@parall/sdk 1.32.0 → 1.33.0

package/src/types.ts

@@ -21,6 +21,12 @@ export interface User {
 export type ChatType = 'direct' | 'group';
 export type AgentRoutingMode = 'passive' | 'active' | 'smart';
 export type ChatVisibility = 'public' | 'private';
+/**
+ * Who can add new members to a chat.
+ * - `everyone` (default): any chat member can add another org member.
+ * - `admins`: only chat admins/owners (and org admins) may add.
+ */
+export type MemberInvitePolicy = 'everyone' | 'admins';
 
 export interface Chat {
   id: string;
@@ -35,6 +41,7 @@ export interface Chat {
   smart_routing_strategy: string | null;
   /** Chat-level smart routing agent override. NULL = use org default. */
   smart_routing_agent_id: string | null;
+  member_invite_policy: MemberInvitePolicy;
   last_message_at: string | null;
   last_message_preview: string | null;
   last_message_sender: string | null;
@@ -718,7 +725,24 @@ export interface Machine {
   daemon_mode: boolean;
   llm_source?: string;
   compute_mode: 'hosted' | 'local';
+  // Whether the machine contributes its local clips as a hub provider
+  // (org-admin-toggleable via PATCH /machines/{id}/provider-enabled). Absent on
+  // servers predating the field → treat as true (default-on). See
+  // docs/engineering-design/clip-provider-sharing-design.md.
+  provider_enabled?: boolean;
+  // Externally-reachable ProviderStream endpoint the daemon connects to in order
+  // to register its clips with the hub. Server-computed (grey-cloud
+  // clip-rpc.{env}.prll.sh, which bypasses Cloudflare's bidi-incompatible proxy)
+  // and delivered only to BYOC (local daemon-mode) machines via GET /machines/me;
+  // absent for hosted machines. See
+  // docs/engineering-design/clip-provider-sharing-design.md.
+  clip_provider_url?: string;
   daemon_version?: string | null;
+  // Whether the daemon can act on a machine.update signal — true only when a
+  // service manager (launchd/systemd) supervises it, false for bare `npx`
+  // foreground runs that can't load the overlay or restart after exit(42).
+  // Reported on heartbeat; gates the "Check for Update" affordance + API.
+  self_update_capable?: boolean;
   region: string | null;
   created_by: string;
   created_at: string;
@@ -862,6 +886,9 @@ export interface MachineAgentDetachedData {
 export interface MachineConfigUpdatedData {
   machine_id: string;
   llm_source?: string;
+  // Present when provider_enabled changed → daemon (de)registers its clip
+  // provider. Absent on llm_source-only updates.
+  provider_enabled?: boolean;
 }
 
 export interface MachineWorkspaceSetupRequestedData {
@@ -887,11 +914,19 @@ export interface MachineUpdateData {
   reason?: string;
 }
 
-export interface MachineClipInstallData {
+export interface MachineClipSyncData {
+  machine_id: string;
   clip_id: string;
-  alias: string;
-  source_ref: string;
-  version?: string;
+  action?: 'create' | 'update' | 'delete' | string;
+}
+
+export type BrowserProfileLifecycleAction = 'open' | 'stop' | 'reset';
+
+export interface MachineBrowserProfileLifecycleData {
+  machine_id: string;
+  profile_id: string;
+  action: BrowserProfileLifecycleAction;
+  start_url?: string;
 }
 
 export interface AgentNewSessionData {
@@ -1692,6 +1727,7 @@ export interface ChatUpdateData {
       | 'agent_routing_mode'
       | 'smart_routing_strategy'
       | 'smart_routing_agent_id'
+      | 'member_invite_policy'
       | 'last_message_at'
       | 'last_message_preview'
       | 'last_message_sender'
@@ -1999,6 +2035,20 @@ export interface DispatchEvent {
 
 export type DispatchNewData = DispatchEvent;
 
+export interface DispatchExpiredGroup {
+  chat_id: string | null;
+  chat_name?: string | null;
+  event_type: DispatchEventType;
+  count: number;
+  oldest: string;
+  newest: string;
+}
+
+export interface DispatchExpireResult {
+  total: number;
+  groups: DispatchExpiredGroup[];
+}
+
 export interface DispatchReceivedData {
   agent_id: string;
   event_type: string;
@@ -2105,8 +2155,9 @@ export type WsEventMap = {
   'machine.stop': MachineStopData;
   'machine.filesystem.browse': MachineFilesystemBrowseData;
   'machine.update': MachineUpdateData;
-  'machine.clip.install': MachineClipInstallData;
-  'clip.installed': ClipInstalledData;
+  'machine.clip.sync': MachineClipSyncData;
+  'machine.browser_profile.lifecycle': MachineBrowserProfileLifecycleData;
+  'clip.created': ClipCreatedData;
   'clip.removed': ClipRemovedData;
   'clip.updated': ClipUpdatedData;
   'agent.new_session': AgentNewSessionData;
@@ -2560,17 +2611,16 @@ export interface Clip {
   org_id: string;
   alias: string;
   name: string;
+  display_name: string;
   description: string | null;
   manifest: Record<string, unknown>;
   source_type: ClipSourceType;
   source_ref: string | null;
   version: string | null;
   status: ClipStatus;
+  machine_id: string;
+  browser_profile_id: string | null;
   created_by: string | null;
-  /** Registry clip that reconciles onto every org machine, including machines
-   * that join after creation. Targeted installs leave this false and persist
-   * per-machine pending clip_instances instead. */
-  install_on_all_machines: boolean;
   created_at: string;
   updated_at: string;
 }
@@ -2584,21 +2634,27 @@ export interface AgentClip {
 
 export interface CreateClipRequest {
   alias: string;
-  name: string;
+  name?: string;
+  display_name?: string;
   description?: string;
-  manifest: Record<string, unknown>;
+  manifest?: Record<string, unknown>;
   source_type?: ClipSourceType;
   source_ref?: string;
   version?: string;
-  target_machine_ids?: string[];
+  machine_id: string;
+  browser_profile_id?: string;
 }
 
 export interface UpdateClipRequest {
   name?: string;
+  display_name?: string;
   description?: string;
   manifest?: Record<string, unknown>;
   status?: ClipStatus;
   version?: string;
+  machine_id?: string;
+  /** Empty string clears the binding; omitted leaves it unchanged. */
+  browser_profile_id?: string;
 }
 
 export interface BindAgentClipRequest {
@@ -2606,32 +2662,68 @@ export interface BindAgentClipRequest {
   config?: Record<string, unknown>;
 }
 
-export interface InvokeClipRequest {
-  alias: string;
+interface InvokeClipBaseRequest {
   command: string;
   input?: unknown;
   timeout_ms?: number;
 }
 
+export type InvokeClipRequest =
+  | (InvokeClipBaseRequest & { alias: string; clip_id?: never })
+  | (InvokeClipBaseRequest & { clip_id: string; alias?: never });
+
 export interface InvokeClipResponse {
   output: unknown;
   error: string | null;
 }
 
-export type ClipInstanceStatus = 'pending' | 'installed' | 'running' | 'stopped' | 'error';
+export type BrowserProfileStatus = 'pending' | 'running' | 'stopped' | 'error';
 
-export interface ClipInstance {
+export interface BrowserProfile {
   id: string;
-  clip_id: string;
-  machine_id: string | null;
-  status: ClipInstanceStatus;
-  version: string | null;
-  error_msg: string | null;
-  last_seen: string | null;
+  org_id: string;
+  /** Host machine where the profile's cookies / bb-browser account live. */
+  machine_id: string;
+  owner_user_id: string;
+  display_name: string;
+  status: BrowserProfileStatus;
+  error_msg?: string | null;
+  last_seen?: string | null;
+  created_by?: string | null;
   created_at: string;
   updated_at: string;
 }
 
+export interface BrowserProfileConsent {
+  id: string;
+  org_id: string;
+  browser_profile_id: string;
+  clip_id: string;
+  owner_user_id: string;
+  granted_by: string;
+  granted_at: string;
+  revoked_at?: string | null;
+}
+
+export interface CreateBrowserProfileRequest {
+  /** Host machine that runs the BrowserProfile (cookies / bb-browser account). */
+  machine_id: string;
+  owner_user_id: string;
+  display_name: string;
+}
+
+export interface UpdateBrowserProfileRequest {
+  display_name?: string;
+}
+
+export interface BrowserProfileLifecycleRequest {
+  start_url?: string;
+}
+
+export interface GrantBrowserProfileConsentRequest {
+  clip_id: string;
+}
+
 export interface OnlineClipInfo {
   alias: string;
   name: string;
@@ -2640,12 +2732,18 @@ export interface OnlineClipInfo {
   provider_name: string;
 }
 
-// Durable install reconcile — a registry clip the machine should install.
-export interface MachineClipInstall {
+// Executable Clip definition assigned to a daemon machine.
+export interface MachineClip {
   clip_id: string;
   alias: string;
+  name: string;
+  display_name: string;
+  description?: string | null;
+  manifest?: Record<string, unknown>;
+  source_type: ClipSourceType;
   source_ref?: string;
   version?: string;
+  browser_profile_id?: string | null;
 }
 
 // Pinix registry catalog clip info (from GET /clip/v1/registry/clips,
@@ -2657,6 +2755,11 @@ export interface RegistryCommandInfo {
   output?: string;
 }
 
+export interface RegistryDependencyInfo {
+  package: string;
+  version: string;
+}
+
 export interface RegistryClipInfo {
   name: string; // @scope/name (canonical package id)
   package: string; // @scope/name (alias derivation + install source_ref)
@@ -2666,11 +2769,11 @@ export interface RegistryClipInfo {
   domain?: string;
   author?: string;
   commands: RegistryCommandInfo[];
-  dependencies: string[];
+  dependencies: Record<string, RegistryDependencyInfo>;
 }
 
 // Clip WS event data types
-export type ClipInstalledData = Clip;
+export type ClipCreatedData = Clip;
 export type ClipUpdatedData = Clip;
 export interface ClipRemovedData {
   clip_id: string;