@neta-art/cohub-cli 2.3.3 → 2.5.0

package/dist/client.js

@@ -1,8 +1,11 @@
-import { CohubHttpClient } from "@neta-art/cohub";
+import { CohubHttpClient, readRequestSourceFromEnv } from "@neta-art/cohub";
 import { clearAuthSession, resolveAccessToken } from "./auth.js";
 export function createClient() {
     return new CohubHttpClient({
         getAccessToken: resolveAccessToken,
         onUnauthorized: clearAuthSession,
+        requestSource: () => readRequestSourceFromEnv(process.env, { via: "cli" }) ?? {
+            via: "cli",
+        },
     });
 }

package/dist/commands/generations.js

@@ -229,26 +229,6 @@ function parseMeta(value) {
     }
     return parsed;
 }
-function mergeCohubMeta(meta) {
-    const sessionId = envValue("COHUB_SESSION_ID");
-    const turnId = envValue("COHUB_TURN_ID");
-    const toolCallId = envValue("COHUB_TOOL_CALL_ID");
-    if (!sessionId && !turnId && !toolCallId)
-        return meta;
-    const existingCohub = meta?.cohub;
-    const cohub = existingCohub && typeof existingCohub === "object" && !Array.isArray(existingCohub)
-        ? existingCohub
-        : {};
-    return {
-        ...(meta ?? {}),
-        cohub: {
-            ...cohub,
-            ...(sessionId ? { sessionId } : {}),
-            ...(turnId ? { turnId } : {}),
-            ...(toolCallId ? { toolCallId } : {}),
-        },
-    };
-}
 export function registerGenerations(program) {
     program
         .command("generate")
@@ -296,7 +276,7 @@ Examples:
                     return error("Generation settings", policyError.message);
                 throw policyError;
             }
-            const meta = mergeCohubMeta(parseMeta(opts.meta));
+            const meta = parseMeta(opts.meta);
             const client = createClient();
             const created = await client.generations.create({
                 spaceId,

package/dist/commands/references.js

@@ -1,21 +1,27 @@
 import { createClient } from "../client.js";
 import { table, json as outJson, jsonRequested, error, handleHttp } from "../output.js";
 const RESOURCE_TYPES = new Set([
-    "space",
+    "turn",
     "session",
+    "space",
     "checkpoint",
 ]);
 const REFERENCE_KINDS = new Set([
     "session_fork",
     "space_fork",
     "checkpoint_fork",
+    "mod",
     "mention",
     "tool_call",
-    "mod",
-    "participant",
+    "agent_tool_file_read",
+    "agent_tool_file_write",
+    "agent_tool_file_edit",
+    "agent_tool_file_ls",
+    "agent_tool_file_find",
+    "agent_tool_file_grep",
 ]);
 const DIRECTIONS = new Set(["out", "in", "both"]);
-const GROUP_BYS = new Set(["kind", "targetType", "sourceType", "day"]);
+const GROUP_BYS = new Set(["kind", "targetType", "target", "sourceType", "day"]);
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 function parseSource(value) {
     const idx = value.indexOf(":");
@@ -44,25 +50,35 @@ function clampNumber(value, fallback, min, max) {
         return fallback;
     return Math.min(Math.max(Math.floor(parsed), min), max);
 }
+const KINDS_HELP = `Kinds:
+  structural:  session_fork, space_fork, checkpoint_fork, mod
+  content:     mention, tool_call
+  file access: agent_tool_file_read, agent_tool_file_write, agent_tool_file_edit,
+               agent_tool_file_ls, agent_tool_file_find, agent_tool_file_grep`;
 export function registerReferences(program) {
     const references = program
         .command("references")
-        .description("Inspect resource references (forks, mentions, tool calls, mods, participants)");
+        .description("Inspect resource references (forks, mentions, tool calls, mods, file access)")
+        .addHelpText("after", "\nAnalysis index for collaboration edges and file heat.\n");
     references
         .command("query")
         .description("List references touching a resource")
-        .argument("<source>", "Resource selector, e.g. session:<uuid> or space:<uuid>")
+        .argument("<source>", "turn:<uuid> | session:<uuid> | space:<uuid> | checkpoint:<uuid>")
         .option("--direction <dir>", "out | in | both", "both")
-        .option("--kinds <kinds>", "Comma-separated kinds to include")
+        .option("--kinds <kinds>", "Comma-separated kinds (see list below)")
         .option("--days <n>", "Only references seen within the last N days")
         .option("--limit <n>", "Maximum rows, 1-500", "200")
         .option("--json", "Output as JSON")
         .addHelpText("after", `
 
+${KINDS_HELP}
+
 Examples:
+  cohub references query turn:<uuid> --kinds agent_tool_file_read,agent_tool_file_write
   cohub references query session:<uuid> --json
+  cohub references query checkpoint:<uuid> --direction out
   cohub references query space:<uuid> --direction in --kinds mention,tool_call
-  cohub references query space:<uuid> --kinds mod --days 30
+  cohub references query space:<uuid> --kinds agent_tool_file_read --days 30
 `)
         .action(async (source, opts) => {
         const client = createClient();
@@ -86,7 +102,7 @@ Examples:
             const rows = result.references.map((r) => ({
                 kind: r.kind,
                 source: `${r.sourceType}:${r.sourceId.slice(0, 8)}`,
-                target: `${r.targetType}:${r.targetId.slice(0, 8)}`,
+                target: formatTarget(r.targetType, r.targetId),
                 count: r.count,
                 lastSeen: r.updatedAt.slice(0, 10),
             }));
@@ -109,15 +125,22 @@ Examples:
         .command("aggregate")
         .description("Grouped reference counts for a space")
         .argument("<spaceId>", "Space id")
-        .option("--group-by <field>", "kind | targetType | sourceType | day", "kind")
-        .option("--kinds <kinds>", "Comma-separated kinds to include")
+        .option("--group-by <field>", "kind | targetType | target | sourceType | day", "kind")
+        .option("--kinds <kinds>", "Comma-separated kinds (see list below)")
         .option("--days <n>", "Only references seen within the last N days")
+        .option("--limit <n>", "Maximum groups, 1-500", "200")
         .option("--json", "Output as JSON")
         .addHelpText("after", `
 
+${KINDS_HELP}
+
+Notes:
+  --group-by target: file targets look like {spaceId}:{path}
+
 Examples:
   cohub references aggregate <spaceId> --json
   cohub references aggregate <spaceId> --group-by targetType
+  cohub references aggregate <spaceId> --group-by target --kinds agent_tool_file_read --limit 20
   cohub references aggregate <spaceId> --group-by day --days 30
 `)
         .action(async (spaceId, opts) => {
@@ -130,7 +153,8 @@ Examples:
                 return error(`Invalid group-by: ${opts.groupBy}`);
             const kinds = parseKinds(opts.kinds);
             const days = opts.days ? clampNumber(opts.days, 30, 1, 365) : undefined;
-            const result = await client.references.aggregate({ spaceId: spaceId.trim(), groupBy, kinds, days });
+            const limit = clampNumber(opts.limit, 200, 1, 500);
+            const result = await client.references.aggregate({ spaceId: spaceId.trim(), groupBy, kinds, days, limit });
             if (jsonRequested(opts))
                 return outJson(result);
             const rows = result.groups.map((g) => ({
@@ -151,3 +175,16 @@ Examples:
         }
     });
 }
+/**
+ * Render a target for the table. File targets are `{spaceId}:{path}`; show the
+ * short space id plus the full path rather than blindly truncating.
+ */
+function formatTarget(targetType, targetId) {
+    if (targetType === "file") {
+        const idx = targetId.indexOf(":");
+        if (idx > 0)
+            return `file:${targetId.slice(0, 8)}…${targetId.slice(idx)}`;
+        return `file:${targetId}`;
+    }
+    return `${targetType}:${targetId.slice(0, 8)}`;
+}

package/dist/commands/spaces.js

@@ -235,7 +235,6 @@ async function sendPrompt(command, words, opts) {
         const result = await client.space(spaceId).prompt({
             sessionId,
             title: sessionId === opts.session ? opts.title : undefined,
-            source: opts.source?.trim() || "cli",
             content: promptContent,
             model: opts.model,
             provider: opts.provider,
@@ -342,7 +341,6 @@ export function registerPrompt(program) {
         .description("Send or schedule a prompt in a space")
         .option("--session <id>", "Target session ID")
         .option("--title <title>", "Title for a newly created session or schedule")
-        .option("--source <source>", "Prompt source for newly created sessions", "cli")
         .option("-m, --model <model>", "Model name")
         .option("-p, --provider <provider>", "Provider name")
         .option("--read-only", "Use read-only tools")
@@ -1219,7 +1217,6 @@ function registerSessions(spacesCmd) {
         try {
             const result = await client.space(spaceId).sessions.create({
                 title,
-                source: "cli",
                 labelRefs: opts.label?.length ? opts.label : undefined,
             });
             if (jsonRequested(opts))

package/dist/commands/works.js

@@ -1,6 +1,5 @@
 import { HttpError } from "@neta-art/cohub";
 import { createClient } from "../client.js";
-import { mergeSourceMeta } from "../env-context.js";
 import { error, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
 import { resolveSpace } from "../space.js";
 import { registerWorkCommerce } from "./work-commerce.js";
@@ -101,14 +100,10 @@ async function confirmDelete(opts) {
     if (answer !== "y" && answer !== "yes")
         return error("Cancelled");
 }
-function resolveVersionMeta() {
-    return mergeSourceMeta(undefined);
-}
 async function publishWorkVersion(id, opts) {
     const client = createClient();
     try {
-        const versionMeta = resolveVersionMeta();
-        const result = await client.works.publishVersion(id, versionMeta ? { meta: versionMeta } : undefined);
+        const result = await client.works.publishVersion(id);
         if (jsonRequested(opts))
             return outJson(result);
         ok(`Work version updated: v${result.version.version}`);
@@ -216,7 +211,6 @@ export function registerWorks(program) {
             hideCohubBar: opts.hideCohubBar,
             showCohubBar: opts.showCohubBar,
         });
-        const versionMeta = resolveVersionMeta();
         const input = {
             spaceId,
             slug,
@@ -227,7 +221,6 @@ export function registerWorks(program) {
             workScopes: opts.workScope,
             allowedViewerScopes: opts.viewerScope,
             meta,
-            versionMeta,
         };
         try {
             const result = await client.works.create(input);
@@ -254,7 +247,7 @@ export function registerWorks(program) {
                     meta,
                 });
                 const publishedVersion = status === "published"
-                    ? await client.works.publishVersion(work.id, versionMeta ? { meta: versionMeta } : undefined)
+                    ? await client.works.publishVersion(work.id)
                     : null;
                 const result = publishedVersion ?? { work };
                 if (jsonRequested(opts))
@@ -328,9 +321,8 @@ export function registerWorks(program) {
             return error("Nothing to update", "Pass --slug, --file, --dir, --port, --status, --visibility, --work-scope, --viewer-scope, --clear-work-scopes, --clear-viewer-scopes, --meta, --hide-cohub-bar, or --show-cohub-bar.");
         try {
             const updated = await client.works.update(id, input);
-            const versionMeta = resolveVersionMeta();
             const publishedVersion = nextStatus === "published" && currentWork?.status !== "published"
-                ? await client.works.publishVersion(updated.work.id, versionMeta ? { meta: versionMeta } : undefined)
+                ? await client.works.publishVersion(updated.work.id)
                 : null;
             const result = publishedVersion ?? updated;
             if (jsonRequested(opts))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "2.3.3",
+  "version": "2.5.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "Apache-2.0",
@@ -18,7 +18,7 @@
     "@neta-art/generation": "^0.1.13",
     "commander": "^15.0.0",
     "sharp": "^0.35.3",
-    "@neta-art/cohub": "2.11.2"
+    "@neta-art/cohub": "2.13.0"
   },
   "publishConfig": {
     "access": "public"

package/dist/env-context.d.ts

@@ -1,12 +0,0 @@
-/** Read a trimmed non-empty env value. */
-export declare function envValue(name: string): string | undefined;
-/**
- * Merge sandbox provenance into meta under `source`.
- * Prefer explicit values; fall back to COHUB_* env vars from the agent/tool runtime.
- */
-export declare function mergeSourceMeta(meta: Record<string, unknown> | undefined, source?: {
-    spaceId?: string;
-    sessionId?: string;
-    turnId?: string;
-    toolCallId?: string;
-}): Record<string, unknown> | undefined;

package/dist/env-context.js

@@ -1,33 +0,0 @@
-/** Read a trimmed non-empty env value. */
-export function envValue(name) {
-    const value = process.env[name]?.trim();
-    return value || undefined;
-}
-/**
- * Merge sandbox provenance into meta under `source`.
- * Prefer explicit values; fall back to COHUB_* env vars from the agent/tool runtime.
- */
-export function mergeSourceMeta(meta, source) {
-    const spaceId = source?.spaceId?.trim() || envValue("COHUB_SPACE_ID");
-    const sessionId = source?.sessionId?.trim() || envValue("COHUB_SESSION_ID");
-    const turnId = source?.turnId?.trim() || envValue("COHUB_TURN_ID");
-    const toolCallId = source?.toolCallId?.trim() || envValue("COHUB_TOOL_CALL_ID");
-    if (!spaceId && !sessionId && !turnId && !toolCallId)
-        return meta;
-    const existingSource = meta?.source;
-    const nextSource = existingSource && typeof existingSource === "object" && !Array.isArray(existingSource)
-        ? { ...existingSource }
-        : {};
-    if (spaceId)
-        nextSource.spaceId = spaceId;
-    if (sessionId)
-        nextSource.sessionId = sessionId;
-    if (turnId)
-        nextSource.turnId = turnId;
-    if (toolCallId)
-        nextSource.toolCallId = toolCallId;
-    return {
-        ...(meta ?? {}),
-        source: nextSource,
-    };
-}