@orkestrel/agent 0.0.32 → 0.0.33

package/dist/src/core/index.d.cts

@@ -691,7 +691,7 @@ export declare interface AgentInterface {
  */
 export declare class AgentJobError extends Error {
     /** Names the machine-readable condition — `'PARTIAL'`: a job that ended partial under a disallowing policy. */
-    readonly code: "PARTIAL";
+    readonly code: 'PARTIAL';
     /** Holds the partial {@link AgentResult} the cancelled job produced. */
     readonly partial: AgentResult;
     constructor(message: string, partial: AgentResult);
@@ -1543,7 +1543,7 @@ export declare interface AgentTurn {
     readonly usage: TokenUsage | undefined;
     readonly spent: TokenUsage | undefined;
     readonly messages: readonly Message[];
-    readonly ending: 'answer' | 'tools' | 'cancel';
+    readonly outcome: 'answer' | 'tools' | 'cancel';
     readonly partial: boolean;
     readonly futile: boolean;
     readonly estimate: number | undefined;
@@ -4616,7 +4616,7 @@ export declare interface GaugeInterface extends LedgerGauge {
  * `'CAPACITY'` otherwise. `replay` names the thinking the next request carries. Default: `'none'`.
  * Measured use is `prompt + completion - (thinking ?? 0)` for `'none'`, and `prompt + completion`
  * otherwise; absent completion counts as 0. Without prompt usage, use is `overhead + scale * estimate`.
- * Capacity left is `max(0, capacity - used)`. The reply reserve adds recall framing at the marginal
+ * Capacity left is `max(0, capacity - used)`. The reply reserve adds recall uniform at the marginal
  * rate to the largest observed reply's `completion - (thinking ?? 0)` for every policy.
  * Without a positive reply observation, it prices the longest reply text at that rate. Recall room is
  * `max(0, (remainder - predict - reserve) / 2 / rate)`; recall closes at `remainder - predict < 2 * reserve`.
@@ -5008,7 +5008,7 @@ export declare function intersectKeys(parent: readonly string[] | undefined, chi
 export declare const INVALID_RELAY_STATUS = 400;
 
 /**
- * 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)
@@ -5026,7 +5026,7 @@ export declare const INVALID_RELAY_STATUS = 400;
 export declare function isAgentError(value: unknown): value is AgentError;
 
 /**
- * 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)
@@ -5044,7 +5044,7 @@ export declare function isAgentError(value: unknown): value is AgentError;
 export declare function isAgentJobError(value: unknown): value is AgentJobError;
 
 /**
- * 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)
@@ -5106,7 +5106,7 @@ export declare function isConversationSnapshot(value: unknown): value is Convers
 export declare function isFraction(value: unknown): value is number;
 
 /**
- * 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
@@ -5138,7 +5138,7 @@ export declare function isJudgeAbortError(value: unknown): value is JudgeAbortEr
 export declare function isJudgeEntry(value: unknown): value is JudgeEntry;
 
 /**
- * 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
@@ -5191,7 +5191,7 @@ export declare function isJudgeQuestion(value: unknown): value is JudgeQuestion;
 export declare function isJudgment(value: unknown): value is Judgment;
 
 /**
- * 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)
@@ -5258,7 +5258,7 @@ export declare function isNonNegativeSafeInteger(value: unknown): value is numbe
 export declare function isPositiveSafeInteger(value: unknown): value is number;
 
 /**
- * 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)
@@ -5276,7 +5276,7 @@ export declare function isPositiveSafeInteger(value: unknown): value is number;
 export declare function isProviderAbortError(value: unknown): value is ProviderAbortError;
 
 /**
- * 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
@@ -5388,7 +5388,7 @@ export declare function joinThinking(running: string | undefined, next: string):
  */
 export declare class JudgeAbortError extends Error {
     /** Names the machine-readable condition — `'ABORT'`: a judge call cancelled mid-flight. */
-    readonly code: "ABORT";
+    readonly code: 'ABORT';
     readonly partial: JudgeResult;
     constructor(partial: JudgeResult, options?: ErrorOptions);
 }
@@ -5970,7 +5970,7 @@ export declare interface LedgerOwner {
 }
 
 /** Names a briefing source's planning group: a topic match, an off-topic rule or correction, or a name match. */
-export declare type LedgerPlanningGroup = 1 | 2 | 3;
+export declare type LedgerPlanGroup = 1 | 2 | 3;
 
 /**
  * Carries the records projected from a conversation, accepted amendments, and the live messages no
@@ -6457,7 +6457,7 @@ export declare const MAX_ERROR_BODY_LENGTH = 2048;
  * @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
@@ -6469,7 +6469,7 @@ export declare const MAX_ERROR_BODY_LENGTH = 2048;
  * @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 }
  * ```
  */
 export declare function measureMessage(message: Message): MessageMeasure;
@@ -6493,7 +6493,7 @@ export declare function measureMessage(message: Message): MessageMeasure;
  * @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 }
  * ```
  */
 export declare function measureRequest(request: ProviderRequest): RequestMeasure;
@@ -6620,7 +6620,7 @@ export declare const MESSAGE_TOKEN_OVERHEAD = 4;
 /** Validates and projects conversation messages at a JSON wire boundary. */
 export declare const messageContract: ContractInterface<Readonly<{
 id: string;
-role: "system" | "user" | "assistant" | "tool";
+role: "assistant" | "system" | "tool" | "user";
 content: string;
 } & {
 calls?: readonly Readonly<{
@@ -6718,7 +6718,7 @@ export declare interface MessageManagerInterface {
  *
  * @remarks
  * The structural estimate is not a tokenizer allocation. `id` and `role` are joins back to the
- * message, not token components. A message's estimate is the sum of `content`, `framing`, `calls`,
+ * message, not token components. A message's estimate is the sum of `content`, `uniform`, `calls`,
  * `thinking`, and `images`; no total is stored. A provider's template effects and the estimation
  * error are not individually attributed.
  */
@@ -6727,9 +6727,9 @@ export declare interface MessageMeasure {
     readonly role: MessageRole;
     /** Holds the `ceil(length / 4)` estimate of the message `content`. */
     readonly content: number;
-    /** Holds the fixed per-message framing overhead. */
-    readonly framing: number;
-    /** Holds the estimate of the JSON-rendered `calls`, or the framing overhead when they cannot be rendered; `0` when the message carries none. */
+    /** Holds the fixed per-message uniform overhead. */
+    readonly uniform: number;
+    /** Holds the estimate of the JSON-rendered `calls`, or the uniform overhead when they cannot be rendered; `0` when the message carries none. */
     readonly calls: number;
     /** Holds the estimate of the message `thinking`; `0` when absent. */
     readonly thinking: number;
@@ -6854,7 +6854,7 @@ export declare function placeMember(input: LedgerProjectionInput, links: Readonl
  */
 export declare class ProviderAbortError extends Error {
     /** Names the machine-readable condition — `'ABORT'`: a stream cancelled mid-flight. */
-    readonly code: "ABORT";
+    readonly code: 'ABORT';
     readonly partial: ProviderResult;
     constructor(partial: ProviderResult, options?: ErrorOptions);
 }
@@ -7015,7 +7015,7 @@ export declare interface ProviderRequest {
 export declare const providerRequestContract: ContractInterface<Readonly<{
 messages: readonly Readonly<{
 id: string;
-role: "system" | "user" | "assistant" | "tool";
+role: "assistant" | "system" | "tool" | "user";
 content: string;
 } & {
 calls?: readonly Readonly<{
@@ -7230,7 +7230,7 @@ export declare function raceSignal<T>(promise: Promise<T>, signal: AbortSignal |
  * rankLedgerCut(2, false, 'rule') // 3
  * ```
  */
-export declare function rankLedgerCut(group: LedgerPlanningGroup, unsettled: boolean, category: LedgerCategory | undefined): number;
+export declare function rankLedgerCut(group: LedgerPlanGroup, unsettled: boolean, category: LedgerCategory | undefined): number;
 
 /**
  * Decodes UTF-8 chunks with a final flush and releases the stream on every exit.

package/dist/src/core/index.d.ts

@@ -691,7 +691,7 @@ export declare interface AgentInterface {
  */
 export declare class AgentJobError extends Error {
     /** Names the machine-readable condition — `'PARTIAL'`: a job that ended partial under a disallowing policy. */
-    readonly code: "PARTIAL";
+    readonly code: 'PARTIAL';
     /** Holds the partial {@link AgentResult} the cancelled job produced. */
     readonly partial: AgentResult;
     constructor(message: string, partial: AgentResult);
@@ -1543,7 +1543,7 @@ export declare interface AgentTurn {
     readonly usage: TokenUsage | undefined;
     readonly spent: TokenUsage | undefined;
     readonly messages: readonly Message[];
-    readonly ending: 'answer' | 'tools' | 'cancel';
+    readonly outcome: 'answer' | 'tools' | 'cancel';
     readonly partial: boolean;
     readonly futile: boolean;
     readonly estimate: number | undefined;
@@ -4616,7 +4616,7 @@ export declare interface GaugeInterface extends LedgerGauge {
  * `'CAPACITY'` otherwise. `replay` names the thinking the next request carries. Default: `'none'`.
  * Measured use is `prompt + completion - (thinking ?? 0)` for `'none'`, and `prompt + completion`
  * otherwise; absent completion counts as 0. Without prompt usage, use is `overhead + scale * estimate`.
- * Capacity left is `max(0, capacity - used)`. The reply reserve adds recall framing at the marginal
+ * Capacity left is `max(0, capacity - used)`. The reply reserve adds recall uniform at the marginal
  * rate to the largest observed reply's `completion - (thinking ?? 0)` for every policy.
  * Without a positive reply observation, it prices the longest reply text at that rate. Recall room is
  * `max(0, (remainder - predict - reserve) / 2 / rate)`; recall closes at `remainder - predict < 2 * reserve`.
@@ -5008,7 +5008,7 @@ export declare function intersectKeys(parent: readonly string[] | undefined, chi
 export declare const INVALID_RELAY_STATUS = 400;
 
 /**
- * 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)
@@ -5026,7 +5026,7 @@ export declare const INVALID_RELAY_STATUS = 400;
 export declare function isAgentError(value: unknown): value is AgentError;
 
 /**
- * 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)
@@ -5044,7 +5044,7 @@ export declare function isAgentError(value: unknown): value is AgentError;
 export declare function isAgentJobError(value: unknown): value is AgentJobError;
 
 /**
- * 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)
@@ -5106,7 +5106,7 @@ export declare function isConversationSnapshot(value: unknown): value is Convers
 export declare function isFraction(value: unknown): value is number;
 
 /**
- * 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
@@ -5138,7 +5138,7 @@ export declare function isJudgeAbortError(value: unknown): value is JudgeAbortEr
 export declare function isJudgeEntry(value: unknown): value is JudgeEntry;
 
 /**
- * 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
@@ -5191,7 +5191,7 @@ export declare function isJudgeQuestion(value: unknown): value is JudgeQuestion;
 export declare function isJudgment(value: unknown): value is Judgment;
 
 /**
- * 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)
@@ -5258,7 +5258,7 @@ export declare function isNonNegativeSafeInteger(value: unknown): value is numbe
 export declare function isPositiveSafeInteger(value: unknown): value is number;
 
 /**
- * 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)
@@ -5276,7 +5276,7 @@ export declare function isPositiveSafeInteger(value: unknown): value is number;
 export declare function isProviderAbortError(value: unknown): value is ProviderAbortError;
 
 /**
- * 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
@@ -5388,7 +5388,7 @@ export declare function joinThinking(running: string | undefined, next: string):
  */
 export declare class JudgeAbortError extends Error {
     /** Names the machine-readable condition — `'ABORT'`: a judge call cancelled mid-flight. */
-    readonly code: "ABORT";
+    readonly code: 'ABORT';
     readonly partial: JudgeResult;
     constructor(partial: JudgeResult, options?: ErrorOptions);
 }
@@ -5970,7 +5970,7 @@ export declare interface LedgerOwner {
 }
 
 /** Names a briefing source's planning group: a topic match, an off-topic rule or correction, or a name match. */
-export declare type LedgerPlanningGroup = 1 | 2 | 3;
+export declare type LedgerPlanGroup = 1 | 2 | 3;
 
 /**
  * Carries the records projected from a conversation, accepted amendments, and the live messages no
@@ -6457,7 +6457,7 @@ export declare const MAX_ERROR_BODY_LENGTH = 2048;
  * @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
@@ -6469,7 +6469,7 @@ export declare const MAX_ERROR_BODY_LENGTH = 2048;
  * @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 }
  * ```
  */
 export declare function measureMessage(message: Message): MessageMeasure;
@@ -6493,7 +6493,7 @@ export declare function measureMessage(message: Message): MessageMeasure;
  * @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 }
  * ```
  */
 export declare function measureRequest(request: ProviderRequest): RequestMeasure;
@@ -6620,7 +6620,7 @@ export declare const MESSAGE_TOKEN_OVERHEAD = 4;
 /** Validates and projects conversation messages at a JSON wire boundary. */
 export declare const messageContract: ContractInterface<Readonly<{
 id: string;
-role: "system" | "user" | "assistant" | "tool";
+role: "assistant" | "system" | "tool" | "user";
 content: string;
 } & {
 calls?: readonly Readonly<{
@@ -6718,7 +6718,7 @@ export declare interface MessageManagerInterface {
  *
  * @remarks
  * The structural estimate is not a tokenizer allocation. `id` and `role` are joins back to the
- * message, not token components. A message's estimate is the sum of `content`, `framing`, `calls`,
+ * message, not token components. A message's estimate is the sum of `content`, `uniform`, `calls`,
  * `thinking`, and `images`; no total is stored. A provider's template effects and the estimation
  * error are not individually attributed.
  */
@@ -6727,9 +6727,9 @@ export declare interface MessageMeasure {
     readonly role: MessageRole;
     /** Holds the `ceil(length / 4)` estimate of the message `content`. */
     readonly content: number;
-    /** Holds the fixed per-message framing overhead. */
-    readonly framing: number;
-    /** Holds the estimate of the JSON-rendered `calls`, or the framing overhead when they cannot be rendered; `0` when the message carries none. */
+    /** Holds the fixed per-message uniform overhead. */
+    readonly uniform: number;
+    /** Holds the estimate of the JSON-rendered `calls`, or the uniform overhead when they cannot be rendered; `0` when the message carries none. */
     readonly calls: number;
     /** Holds the estimate of the message `thinking`; `0` when absent. */
     readonly thinking: number;
@@ -6854,7 +6854,7 @@ export declare function placeMember(input: LedgerProjectionInput, links: Readonl
  */
 export declare class ProviderAbortError extends Error {
     /** Names the machine-readable condition — `'ABORT'`: a stream cancelled mid-flight. */
-    readonly code: "ABORT";
+    readonly code: 'ABORT';
     readonly partial: ProviderResult;
     constructor(partial: ProviderResult, options?: ErrorOptions);
 }
@@ -7015,7 +7015,7 @@ export declare interface ProviderRequest {
 export declare const providerRequestContract: ContractInterface<Readonly<{
 messages: readonly Readonly<{
 id: string;
-role: "system" | "user" | "assistant" | "tool";
+role: "assistant" | "system" | "tool" | "user";
 content: string;
 } & {
 calls?: readonly Readonly<{
@@ -7230,7 +7230,7 @@ export declare function raceSignal<T>(promise: Promise<T>, signal: AbortSignal |
  * rankLedgerCut(2, false, 'rule') // 3
  * ```
  */
-export declare function rankLedgerCut(group: LedgerPlanningGroup, unsettled: boolean, category: LedgerCategory | undefined): number;
+export declare function rankLedgerCut(group: LedgerPlanGroup, unsettled: boolean, category: LedgerCategory | undefined): number;
 
 /**
  * Decodes UTF-8 chunks with a final flush and releases the stream on every exit.