@compozy/extension-sdk 0.3.0-beta.19 → 0.3.0-beta.21

package/dist/types/generated/contracts.d.ts

@@ -7,10 +7,11 @@ export interface AcceptedCapabilities {
 export interface AgentCrashedPatch {
     labels?: Record<string, string>;
 }
-export type HookEvent = "session.pre_create" | "session.post_create" | "session.pre_resume" | "session.post_resume" | "session.pre_stop" | "session.post_stop" | "session.message_persisted" | "sandbox.prepare" | "sandbox.ready" | "sandbox.sync.before" | "sandbox.sync.after" | "sandbox.stop" | "input.pre_submit" | "prompt.post_assemble" | "event.pre_record" | "event.post_record" | "automation.job.pre_fire" | "automation.job.post_fire" | "automation.trigger.pre_fire" | "automation.trigger.post_fire" | "automation.run.completed" | "automation.run.failed" | "agent.pre_start" | "agent.spawned" | "agent.crashed" | "agent.stopped" | "agent.soul.snapshot.resolved" | "agent.soul.mutation.after" | "agent.heartbeat.policy.resolved" | "agent.heartbeat.wake.before" | "agent.heartbeat.wake.after" | "session.health.update.after" | "turn.start" | "turn.end" | "message.start" | "message.delta" | "message.end" | "tool.pre_call" | "tool.post_call" | "tool.post_error" | "permission.request" | "permission.resolved" | "permission.denied" | "context.pre_compact" | "context.post_compact" | "coordinator.pre_spawn" | "coordinator.spawned" | "coordinator.decision" | "coordinator.stopped" | "coordinator.failed" | "task.blocked" | "task.unblocked" | "task.needs_attention" | "task.recovered" | "task.status_changed" | "task.run.enqueued" | "task.run.pre_claim" | "task.run.post_claim" | "task.run.lease_extended" | "task.run.lease_expired" | "task.run.lease_recovered" | "task.run.released" | "task.run.completed" | "task.run.failed" | "loop.started" | "loop.generation.pre" | "loop.generation.post" | "loop.gate.pre" | "loop.gate.post" | "loop.node.terminal" | "loop.terminal" | "spawn.pre_create" | "spawn.created" | "spawn.parent_stopped" | "spawn.ttl_expired" | "spawn.reaped" | "session.attention.changed" | "network.thread.opened" | "network.direct_room.opened" | "network.message.persisted" | "network.work.opened" | "network.work.transitioned" | "network.work.closed" | "network.peer.joined" | "network.peer.left" | "network.participation.pre_resolve" | "network.participation.resolved" | "window_manager.layout.applied" | "window_manager.desktop.created" | "window_manager.desktop.deleted" | "window_manager.window.moved" | "window_manager.window.opened" | "window_manager.window.closed" | "window_manager.stack.grouped" | "window_manager.stack.ungrouped" | "window_manager.stack.activated" | "worktree.pre_create" | "worktree.pre_remove" | "worktree.created" | "worktree.adopted" | "worktree.removed";
+export type HookEvent = "session.pre_create" | "session.post_create" | "session.pre_resume" | "session.post_resume" | "session.pre_stop" | "session.post_stop" | "session.message_persisted" | "session.runtime_recovery.started" | "session.runtime_recovery.succeeded" | "session.runtime_recovery.exhausted" | "sandbox.prepare" | "sandbox.ready" | "sandbox.sync.before" | "sandbox.sync.after" | "sandbox.stop" | "input.pre_submit" | "prompt.post_assemble" | "event.pre_record" | "event.post_record" | "automation.job.pre_fire" | "automation.job.post_fire" | "automation.trigger.pre_fire" | "automation.trigger.post_fire" | "automation.run.completed" | "automation.run.failed" | "agent.pre_start" | "agent.spawned" | "agent.crashed" | "agent.stopped" | "agent.soul.snapshot.resolved" | "agent.soul.mutation.after" | "agent.heartbeat.policy.resolved" | "agent.heartbeat.wake.before" | "agent.heartbeat.wake.after" | "session.health.update.after" | "turn.start" | "turn.end" | "message.start" | "message.delta" | "message.end" | "tool.pre_call" | "tool.post_call" | "tool.post_error" | "permission.request" | "permission.resolved" | "permission.denied" | "context.pre_compact" | "context.post_compact" | "coordinator.pre_spawn" | "coordinator.spawned" | "coordinator.decision" | "coordinator.stopped" | "coordinator.failed" | "task.blocked" | "task.unblocked" | "task.needs_attention" | "task.recovered" | "task.status_changed" | "task.run.enqueued" | "task.run.pre_claim" | "task.run.post_claim" | "task.run.lease_extended" | "task.run.lease_expired" | "task.run.lease_recovered" | "task.run.released" | "task.run.completed" | "task.run.failed" | "loop.started" | "loop.generation.pre" | "loop.generation.post" | "loop.gate.pre" | "loop.gate.post" | "loop.node.terminal" | "loop.terminal" | "spawn.pre_create" | "spawn.created" | "spawn.parent_stopped" | "spawn.ttl_expired" | "spawn.reaped" | "session.attention.changed" | "network.thread.opened" | "network.direct_room.opened" | "network.message.persisted" | "network.work.opened" | "network.work.transitioned" | "network.work.closed" | "network.peer.joined" | "network.peer.left" | "network.participation.pre_resolve" | "network.participation.resolved" | "window_manager.layout.applied" | "window_manager.desktop.created" | "window_manager.desktop.deleted" | "window_manager.window.moved" | "window_manager.window.opened" | "window_manager.window.closed" | "window_manager.stack.grouped" | "window_manager.stack.ungrouped" | "window_manager.stack.activated" | "worktree.pre_create" | "worktree.pre_remove" | "worktree.created" | "worktree.adopted" | "worktree.removed";
 export interface AgentCrashedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -92,6 +93,7 @@ export interface AgentHeartbeatValidateParams {
 export interface AgentHeartbeatWakeAfterPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -117,6 +119,7 @@ export interface AgentHeartbeatWakeAfterPayload {
 export interface AgentHeartbeatWakeBeforePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -151,6 +154,7 @@ export interface AgentLifecyclePatch {
 export interface AgentLifecyclePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -175,6 +179,7 @@ export interface AgentLifecyclePayload {
 export interface AgentPreStartPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -396,6 +401,7 @@ export interface AgentSpawnedPatch {
 export interface AgentSpawnedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -430,6 +436,7 @@ export interface AgentStoppedPatch {
 export interface AgentStoppedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -559,6 +566,7 @@ export interface AutomationJobCreateParams {
     fire_limit?: FireLimitConfig;
 }
 export interface AutomationJobPostFirePayload {
+    profile_id?: string;
     job_id: string;
     job_name?: string;
     agent_name?: string;
@@ -573,6 +581,7 @@ export interface AutomationSchedulePayload {
     time?: string;
 }
 export interface AutomationJobPreFirePayload {
+    profile_id?: string;
     job_id: string;
     job_name?: string;
     agent_name?: string;
@@ -614,6 +623,7 @@ export interface AutomationJobsParams {
 export type JobSource = string;
 export interface Job {
     id: string;
+    profile_id: string;
     scope: Scope;
     name: string;
     target_kind: TargetKind;
@@ -642,6 +652,7 @@ export interface AutomationJobsResult {
 }
 export type AutomationObservationPatch = Record<string, never>;
 export interface AutomationRunCompletedPayload {
+    profile_id?: string;
     run_id: string;
     job_id?: string;
     trigger_id?: string;
@@ -652,6 +663,7 @@ export interface AutomationRunCompletedPayload {
     duration_ms?: number;
 }
 export interface AutomationRunFailedPayload {
+    profile_id?: string;
     run_id: string;
     job_id?: string;
     trigger_id?: string;
@@ -695,6 +707,7 @@ export interface AutomationTriggerFireParams {
     payload?: Record<string, JSONValue>;
 }
 export interface AutomationTriggerPostFirePayload {
+    profile_id?: string;
     trigger_id: string;
     trigger_name?: string;
     event?: string;
@@ -704,6 +717,7 @@ export interface AutomationTriggerPostFirePayload {
     session_id?: string;
 }
 export interface AutomationTriggerPreFirePayload {
+    profile_id?: string;
     trigger_id: string;
     trigger_name?: string;
     event?: string;
@@ -755,6 +769,10 @@ export interface GatewayIngressPayload {
 }
 export interface Trigger {
     id: string;
+    profile_id: string;
+    profile_name: string;
+    profile_color?: string;
+    profile_icon?: string;
     scope: Scope;
     name: string;
     target_kind: TargetKind;
@@ -826,6 +844,12 @@ export interface BridgeDegradation {
 }
 export interface BridgeInstance {
     id: string;
+    profile_id: string;
+    profile_name?: string;
+    profile_color?: string;
+    profile_icon?: string;
+    profile_emoji?: string;
+    profile_archived?: boolean;
     scope: BridgeScope;
     workspace_id?: string;
     platform: string;
@@ -928,6 +952,7 @@ export interface CmdPaletteCommand {
     title: string;
     section?: string;
     icon: string;
+    profile?: string;
     keywords?: string[];
     arguments?: CmdPaletteArgument[];
     action: CmdPaletteAction;
@@ -943,6 +968,7 @@ export interface CmdPaletteView {
     id: string;
     title: string;
     kind: string;
+    profile?: string;
     source?: CmdPaletteViewSource;
     program?: boolean;
 }
@@ -1007,6 +1033,7 @@ export interface ContextBlock {
 export interface ContextCompactPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -1043,6 +1070,7 @@ export interface ContextPostCompactPatch {
 export interface ContextPostCompactPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -1072,6 +1100,7 @@ export interface ContextPreCompactPatch {
 export interface ContextPreCompactPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -1114,6 +1143,7 @@ export type NetworkParticipationSpec = {
     bounds: NetworkParticipationBounds;
 };
 export interface CoordinatorContext {
+    profile_id?: string;
     workspace_id?: string;
     workspace?: string;
     agent_name?: string;
@@ -1128,6 +1158,7 @@ export interface CoordinatorContext {
 export interface CoordinatorDecisionPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     workspace_id?: string;
     workspace?: string;
     agent_name?: string;
@@ -1146,6 +1177,7 @@ export interface CoordinatorDecisionPayload {
 export interface CoordinatorFailedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     workspace_id?: string;
     workspace?: string;
     agent_name?: string;
@@ -1164,6 +1196,7 @@ export interface CoordinatorFailedPayload {
 export interface CoordinatorLifecyclePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     workspace_id?: string;
     workspace?: string;
     agent_name?: string;
@@ -1185,6 +1218,7 @@ export interface CoordinatorObservationPatch {
 export interface CoordinatorPreSpawnPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     workspace_id?: string;
     workspace?: string;
     agent_name?: string;
@@ -1209,6 +1243,7 @@ export interface CoordinatorSpawnPatch {
 export interface CoordinatorSpawnedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     workspace_id?: string;
     workspace?: string;
     agent_name?: string;
@@ -1227,6 +1262,7 @@ export interface CoordinatorSpawnedPayload {
 export interface CoordinatorStoppedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     workspace_id?: string;
     workspace?: string;
     agent_name?: string;
@@ -1332,12 +1368,33 @@ export interface DescribeNetworkParticipation {
     mode: string;
     channel_scopes?: string[];
 }
+export interface DescribeProfileDefaults {
+    agent?: string;
+    provider?: string;
+    sandbox?: string;
+}
+export interface DescribeProfileCredential {
+    provider: string;
+    slot: string;
+}
+export interface DescribeProfile {
+    name: string;
+    color?: string;
+    icon?: string;
+    emoji?: string;
+    defaults?: DescribeProfileDefaults;
+    credentials?: DescribeProfileCredential[];
+}
+export interface DescribeResourcePath {
+    path: string;
+    profile?: string;
+}
 export interface DescribeResources {
-    skills?: string[];
-    loops?: string[];
-    agents?: string[];
-    automation?: string[];
-    layouts?: string[];
+    skills?: DescribeResourcePath[];
+    loops?: DescribeResourcePath[];
+    agents?: DescribeResourcePath[];
+    automation?: DescribeResourcePath[];
+    layouts?: DescribeResourcePath[];
     cmd_palette?: CmdPaletteConfig;
 }
 export interface DescribeSubprocess {
@@ -1354,6 +1411,7 @@ export interface ExtensionCommandSpec {
     flags?: Record<string, string>;
 }
 export interface ExtensionToolRuntimeDescriptor {
+    profile?: string;
     id: ToolID;
     handler: string;
     description?: string;
@@ -1369,9 +1427,14 @@ export interface ExtensionToolRuntimeDescriptor {
     capabilities?: string[];
     command?: ExtensionCommandSpec;
 }
+export interface DescribeHookEvent {
+    event: HookEvent;
+    profile?: string;
+}
 export interface ExtensionCommandGroupSpec {
     path: string;
     summary: string;
+    profile?: string;
 }
 export interface DescribeSDKInfo {
     name: string;
@@ -1386,11 +1449,12 @@ export interface DescribePayload {
     provides: string[];
     permissions: string[];
     requires_env?: string[];
+    profiles?: DescribeProfile[];
     resources: DescribeResources;
     subprocess: DescribeSubprocess;
     network_participation?: DescribeNetworkParticipation;
     tools?: ExtensionToolRuntimeDescriptor[];
-    hook_events?: string[];
+    hook_events?: DescribeHookEvent[];
     watch_source_kinds?: string[];
     cmd_palette_views?: string[];
     command_groups?: ExtensionCommandGroupSpec[];
@@ -1407,6 +1471,7 @@ export interface EventPostRecordPatch {
 export interface EventPostRecordPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -1431,6 +1496,7 @@ export interface EventPreRecordPatch {
 export interface EventPreRecordPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -1455,6 +1521,7 @@ export interface EventRecordPatch {
 export interface EventRecordPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -1858,6 +1925,7 @@ export type HookExecutorKind = "native" | "subprocess" | "wasm";
 export type HookSource = "native" | "config" | "extension" | "agent_definition" | "skill";
 export interface HookDecl {
     name: string;
+    profile_id?: string;
     event: HookEvent;
     mode?: HookMode;
     matcher: HookMatcher;
@@ -1875,7 +1943,7 @@ export interface HookDecl {
 }
 export type HookEventFamily = "session" | "sandbox" | "input" | "prompt" | "event" | "automation" | "agent" | "turn" | "message" | "tool" | "permission" | "context" | "coordinator" | "task" | "task.run" | "loop" | "spawn" | "network" | "window_manager" | "worktree";
 export type HookRunOutcome = "applied" | "denied" | "failed" | "skipped" | "dropped" | "rejected";
-export type HookSkillSource = "bundled" | "marketplace" | "user" | "additional" | "workspace";
+export type HookSkillSource = "bundled" | "marketplace" | "user" | "profile" | "additional" | "workspace" | "workspace_profile";
 export interface InboundAction {
     action_id: string;
     message_id?: string;
@@ -2032,6 +2100,7 @@ export interface InputAttachmentMetadata {
 export interface InputPreSubmitPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -2068,6 +2137,7 @@ export interface ListLogsParams {
     limit?: number;
 }
 export interface LoopContext {
+    profile_id?: string;
     loop_run_id?: string;
     parent_loop_run_id?: string;
     workspace_id?: string;
@@ -2093,6 +2163,7 @@ export interface LoopControlPatch {
 export interface LoopGatePostPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     loop_run_id?: string;
     parent_loop_run_id?: string;
     workspace_id?: string;
@@ -2127,6 +2198,7 @@ export interface LoopGatePrePatch {
 export interface LoopGatePrePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     loop_run_id?: string;
     parent_loop_run_id?: string;
     workspace_id?: string;
@@ -2158,6 +2230,7 @@ export type LoopGenerationOrigin = "initial" | "stop_when" | "reattempt" | "gate
 export interface LoopGenerationPostPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     loop_run_id?: string;
     parent_loop_run_id?: string;
     workspace_id?: string;
@@ -2190,6 +2263,7 @@ export interface LoopGenerationPrePatch {
 export interface LoopGenerationPrePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     loop_run_id?: string;
     parent_loop_run_id?: string;
     workspace_id?: string;
@@ -2218,6 +2292,7 @@ export interface LoopGenerationPrePayload {
 export interface LoopLifecyclePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     loop_run_id?: string;
     parent_loop_run_id?: string;
     workspace_id?: string;
@@ -2243,6 +2318,7 @@ export interface LoopLifecyclePayload {
 export interface LoopNodeTerminalPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     loop_run_id?: string;
     parent_loop_run_id?: string;
     workspace_id?: string;
@@ -2275,6 +2351,7 @@ export interface LoopObservationPatch {
 export interface LoopStartedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     loop_run_id?: string;
     parent_loop_run_id?: string;
     workspace_id?: string;
@@ -2300,6 +2377,7 @@ export interface LoopStartedPayload {
 export interface LoopTerminalPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     loop_run_id?: string;
     parent_loop_run_id?: string;
     workspace_id?: string;
@@ -2322,7 +2400,7 @@ export interface LoopTerminalPayload {
     reason_code?: string;
     details?: JSONValue;
 }
-export type MemoryScope = "global" | "workspace" | "agent";
+export type MemoryScope = "profile" | "workspace" | "agent";
 export interface MemoryForgetParams {
     key: string;
     scope?: MemoryScope;
@@ -2356,6 +2434,7 @@ export interface MessageDeltaPatch {
 export interface MessageDeltaPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -2386,6 +2465,7 @@ export interface MessageEndPatch {
 export interface MessageEndPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -2416,6 +2496,7 @@ export interface MessagePatch {
 export interface MessagePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -2446,6 +2527,7 @@ export interface MessageStartPatch {
 export interface MessageStartPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -2522,6 +2604,12 @@ export interface ModelsStatusParams {
     provider_id?: string;
 }
 export interface NetworkChannelPayload {
+    profile_id: string;
+    profile_name: string;
+    profile_color?: string;
+    profile_icon?: string;
+    profile_emoji?: string;
+    profile_archived?: boolean;
     channel: string;
     workspace_id?: string;
     purpose?: string;
@@ -2559,6 +2647,12 @@ export interface NetworkDirectResolveParams {
     peer_id: string;
 }
 export interface NetworkConversationMessagePayload {
+    profile_id: string;
+    profile_name: string;
+    profile_color?: string;
+    profile_icon?: string;
+    profile_emoji?: string;
+    profile_archived?: boolean;
     message_id: string;
     workspace_id?: string;
     channel: string;
@@ -2615,6 +2709,12 @@ export interface NetworkDirectRoomOpenedPayload {
     causation_id?: string;
 }
 export interface NetworkDirectRoomPayload {
+    profile_id: string;
+    profile_name: string;
+    profile_color?: string;
+    profile_icon?: string;
+    profile_emoji?: string;
+    profile_archived?: boolean;
     workspace_id?: string;
     channel: string;
     direct_id: string;
@@ -2914,6 +3014,12 @@ export interface NetworkCoordinationCostPayload {
     estimated_prompt_tokens?: number;
 }
 export interface NetworkThreadSummaryPayload {
+    profile_id: string;
+    profile_name: string;
+    profile_color?: string;
+    profile_icon?: string;
+    profile_emoji?: string;
+    profile_archived?: boolean;
     workspace_id?: string;
     channel: string;
     thread_id: string;
@@ -3052,6 +3158,12 @@ export interface NetworkWorkOpenedPayload {
     causation_id?: string;
 }
 export interface NetworkWorkPayload {
+    profile_id: string;
+    profile_name: string;
+    profile_color?: string;
+    profile_icon?: string;
+    profile_emoji?: string;
+    profile_archived?: boolean;
     work_id: string;
     workspace_id?: string;
     channel: string;
@@ -3259,6 +3371,7 @@ export interface PermissionToolCall {
 export interface PermissionDeniedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3296,6 +3409,7 @@ export interface PermissionRequestPatch {
 export interface PermissionRequestPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3322,6 +3436,7 @@ export interface PermissionRequestPayload {
 export interface PermissionResolutionPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3348,6 +3463,7 @@ export type PermissionResolvedPatch = Record<string, never>;
 export interface PermissionResolvedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3387,6 +3503,7 @@ export interface PromptPatch {
 export interface PromptPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3510,6 +3627,7 @@ export interface ResourcesSnapshotParams {
 }
 export interface Run {
     id: string;
+    profile_id?: string;
     job_id?: string;
     trigger_id?: string;
     session_id?: string;
@@ -3587,6 +3705,7 @@ export interface SandboxProfilePayload {
 export interface SandboxPreparePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3617,6 +3736,7 @@ export type SandboxReadyPatch = Record<string, never>;
 export interface SandboxReadyPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3644,6 +3764,7 @@ export interface SandboxStopPatch {
 export interface SandboxStopPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3671,6 +3792,7 @@ export type SandboxSyncAfterPatch = Record<string, never>;
 export interface SandboxSyncAfterPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3704,6 +3826,7 @@ export interface SandboxSyncBeforePatch {
 export interface SandboxSyncBeforePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3731,6 +3854,7 @@ export interface SandboxSyncBeforePayload {
 export interface SessionAttentionChangedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3751,6 +3875,7 @@ export interface SessionAttentionChangedPayload {
 }
 export type SessionAttentionObservationPatch = Record<string, never>;
 export interface SessionContext {
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3802,6 +3927,7 @@ export interface SessionHealthResponse {
 export interface SessionHealthUpdateAfterPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3891,6 +4017,7 @@ export interface SessionInspectResponse {
 export interface SessionLifecyclePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3908,6 +4035,7 @@ export interface SessionLifecyclePayload {
 export interface SessionMessagePersistedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3945,6 +4073,7 @@ export interface SessionPostCreatePatch {
 export interface SessionPostCreatePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3971,6 +4100,7 @@ export interface SessionPostResumePatch {
 export interface SessionPostResumePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -3997,6 +4127,7 @@ export interface SessionPostStopPatch {
 export interface SessionPostStopPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -4014,6 +4145,7 @@ export interface SessionPostStopPayload {
 export interface SessionPreCreatePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -4040,6 +4172,7 @@ export interface SessionPreResumePatch {
 export interface SessionPreResumePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -4066,6 +4199,7 @@ export interface SessionPreStopPatch {
 export interface SessionPreStopPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -4100,6 +4234,78 @@ export interface SessionRuntimeClearParams {
     session_id: string;
     expected_revision?: number;
 }
+export interface SessionRuntimeRecoveryExhaustedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    profile_id?: string;
+    session_id?: string;
+    session_name?: string;
+    session_type?: string;
+    agent_name?: string;
+    workspace_id?: string;
+    workspace?: string;
+    worktree_id?: string;
+    acp_session_id?: string;
+    state?: string;
+    soul_snapshot_id?: string;
+    soul_digest?: string;
+    created_at: ISODateTime;
+    updated_at: ISODateTime;
+    turn_id?: string;
+    attempt: number;
+    max_attempts: number;
+    generation: number;
+    failure_kind?: string;
+    failure_detail?: string;
+}
+export interface SessionRuntimeRecoveryStartedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    profile_id?: string;
+    session_id?: string;
+    session_name?: string;
+    session_type?: string;
+    agent_name?: string;
+    workspace_id?: string;
+    workspace?: string;
+    worktree_id?: string;
+    acp_session_id?: string;
+    state?: string;
+    soul_snapshot_id?: string;
+    soul_digest?: string;
+    created_at: ISODateTime;
+    updated_at: ISODateTime;
+    turn_id?: string;
+    attempt: number;
+    max_attempts: number;
+    generation: number;
+    failure_kind?: string;
+    failure_detail?: string;
+}
+export interface SessionRuntimeRecoverySucceededPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    profile_id?: string;
+    session_id?: string;
+    session_name?: string;
+    session_type?: string;
+    agent_name?: string;
+    workspace_id?: string;
+    workspace?: string;
+    worktree_id?: string;
+    acp_session_id?: string;
+    state?: string;
+    soul_snapshot_id?: string;
+    soul_digest?: string;
+    created_at: ISODateTime;
+    updated_at: ISODateTime;
+    turn_id?: string;
+    attempt: number;
+    max_attempts: number;
+    generation: number;
+    failure_kind?: string;
+    failure_detail?: string;
+}
 export interface SessionRuntimeSelectionPayload {
     provider: string;
     model?: string;
@@ -4124,6 +4330,15 @@ export interface SessionSoulRefreshRequest {
 }
 export type SessionRuntimeStatus = string;
 export type SessionRuntimeTransition = string;
+export interface SessionRuntimeRecoveryPayload {
+    attempt: number;
+    max_attempts: number;
+    generation: number;
+    started_at: ISODateTime;
+    last_attempt_at: ISODateTime;
+    next_attempt_at?: ISODateTime;
+    last_error?: string;
+}
 export type ResolutionStatus = string;
 export type ResolutionReason = string;
 export interface Resolution {
@@ -4163,6 +4378,8 @@ export interface SessionRuntimePayload {
     status: SessionRuntimeStatus;
     transition?: SessionRuntimeTransition;
     failure?: string;
+    generation?: number;
+    recovery?: SessionRuntimeRecoveryPayload;
     selected?: PromptRuntimeSelectionPayload;
     selection_revision: number;
     effective?: RuntimeSelectionPayload;
@@ -4274,6 +4491,7 @@ export interface SkillSummary {
     name: string;
     description?: string;
     source: string;
+    origin: string;
     enabled: boolean;
     activation: SkillActivationPayload;
 }
@@ -4282,6 +4500,7 @@ export interface SkillsListParams {
     for_agent?: string;
 }
 export interface SpawnContext {
+    profile_id?: string;
     parent_session_id?: string;
     root_session_id?: string;
     child_session_id?: string;
@@ -4311,6 +4530,7 @@ export interface SpawnCreatePatch {
 export interface SpawnCreatedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     parent_session_id?: string;
     root_session_id?: string;
     child_session_id?: string;
@@ -4337,6 +4557,7 @@ export interface SpawnCreatedPayload {
 export interface SpawnLifecyclePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     parent_session_id?: string;
     root_session_id?: string;
     child_session_id?: string;
@@ -4366,6 +4587,7 @@ export interface SpawnObservationPatch {
 export interface SpawnParentStoppedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     parent_session_id?: string;
     root_session_id?: string;
     child_session_id?: string;
@@ -4392,6 +4614,7 @@ export interface SpawnParentStoppedPayload {
 export interface SpawnPreCreatePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     parent_session_id?: string;
     root_session_id?: string;
     child_session_id?: string;
@@ -4417,6 +4640,7 @@ export interface SpawnPreCreatePayload {
 export interface SpawnReapedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     parent_session_id?: string;
     root_session_id?: string;
     child_session_id?: string;
@@ -4443,6 +4667,7 @@ export interface SpawnReapedPayload {
 export interface SpawnTTLExpiredPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     parent_session_id?: string;
     root_session_id?: string;
     child_session_id?: string;
@@ -4487,8 +4712,21 @@ export interface Origin {
     kind: OriginKind;
     ref: string;
 }
+export type LoopProvenanceRole = "coordinator" | "cell";
+export interface LoopProvenance {
+    run_id: string;
+    loop_name?: string;
+    role: LoopProvenanceRole;
+    generation?: number;
+    node_id?: string;
+    item_index?: number;
+}
 export interface Task {
     id: string;
+    profile_id: string;
+    profile_name: string;
+    profile_color?: string;
+    profile_icon?: string;
     identifier?: string;
     scope: Scope;
     workspace_id?: string;
@@ -4524,10 +4762,12 @@ export interface Task {
     updated_at: ISODateTime;
     closed_at?: ISODateTime;
     metadata?: JSONValue;
+    loop?: LoopProvenance;
 }
 export interface TaskBlockedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     parent_task_id?: string;
     workspace_id?: string;
@@ -4555,6 +4795,7 @@ export interface TaskCancelParams {
     metadata?: JSONValue;
 }
 export interface TaskContext {
+    profile_id?: string;
     task_id?: string;
     parent_task_id?: string;
     workspace_id?: string;
@@ -4796,6 +5037,10 @@ export interface TaskRunSummaryPayload {
 }
 export interface TaskSummaryPayload {
     id: string;
+    profile_id: string;
+    profile_name: string;
+    profile_color?: string;
+    profile_icon?: string;
     identifier?: string;
     scope: Scope;
     workspace_id?: string;
@@ -4843,6 +5088,10 @@ export interface TaskDependencyPayload {
 }
 export interface TaskRun {
     id: string;
+    profile_id?: string;
+    profile_name?: string;
+    profile_color?: string;
+    profile_icon?: string;
     task_id: string;
     status: RunStatus;
     attempt: number;
@@ -4994,6 +5243,7 @@ export interface TaskInboxParams {
 export interface TaskNeedsAttentionPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     parent_task_id?: string;
     workspace_id?: string;
@@ -5018,6 +5268,7 @@ export interface TaskObservationPatch {
 export interface TaskRecoveredPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     parent_task_id?: string;
     workspace_id?: string;
@@ -5063,6 +5314,7 @@ export interface TaskRunCompleteParams {
 export interface TaskRunCompletedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     run_id?: string;
     run_kind?: string;
@@ -5093,6 +5345,7 @@ export interface TaskRunCompletedPayload {
     recovery_reason?: string;
 }
 export interface TaskRunContext {
+    profile_id?: string;
     task_id?: string;
     run_id?: string;
     run_kind?: string;
@@ -5169,6 +5422,7 @@ export interface TaskRunEnqueueParams {
 export interface TaskRunEnqueuedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     run_id?: string;
     run_kind?: string;
@@ -5203,6 +5457,7 @@ export interface TaskRunFailParams {
 export interface TaskRunFailedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     run_id?: string;
     run_kind?: string;
@@ -5238,6 +5493,7 @@ export interface TaskRunGetParams {
 export interface TaskRunLeaseExpiredPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     run_id?: string;
     run_kind?: string;
@@ -5270,6 +5526,7 @@ export interface TaskRunLeaseExpiredPayload {
 export interface TaskRunLeaseExtendedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     run_id?: string;
     run_kind?: string;
@@ -5302,6 +5559,7 @@ export interface TaskRunLeaseExtendedPayload {
 export interface TaskRunLeasePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     run_id?: string;
     run_kind?: string;
@@ -5334,6 +5592,7 @@ export interface TaskRunLeasePayload {
 export interface TaskRunLeaseRecoveredPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     run_id?: string;
     run_kind?: string;
@@ -5369,6 +5628,7 @@ export interface TaskRunObservationPatch {
 export interface TaskRunPostClaimPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     run_id?: string;
     run_kind?: string;
@@ -5404,6 +5664,7 @@ export interface TaskRunPreClaimPatch {
 export interface TaskRunPreClaimPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     run_id?: string;
     run_kind?: string;
@@ -5435,6 +5696,7 @@ export interface TaskRunPreClaimPayload {
 export interface TaskRunReleasedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     run_id?: string;
     run_kind?: string;
@@ -5478,6 +5740,7 @@ export interface TaskRunsParams {
 export interface TaskStatusChangedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     parent_task_id?: string;
     workspace_id?: string;
@@ -5504,6 +5767,7 @@ export interface TaskTimelineItem {
     task: TaskReferencePayload;
     run?: TaskRunSummaryPayload;
     event_type: string;
+    reason?: string;
     actor: ActorIdentity;
     origin: Origin;
     payload?: JSONValue;
@@ -5532,6 +5796,7 @@ export interface TaskTreeParams {
 export interface TaskUnblockedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     task_id?: string;
     parent_task_id?: string;
     workspace_id?: string;
@@ -5573,6 +5838,8 @@ export interface TasksParams {
     status?: Status;
     priority?: Priority;
     include_drafts?: boolean;
+    include_loop?: boolean;
+    loop_run_id?: string;
     approval_state?: ApprovalState;
     owner_kind?: OwnerKind;
     owner_ref?: string;
@@ -5586,6 +5853,10 @@ export interface TasksParams {
 }
 export interface TaskCatalogItemPayload {
     id: string;
+    profile_id: string;
+    profile_name: string;
+    profile_color?: string;
+    profile_icon?: string;
     identifier?: string;
     scope: Scope;
     workspace_id?: string;
@@ -5616,6 +5887,7 @@ export interface TaskCatalogItemPayload {
     dependency_count?: number;
     active_run?: TaskCatalogRunPayload;
     last_activity_at?: ISODateTime;
+    loop?: LoopProvenance;
 }
 export interface TaskCatalogStatusFacetPayload {
     status: Status;
@@ -5652,6 +5924,7 @@ export interface SourceRef {
     raw_tool_name?: string;
     resource_id?: string;
     resource_version?: string;
+    profile_id?: string;
     workspace_id?: string;
     scope?: string;
 }
@@ -5696,6 +5969,7 @@ export interface ToolCallRef {
 export interface ToolPostCallPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -5727,6 +6001,7 @@ export interface ToolPostErrorPatch {
 export interface ToolPostErrorPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -5751,6 +6026,7 @@ export interface ToolPostErrorPayload {
 export interface ToolPreCallPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -5792,6 +6068,7 @@ export interface TurnEndPatch {
 export interface TurnEndPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -5817,6 +6094,7 @@ export interface TurnPatch {
 export interface TurnPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -5842,6 +6120,7 @@ export interface TurnStartPatch {
 export interface TurnStartPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     session_id?: string;
     session_name?: string;
     session_type?: string;
@@ -5859,8 +6138,14 @@ export interface TurnStartPayload {
     input_class?: string;
     user_message?: string;
 }
+export type ProfileLensID = string;
+export interface ProfileLens {
+    profile_lens_id: ProfileLensID;
+    profile_name: string;
+}
 export interface ViewCloseRequest {
     view_session: string;
+    profile_lens: ProfileLens;
     reason?: string;
 }
 export interface ViewEvent {
@@ -6070,6 +6355,7 @@ export type ClientID = string;
 export interface ViewOpenRequest {
     view_session: string;
     view: string;
+    profile_lens: ProfileLens;
     workspace: WorkspaceID;
     client: ClientID;
     args?: Record<string, JSONValue>;
@@ -6186,6 +6472,7 @@ export type WorktreeObservationPatch = Record<string, never>;
 export interface WorktreeObservationPayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     worktree_id: string;
     workspace_id: string;
     workspace_root?: string;
@@ -6198,6 +6485,7 @@ export interface WorktreeObservationPayload {
 export interface WorktreePreCreatePayload {
     event: HookEvent;
     timestamp: ISODateTime;
+    profile_id?: string;
     worktree_id: string;
     workspace_id: string;
     workspace_root?: string;
@@ -6210,6 +6498,7 @@ export interface WorktreePreCreatePayload {
     deny_reason?: string;
 }
 export interface WorktreeContext {
+    profile_id?: string;
     worktree_id: string;
     workspace_id: string;
     workspace_root?: string;
@@ -6243,6 +6532,9 @@ export interface HookPayloadByEvent {
     "session.pre_stop": SessionPreStopPayload;
     "session.post_stop": SessionPostStopPayload;
     "session.message_persisted": SessionMessagePersistedPayload;
+    "session.runtime_recovery.started": SessionRuntimeRecoveryStartedPayload;
+    "session.runtime_recovery.succeeded": SessionRuntimeRecoverySucceededPayload;
+    "session.runtime_recovery.exhausted": SessionRuntimeRecoveryExhaustedPayload;
     "sandbox.prepare": SandboxPreparePayload;
     "sandbox.ready": SandboxReadyPayload;
     "sandbox.sync.before": SandboxSyncBeforePayload;
@@ -6346,6 +6638,9 @@ export interface HookPatchByEvent {
     "session.pre_stop": SessionPreStopPatch;
     "session.post_stop": SessionPostStopPatch;
     "session.message_persisted": AuthoredContextObservationPatch;
+    "session.runtime_recovery.started": AuthoredContextObservationPatch;
+    "session.runtime_recovery.succeeded": AuthoredContextObservationPatch;
+    "session.runtime_recovery.exhausted": AuthoredContextObservationPatch;
     "sandbox.prepare": SandboxPreparePatch;
     "sandbox.ready": SandboxReadyPatch;
     "sandbox.sync.before": SandboxSyncBeforePatch;