@paperclipai/shared 2026.1001.0 → 2026.1002.0-beta.0

package/dist/connection-intent-guidance.d.ts

@@ -6,7 +6,7 @@
  * environment delivery, and MCP tool descriptions.
  */
 export declare const CONNECTION_INTENT_AGENT_GUIDANCE: string;
-export declare const CONNECTIONS_SEARCH_TOOL_DESCRIPTION: string;
-export declare const CONNECTION_REQUEST_TOOL_DESCRIPTION: string;
+export declare const CONNECTIONS_SEARCH_TOOL_DESCRIPTION = "Search connections across tool, channel/email, and AI purposes with a service name or a natural-language description (up to 4000 characters). Results tolerate extra words, split names, and small typos. Choose the relevant match using its description, method purpose, and setupPath; tool methods use connection_request. Also discovers verified external aggregator apps. Use first when the user asks to connect a service, or when usable access is uncertain; follow the returned instruction and exact providerQuestion, if any. Do not use for arbitrary MCP URLs. Search is read-only.";
+export declare const CONNECTION_REQUEST_TOOL_DESCRIPTION = "Request the service identifier returned by connections_search as available or needs_user_action. Follow the search instruction; aggregator routes require the saved provider-selection interaction ID. Only this tool creates the real setup card. If user action is needed, finish independent work, then yield without retrying or asking for credentials in comments.";
 export declare const CONNECTION_RUNTIME_TOOL_NAMES: readonly ["connections_search", "connection_request"];
 //# sourceMappingURL=connection-intent-guidance.d.ts.map

package/dist/connection-intent-guidance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-intent-guidance.d.ts","sourceRoot":"","sources":["../src/connection-intent-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,QAYjC,CAAC;AAEb,eAAO,MAAM,mCAAmC,QAIrC,CAAC;AAEZ,eAAO,MAAM,mCAAmC,QAIrC,CAAC;AAEZ,eAAO,MAAM,6BAA6B,YACxC,oBAAoB,EACpB,oBAAoB,CACZ,CAAC"}
+{"version":3,"file":"connection-intent-guidance.d.ts","sourceRoot":"","sources":["../src/connection-intent-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,QAMjC,CAAC;AAEb,eAAO,MAAM,mCAAmC,wkBAAwkB,CAAC;AAEznB,eAAO,MAAM,mCAAmC,6WAA6W,CAAC;AAE9Z,eAAO,MAAM,6BAA6B,YACxC,oBAAoB,EACpB,oBAAoB,CACZ,CAAC"}

package/dist/connection-intent-guidance.js

@@ -7,27 +7,13 @@
  */
 export const CONNECTION_INTENT_AGENT_GUIDANCE = [
     "Connection tools:",
-    "- When work requires a known external service and usable access is uncertain, call `connections_search` with the service name or capability.",
-    "- This applies both when the user explicitly asks to connect a service and when the requested work implicitly depends on that service.",
-    "- If search returns `ready`, use the installed connection; do not create a connection intent.",
-    "- If search returns `available` or `needs_user_action`, call `connection_request` with the returned service identifier.",
-    "- When the user has already asked to connect a known service, use the real connection request. Do not ask whether to connect again or imitate the Connect / Not now card with `ask_user_questions`, a generic confirmation, or a comment. Only `connection_request` creates the actual connection setup card.",
-    "- If search returns `unavailable`, explain that the service is unavailable and do not call `connection_request`.",
-    "- If `connection_request` returns `needs_user_action`, finish any independent work, then yield in a waiting posture. Do not retry the request, ask for credentials in comments, or claim access.",
-    "- Do not use connection tools for arbitrary MCP URLs, unsupported services, or work that does not require an external service.",
-    "- Keep an existing pending card across messages. Do not request again after the user declines unless they explicitly ask to retry.",
-    "- On a continuation run after connection setup, use the newly installed connection instead of requesting it again.",
+    "- When the user asks to connect a service, call `connections_search` before any service tool, even if already installed. Also search when a task needs a service and usable access is uncertain. Search by its name or capability and follow the returned `instruction`.",
+    "- Use the returned service identifiers and connection tools for setup. Respect recorded user choices; never invent access or ask for credentials in comments.",
+    "- When waiting for user action, finish independent work, then yield without retrying or polling. On continuation, follow the recorded outcome and use the installed connection.",
+    "- Do not use connection tools for arbitrary MCP URLs or unrelated work.",
 ].join("\n");
-export const CONNECTIONS_SEARCH_TOOL_DESCRIPTION = [
-    "Search Paperclip's catalog services and authorized configured custom connections and report this run's agent-relative access state.",
-    "Use it when work requires a known external service and usable access is uncertain; do not use it for arbitrary MCP URLs or unrelated work.",
-    "If the user already asked to connect the service, search and request it through the connection tools instead of asking a generic confirmation question.",
-].join(" ");
-export const CONNECTION_REQUEST_TOOL_DESCRIPTION = [
-    "Request access to a known connectable service for this run's agent from the responsible user.",
-    "This creates the real Connect / Not now setup card. When the user already asked to connect, use this tool; do not recreate those choices with ask_user_questions, request_confirmation, or a comment. A generic question does not start connection setup.",
-    "Call it only with the service identifier returned as available or needs_user_action by connections_search; if user action is needed, finish independent work, then yield without retrying or asking for credentials in comments.",
-].join(" ");
+export const CONNECTIONS_SEARCH_TOOL_DESCRIPTION = "Search connections across tool, channel/email, and AI purposes with a service name or a natural-language description (up to 4000 characters). Results tolerate extra words, split names, and small typos. Choose the relevant match using its description, method purpose, and setupPath; tool methods use connection_request. Also discovers verified external aggregator apps. Use first when the user asks to connect a service, or when usable access is uncertain; follow the returned instruction and exact providerQuestion, if any. Do not use for arbitrary MCP URLs. Search is read-only.";
+export const CONNECTION_REQUEST_TOOL_DESCRIPTION = "Request the service identifier returned by connections_search as available or needs_user_action. Follow the search instruction; aggregator routes require the saved provider-selection interaction ID. Only this tool creates the real setup card. If user action is needed, finish independent work, then yield without retrying or asking for credentials in comments.";
 export const CONNECTION_RUNTIME_TOOL_NAMES = [
     "connections_search",
     "connection_request",

package/dist/connection-intent-guidance.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection-intent-guidance.js","sourceRoot":"","sources":["../src/connection-intent-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,mBAAmB;IACnB,8IAA8I;IAC9I,wIAAwI;IACxI,+FAA+F;IAC/F,yHAAyH;IACzH,+SAA+S;IAC/S,kHAAkH;IAClH,kMAAkM;IAClM,gIAAgI;IAChI,oIAAoI;IACpI,oHAAoH;CACrH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,qIAAqI;IACrI,4IAA4I;IAC5I,yJAAyJ;CAC1J,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,+FAA+F;IAC/F,2PAA2P;IAC3P,kOAAkO;CACnO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,oBAAoB;IACpB,oBAAoB;CACZ,CAAC"}
+{"version":3,"file":"connection-intent-guidance.js","sourceRoot":"","sources":["../src/connection-intent-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,mBAAmB;IACnB,0QAA0Q;IAC1Q,+JAA+J;IAC/J,iLAAiL;IACjL,yEAAyE;CAC1E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,mCAAmC,GAAG,qkBAAqkB,CAAC;AAEznB,MAAM,CAAC,MAAM,mCAAmC,GAAG,0WAA0W,CAAC;AAE9Z,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,oBAAoB;IACpB,oBAAoB;CACZ,CAAC"}

package/dist/connection-intent-guidance.test.js

@@ -1,60 +1,21 @@
 import { describe, expect, it } from "vitest";
-import { CONNECTION_INTENT_AGENT_GUIDANCE, CONNECTION_REQUEST_TOOL_DESCRIPTION, CONNECTION_RUNTIME_TOOL_NAMES, CONNECTIONS_SEARCH_TOOL_DESCRIPTION, } from "./connection-intent-guidance.js";
-describe("connection intent agent guidance", () => {
-    it.each([
-        [
-            "explicit connect request",
-            "explicitly asks to connect",
-            "connections_search",
-        ],
-        [
-            "implicit service dependency",
-            "implicitly depends on that service",
-            "connections_search",
-        ],
-        [
-            "already-ready service",
-            "returns `ready`",
-            "do not create a connection intent",
-        ],
-        [
-            "available service",
-            "returns `available` or `needs_user_action`",
-            "connection_request",
-        ],
-        [
-            "unavailable service",
-            "returns `unavailable`",
-            "do not call `connection_request`",
-        ],
-        ["arbitrary MCP URL", "arbitrary MCP URLs", "Do not use connection tools"],
-        [
-            "pending user action",
-            "returns `needs_user_action`",
-            "finish any independent work, then yield in a waiting posture",
-        ],
-        [
-            "continuation run",
-            "On a continuation run",
-            "instead of requesting it again",
-        ],
-    ])("gives an explicit instruction for %s", (_scenario, trigger, action) => {
-        expect(CONNECTION_INTENT_AGENT_GUIDANCE).toContain(trigger);
-        expect(CONNECTION_INTENT_AGENT_GUIDANCE).toContain(action);
+import { CONNECTION_INTENT_AGENT_GUIDANCE, CONNECTION_REQUEST_TOOL_DESCRIPTION, CONNECTION_RUNTIME_TOOL_NAMES, CONNECTIONS_SEARCH_TOOL_DESCRIPTION } from "./connection-intent-guidance.js";
+describe("connection result guidance", () => {
+    it("delegates route decisions to trusted tool output instead of a provider decision tree", () => {
+        expect(CONNECTION_INTENT_AGENT_GUIDANCE).toContain("follow the returned `instruction`");
+        expect(CONNECTION_INTENT_AGENT_GUIDANCE).toContain("Respect recorded user choices");
+        expect(CONNECTION_INTENT_AGENT_GUIDANCE).not.toMatch(/Composio|Arcade|Executor|Zapier/);
+        expect(CONNECTION_INTENT_AGENT_GUIDANCE).not.toMatch(/https?:\/\/|bearer/);
     });
-    it("names the canonical tools without embedding secrets or authorization URLs", () => {
-        expect(CONNECTION_RUNTIME_TOOL_NAMES).toEqual([
-            "connections_search",
-            "connection_request",
-        ]);
-        expect(CONNECTION_INTENT_AGENT_GUIDANCE).not.toMatch(/bearer|credential value|https?:\/\//i);
+    it("retains waiting, credential, and arbitrary URL boundaries", () => {
+        expect(CONNECTION_INTENT_AGENT_GUIDANCE).toContain("yield without retrying or polling");
+        expect(CONNECTION_INTENT_AGENT_GUIDANCE).toContain("never invent access or ask for credentials in comments");
+        expect(CONNECTION_INTENT_AGENT_GUIDANCE).toContain("arbitrary MCP URLs");
     });
-    it("keeps MCP descriptions aligned with the guidance decision points", () => {
-        expect(CONNECTIONS_SEARCH_TOOL_DESCRIPTION).toContain("usable access is uncertain");
-        expect(CONNECTIONS_SEARCH_TOOL_DESCRIPTION).toContain("arbitrary MCP URLs");
-        expect(CONNECTION_REQUEST_TOOL_DESCRIPTION).toContain("available or needs_user_action");
-        expect(CONNECTION_REQUEST_TOOL_DESCRIPTION).toContain("finish independent work, then yield");
-        expect(CONNECTION_REQUEST_TOOL_DESCRIPTION).toContain("without retrying");
+    it("describes exact questions and saved selection proof", () => {
+        expect(CONNECTIONS_SEARCH_TOOL_DESCRIPTION).toContain("exact providerQuestion");
+        expect(CONNECTION_REQUEST_TOOL_DESCRIPTION).toContain("saved provider-selection interaction ID");
+        expect(CONNECTION_RUNTIME_TOOL_NAMES).toEqual(["connections_search", "connection_request"]);
     });
 });
 //# sourceMappingURL=connection-intent-guidance.test.js.map

package/dist/connection-intent-guidance.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection-intent-guidance.test.js","sourceRoot":"","sources":["../src/connection-intent-guidance.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,gCAAgC,EAChC,mCAAmC,EACnC,6BAA6B,EAC7B,mCAAmC,GACpC,MAAM,iCAAiC,CAAC;AAEzC,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,IAAI,CAAC;QACN;YACE,0BAA0B;YAC1B,4BAA4B;YAC5B,oBAAoB;SACrB;QACD;YACE,6BAA6B;YAC7B,oCAAoC;YACpC,oBAAoB;SACrB;QACD;YACE,uBAAuB;YACvB,iBAAiB;YACjB,mCAAmC;SACpC;QACD;YACE,mBAAmB;YACnB,4CAA4C;YAC5C,oBAAoB;SACrB;QACD;YACE,qBAAqB;YACrB,uBAAuB;YACvB,kCAAkC;SACnC;QACD,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,6BAA6B,CAAC;QAC1E;YACE,qBAAqB;YACrB,6BAA6B;YAC7B,8DAA8D;SAC/D;QACD;YACE,kBAAkB;YAClB,uBAAuB;YACvB,gCAAgC;SACjC;KACF,CAAC,CAAC,sCAAsC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QACxE,MAAM,CAAC,gCAAgC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,CAAC,gCAAgC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,CAAC,6BAA6B,CAAC,CAAC,OAAO,CAAC;YAC5C,oBAAoB;YACpB,oBAAoB;SACrB,CAAC,CAAC;QACH,MAAM,CAAC,gCAAgC,CAAC,CAAC,GAAG,CAAC,OAAO,CAClD,sCAAsC,CACvC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,mCAAmC,CAAC,CAAC,SAAS,CACnD,4BAA4B,CAC7B,CAAC;QACF,MAAM,CAAC,mCAAmC,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAC5E,MAAM,CAAC,mCAAmC,CAAC,CAAC,SAAS,CACnD,gCAAgC,CACjC,CAAC;QACF,MAAM,CAAC,mCAAmC,CAAC,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;QAC7F,MAAM,CAAC,mCAAmC,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"connection-intent-guidance.test.js","sourceRoot":"","sources":["../src/connection-intent-guidance.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gCAAgC,EAAE,mCAAmC,EAAE,6BAA6B,EAAE,mCAAmC,EAAE,MAAM,iCAAiC,CAAC;AAC5L,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;QAC9F,MAAM,CAAC,gCAAgC,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;QACxF,MAAM,CAAC,gCAAgC,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;QACpF,MAAM,CAAC,gCAAgC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;QACxF,MAAM,CAAC,gCAAgC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,gCAAgC,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;QACxF,MAAM,CAAC,gCAAgC,CAAC,CAAC,SAAS,CAAC,wDAAwD,CAAC,CAAC;QAC7G,MAAM,CAAC,gCAAgC,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,mCAAmC,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QAChF,MAAM,CAAC,mCAAmC,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;QACjG,MAAM,CAAC,6BAA6B,CAAC,CAAC,OAAO,CAAC,CAAC,oBAAoB,EAAC,oBAAoB,CAAC,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/connection-routing.d.ts

@@ -0,0 +1,33 @@
+import type { AskUserQuestionsQuestion, ConnectionSearchResultItem } from "./types/index.js";
+import { type RemoteMcpConnectorId } from "./remote-mcp-connectors.js";
+import { prepareConnectionSearch } from "./connection-search.js";
+export declare const AGGREGATOR_PRIORITY: readonly ["composio", "arcade", "executor", "zapier"];
+export declare const AGGREGATOR_NAMES: Record<RemoteMcpConnectorId, string>;
+export interface AggregatorServiceDefinition {
+    slug: string;
+    name: string;
+    aliases: readonly string[];
+    providers: Partial<Record<RemoteMcpConnectorId, string>>;
+    evidenceUrls?: Partial<Record<RemoteMcpConnectorId, string>>;
+}
+export declare const AGGREGATOR_SUPPORT_INDEX: AggregatorServiceDefinition[];
+export declare function searchAggregatorServices(query: string | ReturnType<typeof prepareConnectionSearch>): {
+    score: number;
+    nameScore: number;
+    service: AggregatorServiceDefinition;
+}[];
+export declare const AGGREGATOR_CATALOG_SOURCES: Partial<Record<RemoteMcpConnectorId, string>>;
+export declare function normalizeConnectionQuery(value: string): string;
+export declare function findAggregatorService(query: string, rankedMatches?: ReturnType<typeof searchAggregatorServices>): AggregatorServiceDefinition | undefined;
+/** Preserve a provider explicitly named by the user instead of applying default ranking. */
+export declare function explicitAggregatorQuery(query: string): {
+    provider: RemoteMcpConnectorId;
+    serviceQuery: string;
+} | null;
+export declare function parseAggregatorRoute(service: string): {
+    provider: "arcade" | "composio" | "executor" | "zapier";
+    targetService: string;
+} | null;
+export declare function aggregatorProviderQuestion(targetService: string, targetName: string, results: ConnectionSearchResultItem[]): AskUserQuestionsQuestion;
+export declare function aggregatorContinuationInstruction(provider: RemoteMcpConnectorId, targetName: string): string;
+//# sourceMappingURL=connection-routing.d.ts.map

package/dist/connection-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-routing.d.ts","sourceRoot":"","sources":["../src/connection-routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,uBAAuB,EAAyB,MAAM,wBAAwB,CAAC;AAExF,eAAO,MAAM,mBAAmB,YAC9B,UAAU,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,CACA,CAAC;AACX,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAKjE,CAAC;AAqKF,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9D;AAID,eAAO,MAAM,wBAAwB,EAAE,2BAA2B,EAA6D,CAAC;AAmBhI,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC;;;;IAMlG;AACD,eAAO,MAAM,0BAA0B,EAAE,OAAO,CAC9C,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAKrC,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,2CAkB/G;AAED,4FAA4F;AAC5F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM;cAmBZ,oBAAoB;;SAK5D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM;;;SAUnD;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,0BAA0B,EAAE,GACpC,wBAAwB,CAsB1B;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,oBAAoB,EAC9B,UAAU,EAAE,MAAM,UAcnB"}

package/dist/connection-routing.js

@@ -0,0 +1,295 @@
+import { isRemoteMcpConnectorId, } from "./remote-mcp-connectors.js";
+import composioCatalog from "./composio-search-catalog.json" with { type: "json" };
+import { prepareConnectionSearch, scoreConnectionSearch } from "./connection-search.js";
+export const AGGREGATOR_PRIORITY = [
+    "composio",
+    "arcade",
+    "executor",
+    "zapier",
+];
+export const AGGREGATOR_NAMES = {
+    composio: "Composio",
+    arcade: "Arcade",
+    executor: "Executor",
+    zapier: "Zapier",
+};
+/** Reviewed public catalog snapshot, not a claim that an account has authorized an app.
+ * Add only services confirmed in the cited official catalog. No provider credentials.
+ * Executor has no universal app catalog: use the authorized workspace's indexed tools.
+ */
+const REVIEWED_AGGREGATOR_SUPPORT = [
+    {
+        slug: "hubspot",
+        name: "HubSpot",
+        aliases: ["hub spot"],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+    {
+        slug: "salesforce",
+        name: "Salesforce",
+        aliases: [],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+    {
+        slug: "ashby",
+        name: "Ashby",
+        aliases: [],
+        providers: { composio: "2026-09-23", arcade: "2026-09-23" },
+    },
+    {
+        slug: "pipedrive",
+        name: "Pipedrive",
+        aliases: [],
+        providers: { composio: "2026-09-23", zapier: "2026-09-23" },
+    },
+    {
+        slug: "gong",
+        name: "Gong",
+        aliases: [],
+        providers: { composio: "2026-09-23" },
+    },
+    {
+        slug: "outlook",
+        name: "Outlook",
+        aliases: ["microsoft outlook"],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+    {
+        slug: "microsoft-teams",
+        name: "Microsoft Teams",
+        aliases: ["teams"],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+    {
+        slug: "firecrawl",
+        name: "Firecrawl",
+        aliases: [],
+        providers: { composio: "2026-09-23", arcade: "2026-09-23" },
+    },
+    {
+        slug: "tavily",
+        name: "Tavily",
+        aliases: [],
+        providers: { composio: "2026-09-23", arcade: "2026-09-23" },
+    },
+    {
+        slug: "exa",
+        name: "Exa",
+        aliases: [],
+        providers: { composio: "2026-09-23", arcade: "2026-09-23" },
+    },
+    {
+        slug: "jira",
+        name: "Jira",
+        aliases: ["atlassian jira"],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+    {
+        slug: "notion",
+        name: "Notion",
+        aliases: [],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+    {
+        slug: "github",
+        name: "GitHub",
+        aliases: ["git hub"],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+    {
+        slug: "gmail",
+        name: "Gmail",
+        aliases: ["google mail"],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+    {
+        slug: "slack",
+        name: "Slack",
+        aliases: [],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+    {
+        slug: "airtable",
+        name: "Airtable",
+        aliases: [],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+    {
+        slug: "asana",
+        name: "Asana",
+        aliases: [],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+    {
+        slug: "linear",
+        name: "Linear",
+        aliases: [],
+        providers: {
+            composio: "2026-09-23",
+            arcade: "2026-09-23",
+            zapier: "2026-09-23",
+        },
+    },
+];
+// Keep the other providers' reviewed support claims, and cover the complete
+// public Composio catalog instead of maintaining a tiny app-name allowlist.
+export const AGGREGATOR_SUPPORT_INDEX = REVIEWED_AGGREGATOR_SUPPORT.map(entry => ({ ...entry }));
+for (const [toolkit, name] of composioCatalog.toolkits) {
+    const slug = toolkit.replaceAll("_", "-").replace(/^-+/, "");
+    const evidenceUrl = `https://docs.composio.dev/toolkits/${toolkit}`;
+    const existing = AGGREGATOR_SUPPORT_INDEX.find(entry => entry.slug === slug
+        || (toolkit.endsWith("_mcp") && entry.slug === slug.slice(0, -4)));
+    if (existing) {
+        existing.aliases = [...new Set([...existing.aliases, toolkit, name])];
+        existing.providers = { ...existing.providers, composio: composioCatalog.verifiedAt };
+        existing.evidenceUrls ??= { composio: evidenceUrl };
+    }
+    else {
+        AGGREGATOR_SUPPORT_INDEX.push({ slug, name,
+            aliases: [toolkit, name.replace(/ MCP$/i, "")],
+            providers: { composio: composioCatalog.verifiedAt },
+            evidenceUrls: { composio: evidenceUrl },
+        });
+    }
+}
+export function searchAggregatorServices(query) {
+    const prepared = typeof query === "string" ? prepareConnectionSearch(query) : query;
+    return AGGREGATOR_SUPPORT_INDEX.map(service => ({ service,
+        ...scoreConnectionSearch(prepared, [service.slug, service.name, ...service.aliases]),
+    })).filter(match => match.nameScore > 0 && !isRemoteMcpConnectorId(match.service.slug))
+        .sort((a, b) => b.score - a.score || a.service.slug.localeCompare(b.service.slug));
+}
+export const AGGREGATOR_CATALOG_SOURCES = {
+    composio: "https://composio.dev/toolkits",
+    arcade: "https://docs.arcade.dev/en/resources/integrations",
+    zapier: "https://zapier.com/apps",
+};
+export function normalizeConnectionQuery(value) {
+    return value
+        .toLocaleLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, " ")
+        .trim();
+}
+export function findAggregatorService(query, rankedMatches) {
+    const normalized = normalizeConnectionQuery(query);
+    const exact = AGGREGATOR_SUPPORT_INDEX.find((entry) => [entry.slug, entry.name, ...entry.aliases].some((name) => normalizeConnectionQuery(name) === normalized));
+    if (exact)
+        return exact;
+    // Agents often include the desired capability ("HubSpot recent contacts").
+    // Whole phrases avoid substring guesses; multiple named services need clarification.
+    const matches = (rankedMatches ?? searchAggregatorServices(query))
+        .filter(match => match.nameScore >= 500).map(match => match.service);
+    // "Atlassian Jira" identifies Jira, not both Jira and Atlassian's MCP.
+    const phrases = (entry) => [entry.slug, entry.name, ...entry.aliases]
+        .map(normalizeConnectionQuery).filter(name => ` ${normalized} `.includes(` ${name} `));
+    const specific = matches.filter(entry => !matches.some(other => other !== entry
+        && phrases(entry).every(name => phrases(other).some(longer => longer !== name && ` ${longer} `.includes(` ${name} `)))));
+    return specific.length === 1 ? specific[0] : undefined;
+}
+/** Preserve a provider explicitly named by the user instead of applying default ranking. */
+export function explicitAggregatorQuery(query) {
+    // A trailing exclusion is not a second proposed provider. Keep this grammar
+    // narrow; alternatives and contradictory choices still require confirmation.
+    const exclusion = query.match(/\s*,?\s+not\s+(composio|arcade|executor|zapier)[.!]?\s*$/i);
+    if (exclusion)
+        query = query.slice(0, exclusion.index).trim();
+    const matches = [
+        ...query.matchAll(/\b(?:through|via|using)\s+(composio|arcade|executor|zapier)\b/gi),
+    ];
+    const namedProviders = new Set((query.match(/\b(?:composio|arcade|executor|zapier)\b/gi) ?? []).map((name) => name.toLowerCase()));
+    if (matches.length !== 1 || namedProviders.size !== 1)
+        return null;
+    const match = matches[0];
+    if (exclusion?.[1]?.toLowerCase() === match[1].toLowerCase())
+        return null;
+    return {
+        provider: match[1].toLowerCase(),
+        serviceQuery: (query.slice(0, match.index) + query.slice(match.index + match[0].length)).trim(),
+    };
+}
+export function parseAggregatorRoute(service) {
+    const parts = service.split(":");
+    if (parts.length !== 3 ||
+        parts[0] !== "via" ||
+        !isRemoteMcpConnectorId(parts[1]) ||
+        !/^[a-z0-9][a-z0-9-]{0,79}$/.test(parts[2]))
+        return null;
+    return { provider: parts[1], targetService: parts[2] };
+}
+export function aggregatorProviderQuestion(targetService, targetName, results) {
+    return {
+        id: `connection-provider:${targetService}`,
+        // Keep required disclosure in the prompt: all question transports preserve it.
+        prompt: `Connect ${targetName} through an external service? These services handle the connection and requests to ${targetName}. Connecting a provider does not yet authorize ${targetName}.`,
+        selectionMode: "single",
+        required: true,
+        allowOther: false,
+        options: [
+            ...results.map((result, index) => ({
+                id: result.service,
+                label: `${AGGREGATOR_NAMES[result.aggregator.provider]}${index === 0 ? " — Recommended" : ""}`,
+                description: result.reason ?? "Verify the app in this external provider.",
+            })),
+            {
+                id: "none",
+                label: "None for now",
+                description: "Do not connect through an external service.",
+            },
+        ],
+    };
+}
+export function aggregatorContinuationInstruction(provider, targetName) {
+    const name = AGGREGATOR_NAMES[provider];
+    const discovery = {
+        composio: "Use COMPOSIO_SEARCH_TOOLS to verify the requested app and capability, then COMPOSIO_MANAGE_CONNECTIONS if app authorization is needed.",
+        arcade: "Inspect the gateway tools for the requested app. If absent, ask the user to add the app's tools in the Arcade gateway and refresh the connection. Follow tool authorization links when required.",
+        executor: "Inspect the Executor workspace's actual integrations using its documented discovery tools. Do not assume arbitrary apps exist or register integrations merely to search. Follow provider authorization and resume instructions when needed.",
+        zapier: "In Agentic mode, use discover_zapier_actions and the documented app connection flow. In Managed mode, ask the user to add the required actions in Zapier and refresh the catalog.",
+    }[provider];
+    return `${name} is an external service. Its connection is available to this agent, but ${targetName} access is not yet verified. ${discovery} Use only the requested capability and effective permissions. If support is absent, explain that result and ask before switching providers. Claim success only after verifying the underlying app; never repeat an uncertain write.`;
+}
+//# sourceMappingURL=connection-routing.js.map

package/dist/connection-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-routing.js","sourceRoot":"","sources":["../src/connection-routing.ts"],"names":[],"mappings":"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"}

package/dist/connection-routing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connection-routing.test.d.ts.map

package/dist/connection-routing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-routing.test.d.ts","sourceRoot":"","sources":["../src/connection-routing.test.ts"],"names":[],"mappings":""}

package/dist/connection-routing.test.js

@@ -0,0 +1,73 @@
+import { describe, expect, it } from "vitest";
+import { AGGREGATOR_PRIORITY, AGGREGATOR_SUPPORT_INDEX, explicitAggregatorQuery, findAggregatorService, parseAggregatorRoute, aggregatorProviderQuestion, aggregatorContinuationInstruction, } from "./connection-routing.js";
+describe("aggregator routing contract", () => {
+    it("ranks providers and resolves aliases without fuzzy service claims", () => {
+        expect(AGGREGATOR_PRIORITY).toEqual([
+            "composio",
+            "arcade",
+            "executor",
+            "zapier",
+        ]);
+        expect(findAggregatorService("  Hub Spot ")?.slug).toBe("hubspot");
+        expect(findAggregatorService("my unknown crm")).toBeUndefined();
+    });
+    it("rejects forged or unbounded route identifiers", () => {
+        expect(parseAggregatorRoute("via:arcade:hubspot")).toEqual({
+            provider: "arcade",
+            targetService: "hubspot",
+        });
+        for (const value of [
+            "via:other:hubspot",
+            "via:composio:https://evil",
+            "via:composio:../secret",
+            "via:executor:",
+        ])
+            expect(parseAggregatorRoute(value)).toBeNull();
+    });
+    it("always discloses external handling and offers None even with one provider", () => {
+        const results = [
+            {
+                service: "via:composio:hubspot",
+                aggregator: { provider: "composio" },
+                reason: "Verify app authorization",
+            },
+        ];
+        const question = aggregatorProviderQuestion("hubspot", "HubSpot", results);
+        expect(question.prompt).toContain("external service");
+        expect(question.prompt).toContain("handle the connection and requests");
+        expect(question.options.map((option) => option.id)).toEqual([
+            "via:composio:hubspot",
+            "none",
+        ]);
+        expect(question.selectionMode).toBe("single");
+        expect(question.allowOther).toBe(false);
+    });
+    it.each(AGGREGATOR_PRIORITY)("does not claim underlying app readiness for %s", (provider) => {
+        expect(aggregatorContinuationInstruction(provider, "HubSpot")).toContain("HubSpot access is not yet verified");
+        expect(aggregatorContinuationInstruction(provider, "HubSpot")).toContain("ask before switching providers");
+    });
+});
+it("recognizes a service in capability searches without guessing ambiguous or partial names", () => {
+    expect(findAggregatorService("HubSpot recent contacts")?.slug).toBe("hubspot");
+    expect(findAggregatorService("connect atlassian jira and read issues")?.slug).toBe("jira");
+    expect(findAggregatorService("HubSpot and Salesforce contacts")).toBeUndefined();
+    expect(findAggregatorService("notionally similar")).toBeUndefined();
+});
+it("keeps dates per app/provider claim and parses only an unambiguous explicit provider", () => {
+    for (const app of AGGREGATOR_SUPPORT_INDEX)
+        for (const date of Object.values(app.providers))
+            expect(date).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+    expect(explicitAggregatorQuery("HubSpot through Arcade")).toEqual({
+        provider: "arcade",
+        serviceQuery: "HubSpot",
+    });
+    expect(explicitAggregatorQuery("HubSpot via Arcade or via Composio")).toBeNull();
+    expect(explicitAggregatorQuery("arcade games")).toBeNull();
+    expect(explicitAggregatorQuery("HubSpot via Arcade or Composio")).toBeNull();
+    expect(explicitAggregatorQuery("Jira via Arcade, not Zapier")).toEqual({
+        provider: "arcade",
+        serviceQuery: "Jira",
+    });
+    expect(explicitAggregatorQuery("Jira via Arcade, not Arcade")).toBeNull();
+});
+//# sourceMappingURL=connection-routing.test.js.map

package/dist/connection-routing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-routing.test.js","sourceRoot":"","sources":["../src/connection-routing.test.ts"],"names":[],"mappings":"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"}

package/dist/connection-search.d.ts

@@ -0,0 +1,15 @@
+/** Retrieval only. A fuzzy match is never evidence of authorization or consent. */
+export declare function normalizeConnectionSearch(value: string): string;
+/** Reuse normalized words and deduplicated name windows across a catalog scan. */
+export declare function prepareConnectionSearch(query: string): {
+    normalized: string;
+    compact: string;
+    phrases: Set<string>;
+    phrasesByLength: Map<number, Set<string>>;
+    terms: string[];
+};
+export declare function scoreConnectionSearch(query: string | ReturnType<typeof prepareConnectionSearch>, names: readonly string[], description?: string): {
+    score: number;
+    nameScore: number;
+};
+//# sourceMappingURL=connection-search.d.ts.map

package/dist/connection-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-search.d.ts","sourceRoot":"","sources":["../src/connection-search.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/D;AAKD,kFAAkF;AAClF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM;;;;;;EAkBpD;AAaD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,SAAK;;;EA+B3I"}