@compose-market/sdk 0.8.8 → 0.8.10

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 (247) hide show
  1. package/CHANGELOG.md +344 -0
  2. package/dist/events.d.ts +6 -9
  3. package/dist/events.d.ts.map +1 -1
  4. package/dist/events.js.map +1 -1
  5. package/dist/http.d.ts +105 -0
  6. package/dist/http.d.ts.map +1 -0
  7. package/dist/http.js +399 -0
  8. package/dist/http.js.map +1 -0
  9. package/dist/index.d.ts +18 -23
  10. package/dist/index.d.ts.map +1 -1
  11. package/dist/index.js +41 -39
  12. package/dist/index.js.map +1 -1
  13. package/dist/resources/accounts.d.ts +1 -1
  14. package/dist/resources/accounts.d.ts.map +1 -1
  15. package/dist/resources/accounts.js +1 -1
  16. package/dist/resources/accounts.js.map +1 -1
  17. package/dist/resources/agent.d.ts +23 -10
  18. package/dist/resources/agent.d.ts.map +1 -1
  19. package/dist/resources/agent.js +543 -236
  20. package/dist/resources/agent.js.map +1 -1
  21. package/dist/resources/channels.d.ts +1 -1
  22. package/dist/resources/channels.d.ts.map +1 -1
  23. package/dist/resources/channels.js +3 -21
  24. package/dist/resources/channels.js.map +1 -1
  25. package/dist/resources/directory.d.ts +1 -1
  26. package/dist/resources/directory.d.ts.map +1 -1
  27. package/dist/resources/directory.js.map +1 -1
  28. package/dist/resources/dispenser.d.ts +1 -1
  29. package/dist/resources/dispenser.d.ts.map +1 -1
  30. package/dist/resources/dispenser.js.map +1 -1
  31. package/dist/resources/feedback.d.ts +1 -1
  32. package/dist/resources/feedback.d.ts.map +1 -1
  33. package/dist/resources/feedback.js +1 -1
  34. package/dist/resources/feedback.js.map +1 -1
  35. package/dist/resources/inference.d.ts +6 -6
  36. package/dist/resources/inference.d.ts.map +1 -1
  37. package/dist/resources/inference.js +235 -169
  38. package/dist/resources/inference.js.map +1 -1
  39. package/dist/resources/keys.d.ts +6 -6
  40. package/dist/resources/keys.d.ts.map +1 -1
  41. package/dist/resources/keys.js +4 -4
  42. package/dist/resources/keys.js.map +1 -1
  43. package/dist/resources/local.d.ts +56 -0
  44. package/dist/resources/local.d.ts.map +1 -0
  45. package/dist/resources/local.js +163 -0
  46. package/dist/resources/local.js.map +1 -0
  47. package/dist/resources/memory.d.ts +4 -26
  48. package/dist/resources/memory.d.ts.map +1 -1
  49. package/dist/resources/memory.js +12 -75
  50. package/dist/resources/memory.js.map +1 -1
  51. package/dist/resources/models.d.ts +1 -1
  52. package/dist/resources/models.d.ts.map +1 -1
  53. package/dist/resources/models.js.map +1 -1
  54. package/dist/resources/permissions.d.ts +1 -1
  55. package/dist/resources/permissions.d.ts.map +1 -1
  56. package/dist/resources/permissions.js +1 -1
  57. package/dist/resources/permissions.js.map +1 -1
  58. package/dist/resources/receipts.d.ts +3 -3
  59. package/dist/resources/receipts.d.ts.map +1 -1
  60. package/dist/resources/receipts.js +2 -2
  61. package/dist/resources/receipts.js.map +1 -1
  62. package/dist/resources/session-events.d.ts +1 -1
  63. package/dist/resources/session-events.d.ts.map +1 -1
  64. package/dist/resources/session-events.js +3 -3
  65. package/dist/resources/session-events.js.map +1 -1
  66. package/dist/resources/settlement.d.ts +1 -1
  67. package/dist/resources/settlement.d.ts.map +1 -1
  68. package/dist/resources/settlement.js +1 -1
  69. package/dist/resources/settlement.js.map +1 -1
  70. package/dist/resources/system.d.ts +1 -1
  71. package/dist/resources/system.d.ts.map +1 -1
  72. package/dist/resources/system.js.map +1 -1
  73. package/dist/resources/webhooks.d.ts.map +1 -1
  74. package/dist/resources/workflow.d.ts +18 -11
  75. package/dist/resources/workflow.d.ts.map +1 -1
  76. package/dist/resources/workflow.js +181 -88
  77. package/dist/resources/workflow.js.map +1 -1
  78. package/dist/resources/x402.d.ts +1 -1
  79. package/dist/resources/x402.d.ts.map +1 -1
  80. package/dist/resources/x402.js +1 -1
  81. package/dist/resources/x402.js.map +1 -1
  82. package/dist/storage.d.ts +27 -0
  83. package/dist/storage.d.ts.map +1 -0
  84. package/dist/storage.js +46 -0
  85. package/dist/storage.js.map +1 -0
  86. package/dist/types/index.d.ts +254 -176
  87. package/dist/types/index.d.ts.map +1 -1
  88. package/dist/types/index.js +0 -4
  89. package/dist/types/index.js.map +1 -1
  90. package/dist/version.d.ts +1 -1
  91. package/dist/version.d.ts.map +1 -1
  92. package/dist/version.js +1 -1
  93. package/dist/version.js.map +1 -1
  94. package/generated/channels/esm/lib/config.d.ts +3 -3
  95. package/generated/channels/esm/lib/config.js +3 -3
  96. package/generated/channels/esm/lib/config.js.map +1 -1
  97. package/generated/channels/esm/lib/encodings.d.ts +2 -2
  98. package/generated/channels/esm/sdk/sdk.js +1 -1
  99. package/generated/channels/esm/sdk/sdk.js.map +1 -1
  100. package/generated/channels/esm/types/async.js +1 -1
  101. package/generated/channels/esm/types/async.js.map +1 -1
  102. package/generated/channels/package.json +1 -1
  103. package/generated/channels/src/lib/config.ts +3 -3
  104. package/generated/inference/esm/lib/config.d.ts +3 -3
  105. package/generated/inference/esm/lib/config.js +3 -3
  106. package/generated/inference/esm/lib/config.js.map +1 -1
  107. package/generated/inference/esm/lib/encodings.d.ts +2 -2
  108. package/generated/inference/esm/models/receipt-body.d.ts +2 -2
  109. package/generated/inference/esm/models/receipt-body.d.ts.map +1 -1
  110. package/generated/inference/esm/models/receipt-body.js +2 -2
  111. package/generated/inference/esm/models/receipt-body.js.map +1 -1
  112. package/generated/inference/esm/models/receipt-line-item.d.ts +3 -3
  113. package/generated/inference/esm/models/receipt-line-item.d.ts.map +1 -1
  114. package/generated/inference/esm/models/receipt-line-item.js +2 -2
  115. package/generated/inference/esm/models/receipt-line-item.js.map +1 -1
  116. package/generated/inference/esm/models/responses-create-request.d.ts +0 -2
  117. package/generated/inference/esm/models/responses-create-request.d.ts.map +1 -1
  118. package/generated/inference/esm/models/responses-create-request.js +0 -1
  119. package/generated/inference/esm/models/responses-create-request.js.map +1 -1
  120. package/generated/inference/esm/sdk/sdk.js +4 -4
  121. package/generated/inference/esm/sdk/sdk.js.map +1 -1
  122. package/generated/inference/esm/types/async.js +1 -1
  123. package/generated/inference/esm/types/async.js.map +1 -1
  124. package/generated/inference/package.json +1 -1
  125. package/generated/inference/src/lib/config.ts +3 -3
  126. package/generated/inference/src/models/receipt-body.ts +4 -4
  127. package/generated/inference/src/models/receipt-line-item.ts +6 -6
  128. package/generated/inference/src/models/responses-create-request.ts +0 -3
  129. package/generated/manowar/esm/funcs/agents-responses-create.js +2 -2
  130. package/generated/manowar/esm/funcs/agents-responses-create.js.map +1 -1
  131. package/generated/manowar/esm/funcs/agents-runs-state-get.js +2 -2
  132. package/generated/manowar/esm/funcs/agents-runs-state-get.js.map +1 -1
  133. package/generated/manowar/esm/funcs/agents-stream-create.js +2 -2
  134. package/generated/manowar/esm/funcs/agents-stream-create.js.map +1 -1
  135. package/generated/manowar/esm/funcs/workflows-execute.js +2 -2
  136. package/generated/manowar/esm/funcs/workflows-execute.js.map +1 -1
  137. package/generated/manowar/esm/funcs/workflows-run-alias.js +2 -2
  138. package/generated/manowar/esm/funcs/workflows-run-alias.js.map +1 -1
  139. package/generated/manowar/esm/funcs/workflows-runs-approval-signal.js +2 -2
  140. package/generated/manowar/esm/funcs/workflows-runs-approval-signal.js.map +1 -1
  141. package/generated/manowar/esm/funcs/workflows-runs-state-get.js +2 -2
  142. package/generated/manowar/esm/funcs/workflows-runs-state-get.js.map +1 -1
  143. package/generated/manowar/esm/funcs/workflows-stop.js +2 -2
  144. package/generated/manowar/esm/funcs/workflows-stop.js.map +1 -1
  145. package/generated/manowar/esm/funcs/workflows-stream-create.js +2 -2
  146. package/generated/manowar/esm/funcs/workflows-stream-create.js.map +1 -1
  147. package/generated/manowar/esm/lib/config.d.ts +4 -4
  148. package/generated/manowar/esm/lib/config.d.ts.map +1 -1
  149. package/generated/manowar/esm/lib/config.js +6 -6
  150. package/generated/manowar/esm/lib/config.js.map +1 -1
  151. package/generated/manowar/esm/lib/encodings.d.ts +2 -2
  152. package/generated/manowar/esm/models/agent-stream-request.d.ts +0 -2
  153. package/generated/manowar/esm/models/agent-stream-request.d.ts.map +1 -1
  154. package/generated/manowar/esm/models/agent-stream-request.js +0 -1
  155. package/generated/manowar/esm/models/agent-stream-request.js.map +1 -1
  156. package/generated/manowar/esm/models/operations/execute.d.ts +1 -1
  157. package/generated/manowar/esm/models/operations/execute.d.ts.map +1 -1
  158. package/generated/manowar/esm/models/operations/execute.js +2 -2
  159. package/generated/manowar/esm/models/operations/execute.js.map +1 -1
  160. package/generated/manowar/esm/models/operations/responses-create.d.ts +1 -1
  161. package/generated/manowar/esm/models/operations/responses-create.d.ts.map +1 -1
  162. package/generated/manowar/esm/models/operations/responses-create.js +2 -2
  163. package/generated/manowar/esm/models/operations/responses-create.js.map +1 -1
  164. package/generated/manowar/esm/models/operations/run-alias.d.ts +1 -1
  165. package/generated/manowar/esm/models/operations/run-alias.d.ts.map +1 -1
  166. package/generated/manowar/esm/models/operations/run-alias.js +2 -2
  167. package/generated/manowar/esm/models/operations/run-alias.js.map +1 -1
  168. package/generated/manowar/esm/models/operations/runs-approval-signal.d.ts +1 -1
  169. package/generated/manowar/esm/models/operations/runs-approval-signal.d.ts.map +1 -1
  170. package/generated/manowar/esm/models/operations/runs-approval-signal.js +2 -2
  171. package/generated/manowar/esm/models/operations/runs-approval-signal.js.map +1 -1
  172. package/generated/manowar/esm/models/operations/runs-state-get.d.ts +1 -1
  173. package/generated/manowar/esm/models/operations/runs-state-get.d.ts.map +1 -1
  174. package/generated/manowar/esm/models/operations/runs-state-get.js +2 -2
  175. package/generated/manowar/esm/models/operations/runs-state-get.js.map +1 -1
  176. package/generated/manowar/esm/models/operations/stop.d.ts +1 -1
  177. package/generated/manowar/esm/models/operations/stop.d.ts.map +1 -1
  178. package/generated/manowar/esm/models/operations/stop.js +2 -2
  179. package/generated/manowar/esm/models/operations/stop.js.map +1 -1
  180. package/generated/manowar/esm/models/operations/stream-create.d.ts +1 -1
  181. package/generated/manowar/esm/models/operations/stream-create.d.ts.map +1 -1
  182. package/generated/manowar/esm/models/operations/stream-create.js +2 -2
  183. package/generated/manowar/esm/models/operations/stream-create.js.map +1 -1
  184. package/generated/manowar/esm/models/operations/workflow-runs-state-get.d.ts +1 -1
  185. package/generated/manowar/esm/models/operations/workflow-runs-state-get.d.ts.map +1 -1
  186. package/generated/manowar/esm/models/operations/workflow-runs-state-get.js +2 -2
  187. package/generated/manowar/esm/models/operations/workflow-runs-state-get.js.map +1 -1
  188. package/generated/manowar/esm/models/operations/workflow-stream-create.d.ts +1 -1
  189. package/generated/manowar/esm/models/operations/workflow-stream-create.d.ts.map +1 -1
  190. package/generated/manowar/esm/models/operations/workflow-stream-create.js +2 -2
  191. package/generated/manowar/esm/models/operations/workflow-stream-create.js.map +1 -1
  192. package/generated/manowar/esm/models/workflow-stream-request.d.ts +0 -2
  193. package/generated/manowar/esm/models/workflow-stream-request.d.ts.map +1 -1
  194. package/generated/manowar/esm/models/workflow-stream-request.js +0 -1
  195. package/generated/manowar/esm/models/workflow-stream-request.js.map +1 -1
  196. package/generated/manowar/esm/sdk/sdk.js +4 -4
  197. package/generated/manowar/esm/sdk/sdk.js.map +1 -1
  198. package/generated/manowar/esm/types/async.js +1 -1
  199. package/generated/manowar/esm/types/async.js.map +1 -1
  200. package/generated/manowar/package.json +1 -1
  201. package/generated/manowar/src/funcs/agents-responses-create.ts +2 -2
  202. package/generated/manowar/src/funcs/agents-runs-state-get.ts +2 -2
  203. package/generated/manowar/src/funcs/agents-stream-create.ts +2 -2
  204. package/generated/manowar/src/funcs/workflows-execute.ts +2 -2
  205. package/generated/manowar/src/funcs/workflows-run-alias.ts +2 -2
  206. package/generated/manowar/src/funcs/workflows-runs-approval-signal.ts +2 -2
  207. package/generated/manowar/src/funcs/workflows-runs-state-get.ts +2 -2
  208. package/generated/manowar/src/funcs/workflows-stop.ts +2 -2
  209. package/generated/manowar/src/funcs/workflows-stream-create.ts +2 -2
  210. package/generated/manowar/src/lib/config.ts +6 -6
  211. package/generated/manowar/src/models/agent-stream-request.ts +0 -3
  212. package/generated/manowar/src/models/operations/execute.ts +2 -2
  213. package/generated/manowar/src/models/operations/responses-create.ts +2 -2
  214. package/generated/manowar/src/models/operations/run-alias.ts +2 -2
  215. package/generated/manowar/src/models/operations/runs-approval-signal.ts +2 -2
  216. package/generated/manowar/src/models/operations/runs-state-get.ts +2 -2
  217. package/generated/manowar/src/models/operations/stop.ts +2 -2
  218. package/generated/manowar/src/models/operations/stream-create.ts +2 -2
  219. package/generated/manowar/src/models/operations/workflow-runs-state-get.ts +2 -2
  220. package/generated/manowar/src/models/operations/workflow-stream-create.ts +2 -2
  221. package/generated/manowar/src/models/workflow-stream-request.ts +0 -3
  222. package/generated/memory/esm/lib/config.d.ts +4 -4
  223. package/generated/memory/esm/lib/config.d.ts.map +1 -1
  224. package/generated/memory/esm/lib/config.js +6 -6
  225. package/generated/memory/esm/lib/config.js.map +1 -1
  226. package/generated/memory/esm/lib/encodings.d.ts +2 -2
  227. package/generated/memory/esm/sdk/sdk.js +1 -1
  228. package/generated/memory/esm/sdk/sdk.js.map +1 -1
  229. package/generated/memory/esm/types/async.js +1 -1
  230. package/generated/memory/esm/types/async.js.map +1 -1
  231. package/generated/memory/package.json +1 -1
  232. package/generated/memory/src/lib/config.ts +6 -6
  233. package/generated/x402/esm/lib/config.d.ts +3 -3
  234. package/generated/x402/esm/lib/config.js +3 -3
  235. package/generated/x402/esm/lib/config.js.map +1 -1
  236. package/generated/x402/esm/lib/encodings.d.ts +2 -2
  237. package/generated/x402/esm/sdk/sdk.js +5 -5
  238. package/generated/x402/esm/sdk/sdk.js.map +1 -1
  239. package/generated/x402/esm/types/async.js +1 -1
  240. package/generated/x402/esm/types/async.js.map +1 -1
  241. package/generated/x402/package.json +1 -1
  242. package/generated/x402/src/lib/config.ts +3 -3
  243. package/package.json +6 -6
  244. package/dist/tools/index.d.ts +0 -55
  245. package/dist/tools/index.d.ts.map +0 -1
  246. package/dist/tools/index.js +0 -51
  247. package/dist/tools/index.js.map +0 -1
@@ -5,15 +5,60 @@
5
5
  * (`api.compose.market`) and the SDK. They mirror the OpenAPI sources under
6
6
  * `packages/sdk/specs`; if a mismatch is ever observed, the server contract is
7
7
  * authoritative and this file is the one that needs updating.
8
- *
9
- * Base wire types (payment, receipt, session, errors) are re-exported from
10
- * `@compose-market/core`. SDK-specific types (model catalog, inference,
11
- * agent/workflow streams, memory loop, feedback) are declared below.
12
8
  */
13
- export type { ErrorCode, ErrorEnvelope, PaymentRequirements, PaymentRequiredResource, PaymentRequired, PaymentPayload, X402PaymentSignature, X402PaymentRequest, X402PaymentSigner, PaymentMode, ReceiptLineItem, ReceiptFees, ReceiptBill, Receipt, SessionBudgetSnapshot, SessionInvalidReason, SessionActiveEvent, SessionExpiredEvent, SessionLeaseEvent, SessionEvent, Alert, } from "@compose-market/core";
14
- import type { Receipt, SessionBudgetSnapshot, SessionInvalidReason } from "@compose-market/core";
9
+ import type { Receipt, SessionBudgetSnapshot, SessionInvalidReason } from "@compose-market/core/types";
15
10
  import type { AgentStreamControls } from "@compose-market/core/msm";
11
+ export type { Receipt, Bill, CumulativeBill, Fees, LineItem, ListResponse, SessionBudgetSnapshot, SessionInvalidReason, } from "@compose-market/core/types";
16
12
  export type { AgentStreamControls } from "@compose-market/core/msm";
13
+ export type ErrorCode = "validation_error" | "authentication_required" | "authentication_failed" | "forbidden" | "not_found" | "conflict" | "rate_limited" | "payment_required" | "insufficient_balance" | "insufficient_allowance" | "budget_exhausted" | "key_revoked" | "key_expired" | "key_not_found" | "chain_not_supported" | "model_not_found" | "model_ambiguous" | "provider_unavailable" | "upstream_timeout" | "upstream_error" | "internal_error" | "idempotency_conflict" | "idempotency_in_flight" | "settlement_failed" | "session_invalid" | "network_error" | "timeout";
14
+ export interface ErrorEnvelope {
15
+ error: {
16
+ code: ErrorCode;
17
+ message: string;
18
+ details?: Record<string, unknown>;
19
+ };
20
+ }
21
+ export interface PaymentRequirements {
22
+ scheme: string;
23
+ network: string;
24
+ amount: string;
25
+ asset: string;
26
+ payTo: string;
27
+ maxTimeoutSeconds: number;
28
+ extra?: Record<string, unknown> | null;
29
+ }
30
+ export interface PaymentRequired {
31
+ x402Version: 2;
32
+ error?: string;
33
+ resource: {
34
+ url: string;
35
+ description?: string;
36
+ mimeType?: string;
37
+ };
38
+ accepts: PaymentRequirements[];
39
+ extensions?: Record<string, unknown> | null;
40
+ }
41
+ export interface PaymentPayload {
42
+ x402Version: 2;
43
+ accepted: PaymentRequirements;
44
+ payload: unknown;
45
+ resource?: PaymentRequired["resource"];
46
+ extensions?: Record<string, unknown> | null;
47
+ }
48
+ export type X402PaymentSignature = string | PaymentPayload;
49
+ export interface X402PaymentRequest {
50
+ paymentRequired: PaymentRequired;
51
+ paymentRequiredHeader: string | null;
52
+ method: string;
53
+ path: string;
54
+ url: string;
55
+ body?: unknown;
56
+ userAddress?: string | null;
57
+ chainId?: number | null;
58
+ maxAmountWei?: string;
59
+ }
60
+ export type X402PaymentSigner = (request: X402PaymentRequest) => X402PaymentSignature | Promise<X402PaymentSignature>;
61
+ export type PaymentMode = "auto" | "composeKey" | "x402";
17
62
  export interface SettleResponse {
18
63
  success: boolean;
19
64
  errorReason?: string;
@@ -204,11 +249,11 @@ export interface FeedbackSummary {
204
249
  verification: Record<FeedbackVerificationKind, number>;
205
250
  recent: FeedbackRecord[];
206
251
  }
207
- export type KeyPurpose = "session" | "api";
208
- export interface KeyCreateResponse {
252
+ export type ComposeKeyPurpose = "session" | "api";
253
+ export interface ComposeKeyCreateResponse {
209
254
  keyId: string;
210
255
  token: string;
211
- purpose: KeyPurpose;
256
+ purpose: ComposeKeyPurpose;
212
257
  budgetLimit: string;
213
258
  budgetUsed: string;
214
259
  budgetRemaining: string;
@@ -217,9 +262,9 @@ export interface KeyCreateResponse {
217
262
  chainId: number;
218
263
  name?: string;
219
264
  }
220
- export interface KeyRecord {
265
+ export interface ComposeKeyRecord {
221
266
  keyId: string;
222
- purpose: KeyPurpose;
267
+ purpose: ComposeKeyPurpose;
223
268
  budgetLimit: string;
224
269
  budgetUsed: string;
225
270
  budgetReserved?: string;
@@ -256,17 +301,62 @@ export interface ActiveSessionMetadata {
256
301
  };
257
302
  };
258
303
  }
259
- export interface ReceiptCumulative {
260
- totalAmountWei: string;
261
- providerAmountWei?: string;
262
- platformFeeWei?: string;
263
- receiptCount: number;
304
+ /**
305
+ * SSE-frame payload for `/api/session/events`. The server emits two named
306
+ * events: `session-active` (live ledger heartbeat while the session is
307
+ * healthy) and `session-expired` (terminal notification when the session has
308
+ * been revoked, expired, or run out of budget).
309
+ */
310
+ export interface SessionActiveEvent {
311
+ type: "session-active";
312
+ userAddress: string;
313
+ chainId: number;
314
+ expiresAt?: number;
315
+ budgetLimit?: string;
316
+ budgetUsed?: string;
317
+ budgetLocked?: string;
318
+ budgetRemaining?: string;
319
+ timestamp?: number;
264
320
  }
265
- export interface ReceiptListResponse {
321
+ export interface SessionExpiredEvent {
322
+ type: "session-expired";
266
323
  userAddress: string;
267
324
  chainId: number;
268
- cumulative: ReceiptCumulative;
269
- receipts: Receipt[];
325
+ reason?: SessionInvalidReason;
326
+ message?: string;
327
+ action?: string;
328
+ expiresAt?: number;
329
+ timestamp?: number;
330
+ }
331
+ export interface SessionLeaseEvent {
332
+ type: "session-lease";
333
+ userAddress: string;
334
+ chainId: number;
335
+ reason?: "lease-expired" | (string & {
336
+ readonly __brand?: "SessionLeaseReason";
337
+ });
338
+ message?: string;
339
+ leaseMs?: number;
340
+ retryAfterMs?: number;
341
+ timestamp?: number;
342
+ }
343
+ export type SessionEvent = SessionActiveEvent | SessionExpiredEvent | SessionLeaseEvent;
344
+ export interface Alert {
345
+ type: "compose.alert";
346
+ code: string;
347
+ severity: "info" | "warning" | "error";
348
+ source: string;
349
+ scope: "session" | "agent" | "model" | "workflow" | "api" | (string & {
350
+ readonly __brand?: "AlertScope";
351
+ });
352
+ title?: string;
353
+ message: string;
354
+ userAddress?: string | null;
355
+ chainId?: number | null;
356
+ timestamp?: number;
357
+ metadata?: Record<string, unknown>;
358
+ leaseMs?: number;
359
+ retryAfterMs?: number;
270
360
  }
271
361
  export type ModelProvider = "gemini" | "openai" | "fireworks" | "deepinfra" | "asicloud" | "alibaba" | "hugging face" | "azure" | "aiml" | "vertex" | "cloudflare" | "deepgram" | "elevenlabs" | "cartesia" | "roboflow";
272
362
  export type CanonicalModality = "text" | "image" | "audio" | "video" | "embedding" | "realtime";
@@ -413,7 +503,6 @@ export interface RuntimeFramework {
413
503
  export interface FrameworksResponse {
414
504
  frameworks: RuntimeFramework[];
415
505
  }
416
- export type MessageRole = "system" | "developer" | "user" | "assistant" | "tool";
417
506
  export type AttachmentKind = "image" | "audio" | "video" | "pdf" | "file" | "text" | "json" | "url";
418
507
  export interface Attachment {
419
508
  type?: AttachmentKind | (string & {
@@ -436,44 +525,6 @@ export interface Attachment {
436
525
  [key: string]: unknown;
437
526
  }
438
527
  export type AttachmentInput = Attachment | string;
439
- export interface MessageTextPart {
440
- type: "text";
441
- text: string;
442
- }
443
- export interface MessageImagePart {
444
- type: "image_url";
445
- image_url: {
446
- url: string;
447
- detail?: "auto" | "low" | "high";
448
- } | string;
449
- }
450
- export interface MessageAudioPart {
451
- type: "input_audio";
452
- input_audio: {
453
- url: string;
454
- } | string;
455
- }
456
- export interface MessageVideoPart {
457
- type: "video_url";
458
- video_url: {
459
- url: string;
460
- } | string;
461
- }
462
- export type MessageContentPart = MessageTextPart | MessageImagePart | MessageAudioPart | MessageVideoPart;
463
- export interface Message {
464
- role: MessageRole;
465
- content: string | MessageContentPart[] | null;
466
- name?: string;
467
- tool_call_id?: string;
468
- tool_calls?: Array<{
469
- id: string;
470
- type: "function";
471
- function: {
472
- name: string;
473
- arguments: string;
474
- };
475
- }>;
476
- }
477
528
  export interface ToolDefinition {
478
529
  type: "function";
479
530
  function: {
@@ -599,7 +650,7 @@ export interface ResponseOutputItem {
599
650
  * Events emitted by the Compose agent runtime on /agent/:wallet/stream.
600
651
  * Mirrors the runtime's native SSE vocabulary — no translation, no renaming.
601
652
  */
602
- export type AgentDisplayKind = "tool" | "model" | "connector" | "agent" | "search" | "harness" | "swarm" | "conclave" | "route";
653
+ export type AgentDisplayKind = "tool" | "model" | "connector" | "agent" | "search" | "harness" | "conclave" | "route";
603
654
  export interface AgentEventDisplay {
604
655
  kind: AgentDisplayKind;
605
656
  id?: string;
@@ -608,16 +659,16 @@ export interface AgentEventDisplay {
608
659
  summary?: string;
609
660
  details?: Record<string, unknown>;
610
661
  }
611
- export type PlanDecision = "approved" | "rejected" | "changes_requested";
662
+ export type AgentHarnessPlanDecision = "approved" | "rejected" | "changes_requested";
612
663
  export type AgentArtifactKind = "image" | "audio" | "video" | "embedding" | "realtime" | "file" | "artifact";
613
664
  export interface AgentStreamCreateParams extends AgentStreamControls {
614
665
  agentWallet: string;
615
666
  message: string;
616
667
  threadId: string;
617
668
  userAddress: string;
618
- agentCard?: unknown;
619
669
  cloudPermissions?: unknown;
620
670
  runId?: string;
671
+ agentCard?: DirectoryAgent;
621
672
  attachment?: AttachmentInput;
622
673
  attachments?: AttachmentInput[];
623
674
  }
@@ -643,8 +694,7 @@ export interface AgentDecisionInput {
643
694
  runId: string;
644
695
  proposalId: string;
645
696
  version: number;
646
- approvalId?: string;
647
- decision: PlanDecision;
697
+ decision: AgentHarnessPlanDecision;
648
698
  approver?: string;
649
699
  reason?: string;
650
700
  feedback?: string;
@@ -654,7 +704,7 @@ export interface AgentDecisionResult {
654
704
  proposalId?: string;
655
705
  version?: number;
656
706
  state?: string;
657
- decision?: PlanDecision;
707
+ decision?: AgentHarnessPlanDecision;
658
708
  [key: string]: unknown;
659
709
  }
660
710
  export interface WorkflowStreamCreateParams {
@@ -682,6 +732,146 @@ export interface WorkflowStreamFinalResult {
682
732
  budget: SessionBudgetSnapshot | null;
683
733
  sessionInvalidReason: SessionInvalidReason | null;
684
734
  }
735
+ export interface LocalLinkCreateInput {
736
+ userAddress?: string;
737
+ chainId?: number;
738
+ agentWallet?: string;
739
+ agentCardCid?: string;
740
+ deviceId?: string;
741
+ }
742
+ export interface LocalLinkCreateResponse {
743
+ success: boolean;
744
+ token: string;
745
+ mode: "local-first" | "web-first";
746
+ expiresAt: number;
747
+ deepLinkUrl: string;
748
+ hasSession: boolean;
749
+ }
750
+ export interface LocalLinkRedeemInput {
751
+ token: string;
752
+ deviceId: string;
753
+ connectedUserAddress?: string;
754
+ }
755
+ export interface LocalRedeemedContext {
756
+ agentWallet: string;
757
+ userAddress: string;
758
+ chainId: number;
759
+ composeKey: {
760
+ keyId: string;
761
+ token: string;
762
+ expiresAt: number;
763
+ };
764
+ session: {
765
+ sessionId: string;
766
+ budget: string;
767
+ duration: number;
768
+ expiresAt: number;
769
+ };
770
+ market: {
771
+ entry: "local" | string;
772
+ agentWallet: string;
773
+ agentCardCid: string | null;
774
+ };
775
+ deviceId: string;
776
+ hasSession: boolean;
777
+ linkMode: "local-first" | "web-first";
778
+ }
779
+ export interface LocalLinkRedeemResponse {
780
+ success: boolean;
781
+ context: LocalRedeemedContext;
782
+ }
783
+ export interface LocalDeploymentRegisterInput {
784
+ agentWallet: string;
785
+ userAddress?: string;
786
+ composeKeyId: string;
787
+ agentCardCid: string;
788
+ localVersion: string;
789
+ deployedAt: number;
790
+ chainId?: number;
791
+ }
792
+ export interface LocalDeploymentRecord {
793
+ version: number;
794
+ deploymentId: string;
795
+ agentWallet: string;
796
+ userAddress: string;
797
+ composeKeyId: string;
798
+ agentCardCid: string;
799
+ localVersion: string;
800
+ deployedAt: number;
801
+ chainId: number;
802
+ registeredAt: number;
803
+ updatedAt: number;
804
+ }
805
+ export interface LocalDeploymentRegisterResponse {
806
+ success: boolean;
807
+ idempotent: boolean;
808
+ deployment: LocalDeploymentRecord;
809
+ }
810
+ export interface LocalPeerSummary {
811
+ peerId: string;
812
+ lastSeenAt: number;
813
+ stale: boolean;
814
+ caps: string[];
815
+ listenMultiaddrs: string[];
816
+ deviceId?: string | null;
817
+ agentWallet?: string | null;
818
+ }
819
+ export interface LocalNetworkUpsertInput {
820
+ userAddress?: string;
821
+ chainId?: number;
822
+ agentWallet?: string;
823
+ deviceId?: string;
824
+ peers: LocalPeerSummary[];
825
+ }
826
+ export interface LocalNetworkUpsertResponse {
827
+ success: boolean;
828
+ upserted: number;
829
+ chainId: number;
830
+ }
831
+ export interface LocalNetworkPeersInput {
832
+ userAddress?: string;
833
+ chainId?: number;
834
+ agentWallet?: string;
835
+ }
836
+ export interface LocalNetworkPeersResponse {
837
+ success: boolean;
838
+ chainId: number;
839
+ userAddress: string;
840
+ peers: LocalPeerSummary[];
841
+ }
842
+ export interface LocalSynapseSessionInput {
843
+ agentWallet: string;
844
+ deviceId: string;
845
+ sessionKeyAddress: string;
846
+ sessionKeyExpiresAt: number;
847
+ depositAmount?: string | number;
848
+ }
849
+ export interface LocalStorageSessionResponse {
850
+ success: boolean;
851
+ agentWallet: string;
852
+ deviceId: string;
853
+ payerAddress: string;
854
+ sessionKeyAddress: string;
855
+ sessionKeyExpiresAt: number;
856
+ availableFunds: string;
857
+ depositAmount: string;
858
+ depositExecuted: boolean;
859
+ network: string;
860
+ source: string;
861
+ }
862
+ export type LocalSynapseSessionResponse = LocalStorageSessionResponse;
863
+ export interface LocalFilecoinPinSessionInput {
864
+ agentWallet: string;
865
+ deviceId: string;
866
+ sessionKeyAddress: string;
867
+ sessionKeyExpiresAt: number;
868
+ fileSizeBytes: number;
869
+ copies?: number;
870
+ }
871
+ export interface LocalFilecoinPinSessionResponse extends LocalStorageSessionResponse {
872
+ fileSizeBytes: number;
873
+ providerIds: string[];
874
+ }
685
875
  export interface DispenserStatus {
686
876
  chainId: number;
687
877
  chainName: string;
@@ -876,8 +1066,6 @@ export interface ChannelRoute {
876
1066
  channel: ChannelName;
877
1067
  userAddress: string;
878
1068
  agentWallet: string;
879
- scope: "global" | "local";
880
- haiId?: string;
881
1069
  accountId: string;
882
1070
  threadId: string;
883
1071
  label?: string;
@@ -899,8 +1087,6 @@ export interface ChannelGetResponse {
899
1087
  export interface ChannelLinkInput {
900
1088
  userAddress?: string;
901
1089
  agentWallet: string;
902
- scope?: "global" | "local";
903
- haiId?: string;
904
1090
  agentName?: string;
905
1091
  mode?: "user" | "guild";
906
1092
  privacy?: "public" | "private";
@@ -910,8 +1096,6 @@ export interface ChannelLinkResponse {
910
1096
  channel: ChannelName;
911
1097
  userAddress: string;
912
1098
  agentWallet: string;
913
- scope: "global" | "local";
914
- haiId?: string;
915
1099
  agentName?: string;
916
1100
  mode?: "user" | "guild";
917
1101
  privacy?: "public" | "private";
@@ -929,8 +1113,6 @@ export interface ChannelLinkResponse {
929
1113
  export interface ChannelStatusInput {
930
1114
  userAddress?: string;
931
1115
  agentWallet: string;
932
- scope?: "global" | "local";
933
- haiId?: string;
934
1116
  accountId?: string;
935
1117
  threadId?: string;
936
1118
  }
@@ -942,8 +1124,6 @@ export interface ChannelStatusResponse {
942
1124
  export interface ChannelDisconnectInput {
943
1125
  userAddress?: string;
944
1126
  agentWallet: string;
945
- scope?: "global" | "local";
946
- haiId?: string;
947
1127
  accountId?: string;
948
1128
  threadId?: string;
949
1129
  }
@@ -1217,52 +1397,6 @@ export interface SearchResult {
1217
1397
  accessCount?: number;
1218
1398
  createdAt?: number;
1219
1399
  }
1220
- export interface GraphMemoryItem {
1221
- id?: string;
1222
- memory?: string;
1223
- user_id?: string;
1224
- agent_id?: string;
1225
- run_id?: string;
1226
- metadata?: Record<string, unknown>;
1227
- created_at?: string;
1228
- updated_at?: string;
1229
- relations?: Array<Record<string, unknown>>;
1230
- [key: string]: unknown;
1231
- }
1232
- export interface GraphMemoryAddParams extends AgentMemoryScopeInput {
1233
- messages: Array<Partial<AgentMemoryTurnMessage> & Record<string, unknown>>;
1234
- runId?: string;
1235
- enableGraph?: boolean;
1236
- }
1237
- export interface GraphMemorySearchParams extends AgentMemoryScopeInput {
1238
- query: string;
1239
- runId?: string;
1240
- layers?: AgentMemoryLayer[];
1241
- limit?: number;
1242
- rerank?: boolean;
1243
- }
1244
- export interface GraphMemoryListParams {
1245
- userAddress?: string;
1246
- limit?: number;
1247
- }
1248
- export interface VectorMemorySearchParams extends AgentMemoryScopeInput {
1249
- query: string;
1250
- queryEmbedding?: number[];
1251
- limit?: number;
1252
- threshold?: number;
1253
- }
1254
- export interface VectorMemoryIndexParams extends AgentMemoryScopeInput {
1255
- content: string;
1256
- embedding?: number[];
1257
- source: MemorySource;
1258
- }
1259
- export interface VectorMemorySearchResponse {
1260
- results: SearchResult[];
1261
- }
1262
- export interface VectorMemoryIndexResponse {
1263
- success: boolean;
1264
- vectorId?: string;
1265
- }
1266
1400
  export interface MemoryVector {
1267
1401
  vectorId: string;
1268
1402
  id?: string;
@@ -1275,8 +1409,6 @@ export interface MemoryVector {
1275
1409
  threadId?: string;
1276
1410
  scope?: "global" | "local";
1277
1411
  haiId?: string;
1278
- scopeKind?: "global" | "local";
1279
- scopeId?: string;
1280
1412
  decayScore: number;
1281
1413
  accessCount: number;
1282
1414
  createdAt: number;
@@ -1300,60 +1432,6 @@ export interface MemoryItemUpdateParams extends MemoryItemQuery {
1300
1432
  export interface MemoryItemDeleteParams extends MemoryItemQuery {
1301
1433
  hardDelete?: boolean;
1302
1434
  }
1303
- export interface TranscriptStoreParams {
1304
- sessionId: string;
1305
- threadId: string;
1306
- agentWallet: string;
1307
- userAddress?: string;
1308
- scope?: "global" | "local";
1309
- haiId?: string;
1310
- messages: AgentMemoryTurnMessage[];
1311
- tokenCount: number;
1312
- summary?: string;
1313
- summaryEmbedding?: number[];
1314
- metadata?: Record<string, unknown>;
1315
- }
1316
- export interface TranscriptStoreResponse {
1317
- success: boolean;
1318
- }
1319
- export interface TranscriptGetParams {
1320
- type?: "sessionId" | "threadId";
1321
- agentWallet?: string;
1322
- userAddress?: string;
1323
- }
1324
- export interface SessionTranscript {
1325
- sessionId: string;
1326
- threadId: string;
1327
- agentWallet: string;
1328
- userAddress?: string;
1329
- scope?: "global" | "local";
1330
- haiId?: string;
1331
- messages: AgentMemoryTurnMessage[];
1332
- summary?: string;
1333
- tokenCount?: number;
1334
- metadata: Record<string, unknown>;
1335
- createdAt: number;
1336
- expiresAt?: number;
1337
- }
1338
- export interface MemoryRerankParams {
1339
- query: string;
1340
- documents: Array<Record<string, unknown>>;
1341
- topK?: number;
1342
- }
1343
- export interface MemoryRerankResponse {
1344
- results: Array<Record<string, unknown>>;
1345
- }
1346
- export interface MemoryStatsResponse {
1347
- totalVectors: number;
1348
- totalTranscripts: number;
1349
- avgDecayScore: number;
1350
- oldestVector: number;
1351
- newestVector: number;
1352
- byType: Record<string, number>;
1353
- }
1354
- export interface MemoryScheduleQuery {
1355
- agentWallets?: string[];
1356
- }
1357
1435
  export interface MemoryJobCreateParams {
1358
1436
  type: "consolidate" | "patterns_extract" | "archive_create" | "decay_update" | "cleanup";
1359
1437
  execution?: "inline" | "temporal";