borderless-agent 0.0.1-alpha.1

package/dist/storage/cloudBackend.d.ts

@@ -0,0 +1,48 @@
+/**
+ * storage/cloudBackend.ts - Cloud-backed storage (S3-compatible).
+ *
+ * Uses @aws-sdk/client-s3; set AGENT_STORAGE_BACKEND=cloud and configure bucket + credentials.
+ */
+import { S3Client } from '@aws-sdk/client-s3';
+import { SessionStore, MemoryStore, SkillStore, ContextStore, StorageBackend } from './protocols';
+export declare class CloudSessionStore implements SessionStore {
+    private _client;
+    private _bucket;
+    constructor(client?: S3Client, bucket?: string);
+    private _key;
+    get(sessionId: string): Record<string, any> | null;
+    getAsync(sessionId: string): Promise<Record<string, any> | null>;
+    put(sessionId: string, data: Record<string, any>): void;
+    listIds(): string[];
+    listIdsAsync(): Promise<string[]>;
+    listSummaries(limit?: number): Record<string, any>[];
+    listSummariesAsync(limit?: number): Promise<Record<string, any>[]>;
+}
+export declare class CloudMemoryStore implements MemoryStore {
+    private _client;
+    private _bucket;
+    constructor(client?: S3Client, bucket?: string);
+    load(): Record<string, any>[];
+    loadAsync(): Promise<Record<string, any>[]>;
+    save(items: Record<string, any>[]): void;
+}
+export declare class CloudSkillStore implements SkillStore {
+    private _client;
+    private _bucket;
+    constructor(client?: S3Client, bucket?: string);
+    listSkills(): string[];
+    listSkillsAsync(): Promise<string[]>;
+    getSkill(name: string): Record<string, any> | null;
+    getSkillAsync(name: string): Promise<Record<string, any> | null>;
+}
+export declare class CloudContextStore implements ContextStore {
+    private _client;
+    private _bucket;
+    constructor(client?: S3Client, bucket?: string);
+    private _key;
+    get(sessionId: string): Record<string, any> | null;
+    getAsync(sessionId: string): Promise<Record<string, any> | null>;
+    set(sessionId: string, data: Record<string, any>): void;
+}
+export declare function createCloudBackend(client?: S3Client, bucket?: string): StorageBackend;
+//# sourceMappingURL=cloudBackend.d.ts.map

package/dist/storage/cloudBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudBackend.d.ts","sourceRoot":"","sources":["../../src/storage/cloudBackend.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,QAAQ,EAIX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACjB,MAAM,aAAa,CAAC;AAqDrB,qBAAa,iBAAkB,YAAW,YAAY;IAClD,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM;IAW9C,OAAO,CAAC,IAAI;IAIZ,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAK5C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAYtE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAWvD,OAAO,IAAI,MAAM,EAAE;IAIb,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsBvC,aAAa,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE;IAIlD,kBAAkB,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;CAgB/E;AAMD,qBAAa,gBAAiB,YAAW,WAAW;IAChD,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM;IAW9C,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE;IAIvB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IAajD,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI;CAU3C;AAMD,qBAAa,eAAgB,YAAW,UAAU;IAC9C,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM;IAW9C,UAAU,IAAI,MAAM,EAAE;IAIhB,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI5C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;CAYzE;AAMD,qBAAa,iBAAkB,YAAW,YAAY;IAClD,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM;IAW9C,OAAO,CAAC,IAAI;IAIZ,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI5C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAetE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;CAU1D;AAMD,wBAAgB,kBAAkB,CAC9B,MAAM,CAAC,EAAE,QAAQ,EACjB,MAAM,CAAC,EAAE,MAAM,GAChB,cAAc,CAiBhB"}

package/dist/storage/cloudBackend.js

@@ -0,0 +1,301 @@
+"use strict";
+/**
+ * storage/cloudBackend.ts - Cloud-backed storage (S3-compatible).
+ *
+ * Uses @aws-sdk/client-s3; set AGENT_STORAGE_BACKEND=cloud and configure bucket + credentials.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudContextStore = exports.CloudSkillStore = exports.CloudMemoryStore = exports.CloudSessionStore = void 0;
+exports.createCloudBackend = createCloudBackend;
+const client_s3_1 = require("@aws-sdk/client-s3");
+const protocols_1 = require("./protocols");
+// Key prefixes
+const KEY_PREFIX = 'agent';
+const SESSIONS_PREFIX = `${KEY_PREFIX}/sessions/`;
+const MEMORY_KEY = `${KEY_PREFIX}/memory/data`;
+const SKILLS_PREFIX = `${KEY_PREFIX}/skills/`;
+const CONTEXT_PREFIX = `${KEY_PREFIX}/context/`;
+function configBucket() {
+    const v = (process.env.AGENT_STORAGE_BUCKET ?? '').trim();
+    if (!v)
+        throw new Error('Cloud storage requires AGENT_STORAGE_BUCKET');
+    return v;
+}
+function configEndpoint() {
+    return (process.env.AGENT_S3_ENDPOINT ?? '').trim() || undefined;
+}
+function configRegion() {
+    return ((process.env.AGENT_STORAGE_REGION ?? process.env.AWS_REGION ?? 'us-east-1').trim());
+}
+function getClient() {
+    const bucket = configBucket();
+    const endpoint = configEndpoint();
+    const region = configRegion();
+    const opts = {
+        region,
+        forcePathStyle: true,
+    };
+    if (endpoint)
+        opts.endpoint = endpoint;
+    return { client: new client_s3_1.S3Client(opts), bucket };
+}
+function encode(data) {
+    return Buffer.from(JSON.stringify(data), 'utf-8');
+}
+async function streamToString(stream) {
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
+    }
+    return Buffer.concat(chunks).toString('utf-8');
+}
+// ---------------------------------------------------------------------------
+// CloudSessionStore
+// ---------------------------------------------------------------------------
+class CloudSessionStore {
+    _client;
+    _bucket;
+    constructor(client, bucket) {
+        if (client && bucket) {
+            this._client = client;
+            this._bucket = bucket;
+        }
+        else {
+            const c = getClient();
+            this._client = c.client;
+            this._bucket = c.bucket;
+        }
+    }
+    _key(sessionId) {
+        return `${SESSIONS_PREFIX}${sessionId}`;
+    }
+    get(sessionId) {
+        // Sync wrapper — callers should await if needed
+        return null; // Placeholder: S3 ops are async
+    }
+    async getAsync(sessionId) {
+        try {
+            const resp = await this._client.send(new client_s3_1.GetObjectCommand({ Bucket: this._bucket, Key: this._key(sessionId) }));
+            const body = await streamToString(resp.Body);
+            return JSON.parse(body);
+        }
+        catch {
+            return null;
+        }
+    }
+    put(sessionId, data) {
+        this._client.send(new client_s3_1.PutObjectCommand({
+            Bucket: this._bucket,
+            Key: this._key(sessionId),
+            Body: encode(data),
+            ContentType: 'application/json; charset=utf-8',
+        }));
+    }
+    listIds() {
+        return []; // Async — use listIdsAsync
+    }
+    async listIdsAsync() {
+        const ids = [];
+        let continuationToken;
+        do {
+            const resp = await this._client.send(new client_s3_1.ListObjectsV2Command({
+                Bucket: this._bucket,
+                Prefix: SESSIONS_PREFIX,
+                ContinuationToken: continuationToken,
+            }));
+            for (const obj of resp.Contents ?? []) {
+                const k = obj.Key ?? '';
+                if (k.endsWith('/'))
+                    continue;
+                const sid = k.slice(SESSIONS_PREFIX.length);
+                if (sid)
+                    ids.push(sid);
+            }
+            continuationToken = resp.NextContinuationToken;
+        } while (continuationToken);
+        return ids.sort();
+    }
+    listSummaries(limit = 20) {
+        return []; // Async — use listSummariesAsync
+    }
+    async listSummariesAsync(limit = 20) {
+        const ids = await this.listIdsAsync();
+        const entries = [];
+        for (const sid of ids) {
+            const data = await this.getAsync(sid);
+            if (!data)
+                continue;
+            entries.push({
+                id: sid,
+                updated_at: data.updated_at ?? 0,
+                turns: (data.history ?? []).filter((m) => m.role === 'user').length,
+                state: data.state ?? 'active',
+            });
+        }
+        entries.sort((a, b) => b.updated_at - a.updated_at);
+        return entries.slice(0, limit);
+    }
+}
+exports.CloudSessionStore = CloudSessionStore;
+// ---------------------------------------------------------------------------
+// CloudMemoryStore
+// ---------------------------------------------------------------------------
+class CloudMemoryStore {
+    _client;
+    _bucket;
+    constructor(client, bucket) {
+        if (client && bucket) {
+            this._client = client;
+            this._bucket = bucket;
+        }
+        else {
+            const c = getClient();
+            this._client = c.client;
+            this._bucket = c.bucket;
+        }
+    }
+    load() {
+        return []; // Async — use loadAsync
+    }
+    async loadAsync() {
+        try {
+            const resp = await this._client.send(new client_s3_1.GetObjectCommand({ Bucket: this._bucket, Key: MEMORY_KEY }));
+            const body = await streamToString(resp.Body);
+            const data = JSON.parse(body);
+            return Array.isArray(data) ? data : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    save(items) {
+        this._client.send(new client_s3_1.PutObjectCommand({
+            Bucket: this._bucket,
+            Key: MEMORY_KEY,
+            Body: encode(items),
+            ContentType: 'application/json; charset=utf-8',
+        }));
+    }
+}
+exports.CloudMemoryStore = CloudMemoryStore;
+// ---------------------------------------------------------------------------
+// CloudSkillStore
+// ---------------------------------------------------------------------------
+class CloudSkillStore {
+    _client;
+    _bucket;
+    constructor(client, bucket) {
+        if (client && bucket) {
+            this._client = client;
+            this._bucket = bucket;
+        }
+        else {
+            const c = getClient();
+            this._client = c.client;
+            this._bucket = c.bucket;
+        }
+    }
+    listSkills() {
+        return []; // Async — use listSkillsAsync
+    }
+    async listSkillsAsync() {
+        const names = [];
+        let continuationToken;
+        do {
+            const resp = await this._client.send(new client_s3_1.ListObjectsV2Command({
+                Bucket: this._bucket,
+                Prefix: SKILLS_PREFIX,
+                ContinuationToken: continuationToken,
+            }));
+            for (const obj of resp.Contents ?? []) {
+                const k = obj.Key ?? '';
+                if (k.endsWith('/'))
+                    continue;
+                const name = k.slice(SKILLS_PREFIX.length);
+                if (name)
+                    names.push(name);
+            }
+            continuationToken = resp.NextContinuationToken;
+        } while (continuationToken);
+        return names.sort();
+    }
+    getSkill(name) {
+        return null; // Async — use getSkillAsync
+    }
+    async getSkillAsync(name) {
+        const key = `${SKILLS_PREFIX}${name}`;
+        try {
+            const resp = await this._client.send(new client_s3_1.GetObjectCommand({ Bucket: this._bucket, Key: key }));
+            const body = await streamToString(resp.Body);
+            return JSON.parse(body);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.CloudSkillStore = CloudSkillStore;
+// ---------------------------------------------------------------------------
+// CloudContextStore
+// ---------------------------------------------------------------------------
+class CloudContextStore {
+    _client;
+    _bucket;
+    constructor(client, bucket) {
+        if (client && bucket) {
+            this._client = client;
+            this._bucket = bucket;
+        }
+        else {
+            const c = getClient();
+            this._client = c.client;
+            this._bucket = c.bucket;
+        }
+    }
+    _key(sessionId) {
+        return `${CONTEXT_PREFIX}${sessionId}`;
+    }
+    get(sessionId) {
+        return null; // Async — use getAsync
+    }
+    async getAsync(sessionId) {
+        try {
+            const resp = await this._client.send(new client_s3_1.GetObjectCommand({ Bucket: this._bucket, Key: this._key(sessionId) }));
+            const body = await streamToString(resp.Body);
+            const data = JSON.parse(body);
+            return data && typeof data === 'object' && !Array.isArray(data)
+                ? data
+                : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    set(sessionId, data) {
+        this._client.send(new client_s3_1.PutObjectCommand({
+            Bucket: this._bucket,
+            Key: this._key(sessionId),
+            Body: encode(data),
+            ContentType: 'application/json; charset=utf-8',
+        }));
+    }
+}
+exports.CloudContextStore = CloudContextStore;
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+function createCloudBackend(client, bucket) {
+    let c;
+    let b;
+    if (client && bucket) {
+        c = client;
+        b = bucket;
+    }
+    else {
+        const result = getClient();
+        c = result.client;
+        b = result.bucket;
+    }
+    return new protocols_1.StorageBackend(new CloudSessionStore(c, b), new CloudMemoryStore(c, b), new CloudSkillStore(c, b), new CloudContextStore(c, b));
+}
+//# sourceMappingURL=cloudBackend.js.map

package/dist/storage/cloudBackend.js.map

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

package/dist/storage/fileBackend.d.ts

@@ -0,0 +1,41 @@
+/**
+ * storage/fileBackend.ts - File-backed storage implementations.
+ */
+import { SessionStore, MemoryStore, SkillStore, ContextStore, StorageBackend } from './protocols';
+export declare class FileSessionStore implements SessionStore {
+    private _dir;
+    constructor(storageDir?: string);
+    private _path;
+    get(sessionId: string): Record<string, any> | null;
+    put(sessionId: string, data: Record<string, any>): void;
+    listIds(): string[];
+    listSummaries(limit?: number): Record<string, any>[];
+}
+export declare class FileMemoryStore implements MemoryStore {
+    private _path;
+    constructor(memoryFile?: string);
+    load(): Record<string, any>[];
+    save(items: Record<string, any>[]): void;
+}
+export declare class FileSkillStore implements SkillStore {
+    private _dir;
+    private _cache;
+    constructor(skillsDir?: string);
+    private _parseSkillMd;
+    listSkills(): string[];
+    getSkill(name: string): Record<string, any> | null;
+}
+export declare class FileContextStore implements ContextStore {
+    private _dir;
+    constructor(contextDir?: string);
+    private _path;
+    get(sessionId: string): Record<string, any> | null;
+    set(sessionId: string, data: Record<string, any>): void;
+}
+export declare function createFileBackend(options?: {
+    sessionDir?: string;
+    memoryFile?: string;
+    skillsDir?: string;
+    contextDir?: string;
+}): StorageBackend;
+//# sourceMappingURL=fileBackend.d.ts.map

package/dist/storage/fileBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileBackend.d.ts","sourceRoot":"","sources":["../../src/storage/fileBackend.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EACH,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACjB,MAAM,aAAa,CAAC;AAmCrB,qBAAa,gBAAiB,YAAW,YAAY;IACjD,OAAO,CAAC,IAAI,CAAS;gBAET,UAAU,CAAC,EAAE,MAAM;IAI/B,OAAO,CAAC,KAAK;IAIb,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIlD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKvD,OAAO,IAAI,MAAM,EAAE;IAUnB,aAAa,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE;CAwB3D;AAMD,qBAAa,eAAgB,YAAW,WAAW;IAC/C,OAAO,CAAC,KAAK,CAAS;gBAEV,UAAU,CAAC,EAAE,MAAM;IAI/B,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE;IAK7B,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI;CAG3C;AAMD,qBAAa,cAAe,YAAW,UAAU;IAC7C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAA2C;gBAE7C,SAAS,CAAC,EAAE,MAAM;IAI9B,OAAO,CAAC,aAAa;IAiCrB,UAAU,IAAI,MAAM,EAAE;IAiBtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;CAMrD;AAMD,qBAAa,gBAAiB,YAAW,YAAY;IACjD,OAAO,CAAC,IAAI,CAAS;gBAET,UAAU,CAAC,EAAE,MAAM;IAI/B,OAAO,CAAC,KAAK;IAIb,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAOlD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;CAG1D;AAMD,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,cAAc,CAOjB"}

package/dist/storage/fileBackend.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * storage/fileBackend.ts - File-backed storage implementations.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileContextStore = exports.FileSkillStore = exports.FileMemoryStore = exports.FileSessionStore = void 0;
+exports.createFileBackend = createFileBackend;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("../config");
+const protocols_1 = require("./protocols");
+// Default paths
+const DEFAULT_SESSION_DIR = process.env.AGENT_SESSION_DIR ?? path.join(config_1.WORKDIR, 'data', 'sessions');
+const DEFAULT_MEMORY_DIR = process.env.AGENT_MEMORY_DIR ?? path.join(config_1.WORKDIR, 'data', 'memory');
+const DEFAULT_MEMORY_FILE = path.join(DEFAULT_MEMORY_DIR, 'memories.json');
+const DEFAULT_SKILLS_DIR = process.env.AGENT_SKILLS_DIR ?? path.join(config_1.WORKDIR, 'skills');
+const DEFAULT_CONTEXT_DIR = process.env.AGENT_CONTEXT_DIR ?? path.join(config_1.WORKDIR, 'data', 'context');
+function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+function jsonRead(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function jsonWrite(filePath, data) {
+    ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// FileSessionStore
+// ---------------------------------------------------------------------------
+class FileSessionStore {
+    _dir;
+    constructor(storageDir) {
+        this._dir = storageDir ?? DEFAULT_SESSION_DIR;
+    }
+    _path(sessionId) {
+        return path.join(this._dir, `${sessionId}.json`);
+    }
+    get(sessionId) {
+        return jsonRead(this._path(sessionId));
+    }
+    put(sessionId, data) {
+        ensureDir(this._dir);
+        jsonWrite(this._path(sessionId), data);
+    }
+    listIds() {
+        const ids = new Set();
+        if (fs.existsSync(this._dir)) {
+            for (const f of fs.readdirSync(this._dir)) {
+                if (f.endsWith('.json'))
+                    ids.add(path.basename(f, '.json'));
+            }
+        }
+        return [...ids].sort();
+    }
+    listSummaries(limit = 20) {
+        const entries = [];
+        const seen = new Set();
+        if (fs.existsSync(this._dir)) {
+            for (const f of fs.readdirSync(this._dir)) {
+                if (!f.endsWith('.json'))
+                    continue;
+                const sid = path.basename(f, '.json');
+                if (seen.has(sid))
+                    continue;
+                const data = jsonRead(path.join(this._dir, f));
+                if (!data)
+                    continue;
+                entries.push({
+                    id: sid,
+                    updated_at: data.updated_at ?? 0,
+                    turns: (data.history ?? []).filter((m) => m.role === 'user').length,
+                    state: data.state ?? 'active',
+                });
+                seen.add(sid);
+            }
+        }
+        entries.sort((a, b) => b.updated_at - a.updated_at);
+        return entries.slice(0, limit);
+    }
+}
+exports.FileSessionStore = FileSessionStore;
+// ---------------------------------------------------------------------------
+// FileMemoryStore
+// ---------------------------------------------------------------------------
+class FileMemoryStore {
+    _path;
+    constructor(memoryFile) {
+        this._path = memoryFile ?? DEFAULT_MEMORY_FILE;
+    }
+    load() {
+        const data = jsonRead(this._path);
+        return Array.isArray(data) ? data : [];
+    }
+    save(items) {
+        jsonWrite(this._path, items);
+    }
+}
+exports.FileMemoryStore = FileMemoryStore;
+// ---------------------------------------------------------------------------
+// FileSkillStore
+// ---------------------------------------------------------------------------
+class FileSkillStore {
+    _dir;
+    _cache = {};
+    constructor(skillsDir) {
+        this._dir = skillsDir ?? DEFAULT_SKILLS_DIR;
+    }
+    _parseSkillMd(filePath) {
+        if (!fs.existsSync(filePath))
+            return null;
+        let content;
+        try {
+            content = fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+        const match = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/);
+        if (!match)
+            return null;
+        const [, frontmatter, body] = match;
+        const metadata = {};
+        for (const line of frontmatter.trim().split('\n')) {
+            const idx = line.indexOf(':');
+            if (idx >= 0) {
+                const key = line.slice(0, idx).trim();
+                const value = line
+                    .slice(idx + 1)
+                    .trim()
+                    .replace(/^["']|["']$/g, '');
+                metadata[key] = value;
+            }
+        }
+        if (!metadata.name || !metadata.description)
+            return null;
+        return {
+            name: metadata.name,
+            description: metadata.description,
+            body: body.trim(),
+            path: filePath,
+            dir: path.dirname(filePath),
+        };
+    }
+    listSkills() {
+        this._cache = {};
+        if (!fs.existsSync(this._dir))
+            return [];
+        const out = [];
+        for (const entry of fs.readdirSync(this._dir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const skillMd = path.join(this._dir, entry.name, 'SKILL.md');
+            if (!fs.existsSync(skillMd))
+                continue;
+            const skill = this._parseSkillMd(skillMd);
+            if (skill) {
+                this._cache[skill.name] = skill;
+                out.push(skill.name);
+            }
+        }
+        return out;
+    }
+    getSkill(name) {
+        if (!Object.keys(this._cache).length && fs.existsSync(this._dir)) {
+            this.listSkills();
+        }
+        return this._cache[name] ?? null;
+    }
+}
+exports.FileSkillStore = FileSkillStore;
+// ---------------------------------------------------------------------------
+// FileContextStore
+// ---------------------------------------------------------------------------
+class FileContextStore {
+    _dir;
+    constructor(contextDir) {
+        this._dir = contextDir ?? DEFAULT_CONTEXT_DIR;
+    }
+    _path(sessionId) {
+        return path.join(this._dir, `${sessionId}.json`);
+    }
+    get(sessionId) {
+        const data = jsonRead(this._path(sessionId));
+        return data && typeof data === 'object' && !Array.isArray(data)
+            ? data
+            : null;
+    }
+    set(sessionId, data) {
+        jsonWrite(this._path(sessionId), data);
+    }
+}
+exports.FileContextStore = FileContextStore;
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+function createFileBackend(options) {
+    return new protocols_1.StorageBackend(new FileSessionStore(options?.sessionDir), new FileMemoryStore(options?.memoryFile), new FileSkillStore(options?.skillsDir), new FileContextStore(options?.contextDir));
+}
+//# sourceMappingURL=fileBackend.js.map

package/dist/storage/fileBackend.js.map

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