@polpo-ai/file-stores 0.11.0

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2026-present Lumea Labs
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

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

@@ -0,0 +1,24 @@
+import type { AgentConfig } from "@polpo-ai/core/types";
+import type { AgentStore } from "@polpo-ai/core/agent-store";
+/**
+ * File-based AgentStore.
+ * Persists agents as JSON in `.polpo/agents.json`.
+ */
+export declare class FileAgentStore implements AgentStore {
+    private readonly filePath;
+    constructor(polpoDir: string);
+    private readAll;
+    private writeAll;
+    getAgents(teamName?: string): Promise<AgentConfig[]>;
+    getAgent(name: string): Promise<AgentConfig | undefined>;
+    getAgentTeam(name: string): Promise<string | undefined>;
+    createAgent(agent: AgentConfig, teamName: string): Promise<AgentConfig>;
+    updateAgent(name: string, updates: Partial<Omit<AgentConfig, "name">>): Promise<AgentConfig>;
+    moveAgent(name: string, newTeamName: string): Promise<AgentConfig>;
+    deleteAgent(name: string): Promise<boolean>;
+    cleanupVolatileAgents(missionGroup: string): Promise<number>;
+    seed(agents: Array<AgentConfig & {
+        teamName: string;
+    }>): Promise<void>;
+}
+//# sourceMappingURL=file-agent-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-agent-store.d.ts","sourceRoot":"","sources":["../src/file-agent-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAQ7D;;;GAGG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,EAAE,MAAM;IAM5B,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,QAAQ;IAQV,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAMpD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAIxD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIvD,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAWvE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAS5F,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IASlE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3C,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS5D,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAY7E"}

package/dist/file-agent-store.js

@@ -0,0 +1,102 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+/**
+ * File-based AgentStore.
+ * Persists agents as JSON in `.polpo/agents.json`.
+ */
+export class FileAgentStore {
+    filePath;
+    constructor(polpoDir) {
+        this.filePath = join(polpoDir, "agents.json");
+    }
+    // ── helpers ──────────────────────────────────────────────────────────
+    readAll() {
+        if (!existsSync(this.filePath))
+            return [];
+        try {
+            return JSON.parse(readFileSync(this.filePath, "utf-8"));
+        }
+        catch {
+            return [];
+        }
+    }
+    writeAll(entries) {
+        const dir = dirname(this.filePath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(this.filePath, JSON.stringify(entries, null, 2), "utf-8");
+    }
+    // ── AgentStore implementation ────────────────────────────────────────
+    async getAgents(teamName) {
+        const entries = this.readAll();
+        const filtered = teamName ? entries.filter(e => e.teamName === teamName) : entries;
+        return filtered.map(e => e.agent);
+    }
+    async getAgent(name) {
+        return this.readAll().find(e => e.agent.name === name)?.agent;
+    }
+    async getAgentTeam(name) {
+        return this.readAll().find(e => e.agent.name === name)?.teamName;
+    }
+    async createAgent(agent, teamName) {
+        const entries = this.readAll();
+        if (entries.some(e => e.agent.name === agent.name)) {
+            throw new Error(`Agent "${agent.name}" already exists`);
+        }
+        if (!agent.createdAt)
+            agent.createdAt = new Date().toISOString();
+        entries.push({ agent, teamName });
+        this.writeAll(entries);
+        return agent;
+    }
+    async updateAgent(name, updates) {
+        const entries = this.readAll();
+        const entry = entries.find(e => e.agent.name === name);
+        if (!entry)
+            throw new Error(`Agent "${name}" not found`);
+        Object.assign(entry.agent, updates);
+        this.writeAll(entries);
+        return entry.agent;
+    }
+    async moveAgent(name, newTeamName) {
+        const entries = this.readAll();
+        const entry = entries.find(e => e.agent.name === name);
+        if (!entry)
+            throw new Error(`Agent "${name}" not found`);
+        entry.teamName = newTeamName;
+        this.writeAll(entries);
+        return entry.agent;
+    }
+    async deleteAgent(name) {
+        const entries = this.readAll();
+        const idx = entries.findIndex(e => e.agent.name === name);
+        if (idx < 0)
+            return false;
+        entries.splice(idx, 1);
+        this.writeAll(entries);
+        return true;
+    }
+    async cleanupVolatileAgents(missionGroup) {
+        const entries = this.readAll();
+        const before = entries.length;
+        const filtered = entries.filter(e => !(e.agent.volatile && e.agent.missionGroup === missionGroup));
+        if (filtered.length === before)
+            return 0;
+        this.writeAll(filtered);
+        return before - filtered.length;
+    }
+    async seed(agents) {
+        const existing = this.readAll();
+        const existingNames = new Set(existing.map(e => e.agent.name));
+        let changed = false;
+        for (const { teamName, ...agent } of agents) {
+            if (!existingNames.has(agent.name)) {
+                existing.push({ agent: agent, teamName });
+                changed = true;
+            }
+        }
+        if (changed)
+            this.writeAll(existing);
+    }
+}
+//# sourceMappingURL=file-agent-store.js.map

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

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

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

@@ -0,0 +1,20 @@
+import type { ApprovalStore } from "@polpo-ai/core/approval-store";
+import type { ApprovalRequest, ApprovalStatus } from "@polpo-ai/core/types";
+/**
+ * Filesystem-based approval store.
+ * Persists approval requests as JSON in .polpo/approvals.json.
+ */
+export declare class FileApprovalStore implements ApprovalStore {
+    private filePath;
+    private requests;
+    constructor(polpoDir: string);
+    upsert(request: ApprovalRequest): Promise<void>;
+    get(id: string): Promise<ApprovalRequest | undefined>;
+    list(status?: ApprovalStatus): Promise<ApprovalRequest[]>;
+    listByTask(taskId: string): Promise<ApprovalRequest[]>;
+    delete(id: string): Promise<boolean>;
+    close(): Promise<void>;
+    private load;
+    private save;
+}
+//# sourceMappingURL=file-approval-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-approval-store.d.ts","sourceRoot":"","sources":["../src/file-approval-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA+B;gBAEnC,QAAQ,EAAE,MAAM;IAStB,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAIrD,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAMzD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAItD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,IAAI;CAKb"}

package/dist/file-approval-store.js

@@ -0,0 +1,62 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Filesystem-based approval store.
+ * Persists approval requests as JSON in .polpo/approvals.json.
+ */
+export class FileApprovalStore {
+    filePath;
+    requests;
+    constructor(polpoDir) {
+        if (!existsSync(polpoDir)) {
+            mkdirSync(polpoDir, { recursive: true });
+        }
+        this.filePath = join(polpoDir, "approvals.json");
+        this.requests = new Map();
+        this.load();
+    }
+    async upsert(request) {
+        this.requests.set(request.id, request);
+        this.save();
+    }
+    async get(id) {
+        return this.requests.get(id);
+    }
+    async list(status) {
+        const all = [...this.requests.values()];
+        if (status)
+            return all.filter(r => r.status === status);
+        return all;
+    }
+    async listByTask(taskId) {
+        return [...this.requests.values()].filter(r => r.taskId === taskId);
+    }
+    async delete(id) {
+        const had = this.requests.delete(id);
+        if (had)
+            this.save();
+        return had;
+    }
+    async close() {
+        this.save();
+    }
+    load() {
+        try {
+            if (existsSync(this.filePath)) {
+                const raw = readFileSync(this.filePath, "utf-8");
+                const arr = JSON.parse(raw);
+                for (const r of arr) {
+                    this.requests.set(r.id, r);
+                }
+            }
+        }
+        catch { /* corrupted file — start fresh */ }
+    }
+    save() {
+        try {
+            writeFileSync(this.filePath, JSON.stringify([...this.requests.values()], null, 2));
+        }
+        catch { /* best-effort */ }
+    }
+}
+//# sourceMappingURL=file-approval-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-approval-store.js","sourceRoot":"","sources":["../src/file-approval-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACpB,QAAQ,CAAS;IACjB,QAAQ,CAA+B;IAE/C,YAAY,QAAgB;QAC1B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAwB;QACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAuB;QAChC,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,IAAI,MAAM;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QACxD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,GAAG;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEO,IAAI;QACV,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACjD,MAAM,GAAG,GAAsB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC/C,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;oBACpB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,kCAAkC,CAAC,CAAC;IAChD,CAAC;IAEO,IAAI;QACV,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrF,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/B,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+import type { CheckpointStore, CheckpointState } from "@polpo-ai/core/checkpoint-store";
+export type { CheckpointState };
+/**
+ * Filesystem-based checkpoint store.
+ * Persists checkpoint runtime state as JSON in `.polpo/checkpoints.json`
+ * so that checkpoint blocking survives server restarts.
+ */
+export declare class FileCheckpointStore implements CheckpointStore {
+    private filePath;
+    constructor(polpoDir: string);
+    /** Load persisted state (returns empty collections if file missing/corrupt). */
+    load(): Promise<CheckpointState>;
+    /** Persist current state to disk. */
+    save(state: CheckpointState): Promise<void>;
+    /** Remove all entries for a given group and persist. */
+    removeGroup(state: CheckpointState, group: string): Promise<CheckpointState>;
+}
+//# sourceMappingURL=file-checkpoint-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-checkpoint-store.d.ts","sourceRoot":"","sources":["../src/file-checkpoint-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAExF,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAO5B,gFAAgF;IAC1E,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAetC,qCAAqC;IAC/B,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,wDAAwD;IAClD,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAUnF"}

package/dist/file-checkpoint-store.js

@@ -0,0 +1,52 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Filesystem-based checkpoint store.
+ * Persists checkpoint runtime state as JSON in `.polpo/checkpoints.json`
+ * so that checkpoint blocking survives server restarts.
+ */
+export class FileCheckpointStore {
+    filePath;
+    constructor(polpoDir) {
+        if (!existsSync(polpoDir)) {
+            mkdirSync(polpoDir, { recursive: true });
+        }
+        this.filePath = join(polpoDir, "checkpoints.json");
+    }
+    /** Load persisted state (returns empty collections if file missing/corrupt). */
+    async load() {
+        try {
+            if (existsSync(this.filePath)) {
+                const raw = readFileSync(this.filePath, "utf-8");
+                const data = JSON.parse(raw);
+                return {
+                    definitions: data.definitions ?? {},
+                    active: data.active ?? {},
+                    resumed: data.resumed ?? [],
+                };
+            }
+        }
+        catch { /* corrupted file — start fresh */ }
+        return { definitions: {}, active: {}, resumed: [] };
+    }
+    /** Persist current state to disk. */
+    async save(state) {
+        try {
+            writeFileSync(this.filePath, JSON.stringify(state, null, 2));
+        }
+        catch { /* best-effort */ }
+    }
+    /** Remove all entries for a given group and persist. */
+    async removeGroup(state, group) {
+        delete state.definitions[group];
+        const prefix = `${group}:`;
+        for (const key of Object.keys(state.active)) {
+            if (key.startsWith(prefix))
+                delete state.active[key];
+        }
+        state.resumed = state.resumed.filter(k => !k.startsWith(prefix));
+        await this.save(state);
+        return state;
+    }
+}
+//# sourceMappingURL=file-checkpoint-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-checkpoint-store.js","sourceRoot":"","sources":["../src/file-checkpoint-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IACtB,QAAQ,CAAS;IAEzB,YAAY,QAAgB;QAC1B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IACrD,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;gBAChD,OAAO;oBACL,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;oBACnC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;oBACzB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;iBAC5B,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,kCAAkC,CAAC,CAAC;QAC9C,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,IAAI,CAAC,KAAsB;QAC/B,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/B,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,WAAW,CAAC,KAAsB,EAAE,KAAa;QACrD,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACjE,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+import type { DelayStore, DelayState } from "@polpo-ai/core/delay-store";
+export type { DelayState };
+/**
+ * Filesystem-based delay store.
+ * Persists delay runtime state as JSON in `.polpo/delays.json`
+ * so that delay blocking survives server restarts.
+ */
+export declare class FileDelayStore implements DelayStore {
+    private filePath;
+    constructor(polpoDir: string);
+    /** Load persisted state (returns empty collections if file missing/corrupt). */
+    load(): Promise<DelayState>;
+    /** Persist current state to disk. */
+    save(state: DelayState): Promise<void>;
+    /** Remove all entries for a given group and persist. */
+    removeGroup(state: DelayState, group: string): Promise<DelayState>;
+}
+//# sourceMappingURL=file-delay-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-delay-store.d.ts","sourceRoot":"","sources":["../src/file-delay-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAEzE,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;GAIG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAO5B,gFAAgF;IAC1E,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAejC,qCAAqC;IAC/B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,wDAAwD;IAClD,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAUzE"}

package/dist/file-delay-store.js

@@ -0,0 +1,52 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Filesystem-based delay store.
+ * Persists delay runtime state as JSON in `.polpo/delays.json`
+ * so that delay blocking survives server restarts.
+ */
+export class FileDelayStore {
+    filePath;
+    constructor(polpoDir) {
+        if (!existsSync(polpoDir)) {
+            mkdirSync(polpoDir, { recursive: true });
+        }
+        this.filePath = join(polpoDir, "delays.json");
+    }
+    /** Load persisted state (returns empty collections if file missing/corrupt). */
+    async load() {
+        try {
+            if (existsSync(this.filePath)) {
+                const raw = readFileSync(this.filePath, "utf-8");
+                const data = JSON.parse(raw);
+                return {
+                    definitions: data.definitions ?? {},
+                    active: data.active ?? {},
+                    expired: data.expired ?? [],
+                };
+            }
+        }
+        catch { /* corrupted file — start fresh */ }
+        return { definitions: {}, active: {}, expired: [] };
+    }
+    /** Persist current state to disk. */
+    async save(state) {
+        try {
+            writeFileSync(this.filePath, JSON.stringify(state, null, 2));
+        }
+        catch { /* best-effort */ }
+    }
+    /** Remove all entries for a given group and persist. */
+    async removeGroup(state, group) {
+        delete state.definitions[group];
+        const prefix = `${group}:`;
+        for (const key of Object.keys(state.active)) {
+            if (key.startsWith(prefix))
+                delete state.active[key];
+        }
+        state.expired = state.expired.filter(k => !k.startsWith(prefix));
+        await this.save(state);
+        return state;
+    }
+}
+//# sourceMappingURL=file-delay-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-delay-store.js","sourceRoot":"","sources":["../src/file-delay-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACjB,QAAQ,CAAS;IAEzB,YAAY,QAAgB;QAC1B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;gBAC3C,OAAO;oBACL,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;oBACnC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;oBACzB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;iBAC5B,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,kCAAkC,CAAC,CAAC;QAC9C,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACtD,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,IAAI,CAAC,KAAiB;QAC1B,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/B,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,WAAW,CAAC,KAAiB,EAAE,KAAa;QAChD,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACjE,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

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

@@ -0,0 +1,22 @@
+import type { LogStore, LogEntry, SessionInfo } from "@polpo-ai/core/log-store";
+/**
+ * File-backed LogStore.
+ * Writes JSONL files to `.polpo/logs/`, one per session.
+ *
+ * File naming: `{sessionId}.jsonl`
+ * First line of each file: `{"_session":true,"sessionId":"...","startedAt":"..."}`
+ */
+export declare class FileLogStore implements LogStore {
+    private readonly logsDir;
+    private sessionId?;
+    constructor(polpoDir: string);
+    startSession(): Promise<string>;
+    getSessionId(): Promise<string | undefined>;
+    append(entry: LogEntry): Promise<void>;
+    getSessionEntries(sessionId?: string): Promise<LogEntry[]>;
+    listSessions(): Promise<SessionInfo[]>;
+    prune(keepSessions: number): Promise<number>;
+    close(): Promise<void>;
+    private sessionFile;
+}
+//# sourceMappingURL=file-log-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-log-store.d.ts","sourceRoot":"","sources":["../src/file-log-store.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEhF;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,QAAQ,EAAE,MAAM;IAItB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAc/B,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI3C,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAStC,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAoB1D,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAgCtC,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,OAAO,CAAC,WAAW;CAGpB"}

package/dist/file-log-store.js

@@ -0,0 +1,123 @@
+import { existsSync, mkdirSync, appendFileSync, readFileSync, readdirSync, unlinkSync, statSync, } from "node:fs";
+import { join } from "node:path";
+import { nanoid } from "nanoid";
+/**
+ * File-backed LogStore.
+ * Writes JSONL files to `.polpo/logs/`, one per session.
+ *
+ * File naming: `{sessionId}.jsonl`
+ * First line of each file: `{"_session":true,"sessionId":"...","startedAt":"..."}`
+ */
+export class FileLogStore {
+    logsDir;
+    sessionId;
+    constructor(polpoDir) {
+        this.logsDir = join(polpoDir, "logs");
+    }
+    async startSession() {
+        if (!existsSync(this.logsDir)) {
+            mkdirSync(this.logsDir, { recursive: true });
+        }
+        this.sessionId = nanoid(10);
+        const header = JSON.stringify({
+            _session: true,
+            sessionId: this.sessionId,
+            startedAt: new Date().toISOString(),
+        });
+        appendFileSync(this.sessionFile(this.sessionId), header + "\n", "utf-8");
+        return this.sessionId;
+    }
+    async getSessionId() {
+        return this.sessionId;
+    }
+    async append(entry) {
+        if (!this.sessionId)
+            return;
+        try {
+            const line = JSON.stringify(entry);
+            appendFileSync(this.sessionFile(this.sessionId), line + "\n", "utf-8");
+        }
+        catch { /* best-effort: non-critical */
+        }
+    }
+    async getSessionEntries(sessionId) {
+        const sid = sessionId ?? this.sessionId;
+        if (!sid)
+            return [];
+        const file = this.sessionFile(sid);
+        if (!existsSync(file))
+            return [];
+        try {
+            const lines = readFileSync(file, "utf-8").split("\n").filter(Boolean);
+            const entries = [];
+            for (const line of lines) {
+                const obj = JSON.parse(line);
+                // Skip session header
+                if (obj._session)
+                    continue;
+                entries.push(obj);
+            }
+            return entries;
+        }
+        catch { /* unreadable log file */
+            return [];
+        }
+    }
+    async listSessions() {
+        if (!existsSync(this.logsDir))
+            return [];
+        const files = readdirSync(this.logsDir)
+            .filter(f => f.endsWith(".jsonl"))
+            .sort()
+            .reverse(); // most recent first (nanoid is not time-sorted, so use file mtime)
+        // Sort by modification time (most recent first)
+        const withMtime = files.map(f => ({
+            file: f,
+            mtime: statSync(join(this.logsDir, f)).mtimeMs,
+        }));
+        withMtime.sort((a, b) => b.mtime - a.mtime);
+        const sessions = [];
+        for (const { file } of withMtime) {
+            const filePath = join(this.logsDir, file);
+            try {
+                const content = readFileSync(filePath, "utf-8");
+                const lines = content.split("\n").filter(Boolean);
+                const header = JSON.parse(lines[0]);
+                sessions.push({
+                    sessionId: header.sessionId ?? file.replace(".jsonl", ""),
+                    startedAt: header.startedAt ?? new Date(statSync(filePath).mtimeMs).toISOString(),
+                    entries: lines.length - 1, // exclude header
+                });
+            }
+            catch { /* skip corrupt file */
+            }
+        }
+        return sessions;
+    }
+    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) {
+            // Don't prune current session
+            if (s.sessionId === this.sessionId)
+                continue;
+            try {
+                unlinkSync(this.sessionFile(s.sessionId));
+                removed++;
+            }
+            catch { /* file already removed */ }
+        }
+        return removed;
+    }
+    async close() {
+        // No resources to release for file-based store
+        this.sessionId = undefined;
+    }
+    sessionFile(sessionId) {
+        return join(this.logsDir, `${sessionId}.jsonl`);
+    }
+}
+//# sourceMappingURL=file-log-store.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type { MemoryStore } from "@polpo-ai/core/memory-store";
+/**
+ * File-backed MemoryStore.
+ * Reads/writes `.polpo/memory.md` for shared memory (no scope).
+ * Agent-scoped memory lives in `.polpo/memory/<agent-name>.md`.
+ */
+export declare class FileMemoryStore implements MemoryStore {
+    private readonly sharedPath;
+    private readonly scopeDir;
+    constructor(polpoDir: string);
+    /** Resolve the file path for a given scope. Undefined = shared memory. */
+    private resolvePath;
+    exists(scope?: string): Promise<boolean>;
+    get(scope?: string): Promise<string>;
+    save(content: string, scope?: string): Promise<void>;
+    append(line: string, scope?: string): Promise<void>;
+    update(oldText: string, newText: string, scope?: string): Promise<true | string>;
+    /** List all agent scopes that have memory files. Returns agent names (without "agent:" prefix). */
+    listScopes(): Promise<string[]>;
+}
+//# sourceMappingURL=file-memory-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-memory-store.d.ts","sourceRoot":"","sources":["../src/file-memory-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,EAAE,MAAM;IAK5B,0EAA0E;IAC1E,OAAO,CAAC,WAAW;IAOb,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUpC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASpD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC;IAiBtF,mGAAmG;IAC7F,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAUtC"}