@revealui/contracts 1.0.0

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 (191) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +160 -0
  3. package/dist/a2a/index.d.ts +383 -0
  4. package/dist/a2a/index.d.ts.map +1 -0
  5. package/dist/a2a/index.js +276 -0
  6. package/dist/a2a/index.js.map +1 -0
  7. package/dist/actions/action-validator.d.ts +48 -0
  8. package/dist/actions/action-validator.d.ts.map +1 -0
  9. package/dist/actions/action-validator.js +288 -0
  10. package/dist/actions/action-validator.js.map +1 -0
  11. package/dist/actions/index.d.ts +7 -0
  12. package/dist/actions/index.d.ts.map +1 -0
  13. package/dist/actions/index.js +7 -0
  14. package/dist/actions/index.js.map +1 -0
  15. package/dist/agents/index.d.ts +628 -0
  16. package/dist/agents/index.d.ts.map +1 -0
  17. package/dist/agents/index.js +511 -0
  18. package/dist/agents/index.js.map +1 -0
  19. package/dist/agents/types.d.ts +22 -0
  20. package/dist/agents/types.d.ts.map +1 -0
  21. package/dist/agents/types.js +2 -0
  22. package/dist/agents/types.js.map +1 -0
  23. package/dist/api/auth.d.ts +60 -0
  24. package/dist/api/auth.d.ts.map +1 -0
  25. package/dist/api/auth.js +84 -0
  26. package/dist/api/auth.js.map +1 -0
  27. package/dist/api/chat.d.ts +45 -0
  28. package/dist/api/chat.d.ts.map +1 -0
  29. package/dist/api/chat.js +55 -0
  30. package/dist/api/chat.js.map +1 -0
  31. package/dist/api/gdpr.d.ts +39 -0
  32. package/dist/api/gdpr.d.ts.map +1 -0
  33. package/dist/api/gdpr.js +53 -0
  34. package/dist/api/gdpr.js.map +1 -0
  35. package/dist/cms/collection.d.ts +108 -0
  36. package/dist/cms/collection.d.ts.map +1 -0
  37. package/dist/cms/collection.js +144 -0
  38. package/dist/cms/collection.js.map +1 -0
  39. package/dist/cms/compat.d.ts +128 -0
  40. package/dist/cms/compat.d.ts.map +1 -0
  41. package/dist/cms/compat.js +141 -0
  42. package/dist/cms/compat.js.map +1 -0
  43. package/dist/cms/config-contract.d.ts +278 -0
  44. package/dist/cms/config-contract.d.ts.map +1 -0
  45. package/dist/cms/config-contract.js +220 -0
  46. package/dist/cms/config-contract.js.map +1 -0
  47. package/dist/cms/config.d.ts +351 -0
  48. package/dist/cms/config.d.ts.map +1 -0
  49. package/dist/cms/config.js +50 -0
  50. package/dist/cms/config.js.map +1 -0
  51. package/dist/cms/errors.d.ts +122 -0
  52. package/dist/cms/errors.d.ts.map +1 -0
  53. package/dist/cms/errors.js +163 -0
  54. package/dist/cms/errors.js.map +1 -0
  55. package/dist/cms/extensibility.d.ts +211 -0
  56. package/dist/cms/extensibility.d.ts.map +1 -0
  57. package/dist/cms/extensibility.js +313 -0
  58. package/dist/cms/extensibility.js.map +1 -0
  59. package/dist/cms/field.d.ts +69 -0
  60. package/dist/cms/field.d.ts.map +1 -0
  61. package/dist/cms/field.js +94 -0
  62. package/dist/cms/field.js.map +1 -0
  63. package/dist/cms/functions.d.ts +466 -0
  64. package/dist/cms/functions.d.ts.map +1 -0
  65. package/dist/cms/functions.js +19 -0
  66. package/dist/cms/functions.js.map +1 -0
  67. package/dist/cms/global.d.ts +45 -0
  68. package/dist/cms/global.d.ts.map +1 -0
  69. package/dist/cms/global.js +62 -0
  70. package/dist/cms/global.js.map +1 -0
  71. package/dist/cms/index.d.ts +23 -0
  72. package/dist/cms/index.d.ts.map +1 -0
  73. package/dist/cms/index.js +42 -0
  74. package/dist/cms/index.js.map +1 -0
  75. package/dist/cms/structure.d.ts +1601 -0
  76. package/dist/cms/structure.d.ts.map +1 -0
  77. package/dist/cms/structure.js +757 -0
  78. package/dist/cms/structure.js.map +1 -0
  79. package/dist/content/index.d.ts +1542 -0
  80. package/dist/content/index.d.ts.map +1 -0
  81. package/dist/content/index.js +522 -0
  82. package/dist/content/index.js.map +1 -0
  83. package/dist/database/bridge.d.ts +177 -0
  84. package/dist/database/bridge.d.ts.map +1 -0
  85. package/dist/database/bridge.js +139 -0
  86. package/dist/database/bridge.js.map +1 -0
  87. package/dist/database/index.d.ts +8 -0
  88. package/dist/database/index.d.ts.map +1 -0
  89. package/dist/database/index.js +9 -0
  90. package/dist/database/index.js.map +1 -0
  91. package/dist/database/type-bridge.d.ts +178 -0
  92. package/dist/database/type-bridge.d.ts.map +1 -0
  93. package/dist/database/type-bridge.js +154 -0
  94. package/dist/database/type-bridge.js.map +1 -0
  95. package/dist/entities/agent-context.d.ts +280 -0
  96. package/dist/entities/agent-context.d.ts.map +1 -0
  97. package/dist/entities/agent-context.js +390 -0
  98. package/dist/entities/agent-context.js.map +1 -0
  99. package/dist/entities/agent-memory.d.ts +661 -0
  100. package/dist/entities/agent-memory.d.ts.map +1 -0
  101. package/dist/entities/agent-memory.js +544 -0
  102. package/dist/entities/agent-memory.js.map +1 -0
  103. package/dist/entities/board.d.ts +95 -0
  104. package/dist/entities/board.d.ts.map +1 -0
  105. package/dist/entities/board.js +99 -0
  106. package/dist/entities/board.js.map +1 -0
  107. package/dist/entities/code-provenance.d.ts +270 -0
  108. package/dist/entities/code-provenance.d.ts.map +1 -0
  109. package/dist/entities/code-provenance.js +339 -0
  110. package/dist/entities/code-provenance.js.map +1 -0
  111. package/dist/entities/index.d.ts +22 -0
  112. package/dist/entities/index.d.ts.map +1 -0
  113. package/dist/entities/index.js +22 -0
  114. package/dist/entities/index.js.map +1 -0
  115. package/dist/entities/media.d.ts +485 -0
  116. package/dist/entities/media.d.ts.map +1 -0
  117. package/dist/entities/media.js +606 -0
  118. package/dist/entities/media.js.map +1 -0
  119. package/dist/entities/page-revision.d.ts +390 -0
  120. package/dist/entities/page-revision.d.ts.map +1 -0
  121. package/dist/entities/page-revision.js +406 -0
  122. package/dist/entities/page-revision.js.map +1 -0
  123. package/dist/entities/page.d.ts +2349 -0
  124. package/dist/entities/page.d.ts.map +1 -0
  125. package/dist/entities/page.js +377 -0
  126. package/dist/entities/page.js.map +1 -0
  127. package/dist/entities/post.d.ts +619 -0
  128. package/dist/entities/post.d.ts.map +1 -0
  129. package/dist/entities/post.js +555 -0
  130. package/dist/entities/post.js.map +1 -0
  131. package/dist/entities/price.d.ts +772 -0
  132. package/dist/entities/price.d.ts.map +1 -0
  133. package/dist/entities/price.js +308 -0
  134. package/dist/entities/price.js.map +1 -0
  135. package/dist/entities/product.d.ts +753 -0
  136. package/dist/entities/product.d.ts.map +1 -0
  137. package/dist/entities/product.js +307 -0
  138. package/dist/entities/product.js.map +1 -0
  139. package/dist/entities/session.d.ts +222 -0
  140. package/dist/entities/session.d.ts.map +1 -0
  141. package/dist/entities/session.js +253 -0
  142. package/dist/entities/session.js.map +1 -0
  143. package/dist/entities/site.d.ts +387 -0
  144. package/dist/entities/site.d.ts.map +1 -0
  145. package/dist/entities/site.js +348 -0
  146. package/dist/entities/site.js.map +1 -0
  147. package/dist/entities/ticket-comment.d.ts +49 -0
  148. package/dist/entities/ticket-comment.d.ts.map +1 -0
  149. package/dist/entities/ticket-comment.js +58 -0
  150. package/dist/entities/ticket-comment.js.map +1 -0
  151. package/dist/entities/ticket-label.d.ts +64 -0
  152. package/dist/entities/ticket-label.d.ts.map +1 -0
  153. package/dist/entities/ticket-label.js +77 -0
  154. package/dist/entities/ticket-label.js.map +1 -0
  155. package/dist/entities/ticket.d.ts +204 -0
  156. package/dist/entities/ticket.d.ts.map +1 -0
  157. package/dist/entities/ticket.js +205 -0
  158. package/dist/entities/ticket.js.map +1 -0
  159. package/dist/entities/user.d.ts +336 -0
  160. package/dist/entities/user.d.ts.map +1 -0
  161. package/dist/entities/user.js +255 -0
  162. package/dist/entities/user.js.map +1 -0
  163. package/dist/foundation/contract.d.ts +221 -0
  164. package/dist/foundation/contract.d.ts.map +1 -0
  165. package/dist/foundation/contract.js +133 -0
  166. package/dist/foundation/contract.js.map +1 -0
  167. package/dist/foundation/index.d.ts +7 -0
  168. package/dist/foundation/index.d.ts.map +1 -0
  169. package/dist/foundation/index.js +7 -0
  170. package/dist/foundation/index.js.map +1 -0
  171. package/dist/generated/contracts.d.ts +1514 -0
  172. package/dist/generated/contracts.d.ts.map +1 -0
  173. package/dist/generated/contracts.js +959 -0
  174. package/dist/generated/contracts.js.map +1 -0
  175. package/dist/generated/database.d.ts +48 -0
  176. package/dist/generated/database.d.ts.map +1 -0
  177. package/dist/generated/database.js +17 -0
  178. package/dist/generated/database.js.map +1 -0
  179. package/dist/generated/zod-schemas.d.ts +14793 -0
  180. package/dist/generated/zod-schemas.d.ts.map +1 -0
  181. package/dist/generated/zod-schemas.js +547 -0
  182. package/dist/generated/zod-schemas.js.map +1 -0
  183. package/dist/index.d.ts +50 -0
  184. package/dist/index.d.ts.map +1 -0
  185. package/dist/index.js +81 -0
  186. package/dist/index.js.map +1 -0
  187. package/dist/representation/index.d.ts +304 -0
  188. package/dist/representation/index.d.ts.map +1 -0
  189. package/dist/representation/index.js +280 -0
  190. package/dist/representation/index.js.map +1 -0
  191. package/package.json +117 -0
@@ -0,0 +1,628 @@
1
+ /**
2
+ * Agent Schemas
3
+ *
4
+ * Schemas for AI agent context, memory, and collaboration.
5
+ * These enable the "translator" functionality of RevealUI -
6
+ * letting agents reason about and modify the same state humans interact with.
7
+ *
8
+ * IMPORTANT: These schemas define the DATA STRUCTURES for agent interactions.
9
+ * The actual agent runtime is implemented in @revealui/ai package.
10
+ */
11
+ import { z } from 'zod/v4';
12
+ import { type Embedding } from '../representation/index.js';
13
+ export declare const AGENT_SCHEMA_VERSION = 1;
14
+ /**
15
+ * Context shared across agent sessions.
16
+ * Stored in ElectricSQL for CRDT sync.
17
+ */
18
+ export declare const AgentContextSchema: z.ZodObject<{
19
+ id: z.ZodString;
20
+ version: z.ZodDefault<z.ZodNumber>;
21
+ sessionId: z.ZodString;
22
+ agentId: z.ZodString;
23
+ context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
24
+ priority: z.ZodDefault<z.ZodNumber>;
25
+ expiresAt: z.ZodOptional<z.ZodString>;
26
+ createdAt: z.ZodString;
27
+ updatedAt: z.ZodString;
28
+ }, z.core.$strip>;
29
+ export type AgentContext = z.infer<typeof AgentContextSchema>;
30
+ export declare const MemoryTypeSchema: z.ZodEnum<{
31
+ fact: "fact";
32
+ preference: "preference";
33
+ decision: "decision";
34
+ feedback: "feedback";
35
+ example: "example";
36
+ correction: "correction";
37
+ skill: "skill";
38
+ warning: "warning";
39
+ }>;
40
+ export type MemoryType = z.infer<typeof MemoryTypeSchema>;
41
+ export declare const MemorySourceSchema: z.ZodObject<{
42
+ type: z.ZodEnum<{
43
+ agent: "agent";
44
+ external: "external";
45
+ system: "system";
46
+ user: "user";
47
+ }>;
48
+ id: z.ZodString;
49
+ context: z.ZodOptional<z.ZodString>;
50
+ confidence: z.ZodDefault<z.ZodNumber>;
51
+ }, z.core.$strip>;
52
+ export type MemorySource = z.infer<typeof MemorySourceSchema>;
53
+ /**
54
+ * Long-term memory entry for semantic retrieval.
55
+ * Stored in Postgres with pgvector for similarity search.
56
+ */
57
+ export declare const AgentMemorySchema: z.ZodObject<{
58
+ id: z.ZodString;
59
+ version: z.ZodDefault<z.ZodNumber>;
60
+ content: z.ZodString;
61
+ type: z.ZodEnum<{
62
+ fact: "fact";
63
+ preference: "preference";
64
+ decision: "decision";
65
+ feedback: "feedback";
66
+ example: "example";
67
+ correction: "correction";
68
+ skill: "skill";
69
+ warning: "warning";
70
+ }>;
71
+ source: z.ZodObject<{
72
+ type: z.ZodEnum<{
73
+ agent: "agent";
74
+ external: "external";
75
+ system: "system";
76
+ user: "user";
77
+ }>;
78
+ id: z.ZodString;
79
+ context: z.ZodOptional<z.ZodString>;
80
+ confidence: z.ZodDefault<z.ZodNumber>;
81
+ }, z.core.$strip>;
82
+ embedding: z.ZodOptional<z.ZodObject<{
83
+ model: z.ZodString;
84
+ vector: z.ZodArray<z.ZodNumber>;
85
+ dimension: z.ZodNumber;
86
+ generatedAt: z.ZodString;
87
+ }, z.core.$strip>>;
88
+ metadata: z.ZodObject<{
89
+ siteId: z.ZodOptional<z.ZodString>;
90
+ pageId: z.ZodOptional<z.ZodString>;
91
+ blockId: z.ZodOptional<z.ZodString>;
92
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
93
+ importance: z.ZodDefault<z.ZodNumber>;
94
+ expiresAt: z.ZodOptional<z.ZodString>;
95
+ agentId: z.ZodOptional<z.ZodString>;
96
+ sessionId: z.ZodOptional<z.ZodString>;
97
+ custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
98
+ }, z.core.$strip>;
99
+ createdAt: z.ZodString;
100
+ accessedAt: z.ZodString;
101
+ accessCount: z.ZodDefault<z.ZodNumber>;
102
+ verified: z.ZodDefault<z.ZodBoolean>;
103
+ }, z.core.$strip>;
104
+ export type AgentMemory = z.infer<typeof AgentMemorySchema>;
105
+ /**
106
+ * Agent Memory Contract
107
+ *
108
+ * Validates agent memory data with all required fields
109
+ */
110
+ export declare const AgentMemoryContract: import("../index.js").Contract<{
111
+ id: string;
112
+ version: number;
113
+ content: string;
114
+ type: "fact" | "preference" | "decision" | "feedback" | "example" | "correction" | "skill" | "warning";
115
+ source: {
116
+ type: "agent" | "external" | "system" | "user";
117
+ id: string;
118
+ confidence: number;
119
+ context?: string | undefined;
120
+ };
121
+ metadata: {
122
+ importance: number;
123
+ siteId?: string | undefined;
124
+ pageId?: string | undefined;
125
+ blockId?: string | undefined;
126
+ tags?: string[] | undefined;
127
+ expiresAt?: string | undefined;
128
+ agentId?: string | undefined;
129
+ sessionId?: string | undefined;
130
+ custom?: Record<string, unknown> | undefined;
131
+ };
132
+ createdAt: string;
133
+ accessedAt: string;
134
+ accessCount: number;
135
+ verified: boolean;
136
+ embedding?: {
137
+ model: string;
138
+ vector: number[];
139
+ dimension: number;
140
+ generatedAt: string;
141
+ } | undefined;
142
+ }>;
143
+ /**
144
+ * A recorded action taken by an agent
145
+ */
146
+ export declare const AgentActionRecordSchema: z.ZodObject<{
147
+ id: z.ZodString;
148
+ version: z.ZodDefault<z.ZodNumber>;
149
+ agentId: z.ZodString;
150
+ sessionId: z.ZodString;
151
+ action: z.ZodString;
152
+ params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
153
+ result: z.ZodObject<{
154
+ success: z.ZodBoolean;
155
+ data: z.ZodOptional<z.ZodUnknown>;
156
+ error: z.ZodOptional<z.ZodString>;
157
+ errorCode: z.ZodOptional<z.ZodString>;
158
+ }, z.core.$strip>;
159
+ intent: z.ZodOptional<z.ZodObject<{
160
+ raw: z.ZodString;
161
+ classified: z.ZodOptional<z.ZodString>;
162
+ confidence: z.ZodOptional<z.ZodNumber>;
163
+ }, z.core.$strip>>;
164
+ affectedEntities: z.ZodOptional<z.ZodArray<z.ZodObject<{
165
+ type: z.ZodString;
166
+ id: z.ZodString;
167
+ change: z.ZodEnum<{
168
+ deleted: "deleted";
169
+ created: "created";
170
+ updated: "updated";
171
+ }>;
172
+ }, z.core.$strip>>>;
173
+ durationMs: z.ZodNumber;
174
+ timestamp: z.ZodString;
175
+ }, z.core.$strip>;
176
+ export type AgentActionRecord = z.infer<typeof AgentActionRecordSchema>;
177
+ /**
178
+ * A message in an agent conversation
179
+ */
180
+ export declare const ConversationMessageSchema: z.ZodObject<{
181
+ id: z.ZodString;
182
+ role: z.ZodEnum<{
183
+ system: "system";
184
+ user: "user";
185
+ assistant: "assistant";
186
+ tool: "tool";
187
+ }>;
188
+ content: z.ZodString;
189
+ data: z.ZodOptional<z.ZodObject<{
190
+ toolCall: z.ZodOptional<z.ZodObject<{
191
+ name: z.ZodString;
192
+ params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
193
+ }, z.core.$strip>>;
194
+ toolResult: z.ZodOptional<z.ZodObject<{
195
+ name: z.ZodString;
196
+ result: z.ZodUnknown;
197
+ }, z.core.$strip>>;
198
+ attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
199
+ type: z.ZodEnum<{
200
+ link: "link";
201
+ file: "file";
202
+ image: "image";
203
+ }>;
204
+ url: z.ZodString;
205
+ name: z.ZodOptional<z.ZodString>;
206
+ }, z.core.$strip>>>;
207
+ }, z.core.$strip>>;
208
+ metadata: z.ZodOptional<z.ZodObject<{
209
+ tokens: z.ZodOptional<z.ZodNumber>;
210
+ model: z.ZodOptional<z.ZodString>;
211
+ latencyMs: z.ZodOptional<z.ZodNumber>;
212
+ }, z.core.$strip>>;
213
+ timestamp: z.ZodString;
214
+ }, z.core.$strip>;
215
+ export type ConversationMessage = z.infer<typeof ConversationMessageSchema>;
216
+ /**
217
+ * A conversation thread
218
+ */
219
+ export declare const ConversationSchema: z.ZodObject<{
220
+ id: z.ZodString;
221
+ version: z.ZodDefault<z.ZodNumber>;
222
+ sessionId: z.ZodString;
223
+ userId: z.ZodString;
224
+ agentId: z.ZodString;
225
+ messages: z.ZodArray<z.ZodObject<{
226
+ id: z.ZodString;
227
+ role: z.ZodEnum<{
228
+ system: "system";
229
+ user: "user";
230
+ assistant: "assistant";
231
+ tool: "tool";
232
+ }>;
233
+ content: z.ZodString;
234
+ data: z.ZodOptional<z.ZodObject<{
235
+ toolCall: z.ZodOptional<z.ZodObject<{
236
+ name: z.ZodString;
237
+ params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
238
+ }, z.core.$strip>>;
239
+ toolResult: z.ZodOptional<z.ZodObject<{
240
+ name: z.ZodString;
241
+ result: z.ZodUnknown;
242
+ }, z.core.$strip>>;
243
+ attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
244
+ type: z.ZodEnum<{
245
+ link: "link";
246
+ file: "file";
247
+ image: "image";
248
+ }>;
249
+ url: z.ZodString;
250
+ name: z.ZodOptional<z.ZodString>;
251
+ }, z.core.$strip>>>;
252
+ }, z.core.$strip>>;
253
+ metadata: z.ZodOptional<z.ZodObject<{
254
+ tokens: z.ZodOptional<z.ZodNumber>;
255
+ model: z.ZodOptional<z.ZodString>;
256
+ latencyMs: z.ZodOptional<z.ZodNumber>;
257
+ }, z.core.$strip>>;
258
+ timestamp: z.ZodString;
259
+ }, z.core.$strip>>;
260
+ status: z.ZodDefault<z.ZodEnum<{
261
+ error: "error";
262
+ active: "active";
263
+ paused: "paused";
264
+ completed: "completed";
265
+ }>>;
266
+ metadata: z.ZodOptional<z.ZodObject<{
267
+ siteId: z.ZodOptional<z.ZodString>;
268
+ pageId: z.ZodOptional<z.ZodString>;
269
+ topic: z.ZodOptional<z.ZodString>;
270
+ summary: z.ZodOptional<z.ZodString>;
271
+ totalTokens: z.ZodOptional<z.ZodNumber>;
272
+ }, z.core.$strip>>;
273
+ createdAt: z.ZodString;
274
+ updatedAt: z.ZodString;
275
+ }, z.core.$strip>;
276
+ export type Conversation = z.infer<typeof ConversationSchema>;
277
+ /**
278
+ * Intent types that can be classified
279
+ */
280
+ export declare const IntentTypeSchema: z.ZodEnum<{
281
+ unknown: "unknown";
282
+ style: "style";
283
+ publish: "publish";
284
+ edit: "edit";
285
+ delete: "delete";
286
+ create: "create";
287
+ query: "query";
288
+ navigate: "navigate";
289
+ configure: "configure";
290
+ undo: "undo";
291
+ redo: "redo";
292
+ help: "help";
293
+ confirm: "confirm";
294
+ cancel: "cancel";
295
+ }>;
296
+ export type IntentType = z.infer<typeof IntentTypeSchema>;
297
+ /**
298
+ * Classified user intent
299
+ */
300
+ export declare const IntentSchema: z.ZodObject<{
301
+ raw: z.ZodString;
302
+ type: z.ZodEnum<{
303
+ unknown: "unknown";
304
+ style: "style";
305
+ publish: "publish";
306
+ edit: "edit";
307
+ delete: "delete";
308
+ create: "create";
309
+ query: "query";
310
+ navigate: "navigate";
311
+ configure: "configure";
312
+ undo: "undo";
313
+ redo: "redo";
314
+ help: "help";
315
+ confirm: "confirm";
316
+ cancel: "cancel";
317
+ }>;
318
+ action: z.ZodOptional<z.ZodString>;
319
+ entities: z.ZodOptional<z.ZodArray<z.ZodObject<{
320
+ type: z.ZodString;
321
+ value: z.ZodString;
322
+ confidence: z.ZodNumber;
323
+ span: z.ZodOptional<z.ZodObject<{
324
+ start: z.ZodNumber;
325
+ end: z.ZodNumber;
326
+ }, z.core.$strip>>;
327
+ }, z.core.$strip>>>;
328
+ confidence: z.ZodNumber;
329
+ alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
330
+ type: z.ZodEnum<{
331
+ unknown: "unknown";
332
+ style: "style";
333
+ publish: "publish";
334
+ edit: "edit";
335
+ delete: "delete";
336
+ create: "create";
337
+ query: "query";
338
+ navigate: "navigate";
339
+ configure: "configure";
340
+ undo: "undo";
341
+ redo: "redo";
342
+ help: "help";
343
+ confirm: "confirm";
344
+ cancel: "cancel";
345
+ }>;
346
+ action: z.ZodOptional<z.ZodString>;
347
+ confidence: z.ZodNumber;
348
+ }, z.core.$strip>>>;
349
+ requiresConfirmation: z.ZodDefault<z.ZodBoolean>;
350
+ }, z.core.$strip>;
351
+ export type Intent = z.infer<typeof IntentSchema>;
352
+ /**
353
+ * Parameter definition for a tool
354
+ * Note: Uses explicit interface to handle recursive type (items, properties)
355
+ */
356
+ export interface ToolParameter {
357
+ type: 'string' | 'number' | 'boolean' | 'object' | 'array';
358
+ description: string;
359
+ required?: boolean | undefined;
360
+ enum?: string[] | undefined;
361
+ default?: unknown;
362
+ minimum?: number | undefined;
363
+ maximum?: number | undefined;
364
+ pattern?: string | undefined;
365
+ items?: ToolParameter | undefined;
366
+ properties?: Record<string, ToolParameter> | undefined;
367
+ }
368
+ export declare const ToolParameterSchema: z.ZodType<ToolParameter>;
369
+ /**
370
+ * Definition of a tool an agent can use
371
+ */
372
+ export declare const ToolDefinitionSchema: z.ZodObject<{
373
+ name: z.ZodString;
374
+ description: z.ZodString;
375
+ parameters: z.ZodRecord<z.ZodString, z.ZodType<ToolParameter, unknown, z.core.$ZodTypeInternals<ToolParameter, unknown>>>;
376
+ returns: z.ZodOptional<z.ZodObject<{
377
+ type: z.ZodString;
378
+ description: z.ZodString;
379
+ }, z.core.$strip>>;
380
+ examples: z.ZodOptional<z.ZodArray<z.ZodObject<{
381
+ input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
382
+ output: z.ZodUnknown;
383
+ description: z.ZodOptional<z.ZodString>;
384
+ }, z.core.$strip>>>;
385
+ requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
386
+ destructive: z.ZodDefault<z.ZodBoolean>;
387
+ rateLimit: z.ZodOptional<z.ZodNumber>;
388
+ }, z.core.$strip>;
389
+ export type ToolDefinition = z.infer<typeof ToolDefinitionSchema>;
390
+ /**
391
+ * Definition of an AI agent
392
+ */
393
+ export declare const AgentDefinitionSchema: z.ZodObject<{
394
+ id: z.ZodString;
395
+ version: z.ZodDefault<z.ZodNumber>;
396
+ name: z.ZodString;
397
+ description: z.ZodString;
398
+ model: z.ZodString;
399
+ systemPrompt: z.ZodString;
400
+ tools: z.ZodArray<z.ZodObject<{
401
+ name: z.ZodString;
402
+ description: z.ZodString;
403
+ parameters: z.ZodRecord<z.ZodString, z.ZodType<ToolParameter, unknown, z.core.$ZodTypeInternals<ToolParameter, unknown>>>;
404
+ returns: z.ZodOptional<z.ZodObject<{
405
+ type: z.ZodString;
406
+ description: z.ZodString;
407
+ }, z.core.$strip>>;
408
+ examples: z.ZodOptional<z.ZodArray<z.ZodObject<{
409
+ input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
410
+ output: z.ZodUnknown;
411
+ description: z.ZodOptional<z.ZodString>;
412
+ }, z.core.$strip>>>;
413
+ requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
414
+ destructive: z.ZodDefault<z.ZodBoolean>;
415
+ rateLimit: z.ZodOptional<z.ZodNumber>;
416
+ }, z.core.$strip>>;
417
+ capabilities: z.ZodArray<z.ZodString>;
418
+ temperature: z.ZodDefault<z.ZodNumber>;
419
+ maxTokens: z.ZodDefault<z.ZodNumber>;
420
+ canDelegateToAgents: z.ZodOptional<z.ZodArray<z.ZodString>>;
421
+ rateLimits: z.ZodOptional<z.ZodObject<{
422
+ requestsPerMinute: z.ZodOptional<z.ZodNumber>;
423
+ tokensPerMinute: z.ZodOptional<z.ZodNumber>;
424
+ }, z.core.$strip>>;
425
+ }, z.core.$strip>;
426
+ export type AgentDefinition = z.infer<typeof AgentDefinitionSchema>;
427
+ /**
428
+ * Memory item for real-time sync via ElectricSQL
429
+ * Used for working memory and episodic memory sync
430
+ */
431
+ export interface MemoryItem {
432
+ id: string;
433
+ userId: string;
434
+ agentId: string;
435
+ content: string;
436
+ context: Record<string, unknown>;
437
+ importance: number;
438
+ createdAt: Date;
439
+ expiresAt?: Date;
440
+ }
441
+ /**
442
+ * Complete agent state for a session
443
+ */
444
+ export declare const AgentStateSchema: z.ZodObject<{
445
+ agent: z.ZodObject<{
446
+ id: z.ZodString;
447
+ version: z.ZodDefault<z.ZodNumber>;
448
+ name: z.ZodString;
449
+ description: z.ZodString;
450
+ model: z.ZodString;
451
+ systemPrompt: z.ZodString;
452
+ tools: z.ZodArray<z.ZodObject<{
453
+ name: z.ZodString;
454
+ description: z.ZodString;
455
+ parameters: z.ZodRecord<z.ZodString, z.ZodType<ToolParameter, unknown, z.core.$ZodTypeInternals<ToolParameter, unknown>>>;
456
+ returns: z.ZodOptional<z.ZodObject<{
457
+ type: z.ZodString;
458
+ description: z.ZodString;
459
+ }, z.core.$strip>>;
460
+ examples: z.ZodOptional<z.ZodArray<z.ZodObject<{
461
+ input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
462
+ output: z.ZodUnknown;
463
+ description: z.ZodOptional<z.ZodString>;
464
+ }, z.core.$strip>>>;
465
+ requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
466
+ destructive: z.ZodDefault<z.ZodBoolean>;
467
+ rateLimit: z.ZodOptional<z.ZodNumber>;
468
+ }, z.core.$strip>>;
469
+ capabilities: z.ZodArray<z.ZodString>;
470
+ temperature: z.ZodDefault<z.ZodNumber>;
471
+ maxTokens: z.ZodDefault<z.ZodNumber>;
472
+ canDelegateToAgents: z.ZodOptional<z.ZodArray<z.ZodString>>;
473
+ rateLimits: z.ZodOptional<z.ZodObject<{
474
+ requestsPerMinute: z.ZodOptional<z.ZodNumber>;
475
+ tokensPerMinute: z.ZodOptional<z.ZodNumber>;
476
+ }, z.core.$strip>>;
477
+ }, z.core.$strip>;
478
+ context: z.ZodObject<{
479
+ id: z.ZodString;
480
+ version: z.ZodDefault<z.ZodNumber>;
481
+ sessionId: z.ZodString;
482
+ agentId: z.ZodString;
483
+ context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
484
+ priority: z.ZodDefault<z.ZodNumber>;
485
+ expiresAt: z.ZodOptional<z.ZodString>;
486
+ createdAt: z.ZodString;
487
+ updatedAt: z.ZodString;
488
+ }, z.core.$strip>;
489
+ conversation: z.ZodOptional<z.ZodObject<{
490
+ id: z.ZodString;
491
+ version: z.ZodDefault<z.ZodNumber>;
492
+ sessionId: z.ZodString;
493
+ userId: z.ZodString;
494
+ agentId: z.ZodString;
495
+ messages: z.ZodArray<z.ZodObject<{
496
+ id: z.ZodString;
497
+ role: z.ZodEnum<{
498
+ system: "system";
499
+ user: "user";
500
+ assistant: "assistant";
501
+ tool: "tool";
502
+ }>;
503
+ content: z.ZodString;
504
+ data: z.ZodOptional<z.ZodObject<{
505
+ toolCall: z.ZodOptional<z.ZodObject<{
506
+ name: z.ZodString;
507
+ params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
508
+ }, z.core.$strip>>;
509
+ toolResult: z.ZodOptional<z.ZodObject<{
510
+ name: z.ZodString;
511
+ result: z.ZodUnknown;
512
+ }, z.core.$strip>>;
513
+ attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
514
+ type: z.ZodEnum<{
515
+ link: "link";
516
+ file: "file";
517
+ image: "image";
518
+ }>;
519
+ url: z.ZodString;
520
+ name: z.ZodOptional<z.ZodString>;
521
+ }, z.core.$strip>>>;
522
+ }, z.core.$strip>>;
523
+ metadata: z.ZodOptional<z.ZodObject<{
524
+ tokens: z.ZodOptional<z.ZodNumber>;
525
+ model: z.ZodOptional<z.ZodString>;
526
+ latencyMs: z.ZodOptional<z.ZodNumber>;
527
+ }, z.core.$strip>>;
528
+ timestamp: z.ZodString;
529
+ }, z.core.$strip>>;
530
+ status: z.ZodDefault<z.ZodEnum<{
531
+ error: "error";
532
+ active: "active";
533
+ paused: "paused";
534
+ completed: "completed";
535
+ }>>;
536
+ metadata: z.ZodOptional<z.ZodObject<{
537
+ siteId: z.ZodOptional<z.ZodString>;
538
+ pageId: z.ZodOptional<z.ZodString>;
539
+ topic: z.ZodOptional<z.ZodString>;
540
+ summary: z.ZodOptional<z.ZodString>;
541
+ totalTokens: z.ZodOptional<z.ZodNumber>;
542
+ }, z.core.$strip>>;
543
+ createdAt: z.ZodString;
544
+ updatedAt: z.ZodString;
545
+ }, z.core.$strip>>;
546
+ recentMemories: z.ZodOptional<z.ZodArray<z.ZodObject<{
547
+ id: z.ZodString;
548
+ version: z.ZodDefault<z.ZodNumber>;
549
+ content: z.ZodString;
550
+ type: z.ZodEnum<{
551
+ fact: "fact";
552
+ preference: "preference";
553
+ decision: "decision";
554
+ feedback: "feedback";
555
+ example: "example";
556
+ correction: "correction";
557
+ skill: "skill";
558
+ warning: "warning";
559
+ }>;
560
+ source: z.ZodObject<{
561
+ type: z.ZodEnum<{
562
+ agent: "agent";
563
+ external: "external";
564
+ system: "system";
565
+ user: "user";
566
+ }>;
567
+ id: z.ZodString;
568
+ context: z.ZodOptional<z.ZodString>;
569
+ confidence: z.ZodDefault<z.ZodNumber>;
570
+ }, z.core.$strip>;
571
+ embedding: z.ZodOptional<z.ZodObject<{
572
+ model: z.ZodString;
573
+ vector: z.ZodArray<z.ZodNumber>;
574
+ dimension: z.ZodNumber;
575
+ generatedAt: z.ZodString;
576
+ }, z.core.$strip>>;
577
+ metadata: z.ZodObject<{
578
+ siteId: z.ZodOptional<z.ZodString>;
579
+ pageId: z.ZodOptional<z.ZodString>;
580
+ blockId: z.ZodOptional<z.ZodString>;
581
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
582
+ importance: z.ZodDefault<z.ZodNumber>;
583
+ expiresAt: z.ZodOptional<z.ZodString>;
584
+ agentId: z.ZodOptional<z.ZodString>;
585
+ sessionId: z.ZodOptional<z.ZodString>;
586
+ custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
587
+ }, z.core.$strip>;
588
+ createdAt: z.ZodString;
589
+ accessedAt: z.ZodString;
590
+ accessCount: z.ZodDefault<z.ZodNumber>;
591
+ verified: z.ZodDefault<z.ZodBoolean>;
592
+ }, z.core.$strip>>>;
593
+ focus: z.ZodOptional<z.ZodObject<{
594
+ siteId: z.ZodOptional<z.ZodString>;
595
+ pageId: z.ZodOptional<z.ZodString>;
596
+ blockId: z.ZodOptional<z.ZodString>;
597
+ selection: z.ZodOptional<z.ZodArray<z.ZodString>>;
598
+ }, z.core.$strip>>;
599
+ currentTask: z.ZodOptional<z.ZodObject<{
600
+ id: z.ZodString;
601
+ description: z.ZodString;
602
+ status: z.ZodEnum<{
603
+ pending: "pending";
604
+ completed: "completed";
605
+ running: "running";
606
+ failed: "failed";
607
+ }>;
608
+ progress: z.ZodOptional<z.ZodNumber>;
609
+ }, z.core.$strip>>;
610
+ }, z.core.$strip>;
611
+ export type AgentState = z.infer<typeof AgentStateSchema>;
612
+ /**
613
+ * Creates a new agent context
614
+ */
615
+ export declare function createAgentContext(sessionId: string, agentId: string, context?: Record<string, unknown>): AgentContext;
616
+ /**
617
+ * Creates a new agent memory
618
+ */
619
+ export declare function createAgentMemory(id: string, content: string, type: MemoryType, source: MemorySource, metadata?: AgentMemory['metadata'], embedding?: Embedding): AgentMemory;
620
+ /**
621
+ * Creates a new conversation
622
+ */
623
+ export declare function createConversation(id: string, sessionId: string, userId: string, agentId: string, metadata?: Conversation['metadata']): Conversation;
624
+ /**
625
+ * Creates a conversation message
626
+ */
627
+ export declare function createMessage(id: string, role: ConversationMessage['role'], content: string, data?: ConversationMessage['data']): ConversationMessage;
628
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"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"}