@tangle-network/agent-runtime 0.338.0 → 0.339.0

package/skills/agent-graphs/references/authoring.md

@@ -49,12 +49,13 @@ On each usable settle of `from`, its routes edges are tried in declaration order
 `when` compares JSON scalars only (`equals`, `in`, `exists` at an RFC 6901 pointer, or `all` of several); a numeric or stateful rule is a field the node settles, such as a boolean or a counter.
 A match reads `from` unless it names a node listed in the edge's `evidence`; a pointer that does not resolve does not match.
 An edge without `when` is the default branch: at most one per node, and last.
-A node target receives `{ from: { node, result }, evidence }` and the edge directive; `{ stop: reason }` ends the run with no winner; `{ finish: reason }` makes this settle part of the output.
+A node target receives `{ from: { node, result }, evidence }` (a join's target `{ from: { nodes }, evidence }`) and the edge directive; `{ stop: reason }` ends the run with no winner; `{ finish: reason }` makes this settle part of the output.
 The output is `{ [node]: latest usable result }` over terminal nodes (no outgoing routes or map edge) and finish sources, and the deliverable decides it.
 Every routes cycle, each subcycle included, must cross an edge with an explicit `maxTraversals`: a cap on `a -> b` does not bound a `b <-> c` loop beside it. An edge at its cap is skipped and matching continues, so give a repair loop a fallback edge.
 `continuity: 'resume'` continues the target's latest settled session.
+A routes edge into a node that already has a settled worker in this flow (a back edge) spawns it with `successorOf` that latest settled worker; the spawn key does not change.
 A fork lists two or more nodes in `to`: one traversal spawns them all at once, each under key `route:<edge>#<traversal>:<node>`.
-A join lists two or more nodes in `from`: it fires once every member has settled usably since it last fired, its target's evidence holds each member's latest result, it carries no `when`, and it is the only routes edge leaving each member.
+A join lists two or more nodes in `from`: it fires once every member has settled usably since it last fired, its target's task is `{ from: { nodes: <members in declared order> }, evidence }` with each member's latest result in `evidence`, the same whichever member settled last, so a resumed run derives the same task; it carries no `when`, and it is the only routes edge leaving each member.
 A route into a node that still has a running worker throws `GraphRouteError` with reason `target-live`; converging branches use a join.
 A map edge may leave any flow node, and its join may have routes edges.
 A maps edge's `graph` item and a `run_graph` subtask may be flow graphs (`entry` on the topology). Inside a maps item, every entry whose task is `{ item: true }` receives the item value, and a down settle ends that item only, so `onItemFailure` decides the join.

package/dist/coder-yhVWbdWc.js

@@ -1,40 +0,0 @@
-//#region src/profiles/coder.ts
-/**
-*
-* `CoderTask` + `coderTaskToPrompt` — the per-task DATA + pure formatter for code-modification tasks
-* (§1.5: the system authors profiles; there is no hardcoded coder profile constant). A domain
-* customizes the worker by authoring its own `AgentProfile` and handing it to a leaf executor
-* (`createWorktreeCliExecutor`) or a fanout (`worktreeFanout`); "is it delivered" is a
-* `DeliverableSpec` (`patchDelivered`), not a bundled validator. This formatter renders a `CoderTask`
-* into the per-task instruction that profile receives.
-*
-* @experimental
-*/
-const DEFAULT_MAX_DIFF_LINES = 400;
-/** Render a `CoderTask` into the per-task instruction handed to the coder profile. @experimental */
-function coderTaskToPrompt(task) {
-	const base = task.baseBranch ?? "main";
-	const testCmd = task.testCmd ?? "pnpm test --run";
-	const typecheckCmd = task.typecheckCmd ?? "pnpm typecheck";
-	const maxDiff = task.maxDiffLines ?? DEFAULT_MAX_DIFF_LINES;
-	const forbidden = task.forbiddenPaths?.length ? task.forbiddenPaths.join(", ") : "(none)";
-	const context = task.contextFiles?.length ? task.contextFiles.map((f) => `  - ${f}`).join("\n") : "  (none)";
-	return [
-		`Goal: ${task.goal}`,
-		`Repo: ${task.repoRoot}`,
-		`Base branch: ${base}`,
-		`Run tests with: ${testCmd}`,
-		`Run typecheck with: ${typecheckCmd}`,
-		`Forbidden paths: ${forbidden}`,
-		`Max diff lines: ${maxDiff}`,
-		"Context files:",
-		context,
-		"",
-		"Produce a minimal patch on a fresh branch. Run tests and typecheck before",
-		"returning. Emit the final JSON result block exactly as instructed."
-	].join("\n");
-}
-//#endregion
-export { coderTaskToPrompt as t };
-
-//# sourceMappingURL=coder-yhVWbdWc.js.map

package/dist/coder-yhVWbdWc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"coder-yhVWbdWc.js","names":[],"sources":["../src/profiles/coder.ts"],"sourcesContent":["/**\n *\n * `CoderTask` + `coderTaskToPrompt` — the per-task DATA + pure formatter for code-modification tasks\n * (§1.5: the system authors profiles; there is no hardcoded coder profile constant). A domain\n * customizes the worker by authoring its own `AgentProfile` and handing it to a leaf executor\n * (`createWorktreeCliExecutor`) or a fanout (`worktreeFanout`); \"is it delivered\" is a\n * `DeliverableSpec` (`patchDelivered`), not a bundled validator. This formatter renders a `CoderTask`\n * into the per-task instruction that profile receives.\n *\n * @experimental\n */\n\nconst DEFAULT_MAX_DIFF_LINES = 400\n\n/** @experimental The per-task inputs `coderTaskToPrompt` renders + the worktree gate enforces. */\nexport interface CoderTask {\n  /** What the agent must accomplish. Free-form prose. */\n  goal: string\n  /** Absolute path inside the sandbox where the repo lives. */\n  repoRoot: string\n  /** Default `main`. The branch the agent diffs against. */\n  baseBranch?: string\n  /** Default `pnpm test --run`. */\n  testCmd?: string\n  /** Default `pnpm typecheck`. */\n  typecheckCmd?: string\n  /** Files the agent may inspect for context. Surfaced verbatim in the prompt. */\n  contextFiles?: string[]\n  /**\n   * Paths the agent must not touch. The mechanical gate hard-fails on any match.\n   * Use glob-free literal path prefixes for unambiguous enforcement.\n   */\n  forbiddenPaths?: string[]\n  /** Default 400. Hard cap; the gate hard-fails when exceeded. */\n  maxDiffLines?: number\n}\n\n/** Render a `CoderTask` into the per-task instruction handed to the coder profile. @experimental */\nexport function coderTaskToPrompt(task: CoderTask): string {\n  const base = task.baseBranch ?? 'main'\n  const testCmd = task.testCmd ?? 'pnpm test --run'\n  const typecheckCmd = task.typecheckCmd ?? 'pnpm typecheck'\n  const maxDiff = task.maxDiffLines ?? DEFAULT_MAX_DIFF_LINES\n  const forbidden = task.forbiddenPaths?.length ? task.forbiddenPaths.join(', ') : '(none)'\n  const context = task.contextFiles?.length\n    ? task.contextFiles.map((f) => `  - ${f}`).join('\\n')\n    : '  (none)'\n  return [\n    `Goal: ${task.goal}`,\n    `Repo: ${task.repoRoot}`,\n    `Base branch: ${base}`,\n    `Run tests with: ${testCmd}`,\n    `Run typecheck with: ${typecheckCmd}`,\n    `Forbidden paths: ${forbidden}`,\n    `Max diff lines: ${maxDiff}`,\n    'Context files:',\n    context,\n    '',\n    'Produce a minimal patch on a fresh branch. Run tests and typecheck before',\n    'returning. Emit the final JSON result block exactly as instructed.',\n  ].join('\\n')\n}\n"],"mappings":";;;;;;;;;;;;AAYA,MAAM,yBAAyB;;AA0B/B,SAAgB,kBAAkB,MAAyB;CACzD,MAAM,OAAO,KAAK,cAAc;CAChC,MAAM,UAAU,KAAK,WAAW;CAChC,MAAM,eAAe,KAAK,gBAAgB;CAC1C,MAAM,UAAU,KAAK,gBAAgB;CACrC,MAAM,YAAY,KAAK,gBAAgB,SAAS,KAAK,eAAe,KAAK,IAAI,IAAI;CACjF,MAAM,UAAU,KAAK,cAAc,SAC/B,KAAK,aAAa,KAAK,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI,IAClD;CACJ,OAAO;EACL,SAAS,KAAK;EACd,SAAS,KAAK;EACd,gBAAgB;EAChB,mBAAmB;EACnB,uBAAuB;EACvB,oBAAoB;EACpB,mBAAmB;EACnB;EACA;EACA;EACA;EACA;CACF,CAAC,CAAC,KAAK,IAAI;AACb"}

package/dist/delegation-status-CF4D0NZ_.js

@@ -1,358 +0,0 @@
-import { o as NotFoundError } from "./errors-DodWX-cb.js";
-//#region src/mcp/feedback-store.ts
-/** In-memory `FeedbackStore` — suitable for single-process use and tests. @stable */
-var InMemoryFeedbackStore = class {
-	events = [];
-	async put(event) {
-		this.events.push({ ...event });
-	}
-	async list(filter = {}) {
-		let out = this.events;
-		if (filter.namespace !== void 0) out = out.filter((event) => event.namespace === filter.namespace);
-		if (filter.refersToRef !== void 0) out = out.filter((event) => event.refersTo.ref === filter.refersToRef);
-		return out.map((event) => ({ ...event }));
-	}
-};
-/**
-* Project a `FeedbackEvent` down to the snapshot shape carried on
-* `delegation_history` entries.
-*
-* @stable
-*/
-function eventToSnapshot(event) {
-	const snap = {
-		id: event.id,
-		score: event.rating.score,
-		by: event.by,
-		notes: event.rating.notes,
-		capturedAt: event.capturedAt
-	};
-	if (event.rating.label) snap.label = event.rating.label;
-	return snap;
-}
-//#endregion
-//#region src/mcp/tools/delegate-feedback.ts
-/** MCP tool name for the `delegate_feedback` feedback-recording tool. @stable */
-const DELEGATE_FEEDBACK_TOOL_NAME = "delegate_feedback";
-/** Human-readable description of the `delegate_feedback` MCP tool, injected into the tool manifest. @stable */
-const DELEGATE_FEEDBACK_DESCRIPTION = [
-	"Record feedback on a delegation, artifact, or outcome. Synchronous — the",
-	"event is durably stored when this call returns.",
-	"",
-	"Use when: you (the agent), the user, or a downstream judge has formed an",
-	"opinion about a piece of work and want it persisted for calibration,",
-	"pricing, or future routing. Every call is a new event — multiple ratings",
-	"on the same target are expected and never deduped.",
-	"",
-	"`refersTo.kind`:",
-	"  - \"delegation\": ref is a taskId returned by delegate_ui_audit",
-	"  - \"artifact\":   ref is a URI/path/git-sha — anything you can dereference",
-	"  - \"outcome\":    ref is a free-form description of a downstream result",
-	"",
-	"`by`:",
-	"  - \"agent\":            the agent itself rated the work",
-	"  - \"user\":             the human user rated it",
-	"  - \"downstream-judge\": an automated evaluator emitted the rating",
-	"",
-	"When ref names a known taskId, the rating is also attached to the",
-	"delegation record so delegation_history surfaces it inline."
-].join("\n");
-/** JSON Schema for `delegate_feedback` tool arguments (`refersTo`, `rating`, `by`, optional fields). @stable */
-const DELEGATE_FEEDBACK_INPUT_SCHEMA = {
-	type: "object",
-	properties: {
-		refersTo: {
-			type: "object",
-			properties: {
-				kind: {
-					type: "string",
-					enum: [
-						"delegation",
-						"artifact",
-						"outcome"
-					]
-				},
-				ref: { type: "string" }
-			},
-			required: ["kind", "ref"],
-			additionalProperties: false
-		},
-		rating: {
-			type: "object",
-			properties: {
-				score: {
-					type: "number",
-					minimum: 0,
-					maximum: 1
-				},
-				label: {
-					type: "string",
-					enum: [
-						"good",
-						"bad",
-						"neutral",
-						"mixed"
-					]
-				},
-				notes: { type: "string" }
-			},
-			required: ["score", "notes"],
-			additionalProperties: false
-		},
-		by: {
-			type: "string",
-			enum: [
-				"agent",
-				"user",
-				"downstream-judge"
-			]
-		},
-		capturedAt: { type: "string" },
-		namespace: { type: "string" }
-	},
-	required: [
-		"refersTo",
-		"rating",
-		"by"
-	],
-	additionalProperties: false
-};
-/** Parse and validate raw MCP tool input into typed `DelegateFeedbackArgs`; throws `TypeError` on bad input. @stable */
-function validateDelegateFeedbackArgs(raw) {
-	if (raw === null || typeof raw !== "object") throw new TypeError("delegate_feedback: arguments must be an object");
-	const value = raw;
-	const refersTo = validateRefersTo(value.refersTo);
-	const rating = validateRating(value.rating);
-	const by = value.by;
-	if (by !== "agent" && by !== "user" && by !== "downstream-judge") throw new TypeError("delegate_feedback: `by` must be one of \"agent\" | \"user\" | \"downstream-judge\"");
-	const args = {
-		refersTo,
-		rating,
-		by
-	};
-	if (value.capturedAt !== void 0) {
-		if (typeof value.capturedAt !== "string" || Number.isNaN(Date.parse(value.capturedAt))) throw new TypeError("delegate_feedback: `capturedAt` must be an ISO datetime");
-		args.capturedAt = value.capturedAt;
-	}
-	if (typeof value.namespace === "string") args.namespace = value.namespace;
-	return args;
-}
-function validateRefersTo(raw) {
-	if (raw === null || typeof raw !== "object") throw new TypeError("delegate_feedback: `refersTo` must be an object");
-	const value = raw;
-	const kind = value.kind;
-	if (kind !== "delegation" && kind !== "artifact" && kind !== "outcome") throw new TypeError("delegate_feedback: `refersTo.kind` must be one of \"delegation\" | \"artifact\" | \"outcome\"");
-	const ref = value.ref;
-	if (typeof ref !== "string" || ref.trim().length === 0) throw new TypeError("delegate_feedback: `refersTo.ref` must be a non-empty string");
-	return {
-		kind,
-		ref: ref.trim()
-	};
-}
-function validateRating(raw) {
-	if (raw === null || typeof raw !== "object") throw new TypeError("delegate_feedback: `rating` must be an object");
-	const value = raw;
-	const score = Number(value.score);
-	if (!Number.isFinite(score) || score < 0 || score > 1) throw new RangeError("delegate_feedback: `rating.score` must be a number in [0, 1]");
-	const notes = value.notes;
-	if (typeof notes !== "string") throw new TypeError("delegate_feedback: `rating.notes` must be a string");
-	const rating = {
-		score,
-		notes
-	};
-	const label = value.label;
-	if (label !== void 0) {
-		if (label !== "good" && label !== "bad" && label !== "neutral" && label !== "mixed") throw new TypeError("delegate_feedback: `rating.label` must be one of \"good\" | \"bad\" | \"neutral\" | \"mixed\"");
-		rating.label = label;
-	}
-	return rating;
-}
-/** Build the MCP tool handler that persists feedback events and attaches them to delegation records. @stable */
-function createDelegateFeedbackHandler(options) {
-	const generateId = options.generateId ?? randomFeedbackId;
-	const now = options.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
-	return async (raw) => {
-		const args = validateDelegateFeedbackArgs(raw);
-		const id = generateId();
-		const event = {
-			id,
-			refersTo: args.refersTo,
-			rating: args.rating,
-			by: args.by,
-			capturedAt: args.capturedAt ?? now(),
-			namespace: args.namespace
-		};
-		await options.store.put(event);
-		if (args.refersTo.kind === "delegation") options.queue.attachFeedback(args.refersTo.ref, eventToSnapshot(event));
-		return {
-			recorded: true,
-			id
-		};
-	};
-}
-function randomFeedbackId() {
-	return `fbk-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
-}
-//#endregion
-//#region src/mcp/types.ts
-/**
-* Every delegation profile a queued record can carry. One owner: the tool schemas and validators
-* that filter on a profile read this list, so a profile added here cannot be one a tool refuses.
-* @experimental
-*/
-const delegationProfiles = [
-	"coder",
-	"researcher",
-	"ui-auditor"
-];
-//#endregion
-//#region src/mcp/tools/delegation-history.ts
-/** MCP tool name for the `delegation_history` read-past-delegations tool. @stable */
-const DELEGATION_HISTORY_TOOL_NAME = "delegation_history";
-/** Human-readable description of the `delegation_history` MCP tool, injected into the tool manifest. @stable */
-const DELEGATION_HISTORY_DESCRIPTION = [
-	"Read past delegations newest-first. Each entry carries the original",
-	"arguments, current status, cost, and any feedback attached via",
-	"delegate_feedback.",
-	"",
-	"Use when: you want to introspect prior decisions — \"have I asked this",
-	"question before?",
-	"did the last patch land?",
-	"what's the historical",
-	"success rate of coder delegations on this repo?\". Feed the results back",
-	"into your own routing and calibration.",
-	"",
-	"Each entry carries `hasTrace` — when true, the full loop-trace span tree",
-	"is retrievable via delegation_status { taskId, includeTrace: true }.",
-	"",
-	`Filters: \`namespace\` (multi-tenant scope), \`profile\` (${delegationProfiles.map((profile) => `"${profile}"`).join(" | ")}),`,
-	"`since` (ISO date — only delegations started at-or-after). `limit` defaults",
-	"to 50, capped at 500."
-].join("\n");
-/** JSON Schema for `delegation_history` tool arguments (optional `namespace`, `profile`, `since`, `limit`). @stable */
-const DELEGATION_HISTORY_INPUT_SCHEMA = {
-	type: "object",
-	properties: {
-		namespace: { type: "string" },
-		profile: {
-			type: "string",
-			enum: delegationProfiles
-		},
-		since: {
-			type: "string",
-			description: "ISO datetime — earliest startedAt to include."
-		},
-		limit: {
-			type: "integer",
-			minimum: 1,
-			maximum: 500
-		}
-	},
-	additionalProperties: false
-};
-/** Parse and validate raw MCP tool input into typed `DelegationHistoryArgs`; throws `TypeError` on bad input. @stable */
-function validateDelegationHistoryArgs(raw) {
-	if (raw === void 0 || raw === null) return {};
-	if (typeof raw !== "object") throw new TypeError("delegation_history: arguments must be an object");
-	const value = raw;
-	const out = {};
-	if (value.namespace !== void 0) {
-		if (typeof value.namespace !== "string") throw new TypeError("delegation_history: `namespace` must be a string");
-		out.namespace = value.namespace;
-	}
-	if (value.profile !== void 0) {
-		if (!delegationProfiles.includes(value.profile)) throw new TypeError(`delegation_history: \`profile\` must be one of ${delegationProfiles.join(", ")}`);
-		out.profile = value.profile;
-	}
-	if (value.since !== void 0) {
-		if (typeof value.since !== "string" || Number.isNaN(Date.parse(value.since))) throw new TypeError("delegation_history: `since` must be an ISO datetime");
-		out.since = value.since;
-	}
-	if (value.limit !== void 0) {
-		const n = Number(value.limit);
-		if (!Number.isFinite(n) || n < 1 || n > 500) throw new RangeError("delegation_history: `limit` must be an integer in [1, 500]");
-		out.limit = Math.trunc(n);
-	}
-	return out;
-}
-/** Build the MCP tool handler that reads filtered past delegations from a `DelegationTaskQueue`. @stable */
-function createDelegationHistoryHandler(options) {
-	return async (raw) => {
-		const args = validateDelegationHistoryArgs(raw);
-		return { delegations: options.queue.history(args) };
-	};
-}
-//#endregion
-//#region src/mcp/tools/delegation-status.ts
-/**
-*
-* `delegation_status` MCP tool — synchronous poll. Returns the current
-* state machine + optional progress + final result (when terminal).
-*
-* @stable
-*/
-/** MCP tool name for the `delegation_status` synchronous-poll tool. @stable */
-const DELEGATION_STATUS_TOOL_NAME = "delegation_status";
-/** Human-readable description of the `delegation_status` MCP tool, injected into the tool manifest. @stable */
-const DELEGATION_STATUS_DESCRIPTION = [
-	"Poll the status of an async delegation. Returns the current state",
-	"(pending | running | completed | failed | cancelled), optional progress,",
-	"and the final result when status === \"completed\".",
-	"",
-	"Use when: you previously kicked off an async delegation (delegate_ui_audit)",
-	"and need to know whether the work is done. The agent's right rhythm is to",
-	"call this every minute or two while waiting; do not busy-poll.",
-	"",
-	"For a completed delegate_ui_audit run, `result.output` is the array of UI",
-	"findings — one self-contained Markdown finding per issue, each with an",
-	"embedded screenshot and a suggested fix.",
-	"",
-	"Pass includeTrace: true to also receive the journaled loop-trace span",
-	"tree (loop → round → iteration, with placement/cost/verdict metadata).",
-	"Default false — keep routine polls light.",
-	"",
-	"Throws NotFoundError when taskId is unknown — never silently returns",
-	"`pending` for a typo."
-].join("\n");
-/** JSON Schema for `delegation_status` tool arguments (`taskId` + optional `includeTrace`). @stable */
-const DELEGATION_STATUS_INPUT_SCHEMA = {
-	type: "object",
-	properties: {
-		taskId: {
-			type: "string",
-			description: "Returned by delegate_ui_audit."
-		},
-		includeTrace: {
-			type: "boolean",
-			description: "Also return the journaled loop-trace span tree for this delegation. Default false."
-		}
-	},
-	required: ["taskId"],
-	additionalProperties: false
-};
-/** Parse and validate raw MCP tool input into typed `DelegationStatusArgs`; throws `TypeError` on bad input. @stable */
-function validateDelegationStatusArgs(raw) {
-	if (raw === null || typeof raw !== "object") throw new TypeError("delegation_status: arguments must be an object");
-	const value = raw;
-	const taskId = value.taskId;
-	if (typeof taskId !== "string" || taskId.trim().length === 0) throw new TypeError("delegation_status: `taskId` must be a non-empty string");
-	const out = { taskId: taskId.trim() };
-	if (value.includeTrace !== void 0) {
-		if (typeof value.includeTrace !== "boolean") throw new TypeError("delegation_status: `includeTrace` must be a boolean");
-		out.includeTrace = value.includeTrace;
-	}
-	return out;
-}
-/** Build the MCP tool handler that polls a `DelegationTaskQueue` for task status. @stable */
-function createDelegationStatusHandler(options) {
-	return async (raw) => {
-		const args = validateDelegationStatusArgs(raw);
-		const status = options.queue.status(args.taskId, args.includeTrace !== void 0 ? { includeTrace: args.includeTrace } : void 0);
-		if (!status) throw new NotFoundError(`delegation_status: unknown taskId "${args.taskId}"`);
-		return status;
-	};
-}
-//#endregion
-export { InMemoryFeedbackStore as _, validateDelegationStatusArgs as a, DELEGATION_HISTORY_TOOL_NAME as c, delegationProfiles as d, DELEGATE_FEEDBACK_DESCRIPTION as f, validateDelegateFeedbackArgs as g, createDelegateFeedbackHandler as h, createDelegationStatusHandler as i, createDelegationHistoryHandler as l, DELEGATE_FEEDBACK_TOOL_NAME as m, DELEGATION_STATUS_INPUT_SCHEMA as n, DELEGATION_HISTORY_DESCRIPTION as o, DELEGATE_FEEDBACK_INPUT_SCHEMA as p, DELEGATION_STATUS_TOOL_NAME as r, DELEGATION_HISTORY_INPUT_SCHEMA as s, DELEGATION_STATUS_DESCRIPTION as t, validateDelegationHistoryArgs as u, eventToSnapshot as v };
-
-//# sourceMappingURL=delegation-status-CF4D0NZ_.js.map

package/dist/delegation-status-CF4D0NZ_.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"delegation-status-CF4D0NZ_.js","names":[],"sources":["../src/mcp/feedback-store.ts","../src/mcp/tools/delegate-feedback.ts","../src/mcp/types.ts","../src/mcp/tools/delegation-history.ts","../src/mcp/tools/delegation-status.ts"],"sourcesContent":["/**\n *\n * Feedback persistence surface for the MCP layer.\n *\n * Feedback storage is product policy, so the MCP layer depends on this narrow\n * interface instead of choosing a knowledge store. The default implementation\n * is in-memory; consumers wire their own durable adapter via\n * `createMcpServer({ feedbackStore })`.\n *\n * Feedback events are append-only: every rating is a new event with a\n * fresh id, even when the same delegation is rated multiple times. The\n * caller decides how to roll up scores downstream.\n *\n * @stable\n */\n\nimport type { DelegateFeedbackArgs, DelegationFeedbackSnapshot } from './types'\n\n/** @stable */\nexport interface FeedbackEvent {\n  id: string\n  refersTo: DelegateFeedbackArgs['refersTo']\n  rating: DelegateFeedbackArgs['rating']\n  by: DelegateFeedbackArgs['by']\n  capturedAt: string\n  namespace?: string\n}\n\n/** @stable */\nexport interface FeedbackStore {\n  /** Append a new event. Never dedupes — every rating is its own event. */\n  put(event: FeedbackEvent): Promise<void>\n  /**\n   * List events filtered by `namespace`. When `namespace` is omitted, list\n   * across all namespaces. Returns events in insertion order.\n   */\n  list(filter?: { namespace?: string; refersToRef?: string }): Promise<FeedbackEvent[]>\n}\n\n/** In-memory `FeedbackStore` — suitable for single-process use and tests. @stable */\nexport class InMemoryFeedbackStore implements FeedbackStore {\n  private readonly events: FeedbackEvent[] = []\n\n  async put(event: FeedbackEvent): Promise<void> {\n    this.events.push({ ...event })\n  }\n\n  async list(filter: { namespace?: string; refersToRef?: string } = {}): Promise<FeedbackEvent[]> {\n    let out = this.events\n    if (filter.namespace !== undefined) {\n      out = out.filter((event) => event.namespace === filter.namespace)\n    }\n    if (filter.refersToRef !== undefined) {\n      out = out.filter((event) => event.refersTo.ref === filter.refersToRef)\n    }\n    return out.map((event) => ({ ...event }))\n  }\n}\n\n/**\n * Project a `FeedbackEvent` down to the snapshot shape carried on\n * `delegation_history` entries.\n *\n * @stable\n */\nexport function eventToSnapshot(event: FeedbackEvent): DelegationFeedbackSnapshot {\n  const snap: DelegationFeedbackSnapshot = {\n    id: event.id,\n    score: event.rating.score,\n    by: event.by,\n    notes: event.rating.notes,\n    capturedAt: event.capturedAt,\n  }\n  if (event.rating.label) snap.label = event.rating.label\n  return snap\n}\n","/**\n *\n * `delegate_feedback` MCP tool — synchronous record of agent / user /\n * downstream-judge feedback on a delegation, artifact, or outcome.\n *\n * The store is append-only. Every rating is its own event; no dedupe.\n * When `refersTo.kind === 'delegation'`, the snapshot is also attached\n * to the matching queue record so `delegation_history` surfaces it\n * inline without a join.\n *\n * @stable\n */\n\nimport type { FeedbackStore } from '../feedback-store'\nimport { eventToSnapshot } from '../feedback-store'\nimport type { DelegationTaskQueue } from '../task-queue'\nimport type {\n  DelegateFeedbackArgs,\n  DelegateFeedbackResult,\n  FeedbackRating,\n  FeedbackRefersTo,\n} from '../types'\n\n/** MCP tool name for the `delegate_feedback` feedback-recording tool. @stable */\nexport const DELEGATE_FEEDBACK_TOOL_NAME = 'delegate_feedback'\n\n/** Human-readable description of the `delegate_feedback` MCP tool, injected into the tool manifest. @stable */\nexport const DELEGATE_FEEDBACK_DESCRIPTION = [\n  'Record feedback on a delegation, artifact, or outcome. Synchronous — the',\n  'event is durably stored when this call returns.',\n  '',\n  'Use when: you (the agent), the user, or a downstream judge has formed an',\n  'opinion about a piece of work and want it persisted for calibration,',\n  'pricing, or future routing. Every call is a new event — multiple ratings',\n  'on the same target are expected and never deduped.',\n  '',\n  '`refersTo.kind`:',\n  '  - \"delegation\": ref is a taskId returned by delegate_ui_audit',\n  '  - \"artifact\":   ref is a URI/path/git-sha — anything you can dereference',\n  '  - \"outcome\":    ref is a free-form description of a downstream result',\n  '',\n  '`by`:',\n  '  - \"agent\":            the agent itself rated the work',\n  '  - \"user\":             the human user rated it',\n  '  - \"downstream-judge\": an automated evaluator emitted the rating',\n  '',\n  'When ref names a known taskId, the rating is also attached to the',\n  'delegation record so delegation_history surfaces it inline.',\n].join('\\n')\n\n/** JSON Schema for `delegate_feedback` tool arguments (`refersTo`, `rating`, `by`, optional fields). @stable */\nexport const DELEGATE_FEEDBACK_INPUT_SCHEMA = {\n  type: 'object',\n  properties: {\n    refersTo: {\n      type: 'object',\n      properties: {\n        kind: { type: 'string', enum: ['delegation', 'artifact', 'outcome'] },\n        ref: { type: 'string' },\n      },\n      required: ['kind', 'ref'],\n      additionalProperties: false,\n    },\n    rating: {\n      type: 'object',\n      properties: {\n        score: { type: 'number', minimum: 0, maximum: 1 },\n        label: { type: 'string', enum: ['good', 'bad', 'neutral', 'mixed'] },\n        notes: { type: 'string' },\n      },\n      required: ['score', 'notes'],\n      additionalProperties: false,\n    },\n    by: { type: 'string', enum: ['agent', 'user', 'downstream-judge'] },\n    capturedAt: { type: 'string' },\n    namespace: { type: 'string' },\n  },\n  required: ['refersTo', 'rating', 'by'],\n  additionalProperties: false,\n} as const\n\n/** Parse and validate raw MCP tool input into typed `DelegateFeedbackArgs`; throws `TypeError` on bad input. @stable */\nexport function validateDelegateFeedbackArgs(raw: unknown): DelegateFeedbackArgs {\n  if (raw === null || typeof raw !== 'object') {\n    throw new TypeError('delegate_feedback: arguments must be an object')\n  }\n  const value = raw as Record<string, unknown>\n  const refersTo = validateRefersTo(value.refersTo)\n  const rating = validateRating(value.rating)\n  const by = value.by\n  if (by !== 'agent' && by !== 'user' && by !== 'downstream-judge') {\n    throw new TypeError(\n      'delegate_feedback: `by` must be one of \"agent\" | \"user\" | \"downstream-judge\"',\n    )\n  }\n  const args: DelegateFeedbackArgs = { refersTo, rating, by }\n  if (value.capturedAt !== undefined) {\n    if (typeof value.capturedAt !== 'string' || Number.isNaN(Date.parse(value.capturedAt))) {\n      throw new TypeError('delegate_feedback: `capturedAt` must be an ISO datetime')\n    }\n    args.capturedAt = value.capturedAt\n  }\n  if (typeof value.namespace === 'string') args.namespace = value.namespace\n  return args\n}\n\nfunction validateRefersTo(raw: unknown): FeedbackRefersTo {\n  if (raw === null || typeof raw !== 'object') {\n    throw new TypeError('delegate_feedback: `refersTo` must be an object')\n  }\n  const value = raw as Record<string, unknown>\n  const kind = value.kind\n  if (kind !== 'delegation' && kind !== 'artifact' && kind !== 'outcome') {\n    throw new TypeError(\n      'delegate_feedback: `refersTo.kind` must be one of \"delegation\" | \"artifact\" | \"outcome\"',\n    )\n  }\n  const ref = value.ref\n  if (typeof ref !== 'string' || ref.trim().length === 0) {\n    throw new TypeError('delegate_feedback: `refersTo.ref` must be a non-empty string')\n  }\n  return { kind, ref: ref.trim() }\n}\n\nfunction validateRating(raw: unknown): FeedbackRating {\n  if (raw === null || typeof raw !== 'object') {\n    throw new TypeError('delegate_feedback: `rating` must be an object')\n  }\n  const value = raw as Record<string, unknown>\n  const score = Number(value.score)\n  if (!Number.isFinite(score) || score < 0 || score > 1) {\n    throw new RangeError('delegate_feedback: `rating.score` must be a number in [0, 1]')\n  }\n  const notes = value.notes\n  if (typeof notes !== 'string') {\n    throw new TypeError('delegate_feedback: `rating.notes` must be a string')\n  }\n  const rating: FeedbackRating = { score, notes }\n  const label = value.label\n  if (label !== undefined) {\n    if (label !== 'good' && label !== 'bad' && label !== 'neutral' && label !== 'mixed') {\n      throw new TypeError(\n        'delegate_feedback: `rating.label` must be one of \"good\" | \"bad\" | \"neutral\" | \"mixed\"',\n      )\n    }\n    rating.label = label\n  }\n  return rating\n}\n\n/** @stable */\nexport interface DelegateFeedbackHandlerOptions {\n  queue: DelegationTaskQueue\n  store: FeedbackStore\n  generateId?: () => string\n  now?: () => string\n}\n\n/** Build the MCP tool handler that persists feedback events and attaches them to delegation records. @stable */\nexport function createDelegateFeedbackHandler(\n  options: DelegateFeedbackHandlerOptions,\n): (raw: unknown) => Promise<DelegateFeedbackResult> {\n  const generateId = options.generateId ?? randomFeedbackId\n  const now = options.now ?? (() => new Date().toISOString())\n  return async (raw) => {\n    const args = validateDelegateFeedbackArgs(raw)\n    const id = generateId()\n    const event = {\n      id,\n      refersTo: args.refersTo,\n      rating: args.rating,\n      by: args.by,\n      capturedAt: args.capturedAt ?? now(),\n      namespace: args.namespace,\n    }\n    await options.store.put(event)\n    if (args.refersTo.kind === 'delegation') {\n      options.queue.attachFeedback(args.refersTo.ref, eventToSnapshot(event))\n    }\n    return { recorded: true, id }\n  }\n}\n\nfunction randomFeedbackId(): string {\n  const t = Date.now().toString(36)\n  const r = Math.random().toString(36).slice(2, 10)\n  return `fbk-${t}-${r}`\n}\n","/**\n *\n * MCP delegation tool surface — the typed inputs/outputs the product agent\n * sees over the wire. These types are the contract; the JSON schemas under\n * `tools/*` mirror them for the MCP `tools/list` advertisement.\n *\n * Async semantics: `delegate_ui_audit` returns a `taskId` immediately. The\n * product agent polls `delegation_status` until the task transitions to\n * `completed` | `failed` | `cancelled`. `delegate_feedback` +\n * `delegation_history` are synchronous reads / writes against the local\n * task queue + feedback store.\n *\n * @experimental\n */\n\nimport type { CoderTask } from '../profiles/coder'\nimport type { ResearchSource } from '../profiles/researcher'\nimport type { UiFinding, UiLens } from '../profiles/ui-auditor/substrate'\nimport type { DelegationTraceSpan } from './delegation-trace'\nimport type { CoderOutput } from './detached-coder'\n\n/**\n * Every delegation profile a queued record can carry. One owner: the tool schemas and validators\n * that filter on a profile read this list, so a profile added here cannot be one a tool refuses.\n * @experimental\n */\nexport const delegationProfiles = ['coder', 'researcher', 'ui-auditor'] as const\n\n/** @experimental */\nexport type DelegationProfile = (typeof delegationProfiles)[number]\n\n/** @experimental */\nexport type DelegationStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled'\n\n/**\n * Minimal `CoderTask` overrides exposed over the MCP wire. The full\n * `CoderTask` carries fields the kernel synthesizes from `goal` +\n * `repoRoot` — the agent only edits the few that materially gate\n * validator behavior.\n *\n * @experimental\n */\nexport interface DelegateCodeConfig {\n  testCmd?: string\n  typecheckCmd?: string\n  forbiddenPaths?: string[]\n  maxDiffLines?: number\n}\n\n/** @experimental */\nexport interface DelegateCodeArgs {\n  /** Natural-language description of what the coder must accomplish. */\n  goal: string\n  /** Absolute path inside the sandbox where the repo lives. */\n  repoRoot: string\n  /** Optional free-form context the agent surfaces in the prompt prelude. */\n  contextHint?: string\n  /**\n   * When > 1, dispatches `multiHarnessCoderFanout` across the delegate's configured exact profiles\n   * and picks the highest-scoring passing patch. Default 1.\n   */\n  variants?: number\n  /** Validator + prompt overrides the agent knows for this repo. */\n  config?: DelegateCodeConfig\n  /** Multi-tenant scope (customer-id, workspace-id). */\n  namespace?: string\n}\n\n/** @experimental */\nexport interface DelegateCodeResult {\n  taskId: string\n  /** Best-effort hint — coder loops can take minutes-to-hours. */\n  estimatedDurationMs?: number\n}\n\nexport type { ResearchSource }\n\n/** @experimental */\nexport interface DelegateResearchConfig {\n  recencyWindow?: { since?: string; until?: string }\n  maxItems?: number\n  minConfidence?: number\n}\n\n/** @experimental */\nexport interface DelegateResearchArgs {\n  question: string\n  namespace: string\n  scope?: string\n  sources?: ResearchSource[]\n  variants?: number\n  config?: DelegateResearchConfig\n}\n\n/** @experimental */\nexport interface DelegateResearchResult {\n  taskId: string\n  estimatedDurationMs?: number\n}\n\n/** @experimental */\nexport interface FeedbackRefersTo {\n  kind: 'delegation' | 'artifact' | 'outcome'\n  /** For `'delegation'`, this is the taskId. */\n  ref: string\n}\n\n/** @experimental */\nexport interface FeedbackRating {\n  /** [0, 1]. */\n  score: number\n  label?: 'good' | 'bad' | 'neutral' | 'mixed'\n  notes: string\n}\n\n/** @experimental */\nexport interface DelegateFeedbackArgs {\n  refersTo: FeedbackRefersTo\n  rating: FeedbackRating\n  by: 'agent' | 'user' | 'downstream-judge'\n  /** ISO timestamp; defaults to server clock when omitted. */\n  capturedAt?: string\n  namespace?: string\n}\n\n/** @experimental */\nexport interface DelegateFeedbackResult {\n  recorded: true\n  id: string\n}\n\n/** @experimental */\nexport interface DelegationStatusArgs {\n  taskId: string\n  /**\n   * Return the delegation's compact loop-trace span tree alongside the\n   * status. Default false — status polls stay light; opt in when you need\n   * the topology (which iterations ran, where they were placed, what each\n   * cost) rather than just the state machine.\n   */\n  includeTrace?: boolean\n}\n\n/** @experimental */\nexport interface DelegationProgress {\n  iteration: number\n  phase: string\n}\n\n/** @experimental */\nexport interface DelegationError {\n  message: string\n  kind: string\n}\n\n/**\n * Polymorphic `result` field: `CoderOutput` when the underlying profile\n * is `'coder'`, a structurally-typed research output when `'researcher'`.\n * The MCP wire carries it as JSON either way.\n *\n * @experimental\n */\nexport type DelegationResultPayload =\n  | { profile: 'coder'; output: CoderOutput }\n  | { profile: 'researcher'; output: ResearchOutputShape }\n  | { profile: 'ui-auditor'; output: UiAuditorDelegationOutput }\n\n/**\n * Wire-shape of a completed UI-audit delegation. The `findings` array\n * contains every finding persisted to the workspace during the run,\n * already enriched with `id` and `createdAt` by the writer. `workspaceDir`\n * is the absolute path to the workspace; `indexFile` is the workspace-\n * relative path to the regenerated index.md.\n *\n * @experimental\n */\nexport interface UiAuditorDelegationOutput {\n  workspaceDir: string\n  indexFile: string\n  findings: UiFinding[]\n  /** Total iterations the loop ran for this delegation. */\n  iterations: number\n}\n\n/** @experimental */\nexport type UiAuditLensFilter = readonly UiLens[]\n\n/** Optional per-route capture spec the agent surfaces over the wire. */\nexport interface DelegateUiAuditRoute {\n  /** Stable route name (used in screenshot filenames + finding metadata). */\n  name: string\n  /** Fully-qualified URL. */\n  url: string\n  /** Viewports to capture at. Defaults to `[{ width: 1280, height: 800 }]`. */\n  viewports?: readonly { width: number; height: number }[]\n  /** Default false. Full-page captures for the broad lenses. */\n  fullPage?: boolean\n  /** Selector to wait for before capture. */\n  waitFor?: string\n}\n\n/** @experimental */\nexport interface DelegateUiAuditConfig {\n  /**\n   * Lenses to iterate. Default: every lens except `'other'`. Order is\n   * preserved — the driver iterates lens-by-lens.\n   */\n  lenses?: UiAuditLensFilter\n  /** Maximum total iterations across all (lens × route) pairs. Default 33 (11 lenses × 3 routes). */\n  maxIterations?: number\n  /** Maximum concurrent iterations within a single plan() round. Default 2. */\n  maxConcurrency?: number\n  /** Free-form product context surfaced to the judge. */\n  productContext?: string\n}\n\n/** @experimental */\nexport interface DelegateUiAuditArgs {\n  /** Workspace root for the audit (absolute path). */\n  workspaceDir: string\n  /** Routes to audit. Must be non-empty. */\n  routes: readonly DelegateUiAuditRoute[]\n  /** Multi-tenant scope. */\n  namespace?: string\n  config?: DelegateUiAuditConfig\n}\n\n/** @experimental */\nexport interface DelegateUiAuditResult {\n  taskId: string\n  estimatedDurationMs?: number\n}\n\n/**\n * Provider-neutral research output carried over the MCP boundary. The MCP\n * layer accepts this structural shape instead of coupling its wire contract to\n * one research implementation.\n *\n * @experimental\n */\nexport interface ResearchOutputShape {\n  items: unknown[]\n  citations: unknown[]\n  proposedWrites: unknown[]\n  gaps?: string[]\n  notes?: string\n  [key: string]: unknown\n}\n\n/** @experimental */\nexport interface DelegationStatusResult {\n  taskId: string\n  profile: DelegationProfile\n  status: DelegationStatus\n  progress?: DelegationProgress\n  result?: DelegationResultPayload\n  error?: DelegationError\n  costUsd?: number\n  startedAt: string\n  completedAt?: string\n  /** Compact loop-trace span tree; present only when `includeTrace: true` was passed and spans were recorded. */\n  trace?: DelegationTraceSpan[]\n  /** Present when oldest trace spans were dropped to honor the trace caps. */\n  traceTruncated?: true\n  /** Inherited trace identity recorded at submit — join key into the caller's trace. */\n  traceId?: string\n  /** Caller span that dispatched the delegation, when one was inherited. */\n  parentSpanId?: string\n}\n\n/** @experimental */\nexport interface DelegationHistoryArgs {\n  namespace?: string\n  profile?: DelegationProfile\n  /** ISO date — only delegations started at-or-after `since` are returned. */\n  since?: string\n  /** Default 50. Hard cap 500. */\n  limit?: number\n}\n\n/** @experimental */\nexport interface DelegationFeedbackSnapshot {\n  id: string\n  score: number\n  label?: FeedbackRating['label']\n  by: DelegateFeedbackArgs['by']\n  notes: string\n  capturedAt: string\n}\n\n/** @experimental */\nexport interface DelegationHistoryEntry {\n  taskId: string\n  profile: DelegationProfile\n  namespace?: string\n  args: DelegateCodeArgs | DelegateResearchArgs | DelegateUiAuditArgs\n  status: DelegationStatus\n  feedback?: DelegationFeedbackSnapshot[]\n  costUsd?: number\n  startedAt: string\n  completedAt?: string\n  /**\n   * True when the record carries a journaled loop trace. History stays\n   * light by design — fetch the spans via\n   * `delegation_status { taskId, includeTrace: true }`.\n   */\n  hasTrace: boolean\n  /** Inherited trace identity recorded at submit — join key into the caller's trace. */\n  traceId?: string\n}\n\n/** @experimental */\nexport interface DelegationHistoryResult {\n  delegations: DelegationHistoryEntry[]\n}\n\n/**\n * Re-export `CoderTask` so callers wiring custom delegates don't have to\n * import from `./profiles` themselves.\n *\n * @experimental\n */\nexport type { CoderOutput, CoderTask }\n","/**\n *\n * `delegation_history` MCP tool — synchronous read of past delegations.\n * The agent uses this for self-introspection — \"have I delegated this\n * kind of task before? did it work?\" — and calibration.\n *\n * @stable\n */\n\nimport type {\n  DelegationHistoryArgs,\n  DelegationHistoryResult,\n  DelegationProfile,\n  DelegationTaskQueue,\n} from '../task-queue'\nimport { delegationProfiles } from '../types'\n\n/** MCP tool name for the `delegation_history` read-past-delegations tool. @stable */\nexport const DELEGATION_HISTORY_TOOL_NAME = 'delegation_history'\n\n/** Human-readable description of the `delegation_history` MCP tool, injected into the tool manifest. @stable */\nexport const DELEGATION_HISTORY_DESCRIPTION = [\n  'Read past delegations newest-first. Each entry carries the original',\n  'arguments, current status, cost, and any feedback attached via',\n  'delegate_feedback.',\n  '',\n  'Use when: you want to introspect prior decisions — \"have I asked this',\n  'question before?',\n  'did the last patch land?',\n  \"what's the historical\",\n  'success rate of coder delegations on this repo?\". Feed the results back',\n  'into your own routing and calibration.',\n  '',\n  'Each entry carries `hasTrace` — when true, the full loop-trace span tree',\n  'is retrievable via delegation_status { taskId, includeTrace: true }.',\n  '',\n  `Filters: \\`namespace\\` (multi-tenant scope), \\`profile\\` (${delegationProfiles\n    .map((profile) => `\"${profile}\"`)\n    .join(' | ')}),`,\n  '`since` (ISO date — only delegations started at-or-after). `limit` defaults',\n  'to 50, capped at 500.',\n].join('\\n')\n\n/** JSON Schema for `delegation_history` tool arguments (optional `namespace`, `profile`, `since`, `limit`). @stable */\nexport const DELEGATION_HISTORY_INPUT_SCHEMA = {\n  type: 'object',\n  properties: {\n    namespace: { type: 'string' },\n    profile: { type: 'string', enum: delegationProfiles },\n    since: { type: 'string', description: 'ISO datetime — earliest startedAt to include.' },\n    limit: { type: 'integer', minimum: 1, maximum: 500 },\n  },\n  additionalProperties: false,\n} as const\n\n/** Parse and validate raw MCP tool input into typed `DelegationHistoryArgs`; throws `TypeError` on bad input. @stable */\nexport function validateDelegationHistoryArgs(raw: unknown): DelegationHistoryArgs {\n  if (raw === undefined || raw === null) return {}\n  if (typeof raw !== 'object') {\n    throw new TypeError('delegation_history: arguments must be an object')\n  }\n  const value = raw as Record<string, unknown>\n  const out: DelegationHistoryArgs = {}\n  if (value.namespace !== undefined) {\n    if (typeof value.namespace !== 'string') {\n      throw new TypeError('delegation_history: `namespace` must be a string')\n    }\n    out.namespace = value.namespace\n  }\n  if (value.profile !== undefined) {\n    if (!delegationProfiles.includes(value.profile as DelegationProfile)) {\n      throw new TypeError(\n        `delegation_history: \\`profile\\` must be one of ${delegationProfiles.join(', ')}`,\n      )\n    }\n    out.profile = value.profile as DelegationProfile\n  }\n  if (value.since !== undefined) {\n    if (typeof value.since !== 'string' || Number.isNaN(Date.parse(value.since))) {\n      throw new TypeError('delegation_history: `since` must be an ISO datetime')\n    }\n    out.since = value.since\n  }\n  if (value.limit !== undefined) {\n    const n = Number(value.limit)\n    if (!Number.isFinite(n) || n < 1 || n > 500) {\n      throw new RangeError('delegation_history: `limit` must be an integer in [1, 500]')\n    }\n    out.limit = Math.trunc(n)\n  }\n  return out\n}\n\n/** @stable */\nexport interface DelegationHistoryHandlerOptions {\n  queue: DelegationTaskQueue\n}\n\n/** Build the MCP tool handler that reads filtered past delegations from a `DelegationTaskQueue`. @stable */\nexport function createDelegationHistoryHandler(\n  options: DelegationHistoryHandlerOptions,\n): (raw: unknown) => Promise<DelegationHistoryResult> {\n  return async (raw) => {\n    const args = validateDelegationHistoryArgs(raw)\n    return { delegations: options.queue.history(args) }\n  }\n}\n","/**\n *\n * `delegation_status` MCP tool — synchronous poll. Returns the current\n * state machine + optional progress + final result (when terminal).\n *\n * @stable\n */\n\nimport { NotFoundError } from '../../errors'\nimport type {\n  DelegationStatusArgs,\n  DelegationStatusResult,\n  DelegationTaskQueue,\n} from '../task-queue'\n\n/** MCP tool name for the `delegation_status` synchronous-poll tool. @stable */\nexport const DELEGATION_STATUS_TOOL_NAME = 'delegation_status'\n\n/** Human-readable description of the `delegation_status` MCP tool, injected into the tool manifest. @stable */\nexport const DELEGATION_STATUS_DESCRIPTION = [\n  'Poll the status of an async delegation. Returns the current state',\n  '(pending | running | completed | failed | cancelled), optional progress,',\n  'and the final result when status === \"completed\".',\n  '',\n  'Use when: you previously kicked off an async delegation (delegate_ui_audit)',\n  \"and need to know whether the work is done. The agent's right rhythm is to\",\n  'call this every minute or two while waiting; do not busy-poll.',\n  '',\n  'For a completed delegate_ui_audit run, `result.output` is the array of UI',\n  'findings — one self-contained Markdown finding per issue, each with an',\n  'embedded screenshot and a suggested fix.',\n  '',\n  'Pass includeTrace: true to also receive the journaled loop-trace span',\n  'tree (loop → round → iteration, with placement/cost/verdict metadata).',\n  'Default false — keep routine polls light.',\n  '',\n  'Throws NotFoundError when taskId is unknown — never silently returns',\n  '`pending` for a typo.',\n].join('\\n')\n\n/** JSON Schema for `delegation_status` tool arguments (`taskId` + optional `includeTrace`). @stable */\nexport const DELEGATION_STATUS_INPUT_SCHEMA = {\n  type: 'object',\n  properties: {\n    taskId: { type: 'string', description: 'Returned by delegate_ui_audit.' },\n    includeTrace: {\n      type: 'boolean',\n      description:\n        'Also return the journaled loop-trace span tree for this delegation. Default false.',\n    },\n  },\n  required: ['taskId'],\n  additionalProperties: false,\n} as const\n\n/** Parse and validate raw MCP tool input into typed `DelegationStatusArgs`; throws `TypeError` on bad input. @stable */\nexport function validateDelegationStatusArgs(raw: unknown): DelegationStatusArgs {\n  if (raw === null || typeof raw !== 'object') {\n    throw new TypeError('delegation_status: arguments must be an object')\n  }\n  const value = raw as Record<string, unknown>\n  const taskId = value.taskId\n  if (typeof taskId !== 'string' || taskId.trim().length === 0) {\n    throw new TypeError('delegation_status: `taskId` must be a non-empty string')\n  }\n  const out: DelegationStatusArgs = { taskId: taskId.trim() }\n  if (value.includeTrace !== undefined) {\n    if (typeof value.includeTrace !== 'boolean') {\n      throw new TypeError('delegation_status: `includeTrace` must be a boolean')\n    }\n    out.includeTrace = value.includeTrace\n  }\n  return out\n}\n\n/** @stable */\nexport interface DelegationStatusHandlerOptions {\n  queue: DelegationTaskQueue\n}\n\n/** Build the MCP tool handler that polls a `DelegationTaskQueue` for task status. @stable */\nexport function createDelegationStatusHandler(\n  options: DelegationStatusHandlerOptions,\n): (raw: unknown) => Promise<DelegationStatusResult> {\n  return async (raw) => {\n    const args = validateDelegationStatusArgs(raw)\n    const status = options.queue.status(\n      args.taskId,\n      args.includeTrace !== undefined ? { includeTrace: args.includeTrace } : undefined,\n    )\n    if (!status) {\n      throw new NotFoundError(`delegation_status: unknown taskId \"${args.taskId}\"`)\n    }\n    return status\n  }\n}\n"],"mappings":";;;AAwCA,IAAa,wBAAb,MAA4D;CAC1D,SAA2C,CAAC;CAE5C,MAAM,IAAI,OAAqC;EAC7C,KAAK,OAAO,KAAK,EAAE,GAAG,MAAM,CAAC;CAC/B;CAEA,MAAM,KAAK,SAAuD,CAAC,GAA6B;EAC9F,IAAI,MAAM,KAAK;EACf,IAAI,OAAO,cAAc,KAAA,GACvB,MAAM,IAAI,QAAQ,UAAU,MAAM,cAAc,OAAO,SAAS;EAElE,IAAI,OAAO,gBAAgB,KAAA,GACzB,MAAM,IAAI,QAAQ,UAAU,MAAM,SAAS,QAAQ,OAAO,WAAW;EAEvE,OAAO,IAAI,KAAK,WAAW,EAAE,GAAG,MAAM,EAAE;CAC1C;AACF;;;;;;;AAQA,SAAgB,gBAAgB,OAAkD;CAChF,MAAM,OAAmC;EACvC,IAAI,MAAM;EACV,OAAO,MAAM,OAAO;EACpB,IAAI,MAAM;EACV,OAAO,MAAM,OAAO;EACpB,YAAY,MAAM;CACpB;CACA,IAAI,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,OAAO;CAClD,OAAO;AACT;;;;ACnDA,MAAa,8BAA8B;;AAG3C,MAAa,gCAAgC;CAC3C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC,CAAC,KAAK,IAAI;;AAGX,MAAa,iCAAiC;CAC5C,MAAM;CACN,YAAY;EACV,UAAU;GACR,MAAM;GACN,YAAY;IACV,MAAM;KAAE,MAAM;KAAU,MAAM;MAAC;MAAc;MAAY;KAAS;IAAE;IACpE,KAAK,EAAE,MAAM,SAAS;GACxB;GACA,UAAU,CAAC,QAAQ,KAAK;GACxB,sBAAsB;EACxB;EACA,QAAQ;GACN,MAAM;GACN,YAAY;IACV,OAAO;KAAE,MAAM;KAAU,SAAS;KAAG,SAAS;IAAE;IAChD,OAAO;KAAE,MAAM;KAAU,MAAM;MAAC;MAAQ;MAAO;MAAW;KAAO;IAAE;IACnE,OAAO,EAAE,MAAM,SAAS;GAC1B;GACA,UAAU,CAAC,SAAS,OAAO;GAC3B,sBAAsB;EACxB;EACA,IAAI;GAAE,MAAM;GAAU,MAAM;IAAC;IAAS;IAAQ;GAAkB;EAAE;EAClE,YAAY,EAAE,MAAM,SAAS;EAC7B,WAAW,EAAE,MAAM,SAAS;CAC9B;CACA,UAAU;EAAC;EAAY;EAAU;CAAI;CACrC,sBAAsB;AACxB;;AAGA,SAAgB,6BAA6B,KAAoC;CAC/E,IAAI,QAAQ,QAAQ,OAAO,QAAQ,UACjC,MAAM,IAAI,UAAU,gDAAgD;CAEtE,MAAM,QAAQ;CACd,MAAM,WAAW,iBAAiB,MAAM,QAAQ;CAChD,MAAM,SAAS,eAAe,MAAM,MAAM;CAC1C,MAAM,KAAK,MAAM;CACjB,IAAI,OAAO,WAAW,OAAO,UAAU,OAAO,oBAC5C,MAAM,IAAI,UACR,oFACF;CAEF,MAAM,OAA6B;EAAE;EAAU;EAAQ;CAAG;CAC1D,IAAI,MAAM,eAAe,KAAA,GAAW;EAClC,IAAI,OAAO,MAAM,eAAe,YAAY,OAAO,MAAM,KAAK,MAAM,MAAM,UAAU,CAAC,GACnF,MAAM,IAAI,UAAU,yDAAyD;EAE/E,KAAK,aAAa,MAAM;CAC1B;CACA,IAAI,OAAO,MAAM,cAAc,UAAU,KAAK,YAAY,MAAM;CAChE,OAAO;AACT;AAEA,SAAS,iBAAiB,KAAgC;CACxD,IAAI,QAAQ,QAAQ,OAAO,QAAQ,UACjC,MAAM,IAAI,UAAU,iDAAiD;CAEvE,MAAM,QAAQ;CACd,MAAM,OAAO,MAAM;CACnB,IAAI,SAAS,gBAAgB,SAAS,cAAc,SAAS,WAC3D,MAAM,IAAI,UACR,+FACF;CAEF,MAAM,MAAM,MAAM;CAClB,IAAI,OAAO,QAAQ,YAAY,IAAI,KAAK,CAAC,CAAC,WAAW,GACnD,MAAM,IAAI,UAAU,8DAA8D;CAEpF,OAAO;EAAE;EAAM,KAAK,IAAI,KAAK;CAAE;AACjC;AAEA,SAAS,eAAe,KAA8B;CACpD,IAAI,QAAQ,QAAQ,OAAO,QAAQ,UACjC,MAAM,IAAI,UAAU,+CAA+C;CAErE,MAAM,QAAQ;CACd,MAAM,QAAQ,OAAO,MAAM,KAAK;CAChC,IAAI,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,KAAK,QAAQ,GAClD,MAAM,IAAI,WAAW,8DAA8D;CAErF,MAAM,QAAQ,MAAM;CACpB,IAAI,OAAO,UAAU,UACnB,MAAM,IAAI,UAAU,oDAAoD;CAE1E,MAAM,SAAyB;EAAE;EAAO;CAAM;CAC9C,MAAM,QAAQ,MAAM;CACpB,IAAI,UAAU,KAAA,GAAW;EACvB,IAAI,UAAU,UAAU,UAAU,SAAS,UAAU,aAAa,UAAU,SAC1E,MAAM,IAAI,UACR,+FACF;EAEF,OAAO,QAAQ;CACjB;CACA,OAAO;AACT;;AAWA,SAAgB,8BACd,SACmD;CACnD,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,MAAM,QAAQ,+BAAc,IAAI,KAAK,EAAA,CAAE,YAAY;CACzD,OAAO,OAAO,QAAQ;EACpB,MAAM,OAAO,6BAA6B,GAAG;EAC7C,MAAM,KAAK,WAAW;EACtB,MAAM,QAAQ;GACZ;GACA,UAAU,KAAK;GACf,QAAQ,KAAK;GACb,IAAI,KAAK;GACT,YAAY,KAAK,cAAc,IAAI;GACnC,WAAW,KAAK;EAClB;EACA,MAAM,QAAQ,MAAM,IAAI,KAAK;EAC7B,IAAI,KAAK,SAAS,SAAS,cACzB,QAAQ,MAAM,eAAe,KAAK,SAAS,KAAK,gBAAgB,KAAK,CAAC;EAExE,OAAO;GAAE,UAAU;GAAM;EAAG;CAC9B;AACF;AAEA,SAAS,mBAA2B;CAGlC,OAAO,OAFG,KAAK,IAAI,CAAC,CAAC,SAAS,EAEhB,EAAE,GADN,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,EAC3B;AACrB;;;;;;;;ACjKA,MAAa,qBAAqB;CAAC;CAAS;CAAc;AAAY;;;;ACRtE,MAAa,+BAA+B;;AAG5C,MAAa,iCAAiC;CAC5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,6DAA6D,mBAC1D,KAAK,YAAY,IAAI,QAAQ,EAAE,CAAC,CAChC,KAAK,KAAK,EAAE;CACf;CACA;AACF,CAAC,CAAC,KAAK,IAAI;;AAGX,MAAa,kCAAkC;CAC7C,MAAM;CACN,YAAY;EACV,WAAW,EAAE,MAAM,SAAS;EAC5B,SAAS;GAAE,MAAM;GAAU,MAAM;EAAmB;EACpD,OAAO;GAAE,MAAM;GAAU,aAAa;EAAgD;EACtF,OAAO;GAAE,MAAM;GAAW,SAAS;GAAG,SAAS;EAAI;CACrD;CACA,sBAAsB;AACxB;;AAGA,SAAgB,8BAA8B,KAAqC;CACjF,IAAI,QAAQ,KAAA,KAAa,QAAQ,MAAM,OAAO,CAAC;CAC/C,IAAI,OAAO,QAAQ,UACjB,MAAM,IAAI,UAAU,iDAAiD;CAEvE,MAAM,QAAQ;CACd,MAAM,MAA6B,CAAC;CACpC,IAAI,MAAM,cAAc,KAAA,GAAW;EACjC,IAAI,OAAO,MAAM,cAAc,UAC7B,MAAM,IAAI,UAAU,kDAAkD;EAExE,IAAI,YAAY,MAAM;CACxB;CACA,IAAI,MAAM,YAAY,KAAA,GAAW;EAC/B,IAAI,CAAC,mBAAmB,SAAS,MAAM,OAA4B,GACjE,MAAM,IAAI,UACR,kDAAkD,mBAAmB,KAAK,IAAI,GAChF;EAEF,IAAI,UAAU,MAAM;CACtB;CACA,IAAI,MAAM,UAAU,KAAA,GAAW;EAC7B,IAAI,OAAO,MAAM,UAAU,YAAY,OAAO,MAAM,KAAK,MAAM,MAAM,KAAK,CAAC,GACzE,MAAM,IAAI,UAAU,qDAAqD;EAE3E,IAAI,QAAQ,MAAM;CACpB;CACA,IAAI,MAAM,UAAU,KAAA,GAAW;EAC7B,MAAM,IAAI,OAAO,MAAM,KAAK;EAC5B,IAAI,CAAC,OAAO,SAAS,CAAC,KAAK,IAAI,KAAK,IAAI,KACtC,MAAM,IAAI,WAAW,4DAA4D;EAEnF,IAAI,QAAQ,KAAK,MAAM,CAAC;CAC1B;CACA,OAAO;AACT;;AAQA,SAAgB,+BACd,SACoD;CACpD,OAAO,OAAO,QAAQ;EACpB,MAAM,OAAO,8BAA8B,GAAG;EAC9C,OAAO,EAAE,aAAa,QAAQ,MAAM,QAAQ,IAAI,EAAE;CACpD;AACF;;;;;;;;;;;AC1FA,MAAa,8BAA8B;;AAG3C,MAAa,gCAAgC;CAC3C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC,CAAC,KAAK,IAAI;;AAGX,MAAa,iCAAiC;CAC5C,MAAM;CACN,YAAY;EACV,QAAQ;GAAE,MAAM;GAAU,aAAa;EAAiC;EACxE,cAAc;GACZ,MAAM;GACN,aACE;EACJ;CACF;CACA,UAAU,CAAC,QAAQ;CACnB,sBAAsB;AACxB;;AAGA,SAAgB,6BAA6B,KAAoC;CAC/E,IAAI,QAAQ,QAAQ,OAAO,QAAQ,UACjC,MAAM,IAAI,UAAU,gDAAgD;CAEtE,MAAM,QAAQ;CACd,MAAM,SAAS,MAAM;CACrB,IAAI,OAAO,WAAW,YAAY,OAAO,KAAK,CAAC,CAAC,WAAW,GACzD,MAAM,IAAI,UAAU,wDAAwD;CAE9E,MAAM,MAA4B,EAAE,QAAQ,OAAO,KAAK,EAAE;CAC1D,IAAI,MAAM,iBAAiB,KAAA,GAAW;EACpC,IAAI,OAAO,MAAM,iBAAiB,WAChC,MAAM,IAAI,UAAU,qDAAqD;EAE3E,IAAI,eAAe,MAAM;CAC3B;CACA,OAAO;AACT;;AAQA,SAAgB,8BACd,SACmD;CACnD,OAAO,OAAO,QAAQ;EACpB,MAAM,OAAO,6BAA6B,GAAG;EAC7C,MAAM,SAAS,QAAQ,MAAM,OAC3B,KAAK,QACL,KAAK,iBAAiB,KAAA,IAAY,EAAE,cAAc,KAAK,aAAa,IAAI,KAAA,CAC1E;EACA,IAAI,CAAC,QACH,MAAM,IAAI,cAAc,sCAAsC,KAAK,OAAO,EAAE;EAE9E,OAAO;CACT;AACF"}