@buildanagent/harness 0.0.0-bootstrap.0 → 0.1.0-alpha.28
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 +54 -0
- package/LICENSE-APACHE +202 -0
- package/LICENSE-MIT +21 -0
- package/README.md +717 -0
- package/dist/ablation.d.ts +2 -0
- package/dist/ablation.js +3 -0
- package/dist/ablation.js.map +1 -0
- package/dist/completion/check.d.ts +64 -0
- package/dist/completion/check.js +152 -0
- package/dist/completion/check.js.map +1 -0
- package/dist/completion/checks.d.ts +45 -0
- package/dist/completion/checks.js +173 -0
- package/dist/completion/checks.js.map +1 -0
- package/dist/completion/flags.d.ts +25 -0
- package/dist/completion/flags.js +87 -0
- package/dist/completion/flags.js.map +1 -0
- package/dist/completion/index.d.ts +8 -0
- package/dist/completion/index.js +9 -0
- package/dist/completion/index.js.map +1 -0
- package/dist/completion/snapshot.d.ts +33 -0
- package/dist/completion/snapshot.js +83 -0
- package/dist/completion/snapshot.js.map +1 -0
- package/dist/context/cap.d.ts +32 -0
- package/dist/context/cap.js +50 -0
- package/dist/context/cap.js.map +1 -0
- package/dist/context/estimate.d.ts +18 -0
- package/dist/context/estimate.js +20 -0
- package/dist/context/estimate.js.map +1 -0
- package/dist/context/file-spill.d.ts +5 -0
- package/dist/context/file-spill.js +25 -0
- package/dist/context/file-spill.js.map +1 -0
- package/dist/context/index.d.ts +10 -0
- package/dist/context/index.js +10 -0
- package/dist/context/index.js.map +1 -0
- package/dist/context/mask.d.ts +27 -0
- package/dist/context/mask.js +71 -0
- package/dist/context/mask.js.map +1 -0
- package/dist/context/mid-turn.d.ts +40 -0
- package/dist/context/mid-turn.js +82 -0
- package/dist/context/mid-turn.js.map +1 -0
- package/dist/context/policy.d.ts +9 -0
- package/dist/context/policy.js +140 -0
- package/dist/context/policy.js.map +1 -0
- package/dist/context/spill-ledger.d.ts +25 -0
- package/dist/context/spill-ledger.js +54 -0
- package/dist/context/spill-ledger.js.map +1 -0
- package/dist/context/spill.d.ts +6 -0
- package/dist/context/spill.js +14 -0
- package/dist/context/spill.js.map +1 -0
- package/dist/context/summarize.d.ts +53 -0
- package/dist/context/summarize.js +204 -0
- package/dist/context/summarize.js.map +1 -0
- package/dist/context/summary-template.d.ts +29 -0
- package/dist/context/summary-template.js +69 -0
- package/dist/context/summary-template.js.map +1 -0
- package/dist/context/types.d.ts +150 -0
- package/dist/context/types.js +2 -0
- package/dist/context/types.js.map +1 -0
- package/dist/context/write-cap.d.ts +19 -0
- package/dist/context/write-cap.js +41 -0
- package/dist/context/write-cap.js.map +1 -0
- package/dist/create-harness.d.ts +7 -0
- package/dist/create-harness.js +21 -0
- package/dist/create-harness.js.map +1 -0
- package/dist/credentials/addresses.d.ts +14 -0
- package/dist/credentials/addresses.js +144 -0
- package/dist/credentials/addresses.js.map +1 -0
- package/dist/credentials/allowlist.d.ts +34 -0
- package/dist/credentials/allowlist.js +77 -0
- package/dist/credentials/allowlist.js.map +1 -0
- package/dist/credentials/egress-proxy.d.ts +70 -0
- package/dist/credentials/egress-proxy.js +482 -0
- package/dist/credentials/egress-proxy.js.map +1 -0
- package/dist/credentials/index.d.ts +9 -0
- package/dist/credentials/index.js +10 -0
- package/dist/credentials/index.js.map +1 -0
- package/dist/credentials/scrub.d.ts +16 -0
- package/dist/credentials/scrub.js +93 -0
- package/dist/credentials/scrub.js.map +1 -0
- package/dist/errors.d.ts +56 -0
- package/dist/errors.js +63 -0
- package/dist/errors.js.map +1 -0
- package/dist/extensions/compose.d.ts +27 -0
- package/dist/extensions/compose.js +83 -0
- package/dist/extensions/compose.js.map +1 -0
- package/dist/extensions/context-files-node.d.ts +28 -0
- package/dist/extensions/context-files-node.js +74 -0
- package/dist/extensions/context-files-node.js.map +1 -0
- package/dist/extensions/context-files.d.ts +68 -0
- package/dist/extensions/context-files.js +214 -0
- package/dist/extensions/context-files.js.map +1 -0
- package/dist/extensions/digest.d.ts +6 -0
- package/dist/extensions/digest.js +68 -0
- package/dist/extensions/digest.js.map +1 -0
- package/dist/extensions/index.d.ts +10 -0
- package/dist/extensions/index.js +10 -0
- package/dist/extensions/index.js.map +1 -0
- package/dist/extensions/load.d.ts +42 -0
- package/dist/extensions/load.js +211 -0
- package/dist/extensions/load.js.map +1 -0
- package/dist/extensions/lock.d.ts +8 -0
- package/dist/extensions/lock.js +95 -0
- package/dist/extensions/lock.js.map +1 -0
- package/dist/extensions/node.d.ts +10 -0
- package/dist/extensions/node.js +11 -0
- package/dist/extensions/node.js.map +1 -0
- package/dist/extensions/project-dirs.d.ts +24 -0
- package/dist/extensions/project-dirs.js +97 -0
- package/dist/extensions/project-dirs.js.map +1 -0
- package/dist/extensions/skills-node.d.ts +34 -0
- package/dist/extensions/skills-node.js +123 -0
- package/dist/extensions/skills-node.js.map +1 -0
- package/dist/extensions/skills.d.ts +51 -0
- package/dist/extensions/skills.js +175 -0
- package/dist/extensions/skills.js.map +1 -0
- package/dist/extensions/trust-file.d.ts +3 -0
- package/dist/extensions/trust-file.js +62 -0
- package/dist/extensions/trust-file.js.map +1 -0
- package/dist/extensions/trust-store-node.d.ts +10 -0
- package/dist/extensions/trust-store-node.js +33 -0
- package/dist/extensions/trust-store-node.js.map +1 -0
- package/dist/extensions/types.d.ts +42 -0
- package/dist/extensions/types.js +2 -0
- package/dist/extensions/types.js.map +1 -0
- package/dist/harness.d.ts +156 -0
- package/dist/harness.js +2 -0
- package/dist/harness.js.map +1 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +5 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/connection.d.ts +22 -0
- package/dist/mcp/connection.js +267 -0
- package/dist/mcp/connection.js.map +1 -0
- package/dist/mcp/content.d.ts +27 -0
- package/dist/mcp/content.js +177 -0
- package/dist/mcp/content.js.map +1 -0
- package/dist/mcp/errors.d.ts +19 -0
- package/dist/mcp/errors.js +21 -0
- package/dist/mcp/errors.js.map +1 -0
- package/dist/mcp/index.d.ts +10 -0
- package/dist/mcp/index.js +10 -0
- package/dist/mcp/index.js.map +1 -0
- package/dist/mcp/manager.d.ts +7 -0
- package/dist/mcp/manager.js +173 -0
- package/dist/mcp/manager.js.map +1 -0
- package/dist/mcp/record.d.ts +7 -0
- package/dist/mcp/record.js +20 -0
- package/dist/mcp/record.js.map +1 -0
- package/dist/mcp/stdio.d.ts +39 -0
- package/dist/mcp/stdio.js +382 -0
- package/dist/mcp/stdio.js.map +1 -0
- package/dist/mcp/types.d.ts +172 -0
- package/dist/mcp/types.js +2 -0
- package/dist/mcp/types.js.map +1 -0
- package/dist/memory/index.d.ts +2 -0
- package/dist/memory/index.js +3 -0
- package/dist/memory/index.js.map +1 -0
- package/dist/permissions/default-rules.d.ts +7 -0
- package/dist/permissions/default-rules.js +42 -0
- package/dist/permissions/default-rules.js.map +1 -0
- package/dist/permissions/errors.d.ts +11 -0
- package/dist/permissions/errors.js +14 -0
- package/dist/permissions/errors.js.map +1 -0
- package/dist/permissions/index.d.ts +9 -0
- package/dist/permissions/index.js +9 -0
- package/dist/permissions/index.js.map +1 -0
- package/dist/permissions/match.d.ts +33 -0
- package/dist/permissions/match.js +287 -0
- package/dist/permissions/match.js.map +1 -0
- package/dist/permissions/pipeline.d.ts +9 -0
- package/dist/permissions/pipeline.js +235 -0
- package/dist/permissions/pipeline.js.map +1 -0
- package/dist/permissions/rules.d.ts +22 -0
- package/dist/permissions/rules.js +74 -0
- package/dist/permissions/rules.js.map +1 -0
- package/dist/permissions/shadow.d.ts +5 -0
- package/dist/permissions/shadow.js +22 -0
- package/dist/permissions/shadow.js.map +1 -0
- package/dist/permissions/types.d.ts +104 -0
- package/dist/permissions/types.js +2 -0
- package/dist/permissions/types.js.map +1 -0
- package/dist/sandbox/base.d.ts +35 -0
- package/dist/sandbox/base.js +60 -0
- package/dist/sandbox/base.js.map +1 -0
- package/dist/sandbox/docker/index.d.ts +35 -0
- package/dist/sandbox/docker/index.js +448 -0
- package/dist/sandbox/docker/index.js.map +1 -0
- package/dist/sandbox/errors.d.ts +16 -0
- package/dist/sandbox/errors.js +22 -0
- package/dist/sandbox/errors.js.map +1 -0
- package/dist/sandbox/host-files.d.ts +63 -0
- package/dist/sandbox/host-files.js +248 -0
- package/dist/sandbox/host-files.js.map +1 -0
- package/dist/sandbox/index.d.ts +8 -0
- package/dist/sandbox/index.js +8 -0
- package/dist/sandbox/index.js.map +1 -0
- package/dist/sandbox/none.d.ts +17 -0
- package/dist/sandbox/none.js +108 -0
- package/dist/sandbox/none.js.map +1 -0
- package/dist/sandbox/process.d.ts +61 -0
- package/dist/sandbox/process.js +253 -0
- package/dist/sandbox/process.js.map +1 -0
- package/dist/sandbox/spawn-env.d.ts +20 -0
- package/dist/sandbox/spawn-env.js +128 -0
- package/dist/sandbox/spawn-env.js.map +1 -0
- package/dist/sandbox/srt/index.d.ts +35 -0
- package/dist/sandbox/srt/index.js +264 -0
- package/dist/sandbox/srt/index.js.map +1 -0
- package/dist/sandbox/srt/settings.d.ts +48 -0
- package/dist/sandbox/srt/settings.js +31 -0
- package/dist/sandbox/srt/settings.js.map +1 -0
- package/dist/sandbox/types.d.ts +88 -0
- package/dist/sandbox/types.js +6 -0
- package/dist/sandbox/types.js.map +1 -0
- package/dist/server/answers.d.ts +16 -0
- package/dist/server/answers.js +43 -0
- package/dist/server/answers.js.map +1 -0
- package/dist/server/connection.d.ts +99 -0
- package/dist/server/connection.js +309 -0
- package/dist/server/connection.js.map +1 -0
- package/dist/server/dispatcher.d.ts +86 -0
- package/dist/server/dispatcher.js +800 -0
- package/dist/server/dispatcher.js.map +1 -0
- package/dist/server/index.d.ts +13 -0
- package/dist/server/index.js +12 -0
- package/dist/server/index.js.map +1 -0
- package/dist/server/local-transport.d.ts +44 -0
- package/dist/server/local-transport.js +103 -0
- package/dist/server/local-transport.js.map +1 -0
- package/dist/server/outbox.d.ts +31 -0
- package/dist/server/outbox.js +130 -0
- package/dist/server/outbox.js.map +1 -0
- package/dist/server/params.d.ts +25 -0
- package/dist/server/params.js +112 -0
- package/dist/server/params.js.map +1 -0
- package/dist/server/protocol.schema.json +2448 -0
- package/dist/server/rpc-session.d.ts +43 -0
- package/dist/server/rpc-session.js +167 -0
- package/dist/server/rpc-session.js.map +1 -0
- package/dist/server/stdio-streams.d.ts +67 -0
- package/dist/server/stdio-streams.js +218 -0
- package/dist/server/stdio-streams.js.map +1 -0
- package/dist/server/stdio.d.ts +59 -0
- package/dist/server/stdio.js +189 -0
- package/dist/server/stdio.js.map +1 -0
- package/dist/server/websocket.d.ts +106 -0
- package/dist/server/websocket.js +327 -0
- package/dist/server/websocket.js.map +1 -0
- package/dist/session/approvals.d.ts +81 -0
- package/dist/session/approvals.js +217 -0
- package/dist/session/approvals.js.map +1 -0
- package/dist/session/code-call-log.d.ts +42 -0
- package/dist/session/code-call-log.js +63 -0
- package/dist/session/code-call-log.js.map +1 -0
- package/dist/session/code-call-result.d.ts +19 -0
- package/dist/session/code-call-result.js +95 -0
- package/dist/session/code-call-result.js.map +1 -0
- package/dist/session/code-call.d.ts +49 -0
- package/dist/session/code-call.js +345 -0
- package/dist/session/code-call.js.map +1 -0
- package/dist/session/effect-scope.d.ts +11 -0
- package/dist/session/effect-scope.js +10 -0
- package/dist/session/effect-scope.js.map +1 -0
- package/dist/session/errors.d.ts +19 -0
- package/dist/session/errors.js +27 -0
- package/dist/session/errors.js.map +1 -0
- package/dist/session/file-index.d.ts +8 -0
- package/dist/session/file-index.js +70 -0
- package/dist/session/file-index.js.map +1 -0
- package/dist/session/file-key-store.d.ts +16 -0
- package/dist/session/file-key-store.js +169 -0
- package/dist/session/file-key-store.js.map +1 -0
- package/dist/session/file-lock.d.ts +52 -0
- package/dist/session/file-lock.js +324 -0
- package/dist/session/file-lock.js.map +1 -0
- package/dist/session/index.d.ts +22 -0
- package/dist/session/index.js +20 -0
- package/dist/session/index.js.map +1 -0
- package/dist/session/jsonl-store.d.ts +37 -0
- package/dist/session/jsonl-store.js +386 -0
- package/dist/session/jsonl-store.js.map +1 -0
- package/dist/session/jsonl.d.ts +9 -0
- package/dist/session/jsonl.js +10 -0
- package/dist/session/jsonl.js.map +1 -0
- package/dist/session/lock.d.ts +19 -0
- package/dist/session/lock.js +2 -0
- package/dist/session/lock.js.map +1 -0
- package/dist/session/memory-store.d.ts +12 -0
- package/dist/session/memory-store.js +60 -0
- package/dist/session/memory-store.js.map +1 -0
- package/dist/session/migrate.d.ts +41 -0
- package/dist/session/migrate.js +86 -0
- package/dist/session/migrate.js.map +1 -0
- package/dist/session/pointer.d.ts +15 -0
- package/dist/session/pointer.js +22 -0
- package/dist/session/pointer.js.map +1 -0
- package/dist/session/rebuild.d.ts +53 -0
- package/dist/session/rebuild.js +230 -0
- package/dist/session/rebuild.js.map +1 -0
- package/dist/session/resume.d.ts +26 -0
- package/dist/session/resume.js +128 -0
- package/dist/session/resume.js.map +1 -0
- package/dist/session/retention.d.ts +97 -0
- package/dist/session/retention.js +702 -0
- package/dist/session/retention.js.map +1 -0
- package/dist/session/runner.d.ts +156 -0
- package/dist/session/runner.js +656 -0
- package/dist/session/runner.js.map +1 -0
- package/dist/session/scheduler.d.ts +47 -0
- package/dist/session/scheduler.js +85 -0
- package/dist/session/scheduler.js.map +1 -0
- package/dist/session/secret-key-store.d.ts +47 -0
- package/dist/session/secret-key-store.js +79 -0
- package/dist/session/secret-key-store.js.map +1 -0
- package/dist/session/session.d.ts +106 -0
- package/dist/session/session.js +353 -0
- package/dist/session/session.js.map +1 -0
- package/dist/session/sticky.d.ts +48 -0
- package/dist/session/sticky.js +232 -0
- package/dist/session/sticky.js.map +1 -0
- package/dist/session/store.d.ts +108 -0
- package/dist/session/store.js +163 -0
- package/dist/session/store.js.map +1 -0
- package/dist/telemetry/index.d.ts +2 -0
- package/dist/telemetry/index.js +3 -0
- package/dist/telemetry/index.js.map +1 -0
- package/dist/testing/fake-sandbox.d.ts +34 -0
- package/dist/testing/fake-sandbox.js +221 -0
- package/dist/testing/fake-sandbox.js.map +1 -0
- package/dist/testing/index.d.ts +10 -0
- package/dist/testing/index.js +11 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/testing/key-store-conformance.d.ts +22 -0
- package/dist/testing/key-store-conformance.js +97 -0
- package/dist/testing/key-store-conformance.js.map +1 -0
- package/dist/testing/run-cases.d.ts +21 -0
- package/dist/testing/run-cases.js +20 -0
- package/dist/testing/run-cases.js.map +1 -0
- package/dist/testing/sandbox-conformance.d.ts +64 -0
- package/dist/testing/sandbox-conformance.js +361 -0
- package/dist/testing/sandbox-conformance.js.map +1 -0
- package/dist/testing/scheduler-conformance.d.ts +32 -0
- package/dist/testing/scheduler-conformance.js +72 -0
- package/dist/testing/scheduler-conformance.js.map +1 -0
- package/dist/testing/store-conformance.d.ts +21 -0
- package/dist/testing/store-conformance.js +320 -0
- package/dist/testing/store-conformance.js.map +1 -0
- package/dist/tools/errors.d.ts +13 -0
- package/dist/tools/errors.js +17 -0
- package/dist/tools/errors.js.map +1 -0
- package/dist/tools/index.d.ts +8 -0
- package/dist/tools/index.js +8 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/registry.d.ts +3 -0
- package/dist/tools/registry.js +234 -0
- package/dist/tools/registry.js.map +1 -0
- package/dist/tools/tool-search.d.ts +30 -0
- package/dist/tools/tool-search.js +118 -0
- package/dist/tools/tool-search.js.map +1 -0
- package/dist/tools/types.d.ts +106 -0
- package/dist/tools/types.js +2 -0
- package/dist/tools/types.js.map +1 -0
- package/llms.txt +435 -0
- package/package.json +119 -5
|
@@ -0,0 +1,320 @@
|
|
|
1
|
+
import { isHarnessError } from "../errors.js";
|
|
2
|
+
import { ConflictError, EntryTooLargeError } from "../session/errors.js";
|
|
3
|
+
import { runCases } from "./run-cases.js";
|
|
4
|
+
const ADA = { userId: "ada", sessionId: "s1" };
|
|
5
|
+
const BOB = { userId: "bob", sessionId: "s1" };
|
|
6
|
+
function check(condition, message) {
|
|
7
|
+
if (!condition)
|
|
8
|
+
throw new Error(`Session store conformance: ${message}`);
|
|
9
|
+
}
|
|
10
|
+
const header = (id = "h1", timestamp = "2026-01-01T00:00:00.000Z") => ({
|
|
11
|
+
id,
|
|
12
|
+
parentId: null,
|
|
13
|
+
timestamp,
|
|
14
|
+
origin: "harness",
|
|
15
|
+
type: "session_header",
|
|
16
|
+
formatVersion: 1,
|
|
17
|
+
harnessVersion: "0.0.0",
|
|
18
|
+
sdkVersion: "0.0.0",
|
|
19
|
+
defaultsHash: "d",
|
|
20
|
+
capabilities: [],
|
|
21
|
+
ablationHash: "a",
|
|
22
|
+
});
|
|
23
|
+
const record = (id, parentId, data = {}) => ({
|
|
24
|
+
id,
|
|
25
|
+
parentId,
|
|
26
|
+
timestamp: "2026-01-01T00:00:01.000Z",
|
|
27
|
+
origin: "harness",
|
|
28
|
+
type: "product_record",
|
|
29
|
+
name: "test.record",
|
|
30
|
+
data,
|
|
31
|
+
});
|
|
32
|
+
async function collect(source) {
|
|
33
|
+
const found = [];
|
|
34
|
+
for await (const entry of source)
|
|
35
|
+
found.push(entry);
|
|
36
|
+
return found;
|
|
37
|
+
}
|
|
38
|
+
const ids = (entries) => entries.map((entry) => entry.id);
|
|
39
|
+
async function rejects(run, test, message) {
|
|
40
|
+
try {
|
|
41
|
+
await run();
|
|
42
|
+
}
|
|
43
|
+
catch (error) {
|
|
44
|
+
check(test(error), `${message}, but it threw ${String(error)}`);
|
|
45
|
+
return;
|
|
46
|
+
}
|
|
47
|
+
check(false, `${message}, but it did not throw`);
|
|
48
|
+
}
|
|
49
|
+
const hasCode = (code) => (error) => isHarnessError(error) && error.code === code;
|
|
50
|
+
function appendCases(open) {
|
|
51
|
+
const cases = [
|
|
52
|
+
[
|
|
53
|
+
"append assigns seq from 0 and load returns the entries in order",
|
|
54
|
+
async ({ store }) => {
|
|
55
|
+
const written = await store.append(ADA, [header(), record("r1", "h1"), record("r2", "r1")]);
|
|
56
|
+
check(written.map((entry) => entry.seq).join() === "0,1,2", "append returns each entry with its seq");
|
|
57
|
+
const loaded = await collect(store.load(ADA));
|
|
58
|
+
check(ids(loaded).join() === "h1,r1,r2", "load returns the entries in order");
|
|
59
|
+
const more = await store.append(ADA, [record("r3", "r2")]);
|
|
60
|
+
check(more[0]?.seq === 3, "a later append goes on from the last seq");
|
|
61
|
+
},
|
|
62
|
+
],
|
|
63
|
+
[
|
|
64
|
+
"appending the same entry twice stores it once",
|
|
65
|
+
async ({ store }) => {
|
|
66
|
+
await store.append(ADA, [header(), record("r1", "h1")]);
|
|
67
|
+
const again = await store.append(ADA, [record("r1", "h1")]);
|
|
68
|
+
check(again.length === 1 && again[0]?.seq === 1, "the retry returns the stored entry");
|
|
69
|
+
check((await collect(store.load(ADA))).length === 2, "the entry is in the log once");
|
|
70
|
+
},
|
|
71
|
+
],
|
|
72
|
+
[
|
|
73
|
+
"an entry id stored with different content is a ConflictError",
|
|
74
|
+
async ({ store }) => {
|
|
75
|
+
await store.append(ADA, [header(), record("r1", "h1", { a: 1 })]);
|
|
76
|
+
await rejects(() => store.append(ADA, [record("r1", "h1", { a: 2 })]), (error) => error instanceof ConflictError && isHarnessError(error) && error.code === "session_conflict", "reusing an id with other content must throw a ConflictError");
|
|
77
|
+
const same = await store.append(ADA, [record("r1", "h1", { a: 1 })]);
|
|
78
|
+
check(same.length === 1, "the same content under that id is still a retry");
|
|
79
|
+
},
|
|
80
|
+
],
|
|
81
|
+
[
|
|
82
|
+
"a batch that is partly stored finishes on a retry, and one stored out of order conflicts",
|
|
83
|
+
async ({ store }) => {
|
|
84
|
+
await store.append(ADA, [header(), record("r1", "h1")]);
|
|
85
|
+
const finished = await store.append(ADA, [record("r1", "h1"), record("r2", "r1")]);
|
|
86
|
+
check(ids(finished).join() === "r1,r2" && finished[1]?.seq === 2, "the stored prefix is kept and the rest written");
|
|
87
|
+
await rejects(() => store.append(ADA, [record("r3", "r2"), record("r1", "h1")]), (error) => error instanceof ConflictError, "a stored entry after a new one must conflict");
|
|
88
|
+
check((await collect(store.load(ADA))).length === 3, "the failed batch wrote nothing");
|
|
89
|
+
},
|
|
90
|
+
],
|
|
91
|
+
];
|
|
92
|
+
return cases.map(([name, body]) => ({ name, run: () => open(body) }));
|
|
93
|
+
}
|
|
94
|
+
function conflictCases(open) {
|
|
95
|
+
const cases = [
|
|
96
|
+
[
|
|
97
|
+
"a retry of a partly stored batch conflicts once another writer has extended the log",
|
|
98
|
+
async ({ store }) => {
|
|
99
|
+
await store.append(ADA, [header()]);
|
|
100
|
+
await store.append(ADA, [record("a1", "h1")], { expectedLastId: "h1" });
|
|
101
|
+
await store.append(ADA, [record("b1", "a1")], { expectedLastId: "a1" });
|
|
102
|
+
await rejects(() => store.append(ADA, [record("a1", "h1"), record("a2", "a1")], { expectedLastId: "h1" }), (error) => error instanceof ConflictError, "a1 is stored but is no longer the end of the log, so a2 must not be written after b1");
|
|
103
|
+
check(ids(await collect(store.load(ADA))).join() === "h1,a1,b1", "the retry wrote nothing");
|
|
104
|
+
},
|
|
105
|
+
],
|
|
106
|
+
[
|
|
107
|
+
"a stale expectedLastId is a ConflictError and writes nothing",
|
|
108
|
+
async ({ store }) => {
|
|
109
|
+
await rejects(() => store.append(ADA, [header()], { expectedLastId: "x" }), (error) => error instanceof ConflictError, "a new session expects null, not an id");
|
|
110
|
+
await store.append(ADA, [header()], { expectedLastId: null });
|
|
111
|
+
await store.append(ADA, [record("r1", "h1")], { expectedLastId: "h1" });
|
|
112
|
+
await rejects(() => store.append(ADA, [record("r2", "r1")], { expectedLastId: "h1" }), (error) => error instanceof ConflictError, "an old tail must conflict");
|
|
113
|
+
await rejects(() => store.append(ADA, [record("r2", "r1")], { expectedLastId: null }), (error) => error instanceof ConflictError, "null on a session that exists must conflict");
|
|
114
|
+
check(ids(await collect(store.load(ADA))).join() === "h1,r1", "the failed appends wrote nothing");
|
|
115
|
+
},
|
|
116
|
+
],
|
|
117
|
+
[
|
|
118
|
+
"a load yields the entries present when it began, even if the caller appends while it iterates",
|
|
119
|
+
async ({ store }) => {
|
|
120
|
+
await store.append(ADA, [header(), record("r1", "h1")]);
|
|
121
|
+
const seen = [];
|
|
122
|
+
for await (const entry of store.load(ADA)) {
|
|
123
|
+
seen.push(entry.id);
|
|
124
|
+
if (seen.length < 5)
|
|
125
|
+
await store.append(ADA, [record(`n${seen.length}`, entry.id)]);
|
|
126
|
+
}
|
|
127
|
+
check(seen.join() === "h1,r1", "the loop saw the two entries that existed, and ended");
|
|
128
|
+
check((await collect(store.load(ADA))).length === 4, "the two appends made during it were stored");
|
|
129
|
+
},
|
|
130
|
+
],
|
|
131
|
+
[
|
|
132
|
+
"load from a sequence skips the earlier entries",
|
|
133
|
+
async ({ store }) => {
|
|
134
|
+
await store.append(ADA, [header(), record("r1", "h1"), record("r2", "r1")]);
|
|
135
|
+
check(ids(await collect(store.load(ADA, { fromSeq: 1 }))).join() === "r1,r2", "fromSeq 1 starts at seq 1");
|
|
136
|
+
check((await collect(store.load(ADA, { fromSeq: 9 }))).length === 0, "past the end yields nothing");
|
|
137
|
+
},
|
|
138
|
+
],
|
|
139
|
+
];
|
|
140
|
+
return cases.map(([name, body]) => ({ name, run: () => open(body) }));
|
|
141
|
+
}
|
|
142
|
+
function validationCases(open) {
|
|
143
|
+
const cases = [
|
|
144
|
+
[
|
|
145
|
+
"a first entry that is not a header, a second header and an invalid entry are refused",
|
|
146
|
+
async ({ store }) => {
|
|
147
|
+
const invalid = hasCode("invalid_session_entry");
|
|
148
|
+
await rejects(() => store.append(ADA, [record("r1", "h1")]), invalid, "a log must start with a header");
|
|
149
|
+
await store.append(ADA, [header()]);
|
|
150
|
+
await rejects(() => store.append(ADA, [header("h2")]), invalid, "only the first entry may be a header");
|
|
151
|
+
await rejects(() => store.append(ADA, [{ ...record("r1", "h1"), timestamp: "yesterday" }]), invalid, "an entry the protocol rejects must be refused");
|
|
152
|
+
await rejects(() => store.append(ADA, [record("r1", "h1"), record("r1", "h1")]), invalid, "a batch repeating an id must be refused");
|
|
153
|
+
check((await collect(store.load(ADA))).length === 1, "refused appends wrote nothing");
|
|
154
|
+
},
|
|
155
|
+
],
|
|
156
|
+
[
|
|
157
|
+
"an entry over 64 KiB is an EntryTooLargeError, and a batch with one writes none of it",
|
|
158
|
+
async ({ store }) => {
|
|
159
|
+
const big = record("big", "h1", { text: "x".repeat(64 * 1024) });
|
|
160
|
+
await store.append(ADA, [header()]);
|
|
161
|
+
await rejects(() => store.append(ADA, [record("ok", "h1"), big]), (error) => error instanceof EntryTooLargeError && error.entryId === "big" && error.maxBytes === 64 * 1024, "an oversize entry must throw an EntryTooLargeError");
|
|
162
|
+
check((await collect(store.load(ADA))).length === 1, "the small entry before it was not written either");
|
|
163
|
+
await store.append(ADA, [record("small", "h1", { text: "x".repeat(60 * 1024) })]);
|
|
164
|
+
},
|
|
165
|
+
],
|
|
166
|
+
];
|
|
167
|
+
return cases.map(([name, body]) => ({ name, run: () => open(body) }));
|
|
168
|
+
}
|
|
169
|
+
function identityCases(open) {
|
|
170
|
+
const cases = [
|
|
171
|
+
[
|
|
172
|
+
"a caller that changes an entry after appending it does not change the stored one",
|
|
173
|
+
async ({ store }) => {
|
|
174
|
+
const data = { a: 1 };
|
|
175
|
+
await store.append(ADA, [header(), record("r1", "h1", data)]);
|
|
176
|
+
data.a = 2;
|
|
177
|
+
const again = await store.append(ADA, [record("r1", "h1", { a: 1 })]);
|
|
178
|
+
check(again.length === 1, "a retry with the original content is still a retry");
|
|
179
|
+
await rejects(() => store.append(ADA, [record("r1", "h1", { a: 2 })]), (error) => error instanceof ConflictError, "the changed content must conflict, because the stored entry did not change");
|
|
180
|
+
const [, stored] = await collect(store.load(ADA));
|
|
181
|
+
stored.data.a = 9;
|
|
182
|
+
check((await collect(store.load(ADA)))[1].data.a === 1, "a loaded entry is a copy");
|
|
183
|
+
},
|
|
184
|
+
],
|
|
185
|
+
[
|
|
186
|
+
"ids that differ only in letter case are different users and sessions",
|
|
187
|
+
async ({ store }) => {
|
|
188
|
+
await store.append({ userId: "Ada", sessionId: "S1" }, [header("upper")]);
|
|
189
|
+
await store.append({ userId: "ada", sessionId: "s1" }, [header("lower")]);
|
|
190
|
+
check(ids(await collect(store.load({ userId: "Ada", sessionId: "S1" }))).join() === "upper", "Ada's S1 holds its own entries");
|
|
191
|
+
check(ids(await collect(store.load({ userId: "ada", sessionId: "s1" }))).join() === "lower", "and ada's s1 holds its own");
|
|
192
|
+
check((await collect(store.list("Ada"))).length === 1, "each user lists one session");
|
|
193
|
+
},
|
|
194
|
+
],
|
|
195
|
+
];
|
|
196
|
+
return cases.map(([name, body]) => ({ name, run: () => open(body) }));
|
|
197
|
+
}
|
|
198
|
+
function keyCases(open) {
|
|
199
|
+
const cases = [
|
|
200
|
+
[
|
|
201
|
+
"append rejects, and does not throw, for a key it can't use, and every store agrees on which keys those are",
|
|
202
|
+
async ({ store }) => {
|
|
203
|
+
const invalid = hasCode("invalid_session_key");
|
|
204
|
+
await rejects(() => store.append({ userId: "", sessionId: "s" }, [header()]), invalid, "an empty user is refused");
|
|
205
|
+
await rejects(() => store.append({ userId: "u", sessionId: "é".repeat(64) }, [header()]), invalid, "a name that encodes to over 200 bytes is refused by every store");
|
|
206
|
+
await rejects(() => store.append({ userId: "\ud800", sessionId: "s" }, [header()]), invalid, "a lone surrogate would encode like another id, so it is refused");
|
|
207
|
+
await store.append({ userId: "u", sessionId: "e".repeat(64) }, [header()]);
|
|
208
|
+
},
|
|
209
|
+
],
|
|
210
|
+
[
|
|
211
|
+
"a user id or session id that is empty or has a control character is refused",
|
|
212
|
+
async ({ store }) => {
|
|
213
|
+
const invalid = hasCode("invalid_session_key");
|
|
214
|
+
for (const key of [
|
|
215
|
+
{ userId: "", sessionId: "s" },
|
|
216
|
+
{ userId: "u", sessionId: "" },
|
|
217
|
+
{ userId: "u", sessionId: "a\nb" },
|
|
218
|
+
]) {
|
|
219
|
+
await rejects(() => store.append(key, [header()]), invalid, `${JSON.stringify(key)} must be refused`);
|
|
220
|
+
}
|
|
221
|
+
await store.append({ userId: "u/../x", sessionId: "../../y" }, [header()]);
|
|
222
|
+
check((await collect(store.load({ userId: "u/../x", sessionId: "../../y" }))).length === 1, "an id that looks like a path is a name, and works");
|
|
223
|
+
},
|
|
224
|
+
],
|
|
225
|
+
];
|
|
226
|
+
return cases.map(([name, body]) => ({ name, run: () => open(body) }));
|
|
227
|
+
}
|
|
228
|
+
function listAndOwnerCases(open) {
|
|
229
|
+
const cases = [
|
|
230
|
+
[
|
|
231
|
+
"list returns the user's sessions from their headers, oldest first, and delete removes one",
|
|
232
|
+
async ({ store }) => {
|
|
233
|
+
await store.append({ userId: "ada", sessionId: "late" }, [
|
|
234
|
+
header("h", "2026-01-02T00:00:00.000Z"),
|
|
235
|
+
record("r", "h"),
|
|
236
|
+
]);
|
|
237
|
+
await store.append({ userId: "ada", sessionId: "early" }, [header("h", "2026-01-01T00:00:00.000Z")]);
|
|
238
|
+
const listed = await collect(store.list("ada"));
|
|
239
|
+
check(listed.map((summary) => summary.sessionId).join() === "early,late", "list is oldest first");
|
|
240
|
+
const late = listed[1];
|
|
241
|
+
check(late?.entryCount === 2 && late.startedAt === "2026-01-02T00:00:00.000Z", "the summary comes from the entries");
|
|
242
|
+
await store.delete({ userId: "ada", sessionId: "early" });
|
|
243
|
+
check((await collect(store.list("ada"))).length === 1, "delete removes the session");
|
|
244
|
+
await store.delete({ userId: "ada", sessionId: "early" });
|
|
245
|
+
},
|
|
246
|
+
],
|
|
247
|
+
[
|
|
248
|
+
"another user's session looks the same as one that was never created",
|
|
249
|
+
async ({ store }) => {
|
|
250
|
+
await store.append(ADA, [header(), record("r1", "h1")]);
|
|
251
|
+
const neverMade = await collect(store.load({ userId: "bob", sessionId: "never" }));
|
|
252
|
+
const adasUnderBob = await collect(store.load(BOB));
|
|
253
|
+
check(neverMade.length === 0 && adasUnderBob.length === 0, "loading under another user yields nothing, as for a missing id");
|
|
254
|
+
check((await collect(store.list("bob"))).length === 0, "list under another user leaves it out");
|
|
255
|
+
await store.delete(BOB);
|
|
256
|
+
check((await collect(store.load(ADA))).length === 2, "delete under another user changed nothing");
|
|
257
|
+
await store.append(BOB, [header("hb")]);
|
|
258
|
+
check(ids(await collect(store.load(ADA))).join() === "h1,r1", "bob's session with the same id is a separate session");
|
|
259
|
+
check(ids(await collect(store.load(BOB))).join() === "hb", "and it holds only bob's entries");
|
|
260
|
+
},
|
|
261
|
+
],
|
|
262
|
+
];
|
|
263
|
+
return cases.map(([name, body]) => ({ name, run: () => open(body) }));
|
|
264
|
+
}
|
|
265
|
+
function tornCases(open) {
|
|
266
|
+
const needsTear = "the store gave no way to tear a log's last line";
|
|
267
|
+
const cases = [
|
|
268
|
+
[
|
|
269
|
+
"a torn last line is skipped by load and reported once, with every complete entry kept",
|
|
270
|
+
async ({ store, tearLastLine }) => {
|
|
271
|
+
if (tearLastLine === undefined)
|
|
272
|
+
return { skipped: needsTear };
|
|
273
|
+
await store.append(ADA, [header(), record("r1", "h1")]);
|
|
274
|
+
await tearLastLine(ADA);
|
|
275
|
+
const reports = [];
|
|
276
|
+
const loaded = await collect(store.load(ADA, { onTornLine: (line) => reports.push(line.bytes) }));
|
|
277
|
+
check(ids(loaded).join() === "h1,r1", "the complete entries load");
|
|
278
|
+
check(reports.length === 1 && (reports[0] ?? 0) > 0, "the torn line is reported once");
|
|
279
|
+
const clean = await collect(store.load({ userId: "ada", sessionId: "other" }, { onTornLine: () => check(false, "a clean log reports nothing") }));
|
|
280
|
+
check(clean.length === 0, "a missing session yields nothing");
|
|
281
|
+
},
|
|
282
|
+
],
|
|
283
|
+
[
|
|
284
|
+
"an append after a torn line cuts it off, so the next entry is not glued to it",
|
|
285
|
+
async ({ store, tearLastLine }) => {
|
|
286
|
+
if (tearLastLine === undefined)
|
|
287
|
+
return { skipped: needsTear };
|
|
288
|
+
await store.append(ADA, [header(), record("r1", "h1")]);
|
|
289
|
+
await tearLastLine(ADA);
|
|
290
|
+
const written = await store.append(ADA, [record("r2", "r1")], { expectedLastId: "r1" });
|
|
291
|
+
check(written[0]?.seq === 2, "the new entry follows the last complete one");
|
|
292
|
+
const reports = [];
|
|
293
|
+
const loaded = await collect(store.load(ADA, { onTornLine: (line) => reports.push(line.bytes) }));
|
|
294
|
+
check(ids(loaded).join() === "h1,r1,r2" && reports.length === 0, "the log is whole again");
|
|
295
|
+
},
|
|
296
|
+
],
|
|
297
|
+
];
|
|
298
|
+
return cases.map(([name, body]) => ({ name, run: () => open(body) }));
|
|
299
|
+
}
|
|
300
|
+
/** Every conformance case, each against a store from `factory`. */
|
|
301
|
+
export function storeConformanceCases(factory) {
|
|
302
|
+
const open = async (body) => {
|
|
303
|
+
const outcome = await body(await factory());
|
|
304
|
+
return typeof outcome === "object" && outcome !== null && "skipped" in outcome ? outcome : undefined;
|
|
305
|
+
};
|
|
306
|
+
return [
|
|
307
|
+
...appendCases(open),
|
|
308
|
+
...conflictCases(open),
|
|
309
|
+
...validationCases(open),
|
|
310
|
+
...identityCases(open),
|
|
311
|
+
...keyCases(open),
|
|
312
|
+
...listAndOwnerCases(open),
|
|
313
|
+
...tornCases(open),
|
|
314
|
+
];
|
|
315
|
+
}
|
|
316
|
+
/** Runs every case and reports which passed, which skipped with a reason and which failed. */
|
|
317
|
+
export async function runStoreConformance(factory) {
|
|
318
|
+
return runCases(storeConformanceCases(factory));
|
|
319
|
+
}
|
|
320
|
+
//# sourceMappingURL=store-conformance.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"store-conformance.js","sourceRoot":"","sources":["../../src/testing/store-conformance.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The session store conformance suite: what every `SessionStore` must do. The cases import no test runner and no Node\n * module, so any runner can call them, in workerd too. A case that needs a backend to expose a file skips, and\n * reports why, when the factory gives it no `tearLastLine`.\n */\nimport type { SessionEntry } from \"@buildanagent/protocol\";\nimport { isHarnessError } from \"../errors.js\";\nimport { ConflictError, EntryTooLargeError } from \"../session/errors.js\";\nimport type { EntryInput, SessionKey, SessionStore } from \"../session/store.js\";\nimport { type CaseReport, type RunnableCase, runCases } from \"./run-cases.js\";\n\n/** What a factory returns: a fresh, empty store, and optionally a way to tear a log's last line. */\nexport interface StoreUnderTest {\n readonly store: SessionStore;\n /**\n * Leaves the session's log ending in a line that was never completed, as a crash in the middle of a write would, by\n * appending partial JSON with no newline. Without it the torn-line cases skip, because a store need not be a file.\n */\n readonly tearLastLine?: (key: SessionKey) => void | Promise<void>;\n}\n\n/** Makes a fresh store for each case. */\nexport type StoreFactory = () => StoreUnderTest | Promise<StoreUnderTest>;\n\n/** One case of the store conformance suite, which a runner can register as a test of its own. */\nexport type StoreCase = RunnableCase;\n\n/** The report the store conformance suite returns: which cases passed, which skipped with a reason and which failed. */\nexport type StoreConformanceReport = CaseReport;\n\nconst ADA: SessionKey = { userId: \"ada\", sessionId: \"s1\" };\nconst BOB = { userId: \"bob\", sessionId: \"s1\" };\n\nfunction check(condition: boolean, message: string): asserts condition {\n if (!condition) throw new Error(`Session store conformance: ${message}`);\n}\n\nconst header = (id = \"h1\", timestamp = \"2026-01-01T00:00:00.000Z\"): EntryInput => ({\n id,\n parentId: null,\n timestamp,\n origin: \"harness\",\n type: \"session_header\",\n formatVersion: 1,\n harnessVersion: \"0.0.0\",\n sdkVersion: \"0.0.0\",\n defaultsHash: \"d\",\n capabilities: [],\n ablationHash: \"a\",\n});\n\nconst record = (id: string, parentId: string, data: unknown = {}): EntryInput => ({\n id,\n parentId,\n timestamp: \"2026-01-01T00:00:01.000Z\",\n origin: \"harness\",\n type: \"product_record\",\n name: \"test.record\",\n data,\n});\n\nasync function collect<T>(source: AsyncIterable<T>): Promise<T[]> {\n const found: T[] = [];\n for await (const entry of source) found.push(entry);\n return found;\n}\n\nconst ids = (entries: readonly SessionEntry[]) => entries.map((entry) => entry.id);\n\nasync function rejects(run: () => Promise<unknown>, test: (error: unknown) => boolean, message: string) {\n try {\n await run();\n } catch (error) {\n check(test(error), `${message}, but it threw ${String(error)}`);\n return;\n }\n check(false, `${message}, but it did not throw`);\n}\n\nconst hasCode = (code: string) => (error: unknown) => isHarnessError(error) && error.code === code;\n\ntype Skip = { readonly skipped: string };\ntype Body = (under: StoreUnderTest) => Promise<Skip | undefined | unknown>;\n\nfunction appendCases(open: (body: Body) => Promise<{ skipped: string } | undefined>): StoreCase[] {\n const cases: [string, Body][] = [\n [\n \"append assigns seq from 0 and load returns the entries in order\",\n async ({ store }) => {\n const written = await store.append(ADA, [header(), record(\"r1\", \"h1\"), record(\"r2\", \"r1\")]);\n check(written.map((entry) => entry.seq).join() === \"0,1,2\", \"append returns each entry with its seq\");\n const loaded = await collect(store.load(ADA));\n check(ids(loaded).join() === \"h1,r1,r2\", \"load returns the entries in order\");\n const more = await store.append(ADA, [record(\"r3\", \"r2\")]);\n check(more[0]?.seq === 3, \"a later append goes on from the last seq\");\n },\n ],\n [\n \"appending the same entry twice stores it once\",\n async ({ store }) => {\n await store.append(ADA, [header(), record(\"r1\", \"h1\")]);\n const again = await store.append(ADA, [record(\"r1\", \"h1\")]);\n check(again.length === 1 && again[0]?.seq === 1, \"the retry returns the stored entry\");\n check((await collect(store.load(ADA))).length === 2, \"the entry is in the log once\");\n },\n ],\n [\n \"an entry id stored with different content is a ConflictError\",\n async ({ store }) => {\n await store.append(ADA, [header(), record(\"r1\", \"h1\", { a: 1 })]);\n await rejects(\n () => store.append(ADA, [record(\"r1\", \"h1\", { a: 2 })]),\n (error) => error instanceof ConflictError && isHarnessError(error) && error.code === \"session_conflict\",\n \"reusing an id with other content must throw a ConflictError\",\n );\n const same = await store.append(ADA, [record(\"r1\", \"h1\", { a: 1 })]);\n check(same.length === 1, \"the same content under that id is still a retry\");\n },\n ],\n [\n \"a batch that is partly stored finishes on a retry, and one stored out of order conflicts\",\n async ({ store }) => {\n await store.append(ADA, [header(), record(\"r1\", \"h1\")]);\n const finished = await store.append(ADA, [record(\"r1\", \"h1\"), record(\"r2\", \"r1\")]);\n check(\n ids(finished).join() === \"r1,r2\" && finished[1]?.seq === 2,\n \"the stored prefix is kept and the rest written\",\n );\n await rejects(\n () => store.append(ADA, [record(\"r3\", \"r2\"), record(\"r1\", \"h1\")]),\n (error) => error instanceof ConflictError,\n \"a stored entry after a new one must conflict\",\n );\n check((await collect(store.load(ADA))).length === 3, \"the failed batch wrote nothing\");\n },\n ],\n ];\n return cases.map(([name, body]) => ({ name, run: () => open(body) }));\n}\n\nfunction conflictCases(open: (body: Body) => Promise<{ skipped: string } | undefined>): StoreCase[] {\n const cases: [string, Body][] = [\n [\n \"a retry of a partly stored batch conflicts once another writer has extended the log\",\n async ({ store }) => {\n await store.append(ADA, [header()]);\n await store.append(ADA, [record(\"a1\", \"h1\")], { expectedLastId: \"h1\" });\n await store.append(ADA, [record(\"b1\", \"a1\")], { expectedLastId: \"a1\" });\n await rejects(\n () => store.append(ADA, [record(\"a1\", \"h1\"), record(\"a2\", \"a1\")], { expectedLastId: \"h1\" }),\n (error) => error instanceof ConflictError,\n \"a1 is stored but is no longer the end of the log, so a2 must not be written after b1\",\n );\n check(ids(await collect(store.load(ADA))).join() === \"h1,a1,b1\", \"the retry wrote nothing\");\n },\n ],\n [\n \"a stale expectedLastId is a ConflictError and writes nothing\",\n async ({ store }) => {\n await rejects(\n () => store.append(ADA, [header()], { expectedLastId: \"x\" }),\n (error) => error instanceof ConflictError,\n \"a new session expects null, not an id\",\n );\n await store.append(ADA, [header()], { expectedLastId: null });\n await store.append(ADA, [record(\"r1\", \"h1\")], { expectedLastId: \"h1\" });\n await rejects(\n () => store.append(ADA, [record(\"r2\", \"r1\")], { expectedLastId: \"h1\" }),\n (error) => error instanceof ConflictError,\n \"an old tail must conflict\",\n );\n await rejects(\n () => store.append(ADA, [record(\"r2\", \"r1\")], { expectedLastId: null }),\n (error) => error instanceof ConflictError,\n \"null on a session that exists must conflict\",\n );\n check(ids(await collect(store.load(ADA))).join() === \"h1,r1\", \"the failed appends wrote nothing\");\n },\n ],\n [\n \"a load yields the entries present when it began, even if the caller appends while it iterates\",\n async ({ store }) => {\n await store.append(ADA, [header(), record(\"r1\", \"h1\")]);\n const seen: string[] = [];\n for await (const entry of store.load(ADA)) {\n seen.push(entry.id);\n if (seen.length < 5) await store.append(ADA, [record(`n${seen.length}`, entry.id)]);\n }\n check(seen.join() === \"h1,r1\", \"the loop saw the two entries that existed, and ended\");\n check((await collect(store.load(ADA))).length === 4, \"the two appends made during it were stored\");\n },\n ],\n [\n \"load from a sequence skips the earlier entries\",\n async ({ store }) => {\n await store.append(ADA, [header(), record(\"r1\", \"h1\"), record(\"r2\", \"r1\")]);\n check(ids(await collect(store.load(ADA, { fromSeq: 1 }))).join() === \"r1,r2\", \"fromSeq 1 starts at seq 1\");\n check((await collect(store.load(ADA, { fromSeq: 9 }))).length === 0, \"past the end yields nothing\");\n },\n ],\n ];\n return cases.map(([name, body]) => ({ name, run: () => open(body) }));\n}\n\nfunction validationCases(open: (body: Body) => Promise<{ skipped: string } | undefined>): StoreCase[] {\n const cases: [string, Body][] = [\n [\n \"a first entry that is not a header, a second header and an invalid entry are refused\",\n async ({ store }) => {\n const invalid = hasCode(\"invalid_session_entry\");\n await rejects(() => store.append(ADA, [record(\"r1\", \"h1\")]), invalid, \"a log must start with a header\");\n await store.append(ADA, [header()]);\n await rejects(() => store.append(ADA, [header(\"h2\")]), invalid, \"only the first entry may be a header\");\n await rejects(\n () => store.append(ADA, [{ ...record(\"r1\", \"h1\"), timestamp: \"yesterday\" }]),\n invalid,\n \"an entry the protocol rejects must be refused\",\n );\n await rejects(\n () => store.append(ADA, [record(\"r1\", \"h1\"), record(\"r1\", \"h1\")]),\n invalid,\n \"a batch repeating an id must be refused\",\n );\n check((await collect(store.load(ADA))).length === 1, \"refused appends wrote nothing\");\n },\n ],\n [\n \"an entry over 64 KiB is an EntryTooLargeError, and a batch with one writes none of it\",\n async ({ store }) => {\n const big = record(\"big\", \"h1\", { text: \"x\".repeat(64 * 1024) });\n await store.append(ADA, [header()]);\n await rejects(\n () => store.append(ADA, [record(\"ok\", \"h1\"), big]),\n (error) => error instanceof EntryTooLargeError && error.entryId === \"big\" && error.maxBytes === 64 * 1024,\n \"an oversize entry must throw an EntryTooLargeError\",\n );\n check((await collect(store.load(ADA))).length === 1, \"the small entry before it was not written either\");\n await store.append(ADA, [record(\"small\", \"h1\", { text: \"x\".repeat(60 * 1024) })]);\n },\n ],\n ];\n return cases.map(([name, body]) => ({ name, run: () => open(body) }));\n}\n\nfunction identityCases(open: (body: Body) => Promise<{ skipped: string } | undefined>): StoreCase[] {\n const cases: [string, Body][] = [\n [\n \"a caller that changes an entry after appending it does not change the stored one\",\n async ({ store }) => {\n const data = { a: 1 };\n await store.append(ADA, [header(), record(\"r1\", \"h1\", data)]);\n data.a = 2;\n const again = await store.append(ADA, [record(\"r1\", \"h1\", { a: 1 })]);\n check(again.length === 1, \"a retry with the original content is still a retry\");\n await rejects(\n () => store.append(ADA, [record(\"r1\", \"h1\", { a: 2 })]),\n (error) => error instanceof ConflictError,\n \"the changed content must conflict, because the stored entry did not change\",\n );\n const [, stored] = await collect(store.load(ADA));\n (stored as { data: { a: number } }).data.a = 9;\n check(\n ((await collect(store.load(ADA)))[1] as unknown as { data: { a: number } }).data.a === 1,\n \"a loaded entry is a copy\",\n );\n },\n ],\n [\n \"ids that differ only in letter case are different users and sessions\",\n async ({ store }) => {\n await store.append({ userId: \"Ada\", sessionId: \"S1\" }, [header(\"upper\")]);\n await store.append({ userId: \"ada\", sessionId: \"s1\" }, [header(\"lower\")]);\n check(\n ids(await collect(store.load({ userId: \"Ada\", sessionId: \"S1\" }))).join() === \"upper\",\n \"Ada's S1 holds its own entries\",\n );\n check(\n ids(await collect(store.load({ userId: \"ada\", sessionId: \"s1\" }))).join() === \"lower\",\n \"and ada's s1 holds its own\",\n );\n check((await collect(store.list(\"Ada\"))).length === 1, \"each user lists one session\");\n },\n ],\n ];\n return cases.map(([name, body]) => ({ name, run: () => open(body) }));\n}\n\nfunction keyCases(open: (body: Body) => Promise<{ skipped: string } | undefined>): StoreCase[] {\n const cases: [string, Body][] = [\n [\n \"append rejects, and does not throw, for a key it can't use, and every store agrees on which keys those are\",\n async ({ store }) => {\n const invalid = hasCode(\"invalid_session_key\");\n await rejects(\n () => store.append({ userId: \"\", sessionId: \"s\" }, [header()]),\n invalid,\n \"an empty user is refused\",\n );\n await rejects(\n () => store.append({ userId: \"u\", sessionId: \"é\".repeat(64) }, [header()]),\n invalid,\n \"a name that encodes to over 200 bytes is refused by every store\",\n );\n await rejects(\n () => store.append({ userId: \"\\ud800\", sessionId: \"s\" }, [header()]),\n invalid,\n \"a lone surrogate would encode like another id, so it is refused\",\n );\n await store.append({ userId: \"u\", sessionId: \"e\".repeat(64) }, [header()]);\n },\n ],\n [\n \"a user id or session id that is empty or has a control character is refused\",\n async ({ store }) => {\n const invalid = hasCode(\"invalid_session_key\");\n for (const key of [\n { userId: \"\", sessionId: \"s\" },\n { userId: \"u\", sessionId: \"\" },\n { userId: \"u\", sessionId: \"a\\nb\" },\n ]) {\n await rejects(() => store.append(key, [header()]), invalid, `${JSON.stringify(key)} must be refused`);\n }\n await store.append({ userId: \"u/../x\", sessionId: \"../../y\" }, [header()]);\n check(\n (await collect(store.load({ userId: \"u/../x\", sessionId: \"../../y\" }))).length === 1,\n \"an id that looks like a path is a name, and works\",\n );\n },\n ],\n ];\n return cases.map(([name, body]) => ({ name, run: () => open(body) }));\n}\n\nfunction listAndOwnerCases(open: (body: Body) => Promise<{ skipped: string } | undefined>): StoreCase[] {\n const cases: [string, Body][] = [\n [\n \"list returns the user's sessions from their headers, oldest first, and delete removes one\",\n async ({ store }) => {\n await store.append({ userId: \"ada\", sessionId: \"late\" }, [\n header(\"h\", \"2026-01-02T00:00:00.000Z\"),\n record(\"r\", \"h\"),\n ]);\n await store.append({ userId: \"ada\", sessionId: \"early\" }, [header(\"h\", \"2026-01-01T00:00:00.000Z\")]);\n const listed = await collect(store.list(\"ada\"));\n check(listed.map((summary) => summary.sessionId).join() === \"early,late\", \"list is oldest first\");\n const late = listed[1];\n check(\n late?.entryCount === 2 && late.startedAt === \"2026-01-02T00:00:00.000Z\",\n \"the summary comes from the entries\",\n );\n await store.delete({ userId: \"ada\", sessionId: \"early\" });\n check((await collect(store.list(\"ada\"))).length === 1, \"delete removes the session\");\n await store.delete({ userId: \"ada\", sessionId: \"early\" });\n },\n ],\n [\n \"another user's session looks the same as one that was never created\",\n async ({ store }) => {\n await store.append(ADA, [header(), record(\"r1\", \"h1\")]);\n const neverMade = await collect(store.load({ userId: \"bob\", sessionId: \"never\" }));\n const adasUnderBob = await collect(store.load(BOB));\n check(\n neverMade.length === 0 && adasUnderBob.length === 0,\n \"loading under another user yields nothing, as for a missing id\",\n );\n check((await collect(store.list(\"bob\"))).length === 0, \"list under another user leaves it out\");\n await store.delete(BOB);\n check((await collect(store.load(ADA))).length === 2, \"delete under another user changed nothing\");\n await store.append(BOB, [header(\"hb\")]);\n check(\n ids(await collect(store.load(ADA))).join() === \"h1,r1\",\n \"bob's session with the same id is a separate session\",\n );\n check(ids(await collect(store.load(BOB))).join() === \"hb\", \"and it holds only bob's entries\");\n },\n ],\n ];\n return cases.map(([name, body]) => ({ name, run: () => open(body) }));\n}\n\nfunction tornCases(open: (body: Body) => Promise<{ skipped: string } | undefined>): StoreCase[] {\n const needsTear = \"the store gave no way to tear a log's last line\";\n const cases: [string, Body][] = [\n [\n \"a torn last line is skipped by load and reported once, with every complete entry kept\",\n async ({ store, tearLastLine }) => {\n if (tearLastLine === undefined) return { skipped: needsTear };\n await store.append(ADA, [header(), record(\"r1\", \"h1\")]);\n await tearLastLine(ADA);\n const reports: number[] = [];\n const loaded = await collect(store.load(ADA, { onTornLine: (line) => reports.push(line.bytes) }));\n check(ids(loaded).join() === \"h1,r1\", \"the complete entries load\");\n check(reports.length === 1 && (reports[0] ?? 0) > 0, \"the torn line is reported once\");\n const clean = await collect(\n store.load(\n { userId: \"ada\", sessionId: \"other\" },\n { onTornLine: () => check(false, \"a clean log reports nothing\") },\n ),\n );\n check(clean.length === 0, \"a missing session yields nothing\");\n },\n ],\n [\n \"an append after a torn line cuts it off, so the next entry is not glued to it\",\n async ({ store, tearLastLine }) => {\n if (tearLastLine === undefined) return { skipped: needsTear };\n await store.append(ADA, [header(), record(\"r1\", \"h1\")]);\n await tearLastLine(ADA);\n const written = await store.append(ADA, [record(\"r2\", \"r1\")], { expectedLastId: \"r1\" });\n check(written[0]?.seq === 2, \"the new entry follows the last complete one\");\n const reports: number[] = [];\n const loaded = await collect(store.load(ADA, { onTornLine: (line) => reports.push(line.bytes) }));\n check(ids(loaded).join() === \"h1,r1,r2\" && reports.length === 0, \"the log is whole again\");\n },\n ],\n ];\n return cases.map(([name, body]) => ({ name, run: () => open(body) }));\n}\n\n/** Every conformance case, each against a store from `factory`. */\nexport function storeConformanceCases(factory: StoreFactory): readonly StoreCase[] {\n const open = async (body: Body) => {\n const outcome = await body(await factory());\n return typeof outcome === \"object\" && outcome !== null && \"skipped\" in outcome ? (outcome as Skip) : undefined;\n };\n return [\n ...appendCases(open),\n ...conflictCases(open),\n ...validationCases(open),\n ...identityCases(open),\n ...keyCases(open),\n ...listAndOwnerCases(open),\n ...tornCases(open),\n ];\n}\n\n/** Runs every case and reports which passed, which skipped with a reason and which failed. */\nexport async function runStoreConformance(factory: StoreFactory): Promise<StoreConformanceReport> {\n return runCases(storeConformanceCases(factory));\n}\n"]}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/** The tool registry's named error: a `HarnessError` with the code `duplicate_tool` and the name that collided. */
|
|
2
|
+
import { HarnessError } from "../errors.js";
|
|
3
|
+
/**
|
|
4
|
+
* Thrown by `register()` when a registry already holds a tool, or an alias, by that name. An extension that means to
|
|
5
|
+
* replace a built-in passes `override: true`. An MCP tool whose name needs cleaning gets a hash in its name, and this
|
|
6
|
+
* error is for a final name that is still taken.
|
|
7
|
+
*/
|
|
8
|
+
export declare class DuplicateToolError extends HarnessError {
|
|
9
|
+
readonly name = "DuplicateToolError";
|
|
10
|
+
/** The canonical name or alias that is already taken. */
|
|
11
|
+
readonly toolName: string;
|
|
12
|
+
constructor(toolName: string, why: string);
|
|
13
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/** The tool registry's named error: a `HarnessError` with the code `duplicate_tool` and the name that collided. */
|
|
2
|
+
import { HarnessError } from "../errors.js";
|
|
3
|
+
/**
|
|
4
|
+
* Thrown by `register()` when a registry already holds a tool, or an alias, by that name. An extension that means to
|
|
5
|
+
* replace a built-in passes `override: true`. An MCP tool whose name needs cleaning gets a hash in its name, and this
|
|
6
|
+
* error is for a final name that is still taken.
|
|
7
|
+
*/
|
|
8
|
+
export class DuplicateToolError extends HarnessError {
|
|
9
|
+
name = "DuplicateToolError";
|
|
10
|
+
/** The canonical name or alias that is already taken. */
|
|
11
|
+
toolName;
|
|
12
|
+
constructor(toolName, why) {
|
|
13
|
+
super("duplicate_tool", `the tool name "${toolName}" is already registered: ${why}`);
|
|
14
|
+
this.toolName = toolName;
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=errors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/tools/errors.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAChC,IAAI,GAAG,oBAAoB,CAAC;IAC9C,yDAAyD;IAChD,QAAQ,CAAS;IAE1B,YAAY,QAAgB,EAAE,GAAW;QACvC,KAAK,CAAC,gBAAgB,EAAE,kBAAkB,QAAQ,4BAA4B,GAAG,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF","sourcesContent":["/** The tool registry's named error: a `HarnessError` with the code `duplicate_tool` and the name that collided. */\nimport { HarnessError } from \"../errors.js\";\n\n/**\n * Thrown by `register()` when a registry already holds a tool, or an alias, by that name. An extension that means to\n * replace a built-in passes `override: true`. An MCP tool whose name needs cleaning gets a hash in its name, and this\n * error is for a final name that is still taken.\n */\nexport class DuplicateToolError extends HarnessError {\n override readonly name = \"DuplicateToolError\";\n /** The canonical name or alias that is already taken. */\n readonly toolName: string;\n\n constructor(toolName: string, why: string) {\n super(\"duplicate_tool\", `the tool name \"${toolName}\" is already registered: ${why}`);\n this.toolName = toolName;\n }\n}\n"]}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `@buildanagent/harness/tools`: the tool registry, which names, defers and wraps the tools of every source, and the
|
|
3
|
+
* tool search that activates deferred ones.
|
|
4
|
+
*/
|
|
5
|
+
export { DuplicateToolError } from "./errors.js";
|
|
6
|
+
export { createToolRegistry } from "./registry.js";
|
|
7
|
+
export { type ToolSearchOptions, toolSearchInterceptors, toolSearchTool } from "./tool-search.js";
|
|
8
|
+
export type { ApprovalReuse, HostPattern, OutputTrust, PreambleOptions, RegisteredTool, ToolExposure, ToolRegistration, ToolRegistry, ToolSource, ToolWrapper, } from "./types.js";
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `@buildanagent/harness/tools`: the tool registry, which names, defers and wraps the tools of every source, and the
|
|
3
|
+
* tool search that activates deferred ones.
|
|
4
|
+
*/
|
|
5
|
+
export { DuplicateToolError } from "./errors.js";
|
|
6
|
+
export { createToolRegistry } from "./registry.js";
|
|
7
|
+
export { toolSearchInterceptors, toolSearchTool } from "./tool-search.js";
|
|
8
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAA0B,sBAAsB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["/**\n * `@buildanagent/harness/tools`: the tool registry, which names, defers and wraps the tools of every source, and the\n * tool search that activates deferred ones.\n */\nexport { DuplicateToolError } from \"./errors.js\";\nexport { createToolRegistry } from \"./registry.js\";\nexport { type ToolSearchOptions, toolSearchInterceptors, toolSearchTool } from \"./tool-search.js\";\nexport type {\n ApprovalReuse,\n HostPattern,\n OutputTrust,\n PreambleOptions,\n RegisteredTool,\n ToolExposure,\n ToolRegistration,\n ToolRegistry,\n ToolSource,\n ToolWrapper,\n} from \"./types.js\";\n"]}
|