@full-self-browsing/lattice 1.3.0 → 1.4.0

package/dist/index.d.ts

@@ -1,6 +1,15 @@
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/policy/policy.d.ts
+type GatewayMetadataValue = string | number | boolean | null | readonly GatewayMetadataValue[] | {
+  readonly [key: string]: GatewayMetadataValue;
+};
+interface GatewayPolicy {
+  readonly routeTags?: readonly string[];
+  readonly providerPreferences?: readonly string[];
+  readonly metadata?: Record<string, GatewayMetadataValue>;
+  readonly allowFallbacks?: boolean;
+}
 interface PolicySpec {
   readonly maxCostUsd?: number;
   readonly latency?: "interactive" | "batch";
@@ -10,6 +19,8 @@ interface PolicySpec {
   readonly noUpload?: boolean;
   readonly noPublicUrl?: boolean;
   readonly noLogging?: boolean;
+  readonly stream?: boolean;
+  readonly gateway?: GatewayPolicy;
   readonly metadata?: Record<string, unknown>;
 }
 //#endregion
@@ -115,7 +126,7 @@ interface TracerLike {
   readonly span?: <T>(name: string, fn: () => T | Promise<T>, attributes?: Record<string, unknown>) => T | Promise<T>;
   readonly event?: (name: string, attributes?: Record<string, unknown>) => void;
 }
-type RunEventKind = "run.start" | "artifact.ingested" | "context.packed" | "router.candidates" | "stage.start" | "stage.complete" | "provider.attempt" | "fallback.activated" | "validation.complete" | "validation.failed" | "artifact.created" | "run.complete" | "run.failed" | "tool.call" | "replay.offline" | "replay.live" | "step.transition" | "recovery.start" | "recovery.complete" | "recovery.failed" | "capabilities.negotiation.fallback";
+type RunEventKind = "run.start" | "artifact.ingested" | "context.packed" | "router.candidates" | "stage.start" | "stage.complete" | "provider.attempt" | "stream.start" | "stream.complete" | "stream.failed" | "fallback.activated" | "validation.complete" | "validation.failed" | "artifact.created" | "run.complete" | "run.failed" | "tool.call" | "replay.offline" | "replay.live" | "step.transition" | "recovery.start" | "recovery.complete" | "recovery.failed" | "capabilities.negotiation.fallback";
 interface RunEvent {
   readonly kind: RunEventKind;
   readonly timestamp: string;
@@ -375,11 +386,11 @@ declare function evaluateTripwires(output: unknown, invariants: readonly Invaria
 //#endregion
 //#region src/capabilities/profile.d.ts
 /**
- * Closed enum of the 7 Lattice transport adapters (D-06). Adding a new
+ * Closed enum of the 8 Lattice transport adapters (D-06). Adding a new
  * adapter is a typed breaking change. Phase 34 quirk dispatch reads this
  * field.
  */
-type CapabilityAdapter = "openrouter" | "anthropic" | "openai" | "openai-compat" | "xai" | "gemini" | "lm-studio";
+type CapabilityAdapter = "openrouter" | "anthropic" | "openai" | "openai-compat" | "xai" | "gemini" | "lm-studio" | "litellm";
 /**
  * Closed enum of the 5 training-lineage buckets (D-14). Receipt v1.2
  * (Phase 38) carries this value verbatim via the `modelClass` field.
@@ -414,6 +425,9 @@ type ReasoningSurface = "none" | "hidden_cot" | "inlined_tags" | "interleaved_th
  * the Phase 37 tool-call validator's choice of arguments parser.
  */
 type ToolCallSurface = "none" | "native_strict" | "native_lenient" | "json_only" | "text_only";
+type ModelCapabilityProfilePricingKey = "prompt" | "completion" | "image" | "audio" | "web_search" | "internal_reasoning" | "input_cache_read" | "input_cache_write";
+type ModelCapabilityProfilePricing = Partial<Record<ModelCapabilityProfilePricingKey, string>>;
+type ModelCapabilityProfileModality = "text" | "image" | "audio" | "video" | "file" | "embeddings";
 /**
  * Phase 33 — D-05 / D-08 — Capability profile for one (adapter, model)
  * pair. Sibling to `ModelCapability`, not a replacement. Built-time baked
@@ -435,7 +449,7 @@ interface ModelCapabilityProfile {
   /**
    * The Lattice transport adapter that ships this profile (D-05 /
    * D-06). Phase 34 adapter-quirk dispatch reads this field. Closed
-   * union of 7 values.
+   * union of 8 values.
    */
   readonly adapter: CapabilityAdapter;
   /**
@@ -469,6 +483,10 @@ interface ModelCapabilityProfile {
    * the model card's aspirational maximum.
    */
   readonly contextWindow: number;
+  readonly pricing?: ModelCapabilityProfilePricing;
+  readonly inputModalities?: readonly ModelCapabilityProfileModality[];
+  readonly outputModalities?: readonly ModelCapabilityProfileModality[];
+  readonly supportedParameters?: readonly string[];
   /**
    * Failure modes this model class is known to exhibit (D-14). Class-
    * derived defaults plus per-family overrides. Phase 36 sanitizer
@@ -1237,6 +1255,7 @@ interface AgentIntent<TOutputs extends OutputContractMap = OutputContractMap> {
 interface AgentSuccess<TOutputs extends OutputContractMap = OutputContractMap> {
   readonly kind: "success";
   readonly output: InferOutputMap<TOutputs>;
+  readonly artifacts?: readonly ArtifactRef[];
   readonly usage: Usage;
   readonly iterations: ReadonlyArray<IterationRecord>;
   readonly receipt?: ReceiptEnvelope;
@@ -1451,6 +1470,18 @@ interface LmStudioQuirks extends AdapterQuirks {
   readonly customChatTemplateRiskFlag: boolean;
   readonly noAuthRequired: boolean;
 }
+/**
+ * LiteLLM adapter quirks (extends AdapterQuirks with gateway-specific flags).
+ *
+ * LiteLLM is consumed as an OpenAI-compatible gateway. Lattice does not start,
+ * embed, or depend on a LiteLLM gateway process; these flags describe the
+ * helper's supported gateway metadata contract over HTTP.
+ */
+interface LiteLLMQuirks extends AdapterQuirks {
+  readonly gatewayMetadataSupported: boolean;
+  readonly gatewayFallbacksSupported: boolean;
+  readonly openAIErrorMapping: boolean;
+}
 //#endregion
 //#region src/capabilities/sanitizer-recommendations.d.ts
 /**
@@ -1666,6 +1697,13 @@ interface ProviderRunRequest {
    */
   readonly cacheSystemPrefix?: string;
 }
+interface ProviderGatewayMetadata {
+  readonly used: boolean;
+  readonly requestedModel?: string;
+  readonly observedModel?: string;
+  readonly fallbackModels?: readonly string[];
+  readonly policy?: Record<string, unknown>;
+}
 interface ProviderRunResponse {
   readonly rawOutputs: Record<string, unknown>;
   readonly artifactRefs?: readonly (ArtifactInput | ArtifactRef)[];
@@ -1684,13 +1722,50 @@ interface ProviderRunResponse {
    */
   readonly normalizedUsage?: Usage;
   readonly toolCalls?: readonly ValidatedToolCall[];
+  readonly gateway?: ProviderGatewayMetadata;
+  readonly rawResponse?: unknown;
+}
+interface ProviderStreamTextDeltaChunk {
+  readonly kind: "text-delta";
+  readonly output?: string;
+  readonly text: string;
+}
+interface ProviderStreamOutputChunk {
+  readonly kind: "output";
+  readonly output: string;
+  readonly value: unknown;
+}
+interface ProviderStreamUsageChunk {
+  readonly kind: "usage";
+  readonly usage?: UsageRecord;
+  readonly normalizedUsage?: Usage;
+}
+interface ProviderStreamGatewayChunk {
+  readonly kind: "gateway";
+  readonly gateway: ProviderGatewayMetadata;
+}
+interface ProviderStreamToolCallChunk {
+  readonly kind: "tool-call";
+  readonly toolCall: ValidatedToolCall;
+}
+interface ProviderStreamCompleteChunk {
+  readonly kind: "complete";
+  readonly rawOutputs?: Record<string, unknown>;
+  readonly artifactRefs?: readonly (ArtifactInput | ArtifactRef)[];
+  readonly usage?: UsageRecord;
+  readonly normalizedUsage?: Usage;
+  readonly gateway?: ProviderGatewayMetadata;
+  readonly toolCalls?: readonly ValidatedToolCall[];
   readonly rawResponse?: unknown;
 }
+type ProviderStreamChunk = ProviderStreamTextDeltaChunk | ProviderStreamOutputChunk | ProviderStreamUsageChunk | ProviderStreamGatewayChunk | ProviderStreamToolCallChunk | ProviderStreamCompleteChunk;
+type ProviderStream = AsyncIterable<ProviderStreamChunk>;
 interface ProviderAdapter {
   readonly id: string;
   readonly kind: "provider-adapter";
   readonly capabilities?: readonly ModelCapability[];
   readonly execute?: (request: ProviderRunRequest) => Promise<ProviderRunResponse>;
+  readonly executeStream?: (request: ProviderRunRequest) => ProviderStream | Promise<ProviderStream>;
   /**
    * Phase 34 — D-01 — Per-adapter behavioral deviation flags. OPTIONAL on the
    * base interface so v1.2 consumer adapters (4-field literals) continue to work
@@ -1800,8 +1875,22 @@ interface ProviderPackagedArtifactPlan {
   readonly transport: ProviderTransportMode;
   readonly mediaType?: string;
   readonly lineageTransform: "provider-packaging";
+  readonly providerRequest?: ProviderPackagedArtifactRequestPlan;
   readonly warnings: readonly string[];
 }
+type ProviderPackagedArtifactSourceType = ProviderTransportMode | "file-reference";
+interface ProviderPackagedArtifactRequestPlan {
+  readonly shape: string;
+  readonly sourceType: ProviderPackagedArtifactSourceType;
+  readonly reason: string;
+  readonly mediaType?: string;
+  readonly sizeBytes?: number;
+  readonly reference?: ProviderPackagedArtifactReferencePlan;
+}
+interface ProviderPackagedArtifactReferencePlan {
+  readonly kind: "url" | "file-id" | "file-uri" | "storage";
+  readonly metadataKey?: string;
+}
 interface ProviderAttemptRecord {
   readonly providerId: string;
   readonly modelId: string;
@@ -1810,6 +1899,7 @@ interface ProviderAttemptRecord {
   readonly completedAt?: string;
   readonly error?: string;
   readonly usage?: UsageRecord;
+  readonly metadata?: Record<string, unknown>;
 }
 interface UsageRecord {
   readonly inputTokens?: number;
@@ -1866,7 +1956,7 @@ interface ReceiptRedaction {
   readonly reason: string;
 }
 interface CapabilityReceiptBody {
-  readonly version: "lattice-receipt/v1" | "lattice-receipt/v1.1" | "lattice-receipt/v1.2";
+  readonly version: "lattice-receipt/v1" | "lattice-receipt/v1.1" | "lattice-receipt/v1.2" | "lattice-receipt/v1.3";
   readonly receiptId: string;
   readonly runId: string;
   readonly issuedAt: string;
@@ -1875,6 +1965,7 @@ interface CapabilityReceiptBody {
   readonly route: ReceiptRoute;
   readonly modelClass?: TrainingClass;
   readonly parentReceiptCid?: string;
+  readonly lineageMerkleRoot?: string;
   readonly usage: ReceiptUsageCanonical;
   readonly contractVerdict: ContractVerdict;
   readonly contractHash: string | null;
@@ -1933,7 +2024,7 @@ type VerifyResult = VerifyOk | VerifyFail;
 //#region src/receipts/receipt.d.ts
 /**
  * Public input to createReceipt. Mirrors CapabilityReceiptBody minus:
- *   - `version` (forced to "lattice-receipt/v1.2" per Phase 38)
+ *   - `version` (forced to "lattice-receipt/v1.3" per Phase 46)
  *   - `kid` (forced from signer.kid — caller cannot mismatch)
  *   - `redactions[]` (populated by redactReceiptBody)
  *   - `usage.costUsd` (converted to canonical string by usageToCanonical)
@@ -1949,6 +2040,7 @@ interface CreateReceiptInput {
   readonly route: ReceiptRoute;
   readonly modelClass?: TrainingClass;
   readonly parentReceiptCid?: string;
+  readonly lineageMerkleRoot?: string;
   readonly usage: Usage;
   readonly contractVerdict: ContractVerdict;
   readonly contractHash: string | null;
@@ -2127,6 +2219,60 @@ interface EvaluateContractInput {
  */
 declare function evaluateContractAgainstRoute(contract: CapabilityContract | undefined, input: EvaluateContractInput): ContractPreflightResult;
 //#endregion
+//#region src/observability/otel.d.ts
+type OtelAttributeValue = string | number | boolean | readonly string[] | readonly number[] | readonly boolean[];
+type OtelAttributes = Record<string, OtelAttributeValue>;
+interface OtelSpanStatus {
+  readonly code: number;
+  readonly message?: string;
+}
+interface OtelSpanLike {
+  setAttribute?(key: string, value: OtelAttributeValue): unknown;
+  setAttributes?(attributes: OtelAttributes): unknown;
+  addEvent?(name: string, attributes?: OtelAttributes): unknown;
+  setStatus?(status: OtelSpanStatus): unknown;
+  recordException?(error: Error | string | Record<string, unknown>): unknown;
+  end?(endTime?: Date | number): unknown;
+}
+interface OtelTracerLike {
+  startSpan(name: string, options?: {
+    readonly attributes?: OtelAttributes;
+    readonly startTime?: Date | number;
+  }): OtelSpanLike;
+}
+type OtelContentCaptureMode = "none" | "metadata";
+interface OtelSanitizerOptions {
+  readonly contentCapture?: OtelContentCaptureMode;
+}
+interface OtelRunEventSinkOptions extends OtelSanitizerOptions {
+  readonly tracer: OtelTracerLike;
+  readonly spanName?: string;
+}
+interface OtelHttpTraceConfig {
+  readonly endpoint: string;
+  readonly headers: Record<string, string>;
+}
+interface LangfuseOtlpConfigOptions {
+  readonly baseUrl?: string;
+  readonly publicKey?: string;
+  readonly secretKey?: string;
+  readonly authString?: string;
+  readonly ingestionVersion?: string;
+  readonly headers?: Record<string, string>;
+}
+interface PhoenixOtlpConfigOptions {
+  readonly baseUrl?: string;
+  readonly endpoint?: string;
+  readonly apiKey?: string;
+  readonly projectName?: string;
+  readonly headers?: Record<string, string>;
+}
+declare function createOtelRunEventSink(options: OtelRunEventSinkOptions): RunEventSink;
+declare function sanitizeRunEventAttributes(event: RunEvent, options?: OtelSanitizerOptions): OtelAttributes;
+declare function createOtelReceiptAttributes(envelope: ReceiptEnvelope): Promise<OtelAttributes>;
+declare function createLangfuseOtlpConfig(options?: LangfuseOtlpConfigOptions): OtelHttpTraceConfig;
+declare function createPhoenixOtlpConfig(options?: PhoenixOtlpConfigOptions): OtelHttpTraceConfig;
+//#endregion
 //#region src/receipts/keyset.d.ts
 /**
  * In-memory KeySet factory.
@@ -2145,6 +2291,39 @@ declare function evaluateContractAgainstRoute(contract: CapabilityContract | und
  */
 declare function createMemoryKeySet(entries: readonly KeyEntry[]): KeySet;
 //#endregion
+//#region src/receipts/remote-signer.d.ts
+type RemoteReceiptSignerProvider = "aws-kms" | "gcp-kms" | "external-kms" | (string & {});
+type RemoteReceiptPayloadFormat = "dsse-pae";
+interface RemoteReceiptSignRequest {
+  readonly kid: string;
+  readonly publicKeyJwk: JsonWebKey;
+  readonly bytes: Uint8Array;
+  readonly payloadFormat: RemoteReceiptPayloadFormat;
+  readonly algorithm: "Ed25519";
+  readonly provider?: RemoteReceiptSignerProvider;
+  readonly keyRef?: string;
+  readonly metadata?: Record<string, unknown>;
+}
+interface RemoteReceiptSignResult {
+  readonly signature: Uint8Array;
+}
+interface RemoteReceiptSignerOptions {
+  readonly kid: string;
+  readonly publicKeyJwk: JsonWebKey;
+  readonly provider?: RemoteReceiptSignerProvider;
+  readonly keyRef?: string;
+  readonly metadata?: Record<string, unknown>;
+  sign(request: RemoteReceiptSignRequest): Promise<Uint8Array | RemoteReceiptSignResult>;
+}
+/**
+ * Adapt a remote signing service to Lattice's existing ReceiptSigner contract.
+ *
+ * The callback receives the exact DSSE PAE bytes that createReceipt signs.
+ * Cloud-specific request construction, hashing choices, credentials, retries,
+ * and audit logging stay outside core.
+ */
+declare function createRemoteReceiptSigner(options: RemoteReceiptSignerOptions): ReceiptSigner;
+//#endregion
 //#region src/receipts/sign.d.ts
 interface GeneratedEd25519KeyPair {
   readonly privateKeyJwk: JsonWebKey;
@@ -2178,6 +2357,22 @@ declare function createInMemorySigner(privateKeyJwk: JsonWebKey, options: {
  */
 declare function verifyReceipt(envelope: ReceiptEnvelope, keySet: KeySet): Promise<VerifyResult>;
 //#endregion
+//#region src/providers/no-public-url.d.ts
+/**
+ * Thrown when a run with `policy.noPublicUrl: true` is about to dispatch a
+ * request whose serialized body still contains a public http(s) URL derived
+ * from `request.artifacts` (value or string metadata entry).
+ *
+ * This is the single shared egress error class for all three adapter families
+ * (OpenAI-compatible, Anthropic, Gemini).  Callers may `instanceof`-check it.
+ */
+declare class NoPublicUrlEgressError extends Error {
+  readonly providerId: string;
+  readonly artifactId: string;
+  readonly offendingUrl: string;
+  constructor(providerId: string, artifactId: string, offendingUrl: string);
+}
+//#endregion
 //#region src/sanitizers/sanitizers.d.ts
 interface SanitizerContext {
   readonly providerId: string;
@@ -2201,6 +2396,7 @@ interface OpenAICompatibleProviderOptions {
   readonly model: string;
   readonly baseUrl: string;
   readonly apiKey?: string;
+  readonly gateway?: GatewayPolicy;
   readonly fetch?: typeof fetch;
   /**
    * Phase 7 addition: caller-supplied per-1k pricing. When provided, the
@@ -2323,11 +2519,11 @@ declare function createAISdkProvider(options: SdkLikeProviderOptions): ProviderA
  *
  * SECURITY: `apiKey` is a runtime parameter -- do NOT hardcode or log it.
  *
+ * STREAMING (Phase 44): supported through native Anthropic Messages SSE events.
+ *
  * DEFERRED (Phase 4 carryforward notes):
  *   - prompt caching   (Phase 39: opt-in via `ProviderRunRequest.cacheSystemPrefix` —
  *                       emitted as a cache_control-marked system block when present)
- *   - streaming        (deferred; this adapter is single-shot Promise -- per CONTEXT.md D-06)
- *   - tool use         (Anthropic tool_use blocks are deferred)
  *   - resume-from-eviction -- see Phase 5 (MV3-survivability adapter contract)
  *
  * Ref: FSB v0.10.0-attempt-2 Phase 4 (D-02 + D-07: full custom adapter; preserve top-level `system`).
@@ -2404,10 +2600,10 @@ declare function createFakeProvider(options?: FakeProviderOptions): ProviderAdap
  *
  * SECURITY: `apiKey` is a runtime parameter -- do NOT hardcode or log it.
  *
+ * STREAMING (Phase 44): supported through native `streamGenerateContent` SSE events.
+ *
  * DEFERRED (Phase 4 carryforward notes):
  *   - multimodal (vision) -- deferred
- *   - streaming           -- deferred (single-shot Promise per CONTEXT.md D-06)
- *   - tool use            -- deferred
  *   - resume-from-eviction -- see Phase 5 (MV3-survivability adapter contract)
  *
  * NOTE (Phase 34): negotiate() uses x-goog-api-key HEADER (preferred per RESEARCH §Q3).
@@ -2467,6 +2663,26 @@ declare function createGeminiProvider(options: GeminiProviderOptions): ProviderA
   readonly negotiateCapabilities: (modelId: string) => Promise<NegotiatedCapabilities>;
 };
 //#endregion
+//#region src/providers/litellm.d.ts
+/**
+ * Options for {@link createLiteLLMProvider}.
+ *
+ * Thin wrapper around {@link createOpenAICompatibleProvider} pinned to the
+ * documented local LiteLLM proxy URL. LiteLLM is treated as an
+ * OpenAI-compatible gateway over HTTP; this helper does not start, embed, or
+ * depend on a LiteLLM gateway process.
+ */
+interface LiteLLMProviderOptions extends Omit<OpenAICompatibleProviderOptions, "id" | "baseUrl" | "gateway"> {
+  readonly id?: string;
+  /** Defaults to `http://localhost:4000`. Override for hosted proxies or `/v1` deployments. */
+  readonly baseUrl?: string;
+  readonly gateway?: GatewayPolicy;
+}
+declare function createLiteLLMProvider(options: LiteLLMProviderOptions): ProviderAdapter & {
+  readonly quirks: LiteLLMQuirks;
+  readonly negotiateCapabilities: (modelId: string) => Promise<NegotiatedCapabilities>;
+};
+//#endregion
 //#region src/providers/lm-studio.d.ts
 /**
  * Options for {@link createLmStudioProvider}.
@@ -2487,12 +2703,13 @@ declare function createGeminiProvider(options: GeminiProviderOptions): ProviderA
  *     because source: "registry" is the documented happy path for LM Studio
  *     (no event for intentional no-endpoint per RESEARCH Open Question 5).
  *
+ * STREAMING (Phase 44): supported through the OpenAI-compatible stream path.
+ *
  * DEFERRED (D-16 carryforward):
  *   - latency-tail diagnostics  -- observability concern; LM Studio is
  *                                  the canary for latency tails (INV-03);
  *                                  diagnostics module deferred to a
  *                                  follow-on observability phase.
- *   - streaming                 -- deferred (single-shot per D-06).
  *   - resume-from-eviction      -- see Phase 5 (MV3-survivability adapter).
  *
  * Ref: FSB v0.10.0-attempt-2 Phase 4 (D-03: thin wrapper; D-16: latency-tail deferred; CD-03 no-opt-out).
@@ -2546,14 +2763,11 @@ declare function createLmStudioProvider(options: LmStudioProviderOptions): Provi
  *
  * SECURITY: `apiKey` is a runtime parameter -- do NOT hardcode or log it.
  *
+ * STREAMING (Phase 44): supported through the OpenAI-compatible stream path.
+ *
  * DEFERRED (D-17 carryforward; Phase 4 ships the named adapter as a
  * first-class OpenAI-compat wrapper):
- *   - model-routing array  -- caller supplies `model` (single id); OpenRouter's
- *                             `models: [primary, fallback, ...]` array
- *                             feature is deferred to a follow-on phase.
- *   - fallback-array       -- deferred (same phase as model-routing).
  *   - per-message routing  -- deferred.
- *   - streaming            -- deferred (single-shot per CONTEXT.md D-06).
  *   - resume-from-eviction -- see Phase 5 (MV3-survivability adapter).
  *
  * Ref: FSB v0.10.0-attempt-2 Phase 4 (D-03: thin wrapper; D-17: model-routing deferred).
@@ -2579,6 +2793,12 @@ interface OpenRouterProviderOptions extends Omit<OpenAICompatibleProviderOptions
    * If absent, no event is emitted (silent fallback).
    */
   readonly runEventSink?: RunEventSink;
+  /**
+   * Ordered OpenRouter model fallback candidates. The primary `model` remains
+   * the Lattice-selected route; these candidates serialize as OpenRouter's
+   * top-level `models` request field when non-empty.
+   */
+  readonly fallbackModels?: readonly string[];
 }
 /**
  * Phase 34 — D-03 / D-05..D-12 — Extended OpenRouter provider factory.
@@ -2621,9 +2841,10 @@ declare function createOpenRouterProvider(options: OpenRouterProviderOptions): P
  *
  * SECURITY: `apiKey` is a runtime parameter -- do NOT hardcode or log it.
  *
+ * STREAMING (Phase 44): supported through the OpenAI-compatible stream path.
+ *
  * DEFERRED (Phase 4 carryforward notes):
  *   - tool-streaming -- deferred
- *   - streaming      -- deferred (single-shot Promise per CONTEXT.md D-06)
  *   - resume-from-eviction -- see Phase 5 (MV3-survivability adapter contract)
  *
  * Ref: FSB v0.10.0-attempt-2 Phase 4 (D-03 + D-07: thin wrapper; reasoning_tokens quirk preserved).
@@ -2669,6 +2890,12 @@ declare function createXaiProvider(options: XaiProviderOptions): ProviderAdapter
   readonly negotiateCapabilities: (modelId: string) => Promise<NegotiatedCapabilities>;
 };
 //#endregion
+//#region src/providers/streaming.d.ts
+interface CollectStreamOptions {
+  readonly defaultOutput?: string;
+}
+declare function collectStream(stream: ProviderStream, options?: CollectStreamOptions): Promise<ProviderRunResponse>;
+//#endregion
 //#region src/results/result.d.ts
 interface RunSuccess<TOutputs extends OutputContractMap> {
   readonly ok: true;
@@ -2677,6 +2904,7 @@ interface RunSuccess<TOutputs extends OutputContractMap> {
   readonly usage: Usage;
   readonly plan: ResultPlan;
   readonly events?: readonly RunEvent[];
+  readonly gateway?: ProviderGatewayMetadata;
   /**
    * Phase 9 — signed capability receipt issued when `LatticeConfig.signer`
    * is configured. Undefined when no signer is set.
@@ -2691,6 +2919,7 @@ interface RunFailure {
   readonly partialOutputs?: Record<string, unknown>;
   readonly plan: ResultPlan;
   readonly events?: readonly RunEvent[];
+  readonly gateway?: ProviderGatewayMetadata;
   /**
    * Phase 9 — signed capability receipt issued when `LatticeConfig.signer`
    * is configured. Undefined when no signer is set.
@@ -3218,6 +3447,64 @@ declare function withRateLimit(group: RateLimitGroup, inner?: AgentTransport): A
  */
 declare function receiptCid(envelope: ReceiptEnvelope): Promise<string>;
 //#endregion
+//#region src/realtime/realtime.d.ts
+declare const REALTIME_DIRECTION_SUPPORT_LEVEL: "direction-only";
+type RealtimeSupportLevel = typeof REALTIME_DIRECTION_SUPPORT_LEVEL;
+type RealtimeProviderKind = "openai-realtime" | "gemini-live";
+type RealtimeTransportKind = "websocket" | "webrtc" | "sip";
+type RealtimeSessionMode = "voice-agent" | "transcription" | "translation" | "live-multimodal";
+type RealtimeInputModality = "text" | "audio" | "image" | "video";
+type RealtimeOutputModality = "text" | "audio" | "tool";
+type RealtimeCheckpointKind = "session.start" | "client.frame" | "server.frame" | "session.summary" | "session.close";
+interface OpenAIRealtimeTarget {
+  readonly provider: "openai-realtime";
+  readonly model: string;
+  readonly transport: RealtimeTransportKind;
+  readonly endpoint: "/v1/realtime" | "/v1/realtime/translations" | "/v1/realtime/transcription_sessions";
+}
+interface GeminiLiveTarget {
+  readonly provider: "gemini-live";
+  readonly model: string;
+  readonly transport: "websocket";
+  readonly endpoint: "wss://generativelanguage.googleapis.com/ws/google.ai.generativelanguage.v1beta.GenerativeService.BidiGenerateContent";
+  readonly preview: true;
+}
+type RealtimeProviderTarget = OpenAIRealtimeTarget | GeminiLiveTarget;
+interface RealtimeSessionSpec {
+  readonly kind: "realtime-session-spec";
+  readonly supportLevel: RealtimeSupportLevel;
+  readonly sessionId: string;
+  readonly target: RealtimeProviderTarget;
+  readonly mode: RealtimeSessionMode;
+  readonly inputModalities: readonly RealtimeInputModality[];
+  readonly outputModalities: readonly RealtimeOutputModality[];
+  readonly artifactRefs?: readonly ArtifactRef[];
+  readonly policy?: PolicySpec;
+  readonly checkpointing?: RealtimeCheckpointingSpec;
+}
+interface RealtimeCheckpointingSpec {
+  readonly receiptThreading: "step-linked-list";
+  readonly summaryCheckpoints: "manual" | "session-close" | "interval";
+  readonly note: "direction-only";
+}
+interface RealtimeCheckpointInput {
+  readonly sessionId: string;
+  readonly provider: RealtimeProviderKind;
+  readonly checkpoint: RealtimeCheckpointKind;
+  readonly stepIndex: number;
+  readonly timestamp?: string;
+  readonly parentStepName?: string;
+  readonly previousStepName?: string;
+}
+interface RealtimeReceiptDescriptors {
+  readonly sessionId: string;
+  readonly model: ReceiptModel;
+  readonly route: ReceiptRoute;
+}
+declare function createRealtimeCheckpointContext(input: RealtimeCheckpointInput): CheckpointHookContext;
+declare function createRealtimeReceiptDescriptors(spec: RealtimeSessionSpec): RealtimeReceiptDescriptors;
+declare function realtimeStepName(provider: RealtimeProviderKind, checkpoint: RealtimeCheckpointKind): string;
+//#endregion
 //#region src/agent/eval.d.ts
 /**
  * Summary of an agent run sufficient for regression analysis. Callers
@@ -3272,7 +3559,7 @@ interface MemoryArtifactStoreOptions {
 declare function createMemoryArtifactStore(options?: MemoryArtifactStoreOptions): ArtifactStore;
 //#endregion
 //#region src/version.d.ts
-declare const latticeVersion = "0.0.0";
+declare const latticeVersion = "1.4.0";
 //#endregion
 //#region src/capabilities/lookup.d.ts
 /**
@@ -3329,5 +3616,5 @@ declare const PROMPT_STRATEGIES: readonly ["frontier", "mid_tier", "open_weight"
 declare function getStructuredOutputContract(strategy: RecommendedPromptStrategy, schema: unknown): string;
 declare function getToolUseContract(strategy: RecommendedPromptStrategy, tools: unknown): string;
 //#endregion
-export { type AI, ALL_KNOWN_FAILURE_MODES, ALL_TRAINING_CLASSES, type ActionHistory, type ActionHistoryOptions, type ActionRecord, type AdapterQuirks, AgentDeniedError, type AgentEvalResult, type AgentFailure, type AgentFailureKind, type AgentHost, type AgentIntent, type AgentResult, type AgentRunSnapshot, type AgentScheduler, type AgentSnapshot, type AgentSpec, type AgentStorage, type AgentSuccess, type AgentTransport, type AnthropicProviderOptions, type AnthropicQuirks, type ArtifactFingerprint, type ArtifactInput, type ArtifactKind, type ArtifactLineage, type ArtifactOptions, type ArtifactParentRef, type ArtifactPrivacy, type ArtifactRef, type ArtifactSize, type ArtifactSource, type ArtifactStorageRef, type ArtifactStore, type ArtifactTransformDescriptor, type ArtifactTransformKind, BAND, type BudgetInvariant, type CapabilityAdapter, type CapabilityContract, type CapabilityContractInput, type CapabilityReceiptBody, type CheckpointHookContext, type CheckpointHookOptions, type ContractRejectReasonCode, type ContractVerdict, type ConversationTurn, type CostBudgetStatus, type CostTracker, type CreateReceiptInput, type CrewAgentResult, type CrewPolicy, type CrewRateLimitOverride, type CrewResult, DEFAULT_CHECKPOINT_BAND, type EvalOptions, type EvalRegression, type EvalRegressionKind, type EvictionHook, type ExecutionPlanStub, type FieldFromTableInvariant, type FormatToolsMode, type FormatToolsOptions, type FormattedToolsHandle, type GeminiProviderOptions, type GeminiQuirks, type GoalProgressOptions, type GoalProgressStep, type GoalProgressTracker, type HookControls, type HookDenyDirective, type HookLifecycleEvent, type HookPipeline, type InferOutput, type InferOutputMap, type InternalEnvelopeOptions, type InvariantDeclaration, type InvariantOptions, type IterationRecord, type KeyEntry, type KeySet, type KeyState, type KnownFailureMode, type LatticeConfig, type LatticeRunError, type LmStudioProviderOptions, type LmStudioQuirks, type MatchesInvariant, type MaterializationError, type MaterializeReplayEnvelopeOptions, type ModelCapabilityProfile, type MustCiteInvariant, type NegotiatedCapabilities, NegotiationAuthError, type NoPiiInvariant, type NormalizedLatticeConfig, type OpenAICompatQuirks, type OpenAIQuirks, type OpenRouterProviderOptions, type OpenRouterQuirks, type OutputContract, type OutputContractMap, PROMPT_SCAFFOLD_VERSION, PROMPT_STRATEGIES, type PermissionContext, type PermissionDecisionInput, type PermissionHookContext, type PermissionRule, type PermissionVerdict, type PiiDetector, type PiiDetectorResult, type PolicySpec, type ProgressStatus, type ProviderAdapter, type ProviderRef, type ProviderRunRequest, type ProviderRunResponse, type QualityFloorInvariant, type RateLimitGroup, type RateLimitGroupOptions, type RateLimitLease, type ReasoningSurface, type ReceiptEnvelope, type ReceiptModel, type ReceiptRedaction, type ReceiptRoute, type ReceiptSignature, type ReceiptSigner, type ReceiptUsageCanonical, type RecommendedPromptStrategy, type ReplayEnvelope, type ResumePolicy, type RunAgentCrewOptions, type RunEvent, type RunEventKind, type RunEventSink, type RunFailure, type RunIntent, type RunResult, type RunSuccess, SANITIZER_BY_FAILURE_MODE, STEP_TRANSITION_EVENT_NAME, STUCK_REASONS, type SanitizeOutputOption, type SanitizerContext, type SanitizerFn, type SanitizerKey, type SerializedSnapshot, type SessionRef, type StorageLike, type StoredArtifactEnvelope, type StoredArtifactPayloadDescriptor, type StuckReason, type SurvivabilityAdapter, type TokenEstimator, type ToolCallSurface, ToolCallValidationError, type ToolCallValidationFailureReason, type ToolUseRequest, type TracerLike, type TrainingClass, type TranscriptStore, type TripwireEvidence, type TripwireResult, type TripwireViolationError, type UnsubscribeFn, type Usage, type ValidateToolCallsOption, type ValidatedToolCall, type ValidationIssue, type VerifyError, type VerifyErrorKind, type VerifyFail, type VerifyOk, type VerifyResult, type XaiProviderOptions, type XaiQuirks, artifact, contract, createAI, createAISdkProvider, createActionHistory, createAnthropicProvider, createCheckpointHook, createCostTracker, createFakeProvider, createGeminiProvider, createGoalProgressTracker, createHookPipeline, createInMemorySigner, createLmStudioProvider, createLocalArtifactStore, createMemoryArtifactStore, createMemoryKeySet, createMemorySessionStore, createNoopAgentHost, createNoopSurvivabilityAdapter, createOpenAICompatibleProvider, createOpenAIProvider, createOpenRouterProvider, createPermissionContext, createPermissionGuardHook, createRateLimitGroup, createReceipt, createReplayEnvelope, createTranscriptStore, createXaiProvider, defaultPiiDetectors, defineAgent, defineTool, estimateRouteCost, evalAgentRun, evaluateContractAgainstRoute, evaluateTripwires, findCapabilityProfile, formatToolsForProvider, generateEd25519KeyPairJwk, getCapabilityProfile, getRecommendedSanitizers, getStructuredOutputContract, getToolUseContract, importMcpTools, inv, isTerminal, latticeVersion, materializeReplayEnvelope, negotiateCapabilities, output, parseToolUseEnvelope, permissionGuardRegisterOptions, receiptCid, redactArtifactRef, redactPlan, redactReplayEnvelope, replayOffline, rerunLive, runAgent, runAgentCrew, runTool, stripChatTemplateArtifacts, stripOpenRouterVariant, stripReasoningTags, synthesizeNegotiatedCapabilitiesFromRegistry, toolArtifactRef, toolSchemaToJsonSchema, unwrapInternalEnvelope, verifyReceipt, withRateLimit };
+export { type AI, ALL_KNOWN_FAILURE_MODES, ALL_TRAINING_CLASSES, type ActionHistory, type ActionHistoryOptions, type ActionRecord, type AdapterQuirks, AgentDeniedError, type AgentEvalResult, type AgentFailure, type AgentFailureKind, type AgentHost, type AgentIntent, type AgentResult, type AgentRunSnapshot, type AgentScheduler, type AgentSnapshot, type AgentSpec, type AgentStorage, type AgentSuccess, type AgentTransport, type AnthropicProviderOptions, type AnthropicQuirks, type ArtifactFingerprint, type ArtifactInput, type ArtifactKind, type ArtifactLineage, type ArtifactOptions, type ArtifactParentRef, type ArtifactPrivacy, type ArtifactRef, type ArtifactSize, type ArtifactSource, type ArtifactStorageRef, type ArtifactStore, type ArtifactTransformDescriptor, type ArtifactTransformKind, BAND, type BudgetInvariant, type CapabilityAdapter, type CapabilityContract, type CapabilityContractInput, type CapabilityReceiptBody, type CheckpointHookContext, type CheckpointHookOptions, type CollectStreamOptions, type ContractRejectReasonCode, type ContractVerdict, type ConversationTurn, type CostBudgetStatus, type CostTracker, type CreateReceiptInput, type CrewAgentResult, type CrewPolicy, type CrewRateLimitOverride, type CrewResult, DEFAULT_CHECKPOINT_BAND, type EvalOptions, type EvalRegression, type EvalRegressionKind, type EvictionHook, type ExecutionPlanStub, type FieldFromTableInvariant, type FormatToolsMode, type FormatToolsOptions, type FormattedToolsHandle, type GatewayMetadataValue, type GatewayPolicy, type GeminiLiveTarget, type GeminiProviderOptions, type GeminiQuirks, type GoalProgressOptions, type GoalProgressStep, type GoalProgressTracker, type HookControls, type HookDenyDirective, type HookLifecycleEvent, type HookPipeline, type InferOutput, type InferOutputMap, type InternalEnvelopeOptions, type InvariantDeclaration, type InvariantOptions, type IterationRecord, type KeyEntry, type KeySet, type KeyState, type KnownFailureMode, type LangfuseOtlpConfigOptions, type LatticeConfig, type LatticeRunError, type LiteLLMProviderOptions, type LiteLLMQuirks, type LmStudioProviderOptions, type LmStudioQuirks, type MatchesInvariant, type MaterializationError, type MaterializeReplayEnvelopeOptions, type ModelCapabilityProfile, type ModelCapabilityProfileModality, type ModelCapabilityProfilePricing, type ModelCapabilityProfilePricingKey, type MustCiteInvariant, type NegotiatedCapabilities, NegotiationAuthError, type NoPiiInvariant, NoPublicUrlEgressError, type NormalizedLatticeConfig, type OpenAICompatQuirks, type OpenAIQuirks, type OpenAIRealtimeTarget, type OpenRouterProviderOptions, type OpenRouterQuirks, type OtelAttributeValue, type OtelAttributes, type OtelContentCaptureMode, type OtelHttpTraceConfig, type OtelRunEventSinkOptions, type OtelSanitizerOptions, type OtelSpanLike, type OtelSpanStatus, type OtelTracerLike, type OutputContract, type OutputContractMap, PROMPT_SCAFFOLD_VERSION, PROMPT_STRATEGIES, type PermissionContext, type PermissionDecisionInput, type PermissionHookContext, type PermissionRule, type PermissionVerdict, type PhoenixOtlpConfigOptions, type PiiDetector, type PiiDetectorResult, type PolicySpec, type ProgressStatus, type ProviderAdapter, type ProviderGatewayMetadata, type ProviderRef, type ProviderRunRequest, type ProviderRunResponse, type ProviderStream, type ProviderStreamChunk, type ProviderStreamCompleteChunk, type ProviderStreamGatewayChunk, type ProviderStreamOutputChunk, type ProviderStreamTextDeltaChunk, type ProviderStreamToolCallChunk, type ProviderStreamUsageChunk, type QualityFloorInvariant, REALTIME_DIRECTION_SUPPORT_LEVEL, type RateLimitGroup, type RateLimitGroupOptions, type RateLimitLease, type RealtimeCheckpointInput, type RealtimeCheckpointKind, type RealtimeCheckpointingSpec, type RealtimeInputModality, type RealtimeOutputModality, type RealtimeProviderKind, type RealtimeProviderTarget, type RealtimeReceiptDescriptors, type RealtimeSessionMode, type RealtimeSessionSpec, type RealtimeSupportLevel, type RealtimeTransportKind, type ReasoningSurface, type ReceiptEnvelope, type ReceiptModel, type ReceiptRedaction, type ReceiptRoute, type ReceiptSignature, type ReceiptSigner, type ReceiptUsageCanonical, type RecommendedPromptStrategy, type RemoteReceiptPayloadFormat, type RemoteReceiptSignRequest, type RemoteReceiptSignResult, type RemoteReceiptSignerOptions, type RemoteReceiptSignerProvider, type ReplayEnvelope, type ResumePolicy, type RunAgentCrewOptions, type RunEvent, type RunEventKind, type RunEventSink, type RunFailure, type RunIntent, type RunResult, type RunSuccess, SANITIZER_BY_FAILURE_MODE, STEP_TRANSITION_EVENT_NAME, STUCK_REASONS, type SanitizeOutputOption, type SanitizerContext, type SanitizerFn, type SanitizerKey, type SerializedSnapshot, type SessionRef, type StorageLike, type StoredArtifactEnvelope, type StoredArtifactPayloadDescriptor, type StuckReason, type SurvivabilityAdapter, type TokenEstimator, type ToolCallSurface, ToolCallValidationError, type ToolCallValidationFailureReason, type ToolUseRequest, type TracerLike, type TrainingClass, type TranscriptStore, type TripwireEvidence, type TripwireResult, type TripwireViolationError, type UnsubscribeFn, type Usage, type ValidateToolCallsOption, type ValidatedToolCall, type ValidationIssue, type VerifyError, type VerifyErrorKind, type VerifyFail, type VerifyOk, type VerifyResult, type XaiProviderOptions, type XaiQuirks, artifact, collectStream, contract, createAI, createAISdkProvider, createActionHistory, createAnthropicProvider, createCheckpointHook, createCostTracker, createFakeProvider, createGeminiProvider, createGoalProgressTracker, createHookPipeline, createInMemorySigner, createLangfuseOtlpConfig, createLiteLLMProvider, createLmStudioProvider, createLocalArtifactStore, createMemoryArtifactStore, createMemoryKeySet, createMemorySessionStore, createNoopAgentHost, createNoopSurvivabilityAdapter, createOpenAICompatibleProvider, createOpenAIProvider, createOpenRouterProvider, createOtelReceiptAttributes, createOtelRunEventSink, createPermissionContext, createPermissionGuardHook, createPhoenixOtlpConfig, createRateLimitGroup, createRealtimeCheckpointContext, createRealtimeReceiptDescriptors, createReceipt, createRemoteReceiptSigner, createReplayEnvelope, createTranscriptStore, createXaiProvider, defaultPiiDetectors, defineAgent, defineTool, estimateRouteCost, evalAgentRun, evaluateContractAgainstRoute, evaluateTripwires, findCapabilityProfile, formatToolsForProvider, generateEd25519KeyPairJwk, getCapabilityProfile, getRecommendedSanitizers, getStructuredOutputContract, getToolUseContract, importMcpTools, inv, isTerminal, latticeVersion, materializeReplayEnvelope, negotiateCapabilities, output, parseToolUseEnvelope, permissionGuardRegisterOptions, realtimeStepName, receiptCid, redactArtifactRef, redactPlan, redactReplayEnvelope, replayOffline, rerunLive, runAgent, runAgentCrew, runTool, sanitizeRunEventAttributes, stripChatTemplateArtifacts, stripOpenRouterVariant, stripReasoningTags, synthesizeNegotiatedCapabilitiesFromRegistry, toolArtifactRef, toolSchemaToJsonSchema, unwrapInternalEnvelope, verifyReceipt, withRateLimit };
 //# sourceMappingURL=index.d.ts.map