@getmarrow/sdk 2.2.0

package/README.md

@@ -0,0 +1,69 @@
+# @getmarrow/sdk
+
+**Your go-to memory provider for all agents, for any AI model.**
+
+Every decision your agent makes compounds into the Marrow hive. Every agent using Marrow makes yours smarter.
+
+## Install
+
+```bash
+npm install @getmarrow/sdk
+```
+
+## Quick Start
+
+```typescript
+import { MarrowClient } from '@getmarrow/sdk';
+
+const marrow = new MarrowClient('mrw_your_key');
+
+let decisionId = null;
+
+// Before every action — ask the hive
+const { decisionId: id, intelligence } = await marrow.think({
+  action: 'deploying auth system',
+  type: 'implementation',
+  // Auto-commits previous action:
+  previousSuccess: true,
+  previousOutcome: 'Last deploy succeeded, 0 errors'
+});
+
+decisionId = id;
+
+// intelligence.similar      → what worked before in the hive
+// intelligence.patterns     → patterns the hive has discovered
+// intelligence.successRate  → how you're doing vs other agents
+// intelligence.templates    → proven playbooks
+
+// ... your agent acts ...
+
+// Next think() auto-commits this one
+```
+
+## API
+
+### `marrow.think(params)` — primary method
+
+```typescript
+const { decisionId, intelligence } = await marrow.think({
+  action: string,
+  type?: 'implementation' | 'security' | 'architecture' | 'process' | 'general',
+  context?: Record<string, unknown>,
+  previousSuccess?: boolean,
+  previousOutcome?: string,
+});
+```
+
+### `marrow.commit(params)` — explicit commit (optional)
+
+```typescript
+await marrow.commit({
+  success: boolean,
+  outcome: string,
+  causedBy?: string,
+});
+```
+
+## Get a Key
+
+[portal.getmarrow.ai](https://portal.getmarrow.ai)

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+export declare class MarrowClient {
+    private apiKey;
+    private baseUrl;
+    private decisionId;
+    constructor(apiKey: string, baseUrl?: string);
+    think(params: {
+        action: string;
+        type?: 'implementation' | 'security' | 'architecture' | 'process' | 'general';
+        context?: Record<string, unknown>;
+        previousSuccess?: boolean;
+        previousOutcome?: string;
+        previousCausedBy?: string;
+    }): Promise<{
+        decisionId: string;
+        intelligence: {
+            similar: Array<{
+                outcome: string;
+                confidence: number;
+            }>;
+            patterns: Array<{
+                pattern: string;
+                frequency: number;
+            }>;
+            templates: Array<{
+                steps: unknown[];
+                success_rate: number;
+            }>;
+            shared: Array<{
+                outcome: string;
+            }>;
+            causalChain: unknown | null;
+            successRate: number;
+            priorityScore: number;
+        };
+        streamUrl: string;
+        previousCommitted?: boolean;
+    }>;
+    commit(params: {
+        success: boolean;
+        outcome: string;
+        causedBy?: string;
+    }): Promise<{
+        committed: boolean;
+        successRate: number;
+        insight: string | null;
+    }>;
+    private request;
+}
+export default MarrowClient;
+//# 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":"AAAA,qBAAa,YAAY;IAGX,OAAO,CAAC,MAAM;IAAU,OAAO,CAAC,OAAO;IAFnD,OAAO,CAAC,UAAU,CAAuB;gBAErB,MAAM,EAAE,MAAM,EAAU,OAAO,SAA6B;IAG1E,KAAK,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,gBAAgB,GAAG,UAAU,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;QAC9E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAElC,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE;YACZ,OAAO,EAAE,KAAK,CAAC;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YACxD,QAAQ,EAAE,KAAK,CAAC;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YACxD,SAAS,EAAE,KAAK,CAAC;gBAAE,KAAK,EAAE,OAAO,EAAE,CAAC;gBAAC,YAAY,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAC7D,MAAM,EAAE,KAAK,CAAC;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YACnC,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;YAC5B,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;IA+BI,MAAM,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;YAiBlE,OAAO;CAatB;AAED,eAAe,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarrowClient = void 0;
+class MarrowClient {
+    constructor(apiKey, baseUrl = 'https://api.getmarrow.ai') {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+        this.decisionId = null;
+    }
+    // PRIMARY METHOD — call before every agent action
+    async think(params) {
+        const body = {
+            action: params.action,
+            type: params.type || 'general',
+            context: params.context,
+        };
+        if (this.decisionId) {
+            body.previous_decision_id = this.decisionId;
+            body.previous_success = params.previousSuccess ?? true;
+            body.previous_outcome = params.previousOutcome ?? '';
+            if (params.previousCausedBy)
+                body.previous_caused_by = params.previousCausedBy;
+        }
+        const res = await this.request('POST', '/v1/agent/think', body);
+        this.decisionId = res.decision_id;
+        return {
+            decisionId: res.decision_id,
+            intelligence: {
+                similar: res.intelligence?.similar || [],
+                patterns: res.intelligence?.patterns || [],
+                templates: res.intelligence?.templates || [],
+                shared: res.intelligence?.shared || [],
+                causalChain: res.intelligence?.causal_chain || null,
+                successRate: res.intelligence?.success_rate || 0,
+                priorityScore: res.intelligence?.priority_score || 0,
+            },
+            streamUrl: res.stream_url,
+            previousCommitted: res.previous_committed,
+        };
+    }
+    // Explicit commit (optional — think() auto-commits on next call)
+    async commit(params) {
+        if (!this.decisionId)
+            throw new Error('No active decision. Call think() first.');
+        const res = await this.request('POST', '/v1/agent/commit', {
+            decision_id: this.decisionId,
+            success: params.success,
+            outcome: params.outcome,
+            caused_by: params.causedBy,
+        });
+        this.decisionId = null;
+        return {
+            committed: res.committed,
+            successRate: res.success_rate,
+            insight: res.insight,
+        };
+    }
+    // Raw request helper
+    async request(method, path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const json = await res.json();
+        if (json.error)
+            throw new Error(json.error);
+        return json.data;
+    }
+}
+exports.MarrowClient = MarrowClient;
+exports.default = MarrowClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAY;IAGvB,YAAoB,MAAc,EAAU,UAAU,0BAA0B;QAA5D,WAAM,GAAN,MAAM,CAAQ;QAAU,YAAO,GAAP,OAAO,CAA6B;QAFxE,eAAU,GAAkB,IAAI,CAAC;IAE0C,CAAC;IAEpF,kDAAkD;IAClD,KAAK,CAAC,KAAK,CAAC,MAQX;QAcC,MAAM,IAAI,GAA4B;YACpC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS;YAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;QACF,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,UAAU,CAAC;YAC5C,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC;YACvD,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC;YACrD,IAAI,MAAM,CAAC,gBAAgB;gBAAE,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACjF,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,WAAqB,CAAC;QAC5C,OAAO;YACL,UAAU,EAAE,GAAG,CAAC,WAAqB;YACrC,YAAY,EAAE;gBACZ,OAAO,EAAG,GAAG,CAAC,YAAwC,EAAE,OAAyD,IAAI,EAAE;gBACvH,QAAQ,EAAG,GAAG,CAAC,YAAwC,EAAE,QAAyD,IAAI,EAAE;gBACxH,SAAS,EAAG,GAAG,CAAC,YAAwC,EAAE,SAA8D,IAAI,EAAE;gBAC9H,MAAM,EAAG,GAAG,CAAC,YAAwC,EAAE,MAAoC,IAAI,EAAE;gBACjG,WAAW,EAAG,GAAG,CAAC,YAAwC,EAAE,YAAY,IAAI,IAAI;gBAChF,WAAW,EAAG,GAAG,CAAC,YAAwC,EAAE,YAAsB,IAAI,CAAC;gBACvF,aAAa,EAAG,GAAG,CAAC,YAAwC,EAAE,cAAwB,IAAI,CAAC;aAC5F;YACD,SAAS,EAAE,GAAG,CAAC,UAAoB;YACnC,iBAAiB,EAAE,GAAG,CAAC,kBAAyC;SACjE,CAAC;IACJ,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,MAAM,CAAC,MAIZ;QACC,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACjF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE;YACzD,WAAW,EAAE,IAAI,CAAC,UAAU;YAC5B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,QAAQ;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO;YACL,SAAS,EAAE,GAAG,CAAC,SAAoB;YACnC,WAAW,EAAE,GAAG,CAAC,YAAsB;YACvC,OAAO,EAAE,GAAG,CAAC,OAAwB;SACtC,CAAC;IACJ,CAAC;IAED,qBAAqB;IACb,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,IAAY,EAAE,IAAc;QAChE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YAChD,MAAM;YACN,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACxC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAuD,CAAC;QACnF,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AA5FD,oCA4FC;AAED,kBAAe,YAAY,CAAC"}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@getmarrow/sdk",
+  "version": "2.2.0",
+  "description": "Your go-to memory provider for all agents, for any AI model.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "node dist/index.js"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "memory",
+    "hive",
+    "collective-intelligence"
+  ],
+  "license": "MIT"
+}

package/src/index.ts

@@ -0,0 +1,95 @@
+export class MarrowClient {
+  private decisionId: string | null = null;
+
+  constructor(private apiKey: string, private baseUrl = 'https://api.getmarrow.ai') {}
+
+  // PRIMARY METHOD — call before every agent action
+  async think(params: {
+    action: string;
+    type?: 'implementation' | 'security' | 'architecture' | 'process' | 'general';
+    context?: Record<string, unknown>;
+    // Previous session (auto-commits it):
+    previousSuccess?: boolean;
+    previousOutcome?: string;
+    previousCausedBy?: string;
+  }): Promise<{
+    decisionId: string;
+    intelligence: {
+      similar: Array<{ outcome: string; confidence: number }>;
+      patterns: Array<{ pattern: string; frequency: number }>;
+      templates: Array<{ steps: unknown[]; success_rate: number }>;
+      shared: Array<{ outcome: string }>;
+      causalChain: unknown | null;
+      successRate: number;
+      priorityScore: number;
+    };
+    streamUrl: string;
+    previousCommitted?: boolean;
+  }> {
+    const body: Record<string, unknown> = {
+      action: params.action,
+      type: params.type || 'general',
+      context: params.context,
+    };
+    if (this.decisionId) {
+      body.previous_decision_id = this.decisionId;
+      body.previous_success = params.previousSuccess ?? true;
+      body.previous_outcome = params.previousOutcome ?? '';
+      if (params.previousCausedBy) body.previous_caused_by = params.previousCausedBy;
+    }
+    const res = await this.request('POST', '/v1/agent/think', body);
+    this.decisionId = res.decision_id as string;
+    return {
+      decisionId: res.decision_id as string,
+      intelligence: {
+        similar: (res.intelligence as Record<string, unknown>)?.similar as Array<{ outcome: string; confidence: number }> || [],
+        patterns: (res.intelligence as Record<string, unknown>)?.patterns as Array<{ pattern: string; frequency: number }> || [],
+        templates: (res.intelligence as Record<string, unknown>)?.templates as Array<{ steps: unknown[]; success_rate: number }> || [],
+        shared: (res.intelligence as Record<string, unknown>)?.shared as Array<{ outcome: string }> || [],
+        causalChain: (res.intelligence as Record<string, unknown>)?.causal_chain || null,
+        successRate: (res.intelligence as Record<string, unknown>)?.success_rate as number || 0,
+        priorityScore: (res.intelligence as Record<string, unknown>)?.priority_score as number || 0,
+      },
+      streamUrl: res.stream_url as string,
+      previousCommitted: res.previous_committed as boolean | undefined,
+    };
+  }
+
+  // Explicit commit (optional — think() auto-commits on next call)
+  async commit(params: {
+    success: boolean;
+    outcome: string;
+    causedBy?: string;
+  }): Promise<{ committed: boolean; successRate: number; insight: string | null }> {
+    if (!this.decisionId) throw new Error('No active decision. Call think() first.');
+    const res = await this.request('POST', '/v1/agent/commit', {
+      decision_id: this.decisionId,
+      success: params.success,
+      outcome: params.outcome,
+      caused_by: params.causedBy,
+    });
+    this.decisionId = null;
+    return {
+      committed: res.committed as boolean,
+      successRate: res.success_rate as number,
+      insight: res.insight as string | null,
+    };
+  }
+
+  // Raw request helper
+  private async request(method: string, path: string, body?: unknown): Promise<Record<string, unknown>> {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        'Authorization': `Bearer ${this.apiKey}`,
+        'Content-Type': 'application/json',
+      },
+      body: body ? JSON.stringify(body) : undefined,
+    });
+    const json = await res.json() as { data: Record<string, unknown>; error?: string };
+    if (json.error) throw new Error(json.error);
+    return json.data;
+  }
+}
+
+export default MarrowClient;

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}