@parall/sdk 1.32.1 → 1.34.0

package/src/constants.ts

@@ -13,6 +13,41 @@ export const CLIP_BASE = '/clip/v1';
 // included for catalog completeness and agent runtime delivery; product UI
 // should continue to display canonical model IDs/names.
 export const PLATFORM_MODELS = [
+  // Fable 5 rejects an explicit thinking "disabled" param (400) — bridges must
+  // omit the thinking config entirely instead of disabling it.
+  // "(1M)" variants opt the claude-code runtime into the 1M-token context
+  // window via the CLI's [1m] model-name suffix; the server proxy aliases the
+  // catalog ID back to the base model upstream.
+  {
+    id: 'anthropic/claude-fable-5',
+    name: 'Claude Fable 5',
+    provider: 'anthropic',
+    effortLevels: ['low', 'medium', 'high', 'xhigh', 'max'],
+    runtime_names: { 'claude-code': 'claude-fable-5' },
+  },
+  {
+    id: 'anthropic/claude-fable-5-1m',
+    name: 'Claude Fable 5 (1M)',
+    provider: 'anthropic',
+    effortLevels: ['low', 'medium', 'high', 'xhigh', 'max'],
+    runtime_names: { 'claude-code': 'claude-fable-5[1m]' },
+    upstream_id: 'anthropic/claude-fable-5',
+  },
+  {
+    id: 'anthropic/claude-opus-4.8',
+    name: 'Claude Opus 4.8',
+    provider: 'anthropic',
+    effortLevels: ['low', 'medium', 'high', 'xhigh', 'max'],
+    runtime_names: { 'claude-code': 'claude-opus-4-8' },
+  },
+  {
+    id: 'anthropic/claude-opus-4.8-1m',
+    name: 'Claude Opus 4.8 (1M)',
+    provider: 'anthropic',
+    effortLevels: ['low', 'medium', 'high', 'xhigh', 'max'],
+    runtime_names: { 'claude-code': 'claude-opus-4-8[1m]' },
+    upstream_id: 'anthropic/claude-opus-4.8',
+  },
   {
     id: 'anthropic/claude-opus-4.7',
     name: 'Claude Opus 4.7',
@@ -34,6 +69,14 @@ export const PLATFORM_MODELS = [
     effortLevels: ['low', 'medium', 'high', 'max'],
     runtime_names: { 'claude-code': 'claude-sonnet-4-6' },
   },
+  {
+    id: 'anthropic/claude-sonnet-4.6-1m',
+    name: 'Claude Sonnet 4.6 (1M)',
+    provider: 'anthropic',
+    effortLevels: ['low', 'medium', 'high', 'max'],
+    runtime_names: { 'claude-code': 'claude-sonnet-4-6[1m]' },
+    upstream_id: 'anthropic/claude-sonnet-4.6',
+  },
   {
     id: 'anthropic/claude-sonnet-4.5',
     name: 'Claude Sonnet 4.5',
@@ -77,6 +120,12 @@ export const PLATFORM_MODELS = [
     effortLevels: ['medium', 'high', 'xhigh'],
     runtime_names: { codex: 'gpt-5.4-pro' },
   },
+  {
+    id: 'google/gemini-3.5-flash',
+    name: 'Gemini 3.5 Flash',
+    provider: 'google',
+    effortLevels: [],
+  },
   {
     id: 'google/gemini-3.1-pro-preview',
     name: 'Gemini 3.1 Pro Preview',
@@ -244,6 +293,19 @@ export const PLATFORM_DEFAULT_MODEL_BY_RUNTIME = {
   codex: 'openai/gpt-5.4',
 } as const;
 
+// Mirrors Go llmproxy.IsAllowedModelForRuntime's upstream-alias rule:
+// variants that alias upstream (`upstream_id` set — the "(1M)" entries) encode
+// runtime-specific client behavior and are only selectable by runtimes with an
+// explicit runtime_names mapping. Model pickers must filter with this in
+// addition to provider filtering.
+export function isPlatformModelSelectableForRuntime(
+  model: { id: string; upstream_id?: string; runtime_names?: Record<string, string> },
+  runtime: string | null | undefined,
+): boolean {
+  if (!model.upstream_id) return true;
+  return Boolean(runtime && model.runtime_names && runtime in model.runtime_names);
+}
+
 export function platformDefaultModelForRuntime(runtime: string | null | undefined): string | null {
   switch (runtime?.trim()) {
     case undefined:
@@ -415,6 +477,8 @@ export const ENDPOINTS = {
     `${API_BASE}/orgs/${orgId}/machines/${machineId}/agents/${agentId}/workspace/setup`,
   MACHINE_LLM_SOURCE: (orgId: string, machineId: string) =>
     `${API_BASE}/orgs/${orgId}/machines/${machineId}/llm-source`,
+  MACHINE_PROVIDER_ENABLED: (orgId: string, machineId: string) =>
+    `${API_BASE}/orgs/${orgId}/machines/${machineId}/provider-enabled`,
   MACHINE_RUNTIME_AUTH: (orgId: string, machineId: string) =>
     `${API_BASE}/orgs/${orgId}/machines/${machineId}/runtime-auth`,
   MACHINE_KEYS: (orgId: string, machineId: string) =>
@@ -436,9 +500,10 @@ export const ENDPOINTS = {
   MACHINES_ME: `${API_BASE}/machines/me`,
   MACHINES_ME_AGENTS: `${API_BASE}/machines/me/agents`,
   MACHINES_ME_HEALTH: `${API_BASE}/machines/me/health`,
-  MACHINES_ME_CLIP_INSTALLS: `${API_BASE}/machines/me/clip-installs`,
-  MACHINES_ME_CLIP_INSTALL_DONE: (clipId: string) =>
-    `${API_BASE}/machines/me/clip-installs/${clipId}/installed`,
+  MACHINES_ME_CLIPS: `${API_BASE}/machines/me/clips`,
+  MACHINES_ME_BROWSER_PROFILES: `${API_BASE}/machines/me/browser-profiles`,
+  MACHINES_ME_BROWSER_PROFILE_STATUS: (profileId: string) =>
+    `${API_BASE}/machines/me/browser-profiles/${profileId}/status`,
   MACHINES_ME_AGENT_LAUNCH_CREDENTIAL: (agentId: string) =>
     `${API_BASE}/machines/me/agents/${agentId}/launch-credential`,
   MACHINES_ME_AGENT_WORKSPACE_STATE: (agentId: string) =>
@@ -593,6 +658,7 @@ export const ENDPOINTS = {
   DISPATCH_RECEIVED: (orgId: string) => `${API_BASE}/orgs/${orgId}/dispatch/received`,
   DISPATCH_ACK: (orgId: string) => `${API_BASE}/orgs/${orgId}/dispatch/ack`,
   DISPATCH_ACK_BY_ID: (orgId: string, id: string) => `${API_BASE}/orgs/${orgId}/dispatch/${id}/ack`,
+  DISPATCH_EXPIRE: (orgId: string) => `${API_BASE}/orgs/${orgId}/dispatch/expire`,
   DISPATCH_BY_MESSAGES: (orgId: string) => `${API_BASE}/orgs/${orgId}/dispatch/by-messages`,
 
   // Unread
@@ -618,6 +684,9 @@ export const ENDPOINTS = {
   // Notification preferences
   NOTIFICATION_PREFERENCES: `${API_BASE}/notification-preferences`,
 
+  // Unified search (messages + tasks + wiki, org-scoped)
+  SEARCH: (orgId: string) => `${API_BASE}/orgs/${orgId}/search`,
+
   // Feature flags (org-scoped, server-evaluated)
   FEATURE_FLAGS: (orgId: string) => `${API_BASE}/orgs/${orgId}/feature-flags`,
 
@@ -644,6 +713,19 @@ export const ENDPOINTS = {
     `${CLIP_BASE}/orgs/${orgId}/agents/${agentId}/clips/${clipId}`,
   CLIP_INVOKE: (orgId: string) => `${CLIP_BASE}/orgs/${orgId}/invoke`,
   CLIP_ONLINE: (orgId: string) => `${CLIP_BASE}/orgs/${orgId}/online`,
+  BROWSER_PROFILES: (orgId: string) => `${CLIP_BASE}/orgs/${orgId}/browser-profiles`,
+  BROWSER_PROFILE: (orgId: string, profileId: string) =>
+    `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}`,
+  BROWSER_PROFILE_OPEN: (orgId: string, profileId: string) =>
+    `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/open`,
+  BROWSER_PROFILE_STOP: (orgId: string, profileId: string) =>
+    `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/stop`,
+  BROWSER_PROFILE_RESET: (orgId: string, profileId: string) =>
+    `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/reset`,
+  BROWSER_PROFILE_CONSENTS: (orgId: string, profileId: string) =>
+    `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/consents`,
+  BROWSER_PROFILE_CONSENT: (orgId: string, profileId: string, clipId: string) =>
+    `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/consents/${clipId}`,
 
   // Clip registry (global, served by clip-service → Pinix Hub proxy)
   CLIP_REGISTRY: () => `${CLIP_BASE}/registry/clips`,
@@ -721,9 +803,10 @@ export const WS_EVENTS = {
   MACHINE_FILESYSTEM_BROWSE: 'machine.filesystem.browse',
   MACHINE_UPDATE: 'machine.update',
   MACHINE_CONFIG_UPDATED: 'machine.config.updated',
-  MACHINE_CLIP_INSTALL: 'machine.clip.install',
+  MACHINE_CLIP_SYNC: 'machine.clip.sync',
+  MACHINE_BROWSER_PROFILE_LIFECYCLE: 'machine.browser_profile.lifecycle',
   AGENT_NEW_SESSION: 'agent.new_session',
-  CLIP_INSTALLED: 'clip.installed',
+  CLIP_CREATED: 'clip.created',
   CLIP_REMOVED: 'clip.removed',
   CLIP_UPDATED: 'clip.updated',
 } as const;

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;
@@ -2218,6 +2269,7 @@ export interface ResolvedRef {
   sender_avatar_url?: string | null;
   message_type?: string;
   created_at?: string;
+  attachments?: Attachment[];
 
   // Range fields (cht_ + range anchor)
   range_messages?: Array<{
@@ -2229,6 +2281,7 @@ export interface ResolvedRef {
     message_type: string;
     preview: string;
     created_at: string;
+    attachments?: Attachment[];
   }>;
   range_truncated?: boolean;
 
@@ -2560,17 +2613,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 +2636,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 +2664,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 +2734,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 +2757,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,13 +2771,59 @@ 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;
   org_id: string;
 }
+
+// ─── Unified Search ───
+
+export interface SearchParams {
+  q: string;
+  types?: string;
+  chat_id?: string;
+  limit?: number;
+}
+
+export interface SearchMessageResult {
+  message_id: string;
+  chat_id: string;
+  chat_name?: string;
+  sender?: { id: string; display_name: string };
+  content_snippet: string;
+  score: number;
+  created_at: string;
+}
+
+export interface SearchTaskResult {
+  task_id: string;
+  project_id?: string;
+  project_name?: string;
+  title: string;
+  content_snippet: string;
+  score: number;
+  updated_at?: string;
+}
+
+export interface SearchWikiResult {
+  /** Globally-unique section id (stable React key — file_path can repeat across matched sections). */
+  section_id: string;
+  wiki_id: string;
+  wiki_name?: string;
+  file_path: string;
+  heading_path: string[];
+  content_snippet: string;
+  score: number;
+}
+
+export interface SearchResponse {
+  messages: SearchMessageResult[];
+  tasks: SearchTaskResult[];
+  wiki: SearchWikiResult[];
+}