@orkestrel/agent 0.0.33 → 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
@@ -7232,6 +7232,29 @@ export declare function raceSignal<T>(promise: Promise<T>, signal: AbortSignal |
  */
 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
@@ -7232,6 +7232,29 @@ export declare function raceSignal<T>(promise: Promise<T>, signal: AbortSignal |
  */
 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.js

@@ -1,12 +1,12 @@
-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 { 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
 /**
@@ -922,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}`}`,
@@ -949,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 {
@@ -1979,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");
@@ -2201,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);
@@ -4108,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
@@ -8567,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