@agentxm/extension-model 0.29.4 → 0.30.2

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

@@ -3,7 +3,6 @@
  *
  * @experimental This API is unstable and may change without notice.
  */
-import * as Schema from "effect/Schema";
 import { adalAgent, aiderDeskAgent, ampAgent, antigravityCliAgent, antigravityAgent, augmentAgent, chatgptAgent, claudeAiAgent, claudeCodeAgent, clineAgent, codeartsAgentAgent, codebuddyAgent, codemakerAgent, codestudioAgent, codexAgent, commandCodeAgent, continueAgent, cortexAgent, coworkAgent, crushAgent, cursorAgent, deepagentsAgent, devinAgent, dextoAgent, droidAgent, firebenderAgent, forgecodeAgent, geminiCliAgent, geminiAppAgent, githubCopilotCliAgent, gooseAgent, grokCliAgent, hermesAgent, ibmBobAgent, iflowCliAgent, junieAgent, lingmaAgent, kiloAgent, kimiCliAgent, kiroCliAgent, kodeAgent, mcpjamAgent, minimaxCodeAgent, mistralVibeAgent, muxAgent, neovateAgent, openclawAgent, opencodeAgent, openhandsAgent, onaAgent, piAgent, pochiAgent, qoderAgent, qoderCnAgent, qwenCodeAgent, replitAgent, rooAgent, rovodevAgent, tabnineCliAgent, traeCnAgent, traeAgent, warpAgent, windsurfAgent, zencoderAgent, zedAgent, zenflowAgent, } from "./data/agents/index.js";
 const defineCatalog = (entries) => entries;
 /** @experimental This API is unstable and may change without notice. */
@@ -72,71 +71,6 @@ export const CONFIGURABLE_AGENTS_BY_ID = defineCatalog({
     zenflow: zenflowAgent,
 });
 /** @experimental This API is unstable and may change without notice. */
-export const CONFIGURABLE_AGENT_IDS = [
-    "adal",
-    "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",
-];
-/** @experimental This API is unstable and may change without notice. */
 export const HOSTED_AGENTS_BY_ID = defineCatalog({
     chatgpt: chatgptAgent,
     "claude-ai": claudeAiAgent,
@@ -144,29 +78,10 @@ export const HOSTED_AGENTS_BY_ID = defineCatalog({
     "gemini-app": geminiAppAgent,
 });
 /** @experimental This API is unstable and may change without notice. */
-export const HOSTED_AGENT_IDS = [
-    "chatgpt",
-    "claude-ai",
-    "cowork",
-    "gemini-app",
-];
-/** @experimental This API is unstable and may change without notice. */
 export const AGENTS_BY_ID = defineCatalog({
     ...CONFIGURABLE_AGENTS_BY_ID,
     ...HOSTED_AGENTS_BY_ID,
 });
 /** @experimental This API is unstable and may change without notice. */
-export const AGENT_IDS = [
-    ...CONFIGURABLE_AGENT_IDS,
-    ...HOSTED_AGENT_IDS,
-];
-/** @experimental This API is unstable and may change without notice. */
-export const AgentIdSchema = Schema.Literals(AGENT_IDS).annotate({
-    identifier: "AgentId",
-    title: "Agent ID",
-    description: "Verified coding agent identifier in the capability catalog.",
-    examples: ["claude-code", "codex", "cursor"],
-});
-/** @experimental This API is unstable and may change without notice. */
 export const AGENTS = Object.values(AGENTS_BY_ID);
 //# sourceMappingURL=catalog.js.map

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

@@ -95,7 +95,7 @@ export declare const codexAgent: {
             };
             readonly axm: {
                 readonly status: "supported";
-                readonly lastVerified: "2026-08-05";
+                readonly lastVerified: "2026-09-12";
                 readonly writer: {
                     readonly config: {
                         readonly serversKey: "mcp_servers";
@@ -129,6 +129,7 @@ export declare const codexAgent: {
                             };
                             readonly command: "split";
                             readonly envKey: "env";
+                            readonly envVarsKey: "env_vars";
                         };
                         readonly remote: {
                             readonly typeField: {

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

@@ -80,7 +80,7 @@ export const codexAgent = {
             },
             axm: {
                 status: "supported",
-                lastVerified: "2026-08-05",
+                lastVerified: "2026-09-12",
                 writer: {
                     config: {
                         serversKey: "mcp_servers",
@@ -106,6 +106,7 @@ export const codexAgent = {
                             typeField: { required: null, accepted: [null] },
                             command: "split",
                             envKey: "env",
+                            envVarsKey: "env_vars",
                         },
                         remote: {
                             typeField: { required: null, accepted: [null] },

package/dist/src/unstable/agent-capabilities/data/agents/github-copilot-cli.d.ts

@@ -76,19 +76,19 @@ export declare const githubCopilotCliAgent: {
                 };
                 readonly notes: null;
                 readonly docs: readonly [];
-                readonly sources: readonly ["https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers", "https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-config-dir-reference", "https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference"];
+                readonly sources: readonly ["https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers", "https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-config-dir-reference", "https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference", "https://github.com/github/copilot-cli/issues/1232#issuecomment-4198097885"];
                 readonly scopes: readonly ["user", "project"];
                 readonly standardsCompliance: "full";
                 readonly convention: "vendor";
                 readonly transports: readonly ["stdio", "http", "sse"];
                 readonly mcpEnvExpansion: {
-                    readonly variables: "none";
+                    readonly variables: "braced";
                     readonly defaults: false;
                 };
             };
             readonly axm: {
                 readonly status: "supported";
-                readonly lastVerified: "2026-08-05";
+                readonly lastVerified: "2026-09-12";
                 readonly writer: {
                     readonly config: {
                         readonly serversKey: "mcpServers";

package/dist/src/unstable/agent-capabilities/data/agents/github-copilot-cli.js

@@ -67,19 +67,20 @@ export const githubCopilotCliAgent = {
                     "https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers",
                     "https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-config-dir-reference",
                     "https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference",
+                    "https://github.com/github/copilot-cli/issues/1232#issuecomment-4198097885",
                 ],
                 scopes: ["user", "project"],
                 standardsCompliance: "full",
                 convention: "vendor",
                 transports: ["stdio", "http", "sse"],
                 mcpEnvExpansion: {
-                    variables: "none",
+                    variables: "braced",
                     defaults: false,
                 },
             },
             axm: {
                 status: "supported",
-                lastVerified: "2026-08-05",
+                lastVerified: "2026-09-12",
                 writer: {
                     config: {
                         serversKey: "mcpServers",

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

@@ -108,8 +108,8 @@ export interface HookPortabilityVerdict {
 export declare const canonicalCoverage: (agent: Agent) => {
     events: readonly ("session.start" | "prompt.submit" | "turn.end" | "tool.pre" | "tool.post" | "subagent.stop" | "compaction.pre")[];
     tools: readonly ("file.read" | "file.write" | "file.edit" | "shell.exec" | "web.fetch" | "mcp.call")[];
-    mechanism: readonly ("command-stdin" | "raw")[];
-    matcherKinds: readonly ("regex" | "literal-list" | "glob" | "tool-category" | "exact-substring" | "none-imperative")[];
+    mechanism: readonly ("raw" | "command-stdin")[];
+    matcherKinds: readonly ("regex" | "glob" | "literal-list" | "tool-category" | "exact-substring" | "none-imperative")[];
     decision: ({
         readonly kind: "observe";
     } | {

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

@@ -4,7 +4,8 @@
  * @experimental This API is unstable and may change without notice.
  */
 import { PER_AGENT_EXTENSION_TYPES } from "../extensions/common.js";
-import { AGENTS, CONFIGURABLE_AGENT_IDS } from "./catalog.js";
+import { AGENTS } from "./catalog.js";
+import { CONFIGURABLE_AGENT_IDS } from "./identity.js";
 import { LEAF_EXTENSION_TYPES } from "../extension-types/schema.js";
 import { SUPPORTED_AXM_SUPPORT, } from "./schema.js";
 import {} from "../extensions/common.js";

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

@@ -0,0 +1,17 @@
+/** 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", "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"];
+/** @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. */
+export declare const HOSTED_AGENT_IDS: readonly ["chatgpt", "claude-ai", "cowork", "gemini-app"];
+/** @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", "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"];
+/** @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", "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"]>;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1,79 @@
+/** 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 const CONFIGURABLE_AGENT_IDS = [
+    "adal",
+    "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",
+];
+/** @experimental This API is unstable and may change without notice. */
+export const HOSTED_AGENT_IDS = ["chatgpt", "claude-ai", "cowork", "gemini-app"];
+/** @experimental This API is unstable and may change without notice. */
+export const AGENT_IDS = [...CONFIGURABLE_AGENT_IDS, ...HOSTED_AGENT_IDS];
+/** @experimental This API is unstable and may change without notice. */
+export const AgentIdSchema = Schema.Literals(AGENT_IDS).annotate({
+    identifier: "AgentId",
+    title: "Agent ID",
+    description: "Verified coding agent identifier in the capability catalog.",
+    examples: ["claude-code", "codex", "cursor"],
+});
+//# sourceMappingURL=identity.js.map

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

@@ -10,6 +10,7 @@ export { type PerAgentType } from "../extensions/common.js";
 export { STANDARDS } from "../extension-types/standards.js";
 export { CAPABILITY_VERIFICATION_BUDGET_DAYS, capabilityVerificationAgeReport, type AgentCapabilitySlot, type CapabilityVerificationAge, } from "./verification.js";
 export { agentCapabilityStatus, agentSupportsType, axmIntegrationStatus, canonicalCoverage, deriveAgentDescriptor, deriveSkillConvention, deriveHookPortability, getSupportedAgentsForExtension, getSupportedAgentsForExtensionType, getSupportedAgentsForExtensionTypes, getSupportedExtensionTypesForAgent, isCapabilitySupported, isLeafExtensionType, listCapabilities, installable, toNativeAgent, type AgentCapabilityStatus, type AxmIntegrationStatus, type CapabilityListing, type ExtensionCompatibilityInput, type HookDecisionKind, type HookDecisionRequirement, type HookInstallabilityVerdict, type HookInstallBinding, type HookPortabilityRequirement, type HookPortabilityVerdict, type NativeAgent, type NativeAgentCapabilities, } from "./derive.js";
-export { AGENTS, AGENTS_BY_ID, AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENTS_BY_ID, CONFIGURABLE_AGENT_IDS, HOSTED_AGENTS_BY_ID, HOSTED_AGENT_IDS, type AgentId, type ConfigurableAgentId, type HostedAgentId, } from "./catalog.js";
+export { AGENTS, AGENTS_BY_ID, CONFIGURABLE_AGENTS_BY_ID, HOSTED_AGENTS_BY_ID } from "./catalog.js";
+export { AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENT_IDS, HOSTED_AGENT_IDS, type AgentId, type ConfigurableAgentId, type HostedAgentId, } from "./identity.js";
 export { agentById } from "./lookup.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -10,6 +10,7 @@ export {} from "../extensions/common.js";
 export { STANDARDS } from "../extension-types/standards.js";
 export { CAPABILITY_VERIFICATION_BUDGET_DAYS, capabilityVerificationAgeReport, } from "./verification.js";
 export { agentCapabilityStatus, agentSupportsType, axmIntegrationStatus, canonicalCoverage, deriveAgentDescriptor, deriveSkillConvention, deriveHookPortability, getSupportedAgentsForExtension, getSupportedAgentsForExtensionType, getSupportedAgentsForExtensionTypes, getSupportedExtensionTypesForAgent, isCapabilitySupported, isLeafExtensionType, listCapabilities, installable, toNativeAgent, } from "./derive.js";
-export { AGENTS, AGENTS_BY_ID, AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENTS_BY_ID, CONFIGURABLE_AGENT_IDS, HOSTED_AGENTS_BY_ID, HOSTED_AGENT_IDS, } from "./catalog.js";
+export { AGENTS, AGENTS_BY_ID, CONFIGURABLE_AGENTS_BY_ID, HOSTED_AGENTS_BY_ID } from "./catalog.js";
+export { AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENT_IDS, HOSTED_AGENT_IDS, } from "./identity.js";
 export { agentById } from "./lookup.js";
 //# sourceMappingURL=index.js.map

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

@@ -3,7 +3,7 @@
  *
  * @experimental This API is unstable and may change without notice.
  */
-import { type AgentId } from "./catalog.js";
+import { type AgentId } from "./identity.js";
 import type { Agent } from "./schema.js";
 /** @experimental This API is unstable and may change without notice. */
 export declare const agentById: (id: AgentId) => Agent;

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

@@ -4,6 +4,7 @@
  * @experimental This API is unstable and may change without notice.
  */
 import { AGENTS_BY_ID } from "./catalog.js";
+import {} from "./identity.js";
 /** @experimental This API is unstable and may change without notice. */
 export const agentById = (id) => AGENTS_BY_ID[id];
 //# sourceMappingURL=lookup.js.map

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

@@ -1012,6 +1012,8 @@ export declare const McpStdioDialectSchema: Schema.Struct<{
     }>;
     readonly command: Schema.Literals<readonly ["split", "array"]>;
     readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
+    /** Native allowlist for forwarding same-name environment variables. */
+    readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
 }>;
 /** @experimental This API is unstable and may change without notice. */
 export type McpStdioDialect = Schema.Schema.Type<typeof McpStdioDialectSchema>;
@@ -1090,6 +1092,8 @@ export declare const McpConfigSchema: Schema.Struct<{
         }>;
         readonly command: Schema.Literals<readonly ["split", "array"]>;
         readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
+        /** Native allowlist for forwarding same-name environment variables. */
+        readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
     }>>;
     readonly remote: Schema.NullOr<Schema.Struct<{
         readonly typeField: Schema.Struct<{
@@ -1234,6 +1238,8 @@ export declare const McpExtensionCapabilitySchema: Schema.Union<readonly [Schema
                     }>;
                     readonly command: Schema.Literals<readonly ["split", "array"]>;
                     readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
+                    /** Native allowlist for forwarding same-name environment variables. */
+                    readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
                 }>>;
                 readonly remote: Schema.NullOr<Schema.Struct<{
                     readonly typeField: Schema.Struct<{
@@ -1337,6 +1343,8 @@ export declare const McpExtensionCapabilitySchema: Schema.Union<readonly [Schema
                     }>;
                     readonly command: Schema.Literals<readonly ["split", "array"]>;
                     readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
+                    /** Native allowlist for forwarding same-name environment variables. */
+                    readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
                 }>>;
                 readonly remote: Schema.NullOr<Schema.Struct<{
                     readonly typeField: Schema.Struct<{
@@ -2147,6 +2155,8 @@ export declare const AgentCapabilitiesSchema: Schema.Struct<{
                         }>;
                         readonly command: Schema.Literals<readonly ["split", "array"]>;
                         readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
+                        /** Native allowlist for forwarding same-name environment variables. */
+                        readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
                     }>>;
                     readonly remote: Schema.NullOr<Schema.Struct<{
                         readonly typeField: Schema.Struct<{
@@ -2250,6 +2260,8 @@ export declare const AgentCapabilitiesSchema: Schema.Struct<{
                         }>;
                         readonly command: Schema.Literals<readonly ["split", "array"]>;
                         readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
+                        /** Native allowlist for forwarding same-name environment variables. */
+                        readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
                     }>>;
                     readonly remote: Schema.NullOr<Schema.Struct<{
                         readonly typeField: Schema.Struct<{
@@ -2988,6 +3000,8 @@ export declare const AgentSchema: Schema.Struct<{
                             }>;
                             readonly command: Schema.Literals<readonly ["split", "array"]>;
                             readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
+                            /** Native allowlist for forwarding same-name environment variables. */
+                            readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
                         }>>;
                         readonly remote: Schema.NullOr<Schema.Struct<{
                             readonly typeField: Schema.Struct<{
@@ -3091,6 +3105,8 @@ export declare const AgentSchema: Schema.Struct<{
                             }>;
                             readonly command: Schema.Literals<readonly ["split", "array"]>;
                             readonly envKey: Schema.NullOr<Schema.NonEmptyString>;
+                            /** Native allowlist for forwarding same-name environment variables. */
+                            readonly envVarsKey: Schema.optional<Schema.NonEmptyString>;
                         }>>;
                         readonly remote: Schema.NullOr<Schema.Struct<{
                             readonly typeField: Schema.Struct<{

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

@@ -607,6 +607,8 @@ export const McpStdioDialectSchema = Schema.Struct({
     typeField: McpTypeFieldSchema,
     command: Schema.Literals(["split", "array"]),
     envKey: Schema.NullOr(Schema.NonEmptyString),
+    /** Native allowlist for forwarding same-name environment variables. */
+    envVarsKey: Schema.optional(Schema.NonEmptyString),
 }).annotate({
     identifier: "McpStdioDialect",
     title: "MCP Stdio Dialect",

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

@@ -5,7 +5,7 @@
  * @packageDocumentation
  */
 import type { Record } from "effect";
-import { CONFIGURABLE_AGENT_IDS, type ConfigurableAgentId } from "../agent-capabilities/catalog.js";
+import { CONFIGURABLE_AGENT_IDS, type ConfigurableAgentId } from "../agent-capabilities/identity.js";
 import type { DetectionMarker, Scope, ScopeDetection, SkillReadPath } from "../agent-capabilities/schema.js";
 /**
  * Skills-specific configuration for an agent.

package/dist/src/unstable/agents/types.js

@@ -4,7 +4,7 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
-import { CONFIGURABLE_AGENT_IDS } from "../agent-capabilities/catalog.js";
+import { CONFIGURABLE_AGENT_IDS, } from "../agent-capabilities/identity.js";
 // -----------------------------------------------------------------------------
 // Agent Identifiers
 // -----------------------------------------------------------------------------

package/dist/src/unstable/extensions/common.d.ts

@@ -5,7 +5,7 @@
  */
 import * as Schema from "effect/Schema";
 import * as Option from "effect/Option";
-import { AgentIdSchema } from "../agent-capabilities/catalog.js";
+import { AgentIdSchema } from "../agent-capabilities/identity.js";
 /**
  * Author information for a manifest.
  *
@@ -512,7 +512,7 @@ export declare const NonPackManifestFields: {
 };
 /**
  * Agent identifier enumeration for supported coding agents: the single
- * definition lives in the capability catalog.
+ * definition lives in the agent identity module.
  *
  * @experimental This API is unstable and may change without notice.
  */

package/dist/src/unstable/extensions/common.js

@@ -7,8 +7,7 @@ import * as EffectRecord from "effect/Record";
 import * as Schema from "effect/Schema";
 import * as Option from "effect/Option";
 import * as Result from "effect/Result";
-import { AgentIdSchema } from "../agent-capabilities/catalog.js";
-import { CONFIGURABLE_AGENT_IDS } from "../agents/types.js";
+import { AgentIdSchema, CONFIGURABLE_AGENT_IDS } from "../agent-capabilities/identity.js";
 import { HANDLE_PATTERN_SOURCE, HandleSchema } from "./handle.js";
 import { parseLicenseExpression } from "./license.js";
 import { CompanionPackageSchema } from "../package-urls/index.js";
@@ -577,7 +576,7 @@ export const NonPackManifestFields = {
 };
 /**
  * Agent identifier enumeration for supported coding agents: the single
- * definition lives in the capability catalog.
+ * definition lives in the agent identity module.
  *
  * @experimental This API is unstable and may change without notice.
  */

package/dist/src/unstable/extensions/name-patterns.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Glob expansion for extension names.
+ *
+ * Expands `*` wildcards against a list of names. Only `*` is supported
+ * as a wildcard — all other characters are treated as literals.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Expand a glob pattern against a list of names.
+ *
+ * Only `*` wildcards are supported. All other characters (including `?`, `[`, `]`)
+ * are treated as literals. Matching is case-sensitive.
+ *
+ * @param pattern - The pattern to match (may contain `*`)
+ * @param names - Available names to match against
+ * @returns Matching names in their original order
+ */
+export declare const expandGlob: (pattern: string, names: ReadonlyArray<string>) => ReadonlyArray<string>;
+/**
+ * Expand multiple glob patterns against a list of extension names.
+ *
+ * Returns the union of all matches, deduplicated, preserving the original
+ * order of `names`.
+ *
+ * @param patterns - Patterns to match (may contain `*`)
+ * @param names - Available names to match against
+ * @returns Matching names in their original order, deduplicated
+ */
+export declare const expandGlobs: (patterns: ReadonlyArray<string>, names: ReadonlyArray<string>) => ReadonlyArray<string>;
+/**
+ * Returns true when an input should be treated as a glob pattern.
+ */
+export declare const isGlobPattern: (input: string) => boolean;
+//# sourceMappingURL=name-patterns.d.ts.map

package/dist/src/unstable/extensions/name-patterns.js

@@ -0,0 +1,75 @@
+/**
+ * Glob expansion for extension names.
+ *
+ * Expands `*` wildcards against a list of names. Only `*` is supported
+ * as a wildcard — all other characters are treated as literals.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Expand a glob pattern against a list of names.
+ *
+ * Only `*` wildcards are supported. All other characters (including `?`, `[`, `]`)
+ * are treated as literals. Matching is case-sensitive.
+ *
+ * @param pattern - The pattern to match (may contain `*`)
+ * @param names - Available names to match against
+ * @returns Matching names in their original order
+ */
+export const expandGlob = (pattern, names) => {
+    const matches = (name) => {
+        let patternIndex = 0;
+        let nameIndex = 0;
+        let wildcardIndex = -1;
+        let wildcardNameIndex = 0;
+        while (nameIndex < name.length) {
+            const token = pattern[patternIndex];
+            if (token !== undefined && token !== "*" && token === name[nameIndex]) {
+                patternIndex += 1;
+                nameIndex += 1;
+            }
+            else if (token === "*") {
+                wildcardIndex = patternIndex;
+                wildcardNameIndex = nameIndex;
+                patternIndex += 1;
+            }
+            else if (wildcardIndex >= 0) {
+                patternIndex = wildcardIndex + 1;
+                wildcardNameIndex += 1;
+                nameIndex = wildcardNameIndex;
+            }
+            else {
+                return false;
+            }
+        }
+        while (pattern[patternIndex] === "*") {
+            patternIndex += 1;
+        }
+        return patternIndex === pattern.length;
+    };
+    return names.filter(matches);
+};
+/**
+ * Expand multiple glob patterns against a list of extension names.
+ *
+ * Returns the union of all matches, deduplicated, preserving the original
+ * order of `names`.
+ *
+ * @param patterns - Patterns to match (may contain `*`)
+ * @param names - Available names to match against
+ * @returns Matching names in their original order, deduplicated
+ */
+export const expandGlobs = (patterns, names) => {
+    const matched = new Set();
+    for (const pattern of patterns) {
+        for (const name of expandGlob(pattern, names)) {
+            matched.add(name);
+        }
+    }
+    return names.filter((n) => matched.has(n));
+};
+/**
+ * Returns true when an input should be treated as a glob pattern.
+ */
+export const isGlobPattern = (input) => input.includes("*");
+//# sourceMappingURL=name-patterns.js.map

package/dist/src/unstable/version-constraints/version-selection.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Select a published extension release from domain facts.
+ *
+ * An exact request may select a yanked release; a range selects the highest
+ * non-yanked release it admits. Transport metadata and consumer-specific
+ * admission policies are outside this algorithm.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+import type * as DateTime from "effect/DateTime";
+import { type VersionEntryLike } from "./version-constraints.js";
+/** The release facts needed for selection, independent of index serialization. */
+export interface ReleasedVersion extends VersionEntryLike {
+    readonly yankedAt?: DateTime.Utc | undefined;
+}
+/**
+ * Select the highest non-yanked version, independent of index order.
+ */
+export declare const selectVersion: <T extends ReleasedVersion>(versions: ReadonlyArray<T>) => Option.Option<T>;
+/**
+ * Resolve an optional exact version or range against an index: an exact
+ * version matches even when yanked; a range excludes yanked versions.
+ */
+export declare const resolveVersionEntry: <T extends ReleasedVersion>(versions: ReadonlyArray<T>, versionRange: Option.Option<string>) => Option.Option<T>;
+//# sourceMappingURL=version-selection.d.ts.map