@infinityi/engine-lib 1.0.0 → 1.4.0

package/dist/{index-jp2b31xs.js → index-vwcyawfk.js}

@@ -1,17 +1,17 @@
 import {
   createToolRegistry,
   runAgent
-} from "./index-pwr8179t.js";
+} from "./index-7nb9qwa1.js";
 import {
   s
-} from "./index-02s1fjxr.js";
+} from "./index-mnx5mqbs.js";
 import {
   AgentError,
   ExecutionError
-} from "./index-7690reng.js";
+} from "./index-ajr3nk10.js";
 import {
   defineTool
-} from "./index-w34cbktd.js";
+} from "./index-a67ej96j.js";
 
 // src/agent/define.ts
 function defineAgent(def) {

package/dist/index-ycjsqfpq.js

@@ -0,0 +1,39 @@
+import {
+  system
+} from "./index-1p6mb2vz.js";
+
+// src/context/providers.ts
+function renderItem(item) {
+  const body = typeof item.content === "string" ? item.content : JSON.stringify(item.content, null, 2) ?? "";
+  return item.title !== undefined && item.title !== "" ? `## ${item.title}
+${body}` : body;
+}
+function staticContext(content, title) {
+  const item = { content, ...title !== undefined ? { title } : {} };
+  return {
+    name: "static",
+    resolve: () => [item]
+  };
+}
+function dynamicContext(name, fn, title) {
+  return {
+    name,
+    resolve: async (ctx, run) => {
+      const content = await fn(ctx, run);
+      return [{ content, ...title !== undefined ? { title } : {} }];
+    }
+  };
+}
+async function resolveContext(providers, ctx, run) {
+  if (providers === undefined || providers.length === 0)
+    return [];
+  const resolved = await Promise.all(providers.map((p) => p.resolve(ctx, run)));
+  const blocks = resolved.flat().map(renderItem).filter((s) => s !== "");
+  if (blocks.length === 0)
+    return [];
+  return [system(blocks.join(`
+
+`))];
+}
+
+export { staticContext, dynamicContext, resolveContext };

package/dist/{index-bqg01r42.js → index-zdggff0y.js}

@@ -1,101 +1,3 @@
-// node_modules/@infinityi/forge/dist/index-ft2g12w9.js
-var realClock = {
-  now() {
-    return Date.now();
-  },
-  sleep(ms, signal) {
-    if (signal?.aborted) {
-      return Promise.reject(signal.reason);
-    }
-    if (ms <= 0) {
-      return Promise.resolve();
-    }
-    return new Promise((resolve, reject) => {
-      const timer = setTimeout(() => {
-        signal?.removeEventListener("abort", onAbort);
-        resolve();
-      }, ms);
-      const onAbort = () => {
-        clearTimeout(timer);
-        reject(signal.reason);
-      };
-      signal?.addEventListener("abort", onAbort, { once: true });
-    });
-  }
-};
-
-// node_modules/@infinityi/forge/dist/index-sw7jeh00.js
-class ResilienceError extends Error {
-  constructor(message, options) {
-    super(message, options);
-    this.name = "ResilienceError";
-  }
-}
-
-// node_modules/@infinityi/forge/dist/index-f41wfqnm.js
-function buildInstruments(telemetry) {
-  const meter = telemetry?.meter;
-  const tracer = telemetry?.tracer;
-  let attempts;
-  let retries;
-  let timeouts;
-  let circuitState;
-  let bulkheadQueueSize;
-  return {
-    attempts() {
-      if (!meter)
-        return;
-      attempts ??= meter.createCounter("forge_resilience_attempts_total", {
-        description: "Total execution attempts (including retries).",
-        unit: "1"
-      });
-      return attempts;
-    },
-    retries() {
-      if (!meter)
-        return;
-      retries ??= meter.createCounter("forge_resilience_retries_total", {
-        description: "Total retry attempts triggered.",
-        unit: "1"
-      });
-      return retries;
-    },
-    timeouts() {
-      if (!meter)
-        return;
-      timeouts ??= meter.createCounter("forge_resilience_timeout_total", {
-        description: "Total operations aborted due to timeout.",
-        unit: "1"
-      });
-      return timeouts;
-    },
-    circuitState() {
-      if (!meter)
-        return;
-      circuitState ??= meter.createGauge("forge_resilience_circuit_state", {
-        description: "Current circuit-breaker state (0=Closed, 1=HalfOpen, 2=Open).",
-        unit: "1"
-      });
-      return circuitState;
-    },
-    bulkheadQueueSize() {
-      if (!meter)
-        return;
-      bulkheadQueueSize ??= meter.createGauge("forge_resilience_bulkhead_queue_size", {
-        description: "Current number of tasks waiting in a bulkhead queue.",
-        unit: "1"
-      });
-      return bulkheadQueueSize;
-    },
-    addEvent(name, attributes) {
-      if (!tracer)
-        return;
-      const span = tracer.startSpan(name, attributes ? { attributes } : undefined);
-      span.end();
-    }
-  };
-}
-
 // node_modules/@infinityi/forge/dist/index-yh6c6ebj.js
 import { AsyncLocalStorage } from "node:async_hooks";
 var INVALID_TRACE_ID = "0".repeat(32);
@@ -105,7 +7,7 @@ function currentContext() {
   return contextStorage.getStore();
 }
 
-// node_modules/@infinityi/forge/dist/index-0jqvt0fs.js
+// node_modules/@infinityi/forge/dist/index-d0knb21f.js
 function buildRootContext() {
   const controller = new AbortController;
   const telemetry = currentContext();
@@ -124,7 +26,15 @@ function withExecutionContext(base, overrides) {
   return next;
 }
 
-// node_modules/@infinityi/forge/dist/index-br4e2rnq.js
+// node_modules/@infinityi/forge/dist/index-sw7jeh00.js
+class ResilienceError extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ResilienceError";
+  }
+}
+
+// node_modules/@infinityi/forge/dist/index-f31jaync.js
 function ok(value) {
   return {
     ok: true,
@@ -178,93 +88,97 @@ function createPipeline(policies) {
   }
   return { execute, executeResult };
 }
-function constantBackoff(delayMs) {
-  const ms = Math.max(0, delayMs);
-  return { delay: () => ms };
-}
-function exponentialBackoff(options) {
-  const initial = Math.max(0, options.initial);
-  const max = options.max !== undefined ? Math.max(initial, options.max) : Number.POSITIVE_INFINITY;
-  const factor = options.factor ?? 2;
-  const jitter = options.jitter ?? true;
+// node_modules/@infinityi/forge/dist/index-f41wfqnm.js
+function buildInstruments(telemetry) {
+  const meter = telemetry?.meter;
+  const tracer = telemetry?.tracer;
+  let attempts;
+  let retries;
+  let timeouts;
+  let circuitState;
+  let bulkheadQueueSize;
   return {
-    delay(attempt) {
-      const exponent = Math.max(0, attempt - 1);
-      const raw = Math.min(max, initial * Math.pow(factor, exponent));
-      return jitter ? applyFullJitter(raw) : raw;
+    attempts() {
+      if (!meter)
+        return;
+      attempts ??= meter.createCounter("forge_resilience_attempts_total", {
+        description: "Total execution attempts (including retries).",
+        unit: "1"
+      });
+      return attempts;
+    },
+    retries() {
+      if (!meter)
+        return;
+      retries ??= meter.createCounter("forge_resilience_retries_total", {
+        description: "Total retry attempts triggered.",
+        unit: "1"
+      });
+      return retries;
+    },
+    timeouts() {
+      if (!meter)
+        return;
+      timeouts ??= meter.createCounter("forge_resilience_timeout_total", {
+        description: "Total operations aborted due to timeout.",
+        unit: "1"
+      });
+      return timeouts;
+    },
+    circuitState() {
+      if (!meter)
+        return;
+      circuitState ??= meter.createGauge("forge_resilience_circuit_state", {
+        description: "Current circuit-breaker state (0=Closed, 1=HalfOpen, 2=Open).",
+        unit: "1"
+      });
+      return circuitState;
+    },
+    bulkheadQueueSize() {
+      if (!meter)
+        return;
+      bulkheadQueueSize ??= meter.createGauge("forge_resilience_bulkhead_queue_size", {
+        description: "Current number of tasks waiting in a bulkhead queue.",
+        unit: "1"
+      });
+      return bulkheadQueueSize;
+    },
+    addEvent(name, attributes) {
+      if (!tracer)
+        return;
+      const span = tracer.startSpan(name, attributes ? { attributes } : undefined);
+      span.end();
     }
   };
 }
-function applyFullJitter(base) {
-  if (base <= 0)
-    return 0;
-  return Math.random() * base;
-}
 
-class RetryExhaustedError extends ResilienceError {
-  attempts;
-  constructor(message, options) {
-    super(message, options);
-    this.name = "RetryExhaustedError";
-    this.attempts = options.attempts;
-  }
-}
-function retry(options) {
-  if (!Number.isInteger(options.maxAttempts) || options.maxAttempts < 1) {
-    throw new RangeError(`retry: maxAttempts must be an integer >= 1, got ${options.maxAttempts}`);
-  }
-  const maxAttempts = options.maxAttempts;
-  const backoff = options.backoff ?? constantBackoff(0);
-  const shouldRetry = options.shouldRetry ?? (() => true);
-  const retryOn = options.retryOn;
-  const clock = options.clock ?? realClock;
-  const instruments = buildInstruments(options.telemetry);
-  async function execute(next, ctx) {
-    let lastError;
-    for (let attempt = 1;attempt <= maxAttempts; attempt++) {
-      if (ctx.signal.aborted) {
-        throw ctx.signal.reason;
-      }
-      const attemptCtx = attempt === ctx.attempt ? ctx : withExecutionContext(ctx, { attempt });
-      instruments.attempts()?.add(1, { policy: "retry" });
-      try {
-        const value = await next(attemptCtx);
-        if (retryOn && retryOn(value, attempt)) {
-          const synthetic = new Error("operation returned a retryable value");
-          synthetic.cause = value;
-          lastError = synthetic;
-        } else {
-          return value;
-        }
-      } catch (error) {
-        lastError = error;
-        if (!shouldRetry(error, attempt))
-          throw error;
-      }
-      if (attempt >= maxAttempts)
-        break;
-      const delayMs = Math.max(0, backoff.delay(attempt));
-      instruments.retries()?.add(1, { policy: "retry" });
-      instruments.addEvent("resilience.retry.attempt", {
-        attempt_number: attempt,
-        delay_ms: delayMs,
-        error_message: lastError instanceof Error ? lastError.message : String(lastError)
-      });
-      if (delayMs > 0) {
-        await clock.sleep(delayMs, ctx.signal);
-      } else if (ctx.signal.aborted) {
-        throw ctx.signal.reason;
-      }
+// node_modules/@infinityi/forge/dist/index-ft2g12w9.js
+var realClock = {
+  now() {
+    return Date.now();
+  },
+  sleep(ms, signal) {
+    if (signal?.aborted) {
+      return Promise.reject(signal.reason);
     }
-    throw new RetryExhaustedError(`retry: exhausted ${maxAttempts} attempt(s)`, { attempts: maxAttempts, cause: lastError });
+    if (ms <= 0) {
+      return Promise.resolve();
+    }
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        signal?.removeEventListener("abort", onAbort);
+        resolve();
+      }, ms);
+      const onAbort = () => {
+        clearTimeout(timer);
+        reject(signal.reason);
+      };
+      signal?.addEventListener("abort", onAbort, { once: true });
+    });
   }
-  return {
-    name: "retry",
-    maxAttempts,
-    execute
-  };
-}
+};
 
+// node_modules/@infinityi/forge/dist/index-cfscg5g3.js
 class TimeoutError extends ResilienceError {
   timeoutMs;
   strategy;
@@ -351,4 +265,93 @@ function timeout(options) {
     execute
   };
 }
-export { currentContext, combine, exponentialBackoff, retry, timeout };
+
+// node_modules/@infinityi/forge/dist/index-1b1bteg1.js
+function constantBackoff(delayMs) {
+  const ms = Math.max(0, delayMs);
+  return { delay: () => ms };
+}
+function exponentialBackoff(options) {
+  const initial = Math.max(0, options.initial);
+  const max = options.max !== undefined ? Math.max(initial, options.max) : Number.POSITIVE_INFINITY;
+  const factor = options.factor ?? 2;
+  const jitter = options.jitter ?? true;
+  return {
+    delay(attempt) {
+      const exponent = Math.max(0, attempt - 1);
+      const raw = Math.min(max, initial * Math.pow(factor, exponent));
+      return jitter ? applyFullJitter(raw) : raw;
+    }
+  };
+}
+function applyFullJitter(base) {
+  if (base <= 0)
+    return 0;
+  return Math.random() * base;
+}
+
+class RetryExhaustedError extends ResilienceError {
+  attempts;
+  constructor(message, options) {
+    super(message, options);
+    this.name = "RetryExhaustedError";
+    this.attempts = options.attempts;
+  }
+}
+function retry(options) {
+  if (!Number.isInteger(options.maxAttempts) || options.maxAttempts < 1) {
+    throw new RangeError(`retry: maxAttempts must be an integer >= 1, got ${options.maxAttempts}`);
+  }
+  const maxAttempts = options.maxAttempts;
+  const backoff = options.backoff ?? constantBackoff(0);
+  const shouldRetry = options.shouldRetry ?? (() => true);
+  const retryOn = options.retryOn;
+  const clock = options.clock ?? realClock;
+  const instruments = buildInstruments(options.telemetry);
+  async function execute(next, ctx) {
+    let lastError;
+    for (let attempt = 1;attempt <= maxAttempts; attempt++) {
+      if (ctx.signal.aborted) {
+        throw ctx.signal.reason;
+      }
+      const attemptCtx = attempt === ctx.attempt ? ctx : withExecutionContext(ctx, { attempt });
+      instruments.attempts()?.add(1, { policy: "retry" });
+      try {
+        const value = await next(attemptCtx);
+        if (retryOn && retryOn(value, attempt)) {
+          const synthetic = new Error("operation returned a retryable value");
+          synthetic.cause = value;
+          lastError = synthetic;
+        } else {
+          return value;
+        }
+      } catch (error) {
+        lastError = error;
+        if (!shouldRetry(error, attempt))
+          throw error;
+      }
+      if (attempt >= maxAttempts)
+        break;
+      const delayMs = Math.max(0, backoff.delay(attempt));
+      instruments.retries()?.add(1, { policy: "retry" });
+      instruments.addEvent("resilience.retry.attempt", {
+        attempt_number: attempt,
+        delay_ms: delayMs,
+        error_message: lastError instanceof Error ? lastError.message : String(lastError)
+      });
+      if (delayMs > 0) {
+        await clock.sleep(delayMs, ctx.signal);
+      } else if (ctx.signal.aborted) {
+        throw ctx.signal.reason;
+      }
+    }
+    throw new RetryExhaustedError(`retry: exhausted ${maxAttempts} attempt(s)`, { attempts: maxAttempts, cause: lastError });
+  }
+  return {
+    name: "retry",
+    maxAttempts,
+    execute
+  };
+}
+
+export { currentContext, combine, timeout, exponentialBackoff, retry };

package/dist/index.d.ts

@@ -19,7 +19,7 @@
  *
  * @module
  */
-export { AgentError, CancelledError, ContextWindowError, ExecutionError, MaxHandoffsExceededError, MaxStepsExceededError, ProviderError, SchemaValidationError, ToolError, ToolValidationError, } from "./errors";
+export { AgentError, CancelledError, ContextWindowError, ExecutionError, FilesystemPolicyError, MaxHandoffsExceededError, MaxStepsExceededError, ProviderError, SchemaValidationError, ToolError, ToolValidationError, } from "./errors";
 export type { SchemaIssue } from "./errors";
 export { asSchema, fromJsonSchema, s, toJsonSchema, validateJsonSchema } from "./schema/index";
 export type { Infer, JsonSchema, SafeParseResult, Schema } from "./schema/index";
@@ -40,6 +40,6 @@ export type { AnyRunOptions, BufferedRunOptions, RunBridge, RunEvent, RunHandle,
 export { createSession, InMemorySessionStore } from "./session/index";
 export type { CreateSessionOptions, Session, SessionState, SessionStore, } from "./session/index";
 export { dynamicContext, staticContext, summarizeOldest, truncateOldest, } from "./context/index";
-export type { ContextItem, ContextProvider, ContextStrategy, ContextStrategyContext, ContextWindowOptions, TokenCounter, } from "./context/index";
+export type { ContextItem, ContextProvider, ContextResolveContext, ContextStrategy, ContextStrategyContext, ContextWindowOptions, TokenCounter, } from "./context/index";
 export { createEventHub, loggingSubscriber, messageBusSubscriber, } from "./events/index";
 export type { EventHub, EventHubOptions, LoggingSubscriberOptions, LogLevel, MessageBusSubscriberOptions, RunSubscriber, } from "./events/index";

package/dist/index.js

@@ -1,13 +1,38 @@
-import"./index-kte2h4k2.js";
-import"./index-d4xz3abn.js";
 import {
   loggingSubscriber,
   messageBusSubscriber
-} from "./index-jxgj4z08.js";
+} from "./index-9egrqxkf.js";
+import {
+  asTool,
+  createAgentRegistry,
+  defineAgent
+} from "./index-vwcyawfk.js";
+import"./index-kte2h4k2.js";
+import {
+  runAgent
+} from "./index-7nb9qwa1.js";
+import {
+  createEventHub
+} from "./index-fkr3rcq9.js";
 import {
   InMemorySessionStore,
   createSession
 } from "./index-vnby35rm.js";
+import"./index-d4xz3abn.js";
+import {
+  dynamicContext,
+  staticContext
+} from "./index-ycjsqfpq.js";
+import {
+  summarizeOldest,
+  truncateOldest
+} from "./index-nvdsr51v.js";
+import"./index-c6kgts41.js";
+import {
+  asSchema,
+  fromJsonSchema,
+  toJsonSchema
+} from "./index-k0q7x4mz.js";
 import"./index-19pwq79t.js";
 import"./index-jg19te9v.js";
 import {
@@ -15,62 +40,47 @@ import {
   createGoogle,
   createOpenAI,
   createOpenAICompatible
-} from "./index-64tt9696.js";
-import"./index-bqg01r42.js";
+} from "./index-aed6fe4z.js";
+import"./index-zdggff0y.js";
+import"./index-zfgr4xx3.js";
 import {
   Secret,
   isSecret,
   resolveSecret
-} from "./index-xsv43c5j.js";
-import {
-  asTool,
-  createAgentRegistry,
-  defineAgent
-} from "./index-jp2b31xs.js";
-import {
-  runAgent
-} from "./index-pwr8179t.js";
+} from "./index-e14g2e48.js";
+import"./index-9rr5dkzh.js";
+import"./index-rentvdpp.js";
 import {
-  dynamicContext,
-  staticContext,
-  summarizeOldest,
-  truncateOldest
-} from "./index-yrqrxwjt.js";
+  assistant,
+  normalizeContent,
+  system,
+  text,
+  toolResult,
+  user
+} from "./index-1p6mb2vz.js";
 import {
-  createEventHub
-} from "./index-fkr3rcq9.js";
+  s
+} from "./index-mnx5mqbs.js";
 import {
-  asSchema,
-  fromJsonSchema,
-  s,
-  toJsonSchema,
   validateJsonSchema
-} from "./index-02s1fjxr.js";
-import"./index-zfgr4xx3.js";
+} from "./index-4c15ysa8.js";
 import {
   AgentError,
   CancelledError,
   ContextWindowError,
   ExecutionError,
+  FilesystemPolicyError,
   MaxHandoffsExceededError,
   MaxStepsExceededError,
   ProviderError,
   SchemaValidationError,
   ToolError,
   ToolValidationError
-} from "./index-7690reng.js";
+} from "./index-ajr3nk10.js";
 import {
   defineTool
-} from "./index-w34cbktd.js";
-import"./index-rentvdpp.js";
-import {
-  assistant,
-  normalizeContent,
-  system,
-  text,
-  toolResult,
-  user
-} from "./index-1p6mb2vz.js";
+} from "./index-a67ej96j.js";
+import"./index-37x76zdn.js";
 export {
   validateJsonSchema,
   user,
@@ -110,6 +120,7 @@ export {
   MaxStepsExceededError,
   MaxHandoffsExceededError,
   InMemorySessionStore,
+  FilesystemPolicyError,
   ExecutionError,
   ContextWindowError,
   CancelledError,

package/dist/lifecycle/index.js

@@ -1,3 +1,5 @@
+import"../index-37x76zdn.js";
+
 // src/lifecycle/component.ts
 var DEFAULT_NAME = "agent-runtime";
 function validateProviders(providers) {

package/dist/messages/index.js

@@ -7,6 +7,7 @@ import {
   toolResult,
   user
 } from "../index-1p6mb2vz.js";
+import"../index-37x76zdn.js";
 export {
   user,
   toolResult,

package/dist/providers/index.js

@@ -10,14 +10,15 @@ import {
   openSseStream,
   parseSse,
   toProviderError
-} from "../index-64tt9696.js";
-import"../index-bqg01r42.js";
-import"../index-xsv43c5j.js";
+} from "../index-aed6fe4z.js";
+import"../index-zdggff0y.js";
 import {
   StreamAccumulator,
   collectStream
 } from "../index-zfgr4xx3.js";
-import"../index-7690reng.js";
+import"../index-e14g2e48.js";
+import"../index-ajr3nk10.js";
+import"../index-37x76zdn.js";
 export {
   toProviderError,
   parseSse,

package/dist/retrieval/chunking.d.ts

@@ -0,0 +1,8 @@
+import type { Chunker, TextChunkerOptions } from "./types";
+/**
+ * Create a deterministic plain-text chunker that splits by character budget,
+ * optional overlap, and separator preference while preserving source locations.
+ */
+export declare function createTextChunker(options: TextChunkerOptions): Chunker;
+/** Create a text chunker that recursively splits oversized spans by separator priority. */
+export declare function recursiveTextChunker(options: TextChunkerOptions): Chunker;

package/dist/retrieval/context.d.ts

@@ -0,0 +1,4 @@
+import type { ContextProvider } from "../context/types";
+import type { RetrieverContextOptions } from "./types";
+/** Convert any retriever into a run-time context provider with citations. */
+export declare function retrieverContext(options: RetrieverContextOptions): ContextProvider;

package/dist/retrieval/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@infinityi/engine-lib/retrieval` — opt-in RAG primitives for document
+ * loading, chunking, embeddings, vector stores, retrievers, and context
+ * provider integration.
+ *
+ * The core run loop remains retrieval-agnostic. This module provides contracts
+ * and helpers that hosts can wire into existing `ContextProvider`s.
+ *
+ * @module
+ */
+export { createTextChunker, recursiveTextChunker } from "./chunking";
+export { retrieverContext } from "./context";
+export { createDocumentLoader, loadDocuments, staticDocumentLoader } from "./loaders";
+export { InMemoryVectorStore } from "./memory";
+export type { InMemoryVectorStoreOptions } from "./memory";
+export { createVectorRetriever, indexDocuments, mergeHybridResults } from "./retriever";
+export { assertVector, cosineSimilarity, dotProduct, euclideanSimilarity, scoreVectors, } from "./vector-store";
+export type { VectorSimilarity } from "./vector-store";
+export type { Chunker, ChunkerContext, DocumentLoader, DocumentLoaderOutput, EmbeddingProvider, EmbeddingRequest, EmbeddingResult, EmbeddingUsage, EmbeddingVector, HybridRetrievalOptions, IndexDocumentsOptions, IndexDocumentsResult, KeywordRetrievalResult, KeywordRetriever, LoadDocumentsResult, LoadedDocument, RetrievalChunk, RetrievalQuery, RetrievalResult, RetrievalScores, Retriever, RetrieverContextBudgetOptions, RetrieverContextOptions, RetrieverContextProvider, SourceAttribution, SourceLocation, TextChunkerOptions, VectorQuery, VectorRecord, VectorRecordFilter, VectorRetrieverOptions, VectorSearchResult, VectorStore, VectorStoreStats, } from "./types";