@orkestrel/agent 0.0.32 → 0.0.34

package/dist/src/core/index.js

@@ -1,12 +1,12 @@
-import { ContractError, arrayOf, arrayShape, attempt, booleanShape, boundsOf, canonicalStringify, cloneJSONValue, createContract, isArray, isBoolean, isError, isFiniteNumber, isInstance, isJSONValue, isNumber, isObject, isRecord, isString, jsonShape, literalShape, nullableOf, numberShape, objectOf, objectShape, optionalOf, optionalShape, parseJSON, parseJSONAs, parseJSONValue, preview, rawShape, recordOf, recordShape, stringShape, unionShape } from "@orkestrel/contract";
+import { ContractError, INTRINSICS, arrayOf, arrayShape, attempt, booleanShape, boundsOf, canonicalStringify, cloneJSONValue, createContract, errorToMessage, holds, isArray, isBoolean, isError, isFiniteNumber, isFunction, isJSONValue, isNumber, isObject, isRecord, isString, jsonShape, literalShape, nullableOf, numberShape, objectOf, objectShape, optionalOf, optionalShape, parseJSON, parseJSONAs, parseJSONValue, preview, rawShape, recordOf, recordShape, stringShape, unionShape } from "@orkestrel/contract";
 import { createTokenBudget, createTokenMeter, isBudget, isBudgetError, isTokenUsage } from "@orkestrel/budget";
 import { Timeout, createTimeout } from "@orkestrel/timeout";
 import { createDatabase, createMemoryDriver } from "@orkestrel/database";
 import { Emitter } from "@orkestrel/emitter";
 import { ToolManager, createTool, createToolManager, isToolCall } from "@orkestrel/tool";
-import { WorkspaceManager, isBinary, isText } from "@orkestrel/workspace";
+import { WorkspaceManager, isBinary, isTextContent } from "@orkestrel/workspace";
 import { createQueue } from "@orkestrel/queue";
-import { createRunner, errorToMessage } from "@orkestrel/workflow";
+import { createRunner } from "@orkestrel/workflow";
 import { createAbort } from "@orkestrel/abort";
 // src/core/constants.ts
 /**
@@ -39,11 +39,12 @@ var JudgeAbortError = class extends Error {
 	constructor(partial, options) {
 		super("judge call aborted", options);
 		this.name = "JudgeAbortError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.JudgeAbortError"), { value: this });
 		this.partial = partial;
 	}
 };
 /**
-* Narrows a caught value to a {@link JudgeAbortError} through `instanceof`, so a `catch` can
+* Narrows a caught value to a {@link JudgeAbortError} through its identity brand and declared members, so a `catch` can
 * recover its `partial` result.
 *
 * @param value - The caught value
@@ -54,7 +55,27 @@ var JudgeAbortError = class extends Error {
 * ```
 */
 function isJudgeAbortError(value) {
-	return isInstance(value, JudgeAbortError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.JudgeAbortError"))?.value === value)) return false;
+		if (!(INTRINSICS.reflect.read(value, "code") === "ABORT")) return false;
+		const partial = INTRINSICS.reflect.read(value, "partial");
+		if (!(isObject(partial) || isFunction(partial))) return false;
+		const answers = INTRINSICS.reflect.read(partial, "answers");
+		const refusals = INTRINSICS.reflect.read(partial, "refusals");
+		const usage = INTRINSICS.reflect.read(partial, "usage");
+		return isString(INTRINSICS.reflect.read(partial, "model")) && (usage === void 0 || (isObject(usage) || isFunction(usage)) && [
+			"prompt",
+			"completion",
+			"total"
+		].every((key) => isNumber(INTRINSICS.reflect.read(usage, key)))) && (isObject(answers) || isFunction(answers)) && INTRINSICS.values(answers).every((answer) => {
+			if (!(isObject(answer) || isFunction(answer))) return false;
+			const form = INTRINSICS.reflect.read(answer, "form");
+			if (form === "noul") return isNumber(INTRINSICS.reflect.read(answer, "noul"));
+			const probabilities = INTRINSICS.reflect.read(answer, "probabilities");
+			if (form === "score") return arrayOf(isNumber)(probabilities);
+			return form === "choice" && (isObject(probabilities) || isFunction(probabilities)) && INTRINSICS.values(probabilities).every(isNumber);
+		}) && (refusals === void 0 || (isObject(refusals) || isFunction(refusals)) && INTRINSICS.values(refusals).every((refusal) => (isObject(refusal) || isFunction(refusal)) && arrayOf(isString)(INTRINSICS.reflect.read(refusal, "missing"))));
+	});
 }
 // src/core/shapers.ts
 /**
@@ -614,11 +635,12 @@ var ProviderAbortError = class extends Error {
 	constructor(partial, options) {
 		super("provider stream aborted", options);
 		this.name = "ProviderAbortError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.ProviderAbortError"), { value: this });
 		this.partial = partial;
 	}
 };
 /**
-* Narrows an unknown caught value to a {@link ProviderAbortError} through `instanceof`, so a
+* Narrows an unknown caught value to a {@link ProviderAbortError} through its identity brand and declared members, so a
 * `catch` can recover its `partial` result.
 *
 * @param value - The value to test (typically a `catch` binding)
@@ -634,7 +656,19 @@ var ProviderAbortError = class extends Error {
 * ```
 */
 function isProviderAbortError(value) {
-	return isInstance(value, ProviderAbortError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.ProviderAbortError"))?.value === value)) return false;
+		if (!(INTRINSICS.reflect.read(value, "code") === "ABORT")) return false;
+		const partial = INTRINSICS.reflect.read(value, "partial");
+		if (!(isObject(partial) || isFunction(partial))) return false;
+		const usage = INTRINSICS.reflect.read(partial, "usage");
+		const tools = INTRINSICS.reflect.read(partial, "tools");
+		return isString(INTRINSICS.reflect.read(partial, "content")) && (INTRINSICS.reflect.read(partial, "thinking") === void 0 || isString(INTRINSICS.reflect.read(partial, "thinking"))) && (INTRINSICS.reflect.read(partial, "truncated") === void 0 || isBoolean(INTRINSICS.reflect.read(partial, "truncated"))) && (usage === void 0 || (isObject(usage) || isFunction(usage)) && [
+			"prompt",
+			"completion",
+			"total"
+		].every((key) => isNumber(INTRINSICS.reflect.read(usage, key)))) && (tools === void 0 || arrayOf((tool) => (isObject(tool) || isFunction(tool)) && isString(INTRINSICS.reflect.read(tool, "id")) && isString(INTRINSICS.reflect.read(tool, "name")) && (isObject(INTRINSICS.reflect.read(tool, "arguments")) || isFunction(INTRINSICS.reflect.read(tool, "arguments"))))(tools));
+	});
 }
 /**
 * Reports a coded provider failure with its HTTP status and underlying cause when available.
@@ -653,12 +687,13 @@ var ProviderError = class extends Error {
 	constructor(code, message, options) {
 		super(message, options);
 		this.name = "ProviderError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.ProviderError"), { value: this });
 		this.code = code;
 		this.status = options?.status;
 	}
 };
 /**
-* Narrows a caught value to the provider failure class through `instanceof`.
+* Narrows a caught value to the provider failure class through its identity brand and declared members.
 *
 * @param value - The caught value
 * @returns True if the value is a provider failure; false otherwise
@@ -668,7 +703,13 @@ var ProviderError = class extends Error {
 * ```
 */
 function isProviderError(value) {
-	return isInstance(value, ProviderError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.ProviderError"))?.value === value)) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (!(code === "HTTP" || code === "PROTOCOL" || code === "PROVIDER")) return false;
+		const status = INTRINSICS.reflect.read(value, "status");
+		return status === void 0 || isNumber(status);
+	});
 }
 /**
 * Reports a coded judge failure with its HTTP status and underlying cause when available.
@@ -687,12 +728,13 @@ var JudgeError = class extends Error {
 	constructor(code, message, options) {
 		super(message, options);
 		this.name = "JudgeError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.JudgeError"), { value: this });
 		this.code = code;
 		this.status = options?.status;
 	}
 };
 /**
-* Narrows a caught value to the judge failure class through `instanceof`.
+* Narrows a caught value to the judge failure class through its identity brand and declared members.
 *
 * @param value - The caught value
 * @returns True if the value is a {@link JudgeError}; false otherwise
@@ -702,7 +744,13 @@ var JudgeError = class extends Error {
 * ```
 */
 function isJudgeError(value) {
-	return isInstance(value, JudgeError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.JudgeError"))?.value === value)) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (!(code === "HTTP" || code === "PROTOCOL" || code === "QUESTION")) return false;
+		const status = INTRINSICS.reflect.read(value, "status");
+		return status === void 0 || isNumber(status);
+	});
 }
 // src/core/providers/shapers.ts
 /**
@@ -874,7 +922,7 @@ async function readFailure(response, prefix, signal) {
 			status
 		};
 	}
-	return readText(body, MAX_ERROR_BODY_LENGTH, signal).then((read) => {
+	return readBodyText(body, MAX_ERROR_BODY_LENGTH, signal).then((read) => {
 		signal.throwIfAborted();
 		return {
 			message: `${prefix} ${status}${read.text === "" ? "" : ` - ${read.text}`}`,
@@ -901,13 +949,13 @@ async function readFailure(response, prefix, signal) {
 * @returns The decoded prefix and whether EOF occurred within the byte budget
 * @example
 * ```ts
-* import { readText } from '@orkestrel/agent'
+* import { readBodyText } from '@orkestrel/agent'
 *
 * const body = new Response('answer').body
-* if (body !== null) await readText(body, 3) // { text: 'ans', complete: false }
+* if (body !== null) await readBodyText(body, 3) // { text: 'ans', complete: false }
 * ```
 */
-async function readText(body, limit, signal) {
+async function readBodyText(body, limit, signal) {
 	const reader = body.getReader();
 	const decoder = new TextDecoder();
 	try {
@@ -1931,7 +1979,7 @@ var AgentJudge = class {
 				throw new JudgeError("HTTP", message, options);
 			}
 			if (response.body === null) throw new JudgeError("PROTOCOL", "judge error: no response body");
-			const text = await readText(response.body, void 0, combined);
+			const text = await readBodyText(response.body, void 0, combined);
 			combined.throwIfAborted();
 			const value = parseJSON(text.text);
 			if (value === void 0) throw new JudgeError("PROTOCOL", "judge error: invalid JSON body");
@@ -2153,7 +2201,7 @@ function createRelay(options) {
 			return new Response(void 0, { status: 401 });
 		}
 		if (request.body === null) return new Response(void 0, { status: 400 });
-		const read = await readText(request.body, limit ?? 1048576, request.signal).catch(() => void 0);
+		const read = await readBodyText(request.body, limit ?? 1048576, request.signal).catch(() => void 0);
 		if (read === void 0) return new Response(void 0, { status: request.signal.aborted ? 413 : 400 });
 		if (!read.complete) return new Response(void 0, { status: 413 });
 		const parsed = parseJSONAs(read.text, providerRequestContract.is);
@@ -2328,12 +2376,13 @@ var ConversationError = class extends Error {
 	constructor(code, message, options) {
 		super(message, options?.cause === void 0 ? void 0 : { cause: options.cause });
 		this.name = "ConversationError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.ConversationError"), { value: this });
 		this.code = code;
 		this.context = options?.context;
 	}
 };
 /**
-* Narrows an unknown caught value to a {@link ConversationError} through `instanceof`, so a
+* Narrows an unknown caught value to a {@link ConversationError} through its identity brand and declared members, so a
 * `catch` can branch on its `code`.
 *
 * @param value - The value to test (typically a `catch` binding)
@@ -2349,7 +2398,13 @@ var ConversationError = class extends Error {
 * ```
 */
 function isConversationError(value) {
-	return isInstance(value, ConversationError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.ConversationError"))?.value === value)) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (!(code === "SUMMARIZER" || code === "SECTIONS" || code === "JUDGMENT" || code === "KEEP")) return false;
+		const context = INTRINSICS.reflect.read(value, "context");
+		return context === void 0 || isObject(context) || isFunction(context);
+	});
 }
 // src/core/conversations/validators.ts
 /**
@@ -4053,7 +4108,7 @@ var AgentContext = class {
 		const instructed = renderSection(this.#instructions.open, instructions, (one) => this.#instructions.render(one), this.#instructions.close);
 		if (instructed !== void 0) parts.push(instructed);
 		const files = filterAllowList(scope?.files, this.#workspaces.active?.files() ?? [], (one) => one.path);
-		const documented = renderSection(WORKSPACE_SECTION_HEADER, files.flatMap((file) => isText(file.content) ? [{
+		const documented = renderSection(WORKSPACE_SECTION_HEADER, files.flatMap((file) => isTextContent(file.content) ? [{
 			path: file.path,
 			language: file.content.language,
 			text: file.content.text
@@ -4284,11 +4339,12 @@ var AgentJobError = class extends Error {
 	constructor(message, partial) {
 		super(message);
 		this.name = "AgentJobError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.AgentJobError"), { value: this });
 		this.partial = partial;
 	}
 };
 /**
-* Narrows an unknown caught value to an {@link AgentJobError} through `instanceof`, so a
+* Narrows an unknown caught value to an {@link AgentJobError} through its identity brand and declared members, so a
 * `catch` can recover its `partial` result.
 *
 * @param value - The value to test (typically a `catch` binding or a rejected enqueue)
@@ -4304,7 +4360,30 @@ var AgentJobError = class extends Error {
 * ```
 */
 function isAgentJobError(value) {
-	return isInstance(value, AgentJobError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.AgentJobError"))?.value === value)) return false;
+		if (!(INTRINSICS.reflect.read(value, "code") === "PARTIAL")) return false;
+		const partial = INTRINSICS.reflect.read(value, "partial");
+		if (!(isObject(partial) || isFunction(partial))) return false;
+		const usage = INTRINSICS.reflect.read(partial, "usage");
+		const stop = INTRINSICS.reflect.read(partial, "stop");
+		if (stop !== void 0) {
+			if (!(isObject(stop) || isFunction(stop))) return false;
+			const layer = INTRINSICS.reflect.read(stop, "layer");
+			const spent = INTRINSICS.reflect.read(stop, "usage");
+			if (!isString(INTRINSICS.reflect.read(stop, "id")) || !(INTRINSICS.reflect.read(stop, "estimate") === void 0 || isNumber(INTRINSICS.reflect.read(stop, "estimate"))) || !(spent === void 0 || (isObject(spent) || isFunction(spent)) && [
+				"prompt",
+				"completion",
+				"total"
+			].every((key) => isNumber(INTRINSICS.reflect.read(spent, key))))) return false;
+			if (layer !== "model" && !((layer === "meter" || layer === "budget") && isNumber(INTRINSICS.reflect.read(stop, "max")) && isNumber(INTRINSICS.reflect.read(stop, "consumed")))) return false;
+		}
+		return isString(INTRINSICS.reflect.read(partial, "content")) && (INTRINSICS.reflect.read(partial, "thinking") === void 0 || isString(INTRINSICS.reflect.read(partial, "thinking"))) && isBoolean(INTRINSICS.reflect.read(partial, "partial")) && (usage === void 0 || (isObject(usage) || isFunction(usage)) && [
+			"prompt",
+			"completion",
+			"total"
+		].every((key) => isNumber(INTRINSICS.reflect.read(usage, key))));
+	});
 }
 /**
 * Reports a run sharing accounting with a live run, a `limit` that is not a nonnegative safe integer, a name absent from a registry pool, or a strict run whose request exceeds its window. Agent construction, the `stream` and `generate` methods, and registry accessors throw synchronously, before returning a handle or promise; a `'WINDOW'` refusal rejects the run's `result` instead. Await the call inside `try`/`catch` to catch it.
@@ -4340,12 +4419,13 @@ var AgentError = class extends Error {
 	constructor(code, message, options) {
 		super(message, options?.cause === void 0 ? void 0 : { cause: options.cause });
 		this.name = "AgentError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.AgentError"), { value: this });
 		this.code = code;
 		this.context = options?.context;
 	}
 };
 /**
-* Narrows an unknown caught value to an {@link AgentError} through `instanceof`, so a `catch`
+* Narrows an unknown caught value to an {@link AgentError} through its identity brand and declared members, so a `catch`
 * can branch on its `code`.
 *
 * @param value - The value to test (typically a `catch` binding)
@@ -4361,7 +4441,13 @@ var AgentError = class extends Error {
 * ```
 */
 function isAgentError(value) {
-	return isInstance(value, AgentError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.AgentError"))?.value === value)) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (!(code === "CONCURRENCY" || code === "LIMIT" || code === "REGISTRY" || code === "WINDOW")) return false;
+		const context = INTRINSICS.reflect.read(value, "context");
+		return context === void 0 || isObject(context) || isFunction(context);
+	});
 }
 // src/core/agents/Channel.ts
 /**
@@ -4660,7 +4746,7 @@ function estimateTokens(text) {
 function estimateMessages(messages) {
 	return messages.reduce((sum, message) => {
 		const measure = measureMessage(message);
-		return sum + measure.content + measure.framing + measure.calls + measure.thinking + measure.images;
+		return sum + measure.content + measure.uniform + measure.calls + measure.thinking + measure.images;
 	}, 0);
 }
 /**
@@ -4670,7 +4756,7 @@ function estimateMessages(messages) {
 * @remarks
 * The result is a structural estimate, not a tokenizer allocation. `id` and `role` are joins back to
 * the message, not token components, and a provider's template effects and the estimation error are
-* not individually attributed. `content` is `ceil(length / 4)`, `framing` is
+* not individually attributed. `content` is `ceil(length / 4)`, `uniform` is
 * {@link import('./constants.js').MESSAGE_TOKEN_OVERHEAD}, `calls` is the estimate of the JSON-rendered
 * calls (`0` when the message carries none, the framing overhead when they cannot be rendered),
 * `thinking` is the estimate of the thinking (`0` when absent), and `images` is the attached image
@@ -4682,7 +4768,7 @@ function estimateMessages(messages) {
 * @example
 * ```ts
 * measureMessage({ id: '1', role: 'user', content: 'hello' })
-* // { id: '1', role: 'user', content: 2, framing: 4, calls: 0, thinking: 0, images: 0 }
+* // { id: '1', role: 'user', content: 2, uniform: 4, calls: 0, thinking: 0, images: 0 }
 * ```
 */
 function measureMessage(message) {
@@ -4692,7 +4778,7 @@ function measureMessage(message) {
 		id: message.id,
 		role: message.role,
 		content: estimateTokens(message.content),
-		framing: 4,
+		uniform: 4,
 		calls,
 		thinking: message.thinking === void 0 ? 0 : estimateTokens(message.thinking),
 		images: (message.images?.length ?? 0) * 512
@@ -4724,7 +4810,7 @@ function measureMessage(message) {
 */
 function estimateRequest(request) {
 	const measure = measureRequest(request);
-	return measure.messages.reduce((sum, message) => sum + message.content + message.framing + message.calls + message.thinking + message.images, measure.tools + measure.schema);
+	return measure.messages.reduce((sum, message) => sum + message.content + message.uniform + message.calls + message.thinking + message.images, measure.tools + measure.schema);
 }
 /**
 * Measures the disjoint estimate components of a complete provider request — each message through
@@ -4745,7 +4831,7 @@ function estimateRequest(request) {
 * @example
 * ```ts
 * measureRequest({ messages: [{ id: '1', role: 'user', content: 'hello' }] })
-* // { messages: [{ id: '1', role: 'user', content: 2, framing: 4, calls: 0, thinking: 0, images: 0 }], tools: 0, schema: 0 }
+* // { messages: [{ id: '1', role: 'user', content: 2, uniform: 4, calls: 0, thinking: 0, images: 0 }], tools: 0, schema: 0 }
 * ```
 */
 function measureRequest(request) {
@@ -5196,7 +5282,7 @@ var Agent = class {
 		this.#window?.clear();
 		const cancelled = abort.signal.aborted;
 		const turns = [];
-		while (turns.length < limit && (turns.at(-1)?.ending ?? "tools") === "tools") {
+		while (turns.length < limit && (turns.at(-1)?.outcome ?? "tools") === "tools") {
 			const index = turns.length;
 			const base = turns.at(-1)?.messages ?? entry.messages;
 			const futile = turns.at(-1)?.futile ?? false;
@@ -5206,7 +5292,7 @@ var Agent = class {
 				usage: void 0,
 				spent: void 0,
 				messages: base,
-				ending: "cancel",
+				outcome: "cancel",
 				partial: true,
 				futile,
 				estimate: void 0,
@@ -5252,7 +5338,7 @@ var Agent = class {
 			if (!provided.success) {
 				turns.push({
 					...settled,
-					ending: "cancel",
+					outcome: "cancel",
 					partial: true
 				});
 				continue;
@@ -5274,7 +5360,7 @@ var Agent = class {
 				if (abort.signal.aborted) {
 					turns.push({
 						...settled,
-						ending: "cancel",
+						outcome: "cancel",
 						partial: true
 					});
 					continue;
@@ -5309,7 +5395,7 @@ var Agent = class {
 						assistant,
 						...replies
 					],
-					ending: "tools",
+					outcome: "tools",
 					partial: true
 				});
 				continue;
@@ -5322,7 +5408,7 @@ var Agent = class {
 			turns.push({
 				...settled,
 				content: result.content,
-				ending: "answer",
+				outcome: "answer",
 				partial: abort.signal.aborted,
 				truncated: result.truncated === true
 			});
@@ -5330,7 +5416,7 @@ var Agent = class {
 		const final = turns.at(-1);
 		const thinkings = turns.flatMap((turn) => turn.thinking === void 0 ? [] : [turn.thinking]);
 		return {
-			content: final?.ending === "answer" ? final.content : turns.map((turn) => turn.content).join(""),
+			content: final?.outcome === "answer" ? final.content : turns.map((turn) => turn.content).join(""),
 			thinking: thinkings.length === 0 ? void 0 : thinkings.join("\n\n"),
 			usage: [
 				...turns.map((turn) => turn.usage),
@@ -5338,7 +5424,7 @@ var Agent = class {
 				...turns.map((turn) => turn.spent)
 			].reduce((total, one) => one === void 0 ? total : sumUsage(total, one), void 0),
 			partial: final?.partial ?? cancelled,
-			exhausted: final?.ending === "tools" && !abort.signal.aborted,
+			exhausted: final?.outcome === "tools" && !abort.signal.aborted,
 			stop: inferStop(abort.signal.reason, allowance, budget, this.#provider.id, final)
 		};
 	}
@@ -6139,11 +6225,12 @@ var LedgerError = class extends Error {
 	constructor(code, message) {
 		super(message);
 		this.name = "LedgerError";
+		INTRINSICS.define(this, Symbol.for("@orkestrel/agent.LedgerError"), { value: this });
 		this.code = code;
 	}
 };
 /**
-* Narrows an unknown caught value to a {@link LedgerError} through `instanceof`, so a `catch` can
+* Narrows an unknown caught value to a {@link LedgerError} through its identity brand and declared members, so a `catch` can
 * branch on its `code`.
 *
 * @param value - The value to test (typically a `catch` binding)
@@ -6155,7 +6242,12 @@ var LedgerError = class extends Error {
 * ```
 */
 function isLedgerError(value) {
-	return isInstance(value, LedgerError);
+	return holds(() => {
+		if (!(value instanceof Error && INTRINSICS.prototype(value) !== Error.prototype && INTRINSICS.describe(value, Symbol.for("@orkestrel/agent.LedgerError"))?.value === value)) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (!(code === "REQUEST" || code === "THRESHOLD" || code === "SHARE" || code === "CAPACITY" || code === "LIMIT" || code === "TOPIC" || code === "LOOKUP" || code === "GAUGE" || code === "REFERENCE")) return false;
+		return true;
+	});
 }
 // src/core/ledgers/helpers.ts
 /**
@@ -8475,6 +8567,6 @@ var Ledger = class {
 function createLedger(provider, options) {
 	return new Ledger(provider, options);
 }
-export { Agent, AgentContext, AgentError, AgentFanout, AgentJobError, AgentJudge, AgentProvider, AgentRegistry, Authority, CONVERSATION_RECAP_PREFIX, Channel, Classifier, Conversation, ConversationError, ConversationManager, DECISIVE_CATEGORIES, DEFAULT_AGENT_LIMIT, DEFAULT_AUTHORITY_ZONE, DEFAULT_CONVERSATION_KEEP, DEFAULT_LEDGER_LIMIT, DEFAULT_LEDGER_SHARE, DEFAULT_PROVIDER_TIMEOUT, DEFAULT_RECALL_LIMIT, DEFAULT_RELAY_LIMIT, DETERMINISTIC_JUDGE_ERROR, DatabaseConversationStore, Gauge, IMAGE_TOKEN_ESTIMATE, INVALID_RELAY_STATUS, Instruction, InstructionManager, JudgeAbortError, JudgeError, JudgmentManager, LEDGER_CATEGORIES, LEDGER_NOTES, LEDGER_OWNER_PREFIX, LEDGER_QUESTIONS, LEDGER_RULES_KEY, LEDGER_SCALE_DRIFT, Ledger, LedgerError, LedgerRequest, MAX_ERROR_BODY_LENGTH, MESSAGE_ROLES, MESSAGE_TOKEN_OVERHEAD, MemoryConversationStore, OVERSIZED_RELAY_STATUS, PLACED_CATEGORIES, ProviderAbortError, ProviderError, QUIET_CATEGORIES, RELAY_CONTENT_TYPE, RELAY_PROVIDER_MESSAGE, RelayProvider, RelayStream, SYSTEM_ONE_PATH, Scope, ScopeManager, SystemOneJudge, THINK_CLOSE, THINK_OPEN, ThinkSplitter, UNAUTHORIZED_RELAY_STATUS, UPSTREAM_RELAY_STATUS, WORKSPACE_SECTION_HEADER, agentResultToJSON, armReaderAbort, assembleResult, attachImages, attachUserImages, buildJudgeResult, buildJudgments, buildLedgerRenderContext, buildLines, buildProviderHeaders, buildProviderResult, buildRecallMessage, buildRecapMessage, buildRecords, buildSummaryMessage, chargeUsage, collectAmendments, collectExchanges, collectImageData, collectLive, collectNames, collectProjectionIds, collectRegistry, collectToolGroups, computeReading, computeThinking, copyJSON, createAgent, createAgentContext, createAgentQueue, createAgentRegistry, createAgentRunner, createAuthority, createChannel, createConversation, createConversationManager, createDatabaseConversationStore, createInstruction, createInstructionManager, createLedger, createMemoryConversationStore, createRelay, createRelayProvider, createScope, createScopeManager, createSystemOneJudge, createThinkSplitter, cutListing, denyCall, estimateMessages, estimateRequest, estimateTokens, extractQueueOptions, extractSystemOneAnswer, extractSystemOneUsage, extractTokens, extractWords, filterAllowList, findLedgerCall, fitSlope, handleAgentQueueJob, hasCalls, identifyLookup, inferStop, intersectKeys, isAgentError, isAgentJobError, isConversationError, isConversationSnapshot, isFraction, isJudgeAbortError, isJudgeEntry, isJudgeError, isJudgeQuestion, isJudgment, isLedgerError, isMessage, isNonNegativeSafeInteger, isPositiveSafeInteger, isProviderAbortError, isProviderError, isSection, isSystemOneAnswer, isSystemOneResponse, joinThinking, linkOwners, matchEntities, matchesCutLine, matchesJudgment, measureMessage, measureRequest, messageContract, messageShape, normalizeArgument, placeMember, providerRequestContract, providerRequestShape, providerResultContract, providerResultShape, questionToSystemOne, raceSignal, rankLedgerCut, readChunks, readFailure, readText, relayFrameContract, relayFrameShape, releaseReader, removeEntries, renderCauseChain, renderFencedFile, renderJSON, renderLedgerAnnotation, renderLedgerPinned, renderLedgerRecord, renderLookupCall, renderSection, renderStub, renderToolValue, renderTopicNames, requestToRelay, requireBudget, requireEntry, requireJudgment, requireKeep, requireLimit, requireRolling, requireSectionsCap, resolvePredict, sanitizeToken, sanitizeUsage, scanAmendments, selectRecords, settleAgentJob, splitResultLines, splitSentences, splitTopic, splitWords, stripThinking, sumUsage, tokenUsageToJSON, toolCallShape };
+export { Agent, AgentContext, AgentError, AgentFanout, AgentJobError, AgentJudge, AgentProvider, AgentRegistry, Authority, CONVERSATION_RECAP_PREFIX, Channel, Classifier, Conversation, ConversationError, ConversationManager, DECISIVE_CATEGORIES, DEFAULT_AGENT_LIMIT, DEFAULT_AUTHORITY_ZONE, DEFAULT_CONVERSATION_KEEP, DEFAULT_LEDGER_LIMIT, DEFAULT_LEDGER_SHARE, DEFAULT_PROVIDER_TIMEOUT, DEFAULT_RECALL_LIMIT, DEFAULT_RELAY_LIMIT, DETERMINISTIC_JUDGE_ERROR, DatabaseConversationStore, Gauge, IMAGE_TOKEN_ESTIMATE, INVALID_RELAY_STATUS, Instruction, InstructionManager, JudgeAbortError, JudgeError, JudgmentManager, LEDGER_CATEGORIES, LEDGER_NOTES, LEDGER_OWNER_PREFIX, LEDGER_QUESTIONS, LEDGER_RULES_KEY, LEDGER_SCALE_DRIFT, Ledger, LedgerError, LedgerRequest, MAX_ERROR_BODY_LENGTH, MESSAGE_ROLES, MESSAGE_TOKEN_OVERHEAD, MemoryConversationStore, OVERSIZED_RELAY_STATUS, PLACED_CATEGORIES, ProviderAbortError, ProviderError, QUIET_CATEGORIES, RELAY_CONTENT_TYPE, RELAY_PROVIDER_MESSAGE, RelayProvider, RelayStream, SYSTEM_ONE_PATH, Scope, ScopeManager, SystemOneJudge, THINK_CLOSE, THINK_OPEN, ThinkSplitter, UNAUTHORIZED_RELAY_STATUS, UPSTREAM_RELAY_STATUS, WORKSPACE_SECTION_HEADER, agentResultToJSON, armReaderAbort, assembleResult, attachImages, attachUserImages, buildJudgeResult, buildJudgments, buildLedgerRenderContext, buildLines, buildProviderHeaders, buildProviderResult, buildRecallMessage, buildRecapMessage, buildRecords, buildSummaryMessage, chargeUsage, collectAmendments, collectExchanges, collectImageData, collectLive, collectNames, collectProjectionIds, collectRegistry, collectToolGroups, computeReading, computeThinking, copyJSON, createAgent, createAgentContext, createAgentQueue, createAgentRegistry, createAgentRunner, createAuthority, createChannel, createConversation, createConversationManager, createDatabaseConversationStore, createInstruction, createInstructionManager, createLedger, createMemoryConversationStore, createRelay, createRelayProvider, createScope, createScopeManager, createSystemOneJudge, createThinkSplitter, cutListing, denyCall, estimateMessages, estimateRequest, estimateTokens, extractQueueOptions, extractSystemOneAnswer, extractSystemOneUsage, extractTokens, extractWords, filterAllowList, findLedgerCall, fitSlope, handleAgentQueueJob, hasCalls, identifyLookup, inferStop, intersectKeys, isAgentError, isAgentJobError, isConversationError, isConversationSnapshot, isFraction, isJudgeAbortError, isJudgeEntry, isJudgeError, isJudgeQuestion, isJudgment, isLedgerError, isMessage, isNonNegativeSafeInteger, isPositiveSafeInteger, isProviderAbortError, isProviderError, isSection, isSystemOneAnswer, isSystemOneResponse, joinThinking, linkOwners, matchEntities, matchesCutLine, matchesJudgment, measureMessage, measureRequest, messageContract, messageShape, normalizeArgument, placeMember, providerRequestContract, providerRequestShape, providerResultContract, providerResultShape, questionToSystemOne, raceSignal, rankLedgerCut, readBodyText, readChunks, readFailure, relayFrameContract, relayFrameShape, releaseReader, removeEntries, renderCauseChain, renderFencedFile, renderJSON, renderLedgerAnnotation, renderLedgerPinned, renderLedgerRecord, renderLookupCall, renderSection, renderStub, renderToolValue, renderTopicNames, requestToRelay, requireBudget, requireEntry, requireJudgment, requireKeep, requireLimit, requireRolling, requireSectionsCap, resolvePredict, sanitizeToken, sanitizeUsage, scanAmendments, selectRecords, settleAgentJob, splitResultLines, splitSentences, splitTopic, splitWords, stripThinking, sumUsage, tokenUsageToJSON, toolCallShape };
 
 //# sourceMappingURL=index.js.map