@almadar/agent 2.0.0 → 2.0.1

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 (100) hide show
  1. package/dist/agent/event-budget.d.ts +28 -0
  2. package/dist/agent/experimental/hitl-v2.d.ts +161 -0
  3. package/dist/agent/experimental/hitl-workflow-integration.d.ts +182 -0
  4. package/dist/agent/index.d.ts +14 -0
  5. package/dist/agent/index.js.map +1 -1
  6. package/dist/agent/interrupt-config.d.ts +51 -0
  7. package/dist/agent/session-manager.d.ts +204 -0
  8. package/dist/agent/skill-agent.d.ts +182 -0
  9. package/dist/agent/workflow-middleware.d.ts +63 -0
  10. package/dist/agent/workflow-tool-wrapper.d.ts +87 -0
  11. package/dist/api-types.d.ts +595 -0
  12. package/dist/context/compaction.d.ts +191 -0
  13. package/dist/context-compaction.d.ts +55 -0
  14. package/dist/evals/online-sampling.d.ts +114 -0
  15. package/dist/evals/utils/compact-orbital.d.ts +100 -0
  16. package/dist/event-transformer/event-transformer.d.ts +120 -0
  17. package/dist/event-transformer/index.d.ts +7 -0
  18. package/dist/events.d.ts +85 -0
  19. package/dist/index.d.ts +59 -0
  20. package/dist/index.js.map +1 -1
  21. package/dist/memory/MemoryManager.d.ts +243 -0
  22. package/dist/memory/PreferenceLearner.d.ts +59 -0
  23. package/dist/memory/agentic-search.d.ts +116 -0
  24. package/dist/memory/index.d.ts +14 -0
  25. package/dist/memory/memory-orbital.d.ts +66 -0
  26. package/dist/memory/types.d.ts +143 -0
  27. package/dist/metrics.d.ts +77 -0
  28. package/dist/multi-user.d.ts +155 -0
  29. package/dist/observability/index.d.ts +14 -0
  30. package/dist/observability/langsmith-integration.d.ts +203 -0
  31. package/dist/observability.d.ts +196 -0
  32. package/dist/orbitals/archive/sanitize.d.ts +24 -0
  33. package/dist/orbitals/batch/batch-generator.d.ts +41 -0
  34. package/dist/orbitals/batch/concurrency.d.ts +54 -0
  35. package/dist/orbitals/batch/index.d.ts +14 -0
  36. package/dist/orbitals/batch/prompt-assembler.d.ts +92 -0
  37. package/dist/orbitals/batch/types.d.ts +103 -0
  38. package/dist/orbitals/cache/index.d.ts +11 -0
  39. package/dist/orbitals/cache/orbital-fingerprint.d.ts +37 -0
  40. package/dist/orbitals/cache/prompt-assembler.d.ts +65 -0
  41. package/dist/orbitals/cache/structural-templates.d.ts +33 -0
  42. package/dist/orbitals/combiner/index.d.ts +102 -0
  43. package/dist/orbitals/domain-language/index.d.ts +9 -0
  44. package/dist/orbitals/domain-language/prompts/index.d.ts +11 -0
  45. package/dist/orbitals/domain-language/prompts/odl-examples.d.ts +8 -0
  46. package/dist/orbitals/domain-language/prompts/odl-patterns.d.ts +8 -0
  47. package/dist/orbitals/domain-language/prompts/odl-syntax.d.ts +8 -0
  48. package/dist/orbitals/domain-language/prompts/odl-to-schema.d.ts +8 -0
  49. package/dist/orbitals/generation/index.d.ts +10 -0
  50. package/dist/orbitals/generation/orbital-generator.d.ts +120 -0
  51. package/dist/orbitals/shared/constants.d.ts +65 -0
  52. package/dist/orbitals/shared/index.d.ts +11 -0
  53. package/dist/orbitals/shared/types.d.ts +187 -0
  54. package/dist/orbitals/shared/utils.d.ts +97 -0
  55. package/dist/orchestration/complexity-classifier.d.ts +38 -0
  56. package/dist/orchestration/fixing-orchestrator.d.ts +53 -0
  57. package/dist/orchestration/index.d.ts +31 -0
  58. package/dist/orchestration/provider-router.d.ts +45 -0
  59. package/dist/persistence/firestore-checkpointer.d.ts +139 -0
  60. package/dist/persistence/firestore-session-store.d.ts +75 -0
  61. package/dist/persistence/firestore-store.d.ts +86 -0
  62. package/dist/persistence/index.d.ts +10 -0
  63. package/dist/persistence/memory-backend.d.ts +33 -0
  64. package/dist/persistence/types.d.ts +40 -0
  65. package/dist/security/audit-log.d.ts +44 -0
  66. package/dist/state-sync.d.ts +171 -0
  67. package/dist/subagents.d.ts +38 -0
  68. package/dist/tools/combine-schemas.d.ts +154 -0
  69. package/dist/tools/composition.d.ts +119 -0
  70. package/dist/tools/domain-orbital.d.ts +997 -0
  71. package/dist/tools/execute.d.ts +38 -0
  72. package/dist/tools/finish-task.d.ts +56 -0
  73. package/dist/tools/generate-schema.d.ts +53 -0
  74. package/dist/tools/github.d.ts +297 -0
  75. package/dist/tools/index.d.ts +1318 -0
  76. package/dist/tools/orbital-batch-subagent.d.ts +85 -0
  77. package/dist/tools/orbital-subagent.d.ts +454 -0
  78. package/dist/tools/orchestrated-fixing.d.ts +74 -0
  79. package/dist/tools/orchestrated-generation.d.ts +75 -0
  80. package/dist/tools/sandbox-executor.d.ts +31 -0
  81. package/dist/tools/schema-chunking.d.ts +117 -0
  82. package/dist/tools/trait-subagent.d.ts +179 -0
  83. package/dist/tools/validate-schema.d.ts +17 -0
  84. package/dist/types.d.ts +167 -0
  85. package/dist/utils/safety/capability-token.d.ts +50 -0
  86. package/dist/utils/safety/circuit-breaker.d.ts +71 -0
  87. package/dist/utils/safety/index.d.ts +19 -0
  88. package/dist/utils/safety/rate-limiter.d.ts +39 -0
  89. package/dist/utils/safety/threshold-auth.d.ts +70 -0
  90. package/dist/workspace/git-client.d.ts +51 -0
  91. package/dist/workspace/index.d.ts +38 -0
  92. package/dist/workspace/memory-files.d.ts +31 -0
  93. package/dist/workspace/sink-manager.d.ts +26 -0
  94. package/dist/workspace/sinks/firestore-sink.d.ts +41 -0
  95. package/dist/workspace/sinks/git-sink.d.ts +47 -0
  96. package/dist/workspace/sinks/index.d.ts +9 -0
  97. package/dist/workspace/templates.d.ts +32 -0
  98. package/dist/workspace/types.d.ts +86 -0
  99. package/dist/workspace/workspace-manager.d.ts +57 -0
  100. package/package.json +7 -6
@@ -0,0 +1,997 @@
1
+ /**
2
+ * Domain Orbital Tool
3
+ *
4
+ * Generates domain language orbitals incrementally using LLM.
5
+ * Uses @almadar/llm for LLM access and @almadar/skills for prompt sections.
6
+ *
7
+ * @packageDocumentation
8
+ */
9
+ import { z } from 'zod';
10
+ import { type LLMProvider } from '@almadar/llm';
11
+ import type { SSEEventType } from '../api-types.js';
12
+ import type { AgentDomainCategory } from '@almadar/core/types';
13
+ export type DomainOrbitalEventCallback = (orbitalName: string, orbitalIndex: number, totalOrbitals: number, event: {
14
+ type: Exclude<SSEEventType, 'subagent_event'>;
15
+ data: Record<string, unknown>;
16
+ timestamp: number;
17
+ }) => void;
18
+ export type DomainOrbitalCompleteCallback = (domainText: string, orbitalName: string, orbitalIndex: number, totalOrbitals: number) => void | Promise<void>;
19
+ export interface DomainOrbitalToolOptions {
20
+ onEvent?: DomainOrbitalEventCallback;
21
+ onOrbitalComplete?: DomainOrbitalCompleteCallback;
22
+ workDir?: string;
23
+ /** LLM provider for domain orbital generation. Defaults to 'anthropic' */
24
+ provider?: LLMProvider;
25
+ /** Model name for domain orbital generation. Defaults to 'claude-sonnet-4-20250514' */
26
+ model?: string;
27
+ }
28
+ export interface DomainOrbitalSpec {
29
+ name: string;
30
+ entity: {
31
+ name: string;
32
+ persistence: 'persistent' | 'runtime' | 'singleton';
33
+ fields: Array<{
34
+ name: string;
35
+ type: string;
36
+ required?: boolean;
37
+ default?: unknown;
38
+ }>;
39
+ relations?: Array<{
40
+ entity: string;
41
+ alias?: string;
42
+ type: 'belongs_to' | 'has_many';
43
+ }>;
44
+ };
45
+ pages: Array<{
46
+ name: string;
47
+ path: string;
48
+ viewType: string;
49
+ isInitial?: boolean;
50
+ }>;
51
+ traits: string[];
52
+ patterns: string[];
53
+ domainContext?: {
54
+ request: string;
55
+ requestFragment?: string;
56
+ category: AgentDomainCategory;
57
+ vocabulary?: Record<string, string>;
58
+ };
59
+ design?: {
60
+ style?: 'minimal' | 'modern' | 'playful' | 'data-driven' | 'immersive';
61
+ uxHints?: {
62
+ flowPattern?: 'hub-spoke' | 'master-detail' | 'crud-cycle' | 'linear' | 'role-based';
63
+ listPattern?: 'entity-table' | 'entity-cards' | 'entity-list';
64
+ formPattern?: 'modal' | 'drawer' | 'page';
65
+ detailPattern?: 'drawer' | 'page' | 'split';
66
+ };
67
+ };
68
+ emits?: string[];
69
+ listens?: Array<{
70
+ event: string;
71
+ triggers: string;
72
+ }>;
73
+ }
74
+ /**
75
+ * Create the generate_orbital_domain tool.
76
+ * Uses @almadar/llm LLMClient directly for Anthropic calls.
77
+ */
78
+ export declare function createGenerateOrbitalDomainTool(options?: DomainOrbitalToolOptions): {
79
+ tool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
80
+ sessionId: z.ZodString;
81
+ orbital: z.ZodObject<{
82
+ name: z.ZodString;
83
+ entity: z.ZodObject<{
84
+ name: z.ZodString;
85
+ persistence: z.ZodEnum<["persistent", "runtime", "singleton"]>;
86
+ fields: z.ZodArray<z.ZodObject<{
87
+ name: z.ZodString;
88
+ type: z.ZodString;
89
+ required: z.ZodOptional<z.ZodBoolean>;
90
+ default: z.ZodOptional<z.ZodAny>;
91
+ }, "strip", z.ZodTypeAny, {
92
+ type: string;
93
+ name: string;
94
+ default?: any;
95
+ required?: boolean | undefined;
96
+ }, {
97
+ type: string;
98
+ name: string;
99
+ default?: any;
100
+ required?: boolean | undefined;
101
+ }>, "many">;
102
+ relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
103
+ entity: z.ZodString;
104
+ alias: z.ZodOptional<z.ZodString>;
105
+ type: z.ZodEnum<["belongs_to", "has_many"]>;
106
+ }, "strip", z.ZodTypeAny, {
107
+ type: "belongs_to" | "has_many";
108
+ entity: string;
109
+ alias?: string | undefined;
110
+ }, {
111
+ type: "belongs_to" | "has_many";
112
+ entity: string;
113
+ alias?: string | undefined;
114
+ }>, "many">>;
115
+ }, "strip", z.ZodTypeAny, {
116
+ name: string;
117
+ fields: {
118
+ type: string;
119
+ name: string;
120
+ default?: any;
121
+ required?: boolean | undefined;
122
+ }[];
123
+ persistence: "persistent" | "runtime" | "singleton";
124
+ relations?: {
125
+ type: "belongs_to" | "has_many";
126
+ entity: string;
127
+ alias?: string | undefined;
128
+ }[] | undefined;
129
+ }, {
130
+ name: string;
131
+ fields: {
132
+ type: string;
133
+ name: string;
134
+ default?: any;
135
+ required?: boolean | undefined;
136
+ }[];
137
+ persistence: "persistent" | "runtime" | "singleton";
138
+ relations?: {
139
+ type: "belongs_to" | "has_many";
140
+ entity: string;
141
+ alias?: string | undefined;
142
+ }[] | undefined;
143
+ }>;
144
+ pages: z.ZodArray<z.ZodObject<{
145
+ name: z.ZodString;
146
+ path: z.ZodString;
147
+ viewType: z.ZodString;
148
+ isInitial: z.ZodOptional<z.ZodBoolean>;
149
+ }, "strip", z.ZodTypeAny, {
150
+ path: string;
151
+ name: string;
152
+ viewType: string;
153
+ isInitial?: boolean | undefined;
154
+ }, {
155
+ path: string;
156
+ name: string;
157
+ viewType: string;
158
+ isInitial?: boolean | undefined;
159
+ }>, "many">;
160
+ traits: z.ZodArray<z.ZodString, "many">;
161
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
162
+ domainContext: z.ZodOptional<z.ZodObject<{
163
+ request: z.ZodString;
164
+ requestFragment: z.ZodOptional<z.ZodString>;
165
+ category: z.ZodEnum<["game", "business", "dashboard", "form", "content", "social", "ecommerce", "workflow"]>;
166
+ vocabulary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
167
+ }, "strip", z.ZodTypeAny, {
168
+ request: string;
169
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
170
+ requestFragment?: string | undefined;
171
+ vocabulary?: Record<string, string> | undefined;
172
+ }, {
173
+ request: string;
174
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
175
+ requestFragment?: string | undefined;
176
+ vocabulary?: Record<string, string> | undefined;
177
+ }>>;
178
+ design: z.ZodOptional<z.ZodObject<{
179
+ style: z.ZodOptional<z.ZodEnum<["minimal", "modern", "playful", "data-driven", "immersive"]>>;
180
+ uxHints: z.ZodOptional<z.ZodObject<{
181
+ flowPattern: z.ZodOptional<z.ZodEnum<["hub-spoke", "master-detail", "crud-cycle", "linear", "role-based"]>>;
182
+ listPattern: z.ZodOptional<z.ZodEnum<["entity-table", "entity-cards", "entity-list"]>>;
183
+ formPattern: z.ZodOptional<z.ZodEnum<["modal", "drawer", "page"]>>;
184
+ detailPattern: z.ZodOptional<z.ZodEnum<["drawer", "page", "split"]>>;
185
+ }, "strip", z.ZodTypeAny, {
186
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
187
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
188
+ formPattern?: "modal" | "drawer" | "page" | undefined;
189
+ detailPattern?: "split" | "drawer" | "page" | undefined;
190
+ }, {
191
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
192
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
193
+ formPattern?: "modal" | "drawer" | "page" | undefined;
194
+ detailPattern?: "split" | "drawer" | "page" | undefined;
195
+ }>>;
196
+ }, "strip", z.ZodTypeAny, {
197
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
198
+ uxHints?: {
199
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
200
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
201
+ formPattern?: "modal" | "drawer" | "page" | undefined;
202
+ detailPattern?: "split" | "drawer" | "page" | undefined;
203
+ } | undefined;
204
+ }, {
205
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
206
+ uxHints?: {
207
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
208
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
209
+ formPattern?: "modal" | "drawer" | "page" | undefined;
210
+ detailPattern?: "split" | "drawer" | "page" | undefined;
211
+ } | undefined;
212
+ }>>;
213
+ emits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
214
+ listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
215
+ event: z.ZodString;
216
+ triggers: z.ZodString;
217
+ }, "strip", z.ZodTypeAny, {
218
+ event: string;
219
+ triggers: string;
220
+ }, {
221
+ event: string;
222
+ triggers: string;
223
+ }>, "many">>;
224
+ }, "strip", z.ZodTypeAny, {
225
+ pages: {
226
+ path: string;
227
+ name: string;
228
+ viewType: string;
229
+ isInitial?: boolean | undefined;
230
+ }[];
231
+ traits: string[];
232
+ name: string;
233
+ entity: {
234
+ name: string;
235
+ fields: {
236
+ type: string;
237
+ name: string;
238
+ default?: any;
239
+ required?: boolean | undefined;
240
+ }[];
241
+ persistence: "persistent" | "runtime" | "singleton";
242
+ relations?: {
243
+ type: "belongs_to" | "has_many";
244
+ entity: string;
245
+ alias?: string | undefined;
246
+ }[] | undefined;
247
+ };
248
+ patterns?: string[] | undefined;
249
+ domainContext?: {
250
+ request: string;
251
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
252
+ requestFragment?: string | undefined;
253
+ vocabulary?: Record<string, string> | undefined;
254
+ } | undefined;
255
+ design?: {
256
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
257
+ uxHints?: {
258
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
259
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
260
+ formPattern?: "modal" | "drawer" | "page" | undefined;
261
+ detailPattern?: "split" | "drawer" | "page" | undefined;
262
+ } | undefined;
263
+ } | undefined;
264
+ emits?: string[] | undefined;
265
+ listens?: {
266
+ event: string;
267
+ triggers: string;
268
+ }[] | undefined;
269
+ }, {
270
+ pages: {
271
+ path: string;
272
+ name: string;
273
+ viewType: string;
274
+ isInitial?: boolean | undefined;
275
+ }[];
276
+ traits: string[];
277
+ name: string;
278
+ entity: {
279
+ name: string;
280
+ fields: {
281
+ type: string;
282
+ name: string;
283
+ default?: any;
284
+ required?: boolean | undefined;
285
+ }[];
286
+ persistence: "persistent" | "runtime" | "singleton";
287
+ relations?: {
288
+ type: "belongs_to" | "has_many";
289
+ entity: string;
290
+ alias?: string | undefined;
291
+ }[] | undefined;
292
+ };
293
+ patterns?: string[] | undefined;
294
+ domainContext?: {
295
+ request: string;
296
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
297
+ requestFragment?: string | undefined;
298
+ vocabulary?: Record<string, string> | undefined;
299
+ } | undefined;
300
+ design?: {
301
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
302
+ uxHints?: {
303
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
304
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
305
+ formPattern?: "modal" | "drawer" | "page" | undefined;
306
+ detailPattern?: "split" | "drawer" | "page" | undefined;
307
+ } | undefined;
308
+ } | undefined;
309
+ emits?: string[] | undefined;
310
+ listens?: {
311
+ event: string;
312
+ triggers: string;
313
+ }[] | undefined;
314
+ }>;
315
+ orbitalIndex: z.ZodNumber;
316
+ totalOrbitals: z.ZodNumber;
317
+ }, "strip", z.ZodTypeAny, {
318
+ sessionId: string;
319
+ orbital: {
320
+ pages: {
321
+ path: string;
322
+ name: string;
323
+ viewType: string;
324
+ isInitial?: boolean | undefined;
325
+ }[];
326
+ traits: string[];
327
+ name: string;
328
+ entity: {
329
+ name: string;
330
+ fields: {
331
+ type: string;
332
+ name: string;
333
+ default?: any;
334
+ required?: boolean | undefined;
335
+ }[];
336
+ persistence: "persistent" | "runtime" | "singleton";
337
+ relations?: {
338
+ type: "belongs_to" | "has_many";
339
+ entity: string;
340
+ alias?: string | undefined;
341
+ }[] | undefined;
342
+ };
343
+ patterns?: string[] | undefined;
344
+ domainContext?: {
345
+ request: string;
346
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
347
+ requestFragment?: string | undefined;
348
+ vocabulary?: Record<string, string> | undefined;
349
+ } | undefined;
350
+ design?: {
351
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
352
+ uxHints?: {
353
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
354
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
355
+ formPattern?: "modal" | "drawer" | "page" | undefined;
356
+ detailPattern?: "split" | "drawer" | "page" | undefined;
357
+ } | undefined;
358
+ } | undefined;
359
+ emits?: string[] | undefined;
360
+ listens?: {
361
+ event: string;
362
+ triggers: string;
363
+ }[] | undefined;
364
+ };
365
+ orbitalIndex: number;
366
+ totalOrbitals: number;
367
+ }, {
368
+ sessionId: string;
369
+ orbital: {
370
+ pages: {
371
+ path: string;
372
+ name: string;
373
+ viewType: string;
374
+ isInitial?: boolean | undefined;
375
+ }[];
376
+ traits: string[];
377
+ name: string;
378
+ entity: {
379
+ name: string;
380
+ fields: {
381
+ type: string;
382
+ name: string;
383
+ default?: any;
384
+ required?: boolean | undefined;
385
+ }[];
386
+ persistence: "persistent" | "runtime" | "singleton";
387
+ relations?: {
388
+ type: "belongs_to" | "has_many";
389
+ entity: string;
390
+ alias?: string | undefined;
391
+ }[] | undefined;
392
+ };
393
+ patterns?: string[] | undefined;
394
+ domainContext?: {
395
+ request: string;
396
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
397
+ requestFragment?: string | undefined;
398
+ vocabulary?: Record<string, string> | undefined;
399
+ } | undefined;
400
+ design?: {
401
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
402
+ uxHints?: {
403
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
404
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
405
+ formPattern?: "modal" | "drawer" | "page" | undefined;
406
+ detailPattern?: "split" | "drawer" | "page" | undefined;
407
+ } | undefined;
408
+ } | undefined;
409
+ emits?: string[] | undefined;
410
+ listens?: {
411
+ event: string;
412
+ triggers: string;
413
+ }[] | undefined;
414
+ };
415
+ orbitalIndex: number;
416
+ totalOrbitals: number;
417
+ }>, {
418
+ sessionId: string;
419
+ orbital: {
420
+ pages: {
421
+ path: string;
422
+ name: string;
423
+ viewType: string;
424
+ isInitial?: boolean | undefined;
425
+ }[];
426
+ traits: string[];
427
+ name: string;
428
+ entity: {
429
+ name: string;
430
+ fields: {
431
+ type: string;
432
+ name: string;
433
+ default?: any;
434
+ required?: boolean | undefined;
435
+ }[];
436
+ persistence: "persistent" | "runtime" | "singleton";
437
+ relations?: {
438
+ type: "belongs_to" | "has_many";
439
+ entity: string;
440
+ alias?: string | undefined;
441
+ }[] | undefined;
442
+ };
443
+ patterns?: string[] | undefined;
444
+ domainContext?: {
445
+ request: string;
446
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
447
+ requestFragment?: string | undefined;
448
+ vocabulary?: Record<string, string> | undefined;
449
+ } | undefined;
450
+ design?: {
451
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
452
+ uxHints?: {
453
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
454
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
455
+ formPattern?: "modal" | "drawer" | "page" | undefined;
456
+ detailPattern?: "split" | "drawer" | "page" | undefined;
457
+ } | undefined;
458
+ } | undefined;
459
+ emits?: string[] | undefined;
460
+ listens?: {
461
+ event: string;
462
+ triggers: string;
463
+ }[] | undefined;
464
+ };
465
+ orbitalIndex: number;
466
+ totalOrbitals: number;
467
+ }, {
468
+ sessionId: string;
469
+ orbital: {
470
+ pages: {
471
+ path: string;
472
+ name: string;
473
+ viewType: string;
474
+ isInitial?: boolean | undefined;
475
+ }[];
476
+ traits: string[];
477
+ name: string;
478
+ entity: {
479
+ name: string;
480
+ fields: {
481
+ type: string;
482
+ name: string;
483
+ default?: any;
484
+ required?: boolean | undefined;
485
+ }[];
486
+ persistence: "persistent" | "runtime" | "singleton";
487
+ relations?: {
488
+ type: "belongs_to" | "has_many";
489
+ entity: string;
490
+ alias?: string | undefined;
491
+ }[] | undefined;
492
+ };
493
+ patterns?: string[] | undefined;
494
+ domainContext?: {
495
+ request: string;
496
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
497
+ requestFragment?: string | undefined;
498
+ vocabulary?: Record<string, string> | undefined;
499
+ } | undefined;
500
+ design?: {
501
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
502
+ uxHints?: {
503
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
504
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
505
+ formPattern?: "modal" | "drawer" | "page" | undefined;
506
+ detailPattern?: "split" | "drawer" | "page" | undefined;
507
+ } | undefined;
508
+ } | undefined;
509
+ emits?: string[] | undefined;
510
+ listens?: {
511
+ event: string;
512
+ triggers: string;
513
+ }[] | undefined;
514
+ };
515
+ orbitalIndex: number;
516
+ totalOrbitals: number;
517
+ }, string, "generate_orbital_domain">;
518
+ setEventCallback: (callback: DomainOrbitalEventCallback) => void;
519
+ setCompleteCallback: (callback: DomainOrbitalCompleteCallback) => void;
520
+ };
521
+ /**
522
+ * Create the construct_combined_domain tool.
523
+ */
524
+ export declare function createConstructCombinedDomainTool(options?: {
525
+ onEvent?: DomainOrbitalEventCallback;
526
+ workDir?: string;
527
+ }): {
528
+ tool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
529
+ appName: z.ZodString;
530
+ }, "strip", z.ZodTypeAny, {
531
+ appName: string;
532
+ }, {
533
+ appName: string;
534
+ }>, {
535
+ appName: string;
536
+ }, {
537
+ appName: string;
538
+ }, string, "construct_combined_domain">;
539
+ setEventCallback: (callback: DomainOrbitalEventCallback) => void;
540
+ };
541
+ /**
542
+ * Create both domain orbital tools together.
543
+ */
544
+ export declare function createDomainOrbitalTools(options?: DomainOrbitalToolOptions): {
545
+ generateOrbitalDomain: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
546
+ sessionId: z.ZodString;
547
+ orbital: z.ZodObject<{
548
+ name: z.ZodString;
549
+ entity: z.ZodObject<{
550
+ name: z.ZodString;
551
+ persistence: z.ZodEnum<["persistent", "runtime", "singleton"]>;
552
+ fields: z.ZodArray<z.ZodObject<{
553
+ name: z.ZodString;
554
+ type: z.ZodString;
555
+ required: z.ZodOptional<z.ZodBoolean>;
556
+ default: z.ZodOptional<z.ZodAny>;
557
+ }, "strip", z.ZodTypeAny, {
558
+ type: string;
559
+ name: string;
560
+ default?: any;
561
+ required?: boolean | undefined;
562
+ }, {
563
+ type: string;
564
+ name: string;
565
+ default?: any;
566
+ required?: boolean | undefined;
567
+ }>, "many">;
568
+ relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
569
+ entity: z.ZodString;
570
+ alias: z.ZodOptional<z.ZodString>;
571
+ type: z.ZodEnum<["belongs_to", "has_many"]>;
572
+ }, "strip", z.ZodTypeAny, {
573
+ type: "belongs_to" | "has_many";
574
+ entity: string;
575
+ alias?: string | undefined;
576
+ }, {
577
+ type: "belongs_to" | "has_many";
578
+ entity: string;
579
+ alias?: string | undefined;
580
+ }>, "many">>;
581
+ }, "strip", z.ZodTypeAny, {
582
+ name: string;
583
+ fields: {
584
+ type: string;
585
+ name: string;
586
+ default?: any;
587
+ required?: boolean | undefined;
588
+ }[];
589
+ persistence: "persistent" | "runtime" | "singleton";
590
+ relations?: {
591
+ type: "belongs_to" | "has_many";
592
+ entity: string;
593
+ alias?: string | undefined;
594
+ }[] | undefined;
595
+ }, {
596
+ name: string;
597
+ fields: {
598
+ type: string;
599
+ name: string;
600
+ default?: any;
601
+ required?: boolean | undefined;
602
+ }[];
603
+ persistence: "persistent" | "runtime" | "singleton";
604
+ relations?: {
605
+ type: "belongs_to" | "has_many";
606
+ entity: string;
607
+ alias?: string | undefined;
608
+ }[] | undefined;
609
+ }>;
610
+ pages: z.ZodArray<z.ZodObject<{
611
+ name: z.ZodString;
612
+ path: z.ZodString;
613
+ viewType: z.ZodString;
614
+ isInitial: z.ZodOptional<z.ZodBoolean>;
615
+ }, "strip", z.ZodTypeAny, {
616
+ path: string;
617
+ name: string;
618
+ viewType: string;
619
+ isInitial?: boolean | undefined;
620
+ }, {
621
+ path: string;
622
+ name: string;
623
+ viewType: string;
624
+ isInitial?: boolean | undefined;
625
+ }>, "many">;
626
+ traits: z.ZodArray<z.ZodString, "many">;
627
+ patterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
628
+ domainContext: z.ZodOptional<z.ZodObject<{
629
+ request: z.ZodString;
630
+ requestFragment: z.ZodOptional<z.ZodString>;
631
+ category: z.ZodEnum<["game", "business", "dashboard", "form", "content", "social", "ecommerce", "workflow"]>;
632
+ vocabulary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
633
+ }, "strip", z.ZodTypeAny, {
634
+ request: string;
635
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
636
+ requestFragment?: string | undefined;
637
+ vocabulary?: Record<string, string> | undefined;
638
+ }, {
639
+ request: string;
640
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
641
+ requestFragment?: string | undefined;
642
+ vocabulary?: Record<string, string> | undefined;
643
+ }>>;
644
+ design: z.ZodOptional<z.ZodObject<{
645
+ style: z.ZodOptional<z.ZodEnum<["minimal", "modern", "playful", "data-driven", "immersive"]>>;
646
+ uxHints: z.ZodOptional<z.ZodObject<{
647
+ flowPattern: z.ZodOptional<z.ZodEnum<["hub-spoke", "master-detail", "crud-cycle", "linear", "role-based"]>>;
648
+ listPattern: z.ZodOptional<z.ZodEnum<["entity-table", "entity-cards", "entity-list"]>>;
649
+ formPattern: z.ZodOptional<z.ZodEnum<["modal", "drawer", "page"]>>;
650
+ detailPattern: z.ZodOptional<z.ZodEnum<["drawer", "page", "split"]>>;
651
+ }, "strip", z.ZodTypeAny, {
652
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
653
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
654
+ formPattern?: "modal" | "drawer" | "page" | undefined;
655
+ detailPattern?: "split" | "drawer" | "page" | undefined;
656
+ }, {
657
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
658
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
659
+ formPattern?: "modal" | "drawer" | "page" | undefined;
660
+ detailPattern?: "split" | "drawer" | "page" | undefined;
661
+ }>>;
662
+ }, "strip", z.ZodTypeAny, {
663
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
664
+ uxHints?: {
665
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
666
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
667
+ formPattern?: "modal" | "drawer" | "page" | undefined;
668
+ detailPattern?: "split" | "drawer" | "page" | undefined;
669
+ } | undefined;
670
+ }, {
671
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
672
+ uxHints?: {
673
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
674
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
675
+ formPattern?: "modal" | "drawer" | "page" | undefined;
676
+ detailPattern?: "split" | "drawer" | "page" | undefined;
677
+ } | undefined;
678
+ }>>;
679
+ emits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
680
+ listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
681
+ event: z.ZodString;
682
+ triggers: z.ZodString;
683
+ }, "strip", z.ZodTypeAny, {
684
+ event: string;
685
+ triggers: string;
686
+ }, {
687
+ event: string;
688
+ triggers: string;
689
+ }>, "many">>;
690
+ }, "strip", z.ZodTypeAny, {
691
+ pages: {
692
+ path: string;
693
+ name: string;
694
+ viewType: string;
695
+ isInitial?: boolean | undefined;
696
+ }[];
697
+ traits: string[];
698
+ name: string;
699
+ entity: {
700
+ name: string;
701
+ fields: {
702
+ type: string;
703
+ name: string;
704
+ default?: any;
705
+ required?: boolean | undefined;
706
+ }[];
707
+ persistence: "persistent" | "runtime" | "singleton";
708
+ relations?: {
709
+ type: "belongs_to" | "has_many";
710
+ entity: string;
711
+ alias?: string | undefined;
712
+ }[] | undefined;
713
+ };
714
+ patterns?: string[] | undefined;
715
+ domainContext?: {
716
+ request: string;
717
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
718
+ requestFragment?: string | undefined;
719
+ vocabulary?: Record<string, string> | undefined;
720
+ } | undefined;
721
+ design?: {
722
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
723
+ uxHints?: {
724
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
725
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
726
+ formPattern?: "modal" | "drawer" | "page" | undefined;
727
+ detailPattern?: "split" | "drawer" | "page" | undefined;
728
+ } | undefined;
729
+ } | undefined;
730
+ emits?: string[] | undefined;
731
+ listens?: {
732
+ event: string;
733
+ triggers: string;
734
+ }[] | undefined;
735
+ }, {
736
+ pages: {
737
+ path: string;
738
+ name: string;
739
+ viewType: string;
740
+ isInitial?: boolean | undefined;
741
+ }[];
742
+ traits: string[];
743
+ name: string;
744
+ entity: {
745
+ name: string;
746
+ fields: {
747
+ type: string;
748
+ name: string;
749
+ default?: any;
750
+ required?: boolean | undefined;
751
+ }[];
752
+ persistence: "persistent" | "runtime" | "singleton";
753
+ relations?: {
754
+ type: "belongs_to" | "has_many";
755
+ entity: string;
756
+ alias?: string | undefined;
757
+ }[] | undefined;
758
+ };
759
+ patterns?: string[] | undefined;
760
+ domainContext?: {
761
+ request: string;
762
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
763
+ requestFragment?: string | undefined;
764
+ vocabulary?: Record<string, string> | undefined;
765
+ } | undefined;
766
+ design?: {
767
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
768
+ uxHints?: {
769
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
770
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
771
+ formPattern?: "modal" | "drawer" | "page" | undefined;
772
+ detailPattern?: "split" | "drawer" | "page" | undefined;
773
+ } | undefined;
774
+ } | undefined;
775
+ emits?: string[] | undefined;
776
+ listens?: {
777
+ event: string;
778
+ triggers: string;
779
+ }[] | undefined;
780
+ }>;
781
+ orbitalIndex: z.ZodNumber;
782
+ totalOrbitals: z.ZodNumber;
783
+ }, "strip", z.ZodTypeAny, {
784
+ sessionId: string;
785
+ orbital: {
786
+ pages: {
787
+ path: string;
788
+ name: string;
789
+ viewType: string;
790
+ isInitial?: boolean | undefined;
791
+ }[];
792
+ traits: string[];
793
+ name: string;
794
+ entity: {
795
+ name: string;
796
+ fields: {
797
+ type: string;
798
+ name: string;
799
+ default?: any;
800
+ required?: boolean | undefined;
801
+ }[];
802
+ persistence: "persistent" | "runtime" | "singleton";
803
+ relations?: {
804
+ type: "belongs_to" | "has_many";
805
+ entity: string;
806
+ alias?: string | undefined;
807
+ }[] | undefined;
808
+ };
809
+ patterns?: string[] | undefined;
810
+ domainContext?: {
811
+ request: string;
812
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
813
+ requestFragment?: string | undefined;
814
+ vocabulary?: Record<string, string> | undefined;
815
+ } | undefined;
816
+ design?: {
817
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
818
+ uxHints?: {
819
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
820
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
821
+ formPattern?: "modal" | "drawer" | "page" | undefined;
822
+ detailPattern?: "split" | "drawer" | "page" | undefined;
823
+ } | undefined;
824
+ } | undefined;
825
+ emits?: string[] | undefined;
826
+ listens?: {
827
+ event: string;
828
+ triggers: string;
829
+ }[] | undefined;
830
+ };
831
+ orbitalIndex: number;
832
+ totalOrbitals: number;
833
+ }, {
834
+ sessionId: string;
835
+ orbital: {
836
+ pages: {
837
+ path: string;
838
+ name: string;
839
+ viewType: string;
840
+ isInitial?: boolean | undefined;
841
+ }[];
842
+ traits: string[];
843
+ name: string;
844
+ entity: {
845
+ name: string;
846
+ fields: {
847
+ type: string;
848
+ name: string;
849
+ default?: any;
850
+ required?: boolean | undefined;
851
+ }[];
852
+ persistence: "persistent" | "runtime" | "singleton";
853
+ relations?: {
854
+ type: "belongs_to" | "has_many";
855
+ entity: string;
856
+ alias?: string | undefined;
857
+ }[] | undefined;
858
+ };
859
+ patterns?: string[] | undefined;
860
+ domainContext?: {
861
+ request: string;
862
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
863
+ requestFragment?: string | undefined;
864
+ vocabulary?: Record<string, string> | undefined;
865
+ } | undefined;
866
+ design?: {
867
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
868
+ uxHints?: {
869
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
870
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
871
+ formPattern?: "modal" | "drawer" | "page" | undefined;
872
+ detailPattern?: "split" | "drawer" | "page" | undefined;
873
+ } | undefined;
874
+ } | undefined;
875
+ emits?: string[] | undefined;
876
+ listens?: {
877
+ event: string;
878
+ triggers: string;
879
+ }[] | undefined;
880
+ };
881
+ orbitalIndex: number;
882
+ totalOrbitals: number;
883
+ }>, {
884
+ sessionId: string;
885
+ orbital: {
886
+ pages: {
887
+ path: string;
888
+ name: string;
889
+ viewType: string;
890
+ isInitial?: boolean | undefined;
891
+ }[];
892
+ traits: string[];
893
+ name: string;
894
+ entity: {
895
+ name: string;
896
+ fields: {
897
+ type: string;
898
+ name: string;
899
+ default?: any;
900
+ required?: boolean | undefined;
901
+ }[];
902
+ persistence: "persistent" | "runtime" | "singleton";
903
+ relations?: {
904
+ type: "belongs_to" | "has_many";
905
+ entity: string;
906
+ alias?: string | undefined;
907
+ }[] | undefined;
908
+ };
909
+ patterns?: string[] | undefined;
910
+ domainContext?: {
911
+ request: string;
912
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
913
+ requestFragment?: string | undefined;
914
+ vocabulary?: Record<string, string> | undefined;
915
+ } | undefined;
916
+ design?: {
917
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
918
+ uxHints?: {
919
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
920
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
921
+ formPattern?: "modal" | "drawer" | "page" | undefined;
922
+ detailPattern?: "split" | "drawer" | "page" | undefined;
923
+ } | undefined;
924
+ } | undefined;
925
+ emits?: string[] | undefined;
926
+ listens?: {
927
+ event: string;
928
+ triggers: string;
929
+ }[] | undefined;
930
+ };
931
+ orbitalIndex: number;
932
+ totalOrbitals: number;
933
+ }, {
934
+ sessionId: string;
935
+ orbital: {
936
+ pages: {
937
+ path: string;
938
+ name: string;
939
+ viewType: string;
940
+ isInitial?: boolean | undefined;
941
+ }[];
942
+ traits: string[];
943
+ name: string;
944
+ entity: {
945
+ name: string;
946
+ fields: {
947
+ type: string;
948
+ name: string;
949
+ default?: any;
950
+ required?: boolean | undefined;
951
+ }[];
952
+ persistence: "persistent" | "runtime" | "singleton";
953
+ relations?: {
954
+ type: "belongs_to" | "has_many";
955
+ entity: string;
956
+ alias?: string | undefined;
957
+ }[] | undefined;
958
+ };
959
+ patterns?: string[] | undefined;
960
+ domainContext?: {
961
+ request: string;
962
+ category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
963
+ requestFragment?: string | undefined;
964
+ vocabulary?: Record<string, string> | undefined;
965
+ } | undefined;
966
+ design?: {
967
+ style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
968
+ uxHints?: {
969
+ flowPattern?: "hub-spoke" | "master-detail" | "crud-cycle" | "linear" | "role-based" | undefined;
970
+ listPattern?: "entity-table" | "entity-cards" | "entity-list" | undefined;
971
+ formPattern?: "modal" | "drawer" | "page" | undefined;
972
+ detailPattern?: "split" | "drawer" | "page" | undefined;
973
+ } | undefined;
974
+ } | undefined;
975
+ emits?: string[] | undefined;
976
+ listens?: {
977
+ event: string;
978
+ triggers: string;
979
+ }[] | undefined;
980
+ };
981
+ orbitalIndex: number;
982
+ totalOrbitals: number;
983
+ }, string, "generate_orbital_domain">;
984
+ constructCombinedDomain: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
985
+ appName: z.ZodString;
986
+ }, "strip", z.ZodTypeAny, {
987
+ appName: string;
988
+ }, {
989
+ appName: string;
990
+ }>, {
991
+ appName: string;
992
+ }, {
993
+ appName: string;
994
+ }, string, "construct_combined_domain">;
995
+ setEventCallback: (callback: DomainOrbitalEventCallback) => void;
996
+ setCompleteCallback: (callback: DomainOrbitalCompleteCallback) => void;
997
+ };