cotal-ai 0.90.0 → 0.91.0

package/dist/docs.js

@@ -0,0 +1,93 @@
+/**
+ * `cotal docs [page]`: the installed version's own protocol and CLI docs, offline. It reads the docs
+ * bundle that ships in `@cotal-ai/connector-core`, the one `cotal_docs` serves agents.
+ *
+ * Registered here, in the composition root, because the CLI package must not depend on an extension.
+ * The bundle is imported inside `run` through its narrow subpath, so no other command loads it.
+ */
+import { registry } from "@cotal-ai/core";
+import { CommandFailure, jsonFlag, plainFlag, presentationOf, writeResult } from "@cotal-ai/workspace";
+const searchFlag = { name: "search", type: "string", value: "<query>", description: "show the sections that best match a query" };
+const refreshFlag = { name: "refresh", type: "boolean", description: "also try the version-pinned copy of the page on docs.cotal.ai" };
+export const docsFlags = [searchFlag, refreshFlag, jsonFlag, plainFlag];
+const usage = (message) => new CommandFailure("refused", "USAGE_INVALID", message);
+async function docs(args) {
+    const v = args.values;
+    const presentation = presentationOf(v);
+    if (args.positionals.length > 1)
+        throw usage("docs takes at most one page");
+    const page = args.positionals[0];
+    const query = v.search?.trim();
+    if (v.search !== undefined && !query)
+        throw usage("--search takes a query");
+    if (page !== undefined && query !== undefined)
+        throw usage("give a page or --search, not both");
+    if (v.refresh && page === undefined)
+        throw usage("--refresh applies to reading a page; the index and search use the bundled docs");
+    const d = await import("@cotal-ai/connector-core/docs");
+    if (page !== undefined) {
+        const read = await d.readDocsPage(page, { refresh: v.refresh });
+        if (!read) {
+            const slugs = ["spec", "lang", "schema", ...d.docsIndex().pages.map((p) => p.slug)];
+            throw usage(`no docs page "${page}"; pages: ${slugs.join(", ")}`);
+        }
+        const result = { kind: "docs-page", version: read.version, slug: read.page.slug, title: read.page.title, source: read.source, refresh: read.refresh, body: read.page.body };
+        writeResult(presentation, { command: "docs", target: null, result }, pageView);
+        return;
+    }
+    if (query !== undefined) {
+        const hits = d.searchDocs(query).map((h) => ({ slug: h.slug, page: h.pageTitle, heading: h.heading, text: d.capSection(h.text) }));
+        const result = { kind: "docs-search", version: d.docsIndex().version, query, hits };
+        writeResult(presentation, { command: "docs", target: null, result }, searchView);
+        return;
+    }
+    const result = { kind: "docs-index", ...d.docsIndex() };
+    writeResult(presentation, { command: "docs", target: null, result }, indexView);
+}
+/** A page's category, the leading words of its kind ("Concept (informative)", "Reference: ..."). */
+const category = (kind) => kind.match(/^[^:(]+/)?.[0].trim() || kind;
+function indexView(r) {
+    const columns = [{ key: "slug", label: "PAGE" }, { key: "title", label: "TITLE" }];
+    const table = (pages) => ({ kind: "table", columns, rows: pages.map((p) => ({ slug: { text: p.slug, tone: "command" }, title: p.title })) });
+    const groups = new Map();
+    for (const p of r.pages)
+        groups.set(category(p.kind), [...(groups.get(category(p.kind)) ?? []), p]);
+    return {
+        sections: [
+            { title: `Cotal v${r.version} documentation`, blocks: [{ kind: "lines", lines: [{ text: "Bundled with this installed version and readable offline.", tone: "hint" }] }] },
+            { title: "Normative sources", blocks: [table(r.sources)] },
+            ...[...groups].map(([title, pages]) => ({ title, blocks: [table(pages)] })),
+            { blocks: [{ kind: "lines", lines: [{ text: "Read a page with `cotal docs <page>`; search with `cotal docs --search <query>`.", tone: "hint" }] }] },
+        ],
+    };
+}
+function pageView(r) {
+    const note = r.refresh === null ? { text: `bundled v${r.version}`, tone: "hint" }
+        : r.refresh === "served" ? { text: `refreshed from docs.cotal.ai: the version-pinned copy for v${r.version}`, tone: "hint" }
+            : { text: `bundled v${r.version}: docs.cotal.ai ${r.refresh === "unreachable" ? "did not answer" : `has no version-pinned copy for v${r.version}`}`, tone: "waiting" };
+    return { sections: [{ blocks: [{ kind: "lines", lines: [note] }] }, { blocks: [{ kind: "lines", lines: r.body.split("\n") }] }] };
+}
+function searchView(r) {
+    if (!r.hits.length)
+        return { sections: [{ blocks: [{ kind: "lines", lines: [{ text: `no matches for "${r.query}" in the Cotal v${r.version} docs; \`cotal docs\` lists the pages, or search an exact identifier`, tone: "hint" }] }] }] };
+    return {
+        sections: r.hits.map((h) => ({
+            title: h.heading,
+            blocks: [{ kind: "lines", lines: [...h.text.split("\n"), { text: `read the full page: cotal docs ${h.slug}`, tone: "hint" }] }],
+        })),
+    };
+}
+const docsCommand = {
+    kind: "command",
+    name: "docs",
+    group: "Setup",
+    summary: "read this version's protocol and CLI docs, offline",
+    usage: "cotal docs [<page>] [--refresh] [--json|--plain] | cotal docs --search <query> [--json|--plain]",
+    positionals: "[<page>]",
+    flags: docsFlags,
+    outputs: ["json", "plain"],
+    examples: ["cotal docs", "cotal docs architecture", "cotal docs --search allowSubscribe", "cotal docs spec --refresh"],
+    reads: true,
+    run: docs,
+};
+registry.register(docsCommand);

package/dist/run.js

@@ -17,6 +17,7 @@ import "@cotal-ai/manager"; // self-registers `supervise` — the agent-supervis
 import "@cotal-ai/delivery"; // self-registers `deliver` — the server-side Plane-3 delivery daemon
 import "@cotal-ai/runtime"; // self-registers `run` — the workflow-run operator surface (start/resume/ps/journal/answer)
 import "@cotal-ai/auth"; // self-registers login / logout — per-user IdP sessions (device-code sign-in)
+import "./docs.js"; // self-registers `docs`; the docs bundle loads only when `docs` runs
 // Self-registers the `ag-ui.frame` part renderer, so `cotal console` and `cotal join` draw an event
 // frame instead of `[unrenderable part kind "ag-ui.frame"]`.
 //
@@ -31,7 +32,7 @@ import "@cotal-ai/auth"; // self-registers login / logout — per-user IdP sessi
 import "@cotal-ai/connector-core/agui-render";
 import { registry } from "@cotal-ai/core";
 // A CLI must exit quietly when its stdout is closed early — piped to `head`, a pager that quits,
-// or a shell's process substitution (`source <(cotal completion bash)`). Node otherwise turns the
+// or a shell's process substitution (`source <(cotal completion script bash)`). Node otherwise turns the
 // closed-pipe write into a fatal unhandled 'error' event with a stack trace. Mirror SIGPIPE: exit
 // 0. Registered before any command can write.
 process.stdout.on("error", (e) => {
@@ -45,7 +46,7 @@ process.stdout.on("error", (e) => {
 // materializes each lazily when a command resolves it; the default agent is `COTAL_DEFAULT_AGENT`
 // (else claude), resolved manager-side. The old `"cotal"` default-agent alias is gone with them.
 //
-// Bare `cotal` prints help; explicit `cotal setup` runs guided setup. The published binary is
+// Bare `cotal` prints the entry screen; explicit `cotal setup` runs guided setup. The published binary is
 // the ONE composition root that loads operator-installed extensions (`cotal ext add …`) — commands,
 // runtimes, connectors, and local process components all self-register from those packages. Library
 // roots keep the explicit-import model.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cotal-ai",
-  "version": "0.90.0",
+  "version": "0.91.0",
   "description": "Cotal — lateral agent coordination over NATS. Run `npx cotal-ai` for the CLI.",
   "license": "Apache-2.0",
   "keywords": [
@@ -33,24 +33,25 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@cotal-ai/auth": "0.90.0",
-    "@cotal-ai/cli": "0.90.0",
-    "@cotal-ai/connector-core": "0.90.0",
-    "@cotal-ai/core": "0.90.0",
-    "@cotal-ai/delivery": "0.90.0",
-    "@cotal-ai/manager": "0.90.0",
-    "@cotal-ai/runtime": "0.90.0",
-    "@cotal-ai/workspace": "0.90.0"
+    "@cotal-ai/auth": "0.91.0",
+    "@cotal-ai/cli": "0.91.0",
+    "@cotal-ai/connector-core": "0.91.0",
+    "@cotal-ai/core": "0.91.0",
+    "@cotal-ai/delivery": "0.91.0",
+    "@cotal-ai/manager": "0.91.0",
+    "@cotal-ai/runtime": "0.91.0",
+    "@cotal-ai/workspace": "0.91.0"
   },
   "devDependencies": {
-    "@cotal-ai/connector-claude-code": "0.90.0",
-    "@cotal-ai/connector-codex": "0.90.0",
-    "@cotal-ai/connector-hermes": "0.90.0",
-    "@cotal-ai/connector-jcode": "0.90.0",
-    "@cotal-ai/connector-opencode": "0.90.0",
-    "@cotal-ai/pi": "0.90.0",
+    "@cotal-ai/connector-claude-code": "0.91.0",
+    "@cotal-ai/connector-codex": "0.91.0",
+    "@cotal-ai/connector-hermes": "0.91.0",
+    "@cotal-ai/connector-jcode": "0.91.0",
+    "@cotal-ai/connector-opencode": "0.91.0",
+    "@cotal-ai/linear": "0.91.0",
+    "@cotal-ai/pi": "0.91.0",
     "@cotal-ai/smoke-kit": "0.0.0",
-    "@cotal-ai/web": "0.90.0",
+    "@cotal-ai/web": "0.91.0",
     "@nats-io/jetstream": "^3.4.0",
     "@nats-io/transport-node": "^3.4.0",
     "typescript": "^5.9.3"
@@ -65,7 +66,7 @@
     "access": "public"
   },
   "scripts": {
-    "test": "tsx smoke/dep-pins.smoke.ts",
+    "test": "tsx smoke/dep-pins.smoke.ts && tsx smoke/capability-census.smoke.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.smoke.json",
     "build": "tsc -p tsconfig.json",
     "seeded-connectors": "node scripts/copy-seeded-connectors.mjs"

package/seeded-connectors/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "cotal",
   "version": "0.0.0",
-  "description": "Join the Cotal mesh: coordinate with other AI agents as lateral peers (presence, messaging, role requests) over NATS. Adds one MCP server, 7 hooks and a monitor. A session the cotal CLI did not launch joins only when it calls cotal_connect, and the monitor then starts a turn when a message arrives.",
+  "description": "Connect Claude Code to a Cotal mesh for presence, messaging and role requests. Includes MCP tools, lifecycle hooks and native incoming-message delivery in supported Code sessions. Each conversation joins only when it calls cotal_connect.",
   "author": { "name": "Cotal", "url": "https://cotal.ai" },
   "homepage": "https://cotal.ai",
   "repository": "https://github.com/Cotal-AI/Cotal",

package/seeded-connectors/claude/dist/carried.d.ts

@@ -1,4 +1,4 @@
-import type { ResumeTranscriptLocator } from "@cotal-ai/core";
+import { type ResumeTranscriptLocator } from "@cotal-ai/core";
 export declare const claudeResumeTranscript: ResumeTranscriptLocator;
 /**
  * Refuse a carried launch this host cannot run, before anything is written: a Claude that ignores
@@ -8,7 +8,9 @@ export declare function refuseCarriedLaunch(binary: string, seatEnv: Record<stri
 /** Where a carried seat writes its fork record: the manager's {@link LaunchSpec.resumeRecordPath}. */
 export declare function carriedForkRecord(home: string): string;
 /** Fill the seat's home: the carried transcript where `--resume` finds it, and the first-run state a
- *  fresh home would otherwise prompt for, trusting the authorized launch directory. */
+ *  fresh home would otherwise prompt for, trusting the authorized launch directory. Neither file is
+ *  written through a symlink: the state takes the private open, and the transcript copy refuses a
+ *  name that already exists. */
 export declare function placeCarried(home: string, transcript: string, resume: string | undefined, cwd: string): Record<string, string>;
 /**
  * Write a carried seat's fork record once Claude has forked: the digest of the transcript its

package/seeded-connectors/claude/dist/carried.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"carried.d.ts","sourceRoot":"","sources":["../src/carried.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAiD9D,eAAO,MAAM,sBAAsB,EAAE,uBAqBpC,CAAC;AAUF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAWzF;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;uFACuF;AACvF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ9H;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAY3F"}
+{"version":3,"file":"carried.d.ts","sourceRoot":"","sources":["../src/carried.ts"],"names":[],"mappings":"AAUA,OAAO,EAAsB,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAiDlF,eAAO,MAAM,sBAAsB,EAAE,uBAqBpC,CAAC;AAUF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAWzF;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;gCAGgC;AAChC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ9H;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAY3F"}