@parall/sdk 1.50.0 → 1.51.0

package/src/types.ts

@@ -408,6 +408,8 @@ export interface Organization {
   /** Agent ID for strategy='agent'. NULL when strategy is 'llm' or unset. */
   smart_routing_agent_id: string | null;
   onboarding_agent_id: string | null;
+  /** Org-level IANA timezone (e.g. "America/New_York"). Defaults to "UTC". */
+  timezone: string;
   created_at: string;
   /** Per-member flag: true when the user has dismissed the onboarding popup for this org. */
   onboarding_dismissed: boolean;
@@ -746,6 +748,46 @@ export interface DeployTemplateRequest {
   template_id: string;
   template_revision: string;
   parameter_values?: Record<string, TemplateParameterValue>;
+  /** Hire-time per-agent adjustments (onboarding wizard S2). Keys are the
+   *  template's agent keys; omitted agents keep template defaults. */
+  agent_overrides?: Record<string, DeployAgentOverride>;
+}
+
+/** Per-agent hire-time override. Substitutes values within the platform-legal
+ *  surface; never adds capability. Dependencies may only disable (false)
+ *  declared optional deps — required deps and undeclared refs are rejected. */
+export interface DeployAgentOverride {
+  runtime_type?: string;
+  /** Model catalog id. Empty string clears the template's pin (platform default). */
+  model?: string;
+  compute?: { machine_type: 'cloud'; machine_label?: string };
+  dependencies?: Record<string, boolean>;
+}
+
+/** Pre-deploy dependency connection state (wizard S3 poll target). Same
+ *  checker as the deployment report, so the two surfaces cannot disagree. */
+export interface DependencyCheckResult {
+  ref: string;
+  connected: boolean;
+  name?: string;
+}
+
+/** Onboarding wizard progress (self-scoped). A member who never started
+ *  reads step='s1', state={}, version=0 (missing-row semantics). */
+export interface OnboardingProgress {
+  step: string;
+  state: Record<string, unknown>;
+  completed_at?: string;
+  version: number;
+}
+
+export interface UpdateOnboardingProgressRequest {
+  step: string;
+  state: Record<string, unknown>;
+  /** Stamps completed_at server-side (idempotent, never un-completes). */
+  completed?: boolean;
+  /** 0 = first write (no row yet). */
+  expected_version: number;
 }
 
 export type TemplateDeploymentAgentState = 'up' | 'provisioning' | 'error';
@@ -1343,6 +1385,12 @@ export interface MachineBrowserProfileViewerData {
   turn?: { url: string; username?: string; credential?: string };
 }
 
+/** Daemon reply body for one machine.browser_profile.viewer request. */
+export interface MachineBrowserProfileViewerResponse {
+  result?: Record<string, unknown>;
+  error?: { code?: string; message: string };
+}
+
 export interface AgentNewSessionData {
   previous_session_id?: string;
 }
@@ -4152,15 +4200,31 @@ export type BrowserProfileStatus = 'pending' | 'running' | 'stopped' | 'error' |
 /**
  * Routing/identity discriminant: `byoc` runs on a user machine (machine_id
  * required), `hosted` runs on the platform pool (machine_id null).
+ *
+ * NOTE: `hosted` is RETIRED — its compute plane was removed, so creating a profile
+ * with it is rejected (400 `HOSTED_PLACEMENT_RETIRED`) and existing hosted rows are
+ * read-only (readable, proxy-editable, deletable; never startable). The value stays
+ * in the union because those preserved rows still report it. For a platform-run
+ * browser use a v3 Cloud Profile (`POST /orgs/{org}/edge`).
  */
 export type BrowserPlacement = 'byoc' | 'hosted';
 
-/** Deployment-wide hosted browser runtime availability (the controller startup
- *  gate). Drives whether the create UI offers the platform-hosted placement; it
- *  is org-scoped only for auth — the value itself is the same for every org.
- *  Fail-closed: the server reports `available: false` if it cannot verify. */
+/** Platform-hosted browser runtime availability.
+ *
+ *  This now always reports `available: false`: the v2 hosted compute plane is
+ *  retired, so the answer is a constant rather than a probe of a controller that no
+ *  longer exists. Clients that already treat `available: false` as "offer BYOC
+ *  instead" degrade correctly with no change.
+ *
+ *  `code` distinguishes PERMANENT retirement (`HOSTED_PLACEMENT_RETIRED`) from the
+ *  transient outage the old flag could also mean — do not retry on it. It is
+ *  optional so older servers, which sent only `{available, reason}`, still typecheck. */
 export interface BrowserRuntimeStatus {
   available: boolean;
+  /** Present when `available` is false for a structural reason. Currently only
+   *  `HOSTED_PLACEMENT_RETIRED`; typed as string so a new server code is not a
+   *  breaking SDK change. */
+  code?: string;
   reason?: string;
 }