@arnilo/prism 0.3.2 → 0.5.0

package/dist/contracts-core/speech.d.ts

@@ -0,0 +1,39 @@
+/** Provider-neutral speech synthesis contract (plan 061 Task 3).
+ *  Text→audio bytes plus a streaming variant whose first chunk resolves as soon as the
+ *  provider starts responding. Adapters enforce input caps with typed errors — they never
+ *  silently truncate. Audio bytes use `Uint8Array`/`ReadableStream` (repo convention). */
+import type { ModelCapabilities, ModelConfig } from "./content.js";
+export interface SpeechRequest {
+    readonly model: string;
+    readonly input: string;
+    /** Provider voice id, e.g. `alloy`. Adapter default when omitted. */
+    readonly voice?: string;
+    /** Audio container, e.g. `mp3`, `wav`, `opus`. Adapter default when omitted. */
+    readonly format?: string;
+    /** Playback speed multiplier (e.g. 0.25–4.0 on OpenAI). */
+    readonly speed?: number;
+    readonly signal?: AbortSignal;
+}
+export interface SpeechResult {
+    readonly audio: Uint8Array;
+    /** Actual audio container of `audio` (request value or provider default). */
+    readonly format: string;
+}
+export interface SpeechStreamResult {
+    /** Audio chunks in order; the first chunk is available as soon as the provider responds. */
+    readonly audio: ReadableStream<Uint8Array>;
+    /** Actual audio container of the stream (request value or provider default). */
+    readonly format: string;
+}
+export interface SpeechProvider {
+    readonly id: string;
+    synthesize(request: SpeechRequest): Promise<SpeechResult>;
+    synthesizeStream(request: SpeechRequest): Promise<SpeechStreamResult>;
+}
+export type SpeechErrorCode = "empty_input" | "input_too_large" | "request_failed" | "response_malformed" | "unsupported_model";
+export declare class SpeechError extends Error {
+    readonly code: SpeechErrorCode;
+    constructor(code: SpeechErrorCode, message: string);
+}
+export declare function modelSupportsSpeech(capabilities?: ModelCapabilities): boolean;
+export declare function assertSpeechSupported(model: ModelConfig): void;

package/dist/contracts-core/speech.js

@@ -0,0 +1,17 @@
+export class SpeechError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "SpeechError";
+        this.code = code;
+    }
+}
+export function modelSupportsSpeech(capabilities) {
+    return capabilities?.speech === true;
+}
+export function assertSpeechSupported(model) {
+    if (!modelSupportsSpeech(model.capabilities)) {
+        throw new SpeechError("unsupported_model", `Model ${model.provider}/${model.model} does not declare the speech capability`);
+    }
+}
+//# sourceMappingURL=speech.js.map

package/dist/contracts-core/transcription.d.ts

@@ -0,0 +1,48 @@
+/** Provider-neutral transcription contract (plan 061 Task 3).
+ *  One-shot audio→text plus a streaming variant yielding partials; both share the
+ *  `TranscriptDelta` event type aligned with `RealtimeEvent.transcript_delta` naming.
+ *  Adapters enforce audio byte caps with typed errors — they never silently truncate. */
+import type { ModelCapabilities, ModelConfig, Usage } from "./content.js";
+export interface TranscriptionRequest {
+    readonly model: string;
+    /** Audio bytes to transcribe. */
+    readonly audio: Uint8Array;
+    /** Audio container hint, e.g. `wav`, `mp3`; the adapter maps it to an upload filename. */
+    readonly format?: string;
+    /** ISO-639-1 hint, e.g. `en`. */
+    readonly language?: string;
+    /** Optional spelling/style hint text. */
+    readonly prompt?: string;
+    readonly signal?: AbortSignal;
+}
+export interface TranscriptionResult {
+    readonly text: string;
+    /** Provider-reported token usage; absent when the provider does not report it. */
+    readonly usage?: Usage;
+}
+/** Partial transcript. Naming mirrors `RealtimeEvent.transcript_delta` (no `role` —
+ *  one-shot transcription has no speaker turn). */
+export interface TranscriptDelta {
+    readonly type: "transcript_delta";
+    readonly text: string;
+}
+/** Terminal event: final full text plus optional usage. Exactly one per stream. */
+export interface TranscriptDone {
+    readonly type: "done";
+    readonly text: string;
+    readonly usage?: Usage;
+}
+export type TranscriptEvent = TranscriptDelta | TranscriptDone;
+export interface TranscriptionProvider {
+    readonly id: string;
+    transcribe(request: TranscriptionRequest): Promise<TranscriptionResult>;
+    /** Yields `transcript_delta` partials in order, then exactly one `done`. */
+    transcribeStream(request: TranscriptionRequest): AsyncIterable<TranscriptEvent>;
+}
+export type TranscriptionErrorCode = "empty_input" | "audio_too_large" | "request_failed" | "response_malformed" | "unsupported_model";
+export declare class TranscriptionError extends Error {
+    readonly code: TranscriptionErrorCode;
+    constructor(code: TranscriptionErrorCode, message: string);
+}
+export declare function modelSupportsTranscription(capabilities?: ModelCapabilities): boolean;
+export declare function assertTranscriptionSupported(model: ModelConfig): void;

package/dist/contracts-core/transcription.js

@@ -0,0 +1,17 @@
+export class TranscriptionError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "TranscriptionError";
+        this.code = code;
+    }
+}
+export function modelSupportsTranscription(capabilities) {
+    return capabilities?.transcription === true;
+}
+export function assertTranscriptionSupported(model) {
+    if (!modelSupportsTranscription(model.capabilities)) {
+        throw new TranscriptionError("unsupported_model", `Model ${model.provider}/${model.model} does not declare the transcription capability`);
+    }
+}
+//# sourceMappingURL=transcription.js.map

package/dist/contracts-core/video.d.ts

@@ -0,0 +1,61 @@
+/** Provider-neutral video generation contract (plan 061 Task 5).
+ *
+ * Minimal submit/status shape — video jobs run minutes, not seconds, so unlike
+ * image generation there is no synchronous `generate`. Hosts poll `status`
+ * (or a fake transport in conformance runs) and own download/persistence of
+ * the resulting video. Input video as a chat content part is the typed
+ * `VideoContent` block with the `"video"` input capability (see content.ts).
+ */
+import type { ImageContent, ModelCapabilities, ModelConfig, Usage } from "./content.js";
+/** States mirror the DashScope/OpenAI async job lifecycle; terminal states are
+ *  `succeeded` and `failed`. */
+export type VideoGenerationJobState = "queued" | "running" | "succeeded" | "failed";
+export type VideoGenerationErrorCode = "empty_input" | "input_too_large" | "unsupported_model" | "request_failed" | "response_malformed" | "unsupported_operation";
+export declare class VideoGenerationError extends Error {
+    readonly code: VideoGenerationErrorCode;
+    constructor(code: VideoGenerationErrorCode, message: string);
+}
+export declare function modelSupportsVideoGeneration(capabilities?: ModelCapabilities): boolean;
+export declare function assertVideoGenerationSupported(model: ModelConfig): void;
+/** Video generation request: text-to-video by default; pass `images` (first
+ *  entry wins) for image-to-video providers. Provider-defined vocabulary for
+ *  `size` (e.g. `1280x720`), `durationSeconds`, and `fps`. */
+export interface VideoGenerationRequest {
+    readonly model: string;
+    readonly prompt: string;
+    readonly images?: readonly ImageContent[];
+    readonly size?: string;
+    readonly durationSeconds?: number;
+    readonly fps?: number;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly signal?: AbortSignal;
+}
+/** Provider job handle from `submit`; poll with `status(jobId)`. */
+export interface VideoGenerationJobHandle {
+    readonly jobId: string;
+}
+/** The generated video. At least one of `bytes` or `url` is present when the
+ *  job succeeded; provenance (`provider`/`model`) is always preserved. */
+export interface GeneratedVideo {
+    readonly bytes?: Uint8Array;
+    readonly url?: string;
+    readonly mimeType?: string;
+    readonly provider: string;
+    readonly model: string;
+    readonly durationSeconds?: number;
+}
+/** Point-in-time job state; `video` only on `succeeded`, `error` only on `failed`. */
+export interface VideoGenerationJob {
+    readonly jobId: string;
+    readonly state: VideoGenerationJobState;
+    readonly video?: GeneratedVideo;
+    readonly error?: string;
+    readonly usage?: Usage;
+}
+export interface VideoGenerationProvider {
+    readonly id: string;
+    /** Submit a job; never blocks on generation. */
+    submit(request: VideoGenerationRequest): Promise<VideoGenerationJobHandle>;
+    /** Point-in-time status probe — host-owned polling loop. */
+    status(jobId: string, signal?: AbortSignal): Promise<VideoGenerationJob>;
+}

package/dist/contracts-core/video.js

@@ -0,0 +1,17 @@
+export class VideoGenerationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "VideoGenerationError";
+        this.code = code;
+    }
+}
+export function modelSupportsVideoGeneration(capabilities) {
+    return capabilities?.videoGeneration === true;
+}
+export function assertVideoGenerationSupported(model) {
+    if (!modelSupportsVideoGeneration(model.capabilities)) {
+        throw new VideoGenerationError("unsupported_model", `Model ${model.provider}/${model.model} does not declare the videoGeneration capability`);
+    }
+}
+//# sourceMappingURL=video.js.map

package/dist/contracts-core.d.ts

@@ -3,12 +3,19 @@
  * of `./contracts-core.js` is unchanged (0.1.4 barrel precedent). */
 export type { AudioContent, DocumentContent, FileContent } from "./content.js";
 export * from "./contracts-core/agent.js";
+export * from "./contracts-core/batch.js";
 export * from "./contracts-core/compaction.js";
 export * from "./contracts-core/content.js";
+export * from "./contracts-core/embeddings.js";
 export * from "./contracts-core/extensions.js";
+export * from "./contracts-core/images.js";
 export * from "./contracts-core/loop.js";
+export * from "./contracts-core/moderation.js";
 export * from "./contracts-core/persistence.js";
 export * from "./contracts-core/provider.js";
 export * from "./contracts-core/resources.js";
 export * from "./contracts-core/run-limits.js";
 export * from "./contracts-core/session.js";
+export * from "./contracts-core/speech.js";
+export * from "./contracts-core/transcription.js";
+export * from "./contracts-core/video.js";

package/dist/contracts-core.js

@@ -1,11 +1,18 @@
 export * from "./contracts-core/agent.js";
+export * from "./contracts-core/batch.js";
 export * from "./contracts-core/compaction.js";
 export * from "./contracts-core/content.js";
+export * from "./contracts-core/embeddings.js";
 export * from "./contracts-core/extensions.js";
+export * from "./contracts-core/images.js";
 export * from "./contracts-core/loop.js";
+export * from "./contracts-core/moderation.js";
 export * from "./contracts-core/persistence.js";
 export * from "./contracts-core/provider.js";
 export * from "./contracts-core/resources.js";
 export * from "./contracts-core/run-limits.js";
 export * from "./contracts-core/session.js";
+export * from "./contracts-core/speech.js";
+export * from "./contracts-core/transcription.js";
+export * from "./contracts-core/video.js";
 //# sourceMappingURL=contracts-core.js.map

package/dist/contracts-protocol.d.ts

@@ -57,6 +57,17 @@ export type RealtimeEvent = {
 /** Neutral bidirectional realtime session seam. The provider owns the transport
  *  (e.g. WebSocket); the host owns audio capture/playback and session lifecycle. */
 export type InputAssemblyLayout = "legacy" | "cache_aware";
+/** Opaque provenance ref for the resolved prompt version that produced a run
+ *  (plan 042). Identity only — never prompt content; the body is recoverable
+ *  from the prompt store via `hash`. */
+export interface PromptVersionRef {
+    /** Prompt name within the host's prompt store. */
+    readonly name: string;
+    /** Immutable version number assigned by the prompt store. */
+    readonly version: number;
+    /** Content hash of the exact UTF-8 body bytes: `sha256:<64 lowercase hex>`. */
+    readonly hash: string;
+}
 export interface RunOptions {
     readonly signal?: AbortSignal;
     readonly model?: ModelConfig;
@@ -84,6 +95,9 @@ export interface RunOptions {
     readonly activateAllSkills?: true;
     /** Progressive: catalog (name+description) unless loaded; eager: full instructions every turn. Default progressive. */
     readonly skillsDisclosure?: import("./skill-disclosure.js").SkillsDisclosure;
+    /** Tools disclosure: "all" (default) sends every active tool schema; "search" sends top-k + the generated `search_tools` tool. */
+    readonly toolsDisclosure?: import("./tool-search.js").ToolsDisclosure;
+    readonly toolsSearch?: import("./tool-search.js").ToolsSearchOptions;
     /** Opt-in projection-only fold for aged large tool results in provider view; store untouched. */
     readonly toolResultFold?: import("./tool-result-fold.js").ToolResultFoldOptions;
     readonly instructionInjectors?: readonly InstructionInjector[];
@@ -93,6 +107,8 @@ export interface RunOptions {
     readonly guardrails?: Guardrails;
     /** Opt-in durable interruption/checkpointing. */
     readonly runState?: AgentRunStateOptions;
+    /** Prompt provenance: copied verbatim onto this run's start and finish ledger records. */
+    readonly promptVersion?: PromptVersionRef;
 }
 export interface ProviderTurnMetadata {
     readonly providerId: string;
@@ -493,6 +509,8 @@ export interface RunRecord extends OwnershipScope {
     readonly abortReason?: string;
     readonly error?: ErrorInfo;
     readonly metadata?: Readonly<Record<string, unknown>>;
+    /** Provenance ref copied from `RunOptions.promptVersion` when the host supplied one. */
+    readonly promptVersion?: PromptVersionRef;
 }
 export type AgentEventType = AgentEvent["type"];
 /** Stored agent event ledger row. The `event` payload should be redacted before storage when secrets are present. */

package/dist/contracts-run-state.d.ts

@@ -1,6 +1,5 @@
-import type { AgentSessionCloneOptions, AgentSessionForkOptions, CompactionOptions, CompactionResult, ContentBlock, ErrorInfo, JsonObject, JsonValue, Message, ModelConfig, RunLimitBreach, SessionEntry, ToolCallContent, Usage } from "./contracts-core.js";
+import type { AgentSessionCloneOptions, AgentSessionForkOptions, CheckpointStore, CompactionOptions, CompactionResult, ContentBlock, ErrorInfo, JsonObject, JsonValue, Message, ModelConfig, OwnershipScope, RunLimitBreach, SessionEntry, SubscribeOptions, ToolCallContent, Usage } from "./contracts-core.js";
 import type { AgentEvent, RunOptions, ToolEffectKind } from "./contracts-protocol.js";
-import type { CheckpointStore, OwnershipScope, SubscribeOptions } from "./contracts-core.js";
 export type AgentRunStatus = "succeeded" | "failed" | "aborted" | "suspended" | "denied";
 export type AgentRunInterruptionKind = "input_guardrail" | "tool_approval" | "elicitation";
 export type ApprovalOutcome = "allow_once" | "allow_for_run" | "reject_once" | "reject_for_run";

package/dist/index.d.ts

@@ -13,6 +13,8 @@ export type { ApplyCacheControlOptions, CacheControlledContentBlock, CacheContro
 export { applyCacheControl, cacheHitRate, cacheSavings, cacheUsageReport, mapCacheRetention, resolveBreakpoint, sanitizeCacheKey, systemCacheControlField, } from "./cache-helpers.js";
 export type { CacheTelemetry, CacheTelemetryOptions, CacheTelemetryReport, CacheTelemetrySample, } from "./cache-telemetry.js";
 export { CACHE_TELEMETRY_OVERFLOW_KEY, CacheTelemetryError, createCacheTelemetry, DEFAULT_CACHE_TELEMETRY_CAP, } from "./cache-telemetry.js";
+export type { ProviderCapture, ProviderCaptureEntry, ProviderCaptureOptions, ProviderCapturePolicy } from "./capture.js";
+export { createProviderCapture } from "./capture.js";
 export type { MemoryCheckpointStoreOptions } from "./checkpoints.js";
 export { CHECKPOINT_CONFLICT_CODE, CheckpointConflictError, createMemoryCheckpointStore } from "./checkpoints.js";
 export type { DefaultCompactionStrategyOptions } from "./compaction.js";
@@ -25,7 +27,7 @@ export type { ContextBudget, ContextBudgetMessageGroups, ContextBudgetOmission,
 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 * from "./contracts.js";
 export type { ApprovalOutcome, DecisionScope, NestedRunApproval, NestedRunOutcome, NestedRunRef, PendingDecision, PendingDecisionKind, ProviderResolver, RealtimeCaps, RealtimeEvent, RealtimeSession, RealtimeSessionFactory, RealtimeSessionOptions, ResumeNestedRun, RunDecision, RunLimitCounters, RunLimitName, SecureAgentOptions, StickyDecision, ToolCallAuthority, ToolEffectClassifier, ToolEffectDeclaration, ToolEffectIdempotency, ToolEffectKey, ToolEffectKind, ToolEffectRecord, ToolEffectStatus, ToolEffectStore, ToolEffectTransition, ToolElicitationRequest, } from "./contracts.js";
-export { AgentDecisionError, AgentDelegationSuspendedError, AgentLoopStateError, AgentRunError, AgentRunStateError, assertSessionMetadataKey, DEFAULT_MAX_PENDING_DECISIONS, DEFAULT_MAX_PENDING_STEER_BYTES, DEFAULT_MAX_PENDING_STEERS, DEFAULT_MAX_SESSION_SEARCH_CURSOR_BYTES, DEFAULT_MAX_SESSION_SEARCH_FTS_CANDIDATES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_BYTES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_ENTRIES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_SESSIONS, DEFAULT_MAX_SESSION_SEARCH_QUERY_BYTES, DEFAULT_MAX_SESSION_SEARCH_SNIPPET_BYTES, DEFAULT_MAX_STICKY_DECISIONS, DEFAULT_SESSION_SEARCH_LIMIT, HARD_MAX_ACTION_CONSTRAINT_BYTES, HARD_MAX_ACTION_CONSTRAINTS, HARD_MAX_DECISION_REASON_BYTES, HARD_MAX_ELICITATION_BYTES, HARD_MAX_PENDING_DECISIONS, HARD_MAX_PENDING_STEER_BYTES, HARD_MAX_PENDING_STEERS, HARD_MAX_SESSION_SEARCH_CURSOR_BYTES, HARD_MAX_SESSION_SEARCH_FTS_CANDIDATES, HARD_MAX_SESSION_SEARCH_LIMIT, HARD_MAX_SESSION_SEARCH_LINEAR_BYTES, HARD_MAX_SESSION_SEARCH_LINEAR_ENTRIES, HARD_MAX_SESSION_SEARCH_LINEAR_SESSIONS, HARD_MAX_SESSION_SEARCH_QUERY_BYTES, HARD_MAX_SESSION_SEARCH_SNIPPET_BYTES, HARD_MAX_STICKY_DECISIONS, isSessionAppendConflict, isSessionEntryKind, isSessionMetadataConflict, isSessionSearchUnsupported, MAX_ACTION_CONSTRAINT_BYTES, MAX_ACTION_CONSTRAINTS, MAX_ATTRIBUTION_DEPTH, MAX_DECISION_REASON_BYTES, MAX_ELICITATION_BYTES, resolveSessionSearchQuery, SESSION_APPEND_CONFLICT_CODE, SESSION_ENTRY_KINDS, SESSION_ENTRY_SCHEMA_VERSION, SESSION_METADATA_CONFLICT_CODE, SESSION_SEARCH_UNSUPPORTED_CODE, SESSION_SEARCH_WORKSPACE_METADATA_KEY, SessionAppendConflictError, SessionMetadataConflictError, SessionSearchUnsupportedError, } from "./contracts.js";
+export { AgentDecisionError, AgentDelegationSuspendedError, AgentLoopStateError, AgentRunError, AgentRunStateError, assertBatchJobsSupported, assertEmbeddingsSupported, assertImageGenerationSupported, assertModerationSupported, assertSessionMetadataKey, assertSpeechSupported, assertTranscriptionSupported, assertVideoGenerationSupported, BatchJobsError, DEFAULT_MAX_PENDING_DECISIONS, DEFAULT_MAX_PENDING_STEER_BYTES, DEFAULT_MAX_PENDING_STEERS, DEFAULT_MAX_SESSION_SEARCH_CURSOR_BYTES, DEFAULT_MAX_SESSION_SEARCH_FTS_CANDIDATES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_BYTES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_ENTRIES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_SESSIONS, DEFAULT_MAX_SESSION_SEARCH_QUERY_BYTES, DEFAULT_MAX_SESSION_SEARCH_SNIPPET_BYTES, DEFAULT_MAX_STICKY_DECISIONS, DEFAULT_SESSION_SEARCH_LIMIT, EmbeddingsError, HARD_MAX_ACTION_CONSTRAINT_BYTES, HARD_MAX_ACTION_CONSTRAINTS, HARD_MAX_DECISION_REASON_BYTES, HARD_MAX_ELICITATION_BYTES, HARD_MAX_PENDING_DECISIONS, HARD_MAX_PENDING_STEER_BYTES, HARD_MAX_PENDING_STEERS, HARD_MAX_SESSION_SEARCH_CURSOR_BYTES, HARD_MAX_SESSION_SEARCH_FTS_CANDIDATES, HARD_MAX_SESSION_SEARCH_LIMIT, HARD_MAX_SESSION_SEARCH_LINEAR_BYTES, HARD_MAX_SESSION_SEARCH_LINEAR_ENTRIES, HARD_MAX_SESSION_SEARCH_LINEAR_SESSIONS, HARD_MAX_SESSION_SEARCH_QUERY_BYTES, HARD_MAX_SESSION_SEARCH_SNIPPET_BYTES, HARD_MAX_STICKY_DECISIONS, ImageGenerationError, isBatchJobTerminal, isSessionAppendConflict, isSessionEntryKind, isSessionMetadataConflict, isSessionSearchUnsupported, MAX_ACTION_CONSTRAINT_BYTES, MAX_ACTION_CONSTRAINTS, MAX_ATTRIBUTION_DEPTH, MAX_DECISION_REASON_BYTES, MAX_ELICITATION_BYTES, ModerationError, modelSupportsBatchJobs, modelSupportsEmbeddings, modelSupportsImageGeneration, modelSupportsModeration, modelSupportsSpeech, modelSupportsTranscription, modelSupportsVideoGeneration, pollBatch, resolveSessionSearchQuery, SESSION_APPEND_CONFLICT_CODE, SESSION_ENTRY_KINDS, SESSION_ENTRY_SCHEMA_VERSION, SESSION_METADATA_CONFLICT_CODE, SESSION_SEARCH_UNSUPPORTED_CODE, SESSION_SEARCH_WORKSPACE_METADATA_KEY, SessionAppendConflictError, SessionMetadataConflictError, SessionSearchUnsupportedError, SpeechError, TranscriptionError, VideoGenerationError, } from "./contracts.js";
 export { parseAgentFile, parseSkillFile } from "./contribution-parsing.js";
 export type { ContributionRegistries, ContributionRegistriesOptions, ContributionRegistry, ContributionRegistryOptions, } from "./contributions.js";
 export { createContributionRegistries, createContributionRegistry, registerDiscoveredContributions } from "./contributions.js";
@@ -104,16 +106,18 @@ export type { ComposeSystemPromptOptions } from "./system-prompts.js";
 export { composeSystemPrompt, mergeSystemPromptConfig } from "./system-prompts.js";
 export { assertAgentEventSourceConforms } from "./testing/agent-event-source-conformance.js";
 export type { ThinkingCompatFamily, ThinkingLevel } from "./thinking.js";
-export { applyThinkingLevel, isThinkingLevel, normalizeThinkingLevel, THINKING_LEVELS, thinkingCompatFor, thinkingFamilyForModel, } from "./thinking.js";
+export { applyThinkingLevel, applyThinkingLevelForModel, isSupportedThinkingLevel, isThinkingLevel, normalizeThinkingLevel, parseThinkingLevel, snapThinkingLevel, THINKING_LEVELS, thinkingCompatFor, thinkingFamilyForModel, thinkingLevelsForModel, } from "./thinking.js";
 export type { ToolEffectErrorCode } from "./tool-effects.js";
 export { createMemoryToolEffectStore, ToolEffectError } from "./tool-effects.js";
 export type { FoldToolResultsContext, ResolvedToolResultFoldOptions, ToolResultFoldInput, ToolResultFoldOptions, } from "./tool-result-fold.js";
 export { DEFAULT_TOOL_RESULT_FOLD_MAX_SUMMARY_BYTES, DEFAULT_TOOL_RESULT_FOLD_MIN_AGE_TURNS, DEFAULT_TOOL_RESULT_FOLD_MIN_BYTES, foldedToolResultHeader, foldToolResultHistory, foldToolResults, formatFoldedToolResult, HARD_TOOL_RESULT_FOLD_MAX_SUMMARY_BYTES, resolveToolResultFold, TOOL_RESULT_FOLD_TURN_METADATA_KEY, } from "./tool-result-fold.js";
+export type { ActiveToolSet, ToolSearchIndex, ToolSearchMatch, ToolSearchState, ToolsDisclosure, ToolsSearchOptions, } from "./tool-search.js";
+export { createActiveToolSet, createSearchToolsTool, createToolSearchIndex, createToolSearchState, DEFAULT_MAX_TOOLS_SEARCH_QUERY_BYTES, DEFAULT_TOOLS_SEARCH_TOP_K, HARD_MAX_TOOLS_INDEX, HARD_MAX_TOOLS_SEARCH_QUERY_BYTES, HARD_MAX_TOOLS_SEARCH_TOP_K, isToolDisclosureError, resolveToolsDisclosure, SEARCH_TOOLS_TOOL_NAME, scoreTools, selectDisclosedTools, TOOL_DISCLOSURE_ERROR_CODE, ToolDisclosureError, } from "./tool-search.js";
 export type { DispatchToolCallOptions, ToolArgumentValidationError, ToolArgumentValidationResult, ToolArgumentValidator, ToolFilter, ToolFilterInput, ToolParameterValidatorOptions, ToolRegistryOptions, ToolValidator, } from "./tools.js";
 export { createToolParameterValidator, createToolRegistry, dispatchToolCall, filterTools } from "./tools.js";
 export { trimTrailingSlashes } from "./trim-trailing-slashes.js";
 export type { ResolvedUseCaseModel, ResolveUseCaseModelInput, UseCaseModelBinding, } from "./use-case-model.js";
 export { resolveUseCaseModel, resolveUseCaseModelBinding, useCaseCredentialProviderId, } from "./use-case-model.js";
 export declare const name = "prism";
-export declare const version = "0.3.2";
+export declare const version = "0.5.0";
 export declare const description = "Agent harness for AI providers, agents, sessions, and tools.";

package/dist/index.js

@@ -7,12 +7,13 @@ export { createAgent, createAgentSession, resumeAgentRun, resumeAgentRunStream }
 export { ARTIFACT_BODY_ERROR_CODES, ARTIFACT_CHECKPOINT_NAMESPACE, ArtifactBodyStoreError, ArtifactError, artifactApprovalState, artifactCheckpointKey, } from "./artifacts.js";
 export { applyCacheControl, cacheHitRate, cacheSavings, cacheUsageReport, mapCacheRetention, resolveBreakpoint, sanitizeCacheKey, systemCacheControlField, } from "./cache-helpers.js";
 export { CACHE_TELEMETRY_OVERFLOW_KEY, CacheTelemetryError, createCacheTelemetry, DEFAULT_CACHE_TELEMETRY_CAP, } from "./cache-telemetry.js";
+export { createProviderCapture } from "./capture.js";
 export { CHECKPOINT_CONFLICT_CODE, CheckpointConflictError, createMemoryCheckpointStore } from "./checkpoints.js";
 export { createDefaultCompactionStrategy, isCompactionEntryData } from "./compaction.js";
 export { assertJsonObject, isJsonObject, loadConfigLayers, mergeConfigLayers } from "./config.js";
 export { assertDeclaredMediaTypeMatches, assertMediaBlocksWithinBounds, assertMessagesSupportModelCapabilities, assertModelSupportsContentBlocks, assertSsrfAllowedUrl, collectMessageContentBlocks, contentBlockInputModality, DEFAULT_MAX_AUDIO_DURATION_MS, DEFAULT_MAX_MEDIA_ITEM_BYTES, DEFAULT_MAX_MEDIA_ITEMS_PER_REQUEST, DEFAULT_MAX_MEDIA_REQUEST_BYTES, DEFAULT_MEDIA_FETCH_TIMEOUT_MS, loadBoundedBinaryResource, MediaContentError, MODEL_INPUT_CAPABILITIES, resolveMediaContentBlock, resolveMediaContentBlocks, sniffMediaMimeType, UnsupportedModalityError, } from "./content.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 { AgentDecisionError, AgentDelegationSuspendedError, AgentLoopStateError, AgentRunError, AgentRunStateError, assertSessionMetadataKey, DEFAULT_MAX_PENDING_DECISIONS, DEFAULT_MAX_PENDING_STEER_BYTES, DEFAULT_MAX_PENDING_STEERS, DEFAULT_MAX_SESSION_SEARCH_CURSOR_BYTES, DEFAULT_MAX_SESSION_SEARCH_FTS_CANDIDATES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_BYTES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_ENTRIES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_SESSIONS, DEFAULT_MAX_SESSION_SEARCH_QUERY_BYTES, DEFAULT_MAX_SESSION_SEARCH_SNIPPET_BYTES, DEFAULT_MAX_STICKY_DECISIONS, DEFAULT_SESSION_SEARCH_LIMIT, HARD_MAX_ACTION_CONSTRAINT_BYTES, HARD_MAX_ACTION_CONSTRAINTS, HARD_MAX_DECISION_REASON_BYTES, HARD_MAX_ELICITATION_BYTES, HARD_MAX_PENDING_DECISIONS, HARD_MAX_PENDING_STEER_BYTES, HARD_MAX_PENDING_STEERS, HARD_MAX_SESSION_SEARCH_CURSOR_BYTES, HARD_MAX_SESSION_SEARCH_FTS_CANDIDATES, HARD_MAX_SESSION_SEARCH_LIMIT, HARD_MAX_SESSION_SEARCH_LINEAR_BYTES, HARD_MAX_SESSION_SEARCH_LINEAR_ENTRIES, HARD_MAX_SESSION_SEARCH_LINEAR_SESSIONS, HARD_MAX_SESSION_SEARCH_QUERY_BYTES, HARD_MAX_SESSION_SEARCH_SNIPPET_BYTES, HARD_MAX_STICKY_DECISIONS, isSessionAppendConflict, isSessionEntryKind, isSessionMetadataConflict, isSessionSearchUnsupported, MAX_ACTION_CONSTRAINT_BYTES, MAX_ACTION_CONSTRAINTS, MAX_ATTRIBUTION_DEPTH, MAX_DECISION_REASON_BYTES, MAX_ELICITATION_BYTES, resolveSessionSearchQuery, SESSION_APPEND_CONFLICT_CODE, SESSION_ENTRY_KINDS, SESSION_ENTRY_SCHEMA_VERSION, SESSION_METADATA_CONFLICT_CODE, SESSION_SEARCH_UNSUPPORTED_CODE, SESSION_SEARCH_WORKSPACE_METADATA_KEY, SessionAppendConflictError, SessionMetadataConflictError, SessionSearchUnsupportedError, } from "./contracts.js";
+export { AgentDecisionError, AgentDelegationSuspendedError, AgentLoopStateError, AgentRunError, AgentRunStateError, assertBatchJobsSupported, assertEmbeddingsSupported, assertImageGenerationSupported, assertModerationSupported, assertSessionMetadataKey, assertSpeechSupported, assertTranscriptionSupported, assertVideoGenerationSupported, BatchJobsError, DEFAULT_MAX_PENDING_DECISIONS, DEFAULT_MAX_PENDING_STEER_BYTES, DEFAULT_MAX_PENDING_STEERS, DEFAULT_MAX_SESSION_SEARCH_CURSOR_BYTES, DEFAULT_MAX_SESSION_SEARCH_FTS_CANDIDATES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_BYTES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_ENTRIES, DEFAULT_MAX_SESSION_SEARCH_LINEAR_SESSIONS, DEFAULT_MAX_SESSION_SEARCH_QUERY_BYTES, DEFAULT_MAX_SESSION_SEARCH_SNIPPET_BYTES, DEFAULT_MAX_STICKY_DECISIONS, DEFAULT_SESSION_SEARCH_LIMIT, EmbeddingsError, HARD_MAX_ACTION_CONSTRAINT_BYTES, HARD_MAX_ACTION_CONSTRAINTS, HARD_MAX_DECISION_REASON_BYTES, HARD_MAX_ELICITATION_BYTES, HARD_MAX_PENDING_DECISIONS, HARD_MAX_PENDING_STEER_BYTES, HARD_MAX_PENDING_STEERS, HARD_MAX_SESSION_SEARCH_CURSOR_BYTES, HARD_MAX_SESSION_SEARCH_FTS_CANDIDATES, HARD_MAX_SESSION_SEARCH_LIMIT, HARD_MAX_SESSION_SEARCH_LINEAR_BYTES, HARD_MAX_SESSION_SEARCH_LINEAR_ENTRIES, HARD_MAX_SESSION_SEARCH_LINEAR_SESSIONS, HARD_MAX_SESSION_SEARCH_QUERY_BYTES, HARD_MAX_SESSION_SEARCH_SNIPPET_BYTES, HARD_MAX_STICKY_DECISIONS, ImageGenerationError, isBatchJobTerminal, isSessionAppendConflict, isSessionEntryKind, isSessionMetadataConflict, isSessionSearchUnsupported, MAX_ACTION_CONSTRAINT_BYTES, MAX_ACTION_CONSTRAINTS, MAX_ATTRIBUTION_DEPTH, MAX_DECISION_REASON_BYTES, MAX_ELICITATION_BYTES, ModerationError, modelSupportsBatchJobs, modelSupportsEmbeddings, modelSupportsImageGeneration, modelSupportsModeration, modelSupportsSpeech, modelSupportsTranscription, modelSupportsVideoGeneration, pollBatch, resolveSessionSearchQuery, SESSION_APPEND_CONFLICT_CODE, SESSION_ENTRY_KINDS, SESSION_ENTRY_SCHEMA_VERSION, SESSION_METADATA_CONFLICT_CODE, SESSION_SEARCH_UNSUPPORTED_CODE, SESSION_SEARCH_WORKSPACE_METADATA_KEY, SessionAppendConflictError, SessionMetadataConflictError, SessionSearchUnsupportedError, SpeechError, TranscriptionError, VideoGenerationError, } from "./contracts.js";
 export { parseAgentFile, parseSkillFile } from "./contribution-parsing.js";
 export { createContributionRegistries, createContributionRegistry, registerDiscoveredContributions } from "./contributions.js";
 export { CONVERSATION_METADATA_KEY, ConversationError, conversationMarkerMetadata, conversationThreadFromRecord, DEFAULT_MAX_CONVERSATION_CURSOR_BYTES, decodeConversationReplayCursor, encodeConversationReplayCursor, HARD_MAX_CONVERSATION_CURSOR_BYTES, } from "./conversations.js";
@@ -57,13 +58,14 @@ export { createSkillRegistry, resolveActiveSkills } from "./skills.js";
 export { artifactStructuredOutputRequest, assertStructuredOutputRequestSupported, DEFAULT_MAX_STRUCTURED_OUTPUT_NAME_LENGTH, DEFAULT_MAX_STRUCTURED_OUTPUT_SCHEMA_BYTES, modelSupportsStructuredOutput, resolveRunProviderOptions, StructuredOutputError, validateStructuredOutputOptions, withoutStructuredOutput, } from "./structured-output.js";
 export { composeSystemPrompt, mergeSystemPromptConfig } from "./system-prompts.js";
 export { assertAgentEventSourceConforms } from "./testing/agent-event-source-conformance.js";
-export { applyThinkingLevel, isThinkingLevel, normalizeThinkingLevel, THINKING_LEVELS, thinkingCompatFor, thinkingFamilyForModel, } from "./thinking.js";
+export { applyThinkingLevel, applyThinkingLevelForModel, isSupportedThinkingLevel, isThinkingLevel, normalizeThinkingLevel, parseThinkingLevel, snapThinkingLevel, THINKING_LEVELS, thinkingCompatFor, thinkingFamilyForModel, thinkingLevelsForModel, } from "./thinking.js";
 export { createMemoryToolEffectStore, ToolEffectError } from "./tool-effects.js";
 export { DEFAULT_TOOL_RESULT_FOLD_MAX_SUMMARY_BYTES, DEFAULT_TOOL_RESULT_FOLD_MIN_AGE_TURNS, DEFAULT_TOOL_RESULT_FOLD_MIN_BYTES, foldedToolResultHeader, foldToolResultHistory, foldToolResults, formatFoldedToolResult, HARD_TOOL_RESULT_FOLD_MAX_SUMMARY_BYTES, resolveToolResultFold, TOOL_RESULT_FOLD_TURN_METADATA_KEY, } from "./tool-result-fold.js";
+export { createActiveToolSet, createSearchToolsTool, createToolSearchIndex, createToolSearchState, DEFAULT_MAX_TOOLS_SEARCH_QUERY_BYTES, DEFAULT_TOOLS_SEARCH_TOP_K, HARD_MAX_TOOLS_INDEX, HARD_MAX_TOOLS_SEARCH_QUERY_BYTES, HARD_MAX_TOOLS_SEARCH_TOP_K, isToolDisclosureError, resolveToolsDisclosure, SEARCH_TOOLS_TOOL_NAME, scoreTools, selectDisclosedTools, TOOL_DISCLOSURE_ERROR_CODE, ToolDisclosureError, } from "./tool-search.js";
 export { createToolParameterValidator, createToolRegistry, dispatchToolCall, filterTools } from "./tools.js";
 export { trimTrailingSlashes } from "./trim-trailing-slashes.js";
 export { resolveUseCaseModel, resolveUseCaseModelBinding, useCaseCredentialProviderId, } from "./use-case-model.js";
 export const name = "prism";
-export const version = "0.3.2";
+export const version = "0.5.0";
 export const description = "Agent harness for AI providers, agents, sessions, and tools.";
 //# sourceMappingURL=index.js.map

package/dist/input.d.ts

@@ -4,6 +4,7 @@ import type { MiddlewareRegistry } from "./middleware.js";
 import type { SecretRedactor } from "./redaction.js";
 import { type LoadedSkillSet, type SkillsDisclosure } from "./skill-disclosure.js";
 import { type ResolvedToolResultFoldOptions } from "./tool-result-fold.js";
+import { type ToolsDisclosure, type ToolsSearchOptions } from "./tool-search.js";
 export type AgentInput = string | Message | readonly Message[];
 export interface PromptInstruction {
     readonly text: string;
@@ -58,6 +59,13 @@ export interface AssembleProviderInputOptions extends DefaultInputBuildContext {
     readonly skillsDisclosure?: SkillsDisclosure;
     readonly loadedSkills?: LoadedSkillSet;
     readonly tools?: readonly ToolDefinition[];
+    /** Tools disclosure: "search" narrows the disclosed tool list (activated ∪ top-k); default "all" is unchanged. */
+    readonly toolsDisclosure?: ToolsDisclosure;
+    readonly toolsSearch?: ToolsSearchOptions;
+    /** Per-run activated names from `search_tools`; intersected at disclosure only — dispatch re-checks. */
+    readonly activatedTools?: {
+        has(name: string): boolean;
+    };
     readonly providerOptions?: ProviderRequestOptions;
     /** Assembler-time eviction; does not delete session store history. */
     readonly contextBudget?: ContextBudget;

package/dist/input.js

@@ -6,6 +6,7 @@ import { loadTextResource } from "./resources.js";
 import { skillMessages as buildSkillMessages } from "./skill-disclosure.js";
 import { composeSystemPrompt } from "./system-prompts.js";
 import { foldToolResultHistory, foldToolResults } from "./tool-result-fold.js";
+import { selectDisclosedTools } from "./tool-search.js";
 export function createDefaultInputBuilder() {
     return {
         name: "default-input",
@@ -120,6 +121,9 @@ export async function assembleProviderInput(options) {
     let context;
     let skills = options.skills;
     let tools = options.tools;
+    if (options.toolsDisclosure === "search" && tools?.length) {
+        tools = selectDisclosedTools({ tools, input: options.input, search: options.toolsSearch, activated: options.activatedTools });
+    }
     let demotedSkillBodies;
     let budgetReport;
     if (options.contextBudget) {

package/dist/node/agent-definitions.d.ts

@@ -1,4 +1,4 @@
-import type { Agent, AgentDefinitionResolutionContext, ContextProvider, DiscoveredContribution, ProviderResolver, ToolDefinition } from "../contracts.js";
+import type { Agent, AgentDefinitionResolutionContext, DiscoveredContribution, ProviderResolver } from "../contracts.js";
 import type { PermissionPolicy, TrustPolicy } from "../security.js";
 /** Options for {@link resolveAgentBundle}. */
 export interface ResolveAgentBundleOptions {
@@ -89,10 +89,3 @@ export declare function discoverAgentBundles(options: DiscoverAgentBundlesOption
  *  most once per call; resolution is one-shot, so no cross-call cache is kept
  *  (ponytail: add memoization only if a host resolves the same bundle repeatedly). */
 export declare function resolveAgentBundle(bundle: AgentBundle, options: ResolveAgentBundleOptions): Promise<Agent>;
-/** Parse a `CONTEXT.md` into a static {@link ContextProvider}. The markdown
- *  body becomes the context block content; frontmatter `name` overrides the
- *  directory name. */
-export declare function parseContextFile(text: string, path: string): ContextProvider;
-/** Parse a `TOOL.md` into a descriptor-only {@link ToolDefinition}. The
- *  executable behavior is host-owned; calling `execute` throws. */
-export declare function parseToolFile(text: string, path: string): ToolDefinition;

package/dist/node/agent-definitions.js

@@ -358,38 +358,4 @@ function parentDirName(path) {
     const parts = path.split(/[/\\]+/).filter(Boolean);
     return parts.length >= 2 ? parts[parts.length - 2] : (parts[parts.length - 1] ?? "");
 }
-/** Parse a `CONTEXT.md` into a static {@link ContextProvider}. The markdown
- *  body becomes the context block content; frontmatter `name` overrides the
- *  directory name. */
-export function parseContextFile(text, path) {
-    const { front, body } = splitFrontmatter(text, path);
-    const rawName = String(front.get("name") ?? "").trim() || parentDirName(path);
-    if (!NAME_RE.test(rawName)) {
-        throw new Error(`Invalid context provider name in ${path}: ${JSON.stringify(rawName)}`);
-    }
-    const name = rawName.replace(/\s+/g, "-");
-    const title = String(front.get("title") ?? name);
-    return {
-        name,
-        resolve: () => [{ title, content: body.replace(/^\n+/, "").trimEnd() }],
-    };
-}
-/** Parse a `TOOL.md` into a descriptor-only {@link ToolDefinition}. The
- *  executable behavior is host-owned; calling `execute` throws. */
-export function parseToolFile(text, path) {
-    const { front, body } = splitFrontmatter(text, path);
-    const rawName = String(front.get("name") ?? "").trim() || parentDirName(path);
-    if (!NAME_RE.test(rawName)) {
-        throw new Error(`Invalid tool name in ${path}: ${JSON.stringify(rawName)}`);
-    }
-    const name = rawName.replace(/\s+/g, "-");
-    const description = String(front.get("description") ?? "").trim() || body.replace(/^\n+/, "").slice(0, 80).trim();
-    return {
-        name,
-        ...(description ? { description } : {}),
-        execute: () => {
-            throw new Error(`Discovered tool ${name} requires host execution`);
-        },
-    };
-}
 //# sourceMappingURL=agent-definitions.js.map

package/dist/node/settings.d.ts

@@ -2,6 +2,5 @@ import { type ConfigLayer } from "../config.js";
 import type { SettingsProvider } from "../contracts.js";
 import { type NodeConfigFile } from "./config.js";
 export type NodeSettingsFile = NodeConfigFile;
-export declare function defaultUserSettingsPath(appName?: string): string;
 export declare function readSettingsFile(path: string): Promise<ConfigLayer["config"]>;
 export declare function loadSettingsFiles(files: readonly NodeSettingsFile[]): Promise<SettingsProvider>;

package/dist/node/settings.js

@@ -1,11 +1,6 @@
-import { homedir } from "node:os";
-import { join } from "node:path";
 import { mergeConfigLayers } from "../config.js";
 import { createStaticSettingsProvider } from "../settings.js";
 import { isNodeErrorCode, readConfigFile } from "./config.js";
-export function defaultUserSettingsPath(appName = "prism") {
-    return join(homedir(), ".config", appName, "settings.json");
-}
 export function readSettingsFile(path) {
     return readConfigFile(path);
 }

package/dist/pinned-fetch.js

@@ -99,7 +99,11 @@ export async function requestPinned(url, address, init, errorPrefix = "Request")
         const nodeRequest = request(url, {
             method,
             headers: Object.fromEntries(headers.entries()),
-            signal: init?.signal ?? undefined,
+            // NOTE: the caller signal is NOT passed as the http.request `signal` option:
+            // Node's internal abort wiring destroys the (possibly keep-alive, already
+            // completed) socket with the abort reason, surfacing it as an unhandled
+            // socket 'error' when the response resolved and nothing listens anymore.
+            // Abort is handled manually below with a reason-less destroy.
             lookup: ((_hostname, options, callback) => {
                 if (options.all)
                     callback(null, [{ address: address.address, family: address.family }]);
@@ -132,8 +136,13 @@ export async function requestPinned(url, address, init, errorPrefix = "Request")
                             controller.error(error);
                         }
                     },
-                    cancel(reason) {
-                        incoming.destroy(reason instanceof Error ? reason : undefined);
+                    cancel() {
+                        // Destroy WITHOUT the abort reason: once the response resolved,
+                        // nothing listens on the socket, and propagate-destroy(reason)
+                        // surfaces the DOMException as an unhandled socket 'error'
+                        // (SDK transports abort their controller on close()). Readers
+                        // that still pull observe EOF via the iterator.
+                        incoming.destroy();
                     },
                 });
             resolve(new Response(stream, {
@@ -143,12 +152,29 @@ export async function requestPinned(url, address, init, errorPrefix = "Request")
             }));
         });
         nodeRequest.on("error", reject);
+        if (init?.signal) {
+            const signal = init.signal;
+            if (signal.aborted) {
+                reject(abortReason(signal));
+                nodeRequest.destroy();
+            }
+            else {
+                signal.addEventListener("abort", () => {
+                    nodeRequest.destroy();
+                    reject(abortReason(signal));
+                }, { once: true });
+            }
+        }
         if (body)
             nodeRequest.end(body);
         else
             nodeRequest.end();
     });
 }
+function abortReason(signal) {
+    const reason = signal.reason;
+    return reason instanceof Error ? reason : new Error(String(reason));
+}
 async function requestBody(body, errorPrefix) {
     if (body === undefined || body === null)
         return undefined;

package/dist/provider-events.js

@@ -27,10 +27,9 @@ export function reconstructToolCallDeltas(events) {
         if (event.type !== "tool_call_delta")
             continue;
         const partial = partials.get(event.index) ?? { argumentsText: "" };
-        if (event.id !== undefined)
-            partial.id = event.id;
-        if (event.name !== undefined)
-            partial.name = event.name;
+        // Conformant OpenAI-compatible providers repeat identity as null on continuation chunks; coalesce like openai-compatible.js instead of clobbering.
+        partial.id = event.id ?? partial.id;
+        partial.name = event.name ?? partial.name;
         if (event.argumentsText !== undefined)
             partial.argumentsText += event.argumentsText;
         partials.set(event.index, partial);

package/dist/providers/media.d.ts

@@ -1,5 +1,5 @@
 import { type MediaContentBlock, type ModelInputCapability, type ResolvedMediaContent, type ResolveMediaContentOptions } from "../content.js";
-import type { AudioContent, ContentBlock, DocumentContent, FileContent, JsonObject, Message, ModelCapabilities, ModelConfig } from "../contracts.js";
+import type { ContentBlock, JsonObject, Message, ModelCapabilities, ModelConfig } from "../contracts.js";
 /** Default upload-cache entry cap per provider media session. */
 export declare const DEFAULT_PROVIDER_UPLOAD_CACHE_ENTRIES = 32;
 /** Inline OpenAI file_data ceiling before preferring Files API upload. */
@@ -37,7 +37,6 @@ export declare function serializePdfDocumentWireBlock(options: {
     readonly data: string;
     readonly title?: string;
 }): JsonObject;
-export declare function resolveProviderMediaBlock(block: AudioContent | FileContent | DocumentContent, options?: ResolveMediaContentOptions): Promise<ResolvedMediaContent>;
 /** Resolve every media block once and enforce aggregate request bounds before provider I/O. */
 export declare function resolveProviderMediaMessages(messages: readonly Message[], model: ModelConfig, options?: ResolveMediaContentOptions): Promise<ReadonlyMap<MediaContentBlock, ResolvedMediaContent>>;
 export declare function defaultProviderFilename(block: MediaContentBlock, fallback: string): string;

package/dist/providers/media.js

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { assertMessagesSupportModelCapabilities, contentBlockInputModality, DEFAULT_MAX_MEDIA_ITEM_BYTES, resolveMediaContentBlock, resolveMediaContentBlocks, UnsupportedModalityError, } from "../content.js";
+import { assertMessagesSupportModelCapabilities, contentBlockInputModality, DEFAULT_MAX_MEDIA_ITEM_BYTES, resolveMediaContentBlocks, UnsupportedModalityError, } from "../content.js";
 /** Default upload-cache entry cap per provider media session. */
 export const DEFAULT_PROVIDER_UPLOAD_CACHE_ENTRIES = 32;
 /** Inline OpenAI file_data ceiling before preferring Files API upload. */
@@ -93,9 +93,6 @@ export function serializePdfDocumentWireBlock(options) {
         ...(options.title ? { title: options.title } : {}),
     };
 }
-export async function resolveProviderMediaBlock(block, options = {}) {
-    return resolveMediaContentBlock(block, options);
-}
 /** Resolve every media block once and enforce aggregate request bounds before provider I/O. */
 export async function resolveProviderMediaMessages(messages, model, options = {}) {
     assertMessagesSupportModelCapabilities(model, messages);