@agentxm/extension-model 0.36.0 → 0.37.3

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

@@ -24,14 +24,74 @@ export const opencodeAgent = {
                 vendorStatus: { state: "active" },
                 notes: null,
                 docs: [],
-                sources: ["https://opencode.ai/docs/skills/"],
+                sources: [
+                    "https://opencode.ai/docs/skills/",
+                    "https://github.com/anomalyco/opencode/blob/dev/packages/core/src/global.ts",
+                ],
                 scopes: ["user", "project"],
                 standardsCompliance: "full",
                 convention: "vendor",
-                directory: ".opencode/skills",
-                additionalReadPaths: [
-                    { path: ".claude/skills", status: "compat" },
-                    { path: ".agents/skills", status: "compat" },
+                locations: [
+                    {
+                        scope: "project",
+                        root: "project",
+                        path: ".opencode/skills",
+                        shape: "directory",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                    },
+                    {
+                        scope: "project",
+                        root: "project",
+                        path: ".claude/skills",
+                        shape: "directory",
+                        role: "additional",
+                        status: "compat",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                    },
+                    {
+                        scope: "project",
+                        root: "project",
+                        path: ".agents/skills",
+                        shape: "directory",
+                        role: "additional",
+                        status: "compat",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                    },
+                    {
+                        scope: "user",
+                        root: "xdg-config",
+                        path: "opencode/skills",
+                        shape: "directory",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                    },
+                    {
+                        scope: "user",
+                        root: "home",
+                        path: ".claude/skills",
+                        shape: "directory",
+                        role: "additional",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                    },
+                    {
+                        scope: "user",
+                        root: "home",
+                        path: ".agents/skills",
+                        shape: "directory",
+                        role: "additional",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                    },
                 ],
             },
             axm: {
@@ -44,23 +104,136 @@ export const opencodeAgent = {
             native: {
                 availability: { via: "native" },
                 vendorStatus: { state: "active" },
-                notes: "OpenCode V2 stores server definitions beneath mcp.servers; the native configuration is valid but requires a nested-map writer.",
+                notes: "OpenCode V2 stores server definitions beneath mcp.servers and expands {env:NAME} references without shell defaults.",
                 docs: [],
-                sources: ["https://opencode.ai/v2/docs/mcp-servers", "https://opencode.ai/v2/docs/config"],
+                sources: [
+                    "https://opencode.ai/v2/docs/mcp-servers",
+                    "https://opencode.ai/v2/docs/config",
+                    "https://github.com/anomalyco/opencode/blob/dev/packages/core/src/config.ts",
+                    "https://github.com/anomalyco/opencode/blob/dev/packages/core/src/config/mcp.ts",
+                    "https://github.com/anomalyco/opencode/blob/dev/packages/core/src/global.ts",
+                ],
                 scopes: ["user", "project"],
                 standardsCompliance: "full",
                 convention: "vendor",
                 transports: ["stdio", "http"],
                 mcpEnvExpansion: {
-                    variables: "none",
+                    variables: "env-tag",
                     defaults: false,
                 },
+                locations: [
+                    {
+                        id: "project",
+                        scope: "project",
+                        root: "project",
+                        path: "opencode.json",
+                        shape: "file",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                        format: "json",
+                        keyPath: ["mcp", "servers"],
+                        attribution: "agent",
+                    },
+                    {
+                        id: "project-jsonc",
+                        scope: "project",
+                        root: "project",
+                        path: "opencode.jsonc",
+                        shape: "file",
+                        role: "additional",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                        format: "jsonc",
+                        keyPath: ["mcp", "servers"],
+                        attribution: "agent",
+                    },
+                    {
+                        id: "project-directory",
+                        scope: "project",
+                        root: "project",
+                        path: ".opencode/opencode.json",
+                        shape: "file",
+                        role: "additional",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                        format: "json",
+                        keyPath: ["mcp", "servers"],
+                        attribution: "agent",
+                    },
+                    {
+                        id: "project-directory-jsonc",
+                        scope: "project",
+                        root: "project",
+                        path: ".opencode/opencode.jsonc",
+                        shape: "file",
+                        role: "additional",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                        format: "jsonc",
+                        keyPath: ["mcp", "servers"],
+                        attribution: "agent",
+                    },
+                    {
+                        id: "user",
+                        scope: "user",
+                        root: "xdg-config",
+                        path: "opencode/opencode.json",
+                        shape: "file",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                        format: "json",
+                        keyPath: ["mcp", "servers"],
+                        attribution: "agent",
+                    },
+                    {
+                        id: "user-jsonc",
+                        scope: "user",
+                        root: "xdg-config",
+                        path: "opencode/opencode.jsonc",
+                        shape: "file",
+                        role: "additional",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                        format: "jsonc",
+                        keyPath: ["mcp", "servers"],
+                        attribution: "agent",
+                    },
+                ],
+                entryDialect: {
+                    activationField: {
+                        required: { name: "disabled", enabled: false, disabled: true },
+                        accepted: [null, { name: "disabled", enabled: false, disabled: true }],
+                    },
+                    stdio: {
+                        command: "array",
+                        envKey: "environment",
+                        typeField: {
+                            required: { name: "type", value: "local" },
+                            accepted: [{ name: "type", value: "local" }],
+                        },
+                    },
+                    remote: {
+                        urlKey: { "streamable-http": "url" },
+                        headersKey: "headers",
+                        typeField: {
+                            required: { name: "type", value: "remote" },
+                            accepted: [{ name: "type", value: "remote" }],
+                        },
+                    },
+                },
             },
             axm: {
-                status: "unsupported",
-                lastVerified: null,
-                writer: null,
-                reason: "OpenCode V2 nests MCP server definitions under mcp.servers. AXM's generic MCP writer currently supports only a single keyed server-map level and would write the obsolete shape.",
+                status: "supported",
+                lastVerified: "2026-09-29",
+                writer: { config: { locationIds: ["project", "user"] } },
             },
         },
         subagent: {
@@ -69,10 +242,33 @@ export const opencodeAgent = {
                 vendorStatus: { state: "active" },
                 notes: "No industry spec for subagents yet; AXM bridges to the agent's native layout.",
                 docs: [],
-                sources: ["https://opencode.ai/docs/agents/"],
+                sources: [
+                    "https://opencode.ai/docs/agents/",
+                    "https://github.com/anomalyco/opencode/blob/dev/packages/core/src/global.ts",
+                ],
                 scopes: ["user", "project"],
-                directory: ".opencode/agents",
-                layout: "directory",
+                locations: [
+                    {
+                        scope: "project",
+                        root: "project",
+                        path: ".opencode/agents",
+                        shape: "directory",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                    },
+                    {
+                        scope: "user",
+                        root: "xdg-config",
+                        path: "opencode/agents",
+                        shape: "directory",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                    },
+                ],
             },
             axm: {
                 status: "supported",
@@ -89,6 +285,8 @@ export const opencodeAgent = {
                 sources: ["https://opencode.ai/docs/plugins/"],
                 scopes: ["user", "project"],
                 modeling: "native-unmodeled",
+                locations: [],
+                entryDialect: null,
             },
             axm: {
                 status: "unsupported",
@@ -104,12 +302,55 @@ export const opencodeAgent = {
             vendorStatus: { state: "active" },
             notes: "OpenCode reads AGENTS.md project rules, a global ~/.config/opencode/AGENTS.md, and Claude-compatible CLAUDE.md fallbacks. AXM can target the universal AGENTS.md project file.",
             docs: [],
-            sources: ["https://opencode.ai/docs/rules/"],
+            sources: [
+                "https://opencode.ai/docs/rules/",
+                "https://github.com/anomalyco/opencode/blob/dev/packages/core/src/global.ts",
+            ],
             scopes: ["user", "project"],
             standardsCompliance: "full",
             convention: "universal",
             kind: "agents-md",
-            files: ["AGENTS.md"],
+            locations: [
+                {
+                    scope: "project",
+                    root: "project",
+                    path: "AGENTS.md",
+                    shape: "file",
+                    role: "primary",
+                    status: "canonical",
+                    applicability: { kind: "always" },
+                    provenance: { kind: "capability-sources" },
+                },
+                {
+                    scope: "user",
+                    root: "xdg-config",
+                    path: "opencode/AGENTS.md",
+                    shape: "file",
+                    role: "primary",
+                    status: "canonical",
+                    applicability: { kind: "always" },
+                    provenance: {
+                        kind: "sources",
+                        sources: [
+                            "https://opencode.ai/docs/rules/",
+                            "https://github.com/anomalyco/opencode/blob/dev/packages/core/src/global.ts",
+                        ],
+                    },
+                },
+                {
+                    scope: "user",
+                    root: "home",
+                    path: ".claude/CLAUDE.md",
+                    shape: "file",
+                    role: "additional",
+                    status: "canonical",
+                    applicability: {
+                        kind: "conditional",
+                        condition: "Fallback when the OpenCode global AGENTS.md is absent and Claude Code prompt compatibility is enabled.",
+                    },
+                    provenance: { kind: "sources", sources: ["https://opencode.ai/docs/rules/"] },
+                },
+            ],
             nestedDiscovery: true,
             importSyntax: null,
         },
@@ -125,19 +366,45 @@ export const opencodeAgent = {
             vendorStatus: { state: "active" },
             notes: null,
             docs: [],
-            sources: ["https://opencode.ai/docs/permissions/", "https://opencode.ai/docs/config/"],
+            sources: [
+                "https://opencode.ai/docs/permissions/",
+                "https://opencode.ai/docs/config/",
+                "https://github.com/anomalyco/opencode/blob/dev/packages/core/src/global.ts",
+            ],
             scopes: ["user", "project"],
             mechanism: ["config-file"],
-            configFiles: [
+            locations: [
                 {
+                    id: "user",
                     scope: "user",
-                    path: "~/.config/opencode/opencode.json",
+                    root: "xdg-config",
+                    path: "opencode/opencode.json",
+                    shape: "file",
+                    role: "primary",
+                    status: "canonical",
+                    applicability: {
+                        kind: "always",
+                    },
+                    provenance: {
+                        kind: "capability-sources",
+                    },
                     format: "json",
                     gitignored: false,
                 },
                 {
+                    id: "project",
                     scope: "project",
+                    root: "project",
                     path: "opencode.json",
+                    shape: "file",
+                    role: "primary",
+                    status: "canonical",
+                    applicability: {
+                        kind: "always",
+                    },
+                    provenance: {
+                        kind: "capability-sources",
+                    },
                     format: "json",
                     gitignored: false,
                 },
@@ -156,7 +423,7 @@ export const opencodeAgent = {
             writer: {
                 grants: {
                     shell: {
-                        target: "opencode.json",
+                        destination: { kind: "location", locationId: "project" },
                         patch: {
                             permission: {
                                 bash: {
@@ -168,7 +435,7 @@ export const opencodeAgent = {
                         template: null,
                     },
                     filesystem: {
-                        target: "opencode.json",
+                        destination: { kind: "location", locationId: "project" },
                         patch: {
                             permission: {
                                 external_directory: {

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

@@ -36,10 +36,32 @@ export declare const openhandsAgent: {
                 readonly scopes: readonly ["user", "project"];
                 readonly standardsCompliance: "full";
                 readonly convention: "universal";
-                readonly directory: ".agents/skills";
-                readonly additionalReadPaths: readonly [{
+                readonly locations: readonly [{
+                    readonly scope: "project";
+                    readonly root: "project";
+                    readonly path: ".agents/skills";
+                    readonly shape: "directory";
+                    readonly role: "primary";
+                    readonly status: "canonical";
+                    readonly applicability: {
+                        readonly kind: "always";
+                    };
+                    readonly provenance: {
+                        readonly kind: "capability-sources";
+                    };
+                }, {
+                    readonly scope: "project";
+                    readonly root: "project";
                     readonly path: ".openhands/skills";
+                    readonly shape: "directory";
+                    readonly role: "additional";
                     readonly status: "deprecated";
+                    readonly applicability: {
+                        readonly kind: "always";
+                    };
+                    readonly provenance: {
+                        readonly kind: "capability-sources";
+                    };
                 }];
             };
             readonly axm: {
@@ -63,6 +85,8 @@ export declare const openhandsAgent: {
                 readonly standardsCompliance: "parity";
                 readonly convention: "vendor";
                 readonly transports: readonly ["stdio", "http", "sse"];
+                readonly locations: readonly [];
+                readonly entryDialect: null;
             };
             readonly axm: {
                 readonly status: "unsupported";
@@ -102,9 +126,20 @@ export declare const openhandsAgent: {
                 readonly sources: readonly ["https://docs.openhands.dev/openhands/usage/customization/hooks"];
                 readonly scopes: readonly ["project"];
                 readonly mechanism: readonly ["command-stdin"];
-                readonly configFiles: readonly [{
+                readonly locations: readonly [{
+                    readonly id: "project";
                     readonly scope: "project";
+                    readonly root: "project";
                     readonly path: ".openhands/hooks.json";
+                    readonly shape: "file";
+                    readonly role: "primary";
+                    readonly status: "canonical";
+                    readonly applicability: {
+                        readonly kind: "always";
+                    };
+                    readonly provenance: {
+                        readonly kind: "capability-sources";
+                    };
                     readonly format: "json";
                     readonly gitignored: false;
                 }];
@@ -190,6 +225,7 @@ export declare const openhandsAgent: {
                     readonly lastVerified: "2026-08-05";
                 }];
                 readonly tools: readonly [];
+                readonly entryDialect: null;
             };
             readonly axm: {
                 readonly status: "unsupported";
@@ -213,7 +249,20 @@ export declare const openhandsAgent: {
             readonly standardsCompliance: "full";
             readonly convention: "universal";
             readonly kind: "agents-md";
-            readonly files: readonly ["AGENTS.md"];
+            readonly locations: readonly [{
+                readonly scope: "project";
+                readonly root: "project";
+                readonly path: "AGENTS.md";
+                readonly shape: "file";
+                readonly role: "primary";
+                readonly status: "canonical";
+                readonly applicability: {
+                    readonly kind: "always";
+                };
+                readonly provenance: {
+                    readonly kind: "capability-sources";
+                };
+            }];
             readonly nestedDiscovery: false;
             readonly importSyntax: null;
         };

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

@@ -28,8 +28,28 @@ export const openhandsAgent = {
                 scopes: ["user", "project"],
                 standardsCompliance: "full",
                 convention: "universal",
-                directory: ".agents/skills",
-                additionalReadPaths: [{ path: ".openhands/skills", status: "deprecated" }],
+                locations: [
+                    {
+                        scope: "project",
+                        root: "project",
+                        path: ".agents/skills",
+                        shape: "directory",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                    },
+                    {
+                        scope: "project",
+                        root: "project",
+                        path: ".openhands/skills",
+                        shape: "directory",
+                        role: "additional",
+                        status: "deprecated",
+                        applicability: { kind: "always" },
+                        provenance: { kind: "capability-sources" },
+                    },
+                ],
             },
             axm: {
                 status: "supported",
@@ -51,6 +71,8 @@ export const openhandsAgent = {
                 standardsCompliance: "parity",
                 convention: "vendor",
                 transports: ["stdio", "http", "sse"],
+                locations: [],
+                entryDialect: null,
             },
             axm: {
                 status: "unsupported",
@@ -82,10 +104,21 @@ export const openhandsAgent = {
                 sources: ["https://docs.openhands.dev/openhands/usage/customization/hooks"],
                 scopes: ["project"],
                 mechanism: ["command-stdin"],
-                configFiles: [
+                locations: [
                     {
+                        id: "project",
                         scope: "project",
+                        root: "project",
                         path: ".openhands/hooks.json",
+                        shape: "file",
+                        role: "primary",
+                        status: "canonical",
+                        applicability: {
+                            kind: "always",
+                        },
+                        provenance: {
+                            kind: "capability-sources",
+                        },
                         format: "json",
                         gitignored: false,
                     },
@@ -137,6 +170,7 @@ export const openhandsAgent = {
                     },
                 ],
                 tools: [],
+                entryDialect: null,
             },
             axm: {
                 status: "unsupported",
@@ -156,7 +190,18 @@ export const openhandsAgent = {
             standardsCompliance: "full",
             convention: "universal",
             kind: "agents-md",
-            files: ["AGENTS.md"],
+            locations: [
+                {
+                    scope: "project",
+                    root: "project",
+                    path: "AGENTS.md",
+                    shape: "file",
+                    role: "primary",
+                    status: "canonical",
+                    applicability: { kind: "always" },
+                    provenance: { kind: "capability-sources" },
+                },
+            ],
             nestedDiscovery: false,
             importSyntax: null,
         },

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

@@ -36,7 +36,59 @@ export declare const piAgent: {
                 readonly scopes: readonly ["user", "project"];
                 readonly standardsCompliance: "full";
                 readonly convention: "vendor";
-                readonly directory: ".pi/skills";
+                readonly locations: readonly [{
+                    readonly scope: "project";
+                    readonly root: "project";
+                    readonly path: ".agents/skills";
+                    readonly shape: "directory";
+                    readonly role: "additional";
+                    readonly status: "canonical";
+                    readonly applicability: {
+                        readonly kind: "always";
+                    };
+                    readonly provenance: {
+                        readonly kind: "capability-sources";
+                    };
+                }, {
+                    readonly scope: "project";
+                    readonly root: "project";
+                    readonly path: ".pi/skills";
+                    readonly shape: "directory";
+                    readonly role: "primary";
+                    readonly status: "canonical";
+                    readonly applicability: {
+                        readonly kind: "always";
+                    };
+                    readonly provenance: {
+                        readonly kind: "capability-sources";
+                    };
+                }, {
+                    readonly scope: "user";
+                    readonly root: "home";
+                    readonly path: ".pi/agent/skills";
+                    readonly shape: "directory";
+                    readonly role: "primary";
+                    readonly status: "canonical";
+                    readonly applicability: {
+                        readonly kind: "always";
+                    };
+                    readonly provenance: {
+                        readonly kind: "capability-sources";
+                    };
+                }, {
+                    readonly scope: "user";
+                    readonly root: "home";
+                    readonly path: ".agents/skills";
+                    readonly shape: "directory";
+                    readonly role: "additional";
+                    readonly status: "canonical";
+                    readonly applicability: {
+                        readonly kind: "always";
+                    };
+                    readonly provenance: {
+                        readonly kind: "capability-sources";
+                    };
+                }];
             };
             readonly axm: {
                 readonly status: "supported";
@@ -129,6 +181,8 @@ export declare const piAgent: {
                 readonly sources: readonly ["https://github.com/earendil-works/pi/blob/main/packages/coding-agent/README.md"];
                 readonly scopes: readonly ["user", "project"];
                 readonly modeling: "native-unmodeled";
+                readonly locations: readonly [];
+                readonly entryDialect: null;
             };
             readonly axm: {
                 readonly status: "unsupported";
@@ -153,7 +207,20 @@ export declare const piAgent: {
             readonly standardsCompliance: "full";
             readonly convention: "universal";
             readonly kind: "agents-md";
-            readonly files: readonly ["AGENTS.md"];
+            readonly locations: readonly [{
+                readonly scope: "project";
+                readonly root: "project";
+                readonly path: "AGENTS.md";
+                readonly shape: "file";
+                readonly role: "primary";
+                readonly status: "canonical";
+                readonly applicability: {
+                    readonly kind: "always";
+                };
+                readonly provenance: {
+                    readonly kind: "capability-sources";
+                };
+            }];
             readonly nestedDiscovery: true;
             readonly importSyntax: null;
         };