@j0hanz/cortex-mcp 0.1.2

package/README.md

@@ -0,0 +1,269 @@
+# Cortex MCP
+
+[![npm version](https://img.shields.io/npm/v/cortex-mcp?style=flat-square)](https://www.npmjs.com/package/cortex-mcp) [![Generic badge](https://img.shields.io/badge/Node.js->=24-3c873a?style=flat-square)](https://nodejs.org) [![Generic badge](https://img.shields.io/badge/TypeScript-5.9+-3178c6?style=flat-square)](https://www.typescriptlang.org) [![Generic badge](https://img.shields.io/badge/MCP_SDK-1.26+-ff6600?style=flat-square)](https://modelcontextprotocol.io) [![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
+
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?config=%7B%22name%22%3A%22cortex-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22cortex-mcp%40latest%22%5D%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](vscode-insiders:mcp/install?config=%7B%22name%22%3A%22cortex-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22cortex-mcp%40latest%22%5D%7D) [![Install in Cursor](https://img.shields.io/badge/Cursor-Install-000000?style=flat-square&logo=cursor&logoColor=white)](https://cursor.com/install-mcp?name=cortex-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImNvcnRleC1tY3BAbGF0ZXN0Il19)
+
+Multi-level reasoning MCP server with configurable depth levels.
+
+## Overview
+
+Cortex MCP is a reasoning engine that exposes a `reasoning.think` tool to perform multi-step analysis on complex queries. It supports three configurable depth levels (Basic, Normal, High), maintains session state for follow-up questions, and offers asynchronous task execution for long-running reasoning processes. All reasoning happens locally in-memory.
+
+## Key Features
+
+- **Multi-Level Reasoning**: Three distinct depth levels (`basic`, `normal`, `high`) with varying token budgets and thought counts.
+- **Session Continuity**: Resume reasoning sessions by ID to maintain context across multiple turns.
+- **Async Task Support**: Execute long-running reasoning as a background task with progress notifications.
+- **Event-Driven Architecture**: Internal event emitter orchestrates session lifecycle and resource updates.
+- **Real-time Resources**: Inspect active sessions and individual thought traces via MCP resources.
+- **Strict Validation**: Zod-based schemas ensure type safety for all inputs and outputs.
+
+## Tech Stack
+
+- **Runtime**: Node.js >= 24
+- **Language**: TypeScript 5.9+
+- **MCP SDK**: `@modelcontextprotocol/sdk` ^1.26.0
+- **Validation**: `zod` ^4.3.6
+- **Testing**: `node:test` (Native)
+- **Package Manager**: npm
+
+## Architecture
+
+1. **Transport**: Receives JSON-RPC messages via `stdio`.
+2. **Tool Handler**: `reasoning.think` validates input and initiates the reasoning planner.
+3. **Engine**: The `reasoner` orchestrates thoughts based on the selected `level` configuration.
+4. **State**: Sessions are stored in an in-memory `SessionStore` (LRU/TTL based).
+5. **Resources**: Dynamic resource endpoints expose session data and markdown traces.
+
+## Repository Structure
+
+```
+cortex-mcp/
+├── src/
+│   ├── index.ts              # CLI entry point (stdio transport)
+│   ├── server.ts             # Server factory & setup
+│   ├── engine/               # Reasoning logic and session store
+│   ├── tools/                # Tool implementations (reasoning.think)
+│   ├── resources/            # Resource endpoints
+│   ├── prompts/              # Prompt templates
+│   ├── schemas/              # Zod schemas (inputs/outputs)
+│   └── lib/                  # Utilities and types
+├── scripts/                  # Build and task runners
+├── package.json
+└── tsconfig.json
+```
+
+## Requirements
+
+- **Node.js**: >= 24
+
+## Quickstart
+
+Use `npx` to run the server directly without installation:
+
+```bash
+npx -y cortex-mcp@latest
+```
+
+## Installation
+
+### NPX (Recommended)
+
+```bash
+npx -y cortex-mcp@latest
+```
+
+### From Source
+
+```bash
+git clone https://github.com/j0hanz/cortex-mcp.git
+cd cortex-mcp
+npm install
+npm run build
+node dist/index.js
+```
+
+## Configuration
+
+### Environment Variables
+
+No environment variables are strictly required for basic operation.
+
+### Runtime Levels
+
+The server is configured with the following reasoning levels (defined in `src/engine/config.ts`):
+
+| Level    | Token Budget | Thoughts Range |
+| :------- | :----------- | :------------- |
+| `basic`  | 2,048        | 3–5            |
+| `normal` | 8,192        | 6–10           |
+| `high`   | 32,768       | 15–25          |
+
+## Usage
+
+Configure your MCP client to start the server via stdio.
+
+### Stdio Transport
+
+Run the server process directly. Messages are sent over `stdin` and `stdout`.
+
+## MCP Surface
+
+### Tools
+
+#### `reasoning.think`
+
+Perform multi-level reasoning on a query.
+
+| Parameter        | Type   | Required | Default | Description                                                 |
+| :--------------- | :----- | :------- | :------ | :---------------------------------------------------------- |
+| `query`          | string | Yes      | -       | The question or problem to reason about (max 10,000 chars). |
+| `level`          | enum   | Yes      | -       | Depth level: `basic`, `normal`, `high`.                     |
+| `targetThoughts` | number | No       | -       | Optional exact step count (max 25).                         |
+| `sessionId`      | string | No       | -       | Session ID to continue a previous reasoning session.        |
+
+**Output Example**:
+
+```json
+{
+  "ok": true,
+  "result": {
+    "sessionId": "uuid-v4...",
+    "level": "normal",
+    "thoughts": [{ "index": 0, "content": "...", "revision": 0 }],
+    "generatedThoughts": 1,
+    "totalThoughts": 1,
+    "tokenBudget": 8192
+  }
+}
+```
+
+### Resources
+
+| URI Pattern                                            | Description                                        | MIME Type          |
+| :----------------------------------------------------- | :------------------------------------------------- | :----------------- |
+| `internal://instructions`                              | Usage instructions for the MCP server.             | `text/markdown`    |
+| `reasoning://sessions`                                 | List of active reasoning sessions.                 | `application/json` |
+| `reasoning://sessions/{sessionId}`                     | Detailed view of a reasoning session.              | `application/json` |
+| `file:///cortex/sessions/{sessionId}/trace.md`         | Full Markdown trace of a session.                  | `text/markdown`    |
+| `file:///cortex/sessions/{sessionId}/{thoughtName}.md` | Content of a single thought (e.g. `Thought-1.md`). | `text/markdown`    |
+
+### Prompts
+
+| Name                 | Arguments                          | Description                                   |
+| :------------------- | :--------------------------------- | :-------------------------------------------- |
+| `reasoning.basic`    | `query`, `targetThoughts`          | Prepare a basic-depth reasoning request.      |
+| `reasoning.normal`   | `query`, `targetThoughts`          | Prepare a normal-depth reasoning request.     |
+| `reasoning.high`     | `query`, `targetThoughts`          | Prepare a high-depth reasoning request.       |
+| `reasoning.retry`    | `query`, `level`, `targetThoughts` | Retry a failed task with modified parameters. |
+| `reasoning.continue` | `sessionId`, `query`, `level`, ... | Continue an existing session.                 |
+| `get-help`           | -                                  | Return server usage instructions.             |
+
+### Tasks
+
+This server supports **async task execution** for `reasoning.think`.
+
+- **Capability**: `execution: { taskSupport: 'optional' }`
+- **Usage**: Clients can invoke the tool as a background task.
+- **Monitoring**: Progress is reported via `notifications/progress` (on 'high' level, typically every 2 steps).
+
+## Client Configuration Examples
+
+<details>
+<summary><strong>VS Code</strong></summary>
+
+Add to your `settings.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "cortex-mcp": {
+        "command": "npx",
+        "args": ["-y", "cortex-mcp@latest"]
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "cortex-mcp": {
+      "command": "npx",
+      "args": ["-y", "cortex-mcp@latest"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Cursor</strong></summary>
+
+Add to your Cursor MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "cortex-mcp": {
+      "command": "npx",
+      "args": ["-y", "cortex-mcp@latest"]
+    }
+  }
+}
+```
+
+</details>
+
+## Security
+
+- **Stdio Isolation**: The server writes all logs to `stderr` to avoid corrupting the JSON-RPC stream on `stdout`.
+- **Input Validation**: All tool inputs conform to strict Zod schemas with character limits (`max(10000)` for queries).
+- **Filesystem**: No actual filesystem writes occur; "files" are exposed virtually via resources.
+
+## Development Workflow
+
+1. **Install dependencies**:
+
+   ```bash
+   npm install
+   ```
+
+2. **Scripts**:
+
+| Script      | Command                        | Purpose                          |
+| :---------- | :----------------------------- | :------------------------------- |
+| `build`     | `node scripts/tasks.mjs build` | Clean, compile, and copy assets. |
+| `dev`       | `tsc --watch ...`              | Watch mode compilation.          |
+| `dev:run`   | `node --watch dist/index.js`   | Run server with auto-restart.    |
+| `test`      | `node scripts/tasks.mjs test`  | Build and run tests.             |
+| `lint`      | `eslint .`                     | Lint source files.               |
+| `inspector` | `npm run build && ...`         | Launch MCP Inspector.            |
+
+## Build and Release
+
+The project uses a custom task runner (`scripts/tasks.mjs`) for build orchestration.
+
+- **Build**: `npm run build` generates artifacts in `dist/`.
+- **Publish**: `npm run prepublishOnly` ensures linting, type-checking, and building before publish.
+
+## Troubleshooting
+
+- **No output**: The server uses `stdio`. Ensure your client is capturing `stdout` correctly. Check `stderr` for logs.
+- **Inspector**: Run `npm run inspector` to debug tools and resources interactively.
+- **Session not found**: Sessions are in-memory and expire locally (default TTL: 30 minutes).
+
+## License
+
+MIT

package/dist/assets/logo.svg

@@ -0,0 +1,49 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke-width="1.2" stroke-linecap="round"
+    stroke-linejoin="round" role="img" aria-label="brain">
+    <style>
+        path,
+        circle,
+        rect,
+        line,
+        polyline,
+        polygon {
+            stroke: #000000;
+        }
+
+        @media (prefers-color-scheme: dark) {
+
+            path,
+            circle,
+            rect,
+            line,
+            polyline,
+            polygon {
+                stroke: #FFFFFF;
+            }
+        }
+    </style>
+
+    <g>
+        <!-- Outer silhouette -->
+        <path d="M9 4.2c-2.2 0-4 1.7-4 4v1.1c-1 .6-1.7 1.7-1.7 3 0 1.6 1 2.9 2.4 3.3v.9c0 2.2 1.8 4 4 4h2.3" />
+        <path d="M15 4.2c2.2 0 4 1.7 4 4v1.1c1 .6 1.7 1.7 1.7 3 0 1.6-1 2.9-2.4 3.3v.9c0 2.2-1.8 4-4 4H12" />
+
+        ```
+        <!-- Midline split (subtle) -->
+        <path d="M12 5.1v15.1" />
+
+        <!-- Left hemisphere folds -->
+        <path d="M8.8 7c-1.2.1-2.2 1.1-2.2 2.4" />
+        <path d="M9.3 10.1c-1.4 0-2.6 1.1-2.6 2.6" />
+        <path d="M9.6 13.4c-1.2.2-2.1 1.2-2.1 2.5" />
+        <path d="M10.3 16.4c-1.1 0-2 .7-2.4 1.7" />
+
+        <!-- Right hemisphere folds -->
+        <path d="M15.2 7c1.2.1 2.2 1.1 2.2 2.4" />
+        <path d="M14.7 10.1c1.4 0 2.6 1.1 2.6 2.6" />
+        <path d="M14.4 13.4c1.2.2 2.1 1.2 2.1 2.5" />
+        <path d="M13.7 16.4c1.1 0 2 .7 2.4 1.7" />
+        ```
+
+    </g>
+</svg>

package/dist/engine/config.d.ts

@@ -0,0 +1,9 @@
+import type { LevelConfig, ReasoningLevel } from '../lib/types.js';
+export declare const LEVEL_CONFIGS: Record<ReasoningLevel, LevelConfig>;
+export declare function getThoughtBounds(level: ReasoningLevel): {
+    minThoughts: number;
+    maxThoughts: number;
+};
+export declare function getTargetThoughtsError(level: ReasoningLevel, targetThoughts: number): string | undefined;
+export declare function assertTargetThoughtsInRange(level: ReasoningLevel, targetThoughts: number): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/engine/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/engine/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEnE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,WAAW,CAI7D,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAGA;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,SAAS,CAWpB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,EACrB,cAAc,EAAE,MAAM,GACrB,IAAI,CAKN"}

package/dist/engine/config.js

@@ -0,0 +1,26 @@
+export const LEVEL_CONFIGS = {
+    basic: { minThoughts: 3, maxThoughts: 5, tokenBudget: 2048 },
+    normal: { minThoughts: 6, maxThoughts: 10, tokenBudget: 8192 },
+    high: { minThoughts: 15, maxThoughts: 25, tokenBudget: 32768 },
+};
+export function getThoughtBounds(level) {
+    const { minThoughts, maxThoughts } = LEVEL_CONFIGS[level];
+    return { minThoughts, maxThoughts };
+}
+export function getTargetThoughtsError(level, targetThoughts) {
+    if (!Number.isInteger(targetThoughts)) {
+        return 'targetThoughts must be an integer';
+    }
+    const { minThoughts, maxThoughts } = getThoughtBounds(level);
+    if (targetThoughts < minThoughts || targetThoughts > maxThoughts) {
+        return `targetThoughts must be between ${String(minThoughts)} and ${String(maxThoughts)} for the selected level`;
+    }
+    return undefined;
+}
+export function assertTargetThoughtsInRange(level, targetThoughts) {
+    const error = getTargetThoughtsError(level, targetThoughts);
+    if (error) {
+        throw new Error(error);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/engine/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/engine/config.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAwC;IAChE,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;IAC5D,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;IAC9D,IAAI,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;CAC/D,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IAIpD,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC1D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAqB,EACrB,cAAsB;IAEtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;QACtC,OAAO,mCAAmC,CAAC;IAC7C,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,cAAc,GAAG,WAAW,IAAI,cAAc,GAAG,WAAW,EAAE,CAAC;QACjE,OAAO,kCAAkC,MAAM,CAAC,WAAW,CAAC,QAAQ,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC;IACnH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAqB,EACrB,cAAsB;IAEtB,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAC5D,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/engine/context.d.ts

@@ -0,0 +1,7 @@
+interface EngineContext {
+    sessionId: string;
+    abortSignal?: AbortSignal;
+}
+export declare function runWithContext<T>(ctx: EngineContext, fn: () => T): T;
+export {};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/engine/context.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAID,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEpE"}

package/dist/engine/context.js

@@ -0,0 +1,6 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const storage = new AsyncLocalStorage();
+export function runWithContext(ctx, fn) {
+    return storage.run(ctx, fn);
+}
+//# sourceMappingURL=context.js.map

package/dist/engine/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/engine/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAiB,CAAC;AAEvD,MAAM,UAAU,cAAc,CAAI,GAAkB,EAAE,EAAW;IAC/D,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC"}

package/dist/engine/events.d.ts

@@ -0,0 +1,51 @@
+import { EventEmitter } from 'node:events';
+import type { ReasoningLevel } from '../lib/types.js';
+interface EngineEvents {
+    'thought:added': [{
+        sessionId: string;
+        index: number;
+        content: string;
+    }];
+    'thought:revised': [
+        {
+            sessionId: string;
+            index: number;
+            content: string;
+            revision: number;
+        }
+    ];
+    'thought:budget-exhausted': [
+        {
+            sessionId: string;
+            tokensUsed: number;
+            tokenBudget: number;
+            generatedThoughts: number;
+            requestedThoughts: number;
+        }
+    ];
+    'session:created': [{
+        sessionId: string;
+        level: ReasoningLevel;
+    }];
+    'session:expired': [{
+        sessionId: string;
+    }];
+    'session:deleted': [{
+        sessionId: string;
+    }];
+    'resources:changed': [{
+        uri: string;
+    }];
+    'resource:updated': [{
+        uri: string;
+    }];
+    error: [unknown];
+}
+interface TypedEmitter<T> extends Omit<EventEmitter, 'on' | 'off' | 'emit'> {
+    on<K extends keyof T>(event: K, listener: (...args: T[K] extends unknown[] ? T[K] : never) => void): this;
+    off<K extends keyof T>(event: K, listener: (...args: T[K] extends unknown[] ? T[K] : never) => void): this;
+    emit<K extends keyof T>(event: K, ...args: T[K] extends unknown[] ? T[K] : never): boolean;
+}
+export declare const engineEvents: TypedEmitter<EngineEvents>;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/engine/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/engine/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,UAAU,YAAY;IACpB,eAAe,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,iBAAiB,EAAE;QACjB;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE;KACxE,CAAC;IACF,0BAA0B,EAAE;QAC1B;YACE,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,MAAM,CAAC;YACnB,WAAW,EAAE,MAAM,CAAC;YACpB,iBAAiB,EAAE,MAAM,CAAC;YAC1B,iBAAiB,EAAE,MAAM,CAAC;SAC3B;KACF,CAAC;IACF,iBAAiB,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;IAClE,iBAAiB,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,iBAAiB,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,mBAAmB,EAAE,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvC,kBAAkB,EAAE,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC;CAClB;AAED,UAAU,YAAY,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IACzE,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAClB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,IAAI,GACjE,IAAI,CAAC;IACR,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EACnB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,IAAI,GACjE,IAAI,CAAC;IACR,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EACpB,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAC7C,OAAO,CAAC;CACZ;AAED,eAAO,MAAM,YAAY,EAEnB,YAAY,CAAC,YAAY,CAAC,CAAC"}

package/dist/engine/events.js

@@ -0,0 +1,9 @@
+import { EventEmitter } from 'node:events';
+import { getErrorMessage } from '../lib/errors.js';
+export const engineEvents = new EventEmitter({
+    captureRejections: true,
+});
+engineEvents.on('error', (err) => {
+    process.stderr.write(`[engine] ${getErrorMessage(err)}\n`);
+});
+//# sourceMappingURL=events.js.map

package/dist/engine/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/engine/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAwCnD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC;IAC3C,iBAAiB,EAAE,IAAI;CACxB,CAA+B,CAAC;AAEjC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;IAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC"}

package/dist/engine/index.d.ts

@@ -0,0 +1,6 @@
+export { LEVEL_CONFIGS } from './config.js';
+export { runWithContext } from './context.js';
+export { engineEvents } from './events.js';
+export { reason, sessionStore } from './reasoner.js';
+export { SessionStore } from './session-store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/engine/index.js

@@ -0,0 +1,6 @@
+export { LEVEL_CONFIGS } from './config.js';
+export { runWithContext } from './context.js';
+export { engineEvents } from './events.js';
+export { reason, sessionStore } from './reasoner.js';
+export { SessionStore } from './session-store.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/engine/reasoner.d.ts

@@ -0,0 +1,12 @@
+import type { ReasoningLevel, Session } from '../lib/types.js';
+import { SessionStore } from './session-store.js';
+declare const sessionStore: SessionStore;
+export { sessionStore };
+interface ReasonOptions {
+    sessionId?: string;
+    targetThoughts?: number;
+    abortSignal?: AbortSignal;
+    onProgress?: (progress: number, total: number) => void | Promise<void>;
+}
+export declare function reason(query: string, level: ReasoningLevel, options?: ReasonOptions): Promise<Readonly<Session>>;
+//# sourceMappingURL=reasoner.d.ts.map

package/dist/engine/reasoner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoner.d.ts","sourceRoot":"","sources":["../../src/engine/reasoner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAK/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,QAAA,MAAM,YAAY,cAAqB,CAAC;AAMxC,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAQD,wBAAsB,MAAM,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CA2E5B"}