@compozy/client 0.3.0-beta.36 → 0.3.0-beta.38

package/dist/types/generated/sdk/types.gen.d.ts

@@ -219,6 +219,7 @@ export type AgentPayload = {
     speed?: "normal" | "fast";
     tools?: Array<string>;
     toolsets?: Array<string>;
+    workspace_access?: string;
     workspace_id?: string;
 };
 export type AgentProbeHealthPayload = {
@@ -350,24 +351,31 @@ export type AgentSoulValidateRequest = {
 export type AgentSpawnPayload = {
     lineage: SessionLineagePayload;
     permissions: SpawnPermissionPolicyPayload;
+    prompt?: SpawnPromptPayload | null;
     session: SessionPayload;
+    worktree?: SpawnWorktreePayload | null;
 };
 export type AgentSpawnRequest = {
     acp_options?: Array<AgentACPOptionSelection>;
     agent_name: string;
     auto_stop_on_parent: boolean;
     idempotency_key?: string;
+    inherit_permissions?: boolean;
     model?: string;
     name?: string;
+    new_worktree?: SpawnNewWorktreeRequest | null;
     notify_creator?: boolean | null;
-    permissions: SpawnPermissionPolicyPayload;
+    permissions: SpawnPermissionRequestPayload;
+    prompt?: string;
     prompt_overlay?: string;
     provider?: string;
     reasoning_effort?: string;
     spawn_role: string;
     speed?: "normal" | "fast";
+    toolsets?: Array<string>;
     ttl_seconds: number;
     workspace?: string;
+    worktree?: string;
 };
 export type AgentSpawnResponse = {
     spawn: AgentSpawnPayload;
@@ -989,7 +997,7 @@ export type ContractWindowManagerDesktop = {
     order: number;
 };
 export type ContractWindowManagerErrorPayload = {
-    code: "window_manager_workspace_not_found" | "window_manager_revision_conflict" | "window_manager_invalid_command" | "window_manager_invalid_topology" | "window_manager_desktop_not_found" | "window_manager_window_not_found" | "window_manager_not_stacked" | "window_manager_window_pinned" | "window_manager_client_not_found" | "window_manager_destination_required" | "window_manager_final_desktop" | "window_manager_history_boundary" | "window_manager_layout_not_found" | "window_manager_slow_consumer" | "window_manager_unavailable";
+    code: "window_manager_workspace_not_found" | "window_manager_revision_conflict" | "window_binding_invalid" | "window_manager_invalid_command" | "window_manager_invalid_topology" | "window_manager_desktop_not_found" | "window_manager_window_not_found" | "window_manager_not_stacked" | "window_manager_window_pinned" | "window_manager_client_not_found" | "window_manager_destination_required" | "window_manager_final_desktop" | "window_manager_history_boundary" | "window_manager_layout_not_found" | "window_manager_slow_consumer" | "window_manager_unavailable";
     conflicts?: Array<Conflict>;
     current_revision?: number;
     diagnostics?: Array<Diagnostic>;
@@ -1100,6 +1108,7 @@ export type CreateAgentPayload = {
     speed?: "normal" | "fast";
     tools?: Array<string>;
     toolsets?: Array<string>;
+    workspace_access?: string;
 };
 export type CreateAgentRequest = {
     agent: CreateAgentPayload;
@@ -1122,7 +1131,7 @@ export type CreateJobRequest = {
     prompt: string;
     retry?: RetryConfig | null;
     schedule: ScheduleSpec;
-    scope: "global" | "workspace";
+    scope: "global" | "workspace" | "user" | "@user";
     target_kind?: string;
     task?: JobTaskConfig | null;
     workspace_id?: string;
@@ -1148,6 +1157,7 @@ export type CreateSessionRequest = {
     name?: string;
     new_worktree?: NewSessionWorktreeRequest | null;
     parent_session_id?: string;
+    scope?: string;
     workspace?: string;
     workspace_path?: string;
     worktree?: string;
@@ -1174,7 +1184,7 @@ export type CreateTaskChildRequest = {
     metadata?: unknown;
     owner?: Ownership | null;
     priority?: "low" | "medium" | "high" | "urgent";
-    scope: "global" | "workspace";
+    scope: "global" | "workspace" | "user" | "@user";
     title: string;
     wake_creator?: boolean | null;
     workspace?: string;
@@ -1190,7 +1200,7 @@ export type CreateTaskRequest = {
     metadata?: unknown;
     owner?: Ownership | null;
     priority?: "low" | "medium" | "high" | "urgent";
-    scope: "global" | "workspace";
+    scope: "global" | "workspace" | "user" | "@user";
     title: string;
     wake_creator?: boolean | null;
     workspace?: string;
@@ -1208,7 +1218,7 @@ export type CreateTriggerRequest = {
     name: string;
     prompt: string;
     retry?: RetryConfig | null;
-    scope: "global" | "workspace";
+    scope: "global" | "workspace" | "user" | "@user";
     target_kind?: string;
     webhook_id?: string;
     webhook_secret_value?: string;
@@ -1227,6 +1237,11 @@ export type CreateWorktreeRequest = {
     name?: string;
     path?: string;
 };
+export type CursorPagePayload = {
+    has_more: boolean;
+    limit: number;
+    next_cursor?: string;
+};
 export type DaemonIdentityPayload = {
     http_host: string;
     http_port: number;
@@ -1356,6 +1371,7 @@ export type DuplicateAgentOverrides = {
     speed?: "normal" | "fast";
     tools?: Array<string>;
     toolsets?: Array<string>;
+    workspace_access?: string;
 };
 export type DuplicateAgentRequest = {
     name: string;
@@ -1404,12 +1420,14 @@ export type Entry = {
 };
 export type ErrorPayload = {
     code?: string;
+    config_path?: string;
     current_turn_id?: string;
     details?: {
         [key: string]: string;
     };
     diagnostic?: DiagnosticItem | null;
     error: string;
+    unknown_keys?: Array<string>;
 };
 export type ExecutionPolicy = {
     retry_safe: boolean;
@@ -2704,11 +2722,32 @@ export type LoopBudget = {
     tokens: number;
     wall_clock_sec: number;
 };
+export type LoopCatalogAggregateEntryPayload = {
+    aggregate_30d: LoopCatalogAggregatePayload;
+    catalog: LoopCatalogResourceSpec;
+    contract: LoopContract;
+    description?: string;
+    inputs?: {
+        [key: string]: LoopInput;
+    };
+    last_run?: LoopCatalogLastRunPayload | null;
+    name: string;
+    source: LoopCatalogSourcePayload;
+    start?: Array<LoopStartBinding>;
+    success_rate_30d: number;
+    version: number;
+    workspace_id?: string;
+};
 export type LoopCatalogAggregatePayload = {
     failed: number;
     runs: number;
     succeeded: number;
 };
+export type LoopCatalogBatchResponse = {
+    entries: Array<LoopCatalogAggregateEntryPayload>;
+    errors: Array<LoopCatalogWorkspaceError>;
+    truncated: boolean;
+};
 export type LoopCatalogEntryPayload = {
     aggregate_30d: LoopCatalogAggregatePayload;
     catalog: LoopCatalogResourceSpec;
@@ -2723,6 +2762,7 @@ export type LoopCatalogEntryPayload = {
     start?: Array<LoopStartBinding>;
     success_rate_30d: number;
     version: number;
+    workspace_id?: string;
 };
 export type LoopCatalogFacetsPayload = {
     categories: {
@@ -2747,6 +2787,15 @@ export type LoopCatalogResourceSpec = {
     keywords?: Array<string>;
     use_when?: string;
 };
+export type LoopCatalogSourcePayload = {
+    kind: "marketplace" | "user" | "additional" | "workspace";
+    layer: string;
+};
+export type LoopCatalogWorkspaceError = {
+    code: string;
+    message: string;
+    workspace_id?: string;
+};
 export type LoopConfig = {
     budget_on_exceeded?: "halt" | "escalate";
     budget_tokens?: number | null;
@@ -3077,6 +3126,7 @@ export type LoopNodeInventoryItem = {
     state: "waiting" | "quarantined" | "attention" | "retrying";
     state_at: string;
     wait?: LoopNodeWaitPayload | null;
+    workspace_id?: string;
 };
 export type LoopNodeInventoryResponse = {
     items: Array<LoopNodeInventoryItem>;
@@ -3164,11 +3214,13 @@ export type LoopRequestPayload = {
     loop_run_id: string;
     node_id: string;
     opened_at: string;
+    profile_id: string;
     prompt: string;
     proposed_preview?: unknown;
     resolved_at?: string | null;
     respond_schema?: unknown;
     state: string;
+    workspace_id?: string;
 };
 export type LoopRequestProvenance = {
     actor_id: string;
@@ -3781,6 +3833,7 @@ export type OverviewAttentionItemPayload = {
     session_id?: string;
     task_id?: string;
     title: string;
+    workspace_id: string;
 };
 export type OverviewAttentionPayload = {
     by_kind: {
@@ -4152,6 +4205,91 @@ export type ProviderSummaryPayload = {
     runtime_strategy?: "session_config" | "launch_arg" | "provider_managed";
     session_env_status?: Array<SettingsProviderCredentialStatusPayload>;
 };
+export type ProviderUsageAccount = {
+    label: string;
+    plan: string;
+};
+export type ProviderUsageAmount = {
+    unit: string;
+    value: string;
+};
+export type ProviderUsageBalance = {
+    expires_at: string | null;
+    id: string;
+    label: string;
+    remaining: ProviderUsageAmount;
+};
+export type ProviderUsageEnvelope = {
+    enabled: boolean;
+    generated_at: string;
+    keychain_supported: boolean;
+    profile_id: string;
+    revision: number;
+    targets: Array<ProviderUsageTarget>;
+    tray: ProviderUsageTraySignal | null;
+};
+export type ProviderUsageError = {
+    action: string;
+    code: string;
+    message: string;
+    retry_after: string | null;
+};
+export type ProviderUsageRefreshRequest = {
+    intent?: string;
+    max_age_seconds?: number;
+    profile?: string;
+    provider_ids?: Array<string>;
+    wait_ms?: number | null;
+};
+export type ProviderUsageSource = {
+    kind: string;
+    label: string;
+};
+export type ProviderUsageSpendCap = {
+    enabled: boolean | null;
+    id: string;
+    label: string;
+    limit: ProviderUsageAmount | null;
+    resets_at: string | null;
+    used: ProviderUsageAmount;
+    used_percent: number | null;
+};
+export type ProviderUsageTarget = {
+    account: ProviderUsageAccount | null;
+    balances: Array<ProviderUsageBalance>;
+    checked_at: string | null;
+    confidence: string;
+    error: ProviderUsageError | null;
+    measured_at: string | null;
+    next_refresh_at: string | null;
+    provider_id: string;
+    provider_name: string;
+    refreshing: boolean;
+    source: ProviderUsageSource | null;
+    spend_caps: Array<ProviderUsageSpendCap>;
+    status: string;
+    windows: Array<ProviderUsageWindow>;
+};
+export type ProviderUsageTraySignal = {
+    label: string;
+    provider_id: string;
+    resets_at: string | null;
+    severity: string;
+    stale: boolean;
+    used_percent: number;
+    window_id: string;
+};
+export type ProviderUsageWindow = {
+    duration_seconds: number | null;
+    id: string;
+    kind: string;
+    label: string;
+    limit: ProviderUsageAmount | null;
+    reset_text: string;
+    resets_at: string | null;
+    used: ProviderUsageAmount | null;
+    used_percent: number | null;
+};
 export type PutLoopAnnotationsRequest = {
     annotations: Array<LoopAnnotationPayload>;
 };
@@ -4228,7 +4366,7 @@ export type RecoverTaskRunRequest = {
 export type Redaction = {
     bytes?: number;
     path: string;
-    reason: "approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied";
+    reason: "approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "spawn_budget_exhausted" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied";
 };
 export type Reference = {
     effective_paused?: boolean;
@@ -4248,6 +4386,11 @@ export type ReloadExtensionRequest = {
     confirm_gateway_digest?: string;
     generation_hash: string;
 };
+export type RemoveDiscoveredWorktreeRequest = {
+    expect_stale?: boolean;
+    force?: boolean;
+    path: string;
+};
 export type RenameProfilePlan = {
     dormant_placements: Array<ProfilePlacement>;
     machine_folders: Array<string>;
@@ -4550,6 +4693,7 @@ export type RunOutcome = {
 };
 export type RunPayload = {
     attempt: number;
+    attribution: string;
     delivery_error?: string;
     delivery_error_at?: string | null;
     ended_at?: string | null;
@@ -4572,6 +4716,7 @@ export type RunPayload = {
     task_id?: string;
     task_run_id?: string;
     trigger_id?: string;
+    workspace_id?: string | null;
 };
 export type RunResponse = {
     run: RunPayload;
@@ -4653,6 +4798,7 @@ export type RunWorktreeExitActionRequest = {
     title?: string;
 };
 export type RunsResponse = {
+    page?: CursorPagePayload | null;
     runs: Array<RunPayload>;
 };
 export type RuntimeActivityPayload = {
@@ -4904,6 +5050,7 @@ export type SessionCatalogFacetsPayload = {
     working: number;
 };
 export type SessionCatalogFacetsResponse = {
+    by_profile: Array<SessionProfileFacetsPayload>;
     by_workspace: Array<SessionWorkspaceFacetsPayload>;
     facets: SessionCatalogFacetsPayload;
 };
@@ -5075,12 +5222,14 @@ export type SessionDeriveCutPayload = {
 export type SessionDeriveErrorPayload = {
     child_session_id?: string;
     code?: string;
+    config_path?: string;
     current_turn_id?: string;
     details?: {
         [key: string]: string;
     };
     diagnostic?: DiagnosticItem | null;
     error: string;
+    unknown_keys?: Array<string>;
 };
 export type SessionDerivePreviewResponse = {
     cut?: SessionDeriveCutPayload | null;
@@ -5302,6 +5451,30 @@ export type SessionLineagePayload = {
     spawn_role?: string;
     ttl_expires_at?: string | null;
 };
+export type SessionMonitorPayload = {
+    created_at: string;
+    deadline_at: string;
+    description: string;
+    exit_code?: number | null;
+    fired_at?: string | null;
+    kind: string;
+    monitor_id: string;
+    pattern?: string;
+    reason?: string;
+    session_id: string;
+    status: string;
+    terminal_id?: string;
+    until?: string;
+};
+export type SessionMonitorResponse = {
+    monitor: SessionMonitorPayload;
+};
+export type SessionMonitorSummaryPayload = {
+    active: number;
+};
+export type SessionMonitorsResponse = {
+    monitors: Array<SessionMonitorPayload>;
+};
 export type SessionOwner = {
     session_id: string;
     workspace_id: string;
@@ -5321,12 +5494,14 @@ export type SessionPayload = {
     busy_input?: BusyInputState | null;
     created_at: string;
     derivation?: SessionDerivationPayload | null;
+    effective_workspace_access: string;
     escalated?: boolean | null;
     failure?: SessionFailurePayload | null;
     folder_id?: string;
     health?: SessionHealthPayload | null;
     id: string;
     lineage?: SessionLineagePayload | null;
+    monitor_summary?: SessionMonitorSummaryPayload | null;
     name?: string;
     pending_interactions: Array<PendingInteractionPayload>;
     profile_archived?: boolean;
@@ -5338,6 +5513,7 @@ export type SessionPayload = {
     queue?: SessionQueueSummaryPayload | null;
     reply_watches?: Array<ReplyWatchPayload>;
     runtime: SessionRuntimePayload;
+    scope: string;
     state: "starting" | "active" | "stopping" | "stopped";
     stop_cause?: string;
     stop_detail?: string;
@@ -5359,6 +5535,10 @@ export type SessionPresenceRequest = {
 export type SessionPresenceResponse = {
     lease_id: string;
 };
+export type SessionProfileFacetsPayload = {
+    facets: SessionCatalogFacetsPayload;
+    profile_id: string;
+};
 export type SessionPromptCancelResponse = {
     outcome: string;
     session_id: string;
@@ -5575,7 +5755,7 @@ export type SettingsApplyResponse = {
     restart_required?: boolean;
     restart_scope?: string;
     scope?: "user" | "profile" | "workspace" | "agent";
-    section?: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace" | "providers" | "mcp-servers" | "hooks";
+    section?: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace" | "providers" | "mcp-servers" | "hooks";
     skipped?: boolean;
     skipped_reason?: string;
     warnings?: Array<string>;
@@ -5593,7 +5773,7 @@ export type SettingsAttentionResponse = {
     config: SettingsAttentionPayload;
     profile?: string;
     scope: "user" | "profile" | "workspace";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
     workspace_id?: string;
 };
 export type SettingsAutomationConfigPayload = {
@@ -5608,10 +5788,11 @@ export type SettingsAutomationResponse = {
     links?: Array<SettingsOperationalLinkPayload>;
     runtime: SettingsAutomationRuntimePayload;
     scope: "user";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
 };
 export type SettingsAutomationRuntimePayload = {
     available: boolean;
+    host_timezone?: string;
     job_enabled: number;
     job_total: number;
     last_synced_at?: string | null;
@@ -5633,7 +5814,7 @@ export type SettingsCmdPaletteResponse = {
     personalization: boolean;
     profile?: string;
     scope: "user" | "profile" | "workspace";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
     workspace_id?: string;
 };
 export type SettingsConfigPathsPayload = {
@@ -5748,7 +5929,7 @@ export type SettingsGeneralResponse = {
     config_paths: SettingsConfigPathsPayload;
     runtime: SettingsDaemonRuntimePayload;
     scope: "user";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
 };
 export type SettingsGlobalShortcutPayload = {
     active_chord?: string;
@@ -5795,7 +5976,7 @@ export type SettingsHooksExtensionsResponse = {
     hooks?: Array<SettingsHookItemPayload>;
     installed?: Array<SettingsInstalledExtensionPayload>;
     scope: "user";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
     transport_parity: SettingsTransportParityPayload;
 };
 export type SettingsHooksResponse = {
@@ -5980,7 +6161,7 @@ export type SettingsMarketplaceResponse = {
     available_scopes: Array<"user">;
     config: SettingsMarketplaceCatalogPayload;
     scope: "user";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
 };
 export type SettingsObservabilityConfigPayload = {
     enabled: boolean;
@@ -5994,7 +6175,7 @@ export type SettingsObservabilityResponse = {
     log_tail: SettingsLogTailCapabilityPayload;
     runtime: SettingsObservabilityRuntimePayload;
     scope: "user";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
 };
 export type SettingsObservabilityRuntimePayload = {
     active_agents: number;
@@ -6022,7 +6203,7 @@ export type SettingsPersonaResponse = {
     config: SettingsDefaultsPayload;
     profile?: string;
     scope: "user" | "profile" | "workspace";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
     workspace_id?: string;
 };
 export type SettingsProviderAuthStatusPayload = {
@@ -6132,6 +6313,27 @@ export type SettingsProviderSettingsPayload = {
     steer_capability?: "steer_ext" | "concurrent_prompt" | "none";
     transport?: string;
 };
+export type SettingsProviderUsagePayload = {
+    enabled: boolean;
+    providers: {
+        [key: string]: SettingsProviderUsageProviderPayload;
+    };
+    refresh_interval: string;
+};
+export type SettingsProviderUsageProviderPayload = {
+    enabled?: boolean | null;
+    keychain_access?: boolean | null;
+};
+export type SettingsProviderUsageResponse = {
+    available_scopes: Array<"user">;
+    config: SettingsProviderUsagePayload;
+    keychain_supported: boolean;
+    scope: "user";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
+};
+export type SettingsProviderUsageUpdateRequest = {
+    config: SettingsProviderUsagePayload;
+};
 export type SettingsProviderWritePayload = {
     auth_acp_method?: string | null;
     auth_login_command?: string | null;
@@ -6190,8 +6392,35 @@ export type SettingsRolesResponse = {
     available_scopes: Array<"user" | "workspace">;
     config: SettingsRolesConfigPayload;
     scope: "user" | "workspace";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
+    workspace_id?: string;
+};
+export type SettingsShellLegacyScopePayload = {
+    explicit: boolean;
+    revision: number;
+    value: "workspace" | "all-workspaces";
+};
+export type SettingsShellMutationResponse = {
+    active_config_hash: string;
+    active_generation: number;
+    agent_name?: string;
+    applied: boolean;
+    apply_record_id: string;
+    config: SettingsShellPayload;
+    legacy_scope: SettingsShellLegacyScopePayload;
+    lifecycle: "live" | "live-add" | "live-remove-if-unused" | "restart-required" | "session-rebind";
+    next_action: "none" | "restart-daemon" | "new-session" | "retry";
+    partial_failures?: Array<SettingsApplyFailurePayload>;
+    profile?: string;
+    restart_required?: boolean;
+    restart_scope?: string;
+    scope?: "user" | "profile" | "workspace" | "agent";
+    section?: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace" | "providers" | "mcp-servers" | "hooks";
+    skipped?: boolean;
+    skipped_reason?: string;
+    warnings?: Array<string>;
     workspace_id?: string;
+    write_target?: "global-config" | "profile-config" | "workspace-config" | "global-mcp-sidecar" | "profile-mcp-sidecar" | "workspace-mcp-sidecar" | "global-agent-file" | "workspace-agent-file";
 };
 export type SettingsShellPayload = {
     sessions: SettingsShellSessionsPayload;
@@ -6199,12 +6428,15 @@ export type SettingsShellPayload = {
 export type SettingsShellResponse = {
     available_scopes: Array<"user">;
     config: SettingsShellPayload;
+    legacy_scope: SettingsShellLegacyScopePayload;
     scope: "user";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
+    warnings: Array<string>;
 };
 export type SettingsShellSessionsPayload = {
-    scope: "workspace" | "all-workspaces";
-    sort: "created" | "name" | "last_activity" | "attention" | "manual";
+    group_by?: "none" | "project" | "profile";
+    scope?: "workspace" | "all-workspaces";
+    sort?: "created" | "name" | "last_activity" | "attention" | "manual";
 };
 export type SettingsSkillSourceCollisionPayload = {
     name: string;
@@ -6277,7 +6509,7 @@ export type SettingsSkillsMutationResponse = {
     restart_scope?: string;
     runtime_available: boolean;
     scope: "user" | "profile" | "workspace" | "agent";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
     skipped?: boolean;
     skipped_reason?: string;
     sources: Array<SettingsSkillSourcePayload>;
@@ -6301,7 +6533,7 @@ export type SettingsSkillsResponse = {
     profile?: string;
     runtime_available: boolean;
     scope: "user" | "profile" | "workspace" | "agent";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
     sources: Array<SettingsSkillSourcePayload>;
     workspace_id?: string;
 };
@@ -6477,7 +6709,7 @@ export type SettingsWindowManagerMutationResponse = {
     extension_defaults: Array<SettingsWindowManagerDefaultPayload>;
     global_shortcuts: Array<SettingsGlobalShortcutPayload>;
     scope: "user" | "workspace";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
     workspace_id?: string;
 };
 export type SettingsWindowManagerResponse = {
@@ -6497,7 +6729,7 @@ export type SettingsWindowManagerResponse = {
     extension_defaults: Array<SettingsWindowManagerDefaultPayload>;
     global_shortcuts: Array<SettingsGlobalShortcutPayload>;
     scope: "user" | "workspace";
-    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "observability" | "hooks-extensions" | "marketplace";
+    section: "general" | "persona" | "roles" | "skills" | "automation" | "window-manager" | "cmd-palette" | "attention" | "shell" | "provider-usage" | "observability" | "hooks-extensions" | "marketplace";
     workspace_id?: string;
 };
 export type SettingsWindowManagerSnapPayload = {
@@ -6665,12 +6897,38 @@ export type SpawnBudgetPayload = {
     max_depth: number;
     ttl_seconds: number;
 };
+export type SpawnNewWorktreeRequest = {
+    base_ref?: string;
+    branch?: string;
+    name?: string;
+};
 export type SpawnPermissionPolicyPayload = {
     mcp_servers: Array<string>;
     skills: Array<string>;
     tools: Array<string>;
     workspace_paths: Array<string>;
 };
+export type SpawnPermissionRequestPayload = {
+    mcp_servers?: Array<string>;
+    skills?: Array<string>;
+    tools?: Array<string>;
+    workspace_paths?: Array<string>;
+};
+export type SpawnPromptPayload = {
+    error?: string;
+    message_id: string;
+    reply_watch_id?: string;
+    reply_watch_state?: string;
+    status: string;
+};
+export type SpawnWorktreePayload = {
+    base_sha?: string;
+    branch: string;
+    created: boolean;
+    id: string;
+    name: string;
+    path: string;
+};
 export type StartBinding = {
     input_mapping?: {
         [key: string]: string;
@@ -7315,6 +7573,7 @@ export type TaskPayload = {
 };
 export type TaskQueryErrorPayload = {
     code?: string;
+    config_path?: string;
     current_turn_id?: string;
     details?: {
         [key: string]: string;
@@ -7322,6 +7581,7 @@ export type TaskQueryErrorPayload = {
     diagnostic?: DiagnosticItem | null;
     error: string;
     field: string;
+    unknown_keys?: Array<string>;
 };
 export type TaskQueueDepthPayload = {
     count: number;
@@ -7959,7 +8219,7 @@ export type ToolAvailabilityPayload = {
     conflicted: boolean;
     enabled: boolean;
     executable: boolean;
-    reason_codes?: Array<"approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied">;
+    reason_codes?: Array<"approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "spawn_budget_exhausted" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied">;
     registered: boolean;
 };
 export type ToolBackendRefPayload = {
@@ -7984,7 +8244,7 @@ export type ToolCallEventPayload = {
     kind: "tool.call_started" | "tool.call_completed" | "tool.call_failed" | "tool.call_denied" | "tool.result_truncated";
     open_world: boolean;
     read_only: boolean;
-    reason_codes?: Array<"approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied">;
+    reason_codes?: Array<"approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "spawn_budget_exhausted" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied">;
     redacted_input_fields?: Array<string>;
     result_bytes?: number;
     result_digest?: string;
@@ -8038,7 +8298,7 @@ export type ToolErrorPayload = {
     layer?: string;
     message: string;
     partial_result?: ToolResult | null;
-    reason_codes?: Array<"approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied">;
+    reason_codes?: Array<"approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "spawn_budget_exhausted" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied">;
     tool_id?: string;
 };
 export type ToolErrorResponse = {
@@ -8074,7 +8334,7 @@ export type ToolPolicyDecisionPayload = {
     availability_result?: string;
     callable: boolean;
     hook_result?: string;
-    reason_codes?: Array<"approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied">;
+    reason_codes?: Array<"approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "spawn_budget_exhausted" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied">;
     registry_policy_result?: string;
     session_policy_result?: string;
     source_policy_result?: string;
@@ -8122,7 +8382,7 @@ export type ToolsResponse = {
 export type ToolsetPayload = {
     expanded_tools?: Array<string>;
     id: string;
-    reason_codes?: Array<"approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied">;
+    reason_codes?: Array<"approval_canceled" | "approval_rejected" | "approval_required" | "approval_timed_out" | "approval_token_expired" | "approval_token_mismatch" | "approval_token_missing" | "approval_token_replayed" | "approval_unreachable" | "backend_not_executable" | "backend_unhealthy" | "call_canceled" | "call_timed_out" | "config_path_not_found" | "conflicted_id" | "conflicted_sanitized_name" | "dependency_missing" | "extension_capability_missing" | "extension_inactive" | "extension_runtime_mismatch" | "generation_fenced" | "handler_missing" | "hook_denied" | "id_empty" | "id_empty_segment" | "id_invalid_format" | "id_too_long" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "loop_source_immutable" | "loop_version_conflict" | "mcp_auth_expired" | "mcp_auth_invalid" | "mcp_auth_refresh_failed" | "mcp_auth_required" | "mcp_auth_unconfigured" | "mcp_unreachable" | "policy_denied" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "reserved_conflict" | "reserved_namespace" | "result_budget_exceeded" | "result_persistence_failed" | "runtime_descriptor_mismatch" | "runtime_descriptor_missing" | "schema_invalid" | "secret_metadata" | "session_denied" | "skill_definition_invalid" | "skill_resource_not_found" | "slow_consumer" | "source_disabled" | "spawn_budget_exhausted" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_artifact_corrupt" | "tool_artifact_not_found" | "tool_unknown" | "toolset_cycle" | "toolset_unknown" | "visibility_denied">;
     status: string;
     tools?: Array<string>;
     toolsets?: Array<string>;
@@ -9662,6 +9922,79 @@ export type CreateAgentResponses = {
     201: AgentResponse;
 };
 export type CreateAgentResponse = CreateAgentResponses[keyof CreateAgentResponses];
+export type ListAgentsAggregateData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Read all projects and User rows
+         */
+        all_workspaces?: boolean;
+        /**
+         * Repeatable project IDs or @user; requires all_workspaces=true
+         */
+        workspace_ids?: Array<string>;
+        /**
+         * Exact agent name
+         */
+        name?: string;
+        /**
+         * Case-insensitive agent name or category search
+         */
+        q?: string;
+        /**
+         * Exact category path joined by slash separators
+         */
+        category?: string;
+        /**
+         * Agent session status
+         */
+        status?: "active" | "idle";
+        /**
+         * Opaque cursor bound to workspace and filters
+         */
+        cursor?: string;
+        /**
+         * Agents per page (1-100; default 50)
+         */
+        limit?: number;
+        /**
+         * Act as this profile by name
+         */
+        profile?: string;
+    };
+    url: "/api/agents/aggregate";
+};
+export type ListAgentsAggregateErrors = {
+    /**
+     * Invalid filter
+     */
+    400: ErrorPayload;
+    /**
+     * Workspace not found
+     */
+    404: ErrorPayload;
+    /**
+     * Workspace root missing
+     */
+    410: ErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Workspace resolver unavailable
+     */
+    503: ErrorPayload;
+};
+export type ListAgentsAggregateError = ListAgentsAggregateErrors[keyof ListAgentsAggregateErrors];
+export type ListAgentsAggregateResponses = {
+    /**
+     * OK
+     */
+    200: AgentCatalogResponse;
+};
+export type ListAgentsAggregateResponse = ListAgentsAggregateResponses[keyof ListAgentsAggregateResponses];
 export type ListAgentCatalogData = {
     body?: never;
     path?: never;
@@ -10832,11 +11165,19 @@ export type ListAutomationJobsData = {
         /**
          * Filter by automation scope
          */
-        scope?: "global" | "workspace";
+        scope?: "global" | "workspace" | "user" | "@user";
         /**
          * Filter by workspace id
          */
         workspace_id?: string;
+        /**
+         * Read every definition
+         */
+        all_workspaces?: boolean;
+        /**
+         * Project IDs or @user; requires all_workspaces=true
+         */
+        workspace_ids?: Array<string>;
         /**
          * Filter by job source
          */
@@ -11187,6 +11528,22 @@ export type ListAutomationRunsData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * Filter by source project; @user selects User
+         */
+        workspace_id?: string;
+        /**
+         * Read every run, including unknown attribution
+         */
+        all_workspaces?: boolean;
+        /**
+         * Source project IDs or @user; excludes unknown attribution
+         */
+        workspace_ids?: Array<string>;
+        /**
+         * Opaque source-filter-bound cursor
+         */
+        cursor?: string;
         /**
          * Filter by automation job id
          */
@@ -11286,42 +11643,95 @@ export type GetAutomationRunResponses = {
     200: RunResponse;
 };
 export type GetAutomationRunResponse = GetAutomationRunResponses[keyof GetAutomationRunResponses];
-export type ListAutomationTriggersData = {
+export type ListAutomationSuggestionsAggregateData = {
     body?: never;
     path?: never;
     query?: {
         /**
-         * Filter by automation scope
-         */
-        scope?: "global" | "workspace";
-        /**
-         * Filter by workspace id
-         */
-        workspace_id?: string;
-        /**
-         * Filter by trigger source
-         */
-        source?: "config" | "package" | "dynamic";
-        /**
-         * Filter by target kind; task matches no trigger
-         */
-        target?: "agent" | "loop" | "task";
-        /**
-         * Filter by enabled state
-         */
-        enabled?: boolean;
-        /**
-         * Filter by trigger event
+         * Read all projects and User rows
          */
-        event?: string;
+        all_workspaces?: boolean;
         /**
-         * Search triggers by definition or filter fields
+         * Repeatable project IDs or @user; requires all_workspaces=true
          */
-        q?: string;
+        workspace_ids?: Array<string>;
         /**
-         * Continue after this automation trigger cursor
+         * Filter by suggestion status
          */
-        cursor?: string;
+        status?: "pending" | "accepted" | "dismissed";
+    };
+    url: "/api/automation/suggestions";
+};
+export type ListAutomationSuggestionsAggregateErrors = {
+    /**
+     * Invalid suggestion status
+     */
+    400: ErrorPayload;
+    /**
+     * Workspace not found
+     */
+    404: ErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Automation manager is not configured
+     */
+    503: ErrorPayload;
+};
+export type ListAutomationSuggestionsAggregateError = ListAutomationSuggestionsAggregateErrors[keyof ListAutomationSuggestionsAggregateErrors];
+export type ListAutomationSuggestionsAggregateResponses = {
+    /**
+     * OK
+     */
+    200: AutomationSuggestionsResponse;
+};
+export type ListAutomationSuggestionsAggregateResponse = ListAutomationSuggestionsAggregateResponses[keyof ListAutomationSuggestionsAggregateResponses];
+export type ListAutomationTriggersData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Filter by automation scope
+         */
+        scope?: "global" | "workspace" | "user" | "@user";
+        /**
+         * Filter by workspace id
+         */
+        workspace_id?: string;
+        /**
+         * Read every definition
+         */
+        all_workspaces?: boolean;
+        /**
+         * Project IDs or @user; requires all_workspaces=true
+         */
+        workspace_ids?: Array<string>;
+        /**
+         * Filter by trigger source
+         */
+        source?: "config" | "package" | "dynamic";
+        /**
+         * Filter by target kind; task matches no trigger
+         */
+        target?: "agent" | "loop" | "task";
+        /**
+         * Filter by enabled state
+         */
+        enabled?: boolean;
+        /**
+         * Filter by trigger event
+         */
+        event?: string;
+        /**
+         * Search triggers by definition or filter fields
+         */
+        q?: string;
+        /**
+         * Continue after this automation trigger cursor
+         */
+        cursor?: string;
         /**
          * Maximum number of records to return
          */
@@ -13714,6 +14124,221 @@ export type ListLogsResponses = {
     200: LogsListResponse;
 };
 export type ListLogsResponse = ListLogsResponses[keyof ListLogsResponses];
+export type ListLoopRequestsAggregateData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Read all registered projects and User rows
+         */
+        all_workspaces?: boolean;
+        /**
+         * Repeatable project IDs or @user; requires all_workspaces=true
+         */
+        workspace_ids?: Array<string>;
+        /**
+         * Filter by Loop run id
+         */
+        run_id?: string;
+        /**
+         * Filter by pending or resolved state
+         */
+        state?: string;
+        /**
+         * Opaque continuation cursor
+         */
+        cursor?: string;
+        /**
+         * Maximum number of records to return
+         */
+        limit?: number;
+        /**
+         * Read one profile's rows by name
+         */
+        profile?: string;
+        /**
+         * Read the owner-labeled all-profiles aggregate
+         */
+        all_profiles?: boolean;
+    };
+    url: "/api/loop-requests";
+};
+export type ListLoopRequestsAggregateErrors = {
+    /**
+     * Invalid Loop request
+     */
+    400: ErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Loop service is not configured
+     */
+    503: ErrorPayload;
+};
+export type ListLoopRequestsAggregateError = ListLoopRequestsAggregateErrors[keyof ListLoopRequestsAggregateErrors];
+export type ListLoopRequestsAggregateResponses = {
+    /**
+     * OK
+     */
+    200: LoopRequestsResponse;
+};
+export type ListLoopRequestsAggregateResponse = ListLoopRequestsAggregateResponses[keyof ListLoopRequestsAggregateResponses];
+export type ListLoopRunsAggregateData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Read all registered projects and User rows
+         */
+        all_workspaces?: boolean;
+        /**
+         * Repeatable project IDs or @user; requires all_workspaces=true
+         */
+        workspace_ids?: Array<string>;
+        /**
+         * Filter by Loop name
+         */
+        loop?: string;
+        /**
+         * Filter by Loop status
+         */
+        status?: string;
+        /**
+         * Filter by catalog or session origin
+         */
+        origin?: string;
+        /**
+         * Filter by origin session id
+         */
+        origin_session?: string;
+        /**
+         * Filter by live or terminal status
+         */
+        live?: boolean;
+        /**
+         * Opaque server-order cursor
+         */
+        cursor?: string;
+        /**
+         * Maximum number of records to return
+         */
+        limit?: number;
+        /**
+         * Read one profile's rows by name
+         */
+        profile?: string;
+        /**
+         * Read the owner-labeled all-profiles aggregate
+         */
+        all_profiles?: boolean;
+        /**
+         * Aggregate runs support recency order only
+         */
+        order?: "recency";
+    };
+    url: "/api/loop-runs";
+};
+export type ListLoopRunsAggregateErrors = {
+    /**
+     * Invalid Loop request
+     */
+    400: ErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Loop service is not configured
+     */
+    503: ErrorPayload;
+};
+export type ListLoopRunsAggregateError = ListLoopRunsAggregateErrors[keyof ListLoopRunsAggregateErrors];
+export type ListLoopRunsAggregateResponses = {
+    /**
+     * OK
+     */
+    200: LoopRunsResponse;
+};
+export type ListLoopRunsAggregateResponse = ListLoopRunsAggregateResponses[keyof ListLoopRunsAggregateResponses];
+export type ListLoopsAggregateData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Read all registered projects and User rows
+         */
+        all_workspaces?: boolean;
+        /**
+         * Repeatable project IDs or @user; requires all_workspaces=true
+         */
+        workspace_ids?: Array<string>;
+        /**
+         * Search Loop name or contract goal
+         */
+        q?: string;
+        /**
+         * Filter by effective Loop kind
+         */
+        kind?: "read_only" | "workspace";
+        /**
+         * Filter by exact catalog category
+         */
+        category?: string;
+        /**
+         * Filter by exact latest-run status
+         */
+        status?: "queued" | "running" | "watching" | "needs-approval" | "paused" | "done" | "no-op" | "blocked" | "failed" | "exhausted" | "stalled" | "canceled";
+        /**
+         * Stable read-only-first name order
+         */
+        sort?: "name";
+        /**
+         * Continue after this workspace- and query-bound Loop cursor
+         */
+        cursor?: string;
+        /**
+         * Maximum number of Loops to return; defaults to 50 and is capped at 200
+         */
+        limit?: number;
+        /**
+         * Read one profile's rows by name
+         */
+        profile?: string;
+        /**
+         * Read the owner-labeled all-profiles aggregate
+         */
+        all_profiles?: boolean;
+    };
+    url: "/api/loops";
+};
+export type ListLoopsAggregateErrors = {
+    /**
+     * Invalid Loop request
+     */
+    400: ErrorPayload;
+    /**
+     * Forbidden
+     */
+    403: ErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Loop service is not configured
+     */
+    503: ErrorPayload;
+};
+export type ListLoopsAggregateError = ListLoopsAggregateErrors[keyof ListLoopsAggregateErrors];
+export type ListLoopsAggregateResponses = {
+    /**
+     * OK
+     */
+    200: LoopCatalogBatchResponse;
+};
+export type ListLoopsAggregateResponse = ListLoopsAggregateResponses[keyof ListLoopsAggregateResponses];
 export type ListMarketplaceData = {
     body?: never;
     path?: never;
@@ -14459,6 +15084,10 @@ export type ListAttentionNotificationsData = {
          * Home workspace scope; empty selects global tasks
          */
         workspace?: string;
+        /**
+         * Every project's tasks, matching an All projects Home overview
+         */
+        all_workspaces?: boolean;
         /**
          * Read one profile's rows by name
          */
@@ -14511,6 +15140,10 @@ export type AcknowledgeAttentionNotificationsData = {
          * Home workspace scope; empty selects global tasks
          */
         workspace?: string;
+        /**
+         * Every project's tasks, matching an All projects Home overview
+         */
+        all_workspaces?: boolean;
         /**
          * Read one profile's rows by name
          */
@@ -14560,6 +15193,10 @@ export type GetObserveOverviewData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * Read every project and User within the profile lens; conflicts with workspace
+         */
+        all_workspaces?: boolean;
         /**
          * Profile owning acknowledgement receipts, including aggregate reads
          */
@@ -14584,6 +15221,14 @@ export type GetObserveOverviewData = {
     url: "/api/observe/overview";
 };
 export type GetObserveOverviewErrors = {
+    /**
+     * Invalid workspace breadth
+     */
+    400: ErrorPayload;
+    /**
+     * Agent aggregate access denied
+     */
+    403: ErrorPayload;
     /**
      * Workspace not found
      */
@@ -14613,10 +15258,18 @@ export type GetTaskDashboardData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * Read every project and User within the profile lens; conflicts with workspace
+         */
+        all_workspaces?: boolean;
+        /**
+         * Repeatable project IDs; @user selects User; requires all_workspaces=true
+         */
+        workspace_ids?: Array<string>;
         /**
          * Filter by task scope
          */
-        scope?: "global" | "workspace";
+        scope?: "global" | "workspace" | "user" | "@user";
         /**
          * Filter by workspace path, name, or ID
          */
@@ -14649,6 +15302,14 @@ export type GetTaskDashboardData = {
     url: "/api/observe/tasks/dashboard";
 };
 export type GetTaskDashboardErrors = {
+    /**
+     * Invalid workspace breadth
+     */
+    400: ErrorPayload;
+    /**
+     * Agent aggregate access denied
+     */
+    403: ErrorPayload;
     /**
      * Workspace not found
      */
@@ -14681,11 +15342,19 @@ export type GetTaskInboxData = {
         /**
          * Filter by task scope
          */
-        scope?: "global" | "workspace";
+        scope?: "global" | "workspace" | "user" | "@user";
         /**
          * Filter by workspace path, name, or ID
          */
         workspace?: string;
+        /**
+         * Read all projects and User rows
+         */
+        all_workspaces?: boolean;
+        /**
+         * Repeatable project IDs or @user; requires all_workspaces=true
+         */
+        workspace_ids?: Array<string>;
         /**
          * Filter by active run worktree ID
          */
@@ -15504,6 +16173,144 @@ export type UnarchiveProfileResponses = {
     200: UnarchiveProfileResponse;
 };
 export type UnarchiveProfileResponse2 = UnarchiveProfileResponses[keyof UnarchiveProfileResponses];
+export type ListProviderUsageData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Profile name; defaults to the caller session profile or default
+         */
+        profile?: string;
+    };
+    url: "/api/provider-usage";
+};
+export type ListProviderUsageErrors = {
+    /**
+     * Invalid request
+     */
+    400: ErrorPayload;
+    /**
+     * App token route forbidden
+     */
+    403: ErrorPayload;
+    /**
+     * Profile or provider not found
+     */
+    404: ErrorPayload | ProfileErrorPayload;
+    /**
+     * Usage disabled or session profile conflict
+     */
+    409: ErrorPayload | ProfileErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Usage service unavailable
+     */
+    503: ErrorPayload;
+};
+export type ListProviderUsageError = ListProviderUsageErrors[keyof ListProviderUsageErrors];
+export type ListProviderUsageResponses = {
+    /**
+     * Profile-scoped usage envelope
+     */
+    200: ProviderUsageEnvelope;
+};
+export type ListProviderUsageResponse = ListProviderUsageResponses[keyof ListProviderUsageResponses];
+export type GetProviderUsageData = {
+    body?: never;
+    path: {
+        /**
+         * Canonical provider ID
+         */
+        provider_id: string;
+    };
+    query?: {
+        /**
+         * Profile name; defaults to the caller session profile or default
+         */
+        profile?: string;
+    };
+    url: "/api/provider-usage/providers/{provider_id}";
+};
+export type GetProviderUsageErrors = {
+    /**
+     * Invalid request
+     */
+    400: ErrorPayload;
+    /**
+     * App token route forbidden
+     */
+    403: ErrorPayload;
+    /**
+     * Profile or provider not found
+     */
+    404: ErrorPayload | ProfileErrorPayload;
+    /**
+     * Usage disabled or session profile conflict
+     */
+    409: ErrorPayload | ProfileErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Usage service unavailable
+     */
+    503: ErrorPayload;
+};
+export type GetProviderUsageError = GetProviderUsageErrors[keyof GetProviderUsageErrors];
+export type GetProviderUsageResponses = {
+    /**
+     * Profile-scoped usage envelope
+     */
+    200: ProviderUsageEnvelope;
+};
+export type GetProviderUsageResponse = GetProviderUsageResponses[keyof GetProviderUsageResponses];
+export type RefreshProviderUsageData = {
+    /**
+     * JSON request body
+     */
+    body?: ProviderUsageRefreshRequest;
+    path?: never;
+    query?: never;
+    url: "/api/provider-usage/refresh";
+};
+export type RefreshProviderUsageErrors = {
+    /**
+     * Invalid request
+     */
+    400: ErrorPayload;
+    /**
+     * App token route forbidden
+     */
+    403: ErrorPayload;
+    /**
+     * Profile or provider not found
+     */
+    404: ErrorPayload | ProfileErrorPayload;
+    /**
+     * Usage disabled or session profile conflict
+     */
+    409: ErrorPayload | ProfileErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Usage service unavailable
+     */
+    503: ErrorPayload;
+};
+export type RefreshProviderUsageError = RefreshProviderUsageErrors[keyof RefreshProviderUsageErrors];
+export type RefreshProviderUsageResponses = {
+    /**
+     * Profile-scoped usage envelope
+     */
+    200: ProviderUsageEnvelope;
+};
+export type RefreshProviderUsageResponse = RefreshProviderUsageResponses[keyof RefreshProviderUsageResponses];
 export type ListProvidersData = {
     body?: never;
     path?: never;
@@ -16338,7 +17145,7 @@ export type GetSchedulerBacklogData = {
         /**
          * Filter by catalog visibility
          */
-        scope?: "all" | "global" | "workspace";
+        scope?: "all" | "global" | "workspace" | "user" | "@user";
         /**
          * Filter by workspace path, name, or ID
          */
@@ -16497,6 +17304,10 @@ export type ListSessionsData = {
          * Use the explicit all-workspaces aggregate
          */
         all_workspaces?: boolean;
+        /**
+         * Project IDs or @user; repeatable, requires all_workspaces
+         */
+        workspace_ids?: Array<string>;
         /**
          * Include metadata-only health for returned sessions
          */
@@ -16694,6 +17505,10 @@ export type ListSessionFacetsData = {
          * Use the explicit all-workspaces aggregate
          */
         all_workspaces?: boolean;
+        /**
+         * Project IDs or @user; repeatable, requires all_workspaces
+         */
+        workspace_ids?: Array<string>;
         /**
          * Filter by bound worktree id
          */
@@ -18342,74 +19157,138 @@ export type GetSettingsPersonaErrors = {
      */
     400: ErrorPayload;
     /**
-     * Workspace not found
+     * Workspace not found
+     */
+    404: ErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+};
+export type GetSettingsPersonaError = GetSettingsPersonaErrors[keyof GetSettingsPersonaErrors];
+export type GetSettingsPersonaResponses = {
+    /**
+     * OK
+     */
+    200: SettingsPersonaResponse;
+};
+export type GetSettingsPersonaResponse = GetSettingsPersonaResponses[keyof GetSettingsPersonaResponses];
+export type UpdateSettingsPersonaData = {
+    /**
+     * JSON request body
+     */
+    body: UpdateSettingsPersonaRequest;
+    path?: never;
+    query?: {
+        /**
+         * Select the settings scope
+         */
+        scope?: "user" | "profile" | "workspace";
+        /**
+         * Select the workspace context
+         */
+        workspace_id?: string;
+        /**
+         * Select the profile layer
+         */
+        profile?: string;
+    };
+    url: "/api/settings/persona";
+};
+export type UpdateSettingsPersonaErrors = {
+    /**
+     * Invalid settings payload
+     */
+    400: ErrorPayload;
+    /**
+     * Forbidden
+     */
+    403: ErrorPayload;
+    /**
+     * Workspace not found
+     */
+    404: ErrorPayload;
+    /**
+     * Conflicting settings change
+     */
+    409: ErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+};
+export type UpdateSettingsPersonaError = UpdateSettingsPersonaErrors[keyof UpdateSettingsPersonaErrors];
+export type UpdateSettingsPersonaResponses = {
+    /**
+     * OK
      */
-    404: ErrorPayload;
+    200: SettingsApplyResponse;
+};
+export type UpdateSettingsPersonaResponse = UpdateSettingsPersonaResponses[keyof UpdateSettingsPersonaResponses];
+export type GetSettingsProviderUsageData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: "/api/settings/provider-usage";
+};
+export type GetSettingsProviderUsageErrors = {
     /**
      * Internal server error
      */
     500: ErrorPayload;
 };
-export type GetSettingsPersonaError = GetSettingsPersonaErrors[keyof GetSettingsPersonaErrors];
-export type GetSettingsPersonaResponses = {
+export type GetSettingsProviderUsageError = GetSettingsProviderUsageErrors[keyof GetSettingsProviderUsageErrors];
+export type GetSettingsProviderUsageResponses = {
     /**
      * OK
      */
-    200: SettingsPersonaResponse;
+    200: SettingsProviderUsageResponse;
 };
-export type GetSettingsPersonaResponse = GetSettingsPersonaResponses[keyof GetSettingsPersonaResponses];
-export type UpdateSettingsPersonaData = {
+export type GetSettingsProviderUsageResponse = GetSettingsProviderUsageResponses[keyof GetSettingsProviderUsageResponses];
+export type UpdateSettingsProviderUsageData = {
     /**
      * JSON request body
      */
-    body: UpdateSettingsPersonaRequest;
+    body: SettingsProviderUsageUpdateRequest;
     path?: never;
     query?: {
         /**
-         * Select the settings scope
-         */
-        scope?: "user" | "profile" | "workspace";
-        /**
-         * Select the workspace context
-         */
-        workspace_id?: string;
-        /**
-         * Select the profile layer
+         * Collection profile name or ID for local Keychain consent; independent of user config scope; defaults to default
          */
-        profile?: string;
+        collection_profile?: string;
     };
-    url: "/api/settings/persona";
+    url: "/api/settings/provider-usage";
 };
-export type UpdateSettingsPersonaErrors = {
+export type UpdateSettingsProviderUsageErrors = {
     /**
      * Invalid settings payload
      */
-    400: ErrorPayload;
+    400: ErrorPayload | ProfileErrorPayload;
     /**
      * Forbidden
      */
     403: ErrorPayload;
     /**
-     * Workspace not found
+     * Collection profile not found
      */
-    404: ErrorPayload;
+    404: ProfileErrorPayload;
     /**
      * Conflicting settings change
      */
-    409: ErrorPayload;
+    409: ErrorPayload | ProfileErrorPayload;
     /**
      * Internal server error
      */
     500: ErrorPayload;
 };
-export type UpdateSettingsPersonaError = UpdateSettingsPersonaErrors[keyof UpdateSettingsPersonaErrors];
-export type UpdateSettingsPersonaResponses = {
+export type UpdateSettingsProviderUsageError = UpdateSettingsProviderUsageErrors[keyof UpdateSettingsProviderUsageErrors];
+export type UpdateSettingsProviderUsageResponses = {
     /**
      * OK
      */
     200: SettingsApplyResponse;
 };
-export type UpdateSettingsPersonaResponse = UpdateSettingsPersonaResponses[keyof UpdateSettingsPersonaResponses];
+export type UpdateSettingsProviderUsageResponse = UpdateSettingsProviderUsageResponses[keyof UpdateSettingsProviderUsageResponses];
 export type ListSettingsProvidersData = {
     body?: never;
     path?: never;
@@ -18667,7 +19546,7 @@ export type UpdateSettingsShellResponses = {
     /**
      * OK
      */
-    200: SettingsApplyResponse;
+    200: SettingsShellMutationResponse;
 };
 export type UpdateSettingsShellResponse = UpdateSettingsShellResponses[keyof UpdateSettingsShellResponses];
 export type GetSettingsSkillsData = {
@@ -20065,10 +20944,18 @@ export type ListTasksData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * Read every project and User within the profile lens; conflicts with workspace
+         */
+        all_workspaces?: boolean;
+        /**
+         * Repeatable project IDs; @user selects User; requires all_workspaces=true
+         */
+        workspace_ids?: Array<string>;
         /**
          * Filter by catalog visibility
          */
-        scope?: "all" | "global" | "workspace";
+        scope?: "all" | "global" | "workspace" | "user" | "@user";
         /**
          * Filter by workspace path, name, or ID
          */
@@ -20145,6 +21032,10 @@ export type ListTasksErrors = {
      * Invalid task filter or cursor
      */
     400: TaskQueryErrorPayload;
+    /**
+     * Agent aggregate access denied
+     */
+    403: ErrorPayload;
     /**
      * Workspace not found
      */
@@ -21736,6 +22627,67 @@ export type MarkTaskReadResponses = {
     200: TaskTriageStateResponse;
 };
 export type MarkTaskReadResponse = MarkTaskReadResponses[keyof MarkTaskReadResponses];
+export type ListTerminalsAggregateData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Read all projects and User rows
+         */
+        all_workspaces?: boolean;
+        /**
+         * Repeatable project IDs or @user; requires all_workspaces=true
+         */
+        workspace_ids?: Array<string>;
+        /**
+         * Read one profile's rows by name
+         */
+        profile?: string;
+        /**
+         * Read the owner-labeled all-profiles aggregate
+         */
+        all_profiles?: boolean;
+    };
+    url: "/api/terminals";
+};
+export type ListTerminalsAggregateErrors = {
+    /**
+     * Malformed terminal request
+     */
+    400: TerminalErrorResponse;
+    /**
+     * Terminal authentication required
+     */
+    401: TerminalErrorResponse;
+    /**
+     * Terminal operation forbidden
+     */
+    403: TerminalErrorResponse;
+    /**
+     * Terminal state or profile conflict
+     */
+    409: TerminalErrorResponse;
+    /**
+     * Invalid profile selection
+     */
+    422: TerminalErrorResponse;
+    /**
+     * Terminal transport failed
+     */
+    500: TerminalErrorResponse;
+    /**
+     * Terminal service unavailable
+     */
+    503: TerminalErrorResponse;
+};
+export type ListTerminalsAggregateError = ListTerminalsAggregateErrors[keyof ListTerminalsAggregateErrors];
+export type ListTerminalsAggregateResponses = {
+    /**
+     * OK
+     */
+    200: TerminalListResponse;
+};
+export type ListTerminalsAggregateResponse = ListTerminalsAggregateResponses[keyof ListTerminalsAggregateResponses];
 export type ListToolApprovalGrantsData = {
     body?: never;
     path?: never;
@@ -22758,6 +23710,10 @@ export type CreateWorkspaceErrors = {
      * Workspace conflict
      */
     409: ErrorPayload;
+    /**
+     * Unknown workspace config keys (workspace_config_invalid)
+     */
+    422: ErrorPayload;
     /**
      * Internal server error
      */
@@ -22789,6 +23745,10 @@ export type ResolveWorkspaceErrors = {
      * Workspace not found
      */
     404: ErrorPayload;
+    /**
+     * Unknown workspace config keys (workspace_config_invalid)
+     */
+    422: ErrorPayload;
     /**
      * Internal server error
      */
@@ -22847,6 +23807,10 @@ export type GetWorkspaceErrors = {
      * Workspace not found
      */
     404: ErrorPayload;
+    /**
+     * Unknown workspace config keys (workspace_config_invalid)
+     */
+    422: ErrorPayload;
     /**
      * Internal server error
      */
@@ -25605,6 +26569,10 @@ export type ListWorkspaceSessionsData = {
         workspace_id: string;
     };
     query?: {
+        /**
+         * Project IDs or @user; repeatable, requires all_workspaces
+         */
+        workspace_ids?: Array<string>;
         /**
          * Include metadata-only health for returned sessions
          */
@@ -26910,6 +27878,84 @@ export type ListSessionInteractionsResponses = {
     200: SessionInteractionsResponse;
 };
 export type ListSessionInteractionsResponse = ListSessionInteractionsResponses[keyof ListSessionInteractionsResponses];
+export type ListSessionMonitorsData = {
+    body?: never;
+    path: {
+        /**
+         * Workspace id
+         */
+        workspace_id: string;
+        /**
+         * Session id
+         */
+        session_id: string;
+    };
+    query?: never;
+    url: "/api/workspaces/{workspace_id}/sessions/{session_id}/monitors";
+};
+export type ListSessionMonitorsErrors = {
+    /**
+     * Session or monitor not found
+     */
+    404: ErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Session monitors unavailable
+     */
+    503: ErrorPayload;
+};
+export type ListSessionMonitorsError = ListSessionMonitorsErrors[keyof ListSessionMonitorsErrors];
+export type ListSessionMonitorsResponses = {
+    /**
+     * Success
+     */
+    200: SessionMonitorsResponse;
+};
+export type ListSessionMonitorsResponse = ListSessionMonitorsResponses[keyof ListSessionMonitorsResponses];
+export type CancelSessionMonitorData = {
+    body?: never;
+    path: {
+        /**
+         * Workspace id
+         */
+        workspace_id: string;
+        /**
+         * Session id
+         */
+        session_id: string;
+        /**
+         * Monitor id
+         */
+        monitor_id: string;
+    };
+    query?: never;
+    url: "/api/workspaces/{workspace_id}/sessions/{session_id}/monitors/{monitor_id}/cancel";
+};
+export type CancelSessionMonitorErrors = {
+    /**
+     * Session or monitor not found
+     */
+    404: ErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Session monitors unavailable
+     */
+    503: ErrorPayload;
+};
+export type CancelSessionMonitorError = CancelSessionMonitorErrors[keyof CancelSessionMonitorErrors];
+export type CancelSessionMonitorResponses = {
+    /**
+     * Success
+     */
+    200: SessionMonitorResponse;
+};
+export type CancelSessionMonitorResponse = CancelSessionMonitorResponses[keyof CancelSessionMonitorResponses];
 export type MoveSessionData = {
     /**
      * JSON request body
@@ -29460,6 +30506,10 @@ export type RegisterWindowManagerClientData = {
     url: "/api/workspaces/{workspace_id}/window-manager/clients";
 };
 export type RegisterWindowManagerClientErrors = {
+    /**
+     * Invalid window workspace binding
+     */
+    400: ContractWindowManagerErrorPayload;
     /**
      * Workspace or referenced entity not found
      */
@@ -29506,6 +30556,10 @@ export type UnregisterWindowManagerClientData = {
     url: "/api/workspaces/{workspace_id}/window-manager/clients/{client_id}";
 };
 export type UnregisterWindowManagerClientErrors = {
+    /**
+     * Invalid window workspace binding
+     */
+    400: ContractWindowManagerErrorPayload;
     /**
      * Workspace or referenced entity not found
      */
@@ -29551,6 +30605,10 @@ export type ExecuteWindowManagerCommandData = {
     url: "/api/workspaces/{workspace_id}/window-manager/commands";
 };
 export type ExecuteWindowManagerCommandErrors = {
+    /**
+     * Invalid window workspace binding
+     */
+    400: ContractWindowManagerErrorPayload;
     /**
      * Workspace or referenced entity not found
      */
@@ -29630,6 +30688,10 @@ export type ReplaceWindowManagerLayoutData = {
     url: "/api/workspaces/{workspace_id}/window-manager/layout";
 };
 export type ReplaceWindowManagerLayoutErrors = {
+    /**
+     * Invalid window workspace binding
+     */
+    400: ContractWindowManagerErrorPayload;
     /**
      * Workspace or referenced entity not found
      */
@@ -29851,6 +30913,10 @@ export type ValidateWindowManagerLayoutData = {
     url: "/api/workspaces/{workspace_id}/window-manager/layout/validate";
 };
 export type ValidateWindowManagerLayoutErrors = {
+    /**
+     * Invalid window workspace binding
+     */
+    400: ContractWindowManagerErrorPayload;
     /**
      * Workspace or referenced entity not found
      */
@@ -29896,6 +30962,10 @@ export type PreviewWindowManagerCommandData = {
     url: "/api/workspaces/{workspace_id}/window-manager/preview";
 };
 export type PreviewWindowManagerCommandErrors = {
+    /**
+     * Invalid window workspace binding
+     */
+    400: ContractWindowManagerErrorPayload;
     /**
      * Workspace or referenced entity not found
      */
@@ -30077,6 +31147,59 @@ export type AdoptWorktreeResponses = {
     200: WorktreeResponse;
 };
 export type AdoptWorktreeResponse = AdoptWorktreeResponses[keyof AdoptWorktreeResponses];
+export type RemoveDiscoveredWorktreeData = {
+    /**
+     * JSON request body
+     */
+    body: RemoveDiscoveredWorktreeRequest;
+    path: {
+        /**
+         * Workspace id or path
+         */
+        workspace_id: string;
+    };
+    query?: {
+        /**
+         * Act as this profile by name
+         */
+        profile?: string;
+    };
+    url: "/api/workspaces/{workspace_id}/worktrees/discovered/remove";
+};
+export type RemoveDiscoveredWorktreeErrors = {
+    /**
+     * Invalid discovered removal request
+     */
+    400: ErrorPayload;
+    /**
+     * Hook or profile does not permit removal
+     */
+    403: ErrorPayload;
+    /**
+     * Discovered worktree or workspace not found
+     */
+    404: ErrorPayload;
+    /**
+     * Removal requires another decision
+     */
+    409: WorktreeRemovalRefusalPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Worktree service is unavailable
+     */
+    503: ErrorPayload;
+};
+export type RemoveDiscoveredWorktreeError = RemoveDiscoveredWorktreeErrors[keyof RemoveDiscoveredWorktreeErrors];
+export type RemoveDiscoveredWorktreeResponses = {
+    /**
+     * No Content
+     */
+    204: void;
+};
+export type RemoveDiscoveredWorktreeResponse = RemoveDiscoveredWorktreeResponses[keyof RemoveDiscoveredWorktreeResponses];
 export type RemoveWorktreeData = {
     body?: never;
     path: {
@@ -30511,4 +31634,45 @@ export type GetWorktreeStatusResponses = {
     200: WorktreeStatusResponse;
 };
 export type GetWorktreeStatusResponse = GetWorktreeStatusResponses[keyof GetWorktreeStatusResponses];
+export type ListWorktreesAggregateData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Read all projects and User rows
+         */
+        all_workspaces?: boolean;
+        /**
+         * Repeatable project IDs or @user; requires all_workspaces=true
+         */
+        workspace_ids?: Array<string>;
+    };
+    url: "/api/worktrees";
+};
+export type ListWorktreesAggregateErrors = {
+    /**
+     * Invalid worktree list query
+     */
+    400: ErrorPayload;
+    /**
+     * Workspace not found
+     */
+    404: ErrorPayload;
+    /**
+     * Internal server error
+     */
+    500: ErrorPayload;
+    /**
+     * Worktree service is unavailable
+     */
+    503: ErrorPayload;
+};
+export type ListWorktreesAggregateError = ListWorktreesAggregateErrors[keyof ListWorktreesAggregateErrors];
+export type ListWorktreesAggregateResponses = {
+    /**
+     * OK
+     */
+    200: WorktreesResponse;
+};
+export type ListWorktreesAggregateResponse = ListWorktreesAggregateResponses[keyof ListWorktreesAggregateResponses];
 //# sourceMappingURL=types.gen.d.ts.map