@orkestrel/agent 0.0.32 → 0.0.34

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

@@ -318,7 +318,7 @@ export declare interface AgentContextInterface {
      * `workspaces.active` is set, its
      * {@link import('@orkestrel/workspace').WorkspaceInterface.files} are filtered by
      * `scope.files` (a three-way allow-list; `undefined` ⇒ all active files), then split by
-     * carrier: text files ({@link import('@orkestrel/workspace').isText}) render into a dedicated
+     * carrier: text files ({@link import('@orkestrel/workspace').isTextContent}) render into a dedicated
      * `## Workspace` section in the system block — each a fenced
      * `` File: <path>\n```<language>\n<text>\n``` `` block whose fence is one backtick longer than
      * the longest backtick run in the text, and never shorter than three — placed immediately after
@@ -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,30 @@ 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;
+
+/**
+ * Reads a UTF-8 prefix of a byte stream and cancels its remainder.
+ *
+ * @remarks
+ * The `limit` parameter bounds bytes passed to the decoder, including a partial final
+ * character. An omitted limit reads to completion. A source may deliver a chunk larger
+ * than the remaining limit; its unused bytes are discarded without decoding.
+ * The read can overshoot by one source chunk. An abort leaves completion false.
+ *
+ * @param body - The readable byte stream
+ * @param limit - The maximum byte prefix, or undefined for the complete stream
+ * @param signal - The optional cancellation bound; abort returns the decoded prefix
+ * @returns The decoded prefix and whether EOF occurred within the byte budget
+ * @example
+ * ```ts
+ * import { readBodyText } from '@orkestrel/agent'
+ *
+ * const body = new Response('answer').body
+ * if (body !== null) await readBodyText(body, 3) // { text: 'ans', complete: false }
+ * ```
+ */
+export declare function readBodyText(body: ReadableStream<Uint8Array>, limit?: number, signal?: AbortSignal): Promise<TextRead>;
 
 /**
  * Decodes UTF-8 chunks with a final flush and releases the stream on every exit.
@@ -7279,29 +7302,6 @@ export declare interface Reading {
     readonly score?: number;
 }
 
-/**
- * Reads a UTF-8 prefix of a byte stream and cancels its remainder.
- *
- * @remarks
- * The `limit` parameter bounds bytes passed to the decoder, including a partial final
- * character. An omitted limit reads to completion. A source may deliver a chunk larger
- * than the remaining limit; its unused bytes are discarded without decoding.
- * The read can overshoot by one source chunk. An abort leaves completion false.
- *
- * @param body - The readable byte stream
- * @param limit - The maximum byte prefix, or undefined for the complete stream
- * @param signal - The optional cancellation bound; abort returns the decoded prefix
- * @returns The decoded prefix and whether EOF occurred within the byte budget
- * @example
- * ```ts
- * import { readText } from '@orkestrel/agent'
- *
- * const body = new Response('answer').body
- * if (body !== null) await readText(body, 3) // { text: 'ans', complete: false }
- * ```
- */
-export declare function readText(body: ReadableStream<Uint8Array>, limit?: number, signal?: AbortSignal): Promise<TextRead>;
-
 /** Reports a question a wire could not read a candidate for; it lists the caller's keys and invents no probability. */
 export declare interface Refusal {
     readonly missing: readonly string[];

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

@@ -318,7 +318,7 @@ export declare interface AgentContextInterface {
      * `workspaces.active` is set, its
      * {@link import('@orkestrel/workspace').WorkspaceInterface.files} are filtered by
      * `scope.files` (a three-way allow-list; `undefined` ⇒ all active files), then split by
-     * carrier: text files ({@link import('@orkestrel/workspace').isText}) render into a dedicated
+     * carrier: text files ({@link import('@orkestrel/workspace').isTextContent}) render into a dedicated
      * `## Workspace` section in the system block — each a fenced
      * `` File: <path>\n```<language>\n<text>\n``` `` block whose fence is one backtick longer than
      * the longest backtick run in the text, and never shorter than three — placed immediately after
@@ -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,30 @@ 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;
+
+/**
+ * Reads a UTF-8 prefix of a byte stream and cancels its remainder.
+ *
+ * @remarks
+ * The `limit` parameter bounds bytes passed to the decoder, including a partial final
+ * character. An omitted limit reads to completion. A source may deliver a chunk larger
+ * than the remaining limit; its unused bytes are discarded without decoding.
+ * The read can overshoot by one source chunk. An abort leaves completion false.
+ *
+ * @param body - The readable byte stream
+ * @param limit - The maximum byte prefix, or undefined for the complete stream
+ * @param signal - The optional cancellation bound; abort returns the decoded prefix
+ * @returns The decoded prefix and whether EOF occurred within the byte budget
+ * @example
+ * ```ts
+ * import { readBodyText } from '@orkestrel/agent'
+ *
+ * const body = new Response('answer').body
+ * if (body !== null) await readBodyText(body, 3) // { text: 'ans', complete: false }
+ * ```
+ */
+export declare function readBodyText(body: ReadableStream<Uint8Array>, limit?: number, signal?: AbortSignal): Promise<TextRead>;
 
 /**
  * Decodes UTF-8 chunks with a final flush and releases the stream on every exit.
@@ -7279,29 +7302,6 @@ export declare interface Reading {
     readonly score?: number;
 }
 
-/**
- * Reads a UTF-8 prefix of a byte stream and cancels its remainder.
- *
- * @remarks
- * The `limit` parameter bounds bytes passed to the decoder, including a partial final
- * character. An omitted limit reads to completion. A source may deliver a chunk larger
- * than the remaining limit; its unused bytes are discarded without decoding.
- * The read can overshoot by one source chunk. An abort leaves completion false.
- *
- * @param body - The readable byte stream
- * @param limit - The maximum byte prefix, or undefined for the complete stream
- * @param signal - The optional cancellation bound; abort returns the decoded prefix
- * @returns The decoded prefix and whether EOF occurred within the byte budget
- * @example
- * ```ts
- * import { readText } from '@orkestrel/agent'
- *
- * const body = new Response('answer').body
- * if (body !== null) await readText(body, 3) // { text: 'ans', complete: false }
- * ```
- */
-export declare function readText(body: ReadableStream<Uint8Array>, limit?: number, signal?: AbortSignal): Promise<TextRead>;
-
 /** Reports a question a wire could not read a candidate for; it lists the caller's keys and invents no probability. */
 export declare interface Refusal {
     readonly missing: readonly string[];