elsium-ai 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -13,10 +13,10 @@ export { ElsiumError, ok, err, isOk, isErr, unwrap, unwrapOr, tryCatch, tryCatch
 export type { Role, ContentPart, TextContent, ImageContent, AudioContent, DocumentContent, Message, ToolCall, ToolResult, TokenUsage, CostBreakdown, StopReason, LLMResponse, StreamEvent, XRayData, StreamCheckpoint, ProviderConfig, CompletionRequest, ToolDefinition, TenantContext, Middleware, Result, Ok, Err, ElsiumStream, ResilientStreamOptions, LogLevel, Logger, ErrorCode, Registry, ContextStrategy, ContextManagerConfig, ContextManager, } from '@elsium-ai/core';
 export { gateway, registerProviderFactory, registerProvider, getProviderFactory, listProviders, registerProviderMetadata, getProviderMetadata, calculateCost, registerPricing, composeMiddleware, loggingMiddleware, costTrackingMiddleware, xrayMiddleware, createAnthropicProvider, createOpenAIProvider, createGoogleProvider, createProviderMesh, securityMiddleware, detectPromptInjection, detectJailbreak, redactSecrets, checkBlockedPatterns, cacheMiddleware, createInMemoryCache, outputGuardrailMiddleware, createBatch, } from '@elsium-ai/gateway';
 export type { LLMProvider, ProviderFactory, ProviderMetadata, ModelPricing, ModelTier, Gateway, GatewayConfig, XRayStore, ProviderMeshConfig, ProviderEntry, RoutingStrategy, ProviderMesh, SecurityMiddlewareConfig, SecurityViolation, SecurityResult, CacheAdapter, CacheStats, CacheMiddlewareConfig, OutputGuardrailConfig, OutputGuardrailRule, OutputViolation, BatchConfig, BatchResult, BatchResultItem, } from '@elsium-ai/gateway';
-export { defineAgent, runSequential, runParallel, runSupervisor, createMemory, createSemanticValidator, createAgentSecurity, createConfidenceScorer, executeStateMachine, createInMemoryMemoryStore, createSqliteMemoryStore, createAgentStream, createThread, loadThread, createInMemoryThreadStore, createAsyncAgent, } from '@elsium-ai/agents';
-export type { Agent, AgentDependencies, AgentConfig, AgentResult, AgentRunOptions, GuardrailConfig, AgentHooks, Memory, MemoryConfig, SemanticGuardrailConfig, SemanticCheck, SemanticCheckResult, SemanticValidationResult, SemanticValidator, AgentSecurityConfig, AgentSecurityResult, ConfidenceConfig, ConfidenceResult, StateDefinition, StateHistoryEntry, StateMachineResult, MemoryStore, SqliteMemoryStoreConfig, AgentStreamEvent, AgentStream, StreamingAgentDependencies, Thread, ThreadConfig, ThreadStore, ThreadSnapshot, ThreadSummary, AsyncAgent, AsyncAgentConfig, AsyncAgentRunOptions, AgentTask, TaskStatus, TaskProgressEvent, } from '@elsium-ai/agents';
-export { defineTool, createToolkit, httpFetchTool, calculatorTool, jsonParseTool, currentTimeTool, formatToolResult, formatToolResultAsText, } from '@elsium-ai/tools';
-export type { Tool, ToolConfig, ToolContext, ToolExecutionResult, Toolkit, } from '@elsium-ai/tools';
+export { defineAgent, runSequential, runParallel, runSupervisor, createMemory, createSummarizeFn, createSemanticValidator, createAgentSecurity, createConfidenceScorer, executeStateMachine, createInMemoryMemoryStore, createSqliteMemoryStore, createAgentStream, createThread, loadThread, createInMemoryThreadStore, createAsyncAgent, createChannelGateway, createWebhookChannel, createSessionRouter, createScheduler, parseCronExpression, cronMatchesDate, getNextCronDate, } from '@elsium-ai/agents';
+export type { Agent, AgentDependencies, AgentGenerateResult, AgentConfig, AgentResult, AgentRunOptions, GuardrailConfig, AgentHooks, Memory, MemoryConfig, SummarizeFn, SemanticGuardrailConfig, SemanticCheck, SemanticCheckResult, SemanticValidationResult, SemanticValidator, AgentSecurityConfig, AgentSecurityResult, ConfidenceConfig, ConfidenceResult, StateDefinition, StateHistoryEntry, StateMachineResult, MemoryStore, SqliteMemoryStoreConfig, AgentStreamEvent, AgentStream, StreamingAgentDependencies, Thread, ThreadConfig, ThreadStore, ThreadSnapshot, ThreadSummary, AsyncAgent, AsyncAgentConfig, AsyncAgentRunOptions, AgentTask, TaskStatus, TaskProgressEvent, ChannelAdapter, ChannelGateway, ChannelGatewayConfig, IncomingMessage, OutgoingMessage, ChannelAttachment, WebhookChannelConfig, SessionRouter, SessionRouterConfig, SessionInfo, SessionResolveOptions, Scheduler, SchedulerConfig, ScheduleOptions, ScheduledTask, CronFields, } from '@elsium-ai/agents';
+export { defineTool, createToolkit, httpFetchTool, calculatorTool, jsonParseTool, currentTimeTool, formatToolResult, formatToolResultAsText, createRetrievalTool, } from '@elsium-ai/tools';
+export type { Tool, ToolConfig, ToolContext, ToolExecutionResult, Toolkit, RetrievalToolConfig, RetrievalResult as ToolRetrievalResult, RetrieveFn, } from '@elsium-ai/tools';
 export { rag, createInMemoryStore, createOpenAIEmbeddings, createMockEmbeddings, vectorStoreRegistry, embeddingProviderRegistry, createPgVectorStore, } from '@elsium-ai/rag';
 export type { RAGPipeline, RAGPipelineConfig, IngestResult, Document, Chunk, EmbeddedChunk, RetrievalResult, QueryOptions, EmbeddingProvider, VectorStore, VectorStoreFactory, EmbeddingProviderFactory, PgVectorStoreConfig, } from '@elsium-ai/rag';
 export { defineWorkflow, defineParallelWorkflow, defineBranchWorkflow, step, } from '@elsium-ai/workflows';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -7858,6 +7858,35 @@ var currentTimeTool = defineTool({
     };
   }
 });
+// ../tools/src/retrieval.ts
+function defaultFormatResults(results) {
+  if (results.length === 0)
+    return "No relevant results found.";
+  return results.map((r, i) => {
+    const source = r.source ? ` (source: ${r.source})` : "";
+    return `[${i + 1}]${source} (score: ${r.score.toFixed(2)})
+${r.content}`;
+  }).join(`
+
+---
+
+`);
+}
+function createRetrievalTool(config) {
+  const topK = config.topK ?? 5;
+  const formatResult = config.formatResult ?? defaultFormatResults;
+  return defineTool({
+    name: config.name ?? "search_knowledge",
+    description: config.description ?? "Search the knowledge base for relevant information. Use this when you need to find facts, documentation, or context to answer questions.",
+    input: exports_external.object({
+      query: exports_external.string().describe("The search query to find relevant information")
+    }),
+    async handler(input) {
+      const results = await config.retrieve(input.query, { topK });
+      return formatResult(results);
+    }
+  });
+}
 // ../agents/src/approval.ts
 function createApprovalGate(config) {
   const timeoutMs = config.timeoutMs ?? 300000;
@@ -8036,6 +8065,35 @@ function createMemory(config) {
       messages.shift();
     }
   }
+  let summaryPending = false;
+  function needsSummarization() {
+    if (config.strategy !== "summary")
+      return false;
+    if (!config.summarize)
+      return false;
+    return messages.length > maxMessages;
+  }
+  async function runSummarization() {
+    if (summaryPending || !config.summarize)
+      return;
+    if (messages.length <= maxMessages)
+      return;
+    summaryPending = true;
+    try {
+      const keepCount = Math.floor(maxMessages / 2);
+      const toSummarize = messages.splice(0, messages.length - keepCount);
+      const summaryText = await config.summarize(toSummarize);
+      messages.unshift({
+        role: "system",
+        content: `[Conversation summary]: ${summaryText}`
+      });
+    } finally {
+      summaryPending = false;
+    }
+    if (config.store && config.agentId) {
+      config.store.save(config.agentId, [...messages]).catch(() => {});
+    }
+  }
   return {
     strategy: config.strategy,
     add(message) {
@@ -8047,6 +8105,8 @@ function createMemory(config) {
         case "token-limited":
           trimToTokenLimit();
           break;
+        case "summary":
+          break;
         case "unlimited":
           break;
       }
@@ -8077,9 +8137,28 @@ function createMemory(config) {
       if (!config.store || !config.agentId)
         return;
       await config.store.save(config.agentId, [...messages]);
+    },
+    async summarizeIfNeeded() {
+      if (needsSummarization()) {
+        await runSummarization();
+      }
     }
   };
 }
+var SUMMARIZE_SYSTEM = "You are a conversation summarizer. Given a conversation, produce a concise summary that preserves all key facts, decisions, user preferences, and context needed to continue the conversation. Be factual and complete. Do not add commentary.";
+function createSummarizeFn(complete) {
+  return async (messages) => {
+    const text = messages.map((m) => `${m.role}: ${extractText(m.content)}`).join(`
+`);
+    const response = await complete({
+      messages: [{ role: "user", content: `Summarize this conversation:
+
+${text}` }],
+      system: SUMMARIZE_SYSTEM
+    });
+    return extractText(response.message.content);
+  };
+}
 
 // ../agents/src/security.ts
 var INJECTION_PATTERNS2 = [
@@ -9153,6 +9232,34 @@ function defineAgent(config, deps) {
       const userMessage = { role: "user", content: input };
       return executeLoop([userMessage], options);
     },
+    async generate(input, schema, options = {}) {
+      validateInputText(input);
+      const jsonSchema = zodToJsonSchema(schema);
+      const schemaInstruction = [
+        "You MUST respond with valid JSON matching this schema:",
+        JSON.stringify(jsonSchema, null, 2),
+        "Respond ONLY with the JSON object, no markdown or explanation."
+      ].join(`
+`);
+      const augmentedInput = `${input}
+
+${schemaInstruction}`;
+      const userMessage = { role: "user", content: augmentedInput };
+      const agentResult = await executeLoop([userMessage], options);
+      const text = extractText(agentResult.message.content);
+      const cleaned = text.replace(/^```(?:json)?\s*\n?([\s\S]*?)\n?\s*```$/gm, "$1").trim();
+      const jsonMatch = cleaned.match(/(\{[\s\S]*\}|\[[\s\S]*\])/);
+      if (!jsonMatch) {
+        throw ElsiumError.validation("Agent response did not contain valid JSON");
+      }
+      const parsed = schema.safeParse(JSON.parse(jsonMatch[0]));
+      if (!parsed.success) {
+        throw ElsiumError.validation("Agent response did not match schema", {
+          errors: parsed.error.issues
+        });
+      }
+      return { data: parsed.data, result: agentResult };
+    },
     stream(input, options = {}) {
       validateInputText(input);
       const streamDeps = resolvedDeps;
@@ -9635,6 +9742,429 @@ function createAsyncAgent(config) {
     }
   };
 }
+// ../agents/src/channels.ts
+function createWebhookChannel(config) {
+  let messageHandler = null;
+  return {
+    name: config.name,
+    async start() {},
+    async stop() {},
+    async send(userId, message) {
+      await config.onSend?.(userId, message);
+    },
+    onMessage(handler) {
+      messageHandler = handler;
+    },
+    receive(message) {
+      if (!messageHandler)
+        return;
+      messageHandler({ ...message, channelName: config.name });
+    }
+  };
+}
+function createChannelGateway(config) {
+  const adapterMap = new Map;
+  for (const adapter of config.adapters) {
+    if (adapter.name === "__proto__" || adapter.name === "constructor" || adapter.name === "prototype")
+      continue;
+    adapterMap.set(adapter.name, adapter);
+  }
+  function findAdapter(channelName) {
+    return adapterMap.get(channelName);
+  }
+  async function handleIncoming(message) {
+    const agent = config.resolveAgent?.(message) ?? config.agent;
+    try {
+      const session = await config.router.resolve({
+        channelName: message.channelName,
+        userId: message.userId,
+        agent
+      });
+      const result = await session.send(message.text);
+      const responseText = typeof result.message.content === "string" ? result.message.content : "";
+      const adapter = findAdapter(message.channelName);
+      if (adapter && responseText) {
+        await adapter.send(message.userId, { text: responseText });
+      }
+    } catch (err2) {
+      const error = err2 instanceof Error ? err2 : new Error(String(err2));
+      try {
+        config.onError?.(error, message);
+      } catch {}
+    }
+  }
+  for (const adapter of config.adapters) {
+    adapter.onMessage(handleIncoming);
+  }
+  return {
+    adapters: adapterMap,
+    async start() {
+      const startPromises = [...adapterMap.values()].map((a) => a.start());
+      await Promise.all(startPromises);
+    },
+    async stop() {
+      const stopPromises = [...adapterMap.values()].map((a) => a.stop());
+      await Promise.all(stopPromises);
+    }
+  };
+}
+// ../agents/src/session.ts
+function sessionKey(channelName, userId) {
+  return `${channelName}::${userId}`;
+}
+function createSessionRouter(config) {
+  const sessions = new Map;
+  const concurrency = config.concurrency ?? "serial";
+  const sessionTimeout = config.sessionTimeout ?? 0;
+  let cleanupTimer = null;
+  if (sessionTimeout > 0) {
+    cleanupTimer = setInterval(() => {
+      const now = Date.now();
+      for (const [key, session] of sessions) {
+        if (now - session.lastActiveAt > sessionTimeout) {
+          sessions.delete(key);
+          try {
+            config.onSessionExpired?.({
+              sessionId: session.sessionId,
+              channelName: session.channelName,
+              userId: session.userId,
+              agentName: session.agent.name,
+              createdAt: session.createdAt,
+              lastActiveAt: session.lastActiveAt
+            });
+          } catch {}
+        }
+      }
+    }, Math.min(sessionTimeout, 60000));
+    if (typeof cleanupTimer === "object" && "unref" in cleanupTimer) {
+      cleanupTimer.unref();
+    }
+  }
+  function toPublicSession(session) {
+    return {
+      sessionId: session.sessionId,
+      channelName: session.channelName,
+      userId: session.userId,
+      agentName: session.agent.name,
+      createdAt: session.createdAt,
+      lastActiveAt: session.lastActiveAt
+    };
+  }
+  async function createNewSession(key, channelName, userId, agent) {
+    const sessionId = generateId("sess");
+    const threadId = `${channelName}-${userId}-${sessionId}`;
+    let thread = null;
+    if (config.store) {
+      thread = await loadThread(threadId, { agent, store: config.store });
+    }
+    if (!thread) {
+      thread = createThread({
+        id: threadId,
+        agent,
+        metadata: { channelName, userId, sessionId },
+        store: config.store
+      });
+    }
+    const now = Date.now();
+    const session = {
+      sessionId,
+      channelName,
+      userId,
+      agent,
+      thread,
+      createdAt: now,
+      lastActiveAt: now,
+      lock: null,
+      lockResolve: null
+    };
+    sessions.set(key, session);
+    try {
+      config.onSessionCreated?.(toPublicSession(session));
+    } catch {}
+    return session;
+  }
+  function wrapThreadWithConcurrency(session) {
+    if (concurrency !== "serial")
+      return session.thread;
+    const originalSend = session.thread.send.bind(session.thread);
+    return {
+      ...session.thread,
+      async send(input, options) {
+        while (session.lock) {
+          await session.lock;
+        }
+        let unlock;
+        session.lock = new Promise((resolve) => {
+          unlock = resolve;
+        });
+        session.lockResolve = unlock;
+        try {
+          const result = await originalSend(input, options);
+          session.lastActiveAt = Date.now();
+          return result;
+        } finally {
+          session.lock = null;
+          session.lockResolve = null;
+          unlock();
+        }
+      }
+    };
+  }
+  return {
+    async resolve(options) {
+      const agent = options.agent ?? config.defaultAgent;
+      const key = sessionKey(options.channelName, options.userId);
+      let session = sessions.get(key);
+      if (session && sessionTimeout > 0) {
+        const now = Date.now();
+        if (now - session.lastActiveAt > sessionTimeout) {
+          sessions.delete(key);
+          try {
+            config.onSessionExpired?.(toPublicSession(session));
+          } catch {}
+          session = undefined;
+        }
+      }
+      if (!session) {
+        session = await createNewSession(key, options.channelName, options.userId, agent);
+      }
+      session.lastActiveAt = Date.now();
+      return wrapThreadWithConcurrency(session);
+    },
+    getSession(channelName, userId) {
+      const session = sessions.get(sessionKey(channelName, userId));
+      return session ? toPublicSession(session) : null;
+    },
+    listSessions() {
+      return [...sessions.values()].map(toPublicSession);
+    },
+    endSession(channelName, userId) {
+      return sessions.delete(sessionKey(channelName, userId));
+    },
+    endAllSessions() {
+      sessions.clear();
+      if (cleanupTimer) {
+        clearInterval(cleanupTimer);
+        cleanupTimer = null;
+      }
+    }
+  };
+}
+// ../agents/src/scheduler.ts
+function parseCronExpression(expression) {
+  const parts = expression.trim().split(/\s+/);
+  if (parts.length !== 5)
+    return null;
+  const minute = parseCronField(parts[0], 0, 59);
+  const hour = parseCronField(parts[1], 0, 23);
+  const dayOfMonth = parseCronField(parts[2], 1, 31);
+  const month = parseCronField(parts[3], 1, 12);
+  const dayOfWeek = parseCronField(parts[4], 0, 6);
+  if (!minute || !hour || !dayOfMonth || !month || !dayOfWeek)
+    return null;
+  return { minute, hour, dayOfMonth, month, dayOfWeek };
+}
+function parseStepPart(match, min, max) {
+  const step = Number.parseInt(match[2], 10);
+  if (step <= 0)
+    return null;
+  let rangeStart = min;
+  let rangeEnd = max;
+  if (match[1] !== "*") {
+    const rangeParts = match[1].split("-");
+    rangeStart = Number.parseInt(rangeParts[0], 10);
+    rangeEnd = rangeParts[1] ? Number.parseInt(rangeParts[1], 10) : max;
+  }
+  const values = [];
+  for (let i = rangeStart;i <= rangeEnd; i += step) {
+    if (i >= min && i <= max)
+      values.push(i);
+  }
+  return values;
+}
+function parseRangePart(match, min, max) {
+  const start = Number.parseInt(match[1], 10);
+  const end = Number.parseInt(match[2], 10);
+  if (start > end || start < min || end > max)
+    return null;
+  const values = [];
+  for (let i = start;i <= end; i++) {
+    values.push(i);
+  }
+  return values;
+}
+function parseSinglePart(part, min, max) {
+  const stepMatch = part.match(/^(\*|\d+(?:-\d+)?)\/(\d+)$/);
+  if (stepMatch)
+    return parseStepPart(stepMatch, min, max);
+  const rangeMatch = part.match(/^(\d+)-(\d+)$/);
+  if (rangeMatch)
+    return parseRangePart(rangeMatch, min, max);
+  const num = Number.parseInt(part, 10);
+  if (Number.isNaN(num) || num < min || num > max)
+    return null;
+  return [num];
+}
+function parseCronField(field, min, max) {
+  if (field === "*") {
+    return Array.from({ length: max - min + 1 }, (_, i) => min + i);
+  }
+  const values = [];
+  for (const part of field.split(",")) {
+    const result = parseSinglePart(part, min, max);
+    if (!result)
+      return null;
+    values.push(...result);
+  }
+  return values.length > 0 ? values : null;
+}
+function cronMatchesDate(fields, date) {
+  return fields.minute.includes(date.getMinutes()) && fields.hour.includes(date.getHours()) && fields.dayOfMonth.includes(date.getDate()) && fields.month.includes(date.getMonth() + 1) && fields.dayOfWeek.includes(date.getDay());
+}
+function getNextCronDate(fields, after) {
+  const next = new Date(after.getTime());
+  next.setSeconds(0, 0);
+  next.setMinutes(next.getMinutes() + 1);
+  const maxIterations = 525600;
+  for (let i = 0;i < maxIterations; i++) {
+    if (cronMatchesDate(fields, next))
+      return next;
+    next.setMinutes(next.getMinutes() + 1);
+  }
+  return next;
+}
+function createScheduler(config) {
+  const tasks = new Map;
+  let timer = null;
+  const tickInterval = config.tickIntervalMs ?? 60000;
+  function toPublicTask(task) {
+    return {
+      id: task.id,
+      name: task.name,
+      cronExpression: task.cronExpression,
+      enabled: task.enabled,
+      lastRunAt: task.lastRunAt,
+      nextRunAt: task.nextRunAt,
+      runCount: task.runCount
+    };
+  }
+  function updateNextRun(task) {
+    const fields = parseCronExpression(task.cronExpression);
+    task.nextRunAt = fields ? getNextCronDate(fields, new Date).getTime() : null;
+  }
+  function handleTaskSuccess(task, result) {
+    task.lastRunAt = Date.now();
+    task.runCount++;
+    task.running = false;
+    if (task.maxRuns !== null && task.runCount >= task.maxRuns) {
+      task.enabled = false;
+      task.nextRunAt = null;
+    } else {
+      updateNextRun(task);
+    }
+    try {
+      config.onComplete?.(toPublicTask(task), result);
+    } catch {}
+  }
+  function handleTaskError(task, err2) {
+    task.running = false;
+    task.lastRunAt = Date.now();
+    updateNextRun(task);
+    const error = err2 instanceof Error ? err2 : new Error(String(err2));
+    try {
+      config.onError?.(toPublicTask(task), error);
+    } catch {}
+  }
+  async function executeTask(task) {
+    if (task.running)
+      return;
+    task.running = true;
+    const agent = config.resolveAgent?.(toPublicTask(task)) ?? config.agent;
+    try {
+      const result = await agent.run(task.input);
+      handleTaskSuccess(task, result);
+    } catch (err2) {
+      handleTaskError(task, err2);
+    }
+  }
+  function tick() {
+    const now = Date.now();
+    for (const task of tasks.values()) {
+      if (!task.enabled || task.running)
+        continue;
+      if (task.nextRunAt !== null && task.nextRunAt <= now) {
+        executeTask(task);
+      }
+    }
+  }
+  return {
+    schedule(cronExpression, input, options = {}) {
+      const fields = parseCronExpression(cronExpression);
+      if (!fields) {
+        throw new Error(`Invalid cron expression: ${cronExpression}`);
+      }
+      const id = options.id ?? generateId("sched");
+      const now = new Date;
+      const nextRunAt = options.startImmediately ? Date.now() : getNextCronDate(fields, now).getTime();
+      const task = {
+        id,
+        name: options.name ?? `task-${id}`,
+        cronExpression,
+        input,
+        enabled: true,
+        lastRunAt: null,
+        nextRunAt,
+        runCount: 0,
+        maxRuns: options.maxRuns ?? null,
+        metadata: options.metadata ?? {},
+        running: false
+      };
+      tasks.set(id, task);
+      if (options.startImmediately) {
+        executeTask(task);
+      }
+      return toPublicTask(task);
+    },
+    unschedule(taskId) {
+      return tasks.delete(taskId);
+    },
+    getTask(taskId) {
+      const task = tasks.get(taskId);
+      return task ? toPublicTask(task) : null;
+    },
+    listTasks() {
+      return [...tasks.values()].map(toPublicTask);
+    },
+    pause(taskId) {
+      const task = tasks.get(taskId);
+      if (!task)
+        return false;
+      task.enabled = false;
+      return true;
+    },
+    resume(taskId) {
+      const task = tasks.get(taskId);
+      if (!task)
+        return false;
+      task.enabled = true;
+      const fields = parseCronExpression(task.cronExpression);
+      task.nextRunAt = fields ? getNextCronDate(fields, new Date).getTime() : null;
+      return true;
+    },
+    start() {
+      if (timer)
+        return;
+      tick();
+      timer = setInterval(tick, tickInterval);
+    },
+    stop() {
+      if (timer) {
+        clearInterval(timer);
+        timer = null;
+      }
+    }
+  };
+}
 // ../rag/src/loaders.ts
 function createDocument(content, metadata) {
   return {
@@ -15735,6 +16265,7 @@ export {
   redactSecrets,
   rag,
   parseTraceparent,
+  parseCronExpression,
   outputGuardrailMiddleware,
   ok,
   observe,
@@ -15750,6 +16281,7 @@ export {
   httpFetchTool,
   getProviderMetadata,
   getProviderFactory,
+  getNextCronDate,
   generateTraceId,
   generateId,
   gateway,
@@ -15774,13 +16306,19 @@ export {
   defineBranchWorkflow,
   defineAgent,
   currentTimeTool,
+  cronMatchesDate,
+  createWebhookChannel,
   createToolkit,
   createThread,
+  createSummarizeFn,
   createStream,
   createSqliteMemoryStore,
   createSpan,
   createSnapshotStore,
+  createSessionRouter,
   createSemanticValidator,
+  createScheduler,
+  createRetrievalTool,
   createReplayRecorder,
   createReplayPlayer,
   createRegressionSuite,
@@ -15809,6 +16347,7 @@ export {
   createContextManager,
   createConfidenceScorer,
   createClient,
+  createChannelGateway,
   createBatch,
   createAsyncAgent,
   createApp,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "elsium-ai",
-	"version": "0.5.0",
+	"version": "0.6.0",
 	"description": "ElsiumAI — A high-performance, TypeScript-first AI framework",
 	"license": "MIT",
 	"author": "Eric Utrera <ebutrera9103@gmail.com>",
@@ -25,17 +25,17 @@
 		"build": "bun build ./src/index.ts --outdir ./dist --target node && bun x tsc -p tsconfig.build.json --emitDeclarationOnly"
 	},
 	"dependencies": {
-		"@elsium-ai/core": "^0.5.0",
-		"@elsium-ai/gateway": "^0.5.0",
-		"@elsium-ai/agents": "^0.5.0",
-		"@elsium-ai/tools": "^0.5.0",
-		"@elsium-ai/rag": "^0.5.0",
-		"@elsium-ai/workflows": "^0.5.0",
-		"@elsium-ai/observe": "^0.5.0",
-		"@elsium-ai/app": "^0.5.0",
-		"@elsium-ai/testing": "^0.5.0",
-		"@elsium-ai/mcp": "^0.5.0",
-		"@elsium-ai/client": "^0.5.0"
+		"@elsium-ai/core": "^0.6.0",
+		"@elsium-ai/gateway": "^0.6.0",
+		"@elsium-ai/agents": "^0.6.0",
+		"@elsium-ai/tools": "^0.6.0",
+		"@elsium-ai/rag": "^0.6.0",
+		"@elsium-ai/workflows": "^0.6.0",
+		"@elsium-ai/observe": "^0.6.0",
+		"@elsium-ai/app": "^0.6.0",
+		"@elsium-ai/testing": "^0.6.0",
+		"@elsium-ai/mcp": "^0.6.0",
+		"@elsium-ai/client": "^0.6.0"
 	},
 	"devDependencies": {
 		"typescript": "^5.7.0"