agent-dealer 0.2.0 → 1.0.0

package/bundle/shared/dist/agents.d.ts

@@ -2,154 +2,230 @@ import { z } from "zod";
 /** Built-in agent IDs — stable across installs. */
 export declare const BUILTIN_AGENT_CLAUDE_ID = "00000000-0000-4000-a000-000000000001";
 export declare const BUILTIN_AGENT_CURSOR_ID = "00000000-0000-4000-a000-000000000002";
+export declare const BUILTIN_AGENT_CODEX_ID = "00000000-0000-4000-a000-000000000003";
 /** Cursor CLI model id for Auto + Composer subscription pool (not IDE default). */
 export declare const CURSOR_DEFAULT_MODEL = "auto";
 /** Cursor models that draw from the Auto + Composer pool on individual Pro plans. */
 export declare const CURSOR_SUBSCRIPTION_MODEL_IDS: readonly ["auto", "composer-2.5", "composer-2.5-fast"];
 export declare const AgentHealthIssue: z.ZodObject<{
-    code: z.ZodEnum<["cli_missing", "runtime_auth", "deck_offline", "workspace_missing", "mcp_not_registered"]>;
+    code: z.ZodEnum<["cli_missing", "runtime_auth", "cursor_keychain", "usage_capped", "deck_offline", "deck_unauthorized", "workspace_missing", "deck_missing", "mcp_not_registered", "github_cli_missing", "github_auth"]>;
     message: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+    code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
     message: string;
 }, {
-    code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+    code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
     message: string;
 }>;
 export type AgentHealthIssue = z.infer<typeof AgentHealthIssue>;
 export declare const AgentProfile: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
-    runtime: z.ZodEnum<["claude_code", "cursor_local"]>;
+    runtime: z.ZodEnum<["claude_code", "cursor_local", "codex_local"]>;
+    /**
+     * Dead legacy storage (NOT-149). Retained so existing rows migrate safely; never shown
+     * in UI, never required by health/admission, and never copied into new profile snapshots.
+     */
     workspaceRoot: z.ZodNullable<z.ZodString>;
+    /** Required for any Agent used for execution — Dealer never starts without a Deck. */
     deckId: z.ZodNullable<z.ZodString>;
     deckName: z.ZodNullable<z.ZodString>;
+    /** Dead legacy storage (NOT-149) — playbooks are chosen dynamically inside the Deck. */
     playbookId: z.ZodNullable<z.ZodString>;
-    /** CLI model id for planning; null = runtime default */
+    /**
+     * Legacy phase defaults, read-only since NOT-71: nothing writes these any more, but
+     * profile-snapshot.ts still falls back to them so profiles saved before `defaultModel` /
+     * `defaultBudgetJson` existed keep their configured model and caps.
+     */
     defaultPlanModel: z.ZodNullable<z.ZodString>;
-    /** CLI model id for execution; null = runtime default */
     defaultExecuteModel: z.ZodNullable<z.ZodString>;
-    /** Serialized PhaseBudget; null = runtime default (no CLI caps) */
     defaultPlanBudgetJson: z.ZodNullable<z.ZodString>;
-    /** Serialized PhaseBudget; null = runtime default (no CLI caps) */
     defaultExecuteBudgetJson: z.ZodNullable<z.ZodString>;
+    /** Role-neutral CLI model id for issue-centric developer/reviewer sessions; null = runtime default. */
+    defaultModel: z.ZodNullable<z.ZodString>;
+    /**
+     * Default reasoning effort (NOT-81). Null = runtime default. Applied only for runtimes
+     * that expose a CLI-level effort control (Codex / Claude Code); Cursor ignores it.
+     */
+    defaultEffort: z.ZodNullable<z.ZodEnum<["low", "medium", "high"]>>;
+    /** Serialized PhaseBudget for issue-centric sessions; null = runtime default. */
+    defaultBudgetJson: z.ZodNullable<z.ZodString>;
+    /** Free-text description of what this profile is for (shown in the picker, snapshotted). */
+    purpose: z.ZodNullable<z.ZodString>;
+    /** Dead legacy storage (NOT-149). */
+    playbookIdsJson: z.ZodNullable<z.ZodString>;
+    /** Dead legacy storage (NOT-149). */
+    externalMemoryRefsJson: z.ZodNullable<z.ZodString>;
+    /** Serialized PermissionPolicyOverride — may only tighten the role's capabilities. */
+    permissionPolicyJson: z.ZodNullable<z.ZodString>;
     isBuiltin: z.ZodBoolean;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     id: string;
+    runtime: "claude_code" | "cursor_local" | "codex_local";
+    createdAt: string;
+    updatedAt: string;
+    deckId: string | null;
+    purpose: string | null;
     name: string;
-    runtime: "claude_code" | "cursor_local";
     workspaceRoot: string | null;
-    deckId: string | null;
     deckName: string | null;
     playbookId: string | null;
     defaultPlanModel: string | null;
     defaultExecuteModel: string | null;
     defaultPlanBudgetJson: string | null;
     defaultExecuteBudgetJson: string | null;
+    defaultModel: string | null;
+    defaultEffort: "low" | "medium" | "high" | null;
+    defaultBudgetJson: string | null;
+    playbookIdsJson: string | null;
+    externalMemoryRefsJson: string | null;
+    permissionPolicyJson: string | null;
     isBuiltin: boolean;
-    createdAt: string;
-    updatedAt: string;
 }, {
     id: string;
+    runtime: "claude_code" | "cursor_local" | "codex_local";
+    createdAt: string;
+    updatedAt: string;
+    deckId: string | null;
+    purpose: string | null;
     name: string;
-    runtime: "claude_code" | "cursor_local";
     workspaceRoot: string | null;
-    deckId: string | null;
     deckName: string | null;
     playbookId: string | null;
     defaultPlanModel: string | null;
     defaultExecuteModel: string | null;
     defaultPlanBudgetJson: string | null;
     defaultExecuteBudgetJson: string | null;
+    defaultModel: string | null;
+    defaultEffort: "low" | "medium" | "high" | null;
+    defaultBudgetJson: string | null;
+    playbookIdsJson: string | null;
+    externalMemoryRefsJson: string | null;
+    permissionPolicyJson: string | null;
     isBuiltin: boolean;
-    createdAt: string;
-    updatedAt: string;
 }>;
 export type AgentProfile = z.infer<typeof AgentProfile>;
 export declare const AgentWithHealth: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
-    runtime: z.ZodEnum<["claude_code", "cursor_local"]>;
+    runtime: z.ZodEnum<["claude_code", "cursor_local", "codex_local"]>;
+    /**
+     * Dead legacy storage (NOT-149). Retained so existing rows migrate safely; never shown
+     * in UI, never required by health/admission, and never copied into new profile snapshots.
+     */
     workspaceRoot: z.ZodNullable<z.ZodString>;
+    /** Required for any Agent used for execution — Dealer never starts without a Deck. */
     deckId: z.ZodNullable<z.ZodString>;
     deckName: z.ZodNullable<z.ZodString>;
+    /** Dead legacy storage (NOT-149) — playbooks are chosen dynamically inside the Deck. */
     playbookId: z.ZodNullable<z.ZodString>;
-    /** CLI model id for planning; null = runtime default */
+    /**
+     * Legacy phase defaults, read-only since NOT-71: nothing writes these any more, but
+     * profile-snapshot.ts still falls back to them so profiles saved before `defaultModel` /
+     * `defaultBudgetJson` existed keep their configured model and caps.
+     */
     defaultPlanModel: z.ZodNullable<z.ZodString>;
-    /** CLI model id for execution; null = runtime default */
     defaultExecuteModel: z.ZodNullable<z.ZodString>;
-    /** Serialized PhaseBudget; null = runtime default (no CLI caps) */
     defaultPlanBudgetJson: z.ZodNullable<z.ZodString>;
-    /** Serialized PhaseBudget; null = runtime default (no CLI caps) */
     defaultExecuteBudgetJson: z.ZodNullable<z.ZodString>;
+    /** Role-neutral CLI model id for issue-centric developer/reviewer sessions; null = runtime default. */
+    defaultModel: z.ZodNullable<z.ZodString>;
+    /**
+     * Default reasoning effort (NOT-81). Null = runtime default. Applied only for runtimes
+     * that expose a CLI-level effort control (Codex / Claude Code); Cursor ignores it.
+     */
+    defaultEffort: z.ZodNullable<z.ZodEnum<["low", "medium", "high"]>>;
+    /** Serialized PhaseBudget for issue-centric sessions; null = runtime default. */
+    defaultBudgetJson: z.ZodNullable<z.ZodString>;
+    /** Free-text description of what this profile is for (shown in the picker, snapshotted). */
+    purpose: z.ZodNullable<z.ZodString>;
+    /** Dead legacy storage (NOT-149). */
+    playbookIdsJson: z.ZodNullable<z.ZodString>;
+    /** Dead legacy storage (NOT-149). */
+    externalMemoryRefsJson: z.ZodNullable<z.ZodString>;
+    /** Serialized PermissionPolicyOverride — may only tighten the role's capabilities. */
+    permissionPolicyJson: z.ZodNullable<z.ZodString>;
     isBuiltin: z.ZodBoolean;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 } & {
     healthy: z.ZodBoolean;
     issues: z.ZodArray<z.ZodObject<{
-        code: z.ZodEnum<["cli_missing", "runtime_auth", "deck_offline", "workspace_missing", "mcp_not_registered"]>;
+        code: z.ZodEnum<["cli_missing", "runtime_auth", "cursor_keychain", "usage_capped", "deck_offline", "deck_unauthorized", "workspace_missing", "deck_missing", "mcp_not_registered", "github_cli_missing", "github_auth"]>;
         message: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+        code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
         message: string;
     }, {
-        code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+        code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
         message: string;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     issues: {
-        code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+        code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
         message: string;
     }[];
     id: string;
+    runtime: "claude_code" | "cursor_local" | "codex_local";
+    createdAt: string;
+    updatedAt: string;
+    deckId: string | null;
+    purpose: string | null;
     name: string;
-    runtime: "claude_code" | "cursor_local";
     workspaceRoot: string | null;
-    deckId: string | null;
     deckName: string | null;
     playbookId: string | null;
     defaultPlanModel: string | null;
     defaultExecuteModel: string | null;
     defaultPlanBudgetJson: string | null;
     defaultExecuteBudgetJson: string | null;
+    defaultModel: string | null;
+    defaultEffort: "low" | "medium" | "high" | null;
+    defaultBudgetJson: string | null;
+    playbookIdsJson: string | null;
+    externalMemoryRefsJson: string | null;
+    permissionPolicyJson: string | null;
     isBuiltin: boolean;
-    createdAt: string;
-    updatedAt: string;
     healthy: boolean;
 }, {
     issues: {
-        code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+        code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
         message: string;
     }[];
     id: string;
+    runtime: "claude_code" | "cursor_local" | "codex_local";
+    createdAt: string;
+    updatedAt: string;
+    deckId: string | null;
+    purpose: string | null;
     name: string;
-    runtime: "claude_code" | "cursor_local";
     workspaceRoot: string | null;
-    deckId: string | null;
     deckName: string | null;
     playbookId: string | null;
     defaultPlanModel: string | null;
     defaultExecuteModel: string | null;
     defaultPlanBudgetJson: string | null;
     defaultExecuteBudgetJson: string | null;
+    defaultModel: string | null;
+    defaultEffort: "low" | "medium" | "high" | null;
+    defaultBudgetJson: string | null;
+    playbookIdsJson: string | null;
+    externalMemoryRefsJson: string | null;
+    permissionPolicyJson: string | null;
     isBuiltin: boolean;
-    createdAt: string;
-    updatedAt: string;
     healthy: boolean;
 }>;
 export type AgentWithHealth = z.infer<typeof AgentWithHealth>;
 export declare const CreateAgentInput: z.ZodObject<{
     name: z.ZodString;
-    runtime: z.ZodEnum<["claude_code", "cursor_local"]>;
-    workspaceRoot: z.ZodString;
-    deckId: z.ZodOptional<z.ZodString>;
-    playbookId: z.ZodOptional<z.ZodString>;
-    defaultPlanModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    defaultExecuteModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    defaultPlanBudget: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    runtime: z.ZodEnum<["claude_code", "cursor_local", "codex_local"]>;
+    /** Exactly one Agent Deck — required; workers never start in no-Deck/degraded mode. */
+    deckId: z.ZodString;
+    defaultModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    defaultEffort: z.ZodOptional<z.ZodNullable<z.ZodEnum<["low", "medium", "high"]>>>;
+    defaultBudget: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         maxTurns: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         maxBudgetUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     }, "strip", z.ZodTypeAny, {
@@ -159,45 +235,44 @@ export declare const CreateAgentInput: z.ZodObject<{
         maxTurns?: number | null | undefined;
         maxBudgetUsd?: number | null | undefined;
     }>>>;
-    defaultExecuteBudget: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        maxTurns: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        maxBudgetUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    }, "strip", z.ZodTypeAny, {
-        maxTurns?: number | null | undefined;
-        maxBudgetUsd?: number | null | undefined;
+    purpose: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    permissionPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        worktreeWrite: z.ZodOptional<z.ZodBoolean>;
+        outboundMutation: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        worktreeWrite?: boolean | undefined;
+        outboundMutation?: boolean | undefined;
     }, {
-        maxTurns?: number | null | undefined;
-        maxBudgetUsd?: number | null | undefined;
+        worktreeWrite?: boolean | undefined;
+        outboundMutation?: boolean | undefined;
     }>>>;
 }, "strip", z.ZodTypeAny, {
+    runtime: "claude_code" | "cursor_local" | "codex_local";
+    deckId: string;
     name: string;
-    runtime: "claude_code" | "cursor_local";
-    workspaceRoot: string;
-    deckId?: string | undefined;
-    playbookId?: string | undefined;
-    defaultPlanModel?: string | null | undefined;
-    defaultExecuteModel?: string | null | undefined;
-    defaultPlanBudget?: {
-        maxTurns?: number | null | undefined;
-        maxBudgetUsd?: number | null | undefined;
+    permissionPolicy?: {
+        worktreeWrite?: boolean | undefined;
+        outboundMutation?: boolean | undefined;
     } | null | undefined;
-    defaultExecuteBudget?: {
+    purpose?: string | null | undefined;
+    defaultModel?: string | null | undefined;
+    defaultEffort?: "low" | "medium" | "high" | null | undefined;
+    defaultBudget?: {
         maxTurns?: number | null | undefined;
         maxBudgetUsd?: number | null | undefined;
     } | null | undefined;
 }, {
+    runtime: "claude_code" | "cursor_local" | "codex_local";
+    deckId: string;
     name: string;
-    runtime: "claude_code" | "cursor_local";
-    workspaceRoot: string;
-    deckId?: string | undefined;
-    playbookId?: string | undefined;
-    defaultPlanModel?: string | null | undefined;
-    defaultExecuteModel?: string | null | undefined;
-    defaultPlanBudget?: {
-        maxTurns?: number | null | undefined;
-        maxBudgetUsd?: number | null | undefined;
+    permissionPolicy?: {
+        worktreeWrite?: boolean | undefined;
+        outboundMutation?: boolean | undefined;
     } | null | undefined;
-    defaultExecuteBudget?: {
+    purpose?: string | null | undefined;
+    defaultModel?: string | null | undefined;
+    defaultEffort?: "low" | "medium" | "high" | null | undefined;
+    defaultBudget?: {
         maxTurns?: number | null | undefined;
         maxBudgetUsd?: number | null | undefined;
     } | null | undefined;
@@ -205,13 +280,12 @@ export declare const CreateAgentInput: z.ZodObject<{
 export type CreateAgentInput = z.infer<typeof CreateAgentInput>;
 export declare const UpdateAgentInput: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
-    runtime: z.ZodOptional<z.ZodEnum<["claude_code", "cursor_local"]>>;
-    workspaceRoot: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    runtime: z.ZodOptional<z.ZodEnum<["claude_code", "cursor_local", "codex_local"]>>;
+    /** Null clears the deck (unhealthy until set again); omit leaves unchanged. */
     deckId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    playbookId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    defaultPlanModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    defaultExecuteModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    defaultPlanBudget: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    defaultModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    defaultEffort: z.ZodOptional<z.ZodNullable<z.ZodEnum<["low", "medium", "high"]>>>;
+    defaultBudget: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         maxTurns: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         maxBudgetUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     }, "strip", z.ZodTypeAny, {
@@ -221,45 +295,44 @@ export declare const UpdateAgentInput: z.ZodObject<{
         maxTurns?: number | null | undefined;
         maxBudgetUsd?: number | null | undefined;
     }>>>;
-    defaultExecuteBudget: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        maxTurns: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        maxBudgetUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    }, "strip", z.ZodTypeAny, {
-        maxTurns?: number | null | undefined;
-        maxBudgetUsd?: number | null | undefined;
+    purpose: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    permissionPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        worktreeWrite: z.ZodOptional<z.ZodBoolean>;
+        outboundMutation: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        worktreeWrite?: boolean | undefined;
+        outboundMutation?: boolean | undefined;
     }, {
-        maxTurns?: number | null | undefined;
-        maxBudgetUsd?: number | null | undefined;
+        worktreeWrite?: boolean | undefined;
+        outboundMutation?: boolean | undefined;
     }>>>;
 }, "strip", z.ZodTypeAny, {
-    name?: string | undefined;
-    runtime?: "claude_code" | "cursor_local" | undefined;
-    workspaceRoot?: string | null | undefined;
-    deckId?: string | null | undefined;
-    playbookId?: string | null | undefined;
-    defaultPlanModel?: string | null | undefined;
-    defaultExecuteModel?: string | null | undefined;
-    defaultPlanBudget?: {
-        maxTurns?: number | null | undefined;
-        maxBudgetUsd?: number | null | undefined;
+    runtime?: "claude_code" | "cursor_local" | "codex_local" | undefined;
+    permissionPolicy?: {
+        worktreeWrite?: boolean | undefined;
+        outboundMutation?: boolean | undefined;
     } | null | undefined;
-    defaultExecuteBudget?: {
+    deckId?: string | null | undefined;
+    purpose?: string | null | undefined;
+    name?: string | undefined;
+    defaultModel?: string | null | undefined;
+    defaultEffort?: "low" | "medium" | "high" | null | undefined;
+    defaultBudget?: {
         maxTurns?: number | null | undefined;
         maxBudgetUsd?: number | null | undefined;
     } | null | undefined;
 }, {
-    name?: string | undefined;
-    runtime?: "claude_code" | "cursor_local" | undefined;
-    workspaceRoot?: string | null | undefined;
-    deckId?: string | null | undefined;
-    playbookId?: string | null | undefined;
-    defaultPlanModel?: string | null | undefined;
-    defaultExecuteModel?: string | null | undefined;
-    defaultPlanBudget?: {
-        maxTurns?: number | null | undefined;
-        maxBudgetUsd?: number | null | undefined;
+    runtime?: "claude_code" | "cursor_local" | "codex_local" | undefined;
+    permissionPolicy?: {
+        worktreeWrite?: boolean | undefined;
+        outboundMutation?: boolean | undefined;
     } | null | undefined;
-    defaultExecuteBudget?: {
+    deckId?: string | null | undefined;
+    purpose?: string | null | undefined;
+    name?: string | undefined;
+    defaultModel?: string | null | undefined;
+    defaultEffort?: "low" | "medium" | "high" | null | undefined;
+    defaultBudget?: {
         maxTurns?: number | null | undefined;
         maxBudgetUsd?: number | null | undefined;
     } | null | undefined;
@@ -269,121 +342,177 @@ export declare const AgentsSnapshot: z.ZodObject<{
     agents: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
-        runtime: z.ZodEnum<["claude_code", "cursor_local"]>;
+        runtime: z.ZodEnum<["claude_code", "cursor_local", "codex_local"]>;
+        /**
+         * Dead legacy storage (NOT-149). Retained so existing rows migrate safely; never shown
+         * in UI, never required by health/admission, and never copied into new profile snapshots.
+         */
         workspaceRoot: z.ZodNullable<z.ZodString>;
+        /** Required for any Agent used for execution — Dealer never starts without a Deck. */
         deckId: z.ZodNullable<z.ZodString>;
         deckName: z.ZodNullable<z.ZodString>;
+        /** Dead legacy storage (NOT-149) — playbooks are chosen dynamically inside the Deck. */
         playbookId: z.ZodNullable<z.ZodString>;
-        /** CLI model id for planning; null = runtime default */
+        /**
+         * Legacy phase defaults, read-only since NOT-71: nothing writes these any more, but
+         * profile-snapshot.ts still falls back to them so profiles saved before `defaultModel` /
+         * `defaultBudgetJson` existed keep their configured model and caps.
+         */
         defaultPlanModel: z.ZodNullable<z.ZodString>;
-        /** CLI model id for execution; null = runtime default */
         defaultExecuteModel: z.ZodNullable<z.ZodString>;
-        /** Serialized PhaseBudget; null = runtime default (no CLI caps) */
         defaultPlanBudgetJson: z.ZodNullable<z.ZodString>;
-        /** Serialized PhaseBudget; null = runtime default (no CLI caps) */
         defaultExecuteBudgetJson: z.ZodNullable<z.ZodString>;
+        /** Role-neutral CLI model id for issue-centric developer/reviewer sessions; null = runtime default. */
+        defaultModel: z.ZodNullable<z.ZodString>;
+        /**
+         * Default reasoning effort (NOT-81). Null = runtime default. Applied only for runtimes
+         * that expose a CLI-level effort control (Codex / Claude Code); Cursor ignores it.
+         */
+        defaultEffort: z.ZodNullable<z.ZodEnum<["low", "medium", "high"]>>;
+        /** Serialized PhaseBudget for issue-centric sessions; null = runtime default. */
+        defaultBudgetJson: z.ZodNullable<z.ZodString>;
+        /** Free-text description of what this profile is for (shown in the picker, snapshotted). */
+        purpose: z.ZodNullable<z.ZodString>;
+        /** Dead legacy storage (NOT-149). */
+        playbookIdsJson: z.ZodNullable<z.ZodString>;
+        /** Dead legacy storage (NOT-149). */
+        externalMemoryRefsJson: z.ZodNullable<z.ZodString>;
+        /** Serialized PermissionPolicyOverride — may only tighten the role's capabilities. */
+        permissionPolicyJson: z.ZodNullable<z.ZodString>;
         isBuiltin: z.ZodBoolean;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     } & {
         healthy: z.ZodBoolean;
         issues: z.ZodArray<z.ZodObject<{
-            code: z.ZodEnum<["cli_missing", "runtime_auth", "deck_offline", "workspace_missing", "mcp_not_registered"]>;
+            code: z.ZodEnum<["cli_missing", "runtime_auth", "cursor_keychain", "usage_capped", "deck_offline", "deck_unauthorized", "workspace_missing", "deck_missing", "mcp_not_registered", "github_cli_missing", "github_auth"]>;
             message: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+            code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
             message: string;
         }, {
-            code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+            code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
             message: string;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         issues: {
-            code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+            code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
             message: string;
         }[];
         id: string;
+        runtime: "claude_code" | "cursor_local" | "codex_local";
+        createdAt: string;
+        updatedAt: string;
+        deckId: string | null;
+        purpose: string | null;
         name: string;
-        runtime: "claude_code" | "cursor_local";
         workspaceRoot: string | null;
-        deckId: string | null;
         deckName: string | null;
         playbookId: string | null;
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         defaultPlanBudgetJson: string | null;
         defaultExecuteBudgetJson: string | null;
+        defaultModel: string | null;
+        defaultEffort: "low" | "medium" | "high" | null;
+        defaultBudgetJson: string | null;
+        playbookIdsJson: string | null;
+        externalMemoryRefsJson: string | null;
+        permissionPolicyJson: string | null;
         isBuiltin: boolean;
-        createdAt: string;
-        updatedAt: string;
         healthy: boolean;
     }, {
         issues: {
-            code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+            code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
             message: string;
         }[];
         id: string;
+        runtime: "claude_code" | "cursor_local" | "codex_local";
+        createdAt: string;
+        updatedAt: string;
+        deckId: string | null;
+        purpose: string | null;
         name: string;
-        runtime: "claude_code" | "cursor_local";
         workspaceRoot: string | null;
-        deckId: string | null;
         deckName: string | null;
         playbookId: string | null;
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         defaultPlanBudgetJson: string | null;
         defaultExecuteBudgetJson: string | null;
+        defaultModel: string | null;
+        defaultEffort: "low" | "medium" | "high" | null;
+        defaultBudgetJson: string | null;
+        playbookIdsJson: string | null;
+        externalMemoryRefsJson: string | null;
+        permissionPolicyJson: string | null;
         isBuiltin: boolean;
-        createdAt: string;
-        updatedAt: string;
         healthy: boolean;
     }>, "many">;
     issueCount: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     agents: {
         issues: {
-            code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+            code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
             message: string;
         }[];
         id: string;
+        runtime: "claude_code" | "cursor_local" | "codex_local";
+        createdAt: string;
+        updatedAt: string;
+        deckId: string | null;
+        purpose: string | null;
         name: string;
-        runtime: "claude_code" | "cursor_local";
         workspaceRoot: string | null;
-        deckId: string | null;
         deckName: string | null;
         playbookId: string | null;
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         defaultPlanBudgetJson: string | null;
         defaultExecuteBudgetJson: string | null;
+        defaultModel: string | null;
+        defaultEffort: "low" | "medium" | "high" | null;
+        defaultBudgetJson: string | null;
+        playbookIdsJson: string | null;
+        externalMemoryRefsJson: string | null;
+        permissionPolicyJson: string | null;
         isBuiltin: boolean;
-        createdAt: string;
-        updatedAt: string;
         healthy: boolean;
     }[];
     issueCount: number;
 }, {
     agents: {
         issues: {
-            code: "cli_missing" | "runtime_auth" | "deck_offline" | "workspace_missing" | "mcp_not_registered";
+            code: "cli_missing" | "runtime_auth" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth";
             message: string;
         }[];
         id: string;
+        runtime: "claude_code" | "cursor_local" | "codex_local";
+        createdAt: string;
+        updatedAt: string;
+        deckId: string | null;
+        purpose: string | null;
         name: string;
-        runtime: "claude_code" | "cursor_local";
         workspaceRoot: string | null;
-        deckId: string | null;
         deckName: string | null;
         playbookId: string | null;
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         defaultPlanBudgetJson: string | null;
         defaultExecuteBudgetJson: string | null;
+        defaultModel: string | null;
+        defaultEffort: "low" | "medium" | "high" | null;
+        defaultBudgetJson: string | null;
+        playbookIdsJson: string | null;
+        externalMemoryRefsJson: string | null;
+        permissionPolicyJson: string | null;
         isBuiltin: boolean;
-        createdAt: string;
-        updatedAt: string;
         healthy: boolean;
     }[];
     issueCount: number;
 }>;
 export type AgentsSnapshot = z.infer<typeof AgentsSnapshot>;
+/** Role-neutral model, falling back through the legacy phase columns (execute → plan). */
+export declare function resolveProfileModel(agent: AgentProfile): string | null;
+/** Role-neutral budget JSON, same fallback order as the model. */
+export declare function resolveProfileBudgetJson(agent: AgentProfile): string | null;