@iworkforces/tracelattice 2.0.3

package/dist/core/reasoning.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Reasoning type definitions for advanced sequential thinking.
+ *
+ * Provides type-level constructs for classifying thoughts, computing confidence
+ * signals from reasoning history, and aggregating session analytics.
+ *
+ * @module core/reasoning
+ */
+import type { CalibrationMetrics } from '../contracts/calibrator.js';
+import type { PatternName as ContractPatternName, ThoughtType as ContractThoughtType } from '../contracts/reasoning-types.js';
+export type ThoughtType = ContractThoughtType;
+export type PatternName = ContractPatternName;
+/**
+ * A detected reasoning pattern — surfaced as metadata or a warning.
+ *
+ * @example
+ * ```typescript
+ * const signal: PatternSignal = {
+ *   pattern: 'hypothesis-without-verification',
+ *   severity: 'warning',
+ *   message: 'Hypothesis H1 has no matching verification thought.',
+ *   thought_range: [3, 7],
+ * };
+ * ```
+ */
+export interface PatternSignal {
+    /** Machine-readable pattern identifier. */
+    /** 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. */
+    message: string;
+    /** Thought number range [start, end] where the pattern was detected. */
+    thought_range: [number, number];
+}
+/**
+ * Signals about reasoning quality computed from history.
+ *
+ * These metrics are derived from the thought chain and provide insight into
+ * the depth, breadth, and completeness of the reasoning process.
+ *
+ * @example
+ * ```typescript
+ * const signals: ConfidenceSignals = {
+ *   reasoning_depth: 5,
+ *   revision_count: 1,
+ *   branch_count: 2,
+ *   thought_type_distribution: {
+ *     regular: 3,
+ *     hypothesis: 1,
+ *     verification: 1,
+ *     critique: 0,
+ *     synthesis: 0,
+ *     meta: 0,
+ *   },
+ *   has_hypothesis: true,
+ *   has_verification: true,
+ *   average_confidence: 0.85,
+ *   structural_quality: 0.72,
+ *   quality_components: {
+ *     type_diversity: 0.65,
+ *     verification_coverage: 1.0,
+ *     depth_efficiency: 0.6,
+ *     confidence_stability: 0.85,
+ *   },
+ * };
+ * ```
+ */
+export interface ConfidenceSignals {
+    /** Length of thought chain to this point. */
+    readonly reasoning_depth: number;
+    /** How many revisions in this chain. */
+    readonly revision_count: number;
+    /** Active branches. */
+    readonly branch_count: number;
+    /** Distribution of thought types used. */
+    readonly thought_type_distribution: Record<ThoughtType, number>;
+    /** Whether any hypothesis exists in chain. */
+    readonly has_hypothesis: boolean;
+    /** Whether any verification exists. */
+    readonly has_verification: boolean;
+    /** Mean of explicit confidence values, null if none. */
+    readonly average_confidence: number | null;
+    /**
+     * Composite structural quality score (0-1).
+     * Geometric mean of quality_components with floor of 0.01 per component.
+     * Only present when history has ≥1 thought.
+     */
+    readonly structural_quality?: number;
+    /**
+     * Individual quality components that feed into structural_quality.
+     * Only present when structural_quality is present.
+     */
+    readonly quality_components?: {
+        /** Shannon entropy of thought_type distribution / log2(6), normalized 0-1. */
+        readonly type_diversity: number;
+        /** verified_hypotheses / total_hypotheses. 1.0 if no hypotheses exist. */
+        readonly verification_coverage: number;
+        /** max(chain_depth, branch_count + 1) / total_thoughts, clamped to [0, 1]. Branching is desirable. */
+        readonly depth_efficiency: number;
+        /** 1 - stddev(confidence values). Defaults to 0.5 if no confidence values. Null when fewer than 2 confidence values. */
+        readonly confidence_stability: number | null;
+    };
+    /**
+     * Raw (unfloored) quality components before the 0.01 floor is applied.
+     * Only present when quality_components is present.
+     * Useful for debugging quality score calculations.
+     */
+    readonly quality_components_raw?: {
+        /** Shannon entropy / log2(6) — may be below 0.01 floor. */
+        readonly type_diversity: number;
+        /** verified / total hypotheses — may be below 0.01 floor. */
+        readonly verification_coverage: number;
+        /** depth / total — may be below 0.01 floor. */
+        readonly depth_efficiency: number;
+        /** 1 - stddev — may be below 0.01 floor. Null when fewer than 2 confidence values. */
+        readonly confidence_stability: number | null;
+    };
+    /** Calibrated confidence score (post temperature scaling + prior shrinkage). Only present when features.calibration=true. */
+    readonly calibrated_confidence?: number;
+    /** Calibration quality metrics for the session. Only present when features.calibration=true. */
+    readonly calibration_metrics?: CalibrationMetrics;
+}
+/**
+ * Aggregated analytics about the reasoning session.
+ *
+ * Provides a comprehensive summary of the reasoning process including
+ * thought counts, branch metrics, hypothesis tracking, and quality scores.
+ *
+ * @example
+ * ```typescript
+ * const stats: ReasoningStats = {
+ *   total_thoughts: 12,
+ *   total_branches: 3,
+ *   total_revisions: 2,
+ *   total_merges: 1,
+ *   chain_depth: 8,
+ *   thought_type_counts: {
+ *     regular: 6,
+ *     hypothesis: 2,
+ *     verification: 2,
+ *     critique: 1,
+ *     synthesis: 1,
+ *     meta: 0,
+ *   },
+ *   hypothesis_count: 2,
+ *   verified_hypothesis_count: 1,
+ *   unresolved_hypothesis_count: 1,
+ *   average_quality_score: 0.78,
+ *   average_confidence: 0.82,
+ * };
+ * ```
+ */
+export interface ReasoningStats {
+    /** Total thoughts in session. */
+    readonly total_thoughts: number;
+    /** Total branches created. */
+    readonly total_branches: number;
+    /** Total revision operations. */
+    readonly total_revisions: number;
+    /** Total merge operations (DAG topology). */
+    readonly total_merges: number;
+    /** Longest sequential chain depth. */
+    readonly chain_depth: number;
+    /** Count of each thought type. */
+    readonly thought_type_counts: Record<ThoughtType, number>;
+    /** Hypotheses created. */
+    readonly hypothesis_count: number;
+    /** Hypotheses that have been verified. */
+    readonly verified_hypothesis_count: number;
+    /** Hypotheses without verification. */
+    readonly unresolved_hypothesis_count: number;
+    /** Average quality score across thoughts with scores, null if none. */
+    readonly average_quality_score: number | null;
+    /** Average confidence across thoughts with confidence, null if none. */
+    readonly average_confidence: number | null;
+}
+//# sourceMappingURL=reasoning.d.ts.map

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

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

package/dist/core/reasoning.js

@@ -0,0 +1 @@
+export { };

package/dist/core/step.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Step recommendation type for coordinated multi-step thought processes.
+ *
+ * @module types/step
+ */
+import type { SkillRecommendation } from '../types/skill.js';
+import type { ToolRecommendation } from '../types/tool.js';
+/**
+ * Represents a coordinated step in a multi-step thought process.
+ *
+ * Step recommendations combine tool and skill recommendations to provide
+ * a comprehensive plan for completing a specific task, including expected
+ * outcomes and conditions for moving to the next step.
+ *
+ * @example
+ * ```typescript
+ * const step: StepRecommendation = {
+ *   step_description: 'Search for TypeScript documentation',
+ *   recommended_tools: [
+ *     {
+ *       tool_name: 'mcp__tavily-mcp__tavily-search',
+ *       confidence: 0.9,
+ *       rationale: 'Best for web search',
+ *       priority: 1
+ *     }
+ *   ],
+ *   recommended_skills: [],
+ *   expected_outcome: 'Search results with TypeScript documentation links',
+ *   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. */
+    step_description: string;
+    /** Array of tools recommended for this step, ordered by priority. */
+    recommended_tools: ToolRecommendation[];
+    /** Optional array of skills recommended for this step. */
+    recommended_skills?: SkillRecommendation[];
+    /** Description of what to expect after completing this step. */
+    expected_outcome: string;
+    /** Optional conditions to consider when determining the next step. */
+    next_step_conditions?: string[];
+}
+//# sourceMappingURL=step.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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/step.js

@@ -0,0 +1 @@
+export { };

package/dist/core/thought.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Core data structure for a thought in the sequential thinking process.
+ *
+ * @module types/thought
+ */
+import type { BranchId, SessionId, ThoughtId, SuspensionToken } from '../contracts/ids.js';
+import type { SchemaOutput } from '../schema.js';
+import type { StepRecommendation } from './step.js';
+/**
+ * Core data structure for a thought in the sequential thinking process.
+ *
+ * Thoughts represent individual reasoning steps that can be chained together
+ * to form complex reasoning chains. Each thought can reference previous thoughts,
+ * create branches, and include tool/skill recommendations.
+ *
+ * @remarks
+ * - Thoughts are numbered sequentially within a branch
+ * - Branching allows exploring alternative reasoning paths
+ * - Revisions allow correcting or updating previous thoughts
+ * - The `next_thought_needed` flag controls continuation
+ *
+ * @example
+ * ```typescript
+ * const thought: ThoughtData = {
+ *   available_mcp_tools: ['Read', 'Write', 'Bash'],
+ *   available_skills: ['commit', 'pdf'],
+ *   thought: 'I should read the package.json to understand dependencies',
+ *   thought_number: 1,
+ *   total_thoughts: 5,
+ *   next_thought_needed: true,
+ *   current_step: {
+ *     step_description: 'Read package.json',
+ *     recommended_tools: [{
+ *       tool_name: 'Read',
+ *       confidence: 1.0,
+ *       rationale: 'Direct file reading',
+ *       priority: 1
+ *     }],
+ *     expected_outcome: 'Contents of package.json'
+ *   }
+ * };
+ * ```
+ */
+export type ThoughtData = Omit<SchemaOutput, 'id' | 'session_id' | 'continuation_token' | 'register_branch_id' | 'branch_id' | 'merge_branch_ids' | 'current_step' | 'previous_steps'> & {
+    /** Unique identifier for this thought (branded ThoughtId). Auto-generated when not provided. */
+    id?: ThoughtId;
+    /** Session identifier (branded SessionId) for state isolation. */
+    session_id?: SessionId;
+    /** Continuation token (branded SuspensionToken) linking tool_observation back to suspended tool_call. */
+    continuation_token?: SuspensionToken;
+    /** Branch identifier (branded BranchId) for branching reasoning paths. */
+    branch_id?: BranchId;
+    /** Branch identifiers (branded BranchId[]) being merged into current context. */
+    merge_branch_ids?: BranchId[];
+    /**
+     * When true, this thought has been logically retracted by a subsequent
+     * `backtrack` thought. The thought remains in history (append-only,
+     * event-sourcing) but is excluded from quality calculations.
+     * Default: false. Not part of schema input — set by ThoughtProcessor during processing.
+     */
+    retracted?: boolean;
+    /** Current step recommendation (post-normalization, with defaults filled). */
+    current_step?: StepRecommendation;
+    /** Previously recommended steps (post-normalization, with defaults filled). */
+    previous_steps?: StepRecommendation[];
+};
+/**
+ * Discriminated union variants of `ThoughtData` after `_validateNewTypes`
+ * has guaranteed per-type invariants. Allows downstream methods to consume
+ * narrowed thoughts without `!` non-null assertions.
+ */
+import type { ThoughtType } from './reasoning.js';
+/** A `tool_call` thought with `tool_name` guaranteed by validation. */
+export type ToolCallThought = ThoughtData & {
+    readonly thought_type: 'tool_call';
+    readonly tool_name: string;
+};
+/** A `tool_observation` thought with `continuation_token` guaranteed. */
+export type ToolObservationThought = ThoughtData & {
+    readonly thought_type: 'tool_observation';
+    readonly continuation_token: SuspensionToken;
+};
+/** A `backtrack` thought with `backtrack_target` guaranteed. */
+export type BacktrackThought = ThoughtData & {
+    readonly thought_type: 'backtrack';
+    readonly backtrack_target: number;
+};
+/** A `verification` thought with `verification_target` guaranteed. */
+export type VerificationThought = ThoughtData & {
+    readonly thought_type: 'verification';
+    readonly verification_target: number;
+};
+/** A `critique` thought with `verification_target` guaranteed. */
+export type CritiqueThought = ThoughtData & {
+    readonly thought_type: 'critique';
+    readonly verification_target: number;
+};
+/** A `synthesis` thought with non-empty `synthesis_sources` guaranteed. */
+export type SynthesisThought = ThoughtData & {
+    readonly thought_type: 'synthesis';
+    readonly synthesis_sources: readonly number[];
+};
+/** Catch-all for thought types with no per-type field invariants. */
+export type BaseThought = ThoughtData & {
+    readonly thought_type: Exclude<ThoughtType, 'tool_call' | 'tool_observation' | 'backtrack' | 'verification' | 'critique' | 'synthesis'>;
+};
+/**
+ * Discriminated union of validated thoughts. Returned by
+ * `ThoughtProcessor._validateNewTypes` to encode invariants in the type system
+ * and eliminate `!` non-null assertions in downstream handlers.
+ */
+export type ValidatedThought = ToolCallThought | ToolObservationThought | BacktrackThought | VerificationThought | CritiqueThought | SynthesisThought | BaseThought;
+//# sourceMappingURL=thought.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thought.d.ts","sourceRoot":"","sources":["../../src/core/thought.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAC7B,YAAY,EACV,IAAI,GACJ,YAAY,GACZ,oBAAoB,GACpB,oBAAoB,GACpB,WAAW,GACX,kBAAkB,GAClB,cAAc,GACd,gBAAgB,CAClB,GAAG;IACH,gGAAgG;IAChG,EAAE,CAAC,EAAE,SAAS,CAAC;IAEf,kEAAkE;IAClE,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB,yGAAyG;IACzG,kBAAkB,CAAC,EAAE,eAAe,CAAC;IAErC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,QAAQ,CAAC;IAErB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAC;IAE9B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAElC,+EAA+E;IAC/E,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACtC,CAAC;AAEF;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAC3C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG;IAClD,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,eAAe,CAAC;CAC7C,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC5C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC/C,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAC3C,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC5C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IACvC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAC7B,WAAW,EACX,WAAW,GAAG,kBAAkB,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAC1F,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACzB,eAAe,GACf,sBAAsB,GACtB,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,gBAAgB,GAChB,WAAW,CAAC"}

package/dist/core/thought.js

@@ -0,0 +1 @@
+export { };

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

@@ -0,0 +1,66 @@
+/**
+ * In-memory implementation of {@link ISuspensionStore}.
+ *
+ * Stores suspension records in process memory with optional background
+ * sweeping of expired entries. Suitable for single-process deployments;
+ * cluster setups should provide a shared backend.
+ *
+ * @module core/tools/InMemorySuspensionStore
+ */
+import type { ISuspensionStore, SuspensionRecord } from '../../contracts/suspension.js';
+import { type SessionId, type SuspensionToken } from '../../contracts/ids.js';
+import type { Logger } from '../../logger/StructuredLogger.js';
+/**
+ * Configuration for {@link InMemorySuspensionStore}.
+ */
+export interface InMemorySuspensionStoreConfig {
+    /** Default TTL applied to records that omit `ttlMs`. Defaults to 60_000ms. */
+    ttlMs?: number;
+    /** Sweep interval for the background expiry timer. Defaults to 60_000ms. */
+    sweepIntervalMs?: number;
+    /** Optional logger; reserved for future diagnostic output. */
+    /** Optional logger for diagnostic output. */
+    logger?: Logger;
+}
+/**
+ * In-memory suspension store with TTL expiry and background sweep.
+ *
+ * @example
+ * ```typescript
+ * const store = new InMemorySuspensionStore({ ttlMs: 30_000 });
+ * store.start();
+ * const rec = store.suspend({
+ *   sessionId: 's1',
+ *   toolCallThoughtNumber: 3,
+ *   toolCallThoughtId: 'thought-3',
+ *   toolName: 'search',
+ *   toolArguments: { q: 'foo' },
+ *   expiresAt: 0,
+ * });
+ * const resumed = store.resume(rec.token);
+ * store.stop();
+ * ```
+ */
+export declare class InMemorySuspensionStore implements ISuspensionStore {
+    private readonly _byToken;
+    private readonly _bySession;
+    private readonly _admissionTails;
+    private readonly _ttlMs;
+    private readonly _sweepIntervalMs;
+    private _timer;
+    constructor(config?: InMemorySuspensionStoreConfig);
+    suspend(record: Omit<SuspensionRecord, 'token' | 'createdAt'> & {
+        ttlMs?: number;
+    }): SuspensionRecord;
+    resume(token: string): SuspensionRecord | null;
+    compareAndAdmit(token: SuspensionToken, expectedSessionId: SessionId, admit: (record: SuspensionRecord) => void): Promise<SuspensionRecord>;
+    peek(token: string): SuspensionRecord | null;
+    expireOlderThan(now: number): number;
+    clearSession(sessionId: string): void;
+    clearAll(): void;
+    size(sessionId?: string): number;
+    start(): void;
+    stop(): void;
+    private _delete;
+}
+//# sourceMappingURL=InMemorySuspensionStore.d.ts.map

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

@@ -0,0 +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;AACxF,OAAO,EAGN,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAG/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;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqD;IAC9E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmD;IAC9E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkD;IAClF,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;IA4BnB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAWxC,eAAe,CACpB,KAAK,EAAE,eAAe,EACtB,iBAAiB,EAAE,SAAS,EAC5B,KAAK,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GACvC,OAAO,CAAC,gBAAgB,CAAC;IAsC5B,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,QAAQ,IAAI,IAAI;IAKhB,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

@@ -0,0 +1,121 @@
+import { asSessionId, generateSuspensionToken } from "../../contracts/ids.js";
+import { SuspensionExpiredError, SuspensionNotFoundError } from "../../errors.js";
+const DEFAULT_TTL_MS = 300000;
+const DEFAULT_SWEEP_INTERVAL_MS = 60000;
+class InMemorySuspensionStore {
+    _byToken = new Map();
+    _bySession = new Map();
+    _admissionTails = new Map();
+    _ttlMs;
+    _sweepIntervalMs;
+    _timer = null;
+    constructor(config = {}){
+        this._ttlMs = config.ttlMs ?? DEFAULT_TTL_MS;
+        this._sweepIntervalMs = config.sweepIntervalMs ?? DEFAULT_SWEEP_INTERVAL_MS;
+    }
+    suspend(record) {
+        const token = generateSuspensionToken();
+        const createdAt = Date.now();
+        const ttlMs = record.ttlMs ?? this._ttlMs;
+        const expiresAt = createdAt + ttlMs;
+        const full = {
+            token,
+            sessionId: record.sessionId,
+            toolCallThoughtNumber: record.toolCallThoughtNumber,
+            toolCallThoughtId: record.toolCallThoughtId,
+            toolName: record.toolName,
+            toolArguments: record.toolArguments,
+            createdAt,
+            expiresAt
+        };
+        this._byToken.set(token, full);
+        let bucket = this._bySession.get(full.sessionId);
+        if (!bucket) {
+            bucket = new Set();
+            this._bySession.set(full.sessionId, bucket);
+        }
+        bucket.add(token);
+        return full;
+    }
+    resume(token) {
+        const rec = this._byToken.get(token);
+        if (!rec) return null;
+        if (rec.expiresAt <= Date.now()) {
+            this._delete(token, rec.sessionId);
+            return null;
+        }
+        this._delete(token, rec.sessionId);
+        return rec;
+    }
+    async compareAndAdmit(token, expectedSessionId, admit) {
+        const previous = this._admissionTails.get(token) ?? Promise.resolve();
+        const release = Promise.withResolvers();
+        const tail = previous.then(()=>release.promise, ()=>release.promise);
+        this._admissionTails.set(token, tail);
+        try {
+            await previous.then(()=>void 0, ()=>void 0);
+            const record = this._byToken.get(token);
+            if (void 0 === record) throw new SuspensionNotFoundError('Suspension token not found: ' + token);
+            const now = Date.now();
+            if (record.expiresAt <= now) {
+                this._delete(token, record.sessionId);
+                throw new SuspensionExpiredError('Suspension token expired: ' + token);
+            }
+            if (record.sessionId !== expectedSessionId) throw new SuspensionNotFoundError('Suspension token not found: ' + token);
+            admit(record);
+            this._delete(token, record.sessionId);
+            return record;
+        } finally{
+            release.resolve();
+            if (this._admissionTails.get(token) === tail) this._admissionTails.delete(token);
+        }
+    }
+    peek(token) {
+        return this._byToken.get(token) ?? null;
+    }
+    expireOlderThan(now) {
+        let removed = 0;
+        for (const [token, rec] of this._byToken)if (rec.expiresAt <= now) {
+            this._delete(token, rec.sessionId);
+            removed++;
+        }
+        return removed;
+    }
+    clearSession(sessionId) {
+        const bucket = this._bySession.get(asSessionId(sessionId));
+        if (!bucket) return;
+        for (const token of bucket)this._byToken.delete(token);
+        this._bySession.delete(asSessionId(sessionId));
+    }
+    clearAll() {
+        this._byToken.clear();
+        this._bySession.clear();
+    }
+    size(sessionId) {
+        if (void 0 === sessionId) return this._byToken.size;
+        return this._bySession.get(asSessionId(sessionId))?.size ?? 0;
+    }
+    start() {
+        if (null !== this._timer) return;
+        this._timer = setInterval(()=>{
+            this.expireOlderThan(Date.now());
+        }, this._sweepIntervalMs);
+        this._timer.unref?.();
+    }
+    stop() {
+        if (null === this._timer) return;
+        clearInterval(this._timer);
+        this._timer = null;
+    }
+    _delete(token, sessionId) {
+        this._byToken.delete(token);
+        const bucket = this._bySession.get(sessionId);
+        if (bucket) {
+            bucket.delete(token);
+            if (0 === bucket.size) this._bySession.delete(sessionId);
+        }
+    }
+}
+export { InMemorySuspensionStore };
+
+//# sourceMappingURL=InMemorySuspensionStore.js.map

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

@@ -0,0 +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 {\n\tgenerateSuspensionToken,\n\tasSessionId,\n\ttype SessionId,\n\ttype SuspensionToken,\n} from '../../contracts/ids.js';\nimport type { Logger } from '../../logger/StructuredLogger.js';\nimport { SuspensionExpiredError, SuspensionNotFoundError } from '../../errors.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 *   toolCallThoughtId: 'thought-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<SuspensionToken, SuspensionRecord> = new Map();\n\tprivate readonly _bySession: Map<SessionId, Set<SuspensionToken>> = new Map();\n\tprivate readonly _admissionTails: Map<SuspensionToken, Promise<void>> = 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\ttoolCallThoughtId: record.toolCallThoughtId,\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 as SuspensionToken);\n\t\tif (!rec) return null;\n\t\tif (rec.expiresAt <= Date.now()) {\n\t\t\tthis._delete(token as SuspensionToken, rec.sessionId);\n\t\t\treturn null;\n\t\t}\n\t\tthis._delete(token as SuspensionToken, rec.sessionId);\n\t\treturn rec;\n\t}\n\n\tasync compareAndAdmit(\n\t\ttoken: SuspensionToken,\n\t\texpectedSessionId: SessionId,\n\t\tadmit: (record: SuspensionRecord) => void\n\t): Promise<SuspensionRecord> {\n\t\tconst previous = this._admissionTails.get(token) ?? Promise.resolve();\n\t\tconst release = Promise.withResolvers<void>();\n\t\tconst tail = previous.then(\n\t\t\t() => release.promise,\n\t\t\t() => release.promise\n\t\t);\n\t\tthis._admissionTails.set(token, tail);\n\n\t\ttry {\n\t\t\tawait previous.then(\n\t\t\t\t() => undefined,\n\t\t\t\t() => undefined\n\t\t\t);\n\t\t\tconst record = this._byToken.get(token);\n\t\t\tif (record === undefined) {\n\t\t\t\tthrow new SuspensionNotFoundError('Suspension token not found: ' + token);\n\t\t\t}\n\t\t\tconst now = Date.now();\n\t\t\tif (record.expiresAt <= now) {\n\t\t\t\tthis._delete(token, record.sessionId);\n\t\t\t\tthrow new SuspensionExpiredError('Suspension token expired: ' + token);\n\t\t\t}\n\t\t\tif (record.sessionId !== expectedSessionId) {\n\t\t\t\tthrow new SuspensionNotFoundError('Suspension token not found: ' + token);\n\t\t\t}\n\n\t\t\tadmit(record);\n\t\t\tthis._delete(token, record.sessionId);\n\t\t\treturn record;\n\t\t} finally {\n\t\t\trelease.resolve();\n\t\t\tif (this._admissionTails.get(token) === tail) {\n\t\t\t\tthis._admissionTails.delete(token);\n\t\t\t}\n\t\t}\n\t}\n\n\tpeek(token: string): SuspensionRecord | null {\n\t\treturn this._byToken.get(token as SuspensionToken) ?? 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(asSessionId(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(asSessionId(sessionId));\n\t}\n\n\tclearAll(): void {\n\t\tthis._byToken.clear();\n\t\tthis._bySession.clear();\n\t}\n\n\tsize(sessionId?: string): number {\n\t\tif (sessionId === undefined) return this._byToken.size;\n\t\treturn this._bySession.get(asSessionId(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: SuspensionToken, sessionId: SessionId): 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","expectedSessionId","admit","previous","Promise","release","tail","undefined","SuspensionNotFoundError","now","SuspensionExpiredError","removed","sessionId","asSessionId","setInterval","clearInterval"],"mappings":"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"}