orkajs 1.0.0

package/dist/chunk-4IT37CSA.js

@@ -0,0 +1,54 @@
+import { withRetry } from './chunk-QPL7SRL7.js';
+
+// src/resilience/resilient-llm.ts
+var DEFAULT_RETRYABLE_PATTERNS = [
+  "rate limit",
+  "Rate limit",
+  "429",
+  "500",
+  "502",
+  "503",
+  "timeout",
+  "ETIMEDOUT",
+  "ECONNRESET",
+  "ECONNREFUSED",
+  "AbortError",
+  "timed out"
+];
+var ResilientLLM = class {
+  name;
+  llm;
+  retryOptions;
+  constructor(config) {
+    this.llm = config.llm;
+    this.name = `resilient-${config.llm.name}`;
+    this.retryOptions = {
+      maxRetries: 3,
+      initialDelayMs: 1e3,
+      maxDelayMs: 3e4,
+      backoffMultiplier: 2,
+      retryableErrors: DEFAULT_RETRYABLE_PATTERNS,
+      onRetry: config.onRetry,
+      ...config.retry
+    };
+  }
+  async generate(prompt, options) {
+    return withRetry(
+      () => this.llm.generate(prompt, options),
+      this.retryOptions
+    );
+  }
+  async embed(texts) {
+    return withRetry(
+      () => this.llm.embed(texts),
+      this.retryOptions
+    );
+  }
+  getInnerLLM() {
+    return this.llm;
+  }
+};
+
+export { ResilientLLM };
+//# sourceMappingURL=chunk-4IT37CSA.js.map
+//# sourceMappingURL=chunk-4IT37CSA.js.map

package/dist/chunk-4IT37CSA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resilience/resilient-llm.ts"],"names":[],"mappings":";;;AASA,IAAM,0BAAA,GAA6B;AAAA,EACjC,YAAA;AAAA,EACA,YAAA;AAAA,EACA,KAAA;AAAA,EACA,KAAA;AAAA,EACA,KAAA;AAAA,EACA,KAAA;AAAA,EACA,SAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA,cAAA;AAAA,EACA,YAAA;AAAA,EACA;AACF,CAAA;AAEO,IAAM,eAAN,MAAyC;AAAA,EACrC,IAAA;AAAA,EACD,GAAA;AAAA,EACA,YAAA;AAAA,EAER,YAAY,MAAA,EAA4B;AACtC,IAAA,IAAA,CAAK,MAAM,MAAA,CAAO,GAAA;AAClB,IAAA,IAAA,CAAK,IAAA,GAAO,CAAA,UAAA,EAAa,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA,CAAA;AACxC,IAAA,IAAA,CAAK,YAAA,GAAe;AAAA,MAClB,UAAA,EAAY,CAAA;AAAA,MACZ,cAAA,EAAgB,GAAA;AAAA,MAChB,UAAA,EAAY,GAAA;AAAA,MACZ,iBAAA,EAAmB,CAAA;AAAA,MACnB,eAAA,EAAiB,0BAAA;AAAA,MACjB,SAAS,MAAA,CAAO,OAAA;AAAA,MAChB,GAAG,MAAA,CAAO;AAAA,KACZ;AAAA,EACF;AAAA,EAEA,MAAM,QAAA,CAAS,MAAA,EAAgB,OAAA,EAAkD;AAC/E,IAAA,OAAO,SAAA;AAAA,MACL,MAAM,IAAA,CAAK,GAAA,CAAI,QAAA,CAAS,QAAQ,OAAO,CAAA;AAAA,MACvC,IAAA,CAAK;AAAA,KACP;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,KAAA,EAA+C;AACzD,IAAA,OAAO,SAAA;AAAA,MACL,MAAM,IAAA,CAAK,GAAA,CAAI,KAAA,CAAM,KAAK,CAAA;AAAA,MAC1B,IAAA,CAAK;AAAA,KACP;AAAA,EACF;AAAA,EAEA,WAAA,GAA0B;AACxB,IAAA,OAAO,IAAA,CAAK,GAAA;AAAA,EACd;AACF","file":"chunk-4IT37CSA.js","sourcesContent":["import type { LLMAdapter, LLMGenerateOptions, LLMResult } from '../types/index.js';\nimport { withRetry, type RetryOptions } from './retry.js';\n\nexport interface ResilientLLMConfig {\n  llm: LLMAdapter;\n  retry?: RetryOptions;\n  onRetry?: (error: Error, attempt: number) => void;\n}\n\nconst DEFAULT_RETRYABLE_PATTERNS = [\n  'rate limit',\n  'Rate limit',\n  '429',\n  '500',\n  '502',\n  '503',\n  'timeout',\n  'ETIMEDOUT',\n  'ECONNRESET',\n  'ECONNREFUSED',\n  'AbortError',\n  'timed out',\n];\n\nexport class ResilientLLM implements LLMAdapter {\n  readonly name: string;\n  private llm: LLMAdapter;\n  private retryOptions: RetryOptions;\n\n  constructor(config: ResilientLLMConfig) {\n    this.llm = config.llm;\n    this.name = `resilient-${config.llm.name}`;\n    this.retryOptions = {\n      maxRetries: 3,\n      initialDelayMs: 1000,\n      maxDelayMs: 30000,\n      backoffMultiplier: 2,\n      retryableErrors: DEFAULT_RETRYABLE_PATTERNS,\n      onRetry: config.onRetry,\n      ...config.retry,\n    };\n  }\n\n  async generate(prompt: string, options?: LLMGenerateOptions): Promise<LLMResult> {\n    return withRetry(\n      () => this.llm.generate(prompt, options),\n      this.retryOptions,\n    );\n  }\n\n  async embed(texts: string | string[]): Promise<number[][]> {\n    return withRetry(\n      () => this.llm.embed(texts),\n      this.retryOptions,\n    );\n  }\n\n  getInnerLLM(): LLMAdapter {\n    return this.llm;\n  }\n}\n"]}

package/dist/chunk-4NMX7YMQ.cjs

@@ -0,0 +1,185 @@
+'use strict';
+
+var chunkSTW4N4DQ_cjs = require('./chunk-STW4N4DQ.cjs');
+var chunkBBUZ6P5S_cjs = require('./chunk-BBUZ6P5S.cjs');
+
+// src/core/knowledge.ts
+var Knowledge = class {
+  llm;
+  vectorDB;
+  defaults;
+  collections = /* @__PURE__ */ new Map();
+  constructor(llm, vectorDB, defaults = {}) {
+    this.llm = llm;
+    this.vectorDB = vectorDB;
+    this.defaults = defaults;
+  }
+  async create(options) {
+    const {
+      name,
+      source,
+      chunkSize = this.defaults.chunkSize ?? 1e3,
+      chunkOverlap = this.defaults.chunkOverlap ?? 200,
+      metadata = {}
+    } = options;
+    const documents = await this.sourceToDocuments(source, metadata);
+    const chunks = chunkSTW4N4DQ_cjs.chunkDocuments(documents, { chunkSize, chunkOverlap });
+    if (chunks.length === 0) {
+      throw new Error("No content to index");
+    }
+    const embeddings = await this.llm.embed(chunks.map((c) => c.content));
+    const dimension = embeddings[0].length;
+    await this.vectorDB.createCollection(name, { dimension, metric: "cosine" });
+    this.collections.set(name, { dimension });
+    const vectors = chunks.map((chunk, i) => ({
+      id: chunk.id,
+      vector: embeddings[i],
+      content: chunk.content,
+      metadata: {
+        ...chunk.metadata,
+        documentId: chunk.documentId,
+        chunkIndex: chunk.index
+      }
+    }));
+    const batchSize = 100;
+    for (let i = 0; i < vectors.length; i += batchSize) {
+      await this.vectorDB.upsert(name, vectors.slice(i, i + batchSize));
+    }
+    return {
+      name,
+      documentCount: documents.length,
+      chunkCount: chunks.length
+    };
+  }
+  async add(name, source, options = {}) {
+    const {
+      chunkSize = this.defaults.chunkSize ?? 1e3,
+      chunkOverlap = this.defaults.chunkOverlap ?? 200,
+      metadata = {}
+    } = options;
+    const documents = await this.sourceToDocuments(source, metadata);
+    const chunks = chunkSTW4N4DQ_cjs.chunkDocuments(documents, { chunkSize, chunkOverlap });
+    if (chunks.length === 0) {
+      return { addedChunks: 0 };
+    }
+    const embeddings = await this.llm.embed(chunks.map((c) => c.content));
+    const vectors = chunks.map((chunk, i) => ({
+      id: chunk.id,
+      vector: embeddings[i],
+      content: chunk.content,
+      metadata: {
+        ...chunk.metadata,
+        documentId: chunk.documentId,
+        chunkIndex: chunk.index
+      }
+    }));
+    const batchSize = 100;
+    for (let i = 0; i < vectors.length; i += batchSize) {
+      await this.vectorDB.upsert(name, vectors.slice(i, i + batchSize));
+    }
+    return { addedChunks: chunks.length };
+  }
+  async search(name, query, options = {}) {
+    const { topK = this.defaults.topK ?? 5, minScore } = options;
+    const [queryEmbedding] = await this.llm.embed([query]);
+    return this.vectorDB.search(name, queryEmbedding, { topK, minScore });
+  }
+  async delete(name) {
+    await this.vectorDB.deleteCollection(name);
+    this.collections.delete(name);
+  }
+  async sourceToDocuments(source, baseMetadata) {
+    if (typeof source === "string") {
+      return [{
+        id: chunkBBUZ6P5S_cjs.generateId(),
+        content: source,
+        metadata: baseMetadata
+      }];
+    }
+    if (Array.isArray(source)) {
+      if (source.length === 0) return [];
+      if (typeof source[0] === "string") {
+        return source.map((text) => ({
+          id: chunkBBUZ6P5S_cjs.generateId(),
+          content: text,
+          metadata: baseMetadata
+        }));
+      }
+      return source.map((item) => ({
+        id: chunkBBUZ6P5S_cjs.generateId(),
+        content: item.text,
+        metadata: { ...baseMetadata, ...item.metadata }
+      }));
+    }
+    if ("path" in source) {
+      const fs = await import('fs/promises');
+      const path = await import('path');
+      const stat = await fs.stat(source.path);
+      if (stat.isFile()) {
+        const content = await fs.readFile(source.path, "utf-8");
+        return [{
+          id: chunkBBUZ6P5S_cjs.generateId(),
+          content,
+          metadata: { ...baseMetadata, sourcePath: source.path }
+        }];
+      }
+      if (stat.isDirectory()) {
+        const files = await fs.readdir(source.path);
+        const documents = [];
+        for (const file of files) {
+          const filePath = path.join(source.path, file);
+          const fileStat = await fs.stat(filePath);
+          if (fileStat.isFile() && this.isTextFile(file)) {
+            const content = await fs.readFile(filePath, "utf-8");
+            documents.push({
+              id: chunkBBUZ6P5S_cjs.generateId(),
+              content,
+              metadata: { ...baseMetadata, sourcePath: filePath, fileName: file }
+            });
+          }
+        }
+        return documents;
+      }
+    }
+    if ("url" in source) {
+      const parsedUrl = new URL(source.url);
+      if (!["http:", "https:"].includes(parsedUrl.protocol)) {
+        throw new Error(`Unsupported URL protocol: ${parsedUrl.protocol}. Only http and https are allowed.`);
+      }
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), 3e4);
+      try {
+        const response = await fetch(source.url, { signal: controller.signal });
+        if (!response.ok) {
+          throw new Error(`Failed to fetch URL: ${response.status} ${response.statusText}`);
+        }
+        const contentLength = response.headers.get("content-length");
+        if (contentLength && parseInt(contentLength) > 5e7) {
+          throw new Error("URL content exceeds 50MB limit");
+        }
+        const content = await response.text();
+        return [{
+          id: chunkBBUZ6P5S_cjs.generateId(),
+          content,
+          metadata: { ...baseMetadata, sourceUrl: source.url }
+        }];
+      } catch (error) {
+        if (error.name === "AbortError") {
+          throw new Error(`URL fetch timed out after 30s: ${source.url}`);
+        }
+        throw error;
+      } finally {
+        clearTimeout(timeout);
+      }
+    }
+    throw new Error("Invalid source format");
+  }
+  isTextFile(filename) {
+    const textExtensions = [".txt", ".md", ".json", ".csv", ".html", ".xml", ".yaml", ".yml", ".js", ".ts", ".py", ".java", ".c", ".cpp", ".h", ".css", ".scss", ".sql"];
+    return textExtensions.some((ext) => filename.toLowerCase().endsWith(ext));
+  }
+};
+
+exports.Knowledge = Knowledge;
+//# sourceMappingURL=chunk-4NMX7YMQ.cjs.map
+//# sourceMappingURL=chunk-4NMX7YMQ.cjs.map

package/dist/chunk-4NMX7YMQ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/knowledge.ts"],"names":["chunkDocuments","generateId"],"mappings":"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","file":"chunk-4NMX7YMQ.cjs","sourcesContent":["import type { \n  LLMAdapter, \n  VectorDBAdapter, \n  KnowledgeCreateOptions, \n  KnowledgeSource,\n  Document,\n  VectorSearchResult,\n  OrkaDefaults\n} from '../types/index.js';\nimport { chunkDocuments } from './chunker.js';\nimport { generateId } from '../utils/id.js';\n\nexport class Knowledge {\n  private llm: LLMAdapter;\n  private vectorDB: VectorDBAdapter;\n  private defaults: OrkaDefaults;\n  private collections: Map<string, { dimension: number }> = new Map();\n\n  constructor(llm: LLMAdapter, vectorDB: VectorDBAdapter, defaults: OrkaDefaults = {}) {\n    this.llm = llm;\n    this.vectorDB = vectorDB;\n    this.defaults = defaults;\n  }\n\n  async create(options: KnowledgeCreateOptions): Promise<{ name: string; documentCount: number; chunkCount: number }> {\n    const { \n      name, \n      source, \n      chunkSize = this.defaults.chunkSize ?? 1000,\n      chunkOverlap = this.defaults.chunkOverlap ?? 200,\n      metadata = {}\n    } = options;\n\n    const documents = await this.sourceToDocuments(source, metadata);\n    const chunks = chunkDocuments(documents, { chunkSize, chunkOverlap });\n\n    if (chunks.length === 0) {\n      throw new Error('No content to index');\n    }\n\n    const embeddings = await this.llm.embed(chunks.map(c => c.content));\n    const dimension = embeddings[0].length;\n\n    await this.vectorDB.createCollection(name, { dimension, metric: 'cosine' });\n    this.collections.set(name, { dimension });\n\n    const vectors = chunks.map((chunk, i) => ({\n      id: chunk.id,\n      vector: embeddings[i],\n      content: chunk.content,\n      metadata: {\n        ...chunk.metadata,\n        documentId: chunk.documentId,\n        chunkIndex: chunk.index,\n      },\n    }));\n\n    const batchSize = 100;\n    for (let i = 0; i < vectors.length; i += batchSize) {\n      await this.vectorDB.upsert(name, vectors.slice(i, i + batchSize));\n    }\n\n    return {\n      name,\n      documentCount: documents.length,\n      chunkCount: chunks.length,\n    };\n  }\n\n  async add(name: string, source: KnowledgeSource, options: { chunkSize?: number; chunkOverlap?: number; metadata?: Record<string, unknown> } = {}): Promise<{ addedChunks: number }> {\n    const { \n      chunkSize = this.defaults.chunkSize ?? 1000,\n      chunkOverlap = this.defaults.chunkOverlap ?? 200,\n      metadata = {}\n    } = options;\n\n    const documents = await this.sourceToDocuments(source, metadata);\n    const chunks = chunkDocuments(documents, { chunkSize, chunkOverlap });\n\n    if (chunks.length === 0) {\n      return { addedChunks: 0 };\n    }\n\n    const embeddings = await this.llm.embed(chunks.map(c => c.content));\n\n    const vectors = chunks.map((chunk, i) => ({\n      id: chunk.id,\n      vector: embeddings[i],\n      content: chunk.content,\n      metadata: {\n        ...chunk.metadata,\n        documentId: chunk.documentId,\n        chunkIndex: chunk.index,\n      },\n    }));\n\n    const batchSize = 100;\n    for (let i = 0; i < vectors.length; i += batchSize) {\n      await this.vectorDB.upsert(name, vectors.slice(i, i + batchSize));\n    }\n\n    return { addedChunks: chunks.length };\n  }\n\n  async search(name: string, query: string, options: { topK?: number; minScore?: number } = {}): Promise<VectorSearchResult[]> {\n    const { topK = this.defaults.topK ?? 5, minScore } = options;\n\n    const [queryEmbedding] = await this.llm.embed([query]);\n    \n    return this.vectorDB.search(name, queryEmbedding, { topK, minScore });\n  }\n\n  async delete(name: string): Promise<void> {\n    await this.vectorDB.deleteCollection(name);\n    this.collections.delete(name);\n  }\n\n  private async sourceToDocuments(source: KnowledgeSource, baseMetadata: Record<string, unknown>): Promise<Document[]> {\n    if (typeof source === 'string') {\n      return [{\n        id: generateId(),\n        content: source,\n        metadata: baseMetadata,\n      }];\n    }\n\n    if (Array.isArray(source)) {\n      if (source.length === 0) return [];\n      \n      if (typeof source[0] === 'string') {\n        return (source as string[]).map(text => ({\n          id: generateId(),\n          content: text,\n          metadata: baseMetadata,\n        }));\n      }\n\n      return (source as { text: string; metadata?: Record<string, unknown> }[]).map(item => ({\n        id: generateId(),\n        content: item.text,\n        metadata: { ...baseMetadata, ...item.metadata },\n      }));\n    }\n\n    if ('path' in source) {\n      const fs = await import('fs/promises');\n      const path = await import('path');\n      const stat = await fs.stat(source.path);\n      \n      if (stat.isFile()) {\n        const content = await fs.readFile(source.path, 'utf-8');\n        return [{\n          id: generateId(),\n          content,\n          metadata: { ...baseMetadata, sourcePath: source.path },\n        }];\n      }\n      \n      if (stat.isDirectory()) {\n        const files = await fs.readdir(source.path);\n        const documents: Document[] = [];\n        \n        for (const file of files) {\n          const filePath = path.join(source.path, file);\n          const fileStat = await fs.stat(filePath);\n          \n          if (fileStat.isFile() && this.isTextFile(file)) {\n            const content = await fs.readFile(filePath, 'utf-8');\n            documents.push({\n              id: generateId(),\n              content,\n              metadata: { ...baseMetadata, sourcePath: filePath, fileName: file },\n            });\n          }\n        }\n        \n        return documents;\n      }\n    }\n\n    if ('url' in source) {\n      const parsedUrl = new URL(source.url);\n      if (!['http:', 'https:'].includes(parsedUrl.protocol)) {\n        throw new Error(`Unsupported URL protocol: ${parsedUrl.protocol}. Only http and https are allowed.`);\n      }\n\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), 30_000);\n\n      try {\n        const response = await fetch(source.url, { signal: controller.signal });\n\n        if (!response.ok) {\n          throw new Error(`Failed to fetch URL: ${response.status} ${response.statusText}`);\n        }\n\n        const contentLength = response.headers.get('content-length');\n        if (contentLength && parseInt(contentLength) > 50_000_000) {\n          throw new Error('URL content exceeds 50MB limit');\n        }\n\n        const content = await response.text();\n        return [{\n          id: generateId(),\n          content,\n          metadata: { ...baseMetadata, sourceUrl: source.url },\n        }];\n      } catch (error) {\n        if ((error as Error).name === 'AbortError') {\n          throw new Error(`URL fetch timed out after 30s: ${source.url}`);\n        }\n        throw error;\n      } finally {\n        clearTimeout(timeout);\n      }\n    }\n\n    throw new Error('Invalid source format');\n  }\n\n  private isTextFile(filename: string): boolean {\n    const textExtensions = ['.txt', '.md', '.json', '.csv', '.html', '.xml', '.yaml', '.yml', '.js', '.ts', '.py', '.java', '.c', '.cpp', '.h', '.css', '.scss', '.sql'];\n    return textExtensions.some(ext => filename.toLowerCase().endsWith(ext));\n  }\n}\n"]}

package/dist/chunk-4SX4Q35P.js

@@ -0,0 +1,106 @@
+// src/memory/memory.ts
+var Memory = class {
+  messages = [];
+  config;
+  summaryBuffer = "";
+  constructor(config = {}) {
+    this.config = {
+      maxMessages: config.maxMessages ?? 50,
+      maxTokensEstimate: config.maxTokensEstimate ?? 4e3,
+      strategy: config.strategy ?? "sliding_window",
+      summaryThreshold: config.summaryThreshold ?? 10
+    };
+  }
+  addMessage(message) {
+    this.messages.push({
+      ...message,
+      timestamp: message.timestamp ?? Date.now()
+    });
+    this.trim();
+  }
+  getHistory() {
+    return [...this.messages];
+  }
+  getFormattedHistory() {
+    return this.messages.map((m) => `${m.role}: ${m.content}`).join("\n");
+  }
+  getLastMessages(count) {
+    return this.messages.slice(-count);
+  }
+  clear() {
+    this.messages = [];
+  }
+  getMessageCount() {
+    return this.messages.length;
+  }
+  trim() {
+    switch (this.config.strategy) {
+      case "sliding_window":
+        this.trimSlidingWindow();
+        break;
+      case "buffer":
+        this.trimBuffer();
+        break;
+      case "summary":
+        this.trimSummary();
+        break;
+    }
+  }
+  trimSlidingWindow() {
+    const max = this.config.maxMessages ?? 50;
+    if (this.messages.length > max) {
+      const systemMessages = this.messages.filter((m) => m.role === "system");
+      const nonSystemMessages = this.messages.filter((m) => m.role !== "system");
+      const trimmed = nonSystemMessages.slice(-(max - systemMessages.length));
+      this.messages = [...systemMessages, ...trimmed];
+    }
+  }
+  trimBuffer() {
+    const maxTokens = this.config.maxTokensEstimate ?? 4e3;
+    let estimatedTokens = 0;
+    const kept = [];
+    for (let i = this.messages.length - 1; i >= 0; i--) {
+      const msgTokens = Math.ceil(this.messages[i].content.length / 4);
+      if (estimatedTokens + msgTokens > maxTokens && kept.length > 0) {
+        break;
+      }
+      estimatedTokens += msgTokens;
+      kept.unshift(this.messages[i]);
+    }
+    this.messages = kept;
+  }
+  trimSummary() {
+    const max = this.config.maxMessages ?? 50;
+    const threshold = this.config.summaryThreshold ?? 10;
+    if (this.messages.length <= max) return;
+    const overflow = this.messages.length - max + threshold;
+    const toSummarize = this.messages.filter((m) => m.role !== "system").slice(0, overflow);
+    if (toSummarize.length === 0) return;
+    const summaryLines = toSummarize.map((m) => {
+      const prefix = m.role === "user" ? "User" : "Assistant";
+      const truncated = m.content.length > 200 ? m.content.slice(0, 200) + "..." : m.content;
+      return `- ${prefix}: ${truncated}`;
+    });
+    const newSummary = this.summaryBuffer ? `${this.summaryBuffer}
+${summaryLines.join("\n")}` : summaryLines.join("\n");
+    const maxSummaryLength = 2e3;
+    this.summaryBuffer = newSummary.length > maxSummaryLength ? newSummary.slice(-maxSummaryLength) : newSummary;
+    const existingSystem = this.messages.filter((m) => m.role === "system" && !m.metadata?.isSummary);
+    const remaining = this.messages.filter((m) => m.role !== "system").slice(overflow);
+    const summaryMessage = {
+      role: "system",
+      content: `[Summary of previous conversation]
+${this.summaryBuffer}`,
+      timestamp: Date.now(),
+      metadata: { isSummary: true }
+    };
+    this.messages = [...existingSystem, summaryMessage, ...remaining];
+  }
+  getSummary() {
+    return this.summaryBuffer;
+  }
+};
+
+export { Memory };
+//# sourceMappingURL=chunk-4SX4Q35P.js.map
+//# sourceMappingURL=chunk-4SX4Q35P.js.map

package/dist/chunk-4SX4Q35P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/memory/memory.ts"],"names":[],"mappings":"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","file":"chunk-4SX4Q35P.js","sourcesContent":["export interface Message {\n  role: 'user' | 'assistant' | 'system';\n  content: string;\n  timestamp?: number;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface MemoryConfig {\n  maxMessages?: number;\n  maxTokensEstimate?: number;\n  strategy?: 'sliding_window' | 'summary' | 'buffer';\n  summaryThreshold?: number;\n}\n\nexport class Memory {\n  private messages: Message[] = [];\n  private config: MemoryConfig;\n  private summaryBuffer: string = '';\n\n  constructor(config: MemoryConfig = {}) {\n    this.config = {\n      maxMessages: config.maxMessages ?? 50,\n      maxTokensEstimate: config.maxTokensEstimate ?? 4000,\n      strategy: config.strategy ?? 'sliding_window',\n      summaryThreshold: config.summaryThreshold ?? 10,\n    };\n  }\n\n  addMessage(message: Message): void {\n    this.messages.push({\n      ...message,\n      timestamp: message.timestamp ?? Date.now(),\n    });\n    this.trim();\n  }\n\n  getHistory(): Message[] {\n    return [...this.messages];\n  }\n\n  getFormattedHistory(): string {\n    return this.messages\n      .map(m => `${m.role}: ${m.content}`)\n      .join('\\n');\n  }\n\n  getLastMessages(count: number): Message[] {\n    return this.messages.slice(-count);\n  }\n\n  clear(): void {\n    this.messages = [];\n  }\n\n  getMessageCount(): number {\n    return this.messages.length;\n  }\n\n  private trim(): void {\n    switch (this.config.strategy) {\n      case 'sliding_window':\n        this.trimSlidingWindow();\n        break;\n      case 'buffer':\n        this.trimBuffer();\n        break;\n      case 'summary':\n        this.trimSummary();\n        break;\n    }\n  }\n\n  private trimSlidingWindow(): void {\n    const max = this.config.maxMessages ?? 50;\n    if (this.messages.length > max) {\n      const systemMessages = this.messages.filter(m => m.role === 'system');\n      const nonSystemMessages = this.messages.filter(m => m.role !== 'system');\n      \n      const trimmed = nonSystemMessages.slice(-(max - systemMessages.length));\n      this.messages = [...systemMessages, ...trimmed];\n    }\n  }\n\n  private trimBuffer(): void {\n    const maxTokens = this.config.maxTokensEstimate ?? 4000;\n    let estimatedTokens = 0;\n    const kept: Message[] = [];\n\n    for (let i = this.messages.length - 1; i >= 0; i--) {\n      const msgTokens = Math.ceil(this.messages[i].content.length / 4);\n      if (estimatedTokens + msgTokens > maxTokens && kept.length > 0) {\n        break;\n      }\n      estimatedTokens += msgTokens;\n      kept.unshift(this.messages[i]);\n    }\n\n    this.messages = kept;\n  }\n\n  private trimSummary(): void {\n    const max = this.config.maxMessages ?? 50;\n    const threshold = this.config.summaryThreshold ?? 10;\n\n    if (this.messages.length <= max) return;\n\n    const overflow = this.messages.length - max + threshold;\n    const toSummarize = this.messages\n      .filter(m => m.role !== 'system')\n      .slice(0, overflow);\n\n    if (toSummarize.length === 0) return;\n\n    const summaryLines = toSummarize.map(m => {\n      const prefix = m.role === 'user' ? 'User' : 'Assistant';\n      const truncated = m.content.length > 200 ? m.content.slice(0, 200) + '...' : m.content;\n      return `- ${prefix}: ${truncated}`;\n    });\n\n    const newSummary = this.summaryBuffer\n      ? `${this.summaryBuffer}\\n${summaryLines.join('\\n')}`\n      : summaryLines.join('\\n');\n\n    const maxSummaryLength = 2000;\n    this.summaryBuffer = newSummary.length > maxSummaryLength\n      ? newSummary.slice(-maxSummaryLength)\n      : newSummary;\n\n    const existingSystem = this.messages.filter(m => m.role === 'system' && !m.metadata?.isSummary);\n    const remaining = this.messages\n      .filter(m => m.role !== 'system')\n      .slice(overflow);\n\n    const summaryMessage: Message = {\n      role: 'system',\n      content: `[Summary of previous conversation]\\n${this.summaryBuffer}`,\n      timestamp: Date.now(),\n      metadata: { isSummary: true },\n    };\n\n    this.messages = [...existingSystem, summaryMessage, ...remaining];\n  }\n\n  getSummary(): string {\n    return this.summaryBuffer;\n  }\n}\n"]}

package/dist/chunk-4VMVFWFG.js

@@ -0,0 +1,158 @@
+import { BaseAgent } from './chunk-QQAP3IF5.js';
+
+// src/agent/structured-chat-agent.ts
+var StructuredChatAgent = class extends BaseAgent {
+  outputSchema;
+  constructor(config, llm, memory) {
+    super(config, llm, memory, "structured-chat");
+    this.outputSchema = config.outputSchema;
+  }
+  async run(input) {
+    const startTime = Date.now();
+    const steps = [];
+    const memoryContext = this.getMemoryContext();
+    this.emit({ type: "step:start", agentType: this.agentType, input });
+    for (let step = 0; step < this.maxSteps; step++) {
+      const stepStart = Date.now();
+      const prompt = this.buildPrompt(input, steps, memoryContext);
+      const result = await this.llm.generate(prompt, {
+        temperature: this.temperature,
+        maxTokens: 2048,
+        systemPrompt: this.buildSystemPrompt()
+      });
+      const parsed = this.parseStructuredResponse(result.content);
+      if (parsed.type === "final") {
+        const finalAnswer = parsed.content;
+        this.saveToMemory(input, finalAnswer);
+        this.emit({ type: "complete", agentType: this.agentType, output: finalAnswer });
+        const agentResult = this.buildResult(input, finalAnswer, steps, startTime, { stepsUsed: steps.length });
+        agentResult.totalTokens += result.usage.totalTokens;
+        return agentResult;
+      }
+      const observation = await this.executeTool(parsed.action, parsed.actionInput);
+      steps.push({
+        thought: parsed.thought,
+        action: parsed.action,
+        actionInput: parsed.actionInput,
+        observation,
+        latencyMs: Date.now() - stepStart,
+        usage: {
+          promptTokens: result.usage.promptTokens,
+          completionTokens: result.usage.completionTokens,
+          totalTokens: result.usage.totalTokens
+        }
+      });
+      this.emit({ type: "step:end", agentType: this.agentType, step, output: observation });
+    }
+    const fallback = steps.length > 0 ? `Reached max steps. Last observation: ${steps[steps.length - 1].observation}` : "Unable to process request.";
+    this.saveToMemory(input, fallback);
+    return this.buildResult(input, fallback, steps, startTime, { maxStepsReached: true });
+  }
+  buildSystemPrompt() {
+    const toolSchemas = [...this.tools.values()].map((t) => {
+      const schema = {
+        name: t.name,
+        description: t.description
+      };
+      if (t.parameters && t.parameters.length > 0) {
+        schema.parameters = {
+          type: "object",
+          properties: Object.fromEntries(
+            t.parameters.map((p) => [p.name, { type: p.type, description: p.description }])
+          ),
+          required: t.parameters.filter((p) => p.required).map((p) => p.name)
+        };
+      }
+      return schema;
+    });
+    const outputSchemaStr = this.outputSchema ? `
+Your final answer MUST conform to this JSON schema:
+${JSON.stringify(this.outputSchema, null, 2)}
+` : "";
+    const rules = this.getRulesString();
+    return `You are a structured chat agent. Your goal: ${this.goal}
+
+You have access to the following tools (as JSON schemas):
+\`\`\`json
+${JSON.stringify(toolSchemas, null, 2)}
+\`\`\`
+
+${rules ? `Rules:
+${rules}
+` : ""}${outputSchemaStr}
+Respond with a JSON blob in one of two formats:
+
+To use a tool:
+\`\`\`json
+{
+  "thought": "your reasoning",
+  "action": "tool_name",
+  "action_input": { "param": "value" }
+}
+\`\`\`
+
+To give your final answer:
+\`\`\`json
+{
+  "thought": "your final reasoning",
+  "action": "final_answer",
+  "action_input": "your comprehensive answer"
+}
+\`\`\`
+
+ALWAYS respond with a JSON blob. Never respond with plain text.
+
+${this.systemPrompt ?? ""}`;
+  }
+  buildPrompt(input, steps, memoryContext) {
+    let prompt = `${memoryContext}
+Human: ${input}
+`;
+    for (const step of steps) {
+      prompt += `
+Assistant action: ${step.action}(${JSON.stringify(step.actionInput)})
+`;
+      prompt += `Observation: ${step.observation}
+`;
+    }
+    if (steps.length > 0) {
+      prompt += "\nContinue with the next action or provide your final answer:\n";
+    }
+    return prompt;
+  }
+  parseStructuredResponse(content) {
+    const jsonBlockMatch = content.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+    const jsonStr = jsonBlockMatch ? jsonBlockMatch[1].trim() : content.trim();
+    try {
+      const jsonMatch = jsonStr.match(/\{[\s\S]*\}/);
+      if (jsonMatch) {
+        const parsed = JSON.parse(jsonMatch[0]);
+        const thought = parsed.thought ?? "";
+        const action = parsed.action ?? "final_answer";
+        const actionInput = typeof parsed.action_input === "string" ? { answer: parsed.action_input } : parsed.action_input ?? {};
+        if (action === "final_answer") {
+          return {
+            type: "final",
+            thought,
+            action,
+            actionInput,
+            content: actionInput.answer ?? thought
+          };
+        }
+        return { type: "action", thought, action, actionInput, content: "" };
+      }
+    } catch {
+    }
+    return {
+      type: "final",
+      thought: content,
+      action: "final_answer",
+      actionInput: { answer: content },
+      content
+    };
+  }
+};
+
+export { StructuredChatAgent };
+//# sourceMappingURL=chunk-4VMVFWFG.js.map
+//# sourceMappingURL=chunk-4VMVFWFG.js.map

package/dist/chunk-4VMVFWFG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/structured-chat-agent.ts"],"names":[],"mappings":"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","file":"chunk-4VMVFWFG.js","sourcesContent":["import type { LLMAdapter } from '../types/index.js';\nimport type { Memory } from '../memory/memory.js';\nimport type {\n  StructuredChatAgentConfig,\n  AgentResult,\n  AgentStepResult,\n} from './types.js';\nimport { BaseAgent } from './base-agent.js';\n\nexport class StructuredChatAgent extends BaseAgent {\n  private outputSchema?: Record<string, unknown>;\n\n  constructor(config: StructuredChatAgentConfig, llm: LLMAdapter, memory?: Memory) {\n    super(config, llm, memory, 'structured-chat');\n    this.outputSchema = config.outputSchema;\n  }\n\n  async run(input: string): Promise<AgentResult> {\n    const startTime = Date.now();\n    const steps: AgentStepResult[] = [];\n    const memoryContext = this.getMemoryContext();\n\n    this.emit({ type: 'step:start', agentType: this.agentType, input });\n\n    for (let step = 0; step < this.maxSteps; step++) {\n      const stepStart = Date.now();\n      const prompt = this.buildPrompt(input, steps, memoryContext);\n\n      const result = await this.llm.generate(prompt, {\n        temperature: this.temperature,\n        maxTokens: 2048,\n        systemPrompt: this.buildSystemPrompt(),\n      });\n\n      const parsed = this.parseStructuredResponse(result.content);\n\n      if (parsed.type === 'final') {\n        const finalAnswer = parsed.content;\n        this.saveToMemory(input, finalAnswer);\n        this.emit({ type: 'complete', agentType: this.agentType, output: finalAnswer });\n\n        const agentResult = this.buildResult(input, finalAnswer, steps, startTime, { stepsUsed: steps.length });\n        agentResult.totalTokens += result.usage.totalTokens;\n        return agentResult;\n      }\n\n      const observation = await this.executeTool(parsed.action, parsed.actionInput);\n\n      steps.push({\n        thought: parsed.thought,\n        action: parsed.action,\n        actionInput: parsed.actionInput,\n        observation,\n        latencyMs: Date.now() - stepStart,\n        usage: {\n          promptTokens: result.usage.promptTokens,\n          completionTokens: result.usage.completionTokens,\n          totalTokens: result.usage.totalTokens,\n        },\n      });\n\n      this.emit({ type: 'step:end', agentType: this.agentType, step, output: observation });\n    }\n\n    const fallback = steps.length > 0\n      ? `Reached max steps. Last observation: ${steps[steps.length - 1].observation}`\n      : 'Unable to process request.';\n\n    this.saveToMemory(input, fallback);\n    return this.buildResult(input, fallback, steps, startTime, { maxStepsReached: true });\n  }\n\n  private buildSystemPrompt(): string {\n    const toolSchemas = [...this.tools.values()].map(t => {\n      const schema: Record<string, unknown> = {\n        name: t.name,\n        description: t.description,\n      };\n      if (t.parameters && t.parameters.length > 0) {\n        schema.parameters = {\n          type: 'object',\n          properties: Object.fromEntries(\n            t.parameters.map(p => [p.name, { type: p.type, description: p.description }])\n          ),\n          required: t.parameters.filter(p => p.required).map(p => p.name),\n        };\n      }\n      return schema;\n    });\n\n    const outputSchemaStr = this.outputSchema\n      ? `\\nYour final answer MUST conform to this JSON schema:\\n${JSON.stringify(this.outputSchema, null, 2)}\\n`\n      : '';\n\n    const rules = this.getRulesString();\n\n    return `You are a structured chat agent. Your goal: ${this.goal}\n\nYou have access to the following tools (as JSON schemas):\n\\`\\`\\`json\n${JSON.stringify(toolSchemas, null, 2)}\n\\`\\`\\`\n\n${rules ? `Rules:\\n${rules}\\n` : ''}${outputSchemaStr}\nRespond with a JSON blob in one of two formats:\n\nTo use a tool:\n\\`\\`\\`json\n{\n  \"thought\": \"your reasoning\",\n  \"action\": \"tool_name\",\n  \"action_input\": { \"param\": \"value\" }\n}\n\\`\\`\\`\n\nTo give your final answer:\n\\`\\`\\`json\n{\n  \"thought\": \"your final reasoning\",\n  \"action\": \"final_answer\",\n  \"action_input\": \"your comprehensive answer\"\n}\n\\`\\`\\`\n\nALWAYS respond with a JSON blob. Never respond with plain text.\n\n${this.systemPrompt ?? ''}`;\n  }\n\n  private buildPrompt(input: string, steps: AgentStepResult[], memoryContext: string): string {\n    let prompt = `${memoryContext}\\nHuman: ${input}\\n`;\n\n    for (const step of steps) {\n      prompt += `\\nAssistant action: ${step.action}(${JSON.stringify(step.actionInput)})\\n`;\n      prompt += `Observation: ${step.observation}\\n`;\n    }\n\n    if (steps.length > 0) {\n      prompt += '\\nContinue with the next action or provide your final answer:\\n';\n    }\n\n    return prompt;\n  }\n\n  private parseStructuredResponse(content: string): { type: 'action' | 'final'; thought: string; action: string; actionInput: Record<string, unknown>; content: string } {\n    // Try to extract JSON from code blocks\n    const jsonBlockMatch = content.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```/);\n    const jsonStr = jsonBlockMatch ? jsonBlockMatch[1].trim() : content.trim();\n\n    try {\n      const jsonMatch = jsonStr.match(/\\{[\\s\\S]*\\}/);\n      if (jsonMatch) {\n        const parsed = JSON.parse(jsonMatch[0]);\n        const thought = parsed.thought ?? '';\n        const action = parsed.action ?? 'final_answer';\n        const actionInput = typeof parsed.action_input === 'string'\n          ? { answer: parsed.action_input }\n          : (parsed.action_input ?? {});\n\n        if (action === 'final_answer') {\n          return {\n            type: 'final',\n            thought,\n            action,\n            actionInput,\n            content: actionInput.answer ?? thought,\n          };\n        }\n\n        return { type: 'action', thought, action, actionInput, content: '' };\n      }\n    } catch {\n      // Fall through to plain text\n    }\n\n    return {\n      type: 'final',\n      thought: content,\n      action: 'final_answer',\n      actionInput: { answer: content },\n      content,\n    };\n  }\n}\n"]}