@dexto/core 1.3.0 → 1.5.0

package/dist/session/session-manager.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { randomUUID } from "crypto";
 import { ChatSession } from "./chat-session.js";
 import { DextoLogComponent } from "../logger/v2/types.js";
@@ -18,6 +18,8 @@ class SessionManager {
   initializationPromise;
   // Add a Map to track ongoing session creation operations to prevent race conditions
   pendingCreations = /* @__PURE__ */ new Map();
+  // Per-session mutex for token usage updates to prevent lost updates from concurrent calls
+  tokenUsageLocks = /* @__PURE__ */ new Map();
   logger;
   /**
    * Initialize the SessionManager with persistent storage.
@@ -273,12 +275,17 @@ class SessionManager {
     await this.ensureInitialized();
     const sessionKey = `session:${sessionId}`;
     const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
-    return sessionData ? {
+    if (!sessionData) return void 0;
+    return {
       createdAt: sessionData.createdAt,
       lastActivity: sessionData.lastActivity,
       messageCount: sessionData.messageCount,
-      title: sessionData.metadata?.title
-    } : void 0;
+      title: sessionData.metadata?.title,
+      ...sessionData.tokenUsage && { tokenUsage: sessionData.tokenUsage },
+      ...sessionData.estimatedCost !== void 0 && {
+        estimatedCost: sessionData.estimatedCost
+      }
+    };
   }
   /**
    * Get the global session manager configuration.
@@ -315,6 +322,51 @@ class SessionManager {
       await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
     }
   }
+  /**
+   * Accumulates token usage for a session.
+   * Called after each LLM response to update session-level totals.
+   *
+   * Uses per-session locking to prevent lost updates from concurrent calls.
+   */
+  async accumulateTokenUsage(sessionId, usage, cost) {
+    await this.ensureInitialized();
+    const sessionKey = `session:${sessionId}`;
+    const previousLock = this.tokenUsageLocks.get(sessionKey) ?? Promise.resolve();
+    const currentLock = previousLock.then(async () => {
+      const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
+      if (!sessionData) return;
+      if (!sessionData.tokenUsage) {
+        sessionData.tokenUsage = {
+          inputTokens: 0,
+          outputTokens: 0,
+          reasoningTokens: 0,
+          cacheReadTokens: 0,
+          cacheWriteTokens: 0,
+          totalTokens: 0
+        };
+      }
+      sessionData.tokenUsage.inputTokens += usage.inputTokens ?? 0;
+      sessionData.tokenUsage.outputTokens += usage.outputTokens ?? 0;
+      sessionData.tokenUsage.reasoningTokens += usage.reasoningTokens ?? 0;
+      sessionData.tokenUsage.cacheReadTokens += usage.cacheReadTokens ?? 0;
+      sessionData.tokenUsage.cacheWriteTokens += usage.cacheWriteTokens ?? 0;
+      sessionData.tokenUsage.totalTokens += usage.totalTokens ?? 0;
+      if (cost !== void 0) {
+        sessionData.estimatedCost = (sessionData.estimatedCost ?? 0) + cost;
+      }
+      sessionData.lastActivity = Date.now();
+      await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
+      await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
+    });
+    this.tokenUsageLocks.set(sessionKey, currentLock);
+    try {
+      await currentLock;
+    } finally {
+      if (this.tokenUsageLocks.get(sessionKey) === currentLock) {
+        this.tokenUsageLocks.delete(sessionKey);
+      }
+    }
+  }
   /**
    * Sets the human-friendly title for a session.
    * Title is stored in session metadata and cached with TTL.
@@ -400,11 +452,10 @@ class SessionManager {
     }
     this.services.agentEventBus.emit("llm:switched", {
       newConfig: newLLMConfig,
-      router: newLLMConfig.router,
       historyRetained: true,
       sessionIds: sessionIds.filter((id) => !failedSessions.includes(id))
     });
-    const message = failedSessions.length > 0 ? `Successfully switched to ${newLLMConfig.provider}/${newLLMConfig.model} using ${newLLMConfig.router} router (${failedSessions.length} sessions failed)` : `Successfully switched to ${newLLMConfig.provider}/${newLLMConfig.model} using ${newLLMConfig.router} router for all sessions`;
+    const message = failedSessions.length > 0 ? `Successfully switched to ${newLLMConfig.provider}/${newLLMConfig.model} (${failedSessions.length} sessions failed)` : `Successfully switched to ${newLLMConfig.provider}/${newLLMConfig.model} for all sessions`;
     const warnings = failedSessions.length > 0 ? [`Failed to switch LLM for sessions: ${failedSessions.join(", ")}`] : [];
     return { message, warnings };
   }
@@ -422,11 +473,10 @@ class SessionManager {
     await session.switchLLM(newLLMConfig);
     this.services.agentEventBus.emit("llm:switched", {
       newConfig: newLLMConfig,
-      router: newLLMConfig.router,
       historyRetained: true,
       sessionIds: [sessionId]
     });
-    const message = `Successfully switched to ${newLLMConfig.provider}/${newLLMConfig.model} using ${newLLMConfig.router} router for session ${sessionId}`;
+    const message = `Successfully switched to ${newLLMConfig.provider}/${newLLMConfig.model} for session ${sessionId}`;
     return { message, warnings: [] };
   }
   /**

package/dist/session/title-generator.cjs

@@ -25,7 +25,7 @@ module.exports = __toCommonJS(title_generator_exports);
 var import_factory = require("../llm/services/factory.cjs");
 var import_events = require("../events/index.cjs");
 var import_memory = require("./history/memory.js");
-async function generateSessionTitle(config, router, toolManager, systemPromptManager, resourceManager, userText, logger, opts = {}) {
+async function generateSessionTitle(config, toolManager, systemPromptManager, resourceManager, userText, logger, opts = {}) {
   const timeoutMs = opts.timeoutMs;
   const controller = timeoutMs !== void 0 ? new AbortController() : void 0;
   let timer;
@@ -33,11 +33,10 @@ async function generateSessionTitle(config, router, toolManager, systemPromptMan
     timer = setTimeout(() => controller.abort(), timeoutMs);
   }
   try {
-    const history = new import_memory.MemoryHistoryProvider();
+    const history = new import_memory.MemoryHistoryProvider(logger);
     const bus = new import_events.SessionEventBus();
     const tempService = (0, import_factory.createLLMService)(
       config,
-      router,
       toolManager,
       systemPromptManager,
       history,
@@ -53,12 +52,9 @@ async function generateSessionTitle(config, router, toolManager, systemPromptMan
       "Message:",
       sanitizeUserText(userText, 512)
     ].join("\n");
-    const result = await tempService.completeTask(
+    const result = await tempService.stream(
       instruction,
-      controller ? { signal: controller.signal } : {},
-      void 0,
-      void 0,
-      false
+      controller ? { signal: controller.signal } : void 0
     );
     const processed = postProcessTitle(result);
     if (!processed) {

package/dist/session/title-generator.d.ts

@@ -1,5 +1,4 @@
 import type { ValidatedLLMConfig } from '../llm/schemas.js';
-import type { LLMRouter } from '../llm/types.js';
 import type { ToolManager } from '../tools/tool-manager.js';
 import type { SystemPromptManager } from '../systemPrompt/manager.js';
 import type { ResourceManager } from '../resources/index.js';
@@ -13,7 +12,7 @@ export interface GenerateSessionTitleResult {
  * Generate a concise title for a chat based on the first user message.
  * Runs a lightweight, isolated LLM completion that does not touch real history.
  */
-export declare function generateSessionTitle(config: ValidatedLLMConfig, router: LLMRouter, toolManager: ToolManager, systemPromptManager: SystemPromptManager, resourceManager: ResourceManager, userText: string, logger: IDextoLogger, opts?: {
+export declare function generateSessionTitle(config: ValidatedLLMConfig, toolManager: ToolManager, systemPromptManager: SystemPromptManager, resourceManager: ResourceManager, userText: string, logger: IDextoLogger, opts?: {
     timeoutMs?: number;
 }): Promise<GenerateSessionTitleResult>;
 /**

package/dist/session/title-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"title-generator.d.ts","sourceRoot":"","sources":["../../src/session/title-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D,MAAM,WAAW,0BAA0B;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,EACxB,mBAAmB,EAAE,mBAAmB,EACxC,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,0BAA0B,CAAC,CAuDrC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8BzE"}
+{"version":3,"file":"title-generator.d.ts","sourceRoot":"","sources":["../../src/session/title-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D,MAAM,WAAW,0BAA0B;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,WAAW,EACxB,mBAAmB,EAAE,mBAAmB,EACxC,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,0BAA0B,CAAC,CAmDrC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8BzE"}

package/dist/session/title-generator.js

@@ -1,8 +1,8 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { createLLMService } from "../llm/services/factory.js";
 import { SessionEventBus } from "../events/index.js";
 import { MemoryHistoryProvider } from "./history/memory.js";
-async function generateSessionTitle(config, router, toolManager, systemPromptManager, resourceManager, userText, logger, opts = {}) {
+async function generateSessionTitle(config, toolManager, systemPromptManager, resourceManager, userText, logger, opts = {}) {
   const timeoutMs = opts.timeoutMs;
   const controller = timeoutMs !== void 0 ? new AbortController() : void 0;
   let timer;
@@ -10,11 +10,10 @@ async function generateSessionTitle(config, router, toolManager, systemPromptMan
     timer = setTimeout(() => controller.abort(), timeoutMs);
   }
   try {
-    const history = new MemoryHistoryProvider();
+    const history = new MemoryHistoryProvider(logger);
     const bus = new SessionEventBus();
     const tempService = createLLMService(
       config,
-      router,
       toolManager,
       systemPromptManager,
       history,
@@ -30,12 +29,9 @@ async function generateSessionTitle(config, router, toolManager, systemPromptMan
       "Message:",
       sanitizeUserText(userText, 512)
     ].join("\n");
-    const result = await tempService.completeTask(
+    const result = await tempService.stream(
       instruction,
-      controller ? { signal: controller.signal } : {},
-      void 0,
-      void 0,
-      false
+      controller ? { signal: controller.signal } : void 0
     );
     const processed = postProcessTitle(result);
     if (!processed) {

package/dist/session/types.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/session/types.d.ts

@@ -0,0 +1,14 @@
+import { ContentPart } from '../context/types.js';
+export interface QueuedMessage {
+    id: string;
+    content: ContentPart[];
+    queuedAt: number;
+    metadata?: Record<string, unknown>;
+}
+export interface CoalescedMessage {
+    messages: QueuedMessage[];
+    combinedContent: ContentPart[];
+    firstQueuedAt: number;
+    lastQueuedAt: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACxB"}

package/dist/storage/blob/factory.cjs

@@ -21,19 +21,16 @@ __export(factory_exports, {
   createBlobStore: () => createBlobStore
 });
 module.exports = __toCommonJS(factory_exports);
-var import_local_blob_store = require("./local-blob-store.js");
-var import_memory_blob_store = require("./memory-blob-store.js");
+var import_registry = require("./registry.js");
 function createBlobStore(config, logger) {
-  switch (config.type) {
-    case "in-memory":
-      logger.info("Using in-memory blob store");
-      return new import_memory_blob_store.InMemoryBlobStore(config, logger);
-    case "local":
-      logger.info("Using local file-based blob store");
-      return new import_local_blob_store.LocalBlobStore(config, logger);
-    default:
-      throw new Error(`Unknown blob store type: ${config.type}`);
+  const validatedConfig = import_registry.blobStoreRegistry.validateConfig(config);
+  const provider = import_registry.blobStoreRegistry.get(validatedConfig.type);
+  if (!provider) {
+    throw new Error(`Provider '${validatedConfig.type}' not found in registry`);
   }
+  const providerName = provider.metadata?.displayName || validatedConfig.type;
+  logger.info(`Using ${providerName} blob store`);
+  return provider.create(validatedConfig, logger);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/storage/blob/factory.d.ts

@@ -1,11 +1,37 @@
 import type { BlobStore } from './types.js';
-import type { BlobStoreConfig } from './schemas.js';
 import type { IDextoLogger } from '../../logger/v2/types.js';
 /**
- * Create a blob store based on configuration.
- * Blob paths are provided via CLI enrichment layer for local storage.
- * @param config Blob store configuration
- * @param logger Logger instance for logging
+ * Create a blob store based on configuration using the provider registry.
+ *
+ * This factory function:
+ * 1. Validates the configuration against the registered provider's schema
+ * 2. Looks up the provider in the registry
+ * 3. Calls the provider's create method to instantiate the blob store
+ *
+ * The configuration type is determined at runtime by the 'type' field,
+ * which must match a registered provider. Custom providers can be registered
+ * via blobStoreRegistry.register() before calling this function.
+ *
+ * @param config - Blob store configuration with a 'type' discriminator
+ * @param logger - Logger instance for the blob store
+ * @returns A BlobStore implementation
+ * @throws Error if the provider type is not registered or validation fails
+ *
+ * @example
+ * ```typescript
+ * // Using built-in provider
+ * const blob = createBlobStore({ type: 'local', storePath: '/tmp/blobs' }, logger);
+ *
+ * // Using custom provider (registered beforehand)
+ * import { blobStoreRegistry } from '@dexto/core';
+ * import { s3Provider } from './storage/s3-provider.js';
+ *
+ * blobStoreRegistry.register(s3Provider);
+ * const blob = createBlobStore({ type: 's3', bucket: 'my-bucket' }, logger);
+ * ```
  */
-export declare function createBlobStore(config: BlobStoreConfig, logger: IDextoLogger): BlobStore;
+export declare function createBlobStore(config: {
+    type: string;
+    [key: string]: any;
+}, logger: IDextoLogger): BlobStore;
 //# sourceMappingURL=factory.d.ts.map

package/dist/storage/blob/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/storage/blob/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,CAaxF"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/storage/blob/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAC3B,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,EAC5C,MAAM,EAAE,YAAY,GACrB,SAAS,CAgBX"}

package/dist/storage/blob/factory.js

@@ -1,17 +1,14 @@
-import "../../chunk-C6A6W6XS.js";
-import { LocalBlobStore } from "./local-blob-store.js";
-import { InMemoryBlobStore } from "./memory-blob-store.js";
+import "../../chunk-PTJYTZNU.js";
+import { blobStoreRegistry } from "./registry.js";
 function createBlobStore(config, logger) {
-  switch (config.type) {
-    case "in-memory":
-      logger.info("Using in-memory blob store");
-      return new InMemoryBlobStore(config, logger);
-    case "local":
-      logger.info("Using local file-based blob store");
-      return new LocalBlobStore(config, logger);
-    default:
-      throw new Error(`Unknown blob store type: ${config.type}`);
+  const validatedConfig = blobStoreRegistry.validateConfig(config);
+  const provider = blobStoreRegistry.get(validatedConfig.type);
+  if (!provider) {
+    throw new Error(`Provider '${validatedConfig.type}' not found in registry`);
   }
+  const providerName = provider.metadata?.displayName || validatedConfig.type;
+  logger.info(`Using ${providerName} blob store`);
+  return provider.create(validatedConfig, logger);
 }
 export {
   createBlobStore

package/dist/storage/blob/index.cjs

@@ -0,0 +1,56 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var blob_exports = {};
+__export(blob_exports, {
+  BLOB_STORE_TYPES: () => import_schemas.BLOB_STORE_TYPES,
+  BlobStoreConfigSchema: () => import_schemas.BlobStoreConfigSchema,
+  BlobStoreRegistry: () => import_registry2.BlobStoreRegistry,
+  InMemoryBlobStore: () => import_memory_blob_store.InMemoryBlobStore,
+  InMemoryBlobStoreSchema: () => import_schemas.InMemoryBlobStoreSchema,
+  LocalBlobStore: () => import_local_blob_store.LocalBlobStore,
+  LocalBlobStoreSchema: () => import_schemas.LocalBlobStoreSchema,
+  blobStoreRegistry: () => import_registry2.blobStoreRegistry,
+  createBlobStore: () => import_factory.createBlobStore
+});
+module.exports = __toCommonJS(blob_exports);
+var import_registry = require("./registry.js");
+var import_providers = require("./providers/index.js");
+var import_factory = require("./factory.js");
+var import_registry2 = require("./registry.js");
+var import_schemas = require("./schemas.js");
+var import_local_blob_store = require("./local-blob-store.js");
+var import_memory_blob_store = require("./memory-blob-store.js");
+if (!import_registry.blobStoreRegistry.has("local")) {
+  import_registry.blobStoreRegistry.register(import_providers.localBlobStoreProvider);
+}
+if (!import_registry.blobStoreRegistry.has("in-memory")) {
+  import_registry.blobStoreRegistry.register(import_providers.inMemoryBlobStoreProvider);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BLOB_STORE_TYPES,
+  BlobStoreConfigSchema,
+  BlobStoreRegistry,
+  InMemoryBlobStore,
+  InMemoryBlobStoreSchema,
+  LocalBlobStore,
+  LocalBlobStoreSchema,
+  blobStoreRegistry,
+  createBlobStore
+});

package/dist/storage/blob/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Blob Storage Module
+ *
+ * This module provides a flexible blob storage system with support for
+ * multiple backends through a provider pattern.
+ *
+ * ## Built-in Providers
+ * - `local`: Store blobs on the local filesystem
+ * - `in-memory`: Store blobs in RAM (for testing/development)
+ *
+ * ## Custom Providers
+ * Custom providers (e.g., S3, Azure, Supabase) can be registered at the
+ * CLI/server layer before configuration loading.
+ *
+ * ## Usage
+ *
+ * ### Using built-in providers
+ * ```typescript
+ * import { createBlobStore } from '@dexto/core';
+ *
+ * const blob = createBlobStore({ type: 'local', storePath: '/tmp' }, logger);
+ * ```
+ *
+ * ### Registering custom providers
+ * ```typescript
+ * import { blobStoreRegistry, type BlobStoreProvider } from '@dexto/core';
+ *
+ * const s3Provider: BlobStoreProvider<'s3', S3Config> = {
+ *   type: 's3',
+ *   configSchema: S3ConfigSchema,
+ *   create: (config, logger) => new S3BlobStore(config, logger),
+ * };
+ *
+ * blobStoreRegistry.register(s3Provider);
+ * const blob = createBlobStore({ type: 's3', bucket: 'my-bucket' }, logger);
+ * ```
+ */
+export { createBlobStore } from './factory.js';
+export { blobStoreRegistry, BlobStoreRegistry } from './registry.js';
+export type { BlobStoreProvider } from './provider.js';
+export type { BlobStore, BlobInput, BlobMetadata, BlobReference, BlobData, BlobStats, StoredBlobMetadata, } from './types.js';
+export { BLOB_STORE_TYPES, BlobStoreConfigSchema, InMemoryBlobStoreSchema, LocalBlobStoreSchema, type BlobStoreType, type BlobStoreConfig, type InMemoryBlobStoreConfig, type LocalBlobStoreConfig, } from './schemas.js';
+export { LocalBlobStore } from './local-blob-store.js';
+export { InMemoryBlobStore } from './memory-blob-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/blob/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/blob/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAiBH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,YAAY,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,SAAS,EACT,kBAAkB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,GAC5B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/storage/blob/index.js

@@ -0,0 +1,30 @@
+import "../../chunk-PTJYTZNU.js";
+import { blobStoreRegistry } from "./registry.js";
+import { localBlobStoreProvider, inMemoryBlobStoreProvider } from "./providers/index.js";
+if (!blobStoreRegistry.has("local")) {
+  blobStoreRegistry.register(localBlobStoreProvider);
+}
+if (!blobStoreRegistry.has("in-memory")) {
+  blobStoreRegistry.register(inMemoryBlobStoreProvider);
+}
+import { createBlobStore } from "./factory.js";
+import { blobStoreRegistry as blobStoreRegistry2, BlobStoreRegistry } from "./registry.js";
+import {
+  BLOB_STORE_TYPES,
+  BlobStoreConfigSchema,
+  InMemoryBlobStoreSchema,
+  LocalBlobStoreSchema
+} from "./schemas.js";
+import { LocalBlobStore } from "./local-blob-store.js";
+import { InMemoryBlobStore } from "./memory-blob-store.js";
+export {
+  BLOB_STORE_TYPES,
+  BlobStoreConfigSchema,
+  BlobStoreRegistry,
+  InMemoryBlobStore,
+  InMemoryBlobStoreSchema,
+  LocalBlobStore,
+  LocalBlobStoreSchema,
+  blobStoreRegistry2 as blobStoreRegistry,
+  createBlobStore
+};

package/dist/storage/blob/local-blob-store.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { promises as fs, createReadStream } from "fs";
 import path from "path";
 import { createHash } from "crypto";

package/dist/storage/blob/memory-blob-store.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { createHash } from "crypto";
 import { Readable } from "stream";
 import { DextoLogComponent } from "../../logger/v2/types.js";

package/dist/storage/blob/provider.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var provider_exports = {};
+module.exports = __toCommonJS(provider_exports);

package/dist/storage/blob/provider.d.ts

@@ -0,0 +1,50 @@
+import type { z } from 'zod';
+import type { BlobStore } from './types.js';
+import type { IDextoLogger } from '../../logger/v2/types.js';
+/**
+ * Provider interface for creating blob store instances.
+ *
+ * This interface uses TypeScript generics to enforce type safety:
+ * - TType: The literal type string (e.g., 'local', 's3')
+ * - TConfig: The configuration type with discriminator { type: TType }
+ *
+ * This ensures that the provider type matches the config type discriminator,
+ * providing compile-time safety for provider implementations.
+ */
+export interface BlobStoreProvider<TType extends string = string, TConfig extends {
+    type: TType;
+} = any> {
+    /**
+     * Unique identifier for this provider (e.g., 'local', 'supabase', 's3').
+     * Must match the 'type' field in the configuration.
+     */
+    type: TType;
+    /**
+     * Zod schema for validating provider-specific configuration.
+     * The schema must output TConfig type.
+     *
+     * Note: Uses z.ZodType with relaxed generics to allow input/output type variance.
+     * This is necessary because Zod schemas with `.optional().default()` have
+     * input types that include undefined, but output types that don't.
+     */
+    configSchema: z.ZodType<TConfig, any, any>;
+    /**
+     * Factory function to create a BlobStore instance.
+     * @param config - Validated configuration specific to this provider
+     * @param logger - Logger instance for the blob store
+     * @returns A BlobStore implementation
+     */
+    create(config: TConfig, logger: IDextoLogger): BlobStore;
+    /**
+     * Optional metadata for documentation, UIs, and discovery.
+     */
+    metadata?: {
+        /** Human-readable name (e.g., "Local Filesystem", "Amazon S3") */
+        displayName: string;
+        /** Brief description of this storage backend */
+        description: string;
+        /** Whether this provider requires network connectivity */
+        requiresNetwork?: boolean;
+    };
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/storage/blob/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/storage/blob/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB,CAC9B,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,OAAO,SAAS;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG,GAAG;IAErC;;;OAGG;IACH,IAAI,EAAE,KAAK,CAAC;IAEZ;;;;;;;OAOG;IACH,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,EAAE;QACP,kEAAkE;QAClE,WAAW,EAAE,MAAM,CAAC;QACpB,gDAAgD;QAChD,WAAW,EAAE,MAAM,CAAC;QACpB,0DAA0D;QAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;CACL"}

package/dist/storage/blob/providers/index.cjs

@@ -0,0 +1,31 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var providers_exports = {};
+__export(providers_exports, {
+  inMemoryBlobStoreProvider: () => import_memory.inMemoryBlobStoreProvider,
+  localBlobStoreProvider: () => import_local.localBlobStoreProvider
+});
+module.exports = __toCommonJS(providers_exports);
+var import_local = require("./local.js");
+var import_memory = require("./memory.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  inMemoryBlobStoreProvider,
+  localBlobStoreProvider
+});

package/dist/storage/blob/providers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Built-in blob store providers.
+ *
+ * These providers are automatically registered when importing from @dexto/core.
+ */
+export { localBlobStoreProvider } from './local.js';
+export { inMemoryBlobStoreProvider } from './memory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/blob/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/blob/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC"}

package/dist/storage/blob/providers/index.js

@@ -0,0 +1,7 @@
+import "../../../chunk-PTJYTZNU.js";
+import { localBlobStoreProvider } from "./local.js";
+import { inMemoryBlobStoreProvider } from "./memory.js";
+export {
+  inMemoryBlobStoreProvider,
+  localBlobStoreProvider
+};