@getmarrow/sdk 3.0.0 → 3.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +31 -50
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -23,67 +23,48 @@ That's fine for a toy. It's a problem for anything real.
23
23
 
24
24
  ---
25
25
 
26
- ## What's New in v2.9.2
26
+ ## What's New in v3.0.0
27
27
 
28
- **Backend API Enhancements** — Full memory lifecycle management now available:
28
+ **Active Intelligence — Marrow Now Intervenes Before Mistakes**
29
29
 
30
- ### Cross-Agent Memory Sharing
31
- Share memories with specific agents or all agents in your account:
32
- ```typescript
33
- // After creating a memory, share it with another agent
34
- await marrow.memories.share(memoryId, { agentIds: ['darvis', 'barvis'] });
35
-
36
- // List now includes memories shared with your agents
37
- const memories = await marrow.memories.list({ agentId: 'jarvis' });
38
- ```
30
+ ### Auto-Warn on Orient
31
+ When you call `orient({autoWarn: true})`, Marrow scans your recent decisions and warns you BEFORE you start a task that recently failed:
39
32
 
40
- ### Memory Export/Import
41
- Backup and restore memories across sessions or accounts:
42
33
  ```typescript
43
- // Export all memories to JSON
44
- const exportData = await marrow.memories.export({ format: 'json', status: 'active' });
34
+ const result = await marrow.orient({
35
+ task: "Fix Neutron API authentication",
36
+ autoWarn: true
37
+ });
45
38
 
46
- // Import with merge (dedup) or replace mode
47
- await marrow.memories.import({ memories: exportData.memories, mode: 'merge' });
39
+ // Returns warnings like:
40
+ // "⚠️ HIGH: This task type failed 4x with method='internal'.
41
+ // Try method='neutronpay' (89% success rate)"
48
42
  ```
49
43
 
50
- ### Advanced FTS Filters
51
- Precision search with multiple filters:
44
+ ### Loop Detection on Think
45
+ When you call `think({checkLoop: true})`, Marrow detects if you're about to retry a failed approach and interrupts:
46
+
52
47
  ```typescript
53
- const results = await marrow.memories.retrieve({
54
- query: 'auth fix',
55
- from: '2026-04-01',
56
- to: '2026-04-08',
57
- tags: ['security', 'marrow'],
58
- source: 'session_bootstrap',
59
- status: 'active',
48
+ const decision = await marrow.think({
49
+ action: "Retry auth with method='internal'",
50
+ checkLoop: true
60
51
  });
52
+
53
+ // Returns loop warnings:
54
+ // "🚨 LOOP DETECTED: You're retrying a failed approach.
55
+ // Previous failure: 'internal' method not supported.
56
+ // Suggested: Use method='neutronpay' instead."
61
57
  ```
62
58
 
63
- ### New Memory Management Endpoints
64
- - `GET /v1/memories` — List memories with pagination and filters
65
- - `GET /v1/memories/:id` — Get single memory by ID
66
- - `PATCH /v1/memories/:id` — Update memory text, tags, or metadata
67
- - `POST /v1/memories/:id/outdated` — Mark memory as outdated
68
- - `POST /v1/memories/:id/supersede` — Atomically replace with new version
69
- - `DELETE /v1/memories/:id` — Soft delete
70
- - `GET /v1/memories/export` — Export to JSON or CSV
71
- - `POST /v1/memories/import` — Import with merge/replace mode
72
- - `POST /v1/memories/:id/share` — Share with agents
73
- - `GET /v1/memories/retrieve` — FTS search with filters
74
-
75
- ### Security Hardening
76
- - Account isolation enforced (no cross-account leakage)
77
- - Agent ID validation on all endpoints
78
- - Audit logging for export/import operations
79
- - Rate limiting on export (5/hour)
80
- - SHA-256 dedup on import (checks ALL memories, not just first 200)
81
-
82
- ### Privacy & PII Protection
83
- - **Automatic PII stripping** — Sensitive data (emails, phone numbers, API keys, tokens) is detected and stripped before storage
84
- - **Export verification** — Export your data anytime to verify what's stored and confirm PII is stripped
85
- - **Data ownership** — You own all your data; export and delete anytime
86
- - **All features free** — No paywalls on security or privacy features
59
+ ### Rate Limiting
60
+ - `orient`: 30 requests/minute per account
61
+ - `think`: 60 requests/minute per account
62
+ - Automatic 429 responses when limit exceeded
63
+
64
+ ### Enhanced PII Protection
65
+ - Automatic stripping of emails, phone numbers, API keys from all responses
66
+ - Applied to `recentLessons`, `warnings`, and `outcome` fields
67
+ - Deep object stripping for complex data structures
87
68
 
88
69
  ---
89
70
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getmarrow/sdk",
3
- "version": "3.0.0",
3
+ "version": "3.0.2",
4
4
  "description": "Your go-to memory provider for all agents, for any AI model.",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",