@tickernelz/paperclip-pro-shared 2026.1006.0 → 2026.1006.2

package/dist/connection-instructions.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import type { AppDefinition } from "./types/app-definition.js";
+export declare const CONNECTION_INSTRUCTIONS_MAX_LENGTH = 2000;
+/** Optional catalog capability. It is independent of provider and transport. */
+export declare const connectionInstructionTemplateSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodNumber;
+    text: z.ZodString;
+}, z.core.$strip>;
+export type ConnectionInstructionTemplate = z.infer<typeof connectionInstructionTemplateSchema>;
+/** Connection-owned settings; custom connections need not have a template. */
+export declare const connectionAgentInstructionsSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    text: z.ZodString;
+    template: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ConnectionAgentInstructions = z.infer<typeof connectionAgentInstructionsSchema>;
+export declare function defaultConnectionAgentInstructions(template: ConnectionInstructionTemplate | null | undefined): ConnectionAgentInstructions | null;
+/** The server supplies this immutable snapshot, never the wake request author. */
+export interface ConnectionInstructionsSnapshot {
+    text: string;
+    digest: string;
+}
+/** Older connections can retain catalog metadata only in transportConfig. */
+export declare function connectionInstructionsConfig(connection: {
+    config?: Record<string, unknown> | null;
+    transportConfig?: Record<string, unknown> | null;
+}): Record<string, unknown>;
+/** Only public configuration fields declared by the connector enter prompts. */
+export declare function connectionInstructionContext(app: AppDefinition | null | undefined, config: Record<string, unknown>): Record<string, string | boolean> | null;
+//# sourceMappingURL=connection-instructions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection-instructions.d.ts","sourceRoot":"","sources":["../src/connection-instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,eAAO,MAAM,kCAAkC,OAAO,CAAC;AAEvD,gFAAgF;AAChF,eAAO,MAAM,mCAAmC;;;;iBAI9C,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG,8EAA8E;AAC9E,eAAO,MAAM,iCAAiC;;;;;;;iBAO5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,6BAA6B,GAAG,IAAI,GAAG,SAAS,GACzD,2BAA2B,GAAG,IAAI,CAMpC;AAED,kFAAkF;AAClF,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAAC,UAAU,EAAE;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAClD,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE1B;AAED,gFAAgF;AAChF,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAazC"}

package/dist/connection-instructions.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+export const CONNECTION_INSTRUCTIONS_MAX_LENGTH = 2000;
+/** Optional catalog capability. It is independent of provider and transport. */
+export const connectionInstructionTemplateSchema = z.object({
+    id: z.string().trim().min(1).max(160),
+    version: z.number().int().positive(),
+    text: z.string().trim().min(1).max(CONNECTION_INSTRUCTIONS_MAX_LENGTH),
+});
+/** Connection-owned settings; custom connections need not have a template. */
+export const connectionAgentInstructionsSchema = z.object({
+    enabled: z.boolean(),
+    text: z.string().trim().min(1).max(CONNECTION_INSTRUCTIONS_MAX_LENGTH),
+    template: z.object({
+        id: z.string().trim().min(1).max(160),
+        version: z.number().int().positive(),
+    }).optional(),
+});
+export function defaultConnectionAgentInstructions(template) {
+    return template ? {
+        enabled: true,
+        text: template.text,
+        template: { id: template.id, version: template.version },
+    } : null;
+}
+/** Older connections can retain catalog metadata only in transportConfig. */
+export function connectionInstructionsConfig(connection) {
+    return { ...connection.transportConfig, ...connection.config };
+}
+/** Only public configuration fields declared by the connector enter prompts. */
+export function connectionInstructionContext(app, config) {
+    const method = app?.methods.find((entry) => entry.key === config.connectionMethodKey) ?? app?.methods[0];
+    const values = config.methodConfig && typeof config.methodConfig === "object" && !Array.isArray(config.methodConfig)
+        ? config.methodConfig : {};
+    const context = {};
+    for (const field of [...(method?.tenantFields ?? []), ...(method?.extensionFields ?? [])]) {
+        if (field.secret || field.type === "password")
+            continue;
+        const value = values[field.key] ?? field.defaultValue;
+        if (field.required && (value === undefined || value === null || (typeof value === "string" && !value.trim())))
+            return null;
+        if (typeof value === "string" && value.trim())
+            context[field.key] = value.trim();
+        else if (typeof value === "boolean")
+            context[field.key] = value;
+    }
+    return context;
+}
+//# sourceMappingURL=connection-instructions.js.map

package/dist/connection-instructions.js.map

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

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

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

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

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

package/dist/connection-instructions.test.js

@@ -0,0 +1,84 @@
+import { describe, expect, it } from "vitest";
+import { execFileSync } from "node:child_process";
+import { cpSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { connectionAgentInstructionsSchema, connectionInstructionContext, defaultConnectionAgentInstructions } from "./connection-instructions.js";
+import { getConnectableAppDefinition } from "./app-definitions.js";
+import { connectToolAppSchema, createToolConnectionSchema, finishToolAppSchema, updateToolConnectionSchema } from "./validators/tool-access.js";
+import { appDefinitionSchema } from "./validators/app-definition.js";
+describe("generic connection instructions", () => {
+    it.each(["honcho", "mem0", "zep", "supermemory", "cognee"])("validates and enables the reviewed %s default", (slug) => {
+        const app = appDefinitionSchema.parse(getConnectableAppDefinition(slug));
+        const settings = connectionAgentInstructionsSchema.parse(defaultConnectionAgentInstructions(app.agentInstructions));
+        expect(settings.enabled).toBe(true);
+        expect(settings.template?.version).toBeGreaterThan(0);
+        expect(settings.text).toContain("current task");
+        expect(settings.text).toContain("approvals");
+    });
+    it("supports non-memory templates and saved settings without a template", () => {
+        const app = { ...getConnectableAppDefinition("notion"), agentInstructions: { id: "handbook", version: 1, text: "Consult the current release checklist." } };
+        expect(appDefinitionSchema.parse(app).agentInstructions).toEqual(app.agentInstructions);
+        const value = { enabled: false, text: "Keep this custom paragraph." };
+        expect(updateToolConnectionSchema.parse({ agentInstructions: value }).agentInstructions).toEqual(value);
+        expect(connectToolAppSchema.parse({ galleryKey: "notion", agentInstructions: value }).agentInstructions).toEqual(value);
+        expect(finishToolAppSchema.parse({ enabledCatalogEntryIds: [], askFirstCatalogEntryIds: [], access: "all_agents", agentInstructions: value }).agentInstructions).toEqual(value);
+        expect(createToolConnectionSchema.parse({ name: "Handbook", transport: "mcp_remote", agentInstructions: value }).agentInstructions).toEqual(value);
+        expect(defaultConnectionAgentInstructions(getConnectableAppDefinition("notion")?.agentInstructions)).toBeNull();
+    });
+    it("withholds unconfigured instructions and never includes secret fields", () => {
+        const app = getConnectableAppDefinition("honcho");
+        expect(connectionInstructionContext(app, { methodConfig: { workspaceId: " " } })).toBeNull();
+        expect(connectionInstructionContext(app, { methodConfig: { workspaceId: " team ", apiKey: "secret" } })).toEqual({ workspaceId: "team" });
+    });
+    it("allows explicit clearing and rejects blank or unbounded text", () => {
+        expect(updateToolConnectionSchema.parse({ agentInstructions: null }).agentInstructions).toBeNull();
+        expect(connectionAgentInstructionsSchema.safeParse({ enabled: true, text: " " }).success).toBe(false);
+        expect(connectionAgentInstructionsSchema.safeParse({ enabled: true, text: "a".repeat(2001) }).success).toBe(false);
+    });
+    it("regenerates templates from each app definition, including non-memory edits and removal", () => {
+        const root = fileURLToPath(new URL("../../../", import.meta.url));
+        const fixture = mkdtempSync(join(tmpdir(), "paperclip-app-instructions-"));
+        const definitions = join(fixture, "packages/shared/src/app-definitions");
+        const readApp = (slug) => JSON.parse(readFileSync(join(definitions, `${slug}.json`), "utf8"));
+        const writeApp = (slug, app) => writeFileSync(join(definitions, `${slug}.json`), JSON.stringify(app));
+        const generate = () => execFileSync(process.execPath, [join(root, "scripts/ingest-app-definitions.mjs"), "--definitions-only"], { cwd: fixture, stdio: "pipe" });
+        try {
+            for (const source of [
+                "ui/public/brands/apps/manifest.json",
+                "packages/shared/src/self-serve-mcp-research.json",
+                "doc/connections/tool-method-permission-reviews.json",
+                "packages/shared/src/app-definitions",
+            ]) {
+                mkdirSync(dirname(join(fixture, source)), { recursive: true });
+                cpSync(join(root, source), join(fixture, source), { recursive: true });
+            }
+            const notion = readApp("notion");
+            notion.agentInstructions = { id: "notion.handbook", version: 2, text: "Consult the current release checklist." };
+            writeApp("notion", notion);
+            generate();
+            expect(readApp("notion").agentInstructions).toEqual(notion.agentInstructions);
+            for (const slug of ["honcho", "mem0", "zep", "supermemory", "cognee"]) {
+                expect(readApp(slug).agentInstructions).toEqual(getConnectableAppDefinition(slug)?.agentInstructions);
+            }
+            expect(readApp("linear").agentInstructions).toBeUndefined();
+            notion.agentInstructions.text = "Check the updated handbook before a release.";
+            notion.agentInstructions.version++;
+            writeApp("notion", notion);
+            const mem0 = readApp("mem0");
+            delete mem0.agentInstructions;
+            writeApp("mem0", mem0);
+            generate();
+            expect(readApp("notion").agentInstructions).toEqual(notion.agentInstructions);
+            expect(readApp("mem0").agentInstructions).toBeUndefined();
+            notion.agentInstructions.text = " ";
+            writeApp("notion", notion);
+            expect(generate).toThrow("notion: invalid agent instruction template");
+        }
+        finally {
+            rmSync(fixture, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=connection-instructions.test.js.map

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

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

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 and method purpose. Follow the returned instruction to present an inline setup card with connection_request or share the method's setupPath. 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. For an existing connection with missing agent access, pass connectionId and the exact required toolNames to create an embedded Grant access card; only the human can approve it. 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,QAOjC,CAAC;AAEb,eAAO,MAAM,mCAAmC,gpBAAgpB,CAAC;AAEjsB,eAAO,MAAM,mCAAmC,4fAA4f,CAAC;AAE7iB,eAAO,MAAM,6BAA6B,YACxC,oBAAoB,EACpB,oBAAoB,CACZ,CAAC"}

package/dist/connection-intent-guidance.js

@@ -7,27 +7,14 @@
  */
 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.",
+    "- If installed tools are Off or the connection is not enabled for this agent, call `connection_request` with the saved connectionId and required toolNames. It creates a scoped human access card; never substitute a generic permission question or change permissions yourself.",
+    "- 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 and method purpose. Follow the returned instruction to present an inline setup card with connection_request or share the method's setupPath. 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. For an existing connection with missing agent access, pass connectionId and the exact required toolNames to create an embedded Grant access card; only the human can approve it. 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,mRAAmR;IACnR,iLAAiL;IACjL,yEAAyE;CAC1E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,mCAAmC,GAAG,6oBAA6oB,CAAC;AAEjsB,MAAM,CAAC,MAAM,mCAAmC,GAAG,yfAAyf,CAAC;AAE7iB,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;AAIpC,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;AAgChI,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"}