bopodev-agent-sdk 0.1.24 → 0.1.26

package/dist/contracts/src/index.d.ts

@@ -21,6 +21,9 @@ export declare const ProjectSchema: z.ZodObject<{
         archived: "archived";
     }>;
     plannedStartAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    monthlyBudgetUsd: z.ZodNumber;
+    usedBudgetUsd: z.ZodNumber;
+    budgetWindowStartAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     executionWorkspacePolicy: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     gitDiagnostics: z.ZodOptional<z.ZodObject<{
         workspaceStatus: z.ZodOptional<z.ZodEnum<{
@@ -165,11 +168,77 @@ export declare const IssueAttachmentSchema: z.ZodObject<{
     createdAt: z.ZodString;
 }, z.core.$strip>;
 export type IssueAttachment = z.infer<typeof IssueAttachmentSchema>;
+export declare const IssueCommentRecipientSchema: z.ZodObject<{
+    recipientType: z.ZodEnum<{
+        agent: "agent";
+        board: "board";
+        member: "member";
+    }>;
+    recipientId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deliveryStatus: z.ZodDefault<z.ZodEnum<{
+        pending: "pending";
+        dispatched: "dispatched";
+        failed: "failed";
+        skipped: "skipped";
+    }>>;
+    dispatchedRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dispatchedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    acknowledgedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type IssueCommentRecipient = z.infer<typeof IssueCommentRecipientSchema>;
+export declare const IssueCommentSchema: z.ZodObject<{
+    id: z.ZodString;
+    issueId: z.ZodString;
+    companyId: z.ZodString;
+    authorType: z.ZodEnum<{
+        human: "human";
+        agent: "agent";
+        system: "system";
+    }>;
+    authorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    recipients: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        recipientType: z.ZodEnum<{
+            agent: "agent";
+            board: "board";
+            member: "member";
+        }>;
+        recipientId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        deliveryStatus: z.ZodDefault<z.ZodEnum<{
+            pending: "pending";
+            dispatched: "dispatched";
+            failed: "failed";
+            skipped: "skipped";
+        }>>;
+        dispatchedRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        dispatchedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        acknowledgedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    runId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    body: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type IssueComment = z.infer<typeof IssueCommentSchema>;
 export declare const GoalLevelSchema: z.ZodEnum<{
     agent: "agent";
     company: "company";
     project: "project";
 }>;
+export declare const AgentRoleKeySchema: z.ZodEnum<{
+    ceo: "ceo";
+    cto: "cto";
+    cmo: "cmo";
+    cfo: "cfo";
+    engineer: "engineer";
+    designer: "designer";
+    pm: "pm";
+    qa: "qa";
+    devops: "devops";
+    researcher: "researcher";
+    general: "general";
+}>;
+export type AgentRoleKey = z.infer<typeof AgentRoleKeySchema>;
+export declare const AGENT_ROLE_KEYS: ("ceo" | "cto" | "cmo" | "cfo" | "engineer" | "designer" | "pm" | "qa" | "devops" | "researcher" | "general")[];
+export declare const AGENT_ROLE_LABELS: Record<AgentRoleKey, string>;
 export declare const GoalSchema: z.ZodObject<{
     id: z.ZodString;
     companyId: z.ZodString;
@@ -251,6 +320,20 @@ export declare const TemplateManifestGoalSchema: z.ZodObject<{
 export declare const TemplateManifestAgentSchema: z.ZodObject<{
     key: z.ZodString;
     role: z.ZodString;
+    roleKey: z.ZodOptional<z.ZodEnum<{
+        ceo: "ceo";
+        cto: "cto";
+        cmo: "cmo";
+        cfo: "cfo";
+        engineer: "engineer";
+        designer: "designer";
+        pm: "pm";
+        qa: "qa";
+        devops: "devops";
+        researcher: "researcher";
+        general: "general";
+    }>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodString;
     providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
         claude_code: "claude_code";
@@ -364,6 +447,20 @@ export declare const TemplateManifestSchema: z.ZodObject<{
     agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
         key: z.ZodString;
         role: z.ZodString;
+        roleKey: z.ZodOptional<z.ZodEnum<{
+            ceo: "ceo";
+            cto: "cto";
+            cmo: "cmo";
+            cfo: "cfo";
+            engineer: "engineer";
+            designer: "designer";
+            pm: "pm";
+            qa: "qa";
+            devops: "devops";
+            researcher: "researcher";
+            general: "general";
+        }>>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         name: z.ZodString;
         providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
             claude_code: "claude_code";
@@ -510,6 +607,20 @@ export declare const TemplateSchema: z.ZodObject<{
         agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
             role: z.ZodString;
+            roleKey: z.ZodOptional<z.ZodEnum<{
+                ceo: "ceo";
+                cto: "cto";
+                cmo: "cmo";
+                cfo: "cfo";
+                engineer: "engineer";
+                designer: "designer";
+                pm: "pm";
+                qa: "qa";
+                devops: "devops";
+                researcher: "researcher";
+                general: "general";
+            }>>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             name: z.ZodString;
             providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                 claude_code: "claude_code";
@@ -656,6 +767,20 @@ export declare const TemplateCreateRequestSchema: z.ZodObject<{
         agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
             role: z.ZodString;
+            roleKey: z.ZodOptional<z.ZodEnum<{
+                ceo: "ceo";
+                cto: "cto";
+                cmo: "cmo";
+                cfo: "cfo";
+                engineer: "engineer";
+                designer: "designer";
+                pm: "pm";
+                qa: "qa";
+                devops: "devops";
+                researcher: "researcher";
+                general: "general";
+            }>>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             name: z.ZodString;
             providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                 claude_code: "claude_code";
@@ -800,6 +925,20 @@ export declare const TemplateUpdateRequestSchema: z.ZodObject<{
         agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
             role: z.ZodString;
+            roleKey: z.ZodOptional<z.ZodEnum<{
+                ceo: "ceo";
+                cto: "cto";
+                cmo: "cmo";
+                cfo: "cfo";
+                engineer: "engineer";
+                designer: "designer";
+                pm: "pm";
+                qa: "qa";
+                devops: "devops";
+                researcher: "researcher";
+                general: "general";
+            }>>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             name: z.ZodString;
             providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                 claude_code: "claude_code";
@@ -995,6 +1134,20 @@ export declare const TemplateExportSchema: z.ZodObject<{
             agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 key: z.ZodString;
                 role: z.ZodString;
+                roleKey: z.ZodOptional<z.ZodEnum<{
+                    ceo: "ceo";
+                    cto: "cto";
+                    cmo: "cmo";
+                    cfo: "cfo";
+                    engineer: "engineer";
+                    designer: "designer";
+                    pm: "pm";
+                    qa: "qa";
+                    devops: "devops";
+                    researcher: "researcher";
+                    general: "general";
+                }>>;
+                title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 name: z.ZodString;
                 providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                     claude_code: "claude_code";
@@ -1143,6 +1296,20 @@ export declare const TemplateImportRequestSchema: z.ZodObject<{
                 agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
                     key: z.ZodString;
                     role: z.ZodString;
+                    roleKey: z.ZodOptional<z.ZodEnum<{
+                        ceo: "ceo";
+                        cto: "cto";
+                        cmo: "cmo";
+                        cfo: "cfo";
+                        engineer: "engineer";
+                        designer: "designer";
+                        pm: "pm";
+                        qa: "qa";
+                        devops: "devops";
+                        researcher: "researcher";
+                        general: "general";
+                    }>>;
+                    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                     name: z.ZodString;
                     providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                         claude_code: "claude_code";
@@ -1268,6 +1435,20 @@ export declare const TemplateVersionSchema: z.ZodObject<{
         agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
             role: z.ZodString;
+            roleKey: z.ZodOptional<z.ZodEnum<{
+                ceo: "ceo";
+                cto: "cto";
+                cmo: "cmo";
+                cfo: "cfo";
+                engineer: "engineer";
+                designer: "designer";
+                pm: "pm";
+                qa: "qa";
+                devops: "devops";
+                researcher: "researcher";
+                general: "general";
+            }>>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             name: z.ZodString;
             providerType: z.ZodDefault<z.ZodLazy<z.ZodEnum<{
                 claude_code: "claude_code";
@@ -1359,9 +1540,9 @@ export declare const TemplateInstallSchema: z.ZodObject<{
     templateId: z.ZodNullable<z.ZodString>;
     templateVersionId: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
+        failed: "failed";
         applied: "applied";
         queued: "queued";
-        failed: "failed";
     }>;
     summary: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     variables: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -1434,6 +1615,9 @@ export declare const ControlPlaneRuntimeEnvSchema: z.ZodObject<{
     BOPODEV_ACTOR_COMPANIES: z.ZodOptional<z.ZodString>;
     BOPODEV_ACTOR_PERMISSIONS: z.ZodOptional<z.ZodString>;
     BOPODEV_REQUEST_HEADERS_JSON: z.ZodOptional<z.ZodString>;
+    BOPODEV_WAKE_REASON: z.ZodOptional<z.ZodString>;
+    BOPODEV_WAKE_COMMENT_ID: z.ZodOptional<z.ZodString>;
+    BOPODEV_LINKED_ISSUE_IDS: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ControlPlaneRuntimeEnv = z.infer<typeof ControlPlaneRuntimeEnvSchema>;
 export declare const ExecutionOutcomeKindSchema: z.ZodEnum<{
@@ -1497,6 +1681,211 @@ export declare const ExecutionOutcomeSchema: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 export type ExecutionOutcome = z.infer<typeof ExecutionOutcomeSchema>;
+export declare const AgentFinalRunOutputArtifactSchema: z.ZodObject<{
+    kind: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strict>;
+export type AgentFinalRunOutputArtifact = z.infer<typeof AgentFinalRunOutputArtifactSchema>;
+export declare const AgentFinalRunOutputSchema: z.ZodObject<{
+    employee_comment: z.ZodString;
+    results: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    errors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$loose>;
+export type AgentFinalRunOutput = z.infer<typeof AgentFinalRunOutputSchema>;
+export declare const RunUsdCostStatusSchema: z.ZodEnum<{
+    unknown: "unknown";
+    exact: "exact";
+    estimated: "estimated";
+}>;
+export type RunUsdCostStatus = z.infer<typeof RunUsdCostStatusSchema>;
+export declare const RunCompletionReasonSchema: z.ZodEnum<{
+    blocked: "blocked";
+    unknown: "unknown";
+    task_completed: "task_completed";
+    no_assigned_work: "no_assigned_work";
+    provider_rate_limited: "provider_rate_limited";
+    provider_out_of_funds: "provider_out_of_funds";
+    provider_quota_exhausted: "provider_quota_exhausted";
+    auth_error: "auth_error";
+    timeout: "timeout";
+    cancelled: "cancelled";
+    contract_invalid: "contract_invalid";
+    runtime_error: "runtime_error";
+    runtime_missing: "runtime_missing";
+    budget_hard_stop: "budget_hard_stop";
+    overlap_in_progress: "overlap_in_progress";
+    provider_unavailable: "provider_unavailable";
+}>;
+export type RunCompletionReason = z.infer<typeof RunCompletionReasonSchema>;
+export declare const RunResultStatusSchema: z.ZodEnum<{
+    reported: "reported";
+    none_reported: "none_reported";
+}>;
+export type RunResultStatus = z.infer<typeof RunResultStatusSchema>;
+export declare const RunArtifactSchema: z.ZodObject<{
+    path: z.ZodString;
+    kind: z.ZodString;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    relativePath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    absolutePath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type RunArtifact = z.infer<typeof RunArtifactSchema>;
+export declare const RunCostSummarySchema: z.ZodObject<{
+    tokenInput: z.ZodDefault<z.ZodNumber>;
+    tokenOutput: z.ZodDefault<z.ZodNumber>;
+    usdCost: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    usdCostStatus: z.ZodDefault<z.ZodEnum<{
+        unknown: "unknown";
+        exact: "exact";
+        estimated: "estimated";
+    }>>;
+    pricingSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type RunCostSummary = z.infer<typeof RunCostSummarySchema>;
+export declare const RunManagerReportSchema: z.ZodObject<{
+    agentName: z.ZodString;
+    providerType: z.ZodEnum<{
+        claude_code: "claude_code";
+        codex: "codex";
+        cursor: "cursor";
+        opencode: "opencode";
+        gemini_cli: "gemini_cli";
+        openai_api: "openai_api";
+        anthropic_api: "anthropic_api";
+        http: "http";
+        shell: "shell";
+    }>;
+    whatWasDone: z.ZodString;
+    resultSummary: z.ZodString;
+    artifactPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    blockers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    nextAction: z.ZodString;
+    costLine: z.ZodString;
+}, z.core.$strip>;
+export type RunManagerReport = z.infer<typeof RunManagerReportSchema>;
+export declare const RunCompletionReportSchema: z.ZodObject<{
+    finalStatus: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+    }>;
+    completionReason: z.ZodEnum<{
+        blocked: "blocked";
+        unknown: "unknown";
+        task_completed: "task_completed";
+        no_assigned_work: "no_assigned_work";
+        provider_rate_limited: "provider_rate_limited";
+        provider_out_of_funds: "provider_out_of_funds";
+        provider_quota_exhausted: "provider_quota_exhausted";
+        auth_error: "auth_error";
+        timeout: "timeout";
+        cancelled: "cancelled";
+        contract_invalid: "contract_invalid";
+        runtime_error: "runtime_error";
+        runtime_missing: "runtime_missing";
+        budget_hard_stop: "budget_hard_stop";
+        overlap_in_progress: "overlap_in_progress";
+        provider_unavailable: "provider_unavailable";
+    }>;
+    statusHeadline: z.ZodString;
+    summary: z.ZodString;
+    employeeComment: z.ZodString;
+    results: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    errors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    resultStatus: z.ZodDefault<z.ZodEnum<{
+        reported: "reported";
+        none_reported: "none_reported";
+    }>>;
+    resultSummary: z.ZodString;
+    issueIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        kind: z.ZodString;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        relativePath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        absolutePath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    blockers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    nextAction: z.ZodString;
+    cost: z.ZodObject<{
+        tokenInput: z.ZodDefault<z.ZodNumber>;
+        tokenOutput: z.ZodDefault<z.ZodNumber>;
+        usdCost: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        usdCostStatus: z.ZodDefault<z.ZodEnum<{
+            unknown: "unknown";
+            exact: "exact";
+            estimated: "estimated";
+        }>>;
+        pricingSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    managerReport: z.ZodObject<{
+        agentName: z.ZodString;
+        providerType: z.ZodEnum<{
+            claude_code: "claude_code";
+            codex: "codex";
+            cursor: "cursor";
+            opencode: "opencode";
+            gemini_cli: "gemini_cli";
+            openai_api: "openai_api";
+            anthropic_api: "anthropic_api";
+            http: "http";
+            shell: "shell";
+        }>;
+        whatWasDone: z.ZodString;
+        resultSummary: z.ZodString;
+        artifactPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        blockers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        nextAction: z.ZodString;
+        costLine: z.ZodString;
+    }, z.core.$strip>;
+    outcome: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            blocked: "blocked";
+            completed: "completed";
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        issueIdsTouched: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            kind: z.ZodString;
+        }, z.core.$strip>>>;
+        actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            targetId: z.ZodOptional<z.ZodString>;
+            status: z.ZodEnum<{
+                error: "error";
+                ok: "ok";
+                warn: "warn";
+            }>;
+            detail: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        blockers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        nextSuggestedState: z.ZodOptional<z.ZodEnum<{
+            blocked: "blocked";
+            todo: "todo";
+            in_progress: "in_progress";
+            in_review: "in_review";
+            done: "done";
+        }>>;
+    }, z.core.$strip>>>;
+    debug: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        persistedRunStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        failureType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        errorType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        errorMessage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type RunCompletionReport = z.infer<typeof RunCompletionReportSchema>;
 export declare const ThinkingEffortSchema: z.ZodEnum<{
     low: "low";
     medium: "medium";
@@ -1685,7 +2074,21 @@ export declare const PluginInvocationResultSchema: z.ZodObject<{
 export type PluginInvocationResult = z.infer<typeof PluginInvocationResultSchema>;
 export declare const AgentCreateRequestSchema: z.ZodObject<{
     managerAgentId: z.ZodOptional<z.ZodString>;
-    role: z.ZodString;
+    role: z.ZodOptional<z.ZodString>;
+    roleKey: z.ZodOptional<z.ZodEnum<{
+        ceo: "ceo";
+        cto: "cto";
+        cmo: "cmo";
+        cfo: "cfo";
+        engineer: "engineer";
+        designer: "designer";
+        pm: "pm";
+        qa: "qa";
+        devops: "devops";
+        researcher: "researcher";
+        general: "general";
+    }>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodString;
     providerType: z.ZodEnum<{
         claude_code: "claude_code";
@@ -1706,6 +2109,20 @@ export declare const AgentCreateRequestSchema: z.ZodObject<{
     delegationIntent: z.ZodOptional<z.ZodObject<{
         intentType: z.ZodLiteral<"agent_hiring_request">;
         requestedRole: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        requestedRoleKey: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            ceo: "ceo";
+            cto: "cto";
+            cmo: "cmo";
+            cfo: "cfo";
+            engineer: "engineer";
+            designer: "designer";
+            pm: "pm";
+            qa: "qa";
+            devops: "devops";
+            researcher: "researcher";
+            general: "general";
+        }>>>;
+        requestedTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         requestedName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         requestedManagerAgentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         requestedProviderType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
@@ -1750,6 +2167,20 @@ export type AgentCreateRequest = z.infer<typeof AgentCreateRequestSchema>;
 export declare const AgentUpdateRequestSchema: z.ZodObject<{
     managerAgentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     role: z.ZodOptional<z.ZodString>;
+    roleKey: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        ceo: "ceo";
+        cto: "cto";
+        cmo: "cmo";
+        cfo: "cfo";
+        engineer: "engineer";
+        designer: "designer";
+        pm: "pm";
+        qa: "qa";
+        devops: "devops";
+        researcher: "researcher";
+        general: "general";
+    }>>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodOptional<z.ZodString>;
     providerType: z.ZodOptional<z.ZodEnum<{
         claude_code: "claude_code";
@@ -1801,6 +2232,20 @@ export declare const AgentSchema: z.ZodObject<{
     companyId: z.ZodString;
     managerAgentId: z.ZodNullable<z.ZodString>;
     role: z.ZodString;
+    roleKey: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        ceo: "ceo";
+        cto: "cto";
+        cmo: "cmo";
+        cfo: "cfo";
+        engineer: "engineer";
+        designer: "designer";
+        pm: "pm";
+        qa: "qa";
+        devops: "devops";
+        researcher: "researcher";
+        general: "general";
+    }>>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodString;
     providerType: z.ZodEnum<{
         claude_code: "claude_code";
@@ -2022,6 +2467,242 @@ export declare const GovernanceInboxResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type GovernanceInboxResponse = z.infer<typeof GovernanceInboxResponseSchema>;
+export declare const BoardAttentionCategorySchema: z.ZodEnum<{
+    budget_hard_stop: "budget_hard_stop";
+    approval_required: "approval_required";
+    blocker_escalation: "blocker_escalation";
+    stalled_work: "stalled_work";
+    run_failure_spike: "run_failure_spike";
+    board_mentioned_comment: "board_mentioned_comment";
+}>;
+export type BoardAttentionCategory = z.infer<typeof BoardAttentionCategorySchema>;
+export declare const BoardAttentionSeveritySchema: z.ZodEnum<{
+    info: "info";
+    warning: "warning";
+    critical: "critical";
+}>;
+export type BoardAttentionSeverity = z.infer<typeof BoardAttentionSeveritySchema>;
+export declare const BoardAttentionRequiredActorSchema: z.ZodEnum<{
+    agent: "agent";
+    system: "system";
+    board: "board";
+    member: "member";
+}>;
+export type BoardAttentionRequiredActor = z.infer<typeof BoardAttentionRequiredActorSchema>;
+export declare const BoardAttentionStateSchema: z.ZodEnum<{
+    open: "open";
+    acknowledged: "acknowledged";
+    resolved: "resolved";
+    dismissed: "dismissed";
+}>;
+export type BoardAttentionState = z.infer<typeof BoardAttentionStateSchema>;
+export declare const BoardAttentionEvidenceSchema: z.ZodObject<{
+    issueId: z.ZodOptional<z.ZodString>;
+    runId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    approvalId: z.ZodOptional<z.ZodString>;
+    commentId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BoardAttentionEvidence = z.infer<typeof BoardAttentionEvidenceSchema>;
+export declare const BoardAttentionItemSchema: z.ZodObject<{
+    key: z.ZodString;
+    category: z.ZodEnum<{
+        budget_hard_stop: "budget_hard_stop";
+        approval_required: "approval_required";
+        blocker_escalation: "blocker_escalation";
+        stalled_work: "stalled_work";
+        run_failure_spike: "run_failure_spike";
+        board_mentioned_comment: "board_mentioned_comment";
+    }>;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    requiredActor: z.ZodEnum<{
+        agent: "agent";
+        system: "system";
+        board: "board";
+        member: "member";
+    }>;
+    title: z.ZodString;
+    contextSummary: z.ZodString;
+    actionLabel: z.ZodString;
+    actionHref: z.ZodString;
+    impactSummary: z.ZodString;
+    evidence: z.ZodDefault<z.ZodObject<{
+        issueId: z.ZodOptional<z.ZodString>;
+        runId: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodOptional<z.ZodString>;
+        approvalId: z.ZodOptional<z.ZodString>;
+        commentId: z.ZodOptional<z.ZodString>;
+        agentId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    sourceTimestamp: z.ZodString;
+    state: z.ZodEnum<{
+        open: "open";
+        acknowledged: "acknowledged";
+        resolved: "resolved";
+        dismissed: "dismissed";
+    }>;
+    seenAt: z.ZodNullable<z.ZodString>;
+    acknowledgedAt: z.ZodNullable<z.ZodString>;
+    dismissedAt: z.ZodNullable<z.ZodString>;
+    resolvedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type BoardAttentionItem = z.infer<typeof BoardAttentionItemSchema>;
+export declare const BoardAttentionListResponseSchema: z.ZodObject<{
+    actorId: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        category: z.ZodEnum<{
+            budget_hard_stop: "budget_hard_stop";
+            approval_required: "approval_required";
+            blocker_escalation: "blocker_escalation";
+            stalled_work: "stalled_work";
+            run_failure_spike: "run_failure_spike";
+            board_mentioned_comment: "board_mentioned_comment";
+        }>;
+        severity: z.ZodEnum<{
+            info: "info";
+            warning: "warning";
+            critical: "critical";
+        }>;
+        requiredActor: z.ZodEnum<{
+            agent: "agent";
+            system: "system";
+            board: "board";
+            member: "member";
+        }>;
+        title: z.ZodString;
+        contextSummary: z.ZodString;
+        actionLabel: z.ZodString;
+        actionHref: z.ZodString;
+        impactSummary: z.ZodString;
+        evidence: z.ZodDefault<z.ZodObject<{
+            issueId: z.ZodOptional<z.ZodString>;
+            runId: z.ZodOptional<z.ZodString>;
+            projectId: z.ZodOptional<z.ZodString>;
+            approvalId: z.ZodOptional<z.ZodString>;
+            commentId: z.ZodOptional<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        sourceTimestamp: z.ZodString;
+        state: z.ZodEnum<{
+            open: "open";
+            acknowledged: "acknowledged";
+            resolved: "resolved";
+            dismissed: "dismissed";
+        }>;
+        seenAt: z.ZodNullable<z.ZodString>;
+        acknowledgedAt: z.ZodNullable<z.ZodString>;
+        dismissedAt: z.ZodNullable<z.ZodString>;
+        resolvedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BoardAttentionListResponse = z.infer<typeof BoardAttentionListResponseSchema>;
+export declare const BoardAttentionNotificationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"attention.snapshot">;
+    items: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        category: z.ZodEnum<{
+            budget_hard_stop: "budget_hard_stop";
+            approval_required: "approval_required";
+            blocker_escalation: "blocker_escalation";
+            stalled_work: "stalled_work";
+            run_failure_spike: "run_failure_spike";
+            board_mentioned_comment: "board_mentioned_comment";
+        }>;
+        severity: z.ZodEnum<{
+            info: "info";
+            warning: "warning";
+            critical: "critical";
+        }>;
+        requiredActor: z.ZodEnum<{
+            agent: "agent";
+            system: "system";
+            board: "board";
+            member: "member";
+        }>;
+        title: z.ZodString;
+        contextSummary: z.ZodString;
+        actionLabel: z.ZodString;
+        actionHref: z.ZodString;
+        impactSummary: z.ZodString;
+        evidence: z.ZodDefault<z.ZodObject<{
+            issueId: z.ZodOptional<z.ZodString>;
+            runId: z.ZodOptional<z.ZodString>;
+            projectId: z.ZodOptional<z.ZodString>;
+            approvalId: z.ZodOptional<z.ZodString>;
+            commentId: z.ZodOptional<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        sourceTimestamp: z.ZodString;
+        state: z.ZodEnum<{
+            open: "open";
+            acknowledged: "acknowledged";
+            resolved: "resolved";
+            dismissed: "dismissed";
+        }>;
+        seenAt: z.ZodNullable<z.ZodString>;
+        acknowledgedAt: z.ZodNullable<z.ZodString>;
+        dismissedAt: z.ZodNullable<z.ZodString>;
+        resolvedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"attention.updated">;
+    item: z.ZodObject<{
+        key: z.ZodString;
+        category: z.ZodEnum<{
+            budget_hard_stop: "budget_hard_stop";
+            approval_required: "approval_required";
+            blocker_escalation: "blocker_escalation";
+            stalled_work: "stalled_work";
+            run_failure_spike: "run_failure_spike";
+            board_mentioned_comment: "board_mentioned_comment";
+        }>;
+        severity: z.ZodEnum<{
+            info: "info";
+            warning: "warning";
+            critical: "critical";
+        }>;
+        requiredActor: z.ZodEnum<{
+            agent: "agent";
+            system: "system";
+            board: "board";
+            member: "member";
+        }>;
+        title: z.ZodString;
+        contextSummary: z.ZodString;
+        actionLabel: z.ZodString;
+        actionHref: z.ZodString;
+        impactSummary: z.ZodString;
+        evidence: z.ZodDefault<z.ZodObject<{
+            issueId: z.ZodOptional<z.ZodString>;
+            runId: z.ZodOptional<z.ZodString>;
+            projectId: z.ZodOptional<z.ZodString>;
+            approvalId: z.ZodOptional<z.ZodString>;
+            commentId: z.ZodOptional<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        sourceTimestamp: z.ZodString;
+        state: z.ZodEnum<{
+            open: "open";
+            acknowledged: "acknowledged";
+            resolved: "resolved";
+            dismissed: "dismissed";
+        }>;
+        seenAt: z.ZodNullable<z.ZodString>;
+        acknowledgedAt: z.ZodNullable<z.ZodString>;
+        dismissedAt: z.ZodNullable<z.ZodString>;
+        resolvedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"attention.resolved">;
+    key: z.ZodString;
+}, z.core.$strip>], "type">;
+export type BoardAttentionNotificationEvent = z.infer<typeof BoardAttentionNotificationEventSchema>;
 export declare const OfficeRoomSchema: z.ZodEnum<{
     waiting_room: "waiting_room";
     work_space: "work_space";
@@ -2338,6 +3019,7 @@ export declare const RealtimeChannelSchema: z.ZodEnum<{
     governance: "governance";
     "office-space": "office-space";
     "heartbeat-runs": "heartbeat-runs";
+    attention: "attention";
 }>;
 export type RealtimeChannel = z.infer<typeof RealtimeChannelSchema>;
 export declare const RealtimeEventEnvelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2649,6 +3331,108 @@ export declare const RealtimeEventEnvelopeSchema: z.ZodDiscriminatedUnion<[z.Zod
         }, z.core.$strip>>;
         nextCursor: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+    channel: z.ZodLiteral<"attention">;
+    event: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"attention.snapshot">;
+        items: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            category: z.ZodEnum<{
+                budget_hard_stop: "budget_hard_stop";
+                approval_required: "approval_required";
+                blocker_escalation: "blocker_escalation";
+                stalled_work: "stalled_work";
+                run_failure_spike: "run_failure_spike";
+                board_mentioned_comment: "board_mentioned_comment";
+            }>;
+            severity: z.ZodEnum<{
+                info: "info";
+                warning: "warning";
+                critical: "critical";
+            }>;
+            requiredActor: z.ZodEnum<{
+                agent: "agent";
+                system: "system";
+                board: "board";
+                member: "member";
+            }>;
+            title: z.ZodString;
+            contextSummary: z.ZodString;
+            actionLabel: z.ZodString;
+            actionHref: z.ZodString;
+            impactSummary: z.ZodString;
+            evidence: z.ZodDefault<z.ZodObject<{
+                issueId: z.ZodOptional<z.ZodString>;
+                runId: z.ZodOptional<z.ZodString>;
+                projectId: z.ZodOptional<z.ZodString>;
+                approvalId: z.ZodOptional<z.ZodString>;
+                commentId: z.ZodOptional<z.ZodString>;
+                agentId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            sourceTimestamp: z.ZodString;
+            state: z.ZodEnum<{
+                open: "open";
+                acknowledged: "acknowledged";
+                resolved: "resolved";
+                dismissed: "dismissed";
+            }>;
+            seenAt: z.ZodNullable<z.ZodString>;
+            acknowledgedAt: z.ZodNullable<z.ZodString>;
+            dismissedAt: z.ZodNullable<z.ZodString>;
+            resolvedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"attention.updated">;
+        item: z.ZodObject<{
+            key: z.ZodString;
+            category: z.ZodEnum<{
+                budget_hard_stop: "budget_hard_stop";
+                approval_required: "approval_required";
+                blocker_escalation: "blocker_escalation";
+                stalled_work: "stalled_work";
+                run_failure_spike: "run_failure_spike";
+                board_mentioned_comment: "board_mentioned_comment";
+            }>;
+            severity: z.ZodEnum<{
+                info: "info";
+                warning: "warning";
+                critical: "critical";
+            }>;
+            requiredActor: z.ZodEnum<{
+                agent: "agent";
+                system: "system";
+                board: "board";
+                member: "member";
+            }>;
+            title: z.ZodString;
+            contextSummary: z.ZodString;
+            actionLabel: z.ZodString;
+            actionHref: z.ZodString;
+            impactSummary: z.ZodString;
+            evidence: z.ZodDefault<z.ZodObject<{
+                issueId: z.ZodOptional<z.ZodString>;
+                runId: z.ZodOptional<z.ZodString>;
+                projectId: z.ZodOptional<z.ZodString>;
+                approvalId: z.ZodOptional<z.ZodString>;
+                commentId: z.ZodOptional<z.ZodString>;
+                agentId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            sourceTimestamp: z.ZodString;
+            state: z.ZodEnum<{
+                open: "open";
+                acknowledged: "acknowledged";
+                resolved: "resolved";
+                dismissed: "dismissed";
+            }>;
+            seenAt: z.ZodNullable<z.ZodString>;
+            acknowledgedAt: z.ZodNullable<z.ZodString>;
+            dismissedAt: z.ZodNullable<z.ZodString>;
+            resolvedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"attention.resolved">;
+        key: z.ZodString;
+    }, z.core.$strip>], "type">;
 }, z.core.$strip>], "channel">;
 export type RealtimeEventEnvelope = z.infer<typeof RealtimeEventEnvelopeSchema>;
 export declare const RealtimeSubscribedMessageSchema: z.ZodObject<{
@@ -2658,6 +3442,7 @@ export declare const RealtimeSubscribedMessageSchema: z.ZodObject<{
         governance: "governance";
         "office-space": "office-space";
         "heartbeat-runs": "heartbeat-runs";
+        attention: "attention";
     }>>;
 }, z.core.$strip>;
 export declare const RealtimeEventMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2975,6 +3760,110 @@ export declare const RealtimeEventMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
         }, z.core.$strip>>;
         nextCursor: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"event">;
+    companyId: z.ZodString;
+    channel: z.ZodLiteral<"attention">;
+    event: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"attention.snapshot">;
+        items: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            category: z.ZodEnum<{
+                budget_hard_stop: "budget_hard_stop";
+                approval_required: "approval_required";
+                blocker_escalation: "blocker_escalation";
+                stalled_work: "stalled_work";
+                run_failure_spike: "run_failure_spike";
+                board_mentioned_comment: "board_mentioned_comment";
+            }>;
+            severity: z.ZodEnum<{
+                info: "info";
+                warning: "warning";
+                critical: "critical";
+            }>;
+            requiredActor: z.ZodEnum<{
+                agent: "agent";
+                system: "system";
+                board: "board";
+                member: "member";
+            }>;
+            title: z.ZodString;
+            contextSummary: z.ZodString;
+            actionLabel: z.ZodString;
+            actionHref: z.ZodString;
+            impactSummary: z.ZodString;
+            evidence: z.ZodDefault<z.ZodObject<{
+                issueId: z.ZodOptional<z.ZodString>;
+                runId: z.ZodOptional<z.ZodString>;
+                projectId: z.ZodOptional<z.ZodString>;
+                approvalId: z.ZodOptional<z.ZodString>;
+                commentId: z.ZodOptional<z.ZodString>;
+                agentId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            sourceTimestamp: z.ZodString;
+            state: z.ZodEnum<{
+                open: "open";
+                acknowledged: "acknowledged";
+                resolved: "resolved";
+                dismissed: "dismissed";
+            }>;
+            seenAt: z.ZodNullable<z.ZodString>;
+            acknowledgedAt: z.ZodNullable<z.ZodString>;
+            dismissedAt: z.ZodNullable<z.ZodString>;
+            resolvedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"attention.updated">;
+        item: z.ZodObject<{
+            key: z.ZodString;
+            category: z.ZodEnum<{
+                budget_hard_stop: "budget_hard_stop";
+                approval_required: "approval_required";
+                blocker_escalation: "blocker_escalation";
+                stalled_work: "stalled_work";
+                run_failure_spike: "run_failure_spike";
+                board_mentioned_comment: "board_mentioned_comment";
+            }>;
+            severity: z.ZodEnum<{
+                info: "info";
+                warning: "warning";
+                critical: "critical";
+            }>;
+            requiredActor: z.ZodEnum<{
+                agent: "agent";
+                system: "system";
+                board: "board";
+                member: "member";
+            }>;
+            title: z.ZodString;
+            contextSummary: z.ZodString;
+            actionLabel: z.ZodString;
+            actionHref: z.ZodString;
+            impactSummary: z.ZodString;
+            evidence: z.ZodDefault<z.ZodObject<{
+                issueId: z.ZodOptional<z.ZodString>;
+                runId: z.ZodOptional<z.ZodString>;
+                projectId: z.ZodOptional<z.ZodString>;
+                approvalId: z.ZodOptional<z.ZodString>;
+                commentId: z.ZodOptional<z.ZodString>;
+                agentId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            sourceTimestamp: z.ZodString;
+            state: z.ZodEnum<{
+                open: "open";
+                acknowledged: "acknowledged";
+                resolved: "resolved";
+                dismissed: "dismissed";
+            }>;
+            seenAt: z.ZodNullable<z.ZodString>;
+            acknowledgedAt: z.ZodNullable<z.ZodString>;
+            dismissedAt: z.ZodNullable<z.ZodString>;
+            resolvedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"attention.resolved">;
+        key: z.ZodString;
+    }, z.core.$strip>], "type">;
 }, z.core.$strip>], "channel">;
 export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodLiteral<"subscribed">;
@@ -2983,6 +3872,7 @@ export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
         governance: "governance";
         "office-space": "office-space";
         "heartbeat-runs": "heartbeat-runs";
+        attention: "attention";
     }>>;
 }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"event">;
@@ -3299,11 +4189,116 @@ export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
         }, z.core.$strip>>;
         nextCursor: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"event">;
+    companyId: z.ZodString;
+    channel: z.ZodLiteral<"attention">;
+    event: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"attention.snapshot">;
+        items: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            category: z.ZodEnum<{
+                budget_hard_stop: "budget_hard_stop";
+                approval_required: "approval_required";
+                blocker_escalation: "blocker_escalation";
+                stalled_work: "stalled_work";
+                run_failure_spike: "run_failure_spike";
+                board_mentioned_comment: "board_mentioned_comment";
+            }>;
+            severity: z.ZodEnum<{
+                info: "info";
+                warning: "warning";
+                critical: "critical";
+            }>;
+            requiredActor: z.ZodEnum<{
+                agent: "agent";
+                system: "system";
+                board: "board";
+                member: "member";
+            }>;
+            title: z.ZodString;
+            contextSummary: z.ZodString;
+            actionLabel: z.ZodString;
+            actionHref: z.ZodString;
+            impactSummary: z.ZodString;
+            evidence: z.ZodDefault<z.ZodObject<{
+                issueId: z.ZodOptional<z.ZodString>;
+                runId: z.ZodOptional<z.ZodString>;
+                projectId: z.ZodOptional<z.ZodString>;
+                approvalId: z.ZodOptional<z.ZodString>;
+                commentId: z.ZodOptional<z.ZodString>;
+                agentId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            sourceTimestamp: z.ZodString;
+            state: z.ZodEnum<{
+                open: "open";
+                acknowledged: "acknowledged";
+                resolved: "resolved";
+                dismissed: "dismissed";
+            }>;
+            seenAt: z.ZodNullable<z.ZodString>;
+            acknowledgedAt: z.ZodNullable<z.ZodString>;
+            dismissedAt: z.ZodNullable<z.ZodString>;
+            resolvedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"attention.updated">;
+        item: z.ZodObject<{
+            key: z.ZodString;
+            category: z.ZodEnum<{
+                budget_hard_stop: "budget_hard_stop";
+                approval_required: "approval_required";
+                blocker_escalation: "blocker_escalation";
+                stalled_work: "stalled_work";
+                run_failure_spike: "run_failure_spike";
+                board_mentioned_comment: "board_mentioned_comment";
+            }>;
+            severity: z.ZodEnum<{
+                info: "info";
+                warning: "warning";
+                critical: "critical";
+            }>;
+            requiredActor: z.ZodEnum<{
+                agent: "agent";
+                system: "system";
+                board: "board";
+                member: "member";
+            }>;
+            title: z.ZodString;
+            contextSummary: z.ZodString;
+            actionLabel: z.ZodString;
+            actionHref: z.ZodString;
+            impactSummary: z.ZodString;
+            evidence: z.ZodDefault<z.ZodObject<{
+                issueId: z.ZodOptional<z.ZodString>;
+                runId: z.ZodOptional<z.ZodString>;
+                projectId: z.ZodOptional<z.ZodString>;
+                approvalId: z.ZodOptional<z.ZodString>;
+                commentId: z.ZodOptional<z.ZodString>;
+                agentId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            sourceTimestamp: z.ZodString;
+            state: z.ZodEnum<{
+                open: "open";
+                acknowledged: "acknowledged";
+                resolved: "resolved";
+                dismissed: "dismissed";
+            }>;
+            seenAt: z.ZodNullable<z.ZodString>;
+            acknowledgedAt: z.ZodNullable<z.ZodString>;
+            dismissedAt: z.ZodNullable<z.ZodString>;
+            resolvedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"attention.resolved">;
+        key: z.ZodString;
+    }, z.core.$strip>], "type">;
 }, z.core.$strip>], "channel">]>;
 export type RealtimeMessage = z.infer<typeof RealtimeMessageSchema>;
 export declare const CostLedgerEntrySchema: z.ZodObject<{
     id: z.ZodString;
     companyId: z.ZodString;
+    runId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     projectId: z.ZodNullable<z.ZodString>;
     issueId: z.ZodNullable<z.ZodString>;
     agentId: z.ZodNullable<z.ZodString>;
@@ -3333,6 +4328,11 @@ export declare const CostLedgerEntrySchema: z.ZodObject<{
     tokenInput: z.ZodNumber;
     tokenOutput: z.ZodNumber;
     usdCost: z.ZodNumber;
+    usdCostStatus: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        unknown: "unknown";
+        exact: "exact";
+        estimated: "estimated";
+    }>>>;
     createdAt: z.ZodString;
 }, z.core.$strip>;
 export declare const AuditEventSchema: z.ZodObject<{
@@ -3361,6 +4361,11 @@ export declare const HeartbeatRunSchema: z.ZodObject<{
         skipped: "skipped";
         started: "started";
     }>;
+    publicStatus: z.ZodOptional<z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        started: "started";
+    }>>;
     startedAt: z.ZodString;
     finishedAt: z.ZodNullable<z.ZodString>;
     message: z.ZodOptional<z.ZodString>;
@@ -3444,6 +4449,11 @@ export declare const HeartbeatRunDetailSchema: z.ZodObject<{
             skipped: "skipped";
             started: "started";
         }>;
+        publicStatus: z.ZodOptional<z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            started: "started";
+        }>>;
         startedAt: z.ZodString;
         finishedAt: z.ZodNullable<z.ZodString>;
         message: z.ZodOptional<z.ZodString>;
@@ -3489,10 +4499,132 @@ export declare const HeartbeatRunDetailSchema: z.ZodObject<{
                 done: "done";
             }>>;
         }, z.core.$strip>>>;
+        report: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            finalStatus: z.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+            }>;
+            completionReason: z.ZodEnum<{
+                blocked: "blocked";
+                unknown: "unknown";
+                task_completed: "task_completed";
+                no_assigned_work: "no_assigned_work";
+                provider_rate_limited: "provider_rate_limited";
+                provider_out_of_funds: "provider_out_of_funds";
+                provider_quota_exhausted: "provider_quota_exhausted";
+                auth_error: "auth_error";
+                timeout: "timeout";
+                cancelled: "cancelled";
+                contract_invalid: "contract_invalid";
+                runtime_error: "runtime_error";
+                runtime_missing: "runtime_missing";
+                budget_hard_stop: "budget_hard_stop";
+                overlap_in_progress: "overlap_in_progress";
+                provider_unavailable: "provider_unavailable";
+            }>;
+            statusHeadline: z.ZodString;
+            summary: z.ZodString;
+            employeeComment: z.ZodString;
+            results: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            errors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            resultStatus: z.ZodDefault<z.ZodEnum<{
+                reported: "reported";
+                none_reported: "none_reported";
+            }>>;
+            resultSummary: z.ZodString;
+            issueIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                kind: z.ZodString;
+                label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                relativePath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                absolutePath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+            blockers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            nextAction: z.ZodString;
+            cost: z.ZodObject<{
+                tokenInput: z.ZodDefault<z.ZodNumber>;
+                tokenOutput: z.ZodDefault<z.ZodNumber>;
+                usdCost: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                usdCostStatus: z.ZodDefault<z.ZodEnum<{
+                    unknown: "unknown";
+                    exact: "exact";
+                    estimated: "estimated";
+                }>>;
+                pricingSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>;
+            managerReport: z.ZodObject<{
+                agentName: z.ZodString;
+                providerType: z.ZodEnum<{
+                    claude_code: "claude_code";
+                    codex: "codex";
+                    cursor: "cursor";
+                    opencode: "opencode";
+                    gemini_cli: "gemini_cli";
+                    openai_api: "openai_api";
+                    anthropic_api: "anthropic_api";
+                    http: "http";
+                    shell: "shell";
+                }>;
+                whatWasDone: z.ZodString;
+                resultSummary: z.ZodString;
+                artifactPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                blockers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                nextAction: z.ZodString;
+                costLine: z.ZodString;
+            }, z.core.$strip>;
+            outcome: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    blocked: "blocked";
+                    completed: "completed";
+                    failed: "failed";
+                    skipped: "skipped";
+                }>;
+                issueIdsTouched: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    kind: z.ZodString;
+                }, z.core.$strip>>>;
+                actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    targetId: z.ZodOptional<z.ZodString>;
+                    status: z.ZodEnum<{
+                        error: "error";
+                        ok: "ok";
+                        warn: "warn";
+                    }>;
+                    detail: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>>;
+                blockers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    code: z.ZodString;
+                    message: z.ZodString;
+                    retryable: z.ZodBoolean;
+                }, z.core.$strip>>>;
+                nextSuggestedState: z.ZodOptional<z.ZodEnum<{
+                    blocked: "blocked";
+                    todo: "todo";
+                    in_progress: "in_progress";
+                    in_review: "in_review";
+                    done: "done";
+                }>>;
+            }, z.core.$strip>>>;
+            debug: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                persistedRunStatus: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                failureType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                errorType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                errorMessage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
         usage: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             tokenInput: z.ZodOptional<z.ZodNumber>;
             tokenOutput: z.ZodOptional<z.ZodNumber>;
             usdCost: z.ZodOptional<z.ZodNumber>;
+            usdCostStatus: z.ZodOptional<z.ZodEnum<{
+                unknown: "unknown";
+                exact: "exact";
+                estimated: "estimated";
+            }>>;
             source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>>;
         trace: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;