@parall/sdk 1.33.0 → 1.35.0

package/dist/constants.js

@@ -10,6 +10,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',
@@ -31,6 +66,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',
@@ -74,6 +117,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',
@@ -238,6 +287,16 @@ export const PLATFORM_DEFAULT_MODEL_BY_RUNTIME = {
     'claude-code': 'anthropic/claude-sonnet-4.6',
     codex: 'openai/gpt-5.4',
 };
+// 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, runtime) {
+    if (!model.upstream_id)
+        return true;
+    return Boolean(runtime && model.runtime_names && runtime in model.runtime_names);
+}
 export function platformDefaultModelForRuntime(runtime) {
     switch (runtime?.trim()) {
         case undefined:
@@ -275,6 +334,7 @@ export const ENDPOINTS = {
     // Org-scoped
     ORG: (orgId) => `${API_BASE}/orgs/${orgId}`,
     ORG_MEMBERS: (orgId) => `${API_BASE}/orgs/${orgId}/members`,
+    TEAMS: (orgId) => `${API_BASE}/orgs/${orgId}/teams`,
     ORG_MEMBERS_ONLINE: (orgId) => `${API_BASE}/orgs/${orgId}/members/online`,
     ORG_MEMBER: (orgId, userId) => `${API_BASE}/orgs/${orgId}/members/${userId}`,
     ORG_MEMBER_CHATS: (orgId, memberId) => `${API_BASE}/orgs/${orgId}/members/${memberId}/chats`,
@@ -319,6 +379,7 @@ export const ENDPOINTS = {
     AGENT: (orgId, agentId) => `${API_BASE}/orgs/${orgId}/agents/${agentId}`,
     AGENT_API_KEYS: (orgId, agentId) => `${API_BASE}/orgs/${orgId}/agents/${agentId}/api-keys`,
     AGENT_API_KEY: (orgId, agentId, key) => `${API_BASE}/orgs/${orgId}/agents/${agentId}/api-keys/${key}`,
+    AGENT_API_KEY_REGENERATE: (orgId, agentId) => `${API_BASE}/orgs/${orgId}/agents/${agentId}/api-keys/regenerate`,
     AGENT_AVATAR: (orgId, agentId) => `${API_BASE}/orgs/${orgId}/agents/${agentId}/avatar`,
     AGENT_ACTIVITY: (orgId, agentId) => `${API_BASE}/orgs/${orgId}/agents/${agentId}/activity`,
     AGENT_MONITOR: (orgId, agentId) => `${API_BASE}/orgs/${orgId}/agents/${agentId}/monitor`,
@@ -358,6 +419,7 @@ export const ENDPOINTS = {
     MACHINE_AGENT_WORKSPACE_SETUP: (orgId, machineId, agentId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/agents/${agentId}/workspace/setup`,
     MACHINE_LLM_SOURCE: (orgId, machineId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/llm-source`,
     MACHINE_PROVIDER_ENABLED: (orgId, machineId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/provider-enabled`,
+    MACHINE_CAPABILITIES: (orgId, machineId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/capabilities`,
     MACHINE_RUNTIME_AUTH: (orgId, machineId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/runtime-auth`,
     MACHINE_KEYS: (orgId, machineId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/keys`,
     MACHINE_KEY: (orgId, machineId, keyId) => `${API_BASE}/orgs/${orgId}/machines/${machineId}/keys/${keyId}`,
@@ -378,6 +440,12 @@ export const ENDPOINTS = {
     MACHINES_ME_AGENT_WORKSPACE_STATE: (agentId) => `${API_BASE}/machines/me/agents/${agentId}/workspace-state`,
     MACHINES_ME_WS_TICKET: `${API_BASE}/machines/me/ws/ticket`,
     MACHINES_ME_BROWSE_RESPONSE: (requestId) => `${API_BASE}/machines/me/browse-response/${requestId}`,
+    // Hosted browser live-viewer control plane (api-server, NOT clip-service):
+    // the web client drives WebRTC signaling + tab nav through VIEWER_COMMAND;
+    // api-server brokers each command to the host daemon via the machine:{id}
+    // request/reply bridge (mirrors filesystem browse), and the daemon replies on
+    // VIEWER_RESPONSE. See docs/engineering-design/hosted-browser-provider-design.md.
+    MACHINES_ME_BROWSER_PROFILE_VIEWER_RESPONSE: (requestId) => `${API_BASE}/machines/me/browser-profiles/viewer-response/${requestId}`,
     // Tasks (org-scoped)
     TASKS: (orgId) => `${API_BASE}/orgs/${orgId}/tasks`,
     TASK: (orgId, taskId) => `${API_BASE}/orgs/${orgId}/tasks/${taskId}`,
@@ -443,6 +511,9 @@ export const ENDPOINTS = {
     // Wiki Path Scopes (AFCS ACL)
     WIKI_PATH_SCOPES: (orgId, wikiId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/path-scopes`,
     WIKI_PATH_SCOPE: (orgId, wikiId, scopeId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/path-scopes/${scopeId}`,
+    // Wiki Path Restrictions (AFCS narrowing ACL — private subtrees)
+    WIKI_RESTRICTIONS: (orgId, wikiId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/restrictions`,
+    WIKI_RESTRICTION: (orgId, wikiId, restrictionId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/restrictions/${restrictionId}`,
     WIKI_ACCESS_STATUS: (orgId, wikiId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/access-status`,
     WIKI_ACCESS_REQUESTS: (orgId, wikiId) => `${WIKI_BASE}/orgs/${orgId}/wikis/${wikiId}/access-requests`,
     // Wiki History (commits, file commits, blame)
@@ -491,6 +562,8 @@ export const ENDPOINTS = {
     PUSH_VAPID_KEY: `${API_BASE}/push/vapid-key`,
     // Notification preferences
     NOTIFICATION_PREFERENCES: `${API_BASE}/notification-preferences`,
+    // Unified search (messages + tasks + wiki, org-scoped)
+    SEARCH: (orgId) => `${API_BASE}/orgs/${orgId}/search`,
     // Feature flags (org-scoped, server-evaluated)
     FEATURE_FLAGS: (orgId) => `${API_BASE}/orgs/${orgId}/feature-flags`,
     // Billing & Credits (org-scoped)
@@ -506,6 +579,7 @@ export const ENDPOINTS = {
     // Clips (org-scoped, served by clip-service)
     CLIPS: (orgId) => `${CLIP_BASE}/orgs/${orgId}/clips`,
     CLIP: (orgId, clipId) => `${CLIP_BASE}/orgs/${orgId}/clips/${clipId}`,
+    CLIPS_BULK_METADATA: (orgId) => `${CLIP_BASE}/orgs/${orgId}/clips/bulk-metadata`,
     CLIP_AGENTS: (orgId, clipId) => `${CLIP_BASE}/orgs/${orgId}/clips/${clipId}/agents`,
     AGENT_CLIPS: (orgId, agentId) => `${CLIP_BASE}/orgs/${orgId}/agents/${agentId}/clips`,
     AGENT_CLIP: (orgId, agentId, clipId) => `${CLIP_BASE}/orgs/${orgId}/agents/${agentId}/clips/${clipId}`,
@@ -518,6 +592,9 @@ export const ENDPOINTS = {
     BROWSER_PROFILE_RESET: (orgId, profileId) => `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/reset`,
     BROWSER_PROFILE_CONSENTS: (orgId, profileId) => `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/consents`,
     BROWSER_PROFILE_CONSENT: (orgId, profileId, clipId) => `${CLIP_BASE}/orgs/${orgId}/browser-profiles/${profileId}/consents/${clipId}`,
+    // Live viewer command — on api-server (API_BASE), not clip-service: it rides
+    // the machine control-plane request/reply bridge that lives in api-server.
+    BROWSER_PROFILE_VIEWER_COMMAND: (orgId, profileId) => `${API_BASE}/orgs/${orgId}/browser-profiles/${profileId}/viewer/command`,
     // Clip registry (global, served by clip-service → Pinix Hub proxy)
     CLIP_REGISTRY: () => `${CLIP_BASE}/registry/clips`,
 };
@@ -594,6 +671,7 @@ export const WS_EVENTS = {
     MACHINE_CONFIG_UPDATED: 'machine.config.updated',
     MACHINE_CLIP_SYNC: 'machine.clip.sync',
     MACHINE_BROWSER_PROFILE_LIFECYCLE: 'machine.browser_profile.lifecycle',
+    MACHINE_BROWSER_PROFILE_VIEWER: 'machine.browser_profile.viewer',
     AGENT_NEW_SESSION: 'agent.new_session',
     CLIP_CREATED: 'clip.created',
     CLIP_REMOVED: 'clip.removed',

package/dist/types.d.ts

@@ -290,6 +290,15 @@ export interface OrgMember {
     joined_at: string;
     user?: User;
 }
+export interface Team {
+    id: string;
+    org_id: string;
+    name: string;
+    slug: string;
+    created_by: string;
+    created_at: string;
+    updated_at: string;
+}
 export type InvitationStatus = 'pending' | 'accepted' | 'declined' | 'revoked';
 export interface OrgInvitation {
     id: string;
@@ -357,9 +366,7 @@ export interface CreateInvitationRequest {
 }
 export interface ApiKey {
     id: string;
-    key: string;
-    agent_id: string;
-    created_at: string;
+    api_key: string;
 }
 export interface CreateAgentResponse {
     user: User;
@@ -576,6 +583,7 @@ export interface UpdateAgentRequest {
     thinking_effort?: string;
 }
 export type MachineStatus = 'provisioning' | 'starting' | 'restarting' | 'running' | 'stopped' | 'error' | 'terminated';
+export type MachineCapability = 'agent_host' | 'browser_provider';
 export interface Machine {
     id: string;
     org_id: string;
@@ -589,6 +597,7 @@ export interface Machine {
     daemon_mode: boolean;
     llm_source?: string;
     compute_mode: 'hosted' | 'local';
+    capabilities?: MachineCapability[];
     provider_enabled?: boolean;
     clip_provider_url?: string;
     daemon_version?: string | null;
@@ -737,6 +746,24 @@ export interface MachineBrowserProfileLifecycleData {
     action: BrowserProfileLifecycleAction;
     start_url?: string;
 }
+/**
+ * Live-viewer control command relayed to the host daemon over `machine:{id}`.
+ * One command per WebRTC signaling / tab-nav step; the daemon replies via
+ * `POST /machines/me/browser-profiles/viewer-response/{request_id}`.
+ */
+export interface MachineBrowserProfileViewerData {
+    request_id: string;
+    profile_id: string;
+    session_id: string;
+    command: string;
+    input?: Record<string, unknown>;
+    /** Short-lived managed TURN/ICE credentials, minted server-side per stream.start. */
+    turn?: {
+        url: string;
+        username?: string;
+        credential?: string;
+    };
+}
 export interface AgentNewSessionData {
     previous_session_id?: string;
 }
@@ -1100,6 +1127,10 @@ export interface WikiNodeSection {
     start_line: number;
     end_line: number;
     content: string;
+    /** Frontmatter metadata (OKF-inspired, file-level, all optional). */
+    type?: string;
+    description?: string;
+    tags?: string[];
 }
 export interface WikiNodeSectionArtifact {
     version: number;
@@ -1213,15 +1244,23 @@ export interface CreateWikiRequest {
     name: string;
     default_branch?: string;
 }
+export interface WikiFileChangeInput {
+    path: string;
+    action: 'create' | 'update' | 'delete';
+    content_base64?: string;
+    base_version?: number;
+    /**
+     * Git blob SHA of the default-branch version this change was authored
+     * against. When set on update/delete, the server rejects the changeset
+     * with 409 STALE_BASE if the file has since changed on the default branch
+     * (prevents silently overwriting concurrent edits).
+     */
+    base_sha?: string;
+}
 export interface CreateWikiChangesetRequest {
     title: string;
     message?: string;
-    file_changes: Array<{
-        path: string;
-        action: 'create' | 'update' | 'delete';
-        content_base64?: string;
-        base_version?: number;
-    }>;
+    file_changes: WikiFileChangeInput[];
     source_chat_id?: string;
     source_message_id?: string;
     source_run_id?: string;
@@ -1229,12 +1268,15 @@ export interface CreateWikiChangesetRequest {
 export interface UpdateWikiChangesetRequest {
     title?: string;
     message?: string;
-    file_changes?: Array<{
-        path: string;
-        action: 'create' | 'update' | 'delete';
-        content_base64?: string;
-        base_version?: number;
-    }>;
+    file_changes?: WikiFileChangeInput[];
+    /**
+     * When true, file_changes define the changeset's FULL content: the server
+     * resets the feature branch to the current default-branch HEAD before
+     * applying, so previously-proposed changes that are not re-sent are
+     * dropped. Used by CLI re-propose (`changeset create --update`). Default
+     * false preserves incremental merge semantics (binary-upload flow).
+     */
+    replace_files?: boolean;
 }
 export interface WikiCommit {
     sha: string;
@@ -1269,11 +1311,29 @@ export interface CreateWikiPathScopeRequest {
     maintainers?: unknown;
     admins?: unknown;
 }
+export interface WikiPathRestriction {
+    id: string;
+    wiki_id: string;
+    path: string;
+    level: 'read' | 'maintain' | 'admin';
+    subjects: string[];
+    apply_to_admins: boolean;
+    created_by: string;
+    created_at: string;
+}
+export interface CreateWikiPathRestrictionRequest {
+    path: string;
+    level?: 'read' | 'maintain' | 'admin';
+    subjects: string[];
+    apply_to_admins?: boolean;
+}
 export interface WikiAccessStatus {
     path: string;
     read: boolean;
     maintain: boolean;
     admin: boolean;
+    acl_manage: boolean;
+    acl_manage_any: boolean;
 }
 export interface CreateWikiAccessRequest {
     path: string;
@@ -1732,6 +1792,7 @@ export type WsEventMap = {
     'machine.update': MachineUpdateData;
     'machine.clip.sync': MachineClipSyncData;
     'machine.browser_profile.lifecycle': MachineBrowserProfileLifecycleData;
+    'machine.browser_profile.viewer': MachineBrowserProfileViewerData;
     'clip.created': ClipCreatedData;
     'clip.removed': ClipRemovedData;
     'clip.updated': ClipUpdatedData;
@@ -1816,6 +1877,7 @@ export interface ResolvedRef {
     sender_avatar_url?: string | null;
     message_type?: string;
     created_at?: string;
+    attachments?: Attachment[];
     range_messages?: Array<{
         id: string;
         sender_id: string;
@@ -1825,6 +1887,7 @@ export interface ResolvedRef {
         message_type: string;
         preview: string;
         created_at: string;
+        attachments?: Attachment[];
     }>;
     range_truncated?: boolean;
     file_name?: string;
@@ -2101,6 +2164,8 @@ export interface CreateClipRequest {
     browser_profile_id?: string;
 }
 export interface UpdateClipRequest {
+    /** Rename the clip's org-local alias; uniqueness enforced per org. */
+    alias?: string;
     name?: string;
     display_name?: string;
     description?: string;
@@ -2111,6 +2176,17 @@ export interface UpdateClipRequest {
     /** Empty string clears the binding; omitted leaves it unchanged. */
     browser_profile_id?: string;
 }
+/**
+ * Atomically set application-level metadata (`display_name` and/or
+ * `description`) on every clip instance of an application. All-or-nothing on the
+ * server (one transaction). At least one field must be present; omitted leaves
+ * it unchanged, an empty `description` clears it.
+ */
+export interface BulkUpdateClipMetadataRequest {
+    clip_ids: string[];
+    display_name?: string;
+    description?: string;
+}
 export interface BindAgentClipRequest {
     clip_id: string;
     config?: Record<string, unknown>;
@@ -2168,6 +2244,40 @@ export interface UpdateBrowserProfileRequest {
 export interface BrowserProfileLifecycleRequest {
     start_url?: string;
 }
+/** A WebRTC ICE server (STUN/TURN) for the live-viewer peer connection. */
+export interface BrowserViewerIceServer {
+    urls: string[];
+    username?: string;
+    credential?: string;
+}
+/** A serialized ICE candidate exchanged during live-viewer signaling. */
+export interface BrowserViewerIceCandidate {
+    candidate: string;
+    sdpMLineIndex?: number | null;
+    sdpMid?: string | null;
+}
+/**
+ * One live-viewer control command. The web client drives the WebRTC handshake
+ * (`stream.start` → `stream.answer` → `stream.close`/`stream.switch`) and tab
+ * navigation (`tab_list`/`tab_new`/`open`/`reload`/`back`/`forward`) through a
+ * single endpoint; api-server forwards `command` to the host daemon.
+ */
+export interface BrowserViewerCommandRequest {
+    /** Correlates a viewer session. Omit on `stream.start`; the server returns one. */
+    session_id?: string;
+    command: string;
+    input?: Record<string, unknown>;
+}
+export interface BrowserViewerCommandResponse {
+    session_id: string;
+    /**
+     * Command-specific result. For `stream.start`:
+     * `{ offer_sdp: string, candidates: BrowserViewerIceCandidate[], ice_servers: BrowserViewerIceServer[] }`.
+     * May be `null` on the wire — a nil Go result map serializes as JSON null; the
+     * viewer client coalesces it to `{}`.
+     */
+    result: Record<string, unknown> | null;
+}
 export interface GrantBrowserProfileConsentRequest {
     clip_id: string;
 }
@@ -2220,5 +2330,51 @@ export interface ClipRemovedData {
     clip_id: string;
     org_id: string;
 }
+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;
+    /** Frontmatter document type (OKF facet label), when the file declares one. */
+    type?: string;
+    /** Frontmatter summary; clients may prefer it over content_snippet. */
+    description?: string;
+}
+export interface SearchResponse {
+    messages: SearchMessageResult[];
+    tasks: SearchTaskResult[];
+    wiki: SearchWikiResult[];
+}
 export {};
 //# sourceMappingURL=types.d.ts.map