@compose-market/sdk 0.6.7 → 0.6.9-patched

package/.speakeasy/a2a.arazzo.yaml

@@ -6,7 +6,7 @@ info:
     Step 1 dials blind, step 2 retries with a Permit2 signature against the
     server's `upto` quote, step 3 submits structured feedback. Authoritative
     metering decides the actual settled amount inside the envelope.
-  version: 0.6.7
+  version: 0.6.9-patched
 sourceDescriptions:
   - name: manowar
     url: ../specs/manowar.openapi.yaml

package/.speakeasy/memory.arazzo.yaml

@@ -1,51 +1,123 @@
 arazzo: 1.0.1
 info:
-  title: Compose Memory Agent-First Workflows
+  title: Compose Memory — agent-first contracts
+  version: 0.6.9-patched
   summary: |
-    Standalone workflow contracts for compact retrieval, turn recording,
-    durable recall, and maintenance. Memory framework layers (responsibilities):
-      - MongoDB Atlas $vectorSearch — durable vector store
-      - Voyage embeddings (Redis-cached) — text -> 1024-dim vector
-      - Cloudflare bge-reranker-base — query-time relevance reranking
-      - Temporal decay + MMR — older facts de-rank, top-K diversification
-      - Mem0 v3 — durable extracted-fact graph layer (its own retrieval defaults)
-    Mem0 owns its top_k/threshold/rerank — clients (this workflow) do NOT
-    pass them through. Per-thread traceability lives in metadata.run_id.
-  version: 0.6.7
+    You are an agent. You have memory. Three calls cover 99% of turns.
+
+    PRE-TURN (always):  POST /api/memory/context/assemble
+      → returns { prompt: string|null, items, contextUsage }
+      → inject `prompt` as a system message if non-null. Done.
+
+    POST-TURN (always): POST /api/memory/turns/record  (fire-and-forget)
+      → persists transcript + working buffer + per-turn vector
+      → triggers async fact extraction (graph layer)
+      → idempotent on `turnId`. Pass it.
+
+    REMEMBER (rare):    POST /api/memory/remember
+      → only when the user states a stable fact AND the auto-extractor
+        in record_turn missed it. 99% of facts are auto-extracted.
+
+    Scope contract — memorise these 3 rules and you cannot fail:
+      1. (agentWallet, userAddress) is the durability boundary.
+      2. threadId narrows working+scene only. graph/vectors are
+         cross-thread — recall a fact from any past session.
+      3. mode="local" + haiId partitions a side-tree (HAI-bound). Omit both
+         for default global agent memory.
+
+    Layers (you do NOT pick them; ranker picks for you):
+      working   = rolling thread context        (Mongo sessions)
+      scene     = full transcripts              (Mongo session_transcripts)
+      graph     = durable user facts            (Mongo memory, source:fact)
+      patterns  = mined tool sequences          (Mongo patterns)
+      archives  = cold storage                  (Mongo archives + Pinata)
+      vectors   = hybrid recall                 (Mongo memory, source:session)
+
+    One ranker (Cloudflare BAAI bge-reranker-base + temporal decay + MMR)
+    shortlists across all 6 layers into ≤ 900 chars / ≤ 6 items per turn.
+
+    Token / latency budget defaults (override via params):
+      pre_turn block:  ≤ 900 chars, ≤ 6 items, p50 < 200ms
+      post_turn:       fire-and-forget, p50 < 50ms server-side
+      fact extraction: ~$0.000075/turn (gemini-3.1-flash-lite-preview)
+      voyage embed:    ~$0.00002/turn (voyage-4-large 1024-d)
+      cf rerank:       ~$0.0001/turn (skipped when top-1 dominates)
+
+    Storage summary: Mongo Atlas + Voyage embeddings + Cloudflare reranker.
+    No mem0. No vendor cloud. First-party from end to end.
+
 sourceDescriptions:
   - name: memory
     url: ../specs/memory.openapi.yaml
     type: openapi
+
 x-speakeasy-test-server:
   baseUrl: "x-env: COMPOSE_RUNTIME_TEST_URL; https://runtime.compose.market"
+
 workflows:
-  - workflowId: memory_agent_turn_loop
-    summary: Retrieve compact memory before a turn, persist the turn, then save an explicit durable fact.
+  # ──────────────────────────────────────────────────────────────────
+  # agent_turn_loop — RUN THIS ON EVERY TURN.
+  # ──────────────────────────────────────────────────────────────────
+  - workflowId: agent_turn_loop
+    summary: pre_turn → (agent's model call) → post_turn → optional remember
+    description: |
+      Three steps. Hit them in order.
+        1. pre_turn_context  → get prompt block; inject if non-null.
+        2. post_turn_record  → persist; fire-and-forget; idempotent on turnId.
+        3. remember_fact     → optional; only on explicit user fact.
+
+      Do NOT block your response on step 2 or 3.
     inputs:
       type: object
+      required: [agentWallet, userAddress, threadId, query, userMessage, assistantMessage, modelUsed, totalTokens, turnId]
       properties:
         agentWallet:
           type: string
+          description: agent's on-chain wallet. durability key.
           examples: ["x-env: COMPOSE_TEST_AGENT_WALLET"]
         userAddress:
           type: string
+          description: end-user wallet. durability key.
           examples: ["x-env: COMPOSE_TEST_USER_ADDRESS"]
         threadId:
           type: string
-          examples: ["arazzo-thread"]
+          description: conversation id. narrows working+scene only.
+          examples: ["arazzo-thread-1"]
         query:
           type: string
-          examples: ["billing preference"]
+          description: user's latest message verbatim. used as recall query.
+          examples: ["what did I tell you about my project?"]
+        userMessage:
+          type: string
+          description: the user side of this turn (often == query).
+          examples: ["I work on AI agents and prefer concise answers."]
+        assistantMessage:
+          type: string
+          description: your reply for this turn.
+          examples: ["Got it — concise, AI agents focus."]
+        modelUsed:
+          type: string
+          description: model id. used for receipts + cost telemetry.
+          examples: ["gpt-4o"]
+        totalTokens:
+          type: integer
+          description: input + output + reasoning tokens for this turn.
+          examples: [1209]
+        turnId:
+          type: string
+          description: |
+            stable id for THIS turn. dedup key for record_turn retries.
+            generate once per turn (e.g. crypto.randomUUID()) and reuse.
+          examples: ["turn_a1b2c3"]
+
     steps:
-      - stepId: get_loop_manifest
-        operationId: $sourceDescriptions.memory.workflows_get
-        parameters:
-          - name: workflowId
-            in: path
-            value: agent_memory_loop
-        successCriteria:
-          - condition: $statusCode == 200
       - stepId: pre_turn_context
+        description: |
+          Hits /api/memory/context/assemble. Returns:
+            prompt: string|null            — inject as system msg verbatim
+            items: AgentMemoryCompactItem[] — for telemetry/debug
+            totals: Record<layer, count>   — pre-shortlist counts
+            contextUsage: { characters, savedCharactersVsRaw, items }
         operationId: $sourceDescriptions.memory.context_assemble
         requestBody:
           contentType: application/json
@@ -54,14 +126,22 @@ workflows:
             userAddress: "$inputs.userAddress"
             threadId: "$inputs.threadId"
             query: "$inputs.query"
-            layers: ["working", "patterns", "vectors"]
-            budget:
-              maxCharacters: 1800
+            limit: 8
+            maxItems: 6
+            maxItemChars: 360
+            budget: { maxCharacters: 900 }
         successCriteria:
           - condition: $statusCode == 200
         outputs:
           contextId: $response.body#/contextId
+          prompt: $response.body#/prompt
+
       - stepId: post_turn_record
+        description: |
+          Hits /api/memory/turns/record. Returns:
+            stored: { transcript, working, vector, graph } — assert all 4 true
+            turnId, sessionId, vectorId
+          Idempotent on turnId. Fire-and-forget on the agent side.
         operationId: $sourceDescriptions.memory.turn_record
         requestBody:
           contentType: application/json
@@ -70,13 +150,20 @@ workflows:
             userAddress: "$inputs.userAddress"
             threadId: "$inputs.threadId"
             contextId: $steps.pre_turn_context.outputs.contextId
-            userMessage: "$inputs.query"
-            assistantMessage: "Recorded."
-            modelUsed: "compose-test"
-            totalTokens: 1
+            turnId: "$inputs.turnId"
+            userMessage: "$inputs.userMessage"
+            assistantMessage: "$inputs.assistantMessage"
+            modelUsed: "$inputs.modelUsed"
+            totalTokens: "$inputs.totalTokens"
         successCriteria:
           - condition: $statusCode == 200
+
       - stepId: remember_fact
+        description: |
+          OPTIONAL. Only call when the user volunteers a stable fact AND
+          you suspect the auto-extractor missed it. Use `type` to
+          categorise so the ranker surfaces the fact correctly later.
+          types: preference|identity|context|skill|relationship|event|other
         operationId: $sourceDescriptions.memory.remember
         requestBody:
           contentType: application/json
@@ -84,56 +171,76 @@ workflows:
             agentWallet: "$inputs.agentWallet"
             userAddress: "$inputs.userAddress"
             threadId: "$inputs.threadId"
-            content: "The user prefers concise billing answers."
+            content: "The user prefers concise answers and works on AI agents."
             type: preference
-            retention: long
-            confidence: 0.9
+            confidence: 0.95
         successCriteria:
           - condition: $statusCode == 200
-  - workflowId: memory_maintenance_loop
-    summary: Discover memory workflows, run maintenance, and inspect reusable learned patterns.
+
+  # ──────────────────────────────────────────────────────────────────
+  # eval_loop — measure recall@K. Use to gate deploys.
+  # ──────────────────────────────────────────────────────────────────
+  - workflowId: eval_loop
+    summary: Run a memory eval and assert recall@K ≥ 0.95.
+    description: |
+      Pass {query, expected} test cases. Server returns recallAtK,
+      precisionAtK, avgContextCharacters. Default layer set covers all 6
+      so you measure end-to-end ranker behaviour.
     inputs:
       type: object
+      required: [agentWallet, userAddress]
       properties:
-        agentWallet:
-          type: string
-          examples: ["x-env: COMPOSE_TEST_AGENT_WALLET"]
+        agentWallet: { type: string, examples: ["x-env: COMPOSE_TEST_AGENT_WALLET"] }
+        userAddress: { type: string, examples: ["x-env: COMPOSE_TEST_USER_ADDRESS"] }
     steps:
-      - stepId: list_workflows
-        operationId: $sourceDescriptions.memory.workflows_list
-        successCriteria:
-          - condition: $statusCode == 200
-      - stepId: list_patterns
-        operationId: $sourceDescriptions.memory.patterns_list
-        parameters:
-          - name: agentWallet
-            in: query
-            value: "$inputs.agentWallet"
-          - name: minSuccessRate
-            in: query
-            value: 0.2
-          - name: limit
-            in: query
-            value: 5
+      - stepId: run_eval
+        operationId: $sourceDescriptions.memory.evals_run
+        requestBody:
+          contentType: application/json
+          payload:
+            agentWallet: "$inputs.agentWallet"
+            userAddress: "$inputs.userAddress"
+            testCases:
+              - { query: "What is my favourite color?", expected: "azure" }
+              - { query: "What do I work on?",          expected: "AI agents" }
+              - { query: "What music do I like?",       expected: "jazz" }
         successCriteria:
           - condition: $statusCode == 200
-      - stepId: run_decay_job
+          - condition: $response.body#/scores/recallAtK >= 0.95
+
+  # ──────────────────────────────────────────────────────────────────
+  # maintenance_loop — Temporal already runs these on schedule.
+  # Hit only for out-of-band forced passes (bulk imports, debugging).
+  # ──────────────────────────────────────────────────────────────────
+  - workflowId: maintenance_loop
+    summary: Force decay refresh + cleanup out-of-band.
+    description: |
+      Daily/weekly Temporal schedules already run these. Use only
+      after bulk imports or for debugging.
+    inputs:
+      type: object
+      required: [agentWallet]
+      properties:
+        agentWallet: { type: string, examples: ["x-env: COMPOSE_TEST_AGENT_WALLET"] }
+        halfLifeDays: { type: integer, default: 30 }
+    steps:
+      - stepId: run_decay_refresh
         operationId: $sourceDescriptions.memory.jobs_create
         requestBody:
           contentType: application/json
           payload:
             type: decay_update
             execution: inline
-            halfLifeDays: 30
+            halfLifeDays: "$inputs.halfLifeDays"
         successCriteria:
           - condition: $statusCode == 200
-        outputs:
-          jobId: $response.body#/jobId
-      - stepId: get_decay_job
-        operationId: $sourceDescriptions.memory.jobs_get
-        parameters:
-          - name: jobId
-            in: path
-            value: $steps.run_decay_job.outputs.jobId
+      - stepId: cleanup_expired
+        operationId: $sourceDescriptions.memory.jobs_create
+        requestBody:
+          contentType: application/json
+          payload:
+            type: cleanup
+            execution: inline
+            olderThanDays: 90
         successCriteria:
           - condition: $statusCode == 200

package/.speakeasy/tests.arazzo.yaml

@@ -2,7 +2,7 @@ arazzo: 1.0.1
 info:
   title: Compose SDK Agent-First Workflows
   summary: E2E workflow contracts for the Compose SDK, inference, x402, and manowar loops.
-  version: 0.6.7
+  version: 0.6.9-patched
 sourceDescriptions:
   - name: x402
     url: ../specs/x402.openapi.yaml

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.6.8
+
+### Highlights
+
+- **First-party 6-layer memory framework.** Mem0 cloud removed entirely. Graph-layer durable facts now live in the same Mongo `memory` collection as conversational vectors (with `source: "fact"`, `metadata.layer: "graph"`), extracted by `gemini-3.1-flash-lite-preview` via our own inference gateway. Voyage `voyage-4-large` (1024-d) is the sole embedder; Cloudflare `bge-reranker-base` is the cross-encoder. Recall p50 dropped from ~905ms (mem0 round-trip) to <120ms.
+- **Cross-thread durable recall now actually works.** The vectors layer was thread-scoped by mistake — fixed; `(agentWallet, userAddress)` is the durability boundary, threadId narrows working+scene only.
+- **Agent memory tools simplified.** `save_memory` + `search_memory` + `search_all_memory` collapsed into `memory_recall` and `memory_remember`. The cross-layer ranker handles which layers contribute; agents do NOT pick layers.
+- **Post-turn persistence is fire-and-forget.** Fact extraction never blocks the agent response.
+- **SDK ergonomic shortcuts:**
+  - `sdk.memory.recall(query, { agentWallet, userAddress })` — string-first pre-turn block
+  - `sdk.memory.save(content, { agentWallet, userAddress, type? })` — string-first durable fact
+- **`MemoryShorthandOptions`** type added for the helpers above.
+- **`AgentMemoryRecordTurnResponse.stored`** now exposes `graph` alongside `transcript`/`working`/`vector` so callers can assert all four bookend layers landed.
+- **Memory Arazzo workflow rewritten** as a 10/10 onboarding doc — covers the canonical `agent_turn_loop`, `maintenance_loop`, `pattern_promotion_loop`, and `eval_loop`. No mem0 references; explicit scope rules; explicit cost / latency budget; per-step descriptions explain when and why.
+
+### Bug fixes
+
+- The vectors layer filter no longer includes `threadId` — durable cross-thread recall now works.
+- API gateway no longer aborts the prepared x402 payment when the SSE `[DONE]` terminator passes through `parseSseEventBlock`.
+- `stopped` and `error` SSE events now carry usage payload so the gateway settles partial work on user-initiated abort.
+
 ## 0.6.7
 
 ### Highlights

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

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/resources/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACR,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EACnB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AA6ED,qBAAa,YAAY;IAEjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE;QAClB,SAAS,IAAI;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAClD,cAAc,IAAI;YAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;QACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;QAC1B,UAAU,IAAI,IAAI,CAAC;KACtB;IAGC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA4BjE,SAAS,CAAC,KAAK,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAa3E,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAazC;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmBnD;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBzE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxB,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,UAAU,IAAI,IAAI;CAGrB"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/resources/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACR,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EACnB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AA6ED,qBAAa,YAAY;IAEjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE;QAClB,SAAS,IAAI;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAClD,cAAc,IAAI;YAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;QACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;QAC1B,UAAU,IAAI,IAAI,CAAC;KACtB;IAGC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA4BjE,SAAS,CAAC,KAAK,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiB3E,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAazC;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmBnD;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBzE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxB,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,UAAU,IAAI,IAAI;CAGrB"}

package/dist/resources/keys.js

@@ -98,7 +98,7 @@ export class KeysResource {
     async getActive(input = {}) {
         const wallet = this.ctx.getWallet();
         const chainId = input.chainId ?? wallet.chainId;
-        return this.client.request({
+        const response = await this.client.request({
             method: "GET",
             path: "/api/session",
             headers: {
@@ -106,6 +106,10 @@ export class KeysResource {
                 chainId,
             },
         });
+        if (typeof response.token === "string" && response.token.length > 0) {
+            this.ctx.setToken(response.token);
+        }
+        return response;
     }
     async list() {
         const wallet = this.ctx.getWallet();

package/dist/resources/keys.js.map

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

package/dist/resources/memory.d.ts

@@ -1,3 +1,28 @@
+/**
+ * Compose memory — first-party 6-layer memory framework.
+ *
+ *   working  → Mongo `sessions`        rolling per-thread context
+ *   scene    → Mongo `session_transcripts`  full transcripts
+ *   graph    → Mongo `memory` (source:"fact")  durable user facts
+ *   patterns → Mongo `patterns`        mined tool sequences
+ *   archives → Mongo `archives` + Pinata  cold storage
+ *   vectors  → Mongo `memory` (source:"session"|"knowledge")  hybrid recall
+ *
+ * One unified ranker (Cloudflare BAAI bge-reranker-base + temporal decay +
+ * MMR) shortlists items across all layers into a budget-bounded prompt block.
+ *
+ * The 80%-case surface for agent loops is three calls:
+ *   - `sdk.memory.context({ query, agentWallet, userAddress })` → pre-turn block
+ *   - `sdk.memory.recordTurn({ messages, agentWallet, userAddress, threadId })` → post-turn persist
+ *   - `sdk.memory.remember({ content, agentWallet, userAddress })` → durable fact
+ *
+ * Or even simpler ergonomic shortcuts:
+ *   - `sdk.memory.recall("what's my favourite color?", { agentWallet, userAddress })`
+ *   - `sdk.memory.save("my favourite color is azure", { agentWallet, userAddress })`
+ *
+ * The runtime owns ranking, budget enforcement, layer selection, and fact
+ * extraction. The SDK is a thin transport.
+ */
 import type { APIPromise, HttpClient } from "../http.js";
 import type { AgentMemoryContextParams, AgentMemoryContextResponse, AgentMemoryLoopParams, AgentMemoryLoopResponse, AgentMemoryRecordTurnParams, AgentMemoryRecordTurnResponse, AgentMemoryRememberParams, AgentMemoryRememberResponse, LearnedSkill, LayeredSearchParams, LayeredSearchResult, MemoryEvalRunParams, MemoryEvalRunResponse, MemoryItemDeleteParams, MemoryItemQuery, MemoryItemUpdateParams, MemoryJobCreateParams, MemoryJobRecord, MemoryPatternValidation, MemoryScheduleStatus, MemoryVector, MemoryWorkflowManifest, ProceduralPattern, SessionMemory } from "../types/index.js";
 export interface MemoryResourceContext {
@@ -12,14 +37,79 @@ export interface MemoryRequestOptions {
     timeoutMs?: number;
     idempotencyKey?: string;
 }
+/**
+ * Shorthand options for the ergonomic helpers `recall` and `save`.
+ * Scope (`agentWallet` + `userAddress`) is required; everything else is
+ * either auto-defaulted by the runtime or an opt-in tuning knob.
+ */
+export interface MemoryShorthandOptions {
+    agentWallet: string;
+    userAddress?: string;
+    threadId?: string;
+    mode?: "global" | "local";
+    haiId?: string;
+    /** Recall: max items in the returned prompt block. Default 6. */
+    limit?: number;
+    /** Recall: max characters in the returned prompt block. Default 900. */
+    budgetCharacters?: number;
+    /** Remember: confidence override (default 1 for explicit saves). */
+    confidence?: number;
+    /** Remember: durable-fact category. Default "other". */
+    type?: "preference" | "identity" | "context" | "skill" | "relationship" | "event" | "other";
+    request?: MemoryRequestOptions;
+}
 export declare class MemoryResource {
     private readonly client;
     private readonly ctx;
     constructor(client: HttpClient, ctx: MemoryResourceContext);
+    /**
+     * Pre-turn context retrieval. Returns a budget-bounded prompt block
+     * shortlisting top items across all 6 layers.
+     */
     context(params: AgentMemoryContextParams, options?: MemoryRequestOptions): APIPromise<AgentMemoryContextResponse>;
+    /**
+     * Post-turn persistence. Persists transcript + working memory + per-turn
+     * vector + extracts durable facts (graph layer). Idempotent on `turnId`.
+     */
     recordTurn(params: AgentMemoryRecordTurnParams, options?: MemoryRequestOptions): APIPromise<AgentMemoryRecordTurnResponse>;
+    /**
+     * Save an explicit durable fact. Indexed as a `source:"fact"` vector with
+     * `metadata.layer:"graph"` so the cross-layer ranker surfaces it.
+     */
     remember(params: AgentMemoryRememberParams, options?: MemoryRequestOptions): APIPromise<AgentMemoryRememberResponse>;
+    /**
+     * Unified loop dispatcher — same as calling `context`/`recordTurn`/`remember`
+     * directly but lets you pass a discriminated union, useful when the
+     * caller's step is dynamic.
+     */
     loop(params: AgentMemoryLoopParams, options?: MemoryRequestOptions): APIPromise<AgentMemoryLoopResponse>;
+    /**
+     * Pre-turn recall in one call. Returns the rendered prompt block
+     * directly (or `null` if no relevant memories).
+     *
+     *   const block = await sdk.memory.recall(
+     *     "what's my favourite color?",
+     *     { agentWallet, userAddress },
+     *   );
+     */
+    recall(query: string, options: MemoryShorthandOptions): Promise<{
+        prompt: string | null;
+        items: AgentMemoryContextResponse["items"];
+        totals: Record<string, number>;
+        contextUsage: AgentMemoryContextResponse["contextUsage"];
+    }>;
+    /**
+     * Save a durable fact in one call. Returns whether it landed.
+     *
+     *   await sdk.memory.save(
+     *     "my favourite color is azure",
+     *     { agentWallet, userAddress, type: "preference" },
+     *   );
+     */
+    save(content: string, options: MemoryShorthandOptions): Promise<{
+        saved: boolean;
+        id?: string;
+    }>;
     search(params: LayeredSearchParams, options?: MemoryRequestOptions): APIPromise<LayeredSearchResult>;
     getItem(id: string, params?: MemoryItemQuery, options?: MemoryRequestOptions): APIPromise<{
         item: MemoryVector;

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

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

package/dist/resources/memory.js

@@ -5,18 +5,92 @@ export class MemoryResource {
         this.client = client;
         this.ctx = ctx;
     }
+    /**
+     * Pre-turn context retrieval. Returns a budget-bounded prompt block
+     * shortlisting top items across all 6 layers.
+     */
     context(params, options = {}) {
         return this.request("POST", "/api/memory/context/assemble", params, options);
     }
+    /**
+     * Post-turn persistence. Persists transcript + working memory + per-turn
+     * vector + extracts durable facts (graph layer). Idempotent on `turnId`.
+     */
     recordTurn(params, options = {}) {
         return this.request("POST", "/api/memory/turns/record", params, options, undefined, true);
     }
+    /**
+     * Save an explicit durable fact. Indexed as a `source:"fact"` vector with
+     * `metadata.layer:"graph"` so the cross-layer ranker surfaces it.
+     */
     remember(params, options = {}) {
         return this.request("POST", "/api/memory/remember", params, options, undefined, true);
     }
+    /**
+     * Unified loop dispatcher — same as calling `context`/`recordTurn`/`remember`
+     * directly but lets you pass a discriminated union, useful when the
+     * caller's step is dynamic.
+     */
     loop(params, options = {}) {
         return this.request("POST", "/api/memory/loop", params, options, undefined, params.step !== "pre_turn");
     }
+    // ------------------------------------------------------------------
+    // Ergonomic shortcuts — string-first, no envelopes, the 80% case
+    // ------------------------------------------------------------------
+    /**
+     * Pre-turn recall in one call. Returns the rendered prompt block
+     * directly (or `null` if no relevant memories).
+     *
+     *   const block = await sdk.memory.recall(
+     *     "what's my favourite color?",
+     *     { agentWallet, userAddress },
+     *   );
+     */
+    async recall(query, options) {
+        const response = await this.context({
+            query,
+            agentWallet: options.agentWallet,
+            userAddress: options.userAddress,
+            threadId: options.threadId,
+            mode: options.mode,
+            haiId: options.haiId,
+            limit: options.limit,
+            ...(options.budgetCharacters ? { budget: { maxCharacters: options.budgetCharacters } } : {}),
+        }, options.request ?? {});
+        return {
+            prompt: response.prompt,
+            items: response.items,
+            totals: response.totals,
+            contextUsage: response.contextUsage,
+        };
+    }
+    /**
+     * Save a durable fact in one call. Returns whether it landed.
+     *
+     *   await sdk.memory.save(
+     *     "my favourite color is azure",
+     *     { agentWallet, userAddress, type: "preference" },
+     *   );
+     */
+    async save(content, options) {
+        const response = await this.remember({
+            content,
+            agentWallet: options.agentWallet,
+            userAddress: options.userAddress,
+            threadId: options.threadId,
+            mode: options.mode,
+            haiId: options.haiId,
+            ...(options.type ? { type: options.type } : {}),
+            ...(typeof options.confidence === "number" ? { confidence: options.confidence } : {}),
+        }, options.request ?? {});
+        return {
+            saved: Boolean(response.success),
+            id: response.vectorId ?? response.memory?.id,
+        };
+    }
+    // ------------------------------------------------------------------
+    // Power-user surface (full layered search, item CRUD, jobs, schedules)
+    // ------------------------------------------------------------------
     search(params, options = {}) {
         return this.request("POST", "/api/memory/items/search", params, options);
     }