@agentxm/extension-model 0.38.0 → 0.39.0

package/dist/src/unstable/agent-capabilities/data/agents/pi.js

@@ -79,16 +79,87 @@ export const piAgent = {
         },
         "mcp-server": {
             native: {
-                availability: { via: "unknown" },
+                availability: { via: "native" },
                 vendorStatus: { state: "active" },
-                notes: "The historical profile describes MCP through TypeScript extensions. Current reviewed product documentation does not resolve the core MCP boundary.",
+                notes: "Requires Pi 1.0 or later. Native runtime verification is pending. Hyphens and underscores collide in exposed server names. Reload the host after configuration changes.",
                 docs: [],
-                sources: ["https://github.com/earendil-works/pi/blob/main/packages/coding-agent/README.md"],
+                sources: [
+                    "https://github.com/earendil-works/pi/blob/v1.0.0/packages/coding-agent/docs/mcp.md",
+                ],
+                scopes: ["project", "user"],
+                standardsCompliance: "full",
+                convention: "vendor",
+                transports: ["stdio", "http"],
+                mcpEnvExpansion: {
+                    variables: "braced",
+                    defaults: false,
+                    fields: ["env", "headers"],
+                    executableValues: true,
+                    homeExpansion: true,
+                },
+                locations: [
+                    {
+                        id: "project",
+                        scope: "project",
+                        root: "project",
+                        path: ".pi/mcp.json",
+                        shape: "file",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                        format: "json",
+                        keyPath: ["mcpServers"],
+                        attribution: "agent",
+                    },
+                    {
+                        id: "user",
+                        scope: "user",
+                        root: "home",
+                        path: ".pi/agent/mcp.json",
+                        configRootRelativePath: "mcp.json",
+                        shape: "file",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                        format: "json",
+                        keyPath: ["mcpServers"],
+                        attribution: "agent",
+                    },
+                ],
+                entryDialect: {
+                    activationField: {
+                        required: { name: "enabled", enabled: true, disabled: false },
+                        accepted: [null, { name: "enabled", enabled: true, disabled: false }],
+                    },
+                    stdio: {
+                        typeField: {
+                            required: { name: "type", value: "stdio" },
+                            accepted: [null, { name: "type", value: "stdio" }],
+                        },
+                        command: "split",
+                        envKey: "env",
+                        cwdKey: "cwd",
+                    },
+                    remote: {
+                        typeField: {
+                            required: { name: "type", value: "http" },
+                            accepted: [
+                                null,
+                                { name: "type", value: "http" },
+                                { name: "type", value: "streamable-http" },
+                            ],
+                        },
+                        urlKey: { "streamable-http": "url" },
+                        headersKey: "headers",
+                    },
+                },
             },
             axm: {
-                status: "unsupported",
+                status: "supported",
                 lastVerified: null,
-                writer: null,
+                writer: { config: { locationIds: ["project", "user"] } },
             },
         },
         subagent: {
@@ -236,7 +307,7 @@ export const piAgent = {
             conditions: [],
             limitations: [
                 "Documentation and public source review only; no vendor runtime execution or AXM configuration verification.",
-                "The former README no longer establishes the deliberate no-MCP/no-per-tool-permissions assertions; those availability claims remain unknown pending current extension/security documentation.",
+                "Pi 1.0 MCP configuration is implemented from its versioned documentation; native runtime acceptance remains pending.",
                 "Capability mechanics not revalidated in this review: skill, mcp-server, subagent, hook, instructions, permissions.",
             ],
             claimScope: "Current terminal product and configuration entry points",

package/dist/src/unstable/agent-capabilities/data/agents/qoder.d.ts

@@ -400,7 +400,7 @@ export declare const qoderAgent: {
             readonly axm: {
                 readonly status: "supported";
                 readonly writer: {
-                    readonly locationIds: readonly ["project"];
+                    readonly locationIds: readonly ["user", "project"];
                     readonly eventMap: "native.events";
                 };
                 readonly lastVerified: "2026-08-05";

package/dist/src/unstable/agent-capabilities/data/agents/qoder.js

@@ -359,7 +359,7 @@ export const qoderAgent = {
             axm: {
                 status: "supported",
                 writer: {
-                    locationIds: ["project"],
+                    locationIds: ["user", "project"],
                     eventMap: "native.events",
                 },
                 lastVerified: "2026-08-05",

package/dist/src/unstable/agent-capabilities/data/agents/qwen-code.d.ts

@@ -402,7 +402,7 @@ export declare const qwenCodeAgent: {
             readonly axm: {
                 readonly status: "supported";
                 readonly writer: {
-                    readonly locationIds: readonly ["project"];
+                    readonly locationIds: readonly ["user", "project"];
                     readonly eventMap: "native.events";
                 };
                 readonly lastVerified: "2026-08-05";

package/dist/src/unstable/agent-capabilities/data/agents/qwen-code.js

@@ -340,7 +340,7 @@ export const qwenCodeAgent = {
             axm: {
                 status: "supported",
                 writer: {
-                    locationIds: ["project"],
+                    locationIds: ["user", "project"],
                     eventMap: "native.events",
                 },
                 lastVerified: "2026-08-05",

package/dist/src/unstable/agent-capabilities/data/agents/roo.d.ts

@@ -140,7 +140,7 @@ export declare const rooAgent: {
             };
             readonly axm: {
                 readonly status: "unsupported";
-                readonly reason: "Native ownership is unverified; AXM can offer a role Skill fallback.";
+                readonly reason: "Native ownership is unverified.";
                 readonly lastVerified: "2026-08-05";
                 readonly writer: null;
             };

package/dist/src/unstable/agent-capabilities/data/agents/roo.js

@@ -125,7 +125,7 @@ export const rooAgent = {
             },
             axm: {
                 status: "unsupported",
-                reason: "Native ownership is unverified; AXM can offer a role Skill fallback.",
+                reason: "Native ownership is unverified.",
                 lastVerified: "2026-08-05",
                 writer: null,
             },

package/dist/src/unstable/agent-capabilities/data/agents/vscode.d.ts

@@ -0,0 +1,263 @@
+export declare const vscodeAgent: {
+    readonly id: "vscode";
+    readonly name: "Visual Studio Code";
+    readonly vendor: "Microsoft";
+    readonly homepage: "https://code.visualstudio.com";
+    readonly interfaces: readonly ["ide-extension"];
+    readonly family: null;
+    readonly rootDir: ".vscode";
+    readonly lifecycle: {
+        readonly state: "active";
+    };
+    readonly detection: {
+        readonly project: {
+            readonly markers: readonly [];
+        };
+        readonly user: {
+            readonly markers: readonly [];
+        };
+    };
+    readonly docs: readonly [{
+        readonly label: "MCP configuration";
+        readonly url: "https://code.visualstudio.com/docs/agents/reference/mcp-configuration";
+    }];
+    readonly capabilities: {
+        readonly skill: {
+            readonly native: {
+                readonly availability: {
+                    readonly via: "unknown";
+                };
+                readonly vendorStatus: {
+                    readonly state: "active";
+                };
+                readonly notes: "This adapter models the local MCP extension-host surface only.";
+                readonly docs: readonly [];
+                readonly sources: readonly ["https://code.visualstudio.com/docs/agents/reference/mcp-configuration"];
+            };
+            readonly axm: {
+                readonly status: "unsupported";
+                readonly writer: null;
+                readonly lastVerified: null;
+            };
+        };
+        readonly subagent: {
+            readonly native: {
+                readonly availability: {
+                    readonly via: "unknown";
+                };
+                readonly vendorStatus: {
+                    readonly state: "active";
+                };
+                readonly notes: "This adapter models the local MCP extension-host surface only.";
+                readonly docs: readonly [];
+                readonly sources: readonly ["https://code.visualstudio.com/docs/agents/reference/mcp-configuration"];
+            };
+            readonly axm: {
+                readonly status: "unsupported";
+                readonly writer: null;
+                readonly lastVerified: null;
+            };
+        };
+        readonly hook: {
+            readonly native: {
+                readonly availability: {
+                    readonly via: "unknown";
+                };
+                readonly vendorStatus: {
+                    readonly state: "active";
+                };
+                readonly notes: "This adapter models the local MCP extension-host surface only.";
+                readonly docs: readonly [];
+                readonly sources: readonly ["https://code.visualstudio.com/docs/agents/reference/mcp-configuration"];
+            };
+            readonly axm: {
+                readonly status: "unsupported";
+                readonly writer: null;
+                readonly lastVerified: null;
+            };
+        };
+        readonly "mcp-server": {
+            readonly native: {
+                readonly availability: {
+                    readonly via: "native";
+                };
+                readonly vendorStatus: {
+                    readonly state: "active";
+                };
+                readonly notes: "Local extension host only. Select the absolute user-profile mcp.json path with AXM_VSCODE_USER_MCP_CONFIG. Trust, input prompts, OAuth, policies and remote windows remain host-owned. Native runtime acceptance is pending.";
+                readonly docs: readonly [];
+                readonly sources: readonly ["https://code.visualstudio.com/docs/agents/reference/mcp-configuration"];
+                readonly scopes: readonly ["project", "user"];
+                readonly standardsCompliance: "full";
+                readonly convention: "vendor";
+                readonly transports: readonly ["stdio", "http", "sse"];
+                readonly mcpEnvExpansion: {
+                    readonly variables: "env-colon";
+                    readonly defaults: false;
+                };
+                readonly locations: readonly [{
+                    readonly id: "project";
+                    readonly scope: "project";
+                    readonly root: "project";
+                    readonly path: ".vscode/mcp.json";
+                    readonly shape: "file";
+                    readonly role: "primary";
+                    readonly status: "canonical";
+                    readonly applicability: {
+                        readonly kind: "always";
+                    };
+                    readonly provenance: {
+                        readonly kind: "capability-sources";
+                    };
+                    readonly format: "jsonc";
+                    readonly keyPath: readonly ["servers"];
+                    readonly attribution: "agent";
+                }, {
+                    readonly id: "user";
+                    readonly scope: "user";
+                    readonly root: "home";
+                    readonly path: "mcp.json";
+                    readonly selectedFile: "vscode-user-mcp";
+                    readonly shape: "file";
+                    readonly role: "primary";
+                    readonly status: "canonical";
+                    readonly applicability: {
+                        readonly kind: "always";
+                    };
+                    readonly provenance: {
+                        readonly kind: "capability-sources";
+                    };
+                    readonly format: "jsonc";
+                    readonly keyPath: readonly ["servers"];
+                    readonly attribution: "agent";
+                }, {
+                    readonly id: "agent-host-project";
+                    readonly scope: "project";
+                    readonly root: "project";
+                    readonly path: ".mcp.json";
+                    readonly shape: "file";
+                    readonly role: "additional";
+                    readonly status: "canonical";
+                    readonly applicability: {
+                        readonly kind: "conditional";
+                        readonly condition: "VS Code Agent Host is selected; local extension-host configuration alone does not establish this reader.";
+                    };
+                    readonly provenance: {
+                        readonly kind: "capability-sources";
+                    };
+                    readonly format: "json";
+                    readonly keyPath: readonly ["mcpServers"];
+                    readonly attribution: "shared";
+                }, {
+                    readonly id: "agent-host-user";
+                    readonly scope: "user";
+                    readonly root: "home";
+                    readonly path: ".copilot/mcp-config.json";
+                    readonly shape: "file";
+                    readonly role: "additional";
+                    readonly status: "canonical";
+                    readonly applicability: {
+                        readonly kind: "conditional";
+                        readonly condition: "VS Code Agent Host is selected with the default Copilot home.";
+                    };
+                    readonly provenance: {
+                        readonly kind: "capability-sources";
+                    };
+                    readonly format: "json";
+                    readonly keyPath: readonly ["mcpServers"];
+                    readonly attribution: "shared";
+                }];
+                readonly entryDialect: {
+                    readonly activationField: {
+                        readonly required: null;
+                        readonly accepted: readonly [null];
+                    };
+                    readonly stdio: {
+                        readonly typeField: {
+                            readonly required: {
+                                readonly name: "type";
+                                readonly value: "stdio";
+                            };
+                            readonly accepted: readonly [{
+                                readonly name: "type";
+                                readonly value: "stdio";
+                            }];
+                        };
+                        readonly command: "split";
+                        readonly envKey: "env";
+                        readonly cwdKey: "cwd";
+                    };
+                    readonly remote: {
+                        readonly typeField: {
+                            readonly required: {
+                                readonly name: "type";
+                                readonly value: {
+                                    readonly "streamable-http": "http";
+                                    readonly sse: "sse";
+                                };
+                            };
+                            readonly accepted: readonly [{
+                                readonly name: "type";
+                                readonly value: {
+                                    readonly "streamable-http": "http";
+                                    readonly sse: "sse";
+                                };
+                            }];
+                        };
+                        readonly urlKey: {
+                            readonly "streamable-http": "url";
+                            readonly sse: "url";
+                        };
+                        readonly headersKey: "headers";
+                    };
+                };
+            };
+            readonly axm: {
+                readonly status: "supported";
+                readonly lastVerified: null;
+                readonly writer: {
+                    readonly config: {
+                        readonly locationIds: readonly ["project", "user"];
+                    };
+                };
+            };
+        };
+    };
+    readonly instructions: {
+        readonly native: {
+            readonly availability: {
+                readonly via: "unknown";
+            };
+            readonly vendorStatus: {
+                readonly state: "active";
+            };
+            readonly notes: "This adapter models the local MCP extension-host surface only.";
+            readonly docs: readonly [];
+            readonly sources: readonly ["https://code.visualstudio.com/docs/agents/reference/mcp-configuration"];
+        };
+        readonly axm: {
+            readonly status: "unsupported";
+            readonly writer: null;
+            readonly lastVerified: null;
+        };
+    };
+    readonly permissions: {
+        readonly native: {
+            readonly availability: {
+                readonly via: "unknown";
+            };
+            readonly vendorStatus: {
+                readonly state: "active";
+            };
+            readonly notes: "This adapter models the local MCP extension-host surface only.";
+            readonly docs: readonly [];
+            readonly sources: readonly ["https://code.visualstudio.com/docs/agents/reference/mcp-configuration"];
+        };
+        readonly axm: {
+            readonly status: "unsupported";
+            readonly writer: null;
+            readonly lastVerified: null;
+        };
+    };
+};
+//# sourceMappingURL=vscode.d.ts.map

package/dist/src/unstable/agent-capabilities/data/agents/vscode.js

@@ -0,0 +1,139 @@
+const unreviewed = {
+    native: {
+        availability: { via: "unknown" },
+        vendorStatus: { state: "active" },
+        notes: "This adapter models the local MCP extension-host surface only.",
+        docs: [],
+        sources: ["https://code.visualstudio.com/docs/agents/reference/mcp-configuration"],
+    },
+    axm: { status: "unsupported", writer: null, lastVerified: null },
+};
+export const vscodeAgent = {
+    id: "vscode",
+    name: "Visual Studio Code",
+    vendor: "Microsoft",
+    homepage: "https://code.visualstudio.com",
+    interfaces: ["ide-extension"],
+    family: null,
+    rootDir: ".vscode",
+    lifecycle: { state: "active" },
+    detection: { project: { markers: [] }, user: { markers: [] } },
+    docs: [
+        {
+            label: "MCP configuration",
+            url: "https://code.visualstudio.com/docs/agents/reference/mcp-configuration",
+        },
+    ],
+    capabilities: {
+        skill: unreviewed,
+        subagent: unreviewed,
+        hook: unreviewed,
+        "mcp-server": {
+            native: {
+                availability: { via: "native" },
+                vendorStatus: { state: "active" },
+                notes: "Local extension host only. Select the absolute user-profile mcp.json path with AXM_VSCODE_USER_MCP_CONFIG. Trust, input prompts, OAuth, policies and remote windows remain host-owned. Native runtime acceptance is pending.",
+                docs: [],
+                sources: ["https://code.visualstudio.com/docs/agents/reference/mcp-configuration"],
+                scopes: ["project", "user"],
+                standardsCompliance: "full",
+                convention: "vendor",
+                transports: ["stdio", "http", "sse"],
+                mcpEnvExpansion: { variables: "env-colon", defaults: false },
+                locations: [
+                    {
+                        id: "project",
+                        scope: "project",
+                        root: "project",
+                        path: ".vscode/mcp.json",
+                        shape: "file",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                        format: "jsonc",
+                        keyPath: ["servers"],
+                        attribution: "agent",
+                    },
+                    {
+                        id: "user",
+                        scope: "user",
+                        root: "home",
+                        path: "mcp.json",
+                        selectedFile: "vscode-user-mcp",
+                        shape: "file",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                        format: "jsonc",
+                        keyPath: ["servers"],
+                        attribution: "agent",
+                    },
+                    {
+                        id: "agent-host-project",
+                        scope: "project",
+                        root: "project",
+                        path: ".mcp.json",
+                        shape: "file",
+                        role: "additional",
+                        status: "canonical",
+                        applicability: {
+                            kind: "conditional",
+                            condition: "VS Code Agent Host is selected; local extension-host configuration alone does not establish this reader.",
+                        },
+                        provenance: { kind: "capability-sources" },
+                        format: "json",
+                        keyPath: ["mcpServers"],
+                        attribution: "shared",
+                    },
+                    {
+                        id: "agent-host-user",
+                        scope: "user",
+                        root: "home",
+                        path: ".copilot/mcp-config.json",
+                        shape: "file",
+                        role: "additional",
+                        status: "canonical",
+                        applicability: {
+                            kind: "conditional",
+                            condition: "VS Code Agent Host is selected with the default Copilot home.",
+                        },
+                        provenance: { kind: "capability-sources" },
+                        format: "json",
+                        keyPath: ["mcpServers"],
+                        attribution: "shared",
+                    },
+                ],
+                entryDialect: {
+                    activationField: { required: null, accepted: [null] },
+                    stdio: {
+                        typeField: {
+                            required: { name: "type", value: "stdio" },
+                            accepted: [{ name: "type", value: "stdio" }],
+                        },
+                        command: "split",
+                        envKey: "env",
+                        cwdKey: "cwd",
+                    },
+                    remote: {
+                        typeField: {
+                            required: { name: "type", value: { "streamable-http": "http", sse: "sse" } },
+                            accepted: [{ name: "type", value: { "streamable-http": "http", sse: "sse" } }],
+                        },
+                        urlKey: { "streamable-http": "url", sse: "url" },
+                        headersKey: "headers",
+                    },
+                },
+            },
+            axm: {
+                status: "supported",
+                lastVerified: null,
+                writer: { config: { locationIds: ["project", "user"] } },
+            },
+        },
+    },
+    instructions: unreviewed,
+    permissions: unreviewed,
+};
+//# sourceMappingURL=vscode.js.map

package/dist/src/unstable/agent-capabilities/derive.d.ts

@@ -6,7 +6,7 @@
 import type { AgentDescriptor } from "../agents/types.js";
 import { type ExtensionType } from "../extensions/common.js";
 import { type LeafExtensionType } from "../extension-types/schema.js";
-import { type Agent, type AgentExtensionCapability, type AxmSupport, type CanonicalHookEventId, type CanonicalHookToolId, type HookBlockOutcome, type HookDecisionCapability, type HookMechanismFamily, type HookModifyOperation, type StandardsCompliance } from "./schema.js";
+import { type Agent, type AgentExtensionCapability, type AxmSupport, type CanonicalHookEventId, type HookBlockOutcome, type HookDecisionCapability, type HookMechanismFamily, type HookModifyOperation, type StandardsCompliance } from "./schema.js";
 import { type PerAgentType } from "../extensions/common.js";
 /** @experimental This API is unstable and may change without notice. */
 export interface CapabilityListing {
@@ -64,29 +64,21 @@ export declare const getSupportedAgentsForExtensionType: (type: LeafExtensionTyp
 export declare const getSupportedAgentsForExtension: (extension: ExtensionCompatibilityInput, catalog?: ReadonlyArray<Agent>) => ReadonlyArray<Agent>;
 /** @experimental This API is unstable and may change without notice. */
 export type HookDecisionKind = HookDecisionCapability["kind"];
-/** @experimental This API is unstable and may change without notice. */
-export type HookDecisionRequirement = {
-    readonly kind: "observe";
-} | {
-    readonly kind: "block";
+/** Exact native outcomes required by one implementation binding. */
+export interface HookDecisionRequirement {
     readonly outcomes?: ReadonlyArray<HookBlockOutcome> | undefined;
-} | {
-    readonly kind: "modify";
     readonly operations?: ReadonlyArray<HookModifyOperation> | undefined;
-};
-/** @experimental This API is unstable and may change without notice. */
+}
+/** Structural contract accepts native bindings without depending on the manifest module. */
 export interface HookInstallBinding {
-    readonly on: CanonicalHookEventId;
-    readonly match?: {
-        readonly tools?: ReadonlyArray<CanonicalHookToolId> | undefined;
-    } | undefined;
-    readonly matcherRaw?: string | undefined;
-    readonly targets?: Readonly<Record<string, {
-        readonly matcherRaw?: string | undefined;
-    }>> | undefined;
-    readonly requires?: {
-        readonly decision: HookDecisionRequirement;
-    } | undefined;
+    readonly event: string;
+    readonly matcher?: string | undefined;
+    readonly handler: {
+        readonly type: string;
+        readonly name?: string | undefined;
+        readonly timeoutMs?: number | undefined;
+    };
+    readonly requires?: HookDecisionRequirement | undefined;
 }
 /** @experimental This API is unstable and may change without notice. */
 export interface HookInstallabilityVerdict {
@@ -120,7 +112,7 @@ export declare const canonicalCoverage: (agent: Agent) => {
         readonly operations: readonly ["modify-input" | "inject-context" | "modify-output" | "synthesize" | "redact", ...("modify-input" | "inject-context" | "modify-output" | "synthesize" | "redact")[]];
     })[];
 };
-/** @experimental This API is unstable and may change without notice. */
+/** Check exact native semantics; a canonical event never chooses an implementation. */
 export declare const installable: (agent: Agent, binding: HookInstallBinding) => HookInstallabilityVerdict;
 /** @experimental This API is unstable and may change without notice. */
 export declare const deriveHookPortability: (agent: Agent, requirement: HookPortabilityRequirement) => HookPortabilityVerdict;