@dexto/core 1.5.7 → 1.6.0

package/dist/session/chat-session.js

@@ -1,15 +1,14 @@
 import "../chunk-PTJYTZNU.js";
 import { createDatabaseHistoryProvider } from "./history/factory.js";
-import { createLLMService, createVercelModel } from "../llm/services/factory.js";
-import { createCompactionStrategy } from "../context/compaction/index.js";
+import { createLLMService } from "../llm/services/factory.js";
 import {
   SessionEventBus,
   SessionEventNames
 } from "../events/index.js";
 import { DextoLogComponent } from "../logger/v2/types.js";
 import { DextoRuntimeError, ErrorScope, ErrorType } from "../errors/index.js";
-import { PluginErrorCode } from "../plugins/error-codes.js";
-import { getModelPricing, calculateCost } from "../llm/registry.js";
+import { HookErrorCode } from "../hooks/error-codes.js";
+import { getModelPricing, calculateCost } from "../llm/registry/index.js";
 class ChatSession {
   /**
    * Creates a new ChatSession instance.
@@ -106,13 +105,17 @@ class ChatSession {
   setupTokenAccumulation() {
     this.tokenAccumulatorListener = (payload) => {
       if (payload.tokenUsage) {
-        let cost;
         const llmConfig = this.services.stateManager.getLLMConfig(this.id);
-        const pricing = getModelPricing(llmConfig.provider, llmConfig.model);
+        const modelInfo = {
+          provider: payload.provider ?? llmConfig.provider,
+          model: payload.model ?? llmConfig.model
+        };
+        let cost;
+        const pricing = getModelPricing(modelInfo.provider, modelInfo.model);
         if (pricing) {
           cost = calculateCost(payload.tokenUsage, pricing);
         }
-        this.services.sessionManager.accumulateTokenUsage(this.id, payload.tokenUsage, cost).catch((err) => {
+        this.services.sessionManager.accumulateTokenUsage(this.id, payload.tokenUsage, cost, modelInfo).catch((err) => {
           this.logger.warn(
             `Failed to accumulate token usage: ${err instanceof Error ? err.message : String(err)}`
           );
@@ -132,11 +135,7 @@ class ChatSession {
       this.id,
       this.logger
     );
-    const model = createVercelModel(llmConfig);
-    const compactionStrategy = await createCompactionStrategy(runtimeConfig.compaction, {
-      logger: this.logger,
-      model
-    });
+    const compactionStrategy = this.services.compactionStrategy;
     this.llmService = createLLMService(
       llmConfig,
       this.services.toolManager,
@@ -150,10 +149,8 @@ class ChatSession {
       // Pass ResourceManager for blob storage
       this.logger,
       // Pass logger for dependency injection
-      compactionStrategy,
+      compactionStrategy
       // Pass compaction strategy
-      runtimeConfig.compaction
-      // Pass compaction config for threshold settings
     );
     this.logger.debug(`ChatSession ${this.id}: Services initialized with storage`);
   }
@@ -241,7 +238,7 @@ class ChatSession {
         },
         sessionId: this.id
       };
-      const modifiedBeforePayload = await this.services.pluginManager.executePlugins(
+      const modifiedBeforePayload = await this.services.hookManager.executeHooks(
         "beforeLLMRequest",
         beforeLLMPayload,
         {
@@ -266,7 +263,7 @@ class ChatSession {
         model: llmConfig.model,
         sessionId: this.id
       };
-      const modifiedResponsePayload = await this.services.pluginManager.executePlugins(
+      const modifiedResponsePayload = await this.services.hookManager.executeHooks(
         "beforeResponse",
         beforeResponsePayload,
         {
@@ -310,7 +307,7 @@ class ChatSession {
         }
         return { text: "" };
       }
-      if (error instanceof DextoRuntimeError && error.code === PluginErrorCode.PLUGIN_BLOCKED_EXECUTION && error.scope === ErrorScope.PLUGIN && error.type === ErrorType.FORBIDDEN) {
+      if (error instanceof DextoRuntimeError && error.code === HookErrorCode.HOOK_BLOCKED_EXECUTION && error.scope === ErrorScope.HOOK && error.type === ErrorType.FORBIDDEN) {
         const textContent = parts.filter((p) => p.type === "text").map((p) => p.text).join("\n");
         try {
           await this.saveBlockedInteraction(textContent, error.message);
@@ -433,12 +430,7 @@ class ChatSession {
    */
   async switchLLM(newLLMConfig) {
     try {
-      const runtimeConfig = this.services.stateManager.getRuntimeConfig(this.id);
-      const model = createVercelModel(newLLMConfig);
-      const compactionStrategy = await createCompactionStrategy(runtimeConfig.compaction, {
-        logger: this.logger,
-        model
-      });
+      const compactionStrategy = this.services.compactionStrategy;
       const newLLMService = createLLMService(
         newLLMConfig,
         this.services.toolManager,
@@ -450,10 +442,8 @@ class ChatSession {
         this.id,
         this.services.resourceManager,
         this.logger,
-        compactionStrategy,
+        compactionStrategy
         // Pass compaction strategy
-        runtimeConfig.compaction
-        // Pass compaction config for threshold settings
       );
       this.llmService = newLLMService;
       this.logger.info(

package/dist/session/errors.cjs

@@ -21,8 +21,8 @@ __export(errors_exports, {
   SessionError: () => SessionError
 });
 module.exports = __toCommonJS(errors_exports);
-var import_DextoRuntimeError = require("../errors/DextoRuntimeError.cjs");
-var import_types = require("../errors/types.cjs");
+var import_DextoRuntimeError = require("../errors/DextoRuntimeError.js");
+var import_types = require("../errors/types.js");
 var import_error_codes = require("./error-codes.js");
 class SessionError {
   /**

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/session/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAItE;;;GAGG;AACH,qBAAa,YAAY;IACrB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM;;;IAUjC;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;IAU7D;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;;;;IAWpE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;IAUzE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;CASvD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/session/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAInE;;;GAGG;AACH,qBAAa,YAAY;IACrB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM;;;IAUjC;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;IAU7D;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;;;;IAWpE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;IAUzE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;CASvD"}

package/dist/session/history/database.cjs

@@ -21,7 +21,7 @@ __export(database_exports, {
   DatabaseHistoryProvider: () => DatabaseHistoryProvider
 });
 module.exports = __toCommonJS(database_exports);
-var import_types = require("../../logger/v2/types.cjs");
+var import_types = require("../../logger/v2/types.js");
 var import_errors = require("../errors.js");
 class DatabaseHistoryProvider {
   // Debounce window for batching updates

package/dist/session/history/database.d.ts

@@ -1,7 +1,7 @@
-import type { IDextoLogger } from '../../logger/v2/types.js';
+import type { Logger } from '../../logger/v2/types.js';
 import type { Database } from '../../storage/types.js';
 import type { InternalMessage } from '../../context/types.js';
-import type { IConversationHistoryProvider } from './types.js';
+import type { ConversationHistoryProvider } from './types.js';
 /**
  * History provider that works directly with DatabaseBackend.
  * Uses write-through caching for read performance while maintaining durability.
@@ -18,7 +18,7 @@ import type { IConversationHistoryProvider } from './types.js';
  * - Updates (updateMessage) are durable within flush interval or on explicit flush()
  * - Worst case on crash: lose updates from last flush interval (typically <100ms)
  */
-export declare class DatabaseHistoryProvider implements IConversationHistoryProvider {
+export declare class DatabaseHistoryProvider implements ConversationHistoryProvider {
     private sessionId;
     private database;
     private logger;
@@ -27,7 +27,7 @@ export declare class DatabaseHistoryProvider implements IConversationHistoryProv
     private flushTimer;
     private flushPromise;
     private static readonly FLUSH_DELAY_MS;
-    constructor(sessionId: string, database: Database, logger: IDextoLogger);
+    constructor(sessionId: string, database: Database, logger: Logger);
     getHistory(): Promise<InternalMessage[]>;
     saveMessage(message: InternalMessage): Promise<void>;
     updateMessage(message: InternalMessage): Promise<void>;

package/dist/session/history/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/session/history/database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,uBAAwB,YAAW,4BAA4B;IAapE,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,QAAQ;IAbpB,OAAO,CAAC,MAAM,CAAe;IAG7B,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,YAAY,CAA8B;IAGlD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAO;gBAGjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAC1B,MAAM,EAAE,YAAY;IAKlB,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IA2DxC,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCpD,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCtD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BnC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B;;;OAGG;YACW,OAAO;IA+CrB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,cAAc;CAGzB"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/session/history/database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,uBAAwB,YAAW,2BAA2B;IAanE,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,QAAQ;IAbpB,OAAO,CAAC,MAAM,CAAS;IAGvB,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,YAAY,CAA8B;IAGlD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAO;gBAGjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAC1B,MAAM,EAAE,MAAM;IAKZ,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IA2DxC,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCpD,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCtD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BnC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B;;;OAGG;YACW,OAAO;IA+CrB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,cAAc;CAGzB"}

package/dist/session/history/factory.d.ts

@@ -1,11 +1,11 @@
-import type { IConversationHistoryProvider } from './types.js';
+import type { ConversationHistoryProvider } from './types.js';
 import type { Database } from '../../storage/types.js';
-import type { IDextoLogger } from '../../logger/v2/types.js';
+import type { Logger } from '../../logger/v2/types.js';
 /**
  * Create a history provider directly with database backend
  * @param database Database instance
  * @param sessionId Session ID
  * @param logger Logger instance for logging
  */
-export declare function createDatabaseHistoryProvider(database: Database, sessionId: string, logger: IDextoLogger): IConversationHistoryProvider;
+export declare function createDatabaseHistoryProvider(database: Database, sessionId: string, logger: Logger): ConversationHistoryProvider;
 //# sourceMappingURL=factory.d.ts.map

package/dist/session/history/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/session/history/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D;;;;;GAKG;AACH,wBAAgB,6BAA6B,CACzC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,GACrB,4BAA4B,CAE9B"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/session/history/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAGvD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CACzC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACf,2BAA2B,CAE7B"}

package/dist/session/history/memory.d.ts

@@ -1,15 +1,15 @@
 import type { InternalMessage } from '../../context/types.js';
-import type { IConversationHistoryProvider } from './types.js';
-import type { IDextoLogger } from '../../logger/v2/types.js';
+import type { ConversationHistoryProvider } from './types.js';
+import type { Logger } from '../../logger/v2/types.js';
 /**
  * Lightweight in-memory history provider for ephemeral, isolated LLM calls.
  * Used to run background tasks (e.g., title generation) without touching
  * the real session history or emitting history-related side effects.
  */
-export declare class MemoryHistoryProvider implements IConversationHistoryProvider {
+export declare class MemoryHistoryProvider implements ConversationHistoryProvider {
     private logger;
     private messages;
-    constructor(logger: IDextoLogger);
+    constructor(logger: Logger);
     getHistory(): Promise<InternalMessage[]>;
     saveMessage(message: InternalMessage): Promise<void>;
     updateMessage(message: InternalMessage): Promise<void>;

package/dist/session/history/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/session/history/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,4BAA4B;IAG1D,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAyB;gBAErB,MAAM,EAAE,YAAY;IAElC,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAKxC,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/session/history/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,2BAA2B;IAGzD,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAyB;gBAErB,MAAM,EAAE,MAAM;IAE5B,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAKxC,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

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

@@ -7,7 +7,7 @@ import type { InternalMessage } from '../../context/types.js';
  * the flush() method should be called at turn boundaries to ensure all updates
  * are persisted to durable storage.
  */
-export interface IConversationHistoryProvider {
+export type ConversationHistoryProvider = {
     /** Load the full message history for this session */
     getHistory(): Promise<InternalMessage[]>;
     /** Append a message to this session's history (must be durable immediately) */
@@ -22,5 +22,5 @@ export interface IConversationHistoryProvider {
      * Implementations without caching can make this a no-op.
      */
     flush(): Promise<void>;
-}
+};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/session/history/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IACzC,qDAAqD;IACrD,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEzC,+EAA+E;IAC/E,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD,mFAAmF;IACnF,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,0CAA0C;IAC1C,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/session/history/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACtC,qDAAqD;IACrD,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEzC,+EAA+E;IAC/E,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD,mFAAmF;IACnF,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,0CAA0C;IAC1C,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC"}

package/dist/session/index.cjs

@@ -20,6 +20,7 @@ var session_exports = {};
 __export(session_exports, {
   ChatSession: () => import_chat_session.ChatSession,
   MessageQueueService: () => import_message_queue.MessageQueueService,
+  SessionConfigSchema: () => import_schemas.SessionConfigSchema,
   SessionError: () => import_errors.SessionError,
   SessionErrorCode: () => import_error_codes.SessionErrorCode,
   SessionManager: () => import_session_manager.SessionManager
@@ -30,10 +31,12 @@ var import_session_manager = require("./session-manager.js");
 var import_error_codes = require("./error-codes.js");
 var import_errors = require("./errors.js");
 var import_message_queue = require("./message-queue.js");
+var import_schemas = require("./schemas.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ChatSession,
   MessageQueueService,
+  SessionConfigSchema,
   SessionError,
   SessionErrorCode,
   SessionManager

package/dist/session/index.d.ts

@@ -6,4 +6,6 @@ export { SessionError } from './errors.js';
 export { MessageQueueService } from './message-queue.js';
 export type { UserMessageInput } from './message-queue.js';
 export type { QueuedMessage, CoalescedMessage } from './types.js';
+export { SessionConfigSchema } from './schemas.js';
+export type { SessionConfig, ValidatedSessionConfig } from './schemas.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/session/index.js

@@ -4,9 +4,11 @@ import { SessionManager } from "./session-manager.js";
 import { SessionErrorCode } from "./error-codes.js";
 import { SessionError } from "./errors.js";
 import { MessageQueueService } from "./message-queue.js";
+import { SessionConfigSchema } from "./schemas.js";
 export {
   ChatSession,
   MessageQueueService,
+  SessionConfigSchema,
   SessionError,
   SessionErrorCode,
   SessionManager

package/dist/session/message-queue.cjs

@@ -42,7 +42,8 @@ class MessageQueueService {
       id: generateId(),
       content: message.content,
       queuedAt: Date.now(),
-      ...message.metadata !== void 0 && { metadata: message.metadata }
+      ...message.metadata !== void 0 && { metadata: message.metadata },
+      ...message.kind !== void 0 && { kind: message.kind }
     };
     this.queue.push(queuedMsg);
     this.logger.debug(`Message queued: ${queuedMsg.id}, position: ${this.queue.length}`);
@@ -87,13 +88,14 @@ class MessageQueueService {
       count: messages.length,
       ids: messages.map((m) => m.id),
       coalesced: messages.length > 1,
-      content: combined.combinedContent
+      content: combined.combinedContent,
+      messages
     });
     return combined;
   }
   /**
    * Coalesce multiple messages into one (multimodal-aware).
-   * Strategy: Combine with numbered separators, preserve all media.
+   * Strategy: Combine with per-kind formatting, preserve all media.
    */
   coalesce(messages) {
     if (messages.length === 1) {
@@ -108,10 +110,32 @@ class MessageQueueService {
         lastQueuedAt: firstMsg.queuedAt
       };
     }
+    const getMessageKind = (message) => message.kind ?? "default";
+    const totalUserMessages = messages.filter(
+      (message) => getMessageKind(message) !== "background"
+    ).length;
+    const hasBackgroundMessages = messages.some(
+      (message) => getMessageKind(message) === "background"
+    );
+    const getUserPrefix = (index, total, mixed) => {
+      if (mixed) {
+        return `User follow-up ${index + 1}`;
+      }
+      if (total <= 1) return null;
+      if (total === 2) {
+        return index === 0 ? "First" : "Also";
+      }
+      return `[${index + 1}]`;
+    };
     const combinedContent = [];
+    let userIndex = 0;
     for (const [i, msg] of messages.entries()) {
-      const prefix = messages.length === 2 ? i === 0 ? "First" : "Also" : `[${i + 1}]`;
-      let prefixText = `${prefix}: `;
+      const kind = getMessageKind(msg);
+      const prefix = kind === "background" ? null : getUserPrefix(userIndex, totalUserMessages, hasBackgroundMessages);
+      if (kind !== "background") {
+        userIndex += 1;
+      }
+      let prefixText = prefix ? `${prefix}: ` : "";
       for (const part of msg.content) {
         if (part.type === "text") {
           if (prefixText) {

package/dist/session/message-queue.d.ts

@@ -1,7 +1,7 @@
 import type { SessionEventBus } from '../events/index.js';
 import type { QueuedMessage, CoalescedMessage } from './types.js';
 import type { ContentPart } from '../context/types.js';
-import type { IDextoLogger } from '../logger/v2/types.js';
+import type { Logger } from '../logger/v2/types.js';
 /**
  * Input for enqueuing a user message to the queue.
  * (Not to be confused with UserMessage from context/types.ts which represents
@@ -12,6 +12,8 @@ export interface UserMessageInput {
     content: ContentPart[];
     /** Optional metadata to attach to the message */
     metadata?: Record<string, unknown>;
+    /** Optional kind of queued message */
+    kind?: 'default' | 'background';
 }
 /**
  * MessageQueueService handles queuing of user messages during agent execution.
@@ -45,7 +47,7 @@ export declare class MessageQueueService {
     private eventBus;
     private logger;
     private queue;
-    constructor(eventBus: SessionEventBus, logger: IDextoLogger);
+    constructor(eventBus: SessionEventBus, logger: Logger);
     /**
      * Add a message to the queue.
      * Called by API endpoint - returns immediately with queue position.
@@ -80,7 +82,7 @@ export declare class MessageQueueService {
     dequeueAll(): CoalescedMessage | null;
     /**
      * Coalesce multiple messages into one (multimodal-aware).
-     * Strategy: Combine with numbered separators, preserve all media.
+     * Strategy: Combine with per-kind formatting, preserve all media.
      */
     private coalesce;
     /**

package/dist/session/message-queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-queue.d.ts","sourceRoot":"","sources":["../../src/session/message-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAS1D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,2DAA2D;IAC3D,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,mBAAmB;IAIxB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,MAAM;IAJlB,OAAO,CAAC,KAAK,CAAuB;gBAGxB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,YAAY;IAGhC;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;IAwBlF;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,IAAI,gBAAgB,GAAG,IAAI;IAsBrC;;;OAGG;IACH,OAAO,CAAC,QAAQ;IA0EhB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,MAAM,IAAI,aAAa,EAAE;IAIzB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAY9B"}
+{"version":3,"file":"message-queue.d.ts","sourceRoot":"","sources":["../../src/session/message-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AASpD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,2DAA2D;IAC3D,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,sCAAsC;IACtC,IAAI,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,mBAAmB;IAIxB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,MAAM;IAJlB,OAAO,CAAC,KAAK,CAAuB;gBAGxB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM;IAG1B;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;IAyBlF;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,IAAI,gBAAgB,GAAG,IAAI;IAuBrC;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAuGhB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,MAAM,IAAI,aAAa,EAAE;IAIzB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAY9B"}

package/dist/session/message-queue.js

@@ -20,7 +20,8 @@ class MessageQueueService {
       id: generateId(),
       content: message.content,
       queuedAt: Date.now(),
-      ...message.metadata !== void 0 && { metadata: message.metadata }
+      ...message.metadata !== void 0 && { metadata: message.metadata },
+      ...message.kind !== void 0 && { kind: message.kind }
     };
     this.queue.push(queuedMsg);
     this.logger.debug(`Message queued: ${queuedMsg.id}, position: ${this.queue.length}`);
@@ -65,13 +66,14 @@ class MessageQueueService {
       count: messages.length,
       ids: messages.map((m) => m.id),
       coalesced: messages.length > 1,
-      content: combined.combinedContent
+      content: combined.combinedContent,
+      messages
     });
     return combined;
   }
   /**
    * Coalesce multiple messages into one (multimodal-aware).
-   * Strategy: Combine with numbered separators, preserve all media.
+   * Strategy: Combine with per-kind formatting, preserve all media.
    */
   coalesce(messages) {
     if (messages.length === 1) {
@@ -86,10 +88,32 @@ class MessageQueueService {
         lastQueuedAt: firstMsg.queuedAt
       };
     }
+    const getMessageKind = (message) => message.kind ?? "default";
+    const totalUserMessages = messages.filter(
+      (message) => getMessageKind(message) !== "background"
+    ).length;
+    const hasBackgroundMessages = messages.some(
+      (message) => getMessageKind(message) === "background"
+    );
+    const getUserPrefix = (index, total, mixed) => {
+      if (mixed) {
+        return `User follow-up ${index + 1}`;
+      }
+      if (total <= 1) return null;
+      if (total === 2) {
+        return index === 0 ? "First" : "Also";
+      }
+      return `[${index + 1}]`;
+    };
     const combinedContent = [];
+    let userIndex = 0;
     for (const [i, msg] of messages.entries()) {
-      const prefix = messages.length === 2 ? i === 0 ? "First" : "Also" : `[${i + 1}]`;
-      let prefixText = `${prefix}: `;
+      const kind = getMessageKind(msg);
+      const prefix = kind === "background" ? null : getUserPrefix(userIndex, totalUserMessages, hasBackgroundMessages);
+      if (kind !== "background") {
+        userIndex += 1;
+      }
+      let prefixText = prefix ? `${prefix}: ` : "";
       for (const part of msg.content) {
         if (part.type === "text") {
           if (prefixText) {