@orkestrel/agent 0.0.32 → 0.0.33

package/dist/src/core/index.js

@@ -1,4 +1,4 @@
-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, 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";
@@ -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
 /**
@@ -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
 /**
@@ -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
 /**