@prismer/sdk 2.0.7 → 2.2.55

package/dist/index.d.mts

@@ -1,6 +1,245 @@
 import { AIPIdentity } from '@prismer/aip-sdk';
 export { AIPIdentity, DIDDocument, SignedPayload } from '@prismer/aip-sdk';
 
+/** Subset of the cloud-side AgentStatus enum used by status-change events. */
+type IMAgentStatus = 'online' | 'busy' | 'idle' | 'offline';
+interface HostedAgentDeclaration {
+    imUserId: string;
+    name: string;
+    adapterName: string;
+    capabilities: string[];
+    profiles: Array<{
+        id: string;
+        version: number;
+    }>;
+}
+interface AgentHostDeclarePayload {
+    daemonId: string;
+    /** Optional explicit workspace for local daemons without an IMContainer row. */
+    workspaceId?: string;
+    daemonVersion: string;
+    platform: 'darwin' | 'linux' | 'win32';
+    agents: HostedAgentDeclaration[];
+}
+interface RejectedHostedAgent {
+    imUserId: string;
+    reason: 'bound-to-other-daemon' | 'not-owned' | 'unknown';
+    ownerDaemonId?: string;
+}
+interface HostAckedPayload {
+    workspaceId: string;
+    syncCursor: {
+        workspaces: number;
+        agent_profiles: number;
+        [key: string]: number;
+    };
+    profilesToSync: string[];
+    /** Profile IDs the daemon declared but that no longer exist on the cloud
+     *  (soft-deleted). The daemon should remove these from its local store. */
+    profilesToDelete: string[];
+    acceptedAgents?: string[];
+    rejectedAgents?: RejectedHostedAgent[];
+}
+interface AgentStatusChangedPayload {
+    agentImUserId: string;
+    status: IMAgentStatus;
+    activeProfileId?: string;
+    runningTaskIds?: string[];
+}
+interface TaskDispatchContextEntry {
+    sender: string;
+    senderRole: 'human' | 'agent' | 'admin' | 'system';
+    content: string;
+    createdAt: string;
+    /** Wave-8 W1: assets the human attached to THIS chat message. */
+    attachedAssetIds?: string[];
+}
+/** Wave-8 W1: hydrated asset reference attached to a dispatch. */
+interface AssetRef {
+    assetId: string;
+    contentHash: string;
+    mime: string | null;
+    sizeBytes: number | null;
+    kind: string;
+    workspaceId: string;
+    role: 'attachment' | 'context';
+}
+interface TaskDispatchRequestPayload {
+    taskId: string;
+    /** Agent target for runtimeRoute='agent'. Shell dispatches do not use this. */
+    agentImUserId?: string;
+    /** Runtime/device target for runtimeRoute='shell'. */
+    targetDaemonId?: string;
+    profileId: string;
+    capability: string;
+    prompt: string;
+    /** Execution surface. `shell` is daemon-local command execution. */
+    runtimeRoute?: 'agent' | 'sandbox' | 'shell';
+    metadata?: Record<string, unknown>;
+    timeoutMs?: number;
+    context?: TaskDispatchContextEntry[];
+    conversationId?: string;
+    /**
+     * Channel mode for the originating conversation. Optional and
+     * forward-compatible: when missing, daemon renders 'unknown' in the
+     * [Channel context] prompt block.
+     *   - `direct`: 1:1 DM (no @-mention needed in reply).
+     *   - `group`: multi-party room (end reply with `@<recipient>` to
+     *     continue the chain).
+     */
+    conversationType?: 'direct' | 'group';
+    /**
+     * Active participants of the dispatch's conversation. Daemon injects this
+     * into [Channel context] so the agent knows the authoritative recipient list
+     * without hallucinating. Capped at 50 entries server-side.
+     */
+    participants?: Array<{
+        imUserId: string;
+        username: string;
+        displayName: string;
+        role: string;
+        agentType?: string | null;
+    }>;
+    /** Wave-8 W1: assets cloud wants daemon to fold into agent context. */
+    assetRefs?: AssetRef[];
+}
+interface TaskDispatchProgressPayload {
+    taskId: string;
+    progress: number;
+    message?: string;
+    detail?: Record<string, unknown>;
+}
+/** Wave-8 W1: how the daemon handled a single AssetRef. */
+type AssetDispatchStrategy = 'inline-text' | 'inline-text-truncated' | 'uri-only' | 'error';
+interface AssetDispatchObservation {
+    assetId: string;
+    contentHash: string;
+    mime: string | null;
+    sizeBytes: number | null;
+    strategy: AssetDispatchStrategy;
+    inlinedBytes?: number;
+    error?: string;
+}
+/**
+ * P1-2 (2026-05-25): per-file outbox rejection record emitted by daemon when
+ * outbox-watcher quarantines an artifact (MIME ≠ filename extension). Cloud
+ * persists these on `IMTask.metadata.outboxRejections` and re-injects into
+ * the next dispatch prompt as agent-visible feedback.
+ */
+interface OutboxRejectionRecord {
+    filename: string;
+    reason: string;
+    inferredMime: string;
+    detectedMime: string;
+    rejectedAt: string;
+}
+interface TaskDurabilityPageReceipt {
+    pageId: string;
+    path: string;
+    version: number;
+    contentHash: string;
+    authority?: 'cloud' | 'outbox';
+    authorityEventId?: string;
+}
+interface TaskDurabilityResult {
+    commitKey: string;
+    postTurnKey: string;
+    canonicalTurnId: string;
+    conversationId?: string;
+    runId?: string;
+    messageId?: string;
+    profileId?: string;
+    profileName?: string;
+    model?: string;
+    provider?: string;
+    targetPageKey?: string;
+    normalizedContentHash?: string;
+    state: 'persisted' | 'skipped_not_durable' | 'skipped_duplicate' | 'retryable_failure' | 'terminal_failure';
+    receipts: TaskDurabilityPageReceipt[];
+    error?: {
+        code: string;
+        message: string;
+    };
+    timeoutMs: number;
+    replyCommittedAt: number;
+    duplicateOf?: {
+        state: 'persisted' | 'skipped_not_durable' | 'retryable_failure' | 'terminal_failure';
+        receipts: TaskDurabilityPageReceipt[];
+        replyCommittedAt: number;
+    };
+}
+interface TaskDispatchReplyPayload {
+    taskId: string;
+    ok: boolean;
+    output?: string;
+    /** Markdown projection remains in output; rich PKF rides beside it. */
+    contentBlocks?: ContentBlockInput[];
+    error?: {
+        code: string;
+        message: string;
+    };
+    assetIds?: string[];
+    metrics?: {
+        tokensUsed?: number;
+        durationMs?: number;
+    };
+    /** Wave-8 W1: per-asset handling report. */
+    assetObservability?: AssetDispatchObservation[];
+    /**
+     * P1-2: files quarantined by daemon outbox-watcher's magic-bytes guard
+     * during this turn. Empty/absent when nothing was rejected.
+     */
+    outboxRejections?: OutboxRejectionRecord[];
+    /** PKF 209 Phase 1: bounded pre-reply authoritative Memory outcome. */
+    durability?: TaskDurabilityResult;
+}
+interface TaskCancelPayload {
+    taskId: string;
+    reason?: string;
+}
+/**
+ * Wire envelope for v2.0 WS events. `timestamp` is required (mirrors the
+ * cloud-side `WSMessage<T>` definition in src/im/types/index.ts).
+ */
+interface IMWSMessage<T = unknown> {
+    type: string;
+    payload: T;
+    requestId?: string;
+    timestamp: number;
+}
+interface WorkspaceChangedPayload {
+    workspaceId: string;
+    /** ISO-8601 timestamp from im_workspaces.updatedAt. */
+    updatedAt: string;
+}
+interface AgentProfileChangedPayload {
+    profileId: string;
+    version: number;
+}
+interface AgentChangedPayload {
+    agentImUserId: string;
+    fields: {
+        displayName?: string;
+        capabilities?: string[];
+    };
+}
+interface WorkspaceFileChangedPayload {
+    workspaceId: string;
+    path: string;
+    operation: 'create' | 'update' | 'delete';
+    assetId?: string;
+    contentHash?: string;
+    version: number;
+}
+interface AssetChangedPayload {
+    workspaceId: string;
+    assetId: string;
+    operation: 'create' | 'update' | 'delete';
+    contentHash?: string;
+    assetIndexSeq?: number;
+    revision?: number;
+}
+
 /**
  * Prismer SDK — Storage adapters for offline-first IM.
  *
@@ -256,8 +495,15 @@ interface PrismerConfig {
     timeout?: number;
     /** Custom fetch implementation */
     fetch?: typeof fetch;
-    /** Default X-IM-Agent header for IM requests (select which agent identity to use) */
+    /** Agent identity hint: X-IM-Agent for IM requests, X-Prismer-Agent for canonical PKF requests. */
     imAgent?: string;
+    /**
+     * Default X-IM-Workspace header for IM requests (release202/09 §3.6 B).
+     * Lets the cloud agent-proxy reach its workspace-scoped fallback when the
+     * owner `userId`/`numericId` bridge can't resolve the agent. Optional —
+     * absent header preserves legacy behavior.
+     */
+    imWorkspace?: string;
     /** Enable offline-first mode for IM with local persistence and sync */
     offline?: OfflineConfig;
     /**
@@ -575,18 +821,47 @@ type ContentBlockToolUse = {
     toolName: string;
     inputJson: unknown;
 };
-type ContentBlockToolResult = {
-    kind: 'tool_result';
-    toolCallId: string;
-    output: ContentBlock[];
-};
 type ContentBlockReasoning = {
     kind: 'reasoning';
     text: string;
     redacted?: boolean;
 };
-/** v2.0 §4.6 ContentBlock discriminated union (Anthropic-shape, 8 variants). */
-type ContentBlock = ContentBlockText | ContentBlockImage | ContentBlockAudio | ContentBlockVideo | ContentBlockFile | ContentBlockToolUse | ContentBlockToolResult | ContentBlockReasoning;
+type ContentBlockPkfInput = {
+    kind: 'pkf';
+    source: string;
+    title?: string;
+};
+type ContentBlockPkfOutput = ContentBlockPkfInput & {
+    blockId: string;
+    blockRevision: number;
+    sourceHash: string;
+    authority: {
+        status: 'verified';
+        source: 'pkf_inline_blocks';
+    } | {
+        status: 'corrupt';
+        source: 'pkf_inline_blocks';
+        code: string;
+    };
+};
+/** @deprecated Use ContentBlockPkfInput or ContentBlockPkfOutput at a concrete boundary. */
+type ContentBlockPkf = ContentBlockPkfInput | ContentBlockPkfOutput;
+type ContentBlockToolResultInput = {
+    kind: 'tool_result';
+    toolCallId: string;
+    output: ContentBlockInput[];
+};
+type ContentBlockToolResultOutput = {
+    kind: 'tool_result';
+    toolCallId: string;
+    output: ContentBlockOutput[];
+};
+/** @deprecated Use the boundary-specific recursive ToolResult type. */
+type ContentBlockToolResult = ContentBlockToolResultInput | ContentBlockToolResultOutput;
+type ContentBlockInput = ContentBlockText | ContentBlockImage | ContentBlockAudio | ContentBlockVideo | ContentBlockFile | ContentBlockToolUse | ContentBlockToolResultInput | ContentBlockReasoning | ContentBlockPkfInput;
+type ContentBlockOutput = ContentBlockText | ContentBlockImage | ContentBlockAudio | ContentBlockVideo | ContentBlockFile | ContentBlockToolUse | ContentBlockToolResultOutput | ContentBlockReasoning | ContentBlockPkfOutput;
+/** v2.0 §4.6 + product209 PKF ContentBlock discriminated union (9 variants). */
+type ContentBlock = ContentBlockInput | ContentBlockOutput;
 /**
  * v2.0 §4.6 ChatMessage — used by TaskInput.messages and other multi-turn
  * dispatch shapes. Content may be a plain string (legacy / single-text) or a
@@ -594,7 +869,7 @@ type ContentBlock = ContentBlockText | ContentBlockImage | ContentBlockAudio | C
  */
 interface ChatMessage {
     role: 'system' | 'user' | 'assistant' | 'tool';
-    content: string | ContentBlock[];
+    content: string | ContentBlockInput[];
     /** Optional name (tool message provenance, OpenAI-compat). */
     name?: string;
     /** Optional tool_call_id (for role='tool' responses). */
@@ -631,7 +906,7 @@ interface IMMessage {
      * string) and `attachments` (legacy) for the 6-sprint double-write window.
      * When the server returns ContentBlock[], renderers should prefer this.
      */
-    contentBlocks?: ContentBlock[] | null;
+    contentBlocks?: ContentBlockOutput[] | null;
     /**
      * v2.0 §4.1 — per-conversation strictly monotonic boundary sequence number
      * stamped by the server inside the same tx as the message insert.
@@ -731,6 +1006,42 @@ interface IMDiscoverAgent {
     capabilities?: string[];
     status: string;
 }
+/** Workspace-scoped filters for the Agent Registry (`GET /api/im/agents`). */
+interface IMAgentDiscoverOptions {
+    workspaceId: string;
+    agentType?: string;
+    capability?: string;
+    onlineOnly?: boolean;
+}
+/** Capability declared on an AgentCard returned by the Agent Registry. */
+interface IMAgentCatalogCapability {
+    name: string;
+    description: string;
+    version?: string;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+/** Agent Registry entry. Independent from the contacts-only `IMDiscoverAgent`. */
+interface IMAgentCatalogEntry {
+    agentId: string;
+    userId: string;
+    username?: string;
+    name: string;
+    description: string;
+    agentType: string;
+    /**
+     * Agent Registry rows include both legacy string capability names and
+     * structured AgentCapability declarations. The endpoint intentionally
+     * preserves both persisted shapes.
+     */
+    capabilities: Array<string | IMAgentCatalogCapability>;
+    status: string;
+    load: number;
+    endpoint?: string;
+    did?: string;
+    didDocumentUrl?: string;
+    visionCapable: boolean;
+}
 interface IMBindingData {
     bindingId: string;
     platform: string;
@@ -804,6 +1115,13 @@ interface IMWorkspaceInitGroupOptions {
     }>;
     force?: boolean;
 }
+interface IMWorkspaceCreateAgentOptions {
+    agentName: string;
+    agentDisplayName: string;
+    agentType?: string;
+    capabilities?: string[];
+    metadata?: Record<string, unknown>;
+}
 interface IMAutocompleteResult {
     userId: string;
     username: string;
@@ -848,7 +1166,7 @@ interface IMSendOptions {
      * v2.0 §4.6 — multimodal content blocks. When set, `content` is treated as
      * a fallback summary string for adapters that don't speak ContentBlock yet.
      */
-    contentBlocks?: ContentBlock[];
+    contentBlocks?: ContentBlockInput[];
 }
 interface IMPaginationOptions {
     limit?: number;
@@ -965,8 +1283,20 @@ interface OfflineConfig {
         data: any;
         seq: number;
     }) => 'keep_local' | 'accept_remote' | StoredMessage;
-    /** Sync mode: 'push' = SSE continuous stream, 'poll' = periodic polling (default: 'push') */
+    /** Sync mode: 'push' = continuous stream, 'poll' = periodic polling (default: 'push') */
     syncMode?: 'push' | 'poll';
+    /**
+     * release203/12 — prefer the unified single WebSocket (`WS /ws/realtime`) for
+     * continuous push sync instead of the legacy `/api/im/sync/stream` SSE.
+     * Default: true. Set false to pin the SSE transport (e.g. behind a proxy that
+     * doesn't yet pass WS upgrades). Falls back to SSE then polling automatically
+     * when no WebSocket is available. */
+    unifiedWs?: boolean;
+    /**
+     * Custom WebSocket constructor (Node <21 without a global `WebSocket`, or test
+     * mocks). Mirrors the realtime client's injection point. When omitted the
+     * global `WebSocket` is used (browser / Node 21+). */
+    WebSocket?: new (url: string) => WebSocket;
     /** Enable multi-tab coordination via BroadcastChannel (default: true in browser, false in Node.js) */
     multiTab?: boolean;
     /** E2E encryption config */
@@ -983,10 +1313,12 @@ interface OfflineConfig {
         warningThreshold?: number;
     };
 }
-type TaskStatus = 'pending' | 'assigned' | 'running' | 'review' | 'completed' | 'failed' | 'cancelled';
+type TaskStatus = 'pending' | 'assigned' | 'running' | 'review' | 'blocked' | 'awaiting_approval' | 'completed' | 'failed' | 'cancelled';
 type ScheduleType = 'once' | 'interval' | 'cron';
 interface IMCreateTaskOptions {
     title: string;
+    /** Caller-scoped create idempotency key (1-191 chars). */
+    idempotencyKey?: string;
     description?: string;
     capability?: string;
     input?: Record<string, unknown>;
@@ -1011,6 +1343,10 @@ interface IMCreateTaskOptions {
     conversationId?: string;
     /** v1.9.x: pick the executor — `agent` (default), `sandbox`, or `shell`. */
     runtimeRoute?: 'agent' | 'sandbox' | 'shell';
+    /** runtime210/06 W2: link the task to an OKR Key Result (same workspace). */
+    keyResultId?: string;
+    /** runtime210/06 W2: consistency check — the objective the keyResult belongs to. */
+    objectiveId?: string;
 }
 interface IMUpdateTaskOptions {
     title?: string;
@@ -1130,6 +1466,8 @@ interface IMTaskResult {
     assetIds: string[];
     resultUri?: string | null;
     completedAt: string;
+    /** PKF 209: authoritative pre-reply Memory outcome, when this turn requested durability. */
+    durability?: TaskDurabilityResult;
 }
 interface IMCreateMemoryFileOptions {
     path: string;
@@ -1594,7 +1932,7 @@ interface IMAgentForkResult {
 /**
  * Per-call options for the internal request function (v2.0).
  * `headers` — extra request headers to merge in (caller wins over default
- *   Authorization/X-IM-Agent on collision).
+ *   Authorization/authority-specific agent header on collision).
  */
 interface RequestOpts {
     headers?: Record<string, string>;
@@ -1607,6 +1945,183 @@ interface RequestOpts {
  * existing 4-arg callsites still type-check.
  */
 type RequestFn = <T>(method: string, path: string, body?: unknown, query?: Record<string, string>, opts?: RequestOpts) => Promise<T>;
+interface PkfApiEnvelope<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+        retryable?: boolean;
+    };
+    requestId: string;
+}
+interface PkfMessageSourceLocator {
+    kind: 'message-pkf';
+    messageId: string;
+    blockId: string;
+    blockRevision: number;
+    sourceHash: string;
+}
+type PkfCarrierMaterializationTarget = {
+    kind: 'asset';
+    filename: string;
+} | {
+    kind: 'memory-page';
+    path: string;
+    pathConfirmed: true;
+    visibility?: string;
+};
+interface PkfCarrierMaterializeRequest {
+    workspaceId: string;
+    source: PkfMessageSourceLocator;
+    target: PkfCarrierMaterializationTarget;
+    idempotencyKey: string;
+}
+interface PkfCarrierMaterializationView {
+    receiptId: string;
+    state: 'committed';
+    source: {
+        kind: 'message-pkf';
+        messageId: string;
+        blockId: string;
+        revision: number;
+        contentHash: string;
+    };
+    target: {
+        kind: 'asset';
+        id: string;
+        revision: number;
+        contentHash: string;
+        filename: string;
+        workspacePath: string;
+    } | {
+        kind: 'memory-page';
+        id: string;
+        revision: number;
+        contentHash: string;
+        path: string;
+        visibility: string;
+    };
+    validation: {
+        structureStatus: 'pass';
+        resourceStatus: 'unverified';
+    };
+}
+interface PkfMaterializationReadQuery {
+    workspaceId: string;
+    idempotencyKey: string;
+    targetKind: 'asset' | 'memory-page';
+}
+interface PkfMaterializationDiscoveryQuery {
+    workspaceId: string;
+    source: PkfMessageSourceLocator;
+    targetKind: 'asset' | 'memory-page';
+}
+/** The two mutually exclusive GET /api/pkf/materializations locator forms. */
+type PkfMaterializationQuery = PkfMaterializationReadQuery | PkfMaterializationDiscoveryQuery;
+type PkfBundleResourceUsage = 'harness-manifest' | 'harness-script' | 'harness-style' | 'harness-resource' | 'image' | 'video' | 'audio' | 'file' | 'data';
+interface PkfBundleCommitRequest {
+    workspaceId: string;
+    idempotencyKey: string;
+    root: {
+        filename: string;
+        source: string;
+        sourceHash: string;
+    };
+    resources: Array<{
+        path: string;
+        fromPath?: string;
+        bytesBase64: string;
+        contentHash: string;
+        integrity: string;
+        mime: string;
+        usage: PkfBundleResourceUsage;
+    }>;
+}
+interface PkfBundleReadQuery {
+    workspaceId: string;
+    idempotencyKey: string;
+}
+interface PkfBundleCommitView {
+    replayed: boolean;
+    receipt: {
+        id: string;
+        state: 'committed';
+        requestHash: string;
+    };
+    root: {
+        id: string;
+        revision: number;
+        contentHash: string;
+        filename: string;
+        workspacePath: string;
+    };
+    resources: Array<{
+        id: string;
+        path: string;
+        contentHash: string;
+        integrity: string;
+        mime: string;
+        usage: string;
+        fromContentHash: string;
+        fromNodeKey: string;
+        boundKind: 'pkf-resource';
+    }>;
+}
+type PkfArtifactRootKind = 'message-pkf' | 'asset' | 'memory-page';
+interface PkfArtifactRelationsQuery {
+    workspaceId: string;
+    rootKind: PkfArtifactRootKind;
+    rootId: string;
+    revision: number;
+}
+interface PkfArtifactRelationView {
+    id: string;
+    fromNodeKey: string;
+    fromContentHash: string;
+    toAssetId: string;
+    toContentHash: string;
+    relation: string;
+    usage: string;
+    resourcePathKey: string;
+    displayName: string | null;
+    integrity: string | null;
+    required: boolean;
+    visibility: string;
+    lifecycle: string;
+}
+interface PkfArtifactGraphView {
+    root: {
+        kind: PkfArtifactRootKind;
+        id: string;
+        revision: number;
+        contentHash: string;
+    };
+    relations: PkfArtifactRelationView[];
+}
+interface PkfResourceReadQueryBase {
+    workspaceId: string;
+    rootKind: PkfArtifactRootKind;
+    rootId: string;
+    rootRevision: number;
+    rootHash: string;
+}
+type PkfResourceReadQuery = PkfResourceReadQueryBase & ({
+    targetAssetId: string;
+    targetHash?: never;
+} | {
+    targetAssetId?: never;
+    targetHash: string;
+});
+interface PkfResourceDetailView {
+    id: string;
+    workspaceId: string;
+    contentHash: string;
+    mime: string | null;
+    sizeBytes: number | null;
+    filename: string | null;
+}
 interface ExecutionContext {
     error?: string;
     provider?: string;
@@ -2373,8 +2888,14 @@ declare class OfflineManager extends OfflineEmitter {
     private _isOnline;
     private _syncState;
     private sseSource;
+    /** release203/12 — unified single-WS realtime transport (preferred over SSE). */
+    private wsSource;
     private sseReconnectTimer;
     private sseReconnectAttempts;
+    /** Injected/global WebSocket ctor (undefined → WS transport unavailable). */
+    private readonly WS?;
+    /** Prefer the unified WS over SSE for continuous sync (default true). */
+    private readonly unifiedWs;
     /** Presence cache for realtime presence events */
     private presenceCache;
     /** Auth token provider — set by PrismerClient for SSE auth */
@@ -2436,7 +2957,15 @@ declare class OfflineManager extends OfflineEmitter {
      */
     startContinuousSync(): Promise<void>;
     /**
-     * Stop the SSE continuous sync connection.
+     * release203/12 — continuous sync over the unified single WebSocket.
+     * Consumes the `{ch:'sync',name:'sync',data}` frames (the same per-user
+     * fan-out the SSE endpoint served) and ignores the `tasks` channel + control
+     * frames. Behaviour-preserving vs the SSE path: same applySyncEvent, same
+     * cursor, same emitted events — only the transport differs (2 sockets → 1).
+     */
+    private startContinuousSyncWs;
+    /**
+     * Stop the continuous sync connection (WS or SSE).
      */
     stopContinuousSync(): void;
     private scheduleSseReconnect;
@@ -2732,204 +3261,6 @@ interface WorkspaceAssetsApiContract {
     getAssetUrl(id: string): Promise<string>;
 }
 
-/** Subset of the cloud-side AgentStatus enum used by status-change events. */
-type IMAgentStatus = 'online' | 'busy' | 'idle' | 'offline';
-interface HostedAgentDeclaration {
-    imUserId: string;
-    name: string;
-    adapterName: string;
-    capabilities: string[];
-    profiles: Array<{
-        id: string;
-        version: number;
-    }>;
-}
-interface AgentHostDeclarePayload {
-    daemonId: string;
-    daemonVersion: string;
-    platform: 'darwin' | 'linux' | 'win32';
-    agents: HostedAgentDeclaration[];
-}
-interface RejectedHostedAgent {
-    imUserId: string;
-    reason: 'bound-to-other-daemon' | 'not-owned' | 'unknown';
-    ownerDaemonId?: string;
-}
-interface HostAckedPayload {
-    workspaceId: string;
-    syncCursor: {
-        workspaces: number;
-        agent_profiles: number;
-        [key: string]: number;
-    };
-    profilesToSync: string[];
-    /** Profile IDs the daemon declared but that no longer exist on the cloud
-     *  (soft-deleted). The daemon should remove these from its local store. */
-    profilesToDelete: string[];
-    acceptedAgents?: string[];
-    rejectedAgents?: RejectedHostedAgent[];
-}
-interface AgentStatusChangedPayload {
-    agentImUserId: string;
-    status: IMAgentStatus;
-    activeProfileId?: string;
-    runningTaskIds?: string[];
-}
-interface TaskDispatchContextEntry {
-    sender: string;
-    senderRole: 'human' | 'agent' | 'admin' | 'system';
-    content: string;
-    createdAt: string;
-    /** Wave-8 W1: assets the human attached to THIS chat message. */
-    attachedAssetIds?: string[];
-}
-/** Wave-8 W1: hydrated asset reference attached to a dispatch. */
-interface AssetRef {
-    assetId: string;
-    contentHash: string;
-    mime: string | null;
-    sizeBytes: number | null;
-    kind: string;
-    workspaceId: string;
-    role: 'attachment' | 'context';
-}
-interface TaskDispatchRequestPayload {
-    taskId: string;
-    /** Agent target for runtimeRoute='agent'. Shell dispatches do not use this. */
-    agentImUserId?: string;
-    /** Runtime/device target for runtimeRoute='shell'. */
-    targetDaemonId?: string;
-    profileId: string;
-    capability: string;
-    prompt: string;
-    /** Execution surface. `shell` is daemon-local command execution. */
-    runtimeRoute?: 'agent' | 'sandbox' | 'shell';
-    metadata?: Record<string, unknown>;
-    timeoutMs?: number;
-    context?: TaskDispatchContextEntry[];
-    conversationId?: string;
-    /**
-     * Channel mode for the originating conversation. Optional and
-     * forward-compatible: when missing, daemon renders 'unknown' in the
-     * [Channel context] prompt block.
-     *   - `direct`: 1:1 DM (no @-mention needed in reply).
-     *   - `group`: multi-party room (end reply with `@<recipient>` to
-     *     continue the chain).
-     */
-    conversationType?: 'direct' | 'group';
-    /**
-     * Active participants of the dispatch's conversation. Daemon injects this
-     * into [Channel context] so the agent knows the authoritative recipient list
-     * without hallucinating. Capped at 50 entries server-side.
-     */
-    participants?: Array<{
-        imUserId: string;
-        username: string;
-        displayName: string;
-        role: string;
-        agentType?: string | null;
-    }>;
-    /** Wave-8 W1: assets cloud wants daemon to fold into agent context. */
-    assetRefs?: AssetRef[];
-}
-interface TaskDispatchProgressPayload {
-    taskId: string;
-    progress: number;
-    message?: string;
-    detail?: Record<string, unknown>;
-}
-/** Wave-8 W1: how the daemon handled a single AssetRef. */
-type AssetDispatchStrategy = 'inline-text' | 'inline-text-truncated' | 'uri-only' | 'error';
-interface AssetDispatchObservation {
-    assetId: string;
-    contentHash: string;
-    mime: string | null;
-    sizeBytes: number | null;
-    strategy: AssetDispatchStrategy;
-    inlinedBytes?: number;
-    error?: string;
-}
-/**
- * P1-2 (2026-05-25): per-file outbox rejection record emitted by daemon when
- * outbox-watcher quarantines an artifact (MIME ≠ filename extension). Cloud
- * persists these on `IMTask.metadata.outboxRejections` and re-injects into
- * the next dispatch prompt as agent-visible feedback.
- */
-interface OutboxRejectionRecord {
-    filename: string;
-    reason: string;
-    inferredMime: string;
-    detectedMime: string;
-    rejectedAt: string;
-}
-interface TaskDispatchReplyPayload {
-    taskId: string;
-    ok: boolean;
-    output?: string;
-    error?: {
-        code: string;
-        message: string;
-    };
-    assetIds?: string[];
-    metrics?: {
-        tokensUsed?: number;
-        durationMs?: number;
-    };
-    /** Wave-8 W1: per-asset handling report. */
-    assetObservability?: AssetDispatchObservation[];
-    /**
-     * P1-2: files quarantined by daemon outbox-watcher's magic-bytes guard
-     * during this turn. Empty/absent when nothing was rejected.
-     */
-    outboxRejections?: OutboxRejectionRecord[];
-}
-interface TaskCancelPayload {
-    taskId: string;
-    reason?: string;
-}
-/**
- * Wire envelope for v2.0 WS events. `timestamp` is required (mirrors the
- * cloud-side `WSMessage<T>` definition in src/im/types/index.ts).
- */
-interface IMWSMessage<T = unknown> {
-    type: string;
-    payload: T;
-    requestId?: string;
-    timestamp: number;
-}
-interface WorkspaceChangedPayload {
-    workspaceId: string;
-    /** ISO-8601 timestamp from im_workspaces.updatedAt. */
-    updatedAt: string;
-}
-interface AgentProfileChangedPayload {
-    profileId: string;
-    version: number;
-}
-interface AgentChangedPayload {
-    agentImUserId: string;
-    fields: {
-        displayName?: string;
-        capabilities?: string[];
-    };
-}
-interface WorkspaceFileChangedPayload {
-    workspaceId: string;
-    path: string;
-    operation: 'create' | 'update' | 'delete';
-    assetId?: string;
-    contentHash?: string;
-    version: number;
-}
-interface AssetChangedPayload {
-    workspaceId: string;
-    assetId: string;
-    operation: 'create' | 'update' | 'delete';
-    contentHash?: string;
-    assetIndexSeq?: number;
-    revision?: number;
-}
-
 /**
  * Prismer SDK — Multi-Tab Coordination
  *
@@ -3609,7 +3940,7 @@ declare class DirectClient {
      * generates a UUID per call and stamps it into the `X-Idempotency-Key`
      * header. Pass the same key across retries to trigger server dedup.
      */
-    send(userId: string, content: string | ContentBlock[], options?: IMSendOptions): Promise<IMResult<IMMessageData>>;
+    send(userId: string, content: string | ContentBlockInput[], options?: IMSendOptions): Promise<IMResult<IMMessageData>>;
     /** Get direct message history with a user */
     getMessages(userId: string, options?: IMPaginationOptions): Promise<IMResult<IMMessage[]>>;
 }
@@ -3629,7 +3960,7 @@ declare class GroupsClient {
      * v2.0 §4.6 — `content` may now be a `ContentBlock[]` for multimodal sends.
      * v2.0 §3.0.2 Gap A-④ — auto-generates `X-Idempotency-Key` per call.
      */
-    send(groupId: string, content: string | ContentBlock[], options?: IMSendOptions): Promise<IMResult<IMMessageData>>;
+    send(groupId: string, content: string | ContentBlockInput[], options?: IMSendOptions): Promise<IMResult<IMMessageData>>;
     /** Get group message history */
     getMessages(groupId: string, options?: IMPaginationOptions): Promise<IMResult<IMMessage[]>>;
     /** Add a member to a group (owner/admin only) */
@@ -3684,7 +4015,7 @@ declare class MessagesClient {
      * `(conversationId, idempotencyKey)` dedup; pass the same key across
      * retries to safely re-send.
      */
-    send(conversationId: string, content: string | ContentBlock[], options?: IMSendOptions): Promise<IMResult<IMMessageData>>;
+    send(conversationId: string, content: string | ContentBlockInput[], options?: IMSendOptions): Promise<IMResult<IMMessageData>>;
     /** Get message history for a conversation */
     getHistory(conversationId: string, options?: IMPaginationOptions): Promise<IMResult<IMMessage[]>>;
     /** Edit a message */
@@ -3787,8 +4118,8 @@ declare class WorkspaceClient {
     init(options: IMWorkspaceInitOptions): Promise<IMResult<IMWorkspaceData>>;
     /** Initialize a group workspace (multi-user + multi-agent) */
     initGroup(options: IMWorkspaceInitGroupOptions): Promise<IMResult<IMWorkspaceData>>;
-    /** Add an agent to a workspace */
-    addAgent(workspaceId: string, agentId: string): Promise<IMResult<void>>;
+    /** Create a low-level agent identity in a workspace. Role workflows use the role-builder harness. */
+    addAgent(workspaceId: string, options: IMWorkspaceCreateAgentOptions | string): Promise<IMResult<unknown>>;
     /** List agents in a workspace */
     listAgents(workspaceId: string): Promise<IMResult<any[]>>;
     /** @mention autocomplete */
@@ -3841,6 +4172,22 @@ declare class TasksClient {
     fail(taskId: string, error: string, metadata?: Record<string, unknown>): Promise<IMResult<IMTask>>;
     /** Approve a completed task */
     approve(taskId: string): Promise<IMResult<IMTask>>;
+    /**
+     * apc P-6 — post an auditable task event (`POST /tasks/:id/event`).
+     *
+     * Lands one `im_task_logs` row: `action = code.toLowerCase()`, `payload`
+     * serialised into metadata. Server-side authorization: only the task
+     * assignee may post. Used by `cloud skill ack` for skill invocation
+     * receipts (code `SKILL_ACK` → action `skill_ack`).
+     */
+    postEvent(taskId: string, options: {
+        code: string;
+        payload?: Record<string, unknown>;
+        message?: string;
+    }): Promise<IMResult<{
+        taskId: string;
+        action: string;
+    }>>;
     /** Reject a task with reason */
     reject(taskId: string, reason: string): Promise<IMResult<IMTask>>;
     /** Cancel a task */
@@ -3859,7 +4206,7 @@ declare class TasksClient {
      * `allowedActors`.
      */
     transition(taskId: string, options: {
-        to: 'pending' | 'assigned' | 'running' | 'review' | 'blocked' | 'failed' | 'completed' | 'cancelled';
+        to: 'pending' | 'assigned' | 'running' | 'review' | 'blocked' | 'awaiting_approval' | 'failed' | 'completed' | 'cancelled';
         assigneeId?: string | null;
         position?: number;
         reason?: string;
@@ -3873,7 +4220,7 @@ declare class TasksClient {
      * with `force_transition: true`. UI does NOT expose this — ops only.
      */
     forceTransition(taskId: string, options: {
-        to: 'pending' | 'assigned' | 'running' | 'review' | 'blocked' | 'failed' | 'completed' | 'cancelled';
+        to: 'pending' | 'assigned' | 'running' | 'review' | 'blocked' | 'awaiting_approval' | 'failed' | 'completed' | 'cancelled';
         reason: string;
     }): Promise<IMResult<IMTask>>;
     /** Get rolled-up acceptance + criteria list for a task. */
@@ -3909,6 +4256,12 @@ declare class TasksClient {
             required?: boolean;
             weight?: number;
             evidenceRefs?: unknown[];
+            execution?: {
+                command: string;
+                cwd: string;
+                workdirId: string;
+            };
+            reviewKind?: "code-review" | "design-review";
         }) => Promise<IMResult<unknown>>;
         /** Update a criterion in place. */
         update: (taskId: string, cid: string, patch: {
@@ -3918,6 +4271,12 @@ declare class TasksClient {
             weight?: number;
             required?: boolean;
             evidenceRefs?: unknown[];
+            execution?: {
+                command: string;
+                cwd: string;
+                workdirId: string;
+            };
+            reviewKind?: "code-review" | "design-review";
         }) => Promise<IMResult<unknown>>;
         /** Remove a criterion. */
         remove: (taskId: string, cid: string) => Promise<IMResult<unknown>>;
@@ -3930,6 +4289,7 @@ declare class TasksClient {
             outcome: "passed" | "failed" | "n/a" | "waived";
             note?: string;
             evidenceRefs?: string[];
+            reviewArtifact?: unknown;
             waiveReason?: string;
         }) => Promise<IMResult<unknown>>;
     };
@@ -4042,6 +4402,83 @@ interface MetricAggregateResponse {
     };
     buckets: MetricBucketResult[];
 }
+/**
+ * B-P1c — scope axis of `turnSummary()` (GET /api/im/metrics/turns).
+ */
+type TurnScope = 'conversation' | 'task' | 'agent';
+/**
+ * Frozen contract — mirrors `TurnMetricsSummary` in
+ * src/im/services/metric-turns.service.ts VERBATIM (field names are additive
+ * only; renames / removals are not allowed). `null` always means "no rows in
+ * the window" — never 0-by-inference, never NaN. `turnCountByStatus` carries
+ * `null` for a status the window never saw (the daemon emits only ok/error);
+ * `models` lists only turns that carried a model dim, so sum(models.turns)
+ * can be < turnCount.
+ */
+interface TurnMetricsSummary {
+    turnCount: number;
+    turnCountByStatus: {
+        ok: number | null;
+        error: number | null;
+    };
+    avgTokensPerTurn: {
+        input: number | null;
+        output: number | null;
+        cacheRead: number | null;
+        cacheWrite: number | null;
+    };
+    cacheHitRatio: number | null;
+    p95FirstEventMs: number | null;
+    avgDurationMs: number | null;
+    toolCallsPerTurn: number | null;
+    models: Array<{
+        model: string;
+        turns: number;
+    }>;
+}
+interface TurnSummaryOptions {
+    scope: TurnScope;
+    /** conversationId | taskId | agentId (IM user id of the agent). */
+    id: string;
+    /** Mandatory; a plain query param on /turns (unlike aggregate()'s filter csv). */
+    workspaceId: string;
+    /** e.g. '24h' | '7d' — same Nh|Nd grammar as aggregate(); default 24h. */
+    range?: string;
+    from?: string;
+    to?: string;
+}
+interface MetricEventsOptions {
+    namespace: string;
+    name: string;
+    /** workspaceId is required; other keys ride the filter csv like aggregate(). */
+    filter: Record<string, string> & {
+        workspaceId: string;
+    };
+    range?: string;
+    from?: string;
+    to?: string;
+    /** Server default 50, clamped to 200. */
+    limit?: number;
+}
+/** One raw event row (runtime210/06 W12b provenance read). */
+interface MetricEventRow {
+    id: string;
+    ts: string;
+    valueNumeric: number | null;
+    valueString: string | null;
+    dims: Record<string, unknown> | null;
+    source: string;
+    sourceId: string | null;
+}
+interface MetricEventsResponse {
+    namespace: string;
+    name: string;
+    range: {
+        from: string;
+        to: string;
+    };
+    events: MetricEventRow[];
+}
 /**
  * release201/11 §6 — unified metric data channel.
  *
@@ -4049,6 +4486,8 @@ interface MetricAggregateResponse {
  * - `batch()` ships an array of events (≤ 500) — used by daemon outbox flush
  *   in Phase 2.
  * - `aggregate()` runs a server-side query against `im_metric_events`.
+ * - `events()` reads the raw rows behind an aggregate (provenance drill-down).
+ * - `turnSummary()` joins the turn.* family into a scoped summary (B-P1d).
  */
 declare class MetricsClient {
     private _r;
@@ -4065,6 +4504,18 @@ declare class MetricsClient {
         }>;
     }>>;
     aggregate(opts: MetricAggregateOptions): Promise<IMResult<MetricAggregateResponse>>;
+    /**
+     * B-P1d — raw event rows behind an aggregate (runtime210/06 W12b
+     * provenance read). workspaceId is mandatory on the filter — same
+     * cross-workspace rule as aggregate(); the server rejects without it.
+     */
+    events(opts: MetricEventsOptions): Promise<IMResult<MetricEventsResponse>>;
+    /**
+     * B-P1d — conversation / task / agent scoped turn summary over the turn.*
+     * family. The response `data` shape is the frozen TurnMetricsSummary
+     * contract above.
+     */
+    turnSummary(opts: TurnSummaryOptions): Promise<IMResult<TurnMetricsSummary>>;
 }
 /** Identity key management: Ed25519 keys, attestation, audit */
 declare class IdentityClient {
@@ -4210,6 +4661,8 @@ declare class AgentsClient {
     private _r;
     readonly skills: AgentSkillsClient;
     constructor(_r: RequestFn);
+    /** Discover AgentCard-backed agents in a workspace the caller belongs to. */
+    discover(options: IMAgentDiscoverOptions): Promise<IMResult<IMAgentCatalogEntry[]>>;
     spec(agentId: string, workspaceId?: string): Promise<IMResult<IMAgentSpec>>;
     snapshot(agentId: string, options?: IMAgentSnapshotOptions): Promise<IMResult<IMAgentSnapshot>>;
     snapshots(agentId: string, options?: {
@@ -4682,15 +5135,18 @@ declare class WorkspacesClient {
      */
     getOrchestrator(workspaceId: string): Promise<IMResult<IMWorkspaceOrchestratorEnvelope>>;
     /**
-     * Appoint an agent as the workspace's orchestrator. Owner-only. If an
-     * orchestrator is already active, this auto-revokes the previous one in the
-     * same UPDATE.
+     * Appoint an agent as the workspace's orchestrator. Owner-only.
+     *
+     * ⚠️ FIRST appointment only. The orchestrator is a node of the platform
+     * network — it holds a globally-unique AIP identity (DID) and system contact
+     * edges to the platform official agents — so the appointment is PERMANENT:
+     * appointing a different agent while one is already in place fails with
+     * 409 `ORCHESTRATOR_IMMUTABLE`. Re-appointing the same agent is a no-op.
+     * Revocation does not exist (`revokeOrchestrator` was removed in 2.1.0).
      */
     appointOrchestrator(workspaceId: string, agentImUserId: string): Promise<IMResult<{
         orchestrator: IMWorkspaceOrchestrator | null;
     }>>;
-    /** Revoke the workspace's current orchestrator. Owner-only. Idempotent. */
-    revokeOrchestrator(workspaceId: string): Promise<IMResult<void>>;
 }
 /** Workspace membership role. Different enum from project (16 §5.1 decision). */
 type WorkspaceRole = 'owner' | 'admin' | 'member';
@@ -5104,9 +5560,23 @@ declare class IMRealtimeClient {
     subscribeTaskEvents(token: string, onEvent: (event: TaskEventEnvelope) => void, options?: {
         lastEventId?: string;
         signal?: AbortSignal;
+        /** release203/12 — prefer the unified single WS (`ch:'tasks'`) over the
+         *  `/api/im/tasks/events` SSE. Default true; falls back to SSE when no
+         *  WebSocket is available. */
+        unifiedWs?: boolean;
+        /** Custom WebSocket ctor (Node <21 / tests); else the global WebSocket. */
+        WebSocket?: new (url: string) => WebSocket;
     }): Promise<{
         disconnect: () => void;
     }>;
+    /**
+     * release203/12 — task events over the unified single WebSocket.
+     * Connects to `WS /ws/realtime`, filters the `ch:'tasks'` frames, and emits
+     * the SAME `{ type, payload }` envelopes `subscribeTaskEvents` did over SSE
+     * (the WS carries no per-event `id`; cursor resume is handled by the sync
+     * channel). The `ch:'sync'` frames + control frames are ignored here.
+     */
+    private subscribeTaskEventsWs;
 }
 interface SkillDraftManifestFile {
     path: string;
@@ -5215,6 +5685,27 @@ declare class SkillsClient {
     readonly draft: SkillsDraftClient;
     constructor(_r: RequestFn);
 }
+declare class PkfClient {
+    private readonly _r;
+    private readonly _fetchAuthed;
+    constructor(_r: RequestFn, _fetchAuthed: (path: string, init?: RequestInit) => Promise<Response>);
+    materialize(input: PkfCarrierMaterializeRequest): Promise<PkfApiEnvelope<PkfCarrierMaterializationView>>;
+    getMaterialization(query: PkfMaterializationReadQuery): Promise<PkfApiEnvelope<PkfCarrierMaterializationView | null>>;
+    discoverMaterialization(query: PkfMaterializationDiscoveryQuery): Promise<PkfApiEnvelope<PkfCarrierMaterializationView | null>>;
+    /** Atomically commit a PKF root plus its exact root-bound dependency graph. */
+    commitBundle(input: PkfBundleCommitRequest): Promise<PkfApiEnvelope<PkfBundleCommitView>>;
+    /** Restore the caller-scoped durable bundle receipt after process restart. */
+    getBundle(query: PkfBundleReadQuery): Promise<PkfApiEnvelope<PkfBundleCommitView>>;
+    getArtifactRelations(query: PkfArtifactRelationsQuery): Promise<PkfApiEnvelope<PkfArtifactGraphView>>;
+    getResourceDetail(query: PkfResourceReadQuery): Promise<PkfApiEnvelope<PkfResourceDetailView>>;
+    /**
+     * Read root-authorized dependency bytes. This intentionally returns the raw
+     * Response so callers can stream the body and verify `X-Asset-Hash`.
+     */
+    getResourceBytes(query: PkfResourceReadQuery): Promise<Response>;
+    /** Low-level canonical request seam used by the Cloud CLI. */
+    request<T = unknown>(method: string, path: `/api/pkf/${string}`, body?: unknown, query?: Record<string, string>): Promise<T>;
+}
 declare class IMClient {
     readonly account: AccountClient;
     readonly direct: DirectClient;
@@ -5284,12 +5775,15 @@ declare class PrismerClient {
     private readonly timeout;
     private readonly fetchFn;
     private readonly imAgent?;
+    private readonly imWorkspace?;
     private _offlineManager;
     /** AIP identity for auto-signing (v1.8.0 S1) */
     private _identity;
     private _identityReady;
     /** IM API sub-client */
     readonly im: IMClient;
+    /** Canonical Cloud PKF surface (`/api/pkf/*`), never nested under IM. */
+    readonly pkf: PkfClient;
     /** v2.0 workspace public surface (`/api/im/workspaces`). */
     readonly workspaces: WorkspacesClient;
     /** v2.0.8 release201/16 — token-bearing invite endpoints (preview/accept/reject). */
@@ -5323,9 +5817,10 @@ declare class PrismerClient {
      *
      * The path may be absolute (`/api/...`) or a full URL — full URLs are used
      * verbatim (useful for following 302 redirects), otherwise the path is
-     * appended to the client's configured `baseUrl`. Authorization + `X-IM-Agent`
-     * headers are added automatically; caller-supplied headers in `init.headers`
-     * override them on collision.
+     * appended to the client's configured `baseUrl`. Authorization plus the
+     * authority-specific agent header are added automatically: canonical PKF
+     * requests use `X-Prismer-Agent`, while legacy `/api/im/*` keeps
+     * `X-IM-Agent`. Caller-supplied headers override them on collision.
      *
      * Use this for binary downloads / partial fetches; for normal JSON-envelope
      * IM requests use `client.im.request()` (typed) or the typed sub-clients.
@@ -5359,4 +5854,4 @@ declare class PrismerClient {
 
 declare function createClient(config: PrismerConfig): PrismerClient;
 
-export { AccountClient, type AgentChangedPayload, type AgentHostDeclarePayload, type AgentProfileChangedPayload, AgentSkillsClient, type AgentStatusChangedPayload, AgentsClient, type AssetChangedPayload, type AssetDispatchObservation, type AssetDispatchStrategy, type AssetRef, AssetsClient, AttachmentQueue, type AudioMime, type AuthenticatedPayload, type BatchSummary, type BatchUrlCost, BindingsClient, type CacheManager, type Card, type CardCreateInput, type CardFilters, type CardKanbanMetadata, type CardKanbanMetadataSource, type CardKanbanStatus, type CardMetadata, type CardMove, type ChatMessage, type CommandResult, CommunityHub, type CommunityHubConfig, ContactsClient, type ContentBlock, type ContentBlockAudio, type ContentBlockFile, type ContentBlockImage, type ContentBlockReasoning, type ContentBlockText, type ContentBlockToolResult, type ContentBlockToolUse, type ContentBlockVideo, type ControlCommand, ConversationsClient, CreditsClient, CriteriaTemplatesClient, type DaemonControlPlane, type DecryptResult, type DerivationMode, DirectClient, type DisconnectedPayload, E2EEncryption, ENVIRONMENTS, type EncryptedContextResult, type EncryptedFileResult, type EncryptedMessage, type Environment, type ErrorPayload, EvolutionCache, EvolutionClient, EvolutionRuntime, type EvolutionRuntimeConfig, type EvolutionSession, EvolutionSkillsClient, type EvolutionSyncDelta, type EvolutionSyncSnapshot, type ExecutionContext, type ExecutionPolicy, type FileInput, FilesClient, type GeneCategory, type GeneSelectionResult, type GeneVisibility, GroupsClient, type HostAckedPayload, type HostedAgentDeclaration, type IMAccountDeleteResult, type IMAgentCard, type IMAgentForkOptions, type IMAgentForkResult, type IMAgentPack, type IMAgentPackListOptions, type IMAgentPersonality, type IMAgentPublishOptions, type IMAgentRestoreOptions, type IMAgentSkillAckInput, type IMAgentSkillInstallOptions, type IMAgentSkillListOptions, type IMAgentSkillRecord, type IMAgentSnapshot, type IMAgentSnapshotOptions, type IMAgentSpec, type IMAgentStatus, type IMAnalyzeOptions, type IMAnalyzeResult, type IMAsset, type IMAssetDetail, type IMAssetListOptions, type IMAssetPreviewContract, type IMAssetPreviewKind, type IMAssetPreviewStatus, type IMAssetRevision, type IMAssetRevisionList, type IMAssetUploadOptions, type IMAutocompleteResult, type IMBinding, type IMBindingData, type IMBlockedUser, type IMCapsule, IMClient, type IMCompactOptions, type IMCompactionSummary, type IMCompleteTaskOptions, type IMConfirmResult, type IMContact, type IMConversation, type IMConversationsOptions, type IMCreateBindingOptions, type IMCreateGeneOptions, type IMCreateGroupOptions, type IMCreateMemoryFileOptions, type IMCreateRuntimeInstallationOptions, type IMCreateTaskOptions, type IMCreateWorkspaceFileOptions, type IMCreateWorkspaceOptions, type IMCreditsData, type IMDiscoverAgent, type IMDiscoverOptions, type IMEvolutionEdge, type IMEvolutionStats, type IMFileQuota, type IMForkGeneOptions, type IMFriendRequest, type IMGene, type IMGeneListOptions, type IMGroupData, type IMGroupMember, type IMIdentityKey, type IMInstallAgentOnRuntimeOptions, type IMInstallAgentOnRuntimeResult, type IMKeyAuditEntry, type IMKeyVerifyResult, type IMKnowledgeLink, type IMMeData, type IMMemoryDigest, type IMMemoryDigestOptions, type IMMemoryFile, type IMMemoryFileDetail, type IMMemoryKnowledgeLinks, type IMMemoryLoadResult, type IMMessage, type IMMessageAttachment, type IMMessageData, type IMMultipartInitResult, type IMOwnedAgent, type IMPaginationOptions, type IMPatchRuntimeInstallationOptions, type IMPresignOptions, type IMPresignResult, type IMProject, type IMProjectMembership, type IMProjectWithCounts, IMRealtimeClient, type IMRecordOutcomeOptions, type IMRegisterData, type IMRegisterKeyOptions, type IMRegisterOptions, type IMResult, type IMRouting, type IMRuntimeInstallation, type IMSendOptions, type IMSkillContent, type IMSkillCreateInput, type IMSkillInfo, type IMSkillInstallResult, type IMSkillSearchOptions, type IMSkillUpdateInput, type IMStudioAgentSummary, type IMStudioInstalled, type IMStudioInstalledSkill, type IMStudioOverview, type IMStudioProfile, type IMTask, type IMTaskDetail, type IMTaskListOptions, type IMTaskLog, type IMTaskResult, type IMTokenData, type IMTransaction, type IMUpdateMemoryFileOptions, type IMUpdateTaskOptions, type IMUpdateWorkspaceOptions, type IMUser, type IMUserProfile, type IMWSMessage, type IMWorkspace, type IMWorkspaceData, type IMWorkspaceFile, type IMWorkspaceFileSyncResult, type IMWorkspaceInitGroupOptions, type IMWorkspaceInitOptions, type IMWorkspaceInvite, type IMWorkspaceMember, type IMWorkspaceOrchestrator, type IMWorkspaceOrchestratorEnvelope, type IMWorkspaceSyncResult, IdentityClient, type ImageMime, IndexedDBStorage, InvitesClient, type KeyManager, KnowledgeLinkClient, type KnowledgeLinkSource, type KnowledgeLinkType, type LLMBackend, type LLMDispatcher, type LLMResult, type LLMTask, type LoadOptions, type LoadResult, type LoadResultItem, MemoryClient, MemoryStorage, type MessageDeletedPayload, type MessageEditPayload, type MessageNewPayload, type MessageReactionPayload, MessagesClient, type MetricAgg, type MetricAggregateOptions, type MetricAggregateResponse, type MetricBucket, type MetricBucketResult, type MetricEmitInput, MetricsClient, type ModelEntry, type NotificationSink, type OfflineConfig, type OfflineEventMap, type OfflineEventType, OfflineManager, type OutboxOperation, type OutboxRejectionRecord, type ParseCost, type ParseCostBreakdown, type ParseDocument, type ParseDocumentImage, type ParseOptions, type ParseResult, type ParseUsage, type PongPayload, type PresenceChangedPayload, PrismerClient, type PrismerConfig, type PrismerEvent, type ProjectCreateOptions, type ProjectDeleteCascade, type ProjectListOptions, type ProjectListResult, type ProjectMemberAddOptions, ProjectMembersClient, type ProjectMembershipRole, type ProjectPrincipalKind, type ProjectStatus, type ProjectUpdateOptions, ProjectsClient, type QueryCost, type QuerySummary, type QueuedAttachment, type QueuedTask, type RankingFactors, type RealtimeCommand, type RealtimeConfig, type RealtimeEventMap, type RealtimeEventType, RealtimeSSEClient, type RealtimeState, RealtimeWSClient, type ReconnectingPayload, type RejectedHostedAgent, type RequestFn, type RequestOpts, RuntimeInstallationsClient, type RuntimePhase, type RuntimeRoute, SQLiteStorage, type SaveBatchOptions, type SaveOptions, type SaveResult, type ScheduleType, SecurityClient, type SendFileOptions, type SendFileResult, type SessionMetrics, type SignalEnrichmentConfig, type SignalTag, type SingleUrlCost, type SkillDraftCreateInput, type SkillDraftCreateResult, type SkillDraftDTO, type SkillDraftManifestFile, type SkillDraftPatchInput, type SkillDraftPatchOp, type SkillDraftRegenerateInput, type SkillDraftValidationWarning, SkillsClient, SkillsDraftClient, type StorageAdapter, type StoredContact, type StoredConversation, type StoredMessage, StudioClient, StudioEvolutionClient, type Suggestion, type SyncEvent, type SyncResult, TabCoordinator, type TaskCancelPayload, type TaskDispatchContextEntry, type TaskDispatchProgressPayload, type TaskDispatchReplyPayload, type TaskDispatchRequestPayload, type TaskEventEnvelope, type TaskEventType, type TaskExecutor, type TaskInput, type TaskKind, type TaskStatus, TasksClient, type TypingIndicatorPayload, type UploadOptions, type UploadResult, type VideoMime, WORKSPACE_ASSETS_ROUTE, type WorkspaceAssetFilters, type WorkspaceAssetRoute, type WorkspaceAssetUploadInput, type WorkspaceAssetsApiContract, type WorkspaceChangedPayload, WorkspaceClient, type WorkspaceFileChangedPayload, WorkspaceFilesClient, type WorkspaceInviteCreateOptions, type WorkspaceInvitePreview, type WorkspaceInviteRole, type WorkspaceInviteStatus, WorkspaceInvitesClient, type WorkspaceMemberAddOptions, type WorkspaceMemberRemoveResult, WorkspaceMembersClient, type WorkspaceRole, WorkspacesClient, createClient, createEnrichedExtractor, decryptContext, decryptFile, decryptMessages, decryptOnReceive, PrismerClient as default, encryptContext, encryptFile, encryptForSend, extractSignals, guessMimeType, readCardKanbanMetadata, safeSlug, writeCardKanbanMetadata };
+export { AccountClient, type AgentChangedPayload, type AgentHostDeclarePayload, type AgentProfileChangedPayload, AgentSkillsClient, type AgentStatusChangedPayload, AgentsClient, type AssetChangedPayload, type AssetDispatchObservation, type AssetDispatchStrategy, type AssetRef, AssetsClient, AttachmentQueue, type AudioMime, type AuthenticatedPayload, type BatchSummary, type BatchUrlCost, BindingsClient, type CacheManager, type Card, type CardCreateInput, type CardFilters, type CardKanbanMetadata, type CardKanbanMetadataSource, type CardKanbanStatus, type CardMetadata, type CardMove, type ChatMessage, type CommandResult, CommunityHub, type CommunityHubConfig, ContactsClient, type ContentBlock, type ContentBlockAudio, type ContentBlockFile, type ContentBlockImage, type ContentBlockInput, type ContentBlockOutput, type ContentBlockPkf, type ContentBlockPkfInput, type ContentBlockPkfOutput, type ContentBlockReasoning, type ContentBlockText, type ContentBlockToolResult, type ContentBlockToolResultInput, type ContentBlockToolResultOutput, type ContentBlockToolUse, type ContentBlockVideo, type ControlCommand, ConversationsClient, CreditsClient, CriteriaTemplatesClient, type DaemonControlPlane, type DecryptResult, type DerivationMode, DirectClient, type DisconnectedPayload, E2EEncryption, ENVIRONMENTS, type EncryptedContextResult, type EncryptedFileResult, type EncryptedMessage, type Environment, type ErrorPayload, EvolutionCache, EvolutionClient, EvolutionRuntime, type EvolutionRuntimeConfig, type EvolutionSession, EvolutionSkillsClient, type EvolutionSyncDelta, type EvolutionSyncSnapshot, type ExecutionContext, type ExecutionPolicy, type FileInput, FilesClient, type GeneCategory, type GeneSelectionResult, type GeneVisibility, GroupsClient, type HostAckedPayload, type HostedAgentDeclaration, type IMAccountDeleteResult, type IMAgentCard, type IMAgentCatalogCapability, type IMAgentCatalogEntry, type IMAgentDiscoverOptions, type IMAgentForkOptions, type IMAgentForkResult, type IMAgentPack, type IMAgentPackListOptions, type IMAgentPersonality, type IMAgentPublishOptions, type IMAgentRestoreOptions, type IMAgentSkillAckInput, type IMAgentSkillInstallOptions, type IMAgentSkillListOptions, type IMAgentSkillRecord, type IMAgentSnapshot, type IMAgentSnapshotOptions, type IMAgentSpec, type IMAgentStatus, type IMAnalyzeOptions, type IMAnalyzeResult, type IMAsset, type IMAssetDetail, type IMAssetListOptions, type IMAssetPreviewContract, type IMAssetPreviewKind, type IMAssetPreviewStatus, type IMAssetRevision, type IMAssetRevisionList, type IMAssetUploadOptions, type IMAutocompleteResult, type IMBinding, type IMBindingData, type IMBlockedUser, type IMCapsule, IMClient, type IMCompactOptions, type IMCompactionSummary, type IMCompleteTaskOptions, type IMConfirmResult, type IMContact, type IMConversation, type IMConversationsOptions, type IMCreateBindingOptions, type IMCreateGeneOptions, type IMCreateGroupOptions, type IMCreateMemoryFileOptions, type IMCreateRuntimeInstallationOptions, type IMCreateTaskOptions, type IMCreateWorkspaceFileOptions, type IMCreateWorkspaceOptions, type IMCreditsData, type IMDiscoverAgent, type IMDiscoverOptions, type IMEvolutionEdge, type IMEvolutionStats, type IMFileQuota, type IMForkGeneOptions, type IMFriendRequest, type IMGene, type IMGeneListOptions, type IMGroupData, type IMGroupMember, type IMIdentityKey, type IMInstallAgentOnRuntimeOptions, type IMInstallAgentOnRuntimeResult, type IMKeyAuditEntry, type IMKeyVerifyResult, type IMKnowledgeLink, type IMMeData, type IMMemoryDigest, type IMMemoryDigestOptions, type IMMemoryFile, type IMMemoryFileDetail, type IMMemoryKnowledgeLinks, type IMMemoryLoadResult, type IMMessage, type IMMessageAttachment, type IMMessageData, type IMMultipartInitResult, type IMOwnedAgent, type IMPaginationOptions, type IMPatchRuntimeInstallationOptions, type IMPresignOptions, type IMPresignResult, type IMProject, type IMProjectMembership, type IMProjectWithCounts, IMRealtimeClient, type IMRecordOutcomeOptions, type IMRegisterData, type IMRegisterKeyOptions, type IMRegisterOptions, type IMResult, type IMRouting, type IMRuntimeInstallation, type IMSendOptions, type IMSkillContent, type IMSkillCreateInput, type IMSkillInfo, type IMSkillInstallResult, type IMSkillSearchOptions, type IMSkillUpdateInput, type IMStudioAgentSummary, type IMStudioInstalled, type IMStudioInstalledSkill, type IMStudioOverview, type IMStudioProfile, type IMTask, type IMTaskDetail, type IMTaskListOptions, type IMTaskLog, type IMTaskResult, type IMTokenData, type IMTransaction, type IMUpdateMemoryFileOptions, type IMUpdateTaskOptions, type IMUpdateWorkspaceOptions, type IMUser, type IMUserProfile, type IMWSMessage, type IMWorkspace, type IMWorkspaceCreateAgentOptions, type IMWorkspaceData, type IMWorkspaceFile, type IMWorkspaceFileSyncResult, type IMWorkspaceInitGroupOptions, type IMWorkspaceInitOptions, type IMWorkspaceInvite, type IMWorkspaceMember, type IMWorkspaceOrchestrator, type IMWorkspaceOrchestratorEnvelope, type IMWorkspaceSyncResult, IdentityClient, type ImageMime, IndexedDBStorage, InvitesClient, type KeyManager, KnowledgeLinkClient, type KnowledgeLinkSource, type KnowledgeLinkType, type LLMBackend, type LLMDispatcher, type LLMResult, type LLMTask, type LoadOptions, type LoadResult, type LoadResultItem, MemoryClient, MemoryStorage, type MessageDeletedPayload, type MessageEditPayload, type MessageNewPayload, type MessageReactionPayload, MessagesClient, type MetricAgg, type MetricAggregateOptions, type MetricAggregateResponse, type MetricBucket, type MetricBucketResult, type MetricEmitInput, type MetricEventRow, type MetricEventsOptions, type MetricEventsResponse, MetricsClient, type ModelEntry, type NotificationSink, type OfflineConfig, type OfflineEventMap, type OfflineEventType, OfflineManager, type OutboxOperation, type OutboxRejectionRecord, type ParseCost, type ParseCostBreakdown, type ParseDocument, type ParseDocumentImage, type ParseOptions, type ParseResult, type ParseUsage, type PkfApiEnvelope, type PkfArtifactGraphView, type PkfArtifactRelationView, type PkfArtifactRelationsQuery, type PkfArtifactRootKind, type PkfBundleCommitRequest, type PkfBundleCommitView, type PkfBundleReadQuery, type PkfBundleResourceUsage, type PkfCarrierMaterializationTarget, type PkfCarrierMaterializationView, type PkfCarrierMaterializeRequest, PkfClient, type PkfMaterializationDiscoveryQuery, type PkfMaterializationQuery, type PkfMaterializationReadQuery, type PkfMessageSourceLocator, type PkfResourceDetailView, type PkfResourceReadQuery, type PongPayload, type PresenceChangedPayload, PrismerClient, type PrismerConfig, type PrismerEvent, type ProjectCreateOptions, type ProjectDeleteCascade, type ProjectListOptions, type ProjectListResult, type ProjectMemberAddOptions, ProjectMembersClient, type ProjectMembershipRole, type ProjectPrincipalKind, type ProjectStatus, type ProjectUpdateOptions, ProjectsClient, type QueryCost, type QuerySummary, type QueuedAttachment, type QueuedTask, type RankingFactors, type RealtimeCommand, type RealtimeConfig, type RealtimeEventMap, type RealtimeEventType, RealtimeSSEClient, type RealtimeState, RealtimeWSClient, type ReconnectingPayload, type RejectedHostedAgent, type RequestFn, type RequestOpts, RuntimeInstallationsClient, type RuntimePhase, type RuntimeRoute, SQLiteStorage, type SaveBatchOptions, type SaveOptions, type SaveResult, type ScheduleType, SecurityClient, type SendFileOptions, type SendFileResult, type SessionMetrics, type SignalEnrichmentConfig, type SignalTag, type SingleUrlCost, type SkillDraftCreateInput, type SkillDraftCreateResult, type SkillDraftDTO, type SkillDraftManifestFile, type SkillDraftPatchInput, type SkillDraftPatchOp, type SkillDraftRegenerateInput, type SkillDraftValidationWarning, SkillsClient, SkillsDraftClient, type StorageAdapter, type StoredContact, type StoredConversation, type StoredMessage, StudioClient, StudioEvolutionClient, type Suggestion, type SyncEvent, type SyncResult, TabCoordinator, type TaskCancelPayload, type TaskDispatchContextEntry, type TaskDispatchProgressPayload, type TaskDispatchReplyPayload, type TaskDispatchRequestPayload, type TaskDurabilityPageReceipt, type TaskDurabilityResult, type TaskEventEnvelope, type TaskEventType, type TaskExecutor, type TaskInput, type TaskKind, type TaskStatus, TasksClient, type TurnMetricsSummary, type TurnScope, type TurnSummaryOptions, type TypingIndicatorPayload, type UploadOptions, type UploadResult, type VideoMime, WORKSPACE_ASSETS_ROUTE, type WorkspaceAssetFilters, type WorkspaceAssetRoute, type WorkspaceAssetUploadInput, type WorkspaceAssetsApiContract, type WorkspaceChangedPayload, WorkspaceClient, type WorkspaceFileChangedPayload, WorkspaceFilesClient, type WorkspaceInviteCreateOptions, type WorkspaceInvitePreview, type WorkspaceInviteRole, type WorkspaceInviteStatus, WorkspaceInvitesClient, type WorkspaceMemberAddOptions, type WorkspaceMemberRemoveResult, WorkspaceMembersClient, type WorkspaceRole, WorkspacesClient, createClient, createEnrichedExtractor, decryptContext, decryptFile, decryptMessages, decryptOnReceive, PrismerClient as default, encryptContext, encryptFile, encryptForSend, extractSignals, guessMimeType, readCardKanbanMetadata, safeSlug, writeCardKanbanMetadata };