@arnilo/prism 0.0.10 → 0.0.12

package/dist/context-budget.js

@@ -0,0 +1,235 @@
+export const CONTEXT_BUDGET_REPORT_METADATA_KEY = "contextBudgetReport";
+export const HARD_MAX_CONTEXT_BUDGET_TOKENS = 2_000_000;
+export const HARD_MAX_CONTEXT_BUDGET_BYTES = 32 * 1024 * 1024;
+export const DEFAULT_MAX_CONTEXT_BUDGET_OMISSIONS = 256;
+export const HARD_MAX_CONTEXT_BUDGET_OMISSIONS = 1_024;
+export const CONTEXT_BUDGET_ERROR_CODE = "context_budget_exceeded";
+export class ContextBudgetError extends Error {
+    code = CONTEXT_BUDGET_ERROR_CODE;
+    constructor(message = "context budget exceeded: mandatory prefix cannot fit") {
+        super(message);
+        this.name = "ContextBudgetError";
+    }
+}
+export function isContextBudgetError(error) {
+    return error instanceof Error && error.code === CONTEXT_BUDGET_ERROR_CODE;
+}
+/** UTF-16 code units / 4. Estimate only — not billing. */
+export function estimateTextTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+export function estimateTextBytes(text) {
+    return new TextEncoder().encode(text).byteLength;
+}
+export function estimateMessageTokens(message) {
+    return estimateTextTokens(messageText(message));
+}
+export function estimateMessageBytes(message) {
+    return estimateTextBytes(messageText(message));
+}
+export function estimateAssemblyTokens(messages) {
+    return messages.reduce((sum, message) => sum + estimateMessageTokens(message), 0);
+}
+export function resolveContextBudget(budget) {
+    const hasTokens = budget.maxInputTokens !== undefined;
+    const hasBytes = budget.maxInputBytes !== undefined;
+    if (!hasTokens && !hasBytes) {
+        throw new TypeError("contextBudget requires maxInputTokens and/or maxInputBytes");
+    }
+    if (hasTokens)
+        assertPositiveCap(budget.maxInputTokens, "maxInputTokens", HARD_MAX_CONTEXT_BUDGET_TOKENS);
+    if (hasBytes)
+        assertPositiveCap(budget.maxInputBytes, "maxInputBytes", HARD_MAX_CONTEXT_BUDGET_BYTES);
+    return { ...budget, reportOmissions: budget.reportOmissions === true };
+}
+export function getContextBudgetReport(request) {
+    const value = request.metadata?.[CONTEXT_BUDGET_REPORT_METADATA_KEY];
+    return isContextBudgetReport(value) ? value : undefined;
+}
+export function applyContextBudget(options) {
+    const budget = resolveContextBudget(options.budget);
+    const layout = options.layout ?? "legacy";
+    const groups = {
+        instructions: [...options.groups.instructions],
+        summaries: [...options.groups.summaries],
+        history: [...options.groups.history],
+        input: [...options.groups.input],
+        attachments: [...options.groups.attachments],
+        toolResults: [...options.groups.toolResults],
+    };
+    const context = [...(options.context ?? [])];
+    const skills = [...(options.skills ?? [])].filter((skill) => skill.instructions);
+    const tools = options.tools ? [...options.tools] : undefined;
+    const omitted = [];
+    const cost = () => measureAll(groups, context, skills, tools);
+    while (overBudget(cost(), budget)) {
+        const drop = dropNext(groups, context, skills, layout);
+        if (!drop) {
+            throw new ContextBudgetError();
+        }
+        if (omitted.length < HARD_MAX_CONTEXT_BUDGET_OMISSIONS)
+            omitted.push(drop);
+    }
+    const kept = cost();
+    const reportOmissions = omitted.slice(0, DEFAULT_MAX_CONTEXT_BUDGET_OMISSIONS);
+    return {
+        groups,
+        context,
+        skills,
+        tools,
+        report: {
+            omitted: budget.reportOmissions ? reportOmissions : [],
+            keptTokens: kept.tokens,
+            keptBytes: kept.bytes,
+            maxInputTokens: budget.maxInputTokens,
+            maxInputBytes: budget.maxInputBytes,
+            truncated: omitted.length > 0,
+        },
+    };
+}
+function dropNext(groups, context, skills, layout) {
+    // ponytail: drop from end of keep-stack (history/tool_results first). cache_aware keeps
+    // attachments longer so stable prefix stays intact while budget still allows it.
+    const order = layout === "cache_aware"
+        ? ["tool_results", "history", "summaries", "context", "skills", "attachments"]
+        : ["tool_results", "history", "summaries", "attachments", "context", "skills"];
+    for (const kind of order) {
+        if (kind === "tool_results" && groups.toolResults.length > 0) {
+            const message = groups.toolResults.pop();
+            return omission("tool_results", message.id ?? toolResultId(message), message);
+        }
+        if (kind === "history" && groups.history.length > 0) {
+            const message = groups.history.pop();
+            return omission("history", message.id, message);
+        }
+        if (kind === "summaries" && groups.summaries.length > 0) {
+            const message = groups.summaries.pop();
+            return omission("summaries", message.id, message);
+        }
+        if (kind === "attachments" && groups.attachments.length > 0) {
+            const message = groups.attachments.pop();
+            return omission("attachments", message.id, message);
+        }
+        if (kind === "context" && context.length > 0) {
+            const block = context.pop();
+            const text = `${block.title ? `${block.title}:\n` : "Context:\n"}${contextBlockText(block)}`;
+            return {
+                kind: "context",
+                id: block.id ?? block.title,
+                tokenEstimate: estimateTextTokens(text),
+                byteLength: estimateTextBytes(text),
+            };
+        }
+        if (kind === "skills" && skills.length > 0) {
+            const skill = skills.pop();
+            const text = `Skill ${skill.name}:\n${skill.instructions ?? ""}`;
+            return {
+                kind: "skills",
+                id: skill.name,
+                tokenEstimate: estimateTextTokens(text),
+                byteLength: estimateTextBytes(text),
+            };
+        }
+    }
+    return undefined;
+}
+function omission(kind, id, message) {
+    return {
+        kind,
+        id,
+        tokenEstimate: estimateMessageTokens(message),
+        byteLength: estimateMessageBytes(message),
+    };
+}
+function toolResultId(message) {
+    const block = message.content.find((part) => part.type === "tool_result");
+    return block && block.type === "tool_result" ? block.toolCallId : undefined;
+}
+function measureAll(groups, context, skills, tools) {
+    let tokens = 0;
+    let bytes = 0;
+    const addMessage = (message) => {
+        tokens += estimateMessageTokens(message);
+        bytes += estimateMessageBytes(message);
+    };
+    for (const message of groups.instructions)
+        addMessage(message);
+    for (const message of groups.summaries)
+        addMessage(message);
+    for (const message of groups.history)
+        addMessage(message);
+    for (const message of groups.input)
+        addMessage(message);
+    for (const message of groups.attachments)
+        addMessage(message);
+    for (const message of groups.toolResults)
+        addMessage(message);
+    for (const block of context) {
+        const text = `${block.title ? `${block.title}:\n` : "Context:\n"}${contextBlockText(block)}`;
+        tokens += estimateTextTokens(text);
+        bytes += estimateTextBytes(text);
+    }
+    for (const skill of skills) {
+        const text = `Skill ${skill.name}:\n${skill.instructions ?? ""}`;
+        tokens += estimateTextTokens(text);
+        bytes += estimateTextBytes(text);
+    }
+    if (tools?.length) {
+        const text = `Available tools:\n${tools.map((tool) => `- ${tool.name}${tool.description ? `: ${tool.description}` : ""}`).join("\n")}`;
+        tokens += estimateTextTokens(text);
+        bytes += estimateTextBytes(text);
+    }
+    return { tokens, bytes };
+}
+function overBudget(cost, budget) {
+    if (budget.maxInputTokens !== undefined && cost.tokens > budget.maxInputTokens)
+        return true;
+    if (budget.maxInputBytes !== undefined && cost.bytes > budget.maxInputBytes)
+        return true;
+    return false;
+}
+function assertPositiveCap(value, name, hardMax) {
+    if (!Number.isSafeInteger(value) || value < 1 || value > hardMax) {
+        throw new TypeError(`contextBudget.${name} must be a safe integer from 1 to ${hardMax}`);
+    }
+}
+function isContextBudgetReport(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const report = value;
+    return Array.isArray(report.omitted)
+        && typeof report.keptTokens === "number"
+        && typeof report.keptBytes === "number"
+        && typeof report.truncated === "boolean";
+}
+function messageText(message) {
+    return message.content.map((part) => {
+        if (part.type === "text" || part.type === "thinking")
+            return part.text;
+        if (part.type === "tool_result")
+            return JSON.stringify(part.result ?? part.error ?? null);
+        if (part.type === "tool_call")
+            return `${part.name}(${JSON.stringify(part.arguments)})`;
+        if (part.type === "tool_call_delta")
+            return `${part.name ?? "tool"}(${part.argumentsText ?? ""})`;
+        if (part.type === "image")
+            return part.url ?? part.resourceUri ?? part.mimeType ?? "[image]";
+        if (part.type === "audio")
+            return part.transcript ?? part.name ?? part.url ?? part.resourceUri ?? part.mediaType ?? "[audio]";
+        if (part.type === "file")
+            return part.name ?? part.url ?? part.resourceUri ?? part.mediaType ?? "[file]";
+        if (part.type === "document")
+            return part.transcript ?? part.name ?? part.url ?? part.resourceUri ?? part.mediaType ?? "[document]";
+        return "[content]";
+    }).join("\n");
+}
+function contextBlockText(block) {
+    if (typeof block.content === "string")
+        return block.content;
+    return block.content.map((part) => {
+        if (part.type === "text" || part.type === "thinking")
+            return part.text;
+        return "[content]";
+    }).join("\n");
+}
+//# sourceMappingURL=context-budget.js.map

package/dist/contracts.d.ts

@@ -449,6 +449,10 @@ export interface AgentRunResumeOptions {
     readonly ownership?: OwnershipScope;
     readonly fencingToken?: number;
 }
+/** Bounded, abortable options for `resumeAgentRunStream()`. */
+export interface AgentRunResumeStreamOptions extends AgentRunResumeOptions, SubscribeOptions {
+    readonly signal?: AbortSignal;
+}
 export interface AgentRunRef {
     readonly runId: string;
     readonly sessionId?: string;
@@ -493,6 +497,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 +520,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 +1048,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 +1741,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 +1766,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,7 +1,7 @@
 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 { createAgent, createAgentSession, resumeAgentRun } from "./agents.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, resumeAgentRunStream } 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";
 export { createSecureAgent } from "./secure-agent.js";
@@ -11,7 +11,7 @@ export { CHECKPOINT_CONFLICT_CODE, CheckpointConflictError, createMemoryCheckpoi
 export { AGENT_RUN_STATE_NAMESPACE, AGENT_RUN_STATE_SCHEMA_VERSION, DEFAULT_MAX_AGENT_RUN_STATE_BYTES, HARD_MAX_AGENT_RUN_STATE_BYTES, agentFingerprint, loadAgentRunState } from "./agent-run-state.js";
 export type { StoredAgentRunState } from "./agent-run-state.js";
 export { createAgentRunLifecycle } from "./agent-run-lifecycle.js";
-export type { AgentRunLifecycle, AgentRunLifecycleAgent, AgentRunLifecycleOptions, AgentRunLifecycleRequest } from "./agent-run-lifecycle.js";
+export type { AgentRunLifecycle, AgentRunLifecycleAgent, AgentRunLifecycleOptions, AgentRunLifecycleRequest, AgentRunLifecycleStreamRequest } from "./agent-run-lifecycle.js";
 export type { MemoryCheckpointStoreOptions } from "./checkpoints.js";
 export { LEASE_CONFLICT_CODE, LeaseConflictError, createMemoryLeaseStore } from "./leases.js";
 export { createEventMultiplexer } from "./event-multiplexer.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.12";
 export declare const description = "Agent harness for AI providers, agents, sessions, and tools.";

package/dist/index.js

@@ -1,5 +1,5 @@
-export { isSessionEntryKind, SESSION_APPEND_CONFLICT_CODE, SESSION_ENTRY_KINDS, SESSION_ENTRY_SCHEMA_VERSION, SessionAppendConflictError, isSessionAppendConflict, AgentRunError, AgentRunStateError } from "./contracts.js";
-export { createAgent, createAgentSession, resumeAgentRun } from "./agents.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, resumeAgentRunStream } 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";
 export { createMemoryRunFeedbackStore, prepareRunFeedback, requireRunFeedbackOwnership, runFeedbackPageLimit, RunFeedbackError, } from "./feedback.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.12";
 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[]>;