@compozy/client 0.4.4 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -80,6 +80,7 @@ export type AgentCatalogItemPayload = {
80
80
  };
81
81
  export type AgentCatalogResponse = {
82
82
  agents: Array<AgentCatalogItemPayload>;
83
+ diagnostics?: Array<DiagnosticItem>;
83
84
  facets: AgentCatalogFacetsPayload;
84
85
  page: CountedCursorPagePayload;
85
86
  sessions_available: boolean;
@@ -610,6 +611,10 @@ export type AutonomyMatcher = {
610
611
  task_id?: string;
611
612
  workflow_id?: string;
612
613
  };
614
+ export type BindSessionWorktreeRequest = {
615
+ expected_worktree_id?: string | null;
616
+ worktree: string;
617
+ };
613
618
  export type BindingsConfig = {
614
619
  bottom_center: string;
615
620
  top_center: string;
@@ -1419,6 +1424,7 @@ export type Entry = {
1419
1424
  start_sequence: number;
1420
1425
  };
1421
1426
  export type ErrorPayload = {
1427
+ blockers?: Array<WorkspaceArchiveBlocker>;
1422
1428
  code?: string;
1423
1429
  config_path?: string;
1424
1430
  current_turn_id?: string;
@@ -1968,12 +1974,13 @@ export type GoalBlockingIssue = {
1968
1974
  note: string;
1969
1975
  };
1970
1976
  export type GoalCommandResult = {
1971
- outcome: "started" | "replaced" | "status" | "paused" | "resumed" | "cleared" | "error";
1977
+ outcome: "started" | "replaced" | "status" | "paused" | "resumed" | "cleared" | "stopped" | "error";
1972
1978
  reason_code: "goal_not_active" | "goal_replace_required" | "goal_replace_stale" | "goal_objective_required" | "goal_objective_too_large" | "goal_contract_clause_empty" | "goal_command_invalid" | "goal_draft_requires_idle" | "goal_evidence_too_large" | "goal_report_conflict" | "goal_session_busy_queue_full" | "goal_turn_filter_invalid" | "goal_judge_unavailable" | "goal_judge_broken" | "goal_judge_outcome_invalid" | "goal_action_control_invalid" | "goal_stop_reason_invalid" | "goal_prompt_request_failed" | "goal_agent_refused" | "goal_compaction_cancelled" | "goal_recovery_ambiguous" | "goal_control_revoked_in_flight" | "goal_reseed_confirmation_required" | "goal_presubmit_retries_exhausted" | "goal_budget_fenced" | "goal_origin_invalid" | "goal_origin_workspace_mismatch" | "goal_origin_profile_unavailable" | "goal_control_stale" | "goal_prompt_fenced" | "session_creation_identity_mismatch" | "continuous_binding_mismatch" | "goal_runtime_invalid" | "goal_caller_unauthorized";
1973
1979
  replaced_run_id: string | null;
1974
1980
  snapshot: GoalSnapshot | null;
1975
1981
  };
1976
1982
  export type GoalContextSnapshot = {
1983
+ diagnostic?: string;
1977
1984
  nudge_ratio: number;
1978
1985
  ratio: number | null;
1979
1986
  reported_at: string | null;
@@ -2020,6 +2027,7 @@ export type GoalSnapshot = {
2020
2027
  node_id: string;
2021
2028
  objective: string;
2022
2029
  origin_session_id: string;
2030
+ pause_requested?: boolean;
2023
2031
  run_id: string;
2024
2032
  run_status: "queued" | "running" | "watching" | "needs-approval" | "paused" | "done" | "no-op" | "blocked" | "failed" | "exhausted" | "stalled" | "canceled";
2025
2033
  status: "active" | "paused" | "blocked" | "usage-limited" | "budget-limited" | "complete";
@@ -5234,6 +5242,7 @@ export type SessionDeriveCutPayload = {
5234
5242
  turn_settled: boolean;
5235
5243
  };
5236
5244
  export type SessionDeriveErrorPayload = {
5245
+ blockers?: Array<WorkspaceArchiveBlocker>;
5237
5246
  child_session_id?: string;
5238
5247
  code?: string;
5239
5248
  config_path?: string;
@@ -5367,7 +5376,7 @@ export type SessionFoldersResponse = {
5367
5376
  export type SessionGoalCommandRequest = {
5368
5377
  expected_run_id?: string;
5369
5378
  objective?: string;
5370
- operation: "set" | "replace" | "status" | "pause" | "resume" | "clear";
5379
+ operation: "set" | "replace" | "status" | "pause" | "resume" | "stop" | "clear";
5371
5380
  runtime?: PromptRuntimeSelectionPayload | null;
5372
5381
  };
5373
5382
  export type SessionGoalResponse = {
@@ -5511,6 +5520,7 @@ export type SessionPayload = {
5511
5520
  children?: SessionChildrenPayload | null;
5512
5521
  created_at: string;
5513
5522
  derivation?: SessionDerivationPayload | null;
5523
+ diagnostics?: Array<DiagnosticItem>;
5514
5524
  effective_workspace_access: string;
5515
5525
  escalated?: boolean | null;
5516
5526
  failure?: SessionFailurePayload | null;
@@ -5547,6 +5557,7 @@ export type SessionPayload = {
5547
5557
  waiting_on?: "sessions" | "monitor";
5548
5558
  workspace_id?: string;
5549
5559
  workspace_path?: string;
5560
+ worktree_binding?: WorktreeBindingAvailability | null;
5550
5561
  worktree_id?: string;
5551
5562
  };
5552
5563
  export type SessionPresenceRequest = {
@@ -5583,6 +5594,7 @@ export type SessionPullRequestChecksPayload = {
5583
5594
  state: "passing" | "failing" | "pending" | "none" | "unknown";
5584
5595
  };
5585
5596
  export type SessionPullRequestErrorPayload = {
5597
+ blockers?: Array<WorkspaceArchiveBlocker>;
5586
5598
  cause?: string;
5587
5599
  code?: string;
5588
5600
  config_path?: string;
@@ -5695,6 +5707,7 @@ export type SessionStatusResponse = {
5695
5707
  attention?: string;
5696
5708
  badge: "running" | "idle" | "unhealthy" | "hung" | "waiting-for-auth" | "waiting-for-input" | "done" | "stopped" | "failed" | "unknown" | "needs-attention" | "waiting";
5697
5709
  derivation?: SessionDerivationPayload | null;
5710
+ diagnostics?: Array<DiagnosticItem>;
5698
5711
  eligible_for_wake: boolean;
5699
5712
  escalated?: boolean | null;
5700
5713
  health: "healthy" | "degraded" | "stale" | "dead" | "unknown";
@@ -7653,6 +7666,7 @@ export type TaskPayload = {
7653
7666
  workspace_id?: string;
7654
7667
  };
7655
7668
  export type TaskQueryErrorPayload = {
7669
+ blockers?: Array<WorkspaceArchiveBlocker>;
7656
7670
  code?: string;
7657
7671
  config_path?: string;
7658
7672
  current_turn_id?: string;
@@ -8320,7 +8334,7 @@ export type ToolCallEventPayload = {
8320
8334
  destructive: boolean;
8321
8335
  display_title?: string;
8322
8336
  duration_ms?: number;
8323
- error_code?: "approval_rejected" | "compaction_unsupported" | "generation_fenced" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "message_hop_limit" | "message_rate_limited" | "model_not_found" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "reasoning_effort_unsupported" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "session_archive_stop_failed" | "session_busy" | "slow_consumer" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_approval_required" | "tool_backend_failed" | "tool_canceled" | "tool_conflict" | "tool_denied" | "tool_invalid_input" | "tool_not_found" | "tool_result_persistence_failed" | "tool_result_too_large" | "tool_timed_out" | "tool_unavailable";
8337
+ error_code?: "approval_rejected" | "compaction_unsupported" | "generation_fenced" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "message_hop_limit" | "message_rate_limited" | "model_not_found" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "reasoning_effort_unsupported" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "session_archive_stop_failed" | "session_busy" | "session_worktree_conflict" | "slow_consumer" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_approval_required" | "tool_backend_failed" | "tool_canceled" | "tool_conflict" | "tool_denied" | "tool_invalid_input" | "tool_not_found" | "tool_result_persistence_failed" | "tool_result_too_large" | "tool_timed_out" | "tool_unavailable" | "workspace_archived" | "workspace_busy" | "workspace_root_missing" | "worktree_missing" | "worktree_not_found" | "worktree_not_ready" | "worktree_operation_in_progress" | "worktree_session_active";
8324
8338
  input_digest?: string;
8325
8339
  kind: "tool.call_started" | "tool.call_completed" | "tool.call_failed" | "tool.call_denied" | "tool.result_truncated";
8326
8340
  open_world: boolean;
@@ -8372,7 +8386,7 @@ export type ToolDescriptorPayload = {
8372
8386
  visibility: "internal" | "operator" | "session" | "model";
8373
8387
  };
8374
8388
  export type ToolErrorPayload = {
8375
- code: "approval_rejected" | "compaction_unsupported" | "generation_fenced" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "message_hop_limit" | "message_rate_limited" | "model_not_found" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "reasoning_effort_unsupported" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "session_archive_stop_failed" | "session_busy" | "slow_consumer" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_approval_required" | "tool_backend_failed" | "tool_canceled" | "tool_conflict" | "tool_denied" | "tool_invalid_input" | "tool_not_found" | "tool_result_persistence_failed" | "tool_result_too_large" | "tool_timed_out" | "tool_unavailable";
8389
+ code: "approval_rejected" | "compaction_unsupported" | "generation_fenced" | "input_request_already_answered" | "input_request_limit_reached" | "input_request_not_found" | "input_request_requires_hidden_input" | "input_request_superseded" | "invalid_cwd" | "journal_unavailable" | "message_hop_limit" | "message_rate_limited" | "model_not_found" | "profile_archived" | "profile_selection_conflict" | "profile_session_conflict" | "profile_unavailable" | "reasoning_effort_unsupported" | "recording_already_started" | "recording_not_active" | "recording_unavailable" | "session_archive_stop_failed" | "session_busy" | "session_worktree_conflict" | "slow_consumer" | "subscriber_limit_reached" | "terminal_exited" | "terminal_expired" | "terminal_interactive_unavailable" | "terminal_limit_reached" | "terminal_not_found" | "terminal_not_interactive" | "terminal_requires_workspace" | "ticket_expired" | "ticket_invalid" | "timeout_out_of_range" | "tool_approval_required" | "tool_backend_failed" | "tool_canceled" | "tool_conflict" | "tool_denied" | "tool_invalid_input" | "tool_not_found" | "tool_result_persistence_failed" | "tool_result_too_large" | "tool_timed_out" | "tool_unavailable" | "workspace_archived" | "workspace_busy" | "workspace_root_missing" | "worktree_missing" | "worktree_not_found" | "worktree_not_ready" | "worktree_operation_in_progress" | "worktree_session_active";
8376
8390
  details?: {
8377
8391
  [key: string]: unknown;
8378
8392
  };
@@ -8919,6 +8933,11 @@ export type WorkerProfile = {
8919
8933
  required_capabilities?: Array<string>;
8920
8934
  speed?: "normal" | "fast";
8921
8935
  };
8936
+ export type WorkspaceArchiveBlocker = {
8937
+ id: string;
8938
+ kind: string;
8939
+ name: string;
8940
+ };
8922
8941
  export type WorkspaceAttentionSummaryPayload = {
8923
8942
  finished: number;
8924
8943
  needs_you: number;
@@ -8955,11 +8974,13 @@ export type WorkspaceDetailPayload = {
8955
8974
  };
8956
8975
  export type WorkspacePayload = {
8957
8976
  add_dirs: Array<string>;
8977
+ archived_at?: string | null;
8958
8978
  created_at: string;
8959
8979
  default_agent?: string;
8960
8980
  id: string;
8961
8981
  name: string;
8962
8982
  root_dir: string;
8983
+ root_missing?: boolean;
8963
8984
  updated_at: string;
8964
8985
  };
8965
8986
  export type WorkspaceProfileHintPayload = {
@@ -8979,6 +9000,10 @@ export type WorkspaceSkillPayload = {
8979
9000
  export type WorkspacesResponse = {
8980
9001
  workspaces: Array<WorkspacePayload>;
8981
9002
  };
9003
+ export type WorktreeBindingAvailability = {
9004
+ available: boolean;
9005
+ unavailable_reason?: string;
9006
+ };
8982
9007
  export type WorktreeBindingsPayload = {
8983
9008
  agent_activity: string;
8984
9009
  };
@@ -23808,7 +23833,12 @@ export type DeliverWorkspaceWebhookResponse = DeliverWorkspaceWebhookResponses[k
23808
23833
  export type ListWorkspacesData = {
23809
23834
  body?: never;
23810
23835
  path?: never;
23811
- query?: never;
23836
+ query?: {
23837
+ /**
23838
+ * List archived projects instead of active projects
23839
+ */
23840
+ archived?: boolean;
23841
+ };
23812
23842
  url: "/api/workspaces";
23813
23843
  };
23814
23844
  export type ListWorkspacesErrors = {
@@ -23993,6 +24023,72 @@ export type UpdateWorkspaceResponses = {
23993
24023
  200: WorkspaceResponse;
23994
24024
  };
23995
24025
  export type UpdateWorkspaceResponse = UpdateWorkspaceResponses[keyof UpdateWorkspaceResponses];
24026
+ export type ArchiveWorkspaceData = {
24027
+ body?: never;
24028
+ path: {
24029
+ /**
24030
+ * Workspace name or id
24031
+ */
24032
+ id: string;
24033
+ };
24034
+ query?: never;
24035
+ url: "/api/workspaces/{id}/archive";
24036
+ };
24037
+ export type ArchiveWorkspaceErrors = {
24038
+ /**
24039
+ * Workspace not found
24040
+ */
24041
+ 404: ErrorPayload;
24042
+ /**
24043
+ * Workspace has active sessions, live Loops or enabled automations
24044
+ */
24045
+ 409: ErrorPayload;
24046
+ /**
24047
+ * Internal server error
24048
+ */
24049
+ 500: ErrorPayload;
24050
+ };
24051
+ export type ArchiveWorkspaceError = ArchiveWorkspaceErrors[keyof ArchiveWorkspaceErrors];
24052
+ export type ArchiveWorkspaceResponses = {
24053
+ /**
24054
+ * OK
24055
+ */
24056
+ 200: WorkspaceResponse;
24057
+ };
24058
+ export type ArchiveWorkspaceResponse = ArchiveWorkspaceResponses[keyof ArchiveWorkspaceResponses];
24059
+ export type UnarchiveWorkspaceData = {
24060
+ body?: never;
24061
+ path: {
24062
+ /**
24063
+ * Workspace name or id
24064
+ */
24065
+ id: string;
24066
+ };
24067
+ query?: never;
24068
+ url: "/api/workspaces/{id}/unarchive";
24069
+ };
24070
+ export type UnarchiveWorkspaceErrors = {
24071
+ /**
24072
+ * Workspace not found
24073
+ */
24074
+ 404: ErrorPayload;
24075
+ /**
24076
+ * Workspace has active sessions, live Loops or enabled automations
24077
+ */
24078
+ 409: ErrorPayload;
24079
+ /**
24080
+ * Internal server error
24081
+ */
24082
+ 500: ErrorPayload;
24083
+ };
24084
+ export type UnarchiveWorkspaceError = UnarchiveWorkspaceErrors[keyof UnarchiveWorkspaceErrors];
24085
+ export type UnarchiveWorkspaceResponses = {
24086
+ /**
24087
+ * OK
24088
+ */
24089
+ 200: WorkspaceResponse;
24090
+ };
24091
+ export type UnarchiveWorkspaceResponse = UnarchiveWorkspaceResponses[keyof UnarchiveWorkspaceResponses];
23996
24092
  export type ListAutomationSuggestionsData = {
23997
24093
  body?: never;
23998
24094
  path: {
@@ -29437,6 +29533,113 @@ export type WaitForSessionResponses = {
29437
29533
  200: SessionWaitResponse;
29438
29534
  };
29439
29535
  export type WaitForSessionResponse = WaitForSessionResponses[keyof WaitForSessionResponses];
29536
+ export type UnbindSessionWorktreeData = {
29537
+ body?: never;
29538
+ path: {
29539
+ /**
29540
+ * Workspace id
29541
+ */
29542
+ workspace_id: string;
29543
+ /**
29544
+ * Session id
29545
+ */
29546
+ session_id: string;
29547
+ };
29548
+ query?: {
29549
+ /**
29550
+ * Act as this profile by name
29551
+ */
29552
+ profile?: string;
29553
+ /**
29554
+ * Expected current worktree id; empty for workspace root
29555
+ */
29556
+ expected_worktree_id?: string;
29557
+ };
29558
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/worktree";
29559
+ };
29560
+ export type UnbindSessionWorktreeErrors = {
29561
+ /**
29562
+ * Invalid binding request
29563
+ */
29564
+ 400: ErrorPayload;
29565
+ /**
29566
+ * Session or worktree not found
29567
+ */
29568
+ 404: ErrorPayload;
29569
+ /**
29570
+ * Session busy, stale binding or unavailable worktree
29571
+ */
29572
+ 409: ErrorPayload;
29573
+ /**
29574
+ * Internal server error
29575
+ */
29576
+ 500: ErrorPayload;
29577
+ /**
29578
+ * Binding unavailable
29579
+ */
29580
+ 503: ErrorPayload;
29581
+ };
29582
+ export type UnbindSessionWorktreeError = UnbindSessionWorktreeErrors[keyof UnbindSessionWorktreeErrors];
29583
+ export type UnbindSessionWorktreeResponses = {
29584
+ /**
29585
+ * Same session with updated execution location
29586
+ */
29587
+ 200: SessionResponse;
29588
+ };
29589
+ export type UnbindSessionWorktreeResponse = UnbindSessionWorktreeResponses[keyof UnbindSessionWorktreeResponses];
29590
+ export type BindSessionWorktreeData = {
29591
+ /**
29592
+ * JSON request body
29593
+ */
29594
+ body: BindSessionWorktreeRequest;
29595
+ path: {
29596
+ /**
29597
+ * Workspace id
29598
+ */
29599
+ workspace_id: string;
29600
+ /**
29601
+ * Session id
29602
+ */
29603
+ session_id: string;
29604
+ };
29605
+ query?: {
29606
+ /**
29607
+ * Act as this profile by name
29608
+ */
29609
+ profile?: string;
29610
+ };
29611
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/worktree";
29612
+ };
29613
+ export type BindSessionWorktreeErrors = {
29614
+ /**
29615
+ * Invalid binding request
29616
+ */
29617
+ 400: ErrorPayload;
29618
+ /**
29619
+ * Session or worktree not found
29620
+ */
29621
+ 404: ErrorPayload;
29622
+ /**
29623
+ * Session busy, stale binding or unavailable worktree
29624
+ */
29625
+ 409: ErrorPayload;
29626
+ /**
29627
+ * Internal server error
29628
+ */
29629
+ 500: ErrorPayload;
29630
+ /**
29631
+ * Binding unavailable
29632
+ */
29633
+ 503: ErrorPayload;
29634
+ };
29635
+ export type BindSessionWorktreeError = BindSessionWorktreeErrors[keyof BindSessionWorktreeErrors];
29636
+ export type BindSessionWorktreeResponses = {
29637
+ /**
29638
+ * Same session with updated execution location
29639
+ */
29640
+ 200: SessionResponse;
29641
+ };
29642
+ export type BindSessionWorktreeResponse = BindSessionWorktreeResponses[keyof BindSessionWorktreeResponses];
29440
29643
  export type ForkSessionToWorktreeData = {
29441
29644
  /**
29442
29645
  * JSON request body
@@ -29655,6 +29858,10 @@ export type CreateTerminalData = {
29655
29858
  * Registered browser client attachment token
29656
29859
  */
29657
29860
  "X-Compozy-Client-Token"?: string;
29861
+ /**
29862
+ * Browser client registration partition (project id, global, or user); defaults to the terminal workspace
29863
+ */
29864
+ "X-Compozy-Client-Workspace"?: string;
29658
29865
  };
29659
29866
  path: {
29660
29867
  /**
@@ -30166,6 +30373,10 @@ export type MintTerminalAttachTicketData = {
30166
30373
  * Registered browser client attachment token
30167
30374
  */
30168
30375
  "X-Compozy-Client-Token"?: string;
30376
+ /**
30377
+ * Browser client registration partition (project id, global, or user); defaults to the terminal workspace
30378
+ */
30379
+ "X-Compozy-Client-Workspace"?: string;
30169
30380
  };
30170
30381
  path: {
30171
30382
  /**