@parall/sdk 1.55.5 → 1.56.0

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.
package/dist/types.d.ts CHANGED
@@ -270,10 +270,18 @@ export interface Message {
270
270
  recent_repliers?: User[];
271
271
  /**
272
272
  * Per-viewer count of thread replies newer than the viewer's thread read
273
- * cursor, excluding the viewer's own replies (root only). Populated on
274
- * top-level list responses; omitted when zero.
273
+ * cursor, excluding the viewer's own replies (root only). Watcher-scoped:
274
+ * only threads the viewer watches accrue unread. Populated on top-level
275
+ * list responses; omitted when zero.
275
276
  */
276
277
  unread_reply_count?: number;
278
+ /**
279
+ * Per-viewer thread watch state (root only): true when the viewer watches
280
+ * this root's thread. Populated on top-level list responses for roots with
281
+ * replies; omitted means not watching. Seeds the client's live unread
282
+ * mirror.
283
+ */
284
+ watching?: boolean;
277
285
  edited_at: string | null;
278
286
  deleted_at: string | null;
279
287
  created_at: string;
@@ -1388,6 +1396,19 @@ export interface CreateTaskRequest {
1388
1396
  due_date?: string;
1389
1397
  label_ids?: string[];
1390
1398
  }
1399
+ /**
1400
+ * Moves a task (and its whole subtree) into another project via
1401
+ * POST /tasks/{taskId}/move — the only path that changes the binding; PATCH
1402
+ * keeps refusing project_id changes. Every subtree node is renumbered from the
1403
+ * target project's counter and its old KEY-N identifier stays resolvable as a
1404
+ * permanent alias. parent_id (must belong to the target project) attaches the
1405
+ * moved root under a parent there; same-project calls with a parent degrade to
1406
+ * a reparent, without one they are an idempotent no-op.
1407
+ */
1408
+ export interface MoveTaskRequest {
1409
+ project_id: string;
1410
+ parent_id?: string;
1411
+ }
1391
1412
  export interface UpdateTaskRequest {
1392
1413
  title?: string;
1393
1414
  description?: string;
@@ -1916,10 +1937,18 @@ export interface Wiki {
1916
1937
  * access_tier are populated — enough to request to join, nothing else.
1917
1938
  * Degraded entries must not be mounted, synced or treated as content. */
1918
1939
  degraded?: boolean;
1940
+ /** Caller's library-level star (the sidebar Starred group). Carried on full
1941
+ * list/get projections only — degraded entries never have it. */
1942
+ starred?: boolean;
1919
1943
  }
1920
1944
  export interface WikiFileChange {
1921
1945
  path: string;
1922
- action: 'create' | 'update' | 'delete';
1946
+ action: 'create' | 'update' | 'delete' | 'rename';
1947
+ /**
1948
+ * Rename source; present only when action is "rename" (path is the rename
1949
+ * target). Additive key — older changesets never carry it.
1950
+ */
1951
+ from_path?: string;
1923
1952
  }
1924
1953
  export interface WikiChangeset {
1925
1954
  id: string;
@@ -2106,6 +2135,8 @@ export interface WikiRefsCheckResponse {
2106
2135
  export interface WikiDiffFile {
2107
2136
  path: string;
2108
2137
  action?: string;
2138
+ /** Rename source when action is "rename" (path is the target). */
2139
+ from_path?: string;
2109
2140
  additions: number;
2110
2141
  deletions: number;
2111
2142
  }
@@ -2118,19 +2149,40 @@ export interface CreateWikiRequest {
2118
2149
  name: string;
2119
2150
  default_branch?: string;
2120
2151
  }
2121
- export interface WikiFileChangeInput {
2152
+ interface WikiFileChangeInputCommon {
2122
2153
  path: string;
2123
- action: 'create' | 'update' | 'delete';
2124
- content_base64?: string;
2125
2154
  base_version?: number;
2126
2155
  /**
2127
2156
  * Git blob SHA of the default-branch version this change was authored
2128
2157
  * against. When set on update/delete, the server rejects the changeset
2129
2158
  * with 409 STALE_BASE if the file has since changed on the default branch
2130
- * (prevents silently overwriting concurrent edits).
2159
+ * (prevents silently overwriting concurrent edits). For rename it guards
2160
+ * the from_path side.
2131
2161
  */
2132
2162
  base_sha?: string;
2133
2163
  }
2164
+ export interface WikiFileChangeWriteInput extends WikiFileChangeInputCommon {
2165
+ action: 'create' | 'update' | 'delete';
2166
+ content_base64?: string;
2167
+ /** Only valid with action "rename" — the server rejects it elsewhere. */
2168
+ from_path?: never;
2169
+ }
2170
+ /**
2171
+ * Rename is a discriminated variant: `from_path` (the source; `path` is the
2172
+ * target) and `content_base64` are both REQUIRED. The content must be sent —
2173
+ * the server rejects a rename without the content_base64 key
2174
+ * (400 MISSING_FIELDS) because the single-commit move always writes content
2175
+ * and an omitted key would otherwise erase the file; an explicitly empty
2176
+ * string (an empty file) is legal. Requires the server capability
2177
+ * `cap:wiki-rename` — while it is off the server answers 422 RENAME_DISABLED
2178
+ * (older servers answer 400 INVALID_ACTION).
2179
+ */
2180
+ export interface WikiFileChangeRenameInput extends WikiFileChangeInputCommon {
2181
+ action: 'rename';
2182
+ from_path: string;
2183
+ content_base64: string;
2184
+ }
2185
+ export type WikiFileChangeInput = WikiFileChangeWriteInput | WikiFileChangeRenameInput;
2134
2186
  export interface CreateWikiChangesetRequest {
2135
2187
  title: string;
2136
2188
  message?: string;
@@ -4525,6 +4577,61 @@ export interface BrowserAliasExecutionReceipt {
4525
4577
  terminal_at?: string;
4526
4578
  updated_at: string;
4527
4579
  }
4580
+ export type BrowserUseAction = 'read' | 'tabs' | 'wait' | 'snapshot' | 'get' | 'screenshot' | 'open' | 'navigate' | 'viewport' | 'click' | 'fill' | 'type' | 'press' | 'scroll' | 'close' | 'recover' | 'eval';
4581
+ export interface BrowserUseTarget {
4582
+ tab_id?: string;
4583
+ browser_generation?: number;
4584
+ document_generation?: number;
4585
+ snapshot_id?: string;
4586
+ ref?: string;
4587
+ }
4588
+ export interface BrowserUseOperationRequest {
4589
+ contract_version: 'browser-use-operation-v1';
4590
+ request_id: string;
4591
+ profile_id: string;
4592
+ action: BrowserUseAction;
4593
+ target?: BrowserUseTarget;
4594
+ params: Record<string, unknown>;
4595
+ /** Canonical RFC3339 UTC instant, no more than two minutes in the future. */
4596
+ deadline: string;
4597
+ }
4598
+ export type BrowserUseOperationPhase = 'accepted' | 'started' | 'succeeded' | 'failed' | 'outcome_unknown';
4599
+ export interface BrowserUseOperationError {
4600
+ code: string;
4601
+ message?: string;
4602
+ hint?: string;
4603
+ }
4604
+ /** Durable Browser Use proof. `data` is encrypted/transient: it is present
4605
+ * only while result_available is true and disappears after result_expires_at;
4606
+ * the terminal receipt and result_digest remain durable. */
4607
+ export interface BrowserUseOperationReceipt {
4608
+ contract_version: 'browser-use-operation-v1';
4609
+ operation_id: string;
4610
+ request_id: string;
4611
+ profile_id: string;
4612
+ profile_version: number;
4613
+ profile_config_revision: number;
4614
+ action: BrowserUseAction;
4615
+ required_grant: 'browser.read' | 'browser.interact' | 'browser.advanced';
4616
+ phase: BrowserUseOperationPhase;
4617
+ dispatched?: boolean;
4618
+ receipt_id?: string;
4619
+ receipt_digest?: string;
4620
+ occurred_at?: string;
4621
+ tab_id?: string;
4622
+ browser_generation?: number;
4623
+ duration_ms?: number;
4624
+ result_digest?: string;
4625
+ result_available: boolean;
4626
+ result_expires_at?: string;
4627
+ data?: unknown;
4628
+ error?: BrowserUseOperationError;
4629
+ deadline: string;
4630
+ accepted_at: string;
4631
+ started_at?: string;
4632
+ terminal_at?: string;
4633
+ updated_at: string;
4634
+ }
4528
4635
  /**
4529
4636
  * Sanitized per-profile egress proxy status (hosted Cloud Profiles) — the GET
4530
4637
  * response and the PUT/DELETE result. NEVER carries the password; `password_set`