pocket-agent 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +140 -0
- package/dist/adapters/createLLMEvaluator.d.ts +19 -0
- package/dist/adapters/createLLMEvaluator.d.ts.map +1 -0
- package/dist/adapters/createLLMEvaluator.js +150 -0
- package/dist/adapters/createLLMEvaluator.js.map +1 -0
- package/dist/adapters/models/anthropic.d.ts +15 -0
- package/dist/adapters/models/anthropic.d.ts.map +1 -0
- package/dist/adapters/models/anthropic.js +45 -0
- package/dist/adapters/models/anthropic.js.map +1 -0
- package/dist/adapters/models/gemini.d.ts +16 -0
- package/dist/adapters/models/gemini.d.ts.map +1 -0
- package/dist/adapters/models/gemini.js +58 -0
- package/dist/adapters/models/gemini.js.map +1 -0
- package/dist/adapters/models/lmStudioStreaming.d.ts +21 -0
- package/dist/adapters/models/lmStudioStreaming.d.ts.map +1 -0
- package/dist/adapters/models/lmStudioStreaming.js +90 -0
- package/dist/adapters/models/lmStudioStreaming.js.map +1 -0
- package/dist/adapters/models/lmstudio.d.ts +20 -0
- package/dist/adapters/models/lmstudio.d.ts.map +1 -0
- package/dist/adapters/models/lmstudio.js +59 -0
- package/dist/adapters/models/lmstudio.js.map +1 -0
- package/dist/adapters/models/ollama.d.ts +22 -0
- package/dist/adapters/models/ollama.d.ts.map +1 -0
- package/dist/adapters/models/ollama.js +61 -0
- package/dist/adapters/models/ollama.js.map +1 -0
- package/dist/adapters/models/ollamaStreaming.d.ts +30 -0
- package/dist/adapters/models/ollamaStreaming.d.ts.map +1 -0
- package/dist/adapters/models/ollamaStreaming.js +88 -0
- package/dist/adapters/models/ollamaStreaming.js.map +1 -0
- package/dist/adapters/models/openai.d.ts +17 -0
- package/dist/adapters/models/openai.d.ts.map +1 -0
- package/dist/adapters/models/openai.js +50 -0
- package/dist/adapters/models/openai.js.map +1 -0
- package/dist/defaults/defaultExecutor.d.ts +20 -0
- package/dist/defaults/defaultExecutor.d.ts.map +1 -0
- package/dist/defaults/defaultExecutor.js +67 -0
- package/dist/defaults/defaultExecutor.js.map +1 -0
- package/dist/defaults/llmPlanner.d.ts +20 -0
- package/dist/defaults/llmPlanner.d.ts.map +1 -0
- package/dist/defaults/llmPlanner.js +151 -0
- package/dist/defaults/llmPlanner.js.map +1 -0
- package/dist/defaults/planBuilder.d.ts +48 -0
- package/dist/defaults/planBuilder.d.ts.map +1 -0
- package/dist/defaults/planBuilder.js +105 -0
- package/dist/defaults/planBuilder.js.map +1 -0
- package/dist/defaults/singleStepPlanner.d.ts +17 -0
- package/dist/defaults/singleStepPlanner.d.ts.map +1 -0
- package/dist/defaults/singleStepPlanner.js +52 -0
- package/dist/defaults/singleStepPlanner.js.map +1 -0
- package/dist/evaluator/StepEvaluator.d.ts +9 -0
- package/dist/evaluator/StepEvaluator.d.ts.map +1 -0
- package/dist/evaluator/StepEvaluator.js +5 -0
- package/dist/evaluator/StepEvaluator.js.map +1 -0
- package/dist/events/EventBus.d.ts +13 -0
- package/dist/events/EventBus.d.ts.map +1 -0
- package/dist/events/EventBus.js +34 -0
- package/dist/events/EventBus.js.map +1 -0
- package/dist/executor/StepExecutor.d.ts +9 -0
- package/dist/executor/StepExecutor.d.ts.map +1 -0
- package/dist/executor/StepExecutor.js +5 -0
- package/dist/executor/StepExecutor.js.map +1 -0
- package/dist/index.d.ts +48 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +22 -0
- package/dist/index.js.map +1 -0
- package/dist/models/ModelAdapter.d.ts +5 -0
- package/dist/models/ModelAdapter.d.ts.map +1 -0
- package/dist/models/ModelAdapter.js +5 -0
- package/dist/models/ModelAdapter.js.map +1 -0
- package/dist/planner/PlanValidator.d.ts +16 -0
- package/dist/planner/PlanValidator.d.ts.map +1 -0
- package/dist/planner/PlanValidator.js +44 -0
- package/dist/planner/PlanValidator.js.map +1 -0
- package/dist/planner/Planner.d.ts +10 -0
- package/dist/planner/Planner.d.ts.map +1 -0
- package/dist/planner/Planner.js +5 -0
- package/dist/planner/Planner.js.map +1 -0
- package/dist/quickStart.d.ts +49 -0
- package/dist/quickStart.d.ts.map +1 -0
- package/dist/quickStart.js +77 -0
- package/dist/quickStart.js.map +1 -0
- package/dist/runner/AgentRunner.d.ts +29 -0
- package/dist/runner/AgentRunner.d.ts.map +1 -0
- package/dist/runner/AgentRunner.js +223 -0
- package/dist/runner/AgentRunner.js.map +1 -0
- package/dist/runner/RunStateManager.d.ts +21 -0
- package/dist/runner/RunStateManager.d.ts.map +1 -0
- package/dist/runner/RunStateManager.js +96 -0
- package/dist/runner/RunStateManager.js.map +1 -0
- package/dist/runner/RunningExecution.d.ts +14 -0
- package/dist/runner/RunningExecution.d.ts.map +1 -0
- package/dist/runner/RunningExecution.js +5 -0
- package/dist/runner/RunningExecution.js.map +1 -0
- package/dist/runner/StepScheduler.d.ts +12 -0
- package/dist/runner/StepScheduler.d.ts.map +1 -0
- package/dist/runner/StepScheduler.js +42 -0
- package/dist/runner/StepScheduler.js.map +1 -0
- package/dist/runner/createAgentRunner.d.ts +32 -0
- package/dist/runner/createAgentRunner.d.ts.map +1 -0
- package/dist/runner/createAgentRunner.js +57 -0
- package/dist/runner/createAgentRunner.js.map +1 -0
- package/dist/runner/resolveInputs.d.ts +7 -0
- package/dist/runner/resolveInputs.d.ts.map +1 -0
- package/dist/runner/resolveInputs.js +28 -0
- package/dist/runner/resolveInputs.js.map +1 -0
- package/dist/tools/ToolAdapter.d.ts +5 -0
- package/dist/tools/ToolAdapter.d.ts.map +1 -0
- package/dist/tools/ToolAdapter.js +5 -0
- package/dist/tools/ToolAdapter.js.map +1 -0
- package/dist/types/errors.d.ts +28 -0
- package/dist/types/errors.d.ts.map +1 -0
- package/dist/types/errors.js +37 -0
- package/dist/types/errors.js.map +1 -0
- package/dist/types/evaluator.d.ts +14 -0
- package/dist/types/evaluator.d.ts.map +1 -0
- package/dist/types/evaluator.js +5 -0
- package/dist/types/evaluator.js.map +1 -0
- package/dist/types/events.d.ts +79 -0
- package/dist/types/events.d.ts.map +1 -0
- package/dist/types/events.js +17 -0
- package/dist/types/events.js.map +1 -0
- package/dist/types/executor.d.ts +18 -0
- package/dist/types/executor.d.ts.map +1 -0
- package/dist/types/executor.js +5 -0
- package/dist/types/executor.js.map +1 -0
- package/dist/types/models.d.ts +18 -0
- package/dist/types/models.d.ts.map +1 -0
- package/dist/types/models.js +6 -0
- package/dist/types/models.js.map +1 -0
- package/dist/types/plan.d.ts +37 -0
- package/dist/types/plan.d.ts.map +1 -0
- package/dist/types/plan.js +5 -0
- package/dist/types/plan.js.map +1 -0
- package/dist/types/planner.d.ts +24 -0
- package/dist/types/planner.d.ts.map +1 -0
- package/dist/types/planner.js +5 -0
- package/dist/types/planner.js.map +1 -0
- package/dist/types/run.d.ts +48 -0
- package/dist/types/run.d.ts.map +1 -0
- package/dist/types/run.js +14 -0
- package/dist/types/run.js.map +1 -0
- package/dist/types/step.d.ts +52 -0
- package/dist/types/step.d.ts.map +1 -0
- package/dist/types/step.js +5 -0
- package/dist/types/step.js.map +1 -0
- package/dist/types/tools.d.ts +21 -0
- package/dist/types/tools.d.ts.map +1 -0
- package/dist/types/tools.js +5 -0
- package/dist/types/tools.js.map +1 -0
- package/dist/utils/dag.d.ts +18 -0
- package/dist/utils/dag.d.ts.map +1 -0
- package/dist/utils/dag.js +77 -0
- package/dist/utils/dag.js.map +1 -0
- package/dist/utils/ids.d.ts +6 -0
- package/dist/utils/ids.d.ts.map +1 -0
- package/dist/utils/ids.js +11 -0
- package/dist/utils/ids.js.map +1 -0
- package/dist/utils/schema.d.ts +15 -0
- package/dist/utils/schema.d.ts.map +1 -0
- package/dist/utils/schema.js +11 -0
- package/dist/utils/schema.js.map +1 -0
- package/dist/utils/time.d.ts +6 -0
- package/dist/utils/time.d.ts.map +1 -0
- package/dist/utils/time.js +10 -0
- package/dist/utils/time.js.map +1 -0
- package/package.json +50 -0
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Factory for AgentRunner (spec §23.1).
|
|
3
|
+
*/
|
|
4
|
+
import { AgentRunner } from "./AgentRunner.js";
|
|
5
|
+
import { RunStateManager } from "./RunStateManager.js";
|
|
6
|
+
import { EventBus } from "../events/EventBus.js";
|
|
7
|
+
import { createLLMEvaluator } from "../adapters/createLLMEvaluator.js";
|
|
8
|
+
import { createOpenAIModelAdapter } from "../adapters/models/openai.js";
|
|
9
|
+
import { createAnthropicModelAdapter } from "../adapters/models/anthropic.js";
|
|
10
|
+
import { createGeminiModelAdapter } from "../adapters/models/gemini.js";
|
|
11
|
+
import { createOllamaModelAdapter } from "../adapters/models/ollama.js";
|
|
12
|
+
import { createLmStudioModelAdapter } from "../adapters/models/lmstudio.js";
|
|
13
|
+
function resolveModelAndEvaluator(config) {
|
|
14
|
+
if (config.evaluator) {
|
|
15
|
+
return { model: config.model, evaluator: config.evaluator };
|
|
16
|
+
}
|
|
17
|
+
if (!config.provider) {
|
|
18
|
+
throw new Error("AgentRunnerConfig: provide either evaluator or provider (openai | anthropic | gemini | ollama | lmstudio). Install the SDK for your provider (e.g. npm install openai).");
|
|
19
|
+
}
|
|
20
|
+
const modelConfig = config.modelConfig ?? {};
|
|
21
|
+
let model;
|
|
22
|
+
switch (config.provider) {
|
|
23
|
+
case "openai":
|
|
24
|
+
model = createOpenAIModelAdapter(modelConfig);
|
|
25
|
+
break;
|
|
26
|
+
case "anthropic":
|
|
27
|
+
model = createAnthropicModelAdapter(modelConfig);
|
|
28
|
+
break;
|
|
29
|
+
case "gemini":
|
|
30
|
+
model = createGeminiModelAdapter(modelConfig);
|
|
31
|
+
break;
|
|
32
|
+
case "ollama":
|
|
33
|
+
model = createOllamaModelAdapter(modelConfig);
|
|
34
|
+
break;
|
|
35
|
+
case "lmstudio":
|
|
36
|
+
model = createLmStudioModelAdapter(modelConfig);
|
|
37
|
+
break;
|
|
38
|
+
default:
|
|
39
|
+
throw new Error(`Unknown provider: ${config.provider}`);
|
|
40
|
+
}
|
|
41
|
+
const evaluator = createLLMEvaluator(model);
|
|
42
|
+
return { model, evaluator };
|
|
43
|
+
}
|
|
44
|
+
export function createAgentRunner(config) {
|
|
45
|
+
const { model, evaluator } = resolveModelAndEvaluator(config);
|
|
46
|
+
const stateManager = new RunStateManager();
|
|
47
|
+
const eventBus = new EventBus();
|
|
48
|
+
return new AgentRunner({
|
|
49
|
+
planner: config.planner,
|
|
50
|
+
executor: config.executor,
|
|
51
|
+
evaluator,
|
|
52
|
+
tools: config.tools,
|
|
53
|
+
model,
|
|
54
|
+
defaultOptions: config.defaultOptions,
|
|
55
|
+
}, stateManager, eventBus);
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=createAgentRunner.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"createAgentRunner.js","sourceRoot":"","sources":["../../src/runner/createAgentRunner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AA4B5E,SAAS,wBAAwB,CAAC,MAAyB;IAIzD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,yKAAyK,CAC1K,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IAC7C,IAAI,KAAmB,CAAC;IACxB,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ;YACX,KAAK,GAAG,wBAAwB,CAAC,WAAgC,CAAC,CAAC;YACnE,MAAM;QACR,KAAK,WAAW;YACd,KAAK,GAAG,2BAA2B,CAAC,WAAmC,CAAC,CAAC;YACzE,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,GAAG,wBAAwB,CAAC,WAAgC,CAAC,CAAC;YACnE,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,GAAG,wBAAwB,CAAC,WAAgC,CAAC,CAAC;YACnE,MAAM;QACR,KAAK,UAAU;YACb,KAAK,GAAG,0BAA0B,CAAC,WAAkC,CAAC,CAAC;YACvE,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,OAAO,IAAI,WAAW,CACpB;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS;QACT,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK;QACL,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,EACD,YAAY,EACZ,QAAQ,CACT,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Resolves step inputs from run context and prior step outputs (spec §5.2).
|
|
3
|
+
*/
|
|
4
|
+
import type { StepInputRef } from "../types/plan.js";
|
|
5
|
+
import type { StepRunRecord } from "../types/step.js";
|
|
6
|
+
export declare function resolveInputs(inputs: StepInputRef[], runContext: Record<string, unknown>, steps: Record<string, StepRunRecord>): Record<string, unknown>;
|
|
7
|
+
//# sourceMappingURL=resolveInputs.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolveInputs.d.ts","sourceRoot":"","sources":["../../src/runner/resolveInputs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EAAE,EACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Resolves step inputs from run context and prior step outputs (spec §5.2).
|
|
3
|
+
*/
|
|
4
|
+
export function resolveInputs(inputs, runContext, steps) {
|
|
5
|
+
const resolved = {};
|
|
6
|
+
for (const ref of inputs) {
|
|
7
|
+
let value;
|
|
8
|
+
if (ref.source === "runContext") {
|
|
9
|
+
value = runContext[ref.key];
|
|
10
|
+
}
|
|
11
|
+
else if (ref.source === "stepOutput" && ref.stepId) {
|
|
12
|
+
const record = steps[ref.stepId];
|
|
13
|
+
value = record?.finalOutput ? record.finalOutput[ref.key] : undefined;
|
|
14
|
+
}
|
|
15
|
+
else if (ref.source === "artifact" && ref.stepId) {
|
|
16
|
+
const record = steps[ref.stepId];
|
|
17
|
+
const artifacts = record?.finalArtifacts ?? [];
|
|
18
|
+
const found = artifacts.find((a) => a.key === ref.key || a.id === ref.key);
|
|
19
|
+
value = found ?? undefined;
|
|
20
|
+
}
|
|
21
|
+
else {
|
|
22
|
+
value = undefined;
|
|
23
|
+
}
|
|
24
|
+
resolved[ref.key] = value;
|
|
25
|
+
}
|
|
26
|
+
return resolved;
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=resolveInputs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolveInputs.js","sourceRoot":"","sources":["../../src/runner/resolveInputs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,UAAU,aAAa,CAC3B,MAAsB,EACtB,UAAmC,EACnC,KAAoC;IAEpC,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,KAAc,CAAC;QACnB,IAAI,GAAG,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAChC,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,KAAK,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACjC,KAAK,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,SAAS,GAAG,MAAM,EAAE,cAAc,IAAI,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAsB,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YACjG,KAAK,GAAG,KAAK,IAAI,SAAS,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,SAAS,CAAC;QACpB,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC5B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ToolAdapter.d.ts","sourceRoot":"","sources":["../../src/tools/ToolAdapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ToolAdapter.js","sourceRoot":"","sources":["../../src/tools/ToolAdapter.ts"],"names":[],"mappings":"AAAA;;GAEG"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Typed failure errors (spec §17).
|
|
3
|
+
*/
|
|
4
|
+
export declare class PlanningFailureError extends Error {
|
|
5
|
+
readonly code = "PLANNING_FAILURE";
|
|
6
|
+
readonly errors: string[];
|
|
7
|
+
constructor(message: string, errors?: string[]);
|
|
8
|
+
}
|
|
9
|
+
export declare class ExecutionFailureError extends Error {
|
|
10
|
+
readonly code = "EXECUTION_FAILURE";
|
|
11
|
+
readonly stepId?: string;
|
|
12
|
+
readonly details?: unknown;
|
|
13
|
+
constructor(message: string, options?: {
|
|
14
|
+
stepId?: string;
|
|
15
|
+
details?: unknown;
|
|
16
|
+
});
|
|
17
|
+
}
|
|
18
|
+
export declare class EvaluationFailureError extends Error {
|
|
19
|
+
readonly code = "EVALUATION_FAILURE";
|
|
20
|
+
readonly stepId?: string;
|
|
21
|
+
constructor(message: string, stepId?: string);
|
|
22
|
+
}
|
|
23
|
+
export declare class RunFailureError extends Error {
|
|
24
|
+
readonly code = "RUN_FAILURE";
|
|
25
|
+
readonly runId?: string;
|
|
26
|
+
constructor(message: string, runId?: string);
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=errors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,EAAO;CAKnD;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;CAM9E;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAK7C;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAK5C"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Typed failure errors (spec §17).
|
|
3
|
+
*/
|
|
4
|
+
export class PlanningFailureError extends Error {
|
|
5
|
+
constructor(message, errors = []) {
|
|
6
|
+
super(message);
|
|
7
|
+
this.code = "PLANNING_FAILURE";
|
|
8
|
+
this.name = "PlanningFailureError";
|
|
9
|
+
this.errors = errors;
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
export class ExecutionFailureError extends Error {
|
|
13
|
+
constructor(message, options) {
|
|
14
|
+
super(message);
|
|
15
|
+
this.code = "EXECUTION_FAILURE";
|
|
16
|
+
this.name = "ExecutionFailureError";
|
|
17
|
+
this.stepId = options?.stepId;
|
|
18
|
+
this.details = options?.details;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
export class EvaluationFailureError extends Error {
|
|
22
|
+
constructor(message, stepId) {
|
|
23
|
+
super(message);
|
|
24
|
+
this.code = "EVALUATION_FAILURE";
|
|
25
|
+
this.name = "EvaluationFailureError";
|
|
26
|
+
this.stepId = stepId;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
export class RunFailureError extends Error {
|
|
30
|
+
constructor(message, runId) {
|
|
31
|
+
super(message);
|
|
32
|
+
this.code = "RUN_FAILURE";
|
|
33
|
+
this.name = "RunFailureError";
|
|
34
|
+
this.runId = runId;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=errors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAI7C,YAAY,OAAe,EAAE,SAAmB,EAAE;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAG,kBAAkB,CAAC;QAKjC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAK9C,YAAY,OAAe,EAAE,OAAgD;QAC3E,KAAK,CAAC,OAAO,CAAC,CAAC;QALR,SAAI,GAAG,mBAAmB,CAAC;QAMlC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAI/C,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAG,oBAAoB,CAAC;QAKnC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAIxC,YAAY,OAAe,EAAE,KAAc;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAG,aAAa,CAAC;QAK5B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Step evaluator contract input (spec §12).
|
|
3
|
+
*/
|
|
4
|
+
import type { StepDefinition } from "./plan.js";
|
|
5
|
+
import type { StepAttemptResult } from "./step.js";
|
|
6
|
+
import type { EvaluationResult } from "./step.js";
|
|
7
|
+
export interface StepEvaluationInput {
|
|
8
|
+
runId: string;
|
|
9
|
+
step: StepDefinition;
|
|
10
|
+
attemptResult: StepAttemptResult;
|
|
11
|
+
priorAttempts: StepAttemptResult[];
|
|
12
|
+
}
|
|
13
|
+
export type { EvaluationResult };
|
|
14
|
+
//# sourceMappingURL=evaluator.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/types/evaluator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,CAAC;IACrB,aAAa,EAAE,iBAAiB,CAAC;IACjC,aAAa,EAAE,iBAAiB,EAAE,CAAC;CACpC;AAED,YAAY,EAAE,gBAAgB,EAAE,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../src/types/evaluator.ts"],"names":[],"mappings":"AAAA;;GAEG"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Event payload types (spec §16).
|
|
3
|
+
*/
|
|
4
|
+
import type { Plan } from "./plan.js";
|
|
5
|
+
export interface RunStartedEvent {
|
|
6
|
+
type: "run.started";
|
|
7
|
+
runId: string;
|
|
8
|
+
timestamp: string;
|
|
9
|
+
}
|
|
10
|
+
export interface PlanCreatedEvent {
|
|
11
|
+
type: "plan.created";
|
|
12
|
+
runId: string;
|
|
13
|
+
plan: Plan;
|
|
14
|
+
timestamp: string;
|
|
15
|
+
}
|
|
16
|
+
export interface PlanRevisedEvent {
|
|
17
|
+
type: "plan.revised";
|
|
18
|
+
runId: string;
|
|
19
|
+
plan: Plan;
|
|
20
|
+
timestamp: string;
|
|
21
|
+
}
|
|
22
|
+
export interface StepReadyEvent {
|
|
23
|
+
type: "step.ready";
|
|
24
|
+
runId: string;
|
|
25
|
+
stepId: string;
|
|
26
|
+
timestamp: string;
|
|
27
|
+
}
|
|
28
|
+
export interface StepStartedEvent {
|
|
29
|
+
type: "step.started";
|
|
30
|
+
runId: string;
|
|
31
|
+
stepId: string;
|
|
32
|
+
attempt: number;
|
|
33
|
+
timestamp: string;
|
|
34
|
+
}
|
|
35
|
+
export interface StepRetryingEvent {
|
|
36
|
+
type: "step.retrying";
|
|
37
|
+
runId: string;
|
|
38
|
+
stepId: string;
|
|
39
|
+
attempt: number;
|
|
40
|
+
timestamp: string;
|
|
41
|
+
}
|
|
42
|
+
export interface StepCompletedEvent {
|
|
43
|
+
type: "step.completed";
|
|
44
|
+
runId: string;
|
|
45
|
+
stepId: string;
|
|
46
|
+
attempt: number;
|
|
47
|
+
outputs: Record<string, unknown>;
|
|
48
|
+
timestamp: string;
|
|
49
|
+
}
|
|
50
|
+
export interface StepBlockedEvent {
|
|
51
|
+
type: "step.blocked";
|
|
52
|
+
runId: string;
|
|
53
|
+
stepId: string;
|
|
54
|
+
timestamp: string;
|
|
55
|
+
}
|
|
56
|
+
export interface StepFailedEvent {
|
|
57
|
+
type: "step.failed";
|
|
58
|
+
runId: string;
|
|
59
|
+
stepId: string;
|
|
60
|
+
attempt: number;
|
|
61
|
+
error?: unknown;
|
|
62
|
+
timestamp: string;
|
|
63
|
+
}
|
|
64
|
+
export interface RunCompletedEvent {
|
|
65
|
+
type: "run.completed";
|
|
66
|
+
runId: string;
|
|
67
|
+
outputs: Record<string, unknown>;
|
|
68
|
+
timestamp: string;
|
|
69
|
+
}
|
|
70
|
+
export interface RunFailedEvent {
|
|
71
|
+
type: "run.failed";
|
|
72
|
+
runId: string;
|
|
73
|
+
error?: unknown;
|
|
74
|
+
timestamp: string;
|
|
75
|
+
}
|
|
76
|
+
export type AgentRunnerEvent = RunStartedEvent | PlanCreatedEvent | PlanRevisedEvent | StepReadyEvent | StepStartedEvent | StepRetryingEvent | StepCompletedEvent | StepBlockedEvent | StepFailedEvent | RunCompletedEvent | RunFailedEvent;
|
|
77
|
+
export declare const EVENT_NAMES: readonly ["run.started", "plan.created", "plan.revised", "step.ready", "step.started", "step.retrying", "step.completed", "step.blocked", "step.failed", "run.completed", "run.failed"];
|
|
78
|
+
export type EventName = (typeof EVENT_NAMES)[number];
|
|
79
|
+
//# sourceMappingURL=events.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,iBAAiB,GACjB,cAAc,CAAC;AAEnB,eAAO,MAAM,WAAW,yLAYd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Event payload types (spec §16).
|
|
3
|
+
*/
|
|
4
|
+
export const EVENT_NAMES = [
|
|
5
|
+
"run.started",
|
|
6
|
+
"plan.created",
|
|
7
|
+
"plan.revised",
|
|
8
|
+
"step.ready",
|
|
9
|
+
"step.started",
|
|
10
|
+
"step.retrying",
|
|
11
|
+
"step.completed",
|
|
12
|
+
"step.blocked",
|
|
13
|
+
"step.failed",
|
|
14
|
+
"run.completed",
|
|
15
|
+
"run.failed",
|
|
16
|
+
];
|
|
17
|
+
//# sourceMappingURL=events.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmGH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,aAAa;IACb,cAAc;IACd,cAAc;IACd,YAAY;IACZ,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,cAAc;IACd,aAAa;IACb,eAAe;IACf,YAAY;CACJ,CAAC"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Step executor contract input (spec §11).
|
|
3
|
+
*/
|
|
4
|
+
import type { StepDefinition } from "./plan.js";
|
|
5
|
+
import type { StepAttemptResult } from "./step.js";
|
|
6
|
+
import type { ToolAdapter } from "./tools.js";
|
|
7
|
+
import type { ModelAdapter } from "./models.js";
|
|
8
|
+
export interface StepExecutionInput {
|
|
9
|
+
runId: string;
|
|
10
|
+
step: StepDefinition;
|
|
11
|
+
attempt: number;
|
|
12
|
+
resolvedInputs: Record<string, unknown>;
|
|
13
|
+
runContext: Record<string, unknown>;
|
|
14
|
+
tools: Record<string, ToolAdapter>;
|
|
15
|
+
model?: ModelAdapter;
|
|
16
|
+
priorAttempts: StepAttemptResult[];
|
|
17
|
+
}
|
|
18
|
+
//# sourceMappingURL=executor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/types/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,iBAAiB,EAAE,CAAC;CACpC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/types/executor.ts"],"names":[],"mappings":"AAAA;;GAEG"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Model adapter contract (spec §14).
|
|
3
|
+
* Provider-agnostic; no specific vendor in core.
|
|
4
|
+
*/
|
|
5
|
+
export interface ModelGenerateInput {
|
|
6
|
+
prompt?: string;
|
|
7
|
+
messages?: unknown[];
|
|
8
|
+
[key: string]: unknown;
|
|
9
|
+
}
|
|
10
|
+
export interface ModelGenerateOutput {
|
|
11
|
+
content?: string;
|
|
12
|
+
raw?: unknown;
|
|
13
|
+
[key: string]: unknown;
|
|
14
|
+
}
|
|
15
|
+
export interface ModelAdapter {
|
|
16
|
+
generate(input: ModelGenerateInput): Promise<ModelGenerateOutput>;
|
|
17
|
+
}
|
|
18
|
+
//# sourceMappingURL=models.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/types/models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnE"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/types/models.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Plan and step definition types (spec §9.3–9.6).
|
|
3
|
+
*/
|
|
4
|
+
export type StepType = "tool" | "transform" | "decision" | "validation";
|
|
5
|
+
export type JsonSchemaLike = Record<string, unknown>;
|
|
6
|
+
export interface StepInputRef {
|
|
7
|
+
source: "runContext" | "stepOutput" | "artifact";
|
|
8
|
+
key: string;
|
|
9
|
+
stepId?: string;
|
|
10
|
+
}
|
|
11
|
+
export interface RetryPolicy {
|
|
12
|
+
maxAttempts: number;
|
|
13
|
+
strategy: "retry_with_feedback" | "replan" | "fail";
|
|
14
|
+
backoffMs?: number;
|
|
15
|
+
}
|
|
16
|
+
export interface StepDefinition {
|
|
17
|
+
id: string;
|
|
18
|
+
name: string;
|
|
19
|
+
type: StepType;
|
|
20
|
+
objective: string;
|
|
21
|
+
dependencies: string[];
|
|
22
|
+
allowedTools: string[];
|
|
23
|
+
inputs: StepInputRef[];
|
|
24
|
+
outputSchema?: JsonSchemaLike;
|
|
25
|
+
outputs: string[];
|
|
26
|
+
completionCriteria: string[];
|
|
27
|
+
retryPolicy: RetryPolicy;
|
|
28
|
+
executionMode?: "sequential" | "parallelizable";
|
|
29
|
+
}
|
|
30
|
+
export interface Plan {
|
|
31
|
+
id: string;
|
|
32
|
+
version: number;
|
|
33
|
+
goal: string;
|
|
34
|
+
steps: StepDefinition[];
|
|
35
|
+
createdAt: string;
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=plan.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/types/plan.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,GAAG,YAAY,GAAG,UAAU,CAAC;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,qBAAqB,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,CAAC,EAAE,YAAY,GAAG,gBAAgB,CAAC;CACjD;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/types/plan.ts"],"names":[],"mappings":"AAAA;;GAEG"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Planner contract input types (spec §10).
|
|
3
|
+
*/
|
|
4
|
+
import type { Plan } from "./plan.js";
|
|
5
|
+
import type { RunOptions } from "./run.js";
|
|
6
|
+
import type { ToolDefinition } from "./tools.js";
|
|
7
|
+
export interface PlannerInput {
|
|
8
|
+
goal: string;
|
|
9
|
+
context: Record<string, unknown>;
|
|
10
|
+
constraints: string[];
|
|
11
|
+
availableTools: ToolDefinition[];
|
|
12
|
+
options: RunOptions;
|
|
13
|
+
}
|
|
14
|
+
export interface ReplanInput {
|
|
15
|
+
runId: string;
|
|
16
|
+
goal: string;
|
|
17
|
+
context: Record<string, unknown>;
|
|
18
|
+
constraints: string[];
|
|
19
|
+
currentPlan: Plan;
|
|
20
|
+
failedStepId: string;
|
|
21
|
+
availableTools: ToolDefinition[];
|
|
22
|
+
options: RunOptions;
|
|
23
|
+
}
|
|
24
|
+
//# sourceMappingURL=planner.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/types/planner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,IAAI,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,OAAO,EAAE,UAAU,CAAC;CACrB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/types/planner.ts"],"names":[],"mappings":"AAAA;;GAEG"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Run task input, options, result, and state (spec §9.1, 9.2, 9.11, 15.1).
|
|
3
|
+
*/
|
|
4
|
+
import type { Plan } from "./plan.js";
|
|
5
|
+
import type { ArtifactRef, StepRunRecord } from "./step.js";
|
|
6
|
+
export interface RunOptions {
|
|
7
|
+
maxStepAttempts: number;
|
|
8
|
+
maxPlanRevisions: number;
|
|
9
|
+
maxTotalSteps: number;
|
|
10
|
+
maxExecutionTimeMs: number;
|
|
11
|
+
maxParallelSteps: number;
|
|
12
|
+
requireStructuredOutputs: boolean;
|
|
13
|
+
stopOnStepFailure: boolean;
|
|
14
|
+
}
|
|
15
|
+
/** v1 defaults from spec §26 */
|
|
16
|
+
export declare const DEFAULT_RUN_OPTIONS: RunOptions;
|
|
17
|
+
export interface RunTaskInput {
|
|
18
|
+
goal: string;
|
|
19
|
+
context?: Record<string, unknown>;
|
|
20
|
+
constraints?: string[];
|
|
21
|
+
metadata?: Record<string, unknown>;
|
|
22
|
+
options?: Partial<RunOptions>;
|
|
23
|
+
}
|
|
24
|
+
export interface RunResult {
|
|
25
|
+
runId: string;
|
|
26
|
+
status: "completed" | "failed" | "partial";
|
|
27
|
+
plan: Plan;
|
|
28
|
+
steps: Record<string, StepRunRecord>;
|
|
29
|
+
outputs: Record<string, unknown>;
|
|
30
|
+
startedAt: string;
|
|
31
|
+
completedAt: string;
|
|
32
|
+
durationMs: number;
|
|
33
|
+
}
|
|
34
|
+
export type RunStatus = "planning" | "running" | "completed" | "failed" | "partial";
|
|
35
|
+
export interface RunState {
|
|
36
|
+
runId: string;
|
|
37
|
+
status: RunStatus;
|
|
38
|
+
task: RunTaskInput;
|
|
39
|
+
options: RunOptions;
|
|
40
|
+
currentPlan: Plan;
|
|
41
|
+
planHistory: Plan[];
|
|
42
|
+
steps: Record<string, StepRunRecord>;
|
|
43
|
+
outputs: Record<string, unknown>;
|
|
44
|
+
artifacts: Record<string, ArtifactRef>;
|
|
45
|
+
startedAt: string;
|
|
46
|
+
completedAt?: string;
|
|
47
|
+
}
|
|
48
|
+
//# sourceMappingURL=run.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/types/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,OAAO,CAAC;IAClC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,EAAE,UAQjC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,EAAE,IAAI,CAAC;IAClB,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Run task input, options, result, and state (spec §9.1, 9.2, 9.11, 15.1).
|
|
3
|
+
*/
|
|
4
|
+
/** v1 defaults from spec §26 */
|
|
5
|
+
export const DEFAULT_RUN_OPTIONS = {
|
|
6
|
+
maxStepAttempts: 3,
|
|
7
|
+
maxPlanRevisions: 2,
|
|
8
|
+
maxTotalSteps: 100,
|
|
9
|
+
maxExecutionTimeMs: 300000,
|
|
10
|
+
maxParallelSteps: 1,
|
|
11
|
+
requireStructuredOutputs: true,
|
|
12
|
+
stopOnStepFailure: true,
|
|
13
|
+
};
|
|
14
|
+
//# sourceMappingURL=run.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/types/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,gCAAgC;AAChC,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,eAAe,EAAE,CAAC;IAClB,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,GAAG;IAClB,kBAAkB,EAAE,MAAO;IAC3B,gBAAgB,EAAE,CAAC;IACnB,wBAAwB,EAAE,IAAI;IAC9B,iBAAiB,EAAE,IAAI;CACxB,CAAC"}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Step execution and evaluation types (spec §9.7–9.10).
|
|
3
|
+
*/
|
|
4
|
+
import type { StepDefinition } from "./plan.js";
|
|
5
|
+
export type StepStatus = "pending" | "ready" | "running" | "retrying" | "completed" | "blocked" | "failed" | "skipped";
|
|
6
|
+
export interface ArtifactRef {
|
|
7
|
+
id: string;
|
|
8
|
+
type?: string;
|
|
9
|
+
[key: string]: unknown;
|
|
10
|
+
}
|
|
11
|
+
export interface EvidenceRef {
|
|
12
|
+
type?: string;
|
|
13
|
+
content?: unknown;
|
|
14
|
+
[key: string]: unknown;
|
|
15
|
+
}
|
|
16
|
+
export interface StepExecutionError {
|
|
17
|
+
code: string;
|
|
18
|
+
message: string;
|
|
19
|
+
details?: unknown;
|
|
20
|
+
}
|
|
21
|
+
export interface StepAttemptResult {
|
|
22
|
+
stepId: string;
|
|
23
|
+
attempt: number;
|
|
24
|
+
status: "success" | "error";
|
|
25
|
+
rawOutput?: unknown;
|
|
26
|
+
structuredOutput?: Record<string, unknown>;
|
|
27
|
+
artifacts?: ArtifactRef[];
|
|
28
|
+
evidence?: EvidenceRef[];
|
|
29
|
+
error?: StepExecutionError;
|
|
30
|
+
startedAt: string;
|
|
31
|
+
completedAt: string;
|
|
32
|
+
durationMs: number;
|
|
33
|
+
}
|
|
34
|
+
export type EvaluationVerdict = "complete" | "retry" | "needs_replan" | "failed";
|
|
35
|
+
export interface EvaluationResult {
|
|
36
|
+
stepId: string;
|
|
37
|
+
attempt: number;
|
|
38
|
+
verdict: EvaluationVerdict;
|
|
39
|
+
reasons: string[];
|
|
40
|
+
missingCriteria?: string[];
|
|
41
|
+
confidence?: number;
|
|
42
|
+
suggestedAction?: string;
|
|
43
|
+
}
|
|
44
|
+
export interface StepRunRecord {
|
|
45
|
+
step: StepDefinition;
|
|
46
|
+
status: StepStatus;
|
|
47
|
+
attempts: StepAttemptResult[];
|
|
48
|
+
latestEvaluation?: EvaluationResult;
|
|
49
|
+
finalOutput?: Record<string, unknown>;
|
|
50
|
+
finalArtifacts?: ArtifactRef[];
|
|
51
|
+
}
|
|
52
|
+
//# sourceMappingURL=step.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/types/step.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,OAAO,GACP,SAAS,GACT,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEjF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,WAAW,EAAE,CAAC;CAChC"}
|