@neta-art/cohub-cli 6.3.0 → 6.5.0

package/README.md

@@ -133,8 +133,14 @@ List recent turns across all visible Sessions in a Space:
 cohub -s <spaceId> spaces turns ls
 cohub -s <spaceId> spaces turns ls --author others --limit 50 --json
 cohub -s <spaceId> spaces turns ls --session <sessionId>
+cohub -s <spaceId> spaces turns intermediate <sessionId> <turnId>
+cohub -s <spaceId> spaces turns intermediate <sessionId> <turnId> --json
 ```
 
+When `--session` is provided, the CLI uses the same full turn endpoint as the
+Web session view. Intermediate messages are read from the turn's CDN archive;
+`--json` returns the archive without reducing its content blocks.
+
 Use `pageInfo.nextCursor` with `--cursor` to load older pages. Use a previous
 `snapshotCursor` with `--after` and an explicit `--before` boundary to query
 newer turns:

package/dist/board-export.d.ts

@@ -1,8 +1,9 @@
 /**
  * Board image export for the CLI.
  *
- * Rendering runs through the same PixiJS card renderers the web editor uses (see
- * `@neta-art/cohub/board`), on a Canvas2D backend. Everything platform-specific
+ * The CLI and web editor share canonical Board geometry and card semantics. Each
+ * host selects the renderer primitive suited to its backend; this path uses
+ * Canvas2D. Everything platform-specific
  * lives here: fetching the document over HTTP, pulling image bytes out of the
  * space, and locating fonts on disk.
  */

package/dist/board-export.js

@@ -1,8 +1,9 @@
 /**
  * Board image export for the CLI.
  *
- * Rendering runs through the same PixiJS card renderers the web editor uses (see
- * `@neta-art/cohub/board`), on a Canvas2D backend. Everything platform-specific
+ * The CLI and web editor share canonical Board geometry and card semantics. Each
+ * host selects the renderer primitive suited to its backend; this path uses
+ * Canvas2D. Everything platform-specific
  * lives here: fetching the document over HTTP, pulling image bytes out of the
  * space, and locating fonts on disk.
  */

package/dist/commands/boards/examples.js

@@ -1,5 +1,4 @@
 import { json } from "../../output.js";
-const frame = { x: 120, y: 80, width: 320, height: 48, rotation: 0 };
 const templates = {
     "batch:basic": {
         commands: [
@@ -11,7 +10,9 @@ const templates = {
         items: [{
                 id: "title",
                 type: "text",
-                frame,
+                position: { x: 120, y: 80 },
+                size: { width: 320, height: 48 },
+                rotation: 0,
                 props: { text: "Launch plan", fontSize: 32 },
                 style: { color: "brand" },
             }],
@@ -24,21 +25,27 @@ const templates = {
             {
                 id: "request",
                 type: "text",
-                frame: { x: 80, y: 190, width: 180, height: 48, rotation: 0 },
+                position: { x: 80, y: 190 },
+                size: { width: 180, height: 48 },
+                rotation: 0,
                 props: { text: "Request", fontSize: 28 },
                 style: { color: "brand" },
             },
             {
                 id: "agent",
                 type: "geo",
-                frame: { x: 360, y: 150, width: 240, height: 120, rotation: 0 },
+                position: { x: 360, y: 150 },
+                size: { width: 240, height: 120 },
+                rotation: 0,
                 props: { shape: "rounded", text: "Agent" },
                 style: { color: "blue", fillOpacity: 0.08 },
             },
             {
                 id: "result",
                 type: "geo",
-                frame: { x: 700, y: 150, width: 240, height: 120, rotation: 0 },
+                position: { x: 700, y: 150 },
+                size: { width: 240, height: 120 },
+                rotation: 0,
                 props: { shape: "rounded", text: "Result" },
                 style: { color: "green", fillOpacity: 0.08 },
             },
@@ -55,28 +62,36 @@ const templates = {
             {
                 id: "hero",
                 type: "image",
-                frame: { x: 80, y: 100, width: 640, height: 360, rotation: 0 },
+                position: { x: 80, y: 100 },
+                size: { width: 640, height: 360 },
+                rotation: 0,
                 source: { kind: "space-file", path: "assets/hero.webp" },
                 props: {},
             },
             {
                 id: "demo-video",
                 type: "video",
-                frame: { x: 760, y: 100, width: 480, height: 270, rotation: 0 },
+                position: { x: 760, y: 100 },
+                size: { width: 480, height: 270 },
+                rotation: 0,
                 source: { kind: "space-file", path: "assets/demo.mp4" },
                 props: {},
             },
             {
                 id: "soundtrack",
                 type: "audio",
-                frame: { x: 80, y: 500, width: 400, height: 96, rotation: 0 },
+                position: { x: 80, y: 500 },
+                size: { width: 400, height: 96 },
+                rotation: 0,
                 source: { kind: "space-file", path: "assets/soundtrack.mp3" },
                 props: {},
             },
             {
                 id: "brief",
                 type: "file",
-                frame: { x: 520, y: 500, width: 320, height: 180, rotation: 0 },
+                position: { x: 520, y: 500 },
+                size: { width: 320, height: 180 },
+                rotation: 0,
                 source: { kind: "space-file", path: "docs/brief.md" },
                 props: {},
             },
@@ -90,14 +105,16 @@ const templates = {
             {
                 id: "title",
                 type: "text",
-                frame: { x: 120, y: 80, width: 320, height: 48, rotation: 0 },
+                position: { x: 120, y: 80 },
+                size: { width: 320, height: 48 },
+                rotation: 0,
                 props: { text: "Launch", fontSize: 32 },
                 style: { color: "brand" },
             },
             {
                 id: "stroke",
                 type: "draw",
-                frame: { x: 120, y: 180, width: 180, height: 100, rotation: 0 },
+                rotation: 0,
                 props: { points: [{ x: 2, y: 98, p: 0.5 }, { x: 90, y: 2, p: 0.5 }, { x: 178, y: 98, p: 0.5 }] },
                 style: { color: "violet", strokeWidth: 4 },
             },
@@ -150,70 +167,86 @@ const templates = {
     "item:text": {
         id: "title",
         type: "text",
-        frame,
+        position: { x: 120, y: 80 },
+        size: { width: 320, height: 48 },
+        rotation: 0,
         props: { text: "Launch plan", fontSize: 32 },
         style: { color: "brand" },
     },
     "item:image": {
         id: "hero",
         type: "image",
-        frame: { x: 120, y: 160, width: 640, height: 360, rotation: 0 },
+        position: { x: 120, y: 160 },
+        size: { width: 640, height: 360 },
+        rotation: 0,
         source: { kind: "space-file", path: "assets/hero.webp" },
         props: {},
     },
     "item:geo": {
         id: "goal",
         type: "geo",
-        frame: { x: 120, y: 160, width: 280, height: 140, rotation: 0 },
+        position: { x: 120, y: 160 },
+        size: { width: 280, height: 140 },
+        rotation: 0,
         props: { shape: "rounded", text: "Ship" },
         style: { color: "green", fillOpacity: 0.12 },
     },
     "item:frame": {
         id: "scene",
         type: "frame",
-        frame: { x: 80, y: 60, width: 960, height: 540, rotation: 0 },
+        position: { x: 80, y: 60 },
+        size: { width: 960, height: 540 },
+        rotation: 0,
         props: { label: "Scene 1" },
         style: { color: "neutral" },
     },
     "item:draw": {
         id: "stroke",
         type: "draw",
-        frame: { x: 100, y: 100, width: 180, height: 100, rotation: 0 },
-        props: { points: [{ x: 2, y: 98, p: 0.5 }, { x: 90, y: 2, p: 0.5 }, { x: 178, y: 98, p: 0.5 }] },
+        rotation: 0,
+        props: { points: [{ x: 102, y: 198, p: 0.5 }, { x: 190, y: 102, p: 0.5 }, { x: 278, y: 198, p: 0.5 }] },
         style: { color: "violet", strokeWidth: 4 },
     },
     "item:arrow": {
         id: "arrow",
         type: "arrow",
-        frame: { x: 100, y: 100, width: 260, height: 100, rotation: 0 },
+        rotation: 0,
         props: { start: { x: 116, y: 150 }, end: { x: 344, y: 150 }, bend: 0, arrowStart: false, arrowEnd: true, label: "next" },
         style: { color: "brand", strokeWidth: 2.5 },
     },
     "item:video": {
         id: "demo-video",
         type: "video",
-        frame: { x: 120, y: 160, width: 640, height: 360, rotation: 0 },
+        position: { x: 120, y: 160 },
+        size: { width: 640, height: 360 },
+        rotation: 0,
         source: { kind: "space-file", path: "assets/demo.mp4" },
         props: {},
     },
     "item:audio": {
         id: "soundtrack",
         type: "audio",
-        frame: { x: 120, y: 540, width: 480, height: 96, rotation: 0 },
+        position: { x: 120, y: 540 },
+        size: { width: 480, height: 96 },
+        rotation: 0,
         source: { kind: "space-file", path: "assets/soundtrack.mp3" },
         props: {},
     },
     "item:file": {
         id: "brief",
         type: "file",
-        frame: { x: 120, y: 160, width: 360, height: 220, rotation: 0 },
+        position: { x: 120, y: 160 },
+        size: { width: 360, height: 220 },
+        rotation: 0,
         source: { kind: "space-file", path: "docs/brief.md" },
         props: {},
     },
     "item:task": {
         id: "task",
         type: "task",
-        frame: { x: 120, y: 160, width: 420, height: 240, rotation: 0 },
+        position: { x: 120, y: 160 },
+        size: { width: 420, height: 240 },
+        rotation: 0,
         props: { taskRunId: "task-run-id", snapshot: { taskType: "generation", status: "running", title: "Generate concept", artifactCount: 0, artifacts: [] } },
     },
     "effect:pulse": {

package/dist/commands/boards/items.js

@@ -1,5 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { BoardAuthoringItemSchema, BoardItemPatchSchema, } from "@neta-art/cohub";
+import { computeArrowFrame, computeDrawBounds } from "@neta-art/cohub/board";
 import { BOARD_DOMAIN_INPUT_MAX_BYTES, readBoardJsonObject, } from "../../board-command-support.js";
 import { handleHttp, json, jsonRequested, ok, table } from "../../output.js";
 import { readInput, readOptions, resolvedBoard, withJson, } from "./context.js";
@@ -38,6 +39,25 @@ function mutationOptions(command) {
         .option("--mutation-id <id>", "Stable id for safe retries")
         .option("--dry-run", "Validate on the server (references, version, cascade) without writing");
 }
+function itemLayout(item) {
+    if ("position" in item) {
+        const size = "size" in item ? item.size : undefined;
+        return { x: item.position.x, y: item.position.y, width: size?.width ?? "", height: size?.height ?? "" };
+    }
+    if (item.type === "draw") {
+        const points = item.props.points;
+        const strokeWidth = item.style?.strokeWidth ?? 4;
+        const bounds = computeDrawBounds(points, strokeWidth);
+        return { x: bounds.x, y: bounds.y, width: bounds.width, height: bounds.height };
+    }
+    const bounds = computeArrowFrame({
+        start: item.props.start,
+        end: item.props.end,
+        bend: item.props.bend,
+        size: item.style?.strokeWidth ?? 2.5,
+    });
+    return { x: bounds.x, y: bounds.y, width: bounds.width, height: bounds.height };
+}
 export function registerBoardItemCommands(boards) {
     const items = boards.command("items").description("Author Board items with semantic JSON");
     readOptions(withJson(items.command("list <board>").alias("ls").description("List semantic Board items")))
@@ -51,10 +71,7 @@ export function registerBoardItemCommands(boards) {
             table(items.map((item) => ({
                 id: item.id,
                 type: item.type,
-                x: item.frame.x,
-                y: item.frame.y,
-                width: item.frame.width,
-                height: item.frame.height,
+                ...itemLayout(item),
             })), [
                 { key: "id", label: "ID" },
                 { key: "type", label: "TYPE" },
@@ -81,10 +98,7 @@ export function registerBoardItemCommands(boards) {
             table([{
                     id: item.id,
                     type: item.type,
-                    x: item.frame.x,
-                    y: item.frame.y,
-                    width: item.frame.width,
-                    height: item.frame.height,
+                    ...itemLayout(item),
                 }], [
                 { key: "id", label: "ID" },
                 { key: "type", label: "TYPE" },
@@ -103,7 +117,7 @@ export function registerBoardItemCommands(boards) {
         .requiredOption("-i, --input <file>", "Board Item JSON; use - for stdin")
         .addHelpText("after", `
 Minimal text item:
-  {"id":"title","type":"text","frame":{"x":120,"y":80,"width":320,"height":48,"rotation":0},"props":{"text":"Launch plan","fontSize":32},"style":{"color":"brand"}}`))
+  {"id":"title","type":"text","position":{"x":120,"y":80},"size":{"width":320,"height":48},"props":{"text":"Launch plan","fontSize":32},"style":{"color":"brand"}}`))
         .action(async (target, options) => {
         try {
             const value = await readBoardJsonObject(options.input, BOARD_DOMAIN_INPUT_MAX_BYTES);
@@ -122,7 +136,7 @@ Minimal text item:
         .addHelpText("after", `
 Objects merge recursively, arrays replace, and null clears optional fields.
 Move and rename a text item without replacing its size or font:
-  {"frame":{"x":160,"y":120},"props":{"text":"Updated"}}`))
+  {"position":{"x":160,"y":120},"props":{"text":"Updated"}}`))
         .action(async (target, itemId, options) => {
         try {
             const value = await readBoardJsonObject(options.input, BOARD_DOMAIN_INPUT_MAX_BYTES);

package/dist/commands/boards.d.ts

@@ -7,4 +7,11 @@ export declare function parseViewport(value?: string): {
     width: number;
     height: number;
 } | undefined;
+export declare function showCreated(result: {
+    board: {
+        id: string;
+        title: string;
+        version: number;
+    };
+}, path: string): void;
 export declare function registerBoards(program: Command): Command;

package/dist/commands/boards.js

@@ -38,8 +38,9 @@ export function parseViewport(value) {
         throw new Error("viewport width and height must be greater than zero");
     return { x, y, width, height };
 }
-function showCreated(result) {
-    table([result.board], [
+export function showCreated(result, path) {
+    table([{ path, ...result.board }], [
+        { key: "path", label: "Path" },
         { key: "id", label: "ID" },
         { key: "title", label: "Title" },
         { key: "version", label: "Version" },
@@ -240,9 +241,9 @@ Generate an editable seed:
             };
             const result = await createClient().space(resolveSpace(boards)).boards.create(input);
             if (jsonRequested(options))
-                return outJson(result);
-            ok(`Board created: ${result.board.id}`);
-            showCreated(result);
+                return outJson({ ...result, path });
+            ok(`Board created: ${path}`);
+            showCreated(result, path);
         }
         catch (cause) {
             handleHttp(cause);
@@ -276,6 +277,9 @@ Apply multiple changes atomically:
         .description("Show authoring schemas and runtime capabilities")
         .addHelpText("after", `
 Use --json for complete Item, patch, mutation, effect, Composition, and create JSON Schemas.
+Coordinates:
+  draw points and arrow start/end points are world-space.
+  Position and size are optional; Board geometry derives the persisted frame automatically.
 Use boards examples for editable starter JSON.`))
         .action(async (target, options) => {
         try {

package/dist/commands/space-turns.d.ts

@@ -1,4 +1,4 @@
-import type { SpaceTurnListItem, SpaceTurnListOptions, SpaceTurnsResponse } from "@neta-art/cohub";
+import type { SpaceTurnListItem, SpaceTurnListOptions, SpaceTurnsResponse, SessionTurnRecord, TurnIntermediateMessagesFile } from "@neta-art/cohub";
 import type { Command } from "commander";
 import { type Row } from "../output.js";
 export type SpaceTurnListCliOptions = {
@@ -9,12 +9,30 @@ export type SpaceTurnListCliOptions = {
     limit?: string;
     session?: string;
     json?: boolean;
+    direction?: "older" | "newer";
 };
 type SpaceTurnsCommandClient = {
     space(spaceId: string): {
         turns: {
             list(options: SpaceTurnListOptions): Promise<SpaceTurnsResponse>;
         };
+        session(sessionId: string): {
+            turns: {
+                listPaginated(options?: {
+                    cursor?: number;
+                    limit?: number;
+                    direction?: "older" | "newer";
+                }): Promise<{
+                    session: unknown;
+                    turns: SessionTurnRecord[];
+                    hasMore: boolean;
+                    nextCursor: number | undefined;
+                }>;
+                intermediate: {
+                    get(turnId: string): Promise<TurnIntermediateMessagesFile | null>;
+                };
+            };
+        };
     };
 };
 export declare class InvalidSpaceTurnCliOptionsError extends Error {
@@ -22,6 +40,8 @@ export declare class InvalidSpaceTurnCliOptionsError extends Error {
     constructor(message: string, detail: string);
 }
 export declare function parseSpaceTurnListOptions(options: SpaceTurnListCliOptions): SpaceTurnListOptions;
+export declare function parseSessionTurnCursor(value: string | undefined): number | undefined;
+export declare function validateSpaceTurnListMode(options: SpaceTurnListCliOptions): void;
 export declare function toSpaceTurnRows(turns: SpaceTurnListItem[]): Row[];
 export declare function registerSpaceTurns(spacesCmd: Command, dependencies?: {
     createClient?: () => SpaceTurnsCommandClient;

package/dist/commands/space-turns.js

@@ -48,6 +48,23 @@ export function parseSpaceTurnListOptions(options) {
         sessionId: options.session,
     };
 }
+export function parseSessionTurnCursor(value) {
+    if (value === undefined)
+        return undefined;
+    const cursor = Number(value);
+    if (!Number.isSafeInteger(cursor) || cursor < 1) {
+        throw new InvalidSpaceTurnCliOptionsError("Invalid cursor", "Session cursor must be a positive turn sequence");
+    }
+    return cursor;
+}
+export function validateSpaceTurnListMode(options) {
+    if (!options.session && options.direction !== undefined) {
+        throw new InvalidSpaceTurnCliOptionsError("Invalid direction", "--direction only applies with --session");
+    }
+    if (options.session && (options.author || options.after || options.before)) {
+        throw new InvalidSpaceTurnCliOptionsError("Invalid session turn options", "--session uses the Session turns API; omit --author, --after, and --before");
+    }
+}
 export function toSpaceTurnRows(turns) {
     return turns.map((turn) => ({
         createdAt: turn.createdAt,
@@ -71,13 +88,14 @@ export function registerSpaceTurns(spacesCmd, dependencies = {}) {
     turnsCmd
         .command("ls")
         .alias("list")
-        .description("List recent turns across sessions")
-        .option("--author <any|self|others>", "Filter turns by author")
-        .option("--after <cursor>", "Only turns after a snapshot cursor")
-        .option("--before <timestamp>", "Only turns at or before an ISO 8601 timestamp")
-        .option("--cursor <cursor>", "Older-page cursor from a previous result")
-        .option("--limit <n>", "Page size, from 1 to 100")
-        .option("--session <id>", "Only turns from this session")
+        .description("List turns in the space, or full turns from one session")
+        .option("--author <any|self|others>", "Filter space turns by author")
+        .option("--after <cursor>", "Start after a previous snapshot cursor")
+        .option("--before <timestamp>", "End at an ISO 8601 timestamp")
+        .option("--cursor <cursor>", "Page cursor; with --session, use a turn sequence")
+        .option("--limit <n>", "Maximum turns per page, 1-100")
+        .option("--session <id>", "Use the full turn list for this session")
+        .option("--direction <older|newer>", "Session page direction; use with --session")
         .option("--json", "Output as JSON")
         .action(async (options) => {
         let query;
@@ -93,6 +111,45 @@ export function registerSpaceTurns(spacesCmd, dependencies = {}) {
         const spaceId = resolveSpace(spacesCmd);
         const client = dependencies.createClient?.() ?? createClient();
         try {
+            try {
+                validateSpaceTurnListMode(options);
+            }
+            catch (cause) {
+                if (cause instanceof InvalidSpaceTurnCliOptionsError)
+                    return error(cause.message, cause.detail);
+                throw cause;
+            }
+            if (options.session) {
+                let sessionCursor;
+                try {
+                    sessionCursor = parseSessionTurnCursor(options.cursor);
+                }
+                catch (cause) {
+                    if (cause instanceof InvalidSpaceTurnCliOptionsError)
+                        return error(cause.message, cause.detail);
+                    throw cause;
+                }
+                const result = await client.space(spaceId).session(options.session).turns.listPaginated({
+                    cursor: sessionCursor,
+                    limit: query.limit,
+                    direction: options.direction,
+                });
+                if (jsonRequested(options))
+                    return outJson(result);
+                if (result.turns.length === 0)
+                    return console.log("  No turns found");
+                table(result.turns, [
+                    { key: "sequence", label: "Seq" },
+                    { key: "id", label: "Turn ID" },
+                    { key: "status", label: "Status" },
+                    { key: "userText", label: "User" },
+                    { key: "assistantText", label: "Assistant" },
+                    { key: "updatedAt", label: "Updated" },
+                ]);
+                if (result.hasMore)
+                    console.log(`\n  More turns available - next cursor: ${result.nextCursor}`);
+                return;
+            }
             const result = await client.space(spaceId).turns.list(query);
             if (jsonRequested(options))
                 return outJson(result);
@@ -117,5 +174,32 @@ export function registerSpaceTurns(spacesCmd, dependencies = {}) {
             handleHttp(cause);
         }
     });
+    turnsCmd
+        .command("intermediate <sessionId> <turnId>")
+        .description("Read persisted intermediate messages from the CDN archive")
+        .option("--json", "Output as JSON")
+        .action(async (sessionId, turnId, options) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = dependencies.createClient?.() ?? createClient();
+        try {
+            const archive = await client.space(spaceId).session(sessionId).turns.intermediate.get(turnId);
+            if (jsonRequested(options))
+                return outJson(archive);
+            if (!archive)
+                return console.log("  No intermediate messages found");
+            console.log(`Turn ${archive.turnId}`);
+            console.log(`  ${archive.summary.messageCount} intermediate messages · ${archive.summary.toolCallCount} tool calls`);
+            for (const [index, message] of archive.messages.entries()) {
+                console.log(`\n${index + 1}. ${message.role}${message.provider ? ` · ${message.provider}/${message.model ?? ""}` : ""}`);
+                if (message.text)
+                    console.log(message.text);
+                if (message.toolCallsObjectKey)
+                    console.log("  Tool calls: available");
+            }
+        }
+        catch (cause) {
+            handleHttp(cause);
+        }
+    });
     return turnsCmd;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "6.3.0",
+  "version": "6.5.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "Apache-2.0",
@@ -19,7 +19,7 @@
     "commander": "^15.0.0",
     "pixi.js": "^8.20.1",
     "sharp": "^0.35.4",
-    "@neta-art/cohub": "8.6.0"
+    "@neta-art/cohub": "8.8.0"
   },
   "publishConfig": {
     "access": "public"