tracelattice 1.3.2 → 1.3.3

package/dist/core/reasoning.d.ts

@@ -21,6 +21,12 @@ import type { CalibrationMetrics } from '../contracts/calibrator.js';
  * ```
  */
 export type ThoughtType = 'regular' | 'hypothesis' | 'verification' | 'critique' | 'synthesis' | 'meta' | 'tool_call' | 'tool_observation' | 'assumption' | 'decomposition' | 'backtrack';
+/**
+ * Machine-readable names for the 6 detected reasoning patterns.
+ *
+ * Each name corresponds to a private detector method in PatternDetector.
+ */
+export type PatternName = 'consecutive_without_verification' | 'unverified_hypothesis' | 'monotonic_type' | 'no_alternatives_explored' | 'confidence_drift' | 'healthy_verification';
 /**
  * A detected reasoning pattern — surfaced as metadata or a warning.
  *
@@ -36,7 +42,8 @@ export type ThoughtType = 'regular' | 'hypothesis' | 'verification' | 'critique'
  */
 export interface PatternSignal {
     /** Machine-readable pattern identifier. */
-    pattern: string;
+    /** Machine-readable pattern identifier. */
+    pattern: PatternName;
     /** Severity: 'warning' surfaces as a hint, 'info' is metadata only. */
     severity: 'info' | 'warning';
     /** Human-readable description of the detected pattern. */

package/dist/core/reasoning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reasoning.d.ts","sourceRoot":"","sources":["../../src/core/reasoning.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GACpB,SAAS,GACT,YAAY,GACZ,cAAc,GACd,UAAU,GACV,WAAW,GACX,MAAM,GACN,WAAW,GACX,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,WAAW,CAAC;AAEf;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC7B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAEhB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAEhB,wEAAwE;IACxE,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,iBAAiB;IACjC,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IAExB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IAEvB,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;IAErB,0CAA0C;IAC1C,yBAAyB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAEvD,8CAA8C;IAC9C,cAAc,EAAE,OAAO,CAAC;IAExB,uCAAuC;IACvC,gBAAgB,EAAE,OAAO,CAAC;IAE1B,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,kBAAkB,CAAC,EAAE;QACpB,8EAA8E;QAC9E,cAAc,EAAE,MAAM,CAAC;QACvB,0EAA0E;QAC1E,qBAAqB,EAAE,MAAM,CAAC;QAC9B,sGAAsG;QACtG,gBAAgB,EAAE,MAAM,CAAC;QACzB,wHAAwH;QACxH,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;KACpC,CAAC;IAEF;;;;OAIG;IACH,sBAAsB,CAAC,EAAE;QACxB,2DAA2D;QAC3D,cAAc,EAAE,MAAM,CAAC;QACvB,6DAA6D;QAC7D,qBAAqB,EAAE,MAAM,CAAC;QAC9B,+CAA+C;QAC/C,gBAAgB,EAAE,MAAM,CAAC;QACzB,sFAAsF;QACtF,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;KACpC,CAAC;IAEF,6HAA6H;IAC7H,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAExC,gGAAgG;IAChG,QAAQ,CAAC,mBAAmB,CAAC,EAAE,kBAAkB,CAAC;CAClD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,cAAc;IAC9B,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IAEvB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IAEvB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IAExB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,mBAAmB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAEjD,0BAA0B;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IAEzB,0CAA0C;IAC1C,yBAAyB,EAAE,MAAM,CAAC;IAElC,uCAAuC;IACvC,2BAA2B,EAAE,MAAM,CAAC;IAEpC,uEAAuE;IACvE,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,wEAAwE;IACxE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC"}
+{"version":3,"file":"reasoning.d.ts","sourceRoot":"","sources":["../../src/core/reasoning.ts"],"names":[],"mappings":"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"}

package/dist/core/step.d.ts

@@ -29,6 +29,11 @@ import type { ToolRecommendation } from '../types/tool.js';
  *   next_step_conditions: ['If no results found, try broader search terms']
  * };
  * ```
+ *
+ * NOTE: Kept as a hand-written interface (not inferred from `StepRecommendationSchema`)
+ * because it composes `ToolRecommendation` / `SkillRecommendation`, which are themselves
+ * stricter than their schemas (required vs optional fields). An inferred type would
+ * weaken those nested guarantees.
  */
 export interface StepRecommendation {
     /** Human-readable description of what needs to be done in this step. */

package/dist/core/step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/core/step.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,kBAAkB;IAClC,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IAEzB,qEAAqE;IACrE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;IAExC,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAE3C,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IAEzB,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/core/step.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,kBAAkB;IAClC,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IAEzB,qEAAqE;IACrE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;IAExC,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAE3C,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IAEzB,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC"}

package/dist/core/thought.d.ts

@@ -3,6 +3,7 @@
  *
  * @module types/thought
  */
+import type { SessionId, ThoughtId, SuspensionToken } from '../contracts/ids.js';
 import type { ThoughtType } from './reasoning.js';
 import type { StepRecommendation } from './step.js';
 /**
@@ -57,7 +58,7 @@ export interface ThoughtData {
      * const thought: ThoughtData = { ...base, id: '01H0X0X0X0X0X0X0X0X0X0X0X0' };
      * ```
      */
-    id?: string;
+    id?: ThoughtId;
     /** Current thought number in the sequence (1-indexed). */
     thought_number: number;
     /** Estimated total number of thoughts (can be adjusted during processing). */
@@ -186,7 +187,7 @@ export interface ThoughtData {
      * const thought: ThoughtData = { ...base, session_id: 'analysis-task-42' };
      * ```
      */
-    session_id?: string;
+    session_id?: SessionId;
     /**
      * When true, clears all state for the target session before processing this thought.
      * The thought is then processed as the first in a fresh session.
@@ -204,7 +205,7 @@ export interface ThoughtData {
     /** Result returned by the tool (for tool_observation) */
     tool_result?: unknown;
     /** Continuation token linking tool_observation back to suspended tool_call */
-    continuation_token?: string;
+    continuation_token?: SuspensionToken;
     /** Sub-problem labels for decomposition thoughts */
     decomposition_children?: string[];
     /** Thought number being backtracked from */

package/dist/core/thought.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thought.d.ts","sourceRoot":"","sources":["../../src/core/thought.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,WAAW;IAC3B,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;OASG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IAEvB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IAEvB,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,oEAAoE;IACpE,mBAAmB,EAAE,OAAO,CAAC;IAE7B,wDAAwD;IACxD,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAElC,qEAAqE;IACrE,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEtC,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC;IAE3B;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAElD;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAElC,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"thought.d.ts","sourceRoot":"","sources":["../../src/core/thought.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,WAAW;IAC3B,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;OASG;IACH,EAAE,CAAC,EAAE,SAAS,CAAC;IAEf,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IAEvB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IAEvB,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,oEAAoE;IACpE,mBAAmB,EAAE,OAAO,CAAC;IAE7B,wDAAwD;IACxD,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAElC,qEAAqE;IACrE,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEtC,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC;IAE3B;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAElD;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,eAAe,CAAC;IAErC,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAElC,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/core/tools/InMemorySuspensionStore.d.ts

@@ -8,6 +8,7 @@
  * @module core/tools/InMemorySuspensionStore
  */
 import type { ISuspensionStore, SuspensionRecord } from '../../contracts/suspension.js';
+import type { Logger } from '../../logger/StructuredLogger.js';
 /**
  * Configuration for {@link InMemorySuspensionStore}.
  */
@@ -17,7 +18,8 @@ export interface InMemorySuspensionStoreConfig {
     /** Sweep interval for the background expiry timer. Defaults to 60_000ms. */
     sweepIntervalMs?: number;
     /** Optional logger; reserved for future diagnostic output. */
-    logger?: unknown;
+    /** Optional logger for diagnostic output. */
+    logger?: Logger;
 }
 /**
  * In-memory suspension store with TTL expiry and background sweep.

package/dist/core/tools/InMemorySuspensionStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InMemorySuspensionStore.d.ts","sourceRoot":"","sources":["../../../src/core/tools/InMemorySuspensionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGxF;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC7C,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAKD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,MAAM,CAA+C;gBAEjD,MAAM,GAAE,6BAAkC;IAKtD,OAAO,CACN,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACxE,gBAAgB;IA2BnB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAW9C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAI5C,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAWpC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASrC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAKhC,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;IAMZ,OAAO,CAAC,OAAO;CAQf"}
+{"version":3,"file":"InMemorySuspensionStore.d.ts","sourceRoot":"","sources":["../../../src/core/tools/InMemorySuspensionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAExF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC7C,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,MAAM,CAA+C;gBAEjD,MAAM,GAAE,6BAAkC;IAKtD,OAAO,CACN,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACxE,gBAAgB;IA2BnB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAW9C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAI5C,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAWpC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASrC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAKhC,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;IAMZ,OAAO,CAAC,OAAO;CAQf"}

package/dist/core/tools/InMemorySuspensionStore.js

@@ -1,4 +1,4 @@
-import { generateUlid } from "../ids.js";
+import { generateSuspensionToken } from "../../contracts/ids.js";
 const DEFAULT_TTL_MS = 300000;
 const DEFAULT_SWEEP_INTERVAL_MS = 60000;
 class InMemorySuspensionStore {
@@ -12,7 +12,7 @@ class InMemorySuspensionStore {
         this._sweepIntervalMs = config.sweepIntervalMs ?? DEFAULT_SWEEP_INTERVAL_MS;
     }
     suspend(record) {
-        const token = generateUlid();
+        const token = generateSuspensionToken();
         const createdAt = Date.now();
         const ttlMs = record.ttlMs ?? this._ttlMs;
         const expiresAt = createdAt + ttlMs;

package/dist/core/tools/InMemorySuspensionStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"core/tools/InMemorySuspensionStore.js","sources":["../../../src/core/tools/InMemorySuspensionStore.ts"],"sourcesContent":["/**\n * In-memory implementation of {@link ISuspensionStore}.\n *\n * Stores suspension records in process memory with optional background\n * sweeping of expired entries. Suitable for single-process deployments;\n * cluster setups should provide a shared backend.\n *\n * @module core/tools/InMemorySuspensionStore\n */\n\nimport type { ISuspensionStore, SuspensionRecord } from '../../contracts/suspension.js';\nimport { generateUlid } from '../ids.js';\n\n/**\n * Configuration for {@link InMemorySuspensionStore}.\n */\nexport interface InMemorySuspensionStoreConfig {\n\t/** Default TTL applied to records that omit `ttlMs`. Defaults to 60_000ms. */\n\tttlMs?: number;\n\t/** Sweep interval for the background expiry timer. Defaults to 60_000ms. */\n\tsweepIntervalMs?: number;\n\t/** Optional logger; reserved for future diagnostic output. */\n\tlogger?: unknown;\n}\n\nconst DEFAULT_TTL_MS = 300_000;\nconst DEFAULT_SWEEP_INTERVAL_MS = 60_000;\n\n/**\n * In-memory suspension store with TTL expiry and background sweep.\n *\n * @example\n * ```typescript\n * const store = new InMemorySuspensionStore({ ttlMs: 30_000 });\n * store.start();\n * const rec = store.suspend({\n *   sessionId: 's1',\n *   toolCallThoughtNumber: 3,\n *   toolName: 'search',\n *   toolArguments: { q: 'foo' },\n *   expiresAt: 0,\n * });\n * const resumed = store.resume(rec.token);\n * store.stop();\n * ```\n */\nexport class InMemorySuspensionStore implements ISuspensionStore {\n\tprivate readonly _byToken: Map<string, SuspensionRecord> = new Map();\n\tprivate readonly _bySession: Map<string, Set<string>> = new Map();\n\tprivate readonly _ttlMs: number;\n\tprivate readonly _sweepIntervalMs: number;\n\tprivate _timer: ReturnType<typeof setInterval> | null = null;\n\n\tconstructor(config: InMemorySuspensionStoreConfig = {}) {\n\t\tthis._ttlMs = config.ttlMs ?? DEFAULT_TTL_MS;\n\t\tthis._sweepIntervalMs = config.sweepIntervalMs ?? DEFAULT_SWEEP_INTERVAL_MS;\n\t}\n\n\tsuspend(\n\t\trecord: Omit<SuspensionRecord, 'token' | 'createdAt'> & { ttlMs?: number },\n\t): SuspensionRecord {\n\t\tconst token = generateUlid();\n\t\tconst createdAt = Date.now();\n\t\tconst ttlMs = record.ttlMs ?? this._ttlMs;\n\t\tconst expiresAt = createdAt + ttlMs;\n\n\t\tconst full: SuspensionRecord = {\n\t\t\ttoken,\n\t\t\tsessionId: record.sessionId,\n\t\t\ttoolCallThoughtNumber: record.toolCallThoughtNumber,\n\t\t\ttoolName: record.toolName,\n\t\t\ttoolArguments: record.toolArguments,\n\t\t\tcreatedAt,\n\t\t\texpiresAt,\n\t\t};\n\n\t\tthis._byToken.set(token, full);\n\t\tlet bucket = this._bySession.get(full.sessionId);\n\t\tif (!bucket) {\n\t\t\tbucket = new Set();\n\t\t\tthis._bySession.set(full.sessionId, bucket);\n\t\t}\n\t\tbucket.add(token);\n\n\t\treturn full;\n\t}\n\n\tresume(token: string): SuspensionRecord | null {\n\t\tconst rec = this._byToken.get(token);\n\t\tif (!rec) return null;\n\t\tif (rec.expiresAt <= Date.now()) {\n\t\t\tthis._delete(token, rec.sessionId);\n\t\t\treturn null;\n\t\t}\n\t\tthis._delete(token, rec.sessionId);\n\t\treturn rec;\n\t}\n\n\tpeek(token: string): SuspensionRecord | null {\n\t\treturn this._byToken.get(token) ?? null;\n\t}\n\n\texpireOlderThan(now: number): number {\n\t\tlet removed = 0;\n\t\tfor (const [token, rec] of this._byToken) {\n\t\t\tif (rec.expiresAt <= now) {\n\t\t\t\tthis._delete(token, rec.sessionId);\n\t\t\t\tremoved++;\n\t\t\t}\n\t\t}\n\t\treturn removed;\n\t}\n\n\tclearSession(sessionId: string): void {\n\t\tconst bucket = this._bySession.get(sessionId);\n\t\tif (!bucket) return;\n\t\tfor (const token of bucket) {\n\t\t\tthis._byToken.delete(token);\n\t\t}\n\t\tthis._bySession.delete(sessionId);\n\t}\n\n\tsize(sessionId?: string): number {\n\t\tif (sessionId === undefined) return this._byToken.size;\n\t\treturn this._bySession.get(sessionId)?.size ?? 0;\n\t}\n\n\tstart(): void {\n\t\tif (this._timer !== null) return;\n\t\tthis._timer = setInterval(() => {\n\t\t\tthis.expireOlderThan(Date.now());\n\t\t}, this._sweepIntervalMs);\n\t\tthis._timer.unref?.();\n\t}\n\n\tstop(): void {\n\t\tif (this._timer === null) return;\n\t\tclearInterval(this._timer);\n\t\tthis._timer = null;\n\t}\n\n\tprivate _delete(token: string, sessionId: string): void {\n\t\tthis._byToken.delete(token);\n\t\tconst bucket = this._bySession.get(sessionId);\n\t\tif (bucket) {\n\t\t\tbucket.delete(token);\n\t\t\tif (bucket.size === 0) this._bySession.delete(sessionId);\n\t\t}\n\t}\n}\n"],"names":["DEFAULT_TTL_MS","DEFAULT_SWEEP_INTERVAL_MS","InMemorySuspensionStore","Map","config","record","token","generateUlid","createdAt","Date","ttlMs","expiresAt","full","bucket","Set","rec","now","removed","sessionId","undefined","setInterval","clearInterval"],"mappings":"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"}
+{"version":3,"file":"core/tools/InMemorySuspensionStore.js","sources":["../../../src/core/tools/InMemorySuspensionStore.ts"],"sourcesContent":["/**\n * In-memory implementation of {@link ISuspensionStore}.\n *\n * Stores suspension records in process memory with optional background\n * sweeping of expired entries. Suitable for single-process deployments;\n * cluster setups should provide a shared backend.\n *\n * @module core/tools/InMemorySuspensionStore\n */\n\nimport type { ISuspensionStore, SuspensionRecord } from '../../contracts/suspension.js';\nimport { generateSuspensionToken } from '../../contracts/ids.js';\nimport type { Logger } from '../../logger/StructuredLogger.js';\n\n/**\n * Configuration for {@link InMemorySuspensionStore}.\n */\nexport interface InMemorySuspensionStoreConfig {\n\t/** Default TTL applied to records that omit `ttlMs`. Defaults to 60_000ms. */\n\tttlMs?: number;\n\t/** Sweep interval for the background expiry timer. Defaults to 60_000ms. */\n\tsweepIntervalMs?: number;\n\t/** Optional logger; reserved for future diagnostic output. */\n\t/** Optional logger for diagnostic output. */\n\tlogger?: Logger;\n}\n\nconst DEFAULT_TTL_MS = 300_000;\nconst DEFAULT_SWEEP_INTERVAL_MS = 60_000;\n\n/**\n * In-memory suspension store with TTL expiry and background sweep.\n *\n * @example\n * ```typescript\n * const store = new InMemorySuspensionStore({ ttlMs: 30_000 });\n * store.start();\n * const rec = store.suspend({\n *   sessionId: 's1',\n *   toolCallThoughtNumber: 3,\n *   toolName: 'search',\n *   toolArguments: { q: 'foo' },\n *   expiresAt: 0,\n * });\n * const resumed = store.resume(rec.token);\n * store.stop();\n * ```\n */\nexport class InMemorySuspensionStore implements ISuspensionStore {\n\tprivate readonly _byToken: Map<string, SuspensionRecord> = new Map();\n\tprivate readonly _bySession: Map<string, Set<string>> = new Map();\n\tprivate readonly _ttlMs: number;\n\tprivate readonly _sweepIntervalMs: number;\n\tprivate _timer: ReturnType<typeof setInterval> | null = null;\n\n\tconstructor(config: InMemorySuspensionStoreConfig = {}) {\n\t\tthis._ttlMs = config.ttlMs ?? DEFAULT_TTL_MS;\n\t\tthis._sweepIntervalMs = config.sweepIntervalMs ?? DEFAULT_SWEEP_INTERVAL_MS;\n\t}\n\n\tsuspend(\n\t\trecord: Omit<SuspensionRecord, 'token' | 'createdAt'> & { ttlMs?: number },\n\t): SuspensionRecord {\n\t\tconst token = generateSuspensionToken();\n\t\tconst createdAt = Date.now();\n\t\tconst ttlMs = record.ttlMs ?? this._ttlMs;\n\t\tconst expiresAt = createdAt + ttlMs;\n\n\t\tconst full: SuspensionRecord = {\n\t\t\ttoken,\n\t\t\tsessionId: record.sessionId,\n\t\t\ttoolCallThoughtNumber: record.toolCallThoughtNumber,\n\t\t\ttoolName: record.toolName,\n\t\t\ttoolArguments: record.toolArguments,\n\t\t\tcreatedAt,\n\t\t\texpiresAt,\n\t\t};\n\n\t\tthis._byToken.set(token, full);\n\t\tlet bucket = this._bySession.get(full.sessionId);\n\t\tif (!bucket) {\n\t\t\tbucket = new Set();\n\t\t\tthis._bySession.set(full.sessionId, bucket);\n\t\t}\n\t\tbucket.add(token);\n\n\t\treturn full;\n\t}\n\n\tresume(token: string): SuspensionRecord | null {\n\t\tconst rec = this._byToken.get(token);\n\t\tif (!rec) return null;\n\t\tif (rec.expiresAt <= Date.now()) {\n\t\t\tthis._delete(token, rec.sessionId);\n\t\t\treturn null;\n\t\t}\n\t\tthis._delete(token, rec.sessionId);\n\t\treturn rec;\n\t}\n\n\tpeek(token: string): SuspensionRecord | null {\n\t\treturn this._byToken.get(token) ?? null;\n\t}\n\n\texpireOlderThan(now: number): number {\n\t\tlet removed = 0;\n\t\tfor (const [token, rec] of this._byToken) {\n\t\t\tif (rec.expiresAt <= now) {\n\t\t\t\tthis._delete(token, rec.sessionId);\n\t\t\t\tremoved++;\n\t\t\t}\n\t\t}\n\t\treturn removed;\n\t}\n\n\tclearSession(sessionId: string): void {\n\t\tconst bucket = this._bySession.get(sessionId);\n\t\tif (!bucket) return;\n\t\tfor (const token of bucket) {\n\t\t\tthis._byToken.delete(token);\n\t\t}\n\t\tthis._bySession.delete(sessionId);\n\t}\n\n\tsize(sessionId?: string): number {\n\t\tif (sessionId === undefined) return this._byToken.size;\n\t\treturn this._bySession.get(sessionId)?.size ?? 0;\n\t}\n\n\tstart(): void {\n\t\tif (this._timer !== null) return;\n\t\tthis._timer = setInterval(() => {\n\t\t\tthis.expireOlderThan(Date.now());\n\t\t}, this._sweepIntervalMs);\n\t\tthis._timer.unref?.();\n\t}\n\n\tstop(): void {\n\t\tif (this._timer === null) return;\n\t\tclearInterval(this._timer);\n\t\tthis._timer = null;\n\t}\n\n\tprivate _delete(token: string, sessionId: string): void {\n\t\tthis._byToken.delete(token);\n\t\tconst bucket = this._bySession.get(sessionId);\n\t\tif (bucket) {\n\t\t\tbucket.delete(token);\n\t\t\tif (bucket.size === 0) this._bySession.delete(sessionId);\n\t\t}\n\t}\n}\n"],"names":["DEFAULT_TTL_MS","DEFAULT_SWEEP_INTERVAL_MS","InMemorySuspensionStore","Map","config","record","token","generateSuspensionToken","createdAt","Date","ttlMs","expiresAt","full","bucket","Set","rec","now","removed","sessionId","undefined","setInterval","clearInterval"],"mappings":"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"}

package/dist/di/Container.d.ts

@@ -1,3 +1,6 @@
+import type { Logger } from '../logger/StructuredLogger.js';
+import type { ServerConfig } from '../ServerConfig.js';
+import type { ConfigFileOptions } from '../config/ConfigLoader.js';
 import type { IDisposable } from '../types/disposable.js';
 import type { ServiceKey, ServiceRegistry } from './ServiceRegistry.js';
 /**
@@ -218,9 +221,9 @@ export declare class Container {
  * ```
  */
 export interface CreateContainerOptions {
-    logger?: unknown;
-    config?: unknown;
-    fileConfig?: Record<string, unknown>;
+    logger?: Logger;
+    config?: ServerConfig;
+    fileConfig?: ConfigFileOptions;
 }
 export declare function createDefaultContainer(options?: CreateContainerOptions): Container;
 //# sourceMappingURL=Container.d.ts.map

package/dist/di/Container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../src/di/Container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,YAAY,CAAuC;IAE3D;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IACnF,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI;IAYpD;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAChF,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI;IAYjD;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IACvF,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI;IAYxD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAoC3B;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM1B;;;;;;;;;;OAUG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI;IAQb;;;;;;;;;OASG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;;;OAUG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAQ9B;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAI7D;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,sBAAsB;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,sBAA2B,GAAG,SAAS,CActF"}
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../src/di/Container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,UAAU,CAAyC;IAC3D,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,YAAY,CAAuC;IAE3D;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IACnF,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI;IAYpD;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAChF,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI;IAYjD;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IACvF,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI;IAYxD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAoC3B;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM1B;;;;;;;;;;OAUG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI;IAQb;;;;;;;;;OASG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;;;OAUG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAQ9B;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAI7D;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,sBAAsB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,sBAA2B,GAAG,SAAS,CActF"}

package/dist/di/Container.js.map

@@ -1 +1 @@
-{"version":3,"file":"di/Container.js","sources":["../../src/di/Container.ts"],"sourcesContent":["import type { IDisposable } from '../types/disposable.js';\nimport type { ServiceKey, ServiceRegistry } from './ServiceRegistry.js';\n\n/**\n * Lightweight dependency injection container for managing service dependencies.\n *\n * This container supports:\n * - Instance registration (singleton-like behavior)\n * - Factory registration (lazy instantiation with caching)\n * - Transient factory registration (new instance each time)\n *\n * The container is type-safe when using ServiceKey from ServiceRegistry.\n * For dynamic/unknown services, use string keys with generic type parameters.\n *\n * @example\n * ```typescript\n * const container = new Container();\n *\n * // Type-safe registration with ServiceKey (recommended)\n * container.registerInstance('Logger', new StructuredLogger());\n *\n * // Type inference works automatically\n * const logger = container.resolve('Logger');  // Type: StructuredLogger\n *\n * // Register a factory with caching (singleton per container)\n * container.register('HistoryManager', () =>\n *   new HistoryManager({ logger: container.resolve('Logger') })\n * );\n *\n * // Register a transient factory (new instance each time)\n * container.registerFactory('RequestContext', () =>\n *   new RequestContext()\n * );\n *\n * // For dynamic services not in ServiceRegistry\n * container.registerInstance<MyService>('MyService', myService);\n * const service = container.resolve<MyService>('MyService');\n * ```\n */\nexport class Container {\n\tprivate _services: Map<string, unknown> = new Map();\n\tprivate _factories: Map<string, () => unknown> = new Map();\n\tprivate _transientFactories: Map<string, () => unknown> = new Map();\n\tprivate _resolving: Set<string> = new Set();\n\tprivate _disposables: Map<string, IDisposable> = new Map();\n\n\t/**\n\t * Register a singleton instance that will be returned for all resolutions.\n\t *\n\t * @param name - The unique name/identifier for the service\n\t * @param instance - The instance to register\n\t *\n\t * @example\n\t * ```typescript\n\t * container.registerInstance('Config', new ServerConfig({ ... }));\n\t * ```\n\t */\n\tregisterInstance<K extends ServiceKey>(name: K, instance: ServiceRegistry[K]): void;\n\tregisterInstance<T>(name: string, instance: T): void;\n\tregisterInstance(name: string, instance: unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._services.set(name, instance);\n\t}\n\n\t/**\n\t * Register a factory function that will be called once and cached.\n\t * The first call to `resolve` will invoke the factory and cache the result.\n\t * Subsequent calls will return the cached instance (singleton behavior).\n\t *\n\t * @param name - The unique name/identifier for the service\n\t * @param factory - A factory function that creates the service\n\t *\n\t * @example\n\t * ```typescript\n\t * container.register('HistoryManager', () =>\n\t *   new HistoryManager({ logger: container.resolve('Logger') })\n\t * );\n\t * ```\n\t */\n\tregister<K extends ServiceKey>(name: K, factory: () => ServiceRegistry[K]): void;\n\tregister<T>(name: string, factory: () => T): void;\n\tregister(name: string, factory: () => unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._factories.set(name, factory);\n\t}\n\n\t/**\n\t * Register a transient factory function that will be called on every resolution.\n\t * Each call to `resolve` will invoke the factory and return a new instance.\n\t *\n\t * @param name - The unique name/identifier for the service\n\t * @param factory - A factory function that creates the service\n\t *\n\t * @example\n\t * ```typescript\n\t * container.registerFactory('RequestContext', () =>\n\t *   new RequestContext()\n\t * );\n\t * ```\n\t */\n\tregisterFactory<K extends ServiceKey>(name: K, factory: () => ServiceRegistry[K]): void;\n\tregisterFactory<T>(name: string, factory: () => T): void;\n\tregisterFactory(name: string, factory: () => unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._transientFactories.set(name, factory);\n\t}\n\n\t/**\n\t * Resolve a service by name.\n\t *\n\t * Resolution order:\n\t * 1. If a registered instance exists, return it\n\t * 2. If a cached factory exists, return it\n\t * 3. If a factory exists, invoke it, cache the result, and return it\n\t * 4. If a transient factory exists, invoke it and return a new instance\n\t * 5. Throw an error if the service is not found\n\t *\n\t * @param name - The name/identifier of service to resolve\n\t * @returns The resolved service instance\n\t * @throws {Error} If the service is not registered\n\t *\n\t * @example\n\t * ```typescript\n\t * // Type-safe: ServiceRegistry provides autocomplete\n\t * const logger = container.resolve('Logger');  // Type: StructuredLogger\n\t * const config = container.resolve('Config');  // Type: ServerConfig\n\t *\n\t * // Dynamic: For services not in ServiceRegistry\n\t * const service = container.resolve<MyService>('MyService');\n\t * ```\n\t */\n\tresolve<K extends ServiceKey>(name: K): ServiceRegistry[K];\n\tresolve<T>(name: string): T;\n\tresolve(name: string): unknown {\n\t\tif (this._resolving.has(name)) {\n\t\t\tthrow new Error(`Circular dependency detected while resolving service: ${name}`);\n\t\t}\n\n\t\tthis._resolving.add(name);\n\n\t\ttry {\n\t\t\t// Check for registered instance first\n\t\t\tif (this._services.has(name)) {\n\t\t\t\treturn this._services.get(name);\n\t\t\t}\n\n\t\t\t// Check for cached factory result\n\t\t\tif (this._factories.has(name)) {\n\t\t\t\tconst factory = this._factories.get(name)!;\n\t\t\t\tconst instance = factory();\n\t\t\t\t// Cache the result for future calls (singleton behavior)\n\t\t\t\tthis._services.set(name, instance);\n\t\t\t\tthis._factories.delete(name);\n\t\t\t\treturn instance;\n\t\t\t}\n\n\t\t\t// Check for transient factory (call every time)\n\t\t\tif (this._transientFactories.has(name)) {\n\t\t\t\tconst factory = this._transientFactories.get(name)!;\n\t\t\t\treturn factory();\n\t\t\t}\n\n\t\t\tthrow new Error(`Service not found: ${name}. Did you forget to register it?`);\n\t\t} finally {\n\t\t\tthis._resolving.delete(name);\n\t\t}\n\t}\n\n\t/**\n\t * Check if a service is registered (either as instance or factory).\n\t *\n\t * @param name - The name/identifier of the service to check\n\t * @returns `true` if the service is registered, `false` otherwise\n\t *\n\t * @example\n\t * ```typescript\n\t * if (!container.has('Logger')) {\n\t *   container.registerInstance('Logger', new StructuredLogger());\n\t * }\n\t * ```\n\t */\n\thas(name: string): boolean {\n\t\treturn (\n\t\t\tthis._services.has(name) || this._factories.has(name) || this._transientFactories.has(name)\n\t\t);\n\t}\n\n\t/**\n\t * Remove a registered service from the container.\n\t *\n\t * @param name - The name/identifier of the service to unregister\n\t * @returns `true` if the service was found and removed, `false` otherwise\n\t *\n\t * @example\n\t * ```typescript\n\t * container.unregister('HistoryManager');\n\t * ```\n\t */\n\tunregister(name: string): boolean {\n\t\tconst hadInstance = this._services.delete(name);\n\t\tconst hadFactory = this._factories.delete(name);\n\t\tconst hadTransient = this._transientFactories.delete(name);\n\t\tthis._disposables.delete(name);\n\t\treturn hadInstance || hadFactory || hadTransient;\n\t}\n\n\t/**\n\t * Clear all registered services and factories from the container.\n\t *\n\t * @example\n\t * ```typescript\n\t * container.clear();\n\t * ```\n\t */\n\tclear(): void {\n\t\tthis._services.clear();\n\t\tthis._factories.clear();\n\t\tthis._transientFactories.clear();\n\t\tthis._resolving.clear();\n\t\tthis._disposables.clear();\n\t}\n\n\t/**\n\t * Get the number of registered services (including instances, factories, and transient factories).\n\t *\n\t * @returns The total count of registered services\n\t *\n\t * @example\n\t * ```typescript\n\t * console.log(`Registered services: ${container.size}`);\n\t * ```\n\t */\n\tget size(): number {\n\t\treturn this._services.size + this._factories.size + this._transientFactories.size;\n\t}\n\n\t/**\n\t * Get an array of all registered service names.\n\t *\n\t * @returns An array of service names\n\t *\n\t * @example\n\t * ```typescript\n\t * const names = container.registeredServices();\n\t * console.log('Registered:', names.join(', '));\n\t * ```\n\t */\n\tregisteredServices(): string[] {\n\t\tconst names = new Set<string>();\n\t\tfor (const name of this._services.keys()) names.add(name);\n\t\tfor (const name of this._factories.keys()) names.add(name);\n\t\tfor (const name of this._transientFactories.keys()) names.add(name);\n\t\treturn Array.from(names);\n\t}\n\n\t/**\n\t * Register an instance as disposable for lifecycle management.\n\t * The instance will have its `dispose()` method called when the container is disposed.\n\t *\n\t * @param name - The service name (must already be registered)\n\t * @param instance - The disposable instance to track\n\t *\n\t * @example\n\t * ```typescript\n\t * const pool = new ConnectionPool();\n\t * container.registerInstance('ConnectionPool', pool);\n\t * container.registerDisposable('ConnectionPool', pool);\n\t * ```\n\t */\n\tregisterDisposable(name: string, instance: IDisposable): void {\n\t\tthis._disposables.set(name, instance);\n\t}\n\n\t/**\n\t * Dispose of all registered disposable services.\n\t * Calls `dispose()` on each registered disposable in reverse registration order.\n\t * Errors during individual disposal are caught and logged to prevent cascading failures.\n\t *\n\t * @example\n\t * ```typescript\n\t * await container.dispose();\n\t * ```\n\t */\n\tasync dispose(): Promise<void> {\n\t\tconst entries = Array.from(this._disposables.entries()).reverse();\n\t\tconst errors: Array<{ name: string; error: unknown }> = [];\n\n\t\tfor (const [name, disposable] of entries) {\n\t\t\ttry {\n\t\t\t\tawait disposable.dispose();\n\t\t\t} catch (error) {\n\t\t\t\terrors.push({ name, error });\n\t\t\t}\n\t\t}\n\n\t\tthis._disposables.clear();\n\n\t\tif (errors.length > 0) {\n\t\t\tconst messages = errors.map(\n\t\t\t\t(e) => `${e.name}: ${e.error instanceof Error ? e.error.message : String(e.error)}`\n\t\t\t);\n\t\t\tthrow new Error(`Failed to dispose services: ${messages.join(', ')}`);\n\t\t}\n\t}\n}\n\n/**\n * Create a pre-configured container with all default services registered.\n *\n * This factory function creates a container with all standard services\n * for the ToolAwareSequentialThinkingServer.\n *\n * @param options - Configuration options for the container\n * @returns A configured container ready to use\n *\n * @example\n * ```typescript\n * const container = createDefaultContainer({\n *   logger: customLogger,\n *   config: customConfig\n * });\n * const server = new ToolAwareSequentialThinkingServer({ container });\n * ```\n */\nexport interface CreateContainerOptions {\n\tlogger?: unknown;\n\tconfig?: unknown;\n\tfileConfig?: Record<string, unknown>;\n}\n\nexport function createDefaultContainer(options: CreateContainerOptions = {}): Container {\n\tconst container = new Container();\n\n\t// Register logger if provided\n\tif (options.logger) {\n\t\tcontainer.registerInstance('Logger', options.logger);\n\t}\n\n\t// Register config if provided\n\tif (options.config) {\n\t\tcontainer.registerInstance('Config', options.config);\n\t}\n\n\treturn container;\n}\n"],"names":["Container","Map","Set","name","instance","Error","factory","hadInstance","hadFactory","hadTransient","names","Array","entries","errors","disposable","error","messages","e","String","createDefaultContainer","options","container"],"mappings":"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"}
+{"version":3,"file":"di/Container.js","sources":["../../src/di/Container.ts"],"sourcesContent":["import type { Logger } from '../logger/StructuredLogger.js';\nimport type { ServerConfig } from '../ServerConfig.js';\nimport type { ConfigFileOptions } from '../config/ConfigLoader.js';\n\nimport type { IDisposable } from '../types/disposable.js';\nimport type { ServiceKey, ServiceRegistry } from './ServiceRegistry.js';\n\n/**\n * Lightweight dependency injection container for managing service dependencies.\n *\n * This container supports:\n * - Instance registration (singleton-like behavior)\n * - Factory registration (lazy instantiation with caching)\n * - Transient factory registration (new instance each time)\n *\n * The container is type-safe when using ServiceKey from ServiceRegistry.\n * For dynamic/unknown services, use string keys with generic type parameters.\n *\n * @example\n * ```typescript\n * const container = new Container();\n *\n * // Type-safe registration with ServiceKey (recommended)\n * container.registerInstance('Logger', new StructuredLogger());\n *\n * // Type inference works automatically\n * const logger = container.resolve('Logger');  // Type: StructuredLogger\n *\n * // Register a factory with caching (singleton per container)\n * container.register('HistoryManager', () =>\n *   new HistoryManager({ logger: container.resolve('Logger') })\n * );\n *\n * // Register a transient factory (new instance each time)\n * container.registerFactory('RequestContext', () =>\n *   new RequestContext()\n * );\n *\n * // For dynamic services not in ServiceRegistry\n * container.registerInstance<MyService>('MyService', myService);\n * const service = container.resolve<MyService>('MyService');\n * ```\n */\nexport class Container {\n\tprivate _services: Map<string, unknown> = new Map();\n\tprivate _factories: Map<string, () => unknown> = new Map();\n\tprivate _transientFactories: Map<string, () => unknown> = new Map();\n\tprivate _resolving: Set<string> = new Set();\n\tprivate _disposables: Map<string, IDisposable> = new Map();\n\n\t/**\n\t * Register a singleton instance that will be returned for all resolutions.\n\t *\n\t * @param name - The unique name/identifier for the service\n\t * @param instance - The instance to register\n\t *\n\t * @example\n\t * ```typescript\n\t * container.registerInstance('Config', new ServerConfig({ ... }));\n\t * ```\n\t */\n\tregisterInstance<K extends ServiceKey>(name: K, instance: ServiceRegistry[K]): void;\n\tregisterInstance<T>(name: string, instance: T): void;\n\tregisterInstance(name: string, instance: unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._services.set(name, instance);\n\t}\n\n\t/**\n\t * Register a factory function that will be called once and cached.\n\t * The first call to `resolve` will invoke the factory and cache the result.\n\t * Subsequent calls will return the cached instance (singleton behavior).\n\t *\n\t * @param name - The unique name/identifier for the service\n\t * @param factory - A factory function that creates the service\n\t *\n\t * @example\n\t * ```typescript\n\t * container.register('HistoryManager', () =>\n\t *   new HistoryManager({ logger: container.resolve('Logger') })\n\t * );\n\t * ```\n\t */\n\tregister<K extends ServiceKey>(name: K, factory: () => ServiceRegistry[K]): void;\n\tregister<T>(name: string, factory: () => T): void;\n\tregister(name: string, factory: () => unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._factories.set(name, factory);\n\t}\n\n\t/**\n\t * Register a transient factory function that will be called on every resolution.\n\t * Each call to `resolve` will invoke the factory and return a new instance.\n\t *\n\t * @param name - The unique name/identifier for the service\n\t * @param factory - A factory function that creates the service\n\t *\n\t * @example\n\t * ```typescript\n\t * container.registerFactory('RequestContext', () =>\n\t *   new RequestContext()\n\t * );\n\t * ```\n\t */\n\tregisterFactory<K extends ServiceKey>(name: K, factory: () => ServiceRegistry[K]): void;\n\tregisterFactory<T>(name: string, factory: () => T): void;\n\tregisterFactory(name: string, factory: () => unknown): void {\n\t\tif (\n\t\t\tthis._services.has(name) ||\n\t\t\tthis._factories.has(name) ||\n\t\t\tthis._transientFactories.has(name)\n\t\t) {\n\t\t\tthrow new Error(`Service '${name}' is already registered`);\n\t\t}\n\t\tthis._transientFactories.set(name, factory);\n\t}\n\n\t/**\n\t * Resolve a service by name.\n\t *\n\t * Resolution order:\n\t * 1. If a registered instance exists, return it\n\t * 2. If a cached factory exists, return it\n\t * 3. If a factory exists, invoke it, cache the result, and return it\n\t * 4. If a transient factory exists, invoke it and return a new instance\n\t * 5. Throw an error if the service is not found\n\t *\n\t * @param name - The name/identifier of service to resolve\n\t * @returns The resolved service instance\n\t * @throws {Error} If the service is not registered\n\t *\n\t * @example\n\t * ```typescript\n\t * // Type-safe: ServiceRegistry provides autocomplete\n\t * const logger = container.resolve('Logger');  // Type: StructuredLogger\n\t * const config = container.resolve('Config');  // Type: ServerConfig\n\t *\n\t * // Dynamic: For services not in ServiceRegistry\n\t * const service = container.resolve<MyService>('MyService');\n\t * ```\n\t */\n\tresolve<K extends ServiceKey>(name: K): ServiceRegistry[K];\n\tresolve<T>(name: string): T;\n\tresolve(name: string): unknown {\n\t\tif (this._resolving.has(name)) {\n\t\t\tthrow new Error(`Circular dependency detected while resolving service: ${name}`);\n\t\t}\n\n\t\tthis._resolving.add(name);\n\n\t\ttry {\n\t\t\t// Check for registered instance first\n\t\t\tif (this._services.has(name)) {\n\t\t\t\treturn this._services.get(name);\n\t\t\t}\n\n\t\t\t// Check for cached factory result\n\t\t\tif (this._factories.has(name)) {\n\t\t\t\tconst factory = this._factories.get(name)!;\n\t\t\t\tconst instance = factory();\n\t\t\t\t// Cache the result for future calls (singleton behavior)\n\t\t\t\tthis._services.set(name, instance);\n\t\t\t\tthis._factories.delete(name);\n\t\t\t\treturn instance;\n\t\t\t}\n\n\t\t\t// Check for transient factory (call every time)\n\t\t\tif (this._transientFactories.has(name)) {\n\t\t\t\tconst factory = this._transientFactories.get(name)!;\n\t\t\t\treturn factory();\n\t\t\t}\n\n\t\t\tthrow new Error(`Service not found: ${name}. Did you forget to register it?`);\n\t\t} finally {\n\t\t\tthis._resolving.delete(name);\n\t\t}\n\t}\n\n\t/**\n\t * Check if a service is registered (either as instance or factory).\n\t *\n\t * @param name - The name/identifier of the service to check\n\t * @returns `true` if the service is registered, `false` otherwise\n\t *\n\t * @example\n\t * ```typescript\n\t * if (!container.has('Logger')) {\n\t *   container.registerInstance('Logger', new StructuredLogger());\n\t * }\n\t * ```\n\t */\n\thas(name: string): boolean {\n\t\treturn (\n\t\t\tthis._services.has(name) || this._factories.has(name) || this._transientFactories.has(name)\n\t\t);\n\t}\n\n\t/**\n\t * Remove a registered service from the container.\n\t *\n\t * @param name - The name/identifier of the service to unregister\n\t * @returns `true` if the service was found and removed, `false` otherwise\n\t *\n\t * @example\n\t * ```typescript\n\t * container.unregister('HistoryManager');\n\t * ```\n\t */\n\tunregister(name: string): boolean {\n\t\tconst hadInstance = this._services.delete(name);\n\t\tconst hadFactory = this._factories.delete(name);\n\t\tconst hadTransient = this._transientFactories.delete(name);\n\t\tthis._disposables.delete(name);\n\t\treturn hadInstance || hadFactory || hadTransient;\n\t}\n\n\t/**\n\t * Clear all registered services and factories from the container.\n\t *\n\t * @example\n\t * ```typescript\n\t * container.clear();\n\t * ```\n\t */\n\tclear(): void {\n\t\tthis._services.clear();\n\t\tthis._factories.clear();\n\t\tthis._transientFactories.clear();\n\t\tthis._resolving.clear();\n\t\tthis._disposables.clear();\n\t}\n\n\t/**\n\t * Get the number of registered services (including instances, factories, and transient factories).\n\t *\n\t * @returns The total count of registered services\n\t *\n\t * @example\n\t * ```typescript\n\t * console.log(`Registered services: ${container.size}`);\n\t * ```\n\t */\n\tget size(): number {\n\t\treturn this._services.size + this._factories.size + this._transientFactories.size;\n\t}\n\n\t/**\n\t * Get an array of all registered service names.\n\t *\n\t * @returns An array of service names\n\t *\n\t * @example\n\t * ```typescript\n\t * const names = container.registeredServices();\n\t * console.log('Registered:', names.join(', '));\n\t * ```\n\t */\n\tregisteredServices(): string[] {\n\t\tconst names = new Set<string>();\n\t\tfor (const name of this._services.keys()) names.add(name);\n\t\tfor (const name of this._factories.keys()) names.add(name);\n\t\tfor (const name of this._transientFactories.keys()) names.add(name);\n\t\treturn Array.from(names);\n\t}\n\n\t/**\n\t * Register an instance as disposable for lifecycle management.\n\t * The instance will have its `dispose()` method called when the container is disposed.\n\t *\n\t * @param name - The service name (must already be registered)\n\t * @param instance - The disposable instance to track\n\t *\n\t * @example\n\t * ```typescript\n\t * const pool = new ConnectionPool();\n\t * container.registerInstance('ConnectionPool', pool);\n\t * container.registerDisposable('ConnectionPool', pool);\n\t * ```\n\t */\n\tregisterDisposable(name: string, instance: IDisposable): void {\n\t\tthis._disposables.set(name, instance);\n\t}\n\n\t/**\n\t * Dispose of all registered disposable services.\n\t * Calls `dispose()` on each registered disposable in reverse registration order.\n\t * Errors during individual disposal are caught and logged to prevent cascading failures.\n\t *\n\t * @example\n\t * ```typescript\n\t * await container.dispose();\n\t * ```\n\t */\n\tasync dispose(): Promise<void> {\n\t\tconst entries = Array.from(this._disposables.entries()).reverse();\n\t\tconst errors: Array<{ name: string; error: unknown }> = [];\n\n\t\tfor (const [name, disposable] of entries) {\n\t\t\ttry {\n\t\t\t\tawait disposable.dispose();\n\t\t\t} catch (error) {\n\t\t\t\terrors.push({ name, error });\n\t\t\t}\n\t\t}\n\n\t\tthis._disposables.clear();\n\n\t\tif (errors.length > 0) {\n\t\t\tconst messages = errors.map(\n\t\t\t\t(e) => `${e.name}: ${e.error instanceof Error ? e.error.message : String(e.error)}`\n\t\t\t);\n\t\t\tthrow new Error(`Failed to dispose services: ${messages.join(', ')}`);\n\t\t}\n\t}\n}\n\n/**\n * Create a pre-configured container with all default services registered.\n *\n * This factory function creates a container with all standard services\n * for the ToolAwareSequentialThinkingServer.\n *\n * @param options - Configuration options for the container\n * @returns A configured container ready to use\n *\n * @example\n * ```typescript\n * const container = createDefaultContainer({\n *   logger: customLogger,\n *   config: customConfig\n * });\n * const server = new ToolAwareSequentialThinkingServer({ container });\n * ```\n */\nexport interface CreateContainerOptions {\n\tlogger?: Logger;\n\tconfig?: ServerConfig;\n\tfileConfig?: ConfigFileOptions;\n}\n\nexport function createDefaultContainer(options: CreateContainerOptions = {}): Container {\n\tconst container = new Container();\n\n\t// Register logger if provided\n\tif (options.logger) {\n\t\tcontainer.registerInstance('Logger', options.logger);\n\t}\n\n\t// Register config if provided\n\tif (options.config) {\n\t\tcontainer.registerInstance('Config', options.config);\n\t}\n\n\treturn container;\n}\n"],"names":["Container","Map","Set","name","instance","Error","factory","hadInstance","hadFactory","hadTransient","names","Array","entries","errors","disposable","error","messages","e","String","createDefaultContainer","options","container"],"mappings":"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"}

package/dist/di/ServiceRegistry.d.ts

@@ -5,14 +5,14 @@
  * Interface types are imported from contracts/ to reduce coupling.
  * Concrete types are imported only where needed for DI resolution.
  */
-import type { PersistenceBackend } from '../persistence/PersistenceBackend.js';
+import type { PersistenceBackend } from '../contracts/PersistenceBackend.js';
 import type { HistoryManager } from '../core/HistoryManager.js';
 import type { EdgeStore } from '../core/graph/EdgeStore.js';
 import type { ICalibrator } from '../contracts/calibrator.js';
 import type { IOutcomeRecorder } from '../contracts/interfaces.js';
 import type { IReasoningStrategy } from '../contracts/strategy.js';
 import type { ThoughtEvaluator } from '../core/ThoughtEvaluator.js';
-import type { ThoughtFormatter } from '../core/ThoughtFormatter.js';
+import type { IThoughtFormatter } from '../core/IThoughtFormatter.js';
 import type { ThoughtProcessor } from '../core/ThoughtProcessor.js';
 import type { StructuredLogger } from '../logger/StructuredLogger.js';
 import type { Metrics } from '../metrics/metrics.impl.js';
@@ -28,7 +28,7 @@ export interface ServiceRegistry {
     FileConfig: Record<string, unknown>;
     HistoryManager: HistoryManager;
     ThoughtProcessor: ThoughtProcessor;
-    ThoughtFormatter: ThoughtFormatter;
+    ThoughtFormatter: IThoughtFormatter;
     ThoughtEvaluator: ThoughtEvaluator;
     Persistence: PersistenceBackend | null;
     ToolRegistry: ToolRegistry;

package/dist/di/ServiceRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceRegistry.d.ts","sourceRoot":"","sources":["../../src/di/ServiceRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvC,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,eAAe,EAAE,gBAAgB,CAAC;IAClC,UAAU,EAAE,WAAW,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC;IAC5B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,gBAAgB,CAAC;CAClC;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC"}
+{"version":3,"file":"ServiceRegistry.d.ts","sourceRoot":"","sources":["../../src/di/ServiceRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvC,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,eAAe,EAAE,gBAAgB,CAAC;IAClC,UAAU,EAAE,WAAW,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC;IAC5B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,gBAAgB,CAAC;CAClC;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC"}

package/dist/errors.d.ts

@@ -25,6 +25,34 @@
  * ```
  * @module errors
  */
+/**
+ * All known error codes as a const object for exhaustive switching.
+ */
+export declare const ERROR_CODES: {
+    readonly CONFIGURATION_ERROR: "CONFIGURATION_ERROR";
+    readonly TOOL_NOT_FOUND: "TOOL_NOT_FOUND";
+    readonly SKILL_NOT_FOUND: "SKILL_NOT_FOUND";
+    readonly INVALID_THOUGHT: "INVALID_THOUGHT";
+    readonly SKILL_DISCOVERY_FAILED: "SKILL_DISCOVERY_FAILED";
+    readonly HISTORY_LIMIT_EXCEEDED: "HISTORY_LIMIT_EXCEEDED";
+    readonly DUPLICATE_SKILL: "DUPLICATE_SKILL";
+    readonly INVALID_SKILL: "INVALID_SKILL";
+    readonly DUPLICATE_TOOL: "DUPLICATE_TOOL";
+    readonly INVALID_TOOL: "INVALID_TOOL";
+    readonly SESSION_NOT_ACTIVE: "SESSION_NOT_ACTIVE";
+    readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+    readonly MAX_SESSIONS_REACHED: "MAX_SESSIONS_REACHED";
+    readonly POOL_TERMINATED: "POOL_TERMINATED";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly INVALID_EDGE: "INVALID_EDGE";
+    readonly CYCLE_DETECTED: "CYCLE_DETECTED";
+    readonly SUSPENSION_NOT_FOUND: "SUSPENSION_NOT_FOUND";
+    readonly SUSPENSION_EXPIRED: "SUSPENSION_EXPIRED";
+    readonly INVALID_TOOL_CALL: "INVALID_TOOL_CALL";
+    readonly INVALID_BACKTRACK: "INVALID_BACKTRACK";
+    readonly DUPLICATE_SUMMARY: "DUPLICATE_SUMMARY";
+};
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
 /**
  * Base error class for all Sequential Thinking server errors.
  *
@@ -54,7 +82,7 @@
  */
 export declare class SequentialThinkingError extends Error {
     /** The error code for programmatic identification. */
-    readonly code: string;
+    readonly code: ErrorCode;
     /**
      * Creates a new SequentialThinkingError.
      *
@@ -70,7 +98,7 @@ export declare class SequentialThinkingError extends Error {
      * console.log(error.code); // 'CUSTOM_ERROR'
      * ```
      */
-    constructor(message: string, code: string);
+    constructor(message: string, code: ErrorCode);
 }
 export declare class ConfigurationError extends SequentialThinkingError {
     constructor(message: string);
@@ -577,6 +605,12 @@ export declare class InvalidToolCallError extends SequentialThinkingError {
 export declare class InvalidBacktrackError extends SequentialThinkingError {
     constructor(message: string);
 }
+/**
+ * Type guard to check if an error has a specific error code.
+ */
+export declare function isErrorCode<C extends ErrorCode>(err: unknown, code: C): err is SequentialThinkingError & {
+    readonly code: C;
+};
 /**
  * Extract a human-readable message from an unknown error value.
  *

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;CAuBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,sDAAsD;IACtD,SAAgB,IAAI,EAAE,SAAS,CAAC;IAEhC;;;;;;;;;;;;;;OAcG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;CAM5C;AAED,qBAAa,kBAAmB,SAAQ,uBAAuB;gBAClD,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,SAAQ,uBAAuB;IAC7D;;;;;;;;;;;;;;;OAeG;gBACS,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAO7C;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,uBAAuB;IAC9D;;;;;;;;;;;;;;;OAeG;gBACS,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAO9C;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAoB,SAAQ,uBAAuB;IAC/D;;;;;;;;;;;;OAYG;gBACS,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIjD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAoB,SAAQ,uBAAuB;IAC/D,8DAA8D;IAC9D,SAAyB,KAAK,EAAE,KAAK,CAAC;IAEtC;;;;;;;;;;;;;;OAcG;gBACS,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAQ3C;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAA0B,SAAQ,uBAAuB;IACrE;;;;;;;;;;;;OAYG;gBACS,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIhD;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,SAAQ,uBAAuB;IAC/D;;;;;;;;;;;OAWG;gBACS,SAAS,EAAE,MAAM;CAI7B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,SAAQ,uBAAuB;IAC7D;;;;;;;;;;;OAWG;gBACS,MAAM,EAAE,MAAM;CAI1B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,SAAQ,uBAAuB;IAC9D;;;;;;;;;;;OAWG;gBACS,QAAQ,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,SAAQ,uBAAuB;IAC5D;;;;;;;;;;;OAWG;gBACS,MAAM,EAAE,MAAM;CAI1B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,SAAQ,uBAAuB;IACjE;;;;;;;;;;;OAWG;gBACS,SAAS,EAAE,MAAM;CAI7B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,SAAQ,uBAAuB;IAChE;;;;;;;;;;;OAWG;gBACS,SAAS,EAAE,MAAM;CAI7B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,uBAAwB,SAAQ,uBAAuB;IACnE;;;;;;;;;;;OAWG;gBACS,WAAW,EAAE,MAAM;CAO/B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,SAAQ,uBAAuB;IAC/D;;;;;;;;;OASG;;CAKH;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,uBAAuB;IAC3D,wCAAwC;IACxC,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAKzC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,SAAQ,uBAAuB;IAC5D;;;;;;;;;;OAUG;gBACS,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAmB,SAAQ,uBAAuB;IAC9D;;;;;;;;;;OAUG;gBACS,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,uBAAuB;gBACvD,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,uBAAuB;gBACtD,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,uBAAuB;gBACpD,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,uBAAuB;gBACrD,OAAO,EAAE,MAAM;CAI3B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAC9C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,GACL,GAAG,IAAI,uBAAuB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAEvD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD"}

package/dist/errors.js

@@ -1,3 +1,27 @@
+const ERROR_CODES = {
+    CONFIGURATION_ERROR: 'CONFIGURATION_ERROR',
+    TOOL_NOT_FOUND: 'TOOL_NOT_FOUND',
+    SKILL_NOT_FOUND: 'SKILL_NOT_FOUND',
+    INVALID_THOUGHT: 'INVALID_THOUGHT',
+    SKILL_DISCOVERY_FAILED: 'SKILL_DISCOVERY_FAILED',
+    HISTORY_LIMIT_EXCEEDED: 'HISTORY_LIMIT_EXCEEDED',
+    DUPLICATE_SKILL: 'DUPLICATE_SKILL',
+    INVALID_SKILL: 'INVALID_SKILL',
+    DUPLICATE_TOOL: 'DUPLICATE_TOOL',
+    INVALID_TOOL: 'INVALID_TOOL',
+    SESSION_NOT_ACTIVE: 'SESSION_NOT_ACTIVE',
+    SESSION_NOT_FOUND: 'SESSION_NOT_FOUND',
+    MAX_SESSIONS_REACHED: 'MAX_SESSIONS_REACHED',
+    POOL_TERMINATED: 'POOL_TERMINATED',
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    INVALID_EDGE: 'INVALID_EDGE',
+    CYCLE_DETECTED: 'CYCLE_DETECTED',
+    SUSPENSION_NOT_FOUND: 'SUSPENSION_NOT_FOUND',
+    SUSPENSION_EXPIRED: 'SUSPENSION_EXPIRED',
+    INVALID_TOOL_CALL: 'INVALID_TOOL_CALL',
+    INVALID_BACKTRACK: 'INVALID_BACKTRACK',
+    DUPLICATE_SUMMARY: 'DUPLICATE_SUMMARY'
+};
 class SequentialThinkingError extends Error {
     code;
     constructor(message, code){
@@ -9,139 +33,142 @@ class SequentialThinkingError extends Error {
 }
 class ConfigurationError extends SequentialThinkingError {
     constructor(message){
-        super(message, 'CONFIGURATION_ERROR');
+        super(message, ERROR_CODES.CONFIGURATION_ERROR);
         this.name = 'ConfigurationError';
     }
 }
 class ToolNotFoundError extends SequentialThinkingError {
     constructor(toolName, action){
         const message = action ? `Tool '${toolName}' not found, cannot ${action}` : `Tool '${toolName}' not found`;
-        super(message, 'TOOL_NOT_FOUND');
+        super(message, ERROR_CODES.TOOL_NOT_FOUND);
         this.name = 'ToolNotFoundError';
     }
 }
 class SkillNotFoundError extends SequentialThinkingError {
     constructor(skillName, action){
         const message = action ? `Skill '${skillName}' not found, cannot ${action}` : `Skill '${skillName}' not found`;
-        super(message, 'SKILL_NOT_FOUND');
+        super(message, ERROR_CODES.SKILL_NOT_FOUND);
         this.name = 'SkillNotFoundError';
     }
 }
 class InvalidThoughtError extends SequentialThinkingError {
     constructor(thoughtNumber, reason){
-        super(`Invalid thought ${thoughtNumber}: ${reason}`, 'INVALID_THOUGHT');
+        super(`Invalid thought ${thoughtNumber}: ${reason}`, ERROR_CODES.INVALID_THOUGHT);
         this.name = 'InvalidThoughtError';
     }
 }
 class SkillDiscoveryError extends SequentialThinkingError {
     cause;
     constructor(directory, cause){
-        super(`Failed to discover skills in ${directory}: ${cause.message}`, 'SKILL_DISCOVERY_FAILED');
+        super(`Failed to discover skills in ${directory}: ${cause.message}`, ERROR_CODES.SKILL_DISCOVERY_FAILED);
         this.name = 'SkillDiscoveryError';
         this.cause = cause;
     }
 }
 class HistoryLimitExceededError extends SequentialThinkingError {
     constructor(currentSize, maxSize){
-        super(`History size ${currentSize} exceeds limit ${maxSize}`, 'HISTORY_LIMIT_EXCEEDED');
+        super(`History size ${currentSize} exceeds limit ${maxSize}`, ERROR_CODES.HISTORY_LIMIT_EXCEEDED);
         this.name = 'HistoryLimitExceededError';
     }
 }
 class DuplicateSkillError extends SequentialThinkingError {
     constructor(skillName){
-        super(`skill '${skillName}' already exists`, 'DUPLICATE_SKILL');
+        super(`skill '${skillName}' already exists`, ERROR_CODES.DUPLICATE_SKILL);
         this.name = 'DuplicateSkillError';
     }
 }
 class InvalidSkillError extends SequentialThinkingError {
     constructor(reason){
-        super(`Invalid skill: ${reason}`, 'INVALID_SKILL');
+        super(`Invalid skill: ${reason}`, ERROR_CODES.INVALID_SKILL);
         this.name = 'InvalidSkillError';
     }
 }
 class DuplicateToolError extends SequentialThinkingError {
     constructor(toolName){
-        super(`tool '${toolName}' already exists`, 'DUPLICATE_TOOL');
+        super(`tool '${toolName}' already exists`, ERROR_CODES.DUPLICATE_TOOL);
         this.name = 'DuplicateToolError';
     }
 }
 class InvalidToolError extends SequentialThinkingError {
     constructor(reason){
-        super(`Invalid tool: ${reason}`, 'INVALID_TOOL');
+        super(`Invalid tool: ${reason}`, ERROR_CODES.INVALID_TOOL);
         this.name = 'InvalidToolError';
     }
 }
 class SessionNotActiveError extends SequentialThinkingError {
     constructor(sessionId){
-        super(`Session '${sessionId}' is not active`, 'SESSION_NOT_ACTIVE');
+        super(`Session '${sessionId}' is not active`, ERROR_CODES.SESSION_NOT_ACTIVE);
         this.name = 'SessionNotActiveError';
     }
 }
 class SessionNotFoundError extends SequentialThinkingError {
     constructor(sessionId){
-        super(`Session not found: ${sessionId}`, 'SESSION_NOT_FOUND');
+        super(`Session not found: ${sessionId}`, ERROR_CODES.SESSION_NOT_FOUND);
         this.name = 'SessionNotFoundError';
     }
 }
 class MaxSessionsReachedError extends SequentialThinkingError {
     constructor(maxSessions){
-        super(`Max sessions (${maxSessions}) reached. Wait for a session to close or increase maxSessions.`, 'MAX_SESSIONS_REACHED');
+        super(`Max sessions (${maxSessions}) reached. Wait for a session to close or increase maxSessions.`, ERROR_CODES.MAX_SESSIONS_REACHED);
         this.name = 'MaxSessionsReachedError';
     }
 }
 class PoolTerminatedError extends SequentialThinkingError {
     constructor(){
-        super('ConnectionPool has been terminated', 'POOL_TERMINATED');
+        super('ConnectionPool has been terminated', ERROR_CODES.POOL_TERMINATED);
         this.name = 'PoolTerminatedError';
     }
 }
 class ValidationError extends SequentialThinkingError {
     field;
     constructor(field, reason){
-        super(`Validation failed for '${field}': ${reason}`, 'VALIDATION_ERROR');
+        super(`Validation failed for '${field}': ${reason}`, ERROR_CODES.VALIDATION_ERROR);
         this.name = 'ValidationError';
         this.field = field;
     }
 }
 class InvalidEdgeError extends SequentialThinkingError {
     constructor(message){
-        super(message, 'INVALID_EDGE');
+        super(message, ERROR_CODES.INVALID_EDGE);
         this.name = 'InvalidEdgeError';
     }
 }
 class CycleDetectedError extends SequentialThinkingError {
     constructor(message){
-        super(message, 'CYCLE_DETECTED');
+        super(message, ERROR_CODES.CYCLE_DETECTED);
         this.name = 'CycleDetectedError';
     }
 }
 class SuspensionNotFoundError extends SequentialThinkingError {
     constructor(message){
-        super(message, 'SUSPENSION_NOT_FOUND');
+        super(message, ERROR_CODES.SUSPENSION_NOT_FOUND);
         this.name = 'SuspensionNotFoundError';
     }
 }
 class SuspensionExpiredError extends SequentialThinkingError {
     constructor(message){
-        super(message, 'SUSPENSION_EXPIRED');
+        super(message, ERROR_CODES.SUSPENSION_EXPIRED);
         this.name = 'SuspensionExpiredError';
     }
 }
 class InvalidToolCallError extends SequentialThinkingError {
     constructor(message){
-        super(message, 'INVALID_TOOL_CALL');
+        super(message, ERROR_CODES.INVALID_TOOL_CALL);
         this.name = 'InvalidToolCallError';
     }
 }
 class InvalidBacktrackError extends SequentialThinkingError {
     constructor(message){
-        super(message, 'INVALID_BACKTRACK');
+        super(message, ERROR_CODES.INVALID_BACKTRACK);
         this.name = 'InvalidBacktrackError';
     }
 }
+function isErrorCode(err, code) {
+    return err instanceof SequentialThinkingError && err.code === code;
+}
 function getErrorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }
-export { ConfigurationError, CycleDetectedError, DuplicateSkillError, DuplicateToolError, HistoryLimitExceededError, InvalidBacktrackError, InvalidEdgeError, InvalidSkillError, InvalidThoughtError, InvalidToolCallError, InvalidToolError, MaxSessionsReachedError, PoolTerminatedError, SequentialThinkingError, SessionNotActiveError, SessionNotFoundError, SkillDiscoveryError, SkillNotFoundError, SuspensionExpiredError, SuspensionNotFoundError, ToolNotFoundError, ValidationError, getErrorMessage };
+export { ConfigurationError, CycleDetectedError, DuplicateSkillError, DuplicateToolError, ERROR_CODES, HistoryLimitExceededError, InvalidBacktrackError, InvalidEdgeError, InvalidSkillError, InvalidThoughtError, InvalidToolCallError, InvalidToolError, MaxSessionsReachedError, PoolTerminatedError, SequentialThinkingError, SessionNotActiveError, SessionNotFoundError, SkillDiscoveryError, SkillNotFoundError, SuspensionExpiredError, SuspensionNotFoundError, ToolNotFoundError, ValidationError, getErrorMessage, isErrorCode };
 
 //# sourceMappingURL=errors.js.map