@ocno/oryn-sdk 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,800 @@
+/** Website intent is data. Runtime, device, loader and download authority remain local. */
+interface SelectionModelRef {
+    provider: "huggingface";
+    repository: string;
+    revision?: string;
+    files?: string[];
+}
+type ModelSelection = {
+    version: 1;
+    intent: "source-checkpoint";
+    sourceCheckpoint: SelectionModelRef;
+} | {
+    version: 1;
+    intent: "preferred-variant";
+    sourceCheckpoint?: SelectionModelRef;
+} | {
+    version: 1;
+    intent: "exact-artifact";
+};
+interface SelectionExplanation {
+    version: 1;
+    kind: "requested-artifact" | "same-checkpoint" | "different-model";
+    source: "local-measurements" | "active-configuration" | "deterministic-default";
+    confidence: "measured" | "heuristic" | "unknown";
+    catalogVersion: number;
+    rulesVersion: number;
+    ruleIds: string[];
+    reasons: string[];
+}
+
+interface TaskContractRef {
+    id: string;
+    revision: number;
+}
+type TaskFeatureState = "supported" | "unsupported" | "unknown" | "requires-input";
+interface TaskParameter {
+    inputPointer: string;
+    valueSchema: Record<string, unknown>;
+    default?: unknown;
+    handling: "honored" | "fixed" | "unsupported" | "requires-input";
+    editable: boolean;
+    affects: Array<"result" | "memory" | "latency">;
+    unit?: string;
+}
+interface TaskProfile {
+    kind: "task-profile";
+    schemaVersion: 1;
+    profileId: string;
+    contract: TaskContractRef;
+    task: string;
+    inputModalities: Array<"text" | "image" | "audio" | "video" | "document">;
+    outputModalities: Array<"text" | "image" | "audio" | "video" | "embedding" | "structured">;
+    inputSchemaRef: string;
+    resultSchemaRef: string;
+    features: Record<string, TaskFeatureState>;
+    parameters: Record<string, TaskParameter>;
+    limits: Record<string, number>;
+    streamingChannels: string[];
+    extensions: Record<string, never>;
+    provenance: "runtime-tested" | "runtime-declared" | "adapter-derived" | "runtime-fallback";
+}
+interface TaskRequirements {
+    task?: string;
+    contract?: TaskContractRef;
+    requiredFeatures?: string[];
+    parameterValues?: Record<string, unknown>;
+    inputModalities?: TaskProfile["inputModalities"];
+    outputModalities?: TaskProfile["outputModalities"];
+}
+
+type ModelProvider = "huggingface";
+type InputModality = "text" | "image" | "audio" | "video" | "document";
+type OutputModality = "text" | "image" | "audio" | "video" | "embedding" | "structured";
+type BehavioralCapability = "chat" | "streaming" | "structuredOutput" | "toolCalling" | "imageEditing" | "inpainting" | "outpainting" | "speechRecognition" | "speechSynthesis" | "audioOutput" | "lyrics" | "deterministicSeed" | "multimodalConversation";
+interface RuntimeCapabilities {
+    runtimeAvailable: boolean;
+    runtimeState: "ready" | "starting" | "unavailable" | "error";
+    sdkVersion: string;
+    browserApiVersion?: string;
+    supportedModelProviders: ModelProvider[];
+    features: {
+        modelSelection?: boolean;
+        taskProfiles?: boolean;
+        modelRequests: boolean;
+        modelSubstitution: boolean;
+        streaming: boolean;
+        artifacts: boolean;
+        artifactUrls: boolean;
+        cancellation: boolean;
+        queueing: boolean;
+        multipleSubmittedJobs: boolean;
+    };
+    scheduler?: {
+        generation: {
+            globalAcrossOrigins: boolean;
+            maxConcurrentRunning: number;
+        };
+    };
+}
+/** Optional website-owned conveniences. All options default to disabled. */
+interface LocalAIClientOptions {
+    /**
+     * Show one website-owned explanation when this document is opened outside
+     * Oryn Browser. This never probes the network or grants Local AI authority.
+     */
+    showOrynBrowserAlert?: boolean;
+}
+interface ModelRef {
+    files?: string[];
+    provider: "huggingface";
+    repository: string;
+    revision?: string;
+}
+interface ResolvedModelRef {
+    files?: string[];
+    provider: "huggingface";
+    repository: string;
+    revision: string;
+    displayName?: string;
+    publisher?: string;
+    sourceUrl: string;
+}
+interface ModelRequirements extends TaskRequirements {
+    task?: string;
+    architectures?: string[];
+    parameters?: {
+        minBillions?: number;
+        maxBillions?: number;
+    };
+    minimumContextLength?: number;
+    inputModalities?: InputModality[];
+    outputModalities?: OutputModality[];
+    capabilities?: Partial<Record<BehavioralCapability, boolean>>;
+    memory?: {
+        maximumRecommendedBytes?: number;
+    };
+}
+interface ExplicitModelRequest {
+    selection?: ModelSelection;
+    role: string;
+    preferredModel: ModelRef;
+    certifiedModels?: ModelRef[];
+    requirements?: ModelRequirements;
+    substitution?: {
+        automatic?: "none" | "certified-only" | "same-checkpoint" | "compatible";
+    };
+}
+interface CapabilityModelRequest {
+    selection?: never;
+    role: string;
+    preferredModel?: never;
+    requirements: ModelRequirements & {
+        task: string;
+        outputModalities: OutputModality[];
+    };
+    substitution?: {
+        automatic?: "compatible";
+    };
+}
+interface CheckpointModelRequest {
+    role: string;
+    selection: Extract<ModelSelection, {
+        intent: 'source-checkpoint';
+    }>;
+    preferredModel?: never;
+    requirements?: ModelRequirements;
+    substitution?: {
+        automatic?: 'none' | 'same-checkpoint' | 'compatible';
+    };
+}
+type ModelRequest = ExplicitModelRequest | CapabilityModelRequest | CheckpointModelRequest;
+type ModelRequestProgress = {
+    stage: "resolving";
+} | {
+    stage: "awaiting-permission";
+} | {
+    stage: "awaiting-model-choice";
+} | {
+    stage: "downloading";
+    model: ResolvedModelRef;
+    downloadedBytes: number;
+    totalBytes?: number;
+} | {
+    stage: "loading";
+    model: ResolvedModelRef;
+    progress?: number;
+} | {
+    stage: "ready";
+    sessionId: string;
+};
+interface ModelRequestOptions {
+    signal?: AbortSignal;
+    onProgress?: (progress: ModelRequestProgress) => void;
+}
+interface CompatibilityReason {
+    code: string;
+    status: "satisfied" | "unknown" | "failed";
+    message?: string;
+}
+interface ModelResolution {
+    selection?: SelectionExplanation;
+    preferredModel: ResolvedModelRef;
+    resolvedModel: ResolvedModelRef;
+    compatibility: "certified" | "compatible" | "uncertain" | "incompatible";
+    executability: "executable" | "not-executable" | "unknown";
+    security: "allowed" | "blocked" | "developer-mode-required";
+    /** The browser, not the website, grants exact-revision trust after user consent. */
+    trust: "oryn-verified" | "user-approved-unverified";
+    developerCertified: boolean;
+    substituted: boolean;
+    overriddenByUser: boolean;
+    resolutionReason: "preferred-model" | "developer-certified-alternative" | "already-installed" | "site-preference" | "global-user-preference" | "automatic-compatible-substitution" | "capability-match" | "user-override";
+    compatibilityReasons: CompatibilityReason[];
+}
+interface ResolvedModelCapabilities {
+    task?: string;
+    architectures?: string[];
+    parameterCount?: number;
+    contextLength?: number;
+    inputModalities?: InputModality[];
+    outputModalities?: OutputModality[];
+    capabilities?: Partial<Record<BehavioralCapability, boolean | "unknown">>;
+}
+interface ModelSession {
+    taskProfile?: TaskProfile;
+    sessionId: string;
+    role: string;
+    origin: string;
+    resolution: ModelResolution;
+    capabilities: ResolvedModelCapabilities;
+}
+interface ArtifactReference {
+    id: string;
+    mimeType: string;
+    sizeBytes: number;
+    name?: string;
+}
+interface ArtifactMetadata extends ArtifactReference {
+    createdAt: number;
+    expiresAt?: number;
+    url?: string;
+}
+interface CreateArtifactOptions {
+    name?: string;
+    lifetime?: "ephemeral" | "session";
+}
+interface SaveArtifactOptions {
+    suggestedFilename?: string;
+}
+type InferenceResult = StructuredResult | ArtifactResult | MultiResult;
+interface StructuredResult {
+    kind: "structured";
+    value: unknown;
+}
+interface ArtifactResult {
+    kind: "artifact";
+    artifact: ArtifactMetadata;
+}
+interface MultiResult {
+    kind: "multi";
+    outputs: InferenceResult[];
+}
+interface ModelInvocationRequest<TInput = unknown> {
+    sessionId: string;
+    input: TInput;
+}
+type JobState = "created" | "queued" | "loading" | "running" | "streaming" | "saving" | "completed" | "failed" | "cancelled";
+interface JobQueueStatus {
+    lane: "generation";
+    position: number;
+    jobsAhead: number;
+    reason: "generation-slot" | "model-loading" | "resource-policy";
+}
+interface JobReference {
+    jobId: string;
+    sessionId: string;
+    state: "created" | "queued" | "loading" | "running";
+    queue?: JobQueueStatus;
+}
+interface LocalAIEventBase {
+    event: string;
+    timestamp: number;
+    jobId: string;
+    sessionId: string;
+    sequence: number;
+}
+type LocalAIEvent = LocalAIEventBase & ({
+    event: "job.state";
+    data: {
+        state: "queued" | "loading" | "running" | "streaming" | "saving";
+        queue?: JobQueueStatus;
+    };
+} | {
+    event: "job.queue.updated";
+    data: JobQueueStatus;
+} | {
+    event: "job.progress";
+    data: {
+        progress?: number;
+        stage?: string;
+    };
+} | {
+    event: "job.output.delta";
+    data: {
+        channel: string;
+        delta: unknown;
+    };
+} | {
+    event: "job.preview";
+    data: {
+        artifactId: string;
+    };
+} | {
+    event: "job.completed";
+    data: {
+        result: InferenceResult;
+    };
+} | {
+    event: "job.failed";
+    data: {
+        error: SerializedLocalAIError;
+    };
+} | {
+    event: "job.cancelled";
+    data: {
+        reason?: "website" | "user" | "resource-policy" | "runtime-shutdown";
+    };
+});
+type LocalAIErrorCode = "RUNTIME_NOT_AVAILABLE" | "RUNTIME_STARTING" | "RUNTIME_PROTOCOL_ERROR" | "RUNTIME_DEPENDENCY_UNAVAILABLE" | "UNAUTHORIZED_ORIGIN" | "UNAUTHORIZED_FRAME" | "PERMISSION_DENIED" | "USER_DENIED" | "MODEL_REFERENCE_INVALID" | "MODEL_SOURCE_INVALID" | "MODEL_REVISION_INVALID" | "MODEL_NOT_FOUND" | "MODEL_METADATA_INVALID" | "MODEL_NOT_EXECUTABLE" | "MODEL_SECURITY_BLOCKED" | "CUSTOM_CODE_REQUIRED" | "UNSAFE_MODEL_FORMAT" | "NO_EXECUTABLE_MODEL" | "DOWNLOAD_REQUIRED" | "RESOURCE_REQUIREMENTS_UNSATISFIABLE" | "RESOURCE_LIMIT_EXCEEDED" | "DISK_SPACE_INSUFFICIENT" | "MODEL_OUT_OF_MEMORY" | "MODEL_LOAD_FAILED" | "MODEL_NOT_LOADED" | "SESSION_NOT_FOUND" | "SESSION_ACCESS_DENIED" | "SESSION_RELEASED" | "REQUEST_ABORTED" | "ARTIFACT_NOT_FOUND" | "ARTIFACT_ACCESS_DENIED" | "ARTIFACT_EXPIRED" | "ARTIFACT_INVALID" | "ARTIFACT_IO_ERROR" | "ARTIFACT_PATH_INVALID" | "ARTIFACT_BINDING_INVALID" | "AUDIO_FORMAT_UNSUPPORTED" | "AUDIO_TOO_LARGE" | "AUDIO_DECODE_FAILED" | "AUDIO_PROCESSING_FAILED" | "JOB_NOT_FOUND" | "JOB_ACCESS_DENIED" | "JOB_INPUT_INVALID" | "JOB_ID_CONFLICT" | "JOB_QUEUE_FULL" | "JOB_EXECUTION_FAILED" | "JOB_CANCELLED" | "MODEL_OUTPUT_FILTERED" | "ASR_INFERENCE_FAILED" | "ASR_OUTPUT_INVALID" | "ALIGNMENT_LANGUAGE_UNSUPPORTED" | "ALIGNMENT_OUTPUT_INVALID" | "SONG_GENERATION_FAILED" | "SONG_OUTPUT_INVALID" | "RUNNER_NOT_AVAILABLE";
+interface SerializedLocalAIError {
+    code: LocalAIErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+}
+type BridgeResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: SerializedLocalAIError;
+};
+interface InjectedLocalAI {
+    readonly sdkVersion: string;
+    getCapabilities(): Promise<RuntimeCapabilities>;
+    requestModel(operationId: string, request: ModelRequest): Promise<BridgeResult<ModelSession>>;
+    cancelModelRequest(operationId: string): Promise<void>;
+    releaseModelSession(sessionId: string): Promise<BridgeResult<void>>;
+    onModelRequestProgress(operationId: string, listener: (progress: ModelRequestProgress) => void): () => void;
+    beginArtifactCreate(metadata: {
+        mimeType: string;
+        sizeBytes: number;
+        name?: string;
+        lifetime?: "ephemeral" | "session";
+    }): Promise<BridgeResult<{
+        uploadId: string;
+    }>>;
+    appendArtifactChunk(uploadId: string, chunk: ArrayBuffer): Promise<BridgeResult<void>>;
+    finishArtifactCreate(uploadId: string): Promise<BridgeResult<ArtifactReference>>;
+    abortArtifactCreate(uploadId: string): Promise<void>;
+    getArtifact(artifactId: string): Promise<BridgeResult<ArtifactMetadata>>;
+    getArtifactUrl(artifactId: string): Promise<BridgeResult<string>>;
+    saveArtifactAs(artifactId: string, options?: SaveArtifactOptions): Promise<BridgeResult<void>>;
+    releaseArtifact(artifactId: string): Promise<BridgeResult<void>>;
+    invokeJob(request: ModelInvocationRequest): Promise<BridgeResult<JobReference>>;
+    cancelJob(jobId: string): Promise<BridgeResult<void>>;
+    onJobEvent(listener: (event: LocalAIEvent) => void): () => void;
+}
+interface LocalAIClient {
+    readonly sdkVersion: string;
+    getCapabilities(): Promise<RuntimeCapabilities>;
+    models: {
+        request(request: ModelRequest, options?: ModelRequestOptions): Promise<ModelSession>;
+        releaseSession(sessionId: string): Promise<void>;
+    };
+    artifacts: {
+        create(input: Blob | File, options?: CreateArtifactOptions): Promise<ArtifactReference>;
+        get(artifactId: string): Promise<ArtifactMetadata>;
+        getUrl(artifactId: string): Promise<string>;
+        readBlob(artifactId: string): Promise<Blob>;
+        saveAs(artifactId: string, options?: SaveArtifactOptions): Promise<void>;
+        release(artifactId: string): Promise<void>;
+    };
+    invoke<TInput = unknown>(request: ModelInvocationRequest<TInput>): Promise<JobReference>;
+    cancel(jobId: string): Promise<void>;
+    subscribe(listener: (event: LocalAIEvent) => void): () => void;
+}
+
+declare const SDK_VERSION = "0.1.0";
+declare class LocalAIError extends Error {
+    readonly code: LocalAIErrorCode;
+    readonly details?: Record<string, unknown>;
+    constructor(error: SerializedLocalAIError);
+}
+declare function createLocalAIClient(options?: LocalAIClientOptions): LocalAIClient;
+declare function invokeAndWait<TInput = unknown, TResult extends InferenceResult = InferenceResult>(client: LocalAIClient, request: ModelInvocationRequest<TInput>, options?: {
+    signal?: AbortSignal;
+    onEvent?: (event: LocalAIEvent) => void;
+}): Promise<TResult>;
+declare function invokeStream<TInput = unknown>(client: LocalAIClient, request: ModelInvocationRequest<TInput>, options?: {
+    signal?: AbortSignal;
+}): AsyncIterable<LocalAIEvent>;
+
+/** Closed additive task contracts. Unknown tasks remain unavailable on older peers. */
+interface SharedTaskInputs {
+    "unconditional-image-generation-v1": {
+        "width"?: number;
+        "height"?: number;
+        "steps"?: number;
+        "seed"?: number;
+    };
+    "audio-question-answering-v1": {
+        "audioArtifactId": string;
+        "instruction": string;
+        "maxTokens"?: number;
+    };
+    "audio-transformation-v1": {
+        "operation": "enhance" | "separate" | "voice-conversion" | "encode" | "decode" | "vocode";
+        "audioArtifactId"?: string;
+        "referenceAudioArtifactId"?: string;
+        "codes"?: ((number)[])[];
+        "spectrogram"?: ((number)[])[];
+        "sampleRate"?: number;
+    };
+    "multimodal-generation-v1": {
+        "instruction": string;
+        "imageArtifactId"?: string;
+        "audioArtifactId"?: string;
+        "inputMode": "image" | "audio" | "image-and-audio";
+        "outputMode"?: "text" | "audio" | "text-and-audio";
+        "maxTokens"?: number;
+    };
+    "image-text-to-video-v1": {
+        "imageArtifactId": string;
+        "prompt": string;
+        "width"?: number;
+        "height"?: number;
+        "frames"?: number;
+        "fps"?: number;
+        "steps"?: number;
+        "guidanceScale"?: number;
+        "seed"?: number;
+    };
+    "video-editing-v1": {
+        "videoArtifactId": string;
+        "prompt"?: string;
+        "maskVideoArtifactId"?: string;
+        "operation"?: "edit" | "restore";
+        "startSeconds"?: number;
+        "durationSeconds"?: number;
+        "width"?: number;
+        "height"?: number;
+        "frames"?: number;
+        "fps"?: number;
+        "steps"?: number;
+        "guidanceScale"?: number;
+        "seed"?: number;
+    };
+    "tabular-classification-v1": {
+        "columns": ({
+            "name": string;
+            "type": "numeric" | "categorical";
+        })[];
+        "trainingRows": ((number | string | null)[])[];
+        "queryRows": ((number | string | null)[])[];
+        "targets": (string)[];
+    };
+    "tabular-regression-v1": {
+        "columns": ({
+            "name": string;
+            "type": "numeric" | "categorical";
+        })[];
+        "trainingRows": ((number | string | null)[])[];
+        "queryRows": ((number | string | null)[])[];
+        "targets": (number)[];
+    };
+    "time-series-forecasting-v1": {
+        "context": (number)[];
+        "horizon"?: number;
+        "quantiles"?: (number)[];
+        "timestamps"?: (number)[];
+        "frequencyMilliseconds"?: number;
+        "pastCovariates"?: ((number)[])[];
+        "futureCovariates"?: ((number)[])[];
+    };
+    "pose-estimation-v1": {
+        "imageArtifactId": string;
+        "boxes": ((number)[])[];
+    };
+    "visual-document-retrieval-v1": {
+        imageArtifactId: string;
+        queries: string[];
+    };
+    "table-question-answering-v1": {
+        question: string;
+        columns: string[];
+        rows: string[][];
+    };
+    "document-question-answering-v1": {
+        imageArtifactId: string;
+        question: string;
+        words: string[];
+        boxes: [number, number, number, number][];
+    };
+    "keypoint-detection-v1": {
+        imageArtifactId: string;
+        threshold?: number;
+        maxKeypoints?: number;
+    };
+    "video-classification-v1": {
+        videoArtifactId: string;
+        startSeconds?: number;
+        durationSeconds?: number;
+        topK?: number;
+    };
+    "video-question-answering-v1": {
+        videoArtifactId: string;
+        question: string;
+        startSeconds?: number;
+        durationSeconds?: number;
+        maxTokens?: number;
+    };
+    "voice-activity-detection-v1": {
+        audioArtifactId: string;
+        threshold?: number;
+        minSpeechSeconds?: number;
+        minSilenceSeconds?: number;
+    };
+    "image-editing-v1": {
+        imageArtifactId: string;
+        referenceImageArtifactIds?: string[];
+        prompt: string;
+        negativePrompt?: string;
+        width?: number;
+        height?: number;
+        steps?: number;
+        guidanceScale?: number;
+        seed?: number;
+    };
+    "image-layers-v1": {
+        imageArtifactId: string;
+        prompt: string;
+        negativePrompt?: string;
+        resolution?: 640 | 1024;
+        layers?: number;
+        steps?: number;
+        guidanceScale?: number;
+        seed?: number;
+    };
+    "zero-shot-classification-v1": {
+        text: string;
+        labels: string[];
+        multiLabel?: boolean;
+    };
+    "image-embeddings-v1": {
+        imageArtifactId: string;
+        normalize?: boolean;
+    };
+    "image-segmentation-v1": {
+        imageArtifactId: string;
+    };
+    "mask-generation-v1": {
+        imageArtifactId: string;
+        points: {
+            x: number;
+            y: number;
+            label: 0 | 1;
+        }[];
+    };
+    "zero-shot-object-detection-v1": {
+        imageArtifactId: string;
+        labels: string[];
+        threshold?: number;
+    };
+    "image-to-text-v1": {
+        imageArtifactId: string;
+        maxTokens?: number;
+    };
+    "visual-question-answering-v1": {
+        imageArtifactId: string;
+        question: string;
+        maxTokens?: number;
+    };
+}
+type SharedTaskContract = keyof SharedTaskInputs;
+declare const SHARED_TASK_CONTRACTS: readonly ["unconditional-image-generation-v1", "audio-question-answering-v1", "audio-transformation-v1", "multimodal-generation-v1", "image-text-to-video-v1", "video-editing-v1", "tabular-classification-v1", "tabular-regression-v1", "time-series-forecasting-v1", "pose-estimation-v1", "visual-document-retrieval-v1", "table-question-answering-v1", "document-question-answering-v1", "keypoint-detection-v1", "video-classification-v1", "video-question-answering-v1", "voice-activity-detection-v1", "image-editing-v1", "image-layers-v1", "zero-shot-classification-v1", "image-embeddings-v1", "image-segmentation-v1", "mask-generation-v1", "zero-shot-object-detection-v1", "image-to-text-v1", "visual-question-answering-v1"];
+type SpatialMaskResult = {
+    kind: "artifact";
+    artifact: ArtifactMetadata;
+} | {
+    kind: "multi";
+    outputs: [
+        {
+            kind: "artifact";
+            artifact: ArtifactMetadata;
+        },
+        {
+            kind: "structured";
+            value: {
+                width: number;
+                height: number;
+                encoding: "class-id-16bit" | "binary-8bit";
+                segments: {
+                    id: number;
+                    label: string;
+                    pixelCount: number;
+                }[];
+            };
+        }
+    ];
+};
+/** Structured values, or the existing artifact/multi wrapper for spatial masks. */
+interface SharedTaskOutputs {
+    "unconditional-image-generation-v1": {
+        "kind": "artifact";
+        "artifact": ArtifactMetadata;
+    };
+    "audio-question-answering-v1": {
+        "text": string;
+    };
+    "audio-transformation-v1": {
+        "kind": "artifact";
+        "artifact": ArtifactMetadata;
+    } | {
+        "kind": "multi";
+        "outputs": ({
+            "kind": "artifact";
+            "artifact": ArtifactMetadata;
+        })[];
+    } | {
+        "kind": "structured";
+        "value": {
+            "codes": ((number)[])[];
+            "sampleRate": number;
+            "durationSeconds": number;
+        };
+    };
+    "multimodal-generation-v1": {
+        "kind": "structured";
+        "value": {
+            "text": string;
+        };
+    } | {
+        "kind": "artifact";
+        "artifact": ArtifactMetadata;
+    } | {
+        "kind": "multi";
+        "outputs": [{
+            "kind": "structured";
+            "value": {
+                "text": string;
+            };
+        }, {
+            "kind": "artifact";
+            "artifact": ArtifactMetadata;
+        }];
+    };
+    "image-text-to-video-v1": {
+        "kind": "artifact";
+        "artifact": ArtifactMetadata;
+    };
+    "video-editing-v1": {
+        "kind": "artifact";
+        "artifact": ArtifactMetadata;
+    };
+    "tabular-classification-v1": {
+        "classes": (string)[];
+        "predictions": ({
+            "label": string;
+            "probabilities": (number)[];
+        })[];
+    };
+    "tabular-regression-v1": {
+        "predictions": (number)[];
+    };
+    "time-series-forecasting-v1": {
+        "predictions": (number)[];
+        "quantiles": ({
+            "level": number;
+            "values": (number)[];
+        })[];
+        "timestamps"?: (number)[];
+    };
+    "pose-estimation-v1": {
+        "width": number;
+        "height": number;
+        "poses": ({
+            "box": (number)[];
+            "keypoints": ({
+                "id": number;
+                "label": string;
+                "x": number;
+                "y": number;
+                "confidence": number;
+                "visible": boolean;
+            })[];
+        })[];
+    };
+    "visual-document-retrieval-v1": {
+        dimensions: 128 | 320 | 4096;
+        normalized: true;
+        scoring: "sum-max-cosine" | "mean-max-cosine";
+        documentVectors: number[][];
+        queries: {
+            vectors: number[][];
+            score: number;
+        }[];
+    };
+    "table-question-answering-v1": {
+        answer: string;
+        cells: {
+            row: number;
+            column: number;
+            text: string;
+        }[];
+        aggregation: "none" | "sum" | "average" | "count" | "generated";
+    };
+    "document-question-answering-v1": {
+        answer: string;
+        score: number;
+        wordStart: number;
+        wordEnd: number;
+        box: [number, number, number, number];
+    };
+    "keypoint-detection-v1": {
+        width: number;
+        height: number;
+        keypoints: {
+            x: number;
+            y: number;
+            score: number;
+        }[];
+    };
+    "video-classification-v1": {
+        predictions: {
+            label: string;
+            score: number;
+        }[];
+        sampledTimestamps: number[];
+        durationSeconds: number;
+    };
+    "video-question-answering-v1": {
+        text: string;
+        sampledTimestamps: number[];
+        durationSeconds: number;
+    };
+    "voice-activity-detection-v1": {
+        segments: {
+            start: number;
+            end: number;
+        }[];
+        durationSeconds: number;
+    };
+    "image-editing-v1": {
+        kind: "artifact";
+        artifact: ArtifactMetadata;
+    };
+    "image-layers-v1": {
+        kind: "multi";
+        outputs: {
+            kind: "artifact";
+            artifact: ArtifactMetadata;
+        }[];
+    };
+    "image-segmentation-v1": SpatialMaskResult;
+    "mask-generation-v1": SpatialMaskResult;
+    "zero-shot-classification-v1": {
+        predictions: {
+            label: string;
+            score: number;
+        }[];
+        multiLabel: boolean;
+    };
+    "image-embeddings-v1": {
+        vector: number[];
+        dimensions: number;
+        normalized: boolean;
+        pooling: "cls";
+    };
+    "zero-shot-object-detection-v1": {
+        detections: {
+            label: string;
+            score: number;
+            box: [number, number, number, number];
+        }[];
+        width: number;
+        height: number;
+    };
+    "image-to-text-v1": {
+        text: string;
+    };
+    "visual-question-answering-v1": {
+        text: string;
+    };
+}
+
+declare const SHARED_MODEL_TASK_CONTRACTS: Readonly<Record<string, SharedTaskContract>>;
+/** Canonical data validation only. Browser still owns permissions and artifact leases. */
+declare function validateSharedTaskInput<C extends SharedTaskContract>(contract: C, input: unknown): SharedTaskInputs[C];
+
+export { type ArtifactMetadata, type ArtifactReference, type ArtifactResult, type BehavioralCapability, type BridgeResult, type CapabilityModelRequest, type CheckpointModelRequest, type CompatibilityReason, type CreateArtifactOptions, type ExplicitModelRequest, type InferenceResult, type InjectedLocalAI, type InputModality, type JobQueueStatus, type JobReference, type JobState, type LocalAIClient, type LocalAIClientOptions, LocalAIError, type LocalAIErrorCode, type LocalAIEvent, type LocalAIEventBase, type ModelInvocationRequest, type ModelProvider, type ModelRef, type ModelRequest, type ModelRequestOptions, type ModelRequestProgress, type ModelRequirements, type ModelResolution, type ModelSelection, type ModelSession, type MultiResult, type OutputModality, type ResolvedModelCapabilities, type ResolvedModelRef, type RuntimeCapabilities, SDK_VERSION, SHARED_MODEL_TASK_CONTRACTS, SHARED_TASK_CONTRACTS, type SaveArtifactOptions, type SelectionExplanation, type SerializedLocalAIError, type SharedTaskContract, type SharedTaskInputs, type SharedTaskOutputs, type SpatialMaskResult, type StructuredResult, type TaskContractRef, type TaskFeatureState, type TaskParameter, type TaskProfile, type TaskRequirements, createLocalAIClient, invokeAndWait, invokeStream, validateSharedTaskInput };