@parall/sdk 1.56.2 → 1.57.1

package/dist/constants.js

@@ -365,6 +365,26 @@ export const ENDPOINTS = {
     TEAM_MEMBERS: (orgId, teamId) => `${API_BASE}/orgs/${orgId}/teams/${teamId}/members`,
     TEAM_MEMBER: (orgId, teamId, userId) => `${API_BASE}/orgs/${orgId}/teams/${teamId}/members/${userId}`,
     ORG_MEMBERS_ONLINE: (orgId) => `${API_BASE}/orgs/${orgId}/members/online`,
+    LLM_PROVIDERS: (orgId) => `${API_BASE}/orgs/${orgId}/llm-providers`,
+    LLM_PROVIDER: (orgId, providerId) => `${API_BASE}/orgs/${orgId}/llm-providers/${providerId}`,
+    ORG_LLM_MODELS: (orgId) => `${API_BASE}/orgs/${orgId}/llm-models`,
+    ORG_LLM_MODEL: (orgId, modelRowId) => `${API_BASE}/orgs/${orgId}/llm-models/${modelRowId}`,
+    /**
+     * Platform catalog merged with this org's own model rows. Pass `runtime` to
+     * filter org-added models to the ones that runtime can actually reach —
+     * without it a picker can offer a model the write path rejects.
+     */
+    ORG_MODEL_CATALOG: (orgId, runtime, includeModel) => {
+        const params = new URLSearchParams();
+        if (runtime)
+            params.set('runtime', runtime);
+        // include_model keeps a hidden legacy model the caller is still pinned to
+        // representable, matching the public catalog.
+        if (includeModel)
+            params.set('include_model', includeModel);
+        const qs = params.toString();
+        return `${API_BASE}/orgs/${orgId}/models${qs ? `?${qs}` : ''}`;
+    },
     ORG_MEMBER: (orgId, userId) => `${API_BASE}/orgs/${orgId}/members/${userId}`,
     ORG_MEMBER_CHATS: (orgId, memberId) => `${API_BASE}/orgs/${orgId}/members/${memberId}/chats`,
     ORG_MEMBER_TASKS: (orgId, memberId) => `${API_BASE}/orgs/${orgId}/members/${memberId}/tasks`,

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 export * from './browser-viewer.js';
+export { BROWSER_USE_FEATURE_FLAG, isBrowserUseEnabled } from './browser-use.js';
 export * from './attachment-types.js';
 export type { ParallClientOptions } from './client.js';
 export { ApiError, ParallClient } from './client.js';
 export * from './constants.js';
+export * from './llm-provider-types.js';
 export * from './subject.js';
 export * from './task-label-types.js';
 export * from './types.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,YAAY,EACV,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACjF,cAAc,uBAAuB,CAAC;AACtC,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,YAAY,EACV,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,7 +1,9 @@
 export * from './browser-viewer.js';
+export { BROWSER_USE_FEATURE_FLAG, isBrowserUseEnabled } from './browser-use.js';
 export * from './attachment-types.js';
 export { ApiError, ParallClient } from './client.js';
 export * from './constants.js';
+export * from './llm-provider-types.js';
 export * from './subject.js';
 export * from './task-label-types.js';
 export * from './types.js';

package/dist/llm-provider-client.d.ts

@@ -0,0 +1,38 @@
+import type { CreateLLMProviderRequest, CreateOrgLLMModelRequest, LLMProvider, OrgLLMModel, UpdateOrgLLMModelRequest, UpdateLLMProviderRequest } from './llm-provider-types.js';
+import type { PlatformModelInfo } from './types.js';
+import { WechatClient } from './wechat-client.js';
+/**
+ * Org-configured model providers (BYOK) and the model rows bound to them.
+ *
+ * Writes are org-admin only server-side: a provider row carries a credential
+ * and decides where the org's LLM spend goes.
+ *
+ * Design: docs/engineering-design/org-llm-provider-byok-design.md
+ */
+export declare abstract class LLMProviderClient extends WechatClient {
+    getLLMProviders(orgId: string): Promise<LLMProvider[]>;
+    createLLMProvider(orgId: string, data: CreateLLMProviderRequest): Promise<LLMProvider>;
+    /** Omitting `api_key` leaves the stored credential untouched. */
+    updateLLMProvider(orgId: string, providerId: string, data: UpdateLLMProviderRequest): Promise<LLMProvider>;
+    /** Fails with PROVIDER_IN_USE while model rows still point at it. */
+    deleteLLMProvider(orgId: string, providerId: string): Promise<void>;
+    getOrgLLMModels(orgId: string): Promise<OrgLLMModel[]>;
+    createOrgLLMModel(orgId: string, data: CreateOrgLLMModelRequest): Promise<OrgLLMModel>;
+    /**
+     * Patches a model row in place. Repointing a provider or fixing an upstream
+     * name this way avoids the delete-and-recreate window, during which an
+     * org-only model has no upstream at all and its pinned agents fail.
+     */
+    updateOrgLLMModel(orgId: string, modelRowId: string, data: UpdateOrgLLMModelRequest): Promise<OrgLLMModel>;
+    deleteOrgLLMModel(orgId: string, modelRowId: string): Promise<void>;
+    /**
+     * The catalog as this org sees it: platform models with the org's rows
+     * merged in. Distinct from the public model catalog, which stays org-agnostic
+     * and cacheable — use this one wherever an org context exists.
+     *
+     * Pass `runtime` on a picker: org-added models are then filtered to what that
+     * runtime's protocol can reach, matching the server-side pin validation.
+     */
+    getOrgModelCatalog(orgId: string, runtime?: string, includeModel?: string): Promise<PlatformModelInfo[]>;
+}
+//# sourceMappingURL=llm-provider-client.d.ts.map

package/dist/llm-provider-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-client.d.ts","sourceRoot":"","sources":["../src/llm-provider-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACxB,WAAW,EACX,WAAW,EACX,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;GAOG;AACH,8BAAsB,iBAAkB,SAAQ,YAAY;IACpD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQtD,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC;IAI5F,iEAAiE;IAC3D,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,WAAW,CAAC;IAIvB,qEAAqE;IAC/D,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQtD,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC;IAI5F;;;;OAIG;IACG,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,WAAW,CAAC;IAIjB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE;;;;;;;OAOG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAOhC"}

package/dist/llm-provider-client.js

@@ -0,0 +1,57 @@
+import { ENDPOINTS } from './constants.js';
+import { WechatClient } from './wechat-client.js';
+/**
+ * Org-configured model providers (BYOK) and the model rows bound to them.
+ *
+ * Writes are org-admin only server-side: a provider row carries a credential
+ * and decides where the org's LLM spend goes.
+ *
+ * Design: docs/engineering-design/org-llm-provider-byok-design.md
+ */
+export class LLMProviderClient extends WechatClient {
+    async getLLMProviders(orgId) {
+        const response = await this.request('GET', ENDPOINTS.LLM_PROVIDERS(orgId));
+        return response.data;
+    }
+    async createLLMProvider(orgId, data) {
+        return this.request('POST', ENDPOINTS.LLM_PROVIDERS(orgId), data);
+    }
+    /** Omitting `api_key` leaves the stored credential untouched. */
+    async updateLLMProvider(orgId, providerId, data) {
+        return this.request('PATCH', ENDPOINTS.LLM_PROVIDER(orgId, providerId), data);
+    }
+    /** Fails with PROVIDER_IN_USE while model rows still point at it. */
+    async deleteLLMProvider(orgId, providerId) {
+        return this.request('DELETE', ENDPOINTS.LLM_PROVIDER(orgId, providerId));
+    }
+    async getOrgLLMModels(orgId) {
+        const response = await this.request('GET', ENDPOINTS.ORG_LLM_MODELS(orgId));
+        return response.data;
+    }
+    async createOrgLLMModel(orgId, data) {
+        return this.request('POST', ENDPOINTS.ORG_LLM_MODELS(orgId), data);
+    }
+    /**
+     * Patches a model row in place. Repointing a provider or fixing an upstream
+     * name this way avoids the delete-and-recreate window, during which an
+     * org-only model has no upstream at all and its pinned agents fail.
+     */
+    async updateOrgLLMModel(orgId, modelRowId, data) {
+        return this.request('PATCH', ENDPOINTS.ORG_LLM_MODEL(orgId, modelRowId), data);
+    }
+    async deleteOrgLLMModel(orgId, modelRowId) {
+        return this.request('DELETE', ENDPOINTS.ORG_LLM_MODEL(orgId, modelRowId));
+    }
+    /**
+     * The catalog as this org sees it: platform models with the org's rows
+     * merged in. Distinct from the public model catalog, which stays org-agnostic
+     * and cacheable — use this one wherever an org context exists.
+     *
+     * Pass `runtime` on a picker: org-added models are then filtered to what that
+     * runtime's protocol can reach, matching the server-side pin validation.
+     */
+    async getOrgModelCatalog(orgId, runtime, includeModel) {
+        const response = await this.request('GET', ENDPOINTS.ORG_MODEL_CATALOG(orgId, runtime, includeModel));
+        return response.data;
+    }
+}

package/dist/llm-provider-types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Org-configured model providers (BYOK) and the model rows bound to them.
+ *
+ * Design: docs/engineering-design/org-llm-provider-byok-design.md
+ */
+/** Inbound protocol a provider can serve. */
+export type LLMProviderEndpoint = 'chat_completions' | 'messages' | 'responses';
+export type LLMProviderStatus = 'active' | 'disabled';
+/**
+ * A provider as the server returns it. The credential is never echoed back —
+ * `api_key_set` is the only thing a client learns about it.
+ */
+export interface LLMProvider {
+    id: string;
+    name: string;
+    base_url: string;
+    api_key_set: boolean;
+    endpoints: LLMProviderEndpoint[];
+    status: LLMProviderStatus;
+    is_platform: boolean;
+    /**
+     * Runtime types whose protocol this provider can actually serve. Anything
+     * absent here silently uses the platform provider — surface this, or an
+     * operator will assume their credential covers every agent.
+     */
+    runtimes: string[];
+    /** Most recent fallback-worthy failure, if any. */
+    last_error_at?: string | null;
+    last_error_status?: number | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateLLMProviderRequest {
+    name: string;
+    base_url: string;
+    api_key: string;
+    endpoints: LLMProviderEndpoint[];
+}
+/** Omitting `api_key` leaves the stored credential untouched. */
+export interface UpdateLLMProviderRequest {
+    name?: string;
+    base_url?: string;
+    api_key?: string;
+    endpoints?: LLMProviderEndpoint[];
+    status?: LLMProviderStatus;
+}
+/**
+ * One org's row for a model. Overriding a platform model and adding a new one
+ * are the same shape: `overrides_platform` is derived by the server from
+ * whether the platform catalog knows this id, never stored.
+ */
+export interface OrgLLMModel {
+    id: string;
+    model_id: string;
+    provider_id: string;
+    upstream_model_id: string;
+    display_name?: string | null;
+    context_window?: number | null;
+    max_tokens?: number | null;
+    overrides_platform: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateOrgLLMModelRequest {
+    model_id: string;
+    provider_id: string;
+    /** The name to send to this provider, which differs per provider. */
+    upstream_model_id: string;
+    /** Required when `model_id` is not in the platform catalog. */
+    display_name?: string;
+    context_window?: number;
+    max_tokens?: number;
+    effort_levels?: string[];
+    input_modalities?: string[];
+}
+/**
+ * Everything about a model row except its identity. `model_id` is what agents
+ * pin to, so changing it is a delete-and-recreate the operator performs
+ * deliberately; the server rejects it here.
+ */
+export interface UpdateOrgLLMModelRequest {
+    provider_id?: string;
+    upstream_model_id?: string;
+    /**
+     * Metadata fields accept `null` to clear the org's value and go back to
+     * inheriting the platform entry's. Omitting a field leaves it as it is —
+     * the two are different requests, so do not send `undefined` meaning
+     * "clear". A model the platform does not have cannot clear these: it has
+     * nothing to inherit from, and the server rejects it.
+     */
+    display_name?: string | null;
+    context_window?: number | null;
+    max_tokens?: number | null;
+    effort_levels?: string[] | null;
+    input_modalities?: string[] | null;
+}
+//# sourceMappingURL=llm-provider-types.d.ts.map

package/dist/llm-provider-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-types.d.ts","sourceRoot":"","sources":["../src/llm-provider-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED,iEAAiE;AACjE,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACpC"}

package/dist/llm-provider-types.js

@@ -0,0 +1,6 @@
+/**
+ * Org-configured model providers (BYOK) and the model rows bound to them.
+ *
+ * Design: docs/engineering-design/org-llm-provider-byok-design.md
+ */
+export {};

package/dist/types.d.ts

@@ -376,6 +376,25 @@ export interface Organization {
     onboarding_agent_id: string | null;
     /** Org-level IANA timezone (e.g. "America/New_York"). Defaults to "UTC". */
     timezone: string;
+    /**
+     * Whether this org may configure its own LLM providers (BYOK). Absent means
+     * it inherits the platform default, which is off.
+     *
+     * An entitlement, not a feature flag: only a platform admin changes it, and
+     * it is expected to become plan-driven. Turning it off also stops existing
+     * provider configuration from taking effect.
+     */
+    llm_byok_enabled?: boolean | null;
+    /**
+     * When an org's own model provider fails at run time, retry once on the
+     * platform provider — billed to this org's credit balance. Defaults to off,
+     * so "no fallback" is the default state and fallback is opted into.
+     * Does NOT gate the capability fallback: a provider that cannot serve a
+     * runtime's protocol always defers to the platform regardless.
+     * Current servers populate this field; it remains optional for source
+     * compatibility with cached and rolling-upgrade organization payloads.
+     */
+    llm_byok_fallback_enabled?: boolean;
     created_at: string;
     /** Per-member flag: true when the user has dismissed the onboarding popup for this org. */
     onboarding_dismissed: boolean;
@@ -873,10 +892,8 @@ export interface MessageDispatchSource {
     source_type: string;
     source_id: string;
     /**
-     * Conversation generation of the sending execution (parel v2 invocation
-     * context). Required by the server for agents on the direct_session_v2
-     * transport; a value older than the current New Session barrier is
-     * rejected (STALE_GENERATION).
+     * @deprecated Ignored by current servers. Retained so clients compiled
+     * against older SDKs can upgrade without source changes.
      */
     generation?: number;
 }
@@ -1465,8 +1482,8 @@ export interface UpdateTaskRequest {
      * Lane-bound form (v1 consumers): dispatch_lane + dispatch_event_id bind
      * the update to the claimed typed lane (incumbency-checked).
      * By-id form (parel v2 converged consumers — no lane exists):
-     * dispatch_event_id + dispatch_generation bind the update to the WorkItem
-     * directly under the conversation-generation fence.
+     * dispatch_event_id alone binds the update to the WorkItem; the server
+     * admits it on the binding's transport and deletion state alone.
      * In both forms dispatch_effect_key additionally commits the update as
      * the dispatch's idempotent Effect and resolves the WorkItem in the same
      * transaction. Lane-bound: exactly "task_update:<dispatch_event_id>" —
@@ -1479,6 +1496,10 @@ export interface UpdateTaskRequest {
     dispatch_lane?: string;
     dispatch_event_id?: string;
     dispatch_effect_key?: string;
+    /**
+     * @deprecated Ignored by current servers. Retained so clients compiled
+     * against older SDKs can upgrade without source changes.
+     */
     dispatch_generation?: number;
 }
 export interface CreateTaskRelationRequest {
@@ -2773,6 +2794,7 @@ export interface ChannelConversation {
     agent_id: string;
     agent_session_id?: string | null;
     external_conversation_id: string;
+    external_conversation_name?: string;
     external_thread_id: string;
     conversation_type: string;
     external_user_id: string;
@@ -4603,61 +4625,7 @@ export interface BrowserAliasExecutionReceipt {
     terminal_at?: string;
     updated_at: string;
 }
-export type BrowserUseAction = 'read' | 'tabs' | 'wait' | 'snapshot' | 'get' | 'screenshot' | 'open' | 'navigate' | 'viewport' | 'click' | 'fill' | 'type' | 'press' | 'scroll' | 'close' | 'recover' | 'eval';
-export interface BrowserUseTarget {
-    tab_id?: string;
-    browser_generation?: number;
-    document_generation?: number;
-    snapshot_id?: string;
-    ref?: string;
-}
-export interface BrowserUseOperationRequest {
-    contract_version: 'browser-use-operation-v1';
-    request_id: string;
-    profile_id: string;
-    action: BrowserUseAction;
-    target?: BrowserUseTarget;
-    params: Record<string, unknown>;
-    /** Canonical RFC3339 UTC instant, no more than two minutes in the future. */
-    deadline: string;
-}
-export type BrowserUseOperationPhase = 'accepted' | 'started' | 'succeeded' | 'failed' | 'outcome_unknown';
-export interface BrowserUseOperationError {
-    code: string;
-    message?: string;
-    hint?: string;
-}
-/** Durable Browser Use proof. `data` is encrypted/transient: it is present
- * only while result_available is true and disappears after result_expires_at;
- * the terminal receipt and result_digest remain durable. */
-export interface BrowserUseOperationReceipt {
-    contract_version: 'browser-use-operation-v1';
-    operation_id: string;
-    request_id: string;
-    profile_id: string;
-    profile_version: number;
-    profile_config_revision: number;
-    action: BrowserUseAction;
-    required_grant: 'browser.read' | 'browser.interact' | 'browser.advanced';
-    phase: BrowserUseOperationPhase;
-    dispatched?: boolean;
-    receipt_id?: string;
-    receipt_digest?: string;
-    occurred_at?: string;
-    tab_id?: string;
-    browser_generation?: number;
-    duration_ms?: number;
-    result_digest?: string;
-    result_available: boolean;
-    result_expires_at?: string;
-    data?: unknown;
-    error?: BrowserUseOperationError;
-    deadline: string;
-    accepted_at: string;
-    started_at?: string;
-    terminal_at?: string;
-    updated_at: string;
-}
+export type { BrowserUseAction, BrowserUseActionRequest, BrowserUseArticle, BrowserUseGrant, BrowserUseOperationError, BrowserUseOperationPhase, BrowserUseOperationReceipt, BrowserUseOperationReceiptBase, BrowserUseOperationReceiptFor, BrowserUseOperationRequest, BrowserUseRefTarget, BrowserUseSuccessDataMap, BrowserUseTabState, BrowserUseTabSummary, BrowserUseTabTarget, BrowserUseTarget, BrowserUseViewport, } from './browser-use.js';
 /**
  * Sanitized per-profile egress proxy status (hosted Cloud Profiles) — the GET
  * response and the PUT/DELETE result. NEVER carries the password; `password_set`