@neta-art/cohub-protocol 1.4.0 → 1.6.0

package/dist/core/content.d.ts

@@ -19,6 +19,11 @@ export type ContentBlock = {
         data: string;
     };
     _meta?: ContentBlockMeta;
+} | {
+    type: "shell_command";
+    command: string;
+    rawText: string;
+    _meta?: ContentBlockMeta;
 } | {
     type: "tool_use";
     id: string;

package/dist/generation/index.d.ts

@@ -0,0 +1,117 @@
+export type GenerationSource = {
+    type: "url";
+    url: string;
+} | {
+    type: "base64";
+    media_type: string;
+    data: string;
+} | {
+    type: "space_file";
+    space_id: string;
+    path: string;
+};
+export type GenerationContentBlockMeta = Record<string, unknown>;
+export type GenerationContentBlock = {
+    type: "text";
+    text: string;
+    _meta?: GenerationContentBlockMeta;
+} | {
+    type: "image";
+    source: GenerationSource;
+    _meta?: GenerationContentBlockMeta;
+} | {
+    type: "video";
+    source: GenerationSource;
+    _meta?: GenerationContentBlockMeta;
+} | {
+    type: "audio";
+    source: GenerationSource;
+    _meta?: GenerationContentBlockMeta;
+};
+export type CreateGenerationRequest = {
+    model: string;
+    content: GenerationContentBlock[];
+    parameters?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+};
+export type GenerationStatus = "queued" | "running" | "succeeded" | "failed" | "cancelled";
+export type Generation = {
+    id: string;
+    status: GenerationStatus;
+    model: string;
+    input: GenerationContentBlock[];
+    output?: GenerationContentBlock[];
+    parameters?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    error?: {
+        code?: string;
+        message: string;
+        raw?: unknown;
+    };
+    created_at: string;
+    updated_at: string;
+    completed_at?: string;
+};
+export type GenerationContentSpec = {
+    type: "text" | "image" | "video" | "audio";
+    required?: boolean;
+    min?: number;
+    max?: number;
+    sources?: Array<"url" | "base64" | "space_file">;
+    merge?: "newline" | "space" | "concat";
+    meta?: Record<string, unknown>;
+    description?: string;
+};
+export type GenerationParameterSpec = {
+    type: "string";
+    optional?: boolean;
+    default?: string;
+    enum?: string[];
+    description?: string;
+    examples?: string[];
+} | {
+    type: "number";
+    optional?: boolean;
+    default?: number;
+    min?: number;
+    max?: number;
+    description?: string;
+    examples?: number[];
+} | {
+    type: "integer";
+    optional?: boolean;
+    default?: number;
+    min?: number;
+    max?: number;
+    description?: string;
+    examples?: number[];
+} | {
+    type: "boolean";
+    optional?: boolean;
+    default?: boolean;
+    description?: string;
+    examples?: boolean[];
+};
+export type GenerationDeclaration = {
+    schema: "cohub.generation.v1";
+    model: string;
+    title?: string;
+    description?: string;
+    adapter: {
+        type: string;
+        base_url: string;
+        api_key: string;
+    };
+    content: {
+        input: GenerationContentSpec[];
+    };
+    parameters?: Record<string, GenerationParameterSpec>;
+    examples?: Array<{
+        title?: string;
+        request: CreateGenerationRequest;
+    }>;
+};
+export type PublicGenerationDeclaration = Omit<GenerationDeclaration, "adapter">;
+export type ListGenerationDeclarationsResponse = {
+    declarations: PublicGenerationDeclaration[];
+};

package/dist/generation/index.js

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

package/dist/index.d.ts

@@ -8,3 +8,4 @@ export * from "./gateway/index.js";
 export * from "./task/index.js";
 export * from "./fs/index.js";
 export * from "./ports/index.js";
+export * from "./generation/index.js";

package/dist/index.js

@@ -8,3 +8,4 @@ export * from "./gateway/index.js";
 export * from "./task/index.js";
 export * from "./fs/index.js";
 export * from "./ports/index.js";
+export * from "./generation/index.js";

package/dist/model/session.d.ts

@@ -1,5 +1,29 @@
 import type { ContentBlock } from "../core/content.js";
 import type { Usage } from "../core/usage.js";
+export type SessionForkRecord = {
+    id: string;
+    spaceId: string;
+    parentSessionId: string;
+    childSessionId: string;
+    rootSessionId: string;
+    depth: number;
+    anchorSourceSessionId: string;
+    anchorTurnId: string;
+    anchorSequence: number;
+    ancestorSessionIds: string[];
+    sessionPath: string[];
+    createdBy: string | null;
+    createdAt: string;
+};
+export type SessionTurnSegmentRecord = {
+    id: string;
+    sessionId: string;
+    ordinal: number;
+    sourceSessionId: string;
+    fromSequence: number;
+    toSequence: number | null;
+    createdAt: string;
+};
 export type { MessageToolCallsFile, SessionTurnIntent, SessionTurnIntermediateIndex, SessionTurnIntermediateSummary, SessionTurnIndexItem, SessionTurnRecord, SessionTurnStatus, SessionTurnSummary, StoredIntermediateMessage, StoredToolCall, TurnIntermediateMessagesFile, } from "./turn.js";
 export type SessionPromptInput = {
     spaceId: string;
@@ -74,10 +98,6 @@ export type SessionRecord = {
     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;

package/dist/model/turn.d.ts

@@ -67,6 +67,8 @@ export type TurnIntermediateMessagesFile = {
 export type SessionTurnIndexItem = {
     id: string;
     sessionId: string;
+    sourceSessionId?: string;
+    sourceTurnId?: string;
     sequence: number;
     status: SessionTurnStatus;
     startedAt: string | null;
@@ -89,6 +91,8 @@ export type SessionTurnAuthorProfile = {
 export type SessionTurnRecord = {
     id: string;
     sessionId: string;
+    sourceSessionId?: string;
+    sourceTurnId?: string;
     userUuid: string | null;
     sequence: number;
     status: SessionTurnStatus;

package/dist/realtime/websocket.d.ts

@@ -24,6 +24,11 @@ export declare const contentBlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         data: z.ZodString;
     }, z.core.$strip>]>;
     _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"shell_command">;
+    command: z.ZodString;
+    rawText: z.ZodString;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"tool_use">;
     id: z.ZodString;
@@ -81,6 +86,11 @@ export declare const wsClientEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 data: z.ZodString;
             }, z.core.$strip>]>;
             _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"shell_command">;
+            command: z.ZodString;
+            rawText: z.ZodString;
+            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"tool_use">;
             id: z.ZodString;

package/dist/realtime/websocket.js

@@ -21,6 +21,12 @@ export const contentBlockSchema = z.discriminatedUnion("type", [
         ]),
         _meta: contentBlockMetaSchema.optional(),
     }),
+    z.object({
+        type: z.literal("shell_command"),
+        command: z.string(),
+        rawText: z.string(),
+        _meta: contentBlockMetaSchema.optional(),
+    }),
     z.object({
         type: z.literal("tool_use"),
         id: z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-protocol",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Shared protocol definitions for the Cohub agent collaboration platform.",
   "license": "UNLICENSED",
   "private": false,
@@ -56,6 +56,10 @@
     "./ports": {
       "types": "./dist/ports/index.d.ts",
       "default": "./dist/ports/index.js"
+    },
+    "./generation": {
+      "types": "./dist/generation/index.d.ts",
+      "default": "./dist/generation/index.js"
     }
   },
   "types": "./dist/index.d.ts",