@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.
- package/LICENSE +21 -72
- package/README.md +25 -0
- package/dist/agent/event-budget.d.ts +28 -0
- package/dist/agent/experimental/hitl-v2.d.ts +161 -0
- package/dist/agent/experimental/hitl-workflow-integration.d.ts +182 -0
- package/dist/agent/index.d.ts +14 -13
- package/dist/agent/index.js.map +1 -1
- package/dist/agent/interrupt-config.d.ts +51 -0
- package/dist/agent/session-manager.d.ts +204 -0
- package/dist/agent/skill-agent.d.ts +182 -0
- package/dist/agent/workflow-middleware.d.ts +63 -0
- package/dist/agent/workflow-tool-wrapper.d.ts +87 -0
- package/dist/{api-types-CXrq-fts.d.ts → api-types.d.ts} +85 -51
- package/dist/context/compaction.d.ts +191 -0
- package/dist/context-compaction.d.ts +55 -0
- package/dist/evals/online-sampling.d.ts +114 -0
- package/dist/evals/utils/compact-orbital.d.ts +100 -0
- package/dist/event-transformer/event-transformer.d.ts +120 -0
- package/dist/event-transformer/index.d.ts +4 -122
- package/dist/events.d.ts +85 -0
- package/dist/index.d.ts +58 -1678
- package/dist/index.js +39 -0
- package/dist/index.js.map +1 -1
- package/dist/memory/MemoryManager.d.ts +243 -0
- package/dist/memory/PreferenceLearner.d.ts +59 -0
- package/dist/memory/agentic-search.d.ts +116 -0
- package/dist/memory/index.d.ts +14 -0
- package/dist/memory/memory-orbital.d.ts +66 -0
- package/dist/memory/types.d.ts +143 -0
- package/dist/metrics.d.ts +77 -0
- package/dist/multi-user.d.ts +155 -0
- package/dist/observability/index.d.ts +14 -0
- package/dist/observability/langsmith-integration.d.ts +203 -0
- package/dist/observability.d.ts +196 -0
- package/dist/orbitals/archive/sanitize.d.ts +24 -0
- package/dist/orbitals/batch/batch-generator.d.ts +41 -0
- package/dist/orbitals/batch/concurrency.d.ts +54 -0
- package/dist/orbitals/batch/index.d.ts +14 -0
- package/dist/orbitals/batch/prompt-assembler.d.ts +92 -0
- package/dist/orbitals/batch/types.d.ts +103 -0
- package/dist/orbitals/cache/index.d.ts +11 -0
- package/dist/orbitals/cache/orbital-fingerprint.d.ts +37 -0
- package/dist/orbitals/cache/prompt-assembler.d.ts +65 -0
- package/dist/orbitals/cache/structural-templates.d.ts +33 -0
- package/dist/orbitals/combiner/index.d.ts +102 -0
- package/dist/orbitals/domain-language/index.d.ts +9 -0
- package/dist/orbitals/domain-language/prompts/index.d.ts +11 -0
- package/dist/orbitals/domain-language/prompts/odl-examples.d.ts +8 -0
- package/dist/orbitals/domain-language/prompts/odl-patterns.d.ts +8 -0
- package/dist/orbitals/domain-language/prompts/odl-syntax.d.ts +8 -0
- package/dist/orbitals/domain-language/prompts/odl-to-schema.d.ts +8 -0
- package/dist/orbitals/generation/index.d.ts +10 -0
- package/dist/orbitals/generation/orbital-generator.d.ts +120 -0
- package/dist/orbitals/shared/constants.d.ts +65 -0
- package/dist/orbitals/shared/index.d.ts +11 -0
- package/dist/orbitals/shared/types.d.ts +187 -0
- package/dist/orbitals/shared/utils.d.ts +97 -0
- package/dist/orchestration/complexity-classifier.d.ts +38 -0
- package/dist/orchestration/fixing-orchestrator.d.ts +53 -0
- package/dist/orchestration/index.d.ts +31 -0
- package/dist/orchestration/provider-router.d.ts +45 -0
- package/dist/{firestore-checkpointer-CkNKXoun.d.ts → persistence/firestore-checkpointer.d.ts} +13 -58
- package/dist/persistence/firestore-session-store.d.ts +75 -0
- package/dist/persistence/firestore-store.d.ts +86 -0
- package/dist/persistence/index.d.ts +7 -198
- package/dist/persistence/memory-backend.d.ts +33 -0
- package/dist/persistence/types.d.ts +40 -0
- package/dist/security/audit-log.d.ts +44 -0
- package/dist/state-sync.d.ts +171 -0
- package/dist/subagents.d.ts +38 -0
- package/dist/tools/combine-schemas.d.ts +154 -0
- package/dist/tools/composition.d.ts +119 -0
- package/dist/{orbital-subagent-BdFuf77p.d.ts → tools/domain-orbital.d.ts} +22 -461
- package/dist/tools/execute.d.ts +38 -0
- package/dist/tools/finish-task.d.ts +56 -0
- package/dist/tools/generate-schema.d.ts +53 -0
- package/dist/tools/github.d.ts +297 -0
- package/dist/tools/index.d.ts +1318 -8
- package/dist/tools/orbital-batch-subagent.d.ts +85 -0
- package/dist/tools/orbital-subagent.d.ts +454 -0
- package/dist/tools/orchestrated-fixing.d.ts +74 -0
- package/dist/tools/orchestrated-generation.d.ts +75 -0
- package/dist/tools/sandbox-executor.d.ts +31 -0
- package/dist/tools/schema-chunking.d.ts +117 -0
- package/dist/tools/trait-subagent.d.ts +179 -0
- package/dist/tools/validate-schema.d.ts +17 -0
- package/dist/types.d.ts +14 -17
- package/dist/utils/safety/capability-token.d.ts +50 -0
- package/dist/utils/safety/circuit-breaker.d.ts +71 -0
- package/dist/utils/safety/index.d.ts +19 -0
- package/dist/utils/safety/rate-limiter.d.ts +39 -0
- package/dist/utils/safety/threshold-auth.d.ts +70 -0
- package/dist/workspace/git-client.d.ts +51 -0
- package/dist/workspace/index.d.ts +29 -346
- package/dist/workspace/index.js +39 -0
- package/dist/workspace/index.js.map +1 -1
- package/dist/workspace/memory-files.d.ts +31 -0
- package/dist/workspace/sink-manager.d.ts +26 -0
- package/dist/workspace/sinks/firestore-sink.d.ts +41 -0
- package/dist/workspace/sinks/git-sink.d.ts +47 -0
- package/dist/workspace/sinks/index.d.ts +9 -0
- package/dist/workspace/templates.d.ts +32 -0
- package/dist/workspace/types.d.ts +86 -0
- package/dist/workspace/workspace-manager.d.ts +57 -0
- package/package.json +12 -10
- package/dist/index-DW3F-Ihx.d.ts +0 -2501
- package/dist/index-DZn69no8.d.ts +0 -1014
|
@@ -1,16 +1,22 @@
|
|
|
1
|
-
|
|
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 {
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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">;
|