@neta-art/cohub-protocol 1.2.3 → 1.4.0

package/dist/fs/index.d.ts

@@ -54,10 +54,52 @@ export type SpaceFsUploadEntry = {
 };
 export type SpaceFsUploadError = {
     name: string;
-    code: "file_too_large" | "name_invalid" | "write_failed";
+    code: "file_too_large" | "name_invalid" | "path_invalid" | "write_failed" | "object_missing";
     message: string;
 };
 export type SpaceFsUploadResponse = {
     uploaded: SpaceFsUploadEntry[];
     errors: SpaceFsUploadError[];
 };
+export type SpaceFsUploadPlanEntryInput = {
+    id: string;
+    name: string;
+    relativePath: string;
+    size: number;
+    mimeType?: string | null;
+    lastModified?: number;
+};
+export type SpaceFsCreateUploadInput = {
+    targetDir?: string;
+    entries: SpaceFsUploadPlanEntryInput[];
+};
+export type SpaceFsUploadPlanEntry = {
+    id: string;
+    objectKey: string;
+    uploadUrl: string;
+    headers?: Record<string, string>;
+};
+export type SpaceFsCreateUploadResponse = {
+    uploadId: string;
+    expiresAt: string;
+    entries: SpaceFsUploadPlanEntry[];
+};
+export type SpaceFsCompleteUploadInput = {
+    entries: Array<{
+        id: string;
+        etag?: string | null;
+    }>;
+};
+export type SpaceFsCompleteUploadResponse = {
+    ok: true;
+    taskRunId: string;
+};
+export type SpaceFsUploadProgress = {
+    phase: "queued" | "importing" | "done" | "failed";
+    totalFiles: number;
+    importedFiles: number;
+    totalBytes: number;
+    importedBytes: number;
+    currentPath?: string;
+    errors: SpaceFsUploadError[];
+};

package/dist/model/session.d.ts

@@ -84,6 +84,11 @@ export type SessionRecord = {
     createdAt: string;
     updatedAt: string;
 };
+export type MessageAuthorProfile = {
+    userUuid: string;
+    displayName: string;
+    avatarUrl: string | null;
+};
 export type MessageRecord = {
     id: string;
     sessionId: string;
@@ -97,5 +102,7 @@ export type MessageRecord = {
     errorMessage: string | null;
     usage: Usage | null;
     meta: Record<string, unknown> | null;
+    authorUuid?: string | null;
+    authorProfile?: MessageAuthorProfile | null;
     createdAt: string;
 };

package/dist/model/turn.d.ts

@@ -5,6 +5,8 @@ export type SessionTurnIntent = "steer" | "followup";
 export type SessionTurnSummary = {
     text?: string | null;
     finishReason?: "completed" | "failed" | "interrupted";
+    reason?: "steer" | "abort" | string;
+    continuedByTurnId?: string | null;
     interruptedByTurnId?: string | null;
 };
 export type SessionTurnIntermediateIndex = {
@@ -75,9 +77,15 @@ export type SessionTurnIndexItem = {
     assistantPreview: string | null;
     provider: string | null;
     model: string | null;
-    usage: Usage | null;
+    finalUsage: Usage | null;
+    totalUsage: Usage | null;
     errorMessage: string | null;
 };
+export type SessionTurnAuthorProfile = {
+    userUuid: string;
+    displayName: string;
+    avatarUrl: string | null;
+};
 export type SessionTurnRecord = {
     id: string;
     sessionId: string;
@@ -93,11 +101,13 @@ export type SessionTurnRecord = {
     model: string | null;
     stopReason: string | null;
     errorMessage: string | null;
-    usage: Usage | null;
+    finalUsage: Usage | null;
+    totalUsage: Usage | null;
     summary: SessionTurnSummary | null;
     intermediateIndex: SessionTurnIntermediateIndex | null;
     intermediateSummary: SessionTurnIntermediateSummary | null;
     meta: Record<string, unknown> | null;
+    authorProfile?: SessionTurnAuthorProfile | null;
     startedAt: string | null;
     completedAt: string | null;
     createdAt: string;

package/dist/realtime/websocket.d.ts

@@ -269,6 +269,8 @@ export type SessionRequestAcceptedEvent = {
     sessionId: string;
     payload: {
         clientMessageId?: string | null;
+        turnId?: string | null;
+        userMessageId?: string | null;
     };
 };
 export type SessionRequestErrorEvent = {
@@ -324,6 +326,17 @@ export type RealtimePatchOperation = {
     o?: undefined;
     p?: undefined;
 };
+export type RealtimePatchIdentityInput = {
+    turnId?: unknown;
+    messageId?: unknown;
+    sourceMessageId?: unknown;
+    anchorUserMessageId?: unknown;
+    messageOrdinal?: unknown;
+    sessionId?: unknown;
+};
+export declare const getSessionTurnPatchStreamKey: (input: RealtimePatchIdentityInput, options?: {
+    includeSessionFallback?: boolean;
+}) => string | null;
 export type SessionTurnPatchEvent = {
     id: string;
     timestamp: number;
@@ -336,6 +349,7 @@ export type SessionTurnPatchEvent = {
         turnId: string | null;
         messageId: string | null;
         messageOrdinal?: number | null;
+        sourceMessageId?: string | null;
         anchorUserMessageId: string | null;
         seq: number;
         baseSeq: number;
@@ -374,11 +388,12 @@ export type SessionTurnErrorEvent = {
     spaceId: string;
     sessionId: string;
     payload: {
+        turnId?: string | null;
         anchorUserMessageId: string | null;
         error: string;
     };
 };
-export type RealtimeTurnRecord = Partial<Pick<SessionTurnRecord, "id" | "sessionId" | "sequence" | "status" | "intent" | "userUuid" | "userText" | "assistantText" | "provider" | "model" | "stopReason" | "errorMessage" | "usage" | "summary" | "intermediateIndex" | "intermediateSummary" | "startedAt" | "completedAt" | "createdAt" | "updatedAt">>;
+export type RealtimeTurnRecord = Partial<Pick<SessionTurnRecord, "id" | "sessionId" | "sequence" | "status" | "intent" | "userUuid" | "authorProfile" | "userText" | "assistantText" | "provider" | "model" | "stopReason" | "errorMessage" | "finalUsage" | "totalUsage" | "summary" | "intermediateIndex" | "intermediateSummary" | "startedAt" | "completedAt" | "createdAt" | "updatedAt">>;
 export type SessionTurnUpdatedEvent = {
     id: string;
     timestamp: number;

package/dist/realtime/websocket.js

@@ -105,3 +105,19 @@ export const realtimeCompactFrameSchema = z.discriminatedUnion("t", [
         v: z.unknown().optional(),
     }),
 ]);
+const getNonEmptyString = (value) => typeof value === "string" && value.trim() ? value : null;
+export const getSessionTurnPatchStreamKey = (input, options = {}) => {
+    const turnId = getNonEmptyString(input.turnId);
+    const messageKey = getNonEmptyString(input.messageId) ??
+        getNonEmptyString(input.sourceMessageId) ??
+        getNonEmptyString(input.anchorUserMessageId) ??
+        (typeof input.messageOrdinal === "number" && Number.isFinite(input.messageOrdinal)
+            ? `ordinal:${input.messageOrdinal}`
+            : null);
+    if (turnId && messageKey)
+        return `${turnId}:${messageKey}`;
+    const streamKey = messageKey ?? turnId;
+    if (streamKey)
+        return streamKey;
+    return options.includeSessionFallback ? getNonEmptyString(input.sessionId) : null;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-protocol",
-  "version": "1.2.3",
+  "version": "1.4.0",
   "description": "Shared protocol definitions for the Cohub agent collaboration platform.",
   "license": "UNLICENSED",
   "private": false,

package/dist/gateway.d.ts

@@ -1,136 +0,0 @@
-export type ChannelProvider = "web" | "websocket" | "discord" | "feishu" | "telegram" | "slack";
-export declare function buildSessionSourceChannel(event: GatewayInboundEvent): string;
-export interface DiscordChannelConfig {
-    inbound?: {
-        requireMentionInGuild?: boolean;
-    };
-    outbound?: {
-        showThinking?: boolean;
-        showToolCalls?: boolean;
-    };
-}
-export type ChannelConfig = DiscordChannelConfig | FeishuChannelConfig | Record<string, unknown>;
-export interface FeishuChannelConfig {
-    brand?: "feishu" | "lark";
-    inbound?: {
-        requireMentionInGroup?: boolean;
-    };
-    outbound?: {
-        renderMode?: "card" | "post";
-        showThinking?: boolean;
-        showToolCalls?: boolean;
-    };
-}
-export interface GatewayInboundEvent {
-    eventId: string;
-    timestamp: number;
-    eventType?: "message_create" | "conversation_create";
-    channelId: string;
-    provider: ChannelProvider;
-    externalChatId: string;
-    externalMessageId: string;
-    bindingKey?: string;
-    conversation: {
-        id: string;
-        parentId?: string | null;
-        meta?: Record<string, unknown> | null;
-    };
-    message?: {
-        parentMessageId?: string | null;
-        meta?: Record<string, unknown> | null;
-    };
-    sender: {
-        id: string;
-        name?: string;
-    };
-    content: import("./session-ingestion.js").ContentBlock[];
-    meta?: Record<string, unknown> | null;
-}
-export interface GatewaySessionOutputBase {
-    type: "session.turn.progress" | "session.turn.final" | "session.turn.error" | "session.message.persisted";
-    spaceId: string;
-    sessionId: string;
-}
-export interface GatewaySessionTurnProgressOutput extends GatewaySessionOutputBase {
-    type: "session.turn.progress";
-    anchorUserMessageId: string | null;
-    content: import("./session-ingestion.js").ContentBlock[];
-}
-export interface GatewaySessionTurnFinalOutput extends GatewaySessionOutputBase {
-    type: "session.turn.final";
-    sessionMessageId: string | null;
-    anchorUserMessageId: string | null;
-    content: import("./session-ingestion.js").ContentBlock[];
-}
-export interface GatewaySessionTurnErrorOutput extends GatewaySessionOutputBase {
-    type: "session.turn.error";
-    anchorUserMessageId: string | null;
-    error: string;
-}
-export interface GatewaySessionMessagePersistedOutput extends GatewaySessionOutputBase {
-    type: "session.message.persisted";
-    message: import("./session-ingestion.js").MessageRecord;
-}
-export type GatewaySessionOutput = GatewaySessionTurnProgressOutput | GatewaySessionTurnFinalOutput | GatewaySessionTurnErrorOutput | GatewaySessionMessagePersistedOutput;
-export interface DiscordDeliveryPlan {
-    adapter: "discord";
-    mode: "send" | "upsert";
-    primaryText: string;
-    continuationChunks: string[];
-    files: string[];
-    replyToExternalMessageId?: string;
-    turnAnchorMessageId?: string | null;
-    preferredEditExternalMessageId?: string | null;
-}
-export interface FeishuDeliveryPlan {
-    adapter: "feishu";
-    mode: "create_or_update";
-    renderMode: "card" | "post";
-    msgType: "interactive" | "post";
-    content: string;
-    imageKeys: string[];
-    replyToExternalMessageId?: string;
-    turnAnchorMessageId?: string | null;
-    preferredEditExternalMessageId?: string | null;
-}
-export type GatewayDeliveryPlan = DiscordDeliveryPlan | FeishuDeliveryPlan;
-export interface GatewayOutboundCommand {
-    commandId: string;
-    timestamp: number;
-    channelId: string;
-    provider: ChannelProvider;
-    externalChatId: string;
-    content: import("./session-ingestion.js").ContentBlock[];
-    replyToExternalMessageId?: string;
-    spaceId?: string;
-    spaceSessionId?: string;
-    sessionMessageId?: string;
-    deliveryPlan?: GatewayDeliveryPlan | null;
-    meta?: (Record<string, unknown> & {
-        sessionOutput?: GatewaySessionOutput | null;
-    }) | null;
-}
-export interface GatewayControlCommand {
-    action: "connect" | "disconnect" | "reload";
-    configs: {
-        channelId: string;
-        provider: ChannelProvider;
-        credentials: Record<string, unknown>;
-    }[];
-}
-export type GatewayLogDirection = "inbound" | "outbound";
-export type GatewayLogStatus = "pending" | "success" | "failed";
-export interface GatewayLogEvent {
-    logId: string;
-    timestamp: number;
-    direction: GatewayLogDirection;
-    provider: ChannelProvider;
-    channelId: string;
-    externalChatId: string;
-    externalMessageId?: string;
-    rawPayload: Record<string, unknown>;
-    normalizedPayload?: Record<string, unknown>;
-    status: GatewayLogStatus;
-    errorMessage?: string;
-    correlationId?: string;
-}

package/dist/gateway.js

@@ -1,48 +0,0 @@
-export function buildSessionSourceChannel(event) {
-    const provider = event.provider;
-    const meta = (event.conversation?.meta ?? event.meta ?? {});
-    switch (provider) {
-        case "discord":
-            return buildDiscordSourceChannel(event, meta);
-        case "feishu":
-            return buildFeishuSourceChannel(event, meta);
-        case "web":
-            return "web";
-        default:
-            return `${provider}:${event.conversation?.id?.trim() || event.externalChatId}`;
-    }
-}
-function buildDiscordSourceChannel(event, meta) {
-    const isDm = meta.isDm === true;
-    const guildName = typeof meta.guildName === "string" ? meta.guildName : null;
-    const channelName = typeof meta.channelName === "string" ? meta.channelName : null;
-    const parentChannelName = typeof meta.parentChannelName === "string" ? meta.parentChannelName : null;
-    const threadName = typeof meta.threadName === "string" ? meta.threadName : null;
-    const senderName = event.sender?.name ?? null;
-    if (isDm) {
-        return `discord:dm:${senderName ?? event.sender.id}`;
-    }
-    if (threadName && parentChannelName && guildName) {
-        return `discord:${guildName}:#${parentChannelName}>${threadName}`;
-    }
-    if (channelName && guildName) {
-        return `discord:${guildName}:#${channelName}`;
-    }
-    if (guildName) {
-        return `discord:${guildName}`;
-    }
-    return `discord:${event.conversation?.id?.trim() || event.externalChatId}`;
-}
-function buildFeishuSourceChannel(event, meta) {
-    const chatType = meta.chatType;
-    const chatName = typeof meta.chatName === "string" ? meta.chatName : null;
-    const senderName = event.sender?.name ?? null;
-    const isDm = chatType === "p2p";
-    if (isDm) {
-        return `feishu:dm:${senderName ?? event.sender.id}`;
-    }
-    if (chatName) {
-        return `feishu:group:${chatName}`;
-    }
-    return `feishu:${event.conversation?.id?.trim() || event.externalChatId}`;
-}

package/dist/permissions.d.ts

@@ -1,8 +0,0 @@
-/**
- * Permission level for space / session resources.
- *
- * - `read`   — anyone can read (including anonymous users)
- * - `write`  — anyone can read and write
- * - `private` — explicitly deny access (no fallback to parent)
- */
-export type ResourcePermissionLevel = "read" | "write" | "private";

package/dist/permissions.js

@@ -1 +0,0 @@
-export {};

package/dist/responses.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/responses.js

@@ -1,4 +0,0 @@
-export {};
-// Responses API has been removed.
-// Sessions now work via simple POST /sessions/:id/messages.
-// Frontend live updates are delivered via Gateway WebSocket.

package/dist/session-ingestion.d.ts

@@ -1,158 +0,0 @@
-export type ContentBlockMeta = Record<string, unknown>;
-export type ContentBlock = {
-    type: "text";
-    text: string;
-    _meta?: ContentBlockMeta;
-} | {
-    type: "thinking";
-    thinking: string;
-    signature?: string;
-    _meta?: ContentBlockMeta;
-} | {
-    type: "image";
-    source: {
-        type: "url";
-        url: string;
-    } | {
-        type: "base64";
-        media_type: string;
-        data: string;
-    };
-    _meta?: ContentBlockMeta;
-} | {
-    type: "tool_use";
-    id: string;
-    name: string;
-    input: Record<string, unknown>;
-    _meta?: ContentBlockMeta;
-} | {
-    type: "tool_result";
-    tool_use_id: string;
-    content: string | ContentBlock[];
-    is_error?: boolean;
-    _meta?: ContentBlockMeta;
-} | {
-    type: "system_note";
-    note_type: "session_created" | "forked" | "compacted" | "info";
-    text: string;
-    _meta?: ContentBlockMeta;
-};
-export type SessionPromptInput = {
-    spaceId: string;
-    sessionId: string;
-    userMessageId?: string | null;
-    message: {
-        content: ContentBlock[];
-    };
-    meta?: {
-        source?: string;
-        intent?: "auto" | "continue" | "new_session" | "fork";
-        model?: string;
-        provider?: string;
-    } | null;
-};
-export type RegisterSessionInput = {
-    spaceId: string;
-    sessionId: string;
-    title?: string | null;
-    source?: string | null;
-    externalSessionId?: string | null;
-    meta?: Record<string, unknown> | null;
-};
-export type PersistMessageInput = {
-    spaceId: string;
-    sessionId: string;
-    previousMessageId?: string | null;
-    anchorUserMessageId?: string | null;
-    idempotencyKey: string;
-    message: {
-        role?: "user" | "assistant" | "system";
-        externalMessageId?: string | null;
-        protocolMessageId?: string | null;
-        content: ContentBlock[];
-        text?: string | null;
-        provider?: string | null;
-        model?: string | null;
-        stopReason?: string | null;
-        errorMessage?: string | null;
-        meta?: Record<string, unknown> | null;
-        usage?: {
-            input?: number;
-            output?: number;
-            costTotal?: number;
-        } | null;
-    };
-};
-export type UpdateSessionInfoInput = {
-    spaceId: string;
-    sessionId: string;
-    title?: string | null;
-    updatedAt?: string | null;
-    meta?: Record<string, unknown> | null;
-};
-export type SessionStreamEvent = {
-    type: "stream_update";
-    spaceId: string;
-    sessionId: string;
-    /** `content` always contains delta blocks to be merged into the current streaming state. */
-    content: ContentBlock[];
-    sourceMessageId: string | null;
-    timestamp: number;
-    turnEnd?: boolean;
-    anchorUserMessageId?: string | null;
-};
-export type SessionStreamError = {
-    type: "error";
-    spaceId: string;
-    sessionId: string | null;
-    error: string;
-};
-export type SessionBindingRecord = {
-    id: string;
-    spaceId: string;
-    spaceSessionId: string;
-    spaceChannelId: string;
-    provider: string;
-    bindingKey: string;
-    externalChatId: string;
-    status: string | null;
-    meta: Record<string, unknown> | null;
-    createdAt: string;
-    updatedAt: string;
-    lastMessageAt: string | null;
-};
-export type SessionRecord = {
-    id: string;
-    spaceId: string;
-    title: string | null;
-    source: string | null;
-    status: string | null;
-    externalSessionId: string | null;
-    meta: Record<string, unknown> | null;
-    parentSessionId: string | null;
-    forkedFromMessageId: string | null;
-    lineageRootSessionId: string | null;
-    forkDepth: number;
-    latestMessageText: string | null;
-    lastMessageAt: string | null;
-    lastMessageId: string | null;
-    createdAt: string;
-    updatedAt: string;
-};
-export type MessageRecord = {
-    id: string;
-    sessionId: string;
-    role: "user" | "assistant" | "system";
-    content: ContentBlock[];
-    text: string | null;
-    sequence: number;
-    provider: string | null;
-    model: string | null;
-    stopReason: string | null;
-    errorMessage: string | null;
-    usageInput: number | null;
-    usageOutput: number | null;
-    costTotal: string | null;
-    meta: Record<string, unknown> | null;
-    createdAt: string;
-};

package/dist/session-ingestion.js

@@ -1,2 +0,0 @@
-// ─── Content Block — Anthropic-style, single source of truth ───
-export {};

package/dist/space-fs.d.ts

@@ -1,33 +0,0 @@
-export type SpaceFsEntry = {
-    name: string;
-    path: string;
-    type: "file" | "dir" | "symlink";
-    size: number;
-    mimeType: string | null;
-    mtimeMs: number;
-};
-export type SpaceFsTreeResponse = {
-    path: string;
-    entries: SpaceFsEntry[];
-};
-export type SpaceFsFileKind = "text" | "binary";
-export type SpaceFsEncoding = "utf-8" | "base64";
-export type SpaceFsFileResponse = {
-    path: string;
-    name: string;
-    size: number;
-    mimeType: string | null;
-    mtimeMs: number;
-    kind: SpaceFsFileKind;
-    encoding: SpaceFsEncoding;
-    content: string;
-};
-export type SpaceFsWriteFileInput = {
-    path: string;
-    content: string;
-    encoding: SpaceFsEncoding;
-};
-export type SpaceFsMoveInput = {
-    fromPath: string;
-    toPath: string;
-};

package/dist/space-fs.js

@@ -1 +0,0 @@
-export {};

package/dist/space-sandbox.d.ts

@@ -1,7 +0,0 @@
-/**
- * Space sandbox lifecycle status.
- *
- * Internal infrastructure state only.
- * Not intended as a primary user-facing concept.
- */
-export type SpaceSandboxStatus = "pending" | "provisioning" | "ready" | "stopped" | "error" | "terminated";

package/dist/space-sandbox.js

@@ -1 +0,0 @@
-export {};

package/dist/tasks.d.ts

@@ -1,45 +0,0 @@
-/**
- * Task system protocol definitions.
- * Shared between API (scheduler) and Worker (executor).
- */
-/**
- * Task type identifier.
- * Open-ended — add new types as needed.
- */
-export type TaskType = string;
-/**
- * Universal task payload carried by every BullMQ job.
- * Fields like spaceId / sessionId are optional
- * so tasks can be scoped or global.
- */
-export interface TaskPayload {
-    type: TaskType;
-    /** Optional: which space this task relates to */
-    spaceId?: string;
-    /** Optional: which session this task relates to */
-    sessionId?: string;
-    /** Optional: the user who owns / triggered this task */
-    userId?: string;
-    /** Optional: cron job that spawned this execution (set by API on enqueue) */
-    cronJobId?: string;
-    /** Task-specific parameters */
-    data?: Record<string, unknown>;
-}
-/**
- * Task run status in the database.
- *
- * Flow:
- *   pending (API-enqueued only)
- *     → running (worker picked up)
- *       → completed | failed
- */
-export type TaskRunStatus = "pending" | "running" | "completed" | "failed";
-/**
- * Cron schedule configuration passed from the client.
- */
-export interface TaskScheduleConfig {
-    /** Cron expression, e.g. "0 10 * * *" */
-    pattern: string;
-    /** IANA timezone, defaults to "Asia/Shanghai" */
-    timezone?: string;
-}

package/dist/tasks.js

@@ -1,5 +0,0 @@
-/**
- * Task system protocol definitions.
- * Shared between API (scheduler) and Worker (executor).
- */
-export {};

package/dist/websocket.d.ts

@@ -1,299 +0,0 @@
-import { z } from "zod";
-import type { ContentBlock, MessageRecord } from "./session-ingestion.js";
-export declare const contentBlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"text">;
-    text: z.ZodString;
-    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"thinking">;
-    thinking: z.ZodString;
-    signature: z.ZodOptional<z.ZodString>;
-    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"image">;
-    source: z.ZodUnion<readonly [z.ZodObject<{
-        type: z.ZodLiteral<"url">;
-        url: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        type: z.ZodLiteral<"base64">;
-        media_type: z.ZodString;
-        data: z.ZodString;
-    }, z.core.$strip>]>;
-    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"tool_use">;
-    id: z.ZodString;
-    name: z.ZodString;
-    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"tool_result">;
-    tool_use_id: z.ZodString;
-    content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnknown>]>;
-    is_error: z.ZodOptional<z.ZodBoolean>;
-    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"system_note">;
-    note_type: z.ZodEnum<{
-        session_created: "session_created";
-        forked: "forked";
-        compacted: "compacted";
-        info: "info";
-    }>;
-    text: z.ZodString;
-    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>], "type">;
-export declare const wsClientEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"auth">;
-    requestId: z.ZodOptional<z.ZodString>;
-    payload: z.ZodObject<{
-        token: z.ZodString;
-    }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"session.message.create">;
-    requestId: z.ZodOptional<z.ZodString>;
-    payload: z.ZodObject<{
-        spaceId: z.ZodString;
-        sessionId: z.ZodString;
-        clientMessageId: z.ZodOptional<z.ZodString>;
-        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            type: z.ZodLiteral<"text">;
-            text: z.ZodString;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"thinking">;
-            thinking: z.ZodString;
-            signature: z.ZodOptional<z.ZodString>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"image">;
-            source: z.ZodUnion<readonly [z.ZodObject<{
-                type: z.ZodLiteral<"url">;
-                url: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                type: z.ZodLiteral<"base64">;
-                media_type: z.ZodString;
-                data: z.ZodString;
-            }, z.core.$strip>]>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"tool_use">;
-            id: z.ZodString;
-            name: z.ZodString;
-            input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"tool_result">;
-            tool_use_id: z.ZodString;
-            content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnknown>]>;
-            is_error: z.ZodOptional<z.ZodBoolean>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"system_note">;
-            note_type: z.ZodEnum<{
-                session_created: "session_created";
-                forked: "forked";
-                compacted: "compacted";
-                info: "info";
-            }>;
-            text: z.ZodString;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>], "type">>;
-        model: z.ZodOptional<z.ZodString>;
-        provider: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"ping">;
-    requestId: z.ZodOptional<z.ZodString>;
-    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"ack">;
-    requestId: z.ZodOptional<z.ZodString>;
-    payload: z.ZodOptional<z.ZodObject<{
-        eventId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>], "type">;
-export declare const realtimeEnvelopeSchema: z.ZodObject<{
-    id: z.ZodString;
-    timestamp: z.ZodNumber;
-    domain: z.ZodEnum<{
-        system: "system";
-        session: "session";
-        space: "space";
-    }>;
-    type: z.ZodString;
-    requestId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    spaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, z.core.$strip>;
-export type { ContentBlock };
-export type WsClientEvent = {
-    type: "auth";
-    requestId?: string;
-    payload: {
-        token: string;
-    };
-} | {
-    type: "session.message.create";
-    requestId?: string;
-    payload: {
-        spaceId: string;
-        sessionId: string;
-        clientMessageId?: string;
-        content: ContentBlock[];
-        model?: string;
-        provider?: string;
-    };
-} | {
-    type: "ping";
-    requestId?: string;
-    payload?: Record<string, unknown>;
-} | {
-    type: "ack";
-    requestId?: string;
-    payload?: {
-        eventId?: string;
-    };
-};
-export type RealtimeEnvelope = z.output<typeof realtimeEnvelopeSchema>;
-export type RealtimeEnvelopeBase = RealtimeEnvelope;
-export type RealtimeDomain = RealtimeEnvelopeBase["domain"];
-export type SystemReadyEvent = {
-    id: string;
-    timestamp: number;
-    domain: "system";
-    type: "system.ready";
-    requestId?: string | null;
-    spaceId?: string | null;
-    sessionId?: string | null;
-    payload: {
-        connectionId: string;
-    };
-};
-export type SystemAuthOkEvent = {
-    id: string;
-    timestamp: number;
-    domain: "system";
-    type: "system.auth.ok";
-    requestId?: string | null;
-    spaceId?: string | null;
-    sessionId?: string | null;
-    payload: {
-        connectionId: string;
-        user: Record<string, unknown>;
-    };
-};
-export type SystemRequestErrorEvent = {
-    id: string;
-    timestamp: number;
-    domain: "system";
-    type: "system.request.error";
-    requestId?: string | null;
-    spaceId?: string | null;
-    sessionId?: string | null;
-    payload: {
-        code: string;
-        message: string;
-    };
-};
-export type SystemPongEvent = {
-    id: string;
-    timestamp: number;
-    domain: "system";
-    type: "system.pong";
-    requestId?: string | null;
-    spaceId?: string | null;
-    sessionId?: string | null;
-    payload: Record<string, never>;
-};
-export type SystemAckOkEvent = {
-    id: string;
-    timestamp: number;
-    domain: "system";
-    type: "system.ack.ok";
-    requestId?: string | null;
-    spaceId?: string | null;
-    sessionId?: string | null;
-    payload: Record<string, never>;
-};
-export type SessionRequestAcceptedEvent = {
-    id: string;
-    timestamp: number;
-    domain: "session";
-    type: "session.request.accepted";
-    requestId?: string | null;
-    spaceId: string;
-    sessionId: string;
-    payload: {
-        clientMessageId?: string | null;
-    };
-};
-export type SessionRequestErrorEvent = {
-    id: string;
-    timestamp: number;
-    domain: "session";
-    type: "session.request.error";
-    requestId?: string | null;
-    spaceId?: string | null;
-    sessionId?: string | null;
-    payload: {
-        code: string;
-        message: string;
-        clientMessageId?: string | null;
-    };
-};
-export type SessionTurnProgressEvent = {
-    id: string;
-    timestamp: number;
-    domain: "session";
-    type: "session.turn.progress";
-    requestId?: string | null;
-    spaceId: string;
-    sessionId: string;
-    payload: {
-        anchorUserMessageId: string | null;
-        content: ContentBlock[];
-    };
-};
-export type SessionTurnFinalEvent = {
-    id: string;
-    timestamp: number;
-    domain: "session";
-    type: "session.turn.final";
-    requestId?: string | null;
-    spaceId: string;
-    sessionId: string;
-    payload: {
-        sessionMessageId: string | null;
-        anchorUserMessageId: string | null;
-        content: ContentBlock[];
-    };
-};
-export type SessionTurnErrorEvent = {
-    id: string;
-    timestamp: number;
-    domain: "session";
-    type: "session.turn.error";
-    requestId?: string | null;
-    spaceId: string;
-    sessionId: string;
-    payload: {
-        anchorUserMessageId: string | null;
-        error: string;
-    };
-};
-export type SessionMessagePersistedEvent = {
-    id: string;
-    timestamp: number;
-    domain: "session";
-    type: "session.message.persisted";
-    requestId?: string | null;
-    spaceId: string;
-    sessionId: string;
-    payload: {
-        message: MessageRecord;
-    };
-};
-export type RealtimeServerEvent = SystemReadyEvent | SystemAuthOkEvent | SystemRequestErrorEvent | SystemPongEvent | SystemAckOkEvent | SessionRequestAcceptedEvent | SessionRequestErrorEvent | SessionTurnProgressEvent | SessionTurnFinalEvent | SessionTurnErrorEvent | SessionMessagePersistedEvent;
-export type WsServerEnvelope = RealtimeEnvelope;

package/dist/websocket.js

@@ -1,85 +0,0 @@
-import { z } from "zod";
-const contentBlockMetaSchema = z.record(z.string(), z.unknown());
-// ── Schemas ──
-export const contentBlockSchema = z.discriminatedUnion("type", [
-    z.object({
-        type: z.literal("text"),
-        text: z.string(),
-        _meta: contentBlockMetaSchema.optional(),
-    }),
-    z.object({
-        type: z.literal("thinking"),
-        thinking: z.string(),
-        signature: z.string().optional(),
-        _meta: contentBlockMetaSchema.optional(),
-    }),
-    z.object({
-        type: z.literal("image"),
-        source: z.union([
-            z.object({ type: z.literal("url"), url: z.string().url() }),
-            z.object({ type: z.literal("base64"), media_type: z.string(), data: z.string() }),
-        ]),
-        _meta: contentBlockMetaSchema.optional(),
-    }),
-    z.object({
-        type: z.literal("tool_use"),
-        id: z.string(),
-        name: z.string(),
-        input: z.record(z.string(), z.unknown()),
-        _meta: contentBlockMetaSchema.optional(),
-    }),
-    z.object({
-        type: z.literal("tool_result"),
-        tool_use_id: z.string(),
-        content: z.union([z.string(), z.array(z.unknown())]),
-        is_error: z.boolean().optional(),
-        _meta: contentBlockMetaSchema.optional(),
-    }),
-    z.object({
-        type: z.literal("system_note"),
-        note_type: z.enum(["session_created", "forked", "compacted", "info"]),
-        text: z.string(),
-        _meta: contentBlockMetaSchema.optional(),
-    }),
-]);
-export const wsClientEventSchema = z.discriminatedUnion("type", [
-    z.object({
-        type: z.literal("auth"),
-        requestId: z.string().optional(),
-        payload: z.object({ token: z.string().min(1) }),
-    }),
-    z.object({
-        type: z.literal("session.message.create"),
-        requestId: z.string().optional(),
-        payload: z.object({
-            spaceId: z.string().uuid(),
-            sessionId: z.string().uuid(),
-            clientMessageId: z.string().optional(),
-            content: z.array(contentBlockSchema).min(1),
-            model: z.string().optional(),
-            provider: z.string().optional(),
-        }),
-    }),
-    z.object({
-        type: z.literal("ping"),
-        requestId: z.string().optional(),
-        payload: z.record(z.string(), z.unknown()).optional(),
-    }),
-    z.object({
-        type: z.literal("ack"),
-        requestId: z.string().optional(),
-        payload: z.object({
-            eventId: z.string().optional(),
-        }).optional(),
-    }),
-]);
-export const realtimeEnvelopeSchema = z.object({
-    id: z.string(),
-    timestamp: z.number(),
-    domain: z.enum(["system", "session", "space"]),
-    type: z.string(),
-    requestId: z.string().nullable().optional(),
-    spaceId: z.string().nullable().optional(),
-    sessionId: z.string().nullable().optional(),
-    payload: z.record(z.string(), z.unknown()),
-});