@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 @@
|
|
|
1
|
+
{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/server/dispatcher.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The dispatcher: the one place every interface talks to. It takes the protocol's commands, runs turns through\n * `runTurn()`, and sends the replies, the events and one `turn/settled` per turn back through each connection. The\n * dispatcher holds no session state of its own beyond which turn runs where and which questions it has asked: the log\n * is the state, so a client that joins late reads the log and a restart loses nothing. A turn holds the session's\n * writer lock only while it runs, so another process that wants the session gets `locked` from its own `turn/start`.\n *\n * A call that needs a person ends its turn `awaiting_approval`. Once its `approval_requested` entry is durable, every\n * connection that watches the session is asked with `approval/request` or `clarification/request`. The first answer\n * wins: the others are withdrawn with `$/cancelRequest`, and the answer goes through `Approvals.resolve()`, which runs\n * as a turn of its own once the session is free. A client that reconnects finds the request in `initialize` and is\n * asked again when it opens the session.\n */\nimport {\n type ClientCommand,\n type ClientMessage,\n type ClientResultMap,\n type Disposition,\n ErrorCodes,\n type HarnessEvent,\n type Id,\n type InitializeResult,\n type ServerNotification,\n type SessionEntry,\n type TurnResultSummary,\n} from \"@buildanagent/protocol\";\nimport {\n type AgentEvent,\n CAPABILITIES,\n type Observer,\n type Resolution,\n type Run,\n SDK_VERSION,\n type SignedPendingRequest,\n} from \"@buildanagent/sdk\";\nimport type { CompletionSettings } from \"../completion/check.js\";\nimport { HarnessError, isHarnessError } from \"../errors.js\";\nimport type { CodeCallResult, Harness } from \"../harness.js\";\nimport { type Approvals, createApprovals } from \"../session/approvals.js\";\nimport { codeCallRequestIds } from \"../session/code-call-log.js\";\nimport type { SessionLock } from \"../session/lock.js\";\nimport type { SessionIndex } from \"../session/pointer.js\";\nimport { pendingApprovals } from \"../session/rebuild.js\";\nimport { type ClientToolRunner, runTurn, type TurnOptions, type TurnResult } from \"../session/runner.js\";\nimport { listSessions, openSession, type Session } from \"../session/session.js\";\nimport type { SessionKey, SessionStore } from \"../session/store.js\";\nimport { resolutionOf, toolError, toolResultOf } from \"./answers.js\";\nimport { type ConnectionHost, type Dispatched, Failure, type ServerAnswer, ServerConnection } from \"./connection.js\";\nimport type { Deliver } from \"./outbox.js\";\nimport { paramsProblem } from \"./params.js\";\n\n/** The methods a client must opt into, by listing each in the `capabilities` of its `initialize`. */\nexport const EXPERIMENTAL_METHODS = [\"session/checkout\", \"session/fork\"] as const;\n\nconst PAGE_SIZE = 50;\nconst DEFAULT_QUEUE_SIZE = 128;\n\n/** The settings of `createDispatcher()`. */\nexport interface DispatcherOptions<H = unknown> {\n readonly harness: Harness<H>;\n readonly store: SessionStore;\n readonly index: SessionIndex;\n /** The writer lock a turn takes while it runs. Two dispatchers over one lock serve one session at a time. */\n readonly lock: SessionLock;\n /** Whose sessions this dispatcher serves. Every store call names this user. */\n readonly userId: string;\n /** What the harness adds to the SDK's capabilities in `initialize`. Default none. */\n readonly capabilities?: readonly string[];\n /** The name `initialize` reports. Default `buildanagent-harness`. */\n readonly serverName?: string;\n /** Settings every turn takes besides its input, resumes included. */\n readonly turn?: Pick<TurnOptions<H>, \"maxSteps\" | \"turnRetries\" | \"budgetUsd\" | \"modelOptions\">;\n /**\n * The completion check for a session's turns, given the session's id. It returns the session's sandbox and\n * environment, because one sandbox never serves every session, or `undefined` for a session with no check. Each\n * `turn/start` calls it once. Default: no turn checks its completion.\n */\n readonly completion?: (session: string) => CompletionSettings | undefined;\n /** Makes session and turn ids. Default `crypto.randomUUID()`. */\n readonly newId?: () => string;\n /**\n * How many commands each connection may have unanswered, and how many events may wait for a slow client before\n * the server drops them. A whole number of at least 1. Default 128.\n */\n readonly queueSize?: number;\n /** The approvals a client's answers go through. Default `createApprovals(harness)`. */\n readonly approvals?: Approvals<H>;\n}\n\n/** One client's end of the dispatcher: send it messages, and it calls back with what the server sends. */\nexport interface Connection {\n /** Handles one message and resolves once its response, if it has one, is queued to go out. */\n receive(message: ClientMessage): Promise<void>;\n /**\n * Stops delivering to this client. A turn it started goes on, and a tool call that waits on this client gets an\n * error result. A request for a person stays in the log for the next client.\n */\n close(): void;\n}\n\n/** What `Dispatcher.connect()` takes besides `send`. */\nexport interface ConnectOptions {\n /**\n * Called once when the connection closes, whether the caller closed it with `close()` or the server did. The server\n * closes a connection for a client that leaves 128 refusals unread. A transport uses it to stop serving a connection that is gone.\n */\n readonly onClose?: () => void;\n}\n\n/** The dispatcher `createDispatcher()` returns. */\nexport interface Dispatcher {\n /**\n * Adds a client. `send` gets every message the server sends it, one at a time and in order. A `send` that returns a\n * promise holds the next message until it settles; while it waits, events past the queue size are dropped and an\n * `events_dropped` event stands in for them.\n */\n connect(send: Deliver, options?: ConnectOptions): Connection;\n /** Interrupts every running turn and waits for each to settle. */\n close(): Promise<void>;\n}\n\ninterface Running {\n readonly turn: string;\n run: Run<unknown> | undefined;\n readonly done: Promise<void>;\n /** Resolves `done`. */\n readonly finish: () => void;\n /** Aborts the turn even before its run exists. */\n readonly controller: AbortController;\n /** Steers and follow-ups that arrived before the run existed; they go in as soon as it does. */\n readonly queued: ((run: Run<unknown>) => void)[];\n /** The client a `client_request` tool's call goes to: the one that started the turn or gave the answer it resumes. */\n readonly owner: ServerConnection | undefined;\n}\n\n/** An answer a client gave, held until the session is free to resume. */\ninterface Answer {\n readonly resolution: Resolution;\n readonly by: ServerConnection;\n applying: boolean;\n}\n\ninterface Opened {\n readonly cwd: string;\n running?: Running | undefined;\n /** True while a checkout or fork holds the session's lock. */\n branching?: boolean;\n /** The first answer to each signed request, by its id, until a resume has applied it. */\n readonly answers: Map<string, Answer>;\n /** Counts each answer taken and each resume ended, so a read of the waiting requests can tell it went stale. */\n generation: number;\n /** How many times each request was asked again after a resume that could not apply its answer. */\n readonly reasks: Map<string, number>;\n}\n\n/** The command whose method union holds `M`, for the methods that share one command shape. */\ntype Command<M extends string> = ClientCommand extends infer C\n ? C extends { method: infer X }\n ? M extends X\n ? C\n : never\n : never\n : never;\n\ntype EventMessage = Extract<ServerNotification, { method: \"event\" }>;\n\nconst failure = (code: number, message: string): Failure => new Failure(code, message);\n\nconst newOpened = (cwd: string): Opened => ({ cwd, answers: new Map(), generation: 0, reasks: new Map() });\n\n/** How many times `#armFor` reads the log before it gives up on a read that answers keep making stale. */\nconst ARM_READS = 3;\n\n/**\n * The `error.kind` of a resume's `turn/settled` when its answers were never written, because the lock could not be\n * taken or the resume was stopped first. The requests still wait in the log.\n */\nconst NOT_APPLIED = \"answer_not_applied\";\n\n/** How many times one request is asked again after resumes that could not apply its answer. */\nconst MAX_REASKS = 3;\n\n/** What `turn/settled` says about a resume that wrote none of its answers. */\nfunction notApplied(stopReason: \"aborted\" | \"error\", why: string): TurnResultSummary {\n return {\n stopReason,\n steps: 0,\n costUsd: null,\n error: { kind: NOT_APPLIED, message: `${why}, so no answer was applied and each request still waits` },\n };\n}\n\nconst completionOf = (completion: CompletionSettings | undefined): { completion?: CompletionSettings } =>\n completion === undefined ? {} : { completion };\n\n/** What `turn/settled` says about a finished turn, or about a turn that failed before it could finish. */\nfunction summaryOf(result: TurnResult | undefined, error?: unknown): TurnResultSummary {\n if (result === undefined) {\n return {\n stopReason: \"error\",\n steps: 0,\n costUsd: null,\n error: { kind: \"harness\", message: error instanceof Error ? error.message : String(error) },\n };\n }\n const failed = \"error\" in result ? (result.error as { kind: string; message: string } | undefined) : undefined;\n return {\n stopReason: result.stopReason,\n steps: result.steps,\n costUsd: result.cost.total,\n ...(failed === undefined ? {} : { error: { kind: failed.kind, message: failed.message } }),\n };\n}\n\n/** The summary of a resume. Only a turn's requests reach a resume, so a code call's result, which settles no turn, is an error. */\nfunction resumedSummary(result: TurnResult | CodeCallResult): TurnResultSummary {\n return \"status\" in result\n ? summaryOf(undefined, new Error(\"an answer resolved a code call, which settles no turn\"))\n : summaryOf(result);\n}\n\n/**\n * A store that tells `onAppend` about each batch it stores, with the file it went to, so the dispatcher can announce\n * entries as they land. Delivery never fails a write that has landed.\n */\nfunction watched(\n store: SessionStore,\n onAppend: (key: SessionKey, entries: readonly SessionEntry[]) => void,\n): SessionStore {\n return {\n async append(key, entries, options) {\n const stored = await store.append(key, entries, options);\n onAppend(key, stored);\n return stored;\n },\n load: (key, options) => store.load(key, options),\n list: (userId) => store.list(userId),\n delete: (key) => store.delete(key),\n ...(store.loadRaw === undefined\n ? {}\n : { loadRaw: (key: SessionKey) => (store.loadRaw as NonNullable<SessionStore[\"loadRaw\"]>)(key) }),\n };\n}\n\nconst replayEvent = (session: string, entry: SessionEntry): EventMessage => ({\n jsonrpc: \"2.0\",\n method: \"event\",\n params: { session, seq: entry.seq, event: { type: \"entry_appended\", entry } },\n});\n\nasync function collect(entries: AsyncIterable<SessionEntry>): Promise<SessionEntry[]> {\n const out: SessionEntry[] = [];\n for await (const entry of entries) out.push(entry);\n return out;\n}\n\nfunction checkQueueSize(size: number | undefined): number {\n if (size === undefined) return DEFAULT_QUEUE_SIZE;\n if (!Number.isInteger(size) || size < 1) {\n throw new HarnessError(\"invalid_dispatcher_options\", `queueSize must be a whole number of at least 1, got ${size}`);\n }\n return size;\n}\n\nclass HarnessDispatcher<H> implements Dispatcher, ConnectionHost {\n readonly #options: DispatcherOptions<H>;\n #closed = false;\n readonly #connections = new Set<ServerConnection>();\n readonly #opened = new Map<string, Opened>();\n readonly #lastSeq = new Map<string, number>();\n readonly #newId: () => string;\n readonly #queueSize: number;\n readonly #approvals: Approvals<H>;\n #requests = 0;\n\n constructor(options: DispatcherOptions<H>) {\n this.#options = options;\n this.#newId = options.newId ?? (() => globalThis.crypto.randomUUID());\n this.#queueSize = checkQueueSize(options.queueSize);\n this.#approvals = options.approvals ?? createApprovals(options.harness);\n }\n\n /**\n * The store a turn on `session` writes through. Each batch written to the session's current file is announced under\n * the session's own id; a batch that goes to another file, such as a child's, belongs to that file's session.\n */\n #storeFor(session: string, handle: () => Session | undefined): SessionStore {\n return watched(this.#options.store, (key, entries) => {\n const current = handle();\n if (current === undefined || key.sessionId === current.file()) this.#appended(session, entries);\n });\n }\n\n connect(send: Deliver, options: ConnectOptions = {}): Connection {\n if (this.#closed) throw new Error(\"the dispatcher is closed\");\n const connection = new ServerConnection(this, send, this.#queueSize, options.onClose);\n this.#connections.add(connection);\n return connection;\n }\n\n async close(): Promise<void> {\n this.#closed = true;\n const running = [...this.#opened.values()].flatMap((opened) =>\n opened.running === undefined ? [] : [opened.running],\n );\n for (const turn of running) turn.controller.abort(\"the dispatcher closed\");\n await Promise.all(running.map((turn) => turn.done));\n this.#connections.clear();\n }\n\n detach(connection: ServerConnection): void {\n this.#connections.delete(connection);\n }\n\n key(session: string): SessionKey {\n return { userId: this.#options.userId, sessionId: session };\n }\n\n #watchers(session: string): ServerConnection[] {\n return [...this.#connections].filter((connection) => connection.watching(session));\n }\n\n /** Sends to every connection that has opened the session. `seq` is the log's sequence number at that moment. */\n emit(session: string, event: AgentEvent | HarnessEvent, seq?: number): void {\n const at = seq ?? this.#lastSeq.get(session) ?? -1;\n const message: EventMessage = { jsonrpc: \"2.0\", method: \"event\", params: { session, seq: at, event } };\n for (const connection of this.#connections) connection.event(message);\n }\n\n #appended(session: string, entries: readonly SessionEntry[]): void {\n for (const entry of entries) {\n this.#lastSeq.set(session, entry.seq);\n this.emit(session, { type: \"entry_appended\", entry }, entry.seq);\n // The entry is durable now, so a client that hears of the request can always find it in the log.\n if (entry.type === \"approval_requested\") {\n for (const connection of this.#watchers(session)) this.#ask(connection, session, entry.request);\n }\n }\n }\n\n settled(session: string, turn: string, result: TurnResultSummary): void {\n for (const connection of this.#connections) {\n connection.settled({ jsonrpc: \"2.0\", method: \"turn/settled\", params: { session, turn, result } });\n }\n }\n\n async dispatch(connection: ServerConnection, sent: ClientCommand & { id: Id }): Promise<Dispatched> {\n // JSON-RPC lets a command leave out its params, so the handlers below, which read them as the protocol types them,\n // get an empty object instead.\n const command = (\n (sent as { params?: unknown }).params === undefined ? { ...sent, params: {} } : sent\n ) as ClientCommand & { id: Id };\n // An experimental method answers NotOptedIn before its params are read, as it would for any params.\n const experimental: readonly string[] = EXPERIMENTAL_METHODS;\n if (experimental.includes(command.method) && !connection.optedIn(command.method)) {\n throw failure(\n ErrorCodes.NotOptedIn,\n `${command.method} is experimental: list it in the capabilities of initialize`,\n );\n }\n // Every handler below reads its params as the protocol types them, so a command that breaks its schema is refused\n // here, before any of them runs.\n const problem = paramsProblem(command);\n if (problem !== undefined) throw failure(ErrorCodes.InvalidParams, problem);\n switch (command.method) {\n case \"initialize\":\n return { result: await this.#initialize(connection, command.params.capabilities) };\n case \"session/create\":\n return { result: await this.#create(connection, command.params) };\n case \"session/open\":\n return this.#open(connection, command.params);\n case \"session/list\":\n return { result: await this.#list(command.params.cursor) };\n case \"turn/start\":\n return this.#start(connection, command.id, command.params.session, command.params.input);\n case \"turn/steer\":\n case \"turn/followUp\":\n return { result: this.#redirect(connection, command.method, command.params.session, command.params.input) };\n case \"turn/interrupt\":\n return { result: this.#interrupt(connection, command.params.session, command.params.reason) };\n case \"approval/list\":\n return { result: await this.#approvalList(connection, command.params.session) };\n case \"session/checkout\":\n case \"session/fork\":\n return { result: await this.#branch(connection, command) };\n default:\n throw failure(ErrorCodes.MethodNotFound, `unknown method ${String((command as { method: string }).method)}`);\n }\n }\n\n async #initialize(connection: ServerConnection, requested: readonly string[]): Promise<InitializeResult> {\n connection.optIn(requested);\n const pending: InitializeResult[\"pending\"] = [];\n for await (const summary of listSessions(this.#options.store, this.#options.userId)) {\n // One unreadable session must not stop every client from connecting.\n try {\n const session = await openSession({\n store: this.#options.store,\n index: this.#options.index,\n key: this.key(summary.sessionId),\n });\n for (const entry of pendingApprovals(await session.path()))\n pending.push({ session: summary.sessionId, request: entry.request });\n } catch {\n // skipped\n }\n }\n return {\n serverInfo: {\n name: this.#options.serverName ?? \"buildanagent-harness\",\n version: this.#options.harness.harnessVersion,\n sdkVersion: SDK_VERSION,\n specVersion: \"v1\",\n },\n capabilities: [...CAPABILITIES, ...(this.#options.capabilities ?? [])],\n experimental: [...EXPERIMENTAL_METHODS],\n pending,\n };\n }\n\n async #exists(session: string): Promise<boolean> {\n for await (const _ of this.#options.store.load(this.key(session), { fromSeq: 0 })) return true;\n return false;\n }\n\n async #create(\n connection: ServerConnection,\n params: Command<\"session/create\">[\"params\"],\n ): Promise<ClientResultMap[\"session/create\"]> {\n const id = params.session ?? this.#newId();\n if (this.#opened.has(id)) throw failure(ErrorCodes.InvalidParams, `session ${id} already exists`);\n // Reserve the id before the first await, so two creates of one id cannot both pass.\n const reserved = newOpened(params.cwd);\n this.#opened.set(id, reserved);\n try {\n if (await this.#exists(id)) throw failure(ErrorCodes.InvalidParams, `session ${id} already exists`);\n } catch (error) {\n if (this.#opened.get(id) === reserved) this.#opened.delete(id);\n throw error;\n }\n connection.watch(id);\n return { session: id, head: null };\n }\n\n /**\n * Opens a session for the connection. Its live events are held from the start, so that none is sent before the\n * response, lost, or sent twice: after the response, the connection gets the replay from `fromSeq`, then what was\n * held, then the live stream, and is asked again about every request that still waits.\n */\n async #open(connection: ServerConnection, params: Command<\"session/open\">[\"params\"]): Promise<Dispatched> {\n const id = params.session ?? \"\";\n // The schema check has already refused a fromSeq that is not a whole number of at least 0.\n const { fromSeq } = params;\n if (!connection.hold(id)) throw failure(ErrorCodes.InvalidParams, `session ${JSON.stringify(id)} is being opened`);\n try {\n return await this.#openHeld(connection, id, params.cwd, fromSeq);\n } catch (error) {\n // A failed open leaves the client with no access and nothing of what was held.\n connection.unhold(id);\n throw error;\n }\n }\n\n async #openHeld(\n connection: ServerConnection,\n id: string,\n cwd: string,\n fromSeq: number | undefined,\n ): Promise<Dispatched> {\n // A session this dispatcher created has no file until its first turn, but a second client may still open it.\n const exists = id !== \"\" && (await this.#exists(id));\n if (id === \"\" || !(exists || this.#opened.has(id)))\n throw failure(ErrorCodes.InvalidParams, `no session ${JSON.stringify(id)}`);\n const reader = exists\n ? await openSession({ store: this.#options.store, index: this.#options.index, key: this.key(id) })\n : undefined;\n const replay = fromSeq === undefined ? [] : await this.#replay(reader?.file(), fromSeq);\n if (!this.#opened.has(id)) this.#opened.set(id, newOpened(cwd));\n const replayedTo = fromSeq === undefined ? -1 : (replay.at(-1)?.seq ?? fromSeq - 1);\n return {\n result: { session: id, head: reader?.head() ?? null } satisfies ClientResultMap[\"session/open\"],\n after: () => {\n connection.release(\n id,\n replay.map((entry) => replayEvent(id, entry)),\n replayedTo,\n );\n void this.#armFor(connection, id);\n },\n };\n }\n\n /**\n * The entries of the session's current file from `fromSeq` on, read from the log, which holds every entry: the log is\n * the replay window, so no `fromSeq` is too old. A `fromSeq` past the entry after the last refuses the open.\n */\n async #replay(file: string | undefined, fromSeq: number): Promise<SessionEntry[]> {\n if (file === undefined) {\n if (fromSeq === 0) return [];\n throw failure(ErrorCodes.InvalidParams, `fromSeq ${fromSeq} is past the end of the session's log`);\n }\n // One entry before fromSeq is read too, to tell a client that has everything from one whose fromSeq is too far.\n const entries = await collect(this.#options.store.load(this.key(file), { fromSeq: Math.max(0, fromSeq - 1) }));\n if (fromSeq === 0) return entries;\n if (entries[0]?.seq !== fromSeq - 1)\n throw failure(ErrorCodes.InvalidParams, `fromSeq ${fromSeq} is past the end of the session's log`);\n return entries.slice(1);\n }\n\n async #list(cursor: string | undefined): Promise<ClientResultMap[\"session/list\"]> {\n const from = cursor === undefined ? 0 : /^\\d+$/.test(cursor) ? Number(cursor) : -1;\n if (from < 0) throw failure(ErrorCodes.InvalidParams, \"the cursor is not one this server gave\");\n const all: ClientResultMap[\"session/list\"][\"sessions\"] = [];\n for await (const item of listSessions(this.#options.store, this.#options.userId)) {\n all.push({\n session: item.sessionId,\n startedAt: item.startedAt,\n lastEntryAt: item.lastEntryAt,\n entryCount: item.entryCount,\n });\n }\n const page = all.slice(from, from + PAGE_SIZE);\n return from + PAGE_SIZE < all.length\n ? { sessions: page, nextCursor: String(from + PAGE_SIZE) }\n : { sessions: page };\n }\n\n /** Marks the session busy with a new turn, before any await, so a second command in the same tick sees it busy. */\n #claim(opened: Opened, owner: ServerConnection | undefined): Running {\n let finish!: () => void;\n const done = new Promise<void>((resolve) => {\n finish = resolve;\n });\n const running: Running = {\n turn: this.#newId(),\n run: undefined,\n done,\n finish,\n controller: new AbortController(),\n queued: [],\n owner,\n };\n opened.running = running;\n return running;\n }\n\n /** Opens the session with its lock, writing through a store that announces what lands in its current file. */\n async #lockedHandle(session: string): Promise<Session> {\n let handle: Session | undefined;\n handle = await openSession({\n store: this.#storeFor(session, () => handle),\n index: this.#options.index,\n lock: this.#options.lock,\n key: this.key(session),\n });\n return handle;\n }\n\n async #start(\n connection: ServerConnection,\n requestId: Id,\n session: string,\n input: Command<\"turn/start\">[\"params\"][\"input\"],\n ): Promise<Dispatched> {\n const opened = connection.watching(session) ? this.#opened.get(session) : undefined;\n if (opened === undefined) return { result: { accepted: false, reason: \"invalid\" } satisfies Disposition };\n if (this.#closed) throw failure(ErrorCodes.InternalError, \"the dispatcher is closed\");\n if (opened.running !== undefined || opened.branching === true) {\n return { result: { accepted: false, reason: \"busy\" } satisfies Disposition };\n }\n const running = this.#claim(opened, connection);\n // The client may cancel the turn by the id of its turn/start until the turn settles.\n const cancel = () => running.controller.abort(\"the client cancelled the turn\");\n connection.trackTurn(requestId, cancel);\n const refuse = () => {\n connection.untrackTurn(requestId, cancel);\n opened.running = undefined;\n running.finish();\n // An answer that came while this turn was taking the lock waited for the session; it is free again.\n this.#pump(session);\n };\n let handle: Session;\n try {\n handle = await this.#lockedHandle(session);\n } catch (error) {\n refuse();\n if (isHarnessError(error) && error.code === \"session_locked\")\n return { result: { accepted: false, reason: \"locked\" } satisfies Disposition };\n throw error;\n }\n if (this.#closed) {\n // close() returned while this turn was still taking the lock: give it back and refuse.\n await handle.close().catch(() => undefined);\n refuse();\n throw failure(ErrorCodes.InternalError, \"the dispatcher is closed\");\n }\n // The response goes out first; the run starts after it, so no event can reach a client before its disposition.\n let begin!: () => void;\n const started = new Promise<void>((resolve) => {\n begin = resolve;\n });\n void this.#run(handle, session, opened, running, input, started).finally(() =>\n connection.untrackTurn(requestId, cancel),\n );\n return { result: { accepted: true, turn: running.turn } satisfies Disposition, after: begin };\n }\n\n /** What every turn and every resume passes to the runner besides its own settings. */\n #turnHooks(session: string, running: Running) {\n const observer: Observer = (event) => this.emit(session, event);\n return {\n ...this.#options.turn,\n observers: [observer],\n signal: running.controller.signal,\n clientTool: this.#clientTool(session, running.owner),\n onRun: (run: Run<unknown>) => {\n running.run = run;\n for (const apply of running.queued.splice(0)) apply(run);\n },\n };\n }\n\n async #run(\n handle: Session,\n session: string,\n opened: Opened,\n running: Running,\n input: Command<\"turn/start\">[\"params\"][\"input\"],\n started: Promise<void>,\n ): Promise<void> {\n await started;\n let summary: TurnResultSummary;\n try {\n await this.#seed(handle, session);\n const result = await runTurn(handle, this.#options.harness, {\n ...this.#turnHooks(session, running),\n ...completionOf(this.#options.completion?.(session)),\n input,\n // The first run has ended and a retry may follow: a steer sent now waits in the queue for the retry's run.\n onOverflowRetry: () => {\n running.run = undefined;\n },\n onContextFill: (fill) => this.emit(session, { type: \"context_fill\", tokens: fill.tokens, budget: fill.budget }),\n onCompletionCheck: (entry) => this.emit(session, { type: \"completion_check\", entry }, entry.seq),\n });\n summary = summaryOf(result);\n } catch (error) {\n summary = summaryOf(undefined, error);\n } finally {\n // A lock that will not release must not leave the session busy or the turn unsettled.\n await handle.close().catch(() => undefined);\n this.#release(opened, running);\n }\n this.settled(session, running.turn, summary);\n running.finish();\n // An answer that came while the turn ran resumes it now.\n this.#pump(session);\n }\n\n /**\n * Frees the session. A steer or follow-up still queued for a run that never started ends with its turn: its\n * disposition named the turn, `turn/settled` says the turn ended, and the log has no message for it.\n */\n #release(opened: Opened, running: Running): void {\n running.queued.length = 0;\n running.run = undefined;\n opened.running = undefined;\n }\n\n /** Seeds the sequence a run's own events carry, so a session an earlier process wrote does not start at -1. */\n async #seed(handle: Session, session: string): Promise<void> {\n const last = (await handle.path()).at(-1);\n if (last !== undefined) this.#lastSeq.set(session, Math.max(last.seq, this.#lastSeq.get(session) ?? -1));\n }\n\n #redirect(\n connection: ServerConnection,\n method: \"turn/steer\" | \"turn/followUp\",\n session: string,\n input: Command<\"turn/steer\">[\"params\"][\"input\"],\n ): Disposition {\n const running = connection.watching(session) ? this.#opened.get(session)?.running : undefined;\n if (running === undefined) return { accepted: false, reason: \"invalid\" };\n const apply = (run: Run<unknown>): boolean => {\n try {\n const queued = method === \"turn/steer\" ? run.steer([...input]) : run.followUp([...input]);\n // A message the run ends before applying is rejected as undelivered: the turn's own end says what happened.\n Promise.resolve(queued).catch(() => undefined);\n return true;\n } catch {\n return false;\n }\n };\n if (running.run === undefined) {\n running.queued.push((run) => void apply(run));\n return { accepted: true, turn: running.turn };\n }\n return apply(running.run) ? { accepted: true, turn: running.turn } : { accepted: false, reason: \"invalid\" };\n }\n\n #interrupt(\n connection: ServerConnection,\n session: string,\n reason: string | undefined,\n ): ClientResultMap[\"turn/interrupt\"] {\n const running = connection.watching(session) ? this.#opened.get(session)?.running : undefined;\n if (running === undefined) return { interrupted: false };\n running.controller.abort(reason);\n return { interrupted: true };\n }\n\n async #approvalList(connection: ServerConnection, session: string): Promise<ClientResultMap[\"approval/list\"]> {\n if (!connection.watching(session) || !this.#opened.has(session))\n throw failure(ErrorCodes.InvalidParams, `no session ${JSON.stringify(session)} is open`);\n const reader = await openSession({\n store: this.#options.store,\n index: this.#options.index,\n key: this.key(session),\n });\n // The host's own pending() decides, with a code call's requests taken out: the protocol does not yet carry one, so a\n // client is never shown one.\n const waiting = await this.#approvals.pending(reader);\n const codeRequests = codeCallRequestIds(await reader.path());\n return { pending: waiting.flatMap(({ request }) => (codeRequests.has(request.id) ? [] : [request])) };\n }\n\n /** A fresh id for a server request, unique within this dispatcher. */\n #requestId(): string {\n this.#requests += 1;\n return `sr-${this.#requests}`;\n }\n\n /**\n * Asks one connection about a signed request, unless it already waits on that connection or someone has answered\n * it. Only a connection that watches the session is asked.\n */\n #ask(connection: ServerConnection, session: string, request: SignedPendingRequest): void {\n const opened = this.#opened.get(session);\n if (!connection.watching(session) || opened === undefined) return;\n if (opened.answers.has(request.id) || connection.asking(request.id)) return;\n const id = this.#requestId();\n connection.ask(\n request.kind === \"clarification\"\n ? { jsonrpc: \"2.0\", id, method: \"clarification/request\", params: { session, request } }\n : { jsonrpc: \"2.0\", id, method: \"approval/request\", params: { session, request } },\n {\n session,\n pendingId: request.id,\n answer: (answer) => this.#answer(connection, session, request, answer),\n // A request for a person lives in the log, so a lost connection loses nothing: the next client is asked.\n lost: () => undefined,\n },\n );\n }\n\n /**\n * Asks one connection about every request of the session that still waits, as the log says now. An answer taken or\n * applied while the log was being read makes that read stale, so the log is read again before anyone is asked.\n */\n async #armFor(connection: ServerConnection, session: string, only?: ReadonlySet<string>): Promise<void> {\n const opened = this.#opened.get(session);\n if (opened === undefined) return;\n let waiting: SignedPendingRequest[] = [];\n for (let read = 0; read < ARM_READS; read++) {\n const generation = opened.generation;\n try {\n waiting = await this.#waiting(session);\n } catch {\n // A session with no file yet has nothing to ask, and an unreadable one is listed by initialize as it can be.\n return;\n }\n if (opened.generation === generation) break;\n // Answers kept changing for every read: ask nothing now, since the next resume asks again.\n if (read === ARM_READS - 1) return;\n }\n for (const request of waiting)\n if (only === undefined || only.has(request.id)) this.#ask(connection, session, request);\n }\n\n async #waiting(session: string): Promise<SignedPendingRequest[]> {\n const reader = await openSession({\n store: this.#options.store,\n index: this.#options.index,\n key: this.key(session),\n });\n return pendingApprovals(await reader.path()).map((entry) => entry.request);\n }\n\n /**\n * Takes a client's answer to an approval or a clarification. The first well-formed answer to a signed request wins\n * and the others are withdrawn; a malformed one is asked again on the same connection; an error leaves the request\n * waiting in the log for the next time the session is opened.\n */\n #answer(connection: ServerConnection, session: string, request: SignedPendingRequest, answer: ServerAnswer): void {\n if (\"error\" in answer) return;\n const opened = this.#opened.get(session);\n if (opened === undefined || opened.answers.has(request.id)) return;\n const resolution = resolutionOf(answer.result, request);\n if (resolution === undefined) {\n this.#ask(connection, session, request);\n return;\n }\n opened.answers.set(request.id, { resolution, by: connection, applying: false });\n opened.generation += 1;\n for (const other of this.#connections) other.withdrawPending(request.id);\n this.#pump(session);\n }\n\n /** Starts a resume with the answers that wait, once the session is free. */\n #pump(session: string): void {\n const opened = this.#opened.get(session);\n if (opened === undefined || opened.running !== undefined || opened.branching === true || this.#closed) return;\n const answers = [...opened.answers.entries()].filter(([, answer]) => !answer.applying);\n if (answers.length === 0) return;\n for (const [, answer] of answers) answer.applying = true;\n const running = this.#claim(opened, answers[0]?.[1].by);\n void this.#resume(session, opened, running, answers);\n }\n\n /**\n * Resumes the session with the answers through `Approvals.resolve()`, as a turn of its own that ends with\n * `turn/settled`. An answer whose request no longer waits, because another process settled it, is dropped, and a\n * resume with no answer left runs nothing and settles nothing.\n */\n async #resume(session: string, opened: Opened, running: Running, answers: [string, Answer][]): Promise<void> {\n let summary: TurnResultSummary | undefined;\n let written = false;\n try {\n const handle = await this.#lockedHandle(session);\n try {\n const waiting = new Set(pendingApprovals(await handle.path()).map((entry) => entry.request.id));\n const resolutions = answers.flatMap(([id, answer]) => (waiting.has(id) ? [answer.resolution] : []));\n if (resolutions.length > 0) {\n await this.#seed(handle, session);\n // A close or an interrupt while the lock was being taken leaves the answers unwritten, so the log never shows\n // an answer that no run applied.\n if (running.controller.signal.aborted || this.#closed) {\n summary = notApplied(\"aborted\", \"the resume was stopped before it wrote its answers\");\n } else {\n written = true;\n summary = resumedSummary(\n await this.#approvals.resolve(handle, resolutions, this.#turnHooks(session, running)),\n );\n }\n }\n } finally {\n await handle.close().catch(() => undefined);\n }\n } catch (error) {\n summary = written\n ? summaryOf(undefined, error)\n : notApplied(\"error\", `the resume could not start (${error instanceof Error ? error.message : String(error)})`);\n } finally {\n for (const [id] of answers) opened.answers.delete(id);\n opened.generation += 1;\n this.#release(opened, running);\n }\n if (summary !== undefined) this.settled(session, running.turn, summary);\n running.finish();\n this.#askAfterResume(session, opened, summary, answers);\n this.#pump(session);\n }\n\n /**\n * Asks again after a resume. A request the resume left waiting, such as one a quorum still needs, is asked again.\n * One whose answer was never written, because the lock was held or the resume was stopped, is asked again too, at\n * most `MAX_REASKS` times, so a lock another process holds can't make a loop. A resume that failed after it wrote\n * its answers asks nothing, and a closed dispatcher asks nobody.\n */\n #askAfterResume(\n session: string,\n opened: Opened,\n summary: TurnResultSummary | undefined,\n answers: readonly [string, Answer][],\n ): void {\n if (summary === undefined || this.#closed) return;\n if (summary.error === undefined) {\n for (const connection of this.#watchers(session)) void this.#armFor(connection, session);\n return;\n }\n if (summary.error.kind !== NOT_APPLIED) return;\n const again = new Set<string>();\n for (const [id] of answers) {\n const count = opened.reasks.get(id) ?? 0;\n if (count >= MAX_REASKS) continue;\n opened.reasks.set(id, count + 1);\n again.add(id);\n }\n if (again.size === 0) return;\n for (const connection of this.#watchers(session)) void this.#armFor(connection, session, again);\n }\n\n /**\n * Runs a `client_request` tool's call by sending `tool/call` to the turn's owner, and resolves with its answer. A call\n * never hangs on a client that is gone: with no owner, or once the owner closes, it resolves with an error result,\n * and an abort withdraws the request with `$/cancelRequest` and rejects.\n */\n #clientTool(session: string, owner: ServerConnection | undefined): ClientToolRunner {\n return (call) =>\n new Promise((resolve, reject) => {\n if (call.signal.aborted) {\n reject(call.signal.reason);\n return;\n }\n if (owner === undefined || !owner.open || !owner.watching(session)) {\n resolve(toolError(`no client is connected to run ${call.tool}`));\n return;\n }\n const id = this.#requestId();\n const onAbort = () => {\n owner.withdraw(id);\n reject(call.signal.reason);\n };\n call.signal.addEventListener(\"abort\", onAbort, { once: true });\n const settle = (result: ReturnType<typeof toolError>) => {\n call.signal.removeEventListener(\"abort\", onAbort);\n resolve(result);\n };\n owner.ask(\n {\n jsonrpc: \"2.0\",\n id,\n method: \"tool/call\",\n params: { session, callId: call.callId, tool: call.tool, input: call.input },\n },\n {\n session,\n answer: (answer) =>\n settle(\n \"error\" in answer\n ? toolError(`the client could not run ${call.tool}: ${answer.error.message}`)\n : toolResultOf(answer.result, call.tool),\n ),\n lost: () => settle(toolError(`the client closed before it answered the call to ${call.tool}`)),\n },\n );\n });\n }\n\n async #branch(\n connection: ServerConnection,\n command: Command<\"session/checkout\" | \"session/fork\">,\n ): Promise<ClientResultMap[\"session/fork\"]> {\n const { session } = command.params;\n const opened = this.#opened.get(session);\n if (opened === undefined || !connection.watching(session)) {\n throw failure(ErrorCodes.InvalidParams, `no session ${JSON.stringify(session)} is open`);\n }\n if (opened.running !== undefined || opened.branching === true) {\n throw failure(ErrorCodes.SessionLocked, \"a turn is running in this session\");\n }\n if (this.#closed) throw failure(ErrorCodes.InternalError, \"the dispatcher is closed\");\n opened.branching = true;\n try {\n return await this.#branchLocked(connection, command, opened);\n } finally {\n opened.branching = false;\n this.#pump(session);\n }\n }\n\n async #branchLocked(\n connection: ServerConnection,\n command: Command<\"session/checkout\" | \"session/fork\">,\n opened: Opened,\n ): Promise<ClientResultMap[\"session/fork\"]> {\n const { session, entryId } = command.params;\n // A checkout is announced under its own session; a fork's entries belong to the new session, nobody watches yet.\n const handle =\n command.method === \"session/checkout\"\n ? await this.#lockedHandle(session)\n : await openSession({\n store: this.#options.store,\n index: this.#options.index,\n lock: this.#options.lock,\n key: this.key(session),\n });\n try {\n if (command.method === \"session/checkout\") {\n await handle.checkout(entryId);\n return { session, head: handle.head() as string };\n }\n const forked = await handle.fork(entryId);\n try {\n const id = forked.key.sessionId;\n this.#opened.set(id, newOpened(opened.cwd));\n connection.watch(id);\n return { session: id, head: forked.head() as string };\n } finally {\n // The change has landed; a lock that will not release must not turn it into an error.\n await forked.close().catch(() => undefined);\n }\n } finally {\n await handle.close().catch(() => undefined);\n }\n }\n}\n\n/** Creates the dispatcher that serves `options.harness` over the protocol's commands. */\nexport function createDispatcher<H = unknown>(options: DispatcherOptions<H>): Dispatcher {\n return new HarnessDispatcher(options);\n}\n"]}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `@buildanagent/harness/server`: the harness itself. `createHarness()` holds the settings every turn shares,
|
|
3
|
+
* `createDispatcher()` serves the protocol's commands over a harness, and `inProcessTransport()` connects a client in
|
|
4
|
+
* the same process. `stdioTransport()` serves one client over a pair of byte streams, one JSON-RPC message per line,
|
|
5
|
+
* and `webSocketTransport()` serves one client over a WebSocket, one message per text frame.
|
|
6
|
+
*/
|
|
7
|
+
export { createHarness } from "../create-harness.js";
|
|
8
|
+
export type { CodeCall, CodeCallResult, Harness, HarnessEnv, HarnessOptions } from "../harness.js";
|
|
9
|
+
export { type Connection, type ConnectOptions, createDispatcher, type Dispatcher, type DispatcherOptions, EXPERIMENTAL_METHODS, } from "./dispatcher.js";
|
|
10
|
+
export { type InProcessClient, inProcessTransport, type RequestOptions, RpcFailure } from "./local-transport.js";
|
|
11
|
+
export type { Deliver } from "./outbox.js";
|
|
12
|
+
export { type NodeInput, type NodeOutput, type StdioInput, type StdioIo, type StdioOptions, type StdioOutput, stdioTransport, } from "./stdio.js";
|
|
13
|
+
export { type WebSocketCloseEvent, type WebSocketLike, type WebSocketMessageEvent, type WebSocketOptions, webSocketTransport, } from "./websocket.js";
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `@buildanagent/harness/server`: the harness itself. `createHarness()` holds the settings every turn shares,
|
|
3
|
+
* `createDispatcher()` serves the protocol's commands over a harness, and `inProcessTransport()` connects a client in
|
|
4
|
+
* the same process. `stdioTransport()` serves one client over a pair of byte streams, one JSON-RPC message per line,
|
|
5
|
+
* and `webSocketTransport()` serves one client over a WebSocket, one message per text frame.
|
|
6
|
+
*/
|
|
7
|
+
export { createHarness } from "../create-harness.js";
|
|
8
|
+
export { createDispatcher, EXPERIMENTAL_METHODS, } from "./dispatcher.js";
|
|
9
|
+
export { inProcessTransport, RpcFailure } from "./local-transport.js";
|
|
10
|
+
export { stdioTransport, } from "./stdio.js";
|
|
11
|
+
export { webSocketTransport, } from "./websocket.js";
|
|
12
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAGL,gBAAgB,EAGhB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAwB,kBAAkB,EAAuB,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEjH,OAAO,EAOL,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAKL,kBAAkB,GACnB,MAAM,gBAAgB,CAAC","sourcesContent":["/**\n * `@buildanagent/harness/server`: the harness itself. `createHarness()` holds the settings every turn shares,\n * `createDispatcher()` serves the protocol's commands over a harness, and `inProcessTransport()` connects a client in\n * the same process. `stdioTransport()` serves one client over a pair of byte streams, one JSON-RPC message per line,\n * and `webSocketTransport()` serves one client over a WebSocket, one message per text frame.\n */\nexport { createHarness } from \"../create-harness.js\";\nexport type { CodeCall, CodeCallResult, Harness, HarnessEnv, HarnessOptions } from \"../harness.js\";\nexport {\n type Connection,\n type ConnectOptions,\n createDispatcher,\n type Dispatcher,\n type DispatcherOptions,\n EXPERIMENTAL_METHODS,\n} from \"./dispatcher.js\";\nexport { type InProcessClient, inProcessTransport, type RequestOptions, RpcFailure } from \"./local-transport.js\";\nexport type { Deliver } from \"./outbox.js\";\nexport {\n type NodeInput,\n type NodeOutput,\n type StdioInput,\n type StdioIo,\n type StdioOptions,\n type StdioOutput,\n stdioTransport,\n} from \"./stdio.js\";\nexport {\n type WebSocketCloseEvent,\n type WebSocketLike,\n type WebSocketMessageEvent,\n type WebSocketOptions,\n webSocketTransport,\n} from \"./websocket.js\";\n"]}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The in-process transport: a client that lives in the same process as the dispatcher. It takes plain method calls,
|
|
3
|
+
* sends them as protocol messages and hands back the results, so a CLI or a test drives the harness with no framing,
|
|
4
|
+
* and the stdio transport later carries the same messages.
|
|
5
|
+
*/
|
|
6
|
+
import type { ClientCommand, ClientResultMap, RpcError, ServerMessage, ServerRequest, ServerResultMap } from "@buildanagent/protocol";
|
|
7
|
+
import type { Dispatcher } from "./dispatcher.js";
|
|
8
|
+
type Methods = ClientCommand["method"] & keyof ClientResultMap;
|
|
9
|
+
type ParamsOf<M extends Methods> = ClientCommand extends infer C ? C extends {
|
|
10
|
+
method: infer X;
|
|
11
|
+
params: infer P;
|
|
12
|
+
} ? M extends X ? P : never : never : never;
|
|
13
|
+
/** A command the server answered with an error. */
|
|
14
|
+
export declare class RpcFailure extends Error {
|
|
15
|
+
readonly rpc: RpcError;
|
|
16
|
+
constructor(rpc: RpcError);
|
|
17
|
+
}
|
|
18
|
+
/** What `InProcessClient.request()` takes besides the method and its params. */
|
|
19
|
+
export interface RequestOptions {
|
|
20
|
+
/**
|
|
21
|
+
* Cancels the request with `$/cancelRequest` when it aborts. For an accepted `turn/start` that lasts until the turn's
|
|
22
|
+
* `turn/settled`, so aborting after the disposition still aborts the turn.
|
|
23
|
+
*/
|
|
24
|
+
readonly signal?: AbortSignal;
|
|
25
|
+
}
|
|
26
|
+
/** What a client sees: calls that resolve with a result, the server's messages, and a way to answer its requests. */
|
|
27
|
+
export interface InProcessClient {
|
|
28
|
+
/** Sends one command and resolves with its result. Rejects with an `RpcFailure` when the server answers an error. */
|
|
29
|
+
request<M extends Methods>(method: M, params: ParamsOf<M>, options?: RequestOptions): Promise<ClientResultMap[M]>;
|
|
30
|
+
/** Calls `listener` with every notification and request the server sends, after any response already sent. */
|
|
31
|
+
onMessage(listener: (message: ServerMessage) => void): () => void;
|
|
32
|
+
/**
|
|
33
|
+
* Answers a server request with the result its method takes, so an approval can't be answered with a tool result.
|
|
34
|
+
* An answer to a request the server withdrew is ignored there.
|
|
35
|
+
*/
|
|
36
|
+
respond<R extends ServerRequest>(request: R, result: ServerResultMap[R["method"]]): void;
|
|
37
|
+
/** Answers a server request with an error, for a request the client can't or won't answer. */
|
|
38
|
+
fail(request: ServerRequest, error: RpcError): void;
|
|
39
|
+
/** Ends this client's connection. */
|
|
40
|
+
close(): void;
|
|
41
|
+
}
|
|
42
|
+
/** Connects a new client to `dispatcher`. */
|
|
43
|
+
export declare function inProcessTransport(dispatcher: Dispatcher): InProcessClient;
|
|
44
|
+
export {};
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
/** A command the server answered with an error. */
|
|
2
|
+
export class RpcFailure extends Error {
|
|
3
|
+
rpc;
|
|
4
|
+
constructor(rpc) {
|
|
5
|
+
super(rpc.message);
|
|
6
|
+
this.name = "RpcFailure";
|
|
7
|
+
this.rpc = rpc;
|
|
8
|
+
}
|
|
9
|
+
}
|
|
10
|
+
/** Sends `$/cancelRequest` for a request when its signal aborts, and returns how to stop listening. */
|
|
11
|
+
function cancelling(connection, closed) {
|
|
12
|
+
return (signal, id) => {
|
|
13
|
+
if (signal === undefined)
|
|
14
|
+
return () => undefined;
|
|
15
|
+
const cancel = () => {
|
|
16
|
+
if (!closed())
|
|
17
|
+
void connection.receive({ jsonrpc: "2.0", method: "$/cancelRequest", params: { id } });
|
|
18
|
+
};
|
|
19
|
+
signal.addEventListener("abort", cancel, { once: true });
|
|
20
|
+
return () => signal.removeEventListener("abort", cancel);
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
/** Connects a new client to `dispatcher`. */
|
|
24
|
+
export function inProcessTransport(dispatcher) {
|
|
25
|
+
const listeners = new Set();
|
|
26
|
+
const waiting = new Map();
|
|
27
|
+
// The cancel listener of each accepted turn, removed once the turn settles.
|
|
28
|
+
const turns = new Map();
|
|
29
|
+
let nextId = 1;
|
|
30
|
+
let closed = false;
|
|
31
|
+
const connection = dispatcher.connect((message) => {
|
|
32
|
+
if (!("method" in message)) {
|
|
33
|
+
if (message.id === null)
|
|
34
|
+
return;
|
|
35
|
+
const pending = waiting.get(message.id);
|
|
36
|
+
waiting.delete(message.id);
|
|
37
|
+
if (pending === undefined)
|
|
38
|
+
return;
|
|
39
|
+
if ("error" in message)
|
|
40
|
+
pending.reject(new RpcFailure(message.error));
|
|
41
|
+
else
|
|
42
|
+
pending.resolve(message.result);
|
|
43
|
+
return;
|
|
44
|
+
}
|
|
45
|
+
if (message.method === "turn/settled") {
|
|
46
|
+
turns.get(message.params.turn)?.();
|
|
47
|
+
turns.delete(message.params.turn);
|
|
48
|
+
}
|
|
49
|
+
for (const listener of listeners)
|
|
50
|
+
listener(message);
|
|
51
|
+
});
|
|
52
|
+
const answer = (id, body) => {
|
|
53
|
+
if (!closed)
|
|
54
|
+
void connection.receive({ jsonrpc: "2.0", id, ...body });
|
|
55
|
+
};
|
|
56
|
+
const cancelOn = cancelling(connection, () => closed);
|
|
57
|
+
return {
|
|
58
|
+
request(method, params, options = {}) {
|
|
59
|
+
if (closed)
|
|
60
|
+
return Promise.reject(new Error("the connection closed"));
|
|
61
|
+
if (options.signal?.aborted)
|
|
62
|
+
return Promise.reject(options.signal.reason);
|
|
63
|
+
const id = nextId++;
|
|
64
|
+
const stop = cancelOn(options.signal, id);
|
|
65
|
+
const answered = new Promise((resolve, reject) => waiting.set(id, { resolve, reject }));
|
|
66
|
+
void connection.receive({ jsonrpc: "2.0", id, method, params });
|
|
67
|
+
return answered.then((result) => {
|
|
68
|
+
const disposition = result;
|
|
69
|
+
// An accepted turn stays cancellable by this request's id until it settles.
|
|
70
|
+
if (method === "turn/start" && disposition.accepted === true && typeof disposition.turn === "string") {
|
|
71
|
+
turns.set(disposition.turn, stop);
|
|
72
|
+
}
|
|
73
|
+
else
|
|
74
|
+
stop();
|
|
75
|
+
return result;
|
|
76
|
+
}, (error) => {
|
|
77
|
+
stop();
|
|
78
|
+
throw error;
|
|
79
|
+
});
|
|
80
|
+
},
|
|
81
|
+
onMessage(listener) {
|
|
82
|
+
listeners.add(listener);
|
|
83
|
+
return () => listeners.delete(listener);
|
|
84
|
+
},
|
|
85
|
+
respond(request, result) {
|
|
86
|
+
answer(request.id, { result });
|
|
87
|
+
},
|
|
88
|
+
fail(request, error) {
|
|
89
|
+
answer(request.id, { error });
|
|
90
|
+
},
|
|
91
|
+
close() {
|
|
92
|
+
closed = true;
|
|
93
|
+
connection.close();
|
|
94
|
+
for (const pending of waiting.values())
|
|
95
|
+
pending.reject(new Error("the connection closed"));
|
|
96
|
+
waiting.clear();
|
|
97
|
+
for (const stop of turns.values())
|
|
98
|
+
stop();
|
|
99
|
+
turns.clear();
|
|
100
|
+
},
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
//# sourceMappingURL=local-transport.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"local-transport.js","sourceRoot":"","sources":["../../src/server/local-transport.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The in-process transport: a client that lives in the same process as the dispatcher. It takes plain method calls,\n * sends them as protocol messages and hands back the results, so a CLI or a test drives the harness with no framing,\n * and the stdio transport later carries the same messages.\n */\nimport type {\n ClientCommand,\n ClientResultMap,\n RpcError,\n ServerMessage,\n ServerRequest,\n ServerResultMap,\n} from \"@buildanagent/protocol\";\nimport type { Connection, Dispatcher } from \"./dispatcher.js\";\n\ntype Methods = ClientCommand[\"method\"] & keyof ClientResultMap;\ntype ParamsOf<M extends Methods> = ClientCommand extends infer C\n ? C extends { method: infer X; params: infer P }\n ? M extends X\n ? P\n : never\n : never\n : never;\n\n/** A command the server answered with an error. */\nexport class RpcFailure extends Error {\n readonly rpc: RpcError;\n constructor(rpc: RpcError) {\n super(rpc.message);\n this.name = \"RpcFailure\";\n this.rpc = rpc;\n }\n}\n\n/** What `InProcessClient.request()` takes besides the method and its params. */\nexport interface RequestOptions {\n /**\n * Cancels the request with `$/cancelRequest` when it aborts. For an accepted `turn/start` that lasts until the turn's\n * `turn/settled`, so aborting after the disposition still aborts the turn.\n */\n readonly signal?: AbortSignal;\n}\n\n/** What a client sees: calls that resolve with a result, the server's messages, and a way to answer its requests. */\nexport interface InProcessClient {\n /** Sends one command and resolves with its result. Rejects with an `RpcFailure` when the server answers an error. */\n request<M extends Methods>(method: M, params: ParamsOf<M>, options?: RequestOptions): Promise<ClientResultMap[M]>;\n /** Calls `listener` with every notification and request the server sends, after any response already sent. */\n onMessage(listener: (message: ServerMessage) => void): () => void;\n /**\n * Answers a server request with the result its method takes, so an approval can't be answered with a tool result.\n * An answer to a request the server withdrew is ignored there.\n */\n respond<R extends ServerRequest>(request: R, result: ServerResultMap[R[\"method\"]]): void;\n /** Answers a server request with an error, for a request the client can't or won't answer. */\n fail(request: ServerRequest, error: RpcError): void;\n /** Ends this client's connection. */\n close(): void;\n}\n\n/** Sends `$/cancelRequest` for a request when its signal aborts, and returns how to stop listening. */\nfunction cancelling(connection: Connection, closed: () => boolean) {\n return (signal: AbortSignal | undefined, id: number): (() => void) => {\n if (signal === undefined) return () => undefined;\n const cancel = () => {\n if (!closed()) void connection.receive({ jsonrpc: \"2.0\", method: \"$/cancelRequest\", params: { id } });\n };\n signal.addEventListener(\"abort\", cancel, { once: true });\n return () => signal.removeEventListener(\"abort\", cancel);\n };\n}\n\n/** Connects a new client to `dispatcher`. */\nexport function inProcessTransport(dispatcher: Dispatcher): InProcessClient {\n const listeners = new Set<(message: ServerMessage) => void>();\n const waiting = new Map<number | string, { resolve: (value: never) => void; reject: (error: Error) => void }>();\n // The cancel listener of each accepted turn, removed once the turn settles.\n const turns = new Map<string, () => void>();\n let nextId = 1;\n let closed = false;\n const connection: Connection = dispatcher.connect((message) => {\n if (!(\"method\" in message)) {\n if (message.id === null) return;\n const pending = waiting.get(message.id);\n waiting.delete(message.id);\n if (pending === undefined) return;\n if (\"error\" in message) pending.reject(new RpcFailure(message.error));\n else pending.resolve(message.result as never);\n return;\n }\n if (message.method === \"turn/settled\") {\n turns.get(message.params.turn)?.();\n turns.delete(message.params.turn);\n }\n for (const listener of listeners) listener(message);\n });\n const answer = (id: string, body: { result: unknown } | { error: RpcError }) => {\n if (!closed) void connection.receive({ jsonrpc: \"2.0\", id, ...body } as never);\n };\n const cancelOn = cancelling(connection, () => closed);\n return {\n request(method, params, options = {}) {\n if (closed) return Promise.reject(new Error(\"the connection closed\"));\n if (options.signal?.aborted) return Promise.reject(options.signal.reason);\n const id = nextId++;\n const stop = cancelOn(options.signal, id);\n const answered = new Promise<never>((resolve, reject) => waiting.set(id, { resolve, reject }));\n void connection.receive({ jsonrpc: \"2.0\", id, method, params } as ClientCommand);\n return answered.then(\n (result) => {\n const disposition = result as { accepted?: unknown; turn?: unknown };\n // An accepted turn stays cancellable by this request's id until it settles.\n if (method === \"turn/start\" && disposition.accepted === true && typeof disposition.turn === \"string\") {\n turns.set(disposition.turn, stop);\n } else stop();\n return result;\n },\n (error: unknown) => {\n stop();\n throw error;\n },\n );\n },\n onMessage(listener) {\n listeners.add(listener);\n return () => listeners.delete(listener);\n },\n respond(request, result) {\n answer(request.id, { result });\n },\n fail(request, error) {\n answer(request.id, { error });\n },\n close() {\n closed = true;\n connection.close();\n for (const pending of waiting.values()) pending.reject(new Error(\"the connection closed\"));\n waiting.clear();\n for (const stop of turns.values()) stop();\n turns.clear();\n },\n };\n}\n"]}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A connection's outbound queue. Messages go out one at a time and in order, and a `send` that returns a promise holds
|
|
3
|
+
* the next message until it settles, so a slow client is the only thing that makes the queue grow. Only live `event`
|
|
4
|
+
* notifications count against the bound. Once `limit` of them wait, a new one is dropped and counted against its
|
|
5
|
+
* session, and an `events_dropped` marker takes the place of a session's dropped events: before that session's next
|
|
6
|
+
* message, or once the queue has emptied. Everything else is never dropped: responses, server requests, `turn/settled`,
|
|
7
|
+
* `$/cancelRequest`, markers and replayed events. What produces each of those bounds it, as `connection.ts` says.
|
|
8
|
+
*/
|
|
9
|
+
import type { ServerMessage } from "@buildanagent/protocol";
|
|
10
|
+
/** Takes one message. A promise holds the next message until it settles; a throw or a rejection is the client's own. */
|
|
11
|
+
export type Deliver = (message: ServerMessage) => void | PromiseLike<void>;
|
|
12
|
+
/** What `push()` takes besides the message. */
|
|
13
|
+
export interface PushOptions {
|
|
14
|
+
/** Keep the message even when the queue is full. Every message but a live `event` is kept anyway. */
|
|
15
|
+
readonly keep?: boolean;
|
|
16
|
+
/** Called once the message has gone to the client, or failed to. */
|
|
17
|
+
readonly onSent?: () => void;
|
|
18
|
+
}
|
|
19
|
+
/** One connection's outbound queue, as the module comment describes. */
|
|
20
|
+
export declare class Outbox {
|
|
21
|
+
#private;
|
|
22
|
+
constructor(deliver: Deliver, limit: number);
|
|
23
|
+
/** Queues a message, or drops it when it is a live event and `limit` events already wait. */
|
|
24
|
+
push(message: ServerMessage, options?: PushOptions): void;
|
|
25
|
+
/** Counts `count` events of `session` as dropped, the last of which carried `seq`. */
|
|
26
|
+
markGap(session: string, count: number, seq: number): void;
|
|
27
|
+
/** Queues the marker for `count` dropped events of `session` now, after whatever already waits. */
|
|
28
|
+
pushGap(session: string, count: number, seq: number): void;
|
|
29
|
+
/** Drops everything still queued and refuses what comes after. */
|
|
30
|
+
close(): void;
|
|
31
|
+
}
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
const isThenable = (value) => typeof value?.then === "function";
|
|
2
|
+
/** The session a message belongs to, for the messages that name one. */
|
|
3
|
+
function sessionOf(message) {
|
|
4
|
+
if (!("method" in message))
|
|
5
|
+
return undefined;
|
|
6
|
+
const params = message.params;
|
|
7
|
+
return typeof params.session === "string" ? params.session : undefined;
|
|
8
|
+
}
|
|
9
|
+
/** One connection's outbound queue, as the module comment describes. */
|
|
10
|
+
export class Outbox {
|
|
11
|
+
#deliver;
|
|
12
|
+
#limit;
|
|
13
|
+
#queue = [];
|
|
14
|
+
#gaps = new Map();
|
|
15
|
+
#waitingEvents = 0;
|
|
16
|
+
#pumping = false;
|
|
17
|
+
#closed = false;
|
|
18
|
+
constructor(deliver, limit) {
|
|
19
|
+
this.#deliver = deliver;
|
|
20
|
+
this.#limit = limit;
|
|
21
|
+
}
|
|
22
|
+
/** Queues a message, or drops it when it is a live event and `limit` events already wait. */
|
|
23
|
+
push(message, options = {}) {
|
|
24
|
+
if (this.#closed)
|
|
25
|
+
return;
|
|
26
|
+
const droppable = "method" in message && message.method === "event" && options.keep !== true;
|
|
27
|
+
if (droppable && this.#waitingEvents >= this.#limit) {
|
|
28
|
+
this.markGap(message.params.session, 1, message.params.seq);
|
|
29
|
+
return;
|
|
30
|
+
}
|
|
31
|
+
const session = sessionOf(message);
|
|
32
|
+
if (session !== undefined)
|
|
33
|
+
this.#flushGap(session);
|
|
34
|
+
this.#enqueue({ message, droppable, onSent: options.onSent });
|
|
35
|
+
this.#pump();
|
|
36
|
+
}
|
|
37
|
+
/** Counts `count` events of `session` as dropped, the last of which carried `seq`. */
|
|
38
|
+
markGap(session, count, seq) {
|
|
39
|
+
const gap = this.#gaps.get(session);
|
|
40
|
+
if (gap === undefined)
|
|
41
|
+
this.#gaps.set(session, { count, seq });
|
|
42
|
+
else {
|
|
43
|
+
gap.count += count;
|
|
44
|
+
gap.seq = Math.max(gap.seq, seq);
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
/** Queues the marker for `count` dropped events of `session` now, after whatever already waits. */
|
|
48
|
+
pushGap(session, count, seq) {
|
|
49
|
+
if (this.#closed)
|
|
50
|
+
return;
|
|
51
|
+
this.markGap(session, count, seq);
|
|
52
|
+
this.#flushGap(session);
|
|
53
|
+
this.#pump();
|
|
54
|
+
}
|
|
55
|
+
/** Drops everything still queued and refuses what comes after. */
|
|
56
|
+
close() {
|
|
57
|
+
this.#closed = true;
|
|
58
|
+
this.#queue.length = 0;
|
|
59
|
+
this.#gaps.clear();
|
|
60
|
+
this.#waitingEvents = 0;
|
|
61
|
+
}
|
|
62
|
+
#enqueue(item) {
|
|
63
|
+
this.#queue.push(item);
|
|
64
|
+
if (item.droppable)
|
|
65
|
+
this.#waitingEvents += 1;
|
|
66
|
+
}
|
|
67
|
+
/** Queues the marker for a session's dropped events, so it goes out before the session's next message. */
|
|
68
|
+
#flushGap(session) {
|
|
69
|
+
const gap = this.#gaps.get(session);
|
|
70
|
+
if (gap === undefined)
|
|
71
|
+
return;
|
|
72
|
+
this.#gaps.delete(session);
|
|
73
|
+
this.#enqueue({
|
|
74
|
+
message: {
|
|
75
|
+
jsonrpc: "2.0",
|
|
76
|
+
method: "event",
|
|
77
|
+
params: { session, seq: gap.seq, event: { type: "events_dropped", count: gap.count } },
|
|
78
|
+
},
|
|
79
|
+
droppable: false,
|
|
80
|
+
onSent: undefined,
|
|
81
|
+
});
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Sends what waits, one message at a time. A message pushed while a send is in progress joins the same loop, and a
|
|
85
|
+
* client that takes each message at once gets it at once, with no wait between messages.
|
|
86
|
+
*/
|
|
87
|
+
#pump() {
|
|
88
|
+
if (this.#pumping)
|
|
89
|
+
return;
|
|
90
|
+
this.#pumping = true;
|
|
91
|
+
while (!this.#closed) {
|
|
92
|
+
const next = this.#queue.shift();
|
|
93
|
+
if (next === undefined) {
|
|
94
|
+
// The queue has room again, so the sessions whose events were dropped are told now.
|
|
95
|
+
if (this.#gaps.size === 0)
|
|
96
|
+
break;
|
|
97
|
+
for (const session of [...this.#gaps.keys()])
|
|
98
|
+
this.#flushGap(session);
|
|
99
|
+
continue;
|
|
100
|
+
}
|
|
101
|
+
if (next.droppable)
|
|
102
|
+
this.#waitingEvents -= 1;
|
|
103
|
+
const sent = this.#send(next);
|
|
104
|
+
if (sent !== undefined) {
|
|
105
|
+
const resume = () => {
|
|
106
|
+
next.onSent?.();
|
|
107
|
+
this.#pumping = false;
|
|
108
|
+
this.#pump();
|
|
109
|
+
};
|
|
110
|
+
// A rejection is the client's own failure, as a throw is.
|
|
111
|
+
sent.then(resume, resume);
|
|
112
|
+
return;
|
|
113
|
+
}
|
|
114
|
+
next.onSent?.();
|
|
115
|
+
}
|
|
116
|
+
this.#pumping = false;
|
|
117
|
+
}
|
|
118
|
+
/** Delivers one message, and returns the promise to wait for when the client returned one. */
|
|
119
|
+
#send(item) {
|
|
120
|
+
try {
|
|
121
|
+
const sent = this.#deliver(item.message);
|
|
122
|
+
return isThenable(sent) ? sent : undefined;
|
|
123
|
+
}
|
|
124
|
+
catch {
|
|
125
|
+
// A client's own failure to take a message must not fail the write or the turn that produced it.
|
|
126
|
+
return undefined;
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
//# sourceMappingURL=outbox.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"outbox.js","sourceRoot":"","sources":["../../src/server/outbox.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A connection's outbound queue. Messages go out one at a time and in order, and a `send` that returns a promise holds\n * the next message until it settles, so a slow client is the only thing that makes the queue grow. Only live `event`\n * notifications count against the bound. Once `limit` of them wait, a new one is dropped and counted against its\n * session, and an `events_dropped` marker takes the place of a session's dropped events: before that session's next\n * message, or once the queue has emptied. Everything else is never dropped: responses, server requests, `turn/settled`,\n * `$/cancelRequest`, markers and replayed events. What produces each of those bounds it, as `connection.ts` says.\n */\nimport type { ServerMessage } from \"@buildanagent/protocol\";\n\n/** Takes one message. A promise holds the next message until it settles; a throw or a rejection is the client's own. */\nexport type Deliver = (message: ServerMessage) => void | PromiseLike<void>;\n\ninterface Queued {\n readonly message: ServerMessage;\n readonly droppable: boolean;\n readonly onSent: (() => void) | undefined;\n}\n\ninterface Gap {\n count: number;\n seq: number;\n}\n\n/** What `push()` takes besides the message. */\nexport interface PushOptions {\n /** Keep the message even when the queue is full. Every message but a live `event` is kept anyway. */\n readonly keep?: boolean;\n /** Called once the message has gone to the client, or failed to. */\n readonly onSent?: () => void;\n}\n\nconst isThenable = (value: unknown): value is PromiseLike<void> =>\n typeof (value as { then?: unknown } | null | undefined)?.then === \"function\";\n\n/** The session a message belongs to, for the messages that name one. */\nfunction sessionOf(message: ServerMessage): string | undefined {\n if (!(\"method\" in message)) return undefined;\n const params = message.params as { session?: unknown };\n return typeof params.session === \"string\" ? params.session : undefined;\n}\n\n/** One connection's outbound queue, as the module comment describes. */\nexport class Outbox {\n readonly #deliver: Deliver;\n readonly #limit: number;\n readonly #queue: Queued[] = [];\n readonly #gaps = new Map<string, Gap>();\n #waitingEvents = 0;\n #pumping = false;\n #closed = false;\n\n constructor(deliver: Deliver, limit: number) {\n this.#deliver = deliver;\n this.#limit = limit;\n }\n\n /** Queues a message, or drops it when it is a live event and `limit` events already wait. */\n push(message: ServerMessage, options: PushOptions = {}): void {\n if (this.#closed) return;\n const droppable = \"method\" in message && message.method === \"event\" && options.keep !== true;\n if (droppable && this.#waitingEvents >= this.#limit) {\n this.markGap(message.params.session, 1, message.params.seq);\n return;\n }\n const session = sessionOf(message);\n if (session !== undefined) this.#flushGap(session);\n this.#enqueue({ message, droppable, onSent: options.onSent });\n this.#pump();\n }\n\n /** Counts `count` events of `session` as dropped, the last of which carried `seq`. */\n markGap(session: string, count: number, seq: number): void {\n const gap = this.#gaps.get(session);\n if (gap === undefined) this.#gaps.set(session, { count, seq });\n else {\n gap.count += count;\n gap.seq = Math.max(gap.seq, seq);\n }\n }\n\n /** Queues the marker for `count` dropped events of `session` now, after whatever already waits. */\n pushGap(session: string, count: number, seq: number): void {\n if (this.#closed) return;\n this.markGap(session, count, seq);\n this.#flushGap(session);\n this.#pump();\n }\n\n /** Drops everything still queued and refuses what comes after. */\n close(): void {\n this.#closed = true;\n this.#queue.length = 0;\n this.#gaps.clear();\n this.#waitingEvents = 0;\n }\n\n #enqueue(item: Queued): void {\n this.#queue.push(item);\n if (item.droppable) this.#waitingEvents += 1;\n }\n\n /** Queues the marker for a session's dropped events, so it goes out before the session's next message. */\n #flushGap(session: string): void {\n const gap = this.#gaps.get(session);\n if (gap === undefined) return;\n this.#gaps.delete(session);\n this.#enqueue({\n message: {\n jsonrpc: \"2.0\",\n method: \"event\",\n params: { session, seq: gap.seq, event: { type: \"events_dropped\", count: gap.count } },\n },\n droppable: false,\n onSent: undefined,\n });\n }\n\n /**\n * Sends what waits, one message at a time. A message pushed while a send is in progress joins the same loop, and a\n * client that takes each message at once gets it at once, with no wait between messages.\n */\n #pump(): void {\n if (this.#pumping) return;\n this.#pumping = true;\n while (!this.#closed) {\n const next = this.#queue.shift();\n if (next === undefined) {\n // The queue has room again, so the sessions whose events were dropped are told now.\n if (this.#gaps.size === 0) break;\n for (const session of [...this.#gaps.keys()]) this.#flushGap(session);\n continue;\n }\n if (next.droppable) this.#waitingEvents -= 1;\n const sent = this.#send(next);\n if (sent !== undefined) {\n const resume = () => {\n next.onSent?.();\n this.#pumping = false;\n this.#pump();\n };\n // A rejection is the client's own failure, as a throw is.\n sent.then(resume, resume);\n return;\n }\n next.onSent?.();\n }\n this.#pumping = false;\n }\n\n /** Delivers one message, and returns the promise to wait for when the client returned one. */\n #send(item: Queued): PromiseLike<void> | undefined {\n try {\n const sent = this.#deliver(item.message);\n return isThenable(sent) ? sent : undefined;\n } catch {\n // A client's own failure to take a message must not fail the write or the turn that produced it.\n return undefined;\n }\n }\n}\n"]}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Checks a command against the protocol schema before the dispatcher runs it. `protocol.schema.json` is a copy of the
|
|
3
|
+
* protocol package's generated schema, which ships no JSON of its own; a test fails while the two differ. The schema is
|
|
4
|
+
* one `anyOf` over every message, whose groups hold one branch per message kind. A command's branch is the one that
|
|
5
|
+
* requires an `id` and whose `method` is a `const` or an `enum` naming client methods: each command method must have
|
|
6
|
+
* exactly one, or building the index throws. Only the branch's `params` schema is checked, compiled with the schema's
|
|
7
|
+
* shared `$defs` the first time a command of its method arrives, and kept: `decode()` has already checked the envelope.
|
|
8
|
+
*/
|
|
9
|
+
import { type ClientCommand } from "@buildanagent/protocol";
|
|
10
|
+
/** A command method, as the client sends it with an `id`. */
|
|
11
|
+
type CommandMethod = ClientCommand["method"];
|
|
12
|
+
/** The command methods the protocol schema has a branch for, so a test can check that none is missing. */
|
|
13
|
+
export declare function checkedMethods(): readonly string[];
|
|
14
|
+
/**
|
|
15
|
+
* Why a command's params break its schema branch, or `undefined` when they fit or its method has no branch, which the
|
|
16
|
+
* dispatcher answers with `MethodNotFound`. JSON-RPC lets a command leave out `params`, which is checked as `{}`, so a
|
|
17
|
+
* method whose params are all optional takes it and one with a required field refuses it. The reason names the first
|
|
18
|
+
* error's keyword and the path to it, cut at the first key the schema does not declare, never a key or a value the
|
|
19
|
+
* client sent.
|
|
20
|
+
*/
|
|
21
|
+
export declare function paramsProblem(command: {
|
|
22
|
+
readonly method: CommandMethod | string;
|
|
23
|
+
readonly params?: unknown;
|
|
24
|
+
}): string | undefined;
|
|
25
|
+
export {};
|