@polpo-ai/file-stores 0.11.0

package/dist/file-memory-store.js

@@ -0,0 +1,85 @@
+import { existsSync, readFileSync, writeFileSync, appendFileSync, mkdirSync, renameSync, readdirSync } from "node:fs";
+import { join, dirname, basename } from "node:path";
+/**
+ * File-backed MemoryStore.
+ * Reads/writes `.polpo/memory.md` for shared memory (no scope).
+ * Agent-scoped memory lives in `.polpo/memory/<agent-name>.md`.
+ */
+export class FileMemoryStore {
+    sharedPath;
+    scopeDir;
+    constructor(polpoDir) {
+        this.sharedPath = join(polpoDir, "memory.md");
+        this.scopeDir = join(polpoDir, "memory");
+    }
+    /** Resolve the file path for a given scope. Undefined = shared memory. */
+    resolvePath(scope) {
+        if (!scope)
+            return this.sharedPath;
+        // scope is "agent:<name>" — extract the name part for the filename
+        const name = scope.startsWith("agent:") ? scope.slice(6) : scope;
+        return join(this.scopeDir, `${name}.md`);
+    }
+    async exists(scope) {
+        return existsSync(this.resolvePath(scope));
+    }
+    async get(scope) {
+        const filePath = this.resolvePath(scope);
+        if (!existsSync(filePath))
+            return "";
+        try {
+            return readFileSync(filePath, "utf-8");
+        }
+        catch { /* unreadable memory file */
+            return "";
+        }
+    }
+    async save(content, scope) {
+        const filePath = this.resolvePath(scope);
+        const dir = dirname(filePath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const tmpPath = filePath + ".tmp";
+        writeFileSync(tmpPath, content, "utf-8");
+        renameSync(tmpPath, filePath);
+    }
+    async append(line, scope) {
+        const filePath = this.resolvePath(scope);
+        const dir = dirname(filePath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const ts = new Date().toISOString().slice(0, 10);
+        appendFileSync(filePath, `\n- ${ts}: ${line}\n`, "utf-8");
+    }
+    async update(oldText, newText, scope) {
+        const filePath = this.resolvePath(scope);
+        if (!existsSync(filePath))
+            return "Memory file does not exist. Use save_memory to create it first.";
+        const content = await this.get(scope);
+        if (!content.includes(oldText)) {
+            return "oldString not found in memory. Use get_memory to see the current content.";
+        }
+        const firstIdx = content.indexOf(oldText);
+        const secondIdx = content.indexOf(oldText, firstIdx + 1);
+        if (secondIdx !== -1) {
+            return "oldString found multiple times in memory. Provide more surrounding context to make the match unique.";
+        }
+        const updated = content.replace(oldText, newText);
+        await this.save(updated, scope);
+        return true;
+    }
+    /** List all agent scopes that have memory files. Returns agent names (without "agent:" prefix). */
+    async listScopes() {
+        if (!existsSync(this.scopeDir))
+            return [];
+        try {
+            return readdirSync(this.scopeDir)
+                .filter(f => f.endsWith(".md"))
+                .map(f => basename(f, ".md"));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=file-memory-store.js.map

package/dist/file-memory-store.js.map

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

package/dist/file-playbook-store.d.ts

@@ -0,0 +1,25 @@
+/**
+ * FilePlaybookStore — file-system backed PlaybookStore.
+ *
+ * Wraps the existing discovery/persistence logic from src/core/playbook.ts
+ * behind the async PlaybookStore interface.
+ *
+ * Discovery paths (in priority order, first occurrence wins by name):
+ *   1. <polpoDir>/playbooks/          — project-level
+ *   2. <cwd>/.polpo/playbooks/        — alias when polpoDir != .polpo
+ *   3. ~/.polpo/playbooks/            — user-level
+ *
+ * Also scans legacy templates/ directories for backward compatibility.
+ */
+import type { PlaybookStore } from "@polpo-ai/core/playbook-store";
+import type { PlaybookDefinition, PlaybookInfo } from "@polpo-ai/core/playbook-store";
+export declare class FilePlaybookStore implements PlaybookStore {
+    private readonly cwd;
+    private readonly polpoDir;
+    constructor(cwd: string, polpoDir: string);
+    list(): Promise<PlaybookInfo[]>;
+    get(name: string): Promise<PlaybookDefinition | null>;
+    save(definition: PlaybookDefinition): Promise<string>;
+    delete(name: string): Promise<boolean>;
+}
+//# sourceMappingURL=file-playbook-store.d.ts.map

package/dist/file-playbook-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-playbook-store.d.ts","sourceRoot":"","sources":["../src/file-playbook-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAQtF,qBAAa,iBAAkB,YAAW,aAAa;IAEnD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM;IAG7B,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAIrD,IAAI,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG7C"}

package/dist/file-playbook-store.js

@@ -0,0 +1,35 @@
+/**
+ * FilePlaybookStore — file-system backed PlaybookStore.
+ *
+ * Wraps the existing discovery/persistence logic from src/core/playbook.ts
+ * behind the async PlaybookStore interface.
+ *
+ * Discovery paths (in priority order, first occurrence wins by name):
+ *   1. <polpoDir>/playbooks/          — project-level
+ *   2. <cwd>/.polpo/playbooks/        — alias when polpoDir != .polpo
+ *   3. ~/.polpo/playbooks/            — user-level
+ *
+ * Also scans legacy templates/ directories for backward compatibility.
+ */
+import { discoverPlaybooks, loadPlaybook, savePlaybook, deletePlaybook, } from "./playbook-files.js";
+export class FilePlaybookStore {
+    cwd;
+    polpoDir;
+    constructor(cwd, polpoDir) {
+        this.cwd = cwd;
+        this.polpoDir = polpoDir;
+    }
+    async list() {
+        return discoverPlaybooks(this.cwd, this.polpoDir);
+    }
+    async get(name) {
+        return loadPlaybook(this.cwd, this.polpoDir, name);
+    }
+    async save(definition) {
+        return savePlaybook(this.polpoDir, definition);
+    }
+    async delete(name) {
+        return deletePlaybook(this.cwd, this.polpoDir, name);
+    }
+}
+//# sourceMappingURL=file-playbook-store.js.map

package/dist/file-playbook-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-playbook-store.js","sourceRoot":"","sources":["../src/file-playbook-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,MAAM,OAAO,iBAAiB;IAET;IACA;IAFnB,YACmB,GAAW,EACX,QAAgB;QADhB,QAAG,GAAH,GAAG,CAAQ;QACX,aAAQ,GAAR,QAAQ,CAAQ;IAChC,CAAC;IAEJ,KAAK,CAAC,IAAI;QACR,OAAO,iBAAiB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAA8B;QACvC,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/file-run-store.d.ts

@@ -0,0 +1,29 @@
+import type { AgentActivity, TaskResult, TaskOutcome } from "@polpo-ai/core/types";
+import type { RunStore, RunRecord, RunStatus } from "@polpo-ai/core/run-store";
+/**
+ * Filesystem-based RunStore.
+ * Each run is a single JSON file in .polpo/runs/<runId>.json.
+ *
+ * Concurrency model: the runner subprocess owns its run file (writes),
+ * the orchestrator only reads. No cross-process write conflicts.
+ */
+export declare class FileRunStore implements RunStore {
+    private runsDir;
+    constructor(polpoDir: string);
+    private runPath;
+    private readRun;
+    private writeRun;
+    private listRunIds;
+    private allRuns;
+    upsertRun(run: RunRecord): Promise<void>;
+    updateActivity(runId: string, activity: AgentActivity): Promise<void>;
+    updateOutcomes(runId: string, outcomes: TaskOutcome[]): Promise<void>;
+    completeRun(runId: string, status: RunStatus, result: TaskResult): Promise<void>;
+    getRun(runId: string): Promise<RunRecord | undefined>;
+    getRunByTaskId(taskId: string): Promise<RunRecord | undefined>;
+    getActiveRuns(): Promise<RunRecord[]>;
+    getTerminalRuns(): Promise<RunRecord[]>;
+    deleteRun(runId: string): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=file-run-store.d.ts.map

package/dist/file-run-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-run-store.d.ts","sourceRoot":"","sources":["../src/file-run-store.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAiB/E;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,EAAE,MAAM;IAK5B,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,OAAO;IAST,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IASrE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAchF,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAIrD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAS9D,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIrC,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAMvC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/file-run-store.js

@@ -0,0 +1,131 @@
+import { join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync, readdirSync, unlinkSync, } from "node:fs";
+function safeJsonParse(raw, fallback) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return fallback;
+    }
+}
+/** Atomic write: write to tmp file then rename. */
+function atomicWrite(filePath, data) {
+    const tmp = filePath + ".tmp";
+    writeFileSync(tmp, JSON.stringify(data, null, 2), "utf-8");
+    renameSync(tmp, filePath);
+}
+/**
+ * Filesystem-based RunStore.
+ * Each run is a single JSON file in .polpo/runs/<runId>.json.
+ *
+ * Concurrency model: the runner subprocess owns its run file (writes),
+ * the orchestrator only reads. No cross-process write conflicts.
+ */
+export class FileRunStore {
+    runsDir;
+    constructor(polpoDir) {
+        this.runsDir = join(polpoDir, "runs");
+        if (!existsSync(this.runsDir))
+            mkdirSync(this.runsDir, { recursive: true });
+    }
+    runPath(id) {
+        return join(this.runsDir, `${id}.json`);
+    }
+    readRun(id) {
+        const path = this.runPath(id);
+        if (!existsSync(path))
+            return undefined;
+        try {
+            return safeJsonParse(readFileSync(path, "utf-8"), undefined);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    writeRun(run) {
+        atomicWrite(this.runPath(run.id), run);
+    }
+    listRunIds() {
+        if (!existsSync(this.runsDir))
+            return [];
+        return readdirSync(this.runsDir)
+            .filter(f => f.endsWith(".json") && !f.endsWith(".tmp"))
+            .map(f => f.slice(0, -5));
+    }
+    allRuns() {
+        const records = [];
+        for (const id of this.listRunIds()) {
+            const run = this.readRun(id);
+            if (run)
+                records.push(run);
+        }
+        return records;
+    }
+    async upsertRun(run) {
+        this.writeRun(run);
+    }
+    async updateActivity(runId, activity) {
+        const run = this.readRun(runId);
+        if (!run)
+            return;
+        run.activity = activity;
+        if (activity.sessionId)
+            run.sessionId = activity.sessionId;
+        run.updatedAt = new Date().toISOString();
+        this.writeRun(run);
+    }
+    async updateOutcomes(runId, outcomes) {
+        const run = this.readRun(runId);
+        if (!run)
+            return;
+        run.outcomes = outcomes;
+        run.updatedAt = new Date().toISOString();
+        this.writeRun(run);
+    }
+    async completeRun(runId, status, result) {
+        const run = this.readRun(runId);
+        if (!run)
+            return;
+        // Don't let a later write overwrite a run already in terminal state.
+        // This prevents the runner process from clobbering the orchestrator's
+        // "killed" status with a stale "completed" result (race condition).
+        const terminal = ["completed", "failed", "killed"];
+        if (terminal.includes(run.status))
+            return;
+        run.status = status;
+        run.result = result;
+        run.updatedAt = new Date().toISOString();
+        this.writeRun(run);
+    }
+    async getRun(runId) {
+        return this.readRun(runId);
+    }
+    async getRunByTaskId(taskId) {
+        // Scan all runs — small directory, fast enough
+        for (const id of this.listRunIds()) {
+            const run = this.readRun(id);
+            if (run && run.taskId === taskId)
+                return run;
+        }
+        return undefined;
+    }
+    async getActiveRuns() {
+        return this.allRuns().filter(r => r.status === "running");
+    }
+    async getTerminalRuns() {
+        return this.allRuns().filter(r => r.status === "completed" || r.status === "failed" || r.status === "killed");
+    }
+    async deleteRun(runId) {
+        const path = this.runPath(runId);
+        try {
+            unlinkSync(path);
+        }
+        catch {
+            /* already gone */
+        }
+    }
+    async close() {
+        // No-op for filesystem store
+    }
+}
+//# sourceMappingURL=file-run-store.js.map

package/dist/file-run-store.js.map

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

package/dist/file-session-store.d.ts

@@ -0,0 +1,28 @@
+import type { SessionStore, Session, Message, MessageRole, ToolCallInfo, SessionContentPart, SessionCreateOptions, SessionListFilter } from "@polpo-ai/core/session-store";
+/**
+ * File-backed SessionStore.
+ * Writes JSONL files to `.polpo/sessions/`, one per session.
+ *
+ * File naming: `{sessionId}.jsonl`
+ * First line of each file: `{"_session":true,"id":"...","title":"...","createdAt":"..."}`
+ */
+export declare class FileSessionStore implements SessionStore {
+    private readonly sessionsDir;
+    constructor(polpoDir: string);
+    create(arg1?: string | SessionCreateOptions, arg2?: string): Promise<string>;
+    addMessage(sessionId: string, role: MessageRole, content: string | SessionContentPart[]): Promise<Message>;
+    updateMessage(sessionId: string, messageId: string, content: string | SessionContentPart[], toolCalls?: ToolCallInfo[]): Promise<boolean>;
+    getMessages(sessionId: string): Promise<Message[]>;
+    getRecentMessages(sessionId: string, limit: number): Promise<Message[]>;
+    /** Build a Session out of a session file's first line + mtime. */
+    private headerToSession;
+    listSessions(filter?: SessionListFilter): Promise<Session[]>;
+    getSession(sessionId: string): Promise<Session | undefined>;
+    getLatestSession(agent?: string | null): Promise<Session | undefined>;
+    renameSession(sessionId: string, title: string): Promise<boolean>;
+    deleteSession(sessionId: string): Promise<boolean>;
+    prune(keepSessions: number): Promise<number>;
+    close(): Promise<void>;
+    private sessionFile;
+}
+//# sourceMappingURL=file-session-store.d.ts.map

package/dist/file-session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-session-store.d.ts","sourceRoot":"","sources":["../src/file-session-store.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,OAAO,EACP,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,8BAA8B,CAAC;AAGtC;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,QAAQ,EAAE,MAAM;IAItB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,oBAAoB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB5E,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAe1G,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE,EAAE,SAAS,CAAC,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BzI,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAkBlD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAK7E,kEAAkE;IAClE,OAAO,CAAC,eAAe;IAcjB,YAAY,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAuC5D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAe3D,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAcrE,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBjE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWlD,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,WAAW;CAGpB"}

package/dist/file-session-store.js

@@ -0,0 +1,245 @@
+import { existsSync, mkdirSync, appendFileSync, readFileSync, writeFileSync, readdirSync, unlinkSync, statSync, } from "node:fs";
+import { join } from "node:path";
+import { nanoid } from "nanoid";
+import { normalizeSessionCreateArgs } from "@polpo-ai/core/session-store";
+/**
+ * File-backed SessionStore.
+ * Writes JSONL files to `.polpo/sessions/`, one per session.
+ *
+ * File naming: `{sessionId}.jsonl`
+ * First line of each file: `{"_session":true,"id":"...","title":"...","createdAt":"..."}`
+ */
+export class FileSessionStore {
+    sessionsDir;
+    constructor(polpoDir) {
+        this.sessionsDir = join(polpoDir, "sessions");
+    }
+    async create(arg1, arg2) {
+        const opts = normalizeSessionCreateArgs(arg1, arg2);
+        if (!existsSync(this.sessionsDir)) {
+            mkdirSync(this.sessionsDir, { recursive: true });
+        }
+        const sessionId = nanoid(10);
+        const header = {
+            _session: true,
+            id: sessionId,
+            title: opts.title,
+            createdAt: new Date().toISOString(),
+        };
+        if (opts.agent)
+            header.agent = opts.agent;
+        if (opts.user)
+            header.user = opts.user;
+        if (opts.metadata)
+            header.metadata = opts.metadata;
+        try {
+            appendFileSync(this.sessionFile(sessionId), JSON.stringify(header) + "\n", "utf-8");
+        }
+        catch { /* best-effort: non-critical */
+        }
+        return sessionId;
+    }
+    async addMessage(sessionId, role, content) {
+        const message = {
+            id: nanoid(10),
+            role,
+            content,
+            ts: new Date().toISOString(),
+        };
+        try {
+            const line = JSON.stringify(message);
+            appendFileSync(this.sessionFile(sessionId), line + "\n", "utf-8");
+        }
+        catch { /* best-effort: non-critical */
+        }
+        return message;
+    }
+    async updateMessage(sessionId, messageId, content, toolCalls) {
+        const file = this.sessionFile(sessionId);
+        if (!existsSync(file))
+            return false;
+        try {
+            const raw = readFileSync(file, "utf-8");
+            const lines = raw.split("\n").filter(Boolean);
+            let found = false;
+            const updated = lines.map((line) => {
+                const obj = JSON.parse(line);
+                if (!obj._session && obj.id === messageId) {
+                    found = true;
+                    const patched = { ...obj, content };
+                    if (toolCalls && toolCalls.length > 0) {
+                        patched.toolCalls = toolCalls;
+                    }
+                    return JSON.stringify(patched);
+                }
+                return line;
+            });
+            if (!found)
+                return false;
+            writeFileSync(file, updated.join("\n") + "\n", "utf-8");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getMessages(sessionId) {
+        const file = this.sessionFile(sessionId);
+        if (!existsSync(file))
+            return [];
+        try {
+            const lines = readFileSync(file, "utf-8").split("\n").filter(Boolean);
+            const messages = [];
+            for (const line of lines) {
+                const obj = JSON.parse(line);
+                // Skip session header
+                if (obj._session)
+                    continue;
+                messages.push(obj);
+            }
+            return messages;
+        }
+        catch { /* unreadable session file */
+            return [];
+        }
+    }
+    async getRecentMessages(sessionId, limit) {
+        const messages = await this.getMessages(sessionId);
+        return messages.slice(-limit);
+    }
+    /** Build a Session out of a session file's first line + mtime. */
+    headerToSession(header, filePath, fallbackId) {
+        const updatedAt = new Date(statSync(filePath).mtimeMs).toISOString();
+        return {
+            id: header.id ?? fallbackId,
+            title: header.title,
+            createdAt: header.createdAt ?? updatedAt,
+            updatedAt,
+            messageCount: 0,
+            ...(header.agent ? { agent: header.agent } : {}),
+            ...(header.user ? { user: header.user } : {}),
+            ...(header.metadata ? { metadata: header.metadata } : {}),
+        };
+    }
+    async listSessions(filter) {
+        if (!existsSync(this.sessionsDir))
+            return [];
+        const files = readdirSync(this.sessionsDir)
+            .filter(f => f.endsWith(".jsonl"));
+        // Sort by modification time (most recent first)
+        const withMtime = files.map(f => ({
+            file: f,
+            mtime: statSync(join(this.sessionsDir, f)).mtimeMs,
+        }));
+        withMtime.sort((a, b) => b.mtime - a.mtime);
+        const sessions = [];
+        for (const { file } of withMtime) {
+            const filePath = join(this.sessionsDir, file);
+            try {
+                const content = readFileSync(filePath, "utf-8");
+                const lines = content.split("\n").filter(Boolean);
+                const header = JSON.parse(lines[0]);
+                const session = this.headerToSession(header, filePath, file.replace(".jsonl", ""));
+                session.messageCount = lines.length - 1;
+                // In-memory filter — file store has no index, so we scan + filter.
+                // Acceptable here because file store is for dev/CLI, not high-traffic.
+                if (filter?.user && session.user !== filter.user)
+                    continue;
+                if (filter?.metadata) {
+                    const sessMeta = session.metadata ?? {};
+                    const allMatch = Object.entries(filter.metadata).every(([k, v]) => sessMeta[k] === v);
+                    if (!allMatch)
+                        continue;
+                }
+                sessions.push(session);
+            }
+            catch { /* skip corrupt file */
+            }
+        }
+        return sessions;
+    }
+    async getSession(sessionId) {
+        const file = this.sessionFile(sessionId);
+        if (!existsSync(file))
+            return undefined;
+        try {
+            const content = readFileSync(file, "utf-8");
+            const lines = content.split("\n").filter(Boolean);
+            const header = JSON.parse(lines[0]);
+            const session = this.headerToSession(header, file, sessionId);
+            session.messageCount = lines.length - 1;
+            return session;
+        }
+        catch { /* unreadable session file */
+            return undefined;
+        }
+    }
+    async getLatestSession(agent) {
+        const sessions = await this.listSessions();
+        if (agent === undefined) {
+            // No filter — return the most recent session regardless of agent
+            return sessions[0];
+        }
+        if (agent === null) {
+            // Orchestrator sessions only (no agent)
+            return sessions.find(s => !s.agent);
+        }
+        // Agent-specific sessions
+        return sessions.find(s => s.agent === agent);
+    }
+    async renameSession(sessionId, title) {
+        const file = this.sessionFile(sessionId);
+        if (!existsSync(file))
+            return false;
+        try {
+            const raw = readFileSync(file, "utf-8");
+            const lines = raw.split("\n").filter(Boolean);
+            if (lines.length === 0)
+                return false;
+            const header = JSON.parse(lines[0]);
+            if (!header._session)
+                return false;
+            header.title = title;
+            lines[0] = JSON.stringify(header);
+            writeFileSync(file, lines.join("\n") + "\n", "utf-8");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async deleteSession(sessionId) {
+        const file = this.sessionFile(sessionId);
+        if (!existsSync(file))
+            return false;
+        try {
+            unlinkSync(file);
+            return true;
+        }
+        catch { /* file already removed */
+            return false;
+        }
+    }
+    async prune(keepSessions) {
+        const sessions = await this.listSessions();
+        if (sessions.length <= keepSessions)
+            return 0;
+        const toRemove = sessions.slice(keepSessions);
+        let removed = 0;
+        for (const s of toRemove) {
+            try {
+                unlinkSync(this.sessionFile(s.id));
+                removed++;
+            }
+            catch { /* file already removed */ }
+        }
+        return removed;
+    }
+    async close() {
+        // No resources to release for file-based store
+    }
+    sessionFile(sessionId) {
+        return join(this.sessionsDir, `${sessionId}.jsonl`);
+    }
+}
+//# sourceMappingURL=file-session-store.js.map

package/dist/file-session-store.js.map

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

package/dist/file-skill-store.d.ts

@@ -0,0 +1,26 @@
+import type { SkillStore, SkillRecord } from "@polpo-ai/core";
+/**
+ * File-backed SkillStore.
+ *
+ * Persists the full catalog to `${polpoDir}/skills-index.json` as a
+ * JSON object keyed by skill name. Writes are atomic (tmp + rename).
+ *
+ * Legacy compatibility: the old `skills-index.json` format contained
+ * only `{ tags?, category? }` per skill. This store reads those files
+ * transparently (treating them as partial records) and the caller —
+ * typically the upsert triggered by skills/add — fills in the full
+ * record on next write.
+ */
+export declare class FileSkillStore implements SkillStore {
+    private readonly filePath;
+    constructor(polpoDir: string);
+    list(): Promise<SkillRecord[]>;
+    get(name: string): Promise<SkillRecord | undefined>;
+    upsert(record: SkillRecord): Promise<void>;
+    remove(name: string): Promise<boolean>;
+    /** Read the JSON file, normalising legacy shapes. */
+    private readAll;
+    /** Write the full catalog atomically (tmp + rename). */
+    private writeAll;
+}
+//# sourceMappingURL=file-skill-store.d.ts.map