@oharness/engine 0.1.0

package/dist/agent/store.js

@@ -0,0 +1,596 @@
+import { titleFromMessage } from "./titles.js";
+import { userPath } from "../paths.js";
+import { copyFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+import { shortId, sessionId as newSessionId } from "../util/id.js";
+import { safeTruncate } from "./compaction.js";
+import { JsonStore } from "../storage/kv.js";
+import { migrate } from "../storage/migrate.js";
+import { projectId } from "../storage/project.js";
+import { asRecord, messageId, orderRecords } from "../storage/records.js";
+import { asAuditEntry } from "./permissions.js";
+import { asArtifactRevision } from "../artifacts/store.js";
+/**
+ * Cap on how much of an archive a single `recall` loads. Generous enough that
+ * ordinary sessions read in full, small enough that a runaway one cannot
+ * exhaust memory.
+ */
+export const MAX_ARCHIVE_READ_BYTES = 8 * 1024 * 1024;
+/**
+ * Cap on how much of a permission trail one read loads. Smaller than the
+ * archive's: these are short lines, and a page showing the trail wants the
+ * recent end of it, not a session's entire history of tool calls.
+ */
+export const MAX_DECISION_READ_BYTES = 1024 * 1024;
+export class SessionStore {
+    kv;
+    legacyRoot;
+    ready;
+    deviceId;
+    /** Which project a session was found under, so a second read is a direct hit. */
+    located = new Map();
+    watchers = new Set();
+    constructor(root) {
+        this.kv = new JsonStore(root ?? userPath("storage"));
+        // Only the default root has a predecessor to import. A caller that named
+        // its own directory means that directory, not "that one plus history from
+        // somewhere else".
+        this.legacyRoot = root ? undefined : userPath("sessions");
+    }
+    get root() {
+        return this.kv.root;
+    }
+    /**
+     * Watch local writes. Returns the unsubscribe.
+     *
+     * Sync needs to know when to push, and the alternatives are worse: polling
+     * the directory turns an event into a delay, and calling a client from the
+     * write paths would put a network dependency inside the only thing here that
+     * must not be able to fail. A watcher is told what changed and decides for
+     * itself, so nothing above this file is reachable from below it.
+     *
+     * Listeners are called after the write has landed, and one that throws is
+     * ignored — a mirror falling over is not a reason to lose a transcript.
+     */
+    watch(listener) {
+        this.watchers.add(listener);
+        return () => this.watchers.delete(listener);
+    }
+    announce(change) {
+        for (const watcher of this.watchers) {
+            try {
+                watcher(change);
+            }
+            catch {
+                // Deliberately swallowed; see `watch`.
+            }
+        }
+    }
+    /** A session's transcript as records, ordered and deduplicated. */
+    async recordsOf(id) {
+        await this.prepare();
+        return this.records(id);
+    }
+    /** A session's metadata, without being told which project it is under. */
+    async readMeta(id) {
+        return this.findMeta(id);
+    }
+    /**
+     * Take records that were written somewhere else.
+     *
+     * Distinct from `appendMessage`, which mints an id, a seq and this device —
+     * exactly the three fields that must survive the trip for a merge to work.
+     * The log is append-only and `orderRecords` deduplicates on read, so writing
+     * a record that is already held costs a line and changes nothing, which is
+     * what makes a retried pull safe.
+     */
+    async mergeRecords(id, incoming) {
+        if (incoming.length === 0)
+            return 0;
+        await this.prepare();
+        const held = new Set((await this.records(id)).map((record) => record.id));
+        const fresh = incoming.filter((record) => !held.has(record.id));
+        if (fresh.length === 0)
+            return 0;
+        await this.kv.append(["message", id], fresh);
+        return fresh.length;
+    }
+    /**
+     * Take metadata written somewhere else, if it is newer.
+     *
+     * Generation first, then wall clock. A generation is bumped by a rewrite, so
+     * a device that compacted a session wins over one that merely kept appending
+     * to it — no amount of clock skew should let a stale full transcript
+     * overwrite a summary that replaced it.
+     */
+    async mergeMeta(incoming) {
+        await this.prepare();
+        const held = await this.findMeta(incoming.id);
+        if (held) {
+            const heldGen = held.gen ?? 0;
+            const incomingGen = incoming.gen ?? 0;
+            if (incomingGen < heldGen)
+                return false;
+            if (incomingGen === heldGen && incoming.updatedAt <= held.updatedAt)
+                return false;
+        }
+        await this.putMeta(incoming);
+        return true;
+    }
+    /** Layout changes run once, on first use, before anything reads. */
+    prepare() {
+        this.ready ??= migrate(this.kv, this.legacyRoot).catch(() => { });
+        return this.ready;
+    }
+    /**
+     * This machine's id.
+     *
+     * Two devices appending to one session need to be distinguishable, and the
+     * tiebreak has to survive restarts — so it is stored rather than generated
+     * per process.
+     */
+    device() {
+        this.deviceId ??= (async () => {
+            const existing = await this.kv.read(["device"]);
+            if (existing?.id)
+                return existing.id;
+            const id = `dev_${shortId(6)}`;
+            await this.kv.write(["device"], { id, createdAt: Date.now() });
+            return id;
+        })();
+        return this.deviceId;
+    }
+    async projectOf(meta) {
+        const id = meta.projectId ?? (await projectId(meta.cwd || this.kv.root));
+        this.located.set(meta.id, id);
+        return id;
+    }
+    /** Find a session's metadata without being told which project it is in. */
+    async findMeta(id) {
+        await this.prepare();
+        const known = this.located.get(id);
+        if (known) {
+            const hit = await this.kv.read(["session", known, id]);
+            if (hit)
+                return hit;
+            this.located.delete(id);
+        }
+        for (const key of await this.kv.list(["session"])) {
+            if (key[key.length - 1] !== id)
+                continue;
+            const meta = await this.kv.read(key);
+            if (meta) {
+                this.located.set(id, key[1]);
+                return meta;
+            }
+        }
+        return undefined;
+    }
+    async create(meta) {
+        await this.prepare();
+        await this.writeMeta(meta);
+    }
+    async writeMeta(meta) {
+        const stored = await this.putMeta(meta);
+        this.announce({ kind: "write", id: meta.id, projectId: stored.projectId, meta: stored });
+    }
+    /**
+     * The write itself, without telling anyone.
+     *
+     * Applying what a pull returned goes through here: announcing it would have
+     * the mirror push back what it had just received, and while the server
+     * deduplicates that, a loop that is merely harmless is still a loop.
+     */
+    async putMeta(meta) {
+        await this.prepare();
+        const project = await this.projectOf(meta);
+        const stored = { ...meta, projectId: project };
+        await this.kv.write(["session", project, meta.id], stored);
+        await this.touchProject(project, meta.cwd);
+        return stored;
+    }
+    async touchProject(id, cwd) {
+        const existing = await this.kv.read(["project", id]);
+        const now = Date.now();
+        // Rewritten only when something changed: a project record touched on every
+        // metadata write would be the busiest file in the store for no gain.
+        if (existing && existing.worktree === cwd)
+            return;
+        await this.kv.write(["project", id], {
+            id,
+            vcs: id.startsWith("dir-") ? "none" : "git",
+            worktree: cwd,
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+        });
+    }
+    async appendMessage(id, message) {
+        await this.prepare();
+        const meta = await this.findMeta(id);
+        const seq = (meta?.seq ?? (await this.records(id)).length) + 1;
+        const record = {
+            id: messageId(),
+            seq,
+            device: await this.device(),
+            at: Date.now(),
+            message,
+        };
+        await this.kv.append(["message", id], [record]);
+        if (meta)
+            await this.writeMeta({ ...meta, seq });
+    }
+    /**
+     * Record one artifact revision on disk.
+     *
+     * A log rather than a document, for the same reason the transcript is one:
+     * a revision is a thing that happened, appending never rewrites what is
+     * already there, and a crashed process still leaves everything written
+     * before it. It also means the version history comes free — the file is the
+     * history, in order.
+     *
+     * Keyed by session alone, like `message` and `archive`, because an artifact
+     * belongs to the conversation that made it and is found the same way.
+     *
+     * This is what makes an artifact something other than a by-product of the
+     * transcript. A model's write was always recoverable, because the content is
+     * the argument of a tool call and tool calls are in the transcript. A
+     * revision a person made in the canvas is not a tool call and was therefore
+     * nowhere: a restart brought the model's version back as the newest one and
+     * said nothing about what it had replaced.
+     */
+    async appendArtifactRevision(id, revision) {
+        await this.prepare();
+        // The same three fields `appendMessage` mints, and the same counter: the
+        // mirror tracks one watermark per session, so a revision that numbered
+        // itself in a private sequence would either be pushed forever or never.
+        const meta = await this.findMeta(id);
+        const seq = (meta?.seq ?? (await this.records(id)).length) + 1;
+        const stored = {
+            id: `art_${shortId(8)}`,
+            seq,
+            device: await this.device(),
+            ...revision,
+        };
+        await this.kv.append(["artifact", id], [stored]);
+        if (meta)
+            await this.writeMeta({ ...meta, seq });
+    }
+    /**
+     * Take artifact revisions written on another device.
+     *
+     * The counterpart to `mergeRecords`, and deliberately its shape: dedupe on
+     * the record id, append what is new, and let the reader fold the file
+     * together. A revision already held costs a line and changes nothing, which
+     * is what makes a retried pull safe.
+     */
+    async mergeArtifactRevisions(id, incoming) {
+        if (incoming.length === 0)
+            return 0;
+        await this.prepare();
+        const held = new Set((await this.artifactRevisions(id)).map((revision) => revision.id).filter(Boolean));
+        const fresh = incoming.filter((revision) => !revision.id || !held.has(revision.id));
+        if (fresh.length === 0)
+            return 0;
+        await this.kv.append(["artifact", id], fresh);
+        return fresh.length;
+    }
+    /**
+     * Sessions that have written an artifact, whether or not they are loaded.
+     *
+     * A directory read, not a transcript read. Artifacts belong to sessions and
+     * a session's store is memory, so "everything on this machine" used to mean
+     * "everything currently open" — which is a listing that changes depending on
+     * which tabs happen to be open, and that is not a listing anybody can trust.
+     * The logs are the durable record; this says which ones exist so a caller
+     * can fold the ones it wants without opening a session to ask.
+     */
+    async artifactSessions() {
+        await this.prepare();
+        return (await this.kv.listLogs(["artifact"])).map((key) => key[key.length - 1]);
+    }
+    /**
+     * Every artifact revision recorded for a session, oldest first.
+     *
+     * `maxBytes` reads the tail, for a caller that is building a listing rather
+     * than restoring a session: the newest lines are the ones a listing shows,
+     * and a log with a megabyte of superseded revisions in it should not cost a
+     * megabyte to summarise.
+     */
+    async artifactRevisions(id, maxBytes) {
+        await this.prepare();
+        const lines = await this.kv.readLog(["artifact", id], maxBytes);
+        const out = [];
+        for (const line of lines) {
+            const revision = asArtifactRevision(line);
+            // A line this build cannot read is skipped rather than fatal: the file
+            // is append-only and shared with future versions, and refusing to load
+            // any of it because of one line would lose the rest.
+            if (revision)
+                out.push(revision);
+        }
+        return out;
+    }
+    /**
+     * Record one permission decision, with the session it happened in.
+     *
+     * Beside the transcript rather than in a file of its own somewhere else,
+     * because a decision is a thing that happened *in this conversation*: kept
+     * here it is found the way everything else about the session is found,
+     * deleted when the session is deleted, and readable next to the tool call it
+     * was about. A separate audit file is a second truth that has to be
+     * correlated by timestamp, and correlating by timestamp is how two records
+     * of the same event end up disagreeing.
+     *
+     * No seq and no device, unlike messages and artifact revisions: nothing
+     * merges this log. It stays on the machine that wrote it — see `SessionMirror`,
+     * which pushes messages and artifacts and deliberately not this.
+     */
+    async appendDecision(id, entry) {
+        await this.prepare();
+        await this.kv.append(["decision", id], [entry]);
+    }
+    /**
+     * A session's permission trail, oldest first.
+     *
+     * Bounded like the archive read: the trail grows for the life of a session —
+     * every tool call adds a line — and a long unattended run should not be able
+     * to make reading it the most expensive thing the harness does.
+     */
+    async decisions(id, maxBytes = MAX_DECISION_READ_BYTES) {
+        await this.prepare();
+        const lines = await this.kv.readLog(["decision", id], maxBytes);
+        const out = [];
+        for (const line of lines) {
+            const entry = asAuditEntry(line);
+            if (entry)
+                out.push(entry);
+        }
+        return out;
+    }
+    /**
+     * Append messages to the archive before they leave the live transcript.
+     *
+     * Compaction replaces history with a lossy summary; without this the
+     * originals would be unrecoverable — not just to the agent, but to anyone
+     * debugging the session afterwards. The archive is append-only and is never
+     * rewritten.
+     */
+    async archiveMessages(id, entries) {
+        if (entries.length === 0)
+            return;
+        await this.prepare();
+        const archivedAt = Date.now();
+        await this.kv.append(["archive", id], entries.map((entry) => ({ seq: entry.seq, archivedAt, message: entry.message })));
+    }
+    /**
+     * Read the archive, newest-biased and bounded.
+     *
+     * The archive is append-only and grows for the life of a session — every
+     * compaction and every oversized tool result adds to it. Reading all of it
+     * into memory to answer one `recall` would eventually be the most expensive
+     * thing the harness does, so only the tail is loaded past a threshold.
+     */
+    async readArchive(id, maxBytes = MAX_ARCHIVE_READ_BYTES) {
+        await this.prepare();
+        const lines = await this.kv.readLog(["archive", id], maxBytes);
+        return lines.filter((line) => Boolean(line && line.message));
+    }
+    /**
+     * Branch a session into a new one.
+     *
+     * The parent is never touched — that is the whole point. Exploring a
+     * different approach should not cost you the transcript that got you here,
+     * and mutating in place makes "go back and try the other thing" impossible.
+     */
+    async fork(sourceId, opts = {}) {
+        const source = await this.load(sourceId);
+        if (!source)
+            return undefined;
+        const messages = opts.keepMessages === undefined
+            ? source.messages
+            : safeTruncate(source.messages, opts.keepMessages);
+        const id = opts.newId ?? newSessionId();
+        const now = Date.now();
+        const meta = {
+            ...source.meta,
+            id,
+            createdAt: now,
+            updatedAt: now,
+            title: opts.title ?? (source.meta.title ? `${source.meta.title} (fork)` : undefined),
+            // Cost and turns belong to the parent's history, not the branch's.
+            turns: 0,
+            usage: { inputTokens: 0, outputTokens: 0 },
+            costUsd: 0,
+            forkedFrom: sourceId,
+            forkedAt: messages.length,
+            gen: 0,
+            seq: messages.length,
+        };
+        await this.writeMeta(meta);
+        await this.replaceMessages(id, messages);
+        // The archive holds what compaction dropped, which is always older than
+        // the live transcript — so it is valid for any fork point.
+        const target = this.kv.log(["archive", id]);
+        await mkdir(path.dirname(target), { recursive: true });
+        await copyFile(this.kv.log(["archive", sourceId]), target).catch(() => { });
+        return { id, meta, messages };
+    }
+    /** Permanently remove a session and everything it recorded. */
+    async delete(id) {
+        const meta = await this.findMeta(id);
+        if (!meta)
+            return false;
+        const project = meta.projectId ?? (await this.projectOf(meta));
+        await this.kv.remove(["session", project, id]);
+        await this.kv.removeLog(["message", id]);
+        await this.kv.removeLog(["archive", id]);
+        await this.kv.removeLog(["decision", id]);
+        // Every log keyed by this session, or deleting it leaves the parts that
+        // were added after the delete path was written — which is how a deleted
+        // session keeps its artifact revisions on disk forever.
+        await this.kv.removeLog(["artifact", id]);
+        this.located.delete(id);
+        // Announced with the metadata read a moment ago, because a deletion has to
+        // travel as a fact of its own: a device that only hears silence still
+        // holds the session, and would hand it back on the next push.
+        this.announce({
+            kind: "delete",
+            id,
+            projectId: project,
+            meta: { ...meta, gen: (meta.gen ?? 0) + 1, updatedAt: Date.now() },
+        });
+        return true;
+    }
+    /**
+     * Every session recorded in one tree, deleted.
+     *
+     * By working directory rather than by project id, because that is what the
+     * sidebar groups by and therefore what somebody is looking at when they ask
+     * for this. Deleting one at a time is the same work either way — there is no
+     * bulk primitive underneath — but each one still announces its own tombstone,
+     * so a device syncing with this one loses exactly the same set.
+     *
+     * Returns the ids that went, so a caller holding open tabs knows which of
+     * them are now pointing at nothing.
+     */
+    async deleteIn(cwd) {
+        const all = await this.list(Number.MAX_SAFE_INTEGER);
+        const gone = [];
+        const projects = new Set();
+        for (const meta of all) {
+            if (meta.cwd !== cwd)
+                continue;
+            const project = meta.projectId ?? (await this.projectOf(meta));
+            if (await this.delete(meta.id)) {
+                gone.push(meta.id);
+                projects.add(project);
+            }
+        }
+        // The project record too, once nothing is left under it. Asked of the
+        // store rather than of the metas just read, because a session file need
+        // not carry the project id — the key it is filed under is the truth. Kept
+        // when something is left: a repository and a worktree of it share a
+        // project id, so clearing one tree's sessions can leave the other's.
+        for (const project of projects) {
+            if ((await this.kv.list(["session", project])).length > 0)
+                continue;
+            await this.kv.remove(["project", project]);
+        }
+        return gone;
+    }
+    async rename(id, title) {
+        const meta = await this.findMeta(id);
+        if (!meta)
+            return false;
+        await this.writeMeta({ ...meta, title, updatedAt: Date.now() });
+        return true;
+    }
+    /** Sessions branched from a given one. */
+    async children(id) {
+        const all = await this.list(Number.MAX_SAFE_INTEGER);
+        return all.filter((meta) => meta.forkedFrom === id);
+    }
+    /**
+     * Delete old sessions.
+     *
+     * Nothing reclaimed these before, so a machine used daily accumulates every
+     * transcript and archive it ever produced. Returns the ids removed.
+     */
+    async prune(opts = {}) {
+        const { maxAgeDays, keep } = opts;
+        if (maxAgeDays === undefined && keep === undefined)
+            return [];
+        const sessions = await this.list(Number.MAX_SAFE_INTEGER);
+        // `list` is newest-first, so anything past `keep` is the oldest.
+        const cutoff = maxAgeDays === undefined ? 0 : Date.now() - maxAgeDays * 86_400_000;
+        const doomed = sessions.filter((meta, index) => {
+            if (keep !== undefined && index >= keep)
+                return true;
+            if (maxAgeDays !== undefined && meta.updatedAt < cutoff)
+                return true;
+            return false;
+        });
+        const removed = [];
+        for (const meta of doomed) {
+            // A session we cannot delete is not worth failing startup over.
+            if (await this.delete(meta.id).catch(() => false))
+                removed.push(meta.id);
+        }
+        return removed;
+    }
+    /** Rewrite the transcript wholesale — used after compaction. */
+    async replaceMessages(id, messages) {
+        await this.prepare();
+        const device = await this.device();
+        const at = Date.now();
+        const records = messages.map((message, index) => ({
+            id: messageId(),
+            seq: index + 1,
+            device,
+            at,
+            message,
+        }));
+        await this.kv.replaceLog(["message", id], records);
+        const meta = await this.findMeta(id);
+        // A rewrite is a new generation: a device holding the pre-compaction log
+        // must not merge its appends back in on top of the summary.
+        if (meta)
+            await this.writeMeta({ ...meta, gen: (meta.gen ?? 0) + 1, seq: records.length });
+    }
+    async records(id) {
+        const lines = await this.kv.readLog(["message", id]);
+        const records = [];
+        lines.forEach((line, index) => {
+            const record = asRecord(line, index);
+            if (record)
+                records.push(record);
+        });
+        return orderRecords(records);
+    }
+    async load(id) {
+        const meta = await this.findMeta(id);
+        if (!meta)
+            return undefined;
+        const records = await this.records(id);
+        return { meta, messages: records.map((record) => record.message) };
+    }
+    async list(limit = 20, opts = {}) {
+        await this.prepare();
+        const prefix = opts.projectId ? ["session", opts.projectId] : ["session"];
+        const metas = [];
+        for (const key of await this.kv.list(prefix)) {
+            const meta = await this.kv.read(key);
+            if (meta) {
+                this.located.set(meta.id, key[1]);
+                metas.push(meta);
+            }
+        }
+        const recent = metas.sort((a, b) => b.updatedAt - a.updatedAt).slice(0, limit);
+        // Sessions recorded before titles existed have none, and a list of
+        // timestamps and hex tells nobody which session they want. Backfill from
+        // the transcript — only for what is actually being shown.
+        await Promise.all(recent.map((meta) => this.backfillTitle(meta)));
+        return recent;
+    }
+    async backfillTitle(meta) {
+        if (meta.title)
+            return;
+        for (const record of await this.records(meta.id)) {
+            if (record.message.role !== "user")
+                continue;
+            const title = titleFromMessage(record.message);
+            if (!title)
+                continue;
+            meta.title = title;
+            // Written back so the next listing is a plain metadata read again.
+            await this.writeMeta(meta).catch(() => { });
+            return;
+        }
+    }
+    /** Most recently updated session for a directory, for `--continue`. */
+    async mostRecent(cwd) {
+        const all = await this.list(50);
+        return cwd ? all.find((meta) => meta.cwd === cwd) : all[0];
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/agent/store.js.map

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

package/dist/agent/subagent.d.ts

@@ -0,0 +1,44 @@
+import type { ToolFilter } from "../tools/registry.ts";
+/**
+ * A named subagent configuration. Subagents exist to keep expensive
+ * exploration out of the main context window: the parent sees only the final
+ * message, not the dozens of tool results that produced it.
+ */
+export interface SubagentDefinition {
+    name: string;
+    /** Shown to the model in the `task` tool description — this is what drives selection. */
+    description: string;
+    /** Replaces the base system prompt for this subagent. */
+    systemPrompt: string;
+    /** Model alias; falls back to the parent session's model. */
+    model?: string;
+    /** Restricts which tools the subagent may call. */
+    tools?: ToolFilter;
+    /** Hard cap on turns, to bound a runaway subagent. */
+    maxTurns?: number;
+}
+export declare const EXPLORE_AGENT: SubagentDefinition;
+export declare const GENERAL_AGENT: SubagentDefinition;
+export declare const BUILTIN_SUBAGENTS: SubagentDefinition[];
+export declare class SubagentRegistry {
+    private readonly agents;
+    constructor(definitions?: SubagentDefinition[]);
+    register(def: SubagentDefinition): this;
+    get(name: string): SubagentDefinition | undefined;
+    list(): SubagentDefinition[];
+    summaries(): Array<{
+        name: string;
+        description: string;
+    }>;
+}
+/**
+ * Load subagents from `agents/**‍/*.md`, the convention opencode uses:
+ * YAML frontmatter is the configuration, the body is the system prompt.
+ *
+ * A markdown file is a better home for a subagent than a JSON config field —
+ * the prompt is the bulk of the definition, and prompts do not survive being
+ * escaped into JSON strings with any readability.
+ */
+export declare function loadMarkdownSubagents(cwd: string, extraDirs?: string[]): Promise<SubagentDefinition[]>;
+/** Parse one agent markdown file. Returns undefined if it cannot be selected. */
+export declare function parseAgentMarkdown(raw: string, fallbackName: string, prefix?: string): SubagentDefinition | undefined;