@lannguyensi/harness 0.6.0 → 0.8.0

package/dist/cli/pack/remove.js

@@ -0,0 +1,153 @@
+// `harness pack remove <name>` — managed remove from policy_packs[].
+//
+// Reference-checked: refuses (without --force) when `.last-apply` records
+// files under `policy-packs/<name>/`, on the theory that `harness apply`
+// has run with this pack present and removing it without telling apply
+// would leave orphan files in `harness.generated/`. With --force, the
+// manifest entry is removed AND the orphan files are deleted AND the
+// `.last-apply` file entries are pruned, so the next `harness apply` is
+// a clean no-op.
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { atomicWriteFile } from "../../io/atomic-write.js";
+import { writeLastApply } from "../../io/last-apply.js";
+import { LAST_APPLY_BASENAME, readLastApply, } from "../../io/last-apply.js";
+import { withFileLock } from "../../io/lock.js";
+import { unifiedDiff } from "../../io/patch.js";
+import { formatValidationErrors, validateBeforeWrite, } from "../../io/validate-before-write.js";
+import { EX_FAIL, EX_NOINPUT, HarnessExitError } from "../exit-codes.js";
+import { applyPackRemove, planPackRemove } from "./mutate.js";
+const DEFAULT_BASENAME = "harness.yaml";
+const LOCK_BASENAME = ".harness.lock";
+const GENERATED_DIRNAME = "harness.generated";
+function resolveTargetPath(opts) {
+    if (opts.configPath)
+        return path.resolve(opts.configPath);
+    return path.join(opts.homeDir ?? path.join(os.homedir(), ".claude"), DEFAULT_BASENAME);
+}
+function resolveGeneratedDir(opts, manifestPath) {
+    if (opts.homeDir !== undefined)
+        return path.join(opts.homeDir, GENERATED_DIRNAME);
+    return path.join(path.dirname(manifestPath), GENERATED_DIRNAME);
+}
+function packFileKeys(record, packName) {
+    if (!record)
+        return [];
+    const prefix = `policy-packs/${packName}/`;
+    return Object.keys(record.files)
+        .filter((k) => k.startsWith(prefix))
+        .sort();
+}
+function pruneRecord(record, packName) {
+    const out = {
+        files: {},
+        ...(record.manifest !== undefined ? { manifest: record.manifest } : {}),
+        ...(record.memoryDirs !== undefined ? { memoryDirs: record.memoryDirs } : {}),
+    };
+    const prefix = `policy-packs/${packName}/`;
+    for (const [key, entry] of Object.entries(record.files)) {
+        if (!key.startsWith(prefix))
+            out.files[key] = entry;
+    }
+    return out;
+}
+function formatNameList(names) {
+    if (names.length === 0)
+        return "(none declared)";
+    return names.map((n) => `  - ${n}`).join("\n");
+}
+// Belt-and-braces defense against a path-traversal `name` reaching the
+// filesystem cleanup. The schema regex on PolicyPackSchema.name catches
+// this at parseManifest time, but planPackRemove reads the YAML
+// directly (not via the schema), so a malformed manifest could still
+// surface a bad name here. Refuse rather than rmSync into the void.
+const SAFE_PACK_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+export async function packRemove(name, opts = {}) {
+    const target = resolveTargetPath(opts);
+    if (!fs.existsSync(target)) {
+        throw new HarnessExitError(`harness manifest not found at ${target}; run \`harness init\` first`, EX_NOINPUT);
+    }
+    if (!SAFE_PACK_NAME_RE.test(name)) {
+        throw new HarnessExitError(`policy_pack name ${JSON.stringify(name)} contains path separators or other unsafe characters; refusing to operate on it. Allowed: [A-Za-z0-9._-], leading char alphanumeric.`, EX_FAIL);
+    }
+    const original = fs.readFileSync(target, "utf8");
+    const plan = planPackRemove(original, name);
+    if (!plan.found) {
+        throw new HarnessExitError(`policy_packs entry "${name}" not found. Available entries:\n${formatNameList(plan.availableNames)}`, EX_FAIL);
+    }
+    const generatedDir = resolveGeneratedDir(opts, target);
+    const lastApply = readLastApply(generatedDir);
+    const trackedFiles = packFileKeys(lastApply, name);
+    if (trackedFiles.length > 0 && !opts.force) {
+        const list = trackedFiles.map((f) => `  - ${f}`).join("\n");
+        throw new HarnessExitError(`pack "${name}" has applied state present in ${LAST_APPLY_BASENAME}:\n${list}\n` +
+            `Pass --force to remove the manifest entry and clean up these generated files. ` +
+            `(Without cleanup, a subsequent \`harness apply\` would not delete them.)`, EX_FAIL);
+    }
+    const proposed = applyPackRemove(original, name);
+    const diff = unifiedDiff({
+        fileName: path.basename(target),
+        oldText: original,
+        newText: proposed,
+        oldHeader: "current",
+        newHeader: "proposed",
+    });
+    const schemaResult = validateBeforeWrite(parseYaml(proposed));
+    if (!schemaResult.ok) {
+        throw new HarnessExitError(`proposed manifest fails schema validation:\n${formatValidationErrors(schemaResult.errors)}`, EX_FAIL);
+    }
+    if (opts.dryRun) {
+        // On dry-run, surface what --force WOULD clean up so the user can
+        // sanity-check the blast radius before committing.
+        return {
+            path: target,
+            name,
+            diff,
+            applied: false,
+            cleanedFiles: opts.force ? trackedFiles : [],
+        };
+    }
+    const lockPath = path.join(path.dirname(target), LOCK_BASENAME);
+    const cleanedFiles = [];
+    await withFileLock(lockPath, () => {
+        const current = fs.readFileSync(target, "utf8");
+        const next = applyPackRemove(current, name);
+        const recheck = validateBeforeWrite(parseYaml(next));
+        if (!recheck.ok) {
+            throw new HarnessExitError(`proposed manifest fails schema validation after lock acquisition:\n${formatValidationErrors(recheck.errors)}`, EX_FAIL);
+        }
+        atomicWriteFile(target, next);
+        // Best-effort cleanup under --force. We do this AFTER the manifest
+        // write has succeeded so a partial cleanup never leaves the manifest
+        // in a confusing half-state. Each fs operation is wrapped: a missing
+        // file is a no-op, not a failure (the user may have deleted it
+        // manually since the last apply).
+        if (opts.force && trackedFiles.length > 0) {
+            const packDir = path.join(generatedDir, "policy-packs", name);
+            try {
+                fs.rmSync(packDir, { recursive: true, force: true });
+            }
+            catch {
+                // ignore — best-effort
+            }
+            // Update .last-apply so the next `harness apply` no-ops cleanly
+            // instead of detecting the now-missing files as drift.
+            const fresh = readLastApply(generatedDir);
+            if (fresh) {
+                const pruned = pruneRecord(fresh, name);
+                writeLastApply(generatedDir, pruned);
+            }
+            cleanedFiles.push(...trackedFiles);
+        }
+    });
+    return {
+        path: target,
+        name,
+        diff,
+        applied: true,
+        cleanedFiles,
+    };
+}
+//# sourceMappingURL=remove.js.map

package/dist/cli/pack/remove.js.map

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

package/dist/cli/session-export/index.d.ts

@@ -0,0 +1,46 @@
+import { type LedgerEntry, type LedgerQueryResult } from "../../policies/index.js";
+import { type LoaderOptions } from "../loader.js";
+import { type TranscriptEvent, type TranscriptParseResult } from "./transcript.js";
+export type ExportFormat = "json" | "jsonl";
+export interface SessionExportOptions extends LoaderOptions {
+    sessionId?: string;
+    format?: ExportFormat;
+    outFile?: string;
+    homeDir?: string;
+    projectsRoot?: string;
+    fetchLedger?: (sessionId: string) => Promise<LedgerQueryResult>;
+    /** Override transcript locator (tests). */
+    locateTranscript?: (sessionId: string) => string | null;
+    /** Read a transcript file (tests). */
+    readTranscript?: (file: string) => TranscriptParseResult;
+    /** Override env for env_var redaction (tests). */
+    env?: NodeJS.ProcessEnv;
+}
+export interface SessionExportEvent {
+    source: "transcript" | "ledger";
+    kind: string;
+    timestamp: string | null;
+    /** Stable per-source ordering tiebreaker. */
+    seq: number;
+    data: Record<string, unknown>;
+}
+export interface SessionExportHeader {
+    id: string;
+    cwd: string | null;
+    startedAt: string | null;
+    endedAt: string | null;
+    transcriptPath: string | null;
+    transcriptEvents: number;
+    ledgerEntries: number;
+    ledgerStatus: "ok" | "degraded" | "missing";
+    ledgerNote: string | null;
+    redactionRules: number;
+}
+export interface SessionExportResult {
+    output: string;
+    header: SessionExportHeader;
+    events: SessionExportEvent[];
+}
+export declare function sessionExport(opts: SessionExportOptions): Promise<SessionExportResult>;
+declare function mergeEvents(transcript: TranscriptEvent[], ledger: LedgerEntry[]): SessionExportEvent[];
+export { mergeEvents as mergeEventsForTesting };

package/dist/cli/session-export/index.js

@@ -0,0 +1,169 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { parseLedgerTimestamp, queryLedgerByTag, } from "../../policies/index.js";
+import { resolveSessionId } from "../../runtime/session-id.js";
+import { EX_FAIL, EX_USAGE, HarnessExitError } from "../exit-codes.js";
+import { loadManifest } from "../loader.js";
+import { redactString, resolveRedactionRules } from "./redact.js";
+import { locateTranscript, readTranscript, } from "./transcript.js";
+export async function sessionExport(opts) {
+    const format = opts.format ?? "json";
+    if (format !== "json" && format !== "jsonl") {
+        throw new HarnessExitError(`unknown --format "${format}"; expected json or jsonl`, EX_USAGE);
+    }
+    const sessionId = resolveSessionId(opts.sessionId);
+    const { manifest } = loadManifest(opts);
+    const rules = resolveRedactionRules(manifest.audit.redact, {
+        ...(opts.env !== undefined ? { env: opts.env } : {}),
+    });
+    const transcriptResult = await loadTranscript(sessionId, opts);
+    const ledgerOutcome = await loadLedger(sessionId, manifest, opts);
+    if (!transcriptResult.path &&
+        transcriptResult.events.length === 0 &&
+        ledgerOutcome.entries.length === 0 &&
+        ledgerOutcome.status === "ok") {
+        throw new HarnessExitError(`no transcript or ledger entries for session "${sessionId}"`, EX_FAIL);
+    }
+    const events = mergeEvents(transcriptResult.events, ledgerOutcome.entries);
+    const header = {
+        id: sessionId,
+        cwd: transcriptResult.cwd,
+        startedAt: transcriptResult.startedAt,
+        endedAt: transcriptResult.endedAt,
+        transcriptPath: transcriptResult.path,
+        transcriptEvents: transcriptResult.events.length,
+        ledgerEntries: ledgerOutcome.entries.length,
+        ledgerStatus: ledgerOutcome.status,
+        ledgerNote: ledgerOutcome.note,
+        redactionRules: rules.length,
+    };
+    const rawOutput = format === "json"
+        ? `${JSON.stringify({ session: header, events }, null, 2)}\n`
+        : `${[
+            JSON.stringify({ kind: "session", ...header }),
+            ...events.map((e) => JSON.stringify(e)),
+        ].join("\n")}\n`;
+    const output = redactString(rawOutput, rules);
+    if (opts.outFile) {
+        fs.mkdirSync(path.dirname(path.resolve(opts.outFile)), { recursive: true });
+        fs.writeFileSync(opts.outFile, output, "utf8");
+    }
+    return { output, header, events };
+}
+async function loadTranscript(sessionId, opts) {
+    const locator = opts.locateTranscript ?? ((id) => {
+        const args = {};
+        if (opts.homeDir !== undefined)
+            args.homeDir = opts.homeDir;
+        if (opts.projectsRoot !== undefined)
+            args.projectsRoot = opts.projectsRoot;
+        return locateTranscript(id, args);
+    });
+    const reader = opts.readTranscript ?? readTranscript;
+    const file = locator(sessionId);
+    if (file === null) {
+        return { events: [], startedAt: null, endedAt: null, cwd: null, path: null };
+    }
+    const r = reader(file);
+    return {
+        events: r.events,
+        startedAt: r.startedAt,
+        endedAt: r.endedAt,
+        cwd: r.cwd,
+        path: file,
+    };
+}
+async function loadLedger(sessionId, manifest, opts) {
+    const fetcher = opts.fetchLedger ?? defaultLedgerFetcher(manifest);
+    if (fetcher === null) {
+        return {
+            entries: [],
+            status: "missing",
+            note: "grounding-mcp not declared in manifest; ledger join skipped",
+        };
+    }
+    const result = await fetcher(sessionId);
+    if (result.kind === "ok") {
+        return { entries: result.entries, status: "ok", note: null };
+    }
+    return { entries: [], status: "degraded", note: result.reason };
+}
+function defaultLedgerFetcher(manifest) {
+    const server = manifest.tools.mcp.find((m) => m.name === "grounding-mcp");
+    if (!server)
+        return null;
+    const command = Array.isArray(server.command)
+        ? server.command
+        : server.command.trim().split(/\s+/);
+    return async (sid) => queryLedgerByTag({
+        mcpCommand: command,
+        ...(server.env && { mcpEnv: server.env }),
+        sessionId: sid,
+        timeoutMs: server.health?.timeout_ms ?? 5_000,
+    });
+}
+function mergeEvents(transcript, ledger) {
+    const out = [];
+    transcript.forEach((e, i) => {
+        const data = { ...e.data };
+        if (e.uuid !== undefined)
+            data.uuid = e.uuid;
+        if (e.parentUuid !== undefined)
+            data.parentUuid = e.parentUuid;
+        if (e.cwd !== undefined)
+            data.cwd = e.cwd;
+        out.push({
+            source: "transcript",
+            kind: e.kind,
+            timestamp: e.timestamp,
+            seq: i,
+            data,
+        });
+    });
+    ledger.forEach((entry, i) => {
+        const ts = ledgerEntryIso(entry);
+        const data = {
+            id: entry.id,
+            content: entry.content,
+        };
+        if (entry.type !== undefined)
+            data.type = entry.type;
+        if (entry.source !== undefined)
+            data.tagSource = entry.source;
+        out.push({
+            source: "ledger",
+            kind: entry.type ?? "ledger_entry",
+            timestamp: ts,
+            seq: i,
+            data,
+        });
+    });
+    out.sort((a, b) => {
+        const at = a.timestamp ?? "";
+        const bt = b.timestamp ?? "";
+        if (at === bt) {
+            if (a.source !== b.source)
+                return a.source === "transcript" ? -1 : 1;
+            return a.seq - b.seq;
+        }
+        if (at === "")
+            return 1;
+        if (bt === "")
+            return -1;
+        return at < bt ? -1 : 1;
+    });
+    return out;
+}
+function ledgerEntryIso(entry) {
+    if (entry.createdAt instanceof Date)
+        return entry.createdAt.toISOString();
+    if (typeof entry.createdAt === "string") {
+        const parsed = parseLedgerTimestamp(entry.createdAt);
+        if (parsed === null)
+            return null;
+        return new Date(parsed * 1000).toISOString();
+    }
+    return null;
+}
+export { mergeEvents as mergeEventsForTesting };
+//# sourceMappingURL=index.js.map

package/dist/cli/session-export/index.js.map

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

package/dist/cli/session-export/redact.d.ts

@@ -0,0 +1,22 @@
+import type { RedactRule } from "../../schema/audit.js";
+/**
+ * Default regex denylist — applied even when the manifest declares no
+ * `audit.redact[]`. Catches the four obvious patterns called out in the
+ * design discussion: token, secret, password, api_key. Conservative on
+ * purpose: matches `key: value` / `key=value` and replaces the value
+ * with `<REDACTED>`.
+ */
+export declare const DEFAULT_REGEX_RULES: {
+    regex: string;
+    flags: string;
+    replacement: string;
+}[];
+export interface ResolvedRule {
+    pattern: RegExp;
+    replacement: string;
+}
+export interface ResolveRedactionOptions {
+    env?: NodeJS.ProcessEnv;
+}
+export declare function resolveRedactionRules(manifestRules: RedactRule[], opts?: ResolveRedactionOptions): ResolvedRule[];
+export declare function redactString(input: string, rules: ResolvedRule[]): string;

package/dist/cli/session-export/redact.js

@@ -0,0 +1,47 @@
+/**
+ * Default regex denylist — applied even when the manifest declares no
+ * `audit.redact[]`. Catches the four obvious patterns called out in the
+ * design discussion: token, secret, password, api_key. Conservative on
+ * purpose: matches `key: value` / `key=value` and replaces the value
+ * with `<REDACTED>`.
+ */
+export const DEFAULT_REGEX_RULES = [
+    {
+        regex: "(token|secret|password|api[_-]?key)([\"']?\\s*[:=]\\s*[\"']?)[^\\s\"',}]+",
+        flags: "gi",
+        replacement: "$1$2<REDACTED>",
+    },
+];
+export function resolveRedactionRules(manifestRules, opts = {}) {
+    const env = opts.env ?? process.env;
+    const out = [];
+    for (const def of DEFAULT_REGEX_RULES) {
+        out.push({ pattern: new RegExp(def.regex, def.flags), replacement: def.replacement });
+    }
+    for (const rule of manifestRules) {
+        if ("regex" in rule) {
+            out.push({ pattern: new RegExp(rule.regex, "g"), replacement: rule.replacement });
+        }
+        else {
+            const value = env[rule.env_var];
+            if (typeof value !== "string" || value.length === 0)
+                continue;
+            out.push({
+                pattern: new RegExp(escapeRegex(value), "g"),
+                replacement: rule.replacement,
+            });
+        }
+    }
+    return out;
+}
+function escapeRegex(literal) {
+    return literal.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export function redactString(input, rules) {
+    let out = input;
+    for (const r of rules) {
+        out = out.replace(r.pattern, r.replacement);
+    }
+    return out;
+}
+//# sourceMappingURL=redact.js.map

package/dist/cli/session-export/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../../src/cli/session-export/redact.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA4D;IAC1F;QACE,KAAK,EAAE,2EAA2E;QAClF,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,gBAAgB;KAC9B;CACF,CAAC;AAWF,MAAM,UAAU,qBAAqB,CACnC,aAA2B,EAC3B,OAAgC,EAAE;IAElC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACpF,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAC9D,GAAG,CAAC,IAAI,CAAC;gBACP,OAAO,EAAE,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;gBAC5C,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,KAAqB;IAC/D,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli/session-export/transcript.d.ts

@@ -0,0 +1,24 @@
+export type TranscriptEventKind = "user_prompt" | "user_tool_result" | "assistant_text" | "assistant_thinking" | "assistant_tool_use" | "attachment" | "permission_mode" | "file_history_snapshot";
+export interface TranscriptEvent {
+    source: "transcript";
+    kind: TranscriptEventKind;
+    timestamp: string | null;
+    uuid?: string | undefined;
+    parentUuid?: string | undefined;
+    cwd?: string | undefined;
+    data: Record<string, unknown>;
+}
+export interface TranscriptParseResult {
+    events: TranscriptEvent[];
+    startedAt: string | null;
+    endedAt: string | null;
+    cwd: string | null;
+    malformedLines: number;
+}
+export declare function parseTranscript(jsonl: string): TranscriptParseResult;
+export interface LocateTranscriptOptions {
+    homeDir?: string;
+    projectsRoot?: string;
+}
+export declare function locateTranscript(sessionId: string, opts?: LocateTranscriptOptions): string | null;
+export declare function readTranscript(filePath: string): TranscriptParseResult;

package/dist/cli/session-export/transcript.js

@@ -0,0 +1,162 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+export function parseTranscript(jsonl) {
+    const events = [];
+    let startedAt = null;
+    let endedAt = null;
+    let cwd = null;
+    let malformedLines = 0;
+    for (const line of jsonl.split("\n")) {
+        if (!line.trim())
+            continue;
+        let raw;
+        try {
+            raw = JSON.parse(line);
+        }
+        catch {
+            malformedLines += 1;
+            continue;
+        }
+        const ts = typeof raw.timestamp === "string" ? raw.timestamp : null;
+        if (ts !== null) {
+            if (startedAt === null || ts < startedAt)
+                startedAt = ts;
+            if (endedAt === null || ts > endedAt)
+                endedAt = ts;
+        }
+        if (typeof raw.cwd === "string" && cwd === null)
+            cwd = raw.cwd;
+        const baseFields = {
+            ...(typeof raw.uuid === "string" ? { uuid: raw.uuid } : {}),
+            ...(typeof raw.parentUuid === "string" ? { parentUuid: raw.parentUuid } : {}),
+            ...(typeof raw.cwd === "string" ? { cwd: raw.cwd } : {}),
+        };
+        const base = {
+            source: "transcript",
+            timestamp: ts,
+            ...baseFields,
+        };
+        switch (raw.type) {
+            case "user": {
+                const content = raw.message?.content;
+                if (typeof content === "string") {
+                    events.push({ ...base, kind: "user_prompt", data: { text: content } });
+                }
+                else if (Array.isArray(content)) {
+                    for (const block of content) {
+                        if (!block || typeof block !== "object")
+                            continue;
+                        const b = block;
+                        if (b.type === "tool_result") {
+                            events.push({
+                                ...base,
+                                kind: "user_tool_result",
+                                data: {
+                                    tool_use_id: b.tool_use_id,
+                                    is_error: b.is_error,
+                                    content: b.content,
+                                },
+                            });
+                        }
+                        else if (b.type === "text") {
+                            events.push({
+                                ...base,
+                                kind: "user_prompt",
+                                data: { text: b.text },
+                            });
+                        }
+                    }
+                }
+                break;
+            }
+            case "assistant": {
+                const content = raw.message?.content;
+                if (Array.isArray(content)) {
+                    for (const block of content) {
+                        if (!block || typeof block !== "object")
+                            continue;
+                        const b = block;
+                        if (b.type === "text") {
+                            events.push({
+                                ...base,
+                                kind: "assistant_text",
+                                data: { text: b.text },
+                            });
+                        }
+                        else if (b.type === "thinking") {
+                            events.push({
+                                ...base,
+                                kind: "assistant_thinking",
+                                data: { text: b.thinking ?? b.text },
+                            });
+                        }
+                        else if (b.type === "tool_use") {
+                            events.push({
+                                ...base,
+                                kind: "assistant_tool_use",
+                                data: { id: b.id, name: b.name, input: b.input },
+                            });
+                        }
+                    }
+                }
+                break;
+            }
+            case "attachment": {
+                events.push({
+                    ...base,
+                    kind: "attachment",
+                    data: { attachment: raw.attachment },
+                });
+                break;
+            }
+            case "permission-mode": {
+                events.push({
+                    ...base,
+                    kind: "permission_mode",
+                    data: { mode: raw.permissionMode },
+                });
+                break;
+            }
+            case "file-history-snapshot": {
+                events.push({
+                    ...base,
+                    kind: "file_history_snapshot",
+                    data: {
+                        messageId: raw.messageId,
+                        isSnapshotUpdate: raw.isSnapshotUpdate,
+                        snapshot: raw.snapshot,
+                    },
+                });
+                break;
+            }
+            default:
+                // Ignore unknown record types; future Claude Code versions may add new ones.
+                break;
+        }
+    }
+    return { events, startedAt, endedAt, cwd, malformedLines };
+}
+export function locateTranscript(sessionId, opts = {}) {
+    const projectsRoot = opts.projectsRoot ?? path.join(opts.homeDir ?? os.homedir(), ".claude", "projects");
+    if (!fs.existsSync(projectsRoot))
+        return null;
+    let dirs;
+    try {
+        dirs = fs.readdirSync(projectsRoot);
+    }
+    catch {
+        return null;
+    }
+    for (const dir of dirs) {
+        const candidate = path.join(projectsRoot, dir, `${sessionId}.jsonl`);
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+export function readTranscript(filePath) {
+    const raw = fs.readFileSync(filePath, "utf8");
+    return parseTranscript(raw);
+}
+//# sourceMappingURL=transcript.js.map