coolhand-cli 0.11.1 → 0.13.0

package/dist/sessions/copilot-scanner.js

@@ -0,0 +1,171 @@
+/** Event types `parseCopilotExchanges` reads; the rest (model snapshots, permissions, hooks) are skipped before parsing. */
+const WANTED = new Set(['skill.invoked', 'user.message', 'assistant.message', 'tool.execution_complete', 'session.usage_record']);
+const TYPE_PREFIX = /^\{"type":"([^"]*)"/;
+/** A line whose type can't be read is parsed anyway, unless it is this big. */
+const MAX_UNTYPED_LINE_CHARS = 1000000;
+/** Whether a transcript line is one `parseCopilotExchanges` needs. Cheap: reads only the line's type, without parsing it. */
+export function isWantedLine(line) {
+    const type = TYPE_PREFIX.exec(line)?.[1];
+    return type === undefined ? line.length <= MAX_UNTYPED_LINE_CHARS : WANTED.has(type);
+}
+function obj(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function text(value) {
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : 0;
+}
+/**
+ * Copilot counts cached tokens inside `inputTokens`; the ingest API wants them apart, as Claude Code writes them.
+ */
+function usageFrom(raw) {
+    const u = obj(raw);
+    if (!u) {
+        return undefined;
+    }
+    const cacheRead = num(u.cacheReadTokens);
+    const cacheWrite = num(u.cacheWriteTokens);
+    return {
+        input_tokens: Math.max(num(u.inputTokens) - cacheRead - cacheWrite, 0),
+        output_tokens: num(u.outputTokens),
+        cache_read_input_tokens: cacheRead,
+        cache_creation_input_tokens: cacheWrite,
+    };
+}
+/** What a tool returned. A failed call has not been seen in a recording, so its error text is looked for where it plausibly is. */
+function resultText(result) {
+    const r = obj(result);
+    const candidates = [r?.content, r?.detailedContent, obj(r?.error)?.message];
+    const content = candidates.find((c) => typeof c === 'string' && c.trim()) ?? r?.content ?? r?.error;
+    if (typeof content === 'string') {
+        return content;
+    }
+    return content === undefined ? '' : JSON.stringify(content);
+}
+/**
+ * Walk a Copilot `events.jsonl` (VS Code agent mode) and return its user→assistant exchanges in order.
+ * An exchange starts at a `user.message` and holds what followed as raw messages: each model call's
+ * thinking, text and tool calls as one assistant message, and each batch of tool results as one user
+ * message. A `skill.invoked` event the user typed (`trigger: user-invoked`) is attached to the exchange of the
+ * prompt that comes next; one the model loaded during a turn is attached to the exchange already open. Unreadable
+ * lines are skipped. Pure function, never throws.
+ */
+export function parseCopilotExchanges(content) {
+    const exchanges = [];
+    let model;
+    let current;
+    let pendingSkills = [];
+    const add = (exchange, message) => {
+        (exchange.messages ?? (exchange.messages = [])).push(message);
+    };
+    for (const line of content.split('\n')) {
+        if (!line.trim() || !isWantedLine(line)) {
+            continue;
+        }
+        let event;
+        try {
+            event = obj(JSON.parse(line));
+        }
+        catch {
+            continue;
+        }
+        const data = obj(event?.data);
+        if (!event || !data) {
+            continue;
+        }
+        const timestamp = text(event.timestamp);
+        switch (event.type) {
+            case 'skill.invoked': {
+                const file = text(data.path);
+                const name = text(data.name);
+                if (name) {
+                    const skill = { name, dir: file ? file.replace(/[\\/][^\\/]*$/, '') : name, text: text(data.content) ?? '' };
+                    // A skill the user typed (`/skill`) is logged just BEFORE its prompt. One the model loads itself is
+                    // logged during the turn it belongs to, so it goes to the exchange already open.
+                    if (current && text(data.trigger) !== undefined && data.trigger !== 'user-invoked') {
+                        (current.skills ?? (current.skills = [])).push(skill);
+                    }
+                    else {
+                        pendingSkills.push(skill);
+                    }
+                }
+                break;
+            }
+            case 'user.message': {
+                current = { userText: text(data.content), timestamp };
+                if (pendingSkills.length > 0) {
+                    current.skills = pendingSkills;
+                    pendingSkills = [];
+                }
+                exchanges.push(current);
+                break;
+            }
+            case 'assistant.message': {
+                if (!current) {
+                    break;
+                }
+                const blocks = [];
+                const reasoning = text(data.reasoningText);
+                if (reasoning) {
+                    blocks.push({ type: 'thinking', thinking: reasoning });
+                }
+                const reply = text(data.content);
+                if (reply) {
+                    blocks.push({ type: 'text', text: reply });
+                }
+                const requests = Array.isArray(data.toolRequests) ? data.toolRequests : [];
+                for (const request of requests) {
+                    const r = obj(request);
+                    if (r && text(r.name)) {
+                        blocks.push({ type: 'tool_use', id: text(r.toolCallId), name: r.name, input: r.arguments ?? {} });
+                    }
+                }
+                const key = text(data.messageId);
+                model = text(data.model) ?? model;
+                if (blocks.length > 0) {
+                    add(current, { role: 'assistant', key, blocks });
+                }
+                // The final reply is the last message that answers in text without asking for a tool.
+                if (reply && requests.length === 0) {
+                    current.assistantText = reply;
+                    current.assistantKey = key;
+                }
+                break;
+            }
+            case 'tool.execution_complete': {
+                if (!current) {
+                    break;
+                }
+                const block = { type: 'tool_result', tool_use_id: text(data.toolCallId), content: resultText(data.result), is_error: data.success === false };
+                const last = current.messages?.[current.messages.length - 1];
+                if (last && last.role === 'user') {
+                    last.blocks.push(block);
+                }
+                else {
+                    add(current, { role: 'user', blocks: [block] });
+                }
+                break;
+            }
+            case 'session.usage_record': {
+                // Only the conversation's own model calls (every recorded call of the main thread says so); other
+                // kinds of call, such as background helpers, are not what this turn spent.
+                const kind = text(obj(data.usage)?.interactionType);
+                const usage = kind === undefined || kind === 'conversation-agent' ? usageFrom(data.usage) : undefined;
+                if (current && usage) {
+                    const total = (current.usage ?? (current.usage = { input_tokens: 0, output_tokens: 0, cache_read_input_tokens: 0, cache_creation_input_tokens: 0 }));
+                    total.input_tokens += usage.input_tokens;
+                    total.output_tokens += usage.output_tokens;
+                    total.cache_read_input_tokens += usage.cache_read_input_tokens;
+                    total.cache_creation_input_tokens += usage.cache_creation_input_tokens;
+                }
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    return { exchanges, model };
+}
+//# sourceMappingURL=copilot-scanner.js.map

package/dist/sessions/copilot-scanner.js.map

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

package/dist/sessions/redact-secrets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redact-secrets.d.ts","sourceRoot":"","sources":["../../src/sessions/redact-secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA0CH,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWlD"}
+{"version":3,"file":"redact-secrets.d.ts","sourceRoot":"","sources":["../../src/sessions/redact-secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA8EH,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBlD"}

package/dist/sessions/redact-secrets.js

@@ -14,24 +14,35 @@ const TOKEN_PATTERNS = [
     /ch_pub_[A-Za-z0-9_-]{8,}/g, // Coolhand public token
     /ch_priv_[A-Za-z0-9_-]{8,}/g, // Coolhand private token
     /sk-[A-Za-z0-9_-]{16,}/g, // OpenAI / Anthropic style secret key
-    /ghp_[A-Za-z0-9]{20,}/g, // GitHub personal access token
-    /gho_[A-Za-z0-9]{20,}/g, // GitHub OAuth token
+    /gh[pousr]_[A-Za-z0-9]{20,}/g, // GitHub personal access / OAuth / user-to-server / server-to-server / refresh token
     /github_pat_[A-Za-z0-9_]{20,}/g, // GitHub fine-grained PAT
-    /AKIA[0-9A-Z]{16}/g, // AWS access key id
+    /\b(?:AKIA|ASIA|AROA|AIDA)[0-9A-Z]{16}\b/g, // AWS access key id (long-lived and temporary)
     /xox[baprs]-[A-Za-z0-9-]{10,}/g, // Slack token (bot/user/app/refresh/config)
+    /xapp-\d-[A-Za-z0-9-]{10,}/g, // Slack app-level token
+    /SG\.[\w-]{16,}\.[\w-]{16,}/g, // SendGrid API key
+    /\b(?:rk_live|rk_test)_[0-9A-Za-z]{16,}/g, // Stripe restricted key
+    /whsec_[A-Za-z0-9]{24,}/g, // Stripe webhook signing secret
     /AIza[0-9A-Za-z_-]{35}/g, // Google API key
     /sk_live_[0-9A-Za-z]{16,}/g, // Stripe live secret key
     /sk_test_[0-9A-Za-z]{16,}/g, // Stripe test secret key
-    /\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g, // JWT (three base64url segments)
+    /\beyJ[A-Za-z0-9_-]{1,4096}\.[A-Za-z0-9_-]{1,4096}\.[A-Za-z0-9_-]{1,4096}/g, // JWT (three base64url segments)
     /\bBearer\s+[A-Za-z0-9._~+/-]{12,}=*/gi, // Authorization: Bearer <token>
     /\bBasic\s+[A-Za-z0-9+/=]{8,}/gi, // Authorization: Basic <base64 user:pass>
     /https:\/\/hooks\.slack\.com\/services\/\S+/g, // Slack incoming webhook URL
     /https:\/\/discord(?:app)?\.com\/api\/webhooks\/\S+/g, // Discord webhook URL
+    /npm_[A-Za-z0-9]{36}/g, // npm access token
+    /glpat-[A-Za-z0-9_-]{20,}/g, // GitLab personal access token
+    /hf_[A-Za-z0-9]{30,}/g, // Hugging Face token
+    /ya29\.[A-Za-z0-9_-]+/g, // Google OAuth access token
+    /pypi-[A-Za-z0-9_-]{20,}/g, // PyPI API token
+    /\b([a-z][a-z0-9+.-]{0,31}:\/\/)[^\s/:@]*:[^\s/]+@/gi, // credentials embedded in a URL (scheme://user:pass@host, empty user allowed, `@` inside the password)
     /\b[A-Fa-f0-9]{40,}\b/g, // long hex blobs (generic tokens / hashes)
     // PEM-formatted private key blocks (SSH/RSA/EC/OpenSSH/PGP/encrypted) — no assignment keyword
     // sits next to the base64 body, so ASSIGNMENT_QUOTED/BARE never catch these; a `cat ~/.ssh/id_rsa`
     // in a tool output or a deploy key embedded in a config file would otherwise sail through whole.
-    /-----BEGIN [A-Z0-9 ]*PRIVATE KEY[A-Z0-9 ]*-----[\s\S]*?-----END [A-Z0-9 ]*PRIVATE KEY[A-Z0-9 ]*-----/g,
+    // The body is bounded and may end at the next BEGIN header or the end of the text, so a truncated key
+    // (`head -5 id_rsa`) is still redacted and a long run of unterminated headers cannot go quadratic.
+    /-----BEGIN [A-Z0-9 ]*PRIVATE KEY[A-Z0-9 ]*-----[\s\S]{0,16384}?(?:-----END [A-Z0-9 ]*PRIVATE KEY[A-Z0-9 ]*-----|(?=-----BEGIN )|$)/g,
 ];
 // Two variants: a QUOTED value may contain spaces ("my secret value"); a BARE value stops at
 // whitespace. Splitting them closes the gap where a spaced quoted secret was only partly redacted.
@@ -40,9 +51,32 @@ const TOKEN_PATTERNS = [
 // this was originally written for), so plain JSON — the dominant config format under
 // `~/.claude` — is covered too, not just unquoted-key assignment syntax.
 // The opening quote may be backslash-escaped (`\\"value\\"`): session payloads are JSON.stringify'd
-// before redaction, so a quoted shell assignment inside a tool input arrives with escaped quotes.
-const ASSIGNMENT_QUOTED = /((?:api[_-]?key|secret|token|password|passwd|access[_-]?key|private[_-]?key)\b["']?\s*[:=]\s*)(\\?['"])[^'"]*\2/gi;
-const ASSIGNMENT_BARE = /((?:api[_-]?key|secret|token|password|passwd|access[_-]?key|private[_-]?key)\b["']?\s*[:=]\s*)[^\s'"]+/gi;
+// before redaction, so a quoted shell assignment inside a tool input arrives with escaped quotes. A BARE value
+// never starts with such a backslash-quote, so it cannot re-match what the QUOTED pass just redacted.
+// A keyword may carry a `_value`/`_header` suffix (`CLIENT_SECRET_VALUE=`). `pass` and `pwd` count only inside a compound name (`DB_PASS`, `MYSQL_PWD`), so `bypass:` and `Tests pass:` are not secrets.
+const KEYWORDS = String.raw `(?:api[_-]?key|secret(?:[_-]?key)?|token|password|passwd|(?<=[_-])(?:pass|pwd)|passphrase|credentials?|auth[_-]?header|access[_-]?key|private[_-]?key|auth[_-]?key|signing[_-]?key|encryption[_-]?key)(?:[_-]?(?:value|header))?`;
+// A value can be `Bearer <token>`: take the scheme word with it, or the token pattern below never sees `Bearer`.
+// Values that are settings, not secrets (`credentials: "include"` in a fetch call, `"token": null`).
+const NOT_A_SECRET = String.raw `(?!(?:include|omit|same-origin|true|false|null)\b)`;
+// A bare value is a scalar: `{` or `[` opens a JSON object or array (`"token":{...}`), which it must not swallow.
+const NOT_A_STRUCTURE = String.raw `(?![{\[])`;
+const SCHEME = String.raw `(?:(?:bearer|basic|token|digest|negotiate)[ \t]+)?`;
+const ASSIGNMENT_QUOTED = new RegExp(String.raw `((?:${KEYWORDS})\b["']?\s*[:=]\s*)(\\?['"])${NOT_A_SECRET}[^'"]*\2`, 'gi');
+const ASSIGNMENT_BARE = new RegExp(String.raw `((?:${KEYWORDS})\b["']?\s*[:=]\s*)${NOT_A_SECRET}${NOT_A_STRUCTURE}${SCHEME}(?:\\\\|\\(?!['"])|[^\s'"\\])+`, 'gi');
+// Cookie and authorization headers. Redacting JSON-stringified text (one line, the header inside a string) must
+// leave it parseable, so a value stops at a quote, backslash or line end. A JSON-keyed header (`"Cookie":"sid=1"`)
+// is a value whatever it looks like; in plain text only a `name=value` cookie or a scheme-word authorization
+// (or one long opaque token) counts, so `const cookie: string` and "the Authorization: header" are left alone.
+const HEADER_JSON = /((?<![\w-])(?:(?:set-)?cookie|(?:proxy-)?authorization)\\?["']?\s*[:=]\s*\\?["'])[^"'\\]+/gi;
+const HEADER_COOKIE = /((?<![\w-])(?:set-)?cookie[ \t]*:[ \t]*)[\w.%+-]{1,200}=[^\r\n"'\\`}]*/gi;
+const HEADER_AUTH = /((?<![\w-])(?:proxy-)?authorization[ \t]*[:=][ \t]*)(?:(?:bearer|basic|token|digest|negotiate|apikey|ntlm|hmac|oauth)[ \t]+[^\r\n"'\\`}]+|[^\s"'\\`}]{16,})/gi;
+// A secret given as a command-line flag with its value after a space (`--password hunter2`, `-u admin:s3cr3t`):
+// no `:` or `=` joins them, so the assignment patterns above never see it. The value may be quoted, or
+// backslash-quoted when the text was JSON-stringified; the quoted forms are bounded so an unclosed quote is cheap.
+const CLI_SECRET_FLAG = /((?<![\w-])--?(?:(?:[a-z]{1,20}-){0,3}(?:password|passwd|token|secret|api-?key|auth(?:orization)?|access-?key|private-?key)(?:-(?:key|value))?|pass|pwd)(?:[ \t]{1,10}|=))(?:(?:bearer|basic|token|digest|negotiate)[ \t]+)?(?:\\["'][^\\]{0,500}\\["']|'[^']{0,500}'|"[^"]{0,500}"|[^\s'"\\]+)/gi;
+// `curl -u user:pass`, also `--user`, a flag cluster (`-su`), a quoted credential and a `\`-newline continuation.
+// The separator and the user name share no characters, so a long run of `=` cannot backtrack quadratically.
+const CLI_BASIC_AUTH = /((?<![\w-])curl\b(?:[^\n]|\\\r?\n){0,500}?\s(?:--user|-[a-zA-Z]{0,5}u)(?:[ \t]{1,10}|=)\\?["']?)[^\s:='"\\]+:[^\s'"\\]+/g;
 const REDACTED = '[REDACTED]';
 /** Return `text` with recognised secrets replaced by `[REDACTED]`. Safe on empty input. */
 export function redactSecrets(text) {
@@ -51,9 +85,14 @@ export function redactSecrets(text) {
     }
     let out = text
         .replace(ASSIGNMENT_QUOTED, `$1$2${REDACTED}$2`)
-        .replace(ASSIGNMENT_BARE, `$1${REDACTED}`);
+        .replace(ASSIGNMENT_BARE, `$1${REDACTED}`)
+        .replace(HEADER_JSON, `$1${REDACTED}`)
+        .replace(HEADER_COOKIE, `$1${REDACTED}`)
+        .replace(HEADER_AUTH, `$1${REDACTED}`)
+        .replace(CLI_SECRET_FLAG, `$1${REDACTED}`)
+        .replace(CLI_BASIC_AUTH, `$1${REDACTED}`);
     for (const pattern of TOKEN_PATTERNS) {
-        out = out.replace(pattern, REDACTED);
+        out = out.replace(pattern, (_match, scheme) => (typeof scheme === 'string' ? `${scheme}${REDACTED}@` : REDACTED));
     }
     return out;
 }

package/dist/sessions/redact-secrets.js.map

@@ -1 +1 @@
-{"version":3,"file":"redact-secrets.js","sourceRoot":"","sources":["../../src/sessions/redact-secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uEAAuE;AACvE,MAAM,cAAc,GAAsB;IACxC,2BAA2B,EAAE,wBAAwB;IACrD,4BAA4B,EAAE,yBAAyB;IACvD,wBAAwB,EAAE,sCAAsC;IAChE,uBAAuB,EAAE,+BAA+B;IACxD,uBAAuB,EAAE,qBAAqB;IAC9C,+BAA+B,EAAE,0BAA0B;IAC3D,mBAAmB,EAAE,oBAAoB;IACzC,+BAA+B,EAAE,4CAA4C;IAC7E,wBAAwB,EAAE,iBAAiB;IAC3C,2BAA2B,EAAE,yBAAyB;IACtD,2BAA2B,EAAE,yBAAyB;IACtD,sDAAsD,EAAE,iCAAiC;IACzF,uCAAuC,EAAE,gCAAgC;IACzE,gCAAgC,EAAE,0CAA0C;IAC5E,6CAA6C,EAAE,6BAA6B;IAC5E,qDAAqD,EAAE,sBAAsB;IAC7E,uBAAuB,EAAE,2CAA2C;IACpE,8FAA8F;IAC9F,mGAAmG;IACnG,iGAAiG;IACjG,uGAAuG;CACxG,CAAC;AAEF,6FAA6F;AAC7F,mGAAmG;AACnG,+FAA+F;AAC/F,oGAAoG;AACpG,qFAAqF;AACrF,yEAAyE;AACzE,oGAAoG;AACpG,kGAAkG;AAClG,MAAM,iBAAiB,GACrB,mHAAmH,CAAC;AACtH,MAAM,eAAe,GACnB,0GAA0G,CAAC;AAE7G,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,GAAG,IAAI;SACX,OAAO,CAAC,iBAAiB,EAAE,OAAO,QAAQ,IAAI,CAAC;SAC/C,OAAO,CAAC,eAAe,EAAE,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC7C,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"redact-secrets.js","sourceRoot":"","sources":["../../src/sessions/redact-secrets.ts"],"names":[],"mappings":"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"}

package/dist/sessions/turn-envelope.d.ts

@@ -0,0 +1,62 @@
+import { MAX_TURN_TEXT_CHARS } from './blocks.js';
+import type { CaptureEnvelope } from './claude-scanner.js';
+import { type SubagentUsage, type Usage } from './usage.js';
+import type { HookAgent, HookTurn, TurnMessage } from '../hooks/types.js';
+export { MAX_TURN_TEXT_CHARS };
+/**
+ * Cap on the characters of EARLIER messages sent with a turn (the current turn's own user message is
+ * extra, and is itself capped at MAX_TURN_TEXT_CHARS). The payload grows with the conversation, so
+ * when the history would exceed this the OLDEST whole exchanges are dropped and the most recent are
+ * kept: the server should expect a truncated head, flagged by `metadata.history_truncated`. The newest
+ * earlier exchange is always kept, even if it alone is over the cap. Counted in characters (UTF-16
+ * code units), not bytes.
+ */
+export declare const HISTORY_BUDGET_CHARS = 200000;
+export interface PreparedMessages {
+    /** The conversation so far, ending on the current turn's user message (when there is one). */
+    messages: TurnMessage[];
+    /** Messages dropped from the start of the history to stay inside HISTORY_BUDGET_CHARS (a count of messages in the transcript window: one that redacts to nothing is still counted, and anything older than the window is not). */
+    omitted: number;
+    /** True when part of the conversation since the skill was invoked is not in `messages`. */
+    truncated: boolean;
+    /**
+     * Tokens the main-thread assistant messages spent across the same exchanges as the history, plus
+     * this turn's: a CUMULATIVE total, so a replayed or late older turn can't double count. Absent when
+     * the transcript shows none.
+     */
+    usage?: Usage;
+    /** The same, for subagents (other models, so priced separately). Absent when there were none. */
+    subagents?: SubagentUsage;
+}
+/**
+ * The messages sent with turn `turnIndex`: every earlier message (prompts, thinking, tool calls and results,
+ * replies) since the skill was invoked, in order, then this turn's user message. "Since the skill was invoked" is the session's
+ * `anchor` — the timestamp of its first captured turn — and only exchanges a hook actually captured
+ * (`captured`) are included, so nothing the user said before the skill ran, or while capture was off,
+ * is uploaded, however many exchanges the transcript holds that no hook saw (`/compact`, image
+ * prompts, a second Stop for one prompt). Without a usable anchor there is no history at all. What is
+ * sent is prompts, thinking, tool calls and results and replies, redacted and capped like the turn
+ * itself. If the start of the skill's conversation is no longer in the transcript window, or the history is over budget, the OLDEST part is what is missing and
+ * `truncated` is set.
+ */
+export declare function prepareTurnMessages(turn: HookTurn, turnIndex: number, anchor: string | undefined, captured: ReadonlySet<string>): PreparedMessages;
+/**
+ * An Anthropic-shaped envelope for ONE turn captured by a hook, carrying the conversation so far.
+ *
+ * `request_body.messages` is the conversation since the skill was invoked, in order, ending on the last
+ * message before this turn's reply (`prepareTurnMessages`, passed in as `prepared`); `response_body` is this turn's
+ * reply. The server keeps one chat log per session and the newest turn replaces the stored one, so a
+ * late-arriving older turn (a replay) is ignored by it.
+ *
+ * The url is `coolhand-hook://<agent>/session/<id>/turn/<n>` — deliberately NOT the
+ * `claudecode://session/<id>` scheme `analyze-claude-sessions` uses. The server needs the session id
+ * and the turn number from it. `response_body.id` is `<session>:<turn>:<digest>`, and the digest ties
+ * it to the turn's content. It is no longer the server's dedup key, but stays unique per turn for
+ * debugging and correlation. What goes in is the conversation as structured blocks: prompts, thinking,
+ * tool calls, tool results and replies (subagent traffic and injected context excluded), all
+ * secret-scrubbed and capped (see blocks.ts).
+ */
+export declare function buildTurnEnvelope(agent: HookAgent, turn: HookTurn, turnIndex: number, digest: string, prepared: PreparedMessages, 
+/** The skill's text, sent as `request_body.system`. Redacted and capped here again, so state saved by an older version is scrubbed too. */
+system?: string): CaptureEnvelope;
+//# sourceMappingURL=turn-envelope.d.ts.map

package/dist/sessions/turn-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-envelope.d.ts","sourceRoot":"","sources":["../../src/sessions/turn-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA6E,MAAM,aAAa,CAAC;AAC7H,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAyE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACnI,OAAO,KAAK,EAAmB,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE3F,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,8FAA8F;IAC9F,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,kOAAkO;IAClO,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,iGAAiG;IACjG,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AA2CD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,gBAAgB,CA0ElB;AAWD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB;AAC1B,2IAA2I;AAC3I,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,CAqBjB"}

package/dist/sessions/turn-envelope.js

@@ -0,0 +1,182 @@
+import { MAX_TURN_TEXT_CHARS, cleanText, messageSize, sanitizeBlock, sanitizeMessage } from './blocks.js';
+import { addUsage, emptySubagentUsage, emptyUsage, mergeSubagents, totalTokens } from './usage.js';
+export { MAX_TURN_TEXT_CHARS };
+/**
+ * Cap on the characters of EARLIER messages sent with a turn (the current turn's own user message is
+ * extra, and is itself capped at MAX_TURN_TEXT_CHARS). The payload grows with the conversation, so
+ * when the history would exceed this the OLDEST whole exchanges are dropped and the most recent are
+ * kept: the server should expect a truncated head, flagged by `metadata.history_truncated`. The newest
+ * earlier exchange is always kept, even if it alone is over the cap. Counted in characters (UTF-16
+ * code units), not bytes.
+ */
+export const HISTORY_BUDGET_CHARS = 200000;
+function promptMessage(userText) {
+    return { role: 'user', content: cleanText(userText) };
+}
+/**
+ * One exchange as redacted, capped messages: the prompt, then everything the transcript shows after it
+ * (thinking, tool calls, tool results, replies) in order. A hand-built exchange with only reply text
+ * (no transcript behind it) falls back to prompt + reply.
+ */
+function exchangeMessages(exchange) {
+    const out = [promptMessage(exchange.userText)];
+    if (exchange.messages) {
+        for (const raw of exchange.messages) {
+            const message = sanitizeMessage(raw);
+            if (message) {
+                out.push(message);
+            }
+        }
+    }
+    else if (exchange.assistantText) {
+        const reply = cleanText(exchange.assistantText);
+        if (reply) {
+            out.push({ role: 'assistant', content: reply });
+        }
+    }
+    return out;
+}
+/** Characters an exchange will occupy once capped (an estimate: redaction usually shortens it, but `[REDACTED]` can replace a shorter secret). */
+function cappedSize(exchange) {
+    const prompt = Math.min(exchange.userText.length, MAX_TURN_TEXT_CHARS);
+    if (exchange.messages) {
+        return prompt + exchange.messages.reduce((n, m) => n + messageSize(m), 0);
+    }
+    return prompt + Math.min(exchange.assistantText?.length ?? 0, MAX_TURN_TEXT_CHARS);
+}
+/** How many messages an exchange would have contributed (for `omitted`). */
+function messageCount(exchange) {
+    return 1 + (exchange.messages ? exchange.messages.length : exchange.assistantText ? 1 : 0);
+}
+/**
+ * The messages sent with turn `turnIndex`: every earlier message (prompts, thinking, tool calls and results,
+ * replies) since the skill was invoked, in order, then this turn's user message. "Since the skill was invoked" is the session's
+ * `anchor` — the timestamp of its first captured turn — and only exchanges a hook actually captured
+ * (`captured`) are included, so nothing the user said before the skill ran, or while capture was off,
+ * is uploaded, however many exchanges the transcript holds that no hook saw (`/compact`, image
+ * prompts, a second Stop for one prompt). Without a usable anchor there is no history at all. What is
+ * sent is prompts, thinking, tool calls and results and replies, redacted and capped like the turn
+ * itself. If the start of the skill's conversation is no longer in the transcript window, or the history is over budget, the OLDEST part is what is missing and
+ * `truncated` is set.
+ */
+export function prepareTurnMessages(turn, turnIndex, anchor, captured) {
+    const anchorMs = anchor ? Date.parse(anchor) : Number.NaN;
+    const earlier = turn.earlier ?? [];
+    // Exchanges at or after the anchor that a hook actually captured, in order. One with no usable
+    // timestamp can't be placed, so it is left out (fail closed); inside the skill's conversation that
+    // is a gap worth flagging. So is an answered exchange no hook captured (capture was off, or the hook
+    // was killed): it is never swept up into a later upload. An uncaptured exchange with no reply (a
+    // command, an interrupted prompt) is dropped quietly, because there was no turn to capture.
+    const since = [];
+    let gap = false;
+    const usage = emptyUsage();
+    const subagents = emptySubagentUsage();
+    addUsage(usage, turn.usage);
+    mergeSubagents(subagents, turn.subagents);
+    if (turnIndex > 1 && !Number.isNaN(anchorMs)) {
+        for (const e of earlier) {
+            const ms = e.timestamp ? Date.parse(e.timestamp) : Number.NaN;
+            if (Number.isNaN(ms)) {
+                gap || (gap = since.length > 0);
+            }
+            else if (ms >= anchorMs) {
+                if (e.timestamp && captured.has(e.timestamp)) {
+                    since.push(e);
+                    addUsage(usage, e.usage);
+                    mergeSubagents(subagents, e.subagents);
+                }
+                else if (e.assistantText) {
+                    gap = true;
+                }
+            }
+        }
+    }
+    // Newest first, so the budget keeps the most recent; the newest is kept whatever its size.
+    const kept = [];
+    let used = 0;
+    for (let i = since.length - 1; i >= 0; i--) {
+        const size = cappedSize(since[i]);
+        if (kept.length > 0 && used + size > HISTORY_BUDGET_CHARS) {
+            break;
+        }
+        kept.unshift(since[i]);
+        used += size;
+    }
+    const dropped = since.slice(0, since.length - kept.length);
+    const omitted = dropped.reduce((n, e) => n + messageCount(e), 0);
+    const messages = kept.flatMap(exchangeMessages);
+    if (turn.userText) {
+        messages.push(promptMessage(turn.userText));
+    }
+    // This turn's own tool loop (everything up to, not including, its final reply).
+    for (const raw of turn.currentMessages ?? []) {
+        const message = sanitizeMessage(raw);
+        if (message) {
+            messages.push(message);
+        }
+    }
+    // Did we see where the skill's conversation began? Turn 1 is that start; later turns need the
+    // anchor's own exchange to still be in the window.
+    const stamps = turn.earlierStamps ?? earlier.flatMap((e) => (e.timestamp ? [e.timestamp] : []));
+    // A captured exchange that can't be rendered (an image-only prompt: no text of its own, so there is
+    // no user message to pair its reply with) is missing from the history; say so.
+    const rendered = new Set(earlier.flatMap((e) => (e.timestamp ? [e.timestamp] : [])));
+    const unrenderable = turnIndex > 1 && !Number.isNaN(anchorMs) && stamps.some((st) => Date.parse(st) >= anchorMs && captured.has(st) && !rendered.has(st));
+    const anchorSeen = turnIndex <= 1 || (anchor !== undefined && (turn.exchangeTimestamp === anchor || stamps.includes(anchor)));
+    return {
+        messages,
+        omitted,
+        truncated: omitted > 0 || gap || unrenderable || !anchorSeen,
+        ...(totalTokens(usage) > 0 ? { usage } : {}),
+        ...(subagents.calls > 0 ? { subagents } : {}),
+    };
+}
+/**
+ * The blocks of this turn's reply: the transcript's own (thinking, then text) when it shows the final
+ * message, otherwise just the text the hook was given.
+ */
+function replyBlocks(turn) {
+    const blocks = (turn.finalReply ?? []).map(sanitizeBlock).filter((b) => b !== undefined);
+    return blocks.some((b) => b.type === 'text') ? blocks : [{ type: 'text', text: cleanText(turn.assistantText) }];
+}
+/**
+ * An Anthropic-shaped envelope for ONE turn captured by a hook, carrying the conversation so far.
+ *
+ * `request_body.messages` is the conversation since the skill was invoked, in order, ending on the last
+ * message before this turn's reply (`prepareTurnMessages`, passed in as `prepared`); `response_body` is this turn's
+ * reply. The server keeps one chat log per session and the newest turn replaces the stored one, so a
+ * late-arriving older turn (a replay) is ignored by it.
+ *
+ * The url is `coolhand-hook://<agent>/session/<id>/turn/<n>` — deliberately NOT the
+ * `claudecode://session/<id>` scheme `analyze-claude-sessions` uses. The server needs the session id
+ * and the turn number from it. `response_body.id` is `<session>:<turn>:<digest>`, and the digest ties
+ * it to the turn's content. It is no longer the server's dedup key, but stays unique per turn for
+ * debugging and correlation. What goes in is the conversation as structured blocks: prompts, thinking,
+ * tool calls, tool results and replies (subagent traffic and injected context excluded), all
+ * secret-scrubbed and capped (see blocks.ts).
+ */
+export function buildTurnEnvelope(agent, turn, turnIndex, digest, prepared, 
+/** The skill's text, sent as `request_body.system`. Redacted and capped here again, so state saved by an older version is scrubbed too. */
+system) {
+    return {
+        url: `coolhand-hook://${agent}/session/${encodeURIComponent(turn.sessionId)}/turn/${turnIndex}`,
+        method: 'POST',
+        status_code: 200,
+        request_body: {
+            model: turn.model,
+            ...(system ? { system: cleanText(system) } : {}),
+            messages: prepared.messages,
+        },
+        response_body: {
+            id: `${turn.sessionId}:${turnIndex}:${digest.slice(0, 8)}`,
+            type: 'message',
+            role: 'assistant',
+            model: turn.model,
+            content: replyBlocks(turn),
+            ...(prepared.usage ? { usage: prepared.usage } : {}),
+        },
+        turnCount: turnIndex,
+        projectPath: turn.cwd,
+    };
+}
+//# sourceMappingURL=turn-envelope.js.map

package/dist/sessions/turn-envelope.js.map

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

package/dist/sessions/usage.d.ts

@@ -0,0 +1,23 @@
+/** Token counts in the shape Claude Code writes on every assistant message (and the ingest API reads). */
+export interface Usage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_input_tokens: number;
+    cache_creation_input_tokens: number;
+}
+/** What subagents (Agent tool calls) spent, which a single log can't price: they run on other models. */
+export interface SubagentUsage {
+    calls: number;
+    total: Usage;
+    by_model: Record<string, Usage>;
+}
+export declare function emptyUsage(): Usage;
+export declare function emptySubagentUsage(): SubagentUsage;
+/** Add the four token fields of a raw `usage` object (anything else in it is ignored) into `into`. */
+export declare function addUsage(into: Usage, raw: unknown): void;
+export declare function totalTokens(u: Usage): number;
+/** Add one subagent run (an Agent tool result) under the model it ran on. */
+export declare function addSubagent(into: SubagentUsage, model: string, raw: unknown): void;
+/** Fold `from` into `into`. */
+export declare function mergeSubagents(into: SubagentUsage, from: SubagentUsage | undefined): void;
+//# sourceMappingURL=usage.d.ts.map

package/dist/sessions/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/sessions/usage.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,MAAM,WAAW,KAAK;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED,yGAAyG;AACzG,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CACjC;AAED,wBAAgB,UAAU,IAAI,KAAK,CAElC;AAED,wBAAgB,kBAAkB,IAAI,aAAa,CAElD;AAMD,sGAAsG;AACtG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CASxD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAE5C;AAiBD,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAMlF;AAED,+BAA+B;AAC/B,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,CASzF"}