@neta-art/cohub-cli 2.3.2 → 2.4.0

package/NOTICE

@@ -0,0 +1,4 @@
+Cohub
+Copyright 2026 Viscept Limited
+
+This product includes software developed by Viscept Limited and contributors.

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(":");
@@ -47,11 +53,11 @@ function clampNumber(value, fallback, min, max) {
 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)");
     references
         .command("query")
         .description("List references touching a resource")
-        .argument("<source>", "Resource selector, e.g. session:<uuid> or space:<uuid>")
+        .argument("<source>", "Resource selector, e.g. turn:<uuid>, session:<uuid>, space:<uuid>")
         .option("--direction <dir>", "out | in | both", "both")
         .option("--kinds <kinds>", "Comma-separated kinds to include")
         .option("--days <n>", "Only references seen within the last N days")
@@ -60,9 +66,10 @@ export function registerReferences(program) {
         .addHelpText("after", `
 
 Examples:
+  cohub references query turn:<uuid> --kinds agent_tool_file_read,agent_tool_file_write
   cohub references query session:<uuid> --json
   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 +93,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 +116,17 @@ Examples:
         .command("aggregate")
         .description("Grouped reference counts for a space")
         .argument("<spaceId>", "Space id")
-        .option("--group-by <field>", "kind | targetType | sourceType | day", "kind")
+        .option("--group-by <field>", "kind | targetType | target | sourceType | day", "kind")
         .option("--kinds <kinds>", "Comma-separated kinds to include")
         .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", `
 
 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 +139,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 +161,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "2.3.2",
+  "version": "2.4.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "Apache-2.0",
@@ -10,13 +10,15 @@
   "files": [
     "dist",
     "bin",
-    "README.md"
+    "README.md",
+    "LICENSE",
+    "NOTICE"
   ],
   "dependencies": {
     "@neta-art/generation": "^0.1.13",
     "commander": "^15.0.0",
     "sharp": "^0.35.3",
-    "@neta-art/cohub": "2.11.1"
+    "@neta-art/cohub": "2.12.0"
   },
   "publishConfig": {
     "access": "public"