@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,511 @@
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 { createContract } from '../foundation/contract.js';
13
+ import { EmbeddingSchema } from '../representation/index.js';
14
+ // =============================================================================
15
+ // Schema Versions
16
+ // =============================================================================
17
+ export const AGENT_SCHEMA_VERSION = 1;
18
+ // =============================================================================
19
+ // Agent Context
20
+ // =============================================================================
21
+ /**
22
+ * Context shared across agent sessions.
23
+ * Stored in ElectricSQL for CRDT sync.
24
+ */
25
+ export const AgentContextSchema = z.object({
26
+ /** Unique context ID (sessionId:agentId) */
27
+ id: z.string(),
28
+ /** Schema version */
29
+ version: z.number().int().default(AGENT_SCHEMA_VERSION),
30
+ /** Session this context belongs to */
31
+ sessionId: z.string(),
32
+ /** Agent that owns this context */
33
+ agentId: z.string(),
34
+ /** The context data (JSONB) - structured for the specific agent */
35
+ context: z.record(z.string(), z.unknown()),
36
+ /** Context priority (higher = more important) */
37
+ priority: z.number().min(0).max(1).default(0.5),
38
+ /** When this context expires (for temporary context) */
39
+ expiresAt: z.string().datetime().optional(),
40
+ /** When this context was created */
41
+ createdAt: z.string().datetime(),
42
+ /** When this context was last updated */
43
+ updatedAt: z.string().datetime(),
44
+ });
45
+ // =============================================================================
46
+ // Memory Type
47
+ // =============================================================================
48
+ export const MemoryTypeSchema = z.enum([
49
+ 'fact', // A learned fact
50
+ 'preference', // User preference
51
+ 'decision', // A decision that was made
52
+ 'feedback', // User feedback
53
+ 'example', // An example to learn from
54
+ 'correction', // A correction to previous behavior
55
+ 'skill', // A learned skill or pattern
56
+ 'warning', // Something to avoid
57
+ ]);
58
+ // =============================================================================
59
+ // Memory Source
60
+ // =============================================================================
61
+ export const MemorySourceSchema = z.object({
62
+ /** Where this memory came from */
63
+ type: z.enum(['user', 'agent', 'system', 'external']),
64
+ /** ID of the source (user ID, agent ID, etc.) */
65
+ id: z.string(),
66
+ /** Context in which it was created */
67
+ context: z.string().optional(),
68
+ /** Confidence in this source (0-1) */
69
+ confidence: z.number().min(0).max(1).default(1),
70
+ });
71
+ // =============================================================================
72
+ // Agent Memory
73
+ // =============================================================================
74
+ /**
75
+ * Long-term memory entry for semantic retrieval.
76
+ * Stored in Postgres with pgvector for similarity search.
77
+ */
78
+ export const AgentMemorySchema = z.object({
79
+ /** Memory ID */
80
+ id: z.string(),
81
+ /** Schema version */
82
+ version: z.number().int().default(AGENT_SCHEMA_VERSION),
83
+ /** The content of this memory */
84
+ content: z.string().min(1).max(10000),
85
+ /** Memory type for categorization */
86
+ type: MemoryTypeSchema,
87
+ /** Source of this memory */
88
+ source: MemorySourceSchema,
89
+ /** Embedding for semantic search - PROPERLY VALIDATED */
90
+ embedding: EmbeddingSchema.optional(),
91
+ /** Metadata for filtering/retrieval */
92
+ metadata: z.object({
93
+ /** Related site ID */
94
+ siteId: z.string().optional(),
95
+ /** Related page ID */
96
+ pageId: z.string().optional(),
97
+ /** Related block ID */
98
+ blockId: z.string().optional(),
99
+ /** Tags for categorization */
100
+ tags: z.array(z.string()).optional(),
101
+ /** Importance score (0-1) */
102
+ importance: z.number().min(0).max(1).default(0.5),
103
+ /** Expiration time (for temporary memories) */
104
+ expiresAt: z.string().datetime().optional(),
105
+ /** Agent ID for filtering memories by agent */
106
+ agentId: z.string().optional(),
107
+ /** Session ID for associating memories with specific sessions */
108
+ sessionId: z.string().optional(),
109
+ /** Custom metadata */
110
+ custom: z.record(z.string(), z.unknown()).optional(),
111
+ }),
112
+ /** Creation timestamp */
113
+ createdAt: z.string().datetime(),
114
+ /** Last access timestamp (for relevance decay) */
115
+ accessedAt: z.string().datetime(),
116
+ /** Access count (for popularity) */
117
+ accessCount: z.number().int().default(0),
118
+ /** Whether this memory has been verified by a human */
119
+ verified: z.boolean().default(false),
120
+ });
121
+ /**
122
+ * Agent Memory Contract
123
+ *
124
+ * Validates agent memory data with all required fields
125
+ */
126
+ export const AgentMemoryContract = createContract({
127
+ name: 'AgentMemory',
128
+ version: '1',
129
+ description: 'Validates agent memory data',
130
+ schema: AgentMemorySchema,
131
+ });
132
+ // =============================================================================
133
+ // Agent Action Record
134
+ // =============================================================================
135
+ /**
136
+ * A recorded action taken by an agent
137
+ */
138
+ export const AgentActionRecordSchema = z.object({
139
+ /** Action ID */
140
+ id: z.string(),
141
+ /** Schema version */
142
+ version: z.number().int().default(AGENT_SCHEMA_VERSION),
143
+ /** Agent that took this action */
144
+ agentId: z.string(),
145
+ /** Session in which action was taken */
146
+ sessionId: z.string(),
147
+ /** Type of action */
148
+ action: z.string(),
149
+ /** Parameters passed to the action */
150
+ params: z.record(z.string(), z.unknown()),
151
+ /** Result of the action */
152
+ result: z.object({
153
+ success: z.boolean(),
154
+ data: z.unknown().optional(),
155
+ error: z.string().optional(),
156
+ errorCode: z.string().optional(),
157
+ }),
158
+ /** Human intent that triggered this action */
159
+ intent: z
160
+ .object({
161
+ raw: z.string(),
162
+ classified: z.string().optional(),
163
+ confidence: z.number().min(0).max(1).optional(),
164
+ })
165
+ .optional(),
166
+ /** Affected entities */
167
+ affectedEntities: z
168
+ .array(z.object({
169
+ type: z.string(),
170
+ id: z.string(),
171
+ change: z.enum(['created', 'updated', 'deleted']),
172
+ }))
173
+ .optional(),
174
+ /** Duration in milliseconds */
175
+ durationMs: z.number().int().nonnegative(),
176
+ /** Timestamp */
177
+ timestamp: z.string().datetime(),
178
+ });
179
+ // =============================================================================
180
+ // Conversation Message
181
+ // =============================================================================
182
+ /**
183
+ * A message in an agent conversation
184
+ */
185
+ export const ConversationMessageSchema = z.object({
186
+ /** Message ID */
187
+ id: z.string(),
188
+ /** Role of the sender */
189
+ role: z.enum(['user', 'assistant', 'system', 'tool']),
190
+ /** Message content */
191
+ content: z.string(),
192
+ /** Structured data (for tool calls, etc.) */
193
+ data: z
194
+ .object({
195
+ toolCall: z
196
+ .object({
197
+ name: z.string(),
198
+ params: z.record(z.string(), z.unknown()),
199
+ })
200
+ .optional(),
201
+ toolResult: z
202
+ .object({
203
+ name: z.string(),
204
+ result: z.unknown(),
205
+ })
206
+ .optional(),
207
+ attachments: z
208
+ .array(z.object({
209
+ type: z.enum(['image', 'file', 'link']),
210
+ url: z.string(),
211
+ name: z.string().optional(),
212
+ }))
213
+ .optional(),
214
+ })
215
+ .optional(),
216
+ /** Message metadata */
217
+ metadata: z
218
+ .object({
219
+ tokens: z.number().int().optional(),
220
+ model: z.string().optional(),
221
+ latencyMs: z.number().int().optional(),
222
+ })
223
+ .optional(),
224
+ /** Timestamp */
225
+ timestamp: z.string().datetime(),
226
+ });
227
+ // =============================================================================
228
+ // Conversation
229
+ // =============================================================================
230
+ /**
231
+ * A conversation thread
232
+ */
233
+ export const ConversationSchema = z.object({
234
+ /** Conversation ID */
235
+ id: z.string(),
236
+ /** Schema version */
237
+ version: z.number().int().default(AGENT_SCHEMA_VERSION),
238
+ /** Session this conversation belongs to */
239
+ sessionId: z.string(),
240
+ /** User involved in this conversation */
241
+ userId: z.string(),
242
+ /** Agent involved in this conversation */
243
+ agentId: z.string(),
244
+ /** Messages in order */
245
+ messages: z.array(ConversationMessageSchema),
246
+ /** Conversation status */
247
+ status: z.enum(['active', 'paused', 'completed', 'error']).default('active'),
248
+ /** Conversation metadata */
249
+ metadata: z
250
+ .object({
251
+ /** Related site */
252
+ siteId: z.string().optional(),
253
+ /** Related page */
254
+ pageId: z.string().optional(),
255
+ /** Topic/purpose of conversation */
256
+ topic: z.string().optional(),
257
+ /** Summary of conversation */
258
+ summary: z.string().optional(),
259
+ /** Total tokens used */
260
+ totalTokens: z.number().int().optional(),
261
+ })
262
+ .optional(),
263
+ /** Timestamps */
264
+ createdAt: z.string().datetime(),
265
+ updatedAt: z.string().datetime(),
266
+ });
267
+ // =============================================================================
268
+ // Intent Classification
269
+ // =============================================================================
270
+ /**
271
+ * Intent types that can be classified
272
+ */
273
+ export const IntentTypeSchema = z.enum([
274
+ 'create', // Create something new
275
+ 'edit', // Modify existing
276
+ 'delete', // Remove something
277
+ 'query', // Ask a question
278
+ 'navigate', // Go somewhere
279
+ 'style', // Change appearance
280
+ 'configure', // Change settings
281
+ 'publish', // Make public
282
+ 'undo', // Revert action
283
+ 'redo', // Redo action
284
+ 'help', // Get assistance
285
+ 'confirm', // Confirm an action
286
+ 'cancel', // Cancel an action
287
+ 'unknown', // Could not classify
288
+ ]);
289
+ /**
290
+ * Classified user intent
291
+ */
292
+ export const IntentSchema = z.object({
293
+ /** Raw input from user */
294
+ raw: z.string(),
295
+ /** Classified intent type */
296
+ type: IntentTypeSchema,
297
+ /** Specific action within the type */
298
+ action: z.string().optional(),
299
+ /** Extracted entities */
300
+ entities: z
301
+ .array(z.object({
302
+ type: z.string(),
303
+ value: z.string(),
304
+ confidence: z.number().min(0).max(1),
305
+ span: z
306
+ .object({
307
+ start: z.number().int(),
308
+ end: z.number().int(),
309
+ })
310
+ .optional(),
311
+ }))
312
+ .optional(),
313
+ /** Overall confidence score */
314
+ confidence: z.number().min(0).max(1),
315
+ /** Alternative interpretations */
316
+ alternatives: z
317
+ .array(z.object({
318
+ type: IntentTypeSchema,
319
+ action: z.string().optional(),
320
+ confidence: z.number().min(0).max(1),
321
+ }))
322
+ .optional(),
323
+ /** Whether this requires confirmation */
324
+ requiresConfirmation: z.boolean().default(false),
325
+ });
326
+ export const ToolParameterSchema = z.object({
327
+ type: z.enum(['string', 'number', 'boolean', 'object', 'array']),
328
+ description: z.string(),
329
+ required: z.boolean().optional(),
330
+ enum: z.array(z.string()).optional(),
331
+ default: z.unknown().optional(),
332
+ minimum: z.number().optional(),
333
+ maximum: z.number().optional(),
334
+ pattern: z.string().optional(),
335
+ items: z.lazy(() => ToolParameterSchema).optional(),
336
+ properties: z
337
+ .lazy(() => z.record(z.string(), ToolParameterSchema))
338
+ .optional(),
339
+ });
340
+ /**
341
+ * Definition of a tool an agent can use
342
+ */
343
+ export const ToolDefinitionSchema = z.object({
344
+ /** Tool name */
345
+ name: z.string().regex(/^[a-z][a-zA-Z0-9_]*$/),
346
+ /** Human-readable description */
347
+ description: z.string().min(10).max(500),
348
+ /** Parameter schema */
349
+ parameters: z.record(z.string(), ToolParameterSchema),
350
+ /** Return type description */
351
+ returns: z
352
+ .object({
353
+ type: z.string(),
354
+ description: z.string(),
355
+ })
356
+ .optional(),
357
+ /** Usage examples */
358
+ examples: z
359
+ .array(z.object({
360
+ input: z.record(z.string(), z.unknown()),
361
+ output: z.unknown(),
362
+ description: z.string().optional(),
363
+ }))
364
+ .optional(),
365
+ /** Required capabilities */
366
+ requiredCapabilities: z.array(z.string()).optional(),
367
+ /** Whether this tool is destructive */
368
+ destructive: z.boolean().default(false),
369
+ /** Rate limit (calls per minute) */
370
+ rateLimit: z.number().int().positive().optional(),
371
+ });
372
+ // =============================================================================
373
+ // Agent Definition
374
+ // =============================================================================
375
+ /**
376
+ * Definition of an AI agent
377
+ */
378
+ export const AgentDefinitionSchema = z.object({
379
+ /** Agent ID */
380
+ id: z.string(),
381
+ /** Schema version */
382
+ version: z.number().int().default(AGENT_SCHEMA_VERSION),
383
+ /** Agent name */
384
+ name: z.string(),
385
+ /** Agent description */
386
+ description: z.string(),
387
+ /** AI model to use */
388
+ model: z.string(),
389
+ /** System prompt */
390
+ systemPrompt: z.string(),
391
+ /** Available tools */
392
+ tools: z.array(ToolDefinitionSchema),
393
+ /** Agent capabilities */
394
+ capabilities: z.array(z.string()),
395
+ /** Temperature for generation */
396
+ temperature: z.number().min(0).max(2).default(0.7),
397
+ /** Max tokens per response */
398
+ maxTokens: z.number().int().positive().default(4096),
399
+ /** Whether this agent can call other agents */
400
+ canDelegateToAgents: z.array(z.string()).optional(),
401
+ /** Rate limits */
402
+ rateLimits: z
403
+ .object({
404
+ requestsPerMinute: z.number().int().positive().optional(),
405
+ tokensPerMinute: z.number().int().positive().optional(),
406
+ })
407
+ .optional(),
408
+ });
409
+ // =============================================================================
410
+ // Agent State
411
+ // =============================================================================
412
+ /**
413
+ * Complete agent state for a session
414
+ */
415
+ export const AgentStateSchema = z.object({
416
+ /** Agent definition */
417
+ agent: AgentDefinitionSchema,
418
+ /** Current context */
419
+ context: AgentContextSchema,
420
+ /** Current conversation */
421
+ conversation: ConversationSchema.optional(),
422
+ /** Recent memories (for context window) */
423
+ recentMemories: z.array(AgentMemorySchema).optional(),
424
+ /** Active entities being worked on */
425
+ focus: z
426
+ .object({
427
+ siteId: z.string().optional(),
428
+ pageId: z.string().optional(),
429
+ blockId: z.string().optional(),
430
+ selection: z.array(z.string()).optional(),
431
+ })
432
+ .optional(),
433
+ /** Current task (if any) */
434
+ currentTask: z
435
+ .object({
436
+ id: z.string(),
437
+ description: z.string(),
438
+ status: z.enum(['pending', 'running', 'completed', 'failed']),
439
+ progress: z.number().min(0).max(1).optional(),
440
+ })
441
+ .optional(),
442
+ });
443
+ // =============================================================================
444
+ // Factory Functions
445
+ // =============================================================================
446
+ /**
447
+ * Creates a new agent context
448
+ */
449
+ export function createAgentContext(sessionId, agentId, context = {}) {
450
+ const now = new Date().toISOString();
451
+ return {
452
+ id: `${sessionId}:${agentId}`,
453
+ version: AGENT_SCHEMA_VERSION,
454
+ sessionId,
455
+ agentId,
456
+ context,
457
+ priority: 0.5,
458
+ createdAt: now,
459
+ updatedAt: now,
460
+ };
461
+ }
462
+ /**
463
+ * Creates a new agent memory
464
+ */
465
+ export function createAgentMemory(id, content, type, source, metadata, embedding) {
466
+ const now = new Date().toISOString();
467
+ return {
468
+ id,
469
+ version: AGENT_SCHEMA_VERSION,
470
+ content,
471
+ type,
472
+ source,
473
+ embedding,
474
+ metadata: metadata || { importance: 0.5 },
475
+ createdAt: now,
476
+ accessedAt: now,
477
+ accessCount: 0,
478
+ verified: false,
479
+ };
480
+ }
481
+ /**
482
+ * Creates a new conversation
483
+ */
484
+ export function createConversation(id, sessionId, userId, agentId, metadata) {
485
+ const now = new Date().toISOString();
486
+ return {
487
+ id,
488
+ version: AGENT_SCHEMA_VERSION,
489
+ sessionId,
490
+ userId,
491
+ agentId,
492
+ messages: [],
493
+ status: 'active',
494
+ metadata,
495
+ createdAt: now,
496
+ updatedAt: now,
497
+ };
498
+ }
499
+ /**
500
+ * Creates a conversation message
501
+ */
502
+ export function createMessage(id, role, content, data) {
503
+ return {
504
+ id,
505
+ role,
506
+ content,
507
+ data,
508
+ timestamp: new Date().toISOString(),
509
+ };
510
+ }
511
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ export type AgentMode = 'plan' | 'debug' | 'execute';
2
+ export interface AgentRequest {
3
+ id: string;
4
+ mode: AgentMode;
5
+ input: string;
6
+ context?: string[];
7
+ capabilities?: string[];
8
+ messages?: Array<{
9
+ role: string;
10
+ content: string;
11
+ }>;
12
+ }
13
+ export interface AgentResponse {
14
+ output: string;
15
+ traces?: AgentTrace[];
16
+ }
17
+ export interface AgentTrace {
18
+ step: string;
19
+ provider: string;
20
+ latencyMs: number;
21
+ }
22
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;AAEpD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,60 @@
1
+ /**
2
+ * Authentication API Contracts
3
+ *
4
+ * Validation contracts for authentication endpoints
5
+ */
6
+ import { z } from 'zod/v4';
7
+ /**
8
+ * Sign-up request validation
9
+ *
10
+ * Validates user registration data with:
11
+ * - Email format validation and sanitization
12
+ * - Password strength requirements (min 8 chars)
13
+ * - Name validation and sanitization
14
+ */
15
+ export declare const SignUpRequestSchema: z.ZodObject<{
16
+ email: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
17
+ password: z.ZodString;
18
+ name: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
19
+ }, z.core.$strip>;
20
+ export type SignUpRequest = z.infer<typeof SignUpRequestSchema>;
21
+ export declare const SignUpRequestContract: import("../index.js").Contract<{
22
+ email: string;
23
+ password: string;
24
+ name: string;
25
+ }>;
26
+ /**
27
+ * Sign-in request validation
28
+ */
29
+ export declare const SignInRequestSchema: z.ZodObject<{
30
+ email: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
31
+ password: z.ZodString;
32
+ }, z.core.$strip>;
33
+ export type SignInRequest = z.infer<typeof SignInRequestSchema>;
34
+ export declare const SignInRequestContract: import("../index.js").Contract<{
35
+ email: string;
36
+ password: string;
37
+ }>;
38
+ /**
39
+ * Password reset request validation
40
+ */
41
+ export declare const PasswordResetRequestSchema: z.ZodObject<{
42
+ email: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
43
+ }, z.core.$strip>;
44
+ export type PasswordResetRequest = z.infer<typeof PasswordResetRequestSchema>;
45
+ export declare const PasswordResetRequestContract: import("../index.js").Contract<{
46
+ email: string;
47
+ }>;
48
+ /**
49
+ * Password reset with token validation
50
+ */
51
+ export declare const PasswordResetTokenSchema: z.ZodObject<{
52
+ token: z.ZodString;
53
+ password: z.ZodString;
54
+ }, z.core.$strip>;
55
+ export type PasswordResetToken = z.infer<typeof PasswordResetTokenSchema>;
56
+ export declare const PasswordResetTokenContract: import("../index.js").Contract<{
57
+ token: string;
58
+ password: string;
59
+ }>;
60
+ //# sourceMappingURL=auth.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/api/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAG1B;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;iBAiB9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,qBAAqB;;;;EAKhC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;iBAO9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,qBAAqB;;;EAKhC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B;;iBAMrC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAE7E,eAAO,MAAM,4BAA4B;;EAKvC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEzE,eAAO,MAAM,0BAA0B;;;EAKrC,CAAA"}