@agentscope-ai/agentscope 0.0.2

package/dist/storage/index.js

@@ -0,0 +1,250 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/storage/index.ts
+var storage_exports = {};
+__export(storage_exports, {
+  LocalFileStorage: () => LocalFileStorage,
+  StorageBase: () => StorageBase
+});
+module.exports = __toCommonJS(storage_exports);
+
+// src/storage/base.ts
+var StorageBase = class {
+  /**
+   * Offload the compressed context to external storage for agentic search if needed.
+   * @param _options.msgs
+   * @param _options
+   * @returns The identifier or URL of the offloaded context, or undefined if offloading is not implemented or not needed
+   */
+  async offloadContext(_options) {
+    console.log("Offloading context is not implemented for this storage. Skipping offloading.");
+    return void 0;
+  }
+};
+
+// src/storage/file-system.ts
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var mime = __toESM(require("mime-types"));
+var LocalFileStorage = class extends StorageBase {
+  saveDir;
+  offloadDir;
+  /**
+   * Internal metadata key prefix for storage-layer fields.
+   * Fields with this prefix are managed by storage and filtered out when returning to agent layer.
+   */
+  INTERNAL_PREFIX = "_storage_";
+  /**
+   * Initialize a LocalFileStorage instance.
+   * @param root0
+   * @param root0.pathSegments - Path segments to determine the directory for saving agent state (e.g. ['rootDir', '{sessionId}'])
+   * @param root0.offloadPathSegments - Optional path segments for offloading compressed context for agentic search (e.g. ['rootDir', 'offload'])
+   */
+  constructor({
+    pathSegments = [],
+    offloadPathSegments = []
+  }) {
+    super();
+    this.saveDir = import_path.default.join(...pathSegments);
+    this.offloadDir = offloadPathSegments.length > 0 ? import_path.default.join(...offloadPathSegments) : void 0;
+  }
+  /**
+   * Load the complete agent state including context and metadata.
+   * @param options
+   * @param options.agentId - The agent identifier
+   * @returns The agent state with context and metadata (internal fields filtered out)
+   */
+  async loadAgentState(options) {
+    const agentDir = import_path.default.join(this.saveDir, options?.agentId || "");
+    if (!import_fs.default.existsSync(agentDir)) {
+      console.log(`Agent directory ${agentDir} does not exist. Returning empty state.`);
+      return {
+        context: [],
+        metadata: {}
+      };
+    }
+    console.log(`Loading agent state from directory: ${agentDir}`);
+    const contextFile = import_path.default.join(agentDir, "context.jsonl");
+    const stateFile = import_path.default.join(agentDir, "state.json");
+    let metadata = {};
+    if (import_fs.default.existsSync(stateFile)) {
+      const content = import_fs.default.readFileSync(stateFile, "utf-8");
+      metadata = JSON.parse(content);
+    }
+    const compressionBoundaryMsgId = metadata[`${this.INTERNAL_PREFIX}compressionBoundaryMsgId`];
+    let context = [];
+    if (import_fs.default.existsSync(contextFile)) {
+      const content = import_fs.default.readFileSync(contextFile, "utf-8");
+      const allMsgs = content.trim().split("\n").filter((line) => line.length > 0).map((line) => JSON.parse(line));
+      if (compressionBoundaryMsgId) {
+        const boundaryIndex = allMsgs.findIndex((msg) => msg.id === compressionBoundaryMsgId);
+        if (boundaryIndex !== -1) {
+          context = allMsgs.slice(boundaryIndex);
+        } else {
+          context = allMsgs;
+        }
+      } else {
+        context = allMsgs;
+      }
+    }
+    const publicMetadata = this._filterInternalFields(metadata);
+    return {
+      context,
+      metadata: publicMetadata
+    };
+  }
+  /**
+   * Save the complete agent state including context and metadata.
+   * @param options
+   * @param options.agentId - The agent identifier
+   * @param options.context - The conversation context to save
+   * @param options.metadata - The agent metadata to save
+   */
+  async saveAgentState(options) {
+    const agentDir = import_path.default.join(this.saveDir, options.agentId || "");
+    const contextFile = import_path.default.join(agentDir, "context.jsonl");
+    const stateFile = import_path.default.join(agentDir, "state.json");
+    if (!import_fs.default.existsSync(agentDir)) {
+      import_fs.default.mkdirSync(agentDir, { recursive: true });
+    }
+    const compressionBoundaryMsgId = options.context[0]?.id;
+    if (!import_fs.default.existsSync(contextFile)) {
+      const content = options.context.map((msg) => JSON.stringify(msg)).join("\n");
+      if (content) {
+        import_fs.default.writeFileSync(contextFile, content + "\n", "utf-8");
+      }
+    } else {
+      const existingContent = import_fs.default.readFileSync(contextFile, "utf-8");
+      const existingLines = existingContent.trim().split("\n").filter((line) => line.length > 0);
+      if (existingLines.length > 0) {
+        const lastLine = existingLines[existingLines.length - 1];
+        const lastMsg = JSON.parse(lastLine);
+        const lastMsgIndex = options.context.findIndex((msg) => msg.id === lastMsg.id);
+        const newMsgs = lastMsgIndex >= 0 ? options.context.slice(lastMsgIndex) : options.context;
+        if (newMsgs.length > 0) {
+          const allLines = [
+            ...existingLines.slice(0, -1),
+            ...newMsgs.map((msg) => JSON.stringify(msg))
+          ];
+          const content = allLines.join("\n") + "\n";
+          import_fs.default.writeFileSync(contextFile, content, "utf-8");
+        }
+      } else {
+        const content = options.context.map((msg) => JSON.stringify(msg)).join("\n");
+        if (content) {
+          import_fs.default.writeFileSync(contextFile, content + "\n", "utf-8");
+        }
+      }
+    }
+    const internalMetadata = {
+      ...options.metadata,
+      [`${this.INTERNAL_PREFIX}compressionBoundaryMsgId`]: compressionBoundaryMsgId
+    };
+    import_fs.default.writeFileSync(stateFile, JSON.stringify(internalMetadata, null, 2), "utf-8");
+  }
+  /**
+   * Filter out internal storage fields from metadata.
+   * @param metadata - The metadata object
+   * @returns Metadata with internal fields removed
+   */
+  _filterInternalFields(metadata) {
+    const filtered = {};
+    for (const [key, value] of Object.entries(metadata)) {
+      if (!key.startsWith(this.INTERNAL_PREFIX)) {
+        filtered[key] = value;
+      }
+    }
+    return filtered;
+  }
+  /**
+   * Offload the compressed context to external storage for agentic search if needed.
+   * @param options
+   * @param options.agentId - The agent identifier
+   * @param options.msgs - The messages to offload
+   * @returns The file path of the offloaded context, or undefined if offloading is not implemented or not needed
+   */
+  async offloadContext(options) {
+    if (!this.offloadDir) {
+      return;
+    }
+    const fileName = `${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.txt`;
+    const offloadFile = import_path.default.join(this.offloadDir, options.agentId || "", fileName);
+    const offloadDataDir = import_path.default.join(this.offloadDir, options.agentId || "", "data");
+    const offloadAgentDir = import_path.default.dirname(offloadFile);
+    if (!import_fs.default.existsSync(offloadAgentDir)) {
+      import_fs.default.mkdirSync(offloadAgentDir, { recursive: true });
+    }
+    let appendContent = "";
+    for (const msg of options.msgs) {
+      const msgContent = [];
+      for (const block of msg.content) {
+        switch (block.type) {
+          case "text":
+            msgContent.push(`${msg.name}: ${block.text}`);
+            break;
+          case "data":
+            if (block.source.type === "url") {
+              msgContent.push(
+                `${msg.name}: <data src={${block.source.url}} type={${block.source.mediaType}} />`
+              );
+            } else if (block.source.type === "base64") {
+              const mainType = block.source.mediaType.split("/")[0];
+              const extension2 = mime.extension(block.source.mediaType) || "bin";
+              const filePath = import_path.default.join(
+                offloadDataDir,
+                `${mainType}-${Date.now()}.${extension2}`
+              );
+              if (!import_fs.default.existsSync(offloadDataDir)) {
+                import_fs.default.mkdirSync(offloadDataDir, { recursive: true });
+              }
+              const buffer = Buffer.from(block.source.data, "base64");
+              import_fs.default.writeFileSync(filePath, buffer);
+              msgContent.push(
+                `${msg.name}: <data src={${filePath}} type={${block.source.mediaType}} />`
+              );
+            }
+            break;
+          case "tool_call":
+            msgContent.push(`${msg.name}: Calling tool ${block.name} ...`);
+            break;
+        }
+      }
+      appendContent += msgContent.join("\n") + "\n";
+    }
+    import_fs.default.appendFileSync(offloadFile, appendContent, "utf-8");
+    return offloadFile;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LocalFileStorage,
+  StorageBase
+});
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/index.ts","../../src/storage/base.ts","../../src/storage/file-system.ts"],"sourcesContent":["export { AgentState, StorageBase } from './base';\nexport { LocalFileStorage } from './file-system';\n","import { Msg } from '../message';\n\n/**\n * The complete agent state including both conversation context and metadata.\n */\nexport interface AgentState {\n    /**\n     * The conversation context (message history).\n     */\n    context: Msg[];\n    /**\n     * Agent metadata (replyId, curIter, curSummary, etc.).\n     */\n    metadata: Record<string, unknown>;\n}\n\n/**\n * The base storage class that responsible for\n * - loading/saving agent context and state, and\n * - offloading compressed context to external storage for agentic search if needed\n */\nexport abstract class StorageBase {\n    /**\n     * Load the complete agent state including context and metadata.\n     * @param options.agentId - The agent identifier\n     * @returns The agent state with context and metadata\n     */\n    abstract loadAgentState(options?: { agentId?: string }): Promise<AgentState>;\n\n    /**\n     * Save the complete agent state including context and metadata.\n     * @param options.agentId - The agent identifier\n     * @param options.context - The conversation context to save\n     * @param options.metadata - The agent metadata to save\n     */\n    abstract saveAgentState(options: {\n        agentId?: string;\n        context: Msg[];\n        metadata: Record<string, unknown>;\n    }): Promise<void>;\n\n    /**\n     * Offload the compressed context to external storage for agentic search if needed.\n     * @param _options.msgs\n     * @param _options\n     * @returns The identifier or URL of the offloaded context, or undefined if offloading is not implemented or not needed\n     */\n    async offloadContext(_options: { msgs: Msg[] }): Promise<string | undefined> {\n        console.log('Offloading context is not implemented for this storage. Skipping offloading.');\n        return undefined;\n    }\n}\n","import fs from 'fs';\nimport path from 'path';\n\nimport * as mime from 'mime-types';\n\nimport { Msg } from '../message';\nimport { AgentState, StorageBase } from './base';\n\n/**\n * Local file system storage implementation.\n * Stores agent state in JSON files with support for incremental context updates.\n */\nexport class LocalFileStorage extends StorageBase {\n    saveDir: string;\n    offloadDir?: string;\n\n    /**\n     * Internal metadata key prefix for storage-layer fields.\n     * Fields with this prefix are managed by storage and filtered out when returning to agent layer.\n     */\n    private readonly INTERNAL_PREFIX = '_storage_';\n\n    /**\n     * Initialize a LocalFileStorage instance.\n     * @param root0\n     * @param root0.pathSegments - Path segments to determine the directory for saving agent state (e.g. ['rootDir', '{sessionId}'])\n     * @param root0.offloadPathSegments - Optional path segments for offloading compressed context for agentic search (e.g. ['rootDir', 'offload'])\n     */\n    constructor({\n        pathSegments = [],\n        offloadPathSegments = [],\n    }: {\n        pathSegments?: string[];\n        offloadPathSegments?: string[];\n    }) {\n        super();\n        this.saveDir = path.join(...pathSegments);\n        this.offloadDir =\n            offloadPathSegments.length > 0 ? path.join(...offloadPathSegments) : undefined;\n    }\n\n    /**\n     * Load the complete agent state including context and metadata.\n     * @param options\n     * @param options.agentId - The agent identifier\n     * @returns The agent state with context and metadata (internal fields filtered out)\n     */\n    async loadAgentState(options?: { agentId?: string }): Promise<AgentState> {\n        const agentDir = path.join(this.saveDir, options?.agentId || '');\n\n        // If the agent directory doesn't exist, return empty state\n        if (!fs.existsSync(agentDir)) {\n            console.log(`Agent directory ${agentDir} does not exist. Returning empty state.`);\n            return {\n                context: [],\n                metadata: {},\n            };\n        }\n        console.log(`Loading agent state from directory: ${agentDir}`);\n\n        const contextFile = path.join(agentDir, 'context.jsonl');\n        const stateFile = path.join(agentDir, 'state.json');\n\n        // Load metadata\n        let metadata: Record<string, unknown> = {};\n        if (fs.existsSync(stateFile)) {\n            const content = fs.readFileSync(stateFile, 'utf-8');\n            metadata = JSON.parse(content);\n        }\n\n        // Extract internal compression boundary ID\n        const compressionBoundaryMsgId = metadata[\n            `${this.INTERNAL_PREFIX}compressionBoundaryMsgId`\n        ] as string | undefined;\n\n        // Load context (incrementally if compression boundary exists)\n        let context: Msg[] = [];\n        if (fs.existsSync(contextFile)) {\n            const content = fs.readFileSync(contextFile, 'utf-8');\n            const allMsgs = content\n                .trim()\n                .split('\\n')\n                .filter(line => line.length > 0)\n                .map(line => JSON.parse(line));\n\n            if (compressionBoundaryMsgId) {\n                // Load only messages after the compression boundary\n                const boundaryIndex = allMsgs.findIndex(msg => msg.id === compressionBoundaryMsgId);\n                if (boundaryIndex !== -1) {\n                    // Include the boundary message itself\n                    context = allMsgs.slice(boundaryIndex);\n                } else {\n                    // Boundary not found, load all messages\n                    context = allMsgs;\n                }\n            } else {\n                // No compression, load all messages\n                context = allMsgs;\n            }\n        }\n\n        // Filter out internal fields from metadata before returning\n        const publicMetadata = this._filterInternalFields(metadata);\n\n        return {\n            context,\n            metadata: publicMetadata,\n        };\n    }\n\n    /**\n     * Save the complete agent state including context and metadata.\n     * @param options\n     * @param options.agentId - The agent identifier\n     * @param options.context - The conversation context to save\n     * @param options.metadata - The agent metadata to save\n     */\n    async saveAgentState(options: {\n        agentId?: string;\n        context: Msg[];\n        metadata: Record<string, unknown>;\n    }): Promise<void> {\n        const agentDir = path.join(this.saveDir, options.agentId || '');\n        const contextFile = path.join(agentDir, 'context.jsonl');\n        const stateFile = path.join(agentDir, 'state.json');\n\n        // Ensure directory exists\n        if (!fs.existsSync(agentDir)) {\n            fs.mkdirSync(agentDir, { recursive: true });\n        }\n\n        // Determine compression boundary (first message in current context)\n        const compressionBoundaryMsgId = options.context[0]?.id;\n\n        // Save context with incremental append optimization\n        if (!fs.existsSync(contextFile)) {\n            // First time: write all messages\n            const content = options.context.map(msg => JSON.stringify(msg)).join('\\n');\n            if (content) {\n                fs.writeFileSync(contextFile, content + '\\n', 'utf-8');\n            }\n        } else {\n            // File exists: append only new messages\n            const existingContent = fs.readFileSync(contextFile, 'utf-8');\n            const existingLines = existingContent\n                .trim()\n                .split('\\n')\n                .filter(line => line.length > 0);\n\n            if (existingLines.length > 0) {\n                const lastLine = existingLines[existingLines.length - 1];\n                const lastMsg = JSON.parse(lastLine);\n\n                // Find new messages that need to be saved (including the last saved message to overwrite it)\n                const lastMsgIndex = options.context.findIndex(msg => msg.id === lastMsg.id);\n                const newMsgs =\n                    lastMsgIndex >= 0 ? options.context.slice(lastMsgIndex) : options.context;\n\n                if (newMsgs.length > 0) {\n                    // Combine existing messages (without last line) with new messages\n                    const allLines = [\n                        ...existingLines.slice(0, -1),\n                        ...newMsgs.map(msg => JSON.stringify(msg)),\n                    ];\n                    const content = allLines.join('\\n') + '\\n';\n                    fs.writeFileSync(contextFile, content, 'utf-8');\n                }\n            } else {\n                // File is empty, write all messages\n                const content = options.context.map(msg => JSON.stringify(msg)).join('\\n');\n                if (content) {\n                    fs.writeFileSync(contextFile, content + '\\n', 'utf-8');\n                }\n            }\n        }\n\n        // Save metadata with internal compression boundary\n        const internalMetadata = {\n            ...options.metadata,\n            [`${this.INTERNAL_PREFIX}compressionBoundaryMsgId`]: compressionBoundaryMsgId,\n        };\n        fs.writeFileSync(stateFile, JSON.stringify(internalMetadata, null, 2), 'utf-8');\n    }\n\n    /**\n     * Filter out internal storage fields from metadata.\n     * @param metadata - The metadata object\n     * @returns Metadata with internal fields removed\n     */\n    private _filterInternalFields(metadata: Record<string, unknown>): Record<string, unknown> {\n        const filtered: Record<string, unknown> = {};\n        for (const [key, value] of Object.entries(metadata)) {\n            if (!key.startsWith(this.INTERNAL_PREFIX)) {\n                filtered[key] = value;\n            }\n        }\n        return filtered;\n    }\n\n    /**\n     * Offload the compressed context to external storage for agentic search if needed.\n     * @param options\n     * @param options.agentId - The agent identifier\n     * @param options.msgs - The messages to offload\n     * @returns The file path of the offloaded context, or undefined if offloading is not implemented or not needed\n     */\n    async offloadContext(options: { agentId?: string; msgs: Msg[] }): Promise<string | undefined> {\n        if (!this.offloadDir) {\n            return;\n        }\n\n        // Offload the compressed context to the text file\n        // e.g. 2026-03-01.txt\n        const fileName = `${new Date().toISOString().split('T')[0]}.txt`;\n        const offloadFile = path.join(this.offloadDir, options.agentId || '', fileName);\n        const offloadDataDir = path.join(this.offloadDir, options.agentId || '', 'data');\n\n        // Create the dir if it doesn't exist\n        const offloadAgentDir = path.dirname(offloadFile);\n        if (!fs.existsSync(offloadAgentDir)) {\n            fs.mkdirSync(offloadAgentDir, { recursive: true });\n        }\n\n        // Append the new context to the offload file\n        let appendContent = '';\n        for (const msg of options.msgs) {\n            const msgContent: string[] = [];\n            for (const block of msg.content) {\n                switch (block.type) {\n                    case 'text':\n                        msgContent.push(`${msg.name}: ${block.text}`);\n                        break;\n                    case 'data':\n                        if (block.source.type === 'url') {\n                            msgContent.push(\n                                `${msg.name}: <data src={${block.source.url}} type={${block.source.mediaType}} />`\n                            );\n                        } else if (block.source.type === 'base64') {\n                            // Save the base64 data to a file and add a reference to the file in the offload content\n                            const mainType = block.source.mediaType.split('/')[0];\n                            const extension = mime.extension(block.source.mediaType) || 'bin';\n                            const filePath = path.join(\n                                offloadDataDir,\n                                `${mainType}-${Date.now()}.${extension}`\n                            );\n                            if (!fs.existsSync(offloadDataDir)) {\n                                fs.mkdirSync(offloadDataDir, { recursive: true });\n                            }\n                            const buffer = Buffer.from(block.source.data, 'base64');\n                            fs.writeFileSync(filePath, buffer);\n                            msgContent.push(\n                                `${msg.name}: <data src={${filePath}} type={${block.source.mediaType}} />`\n                            );\n                        }\n                        break;\n                    case 'tool_call':\n                        msgContent.push(`${msg.name}: Calling tool ${block.name} ...`);\n                        break;\n                }\n            }\n            appendContent += msgContent.join('\\n') + '\\n';\n        }\n\n        // Append to the offload file\n        fs.appendFileSync(offloadFile, appendContent, 'utf-8');\n\n        return offloadFile;\n    }\n}\n"],"mappings":"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","names":["path","fs","extension"]}

package/dist/storage/index.mjs

@@ -0,0 +1,212 @@
+// src/storage/base.ts
+var StorageBase = class {
+  /**
+   * Offload the compressed context to external storage for agentic search if needed.
+   * @param _options.msgs
+   * @param _options
+   * @returns The identifier or URL of the offloaded context, or undefined if offloading is not implemented or not needed
+   */
+  async offloadContext(_options) {
+    console.log("Offloading context is not implemented for this storage. Skipping offloading.");
+    return void 0;
+  }
+};
+
+// src/storage/file-system.ts
+import fs from "fs";
+import path from "path";
+import * as mime from "mime-types";
+var LocalFileStorage = class extends StorageBase {
+  saveDir;
+  offloadDir;
+  /**
+   * Internal metadata key prefix for storage-layer fields.
+   * Fields with this prefix are managed by storage and filtered out when returning to agent layer.
+   */
+  INTERNAL_PREFIX = "_storage_";
+  /**
+   * Initialize a LocalFileStorage instance.
+   * @param root0
+   * @param root0.pathSegments - Path segments to determine the directory for saving agent state (e.g. ['rootDir', '{sessionId}'])
+   * @param root0.offloadPathSegments - Optional path segments for offloading compressed context for agentic search (e.g. ['rootDir', 'offload'])
+   */
+  constructor({
+    pathSegments = [],
+    offloadPathSegments = []
+  }) {
+    super();
+    this.saveDir = path.join(...pathSegments);
+    this.offloadDir = offloadPathSegments.length > 0 ? path.join(...offloadPathSegments) : void 0;
+  }
+  /**
+   * Load the complete agent state including context and metadata.
+   * @param options
+   * @param options.agentId - The agent identifier
+   * @returns The agent state with context and metadata (internal fields filtered out)
+   */
+  async loadAgentState(options) {
+    const agentDir = path.join(this.saveDir, options?.agentId || "");
+    if (!fs.existsSync(agentDir)) {
+      console.log(`Agent directory ${agentDir} does not exist. Returning empty state.`);
+      return {
+        context: [],
+        metadata: {}
+      };
+    }
+    console.log(`Loading agent state from directory: ${agentDir}`);
+    const contextFile = path.join(agentDir, "context.jsonl");
+    const stateFile = path.join(agentDir, "state.json");
+    let metadata = {};
+    if (fs.existsSync(stateFile)) {
+      const content = fs.readFileSync(stateFile, "utf-8");
+      metadata = JSON.parse(content);
+    }
+    const compressionBoundaryMsgId = metadata[`${this.INTERNAL_PREFIX}compressionBoundaryMsgId`];
+    let context = [];
+    if (fs.existsSync(contextFile)) {
+      const content = fs.readFileSync(contextFile, "utf-8");
+      const allMsgs = content.trim().split("\n").filter((line) => line.length > 0).map((line) => JSON.parse(line));
+      if (compressionBoundaryMsgId) {
+        const boundaryIndex = allMsgs.findIndex((msg) => msg.id === compressionBoundaryMsgId);
+        if (boundaryIndex !== -1) {
+          context = allMsgs.slice(boundaryIndex);
+        } else {
+          context = allMsgs;
+        }
+      } else {
+        context = allMsgs;
+      }
+    }
+    const publicMetadata = this._filterInternalFields(metadata);
+    return {
+      context,
+      metadata: publicMetadata
+    };
+  }
+  /**
+   * Save the complete agent state including context and metadata.
+   * @param options
+   * @param options.agentId - The agent identifier
+   * @param options.context - The conversation context to save
+   * @param options.metadata - The agent metadata to save
+   */
+  async saveAgentState(options) {
+    const agentDir = path.join(this.saveDir, options.agentId || "");
+    const contextFile = path.join(agentDir, "context.jsonl");
+    const stateFile = path.join(agentDir, "state.json");
+    if (!fs.existsSync(agentDir)) {
+      fs.mkdirSync(agentDir, { recursive: true });
+    }
+    const compressionBoundaryMsgId = options.context[0]?.id;
+    if (!fs.existsSync(contextFile)) {
+      const content = options.context.map((msg) => JSON.stringify(msg)).join("\n");
+      if (content) {
+        fs.writeFileSync(contextFile, content + "\n", "utf-8");
+      }
+    } else {
+      const existingContent = fs.readFileSync(contextFile, "utf-8");
+      const existingLines = existingContent.trim().split("\n").filter((line) => line.length > 0);
+      if (existingLines.length > 0) {
+        const lastLine = existingLines[existingLines.length - 1];
+        const lastMsg = JSON.parse(lastLine);
+        const lastMsgIndex = options.context.findIndex((msg) => msg.id === lastMsg.id);
+        const newMsgs = lastMsgIndex >= 0 ? options.context.slice(lastMsgIndex) : options.context;
+        if (newMsgs.length > 0) {
+          const allLines = [
+            ...existingLines.slice(0, -1),
+            ...newMsgs.map((msg) => JSON.stringify(msg))
+          ];
+          const content = allLines.join("\n") + "\n";
+          fs.writeFileSync(contextFile, content, "utf-8");
+        }
+      } else {
+        const content = options.context.map((msg) => JSON.stringify(msg)).join("\n");
+        if (content) {
+          fs.writeFileSync(contextFile, content + "\n", "utf-8");
+        }
+      }
+    }
+    const internalMetadata = {
+      ...options.metadata,
+      [`${this.INTERNAL_PREFIX}compressionBoundaryMsgId`]: compressionBoundaryMsgId
+    };
+    fs.writeFileSync(stateFile, JSON.stringify(internalMetadata, null, 2), "utf-8");
+  }
+  /**
+   * Filter out internal storage fields from metadata.
+   * @param metadata - The metadata object
+   * @returns Metadata with internal fields removed
+   */
+  _filterInternalFields(metadata) {
+    const filtered = {};
+    for (const [key, value] of Object.entries(metadata)) {
+      if (!key.startsWith(this.INTERNAL_PREFIX)) {
+        filtered[key] = value;
+      }
+    }
+    return filtered;
+  }
+  /**
+   * Offload the compressed context to external storage for agentic search if needed.
+   * @param options
+   * @param options.agentId - The agent identifier
+   * @param options.msgs - The messages to offload
+   * @returns The file path of the offloaded context, or undefined if offloading is not implemented or not needed
+   */
+  async offloadContext(options) {
+    if (!this.offloadDir) {
+      return;
+    }
+    const fileName = `${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.txt`;
+    const offloadFile = path.join(this.offloadDir, options.agentId || "", fileName);
+    const offloadDataDir = path.join(this.offloadDir, options.agentId || "", "data");
+    const offloadAgentDir = path.dirname(offloadFile);
+    if (!fs.existsSync(offloadAgentDir)) {
+      fs.mkdirSync(offloadAgentDir, { recursive: true });
+    }
+    let appendContent = "";
+    for (const msg of options.msgs) {
+      const msgContent = [];
+      for (const block of msg.content) {
+        switch (block.type) {
+          case "text":
+            msgContent.push(`${msg.name}: ${block.text}`);
+            break;
+          case "data":
+            if (block.source.type === "url") {
+              msgContent.push(
+                `${msg.name}: <data src={${block.source.url}} type={${block.source.mediaType}} />`
+              );
+            } else if (block.source.type === "base64") {
+              const mainType = block.source.mediaType.split("/")[0];
+              const extension2 = mime.extension(block.source.mediaType) || "bin";
+              const filePath = path.join(
+                offloadDataDir,
+                `${mainType}-${Date.now()}.${extension2}`
+              );
+              if (!fs.existsSync(offloadDataDir)) {
+                fs.mkdirSync(offloadDataDir, { recursive: true });
+              }
+              const buffer = Buffer.from(block.source.data, "base64");
+              fs.writeFileSync(filePath, buffer);
+              msgContent.push(
+                `${msg.name}: <data src={${filePath}} type={${block.source.mediaType}} />`
+              );
+            }
+            break;
+          case "tool_call":
+            msgContent.push(`${msg.name}: Calling tool ${block.name} ...`);
+            break;
+        }
+      }
+      appendContent += msgContent.join("\n") + "\n";
+    }
+    fs.appendFileSync(offloadFile, appendContent, "utf-8");
+    return offloadFile;
+  }
+};
+export {
+  LocalFileStorage,
+  StorageBase
+};
+//# sourceMappingURL=index.mjs.map

package/dist/storage/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/base.ts","../../src/storage/file-system.ts"],"sourcesContent":["import { Msg } from '../message';\n\n/**\n * The complete agent state including both conversation context and metadata.\n */\nexport interface AgentState {\n    /**\n     * The conversation context (message history).\n     */\n    context: Msg[];\n    /**\n     * Agent metadata (replyId, curIter, curSummary, etc.).\n     */\n    metadata: Record<string, unknown>;\n}\n\n/**\n * The base storage class that responsible for\n * - loading/saving agent context and state, and\n * - offloading compressed context to external storage for agentic search if needed\n */\nexport abstract class StorageBase {\n    /**\n     * Load the complete agent state including context and metadata.\n     * @param options.agentId - The agent identifier\n     * @returns The agent state with context and metadata\n     */\n    abstract loadAgentState(options?: { agentId?: string }): Promise<AgentState>;\n\n    /**\n     * Save the complete agent state including context and metadata.\n     * @param options.agentId - The agent identifier\n     * @param options.context - The conversation context to save\n     * @param options.metadata - The agent metadata to save\n     */\n    abstract saveAgentState(options: {\n        agentId?: string;\n        context: Msg[];\n        metadata: Record<string, unknown>;\n    }): Promise<void>;\n\n    /**\n     * Offload the compressed context to external storage for agentic search if needed.\n     * @param _options.msgs\n     * @param _options\n     * @returns The identifier or URL of the offloaded context, or undefined if offloading is not implemented or not needed\n     */\n    async offloadContext(_options: { msgs: Msg[] }): Promise<string | undefined> {\n        console.log('Offloading context is not implemented for this storage. Skipping offloading.');\n        return undefined;\n    }\n}\n","import fs from 'fs';\nimport path from 'path';\n\nimport * as mime from 'mime-types';\n\nimport { Msg } from '../message';\nimport { AgentState, StorageBase } from './base';\n\n/**\n * Local file system storage implementation.\n * Stores agent state in JSON files with support for incremental context updates.\n */\nexport class LocalFileStorage extends StorageBase {\n    saveDir: string;\n    offloadDir?: string;\n\n    /**\n     * Internal metadata key prefix for storage-layer fields.\n     * Fields with this prefix are managed by storage and filtered out when returning to agent layer.\n     */\n    private readonly INTERNAL_PREFIX = '_storage_';\n\n    /**\n     * Initialize a LocalFileStorage instance.\n     * @param root0\n     * @param root0.pathSegments - Path segments to determine the directory for saving agent state (e.g. ['rootDir', '{sessionId}'])\n     * @param root0.offloadPathSegments - Optional path segments for offloading compressed context for agentic search (e.g. ['rootDir', 'offload'])\n     */\n    constructor({\n        pathSegments = [],\n        offloadPathSegments = [],\n    }: {\n        pathSegments?: string[];\n        offloadPathSegments?: string[];\n    }) {\n        super();\n        this.saveDir = path.join(...pathSegments);\n        this.offloadDir =\n            offloadPathSegments.length > 0 ? path.join(...offloadPathSegments) : undefined;\n    }\n\n    /**\n     * Load the complete agent state including context and metadata.\n     * @param options\n     * @param options.agentId - The agent identifier\n     * @returns The agent state with context and metadata (internal fields filtered out)\n     */\n    async loadAgentState(options?: { agentId?: string }): Promise<AgentState> {\n        const agentDir = path.join(this.saveDir, options?.agentId || '');\n\n        // If the agent directory doesn't exist, return empty state\n        if (!fs.existsSync(agentDir)) {\n            console.log(`Agent directory ${agentDir} does not exist. Returning empty state.`);\n            return {\n                context: [],\n                metadata: {},\n            };\n        }\n        console.log(`Loading agent state from directory: ${agentDir}`);\n\n        const contextFile = path.join(agentDir, 'context.jsonl');\n        const stateFile = path.join(agentDir, 'state.json');\n\n        // Load metadata\n        let metadata: Record<string, unknown> = {};\n        if (fs.existsSync(stateFile)) {\n            const content = fs.readFileSync(stateFile, 'utf-8');\n            metadata = JSON.parse(content);\n        }\n\n        // Extract internal compression boundary ID\n        const compressionBoundaryMsgId = metadata[\n            `${this.INTERNAL_PREFIX}compressionBoundaryMsgId`\n        ] as string | undefined;\n\n        // Load context (incrementally if compression boundary exists)\n        let context: Msg[] = [];\n        if (fs.existsSync(contextFile)) {\n            const content = fs.readFileSync(contextFile, 'utf-8');\n            const allMsgs = content\n                .trim()\n                .split('\\n')\n                .filter(line => line.length > 0)\n                .map(line => JSON.parse(line));\n\n            if (compressionBoundaryMsgId) {\n                // Load only messages after the compression boundary\n                const boundaryIndex = allMsgs.findIndex(msg => msg.id === compressionBoundaryMsgId);\n                if (boundaryIndex !== -1) {\n                    // Include the boundary message itself\n                    context = allMsgs.slice(boundaryIndex);\n                } else {\n                    // Boundary not found, load all messages\n                    context = allMsgs;\n                }\n            } else {\n                // No compression, load all messages\n                context = allMsgs;\n            }\n        }\n\n        // Filter out internal fields from metadata before returning\n        const publicMetadata = this._filterInternalFields(metadata);\n\n        return {\n            context,\n            metadata: publicMetadata,\n        };\n    }\n\n    /**\n     * Save the complete agent state including context and metadata.\n     * @param options\n     * @param options.agentId - The agent identifier\n     * @param options.context - The conversation context to save\n     * @param options.metadata - The agent metadata to save\n     */\n    async saveAgentState(options: {\n        agentId?: string;\n        context: Msg[];\n        metadata: Record<string, unknown>;\n    }): Promise<void> {\n        const agentDir = path.join(this.saveDir, options.agentId || '');\n        const contextFile = path.join(agentDir, 'context.jsonl');\n        const stateFile = path.join(agentDir, 'state.json');\n\n        // Ensure directory exists\n        if (!fs.existsSync(agentDir)) {\n            fs.mkdirSync(agentDir, { recursive: true });\n        }\n\n        // Determine compression boundary (first message in current context)\n        const compressionBoundaryMsgId = options.context[0]?.id;\n\n        // Save context with incremental append optimization\n        if (!fs.existsSync(contextFile)) {\n            // First time: write all messages\n            const content = options.context.map(msg => JSON.stringify(msg)).join('\\n');\n            if (content) {\n                fs.writeFileSync(contextFile, content + '\\n', 'utf-8');\n            }\n        } else {\n            // File exists: append only new messages\n            const existingContent = fs.readFileSync(contextFile, 'utf-8');\n            const existingLines = existingContent\n                .trim()\n                .split('\\n')\n                .filter(line => line.length > 0);\n\n            if (existingLines.length > 0) {\n                const lastLine = existingLines[existingLines.length - 1];\n                const lastMsg = JSON.parse(lastLine);\n\n                // Find new messages that need to be saved (including the last saved message to overwrite it)\n                const lastMsgIndex = options.context.findIndex(msg => msg.id === lastMsg.id);\n                const newMsgs =\n                    lastMsgIndex >= 0 ? options.context.slice(lastMsgIndex) : options.context;\n\n                if (newMsgs.length > 0) {\n                    // Combine existing messages (without last line) with new messages\n                    const allLines = [\n                        ...existingLines.slice(0, -1),\n                        ...newMsgs.map(msg => JSON.stringify(msg)),\n                    ];\n                    const content = allLines.join('\\n') + '\\n';\n                    fs.writeFileSync(contextFile, content, 'utf-8');\n                }\n            } else {\n                // File is empty, write all messages\n                const content = options.context.map(msg => JSON.stringify(msg)).join('\\n');\n                if (content) {\n                    fs.writeFileSync(contextFile, content + '\\n', 'utf-8');\n                }\n            }\n        }\n\n        // Save metadata with internal compression boundary\n        const internalMetadata = {\n            ...options.metadata,\n            [`${this.INTERNAL_PREFIX}compressionBoundaryMsgId`]: compressionBoundaryMsgId,\n        };\n        fs.writeFileSync(stateFile, JSON.stringify(internalMetadata, null, 2), 'utf-8');\n    }\n\n    /**\n     * Filter out internal storage fields from metadata.\n     * @param metadata - The metadata object\n     * @returns Metadata with internal fields removed\n     */\n    private _filterInternalFields(metadata: Record<string, unknown>): Record<string, unknown> {\n        const filtered: Record<string, unknown> = {};\n        for (const [key, value] of Object.entries(metadata)) {\n            if (!key.startsWith(this.INTERNAL_PREFIX)) {\n                filtered[key] = value;\n            }\n        }\n        return filtered;\n    }\n\n    /**\n     * Offload the compressed context to external storage for agentic search if needed.\n     * @param options\n     * @param options.agentId - The agent identifier\n     * @param options.msgs - The messages to offload\n     * @returns The file path of the offloaded context, or undefined if offloading is not implemented or not needed\n     */\n    async offloadContext(options: { agentId?: string; msgs: Msg[] }): Promise<string | undefined> {\n        if (!this.offloadDir) {\n            return;\n        }\n\n        // Offload the compressed context to the text file\n        // e.g. 2026-03-01.txt\n        const fileName = `${new Date().toISOString().split('T')[0]}.txt`;\n        const offloadFile = path.join(this.offloadDir, options.agentId || '', fileName);\n        const offloadDataDir = path.join(this.offloadDir, options.agentId || '', 'data');\n\n        // Create the dir if it doesn't exist\n        const offloadAgentDir = path.dirname(offloadFile);\n        if (!fs.existsSync(offloadAgentDir)) {\n            fs.mkdirSync(offloadAgentDir, { recursive: true });\n        }\n\n        // Append the new context to the offload file\n        let appendContent = '';\n        for (const msg of options.msgs) {\n            const msgContent: string[] = [];\n            for (const block of msg.content) {\n                switch (block.type) {\n                    case 'text':\n                        msgContent.push(`${msg.name}: ${block.text}`);\n                        break;\n                    case 'data':\n                        if (block.source.type === 'url') {\n                            msgContent.push(\n                                `${msg.name}: <data src={${block.source.url}} type={${block.source.mediaType}} />`\n                            );\n                        } else if (block.source.type === 'base64') {\n                            // Save the base64 data to a file and add a reference to the file in the offload content\n                            const mainType = block.source.mediaType.split('/')[0];\n                            const extension = mime.extension(block.source.mediaType) || 'bin';\n                            const filePath = path.join(\n                                offloadDataDir,\n                                `${mainType}-${Date.now()}.${extension}`\n                            );\n                            if (!fs.existsSync(offloadDataDir)) {\n                                fs.mkdirSync(offloadDataDir, { recursive: true });\n                            }\n                            const buffer = Buffer.from(block.source.data, 'base64');\n                            fs.writeFileSync(filePath, buffer);\n                            msgContent.push(\n                                `${msg.name}: <data src={${filePath}} type={${block.source.mediaType}} />`\n                            );\n                        }\n                        break;\n                    case 'tool_call':\n                        msgContent.push(`${msg.name}: Calling tool ${block.name} ...`);\n                        break;\n                }\n            }\n            appendContent += msgContent.join('\\n') + '\\n';\n        }\n\n        // Append to the offload file\n        fs.appendFileSync(offloadFile, appendContent, 'utf-8');\n\n        return offloadFile;\n    }\n}\n"],"mappings":";AAqBO,IAAe,cAAf,MAA2B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0B9B,MAAM,eAAe,UAAwD;AACzE,YAAQ,IAAI,8EAA8E;AAC1F,WAAO;AAAA,EACX;AACJ;;;ACnDA,OAAO,QAAQ;AACf,OAAO,UAAU;AAEjB,YAAY,UAAU;AASf,IAAM,mBAAN,cAA+B,YAAY;AAAA,EAC9C;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMiB,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQnC,YAAY;AAAA,IACR,eAAe,CAAC;AAAA,IAChB,sBAAsB,CAAC;AAAA,EAC3B,GAGG;AACC,UAAM;AACN,SAAK,UAAU,KAAK,KAAK,GAAG,YAAY;AACxC,SAAK,aACD,oBAAoB,SAAS,IAAI,KAAK,KAAK,GAAG,mBAAmB,IAAI;AAAA,EAC7E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,eAAe,SAAqD;AACtE,UAAM,WAAW,KAAK,KAAK,KAAK,SAAS,SAAS,WAAW,EAAE;AAG/D,QAAI,CAAC,GAAG,WAAW,QAAQ,GAAG;AAC1B,cAAQ,IAAI,mBAAmB,QAAQ,yCAAyC;AAChF,aAAO;AAAA,QACH,SAAS,CAAC;AAAA,QACV,UAAU,CAAC;AAAA,MACf;AAAA,IACJ;AACA,YAAQ,IAAI,uCAAuC,QAAQ,EAAE;AAE7D,UAAM,cAAc,KAAK,KAAK,UAAU,eAAe;AACvD,UAAM,YAAY,KAAK,KAAK,UAAU,YAAY;AAGlD,QAAI,WAAoC,CAAC;AACzC,QAAI,GAAG,WAAW,SAAS,GAAG;AAC1B,YAAM,UAAU,GAAG,aAAa,WAAW,OAAO;AAClD,iBAAW,KAAK,MAAM,OAAO;AAAA,IACjC;AAGA,UAAM,2BAA2B,SAC7B,GAAG,KAAK,eAAe,0BAC3B;AAGA,QAAI,UAAiB,CAAC;AACtB,QAAI,GAAG,WAAW,WAAW,GAAG;AAC5B,YAAM,UAAU,GAAG,aAAa,aAAa,OAAO;AACpD,YAAM,UAAU,QACX,KAAK,EACL,MAAM,IAAI,EACV,OAAO,UAAQ,KAAK,SAAS,CAAC,EAC9B,IAAI,UAAQ,KAAK,MAAM,IAAI,CAAC;AAEjC,UAAI,0BAA0B;AAE1B,cAAM,gBAAgB,QAAQ,UAAU,SAAO,IAAI,OAAO,wBAAwB;AAClF,YAAI,kBAAkB,IAAI;AAEtB,oBAAU,QAAQ,MAAM,aAAa;AAAA,QACzC,OAAO;AAEH,oBAAU;AAAA,QACd;AAAA,MACJ,OAAO;AAEH,kBAAU;AAAA,MACd;AAAA,IACJ;AAGA,UAAM,iBAAiB,KAAK,sBAAsB,QAAQ;AAE1D,WAAO;AAAA,MACH;AAAA,MACA,UAAU;AAAA,IACd;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,eAAe,SAIH;AACd,UAAM,WAAW,KAAK,KAAK,KAAK,SAAS,QAAQ,WAAW,EAAE;AAC9D,UAAM,cAAc,KAAK,KAAK,UAAU,eAAe;AACvD,UAAM,YAAY,KAAK,KAAK,UAAU,YAAY;AAGlD,QAAI,CAAC,GAAG,WAAW,QAAQ,GAAG;AAC1B,SAAG,UAAU,UAAU,EAAE,WAAW,KAAK,CAAC;AAAA,IAC9C;AAGA,UAAM,2BAA2B,QAAQ,QAAQ,CAAC,GAAG;AAGrD,QAAI,CAAC,GAAG,WAAW,WAAW,GAAG;AAE7B,YAAM,UAAU,QAAQ,QAAQ,IAAI,SAAO,KAAK,UAAU,GAAG,CAAC,EAAE,KAAK,IAAI;AACzE,UAAI,SAAS;AACT,WAAG,cAAc,aAAa,UAAU,MAAM,OAAO;AAAA,MACzD;AAAA,IACJ,OAAO;AAEH,YAAM,kBAAkB,GAAG,aAAa,aAAa,OAAO;AAC5D,YAAM,gBAAgB,gBACjB,KAAK,EACL,MAAM,IAAI,EACV,OAAO,UAAQ,KAAK,SAAS,CAAC;AAEnC,UAAI,cAAc,SAAS,GAAG;AAC1B,cAAM,WAAW,cAAc,cAAc,SAAS,CAAC;AACvD,cAAM,UAAU,KAAK,MAAM,QAAQ;AAGnC,cAAM,eAAe,QAAQ,QAAQ,UAAU,SAAO,IAAI,OAAO,QAAQ,EAAE;AAC3E,cAAM,UACF,gBAAgB,IAAI,QAAQ,QAAQ,MAAM,YAAY,IAAI,QAAQ;AAEtE,YAAI,QAAQ,SAAS,GAAG;AAEpB,gBAAM,WAAW;AAAA,YACb,GAAG,cAAc,MAAM,GAAG,EAAE;AAAA,YAC5B,GAAG,QAAQ,IAAI,SAAO,KAAK,UAAU,GAAG,CAAC;AAAA,UAC7C;AACA,gBAAM,UAAU,SAAS,KAAK,IAAI,IAAI;AACtC,aAAG,cAAc,aAAa,SAAS,OAAO;AAAA,QAClD;AAAA,MACJ,OAAO;AAEH,cAAM,UAAU,QAAQ,QAAQ,IAAI,SAAO,KAAK,UAAU,GAAG,CAAC,EAAE,KAAK,IAAI;AACzE,YAAI,SAAS;AACT,aAAG,cAAc,aAAa,UAAU,MAAM,OAAO;AAAA,QACzD;AAAA,MACJ;AAAA,IACJ;AAGA,UAAM,mBAAmB;AAAA,MACrB,GAAG,QAAQ;AAAA,MACX,CAAC,GAAG,KAAK,eAAe,0BAA0B,GAAG;AAAA,IACzD;AACA,OAAG,cAAc,WAAW,KAAK,UAAU,kBAAkB,MAAM,CAAC,GAAG,OAAO;AAAA,EAClF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,sBAAsB,UAA4D;AACtF,UAAM,WAAoC,CAAC;AAC3C,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,GAAG;AACjD,UAAI,CAAC,IAAI,WAAW,KAAK,eAAe,GAAG;AACvC,iBAAS,GAAG,IAAI;AAAA,MACpB;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,eAAe,SAAyE;AAC1F,QAAI,CAAC,KAAK,YAAY;AAClB;AAAA,IACJ;AAIA,UAAM,WAAW,IAAG,oBAAI,KAAK,GAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;AAC1D,UAAM,cAAc,KAAK,KAAK,KAAK,YAAY,QAAQ,WAAW,IAAI,QAAQ;AAC9E,UAAM,iBAAiB,KAAK,KAAK,KAAK,YAAY,QAAQ,WAAW,IAAI,MAAM;AAG/E,UAAM,kBAAkB,KAAK,QAAQ,WAAW;AAChD,QAAI,CAAC,GAAG,WAAW,eAAe,GAAG;AACjC,SAAG,UAAU,iBAAiB,EAAE,WAAW,KAAK,CAAC;AAAA,IACrD;AAGA,QAAI,gBAAgB;AACpB,eAAW,OAAO,QAAQ,MAAM;AAC5B,YAAM,aAAuB,CAAC;AAC9B,iBAAW,SAAS,IAAI,SAAS;AAC7B,gBAAQ,MAAM,MAAM;AAAA,UAChB,KAAK;AACD,uBAAW,KAAK,GAAG,IAAI,IAAI,KAAK,MAAM,IAAI,EAAE;AAC5C;AAAA,UACJ,KAAK;AACD,gBAAI,MAAM,OAAO,SAAS,OAAO;AAC7B,yBAAW;AAAA,gBACP,GAAG,IAAI,IAAI,gBAAgB,MAAM,OAAO,GAAG,WAAW,MAAM,OAAO,SAAS;AAAA,cAChF;AAAA,YACJ,WAAW,MAAM,OAAO,SAAS,UAAU;AAEvC,oBAAM,WAAW,MAAM,OAAO,UAAU,MAAM,GAAG,EAAE,CAAC;AACpD,oBAAMA,aAAiB,eAAU,MAAM,OAAO,SAAS,KAAK;AAC5D,oBAAM,WAAW,KAAK;AAAA,gBAClB;AAAA,gBACA,GAAG,QAAQ,IAAI,KAAK,IAAI,CAAC,IAAIA,UAAS;AAAA,cAC1C;AACA,kBAAI,CAAC,GAAG,WAAW,cAAc,GAAG;AAChC,mBAAG,UAAU,gBAAgB,EAAE,WAAW,KAAK,CAAC;AAAA,cACpD;AACA,oBAAM,SAAS,OAAO,KAAK,MAAM,OAAO,MAAM,QAAQ;AACtD,iBAAG,cAAc,UAAU,MAAM;AACjC,yBAAW;AAAA,gBACP,GAAG,IAAI,IAAI,gBAAgB,QAAQ,WAAW,MAAM,OAAO,SAAS;AAAA,cACxE;AAAA,YACJ;AACA;AAAA,UACJ,KAAK;AACD,uBAAW,KAAK,GAAG,IAAI,IAAI,kBAAkB,MAAM,IAAI,MAAM;AAC7D;AAAA,QACR;AAAA,MACJ;AACA,uBAAiB,WAAW,KAAK,IAAI,IAAI;AAAA,IAC7C;AAGA,OAAG,eAAe,aAAa,eAAe,OAAO;AAErD,WAAO;AAAA,EACX;AACJ;","names":["extension"]}