@getmarrow/mcp 2.3.5 → 2.5.0

package/README.md

@@ -10,6 +10,15 @@ With `@getmarrow/mcp`, any MCP-compatible client can log intent before acting, i
 
 ---
 
+## What's New in v2.5.0
+
+- **`marrow_run` tool** — single-call memory logging. Pass description + success + outcome. Marrow handles orient → think → commit internally.
+- **`MARROW_SESSION_ID` env var** — tag all requests with a session identifier
+- **Auto-commit on session close** — if session ends with an open loop, Marrow commits automatically
+- **Orient warnings in think response** — startup warnings now surface in `marrow_think` intelligence, not just stderr
+
+---
+
 ## What's New in v2.3.4
 
 ### Loop enforcement is now part of the MCP workflow
@@ -174,7 +183,7 @@ Returns:
 
 Typical use:
 - before handoff
-- before “done”
+- before "done"
 - before outbound updates after meaningful work
 
 ### `marrow_commit` / `commit`
@@ -190,6 +199,24 @@ Typical use:
 - after a deploy / publish / send / write succeeds or fails
 - before a clean handoff or completion
 
+### `marrow_run` — Zero-ceremony wrapper
+
+Single call. Handles orient → think → commit automatically.
+
+Input:
+```json
+{
+  "description": "What the agent did",
+  "success": true,
+  "outcome": "One-line summary of what happened",
+  "type": "implementation"
+}
+```
+
+Returns: `{ decision_id, success_rate, insight, intelligence }`
+
+Use this when you want memory logging without managing the loop manually.
+
 ### `patterns`
 Inspect accumulated decision patterns.
 
@@ -200,6 +227,36 @@ Typical use:
 
 ---
 
+## Zero-Ceremony Mode
+
+Use `marrow_run` instead of chaining `marrow_think` + `marrow_commit`:
+
+```json
+{
+  "tool": "marrow_run",
+  "input": {
+    "description": "Refactored auth service to add retry logic",
+    "success": true,
+    "outcome": "Auth refactored. Exponential backoff added. Tests passing.",
+    "type": "implementation"
+  }
+}
+```
+
+Marrow handles the full loop internally.
+
+---
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `MARROW_API_KEY` | Yes | Your Marrow API key (starts with `mrw_`) |
+| `MARROW_BASE_URL` | No | Override API base URL (default: `https://api.getmarrow.ai`) |
+| `MARROW_SESSION_ID` | No | Session identifier — sent as `X-Marrow-Session-Id` on all requests |
+
+---
+
 ## Example Workflow
 
 ### Example: deployment task
@@ -255,6 +312,24 @@ With Marrow MCP:
 
 ---
 
+## Privacy, Sanitization, and Data Ownership
+
+Marrow should make agents smarter **without turning user sessions into careless raw-data collection**.
+
+Key trust properties:
+- sensitive inputs can be sanitized before storage when possible
+- privacy-preserving learning matters more than retaining raw personal data forever
+- MCP hosts should pass API keys through environment variables, not embed them in source or config blobs committed to git
+- the product direction is anonymized pattern learning, not exposing private user context across the hive
+- users should be able to export and own their memory data instead of being trapped in a closed system
+
+In short:
+- better agent memory
+- stronger privacy posture
+- clearer user ownership
+
+---
+
 ## Session Hint
 
 At session start, Marrow nudges clients with the canonical reminder:

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Marrow MCP stdio server — collective memory for Claude and MCP agents.
+ * Exposes: marrow_orient (call first!), marrow_think, marrow_commit, marrow_status
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/cli.js

@@ -0,0 +1,373 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Marrow MCP stdio server — collective memory for Claude and MCP agents.
+ * Exposes: marrow_orient (call first!), marrow_think, marrow_commit, marrow_status
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const readline = __importStar(require("readline"));
+const index_1 = require("./index");
+const API_KEY = process.env.MARROW_API_KEY || '';
+const BASE_URL = process.env.MARROW_BASE_URL || 'https://api.getmarrow.ai';
+const SESSION_ID = process.env.MARROW_SESSION_ID || undefined;
+if (!API_KEY) {
+    process.stderr.write('Error: MARROW_API_KEY environment variable is required\n');
+    process.exit(1);
+}
+// Auto-orient on startup — cache warnings, inject into first marrow_think response
+let cachedOrientWarnings = [];
+(0, index_1.marrowOrient)(API_KEY, BASE_URL, undefined, SESSION_ID).then(r => {
+    cachedOrientWarnings = r.warnings;
+    if (r.shouldPause) {
+        process.stderr.write(`[marrow] ⚠️ High failure rate detected on startup — call marrow_orient for details before acting\n`);
+    }
+}).catch(() => { });
+// Auto-commit tracking for session close
+let lastDecisionId = null;
+let lastCommitted = false;
+async function autoCommitOnClose() {
+    if (lastDecisionId && !lastCommitted) {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 3000);
+            await (0, index_1.marrowCommit)(API_KEY, BASE_URL, {
+                decision_id: lastDecisionId,
+                success: true,
+                outcome: 'Session ended',
+            }, SESSION_ID);
+            clearTimeout(timeout);
+        }
+        catch { }
+    }
+}
+process.on('SIGTERM', async () => {
+    const forceExit = setTimeout(() => process.exit(0), 5000);
+    forceExit.unref();
+    await autoCommitOnClose();
+    process.exit(0);
+});
+process.stdin.on('end', async () => { await autoCommitOnClose(); });
+function send(response) {
+    process.stdout.write(JSON.stringify(response) + '\n');
+}
+function success(id, result) {
+    send({ jsonrpc: '2.0', id, result });
+}
+function error(id, code, message) {
+    send({ jsonrpc: '2.0', id, error: { code, message } });
+}
+// Tool definitions
+const TOOLS = [
+    {
+        name: 'marrow_orient',
+        description: '⚡ CALL THIS FIRST at the start of every session or task — before marrow_think, before any action. ' +
+            'Returns failure warnings from your hive history so you avoid known mistakes immediately. ' +
+            'If shouldPause=true, query for lessons before proceeding. ' +
+            'This is what makes Marrow compound — orient() reads, think() writes. Both are required.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                taskType: {
+                    type: 'string',
+                    enum: ['implementation', 'security', 'architecture', 'process', 'general'],
+                    description: 'Optional: filter warnings to a specific task type you are about to perform',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'marrow_think',
+        description: 'Get collective intelligence from the Marrow hive before acting. ' +
+            'Returns pattern insights, failure detection, workflow gaps, and semantic clustering. ' +
+            'Call this before every significant action. Pass previous_outcome ' +
+            'to auto-commit your last action and open a new memory session. ' +
+            'Response includes: decision_id, insight (string), insights[] (ActionableInsight[]), cluster_id.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    description: 'What the agent is about to do',
+                },
+                type: {
+                    type: 'string',
+                    enum: ['implementation', 'security', 'architecture', 'process', 'general'],
+                    description: 'Type of action (default: general)',
+                },
+                context: {
+                    type: 'object',
+                    description: 'Optional metadata about the current situation',
+                },
+                previous_decision_id: {
+                    type: 'string',
+                    description: 'decision_id from previous think() call — auto-commits that session',
+                },
+                previous_success: {
+                    type: 'boolean',
+                    description: 'Did the previous action succeed?',
+                },
+                previous_outcome: {
+                    type: 'string',
+                    description: 'What happened in the previous action (required if previous_decision_id provided)',
+                },
+            },
+            required: ['action'],
+        },
+    },
+    {
+        name: 'marrow_commit',
+        description: 'Explicitly commit the result of an action to Marrow. ' +
+            'Optional — marrow_think() auto-commits if you pass previous_outcome. ' +
+            'Use when you need explicit control over commit timing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                decision_id: {
+                    type: 'string',
+                    description: 'decision_id from the marrow_think call',
+                },
+                success: {
+                    type: 'boolean',
+                    description: 'Did the action succeed?',
+                },
+                outcome: {
+                    type: 'string',
+                    description: 'What happened — be specific, this trains the hive',
+                },
+                caused_by: {
+                    type: 'string',
+                    description: 'Optional: what caused this action',
+                },
+            },
+            required: ['decision_id', 'success', 'outcome'],
+        },
+    },
+    {
+        name: 'marrow_run',
+        description: 'Single-call task wrapper. Automatically handles orient → think → commit. ' +
+            'Use instead of chaining marrow_think + marrow_commit separately.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                description: {
+                    type: 'string',
+                    description: 'What the agent did',
+                },
+                success: {
+                    type: 'boolean',
+                    description: 'Whether it succeeded',
+                },
+                outcome: {
+                    type: 'string',
+                    description: 'One-line summary of what happened',
+                },
+                type: {
+                    type: 'string',
+                    enum: ['implementation', 'security', 'architecture', 'process', 'general'],
+                    description: 'Type of action (default: general)',
+                },
+            },
+            required: ['description', 'success', 'outcome'],
+        },
+    },
+    {
+        name: 'marrow_status',
+        description: 'Check Marrow platform health and status.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+];
+// Request handler
+async function handleRequest(req) {
+    const { id, method, params } = req;
+    try {
+        if (method === 'initialize') {
+            success(id, {
+                protocolVersion: '2024-11-05',
+                capabilities: { tools: {} },
+                serverInfo: { name: 'marrow', version: '2.5.0' },
+            });
+            return;
+        }
+        if (method === 'tools/list') {
+            success(id, { tools: TOOLS });
+            return;
+        }
+        if (method === 'tools/call') {
+            const toolName = params?.name;
+            const args = (params?.arguments || {});
+            if (toolName === 'marrow_orient') {
+                const result = await (0, index_1.marrowOrient)(API_KEY, BASE_URL, {
+                    taskType: args.taskType,
+                }, SESSION_ID);
+                success(id, {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                });
+                return;
+            }
+            if (toolName === 'marrow_think') {
+                const result = await (0, index_1.marrowThink)(API_KEY, BASE_URL, {
+                    action: args.action,
+                    type: args.type,
+                    context: args.context,
+                    previous_decision_id: args.previous_decision_id,
+                    previous_success: args.previous_success,
+                    previous_outcome: args.previous_outcome,
+                }, SESSION_ID);
+                // Inject startup orient warnings into first think() response
+                if (cachedOrientWarnings.length > 0) {
+                    const intel = result.intelligence;
+                    const existing = intel.insights || [];
+                    intel.insights = [
+                        ...cachedOrientWarnings.map(w => ({
+                            type: 'failure_pattern',
+                            summary: w.message,
+                            action: `Review past ${w.type} failures before proceeding`,
+                            severity: w.failureRate > 0.4 ? 'critical' : 'warning',
+                            count: 0,
+                        })),
+                        ...existing,
+                    ];
+                    cachedOrientWarnings = []; // clear after first injection
+                }
+                // Track for auto-commit on session close
+                lastDecisionId = result.decision_id;
+                lastCommitted = false;
+                success(id, {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                });
+                return;
+            }
+            if (toolName === 'marrow_commit') {
+                const result = await (0, index_1.marrowCommit)(API_KEY, BASE_URL, {
+                    decision_id: args.decision_id,
+                    success: args.success,
+                    outcome: args.outcome,
+                    caused_by: args.caused_by,
+                }, SESSION_ID);
+                lastCommitted = true;
+                success(id, {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                });
+                return;
+            }
+            if (toolName === 'marrow_run') {
+                const description = args.description;
+                const type = args.type || 'general';
+                const runSuccess = args.success;
+                const outcome = args.outcome;
+                const thinkResult = await (0, index_1.marrowThink)(API_KEY, BASE_URL, {
+                    action: description,
+                    type,
+                }, SESSION_ID);
+                const commitResult = await (0, index_1.marrowCommit)(API_KEY, BASE_URL, {
+                    decision_id: thinkResult.decision_id,
+                    success: runSuccess,
+                    outcome,
+                }, SESSION_ID);
+                lastCommitted = true;
+                lastDecisionId = thinkResult.decision_id;
+                success(id, {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                decision_id: thinkResult.decision_id,
+                                success_rate: commitResult.success_rate,
+                                insight: commitResult.insight,
+                                intelligence: thinkResult.intelligence,
+                            }, null, 2),
+                        },
+                    ],
+                });
+                return;
+            }
+            if (toolName === 'marrow_status') {
+                const result = await (0, index_1.marrowStatus)(API_KEY, BASE_URL, SESSION_ID);
+                success(id, {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                });
+                return;
+            }
+            error(id, -32601, `Unknown tool: ${toolName}`);
+            return;
+        }
+        // Unknown method
+        error(id, -32601, `Method not found: ${method}`);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message.slice(0, 200) : 'Internal error';
+        error(id, -32603, msg);
+    }
+}
+// stdio server
+const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    terminal: false,
+});
+rl.on('line', (line) => {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return;
+    try {
+        const req = JSON.parse(trimmed);
+        handleRequest(req).catch((err) => {
+            process.stderr.write(`Unhandled error: ${err}\n`);
+        });
+    }
+    catch {
+        process.stderr.write(`Failed to parse request: ${trimmed}\n`);
+    }
+});
+rl.on('close', () => {
+    process.exit(0);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AAEA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,mDAAqC;AACrC,mCAAgF;AAEhF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;AACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,0BAA0B,CAAC;AAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,SAAS,CAAC;AAE9D,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,mFAAmF;AACnF,IAAI,oBAAoB,GAAkE,EAAE,CAAC;AAC7F,IAAA,oBAAY,EAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;IAC9D,oBAAoB,GAAG,CAAC,CAAC,QAAQ,CAAC;IAClC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oGAAoG,CAAC,CAAC;IAC7H,CAAC;AACH,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAEnB,yCAAyC;AACzC,IAAI,cAAc,GAAkB,IAAI,CAAC;AACzC,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B,KAAK,UAAU,iBAAiB;IAC9B,IAAI,cAAc,IAAI,CAAC,aAAa,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;YAC3D,MAAM,IAAA,oBAAY,EAAC,OAAO,EAAE,QAAQ,EAAE;gBACpC,WAAW,EAAE,cAAc;gBAC3B,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,eAAe;aACzB,EAAE,UAAU,CAAC,CAAC;YACf,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;AACH,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;IAC/B,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1D,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,MAAM,iBAAiB,EAAE,CAAC;IAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAiBpE,SAAS,IAAI,CAAC,QAAqB;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,OAAO,CAAC,EAAmB,EAAE,MAAe;IACnD,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,KAAK,CAAC,EAAmB,EAAE,IAAY,EAAE,OAAe;IAC/D,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,mBAAmB;AACnB,MAAM,KAAK,GAAG;IACZ;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,oGAAoG;YACpG,2FAA2F;YAC3F,4DAA4D;YAC5D,yFAAyF;QAC3F,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,CAAC;oBAC1E,WAAW,EAAE,4EAA4E;iBAC1F;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,kEAAkE;YAClE,uFAAuF;YACvF,mEAAmE;YACnE,iEAAiE;YACjE,iGAAiG;QACnG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,CAAC;oBAC1E,WAAW,EAAE,mCAAmC;iBACjD;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;iBAC7D;gBACD,oBAAoB,EAAE;oBACpB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oEAAoE;iBAClF;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,kCAAkC;iBAChD;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kFAAkF;iBAChG;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,uDAAuD;YACvD,uEAAuE;YACvE,wDAAwD;QAC1D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wCAAwC;iBACtD;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,yBAAyB;iBACvC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mDAAmD;iBACjE;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC;iBACjD;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC;SAChD;KACF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,2EAA2E;YAC3E,kEAAkE;QACpE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oBAAoB;iBAClC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,sBAAsB;iBACpC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC;iBACjD;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,CAAC;oBAC1E,WAAW,EAAE,mCAAmC;iBACjD;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC;SAChD;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,0CAA0C;QACvD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC;AAEF,kBAAkB;AAClB,KAAK,UAAU,aAAa,CAAC,GAAe;IAC1C,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAEnC,IAAI,CAAC;QACH,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YAC5B,OAAO,CAAC,EAAE,EAAE;gBACV,eAAe,EAAE,YAAY;gBAC7B,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE;aACjD,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YAC5B,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAI,MAAkC,EAAE,IAAc,CAAC;YACrE,MAAM,IAAI,GAAG,CAAE,MAAkC,EAAE,SAAS,IAAI,EAAE,CAA4B,CAAC;YAE/F,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAY,EAAC,OAAO,EAAE,QAAQ,EAAE;oBACnD,QAAQ,EAAE,IAAI,CAAC,QAA8B;iBAC9C,EAAE,UAAU,CAAC,CAAC;gBACf,OAAO,CAAC,EAAE,EAAE;oBACV,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAW,EAAC,OAAO,EAAE,QAAQ,EAAE;oBAClD,MAAM,EAAE,IAAI,CAAC,MAAgB;oBAC7B,IAAI,EAAE,IAAI,CAAC,IAA0B;oBACrC,OAAO,EAAE,IAAI,CAAC,OAA8C;oBAC5D,oBAAoB,EAAE,IAAI,CAAC,oBAA0C;oBACrE,gBAAgB,EAAE,IAAI,CAAC,gBAAuC;oBAC9D,gBAAgB,EAAE,IAAI,CAAC,gBAAsC;iBAC9D,EAAE,UAAU,CAAC,CAAC;gBACf,6DAA6D;gBAC7D,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpC,MAAM,KAAK,GAAG,MAAM,CAAC,YAAkD,CAAC;oBACxE,MAAM,QAAQ,GAAI,KAAK,CAAC,QAAsB,IAAI,EAAE,CAAC;oBACrD,KAAK,CAAC,QAAQ,GAAG;wBACf,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;4BAChC,IAAI,EAAE,iBAAiB;4BACvB,OAAO,EAAE,CAAC,CAAC,OAAO;4BAClB,MAAM,EAAE,eAAe,CAAC,CAAC,IAAI,6BAA6B;4BAC1D,QAAQ,EAAE,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;4BACtD,KAAK,EAAE,CAAC;yBACT,CAAC,CAAC;wBACH,GAAG,QAAQ;qBACZ,CAAC;oBACF,oBAAoB,GAAG,EAAE,CAAC,CAAC,8BAA8B;gBAC3D,CAAC;gBACD,yCAAyC;gBACzC,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC;gBACpC,aAAa,GAAG,KAAK,CAAC;gBACtB,OAAO,CAAC,EAAE,EAAE;oBACV,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAY,EAAC,OAAO,EAAE,QAAQ,EAAE;oBACnD,WAAW,EAAE,IAAI,CAAC,WAAqB;oBACvC,OAAO,EAAE,IAAI,CAAC,OAAkB;oBAChC,OAAO,EAAE,IAAI,CAAC,OAAiB;oBAC/B,SAAS,EAAE,IAAI,CAAC,SAA+B;iBAChD,EAAE,UAAU,CAAC,CAAC;gBACf,aAAa,GAAG,IAAI,CAAC;gBACrB,OAAO,CAAC,EAAE,EAAE;oBACV,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAqB,CAAC;gBAC/C,MAAM,IAAI,GAAI,IAAI,CAAC,IAAe,IAAI,SAAS,CAAC;gBAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAkB,CAAC;gBAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;gBAEvC,MAAM,WAAW,GAAG,MAAM,IAAA,mBAAW,EAAC,OAAO,EAAE,QAAQ,EAAE;oBACvD,MAAM,EAAE,WAAW;oBACnB,IAAI;iBACL,EAAE,UAAU,CAAC,CAAC;gBAEf,MAAM,YAAY,GAAG,MAAM,IAAA,oBAAY,EAAC,OAAO,EAAE,QAAQ,EAAE;oBACzD,WAAW,EAAE,WAAW,CAAC,WAAW;oBACpC,OAAO,EAAE,UAAU;oBACnB,OAAO;iBACR,EAAE,UAAU,CAAC,CAAC;gBAEf,aAAa,GAAG,IAAI,CAAC;gBACrB,cAAc,GAAG,WAAW,CAAC,WAAW,CAAC;gBAEzC,OAAO,CAAC,EAAE,EAAE;oBACV,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,WAAW,EAAE,WAAW,CAAC,WAAW;gCACpC,YAAY,EAAE,YAAY,CAAC,YAAY;gCACvC,OAAO,EAAE,YAAY,CAAC,OAAO;gCAC7B,YAAY,EAAE,WAAW,CAAC,YAAY;6BACvC,EAAE,IAAI,EAAE,CAAC,CAAC;yBACZ;qBACF;iBACF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAY,EAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;gBACjE,OAAO,CAAC,EAAE,EAAE;oBACV,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,iBAAiB,QAAQ,EAAE,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,iBAAiB;QACjB,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,qBAAqB,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAChF,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,eAAe;AACf,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;IAClC,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,QAAQ,EAAE,KAAK;CAChB,CAAC,CAAC;AAEH,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;IACrB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO;IAErB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAe,CAAC;QAC9C,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,OAAO,IAAI,CAAC,CAAC;IAChE,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;IAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,109 @@
-#!/usr/bin/env node
-export {};
+export interface ActionableInsight {
+    type: 'frequency' | 'failure_pattern' | 'workflow_gap' | 'hive_trend';
+    summary: string;
+    action: string;
+    severity: 'info' | 'warning' | 'critical';
+    count: number;
+}
+export interface MarrowIntelligence {
+    similar: Array<{
+        outcome: string;
+        confidence: number;
+    }>;
+    similar_count: number;
+    patterns: Array<{
+        pattern_id: string;
+        decision_type: string;
+        frequency: number;
+        confidence: number;
+    }>;
+    patterns_count: number;
+    templates: Array<{
+        steps: unknown[];
+        success_rate: number;
+    }>;
+    shared: Array<{
+        outcome: string;
+    }>;
+    causal_chain: unknown | null;
+    success_rate: number;
+    priority_score: number;
+    insight: string | null;
+    insights: ActionableInsight[];
+    cluster_id: string | null;
+}
+export interface ThinkResult {
+    decision_id: string;
+    intelligence: MarrowIntelligence;
+    stream_url: string;
+    previous_committed?: boolean;
+    sanitized?: boolean;
+    upgrade_hint?: {
+        message: string;
+        tier: string;
+        url: string;
+    };
+}
+export interface CommitResult {
+    committed: boolean;
+    success_rate: number;
+    insight: string | null;
+}
+export interface StatusResult {
+    status: string;
+    version: string;
+    tiers: number;
+    uptime_ms: number;
+}
+export declare function marrowThink(apiKey: string, baseUrl: string, params: {
+    action: string;
+    type?: string;
+    context?: Record<string, unknown>;
+    previous_decision_id?: string;
+    previous_success?: boolean;
+    previous_outcome?: string;
+}, sessionId?: string): Promise<ThinkResult>;
+export declare function marrowCommit(apiKey: string, baseUrl: string, params: {
+    decision_id: string;
+    success: boolean;
+    outcome: string;
+    caused_by?: string;
+}, sessionId?: string): Promise<CommitResult>;
+export interface AgentPatternsResult {
+    failure_patterns: Array<{
+        decision_type: string;
+        failure_rate: number;
+        count: number;
+        last_seen: string;
+    }>;
+    recurring_decisions: Array<{
+        decision_type: string;
+        frequency: number;
+        avg_confidence: number;
+        trend: string;
+    }>;
+    behavioral_drift: {
+        success_rate_7d: number;
+        success_rate_30d: number;
+        drift: string;
+        direction: string;
+    };
+    top_failure_types: string[];
+    generated_at: string;
+}
+export declare function marrowAgentPatterns(apiKey: string, baseUrl: string, params?: {
+    type?: string;
+    limit?: number;
+}, sessionId?: string): Promise<AgentPatternsResult>;
+export declare function marrowOrient(apiKey: string, baseUrl: string, params?: {
+    taskType?: string;
+}, sessionId?: string): Promise<{
+    warnings: Array<{
+        type: string;
+        failureRate: number;
+        message: string;
+    }>;
+    shouldPause: boolean;
+}>;
+export declare function marrowStatus(apiKey: string, baseUrl: string, sessionId?: string): Promise<StatusResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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