@open-mercato/cezar 0.9.1 → 0.9.2

package/dist/config.d.ts

@@ -6,140 +6,38 @@ 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>>>;
+}, z.core.$strip>;
 export type CezConfig = z.infer<typeof configSchema>;
 /** Read `.ai/cezar/config.json` on demand — never cached, never throws. */
 export declare function loadConfig(repoRoot: string): Promise<CezConfig>;

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>;