@parall/sdk 1.55.3 → 1.55.5

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { Label, LabelCreatedData, LabelDeletedData, LabelUpdatedData } from './task-label-types.js';
+export type { CompletedUploadPart, FileUrlResponse, PresignedUploadPart, PresignResponse, PresignUploadRequest, } from './attachment-types.js';
 export type UserType = 'human' | 'agent';
 export type UserStatus = 'active' | 'disabled';
 export interface User {
@@ -47,9 +48,25 @@ export interface Chat {
     pinned: boolean;
     hidden: boolean;
     my_notification_level?: NotificationLevel;
+    /**
+     * Resolved per-(agent, chat) reply policy for an AGENT caller: override →
+     * room default → mentions_only floor, gated on the runtime capability.
+     * Absent for human callers, DMs, and smart chats — a runtime reading
+     * nothing here falls back to its legacy agent_routing_mode check.
+     */
+    my_agent_reply_policy?: AgentReplyPolicy;
 }
 export type ChatMemberRole = 'owner' | 'admin' | 'member';
 export type NotificationLevel = 'all' | 'mentions_only' | 'none';
+/** Trigger axis of the per-(agent, chat) reply policy. No 'none': @mentions
+ *  are an unsuppressible floor, so it would equal 'mentions_only'. */
+export type AgentReplyTrigger = 'all' | 'mentions_only';
+/** Reply-form axis; V1 defines only 'full'. */
+export type AgentReplyForm = 'full';
+export interface AgentReplyPolicy {
+    trigger: AgentReplyTrigger;
+    form: AgentReplyForm;
+}
 export interface PushSubscribeRequest {
     platform: 'web' | 'ios' | 'android';
     token: string;
@@ -80,6 +97,14 @@ export interface ChatMember {
     pinned: boolean;
     hidden: boolean;
     joined_at: string;
+    /**
+     * Per-(agent, chat) trigger override on an AGENT member row; absent/null =
+     * follow the room default. Writable by chat owners/admins and org admins
+     * only — never by the agent itself.
+     */
+    agent_reply_trigger?: AgentReplyTrigger | null;
+    /** Reply-form axis; always 'full' in V1. Absent on older servers. */
+    agent_reply_form?: AgentReplyForm;
     /** Org-scoped public title. Omitted by older servers and for former DM peers. */
     title?: string;
     user?: User;
@@ -89,6 +114,11 @@ export interface UpdateChatMemberRequest {
     pinned?: boolean;
     hidden?: boolean;
     notification_level?: NotificationLevel;
+    /** 'all' | 'mentions_only' sets the override; '' clears it (follow the
+     *  room default). Chat-governance authz — agents can never write it. */
+    agent_reply_trigger?: AgentReplyTrigger | '';
+    /** V1 accepts only 'full'. */
+    agent_reply_form?: AgentReplyForm;
 }
 export interface TransferChatOwnershipRequest {
     target_user_id: string;
@@ -175,6 +205,8 @@ export interface ApprovalCardContent {
     display: {
         title: string;
         description?: string;
+        request_reason?: string;
+        resource_label?: string;
         requester?: {
             id: string;
             name: string;
@@ -189,6 +221,7 @@ export interface ApprovalCardContent {
         status: string;
         decided_by?: string;
         decided_at?: string;
+        decision_reason?: string | null;
         execution_status?: ExecutionStatus | null;
         execution_error?: string | null;
         executed_at?: string | null;
@@ -213,6 +246,7 @@ export interface SystemContent {
     actor_name: string;
     target_id?: string;
     target_name?: string;
+    decision_reason?: string;
 }
 export type MessageContent = TextContent | ToolCallContent | ToolResultContent | ApprovalCardContent | StateDeltaContent | SystemContent | IssueProjectionContent | CardContent;
 export interface Message {
@@ -289,9 +323,12 @@ export interface Approval {
     resource_uri: string;
     action_payload: Record<string, unknown>;
     title: string;
+    request_reason?: string | null;
+    resource_label?: string | null;
     requester_id: string;
     decided_by: string | null;
     decided_at: string | null;
+    decision_reason?: string | null;
     status: ApprovalStatus;
     expires_at: string | null;
     execution_status?: ExecutionStatus | null;
@@ -317,6 +354,9 @@ export interface Organization {
     avatar_url: string | null;
     is_personal: boolean;
     member_limit: number | null;
+    attachment_max_file_size_bytes?: number | null;
+    attachment_storage_limit_bytes?: number | null;
+    attachment_storage_used_bytes?: number;
     /** Org-level default smart routing strategy: 'llm' | 'agent' | null. */
     smart_routing_strategy: string | null;
     /** Agent ID for strategy='agent'. NULL when strategy is 'llm' or unset. */
@@ -543,11 +583,6 @@ export interface CheckEmailResponse {
     exists: boolean;
     pending_verification?: boolean;
 }
-export interface PresignResponse {
-    upload_url: string;
-    attachment_id: string;
-    expires_in: number;
-}
 export interface WsTicketResponse {
     ticket: string;
     expires_at: string;
@@ -808,6 +843,13 @@ export interface SendMessageRequest {
 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).
+     */
+    generation?: number;
 }
 /** One WorkItem source pointer for the by-source complete surface. */
 export interface DispatchSourceRef {
@@ -1221,21 +1263,6 @@ export interface LaunchCredentialResponse {
     id: string;
     agent_id: string;
 }
-export interface PresignUploadRequest {
-    file_name: string;
-    file_size: number;
-    mime_type?: string;
-}
-export interface FileUrlResponse {
-    url: string;
-    is_proxy_url?: boolean;
-    expires_in: number;
-    width?: number;
-    height?: number;
-    file_name: string;
-    file_size: number;
-    mime_type: string;
-}
 export interface AvatarUploadResponse {
     avatar_url: string;
 }
@@ -1390,16 +1417,25 @@ export interface UpdateTaskRequest {
      */
     label_ids?: string[] | null;
     /**
-     * Dispatch lane binding (agent senders during a typed dispatch turn).
-     * dispatch_lane + dispatch_event_id bind the update to the claimed typed
-     * lane (incumbency-checked); dispatch_effect_key — exactly
-     * "task_update:<dispatch_event_id>" — additionally commits the update as
+     * Dispatch binding (agent senders during a typed dispatch turn).
+     * 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.
+     * In both forms dispatch_effect_key additionally commits the update as
      * the dispatch's idempotent Effect and resolves the WorkItem in the same
-     * transaction (first update only).
+     * transaction. Lane-bound: exactly "task_update:<dispatch_event_id>" —
+     * first update only; later updates go fenced keyless (the CLI sidecar
+     * arbitrates). By-id: "task_update:<dispatch_event_id>:<payload-hash>" —
+     * content-addressed, every distinct update carries its own key; the first
+     * resolves the WorkItem and later keys land as their own Effects against
+     * the already-resolved row.
      */
     dispatch_lane?: string;
     dispatch_event_id?: string;
     dispatch_effect_key?: string;
+    dispatch_generation?: number;
 }
 export interface CreateTaskRelationRequest {
     target_type: TaskRelationTargetType;
@@ -1826,10 +1862,32 @@ export interface ScheduleFiredData {
     actual_fired_at: string;
 }
 export type WikiChangesetStatus = 'draft' | 'proposed' | 'approval_pending' | 'approved' | 'rejected' | 'merged' | 'closed' | 'superseded' | 'conflict';
+export type WikiAccessTier = 'public' | 'restricted' | 'private';
+export type WikiMemberRole = 'viewer' | 'editor' | 'manager';
+export interface WikiAccessPolicyMember {
+    subject: string;
+    role: WikiMemberRole;
+}
+/** GET/PUT shape of the who-can-access projection (membership design §4).
+ *  PUT must echo the revision from the latest GET (409 POLICY_REVISION_STALE
+ *  on mismatch). Container policy bits ride the root ('' path) PUT only. */
+export interface WikiAccessPolicy {
+    path: string;
+    general_access: WikiAccessTier | 'inherit';
+    default_role?: 'editor' | 'viewer';
+    discoverable: boolean;
+    members: WikiAccessPolicyMember[];
+    revision: string;
+    /** Stored rows the projection cannot express — route to the advanced rules surface. */
+    advanced?: boolean;
+    editors_can_invite?: boolean;
+    viewers_can_download?: boolean;
+}
 export interface Wiki {
     id: string;
     org_id: string;
-    slug: string;
+    /** Absent on degraded listing entries (discoverable-but-unreadable). */
+    slug?: string;
     name: string;
     repo_owner: string;
     repo_name: string;
@@ -1850,6 +1908,14 @@ export interface Wiki {
     purge_eligible_at?: string | null;
     /** Server-computed restore availability for recycle-bin rows. */
     restorable?: boolean | null;
+    /** Derived from the root path rules (never stored): public | restricted | private. */
+    access_tier?: 'public' | 'restricted' | 'private';
+    /** Caller's explicit membership at the library root: none | viewer | editor | manager. */
+    my_membership?: 'none' | 'viewer' | 'editor' | 'manager';
+    /** True for discoverable-but-unreadable listing entries: only id, name and
+     *  access_tier are populated — enough to request to join, nothing else.
+     *  Degraded entries must not be mounted, synced or treated as content. */
+    degraded?: boolean;
 }
 export interface WikiFileChange {
     path: string;
@@ -1884,6 +1950,12 @@ export interface WikiTreeEntry {
      * entry; use it to badge private folders, never for access decisions.
      */
     restricted?: boolean;
+    /**
+     * Committer date (RFC3339) of the newest default-branch commit touching this
+     * entry — the listing's "Last published" value. Present only when the tree
+     * was requested with `last_commit: true` and the lookup succeeded.
+     */
+    last_commit_at?: string;
 }
 export interface WikiTreeResponse {
     data: WikiTreeEntry[];
@@ -2310,6 +2382,7 @@ export interface CardUpdateData {
     execution_status?: ExecutionStatus | null;
     decided_by?: string;
     decided_at?: string;
+    decision_reason?: string | null;
     executed_at?: string | null;
     execution_error?: string | null;
 }
@@ -2322,7 +2395,7 @@ export interface WatchingData {
 export interface MembershipChangedData {
     chat_id: string;
     user_id: string;
-    action: 'added' | 'removed' | 'role_changed';
+    action: 'added' | 'removed' | 'role_changed' | 'policy_changed';
 }
 /**
  * A member was removed from an org — kicked by an admin or self-removal
@@ -3317,6 +3390,7 @@ export interface PresenceUpdateData {
 export interface ResolveRefsRequest {
     refs: string[];
     source_message_id?: string;
+    full?: boolean;
 }
 export interface ResolvedRef {
     type: string;
@@ -4159,6 +4233,12 @@ export interface EdgeBrowserProfile {
     edge_id: string;
     name: string;
     is_default: boolean;
+    /** Stable compare-and-swap revision for Local BYOC Profile operations. */
+    version: number;
+    /** Stable configuration binding used by Alias readiness and execution. */
+    config_revision: number;
+    /** Authoritative persisted Profile operation lifecycle. */
+    lifecycle_state: 'active' | 'pending_create' | 'pending_rename' | 'pending_delete';
     created_at: string;
     updated_at: string;
     /**
@@ -4169,6 +4249,282 @@ export interface EdgeBrowserProfile {
      */
     proxy_configured?: boolean;
 }
+export type EdgeProfileOperationAction = 'create' | 'rename' | 'delete';
+export type EdgeProfileOperationStatus = 'confirmation_required' | 'pending' | 'retryable' | 'rejected' | 'outcome_unknown' | 'succeeded';
+export type EdgeProfileOperationOutcome = 'applied' | 'retryable' | 'rejected';
+export type EdgeProfileOperationErrorCode = 'JWT_REQUIRED' | 'HUMAN_REQUIRED' | 'EDGE_NOT_FOUND' | 'EDGE_OFFLINE' | 'EDGE_STATUS_UNAVAILABLE' | 'PROFILE_NOT_FOUND' | 'PROFILE_VERSION_CONFLICT' | 'PROFILE_OPERATION_IN_PROGRESS' | 'PROFILE_OPERATION_NOT_FOUND' | 'PROFILE_OPERATION_CONFLICT' | 'PROFILE_DELETE_IMPACT_CHANGED' | 'IDEMPOTENCY_CONFLICT' | 'INVALID_IDEMPOTENCY_KEY' | 'INVALID_INPUT';
+export type EdgeProfileOperationRequest = {
+    action: 'create';
+    name: string;
+} | {
+    action: 'rename';
+    profile_id: string;
+    expected_version: number;
+    name: string;
+} | {
+    action: 'delete';
+    profile_id: string;
+    expected_version: number;
+};
+export interface EdgeProfileOperationConfirmRequest {
+    impact_hash: string;
+    confirmation_token: string;
+}
+export interface EdgeProfileDeleteImpact {
+    profile_id: string;
+    profile_version: number;
+    aliases: Array<{
+        alias_id: string;
+        name: string;
+    }>;
+    /** Classified legacy rows block confirmation; they are never silently deleted. */
+    legacy_connections: Array<{
+        connection_id: string;
+        classification: string;
+    }>;
+    grants_count: number;
+    accepted_or_running_executions: number;
+    impact_hash: string;
+    confirmation_token: string;
+}
+export interface EdgeProfileOperationReceipt {
+    operation_id: string;
+    edge_id: string;
+    profile_id: string;
+    action: EdgeProfileOperationAction;
+    status: EdgeProfileOperationStatus;
+    expected_version?: number;
+    target_version: number;
+    attempt: number;
+    name_before?: string;
+    name_after?: string;
+    impact?: EdgeProfileDeleteImpact;
+    /** Present only while a Delete is awaiting the explicit strong confirmation. */
+    confirmation_token?: string;
+    /** Exact Edge outcome only; Server-private lifecycle evidence is never exposed here. */
+    edge_outcome?: EdgeProfileOperationOutcome;
+    error?: {
+        code: string;
+        message?: string;
+    };
+    created_at: string;
+    updated_at: string;
+    completed_at?: string;
+}
+export interface BrowserAliasCreateRequest {
+    name: string;
+    clip_id: string;
+    edge_id: string;
+    profile_id: string;
+    idempotency_key: string;
+}
+export interface BrowserAliasRenameRequest {
+    name: string;
+    expected_version: number;
+    idempotency_key: string;
+}
+export interface BrowserAliasDeleteRequest {
+    expected_version: number;
+    idempotency_key: string;
+}
+export type BrowserAliasErrorCode = 'JWT_REQUIRED' | 'HUMAN_REQUIRED' | 'INVALID_REQUEST' | 'INVALID_ALIAS_NAME' | 'CLIP_NOT_AVAILABLE' | 'PROFILE_NOT_FOUND' | 'ALIAS_NOT_FOUND' | 'ALIAS_NOT_READY' | 'ALIAS_NAME_TAKEN' | 'ALIAS_STALE' | 'PROFILE_OPERATION_IN_PROGRESS' | 'IDEMPOTENCY_CONFLICT' | 'EDGE_OFFLINE' | 'EDGE_STATUS_UNAVAILABLE';
+export interface BrowserAliasVersion {
+    id: string;
+    version_seq: number;
+    source_kind: 'publisher_working_copy' | 'approved_public_snapshot';
+    source_clip_version_id?: string;
+    source_working_revision?: string;
+    version_label?: string;
+    artifact_digest?: string;
+    preparation_status: 'pending' | 'preparing' | 'ready' | 'failed';
+    preparation_result?: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+}
+export type BrowserAliasReadinessStatus = 'checking' | 'ready' | 'needs_action' | 'unavailable' | 'error';
+export declare const BROWSER_ALIAS_READINESS_REASON_CODES: readonly ["edge_offline", "profile_not_found", "profile_damaged", "artifact_invalid", "runtime_incompatible", "needs_login", "target_service_unavailable", "readiness_check_running", "readiness_check_timeout", "readiness_contract_error"];
+export type BrowserAliasReadinessReasonCode = (typeof BROWSER_ALIAS_READINESS_REASON_CODES)[number];
+export interface BrowserAliasReadinessReason {
+    code: BrowserAliasReadinessReasonCode;
+    status: BrowserAliasReadinessStatus;
+    hint: string;
+    observed_at: string;
+    retry_after_ms?: number;
+}
+export interface BrowserAliasReadiness {
+    alias_id: string;
+    status: BrowserAliasReadinessStatus;
+    blocking_reasons: BrowserAliasReadinessReason[];
+    primary_reason?: BrowserAliasReadinessReasonCode;
+    hint?: string;
+    observed_at: string;
+    source: 'server' | 'edge';
+    retry_after_ms?: number;
+    alias_revision: number;
+    active_alias_version_id?: string;
+    profile_revision: number;
+    profile_config_revision: number;
+    generation: number;
+    updated_at: string;
+}
+export interface BrowserAliasReadinessCheckRequest {
+    idempotency_key: string;
+}
+export type BrowserAliasReadinessCheckStatus = 'pending' | 'dispatched' | 'succeeded' | 'rejected';
+export interface BrowserAliasReadinessCheckReceipt {
+    check_id: string;
+    alias_id: string;
+    status: BrowserAliasReadinessCheckStatus;
+    error_code?: 'REPORT_STALE';
+    generation: number;
+    attempt: number;
+    readiness?: BrowserAliasReadiness;
+    created_at: string;
+    updated_at: string;
+    dispatched_at?: string;
+    completed_at?: string;
+}
+export interface BrowserAlias {
+    id: string;
+    name: string;
+    version: number;
+    lifecycle: 'preparing' | 'active' | 'update_preparing' | 'update_failed' | 'deleting';
+    edge: {
+        id: string;
+        name: string;
+        status: 'online' | 'offline';
+        placement: 'byoc' | 'hosted';
+    };
+    profile: {
+        id: string;
+        name: string;
+        version: number;
+        config_revision: number;
+        lifecycle_state: string;
+    };
+    clip: {
+        id: string;
+        name: string;
+        version?: string;
+    };
+    desired_version?: BrowserAliasVersion;
+    active_version?: BrowserAliasVersion;
+    active_artifact_digest?: string;
+    preparation_result?: Record<string, unknown>;
+    update_result?: Record<string, unknown>;
+    readiness?: BrowserAliasReadiness;
+    created_at: string;
+    updated_at: string;
+}
+export interface BrowserAliasDeleteProof {
+    alias_deleted: true;
+    grants_deleted: number;
+    name_released: true;
+}
+export interface BrowserAliasCommandContractSnapshot {
+    command_name: string;
+    input_schema: Record<string, unknown>;
+    output_schema: Record<string, unknown> | null;
+    side_effect_level: string;
+    data_scopes: string[];
+    allowed_domains: string[];
+    required_capabilities: string[];
+}
+export interface BrowserAliasGrantContractEvidence {
+    contract_hash: string;
+    contract_snapshot: BrowserAliasCommandContractSnapshot;
+}
+export interface BrowserAliasGrantCommand {
+    command_name: string;
+    status: 'missing' | 'active' | 'review_required';
+    authorized?: BrowserAliasGrantContractEvidence;
+    current: BrowserAliasGrantContractEvidence;
+    delta?: {
+        changed_fields: string[];
+    };
+}
+export interface BrowserAliasGrantSet {
+    key_id: string;
+    alias: {
+        id: string;
+        name: string;
+        clip: BrowserAlias['clip'];
+    };
+    /** Zero means this Key+Alias set has never been written. */
+    version: number;
+    commands: BrowserAliasGrantCommand[];
+    updated_at?: string;
+}
+export interface BrowserAliasGrantReplaceRequest {
+    expected_version: number;
+    idempotency_key: string;
+    commands: Array<{
+        command_name: string;
+        authorized_contract_hash: string;
+        authorized_contract_snapshot: BrowserAliasCommandContractSnapshot;
+    }>;
+}
+export interface ManagedBrowserAliasSummary {
+    id: string;
+    name: string;
+    clip: BrowserAlias['clip'];
+    readiness?: BrowserAliasReadiness;
+    commands: string[];
+    needs_owner_review: string[];
+}
+export interface ManagedBrowserAliasCommand {
+    name: string;
+    status: 'active';
+    description: string;
+    input_schema: Record<string, unknown>;
+    output_schema: Record<string, unknown> | null;
+    side_effect_level: string;
+    data_scopes: string[];
+    allowed_domains: string[];
+    required_capabilities: string[];
+}
+export interface ManagedBrowserAliasReviewRequiredCommand {
+    name: string;
+    status: 'review_required';
+    hint: string;
+}
+export interface ManagedBrowserAliasInfo {
+    id: string;
+    name: string;
+    clip: BrowserAlias['clip'];
+    readiness?: BrowserAliasReadiness;
+    commands: ManagedBrowserAliasCommand[];
+    needs_owner_review: ManagedBrowserAliasReviewRequiredCommand[];
+}
+export type BrowserAliasExecutionStatus = 'accepted' | 'running' | 'succeeded' | 'failed' | 'outcome_unknown';
+export interface BrowserAliasExecutionRequest {
+    request_id: string;
+    alias: string;
+    command: string;
+    args: Record<string, unknown>;
+}
+export interface BrowserAliasExecutionError {
+    code: string;
+    message: string;
+    hint?: string;
+}
+/** Redacted managed-key/Owner recovery DTO. It never contains target IDs,
+ * hashes, dispatch claims or Edge-ledger evidence. */
+export interface BrowserAliasExecutionReceipt {
+    request_id: string;
+    alias: string;
+    command: string;
+    status: BrowserAliasExecutionStatus;
+    dispatched: true;
+    command_timeout_ms: number;
+    execution_deadline: string;
+    result?: Record<string, unknown>;
+    error?: BrowserAliasExecutionError;
+    accepted_at: string;
+    running_at?: string;
+    terminal_at?: string;
+    updated_at: string;
+}
 /**
  * Sanitized per-profile egress proxy status (hosted Cloud Profiles) — the GET
  * response and the PUT/DELETE result. NEVER carries the password; `password_set`
@@ -4665,5 +5021,4 @@ export interface EdgeOnboardingStatus {
     hosted_profile_created?: boolean;
     hosted_connection_created?: boolean;
 }
-export {};
 //# sourceMappingURL=types.d.ts.map