@almadar/agent 1.6.4 → 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 (107) hide show
  1. package/LICENSE +21 -72
  2. package/README.md +25 -0
  3. package/dist/agent/event-budget.d.ts +28 -0
  4. package/dist/agent/experimental/hitl-v2.d.ts +161 -0
  5. package/dist/agent/experimental/hitl-workflow-integration.d.ts +182 -0
  6. package/dist/agent/index.d.ts +14 -13
  7. package/dist/agent/index.js.map +1 -1
  8. package/dist/agent/interrupt-config.d.ts +51 -0
  9. package/dist/agent/session-manager.d.ts +204 -0
  10. package/dist/agent/skill-agent.d.ts +182 -0
  11. package/dist/agent/workflow-middleware.d.ts +63 -0
  12. package/dist/agent/workflow-tool-wrapper.d.ts +87 -0
  13. package/dist/{api-types-CXrq-fts.d.ts → api-types.d.ts} +85 -51
  14. package/dist/context/compaction.d.ts +191 -0
  15. package/dist/context-compaction.d.ts +55 -0
  16. package/dist/evals/online-sampling.d.ts +114 -0
  17. package/dist/evals/utils/compact-orbital.d.ts +100 -0
  18. package/dist/event-transformer/event-transformer.d.ts +120 -0
  19. package/dist/event-transformer/index.d.ts +4 -122
  20. package/dist/events.d.ts +85 -0
  21. package/dist/index.d.ts +58 -1678
  22. package/dist/index.js +39 -0
  23. package/dist/index.js.map +1 -1
  24. package/dist/memory/MemoryManager.d.ts +243 -0
  25. package/dist/memory/PreferenceLearner.d.ts +59 -0
  26. package/dist/memory/agentic-search.d.ts +116 -0
  27. package/dist/memory/index.d.ts +14 -0
  28. package/dist/memory/memory-orbital.d.ts +66 -0
  29. package/dist/memory/types.d.ts +143 -0
  30. package/dist/metrics.d.ts +77 -0
  31. package/dist/multi-user.d.ts +155 -0
  32. package/dist/observability/index.d.ts +14 -0
  33. package/dist/observability/langsmith-integration.d.ts +203 -0
  34. package/dist/observability.d.ts +196 -0
  35. package/dist/orbitals/archive/sanitize.d.ts +24 -0
  36. package/dist/orbitals/batch/batch-generator.d.ts +41 -0
  37. package/dist/orbitals/batch/concurrency.d.ts +54 -0
  38. package/dist/orbitals/batch/index.d.ts +14 -0
  39. package/dist/orbitals/batch/prompt-assembler.d.ts +92 -0
  40. package/dist/orbitals/batch/types.d.ts +103 -0
  41. package/dist/orbitals/cache/index.d.ts +11 -0
  42. package/dist/orbitals/cache/orbital-fingerprint.d.ts +37 -0
  43. package/dist/orbitals/cache/prompt-assembler.d.ts +65 -0
  44. package/dist/orbitals/cache/structural-templates.d.ts +33 -0
  45. package/dist/orbitals/combiner/index.d.ts +102 -0
  46. package/dist/orbitals/domain-language/index.d.ts +9 -0
  47. package/dist/orbitals/domain-language/prompts/index.d.ts +11 -0
  48. package/dist/orbitals/domain-language/prompts/odl-examples.d.ts +8 -0
  49. package/dist/orbitals/domain-language/prompts/odl-patterns.d.ts +8 -0
  50. package/dist/orbitals/domain-language/prompts/odl-syntax.d.ts +8 -0
  51. package/dist/orbitals/domain-language/prompts/odl-to-schema.d.ts +8 -0
  52. package/dist/orbitals/generation/index.d.ts +10 -0
  53. package/dist/orbitals/generation/orbital-generator.d.ts +120 -0
  54. package/dist/orbitals/shared/constants.d.ts +65 -0
  55. package/dist/orbitals/shared/index.d.ts +11 -0
  56. package/dist/orbitals/shared/types.d.ts +187 -0
  57. package/dist/orbitals/shared/utils.d.ts +97 -0
  58. package/dist/orchestration/complexity-classifier.d.ts +38 -0
  59. package/dist/orchestration/fixing-orchestrator.d.ts +53 -0
  60. package/dist/orchestration/index.d.ts +31 -0
  61. package/dist/orchestration/provider-router.d.ts +45 -0
  62. package/dist/{firestore-checkpointer-CkNKXoun.d.ts → persistence/firestore-checkpointer.d.ts} +13 -58
  63. package/dist/persistence/firestore-session-store.d.ts +75 -0
  64. package/dist/persistence/firestore-store.d.ts +86 -0
  65. package/dist/persistence/index.d.ts +7 -198
  66. package/dist/persistence/memory-backend.d.ts +33 -0
  67. package/dist/persistence/types.d.ts +40 -0
  68. package/dist/security/audit-log.d.ts +44 -0
  69. package/dist/state-sync.d.ts +171 -0
  70. package/dist/subagents.d.ts +38 -0
  71. package/dist/tools/combine-schemas.d.ts +154 -0
  72. package/dist/tools/composition.d.ts +119 -0
  73. package/dist/{orbital-subagent-BdFuf77p.d.ts → tools/domain-orbital.d.ts} +22 -461
  74. package/dist/tools/execute.d.ts +38 -0
  75. package/dist/tools/finish-task.d.ts +56 -0
  76. package/dist/tools/generate-schema.d.ts +53 -0
  77. package/dist/tools/github.d.ts +297 -0
  78. package/dist/tools/index.d.ts +1318 -8
  79. package/dist/tools/orbital-batch-subagent.d.ts +85 -0
  80. package/dist/tools/orbital-subagent.d.ts +454 -0
  81. package/dist/tools/orchestrated-fixing.d.ts +74 -0
  82. package/dist/tools/orchestrated-generation.d.ts +75 -0
  83. package/dist/tools/sandbox-executor.d.ts +31 -0
  84. package/dist/tools/schema-chunking.d.ts +117 -0
  85. package/dist/tools/trait-subagent.d.ts +179 -0
  86. package/dist/tools/validate-schema.d.ts +17 -0
  87. package/dist/types.d.ts +14 -17
  88. package/dist/utils/safety/capability-token.d.ts +50 -0
  89. package/dist/utils/safety/circuit-breaker.d.ts +71 -0
  90. package/dist/utils/safety/index.d.ts +19 -0
  91. package/dist/utils/safety/rate-limiter.d.ts +39 -0
  92. package/dist/utils/safety/threshold-auth.d.ts +70 -0
  93. package/dist/workspace/git-client.d.ts +51 -0
  94. package/dist/workspace/index.d.ts +29 -346
  95. package/dist/workspace/index.js +39 -0
  96. package/dist/workspace/index.js.map +1 -1
  97. package/dist/workspace/memory-files.d.ts +31 -0
  98. package/dist/workspace/sink-manager.d.ts +26 -0
  99. package/dist/workspace/sinks/firestore-sink.d.ts +41 -0
  100. package/dist/workspace/sinks/git-sink.d.ts +47 -0
  101. package/dist/workspace/sinks/index.d.ts +9 -0
  102. package/dist/workspace/templates.d.ts +32 -0
  103. package/dist/workspace/types.d.ts +86 -0
  104. package/dist/workspace/workspace-manager.d.ts +57 -0
  105. package/package.json +12 -10
  106. package/dist/index-DW3F-Ihx.d.ts +0 -2501
  107. package/dist/index-DZn69no8.d.ts +0 -1014
@@ -1,16 +1,22 @@
1
- import * as _langchain_core_tools from '@langchain/core/tools';
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
+ */
2
9
  import { z } from 'zod';
3
- import { LLMProvider } from '@almadar/llm';
4
- import { S as SSEEventType, a as SSEEvent } from './api-types-CXrq-fts.js';
5
- import { AgentDomainCategory } from '@almadar/core/types';
6
-
7
- type DomainOrbitalEventCallback = (orbitalName: string, orbitalIndex: number, totalOrbitals: number, event: {
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: {
8
14
  type: Exclude<SSEEventType, 'subagent_event'>;
9
15
  data: Record<string, unknown>;
10
16
  timestamp: number;
11
17
  }) => void;
12
- type DomainOrbitalCompleteCallback = (domainText: string, orbitalName: string, orbitalIndex: number, totalOrbitals: number) => void | Promise<void>;
13
- interface DomainOrbitalToolOptions {
18
+ export type DomainOrbitalCompleteCallback = (domainText: string, orbitalName: string, orbitalIndex: number, totalOrbitals: number) => void | Promise<void>;
19
+ export interface DomainOrbitalToolOptions {
14
20
  onEvent?: DomainOrbitalEventCallback;
15
21
  onOrbitalComplete?: DomainOrbitalCompleteCallback;
16
22
  workDir?: string;
@@ -19,7 +25,7 @@ interface DomainOrbitalToolOptions {
19
25
  /** Model name for domain orbital generation. Defaults to 'claude-sonnet-4-20250514' */
20
26
  model?: string;
21
27
  }
22
- interface DomainOrbitalSpec {
28
+ export interface DomainOrbitalSpec {
23
29
  name: string;
24
30
  entity: {
25
31
  name: string;
@@ -69,8 +75,8 @@ interface DomainOrbitalSpec {
69
75
  * Create the generate_orbital_domain tool.
70
76
  * Uses @almadar/llm LLMClient directly for Anthropic calls.
71
77
  */
72
- declare function createGenerateOrbitalDomainTool(options?: DomainOrbitalToolOptions): {
73
- tool: _langchain_core_tools.DynamicStructuredTool<z.ZodObject<{
78
+ export declare function createGenerateOrbitalDomainTool(options?: DomainOrbitalToolOptions): {
79
+ tool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
74
80
  sessionId: z.ZodString;
75
81
  orbital: z.ZodObject<{
76
82
  name: z.ZodString;
@@ -515,11 +521,11 @@ declare function createGenerateOrbitalDomainTool(options?: DomainOrbitalToolOpti
515
521
  /**
516
522
  * Create the construct_combined_domain tool.
517
523
  */
518
- declare function createConstructCombinedDomainTool(options?: {
524
+ export declare function createConstructCombinedDomainTool(options?: {
519
525
  onEvent?: DomainOrbitalEventCallback;
520
526
  workDir?: string;
521
527
  }): {
522
- tool: _langchain_core_tools.DynamicStructuredTool<z.ZodObject<{
528
+ tool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
523
529
  appName: z.ZodString;
524
530
  }, "strip", z.ZodTypeAny, {
525
531
  appName: string;
@@ -535,8 +541,8 @@ declare function createConstructCombinedDomainTool(options?: {
535
541
  /**
536
542
  * Create both domain orbital tools together.
537
543
  */
538
- declare function createDomainOrbitalTools(options?: DomainOrbitalToolOptions): {
539
- generateOrbitalDomain: _langchain_core_tools.DynamicStructuredTool<z.ZodObject<{
544
+ export declare function createDomainOrbitalTools(options?: DomainOrbitalToolOptions): {
545
+ generateOrbitalDomain: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
540
546
  sessionId: z.ZodString;
541
547
  orbital: z.ZodObject<{
542
548
  name: z.ZodString;
@@ -975,7 +981,7 @@ declare function createDomainOrbitalTools(options?: DomainOrbitalToolOptions): {
975
981
  orbitalIndex: number;
976
982
  totalOrbitals: number;
977
983
  }, string, "generate_orbital_domain">;
978
- constructCombinedDomain: _langchain_core_tools.DynamicStructuredTool<z.ZodObject<{
984
+ constructCombinedDomain: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
979
985
  appName: z.ZodString;
980
986
  }, "strip", z.ZodTypeAny, {
981
987
  appName: string;
@@ -989,448 +995,3 @@ declare function createDomainOrbitalTools(options?: DomainOrbitalToolOptions): {
989
995
  setEventCallback: (callback: DomainOrbitalEventCallback) => void;
990
996
  setCompleteCallback: (callback: DomainOrbitalCompleteCallback) => void;
991
997
  };
992
-
993
- type SubagentEventCallback = (orbitalName: string, orbitalIndex: number, totalOrbitals: number, event: {
994
- type: Exclude<SSEEventType, 'subagent_event'>;
995
- data: Record<string, unknown>;
996
- timestamp: number;
997
- }) => void;
998
- type OrbitalCompleteCallback = (orbital: unknown, orbitalName: string, orbitalIndex: number, totalOrbitals: number) => void | Promise<void>;
999
- interface OrbitalRequirements {
1000
- entities?: string[];
1001
- states?: string[];
1002
- events?: string[];
1003
- guards?: string[];
1004
- pages?: string[];
1005
- effects?: string[];
1006
- rawRequirements?: string[];
1007
- }
1008
- interface OrbitalSubagentToolOptions {
1009
- onSubagentEvent?: SubagentEventCallback;
1010
- onOrbitalComplete?: OrbitalCompleteCallback;
1011
- requirements?: OrbitalRequirements;
1012
- /** LLM provider for orbital generation subagent. Defaults to 'anthropic' */
1013
- provider?: LLMProvider;
1014
- /** Model name for orbital generation subagent. Defaults to 'claude-sonnet-4-20250514' */
1015
- model?: string;
1016
- /** Working directory for persisting orbital files. When set, orbitals are written to .orbitals/ */
1017
- workDir?: string;
1018
- }
1019
- /**
1020
- * Create a tool for generating orbitals with subagent event streaming.
1021
- * Uses @almadar/llm LLMClient directly.
1022
- */
1023
- declare function createOrbitalSubagentTool(options?: OrbitalSubagentToolOptions): {
1024
- tool: _langchain_core_tools.DynamicStructuredTool<z.ZodObject<{
1025
- orbital: z.ZodObject<{
1026
- name: z.ZodString;
1027
- entity: z.ZodObject<{
1028
- name: z.ZodString;
1029
- persistence: z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>;
1030
- fields: z.ZodArray<z.ZodObject<{
1031
- name: z.ZodString;
1032
- type: z.ZodString;
1033
- required: z.ZodOptional<z.ZodBoolean>;
1034
- }, "strip", z.ZodTypeAny, {
1035
- type: string;
1036
- name: string;
1037
- required?: boolean | undefined;
1038
- }, {
1039
- type: string;
1040
- name: string;
1041
- required?: boolean | undefined;
1042
- }>, "many">;
1043
- }, "strip", z.ZodTypeAny, {
1044
- name: string;
1045
- fields: {
1046
- type: string;
1047
- name: string;
1048
- required?: boolean | undefined;
1049
- }[];
1050
- persistence: "persistent" | "runtime" | "singleton" | "instance";
1051
- }, {
1052
- name: string;
1053
- fields: {
1054
- type: string;
1055
- name: string;
1056
- required?: boolean | undefined;
1057
- }[];
1058
- persistence: "persistent" | "runtime" | "singleton" | "instance";
1059
- }>;
1060
- traits: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
1061
- patterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1062
- pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
1063
- name: z.ZodString;
1064
- path: z.ZodString;
1065
- viewType: z.ZodString;
1066
- }, "strip", z.ZodTypeAny, {
1067
- path: string;
1068
- name: string;
1069
- viewType: string;
1070
- }, {
1071
- path: string;
1072
- name: string;
1073
- viewType: string;
1074
- }>, "many">>;
1075
- domainContext: z.ZodOptional<z.ZodObject<{
1076
- request: z.ZodString;
1077
- requestFragment: z.ZodOptional<z.ZodString>;
1078
- category: z.ZodEnum<["game", "business", "dashboard", "form", "content", "social", "ecommerce", "workflow"]>;
1079
- vocabulary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1080
- }, "strip", z.ZodTypeAny, {
1081
- request: string;
1082
- category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
1083
- requestFragment?: string | undefined;
1084
- vocabulary?: Record<string, string> | undefined;
1085
- }, {
1086
- request: string;
1087
- category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
1088
- requestFragment?: string | undefined;
1089
- vocabulary?: Record<string, string> | undefined;
1090
- }>>;
1091
- design: z.ZodOptional<z.ZodObject<{
1092
- style: z.ZodOptional<z.ZodEnum<["minimal", "modern", "playful", "data-driven", "immersive"]>>;
1093
- uxHints: z.ZodOptional<z.ZodObject<{
1094
- flowPattern: z.ZodOptional<z.ZodString>;
1095
- listPattern: z.ZodOptional<z.ZodString>;
1096
- formPattern: z.ZodOptional<z.ZodString>;
1097
- detailPattern: z.ZodOptional<z.ZodString>;
1098
- }, "strip", z.ZodTypeAny, {
1099
- flowPattern?: string | undefined;
1100
- listPattern?: string | undefined;
1101
- formPattern?: string | undefined;
1102
- detailPattern?: string | undefined;
1103
- }, {
1104
- flowPattern?: string | undefined;
1105
- listPattern?: string | undefined;
1106
- formPattern?: string | undefined;
1107
- detailPattern?: string | undefined;
1108
- }>>;
1109
- }, "strip", z.ZodTypeAny, {
1110
- style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
1111
- uxHints?: {
1112
- flowPattern?: string | undefined;
1113
- listPattern?: string | undefined;
1114
- formPattern?: string | undefined;
1115
- detailPattern?: string | undefined;
1116
- } | undefined;
1117
- }, {
1118
- style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
1119
- uxHints?: {
1120
- flowPattern?: string | undefined;
1121
- listPattern?: string | undefined;
1122
- formPattern?: string | undefined;
1123
- detailPattern?: string | undefined;
1124
- } | undefined;
1125
- }>>;
1126
- emits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1127
- listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
1128
- event: z.ZodString;
1129
- triggers: z.ZodString;
1130
- }, "strip", z.ZodTypeAny, {
1131
- event: string;
1132
- triggers: string;
1133
- }, {
1134
- event: string;
1135
- triggers: string;
1136
- }>, "many">>;
1137
- relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
1138
- entity: z.ZodString;
1139
- alias: z.ZodOptional<z.ZodString>;
1140
- cardinality: z.ZodEnum<["one", "many"]>;
1141
- }, "strip", z.ZodTypeAny, {
1142
- entity: string;
1143
- cardinality: "many" | "one";
1144
- alias?: string | undefined;
1145
- }, {
1146
- entity: string;
1147
- cardinality: "many" | "one";
1148
- alias?: string | undefined;
1149
- }>, "many">>;
1150
- }, "strip", z.ZodTypeAny, {
1151
- traits: string[];
1152
- name: string;
1153
- entity: {
1154
- name: string;
1155
- fields: {
1156
- type: string;
1157
- name: string;
1158
- required?: boolean | undefined;
1159
- }[];
1160
- persistence: "persistent" | "runtime" | "singleton" | "instance";
1161
- };
1162
- pages?: {
1163
- path: string;
1164
- name: string;
1165
- viewType: string;
1166
- }[] | undefined;
1167
- relations?: {
1168
- entity: string;
1169
- cardinality: "many" | "one";
1170
- alias?: string | undefined;
1171
- }[] | undefined;
1172
- patterns?: string[] | undefined;
1173
- domainContext?: {
1174
- request: string;
1175
- category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
1176
- requestFragment?: string | undefined;
1177
- vocabulary?: Record<string, string> | undefined;
1178
- } | undefined;
1179
- design?: {
1180
- style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
1181
- uxHints?: {
1182
- flowPattern?: string | undefined;
1183
- listPattern?: string | undefined;
1184
- formPattern?: string | undefined;
1185
- detailPattern?: string | undefined;
1186
- } | undefined;
1187
- } | undefined;
1188
- emits?: string[] | undefined;
1189
- listens?: {
1190
- event: string;
1191
- triggers: string;
1192
- }[] | undefined;
1193
- }, {
1194
- name: string;
1195
- entity: {
1196
- name: string;
1197
- fields: {
1198
- type: string;
1199
- name: string;
1200
- required?: boolean | undefined;
1201
- }[];
1202
- persistence: "persistent" | "runtime" | "singleton" | "instance";
1203
- };
1204
- pages?: {
1205
- path: string;
1206
- name: string;
1207
- viewType: string;
1208
- }[] | undefined;
1209
- traits?: string[] | undefined;
1210
- relations?: {
1211
- entity: string;
1212
- cardinality: "many" | "one";
1213
- alias?: string | undefined;
1214
- }[] | undefined;
1215
- patterns?: string[] | undefined;
1216
- domainContext?: {
1217
- request: string;
1218
- category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
1219
- requestFragment?: string | undefined;
1220
- vocabulary?: Record<string, string> | undefined;
1221
- } | undefined;
1222
- design?: {
1223
- style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
1224
- uxHints?: {
1225
- flowPattern?: string | undefined;
1226
- listPattern?: string | undefined;
1227
- formPattern?: string | undefined;
1228
- detailPattern?: string | undefined;
1229
- } | undefined;
1230
- } | undefined;
1231
- emits?: string[] | undefined;
1232
- listens?: {
1233
- event: string;
1234
- triggers: string;
1235
- }[] | undefined;
1236
- }>;
1237
- orbitalIndex: z.ZodOptional<z.ZodNumber>;
1238
- totalOrbitals: z.ZodOptional<z.ZodNumber>;
1239
- }, "strip", z.ZodTypeAny, {
1240
- orbital: {
1241
- traits: string[];
1242
- name: string;
1243
- entity: {
1244
- name: string;
1245
- fields: {
1246
- type: string;
1247
- name: string;
1248
- required?: boolean | undefined;
1249
- }[];
1250
- persistence: "persistent" | "runtime" | "singleton" | "instance";
1251
- };
1252
- pages?: {
1253
- path: string;
1254
- name: string;
1255
- viewType: string;
1256
- }[] | undefined;
1257
- relations?: {
1258
- entity: string;
1259
- cardinality: "many" | "one";
1260
- alias?: string | undefined;
1261
- }[] | undefined;
1262
- patterns?: string[] | undefined;
1263
- domainContext?: {
1264
- request: string;
1265
- category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
1266
- requestFragment?: string | undefined;
1267
- vocabulary?: Record<string, string> | undefined;
1268
- } | undefined;
1269
- design?: {
1270
- style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
1271
- uxHints?: {
1272
- flowPattern?: string | undefined;
1273
- listPattern?: string | undefined;
1274
- formPattern?: string | undefined;
1275
- detailPattern?: string | undefined;
1276
- } | undefined;
1277
- } | undefined;
1278
- emits?: string[] | undefined;
1279
- listens?: {
1280
- event: string;
1281
- triggers: string;
1282
- }[] | undefined;
1283
- };
1284
- orbitalIndex?: number | undefined;
1285
- totalOrbitals?: number | undefined;
1286
- }, {
1287
- orbital: {
1288
- name: string;
1289
- entity: {
1290
- name: string;
1291
- fields: {
1292
- type: string;
1293
- name: string;
1294
- required?: boolean | undefined;
1295
- }[];
1296
- persistence: "persistent" | "runtime" | "singleton" | "instance";
1297
- };
1298
- pages?: {
1299
- path: string;
1300
- name: string;
1301
- viewType: string;
1302
- }[] | undefined;
1303
- traits?: string[] | undefined;
1304
- relations?: {
1305
- entity: string;
1306
- cardinality: "many" | "one";
1307
- alias?: string | undefined;
1308
- }[] | undefined;
1309
- patterns?: string[] | undefined;
1310
- domainContext?: {
1311
- request: string;
1312
- category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
1313
- requestFragment?: string | undefined;
1314
- vocabulary?: Record<string, string> | undefined;
1315
- } | undefined;
1316
- design?: {
1317
- style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
1318
- uxHints?: {
1319
- flowPattern?: string | undefined;
1320
- listPattern?: string | undefined;
1321
- formPattern?: string | undefined;
1322
- detailPattern?: string | undefined;
1323
- } | undefined;
1324
- } | undefined;
1325
- emits?: string[] | undefined;
1326
- listens?: {
1327
- event: string;
1328
- triggers: string;
1329
- }[] | undefined;
1330
- };
1331
- orbitalIndex?: number | undefined;
1332
- totalOrbitals?: number | undefined;
1333
- }>, {
1334
- orbital: {
1335
- traits: string[];
1336
- name: string;
1337
- entity: {
1338
- name: string;
1339
- fields: {
1340
- type: string;
1341
- name: string;
1342
- required?: boolean | undefined;
1343
- }[];
1344
- persistence: "persistent" | "runtime" | "singleton" | "instance";
1345
- };
1346
- pages?: {
1347
- path: string;
1348
- name: string;
1349
- viewType: string;
1350
- }[] | undefined;
1351
- relations?: {
1352
- entity: string;
1353
- cardinality: "many" | "one";
1354
- alias?: string | undefined;
1355
- }[] | undefined;
1356
- patterns?: string[] | undefined;
1357
- domainContext?: {
1358
- request: string;
1359
- category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
1360
- requestFragment?: string | undefined;
1361
- vocabulary?: Record<string, string> | undefined;
1362
- } | undefined;
1363
- design?: {
1364
- style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
1365
- uxHints?: {
1366
- flowPattern?: string | undefined;
1367
- listPattern?: string | undefined;
1368
- formPattern?: string | undefined;
1369
- detailPattern?: string | undefined;
1370
- } | undefined;
1371
- } | undefined;
1372
- emits?: string[] | undefined;
1373
- listens?: {
1374
- event: string;
1375
- triggers: string;
1376
- }[] | undefined;
1377
- };
1378
- orbitalIndex?: number | undefined;
1379
- totalOrbitals?: number | undefined;
1380
- }, {
1381
- orbital: {
1382
- name: string;
1383
- entity: {
1384
- name: string;
1385
- fields: {
1386
- type: string;
1387
- name: string;
1388
- required?: boolean | undefined;
1389
- }[];
1390
- persistence: "persistent" | "runtime" | "singleton" | "instance";
1391
- };
1392
- pages?: {
1393
- path: string;
1394
- name: string;
1395
- viewType: string;
1396
- }[] | undefined;
1397
- traits?: string[] | undefined;
1398
- relations?: {
1399
- entity: string;
1400
- cardinality: "many" | "one";
1401
- alias?: string | undefined;
1402
- }[] | undefined;
1403
- patterns?: string[] | undefined;
1404
- domainContext?: {
1405
- request: string;
1406
- category: "game" | "business" | "dashboard" | "form" | "content" | "social" | "ecommerce" | "workflow";
1407
- requestFragment?: string | undefined;
1408
- vocabulary?: Record<string, string> | undefined;
1409
- } | undefined;
1410
- design?: {
1411
- style?: "minimal" | "modern" | "playful" | "data-driven" | "immersive" | undefined;
1412
- uxHints?: {
1413
- flowPattern?: string | undefined;
1414
- listPattern?: string | undefined;
1415
- formPattern?: string | undefined;
1416
- detailPattern?: string | undefined;
1417
- } | undefined;
1418
- } | undefined;
1419
- emits?: string[] | undefined;
1420
- listens?: {
1421
- event: string;
1422
- triggers: string;
1423
- }[] | undefined;
1424
- };
1425
- orbitalIndex?: number | undefined;
1426
- totalOrbitals?: number | undefined;
1427
- }, string, "generate_orbital">;
1428
- setEventCallback: (callback: SubagentEventCallback) => void;
1429
- setOrbitalCompleteCallback: (callback: OrbitalCompleteCallback) => void;
1430
- };
1431
- /**
1432
- * Create a helper to wrap subagent events into SSE format.
1433
- */
1434
- declare function createSubagentEventWrapper(writeEvent: (event: SSEEvent) => void): SubagentEventCallback;
1435
-
1436
- export { type DomainOrbitalEventCallback as D, type OrbitalCompleteCallback as O, type SubagentEventCallback as S, type DomainOrbitalCompleteCallback as a, type DomainOrbitalSpec as b, type DomainOrbitalToolOptions as c, type OrbitalRequirements as d, type OrbitalSubagentToolOptions as e, createConstructCombinedDomainTool as f, createDomainOrbitalTools as g, createGenerateOrbitalDomainTool as h, createOrbitalSubagentTool as i, createSubagentEventWrapper as j };
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Execute Tool
3
+ *
4
+ * Sandboxed shell command execution within a workspace directory.
5
+ *
6
+ * @packageDocumentation
7
+ */
8
+ import { z } from 'zod';
9
+ import type { AuditLog } from '../security/audit-log.js';
10
+ /**
11
+ * Check if a command contains paths outside the workspace.
12
+ * Returns an error message if unsafe, null if safe.
13
+ */
14
+ export declare function validateCommandPaths(command: string, workDir: string): string | null;
15
+ /**
16
+ * Create an execute tool that runs shell commands in the workspace directory.
17
+ *
18
+ * @param workDir Workspace directory — commands are sandboxed to this path.
19
+ * @param auditLog Optional audit chain. When provided, every execution attempt
20
+ * (blocked or successful) is recorded with command, gate
21
+ * classification, exit code, and output length.
22
+ */
23
+ export declare function createExecuteTool(workDir: string, auditLog?: AuditLog): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
24
+ command: z.ZodString;
25
+ timeout: z.ZodOptional<z.ZodNumber>;
26
+ }, "strip", z.ZodTypeAny, {
27
+ command: string;
28
+ timeout?: number | undefined;
29
+ }, {
30
+ command: string;
31
+ timeout?: number | undefined;
32
+ }>, {
33
+ command: string;
34
+ timeout?: number | undefined;
35
+ }, {
36
+ command: string;
37
+ timeout?: number | undefined;
38
+ }, string, "execute">;
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Finish Task Tool
3
+ *
4
+ * Signals the agent has completed the workflow. Automatically combines
5
+ * orbitals and validates the result.
6
+ *
7
+ * @packageDocumentation
8
+ */
9
+ import { z } from 'zod';
10
+ /**
11
+ * Create a finish_task tool that signals the agent has completed the workflow.
12
+ *
13
+ * Automatically combines orbitals from:
14
+ * 1. .orbitals/ directory (for kflow-orbitals skill)
15
+ * 2. domain.txt (for lean skills) - converted to schema via convertDomainToSchema
16
+ */
17
+ export declare function createFinishTaskTool(workDir: string | undefined): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
18
+ summary: z.ZodString;
19
+ schemaPath: z.ZodOptional<z.ZodString>;
20
+ }, "strip", z.ZodTypeAny, {
21
+ summary: string;
22
+ schemaPath?: string | undefined;
23
+ }, {
24
+ summary: string;
25
+ schemaPath?: string | undefined;
26
+ }>, {
27
+ summary: string;
28
+ schemaPath?: string | undefined;
29
+ }, {
30
+ summary: string;
31
+ schemaPath?: string | undefined;
32
+ }, {
33
+ success: boolean;
34
+ status: string;
35
+ message: string;
36
+ summary: string;
37
+ autoCombined: boolean;
38
+ source: "domain" | "orbitals" | undefined;
39
+ stats: {
40
+ totalOrbitals: number;
41
+ totalEntities: number;
42
+ totalPages: number;
43
+ totalTraits: number;
44
+ } | undefined;
45
+ validation: {
46
+ valid: boolean;
47
+ errorCount: number;
48
+ warningCount: number;
49
+ } | undefined;
50
+ designQuality: {
51
+ propCorrections: number;
52
+ compositionWarnings: string[];
53
+ };
54
+ schemaPath: string | undefined;
55
+ nextAction: string;
56
+ }, "finish_task">;
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Schema Generation Tool (via Structured Output LLM)
3
+ *
4
+ * Generates KFlow schemas using OpenAI's structured output mode.
5
+ * Uses @almadar/llm StructuredOutputClient directly.
6
+ *
7
+ * @packageDocumentation
8
+ */
9
+ import { z } from 'zod';
10
+ /**
11
+ * Create a tool that generates KFlow schemas using structured output.
12
+ */
13
+ export declare function createGenerateSchemaTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
14
+ userRequest: z.ZodString;
15
+ suggestedTraits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
16
+ suggestedEntities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
17
+ suggestedPages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
18
+ suggestedPatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
19
+ additionalInstructions: z.ZodOptional<z.ZodString>;
20
+ existingSchema: z.ZodOptional<z.ZodString>;
21
+ }, "strip", z.ZodTypeAny, {
22
+ userRequest: string;
23
+ suggestedTraits?: string[] | undefined;
24
+ suggestedEntities?: string[] | undefined;
25
+ suggestedPages?: string[] | undefined;
26
+ suggestedPatterns?: string[] | undefined;
27
+ additionalInstructions?: string | undefined;
28
+ existingSchema?: string | undefined;
29
+ }, {
30
+ userRequest: string;
31
+ suggestedTraits?: string[] | undefined;
32
+ suggestedEntities?: string[] | undefined;
33
+ suggestedPages?: string[] | undefined;
34
+ suggestedPatterns?: string[] | undefined;
35
+ additionalInstructions?: string | undefined;
36
+ existingSchema?: string | undefined;
37
+ }>, {
38
+ userRequest: string;
39
+ suggestedTraits?: string[] | undefined;
40
+ suggestedEntities?: string[] | undefined;
41
+ suggestedPages?: string[] | undefined;
42
+ suggestedPatterns?: string[] | undefined;
43
+ additionalInstructions?: string | undefined;
44
+ existingSchema?: string | undefined;
45
+ }, {
46
+ userRequest: string;
47
+ suggestedTraits?: string[] | undefined;
48
+ suggestedEntities?: string[] | undefined;
49
+ suggestedPages?: string[] | undefined;
50
+ suggestedPatterns?: string[] | undefined;
51
+ additionalInstructions?: string | undefined;
52
+ existingSchema?: string | undefined;
53
+ }, string, "generate_schema">;