@arnilo/prism 0.0.10 → 0.0.11

package/dist/contracts.d.ts

@@ -493,6 +493,22 @@ export declare class AgentRunError extends Error {
         readonly cause?: unknown;
     });
 }
+/** Mid-run steer queue: default pending message count (fail closed at this cap). */
+export declare const DEFAULT_MAX_PENDING_STEERS = 8;
+/** Absolute pending steer count ceiling if hosts later expose overrides. */
+export declare const HARD_MAX_PENDING_STEERS = 32;
+/** Mid-run steer queue: default total UTF-8 byte budget across pending messages. */
+export declare const DEFAULT_MAX_PENDING_STEER_BYTES: number;
+/** Absolute pending steer byte ceiling if hosts later expose overrides. */
+export declare const HARD_MAX_PENDING_STEER_BYTES: number;
+export interface SteerOptions {
+    /**
+     * When true, abort the in-flight provider stream and continue the same run after
+     * injecting steered user text. Default false: inject before the next provider turn
+     * (after the current tool batch completes).
+     */
+    readonly softInterrupt?: boolean;
+}
 export interface AgentSession {
     readonly id: string;
     /** Current branch leaf entry id; advances on every append/run and is re-pointed by `checkout`.
@@ -500,6 +516,12 @@ export interface AgentSession {
     readonly leafId: string | undefined;
     run(input: string | Message | readonly Message[], options?: RunOptions): Promise<AgentRunResult>;
     prompt(input: string, options?: RunOptions): Promise<AgentRunResult>;
+    /**
+     * Enqueue user text into an active run. Default injects before the next provider turn.
+     * `softInterrupt: true` aborts the current provider stream, then continues the same run.
+     * Fails closed when no run is active or the pending queue exceeds caps.
+     */
+    steer(input: string | Message | readonly Message[], options?: SteerOptions): void;
     /** Subscribe first, then start exactly one run and yield only that run's events until it terminates. */
     stream(input: string | Message | readonly Message[], options?: RunOptions & SubscribeOptions): AsyncIterable<AgentEvent>;
     compact(options?: CompactionOptions): Promise<CompactionResult>;
@@ -1022,7 +1044,80 @@ export interface SessionStore {
      *  avoid `list(sessionId)` (full-session scan) + in-memory rebuild. Optional — the
      *  built-in memory/JSONL stores omit it and the runtime falls back to `list()`. */
     readBranchPath?(query: SessionBranchRead): Promise<PersistencePage<SessionEntry>>;
+    /**
+     * Optional bounded session search. Prefer implementing this **or** returning a companion
+     * `SessionIndex` from the adapter factory — hosts must not need both. Call
+     * `resolveSessionSearchQuery` before scan/query. Memory defaults to capped linear
+     * search (`sessionSearchMode: "unsupported"` throws). JSONL throws unsupported.
+     */
+    searchSessions?(query: SessionSearchQuery): Promise<PersistencePage<SessionSearchHit>>;
+}
+/** Host-written `SessionRecord.metadata` / session metadata key for workspace filtering. */
+export declare const SESSION_SEARCH_WORKSPACE_METADATA_KEY: "workspaceRoot";
+export declare const DEFAULT_SESSION_SEARCH_LIMIT = 20;
+export declare const HARD_MAX_SESSION_SEARCH_LIMIT = 100;
+export declare const DEFAULT_MAX_SESSION_SEARCH_QUERY_BYTES: number;
+export declare const HARD_MAX_SESSION_SEARCH_QUERY_BYTES: number;
+export declare const DEFAULT_MAX_SESSION_SEARCH_SNIPPET_BYTES = 512;
+export declare const HARD_MAX_SESSION_SEARCH_SNIPPET_BYTES: number;
+export declare const DEFAULT_MAX_SESSION_SEARCH_CURSOR_BYTES: number;
+export declare const HARD_MAX_SESSION_SEARCH_CURSOR_BYTES: number;
+export declare const DEFAULT_MAX_SESSION_SEARCH_LINEAR_SESSIONS = 1000;
+export declare const HARD_MAX_SESSION_SEARCH_LINEAR_SESSIONS = 5000;
+export declare const DEFAULT_MAX_SESSION_SEARCH_LINEAR_ENTRIES = 10000;
+export declare const HARD_MAX_SESSION_SEARCH_LINEAR_ENTRIES = 50000;
+export declare const DEFAULT_MAX_SESSION_SEARCH_LINEAR_BYTES: number;
+export declare const HARD_MAX_SESSION_SEARCH_LINEAR_BYTES: number;
+export declare const DEFAULT_MAX_SESSION_SEARCH_FTS_CANDIDATES = 1000;
+export declare const HARD_MAX_SESSION_SEARCH_FTS_CANDIDATES = 5000;
+/** Bounded session search filters. Workspace matches host-written `metadata.workspaceRoot`. */
+export interface SessionSearchQuery extends PersistenceQuery, OwnershipScope {
+    readonly workspaceRoot?: string;
+    /** Optional full-text / message+summary query (adapter-defined matching). */
+    readonly query?: string;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly label?: string;
+    readonly summary?: string;
+    readonly fromUpdatedAt?: string;
+    readonly toUpdatedAt?: string;
+    readonly signal?: AbortSignal;
 }
+/**
+ * Safe search hit for resume/checkout. Never includes credentials or raw full transcripts.
+ * `leafId` is the branch tip for `session.checkout` when known.
+ */
+export interface SessionSearchHit {
+    readonly sessionId: string;
+    readonly leafId?: string;
+    readonly updatedAt?: string;
+    readonly label?: string;
+    readonly summary?: string;
+    readonly snippet?: string;
+    /** Safe display fields only (e.g. workspaceRoot); never credentials. */
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Narrow search seam; adapters may implement this instead of `SessionStore.searchSessions`. */
+export interface SessionIndex {
+    search(query: SessionSearchQuery): Promise<PersistencePage<SessionSearchHit>>;
+}
+/** Validated search query with finite `limit` / `order` filled in. */
+export interface ResolvedSessionSearchQuery extends SessionSearchQuery {
+    readonly limit: number;
+    readonly order: "asc" | "desc";
+}
+/**
+ * O(1) validation before any scan/query. Applies default page limit; rejects NaN,
+ * non-positive limits, oversize query/cursor/filter strings, and invalid order.
+ */
+export declare function resolveSessionSearchQuery(query: SessionSearchQuery): ResolvedSessionSearchQuery;
+export declare const SESSION_SEARCH_UNSUPPORTED_CODE: "session_search_unsupported";
+/** Thrown when a store opts out of `searchSessions` (memory `unsupported`, JSONL). */
+export declare class SessionSearchUnsupportedError extends Error {
+    readonly code: "session_search_unsupported";
+    constructor(message?: string);
+}
+export declare function isSessionSearchUnsupported(error: unknown): error is SessionSearchUnsupportedError;
 /** Query for a single branch's ancestor chain (DB-friendly: one recursive/ancestor query
  *  instead of a full-session scan). Honored by `SessionStore.readBranchPath` and the pure
  *  branch helpers' reader overload. `leafId` is optional (omit for the latest leaf). */
@@ -1642,6 +1737,10 @@ export interface LoopContext {
     isToolCallExclusive?(call: ToolCallContent): boolean;
     appendMessage(message: Message): Promise<void>;
     emit(event: AgentEvent): void;
+    /** True when mid-run steers are queued for the next provider turn. */
+    hasPendingSteers?(): boolean;
+    /** Drain pending steers into history/session. Returns true when any were applied. */
+    applyPendingSteers?(): Promise<boolean>;
 }
 export interface AgentLoopStrategy {
     readonly name: string;
@@ -1663,6 +1762,12 @@ export type AgentLoopOptions = {
     readonly structuredOutput?: StructuredOutputOptions;
     /** `native` maps schema to capable providers; `artifact-loop` keeps repair turns only. */
     readonly structuredOutputMode?: "native" | "artifact-loop";
+    /**
+     * When to attach native `structuredOutput` under `toolCalls: "bounded"`.
+     * `every-turn` (default): schema on every provider request (legacy).
+     * `final-turn-only`: tool-eligible turns omit schema; artifact/revision turns send schema and withdraw tools.
+     */
+    readonly structuredOutputTiming?: "every-turn" | "final-turn-only";
 };
 export interface ArtifactValidation {
     readonly ok: boolean;

package/dist/contracts.js

@@ -10,6 +10,14 @@ export class AgentRunError extends Error {
         this.result = result;
     }
 }
+/** Mid-run steer queue: default pending message count (fail closed at this cap). */
+export const DEFAULT_MAX_PENDING_STEERS = 8;
+/** Absolute pending steer count ceiling if hosts later expose overrides. */
+export const HARD_MAX_PENDING_STEERS = 32;
+/** Mid-run steer queue: default total UTF-8 byte budget across pending messages. */
+export const DEFAULT_MAX_PENDING_STEER_BYTES = 64 * 1024;
+/** Absolute pending steer byte ceiling if hosts later expose overrides. */
+export const HARD_MAX_PENDING_STEER_BYTES = 256 * 1024;
 export const SESSION_ENTRY_KINDS = [
     "message",
     "event",
@@ -25,6 +33,75 @@ export const SESSION_ENTRY_SCHEMA_VERSION = 1;
 export function isSessionEntryKind(value) {
     return typeof value === "string" && SESSION_ENTRY_KIND_SET.has(value);
 }
+/** Host-written `SessionRecord.metadata` / session metadata key for workspace filtering. */
+export const SESSION_SEARCH_WORKSPACE_METADATA_KEY = "workspaceRoot";
+export const DEFAULT_SESSION_SEARCH_LIMIT = 20;
+export const HARD_MAX_SESSION_SEARCH_LIMIT = 100;
+export const DEFAULT_MAX_SESSION_SEARCH_QUERY_BYTES = 4 * 1024;
+export const HARD_MAX_SESSION_SEARCH_QUERY_BYTES = 16 * 1024;
+export const DEFAULT_MAX_SESSION_SEARCH_SNIPPET_BYTES = 512;
+export const HARD_MAX_SESSION_SEARCH_SNIPPET_BYTES = 4 * 1024;
+export const DEFAULT_MAX_SESSION_SEARCH_CURSOR_BYTES = 1 * 1024;
+export const HARD_MAX_SESSION_SEARCH_CURSOR_BYTES = 4 * 1024;
+export const DEFAULT_MAX_SESSION_SEARCH_LINEAR_SESSIONS = 1_000;
+export const HARD_MAX_SESSION_SEARCH_LINEAR_SESSIONS = 5_000;
+export const DEFAULT_MAX_SESSION_SEARCH_LINEAR_ENTRIES = 10_000;
+export const HARD_MAX_SESSION_SEARCH_LINEAR_ENTRIES = 50_000;
+export const DEFAULT_MAX_SESSION_SEARCH_LINEAR_BYTES = 8 * 1024 * 1024;
+export const HARD_MAX_SESSION_SEARCH_LINEAR_BYTES = 64 * 1024 * 1024;
+export const DEFAULT_MAX_SESSION_SEARCH_FTS_CANDIDATES = 1_000;
+export const HARD_MAX_SESSION_SEARCH_FTS_CANDIDATES = 5_000;
+/**
+ * O(1) validation before any scan/query. Applies default page limit; rejects NaN,
+ * non-positive limits, oversize query/cursor/filter strings, and invalid order.
+ */
+export function resolveSessionSearchQuery(query) {
+    const limit = query.limit === undefined ? DEFAULT_SESSION_SEARCH_LIMIT : query.limit;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > HARD_MAX_SESSION_SEARCH_LIMIT) {
+        throw new TypeError(`SessionSearchQuery.limit must be a safe integer from 1 to ${HARD_MAX_SESSION_SEARCH_LIMIT}`);
+    }
+    const order = query.order ?? "desc";
+    if (order !== "asc" && order !== "desc") {
+        throw new TypeError('SessionSearchQuery.order must be "asc" or "desc"');
+    }
+    assertSearchStringBytes(query.query, "query", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.cursor, "cursor", HARD_MAX_SESSION_SEARCH_CURSOR_BYTES);
+    assertSearchStringBytes(query.workspaceRoot, "workspaceRoot", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.provider, "provider", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.model, "model", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.label, "label", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.summary, "summary", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.tenantId, "tenantId", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.accountId, "accountId", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.userId, "userId", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.fromUpdatedAt, "fromUpdatedAt", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    assertSearchStringBytes(query.toUpdatedAt, "toUpdatedAt", HARD_MAX_SESSION_SEARCH_QUERY_BYTES);
+    return { ...query, limit, order };
+}
+function assertSearchStringBytes(value, name, hardMax) {
+    if (value === undefined)
+        return;
+    if (typeof value !== "string") {
+        throw new TypeError(`SessionSearchQuery.${name} must be a string`);
+    }
+    // ponytail: UTF-8 byte length via TextEncoder; upgrade only if a non-Unicode host appears.
+    const bytes = new TextEncoder().encode(value).byteLength;
+    if (bytes > hardMax) {
+        throw new TypeError(`SessionSearchQuery.${name} exceeds ${hardMax} bytes`);
+    }
+}
+export const SESSION_SEARCH_UNSUPPORTED_CODE = "session_search_unsupported";
+/** Thrown when a store opts out of `searchSessions` (memory `unsupported`, JSONL). */
+export class SessionSearchUnsupportedError extends Error {
+    code = SESSION_SEARCH_UNSUPPORTED_CODE;
+    constructor(message = "session search is unsupported by this store") {
+        super(message);
+        this.name = "SessionSearchUnsupportedError";
+    }
+}
+export function isSessionSearchUnsupported(error) {
+    return error instanceof Error && error.code === SESSION_SEARCH_UNSUPPORTED_CODE;
+}
 /** Stable error code carried by `SessionAppendConflictError`. */
 export const SESSION_APPEND_CONFLICT_CODE = "session_append_conflict";
 /**

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export type * from "./contracts.js";
 export type { RunLimitCounters, RunLimitName, SecureAgentOptions } from "./contracts.js";
-export { isSessionEntryKind, SESSION_APPEND_CONFLICT_CODE, SESSION_ENTRY_KINDS, SESSION_ENTRY_SCHEMA_VERSION, SessionAppendConflictError, isSessionAppendConflict, AgentRunError, AgentRunStateError } from "./contracts.js";
+export { isSessionEntryKind, SESSION_APPEND_CONFLICT_CODE, SESSION_ENTRY_KINDS, SESSION_ENTRY_SCHEMA_VERSION, SessionAppendConflictError, isSessionAppendConflict, AgentRunError, AgentRunStateError, SESSION_SEARCH_WORKSPACE_METADATA_KEY, SESSION_SEARCH_UNSUPPORTED_CODE, SessionSearchUnsupportedError, isSessionSearchUnsupported, DEFAULT_SESSION_SEARCH_LIMIT, HARD_MAX_SESSION_SEARCH_LIMIT, DEFAULT_MAX_SESSION_SEARCH_QUERY_BYTES, HARD_MAX_SESSION_SEARCH_QUERY_BYTES, DEFAULT_MAX_SESSION_SEARCH_SNIPPET_BYTES, HARD_MAX_SESSION_SEARCH_SNIPPET_BYTES, DEFAULT_MAX_SESSION_SEARCH_CURSOR_BYTES, HARD_MAX_SESSION_SEARCH_CURSOR_BYTES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_SESSIONS, HARD_MAX_SESSION_SEARCH_LINEAR_SESSIONS, DEFAULT_MAX_SESSION_SEARCH_LINEAR_ENTRIES, HARD_MAX_SESSION_SEARCH_LINEAR_ENTRIES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_BYTES, HARD_MAX_SESSION_SEARCH_LINEAR_BYTES, DEFAULT_MAX_SESSION_SEARCH_FTS_CANDIDATES, HARD_MAX_SESSION_SEARCH_FTS_CANDIDATES, resolveSessionSearchQuery, DEFAULT_MAX_PENDING_STEERS, HARD_MAX_PENDING_STEERS, DEFAULT_MAX_PENDING_STEER_BYTES, HARD_MAX_PENDING_STEER_BYTES } from "./contracts.js";
 export { createAgent, createAgentSession, resumeAgentRun } from "./agents.js";
 export { createBatchedRunLedger, isFlushableRunLedger, DEFAULT_LEDGER_BATCH_ENTRIES, HARD_LEDGER_BATCH_ENTRIES, DEFAULT_LEDGER_BATCH_BYTES, HARD_LEDGER_BATCH_BYTES, DEFAULT_LEDGER_BATCH_DELAY_MS, HARD_LEDGER_BATCH_DELAY_MS, } from "./run-ledger.js";
 export type { BatchedRunLedgerOptions } from "./run-ledger.js";
@@ -34,7 +34,7 @@ export type { ExtensionErrorPolicy, ExtensionEventBus, ExtensionEventHandler, Ex
 export type { CredentialRecord, CredentialValueSource, MemoryCredentialStore } from "./credentials.js";
 export { createModelRegistry } from "./models.js";
 export { authMethodKey, defineProviderPackage, systemPromptContributionKey } from "./provider-packages.js";
-export { assertStructuredOutputRequestSupported, DEFAULT_MAX_STRUCTURED_OUTPUT_NAME_LENGTH, DEFAULT_MAX_STRUCTURED_OUTPUT_SCHEMA_BYTES, modelSupportsStructuredOutput, resolveRunProviderOptions, StructuredOutputError, validateStructuredOutputOptions, } from "./structured-output.js";
+export { assertStructuredOutputRequestSupported, artifactStructuredOutputRequest, DEFAULT_MAX_STRUCTURED_OUTPUT_NAME_LENGTH, DEFAULT_MAX_STRUCTURED_OUTPUT_SCHEMA_BYTES, modelSupportsStructuredOutput, resolveRunProviderOptions, StructuredOutputError, validateStructuredOutputOptions, withoutStructuredOutput, } from "./structured-output.js";
 export { createProviderTurnMetadata, readProviderHttpStatus } from "./observability.js";
 export { createProviderRequestPolicyChain, createSessionCachePolicy, mergeProviderRequestOptions } from "./provider-request-policy.js";
 export type { SessionCachePolicyOptions } from "./provider-request-policy.js";
@@ -55,10 +55,12 @@ export { createChainedSettingsProvider, createStaticSettingsProvider } from "./s
 export { createMiddlewareRegistry } from "./middleware.js";
 export type { Middleware, MiddlewareHookName, MiddlewareNext, MiddlewareRegistry, MiddlewareRegistryOptions } from "./middleware.js";
 export { assembleProviderInput, createDefaultInputBuilder, createDefaultPromptBuilder, renderPromptTemplate, resolveContextProviders } from "./input.js";
+export { applyContextBudget, CONTEXT_BUDGET_ERROR_CODE, CONTEXT_BUDGET_REPORT_METADATA_KEY, ContextBudgetError, DEFAULT_MAX_CONTEXT_BUDGET_OMISSIONS, estimateAssemblyTokens, estimateMessageBytes, estimateMessageTokens, estimateTextBytes, estimateTextTokens, getContextBudgetReport, HARD_MAX_CONTEXT_BUDGET_BYTES, HARD_MAX_CONTEXT_BUDGET_OMISSIONS, HARD_MAX_CONTEXT_BUDGET_TOKENS, isContextBudgetError, resolveContextBudget, } from "./context-budget.js";
+export type { ContextBudget, ContextBudgetMessageGroups, ContextBudgetOmission, ContextBudgetOmissionKind, ContextBudgetReport, } from "./context-budget.js";
 export type { AgentInput, AssembleProviderInputOptions, DefaultInputBuilder, DefaultInputBuildContext, DefaultPromptBuilder, InputAttachment, PromptInstruction, PromptTemplateOptions, ResolveContextOptions } from "./input.js";
 export { createMockProvider } from "./mock-provider.js";
 export { createMemorySessionStore, createSessionEntry, getSessionBranchEntries, listSessionBranches, rebuildSessionContext } from "./session-stores.js";
-export type { CreateSessionEntryOptions, SessionBranch, SessionBranchOptions, SessionContextSnapshot } from "./session-stores.js";
+export type { CreateMemorySessionStoreOptions, CreateSessionEntryOptions, MemorySessionSearchMode, SessionBranch, SessionBranchOptions, SessionContextSnapshot } from "./session-stores.js";
 export type { MockProviderOptions } from "./mock-provider.js";
 export { providerContentDelta, providerDone, providerError, providerTextDelta, providerThinkingDelta, providerToolCall, providerToolCallDelta, providerUsage, toolCallContent, toolCallFromArgumentsText, } from "./provider-events.js";
 export type { ProviderResolver } from "./contracts.js";
@@ -83,5 +85,5 @@ export type { DispatchToolCallOptions, ToolArgumentValidationError, ToolArgument
 export type { DuplicateRegistrationOptions, DuplicateRegistrationPolicy } from "./registry-options.js";
 export { dispatchToolCallsInOrder, generateValidateReviseLoop, isAgentLoopOptions, resolveLoop, resolveToolConcurrency, singleShotLoop } from "./agent-loops.js";
 export declare const name = "prism";
-export declare const version = "0.0.10";
+export declare const version = "0.0.11";
 export declare const description = "Agent harness for AI providers, agents, sessions, and tools.";

package/dist/index.js

@@ -1,4 +1,4 @@
-export { isSessionEntryKind, SESSION_APPEND_CONFLICT_CODE, SESSION_ENTRY_KINDS, SESSION_ENTRY_SCHEMA_VERSION, SessionAppendConflictError, isSessionAppendConflict, AgentRunError, AgentRunStateError } from "./contracts.js";
+export { isSessionEntryKind, SESSION_APPEND_CONFLICT_CODE, SESSION_ENTRY_KINDS, SESSION_ENTRY_SCHEMA_VERSION, SessionAppendConflictError, isSessionAppendConflict, AgentRunError, AgentRunStateError, SESSION_SEARCH_WORKSPACE_METADATA_KEY, SESSION_SEARCH_UNSUPPORTED_CODE, SessionSearchUnsupportedError, isSessionSearchUnsupported, DEFAULT_SESSION_SEARCH_LIMIT, HARD_MAX_SESSION_SEARCH_LIMIT, DEFAULT_MAX_SESSION_SEARCH_QUERY_BYTES, HARD_MAX_SESSION_SEARCH_QUERY_BYTES, DEFAULT_MAX_SESSION_SEARCH_SNIPPET_BYTES, HARD_MAX_SESSION_SEARCH_SNIPPET_BYTES, DEFAULT_MAX_SESSION_SEARCH_CURSOR_BYTES, HARD_MAX_SESSION_SEARCH_CURSOR_BYTES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_SESSIONS, HARD_MAX_SESSION_SEARCH_LINEAR_SESSIONS, DEFAULT_MAX_SESSION_SEARCH_LINEAR_ENTRIES, HARD_MAX_SESSION_SEARCH_LINEAR_ENTRIES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_BYTES, HARD_MAX_SESSION_SEARCH_LINEAR_BYTES, DEFAULT_MAX_SESSION_SEARCH_FTS_CANDIDATES, HARD_MAX_SESSION_SEARCH_FTS_CANDIDATES, resolveSessionSearchQuery, DEFAULT_MAX_PENDING_STEERS, HARD_MAX_PENDING_STEERS, DEFAULT_MAX_PENDING_STEER_BYTES, HARD_MAX_PENDING_STEER_BYTES } from "./contracts.js";
 export { createAgent, createAgentSession, resumeAgentRun } from "./agents.js";
 export { createBatchedRunLedger, isFlushableRunLedger, DEFAULT_LEDGER_BATCH_ENTRIES, HARD_LEDGER_BATCH_ENTRIES, DEFAULT_LEDGER_BATCH_BYTES, HARD_LEDGER_BATCH_BYTES, DEFAULT_LEDGER_BATCH_DELAY_MS, HARD_LEDGER_BATCH_DELAY_MS, } from "./run-ledger.js";
 export { createSecureAgent } from "./secure-agent.js";
@@ -19,7 +19,7 @@ export { createChainedCredentialResolver, createEnvCredentialResolver, createExp
 export { createExtensionEventBus, createExtensionKernel } from "./extensions.js";
 export { createModelRegistry } from "./models.js";
 export { authMethodKey, defineProviderPackage, systemPromptContributionKey } from "./provider-packages.js";
-export { assertStructuredOutputRequestSupported, DEFAULT_MAX_STRUCTURED_OUTPUT_NAME_LENGTH, DEFAULT_MAX_STRUCTURED_OUTPUT_SCHEMA_BYTES, modelSupportsStructuredOutput, resolveRunProviderOptions, StructuredOutputError, validateStructuredOutputOptions, } from "./structured-output.js";
+export { assertStructuredOutputRequestSupported, artifactStructuredOutputRequest, DEFAULT_MAX_STRUCTURED_OUTPUT_NAME_LENGTH, DEFAULT_MAX_STRUCTURED_OUTPUT_SCHEMA_BYTES, modelSupportsStructuredOutput, resolveRunProviderOptions, StructuredOutputError, validateStructuredOutputOptions, withoutStructuredOutput, } from "./structured-output.js";
 export { createProviderTurnMetadata, readProviderHttpStatus } from "./observability.js";
 export { createProviderRequestPolicyChain, createSessionCachePolicy, mergeProviderRequestOptions } from "./provider-request-policy.js";
 export { THINKING_LEVELS, applyThinkingLevel, isThinkingLevel, normalizeThinkingLevel, thinkingCompatFor, thinkingFamilyForModel, } from "./thinking.js";
@@ -31,6 +31,7 @@ export { loadBinaryResource, loadJsonResource, loadManifestResource, loadTextRes
 export { createChainedSettingsProvider, createStaticSettingsProvider } from "./settings.js";
 export { createMiddlewareRegistry } from "./middleware.js";
 export { assembleProviderInput, createDefaultInputBuilder, createDefaultPromptBuilder, renderPromptTemplate, resolveContextProviders } from "./input.js";
+export { applyContextBudget, CONTEXT_BUDGET_ERROR_CODE, CONTEXT_BUDGET_REPORT_METADATA_KEY, ContextBudgetError, DEFAULT_MAX_CONTEXT_BUDGET_OMISSIONS, estimateAssemblyTokens, estimateMessageBytes, estimateMessageTokens, estimateTextBytes, estimateTextTokens, getContextBudgetReport, HARD_MAX_CONTEXT_BUDGET_BYTES, HARD_MAX_CONTEXT_BUDGET_OMISSIONS, HARD_MAX_CONTEXT_BUDGET_TOKENS, isContextBudgetError, resolveContextBudget, } from "./context-budget.js";
 export { createMockProvider } from "./mock-provider.js";
 export { createMemorySessionStore, createSessionEntry, getSessionBranchEntries, listSessionBranches, rebuildSessionContext } from "./session-stores.js";
 export { providerContentDelta, providerDone, providerError, providerTextDelta, providerThinkingDelta, providerToolCall, providerToolCallDelta, providerUsage, toolCallContent, toolCallFromArgumentsText, } from "./provider-events.js";
@@ -45,6 +46,6 @@ export { assertGuardrailsAllowed, GuardrailError, MAX_GUARDRAIL_CONCURRENCY, run
 export { createRunLimitTracker, DEFAULT_RUN_LIMITS, HARD_MAX_RUN_COST, HARD_RUN_LIMITS, RunLimitError, RunLimitTracker, resolveRunLimits } from "./run-limits.js";
 export { dispatchToolCallsInOrder, generateValidateReviseLoop, isAgentLoopOptions, resolveLoop, resolveToolConcurrency, singleShotLoop } from "./agent-loops.js";
 export const name = "prism";
-export const version = "0.0.10";
+export const version = "0.0.11";
 export const description = "Agent harness for AI providers, agents, sessions, and tools.";
 //# sourceMappingURL=index.js.map

package/dist/input.d.ts

@@ -1,6 +1,7 @@
 import type { ContentBlock, ContextBlock, ContextProvider, ContextResolutionContext, InputBuilder, InstructionInjector, InputBuildContext, JsonObject, Message, ModelConfig, PromptBuilder, PromptBuildRequest, ProviderRequest, ProviderRequestOptions, ResourceLoader, Skill, ToolDefinition, ToolResult } from "./contracts.js";
 import type { MiddlewareRegistry } from "./middleware.js";
 import type { SecretRedactor } from "./redaction.js";
+import { type ContextBudget } from "./context-budget.js";
 export type AgentInput = string | Message | readonly Message[];
 export interface PromptInstruction {
     readonly text: string;
@@ -54,6 +55,8 @@ export interface AssembleProviderInputOptions extends DefaultInputBuildContext {
     readonly skills?: readonly Skill[];
     readonly tools?: readonly ToolDefinition[];
     readonly providerOptions?: ProviderRequestOptions;
+    /** Assembler-time eviction; does not delete session store history. */
+    readonly contextBudget?: ContextBudget;
 }
 export declare function createDefaultInputBuilder(): DefaultInputBuilder;
 export declare function resolveContextProviders(options: ResolveContextOptions): Promise<readonly ContextBlock[]>;

package/dist/input.js

@@ -3,22 +3,12 @@ import { assertMessagesSupportModelCapabilities } from "./content.js";
 import { loadTextResource } from "./resources.js";
 import { composeSystemPrompt } from "./system-prompts.js";
 import { runInstructionInjectors } from "./instruction-injection.js";
+import { applyContextBudget, CONTEXT_BUDGET_REPORT_METADATA_KEY, } from "./context-budget.js";
 export function createDefaultInputBuilder() {
     return {
         name: "default-input",
         async build(input, context = {}) {
-            const groups = {
-                instructions: [
-                    ...instructionMessages(context.systemInstructions, "System instruction"),
-                    ...instructionMessages(context.developerInstructions, "Developer instruction"),
-                    ...customInstructionMessages(context.instructions),
-                ],
-                summaries: summaryMessages(context.summaries),
-                history: [...(context.history ?? [])],
-                input: inputMessages(input),
-                attachments: await attachmentMessages(context),
-                toolResults: toolResultMessages(context.toolResults),
-            };
+            const groups = await buildDefaultInputMessageGroups(input, context);
             const messages = flattenInputGroups(groups, context.inputLayout ?? "legacy");
             return context.middleware ? context.middleware.run("input_assembly", messages) : messages;
         },
@@ -65,7 +55,6 @@ export function renderPromptTemplate(template, variables, options = {}) {
     });
 }
 export async function assembleProviderInput(options) {
-    const inputBuilder = options.inputBuilder ?? createDefaultInputBuilder();
     const baseContext = {
         sessionId: options.sessionId,
         runId: options.runId,
@@ -92,44 +81,98 @@ export async function assembleProviderInput(options) {
         ? composeSystemPrompt(injectorContribs.instructions, { base: options.systemInstructions })
         : options.systemInstructions;
     const buildContext = { ...options, ...baseContext, systemInstructions };
-    const messages = await inputBuilder.build(options.input, buildContext);
-    const context = await resolveContextProviders({
-        providers: options.contextProviders,
-        messages,
-        injectedBlocks: injectorContribs.contextBlocks.length ? injectorContribs.contextBlocks : undefined,
-        middleware: options.middleware,
-        ...baseContext,
-    });
+    const layout = buildContext.inputLayout ?? "legacy";
+    let messages;
+    let context;
+    let skills = options.skills;
+    let tools = options.tools;
+    let budgetReport;
+    if (options.contextBudget) {
+        // ponytail: budget path always uses default groups so eviction kinds stay deterministic;
+        // custom inputBuilder still honored when contextBudget is absent.
+        const groups = await buildDefaultInputMessageGroups(options.input, buildContext);
+        context = await resolveContextProviders({
+            providers: options.contextProviders,
+            messages: flattenInputGroups(groups, layout),
+            injectedBlocks: injectorContribs.contextBlocks.length ? injectorContribs.contextBlocks : undefined,
+            middleware: options.middleware,
+            ...baseContext,
+        });
+        const applied = applyContextBudget({
+            groups,
+            context,
+            skills: skills ?? [],
+            tools,
+            budget: options.contextBudget,
+            layout,
+        });
+        messages = flattenInputGroups(applied.groups, layout);
+        if (buildContext.middleware)
+            messages = await buildContext.middleware.run("input_assembly", messages);
+        context = applied.context;
+        skills = applied.skills;
+        tools = applied.tools;
+        if (options.contextBudget.reportOmissions)
+            budgetReport = applied.report;
+    }
+    else {
+        const inputBuilder = options.inputBuilder ?? createDefaultInputBuilder();
+        messages = await inputBuilder.build(options.input, buildContext);
+        context = await resolveContextProviders({
+            providers: options.contextProviders,
+            messages,
+            injectedBlocks: injectorContribs.contextBlocks.length ? injectorContribs.contextBlocks : undefined,
+            middleware: options.middleware,
+            ...baseContext,
+        });
+    }
     const promptBuilder = options.promptBuilder ?? createDefaultPromptBuilder();
     const promptRequest = options.middleware
         ? await options.middleware.run("prompt_build", {
             messages,
             context,
-            skills: options.skills,
-            tools: options.tools,
+            skills,
+            tools,
             metadata: options.metadata,
             signal: options.signal,
         })
         : {
             messages,
             context,
-            skills: options.skills,
-            tools: options.tools,
+            skills,
+            tools,
             metadata: options.metadata,
             signal: options.signal,
         };
-    const providerMessages = await promptBuilder.build({ ...promptRequest, tools: options.tools });
+    const providerMessages = await promptBuilder.build({ ...promptRequest, tools });
     assertMessagesSupportModelCapabilities(options.model, providerMessages);
+    const metadata = budgetReport
+        ? { ...options.metadata, [CONTEXT_BUDGET_REPORT_METADATA_KEY]: budgetReport }
+        : options.metadata;
     return {
         model: options.model,
         messages: providerMessages,
-        tools: options.tools,
+        tools,
         context,
         options: options.providerOptions,
-        metadata: options.metadata,
+        metadata,
         signal: options.signal,
     };
 }
+async function buildDefaultInputMessageGroups(input, context) {
+    return {
+        instructions: [
+            ...instructionMessages(context.systemInstructions, "System instruction"),
+            ...instructionMessages(context.developerInstructions, "Developer instruction"),
+            ...customInstructionMessages(context.instructions),
+        ],
+        summaries: summaryMessages(context.summaries),
+        history: [...(context.history ?? [])],
+        input: inputMessages(input),
+        attachments: await attachmentMessages(context),
+        toolResults: toolResultMessages(context.toolResults),
+    };
+}
 function flattenInputGroups(groups, layout) {
     switch (layout) {
         case "cache_aware":

package/dist/node/session-store-jsonl.js

@@ -1,6 +1,6 @@
 import { mkdir, readFile, appendFile } from "node:fs/promises";
 import { dirname } from "node:path";
-import { SESSION_APPEND_CONFLICT_CODE, SessionAppendConflictError, isSessionEntryKind, SESSION_ENTRY_SCHEMA_VERSION } from "../contracts.js";
+import { SESSION_APPEND_CONFLICT_CODE, SessionAppendConflictError, SessionSearchUnsupportedError, isSessionEntryKind, SESSION_ENTRY_SCHEMA_VERSION, } from "../contracts.js";
 import { isNodeErrorCode } from "./config.js";
 export function createJsonlSessionStore(pathOrOptions) {
     const options = typeof pathOrOptions === "string" ? { path: pathOrOptions, createDirectory: true } : pathOrOptions;
@@ -46,6 +46,9 @@ export function createJsonlSessionStore(pathOrOptions) {
         async get(id) {
             return findEntry(path, id);
         },
+        async searchSessions() {
+            throw new SessionSearchUnsupportedError("JSONL session store does not support searchSessions");
+        },
     };
 }
 /** Read a JSONL session file and return both valid entries and per-line parse errors. */

package/dist/rpc.js

@@ -82,8 +82,19 @@ async function handleRequest(request, state, stdout, activeRuns) {
             activeRuns.set(session.id, { requestId: request.id, promise });
             break;
         }
-        case "steer":
-            throw new Error("steer is not supported by the current AgentSession runtime");
+        case "steer": {
+            const input = stringParam(request.params, "input") ?? stringParam(request.params, "prompt");
+            if (!input)
+                throw new Error("steer requires params.input");
+            const softInterrupt = request.params?.softInterrupt === true;
+            state.current.steer(input, softInterrupt ? { softInterrupt: true } : undefined);
+            write(stdout, {
+                id: request.id,
+                ok: true,
+                result: { sessionId: state.current.id },
+            });
+            break;
+        }
         case "abort":
             state.current.abort(stringParam(request.params, "reason"));
             write(stdout, { id: request.id, ok: true, result: { sessionId: state.current.id } });

package/dist/session-stores.d.ts

@@ -1,4 +1,4 @@
-import type { Message, SessionBranchRead, BranchReader, SessionEntry, SessionStore } from "./contracts.js";
+import { type Message, type SessionBranchRead, type BranchReader, type SessionEntry, type SessionStore } from "./contracts.js";
 export interface CreateSessionEntryOptions extends Omit<SessionEntry, "id" | "timestamp"> {
     readonly id?: string;
     readonly timestamp?: string;
@@ -24,4 +24,9 @@ export declare function getSessionBranchEntries(entries: readonly SessionEntry[]
 export declare function listSessionBranches(entries: readonly SessionEntry[]): readonly SessionBranch[];
 export declare function rebuildSessionContext(reader: BranchReader, query: SessionBranchRead): Promise<SessionContextSnapshot>;
 export declare function rebuildSessionContext(entries: readonly SessionEntry[], options?: SessionBranchOptions): SessionContextSnapshot;
-export declare function createMemorySessionStore(initialEntries?: readonly SessionEntry[]): SessionStore;
+export type MemorySessionSearchMode = "linear" | "unsupported";
+export interface CreateMemorySessionStoreOptions {
+    /** Default `"linear"`: capped in-process scan. `"unsupported"`: typed throw. */
+    readonly sessionSearchMode?: MemorySessionSearchMode;
+}
+export declare function createMemorySessionStore(initialEntries?: readonly SessionEntry[], options?: CreateMemorySessionStoreOptions): SessionStore;