@jussmor/sdk-ai 0.2.0

package/dist/providers/llm/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/providers/llm/openai.ts"],"sourcesContent":["import OpenAI from \"openai\";\nimport type {\n  LLMProvider,\n  ChatRequest,\n  ChatResponse,\n  ChatMessage,\n} from \"../../llm.js\";\nimport type { StreamingLLMProvider, StreamEvent } from \"../../streaming.js\";\n\nfunction toOpenAIMessages(\n  messages: ChatMessage[],\n): OpenAI.ChatCompletionMessageParam[] {\n  return messages.map((msg): OpenAI.ChatCompletionMessageParam => {\n    if (msg.role === \"system\") {\n      return { role: \"system\", content: msg.content };\n    }\n    if (msg.role === \"tool\") {\n      return {\n        role: \"tool\",\n        tool_call_id: msg.toolCallId ?? \"\",\n        content: msg.content,\n      };\n    }\n    if (msg.role === \"assistant\") {\n      const out: OpenAI.ChatCompletionAssistantMessageParam = {\n        role: \"assistant\",\n        content: msg.content || null,\n      };\n      if (msg.toolCalls?.length) {\n        out.tool_calls = msg.toolCalls.map((tc) => ({\n          id: tc.id,\n          type: \"function\" as const,\n          function: { name: tc.name, arguments: tc.arguments },\n        }));\n      }\n      return out;\n    }\n    if (msg.images?.length) {\n      const content: OpenAI.ChatCompletionContentPart[] = msg.images.map(\n        (img) =>\n          img.url\n            ? ({ type: \"image_url\", image_url: { url: img.url } } as const)\n            : ({\n                type: \"image_url\",\n                image_url: {\n                  url: `data:${img.mediaType};base64,${img.source}`,\n                },\n              } as const),\n      );\n      if (msg.content) content.push({ type: \"text\", text: msg.content });\n      return { role: \"user\", content };\n    }\n    return { role: \"user\", content: msg.content };\n  });\n}\n\nexport interface OpenAIProviderOptions {\n  apiKey?: string;\n  baseURL?: string;\n  defaultModel?: string;\n  defaultMaxTokens?: number;\n}\n\nexport class OpenAIProvider implements StreamingLLMProvider {\n  private client: OpenAI;\n  private defaultModel: string;\n  private defaultMaxTokens: number;\n\n  constructor(opts: OpenAIProviderOptions = {}) {\n    this.client = new OpenAI({\n      apiKey: opts.apiKey ?? process.env[\"OPENAI_API_KEY\"],\n      baseURL: opts.baseURL ?? process.env[\"OPENAI_BASE_URL\"],\n    });\n    this.defaultModel = opts.defaultModel ?? \"gpt-4o\";\n    this.defaultMaxTokens = opts.defaultMaxTokens ?? 4096;\n  }\n\n  async chat(req: ChatRequest, signal?: AbortSignal): Promise<ChatResponse> {\n    const messages = toOpenAIMessages(req.messages);\n    const tools = req.tools?.map((t) => ({\n      type: \"function\" as const,\n      function: {\n        name: t.function.name,\n        description: t.function.description,\n        parameters: t.function.parameters as unknown as Record<string, unknown>,\n      },\n    }));\n\n    const resp = await this.client.chat.completions.create(\n      {\n        model: req.model ?? this.defaultModel,\n        messages,\n        max_tokens: req.maxTokens ?? this.defaultMaxTokens,\n        ...(tools?.length ? { tools } : {}),\n        ...(req.temperature != null ? { temperature: req.temperature } : {}),\n        ...(req.topP != null ? { top_p: req.topP } : {}),\n        ...(req.stop?.length ? { stop: req.stop } : {}),\n      },\n      { signal },\n    );\n\n    const choice = resp.choices[0];\n    const msg = choice?.message;\n\n    return {\n      content: msg?.content ?? \"\",\n      toolCalls: msg?.tool_calls?.map((tc) => ({\n        id: tc.id,\n        name: tc.function.name,\n        arguments: tc.function.arguments,\n      })),\n      finishReason: choice?.finish_reason ?? \"stop\",\n      usage: {\n        promptTokens: resp.usage?.prompt_tokens ?? 0,\n        completionTokens: resp.usage?.completion_tokens ?? 0,\n        totalTokens: resp.usage?.total_tokens ?? 0,\n      },\n      model: resp.model,\n    };\n  }\n\n  async *chatStream(\n    req: ChatRequest,\n    signal?: AbortSignal,\n  ): AsyncGenerator<StreamEvent> {\n    const messages = toOpenAIMessages(req.messages);\n    const tools = req.tools?.map((t) => ({\n      type: \"function\" as const,\n      function: {\n        name: t.function.name,\n        description: t.function.description,\n        parameters: t.function.parameters as unknown as Record<string, unknown>,\n      },\n    }));\n\n    const stream = await this.client.chat.completions.create(\n      {\n        model: req.model ?? this.defaultModel,\n        messages,\n        max_tokens: req.maxTokens ?? this.defaultMaxTokens,\n        stream: true,\n        stream_options: { include_usage: true },\n        ...(tools?.length ? { tools } : {}),\n        ...(req.temperature != null ? { temperature: req.temperature } : {}),\n        ...(req.topP != null ? { top_p: req.topP } : {}),\n        ...(req.stop?.length ? { stop: req.stop } : {}),\n      },\n      { signal },\n    );\n\n    const toolCallBufs = new Map<\n      number,\n      { id: string; name: string; argsBuf: string }\n    >();\n    let promptTokens = 0;\n    let completionTokens = 0;\n\n    for await (const chunk of stream) {\n      if (signal?.aborted) break;\n\n      if (chunk.usage) {\n        promptTokens = chunk.usage.prompt_tokens;\n        completionTokens = chunk.usage.completion_tokens;\n      }\n\n      const delta = chunk.choices[0]?.delta;\n      if (!delta) continue;\n\n      if (delta.content) {\n        yield { type: \"delta\", delta: delta.content };\n      }\n\n      if (delta.tool_calls) {\n        for (const tc of delta.tool_calls) {\n          const idx = tc.index;\n          if (!toolCallBufs.has(idx)) {\n            toolCallBufs.set(idx, { id: tc.id ?? \"\", name: tc.function?.name ?? \"\", argsBuf: \"\" });\n          }\n          const buf = toolCallBufs.get(idx)!;\n          if (tc.id) buf.id = tc.id;\n          if (tc.function?.name) buf.name = tc.function.name;\n          if (tc.function?.arguments) buf.argsBuf += tc.function.arguments;\n        }\n      }\n\n      const finishReason = chunk.choices[0]?.finish_reason;\n      if (finishReason) {\n        for (const [, tc] of toolCallBufs) {\n          yield {\n            type: \"tool_call\",\n            toolCall: { id: tc.id, name: tc.name, arguments: tc.argsBuf },\n          };\n        }\n        toolCallBufs.clear();\n\n        yield {\n          type: \"done\",\n          final: {\n            finalContent: \"\",\n            providerReasoning: \"\",\n            totalTurns: 1,\n            totalUsage: {\n              promptTokens,\n              completionTokens,\n              totalTokens: promptTokens + completionTokens,\n            },\n            messages: [],\n            reasoningTrace: [],\n            stopReason: \"complete\",\n          },\n        };\n      }\n    }\n  }\n}\n"],"mappings":";AAAA,OAAO,YAAY;AASnB,SAAS,iBACP,UACqC;AACrC,SAAO,SAAS,IAAI,CAAC,QAA2C;AAC9D,QAAI,IAAI,SAAS,UAAU;AACzB,aAAO,EAAE,MAAM,UAAU,SAAS,IAAI,QAAQ;AAAA,IAChD;AACA,QAAI,IAAI,SAAS,QAAQ;AACvB,aAAO;AAAA,QACL,MAAM;AAAA,QACN,cAAc,IAAI,cAAc;AAAA,QAChC,SAAS,IAAI;AAAA,MACf;AAAA,IACF;AACA,QAAI,IAAI,SAAS,aAAa;AAC5B,YAAM,MAAkD;AAAA,QACtD,MAAM;AAAA,QACN,SAAS,IAAI,WAAW;AAAA,MAC1B;AACA,UAAI,IAAI,WAAW,QAAQ;AACzB,YAAI,aAAa,IAAI,UAAU,IAAI,CAAC,QAAQ;AAAA,UAC1C,IAAI,GAAG;AAAA,UACP,MAAM;AAAA,UACN,UAAU,EAAE,MAAM,GAAG,MAAM,WAAW,GAAG,UAAU;AAAA,QACrD,EAAE;AAAA,MACJ;AACA,aAAO;AAAA,IACT;AACA,QAAI,IAAI,QAAQ,QAAQ;AACtB,YAAM,UAA8C,IAAI,OAAO;AAAA,QAC7D,CAAC,QACC,IAAI,MACC,EAAE,MAAM,aAAa,WAAW,EAAE,KAAK,IAAI,IAAI,EAAE,IACjD;AAAA,UACC,MAAM;AAAA,UACN,WAAW;AAAA,YACT,KAAK,QAAQ,IAAI,SAAS,WAAW,IAAI,MAAM;AAAA,UACjD;AAAA,QACF;AAAA,MACR;AACA,UAAI,IAAI,QAAS,SAAQ,KAAK,EAAE,MAAM,QAAQ,MAAM,IAAI,QAAQ,CAAC;AACjE,aAAO,EAAE,MAAM,QAAQ,QAAQ;AAAA,IACjC;AACA,WAAO,EAAE,MAAM,QAAQ,SAAS,IAAI,QAAQ;AAAA,EAC9C,CAAC;AACH;AASO,IAAM,iBAAN,MAAqD;AAAA,EAClD;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,OAA8B,CAAC,GAAG;AAC5C,SAAK,SAAS,IAAI,OAAO;AAAA,MACvB,QAAQ,KAAK,UAAU,QAAQ,IAAI,gBAAgB;AAAA,MACnD,SAAS,KAAK,WAAW,QAAQ,IAAI,iBAAiB;AAAA,IACxD,CAAC;AACD,SAAK,eAAe,KAAK,gBAAgB;AACzC,SAAK,mBAAmB,KAAK,oBAAoB;AAAA,EACnD;AAAA,EAEA,MAAM,KAAK,KAAkB,QAA6C;AACxE,UAAM,WAAW,iBAAiB,IAAI,QAAQ;AAC9C,UAAM,QAAQ,IAAI,OAAO,IAAI,CAAC,OAAO;AAAA,MACnC,MAAM;AAAA,MACN,UAAU;AAAA,QACR,MAAM,EAAE,SAAS;AAAA,QACjB,aAAa,EAAE,SAAS;AAAA,QACxB,YAAY,EAAE,SAAS;AAAA,MACzB;AAAA,IACF,EAAE;AAEF,UAAM,OAAO,MAAM,KAAK,OAAO,KAAK,YAAY;AAAA,MAC9C;AAAA,QACE,OAAO,IAAI,SAAS,KAAK;AAAA,QACzB;AAAA,QACA,YAAY,IAAI,aAAa,KAAK;AAAA,QAClC,GAAI,OAAO,SAAS,EAAE,MAAM,IAAI,CAAC;AAAA,QACjC,GAAI,IAAI,eAAe,OAAO,EAAE,aAAa,IAAI,YAAY,IAAI,CAAC;AAAA,QAClE,GAAI,IAAI,QAAQ,OAAO,EAAE,OAAO,IAAI,KAAK,IAAI,CAAC;AAAA,QAC9C,GAAI,IAAI,MAAM,SAAS,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAAA,MAC/C;AAAA,MACA,EAAE,OAAO;AAAA,IACX;AAEA,UAAM,SAAS,KAAK,QAAQ,CAAC;AAC7B,UAAM,MAAM,QAAQ;AAEpB,WAAO;AAAA,MACL,SAAS,KAAK,WAAW;AAAA,MACzB,WAAW,KAAK,YAAY,IAAI,CAAC,QAAQ;AAAA,QACvC,IAAI,GAAG;AAAA,QACP,MAAM,GAAG,SAAS;AAAA,QAClB,WAAW,GAAG,SAAS;AAAA,MACzB,EAAE;AAAA,MACF,cAAc,QAAQ,iBAAiB;AAAA,MACvC,OAAO;AAAA,QACL,cAAc,KAAK,OAAO,iBAAiB;AAAA,QAC3C,kBAAkB,KAAK,OAAO,qBAAqB;AAAA,QACnD,aAAa,KAAK,OAAO,gBAAgB;AAAA,MAC3C;AAAA,MACA,OAAO,KAAK;AAAA,IACd;AAAA,EACF;AAAA,EAEA,OAAO,WACL,KACA,QAC6B;AAC7B,UAAM,WAAW,iBAAiB,IAAI,QAAQ;AAC9C,UAAM,QAAQ,IAAI,OAAO,IAAI,CAAC,OAAO;AAAA,MACnC,MAAM;AAAA,MACN,UAAU;AAAA,QACR,MAAM,EAAE,SAAS;AAAA,QACjB,aAAa,EAAE,SAAS;AAAA,QACxB,YAAY,EAAE,SAAS;AAAA,MACzB;AAAA,IACF,EAAE;AAEF,UAAM,SAAS,MAAM,KAAK,OAAO,KAAK,YAAY;AAAA,MAChD;AAAA,QACE,OAAO,IAAI,SAAS,KAAK;AAAA,QACzB;AAAA,QACA,YAAY,IAAI,aAAa,KAAK;AAAA,QAClC,QAAQ;AAAA,QACR,gBAAgB,EAAE,eAAe,KAAK;AAAA,QACtC,GAAI,OAAO,SAAS,EAAE,MAAM,IAAI,CAAC;AAAA,QACjC,GAAI,IAAI,eAAe,OAAO,EAAE,aAAa,IAAI,YAAY,IAAI,CAAC;AAAA,QAClE,GAAI,IAAI,QAAQ,OAAO,EAAE,OAAO,IAAI,KAAK,IAAI,CAAC;AAAA,QAC9C,GAAI,IAAI,MAAM,SAAS,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAAA,MAC/C;AAAA,MACA,EAAE,OAAO;AAAA,IACX;AAEA,UAAM,eAAe,oBAAI,IAGvB;AACF,QAAI,eAAe;AACnB,QAAI,mBAAmB;AAEvB,qBAAiB,SAAS,QAAQ;AAChC,UAAI,QAAQ,QAAS;AAErB,UAAI,MAAM,OAAO;AACf,uBAAe,MAAM,MAAM;AAC3B,2BAAmB,MAAM,MAAM;AAAA,MACjC;AAEA,YAAM,QAAQ,MAAM,QAAQ,CAAC,GAAG;AAChC,UAAI,CAAC,MAAO;AAEZ,UAAI,MAAM,SAAS;AACjB,cAAM,EAAE,MAAM,SAAS,OAAO,MAAM,QAAQ;AAAA,MAC9C;AAEA,UAAI,MAAM,YAAY;AACpB,mBAAW,MAAM,MAAM,YAAY;AACjC,gBAAM,MAAM,GAAG;AACf,cAAI,CAAC,aAAa,IAAI,GAAG,GAAG;AAC1B,yBAAa,IAAI,KAAK,EAAE,IAAI,GAAG,MAAM,IAAI,MAAM,GAAG,UAAU,QAAQ,IAAI,SAAS,GAAG,CAAC;AAAA,UACvF;AACA,gBAAM,MAAM,aAAa,IAAI,GAAG;AAChC,cAAI,GAAG,GAAI,KAAI,KAAK,GAAG;AACvB,cAAI,GAAG,UAAU,KAAM,KAAI,OAAO,GAAG,SAAS;AAC9C,cAAI,GAAG,UAAU,UAAW,KAAI,WAAW,GAAG,SAAS;AAAA,QACzD;AAAA,MACF;AAEA,YAAM,eAAe,MAAM,QAAQ,CAAC,GAAG;AACvC,UAAI,cAAc;AAChB,mBAAW,CAAC,EAAE,EAAE,KAAK,cAAc;AACjC,gBAAM;AAAA,YACJ,MAAM;AAAA,YACN,UAAU,EAAE,IAAI,GAAG,IAAI,MAAM,GAAG,MAAM,WAAW,GAAG,QAAQ;AAAA,UAC9D;AAAA,QACF;AACA,qBAAa,MAAM;AAEnB,cAAM;AAAA,UACJ,MAAM;AAAA,UACN,OAAO;AAAA,YACL,cAAc;AAAA,YACd,mBAAmB;AAAA,YACnB,YAAY;AAAA,YACZ,YAAY;AAAA,cACV;AAAA,cACA;AAAA,cACA,aAAa,eAAe;AAAA,YAC9B;AAAA,YACA,UAAU,CAAC;AAAA,YACX,gBAAgB,CAAC;AAAA,YACjB,YAAY;AAAA,UACd;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/providers/memory/filesystem.cjs

@@ -0,0 +1,112 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/providers/memory/filesystem.ts
+var filesystem_exports = {};
+__export(filesystem_exports, {
+  FilesystemMemoryProvider: () => FilesystemMemoryProvider
+});
+module.exports = __toCommonJS(filesystem_exports);
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+var import_node_fs = require("fs");
+var FilesystemMemoryProvider = class {
+  constructor(root) {
+    this.root = root;
+  }
+  root;
+  scopeDir(scope) {
+    return (0, import_node_path.join)(this.root, scope);
+  }
+  resolvePath(scope, path) {
+    const base = this.scopeDir(scope);
+    const resolved = (0, import_node_path.normalize)((0, import_node_path.join)(base, path));
+    if (!resolved.startsWith(base)) {
+      throw new Error(`path traversal attempt: ${path}`);
+    }
+    return resolved;
+  }
+  async view(scope, path) {
+    const full = this.resolvePath(scope, path);
+    try {
+      return await (0, import_promises.readFile)(full, "utf-8");
+    } catch (e) {
+      const err = e;
+      if (err.code === "ENOENT") throw new Error(`not found: ${path}`);
+      throw e;
+    }
+  }
+  async create(scope, path, content) {
+    const full = this.resolvePath(scope, path);
+    if ((0, import_node_fs.existsSync)(full)) {
+      throw new Error(`file already exists: ${path}`);
+    }
+    await (0, import_promises.mkdir)((0, import_node_path.dirname)(full), { recursive: true });
+    await (0, import_promises.writeFile)(full, content, "utf-8");
+  }
+  async strReplace(scope, path, oldStr, newStr) {
+    const full = this.resolvePath(scope, path);
+    const content = await (0, import_promises.readFile)(full, "utf-8");
+    const count = content.split(oldStr).length - 1;
+    if (count === 0) throw new Error(`string not found in ${path}`);
+    if (count > 1) throw new Error(`string appears ${count} times in ${path}, must appear exactly once`);
+    await (0, import_promises.writeFile)(full, content.replace(oldStr, newStr), "utf-8");
+  }
+  async delete(scope, path) {
+    const full = this.resolvePath(scope, path);
+    await (0, import_promises.rm)(full, { recursive: true, force: true });
+  }
+  async rename(scope, oldPath, newPath) {
+    const oldFull = this.resolvePath(scope, oldPath);
+    const newFull = this.resolvePath(scope, newPath);
+    await (0, import_promises.mkdir)((0, import_node_path.dirname)(newFull), { recursive: true });
+    await (0, import_promises.rename)(oldFull, newFull);
+  }
+  async list(scope, path) {
+    const full = this.resolvePath(scope, path);
+    const base = this.scopeDir(scope);
+    try {
+      const entries = await (0, import_promises.readdir)(full, { recursive: true });
+      return entries.map((e) => (0, import_node_path.relative)(base, (0, import_node_path.join)(full, e))).sort();
+    } catch {
+      return [];
+    }
+  }
+  async search(scope, query) {
+    const files = await this.list(scope, "/");
+    const results = [];
+    const q = query.toLowerCase();
+    for (const file of files) {
+      if (!file.endsWith(".md")) continue;
+      try {
+        const content = await this.view(scope, file);
+        if (content.toLowerCase().includes(q)) {
+          results.push({ path: file, scope, content: content.slice(0, 500) });
+        }
+      } catch {
+      }
+    }
+    return results;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FilesystemMemoryProvider
+});
+//# sourceMappingURL=filesystem.cjs.map

package/dist/providers/memory/filesystem.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/providers/memory/filesystem.ts"],"sourcesContent":["import { readFile, writeFile, mkdir, rm, rename, readdir } from \"node:fs/promises\";\nimport { join, dirname, normalize, relative } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport type { MemoryProvider, MemoryEntry, Scope } from \"../../memory.js\";\n\nexport class FilesystemMemoryProvider implements MemoryProvider {\n  constructor(private root: string) {}\n\n  private scopeDir(scope: Scope): string {\n    return join(this.root, scope);\n  }\n\n  private resolvePath(scope: Scope, path: string): string {\n    const base = this.scopeDir(scope);\n    const resolved = normalize(join(base, path));\n    if (!resolved.startsWith(base)) {\n      throw new Error(`path traversal attempt: ${path}`);\n    }\n    return resolved;\n  }\n\n  async view(scope: Scope, path: string): Promise<string> {\n    const full = this.resolvePath(scope, path);\n    try {\n      return await readFile(full, \"utf-8\");\n    } catch (e) {\n      const err = e as NodeJS.ErrnoException;\n      if (err.code === \"ENOENT\") throw new Error(`not found: ${path}`);\n      throw e;\n    }\n  }\n\n  async create(scope: Scope, path: string, content: string): Promise<void> {\n    const full = this.resolvePath(scope, path);\n    if (existsSync(full)) {\n      throw new Error(`file already exists: ${path}`);\n    }\n    await mkdir(dirname(full), { recursive: true });\n    await writeFile(full, content, \"utf-8\");\n  }\n\n  async strReplace(\n    scope: Scope,\n    path: string,\n    oldStr: string,\n    newStr: string,\n  ): Promise<void> {\n    const full = this.resolvePath(scope, path);\n    const content = await readFile(full, \"utf-8\");\n    const count = (content.split(oldStr).length - 1);\n    if (count === 0) throw new Error(`string not found in ${path}`);\n    if (count > 1) throw new Error(`string appears ${count} times in ${path}, must appear exactly once`);\n    await writeFile(full, content.replace(oldStr, newStr), \"utf-8\");\n  }\n\n  async delete(scope: Scope, path: string): Promise<void> {\n    const full = this.resolvePath(scope, path);\n    await rm(full, { recursive: true, force: true });\n  }\n\n  async rename(scope: Scope, oldPath: string, newPath: string): Promise<void> {\n    const oldFull = this.resolvePath(scope, oldPath);\n    const newFull = this.resolvePath(scope, newPath);\n    await mkdir(dirname(newFull), { recursive: true });\n    await rename(oldFull, newFull);\n  }\n\n  async list(scope: Scope, path: string): Promise<string[]> {\n    const full = this.resolvePath(scope, path);\n    const base = this.scopeDir(scope);\n    try {\n      const entries = await readdir(full, { recursive: true });\n      return (entries as string[])\n        .map((e) => relative(base, join(full, e)))\n        .sort();\n    } catch {\n      return [];\n    }\n  }\n\n  async search(scope: Scope, query: string): Promise<MemoryEntry[]> {\n    const files = await this.list(scope, \"/\");\n    const results: MemoryEntry[] = [];\n    const q = query.toLowerCase();\n\n    for (const file of files) {\n      if (!file.endsWith(\".md\")) continue;\n      try {\n        const content = await this.view(scope, file);\n        if (content.toLowerCase().includes(q)) {\n          results.push({ path: file, scope, content: content.slice(0, 500) });\n        }\n      } catch {\n        // skip unreadable files\n      }\n    }\n    return results;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/providers/memory/filesystem.d.cts

@@ -0,0 +1,17 @@
+import { b as MemoryProvider, S as Scope, a as MemoryEntry } from '../../memory-uBLqrQRY.cjs';
+
+declare class FilesystemMemoryProvider implements MemoryProvider {
+    private root;
+    constructor(root: string);
+    private scopeDir;
+    private resolvePath;
+    view(scope: Scope, path: string): Promise<string>;
+    create(scope: Scope, path: string, content: string): Promise<void>;
+    strReplace(scope: Scope, path: string, oldStr: string, newStr: string): Promise<void>;
+    delete(scope: Scope, path: string): Promise<void>;
+    rename(scope: Scope, oldPath: string, newPath: string): Promise<void>;
+    list(scope: Scope, path: string): Promise<string[]>;
+    search(scope: Scope, query: string): Promise<MemoryEntry[]>;
+}
+
+export { FilesystemMemoryProvider };

package/dist/providers/memory/filesystem.d.ts

@@ -0,0 +1,17 @@
+import { b as MemoryProvider, S as Scope, a as MemoryEntry } from '../../memory-uBLqrQRY.js';
+
+declare class FilesystemMemoryProvider implements MemoryProvider {
+    private root;
+    constructor(root: string);
+    private scopeDir;
+    private resolvePath;
+    view(scope: Scope, path: string): Promise<string>;
+    create(scope: Scope, path: string, content: string): Promise<void>;
+    strReplace(scope: Scope, path: string, oldStr: string, newStr: string): Promise<void>;
+    delete(scope: Scope, path: string): Promise<void>;
+    rename(scope: Scope, oldPath: string, newPath: string): Promise<void>;
+    list(scope: Scope, path: string): Promise<string[]>;
+    search(scope: Scope, query: string): Promise<MemoryEntry[]>;
+}
+
+export { FilesystemMemoryProvider };

package/dist/providers/memory/filesystem.js

@@ -0,0 +1,87 @@
+// src/providers/memory/filesystem.ts
+import { readFile, writeFile, mkdir, rm, rename, readdir } from "fs/promises";
+import { join, dirname, normalize, relative } from "path";
+import { existsSync } from "fs";
+var FilesystemMemoryProvider = class {
+  constructor(root) {
+    this.root = root;
+  }
+  root;
+  scopeDir(scope) {
+    return join(this.root, scope);
+  }
+  resolvePath(scope, path) {
+    const base = this.scopeDir(scope);
+    const resolved = normalize(join(base, path));
+    if (!resolved.startsWith(base)) {
+      throw new Error(`path traversal attempt: ${path}`);
+    }
+    return resolved;
+  }
+  async view(scope, path) {
+    const full = this.resolvePath(scope, path);
+    try {
+      return await readFile(full, "utf-8");
+    } catch (e) {
+      const err = e;
+      if (err.code === "ENOENT") throw new Error(`not found: ${path}`);
+      throw e;
+    }
+  }
+  async create(scope, path, content) {
+    const full = this.resolvePath(scope, path);
+    if (existsSync(full)) {
+      throw new Error(`file already exists: ${path}`);
+    }
+    await mkdir(dirname(full), { recursive: true });
+    await writeFile(full, content, "utf-8");
+  }
+  async strReplace(scope, path, oldStr, newStr) {
+    const full = this.resolvePath(scope, path);
+    const content = await readFile(full, "utf-8");
+    const count = content.split(oldStr).length - 1;
+    if (count === 0) throw new Error(`string not found in ${path}`);
+    if (count > 1) throw new Error(`string appears ${count} times in ${path}, must appear exactly once`);
+    await writeFile(full, content.replace(oldStr, newStr), "utf-8");
+  }
+  async delete(scope, path) {
+    const full = this.resolvePath(scope, path);
+    await rm(full, { recursive: true, force: true });
+  }
+  async rename(scope, oldPath, newPath) {
+    const oldFull = this.resolvePath(scope, oldPath);
+    const newFull = this.resolvePath(scope, newPath);
+    await mkdir(dirname(newFull), { recursive: true });
+    await rename(oldFull, newFull);
+  }
+  async list(scope, path) {
+    const full = this.resolvePath(scope, path);
+    const base = this.scopeDir(scope);
+    try {
+      const entries = await readdir(full, { recursive: true });
+      return entries.map((e) => relative(base, join(full, e))).sort();
+    } catch {
+      return [];
+    }
+  }
+  async search(scope, query) {
+    const files = await this.list(scope, "/");
+    const results = [];
+    const q = query.toLowerCase();
+    for (const file of files) {
+      if (!file.endsWith(".md")) continue;
+      try {
+        const content = await this.view(scope, file);
+        if (content.toLowerCase().includes(q)) {
+          results.push({ path: file, scope, content: content.slice(0, 500) });
+        }
+      } catch {
+      }
+    }
+    return results;
+  }
+};
+export {
+  FilesystemMemoryProvider
+};
+//# sourceMappingURL=filesystem.js.map

package/dist/providers/memory/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/providers/memory/filesystem.ts"],"sourcesContent":["import { readFile, writeFile, mkdir, rm, rename, readdir } from \"node:fs/promises\";\nimport { join, dirname, normalize, relative } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport type { MemoryProvider, MemoryEntry, Scope } from \"../../memory.js\";\n\nexport class FilesystemMemoryProvider implements MemoryProvider {\n  constructor(private root: string) {}\n\n  private scopeDir(scope: Scope): string {\n    return join(this.root, scope);\n  }\n\n  private resolvePath(scope: Scope, path: string): string {\n    const base = this.scopeDir(scope);\n    const resolved = normalize(join(base, path));\n    if (!resolved.startsWith(base)) {\n      throw new Error(`path traversal attempt: ${path}`);\n    }\n    return resolved;\n  }\n\n  async view(scope: Scope, path: string): Promise<string> {\n    const full = this.resolvePath(scope, path);\n    try {\n      return await readFile(full, \"utf-8\");\n    } catch (e) {\n      const err = e as NodeJS.ErrnoException;\n      if (err.code === \"ENOENT\") throw new Error(`not found: ${path}`);\n      throw e;\n    }\n  }\n\n  async create(scope: Scope, path: string, content: string): Promise<void> {\n    const full = this.resolvePath(scope, path);\n    if (existsSync(full)) {\n      throw new Error(`file already exists: ${path}`);\n    }\n    await mkdir(dirname(full), { recursive: true });\n    await writeFile(full, content, \"utf-8\");\n  }\n\n  async strReplace(\n    scope: Scope,\n    path: string,\n    oldStr: string,\n    newStr: string,\n  ): Promise<void> {\n    const full = this.resolvePath(scope, path);\n    const content = await readFile(full, \"utf-8\");\n    const count = (content.split(oldStr).length - 1);\n    if (count === 0) throw new Error(`string not found in ${path}`);\n    if (count > 1) throw new Error(`string appears ${count} times in ${path}, must appear exactly once`);\n    await writeFile(full, content.replace(oldStr, newStr), \"utf-8\");\n  }\n\n  async delete(scope: Scope, path: string): Promise<void> {\n    const full = this.resolvePath(scope, path);\n    await rm(full, { recursive: true, force: true });\n  }\n\n  async rename(scope: Scope, oldPath: string, newPath: string): Promise<void> {\n    const oldFull = this.resolvePath(scope, oldPath);\n    const newFull = this.resolvePath(scope, newPath);\n    await mkdir(dirname(newFull), { recursive: true });\n    await rename(oldFull, newFull);\n  }\n\n  async list(scope: Scope, path: string): Promise<string[]> {\n    const full = this.resolvePath(scope, path);\n    const base = this.scopeDir(scope);\n    try {\n      const entries = await readdir(full, { recursive: true });\n      return (entries as string[])\n        .map((e) => relative(base, join(full, e)))\n        .sort();\n    } catch {\n      return [];\n    }\n  }\n\n  async search(scope: Scope, query: string): Promise<MemoryEntry[]> {\n    const files = await this.list(scope, \"/\");\n    const results: MemoryEntry[] = [];\n    const q = query.toLowerCase();\n\n    for (const file of files) {\n      if (!file.endsWith(\".md\")) continue;\n      try {\n        const content = await this.view(scope, file);\n        if (content.toLowerCase().includes(q)) {\n          results.push({ path: file, scope, content: content.slice(0, 500) });\n        }\n      } catch {\n        // skip unreadable files\n      }\n    }\n    return results;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/providers/store/filesystem.cjs

@@ -0,0 +1,87 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/providers/store/filesystem.ts
+var filesystem_exports = {};
+__export(filesystem_exports, {
+  FilesystemConversationStore: () => FilesystemConversationStore
+});
+module.exports = __toCommonJS(filesystem_exports);
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+var FilesystemConversationStore = class {
+  constructor(root) {
+    this.root = root;
+  }
+  root;
+  filePath(id) {
+    const safe = id.replace(/[^a-zA-Z0-9_-]/g, "_");
+    const full = (0, import_node_path.normalize)((0, import_node_path.join)(this.root, `${safe}.json`));
+    if (!full.startsWith((0, import_node_path.normalize)(this.root))) {
+      throw new Error(`invalid conversation id: ${id}`);
+    }
+    return full;
+  }
+  async save(conv) {
+    await (0, import_promises.mkdir)(this.root, { recursive: true });
+    const path = this.filePath(conv.id);
+    await (0, import_promises.writeFile)(path, JSON.stringify(conv, null, 2), "utf-8");
+  }
+  async load(id) {
+    try {
+      const raw = await (0, import_promises.readFile)(this.filePath(id), "utf-8");
+      const parsed = JSON.parse(raw);
+      parsed.createdAt = new Date(parsed.createdAt);
+      if (parsed.lastTurnAt) parsed.lastTurnAt = new Date(parsed.lastTurnAt);
+      return parsed;
+    } catch {
+      return void 0;
+    }
+  }
+  async list(threadId) {
+    try {
+      const files = await (0, import_promises.readdir)(this.root);
+      const convs = [];
+      for (const f of files) {
+        if (!f.endsWith(".json")) continue;
+        const id = f.slice(0, -5);
+        const conv = await this.load(id);
+        if (conv && (!threadId || conv.threadId === threadId)) {
+          convs.push(conv);
+        }
+      }
+      return convs.sort(
+        (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()
+      );
+    } catch {
+      return [];
+    }
+  }
+  async delete(id) {
+    try {
+      await (0, import_promises.rm)(this.filePath(id));
+    } catch {
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FilesystemConversationStore
+});
+//# sourceMappingURL=filesystem.cjs.map

package/dist/providers/store/filesystem.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/providers/store/filesystem.ts"],"sourcesContent":["import { readFile, writeFile, mkdir, rm, readdir } from \"node:fs/promises\";\nimport { join, normalize } from \"node:path\";\nimport type { ConversationStore } from \"../../conversation-store.js\";\nimport type { Conversation } from \"../../conversation.js\";\n\nexport class FilesystemConversationStore implements ConversationStore {\n  constructor(private root: string) {}\n\n  private filePath(id: string): string {\n    const safe = id.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n    const full = normalize(join(this.root, `${safe}.json`));\n    if (!full.startsWith(normalize(this.root))) {\n      throw new Error(`invalid conversation id: ${id}`);\n    }\n    return full;\n  }\n\n  async save(conv: Conversation): Promise<void> {\n    await mkdir(this.root, { recursive: true });\n    const path = this.filePath(conv.id);\n    await writeFile(path, JSON.stringify(conv, null, 2), \"utf-8\");\n  }\n\n  async load(id: string): Promise<Conversation | undefined> {\n    try {\n      const raw = await readFile(this.filePath(id), \"utf-8\");\n      const parsed = JSON.parse(raw) as Conversation;\n      parsed.createdAt = new Date(parsed.createdAt);\n      if (parsed.lastTurnAt) parsed.lastTurnAt = new Date(parsed.lastTurnAt);\n      return parsed;\n    } catch {\n      return undefined;\n    }\n  }\n\n  async list(threadId?: string): Promise<Conversation[]> {\n    try {\n      const files = await readdir(this.root);\n      const convs: Conversation[] = [];\n      for (const f of files) {\n        if (!f.endsWith(\".json\")) continue;\n        const id = f.slice(0, -5);\n        const conv = await this.load(id);\n        if (conv && (!threadId || conv.threadId === threadId)) {\n          convs.push(conv);\n        }\n      }\n      return convs.sort(\n        (a, b) =>\n          new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime(),\n      );\n    } catch {\n      return [];\n    }\n  }\n\n  async delete(id: string): Promise<void> {\n    try {\n      await rm(this.filePath(id));\n    } catch {\n      // already gone\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAwD;AACxD,uBAAgC;AAIzB,IAAM,8BAAN,MAA+D;AAAA,EACpE,YAAoB,MAAc;AAAd;AAAA,EAAe;AAAA,EAAf;AAAA,EAEZ,SAAS,IAAoB;AACnC,UAAM,OAAO,GAAG,QAAQ,mBAAmB,GAAG;AAC9C,UAAM,WAAO,gCAAU,uBAAK,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC;AACtD,QAAI,CAAC,KAAK,eAAW,4BAAU,KAAK,IAAI,CAAC,GAAG;AAC1C,YAAM,IAAI,MAAM,4BAA4B,EAAE,EAAE;AAAA,IAClD;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,KAAK,MAAmC;AAC5C,cAAM,uBAAM,KAAK,MAAM,EAAE,WAAW,KAAK,CAAC;AAC1C,UAAM,OAAO,KAAK,SAAS,KAAK,EAAE;AAClC,cAAM,2BAAU,MAAM,KAAK,UAAU,MAAM,MAAM,CAAC,GAAG,OAAO;AAAA,EAC9D;AAAA,EAEA,MAAM,KAAK,IAA+C;AACxD,QAAI;AACF,YAAM,MAAM,UAAM,0BAAS,KAAK,SAAS,EAAE,GAAG,OAAO;AACrD,YAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,aAAO,YAAY,IAAI,KAAK,OAAO,SAAS;AAC5C,UAAI,OAAO,WAAY,QAAO,aAAa,IAAI,KAAK,OAAO,UAAU;AACrE,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,KAAK,UAA4C;AACrD,QAAI;AACF,YAAM,QAAQ,UAAM,yBAAQ,KAAK,IAAI;AACrC,YAAM,QAAwB,CAAC;AAC/B,iBAAW,KAAK,OAAO;AACrB,YAAI,CAAC,EAAE,SAAS,OAAO,EAAG;AAC1B,cAAM,KAAK,EAAE,MAAM,GAAG,EAAE;AACxB,cAAM,OAAO,MAAM,KAAK,KAAK,EAAE;AAC/B,YAAI,SAAS,CAAC,YAAY,KAAK,aAAa,WAAW;AACrD,gBAAM,KAAK,IAAI;AAAA,QACjB;AAAA,MACF;AACA,aAAO,MAAM;AAAA,QACX,CAAC,GAAG,MACF,IAAI,KAAK,EAAE,SAAS,EAAE,QAAQ,IAAI,IAAI,KAAK,EAAE,SAAS,EAAE,QAAQ;AAAA,MACpE;AAAA,IACF,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,IAA2B;AACtC,QAAI;AACF,gBAAM,oBAAG,KAAK,SAAS,EAAE,CAAC;AAAA,IAC5B,QAAQ;AAAA,IAER;AAAA,EACF;AACF;","names":[]}

package/dist/providers/store/filesystem.d.cts

@@ -0,0 +1,14 @@
+import { C as ConversationStore } from '../../conversation-store-Cl42jpsA.cjs';
+import { a as Conversation } from '../../conversation-kIkMQdYK.cjs';
+
+declare class FilesystemConversationStore implements ConversationStore {
+    private root;
+    constructor(root: string);
+    private filePath;
+    save(conv: Conversation): Promise<void>;
+    load(id: string): Promise<Conversation | undefined>;
+    list(threadId?: string): Promise<Conversation[]>;
+    delete(id: string): Promise<void>;
+}
+
+export { FilesystemConversationStore };

package/dist/providers/store/filesystem.d.ts

@@ -0,0 +1,14 @@
+import { C as ConversationStore } from '../../conversation-store-CAyPuBjk.js';
+import { a as Conversation } from '../../conversation-kIkMQdYK.js';
+
+declare class FilesystemConversationStore implements ConversationStore {
+    private root;
+    constructor(root: string);
+    private filePath;
+    save(conv: Conversation): Promise<void>;
+    load(id: string): Promise<Conversation | undefined>;
+    list(threadId?: string): Promise<Conversation[]>;
+    delete(id: string): Promise<void>;
+}
+
+export { FilesystemConversationStore };

package/dist/providers/store/filesystem.js

@@ -0,0 +1,62 @@
+// src/providers/store/filesystem.ts
+import { readFile, writeFile, mkdir, rm, readdir } from "fs/promises";
+import { join, normalize } from "path";
+var FilesystemConversationStore = class {
+  constructor(root) {
+    this.root = root;
+  }
+  root;
+  filePath(id) {
+    const safe = id.replace(/[^a-zA-Z0-9_-]/g, "_");
+    const full = normalize(join(this.root, `${safe}.json`));
+    if (!full.startsWith(normalize(this.root))) {
+      throw new Error(`invalid conversation id: ${id}`);
+    }
+    return full;
+  }
+  async save(conv) {
+    await mkdir(this.root, { recursive: true });
+    const path = this.filePath(conv.id);
+    await writeFile(path, JSON.stringify(conv, null, 2), "utf-8");
+  }
+  async load(id) {
+    try {
+      const raw = await readFile(this.filePath(id), "utf-8");
+      const parsed = JSON.parse(raw);
+      parsed.createdAt = new Date(parsed.createdAt);
+      if (parsed.lastTurnAt) parsed.lastTurnAt = new Date(parsed.lastTurnAt);
+      return parsed;
+    } catch {
+      return void 0;
+    }
+  }
+  async list(threadId) {
+    try {
+      const files = await readdir(this.root);
+      const convs = [];
+      for (const f of files) {
+        if (!f.endsWith(".json")) continue;
+        const id = f.slice(0, -5);
+        const conv = await this.load(id);
+        if (conv && (!threadId || conv.threadId === threadId)) {
+          convs.push(conv);
+        }
+      }
+      return convs.sort(
+        (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()
+      );
+    } catch {
+      return [];
+    }
+  }
+  async delete(id) {
+    try {
+      await rm(this.filePath(id));
+    } catch {
+    }
+  }
+};
+export {
+  FilesystemConversationStore
+};
+//# sourceMappingURL=filesystem.js.map

package/dist/providers/store/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/providers/store/filesystem.ts"],"sourcesContent":["import { readFile, writeFile, mkdir, rm, readdir } from \"node:fs/promises\";\nimport { join, normalize } from \"node:path\";\nimport type { ConversationStore } from \"../../conversation-store.js\";\nimport type { Conversation } from \"../../conversation.js\";\n\nexport class FilesystemConversationStore implements ConversationStore {\n  constructor(private root: string) {}\n\n  private filePath(id: string): string {\n    const safe = id.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n    const full = normalize(join(this.root, `${safe}.json`));\n    if (!full.startsWith(normalize(this.root))) {\n      throw new Error(`invalid conversation id: ${id}`);\n    }\n    return full;\n  }\n\n  async save(conv: Conversation): Promise<void> {\n    await mkdir(this.root, { recursive: true });\n    const path = this.filePath(conv.id);\n    await writeFile(path, JSON.stringify(conv, null, 2), \"utf-8\");\n  }\n\n  async load(id: string): Promise<Conversation | undefined> {\n    try {\n      const raw = await readFile(this.filePath(id), \"utf-8\");\n      const parsed = JSON.parse(raw) as Conversation;\n      parsed.createdAt = new Date(parsed.createdAt);\n      if (parsed.lastTurnAt) parsed.lastTurnAt = new Date(parsed.lastTurnAt);\n      return parsed;\n    } catch {\n      return undefined;\n    }\n  }\n\n  async list(threadId?: string): Promise<Conversation[]> {\n    try {\n      const files = await readdir(this.root);\n      const convs: Conversation[] = [];\n      for (const f of files) {\n        if (!f.endsWith(\".json\")) continue;\n        const id = f.slice(0, -5);\n        const conv = await this.load(id);\n        if (conv && (!threadId || conv.threadId === threadId)) {\n          convs.push(conv);\n        }\n      }\n      return convs.sort(\n        (a, b) =>\n          new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime(),\n      );\n    } catch {\n      return [];\n    }\n  }\n\n  async delete(id: string): Promise<void> {\n    try {\n      await rm(this.filePath(id));\n    } catch {\n      // already gone\n    }\n  }\n}\n"],"mappings":";AAAA,SAAS,UAAU,WAAW,OAAO,IAAI,eAAe;AACxD,SAAS,MAAM,iBAAiB;AAIzB,IAAM,8BAAN,MAA+D;AAAA,EACpE,YAAoB,MAAc;AAAd;AAAA,EAAe;AAAA,EAAf;AAAA,EAEZ,SAAS,IAAoB;AACnC,UAAM,OAAO,GAAG,QAAQ,mBAAmB,GAAG;AAC9C,UAAM,OAAO,UAAU,KAAK,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC;AACtD,QAAI,CAAC,KAAK,WAAW,UAAU,KAAK,IAAI,CAAC,GAAG;AAC1C,YAAM,IAAI,MAAM,4BAA4B,EAAE,EAAE;AAAA,IAClD;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,KAAK,MAAmC;AAC5C,UAAM,MAAM,KAAK,MAAM,EAAE,WAAW,KAAK,CAAC;AAC1C,UAAM,OAAO,KAAK,SAAS,KAAK,EAAE;AAClC,UAAM,UAAU,MAAM,KAAK,UAAU,MAAM,MAAM,CAAC,GAAG,OAAO;AAAA,EAC9D;AAAA,EAEA,MAAM,KAAK,IAA+C;AACxD,QAAI;AACF,YAAM,MAAM,MAAM,SAAS,KAAK,SAAS,EAAE,GAAG,OAAO;AACrD,YAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,aAAO,YAAY,IAAI,KAAK,OAAO,SAAS;AAC5C,UAAI,OAAO,WAAY,QAAO,aAAa,IAAI,KAAK,OAAO,UAAU;AACrE,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,KAAK,UAA4C;AACrD,QAAI;AACF,YAAM,QAAQ,MAAM,QAAQ,KAAK,IAAI;AACrC,YAAM,QAAwB,CAAC;AAC/B,iBAAW,KAAK,OAAO;AACrB,YAAI,CAAC,EAAE,SAAS,OAAO,EAAG;AAC1B,cAAM,KAAK,EAAE,MAAM,GAAG,EAAE;AACxB,cAAM,OAAO,MAAM,KAAK,KAAK,EAAE;AAC/B,YAAI,SAAS,CAAC,YAAY,KAAK,aAAa,WAAW;AACrD,gBAAM,KAAK,IAAI;AAAA,QACjB;AAAA,MACF;AACA,aAAO,MAAM;AAAA,QACX,CAAC,GAAG,MACF,IAAI,KAAK,EAAE,SAAS,EAAE,QAAQ,IAAI,IAAI,KAAK,EAAE,SAAS,EAAE,QAAQ;AAAA,MACpE;AAAA,IACF,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,IAA2B;AACtC,QAAI;AACF,YAAM,GAAG,KAAK,SAAS,EAAE,CAAC;AAAA,IAC5B,QAAQ;AAAA,IAER;AAAA,EACF;AACF;","names":[]}

package/dist/providers/thread/memory.cjs

@@ -0,0 +1,81 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/providers/thread/memory.ts
+var memory_exports = {};
+__export(memory_exports, {
+  InMemoryThreadProvider: () => InMemoryThreadProvider
+});
+module.exports = __toCommonJS(memory_exports);
+var import_node_crypto = require("crypto");
+
+// src/thread.ts
+var ErrThreadAccessDenied = new Error("thread: access denied");
+
+// src/providers/thread/memory.ts
+var InMemoryThreadProvider = class {
+  threads = /* @__PURE__ */ new Map();
+  async create(projectId, modeId) {
+    const t = {
+      id: (0, import_node_crypto.randomUUID)(),
+      projectId,
+      modeId,
+      status: "active"
+    };
+    this.threads.set(t.id, t);
+    return t;
+  }
+  async createForUser(userId, projectId, modeId) {
+    const t = {
+      id: (0, import_node_crypto.randomUUID)(),
+      userId,
+      projectId,
+      modeId,
+      status: "active"
+    };
+    this.threads.set(t.id, t);
+    return t;
+  }
+  async get(threadId) {
+    const t = this.threads.get(threadId);
+    if (!t) throw new Error(`thread not found: ${threadId}`);
+    return t;
+  }
+  async getForUser(userId, threadId) {
+    const t = await this.get(threadId);
+    if (t.userId && t.userId !== userId) throw ErrThreadAccessDenied;
+    return t;
+  }
+  async listByUser(userId, status) {
+    return Array.from(this.threads.values()).filter(
+      (t) => t.userId === userId && (!status || t.status === status)
+    );
+  }
+  async archive(threadId) {
+    const t = await this.get(threadId);
+    t.status = "archived";
+  }
+  async sendMessage(_msg) {
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InMemoryThreadProvider
+});
+//# sourceMappingURL=memory.cjs.map

package/dist/providers/thread/memory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/providers/thread/memory.ts","../../../src/thread.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type {\n  ThreadProvider,\n  MultiUserThreadProvider,\n  Thread,\n  ThreadStatus,\n  Message,\n} from \"../../thread.js\";\nimport { ErrThreadAccessDenied } from \"../../thread.js\";\n\nexport class InMemoryThreadProvider implements MultiUserThreadProvider {\n  private threads = new Map<string, Thread>();\n\n  async create(projectId: string, modeId: string): Promise<Thread> {\n    const t: Thread = {\n      id: randomUUID(),\n      projectId,\n      modeId,\n      status: \"active\",\n    };\n    this.threads.set(t.id, t);\n    return t;\n  }\n\n  async createForUser(\n    userId: string,\n    projectId: string,\n    modeId: string,\n  ): Promise<Thread> {\n    const t: Thread = {\n      id: randomUUID(),\n      userId,\n      projectId,\n      modeId,\n      status: \"active\",\n    };\n    this.threads.set(t.id, t);\n    return t;\n  }\n\n  async get(threadId: string): Promise<Thread> {\n    const t = this.threads.get(threadId);\n    if (!t) throw new Error(`thread not found: ${threadId}`);\n    return t;\n  }\n\n  async getForUser(userId: string, threadId: string): Promise<Thread> {\n    const t = await this.get(threadId);\n    if (t.userId && t.userId !== userId) throw ErrThreadAccessDenied;\n    return t;\n  }\n\n  async listByUser(userId: string, status: ThreadStatus): Promise<Thread[]> {\n    return Array.from(this.threads.values()).filter(\n      (t) => t.userId === userId && (!status || t.status === status),\n    );\n  }\n\n  async archive(threadId: string): Promise<void> {\n    const t = await this.get(threadId);\n    t.status = \"archived\";\n  }\n\n  async sendMessage(_msg: Message): Promise<void> {\n    // in-memory: drop messages\n  }\n}\n","export type ThreadStatus = \"active\" | \"completed\" | \"failed\" | \"archived\";\n\nexport interface Thread {\n  id: string;\n  userId?: string;\n  projectId?: string;\n  modeId?: string;\n  status: ThreadStatus;\n  parentId?: string;\n}\n\nexport interface Message {\n  id?: string;\n  fromThreadId: string;\n  toThreadId: string;\n  content: string;\n  sentAt?: Date;\n}\n\nexport interface ThreadProvider {\n  create(projectId: string, modeId: string, signal?: AbortSignal): Promise<Thread>;\n  get(threadId: string, signal?: AbortSignal): Promise<Thread>;\n  archive(threadId: string, signal?: AbortSignal): Promise<void>;\n  sendMessage(msg: Message, signal?: AbortSignal): Promise<void>;\n}\n\nexport interface MultiUserThreadProvider extends ThreadProvider {\n  createForUser(userId: string, projectId: string, modeId: string, signal?: AbortSignal): Promise<Thread>;\n  getForUser(userId: string, threadId: string, signal?: AbortSignal): Promise<Thread>;\n  listByUser(userId: string, status: ThreadStatus, signal?: AbortSignal): Promise<Thread[]>;\n}\n\nexport const ErrThreadAccessDenied = new Error(\"thread: access denied\");\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAA2B;;;ACgCpB,IAAM,wBAAwB,IAAI,MAAM,uBAAuB;;;ADtB/D,IAAM,yBAAN,MAAgE;AAAA,EAC7D,UAAU,oBAAI,IAAoB;AAAA,EAE1C,MAAM,OAAO,WAAmB,QAAiC;AAC/D,UAAM,IAAY;AAAA,MAChB,QAAI,+BAAW;AAAA,MACf;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,IACV;AACA,SAAK,QAAQ,IAAI,EAAE,IAAI,CAAC;AACxB,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,cACJ,QACA,WACA,QACiB;AACjB,UAAM,IAAY;AAAA,MAChB,QAAI,+BAAW;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,IACV;AACA,SAAK,QAAQ,IAAI,EAAE,IAAI,CAAC;AACxB,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,IAAI,UAAmC;AAC3C,UAAM,IAAI,KAAK,QAAQ,IAAI,QAAQ;AACnC,QAAI,CAAC,EAAG,OAAM,IAAI,MAAM,qBAAqB,QAAQ,EAAE;AACvD,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,WAAW,QAAgB,UAAmC;AAClE,UAAM,IAAI,MAAM,KAAK,IAAI,QAAQ;AACjC,QAAI,EAAE,UAAU,EAAE,WAAW,OAAQ,OAAM;AAC3C,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,WAAW,QAAgB,QAAyC;AACxE,WAAO,MAAM,KAAK,KAAK,QAAQ,OAAO,CAAC,EAAE;AAAA,MACvC,CAAC,MAAM,EAAE,WAAW,WAAW,CAAC,UAAU,EAAE,WAAW;AAAA,IACzD;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,UAAiC;AAC7C,UAAM,IAAI,MAAM,KAAK,IAAI,QAAQ;AACjC,MAAE,SAAS;AAAA,EACb;AAAA,EAEA,MAAM,YAAY,MAA8B;AAAA,EAEhD;AACF;","names":[]}

package/dist/providers/thread/memory.d.cts

@@ -0,0 +1,14 @@
+import { a as MultiUserThreadProvider, T as Thread, c as ThreadStatus, M as Message } from '../../thread-C2b9xRMJ.cjs';
+
+declare class InMemoryThreadProvider implements MultiUserThreadProvider {
+    private threads;
+    create(projectId: string, modeId: string): Promise<Thread>;
+    createForUser(userId: string, projectId: string, modeId: string): Promise<Thread>;
+    get(threadId: string): Promise<Thread>;
+    getForUser(userId: string, threadId: string): Promise<Thread>;
+    listByUser(userId: string, status: ThreadStatus): Promise<Thread[]>;
+    archive(threadId: string): Promise<void>;
+    sendMessage(_msg: Message): Promise<void>;
+}
+
+export { InMemoryThreadProvider };

package/dist/providers/thread/memory.d.ts

@@ -0,0 +1,14 @@
+import { a as MultiUserThreadProvider, T as Thread, c as ThreadStatus, M as Message } from '../../thread-C2b9xRMJ.js';
+
+declare class InMemoryThreadProvider implements MultiUserThreadProvider {
+    private threads;
+    create(projectId: string, modeId: string): Promise<Thread>;
+    createForUser(userId: string, projectId: string, modeId: string): Promise<Thread>;
+    get(threadId: string): Promise<Thread>;
+    getForUser(userId: string, threadId: string): Promise<Thread>;
+    listByUser(userId: string, status: ThreadStatus): Promise<Thread[]>;
+    archive(threadId: string): Promise<void>;
+    sendMessage(_msg: Message): Promise<void>;
+}
+
+export { InMemoryThreadProvider };