@cubicecho/agent-core 3.0.0 → 4.1.0

package/dist/{continuation.d.ts → turn/continuation.d.ts}

@@ -1,7 +1,7 @@
 import type OpenAI from 'openai';
-import { type Capabilities } from './capabilities.ts';
+import { type Capabilities } from '../endpoint/capabilities.ts';
+import { type Turn } from '../wire/stream.ts';
 import { type RequestBuilder, type RunTurnOptions } from './run-turn.ts';
-import { type Turn } from './stream.ts';
 /**
  * Picking up an answer the token ceiling cut off, instead of keeping half of it.
  *
@@ -50,8 +50,8 @@ export declare const isContinuable: (turn: Turn) => boolean;
  * continuation's `finishReason` and tool calls.
  *
  * @remarks
- * Only a turn `isContinuable` accepts is continued; any other comes back as it was. Content and
- * reasoning are joined in order, the tool calls a continuation makes are kept, and usage is summed
+ * Only a turn cut off at the ceiling, with an answer begun and no tool call in it, is continued;
+ * any other comes back as it was. Content and reasoning are joined in order, the tool calls a continuation makes are kept, and usage is summed
  * across the requests with `continuations` counting them. The continuation is read as starting in
  * the answer, whatever `startInReasoning` says: a template that opens a fence for a fresh reply
  * does not open one for a prefill. Its tokens reach `onOutput` as they arrive, so a watcher sees

package/dist/{continuation.js → turn/continuation.js}

@@ -1,9 +1,9 @@
-import { modelCapabilitiesFor } from './capabilities.js';
-import { errorMessage } from './errors.js';
-import { ContextOverflow, refusesRequest } from './retry.js';
+import { modelCapabilitiesFor } from '../endpoint/capabilities.js';
+import { errorMessage } from '../wire/errors.js';
+import { ContextOverflow, refusesRequest } from '../wire/retry.js';
+import { addCounts } from '../wire/stream.js';
+import { FinishReason, Role } from '../wire/wire.js';
 import { modelLabel, runTurn } from './run-turn.js';
-import { addCounts } from './stream.js';
-import { FinishReason, Role } from './wire.js';
 /**
  * Whether a turn is one a continuation can finish: cut off at the ceiling, with an answer begun
  * and no tool call in it.
@@ -112,8 +112,8 @@ function joinUsage(first, next) {
  * continuation's `finishReason` and tool calls.
  *
  * @remarks
- * Only a turn `isContinuable` accepts is continued; any other comes back as it was. Content and
- * reasoning are joined in order, the tool calls a continuation makes are kept, and usage is summed
+ * Only a turn cut off at the ceiling, with an answer begun and no tool call in it, is continued;
+ * any other comes back as it was. Content and reasoning are joined in order, the tool calls a continuation makes are kept, and usage is summed
  * across the requests with `continuations` counting them. The continuation is read as starting in
  * the answer, whatever `startInReasoning` says: a template that opens a fence for a fresh reply
  * does not open one for a prefill. Its tokens reach `onOutput` as they arrive, so a watcher sees

package/dist/{run-turn.d.ts → turn/run-turn.d.ts}

@@ -1,6 +1,6 @@
 import type OpenAI from 'openai';
-import { type Capabilities, type ModelCapabilities, type OnNotice } from './capabilities.ts';
-import { type StreamTurnOptions, type Turn } from './stream.ts';
+import { type Capabilities, type ModelCapabilities, type OnNotice } from '../endpoint/capabilities.ts';
+import { type StreamTurnOptions, type Turn } from '../wire/stream.ts';
 /**
  * One turn, given as many attempts as the caller allows.
  *

package/dist/{run-turn.js → turn/run-turn.js}

@@ -1,10 +1,10 @@
-import { calibrate, charsPerTokenFor } from './calibration.js';
-import { negotiate } from './capabilities.js';
-import { errorMessage } from './errors.js';
-import { MS_PER_SECOND } from './platform.js';
-import { backoffMs, ContextOverflow, EndpointSilent, isModelLoading, isOverflow, isTransient, LOADING_POLL_MS, LOADING_TIMEOUT_MS, SMALLEST_LIKELY_WINDOW, sleep, } from './retry.js';
-import { streamTurn } from './stream.js';
-import { compact, requestTokens } from './tokens.js';
+import { MS_PER_SECOND } from '../core/platform.js';
+import { calibrate, charsPerTokenFor } from '../endpoint/calibration.js';
+import { negotiate } from '../endpoint/capabilities.js';
+import { errorMessage } from '../wire/errors.js';
+import { backoffMs, ContextOverflow, EndpointSilent, isModelLoading, isOverflow, isTransient, LOADING_POLL_MS, LOADING_TIMEOUT_MS, SMALLEST_LIKELY_WINDOW, sleep, } from '../wire/retry.js';
+import { streamTurn } from '../wire/stream.js';
+import { compact, requestTokens } from '../wire/tokens.js';
 /**
  * What a notice calls the model, where the caller did not say which one it is.
  *

package/dist/{side-task.d.ts → turn/side-task.d.ts}

@@ -1,6 +1,6 @@
 import type OpenAI from 'openai';
-import { type OnNotice } from './capabilities.ts';
-import type { Endpoint, EndpointIdentity } from './config.ts';
+import type { Endpoint, EndpointIdentity } from '../core/config.ts';
+import { type OnNotice } from '../endpoint/capabilities.ts';
 /**
  * The pairs that refused the hints, the live set, for `exportCapabilities` and
  * `importCapabilities`.

package/dist/{side-task.js → turn/side-task.js}

@@ -1,12 +1,12 @@
-import { capabilitiesFor, ceilingAndTemperature, EFFORT_NONE, effortFor, modelCapabilitiesFor, negotiate, } from './capabilities.js';
-import { endpointId, getClient, modelKey, resolveApiKey, sameUrl } from './client.js';
-import { errorMessage } from './errors.js';
-import { isAbort, refusesRequest } from './retry.js';
-import { relaxSchema, sanitizeSchema } from './schema-compat.js';
-import { scoped } from './scope.js';
-import { stripThinking } from './thinking.js';
-import { CODE_FENCE, looseJson } from './tool-calls.js';
-import { JSON_SCHEMA_FORMAT, Role } from './wire.js';
+import { scoped } from '../core/scope.js';
+import { capabilitiesFor, ceilingAndTemperature, EFFORT_NONE, effortFor, modelCapabilitiesFor, negotiate, } from '../endpoint/capabilities.js';
+import { endpointId, getClient, modelKey, resolveApiKey, sameUrl } from '../endpoint/client.js';
+import { relaxSchema, sanitizeSchema } from '../endpoint/schema-compat.js';
+import { errorMessage } from '../wire/errors.js';
+import { isAbort, refusesRequest } from '../wire/retry.js';
+import { stripThinking } from '../wire/thinking.js';
+import { CODE_FENCE, looseJson } from '../wire/tool-calls.js';
+import { JSON_SCHEMA_FORMAT, Role } from '../wire/wire.js';
 /**
  * One-shot calls that support a run without being one: picking tools, naming a session,
  * summarising a transcript, proposing follow-ups. They share a shape — small prompt, short

package/dist/{errors.d.ts → wire/errors.d.ts}

@@ -38,6 +38,8 @@ export interface AgentLoopFailure {
     loaded: string[];
     /** The tools the model had called, `load_tools` excluded. */
     used: string[];
+    /** The shortlist the run opened with, as the result's `preselected` would have said it. */
+    preselected: string[];
 }
 /**
  * What `runAgentLoop` throws, carrying the run as it stood and what was caught as `cause`.
@@ -55,6 +57,7 @@ export declare class AgentLoopError extends Error implements AgentLoopFailure {
     readonly toolCalls: ToolCallOutcome[];
     readonly loaded: string[];
     readonly used: string[];
+    readonly preselected: string[];
     /**
      * @param message - What went wrong — the cause's own message, where there is a cause.
      * @param run - The run as it stood. Held, not copied.
@@ -87,6 +90,7 @@ export declare class AgentLoopOverflow extends ContextOverflow implements AgentL
     readonly toolCalls: ToolCallOutcome[];
     readonly loaded: string[];
     readonly used: string[];
+    readonly preselected: string[];
     /**
      * @param message - The overflow's own message.
      * @param run - The run as it stood. Held, not copied.

package/dist/{errors.js → wire/errors.js}

@@ -28,6 +28,7 @@ export class AgentLoopError extends Error {
     toolCalls;
     loaded;
     used;
+    preselected;
     /**
      * @param message - What went wrong — the cause's own message, where there is a cause.
      * @param run - The run as it stood. Held, not copied.
@@ -40,6 +41,7 @@ export class AgentLoopError extends Error {
         this.toolCalls = run.toolCalls;
         this.loaded = run.loaded;
         this.used = run.used;
+        this.preselected = run.preselected;
     }
 }
 /**
@@ -67,6 +69,7 @@ export class AgentLoopOverflow extends ContextOverflow {
     toolCalls;
     loaded;
     used;
+    preselected;
     /**
      * @param message - The overflow's own message.
      * @param run - The run as it stood. Held, not copied.
@@ -79,6 +82,7 @@ export class AgentLoopOverflow extends ContextOverflow {
         this.toolCalls = run.toolCalls;
         this.loaded = run.loaded;
         this.used = run.used;
+        this.preselected = run.preselected;
     }
 }
 /**

package/dist/{retry.d.ts → wire/retry.d.ts}

@@ -91,7 +91,7 @@ export declare const refusesRequest: (error: unknown) => boolean;
  *
  * @remarks
  * An abort reaches a catch in two shapes. The SDK raises its own class when a request in flight is
- * cancelled, and `sleep` rejects with the signal's reason when the cancel lands between attempts.
+ * cancelled, and the wait between attempts rejects with the signal's reason when the cancel lands there.
  * A catch that knew only the first reported the second as a failure. A signal aborted with a
  * reason of the caller's own making is not recognised, since only the error is looked at: a
  * catch that holds the signal asks it as well, as `tryAsk` does.

package/dist/{retry.js → wire/retry.js}

@@ -1,5 +1,5 @@
 import OpenAI from 'openai';
-import { ABORT_ERROR, ABORT_EVENT } from './platform.js';
+import { ABORT_ERROR, ABORT_EVENT } from '../core/platform.js';
 import { HttpStatus } from './wire.js';
 /**
  * Everything about a request failing that is not about what the request said.
@@ -135,7 +135,7 @@ export const refusesRequest = (error) => error instanceof OpenAI.APIError &&
  *
  * @remarks
  * An abort reaches a catch in two shapes. The SDK raises its own class when a request in flight is
- * cancelled, and `sleep` rejects with the signal's reason when the cancel lands between attempts.
+ * cancelled, and the wait between attempts rejects with the signal's reason when the cancel lands there.
  * A catch that knew only the first reported the second as a failure. A signal aborted with a
  * reason of the caller's own making is not recognised, since only the error is looked at: a
  * catch that holds the signal asks it as well, as `tryAsk` does.

package/dist/{stream.js → wire/stream.js}

@@ -1,4 +1,4 @@
-import { MS_PER_SECOND } from './platform.js';
+import { MS_PER_SECOND } from '../core/platform.js';
 import { EndpointSilent } from './retry.js';
 import { DEFAULT_FENCES, FenceSplitter, SPLIT_REASONING } from './thinking.js';
 import { FUNCTION_TOOL } from './wire.js';

package/dist/{tokens.d.ts → wire/tokens.d.ts}

@@ -72,7 +72,7 @@ export declare function toolsChars(tools: OpenAI.ChatCompletionTool[]): number;
  *
  * @param body - The request as it was sent, tools included.
  * @returns The sum of `messageChars` over the messages. The tools are not in it, whether or not
- * the body carries them; `toolsChars` counts those.
+ * the body carries them; `contextChars` counts those, under `tools`.
  *
  * @remarks
  * What calibration reads a reported prompt count against, since a ratio is only as good as the
@@ -132,7 +132,7 @@ export interface ContextBreakdown {
  * that is neither that nor a `tool` message as `history`.
  *
  * @remarks
- * Exact and additive: the parts sum to `total`, which is `requestChars` plus `toolsChars`. The
+ * Exact and additive: the parts sum to `total`, which is `requestChars` plus the characters of the tools. The
  * conversion to tokens is `contextTokens`' business, because that is where an estimate and a
  * reported count have to be told apart.
  */

package/dist/{tokens.js → wire/tokens.js}

@@ -180,7 +180,7 @@ export function toolsChars(tools) {
  *
  * @param body - The request as it was sent, tools included.
  * @returns The sum of `messageChars` over the messages. The tools are not in it, whether or not
- * the body carries them; `toolsChars` counts those.
+ * the body carries them; `contextChars` counts those, under `tools`.
  *
  * @remarks
  * What calibration reads a reported prompt count against, since a ratio is only as good as the
@@ -232,7 +232,7 @@ const PARTS = ['system', 'tools', 'history', 'toolResults'];
  * that is neither that nor a `tool` message as `history`.
  *
  * @remarks
- * Exact and additive: the parts sum to `total`, which is `requestChars` plus `toolsChars`. The
+ * Exact and additive: the parts sum to `total`, which is `requestChars` plus the characters of the tools. The
  * conversion to tokens is `contextTokens`' business, because that is where an estimate and a
  * reported count have to be told apart.
  */

package/dist/{tool-calls.js → wire/tool-calls.js}

@@ -1,4 +1,4 @@
-import { isRecord } from './guards.js';
+import { isRecord } from '../core/guards.js';
 import { THINK_FENCE } from './thinking.js';
 import { FinishReason, FUNCTION_TOOL } from './wire.js';
 /**