@agentxm/extension-model 0.28.4-bootstrap.0

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

@@ -0,0 +1,458 @@
+export declare const codexAgent: {
+    readonly id: "codex";
+    readonly name: "Codex";
+    readonly vendor: "OpenAI";
+    readonly homepage: "https://learn.chatgpt.com/docs";
+    readonly interfaces: readonly ["cli", "ide-extension"];
+    readonly family: "openai";
+    readonly rootDir: ".codex";
+    readonly targeting: {
+        readonly extends: null;
+        readonly capabilities: {
+            readonly "structured-input": {
+                readonly grades: readonly ["native"];
+                readonly nouns: {
+                    readonly "tool:structured-input": "request_user_input";
+                };
+                readonly affordances: {
+                    readonly "do:ask-structured": "Use request_user_input to collect structured input, then STOP and wait for the response.";
+                };
+            };
+        };
+    };
+    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: "~/.codex";
+                readonly signal: "definitive";
+                readonly note: null;
+            }, {
+                readonly kind: "executable";
+                readonly name: "codex";
+                readonly signal: "definitive";
+                readonly note: "CLI on PATH.";
+            }];
+        };
+    };
+    readonly docs: readonly [{
+        readonly label: "Codex documentation";
+        readonly url: "https://learn.chatgpt.com/docs";
+    }];
+    readonly capabilities: {
+        readonly skill: {
+            readonly native: {
+                readonly availability: {
+                    readonly via: "native";
+                };
+                readonly vendorStatus: {
+                    readonly state: "active";
+                };
+                readonly notes: "Reads SKILL.md skills from repository (.agents/skills) and user (~/.agents/skills) locations with progressive disclosure, using the cross-tool Agent Skills convention rather than a .codex/ path.\n";
+                readonly docs: readonly [];
+                readonly sources: readonly ["https://developers.openai.com/codex/skills"];
+                readonly scopes: readonly ["user", "project"];
+                readonly standardsCompliance: "full";
+                readonly convention: "universal";
+                readonly directory: ".agents/skills";
+            };
+            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://developers.openai.com/codex/mcp/"];
+                readonly scopes: readonly ["user", "project"];
+                readonly standardsCompliance: "full";
+                readonly convention: "vendor";
+                readonly transports: readonly ["stdio", "http"];
+                readonly mcpEnvExpansion: {
+                    readonly variables: "none";
+                    readonly defaults: false;
+                };
+            };
+            readonly axm: {
+                readonly status: "supported";
+                readonly lastVerified: "2026-08-05";
+                readonly writer: {
+                    readonly config: {
+                        readonly serversKey: "mcp_servers";
+                        readonly activationField: {
+                            readonly required: {
+                                readonly name: "enabled";
+                                readonly enabled: true;
+                                readonly disabled: false;
+                            };
+                            readonly accepted: readonly [{
+                                readonly name: "enabled";
+                                readonly enabled: true;
+                                readonly disabled: false;
+                            }, null];
+                        };
+                        readonly targets: readonly [{
+                            readonly scope: "project";
+                            readonly path: ".codex/config.toml";
+                            readonly format: "toml";
+                            readonly attribution: "agent";
+                        }, {
+                            readonly scope: "user";
+                            readonly path: "~/.codex/config.toml";
+                            readonly format: "toml";
+                            readonly attribution: "agent";
+                        }];
+                        readonly stdio: {
+                            readonly typeField: {
+                                readonly required: null;
+                                readonly accepted: readonly [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 headersKey: "http_headers";
+                            readonly bearerTokenEnvKey: "bearer_token_env_var";
+                            readonly envHeadersKey: "env_http_headers";
+                        };
+                    };
+                };
+            };
+        };
+        readonly subagent: {
+            readonly native: {
+                readonly availability: {
+                    readonly via: "native";
+                };
+                readonly vendorStatus: {
+                    readonly state: "active";
+                };
+                readonly notes: "Custom agents are standalone TOML files under .codex/agents (project) or ~/.codex/agents (user); a custom agent overrides a built-in of the same name.\n";
+                readonly docs: readonly [];
+                readonly sources: readonly ["https://learn.chatgpt.com/docs/agent-configuration/subagents"];
+                readonly scopes: readonly ["user", "project"];
+                readonly directory: ".codex/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: "Codex lifecycle hooks are command hooks loaded from hooks.json or inline [hooks] tables next to active config layers.";
+                readonly docs: readonly [];
+                readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                readonly scopes: readonly ["user", "project"];
+                readonly mechanism: readonly ["command-stdin"];
+                readonly configFiles: readonly [{
+                    readonly scope: "user";
+                    readonly path: "~/.codex/hooks.json";
+                    readonly format: "json";
+                    readonly gitignored: false;
+                }, {
+                    readonly scope: "project";
+                    readonly path: ".codex/hooks.json";
+                    readonly format: "json";
+                    readonly gitignored: false;
+                }];
+                readonly events: readonly [{
+                    readonly nativeName: "PreToolUse";
+                    readonly canonical: "tool.pre";
+                    readonly matcher: {
+                        readonly kind: "regex";
+                        readonly example: "Bash|apply_patch";
+                        readonly notes: null;
+                    };
+                    readonly decision: readonly [{
+                        readonly kind: "block";
+                        readonly outcomes: readonly ["deny"];
+                    }];
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }, {
+                    readonly nativeName: "PermissionRequest";
+                    readonly canonical: "tool.pre";
+                    readonly matcher: {
+                        readonly kind: "regex";
+                        readonly example: "Bash|apply_patch";
+                        readonly notes: null;
+                    };
+                    readonly decision: readonly [{
+                        readonly kind: "block";
+                        readonly outcomes: readonly ["deny"];
+                    }];
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }, {
+                    readonly nativeName: "PostToolUse";
+                    readonly canonical: "tool.post";
+                    readonly matcher: {
+                        readonly kind: "regex";
+                        readonly example: "Bash|apply_patch";
+                        readonly notes: null;
+                    };
+                    readonly decision: readonly [{
+                        readonly kind: "observe";
+                    }];
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }, {
+                    readonly nativeName: "UserPromptSubmit";
+                    readonly canonical: "prompt.submit";
+                    readonly matcher: {
+                        readonly kind: "none-imperative";
+                        readonly example: null;
+                        readonly notes: null;
+                    };
+                    readonly decision: readonly [{
+                        readonly kind: "block";
+                        readonly outcomes: readonly ["deny"];
+                    }];
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }, {
+                    readonly nativeName: "SessionStart";
+                    readonly canonical: "session.start";
+                    readonly matcher: {
+                        readonly kind: "regex";
+                        readonly example: "startup|resume|clear|compact";
+                        readonly notes: null;
+                    };
+                    readonly decision: readonly [{
+                        readonly kind: "observe";
+                    }];
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }, {
+                    readonly nativeName: "Stop";
+                    readonly canonical: "turn.end";
+                    readonly matcher: {
+                        readonly kind: "none-imperative";
+                        readonly example: null;
+                        readonly notes: null;
+                    };
+                    readonly decision: readonly [{
+                        readonly kind: "observe";
+                    }];
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }, {
+                    readonly nativeName: "SubagentStop";
+                    readonly canonical: "subagent.stop";
+                    readonly matcher: {
+                        readonly kind: "regex";
+                        readonly example: null;
+                        readonly notes: "Matcher filters subagent type.";
+                    };
+                    readonly decision: readonly [{
+                        readonly kind: "observe";
+                    }];
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }, {
+                    readonly nativeName: "PreCompact";
+                    readonly canonical: "compaction.pre";
+                    readonly matcher: {
+                        readonly kind: "regex";
+                        readonly example: "manual|auto";
+                        readonly notes: null;
+                    };
+                    readonly decision: readonly [{
+                        readonly kind: "observe";
+                    }];
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }];
+                readonly tools: readonly [{
+                    readonly nativeName: "apply_patch";
+                    readonly canonical: "file.edit";
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }, {
+                    readonly nativeName: "Edit";
+                    readonly canonical: "file.edit";
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }, {
+                    readonly nativeName: "Write";
+                    readonly canonical: "file.write";
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }, {
+                    readonly nativeName: "Bash";
+                    readonly canonical: "shell.exec";
+                    readonly sources: readonly ["https://learn.chatgpt.com/docs/hooks"];
+                    readonly lastVerified: "2026-08-05";
+                }];
+            };
+            readonly axm: {
+                readonly status: "supported";
+                readonly writer: {
+                    readonly serializer: "command-stdin";
+                    readonly configFiles: readonly [{
+                        readonly scope: "project";
+                        readonly path: ".codex/hooks.json";
+                        readonly format: "json";
+                        readonly gitignored: false;
+                    }];
+                    readonly settingsKey: "hooks";
+                    readonly eventMap: "native.events";
+                    readonly matcherKind: "regex";
+                    readonly matcherSerialization: "bare";
+                    readonly timeoutSerialization: "seconds";
+                    readonly commandNameSerialization: "omit";
+                };
+                readonly lastVerified: "2026-08-05";
+            };
+        };
+    };
+    readonly instructions: {
+        readonly native: {
+            readonly availability: {
+                readonly via: "native";
+            };
+            readonly vendorStatus: {
+                readonly state: "active";
+            };
+            readonly notes: null;
+            readonly docs: readonly [];
+            readonly sources: readonly ["https://github.com/openai/codex/blob/main/docs/agents_md.md"];
+            readonly scopes: readonly ["user", "project"];
+            readonly standardsCompliance: "full";
+            readonly convention: "universal";
+            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://learn.chatgpt.com/docs/config-file/config-reference", "https://learn.chatgpt.com/docs/permissions"];
+            readonly scopes: readonly ["user", "project"];
+            readonly mechanism: readonly ["config-file", "cli-flag"];
+            readonly configFiles: readonly [{
+                readonly scope: "user";
+                readonly path: "~/.codex/config.toml";
+                readonly format: "toml";
+                readonly gitignored: false;
+            }, {
+                readonly scope: "user";
+                readonly path: "~/.codex/axm.config.toml";
+                readonly format: "toml";
+                readonly gitignored: false;
+            }];
+            readonly grammar: {
+                readonly style: "glob";
+                readonly example: "[permissions.agentxm.filesystem.\":workspace_roots\"] \".\" = \"write\"";
+                readonly notes: "Permission profiles combine filesystem, network, and workspace-root rules. Narrower deny rules remain in force over broader readable or writable paths.\n";
+            };
+            readonly prerequisites: readonly [{
+                readonly key: "default_permissions";
+                readonly value: "agentxm";
+                readonly scope: "user";
+                readonly note: "Selects the named permission profile.";
+            }];
+            readonly cliFlags: readonly [{
+                readonly flag: "--yolo";
+                readonly note: "Alias for danger-full-access; use only when broad local access is intentional.";
+            }, {
+                readonly flag: "--dangerously-bypass-approvals-and-sandbox";
+                readonly note: "Runs without local sandbox restrictions.";
+            }];
+        };
+        readonly axm: {
+            readonly status: "supported";
+            readonly lastVerified: "2026-08-05";
+            readonly writer: {
+                readonly grants: {
+                    readonly shell: {
+                        readonly target: "~/.codex/axm.config.toml";
+                        readonly patch: {
+                            readonly default_permissions: "agentxm";
+                            readonly permissions: {
+                                readonly agentxm: {
+                                    readonly extends: ":workspace";
+                                };
+                            };
+                        };
+                        readonly template: null;
+                    };
+                    readonly filesystem: {
+                        readonly target: "~/.codex/axm.config.toml";
+                        readonly patch: {
+                            readonly default_permissions: "agentxm";
+                            readonly permissions: {
+                                readonly agentxm: {
+                                    readonly extends: ":workspace";
+                                    readonly workspace_roots: {
+                                        readonly "${workspaceRoot}": true;
+                                    };
+                                    readonly filesystem: {
+                                        readonly ":workspace_roots": {
+                                            readonly ".": "write";
+                                        };
+                                    };
+                                    readonly network: {
+                                        readonly enabled: true;
+                                    };
+                                };
+                            };
+                        };
+                        readonly template: null;
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=codex.d.ts.map