@weavecode/weave 0.1.2 → 0.1.3

package/node_modules/@weavecode/harness/dist/claude/settings-gen.d.ts

@@ -6,6 +6,8 @@ export interface SettingsGeneratorInput {
     /** Absolute path to the helpers directory in the target project */
     helpersDir: string;
 }
+export declare const WEAVE_PERMISSIONS_ALLOW: string[];
+export declare const WEAVE_PERMISSIONS_DENY: string[];
 export declare function generateSettingsJson(input: SettingsGeneratorInput): Record<string, unknown>;
 /**
  * Merge weave's generated settings into an existing user settings.json.
@@ -23,6 +25,7 @@ export declare function generateSettingsJson(input: SettingsGeneratorInput): Rec
  * Idempotent: merging the same `generated` twice yields the same result.
  */
 export declare function mergeSettingsJson(existing: Record<string, unknown>, generated: Record<string, unknown>): Record<string, unknown>;
+export declare function statusLineIsWeave(statusLine: unknown): boolean;
 /**
  * uninstall 用的剥除：把 merge 的加法原样减回去。weave 的 hook 组、weave 的
  * statusLine、weave 写入的默认 permissions/env 条目与 $comment 一并移除；

package/node_modules/@weavecode/harness/dist/claude/settings-gen.js

@@ -1 +1 @@
-import{captureHookGroup as r,sweepWeaveHookEvents as d}from"./capture.js";const v=".claude/helpers/statusline.cjs",f="Generated by weave \u2014 do not edit manually",S=["Bash(npx weave:*)","Bash(pnpm:*)","Bash(npm:*)"],h=["Read(./.env)","Read(./.env.*)","Read(./secrets/*)"];export function generateSettingsJson(n){const{components:t,hooks:e,platform:l,helpersDir:o}=n,c={$comment:f};if(t.helpers){const s={};e.preToolUse&&(s.PreToolUse=r("PreToolUse",o)),e.postToolUse&&(s.PostToolUse=r("PostToolUse",o)),e.userPromptSubmit&&(s.UserPromptSubmit=r("UserPromptSubmit",o)),e.sessionStart&&(s.SessionStart=r("SessionStart",o)),e.stop&&(s.Stop=r("Stop",o)),e.stopFailure&&(s.StopFailure=r("StopFailure",o)),e.subagentStop&&(s.SubagentStop=r("SubagentStop",o)),e.subagentStart&&(s.SubagentStart=r("SubagentStart",o)),e.notification&&(s.Notification=r("Notification",o)),e.postToolUseFailure&&(s.PostToolUseFailure=r("PostToolUseFailure",o)),e.permissionRequest&&(s.PermissionRequest=r("PermissionRequest",o)),e.permissionDenied&&(s.PermissionDenied=r("PermissionDenied",o)),e.preCompact&&(s.PreCompact=r("PreCompact",o)),e.sessionEnd&&(s.SessionEnd=r("SessionEnd",o)),e.preModelSwitch&&(s.PreModelSwitch=r("PreModelSwitch",o),s.PostModelSwitch=r("PostModelSwitch",o)),c.hooks=s}return c.permissions={allow:[...S],deny:[...h]},c.env={WEAVE_ENABLED:"true"},t.helpers&&(c.statusLine={type:"command",command:l.os==="windows"?`node "${o}/statusline.cjs"`:"node "+o+"/statusline.cjs",padding:0,refreshInterval:30}),c}export function mergeSettingsJson(n,t){const e={...n},l=t.hooks;if(l&&typeof l=="object"){const i=d(u(e.hooks)?{...e.hooks}:{})??{};for(const[a,p]of Object.entries(l)){const m=i[a];m===void 0?i[a]=p:Array.isArray(m)&&(i[a]=[...m,...Array.isArray(p)?p:[]])}e.hooks=i}const o=e.statusLine;t.statusLine&&(o===void 0||y(o))&&(e.statusLine=t.statusLine);const c=t.permissions;if(c&&typeof c=="object"){const i=u(e.permissions)?e.permissions:{};for(const a of["allow","deny"]){const p=c[a],m=i[a];Array.isArray(p)?i[a]=b(m,p):m===void 0&&(i[a]=p)}e.permissions=i}const s=t.env;if(s&&typeof s=="object"){const i=u(e.env)?e.env:{};for(const[a,p]of Object.entries(s))i[a]===void 0&&(i[a]=p);e.env=i}return e}function u(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}function y(n){if(!u(n))return!1;const t=n.command;return typeof t=="string"&&P(t,v)}function P(n,t){return n.replace(/\\/g,"/").includes(t)}function b(n,t){return Array.isArray(n)?[...n,...t.filter(e=>!n.includes(e))]:[...t]}export function stripWeaveSettings(n){const t={...n};if(u(t.hooks)){const e=d(t.hooks);e?t.hooks=e:delete t.hooks}if(y(t.statusLine)&&delete t.statusLine,u(t.permissions)){const e={...t.permissions},l=(o,c)=>{const s=e[o];if(!Array.isArray(s))return;const i=s.filter(a=>!c.includes(a));i.length>0?e[o]=i:delete e[o]};l("allow",S),l("deny",h),Object.keys(e).length>0?t.permissions=e:delete t.permissions}if(u(t.env)){const e={...t.env};delete e.WEAVE_ENABLED,Object.keys(e).length>0?t.env=e:delete t.env}return t.$comment===f&&delete t.$comment,t}
+import{captureHookGroup as r,sweepWeaveHookEvents as d}from"./capture.js";const f=".claude/helpers/statusline.cjs",S="Generated by weave \u2014 do not edit manually";export const WEAVE_PERMISSIONS_ALLOW=["Bash(npx weave:*)","Bash(pnpm:*)","Bash(npm:*)"],WEAVE_PERMISSIONS_DENY=["Read(./.env)","Read(./.env.*)","Read(./secrets/*)"];export function generateSettingsJson(n){const{components:t,hooks:e,platform:u,helpersDir:o}=n,c={$comment:S};if(t.helpers){const s={};e.preToolUse&&(s.PreToolUse=r("PreToolUse",o)),e.postToolUse&&(s.PostToolUse=r("PostToolUse",o)),e.userPromptSubmit&&(s.UserPromptSubmit=r("UserPromptSubmit",o)),e.sessionStart&&(s.SessionStart=r("SessionStart",o)),e.stop&&(s.Stop=r("Stop",o)),e.stopFailure&&(s.StopFailure=r("StopFailure",o)),e.subagentStop&&(s.SubagentStop=r("SubagentStop",o)),e.subagentStart&&(s.SubagentStart=r("SubagentStart",o)),e.notification&&(s.Notification=r("Notification",o)),e.postToolUseFailure&&(s.PostToolUseFailure=r("PostToolUseFailure",o)),e.permissionRequest&&(s.PermissionRequest=r("PermissionRequest",o)),e.permissionDenied&&(s.PermissionDenied=r("PermissionDenied",o)),e.preCompact&&(s.PreCompact=r("PreCompact",o)),e.sessionEnd&&(s.SessionEnd=r("SessionEnd",o)),e.preModelSwitch&&(s.PreModelSwitch=r("PreModelSwitch",o),s.PostModelSwitch=r("PostModelSwitch",o)),c.hooks=s}return c.permissions={allow:[...WEAVE_PERMISSIONS_ALLOW],deny:[...WEAVE_PERMISSIONS_DENY]},c.env={WEAVE_ENABLED:"true"},t.helpers&&(c.statusLine={type:"command",command:u.os==="windows"?`node "${o}/statusline.cjs"`:"node "+o+"/statusline.cjs",padding:0,refreshInterval:30}),c}export function mergeSettingsJson(n,t){const e={...n},u=t.hooks;if(u&&typeof u=="object"){const i=d(l(e.hooks)?{...e.hooks}:{})??{};for(const[a,p]of Object.entries(u)){const m=i[a];m===void 0?i[a]=p:Array.isArray(m)&&(i[a]=[...m,...Array.isArray(p)?p:[]])}e.hooks=i}const o=e.statusLine;t.statusLine&&(o===void 0||statusLineIsWeave(o))&&(e.statusLine=t.statusLine);const c=t.permissions;if(c&&typeof c=="object"){const i=l(e.permissions)?e.permissions:{};for(const a of["allow","deny"]){const p=c[a],m=i[a];Array.isArray(p)?i[a]=y(m,p):m===void 0&&(i[a]=p)}e.permissions=i}const s=t.env;if(s&&typeof s=="object"){const i=l(e.env)?e.env:{};for(const[a,p]of Object.entries(s))i[a]===void 0&&(i[a]=p);e.env=i}return e}function l(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}export function statusLineIsWeave(n){if(!l(n))return!1;const t=n.command;return typeof t=="string"&&h(t,f)}function h(n,t){return n.replace(/\\/g,"/").includes(t)}function y(n,t){return Array.isArray(n)?[...n,...t.filter(e=>!n.includes(e))]:[...t]}export function stripWeaveSettings(n){const t={...n};if(l(t.hooks)){const e=d(t.hooks);e?t.hooks=e:delete t.hooks}if(statusLineIsWeave(t.statusLine)&&delete t.statusLine,l(t.permissions)){const e={...t.permissions},u=(o,c)=>{const s=e[o];if(!Array.isArray(s))return;const i=s.filter(a=>!c.includes(a));i.length>0?e[o]=i:delete e[o]};u("allow",WEAVE_PERMISSIONS_ALLOW),u("deny",WEAVE_PERMISSIONS_DENY),Object.keys(e).length>0?t.permissions=e:delete t.permissions}if(l(t.env)){const e={...t.env};delete e.WEAVE_ENABLED,Object.keys(e).length>0?t.env=e:delete t.env}return t.$comment===S&&delete t.$comment,t}

package/node_modules/@weavecode/harness/dist/claude/side-question.js

@@ -1 +1,2 @@
-import{existsSync as i}from"node:fs";const a=2e3,E=/^[^\x00-\x1f\x7f]+$/,F=/^<(?:analysis|summary)>/,e=(u,t)=>u&&typeof u=="object"?u[t]:void 0;export const CLAUDE_SIDE_QUESTION={command(u){return`/btw ${u}`},validate(u){const t=u.trim();return t?t.length>a?{ok:!1,error:`\u95EE\u9898\u8FC7\u957F\uFF08\u4E0A\u9650 ${a} \u5B57\u7B26\uFF09`}:E.test(t)?{ok:!0,text:t}:{ok:!1,error:"\u95EE\u9898\u4E0D\u80FD\u542B\u6362\u884C\u6216\u63A7\u5236\u5B57\u7B26\uFF08\u4F1A\u63D0\u524D\u63D0\u4EA4\uFF09"}:{ok:!1,error:"\u95EE\u9898\u4E0D\u80FD\u4E3A\u7A7A"}},answerOf(u,t){if(u!=="SubagentStop")return null;const s=e(t,"raw"),r=e(s,"agent_transcript_path");if(typeof r!="string"||!r||i(r))return null;const o=e(s,"last_assistant_message");if(typeof o!="string")return null;const n=o.trim();return n&&!F.test(n)?n:null}};
+import{existsSync as a}from"node:fs";const s=2e3,o=/^[^\x00-\x1f\x7f]+$/,c=/^<(?:analysis|summary)>/,p="exploring|reviewing|inspecting|tracing|checking|locating|reporting|summarizing|examining|reading|searching|scanning|analyzing|investigating|fetching|loading|probing|auditing|mapping|listing|comparing|verifying|testing|extracting|processing|measuring|assessing|evaluating|identifying|confirming|drafting|refactoring|debugging|grepping",l=new RegExp(`^[\\p{P}\\s]*(${p})\\b`,"iu"),f=/\p{Script=Han}/u,m=n=>!n.includes(`
+`)&&n.length<=80&&!f.test(n)&&l.test(n),e=(n,t)=>n&&typeof n=="object"?n[t]:void 0;export const CLAUDE_SIDE_QUESTION={command(n){return`/btw ${n}`},validate(n){const t=n.trim();return t?t.length>s?{ok:!1,error:`\u95EE\u9898\u8FC7\u957F\uFF08\u4E0A\u9650 ${s} \u5B57\u7B26\uFF09`}:o.test(t)?{ok:!0,text:t}:{ok:!1,error:"\u95EE\u9898\u4E0D\u80FD\u542B\u6362\u884C\u6216\u63A7\u5236\u5B57\u7B26\uFF08\u4F1A\u63D0\u524D\u63D0\u4EA4\uFF09"}:{ok:!1,error:"\u95EE\u9898\u4E0D\u80FD\u4E3A\u7A7A"}},answerOf(n,t){if(n!=="SubagentStop")return null;const r=e(t,"raw"),u=e(r,"agent_transcript_path");if(typeof u!="string"||!u||a(u))return null;const g=e(r,"last_assistant_message");if(typeof g!="string")return null;const i=g.trim();return i&&!c.test(i)&&!m(i)?i:null}};

package/node_modules/@weavecode/harness/dist/claude/statusline/config.d.ts

@@ -167,7 +167,7 @@ export declare const LEGACY_METRICS_LINE: SegmentKey[];
  * context bar.
  *
  * ```
- * 🤖 Model: deepseek-flash[1M] 🧠 [░░░░░░░░░░░░] 39k/1.0M (4%) 🌿 main ✏️ (+1, -1)
+ * 🤖 Model: <网关模型ID>[1M] 🧠 [░░░░░░░░░░░░] 39k/1.0M (4%) 🌿 main ✏️ (+1, -1)
  * 🧩 Thinking: high 💸 Cost: $0.45 🔢 Total: 960.9k 📁 D:\…\weave-cli
  * ```
  *

package/node_modules/@weavecode/harness/dist/claude/transcript.d.ts

@@ -17,6 +17,15 @@ export declare function interruptMarkerAt(tail: string): number | null;
  * 故这里只答「最近这一轮用的是什么」，不猜配置。
  */
 export declare function currentModelAt(tail: string): string | null;
+/**
+ * 转录尾部最后一次上报的推理档位（assistant 条目顶层的 `effort`）。
+ *
+ * 为什么绕到转录：hook 事件带的 `effort.level` 只出现在工具/回合类事件上
+ * （Notification / SessionStart 这些不带），而 daemon 重启会清掉内存里的「最后
+ * 已知」——不清的话，重启后这个会话会一直显「未知」，直到下一次工具调用。
+ * 转录里这份与 `message.model` 同位，重启后立刻读得到。
+ */
+export declare function currentEffortAt(tail: string): string | null;
 /**
  * 转录尾部最后一次的执行模式（条目上的 `permissionMode`）。
  *
@@ -25,3 +34,12 @@ export declare function currentModelAt(tail: string): string | null;
  * 宿主自己算下一个模式（还会被计划提案、auto 闸插手），这里只读不猜。
  */
 export declare function currentModeAt(tail: string): string | null;
+/**
+ * 转录尾部最后一条 assistant 的上下文窗口占用（`message.usage` 四项之和：
+ * input + cache_read + cache_creation + output——实测与宿主 SessionStart 的
+ * `context_tokens` 交叉吻合）。
+ *
+ * 语义是「**上一轮完成时**的占用」：正在跑的那轮要等它写出 assistant 记录才
+ * 更新——与模型/模式的「最后已知」同口径。没有 usage 的行（合成条目等）跳过。
+ */
+export declare function currentContextTokensAt(tail: string): number | null;

package/node_modules/@weavecode/harness/dist/claude/transcript.js

@@ -1,4 +1,6 @@
-const s="[Request interrupted by user";function c(n){return typeof n=="string"?n:Array.isArray(n)?n.map(t=>{const e=t?.text;return typeof e=="string"?e:""}).join(""):""}export function interruptMarkerAt(n){let t=null;for(const e of n.split(`
-`)){if(!e.includes(s))continue;let o;try{o=JSON.parse(e)}catch{continue}const r=o;if(r?.type!=="user"||!c(r.message?.content).startsWith(s))continue;const i=Date.parse(String(r.timestamp));Number.isFinite(i)&&(t===null||i>t)&&(t=i)}return t}const u="<synthetic>";export function currentModelAt(n){let t=null;for(const e of n.split(`
-`)){if(!e.includes('"model"'))continue;let o;try{o=JSON.parse(e)}catch{continue}const r=o,i=r?.message?.model??r?.model;typeof i!="string"||!i||i===u||(t=i)}return t}export function currentModeAt(n){let t=null;for(const e of n.split(`
-`)){if(!e.includes("permissionMode"))continue;let o;try{o=JSON.parse(e)}catch{continue}const r=o?.permissionMode;typeof r!="string"||!r||(t=r)}return t}
+const u="[Request interrupted by user";function f(r){return typeof r=="string"?r:Array.isArray(r)?r.map(e=>{const n=e?.text;return typeof n=="string"?n:""}).join(""):""}export function interruptMarkerAt(r){let e=null;for(const n of r.split(`
+`)){if(!n.includes(u))continue;let o;try{o=JSON.parse(n)}catch{continue}const t=o;if(t?.type!=="user"||!f(t.message?.content).startsWith(u))continue;const i=Date.parse(String(t.timestamp));Number.isFinite(i)&&(e===null||i>e)&&(e=i)}return e}const l="<synthetic>";export function currentModelAt(r){let e=null;for(const n of r.split(`
+`)){if(!n.includes('"model"'))continue;let o;try{o=JSON.parse(n)}catch{continue}const t=o,i=t?.message?.model??t?.model;typeof i!="string"||!i||i===l||(e=i)}return e}export function currentEffortAt(r){let e=null;for(const n of r.split(`
+`)){if(!n.includes('"effort"'))continue;let o;try{o=JSON.parse(n)}catch{continue}const t=o?.effort;typeof t!="string"||!t||(e=t)}return e}export function currentModeAt(r){let e=null;for(const n of r.split(`
+`)){if(!n.includes("permissionMode"))continue;let o;try{o=JSON.parse(n)}catch{continue}const t=o?.permissionMode;typeof t!="string"||!t||(e=t)}return e}export function currentContextTokensAt(r){let e=null;for(const n of r.split(`
+`)){if(!n.includes('"usage"'))continue;let o;try{o=JSON.parse(n)}catch{continue}const t=o?.message?.usage;if(!t||typeof t!="object")continue;const i=s=>typeof t[s]=="number"&&Number.isFinite(t[s])?t[s]:0,c=i("input_tokens")+i("output_tokens")+i("cache_read_input_tokens")+i("cache_creation_input_tokens");c<=0||(e=c)}return e}

package/node_modules/@weavecode/harness/dist/codex/assets.js

@@ -1 +1 @@
-import i from"node:path";import{FILE_ASSET_SPECS as n}from"../shared/file-specs.js";import{readCodexMcpServers as l,removeCodexMcpServer as d,writeCodexMcpServer as a}from"./mcp.js";const c=e=>i.join(e,".codex","config.toml");export const CODEX_ASSETS={harness:"codex",targetDir(e,r,o,s){const t=n[e].dirs.codex;if(r!=="user"||!t?.user)throw new Error(`"${e}" has no Codex ${r==="user"?"user":"project"} surface`);return i.join(s,...t.user.split("/"))},projectSkillsDir:()=>".codex/skills",globalSkillsRoots:e=>[i.join(e,...".agents/skills".split("/")),i.join(e,...".codex/skills".split("/"))],userConfigFile:e=>c(e),mcpScopes:()=>["user"],mcpDest:(e,r)=>e==="user"?c(r):void 0,pluginCacheDir:e=>i.join(e,".codex","plugins","cache"),async mcpRead(e,r,o){if(e!=="user")throw new Error("Codex MCP servers are user-level only (~/.codex/config.toml)");return l(c(o))},async mcpWrite(e,r,o,s,t){if(e!=="user")throw new Error("Codex MCP servers are user-level only (~/.codex/config.toml)");await a(s,t,c(o))},async mcpRemove(e,r,o,s){if(e!=="user")throw new Error("Codex MCP servers are user-level only (~/.codex/config.toml)");return d(s,c(o))},classify(e){return e===".codex"||e.startsWith(".codex/")?!0:e.slice(e.lastIndexOf("/")+1)==="AGENTS.md"},ignore(e){return!(e===".codex"||e.startsWith(".codex/")||e==="AGENTS.md")}};
+import t from"node:path";import{FILE_ASSET_SPECS as n}from"../shared/file-specs.js";import{readCodexMcpServers as l,removeCodexMcpServer as a,writeCodexMcpServer as d}from"./mcp.js";const i=e=>t.join(e,".codex","config.toml");export const CODEX_ASSETS={harness:"codex",targetDir(e,r,s,o){const c=n[e].dirs.codex;if(r!=="user"||!c?.user)throw new Error(`"${e}" has no Codex ${r==="user"?"user":"project"} surface`);return t.join(o,...c.user.split("/"))},projectSkillsRoots:()=>[".codex/skills",".agents/skills"],globalSkillsRoots:e=>[t.join(e,...".agents/skills".split("/")),t.join(e,...".codex/skills".split("/"))],userConfigFile:e=>i(e),mcpScopes:()=>["user"],mcpDest:(e,r)=>e==="user"?i(r):void 0,pluginCacheDir:e=>t.join(e,".codex","plugins","cache"),async mcpRead(e,r,s){if(e!=="user")throw new Error("Codex MCP servers are user-level only (~/.codex/config.toml)");return l(i(s))},async mcpWrite(e,r,s,o,c){if(e!=="user")throw new Error("Codex MCP servers are user-level only (~/.codex/config.toml)");await d(o,c,i(s))},async mcpRemove(e,r,s,o){if(e!=="user")throw new Error("Codex MCP servers are user-level only (~/.codex/config.toml)");return a(o,i(s))},classify(e){return e===".codex"||e.startsWith(".codex/")||e===".agents"||e.startsWith(".agents/")?!0:e.slice(e.lastIndexOf("/")+1)==="AGENTS.md"},ignore(e){return!(e===".codex"||e.startsWith(".codex/")||e===".agents"||e.startsWith(".agents/")||e==="AGENTS.md")}};

package/node_modules/@weavecode/harness/dist/codex/capture.d.ts

@@ -0,0 +1,71 @@
+import type { CaptureDeps, CaptureScriptHealth, CaptureState, CaptureSurface } from '../driver.js';
+/**
+ * codex 采集集成（`<CODEX_HOME>/hooks.json` 的 weave 组 + hook-handler 脚本）。
+ *
+ * codex 0.163 起带 Claude 同形的 hooks 引擎：stdin JSON、字段名与 claude 逐字对齐
+ * （`codex-rs/hooks/schema/generated/*.command.input.schema.json`），只是事件词表
+ * 少几个、多一个 `Interrupt`。故脚本正文与 claude 共用一份生成器（`OWN_HARNESS`
+ * 不同决定它只认自己那份注入规则），本文件只管 codex 的声明落点与信任闸。
+ *
+ * **信任闸**（codex 独有）：非 builtin / 非 managed 的 handler 必须有
+ * `[hooks.state.'<hooks.json>:<event>:<group>:<handler>'] trusted_hash`，否则
+ * **静默不执行**。哈希盖住 handler 的声明内容 ⇒ `command` 串必须**恒定**（不含
+ * 版本号/时间戳），版本差异全放在脚本内部。这样「Trust all and continue」点过
+ * 一次即长期有效，weave 升级不重弹。weave 不自己算这个哈希：那等于替用户签字，
+ * 且依赖 codex 内部的 TOML 规范化序列化，算错的表现就是「静默不跑」。
+ *
+ * 只装 user 档：项目档（`<repo>/.codex/hooks.json`）还额外要求该文件夹被 codex
+ * 标成 trusted，多一道用户自解不了的坎。
+ */
+/**
+ * 要订阅的 codex 线名（`HookEventsToml` 的键，`codex-rs/config/src/hook_config.rs:39`）
+ * ——由 `HARNESS_EVENTS.codex` 反推，不另抄一份线名表。`PreToolUse` /
+ * `PermissionRequest` / `PreModelRequest` / `PostModelRequest` 不订阅：量最大且
+ * 眼下没有消费方。
+ */
+export declare const CODEX_HOOK_EVENTS: readonly string[];
+/**
+ * weave 采集组的判据：命令指向 `<CODEX_HOME>/helpers/hook-handler.cjs`。用相对段
+ * 而非绝对路径——`CODEX_HOME` 可被用户搬走，声明文件跟着搬，相对段仍命中。
+ */
+export declare const CODEX_HOOK_HANDLER_MARKER = "helpers/hook-handler.cjs";
+/** 一个 group 是 weave 的，当它的任一命令指向 hook-handler 脚本。 */
+export declare function groupIsWeave(group: unknown): boolean;
+/**
+ * hooks 子图清掉 weave 采集组：用户组不动；事件清空删键；非数组形状属用户，
+ * 原样保留。返回清扫后的新子图。
+ */
+export declare function sweepWeaveHookEvents(hooks: unknown): Record<string, unknown>;
+/**
+ * 单事件的 weave 采集组。`command` 串恒定（脚本路径 + 固定超时），这正是
+ * trusted_hash 跨 weave 升级保持有效的前提。唯一会变的是路径本身：搬
+ * `CODEX_HOME` / 改数据目录后要重装一次。
+ */
+export declare function captureHookGroup(event: string, script: string): Array<Record<string, unknown>>;
+/** hooks.json 里是否已有 weave 采集组（installed 判据）。 */
+export declare function captureGroupsPresent(file: unknown): boolean;
+export declare function readUserCapture(deps?: CaptureDeps): Promise<CaptureState>;
+/**
+ * 生效采集脚本的健康（诊断面只读）。codex 没有项目档分支（项目 hooks 要文件夹
+ * 信任，weave 不装），故 source 只有 user / none 两态。`reportsInbox` 恒 false：
+ * codex 侧没有会话 inbox 凭据这个概念（层①-a 投递是 claude 专属）。
+ */
+export declare function readScriptHealth(deps?: CaptureDeps & {
+    projectPath?: string;
+}): Promise<CaptureScriptHealth>;
+/**
+ * user 档采集安装（幂等）：`<CODEX_HOME>/helpers/hook-handler.cjs` + `hooks.json`
+ * 的 weave 组（weave 组清扫后并入，用户自己的 hooks 与 description 永不动）。
+ */
+export declare function installUserCapture(deps: CaptureDeps & {
+    version: string;
+}): Promise<void>;
+/**
+ * user 档采集停用（幂等）：清扫 hooks.json 的 weave 组 + 删脚本（带 weave 标记
+ * 才删）。清完只剩空 hooks 与 weave 自己写的 description 时整份删掉——那是
+ * weave 建的文件，留着只会让 codex 每次多读一个空声明。
+ */
+export declare function uninstallUserCapture(deps?: CaptureDeps): Promise<void>;
+/** 项目档去重：user 档接管时清扫该项目 `.codex/hooks.json` 的 weave 组。 */
+export declare function stripProjectCapture(projectPath: string): Promise<void>;
+export declare const CODEX_CAPTURE: CaptureSurface;

package/node_modules/@weavecode/harness/dist/codex/capture.js

@@ -0,0 +1,2 @@
+import{access as A,mkdir as y,readFile as d,unlink as k,writeFile as x}from"node:fs/promises";import i from"node:path";import{HARNESS_EVENTS as j}from"@weavecode/core";import{generateHookHandler as g}from"../claude/capture.js";import{CANONICAL_TO_WIRE as C}from"./event-source.js";import{codexHome as v}from"./home.js";export const CODEX_HOOK_EVENTS=j.codex.map(t=>C[t]??t),CODEX_HOOK_HANDLER_MARKER="helpers/hook-handler.cjs";const O="@version weave@",H=3;function a(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function f(t){return t.replace(/\\/g,"/")}function h(t){return i.join(v(t),"hooks.json")}function E(t){return i.join(v(t),"helpers")}function u(t){return i.join(E(t),"hook-handler.cjs")}export function groupIsWeave(t){if(!a(t))return!1;const e=t.hooks;return Array.isArray(e)?e.some(o=>{if(!a(o))return!1;const n=o.commandWindows;return typeof o.command=="string"&&f(o.command).includes(CODEX_HOOK_HANDLER_MARKER)||typeof n=="string"&&f(n).includes(CODEX_HOOK_HANDLER_MARKER)}):!1}export function sweepWeaveHookEvents(t){if(!a(t))return{};const e={};for(const[o,n]of Object.entries(t)){if(!Array.isArray(n)){e[o]=n;continue}const r=n.filter(s=>!groupIsWeave(s));r.length>0&&(e[o]=r)}return e}export function captureHookGroup(t,e){const o=`node "${f(e)}"`;return[{hooks:[{type:"command",command:o,commandWindows:o,timeout:H,...t==="PostToolUse"?{async:!0}:{}}]}]}export function captureGroupsPresent(t){if(!a(t))return!1;const e=t.hooks;return a(e)?Object.values(e).some(o=>Array.isArray(o)&&o.some(groupIsWeave)):!1}async function N(t){try{return await A(t),!0}catch{return!1}}async function l(t){let e;try{e=await d(t,"utf-8")}catch{return{}}let o;try{o=JSON.parse(e)}catch{throw new Error(`codex hooks file is not parseable JSON: ${t}`)}if(!a(o))throw new Error(`codex hooks file is not a JSON object: ${t}`);return o}async function m(t,e){await y(i.dirname(t),{recursive:!0}),await x(t,JSON.stringify(e,null,2)+`
+`,"utf-8")}export async function readUserCapture(t={}){const e=t.home,o=await l(h(e)).catch(()=>({}));return{installed:captureGroupsPresent(o),helperPresent:await N(u(e))}}export async function readScriptHealth(t={}){const e=t.home,o=u(e),n=(await readUserCapture({home:e})).installed;let r=null;try{r=await d(o,"utf-8")}catch{r=null}return{source:n?"user":"none",present:r!==null,weaveOwned:r!==null&&r.includes(O),generatedVersion:r?.match(/@version weave@(\S+)/)?.[1]??null,reportsInbox:!1,reportsPaneEnv:r!==null&&r.includes("terminalEnv()")}}export async function installUserCapture(t){const e=t.home,o=E(e);await y(o,{recursive:!0});const n=u(e);await x(n,g(t.version,"codex"),"utf-8");const r=h(e),s=await l(r),p=sweepWeaveHookEvents(s.hooks);for(const c of CODEX_HOOK_EVENTS){const w=p[c];p[c]=Array.isArray(w)?[...w,...captureHookGroup(c,n)]:captureHookGroup(c,n)}s.hooks=p,typeof s.description!="string"&&(s.description="weave hooks (generated \u2014 do not edit)"),await m(r,s)}export async function uninstallUserCapture(t={}){const e=t.home,o=h(e),n=await l(o).catch(()=>null);if(n){const s=sweepWeaveHookEvents(n.hooks);Object.keys(s).length===0?delete n.hooks:n.hooks=s,n.hooks===void 0&&(n.description===void 0||n.description==="weave hooks (generated \u2014 do not edit)")?await k(o).catch(()=>{}):await m(o,n)}const r=u(e);try{(await d(r,"utf-8")).includes(O)&&await k(r)}catch{}}export async function stripProjectCapture(t){const e=i.join(t,".codex","hooks.json"),o=await l(e).catch(()=>null);if(!o)return;const n=sweepWeaveHookEvents(o.hooks);Object.keys(n).length===0?delete o.hooks:o.hooks=n,await m(e,o)}export const CODEX_CAPTURE={harness:"codex",readUserCapture:t=>readUserCapture(t),installUserCapture:t=>installUserCapture(t),uninstallUserCapture:t=>uninstallUserCapture(t),stripProjectCapture,scriptHealth:t=>readScriptHealth(t)};

package/node_modules/@weavecode/harness/dist/codex/commands.d.ts

@@ -0,0 +1,5 @@
+import type { CommandsSurface, HarnessCommand } from '../driver.js';
+export declare function createCodexCommandSurface(deps?: {
+    skills?: (projectPath: string) => Promise<HarnessCommand[] | null>;
+}): CommandsSurface;
+export declare const CODEX_COMMANDS: CommandsSurface;

package/node_modules/@weavecode/harness/dist/codex/commands.js

@@ -0,0 +1,4 @@
+import{spawn as p}from"node:child_process";import{readdir as m,readFile as f,stat as b}from"node:fs/promises";import{homedir as S}from"node:os";import r from"node:path";import{codexCommandLine as x}from"./plugins.js";const v=[{name:"model",description:"Choose what model and reasoning effort to use",source:"builtin"},{name:"approvals",description:"Choose what Codex can do without approval",source:"builtin"},{name:"new",description:"Start a new chat during a conversation",source:"builtin"},{name:"init",description:"Create an AGENTS.md file with project instructions",source:"builtin"},{name:"compact",description:"Summarize the conversation to free context",source:"builtin"},{name:"diff",description:"Show the diff of the working tree",source:"builtin"},{name:"mention",description:"Mention a file in the conversation",argsHint:"<path>",source:"builtin"},{name:"status",description:"Show session configuration and token usage",source:"builtin"},{name:"mcp",description:"List configured MCP tools",source:"builtin"},{name:"prompts",description:"Browse and use custom prompts",source:"builtin"},{name:"skills",description:"Browse and use skills",source:"builtin"},{name:"plugins",description:"Browse and manage plugins",source:"builtin"},{name:"review",description:"Review the current changes",source:"builtin"},{name:"undo",description:"Undo the last turn",source:"builtin"},{name:"statusline",description:"Configure the status line",source:"builtin"},{name:"logout",description:"Sign out of your account",source:"builtin"},{name:"quit",description:"Exit Codex",source:"builtin"}];function h(t){const n=/^---\r?\n([\s\S]*?)\r?\n---/.exec(t)?.[1]??"";return/^description:\s*(.+)$/m.exec(n)?.[1]?.trim().replace(/^["']|["']$/g,"")||(t.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/,"").split(`
+`).find(e=>e.trim()!==""&&!e.startsWith("#"))?.trim()??"")}async function w(t){try{const n=await b(t);return n.isDirectory()?"dir":n.isFile()?"file":"other"}catch{return"other"}}async function k(t){try{const n=[];for(const i of await m(t,{withFileTypes:!0})){if(!i.name.endsWith(".md"))continue;const e=r.join(t,i.name);(i.isFile()||i.isSymbolicLink()&&await w(e)==="file")&&n.push(e)}return n}catch{return[]}}async function C(t){try{const n=[];for(const i of await m(t,{withFileTypes:!0})){const e=r.join(t,i.name);(i.isDirectory()||i.isSymbolicLink()&&await w(e)==="dir")&&n.push(e)}return n}catch{return[]}}async function j(t){const n=[];for(const i of await k(t)){const e=h(await f(i,"utf8").catch(()=>""));n.push({name:r.basename(i,".md"),description:e,source:"command"})}return n}async function L(t){const n=[];for(const i of await C(t)){const e=h(await f(r.join(i,"SKILL.md"),"utf8").catch(()=>""));n.push({name:r.basename(i),description:e,source:"skill",sigil:"$"})}return n}function O(t){const n=t?.data;if(!Array.isArray(n))return null;const i=[];for(const e of n){const s=e?.skills;if(Array.isArray(s))for(const c of s){const o=c;typeof o.name!="string"||o.enabled===!1||i.push({name:o.name,description:typeof o.description=="string"?o.description:"",source:typeof o.pluginId=="string"?"plugin":"skill",sigil:"$"})}}return i}const A=1e4;function E(t){return new Promise(n=>{const i=process.platform==="win32",e=p(i?process.env.ComSpec||"cmd.exe":"codex",i?["/d","/s","/c",x(["app-server"])]:["app-server"],{windowsHide:!0,windowsVerbatimArguments:i,stdio:["pipe","pipe","pipe"]});let s=!1,c="";const o=a=>{s||(s=!0,clearTimeout(g),i&&e.pid!==void 0?p("taskkill",["/pid",String(e.pid),"/t","/f"],{windowsHide:!0,stdio:"ignore"}).unref():e.kill("SIGKILL"),n(a))},g=setTimeout(()=>o(null),A),l=a=>{e.stdin?.write(`${JSON.stringify(a)}
+`)};e.on("error",()=>o(null)),e.on("exit",()=>o(null)),e.stdin?.on("error",()=>o(null)),l({jsonrpc:"2.0",id:1,method:"initialize",params:{clientInfo:{name:"weave",title:"weave",version:"1.0.0"}}}),e.stdout?.setEncoding("utf8"),e.stdout?.on("data",a=>{c+=a;let d;for(;(d=c.indexOf(`
+`))>=0;){const y=c.slice(0,d);c=c.slice(d+1);let u=null;try{u=JSON.parse(y)}catch{continue}if(u?.id===1){l({jsonrpc:"2.0",method:"initialized",params:{}}),l({jsonrpc:"2.0",id:2,method:"skills/list",params:{cwds:[t]}});continue}u?.id===2&&o(O(u.result))}})})}function I(t){const n=new Set;return t.filter(i=>n.has(i.name)?!1:(n.add(i.name),!0))}export function createCodexCommandSurface(t={}){const n=t.skills??E;return{harness:"codex",async list({projectPath:i,homedir:e=S()}){const s=process.env.CODEX_HOME??r.join(e,".codex");return I([...v,...await j(r.join(s,"prompts")),...await n(i)??await L(r.join(s,"skills"))])},executions:()=>Promise.resolve(null)}}export const CODEX_COMMANDS=createCodexCommandSurface();

package/node_modules/@weavecode/harness/dist/codex/config-catalog.generated.d.ts

@@ -0,0 +1,10 @@
+/**
+ * codex 配置词表（config.toml 键）——**生成物，勿手改**。
+ * 重新生成：`node scripts/gen-codex-catalog.mjs`（`pnpm gen:codex-catalog`）。
+ *
+ * 源：https://raw.githubusercontent.com/openai/codex/main/codex-rs/core/config.schema.json
+ * 生成日期：2026-10-22
+ */
+import type { ConfigKeySpec } from '../driver.js';
+export declare const CODEX_CONFIG_GROUPS: readonly string[];
+export declare const CODEX_CONFIG_KEYS: readonly ConfigKeySpec[];

package/node_modules/@weavecode/harness/dist/codex/config-catalog.generated.js

@@ -0,0 +1 @@
+export const CODEX_CONFIG_GROUPS=["Model","Approvals & sandbox","Profiles","MCP servers","Plugins & marketplaces","Projects & docs","Hooks","Features","TUI","Shell & execution","Tools","Agents & automation","Skills & memories","Apps & integrations","Auth & network","Updates & telemetry","General"],CODEX_CONFIG_KEYS=[{key:"model",group:"Model",description:"Optional override of model selection.",scope:"any",type:"String"},{key:"model_auto_compact_token_limit",group:"Model",description:"Token usage threshold triggering auto-compaction of conversation history.",scope:"any",type:"Integer"},{key:"model_auto_compact_token_limit_scope",group:"Model",description:"Controls whether the auto-compaction limit applies to the full context or only to tokens after the carried prefix in the current compaction window.",scope:"any",type:"String",options:["total","body_after_prefix"]},{key:"model_catalog_json",group:"Model",description:"Optional path to a JSON model catalog (applied on startup only). Per-thread config overrides are accepted but do not reapply this (no-ops).",scope:"any",type:"String"},{key:"model_context_window",group:"Model",description:"Size of the context window for the model, in tokens.",scope:"any",type:"Integer"},{key:"model_instructions_file",group:"Model",description:"Optional path to a file containing model instructions that will override the built-in instructions for the selected model. Users are STRONGLY DISCOURAGED from using this field, as deviating from the instructions sanctioned by Codex will likely degrade model performance.",scope:"any",type:"String"},{key:"model_post_turn_compact_threshold_percent",group:"Model",description:"Percentage of the usable context window that triggers compaction after a final response. Existing auto-compaction limits still apply. Omitted or zero disables turn-end compaction; valid values are 0\u2013100.",scope:"any",type:"Integer"},{key:"model_provider",group:"Model",description:"Provider to use from the model_providers map.",scope:"user",type:"String"},{key:"model_providers",group:"Model",description:"User-defined provider entries that extend the built-in list. Built-in IDs cannot be overridden.",scope:"user",type:"Object",shape:"map",fields:[{name:"auth",type:"Object",description:"Command-backed bearer-token configuration for this provider."},{name:"aws",type:"Object",description:"AWS SigV4 auth configuration for this provider."},{name:"base_url",type:"String",description:"Base URL for the provider's OpenAI-compatible API."},{name:"capabilities",type:"Object",description:"Optional API capability overrides for a custom Responses-compatible provider. Unspecified capabilities retain their existing provider defaults."},{name:"env_http_headers",type:"Object",description:"Optional HTTP headers to include in requests to this provider where the (key, value) pairs are the header name and _environment variable_ whose value should be used. If the environment variable is not set, or the value is empty, the header will not be included in the request."},{name:"env_key",type:"String",description:"Environment variable that stores the user's API key for this provider."},{name:"env_key_instructions",type:"String",description:"Optional instructions to help the user get a valid value for the variable and set it."},{name:"experimental_bearer_token",type:"String",description:"Value to use with Authorization: Bearer <token> header. Use of this config is discouraged in favor of env_key for security reasons, but this may be necessary when using this programmatically."},{name:"gateway_oauth",type:"Object",description:"Secondary OAuth credentials required by the provider's gateway."},{name:"http_headers",type:"Object",description:"Additional HTTP headers to include in requests to this provider where the (key, value) pairs are the header name and value."},{name:"model_catalog_url",type:"String",description:"Optional full URL for a Codex-native model catalog. When unset, OpenAI discovery uses the Codex backend unless base_url overrides the inference endpoint."},{name:"name",type:"String",description:"Friendly display name."},{name:"query_params",type:"Object",description:"Optional query parameters to append to the base URL."},{name:"request_max_retries",type:"Integer",description:"Maximum number of times to retry a failed HTTP request to this provider."},{name:"requires_openai_auth",type:"Boolean",description:"Does this provider require an OpenAI API key or ChatGPT login token? If true, the user is presented with a login screen on first run, and credentials are stored using the backend selected by cli_auth_credentials_store. If false (the default), the login screen is skipped\u2026"},{name:"stream_idle_timeout_ms",type:"Integer",description:"Idle timeout (in milliseconds) to wait for activity on a streaming response before treating the connection as lost."},{name:"stream_max_retries",type:"Integer",description:"Number of times to retry reconnecting a dropped streaming response before failing."},{name:"supports_standalone_web_search",type:"Boolean",description:"Whether this provider supports the standalone web-search endpoint."},{name:"supports_websockets",type:"Boolean",description:"Whether this provider supports the Responses API WebSocket transport."},{name:"websocket_connect_timeout_ms",type:"Integer",description:"Maximum time (in milliseconds) to wait for a websocket connection attempt before treating it as failed."},{name:"wire_api",type:"String",options:["responses"],description:"Which wire protocol this provider expects."}]},{key:"model_reasoning_effort",group:"Model",description:"A non-empty reasoning effort value advertised by the model.",scope:"any",type:"String"},{key:"model_reasoning_summary",group:"Model",description:"A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries",scope:"any",type:"String",options:["auto","concise","detailed","none"]},{key:"model_verbosity",group:"Model",description:"Optional verbosity control for GPT-5 models (Responses API text.verbosity).",scope:"any",type:"String",options:["low","medium","high"]},{key:"oss_provider",group:"Model",description:'Preferred OSS provider for local models, e.g. "lmstudio" or "ollama".',scope:"any",type:"String"},{key:"plan_mode_reasoning_effort",group:"Model",description:"A non-empty reasoning effort value advertised by the model.",scope:"any",type:"String"},{key:"review_model",group:"Model",description:"Review model override used by the /review feature.",scope:"any",type:"String"},{key:"service_tier",group:"Model",description:"Optional explicit service tier request id for new turns (for example default, priority, or flex; legacy fast also works).",scope:"any",type:"String"},{key:"approval_policy",group:"Approvals & sandbox",description:"Default approval policy for executing commands.",scope:"any",type:"String",options:["on-request","never"]},{key:"approvals_reviewer",group:"Approvals & sandbox",description:"Configures who approval requests are routed to for review once they have been escalated. This does not disable separate safety checks such as ARC.",scope:"any",type:"String",options:["user","auto_review","guardian_subagent"]},{key:"default_permissions",group:"Approvals & sandbox",description:"Default permissions profile to apply. Names starting with : refer to built-in profiles; other names are resolved from the [permissions] table.",scope:"any",type:"String"},{key:"permissions",group:"Approvals & sandbox",description:"Named permissions profiles.",scope:"any",type:"Object"},{key:"sandbox_mode",group:"Approvals & sandbox",description:"Sandbox mode to use.",scope:"any",type:"String",options:["read-only","workspace-write","danger-full-access"]},{key:"sandbox_workspace_write.exclude_slash_tmp",group:"Approvals & sandbox",default:"false",description:"Sandbox configuration to apply if sandbox is WorkspaceWrite.",scope:"any",type:"Boolean"},{key:"sandbox_workspace_write.exclude_tmpdir_env_var",group:"Approvals & sandbox",default:"false",description:"Sandbox configuration to apply if sandbox is WorkspaceWrite.",scope:"any",type:"Boolean"},{key:"sandbox_workspace_write.network_access",group:"Approvals & sandbox",default:"false",description:"Sandbox configuration to apply if sandbox is WorkspaceWrite.",scope:"any",type:"Boolean"},{key:"sandbox_workspace_write.writable_roots",group:"Approvals & sandbox",description:"Sandbox configuration to apply if sandbox is WorkspaceWrite.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"profile",group:"Profiles",description:"Profile to use from the profiles map.",scope:"user",type:"String"},{key:"profiles",group:"Profiles",description:"Named profiles to facilitate switching between different configurations.",scope:"user",type:"Object",shape:"map",fields:[{name:"analytics",type:"Object",description:"Analytics settings loaded from config.toml. Fields are optional so we can apply defaults."},{name:"approval_policy",type:"String",options:["on-request","never"],description:"Determines the conditions under which the user is consulted to approve running the command proposed by Codex."},{name:"approvals_reviewer",type:"String",options:["user","auto_review","guardian_subagent"],description:"Configures who approval requests are routed to for review. Examples include sandbox escapes, blocked network access, MCP approval prompts, and ARC escalations. Defaults to user. auto_review uses a carefully prompted subagent to gather relevant context and apply a risk-based decision framework before approving or denyin\u2026"},{name:"chatgpt_base_url",type:"String"},{name:"experimental_compact_prompt_file",type:"String",description:"A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem). IMPORTANT: When deserializing an AbsolutePathBuf, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set\u2026"},{name:"experimental_use_unified_exec_tool",type:"Boolean"},{name:"features",type:"Object",description:"Optional feature toggles scoped to this profile."},{name:"include_apps_instructions",type:"Boolean"},{name:"include_collaboration_mode_instructions",type:"Boolean"},{name:"include_environment_context",type:"Boolean"},{name:"include_environment_context_time",type:"Boolean"},{name:"include_permissions_instructions",type:"Boolean"},{name:"model",type:"String"},{name:"model_catalog_json",type:"String",description:"Optional path to a JSON model catalog (applied on startup only)."},{name:"model_instructions_file",type:"String",description:"Optional path to a file containing model instructions."},{name:"model_provider",type:"String",description:"The key in the model_providers map identifying the [ModelProviderInfo] to use."},{name:"model_reasoning_effort",type:"String",description:"A non-empty reasoning effort value advertised by the model."},{name:"model_reasoning_summary",type:"String",options:["auto","concise","detailed","none"],description:"A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries"},{name:"model_verbosity",type:"String",options:["low","medium","high"],description:"Controls output length/detail on GPT-5 models via the Responses API. Serialized with lowercase values to match the OpenAI API."},{name:"oss_provider",type:"String"},{name:"personality",type:"String",options:["none","friendly","pragmatic"],description:"Deprecated: friendly and pragmatic no longer select a style."},{name:"plan_mode_reasoning_effort",type:"String",description:"A non-empty reasoning effort value advertised by the model."},{name:"sandbox_mode",type:"String",options:["read-only","workspace-write","danger-full-access"]},{name:"service_tier",type:"String",description:"Optional explicit service tier request id for new turns (for example default, priority, or flex; legacy fast also works)."},{name:"tools",type:"Object"},{name:"tui",type:"Object",description:"TUI settings scoped to this profile."},{name:"web_search",type:"String",options:["disabled","cached","indexed","live"]},{name:"windows",type:"Object"}]},{key:"mcp_enterprise_managed_auth.idp.client_id",group:"MCP servers",description:"Public OAuth client registered with that enterprise IdP.",scope:"any",type:"String"},{key:"mcp_enterprise_managed_auth.idp.issuer",group:"MCP servers",description:"Issuer used for enterprise OAuth discovery and identity validation.",scope:"any",type:"String"},{key:"mcp_oauth_callback_port",group:"MCP servers",description:"Optional fixed port for the local HTTP callback server used during MCP OAuth login. When unset, Codex will bind to an ephemeral port chosen by the OS.",scope:"any",type:"Integer"},{key:"mcp_oauth_callback_url",group:"MCP servers",description:"Optional redirect URI to use during MCP OAuth login. When set, this URI is used in the OAuth authorization request instead of the local listener address. The local callback listener still binds to 127.0.0.1 (using mcp_oauth_callback_port when provided).",scope:"any",type:"String"},{key:"mcp_oauth_credentials_store",group:"MCP servers",description:"Preferred backend for storing MCP OAuth credentials. keyring: Use an OS-specific keyring service. https://github.com/openai/codex/blob/main/codex-rs/rmcp-client/src/oauth.rs#L2 file: Use a file in the Codex home directory. auto (default): Use the OS-specific keyring service if available, otherwise use a file.",scope:"any",type:"String",options:["auto","file","keyring"]},{key:"mcp_optional_startup_grace_ms",group:"MCP servers",description:"Milliseconds to wait for optional MCP servers while building the initial tool catalog. Defaults to 1000. Set to 0 to disable the shared grace and wait for each server's configured startup_timeout_sec instead.",scope:"any",type:"Integer"},{key:"mcp_servers",group:"MCP servers",description:"Definition for MCP servers that Codex can reach out to for tool calls.",scope:"any",type:"Object",shape:"map",fields:[{name:"args",type:"Array of String"},{name:"auth",type:"String",options:["oauth","chatgpt","ema_auth"],description:"Authentication flow for an HTTP MCP server. Explicit credentials take precedence for OAuth and ChatGPT; EMA rejects alternate credentials and fallback."},{name:"bearer_token_env_var",type:"String"},{name:"command",type:"String"},{name:"cwd",type:"String"},{name:"default_tools_approval_mode",type:"String",options:["auto","prompt","writes","approve"]},{name:"disabled_tools",type:"Array of String"},{name:"enabled",type:"Boolean"},{name:"enabled_tools",type:"Array of String"},{name:"env",type:"Object"},{name:"env_http_headers",type:"Object"},{name:"env_vars",type:"Array of String"},{name:"environment_id",type:"String"},{name:"http_headers",type:"Object"},{name:"http_headers_helper",type:"String"},{name:"name",type:"String",description:"Legacy display-name field accepted for backward compatibility."},{name:"oauth",type:"Object",description:"Client settings for MCP OAuth login or enterprise token exchange."},{name:"oauth_resource",type:"String"},{name:"omit_tools_from",type:"Array of String"},{name:"required",type:"Boolean"},{name:"scopes",type:"Array of String"},{name:"startup_readiness",type:"String",options:["connection","catalog"],description:"Whether startup requires a live connection or can use a valid cached tool catalog."},{name:"startup_timeout_ms",type:"Integer"},{name:"startup_timeout_sec",type:"Number"},{name:"supports_parallel_tool_calls",type:"Boolean"},{name:"tool_input_schema_max_bytes",type:"Integer",description:"UTF-8 byte threshold for compacting each ordinary MCP tool input schema. Defaults to 5,000 bytes. Code Mode also uses an explicitly configured limit when rendering each tool's input type. Larger limits preserve more parameter descriptions."},{name:"tool_timeout_sec",type:"Number"},{name:"tools",type:"Object"},{name:"url",type:"String"}]},{key:"marketplaces",group:"Plugins & marketplaces",description:"User-level marketplace entries keyed by marketplace name.",scope:"any",type:"Object",shape:"map",fields:[{name:"last_revision",type:"String",description:"Git revision Codex last successfully activated for this marketplace."},{name:"last_updated",type:"String",description:"Last time Codex successfully added or refreshed this marketplace."},{name:"ref",type:"String",description:"Git ref to check out when source_type is git."},{name:"source",type:"String",description:"Source location used when the marketplace was added."},{name:"source_type",type:"String",options:["git","local"],description:"Source kind used to install this marketplace."},{name:"sparse_paths",type:"Array of String",description:"Sparse checkout paths used when source_type is git."}]},{key:"plugins",group:"Plugins & marketplaces",description:"Default and per-plugin settings keyed by exact <plugin>@<marketplace> IDs.",scope:"any",type:"Object",shape:"map",fields:[{name:"auto_provision",type:"Boolean",description:"Provisioning metadata. Omission does not request provisioning. Only applies with remote_plugin_id and Plugin Service availability to the requesting user at provisioning time. Effective enablement, trusted provisioning policy, and authentication and authorization restrictions still apply\u2026"},{name:"enabled",type:"Boolean",description:"Explicit activation override. Omission inherits the installed-plugin default."},{name:"mcp_servers",type:"Object",description:"Per-MCP-server policy overlays for MCP servers contributed by this plugin."},{name:"release_id",type:"String",description:"Release identifier used to pin the remote plugin to a specific release. Omission leaves release selection unchanged. Core stores this metadata without selecting or fetching a release."},{name:"remote_plugin_id",type:"String",description:"Stable, unique identifier of a ChatGPT-hosted remote plugin. Availability to the requesting user is determined by Plugin Service at provisioning time."}]},{key:"plugins._default.enabled",group:"Plugins & marketplaces",default:"true",description:"Defaults for installed plugin activation. Omission preserves source enablement. Explicit plugin enablement settings override this default, but cannot enable an installation disabled by its source.",scope:"any",type:"Boolean"},{key:"project_doc_fallback_filenames",group:"Projects & docs",description:"Ordered list of fallback filenames to look for when AGENTS.md is missing.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"project_doc_max_bytes",group:"Projects & docs",default:"32768",description:"Maximum total bytes of project instruction content across all selected environments.",scope:"any",type:"Integer"},{key:"project_root_markers",group:"Projects & docs",description:'Markers used to detect the project root when searching parent directories for .codex folders. Defaults to [".git"] when unset.',scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"projects",group:"Projects & docs",description:"",scope:"any",type:"Object",shape:"map",fields:[{name:"trust_level",type:"String",options:["trusted","untrusted"],description:"Represents the trust level for a project directory. This determines the approval policy and sandbox mode applied."}]},{key:"hooks.Interrupt",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PermissionRequest",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PostCompact",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PostModelRequest",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PostToolUse",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PreCompact",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PreModelRequest",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.PreToolUse",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.SessionEnd",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.SessionStart",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.state",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Object",shape:"map",fields:[{name:"enabled",type:"Boolean"},{name:"trusted_content_hash",type:"String",description:"Approved plugin contents; kept separate for declaration-only clients."},{name:"trusted_hash",type:"String"}]},{key:"hooks.Stop",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.SubagentStart",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.SubagentStop",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"hooks.UserPromptSubmit",group:"Hooks",description:"Lifecycle hooks configured inline in TOML plus user-level overrides.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"hooks",type:"Array of Object"},{name:"matcher",type:"String"}]},{key:"features.agent_message_board",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.analytics_plan_history",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.api_key_cyber_access_programs",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.api_key_model_discovery",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.app_server_websocket_compression",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.apply_patch_freeform",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.apply_patch_preserve_line_endings",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.apply_patch_streaming_events",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.apps",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.apps_mcp_path_override",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.async_compaction",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.auth_elicitation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.background_paginated_rollout_migration",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.bedrock_setup_wizard",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.browser_annotation_api",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.browser_use",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.browser_use_external",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.browser_use_full_cdp_access",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.chronicle",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.cli_daybreak",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_buffered_exec",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_host",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_host_grpc",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_interrupt",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_only",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_only_strict_3p_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_prewarm",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_tool_description_first",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.code_mode_tool_search",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.codex_apps_mcp_2026_07_28",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.codex_git_commit",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.codex_hooks",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.collab",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.collaboration_modes",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.compaction_image_budget",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.computer_use",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.concurrent_reasoning_summaries",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.connectors",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.content_item_kinds",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.context_management",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.credential_masking",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.current_time_reminder",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.cwd_relative_turn_diffs",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.daemon_auto_start",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.default_mode_request_user_input",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.defer_mailbox_preemption",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.deferred_executor",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.deferred_tool_world_state",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.elevated_windows_sandbox",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.enable_experimental_windows_sandbox",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.enable_fanout",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.enable_mcp_apps",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.enable_request_compression",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.exec_permission_approvals",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.executed_tool_call_metadata",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.executor_capability_discovery",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.executor_capability_discovery_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.experimental_use_unified_exec_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.experimental_windows_sandbox",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.external_agent_memory_import",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.external_migration",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.fast_mode",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.goals",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_approval",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_conversation_history_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_enhanced_node_repl_transcripts",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_ext",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_node_repl_transcript_images",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_reuse_parent_compaction",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_root_handoff_context",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardian_trust_orchestrator_connectors",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardianv2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.guardianv2_decisions_comparison",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.hooks",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.image_detail_original",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.image_generation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.image_resize_notice",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.imagegenext",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_browser",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_chat",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_dictation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_local_automation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_updates",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.in_app_voice",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.incremental_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.instant_interrupt",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.item_ids",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.js_repl",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.js_repl_tools_only",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.local_thread_store_compression",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.local_thread_store_shared_compression",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.login_shell_package_path",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.mcp_2026_07_28",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.mcp_oauth_refresh_coordination",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.mcp_tool_list_changed",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.memories",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.memory_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.mentions_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.model_catalog_in_context",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.multi_agent",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.multi_agent_mode",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.multi_agent_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.multi_agent_v2_dynamic_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.multi_env_copy_file",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.network_proxy",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.non_prefixed_mcp_tool_names",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.nonfatal_clock_read_errors",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.omit_app_server_notification_media",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.output_token_replay",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.personality",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.plugin_hooks",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.plugin_sharing",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.plugins",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.powershell_shell_version",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.prefer_mxc",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.prevent_idle_sleep",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.psp",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.realtime_conversation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.reasoning_effort_override",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.recommended_plugins",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.remote_compaction_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.remote_control",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.remote_models",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.remote_plugin",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.request_permissions",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.request_permissions_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.request_rule",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.resize_all_images",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.respect_system_proxy",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.responses_websockets",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.responses_websockets_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.retain_client_developer_messages",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.retain_client_tool_outputs",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.rollout_budget",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.runtime_agent_instances",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.runtime_metrics",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.search_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.secret_auth_storage",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.send_async_message",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.send_message_to_user_async",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.shell_snapshot",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.shell_snapshot_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.shell_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.shell_zsh_fork",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.skill_env_var_dependency_prompt",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.skill_mcp_dependency_install",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.skill_search",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.skip_host_skill_discovery",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.sleep_tool",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.sqlite",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.stable_environment_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.standalone_web_search",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.steer",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.step_model_switching",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.subagent_default_context_limits",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.subagent_thread_environments",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.system_proxy_fallback",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.telepathy",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.terminal_resize_reflow",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.terminal_visualization_instructions",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.token_budget",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.tool_call_mcp_elicitation",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.tool_registry.error_on_tool_collisions",group:"Features",description:"Fail the turn when multiple tools share the same effective name.",scope:"any",type:"Boolean"},{key:"features.tool_registry.turn_metadata_includes_tool_info",group:"Features",description:"Include authoritative tool information in per-turn request metadata.",scope:"any",type:"Boolean"},{key:"features.tool_search",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.tool_search_always_defer_mcp_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.tool_suggest",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.transcript_v2",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.tui_app_server",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.ultrafast_mode",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unavailable_dummy_tools",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unbounded_connection_retries",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.undo",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unified_exec",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unified_exec_tty",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unified_exec_zsh_fork",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.unified_image_budget",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.use_agent_identity",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.use_legacy_landlock",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.use_linux_sandbox_bwrap",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.use_xaa",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.view_image",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.wake_on_agent_messages",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.web_search",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.web_search_cached",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.web_search_request",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.windows_sandbox_service",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.workspace_dependencies",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.workspace_owner_usage_nudge",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.worktrees",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"features.write_stdin_approval",group:"Features",description:"Centralized feature flags (new). Prefer this over individual toggles.",scope:"any",type:"Boolean"},{key:"tui.agents_overview_grouping",group:"TUI",description:"Last selected grouping in Agent Command Center.",scope:"any",type:"String",options:["project","status","model"]},{key:"tui.alternate_screen",group:"TUI",description:"Controls whether the TUI uses the terminal's alternate screen buffer. - auto (default): Use alternate screen. - always: Always use alternate screen. - never: Never use alternate screen (inline mode only, preserves scrollback).",scope:"any",type:"String",options:["auto","always","never"]},{key:"tui.animations",group:"TUI",default:"true",description:"Enable animations (welcome screen, shimmer effects, spinners). Defaults to true.",scope:"any",type:"Boolean"},{key:"tui.auto_recap",group:"TUI",default:"true",description:"Generate automatic conversation recaps when the terminal is unfocused. Defaults to true. Disabling this leaves /recap available on demand.",scope:"any",type:"Boolean"},{key:"tui.copy_on_select",group:"TUI",description:"Copy selected transcript, footer, or composer text when the mouse button is released. Defaults to auto: enabled except in direct terminals known to forward their native copy shortcut (Ghostty 1.2+, Kitty on macOS, Windows Terminal, and VS Code on Windows). Unknown terminals, Ghostty without a recognized version\u2026",scope:"any",type:"String",options:["auto","always","never"]},{key:"tui.copy_on_select_clear_selection",group:"TUI",default:"false",description:"Deselect read-only transcript or footer text after Copy on select confirms delivery. Editable composer selections remain visible. Defaults to false and has no effect when Copy on select is off.",scope:"any",type:"Boolean"},{key:"tui.disable_paste_burst",group:"TUI",description:"When true, disables burst-paste detection for typed input entirely. All characters are inserted as they are received, and no buffering or placeholder replacement will occur for fast keypress bursts. Overrides the legacy top-level disable_paste_burst setting. Defaults to false.",scope:"any",type:"Boolean"},{key:"tui.effects.effort",group:"TUI",default:"true",description:"Animate reasoning-effort changes in the composer and footer.",scope:"any",type:"Boolean"},{key:"tui.effects.progress",group:"TUI",default:"true",description:"Animate activity bullets and loading spinners.",scope:"any",type:"Boolean"},{key:"tui.effects.shimmer",group:"TUI",default:"true",description:"Shimmer status and loading text.",scope:"any",type:"Boolean"},{key:"tui.effects.starfield",group:"TUI",default:"true",description:"Animate the composer starfield.",scope:"any",type:"Boolean"},{key:"tui.effects.title",group:"TUI",default:"true",description:"Blink the terminal-title indicator when user action is required.",scope:"any",type:"Boolean"},{key:"tui.effects.welcome",group:"TUI",default:"true",description:"Animate the welcome artwork.",scope:"any",type:"Boolean"},{key:"tui.fullscreen_transcript",group:"TUI",default:"true",description:"Own the fullscreen transcript, including scrolling, selection, and search. Defaults to true; alternate-screen restrictions take precedence.",scope:"any",type:"Boolean"},{key:"tui.keymap",group:"TUI",description:"Keybinding overrides for the TUI. This supports rebinding selected actions globally and by context. Context bindings take precedence over global bindings.",scope:"any",type:"Object"},{key:"tui.model_availability_nux",group:"TUI",description:"Startup tooltip availability NUX state persisted by the TUI.",scope:"any",type:"Object",shape:"map",valueType:"Integer"},{key:"tui.mouse_scroll_speed",group:"TUI",description:"Mouse wheel speed multiplier for transcript scrolling, based on one row per event. Defaults to 1.0. Positive fractional values slow scrolling; values above 1.0 speed it up.",scope:"any",type:"Number"},{key:"tui.notification_condition",group:"TUI",description:"Controls whether TUI notifications are delivered only when the terminal is unfocused or regardless of focus. Defaults to unfocused.",scope:"any",type:"String",options:["unfocused","always"]},{key:"tui.notification_method",group:"TUI",description:"Notification method to use for terminal notifications. Defaults to auto.",scope:"any",type:"String",options:["auto","osc9","bel"]},{key:"tui.notifications",group:"TUI",description:"Enable desktop notifications from the TUI. Defaults to true.",scope:"any",type:"Boolean"},{key:"tui.pet",group:"TUI",description:"Pet id to preselect in the terminal pet picker. Custom pet ids resolve against CODEX_HOME/pets/<pet-id>/pet.json.",scope:"any",type:"String"},{key:"tui.pet_anchor",group:"TUI",description:"Where the terminal pet should anchor vertically. Defaults to composer, which follows the current TUI composer viewport.",scope:"any",type:"String",options:["composer","screen-bottom"]},{key:"tui.presets",group:"TUI",description:"Saved inputs keyed by a single digit (0 through 9).",scope:"any",type:"Object",shape:"map",fields:[{name:"input",type:"String",description:"Plain-text input, limited to 8,000 UTF-8 bytes."},{name:"label",type:"String",description:"Optional short name for the picker and shortcut hints."}]},{key:"tui.question_esc_back",group:"TUI",default:"true",description:"Escape returns from async questions to the composer, preserving the answer draft.",scope:"any",type:"Boolean"},{key:"tui.raw_output_mode",group:"TUI",default:"false",description:"Start the TUI in raw scrollback mode for copy-friendly transcript output. Defaults to false.",scope:"any",type:"Boolean"},{key:"tui.rendering.lists",group:"TUI",default:"true",description:"Render Markdown bullets and task-list markers as Unicode symbols.",scope:"any",type:"Boolean"},{key:"tui.rendering.math",group:"TUI",default:"true",description:"Render math expressions using Unicode notation.",scope:"any",type:"Boolean"},{key:"tui.rendering.mermaid",group:"TUI",default:"true",description:"Render Mermaid code blocks as diagrams.",scope:"any",type:"Boolean"},{key:"tui.rendering.tables",group:"TUI",default:"true",description:"Render pipe tables, including tables inside Markdown fences.",scope:"any",type:"Boolean"},{key:"tui.resume_cwd",group:"TUI",description:"Working directory to use when resuming or forking a session. When unset, prompt if the current and session directories differ.",scope:"any",type:"String",options:["current","session"]},{key:"tui.right_click_paste",group:"TUI",description:"Right-click text paste fallback. Defaults to auto (Windows/WSL/Linux). on also enables macOS; neither mode reads over SSH or in recognized VS Code terminals. This controls the fullscreen fallback, not the terminal's own paste binding.",scope:"any",type:"String",options:["auto","on","off"]},{key:"tui.screen_reader_detection_done",group:"TUI",description:"Records the one-time screen-reader detection attempt. Either value skips detection.",scope:"any",type:"Boolean"},{key:"tui.session_picker_view",group:"TUI",description:"Preferred layout for resume/fork session picker results.",scope:"any",type:"String",options:["comfortable","dense"]},{key:"tui.show_server_version_notice",group:"TUI",default:"true",description:"Show informational notices about connected app server version differences. Defaults to true; this does not control compatibility errors or version status.",scope:"any",type:"Boolean"},{key:"tui.show_tooltips",group:"TUI",default:"true",description:"Show startup tooltips in the TUI welcome screen. Defaults to true.",scope:"any",type:"Boolean"},{key:"tui.status_line",group:"TUI",description:"Ordered list of status line item identifiers. When set, the TUI renders the selected items as the status line. When unset, the TUI defaults to: model-with-reasoning, current-dir, and thread-name.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"tui.status_line_use_colors",group:"TUI",default:"true",description:"Color status line items with colors derived from the active syntax theme. Defaults to true.",scope:"any",type:"Boolean"},{key:"tui.terminal_resize_reflow_max_rows",group:"TUI",description:"Trim terminal resize-reflow replay to the most recent rendered terminal rows when the transcript exceeds this cap. Omit to use Codex's terminal-specific default. Set to 0 to keep all rendered rows.",scope:"any",type:"Integer"},{key:"tui.terminal_title",group:"TUI",description:"Ordered list of terminal title item identifiers. When set, the TUI renders the selected items into the terminal window/tab title. When unset, the TUI defaults to: activity, thread-name, and project-name. The activity item spins while working and shows an action-required message when blocked on the user.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"tui.theme",group:"TUI",description:"Syntax highlighting theme name (kebab-case). When set, overrides automatic light/dark theme detection. Use /theme in the TUI or see $CODEX_HOME/themes for custom themes.",scope:"any",type:"String"},{key:"tui.vim_mode_default",group:"TUI",default:"false",description:"Start the composer in Vim mode (Normal) by default. Defaults to false.",scope:"any",type:"Boolean"},{key:"allow_login_shell",group:"Shell & execution",description:"Whether the model may request a login shell for shell-based tools. Default to true If true, the model may request a login shell (login = true), and omitting login defaults to using a login shell. If false, the model can never use a login shell: login = true requests are rejected\u2026",scope:"any",type:"Boolean"},{key:"background_terminal_max_timeout",group:"Shell & execution",description:"Maximum poll window for background terminal output (write_stdin), in milliseconds. Default: 300000 (5 minutes).",scope:"any",type:"Integer"},{key:"experimental_use_unified_exec_tool",group:"Shell & execution",description:"",scope:"any",type:"Boolean"},{key:"shell_environment_policy.exclude",group:"Shell & execution",description:"Legacy list of regular expressions to exclude.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"shell_environment_policy.experimental_use_profile",group:"Shell & execution",description:"Policy for building the env when spawning a process via shell-like tools.",scope:"any",type:"Boolean"},{key:"shell_environment_policy.filters",group:"Shell & execution",description:"Pattern actions used by the canonical table representation. Ordinary config keeps accepting the legacy arrays above during the migration. Requirements will accept only this keyed form, keeping array compatibility isolated so the legacy fields can be deprecated later\u2026",scope:"any",type:"Object",shape:"map",valueType:"String",valueOptions:["include","exclude"]},{key:"shell_environment_policy.ignore_default_excludes",group:"Shell & execution",description:"Policy for building the env when spawning a process via shell-like tools.",scope:"any",type:"Boolean"},{key:"shell_environment_policy.include_only",group:"Shell & execution",description:"Legacy list of regular expressions to include.",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"shell_environment_policy.inherit",group:"Shell & execution",description:"Policy for building the env when spawning a process via shell-like tools.",scope:"any",type:"String",options:["core","all","none"]},{key:"shell_environment_policy.set",group:"Shell & execution",description:"Policy for building the env when spawning a process via shell-like tools.",scope:"any",type:"Object",shape:"map",valueType:"String"},{key:"browser_use.allow_history_access",group:"Tools",description:"",scope:"any",type:"Boolean"},{key:"browser_use.default_origin_policy.access",group:"Tools",description:"",scope:"any",type:"String",options:["allow","deny"]},{key:"browser_use.default_origin_policy.downloads",group:"Tools",description:"",scope:"any",type:"String",options:["allow","deny"]},{key:"browser_use.default_origin_policy.full_cdp_access",group:"Tools",description:"",scope:"any",type:"String",options:["allow","deny"]},{key:"browser_use.default_origin_policy.uploads",group:"Tools",description:"",scope:"any",type:"String",options:["allow","deny"]},{key:"browser_use.origins",group:"Tools",description:"",scope:"any",type:"Object",shape:"map",fields:[{name:"access",type:"String",options:["allow","deny"]},{name:"downloads",type:"String",options:["allow","deny"]},{name:"full_cdp_access",type:"String",options:["allow","deny"]},{name:"uploads",type:"String",options:["allow","deny"]}]},{key:"computer_use.default_app_access",group:"Tools",description:"",scope:"any",type:"String",options:["allow","deny"]},{key:"computer_use.macos.bundle_ids",group:"Tools",description:"",scope:"any",type:"Object",shape:"map",valueType:"String",valueOptions:["allow","deny"]},{key:"computer_use.windows.aumids",group:"Tools",description:"",scope:"any",type:"Object",shape:"map",valueType:"String",valueOptions:["allow","deny"]},{key:"computer_use.windows.exes",group:"Tools",description:"",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"access",type:"String",options:["allow","deny"]},{name:"binary_name",type:"String"},{name:"product_name",type:"String"},{name:"publisher_name",type:"String"}]},{key:"tool_output_token_limit",group:"Tools",description:"Token budget applied when storing tool/function outputs in the context manager.",scope:"any",type:"Integer"},{key:"tool_suggest.disabled_tools",group:"Tools",description:"Additional discoverable tools that can be suggested for installation.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"id",type:"String"},{name:"type",type:"String",options:["connector","plugin"]}]},{key:"tool_suggest.discoverables",group:"Tools",description:"Additional discoverable tools that can be suggested for installation.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"id",type:"String"},{name:"type",type:"String",options:["connector","plugin"]}]},{key:"tools.experimental_request_user_input.enabled",group:"Tools",default:"true",description:"Nested tools section for feature toggles",scope:"any",type:"Boolean"},{key:"tools.update_plan.enabled",group:"Tools",default:"false",description:"Nested tools section for feature toggles",scope:"any",type:"Boolean"},{key:"tools.web_search.allowed_domains",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"Array of String",shape:"array",valueType:"String"},{key:"tools.web_search.context_size",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"String",options:["low","medium","high"]},{key:"tools.web_search.location.city",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"String"},{key:"tools.web_search.location.country",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"String"},{key:"tools.web_search.location.region",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"String"},{key:"tools.web_search.location.timezone",group:"Tools",description:"Nested tools section for feature toggles",scope:"any",type:"String"},{key:"web_search",group:"Tools",description:"Controls the web search tool mode: disabled, cached, indexed, or live.",scope:"any",type:"String",options:["disabled","cached","indexed","live"]},{key:"agents",group:"Agents & automation",description:"Agent-related settings (thread limits, etc.).",scope:"any",type:"Object",shape:"map",fields:[{name:"config_file",type:"String",description:"Path to a role-specific config layer. Relative paths are resolved relative to the config.toml that defines them."},{name:"description",type:"String",description:"Human-facing role documentation used in spawn tool guidance. Required unless supplied by the referenced agent role file."},{name:"nickname_candidates",type:"Array of String",description:"Candidate nicknames for agents spawned with this role."}]},{key:"agents.default_subagent_model",group:"Agents & automation",description:"Default model for spawned subagents when the spawn call does not select one.",scope:"any",type:"String"},{key:"agents.default_subagent_reasoning_effort",group:"Agents & automation",description:"Default reasoning effort for spawned subagents when the spawn call does not select one.",scope:"any",type:"String"},{key:"agents.enabled",group:"Agents & automation",description:"Whether multi-agent tools are enabled. Defaults to true. An enabled features.multi_agent_v2 setting takes precedence.",scope:"any",type:"Boolean"},{key:"agents.interrupt_message",group:"Agents & automation",description:"Whether to record a model-visible message when an agent turn is interrupted. Defaults to true.",scope:"any",type:"Boolean"},{key:"agents.max_concurrent_threads_per_session",group:"Agents & automation",description:"Maximum number of spawned agent threads that can be open concurrently per session. When unset, the selected multi-agent backend uses its default.",scope:"any",type:"Integer"},{key:"agents.max_depth",group:"Agents & automation",description:"Maximum nesting depth for V1 agent threads. Ignored by V2.",scope:"any",type:"Integer"},{key:"auto_review.circuit_break_action",group:"Agents & automation",description:"Controls whether circuit-breaker interruptions include a structured error. Strict mode writes structured errors that older clients may not recognize when reading shared history. Defaults to default.",scope:"any",type:"String",options:["default","strict"]},{key:"auto_review.conversation_history_max_output_tokens",group:"Agents & automation",description:"Maximum estimated tokens per Guardian history-tool response, before the standard serialization allowance. Defaults to 4,000; stricter parent tool limits still apply.",scope:"any",type:"Integer"},{key:"auto_review.experimental_conversation_history_prompt",group:"Agents & automation",description:"Experimental replacement for the history-retrieval instructions when history tools and Apps are enabled. Omitted or blank values use the built-in prompt.",scope:"any",type:"String"},{key:"auto_review.experimental_policy_template",group:"Agents & automation",description:"Experimental full Guardian prompt template containing the tenant policy placeholder.",scope:"any",type:"String"},{key:"auto_review.extra_policy",group:"Agents & automation",description:"Additional policy text inserted into the Guardian template's {{ extra_policy }} slot.",scope:"any",type:"String"},{key:"auto_review.policy",group:"Agents & automation",description:"Additional policy instructions inserted into the guardian prompt.",scope:"any",type:"String"},{key:"goals.max_goal_token_budget",group:"Agents & automation",description:"Maximum token budget allowed for a goal and default budget for new goals.",scope:"any",type:"Integer"},{key:"memories.consolidation_model",group:"Agents & automation",description:"Model used for memory consolidation.",scope:"any",type:"String"},{key:"memories.dedicated_tools",group:"Agents & automation",description:"When true, expose dedicated memory tools through the extension tool surface.",scope:"any",type:"Boolean"},{key:"memories.disable_on_external_context",group:"Agents & automation",description:'When true, external context sources mark the thread memory_mode as "polluted".',scope:"any",type:"Boolean"},{key:"memories.dual_write",group:"Agents & automation",description:"Generate both versions while v1 is selected; v2 runs alone after cutover.",scope:"any",type:"Boolean"},{key:"memories.extract_model",group:"Agents & automation",description:"Model used for thread summarisation.",scope:"any",type:"String"},{key:"memories.generate_memories",group:"Agents & automation",description:'When false, newly created threads are stored with memory_mode = "disabled" in the state DB.',scope:"any",type:"Boolean"},{key:"memories.max_raw_memories_for_consolidation",group:"Agents & automation",description:"Maximum number of recent raw memories retained for global consolidation.",scope:"any",type:"Integer"},{key:"memories.max_rollout_age_days",group:"Agents & automation",description:"Maximum age of the threads used for memories.",scope:"any",type:"Integer"},{key:"memories.max_rollouts_per_startup",group:"Agents & automation",description:"Maximum number of rollout candidates processed per pass.",scope:"any",type:"Integer"},{key:"memories.max_unused_days",group:"Agents & automation",description:"Maximum number of days since a memory was last used before it becomes ineligible for phase 2 selection.",scope:"any",type:"Integer"},{key:"memories.min_rate_limit_remaining_percent",group:"Agents & automation",description:"Minimum remaining percentage required in Codex rate-limit windows before memory startup runs.",scope:"any",type:"Integer"},{key:"memories.min_rollout_idle_hours",group:"Agents & automation",description:"Minimum idle time between last thread activity and memory creation (hours). > 12h recommended.",scope:"any",type:"Integer"},{key:"memories.use_memories",group:"Agents & automation",description:"When false, skip injecting memory usage instructions into developer prompts.",scope:"any",type:"Boolean"},{key:"memories.version",group:"Agents & automation",description:"Selects the memory pipeline; v1 remains the default.",scope:"any",type:"String",options:["v1","v2"]},{key:"orchestrator.mcp.enabled",group:"Agents & automation",description:"Optional enablement of a configured feature.",scope:"any",type:"Boolean"},{key:"orchestrator.skills.enabled",group:"Agents & automation",description:"Legacy no-op setting retained for compatibility. Use cloud.skills to configure cloud skills.",scope:"any",type:"Boolean"},{key:"skills.bundled.enabled",group:"Skills & memories",default:"true",description:"User-level skill config entries keyed by SKILL.md path.",scope:"any",type:"Boolean"},{key:"skills.config",group:"Skills & memories",description:"User-level skill config entries keyed by SKILL.md path.",scope:"any",type:"Array of Object",shape:"array",fields:[{name:"enabled",type:"Boolean"},{name:"name",type:"String",description:"Name-based selector."},{name:"path",type:"String",description:"Path-based selector."}]},{key:"skills.include_instructions",group:"Skills & memories",description:"Whether turns receive the automatic skills instructions block.",scope:"any",type:"Boolean"},{key:"skills.max_context_tokens",group:"Skills & memories",description:"Maximum tokens used by the available-skills catalog. Defaults to 2% of the model context window and is capped at 10,000 tokens when set.",scope:"any",type:"Integer"},{key:"apps",group:"Apps & integrations",description:"Settings for app-specific controls.",scope:"any",type:"Object",shape:"map",fields:[{name:"approvals_reviewer",type:"String",options:["user","auto_review","guardian_subagent"],description:"Reviewer for approval prompts from this app, overriding the thread default."},{name:"default_tools_approval_mode",type:"String",options:["auto","prompt","writes","approve"],description:"Approval mode for tools in this app unless a tool override exists."},{name:"default_tools_enabled",type:"Boolean",description:"Whether tools are enabled by default for this app."},{name:"destructive_enabled",type:"Boolean",description:"Whether tools with destructive_hint = true are allowed for this app."},{name:"enabled",type:"Boolean",description:"When false, Codex does not surface this app."},{name:"links",type:"Object",description:"Per-account approval settings keyed by link ID."},{name:"omit_tools_from",type:"Array of String",description:"Model-facing surfaces from which this connector's tools must be omitted, in addition to any server-level omissions. None leaves lower-priority configuration unchanged; an empty list clears connector-level omissions."},{name:"open_world_enabled",type:"Boolean",description:"Whether tools with open_world_hint = true are allowed for this app."},{name:"tools",type:"Object",description:"Per-tool settings for this app."}]},{key:"apps._default.approvals_reviewer",group:"Apps & integrations",description:"Reviewer for approval prompts unless overridden by per-app settings.",scope:"any",type:"String",options:["user","auto_review","guardian_subagent"]},{key:"apps._default.default_tools_approval_mode",group:"Apps & integrations",description:"Approval mode for tools unless overridden by per-app or per-tool settings.",scope:"any",type:"String",options:["auto","prompt","writes","approve"]},{key:"apps._default.destructive_enabled",group:"Apps & integrations",description:"Whether tools with destructive_hint = true are allowed by default.",scope:"any",type:"Boolean"},{key:"apps._default.enabled",group:"Apps & integrations",default:"true",description:"When false, apps are disabled unless overridden by per-app settings.",scope:"any",type:"Boolean"},{key:"apps._default.open_world_enabled",group:"Apps & integrations",description:"Whether tools with open_world_hint = true are allowed by default.",scope:"any",type:"Boolean"},{key:"audio.microphone",group:"Apps & integrations",description:"Machine-local realtime audio device preferences used by realtime voice.",scope:"any",type:"String"},{key:"audio.microphone_channel",group:"Apps & integrations",description:"One-based microphone channels to mix; unset mixes all input channels.",scope:"any",type:"Integer"},{key:"audio.speaker",group:"Apps & integrations",description:"Machine-local realtime audio device preferences used by realtime voice.",scope:"any",type:"String"},{key:"daybreak",group:"Apps & integrations",description:"Default Daybreak preference for new threads and non-interactive turns.",scope:"any",type:"Boolean"},{key:"desktop",group:"Apps & integrations",description:"Opaque desktop settings stored alongside the rest of config.toml.",scope:"any",type:"Object"},{key:"ghost_snapshot.disable_warnings",group:"Apps & integrations",description:"Legacy no-op setting retained for compatibility.",scope:"any",type:"Boolean"},{key:"ghost_snapshot.ignore_large_untracked_dirs",group:"Apps & integrations",description:"Legacy no-op setting retained for compatibility.",scope:"any",type:"Integer"},{key:"ghost_snapshot.ignore_large_untracked_files",group:"Apps & integrations",description:"Legacy no-op setting retained for compatibility.",scope:"any",type:"Integer"},{key:"realtime.transport",group:"Apps & integrations",description:"Experimental / do not use. Realtime websocket session selection. version controls v1/v2 and type controls conversational/transcription.",scope:"any",type:"String",options:["webrtc","websocket"]},{key:"realtime.type",group:"Apps & integrations",description:"Experimental / do not use. Realtime websocket session selection. version controls v1/v2 and type controls conversational/transcription.",scope:"any",type:"String",options:["conversational","transcription"]},{key:"realtime.version",group:"Apps & integrations",description:"Experimental / do not use. Realtime websocket session selection. version controls v1/v2 and type controls conversational/transcription.",scope:"any",type:"String",options:["v1","v2","v3"]},{key:"realtime.voice",group:"Apps & integrations",description:"Experimental / do not use. Realtime websocket session selection. version controls v1/v2 and type controls conversational/transcription.",scope:"any",type:"String",options:["alloy","arbor","ash","aube","ballad","breeze","bubbie","cedar","coral","cove","echo","ember","haetsal","hanul","himari","juniper","leher","maple","marin","miko","neer","porto","rindo","rio","rivage","sage","selva","shimmer","sol","sonna","spruce","tinta","vale","verse","viola"]},{key:"chatgpt_base_url",group:"Auth & network",description:"Base URL for requests to ChatGPT (as opposed to the OpenAI API).",scope:"user",type:"String"},{key:"cli_auth_credentials_store",group:"Auth & network",description:"Preferred backend for storing CLI auth credentials. file (default): Use a file in the Codex home directory. keyring: Use an OS-specific keyring service. auto: Use the keyring if available, otherwise use a file.",scope:"any",type:"String",options:["file","keyring","auto","ephemeral"]},{key:"forced_chatgpt_workspace_id",group:"Auth & network",description:"When set, restricts ChatGPT login to one or more workspace identifiers.",scope:"any",type:"String"},{key:"forced_login_method",group:"Auth & network",description:"When set, restricts the login mechanism users may use.",scope:"any",type:"String",options:["chatgpt","api"]},{key:"openai_base_url",group:"Auth & network",description:"Base URL override for the built-in openai model provider.",scope:"user",type:"String"},{key:"analytics.enabled",group:"Updates & telemetry",description:'When false, disables OpenAI analytics across Codex product surfaces in this profile. Custom OTLP metrics exporters remain enabled; set otel.metrics_exporter = "none" to disable them.',scope:"any",type:"Boolean"},{key:"check_for_update_on_startup",group:"Updates & telemetry",description:"When true, checks for Codex updates on startup and surfaces update prompts. Set to false only if your Codex updates are centrally managed. Defaults to true.",scope:"any",type:"Boolean"},{key:"cloud.skills.enabled",group:"Updates & telemetry",description:"Cloud skills are permitted by default; the host must supply a cloud provider.",scope:"any",type:"Boolean"},{key:"feedback.enabled",group:"Updates & telemetry",description:"When false, disables the feedback flow across Codex product surfaces.",scope:"any",type:"Boolean"},{key:"allow_symlinked_codex_home",group:"General",description:"Allow macOS sandbox writable roots at or beneath CODEX_HOME to traverse symlinks. Read only from the host's user config at startup; defaults to false. This grants no write access by itself, but trusts symlink targets even if they change between commands or lie outside CODEX_HOME\u2026",scope:"any",type:"Boolean"},{key:"apps_mcp_product_sku",group:"General",description:"Optional product SKU forwarded on host-owned Codex Apps MCP requests.",scope:"user",type:"String"},{key:"compact_prompt",group:"General",description:"Compact prompt used for history compaction.",scope:"any",type:"String"},{key:"developer_instructions",group:"General",description:"Developer instructions inserted as a developer role message.",scope:"any",type:"String"},{key:"disable_paste_burst",group:"General",description:"Legacy fallback for tui.disable_paste_burst. Prefer the setting under [tui].",scope:"any",type:"Boolean"},{key:"experimental_compact_prompt_file",group:"General",description:"A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem). IMPORTANT: When deserializing an AbsolutePathBuf, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set\u2026",scope:"any",type:"String"},{key:"experimental_realtime_start_instructions",group:"General",description:"Experimental / do not use. Replaces the built-in realtime start instructions inserted into developer messages when realtime becomes active.",scope:"any",type:"String"},{key:"experimental_realtime_webrtc_call_base_url",group:"General",description:"Experimental / do not use. Overrides only the WebRTC realtime call creation base URL. This is separate from experimental_realtime_ws_base_url because WebRTC call creation is HTTP, while sideband control is websocket.",scope:"user",type:"String"},{key:"experimental_realtime_ws_backend_prompt",group:"General",description:"Experimental / do not use. Overrides only the realtime conversation websocket transport instructions (the Op::RealtimeConversation /ws session.update instructions) without changing normal prompts.",scope:"any",type:"String"},{key:"experimental_realtime_ws_base_url",group:"General",description:"Experimental / do not use. Overrides only the realtime conversation websocket transport base URL (the Op::RealtimeConversation /v1/realtime connection) without changing normal provider HTTP requests.",scope:"user",type:"String"},{key:"experimental_realtime_ws_model",group:"General",description:"Experimental / do not use. Selects the realtime websocket model/snapshot used for the Op::RealtimeConversation connection.",scope:"any",type:"String"},{key:"experimental_realtime_ws_startup_context",group:"General",description:"Experimental / do not use. Replaces the synthesized realtime startup context appended to websocket session instructions. An empty string disables startup context injection entirely.",scope:"any",type:"String"},{key:"experimental_thread_store",group:"General",description:"Experimental / do not use. Selects the thread store implementation.",scope:"any",type:"Object"},{key:"file_opener",group:"General",description:"Optional URI-based file opener. If set, citations to files in the model output will be hyperlinked using the specified URI scheme.",scope:"any",type:"String",options:["vscode","vscode-insiders","windsurf","cursor","none"]},{key:"hide_agent_reasoning",group:"General",default:"false",description:"When set to true, AgentReasoning events will be hidden from the UI/output. Defaults to false.",scope:"any",type:"Boolean"},{key:"history.max_bytes",group:"General",description:"If set, the maximum size of the history file in bytes. The oldest entries are dropped once the file exceeds this limit.",scope:"any",type:"Integer"},{key:"history.persistence",group:"General",description:"If true, history entries will not be written to disk.",scope:"any",type:"String",options:["save-all","none"]},{key:"include_apps_instructions",group:"General",description:"Whether to inject the <apps_instructions> developer block.",scope:"any",type:"Boolean"},{key:"include_collaboration_mode_instructions",group:"General",description:"Whether to inject the <collaboration_mode> developer block.",scope:"any",type:"Boolean"},{key:"include_environment_context",group:"General",description:"Whether to inject the <environment_context> user block.",scope:"any",type:"Boolean"},{key:"include_environment_context_time",group:"General",description:"Whether environment context includes the current date and timezone.",scope:"any",type:"Boolean"},{key:"include_permissions_instructions",group:"General",description:"Whether to inject the <permissions instructions> developer block.",scope:"any",type:"Boolean"},{key:"instructions",group:"General",description:"System instructions.",scope:"any",type:"String"},{key:"log_dir",group:"General",description:"Directory where Codex writes log files. Setting this value explicitly also enables the TUI text log in this directory. Defaults to $CODEX_HOME/log.",scope:"any",type:"String"},{key:"notice",group:"General",description:"Collection of in-product notices (different from notifications) See [crate::types::Notice] for more details",scope:"any",type:"Object"},{key:"notify",group:"General",description:"Optional external command to spawn for end-user notifications.",scope:"user",type:"Array of String",shape:"array",valueType:"String"},{key:"otel.environment",group:"General",description:"Mark traces with environment (dev, staging, prod, test). Defaults to dev.",scope:"user",type:"String"},{key:"otel.exporter",group:"General",description:"Optional log exporter",scope:"user",type:"String",options:["none","statsig"]},{key:"otel.log_agent_responses",group:"General",description:"Opt in to logging final main-agent and spawned-subagent responses to an OTLP log exporter. Defaults to false. Response text can be sensitive and is capped at 64 KiB.",scope:"user",type:"Boolean"},{key:"otel.log_guardian_assessments",group:"General",description:"Opt in to logging completed Guardian assessments to an OTLP log exporter. Defaults to false. Rationales can be sensitive and are capped at 64 KiB.",scope:"user",type:"Boolean"},{key:"otel.log_user_prompt",group:"General",description:"Log user prompt in traces",scope:"user",type:"Boolean"},{key:"otel.metrics_exporter",group:"General",description:"Metrics exporter. Defaults to statsig, which follows analytics.enabled. Custom OTLP exporters are independent of analytics.enabled; none disables metrics export.",scope:"user",type:"String",options:["none","statsig"]},{key:"otel.span_attributes",group:"General",description:"Attributes to add to every exported trace span.",scope:"user",type:"Object",shape:"map",valueType:"String"},{key:"otel.tool_result.max_bytes",group:"General",default:"2048",description:"Maximum UTF-8 bytes before the truncation notice. Defaults to 2048.",scope:"user",type:"Integer"},{key:"otel.trace_exporter",group:"General",description:"Optional trace exporter",scope:"user",type:"String",options:["none","statsig"]},{key:"otel.tracestate",group:"General",description:"Semicolon-separated key:value fields to upsert into W3C tracestate members.",scope:"user",type:"Object",shape:"map",valueType:"Object"},{key:"personality",group:"General",description:"Deprecated: friendly and pragmatic no longer select a style.",scope:"any",type:"String",options:["none","friendly","pragmatic"]},{key:"responses_api_metadata",group:"General",description:"Bounded, product-owned metadata attached to every Responses API request.",scope:"user",type:"Object",shape:"map",valueType:"String"},{key:"show_raw_agent_reasoning",group:"General",description:"When set to true, AgentReasoningRawContentEvent events will be shown in the UI/output. Defaults to false.",scope:"any",type:"Boolean"},{key:"sqlite_home",group:"General",description:"Directory where Codex stores the SQLite state DB. Defaults to $CODEX_SQLITE_HOME when set. Otherwise uses $CODEX_HOME.",scope:"any",type:"String"},{key:"suppress_unstable_features_warning",group:"General",description:"Suppress warnings about unstable (under development) features.",scope:"any",type:"Boolean"},{key:"thread_unload_delay_secs",group:"General",description:"Seconds a thread must have no subscribers and no activity before app-server unloads it. Defaults to 1800 (30 minutes); zero unloads immediately. Resolved when each thread is loaded; request config overrides apply per thread.",scope:"any",type:"Integer"},{key:"windows.allow_mxc",group:"General",description:"False blocks both explicit MXC configuration and automatic selection.",scope:"any",type:"Boolean"},{key:"windows.sandbox",group:"General",description:"Windows-specific configuration.",scope:"any",type:"String",options:["elevated","unelevated","mxc"]}];

package/node_modules/@weavecode/harness/dist/codex/config.d.ts

@@ -0,0 +1,2 @@
+import type { ConfigSurface } from '../driver.js';
+export declare const CODEX_CONFIG: ConfigSurface;

package/node_modules/@weavecode/harness/dist/codex/config.js

@@ -0,0 +1,3 @@
+import f from"node:fs/promises";import p from"node:path";import{parse as m}from"smol-toml";import{CODEX_CONFIG_GROUPS as _,CODEX_CONFIG_KEYS as y}from"./config-catalog.generated.js";import{codexHome as $}from"./home.js";import{CodexTomlCorruptError as w}from"./toml.js";const b=[{id:"user",profiles:!0},{id:"project",profiles:!1}];function d(r,t){switch(r){case"user":return p.join($(t.homedir),"config.toml");case"project":return p.join(t.projectPath??"",".codex","config.toml");default:return""}}function j(r){return r==="project"?y.filter(t=>t.scope!=="user"):y}function F(r){return new Set(j(r).map(t=>t.key.split(".")[0]))}function l(r){return typeof r=="object"&&r!==null&&!Array.isArray(r)}function C(r){const t=[],e=r.mcp_servers;return l(e)&&"weave"in e&&t.push("mcp_servers.weave"),t}async function A(r){const t=r.values.model_catalog_json;if(typeof t!="string"||!t.trim())return{models:[],baseUrl:"",credential:"none"};let e;try{e=await f.readFile(t,"utf-8")}catch{throw new Error(`model_catalog_json \u6307\u5411\u7684\u6587\u4EF6\u8BFB\u4E0D\u5230\uFF1A${t}`)}let o;try{o=JSON.parse(e)}catch{throw new Error(`model_catalog_json \u4E0D\u662F\u5408\u6CD5 JSON\uFF1A${t}`)}const i=l(o)?o.models:null;if(!Array.isArray(i))throw new Error("model catalog \u7F3A models \u6570\u7EC4");const u=[];for(const n of i)!l(n)||typeof n.slug!="string"||u.push({id:n.slug,...typeof n.display_name=="string"?{name:n.display_name}:{},...typeof n.description=="string"?{createdAt:n.description}:{}});return{models:u,baseUrl:"",credential:"none"}}export const CODEX_CONFIG={harness:"codex",files(r){return b.map(t=>({id:t.id,profiles:t.profiles,path:e=>d(t.id,e)}))},catalog(r){const t=j(r);return{groups:_.filter(e=>t.some(o=>o.group===e)),keys:t,envVars:[]}},async read(r,t){const e=d(r,t);let o;try{o=await f.readFile(e,"utf-8")}catch{return{}}let i;try{i=m(o)}catch(s){throw new w(`${e} is not valid TOML \u2014 refusing to read: ${s instanceof Error?s.message:String(s)}`)}if(!l(i))return{};const u=F(r),n={};for(const s of u)s in i&&(n[s]=i[s]);return n},async write(r,t,e){const o=d(r,t);let i="";try{i=await f.readFile(o,"utf-8")}catch{}let u;try{u=m(i)}catch(a){throw new w(`${o} is not valid TOML \u2014 refusing to write: ${a instanceof Error?a.message:String(a)}`)}const n=F(r),s={...u};for(const a of Object.keys(u))n.has(a)&&!(a in e)&&delete s[a];for(const[a,E]of Object.entries(e))n.has(a.split(".")[0])&&(s[a]=E);const c=O(s);await f.mkdir(p.dirname(o),{recursive:!0}),await f.writeFile(o,c,"utf-8")},managedKeys:C,managedEntries(){return[]},models:A,rawFormat:"toml",parseRaw(r){const t=m(r);if(!l(t))throw new Error("\u9876\u5C42\u5FC5\u987B\u662F\u8868");return t},serializeRaw(r){return O(r)}};function O(r){const t=[],e=(o,i)=>{const u=[],n=[];for(const[s,c]of Object.entries(i))l(c)&&!S(c)?n.push([s,c]):u.push(`${g(s)} = ${h(c)}`);o.length>0&&(u.length>0||n.length===0)&&(t.length>0&&t.push(""),t.push(`[${o.map(g).join(".")}]`)),t.push(...u);for(const[s,c]of n)e([...o,s],c)};return e([],r),t.length>0?`${t.join(`
+`)}
+`:""}function S(r){return Object.keys(r).length===0}function g(r){return/^[A-Za-z0-9_-]+$/.test(r)?r:JSON.stringify(r)}function h(r){return r==null?'""':typeof r=="boolean"?r?"true":"false":typeof r=="number"?Number.isFinite(r)?String(r):'""':typeof r=="string"?v(r):Array.isArray(r)?`[${r.map(h).join(", ")}]`:`{ ${Object.entries(r).filter(([,t])=>t!==void 0).map(([t,e])=>`${g(t)} = ${h(e)}`).join(", ")} }`}function v(r){const t=r.includes("\\"),e=!r.includes("'")&&!/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f\n]/.test(r);return t&&e?`'${r}'`:JSON.stringify(r)}