@getmarrow/sdk 2.7.0 → 2.9.0

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.
@@ -0,0 +1,218 @@
1
+ /**
2
+ * @getmarrow/sdk — Type Definitions
3
+ */
4
+ export type MarrowDecisionType = 'implementation' | 'security' | 'architecture' | 'process' | 'general';
5
+ export type MarrowEnforcementMode = 'off' | 'warn' | 'require' | 'auto';
6
+ export type MarrowLoopRecommendation = 'orient' | 'think' | 'act' | 'commit' | 'done';
7
+ export type MarrowBlockReasonCode = 'missing_intent_for_external_action' | 'missing_outcome_for_completion' | 'loop_closed' | 'no_meaningful_action';
8
+ export type MarrowActionClass = 'read_only' | 'low_risk_internal' | 'state_changing_internal' | 'external_irreversible';
9
+ export type MarrowChokePoint = 'publish' | 'deploy' | 'outbound_message' | 'external_write' | 'handoff' | 'other';
10
+ export type MemoryStatus = 'active' | 'outdated' | 'superseded' | 'deleted';
11
+ export type MemoryAuditAction = 'created' | 'edited' | 'deleted' | 'marked_outdated' | 'superseded' | 'created_as_replacement' | 'bootstrapped';
12
+ export interface ActionableInsight {
13
+ type: 'frequency' | 'failure_pattern' | 'workflow_gap' | 'hive_trend';
14
+ summary: string;
15
+ action: string;
16
+ severity: 'info' | 'warning' | 'critical';
17
+ count: number;
18
+ }
19
+ export interface MarrowMemoryAuditEntry {
20
+ action: MemoryAuditAction;
21
+ timestamp: string;
22
+ actor: string;
23
+ note: string;
24
+ [key: string]: unknown;
25
+ }
26
+ export interface MarrowMemory {
27
+ id: string;
28
+ text: string;
29
+ status: MemoryStatus;
30
+ createdAt: string;
31
+ updatedAt: string;
32
+ source: string | null;
33
+ tags: string[];
34
+ supersedes: string | null;
35
+ supersededBy: string | null;
36
+ deletedAt: string | null;
37
+ audit: MarrowMemoryAuditEntry[];
38
+ }
39
+ export interface MarrowMemoryRetrievalResult {
40
+ memories: MarrowMemory[];
41
+ query: string;
42
+ count: number;
43
+ }
44
+ export interface MarrowLoopState {
45
+ mode: MarrowEnforcementMode;
46
+ orientedAt: string | null;
47
+ lastThinkAt: string | null;
48
+ lastOutcomeAt: string | null;
49
+ hasIntentLog: boolean;
50
+ hasOutcomeLog: boolean;
51
+ meaningfulActionTaken: boolean;
52
+ actionCountSinceLastThink: number;
53
+ externalActionCountSinceLastThink: number;
54
+ lastDecisionId: string | null;
55
+ pendingDecisionId: string | null;
56
+ pendingAction: string | null;
57
+ inFlightAction: string | null;
58
+ lastActionAt: string | null;
59
+ lastActionClass: MarrowActionClass | null;
60
+ lastChokePoint: MarrowChokePoint | null;
61
+ recommendedNext: MarrowLoopRecommendation;
62
+ loopState: 'idle' | 'oriented' | 'intent_logged' | 'acting' | 'outcome_logged';
63
+ message: string | null;
64
+ hints: string[];
65
+ }
66
+ export interface MarrowCheckResult {
67
+ ok: boolean;
68
+ mode: MarrowEnforcementMode;
69
+ state: MarrowLoopState;
70
+ warnings: string[];
71
+ recommendedNext: MarrowLoopRecommendation;
72
+ shouldBlock: boolean;
73
+ shouldBlockCompletion: boolean;
74
+ shouldBlockExternalAction: boolean;
75
+ blockReasonCodes: MarrowBlockReasonCode[];
76
+ }
77
+ export interface MarrowEnforceOptions {
78
+ mode?: MarrowEnforcementMode;
79
+ remindEveryActions?: number;
80
+ externalActions?: string[];
81
+ classifyExternal?: (meta: MarrowActionMeta) => boolean;
82
+ }
83
+ export interface MarrowActionMeta {
84
+ action: string;
85
+ type?: MarrowDecisionType;
86
+ external?: boolean;
87
+ meaningful?: boolean;
88
+ actionClass?: MarrowActionClass;
89
+ chokePoint?: MarrowChokePoint;
90
+ name?: string;
91
+ context?: Record<string, unknown>;
92
+ result?: string;
93
+ success?: boolean;
94
+ causedBy?: string;
95
+ skipAutoOutcome?: boolean;
96
+ }
97
+ export interface MarrowOrientResult {
98
+ warnings: Array<{
99
+ type: string;
100
+ failureRate: number;
101
+ message: string;
102
+ }>;
103
+ lessons: Array<{
104
+ summary: string;
105
+ severity: string;
106
+ }>;
107
+ shouldPause: boolean;
108
+ loop: MarrowCheckResult;
109
+ recommendedNext: MarrowLoopRecommendation;
110
+ nudge: string | null;
111
+ text: string;
112
+ }
113
+ export interface MarrowThinkResult {
114
+ decisionId: string;
115
+ intelligence: {
116
+ similar: Array<{
117
+ outcome: string;
118
+ confidence: number;
119
+ }>;
120
+ similarCount: number;
121
+ patterns: Array<{
122
+ patternId: string;
123
+ decisionType: string;
124
+ frequency: number;
125
+ confidence: number;
126
+ }>;
127
+ patternsCount: number;
128
+ templates: Array<{
129
+ steps: unknown[];
130
+ success_rate: number;
131
+ }>;
132
+ shared: Array<{
133
+ outcome: string;
134
+ }>;
135
+ causalChain: unknown | null;
136
+ successRate: number;
137
+ priorityScore: number;
138
+ insight: string | null;
139
+ insights: ActionableInsight[];
140
+ clusterId: string | null;
141
+ };
142
+ streamUrl: string;
143
+ previousCommitted?: boolean;
144
+ sanitized: boolean;
145
+ upgradeHint?: {
146
+ message: string;
147
+ tier: string;
148
+ url: string;
149
+ };
150
+ acceptedAs: 'intent';
151
+ warnings: string[];
152
+ recommendedNext: MarrowLoopRecommendation;
153
+ loop: MarrowCheckResult;
154
+ summary: string;
155
+ }
156
+ export interface MarrowCommitResult {
157
+ committed: boolean;
158
+ successRate: number;
159
+ insight: string | null;
160
+ acceptedAs: 'outcome';
161
+ recommendedNext: MarrowLoopRecommendation;
162
+ loop: MarrowCheckResult;
163
+ summary: string;
164
+ }
165
+ export interface MarrowAskResult {
166
+ answer: string;
167
+ stats: {
168
+ total: number;
169
+ success: number;
170
+ failure: number;
171
+ failure_rate: number;
172
+ } | null;
173
+ top_outcomes: string[];
174
+ decisions_matched: number;
175
+ query_keywords?: string[];
176
+ low_history?: boolean;
177
+ }
178
+ export interface MarrowQuickStatusResult {
179
+ ok: boolean;
180
+ health: 'healthy' | 'degraded';
181
+ message: string;
182
+ hasMemory: boolean;
183
+ lowHistory: boolean;
184
+ decisionCount: number;
185
+ successRate: number | null;
186
+ }
187
+ export interface MarrowClientOptions {
188
+ baseUrl?: string;
189
+ sessionId?: string;
190
+ mode?: MarrowEnforcementMode;
191
+ }
192
+ export interface MemoryShareOptions {
193
+ agentIds: string[];
194
+ actor?: string;
195
+ }
196
+ export interface MemoryExportOptions {
197
+ format?: 'json' | 'csv';
198
+ status?: MemoryStatus | 'all';
199
+ tags?: string[];
200
+ }
201
+ export interface MemoryImportOptions {
202
+ memories: Array<{
203
+ text: string;
204
+ source?: string;
205
+ tags?: string[];
206
+ sharedWith?: string[];
207
+ }>;
208
+ mode: 'merge' | 'replace';
209
+ }
210
+ export interface MemoryRetrieveOptions {
211
+ from?: string;
212
+ to?: string;
213
+ tags?: string;
214
+ source?: string;
215
+ status?: MemoryStatus;
216
+ shared?: boolean;
217
+ }
218
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js ADDED
@@ -0,0 +1,6 @@
1
+ "use strict";
2
+ /**
3
+ * @getmarrow/sdk — Type Definitions
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getmarrow/sdk",
3
- "version": "2.7.0",
3
+ "version": "2.9.0",
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",
@@ -20,5 +20,9 @@
20
20
  "files": [
21
21
  "dist",
22
22
  "README.md"
23
- ]
23
+ ],
24
+ "devDependencies": {
25
+ "@types/node": "^25.5.2",
26
+ "typescript": "^5.3.3"
27
+ }
24
28
  }