@compozy/extension-sdk 0.3.0-beta.22 → 0.3.0-beta.24

package/dist/cjs/generated/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/generated/contracts.ts"],"names":[],"mappings":";;;AAmhQa,QAAA,2BAA2B,GAAG;IACzC,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;IACjE,uBAAuB,EAAE;QACvB,wBAAwB;QACxB,qBAAqB;QACrB,uBAAuB;KACxB;IACD,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,iBAAiB,EAAE,cAAc,CAAC;IAC3E,mBAAmB,EAAE,CAAC,YAAY,CAAC;IACnC,gBAAgB,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,cAAc,CAAC;IACpE,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,eAAe,EAAE,CAAC,eAAe,EAAE,YAAY,CAAC;IAChD,eAAe,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC;CACI,CAAC;AAOpD,QAAA,mCAAmC,GAAyC;IACvF;QACE,OAAO,EAAE,uBAAuB;QAChC,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,uBAAuB,CAAC;KACvE;IACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,gBAAgB,CAAC,EAAE;IAC9F;QACE,OAAO,EAAE,mBAAmB;QAC5B,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,mBAAmB,CAAC;KACnE;IACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,gBAAgB,CAAC,EAAE;IAC9F,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,cAAc,CAAC,EAAE;IAC1F,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,eAAe,CAAC,EAAE;IAC5F,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,eAAe,CAAC,EAAE;CAC7F,CAAC"}
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/generated/contracts.ts"],"names":[],"mappings":";;;AAqwQa,QAAA,2BAA2B,GAAG;IACzC,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;IACjE,uBAAuB,EAAE;QACvB,wBAAwB;QACxB,qBAAqB;QACrB,uBAAuB;KACxB;IACD,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,iBAAiB,EAAE,cAAc,CAAC;IAC3E,mBAAmB,EAAE,CAAC,YAAY,CAAC;IACnC,gBAAgB,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,cAAc,CAAC;IACpE,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,eAAe,EAAE,CAAC,eAAe,EAAE,YAAY,CAAC;IAChD,eAAe,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC;CACI,CAAC;AAOpD,QAAA,mCAAmC,GAAyC;IACvF;QACE,OAAO,EAAE,uBAAuB;QAChC,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,uBAAuB,CAAC;KACvE;IACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,gBAAgB,CAAC,EAAE;IAC9F;QACE,OAAO,EAAE,mBAAmB;QAC5B,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,mBAAmB,CAAC;KACnE;IACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,gBAAgB,CAAC,EAAE;IAC9F,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,cAAc,CAAC,EAAE;IAC1F,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,eAAe,CAAC,EAAE;IAC5F,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,QAAA,2BAA2B,CAAC,eAAe,CAAC,EAAE;CAC7F,CAAC"}

package/dist/esm/generated/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/generated/contracts.ts"],"names":[],"mappings":"AAmhQA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;IACjE,uBAAuB,EAAE;QACvB,wBAAwB;QACxB,qBAAqB;QACrB,uBAAuB;KACxB;IACD,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,iBAAiB,EAAE,cAAc,CAAC;IAC3E,mBAAmB,EAAE,CAAC,YAAY,CAAC;IACnC,gBAAgB,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,cAAc,CAAC;IACpE,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,eAAe,EAAE,CAAC,eAAe,EAAE,YAAY,CAAC;IAChD,eAAe,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC;CACI,CAAC;AAOjE,MAAM,CAAC,MAAM,mCAAmC,GAAyC;IACvF;QACE,OAAO,EAAE,uBAAuB;QAChC,gBAAgB,EAAE,2BAA2B,CAAC,uBAAuB,CAAC;KACvE;IACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,EAAE;IAC9F;QACE,OAAO,EAAE,mBAAmB;QAC5B,gBAAgB,EAAE,2BAA2B,CAAC,mBAAmB,CAAC;KACnE;IACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,EAAE;IAC9F,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,cAAc,CAAC,EAAE;IAC1F,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,eAAe,CAAC,EAAE;IAC5F,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,eAAe,CAAC,EAAE;CAC7F,CAAC"}
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/generated/contracts.ts"],"names":[],"mappings":"AAqwQA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;IACjE,uBAAuB,EAAE;QACvB,wBAAwB;QACxB,qBAAqB;QACrB,uBAAuB;KACxB;IACD,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,iBAAiB,EAAE,cAAc,CAAC;IAC3E,mBAAmB,EAAE,CAAC,YAAY,CAAC;IACnC,gBAAgB,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,cAAc,CAAC;IACpE,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,eAAe,EAAE,CAAC,eAAe,EAAE,YAAY,CAAC;IAChD,eAAe,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,CAAC;CACI,CAAC;AAOjE,MAAM,CAAC,MAAM,mCAAmC,GAAyC;IACvF;QACE,OAAO,EAAE,uBAAuB;QAChC,gBAAgB,EAAE,2BAA2B,CAAC,uBAAuB,CAAC;KACvE;IACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,EAAE;IAC9F;QACE,OAAO,EAAE,mBAAmB;QAC5B,gBAAgB,EAAE,2BAA2B,CAAC,mBAAmB,CAAC;KACnE;IACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,EAAE;IAC9F,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,cAAc,CAAC,EAAE;IAC1F,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,eAAe,CAAC,EAAE;IAC5F,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,eAAe,CAAC,EAAE;CAC7F,CAAC"}

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

@@ -7,7 +7,7 @@ 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" | "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 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" | "terminal.opened" | "terminal.closed" | "terminal.command_started" | "terminal.command_finished" | "terminal.input_requested" | "terminal.input_provided" | "terminal.recording_started" | "terminal.recording_stopped" | "terminal.subscriber_evicted" | "terminal.limit_rejected";
 export interface AgentCrashedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
@@ -1576,6 +1576,7 @@ export interface Redaction {
     reason: ReasonCode;
     bytes?: number;
 }
+export type ResultTrust = string;
 export interface ToolResult {
     content?: ToolContent[];
     structured?: JSONValue;
@@ -1586,6 +1587,7 @@ export interface ToolResult {
     truncated: boolean;
     bytes: number;
     duration_ms: number;
+    trust?: ResultTrust;
 }
 export interface ExtensionToolCallResponse {
     result: ToolResult;
@@ -1826,10 +1828,15 @@ export interface HeartbeatWakeEventPayload {
     created_at: ISODateTime;
     expires_at: ISODateTime;
 }
+export type State = "starting" | "active" | "stopping" | "stopped";
 export type SessionHealthState = "idle" | "prompting" | "stopped" | "detached";
 export type SessionHealthStatus = "healthy" | "degraded" | "stale" | "dead" | "unknown";
 export type SessionHealthIneligibilityReason = "session_prompt_active" | "session_not_attachable" | "session_unhealthy" | "session_health_stale" | "session_health_hung" | "session_health_dead" | "session_health_unknown";
 export interface SessionHealthPayload {
+    lifecycle_state?: State;
+    verified?: boolean;
+    escalated?: boolean;
+    attention?: string;
     session_id: string;
     workspace_id: string;
     agent_name: string;
@@ -1941,7 +1948,7 @@ export interface HookDecl {
     source: HookSource;
     required?: boolean;
 }
-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 HookEventFamily = "session" | "sandbox" | "input" | "prompt" | "event" | "automation" | "agent" | "turn" | "message" | "tool" | "permission" | "context" | "coordinator" | "task" | "task.run" | "loop" | "spawn" | "network" | "window_manager" | "worktree" | "terminal";
 export type HookRunOutcome = "applied" | "denied" | "failed" | "skipped" | "dropped" | "rejected";
 export type HookSkillSource = "bundled" | "marketplace" | "user" | "profile" | "additional" | "workspace" | "workspace_profile";
 export interface InboundAction {
@@ -2553,7 +2560,7 @@ export interface ModelSourceListParams {
     refresh?: boolean;
     include_stale?: boolean;
 }
-export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+export type ReasoningEffort = string;
 export type ModelSourceOptionKind = string;
 export interface ModelSourceOptionValue {
     value_id: string;
@@ -4008,6 +4015,7 @@ export interface SessionHealthUpdateAfterPayload {
     last_presence_at: ISODateTime;
     last_error?: string;
 }
+export type SteerDeliveryMode = "injected" | "pending_injection" | "interrupt_fallback";
 export type PromptMode = string;
 export type PromptDelivery = string;
 export type Speed = string;
@@ -4024,6 +4032,7 @@ export interface PromptRuntimeSelectionPayload {
     acp_options?: AgentACPOptionSelection[];
 }
 export interface SessionInput {
+    steer_delivery?: SteerDeliveryMode;
     id: string;
     session_id: string;
     message_id?: string;
@@ -4278,7 +4287,11 @@ export interface SessionPreStopPayload {
     created_at: ISODateTime;
     updated_at: ISODateTime;
 }
+export type Disposition = "direct" | "steering" | "queued" | "interrupting";
 export interface SessionPromptResult {
+    disposition?: Disposition;
+    steer_delivery?: SteerDeliveryMode;
+    entry_id?: string;
     status: string;
     mode?: PromptMode;
     delivery: PromptDelivery;
@@ -4316,6 +4329,7 @@ export interface SessionRuntimeRecoveryExhaustedPayload {
     created_at: ISODateTime;
     updated_at: ISODateTime;
     turn_id?: string;
+    run_id: string;
     attempt: number;
     max_attempts: number;
     generation: number;
@@ -4340,6 +4354,7 @@ export interface SessionRuntimeRecoveryStartedPayload {
     created_at: ISODateTime;
     updated_at: ISODateTime;
     turn_id?: string;
+    run_id: string;
     attempt: number;
     max_attempts: number;
     generation: number;
@@ -4364,6 +4379,7 @@ export interface SessionRuntimeRecoverySucceededPayload {
     created_at: ISODateTime;
     updated_at: ISODateTime;
     turn_id?: string;
+    run_id: string;
     attempt: number;
     max_attempts: number;
     generation: number;
@@ -4439,7 +4455,6 @@ export interface SessionRuntimePayload {
     acp_session_id?: string;
     acp_caps?: ACPCapsPayload;
 }
-export type State = "starting" | "active" | "stopping" | "stopped";
 export type StopReason = "completed" | "user_canceled" | "max_iterations" | "loop_detected" | "timeout" | "budget_exceeded" | "error" | "agent_crashed" | "hook_stopped" | "shutdown";
 export interface SessionStatus {
     session_id: string;
@@ -4459,6 +4474,10 @@ export interface SessionStatusGetParams {
     workspace_id: string;
     session_id: string;
 }
+export interface SessionQueueSummaryPayload {
+    entries: number;
+    cap: number;
+}
 export type Badge = string;
 export interface PendingInteractionPayload {
     interaction_id: string;
@@ -4468,6 +4487,7 @@ export interface PendingInteractionPayload {
     title?: string;
     choices?: string[];
     decisions?: string[];
+    tool_id?: string;
     status: string;
     created_at: ISODateTime;
     resolved_at?: ISODateTime;
@@ -4475,6 +4495,11 @@ export interface PendingInteractionPayload {
     resolved_by?: string;
 }
 export interface SessionStatusResponse {
+    queue?: SessionQueueSummaryPayload;
+    lifecycle_state?: State;
+    verified?: boolean;
+    escalated?: boolean;
+    attention?: string;
     session_id: string;
     workspace_id: string;
     agent_name: string;
@@ -5976,6 +6001,176 @@ export interface TasksResponse {
     page: CountedCursorPagePayload;
     facets: TaskCatalogFacetsPayload;
 }
+export interface TerminalExit {
+    cause: string;
+    code?: number;
+    signal?: string;
+}
+export interface TerminalClosedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    workspace_id: string;
+    profile_id: string;
+    terminal_id?: string;
+    actor_kind: string;
+    actor_id: string;
+    session_id?: string;
+    run_id?: string;
+    generation?: number;
+    at: ISODateTime;
+    exit: TerminalExit;
+    reason: string;
+}
+export interface TerminalCommandFinishedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    workspace_id: string;
+    profile_id: string;
+    terminal_id?: string;
+    actor_kind: string;
+    actor_id: string;
+    session_id?: string;
+    run_id?: string;
+    generation?: number;
+    at: ISODateTime;
+    command_id: string;
+    exit_code?: number;
+    signal?: string;
+    exit_cause: string;
+    duration_ms: number;
+    detected_by: string;
+    approval: string;
+}
+export interface TerminalCommandStartedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    workspace_id: string;
+    profile_id: string;
+    terminal_id?: string;
+    actor_kind: string;
+    actor_id: string;
+    session_id?: string;
+    run_id?: string;
+    generation?: number;
+    at: ISODateTime;
+    command_id: string;
+    command: string;
+    cwd: string;
+    detected_by: string;
+}
+export interface TerminalInputProvidedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    workspace_id: string;
+    profile_id: string;
+    terminal_id?: string;
+    actor_kind: string;
+    actor_id: string;
+    session_id?: string;
+    run_id?: string;
+    generation?: number;
+    at: ISODateTime;
+    request_id: string;
+    redacted: boolean;
+    length: number;
+    outcome: string;
+}
+export interface TerminalInputRequestedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    workspace_id: string;
+    profile_id: string;
+    terminal_id?: string;
+    actor_kind: string;
+    actor_id: string;
+    session_id?: string;
+    run_id?: string;
+    generation?: number;
+    at: ISODateTime;
+    request_id: string;
+    reason: string;
+    redacted: boolean;
+}
+export interface TerminalLimitRejectedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    workspace_id: string;
+    profile_id: string;
+    terminal_id?: string;
+    actor_kind: string;
+    actor_id: string;
+    session_id?: string;
+    run_id?: string;
+    generation?: number;
+    at: ISODateTime;
+    limit: string;
+    current: number;
+    max: number;
+}
+export type TerminalObservationPatch = Record<string, never>;
+export interface TerminalOpenedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    workspace_id: string;
+    profile_id: string;
+    terminal_id?: string;
+    actor_kind: string;
+    actor_id: string;
+    session_id?: string;
+    run_id?: string;
+    generation?: number;
+    at: ISODateTime;
+    mode: string;
+    cwd: string;
+    title?: string;
+}
+export interface TerminalRecordingStartedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    workspace_id: string;
+    profile_id: string;
+    terminal_id?: string;
+    actor_kind: string;
+    actor_id: string;
+    session_id?: string;
+    run_id?: string;
+    generation?: number;
+    at: ISODateTime;
+    recording_id: string;
+}
+export interface TerminalRecordingStoppedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    workspace_id: string;
+    profile_id: string;
+    terminal_id?: string;
+    actor_kind: string;
+    actor_id: string;
+    session_id?: string;
+    run_id?: string;
+    generation?: number;
+    at: ISODateTime;
+    recording_id: string;
+    digest: string;
+    bytes: number;
+    reason: string;
+    truncated: boolean;
+}
+export interface TerminalSubscriberEvictedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    workspace_id: string;
+    profile_id: string;
+    terminal_id?: string;
+    actor_kind: string;
+    actor_id: string;
+    session_id?: string;
+    run_id?: string;
+    generation?: number;
+    at: ISODateTime;
+    flow: string;
+    reason: string;
+}
 export type BackendKind = string;
 export interface BackendRef {
     kind: BackendKind;
@@ -6699,6 +6894,16 @@ export interface HookPayloadByEvent {
     "worktree.created": WorktreeObservationPayload;
     "worktree.adopted": WorktreeObservationPayload;
     "worktree.removed": WorktreeObservationPayload;
+    "terminal.opened": TerminalOpenedPayload;
+    "terminal.closed": TerminalClosedPayload;
+    "terminal.command_started": TerminalCommandStartedPayload;
+    "terminal.command_finished": TerminalCommandFinishedPayload;
+    "terminal.input_requested": TerminalInputRequestedPayload;
+    "terminal.input_provided": TerminalInputProvidedPayload;
+    "terminal.recording_started": TerminalRecordingStartedPayload;
+    "terminal.recording_stopped": TerminalRecordingStoppedPayload;
+    "terminal.subscriber_evicted": TerminalSubscriberEvictedPayload;
+    "terminal.limit_rejected": TerminalLimitRejectedPayload;
 }
 export interface HookPatchByEvent {
     "session.pre_create": SessionCreatePatch;
@@ -6805,6 +7010,16 @@ export interface HookPatchByEvent {
     "worktree.created": WorktreeObservationPatch;
     "worktree.adopted": WorktreeObservationPatch;
     "worktree.removed": WorktreeObservationPatch;
+    "terminal.opened": TerminalObservationPatch;
+    "terminal.closed": TerminalObservationPatch;
+    "terminal.command_started": TerminalObservationPatch;
+    "terminal.command_finished": TerminalObservationPatch;
+    "terminal.input_requested": TerminalObservationPatch;
+    "terminal.input_provided": TerminalObservationPatch;
+    "terminal.recording_started": TerminalObservationPatch;
+    "terminal.recording_stopped": TerminalObservationPatch;
+    "terminal.subscriber_evicted": TerminalObservationPatch;
+    "terminal.limit_rejected": TerminalObservationPatch;
 }
 export interface HostAPIMethodMap {
     "sessions/list": {