@j0hanz/thinkseq-mcp 1.0.5 → 1.1.0

package/dist/engine.js

@@ -1,177 +1,83 @@
-import { publishEngineEvent } from './lib/diagnostics.js';
-const DEFAULT_MAX_THOUGHTS = 500;
-const MAX_THOUGHTS_CAP = 10000;
-const MAX_MEMORY_BYTES = 100 * 1024 * 1024;
-const ESTIMATED_THOUGHT_OVERHEAD_BYTES = 200;
-function normalizeInt(value, fallback, options) {
-    if (typeof value !== 'number' || !Number.isFinite(value))
-        return fallback;
-    return Math.max(options.min, Math.min(options.max, Math.trunc(value)));
-}
+import { resolveRevisionTarget } from './engine/revision.js';
+import { buildContextSummary } from './engine/thoughtQueries.js';
+import { ThoughtStore } from './engine/thoughtStore.js';
+import { DEFAULT_MAX_THOUGHTS, ESTIMATED_THOUGHT_OVERHEAD_BYTES, MAX_MEMORY_BYTES, MAX_THOUGHTS_CAP, normalizeInt, } from './engineConfig.js';
 export class ThinkingEngine {
-    #thoughts = [];
-    #branches = new Map();
-    #branchIdsCache = [];
-    #branchIdsDirty = true;
-    #estimatedBytes = 0;
-    #revisionCount = 0;
-    #maxThoughts;
-    #maxMemoryBytes;
-    #estimatedThoughtOverheadBytes;
+    #store;
+    #hasRevisions = false;
     constructor(options = {}) {
-        this.#maxThoughts = normalizeInt(options.maxThoughts, DEFAULT_MAX_THOUGHTS, { min: 1, max: MAX_THOUGHTS_CAP });
-        this.#maxMemoryBytes = normalizeInt(options.maxMemoryBytes, MAX_MEMORY_BYTES, { min: 1, max: Number.MAX_SAFE_INTEGER });
-        this.#estimatedThoughtOverheadBytes = normalizeInt(options.estimatedThoughtOverheadBytes, ESTIMATED_THOUGHT_OVERHEAD_BYTES, { min: 1, max: Number.MAX_SAFE_INTEGER });
+        const maxThoughts = normalizeInt(options.maxThoughts, DEFAULT_MAX_THOUGHTS, { min: 1, max: MAX_THOUGHTS_CAP });
+        const maxMemoryBytes = normalizeInt(options.maxMemoryBytes, MAX_MEMORY_BYTES, { min: 1, max: Number.MAX_SAFE_INTEGER });
+        const estimatedThoughtOverheadBytes = normalizeInt(options.estimatedThoughtOverheadBytes, ESTIMATED_THOUGHT_OVERHEAD_BYTES, { min: 1, max: Number.MAX_SAFE_INTEGER });
+        this.#store = new ThoughtStore({
+            maxThoughts,
+            maxMemoryBytes,
+            estimatedThoughtOverheadBytes,
+        });
     }
     processThought(input) {
-        this.#validateThoughtNumber(input);
-        this.#validateReferences(input);
-        const totalThoughts = Math.max(input.totalThoughts, input.thoughtNumber);
-        const stored = {
+        if (input.revisesThought !== undefined) {
+            return this.#processRevision(input);
+        }
+        return this.#processNewThought(input);
+    }
+    #processNewThought(input) {
+        const numbers = this.#store.nextThoughtNumbers(input.totalThoughts);
+        const stored = this.#buildStoredThought(input, numbers);
+        this.#store.storeThought(stored);
+        this.#store.pruneHistoryIfNeeded();
+        return this.#buildProcessResult(stored);
+    }
+    #processRevision(input) {
+        const resolved = resolveRevisionTarget(input, (thoughtNumber) => this.#store.getThoughtByNumber(thoughtNumber));
+        if (!resolved.ok)
+            return resolved.error;
+        const { targetNumber } = resolved;
+        const numbers = this.#store.nextThoughtNumbers(input.totalThoughts);
+        const supersedes = this.#store.supersedeFrom(targetNumber, numbers.thoughtNumber);
+        const stored = this.#buildStoredThought(input, {
+            ...numbers,
+            revisionOf: targetNumber,
+        });
+        this.#store.storeThought(stored);
+        this.#hasRevisions = true;
+        this.#store.pruneHistoryIfNeeded();
+        return this.#buildProcessResult(stored, {
+            revises: targetNumber,
+            supersedes,
+        });
+    }
+    #buildStoredThought(input, details) {
+        return {
             ...input,
-            totalThoughts,
+            thoughtNumber: details.thoughtNumber,
+            totalThoughts: details.totalThoughts,
             timestamp: Date.now(),
+            isActive: true,
+            ...(details.revisionOf !== undefined && {
+                revisionOf: details.revisionOf,
+            }),
         };
-        this.#thoughts.push(stored);
-        this.#estimatedBytes += this.#estimateThoughtBytes(stored);
-        if (stored.isRevision)
-            this.#revisionCount += 1;
-        if (stored.branchId) {
-            const branch = this.#branches.get(stored.branchId);
-            if (branch)
-                branch.push(stored);
-            else {
-                this.#branches.set(stored.branchId, [stored]);
-                this.#branchIdsDirty = true;
-            }
-        }
-        this.#pruneHistoryIfNeeded();
-        const context = this.#buildContextSummary();
+    }
+    #buildProcessResult(stored, revisionInfo) {
+        const activeThoughts = this.#store.getActiveThoughts();
+        const context = buildContextSummary(activeThoughts, revisionInfo);
+        const isComplete = stored.thoughtNumber >= stored.totalThoughts;
+        const revisableThoughts = this.#store.getActiveThoughtNumbers().slice();
         return {
             ok: true,
             result: {
                 thoughtNumber: stored.thoughtNumber,
                 totalThoughts: stored.totalThoughts,
                 progress: Math.min(1, stored.thoughtNumber / stored.totalThoughts),
-                nextThoughtNeeded: input.nextThoughtNeeded,
-                thoughtHistoryLength: this.#thoughts.length,
-                branches: this.#getBranchIds(),
+                isComplete,
+                thoughtHistoryLength: this.#store.getTotalLength(),
+                hasRevisions: this.#hasRevisions,
+                activePathLength: activeThoughts.length,
+                revisableThoughts,
                 context,
             },
         };
     }
-    #getBranchIds() {
-        if (this.#branchIdsDirty) {
-            this.#branchIdsCache = Array.from(this.#branches.keys());
-            this.#branchIdsDirty = false;
-        }
-        return this.#branchIdsCache;
-    }
-    #buildContextSummary() {
-        const recent = this.#thoughts.slice(-5);
-        const currentBranch = this.#thoughts.at(-1)?.branchId;
-        return {
-            recentThoughts: recent.map((t) => {
-                const base = {
-                    number: t.thoughtNumber,
-                    preview: t.thought.slice(0, 100) + (t.thought.length > 100 ? '...' : ''),
-                };
-                return t.thoughtType ? { ...base, type: t.thoughtType } : base;
-            }),
-            ...(currentBranch !== undefined ? { currentBranch } : {}),
-            hasRevisions: this.#revisionCount > 0,
-        };
-    }
-    #validateThoughtNumber(input) {
-        const lastThought = this.#thoughts.at(-1);
-        if (!lastThought) {
-            this.#ensureFirstThought(input.thoughtNumber);
-            return;
-        }
-        if (this.#isRevisionOrBranch(input))
-            return;
-        this.#warnOnSequenceGap(lastThought, input.thoughtNumber);
-    }
-    #ensureFirstThought(thoughtNumber) {
-        if (thoughtNumber === 1)
-            return;
-        throw new Error(`First thought must be number 1, got ${String(thoughtNumber)}`);
-    }
-    #isRevisionOrBranch(input) {
-        return input.isRevision === true || input.branchFromThought !== undefined;
-    }
-    #warnOnSequenceGap(lastThought, thoughtNumber) {
-        if (thoughtNumber === lastThought.thoughtNumber + 1)
-            return;
-        publishEngineEvent({
-            type: 'engine.sequence_gap',
-            ts: Date.now(),
-            expected: lastThought.thoughtNumber + 1,
-            received: thoughtNumber,
-        });
-    }
-    #validateReferences(input) {
-        const maxThoughtNumber = this.#thoughts.at(-1)?.thoughtNumber ?? 0;
-        this.#assertValidReference('revisesThought', input.revisesThought, maxThoughtNumber);
-        this.#assertValidReference('branchFromThought', input.branchFromThought, maxThoughtNumber);
-    }
-    #assertValidReference(field, value, max) {
-        if (value === undefined || value <= max)
-            return;
-        throw new Error(`${field} ${String(value)} references non-existent thought (max: ${String(max)})`);
-    }
-    #pruneHistoryIfNeeded() {
-        const excess = this.#thoughts.length - this.#maxThoughts;
-        if (excess > 0) {
-            const batch = Math.max(excess, Math.ceil(this.#maxThoughts * 0.1));
-            this.#removeOldest(batch);
-        }
-        if (this.#estimatedBytes > this.#maxMemoryBytes &&
-            this.#thoughts.length > 10) {
-            const toRemove = Math.ceil(this.#thoughts.length * 0.2);
-            this.#removeOldest(toRemove);
-        }
-    }
-    #estimateThoughtBytes(thought) {
-        return thought.thought.length * 2 + this.#estimatedThoughtOverheadBytes;
-    }
-    #removeOldest(count) {
-        if (count <= 0 || this.#thoughts.length === 0)
-            return;
-        const actual = Math.min(count, this.#thoughts.length);
-        const removed = this.#thoughts.splice(0, actual);
-        if (removed.length === 0)
-            return;
-        this.#applyRemoval(removed);
-    }
-    #applyRemoval(removed) {
-        const branchRemovals = this.#collectBranchRemovals(removed);
-        for (const [branchId, removeCount] of branchRemovals) {
-            this.#trimBranch(branchId, removeCount);
-        }
-    }
-    #collectBranchRemovals(removed) {
-        const branchRemovals = new Map();
-        for (const thought of removed) {
-            this.#estimatedBytes -= this.#estimateThoughtBytes(thought);
-            if (thought.isRevision)
-                this.#revisionCount -= 1;
-            if (!thought.branchId)
-                continue;
-            branchRemovals.set(thought.branchId, (branchRemovals.get(thought.branchId) ?? 0) + 1);
-        }
-        return branchRemovals;
-    }
-    #trimBranch(branchId, removeCount) {
-        const branch = this.#branches.get(branchId);
-        if (!branch)
-            return;
-        if (removeCount >= branch.length) {
-            this.#branches.delete(branchId);
-            this.#branchIdsDirty = true;
-            return;
-        }
-        branch.splice(0, removeCount);
-    }
 }
 //# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ1D,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACjC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAC3C,MAAM,gCAAgC,GAAG,GAAG,CAAC;AAQ7C,SAAS,YAAY,CACnB,KAAyB,EACzB,QAAgB,EAChB,OAAqC;IAErC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,OAAO,cAAc;IACzB,SAAS,GAAoB,EAAE,CAAC;IAChC,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC/C,eAAe,GAAa,EAAE,CAAC;IAC/B,eAAe,GAAG,IAAI,CAAC;IACvB,eAAe,GAAG,CAAC,CAAC;IACpB,cAAc,GAAG,CAAC,CAAC;IACV,YAAY,CAAS;IACrB,eAAe,CAAS;IACxB,8BAA8B,CAAS;IAEhD,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,YAAY,GAAG,YAAY,CAC9B,OAAO,CAAC,WAAW,EACnB,oBAAoB,EACpB,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAClC,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,YAAY,CACjC,OAAO,CAAC,cAAc,EACtB,gBAAgB,EAChB,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,gBAAgB,EAAE,CACzC,CAAC;QACF,IAAI,CAAC,8BAA8B,GAAG,YAAY,CAChD,OAAO,CAAC,6BAA6B,EACrC,gCAAgC,EAChC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,gBAAgB,EAAE,CACzC,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,KAAkB;QAC/B,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QACzE,MAAM,MAAM,GAAkB;YAC5B,GAAG,KAAK;YACR,aAAa;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,UAAU;YAAE,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACnD,IAAI,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;iBAC3B,CAAC;gBACJ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC9C,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5C,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE;gBACN,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;gBAClE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;gBAC3C,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE;gBAC9B,OAAO;aACR;SACF,CAAC;IACJ,CAAC;IAED,aAAa;QACX,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,oBAAoB;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;QACtD,OAAO;YACL,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC/B,MAAM,IAAI,GAAG;oBACX,MAAM,EAAE,CAAC,CAAC,aAAa;oBACvB,OAAO,EACL,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;iBAClE,CAAC;gBACF,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACjE,CAAC,CAAC;YACF,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,YAAY,EAAE,IAAI,CAAC,cAAc,GAAG,CAAC;SACtC,CAAC;IACJ,CAAC;IAED,sBAAsB,CAAC,KAAkB;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;YAAE,OAAO;QAC5C,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAC5D,CAAC;IAED,mBAAmB,CAAC,aAAqB;QACvC,IAAI,aAAa,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,IAAI,KAAK,CACb,uCAAuC,MAAM,CAAC,aAAa,CAAC,EAAE,CAC/D,CAAC;IACJ,CAAC;IAED,mBAAmB,CAAC,KAAkB;QACpC,OAAO,KAAK,CAAC,UAAU,KAAK,IAAI,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAC;IAC5E,CAAC;IAED,kBAAkB,CAAC,WAA0B,EAAE,aAAqB;QAClE,IAAI,aAAa,KAAK,WAAW,CAAC,aAAa,GAAG,CAAC;YAAE,OAAO;QAC5D,kBAAkB,CAAC;YACjB,IAAI,EAAE,qBAAqB;YAC3B,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,QAAQ,EAAE,WAAW,CAAC,aAAa,GAAG,CAAC;YACvC,QAAQ,EAAE,aAAa;SACxB,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB,CAAC,KAAkB;QACpC,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,qBAAqB,CACxB,gBAAgB,EAChB,KAAK,CAAC,cAAc,EACpB,gBAAgB,CACjB,CAAC;QACF,IAAI,CAAC,qBAAqB,CACxB,mBAAmB,EACnB,KAAK,CAAC,iBAAiB,EACvB,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED,qBAAqB,CACnB,KAAa,EACb,KAAyB,EACzB,GAAW;QAEX,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,IAAI,GAAG;YAAE,OAAO;QAChD,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,0CAA0C,MAAM,CAAC,GAAG,CAAC,GAAG,CAClF,CAAC;IACJ,CAAC;IAED,qBAAqB;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC;QACzD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC;YACnE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QAED,IACE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe;YAC3C,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,EAC1B,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;YACxD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,qBAAqB,CAAC,OAAsB;QAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,8BAA8B,CAAC;IAC1E,CAAC;IAED,aAAa,CAAC,KAAa;QACzB,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACjC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,aAAa,CAAC,OAAwB;QACpC,MAAM,cAAc,GAAG,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC5D,KAAK,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,cAAc,EAAE,CAAC;YACrD,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,sBAAsB,CAAC,OAAwB;QAC7C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;QACjD,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAC5D,IAAI,OAAO,CAAC,UAAU;gBAAE,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,OAAO,CAAC,QAAQ;gBAAE,SAAS;YAChC,cAAc,CAAC,GAAG,CAChB,OAAO,CAAC,QAAQ,EAChB,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAChD,CAAC;QACJ,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,WAAW,CAAC,QAAgB,EAAE,WAAmB;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAChC,CAAC;CACF"}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/engineConfig.d.ts

@@ -0,0 +1,11 @@
+export declare const DEFAULT_MAX_THOUGHTS = 500;
+export declare const MAX_THOUGHTS_CAP = 10000;
+export declare const MAX_MEMORY_BYTES: number;
+export declare const ESTIMATED_THOUGHT_OVERHEAD_BYTES = 200;
+export declare const COMPACT_THRESHOLD = 1024;
+export declare const COMPACT_RATIO = 0.5;
+export declare function normalizeInt(value: number | undefined, fallback: number, options: {
+    min: number;
+    max: number;
+}): number;
+//# sourceMappingURL=engineConfig.d.ts.map

package/dist/engineConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineConfig.d.ts","sourceRoot":"","sources":["../src/engineConfig.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AACtC,eAAO,MAAM,gBAAgB,QAAoB,CAAC;AAClD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpC,MAAM,CAGR"}

package/dist/engineConfig.js

@@ -0,0 +1,12 @@
+export const DEFAULT_MAX_THOUGHTS = 500;
+export const MAX_THOUGHTS_CAP = 10000;
+export const MAX_MEMORY_BYTES = 100 * 1024 * 1024;
+export const ESTIMATED_THOUGHT_OVERHEAD_BYTES = 200;
+export const COMPACT_THRESHOLD = 1024;
+export const COMPACT_RATIO = 0.5;
+export function normalizeInt(value, fallback, options) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return fallback;
+    return Math.max(options.min, Math.min(options.max, Math.trunc(value)));
+}
+//# sourceMappingURL=engineConfig.js.map

package/dist/engineConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineConfig.js","sourceRoot":"","sources":["../src/engineConfig.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAClD,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,CAAC;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AACtC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,MAAM,UAAU,YAAY,CAC1B,KAAyB,EACzB,QAAgB,EAChB,OAAqC;IAErC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/index.js

@@ -1,9 +1,42 @@
 #!/usr/bin/env node
 import { installProcessErrorHandlers, run } from './app.js';
+import { ThinkingEngine } from './engine.js';
+import { getCliHelpText, parseCliConfig } from './lib/cli.js';
 installProcessErrorHandlers();
-run().catch((err) => {
+const fatal = (err) => {
     const message = err instanceof Error ? err.message : String(err);
     console.error(`thinkseq: fatal: ${message}`);
     process.exit(1);
-});
+};
+const printHelpAndExit = () => {
+    console.log(getCliHelpText());
+    process.exit(0);
+};
+const buildEngineOptions = (config) => {
+    const options = {};
+    if (config.maxThoughts !== undefined)
+        options.maxThoughts = config.maxThoughts;
+    if (config.maxMemoryBytes !== undefined)
+        options.maxMemoryBytes = config.maxMemoryBytes;
+    return options;
+};
+const buildRunDependencies = (config) => {
+    const engineOptions = buildEngineOptions(config);
+    return {
+        ...(config.packageReadTimeoutMs !== undefined && {
+            packageReadTimeoutMs: config.packageReadTimeoutMs,
+        }),
+        ...(config.shutdownTimeoutMs !== undefined && {
+            shutdownTimeoutMs: config.shutdownTimeoutMs,
+        }),
+        engineFactory: () => new ThinkingEngine(engineOptions),
+    };
+};
+const runCli = async () => {
+    const { config, help } = parseCliConfig();
+    if (help)
+        printHelpAndExit();
+    await run(buildRunDependencies(config));
+};
+void runCli().catch(fatal);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,2BAA2B,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE5D,2BAA2B,EAAE,CAAC;AAE9B,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC3B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,2BAA2B,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9D,2BAA2B,EAAE,CAAC;AAI9B,MAAM,KAAK,GAAG,CAAC,GAAY,EAAS,EAAE;IACpC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,GAAU,EAAE;IACnC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,MAG3B,EAAyB,EAAE;IAC1B,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;QAClC,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAC3C,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS;QACrC,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;IACjD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,MAAiB,EAAmB,EAAE;IAClE,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO;QACL,GAAG,CAAC,MAAM,CAAC,oBAAoB,KAAK,SAAS,IAAI;YAC/C,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;SAClD,CAAC;QACF,GAAG,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS,IAAI;YAC5C,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;SAC5C,CAAC;QACF,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,cAAc,CAAC,aAAa,CAAC;KACvD,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;IACvC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAC;IAC1C,IAAI,IAAI;QAAE,gBAAgB,EAAE,CAAC;IAC7B,MAAM,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,KAAK,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC"}

package/dist/lib/cli.d.ts

@@ -0,0 +1,14 @@
+interface CliConfig {
+    maxThoughts?: number;
+    maxMemoryBytes?: number;
+    shutdownTimeoutMs?: number;
+    packageReadTimeoutMs?: number;
+}
+export interface CliParseResult {
+    config: CliConfig;
+    help: boolean;
+}
+export declare function getCliHelpText(): string;
+export declare function parseCliConfig(args?: readonly string[]): CliParseResult;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/lib/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":"AAEA,UAAU,SAAS;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAuFD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAMvE"}

package/dist/lib/cli.js

@@ -0,0 +1,71 @@
+import { parseArgs } from 'node:util';
+const PARSE_CONFIG = {
+    options: {
+        'max-thoughts': { type: 'string' },
+        'max-memory-mb': { type: 'string' },
+        'shutdown-timeout-ms': { type: 'string' },
+        'package-read-timeout-ms': { type: 'string' },
+        help: { type: 'boolean', short: 'h' },
+    },
+    strict: true,
+    allowPositionals: false,
+    allowNegative: false,
+};
+const HELP_TEXT = `Usage: thinkseq [options]
+
+Options:
+  --max-thoughts <number>          Max thoughts to keep in memory
+  --max-memory-mb <number>         Max memory (MB) for stored thoughts
+  --shutdown-timeout-ms <number>   Graceful shutdown timeout
+  --package-read-timeout-ms <number>  Package.json read timeout
+  -h, --help                       Show this help`;
+const BYTES_PER_MB = 1024 * 1024;
+function parsePositiveInt(value, label) {
+    if (value === undefined)
+        return undefined;
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`Invalid ${label}: ${value}`);
+    }
+    return parsed;
+}
+function getParsedValues(args) {
+    if (args) {
+        return parseArgs({ ...PARSE_CONFIG, args }).values;
+    }
+    return parseArgs(PARSE_CONFIG).values;
+}
+function getStringOption(values, key) {
+    const value = values[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function buildCliConfig(values) {
+    const maxThoughts = parsePositiveInt(getStringOption(values, 'max-thoughts'), 'max-thoughts');
+    const maxMemoryMb = parsePositiveInt(getStringOption(values, 'max-memory-mb'), 'max-memory-mb');
+    const shutdownTimeoutMs = parsePositiveInt(getStringOption(values, 'shutdown-timeout-ms'), 'shutdown-timeout-ms');
+    const packageReadTimeoutMs = parsePositiveInt(getStringOption(values, 'package-read-timeout-ms'), 'package-read-timeout-ms');
+    const config = {};
+    if (maxThoughts !== undefined)
+        config.maxThoughts = maxThoughts;
+    if (maxMemoryMb !== undefined) {
+        config.maxMemoryBytes = maxMemoryMb * BYTES_PER_MB;
+    }
+    if (shutdownTimeoutMs !== undefined) {
+        config.shutdownTimeoutMs = shutdownTimeoutMs;
+    }
+    if (packageReadTimeoutMs !== undefined) {
+        config.packageReadTimeoutMs = packageReadTimeoutMs;
+    }
+    return config;
+}
+export function getCliHelpText() {
+    return HELP_TEXT;
+}
+export function parseCliConfig(args) {
+    const values = getParsedValues(args);
+    return {
+        help: values.help === true,
+        config: buildCliConfig(values),
+    };
+}
+//# sourceMappingURL=cli.js.map

package/dist/lib/cli.js.map

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

package/dist/lib/context.d.ts

@@ -0,0 +1,7 @@
+export interface RequestContext {
+    requestId: string;
+    startedAt: number;
+}
+export declare function runWithContext<T>(callback: () => T, context?: Partial<RequestContext>): T;
+export declare function getRequestContext(): RequestContext | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/lib/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/lib/context.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,cAAc,CAAC,CAAC,EAC9B,QAAQ,EAAE,MAAM,CAAC,EACjB,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,CAAC,CAMH;AAED,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D"}

package/dist/lib/context.js

@@ -0,0 +1,15 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomUUID } from 'node:crypto';
+import { performance } from 'node:perf_hooks';
+const storage = new AsyncLocalStorage();
+export function runWithContext(callback, context) {
+    const store = {
+        requestId: context?.requestId ?? randomUUID(),
+        startedAt: context?.startedAt ?? performance.now(),
+    };
+    return storage.run(store, callback);
+}
+export function getRequestContext() {
+    return storage.getStore();
+}
+//# sourceMappingURL=context.js.map

package/dist/lib/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/lib/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAO9C,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAkB,CAAC;AAExD,MAAM,UAAU,cAAc,CAC5B,QAAiB,EACjB,OAAiC;IAEjC,MAAM,KAAK,GAAmB;QAC5B,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE;QAC7C,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,WAAW,CAAC,GAAG,EAAE;KACnD,CAAC;IACF,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/lib/diagnostics.d.ts

@@ -1,4 +1,8 @@
-export type ToolEvent = {
+interface EventContext {
+    requestId: string;
+    startedAt: number;
+}
+type ToolEventBase = {
     type: 'tool.start';
     tool: 'thinkseq';
     ts: number;
@@ -17,6 +21,9 @@ export type ToolEvent = {
     errorMessage: string;
     durationMs?: number;
 };
+export type ToolEvent = ToolEventBase & {
+    context?: EventContext;
+};
 export type LifecycleEvent = {
     type: 'lifecycle.started';
     ts: number;
@@ -25,13 +32,7 @@ export type LifecycleEvent = {
     ts: number;
     signal: string;
 };
-export interface EngineEvent {
-    type: 'engine.sequence_gap';
-    ts: number;
-    expected: number;
-    received: number;
-}
 export declare function publishToolEvent(event: ToolEvent): void;
 export declare function publishLifecycleEvent(event: LifecycleEvent): void;
-export declare function publishEngineEvent(event: EngineEvent): void;
+export {};
 //# sourceMappingURL=diagnostics.d.ts.map

package/dist/lib/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/lib/diagnostics.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GACjB;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,IAAI,CAAC;IACT,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,KAAK,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAkBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAEvD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAEjE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAE3D"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/lib/diagnostics.ts"],"names":[],"mappings":"AAIA,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,aAAa,GACd;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,IAAI,CAAC;IACT,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,KAAK,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG;IAAE,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA8B/D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAEvD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAEjE"}

package/dist/lib/diagnostics.js

@@ -1,7 +1,7 @@
-import diagnostics_channel from 'node:diagnostics_channel';
-const toolChannel = diagnostics_channel.channel('thinkseq:tool');
-const lifecycleChannel = diagnostics_channel.channel('thinkseq:lifecycle');
-const engineChannel = diagnostics_channel.channel('thinkseq:engine');
+import diagnosticsChannel from 'node:diagnostics_channel';
+import { getRequestContext } from './context.js';
+const toolChannel = diagnosticsChannel.channel('thinkseq:tool');
+const lifecycleChannel = diagnosticsChannel.channel('thinkseq:lifecycle');
 function safePublish(channel, message) {
     if (!channel.hasSubscribers)
         return;
@@ -12,13 +12,23 @@ function safePublish(channel, message) {
         // Intentional suppression of publication errors
     }
 }
+function attachContext(event) {
+    const context = getRequestContext();
+    if (!context)
+        return event;
+    return {
+        ...event,
+        context: {
+            ...event.context,
+            requestId: context.requestId,
+            startedAt: context.startedAt,
+        },
+    };
+}
 export function publishToolEvent(event) {
-    safePublish(toolChannel, event);
+    safePublish(toolChannel, attachContext(event));
 }
 export function publishLifecycleEvent(event) {
     safePublish(lifecycleChannel, event);
 }
-export function publishEngineEvent(event) {
-    safePublish(engineChannel, event);
-}
 //# sourceMappingURL=diagnostics.js.map

package/dist/lib/diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/lib/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,MAAM,0BAA0B,CAAC;AAoC3D,MAAM,WAAW,GAAG,mBAAmB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;AACjE,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAC3E,MAAM,aAAa,GAAG,mBAAmB,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAErE,SAAS,WAAW,CAClB,OAAoC,EACpC,OAAgB;IAEhB,IAAI,CAAC,OAAO,CAAC,cAAc;QAAE,OAAO;IACpC,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAC/C,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAqB;IACzD,WAAW,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAkB;IACnD,WAAW,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/lib/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAoCjD,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;AAChE,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAE1E,SAAS,WAAW,CAClB,OAAmC,EACnC,OAAgB;IAEhB,IAAI,CAAC,OAAO,CAAC,cAAc;QAAE,OAAO;IACpC,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAuC,KAAQ;IACnE,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO;QACL,GAAG,KAAK;QACR,OAAO,EAAE;YACP,GAAG,KAAK,CAAC,OAAO;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAC/C,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAqB;IACzD,WAAW,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/lib/engineWorkerHandler.d.ts

@@ -0,0 +1,12 @@
+import type { ProcessResult, ThoughtData } from './types.js';
+import type { EngineWorkerResponse } from './workerProtocol.js';
+interface EngineProcessor {
+    processThought: (input: ThoughtData) => ProcessResult;
+}
+interface WorkerHandlerDeps {
+    engine: EngineProcessor;
+    post: (message: EngineWorkerResponse) => void;
+}
+export declare function handleEngineWorkerMessage(raw: unknown, deps: WorkerHandlerDeps): void;
+export {};
+//# sourceMappingURL=engineWorkerHandler.d.ts.map

package/dist/lib/engineWorkerHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineWorkerHandler.d.ts","sourceRoot":"","sources":["../../src/lib/engineWorkerHandler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAG7B,UAAU,eAAe;IACvB,cAAc,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,aAAa,CAAC;CACvD;AAED,UAAU,iBAAiB;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC/C;AAmCD,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,iBAAiB,GACtB,IAAI,CAcN"}