bopodev-agent-sdk 0.1.12 → 0.1.13

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

@@ -70,10 +70,28 @@ export declare const IssueSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
+export declare const IssueAttachmentSchema: z.ZodObject<{
+    id: z.ZodString;
+    companyId: z.ZodString;
+    issueId: z.ZodString;
+    projectId: z.ZodString;
+    fileName: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fileSizeBytes: z.ZodNumber;
+    relativePath: z.ZodString;
+    uploadedByActorType: z.ZodEnum<{
+        human: "human";
+        agent: "agent";
+        system: "system";
+    }>;
+    uploadedByActorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type IssueAttachment = z.infer<typeof IssueAttachmentSchema>;
 export declare const GoalLevelSchema: z.ZodEnum<{
+    agent: "agent";
     company: "company";
     project: "project";
-    agent: "agent";
 }>;
 export declare const GoalSchema: z.ZodObject<{
     id: z.ZodString;
@@ -81,9 +99,9 @@ export declare const GoalSchema: z.ZodObject<{
     projectId: z.ZodNullable<z.ZodString>;
     parentGoalId: z.ZodNullable<z.ZodString>;
     level: z.ZodEnum<{
+        agent: "agent";
         company: "company";
         project: "project";
-        agent: "agent";
     }>;
     title: z.ZodString;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -107,6 +125,8 @@ export declare const ProviderTypeSchema: z.ZodEnum<{
     codex: "codex";
     cursor: "cursor";
     opencode: "opencode";
+    openai_api: "openai_api";
+    anthropic_api: "anthropic_api";
     http: "http";
     shell: "shell";
 }>;
@@ -266,6 +286,148 @@ export declare const AgentRuntimeConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type AgentRuntimeConfig = z.infer<typeof AgentRuntimeConfigSchema>;
+export declare const PluginKindSchema: z.ZodEnum<{
+    lifecycle: "lifecycle";
+    tool: "tool";
+    integration: "integration";
+}>;
+export type PluginKind = z.infer<typeof PluginKindSchema>;
+export declare const PluginHookSchema: z.ZodEnum<{
+    beforeClaim: "beforeClaim";
+    afterClaim: "afterClaim";
+    beforeAdapterExecute: "beforeAdapterExecute";
+    afterAdapterExecute: "afterAdapterExecute";
+    beforePersist: "beforePersist";
+    afterPersist: "afterPersist";
+    onError: "onError";
+}>;
+export type PluginHook = z.infer<typeof PluginHookSchema>;
+export declare const PluginCapabilitySchema: z.ZodEnum<{
+    emit_audit: "emit_audit";
+    read_memory: "read_memory";
+    write_memory: "write_memory";
+    queue_publish: "queue_publish";
+    network: "network";
+    tool_expose: "tool_expose";
+    issue_write: "issue_write";
+}>;
+export type PluginCapability = z.infer<typeof PluginCapabilitySchema>;
+export declare const PluginRuntimeTypeSchema: z.ZodEnum<{
+    http: "http";
+    builtin: "builtin";
+    stdio: "stdio";
+    prompt: "prompt";
+}>;
+export type PluginRuntimeType = z.infer<typeof PluginRuntimeTypeSchema>;
+export declare const PluginWebhookRequestSchema: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+    }>>;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type PluginWebhookRequest = z.infer<typeof PluginWebhookRequestSchema>;
+export declare const PluginTraceEventSchema: z.ZodObject<{
+    eventType: z.ZodString;
+    payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type PluginTraceEvent = z.infer<typeof PluginTraceEventSchema>;
+export declare const PluginManifestSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        lifecycle: "lifecycle";
+        tool: "tool";
+        integration: "integration";
+    }>;
+    hooks: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        beforeClaim: "beforeClaim";
+        afterClaim: "afterClaim";
+        beforeAdapterExecute: "beforeAdapterExecute";
+        afterAdapterExecute: "afterAdapterExecute";
+        beforePersist: "beforePersist";
+        afterPersist: "afterPersist";
+        onError: "onError";
+    }>>>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        emit_audit: "emit_audit";
+        read_memory: "read_memory";
+        write_memory: "write_memory";
+        queue_publish: "queue_publish";
+        network: "network";
+        tool_expose: "tool_expose";
+        issue_write: "issue_write";
+    }>>>;
+    runtime: z.ZodObject<{
+        type: z.ZodEnum<{
+            http: "http";
+            builtin: "builtin";
+            stdio: "stdio";
+            prompt: "prompt";
+        }>;
+        entrypoint: z.ZodString;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        retryCount: z.ZodDefault<z.ZodNumber>;
+        promptTemplate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    configSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    minimumBopoVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginManifest = z.infer<typeof PluginManifestSchema>;
+export declare const PluginPromptExecutionResultSchema: z.ZodObject<{
+    promptAppend: z.ZodOptional<z.ZodString>;
+    traceEvents: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        eventType: z.ZodString;
+        payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    webhookRequests: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        method: z.ZodDefault<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+        }>>;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        body: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    diagnostics: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type PluginPromptExecutionResult = z.infer<typeof PluginPromptExecutionResultSchema>;
+export declare const PluginRunStatusSchema: z.ZodEnum<{
+    blocked: "blocked";
+    failed: "failed";
+    skipped: "skipped";
+    ok: "ok";
+}>;
+export type PluginRunStatus = z.infer<typeof PluginRunStatusSchema>;
+export declare const PluginInvocationResultSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        blocked: "blocked";
+        failed: "failed";
+        skipped: "skipped";
+        ok: "ok";
+    }>;
+    summary: z.ZodDefault<z.ZodString>;
+    diagnostics: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    blockers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    metadataPatch: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type PluginInvocationResult = z.infer<typeof PluginInvocationResultSchema>;
 export declare const AgentCreateRequestSchema: z.ZodObject<{
     managerAgentId: z.ZodOptional<z.ZodString>;
     role: z.ZodString;
@@ -275,6 +437,8 @@ export declare const AgentCreateRequestSchema: z.ZodObject<{
         codex: "codex";
         cursor: "cursor";
         opencode: "opencode";
+        openai_api: "openai_api";
+        anthropic_api: "anthropic_api";
         http: "http";
         shell: "shell";
     }>;
@@ -316,6 +480,8 @@ export declare const AgentUpdateRequestSchema: z.ZodObject<{
         codex: "codex";
         cursor: "cursor";
         opencode: "opencode";
+        openai_api: "openai_api";
+        anthropic_api: "anthropic_api";
         http: "http";
         shell: "shell";
     }>>;
@@ -364,6 +530,8 @@ export declare const AgentSchema: z.ZodObject<{
         codex: "codex";
         cursor: "cursor";
         opencode: "opencode";
+        openai_api: "openai_api";
+        anthropic_api: "anthropic_api";
         http: "http";
         shell: "shell";
     }>;
@@ -601,15 +769,17 @@ export declare const OfficeOccupantSchema: z.ZodObject<{
         codex: "codex";
         cursor: "cursor";
         opencode: "opencode";
+        openai_api: "openai_api";
+        anthropic_api: "anthropic_api";
         http: "http";
         shell: "shell";
     }>>;
     avatarSeed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     focusEntityType: z.ZodNullable<z.ZodEnum<{
         agent: "agent";
+        system: "system";
         approval: "approval";
         issue: "issue";
-        system: "system";
     }>>;
     focusEntityId: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodString;
@@ -645,15 +815,17 @@ export declare const OfficeSpaceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
             codex: "codex";
             cursor: "cursor";
             opencode: "opencode";
+            openai_api: "openai_api";
+            anthropic_api: "anthropic_api";
             http: "http";
             shell: "shell";
         }>>;
         avatarSeed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         focusEntityType: z.ZodNullable<z.ZodEnum<{
             agent: "agent";
+            system: "system";
             approval: "approval";
             issue: "issue";
-            system: "system";
         }>>;
         focusEntityId: z.ZodNullable<z.ZodString>;
         updatedAt: z.ZodString;
@@ -688,15 +860,17 @@ export declare const OfficeSpaceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
             codex: "codex";
             cursor: "cursor";
             opencode: "opencode";
+            openai_api: "openai_api";
+            anthropic_api: "anthropic_api";
             http: "http";
             shell: "shell";
         }>>;
         avatarSeed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         focusEntityType: z.ZodNullable<z.ZodEnum<{
             agent: "agent";
+            system: "system";
             approval: "approval";
             issue: "issue";
-            system: "system";
         }>>;
         focusEntityId: z.ZodNullable<z.ZodString>;
         updatedAt: z.ZodString;
@@ -706,9 +880,162 @@ export declare const OfficeSpaceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     occupantId: z.ZodString;
 }, z.core.$strip>], "type">;
 export type OfficeSpaceEvent = z.infer<typeof OfficeSpaceEventSchema>;
+export declare const HeartbeatRunTranscriptEventKindSchema: z.ZodEnum<{
+    system: "system";
+    assistant: "assistant";
+    thinking: "thinking";
+    tool_call: "tool_call";
+    tool_result: "tool_result";
+    result: "result";
+    stderr: "stderr";
+}>;
+export type HeartbeatRunTranscriptEventKind = z.infer<typeof HeartbeatRunTranscriptEventKindSchema>;
+export declare const HeartbeatRunTranscriptSignalLevelSchema: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+    noise: "noise";
+}>;
+export type HeartbeatRunTranscriptSignalLevel = z.infer<typeof HeartbeatRunTranscriptSignalLevelSchema>;
+export declare const HeartbeatRunTranscriptSourceSchema: z.ZodEnum<{
+    stderr: "stderr";
+    stdout: "stdout";
+    trace_fallback: "trace_fallback";
+}>;
+export type HeartbeatRunTranscriptSource = z.infer<typeof HeartbeatRunTranscriptSourceSchema>;
+export declare const HeartbeatRunRealtimeEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"runs.snapshot">;
+    runs: z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            skipped: "skipped";
+            started: "started";
+        }>;
+        message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        startedAt: z.ZodString;
+        finishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    transcripts: z.ZodArray<z.ZodObject<{
+        runId: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            runId: z.ZodString;
+            sequence: z.ZodNumber;
+            kind: z.ZodEnum<{
+                system: "system";
+                assistant: "assistant";
+                thinking: "thinking";
+                tool_call: "tool_call";
+                tool_result: "tool_result";
+                result: "result";
+                stderr: "stderr";
+            }>;
+            label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            signalLevel: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                noise: "noise";
+            }>>;
+            groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            source: z.ZodOptional<z.ZodEnum<{
+                stderr: "stderr";
+                stdout: "stdout";
+                trace_fallback: "trace_fallback";
+            }>>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+        nextCursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"run.status.updated">;
+    runId: z.ZodString;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        skipped: "skipped";
+        started: "started";
+    }>;
+    message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    finishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"run.transcript.append">;
+    runId: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        runId: z.ZodString;
+        sequence: z.ZodNumber;
+        kind: z.ZodEnum<{
+            system: "system";
+            assistant: "assistant";
+            thinking: "thinking";
+            tool_call: "tool_call";
+            tool_result: "tool_result";
+            result: "result";
+            stderr: "stderr";
+        }>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        signalLevel: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            noise: "noise";
+        }>>;
+        groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodEnum<{
+            stderr: "stderr";
+            stdout: "stdout";
+            trace_fallback: "trace_fallback";
+        }>>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"run.transcript.snapshot">;
+    runId: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        runId: z.ZodString;
+        sequence: z.ZodNumber;
+        kind: z.ZodEnum<{
+            system: "system";
+            assistant: "assistant";
+            thinking: "thinking";
+            tool_call: "tool_call";
+            tool_result: "tool_result";
+            result: "result";
+            stderr: "stderr";
+        }>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        signalLevel: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            noise: "noise";
+        }>>;
+        groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodEnum<{
+            stderr: "stderr";
+            stdout: "stdout";
+            trace_fallback: "trace_fallback";
+        }>>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type HeartbeatRunRealtimeEvent = z.infer<typeof HeartbeatRunRealtimeEventSchema>;
 export declare const RealtimeChannelSchema: z.ZodEnum<{
     governance: "governance";
     "office-space": "office-space";
+    "heartbeat-runs": "heartbeat-runs";
 }>;
 export type RealtimeChannel = z.infer<typeof RealtimeChannelSchema>;
 export declare const RealtimeEventEnvelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -815,15 +1142,17 @@ export declare const RealtimeEventEnvelopeSchema: z.ZodDiscriminatedUnion<[z.Zod
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                openai_api: "openai_api";
+                anthropic_api: "anthropic_api";
                 http: "http";
                 shell: "shell";
             }>>;
             avatarSeed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             focusEntityType: z.ZodNullable<z.ZodEnum<{
                 agent: "agent";
+                system: "system";
                 approval: "approval";
                 issue: "issue";
-                system: "system";
             }>>;
             focusEntityId: z.ZodNullable<z.ZodString>;
             updatedAt: z.ZodString;
@@ -858,15 +1187,17 @@ export declare const RealtimeEventEnvelopeSchema: z.ZodDiscriminatedUnion<[z.Zod
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                openai_api: "openai_api";
+                anthropic_api: "anthropic_api";
                 http: "http";
                 shell: "shell";
             }>>;
             avatarSeed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             focusEntityType: z.ZodNullable<z.ZodEnum<{
                 agent: "agent";
+                system: "system";
                 approval: "approval";
                 issue: "issue";
-                system: "system";
             }>>;
             focusEntityId: z.ZodNullable<z.ZodString>;
             updatedAt: z.ZodString;
@@ -875,6 +1206,136 @@ export declare const RealtimeEventEnvelopeSchema: z.ZodDiscriminatedUnion<[z.Zod
         type: z.ZodLiteral<"office.occupant.left">;
         occupantId: z.ZodString;
     }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+    channel: z.ZodLiteral<"heartbeat-runs">;
+    event: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"runs.snapshot">;
+        runs: z.ZodArray<z.ZodObject<{
+            runId: z.ZodString;
+            status: z.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+                skipped: "skipped";
+                started: "started";
+            }>;
+            message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            startedAt: z.ZodString;
+            finishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+        transcripts: z.ZodArray<z.ZodObject<{
+            runId: z.ZodString;
+            messages: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                runId: z.ZodString;
+                sequence: z.ZodNumber;
+                kind: z.ZodEnum<{
+                    system: "system";
+                    assistant: "assistant";
+                    thinking: "thinking";
+                    tool_call: "tool_call";
+                    tool_result: "tool_result";
+                    result: "result";
+                    stderr: "stderr";
+                }>;
+                label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                signalLevel: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    noise: "noise";
+                }>>;
+                groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                source: z.ZodOptional<z.ZodEnum<{
+                    stderr: "stderr";
+                    stdout: "stdout";
+                    trace_fallback: "trace_fallback";
+                }>>;
+                createdAt: z.ZodString;
+            }, z.core.$strip>>;
+            nextCursor: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"run.status.updated">;
+        runId: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            skipped: "skipped";
+            started: "started";
+        }>;
+        message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"run.transcript.append">;
+        runId: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            runId: z.ZodString;
+            sequence: z.ZodNumber;
+            kind: z.ZodEnum<{
+                system: "system";
+                assistant: "assistant";
+                thinking: "thinking";
+                tool_call: "tool_call";
+                tool_result: "tool_result";
+                result: "result";
+                stderr: "stderr";
+            }>;
+            label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            signalLevel: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                noise: "noise";
+            }>>;
+            groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            source: z.ZodOptional<z.ZodEnum<{
+                stderr: "stderr";
+                stdout: "stdout";
+                trace_fallback: "trace_fallback";
+            }>>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"run.transcript.snapshot">;
+        runId: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            runId: z.ZodString;
+            sequence: z.ZodNumber;
+            kind: z.ZodEnum<{
+                system: "system";
+                assistant: "assistant";
+                thinking: "thinking";
+                tool_call: "tool_call";
+                tool_result: "tool_result";
+                result: "result";
+                stderr: "stderr";
+            }>;
+            label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            signalLevel: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                noise: "noise";
+            }>>;
+            groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            source: z.ZodOptional<z.ZodEnum<{
+                stderr: "stderr";
+                stdout: "stdout";
+                trace_fallback: "trace_fallback";
+            }>>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+        nextCursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>], "type">;
 }, z.core.$strip>], "channel">;
 export type RealtimeEventEnvelope = z.infer<typeof RealtimeEventEnvelopeSchema>;
 export declare const RealtimeSubscribedMessageSchema: z.ZodObject<{
@@ -883,6 +1344,7 @@ export declare const RealtimeSubscribedMessageSchema: z.ZodObject<{
     channels: z.ZodArray<z.ZodEnum<{
         governance: "governance";
         "office-space": "office-space";
+        "heartbeat-runs": "heartbeat-runs";
     }>>;
 }, z.core.$strip>;
 export declare const RealtimeEventMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -993,15 +1455,17 @@ export declare const RealtimeEventMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                openai_api: "openai_api";
+                anthropic_api: "anthropic_api";
                 http: "http";
                 shell: "shell";
             }>>;
             avatarSeed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             focusEntityType: z.ZodNullable<z.ZodEnum<{
                 agent: "agent";
+                system: "system";
                 approval: "approval";
                 issue: "issue";
-                system: "system";
             }>>;
             focusEntityId: z.ZodNullable<z.ZodString>;
             updatedAt: z.ZodString;
@@ -1036,15 +1500,17 @@ export declare const RealtimeEventMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                openai_api: "openai_api";
+                anthropic_api: "anthropic_api";
                 http: "http";
                 shell: "shell";
             }>>;
             avatarSeed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             focusEntityType: z.ZodNullable<z.ZodEnum<{
                 agent: "agent";
+                system: "system";
                 approval: "approval";
                 issue: "issue";
-                system: "system";
             }>>;
             focusEntityId: z.ZodNullable<z.ZodString>;
             updatedAt: z.ZodString;
@@ -1053,6 +1519,138 @@ export declare const RealtimeEventMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
         type: z.ZodLiteral<"office.occupant.left">;
         occupantId: z.ZodString;
     }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"event">;
+    companyId: z.ZodString;
+    channel: z.ZodLiteral<"heartbeat-runs">;
+    event: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"runs.snapshot">;
+        runs: z.ZodArray<z.ZodObject<{
+            runId: z.ZodString;
+            status: z.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+                skipped: "skipped";
+                started: "started";
+            }>;
+            message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            startedAt: z.ZodString;
+            finishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+        transcripts: z.ZodArray<z.ZodObject<{
+            runId: z.ZodString;
+            messages: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                runId: z.ZodString;
+                sequence: z.ZodNumber;
+                kind: z.ZodEnum<{
+                    system: "system";
+                    assistant: "assistant";
+                    thinking: "thinking";
+                    tool_call: "tool_call";
+                    tool_result: "tool_result";
+                    result: "result";
+                    stderr: "stderr";
+                }>;
+                label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                signalLevel: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    noise: "noise";
+                }>>;
+                groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                source: z.ZodOptional<z.ZodEnum<{
+                    stderr: "stderr";
+                    stdout: "stdout";
+                    trace_fallback: "trace_fallback";
+                }>>;
+                createdAt: z.ZodString;
+            }, z.core.$strip>>;
+            nextCursor: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"run.status.updated">;
+        runId: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            skipped: "skipped";
+            started: "started";
+        }>;
+        message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"run.transcript.append">;
+        runId: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            runId: z.ZodString;
+            sequence: z.ZodNumber;
+            kind: z.ZodEnum<{
+                system: "system";
+                assistant: "assistant";
+                thinking: "thinking";
+                tool_call: "tool_call";
+                tool_result: "tool_result";
+                result: "result";
+                stderr: "stderr";
+            }>;
+            label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            signalLevel: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                noise: "noise";
+            }>>;
+            groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            source: z.ZodOptional<z.ZodEnum<{
+                stderr: "stderr";
+                stdout: "stdout";
+                trace_fallback: "trace_fallback";
+            }>>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"run.transcript.snapshot">;
+        runId: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            runId: z.ZodString;
+            sequence: z.ZodNumber;
+            kind: z.ZodEnum<{
+                system: "system";
+                assistant: "assistant";
+                thinking: "thinking";
+                tool_call: "tool_call";
+                tool_result: "tool_result";
+                result: "result";
+                stderr: "stderr";
+            }>;
+            label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            signalLevel: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                noise: "noise";
+            }>>;
+            groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            source: z.ZodOptional<z.ZodEnum<{
+                stderr: "stderr";
+                stdout: "stdout";
+                trace_fallback: "trace_fallback";
+            }>>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+        nextCursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>], "type">;
 }, z.core.$strip>], "channel">;
 export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodLiteral<"subscribed">;
@@ -1060,6 +1658,7 @@ export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
     channels: z.ZodArray<z.ZodEnum<{
         governance: "governance";
         "office-space": "office-space";
+        "heartbeat-runs": "heartbeat-runs";
     }>>;
 }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"event">;
@@ -1169,15 +1768,17 @@ export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                openai_api: "openai_api";
+                anthropic_api: "anthropic_api";
                 http: "http";
                 shell: "shell";
             }>>;
             avatarSeed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             focusEntityType: z.ZodNullable<z.ZodEnum<{
                 agent: "agent";
+                system: "system";
                 approval: "approval";
                 issue: "issue";
-                system: "system";
             }>>;
             focusEntityId: z.ZodNullable<z.ZodString>;
             updatedAt: z.ZodString;
@@ -1212,15 +1813,17 @@ export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                openai_api: "openai_api";
+                anthropic_api: "anthropic_api";
                 http: "http";
                 shell: "shell";
             }>>;
             avatarSeed: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             focusEntityType: z.ZodNullable<z.ZodEnum<{
                 agent: "agent";
+                system: "system";
                 approval: "approval";
                 issue: "issue";
-                system: "system";
             }>>;
             focusEntityId: z.ZodNullable<z.ZodString>;
             updatedAt: z.ZodString;
@@ -1229,6 +1832,138 @@ export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"office.occupant.left">;
         occupantId: z.ZodString;
     }, z.core.$strip>], "type">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"event">;
+    companyId: z.ZodString;
+    channel: z.ZodLiteral<"heartbeat-runs">;
+    event: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"runs.snapshot">;
+        runs: z.ZodArray<z.ZodObject<{
+            runId: z.ZodString;
+            status: z.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+                skipped: "skipped";
+                started: "started";
+            }>;
+            message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            startedAt: z.ZodString;
+            finishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+        transcripts: z.ZodArray<z.ZodObject<{
+            runId: z.ZodString;
+            messages: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                runId: z.ZodString;
+                sequence: z.ZodNumber;
+                kind: z.ZodEnum<{
+                    system: "system";
+                    assistant: "assistant";
+                    thinking: "thinking";
+                    tool_call: "tool_call";
+                    tool_result: "tool_result";
+                    result: "result";
+                    stderr: "stderr";
+                }>;
+                label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                signalLevel: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    noise: "noise";
+                }>>;
+                groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                source: z.ZodOptional<z.ZodEnum<{
+                    stderr: "stderr";
+                    stdout: "stdout";
+                    trace_fallback: "trace_fallback";
+                }>>;
+                createdAt: z.ZodString;
+            }, z.core.$strip>>;
+            nextCursor: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"run.status.updated">;
+        runId: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            skipped: "skipped";
+            started: "started";
+        }>;
+        message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"run.transcript.append">;
+        runId: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            runId: z.ZodString;
+            sequence: z.ZodNumber;
+            kind: z.ZodEnum<{
+                system: "system";
+                assistant: "assistant";
+                thinking: "thinking";
+                tool_call: "tool_call";
+                tool_result: "tool_result";
+                result: "result";
+                stderr: "stderr";
+            }>;
+            label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            signalLevel: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                noise: "noise";
+            }>>;
+            groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            source: z.ZodOptional<z.ZodEnum<{
+                stderr: "stderr";
+                stdout: "stdout";
+                trace_fallback: "trace_fallback";
+            }>>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"run.transcript.snapshot">;
+        runId: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            runId: z.ZodString;
+            sequence: z.ZodNumber;
+            kind: z.ZodEnum<{
+                system: "system";
+                assistant: "assistant";
+                thinking: "thinking";
+                tool_call: "tool_call";
+                tool_result: "tool_result";
+                result: "result";
+                stderr: "stderr";
+            }>;
+            label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            signalLevel: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                noise: "noise";
+            }>>;
+            groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            source: z.ZodOptional<z.ZodEnum<{
+                stderr: "stderr";
+                stdout: "stdout";
+                trace_fallback: "trace_fallback";
+            }>>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+        nextCursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>], "type">;
 }, z.core.$strip>], "channel">]>;
 export type RealtimeMessage = z.infer<typeof RealtimeMessageSchema>;
 export declare const CostLedgerEntrySchema: z.ZodObject<{
@@ -1242,6 +1977,8 @@ export declare const CostLedgerEntrySchema: z.ZodObject<{
         codex: "codex";
         cursor: "cursor";
         opencode: "opencode";
+        openai_api: "openai_api";
+        anthropic_api: "anthropic_api";
         http: "http";
         shell: "shell";
     }>;
@@ -1254,9 +1991,9 @@ export declare const AuditEventSchema: z.ZodObject<{
     id: z.ZodString;
     companyId: z.ZodString;
     actorType: z.ZodEnum<{
+        human: "human";
         agent: "agent";
         system: "system";
-        human: "human";
     }>;
     actorId: z.ZodNullable<z.ZodString>;
     eventType: z.ZodString;
@@ -1280,6 +2017,146 @@ export declare const HeartbeatRunSchema: z.ZodObject<{
     finishedAt: z.ZodNullable<z.ZodString>;
     message: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+export declare const HeartbeatRunMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    companyId: z.ZodString;
+    runId: z.ZodString;
+    sequence: z.ZodNumber;
+    kind: z.ZodEnum<{
+        system: "system";
+        assistant: "assistant";
+        thinking: "thinking";
+        tool_call: "tool_call";
+        tool_result: "tool_result";
+        result: "result";
+        stderr: "stderr";
+    }>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    signalLevel: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        noise: "noise";
+    }>>;
+    groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source: z.ZodOptional<z.ZodEnum<{
+        stderr: "stderr";
+        stdout: "stdout";
+        trace_fallback: "trace_fallback";
+    }>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type HeartbeatRunMessage = z.infer<typeof HeartbeatRunMessageSchema>;
+export declare const ListHeartbeatRunMessagesResponseSchema: z.ZodObject<{
+    runId: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        companyId: z.ZodString;
+        runId: z.ZodString;
+        sequence: z.ZodNumber;
+        kind: z.ZodEnum<{
+            system: "system";
+            assistant: "assistant";
+            thinking: "thinking";
+            tool_call: "tool_call";
+            tool_result: "tool_result";
+            result: "result";
+            stderr: "stderr";
+        }>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        payload: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        signalLevel: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            noise: "noise";
+        }>>;
+        groupKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodEnum<{
+            stderr: "stderr";
+            stdout: "stdout";
+            trace_fallback: "trace_fallback";
+        }>>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ListHeartbeatRunMessagesResponse = z.infer<typeof ListHeartbeatRunMessagesResponseSchema>;
+export declare const HeartbeatRunDetailSchema: z.ZodObject<{
+    run: z.ZodObject<{
+        id: z.ZodString;
+        companyId: z.ZodString;
+        agentId: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            skipped: "skipped";
+            started: "started";
+        }>;
+        startedAt: z.ZodString;
+        finishedAt: z.ZodNullable<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    details: z.ZodNullable<z.ZodObject<{
+        status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        errorMessage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        result: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        issueIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        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>>>;
+        usage: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            tokenInput: z.ZodOptional<z.ZodNumber>;
+            tokenOutput: z.ZodOptional<z.ZodNumber>;
+            usdCost: z.ZodOptional<z.ZodNumber>;
+            source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        trace: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        diagnostics: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
+    transcript: z.ZodObject<{
+        hasPersistedMessages: z.ZodBoolean;
+        fallbackFromTrace: z.ZodBoolean;
+        truncated: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type HeartbeatRunDetail = z.infer<typeof HeartbeatRunDetailSchema>;
 export declare const PaginatedSchema: <T extends z.ZodTypeAny>(item: T) => z.ZodObject<{
     items: z.ZodArray<T>;
     nextCursor: z.ZodNullable<z.ZodString>;