@sapiom/harness 0.0.0 → 0.1.1

package/dist/cli/machine-id.js

@@ -0,0 +1,75 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as crypto from "node:crypto";
+import { HARNESS_PATHS } from "../shared/types.js";
+import { expandHome } from "./paths.js";
+const UUID_SHAPE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Stable anonymous install id, used to tag every analytics event
+ * (`AnalyticsEvent.machineId`) regardless of which Sapiom user is signed in.
+ * Created once on first run and reused forever after.
+ *
+ * Hardened per `@sapiom/analytics-core`'s `identity.ts` pattern: private
+ * file permissions (mode 0600, on both create and a pre-existing file),
+ * silent regeneration when the stored content is missing/corrupt, and
+ * graceful degradation — an unreadable/unwritable HOME must never crash
+ * server boot over an analytics nicety. Kept as our own plain-text
+ * `~/.sapiom/harness/machine-id` file for now; converging onto her
+ * `~/.sapiom/analytics.json` identity is a separate, later conversation.
+ *
+ * @param filePath Where the id file lives. Defaults to the real
+ *   `HARNESS_PATHS.machineId`; tests and scripted checks pass a path under
+ *   their scratch state root so a boot never writes to the real home dir.
+ */
+export async function getOrCreateMachineId(filePath = expandHome(HARNESS_PATHS.machineId)) {
+    try {
+        const existing = await readMachineId(filePath);
+        if (existing) {
+            // Re-assert privacy even when we're not writing: a file created by a
+            // pre-hardening version of the harness (default `fs.writeFile` perms,
+            // typically 0644) would otherwise stay loosely-permissioned forever,
+            // since its content never needs to change again once it exists.
+            await hardenPermissions(filePath);
+            return existing;
+        }
+        const id = crypto.randomUUID();
+        await writeMachineId(filePath, id);
+        return id;
+    }
+    catch {
+        // Persistence is impossible (unwritable/unreadable HOME, permissions,
+        // whatever) — hand back a fresh id for this process rather than taking
+        // the server down over it. It won't be stable across runs, but every
+        // event within this run is at least internally consistent.
+        return crypto.randomUUID();
+    }
+}
+/** Reads and validates the persisted id. Missing, empty, or malformed
+ *  content returns `undefined` so the caller regenerates — same recovery
+ *  posture as `identity.ts`'s corrupt/wrong-shape handling. */
+async function readMachineId(filePath) {
+    try {
+        const raw = (await fs.readFile(filePath, "utf-8")).trim();
+        return UUID_SHAPE.test(raw) ? raw : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeMachineId(filePath, id) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true, mode: 0o700 });
+    // `mode` on writeFile only applies when creating the file — the follow-up
+    // hardenPermissions() covers the (unlikely but possible) case of writing
+    // over a pre-existing file at this path with looser permissions.
+    await fs.writeFile(filePath, id + "\n", { mode: 0o600 });
+    await hardenPermissions(filePath);
+}
+async function hardenPermissions(filePath) {
+    try {
+        await fs.chmod(filePath, 0o600);
+    }
+    catch {
+        // Best effort.
+    }
+}
+//# sourceMappingURL=machine-id.js.map

package/dist/cli/machine-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-id.js","sourceRoot":"","sources":["../../src/cli/machine-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,UAAU,GAAG,iEAAiE,CAAC;AAErF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE,CAAC;YACb,qEAAqE;YACrE,sEAAsE;YACtE,qEAAqE;YACrE,gEAAgE;YAChE,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAClC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACnC,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;QACtE,uEAAuE;QACvE,qEAAqE;QACrE,2DAA2D;QAC3D,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;+DAE+D;AAC/D,KAAK,UAAU,aAAa,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,EAAU;IACxD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,0EAA0E;IAC1E,yEAAyE;IACzE,iEAAiE;IACjE,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC"}

package/dist/cli/paths.d.ts

@@ -0,0 +1,3 @@
+/** Expand a leading `~` (as used by HARNESS_PATHS) to the user's home directory. */
+export declare function expandHome(p: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/cli/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAGA,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5C"}

package/dist/cli/paths.js

@@ -0,0 +1,11 @@
+import * as os from "node:os";
+import * as path from "node:path";
+/** Expand a leading `~` (as used by HARNESS_PATHS) to the user's home directory. */
+export function expandHome(p) {
+    if (p === "~")
+        return os.homedir();
+    if (p.startsWith("~/"))
+        return path.join(os.homedir(), p.slice(2));
+    return p;
+}
+//# sourceMappingURL=paths.js.map

package/dist/cli/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACnC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/settings.d.ts

@@ -0,0 +1,26 @@
+import { type HarnessSettings } from "../shared/types.js";
+/**
+ * Validates, normalizes, case-sensitively dedupes (first occurrence wins —
+ * callers order newest-first), and caps a candidate recent-dirs list.
+ * Applied on every write (via saveSettings) and on every read (via
+ * loadSettings), so junk already on disk self-heals the next time it's
+ * loaded instead of requiring a migration.
+ */
+export declare function sanitizeRecentDirs(candidates: string[]): Promise<string[]>;
+/** Whether settings have ever been persisted — used to detect first run. */
+export declare function hasStoredSettings(settingsPath?: string): Promise<boolean>;
+export declare function loadSettings(settingsPath?: string): Promise<HarnessSettings>;
+export declare function saveSettings(settings: HarnessSettings, settingsPath?: string): Promise<void>;
+/** Record `cwd` as the most-recently-used project directory (validated, deduped, capped). */
+export declare function recordRecentDir(cwd: string, settingsPath?: string): Promise<void>;
+/**
+ * Boot-time hygiene: persist the removal of recent-dir entries whose path no
+ * longer exists on disk. sanitizeRecentDirs() already drops them from every
+ * in-memory read, but a read alone never rewrites the file — so a dead entry
+ * (deleted project, a crashed check's temp dir) would otherwise sit in
+ * settings.json indefinitely. Returns the entries that were dropped; leaves
+ * the file completely untouched (not even created) when there is nothing to
+ * prune, so this can never break first-run detection (hasStoredSettings).
+ */
+export declare function pruneDeadRecentDirs(settingsPath?: string): Promise<string[]>;
+//# sourceMappingURL=settings.d.ts.map

package/dist/cli/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/cli/settings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAqCzE;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWhF;AAED,4EAA4E;AAC5E,wBAAsB,iBAAiB,CAAC,YAAY,GAAE,MAAkC,GAAG,OAAO,CAAC,OAAO,CAAC,CAO1G;AAED,wBAAsB,YAAY,CAAC,YAAY,GAAE,MAAkC,GAAG,OAAO,CAAC,eAAe,CAAC,CAQ7G;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,eAAe,EACzB,YAAY,GAAE,MAAkC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,6FAA6F;AAC7F,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,MAAkC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlH;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,YAAY,GAAE,MAAkC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkB7G"}

package/dist/cli/settings.js

@@ -0,0 +1,123 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { HARNESS_PATHS } from "../shared/types.js";
+import { expandHome } from "./paths.js";
+const DEFAULT_SETTINGS = {
+    telemetryOptIn: false,
+    recentDirs: [],
+};
+const MAX_RECENT_DIRS = 8;
+/** The real settings file. Every function below accepts an explicit path so
+ *  tests and scripted checks can point at a scratch state root instead —
+ *  omitted, they operate on the real file, unchanged for CLI users. */
+function defaultSettingsFilePath() {
+    return expandHome(HARNESS_PATHS.settings);
+}
+/**
+ * Resolves a candidate recent-dir entry to an absolute, existing directory
+ * path, or null if it doesn't qualify. Rejects anything that isn't a real
+ * directory on disk right now — relative paths, stray free text (e.g. typed
+ * into the directory field by mistake), and directories that have since been
+ * deleted all fall out here rather than accumulating in the list.
+ */
+async function normalizeRecentDir(candidate) {
+    const expanded = expandHome(candidate.trim());
+    if (!path.isAbsolute(expanded))
+        return null;
+    const resolved = path.resolve(expanded);
+    try {
+        const stat = await fs.stat(resolved);
+        if (!stat.isDirectory())
+            return null;
+    }
+    catch {
+        return null;
+    }
+    return resolved;
+}
+/**
+ * Validates, normalizes, case-sensitively dedupes (first occurrence wins —
+ * callers order newest-first), and caps a candidate recent-dirs list.
+ * Applied on every write (via saveSettings) and on every read (via
+ * loadSettings), so junk already on disk self-heals the next time it's
+ * loaded instead of requiring a migration.
+ */
+export async function sanitizeRecentDirs(candidates) {
+    const seen = new Set();
+    const result = [];
+    for (const candidate of candidates) {
+        if (result.length >= MAX_RECENT_DIRS)
+            break;
+        const normalized = await normalizeRecentDir(candidate);
+        if (normalized === null || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        result.push(normalized);
+    }
+    return result;
+}
+/** Whether settings have ever been persisted — used to detect first run. */
+export async function hasStoredSettings(settingsPath = defaultSettingsFilePath()) {
+    try {
+        await fs.access(settingsPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function loadSettings(settingsPath = defaultSettingsFilePath()) {
+    try {
+        const raw = await fs.readFile(settingsPath, "utf-8");
+        const parsed = { ...DEFAULT_SETTINGS, ...JSON.parse(raw) };
+        return { ...parsed, recentDirs: await sanitizeRecentDirs(parsed.recentDirs) };
+    }
+    catch {
+        return { ...DEFAULT_SETTINGS };
+    }
+}
+export async function saveSettings(settings, settingsPath = defaultSettingsFilePath()) {
+    const sanitized = {
+        ...settings,
+        recentDirs: await sanitizeRecentDirs(settings.recentDirs),
+    };
+    await fs.mkdir(path.dirname(settingsPath), { recursive: true });
+    await fs.writeFile(settingsPath, JSON.stringify(sanitized, null, 2) + "\n");
+}
+/** Record `cwd` as the most-recently-used project directory (validated, deduped, capped). */
+export async function recordRecentDir(cwd, settingsPath = defaultSettingsFilePath()) {
+    const settings = await loadSettings(settingsPath);
+    await saveSettings({ ...settings, recentDirs: [cwd, ...settings.recentDirs] }, settingsPath);
+}
+/**
+ * Boot-time hygiene: persist the removal of recent-dir entries whose path no
+ * longer exists on disk. sanitizeRecentDirs() already drops them from every
+ * in-memory read, but a read alone never rewrites the file — so a dead entry
+ * (deleted project, a crashed check's temp dir) would otherwise sit in
+ * settings.json indefinitely. Returns the entries that were dropped; leaves
+ * the file completely untouched (not even created) when there is nothing to
+ * prune, so this can never break first-run detection (hasStoredSettings).
+ */
+export async function pruneDeadRecentDirs(settingsPath = defaultSettingsFilePath()) {
+    let stored;
+    try {
+        stored = JSON.parse(await fs.readFile(settingsPath, "utf-8"));
+    }
+    catch {
+        return []; // no settings file yet (or unreadable) — nothing to prune
+    }
+    const recentDirs = Array.isArray(stored.recentDirs)
+        ? stored.recentDirs.filter((entry) => typeof entry === "string")
+        : [];
+    const dead = [];
+    for (const entry of recentDirs) {
+        if ((await normalizeRecentDir(entry)) === null)
+            dead.push(entry);
+    }
+    if (dead.length === 0)
+        return [];
+    // saveSettings' own sanitize pass is what actually drops the dead entries.
+    await saveSettings({ ...DEFAULT_SETTINGS, ...stored, recentDirs }, settingsPath);
+    return dead;
+}
+//# sourceMappingURL=settings.js.map

package/dist/cli/settings.js.map

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

package/dist/core/adapters/claude-code.d.ts

@@ -0,0 +1,41 @@
+/**
+ * claude-code adapter — launches/resumes the `claude` CLI and scans its
+ * transcript store for resumable history. All Sapiom-ness is injected via
+ * flags (settings/mcp-config/system-prompt); nothing here mutates the user's
+ * own `~/.claude` config.
+ */
+import type { DoctorCheck, HarnessAdapter, LaunchOpts, SessionSummary, SpawnSpec } from "../../shared/types.js";
+export interface ClaudeCodeAdapterOptions {
+    /** Overridable for tests (e.g. spawn `bash` instead of a real, auth-gated `claude`). */
+    binary?: string;
+    /** Overridable for tests. Defaults to the real home directory. */
+    homeDir?: string;
+}
+export declare class ClaudeCodeAdapter implements HarnessAdapter {
+    readonly id: "claude-code";
+    readonly eventSource: "hooks";
+    private readonly binary;
+    private readonly homeDir;
+    constructor(options?: ClaudeCodeAdapterOptions);
+    doctor(): Promise<DoctorCheck[]>;
+    launch(opts: LaunchOpts): SpawnSpec;
+    resume(agentSessionId: string, opts: LaunchOpts): SpawnSpec;
+    /**
+     * Headless one-shot run for TaskManager (see HarnessAdapter.launchTask).
+     * Verified against a real `claude` binary: `-p` carries the exact same
+     * --settings/--mcp-config/--append-system-prompt injection as launch()
+     * (all six hooks fire), skips the trust dialog entirely, and exits on its
+     * own when the turn completes. The extra flags:
+     * - --permission-mode acceptEdits: a headless task has no human to click
+     *   through a permission prompt — without it a tool call hangs forever.
+     * - --output-format stream-json --verbose: line-oriented JSON progress on
+     *   stdout (parsed by core/task-stream.ts) instead of a bare final answer.
+     * - --model / --max-turns: only when the caller sets them — a bounded task
+     *   (canvas enrichment) pins a cheaper model and a hard turn cap instead of
+     *   inheriting the user's interactive defaults.
+     */
+    launchTask(opts: LaunchOpts): SpawnSpec;
+    listPastSessions(cwd: string): Promise<SessionSummary[]>;
+}
+export declare function createClaudeCodeAdapter(options?: ClaudeCodeAdapterOptions): HarnessAdapter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/core/adapters/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,EACV,MAAM,uBAAuB,CAAC;AAQ/B,MAAM,WAAW,wBAAwB;IACvC,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuGD,qBAAa,iBAAkB,YAAW,cAAc;IACtD,QAAQ,CAAC,EAAE,EAAG,aAAa,CAAU;IACrC,QAAQ,CAAC,WAAW,EAAG,OAAO,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,wBAA6B;IAK5C,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAetC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS;IAgBnC,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS;IAa3D;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS;IAmBjC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CA8B/D;AAcD,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,cAAc,CAE1F"}

package/dist/core/adapters/claude-code.js

@@ -0,0 +1,238 @@
+/**
+ * claude-code adapter — launches/resumes the `claude` CLI and scans its
+ * transcript store for resumable history. All Sapiom-ness is injected via
+ * flags (settings/mcp-config/system-prompt); nothing here mutates the user's
+ * own `~/.claude` config.
+ */
+import { execFile } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { readFile, readdir, stat, open } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/** Bytes read from the tail of a transcript file. Files can be 100MB+; the
+ * summary/title we need is always near the end. */
+const TRANSCRIPT_TAIL_BYTES = 65536;
+/**
+ * Claude Code stores transcripts at `~/.claude/projects/<encoded-cwd>/*.jsonl`.
+ * The encoding strips the leading `/` and replaces `/` and `.` with `-`.
+ * If Claude Code changes this scheme, discovery silently returns no history
+ * (listPastSessions degrades to an empty list, not an error).
+ */
+function encodeProjectPath(cwd) {
+    const normalized = cwd.replace(/\\/g, "/");
+    return normalized.replace(/:/g, "").replace(/[/.]/g, "-");
+}
+function extractTextFromContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        const texts = content
+            .map((block) => typeof block === "object" && block !== null && "text" in block
+            ? block.text
+            : undefined)
+            .filter((text) => typeof text === "string");
+        return texts.length > 0 ? texts.join(" ") : undefined;
+    }
+    return undefined;
+}
+/** Read only the tail of a (possibly huge) JSONL transcript file. */
+async function readTranscriptTail(filePath, maxBytes = TRANSCRIPT_TAIL_BYTES) {
+    let content;
+    let startedMidFile = false;
+    try {
+        const { size } = await stat(filePath);
+        if (size <= maxBytes) {
+            content = await readFile(filePath, "utf8");
+        }
+        else {
+            const offset = size - maxBytes;
+            const handle = await open(filePath, "r");
+            try {
+                const buffer = Buffer.allocUnsafe(maxBytes);
+                await handle.read(buffer, 0, maxBytes, offset);
+                content = buffer.toString("utf8");
+                startedMidFile = true;
+            }
+            finally {
+                await handle.close();
+            }
+        }
+    }
+    catch {
+        return [];
+    }
+    // A tail read may start mid-line; drop the (possibly truncated) first line.
+    const firstNewline = content.indexOf("\n");
+    const safeContent = startedMidFile && firstNewline >= 0 ? content.slice(firstNewline + 1) : content;
+    const entries = [];
+    for (const line of safeContent.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+                entries.push(parsed);
+            }
+        }
+        catch {
+            // Skip malformed/truncated lines (expected at the start of a tail read).
+        }
+    }
+    return entries;
+}
+function extractTitle(entries, fallback) {
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (entry?.type === "summary" && typeof entry.summary === "string" && entry.summary.trim()) {
+            return entry.summary.trim();
+        }
+    }
+    for (const entry of entries) {
+        if (entry?.type !== "user")
+            continue;
+        const text = extractTextFromContent(entry.message?.content)?.trim();
+        if (text)
+            return text.length > 120 ? `${text.slice(0, 120)}...` : text;
+    }
+    return fallback;
+}
+function buildConfigArgs(opts) {
+    const args = [];
+    if (opts.settingsFile)
+        args.push("--settings", opts.settingsFile);
+    if (opts.mcpConfigFile)
+        args.push("--mcp-config", opts.mcpConfigFile);
+    return args;
+}
+export class ClaudeCodeAdapter {
+    constructor(options = {}) {
+        this.id = "claude-code";
+        this.eventSource = "hooks";
+        this.binary = options.binary ?? "claude";
+        this.homeDir = options.homeDir ?? homedir();
+    }
+    async doctor() {
+        try {
+            const { stdout } = await execFileAsync(this.binary, ["--version"], { timeout: 5000 });
+            return [{ name: "claude", ok: true, detail: stdout.trim() || "installed" }];
+        }
+        catch {
+            return [
+                {
+                    name: "claude",
+                    ok: false,
+                    detail: `\`${this.binary}\` not found on PATH. Install Claude Code: https://docs.claude.com/en/docs/claude-code/setup`,
+                },
+            ];
+        }
+    }
+    launch(opts) {
+        const args = buildConfigArgs(opts);
+        if (opts.systemPromptFile) {
+            args.push("--append-system-prompt", readPromptFile(opts.systemPromptFile));
+        }
+        return {
+            command: this.binary,
+            args,
+            // Nested-agent conflict: Claude Code refuses to run "inside itself" if
+            // CLAUDECODE is already set, which it will be if the harness server
+            // itself was launched from within a Claude Code session.
+            env: { CLAUDECODE: null },
+            cwd: opts.cwd,
+        };
+    }
+    resume(agentSessionId, opts) {
+        const args = ["--resume", agentSessionId, ...buildConfigArgs(opts)];
+        if (opts.systemPromptFile) {
+            args.push("--append-system-prompt", readPromptFile(opts.systemPromptFile));
+        }
+        return {
+            command: this.binary,
+            args,
+            env: { CLAUDECODE: null },
+            cwd: opts.cwd,
+        };
+    }
+    /**
+     * Headless one-shot run for TaskManager (see HarnessAdapter.launchTask).
+     * Verified against a real `claude` binary: `-p` carries the exact same
+     * --settings/--mcp-config/--append-system-prompt injection as launch()
+     * (all six hooks fire), skips the trust dialog entirely, and exits on its
+     * own when the turn completes. The extra flags:
+     * - --permission-mode acceptEdits: a headless task has no human to click
+     *   through a permission prompt — without it a tool call hangs forever.
+     * - --output-format stream-json --verbose: line-oriented JSON progress on
+     *   stdout (parsed by core/task-stream.ts) instead of a bare final answer.
+     * - --model / --max-turns: only when the caller sets them — a bounded task
+     *   (canvas enrichment) pins a cheaper model and a hard turn cap instead of
+     *   inheriting the user's interactive defaults.
+     */
+    launchTask(opts) {
+        if (!opts.prompt) {
+            throw new Error("claude-code adapter: launchTask requires opts.prompt");
+        }
+        const args = ["-p", opts.prompt, ...buildConfigArgs(opts)];
+        if (opts.systemPromptFile) {
+            args.push("--append-system-prompt", readPromptFile(opts.systemPromptFile));
+        }
+        if (opts.model)
+            args.push("--model", opts.model);
+        if (opts.maxTurns != null)
+            args.push("--max-turns", String(opts.maxTurns));
+        args.push("--permission-mode", "acceptEdits", "--output-format", "stream-json", "--verbose");
+        return {
+            command: this.binary,
+            args,
+            env: { CLAUDECODE: null },
+            cwd: opts.cwd,
+        };
+    }
+    async listPastSessions(cwd) {
+        const projectDir = join(this.homeDir, ".claude", "projects", encodeProjectPath(cwd));
+        let entries;
+        try {
+            entries = await readdir(projectDir);
+        }
+        catch {
+            return [];
+        }
+        const summaries = [];
+        for (const file of entries) {
+            if (!file.endsWith(".jsonl"))
+                continue;
+            const filePath = join(projectDir, file);
+            const agentSessionId = basename(file, ".jsonl");
+            const transcript = await readTranscriptTail(filePath);
+            if (transcript.length === 0)
+                continue;
+            const fileStat = await stat(filePath).catch(() => undefined);
+            const lastActiveAt = fileStat ? fileStat.mtime.toISOString() : new Date(0).toISOString();
+            summaries.push({
+                agentSessionId,
+                harness: "claude-code",
+                cwd,
+                title: extractTitle(transcript, agentSessionId),
+                lastActiveAt,
+                source: "transcript",
+            });
+        }
+        return summaries.sort((a, b) => (a.lastActiveAt < b.lastActiveAt ? 1 : -1));
+    }
+}
+function readPromptFile(path) {
+    // launch()/resume() are synchronous per the adapter contract, so this reads
+    // synchronously; profile prompts are small (a few KB), read once at spawn time.
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch (err) {
+        throw new Error(`claude-code adapter: failed to read systemPromptFile "${path}": ${err.message}`);
+    }
+}
+export function createClaudeCodeAdapter(options) {
+    return new ClaudeCodeAdapter(options);
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/core/adapters/claude-code.js.map

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

package/dist/core/adapters/codex.d.ts

@@ -0,0 +1,59 @@
+/**
+ * codex adapter — launches/resumes the `codex` CLI and scans its rollout
+ * store for resumable history. Codex has no hook system (see
+ * core/collector/codex-tailer.ts for how its analytics eventSource works
+ * instead); this file only covers process launch/resume/doctor/history.
+ *
+ * Verified against a locally installed `codex-cli 0.134.0`: `codex resume
+ * [SESSION_ID] [PROMPT]` (positional UUID or thread name) via `codex resume
+ * --help`; the generic `-c key=value` config-override mechanism via `codex
+ * --help`; and, via real spawns with `--strict-config`, that both
+ * `developer_instructions` and `model_instructions_file` are real,
+ * recognized keys (an earlier version of this file used the latter and
+ * flagged both as unconfirmed — see buildConfigArgs below for why the
+ * adapter now uses `developer_instructions` instead: `model_instructions_file`
+ * makes codex's own startup depend on re-reading a file we already have the
+ * content of, and an unreadable path there kills the process instantly with
+ * no trust prompt, no TUI — precisely the "session has no live pty" a user
+ * sees with zero indication why).
+ */
+import type { DoctorCheck, HarnessAdapter, LaunchOpts, SessionSummary, SpawnSpec } from "../../shared/types.js";
+/** Strips ANSI/CSI/OSC control sequences a pty stream is otherwise full of,
+ *  so text pattern-matching (e.g. `TRUST_PROMPT_PATTERN`) sees the words a
+ *  human would actually read rather than raw terminal-control bytes. Not
+ *  exhaustive of every escape sequence a TUI could emit, but covers what
+ *  Codex's TUI is confirmed (via real captures) to use: CSI (cursor moves,
+ *  SGR color/style) and OSC (window title) sequences. */
+export declare function stripAnsi(text: string): string;
+export interface CodexAdapterOptions {
+    /** Overridable for tests. */
+    binary?: string;
+    /** Overridable for tests. Defaults to the real home directory. */
+    homeDir?: string;
+}
+export declare class CodexAdapter implements HarnessAdapter {
+    readonly id: "codex";
+    readonly eventSource: "transcript-tail";
+    private readonly binary;
+    private readonly homeDir;
+    constructor(options?: CodexAdapterOptions);
+    doctor(): Promise<DoctorCheck[]>;
+    launch(opts: LaunchOpts): SpawnSpec;
+    resume(agentSessionId: string, opts: LaunchOpts): SpawnSpec;
+    /**
+     * See `HarnessAdapter.detectBlockingPrompt`. Codex needs this (Claude Code
+     * doesn't) because its rollout file — and therefore the SessionStart-
+     * equivalent event `SessionManager` otherwise waits on — isn't written
+     * until the *first* turn is actually submitted, confirmed empirically
+     * against a real `codex-cli 0.134.0`: an idle, fully-interactive session
+     * (trust prompt already accepted, composer visibly ready) produces zero
+     * files under `~/.codex/sessions` for as long as nothing is submitted.
+     * That real signal therefore can't arrive before the very first
+     * injection that needs it — a scrollback check is the only thing that
+     * can stand in for it up to that point.
+     */
+    detectBlockingPrompt(scrollback: string): boolean;
+    listPastSessions(cwd: string): Promise<SessionSummary[]>;
+}
+export declare function createCodexAdapter(options?: CodexAdapterOptions): HarnessAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/core/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/codex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,EACV,MAAM,uBAAuB,CAAC;AA0B/B;;;;;yDAKyD;AACzD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB9C;AAED,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmGD,qBAAa,YAAa,YAAW,cAAc;IACjD,QAAQ,CAAC,EAAE,EAAG,OAAO,CAAU;IAC/B,QAAQ,CAAC,WAAW,EAAG,iBAAiB,CAAU;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,mBAAwB;IAKvC,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAetC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS;IAWnC,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS;IAS3D;;;;;;;;;;;OAWG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI3C,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAwC/D;AA8DD,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,cAAc,CAEhF"}