@dexto/core 1.2.6 → 1.4.0

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.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { LocalBlobStore } from "./local-blob-store.js";
 import { InMemoryBlobStore } from "./memory-blob-store.js";
 function createBlobStore(config, logger) {

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/schemas.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { z } from "zod";
 const BLOB_STORE_TYPES = ["in-memory", "local"];
 const InMemoryBlobStoreSchema = z.object({

package/dist/storage/cache/factory.cjs

@@ -32,6 +32,7 @@ __export(factory_exports, {
 });
 module.exports = __toCommonJS(factory_exports);
 var import_memory_cache_store = require("./memory-cache-store.js");
+var import_errors = require("../errors.js");
 let RedisStore = null;
 async function createCache(config, logger) {
   switch (config.type) {
@@ -52,8 +53,11 @@ async function createRedisStore(config, logger) {
     logger.info(`Connecting to Redis at ${config.host}:${config.port}`);
     return new RedisStore(config, logger);
   } catch (error) {
-    logger.warn(`Redis not available, falling back to in-memory cache: ${error}`);
-    return new import_memory_cache_store.MemoryCacheStore();
+    const err = error;
+    if (err.code === "ERR_MODULE_NOT_FOUND") {
+      throw import_errors.StorageError.dependencyNotInstalled("Redis", "ioredis", "npm install ioredis");
+    }
+    throw error;
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

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

@@ -3,7 +3,8 @@ import type { CacheConfig } from '../schemas.js';
 import type { IDextoLogger } from '../../logger/v2/types.js';
 /**
  * Create a cache store based on configuration.
- * Handles lazy loading of optional dependencies with automatic fallback.
+ * Handles lazy loading of optional dependencies.
+ * Throws StorageError.dependencyNotInstalled if required package is missing.
  * @param config Cache configuration
  * @param logger Logger instance for logging
  */

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/storage/cache/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAoB,WAAW,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAU7D;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAU3F"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/storage/cache/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAoB,WAAW,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAW7D;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAU3F"}

package/dist/storage/cache/factory.js

@@ -1,5 +1,6 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { MemoryCacheStore } from "./memory-cache-store.js";
+import { StorageError } from "../errors.js";
 let RedisStore = null;
 async function createCache(config, logger) {
   switch (config.type) {
@@ -20,8 +21,11 @@ async function createRedisStore(config, logger) {
     logger.info(`Connecting to Redis at ${config.host}:${config.port}`);
     return new RedisStore(config, logger);
   } catch (error) {
-    logger.warn(`Redis not available, falling back to in-memory cache: ${error}`);
-    return new MemoryCacheStore();
+    const err = error;
+    if (err.code === "ERR_MODULE_NOT_FOUND") {
+      throw StorageError.dependencyNotInstalled("Redis", "ioredis", "npm install ioredis");
+    }
+    throw error;
   }
 }
 export {

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

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { StorageError } from "../errors.js";
 class MemoryCacheStore {
   data = /* @__PURE__ */ new Map();

package/dist/storage/cache/redis-store.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { Redis } from "ioredis";
 import { DextoLogComponent } from "../../logger/v2/types.js";
 import { StorageError } from "../errors.js";

package/dist/storage/cache/schemas.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { z } from "zod";
 import { EnvExpandedString } from "../../utils/result.js";
 import { StorageErrorCode } from "../error-codes.js";

package/dist/storage/database/factory.cjs

@@ -32,6 +32,7 @@ __export(factory_exports, {
 });
 module.exports = __toCommonJS(factory_exports);
 var import_memory_database_store = require("./memory-database-store.js");
+var import_errors = require("../errors.js");
 let SQLiteStore = null;
 let PostgresStore = null;
 async function createDatabase(config, logger) {
@@ -55,27 +56,20 @@ async function createPostgresStore(config, logger) {
     logger.info("Connecting to PostgreSQL database");
     return new PostgresStore(config, logger);
   } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    logger.warn(
-      `PostgreSQL not available, falling back to in-memory database: ${errorMessage}`
-    );
-    return new import_memory_database_store.MemoryDatabaseStore();
+    const err = error;
+    if (err.code === "ERR_MODULE_NOT_FOUND") {
+      throw import_errors.StorageError.dependencyNotInstalled("PostgreSQL", "pg", "npm install pg");
+    }
+    throw error;
   }
 }
 async function createSQLiteStore(config, logger) {
-  try {
-    if (!SQLiteStore) {
-      const module2 = await import("./sqlite-store.js");
-      SQLiteStore = module2.SQLiteStore;
-    }
-    logger.info(`Creating SQLite database store: ${config.path}`);
-    return new SQLiteStore(config, logger);
-  } catch (error) {
-    const err = error instanceof Error ? error : new Error(String(error));
-    logger.error(`SQLite store failed to load: ${err.message}`, { error: err.message });
-    logger.warn("Falling back to in-memory database store");
-    return new import_memory_database_store.MemoryDatabaseStore();
+  if (!SQLiteStore) {
+    const module2 = await import("./sqlite-store.js");
+    SQLiteStore = module2.SQLiteStore;
   }
+  logger.info(`Creating SQLite database store: ${config.path}`);
+  return new SQLiteStore(config, logger);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

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

@@ -3,7 +3,8 @@ import type { DatabaseConfig } from '../schemas.js';
 import type { IDextoLogger } from '../../logger/v2/types.js';
 /**
  * Create a database store based on configuration.
- * Handles lazy loading of optional dependencies with automatic fallback.
+ * Handles lazy loading of optional dependencies.
+ * Throws StorageError.dependencyNotInstalled if required package is missing.
  * Database paths are provided via CLI enrichment layer.
  * @param config Database configuration with explicit paths
  * @param logger Logger instance for logging

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/storage/database/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAgD,MAAM,eAAe,CAAC;AAElG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAe7D;;;;;;GAMG;AACH,wBAAsB,cAAc,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,QAAQ,CAAC,CAanB"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/storage/database/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAgD,MAAM,eAAe,CAAC;AAElG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAgB7D;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,QAAQ,CAAC,CAanB"}

package/dist/storage/database/factory.js

@@ -1,5 +1,6 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { MemoryDatabaseStore } from "./memory-database-store.js";
+import { StorageError } from "../errors.js";
 let SQLiteStore = null;
 let PostgresStore = null;
 async function createDatabase(config, logger) {
@@ -23,27 +24,20 @@ async function createPostgresStore(config, logger) {
     logger.info("Connecting to PostgreSQL database");
     return new PostgresStore(config, logger);
   } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    logger.warn(
-      `PostgreSQL not available, falling back to in-memory database: ${errorMessage}`
-    );
-    return new MemoryDatabaseStore();
+    const err = error;
+    if (err.code === "ERR_MODULE_NOT_FOUND") {
+      throw StorageError.dependencyNotInstalled("PostgreSQL", "pg", "npm install pg");
+    }
+    throw error;
   }
 }
 async function createSQLiteStore(config, logger) {
-  try {
-    if (!SQLiteStore) {
-      const module = await import("./sqlite-store.js");
-      SQLiteStore = module.SQLiteStore;
-    }
-    logger.info(`Creating SQLite database store: ${config.path}`);
-    return new SQLiteStore(config, logger);
-  } catch (error) {
-    const err = error instanceof Error ? error : new Error(String(error));
-    logger.error(`SQLite store failed to load: ${err.message}`, { error: err.message });
-    logger.warn("Falling back to in-memory database store");
-    return new MemoryDatabaseStore();
+  if (!SQLiteStore) {
+    const module = await import("./sqlite-store.js");
+    SQLiteStore = module.SQLiteStore;
   }
+  logger.info(`Creating SQLite database store: ${config.path}`);
+  return new SQLiteStore(config, logger);
 }
 export {
   createDatabase

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

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { StorageError } from "../errors.js";
 class MemoryDatabaseStore {
   data = /* @__PURE__ */ new Map();

package/dist/storage/database/postgres-store.cjs

@@ -88,6 +88,12 @@ class PostgresStore {
         "INSERT INTO kv (key, value, updated_at) VALUES ($1, $2, $3) ON CONFLICT (key) DO UPDATE SET value = $2, updated_at = $3",
         [key, value, /* @__PURE__ */ new Date()]
       );
+    } catch (error) {
+      throw import_errors.StorageError.writeFailed(
+        "set",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
     } finally {
       client.release();
     }
@@ -137,6 +143,12 @@ class PostgresStore {
         item,
         /* @__PURE__ */ new Date()
       ]);
+    } catch (error) {
+      throw import_errors.StorageError.writeFailed(
+        "append",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
     } finally {
       client.release();
     }

package/dist/storage/database/postgres-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-store.d.ts","sourceRoot":"","sources":["../../../src/storage/database/postgres-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;;GAIG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAMtC,OAAO,CAAC,MAAM;IALlB,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAe;gBAGjB,MAAM,EAAE,sBAAsB,EACtC,MAAM,EAAE,YAAY;IAKlB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,MAAM;IAKhB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAiB3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBvC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9C,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;YAe5D,YAAY;IA4B1B,OAAO,CAAC,eAAe;IAOjB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBxE,QAAQ,IAAI,OAAO,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;IAsBI,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAShC"}
+{"version":3,"file":"postgres-store.d.ts","sourceRoot":"","sources":["../../../src/storage/database/postgres-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;;GAIG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAMtC,OAAO,CAAC,MAAM;IALlB,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAe;gBAGjB,MAAM,EAAE,sBAAsB,EACtC,MAAM,EAAE,YAAY;IAKlB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,MAAM;IAKhB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAiB3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBvC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9C,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;YAe5D,YAAY;IA4B1B,OAAO,CAAC,eAAe;IAOjB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBxE,QAAQ,IAAI,OAAO,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;IAsBI,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAShC"}

package/dist/storage/database/postgres-store.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { Pool } from "pg";
 import { DextoLogComponent } from "../../logger/v2/types.js";
 import { StorageError } from "../errors.js";
@@ -66,6 +66,12 @@ class PostgresStore {
         "INSERT INTO kv (key, value, updated_at) VALUES ($1, $2, $3) ON CONFLICT (key) DO UPDATE SET value = $2, updated_at = $3",
         [key, value, /* @__PURE__ */ new Date()]
       );
+    } catch (error) {
+      throw StorageError.writeFailed(
+        "set",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
     } finally {
       client.release();
     }
@@ -115,6 +121,12 @@ class PostgresStore {
         item,
         /* @__PURE__ */ new Date()
       ]);
+    } catch (error) {
+      throw StorageError.writeFailed(
+        "append",
+        error instanceof Error ? error.message : String(error),
+        { key }
+      );
     } finally {
       client.release();
     }

package/dist/storage/database/schemas.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { z } from "zod";
 import { EnvExpandedString } from "../../utils/result.js";
 import { StorageErrorCode } from "../error-codes.js";

package/dist/storage/database/sqlite-store.cjs

@@ -91,6 +91,14 @@ class SQLiteStore {
         const module2 = await import("better-sqlite3");
         BetterSqlite3Database = module2.default || module2;
       } catch (error) {
+        const err = error;
+        if (err.code === "ERR_MODULE_NOT_FOUND") {
+          throw import_errors.StorageError.dependencyNotInstalled(
+            "SQLite",
+            "better-sqlite3",
+            "npm install better-sqlite3"
+          );
+        }
         throw import_errors.StorageError.connectionFailed(
           `Failed to import better-sqlite3: ${error instanceof Error ? error.message : String(error)}`
         );

package/dist/storage/database/sqlite-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../../src/storage/database/sqlite-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAMzD;;;GAGG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY;IAO9D,OAAO,CAAC,gBAAgB;IA8ClB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkExB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,MAAM;IAKhB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAgB3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BvC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9C,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAqB1E,OAAO,CAAC,eAAe;IAOjB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,QAAQ,IAAI,OAAO,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;CAqBL"}
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../../src/storage/database/sqlite-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAMzD;;;GAGG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY;IAO9D,OAAO,CAAC,gBAAgB;IA8ClB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0ExB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,MAAM;IAKhB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAgB3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BvC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9C,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAqB1E,OAAO,CAAC,eAAe;IAOjB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,QAAQ,IAAI,OAAO,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;CAqBL"}

package/dist/storage/database/sqlite-store.js

@@ -1,4 +1,4 @@
-import "../../chunk-C6A6W6XS.js";
+import "../../chunk-PTJYTZNU.js";
 import { dirname } from "path";
 import { mkdirSync } from "fs";
 import { DextoLogComponent } from "../../logger/v2/types.js";
@@ -59,6 +59,14 @@ class SQLiteStore {
         const module = await import("better-sqlite3");
         BetterSqlite3Database = module.default || module;
       } catch (error) {
+        const err = error;
+        if (err.code === "ERR_MODULE_NOT_FOUND") {
+          throw StorageError.dependencyNotInstalled(
+            "SQLite",
+            "better-sqlite3",
+            "npm install better-sqlite3"
+          );
+        }
         throw StorageError.connectionFailed(
           `Failed to import better-sqlite3: ${error instanceof Error ? error.message : String(error)}`
         );

package/dist/storage/error-codes.cjs

@@ -24,6 +24,7 @@ module.exports = __toCommonJS(error_codes_exports);
 var StorageErrorCode = /* @__PURE__ */ ((StorageErrorCode2) => {
   StorageErrorCode2["MANAGER_NOT_INITIALIZED"] = "storage_manager_not_initialized";
   StorageErrorCode2["MANAGER_NOT_CONNECTED"] = "storage_manager_not_connected";
+  StorageErrorCode2["DEPENDENCY_NOT_INSTALLED"] = "storage_dependency_not_installed";
   StorageErrorCode2["CONNECTION_FAILED"] = "storage_connection_failed";
   StorageErrorCode2["CONNECTION_CONFIG_MISSING"] = "storage_connection_config_missing";
   StorageErrorCode2["READ_FAILED"] = "storage_read_failed";

package/dist/storage/error-codes.d.ts

@@ -5,6 +5,7 @@
 export declare enum StorageErrorCode {
     MANAGER_NOT_INITIALIZED = "storage_manager_not_initialized",
     MANAGER_NOT_CONNECTED = "storage_manager_not_connected",
+    DEPENDENCY_NOT_INSTALLED = "storage_dependency_not_installed",
     CONNECTION_FAILED = "storage_connection_failed",
     CONNECTION_CONFIG_MISSING = "storage_connection_config_missing",
     READ_FAILED = "storage_read_failed",

package/dist/storage/error-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/storage/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,gBAAgB;IAExB,uBAAuB,oCAAoC;IAC3D,qBAAqB,kCAAkC;IAGvD,iBAAiB,8BAA8B;IAC/C,yBAAyB,sCAAsC;IAG/D,WAAW,wBAAwB;IACnC,YAAY,yBAAyB;IACrC,aAAa,0BAA0B;IAGvC,gBAAgB,6BAA6B;IAC7C,uBAAuB,oCAAoC;IAG3D,mBAAmB,wBAAwB;IAG3C,kBAAkB,uBAAuB;IACzC,wBAAwB,6BAA6B;IACrD,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAG3C,cAAc,mBAAmB;IACjC,sBAAsB,2BAA2B;IACjD,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IAGjC,0BAA0B,+BAA+B;IACzD,wBAAwB,6BAA6B;IAGrD,mBAAmB,wBAAwB;IAC3C,qBAAqB,0BAA0B;CAClD"}
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/storage/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,gBAAgB;IAExB,uBAAuB,oCAAoC;IAC3D,qBAAqB,kCAAkC;IAGvD,wBAAwB,qCAAqC;IAG7D,iBAAiB,8BAA8B;IAC/C,yBAAyB,sCAAsC;IAG/D,WAAW,wBAAwB;IACnC,YAAY,yBAAyB;IACrC,aAAa,0BAA0B;IAGvC,gBAAgB,6BAA6B;IAC7C,uBAAuB,oCAAoC;IAG3D,mBAAmB,wBAAwB;IAG3C,kBAAkB,uBAAuB;IACzC,wBAAwB,6BAA6B;IACrD,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAG3C,cAAc,mBAAmB;IACjC,sBAAsB,2BAA2B;IACjD,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IAGjC,0BAA0B,+BAA+B;IACzD,wBAAwB,6BAA6B;IAGrD,mBAAmB,wBAAwB;IAC3C,qBAAqB,0BAA0B;CAClD"}

package/dist/storage/error-codes.js

@@ -1,7 +1,8 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 var StorageErrorCode = /* @__PURE__ */ ((StorageErrorCode2) => {
   StorageErrorCode2["MANAGER_NOT_INITIALIZED"] = "storage_manager_not_initialized";
   StorageErrorCode2["MANAGER_NOT_CONNECTED"] = "storage_manager_not_connected";
+  StorageErrorCode2["DEPENDENCY_NOT_INSTALLED"] = "storage_dependency_not_installed";
   StorageErrorCode2["CONNECTION_FAILED"] = "storage_connection_failed";
   StorageErrorCode2["CONNECTION_CONFIG_MISSING"] = "storage_connection_config_missing";
   StorageErrorCode2["READ_FAILED"] = "storage_read_failed";

package/dist/storage/errors.cjs

@@ -73,6 +73,23 @@ class StorageError {
       { method, hint: "Call await manager.connect() after initialize()" }
     );
   }
+  /**
+   * Required storage dependency not installed
+   */
+  static dependencyNotInstalled(backendType, packageName, installCommand) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.StorageErrorCode.DEPENDENCY_NOT_INSTALLED,
+      import_types.ErrorScope.STORAGE,
+      import_types.ErrorType.USER,
+      `${backendType} storage configured but '${packageName}' package is not installed`,
+      {
+        backendType,
+        packageName,
+        hint: `Install with: ${installCommand}`,
+        recovery: `Either install the package or change storage type to 'in-memory'`
+      }
+    );
+  }
   /**
    * Read operation failed
    */

package/dist/storage/errors.d.ts

@@ -32,6 +32,15 @@ export declare class StorageError {
         method: string;
         hint: string;
     }>;
+    /**
+     * Required storage dependency not installed
+     */
+    static dependencyNotInstalled(backendType: string, packageName: string, installCommand: string): DextoRuntimeError<{
+        backendType: string;
+        packageName: string;
+        hint: string;
+        recovery: string;
+    }>;
     /**
      * Read operation failed
      */

package/dist/storage/errors.d.ts.map

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

package/dist/storage/errors.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { DextoRuntimeError, DextoValidationError } from "../errors/index.js";
 import { ErrorScope, ErrorType } from "../errors/types.js";
 import { StorageErrorCode } from "./error-codes.js";
@@ -51,6 +51,23 @@ class StorageError {
       { method, hint: "Call await manager.connect() after initialize()" }
     );
   }
+  /**
+   * Required storage dependency not installed
+   */
+  static dependencyNotInstalled(backendType, packageName, installCommand) {
+    return new DextoRuntimeError(
+      StorageErrorCode.DEPENDENCY_NOT_INSTALLED,
+      ErrorScope.STORAGE,
+      ErrorType.USER,
+      `${backendType} storage configured but '${packageName}' package is not installed`,
+      {
+        backendType,
+        packageName,
+        hint: `Install with: ${installCommand}`,
+        recovery: `Either install the package or change storage type to 'in-memory'`
+      }
+    );
+  }
   /**
    * Read operation failed
    */

package/dist/storage/index.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { StorageManager, createStorageManager } from "./storage-manager.js";
 import { MemoryCacheStore } from "./cache/memory-cache-store.js";
 import { MemoryDatabaseStore } from "./database/memory-database-store.js";

package/dist/storage/schemas.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { z } from "zod";
 import {
   CACHE_TYPES,

package/dist/storage/storage-manager.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { createCache } from "./cache/factory.js";
 import { createDatabase } from "./database/factory.js";
 import { createBlobStore } from "./blob/factory.js";

package/dist/systemPrompt/contributors.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { readFile, stat } from "fs/promises";
 import { resolve, extname } from "path";
 import { SystemPromptError } from "./errors.js";

package/dist/systemPrompt/error-codes.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 var SystemPromptErrorCode = /* @__PURE__ */ ((SystemPromptErrorCode2) => {
   SystemPromptErrorCode2["FILE_INVALID_TYPE"] = "systemprompt_file_invalid_type";
   SystemPromptErrorCode2["FILE_TOO_LARGE"] = "systemprompt_file_too_large";

package/dist/systemPrompt/errors.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { DextoRuntimeError } from "../errors/DextoRuntimeError.js";
 import { ErrorScope, ErrorType } from "../errors/types.js";
 import { SystemPromptErrorCode } from "./error-codes.js";

package/dist/systemPrompt/in-built-prompts.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 async function getCurrentDateTime(_context) {
   return `<dateTime>Current date and time: ${(/* @__PURE__ */ new Date()).toISOString()}</dateTime>`;
 }

package/dist/systemPrompt/index.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 export * from "./types.js";
 export * from "./manager.js";
 export * from "./registry.js";

package/dist/systemPrompt/manager.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import { StaticContributor, FileContributor, MemoryContributor } from "./contributors.js";
 import { getPromptGenerator } from "./registry.js";
 import { DynamicContributor } from "./contributors.js";

package/dist/systemPrompt/registry.js

@@ -1,4 +1,4 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 import * as handlers from "./in-built-prompts.js";
 const PROMPT_GENERATOR_SOURCES = ["dateTime", "resources"];
 const PROMPT_GENERATOR_REGISTRY = {