@compozy/client 0.3.0-beta.37 → 0.3.0-beta.39

package/dist/types/generated/openapi/compozy-openapi.d.ts

@@ -243,6 +243,23 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/agents/aggregate": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** List a filtered agent fleet with exact session metrics */
+    get: operations["listAgentsAggregate"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/agents/catalog": {
     parameters: {
       query?: never;
@@ -611,6 +628,23 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/automation/suggestions": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** List consent-first automation suggestions for one workspace */
+    get: operations["listAutomationSuggestionsAggregate"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/automation/triggers": {
     parameters: {
       query?: never;
@@ -1472,6 +1506,57 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/loop-requests": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** List Loop human requests */
+    get: operations["listLoopRequestsAggregate"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/loop-runs": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** List Loop runs */
+    get: operations["listLoopRunsAggregate"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/loops": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** List Loop catalog entries */
+    get: operations["listLoopsAggregate"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/marketplace": {
     parameters: {
       query?: never;
@@ -2057,6 +2142,74 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/provider-usage": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** Read cached provider usage (experimental) */
+    get: operations["listProviderUsage"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/provider-usage/providers/{provider_id}": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** Read cached provider usage (experimental) */
+    get: operations["getProviderUsage"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/provider-usage/refresh": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /** Refresh provider usage (experimental) */
+    post: operations["refreshProviderUsage"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/provider-usage/stream": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** Stream provider usage invalidations (experimental) */
+    get: operations["streamProviderUsage"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/providers": {
     parameters: {
       query?: never;
@@ -2972,6 +3125,24 @@ export interface paths {
     patch: operations["updateSettingsPersona"];
     trace?: never;
   };
+  "/api/settings/provider-usage": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** Read the provider usage settings section */
+    get: operations["getSettingsProviderUsage"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    /** Update the provider usage settings section */
+    patch: operations["updateSettingsProviderUsage"];
+    trace?: never;
+  };
   "/api/settings/providers": {
     parameters: {
       query?: never;
@@ -4023,6 +4194,40 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/terminals": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** List workspace terminals */
+    get: operations["listTerminalsAggregate"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/terminals/catalog-stream": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** Stream one profile-scoped terminal catalog */
+    get: operations["streamTerminalsAggregate"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/tool-approval-grants": {
     parameters: {
       query?: never;
@@ -5104,7 +5309,7 @@ export interface paths {
     };
     get?: never;
     put?: never;
-    /** Archive a stopped session */
+    /** Archive a stopped session, or stop and archive a live session with stop=true */
     post: operations["archiveSession"];
     delete?: never;
     options?: never;
@@ -5436,6 +5641,40 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/workspaces/{workspace_id}/sessions/{session_id}/monitors": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** List a session's monitors */
+    get: operations["listSessionMonitors"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/workspaces/{workspace_id}/sessions/{session_id}/monitors/{monitor_id}/cancel": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /** Cancel a session monitor without waking the session */
+    post: operations["cancelSessionMonitor"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/workspaces/{workspace_id}/sessions/{session_id}/move": {
     parameters: {
       query?: never;
@@ -5453,6 +5692,24 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/workspaces/{workspace_id}/sessions/{session_id}/parent": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    /** Adopt a parentless user session as a child of another session */
+    put: operations["setSessionParent"];
+    post?: never;
+    /** Make an adopted child session top-level again */
+    delete: operations["clearSessionParent"];
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/workspaces/{workspace_id}/sessions/{session_id}/presence": {
     parameters: {
       query?: never;
@@ -6431,6 +6688,23 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/workspaces/{workspace_id}/worktrees/discovered/remove": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /** Remove a discovered worktree */
+    post: operations["removeDiscoveredWorktree"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/workspaces/{workspace_id}/worktrees/{worktree_id}": {
     parameters: {
       query?: never;
@@ -6568,6 +6842,23 @@ export interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/worktrees": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** List registered and discovered worktrees */
+    get: operations["listWorktreesAggregate"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/worktrees/catalog-stream": {
     parameters: {
       query?: never;
@@ -6815,6 +7106,7 @@ export interface components {
       speed?: "normal" | "fast";
       tools?: string[];
       toolsets?: string[];
+      workspace_access?: string;
       workspace_id?: string;
     };
     AgentProbeHealthPayload: {
@@ -6963,26 +7255,33 @@ export interface components {
     AgentSpawnPayload: {
       lineage: components["schemas"]["SessionLineagePayload"];
       permissions: components["schemas"]["SpawnPermissionPolicyPayload"];
+      prompt?: components["schemas"]["SpawnPromptPayload"] | null;
       session: components["schemas"]["SessionPayload"];
+      worktree?: components["schemas"]["SpawnWorktreePayload"] | null;
     };
     AgentSpawnRequest: {
       acp_options?: components["schemas"]["AgentACPOptionSelection"][];
       agent_name: string;
       auto_stop_on_parent: boolean;
       idempotency_key?: string;
+      inherit_permissions?: boolean;
       model?: string;
       name?: string;
+      new_worktree?: components["schemas"]["SpawnNewWorktreeRequest"] | null;
       notify_creator?: boolean | null;
-      permissions: components["schemas"]["SpawnPermissionPolicyPayload"];
+      permissions: components["schemas"]["SpawnPermissionRequestPayload"];
+      prompt?: string;
       prompt_overlay?: string;
       provider?: string;
       reasoning_effort?: string;
       spawn_role: string;
       /** @enum {string} */
       speed?: "normal" | "fast";
+      toolsets?: string[];
       /** Format: int64 */
       ttl_seconds: number;
       workspace?: string;
+      worktree?: string;
     };
     AgentSpawnResponse: {
       spawn: components["schemas"]["AgentSpawnPayload"];
@@ -7736,6 +8035,7 @@ export interface components {
       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"
@@ -7886,6 +8186,7 @@ export interface components {
       speed?: "normal" | "fast";
       tools?: string[];
       toolsets?: string[];
+      workspace_access?: string;
     };
     CreateAgentRequest: {
       agent: components["schemas"]["CreateAgentPayload"];
@@ -7910,7 +8211,7 @@ export interface components {
       retry?: components["schemas"]["RetryConfig"] | null;
       schedule: components["schemas"]["ScheduleSpec"];
       /** @enum {string} */
-      scope: "global" | "workspace";
+      scope: "global" | "workspace" | "user" | "@user";
       target_kind?: string;
       task?: components["schemas"]["JobTaskConfig"] | null;
       workspace_id?: string;
@@ -7936,6 +8237,7 @@ export interface components {
       name?: string;
       new_worktree?: components["schemas"]["NewSessionWorktreeRequest"] | null;
       parent_session_id?: string;
+      scope?: string;
       workspace?: string;
       workspace_path?: string;
       worktree?: string;
@@ -7967,7 +8269,7 @@ export interface components {
       /** @enum {string} */
       priority?: "low" | "medium" | "high" | "urgent";
       /** @enum {string} */
-      scope: "global" | "workspace";
+      scope: "global" | "workspace" | "user" | "@user";
       title: string;
       wake_creator?: boolean | null;
       workspace?: string;
@@ -7986,7 +8288,7 @@ export interface components {
       /** @enum {string} */
       priority?: "low" | "medium" | "high" | "urgent";
       /** @enum {string} */
-      scope: "global" | "workspace";
+      scope: "global" | "workspace" | "user" | "@user";
       title: string;
       wake_creator?: boolean | null;
       workspace?: string;
@@ -8005,7 +8307,7 @@ export interface components {
       prompt: string;
       retry?: components["schemas"]["RetryConfig"] | null;
       /** @enum {string} */
-      scope: "global" | "workspace";
+      scope: "global" | "workspace" | "user" | "@user";
       target_kind?: string;
       webhook_id?: string;
       webhook_secret_value?: string;
@@ -8024,6 +8326,11 @@ export interface components {
       name?: string;
       path?: string;
     };
+    CursorPagePayload: {
+      has_more: boolean;
+      limit: number;
+      next_cursor?: string;
+    };
     DaemonIdentityPayload: {
       http_host: string;
       http_port: number;
@@ -8163,6 +8470,7 @@ export interface components {
       speed?: "normal" | "fast";
       tools?: string[];
       toolsets?: string[];
+      workspace_access?: string;
     };
     DuplicateAgentRequest: {
       name: string;
@@ -9895,11 +10203,33 @@ export interface components {
       tokens: number;
       wall_clock_sec: number;
     };
+    LoopCatalogAggregateEntryPayload: {
+      aggregate_30d: components["schemas"]["LoopCatalogAggregatePayload"];
+      catalog: components["schemas"]["LoopCatalogResourceSpec"];
+      contract: components["schemas"]["LoopContract"];
+      description?: string;
+      inputs?: {
+        [key: string]: components["schemas"]["LoopInput"];
+      };
+      last_run?: components["schemas"]["LoopCatalogLastRunPayload"] | null;
+      name: string;
+      source: components["schemas"]["LoopCatalogSourcePayload"];
+      start?: components["schemas"]["LoopStartBinding"][];
+      /** Format: double */
+      success_rate_30d: number;
+      version: number;
+      workspace_id?: string;
+    };
     LoopCatalogAggregatePayload: {
       failed: number;
       runs: number;
       succeeded: number;
     };
+    LoopCatalogBatchResponse: {
+      entries: components["schemas"]["LoopCatalogAggregateEntryPayload"][];
+      errors: components["schemas"]["LoopCatalogWorkspaceError"][];
+      truncated: boolean;
+    };
     LoopCatalogEntryPayload: {
       aggregate_30d: components["schemas"]["LoopCatalogAggregatePayload"];
       catalog: components["schemas"]["LoopCatalogResourceSpec"];
@@ -9916,6 +10246,7 @@ export interface components {
       /** Format: double */
       success_rate_30d: number;
       version: number;
+      workspace_id?: string;
     };
     LoopCatalogFacetsPayload: {
       categories: {
@@ -9956,6 +10287,16 @@ export interface components {
       keywords?: string[];
       use_when?: string;
     };
+    LoopCatalogSourcePayload: {
+      /** @enum {string} */
+      kind: "marketplace" | "user" | "additional" | "workspace";
+      layer: string;
+    };
+    LoopCatalogWorkspaceError: {
+      code: string;
+      message: string;
+      workspace_id?: string;
+    };
     LoopConfig: {
       /** @enum {string|null} */
       budget_on_exceeded?: "halt" | "escalate" | null;
@@ -10450,6 +10791,7 @@ export interface components {
       /** Format: date-time */
       state_at: string;
       wait?: components["schemas"]["LoopNodeWaitPayload"] | null;
+      workspace_id?: string;
     };
     LoopNodeInventoryResponse: {
       items: components["schemas"]["LoopNodeInventoryItem"][];
@@ -10548,12 +10890,14 @@ export interface components {
       node_id: string;
       /** Format: date-time */
       opened_at: string;
+      profile_id: string;
       prompt: string;
       proposed_preview?: unknown;
       /** Format: date-time */
       resolved_at?: string | null;
       respond_schema?: unknown;
       state: string;
+      workspace_id?: string;
     };
     LoopRequestProvenance: {
       actor_id: string;
@@ -11321,6 +11665,7 @@ export interface components {
       session_id?: string;
       task_id?: string;
       title: string;
+      workspace_id: string;
     };
     OverviewAttentionPayload: {
       by_kind: {
@@ -11743,6 +12088,112 @@ export interface components {
       runtime_strategy?: "session_config" | "launch_arg" | "provider_managed";
       session_env_status?: components["schemas"]["SettingsProviderCredentialStatusPayload"][];
     };
+    ProviderUsageAccount: {
+      label: string;
+      plan: string;
+    };
+    ProviderUsageAmount: {
+      unit: string;
+      value: string;
+    };
+    ProviderUsageBalance: {
+      /** Format: date-time */
+      expires_at: string | null;
+      id: string;
+      label: string;
+      remaining: components["schemas"]["ProviderUsageAmount"];
+    };
+    ProviderUsageEnvelope: {
+      enabled: boolean;
+      /** Format: date-time */
+      generated_at: string;
+      keychain_supported: boolean;
+      profile_id: string;
+      /** Format: uint64 */
+      revision: number;
+      targets: components["schemas"]["ProviderUsageTarget"][];
+      tray: components["schemas"]["ProviderUsageTraySignal"] | null;
+    };
+    ProviderUsageError: {
+      action: string;
+      code: string;
+      message: string;
+      /** Format: date-time */
+      retry_after: string | null;
+    };
+    ProviderUsageRefreshRequest: {
+      intent?: string;
+      /** Format: int64 */
+      max_age_seconds?: number;
+      profile?: string;
+      provider_ids?: string[];
+      /** Format: int64 */
+      wait_ms?: number | null;
+    };
+    ProviderUsageSource: {
+      kind: string;
+      label: string;
+    };
+    ProviderUsageSpendCap: {
+      enabled: boolean | null;
+      id: string;
+      label: string;
+      limit: components["schemas"]["ProviderUsageAmount"] | null;
+      /** Format: date-time */
+      resets_at: string | null;
+      used: components["schemas"]["ProviderUsageAmount"];
+      /** Format: double */
+      used_percent: number | null;
+    };
+    ProviderUsageStreamEvent: {
+      boot_id: string;
+      /** Format: uint64 */
+      revision: number;
+    };
+    ProviderUsageTarget: {
+      account: components["schemas"]["ProviderUsageAccount"] | null;
+      balances: components["schemas"]["ProviderUsageBalance"][];
+      /** Format: date-time */
+      checked_at: string | null;
+      confidence: string;
+      error: components["schemas"]["ProviderUsageError"] | null;
+      /** Format: date-time */
+      measured_at: string | null;
+      /** Format: date-time */
+      next_refresh_at: string | null;
+      provider_id: string;
+      provider_name: string;
+      refreshing: boolean;
+      source: components["schemas"]["ProviderUsageSource"] | null;
+      spend_caps: components["schemas"]["ProviderUsageSpendCap"][];
+      status: string;
+      windows: components["schemas"]["ProviderUsageWindow"][];
+    };
+    ProviderUsageTraySignal: {
+      label: string;
+      provider_id: string;
+      /** Format: date-time */
+      resets_at: string | null;
+      severity: string;
+      stale: boolean;
+      /** Format: double */
+      used_percent: number;
+      window_id: string;
+    };
+    ProviderUsageWindow: {
+      /** Format: int64 */
+      duration_seconds: number | null;
+      id: string;
+      kind: string;
+      label: string;
+      limit: components["schemas"]["ProviderUsageAmount"] | null;
+      reset_text: string;
+      /** Format: date-time */
+      resets_at: string | null;
+      used: components["schemas"]["ProviderUsageAmount"] | null;
+      /** Format: double */
+      used_percent: number | null;
+    };
     PutLoopAnnotationsRequest: {
       annotations: components["schemas"]["LoopAnnotationPayload"][];
     };
@@ -11894,6 +12345,7 @@ export interface components {
         | "skill_resource_not_found"
         | "slow_consumer"
         | "source_disabled"
+        | "spawn_budget_exhausted"
         | "subscriber_limit_reached"
         | "terminal_exited"
         | "terminal_expired"
@@ -11943,6 +12395,11 @@ export interface components {
       confirm_gateway_digest?: string;
       generation_hash: string;
     };
+    RemoveDiscoveredWorktreeRequest: {
+      expect_stale?: boolean;
+      force?: boolean;
+      path: string;
+    };
     RenameProfilePlan: {
       dormant_placements: components["schemas"]["ProfilePlacement"][];
       machine_folders: string[];
@@ -12275,6 +12732,7 @@ export interface components {
     };
     RunPayload: {
       attempt: number;
+      attribution: string;
       delivery_error?: string;
       /** Format: date-time */
       delivery_error_at?: string | null;
@@ -12302,6 +12760,7 @@ export interface components {
       task_id?: string;
       task_run_id?: string;
       trigger_id?: string;
+      workspace_id?: string | null;
     };
     RunResponse: {
       run: components["schemas"]["RunPayload"];
@@ -12407,6 +12866,7 @@ export interface components {
       title?: string;
     };
     RunsResponse: {
+      page?: components["schemas"]["CursorPagePayload"] | null;
       runs: components["schemas"]["RunPayload"][];
     };
     RuntimeActivityPayload: {
@@ -12724,6 +13184,7 @@ export interface components {
       working: number;
     };
     SessionCatalogFacetsResponse: {
+      by_profile: components["schemas"]["SessionProfileFacetsPayload"][];
       by_workspace: components["schemas"]["SessionWorkspaceFacetsPayload"][];
       facets: components["schemas"]["SessionCatalogFacetsPayload"];
     };
@@ -13206,6 +13667,33 @@ export interface components {
       /** Format: date-time */
       ttl_expires_at?: string | null;
     };
+    SessionMonitorPayload: {
+      /** Format: date-time */
+      created_at: string;
+      /** Format: date-time */
+      deadline_at: string;
+      description: string;
+      exit_code?: number | null;
+      /** Format: date-time */
+      fired_at?: string | null;
+      kind: string;
+      monitor_id: string;
+      pattern?: string;
+      reason?: string;
+      session_id: string;
+      status: string;
+      terminal_id?: string;
+      until?: string;
+    };
+    SessionMonitorResponse: {
+      monitor: components["schemas"]["SessionMonitorPayload"];
+    };
+    SessionMonitorSummaryPayload: {
+      active: number;
+    };
+    SessionMonitorsResponse: {
+      monitors: components["schemas"]["SessionMonitorPayload"][];
+    };
     SessionOwner: {
       session_id: string;
       workspace_id: string;
@@ -13229,12 +13717,14 @@ export interface components {
       /** Format: date-time */
       created_at: string;
       derivation?: components["schemas"]["SessionDerivationPayload"] | null;
+      effective_workspace_access: string;
       escalated?: boolean | null;
       failure?: components["schemas"]["SessionFailurePayload"] | null;
       folder_id?: string;
       health?: components["schemas"]["SessionHealthPayload"] | null;
       id: string;
       lineage?: components["schemas"]["SessionLineagePayload"] | null;
+      monitor_summary?: components["schemas"]["SessionMonitorSummaryPayload"] | null;
       name?: string;
       pending_interactions: components["schemas"]["PendingInteractionPayload"][];
       profile_archived?: boolean;
@@ -13246,6 +13736,7 @@ export interface components {
       queue?: components["schemas"]["SessionQueueSummaryPayload"] | null;
       reply_watches?: components["schemas"]["ReplyWatchPayload"][];
       runtime: components["schemas"]["SessionRuntimePayload"];
+      scope: string;
       /** @enum {string} */
       state: "starting" | "active" | "stopping" | "stopped";
       stop_cause?: string;
@@ -13283,6 +13774,10 @@ export interface components {
     SessionPresenceResponse: {
       lease_id: string;
     };
+    SessionProfileFacetsPayload: {
+      facets: components["schemas"]["SessionCatalogFacetsPayload"];
+      profile_id: string;
+    };
     SessionPromptCancelResponse: {
       outcome: string;
       session_id: string;
@@ -13342,6 +13837,7 @@ export interface components {
       generation?: number;
       last_known?: components["schemas"]["RuntimeSelectionPayload"] | null;
       recovery?: components["schemas"]["SessionRuntimeRecoveryPayload"] | null;
+      requested?: components["schemas"]["PromptRuntimeSelectionPayload"] | null;
       selected?: components["schemas"]["PromptRuntimeSelectionPayload"] | null;
       /** Format: int64 */
       selection_revision: number;
@@ -13478,6 +13974,7 @@ export interface components {
       total_tokens?: number | null;
       /** Format: int64 */
       turn_count: number;
+      work_time?: components["schemas"]["SessionWorkTimePayload"] | null;
     };
     SessionUsageResponse: {
       usage: components["schemas"]["SessionUsagePayload"];
@@ -13512,6 +14009,13 @@ export interface components {
       /** Format: int64 */
       waited_ms: number;
     };
+    SessionWorkTimePayload: {
+      /** Format: int64 */
+      active_duration_ms: number;
+      last_completed_turn_id?: string;
+      /** Format: int64 */
+      turn_count: number;
+    };
     SessionWorkspaceFacetsPayload: {
       facets: components["schemas"]["SessionCatalogFacetsPayload"];
       workspace_id: string;
@@ -13523,6 +14027,9 @@ export interface components {
     SetExtensionSecretsRequest: {
       bindings: components["schemas"]["ExtensionSecretBindingInput"][];
     };
+    SetSessionParentRequest: {
+      parent_session_id: string;
+    };
     SetSessionRuntimeRequest: {
       /** Format: int64 */
       expected_revision: number | null;
@@ -13571,6 +14078,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace"
@@ -13615,6 +14123,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
@@ -13644,12 +14153,14 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
     };
     SettingsAutomationRuntimePayload: {
       available: boolean;
+      host_timezone?: string;
       job_enabled: number;
       job_total: number;
       /** Format: date-time */
@@ -13685,6 +14196,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
@@ -13815,6 +14327,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
@@ -13979,6 +14492,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
@@ -14191,6 +14705,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
@@ -14220,6 +14735,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
@@ -14267,6 +14783,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
@@ -14390,6 +14907,42 @@ export interface components {
       steer_capability?: "steer_ext" | "concurrent_prompt" | "none";
       transport?: string;
     };
+    SettingsProviderUsagePayload: {
+      enabled: boolean;
+      providers: {
+        [key: string]: components["schemas"]["SettingsProviderUsageProviderPayload"];
+      };
+      refresh_interval: string;
+    };
+    SettingsProviderUsageProviderPayload: {
+      enabled?: boolean | null;
+      keychain_access?: boolean | null;
+    };
+    SettingsProviderUsageResponse: {
+      available_scopes: "user"[];
+      config: components["schemas"]["SettingsProviderUsagePayload"];
+      keychain_supported: boolean;
+      /** @enum {string} */
+      scope: "user";
+      /** @enum {string} */
+      section:
+        | "general"
+        | "persona"
+        | "roles"
+        | "skills"
+        | "automation"
+        | "window-manager"
+        | "cmd-palette"
+        | "attention"
+        | "shell"
+        | "provider-usage"
+        | "observability"
+        | "hooks-extensions"
+        | "marketplace";
+    };
+    SettingsProviderUsageUpdateRequest: {
+      config: components["schemas"]["SettingsProviderUsagePayload"];
+    };
     SettingsProviderWritePayload: {
       auth_acp_method?: string | null;
       auth_login_command?: string | null;
@@ -14465,17 +15018,83 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
       workspace_id?: string;
     };
+    SettingsShellLegacyScopePayload: {
+      explicit: boolean;
+      /** Format: uint64 */
+      revision: number;
+      /** @enum {string} */
+      value: "workspace" | "all-workspaces";
+    };
+    SettingsShellMutationResponse: {
+      active_config_hash: string;
+      /** Format: int64 */
+      active_generation: number;
+      agent_name?: string;
+      applied: boolean;
+      apply_record_id: string;
+      config: components["schemas"]["SettingsShellPayload"];
+      legacy_scope: components["schemas"]["SettingsShellLegacyScopePayload"];
+      /** @enum {string} */
+      lifecycle:
+        | "live"
+        | "live-add"
+        | "live-remove-if-unused"
+        | "restart-required"
+        | "session-rebind";
+      /** @enum {string} */
+      next_action: "none" | "restart-daemon" | "new-session" | "retry";
+      partial_failures?: components["schemas"]["SettingsApplyFailurePayload"][];
+      profile?: string;
+      restart_required?: boolean;
+      restart_scope?: string;
+      /** @enum {string} */
+      scope?: "user" | "profile" | "workspace" | "agent";
+      /** @enum {string} */
+      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?: string[];
+      workspace_id?: string;
+      /** @enum {string} */
+      write_target?:
+        | "global-config"
+        | "profile-config"
+        | "workspace-config"
+        | "global-mcp-sidecar"
+        | "profile-mcp-sidecar"
+        | "workspace-mcp-sidecar"
+        | "global-agent-file"
+        | "workspace-agent-file";
+    };
     SettingsShellPayload: {
       sessions: components["schemas"]["SettingsShellSessionsPayload"];
     };
     SettingsShellResponse: {
       available_scopes: "user"[];
       config: components["schemas"]["SettingsShellPayload"];
+      legacy_scope: components["schemas"]["SettingsShellLegacyScopePayload"];
       /** @enum {string} */
       scope: "user";
       /** @enum {string} */
@@ -14489,15 +15108,19 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
+      warnings: string[];
     };
     SettingsShellSessionsPayload: {
       /** @enum {string} */
-      scope: "workspace" | "all-workspaces";
+      group_by?: "none" | "project" | "profile";
+      /** @enum {string} */
+      scope?: "workspace" | "all-workspaces";
       /** @enum {string} */
-      sort: "created" | "name" | "last_activity" | "attention" | "manual";
+      sort?: "created" | "name" | "last_activity" | "attention" | "manual";
     };
     SettingsSkillSourceCollisionPayload: {
       name: string;
@@ -14590,6 +15213,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
@@ -14637,6 +15261,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
@@ -14940,6 +15565,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
@@ -14974,6 +15600,7 @@ export interface components {
         | "cmd-palette"
         | "attention"
         | "shell"
+        | "provider-usage"
         | "observability"
         | "hooks-extensions"
         | "marketplace";
@@ -15168,12 +15795,38 @@ export interface components {
       /** Format: int64 */
       ttl_seconds: number;
     };
+    SpawnNewWorktreeRequest: {
+      base_ref?: string;
+      branch?: string;
+      name?: string;
+    };
     SpawnPermissionPolicyPayload: {
       mcp_servers: string[];
       skills: string[];
       tools: string[];
       workspace_paths: string[];
     };
+    SpawnPermissionRequestPayload: {
+      mcp_servers?: string[];
+      skills?: string[];
+      tools?: string[];
+      workspace_paths?: string[];
+    };
+    SpawnPromptPayload: {
+      error?: string;
+      message_id: string;
+      reply_watch_id?: string;
+      reply_watch_state?: string;
+      status: string;
+    };
+    SpawnWorktreePayload: {
+      base_sha?: string;
+      branch: string;
+      created: boolean;
+      id: string;
+      name: string;
+      path: string;
+    };
     StartBinding: {
       input_mapping?: {
         [key: string]: string;
@@ -16948,6 +17601,7 @@ export interface components {
         | "skill_resource_not_found"
         | "slow_consumer"
         | "source_disabled"
+        | "spawn_budget_exhausted"
         | "subscriber_limit_reached"
         | "terminal_exited"
         | "terminal_expired"
@@ -17010,6 +17664,7 @@ export interface components {
         | "recording_already_started"
         | "recording_not_active"
         | "recording_unavailable"
+        | "session_archive_stop_failed"
         | "session_busy"
         | "slow_consumer"
         | "subscriber_limit_reached"
@@ -17108,6 +17763,7 @@ export interface components {
         | "skill_resource_not_found"
         | "slow_consumer"
         | "source_disabled"
+        | "spawn_budget_exhausted"
         | "subscriber_limit_reached"
         | "terminal_exited"
         | "terminal_expired"
@@ -17201,6 +17857,7 @@ export interface components {
         | "recording_already_started"
         | "recording_not_active"
         | "recording_unavailable"
+        | "session_archive_stop_failed"
         | "session_busy"
         | "slow_consumer"
         | "subscriber_limit_reached"
@@ -17295,6 +17952,7 @@ export interface components {
         | "skill_resource_not_found"
         | "slow_consumer"
         | "source_disabled"
+        | "spawn_budget_exhausted"
         | "subscriber_limit_reached"
         | "terminal_exited"
         | "terminal_expired"
@@ -17413,6 +18071,7 @@ export interface components {
         | "skill_resource_not_found"
         | "slow_consumer"
         | "source_disabled"
+        | "spawn_budget_exhausted"
         | "subscriber_limit_reached"
         | "terminal_exited"
         | "terminal_expired"
@@ -17545,6 +18204,7 @@ export interface components {
         | "skill_resource_not_found"
         | "slow_consumer"
         | "source_disabled"
+        | "spawn_budget_exhausted"
         | "subscriber_limit_reached"
         | "terminal_exited"
         | "terminal_expired"
@@ -18361,6 +19021,7 @@ export interface components {
       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"
@@ -20150,6 +20811,90 @@ export interface operations {
       };
     };
   };
+  listAgentsAggregate: {
+    parameters: {
+      query?: {
+        /** @description Read all projects and User rows */
+        all_workspaces?: boolean;
+        /** @description Repeatable project IDs or @user; requires all_workspaces=true */
+        workspace_ids?: string[];
+        /** @description Exact agent name */
+        name?: string;
+        /** @description Case-insensitive agent name or category search */
+        q?: string;
+        /** @description Exact category path joined by slash separators */
+        category?: string;
+        /** @description Agent session status */
+        status?: "active" | "idle";
+        /** @description Opaque cursor bound to workspace and filters */
+        cursor?: string;
+        /** @description Agents per page (1-100; default 50) */
+        limit?: number;
+        /** @description Act as this profile by name */
+        profile?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["AgentCatalogResponse"];
+        };
+      };
+      /** @description Invalid filter */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Workspace not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Workspace root missing */
+      410: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Workspace resolver unavailable */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
   listAgentCatalog: {
     parameters: {
       query?: {
@@ -21903,9 +22648,13 @@ export interface operations {
     parameters: {
       query?: {
         /** @description Filter by automation scope */
-        scope?: "global" | "workspace";
+        scope?: "global" | "workspace" | "user" | "@user";
         /** @description Filter by workspace id */
         workspace_id?: string;
+        /** @description Read every definition */
+        all_workspaces?: boolean;
+        /** @description Project IDs or @user; requires all_workspaces=true */
+        workspace_ids?: string[];
         /** @description Filter by job source */
         source?: "config" | "package" | "dynamic";
         /** @description Filter by target kind; task matches jobs with a task target */
@@ -22379,6 +23128,14 @@ export interface operations {
   listAutomationRuns: {
     parameters: {
       query?: {
+        /** @description Filter by source project; @user selects User */
+        workspace_id?: string;
+        /** @description Read every run, including unknown attribution */
+        all_workspaces?: boolean;
+        /** @description Source project IDs or @user; excludes unknown attribution */
+        workspace_ids?: string[];
+        /** @description Opaque source-filter-bound cursor */
+        cursor?: string;
         /** @description Filter by automation job id */
         job_id?: string;
         /** @description Filter by automation trigger id */
@@ -22495,13 +23252,80 @@ export interface operations {
       };
     };
   };
+  listAutomationSuggestionsAggregate: {
+    parameters: {
+      query?: {
+        /** @description Read all projects and User rows */
+        all_workspaces?: boolean;
+        /** @description Repeatable project IDs or @user; requires all_workspaces=true */
+        workspace_ids?: string[];
+        /** @description Filter by suggestion status */
+        status?: "pending" | "accepted" | "dismissed";
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["AutomationSuggestionsResponse"];
+        };
+      };
+      /** @description Invalid suggestion status */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Workspace not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Automation manager is not configured */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
   listAutomationTriggers: {
     parameters: {
       query?: {
         /** @description Filter by automation scope */
-        scope?: "global" | "workspace";
+        scope?: "global" | "workspace" | "user" | "@user";
         /** @description Filter by workspace id */
         workspace_id?: string;
+        /** @description Read every definition */
+        all_workspaces?: boolean;
+        /** @description Project IDs or @user; requires all_workspaces=true */
+        workspace_ids?: string[];
         /** @description Filter by trigger source */
         source?: "config" | "package" | "dynamic";
         /** @description Filter by target kind; task matches no trigger */
@@ -26206,6 +27030,233 @@ export interface operations {
       };
     };
   };
+  listLoopRequestsAggregate: {
+    parameters: {
+      query?: {
+        /** @description Read all registered projects and User rows */
+        all_workspaces?: boolean;
+        /** @description Repeatable project IDs or @user; requires all_workspaces=true */
+        workspace_ids?: string[];
+        /** @description Filter by Loop run id */
+        run_id?: string;
+        /** @description Filter by pending or resolved state */
+        state?: string;
+        /** @description Opaque continuation cursor */
+        cursor?: string;
+        /** @description Maximum number of records to return */
+        limit?: number;
+        /** @description Read one profile's rows by name */
+        profile?: string;
+        /** @description Read the owner-labeled all-profiles aggregate */
+        all_profiles?: boolean;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["LoopRequestsResponse"];
+        };
+      };
+      /** @description Invalid Loop request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Loop service is not configured */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
+  listLoopRunsAggregate: {
+    parameters: {
+      query?: {
+        /** @description Read all registered projects and User rows */
+        all_workspaces?: boolean;
+        /** @description Repeatable project IDs or @user; requires all_workspaces=true */
+        workspace_ids?: string[];
+        /** @description Filter by Loop name */
+        loop?: string;
+        /** @description Filter by Loop status */
+        status?: string;
+        /** @description Filter by catalog or session origin */
+        origin?: string;
+        /** @description Filter by origin session id */
+        origin_session?: string;
+        /** @description Filter by live or terminal status */
+        live?: boolean;
+        /** @description Opaque server-order cursor */
+        cursor?: string;
+        /** @description Maximum number of records to return */
+        limit?: number;
+        /** @description Read one profile's rows by name */
+        profile?: string;
+        /** @description Read the owner-labeled all-profiles aggregate */
+        all_profiles?: boolean;
+        /** @description Aggregate runs support recency order only */
+        order?: "recency";
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["LoopRunsResponse"];
+        };
+      };
+      /** @description Invalid Loop request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Loop service is not configured */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
+  listLoopsAggregate: {
+    parameters: {
+      query?: {
+        /** @description Read all registered projects and User rows */
+        all_workspaces?: boolean;
+        /** @description Repeatable project IDs or @user; requires all_workspaces=true */
+        workspace_ids?: string[];
+        /** @description Search Loop name or contract goal */
+        q?: string;
+        /** @description Filter by effective Loop kind */
+        kind?: "read_only" | "workspace";
+        /** @description Filter by exact catalog category */
+        category?: string;
+        /** @description Filter by exact latest-run status */
+        status?:
+          | "queued"
+          | "running"
+          | "watching"
+          | "needs-approval"
+          | "paused"
+          | "done"
+          | "no-op"
+          | "blocked"
+          | "failed"
+          | "exhausted"
+          | "stalled"
+          | "canceled";
+        /** @description Stable read-only-first name order */
+        sort?: "name";
+        /** @description Continue after this workspace- and query-bound Loop cursor */
+        cursor?: string;
+        /** @description Maximum number of Loops to return; defaults to 50 and is capped at 200 */
+        limit?: number;
+        /** @description Read one profile's rows by name */
+        profile?: string;
+        /** @description Read the owner-labeled all-profiles aggregate */
+        all_profiles?: boolean;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["LoopCatalogBatchResponse"];
+        };
+      };
+      /** @description Invalid Loop request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Forbidden */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Loop service is not configured */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
   listMarketplace: {
     parameters: {
       query?: {
@@ -27362,6 +28413,8 @@ export interface operations {
         receipt_profile?: string;
         /** @description Home workspace scope; empty selects global tasks */
         workspace?: string;
+        /** @description Every project's tasks, matching an All projects Home overview */
+        all_workspaces?: boolean;
         /** @description Read one profile's rows by name */
         profile?: string;
         /** @description Read the owner-labeled all-profiles aggregate */
@@ -27427,6 +28480,8 @@ export interface operations {
         receipt_profile?: string;
         /** @description Home workspace scope; empty selects global tasks */
         workspace?: string;
+        /** @description Every project's tasks, matching an All projects Home overview */
+        all_workspaces?: boolean;
         /** @description Read one profile's rows by name */
         profile?: string;
         /** @description Read the owner-labeled all-profiles aggregate */
@@ -27502,6 +28557,8 @@ export interface operations {
   getObserveOverview: {
     parameters: {
       query?: {
+        /** @description Read every project and User within the profile lens; conflicts with workspace */
+        all_workspaces?: boolean;
         /** @description Profile owning acknowledgement receipts, including aggregate reads */
         receipt_profile?: string;
         /** @description Scope aggregates to one workspace; empty selects the global home scope */
@@ -27528,6 +28585,24 @@ export interface operations {
           "application/json": components["schemas"]["ObserveOverviewResponse"];
         };
       };
+      /** @description Invalid workspace breadth */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Agent aggregate access denied */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
       /** @description Workspace not found */
       404: {
         headers: {
@@ -27569,8 +28644,12 @@ export interface operations {
   getTaskDashboard: {
     parameters: {
       query?: {
+        /** @description Read every project and User within the profile lens; conflicts with workspace */
+        all_workspaces?: boolean;
+        /** @description Repeatable project IDs; @user selects User; requires all_workspaces=true */
+        workspace_ids?: string[];
         /** @description Filter by task scope */
-        scope?: "global" | "workspace";
+        scope?: "global" | "workspace" | "user" | "@user";
         /** @description Filter by workspace path, name, or ID */
         workspace?: string;
         /** @description Filter by active run worktree ID */
@@ -27609,6 +28688,24 @@ export interface operations {
           "application/json": components["schemas"]["TaskDashboardResponse"];
         };
       };
+      /** @description Invalid workspace breadth */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Agent aggregate access denied */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
       /** @description Workspace not found */
       404: {
         headers: {
@@ -27651,9 +28748,13 @@ export interface operations {
     parameters: {
       query?: {
         /** @description Filter by task scope */
-        scope?: "global" | "workspace";
+        scope?: "global" | "workspace" | "user" | "@user";
         /** @description Filter by workspace path, name, or ID */
         workspace?: string;
+        /** @description Read all projects and User rows */
+        all_workspaces?: boolean;
+        /** @description Repeatable project IDs or @user; requires all_workspaces=true */
+        workspace_ids?: string[];
         /** @description Filter by active run worktree ID */
         worktree?: string;
         /** @description Filter by owner kind */
@@ -28954,6 +30055,335 @@ export interface operations {
       };
     };
   };
+  listProviderUsage: {
+    parameters: {
+      query?: {
+        /** @description Profile name; defaults to the caller session profile or default */
+        profile?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Profile-scoped usage envelope */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ProviderUsageEnvelope"];
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description App token route forbidden */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Profile or provider not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json":
+            | components["schemas"]["ErrorPayload"]
+            | components["schemas"]["ProfileErrorPayload"];
+        };
+      };
+      /** @description Usage disabled or session profile conflict */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json":
+            | components["schemas"]["ErrorPayload"]
+            | components["schemas"]["ProfileErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Usage service unavailable */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
+  getProviderUsage: {
+    parameters: {
+      query?: {
+        /** @description Profile name; defaults to the caller session profile or default */
+        profile?: string;
+      };
+      header?: never;
+      path: {
+        /** @description Canonical provider ID */
+        provider_id: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Profile-scoped usage envelope */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ProviderUsageEnvelope"];
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description App token route forbidden */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Profile or provider not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json":
+            | components["schemas"]["ErrorPayload"]
+            | components["schemas"]["ProfileErrorPayload"];
+        };
+      };
+      /** @description Usage disabled or session profile conflict */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json":
+            | components["schemas"]["ErrorPayload"]
+            | components["schemas"]["ProfileErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Usage service unavailable */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
+  refreshProviderUsage: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** @description JSON request body */
+    requestBody?: {
+      content: {
+        "application/json": components["schemas"]["ProviderUsageRefreshRequest"];
+      };
+    };
+    responses: {
+      /** @description Profile-scoped usage envelope */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ProviderUsageEnvelope"];
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description App token route forbidden */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Profile or provider not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json":
+            | components["schemas"]["ErrorPayload"]
+            | components["schemas"]["ProfileErrorPayload"];
+        };
+      };
+      /** @description Usage disabled or session profile conflict */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json":
+            | components["schemas"]["ErrorPayload"]
+            | components["schemas"]["ProfileErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Usage service unavailable */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
+  streamProviderUsage: {
+    parameters: {
+      query?: {
+        /** @description Profile name; defaults to the caller session profile or default */
+        profile?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description ready and provider_usage_changed revision events */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "text/event-stream": components["schemas"]["ProviderUsageStreamEvent"];
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description App token route forbidden */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Profile or provider not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json":
+            | components["schemas"]["ErrorPayload"]
+            | components["schemas"]["ProfileErrorPayload"];
+        };
+      };
+      /** @description Usage disabled or session profile conflict */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json":
+            | components["schemas"]["ErrorPayload"]
+            | components["schemas"]["ProfileErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Usage service unavailable */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
   listProviders: {
     parameters: {
       query?: never;
@@ -30199,7 +31629,7 @@ export interface operations {
         /** @description Maximum number of queued runs to return */
         limit?: number;
         /** @description Filter by catalog visibility */
-        scope?: "all" | "global" | "workspace";
+        scope?: "all" | "global" | "workspace" | "user" | "@user";
         /** @description Filter by workspace path, name, or ID */
         workspace?: string;
         /** @description Include runs blocked by task pause state */
@@ -30457,6 +31887,8 @@ export interface operations {
         workspace_id?: string;
         /** @description Use the explicit all-workspaces aggregate */
         all_workspaces?: boolean;
+        /** @description Project IDs or @user; repeatable, requires all_workspaces */
+        workspace_ids?: string[];
         /** @description Include metadata-only health for returned sessions */
         include_health?: boolean;
         /** @description Omit the exact catalog count for a bounded cursor read */
@@ -30756,6 +32188,8 @@ export interface operations {
         workspace_id?: string;
         /** @description Use the explicit all-workspaces aggregate */
         all_workspaces?: boolean;
+        /** @description Project IDs or @user; repeatable, requires all_workspaces */
+        workspace_ids?: string[];
         /** @description Filter by bound worktree id */
         worktree?: string;
         /** @description Filter by exact agent name */
@@ -33178,6 +34612,112 @@ export interface operations {
       };
     };
   };
+  getSettingsProviderUsage: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["SettingsProviderUsageResponse"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
+  updateSettingsProviderUsage: {
+    parameters: {
+      query?: {
+        /** @description Collection profile name or ID for local Keychain consent; independent of user config scope; defaults to default */
+        collection_profile?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /** @description JSON request body */
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["SettingsProviderUsageUpdateRequest"];
+      };
+    };
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["SettingsApplyResponse"];
+        };
+      };
+      /** @description Invalid settings payload */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json":
+            | components["schemas"]["ErrorPayload"]
+            | components["schemas"]["ProfileErrorPayload"];
+        };
+      };
+      /** @description Forbidden */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Collection profile not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ProfileErrorPayload"];
+        };
+      };
+      /** @description Conflicting settings change */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json":
+            | components["schemas"]["ErrorPayload"]
+            | components["schemas"]["ProfileErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
   listSettingsProviders: {
     parameters: {
       query?: never;
@@ -33548,7 +35088,7 @@ export interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["SettingsApplyResponse"];
+          "application/json": components["schemas"]["SettingsShellMutationResponse"];
         };
       };
       /** @description Invalid settings payload */
@@ -35624,8 +37164,12 @@ export interface operations {
   listTasks: {
     parameters: {
       query?: {
+        /** @description Read every project and User within the profile lens; conflicts with workspace */
+        all_workspaces?: boolean;
+        /** @description Repeatable project IDs; @user selects User; requires all_workspaces=true */
+        workspace_ids?: string[];
         /** @description Filter by catalog visibility */
-        scope?: "all" | "global" | "workspace";
+        scope?: "all" | "global" | "workspace" | "user" | "@user";
         /** @description Filter by workspace path, name, or ID */
         workspace?: string;
         /** @description Filter by task status */
@@ -35694,6 +37238,15 @@ export interface operations {
           "application/json": components["schemas"]["TaskQueryErrorPayload"];
         };
       };
+      /** @description Agent aggregate access denied */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
       /** @description Workspace not found */
       404: {
         headers: {
@@ -37747,11 +39300,143 @@ export interface operations {
       };
     };
   };
-  streamTask: {
+  streamTask: {
+    parameters: {
+      query?: {
+        /** @description Replay events after the supplied task stream sequence */
+        after_sequence?: number;
+        /** @description Read one profile's rows by name */
+        profile?: string;
+        /** @description Read the owner-labeled all-profiles aggregate */
+        all_profiles?: boolean;
+      };
+      header?: never;
+      path: {
+        /** @description Task id */
+        id: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Standard SSE message stream; the payload type identifies each task event */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "text/event-stream": components["schemas"]["TaskStreamEventPayload"];
+        };
+      };
+      /** @description Task not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Invalid task stream query */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Task service is not configured */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
+  getTaskTimeline: {
+    parameters: {
+      query?: {
+        /** @description Return only events after the supplied sequence */
+        after_sequence?: number;
+        /** @description Maximum number of timeline items to return */
+        limit?: number;
+        /** @description Read one profile's rows by name */
+        profile?: string;
+        /** @description Read the owner-labeled all-profiles aggregate */
+        all_profiles?: boolean;
+      };
+      header?: never;
+      path: {
+        /** @description Task id */
+        id: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["TaskTimelineResponse"];
+        };
+      };
+      /** @description Task not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Invalid timeline query */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Task service is not configured */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
+  getTaskTree: {
     parameters: {
       query?: {
-        /** @description Replay events after the supplied task stream sequence */
-        after_sequence?: number;
         /** @description Read one profile's rows by name */
         profile?: string;
         /** @description Read the owner-labeled all-profiles aggregate */
@@ -37766,13 +39451,13 @@ export interface operations {
     };
     requestBody?: never;
     responses: {
-      /** @description Standard SSE message stream; the payload type identifies each task event */
+      /** @description OK */
       200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "text/event-stream": components["schemas"]["TaskStreamEventPayload"];
+          "application/json": components["schemas"]["TaskTreeResponse"];
         };
       };
       /** @description Task not found */
@@ -37784,7 +39469,7 @@ export interface operations {
           "application/json": components["schemas"]["ErrorPayload"];
         };
       };
-      /** @description Invalid task stream query */
+      /** @description Invalid task id */
       422: {
         headers: {
           [name: string]: unknown;
@@ -37813,17 +39498,11 @@ export interface operations {
       };
     };
   };
-  getTaskTimeline: {
+  archiveTask: {
     parameters: {
       query?: {
-        /** @description Return only events after the supplied sequence */
-        after_sequence?: number;
-        /** @description Maximum number of timeline items to return */
-        limit?: number;
-        /** @description Read one profile's rows by name */
+        /** @description Act as this profile by name */
         profile?: string;
-        /** @description Read the owner-labeled all-profiles aggregate */
-        all_profiles?: boolean;
       };
       header?: never;
       path: {
@@ -37840,7 +39519,7 @@ export interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["TaskTimelineResponse"];
+          "application/json": components["schemas"]["TaskTriageStateResponse"];
         };
       };
       /** @description Task not found */
@@ -37852,7 +39531,7 @@ export interface operations {
           "application/json": components["schemas"]["ErrorPayload"];
         };
       };
-      /** @description Invalid timeline query */
+      /** @description Invalid task triage request */
       422: {
         headers: {
           [name: string]: unknown;
@@ -37881,13 +39560,11 @@ export interface operations {
       };
     };
   };
-  getTaskTree: {
+  dismissTask: {
     parameters: {
       query?: {
-        /** @description Read one profile's rows by name */
+        /** @description Act as this profile by name */
         profile?: string;
-        /** @description Read the owner-labeled all-profiles aggregate */
-        all_profiles?: boolean;
       };
       header?: never;
       path: {
@@ -37904,7 +39581,7 @@ export interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["TaskTreeResponse"];
+          "application/json": components["schemas"]["TaskTriageStateResponse"];
         };
       };
       /** @description Task not found */
@@ -37916,7 +39593,7 @@ export interface operations {
           "application/json": components["schemas"]["ErrorPayload"];
         };
       };
-      /** @description Invalid task id */
+      /** @description Invalid task triage request */
       422: {
         headers: {
           [name: string]: unknown;
@@ -37945,7 +39622,7 @@ export interface operations {
       };
     };
   };
-  archiveTask: {
+  markTaskRead: {
     parameters: {
       query?: {
         /** @description Act as this profile by name */
@@ -38007,17 +39684,20 @@ export interface operations {
       };
     };
   };
-  dismissTask: {
+  listTerminalsAggregate: {
     parameters: {
       query?: {
-        /** @description Act as this profile by name */
+        /** @description Read all projects and User rows */
+        all_workspaces?: boolean;
+        /** @description Repeatable project IDs or @user; requires all_workspaces=true */
+        workspace_ids?: string[];
+        /** @description Read one profile's rows by name */
         profile?: string;
+        /** @description Read the owner-labeled all-profiles aggregate */
+        all_profiles?: boolean;
       };
       header?: never;
-      path: {
-        /** @description Task id */
-        id: string;
-      };
+      path?: never;
       cookie?: never;
     };
     requestBody?: never;
@@ -38028,105 +39708,163 @@ export interface operations {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["TaskTriageStateResponse"];
+          "application/json": components["schemas"]["TerminalListResponse"];
         };
       };
-      /** @description Task not found */
-      404: {
+      /** @description Malformed terminal request */
+      400: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["ErrorPayload"];
+          "application/json": components["schemas"]["TerminalErrorResponse"];
         };
       };
-      /** @description Invalid task triage request */
+      /** @description Terminal authentication required */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["TerminalErrorResponse"];
+        };
+      };
+      /** @description Terminal operation forbidden */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["TerminalErrorResponse"];
+        };
+      };
+      /** @description Terminal state or profile conflict */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["TerminalErrorResponse"];
+        };
+      };
+      /** @description Invalid profile selection */
       422: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["ErrorPayload"];
+          "application/json": components["schemas"]["TerminalErrorResponse"];
         };
       };
-      /** @description Internal server error */
+      /** @description Terminal transport failed */
       500: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["ErrorPayload"];
+          "application/json": components["schemas"]["TerminalErrorResponse"];
         };
       };
-      /** @description Task service is not configured */
+      /** @description Terminal service unavailable */
       503: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["ErrorPayload"];
+          "application/json": components["schemas"]["TerminalErrorResponse"];
         };
       };
     };
   };
-  markTaskRead: {
+  streamTerminalsAggregate: {
     parameters: {
       query?: {
+        /** @description Read all projects and User rows */
+        all_workspaces?: boolean;
+        /** @description Repeatable project IDs or @user; requires all_workspaces=true */
+        workspace_ids?: string[];
         /** @description Act as this profile by name */
         profile?: string;
       };
-      header?: never;
-      path: {
-        /** @description Task id */
-        id: string;
+      header?: {
+        /** @description Resume after the last terminal catalog event */
+        "Last-Event-ID"?: string;
       };
+      path?: never;
       cookie?: never;
     };
     requestBody?: never;
     responses: {
-      /** @description OK */
+      /** @description Terminal catalog event stream */
       200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["TaskTriageStateResponse"];
+          "text/event-stream": components["schemas"]["TerminalCatalogSnapshot"];
         };
       };
-      /** @description Task not found */
-      404: {
+      /** @description Malformed terminal request */
+      400: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["ErrorPayload"];
+          "application/json": components["schemas"]["TerminalErrorResponse"];
         };
       };
-      /** @description Invalid task triage request */
+      /** @description Terminal authentication required */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["TerminalErrorResponse"];
+        };
+      };
+      /** @description Terminal operation forbidden */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["TerminalErrorResponse"];
+        };
+      };
+      /** @description Terminal state or profile conflict */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["TerminalErrorResponse"];
+        };
+      };
+      /** @description Invalid terminal catalog cursor */
       422: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["ErrorPayload"];
+          "application/json": components["schemas"]["TerminalErrorResponse"];
         };
       };
-      /** @description Internal server error */
+      /** @description Terminal transport failed */
       500: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["ErrorPayload"];
+          "application/json": components["schemas"]["TerminalErrorResponse"];
         };
       };
-      /** @description Task service is not configured */
+      /** @description Terminal catalog unavailable */
       503: {
         headers: {
           [name: string]: unknown;
         };
         content: {
-          "application/json": components["schemas"]["ErrorPayload"];
+          "application/json": components["schemas"]["TerminalErrorResponse"];
         };
       };
     };
@@ -43872,6 +45610,8 @@ export interface operations {
   listWorkspaceSessions: {
     parameters: {
       query?: {
+        /** @description Project IDs or @user; repeatable, requires all_workspaces */
+        workspace_ids?: string[];
         /** @description Include metadata-only health for returned sessions */
         include_health?: boolean;
         /** @description Omit the exact catalog count for a bounded cursor read */
@@ -44208,6 +45948,8 @@ export interface operations {
   archiveSession: {
     parameters: {
       query?: {
+        /** @description Stop a live session through the normal stop path before archiving it; a failed stop leaves it unarchived */
+        stop?: boolean;
         /** @description Act as this profile by name */
         profile?: string;
       };
@@ -44231,6 +45973,15 @@ export interface operations {
           "application/json": components["schemas"]["SessionResponse"];
         };
       };
+      /** @description Invalid archive request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
       /** @description Session not found */
       404: {
         headers: {
@@ -44240,7 +45991,7 @@ export interface operations {
           "application/json": components["schemas"]["ErrorPayload"];
         };
       };
-      /** @description Session must be stopped before archiving */
+      /** @description Session must be stopped before archiving, or the requested stop failed */
       409: {
         headers: {
           [name: string]: unknown;
@@ -45642,6 +47393,112 @@ export interface operations {
       };
     };
   };
+  listSessionMonitors: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /** @description Workspace id */
+        workspace_id: string;
+        /** @description Session id */
+        session_id: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Success */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["SessionMonitorsResponse"];
+        };
+      };
+      /** @description Session or monitor not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Session monitors unavailable */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
+  cancelSessionMonitor: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /** @description Workspace id */
+        workspace_id: string;
+        /** @description Session id */
+        session_id: string;
+        /** @description Monitor id */
+        monitor_id: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Success */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["SessionMonitorResponse"];
+        };
+      };
+      /** @description Session or monitor not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Session monitors unavailable */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
   moveSession: {
     parameters: {
       query?: {
@@ -45720,6 +47577,157 @@ export interface operations {
       };
     };
   };
+  setSessionParent: {
+    parameters: {
+      query?: {
+        /** @description Act as this profile by name */
+        profile?: string;
+      };
+      header?: never;
+      path: {
+        /** @description Workspace id */
+        workspace_id: string;
+        /** @description Session id */
+        session_id: string;
+      };
+      cookie?: never;
+    };
+    /** @description JSON request body */
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["SetSessionParentRequest"];
+      };
+    };
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["SessionResponse"];
+        };
+      };
+      /** @description Invalid reparent request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Session not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Reparent refused by a lineage rule; code names the rule */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Session reparent unavailable */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
+  clearSessionParent: {
+    parameters: {
+      query?: {
+        /** @description Act as this profile by name */
+        profile?: string;
+      };
+      header?: never;
+      path: {
+        /** @description Workspace id */
+        workspace_id: string;
+        /** @description Session id */
+        session_id: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["SessionResponse"];
+        };
+      };
+      /** @description Invalid reparent request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Session not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Reparent refused by a lineage rule; code names the rule */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Session reparent unavailable */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
   updateSessionPresence: {
     parameters: {
       query?: never;
@@ -49744,6 +51752,15 @@ export interface operations {
           "application/json": components["schemas"]["ContractWindowManagerClientView"];
         };
       };
+      /** @description Invalid window workspace binding */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ContractWindowManagerErrorPayload"];
+        };
+      };
       /** @description Workspace or referenced entity not found */
       404: {
         headers: {
@@ -49806,6 +51823,15 @@ export interface operations {
         };
         content?: never;
       };
+      /** @description Invalid window workspace binding */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ContractWindowManagerErrorPayload"];
+        };
+      };
       /** @description Workspace or referenced entity not found */
       404: {
         headers: {
@@ -49873,6 +51899,15 @@ export interface operations {
           "application/json": components["schemas"]["ContractWindowManagerResult"];
         };
       };
+      /** @description Invalid window workspace binding */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ContractWindowManagerErrorPayload"];
+        };
+      };
       /** @description Workspace or referenced entity not found */
       404: {
         headers: {
@@ -49984,6 +52019,15 @@ export interface operations {
           "application/json": components["schemas"]["ContractWindowManagerResult"];
         };
       };
+      /** @description Invalid window workspace binding */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ContractWindowManagerErrorPayload"];
+        };
+      };
       /** @description Workspace or referenced entity not found */
       404: {
         headers: {
@@ -50342,6 +52386,15 @@ export interface operations {
           "application/json": components["schemas"]["ContractWindowManagerLayoutValidationResponse"];
         };
       };
+      /** @description Invalid window workspace binding */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ContractWindowManagerErrorPayload"];
+        };
+      };
       /** @description Workspace or referenced entity not found */
       404: {
         headers: {
@@ -50409,6 +52462,15 @@ export interface operations {
           "application/json": components["schemas"]["ContractWindowManagerPreview"];
         };
       };
+      /** @description Invalid window workspace binding */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ContractWindowManagerErrorPayload"];
+        };
+      };
       /** @description Workspace or referenced entity not found */
       404: {
         headers: {
@@ -50768,6 +52830,89 @@ export interface operations {
       };
     };
   };
+  removeDiscoveredWorktree: {
+    parameters: {
+      query?: {
+        /** @description Act as this profile by name */
+        profile?: string;
+      };
+      header?: never;
+      path: {
+        /** @description Workspace id or path */
+        workspace_id: string;
+      };
+      cookie?: never;
+    };
+    /** @description JSON request body */
+    requestBody: {
+      content: {
+        "application/json": components["schemas"]["RemoveDiscoveredWorktreeRequest"];
+      };
+    };
+    responses: {
+      /** @description No Content */
+      204: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Invalid discovered removal request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Hook or profile does not permit removal */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Discovered worktree or workspace not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Removal requires another decision */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["WorktreeRemovalRefusalPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Worktree service is unavailable */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
   inspectWorktree: {
     parameters: {
       query?: never;
@@ -51484,6 +53629,67 @@ export interface operations {
       };
     };
   };
+  listWorktreesAggregate: {
+    parameters: {
+      query?: {
+        /** @description Read all projects and User rows */
+        all_workspaces?: boolean;
+        /** @description Repeatable project IDs or @user; requires all_workspaces=true */
+        workspace_ids?: string[];
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["WorktreesResponse"];
+        };
+      };
+      /** @description Invalid worktree list query */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Workspace not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Internal server error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+      /** @description Worktree service is unavailable */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": components["schemas"]["ErrorPayload"];
+        };
+      };
+    };
+  };
   streamWorktreeCatalog: {
     parameters: {
       query?: never;