feat: dedupe 5 duplicate connectors into canonicals + release 0.39.0 (#98) (#101)

* feat: dedupe 5 duplicate connectors into canonicals + release 0.39.0 (ai#98)

Retire microsoft-onedrive / -sharepoint / -outlook / -outlook-calendar / notion-database into their canonicals (onedrive / sharepoint / outlook-mail / microsoft-calendar / notion), harvesting each duplicate's unique capabilities first.

Notion: promote to canonical — scopes [] + extraAuthParams {owner:user}, +databases.create/update, and a notion(opts) factory carrying Notion's required HTTP Basic exchangeOAuth/refreshToken (mirrors the twitter const+factory split; creds injected, no process.env in the lib). Flip registry/spec aliases (notion-database -> notion).

SharePoint: +get_site_info, copy_item, lists.create, lists.items.update/delete/find, pages.publish; connect scope Sites.Read.All -> Sites.ReadWrite.All (existing connections need re-consent). Outlook: +forward_message, move_message, set_labels, send_draft, download_attachment. Calendar: +delete_event, list_events, rich book_slot fields.

Also: add microsoft-onedrive/-sharepoint -> canonical aliases; export google-analytics + google-meet (implemented but previously unexported) so the platform can bundle them. BREAKING: removes notionDatabase + microsoft* duplicate exports. typecheck + 4039 tests + build all green.

Closes #98.

* fix(notion): databases.update partial updates + Notion-Version header; tests for harvested caps

Addresses the PR review on #101.

#1 (blocking): databases.update threw on title-only / schema-only updates because the declarative renderer resolves exact-match body placeholders via readRequiredPath. Hand-roll a conditional body reusing the shared executeRestRequest (now exported). Also add the missing Notion-Version defaultHeaders: the declarative data ops never sent it (the retired notion-database did), so the promoted notion would 400 in prod.

#3: behavioral tests for the tricky harvested branches — notion databases.update (partial), sharepoint copy_item(202 monitor)/lists.items.update(412)/delete(404 tombstone)+happy paths, outlook download_attachment/set_labels/forward/move/send_draft, and a NEW microsoft-calendar.test.ts (list_events calendarId-omit, delete_event 404 tombstone + If-Match). +27 tests, 4066 total; typecheck + build green.

Skipped per validated triage: #2 (Idempotency-Key is a pre-existing renderer-wide gap, not introduced here), #4 (retired duplicate capabilities had no consumers; kind aliases cover back-compat). Nits confirmed non-issues.

Author: AtelyPham

README.md

@@ -202,7 +202,7 @@ code should route through `IntegrationHub` either way.
 
 Use `buildDefaultIntegrationRegistry()` before creating tool catalogs or
 connection pickers. It produces one canonical connector per integration,
-dedupes aliases such as `notion -> notion-database`, keeps source provenance in
+dedupes aliases such as `notion-database -> notion`, keeps source provenance in
 metadata, and marks the configured execution state for each connector:
 
 ```txt

docs/adapter-triage.md

@@ -30,7 +30,7 @@ behavior behind the `ConnectorAdapter` contract.
 | `microsoft-calendar` | OAuth2 | read/write | first-party executable |
 | `hubspot` | OAuth2 | read/write | first-party executable |
 | `slack` | OAuth2 | read/write | first-party executable |
-| `notion-database` | OAuth2 | read/write | first-party executable |
+| `notion` | OAuth2 | read/write | first-party executable |
 | `salesforce` | OAuth2 | read/write | first-party executable |
 | `twilio-sms` | API key | read/write | first-party executable |
 | `stripe-pack` | API key | read/write | first-party executable |
@@ -45,7 +45,7 @@ behavior behind the `ConnectorAdapter` contract.
 Aliases matter when comparing coverage:
 
 - `outlook-calendar` maps to `microsoft-calendar`.
-- `notion` maps to `notion-database`.
+- `notion-database` maps to `notion`.
 - `stripe` maps to `stripe-pack` for outbound payment actions.
 - `twilio` maps to `twilio-sms`.
 
@@ -75,7 +75,7 @@ lookups.
 Four Tier 0 entries are canonicalized aliases:
 
 - `outlook-calendar` should resolve to `microsoft-calendar`.
-- `notion` should resolve to `notion-database`.
+- `notion-database` should resolve to `notion`.
 - `stripe` should resolve to `stripe-pack` for outbound payment actions and
   `stripe` for inbound webhooks.
 - `twilio` should resolve to `twilio-sms`.

docs/catalog-registry.md

@@ -57,6 +57,6 @@ const matches = searchIntegrationTools(tools, 'send a slack message', {
 })
 ```
 
-Aliases such as `notion -> notion-database`, `stripe -> stripe-pack`,
+Aliases such as `notion-database -> notion`, `stripe -> stripe-pack`,
 `twilio -> twilio-sms`, and `outlook-calendar -> microsoft-calendar` resolve to
 one canonical entry while preserving lookup by either name.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-integrations",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "Vendor-neutral integration contracts and runtime helpers for sandbox and agent apps.",
   "homepage": "https://github.com/tangle-network/agent-integrations#readme",
   "repository": {

src/connectors/adapters/__tests__/notion.test.ts

@@ -14,7 +14,8 @@ describe('notionConnector', () => {
     // `400 invalid_request_url`, so the connect flow never reaches consent.
     expect(auth.authorizationUrl).toBe('https://api.notion.com/v1/oauth/authorize')
     expect(auth.tokenUrl).toBe('https://api.notion.com/v1/oauth/token')
-    expect(auth.scopes).toEqual(['read', 'write'])
+    expect(auth.scopes).toEqual([])
+    expect(auth.extraAuthParams).toEqual({ owner: 'user' })
     expect(auth.clientIdEnv).toBe('NOTION_OAUTH_CLIENT_ID')
     expect(auth.clientSecretEnv).toBe('NOTION_OAUTH_CLIENT_SECRET')
   })

src/connectors/adapters/declarative-rest.ts

@@ -125,7 +125,7 @@ function readOperation(spec: RestConnectorSpec, name: string, expected: 'read' |
   return op
 }
 
-async function executeRestRequest(
+export async function executeRestRequest(
   spec: RestConnectorSpec,
   request: RestRequestSpec,
   inv: ConnectorInvocation,

src/connectors/adapters/index.ts

@@ -25,7 +25,6 @@ export { gmail, type GmailOptions } from './gmail.js'
 export { microsoftCalendar, type MicrosoftCalendarOptions } from './microsoft-calendar.js'
 export { hubspot, type HubSpotOptions } from './hubspot.js'
 export { slack, type SlackOptions } from './slack.js'
-export { notionDatabase, type NotionDatabaseOptions } from './notion-database.js'
 export { docuseal, type DocuSealOptions } from './docuseal.js'
 export {
   declarativeRestConnector,
@@ -315,6 +314,8 @@ export { freshserviceConnector } from './freshservice.js'
 export { ghostcmsConnector } from './ghostcms.js'
 export { gistlyConnector } from './gistly.js'
 export { googleSearchConsoleConnector } from './google-search-console.js'
+export { googleAnalyticsConnector } from './google-analytics.js'
+export { googleMeetConnector } from './google-meet.js'
 export { youtubeDataConnector } from './youtube-data.js'
 export { googleCloudStorageConnector } from './google-cloud-storage.js'
 export { googleBigqueryConnector } from './google-bigquery.js'
@@ -392,12 +393,9 @@ export { microsoftDynamicsCrmConnector } from './microsoft-dynamics-crm.js'
 export { microsoftDynamics365BusinessCentralConnector } from './microsoft-dynamics-365-business-central.js'
 export { microsoft365PlannerConnector } from './microsoft-365-planner.js'
 export { microsoftPowerBiConnector } from './microsoft-power-bi.js'
-export { microsoftOutlookCalendarConnector } from './microsoft-outlook-calendar.js'
 export { microsoftOnenoteConnector } from './microsoft-onenote.js'
-export { microsoftOutlookConnector } from './microsoft-outlook.js'
 export { microsoftExcel365Connector } from './microsoft-excel-365.js'
 export { microsoftTodoConnector } from './microsoft-todo.js'
-export { microsoftSharepointConnector } from './microsoft-sharepoint.js'
 export { millionverifierConnector } from './millionverifier.js'
 export { mindeeConnector } from './mindee.js'
 export { mixmaxConnector } from './mixmax.js'
@@ -428,12 +426,11 @@ export { medullarConnector } from './medullar.js'
 export { mollieConnector } from './mollie.js'
 export { metabaseConnector } from './metabase.js'
 export { mindStudioConnector } from './mind-studio.js'
-export { microsoftOnedriveConnector } from './microsoft-onedrive.js'
 export { mongodbConnector } from './mongodb.js'
 export { niftyConnector } from './nifty.js'
 export { ninjapipeConnector } from './ninjapipe.js'
 export { nocodbConnector } from './nocodb.js'
-export { notionConnector } from './notion.js'
+export { notionConnector, notion, type NotionOptions } from './notion.js'
 export { ntfyConnector } from './ntfy.js'
 export { odooConnector } from './odoo.js'
 export { omniCoConnector } from './omni-co.js'