@thijshakkenberg/valkyrie-mom-mcp 1.0.0 → 1.2.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "valkyrie-mom",
+  "description": "Valkyrie Mansions of Madness scenario editor plugin and MCP server",
+  "owner": {
+    "name": "Thijs Hakkenberg"
+  },
+  "plugins": [
+    {
+      "name": "valkyrie-mom",
+      "description": "AI-assisted Mansions of Madness scenario editor for Valkyrie — MCP server, 7 skills, and scenario designer agent",
+      "version": "1.0.1",
+      "author": {
+        "name": "Thijs Hakkenberg"
+      },
+      "source": "./",
+      "category": "development"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "valkyrie-mom",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "AI-assisted Mansions of Madness scenario editor for Valkyrie",
   "author": {
     "name": "Thijs Hakkenberg"
@@ -10,8 +10,7 @@
   "mcpServers": {
     "valkyrie-mom": {
       "command": "npx",
-      "args": ["tsx", "${CLAUDE_PLUGIN_ROOT}/src/index.ts"],
-      "cwd": "${CLAUDE_PLUGIN_ROOT}"
+      "args": ["-y", "@thijshakkenberg/valkyrie-mom-mcp"]
     }
   }
 }

package/.mcp.json

@@ -2,8 +2,7 @@
   "mcpServers": {
     "valkyrie-mom": {
       "command": "npx",
-      "args": ["tsx", "${CLAUDE_PLUGIN_ROOT}/src/index.ts"],
-      "cwd": "${CLAUDE_PLUGIN_ROOT}"
+      "args": ["-y", "@thijshakkenberg/valkyrie-mom-mcp"]
     }
   }
 }

package/README.md

@@ -1,47 +1,79 @@
 # valkyrie-mom-mcp
 
-MCP (Model Context Protocol) server for AI-assisted Mansions of Madness 2nd Edition scenario creation with [Valkyrie](https://github.com/NPBruce/valkyrie).
+[![npm](https://img.shields.io/npm/v/@thijshakkenberg/valkyrie-mom-mcp)](https://www.npmjs.com/package/@thijshakkenberg/valkyrie-mom-mcp)
+
+MCP (Model Context Protocol) server and Claude Code plugin for AI-assisted Mansions of Madness 2nd Edition scenario creation with [Valkyrie](https://github.com/NPBruce/valkyrie).
 
 ## What it does
 
 This server exposes Valkyrie scenario editing as MCP tools, enabling AI assistants (Claude, etc.) to create, modify, validate, and build complete MoM scenarios. It auto-detects the Valkyrie editor directory so scenarios appear directly in the app.
 
-## Prerequisites
+The plugin bundles 7 skills covering advanced patterns (event loops, mythos scaling, tile placement chains, custom puzzles, etc.) and an autonomous scenario designer agent.
 
-- [Node.js](https://nodejs.org/) >= 18
-- [Valkyrie](https://github.com/NPBruce/valkyrie) (optional, for playing built scenarios)
+## Install
 
-## Setup
+### As a Claude Code plugin (recommended)
 
 ```bash
-npm install
+claude plugin marketplace add thijs-hakkenberg/ValkyrieMCP
+claude plugin install valkyrie-mom
 ```
 
-### As an MCP server (Claude Code, Claude Desktop, etc.)
+This gives you:
+- **MCP server** with 20 tools for scenario editing (auto-started)
+- **7 skills**: `/scenario`, `/event-patterns`, `/tile-placement`, `/variables-and-mythos`, `/custom-monsters`, `/ui-and-puzzles`, `/items-and-distribution`
+- **Scenario designer agent** for autonomous scenario creation
+- **5 MCP resources** for format documentation
 
-Add to your `.mcp.json` or MCP client config:
+To update to the latest version:
+```bash
+claude plugin marketplace update valkyrie-mom
+claude plugin update valkyrie-mom
+```
+
+To uninstall:
+```bash
+claude plugin uninstall valkyrie-mom
+```
+
+### As a standalone MCP server (Claude Desktop, other MCP clients)
+
+Add to your MCP client config (e.g., `~/.claude/mcp.json` or Claude Desktop settings):
 
 ```json
 {
   "mcpServers": {
     "valkyrie-mom": {
       "command": "npx",
-      "args": ["tsx", "src/index.ts"],
-      "cwd": "/path/to/valkyrie_mom_mcp"
+      "args": ["-y", "@thijshakkenberg/valkyrie-mom-mcp"]
     }
   }
 }
 ```
 
-### Development
+This gives you the MCP tools and resources, but not the skills or agent (those require Claude Code).
+
+### From source
 
 ```bash
-npm test          # Run all tests
-npm run test:watch # Watch mode
-npm run lint       # Type check
-npm run build      # Compile to dist/
+git clone https://github.com/thijs-hakkenberg/ValkyrieMCP.git
+cd ValkyrieMCP
+npm install
+npx tsx src/index.ts   # Run MCP server via stdio
 ```
 
+## Skills
+
+| Skill | Description |
+|-------|-------------|
+| `/scenario` | Guided end-to-end scenario creation workflow |
+| `/event-patterns` | Event loops, multi-question dialogues, silent events, token swaps, random events, variable branching |
+| `/tile-placement` | Standard placement chains, multi-entry tiles, naming conventions |
+| `/variables-and-mythos` | Variable system, mythos scaling formula, random generation, hero detection, content pack gating |
+| `/custom-monsters` | Custom activations, evade/horror events, round-based spawn triggering |
+| `/ui-and-puzzles` | Prologues, interactive journals, combination locks, built-in puzzle types |
+| `/items-and-distribution` | Random items, unique items, starting items, inspection events |
+
 ## MCP Tools
 
 ### Lifecycle
@@ -77,7 +109,12 @@ npm run build      # Compile to dist/
 ### Reference
 | Tool | Description |
 |------|-------------|
-| `search_game_content` | Search game content catalogs |
+| `search_game_content` | Search game content catalogs (846 entries across tiles, monsters, items, audio) |
+
+### Diagnostics
+| Tool | Description |
+|------|-------------|
+| `export_bug_report` | Generate a ZIP bug report with session trace, scenario files, validation results, and Valkyrie logs |
 
 ## MCP Resources
 
@@ -86,6 +123,7 @@ npm run build      # Compile to dist/
 | Event format docs | `valkyrie://format/events` |
 | Localization format docs | `valkyrie://format/localization` |
 | Component format docs | `valkyrie://format/components` |
+| Pattern reference | `valkyrie://format/patterns` |
 | Current scenario state | `valkyrie://scenario/current` |
 
 ## MCP Prompts
@@ -122,25 +160,45 @@ Built scenarios are ZIP archives with a `.valkyrie` extension.
 
 ## Validation Rules
 
-The server validates scenarios against 6 rule sets:
+The server validates scenarios against 12 rule categories:
 
 1. **Unique names** - No duplicate component names
 2. **Required fields** - Tiles have `side`, displayed events have `buttons`
-3. **Cross-references** - All referenced components exist (built-in game content like `Monster*` is exempt)
+3. **Cross-references** - All referenced components exist
 4. **Event graph** - `EventStart` trigger exists, no unreachable/dead-end events
-5. **Localization completeness** - `quest.name`, `quest.description`, event text, button labels
-6. **Format rules** - Valid format version, type=MoM, tile rotations in {0, 90, 180, 270}
+5. **Event flow** - Buttons vs event-ref consistency, silent event rules
+6. **Localization completeness** - Event text, button labels, quest metadata
+7. **Format rules** - Valid format version, type=MoM, tile rotations
+8. **Catalog references** - Tile sides, monster names, items match game content
+9. **Tile connectivity** - Tiles are spatially connected
+10. **Mythos structure** - Proper mythos trigger configuration
+11. **Investigator token** - TokenInvestigators setup and removal
+12. **Explore token** - Explore tokens linked to tile reveal events
+
+## Development
+
+```bash
+npm test          # Run all tests (1096 tests across 36 files)
+npm run test:watch # Watch mode
+npm run lint       # Type check
+npm run build      # Compile to dist/
+```
 
 ## Project Structure
 
 ```
+.claude-plugin/    Plugin manifest
+skills/            7 skill SKILL.md files
+agents/            Scenario designer agent
 src/
   io/              INI parser/writer, localization CSV, ZIP packager
   model/           ScenarioModel, LocalizationStore, component types
-  validation/      6 rules + orchestrator
+  validation/      12 rules + orchestrator
     rules/         Individual validation rule implementations
   tools/           MCP tool implementations
   resources/       Format documentation resources
+  catalogs/        846-entry game content catalog
+  diagnostics/     Bug report builder, session trace, ring buffer
   server.ts        MCP server registration
   index.ts         Entry point (stdio transport)
 tests/
@@ -149,6 +207,7 @@ tests/
   model/           Model layer tests
   tools/           Tool tests
   validation/      Validation rule tests
+  diagnostics/     Diagnostics tests
   golden.test.ts   Round-trip integrity tests
   integration.test.ts  Full pipeline tests
 ```
@@ -161,4 +220,4 @@ tests/
 
 ## License
 
-ISC
+MIT

package/dist/catalogs/catalog-store.d.ts

@@ -1,4 +1,8 @@
 import type { CatalogEntry, CatalogType } from './catalog-types.js';
+/** Maps lowercase catalog pack IDs to Valkyrie's case-sensitive pack IDs */
+export declare const PACK_ID_MAP: Record<string, string>;
+/** Convert a catalog pack ID (lowercase) to Valkyrie's case-sensitive pack ID */
+export declare function getValkyriePackId(catalogPack: string): string;
 export declare class CatalogStore {
     private entries;
     private byId;
@@ -15,6 +19,12 @@ export declare class CatalogStore {
     getByType(type: CatalogType): CatalogEntry[];
     /** Get a Set of all entry IDs, optionally filtered by type. */
     getAllIds(type?: CatalogType): Set<string>;
+    /** Get the Valkyrie pack ID for a catalog pack string */
+    getPackId(catalogPack: string): string;
+    /** Look up a tile side's pack from catalog, return Valkyrie pack ID */
+    getPackForTileSide(tileId: string): string | undefined;
+    /** Look up a monster's pack from catalog, return Valkyrie pack ID */
+    getPackForMonster(monsterId: string): string | undefined;
 }
 export declare function getSharedCatalog(): CatalogStore;
 //# sourceMappingURL=catalog-store.d.ts.map

package/dist/catalogs/catalog-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-store.d.ts","sourceRoot":"","sources":["../../src/catalogs/catalog-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAYpE,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,MAAM,CAAmC;;IAoCjD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY,EAAE;IAazD,uCAAuC;IACvC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI7C,uCAAuC;IACvC,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE;IAI5C,+DAA+D;IAC/D,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC;CAI3C;AAKD,wBAAgB,gBAAgB,IAAI,YAAY,CAK/C"}
+{"version":3,"file":"catalog-store.d.ts","sourceRoot":"","sources":["../../src/catalogs/catalog-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAYpE,4EAA4E;AAC5E,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO9C,CAAC;AAEF,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,MAAM,CAAmC;;IAoCjD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY,EAAE;IAazD,uCAAuC;IACvC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI7C,uCAAuC;IACvC,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE;IAI5C,+DAA+D;IAC/D,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC;IAK1C,yDAAyD;IACzD,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAItC,uEAAuE;IACvE,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMtD,qEAAqE;IACrE,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAKzD;AAKD,wBAAgB,gBAAgB,IAAI,YAAY,CAK/C"}

package/dist/catalogs/catalog-store.js

@@ -1,5 +1,18 @@
 import { MONSTERS, TILES, AUDIO, ITEMS, INVESTIGATORS, PUZZLES, TOKENS, } from './data/all-catalogs.js';
 import { TILE_GEOMETRY } from './data/tile-geometry.js';
+/** Maps lowercase catalog pack IDs to Valkyrie's case-sensitive pack IDs */
+export const PACK_ID_MAP = {
+    base: 'MoMBase',
+    btt: 'BtT',
+    hj: 'HJ',
+    pots: 'PotS',
+    soa: 'SoA',
+    sot: 'SoT',
+};
+/** Convert a catalog pack ID (lowercase) to Valkyrie's case-sensitive pack ID */
+export function getValkyriePackId(catalogPack) {
+    return PACK_ID_MAP[catalogPack] ?? catalogPack;
+}
 export class CatalogStore {
     entries;
     byId;
@@ -66,6 +79,24 @@ export class CatalogStore {
         const source = type ? (this.byType.get(type) ?? []) : this.entries;
         return new Set(source.map(e => e.id));
     }
+    /** Get the Valkyrie pack ID for a catalog pack string */
+    getPackId(catalogPack) {
+        return getValkyriePackId(catalogPack);
+    }
+    /** Look up a tile side's pack from catalog, return Valkyrie pack ID */
+    getPackForTileSide(tileId) {
+        const entry = this.byId.get(tileId);
+        if (!entry || entry.type !== 'tile')
+            return undefined;
+        return getValkyriePackId(entry.pack);
+    }
+    /** Look up a monster's pack from catalog, return Valkyrie pack ID */
+    getPackForMonster(monsterId) {
+        const entry = this.byId.get(monsterId);
+        if (!entry || entry.type !== 'monster')
+            return undefined;
+        return getValkyriePackId(entry.pack);
+    }
 }
 /** Shared singleton instance — avoids re-indexing 846 entries multiple times */
 let sharedInstance = null;

package/dist/catalogs/catalog-store.js.map

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

package/dist/diagnostics/bug-report-builder.d.ts

@@ -0,0 +1,5 @@
+import type { SessionTrace } from './session-trace.js';
+import type { ScenarioModel } from '../model/scenario-model.js';
+import type { BugReportOptions, BugReportResult } from './types.js';
+export declare function buildBugReport(trace: SessionTrace, model: ScenarioModel | null, options?: BugReportOptions): Promise<BugReportResult>;
+//# sourceMappingURL=bug-report-builder.d.ts.map

package/dist/diagnostics/bug-report-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug-report-builder.d.ts","sourceRoot":"","sources":["../../src/diagnostics/bug-report-builder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAqBpE,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA8G1B"}

package/dist/diagnostics/bug-report-builder.js

@@ -0,0 +1,112 @@
+import archiver from 'archiver';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { validateScenario } from '../validation/validator.js';
+import { getValkyrieLogPath, readLogTail } from './valkyrie-log-finder.js';
+const README_TEXT = `Valkyrie MoM MCP - Bug Report
+==============================
+
+This ZIP was generated by the export_bug_report tool.
+
+Contents:
+  report.json        - Session metadata and trace of MCP tool calls
+  validation.json    - Validation results at time of export
+  scenario/          - Scenario INI files (if a scenario was loaded)
+  valkyrie-logs/     - Valkyrie Player.log tail (if found)
+
+How to file an issue:
+  1. Go to https://github.com/thijs-hakkenberg/ValkyrieMCP/issues/new
+  2. Paste the issue template from the tool output
+  3. Drag and drop this ZIP file into the issue
+`;
+export async function buildBugReport(trace, model, options = {}) {
+    const { outputDir = os.tmpdir(), includeScenario = true, includeValkyrieLog = true, } = options;
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const zipName = `valkyrie-bug-report-${timestamp}.zip`;
+    const zipPath = path.join(outputDir, zipName);
+    // Build ZIP
+    const output = fs.createWriteStream(zipPath);
+    const archive = archiver('zip');
+    const done = new Promise((resolve, reject) => {
+        output.on('close', resolve);
+        archive.on('error', reject);
+    });
+    archive.pipe(output);
+    // report.json
+    const metadata = trace.getMetadata();
+    const entries = trace.getEntries();
+    const report = {
+        metadata,
+        traceEntries: entries,
+        exportedAt: new Date().toISOString(),
+    };
+    archive.append(JSON.stringify(report, null, 2), { name: 'report.json' });
+    // validation.json
+    let validationData = { errors: [], warnings: [], note: 'No scenario loaded' };
+    if (model) {
+        const results = validateScenario(model);
+        const errors = results.filter(r => r.severity === 'error');
+        const warnings = results.filter(r => r.severity === 'warning');
+        validationData = { errors, warnings };
+    }
+    archive.append(JSON.stringify(validationData, null, 2), { name: 'validation.json' });
+    // README.txt
+    archive.append(README_TEXT, { name: 'README.txt' });
+    // scenario/ directory
+    if (includeScenario && model?.scenarioDir && fs.existsSync(model.scenarioDir)) {
+        const scenarioFiles = fs.readdirSync(model.scenarioDir);
+        for (const file of scenarioFiles) {
+            const filePath = path.join(model.scenarioDir, file);
+            if (fs.statSync(filePath).isFile()) {
+                archive.file(filePath, { name: `scenario/${file}` });
+            }
+        }
+    }
+    // valkyrie-logs/
+    if (includeValkyrieLog) {
+        const logPath = getValkyrieLogPath();
+        if (logPath) {
+            const logContent = await readLogTail(logPath);
+            if (logContent) {
+                archive.append(logContent, { name: 'valkyrie-logs/Player.log' });
+            }
+        }
+    }
+    await archive.finalize();
+    await done;
+    // Build issue template
+    const errorEntries = trace.getErrorEntries();
+    const allEntries = trace.getEntries();
+    const errorCount = errorEntries.length;
+    const validationErrors = model ? validateScenario(model).filter(r => r.severity === 'error').length : 0;
+    const validationWarnings = model ? validateScenario(model).filter(r => r.severity === 'warning').length : 0;
+    const recentErrors = errorEntries.slice(-5).map(e => `- \`${e.tool}\` (${e.timestamp}): ${e.resultSummary.replace(/^Error:\s*/, '').slice(0, 100)}`).join('\n');
+    const issueTitle = `[Bug Report] MCP session with ${allEntries.length} tool calls, ${errorCount} errors`;
+    const issueBody = `## Bug Report
+
+**Environment:**
+- MCP Server: v${metadata.serverVersion}
+- Node: ${metadata.nodeVersion}
+- Platform: ${metadata.platform} ${metadata.arch}
+
+**Session Summary:**
+- Tool calls: ${allEntries.length}
+- Errors: ${errorCount}
+- Validation: ${validationErrors} errors, ${validationWarnings} warnings
+
+## What happened?
+<!-- Describe what you expected vs. what actually happened -->
+
+## Steps to reproduce
+<!-- The session trace is in the attached ZIP -->
+
+${recentErrors ? `## Recent errors from session trace\n${recentErrors}\n` : ''}
+## Attachments
+<!-- Drag and drop the .zip bug report file here -->
+`;
+    const escapedTitle = issueTitle.replace(/"/g, '\\"');
+    const ghCommand = `gh issue create --repo thijs-hakkenberg/ValkyrieMCP --title "${escapedTitle}" --body-file -`;
+    return { zipPath, issueTitle, issueBody, ghCommand };
+}
+//# sourceMappingURL=bug-report-builder.js.map

package/dist/diagnostics/bug-report-builder.js.map

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

package/dist/diagnostics/ring-buffer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Fixed-capacity circular buffer. When full, new items overwrite the oldest.
+ */
+export declare class RingBuffer<T> {
+    private buffer;
+    private head;
+    private count;
+    private readonly capacity;
+    constructor(capacity: number);
+    push(item: T): void;
+    get size(): number;
+    /** Returns entries oldest-first */
+    toArray(): T[];
+    clear(): void;
+}
+//# sourceMappingURL=ring-buffer.d.ts.map

package/dist/diagnostics/ring-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-buffer.d.ts","sourceRoot":"","sources":["../../src/diagnostics/ring-buffer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,EAAE,MAAM;IAK5B,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAQnB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,mCAAmC;IACnC,OAAO,IAAI,CAAC,EAAE;IAWd,KAAK,IAAI,IAAI;CAKd"}

package/dist/diagnostics/ring-buffer.js

@@ -0,0 +1,41 @@
+/**
+ * Fixed-capacity circular buffer. When full, new items overwrite the oldest.
+ */
+export class RingBuffer {
+    buffer;
+    head = 0; // next write position
+    count = 0;
+    capacity;
+    constructor(capacity) {
+        this.capacity = capacity;
+        this.buffer = new Array(capacity);
+    }
+    push(item) {
+        this.buffer[this.head] = item;
+        this.head = (this.head + 1) % this.capacity;
+        if (this.count < this.capacity) {
+            this.count++;
+        }
+    }
+    get size() {
+        return this.count;
+    }
+    /** Returns entries oldest-first */
+    toArray() {
+        if (this.count === 0)
+            return [];
+        const result = [];
+        const start = this.count < this.capacity ? 0 : this.head;
+        for (let i = 0; i < this.count; i++) {
+            const idx = (start + i) % this.capacity;
+            result.push(this.buffer[idx]);
+        }
+        return result;
+    }
+    clear() {
+        this.buffer = new Array(this.capacity);
+        this.head = 0;
+        this.count = 0;
+    }
+}
+//# sourceMappingURL=ring-buffer.js.map

package/dist/diagnostics/ring-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-buffer.js","sourceRoot":"","sources":["../../src/diagnostics/ring-buffer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,UAAU;IACb,MAAM,CAAuB;IAC7B,IAAI,GAAG,CAAC,CAAC,CAAG,sBAAsB;IAClC,KAAK,GAAG,CAAC,CAAC;IACD,QAAQ,CAAS;IAElC,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAgB,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,CAAC,IAAO;QACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5C,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,mCAAmC;IACnC,OAAO;QACL,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAM,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAgB,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;CACF"}

package/dist/diagnostics/session-trace.d.ts

@@ -0,0 +1,19 @@
+import type { TraceEntry, SessionMetadata } from './types.js';
+/** Omit timestamp — it's auto-filled by record() */
+type TraceInput = Omit<TraceEntry, 'timestamp'>;
+/**
+ * In-memory session trace. Records MCP tool calls in a ring buffer.
+ * Nothing is written to disk until explicitly exported.
+ */
+export declare class SessionTrace {
+    private buffer;
+    private metadata;
+    constructor(serverVersion: string, capacity?: number);
+    record(input: TraceInput): void;
+    getEntries(): TraceEntry[];
+    getErrorEntries(): TraceEntry[];
+    getMetadata(): SessionMetadata;
+    updateScenario(dir: string): void;
+}
+export {};
+//# sourceMappingURL=session-trace.d.ts.map

package/dist/diagnostics/session-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-trace.d.ts","sourceRoot":"","sources":["../../src/diagnostics/session-trace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI9D,oDAAoD;AACpD,KAAK,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAEhD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,aAAa,EAAE,MAAM,EAAE,QAAQ,SAAmB;IAW9D,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAO/B,UAAU,IAAI,UAAU,EAAE;IAI1B,eAAe,IAAI,UAAU,EAAE;IAI/B,WAAW,IAAI,eAAe;IAI9B,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAGlC"}

package/dist/diagnostics/session-trace.js

@@ -0,0 +1,40 @@
+import * as os from 'node:os';
+import { RingBuffer } from './ring-buffer.js';
+const DEFAULT_CAPACITY = 200;
+/**
+ * In-memory session trace. Records MCP tool calls in a ring buffer.
+ * Nothing is written to disk until explicitly exported.
+ */
+export class SessionTrace {
+    buffer;
+    metadata;
+    constructor(serverVersion, capacity = DEFAULT_CAPACITY) {
+        this.buffer = new RingBuffer(capacity);
+        this.metadata = {
+            serverVersion,
+            nodeVersion: process.version,
+            platform: os.platform(),
+            arch: os.arch(),
+            startedAt: new Date().toISOString(),
+        };
+    }
+    record(input) {
+        this.buffer.push({
+            ...input,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    getEntries() {
+        return this.buffer.toArray();
+    }
+    getErrorEntries() {
+        return this.buffer.toArray().filter(e => e.isError);
+    }
+    getMetadata() {
+        return { ...this.metadata };
+    }
+    updateScenario(dir) {
+        this.metadata.scenarioDir = dir;
+    }
+}
+//# sourceMappingURL=session-trace.js.map

package/dist/diagnostics/session-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-trace.js","sourceRoot":"","sources":["../../src/diagnostics/session-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAK7B;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAyB;IAC/B,QAAQ,CAAkB;IAElC,YAAY,aAAqB,EAAE,QAAQ,GAAG,gBAAgB;QAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAa,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG;YACd,aAAa;YACb,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE;YACvB,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;YACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAiB;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,GAAG,KAAK;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,WAAW;QACT,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,cAAc,CAAC,GAAW;QACxB,IAAI,CAAC,QAAQ,CAAC,WAAW,GAAG,GAAG,CAAC;IAClC,CAAC;CACF"}

package/dist/diagnostics/tool-interceptor.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { SessionTrace } from './session-trace.js';
+/** Truncate string values in args to prevent huge trace entries */
+export declare function sanitizeArgs(args: Record<string, unknown> | undefined): Record<string, unknown>;
+/**
+ * Wrap all registered tool handlers to record calls to the session trace.
+ * Must be called after all tools are registered. Skips `export_bug_report`
+ * to avoid circular recording.
+ */
+export declare function wrapAllTools(server: McpServer, trace: SessionTrace): void;
+//# sourceMappingURL=tool-interceptor.d.ts.map

package/dist/diagnostics/tool-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-interceptor.d.ts","sourceRoot":"","sources":["../../src/diagnostics/tool-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW/F;AAgBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAkCzE"}