@arnilo/prism 0.4.0 → 0.5.0

package/dist/contracts-core/embeddings.js

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

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

@@ -0,0 +1,60 @@
+/** Provider-neutral image generation/editing contract (plan 061 Task 4).
+ *  Generate (prompt→image[s]) and edit (image+mask+prompt) returning `Uint8Array`
+ *  bytes plus provenance — hosts own persistence (no disk writes, no URL-only
+ *  contract). Edit inputs reuse the existing `ImageContent` binary content parts.
+ *  Adapters enforce prompt/content caps with typed errors — they never truncate. */
+import type { ImageContent, ModelCapabilities, ModelConfig, Usage } from "./content.js";
+export interface ImageGenerationRequest {
+    readonly model: string;
+    readonly prompt: string;
+    /** Pixel dimensions, e.g. `1024x1024` (provider-defined vocabulary). */
+    readonly size?: string;
+    /** Output container, e.g. `png`, `jpeg`, `webp`. */
+    readonly format?: string;
+    /** Provider-defined quality tier, e.g. `standard` | `hd`. */
+    readonly quality?: string;
+    /** Number of images to generate (within the provider cap). */
+    readonly count?: number;
+    readonly signal?: AbortSignal;
+}
+export interface ImageEditRequest {
+    readonly model: string;
+    readonly prompt: string;
+    /** Base image(s) as existing binary content parts (base64 `data` or `url`). */
+    readonly images: readonly ImageContent[];
+    /** Optional mask as an image content part (transparent areas mark edits). */
+    readonly mask?: ImageContent;
+    readonly size?: string;
+    readonly format?: string;
+    readonly count?: number;
+    readonly signal?: AbortSignal;
+}
+/** One generated image: bytes plus provenance. `provider`/`model` are preserved
+ *  end-to-end so hosts can attribute stored output. */
+export interface GeneratedImage {
+    readonly bytes: Uint8Array;
+    /** e.g. `image/png`. */
+    readonly mimeType: string;
+    readonly provider: string;
+    readonly model: string;
+    /** Provider-native URL passthrough, when the provider returns one. */
+    readonly url?: string;
+    /** Provider-revised prompt, when the provider returns one. */
+    readonly revisedPrompt?: string;
+}
+export interface ImageGenerationResult {
+    readonly images: readonly GeneratedImage[];
+    readonly usage?: Usage;
+}
+export interface ImageGenerationProvider {
+    readonly id: string;
+    generate(request: ImageGenerationRequest): Promise<ImageGenerationResult>;
+    edit(request: ImageEditRequest): Promise<ImageGenerationResult>;
+}
+export type ImageGenerationErrorCode = "empty_input" | "input_too_large" | "unsupported_operation" | "request_failed" | "response_malformed" | "unsupported_model";
+export declare class ImageGenerationError extends Error {
+    readonly code: ImageGenerationErrorCode;
+    constructor(code: ImageGenerationErrorCode, message: string);
+}
+export declare function modelSupportsImageGeneration(capabilities?: ModelCapabilities): boolean;
+export declare function assertImageGenerationSupported(model: ModelConfig): void;

package/dist/contracts-core/images.js

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

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

@@ -0,0 +1,46 @@
+/** Provider-neutral moderation classification contract (plan 061 Task 6).
+ *
+ * Scores and flagged booleans are provider output — core bakes in no policy:
+ * thresholds, blocking, and routing stay host-owned (see docs/host-security.md).
+ * Category keys use the provider-neutral vocabulary below; raw provider
+ * categories that have no neutral mapping pass through untouched.
+ */
+import type { JsonObject, ModelCapabilities, ModelConfig } from "./content.js";
+/** Provider-neutral category vocabulary (canonical names; adapters map their raw
+ *  categories onto these — unknown raw categories pass through as-is). */
+export declare const MODERATION_CATEGORIES: readonly ["harassment", "harassment/threatening", "hate", "hate/threatening", "illicit", "illicit/violent", "self-harm", "self-harm/instructions", "self-harm/intent", "sexual", "sexual/minors", "violence", "violence/graphic"];
+export type ModerationCategory = (typeof MODERATION_CATEGORIES)[number];
+export type ModerationErrorCode = "empty_input" | "input_too_large" | "unsupported_model" | "request_failed" | "response_malformed" | "unsupported_operation";
+export declare class ModerationError extends Error {
+    readonly code: ModerationErrorCode;
+    constructor(code: ModerationErrorCode, message: string);
+}
+export declare function modelSupportsModeration(capabilities?: ModelCapabilities): boolean;
+export declare function assertModerationSupported(model: ModelConfig): void;
+export interface ModerationRequest {
+    /** One input per call, or a batch where the provider allows it (results match
+     *  input arity and order). */
+    readonly input: string | readonly string[];
+    readonly model?: string;
+    readonly signal?: AbortSignal;
+}
+/** Per-category verdict: provider-reported score in [0,1] plus the provider's own
+ *  flagged decision — never a locally recomputed threshold. */
+export interface ModerationCategoryResult {
+    readonly score: number;
+    readonly flagged: boolean;
+}
+export interface ModerationResult {
+    /** True when the provider flagged any category for this input. */
+    readonly flagged: boolean;
+    /** Category verdicts keyed by provider-neutral name (unknown raw categories pass through). */
+    readonly categories: Readonly<Record<string, ModerationCategoryResult>>;
+    /** Provider-native category/score fields, unmodified, for host-side audits. */
+    readonly raw?: JsonObject;
+    readonly model?: string;
+    readonly id?: string;
+}
+export interface ModerationProvider {
+    readonly id: string;
+    moderate(request: ModerationRequest): Promise<ModerationResult | readonly ModerationResult[]>;
+}

package/dist/contracts-core/moderation.js

@@ -0,0 +1,34 @@
+/** Provider-neutral category vocabulary (canonical names; adapters map their raw
+ *  categories onto these — unknown raw categories pass through as-is). */
+export const MODERATION_CATEGORIES = [
+    "harassment",
+    "harassment/threatening",
+    "hate",
+    "hate/threatening",
+    "illicit",
+    "illicit/violent",
+    "self-harm",
+    "self-harm/instructions",
+    "self-harm/intent",
+    "sexual",
+    "sexual/minors",
+    "violence",
+    "violence/graphic",
+];
+export class ModerationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "ModerationError";
+        this.code = code;
+    }
+}
+export function modelSupportsModeration(capabilities) {
+    return capabilities?.moderation === true;
+}
+export function assertModerationSupported(model) {
+    if (!modelSupportsModeration(model.capabilities)) {
+        throw new ModerationError("unsupported_model", `Model ${model.provider}/${model.model} does not declare the moderation capability`);
+    }
+}
+//# sourceMappingURL=moderation.js.map

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/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,7 +106,7 @@ 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";
@@ -117,5 +119,5 @@ 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.4.0";
+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,7 +58,7 @@ 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";
@@ -65,6 +66,6 @@ export { createToolParameterValidator, createToolRegistry, dispatchToolCall, fil
 export { trimTrailingSlashes } from "./trim-trailing-slashes.js";
 export { resolveUseCaseModel, resolveUseCaseModelBinding, useCaseCredentialProviderId, } from "./use-case-model.js";
 export const name = "prism";
-export const version = "0.4.0";
+export const version = "0.5.0";
 export const description = "Agent harness for AI providers, agents, sessions, and tools.";
 //# sourceMappingURL=index.js.map

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);
 }