@cotal-ai/connector-claude-code 0.11.3 → 0.11.5

package/dist/transcript.js

@@ -1,203 +0,0 @@
-/**
- * Transcript mirror — publishes this session's own Claude Code transcript (the JSONL
- * behind the hooks' `transcript_path`) onto a per-agent mesh channel, `tr-<name>`, so
- * peers and observer agents can read what the agent is ACTUALLY doing, not only what
- * it chooses to narrate.
- *
- * Off unless the launch sets COTAL_TRANSCRIPT (the connector's buildLaunch sets it for
- * managed sessions; a personal session never mirrors). Flushes ride the lifecycle hooks:
- * read the JSONL from the last offset, condense each entry to its observable surface
- * (assistant text in full, tool calls as one-liners, tool results truncated, thinking
- * omitted), and multicast the batch. The offset starts at end-of-file on adopt, so a
- * resumed session never rebroadcasts history. Publishing is at-least-once: the offset
- * commits only after a successful publish, so a mesh outage replays the batch rather
- * than losing it.
- */
-import { closeSync, fstatSync, openSync, readSync, statSync } from "node:fs";
-const MAX_PREVIEW = 700; // tool results / user prompts — enough to see what happened
-const MAX_CHUNK = 6000; // chars per published message; batches split on entry boundaries
-// The `tr-<name>` convention now lives in connector-core (shared with the manager + opencode
-// connector). Re-exported here so existing imports (mcp.ts, index.ts) keep resolving.
-export { transcriptChannel } from "@cotal-ai/connector-core";
-function truncate(s, max) {
-    return s.length > max ? `${s.slice(0, max - 1)}…` : s;
-}
-/** A tool call's most salient input, mirroring the presence preview in mcp.ts. */
-function salient(input) {
-    const i = (input ?? {});
-    const v = i.command ?? i.file_path ?? i.path ?? i.url ?? i.pattern ?? i.description;
-    const s = typeof v === "string" ? v : Object.keys(i).length ? JSON.stringify(i) : "";
-    return s ? `: ${truncate(s, 300)}` : "";
-}
-/** Flatten a tool_result's content (string or text-block array) to plain text. */
-function resultText(content) {
-    if (typeof content === "string")
-        return content;
-    if (Array.isArray(content))
-        return content
-            .map((b) => (typeof b?.text === "string" ? b.text : ""))
-            .filter(Boolean)
-            .join("\n");
-    return "";
-}
-/** One JSONL entry → the lines worth mirroring (empty for meta/system/thinking-only entries). */
-function condense(line) {
-    let e;
-    try {
-        e = JSON.parse(line);
-    }
-    catch {
-        return [];
-    }
-    if (!e || e.isMeta)
-        return [];
-    const content = e.message?.content;
-    if (e.type === "assistant" && Array.isArray(content)) {
-        const out = [];
-        for (const b of content) {
-            if (b.type === "text" && b.text?.trim())
-                out.push(b.text.trim());
-            else if (b.type === "tool_use" && b.name)
-                out.push(`⚒ ${b.name}${salient(b.input)}`);
-        }
-        return out;
-    }
-    if (e.type === "user") {
-        if (typeof content === "string")
-            return content.trim() ? [`» ${truncate(content.trim(), MAX_PREVIEW)}`] : [];
-        if (Array.isArray(content)) {
-            const out = [];
-            for (const b of content) {
-                if (b.type === "tool_result") {
-                    const t = resultText(b.content).trim();
-                    out.push(`→ ${b.is_error ? "ERROR: " : ""}${t ? truncate(t, MAX_PREVIEW) : "(no output)"}`);
-                }
-                else if (b.type === "text" && b.text?.trim()) {
-                    out.push(`» ${truncate(b.text.trim(), MAX_PREVIEW)}`);
-                }
-            }
-            return out;
-        }
-    }
-    return [];
-}
-export class TranscriptMirror {
-    agent;
-    channel;
-    path;
-    offset = 0;
-    /** A batch that failed mid-publish: chunks + how many already landed. Retried (from the
-     *  first unsent chunk — never re-sending a delivered one) before any new read. */
-    pending;
-    /** ALL path/offset mutation and publishing runs on this serialized chain — hook events
-     *  land concurrently on the control socket. */
-    chain = Promise.resolve();
-    constructor(agent, channel) {
-        this.agent = agent;
-        this.channel = channel;
-    }
-    /** Adopt the transcript at its CURRENT end — mirror only what happens from now on, so a
-     *  resumed session (or a mirror that first sees the path mid-session) never rebroadcasts. */
-    adopt(path) {
-        this.enqueue(() => {
-            this.adoptNow(path);
-            return Promise.resolve();
-        });
-    }
-    /** Queue a flush of new transcript entries to the channel. Never throws, never blocks the
-     *  hook reply — the read+publish runs on the serialized chain. */
-    flush(path) {
-        this.enqueue(() => {
-            if (!this.path)
-                this.adoptNow(path);
-            return this.doFlush();
-        });
-    }
-    enqueue(step) {
-        this.chain = this.chain.then(step).catch((e) => {
-            process.stderr.write(`[cotal-connector] transcript mirror: ${e.message}\n`);
-        });
-    }
-    adoptNow(path) {
-        if (typeof path !== "string" || !path || this.path === path)
-            return;
-        this.path = path;
-        this.pending = undefined; // a batch from the old path must not commit the new offset
-        try {
-            this.offset = statSync(path).size;
-        }
-        catch {
-            this.offset = 0; // not written yet — everything from byte 0 is this session's
-        }
-    }
-    async doFlush() {
-        if (!this.path || !this.agent.connected)
-            return; // offset untouched — catch up next flush
-        if (!this.pending) {
-            const { lines, nextOffset } = this.readComplete();
-            if (nextOffset === this.offset)
-                return; // nothing new
-            this.pending = { chunks: chunkLines(lines.flatMap(condense), MAX_CHUNK), sent: 0, nextOffset };
-        }
-        // Publish the pinned batch, tracking per-chunk progress: a mid-batch failure resumes at
-        // the first UNSENT chunk (no duplicates), and only a fully delivered batch commits the
-        // offset — the read range stays pinned until then.
-        const p = this.pending;
-        while (p.sent < p.chunks.length) {
-            await this.agent.send(p.chunks[p.sent], this.channel);
-            p.sent++;
-        }
-        this.offset = p.nextOffset;
-        this.pending = undefined;
-    }
-    /** New complete lines since the offset (a trailing partial line stays for the next flush). */
-    readComplete() {
-        const none = () => ({ lines: [], nextOffset: this.offset }); // evaluated late — after any truncation reset
-        let fd;
-        try {
-            fd = openSync(this.path, "r");
-        }
-        catch {
-            return none();
-        }
-        try {
-            const size = fstatSync(fd).size;
-            if (size < this.offset)
-                this.offset = 0; // truncated/rotated — start over
-            if (size === this.offset)
-                return none();
-            const buf = Buffer.alloc(size - this.offset);
-            readSync(fd, buf, 0, buf.length, this.offset);
-            const text = buf.toString("utf8");
-            const lastNl = text.lastIndexOf("\n");
-            if (lastNl < 0)
-                return none();
-            return {
-                lines: text.slice(0, lastNl).split("\n").filter(Boolean),
-                nextOffset: this.offset + Buffer.byteLength(text.slice(0, lastNl + 1), "utf8"),
-            };
-        }
-        finally {
-            closeSync(fd);
-        }
-    }
-}
-/** Pack lines into chunks of at most `max` chars, splitting only on line boundaries
- *  (an oversized single line becomes its own chunk — never dropped). */
-function chunkLines(lines, max) {
-    const chunks = [];
-    let cur = "";
-    for (const line of lines) {
-        if (cur && cur.length + 1 + line.length > max) {
-            chunks.push(cur);
-            cur = line;
-        }
-        else {
-            cur = cur ? `${cur}\n${line}` : line;
-        }
-    }
-    if (cur)
-        chunks.push(cur);
-    return chunks;
-}
-//# sourceMappingURL=transcript.js.map

package/dist/transcript.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"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"}