@kitman-sh/loops 0.0.0-stage → 0.7.0

package/types/packages/core/src/run.d.ts

@@ -0,0 +1,566 @@
+import * as Schema from 'effect/Schema';
+export declare const RunContractVersion: Schema.Literal<"run.v1">;
+export type RunContractVersion = (typeof RunContractVersion)['Type'];
+export type SafeJson = null | boolean | number | string | readonly SafeJson[] | {
+    readonly [key: string]: SafeJson;
+};
+export declare const SafeJson: Schema.Codec<SafeJson>;
+export declare const RunActorRef: Schema.Struct<{
+    readonly actorType: Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>, Schema.Literal<"runner">]>;
+    readonly actorId: Schema.String;
+    readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+    readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+    readonly runnerId: Schema.optionalKey<Schema.String>;
+}>;
+export type RunActorRef = (typeof RunActorRef)['Type'];
+export declare const RunResourceRef: Schema.Struct<{
+    readonly kind: Schema.String;
+    readonly id: Schema.String;
+}>;
+export type RunResourceRef = (typeof RunResourceRef)['Type'];
+export declare const RunSchemaRef: Schema.Struct<{
+    readonly kind: Schema.Literal<"typebox_ref">;
+    readonly name: Schema.String;
+    readonly version: Schema.String;
+    readonly sha256: Schema.String;
+}>;
+export type RunSchemaRef = (typeof RunSchemaRef)['Type'];
+export declare const AgentPinnedKitRef: Schema.Struct<{
+    readonly kitId: Schema.String;
+    readonly version: Schema.Int;
+    readonly sha256: Schema.String;
+    readonly precedence: Schema.Int;
+    readonly required: Schema.Boolean;
+}>;
+export type AgentPinnedKitRef = (typeof AgentPinnedKitRef)['Type'];
+export declare const AgentSkillRef: Schema.Struct<{
+    readonly sourceId: Schema.String;
+    readonly name: Schema.String;
+    readonly version: Schema.optionalKey<Schema.String>;
+    readonly sha256: Schema.optionalKey<Schema.String>;
+    readonly required: Schema.Boolean;
+}>;
+export type AgentSkillRef = (typeof AgentSkillRef)['Type'];
+export declare const AgentReference: Schema.Union<readonly [Schema.Struct<{
+    readonly agentId: Schema.String;
+    readonly alias: Schema.String;
+}>, Schema.Struct<{
+    readonly agentId: Schema.String;
+    readonly version: Schema.Int;
+    readonly digest: Schema.String;
+}>]>;
+export type AgentReference = (typeof AgentReference)['Type'];
+export declare const AgentToolGrant: Schema.Struct<{
+    readonly ref: Schema.String;
+    readonly inputSchema: Schema.optionalKey<Schema.Struct<{
+        readonly kind: Schema.Literal<"typebox_ref">;
+        readonly name: Schema.String;
+        readonly version: Schema.String;
+        readonly sha256: Schema.String;
+    }>>;
+    readonly scope: Schema.optionalKey<Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly id: Schema.String;
+    }>>;
+    readonly approval: Schema.Union<readonly [Schema.Literal<"none">, Schema.Literal<"human_each_call">, Schema.Literal<"human_once">]>;
+    readonly delegable: Schema.Boolean;
+}>;
+export type AgentToolGrant = (typeof AgentToolGrant)['Type'];
+export declare const AgentHarnessSelector: Schema.Struct<{
+    readonly mode: Schema.Union<readonly [Schema.Literal<"direct_model">, Schema.Literal<"harness_v1">, Schema.Literal<"native">]>;
+    readonly harness: Schema.optionalKey<Schema.String>;
+    readonly adapterRef: Schema.optionalKey<Schema.String>;
+    readonly requiredCapabilities: Schema.$Array<Schema.String>;
+    readonly allowedFallbacks: Schema.$Array<Schema.String>;
+}>;
+export type AgentHarnessSelector = (typeof AgentHarnessSelector)['Type'];
+export declare const AgentModelSelector: Schema.Struct<{
+    readonly providerRef: Schema.String;
+    readonly modelRef: Schema.String;
+    readonly profile: Schema.optionalKey<Schema.String>;
+    readonly reasoning: Schema.optionalKey<Schema.String>;
+}>;
+export type AgentModelSelector = (typeof AgentModelSelector)['Type'];
+export declare const AgentPolicy: Schema.Struct<{
+    readonly requestedCapabilities: Schema.$Array<Schema.String>;
+    readonly maxChildDepth: Schema.Int;
+    readonly allowSubdelegation: Schema.Boolean;
+    readonly maxWallSeconds: Schema.optionalKey<Schema.Int>;
+    readonly maxInputTokens: Schema.optionalKey<Schema.Int>;
+    readonly maxOutputTokens: Schema.optionalKey<Schema.Int>;
+    readonly hardLimit: Schema.Boolean;
+}>;
+export type AgentPolicy = (typeof AgentPolicy)['Type'];
+export declare const AgentProvenance: Schema.Struct<{
+    readonly source: Schema.Union<readonly [Schema.Literal<"kitman">, Schema.Literal<"workspace">, Schema.Literal<"project">, Schema.Literal<"git">, Schema.Literal<"package">, Schema.Literal<"import">]>;
+    readonly sourceRef: Schema.optionalKey<Schema.String>;
+    readonly sourceCommitSha: Schema.optionalKey<Schema.String>;
+    readonly contentSha256: Schema.String;
+    readonly reviewedBy: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly actorType: Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>, Schema.Literal<"runner">]>;
+        readonly actorId: Schema.String;
+        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+        readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+        readonly runnerId: Schema.optionalKey<Schema.String>;
+    }>>>;
+}>;
+export type AgentProvenance = (typeof AgentProvenance)['Type'];
+export declare const Agent: Schema.Struct<{
+    readonly contractVersion: Schema.Literal<"run.v1">;
+    readonly id: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly name: Schema.String;
+    readonly slug: Schema.String;
+    readonly currentVersion: Schema.optionalKey<Schema.Int>;
+    readonly status: Schema.Union<readonly [Schema.Literal<"draft">, Schema.Literal<"published">, Schema.Literal<"deprecated">, Schema.Literal<"disabled">, Schema.Literal<"archived">]>;
+    readonly createdBy: Schema.Struct<{
+        readonly actorType: Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>, Schema.Literal<"runner">]>;
+        readonly actorId: Schema.String;
+        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+        readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+        readonly runnerId: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+}>;
+export type Agent = (typeof Agent)['Type'];
+export declare const RunMessagePayload: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"progress">;
+    readonly summary: Schema.String;
+    readonly phase: Schema.optionalKey<Schema.String>;
+    readonly percent: Schema.optionalKey<Schema.Finite>;
+    readonly evidenceRefs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly id: Schema.String;
+    }>>>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"question">;
+    readonly questionId: Schema.String;
+    readonly prompt: Schema.String;
+    readonly answerSchema: Schema.Struct<{
+        readonly kind: Schema.Literal<"typebox_ref">;
+        readonly name: Schema.String;
+        readonly version: Schema.String;
+        readonly sha256: Schema.String;
+    }>;
+    readonly urgency: Schema.Union<readonly [Schema.Literal<"normal">, Schema.Literal<"blocking">]>;
+    readonly waitId: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"answer">;
+    readonly questionId: Schema.String;
+    readonly answer: Schema.Codec<SafeJson, SafeJson, never, never>;
+    readonly answerSchema: Schema.Struct<{
+        readonly kind: Schema.Literal<"typebox_ref">;
+        readonly name: Schema.String;
+        readonly version: Schema.String;
+        readonly sha256: Schema.String;
+    }>;
+    readonly waitId: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"context_request">;
+    readonly requestId: Schema.String;
+    readonly refs: Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly id: Schema.String;
+    }>>;
+    readonly reason: Schema.String;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"context_response">;
+    readonly requestId: Schema.String;
+    readonly refs: Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly id: Schema.String;
+    }>>;
+    readonly summaries: Schema.$Array<Schema.Codec<SafeJson, SafeJson, never, never>>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"finding">;
+    readonly severity: Schema.Union<readonly [Schema.Literal<"info">, Schema.Literal<"low">, Schema.Literal<"medium">, Schema.Literal<"high">, Schema.Literal<"critical">]>;
+    readonly category: Schema.String;
+    readonly summary: Schema.String;
+    readonly evidenceRefs: Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly id: Schema.String;
+    }>>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"partial_result">;
+    readonly outputSchema: Schema.Struct<{
+        readonly kind: Schema.Literal<"typebox_ref">;
+        readonly name: Schema.String;
+        readonly version: Schema.String;
+        readonly sha256: Schema.String;
+    }>;
+    readonly data: Schema.Codec<SafeJson, SafeJson, never, never>;
+    readonly complete: Schema.Literal<false>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"handoff">;
+    readonly summary: Schema.String;
+    readonly nextAction: Schema.optionalKey<Schema.String>;
+    readonly evidenceRefs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly id: Schema.String;
+    }>>>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"instruction">;
+    readonly instruction: Schema.String;
+    readonly authority: Schema.Union<readonly [Schema.Literal<"normal">, Schema.Literal<"operator">]>;
+}>, Schema.Struct<{
+    readonly type: Schema.Literal<"notice">;
+    readonly code: Schema.String;
+    readonly summary: Schema.String;
+}>]>;
+export type RunMessagePayload = (typeof RunMessagePayload)['Type'];
+export declare const RunMessage: Schema.Struct<{
+    readonly contractVersion: Schema.Literal<"run.v1">;
+    readonly id: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly rootRunId: Schema.String;
+    readonly sender: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Union<readonly [Schema.Literal<"run">, Schema.Literal<"step_attempt">]>;
+        readonly id: Schema.String;
+    }>, Schema.Struct<{
+        readonly actorType: Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>, Schema.Literal<"runner">]>;
+        readonly actorId: Schema.String;
+        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+        readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+        readonly runnerId: Schema.optionalKey<Schema.String>;
+    }>]>;
+    readonly recipient: Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly id: Schema.String;
+    }>;
+    readonly type: Schema.Literals<readonly ["progress", "question", "answer", "context_request", "context_response", "finding", "partial_result", "handoff", "instruction", "notice"]>;
+    readonly streamKey: Schema.String;
+    readonly sequence: Schema.Int;
+    readonly correlationId: Schema.optionalKey<Schema.String>;
+    readonly causationId: Schema.optionalKey<Schema.String>;
+    readonly replyToMessageId: Schema.optionalKey<Schema.String>;
+    readonly payloadSchema: Schema.optionalKey<Schema.Struct<{
+        readonly kind: Schema.Literal<"typebox_ref">;
+        readonly name: Schema.String;
+        readonly version: Schema.String;
+        readonly sha256: Schema.String;
+    }>>;
+    readonly payload: Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"progress">;
+        readonly summary: Schema.String;
+        readonly phase: Schema.optionalKey<Schema.String>;
+        readonly percent: Schema.optionalKey<Schema.Finite>;
+        readonly evidenceRefs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.String;
+            readonly id: Schema.String;
+        }>>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"question">;
+        readonly questionId: Schema.String;
+        readonly prompt: Schema.String;
+        readonly answerSchema: Schema.Struct<{
+            readonly kind: Schema.Literal<"typebox_ref">;
+            readonly name: Schema.String;
+            readonly version: Schema.String;
+            readonly sha256: Schema.String;
+        }>;
+        readonly urgency: Schema.Union<readonly [Schema.Literal<"normal">, Schema.Literal<"blocking">]>;
+        readonly waitId: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"answer">;
+        readonly questionId: Schema.String;
+        readonly answer: Schema.Codec<SafeJson, SafeJson, never, never>;
+        readonly answerSchema: Schema.Struct<{
+            readonly kind: Schema.Literal<"typebox_ref">;
+            readonly name: Schema.String;
+            readonly version: Schema.String;
+            readonly sha256: Schema.String;
+        }>;
+        readonly waitId: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"context_request">;
+        readonly requestId: Schema.String;
+        readonly refs: Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.String;
+            readonly id: Schema.String;
+        }>>;
+        readonly reason: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"context_response">;
+        readonly requestId: Schema.String;
+        readonly refs: Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.String;
+            readonly id: Schema.String;
+        }>>;
+        readonly summaries: Schema.$Array<Schema.Codec<SafeJson, SafeJson, never, never>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"finding">;
+        readonly severity: Schema.Union<readonly [Schema.Literal<"info">, Schema.Literal<"low">, Schema.Literal<"medium">, Schema.Literal<"high">, Schema.Literal<"critical">]>;
+        readonly category: Schema.String;
+        readonly summary: Schema.String;
+        readonly evidenceRefs: Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.String;
+            readonly id: Schema.String;
+        }>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"partial_result">;
+        readonly outputSchema: Schema.Struct<{
+            readonly kind: Schema.Literal<"typebox_ref">;
+            readonly name: Schema.String;
+            readonly version: Schema.String;
+            readonly sha256: Schema.String;
+        }>;
+        readonly data: Schema.Codec<SafeJson, SafeJson, never, never>;
+        readonly complete: Schema.Literal<false>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"handoff">;
+        readonly summary: Schema.String;
+        readonly nextAction: Schema.optionalKey<Schema.String>;
+        readonly evidenceRefs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.String;
+            readonly id: Schema.String;
+        }>>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"instruction">;
+        readonly instruction: Schema.String;
+        readonly authority: Schema.Union<readonly [Schema.Literal<"normal">, Schema.Literal<"operator">]>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"notice">;
+        readonly code: Schema.String;
+        readonly summary: Schema.String;
+    }>]>;
+    readonly delivery: Schema.Union<readonly [Schema.Literal<"created">, Schema.Literal<"queued">, Schema.Literal<"delivered">, Schema.Literal<"acknowledged">, Schema.Literal<"expired">, Schema.Literal<"failed">]>;
+    readonly idempotencyKey: Schema.String;
+    readonly expiresAt: Schema.optionalKey<Schema.String>;
+    readonly createdAt: Schema.String;
+    readonly acknowledgedAt: Schema.optionalKey<Schema.String>;
+}>;
+export type RunMessage = (typeof RunMessage)['Type'];
+export declare const RunResult: Schema.Struct<{
+    readonly contractVersion: Schema.Literal<"run.v1">;
+    readonly id: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly runId: Schema.String;
+    readonly rootRunId: Schema.String;
+    readonly attempt: Schema.Int;
+    readonly outcome: Schema.Union<readonly [Schema.Literal<"succeeded">, Schema.Literal<"failed">, Schema.Literal<"canceled">, Schema.Literal<"blocked">, Schema.Literal<"expired">]>;
+    readonly output: Schema.optionalKey<Schema.Struct<{
+        readonly schema: Schema.Struct<{
+            readonly kind: Schema.Literal<"typebox_ref">;
+            readonly name: Schema.String;
+            readonly version: Schema.String;
+            readonly sha256: Schema.String;
+        }>;
+        readonly data: Schema.Codec<SafeJson, SafeJson, never, never>;
+        readonly digest: Schema.String;
+    }>>;
+    readonly failure: Schema.optionalKey<Schema.Struct<{
+        readonly code: Schema.String;
+        readonly category: Schema.String;
+        readonly summary: Schema.String;
+        readonly retryable: Schema.Boolean;
+        readonly details: Schema.optionalKey<Schema.Codec<SafeJson, SafeJson, never, never>>;
+    }>>;
+    readonly evidenceRefs: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly id: Schema.String;
+    }>, Schema.Struct<{
+        readonly contractVersion: Schema.Literal<"evidence-ref.v1">;
+        readonly kind: Schema.String;
+        readonly summary: Schema.String;
+        readonly sha256: Schema.String;
+        readonly redaction: Schema.Literal<"redacted">;
+        readonly findingCount: Schema.Int;
+        readonly classifications: Schema.$Array<Schema.Union<readonly [Schema.Literal<"secret">, Schema.Literal<"credential">, Schema.Literal<"pii">, Schema.Literal<"source">, Schema.Literal<"log">, Schema.Literal<"diff">, Schema.Literal<"transcript">, Schema.Literal<"provider_payload">, Schema.Literal<"url">, Schema.Literal<"path">, Schema.Literal<"unknown">]>>;
+    }>]>>;
+    readonly childSummary: Schema.Struct<{
+        readonly awaited: Schema.Int;
+        readonly detached: Schema.Int;
+        readonly succeeded: Schema.Int;
+        readonly failed: Schema.Int;
+        readonly canceled: Schema.Int;
+    }>;
+    readonly usage: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<SafeJson, SafeJson, never, never>>>;
+    readonly producedBy: Schema.Struct<{
+        readonly workUnitId: Schema.optionalKey<Schema.String>;
+        readonly leaseId: Schema.optionalKey<Schema.String>;
+        readonly fencingTokenDigest: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly createdAt: Schema.String;
+    readonly finalizedAt: Schema.String;
+}>;
+export type RunResult = (typeof RunResult)['Type'];
+export declare const RunEvent: Schema.Struct<{
+    readonly contractVersion: Schema.Literal<"run.v1">;
+    readonly id: Schema.String;
+    readonly eventVersion: Schema.Literal<1>;
+    readonly streamId: Schema.String;
+    readonly sequence: Schema.Int;
+    readonly workspaceId: Schema.String;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly subject: Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly id: Schema.String;
+    }>;
+    readonly rootRunId: Schema.String;
+    readonly type: Schema.String;
+    readonly actor: Schema.optionalKey<Schema.Struct<{
+        readonly actorType: Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>, Schema.Literal<"runner">]>;
+        readonly actorId: Schema.String;
+        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+        readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+        readonly runnerId: Schema.optionalKey<Schema.String>;
+    }>>;
+    readonly correlationId: Schema.optionalKey<Schema.String>;
+    readonly causationId: Schema.optionalKey<Schema.String>;
+    readonly occurredAt: Schema.String;
+    readonly data: Schema.Struct<{
+        readonly type: Schema.String;
+        readonly value: Schema.Codec<SafeJson, SafeJson, never, never>;
+    }>;
+}>;
+export type RunEvent = (typeof RunEvent)['Type'];
+export declare const Wait: Schema.Struct<{
+    readonly contractVersion: Schema.Literal<"run.v1">;
+    readonly id: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly runId: Schema.String;
+    readonly rootRunId: Schema.String;
+    readonly stepKey: Schema.optionalKey<Schema.String>;
+    readonly kind: Schema.Literals<readonly ["timer", "message", "child_run", "external_event", "human_approval", "provider_check", "provider_quota", "resource"]>;
+    readonly state: Schema.Union<readonly [Schema.Literal<"open">, Schema.Literal<"resolved">, Schema.Literal<"expired">, Schema.Literal<"canceled">]>;
+    readonly correlation: Schema.$Record<Schema.String, Schema.Codec<SafeJson, SafeJson, never, never>>;
+    readonly expectedSchema: Schema.optionalKey<Schema.Struct<{
+        readonly kind: Schema.Literal<"typebox_ref">;
+        readonly name: Schema.String;
+        readonly version: Schema.String;
+        readonly sha256: Schema.String;
+    }>>;
+    readonly timeout: Schema.Struct<{
+        readonly dueAt: Schema.optionalKey<Schema.String>;
+        readonly onTimeout: Schema.Union<readonly [Schema.Literal<"fail">, Schema.Literal<"block">, Schema.Literal<"cancel">, Schema.Literal<"default">, Schema.Literal<"escalate">]>;
+        readonly defaultValue: Schema.optionalKey<Schema.Codec<SafeJson, SafeJson, never, never>>;
+    }>;
+    readonly responderScope: Schema.optionalKey<Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly id: Schema.String;
+    }>>;
+    readonly resolution: Schema.optionalKey<Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly data: Schema.optionalKey<Schema.Codec<SafeJson, SafeJson, never, never>>;
+        readonly digest: Schema.String;
+        readonly actor: Schema.optionalKey<Schema.Struct<{
+            readonly actorType: Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>, Schema.Literal<"runner">]>;
+            readonly actorId: Schema.String;
+            readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+            readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+            readonly runnerId: Schema.optionalKey<Schema.String>;
+        }>>;
+    }>>;
+    readonly createdAt: Schema.String;
+    readonly resolvedAt: Schema.optionalKey<Schema.String>;
+}>;
+export type Wait = (typeof Wait)['Type'];
+export declare const ControlCommand: Schema.Struct<{
+    readonly contractVersion: Schema.Literal<"run.v1">;
+    readonly id: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly projectId: Schema.optionalKey<Schema.String>;
+    readonly target: Schema.Struct<{
+        readonly kind: Schema.String;
+        readonly id: Schema.String;
+    }>;
+    readonly kind: Schema.Literals<readonly ["pause", "resume", "extend_budget", "cancel", "retry", "rerun_latest", "takeover", "release_takeover", "answer_wait", "approve_wait", "reject_wait", "refresh_context", "repair_readiness", "sync_agent_environment", "escalate_sandbox", "rotate_secret_ref", "rerun_verification", "create_follow_up", "drain_replica", "discard_cache", "request_status", "request_handoff"]>;
+    readonly payload: Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["pause", "resume", "extend_budget", "cancel", "retry", "rerun_latest", "takeover", "release_takeover", "answer_wait", "approve_wait", "reject_wait", "refresh_context", "repair_readiness", "sync_agent_environment", "escalate_sandbox", "rotate_secret_ref", "rerun_verification", "create_follow_up", "drain_replica", "discard_cache", "request_status", "request_handoff"]>;
+        readonly data: Schema.Codec<SafeJson, SafeJson, never, never>;
+    }>;
+    readonly requestedBy: Schema.Struct<{
+        readonly actorType: Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>, Schema.Literal<"runner">]>;
+        readonly actorId: Schema.String;
+        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+        readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+        readonly runnerId: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly idempotencyKey: Schema.String;
+    readonly expectedResourceVersion: Schema.optionalKey<Schema.Int>;
+    readonly status: Schema.Union<readonly [Schema.Literal<"accepted">, Schema.Literal<"queued">, Schema.Literal<"applied">, Schema.Literal<"rejected">, Schema.Literal<"expired">, Schema.Literal<"superseded">]>;
+    readonly rejection: Schema.optionalKey<Schema.Struct<{
+        readonly code: Schema.String;
+        readonly summary: Schema.String;
+    }>>;
+    readonly createdAt: Schema.String;
+    readonly appliedAt: Schema.optionalKey<Schema.String>;
+}>;
+export type ControlCommand = (typeof ControlCommand)['Type'];
+export declare const ControlCommandList: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly contractVersion: Schema.Literal<"run.v1">;
+        readonly id: Schema.String;
+        readonly workspaceId: Schema.String;
+        readonly projectId: Schema.optionalKey<Schema.String>;
+        readonly target: Schema.Struct<{
+            readonly kind: Schema.String;
+            readonly id: Schema.String;
+        }>;
+        readonly kind: Schema.Literals<readonly ["pause", "resume", "extend_budget", "cancel", "retry", "rerun_latest", "takeover", "release_takeover", "answer_wait", "approve_wait", "reject_wait", "refresh_context", "repair_readiness", "sync_agent_environment", "escalate_sandbox", "rotate_secret_ref", "rerun_verification", "create_follow_up", "drain_replica", "discard_cache", "request_status", "request_handoff"]>;
+        readonly payload: Schema.Struct<{
+            readonly kind: Schema.Literals<readonly ["pause", "resume", "extend_budget", "cancel", "retry", "rerun_latest", "takeover", "release_takeover", "answer_wait", "approve_wait", "reject_wait", "refresh_context", "repair_readiness", "sync_agent_environment", "escalate_sandbox", "rotate_secret_ref", "rerun_verification", "create_follow_up", "drain_replica", "discard_cache", "request_status", "request_handoff"]>;
+            readonly data: Schema.Codec<SafeJson, SafeJson, never, never>;
+        }>;
+        readonly requestedBy: Schema.Struct<{
+            readonly actorType: Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>, Schema.Literal<"runner">]>;
+            readonly actorId: Schema.String;
+            readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+            readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+            readonly runnerId: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly idempotencyKey: Schema.String;
+        readonly expectedResourceVersion: Schema.optionalKey<Schema.Int>;
+        readonly status: Schema.Union<readonly [Schema.Literal<"accepted">, Schema.Literal<"queued">, Schema.Literal<"applied">, Schema.Literal<"rejected">, Schema.Literal<"expired">, Schema.Literal<"superseded">]>;
+        readonly rejection: Schema.optionalKey<Schema.Struct<{
+            readonly code: Schema.String;
+            readonly summary: Schema.String;
+        }>>;
+        readonly createdAt: Schema.String;
+        readonly appliedAt: Schema.optionalKey<Schema.String>;
+    }>>;
+}>;
+export type ControlCommandList = (typeof ControlCommandList)['Type'];
+export declare const RunCommandCenterSnapshot: Schema.Struct<{
+    readonly source: Schema.Literal<"http_snapshot">;
+    readonly collection: Schema.Literal<"run_command_center">;
+    readonly scope: Schema.Struct<{
+        readonly kind: Schema.Literal<"run">;
+        readonly workspaceId: Schema.String;
+        readonly projectId: Schema.optionalKey<Schema.String>;
+        readonly runId: Schema.String;
+    }>;
+    readonly capturedAt: Schema.String;
+    readonly consistency: Schema.Literal<"lower_bound">;
+    readonly lowerBound: Schema.String;
+    readonly isComplete: Schema.Literal<true>;
+}>;
+export type RunCommandCenterSnapshot = (typeof RunCommandCenterSnapshot)['Type'];
+type HumanApprovalActor = Extract<RunActorRef, {
+    actorType: 'human';
+}>;
+export declare function isHumanApprovalActor(actor: RunActorRef): actor is HumanApprovalActor;
+export declare function assertHumanOnlyWaitApproval(wait: Pick<Wait, 'kind'>, actor: RunActorRef): void;
+export declare function assertBoundedRunData<ValueType>(value: ValueType): void;
+/** Outcome of cancelling a Run's open wait through the public API. */
+export type RunWaitCancellationResult = {
+    readonly status: 'completed';
+    readonly runId: string;
+    readonly waitId: string;
+    readonly outcome: 'cancelled' | 'timeout';
+} | {
+    readonly status: 'duplicate';
+    readonly runId: string;
+    readonly waitId: string;
+    readonly outcome: 'cancelled' | 'timeout';
+} | {
+    readonly status: 'ignored';
+    readonly runId: string;
+    readonly reason: 'no_open_wait' | 'cancellation_not_configured' | 'wait_closed';
+};
+export {};

package/types/packages/core/src/runtime-type.d.ts

@@ -0,0 +1,36 @@
+type RuntimeTypeName = 'bigint' | 'boolean' | 'function' | 'number' | 'object' | 'string' | 'symbol' | 'undefined';
+type JsonPrimitive = null | boolean | number | string;
+export type JsonValue = JsonPrimitive | readonly JsonValue[] | JsonObject;
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+/** In-memory structured data, before normalization for a JSON boundary. */
+export type StructuredValue = JsonValue | undefined | Date | readonly StructuredValue[] | StructuredObject;
+export type StructuredObject = {
+    readonly [key: string]: StructuredValue;
+};
+/** Normalize a JavaScript value into data that serializes without information loss. */
+export declare function toJsonValue<ValueType>(value: ValueType): JsonValue;
+/** Narrow a value to one member of a readonly literal list. */
+export declare function isOneOf<const Literal extends string | number, Value>(values: readonly Literal[], value: Value): value is Value & Literal;
+/** Narrow a value to one member of a readonly literal set. */
+export declare function isMemberOf<const Literal extends string | number, Value>(values: ReadonlySet<Literal>, value: Value): value is Value & Literal;
+/** Narrow a property key to an own key of a lookup record. */
+export declare function isKeyOf<Lookup extends object>(record: Lookup, key: PropertyKey): key is keyof Lookup;
+/** Read an own data property of untrusted input as JSON; undefined when missing or not JSON. */
+export declare function jsonProperty<Value extends object>(value: Value, key: string): JsonValue | undefined;
+export declare function toJsonObject<ValueType>(value: ValueType): JsonObject;
+type RuntimeNarrow<Value, Target, Fallback = Target> = [Extract<Value, Target>] extends [never] ? Value & Fallback : Extract<Value, Target>;
+/** Runtime predicates for values entering an untyped boundary. */
+export declare function isBigInt<Value>(value: Value): value is RuntimeNarrow<Value, bigint>;
+export declare function isBoolean<Value>(value: Value): value is RuntimeNarrow<Value, boolean>;
+export declare function isFunction<Value>(value: Value): value is RuntimeNarrow<Value, globalThis.Function>;
+export declare function isNumber<Value>(value: Value): value is RuntimeNarrow<Value, number>;
+export declare function isObject<Value>(value: Value): value is Value & object;
+export declare function isJsonObject(value: JsonValue | undefined): value is JsonObject;
+export declare function isString<Value>(value: Value): value is RuntimeNarrow<Value, string>;
+export declare function isSymbol<Value>(value: Value): value is RuntimeNarrow<Value, symbol>;
+export declare function isUndefined<Value>(value: Value): value is RuntimeNarrow<Value, undefined>;
+/** Return the ECMAScript runtime category after checking every primitive schema. */
+export declare function kindOf<Value>(value: Value): RuntimeTypeName;
+export {};