@open-mercato/cezar 0.9.1 → 0.9.2-pr772.1071

package/dist/config.d.ts

@@ -6,142 +6,47 @@ import { z } from 'zod';
  * can be overridden or emptied (`"skillsRepos": []` disables team skills).
  */
 declare const skillsRepoSchema: z.ZodObject<{
-    /** `owner/name` (GitHub shorthand), a full git URL, or a local/file:// path. */
     repo: z.ZodString;
     ref: z.ZodDefault<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    repo: string;
-    ref: string;
-}, {
-    repo: string;
-    ref?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type SkillsRepoSource = z.infer<typeof skillsRepoSchema>;
 export declare const DEFAULT_SKILLS_REPOS: SkillsRepoSource[];
 /** Last-resort retention when neither the repo nor the workspace says anything. */
 export declare const DEFAULT_WORKTREE_RETENTION = 10;
 declare const configSchema: z.ZodObject<{
     skillsRepos: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** `owner/name` (GitHub shorthand), a full git URL, or a local/file:// path. */
         repo: z.ZodString;
         ref: z.ZodDefault<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        repo: string;
-        ref: string;
-    }, {
-        repo: string;
-        ref?: string | undefined;
-    }>, "many">>;
-    /** How many tasks may run at once (spec 006). Non-git dirs always run 1. */
+    }, z.core.$strip>>>;
     maxParallel: z.ZodDefault<z.ZodNumber>;
-    /**
-     * Count-based worktree retention (#483): keep the last N *finished*
-     * worktrees materialized on disk; reclaim older ones (directory only — the
-     * `cez/<id8>` branch is kept, so the work stays recoverable). 0 = unlimited
-     * (never auto-reclaim). Default 10. `.catch(10)` keeps it additive-safe: a
-     * bad value degrades to the default instead of discarding the rest.
-     */
     worktreeRetention: z.ZodCatch<z.ZodDefault<z.ZodNumber>>;
-    /**
-     * Per-task memory ceiling in MiB (whole process tree). When a running task's
-     * RSS crosses this the engine pauses it with a warning and lets the queue
-     * advance (#memory-guard). 0 / unset = no limit. `.catch(undefined)` keeps
-     * the key additive-safe: a bad value degrades to "no limit".
-     */
     memoryLimitMb: z.ZodCatch<z.ZodOptional<z.ZodNumber>>;
-    /**
-     * Which agent backend a task uses unless overridden per task (GUI) or per
-     * step (workflow). The GUI only offers runners actually installed; this is
-     * the preselected default. Also the runner the chain planner uses.
-     */
-    defaultRunner: z.ZodDefault<z.ZodEnum<["claude", "codex", "opencode"]>>;
-    /** Model for the chain planner (spec 008) — cheap but reliable at JSON. */
+    defaultRunner: z.ZodDefault<z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        opencode: "opencode";
+    }>>;
     plannerModel: z.ZodDefault<z.ZodString>;
-    /** Model for the task namer (spec 2026-07-17-task-auto-naming) — the cheapest
-     *  alias that answers strict JSON; naming is fire-and-forget and never blocks. */
     namerModel: z.ZodDefault<z.ZodString>;
-    /** Live title updates: refresh the display title through the namer on each
-     *  turn end. Absent = the `CEZ_TITLE_UPDATES` env decides (default ON — owner
-     *  decision on PR #479). */
     liveTitleUpdates: z.ZodOptional<z.ZodBoolean>;
-    /** Optional diff-first review gate (#489): when a successful run with changes
-     *  should park at `review` for a human. Absent = the `CEZ_REVIEW_GATE` env
-     *  decides (default OFF — the deliberate inverse of `liveTitleUpdates`).
-     *  Autonomous runs always skip the gate regardless of this. */
     reviewGate: z.ZodOptional<z.ZodBoolean>;
-    /**
-     * Branch task worktrees fork from and draft PRs target (e.g. `develop`).
-     * Unset = the branch currently checked out. Settable from the Repo tab.
-     */
     baseBranch: z.ZodOptional<z.ZodString>;
-    /**
-     * Default extra system prompt applied to every run's agent steps (claude:
-     * `--append-system-prompt`; codex/opencode: prepended to the opening user
-     * message — the AgentRunSpec seam handles the per-backend delivery).
-     * Settings is the single edit place; `POST /api/runs` can override it per
-     * run (`systemPrompt`). `.catch(undefined)` keeps the key additive-safe: a
-     * bad value degrades to unset without discarding the rest of the config.
-     */
     systemPrompt: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    /**
-     * Per-runner default model preset (Settings → Agents, redesign R6 1.5): the
-     * model id the composer preselects for that runner. Missing = auto (the
-     * runner decides). A capability (`model`), never a vendor config format.
-     * `.catch(undefined)` keeps the key additive-safe like `systemPrompt`: a
-     * bad value degrades to unset without discarding the rest of the config.
-     */
     defaultModels: z.ZodCatch<z.ZodOptional<z.ZodObject<{
         claude: z.ZodOptional<z.ZodString>;
         codex: z.ZodOptional<z.ZodString>;
         opencode: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        claude?: string | undefined;
-        codex?: string | undefined;
-        opencode?: string | undefined;
-    }, {
-        claude?: string | undefined;
-        codex?: string | undefined;
-        opencode?: string | undefined;
-    }>>>;
-}, "strip", z.ZodTypeAny, {
-    skillsRepos: {
-        repo: string;
-        ref: string;
-    }[];
-    maxParallel: number;
-    worktreeRetention: number;
-    memoryLimitMb?: number | undefined;
-    defaultRunner: "claude" | "codex" | "opencode";
-    plannerModel: string;
-    namerModel: string;
-    liveTitleUpdates?: boolean | undefined;
-    reviewGate?: boolean | undefined;
-    baseBranch?: string | undefined;
-    systemPrompt?: string | undefined;
-    defaultModels?: {
-        claude?: string | undefined;
-        codex?: string | undefined;
-        opencode?: string | undefined;
-    } | undefined;
-}, {
-    skillsRepos?: {
-        repo: string;
-        ref?: string | undefined;
-    }[] | undefined;
-    maxParallel?: number | undefined;
-    worktreeRetention?: unknown;
-    memoryLimitMb?: unknown;
-    defaultRunner?: "claude" | "codex" | "opencode" | undefined;
-    plannerModel?: string | undefined;
-    namerModel?: string | undefined;
-    liveTitleUpdates?: boolean | undefined;
-    reviewGate?: boolean | undefined;
-    baseBranch?: string | undefined;
-    systemPrompt?: unknown;
-    defaultModels?: unknown;
-}>;
+    }, z.core.$strip>>>;
+    modelsLocked: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
 export type CezConfig = z.infer<typeof configSchema>;
-/** Read `.ai/cezar/config.json` on demand — never cached, never throws. */
+/**
+ * Read `.ai/cezar/config.json` on demand — never cached, never throws.
+ *
+ * Also reads the machine-wide defaults, which is one more small JSON read and deliberately not
+ * cached for the same reason this one is not: `~/.cezar/` is shared by every cezar process on the
+ * machine, so a snapshot is a staleness bug.
+ */
 export declare function loadConfig(repoRoot: string): Promise<CezConfig>;
 /**
  * The default skills repos that are *opt-in per skill* (the "import OM skills"

package/dist/config.js

@@ -90,25 +90,66 @@ const configSchema = z.object({
     })
         .optional()
         .catch(undefined),
+    /**
+     * Make each coding agent's native model setting authoritative. This is an
+     * optional repo-level counterpart to `CEZ_AGENT_MODELS_LOCKED=1`; absent or
+     * false preserves the ordinary per-runner model selector.
+     */
+    modelsLocked: z.boolean().optional().catch(undefined),
 });
-/** Read `.ai/cezar/config.json` on demand — never cached, never throws. */
+/**
+ * Fold the machine-wide agent defaults under a repo's own config (spec 2026-07-29-agent-profiles).
+ *
+ * Applied to the RAW object, before parsing, for the reason `ownWorktreeRetention` documents just
+ * below: `defaultRunner`'s `.default('claude')` materializes the key, so after a parse there is no
+ * telling "the user chose claude" from "the user said nothing". Merging first keeps the wire shape
+ * exactly as it has always been — `defaultRunner` and the model presets stay always-present — while
+ * making an absent key mean "ask the machine".
+ *
+ * A repo key always wins, and `models` merges per RUNNER rather than wholesale: pinning claude's
+ * model in one repo must not silently discard the machine's codex preset.
+ */
+function withMachineDefaults(raw, machine) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        raw = {};
+    const own = raw;
+    const ownModels = own.defaultModels && typeof own.defaultModels === 'object'
+        ? own.defaultModels
+        : undefined;
+    const models = { ...machine.models, ...ownModels };
+    return {
+        ...own,
+        ...(own.defaultRunner === undefined && machine.runner !== undefined
+            ? { defaultRunner: machine.runner }
+            : {}),
+        ...(Object.keys(models).length > 0 ? { defaultModels: models } : {}),
+    };
+}
+/**
+ * Read `.ai/cezar/config.json` on demand — never cached, never throws.
+ *
+ * Also reads the machine-wide defaults, which is one more small JSON read and deliberately not
+ * cached for the same reason this one is not: `~/.cezar/` is shared by every cezar process on the
+ * machine, so a snapshot is a staleness bug.
+ */
 export async function loadConfig(repoRoot) {
+    const machine = (await loadWorkspaceConfig()).agentDefaults;
     let raw;
     try {
         raw = await readFile(join(repoRoot, '.ai/cezar', 'config.json'), 'utf8');
     }
     catch {
-        return configSchema.parse({});
+        return configSchema.parse(withMachineDefaults({}, machine));
     }
     try {
-        const parsed = configSchema.safeParse(JSON.parse(raw));
+        const parsed = configSchema.safeParse(withMachineDefaults(JSON.parse(raw), machine));
         if (parsed.success)
             return parsed.data;
     }
     catch {
         // fall through — malformed JSON degrades to the default
     }
-    return configSchema.parse({});
+    return configSchema.parse(withMachineDefaults({}, machine));
 }
 /**
  * The repo's OWN `worktreeRetention`, or `undefined` when it doesn't set one.

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAwB,MAAM,uBAAuB,CAAC;AAElF;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,gFAAgF;IAChF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CACvC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAuB;IACtD,EAAE,IAAI,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,EAAE;CAC7C,CAAC;AAEF,mFAAmF;AACnF,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C;;oEAEoE;AACpE,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAElE,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IACpE,4EAA4E;IAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD;;;;;;OAMG;IACH,iBAAiB,EAAE,uBAAuB,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC;IAChH;;;;;OAKG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IACjF;;;;OAIG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACxE,2EAA2E;IAC3E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACjD;sFACkF;IAClF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAC9C;;gCAE4B;IAC5B,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC;;;mEAG+D;IAC/D,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C;;;;;;;OAOG;IACH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IAC9E;;;;;;OAMG;IACH,aAAa,EAAE,CAAC;SACb,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QACpD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;KACvD,CAAC;SACD,QAAQ,EAAE;SACV,KAAK,CAAC,SAAS,CAAC;IACnB;;;;OAIG;IACH,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;CACtD,CAAC,CAAC;AAIH;;;;;;;;;;;GAWG;AACH,SAAS,mBAAmB,CAAC,GAAY,EAAE,OAAyC;IAClF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,EAAE,CAAC;IACpE,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,MAAM,SAAS,GAAG,GAAG,CAAC,aAAa,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ;QAC1E,CAAC,CAAC,GAAG,CAAC,aAAwC;QAC9C,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IACnD,OAAO;QACL,GAAG,GAAG;QACN,GAAG,CAAC,GAAG,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YACjE,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE;YACnC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,MAAM,OAAO,GAAG,CAAC,MAAM,mBAAmB,EAAE,CAAC,CAAC,aAAa,CAAC;IAC5D,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACrF,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;IAC1D,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,oBAAoB,CAAC,QAAgB;IAClD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC,CAAC,wBAAwB;IAC5C,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC5D,MAAM,KAAK,GAAI,MAAkC,CAAC,iBAAiB,CAAC;QACpE,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC1C,MAAM,KAAK,GAAG,uBAAuB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACvD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC,CAAC,iCAAiC;IACrD,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;QACpE,OAAO,IAAI,GAAG,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,OAAO,IAAI,GAAG,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,2EAA2E;QAC3E,0EAA0E;QAC1E,IAAK,MAAkC,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC/E,OAAO,IAAI,GAAG,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,OAAO,IAAI,GAAG,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,QAAgB;IAC7D,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClC,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,SAAS,EAAE,SAAS,CAAC,wBAAwB,IAAI,0BAA0B,CAAC;AACrF,CAAC"}

package/dist/contract/agent-config.d.ts

@@ -0,0 +1,151 @@
+import { z } from 'zod';
+/**
+ * The agent-config surface (spec #404): the settings / memory / MCP files the installed agent
+ * CLIs read, listed and edited through `GET/PUT /agent-config[/:id]`.
+ */
+export declare const agentConfigFormatSchema: z.ZodEnum<{
+    json: "json";
+    jsonc: "jsonc";
+    markdown: "markdown";
+    toml: "toml";
+}>;
+export type AgentConfigFormat = z.infer<typeof agentConfigFormatSchema>;
+export declare const agentConfigScopeSchema: z.ZodEnum<{
+    local: "local";
+    project: "project";
+    user: "user";
+}>;
+export type AgentConfigScope = z.infer<typeof agentConfigScopeSchema>;
+/** `settings` = behavior knobs; `memory` = instruction/markdown; `mcp` = a dedicated MCP file. */
+export declare const agentConfigKindSchema: z.ZodEnum<{
+    mcp: "mcp";
+    memory: "memory";
+    settings: "settings";
+}>;
+export type AgentConfigKind = z.infer<typeof agentConfigKindSchema>;
+/** Git status BY CONVENTION — it drives the honest label; it is not read from git. */
+export declare const agentConfigTrackedSchema: z.ZodEnum<{
+    gitignored: "gitignored";
+    "outside-repo": "outside-repo";
+    tracked: "tracked";
+}>;
+export type AgentConfigTracked = z.infer<typeof agentConfigTrackedSchema>;
+/** One catalog file plus its current on-disk state. */
+export declare const agentConfigFileSchema: z.ZodObject<{
+    id: z.ZodString;
+    runners: z.ZodArray<z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        opencode: "opencode";
+    }>>;
+    kind: z.ZodEnum<{
+        mcp: "mcp";
+        memory: "memory";
+        settings: "settings";
+    }>;
+    scope: z.ZodEnum<{
+        local: "local";
+        project: "project";
+        user: "user";
+    }>;
+    label: z.ZodString;
+    path: z.ZodString;
+    format: z.ZodEnum<{
+        json: "json";
+        jsonc: "jsonc";
+        markdown: "markdown";
+        toml: "toml";
+    }>;
+    tracked: z.ZodEnum<{
+        gitignored: "gitignored";
+        "outside-repo": "outside-repo";
+        tracked: "tracked";
+    }>;
+    seeded: z.ZodBoolean;
+    holdsMcp: z.ZodBoolean;
+    precedence: z.ZodString;
+    hotReload: z.ZodOptional<z.ZodString>;
+    docsUrl: z.ZodString;
+    exists: z.ZodBoolean;
+    size: z.ZodNumber;
+    version: z.ZodNullable<z.ZodString>;
+    writable: z.ZodBoolean;
+    readOnlyReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AgentConfigFile = z.infer<typeof agentConfigFileSchema>;
+/** Read-only listing of the MCP servers Claude keeps in `~/.claude.json`. */
+export declare const userMcpListingSchema: z.ZodObject<{
+    path: z.ZodString;
+    servers: z.ZodArray<z.ZodString>;
+    readable: z.ZodBoolean;
+}, z.core.$strip>;
+export type UserMcpListing = z.infer<typeof userMcpListingSchema>;
+/** `GET /agent-config` — the whole panel in one read. */
+export declare const agentConfigListingSchema: z.ZodObject<{
+    editable: z.ZodBoolean;
+    files: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        runners: z.ZodArray<z.ZodEnum<{
+            claude: "claude";
+            codex: "codex";
+            opencode: "opencode";
+        }>>;
+        kind: z.ZodEnum<{
+            mcp: "mcp";
+            memory: "memory";
+            settings: "settings";
+        }>;
+        scope: z.ZodEnum<{
+            local: "local";
+            project: "project";
+            user: "user";
+        }>;
+        label: z.ZodString;
+        path: z.ZodString;
+        format: z.ZodEnum<{
+            json: "json";
+            jsonc: "jsonc";
+            markdown: "markdown";
+            toml: "toml";
+        }>;
+        tracked: z.ZodEnum<{
+            gitignored: "gitignored";
+            "outside-repo": "outside-repo";
+            tracked: "tracked";
+        }>;
+        seeded: z.ZodBoolean;
+        holdsMcp: z.ZodBoolean;
+        precedence: z.ZodString;
+        hotReload: z.ZodOptional<z.ZodString>;
+        docsUrl: z.ZodString;
+        exists: z.ZodBoolean;
+        size: z.ZodNumber;
+        version: z.ZodNullable<z.ZodString>;
+        writable: z.ZodBoolean;
+        readOnlyReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    userMcp: z.ZodNullable<z.ZodObject<{
+        path: z.ZodString;
+        servers: z.ZodArray<z.ZodString>;
+        readable: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AgentConfigListing = z.infer<typeof agentConfigListingSchema>;
+/** `GET /agent-config/:id` and the `PUT` echo — one file's bytes plus its stale-write token. */
+export declare const agentConfigFileContentSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    exists: z.ZodBoolean;
+    content: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AgentConfigFileContent = z.infer<typeof agentConfigFileContentSchema>;
+/**
+ * `PUT /agent-config/:id` body. `version` is the token from the read that produced `content` —
+ * `null` means "I expect no file to exist yet" (the create path); a mismatch is a 409.
+ */
+export declare const setAgentConfigInputSchema: z.ZodObject<{
+    content: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type SetAgentConfigInput = z.infer<typeof setAgentConfigInputSchema>;