@parall/sdk 1.34.0 → 1.36.0

package/dist/types.d.ts

@@ -202,6 +202,15 @@ export interface Message {
     content: MessageContent;
     version: number;
     reply_count: number;
+    /** Timestamp of the most recent reply in this message's thread (root only). */
+    last_reply_at?: string | null;
+    /**
+     * Most-recent distinct reply authors, newest-first (root only, capped at 3).
+     * Approximate: derived from the newest ~30 replies per root, so on very long
+     * threads dominated by a few recent senders, older distinct authors may be
+     * absent from the stack. A reload re-derives it from the server's view.
+     */
+    recent_repliers?: User[];
     edited_at: string | null;
     deleted_at: string | null;
     created_at: string;
@@ -290,6 +299,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 +375,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 +592,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 +606,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 +755,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;
 }
@@ -1023,6 +1059,162 @@ export interface ScheduleRunFilters {
     cursor?: string;
     limit?: number;
 }
+export type ExternalConnectionStatus = 'active' | 'disabled';
+export type ExternalIngressEventStatus = 'received' | 'processed' | 'failed';
+export type ExternalTriggerStatus = 'active' | 'paused';
+export type ExternalTriggerEffectiveStatus = 'active' | 'inactive';
+export type ExternalTriggerInactiveReason = 'connection_disabled' | 'connection_archived' | 'trigger_paused' | 'trigger_archived' | 'expired' | 'max_runs_reached';
+export type ExternalTriggerRunStatus = 'delivered' | 'failed';
+export interface ExternalConnection {
+    id: string;
+    org_id: string;
+    source_type: string;
+    display_name: string;
+    owner_id: string;
+    status: ExternalConnectionStatus;
+    auth_config: Record<string, unknown>;
+    archived_at: string | null;
+    archive_reason: string | null;
+    ingress_url?: string;
+    ingress_token?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateExternalConnectionInput {
+    source_type?: string;
+    display_name: string;
+}
+export interface UpdateExternalConnectionInput {
+    display_name?: string;
+    status?: ExternalConnectionStatus;
+}
+export interface ExternalIngressEvent {
+    id: string;
+    org_id: string;
+    connection_id: string;
+    status: ExternalIngressEventStatus;
+    dedupe_key: string | null;
+    event_type: string;
+    request_snapshot: Record<string, unknown>;
+    body_snapshot: Record<string, unknown>;
+    envelope_snapshot: Record<string, unknown>;
+    raw_body_sha256: string;
+    body_size: number;
+    error_code: string | null;
+    error_message: string | null;
+    received_at: string;
+    processed_at: string | null;
+}
+export interface ExternalTrigger {
+    id: string;
+    org_id: string;
+    connection_id: string;
+    creator_id: string;
+    name: string;
+    description: string;
+    status: ExternalTriggerStatus;
+    effective_status: ExternalTriggerEffectiveStatus;
+    inactive_reason?: ExternalTriggerInactiveReason;
+    archived_at: string | null;
+    archive_reason: string | null;
+    attached_to_uri: string | null;
+    filter_language: 'cel';
+    filter_profile: 'parall_cel_v1';
+    filter_expr: string;
+    filter_display_metadata: Record<string, unknown>;
+    template_language: 'liquid';
+    template_profile: 'parall_safe_v1';
+    agent_input_template: string;
+    max_runs: number | null;
+    run_count: number;
+    expires_at: string | null;
+    client_context: Record<string, unknown>;
+    target_agent_ids: string[];
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateExternalTriggerInput {
+    connection_id: string;
+    name: string;
+    description?: string;
+    target_agent_ids: string[];
+    attached_to_uri?: string;
+    filter_expr: string;
+    filter_display_metadata?: Record<string, unknown>;
+    agent_input_template: string;
+    max_runs?: number;
+    expires_at?: string;
+    client_context?: Record<string, unknown>;
+}
+export interface UpdateExternalTriggerInput {
+    name?: string;
+    description?: string;
+    status?: ExternalTriggerStatus;
+    target_agent_ids?: string[];
+    attached_to_uri?: string;
+    attached_to_uri_clear?: boolean;
+    filter_expr?: string;
+    filter_display_metadata?: Record<string, unknown>;
+    agent_input_template?: string;
+    max_runs?: number;
+    max_runs_clear?: boolean;
+    expires_at?: string;
+    expires_at_clear?: boolean;
+    client_context?: Record<string, unknown>;
+}
+export interface ExternalTriggerRun {
+    id: string;
+    org_id: string;
+    connection_id: string;
+    ingress_event_id: string;
+    trigger_id: string;
+    status: ExternalTriggerRunStatus;
+    failure_stage: string | null;
+    error_code: string | null;
+    error_message: string | null;
+    agent_input_body: string | null;
+    trigger_snapshot: Record<string, unknown>;
+    configured_target_agent_ids: string[];
+    eligible_target_agent_ids: string[];
+    skipped_target_agent_ids: string[];
+    dispatch_event_ids: string[];
+    trigger_name?: string;
+    connection_source_type?: string;
+    connection_display_name?: string;
+    ingress_event_type?: string;
+    created_at: string;
+    delivered_at: string | null;
+}
+export interface ExternalConnectionFilters {
+    cursor?: string;
+    limit?: number;
+}
+export interface ExternalTriggerFilters {
+    connection_id?: string;
+    creator_id?: string;
+    cursor?: string;
+    limit?: number;
+}
+export interface ExternalIngressEventFilters {
+    connection_id?: string;
+    cursor?: string;
+    limit?: number;
+}
+export interface ExternalTriggerRunFilters {
+    trigger_id?: string;
+    cursor?: string;
+    limit?: number;
+}
+export interface ExternalTriggerSchema {
+    filter_language: 'cel';
+    filter_profile: 'parall_cel_v1';
+    template_language: 'liquid';
+    template_profile: 'parall_safe_v1';
+    filter_variables: string[];
+    template_variables: string[];
+    template_filters: string[];
+    examples: Record<string, string>;
+}
 export type ScheduleCreatedData = Schedule;
 export type ScheduleUpdatedData = Schedule;
 export interface ScheduleDeletedData {
@@ -1100,6 +1292,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 +1409,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 +1433,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 +1476,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;
@@ -1586,7 +1811,7 @@ export interface InboxItem {
     created_at: string;
     updated_at: string;
 }
-export type DispatchEventType = 'message' | 'task_assign' | 'task_update' | 'task_comment' | 'wiki_comment' | 'schedule.fire' | 'approval_decided';
+export type DispatchEventType = 'message' | 'task_assign' | 'task_update' | 'task_comment' | 'wiki_comment' | 'schedule.fire' | 'external_trigger' | 'approval_decided';
 export type DispatchStatus = 'pending' | 'received' | 'acked';
 export type DispatchDeliveryReason = 'mention' | 'watcher' | 'assignee' | 'creator';
 export interface DispatchEvent {
@@ -1732,6 +1957,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;
@@ -1831,6 +2057,8 @@ export interface ResolvedRef {
     range_truncated?: boolean;
     file_name?: string;
     wiki_name?: string;
+    /** Frontmatter description of the referenced wiki page (OKF), when present. */
+    wiki_description?: string;
     fragment_exists?: boolean;
     anchor_kind?: string;
     anchor_exists?: boolean;
@@ -2103,6 +2331,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;
@@ -2113,6 +2343,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>;
@@ -2133,12 +2374,26 @@ export interface InvokeClipResponse {
     output: unknown;
     error: string | null;
 }
-export type BrowserProfileStatus = 'pending' | 'running' | 'stopped' | 'error';
+/**
+ * profile.status is owner INTENT only, never runtime readiness:
+ *   - BYOC:   pending | running | stopped | error
+ *   - hosted: idle | stopped | error  (idle = enabled, activates lazily on invoke/viewer)
+ * Whether a hosted pod is registered + routable is the lease/controller/provider's
+ * runtime state, NOT profile status — hosted profiles are never `active`.
+ */
+export type BrowserProfileStatus = 'pending' | 'running' | 'stopped' | 'error' | 'idle';
+/**
+ * Routing/identity discriminant: `byoc` runs on a user machine (machine_id
+ * required), `hosted` runs on the platform pool (machine_id null).
+ */
+export type BrowserPlacement = 'byoc' | 'hosted';
 export interface BrowserProfile {
     id: string;
     org_id: string;
-    /** Host machine where the profile's cookies / bb-browser account live. */
-    machine_id: string;
+    /** byoc = user machine, hosted = platform pool. */
+    placement: BrowserPlacement;
+    /** Host machine for byoc profiles; null for hosted (the platform pool owns the pod). */
+    machine_id: string | null;
     owner_user_id: string;
     display_name: string;
     status: BrowserProfileStatus;
@@ -2147,6 +2402,33 @@ export interface BrowserProfile {
     created_by?: string | null;
     created_at: string;
     updated_at: string;
+    /** Control hint on the single-profile responses (create / get / lifecycle) —
+     *  always true, since reaching those endpoints means the caller passed the read
+     *  or control gate and owner/admin can always control. The org-wide list uses
+     *  {@link BrowserProfileListItem.can_open} (per-viewer) instead. */
+    can_open?: boolean;
+}
+/** Sanitized row from `GET /orgs/{orgId}/browser-profiles` (org-wide discovery).
+ *  Carries only the fields the Browser Profiles tab needs to render + gate
+ *  actions — the full domain model (provenance, timestamps) is never returned
+ *  org-wide. `error_msg` / `last_seen` are present only for readers (the profile
+ *  owner or an org admin), not merely for own-local host owners who can `can_open`. */
+export interface BrowserProfileListItem {
+    id: string;
+    org_id: string;
+    /** byoc = user machine, hosted = platform pool. */
+    placement: BrowserPlacement;
+    /** Host machine for byoc; null for hosted (the platform pool owns the pod). */
+    machine_id: string | null;
+    owner_user_id: string;
+    display_name: string;
+    status: BrowserProfileStatus;
+    /** Per-viewer control hint computed by the server (owner / org admin / own
+     *  local host machine). Optional only for forward-compat with an older
+     *  clip-service mid web-first rollout; the current server always sets it. */
+    can_open?: boolean;
+    error_msg?: string | null;
+    last_seen?: string | null;
 }
 export interface BrowserProfileConsent {
     id: string;
@@ -2159,8 +2441,10 @@ export interface BrowserProfileConsent {
     revoked_at?: string | null;
 }
 export interface CreateBrowserProfileRequest {
-    /** Host machine that runs the BrowserProfile (cookies / bb-browser account). */
-    machine_id: string;
+    /** Defaults to `byoc` when omitted (backward compatible). */
+    placement?: BrowserPlacement;
+    /** Required for byoc; omitted for hosted (the platform pool assigns a pod). */
+    machine_id?: string | null;
     owner_user_id: string;
     display_name: string;
 }
@@ -2170,6 +2454,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;
 }
@@ -2258,6 +2576,10 @@ export interface SearchWikiResult {
     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[];