@compose-market/sdk 0.8.9 → 0.8.11

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 (258) 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/index.d.ts +14 -19
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +13 -12
  8. package/dist/index.js.map +1 -1
  9. package/dist/resources/accounts.d.ts.map +1 -1
  10. package/dist/resources/accounts.js +1 -1
  11. package/dist/resources/accounts.js.map +1 -1
  12. package/dist/resources/agent.d.ts +22 -9
  13. package/dist/resources/agent.d.ts.map +1 -1
  14. package/dist/resources/agent.js +543 -234
  15. package/dist/resources/agent.js.map +1 -1
  16. package/dist/resources/channels.d.ts.map +1 -1
  17. package/dist/resources/channels.js +4 -22
  18. package/dist/resources/channels.js.map +1 -1
  19. package/dist/resources/directory.d.ts.map +1 -1
  20. package/dist/resources/directory.js.map +1 -1
  21. package/dist/resources/dispenser.d.ts.map +1 -1
  22. package/dist/resources/dispenser.js +1 -1
  23. package/dist/resources/dispenser.js.map +1 -1
  24. package/dist/resources/feedback.d.ts.map +1 -1
  25. package/dist/resources/feedback.js +1 -1
  26. package/dist/resources/feedback.js.map +1 -1
  27. package/dist/resources/inference.d.ts +2 -2
  28. package/dist/resources/inference.d.ts.map +1 -1
  29. package/dist/resources/inference.js +206 -171
  30. package/dist/resources/inference.js.map +1 -1
  31. package/dist/resources/keys.d.ts +5 -5
  32. package/dist/resources/keys.d.ts.map +1 -1
  33. package/dist/resources/keys.js +1 -1
  34. package/dist/resources/keys.js.map +1 -1
  35. package/dist/resources/local.d.ts +56 -0
  36. package/dist/resources/local.d.ts.map +1 -0
  37. package/dist/resources/local.js +163 -0
  38. package/dist/resources/local.js.map +1 -0
  39. package/dist/resources/memory.d.ts +3 -25
  40. package/dist/resources/memory.d.ts.map +1 -1
  41. package/dist/resources/memory.js +12 -75
  42. package/dist/resources/memory.js.map +1 -1
  43. package/dist/resources/models.d.ts.map +1 -1
  44. package/dist/resources/models.js.map +1 -1
  45. package/dist/resources/permissions.d.ts.map +1 -1
  46. package/dist/resources/permissions.js +1 -1
  47. package/dist/resources/permissions.js.map +1 -1
  48. package/dist/resources/receipts.d.ts +2 -3
  49. package/dist/resources/receipts.d.ts.map +1 -1
  50. package/dist/resources/receipts.js +1 -8
  51. package/dist/resources/receipts.js.map +1 -1
  52. package/dist/resources/session-events.d.ts.map +1 -1
  53. package/dist/resources/session-events.js +3 -3
  54. package/dist/resources/session-events.js.map +1 -1
  55. package/dist/resources/settlement.d.ts.map +1 -1
  56. package/dist/resources/settlement.js +1 -1
  57. package/dist/resources/settlement.js.map +1 -1
  58. package/dist/resources/system.d.ts.map +1 -1
  59. package/dist/resources/system.js.map +1 -1
  60. package/dist/resources/webhooks.d.ts.map +1 -1
  61. package/dist/resources/workflow.d.ts +17 -10
  62. package/dist/resources/workflow.d.ts.map +1 -1
  63. package/dist/resources/workflow.js +182 -87
  64. package/dist/resources/workflow.js.map +1 -1
  65. package/dist/resources/x402.d.ts.map +1 -1
  66. package/dist/resources/x402.js.map +1 -1
  67. package/dist/storage.d.ts +27 -0
  68. package/dist/storage.d.ts.map +1 -0
  69. package/dist/storage.js +46 -0
  70. package/dist/storage.js.map +1 -0
  71. package/dist/types/index.d.ts +257 -176
  72. package/dist/types/index.d.ts.map +1 -1
  73. package/dist/types/index.js +0 -4
  74. package/dist/types/index.js.map +1 -1
  75. package/dist/version.d.ts +1 -1
  76. package/dist/version.d.ts.map +1 -1
  77. package/dist/version.js +1 -1
  78. package/dist/version.js.map +1 -1
  79. package/generated/channels/esm/lib/config.d.ts +3 -3
  80. package/generated/channels/esm/lib/config.js +3 -3
  81. package/generated/channels/esm/lib/config.js.map +1 -1
  82. package/generated/channels/esm/lib/encodings.d.ts +2 -2
  83. package/generated/channels/esm/sdk/sdk.js +1 -1
  84. package/generated/channels/esm/sdk/sdk.js.map +1 -1
  85. package/generated/channels/esm/types/async.js +1 -1
  86. package/generated/channels/esm/types/async.js.map +1 -1
  87. package/generated/channels/package.json +1 -1
  88. package/generated/channels/src/lib/config.ts +3 -3
  89. package/generated/inference/esm/lib/config.d.ts +3 -3
  90. package/generated/inference/esm/lib/config.js +3 -3
  91. package/generated/inference/esm/lib/config.js.map +1 -1
  92. package/generated/inference/esm/lib/encodings.d.ts +2 -2
  93. package/generated/inference/esm/models/receipt-body.d.ts +2 -2
  94. package/generated/inference/esm/models/receipt-body.d.ts.map +1 -1
  95. package/generated/inference/esm/models/receipt-body.js +2 -2
  96. package/generated/inference/esm/models/receipt-body.js.map +1 -1
  97. package/generated/inference/esm/models/receipt-line-item.d.ts +3 -3
  98. package/generated/inference/esm/models/receipt-line-item.d.ts.map +1 -1
  99. package/generated/inference/esm/models/receipt-line-item.js +2 -2
  100. package/generated/inference/esm/models/receipt-line-item.js.map +1 -1
  101. package/generated/inference/esm/sdk/sdk.js +4 -4
  102. package/generated/inference/esm/sdk/sdk.js.map +1 -1
  103. package/generated/inference/esm/types/async.js +1 -1
  104. package/generated/inference/esm/types/async.js.map +1 -1
  105. package/generated/inference/package.json +1 -1
  106. package/generated/inference/src/lib/config.ts +3 -3
  107. package/generated/inference/src/models/receipt-body.ts +4 -4
  108. package/generated/inference/src/models/receipt-line-item.ts +6 -6
  109. package/generated/manowar/esm/funcs/agents-responses-create.js +2 -2
  110. package/generated/manowar/esm/funcs/agents-responses-create.js.map +1 -1
  111. package/generated/manowar/esm/funcs/agents-runs-state-get.js +2 -2
  112. package/generated/manowar/esm/funcs/agents-runs-state-get.js.map +1 -1
  113. package/generated/manowar/esm/funcs/agents-stream-create.js +2 -2
  114. package/generated/manowar/esm/funcs/agents-stream-create.js.map +1 -1
  115. package/generated/manowar/esm/funcs/workflows-execute.js +2 -2
  116. package/generated/manowar/esm/funcs/workflows-execute.js.map +1 -1
  117. package/generated/manowar/esm/funcs/workflows-run-alias.js +2 -2
  118. package/generated/manowar/esm/funcs/workflows-run-alias.js.map +1 -1
  119. package/generated/manowar/esm/funcs/workflows-runs-approval-signal.js +2 -2
  120. package/generated/manowar/esm/funcs/workflows-runs-approval-signal.js.map +1 -1
  121. package/generated/manowar/esm/funcs/workflows-runs-state-get.js +2 -2
  122. package/generated/manowar/esm/funcs/workflows-runs-state-get.js.map +1 -1
  123. package/generated/manowar/esm/funcs/workflows-stop.js +2 -2
  124. package/generated/manowar/esm/funcs/workflows-stop.js.map +1 -1
  125. package/generated/manowar/esm/funcs/workflows-stream-create.js +2 -2
  126. package/generated/manowar/esm/funcs/workflows-stream-create.js.map +1 -1
  127. package/generated/manowar/esm/lib/config.d.ts +4 -4
  128. package/generated/manowar/esm/lib/config.d.ts.map +1 -1
  129. package/generated/manowar/esm/lib/config.js +6 -6
  130. package/generated/manowar/esm/lib/config.js.map +1 -1
  131. package/generated/manowar/esm/lib/encodings.d.ts +2 -2
  132. package/generated/manowar/esm/models/operations/execute.d.ts +1 -1
  133. package/generated/manowar/esm/models/operations/execute.d.ts.map +1 -1
  134. package/generated/manowar/esm/models/operations/execute.js +2 -2
  135. package/generated/manowar/esm/models/operations/execute.js.map +1 -1
  136. package/generated/manowar/esm/models/operations/responses-create.d.ts +1 -1
  137. package/generated/manowar/esm/models/operations/responses-create.d.ts.map +1 -1
  138. package/generated/manowar/esm/models/operations/responses-create.js +2 -2
  139. package/generated/manowar/esm/models/operations/responses-create.js.map +1 -1
  140. package/generated/manowar/esm/models/operations/run-alias.d.ts +1 -1
  141. package/generated/manowar/esm/models/operations/run-alias.d.ts.map +1 -1
  142. package/generated/manowar/esm/models/operations/run-alias.js +2 -2
  143. package/generated/manowar/esm/models/operations/run-alias.js.map +1 -1
  144. package/generated/manowar/esm/models/operations/runs-approval-signal.d.ts +1 -1
  145. package/generated/manowar/esm/models/operations/runs-approval-signal.d.ts.map +1 -1
  146. package/generated/manowar/esm/models/operations/runs-approval-signal.js +2 -2
  147. package/generated/manowar/esm/models/operations/runs-approval-signal.js.map +1 -1
  148. package/generated/manowar/esm/models/operations/runs-state-get.d.ts +1 -1
  149. package/generated/manowar/esm/models/operations/runs-state-get.d.ts.map +1 -1
  150. package/generated/manowar/esm/models/operations/runs-state-get.js +2 -2
  151. package/generated/manowar/esm/models/operations/runs-state-get.js.map +1 -1
  152. package/generated/manowar/esm/models/operations/stop.d.ts +1 -1
  153. package/generated/manowar/esm/models/operations/stop.d.ts.map +1 -1
  154. package/generated/manowar/esm/models/operations/stop.js +2 -2
  155. package/generated/manowar/esm/models/operations/stop.js.map +1 -1
  156. package/generated/manowar/esm/models/operations/stream-create.d.ts +1 -1
  157. package/generated/manowar/esm/models/operations/stream-create.d.ts.map +1 -1
  158. package/generated/manowar/esm/models/operations/stream-create.js +2 -2
  159. package/generated/manowar/esm/models/operations/stream-create.js.map +1 -1
  160. package/generated/manowar/esm/models/operations/workflow-runs-state-get.d.ts +1 -1
  161. package/generated/manowar/esm/models/operations/workflow-runs-state-get.d.ts.map +1 -1
  162. package/generated/manowar/esm/models/operations/workflow-runs-state-get.js +2 -2
  163. package/generated/manowar/esm/models/operations/workflow-runs-state-get.js.map +1 -1
  164. package/generated/manowar/esm/models/operations/workflow-stream-create.d.ts +1 -1
  165. package/generated/manowar/esm/models/operations/workflow-stream-create.d.ts.map +1 -1
  166. package/generated/manowar/esm/models/operations/workflow-stream-create.js +2 -2
  167. package/generated/manowar/esm/models/operations/workflow-stream-create.js.map +1 -1
  168. package/generated/manowar/esm/sdk/sdk.js +4 -4
  169. package/generated/manowar/esm/sdk/sdk.js.map +1 -1
  170. package/generated/manowar/esm/types/async.js +1 -1
  171. package/generated/manowar/esm/types/async.js.map +1 -1
  172. package/generated/manowar/package.json +1 -1
  173. package/generated/manowar/src/funcs/agents-responses-create.ts +2 -2
  174. package/generated/manowar/src/funcs/agents-runs-state-get.ts +2 -2
  175. package/generated/manowar/src/funcs/agents-stream-create.ts +2 -2
  176. package/generated/manowar/src/funcs/workflows-execute.ts +2 -2
  177. package/generated/manowar/src/funcs/workflows-run-alias.ts +2 -2
  178. package/generated/manowar/src/funcs/workflows-runs-approval-signal.ts +2 -2
  179. package/generated/manowar/src/funcs/workflows-runs-state-get.ts +2 -2
  180. package/generated/manowar/src/funcs/workflows-stop.ts +2 -2
  181. package/generated/manowar/src/funcs/workflows-stream-create.ts +2 -2
  182. package/generated/manowar/src/lib/config.ts +6 -6
  183. package/generated/manowar/src/models/operations/execute.ts +2 -2
  184. package/generated/manowar/src/models/operations/responses-create.ts +2 -2
  185. package/generated/manowar/src/models/operations/run-alias.ts +2 -2
  186. package/generated/manowar/src/models/operations/runs-approval-signal.ts +2 -2
  187. package/generated/manowar/src/models/operations/runs-state-get.ts +2 -2
  188. package/generated/manowar/src/models/operations/stop.ts +2 -2
  189. package/generated/manowar/src/models/operations/stream-create.ts +2 -2
  190. package/generated/manowar/src/models/operations/workflow-runs-state-get.ts +2 -2
  191. package/generated/manowar/src/models/operations/workflow-stream-create.ts +2 -2
  192. package/generated/memory/esm/lib/config.d.ts +4 -4
  193. package/generated/memory/esm/lib/config.d.ts.map +1 -1
  194. package/generated/memory/esm/lib/config.js +6 -6
  195. package/generated/memory/esm/lib/config.js.map +1 -1
  196. package/generated/memory/esm/lib/encodings.d.ts +2 -2
  197. package/generated/memory/esm/sdk/sdk.js +1 -1
  198. package/generated/memory/esm/sdk/sdk.js.map +1 -1
  199. package/generated/memory/esm/types/async.js +1 -1
  200. package/generated/memory/esm/types/async.js.map +1 -1
  201. package/generated/memory/package.json +1 -1
  202. package/generated/memory/src/lib/config.ts +6 -6
  203. package/generated/x402/esm/funcs/compose-keys-create.d.ts +1 -1
  204. package/generated/x402/esm/funcs/compose-keys-create.d.ts.map +1 -1
  205. package/generated/x402/esm/funcs/compose-keys-create.js +1 -1
  206. package/generated/x402/esm/funcs/compose-keys-create.js.map +1 -1
  207. package/generated/x402/esm/funcs/compose-keys-get.d.ts +1 -1
  208. package/generated/x402/esm/funcs/compose-keys-get.d.ts.map +1 -1
  209. package/generated/x402/esm/funcs/compose-keys-get.js +1 -1
  210. package/generated/x402/esm/funcs/compose-keys-get.js.map +1 -1
  211. package/generated/x402/esm/funcs/compose-keys-list.d.ts +1 -1
  212. package/generated/x402/esm/funcs/compose-keys-list.d.ts.map +1 -1
  213. package/generated/x402/esm/funcs/compose-keys-list.js +1 -1
  214. package/generated/x402/esm/funcs/compose-keys-list.js.map +1 -1
  215. package/generated/x402/esm/funcs/compose-keys-revoke.d.ts +1 -1
  216. package/generated/x402/esm/funcs/compose-keys-revoke.d.ts.map +1 -1
  217. package/generated/x402/esm/funcs/compose-keys-revoke.js +1 -1
  218. package/generated/x402/esm/funcs/compose-keys-revoke.js.map +1 -1
  219. package/generated/x402/esm/funcs/compose-keys-session-events-subscribe.d.ts +1 -1
  220. package/generated/x402/esm/funcs/compose-keys-session-events-subscribe.d.ts.map +1 -1
  221. package/generated/x402/esm/funcs/compose-keys-session-events-subscribe.js +1 -1
  222. package/generated/x402/esm/funcs/compose-keys-session-events-subscribe.js.map +1 -1
  223. package/generated/x402/esm/funcs/compose-keys-session-get-active.d.ts +1 -1
  224. package/generated/x402/esm/funcs/compose-keys-session-get-active.d.ts.map +1 -1
  225. package/generated/x402/esm/funcs/compose-keys-session-get-active.js +1 -1
  226. package/generated/x402/esm/funcs/compose-keys-session-get-active.js.map +1 -1
  227. package/generated/x402/esm/lib/config.d.ts +3 -3
  228. package/generated/x402/esm/lib/config.js +3 -3
  229. package/generated/x402/esm/lib/config.js.map +1 -1
  230. package/generated/x402/esm/lib/encodings.d.ts +2 -2
  231. package/generated/x402/esm/models/feedback-summary.d.ts +1 -1
  232. package/generated/x402/esm/models/feedback-summary.d.ts.map +1 -1
  233. package/generated/x402/esm/models/feedback-summary.js +1 -1
  234. package/generated/x402/esm/models/feedback-summary.js.map +1 -1
  235. package/generated/x402/esm/sdk/compose-keys.js +12 -12
  236. package/generated/x402/esm/sdk/compose-keys.js.map +1 -1
  237. package/generated/x402/esm/sdk/sdk.d.ts +2 -2
  238. package/generated/x402/esm/sdk/sdk.d.ts.map +1 -1
  239. package/generated/x402/esm/sdk/sdk.js +7 -7
  240. package/generated/x402/esm/sdk/sdk.js.map +1 -1
  241. package/generated/x402/esm/types/async.js +1 -1
  242. package/generated/x402/esm/types/async.js.map +1 -1
  243. package/generated/x402/package.json +1 -1
  244. package/generated/x402/src/funcs/compose-keys-create.ts +1 -1
  245. package/generated/x402/src/funcs/compose-keys-get.ts +1 -1
  246. package/generated/x402/src/funcs/compose-keys-list.ts +1 -1
  247. package/generated/x402/src/funcs/compose-keys-revoke.ts +1 -1
  248. package/generated/x402/src/funcs/compose-keys-session-events-subscribe.ts +1 -1
  249. package/generated/x402/src/funcs/compose-keys-session-get-active.ts +1 -1
  250. package/generated/x402/src/lib/config.ts +3 -3
  251. package/generated/x402/src/models/feedback-summary.ts +2 -2
  252. package/generated/x402/src/sdk/compose-keys.ts +12 -12
  253. package/generated/x402/src/sdk/sdk.ts +3 -3
  254. package/package.json +5 -5
  255. package/dist/tools/index.d.ts +0 -55
  256. package/dist/tools/index.d.ts.map +0 -1
  257. package/dist/tools/index.js +0 -51
  258. 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" | "key" | "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: {
@@ -539,6 +590,7 @@ export interface ResponsesCreateParams extends OpenAIPassthroughParams {
539
590
  model: string;
540
591
  input: unknown;
541
592
  attachments?: AttachmentInput[];
593
+ attachment?: AttachmentInput;
542
594
  modalities?: Array<"text" | "image" | "audio" | "video" | "embedding">;
543
595
  stream?: boolean;
544
596
  instructions?: string;
@@ -598,7 +650,7 @@ export interface ResponseOutputItem {
598
650
  * Events emitted by the Compose agent runtime on /agent/:wallet/stream.
599
651
  * Mirrors the runtime's native SSE vocabulary — no translation, no renaming.
600
652
  */
601
- export type AgentDisplayKind = "tool" | "model" | "connector" | "agent" | "search" | "harness" | "swarm" | "conclave" | "route";
653
+ export type AgentDisplayKind = "tool" | "model" | "connector" | "agent" | "search" | "harness" | "conclave" | "route";
602
654
  export interface AgentEventDisplay {
603
655
  kind: AgentDisplayKind;
604
656
  id?: string;
@@ -607,16 +659,17 @@ export interface AgentEventDisplay {
607
659
  summary?: string;
608
660
  details?: Record<string, unknown>;
609
661
  }
610
- export type PlanDecision = "approved" | "rejected" | "changes_requested";
662
+ export type AgentHarnessPlanDecision = "approved" | "rejected" | "changes_requested";
611
663
  export type AgentArtifactKind = "image" | "audio" | "video" | "embedding" | "realtime" | "file" | "artifact";
612
664
  export interface AgentStreamCreateParams extends AgentStreamControls {
613
665
  agentWallet: string;
614
666
  message: string;
615
667
  threadId: string;
616
668
  userAddress: string;
617
- agentCard?: unknown;
618
669
  cloudPermissions?: unknown;
619
670
  runId?: string;
671
+ agentCard?: DirectoryAgent;
672
+ attachment?: AttachmentInput;
620
673
  attachments?: AttachmentInput[];
621
674
  }
622
675
  export interface AgentStreamFinalResult {
@@ -641,8 +694,7 @@ export interface AgentDecisionInput {
641
694
  runId: string;
642
695
  proposalId: string;
643
696
  version: number;
644
- approvalId?: string;
645
- decision: PlanDecision;
697
+ decision: AgentHarnessPlanDecision;
646
698
  approver?: string;
647
699
  reason?: string;
648
700
  feedback?: string;
@@ -652,7 +704,7 @@ export interface AgentDecisionResult {
652
704
  proposalId?: string;
653
705
  version?: number;
654
706
  state?: string;
655
- decision?: PlanDecision;
707
+ decision?: AgentHarnessPlanDecision;
656
708
  [key: string]: unknown;
657
709
  }
658
710
  export interface WorkflowStreamCreateParams {
@@ -663,6 +715,7 @@ export interface WorkflowStreamCreateParams {
663
715
  runId?: string;
664
716
  continuous?: boolean;
665
717
  lastEventIndex?: number;
718
+ attachment?: AttachmentInput;
666
719
  attachments?: AttachmentInput[];
667
720
  }
668
721
  export interface WorkflowStreamFinalResult {
@@ -679,6 +732,146 @@ export interface WorkflowStreamFinalResult {
679
732
  budget: SessionBudgetSnapshot | null;
680
733
  sessionInvalidReason: SessionInvalidReason | null;
681
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
+ key: {
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
+ keyId: 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
+ keyId: 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
+ }
682
875
  export interface DispenserStatus {
683
876
  chainId: number;
684
877
  chainName: string;
@@ -873,8 +1066,6 @@ export interface ChannelRoute {
873
1066
  channel: ChannelName;
874
1067
  userAddress: string;
875
1068
  agentWallet: string;
876
- scope: "global" | "local";
877
- haiId?: string;
878
1069
  accountId: string;
879
1070
  threadId: string;
880
1071
  label?: string;
@@ -896,8 +1087,6 @@ export interface ChannelGetResponse {
896
1087
  export interface ChannelLinkInput {
897
1088
  userAddress?: string;
898
1089
  agentWallet: string;
899
- scope?: "global" | "local";
900
- haiId?: string;
901
1090
  agentName?: string;
902
1091
  mode?: "user" | "guild";
903
1092
  privacy?: "public" | "private";
@@ -907,8 +1096,6 @@ export interface ChannelLinkResponse {
907
1096
  channel: ChannelName;
908
1097
  userAddress: string;
909
1098
  agentWallet: string;
910
- scope: "global" | "local";
911
- haiId?: string;
912
1099
  agentName?: string;
913
1100
  mode?: "user" | "guild";
914
1101
  privacy?: "public" | "private";
@@ -926,8 +1113,6 @@ export interface ChannelLinkResponse {
926
1113
  export interface ChannelStatusInput {
927
1114
  userAddress?: string;
928
1115
  agentWallet: string;
929
- scope?: "global" | "local";
930
- haiId?: string;
931
1116
  accountId?: string;
932
1117
  threadId?: string;
933
1118
  }
@@ -939,8 +1124,6 @@ export interface ChannelStatusResponse {
939
1124
  export interface ChannelDisconnectInput {
940
1125
  userAddress?: string;
941
1126
  agentWallet: string;
942
- scope?: "global" | "local";
943
- haiId?: string;
944
1127
  accountId?: string;
945
1128
  threadId?: string;
946
1129
  }
@@ -1214,52 +1397,6 @@ export interface SearchResult {
1214
1397
  accessCount?: number;
1215
1398
  createdAt?: number;
1216
1399
  }
1217
- export interface GraphMemoryItem {
1218
- id?: string;
1219
- memory?: string;
1220
- user_id?: string;
1221
- agent_id?: string;
1222
- run_id?: string;
1223
- metadata?: Record<string, unknown>;
1224
- created_at?: string;
1225
- updated_at?: string;
1226
- relations?: Array<Record<string, unknown>>;
1227
- [key: string]: unknown;
1228
- }
1229
- export interface GraphMemoryAddParams extends AgentMemoryScopeInput {
1230
- messages: Array<Partial<AgentMemoryTurnMessage> & Record<string, unknown>>;
1231
- runId?: string;
1232
- enableGraph?: boolean;
1233
- }
1234
- export interface GraphMemorySearchParams extends AgentMemoryScopeInput {
1235
- query: string;
1236
- runId?: string;
1237
- layers?: AgentMemoryLayer[];
1238
- limit?: number;
1239
- rerank?: boolean;
1240
- }
1241
- export interface GraphMemoryListParams {
1242
- userAddress?: string;
1243
- limit?: number;
1244
- }
1245
- export interface VectorMemorySearchParams extends AgentMemoryScopeInput {
1246
- query: string;
1247
- queryEmbedding?: number[];
1248
- limit?: number;
1249
- threshold?: number;
1250
- }
1251
- export interface VectorMemoryIndexParams extends AgentMemoryScopeInput {
1252
- content: string;
1253
- embedding?: number[];
1254
- source: MemorySource;
1255
- }
1256
- export interface VectorMemorySearchResponse {
1257
- results: SearchResult[];
1258
- }
1259
- export interface VectorMemoryIndexResponse {
1260
- success: boolean;
1261
- vectorId?: string;
1262
- }
1263
1400
  export interface MemoryVector {
1264
1401
  vectorId: string;
1265
1402
  id?: string;
@@ -1272,8 +1409,6 @@ export interface MemoryVector {
1272
1409
  threadId?: string;
1273
1410
  scope?: "global" | "local";
1274
1411
  haiId?: string;
1275
- scopeKind?: "global" | "local";
1276
- scopeId?: string;
1277
1412
  decayScore: number;
1278
1413
  accessCount: number;
1279
1414
  createdAt: number;
@@ -1297,60 +1432,6 @@ export interface MemoryItemUpdateParams extends MemoryItemQuery {
1297
1432
  export interface MemoryItemDeleteParams extends MemoryItemQuery {
1298
1433
  hardDelete?: boolean;
1299
1434
  }
1300
- export interface TranscriptStoreParams {
1301
- sessionId: string;
1302
- threadId: string;
1303
- agentWallet: string;
1304
- userAddress?: string;
1305
- scope?: "global" | "local";
1306
- haiId?: string;
1307
- messages: AgentMemoryTurnMessage[];
1308
- tokenCount: number;
1309
- summary?: string;
1310
- summaryEmbedding?: number[];
1311
- metadata?: Record<string, unknown>;
1312
- }
1313
- export interface TranscriptStoreResponse {
1314
- success: boolean;
1315
- }
1316
- export interface TranscriptGetParams {
1317
- type?: "sessionId" | "threadId";
1318
- agentWallet?: string;
1319
- userAddress?: string;
1320
- }
1321
- export interface SessionTranscript {
1322
- sessionId: string;
1323
- threadId: string;
1324
- agentWallet: string;
1325
- userAddress?: string;
1326
- scope?: "global" | "local";
1327
- haiId?: string;
1328
- messages: AgentMemoryTurnMessage[];
1329
- summary?: string;
1330
- tokenCount?: number;
1331
- metadata: Record<string, unknown>;
1332
- createdAt: number;
1333
- expiresAt?: number;
1334
- }
1335
- export interface MemoryRerankParams {
1336
- query: string;
1337
- documents: Array<Record<string, unknown>>;
1338
- topK?: number;
1339
- }
1340
- export interface MemoryRerankResponse {
1341
- results: Array<Record<string, unknown>>;
1342
- }
1343
- export interface MemoryStatsResponse {
1344
- totalVectors: number;
1345
- totalTranscripts: number;
1346
- avgDecayScore: number;
1347
- oldestVector: number;
1348
- newestVector: number;
1349
- byType: Record<string, number>;
1350
- }
1351
- export interface MemoryScheduleQuery {
1352
- agentWallets?: string[];
1353
- }
1354
1435
  export interface MemoryJobCreateParams {
1355
1436
  type: "consolidate" | "patterns_extract" | "archive_create" | "decay_update" | "cleanup";
1356
1437
  execution?: "inline" | "temporal";