@illalabs/interfaces 0.2.1 → 0.3.0-canary-dev-c9b759da

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 (134) hide show
  1. package/dist/errors/endpoints/chat/ChatBaseError.d.ts +16 -5
  2. package/dist/errors/endpoints/chat/ChatBaseError.d.ts.map +1 -1
  3. package/dist/external.d.ts +1 -0
  4. package/dist/external.d.ts.map +1 -1
  5. package/dist/external.js +1 -0
  6. package/dist/external.js.map +1 -1
  7. package/dist/interfaces/chat/response.d.ts +5 -3
  8. package/dist/interfaces/chat/response.d.ts.map +1 -1
  9. package/dist/schemas/chatContext.d.ts +93 -590
  10. package/dist/schemas/chatContext.d.ts.map +1 -1
  11. package/dist/schemas/chatRequestBody.d.ts +290 -1960
  12. package/dist/schemas/chatRequestBody.d.ts.map +1 -1
  13. package/dist/schemas/chatRequestBody.js +6 -4
  14. package/dist/schemas/chatRequestBody.js.map +1 -1
  15. package/dist/schemas/executionCheckerQueryParams.d.ts +5 -5
  16. package/dist/schemas/illaTools.d.ts +266 -0
  17. package/dist/schemas/illaTools.d.ts.map +1 -0
  18. package/dist/schemas/illaTools.js +58 -0
  19. package/dist/schemas/illaTools.js.map +1 -0
  20. package/dist/schemas/index.d.ts +3 -0
  21. package/dist/schemas/index.d.ts.map +1 -1
  22. package/dist/schemas/index.js +3 -0
  23. package/dist/schemas/index.js.map +1 -1
  24. package/dist/schemas/messages.d.ts +566 -928
  25. package/dist/schemas/messages.d.ts.map +1 -1
  26. package/dist/schemas/messages.js +74 -113
  27. package/dist/schemas/messages.js.map +1 -1
  28. package/dist/schemas/modelContext.d.ts +23 -0
  29. package/dist/schemas/modelContext.d.ts.map +1 -0
  30. package/dist/schemas/modelContext.js +13 -0
  31. package/dist/schemas/modelContext.js.map +1 -0
  32. package/dist/schemas/telemetryEvents.d.ts +2417 -0
  33. package/dist/schemas/telemetryEvents.d.ts.map +1 -0
  34. package/dist/schemas/telemetryEvents.js +236 -0
  35. package/dist/schemas/telemetryEvents.js.map +1 -0
  36. package/dist/schemas/toolAutorouter.d.ts +6 -6
  37. package/dist/schemas/userContext.d.ts +3 -0
  38. package/dist/schemas/userContext.d.ts.map +1 -1
  39. package/dist/schemas/userContext.js +4 -0
  40. package/dist/schemas/userContext.js.map +1 -1
  41. package/dist/tools/IllaToolError.d.ts +117 -0
  42. package/dist/tools/IllaToolError.d.ts.map +1 -0
  43. package/dist/tools/IllaToolError.js +147 -0
  44. package/dist/tools/IllaToolError.js.map +1 -0
  45. package/dist/tools/IllaToolOutcome.d.ts +131 -0
  46. package/dist/tools/IllaToolOutcome.d.ts.map +1 -0
  47. package/dist/tools/IllaToolOutcome.js +191 -0
  48. package/dist/tools/IllaToolOutcome.js.map +1 -0
  49. package/dist/tools/index.d.ts +3 -0
  50. package/dist/tools/index.d.ts.map +1 -0
  51. package/dist/tools/index.js +3 -0
  52. package/dist/tools/index.js.map +1 -0
  53. package/dist/types/actions/inputs.d.ts +8 -3
  54. package/dist/types/actions/inputs.d.ts.map +1 -1
  55. package/dist/types/actions/outputs.d.ts +19 -1
  56. package/dist/types/actions/outputs.d.ts.map +1 -1
  57. package/dist/types/actions/tools/{swapBridgeAction.d.ts → bridgeAction.d.ts} +4 -4
  58. package/dist/types/actions/tools/bridgeAction.d.ts.map +1 -0
  59. package/dist/types/actions/tools/bridgeAction.js +2 -0
  60. package/dist/types/actions/tools/bridgeAction.js.map +1 -0
  61. package/dist/types/actions/tools/defiFetchListingsAction.d.ts +1 -2
  62. package/dist/types/actions/tools/defiFetchListingsAction.d.ts.map +1 -1
  63. package/dist/types/actions/tools/defiFetchListingsAction.js +1 -1
  64. package/dist/types/actions/tools/defiFetchListingsAction.js.map +1 -1
  65. package/dist/types/actions/tools/defiPositionsAction.d.ts +1 -2
  66. package/dist/types/actions/tools/defiPositionsAction.d.ts.map +1 -1
  67. package/dist/types/actions/tools/defiPositionsAction.js +1 -1
  68. package/dist/types/actions/tools/defiPositionsAction.js.map +1 -1
  69. package/dist/types/actions/tools/defiSupplyAction.d.ts +1 -2
  70. package/dist/types/actions/tools/defiSupplyAction.d.ts.map +1 -1
  71. package/dist/types/actions/tools/defiSupplyAction.js +1 -1
  72. package/dist/types/actions/tools/defiSupplyAction.js.map +1 -1
  73. package/dist/types/actions/tools/defiWithdrawAction.d.ts +1 -2
  74. package/dist/types/actions/tools/defiWithdrawAction.d.ts.map +1 -1
  75. package/dist/types/actions/tools/defiWithdrawAction.js +1 -1
  76. package/dist/types/actions/tools/defiWithdrawAction.js.map +1 -1
  77. package/dist/types/actions/tools/exchangeRateAction.d.ts +1 -2
  78. package/dist/types/actions/tools/exchangeRateAction.d.ts.map +1 -1
  79. package/dist/types/actions/tools/exchangeRateAction.js +1 -1
  80. package/dist/types/actions/tools/exchangeRateAction.js.map +1 -1
  81. package/dist/types/actions/tools/getWalletBalanceAction.d.ts +4 -3
  82. package/dist/types/actions/tools/getWalletBalanceAction.d.ts.map +1 -1
  83. package/dist/types/actions/tools/getWalletBalanceAction.js +1 -1
  84. package/dist/types/actions/tools/getWalletBalanceAction.js.map +1 -1
  85. package/dist/types/actions/tools/index.d.ts +18 -3
  86. package/dist/types/actions/tools/index.d.ts.map +1 -1
  87. package/dist/types/actions/tools/polymarketPostOrderAction.d.ts +81 -0
  88. package/dist/types/actions/tools/polymarketPostOrderAction.d.ts.map +1 -0
  89. package/dist/types/actions/tools/polymarketPostOrderAction.js +2 -0
  90. package/dist/types/actions/tools/polymarketPostOrderAction.js.map +1 -0
  91. package/dist/types/actions/tools/predictionMarketsBetAction.d.ts +19 -0
  92. package/dist/types/actions/tools/predictionMarketsBetAction.d.ts.map +1 -0
  93. package/dist/types/actions/tools/predictionMarketsBetAction.js +2 -0
  94. package/dist/types/actions/tools/predictionMarketsBetAction.js.map +1 -0
  95. package/dist/types/actions/tools/predictionMarketsFetchAction.d.ts +21 -0
  96. package/dist/types/actions/tools/predictionMarketsFetchAction.d.ts.map +1 -0
  97. package/dist/types/actions/tools/predictionMarketsFetchAction.js +2 -0
  98. package/dist/types/actions/tools/predictionMarketsFetchAction.js.map +1 -0
  99. package/dist/types/actions/tools/predictionMarketsPositionsAction.d.ts +25 -0
  100. package/dist/types/actions/tools/predictionMarketsPositionsAction.d.ts.map +1 -0
  101. package/dist/types/actions/tools/predictionMarketsPositionsAction.js +2 -0
  102. package/dist/types/actions/tools/predictionMarketsPositionsAction.js.map +1 -0
  103. package/dist/types/actions/tools/swapAction.d.ts +16 -0
  104. package/dist/types/actions/tools/swapAction.d.ts.map +1 -0
  105. package/dist/types/actions/tools/swapAction.js +2 -0
  106. package/dist/types/actions/tools/swapAction.js.map +1 -0
  107. package/dist/types/actions/tools/tokenTransferAction.d.ts +1 -2
  108. package/dist/types/actions/tools/tokenTransferAction.d.ts.map +1 -1
  109. package/dist/types/actions/tools/tokenTransferAction.js +1 -1
  110. package/dist/types/actions/tools/tokenTransferAction.js.map +1 -1
  111. package/dist/types/index.d.ts +2 -0
  112. package/dist/types/index.d.ts.map +1 -1
  113. package/dist/types/index.js +2 -0
  114. package/dist/types/index.js.map +1 -1
  115. package/dist/types/messages.d.ts +3 -6
  116. package/dist/types/messages.d.ts.map +1 -1
  117. package/dist/types/messages.js +1 -1
  118. package/dist/types/messages.js.map +1 -1
  119. package/dist/types/streaming.d.ts +81 -0
  120. package/dist/types/streaming.d.ts.map +1 -0
  121. package/dist/types/streaming.js +2 -0
  122. package/dist/types/streaming.js.map +1 -0
  123. package/dist/types/telemetry.d.ts +139 -0
  124. package/dist/types/telemetry.d.ts.map +1 -0
  125. package/dist/types/telemetry.js +7 -0
  126. package/dist/types/telemetry.js.map +1 -0
  127. package/dist/utils/constants.d.ts +7 -5
  128. package/dist/utils/constants.d.ts.map +1 -1
  129. package/dist/utils/constants.js +22 -4
  130. package/dist/utils/constants.js.map +1 -1
  131. package/package.json +4 -4
  132. package/dist/types/actions/tools/swapBridgeAction.d.ts.map +0 -1
  133. package/dist/types/actions/tools/swapBridgeAction.js +0 -2
  134. package/dist/types/actions/tools/swapBridgeAction.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telemetryEvents.d.ts","sourceRoot":"","sources":["../../src/schemas/telemetryEvents.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,236 @@
1
+ import { z } from "zod";
2
+ import { IllaToolErrorSchema } from "./illaTools.js";
3
+ import { PendingToolCallSchema } from "./messages.js";
4
+ /**
5
+ * Telemetry event type enum values.
6
+ * Used to infer TelemetryEventType in types/telemetry.ts
7
+ */
8
+ export const telemetryEventTypes = [
9
+ "iteration_start",
10
+ "iteration_end",
11
+ "tool_call_batch",
12
+ "tool_result",
13
+ "scratchpad_reset",
14
+ "llm_start",
15
+ "llm_end",
16
+ "text_delta",
17
+ "finish",
18
+ "error",
19
+ "connected",
20
+ "stream_end",
21
+ ];
22
+ /**
23
+ * Base telemetry event schema with common fields
24
+ */
25
+ export const baseTelemetryEventSchema = z.object({
26
+ requestId: z.string(),
27
+ type: z.enum(telemetryEventTypes),
28
+ timestamp: z.number().optional(),
29
+ });
30
+ /**
31
+ * Connected event schema - emitted when connected to telemetry stream
32
+ */
33
+ export const connectedEventSchema = baseTelemetryEventSchema.extend({
34
+ type: z.literal("connected"),
35
+ });
36
+ /**
37
+ * Stream end telemetry event schema - emitted when stream ends
38
+ */
39
+ export const streamEndTelemetryEventSchema = baseTelemetryEventSchema.extend({
40
+ type: z.literal("stream_end"),
41
+ });
42
+ /**
43
+ * Iteration start event schema - emitted when an iteration starts
44
+ */
45
+ export const iterationStartEventSchema = baseTelemetryEventSchema.extend({
46
+ type: z.literal("iteration_start"),
47
+ data: z.object({
48
+ iteration: z.number(),
49
+ }),
50
+ });
51
+ /**
52
+ * Iteration end event schema - emitted when an iteration ends
53
+ */
54
+ export const iterationEndEventSchema = baseTelemetryEventSchema.extend({
55
+ type: z.literal("iteration_end"),
56
+ data: z.object({
57
+ iteration: z.number(),
58
+ hasToolCalls: z.boolean(),
59
+ shouldContinue: z.boolean(),
60
+ }),
61
+ });
62
+ /**
63
+ * Tool call batch event schema - emitted when tool calls are batched for execution
64
+ */
65
+ export const toolCallBatchEventSchema = baseTelemetryEventSchema.extend({
66
+ type: z.literal("tool_call_batch"),
67
+ data: z.object({
68
+ iteration: z.number(),
69
+ tools: z.array(z.object({
70
+ toolCallId: z.string(),
71
+ toolName: z.string(),
72
+ })),
73
+ }),
74
+ });
75
+ /**
76
+ * Tool result event schema - emitted when a tool execution completes
77
+ */
78
+ export const toolResultEventSchema = baseTelemetryEventSchema.extend({
79
+ type: z.literal("tool_result"),
80
+ data: z.discriminatedUnion("status", [
81
+ z.object({
82
+ toolCallId: z.string(),
83
+ toolName: z.string(),
84
+ status: z.literal("pending"),
85
+ }),
86
+ z.object({
87
+ toolCallId: z.string(),
88
+ toolName: z.string(),
89
+ status: z.literal("success"),
90
+ }),
91
+ z.object({
92
+ toolCallId: z.string(),
93
+ toolName: z.string(),
94
+ status: z.literal("failure"),
95
+ error: z.string(),
96
+ }),
97
+ ]),
98
+ });
99
+ /**
100
+ * Scratchpad reset event schema - emitted when the scratchpad is reset
101
+ */
102
+ export const scratchpadResetEventSchema = baseTelemetryEventSchema.extend({
103
+ type: z.literal("scratchpad_reset"),
104
+ data: z.object({
105
+ reason: z.string(),
106
+ }),
107
+ });
108
+ /**
109
+ * LLM start event schema - emitted when LLM generation starts
110
+ */
111
+ export const llmStartEventSchema = baseTelemetryEventSchema.extend({
112
+ type: z.literal("llm_start"),
113
+ data: z.object({
114
+ iteration: z.number(),
115
+ }),
116
+ });
117
+ /**
118
+ * LLM end event schema - emitted when LLM generation ends
119
+ */
120
+ export const llmEndEventSchema = baseTelemetryEventSchema.extend({
121
+ type: z.literal("llm_end"),
122
+ data: z.object({
123
+ iteration: z.number(),
124
+ hasText: z.boolean(),
125
+ toolCallCount: z.number(),
126
+ }),
127
+ });
128
+ /**
129
+ * Text delta event schema - emitted when a text chunk is received from LLM
130
+ */
131
+ export const textDeltaEventSchema = baseTelemetryEventSchema.extend({
132
+ type: z.literal("text_delta"),
133
+ data: z.object({
134
+ delta: z.string(),
135
+ }),
136
+ });
137
+ /**
138
+ * Finish event schema - emitted when orchestration finishes
139
+ */
140
+ export const finishEventSchema = baseTelemetryEventSchema.extend({
141
+ type: z.literal("finish"),
142
+ data: z.object({
143
+ totalIterations: z.number(),
144
+ hasPendingTools: z.boolean(),
145
+ hasToolErrors: z.boolean(),
146
+ }),
147
+ });
148
+ /**
149
+ * Error telemetry event schema - emitted when an error occurs.
150
+ * The data field is always present per the ErrorEvent type definition.
151
+ */
152
+ export const errorTelemetryEventSchema = baseTelemetryEventSchema.extend({
153
+ type: z.literal("error"),
154
+ data: z.object({
155
+ message: z.string(),
156
+ code: z.string().optional(),
157
+ }),
158
+ });
159
+ /**
160
+ * Schema for validating telemetry events.
161
+ * Discriminated union using the "type" field.
162
+ */
163
+ export const telemetryEventSchema = z.discriminatedUnion("type", [
164
+ connectedEventSchema,
165
+ streamEndTelemetryEventSchema,
166
+ iterationStartEventSchema,
167
+ iterationEndEventSchema,
168
+ toolCallBatchEventSchema,
169
+ toolResultEventSchema,
170
+ scratchpadResetEventSchema,
171
+ llmStartEventSchema,
172
+ llmEndEventSchema,
173
+ textDeltaEventSchema,
174
+ finishEventSchema,
175
+ errorTelemetryEventSchema,
176
+ ]);
177
+ /**
178
+ * Message schema for result events.
179
+ * Uses z.custom<ModelMessage>() to ensure type compatibility with the AI SDK's
180
+ * ModelMessage type. Runtime validation of the message structure happens at the
181
+ * API layer; this schema trusts the structure and preserves the correct TypeScript type.
182
+ */
183
+ const messageSchema = z.custom();
184
+ /**
185
+ * Incomplete tool call schema for result events
186
+ */
187
+ const incompleteToolCallSchema = z.object({
188
+ toolCallId: z.string(),
189
+ toolName: z.string(),
190
+ toolInput: z.unknown().optional(),
191
+ });
192
+ /**
193
+ * Schema for validating result events from the streaming endpoint.
194
+ * Uses type: "result" as discriminator for consistency with other event schemas.
195
+ * Also includes status: 200 for backward compatibility with CoreApiChatSuccessResponse.
196
+ */
197
+ export const resultEventDataSchema = z.object({
198
+ type: z.literal("result"),
199
+ status: z.literal(200),
200
+ messages: z.array(messageSchema),
201
+ text: z.string(),
202
+ pendingTools: z.array(PendingToolCallSchema).optional(),
203
+ incompleteTools: z.array(incompleteToolCallSchema).optional(),
204
+ toolErrors: z.array(IllaToolErrorSchema).optional(),
205
+ requestId: z.string(),
206
+ });
207
+ /**
208
+ * Schema for validating error events from the streaming endpoint
209
+ */
210
+ export const errorEventDataSchema = z.object({
211
+ type: z.literal("error"),
212
+ requestId: z.string(),
213
+ timestamp: z.number().optional(),
214
+ data: z.object({
215
+ message: z.string(),
216
+ code: z.string().optional(),
217
+ }),
218
+ });
219
+ /**
220
+ * Schema for validating stream_end events from the streaming endpoint
221
+ */
222
+ export const streamEndEventDataSchema = z.object({
223
+ type: z.literal("stream_end"),
224
+ requestId: z.string(),
225
+ timestamp: z.number().optional(),
226
+ });
227
+ /**
228
+ * Unified discriminated union for all stream event data types.
229
+ * Uses "type" as the discriminator field for runtime validation.
230
+ */
231
+ export const streamEventDataSchema = z.discriminatedUnion("type", [
232
+ resultEventDataSchema,
233
+ errorEventDataSchema,
234
+ streamEndEventDataSchema,
235
+ ]);
236
+ //# sourceMappingURL=telemetryEvents.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telemetryEvents.js","sourceRoot":"","sources":["../../src/schemas/telemetryEvents.ts"],"names":[],"mappings":"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"}
@@ -53,7 +53,6 @@ export declare const AutoRouterConfigSchema: z.ZodObject<{
53
53
  }>]>>;
54
54
  swapOrBridge: z.ZodOptional<z.ZodEnum<["lifi"]>>;
55
55
  }, "strict", z.ZodTypeAny, {
56
- swapOrBridge?: "lifi" | undefined;
57
56
  defi?: {
58
57
  lending: "aave";
59
58
  supply?: undefined;
@@ -63,8 +62,8 @@ export declare const AutoRouterConfigSchema: z.ZodObject<{
63
62
  withdraw: "aave";
64
63
  lending?: undefined;
65
64
  } | undefined;
66
- }, {
67
65
  swapOrBridge?: "lifi" | undefined;
66
+ }, {
68
67
  defi?: {
69
68
  lending: "aave";
70
69
  supply?: undefined;
@@ -74,6 +73,7 @@ export declare const AutoRouterConfigSchema: z.ZodObject<{
74
73
  withdraw: "aave";
75
74
  lending?: undefined;
76
75
  } | undefined;
76
+ swapOrBridge?: "lifi" | undefined;
77
77
  }>;
78
78
  export declare const ToolAutorouterSchema: z.ZodObject<{
79
79
  autoRouter: z.ZodOptional<z.ZodObject<{
@@ -104,7 +104,6 @@ export declare const ToolAutorouterSchema: z.ZodObject<{
104
104
  }>]>>;
105
105
  swapOrBridge: z.ZodOptional<z.ZodEnum<["lifi"]>>;
106
106
  }, "strict", z.ZodTypeAny, {
107
- swapOrBridge?: "lifi" | undefined;
108
107
  defi?: {
109
108
  lending: "aave";
110
109
  supply?: undefined;
@@ -114,8 +113,8 @@ export declare const ToolAutorouterSchema: z.ZodObject<{
114
113
  withdraw: "aave";
115
114
  lending?: undefined;
116
115
  } | undefined;
117
- }, {
118
116
  swapOrBridge?: "lifi" | undefined;
117
+ }, {
119
118
  defi?: {
120
119
  lending: "aave";
121
120
  supply?: undefined;
@@ -125,10 +124,10 @@ export declare const ToolAutorouterSchema: z.ZodObject<{
125
124
  withdraw: "aave";
126
125
  lending?: undefined;
127
126
  } | undefined;
127
+ swapOrBridge?: "lifi" | undefined;
128
128
  }>>;
129
129
  }, "strict", z.ZodTypeAny, {
130
130
  autoRouter?: {
131
- swapOrBridge?: "lifi" | undefined;
132
131
  defi?: {
133
132
  lending: "aave";
134
133
  supply?: undefined;
@@ -138,10 +137,10 @@ export declare const ToolAutorouterSchema: z.ZodObject<{
138
137
  withdraw: "aave";
139
138
  lending?: undefined;
140
139
  } | undefined;
140
+ swapOrBridge?: "lifi" | undefined;
141
141
  } | undefined;
142
142
  }, {
143
143
  autoRouter?: {
144
- swapOrBridge?: "lifi" | undefined;
145
144
  defi?: {
146
145
  lending: "aave";
147
146
  supply?: undefined;
@@ -151,6 +150,7 @@ export declare const ToolAutorouterSchema: z.ZodObject<{
151
150
  withdraw: "aave";
152
151
  lending?: undefined;
153
152
  } | undefined;
153
+ swapOrBridge?: "lifi" | undefined;
154
154
  } | undefined;
155
155
  }>;
156
156
  //# sourceMappingURL=toolAutorouter.d.ts.map
@@ -2,10 +2,13 @@ import type { TypeOf } from "zod";
2
2
  import { z } from "zod";
3
3
  export declare const UserContextSchema: z.ZodObject<{
4
4
  address: z.ZodEffects<z.ZodString, `0x${string}`, string>;
5
+ signerWallet: z.ZodOptional<z.ZodEffects<z.ZodString, `0x${string}`, string>>;
5
6
  }, "strict", z.ZodTypeAny, {
6
7
  address: `0x${string}`;
8
+ signerWallet?: `0x${string}` | undefined;
7
9
  }, {
8
10
  address: string;
11
+ signerWallet?: string | undefined;
9
12
  }>;
10
13
  export type UserContext = TypeOf<typeof UserContextSchema>;
11
14
  //# sourceMappingURL=userContext.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"userContext.d.ts","sourceRoot":"","sources":["../../src/schemas/userContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;EAIjB,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
1
+ {"version":3,"file":"userContext.d.ts","sourceRoot":"","sources":["../../src/schemas/userContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;EAQjB,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
@@ -3,6 +3,10 @@ import { z } from "zod";
3
3
  export const UserContextSchema = z
4
4
  .object({
5
5
  address: z.string().refine(isAddress, { message: "Invalid address" }),
6
+ signerWallet: z
7
+ .string()
8
+ .refine(isAddress, { message: "Invalid signer wallet address" })
9
+ .optional(),
6
10
  })
7
11
  .strict();
8
12
  //# sourceMappingURL=userContext.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"userContext.js","sourceRoot":"","sources":["../../src/schemas/userContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC7B,MAAM,CAAC;IACJ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;CACxE,CAAC;KACD,MAAM,EAAE,CAAC"}
1
+ {"version":3,"file":"userContext.js","sourceRoot":"","sources":["../../src/schemas/userContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC7B,MAAM,CAAC;IACJ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;IACrE,YAAY,EAAE,CAAC;SACV,MAAM,EAAE;SACR,MAAM,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;SAC/D,QAAQ,EAAE;CAClB,CAAC;KACD,MAAM,EAAE,CAAC"}
@@ -0,0 +1,117 @@
1
+ import type { IllaToolErrorData, IllaToolExecutionErrorData, IllaToolInputErrorData } from "../internal.js";
2
+ /**
3
+ * Represents an error that occurred during tool call validation or execution.
4
+ * This is a structured error class that distinguishes between input validation
5
+ * errors and execution errors.
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * // Create an input validation error
10
+ * const inputError = IllaToolError.input('call-123', 'tokenTransfer', [
11
+ * { path: 'amount', message: 'Amount is required' }
12
+ * ]);
13
+ *
14
+ * // Create an execution error
15
+ * const execError = IllaToolError.execution('call-123', 'tokenTransfer', 'Network timeout');
16
+ * ```
17
+ */
18
+ export declare class IllaToolError {
19
+ readonly id: string;
20
+ readonly name: string;
21
+ readonly data: IllaToolErrorData;
22
+ /**
23
+ * Creates a new IllaToolError instance
24
+ * @param id - The tool call ID this error is associated with
25
+ * @param name - The name of the tool/action that errored
26
+ * @param data - The structured error data
27
+ */
28
+ private constructor();
29
+ /**
30
+ * The type of error ("input" or "execution")
31
+ */
32
+ get type(): "input" | "execution";
33
+ /**
34
+ * Creates an input validation error
35
+ * @param id - The tool call ID
36
+ * @param name - The tool/action name
37
+ * @param errors - Array of validation errors with path and message
38
+ * @returns A new IllaToolError representing input validation failure
39
+ */
40
+ static input(id: string, name: string, errors: Array<{
41
+ path: string;
42
+ message: string;
43
+ }>): IllaToolError;
44
+ /**
45
+ * Creates an execution error
46
+ * @param id - The tool call ID
47
+ * @param name - The tool/action name
48
+ * @param message - Human-readable error message
49
+ * @param details - Optional additional error details
50
+ * @returns A new IllaToolError representing execution failure
51
+ */
52
+ static execution(id: string, name: string, message: string, details?: unknown): IllaToolError;
53
+ /**
54
+ * Parses and validates unknown input to create an IllaToolError instance.
55
+ * Expects an object with id, name, and data properties.
56
+ *
57
+ * @param input - Unknown input to parse
58
+ * @returns A new IllaToolError instance
59
+ * @throws ZodError if the input doesn't match the expected schema
60
+ *
61
+ * @example
62
+ * ```ts
63
+ * const error = IllaToolError.parse({
64
+ * id: 'call-123',
65
+ * name: 'tokenTransfer',
66
+ * data: { type: 'execution', message: 'Failed' }
67
+ * });
68
+ * ```
69
+ */
70
+ static parse(input: unknown): IllaToolError;
71
+ /**
72
+ * Parses error data and creates an IllaToolError with the provided id and name.
73
+ * Useful when reconstructing from IllaToolOutcome where id/name are separate.
74
+ *
75
+ * @param id - The tool call ID
76
+ * @param name - The tool/action name
77
+ * @param data - Unknown error data to parse
78
+ * @returns A new IllaToolError instance
79
+ * @throws ZodError if the data doesn't match the expected schema
80
+ */
81
+ static parseData(id: string, name: string, data: unknown): IllaToolError;
82
+ /**
83
+ * Check if this is an input validation error
84
+ */
85
+ isInputError(): this is IllaToolError & {
86
+ data: IllaToolInputErrorData;
87
+ };
88
+ /**
89
+ * Check if this is an execution error
90
+ */
91
+ isExecutionError(): this is IllaToolError & {
92
+ data: IllaToolExecutionErrorData;
93
+ };
94
+ /**
95
+ * Get the validation errors if this is an input error
96
+ * @returns Array of validation errors or undefined if not an input error
97
+ */
98
+ getValidationErrors(): Array<{
99
+ path: string;
100
+ message: string;
101
+ }> | undefined;
102
+ /**
103
+ * Get the error message
104
+ * @returns The error message (for execution errors) or a summary of validation errors
105
+ */
106
+ getMessage(): string;
107
+ /**
108
+ * Convert to a plain JSON object for serialization
109
+ * @returns The full error object
110
+ */
111
+ toJSON(): {
112
+ id: string;
113
+ name: string;
114
+ data: IllaToolErrorData;
115
+ };
116
+ }
117
+ //# sourceMappingURL=IllaToolError.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IllaToolError.d.ts","sourceRoot":"","sources":["../../src/tools/IllaToolError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,iBAAiB,EACjB,0BAA0B,EAC1B,sBAAsB,EACzB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAa;aAQF,EAAE,EAAE,MAAM;aACV,IAAI,EAAE,MAAM;aACZ,IAAI,EAAE,iBAAiB;IAT3C;;;;;OAKG;IACH,OAAO;IAMP;;OAEG;IACH,IAAW,IAAI,IAAI,OAAO,GAAG,WAAW,CAEvC;IAED;;;;;;OAMG;WACW,KAAK,CACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GACjD,aAAa;IAOhB;;;;;;;OAOG;WACW,SAAS,CACnB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,GAClB,aAAa;IAQhB;;;;;;;;;;;;;;;;OAgBG;WACW,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;IAKlD;;;;;;;;;OASG;WACW,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,aAAa;IAK/E;;OAEG;IACI,YAAY,IAAI,IAAI,IAAI,aAAa,GAAG;QAAE,IAAI,EAAE,sBAAsB,CAAA;KAAE;IAI/E;;OAEG;IACI,gBAAgB,IAAI,IAAI,IAAI,aAAa,GAAG;QAAE,IAAI,EAAE,0BAA0B,CAAA;KAAE;IAIvF;;;OAGG;IACI,mBAAmB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS;IAOlF;;;OAGG;IACI,UAAU,IAAI,MAAM;IAQ3B;;;OAGG;IACI,MAAM,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,iBAAiB,CAAA;KAAE;CAOzE"}
@@ -0,0 +1,147 @@
1
+ import { IllaToolErrorDataSchema, IllaToolErrorSchema } from "../internal.js";
2
+ /**
3
+ * Represents an error that occurred during tool call validation or execution.
4
+ * This is a structured error class that distinguishes between input validation
5
+ * errors and execution errors.
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * // Create an input validation error
10
+ * const inputError = IllaToolError.input('call-123', 'tokenTransfer', [
11
+ * { path: 'amount', message: 'Amount is required' }
12
+ * ]);
13
+ *
14
+ * // Create an execution error
15
+ * const execError = IllaToolError.execution('call-123', 'tokenTransfer', 'Network timeout');
16
+ * ```
17
+ */
18
+ export class IllaToolError {
19
+ id;
20
+ name;
21
+ data;
22
+ /**
23
+ * Creates a new IllaToolError instance
24
+ * @param id - The tool call ID this error is associated with
25
+ * @param name - The name of the tool/action that errored
26
+ * @param data - The structured error data
27
+ */
28
+ constructor(id, name, data) {
29
+ this.id = id;
30
+ this.name = name;
31
+ this.data = data;
32
+ }
33
+ /**
34
+ * The type of error ("input" or "execution")
35
+ */
36
+ get type() {
37
+ return this.data.type;
38
+ }
39
+ /**
40
+ * Creates an input validation error
41
+ * @param id - The tool call ID
42
+ * @param name - The tool/action name
43
+ * @param errors - Array of validation errors with path and message
44
+ * @returns A new IllaToolError representing input validation failure
45
+ */
46
+ static input(id, name, errors) {
47
+ return new IllaToolError(id, name, {
48
+ type: "input",
49
+ errors,
50
+ });
51
+ }
52
+ /**
53
+ * Creates an execution error
54
+ * @param id - The tool call ID
55
+ * @param name - The tool/action name
56
+ * @param message - Human-readable error message
57
+ * @param details - Optional additional error details
58
+ * @returns A new IllaToolError representing execution failure
59
+ */
60
+ static execution(id, name, message, details) {
61
+ return new IllaToolError(id, name, {
62
+ type: "execution",
63
+ message,
64
+ details,
65
+ });
66
+ }
67
+ /**
68
+ * Parses and validates unknown input to create an IllaToolError instance.
69
+ * Expects an object with id, name, and data properties.
70
+ *
71
+ * @param input - Unknown input to parse
72
+ * @returns A new IllaToolError instance
73
+ * @throws ZodError if the input doesn't match the expected schema
74
+ *
75
+ * @example
76
+ * ```ts
77
+ * const error = IllaToolError.parse({
78
+ * id: 'call-123',
79
+ * name: 'tokenTransfer',
80
+ * data: { type: 'execution', message: 'Failed' }
81
+ * });
82
+ * ```
83
+ */
84
+ static parse(input) {
85
+ const parsed = IllaToolErrorSchema.parse(input);
86
+ return new IllaToolError(parsed.id, parsed.name, parsed.data);
87
+ }
88
+ /**
89
+ * Parses error data and creates an IllaToolError with the provided id and name.
90
+ * Useful when reconstructing from IllaToolOutcome where id/name are separate.
91
+ *
92
+ * @param id - The tool call ID
93
+ * @param name - The tool/action name
94
+ * @param data - Unknown error data to parse
95
+ * @returns A new IllaToolError instance
96
+ * @throws ZodError if the data doesn't match the expected schema
97
+ */
98
+ static parseData(id, name, data) {
99
+ const parsedData = IllaToolErrorDataSchema.parse(data);
100
+ return new IllaToolError(id, name, parsedData);
101
+ }
102
+ /**
103
+ * Check if this is an input validation error
104
+ */
105
+ isInputError() {
106
+ return this.data.type === "input";
107
+ }
108
+ /**
109
+ * Check if this is an execution error
110
+ */
111
+ isExecutionError() {
112
+ return this.data.type === "execution";
113
+ }
114
+ /**
115
+ * Get the validation errors if this is an input error
116
+ * @returns Array of validation errors or undefined if not an input error
117
+ */
118
+ getValidationErrors() {
119
+ if (this.isInputError()) {
120
+ return this.data.errors;
121
+ }
122
+ return undefined;
123
+ }
124
+ /**
125
+ * Get the error message
126
+ * @returns The error message (for execution errors) or a summary of validation errors
127
+ */
128
+ getMessage() {
129
+ if (this.data.type === "execution") {
130
+ return this.data.message;
131
+ }
132
+ const errors = this.data.errors;
133
+ return errors.map((error) => `${error.path}: ${error.message}`).join(", ");
134
+ }
135
+ /**
136
+ * Convert to a plain JSON object for serialization
137
+ * @returns The full error object
138
+ */
139
+ toJSON() {
140
+ return {
141
+ id: this.id,
142
+ name: this.name,
143
+ data: this.data,
144
+ };
145
+ }
146
+ }
147
+ //# sourceMappingURL=IllaToolError.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IllaToolError.js","sourceRoot":"","sources":["../../src/tools/IllaToolError.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,aAAa;IAQF;IACA;IACA;IATpB;;;;;OAKG;IACH,YACoB,EAAU,EACV,IAAY,EACZ,IAAuB;QAFvB,OAAE,GAAF,EAAE,CAAQ;QACV,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAmB;IACxC,CAAC;IAEJ;;OAEG;IACH,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CACf,EAAU,EACV,IAAY,EACZ,MAAgD;QAEhD,OAAO,IAAI,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE;YAC/B,IAAI,EAAE,OAAO;YACb,MAAM;SACT,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,SAAS,CACnB,EAAU,EACV,IAAY,EACZ,OAAe,EACf,OAAiB;QAEjB,OAAO,IAAI,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE;YAC/B,IAAI,EAAE,WAAW;YACjB,OAAO;YACP,OAAO;SACV,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,MAAM,CAAC,KAAK,CAAC,KAAc;QAC9B,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,SAAS,CAAC,EAAU,EAAE,IAAY,EAAE,IAAa;QAC3D,MAAM,UAAU,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,IAAI,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACI,YAAY;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,gBAAgB;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACI,mBAAmB;QACtB,IAAI,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;;OAGG;IACI,UAAU;QACb,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAC7B,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAChC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,CAAC;IAED;;;OAGG;IACI,MAAM;QACT,OAAO;YACH,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;SAClB,CAAC;IACN,CAAC;CACJ"}