coolhand-cli 0.12.0 → 0.13.1

package/dist/hooks/adapters/claude.js

@@ -0,0 +1,98 @@
+import { promises as fs } from 'fs';
+import { lastTurnFrom, parseExchanges } from '../../sessions/claude-scanner.js';
+import { earlierFrom, earlierStampsFrom, sameText, splitCurrent, str } from './shared.js';
+/**
+ * How much of the transcript's tail to read. A turn full of tool output can run to megabytes, and the
+ * earlier exchanges are rebuilt from the same window, so anything older than this is simply not seen
+ * (the turn's `history_truncated` flag says when that cost the conversation some of its history).
+ */
+const TRANSCRIPT_TAIL_BYTES = 8 * 1024 * 1024;
+async function readTail(filePath, maxBytes) {
+    const handle = await fs.open(filePath, 'r');
+    try {
+        const { size } = await handle.stat();
+        const length = Math.min(size, maxBytes);
+        const buffer = Buffer.alloc(length);
+        const { bytesRead } = await handle.read(buffer, 0, length, size - length);
+        return buffer.subarray(0, bytesRead).toString('utf8');
+    }
+    finally {
+        await handle.close();
+    }
+}
+/**
+ * Is the transcript's latest exchange this turn? Yes when its reply is the one the hook was given, or
+ * when it has a prompt but no reply yet (the transcript is written asynchronously and can lag the hook
+ * by exactly the reply). No when it shows some other reply: that is an earlier turn.
+ */
+function transcriptShowsThisTurn(tail, assistantText) {
+    if (tail.assistantText === undefined) {
+        return tail.userText !== undefined;
+    }
+    return sameText(tail.assistantText, assistantText);
+}
+/**
+ * Claude Code `Stop` hook → a turn. The assistant text comes from `last_assistant_message` (the
+ * transcript file is written asynchronously and can lag it). The user text, and the model, come
+ * from the tail of `transcript_path` — that is also what covers the turn that invoked the skill,
+ * whose prompt was submitted before the skill's hooks registered. If the transcript can't be read
+ * the turn is still captured, just without the user half.
+ *
+ * Returns `null` for any other event or when there is nothing to send.
+ */
+export async function claudeTurn(input) {
+    const event = str(input.hook_event_name);
+    if (event !== undefined && event !== 'Stop') {
+        return null;
+    }
+    const sessionId = str(input.session_id);
+    if (!sessionId) {
+        return null;
+    }
+    let tail = {};
+    let earlier = [];
+    let exchangeTimestamp;
+    let current;
+    let skillBodies;
+    let earlierStamps = [];
+    const transcriptPath = str(input.transcript_path);
+    if (transcriptPath) {
+        try {
+            const parsed = parseExchanges(await readTail(transcriptPath, TRANSCRIPT_TAIL_BYTES));
+            tail = lastTurnFrom(parsed);
+            // Everything before the latest exchange that has a prompt of its own, oldest first.
+            exchangeTimestamp = parsed.exchanges[parsed.exchanges.length - 1]?.timestamp;
+            earlierStamps = earlierStampsFrom(parsed.exchanges);
+            earlier = earlierFrom(parsed.exchanges);
+            current = parsed.exchanges[parsed.exchanges.length - 1];
+            skillBodies = parsed.exchanges.flatMap((e) => (e.skill ? [{ ...e.skill, timestamp: e.timestamp }] : []));
+        }
+        catch {
+            // Unreadable transcript: fall through with whatever the payload itself carries.
+        }
+    }
+    const assistantText = str(input.last_assistant_message) ?? tail.assistantText;
+    if (!assistantText) {
+        return null;
+    }
+    return {
+        sessionId,
+        userText: tail.userText,
+        assistantText,
+        model: tail.model,
+        // The transcript can lag the payload; only trust its request id if it is for the same reply.
+        turnKey: sameText(tail.assistantText, assistantText) ? tail.assistantKey : undefined,
+        cwd: str(input.cwd),
+        // Only trust the transcript's latest exchange as THIS turn (and so as the start of the skill's
+        // conversation, if this is turn 1) when it shows this turn's reply, or shows its prompt and no
+        // reply yet. A lagging transcript would otherwise make an earlier, pre-skill prompt the anchor.
+        exchangeTimestamp: transcriptShowsThisTurn(tail, assistantText) ? exchangeTimestamp : undefined,
+        earlier,
+        earlierStamps,
+        usage: current?.usage,
+        subagents: current?.subagents,
+        skillBodies,
+        ...splitCurrent(current?.messages, assistantText),
+    };
+}
+//# sourceMappingURL=claude.js.map

package/dist/hooks/adapters/claude.js.map

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

package/dist/hooks/adapters/copilot.d.ts

@@ -0,0 +1,16 @@
+import type { AdapterContext, HookInput, HookTurn } from '../types.js';
+/**
+ * VS Code Copilot `Stop` hook → a turn. The payload carries only the session id and `transcript_path`
+ * (`~/.copilot/session-state/<id>/events.jsonl`), so the prompt, the reply, the tool loop and the
+ * token usage all come from that file. Both the PascalCase (`session_id`, `transcript_path`) and the
+ * camelCase (`sessionId`, `transcriptPath`) spellings of the payload are understood.
+ *
+ * A Copilot hook runs for EVERY chat in the workspace, so a turn is sent only when the transcript shows
+ * the `--skill` skill was invoked in this session (a `skill.invoked` event), at or before this turn.
+ * `--skill` may be a pattern (`*`, `acme-*`): then any matching skill counts, and the first one invoked in
+ * the session is returned as `skill`. Without `--skill`, or for a chat that never invoked it, nothing is sent.
+ *
+ * Returns `null` for any other event, an unrelated chat, or when there is nothing to send.
+ */
+export declare function copilotTurn(input: HookInput, ctx?: AdapterContext): Promise<HookTurn | null>;
+//# sourceMappingURL=copilot.d.ts.map

package/dist/hooks/adapters/copilot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../../src/hooks/adapters/copilot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiDvE;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAwDtG"}

package/dist/hooks/adapters/copilot.js

@@ -0,0 +1,115 @@
+import { createReadStream } from 'fs';
+import { logHookEvent } from '../hook-log.js';
+import { createInterface } from 'readline';
+import { isWantedLine, parseCopilotExchanges } from '../../sessions/copilot-scanner.js';
+import { earlierFrom, earlierStampsFrom, isSkillPattern, skillMatchesPattern, splitCurrent, str } from './shared.js';
+/**
+ * The transcript is written asynchronously and Claude's can lag its `Stop` by the reply. Copilot's was in the file
+ * 15 to 20 ms BEFORE `Stop` in the three recorded turns, so this is a precaution: wait this long, this many times, for it.
+ */
+const LAG_WAIT_MS = 250;
+const LAG_RETRIES = 4;
+/**
+ * The lines of the transcript that matter. Copilot snapshots the whole conversation into the file on
+ * every model call, so it is streamed and filtered rather than read whole.
+ */
+async function readEvents(filePath) {
+    // `parseCopilotExchanges` applies the same filter, so it stays safe when called on a whole file; this pass only keeps memory small.
+    const kept = [];
+    const lines = createInterface({ input: createReadStream(filePath, { encoding: 'utf8' }), crlfDelay: Infinity });
+    for await (const line of lines) {
+        if (isWantedLine(line)) {
+            kept.push(line);
+        }
+    }
+    return kept.join('\n');
+}
+function wait(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Does this exchange's skill invocation name `skill`: by its declared name or by its directory's name, or a `--skill` pattern. */
+function invokes(e, skill) {
+    return (e.skills ?? []).some((s) => skillMatchesPattern(skill, s));
+}
+/** The skill a `--skill` value matched in this session: for a pattern the first one invoked (never the pattern itself), for a plain name that name. */
+function resolveSkill(exchanges, skill) {
+    if (!isSkillPattern(skill)) {
+        return skill;
+    }
+    for (const e of exchanges) {
+        const hit = (e.skills ?? []).find((s) => skillMatchesPattern(skill, s));
+        if (hit) {
+            return hit.name;
+        }
+    }
+    return undefined;
+}
+/**
+ * VS Code Copilot `Stop` hook → a turn. The payload carries only the session id and `transcript_path`
+ * (`~/.copilot/session-state/<id>/events.jsonl`), so the prompt, the reply, the tool loop and the
+ * token usage all come from that file. Both the PascalCase (`session_id`, `transcript_path`) and the
+ * camelCase (`sessionId`, `transcriptPath`) spellings of the payload are understood.
+ *
+ * A Copilot hook runs for EVERY chat in the workspace, so a turn is sent only when the transcript shows
+ * the `--skill` skill was invoked in this session (a `skill.invoked` event), at or before this turn.
+ * `--skill` may be a pattern (`*`, `acme-*`): then any matching skill counts, and the first one invoked in
+ * the session is returned as `skill`. Without `--skill`, or for a chat that never invoked it, nothing is sent.
+ *
+ * Returns `null` for any other event, an unrelated chat, or when there is nothing to send.
+ */
+export async function copilotTurn(input, ctx = {}) {
+    const event = str(input.hook_event_name);
+    if (event !== undefined && event !== 'Stop' && event !== 'agentStop') {
+        return null;
+    }
+    const sessionId = str(input.session_id) ?? str(input.sessionId);
+    const transcriptPath = str(input.transcript_path) ?? str(input.transcriptPath);
+    if (!sessionId || !transcriptPath || !ctx.skill) {
+        return null;
+    }
+    const skill = ctx.skill;
+    let parsed;
+    try {
+        for (let attempt = 0;; attempt++) {
+            parsed = parseCopilotExchanges(await readEvents(transcriptPath));
+            if (parsed.exchanges[parsed.exchanges.length - 1]?.assistantText || attempt >= LAG_RETRIES) {
+                break;
+            }
+            // A chat that never used the skill has nothing to wait for.
+            if (!parsed.exchanges.some((e) => invokes(e, skill))) {
+                return null;
+            }
+            await wait(LAG_WAIT_MS);
+        }
+    }
+    catch (err) {
+        // Not the normal "unrelated chat" path: say why nothing was captured, so a broken hook can be told from a quiet one.
+        await logHookEvent(`capture-turn (copilot): could not read the transcript: ${err.code ?? err.message}`);
+        return null;
+    }
+    const { exchanges } = parsed;
+    const current = exchanges[exchanges.length - 1];
+    if (!current?.assistantText || !exchanges.some((e) => invokes(e, skill))) {
+        return null;
+    }
+    const resolved = resolveSkill(exchanges, skill);
+    if (!resolved) {
+        return null;
+    }
+    return {
+        sessionId,
+        skill: resolved,
+        userText: current.userText,
+        assistantText: current.assistantText,
+        model: parsed.model,
+        turnKey: current.assistantKey,
+        cwd: str(input.cwd),
+        exchangeTimestamp: current.timestamp,
+        earlier: earlierFrom(exchanges),
+        earlierStamps: earlierStampsFrom(exchanges),
+        usage: current.usage,
+        skillBodies: exchanges.flatMap((e) => (e.skills ?? []).map((s) => ({ dir: s.dir, text: s.text, name: s.name, timestamp: e.timestamp }))),
+        ...splitCurrent(current.messages, current.assistantText),
+    };
+}
+//# sourceMappingURL=copilot.js.map

package/dist/hooks/adapters/copilot.js.map

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

package/dist/hooks/adapters/index.d.ts

@@ -0,0 +1,5 @@
+import type { AdapterContext, HookAgent, HookInput, HookTurn } from '../types.js';
+export type HookAdapter = (input: HookInput, ctx?: AdapterContext) => Promise<HookTurn | null>;
+/** One adapter per agent: turns that agent's hook payload (and transcript) into a `HookTurn`. */
+export declare const ADAPTERS: Record<HookAgent, HookAdapter>;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIlF,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;AAE/F,iGAAiG;AACjG,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAGnD,CAAC"}

package/dist/hooks/adapters/index.js

@@ -0,0 +1,8 @@
+import { claudeTurn } from './claude.js';
+import { copilotTurn } from './copilot.js';
+/** One adapter per agent: turns that agent's hook payload (and transcript) into a `HookTurn`. */
+export const ADAPTERS = {
+    claude: (input) => claudeTurn(input),
+    copilot: copilotTurn,
+};
+//# sourceMappingURL=index.js.map

package/dist/hooks/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/adapters/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAI3C,iGAAiG;AACjG,MAAM,CAAC,MAAM,QAAQ,GAAmC;IACtD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;IACpC,OAAO,EAAE,WAAW;CACrB,CAAC"}

package/dist/hooks/adapters/shared.d.ts

@@ -0,0 +1,32 @@
+import { type RawMessage } from '../../sessions/blocks.js';
+import type { Exchange } from '../../sessions/claude-scanner.js';
+import type { EarlierExchange } from '../types.js';
+/** Equal once whitespace is collapsed: the payload and the transcript may join a reply's text blocks differently. */
+export declare function sameText(a: string | undefined, b: string): boolean;
+/**
+ * Split this turn's messages into its tool loop and its final reply. The final reply is the last
+ * assistant message, and only when its text is the reply the hook was given (otherwise the transcript
+ * hasn't caught up, and the reply is sent as the text the hook has, with the loop as far as it shows).
+ */
+export declare function splitCurrent(messages: RawMessage[] | undefined, reply: string): {
+    currentMessages: RawMessage[];
+    finalReply?: unknown[];
+};
+export declare function str(value: unknown): string | undefined;
+/** The exchanges before the latest one that have a prompt of their own, as `earlier` history (oldest first). */
+export declare function earlierFrom(exchanges: Exchange[]): EarlierExchange[];
+/** Timestamps of EVERY exchange before the latest, including ones with no prompt text of their own. */
+export declare function earlierStampsFrom(exchanges: Exchange[]): string[];
+/** Does a skill (its declared `name` and the directory it was loaded from) answer to `--skill`: by name or by its directory's name. */
+export declare function skillMatches(skill: string, candidate: {
+    name?: string;
+    dir: string;
+}): boolean;
+/** A `--skill` value that ends in `*` is a pattern: `*` is any skill, `acme-*` any skill whose declared name starts with `acme-`. */
+export declare function isSkillPattern(skill: string): boolean;
+/** Does a skill answer to a `--skill` value: by name or directory, or, for a pattern, by the prefix of its declared name. */
+export declare function skillMatchesPattern(skill: string, candidate: {
+    name?: string;
+    dir: string;
+}): boolean;
+//# sourceMappingURL=shared.d.ts.map

package/dist/hooks/adapters/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/hooks/adapters/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,qHAAqH;AACrH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,eAAe,EAAE,UAAU,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,CAOzI;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEtD;AAED,gHAAgH;AAChH,wBAAgB,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,eAAe,EAAE,CAKpE;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAEjE;AAED,uIAAuI;AACvI,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAE9F;AAED,qIAAqI;AACrI,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,6HAA6H;AAC7H,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAErG"}

package/dist/hooks/adapters/shared.js

@@ -0,0 +1,45 @@
+import { rawMessageText } from '../../sessions/blocks.js';
+/** Equal once whitespace is collapsed: the payload and the transcript may join a reply's text blocks differently. */
+export function sameText(a, b) {
+    return a !== undefined && a.replace(/\s+/g, ' ').trim() === b.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Split this turn's messages into its tool loop and its final reply. The final reply is the last
+ * assistant message, and only when its text is the reply the hook was given (otherwise the transcript
+ * hasn't caught up, and the reply is sent as the text the hook has, with the loop as far as it shows).
+ */
+export function splitCurrent(messages, reply) {
+    const all = messages ?? [];
+    const last = all[all.length - 1];
+    if (last && last.role === 'assistant' && sameText(rawMessageText(last), reply)) {
+        return { currentMessages: all.slice(0, -1), finalReply: last.blocks };
+    }
+    return { currentMessages: all };
+}
+export function str(value) {
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+/** The exchanges before the latest one that have a prompt of their own, as `earlier` history (oldest first). */
+export function earlierFrom(exchanges) {
+    return exchanges
+        .slice(0, -1)
+        .filter((e) => typeof e.userText === 'string')
+        .map((e) => ({ timestamp: e.timestamp, userText: e.userText, assistantText: e.assistantText, usage: e.usage, subagents: e.subagents, messages: e.messages }));
+}
+/** Timestamps of EVERY exchange before the latest, including ones with no prompt text of their own. */
+export function earlierStampsFrom(exchanges) {
+    return exchanges.slice(0, -1).flatMap((e) => (e.timestamp ? [e.timestamp] : []));
+}
+/** Does a skill (its declared `name` and the directory it was loaded from) answer to `--skill`: by name or by its directory's name. */
+export function skillMatches(skill, candidate) {
+    return candidate.name === skill || candidate.dir.split(/[\\/]/).filter(Boolean).pop() === skill;
+}
+/** A `--skill` value that ends in `*` is a pattern: `*` is any skill, `acme-*` any skill whose declared name starts with `acme-`. */
+export function isSkillPattern(skill) {
+    return skill.endsWith('*');
+}
+/** Does a skill answer to a `--skill` value: by name or directory, or, for a pattern, by the prefix of its declared name. */
+export function skillMatchesPattern(skill, candidate) {
+    return isSkillPattern(skill) ? (candidate.name ?? '').startsWith(skill.slice(0, -1)) : skillMatches(skill, candidate);
+}
+//# sourceMappingURL=shared.js.map

package/dist/hooks/adapters/shared.js.map

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

package/dist/hooks/disabled.d.ts

@@ -0,0 +1,3 @@
+/** `COOLHAND_CAPTURE_DISABLED=1|true|yes`: the kill switch for people who didn't choose to run a skill's hook. */
+export declare function isCaptureDisabled(): boolean;
+//# sourceMappingURL=disabled.d.ts.map

package/dist/hooks/disabled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disabled.d.ts","sourceRoot":"","sources":["../../src/hooks/disabled.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/hooks/disabled.js

@@ -0,0 +1,5 @@
+/** `COOLHAND_CAPTURE_DISABLED=1|true|yes`: the kill switch for people who didn't choose to run a skill's hook. */
+export function isCaptureDisabled() {
+    return /^(1|true|yes)$/i.test(process.env.COOLHAND_CAPTURE_DISABLED ?? '');
+}
+//# sourceMappingURL=disabled.js.map

package/dist/hooks/disabled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disabled.js","sourceRoot":"","sources":["../../src/hooks/disabled.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/dist/hooks/hook-log.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Append one line to `~/.coolhand/capture-turns/hook.log`. A hook has to stay silent — anything it
+ * prints reaches the agent — so this file is the only place its failures can be found. Best-effort
+ * and bounded (once it passes 256 KB it is cut back to its last 64 KB); never throws.
+ */
+export declare function logHookEvent(message: string): Promise<void>;
+//# sourceMappingURL=hook-log.d.ts.map

package/dist/hooks/hook-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-log.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-log.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjE"}

package/dist/hooks/hook-log.js

@@ -0,0 +1,34 @@
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { atomicWriteFile } from '../config.js';
+import { redact } from '../logger.js';
+import { turnsDir } from './turn-state.js';
+const MAX_LOG_BYTES = 256 * 1024;
+/** What survives a trim: the most recent failures are the ones worth reading. */
+const KEEP_LOG_BYTES = 64 * 1024;
+/**
+ * Append one line to `~/.coolhand/capture-turns/hook.log`. A hook has to stay silent — anything it
+ * prints reaches the agent — so this file is the only place its failures can be found. Best-effort
+ * and bounded (once it passes 256 KB it is cut back to its last 64 KB); never throws.
+ */
+export async function logHookEvent(message) {
+    try {
+        const file = path.join(turnsDir(), 'hook.log');
+        await fs.mkdir(turnsDir(), { recursive: true, mode: 0o700 });
+        try {
+            if ((await fs.stat(file)).size > MAX_LOG_BYTES) {
+                const tail = (await fs.readFile(file, 'utf8')).slice(-KEEP_LOG_BYTES);
+                // Drop the partial first line, then replace the file atomically.
+                await atomicWriteFile(file, tail.slice(tail.indexOf('\n') + 1), 0o600);
+            }
+        }
+        catch {
+            // No log yet.
+        }
+        await fs.appendFile(file, `${new Date().toISOString()} ${redact(message).replace(/[\r\n]+/g, ' ')}\n`, { mode: 0o600 });
+    }
+    catch {
+        // Nowhere left to report to.
+    }
+}
+//# sourceMappingURL=hook-log.js.map

package/dist/hooks/hook-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-log.js","sourceRoot":"","sources":["../../src/hooks/hook-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;AACjC,iFAAiF;AACjF,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC;AAEjC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;QAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;gBAC/C,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC;gBACtE,iEAAiE;gBACjE,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QACD,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1H,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;AACH,CAAC"}

package/dist/hooks/identity.d.ts

@@ -0,0 +1,21 @@
+export interface TesterIdentity {
+    id: string;
+    /** Where `id` came from: an explicit override, the git email, or the anonymous machine id. */
+    source: 'env' | 'git' | 'machine';
+}
+/** A random UUID minted on first use and kept in `~/.coolhand/machine-id`. Identifies a machine, not a person. */
+export declare function machineId(): Promise<string>;
+/**
+ * Who ran this session, for attributing turns captured with one shared public key.
+ *
+ * `anonymous` wins over everything: it returns the machine id without consulting the environment or
+ * git, so nothing identifying can leave the machine. Otherwise: `COOLHAND_CAPTURE_USER`, then the git
+ * email (read from the session's own working directory, so a repo-local `user.email` is honoured),
+ * then the machine id. `capture-turn` calls this once per session and keeps the answer in the
+ * session's state file.
+ */
+export declare function resolveTesterIdentity(opts?: {
+    anonymous?: boolean;
+    cwd?: string;
+}): Promise<TesterIdentity>;
+//# sourceMappingURL=identity.d.ts.map

package/dist/hooks/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/hooks/identity.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,8FAA8F;IAC9F,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;CACnC;AAMD,kHAAkH;AAClH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CA+BjD;AA0DD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/C,OAAO,CAAC,cAAc,CAAC,CAazB"}

package/dist/hooks/identity.js

@@ -0,0 +1,121 @@
+import { execFile } from 'child_process';
+import { promises as fs, constants as fsConstants } from 'fs';
+import * as path from 'path';
+import { randomUUID } from 'crypto';
+import { configDir, atomicWriteFile } from '../config.js';
+const DIR_MODE = 0o700;
+const FILE_MODE = 0o600;
+const GIT_TIMEOUT_MS = 2000;
+function machineIdPath() {
+    return path.join(configDir(), 'machine-id');
+}
+/** A random UUID minted on first use and kept in `~/.coolhand/machine-id`. Identifies a machine, not a person. */
+export async function machineId() {
+    try {
+        const existing = (await fs.readFile(machineIdPath(), 'utf8')).trim();
+        if (existing) {
+            return existing;
+        }
+    }
+    catch {
+        // Not minted yet.
+    }
+    const id = randomUUID();
+    await fs.mkdir(configDir(), { recursive: true, mode: DIR_MODE });
+    try {
+        // 'wx': when two first-ever runs race, exactly one creates the file and the other adopts its id.
+        await fs.writeFile(machineIdPath(), `${id}\n`, { flag: 'wx', mode: FILE_MODE });
+        return id;
+    }
+    catch (err) {
+        if (err.code !== 'EEXIST') {
+            throw err;
+        }
+        // The winner creates the file and then writes it; a reader can catch it between the two.
+        for (let attempt = 0; attempt < 5; attempt++) {
+            const winner = (await fs.readFile(machineIdPath(), 'utf8')).trim();
+            if (winner) {
+                return winner;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+        // Still empty: a crash left a half-made file. Repair it so the id stops changing on every run.
+        await atomicWriteFile(machineIdPath(), `${id}\n`, FILE_MODE);
+        return id;
+    }
+}
+/** The machine id, or a throwaway one when the config dir can't be written: attribution is not worth a lost turn. */
+async function machineIdentity() {
+    try {
+        return { id: await machineId(), source: 'machine' };
+    }
+    catch {
+        return { id: randomUUID(), source: 'machine' };
+    }
+}
+/**
+ * Find an executable on PATH, ignoring empty and relative entries. The session's cwd is an arbitrary,
+ * possibly untrusted repository, and Windows searches the working directory (and a `.` PATH entry)
+ * when launching a bare command name, so a repo could plant its own `git.exe`. An absolute path
+ * resolved here avoids that on every platform.
+ */
+async function findOnPath(name) {
+    const suffixes = process.platform === 'win32' ? ['.exe'] : [''];
+    for (const dir of (process.env.PATH ?? '').split(path.delimiter)) {
+        if (!dir || !path.isAbsolute(dir)) {
+            continue;
+        }
+        for (const suffix of suffixes) {
+            const candidate = path.join(dir, `${name}${suffix}`);
+            try {
+                await fs.access(candidate, fsConstants.X_OK);
+                return candidate;
+            }
+            catch {
+                // Not here.
+            }
+        }
+    }
+    return undefined;
+}
+async function gitEmail(cwd) {
+    const git = await findOnPath('git');
+    if (!git) {
+        return undefined;
+    }
+    return new Promise((resolve) => {
+        try {
+            execFile(git, ['config', 'user.email'], { cwd, timeout: GIT_TIMEOUT_MS, windowsHide: true }, (err, stdout) => {
+                const email = err ? '' : String(stdout).trim();
+                resolve(email || undefined);
+            });
+        }
+        catch {
+            resolve(undefined);
+        }
+    });
+}
+/**
+ * Who ran this session, for attributing turns captured with one shared public key.
+ *
+ * `anonymous` wins over everything: it returns the machine id without consulting the environment or
+ * git, so nothing identifying can leave the machine. Otherwise: `COOLHAND_CAPTURE_USER`, then the git
+ * email (read from the session's own working directory, so a repo-local `user.email` is honoured),
+ * then the machine id. `capture-turn` calls this once per session and keeps the answer in the
+ * session's state file.
+ */
+export async function resolveTesterIdentity(opts = {}) {
+    if (opts.anonymous) {
+        return machineIdentity();
+    }
+    const override = process.env.COOLHAND_CAPTURE_USER?.trim();
+    if (override) {
+        return { id: override, source: 'env' };
+    }
+    const email = await gitEmail(opts.cwd);
+    if (email) {
+        return { id: email, source: 'git' };
+    }
+    return machineIdentity();
+}
+//# sourceMappingURL=identity.js.map

package/dist/hooks/identity.js.map

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

package/dist/hooks/log-turn.d.ts

@@ -0,0 +1,23 @@
+import { type Coolhand, type CoolhandLogResponse, type DeclaredContext } from 'coolhand-node';
+export interface LogTurnOptions {
+    collector?: string;
+    metadata: Record<string, unknown>;
+    /**
+     * The workload this log belongs to, sent as `llm_request_log.declared`. The server find-or-creates
+     * the workload by key and attaches the log directly, skipping its own matching. Only a workload is
+     * declared: no template (the server derives the skill's single default template from the workload).
+     */
+    declared?: DeclaredContext;
+}
+/**
+ * Send one turn through the SDK, declared as `opts.declared` when given. Both the live send and the
+ * replay of a spooled turn go through here, so a replay is declared exactly like the original.
+ *
+ * - `withContext` throws synchronously for a malformed declaration (a blank, over-long or control-
+ *   character key, say). That must not cost the turn: it is written to hook.log and the turn is sent
+ *   undeclared, so it still lands, just unmatched.
+ * - The server answers `warnings` when it ignores a declaration (for example the public-key cap on
+ *   declared workloads): the turn still landed, but not as declared. They go to hook.log.
+ */
+export declare function logTurn(coolhand: Coolhand, envelope: unknown, opts: LogTurnOptions): Promise<CoolhandLogResponse | null>;
+//# sourceMappingURL=log-turn.d.ts.map

package/dist/hooks/log-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-turn.d.ts","sourceRoot":"","sources":["../../src/hooks/log-turn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAyB,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAGlI,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAWD;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA2B9H"}