@rkat/sdk 0.8.21 → 0.8.23

package/dist/generated/types.d.ts

@@ -1,4 +1,4 @@
-export declare const CONTRACT_VERSION = "0.8.21";
+export declare const CONTRACT_VERSION = "0.8.23";
 export type Value = unknown;
 export interface WireUsage {
     input_tokens: number;
@@ -454,6 +454,12 @@ export interface EventsSnapshotResult {
     scope: Record<string, unknown>;
     snapshot: Record<string, unknown>;
 }
+export interface ExportAtifParams {
+    agent_name?: string | null;
+    agent_version?: string | null;
+    model_name?: string | null;
+    session_id: string;
+}
 export interface ForkSessionAtParams {
     message_index: number;
     running_behavior?: "reject";
@@ -486,7 +492,7 @@ export interface HelpResponse {
     text: string;
     tool_calls: number;
     turns: number;
-    usage: Record<string, unknown>;
+    usage: WireUsage;
 }
 export interface InjectSystemContextParams {
     content: Record<string, unknown>;
@@ -647,6 +653,7 @@ export interface ScheduleToolsResult {
     tools: unknown[];
 }
 export interface SessionForkResult {
+    cache_inheritance: Record<string, unknown>;
     message_count: number;
     session_id: string;
     session_ref?: string | null;
@@ -660,6 +667,15 @@ export interface SessionPeerResponseTerminalParams {
     session_id: string;
     status: "completed" | "failed" | "cancelled";
 }
+export interface SystemPromptUpdateResult {
+    commit?: Record<string, unknown> | null;
+    key: SystemPromptKey;
+    message_index: number;
+    session_id: string;
+    status: "applied" | "duplicate";
+    transcript_revision: string;
+    version: SystemPromptVersion;
+}
 export interface SessionTranscriptRewriteResult {
     commit: Record<string, unknown>;
     message_count: number;
@@ -667,6 +683,15 @@ export interface SessionTranscriptRewriteResult {
     revision: string;
     session_id: string;
 }
+export interface UpdateSystemPromptParams {
+    actor?: string | null;
+    content: string;
+    expected_parent_revision?: string | null;
+    expected_version?: SystemPromptVersion | null;
+    key: SystemPromptKey;
+    session_id: string;
+    target_message_index?: number | null;
+}
 export interface WireProvisionApiKeyResult {
     auth_binding: WireAuthBindingRef;
     auth_mode: string;
@@ -1033,6 +1058,7 @@ export interface WireMobToolConfig {
     mcp?: string[];
     memory?: boolean;
     mob?: boolean;
+    read_only?: boolean;
     schedule?: boolean;
     shell?: boolean;
     workgraph?: boolean;
@@ -1060,7 +1086,26 @@ export interface WireMobRun {
     run_id: string;
     status: WireMobRunStatus;
 }
+export interface WireMobRunMemberAccounting {
+    agent_identity: string;
+    message_count?: number | null;
+    model?: string | null;
+    provider?: Provider | null;
+    role: string;
+    session_id?: string | null;
+    usage?: WireUsage | null;
+    usage_unavailable?: string | null;
+}
+export interface WireMobRunAccounting {
+    attribution: WireMobRunUsageAttribution;
+    member_session_ids?: string[];
+    members?: WireMobRunMemberAccounting[];
+    members_usage_unavailable?: number;
+    unpriced_reason: string;
+    usage_total: WireUsage;
+}
 export interface WireMobRunResultEnvelope {
+    accounting?: WireMobRunAccounting | null;
     flow_id: string;
     mob_id: string;
     outputs?: Record<string, unknown>;
@@ -1259,9 +1304,11 @@ export interface MobSpawnHelperParams {
     agent_identity?: string | null;
     auth_binding?: WireAuthBindingRef | null;
     backend?: WireMobBackendKind | null;
+    max_text_bytes: number;
     mob_id: string;
     model_override?: string | null;
     prompt: string;
+    result_label: string;
     role_name?: string | null;
     runtime_mode?: WireMobRuntimeMode | null;
 }
@@ -1270,18 +1317,26 @@ export interface MobForkHelperParams {
     auth_binding?: WireAuthBindingRef | null;
     backend?: WireMobBackendKind | null;
     fork_context?: unknown;
+    max_text_bytes: number;
     mob_id: string;
     model_override?: string | null;
     prompt: string;
+    result_label: string;
     role_name?: string | null;
     runtime_mode?: WireMobRuntimeMode | null;
     source_member_id: string;
 }
 export interface MobHelperResult {
     agent_identity: string;
+    bounded_result: Record<string, unknown>;
     member_ref: WireMemberRef;
-    output?: string | null;
+    output: string;
+    retirement_error?: string | null;
+    session_id: string;
     tokens_used: number;
+    tool_calls: number;
+    turns: number;
+    usage: Record<string, unknown>;
 }
 export interface MobForceCancelResult {
     cancelled: boolean;
@@ -1615,6 +1670,7 @@ export interface MobFlowStepInput {
     depends_on_mode?: MobDependencyModeInput;
     dispatch_mode?: MobDispatchModeInput;
     expected_schema_ref?: string | null;
+    failure_policy?: MobFlowNodeFailurePolicyInput;
     message: WireContentInput;
     output_format?: MobStepOutputFormatInput | null;
     role: string;
@@ -1668,6 +1724,7 @@ export interface MobToolConfigInput {
     mcp?: string[];
     memory?: boolean;
     mob?: boolean;
+    read_only?: boolean;
     schedule?: boolean;
     shell?: boolean;
     workgraph?: boolean;
@@ -1826,6 +1883,7 @@ export interface WorkGraphSnapshotFilter {
     statuses?: WorkStatus[];
 }
 export interface WorkItem {
+    cancelled_child_join_policy: "require_success" | "propagate" | "accept";
     claim?: WorkItemClaim | null;
     completion_policy: WorkCompletionPolicy;
     created_at: string;
@@ -1833,6 +1891,7 @@ export interface WorkItem {
     due_at?: string | null;
     evidence_refs?: WorkEvidenceRef[];
     external_refs?: WorkItemExternalRef[];
+    failed_child_join_policy: "require_success" | "propagate" | "accept";
     id: string;
     labels?: string[];
     machine_state: Record<string, unknown>;
@@ -1881,6 +1940,7 @@ export interface WorkEvidenceRef {
 }
 export interface WorkGraphEvent {
     at: string;
+    facts?: unknown[];
     item_id?: string | null;
     kind: WorkGraphEventKind;
     namespace: string;
@@ -1894,6 +1954,7 @@ export interface WorkOwnerKey {
 }
 export interface WorkItemClaim {
     claimed_at: string;
+    expiry_observed_at?: string | null;
     lease_expires_at?: string | null;
     owner: WorkItemOwner;
 }
@@ -1914,12 +1975,14 @@ export interface BridgeBindPayload {
     epoch: number;
     expected_address: string;
     expected_peer_id: string;
+    member: Record<string, unknown>;
     protocol_version: BridgeProtocolVersion;
     supervisor: BridgePeerSpec;
 }
 export interface BridgeBindResponse {
     address: string;
     capabilities: BridgeCapabilities;
+    member_fence: Record<string, unknown>;
     peer_id: string;
 }
 export interface BridgeCapabilities {
@@ -1944,6 +2007,7 @@ export interface BridgeCapabilities {
     wire_member?: boolean;
 }
 export interface BridgeDeliveryPayload {
+    bounded_result_spec?: Record<string, unknown> | null;
     content: ContentInput;
     epoch: number;
     expected_member?: BridgeMemberIncarnation | null;
@@ -1998,8 +2062,7 @@ export interface BridgePeerWiringPayload {
     supervisor: BridgePeerSpec;
 }
 export interface BridgeRetireResponse {
-    inputs_abandoned: number;
-    inputs_pending_drain: number;
+    outcome: Record<string, unknown>;
 }
 export interface BridgeSupervisorPayload {
     epoch: number;
@@ -2093,6 +2156,7 @@ export interface WireFlowFailureDetail {
     truncated: boolean;
 }
 export interface BridgeTurnOutcomeRecord {
+    bounded_result?: unknown | null;
     fence_token: number;
     generation: number;
     input_id: string;
@@ -2334,7 +2398,10 @@ export interface WireToolAccessPolicyDenyList {
     type: "deny_list";
     value: string[];
 }
-export type WireToolAccessPolicy = WireToolAccessPolicyInherit | WireToolAccessPolicyAllowList | WireToolAccessPolicyDenyList;
+export interface WireToolAccessPolicyReadOnly {
+    type: "read_only";
+}
+export type WireToolAccessPolicy = WireToolAccessPolicyInherit | WireToolAccessPolicyAllowList | WireToolAccessPolicyDenyList | WireToolAccessPolicyReadOnly;
 export type WireToolFilter = "All" | {
     Allow: string[];
 } | {
@@ -2392,10 +2459,12 @@ export interface MobConditionExprInputNot {
 export type MobConditionExprInput = MobConditionExprInputEq | MobConditionExprInputIn | MobConditionExprInputGt | MobConditionExprInputLt | MobConditionExprInputAnd | MobConditionExprInputOr | MobConditionExprInputNot;
 export type MobDependencyModeInput = "all" | "any";
 export type MobDispatchModeInput = "fan_out" | "one_to_one" | "fan_in";
+export type MobFlowNodeFailurePolicyInput = "escalate" | "continue";
 export interface MobFlowNodeInputStep {
     branch?: string | null;
     depends_on?: string[];
     depends_on_mode?: MobDependencyModeInput;
+    failure_policy?: MobFlowNodeFailurePolicyInput;
     kind: "step";
     step_id: string;
 }
@@ -2403,6 +2472,7 @@ export interface MobFlowNodeInputRepeatUntil {
     body: MobFrameSpecInput;
     depends_on?: string[];
     depends_on_mode?: MobDependencyModeInput;
+    failure_policy?: MobFlowNodeFailurePolicyInput;
     kind: "repeat_until";
     loop_id: string;
     max_iterations: number;
@@ -2436,6 +2506,7 @@ export type WireProjectionProvenance = "host_claimed" | "controlling_host_verifi
 export type WireReachability = "reachable" | "stale" | "unreachable" | "unknown";
 export type WireNonPortableResourceKind = "rust_bundles" | "per_spawn_external_tools" | "mob_default_external_tools" | "default_llm_client_override" | "host_surface_mcp_allowlist" | "workgraph_tools";
 export type WireMobRunStatus = "pending" | "running" | "completed" | "failed" | "canceled";
+export type WireMobRunUsageAttribution = "session_cumulative";
 export type WireWorkExecutionLifecyclePhase = "absent" | "launch_requested" | "launch_uncertain" | "launch_quarantined" | "running" | "evidence_projection_requested" | "failure_evidence_projection_requested" | "cancellation_evidence_projection_requested" | "launch_failure_evidence_projection_requested" | "work_closure_requested" | "flow_failed" | "flow_canceled" | "evidence_projected" | "work_closed" | "launch_failed";
 export interface WirePeerConnectivityNotApplicable {
     status: "not_applicable";
@@ -2536,14 +2607,14 @@ export interface WorkCompletionPolicyReviewerQuorum {
 export type WorkCompletionPolicy = WorkCompletionPolicySelfAttest | WorkCompletionPolicyHostConfirmed | WorkCompletionPolicyPrincipalConfirmed | WorkCompletionPolicySupervisor | WorkCompletionPolicyReviewerQuorum;
 export type WorkEdgeKind = "blocks" | "parent" | "related" | "supersedes" | "derived_from";
 export type WorkEvidenceKind = "host_confirmation" | "principal_confirmation" | "supervisor_confirmation" | "reviewer_confirmation" | "self_attest";
-export type WorkGraphEventKind = "created" | "updated" | "claimed" | "released" | "blocked" | "closed" | "linked" | "evidence_added" | "attention_created" | "attention_updated" | "execution_bound" | "execution_transitioned";
+export type WorkGraphEventKind = "created" | "updated" | "readiness_observed" | "claimed" | "released" | "blocked" | "closed" | "linked" | "evidence_added" | "attention_created" | "attention_updated" | "execution_bound" | "execution_transitioned";
 export type WorkOwnerKind = "principal" | "agent" | "session" | "mob" | "label";
 export type WorkStatus = "open" | "in_progress" | "blocked" | "completed" | "cancelled" | "failed";
 export declare const WORK_GRAPH_STATUSES: readonly ["open", "in_progress", "blocked", "completed", "cancelled", "failed"];
 export type WorkGraphStatus = typeof WORK_GRAPH_STATUSES[number];
 export declare const WORK_GRAPH_PRIORITIES: readonly ["low", "medium", "high"];
 export type WorkGraphPriority = typeof WORK_GRAPH_PRIORITIES[number];
-export declare const WORK_GRAPH_EVENT_KINDS: readonly ["created", "updated", "claimed", "released", "blocked", "closed", "linked", "evidence_added", "attention_created", "attention_updated", "execution_bound", "execution_transitioned"];
+export declare const WORK_GRAPH_EVENT_KINDS: readonly ["created", "updated", "readiness_observed", "claimed", "released", "blocked", "closed", "linked", "evidence_added", "attention_created", "attention_updated", "execution_bound", "execution_transitioned"];
 export type McpLiveOperation = "add" | "remove" | "reload";
 export type McpLiveOpStatus = "staged" | "applied" | "rejected";
 export type McpHttpTransport = "streamable-http" | "sse";
@@ -2638,6 +2709,7 @@ export interface BridgeCommandBindMember {
     epoch: number;
     expected_address: string;
     expected_peer_id: string;
+    member: Record<string, unknown>;
     protocol_version: BridgeProtocolVersion;
     supervisor: BridgePeerSpec;
 }
@@ -2654,6 +2726,7 @@ export interface BridgeCommandRevokeSupervisor {
     supervisor: BridgePeerSpec;
 }
 export interface BridgeCommandDeliverMemberInput {
+    bounded_result_spec?: Record<string, unknown> | null;
     command: "deliver_member_input";
     content: ContentInput;
     epoch: number;
@@ -2704,6 +2777,7 @@ export interface BridgeCommandCancelTrackedMemberInput {
 export interface BridgeCommandRetireMember {
     command: "retire_member";
     epoch: number;
+    member_fence: Record<string, unknown>;
     protocol_version: BridgeProtocolVersion;
     supervisor: BridgePeerSpec;
 }
@@ -2974,6 +3048,12 @@ export interface BridgeRejectionCauseHistoryRowTooLargePayload {
 export interface BridgeRejectionCauseHistoryRowTooLarge {
     history_row_too_large: BridgeRejectionCauseHistoryRowTooLargePayload;
 }
+export interface BridgeRejectionCauseRuntimeRetirementInProgressPayload {
+    stage: string;
+}
+export interface BridgeRejectionCauseRuntimeRetirementInProgress {
+    runtime_retirement_in_progress: BridgeRejectionCauseRuntimeRetirementInProgressPayload;
+}
 export interface BridgeRejectionCauseScopeDeniedPayload {
     presented: WireControlScope[];
     required: WireControlScope;
@@ -3050,10 +3130,11 @@ export interface BridgeRejectionCauseSessionOwnershipConflictPayload {
 export interface BridgeRejectionCauseSessionOwnershipConflict {
     session_ownership_conflict: BridgeRejectionCauseSessionOwnershipConflictPayload;
 }
-export type BridgeRejectionCause = "not_bound" | "stale_supervisor" | "sender_mismatch" | "already_bound" | "invalid_bootstrap_token" | "unsupported_protocol_version" | "invalid_supervisor_spec" | "invalid_peer_spec" | "address_mismatch" | "unsupported" | "internal" | "stale_fence" | BridgeRejectionCauseStaleCursor | BridgeRejectionCauseOversizedEvent | BridgeRejectionCauseHistoryRowTooLarge | "unavailable" | BridgeRejectionCauseScopeDenied | "spec_digest_mismatch" | BridgeRejectionCauseMaterializeBuildRejected | BridgeRejectionCauseModelUnresolvable | BridgeRejectionCauseAuthBindingUnresolvable | BridgeRejectionCauseMcpCommandMissing | "realm_backend_unavailable" | BridgeRejectionCauseEnvKeyMissing | BridgeRejectionCauseHostEngineVersionChanged | BridgeRejectionCauseModelNotRealtime | BridgeRejectionCauseLiveAdapterUnavailable | "live_transport_unavailable" | "live_channel_already_bound" | "live_channel_not_found" | BridgeRejectionCauseLiveTransportUnsupported | "resume_session_not_found" | BridgeRejectionCauseCapabilityMissing | "launch_mode_unsupported" | "launch_mode_placement_mismatch" | BridgeRejectionCauseSessionOwnershipConflict;
+export type BridgeRejectionCause = "not_bound" | "stale_supervisor" | "sender_mismatch" | "already_bound" | "invalid_bootstrap_token" | "unsupported_protocol_version" | "invalid_supervisor_spec" | "invalid_peer_spec" | "address_mismatch" | "unsupported" | "internal" | "bind_admission_outcome_unknown" | "stale_fence" | BridgeRejectionCauseStaleCursor | BridgeRejectionCauseOversizedEvent | BridgeRejectionCauseHistoryRowTooLarge | "unavailable" | BridgeRejectionCauseRuntimeRetirementInProgress | BridgeRejectionCauseScopeDenied | "spec_digest_mismatch" | BridgeRejectionCauseMaterializeBuildRejected | BridgeRejectionCauseModelUnresolvable | BridgeRejectionCauseAuthBindingUnresolvable | BridgeRejectionCauseMcpCommandMissing | "realm_backend_unavailable" | BridgeRejectionCauseEnvKeyMissing | BridgeRejectionCauseHostEngineVersionChanged | BridgeRejectionCauseModelNotRealtime | BridgeRejectionCauseLiveAdapterUnavailable | "live_transport_unavailable" | "live_channel_already_bound" | "live_channel_not_found" | BridgeRejectionCauseLiveTransportUnsupported | "resume_session_not_found" | BridgeRejectionCauseCapabilityMissing | "launch_mode_unsupported" | "launch_mode_placement_mismatch" | BridgeRejectionCauseSessionOwnershipConflict;
 export interface BridgeReplyBindMember {
     address: string;
     capabilities: BridgeCapabilities;
+    member_fence: Record<string, unknown>;
     peer_id: string;
     result: "bind_member";
 }
@@ -3083,8 +3164,7 @@ export interface BridgeReplyTrackedInputCancelled {
     result: "tracked_input_cancelled";
 }
 export interface BridgeReplyRetire {
-    inputs_abandoned: number;
-    inputs_pending_drain: number;
+    outcome: Record<string, unknown>;
     result: "retire";
 }
 export interface BridgeReplyDestroy {
@@ -3286,15 +3366,23 @@ export interface CommsSendResultInputAccepted {
     stream_reserved: boolean;
 }
 export interface CommsSendResultPeerMessageSent {
-    delivery: "acked" | "handed_off" | "queued";
+    delivery: {
+        durably_resolved: Record<string, unknown>;
+    } | "acked" | "volatile_handed_off" | "queued";
     envelope_id: string;
     kind: "peer_message_sent";
 }
 export interface CommsSendResultPeerLifecycleSent {
+    delivery: {
+        durably_resolved: Record<string, unknown>;
+    } | "acked" | "volatile_handed_off" | "queued";
     envelope_id: string;
     kind: "peer_lifecycle_sent";
 }
 export interface CommsSendResultPeerRequestSent {
+    delivery: {
+        durably_resolved: Record<string, unknown>;
+    } | "acked" | "volatile_handed_off" | "queued";
     envelope_id: string;
     interaction_id: string;
     kind: "peer_request_sent";
@@ -3302,6 +3390,9 @@ export interface CommsSendResultPeerRequestSent {
     stream_reserved: boolean;
 }
 export interface CommsSendResultPeerResponseSent {
+    delivery: {
+        durably_resolved: Record<string, unknown>;
+    } | "acked" | "volatile_handed_off" | "queued";
     envelope_id: string;
     in_reply_to: string;
     kind: "peer_response_sent";
@@ -3799,7 +3890,7 @@ export interface WireLiveAdapterObservationAssistantTranscriptFinal {
     response_id?: string | null;
     stop_reason: WireStopReason;
     text: string;
-    usage: Record<string, unknown>;
+    usage: WireUsage;
 }
 export interface WireLiveAdapterObservationAssistantTranscriptTruncated {
     content_index?: number | null;
@@ -4361,6 +4452,12 @@ export interface SystemNoticeBlockUnknown {
 }
 export type SystemNoticeBlock = SystemNoticeBlockComms | SystemNoticeBlockExternalEvent | SystemNoticeBlockToolConfig | SystemNoticeBlockMcp | SystemNoticeBlockBackgroundJob | SystemNoticeBlockAuth | SystemNoticeBlockRuntimeNotice | SystemNoticeBlockUnknown;
 export type SystemNoticeKind = "generic" | "comms" | "external_event" | "mcp_pending" | "mcp" | "background_job" | "tool_scope" | "tool_scope_warning" | "auth_reauth_required";
+export type SystemPromptKey = string;
+export type SystemPromptVersion = number;
+export interface SystemPromptVersionIdentity {
+    key: SystemPromptKey;
+    version: SystemPromptVersion;
+}
 export type TranscriptUserRole = "conversational" | "compaction_summary" | "injected_context";
 export type AssistantImageId = string;
 export interface BlobRef {
@@ -4430,6 +4527,7 @@ export type WireServerToolKind = WireServerToolKindWebSearch | WireServerToolKin
 export interface TranscriptRewriteMessageSystem {
     content: string;
     created_at?: string | null;
+    prompt_version?: SystemPromptVersionIdentity | null;
     role: "system";
 }
 export interface TranscriptRewriteMessageSystemNotice {
@@ -4521,6 +4619,7 @@ export interface WireSessionMessageSystem {
     content: string;
     created_at: string;
     identity?: Record<string, unknown> | null;
+    prompt_version?: SystemPromptVersionIdentity | null;
     role: "system";
 }
 export interface WireSessionMessageSystemNotice {