@recursiv/sdk 0.6.0 → 0.6.2

package/dist/resources/goals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals.d.ts","sourceRoot":"","sources":["../../src/resources/goals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACvC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CACzC;AAID,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,4CAA4C;IAC5C,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;IAI/D,4CAA4C;IAC5C,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAIzF,oBAAoB;IACpB,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAI7D,gFAAgF;IAChF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAI7E,oEAAoE;IACpE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;CAM9F"}

package/dist/resources/goals.js

@@ -0,0 +1,31 @@
+// ── Resource ──
+export class GoalsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** List goals with per-goal task rollups */
+    list(params) {
+        return this.client.get('/goals', params);
+    }
+    /** Get a single goal (with rollup) by ID */
+    get(goalId, params) {
+        return this.client.get(`/goals/${encodeURIComponent(goalId)}`, params);
+    }
+    /** Create a goal */
+    create(input) {
+        return this.client.post('/goals', input);
+    }
+    /** Update a goal (name, description, status, target date, owner, sort order) */
+    update(goalId, input) {
+        return this.client.patch(`/goals/${encodeURIComponent(goalId)}`, input);
+    }
+    /** Archive (soft-delete) a goal — its tasks become miscellaneous */
+    archive(goalId, params) {
+        const query = params?.organization_id
+            ? `?organization_id=${encodeURIComponent(params.organization_id)}`
+            : '';
+        return this.client.delete(`/goals/${encodeURIComponent(goalId)}${query}`);
+    }
+}
+//# sourceMappingURL=goals.js.map

package/dist/resources/goals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals.js","sourceRoot":"","sources":["../../src/resources/goals.ts"],"names":[],"mappings":"AAuDA,iBAAiB;AAEjB,MAAM,OAAO,aAAa;IACJ;IAApB,YAAoB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAE1C,4CAA4C;IAC5C,IAAI,CAAC,MAAwB;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAiC,CAAC,CAAC;IACtE,CAAC;IAED,4CAA4C;IAC5C,GAAG,CAAC,MAAc,EAAE,MAAqC;QACvD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAiC,CAAC,CAAC;IACpG,CAAC;IAED,oBAAoB;IACpB,MAAM,CAAC,KAAsB;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,gFAAgF;IAChF,MAAM,CAAC,MAAc,EAAE,KAAsB;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1E,CAAC;IAED,oEAAoE;IACpE,OAAO,CAAC,MAAc,EAAE,MAAqC;QAC3D,MAAM,KAAK,GAAG,MAAM,EAAE,eAAe;YACnC,CAAC,CAAC,oBAAoB,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE;YAClE,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/llm.md

@@ -183,6 +183,32 @@ Methods: `tasks`, `stats`, `decisions`, `milestones`, `agents`, `teamActivity`,
 
 ---
 
+## Evidence — Measure agents (evals, accuracy, cost)
+
+### r.evidence — Author evals, run simulations, read graded results
+
+```typescript
+// Run a batch of cases through an agent or swarm and grade them (the whole loop)
+const { data } = await r.evidence.simulate({
+  target: { type: 'swarm', id: swarmId },
+  cases: [{ input: 'New account, $9.6k order', expected: { answer: 'ESCALATE' } }],
+  evals: [{ name: 'On-policy', type: 'judge', definition: { rubric: 'Follows the risk policy?' }, judge_model: 'anthropic/claude-sonnet-4.6' }],
+})
+console.log(data.run_id, data.run?.accuracy) // per-step results in data.results
+
+// Read the audit trail — what an agent/swarm actually did and what it cost
+const { data: sum } = await r.evidence.summary({ type: 'swarm', id: swarmId })
+const { data: events } = await r.evidence.records({ type: 'swarm', id: swarmId }, { limit: 50 })
+const first = events[0]
+const { data: step } = await r.evidence.recordDetail({ type: 'swarm', id: swarmId }, first.id, first.kind)
+// step: model_call → { systemPrompt, promptMessages, responseText, reasoningText, toolCalls }
+//       tool_call  → { toolName, args, result, success }
+```
+
+Methods: `createEval` (code | judge | match | consensus), `simulate`, `listRuns`, `getRun`, `summary`, `records`, `recordDetail`. Eval types: `code` (rule), `judge` (rubric, reference-free — use a different model family), `match` (vs known answer), `consensus` (cross-model agreement; premium). `records` is the continuous activity ledger (every model + tool call); `recordDetail` is the drill-down behind one event (exact prompt/reasoning, or exact tool inputs/outputs).
+
+---
+
 ## Memory — Persistent agent memory across sessions
 
 ### r.memory — Facts, decisions, and search
@@ -510,6 +536,14 @@ Methods: `list`, `get`, `create`, `delete`
 - `r.simulator` — Simulation/testing
 - `r.dispatcher` — Task queue: `tasks()`, `create()`, `claimNext()`, `complete()`, `release()`, `stats()`, `signals()`, `outcomes()`, `staleItems()`, `stuckItems()`, `discoveries()`
 - `r.dispatcher` (webhooks): `createWebhook()`, `listWebhooks()`, `updateWebhook()`, `deleteWebhook()`, `testWebhook()`, `webhookDeliveries()`, `cleanupWebhookLogs()`
+- `r.goals` — Org goals that dispatcher tasks roll up into: `list()`, `get()`, `create()`, `update()`, `archive()`. Tasks link via `goal_id` on `r.dispatcher.create()/update()`; `tasks({ goal_id })` filters (use `'none'` for goal-less tasks).
+
+```typescript
+// Create a goal and group tasks under it (personal keys: pass organization_id)
+const { data: goal } = await r.goals.create({ name: 'Ship the relaunch', organization_id: orgId })
+await r.dispatcher.update(taskId, { goal_id: goal.id, organization_id: orgId })
+const { data: goals } = await r.goals.list({ organization_id: orgId }) // includes task rollups
+```
 
 ```typescript
 // Create a webhook to receive dispatcher events

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recursiv/sdk",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "TypeScript SDK for the Recursiv API",
   "license": "FSL-1.1-ALv2",
   "type": "module",