@agentxm/extension-model 0.38.0 → 0.39.0

package/dist/src/unstable/agent-capabilities/derive.js

@@ -243,75 +243,64 @@ export const canonicalCoverage = (agent) => {
         decision: hook.native.events.flatMap((event) => event.decision),
     };
 };
-const hookEventForBinding = (agent, binding) => {
-    const native = agent.capabilities.hook.native;
-    if (!("events" in native))
-        return undefined;
-    return native.events.find((event) => event.canonical === binding.on);
-};
-const targetMatcherRaw = (agent, binding) => binding.targets?.[agent.id]?.matcherRaw ?? binding.matcherRaw;
-const bindingRequiresMatcher = (agent, binding) => targetMatcherRaw(agent, binding) !== undefined || (binding.match?.tools?.length ?? 0) > 0;
-const decisionRequirementSatisfied = (available, required) => available.some((decision) => decision.kind === required.kind);
-/** @experimental This API is unstable and may change without notice. */
+/** Check exact native semantics; a canonical event never chooses an implementation. */
 export const installable = (agent, binding) => {
     const hook = agent.capabilities.hook;
-    if (hook.native.availability.via === "unknown") {
+    if (hook.native.availability.via === "unknown")
         return {
             installable: false,
             reason: `${agent.name}'s hook availability has not been established.`,
         };
-    }
-    if (hook.native.availability.via === "none") {
-        return { installable: false, reason: `${agent.name} has no hook system.` };
-    }
-    if (hook.native.vendorStatus.state === "removed") {
-        return { installable: false, reason: `${agent.name}'s native hook surface has been removed.` };
-    }
-    if (!("events" in hook.native)) {
-        return { installable: false, reason: `${agent.name} has no modeled hook events.` };
-    }
-    if (hook.axm.writer === null) {
-        return { installable: false, reason: `AXM has not built a hook writer for ${agent.name}.` };
-    }
-    if (!hook.native.mechanism.includes("command-stdin")) {
+    if (hook.native.availability.via === "none" || hook.native.vendorStatus.state === "removed")
+        return { installable: false, reason: `${agent.name} has no available native hook system.` };
+    if (!("events" in hook.native) || hook.axm.writer === null || hook.native.entryDialect === null)
         return {
             installable: false,
-            reason: `AXM's hook writer requires command-stdin invocation for ${agent.name}.`,
+            reason: `AXM has no verified native hook writer for ${agent.name}.`,
         };
-    }
-    const event = hookEventForBinding(agent, binding);
-    if (event === undefined) {
+    if (binding.handler.type !== "command" || !hook.native.mechanism.includes("command-stdin"))
         return {
             installable: false,
-            reason: `${agent.name} does not support ${binding.on}.`,
+            reason: `${agent.name} cannot project the ${binding.handler.type} handler.`,
         };
-    }
-    if (bindingRequiresMatcher(agent, binding) && event.matcher.kind === "none-imperative") {
+    if (binding.handler.name !== undefined &&
+        hook.native.entryDialect.commandNameSerialization !== "manifest")
         return {
             installable: false,
-            reason: `${agent.name} cannot express a matcher for ${binding.on}.`,
+            reason: `${agent.name}'s writer cannot preserve an explicit command name.`,
         };
-    }
-    const tools = binding.match?.tools ?? [];
-    if (tools.length > 0) {
-        const nativeTools = new Set(hook.native.tools.map((tool) => tool.canonical));
-        const missingTools = missingValues(tools, nativeTools);
-        if (missingTools.length > 0) {
-            return {
-                installable: false,
-                reason: `${agent.name} cannot express matcher tool(s): ${missingTools.join(", ")}.`,
-            };
-        }
-    }
-    const requiredDecision = binding.requires?.decision;
-    if (requiredDecision !== undefined &&
-        !decisionRequirementSatisfied(event.decision, requiredDecision)) {
+    if (binding.handler.timeoutMs !== undefined &&
+        hook.native.entryDialect.timeoutSerialization === "seconds" &&
+        binding.handler.timeoutMs % 1000 !== 0)
         return {
             installable: false,
-            reason: `${agent.name} cannot satisfy ${requiredDecision.kind} decisions for ${binding.on}.`,
+            reason: `${agent.name}'s writer accepts whole-second timeouts; the declared milliseconds cannot be represented exactly.`,
         };
-    }
-    return { installable: true, reason: `${agent.name} can install ${binding.on}.` };
+    const matches = hook.native.events.filter((event) => event.nativeName === binding.event);
+    const event = matches[0];
+    if (matches.length !== 1 || event === undefined)
+        return {
+            installable: false,
+            reason: `${agent.name} has no unambiguous native ${binding.event} event.`,
+        };
+    if (binding.matcher !== undefined && event.matcher.kind === "none-imperative")
+        return {
+            installable: false,
+            reason: `${agent.name} cannot express a matcher for ${binding.event}.`,
+        };
+    const outcomes = new Set(event.decision.flatMap((decision) => (decision.kind === "block" ? decision.outcomes : [])));
+    const operations = new Set(event.decision.flatMap((decision) => (decision.kind === "modify" ? decision.operations : [])));
+    const missingOutcomes = missingValues(binding.requires?.outcomes ?? [], outcomes);
+    const missingOperations = missingValues(binding.requires?.operations ?? [], operations);
+    if (missingOutcomes.length > 0 || missingOperations.length > 0)
+        return {
+            installable: false,
+            reason: `${agent.name} ${binding.event} cannot preserve required semantics: ${[...missingOutcomes, ...missingOperations].join(", ")}.`,
+        };
+    return {
+        installable: true,
+        reason: `${agent.name} can project native ${binding.event}; runtime execution remains unverified.`,
+    };
 };
 /** @experimental This API is unstable and may change without notice. */
 export const deriveHookPortability = (agent, requirement) => {

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

@@ -1,7 +1,7 @@
 /** Published coding-agent identities, independent of capability data and adapters. */
 import * as Schema from "effect/Schema";
 /** @experimental This API is unstable and may change without notice. */
-export declare const CONFIGURABLE_AGENT_IDS: readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"];
+export declare const CONFIGURABLE_AGENT_IDS: readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "vscode", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"];
 /** @experimental This API is unstable and may change without notice. */
 export type ConfigurableAgentId = (typeof CONFIGURABLE_AGENT_IDS)[number];
 /** @experimental This API is unstable and may change without notice. */
@@ -11,9 +11,9 @@ export declare const HOSTED_AGENT_IDS: readonly ["chatgpt", "claude-ai", "cowork
 /** @experimental This API is unstable and may change without notice. */
 export type HostedAgentId = (typeof HOSTED_AGENT_IDS)[number];
 /** @experimental This API is unstable and may change without notice. */
-export declare const AGENT_IDS: readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow", "chatgpt", "claude-ai", "cowork", "gemini-app"];
+export declare const AGENT_IDS: readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "vscode", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow", "chatgpt", "claude-ai", "cowork", "gemini-app"];
 /** @experimental This API is unstable and may change without notice. */
 export type AgentId = (typeof AGENT_IDS)[number];
 /** @experimental This API is unstable and may change without notice. */
-export declare const AgentIdSchema: Schema.Literals<readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow", "chatgpt", "claude-ai", "cowork", "gemini-app"]>;
+export declare const AgentIdSchema: Schema.Literals<readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "vscode", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow", "chatgpt", "claude-ai", "cowork", "gemini-app"]>;
 //# sourceMappingURL=identity.d.ts.map

package/dist/src/unstable/agent-capabilities/identity.js

@@ -53,6 +53,7 @@ export const CONFIGURABLE_AGENT_IDS = [
     "openhands",
     "ona",
     "pi",
+    "vscode",
     "pochi",
     "qoder",
     "qoder-cn",

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

@@ -64,6 +64,7 @@ export declare const NativeReadLocationSchema: Schema.Struct<{
     root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
     path: Schema.NonEmptyString;
     configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+    selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
     shape: Schema.Literals<readonly ["directory", "file"]>;
     role: Schema.Literals<readonly ["primary", "additional"]>;
     status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
@@ -480,6 +481,7 @@ export declare const SkillsExtensionCapabilitySchema: Schema.Struct<{
             root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
             path: Schema.NonEmptyString;
             configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+            selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
             shape: Schema.Literals<readonly ["directory", "file"]>;
             role: Schema.Literals<readonly ["primary", "additional"]>;
             status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
@@ -684,6 +686,7 @@ export declare const SubagentsExtensionCapabilitySchema: Schema.Struct<{
             root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
             path: Schema.NonEmptyString;
             configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+            selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
             shape: Schema.Literals<readonly ["directory", "file"]>;
             role: Schema.Literals<readonly ["primary", "additional"]>;
             status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
@@ -899,6 +902,7 @@ export declare const RulesExtensionCapabilitySchema: Schema.Struct<{
             root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
             path: Schema.NonEmptyString;
             configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+            selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
             shape: Schema.Literals<readonly ["directory", "file"]>;
             role: Schema.Literals<readonly ["primary", "additional"]>;
             status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
@@ -1048,6 +1052,7 @@ export declare const NativeConfigReadLocationSchema: Schema.Struct<{
     readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
     readonly path: Schema.NonEmptyString;
     readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
     readonly role: Schema.Literals<readonly ["primary", "additional"]>;
     readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
     readonly applicability: Schema.Union<readonly [Schema.Struct<{
@@ -1164,6 +1169,7 @@ export declare const McpStdioDialectSchema: Schema.Struct<{
     readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
     /** Native allowlist for forwarding same-name environment variables. */
     readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
+    readonly cwdKey: Schema.optionalKey<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type McpStdioDialect = Schema.Schema.Type<typeof McpStdioDialectSchema>;
@@ -1238,6 +1244,7 @@ export declare const McpEntryDialectSchema: Schema.Struct<{
         readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
         /** Native allowlist for forwarding same-name environment variables. */
         readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
+        readonly cwdKey: Schema.optionalKey<Schema.NonEmptyString>;
     }>>;
     readonly remote: Schema.NullOr<Schema.Struct<{
         readonly implicitTransport: Schema.optionalKey<Schema.Literal<"http-or-sse">>;
@@ -1276,8 +1283,11 @@ export declare const McpConfigSchema: Schema.Struct<{
 export type McpConfig = Schema.Schema.Type<typeof McpConfigSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const McpEnvExpansionSchema: Schema.Struct<{
-    readonly variables: Schema.Literals<readonly ["none", "braced", "env-tag"]>;
+    readonly variables: Schema.Literals<readonly ["none", "braced", "env-tag", "env-colon"]>;
     readonly defaults: Schema.Boolean;
+    readonly fields: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["command", "args", "env", "url", "headers", "cwd"]>>>;
+    readonly executableValues: Schema.optionalKey<Schema.Boolean>;
+    readonly homeExpansion: Schema.optionalKey<Schema.Boolean>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type McpEnvExpansion = Schema.Schema.Type<typeof McpEnvExpansionSchema>;
@@ -1319,6 +1329,7 @@ export declare const McpExtensionCapabilitySchema: Schema.Union<readonly [Schema
                 readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
                 /** Native allowlist for forwarding same-name environment variables. */
                 readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
+                readonly cwdKey: Schema.optionalKey<Schema.NonEmptyString>;
             }>>;
             readonly remote: Schema.NullOr<Schema.Struct<{
                 readonly implicitTransport: Schema.optionalKey<Schema.Literal<"http-or-sse">>;
@@ -1358,6 +1369,7 @@ export declare const McpExtensionCapabilitySchema: Schema.Union<readonly [Schema
             readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
             readonly path: Schema.NonEmptyString;
             readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+            readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
             readonly role: Schema.Literals<readonly ["primary", "additional"]>;
             readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
             readonly applicability: Schema.Union<readonly [Schema.Struct<{
@@ -1374,8 +1386,11 @@ export declare const McpExtensionCapabilitySchema: Schema.Union<readonly [Schema
             }>]>;
         }>>;
         readonly mcpEnvExpansion: Schema.optionalKey<Schema.Struct<{
-            readonly variables: Schema.Literals<readonly ["none", "braced", "env-tag"]>;
+            readonly variables: Schema.Literals<readonly ["none", "braced", "env-tag", "env-colon"]>;
             readonly defaults: Schema.Boolean;
+            readonly fields: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["command", "args", "env", "url", "headers", "cwd"]>>>;
+            readonly executableValues: Schema.optionalKey<Schema.Boolean>;
+            readonly homeExpansion: Schema.optionalKey<Schema.Boolean>;
         }>>;
         readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
         readonly convention: Schema.Literals<readonly ["universal", "vendor", "hosted"]>;
@@ -1715,7 +1730,7 @@ export declare const HookEventMappingSchema: Schema.Struct<{
 /** @experimental This API is unstable and may change without notice. */
 export type HookEventMapping = Schema.Schema.Type<typeof HookEventMappingSchema>;
 /** @experimental This API is unstable and may change without notice. */
-export declare const HooksSerializerSchema: Schema.Literals<readonly ["command-stdin"]>;
+export declare const HooksSerializerSchema: Schema.Literals<readonly ["command-stdin", "flat-command-stdin"]>;
 /** @experimental This API is unstable and may change without notice. */
 export type HooksSerializer = Schema.Schema.Type<typeof HooksSerializerSchema>;
 /** @experimental This API is unstable and may change without notice. */
@@ -1732,7 +1747,7 @@ export declare const HookCommandNameSerializationSchema: Schema.Literals<readonl
 export type HookCommandNameSerialization = Schema.Schema.Type<typeof HookCommandNameSerializationSchema>;
 /** @experimental This API is unstable and may change without notice. */
 export declare const HookEntryDialectSchema: Schema.Struct<{
-    readonly serializer: Schema.Literals<readonly ["command-stdin"]>;
+    readonly serializer: Schema.Literals<readonly ["command-stdin", "flat-command-stdin"]>;
     readonly matcherKind: Schema.Literals<readonly ["regex", "literal-list", "glob", "tool-category", "exact-substring", "none-imperative"]>;
     readonly matcherSerialization: Schema.Literals<readonly ["bare", "slash-delimited", "glob"]>;
     readonly timeoutSerialization: Schema.Literals<readonly ["seconds", "milliseconds"]>;
@@ -1752,7 +1767,7 @@ export declare const HooksExtensionCapabilitySchema: Schema.Struct<{
     readonly native: Schema.Union<readonly [Schema.Struct<{
         readonly mechanism: Schema.NonEmptyArray<Schema.Literals<readonly ["command-stdin", "http", "prompt", "agent", "mcp", "raw"]>>;
         readonly entryDialect: Schema.NullOr<Schema.Struct<{
-            readonly serializer: Schema.Literals<readonly ["command-stdin"]>;
+            readonly serializer: Schema.Literals<readonly ["command-stdin", "flat-command-stdin"]>;
             readonly matcherKind: Schema.Literals<readonly ["regex", "literal-list", "glob", "tool-category", "exact-substring", "none-imperative"]>;
             readonly matcherSerialization: Schema.Literals<readonly ["bare", "slash-delimited", "glob"]>;
             readonly timeoutSerialization: Schema.Literals<readonly ["seconds", "milliseconds"]>;
@@ -1769,6 +1784,7 @@ export declare const HooksExtensionCapabilitySchema: Schema.Struct<{
             readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
             readonly path: Schema.NonEmptyString;
             readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+            readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
             readonly role: Schema.Literals<readonly ["primary", "additional"]>;
             readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
             readonly applicability: Schema.Union<readonly [Schema.Struct<{
@@ -1874,7 +1890,7 @@ export declare const HooksExtensionCapabilitySchema: Schema.Struct<{
         readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
         readonly modeling: Schema.Literal<"native-unmodeled">;
         readonly entryDialect: Schema.NullOr<Schema.Struct<{
-            readonly serializer: Schema.Literals<readonly ["command-stdin"]>;
+            readonly serializer: Schema.Literals<readonly ["command-stdin", "flat-command-stdin"]>;
             readonly matcherKind: Schema.Literals<readonly ["regex", "literal-list", "glob", "tool-category", "exact-substring", "none-imperative"]>;
             readonly matcherSerialization: Schema.Literals<readonly ["bare", "slash-delimited", "glob"]>;
             readonly timeoutSerialization: Schema.Literals<readonly ["seconds", "milliseconds"]>;
@@ -1891,6 +1907,7 @@ export declare const HooksExtensionCapabilitySchema: Schema.Struct<{
             readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
             readonly path: Schema.NonEmptyString;
             readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+            readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
             readonly role: Schema.Literals<readonly ["primary", "additional"]>;
             readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
             readonly applicability: Schema.Union<readonly [Schema.Struct<{
@@ -2075,6 +2092,7 @@ export declare const PermissionsExtensionCapabilitySchema: Schema.Struct<{
             readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
             readonly path: Schema.NonEmptyString;
             readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+            readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
             readonly role: Schema.Literals<readonly ["primary", "additional"]>;
             readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
             readonly applicability: Schema.Union<readonly [Schema.Struct<{
@@ -2241,6 +2259,7 @@ export declare const AgentCapabilitiesSchema: Schema.Struct<{
                 root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                 path: Schema.NonEmptyString;
                 configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                 shape: Schema.Literals<readonly ["directory", "file"]>;
                 role: Schema.Literals<readonly ["primary", "additional"]>;
                 status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
@@ -2469,6 +2488,7 @@ export declare const AgentCapabilitiesSchema: Schema.Struct<{
                     readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
                     /** Native allowlist for forwarding same-name environment variables. */
                     readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
+                    readonly cwdKey: Schema.optionalKey<Schema.NonEmptyString>;
                 }>>;
                 readonly remote: Schema.NullOr<Schema.Struct<{
                     readonly implicitTransport: Schema.optionalKey<Schema.Literal<"http-or-sse">>;
@@ -2508,6 +2528,7 @@ export declare const AgentCapabilitiesSchema: Schema.Struct<{
                 readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                 readonly path: Schema.NonEmptyString;
                 readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                 readonly role: Schema.Literals<readonly ["primary", "additional"]>;
                 readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
                 readonly applicability: Schema.Union<readonly [Schema.Struct<{
@@ -2524,8 +2545,11 @@ export declare const AgentCapabilitiesSchema: Schema.Struct<{
                 }>]>;
             }>>;
             readonly mcpEnvExpansion: Schema.optionalKey<Schema.Struct<{
-                readonly variables: Schema.Literals<readonly ["none", "braced", "env-tag"]>;
+                readonly variables: Schema.Literals<readonly ["none", "braced", "env-tag", "env-colon"]>;
                 readonly defaults: Schema.Boolean;
+                readonly fields: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["command", "args", "env", "url", "headers", "cwd"]>>>;
+                readonly executableValues: Schema.optionalKey<Schema.Boolean>;
+                readonly homeExpansion: Schema.optionalKey<Schema.Boolean>;
             }>>;
             readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
             readonly convention: Schema.Literals<readonly ["universal", "vendor", "hosted"]>;
@@ -2750,6 +2774,7 @@ export declare const AgentCapabilitiesSchema: Schema.Struct<{
                 root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                 path: Schema.NonEmptyString;
                 configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                 shape: Schema.Literals<readonly ["directory", "file"]>;
                 role: Schema.Literals<readonly ["primary", "additional"]>;
                 status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
@@ -2950,7 +2975,7 @@ export declare const AgentCapabilitiesSchema: Schema.Struct<{
         readonly native: Schema.Union<readonly [Schema.Struct<{
             readonly mechanism: Schema.NonEmptyArray<Schema.Literals<readonly ["command-stdin", "http", "prompt", "agent", "mcp", "raw"]>>;
             readonly entryDialect: Schema.NullOr<Schema.Struct<{
-                readonly serializer: Schema.Literals<readonly ["command-stdin"]>;
+                readonly serializer: Schema.Literals<readonly ["command-stdin", "flat-command-stdin"]>;
                 readonly matcherKind: Schema.Literals<readonly ["regex", "literal-list", "glob", "tool-category", "exact-substring", "none-imperative"]>;
                 readonly matcherSerialization: Schema.Literals<readonly ["bare", "slash-delimited", "glob"]>;
                 readonly timeoutSerialization: Schema.Literals<readonly ["seconds", "milliseconds"]>;
@@ -2967,6 +2992,7 @@ export declare const AgentCapabilitiesSchema: Schema.Struct<{
                 readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                 readonly path: Schema.NonEmptyString;
                 readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                 readonly role: Schema.Literals<readonly ["primary", "additional"]>;
                 readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
                 readonly applicability: Schema.Union<readonly [Schema.Struct<{
@@ -3072,7 +3098,7 @@ export declare const AgentCapabilitiesSchema: Schema.Struct<{
             readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
             readonly modeling: Schema.Literal<"native-unmodeled">;
             readonly entryDialect: Schema.NullOr<Schema.Struct<{
-                readonly serializer: Schema.Literals<readonly ["command-stdin"]>;
+                readonly serializer: Schema.Literals<readonly ["command-stdin", "flat-command-stdin"]>;
                 readonly matcherKind: Schema.Literals<readonly ["regex", "literal-list", "glob", "tool-category", "exact-substring", "none-imperative"]>;
                 readonly matcherSerialization: Schema.Literals<readonly ["bare", "slash-delimited", "glob"]>;
                 readonly timeoutSerialization: Schema.Literals<readonly ["seconds", "milliseconds"]>;
@@ -3089,6 +3115,7 @@ export declare const AgentCapabilitiesSchema: Schema.Struct<{
                 readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                 readonly path: Schema.NonEmptyString;
                 readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                 readonly role: Schema.Literals<readonly ["primary", "additional"]>;
                 readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
                 readonly applicability: Schema.Union<readonly [Schema.Struct<{
@@ -3387,6 +3414,7 @@ export declare const AgentSchema: Schema.Struct<{
                     root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                     path: Schema.NonEmptyString;
                     configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                    selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                     shape: Schema.Literals<readonly ["directory", "file"]>;
                     role: Schema.Literals<readonly ["primary", "additional"]>;
                     status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
@@ -3615,6 +3643,7 @@ export declare const AgentSchema: Schema.Struct<{
                         readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
                         /** Native allowlist for forwarding same-name environment variables. */
                         readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
+                        readonly cwdKey: Schema.optionalKey<Schema.NonEmptyString>;
                     }>>;
                     readonly remote: Schema.NullOr<Schema.Struct<{
                         readonly implicitTransport: Schema.optionalKey<Schema.Literal<"http-or-sse">>;
@@ -3654,6 +3683,7 @@ export declare const AgentSchema: Schema.Struct<{
                     readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                     readonly path: Schema.NonEmptyString;
                     readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                    readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                     readonly role: Schema.Literals<readonly ["primary", "additional"]>;
                     readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
                     readonly applicability: Schema.Union<readonly [Schema.Struct<{
@@ -3670,8 +3700,11 @@ export declare const AgentSchema: Schema.Struct<{
                     }>]>;
                 }>>;
                 readonly mcpEnvExpansion: Schema.optionalKey<Schema.Struct<{
-                    readonly variables: Schema.Literals<readonly ["none", "braced", "env-tag"]>;
+                    readonly variables: Schema.Literals<readonly ["none", "braced", "env-tag", "env-colon"]>;
                     readonly defaults: Schema.Boolean;
+                    readonly fields: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["command", "args", "env", "url", "headers", "cwd"]>>>;
+                    readonly executableValues: Schema.optionalKey<Schema.Boolean>;
+                    readonly homeExpansion: Schema.optionalKey<Schema.Boolean>;
                 }>>;
                 readonly standardsCompliance: Schema.Literals<readonly ["full", "parity", "partial", "none"]>;
                 readonly convention: Schema.Literals<readonly ["universal", "vendor", "hosted"]>;
@@ -3896,6 +3929,7 @@ export declare const AgentSchema: Schema.Struct<{
                     root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                     path: Schema.NonEmptyString;
                     configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                    selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                     shape: Schema.Literals<readonly ["directory", "file"]>;
                     role: Schema.Literals<readonly ["primary", "additional"]>;
                     status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
@@ -4096,7 +4130,7 @@ export declare const AgentSchema: Schema.Struct<{
             readonly native: Schema.Union<readonly [Schema.Struct<{
                 readonly mechanism: Schema.NonEmptyArray<Schema.Literals<readonly ["command-stdin", "http", "prompt", "agent", "mcp", "raw"]>>;
                 readonly entryDialect: Schema.NullOr<Schema.Struct<{
-                    readonly serializer: Schema.Literals<readonly ["command-stdin"]>;
+                    readonly serializer: Schema.Literals<readonly ["command-stdin", "flat-command-stdin"]>;
                     readonly matcherKind: Schema.Literals<readonly ["regex", "literal-list", "glob", "tool-category", "exact-substring", "none-imperative"]>;
                     readonly matcherSerialization: Schema.Literals<readonly ["bare", "slash-delimited", "glob"]>;
                     readonly timeoutSerialization: Schema.Literals<readonly ["seconds", "milliseconds"]>;
@@ -4113,6 +4147,7 @@ export declare const AgentSchema: Schema.Struct<{
                     readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                     readonly path: Schema.NonEmptyString;
                     readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                    readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                     readonly role: Schema.Literals<readonly ["primary", "additional"]>;
                     readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
                     readonly applicability: Schema.Union<readonly [Schema.Struct<{
@@ -4218,7 +4253,7 @@ export declare const AgentSchema: Schema.Struct<{
                 readonly scopes: Schema.$Array<Schema.Literals<readonly ["user", "project"]>>;
                 readonly modeling: Schema.Literal<"native-unmodeled">;
                 readonly entryDialect: Schema.NullOr<Schema.Struct<{
-                    readonly serializer: Schema.Literals<readonly ["command-stdin"]>;
+                    readonly serializer: Schema.Literals<readonly ["command-stdin", "flat-command-stdin"]>;
                     readonly matcherKind: Schema.Literals<readonly ["regex", "literal-list", "glob", "tool-category", "exact-substring", "none-imperative"]>;
                     readonly matcherSerialization: Schema.Literals<readonly ["bare", "slash-delimited", "glob"]>;
                     readonly timeoutSerialization: Schema.Literals<readonly ["seconds", "milliseconds"]>;
@@ -4235,6 +4270,7 @@ export declare const AgentSchema: Schema.Struct<{
                     readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                     readonly path: Schema.NonEmptyString;
                     readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                    readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                     readonly role: Schema.Literals<readonly ["primary", "additional"]>;
                     readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
                     readonly applicability: Schema.Union<readonly [Schema.Struct<{
@@ -4372,6 +4408,7 @@ export declare const AgentSchema: Schema.Struct<{
                 root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                 path: Schema.NonEmptyString;
                 configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                 shape: Schema.Literals<readonly ["directory", "file"]>;
                 role: Schema.Literals<readonly ["primary", "additional"]>;
                 status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
@@ -4517,6 +4554,7 @@ export declare const AgentSchema: Schema.Struct<{
                 readonly root: Schema.Literals<readonly ["project", "home", "xdg-config"]>;
                 readonly path: Schema.NonEmptyString;
                 readonly configRootRelativePath: Schema.optionalKey<Schema.NonEmptyString>;
+                readonly selectedFile: Schema.optionalKey<Schema.Literal<"vscode-user-mcp">>;
                 readonly role: Schema.Literals<readonly ["primary", "additional"]>;
                 readonly status: Schema.Literals<readonly ["canonical", "compat", "deprecated"]>;
                 readonly applicability: Schema.Union<readonly [Schema.Struct<{

package/dist/src/unstable/agent-capabilities/schema.js

@@ -87,6 +87,7 @@ const NativeReadLocationFields = {
     root: Schema.Literals(["project", "home", "xdg-config"]),
     path: Schema.NonEmptyString,
     configRootRelativePath: Schema.optionalKey(Schema.NonEmptyString),
+    selectedFile: Schema.optionalKey(Schema.Literal("vscode-user-mcp")),
     shape: Schema.Literals(["directory", "file"]),
     role: Schema.Literals(["primary", "additional"]),
     status: Schema.Literals(["canonical", "compat", "deprecated"]),
@@ -700,6 +701,7 @@ export const McpStdioDialectSchema = Schema.Struct({
     envKey: Schema.NullOr(Schema.NonEmptyString),
     /** Native allowlist for forwarding same-name environment variables. */
     envVarsKey: Schema.optional(Schema.NonEmptyString),
+    cwdKey: Schema.optionalKey(Schema.NonEmptyString),
 }).annotate({
     identifier: "McpStdioDialect",
     title: "MCP Stdio Dialect",
@@ -749,8 +751,11 @@ export const McpConfigSchema = Schema.Struct({
 });
 /** @experimental This API is unstable and may change without notice. */
 export const McpEnvExpansionSchema = Schema.Struct({
-    variables: Schema.Literals(["none", "braced", "env-tag"]),
+    variables: Schema.Literals(["none", "braced", "env-tag", "env-colon"]),
     defaults: Schema.Boolean,
+    fields: Schema.optionalKey(Schema.Array(Schema.Literals(["command", "args", "env", "url", "headers", "cwd"]))),
+    executableValues: Schema.optionalKey(Schema.Boolean),
+    homeExpansion: Schema.optionalKey(Schema.Boolean),
 }).annotate({
     identifier: "McpEnvExpansion",
     title: "MCP Env Expansion",
@@ -1023,7 +1028,10 @@ export const HookEventMappingSchema = Schema.Struct({
     description: "Native hook event name with its canonical AXM event pointer and provenance.",
 });
 /** @experimental This API is unstable and may change without notice. */
-export const HooksSerializerSchema = Schema.Literals(["command-stdin"]).annotate({
+export const HooksSerializerSchema = Schema.Literals([
+    "command-stdin",
+    "flat-command-stdin",
+]).annotate({
     identifier: "HooksSerializer",
     title: "Hooks Serializer",
     description: "Native settings serializer AXM uses for managed hook declarations.",

package/dist/src/unstable/agents/types.d.ts

@@ -59,7 +59,7 @@ export interface AgentDetectionDescriptor {
 /** @experimental This API is unstable and may change without notice. */
 export { CONFIGURABLE_AGENT_IDS, type ConfigurableAgentId };
 /** Real agents that can participate in native materialization. @experimental */
-export declare const MATERIALIZATION_TARGET_IDS: readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"];
+export declare const MATERIALIZATION_TARGET_IDS: readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "vscode", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"];
 /** @experimental This API is unstable and may change without notice. */
 export type MaterializationTargetId = (typeof MATERIALIZATION_TARGET_IDS)[number];
 /**