@compozy/extension-sdk 0.3.0-beta.16 → 0.3.0-beta.18

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" | "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" | "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";
+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 interface AgentCrashedPayload {
     event: HookEvent;
     timestamp: ISODateTime;
@@ -17,6 +17,7 @@ export interface AgentCrashedPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -97,6 +98,7 @@ export interface AgentHeartbeatWakeAfterPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -121,6 +123,7 @@ export interface AgentHeartbeatWakeBeforePayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -154,6 +157,7 @@ export interface AgentLifecyclePayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -177,6 +181,7 @@ export interface AgentPreStartPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -397,6 +402,7 @@ export interface AgentSpawnedPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -430,6 +436,7 @@ export interface AgentStoppedPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -955,6 +962,7 @@ export interface ContextCompactPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -990,6 +998,7 @@ export interface ContextPostCompactPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -1018,6 +1027,7 @@ export interface ContextPreCompactPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -1346,6 +1356,7 @@ export interface EventPostRecordPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -1369,6 +1380,7 @@ export interface EventPreRecordPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -1392,6 +1404,7 @@ export interface EventRecordPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -1453,9 +1466,15 @@ export interface ToolResult {
 export interface ExtensionToolCallResponse {
     result: ToolResult;
 }
-export type IssueSeverity = "error" | "warning";
+export interface ExtensionValidationComponent {
+    kind: string;
+    name: string;
+    transport?: string;
+}
+export type IssueSeverity = "error" | "warning" | "warn";
 export interface ValidationIssue {
     path: string;
+    scope?: string;
     line?: number;
     column?: number;
     field?: string;
@@ -1463,9 +1482,60 @@ export interface ValidationIssue {
     severity: IssueSeverity;
 }
 export interface ExtensionValidatePayload {
+    status: string;
+    format: string;
+    name?: string;
+    version?: string;
+    would_ingest?: ExtensionValidationComponent[];
     manifest?: ExtensionManifestSummary;
     issues: ValidationIssue[];
-    consent_areas: ConsentArea[];
+    consent_areas?: ConsentArea[];
+}
+export interface ForgeCapabilitiesRequest {
+    remote_urls: string[];
+}
+export interface ForgeCapabilitiesResponse {
+    served: boolean;
+    available: boolean;
+    winner?: string;
+    provider?: string;
+    served_remote?: string;
+    request_noun?: string;
+    open_action_label?: string;
+    view_action_label?: string;
+    supports_draft?: boolean;
+    compare_url_template?: string;
+    template_paths?: string[];
+    credential_source?: string;
+    default_branch?: string;
+    cause?: string;
+}
+export interface ForgePRCreateRequest {
+    remote_urls: string[];
+    head: string;
+    base: string;
+    title: string;
+    body?: string;
+    draft?: boolean;
+}
+export interface ForgePRCreateResponse {
+    status: string;
+    number?: number;
+    url?: string;
+    cause?: string;
+}
+export interface ForgeStatusRequest {
+    remote_urls: string[];
+    branch: string;
+}
+export interface ForgeStatusResponse {
+    provider: string;
+    pr_number?: number;
+    pr_state?: string;
+    pr_url?: string;
+    merged?: boolean;
+    fetched_at: ISODateTime;
+    cause?: string;
 }
 export interface HeartbeatDeleteRequest {
     workspace_id?: string;
@@ -1700,6 +1770,7 @@ export interface HookMatcher {
     agent_name?: string;
     agent_type?: string;
     workspace_id?: string;
+    worktree_id?: string;
     workspace_root?: string;
     session_type?: string;
     sandbox_id?: string;
@@ -1745,7 +1816,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";
+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 interface InboundAction {
@@ -1892,6 +1963,13 @@ export interface InputPreSubmitPatch {
     message?: string;
     context_blocks?: ContextBlock[];
 }
+export interface InputAttachmentMetadata {
+    id: string;
+    name: string;
+    mime: string;
+    bytes: number;
+    kind: string;
+}
 export interface InputPreSubmitPayload {
     event: HookEvent;
     timestamp: ISODateTime;
@@ -1901,6 +1979,7 @@ export interface InputPreSubmitPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -1911,6 +1990,7 @@ export interface InputPreSubmitPayload {
     input_class?: string;
     message?: string;
     context_blocks?: ContextBlock[];
+    attachments?: InputAttachmentMetadata[];
 }
 export interface ListLogsParams {
     workspace_id: string;
@@ -2223,6 +2303,7 @@ export interface MessageDeltaPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -2252,6 +2333,7 @@ export interface MessageEndPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -2281,6 +2363,7 @@ export interface MessagePayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -2310,6 +2393,7 @@ export interface MessageStartPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3122,6 +3206,7 @@ export interface PermissionDeniedPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3134,7 +3219,6 @@ export interface PermissionDeniedPayload {
     resource?: string;
     decision?: string;
     decision_class?: string;
-    tool_input?: JSONValue;
     tool_call: PermissionToolCall;
 }
 export interface PermissionOption {
@@ -3159,6 +3243,7 @@ export interface PermissionRequestPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3184,6 +3269,7 @@ export interface PermissionResolutionPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3209,6 +3295,7 @@ export interface PermissionResolvedPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3247,6 +3334,7 @@ export interface PromptPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3446,6 +3534,7 @@ export interface SandboxPreparePayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3475,6 +3564,7 @@ export interface SandboxReadyPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3501,6 +3591,7 @@ export interface SandboxStopPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3527,6 +3618,7 @@ export interface SandboxSyncAfterPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3559,6 +3651,7 @@ export interface SandboxSyncBeforePayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3576,6 +3669,28 @@ export interface SandboxSyncBeforePayload {
     denied?: boolean;
     deny_reason?: string;
 }
+export interface SessionAttentionChangedPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    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;
+    from: string;
+    to: string;
+    class: string;
+    at: ISODateTime;
+}
+export type SessionAttentionObservationPatch = Record<string, never>;
 export interface SessionContext {
     session_id?: string;
     session_name?: string;
@@ -3583,6 +3698,7 @@ export interface SessionContext {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3633,6 +3749,7 @@ export interface SessionHealthUpdateAfterPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3721,6 +3838,7 @@ export interface SessionLifecyclePayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3737,6 +3855,7 @@ export interface SessionMessagePersistedPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3773,6 +3892,7 @@ export interface SessionPostCreatePayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3798,6 +3918,7 @@ export interface SessionPostResumePayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3823,6 +3944,7 @@ export interface SessionPostStopPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3839,6 +3961,7 @@ export interface SessionPreCreatePayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3864,6 +3987,7 @@ export interface SessionPreResumePayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3889,6 +4013,7 @@ export interface SessionPreStopPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -3969,6 +4094,9 @@ export interface SessionConfigOptionPayload {
 }
 export interface ACPCapsPayload {
     supports_load_session: boolean;
+    prompt_image: boolean;
+    prompt_audio: boolean;
+    prompt_embedded_context: boolean;
     supported_modes?: string[];
     config_options?: SessionConfigOptionPayload[];
 }
@@ -4002,17 +4130,34 @@ export interface SessionStatusGetParams {
     workspace_id: string;
     session_id: string;
 }
+export type Badge = string;
+export interface PendingInteractionPayload {
+    interaction_id: string;
+    kind: string;
+    provider_request_id: string;
+    turn_id?: string;
+    title?: string;
+    choices?: string[];
+    decisions?: string[];
+    status: string;
+    created_at: ISODateTime;
+    resolved_at?: ISODateTime;
+    resolution?: string;
+    resolved_by?: string;
+}
 export interface SessionStatusResponse {
     session_id: string;
     workspace_id: string;
     agent_name: string;
     state: SessionHealthState;
+    badge: Badge;
     health: SessionHealthStatus;
     active_prompt: boolean;
     attachable: boolean;
     eligible_for_wake: boolean;
     ineligibility_reason?: SessionHealthIneligibilityReason;
     wake_state?: HeartbeatWakeStatePayload;
+    pending_interactions: PendingInteractionPayload[];
     updated_at: ISODateTime;
 }
 export interface SessionSummary {
@@ -4518,6 +4663,7 @@ export interface TaskDashboard {
 export interface TaskDashboardParams {
     scope?: Scope;
     workspace?: string;
+    worktree?: string;
     owner_kind?: OwnerKind;
     owner_ref?: string;
     participation_channel?: string;
@@ -4545,6 +4691,7 @@ export interface TaskDependencyReferencePayload {
     created_at: ISODateTime;
     depends_on: TaskReferencePayload;
 }
+export type ResolvedWorktreeMode = string;
 export type CoordinationMessageKind = string;
 export interface CoordinationChannelPayload {
     id: string;
@@ -4571,6 +4718,9 @@ export interface TaskRunSummaryPayload {
     failure_kind?: string;
     max_attempts: number;
     session_id?: string;
+    worktree_id?: string;
+    resolved_worktree_mode: ResolvedWorktreeMode;
+    resolved_worktree_ref?: string;
     claimed_by?: ActorIdentity;
     claim_token_hash?: string;
     lease_until?: ISODateTime;
@@ -4642,6 +4792,9 @@ export interface TaskRun {
     failure_kind?: string;
     claimed_by?: ActorIdentity;
     session_id?: string;
+    worktree_id?: string;
+    resolved_worktree_mode: ResolvedWorktreeMode;
+    resolved_worktree_ref?: string;
     origin: Origin;
     idempotency_key?: string;
     resolved_network_participation?: NetworkParticipationSpec;
@@ -4707,6 +4860,9 @@ export interface TaskCatalogRunPayload {
     failure_kind?: string;
     max_attempts: number;
     session_id?: string;
+    worktree_id?: string;
+    resolved_worktree_mode: ResolvedWorktreeMode;
+    resolved_worktree_ref?: string;
     claimed_by?: ActorIdentity;
     lease_until?: ISODateTime;
     heartbeat_at?: ISODateTime;
@@ -4765,6 +4921,7 @@ export type CatalogScope = string;
 export interface TaskInboxParams {
     scope?: CatalogScope;
     workspace?: string;
+    worktree?: string;
     owner_kind?: OwnerKind;
     owner_ref?: string;
     lane?: TaskInboxLane;
@@ -5361,6 +5518,7 @@ export interface TasksParams {
     owner_kind?: OwnerKind;
     owner_ref?: string;
     parent_task_id?: string;
+    worktree?: string;
     participation_channel?: string;
     query?: string;
     sort?: CatalogSort;
@@ -5485,6 +5643,7 @@ export interface ToolPostCallPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -5515,6 +5674,7 @@ export interface ToolPostErrorPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -5538,6 +5698,7 @@ export interface ToolPreCallPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -5578,6 +5739,7 @@ export interface TurnEndPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -5602,6 +5764,7 @@ export interface TurnPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -5626,6 +5789,7 @@ export interface TurnStartPayload {
     agent_name?: string;
     workspace_id?: string;
     workspace?: string;
+    worktree_id?: string;
     acp_session_id?: string;
     state?: string;
     soul_snapshot_id?: string;
@@ -5740,6 +5904,63 @@ export interface WindowManagerWindowOpenedPayload {
     actor: WindowManagerActor;
     origin?: string;
 }
+export interface WorktreeControlPatch {
+    deny?: boolean;
+    deny_reason?: string;
+}
+export type WorktreeObservationPatch = Record<string, never>;
+export interface WorktreeObservationPayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    worktree_id: string;
+    workspace_id: string;
+    workspace_root?: string;
+    name: string;
+    branch: string;
+    path: string;
+    origin: string;
+    run_id?: string;
+}
+export interface WorktreePreCreatePayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    worktree_id: string;
+    workspace_id: string;
+    workspace_root?: string;
+    name: string;
+    branch: string;
+    path: string;
+    origin: string;
+    run_id?: string;
+    denied?: boolean;
+    deny_reason?: string;
+}
+export interface WorktreeContext {
+    worktree_id: string;
+    workspace_id: string;
+    workspace_root?: string;
+    name: string;
+    branch: string;
+    path: string;
+    origin: string;
+    run_id?: string;
+}
+export interface WorktreeRisk {
+    changed_files: number;
+    insertions: number;
+    deletions: number;
+    unpushed_commits: number;
+    exists_on_remote: boolean;
+}
+export interface WorktreePreRemovePayload {
+    event: HookEvent;
+    timestamp: ISODateTime;
+    worktree: WorktreeContext;
+    force: boolean;
+    risk: WorktreeRisk;
+    denied?: boolean;
+    deny_reason?: string;
+}
 export interface HookPayloadByEvent {
     "session.pre_create": SessionPreCreatePayload;
     "session.post_create": SessionPostCreatePayload;
@@ -5817,6 +6038,7 @@ export interface HookPayloadByEvent {
     "spawn.parent_stopped": SpawnParentStoppedPayload;
     "spawn.ttl_expired": SpawnTTLExpiredPayload;
     "spawn.reaped": SpawnReapedPayload;
+    "session.attention.changed": SessionAttentionChangedPayload;
     "network.thread.opened": NetworkThreadOpenedPayload;
     "network.direct_room.opened": NetworkDirectRoomOpenedPayload;
     "network.message.persisted": NetworkMessagePersistedPayload;
@@ -5836,6 +6058,11 @@ export interface HookPayloadByEvent {
     "window_manager.stack.grouped": WindowManagerStackGroupedPayload;
     "window_manager.stack.ungrouped": WindowManagerStackUngroupedPayload;
     "window_manager.stack.activated": WindowManagerStackActivatedPayload;
+    "worktree.pre_create": WorktreePreCreatePayload;
+    "worktree.pre_remove": WorktreePreRemovePayload;
+    "worktree.created": WorktreeObservationPayload;
+    "worktree.adopted": WorktreeObservationPayload;
+    "worktree.removed": WorktreeObservationPayload;
 }
 export interface HookPatchByEvent {
     "session.pre_create": SessionCreatePatch;
@@ -5914,6 +6141,7 @@ export interface HookPatchByEvent {
     "spawn.parent_stopped": SpawnObservationPatch;
     "spawn.ttl_expired": SpawnObservationPatch;
     "spawn.reaped": SpawnObservationPatch;
+    "session.attention.changed": SessionAttentionObservationPatch;
     "network.thread.opened": NetworkObservationPatch;
     "network.direct_room.opened": NetworkObservationPatch;
     "network.message.persisted": NetworkObservationPatch;
@@ -5933,6 +6161,11 @@ export interface HookPatchByEvent {
     "window_manager.stack.grouped": WindowManagerObservationPatch;
     "window_manager.stack.ungrouped": WindowManagerObservationPatch;
     "window_manager.stack.activated": WindowManagerObservationPatch;
+    "worktree.pre_create": WorktreeControlPatch;
+    "worktree.pre_remove": WorktreeControlPatch;
+    "worktree.created": WorktreeObservationPatch;
+    "worktree.adopted": WorktreeObservationPatch;
+    "worktree.removed": WorktreeObservationPatch;
 }
 export interface HostAPIMethodMap {
     "sessions/list": {
@@ -6319,6 +6552,7 @@ export interface HostAPIMethodMap {
 export declare const REQUIRED_METHODS_BY_PROVIDE: {
     readonly "bridge.adapter": readonly ["bridges/deliver", "bridges/targets/snapshot"];
     readonly "connectivity.provider": readonly ["connectivity/establish", "connectivity/status", "connectivity/teardown"];
+    readonly "forge.provider": readonly ["forge/capabilities", "forge/pr_create", "forge/status"];
     readonly "loop.watch_source": readonly ["watch/poll"];
     readonly "memory.backend": readonly ["memory/forget", "memory/recall", "memory/store"];
     readonly "model.source": readonly ["models/list"];