clanka 0.8.6 → 0.10.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/dist/Acp.d.ts +6 -1
- package/dist/Acp.d.ts.map +1 -1
- package/dist/Acp.js +34 -3
- package/dist/Acp.js.map +1 -1
- package/dist/Acp.test.js +178 -2
- package/dist/Acp.test.js.map +1 -1
- package/dist/AcpImage.test.js +7 -1
- package/dist/AcpImage.test.js.map +1 -1
- package/dist/Agent.d.ts +82 -8
- package/dist/Agent.d.ts.map +1 -1
- package/dist/Agent.js +556 -113
- package/dist/Agent.js.map +1 -1
- package/dist/Agent.test.js +86 -5
- package/dist/Agent.test.js.map +1 -1
- package/dist/AgentCallerConfig.test.d.ts +2 -0
- package/dist/AgentCallerConfig.test.d.ts.map +1 -0
- package/dist/AgentCallerConfig.test.js +335 -0
- package/dist/AgentCallerConfig.test.js.map +1 -0
- package/dist/AgentEnvironment.d.ts +76 -0
- package/dist/AgentEnvironment.d.ts.map +1 -0
- package/dist/AgentEnvironment.js +119 -0
- package/dist/AgentEnvironment.js.map +1 -0
- package/dist/AgentEnvironment.test.d.ts +2 -0
- package/dist/AgentEnvironment.test.d.ts.map +1 -0
- package/dist/AgentEnvironment.test.js +304 -0
- package/dist/AgentEnvironment.test.js.map +1 -0
- package/dist/AgentExecutor.d.ts +342 -183
- package/dist/AgentExecutor.d.ts.map +1 -1
- package/dist/AgentExecutor.js +607 -127
- package/dist/AgentExecutor.js.map +1 -1
- package/dist/AgentExecutor.test.js +287 -31
- package/dist/AgentExecutor.test.js.map +1 -1
- package/dist/AgentExecutorImage.test.js +5 -1
- package/dist/AgentExecutorImage.test.js.map +1 -1
- package/dist/AgentImage.test.js +15 -2
- package/dist/AgentImage.test.js.map +1 -1
- package/dist/AgentOutput.d.ts +70 -5
- package/dist/AgentOutput.d.ts.map +1 -1
- package/dist/AgentOutput.js +65 -0
- package/dist/AgentOutput.js.map +1 -1
- package/dist/AgentSkills.d.ts +37 -0
- package/dist/AgentSkills.d.ts.map +1 -1
- package/dist/AgentSkills.js +96 -32
- package/dist/AgentSkills.js.map +1 -1
- package/dist/AgentSkills.test.js +14 -2
- package/dist/AgentSkills.test.js.map +1 -1
- package/dist/AgentSubagents.test.d.ts +2 -0
- package/dist/AgentSubagents.test.d.ts.map +1 -0
- package/dist/AgentSubagents.test.js +494 -0
- package/dist/AgentSubagents.test.js.map +1 -0
- package/dist/AgentTools.d.ts +356 -14
- package/dist/AgentTools.d.ts.map +1 -1
- package/dist/AgentTools.js +214 -35
- package/dist/AgentTools.js.map +1 -1
- package/dist/OutputFormatter.d.ts.map +1 -1
- package/dist/OutputFormatter.js +19 -2
- package/dist/OutputFormatter.js.map +1 -1
- package/dist/ToolkitRenderer.d.ts.map +1 -1
- package/dist/ToolkitRenderer.js +6 -1
- package/dist/ToolkitRenderer.js.map +1 -1
- package/dist/bin/{Effect-rADALOOD.mjs → Effect-2jPlJ8eu.mjs} +43 -38
- package/dist/bin/Effect-2jPlJ8eu.mjs.map +1 -0
- package/dist/bin/{McpClient-NazR2OwL.mjs → McpClient-1W508adc.mjs} +3 -3
- package/dist/bin/{McpClient-NazR2OwL.mjs.map → McpClient-1W508adc.mjs.map} +1 -1
- package/dist/bin/{OutputFormatter-BVHbgF2b.mjs → OutputFormatter-BFAv48k9.mjs} +17 -5
- package/dist/bin/{OutputFormatter-BVHbgF2b.mjs.map → OutputFormatter-BFAv48k9.mjs.map} +1 -1
- package/dist/bin/{Schema-C7NXAOWA.mjs → Schema-D-7VuCiC.mjs} +2 -2
- package/dist/bin/{Schema-C7NXAOWA.mjs.map → Schema-D-7VuCiC.mjs.map} +1 -1
- package/dist/bin/{SemanticSearch-4Jes3jCl.mjs → SemanticSearch-Cb8aqvGv.mjs} +4 -4
- package/dist/bin/{SemanticSearch-4Jes3jCl.mjs.map → SemanticSearch-Cb8aqvGv.mjs.map} +1 -1
- package/dist/bin/{Stream-CSLA1_GD.mjs → Stream-DEu2tfCV.mjs} +12 -3
- package/dist/bin/Stream-DEu2tfCV.mjs.map +1 -0
- package/dist/bin/cli.mjs +13333 -12470
- package/dist/bin/cli.mjs.map +1 -1
- package/package.json +1 -1
- package/src/Acp.test.ts +279 -3
- package/src/Acp.ts +34 -4
- package/src/AcpImage.test.ts +7 -1
- package/src/Agent.test.ts +109 -4
- package/src/Agent.ts +874 -140
- package/src/AgentCallerConfig.test.ts +522 -0
- package/src/AgentEnvironment.test.ts +504 -0
- package/src/AgentEnvironment.ts +161 -0
- package/src/AgentExecutor.test.ts +414 -37
- package/src/AgentExecutor.ts +1028 -191
- package/src/AgentExecutorImage.test.ts +5 -1
- package/src/AgentImage.test.ts +21 -3
- package/src/AgentOutput.ts +91 -1
- package/src/AgentSkills.test.ts +14 -2
- package/src/AgentSkills.ts +117 -34
- package/src/AgentSubagents.test.ts +824 -0
- package/src/AgentTools.ts +377 -53
- package/src/OutputFormatter.ts +19 -2
- package/src/ToolkitRenderer.ts +7 -1
- package/dist/bin/Effect-rADALOOD.mjs.map +0 -1
- package/dist/bin/Stream-CSLA1_GD.mjs.map +0 -1
|
@@ -0,0 +1,335 @@
|
|
|
1
|
+
import { assert, describe, it } from "@effect/vitest";
|
|
2
|
+
import * as NodeHttpServer from "@effect/platform-node/NodeHttpServer";
|
|
3
|
+
import * as NodeServices from "@effect/platform-node/NodeServices";
|
|
4
|
+
import * as Deferred from "effect/Deferred";
|
|
5
|
+
import * as Effect from "effect/Effect";
|
|
6
|
+
import * as Exit from "effect/Exit";
|
|
7
|
+
import * as Fiber from "effect/Fiber";
|
|
8
|
+
import * as FileSystem from "effect/FileSystem";
|
|
9
|
+
import * as FetchHttpClient from "effect/http/FetchHttpClient";
|
|
10
|
+
import * as HttpServer from "effect/http/HttpServer";
|
|
11
|
+
import * as Latch from "effect/Latch";
|
|
12
|
+
import * as Layer from "effect/Layer";
|
|
13
|
+
import * as Option from "effect/Option";
|
|
14
|
+
import * as Path from "effect/Path";
|
|
15
|
+
import * as Schema from "effect/Schema";
|
|
16
|
+
import * as Stream from "effect/Stream";
|
|
17
|
+
import * as LanguageModel from "effect/ai/LanguageModel";
|
|
18
|
+
import * as Model from "effect/ai/Model";
|
|
19
|
+
import * as Tool from "effect/ai/Tool";
|
|
20
|
+
import * as Toolkit from "effect/ai/Toolkit";
|
|
21
|
+
import * as RpcClient from "effect/rpc/RpcClient";
|
|
22
|
+
import * as RpcSerialization from "effect/rpc/RpcSerialization";
|
|
23
|
+
import * as RpcServer from "effect/rpc/RpcServer";
|
|
24
|
+
import * as Agent from "./Agent.js";
|
|
25
|
+
import * as AgentExecutor from "./AgentExecutor.js";
|
|
26
|
+
import { subagentsUnavailable } from "./AgentTools.js";
|
|
27
|
+
const modes = ["local", "rpc"];
|
|
28
|
+
// The executor's checkout carries instructions and a skill a caller may
|
|
29
|
+
// replace. Neither marker may leak into a prompt that replaced them.
|
|
30
|
+
const prepareDirectory = Effect.gen(function* () {
|
|
31
|
+
const fs = yield* FileSystem.FileSystem;
|
|
32
|
+
const path = yield* Path.Path;
|
|
33
|
+
const directory = yield* fs.makeTempDirectoryScoped();
|
|
34
|
+
yield* fs.writeFileString(path.join(directory, "AGENTS.md"), "EXECUTOR-AGENTS-MD");
|
|
35
|
+
const skillDir = path.join(directory, ".agents", "skills", "executor-skill");
|
|
36
|
+
yield* fs.makeDirectory(skillDir, { recursive: true });
|
|
37
|
+
yield* fs.writeFileString(path.join(skillDir, "SKILL.md"), "---\nname: executor-skill\ndescription: Executor skill\n---\nEXECUTOR-SKILL-CONTENT");
|
|
38
|
+
return directory;
|
|
39
|
+
});
|
|
40
|
+
const localExecutor = (options) => Layer.unwrap(Effect.gen(function* () {
|
|
41
|
+
const directory = yield* prepareDirectory;
|
|
42
|
+
return AgentExecutor.layerLocal({ directory, ...options });
|
|
43
|
+
})).pipe(Layer.provide(Layer.mergeAll(NodeServices.layer, FetchHttpClient.layer)));
|
|
44
|
+
const rpcExecutor = (options) => Layer.unwrap(Effect.gen(function* () {
|
|
45
|
+
const directory = yield* prepareDirectory;
|
|
46
|
+
const { protocol, httpEffect } = yield* RpcServer.makeProtocolWithHttpEffect();
|
|
47
|
+
yield* Layer.build(AgentExecutor.layerRpcServer({ directory, ...options }).pipe(Layer.provide(Layer.succeed(RpcServer.Protocol, protocol))));
|
|
48
|
+
yield* HttpServer.serveEffect(httpEffect);
|
|
49
|
+
return AgentExecutor.layerRpc.pipe(Layer.provide(RpcClient.layerProtocolHttp({ url: "" })));
|
|
50
|
+
})).pipe(Layer.provide(Layer.mergeAll(RpcSerialization.layerNdjson, NodeHttpServer.layerTest, NodeServices.layer)));
|
|
51
|
+
const executorLayer = (mode, options = {}) => mode === "local" ? localExecutor(options) : rpcExecutor(options);
|
|
52
|
+
const systemText = (prompt) => prompt.content
|
|
53
|
+
.filter((message) => message.role === "system")
|
|
54
|
+
.map((message) => message.content)
|
|
55
|
+
.join("\n");
|
|
56
|
+
// A script that does not reach `taskComplete` leads to a second model call;
|
|
57
|
+
// its tool result carries the script's output, including any thrown error.
|
|
58
|
+
const lastToolResult = (prompt) => {
|
|
59
|
+
const message = prompt.content.findLast((message) => message.role === "tool");
|
|
60
|
+
if (message === undefined)
|
|
61
|
+
return "";
|
|
62
|
+
return message.content
|
|
63
|
+
.map((part) => (part.type === "tool-result" ? String(part.result) : ""))
|
|
64
|
+
.join("");
|
|
65
|
+
};
|
|
66
|
+
const toolCall = (script) => ({
|
|
67
|
+
type: "tool-call",
|
|
68
|
+
id: "call-1",
|
|
69
|
+
name: "execute",
|
|
70
|
+
params: { script },
|
|
71
|
+
});
|
|
72
|
+
/**
|
|
73
|
+
* Runs one script through the Agent and returns the system prompt the model
|
|
74
|
+
* saw and the summary passed to `taskComplete`.
|
|
75
|
+
*/
|
|
76
|
+
const runAgent = (options) => Effect.gen(function* () {
|
|
77
|
+
let system = "";
|
|
78
|
+
let calls = 0;
|
|
79
|
+
const languageModel = yield* LanguageModel.make({
|
|
80
|
+
generateText: () => Effect.die("unexpected generateText call"),
|
|
81
|
+
streamText: (providerOptions) => {
|
|
82
|
+
if (calls++ > 0) {
|
|
83
|
+
return Stream.die(`the script did not call taskComplete: ${lastToolResult(providerOptions.prompt)}`);
|
|
84
|
+
}
|
|
85
|
+
system = systemText(providerOptions.prompt);
|
|
86
|
+
return Stream.make(toolCall(options.script));
|
|
87
|
+
},
|
|
88
|
+
});
|
|
89
|
+
const modelLayer = Layer.mergeAll(Layer.succeed(LanguageModel.LanguageModel, languageModel), Layer.succeed(Model.ProviderName, "test-provider"), Layer.succeed(Model.ModelName, "test-model"));
|
|
90
|
+
const agent = yield* Agent.makeWith(options.agent ?? {});
|
|
91
|
+
const summary = yield* agent.send({ prompt: "hello" }).pipe(Effect.flatMap(Stream.runDrain), Effect.as(""), Effect.catchTag("AgentFinished", (finished) => Effect.succeed(finished.summary)), Effect.provide(modelLayer));
|
|
92
|
+
return { system, summary };
|
|
93
|
+
}).pipe(Effect.scoped,
|
|
94
|
+
// The executor lives as long as the run, not just the Agent's creation.
|
|
95
|
+
Effect.provide([
|
|
96
|
+
executorLayer(options.mode, options.executor),
|
|
97
|
+
options.handlers ?? Layer.empty,
|
|
98
|
+
]), Effect.timeout("4 seconds"));
|
|
99
|
+
// A loop-side tool that rejects lines past 50, as janitor rejects lines that
|
|
100
|
+
// are not in the diff.
|
|
101
|
+
const Report = Toolkit.make(Tool.make("report", {
|
|
102
|
+
description: "Report a finding on a line of the diff.",
|
|
103
|
+
parameters: Schema.Struct({ line: Schema.Finite }),
|
|
104
|
+
success: Schema.Struct({ line: Schema.Finite }),
|
|
105
|
+
failure: Schema.String,
|
|
106
|
+
}));
|
|
107
|
+
const reportHandlers = (onCall) => Report.toLayer({
|
|
108
|
+
report: ({ line }) => onCall(line).pipe(Effect.andThen(line > 50
|
|
109
|
+
? Effect.fail(`line ${line} is not in the diff`)
|
|
110
|
+
: Effect.succeed({ line }))),
|
|
111
|
+
});
|
|
112
|
+
// Runs a script on the executor directly, below the Agent.
|
|
113
|
+
const execute = (script, loopTools) => Effect.gen(function* () {
|
|
114
|
+
const executor = yield* AgentExecutor.AgentExecutor;
|
|
115
|
+
const { environment } = yield* executor.capabilities;
|
|
116
|
+
return yield* executor
|
|
117
|
+
.execute({
|
|
118
|
+
script,
|
|
119
|
+
environment,
|
|
120
|
+
onEnvironment: () => Effect.void,
|
|
121
|
+
onTaskComplete: () => Effect.void,
|
|
122
|
+
onImage: () => Effect.void,
|
|
123
|
+
subagents: subagentsUnavailable,
|
|
124
|
+
loopTools,
|
|
125
|
+
})
|
|
126
|
+
.pipe(Stream.mkString);
|
|
127
|
+
});
|
|
128
|
+
// --- tests -------------------------------------------------------------------
|
|
129
|
+
// Where the RPC executor takes its own path.
|
|
130
|
+
for (const mode of modes) {
|
|
131
|
+
describe(`${mode} executor`, () => {
|
|
132
|
+
it.live("left-out tools are not offered to the model or the script", () => Effect.gen(function* () {
|
|
133
|
+
const { system, summary } = yield* runAgent({
|
|
134
|
+
mode,
|
|
135
|
+
executor: {
|
|
136
|
+
excludeTools: ["gh", "webSearch", "fetchMarkdown", "delegate"],
|
|
137
|
+
},
|
|
138
|
+
script: `const missing = [typeof gh, typeof webSearch, typeof fetchMarkdown, typeof delegate, typeof waitAgents].join(",")
|
|
139
|
+
let call
|
|
140
|
+
try {
|
|
141
|
+
await gh(["pr", "view"])
|
|
142
|
+
call = "called"
|
|
143
|
+
} catch (error) {
|
|
144
|
+
call = "failed"
|
|
145
|
+
}
|
|
146
|
+
await taskComplete(missing + " " + call)`,
|
|
147
|
+
});
|
|
148
|
+
assert.strictEqual(summary, "undefined,undefined,undefined,undefined,undefined failed");
|
|
149
|
+
assert.notMatch(system, /\b(gh|webSearch|fetchMarkdown|delegate|waitAgents|messageAgent|stopAgent|listAgents)\b/);
|
|
150
|
+
assert.include(system, "declare function readFile(");
|
|
151
|
+
}));
|
|
152
|
+
it.live("a caller tool replaces a left-out built-in of the same name", () => Effect.gen(function* () {
|
|
153
|
+
let calls = 0;
|
|
154
|
+
const CallerTools = Toolkit.make(Tool.make("readFile", {
|
|
155
|
+
parameters: Schema.Struct({ path: Schema.String }),
|
|
156
|
+
success: Schema.String,
|
|
157
|
+
}));
|
|
158
|
+
const output = yield* execute('console.log(await readFile({ path: "AGENTS.md" }))').pipe(Effect.provide(executorLayer(mode, {
|
|
159
|
+
excludeTools: ["readFile"],
|
|
160
|
+
tools: CallerTools,
|
|
161
|
+
}).pipe(Layer.provide(CallerTools.toLayer({
|
|
162
|
+
readFile: () => Effect.sync(() => {
|
|
163
|
+
calls++;
|
|
164
|
+
return "CALLER";
|
|
165
|
+
}),
|
|
166
|
+
})))), Effect.scoped, Effect.timeout("4 seconds"));
|
|
167
|
+
assert.isTrue(output.endsWith("CALLER\n"));
|
|
168
|
+
assert.strictEqual(calls, 1);
|
|
169
|
+
}));
|
|
170
|
+
it.live("loop-side tools are declared, decoded on the loop and answer the script", () => Effect.gen(function* () {
|
|
171
|
+
// The two valid calls wait for each other: serialized calls never
|
|
172
|
+
// open the latch.
|
|
173
|
+
const bothArrived = yield* Latch.make(false);
|
|
174
|
+
const lines = [];
|
|
175
|
+
const { system, summary } = yield* runAgent({
|
|
176
|
+
mode,
|
|
177
|
+
agent: { loopTools: Report },
|
|
178
|
+
handlers: reportHandlers((line) => Effect.gen(function* () {
|
|
179
|
+
if (lines.push(line) === 2)
|
|
180
|
+
yield* bothArrived.open;
|
|
181
|
+
yield* bothArrived.await;
|
|
182
|
+
})),
|
|
183
|
+
script: `const message = (call) => call.then(() => "called", (error) => error.message)
|
|
184
|
+
await taskComplete(JSON.stringify({
|
|
185
|
+
result: await Promise.all([report({ line: 3 }), report({ line: 4 })]),
|
|
186
|
+
invalid: await message(report({ line: "three" })),
|
|
187
|
+
rejected: await message(report({ line: 88 })),
|
|
188
|
+
}))`,
|
|
189
|
+
});
|
|
190
|
+
const { result, invalid, rejected } = JSON.parse(summary);
|
|
191
|
+
assert.deepStrictEqual(result, [{ line: 3 }, { line: 4 }]);
|
|
192
|
+
// The rejection names the tool and the argument, and the handler
|
|
193
|
+
// never sees the call.
|
|
194
|
+
assert.include(invalid, "report");
|
|
195
|
+
assert.include(invalid, "line");
|
|
196
|
+
assert.strictEqual(rejected, "line 88 is not in the diff");
|
|
197
|
+
assert.sameMembers(lines, [3, 4, 88]);
|
|
198
|
+
assert.include(system, "declare function report(");
|
|
199
|
+
assert.include(system, "Report a finding on a line of the diff.");
|
|
200
|
+
}));
|
|
201
|
+
it.live("interrupting the run interrupts in-flight loop-side calls", () => Effect.gen(function* () {
|
|
202
|
+
const started = yield* Deferred.make();
|
|
203
|
+
const interrupted = yield* Deferred.make();
|
|
204
|
+
const fiber = yield* Effect.forkChild(runAgent({
|
|
205
|
+
mode,
|
|
206
|
+
agent: { loopTools: Report },
|
|
207
|
+
handlers: reportHandlers(() => Deferred.succeed(started, undefined).pipe(Effect.andThen(Effect.never), Effect.onInterrupt(() => Deferred.succeed(interrupted, undefined)))),
|
|
208
|
+
script: "await report({ line: 3 })",
|
|
209
|
+
}));
|
|
210
|
+
yield* Deferred.await(started);
|
|
211
|
+
yield* Fiber.interrupt(fiber);
|
|
212
|
+
yield* Deferred.await(interrupted).pipe(Effect.timeout("2 seconds"));
|
|
213
|
+
}));
|
|
214
|
+
});
|
|
215
|
+
}
|
|
216
|
+
describe("rpc executor", () => {
|
|
217
|
+
it.live("loop-side calls run concurrently within and across scripts", () => Effect.gen(function* () {
|
|
218
|
+
// Every call waits for all four: serialized calls never open the latch.
|
|
219
|
+
const allArrived = yield* Latch.make(false);
|
|
220
|
+
let arrived = 0;
|
|
221
|
+
const loopTools = {
|
|
222
|
+
echo: (params) => Effect.gen(function* () {
|
|
223
|
+
if (++arrived === 4)
|
|
224
|
+
yield* allArrived.open;
|
|
225
|
+
yield* allArrived.await;
|
|
226
|
+
return params;
|
|
227
|
+
}),
|
|
228
|
+
};
|
|
229
|
+
const outputs = yield* Effect.all([
|
|
230
|
+
execute('console.log((await Promise.all([echo("a1"), echo("a2")])).join())', loopTools),
|
|
231
|
+
execute('console.log((await Promise.all([echo("b1"), echo("b2")])).join())', loopTools),
|
|
232
|
+
], { concurrency: "unbounded" }).pipe(Effect.provide(executorLayer("rpc")), Effect.scoped, Effect.timeout("4 seconds"));
|
|
233
|
+
assert.isTrue(outputs[0].endsWith("a1,a2\n"));
|
|
234
|
+
assert.isTrue(outputs[1].endsWith("b1,b2\n"));
|
|
235
|
+
}));
|
|
236
|
+
});
|
|
237
|
+
// Decided by the Agent from the executor's capabilities, whatever the
|
|
238
|
+
// transport.
|
|
239
|
+
describe("agent", () => {
|
|
240
|
+
it.live("a left-out tool is not mentioned anywhere in the prompt", () => Effect.gen(function* () {
|
|
241
|
+
// Each is named outside its own declaration: the delegate bullet, the
|
|
242
|
+
// applyPatch hint and the executor's skills catalog.
|
|
243
|
+
const { system, summary } = yield* runAgent({
|
|
244
|
+
mode: "local",
|
|
245
|
+
executor: { excludeTools: ["waitAgents", "applyPatch", "readFile"] },
|
|
246
|
+
script: "await taskComplete([typeof waitAgents, typeof applyPatch, typeof readFile].join())",
|
|
247
|
+
});
|
|
248
|
+
assert.strictEqual(summary, "undefined,undefined,undefined");
|
|
249
|
+
assert.notMatch(system, /\b(waitAgents|applyPatch|readFile)\b/);
|
|
250
|
+
assert.include(system, "declare function delegate(");
|
|
251
|
+
}));
|
|
252
|
+
it.live("caller instructions and skills replace the executor's", () => Effect.gen(function* () {
|
|
253
|
+
const byDefault = yield* runAgent({
|
|
254
|
+
mode: "local",
|
|
255
|
+
script: 'await taskComplete("ok")',
|
|
256
|
+
});
|
|
257
|
+
assert.include(byDefault.system, "EXECUTOR-AGENTS-MD");
|
|
258
|
+
assert.include(byDefault.system, "executor-skill");
|
|
259
|
+
const replaced = yield* runAgent({
|
|
260
|
+
mode: "local",
|
|
261
|
+
agent: {
|
|
262
|
+
instructions: Option.some("CALLER-INSTRUCTIONS"),
|
|
263
|
+
skills: [
|
|
264
|
+
{
|
|
265
|
+
name: "caller-skill",
|
|
266
|
+
description: "Caller skill",
|
|
267
|
+
content: "CALLER-SKILL-CONTENT",
|
|
268
|
+
},
|
|
269
|
+
],
|
|
270
|
+
},
|
|
271
|
+
script: 'await taskComplete(await readSkill("caller-skill"))',
|
|
272
|
+
});
|
|
273
|
+
assert.strictEqual(replaced.summary, "CALLER-SKILL-CONTENT");
|
|
274
|
+
assert.include(replaced.system, "CALLER-INSTRUCTIONS");
|
|
275
|
+
assert.include(replaced.system, "caller-skill: Caller skill");
|
|
276
|
+
assert.notInclude(replaced.system, "EXECUTOR-AGENTS-MD");
|
|
277
|
+
assert.notInclude(replaced.system, "executor-skill");
|
|
278
|
+
// Skill content is only read on demand.
|
|
279
|
+
assert.notInclude(replaced.system, "CALLER-SKILL-CONTENT");
|
|
280
|
+
const removed = yield* runAgent({
|
|
281
|
+
mode: "local",
|
|
282
|
+
agent: { instructions: Option.none(), skills: [] },
|
|
283
|
+
script: 'await taskComplete("ok")',
|
|
284
|
+
});
|
|
285
|
+
assert.notInclude(removed.system, "EXECUTOR-AGENTS-MD");
|
|
286
|
+
assert.notInclude(removed.system, "# Skills");
|
|
287
|
+
}));
|
|
288
|
+
it.live("a loop-side tool cannot shadow a built-in tool", () => Effect.gen(function* () {
|
|
289
|
+
const Shadow = Toolkit.make(Tool.make("readFile", { parameters: Schema.String }));
|
|
290
|
+
const result = yield* Agent.makeWith({ loopTools: Shadow }).pipe(Effect.as("built"), Effect.scoped, Effect.provide([
|
|
291
|
+
executorLayer("local"),
|
|
292
|
+
Shadow.toLayer({ readFile: () => Effect.void }),
|
|
293
|
+
]), Effect.catchDefect((defect) => Effect.succeed(String(defect))));
|
|
294
|
+
assert.include(result, "readFile");
|
|
295
|
+
assert.notStrictEqual(result, "built");
|
|
296
|
+
}));
|
|
297
|
+
it.live("a caller readSkill runs when no skills are provided", () => Effect.gen(function* () {
|
|
298
|
+
const CallerTools = Toolkit.make(Tool.make("readSkill", {
|
|
299
|
+
parameters: Schema.String,
|
|
300
|
+
success: Schema.String,
|
|
301
|
+
}));
|
|
302
|
+
const { summary } = yield* runAgent({
|
|
303
|
+
mode: "local",
|
|
304
|
+
agent: { loopTools: CallerTools, skills: [] },
|
|
305
|
+
handlers: CallerTools.toLayer({
|
|
306
|
+
readSkill: (name) => Effect.succeed(`CALLER:${name}`),
|
|
307
|
+
}),
|
|
308
|
+
script: 'await taskComplete(await readSkill("anything"))',
|
|
309
|
+
});
|
|
310
|
+
assert.strictEqual(summary, "CALLER:anything");
|
|
311
|
+
}));
|
|
312
|
+
});
|
|
313
|
+
describe("executor capabilities", () => {
|
|
314
|
+
// Loop and executor are upgraded together, so an executor that does not
|
|
315
|
+
// report its tools is rejected rather than assumed to offer all of them.
|
|
316
|
+
it.effect("require the tools the executor offers", () => Effect.gen(function* () {
|
|
317
|
+
const codec = Schema.toCodecJson(AgentExecutor.Capabilities);
|
|
318
|
+
const encoded = yield* Schema.encodeEffect(codec)(new AgentExecutor.Capabilities({
|
|
319
|
+
toolsDts: "",
|
|
320
|
+
environment: new AgentExecutor.ExecutionEnvironment({
|
|
321
|
+
cwd: "/",
|
|
322
|
+
baseline: [],
|
|
323
|
+
seen: [],
|
|
324
|
+
}),
|
|
325
|
+
instructions: Option.none(),
|
|
326
|
+
supportsSearch: false,
|
|
327
|
+
tools: ["readFile"],
|
|
328
|
+
skills: [],
|
|
329
|
+
}));
|
|
330
|
+
const { tools: _, ...older } = encoded;
|
|
331
|
+
const exit = yield* Effect.exit(Schema.decodeUnknownEffect(codec)(older));
|
|
332
|
+
assert.isTrue(Exit.isFailure(exit));
|
|
333
|
+
}));
|
|
334
|
+
});
|
|
335
|
+
//# sourceMappingURL=AgentCallerConfig.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AgentCallerConfig.test.js","sourceRoot":"","sources":["../src/AgentCallerConfig.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Find the AGENTS.md files and skills that apply to a directory, and render
|
|
3
|
+
* them for the model.
|
|
4
|
+
*
|
|
5
|
+
* @since 1.0.0
|
|
6
|
+
*/
|
|
7
|
+
import * as Effect from "effect/Effect";
|
|
8
|
+
import * as FileSystem from "effect/FileSystem";
|
|
9
|
+
import * as Option from "effect/Option";
|
|
10
|
+
import * as Path from "effect/Path";
|
|
11
|
+
import * as AgentSkills from "./AgentSkills.ts";
|
|
12
|
+
/**
|
|
13
|
+
* The most characters of one AGENTS.md sent to the model.
|
|
14
|
+
*
|
|
15
|
+
* @since 1.0.0
|
|
16
|
+
* @category Constants
|
|
17
|
+
*/
|
|
18
|
+
export declare const maxInstructionsChars = 32000;
|
|
19
|
+
/**
|
|
20
|
+
* An AGENTS.md file and the directory it applies to.
|
|
21
|
+
*
|
|
22
|
+
* @since 1.0.0
|
|
23
|
+
* @category Models
|
|
24
|
+
*/
|
|
25
|
+
export interface Instructions {
|
|
26
|
+
readonly id: string;
|
|
27
|
+
readonly path: string;
|
|
28
|
+
readonly directory: string;
|
|
29
|
+
readonly content: string;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* @since 1.0.0
|
|
33
|
+
* @category Models
|
|
34
|
+
*/
|
|
35
|
+
export interface Discovered {
|
|
36
|
+
/** Outermost directory first. */
|
|
37
|
+
readonly instructions: ReadonlyArray<Instructions>;
|
|
38
|
+
/** Outermost directory first. */
|
|
39
|
+
readonly skills: ReadonlyArray<AgentSkills.Skill>;
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* The id that records whether a skill has been sent to the model.
|
|
43
|
+
*
|
|
44
|
+
* @since 1.0.0
|
|
45
|
+
* @category Models
|
|
46
|
+
*/
|
|
47
|
+
export declare const skillId: (skill: AgentSkills.Skill) => string;
|
|
48
|
+
/**
|
|
49
|
+
* The AGENTS.md files and project skills from `cwd` up to the startup
|
|
50
|
+
* directory when `cwd` is inside it, or else up to the nearest git root. The
|
|
51
|
+
* walk never goes up into `home` or the filesystem root.
|
|
52
|
+
*
|
|
53
|
+
* @since 1.0.0
|
|
54
|
+
* @category Discovery
|
|
55
|
+
*/
|
|
56
|
+
export declare const discover: (options: {
|
|
57
|
+
readonly cwd: string;
|
|
58
|
+
readonly startup: string;
|
|
59
|
+
readonly home: Option.Option<string>;
|
|
60
|
+
}) => Effect.Effect<Discovered, never, FileSystem.FileSystem | Path.Path>;
|
|
61
|
+
/**
|
|
62
|
+
* One AGENTS.md as the model sees it, in the system prompt and in updates.
|
|
63
|
+
*
|
|
64
|
+
* @since 1.0.0
|
|
65
|
+
* @category Rendering
|
|
66
|
+
*/
|
|
67
|
+
export declare const renderInstructions: (instructions: Instructions) => string;
|
|
68
|
+
/**
|
|
69
|
+
* The text of an environment update: new AGENTS.md files, outermost first,
|
|
70
|
+
* then new skills.
|
|
71
|
+
*
|
|
72
|
+
* @since 1.0.0
|
|
73
|
+
* @category Rendering
|
|
74
|
+
*/
|
|
75
|
+
export declare const renderUpdate: (discovered: Discovered) => string;
|
|
76
|
+
//# sourceMappingURL=AgentEnvironment.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AgentEnvironment.d.ts","sourceRoot":"","sources":["../src/AgentEnvironment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAAS,CAAA;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;IAClD,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;CAClD;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,UAAW,WAAW,CAAC,KAAK,KAAG,MACxB,CAAA;AAE3B;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;kBACL,MAAM;sBACF,MAAM;mBACT,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;yEAoDpC,CAAA;AAOF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,iBAAkB,YAAY,WAUtC,CAAA;AAEvB;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,eAAgB,UAAU,KAAG,MAYrD,CAAA"}
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Find the AGENTS.md files and skills that apply to a directory, and render
|
|
3
|
+
* them for the model.
|
|
4
|
+
*
|
|
5
|
+
* @since 1.0.0
|
|
6
|
+
*/
|
|
7
|
+
import * as Effect from "effect/Effect";
|
|
8
|
+
import * as FileSystem from "effect/FileSystem";
|
|
9
|
+
import * as Option from "effect/Option";
|
|
10
|
+
import * as Path from "effect/Path";
|
|
11
|
+
import * as AgentSkills from "./AgentSkills.js";
|
|
12
|
+
/**
|
|
13
|
+
* The most characters of one AGENTS.md sent to the model.
|
|
14
|
+
*
|
|
15
|
+
* @since 1.0.0
|
|
16
|
+
* @category Constants
|
|
17
|
+
*/
|
|
18
|
+
export const maxInstructionsChars = 32_000;
|
|
19
|
+
/**
|
|
20
|
+
* The id that records whether a skill has been sent to the model.
|
|
21
|
+
*
|
|
22
|
+
* @since 1.0.0
|
|
23
|
+
* @category Models
|
|
24
|
+
*/
|
|
25
|
+
export const skillId = (skill) => `skill:${skill.location}`;
|
|
26
|
+
/**
|
|
27
|
+
* The AGENTS.md files and project skills from `cwd` up to the startup
|
|
28
|
+
* directory when `cwd` is inside it, or else up to the nearest git root. The
|
|
29
|
+
* walk never goes up into `home` or the filesystem root.
|
|
30
|
+
*
|
|
31
|
+
* @since 1.0.0
|
|
32
|
+
* @category Discovery
|
|
33
|
+
*/
|
|
34
|
+
export const discover = Effect.fnUntraced(function* (options) {
|
|
35
|
+
const fs = yield* FileSystem.FileSystem;
|
|
36
|
+
const path = yield* Path.Path;
|
|
37
|
+
const relative = path.relative(options.startup, options.cwd);
|
|
38
|
+
// `..pkg` is a child, so compare the first path segment, not a prefix.
|
|
39
|
+
const inside = relative !== ".." &&
|
|
40
|
+
!relative.startsWith(`..${path.sep}`) &&
|
|
41
|
+
!path.isAbsolute(relative);
|
|
42
|
+
const directories = [];
|
|
43
|
+
let directory = options.cwd;
|
|
44
|
+
while (true) {
|
|
45
|
+
directories.push(directory);
|
|
46
|
+
if (inside
|
|
47
|
+
? directory === options.startup
|
|
48
|
+
: yield* fs
|
|
49
|
+
.exists(path.join(directory, ".git"))
|
|
50
|
+
.pipe(Effect.orElseSucceed(() => false))) {
|
|
51
|
+
break;
|
|
52
|
+
}
|
|
53
|
+
const parent = path.dirname(directory);
|
|
54
|
+
if (parent === directory ||
|
|
55
|
+
parent === path.parse(parent).root ||
|
|
56
|
+
(Option.isSome(options.home) && parent === options.home.value)) {
|
|
57
|
+
break;
|
|
58
|
+
}
|
|
59
|
+
directory = parent;
|
|
60
|
+
}
|
|
61
|
+
directories.reverse();
|
|
62
|
+
const instructions = [];
|
|
63
|
+
const skills = [];
|
|
64
|
+
for (const directory of directories) {
|
|
65
|
+
const file = path.join(directory, "AGENTS.md");
|
|
66
|
+
const content = yield* Effect.option(fs.readFileString(file));
|
|
67
|
+
if (Option.isSome(content) && content.value.trim() !== "") {
|
|
68
|
+
instructions.push({
|
|
69
|
+
id: `AGENTS.md:${file}`,
|
|
70
|
+
path: file,
|
|
71
|
+
directory,
|
|
72
|
+
content: cap(content.value),
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
skills.push(...(yield* AgentSkills.discoverProject(directory)));
|
|
76
|
+
}
|
|
77
|
+
return { instructions, skills };
|
|
78
|
+
});
|
|
79
|
+
const cap = (content) => content.length <= maxInstructionsChars
|
|
80
|
+
? content
|
|
81
|
+
: `${content.slice(0, maxInstructionsChars)}\n\n[Truncated: the file has ${content.length} characters; read it for the rest.]`;
|
|
82
|
+
/**
|
|
83
|
+
* One AGENTS.md as the model sees it, in the system prompt and in updates.
|
|
84
|
+
*
|
|
85
|
+
* @since 1.0.0
|
|
86
|
+
* @category Rendering
|
|
87
|
+
*/
|
|
88
|
+
export const renderInstructions = (instructions) => `# AGENTS.md
|
|
89
|
+
|
|
90
|
+
The following instructions are from ${instructions.path}.
|
|
91
|
+
They apply when working under ${instructions.directory}.
|
|
92
|
+
You do not need to read this file again.
|
|
93
|
+
|
|
94
|
+
**ALWAYS follow these instructions when working under ${instructions.directory}**:
|
|
95
|
+
|
|
96
|
+
<!-- AGENTS.md start -->
|
|
97
|
+
${instructions.content}
|
|
98
|
+
<!-- AGENTS.md end -->`;
|
|
99
|
+
/**
|
|
100
|
+
* The text of an environment update: new AGENTS.md files, outermost first,
|
|
101
|
+
* then new skills.
|
|
102
|
+
*
|
|
103
|
+
* @since 1.0.0
|
|
104
|
+
* @category Rendering
|
|
105
|
+
*/
|
|
106
|
+
export const renderUpdate = (discovered) => {
|
|
107
|
+
const sections = discovered.instructions.map(renderInstructions);
|
|
108
|
+
if (discovered.skills.length > 0) {
|
|
109
|
+
sections.push(`# Skills
|
|
110
|
+
|
|
111
|
+
New skills are available, in addition to those listed before. A skill listed
|
|
112
|
+
here takes precedence over an earlier skill with the same name. Read a skill's
|
|
113
|
+
file with "readFile" before a task that matches its description.
|
|
114
|
+
|
|
115
|
+
${AgentSkills.renderEntries(discovered.skills)}`);
|
|
116
|
+
}
|
|
117
|
+
return sections.join("\n\n");
|
|
118
|
+
};
|
|
119
|
+
//# sourceMappingURL=AgentEnvironment.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AgentEnvironment.js","sourceRoot":"","sources":["../src/AgentEnvironment.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AgentEnvironment.test.d.ts","sourceRoot":"","sources":["../src/AgentEnvironment.test.ts"],"names":[],"mappings":""}
|