mcp-use-compat 0.3.0

package/dist/profiles/goose.d.ts

@@ -0,0 +1,4 @@
+import type { ClientProfile } from "./types.js";
+/** Generated from research notes (2026-09-27); every fact links to its source. */
+export declare const goose: ClientProfile;
+//# sourceMappingURL=goose.d.ts.map

package/dist/profiles/goose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goose.d.ts","sourceRoot":"","sources":["../../src/profiles/goose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,kFAAkF;AAClF,eAAO,MAAM,KAAK,EAAE,aA+GnB,CAAC"}

package/dist/profiles/goose.js

@@ -0,0 +1,114 @@
+/** Generated from research notes (2026-09-27); every fact links to its source. */
+export const goose = {
+    id: "goose",
+    aliases: [],
+    displayName: "Goose",
+    versionTested: "block/goose @ 04ed836 (1.52.0)",
+    supports: {
+        stdio: {
+            value: true,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/agents/extension.rs#L157-L158",
+            verifiedOn: "2026-09-27"
+        },
+        streamableHttp: {
+            value: true,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/agents/extension.rs#L207-L208",
+            verifiedOn: "2026-09-27"
+        },
+        sse: {
+            value: false,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/agents/extension.rs#L156",
+            verifiedOn: "2026-09-27",
+            note: "No SSE variant in ExtensionConfig."
+        },
+        toolsListChanged: {
+            value: true,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/agents/mcp_client.rs#L377-L379",
+            verifiedOn: "2026-09-27"
+        },
+        resources: {
+            value: true,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/agents/extension_manager/mod.rs#L1067",
+            verifiedOn: "2026-09-27"
+        },
+        prompts: {
+            value: true,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/agents/extension_manager/mod.rs#L1450",
+            verifiedOn: "2026-09-27"
+        },
+        sampling: {
+            value: false,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/agents/mcp_client.rs#L1516-L1521",
+            verifiedOn: "2026-09-27",
+            note: "A test asserts sampling is not advertised."
+        },
+        elicitation: {
+            value: true,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/agents/mcp_client.rs#L466-L472",
+            verifiedOn: "2026-09-27"
+        },
+        oauth: {
+            value: true,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/oauth/mod.rs#L255-L276",
+            verifiedOn: "2026-09-27"
+        },
+        cimd: {
+            value: true,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/oauth/mod.rs#L273-L275",
+            verifiedOn: "2026-09-27",
+            note: "Uses a client_metadata_url unless a static client is configured."
+        },
+        uiResources: {
+            value: true,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/agents/mcp_client.rs#L300-L311",
+            verifiedOn: "2026-09-27",
+            note: "The MCP Apps UI extension is advertised when the host sets mcpui."
+        },
+        structuredContent: {
+            value: false,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose-provider-types/src/formats/anthropic.rs#L314-L404",
+            verifiedOn: "2026-09-27",
+            note: "Provider formatting reads result.content only."
+        }
+    },
+    limits: {
+        toolNamePrefix: {
+            value: {
+                format: "{server}__",
+                lowercase: true
+            },
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/agents/extension_manager/mod.rs#L850-L854",
+            verifiedOn: "2026-09-27",
+            note: "{server} is the extension key: name_to_key() lowercases, removes whitespace and replaces chars other than [A-Za-z0-9_-] with '_' (config/extensions.rs#L22-L32). The tool name itself is not sanitised. unprefixed extensions skip the prefix."
+        },
+        structuredContent: {
+            value: "textOnly",
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose-provider-types/src/formats/anthropic.rs#L314-L404",
+            verifiedOn: "2026-09-27",
+            note: "Provider formatting reads result.content only."
+        },
+        maxToolResult: {
+            value: {
+                max: 200000,
+                unit: "chars",
+                onExceed: "file"
+            },
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/agents/large_response_handler.rs#L5-L50",
+            verifiedOn: "2026-09-27",
+            note: "Text blocks over 200,000 chars (GOOSE_MAX_TOOL_RESPONSE_SIZE) are written to a temp file and replaced by a pointer message."
+        },
+        toolTimeoutMs: {
+            value: 300000,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/config/extensions.rs#L10",
+            verifiedOn: "2026-09-27",
+            note: "Per-extension timeout, default 300 s."
+        },
+        readOnlySkipsApproval: {
+            value: true,
+            source: "https://github.com/block/goose/blob/04ed836c8cde23e540cc77d256992e00be99298b/crates/goose/src/permission/permission_inspector.rs#L52-L64",
+            verifiedOn: "2026-09-27",
+            note: "Smart-approve: readOnlyHint:true tools are treated as read-only (no prompt), and readOnlyHint:false tools are set to AskBefore."
+        }
+    },
+};
+//# sourceMappingURL=goose.js.map

package/dist/profiles/goose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goose.js","sourceRoot":"","sources":["../../src/profiles/goose.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,CAAC,MAAM,KAAK,GAAkB;IAClC,EAAE,EAAE,OAAO;IACX,OAAO,EAAE,EAAE;IACX,WAAW,EAAE,OAAO;IACpB,aAAa,EAAE,gCAAgC;IAC/C,QAAQ,EAAE;QACR,KAAK,EAAE;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,6HAA6H;YACrI,UAAU,EAAE,YAAY;SACzB;QACD,cAAc,EAAE;YACd,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,6HAA6H;YACrI,UAAU,EAAE,YAAY;SACzB;QACD,GAAG,EAAE;YACH,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,wHAAwH;YAChI,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,oCAAoC;SAC3C;QACD,gBAAgB,EAAE;YAChB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,8HAA8H;YACtI,UAAU,EAAE,YAAY;SACzB;QACD,SAAS,EAAE;YACT,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,qIAAqI;YAC7I,UAAU,EAAE,YAAY;SACzB;QACD,OAAO,EAAE;YACP,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,qIAAqI;YAC7I,UAAU,EAAE,YAAY;SACzB;QACD,QAAQ,EAAE;YACR,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,gIAAgI;YACxI,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,4CAA4C;SACnD;QACD,WAAW,EAAE;YACX,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,8HAA8H;YACtI,UAAU,EAAE,YAAY;SACzB;QACD,KAAK,EAAE;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,sHAAsH;YAC9H,UAAU,EAAE,YAAY;SACzB;QACD,IAAI,EAAE;YACJ,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,sHAAsH;YAC9H,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,kEAAkE;SACzE;QACD,WAAW,EAAE;YACX,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,8HAA8H;YACtI,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,mEAAmE;SAC1E;QACD,iBAAiB,EAAE;YACjB,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,6IAA6I;YACrJ,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,gDAAgD;SACvD;KACF;IACD,MAAM,EAAE;QACN,cAAc,EAAE;YACd,KAAK,EAAE;gBACL,MAAM,EAAE,YAAY;gBACpB,SAAS,EAAE,IAAI;aAChB;YACD,MAAM,EAAE,yIAAyI;YACjJ,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,gPAAgP;SACvP;QACD,iBAAiB,EAAE;YACjB,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,6IAA6I;YACrJ,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,gDAAgD;SACvD;QACD,aAAa,EAAE;YACb,KAAK,EAAE;gBACL,GAAG,EAAE,MAAM;gBACX,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,MAAM;aACjB;YACD,MAAM,EAAE,uIAAuI;YAC/I,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,6HAA6H;SACpI;QACD,aAAa,EAAE;YACb,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,wHAAwH;YAChI,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,uCAAuC;SAC9C;QACD,qBAAqB,EAAE;YACrB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,0IAA0I;YAClJ,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,iIAAiI;SACxI;KACF;CACF,CAAC"}

package/dist/profiles/index.d.ts

@@ -0,0 +1,7 @@
+import type { ClientProfile } from "./types.js";
+export declare const ALL_PROFILES: ClientProfile[];
+export declare class UnknownClientError extends Error {
+}
+/** Resolves ids/aliases to profiles; undefined selects all. */
+export declare function selectProfiles(ids: string[] | undefined, profiles?: ClientProfile[]): ClientProfile[];
+//# sourceMappingURL=index.d.ts.map

package/dist/profiles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/profiles/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,eAAO,MAAM,YAAY,EAAE,aAAa,EAavC,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAEhD,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,QAAQ,kBAAe,GAAG,aAAa,EAAE,CAWlG"}

package/dist/profiles/index.js

@@ -0,0 +1,43 @@
+import { chatgpt } from "./chatgpt.js";
+import { cline } from "./cline.js";
+import { codex } from "./codex.js";
+import { continueDev } from "./continue.js";
+import { geminiCli } from "./gemini-cli.js";
+import { goose } from "./goose.js";
+import { windsurf } from "./windsurf.js";
+import { claudeCode } from "./claude-code.js";
+import { claudeDesktop } from "./claude-desktop.js";
+import { cursor } from "./cursor.js";
+import { opencode } from "./opencode.js";
+import { vscodeCopilot } from "./vscode-copilot.js";
+export const ALL_PROFILES = [
+    claudeDesktop,
+    claudeCode,
+    chatgpt,
+    cursor,
+    vscodeCopilot,
+    opencode,
+    codex,
+    geminiCli,
+    cline,
+    goose,
+    continueDev,
+    windsurf,
+];
+export class UnknownClientError extends Error {
+}
+/** Resolves ids/aliases to profiles; undefined selects all. */
+export function selectProfiles(ids, profiles = ALL_PROFILES) {
+    if (!ids)
+        return profiles;
+    return ids.map((id) => {
+        const wanted = id.toLowerCase();
+        const found = profiles.find((p) => p.id === wanted || p.aliases.includes(wanted));
+        if (!found) {
+            const known = profiles.map((p) => p.id).join(", ") || "(none)";
+            throw new UnknownClientError(`Unknown client "${id}". Known clients: ${known}`);
+        }
+        return found;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/profiles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/profiles/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,aAAa;IACb,UAAU;IACV,OAAO;IACP,MAAM;IACN,aAAa;IACb,QAAQ;IACR,KAAK;IACL,SAAS;IACT,KAAK;IACL,KAAK;IACL,WAAW;IACX,QAAQ;CACT,CAAC;AAEF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;CAAG;AAEhD,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,GAAyB,EAAE,QAAQ,GAAG,YAAY;IAC/E,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAClF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;YAC/D,MAAM,IAAI,kBAAkB,CAAC,mBAAmB,EAAE,qBAAqB,KAAK,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/profiles/opencode.d.ts

@@ -0,0 +1,3 @@
+import type { ClientProfile } from "./types.js";
+export declare const opencode: ClientProfile;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/profiles/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/profiles/opencode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD,eAAO,MAAM,QAAQ,EAAE,aA0CtB,CAAC"}

package/dist/profiles/opencode.js

@@ -0,0 +1,47 @@
+const DOCS = "https://opencode.ai/docs/mcp-servers/";
+const SRC = "https://github.com/anomalyco/opencode/blob/a42f393c850bec0c0f395fb91bf19b1ee8b31666/packages/opencode/src/mcp";
+const verifiedOn = "2026-09-26";
+export const opencode = {
+    id: "opencode",
+    aliases: [],
+    displayName: "OpenCode",
+    versionTested: "opencode-ai 1.18.32 (anomalyco/opencode @ a42f393)",
+    supports: {
+        stdio: { value: true, source: DOCS, verifiedOn },
+        streamableHttp: { value: true, source: `${SRC}/index.ts#L268-L283`, verifiedOn },
+        sse: { value: true, source: `${SRC}/index.ts#L268-L283`, verifiedOn },
+        toolsListChanged: { value: true, source: `${SRC}/index.ts#L461-L471`, verifiedOn },
+        promptsListChanged: { value: false, source: `${SRC}/index.ts`, verifiedOn, note: "No handler in the client source." },
+        resourcesListChanged: { value: false, source: `${SRC}/index.ts`, verifiedOn, note: "No handler in the client source." },
+        resources: { value: true, source: `${SRC}/catalog.ts#L130-L134`, verifiedOn },
+        prompts: { value: true, source: `${SRC}/catalog.ts#L122-L126`, verifiedOn },
+        sampling: { value: false, source: `${SRC}/index.ts#L39-L49`, verifiedOn },
+        elicitation: { value: false, source: `${SRC}/index.ts#L39-L49`, verifiedOn },
+        oauth: { value: true, source: DOCS, verifiedOn },
+        dcr: { value: true, source: DOCS, verifiedOn },
+        uiResources: { value: false, source: `${SRC}/`, verifiedOn, note: "No MCP Apps handling in the source." },
+        structuredContent: { value: "partial", source: `${SRC}/catalog.ts#L75-L80`, verifiedOn },
+    },
+    limits: {
+        toolNamePrefix: { value: { format: "{server}_" }, source: `${SRC}/catalog.ts#L117-L119`, verifiedOn },
+        toolNameChars: {
+            value: { allowed: "A-Za-z0-9_-", onInvalid: "replace" },
+            source: `${SRC}/catalog.ts#L117`,
+            verifiedOn,
+        },
+        structuredContent: { value: "fallbackOnly", source: `${SRC}/catalog.ts#L75-L80`, verifiedOn },
+        maxToolResult: {
+            value: { max: 51200, unit: "bytes", onExceed: "file" },
+            source: "https://github.com/anomalyco/opencode/blob/b471c2b4495747353af768fbf2e0790c9d820ce2/packages/opencode/src/tool/truncate.ts#L14-L15",
+            verifiedOn: "2026-09-27",
+            note: "2000 lines / 50 KB by default; the full output is saved to a file.",
+        },
+        toolTimeoutMs: {
+            value: 60000,
+            source: "https://github.com/anomalyco/opencode/blob/b471c2b4495747353af768fbf2e0790c9d820ce2/packages/opencode/src/mcp/catalog.ts#L54-L66",
+            verifiedOn: "2026-09-27",
+            note: "Per-server timeout, else the MCP SDK default of 60 s.",
+        },
+    },
+};
+//# sourceMappingURL=opencode.js.map

package/dist/profiles/opencode.js.map

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

package/dist/profiles/types.d.ts

@@ -0,0 +1,86 @@
+/** Client features a finding can depend on. */
+export type ClientFeature = "stdio" | "streamableHttp" | "sse" | "toolsListChanged" | "resourcesListChanged" | "promptsListChanged" | "resources" | "prompts" | "sampling" | "elicitation" | "oauth" | "dcr" | "cimd" | "uiResources" | "structuredContent";
+/** A fact about a client, with where we learned it. */
+export interface Sourced<T> {
+    value: T;
+    source: string;
+    /** YYYY-MM-DD */
+    verifiedOn: string;
+    note?: string;
+}
+/** "partial" = supported but known to be unreliable or incomplete; see the note. */
+export type Support = boolean | "partial";
+/** What a client does with a tool name it doesn't accept as-is. */
+export type NameHandling = "reject" | "replace" | "truncate"
+/** Truncated (or renamed), then made unique with a hash suffix. */
+ | "truncateWithHash"
+/** Keeps the start and end, joined by "...". */
+ | "truncateMiddle"
+/** Replaced; names that then collide get a hash suffix, so they stay unique. */
+ | "replaceUnique" | "unknown";
+/** How a client passes a tool result with structuredContent to the model. */
+export type StructuredContentHandling = 
+/** Model sees JSON of structuredContent instead of the text content. */
+"replacesText"
+/** Model sees both. */
+ | "alongsideText"
+/** Model sees text content; structuredContent only if content is empty. */
+ | "fallbackOnly"
+/** Model only ever sees the text content. */
+ | "textOnly";
+export interface ClientProfile {
+    id: string;
+    aliases: string[];
+    displayName: string;
+    versionTested?: string;
+    /** Absent feature = unknown. Unknown never produces a FAIL or WARN. */
+    supports: Partial<Record<ClientFeature, Sourced<Support>>>;
+    limits: {
+        maxTools?: Sourced<number>;
+        /**
+         * Prefix the client adds before the tool name. {server} is the name the
+         * user gave the server; maxLength caps the prefix, lowercase lowercases it.
+         */
+        toolNamePrefix?: Sourced<{
+            format: string;
+            maxLength?: number;
+            lowercase?: boolean;
+        }>;
+        /** Allowed characters (regex character class body, e.g. "A-Za-z0-9_-") and what happens to others. */
+        toolNameChars?: Sourced<{
+            allowed: string;
+            onInvalid: NameHandling;
+        }>;
+        /** Max length of prefix + tool name and what happens beyond it. */
+        maxToolNameLength?: Sourced<{
+            max: number;
+            onExceed: NameHandling;
+        }>;
+        /** Descriptions (and server instructions) longer than this are truncated. */
+        maxDescriptionLength?: Sourced<number>;
+        /** Top-level inputSchema property names must match this regex, or the tool is dropped. */
+        inputPropertyNamePattern?: Sourced<string>;
+        /** JSON Schema keywords the client rejects or drops. */
+        schemaUnsupported?: Sourced<string[]>;
+        structuredContent?: Sourced<StructuredContentHandling>;
+        /** Root-level oneOf/anyOf with a non-object branch makes the client drop the server's tools. */
+        rootCombinatorNonObject?: Sourced<"dropsServerTools">;
+        /** Type arrays like ["string","null"] fail the client's argument validation. */
+        typeArraysRejected?: Sourced<boolean>;
+        /** JSON Schema keywords the client silently removes before the model sees the schema. */
+        schemaDroppedKeywords?: Sourced<string[]>;
+        /** inputSchema size (JSON characters) above which the client compacts or strips it. */
+        maxSchemaChars?: Sourced<number>;
+        /** Tool result size the model gets before the client truncates or offloads it. */
+        maxToolResult?: Sourced<{
+            max: number;
+            unit: "chars" | "tokens" | "bytes";
+            onExceed: "truncate" | "file" | "unknown";
+        }>;
+        /** Default tool call timeout. */
+        toolTimeoutMs?: Sourced<number>;
+        /** readOnlyHint: true lets tools run without a confirmation prompt. */
+        readOnlySkipsApproval?: Sourced<boolean>;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/profiles/types.d.ts.map

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

package/dist/profiles/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/profiles/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/profiles/types.ts"],"names":[],"mappings":""}

package/dist/profiles/vscode-copilot.d.ts

@@ -0,0 +1,3 @@
+import type { ClientProfile } from "./types.js";
+export declare const vscodeCopilot: ClientProfile;
+//# sourceMappingURL=vscode-copilot.d.ts.map

package/dist/profiles/vscode-copilot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode-copilot.d.ts","sourceRoot":"","sources":["../../src/profiles/vscode-copilot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD,eAAO,MAAM,aAAa,EAAE,aAkE3B,CAAC"}

package/dist/profiles/vscode-copilot.js

@@ -0,0 +1,71 @@
+const GUIDE = "https://code.visualstudio.com/api/extension-guides/ai/mcp";
+const SRC = "https://github.com/microsoft/vscode/blob/a460613c57b4c1eb2bc8edc97be694e05ae286b2/src/vs/workbench/contrib/mcp/common";
+const verifiedOn = "2026-09-26";
+export const vscodeCopilot = {
+    id: "vscode-copilot",
+    aliases: ["vscode", "copilot"],
+    displayName: "VS Code (GitHub Copilot)",
+    versionTested: "microsoft/vscode @ a460613 (1.140.0)",
+    supports: {
+        stdio: { value: true, source: GUIDE, verifiedOn },
+        streamableHttp: { value: true, source: GUIDE, verifiedOn },
+        sse: { value: true, source: GUIDE, verifiedOn },
+        toolsListChanged: { value: true, source: `${SRC}/mcpServer.ts#L1224-L1227`, verifiedOn },
+        promptsListChanged: { value: true, source: `${SRC}/mcpServer.ts#L1229-L1232`, verifiedOn },
+        resourcesListChanged: {
+            value: "partial",
+            source: `${SRC}/mcpServerRequestHandler.ts#L368-L370`,
+            verifiedOn,
+            note: "The notification is parsed but nothing listens to it; resources are listed on demand.",
+        },
+        resources: { value: true, source: GUIDE, verifiedOn },
+        prompts: { value: true, source: GUIDE, verifiedOn },
+        sampling: { value: true, source: GUIDE, verifiedOn },
+        elicitation: { value: true, source: `${SRC}/mcpServerRequestHandler.ts#L120-L134`, verifiedOn },
+        oauth: { value: true, source: GUIDE, verifiedOn },
+        dcr: { value: true, source: GUIDE, verifiedOn },
+        cimd: {
+            value: true,
+            source: "https://github.com/microsoft/vscode/blob/a460613c57b4c1eb2bc8edc97be694e05ae286b2/src/vs/workbench/api/browser/mainThreadAuthentication.ts#L178-L192",
+            verifiedOn,
+        },
+        uiResources: { value: true, source: GUIDE, verifiedOn },
+        structuredContent: { value: true, source: `${SRC}/mcpLanguageModelToolContribution.ts#L331-L392`, verifiedOn },
+    },
+    limits: {
+        maxTools: {
+            value: 128,
+            source: "https://code.visualstudio.com/docs/agents/run/tools",
+            verifiedOn,
+            note: "per chat request, across all servers",
+        },
+        toolNamePrefix: {
+            value: { format: "mcp_{server}_", maxLength: 18, lowercase: true },
+            source: `${SRC}/mcpServer.ts#L232-L252`,
+            verifiedOn,
+        },
+        toolNameChars: {
+            value: { allowed: "A-Za-z0-9_-", onInvalid: "replace" },
+            source: `${SRC}/mcpServer.ts#L1086-L1089`,
+            verifiedOn,
+            note: "Other characters are replaced with '_' and a warning is logged.",
+        },
+        maxToolNameLength: {
+            value: { max: 64, onExceed: "truncate" },
+            source: `${SRC}/mcpServer.ts#L1333`,
+            verifiedOn,
+        },
+        structuredContent: {
+            value: "replacesText",
+            source: `${SRC}/mcpLanguageModelToolContribution.ts#L331-L392`,
+            verifiedOn,
+        },
+        readOnlySkipsApproval: {
+            value: true,
+            source: "https://github.com/microsoft/vscode/blob/43dd9070f75d527ab38035c0562acbfe9de4209b/src/vs/workbench/contrib/mcp/common/mcpLanguageModelToolContribution.ts#L231-L243",
+            verifiedOn: "2026-09-27",
+            note: "Without readOnlyHint every call needs confirmation.",
+        },
+    },
+};
+//# sourceMappingURL=vscode-copilot.js.map

package/dist/profiles/vscode-copilot.js.map

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

package/dist/profiles/windsurf.d.ts

@@ -0,0 +1,4 @@
+import type { ClientProfile } from "./types.js";
+/** Generated from research notes (2026-09-27); every fact links to its source. */
+export declare const windsurf: ClientProfile;
+//# sourceMappingURL=windsurf.d.ts.map

package/dist/profiles/windsurf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.d.ts","sourceRoot":"","sources":["../../src/profiles/windsurf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,kFAAkF;AAClF,eAAO,MAAM,QAAQ,EAAE,aA8CtB,CAAC"}

package/dist/profiles/windsurf.js

@@ -0,0 +1,49 @@
+/** Generated from research notes (2026-09-27); every fact links to its source. */
+export const windsurf = {
+    id: "windsurf",
+    aliases: ["devin-desktop", "cascade"],
+    displayName: "Windsurf / Devin Desktop",
+    versionTested: "docs only (closed source)",
+    supports: {
+        stdio: {
+            value: true,
+            source: "https://docs.devin.ai/desktop/cascade/mcp",
+            verifiedOn: "2026-09-27"
+        },
+        streamableHttp: {
+            value: true,
+            source: "https://docs.devin.ai/desktop/cascade/mcp",
+            verifiedOn: "2026-09-27"
+        },
+        sse: {
+            value: true,
+            source: "https://docs.devin.ai/desktop/cascade/mcp",
+            verifiedOn: "2026-09-27"
+        },
+        oauth: {
+            value: true,
+            source: "https://docs.devin.ai/desktop/cascade/mcp",
+            verifiedOn: "2026-09-27",
+            note: "'supports OAuth for each transport type'."
+        },
+        resources: {
+            value: true,
+            source: "https://docs.devin.ai/desktop/cascade/mcp",
+            verifiedOn: "2026-09-27"
+        },
+        prompts: {
+            value: true,
+            source: "https://docs.devin.ai/desktop/cascade/mcp",
+            verifiedOn: "2026-09-27"
+        }
+    },
+    limits: {
+        maxTools: {
+            value: 100,
+            source: "https://docs.devin.ai/desktop/cascade/mcp",
+            verifiedOn: "2026-09-27",
+            note: "'Cascade has a limit of 100 total tools'. docs.windsurf.com now redirects here; the page calls Cascade the legacy agent."
+        }
+    },
+};
+//# sourceMappingURL=windsurf.js.map

package/dist/profiles/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../src/profiles/windsurf.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,CAAC,MAAM,QAAQ,GAAkB;IACrC,EAAE,EAAE,UAAU;IACd,OAAO,EAAE,CAAC,eAAe,EAAE,SAAS,CAAC;IACrC,WAAW,EAAE,0BAA0B;IACvC,aAAa,EAAE,2BAA2B;IAC1C,QAAQ,EAAE;QACR,KAAK,EAAE;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,2CAA2C;YACnD,UAAU,EAAE,YAAY;SACzB;QACD,cAAc,EAAE;YACd,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,2CAA2C;YACnD,UAAU,EAAE,YAAY;SACzB;QACD,GAAG,EAAE;YACH,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,2CAA2C;YACnD,UAAU,EAAE,YAAY;SACzB;QACD,KAAK,EAAE;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,2CAA2C;YACnD,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,2CAA2C;SAClD;QACD,SAAS,EAAE;YACT,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,2CAA2C;YACnD,UAAU,EAAE,YAAY;SACzB;QACD,OAAO,EAAE;YACP,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,2CAA2C;YACnD,UAAU,EAAE,YAAY;SACzB;KACF;IACD,MAAM,EAAE;QACN,QAAQ,EAAE;YACR,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,2CAA2C;YACnD,UAAU,EAAE,YAAY;YACxB,IAAI,EAAE,0HAA0H;SACjI;KACF;CACF,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,52 @@
+export type Ecosystem = "npm" | "pypi" | "go" | "crates";
+/** An MCP SDK or framework the server's project depends on. */
+export interface DetectedSdk {
+    ecosystem: Ecosystem;
+    name: string;
+    /** Version actually installed (node_modules, site-packages, lockfile), if found. */
+    installed?: string;
+    /** Version or range declared in the manifest. */
+    declared?: string;
+    /** Latest release from the registry (filled in by lookupLatest). */
+    latest?: string;
+    manifest: string;
+    /** Package manager used to upgrade it (npm, pnpm, yarn, bun, uv, poetry, pipenv, pip, go, cargo). */
+    manager: string;
+    /** For pip: the interpreter that owns the environment. */
+    python?: string;
+}
+export interface ProjectInfo {
+    dir: string;
+    sdks: DetectedSdk[];
+}
+/** SDK packages we know, with verified facts about protocol support. */
+export declare const KNOWN_SDKS: Record<Ecosystem, string[]>;
+/**
+ * Finds the project a stdio server runs from: the cwd, directories of file
+ * arguments (e.g. dist/index.js) and a venv interpreter, walking up to the
+ * nearest manifest. Reads files only; no network.
+ */
+export declare function detectProject(command: string, args: string[], cwd: string): ProjectInfo | undefined;
+/**
+ * The version specifier for `name` in a requirements file ("" if unpinned),
+ * or undefined if it isn't listed. Comments and other packages are ignored.
+ */
+export declare function requirementsLine(text: string, name: string): string | undefined;
+/**
+ * The specifier for `name` in pyproject.toml: PEP 621 quoted requirements
+ * ("mcp[cli]>=1.2") or Poetry tables (mcp = "^1.2" / mcp = { version = "^1.2" }).
+ */
+export declare function pyprojectRequirement(text: string, name: string): string | undefined;
+/** Looks up the latest release of each SDK. Failures leave `latest` unset. */
+export declare function lookupLatest(sdks: DetectedSdk[], timeoutMs?: number): Promise<void>;
+/** Compares dotted numeric versions (ignores a leading v and pre-release suffixes). */
+export declare function compareVersions(a: string, b: string): number;
+export declare const majorOf: (v: string) => number;
+/** Registry versions end up in shell commands, so only plain version strings are allowed. */
+export declare const SAFE_VERSION: RegExp;
+/**
+ * Shell command that upgrades the SDK to `version` (or the newest) with the
+ * project's package manager. Unsafe version strings are ignored (→ "latest").
+ */
+export declare function upgradeCommand(sdk: DetectedSdk, requested?: string | undefined): string;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC;AAEzD,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,qGAAqG;IACrG,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED,wEAAwE;AACxE,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAKlD,CAAC;AAKF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAsBnG;AA6FD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ/E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOnF;AAkDD,8EAA8E;AAC9E,wBAAsB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAUvF;AAmBD,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAa5D;AAED,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,WAAyD,CAAC;AAE3F,6FAA6F;AAC7F,eAAO,MAAM,YAAY,QAA6B,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,qBAAa,GAAG,MAAM,CA4B/E"}