@neta-art/cohub-protocol 1.2.2 → 1.2.3

package/dist/model/turn.d.ts

@@ -20,12 +20,6 @@ export type SessionTurnIntermediateSummary = {
     lastMessageText?: string | null;
     hasError?: boolean;
 };
-export type StoredIntermediateMessageToolCallSummary = {
-    id: string;
-    name: string;
-    status: "running" | "done" | "failed";
-    input: Record<string, unknown>;
-};
 export type StoredIntermediateMessage = {
     id: string;
     sessionId: string;
@@ -37,7 +31,6 @@ export type StoredIntermediateMessage = {
     stopReason: string | null;
     errorMessage: string | null;
     usage: Usage | null;
-    toolCalls: StoredIntermediateMessageToolCallSummary[];
     toolCallsObjectKey: string | null;
     meta: Record<string, unknown> | null;
     createdAt: string;
@@ -46,11 +39,12 @@ export type StoredToolCall = {
     id: string;
     name: string;
     input: Record<string, unknown>;
+    meta: Record<string, unknown> | null;
     result: {
         content: string | ContentBlock[] | null;
         isError: boolean;
+        meta: Record<string, unknown> | null;
     } | null;
-    meta: Record<string, unknown> | null;
 };
 export type MessageToolCallsFile = {
     version: 1;
@@ -68,6 +62,22 @@ export type TurnIntermediateMessagesFile = {
     summary: SessionTurnIntermediateSummary;
     messages: StoredIntermediateMessage[];
 };
+export type SessionTurnIndexItem = {
+    id: string;
+    sessionId: string;
+    sequence: number;
+    status: SessionTurnStatus;
+    startedAt: string | null;
+    completedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    userPreview: string | null;
+    assistantPreview: string | null;
+    provider: string | null;
+    model: string | null;
+    usage: Usage | null;
+    errorMessage: string | null;
+};
 export type SessionTurnRecord = {
     id: string;
     sessionId: string;

package/dist/permissions.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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

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

package/dist/ports/index.d.ts

@@ -0,0 +1,21 @@
+export declare const SANDBOX_PUBLIC_PORTS: readonly [3000, 5173];
+export type SandboxPublicPort = (typeof SANDBOX_PUBLIC_PORTS)[number];
+export type SpacePortStatus = "listening" | "closed";
+export type SpacePortChange = {
+    port: SandboxPublicPort | number;
+    protocol: "tcp";
+    status: SpacePortStatus;
+    observedAt: number;
+};
+export type SpacePortsChangedPayload = {
+    source: "sandbox-port-watch" | "sandbox-port-watch-started";
+    seq?: number;
+    resync?: boolean;
+    ports: SpacePortChange[];
+};
+export type SpacePublicEndpoint = {
+    url: string;
+    status?: SpacePortStatus | "unknown";
+    observedAt?: number;
+};
+export type SpacePublicEndpoints = Record<string, SpacePublicEndpoint>;

package/dist/ports/index.js

@@ -0,0 +1 @@
+export const SANDBOX_PUBLIC_PORTS = [3000, 5173];

package/dist/realtime/stream.d.ts

@@ -8,6 +8,8 @@ export type SessionStreamEvent = {
     baseSeq: number;
     content: ContentBlock[];
     snapshotContent?: ContentBlock[];
+    messageId?: string | null;
+    messageOrdinal?: number | null;
     sourceMessageId: string | null;
     timestamp: number;
     turnEnd?: boolean;

package/dist/realtime/websocket.d.ts

@@ -1,7 +1,8 @@
 import { z } from "zod";
 import type { ContentBlock } from "../core/content.js";
-import type { MessageRecord } from "../model/session.js";
+import type { MessageRecord, SessionTurnRecord } from "../model/session.js";
 import type { SpaceFsChangedPayload } from "../fs/index.js";
+import type { SpacePortsChangedPayload } from "../ports/index.js";
 export declare const WS_COMPACT_STREAM_CAPABILITY = "session.compact_stream.v1";
 export declare const contentBlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"text">;
@@ -293,6 +294,8 @@ export type SessionTurnProgressEvent = {
     spaceId: string;
     sessionId: string;
     payload: {
+        messageId: string | null;
+        messageOrdinal?: number | null;
         anchorUserMessageId: string | null;
         content: ContentBlock[];
     };
@@ -332,12 +335,36 @@ export type SessionTurnPatchEvent = {
     payload: {
         turnId: string | null;
         messageId: string | null;
+        messageOrdinal?: number | null;
         anchorUserMessageId: string | null;
         seq: number;
         baseSeq: number;
         ops: RealtimePatchOperation[];
     };
 };
+export type SessionTurnSnapshotMessage = {
+    messageId: string | null;
+    messageOrdinal: number | null;
+    content: ContentBlock[];
+};
+export type SessionTurnSnapshotEvent = {
+    id: string;
+    timestamp: number;
+    domain: "session";
+    type: "session.turn.snapshot";
+    requestId?: string | null;
+    spaceId: string;
+    sessionId: string;
+    payload: {
+        turnId: string | null;
+        anchorUserMessageId: string | null;
+        seq: number;
+        current: SessionTurnSnapshotMessage & {
+            appendPath: string | null;
+        };
+        intermediateMessages: SessionTurnSnapshotMessage[];
+    };
+};
 export type SessionTurnErrorEvent = {
     id: string;
     timestamp: number;
@@ -351,6 +378,31 @@ export type SessionTurnErrorEvent = {
         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 SessionTurnUpdatedEvent = {
+    id: string;
+    timestamp: number;
+    domain: "session";
+    type: "session.turn.updated";
+    requestId?: string | null;
+    spaceId: string;
+    sessionId: string;
+    payload: {
+        turn: RealtimeTurnRecord;
+    };
+};
+export type SessionTurnFinalizedEvent = {
+    id: string;
+    timestamp: number;
+    domain: "session";
+    type: "session.turn.finalized";
+    requestId?: string | null;
+    spaceId: string;
+    sessionId: string;
+    payload: {
+        turn: RealtimeTurnRecord;
+    };
+};
 export type RealtimeMessageRecord = Pick<MessageRecord, "id" | "sessionId" | "role" | "content" | "text" | "sequence" | "provider" | "model" | "stopReason" | "errorMessage" | "usage" | "meta" | "createdAt">;
 export type SessionMessagePersistedEvent = {
     id: string;
@@ -374,6 +426,16 @@ export type SpaceFsChangedEvent = {
     sessionId?: string | null;
     payload: SpaceFsChangedPayload;
 };
-export type RealtimeServerEvent = SystemReadyEvent | SystemAuthOkEvent | SystemRequestErrorEvent | SystemPongEvent | SystemAckOkEvent | SessionRequestAcceptedEvent | SessionRequestErrorEvent | SessionTurnProgressEvent | SessionTurnPatchEvent | SessionTurnErrorEvent | SessionMessagePersistedEvent | SpaceFsChangedEvent;
+export type SpacePortsChangedEvent = {
+    id: string;
+    timestamp: number;
+    domain: "space";
+    type: "space.ports.changed";
+    requestId?: string | null;
+    spaceId: string;
+    sessionId?: string | null;
+    payload: SpacePortsChangedPayload;
+};
+export type RealtimeServerEvent = SystemReadyEvent | SystemAuthOkEvent | SystemRequestErrorEvent | SystemPongEvent | SystemAckOkEvent | SessionRequestAcceptedEvent | SessionRequestErrorEvent | SessionTurnProgressEvent | SessionTurnPatchEvent | SessionTurnSnapshotEvent | SessionTurnErrorEvent | SessionTurnUpdatedEvent | SessionTurnFinalizedEvent | SessionMessagePersistedEvent | SpaceFsChangedEvent | SpacePortsChangedEvent;
 export type WsServerEnvelope = RealtimeEnvelope;
 export type ChannelServerEnvelope = ChannelEnvelope;

package/dist/responses.d.ts

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

package/dist/responses.js

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1,158 @@
+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

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

package/dist/space-fs.d.ts

@@ -0,0 +1,33 @@
+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

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

package/dist/space-sandbox.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 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

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

package/dist/tasks.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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

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