@agentxm/extension-model 0.28.4-bootstrap.0

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

@@ -0,0 +1,300 @@
+export declare const cursorAgent: {
+    readonly id: "cursor";
+    readonly name: "Cursor";
+    readonly vendor: "Anysphere";
+    readonly homepage: "https://cursor.com";
+    readonly interfaces: readonly ["ide-extension", "cli"];
+    readonly family: "cursor";
+    readonly rootDir: ".cursor";
+    readonly lifecycle: {
+        readonly state: "active";
+    };
+    readonly detection: {
+        readonly project: {
+            readonly markers: readonly [{
+                readonly kind: "file";
+                readonly path: "AGENTS.md";
+                readonly signal: "ambiguous";
+                readonly note: "Shared instruction filename used by multiple agents.";
+            }];
+        };
+        readonly user: {
+            readonly markers: readonly [{
+                readonly kind: "dir";
+                readonly path: "~/.cursor";
+                readonly signal: "definitive";
+                readonly note: null;
+            }, {
+                readonly kind: "executable";
+                readonly name: "cursor-agent";
+                readonly signal: "definitive";
+                readonly note: "CLI on PATH.";
+            }];
+        };
+    };
+    readonly docs: readonly [{
+        readonly label: "Cursor documentation";
+        readonly url: "https://docs.cursor.com";
+    }];
+    readonly capabilities: {
+        readonly skill: {
+            readonly native: {
+                readonly availability: {
+                    readonly via: "native";
+                };
+                readonly vendorStatus: {
+                    readonly state: "active";
+                };
+                readonly notes: "Cursor 2.4 added Agent Skills (SKILL.md) across the editor and the cursor-agent CLI.";
+                readonly docs: readonly [];
+                readonly sources: readonly ["https://cursor.com/docs/skills.md"];
+                readonly scopes: readonly ["user", "project"];
+                readonly standardsCompliance: "full";
+                readonly convention: "vendor";
+                readonly directory: ".cursor/skills";
+                readonly additionalReadPaths: readonly [{
+                    readonly path: ".claude/skills";
+                    readonly status: "compat";
+                }, {
+                    readonly path: ".codex/skills";
+                    readonly status: "compat";
+                }];
+            };
+            readonly axm: {
+                readonly status: "supported";
+                readonly lastVerified: "2026-08-05";
+                readonly writer: null;
+            };
+        };
+        readonly "mcp-server": {
+            readonly native: {
+                readonly availability: {
+                    readonly via: "native";
+                };
+                readonly vendorStatus: {
+                    readonly state: "active";
+                };
+                readonly notes: null;
+                readonly docs: readonly [];
+                readonly sources: readonly ["https://cursor.com/docs/mcp.md"];
+                readonly scopes: readonly ["user", "project"];
+                readonly standardsCompliance: "full";
+                readonly convention: "universal";
+                readonly transports: readonly ["stdio", "http", "sse"];
+                readonly mcpEnvExpansion: {
+                    readonly variables: "braced";
+                    readonly defaults: false;
+                };
+            };
+            readonly axm: {
+                readonly status: "supported";
+                readonly lastVerified: "2026-08-05";
+                readonly writer: {
+                    readonly config: {
+                        readonly serversKey: "mcpServers";
+                        readonly activationField: {
+                            readonly required: null;
+                            readonly accepted: readonly [null];
+                        };
+                        readonly targets: readonly [{
+                            readonly scope: "project";
+                            readonly path: ".cursor/mcp.json";
+                            readonly format: "json";
+                            readonly attribution: "agent";
+                        }, {
+                            readonly scope: "user";
+                            readonly path: "~/.cursor/mcp.json";
+                            readonly format: "json";
+                            readonly attribution: "agent";
+                        }];
+                        readonly stdio: {
+                            readonly typeField: {
+                                readonly required: {
+                                    readonly name: "type";
+                                    readonly value: "stdio";
+                                };
+                                readonly accepted: readonly [{
+                                    readonly name: "type";
+                                    readonly value: "stdio";
+                                }, null];
+                            };
+                            readonly command: "split";
+                            readonly envKey: "env";
+                        };
+                        readonly remote: {
+                            readonly typeField: {
+                                readonly required: null;
+                                readonly accepted: readonly [null];
+                            };
+                            readonly urlKey: {
+                                readonly "streamable-http": "url";
+                                readonly sse: "url";
+                            };
+                            readonly headersKey: "headers";
+                        };
+                    };
+                };
+            };
+        };
+        readonly subagent: {
+            readonly native: {
+                readonly availability: {
+                    readonly via: "native";
+                };
+                readonly vendorStatus: {
+                    readonly state: "active";
+                };
+                readonly notes: "Custom subagents are Markdown files with YAML frontmatter under .cursor/agents (project) or ~/.cursor/agents (user); added in Cursor 2.4.\n";
+                readonly docs: readonly [];
+                readonly sources: readonly ["https://cursor.com/docs/subagents.md"];
+                readonly scopes: readonly ["user", "project"];
+                readonly directory: ".cursor/agents";
+                readonly layout: "directory";
+            };
+            readonly axm: {
+                readonly status: "supported";
+                readonly lastVerified: "2026-08-05";
+                readonly writer: null;
+            };
+        };
+        readonly hook: {
+            readonly native: {
+                readonly availability: {
+                    readonly via: "native";
+                };
+                readonly vendorStatus: {
+                    readonly state: "active";
+                };
+                readonly notes: "Cursor hooks run custom scripts around agent-loop stages. The native hooks.json shape is a direct event-to-command array, not AXM's current grouped command-stdin serializer shape.";
+                readonly docs: readonly [];
+                readonly sources: readonly ["https://cursor.com/docs/hooks.md"];
+                readonly scopes: readonly ["user", "project"];
+                readonly modeling: "native-unmodeled";
+            };
+            readonly axm: {
+                readonly status: "unsupported";
+                readonly writer: null;
+                readonly lastVerified: null;
+                readonly reason: "Cursor's hooks.json maps each event to a flat command array; AXM's only hook serializer emits grouped command-stdin entries, so a writer needs a new serializer rather than catalog data.";
+            };
+        };
+    };
+    readonly instructions: {
+        readonly native: {
+            readonly availability: {
+                readonly via: "native";
+            };
+            readonly vendorStatus: {
+                readonly state: "active";
+            };
+            readonly notes: null;
+            readonly docs: readonly [];
+            readonly sources: readonly ["https://cursor.com/docs/rules.md"];
+            readonly scopes: readonly ["project"];
+            readonly standardsCompliance: "full";
+            readonly convention: "universal";
+            readonly directory: ".cursor/rules";
+            readonly kind: "agents-md";
+            readonly files: readonly ["AGENTS.md"];
+            readonly nestedDiscovery: true;
+            readonly importSyntax: null;
+        };
+        readonly axm: {
+            readonly status: "supported";
+            readonly lastVerified: "2026-08-05";
+            readonly writer: null;
+        };
+    };
+    readonly permissions: {
+        readonly native: {
+            readonly availability: {
+                readonly via: "native";
+            };
+            readonly vendorStatus: {
+                readonly state: "active";
+            };
+            readonly notes: null;
+            readonly docs: readonly [];
+            readonly sources: readonly ["https://cursor.com/docs/cli/reference/permissions.md", "https://cursor.com/docs/cli/reference/parameters.md", "https://cursor.com/docs/agent/tools/terminal"];
+            readonly scopes: readonly ["user", "project"];
+            readonly mechanism: readonly ["config-file", "ui-only", "cli-flag"];
+            readonly configFiles: readonly [{
+                readonly scope: "user";
+                readonly path: "~/.cursor/permissions.json";
+                readonly format: "json";
+                readonly gitignored: false;
+            }, {
+                readonly scope: "user";
+                readonly path: "~/.cursor/sandbox.json";
+                readonly format: "json";
+                readonly gitignored: false;
+            }, {
+                readonly scope: "project";
+                readonly path: ".cursor/sandbox.json";
+                readonly format: "json";
+                readonly gitignored: false;
+            }, {
+                readonly scope: "user";
+                readonly path: "~/.cursor/cli-config.json";
+                readonly format: "json";
+                readonly gitignored: false;
+            }, {
+                readonly scope: "project";
+                readonly path: ".cursor/cli.json";
+                readonly format: "json";
+                readonly gitignored: false;
+            }];
+            readonly grammar: {
+                readonly style: "prefix";
+                readonly example: "axm";
+                readonly notes: "IDE: case-sensitive command prefix in terminalAllowlist. CLI: Tool-call syntax Shell()/Read()/Write() with glob patterns. Deny always beats allow.\n";
+            };
+            readonly prerequisites: readonly [{
+                readonly key: "Settings > Cursor Settings > Agents > Auto-Run";
+                readonly value: "Run in Sandbox | Run Everything";
+                readonly scope: "user";
+                readonly note: "IDE Auto-Run must be enabled before terminalAllowlist takes effect.";
+            }];
+            readonly cliFlags: readonly [{
+                readonly flag: "--force";
+                readonly note: "Force allow commands unless explicitly denied.";
+            }, {
+                readonly flag: "--yolo";
+                readonly note: "Alias for --force.";
+            }];
+        };
+        readonly axm: {
+            readonly status: "supported";
+            readonly lastVerified: "2026-08-05";
+            readonly writer: {
+                readonly grants: {
+                    readonly shell: {
+                        readonly target: "~/.cursor/permissions.json";
+                        readonly patch: {
+                            readonly terminalAllowlist: readonly ["${tool}"];
+                        };
+                        readonly template: null;
+                    };
+                    readonly cliShell: {
+                        readonly target: ".cursor/cli.json";
+                        readonly patch: {
+                            readonly permissions: {
+                                readonly allow: readonly ["Shell(${tool})", "Shell(${tool}:*)"];
+                            };
+                        };
+                        readonly template: null;
+                    };
+                    readonly filesystem: {
+                        readonly target: ".cursor/sandbox.json";
+                        readonly patch: {
+                            readonly type: "workspace_readwrite";
+                            readonly additionalReadwritePaths: readonly [];
+                        };
+                        readonly template: null;
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=cursor.d.ts.map

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

@@ -0,0 +1,282 @@
+export const cursorAgent = {
+    id: "cursor",
+    name: "Cursor",
+    vendor: "Anysphere",
+    homepage: "https://cursor.com",
+    interfaces: ["ide-extension", "cli"],
+    family: "cursor",
+    rootDir: ".cursor",
+    lifecycle: { state: "active" },
+    detection: {
+        project: {
+            markers: [
+                {
+                    kind: "file",
+                    path: "AGENTS.md",
+                    signal: "ambiguous",
+                    note: "Shared instruction filename used by multiple agents.",
+                },
+            ],
+        },
+        user: {
+            markers: [
+                { kind: "dir", path: "~/.cursor", signal: "definitive", note: null },
+                {
+                    kind: "executable",
+                    name: "cursor-agent",
+                    signal: "definitive",
+                    note: "CLI on PATH.",
+                },
+            ],
+        },
+    },
+    docs: [
+        {
+            label: "Cursor documentation",
+            url: "https://docs.cursor.com",
+        },
+    ],
+    capabilities: {
+        skill: {
+            native: {
+                availability: { via: "native" },
+                vendorStatus: { state: "active" },
+                notes: "Cursor 2.4 added Agent Skills (SKILL.md) across the editor and the cursor-agent CLI.",
+                docs: [],
+                sources: ["https://cursor.com/docs/skills.md"],
+                scopes: ["user", "project"],
+                standardsCompliance: "full",
+                convention: "vendor",
+                directory: ".cursor/skills",
+                additionalReadPaths: [
+                    { path: ".claude/skills", status: "compat" },
+                    { path: ".codex/skills", status: "compat" },
+                ],
+            },
+            axm: {
+                status: "supported",
+                lastVerified: "2026-08-05",
+                writer: null,
+            },
+        },
+        "mcp-server": {
+            native: {
+                availability: { via: "native" },
+                vendorStatus: { state: "active" },
+                notes: null,
+                docs: [],
+                sources: ["https://cursor.com/docs/mcp.md"],
+                scopes: ["user", "project"],
+                standardsCompliance: "full",
+                convention: "universal",
+                transports: ["stdio", "http", "sse"],
+                mcpEnvExpansion: {
+                    variables: "braced",
+                    defaults: false,
+                },
+            },
+            axm: {
+                status: "supported",
+                lastVerified: "2026-08-05",
+                writer: {
+                    config: {
+                        serversKey: "mcpServers",
+                        activationField: {
+                            required: null,
+                            accepted: [null],
+                        },
+                        targets: [
+                            {
+                                scope: "project",
+                                path: ".cursor/mcp.json",
+                                format: "json",
+                                attribution: "agent",
+                            },
+                            {
+                                scope: "user",
+                                path: "~/.cursor/mcp.json",
+                                format: "json",
+                                attribution: "agent",
+                            },
+                        ],
+                        stdio: {
+                            typeField: {
+                                required: { name: "type", value: "stdio" },
+                                accepted: [{ name: "type", value: "stdio" }, null],
+                            },
+                            command: "split",
+                            envKey: "env",
+                        },
+                        remote: {
+                            typeField: { required: null, accepted: [null] },
+                            urlKey: {
+                                "streamable-http": "url",
+                                sse: "url",
+                            },
+                            headersKey: "headers",
+                        },
+                    },
+                },
+            },
+        },
+        subagent: {
+            native: {
+                availability: { via: "native" },
+                vendorStatus: { state: "active" },
+                notes: "Custom subagents are Markdown files with YAML frontmatter under .cursor/agents (project) or ~/.cursor/agents (user); added in Cursor 2.4.\n",
+                docs: [],
+                sources: ["https://cursor.com/docs/subagents.md"],
+                scopes: ["user", "project"],
+                directory: ".cursor/agents",
+                layout: "directory",
+            },
+            axm: {
+                status: "supported",
+                lastVerified: "2026-08-05",
+                writer: null,
+            },
+        },
+        hook: {
+            native: {
+                availability: { via: "native" },
+                vendorStatus: { state: "active" },
+                notes: "Cursor hooks run custom scripts around agent-loop stages. The native hooks.json shape is a direct event-to-command array, not AXM's current grouped command-stdin serializer shape.",
+                docs: [],
+                sources: ["https://cursor.com/docs/hooks.md"],
+                scopes: ["user", "project"],
+                modeling: "native-unmodeled",
+            },
+            axm: {
+                status: "unsupported",
+                writer: null,
+                lastVerified: null,
+                reason: "Cursor's hooks.json maps each event to a flat command array; AXM's only hook serializer emits grouped command-stdin entries, so a writer needs a new serializer rather than catalog data.",
+            },
+        },
+    },
+    instructions: {
+        native: {
+            availability: { via: "native" },
+            vendorStatus: { state: "active" },
+            notes: null,
+            docs: [],
+            sources: ["https://cursor.com/docs/rules.md"],
+            scopes: ["project"],
+            standardsCompliance: "full",
+            convention: "universal",
+            directory: ".cursor/rules",
+            kind: "agents-md",
+            files: ["AGENTS.md"],
+            nestedDiscovery: true,
+            importSyntax: null,
+        },
+        axm: {
+            status: "supported",
+            lastVerified: "2026-08-05",
+            writer: null,
+        },
+    },
+    permissions: {
+        native: {
+            availability: { via: "native" },
+            vendorStatus: { state: "active" },
+            notes: null,
+            docs: [],
+            sources: [
+                "https://cursor.com/docs/cli/reference/permissions.md",
+                "https://cursor.com/docs/cli/reference/parameters.md",
+                "https://cursor.com/docs/agent/tools/terminal",
+            ],
+            scopes: ["user", "project"],
+            mechanism: ["config-file", "ui-only", "cli-flag"],
+            configFiles: [
+                {
+                    scope: "user",
+                    path: "~/.cursor/permissions.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "user",
+                    path: "~/.cursor/sandbox.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".cursor/sandbox.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "user",
+                    path: "~/.cursor/cli-config.json",
+                    format: "json",
+                    gitignored: false,
+                },
+                {
+                    scope: "project",
+                    path: ".cursor/cli.json",
+                    format: "json",
+                    gitignored: false,
+                },
+            ],
+            grammar: {
+                style: "prefix",
+                example: "axm",
+                notes: "IDE: case-sensitive command prefix in terminalAllowlist. CLI: Tool-call syntax Shell()/Read()/Write() with glob patterns. Deny always beats allow.\n",
+            },
+            prerequisites: [
+                {
+                    key: "Settings > Cursor Settings > Agents > Auto-Run",
+                    value: "Run in Sandbox | Run Everything",
+                    scope: "user",
+                    note: "IDE Auto-Run must be enabled before terminalAllowlist takes effect.",
+                },
+            ],
+            cliFlags: [
+                {
+                    flag: "--force",
+                    note: "Force allow commands unless explicitly denied.",
+                },
+                {
+                    flag: "--yolo",
+                    note: "Alias for --force.",
+                },
+            ],
+        },
+        axm: {
+            status: "supported",
+            lastVerified: "2026-08-05",
+            writer: {
+                grants: {
+                    shell: {
+                        target: "~/.cursor/permissions.json",
+                        patch: {
+                            terminalAllowlist: ["${tool}"],
+                        },
+                        template: null,
+                    },
+                    cliShell: {
+                        target: ".cursor/cli.json",
+                        patch: {
+                            permissions: {
+                                allow: ["Shell(${tool})", "Shell(${tool}:*)"],
+                            },
+                        },
+                        template: null,
+                    },
+                    filesystem: {
+                        target: ".cursor/sandbox.json",
+                        patch: {
+                            type: "workspace_readwrite",
+                            additionalReadwritePaths: [],
+                        },
+                        template: null,
+                    },
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=cursor.js.map