lemura 1.0.0

package/dist/context/index.mjs

@@ -0,0 +1,314 @@
+import { randomUUID } from 'crypto';
+
+// src/types/errors.ts
+var LemuraError = class extends Error {
+  /**
+   * @param message - The error message
+   * @param code - The error code for programmatic handling
+   * @param problem - A clear description of the problem for the end user
+   * @param hints - A list of suggestions to resolve the issue
+   */
+  constructor(message, code, problem, hints = []) {
+    super(message);
+    this.code = code;
+    this.problem = problem;
+    this.hints = hints;
+    this.name = "LemuraError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var LemuraContextOverflowError = class extends LemuraError {
+  constructor(message) {
+    super(message, "CONTEXT_OVERFLOW");
+    this.name = "LemuraContextOverflowError";
+  }
+};
+
+// src/context/ContextManager.ts
+var ContextManager = class {
+  strategies = [];
+  /**
+   * Registers a new compression or pre-turn strategy and sorts the stack by priority.
+   *
+   * @param strategy - The strategy implementation to register
+   */
+  registerStrategy(strategy) {
+    this.strategies.push(strategy);
+    this.strategies.sort((a, b) => a.priority - b.priority);
+  }
+  /**
+   * Applies all registered strategies that return true for `shouldApply()`
+   * until the context token count is safely below the maximum budget.
+   *
+   * @param context - The context window to prepare
+   * @param safetyMargin - Modifier applied to maxTokens (default: 0.95 -> 95%)
+   * @returns A new ContextWindow object potentially compressed
+   * @throws {LemuraContextOverflowError} If the context is still over maxTokens after all strategies
+   */
+  async prepare(context, safetyMargin = 0.95) {
+    let currentCtx = { ...context, turns: [...context.turns] };
+    currentCtx.maxTokens * safetyMargin;
+    for (const strategy of this.strategies) {
+      if (strategy.shouldApply(currentCtx)) {
+        currentCtx = await strategy.apply(currentCtx);
+      }
+    }
+    if (currentCtx.tokenCount > currentCtx.maxTokens) {
+      throw new LemuraContextOverflowError(
+        `Context overflowed: ${currentCtx.tokenCount} tokens > ${currentCtx.maxTokens}`
+      );
+    }
+    return currentCtx;
+  }
+};
+
+// src/context/SandwichCompressionStrategy.ts
+var SandwichCompressionStrategy = class {
+  constructor(adapter, config) {
+    this.adapter = adapter;
+    this.config = config;
+  }
+  name = "sandwich_compression";
+  priority = 20;
+  shouldApply(ctx) {
+    return ctx.tokenCount >= ctx.maxTokens * this.config.triggerThreshold && ctx.turns.length > this.config.preserveFirst + this.config.preserveLast;
+  }
+  async apply(ctx) {
+    const { preserveFirst, preserveLast } = this.config;
+    const head = ctx.turns.slice(0, preserveFirst);
+    const tail = ctx.turns.slice(ctx.turns.length - preserveLast);
+    const middle = ctx.turns.slice(preserveFirst, ctx.turns.length - preserveLast);
+    const middleText = middle.map((t) => `${t.role}: ${JSON.stringify(t.content)}`).join("\n");
+    const summaryResponse = await this.adapter.complete({
+      model: "",
+      messages: [{
+        role: "user",
+        content: `Summarize the following conversation history briefly:
+${middleText}`
+      }]
+    });
+    const summaryStr = summaryResponse.content;
+    const newCompressionSummary = ctx.compressionSummary ? `${ctx.compressionSummary}
+${summaryStr}` : summaryStr;
+    const summaryTurn = {
+      role: "system",
+      content: `[COMPRESSED HISTORY SUMMARY]
+${newCompressionSummary}`,
+      tokenCount: this.adapter.estimateTokens(newCompressionSummary),
+      turnIndex: -1,
+      compressed: true
+    };
+    const newTurns = [...head, summaryTurn, ...tail];
+    const newTokenCount = newTurns.reduce((sum, t) => sum + t.tokenCount, 0) + this.adapter.estimateTokens(ctx.systemPrompt) + this.adapter.estimateTokens(ctx.scratchpad);
+    return {
+      ...ctx,
+      turns: newTurns,
+      tokenCount: newTokenCount,
+      compressionSummary: newCompressionSummary
+    };
+  }
+  /**
+   * Applies sandwich compression specifically to a Short Term Memory item's content.
+   * Implements a 3-layer pipeline: Pre-Layer (encoding), Core Layer (dense summary), Post-Layer (refinement cues).
+   * 
+   * @param content - The heavy text content to compress
+   * @param instructions - Guiding instructions for the core layer summary
+   * @returns The three-layer sandwich result
+   */
+  async compressMemoryItem(content, instructions = "Extract the key information") {
+    const estimatedChunks = Math.max(1, Math.ceil(this.adapter.estimateTokens(content) / 2e3));
+    const preLayer = `[PRE-LAYER ENCODED: ${estimatedChunks} internal chunks]`;
+    const summaryResponse = await this.adapter.complete({
+      model: "",
+      messages: [{
+        role: "user",
+        content: `### INSTRUCTIONS ###
+${instructions}
+
+### CONTENT ###
+${content}
+
+### INSTRUCTIONS ###
+${instructions}`
+      }]
+    });
+    const coreLayer = summaryResponse.content;
+    const postLayer = `[POST-LAYER DECODING: Use \`refine_layer\` or \`read_chunk\` tools to expand specific sections]`;
+    return { preLayer, coreLayer, postLayer };
+  }
+};
+
+// src/context/HistoryCompressionStrategy.ts
+var ScratchpadStrategy = class {
+  name = "scratchpad_strategy";
+  priority = 10;
+  shouldApply(ctx) {
+    return ctx.scratchpad.length > 0;
+  }
+  async apply(ctx) {
+    return ctx;
+  }
+};
+var HistoryCompressionStrategy = class {
+  constructor(adapter, config) {
+    this.adapter = adapter;
+    this.config = config;
+  }
+  name = "history_compression";
+  priority = 30;
+  shouldApply(ctx) {
+    const triggerTokens = ctx.maxTokens * this.config.triggerAtPercent;
+    const uncompressedTurns = ctx.turns.filter((t) => t.role !== "system" && !t.compressed);
+    return ctx.tokenCount >= triggerTokens && uncompressedTurns.length > this.config.windowSize;
+  }
+  async apply(ctx) {
+    const uncompressedIndices = ctx.turns.map((t, i) => ({ t, i })).filter(({ t }) => t.role !== "system" && !t.compressed).slice(0, this.config.windowSize);
+    const targetTurns = uncompressedIndices.map((u) => u.t);
+    const middleText = targetTurns.map((t) => `${t.role}: ${JSON.stringify(t.content)}`).join("\n");
+    const summaryResponse = await this.adapter.complete({
+      model: "",
+      messages: [{
+        role: "user",
+        content: `Summarize the oldest part of this conversation:
+${middleText}`
+      }]
+    });
+    const summaryStr = summaryResponse.content;
+    const newCompressionSummary = ctx.compressionSummary ? `${ctx.compressionSummary}
+${summaryStr}` : summaryStr;
+    const indicesToRemove = new Set(uncompressedIndices.map((u) => u.i));
+    const newTurns = ctx.turns.filter((_, i) => !indicesToRemove.has(i));
+    const TokenCount = newTurns.reduce((sum, t) => sum + t.tokenCount, 0) + this.adapter.estimateTokens(ctx.systemPrompt) + this.adapter.estimateTokens(ctx.scratchpad);
+    return {
+      ...ctx,
+      turns: newTurns,
+      tokenCount: TokenCount,
+      compressionSummary: newCompressionSummary
+    };
+  }
+};
+var ShortTermMemoryRegistry = class {
+  storage;
+  maxTextTokens;
+  constructor(config) {
+    this.storage = config.storage;
+    this.maxTextTokens = config.maxTextTokens ?? 1e5;
+  }
+  /**
+   * Registers a new memory item and returns its reference string.
+   * 
+   * @param content - The raw content to store
+   * @param type - The type of content ('text' or 'blob')
+   * @param metadata - Optional metadata (e.g. sandwich layers, original filename)
+   * @param estimateTokens - Optional function to estimate token count for 'text' type
+   * @returns A reference string formatted as '[STM:uuid]'
+   * @throws {Error} if a text item exceeds the maxTextTokens limit
+   */
+  async register(content, type, metadata, estimateTokens) {
+    if (type === "text") {
+      const tokenCount = estimateTokens ? estimateTokens(content) : Math.ceil(String(content).length / 4);
+      if (tokenCount > this.maxTextTokens) {
+        throw new Error(`Text content exceeds max tokens limit of ${this.maxTextTokens} (estimated ${tokenCount})`);
+      }
+    }
+    const id = randomUUID();
+    const item = {
+      id,
+      content,
+      type,
+      ...metadata !== void 0 ? { metadata } : {}
+    };
+    await this.storage.set(id, item);
+    return `[STM:${id}]`;
+  }
+  /**
+   * Updates an existing STM item's content or metadata.
+   * 
+   * @param id - The UUID of the item to update
+   * @param updates - Partial updates to apply (content or metadata)
+   */
+  async update(id, updates) {
+    const item = await this.storage.get(id);
+    if (!item) throw new Error(`STM item not found for update: ${id}`);
+    const updatedItem = {
+      ...item,
+      ...updates.content !== void 0 ? { content: updates.content } : {},
+      ...updates.metadata !== void 0 ? { metadata: { ...item.metadata, ...updates.metadata } } : {}
+    };
+    await this.storage.set(id, updatedItem);
+  }
+  /**
+   * Retrieves an STM item by its full reference string (e.g., '[STM:uuid]').
+   * 
+   * @param ref - The full reference string
+   * @returns The STMItem or undefined if not found
+   */
+  async getByRef(ref) {
+    const match = ref.match(/^\[STM:(.+)\]$/);
+    if (!match || !match[1]) return void 0;
+    return this.storage.get(match[1]);
+  }
+  /**
+   * Deletes an STM item by its ID.
+   * 
+   * @param id - The UUID of the item to delete
+   */
+  async delete(id) {
+    await this.storage.delete(id);
+  }
+};
+var InMemoryStorageAdapter = class {
+  store = /* @__PURE__ */ new Map();
+  /**
+   * Retrieves stored content by ID.
+   *
+   * @param id - The identifier of the stored item
+   * @returns The stored content or undefined if not found
+   */
+  async get(id) {
+    return this.store.get(id)?.content;
+  }
+  /**
+   * Returns the full item including metadata.
+   *
+   * @param id - The identifier of the stored item
+   * @returns The complete item with content and metadata
+   * @internal
+   */
+  async getFull(id) {
+    return this.store.get(id);
+  }
+  /**
+   * Stores content, generating an ID if none is provided.
+   *
+   * @param id - Optional provided ID. If omitted, a UUID is generated.
+   * @param content - The content to store
+   * @param metadata - Optional metadata
+   * @returns The ID under which the content is stored
+   */
+  async set(id, content, metadata) {
+    const resolvedId = id ?? randomUUID();
+    this.store.set(resolvedId, metadata !== void 0 ? { content, metadata } : { content });
+    return resolvedId;
+  }
+  /**
+   * Deletes the content for the given ID.
+   *
+   * @param id - The identifier of the item to delete
+   */
+  async delete(id) {
+    this.store.delete(id);
+  }
+  /**
+   * Synchronous health check, always true for in-memory.
+   *
+   * @returns true
+   */
+  async healthCheck() {
+    return true;
+  }
+};
+
+export { ContextManager, HistoryCompressionStrategy, InMemoryStorageAdapter, SandwichCompressionStrategy, ScratchpadStrategy, ShortTermMemoryRegistry };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/context/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/errors.ts","../../src/context/ContextManager.ts","../../src/context/SandwichCompressionStrategy.ts","../../src/context/HistoryCompressionStrategy.ts","../../src/context/ShortTermMemoryRegistry.ts","../../src/context/InMemoryStorageAdapter.ts"],"names":["randomUUID"],"mappings":";;;AAMO,IAAM,WAAA,GAAN,cAA0B,KAAA,CAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOnC,YACI,OAAA,EACgB,IAAA,EACA,OAAA,EACA,KAAA,GAAkB,EAAC,EACrC;AACE,IAAA,KAAA,CAAM,OAAO,CAAA;AAJG,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAGhB,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EACpD;AACJ,CAAA;AAGO,IAAM,0BAAA,GAAN,cAAyC,WAAA,CAAY;AAAA,EACxD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,kBAAkB,CAAA;AACjC,IAAA,IAAA,CAAK,IAAA,GAAO,4BAAA;AAAA,EAChB;AACJ,CAAA;;;ACzBO,IAAM,iBAAN,MAAqB;AAAA,EAChB,aAAiC,EAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO1C,iBAAiB,QAAA,EAAkC;AAC/C,IAAA,IAAA,CAAK,UAAA,CAAW,KAAK,QAAQ,CAAA;AAC7B,IAAA,IAAA,CAAK,UAAA,CAAW,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,CAAE,QAAA,GAAW,EAAE,QAAQ,CAAA;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,OAAA,CAAQ,OAAA,EAAwB,YAAA,GAAe,IAAA,EAA8B;AAC/E,IAAA,IAAI,UAAA,GAAa,EAAE,GAAG,OAAA,EAAS,OAAO,CAAC,GAAG,OAAA,CAAQ,KAAK,CAAA,EAAE;AACzD,IAAyB,WAAW,SAAA,GAAY;AAEhD,IAAA,KAAA,MAAW,QAAA,IAAY,KAAK,UAAA,EAAY;AAIpC,MAAA,IAAI,QAAA,CAAS,WAAA,CAAY,UAAU,CAAA,EAAG;AAClC,QAAA,UAAA,GAAa,MAAM,QAAA,CAAS,KAAA,CAAM,UAAU,CAAA;AAAA,MAChD;AAAA,IACJ;AAEA,IAAA,IAAI,UAAA,CAAW,UAAA,GAAa,UAAA,CAAW,SAAA,EAAW;AAC9C,MAAA,MAAM,IAAI,0BAAA;AAAA,QACN,CAAA,oBAAA,EAAuB,UAAA,CAAW,UAAU,CAAA,UAAA,EAAa,WAAW,SAAS,CAAA;AAAA,OACjF;AAAA,IACJ;AAEA,IAAA,OAAO,UAAA;AAAA,EACX;AACJ;;;ACrCO,IAAM,8BAAN,MAA8D;AAAA,EAIjE,WAAA,CACY,SACA,MAAA,EACV;AAFU,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EACR;AAAA,EANK,IAAA,GAAO,sBAAA;AAAA,EACP,QAAA,GAAW,EAAA;AAAA,EAOpB,YAAY,GAAA,EAA6B;AACrC,IAAA,OACI,GAAA,CAAI,UAAA,IAAc,GAAA,CAAI,SAAA,GAAY,KAAK,MAAA,CAAO,gBAAA,IAC9C,GAAA,CAAI,KAAA,CAAM,MAAA,GAAS,IAAA,CAAK,MAAA,CAAO,aAAA,GAAgB,KAAK,MAAA,CAAO,YAAA;AAAA,EAEnE;AAAA,EAEA,MAAM,MAAM,GAAA,EAA4C;AACpD,IAAA,MAAM,EAAE,aAAA,EAAe,YAAA,EAAa,GAAI,IAAA,CAAK,MAAA;AAE7C,IAAA,MAAM,IAAA,GAAO,GAAA,CAAI,KAAA,CAAM,KAAA,CAAM,GAAG,aAAa,CAAA;AAC7C,IAAA,MAAM,OAAO,GAAA,CAAI,KAAA,CAAM,MAAM,GAAA,CAAI,KAAA,CAAM,SAAS,YAAY,CAAA;AAC5D,IAAA,MAAM,MAAA,GAAS,IAAI,KAAA,CAAM,KAAA,CAAM,eAAe,GAAA,CAAI,KAAA,CAAM,SAAS,YAAY,CAAA;AAE7E,IAAA,MAAM,aAAa,MAAA,CAAO,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,EAAG,EAAE,IAAI,CAAA,EAAA,EAAK,IAAA,CAAK,SAAA,CAAU,EAAE,OAAO,CAAC,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAEvF,IAAA,MAAM,eAAA,GAAkB,MAAM,IAAA,CAAK,OAAA,CAAQ,QAAA,CAAS;AAAA,MAChD,KAAA,EAAO,EAAA;AAAA,MACP,UAAU,CAAC;AAAA,QACP,IAAA,EAAM,MAAA;AAAA,QACN,OAAA,EAAS,CAAA;AAAA,EAA0D,UAAU,CAAA;AAAA,OAChF;AAAA,KACJ,CAAA;AAED,IAAA,MAAM,aAAa,eAAA,CAAgB,OAAA;AAEnC,IAAA,MAAM,qBAAA,GAAwB,GAAA,CAAI,kBAAA,GAC5B,CAAA,EAAG,IAAI,kBAAkB;AAAA,EAAK,UAAU,CAAA,CAAA,GACxC,UAAA;AAEN,IAAA,MAAM,WAAA,GAAoB;AAAA,MACtB,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS,CAAA;AAAA,EAAiC,qBAAqB,CAAA,CAAA;AAAA,MAC/D,UAAA,EAAY,IAAA,CAAK,OAAA,CAAQ,cAAA,CAAe,qBAAqB,CAAA;AAAA,MAC7D,SAAA,EAAW,EAAA;AAAA,MACX,UAAA,EAAY;AAAA,KAChB;AAEA,IAAA,MAAM,WAAW,CAAC,GAAG,IAAA,EAAM,WAAA,EAAa,GAAG,IAAI,CAAA;AAC/C,IAAA,MAAM,aAAA,GAAgB,SAAS,MAAA,CAAO,CAAC,KAAK,CAAA,KAAM,GAAA,GAAM,EAAE,UAAA,EAAY,CAAC,IACnE,IAAA,CAAK,OAAA,CAAQ,eAAe,GAAA,CAAI,YAAY,IAC5C,IAAA,CAAK,OAAA,CAAQ,cAAA,CAAe,GAAA,CAAI,UAAU,CAAA;AAE9C,IAAA,OAAO;AAAA,MACH,GAAG,GAAA;AAAA,MACH,KAAA,EAAO,QAAA;AAAA,MACP,UAAA,EAAY,aAAA;AAAA,MACZ,kBAAA,EAAoB;AAAA,KACxB;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,kBAAA,CAAmB,OAAA,EAAiB,YAAA,GAAuB,6BAAA,EAI9D;AAGC,IAAA,MAAM,eAAA,GAAkB,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,cAAA,CAAe,OAAO,CAAA,GAAI,GAAI,CAAC,CAAA;AAC1F,IAAA,MAAM,QAAA,GAAW,uBAAuB,eAAe,CAAA,iBAAA,CAAA;AAKvD,IAAA,MAAM,eAAA,GAAkB,MAAM,IAAA,CAAK,OAAA,CAAQ,QAAA,CAAS;AAAA,MAChD,KAAA,EAAO,EAAA;AAAA,MACP,UAAU,CAAC;AAAA,QACP,IAAA,EAAM,MAAA;AAAA,QACN,OAAA,EAAS,CAAA;AAAA,EAAyB,YAAY;;AAAA;AAAA,EAAwB,OAAO;;AAAA;AAAA,EAA6B,YAAY,CAAA;AAAA,OACzH;AAAA,KACJ,CAAA;AACD,IAAA,MAAM,YAAY,eAAA,CAAgB,OAAA;AAIlC,IAAA,MAAM,SAAA,GAAY,CAAA,+FAAA,CAAA;AAElB,IAAA,OAAO,EAAE,QAAA,EAAU,SAAA,EAAW,SAAA,EAAU;AAAA,EAC5C;AACJ;;;ACrGO,IAAM,qBAAN,MAAqD;AAAA,EAC/C,IAAA,GAAO,qBAAA;AAAA,EACP,QAAA,GAAW,EAAA;AAAA,EAEpB,YAAY,GAAA,EAA6B;AAErC,IAAA,OAAO,GAAA,CAAI,WAAW,MAAA,GAAS,CAAA;AAAA,EACnC;AAAA,EAEA,MAAM,MAAM,GAAA,EAA4C;AAEpD,IAAA,OAAO,GAAA;AAAA,EACX;AACJ;AAUO,IAAM,6BAAN,MAA6D;AAAA,EAIhE,WAAA,CACY,SACA,MAAA,EACV;AAFU,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EACR;AAAA,EANK,IAAA,GAAO,qBAAA;AAAA,EACP,QAAA,GAAW,EAAA;AAAA,EAOpB,YAAY,GAAA,EAA6B;AACrC,IAAA,MAAM,aAAA,GAAgB,GAAA,CAAI,SAAA,GAAY,IAAA,CAAK,MAAA,CAAO,gBAAA;AAGlD,IAAA,MAAM,iBAAA,GAAoB,GAAA,CAAI,KAAA,CAAM,MAAA,CAAO,CAAA,CAAA,KAAK,EAAE,IAAA,KAAS,QAAA,IAAY,CAAC,CAAA,CAAE,UAAU,CAAA;AACpF,IAAA,OAAO,IAAI,UAAA,IAAc,aAAA,IAAiB,iBAAA,CAAkB,MAAA,GAAS,KAAK,MAAA,CAAO,UAAA;AAAA,EACrF;AAAA,EAEA,MAAM,MAAM,GAAA,EAA4C;AAEpD,IAAA,MAAM,mBAAA,GAAsB,GAAA,CAAI,KAAA,CAC3B,GAAA,CAAI,CAAC,CAAA,EAAG,CAAA,MAAO,EAAE,CAAA,EAAG,CAAA,EAAE,CAAE,CAAA,CACxB,MAAA,CAAO,CAAC,EAAE,CAAA,EAAE,KAAM,CAAA,CAAE,IAAA,KAAS,QAAA,IAAY,CAAC,CAAA,CAAE,UAAU,CAAA,CACtD,KAAA,CAAM,CAAA,EAAG,IAAA,CAAK,MAAA,CAAO,UAAU,CAAA;AAEpC,IAAA,MAAM,WAAA,GAAc,mBAAA,CAAoB,GAAA,CAAI,CAAA,CAAA,KAAK,EAAE,CAAC,CAAA;AACpD,IAAA,MAAM,aAAa,WAAA,CAAY,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,EAAG,EAAE,IAAI,CAAA,EAAA,EAAK,IAAA,CAAK,SAAA,CAAU,EAAE,OAAO,CAAC,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAE5F,IAAA,MAAM,eAAA,GAAkB,MAAM,IAAA,CAAK,OAAA,CAAQ,QAAA,CAAS;AAAA,MAChD,KAAA,EAAO,EAAA;AAAA,MACP,UAAU,CAAC;AAAA,QACP,IAAA,EAAM,MAAA;AAAA,QACN,OAAA,EAAS,CAAA;AAAA,EAAoD,UAAU,CAAA;AAAA,OAC1E;AAAA,KACJ,CAAA;AAED,IAAA,MAAM,aAAa,eAAA,CAAgB,OAAA;AACnC,IAAA,MAAM,qBAAA,GAAwB,GAAA,CAAI,kBAAA,GAC5B,CAAA,EAAG,IAAI,kBAAkB;AAAA,EAAK,UAAU,CAAA,CAAA,GACxC,UAAA;AAGN,IAAA,MAAM,eAAA,GAAkB,IAAI,GAAA,CAAI,mBAAA,CAAoB,IAAI,CAAA,CAAA,KAAK,CAAA,CAAE,CAAC,CAAC,CAAA;AACjE,IAAA,MAAM,QAAA,GAAW,GAAA,CAAI,KAAA,CAAM,MAAA,CAAO,CAAC,CAAA,EAAG,CAAA,KAAM,CAAC,eAAA,CAAgB,GAAA,CAAI,CAAC,CAAC,CAAA;AAEnE,IAAA,MAAM,UAAA,GAAa,SAAS,MAAA,CAAO,CAAC,KAAK,CAAA,KAAM,GAAA,GAAM,EAAE,UAAA,EAAY,CAAC,IAChE,IAAA,CAAK,OAAA,CAAQ,eAAe,GAAA,CAAI,YAAY,IAC5C,IAAA,CAAK,OAAA,CAAQ,cAAA,CAAe,GAAA,CAAI,UAAU,CAAA;AAE9C,IAAA,OAAO;AAAA,MACH,GAAG,GAAA;AAAA,MACH,KAAA,EAAO,QAAA;AAAA,MACP,UAAA,EAAY,UAAA;AAAA,MACZ,kBAAA,EAAoB;AAAA,KACxB;AAAA,EACJ;AACJ;AC/DO,IAAM,0BAAN,MAA8B;AAAA,EACzB,OAAA;AAAA,EACA,aAAA;AAAA,EAER,YAAY,MAAA,EAA2B;AACnC,IAAA,IAAA,CAAK,UAAU,MAAA,CAAO,OAAA;AACtB,IAAA,IAAA,CAAK,aAAA,GAAgB,OAAO,aAAA,IAAiB,GAAA;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,QAAA,CACF,OAAA,EACA,IAAA,EACA,UACA,cAAA,EACe;AACf,IAAA,IAAI,SAAS,MAAA,EAAQ;AACjB,MAAA,MAAM,UAAA,GAAa,cAAA,GAAiB,cAAA,CAAe,OAAO,CAAA,GAAI,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,OAAO,CAAA,CAAE,MAAA,GAAS,CAAC,CAAA;AAClG,MAAA,IAAI,UAAA,GAAa,KAAK,aAAA,EAAe;AACjC,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,yCAAA,EAA4C,KAAK,aAAa,CAAA,YAAA,EAAe,UAAU,CAAA,CAAA,CAAG,CAAA;AAAA,MAC9G;AAAA,IACJ;AAEA,IAAA,MAAM,KAAK,UAAA,EAAW;AACtB,IAAA,MAAM,IAAA,GAAgB;AAAA,MAClB,EAAA;AAAA,MACA,OAAA;AAAA,MACA,IAAA;AAAA,MACA,GAAI,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,KAAa;AAAC,KACjD;AAEA,IAAA,MAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,EAAA,EAAI,IAAI,CAAA;AAC/B,IAAA,OAAO,QAAQ,EAAE,CAAA,CAAA,CAAA;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,MAAA,CAAO,EAAA,EAAY,OAAA,EAA+E;AACpG,IAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,OAAA,CAAQ,IAAI,EAAE,CAAA;AACtC,IAAA,IAAI,CAAC,IAAA,EAAM,MAAM,IAAI,KAAA,CAAM,CAAA,+BAAA,EAAkC,EAAE,CAAA,CAAE,CAAA;AAEjE,IAAA,MAAM,WAAA,GAAuB;AAAA,MACzB,GAAG,IAAA;AAAA,MACH,GAAI,QAAQ,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,EAAS,OAAA,CAAQ,OAAA,EAAQ,GAAI,EAAC;AAAA,MACpE,GAAI,OAAA,CAAQ,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,EAAU,EAAE,GAAG,IAAA,CAAK,UAAU,GAAG,OAAA,CAAQ,QAAA,EAAS,KAAM;AAAC,KACpG;AAEA,IAAA,MAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,EAAA,EAAI,WAAW,CAAA;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,SAAS,GAAA,EAA2C;AACtD,IAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,KAAA,CAAM,gBAAgB,CAAA;AACxC,IAAA,IAAI,CAAC,KAAA,IAAS,CAAC,KAAA,CAAM,CAAC,GAAG,OAAO,MAAA;AAChC,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,CAAC,CAAC,CAAA;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAO,EAAA,EAA2B;AACpC,IAAA,MAAM,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,EAAE,CAAA;AAAA,EAChC;AACJ;AC9FO,IAAM,yBAAN,MAAwD;AAAA,EACnD,KAAA,uBAAY,GAAA,EAAkE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQtF,MAAM,IAAI,EAAA,EAAsC;AAC5C,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,EAAE,CAAA,EAAG,OAAA;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,QAAQ,EAAA,EAAuF;AACjG,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,EAAE,CAAA;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,GAAA,CAAI,EAAA,EAAwB,OAAA,EAAc,QAAA,EAAqD;AACjG,IAAA,MAAM,UAAA,GAAa,MAAMA,UAAAA,EAAW;AACpC,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,UAAA,EAAY,QAAA,KAAa,MAAA,GAAY,EAAE,OAAA,EAAS,QAAA,EAAS,GAAI,EAAE,OAAA,EAAS,CAAA;AACvF,IAAA,OAAO,UAAA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAO,EAAA,EAA2B;AACpC,IAAA,IAAA,CAAK,KAAA,CAAM,OAAO,EAAE,CAAA;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,WAAA,GAAgC;AAClC,IAAA,OAAO,IAAA;AAAA,EACX;AACJ","file":"index.mjs","sourcesContent":["/**\n * Base class for all custom errors thrown by lemura.\n *\n * @example\n * throw new LemuraError('Something went wrong', 'UNKNOWN_ERROR');\n */\nexport class LemuraError extends Error {\n    /**\n     * @param message - The error message\n     * @param code - The error code for programmatic handling\n     * @param problem - A clear description of the problem for the end user\n     * @param hints - A list of suggestions to resolve the issue\n     */\n    constructor(\n        message: string,\n        public readonly code: string,\n        public readonly problem?: string,\n        public readonly hints: string[] = []\n    ) {\n        super(message);\n        this.name = 'LemuraError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/** Error thrown when context exceeds max tokens and cannot be compressed further */\nexport class LemuraContextOverflowError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'CONTEXT_OVERFLOW');\n        this.name = 'LemuraContextOverflowError';\n    }\n}\n\n/** Error thrown when a requested tool is not found in the registry */\nexport class LemuraToolNotFoundError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_NOT_FOUND');\n        this.name = 'LemuraToolNotFoundError';\n    }\n}\n\n/** Error thrown when an adapter encounters an API or formatting issue */\nexport class LemuraAdapterError extends LemuraError {\n    constructor(\n        message: string,\n        code = 'ADAPTER_ERROR',\n        public cause?: any,\n        problem?: string,\n        hints: string[] = []\n    ) {\n        super(message, code, problem, hints);\n        this.name = 'LemuraAdapterError';\n    }\n}\n\n/** Error thrown when a skill cannot be parsed or injected */\nexport class LemuraSkillInjectionError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'SKILL_INJECTION_FAILED');\n        this.name = 'LemuraSkillInjectionError';\n    }\n}\n\n/** Error thrown when the ReAct loop exceeds the configured max iterations */\nexport class LemuraMaxIterationsError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'MAX_ITERATIONS_EXCEEDED');\n        this.name = 'LemuraMaxIterationsError';\n    }\n}\n\n/** Error thrown when tool parameters fail JSON schema validation */\nexport class LemuraToolValidationError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_VALIDATION_FAILED');\n        this.name = 'LemuraToolValidationError';\n    }\n}\n\n/** Error thrown when a tool execute function exceeds its timeout */\nexport class LemuraToolTimeoutError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_TIMEOUT');\n        this.name = 'LemuraToolTimeoutError';\n    }\n}\n","import { ContextWindow, IContextStrategy, LemuraContextOverflowError } from '../types/index.js';\n\n/**\n * Orchestrates a stack of IContextStrategy implementations to keep the\n * token count within the maxTokens limit.\n */\nexport class ContextManager {\n    private strategies: IContextStrategy[] = [];\n\n    /**\n     * Registers a new compression or pre-turn strategy and sorts the stack by priority.\n     *\n     * @param strategy - The strategy implementation to register\n     */\n    registerStrategy(strategy: IContextStrategy): void {\n        this.strategies.push(strategy);\n        this.strategies.sort((a, b) => a.priority - b.priority);\n    }\n\n    /**\n     * Applies all registered strategies that return true for `shouldApply()`\n     * until the context token count is safely below the maximum budget.\n     *\n     * @param context - The context window to prepare\n     * @param safetyMargin - Modifier applied to maxTokens (default: 0.95 -> 95%)\n     * @returns A new ContextWindow object potentially compressed\n     * @throws {LemuraContextOverflowError} If the context is still over maxTokens after all strategies\n     */\n    async prepare(context: ContextWindow, safetyMargin = 0.95): Promise<ContextWindow> {\n        let currentCtx = { ...context, turns: [...context.turns] };\n        const targetTokenCount = currentCtx.maxTokens * safetyMargin;\n\n        for (const strategy of this.strategies) {\n            // If we are below the limit and it's not a pre-turn non-reducing strategy, skip it.\n            // E.g., SummaryInjectionStrategy might still want to run.\n            // But purely compression ones drop out early in our base architecture if they choose in `shouldApply`.\n            if (strategy.shouldApply(currentCtx)) {\n                currentCtx = await strategy.apply(currentCtx);\n            }\n        }\n\n        if (currentCtx.tokenCount > currentCtx.maxTokens) {\n            throw new LemuraContextOverflowError(\n                `Context overflowed: ${currentCtx.tokenCount} tokens > ${currentCtx.maxTokens}`\n            );\n        }\n\n        return currentCtx;\n    }\n}\n","import { ContextWindow, IContextStrategy, IProviderAdapter, Turn } from '../types/index.js';\n\nexport interface SandwichCompressionConfig {\n    preserveFirst: number;\n    preserveLast: number;\n    triggerThreshold: number; // e.g. 0.8\n}\n\n/**\n * Sandwich compression preserves the beginning and end of the conversation,\n * replacing the middle with a generated summary.\n */\nexport class SandwichCompressionStrategy implements IContextStrategy {\n    readonly name = 'sandwich_compression';\n    readonly priority = 20;\n\n    constructor(\n        private adapter: IProviderAdapter,\n        private config: SandwichCompressionConfig\n    ) { }\n\n    shouldApply(ctx: ContextWindow): boolean {\n        return (\n            ctx.tokenCount >= ctx.maxTokens * this.config.triggerThreshold &&\n            ctx.turns.length > this.config.preserveFirst + this.config.preserveLast\n        );\n    }\n\n    async apply(ctx: ContextWindow): Promise<ContextWindow> {\n        const { preserveFirst, preserveLast } = this.config;\n\n        const head = ctx.turns.slice(0, preserveFirst);\n        const tail = ctx.turns.slice(ctx.turns.length - preserveLast);\n        const middle = ctx.turns.slice(preserveFirst, ctx.turns.length - preserveLast);\n\n        const middleText = middle.map(t => `${t.role}: ${JSON.stringify(t.content)}`).join('\\n');\n\n        const summaryResponse = await this.adapter.complete({\n            model: '',\n            messages: [{\n                role: 'user',\n                content: `Summarize the following conversation history briefly:\\n${middleText}`\n            }]\n        });\n\n        const summaryStr = summaryResponse.content;\n\n        const newCompressionSummary = ctx.compressionSummary\n            ? `${ctx.compressionSummary}\\n${summaryStr}`\n            : summaryStr;\n\n        const summaryTurn: Turn = {\n            role: 'system',\n            content: `[COMPRESSED HISTORY SUMMARY]\\n${newCompressionSummary}`,\n            tokenCount: this.adapter.estimateTokens(newCompressionSummary),\n            turnIndex: -1,\n            compressed: true,\n        };\n\n        const newTurns = [...head, summaryTurn, ...tail];\n        const newTokenCount = newTurns.reduce((sum, t) => sum + t.tokenCount, 0) +\n            this.adapter.estimateTokens(ctx.systemPrompt) +\n            this.adapter.estimateTokens(ctx.scratchpad);\n\n        return {\n            ...ctx,\n            turns: newTurns,\n            tokenCount: newTokenCount,\n            compressionSummary: newCompressionSummary,\n        };\n    }\n\n    /**\n     * Applies sandwich compression specifically to a Short Term Memory item's content.\n     * Implements a 3-layer pipeline: Pre-Layer (encoding), Core Layer (dense summary), Post-Layer (refinement cues).\n     * \n     * @param content - The heavy text content to compress\n     * @param instructions - Guiding instructions for the core layer summary\n     * @returns The three-layer sandwich result\n     */\n    async compressMemoryItem(content: string, instructions: string = 'Extract the key information'): Promise<{\n        preLayer: string;\n        coreLayer: string;\n        postLayer: string;\n    }> {\n        // Pre-Layer: Chunking and initial encoding\n        // Here we do a naive encoding representation to signify the pre-processed chunks\n        const estimatedChunks = Math.max(1, Math.ceil(this.adapter.estimateTokens(content) / 2000));\n        const preLayer = `[PRE-LAYER ENCODED: ${estimatedChunks} internal chunks]`;\n\n        // Core Layer: Dense summary sandwich with instructions\n        // We sandwich the content between the instructions to guide extraction\n        // If content is extremely large, we might trim it here, but ideally the provider streaming handles it.\n        const summaryResponse = await this.adapter.complete({\n            model: '',\n            messages: [{\n                role: 'user',\n                content: `### INSTRUCTIONS ###\\n${instructions}\\n\\n### CONTENT ###\\n${content}\\n\\n### INSTRUCTIONS ###\\n${instructions}`\n            }]\n        });\n        const coreLayer = summaryResponse.content;\n\n        // Post-Layer: Decoding/Refinement hooks\n        // Indicates that the LLM can use tools to drill down into specific chunks\n        const postLayer = `[POST-LAYER DECODING: Use \\`refine_layer\\` or \\`read_chunk\\` tools to expand specific sections]`;\n\n        return { preLayer, coreLayer, postLayer };\n    }\n}\n","import { ContextWindow, IContextStrategy, IProviderAdapter, Turn } from '../types/index.js';\n\n/**\n * ScratchpadStrategy manages the thinking process separate from the turn history.\n * It is primarily a marker/pre-turn strategy that ensures scratchpad gets tokenized properly\n * but is not compressed.\n */\nexport class ScratchpadStrategy implements IContextStrategy {\n    readonly name = 'scratchpad_strategy';\n    readonly priority = 10;\n\n    shouldApply(ctx: ContextWindow): boolean {\n        // Only apply if there's actual scratchpad content to track\n        return ctx.scratchpad.length > 0;\n    }\n\n    async apply(ctx: ContextWindow): Promise<ContextWindow> {\n        // Basic implementation: we don't compress the scratchpad, we just ensure its tokens are counted\n        return ctx;\n    }\n}\n\nexport interface HistoryCompressionConfig {\n    windowSize: number;\n    triggerAtPercent: number; // e.g. 0.8\n}\n\n/**\n * Operates on a rolling window of the oldest N turns and summarizes them.\n */\nexport class HistoryCompressionStrategy implements IContextStrategy {\n    readonly name = 'history_compression';\n    readonly priority = 30;\n\n    constructor(\n        private adapter: IProviderAdapter,\n        private config: HistoryCompressionConfig\n    ) { }\n\n    shouldApply(ctx: ContextWindow): boolean {\n        const triggerTokens = ctx.maxTokens * this.config.triggerAtPercent;\n        // Apply if we are over the trigger threshold and have at least enough turns\n        // Ignore system prompts and already compressed turns\n        const uncompressedTurns = ctx.turns.filter(t => t.role !== 'system' && !t.compressed);\n        return ctx.tokenCount >= triggerTokens && uncompressedTurns.length > this.config.windowSize;\n    }\n\n    async apply(ctx: ContextWindow): Promise<ContextWindow> {\n        // Find the oldest N uncompressed turns that aren't the system prompt\n        const uncompressedIndices = ctx.turns\n            .map((t, i) => ({ t, i }))\n            .filter(({ t }) => t.role !== 'system' && !t.compressed)\n            .slice(0, this.config.windowSize);\n\n        const targetTurns = uncompressedIndices.map(u => u.t);\n        const middleText = targetTurns.map(t => `${t.role}: ${JSON.stringify(t.content)}`).join('\\n');\n\n        const summaryResponse = await this.adapter.complete({\n            model: '',\n            messages: [{\n                role: 'user',\n                content: `Summarize the oldest part of this conversation:\\n${middleText}`\n            }]\n        });\n\n        const summaryStr = summaryResponse.content;\n        const newCompressionSummary = ctx.compressionSummary\n            ? `${ctx.compressionSummary}\\n${summaryStr}`\n            : summaryStr;\n\n        // Filter out the summarized turns\n        const indicesToRemove = new Set(uncompressedIndices.map(u => u.i));\n        const newTurns = ctx.turns.filter((_, i) => !indicesToRemove.has(i));\n\n        const TokenCount = newTurns.reduce((sum, t) => sum + t.tokenCount, 0) +\n            this.adapter.estimateTokens(ctx.systemPrompt) +\n            this.adapter.estimateTokens(ctx.scratchpad);\n\n        return {\n            ...ctx,\n            turns: newTurns,\n            tokenCount: TokenCount,\n            compressionSummary: newCompressionSummary,\n        };\n    }\n}\n","import { IStorageAdapter, STMItem } from '../types/index.js';\nimport { randomUUID } from 'crypto';\n\nexport interface STMRegistryConfig {\n    /**\n     * The storage backend to use for Short Term Memory items.\n     */\n    storage: IStorageAdapter;\n\n    /**\n     * The maximum number of tokens allowed for a 'text' type STM item.\n     * If an item exceeds this, it may be rejected or truncated.\n     * Default: 100000\n     */\n    maxTextTokens?: number;\n}\n\n/**\n * Registry for Short Term Memory (STM).\n * Manages the storage and retrieval of large context variables like long texts or blobs.\n * Generates '[STM:uuid]' references to be used within the ReAct agent context.\n */\nexport class ShortTermMemoryRegistry {\n    private storage: IStorageAdapter;\n    private maxTextTokens: number;\n\n    constructor(config: STMRegistryConfig) {\n        this.storage = config.storage;\n        this.maxTextTokens = config.maxTextTokens ?? 100000;\n    }\n\n    /**\n     * Registers a new memory item and returns its reference string.\n     * \n     * @param content - The raw content to store\n     * @param type - The type of content ('text' or 'blob')\n     * @param metadata - Optional metadata (e.g. sandwich layers, original filename)\n     * @param estimateTokens - Optional function to estimate token count for 'text' type\n     * @returns A reference string formatted as '[STM:uuid]'\n     * @throws {Error} if a text item exceeds the maxTextTokens limit\n     */\n    async register(\n        content: any,\n        type: 'text' | 'blob',\n        metadata?: Record<string, unknown>,\n        estimateTokens?: (text: string) => number\n    ): Promise<string> {\n        if (type === 'text') {\n            const tokenCount = estimateTokens ? estimateTokens(content) : Math.ceil(String(content).length / 4);\n            if (tokenCount > this.maxTextTokens) {\n                throw new Error(`Text content exceeds max tokens limit of ${this.maxTextTokens} (estimated ${tokenCount})`);\n            }\n        }\n\n        const id = randomUUID();\n        const item: STMItem = {\n            id,\n            content,\n            type,\n            ...(metadata !== undefined ? { metadata } : {})\n        };\n\n        await this.storage.set(id, item);\n        return `[STM:${id}]`;\n    }\n\n    /**\n     * Updates an existing STM item's content or metadata.\n     * \n     * @param id - The UUID of the item to update\n     * @param updates - Partial updates to apply (content or metadata)\n     */\n    async update(id: string, updates: { content?: any; metadata?: Record<string, unknown> }): Promise<void> {\n        const item = await this.storage.get(id);\n        if (!item) throw new Error(`STM item not found for update: ${id}`);\n\n        const updatedItem: STMItem = {\n            ...item,\n            ...(updates.content !== undefined ? { content: updates.content } : {}),\n            ...(updates.metadata !== undefined ? { metadata: { ...item.metadata, ...updates.metadata } } : {})\n        };\n\n        await this.storage.set(id, updatedItem);\n    }\n\n\n    /**\n     * Retrieves an STM item by its full reference string (e.g., '[STM:uuid]').\n     * \n     * @param ref - The full reference string\n     * @returns The STMItem or undefined if not found\n     */\n    async getByRef(ref: string): Promise<STMItem | undefined> {\n        const match = ref.match(/^\\[STM:(.+)\\]$/);\n        if (!match || !match[1]) return undefined;\n        return this.storage.get(match[1]);\n    }\n\n    /**\n     * Deletes an STM item by its ID.\n     * \n     * @param id - The UUID of the item to delete\n     */\n    async delete(id: string): Promise<void> {\n        await this.storage.delete(id);\n    }\n}\n","import { IStorageAdapter } from '../types/index.js';\nimport { randomUUID } from 'crypto';\n\n/**\n * An in-memory implementation of IStorageAdapter for holding Short Term Memory.\n * Ideal for testing or single-process lightweight usage.\n *\n * @example\n * const storage = new InMemoryStorageAdapter();\n * const id = await storage.set(undefined, 'my content', { type: 'text' });\n * const retrieved = await storage.get(id);\n */\nexport class InMemoryStorageAdapter implements IStorageAdapter {\n    private store = new Map<string, { content: any; metadata?: Record<string, unknown> }>();\n\n    /**\n     * Retrieves stored content by ID.\n     *\n     * @param id - The identifier of the stored item\n     * @returns The stored content or undefined if not found\n     */\n    async get(id: string): Promise<any | undefined> {\n        return this.store.get(id)?.content;\n    }\n\n    /**\n     * Returns the full item including metadata.\n     *\n     * @param id - The identifier of the stored item\n     * @returns The complete item with content and metadata\n     * @internal\n     */\n    async getFull(id: string): Promise<{ content: any; metadata?: Record<string, unknown> } | undefined> {\n        return this.store.get(id);\n    }\n\n    /**\n     * Stores content, generating an ID if none is provided.\n     *\n     * @param id - Optional provided ID. If omitted, a UUID is generated.\n     * @param content - The content to store\n     * @param metadata - Optional metadata\n     * @returns The ID under which the content is stored\n     */\n    async set(id: string | undefined, content: any, metadata?: Record<string, unknown>): Promise<string> {\n        const resolvedId = id ?? randomUUID();\n        this.store.set(resolvedId, metadata !== undefined ? { content, metadata } : { content });\n        return resolvedId;\n    }\n\n    /**\n     * Deletes the content for the given ID.\n     *\n     * @param id - The identifier of the item to delete\n     */\n    async delete(id: string): Promise<void> {\n        this.store.delete(id);\n    }\n\n    /**\n     * Synchronous health check, always true for in-memory.\n     *\n     * @returns true\n     */\n    async healthCheck(): Promise<boolean> {\n        return true;\n    }\n}\n"]}

package/dist/index.d.mts

@@ -0,0 +1,91 @@
+import { C as ContextWindow, T as Turn, a as ContentBlock } from './adapters-BnG0LEYD.mjs';
+export { A as AudioChunk, b as CompletionChunk, c as CompletionRequest, d as CompletionResponse, I as IContextStrategy, e as IProviderAdapter, f as ImageGenRequest, g as ImageGenResponse, M as ModelInfo, N as NormalizedMessage, S as SynthesisRequest, h as TokenUsage, i as ToolCall, j as ToolResult, k as TranscriptionRequest, l as TranscriptionResponse, V as VisionRequest, m as VisionResponse } from './adapters-BnG0LEYD.mjs';
+import { SessionConfig, IToolResponseProcessor, ToolResponseEvaluation } from './types/index.mjs';
+export { LemuraAdapterError, LemuraContextOverflowError, LemuraError, LemuraMaxIterationsError, LemuraSkillInjectionError, LemuraToolNotFoundError, LemuraToolTimeoutError, LemuraToolValidationError } from './types/index.mjs';
+export { I as ILogger, L as LogLevel, a as LogMetadata, S as Severity } from './logger-DxvKliuk.mjs';
+export { I as IRAGAdapter, R as RAGDocument, a as RAGIngestOptions, b as RAGIngestRequest, c as RAGIngestResponse, d as RAGQueryRequest, e as RAGQueryResponse, f as RAGResult } from './rag-La_Bo-J8.mjs';
+export { I as ISkill } from './skills-wc8S-OvC.mjs';
+import { I as IToolDefinition } from './storage-DMcliVVj.mjs';
+export { a as IStorageAdapter, S as STMItem, b as STMRegistryConfig, c as ShortTermMemoryRegistry, T as ToolContext } from './storage-DMcliVVj.mjs';
+export { OpenAICompatibleAdapter, OpenAICompatibleAdapterConfig, RetryConfig } from './adapters/index.mjs';
+export { ContextManager, HistoryCompressionConfig, HistoryCompressionStrategy, InMemoryStorageAdapter, SandwichCompressionConfig, SandwichCompressionStrategy, ScratchpadStrategy } from './context/index.mjs';
+export { ToolRegistry } from './tools/index.mjs';
+export { SkillInjector } from './skills/index.mjs';
+export { InMemoryRAGAdapter } from './rag/index.mjs';
+export { DefaultLogger } from './logger/index.mjs';
+
+declare class SessionManager {
+    private contextManager;
+    private toolRegistry;
+    private skillInjector;
+    private context;
+    private adapter;
+    private config;
+    private iterations;
+    private logger;
+    constructor(config: SessionConfig);
+    getContext(): ContextWindow;
+    getHistory(): Turn[];
+    run(userMessage: string | ContentBlock[]): Promise<string>;
+}
+
+/**
+ * Advanced Execution: ToolResponseProcessor handles compression
+ * and evaluation of tool outputs, flagging errors, mapping tool size classes
+ * and compressing large responses to save token bandwidth.
+ */
+declare class ToolResponseProcessor implements IToolResponseProcessor {
+    evaluate(response: string, tool: IToolDefinition, context: unknown): ToolResponseEvaluation;
+    compress(response: string, evaluation: ToolResponseEvaluation): string;
+}
+
+interface Goal {
+    id: string;
+    statement: string;
+    decomposition: string[];
+    successCriteria: string[];
+    injectionFrequency: 'always' | 'every_N_turns' | 'on_compression';
+    injectionPosition: 'system_prompt' | 'pre_turn';
+}
+declare class GoalInjector {
+    private goal;
+    constructor(goal: Goal);
+    injectInto(prompt: string): string;
+}
+
+interface ContinuationStep {
+    stepId: string;
+    toolName: string;
+    description: string;
+    dependsOn: string[];
+    status: 'pending' | 'running' | 'done' | 'failed' | 'skipped';
+    outputKey?: string;
+    inputMapping?: Record<string, string>;
+}
+interface ContinuationPlan {
+    steps: ContinuationStep[];
+    currentStepIndex: number;
+    strategy: 'sequential' | 'parallel' | 'conditional';
+}
+declare class ContinuationPlanner {
+    private plan;
+    constructor(plan: ContinuationPlan);
+    getPlanStatusString(): string;
+}
+
+declare class StepCounter {
+    private maxSteps;
+    private toolCallCount;
+    constructor(maxSteps?: number);
+    increment(count?: number): void;
+    get count(): number;
+    isMaxReached(): boolean;
+    getForcedConclusionPrompt(): string;
+}
+
+declare class FinalResponseFormatter {
+    static getRequiredStructure(): string;
+    static validateStructure(response: string): boolean;
+}
+
+export { ContentBlock, ContextWindow, type ContinuationPlan, ContinuationPlanner, type ContinuationStep, FinalResponseFormatter, type Goal, GoalInjector, IToolDefinition, IToolResponseProcessor, SessionConfig, SessionManager, StepCounter, ToolResponseEvaluation, ToolResponseProcessor, Turn };

package/dist/index.d.ts

@@ -0,0 +1,91 @@
+import { C as ContextWindow, T as Turn, a as ContentBlock } from './adapters-BSkhv5ac.js';
+export { A as AudioChunk, b as CompletionChunk, c as CompletionRequest, d as CompletionResponse, I as IContextStrategy, e as IProviderAdapter, f as ImageGenRequest, g as ImageGenResponse, M as ModelInfo, N as NormalizedMessage, S as SynthesisRequest, h as TokenUsage, i as ToolCall, j as ToolResult, k as TranscriptionRequest, l as TranscriptionResponse, V as VisionRequest, m as VisionResponse } from './adapters-BSkhv5ac.js';
+import { SessionConfig, IToolResponseProcessor, ToolResponseEvaluation } from './types/index.js';
+export { LemuraAdapterError, LemuraContextOverflowError, LemuraError, LemuraMaxIterationsError, LemuraSkillInjectionError, LemuraToolNotFoundError, LemuraToolTimeoutError, LemuraToolValidationError } from './types/index.js';
+export { I as ILogger, L as LogLevel, a as LogMetadata, S as Severity } from './logger-DxvKliuk.js';
+export { I as IRAGAdapter, R as RAGDocument, a as RAGIngestOptions, b as RAGIngestRequest, c as RAGIngestResponse, d as RAGQueryRequest, e as RAGQueryResponse, f as RAGResult } from './rag-La_Bo-J8.js';
+export { I as ISkill } from './skills-wc8S-OvC.js';
+import { I as IToolDefinition } from './storage-BGu4Loao.js';
+export { a as IStorageAdapter, S as STMItem, b as STMRegistryConfig, c as ShortTermMemoryRegistry, T as ToolContext } from './storage-BGu4Loao.js';
+export { OpenAICompatibleAdapter, OpenAICompatibleAdapterConfig, RetryConfig } from './adapters/index.js';
+export { ContextManager, HistoryCompressionConfig, HistoryCompressionStrategy, InMemoryStorageAdapter, SandwichCompressionConfig, SandwichCompressionStrategy, ScratchpadStrategy } from './context/index.js';
+export { ToolRegistry } from './tools/index.js';
+export { SkillInjector } from './skills/index.js';
+export { InMemoryRAGAdapter } from './rag/index.js';
+export { DefaultLogger } from './logger/index.js';
+
+declare class SessionManager {
+    private contextManager;
+    private toolRegistry;
+    private skillInjector;
+    private context;
+    private adapter;
+    private config;
+    private iterations;
+    private logger;
+    constructor(config: SessionConfig);
+    getContext(): ContextWindow;
+    getHistory(): Turn[];
+    run(userMessage: string | ContentBlock[]): Promise<string>;
+}
+
+/**
+ * Advanced Execution: ToolResponseProcessor handles compression
+ * and evaluation of tool outputs, flagging errors, mapping tool size classes
+ * and compressing large responses to save token bandwidth.
+ */
+declare class ToolResponseProcessor implements IToolResponseProcessor {
+    evaluate(response: string, tool: IToolDefinition, context: unknown): ToolResponseEvaluation;
+    compress(response: string, evaluation: ToolResponseEvaluation): string;
+}
+
+interface Goal {
+    id: string;
+    statement: string;
+    decomposition: string[];
+    successCriteria: string[];
+    injectionFrequency: 'always' | 'every_N_turns' | 'on_compression';
+    injectionPosition: 'system_prompt' | 'pre_turn';
+}
+declare class GoalInjector {
+    private goal;
+    constructor(goal: Goal);
+    injectInto(prompt: string): string;
+}
+
+interface ContinuationStep {
+    stepId: string;
+    toolName: string;
+    description: string;
+    dependsOn: string[];
+    status: 'pending' | 'running' | 'done' | 'failed' | 'skipped';
+    outputKey?: string;
+    inputMapping?: Record<string, string>;
+}
+interface ContinuationPlan {
+    steps: ContinuationStep[];
+    currentStepIndex: number;
+    strategy: 'sequential' | 'parallel' | 'conditional';
+}
+declare class ContinuationPlanner {
+    private plan;
+    constructor(plan: ContinuationPlan);
+    getPlanStatusString(): string;
+}
+
+declare class StepCounter {
+    private maxSteps;
+    private toolCallCount;
+    constructor(maxSteps?: number);
+    increment(count?: number): void;
+    get count(): number;
+    isMaxReached(): boolean;
+    getForcedConclusionPrompt(): string;
+}
+
+declare class FinalResponseFormatter {
+    static getRequiredStructure(): string;
+    static validateStructure(response: string): boolean;
+}
+
+export { ContentBlock, ContextWindow, type ContinuationPlan, ContinuationPlanner, type ContinuationStep, FinalResponseFormatter, type Goal, GoalInjector, IToolDefinition, IToolResponseProcessor, SessionConfig, SessionManager, StepCounter, ToolResponseEvaluation, ToolResponseProcessor, Turn };