@vetta-org/plugin-sdk 0.1.1 → 0.3.0

package/dist/media.d.ts

@@ -0,0 +1,193 @@
+import type { PluginArtifactRef } from "./artifacts.js";
+import type { Disposable } from "./disposable.js";
+import type { PluginJob, PluginJobFailure } from "./jobs.js";
+export type PluginMediaKind = "image" | "video" | "audio" | "document";
+export type PluginMediaOutputKind = "image" | "video" | "audio";
+export type PluginMediaOperation = "generate" | "compose" | "transcode";
+export type PluginMediaGenerationMode = "text-to-image" | "image-to-image" | "text-to-video" | "image-to-video" | "video-to-video" | "reference-to-video";
+export type PluginMediaErrorCode = "unauthenticated" | "provider-unavailable" | "operation-unsupported" | "invalid-request" | "not-entitled" | "quota-exhausted" | "content-rejected" | "provider-timeout" | "provider-failed" | "cancelled";
+export interface PluginMediaFailure extends PluginJobFailure {
+    code: PluginMediaErrorCode;
+}
+export declare class PluginMediaError extends Error {
+    readonly code: PluginMediaErrorCode;
+    readonly retryable: boolean;
+    constructor(failure: PluginMediaFailure);
+}
+export interface PluginMediaDimensions {
+    width: number;
+    height: number;
+}
+export type PluginMediaInputSource = {
+    type: "plugin-blob";
+    blobId: string;
+} | {
+    type: "workspace-file";
+    path: string;
+};
+export interface PluginMediaInput {
+    id?: string;
+    role?: string;
+    kind: PluginMediaKind;
+    mimeType?: string;
+    source: PluginMediaInputSource;
+}
+export interface PluginMediaOutput {
+    kind: PluginMediaOutputKind;
+    mimeType: string;
+    dimensions?: PluginMediaDimensions;
+    fps?: number;
+    durationSeconds?: number;
+    videoCodec?: string;
+    audioCodec?: string;
+}
+export interface PluginMediaArtifact extends PluginArtifactRef {
+    kind: PluginMediaOutputKind;
+    width?: number;
+    height?: number;
+    durationSeconds?: number;
+}
+export interface PluginMediaGenerateRequest {
+    operation: "generate";
+    providerId: string;
+    kind: "image" | "video";
+    mode: PluginMediaGenerationMode;
+    prompt: string;
+    modelId?: string;
+    dimensions?: PluginMediaDimensions;
+    aspectRatio?: string;
+    resolution?: string;
+    durationSeconds?: number;
+    inputs?: readonly PluginMediaInput[];
+}
+export interface PluginMediaComposeRequest {
+    operation: "compose";
+    providerId: string;
+    inputs: readonly PluginMediaInput[];
+    output: PluginMediaOutput;
+}
+export interface PluginMediaTranscodeRequest {
+    operation: "transcode";
+    providerId: string;
+    inputs: readonly PluginMediaInput[];
+    output: PluginMediaOutput;
+}
+export type PluginMediaSubmitRequest = PluginMediaGenerateRequest | PluginMediaComposeRequest | PluginMediaTranscodeRequest;
+export interface PluginMediaGenerationInputSlot {
+    role: string;
+    kinds: readonly PluginMediaKind[];
+    minItems: number;
+    maxItems: number;
+}
+export interface PluginMediaGenerationModeCapability {
+    mode: PluginMediaGenerationMode;
+    inputs: readonly PluginMediaGenerationInputSlot[];
+    minTotalItems?: number;
+    maxTotalItems?: number;
+    aspectRatioPolicy?: "configurable" | "input-derived";
+    audioGeneration?: "none" | "always" | "optional";
+}
+export type PluginMediaCapability = {
+    operation: "generate";
+    kind: "image" | "video";
+    modes: readonly PluginMediaGenerationMode[];
+    aspectRatios?: readonly string[];
+    /** Provider-defined stable option ids; consumers must not infer pixel dimensions from their names. */
+    resolutions?: readonly string[];
+    /** Preferred option when the consumer has no supported persisted resolution. */
+    defaultResolution?: string;
+    durationsSeconds?: readonly number[];
+    modeCapabilities?: readonly PluginMediaGenerationModeCapability[];
+} | {
+    operation: "compose";
+    documentMimeTypes: readonly string[];
+    outputMimeTypes: readonly string[];
+} | {
+    operation: "transcode";
+    inputMimeTypes: readonly string[];
+    outputMimeTypes: readonly string[];
+};
+export interface PluginMediaProviderDescriptor {
+    /** Host-qualified provider id. */
+    id: string;
+    displayName?: string;
+    ownerId: string;
+    protocolVersion: number;
+    capabilities: readonly PluginMediaCapability[];
+}
+export type PluginMediaJob = Omit<PluginJob<PluginMediaArtifact>, "error"> & {
+    error?: PluginMediaFailure;
+};
+/** A media input exposed to its provider without revealing its storage location. */
+export interface PluginMediaProviderInput {
+    id: string;
+    role?: string;
+    kind: PluginMediaKind;
+    mimeType?: string;
+}
+type ProviderRequest<Request extends PluginMediaSubmitRequest> = Omit<Request, "providerId" | "inputs"> & {
+    readonly inputs: readonly PluginMediaProviderInput[];
+};
+export type PluginMediaProviderSubmitRequest = PluginMediaSubmitRequest extends infer Request ? Request extends PluginMediaSubmitRequest ? ProviderRequest<Request> : never : never;
+export interface PluginMediaInputUploadRequest {
+    url: string;
+    fieldName: string;
+    fileName?: string;
+    fields?: Record<string, string>;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+}
+export interface PluginMediaTransferResponse<T = unknown> {
+    ok: boolean;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    body: T;
+}
+export interface PluginMediaProviderHandlerContext {
+    readonly invocationId: string;
+    uploadInput<T = unknown>(inputId: string, request: PluginMediaInputUploadRequest): Promise<PluginMediaTransferResponse<T>>;
+}
+export type PluginMediaProviderArtifactSource = {
+    type: "remote-url";
+    url: string;
+    headers?: Record<string, string>;
+} | {
+    type: "plugin-blob";
+    blobId: string;
+} | {
+    type: "workspace-file";
+    path: string;
+};
+export interface PluginMediaProviderArtifact {
+    kind: PluginMediaOutputKind;
+    mimeType?: string;
+    name?: string;
+    width?: number;
+    height?: number;
+    durationSeconds?: number;
+    source: PluginMediaProviderArtifactSource;
+}
+export interface PluginMediaProviderJob {
+    id: string;
+    status: PluginMediaJob["status"];
+    progress?: number;
+    artifacts?: readonly PluginMediaProviderArtifact[];
+    error?: PluginMediaFailure;
+}
+export interface PluginMediaProviderRegistration {
+    id: string;
+    displayName?: string;
+    capabilities: readonly PluginMediaCapability[];
+    submit(request: PluginMediaProviderSubmitRequest, context: PluginMediaProviderHandlerContext): Promise<PluginMediaProviderJob>;
+    getJob?(jobId: string, context: PluginMediaProviderHandlerContext): Promise<PluginMediaProviderJob>;
+    cancelJob?(jobId: string, context: PluginMediaProviderHandlerContext): Promise<PluginMediaProviderJob>;
+}
+export interface PluginMediaApi {
+    registerProvider(registration: PluginMediaProviderRegistration): Disposable;
+    listProviders(): Promise<readonly PluginMediaProviderDescriptor[]>;
+    onProvidersChanged(listener: () => void): Disposable;
+    submit(request: PluginMediaSubmitRequest): Promise<PluginMediaJob>;
+}
+export {};
+//# sourceMappingURL=media.d.ts.map

package/dist/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7D,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AACvE,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAChE,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAExE,MAAM,MAAM,yBAAyB,GAClC,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,CAAC;AAExB,MAAM,MAAM,oBAAoB,GAC7B,iBAAiB,GACjB,sBAAsB,GACtB,uBAAuB,GACvB,iBAAiB,GACjB,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,GACjB,WAAW,CAAC;AAEf,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC3D,IAAI,EAAE,oBAAoB,CAAC;CAC3B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,YAAY,OAAO,EAAE,kBAAkB,EAKtC;CACD;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,sBAAsB,GAC/B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,sBAAsB,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC7D,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IAC1C,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,IAAI,EAAE,yBAAyB,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,yBAAyB;IACzC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpC,MAAM,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC3C,SAAS,EAAE,WAAW,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpC,MAAM,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,MAAM,wBAAwB,GACjC,0BAA0B,GAC1B,yBAAyB,GACzB,2BAA2B,CAAC;AAE/B,MAAM,WAAW,8BAA8B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mCAAmC;IACnD,IAAI,EAAE,yBAAyB,CAAC;IAChC,MAAM,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,cAAc,GAAG,eAAe,CAAC;IACrD,eAAe,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;CACjD;AAED,MAAM,MAAM,qBAAqB,GAC9B;IACA,SAAS,EAAE,UAAU,CAAC;IACtB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,KAAK,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5C,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,sGAAsG;IACtG,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,gBAAgB,CAAC,EAAE,SAAS,mCAAmC,EAAE,CAAC;CACjE,GACD;IACA,SAAS,EAAE,SAAS,CAAC;IACrB,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,GACD;IACA,SAAS,EAAE,WAAW,CAAC;IACvB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC;AAEL,MAAM,WAAW,6BAA6B;IAC7C,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC/C;AAED,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC,GAAG;IAC5E,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC3B,CAAC;AAEF,oFAAoF;AACpF,MAAM,WAAW,wBAAwB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,eAAe,CAAC,OAAO,SAAS,wBAAwB,IAAI,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,CAAC,GAAG;IACzG,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAC3C,wBAAwB,SAAS,MAAM,OAAO,GAC3C,OAAO,SAAS,wBAAwB,GACvC,eAAe,CAAC,OAAO,CAAC,GACxB,KAAK,GACN,KAAK,CAAC;AAEV,MAAM,WAAW,6BAA6B;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B,CAAC,CAAC,GAAG,OAAO;IACvD,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;CACR;AAED,MAAM,WAAW,iCAAiC;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,CAAC,GAAG,OAAO,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,6BAA6B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,iCAAiC,GAC1C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,2BAA2B;IAC3C,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,iCAAiC,CAAC;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACnD,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC/C,MAAM,CACL,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,iCAAiC,GACxC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,iCAAiC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACpG,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,iCAAiC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACvG;AAED,MAAM,WAAW,cAAc;IAC9B,gBAAgB,CAAC,YAAY,EAAE,+BAA+B,GAAG,UAAU,CAAC;IAC5E,aAAa,IAAI,OAAO,CAAC,SAAS,6BAA6B,EAAE,CAAC,CAAC;IACnE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,UAAU,CAAC;IACrD,MAAM,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACnE","sourcesContent":["import type { PluginArtifactRef } from \"./artifacts.js\";\nimport type { Disposable } from \"./disposable.js\";\nimport type { PluginJob, PluginJobFailure } from \"./jobs.js\";\n\nexport type PluginMediaKind = \"image\" | \"video\" | \"audio\" | \"document\";\nexport type PluginMediaOutputKind = \"image\" | \"video\" | \"audio\";\nexport type PluginMediaOperation = \"generate\" | \"compose\" | \"transcode\";\n\nexport type PluginMediaGenerationMode =\n\t| \"text-to-image\"\n\t| \"image-to-image\"\n\t| \"text-to-video\"\n\t| \"image-to-video\"\n\t| \"video-to-video\"\n\t| \"reference-to-video\";\n\nexport type PluginMediaErrorCode =\n\t| \"unauthenticated\"\n\t| \"provider-unavailable\"\n\t| \"operation-unsupported\"\n\t| \"invalid-request\"\n\t| \"not-entitled\"\n\t| \"quota-exhausted\"\n\t| \"content-rejected\"\n\t| \"provider-timeout\"\n\t| \"provider-failed\"\n\t| \"cancelled\";\n\nexport interface PluginMediaFailure extends PluginJobFailure {\n\tcode: PluginMediaErrorCode;\n}\n\nexport class PluginMediaError extends Error {\n\treadonly code: PluginMediaErrorCode;\n\treadonly retryable: boolean;\n\n\tconstructor(failure: PluginMediaFailure) {\n\t\tsuper(failure.message);\n\t\tthis.name = \"PluginMediaError\";\n\t\tthis.code = failure.code;\n\t\tthis.retryable = failure.retryable;\n\t}\n}\n\nexport interface PluginMediaDimensions {\n\twidth: number;\n\theight: number;\n}\n\nexport type PluginMediaInputSource =\n\t| { type: \"plugin-blob\"; blobId: string }\n\t| { type: \"workspace-file\"; path: string };\n\nexport interface PluginMediaInput {\n\tid?: string;\n\trole?: string;\n\tkind: PluginMediaKind;\n\tmimeType?: string;\n\tsource: PluginMediaInputSource;\n}\n\nexport interface PluginMediaOutput {\n\tkind: PluginMediaOutputKind;\n\tmimeType: string;\n\tdimensions?: PluginMediaDimensions;\n\tfps?: number;\n\tdurationSeconds?: number;\n\tvideoCodec?: string;\n\taudioCodec?: string;\n}\n\nexport interface PluginMediaArtifact extends PluginArtifactRef {\n\tkind: PluginMediaOutputKind;\n\twidth?: number;\n\theight?: number;\n\tdurationSeconds?: number;\n}\n\nexport interface PluginMediaGenerateRequest {\n\toperation: \"generate\";\n\tproviderId: string;\n\tkind: \"image\" | \"video\";\n\tmode: PluginMediaGenerationMode;\n\tprompt: string;\n\tmodelId?: string;\n\tdimensions?: PluginMediaDimensions;\n\taspectRatio?: string;\n\tresolution?: string;\n\tdurationSeconds?: number;\n\tinputs?: readonly PluginMediaInput[];\n}\n\nexport interface PluginMediaComposeRequest {\n\toperation: \"compose\";\n\tproviderId: string;\n\tinputs: readonly PluginMediaInput[];\n\toutput: PluginMediaOutput;\n}\n\nexport interface PluginMediaTranscodeRequest {\n\toperation: \"transcode\";\n\tproviderId: string;\n\tinputs: readonly PluginMediaInput[];\n\toutput: PluginMediaOutput;\n}\n\nexport type PluginMediaSubmitRequest =\n\t| PluginMediaGenerateRequest\n\t| PluginMediaComposeRequest\n\t| PluginMediaTranscodeRequest;\n\nexport interface PluginMediaGenerationInputSlot {\n\trole: string;\n\tkinds: readonly PluginMediaKind[];\n\tminItems: number;\n\tmaxItems: number;\n}\n\nexport interface PluginMediaGenerationModeCapability {\n\tmode: PluginMediaGenerationMode;\n\tinputs: readonly PluginMediaGenerationInputSlot[];\n\tminTotalItems?: number;\n\tmaxTotalItems?: number;\n\taspectRatioPolicy?: \"configurable\" | \"input-derived\";\n\taudioGeneration?: \"none\" | \"always\" | \"optional\";\n}\n\nexport type PluginMediaCapability =\n\t| {\n\t\t\toperation: \"generate\";\n\t\t\tkind: \"image\" | \"video\";\n\t\t\tmodes: readonly PluginMediaGenerationMode[];\n\t\t\taspectRatios?: readonly string[];\n\t\t\t/** Provider-defined stable option ids; consumers must not infer pixel dimensions from their names. */\n\t\t\tresolutions?: readonly string[];\n\t\t\t/** Preferred option when the consumer has no supported persisted resolution. */\n\t\t\tdefaultResolution?: string;\n\t\t\tdurationsSeconds?: readonly number[];\n\t\t\tmodeCapabilities?: readonly PluginMediaGenerationModeCapability[];\n\t  }\n\t| {\n\t\t\toperation: \"compose\";\n\t\t\tdocumentMimeTypes: readonly string[];\n\t\t\toutputMimeTypes: readonly string[];\n\t  }\n\t| {\n\t\t\toperation: \"transcode\";\n\t\t\tinputMimeTypes: readonly string[];\n\t\t\toutputMimeTypes: readonly string[];\n\t  };\n\nexport interface PluginMediaProviderDescriptor {\n\t/** Host-qualified provider id. */\n\tid: string;\n\tdisplayName?: string;\n\townerId: string;\n\tprotocolVersion: number;\n\tcapabilities: readonly PluginMediaCapability[];\n}\n\nexport type PluginMediaJob = Omit<PluginJob<PluginMediaArtifact>, \"error\"> & {\n\terror?: PluginMediaFailure;\n};\n\n/** A media input exposed to its provider without revealing its storage location. */\nexport interface PluginMediaProviderInput {\n\tid: string;\n\trole?: string;\n\tkind: PluginMediaKind;\n\tmimeType?: string;\n}\n\ntype ProviderRequest<Request extends PluginMediaSubmitRequest> = Omit<Request, \"providerId\" | \"inputs\"> & {\n\treadonly inputs: readonly PluginMediaProviderInput[];\n};\n\nexport type PluginMediaProviderSubmitRequest =\n\tPluginMediaSubmitRequest extends infer Request\n\t\t? Request extends PluginMediaSubmitRequest\n\t\t\t? ProviderRequest<Request>\n\t\t\t: never\n\t\t: never;\n\nexport interface PluginMediaInputUploadRequest {\n\turl: string;\n\tfieldName: string;\n\tfileName?: string;\n\tfields?: Record<string, string>;\n\theaders?: Record<string, string>;\n\ttimeoutMs?: number;\n}\n\nexport interface PluginMediaTransferResponse<T = unknown> {\n\tok: boolean;\n\tstatus: number;\n\tstatusText: string;\n\theaders: Record<string, string>;\n\tbody: T;\n}\n\nexport interface PluginMediaProviderHandlerContext {\n\treadonly invocationId: string;\n\tuploadInput<T = unknown>(\n\t\tinputId: string,\n\t\trequest: PluginMediaInputUploadRequest,\n\t): Promise<PluginMediaTransferResponse<T>>;\n}\n\nexport type PluginMediaProviderArtifactSource =\n\t| { type: \"remote-url\"; url: string; headers?: Record<string, string> }\n\t| { type: \"plugin-blob\"; blobId: string }\n\t| { type: \"workspace-file\"; path: string };\n\nexport interface PluginMediaProviderArtifact {\n\tkind: PluginMediaOutputKind;\n\tmimeType?: string;\n\tname?: string;\n\twidth?: number;\n\theight?: number;\n\tdurationSeconds?: number;\n\tsource: PluginMediaProviderArtifactSource;\n}\n\nexport interface PluginMediaProviderJob {\n\tid: string;\n\tstatus: PluginMediaJob[\"status\"];\n\tprogress?: number;\n\tartifacts?: readonly PluginMediaProviderArtifact[];\n\terror?: PluginMediaFailure;\n}\n\nexport interface PluginMediaProviderRegistration {\n\tid: string;\n\tdisplayName?: string;\n\tcapabilities: readonly PluginMediaCapability[];\n\tsubmit(\n\t\trequest: PluginMediaProviderSubmitRequest,\n\t\tcontext: PluginMediaProviderHandlerContext,\n\t): Promise<PluginMediaProviderJob>;\n\tgetJob?(jobId: string, context: PluginMediaProviderHandlerContext): Promise<PluginMediaProviderJob>;\n\tcancelJob?(jobId: string, context: PluginMediaProviderHandlerContext): Promise<PluginMediaProviderJob>;\n}\n\nexport interface PluginMediaApi {\n\tregisterProvider(registration: PluginMediaProviderRegistration): Disposable;\n\tlistProviders(): Promise<readonly PluginMediaProviderDescriptor[]>;\n\tonProvidersChanged(listener: () => void): Disposable;\n\tsubmit(request: PluginMediaSubmitRequest): Promise<PluginMediaJob>;\n}\n"]}

package/dist/media.js

@@ -0,0 +1,11 @@
+export class PluginMediaError extends Error {
+    code;
+    retryable;
+    constructor(failure) {
+        super(failure.message);
+        this.name = "PluginMediaError";
+        this.code = failure.code;
+        this.retryable = failure.retryable;
+    }
+}
+//# sourceMappingURL=media.js.map

package/dist/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAgCA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACjC,IAAI,CAAuB;IAC3B,SAAS,CAAU;IAE5B,YAAY,OAA2B,EAAE;QACxC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAAA,CACnC;CACD","sourcesContent":["import type { PluginArtifactRef } from \"./artifacts.js\";\nimport type { Disposable } from \"./disposable.js\";\nimport type { PluginJob, PluginJobFailure } from \"./jobs.js\";\n\nexport type PluginMediaKind = \"image\" | \"video\" | \"audio\" | \"document\";\nexport type PluginMediaOutputKind = \"image\" | \"video\" | \"audio\";\nexport type PluginMediaOperation = \"generate\" | \"compose\" | \"transcode\";\n\nexport type PluginMediaGenerationMode =\n\t| \"text-to-image\"\n\t| \"image-to-image\"\n\t| \"text-to-video\"\n\t| \"image-to-video\"\n\t| \"video-to-video\"\n\t| \"reference-to-video\";\n\nexport type PluginMediaErrorCode =\n\t| \"unauthenticated\"\n\t| \"provider-unavailable\"\n\t| \"operation-unsupported\"\n\t| \"invalid-request\"\n\t| \"not-entitled\"\n\t| \"quota-exhausted\"\n\t| \"content-rejected\"\n\t| \"provider-timeout\"\n\t| \"provider-failed\"\n\t| \"cancelled\";\n\nexport interface PluginMediaFailure extends PluginJobFailure {\n\tcode: PluginMediaErrorCode;\n}\n\nexport class PluginMediaError extends Error {\n\treadonly code: PluginMediaErrorCode;\n\treadonly retryable: boolean;\n\n\tconstructor(failure: PluginMediaFailure) {\n\t\tsuper(failure.message);\n\t\tthis.name = \"PluginMediaError\";\n\t\tthis.code = failure.code;\n\t\tthis.retryable = failure.retryable;\n\t}\n}\n\nexport interface PluginMediaDimensions {\n\twidth: number;\n\theight: number;\n}\n\nexport type PluginMediaInputSource =\n\t| { type: \"plugin-blob\"; blobId: string }\n\t| { type: \"workspace-file\"; path: string };\n\nexport interface PluginMediaInput {\n\tid?: string;\n\trole?: string;\n\tkind: PluginMediaKind;\n\tmimeType?: string;\n\tsource: PluginMediaInputSource;\n}\n\nexport interface PluginMediaOutput {\n\tkind: PluginMediaOutputKind;\n\tmimeType: string;\n\tdimensions?: PluginMediaDimensions;\n\tfps?: number;\n\tdurationSeconds?: number;\n\tvideoCodec?: string;\n\taudioCodec?: string;\n}\n\nexport interface PluginMediaArtifact extends PluginArtifactRef {\n\tkind: PluginMediaOutputKind;\n\twidth?: number;\n\theight?: number;\n\tdurationSeconds?: number;\n}\n\nexport interface PluginMediaGenerateRequest {\n\toperation: \"generate\";\n\tproviderId: string;\n\tkind: \"image\" | \"video\";\n\tmode: PluginMediaGenerationMode;\n\tprompt: string;\n\tmodelId?: string;\n\tdimensions?: PluginMediaDimensions;\n\taspectRatio?: string;\n\tresolution?: string;\n\tdurationSeconds?: number;\n\tinputs?: readonly PluginMediaInput[];\n}\n\nexport interface PluginMediaComposeRequest {\n\toperation: \"compose\";\n\tproviderId: string;\n\tinputs: readonly PluginMediaInput[];\n\toutput: PluginMediaOutput;\n}\n\nexport interface PluginMediaTranscodeRequest {\n\toperation: \"transcode\";\n\tproviderId: string;\n\tinputs: readonly PluginMediaInput[];\n\toutput: PluginMediaOutput;\n}\n\nexport type PluginMediaSubmitRequest =\n\t| PluginMediaGenerateRequest\n\t| PluginMediaComposeRequest\n\t| PluginMediaTranscodeRequest;\n\nexport interface PluginMediaGenerationInputSlot {\n\trole: string;\n\tkinds: readonly PluginMediaKind[];\n\tminItems: number;\n\tmaxItems: number;\n}\n\nexport interface PluginMediaGenerationModeCapability {\n\tmode: PluginMediaGenerationMode;\n\tinputs: readonly PluginMediaGenerationInputSlot[];\n\tminTotalItems?: number;\n\tmaxTotalItems?: number;\n\taspectRatioPolicy?: \"configurable\" | \"input-derived\";\n\taudioGeneration?: \"none\" | \"always\" | \"optional\";\n}\n\nexport type PluginMediaCapability =\n\t| {\n\t\t\toperation: \"generate\";\n\t\t\tkind: \"image\" | \"video\";\n\t\t\tmodes: readonly PluginMediaGenerationMode[];\n\t\t\taspectRatios?: readonly string[];\n\t\t\t/** Provider-defined stable option ids; consumers must not infer pixel dimensions from their names. */\n\t\t\tresolutions?: readonly string[];\n\t\t\t/** Preferred option when the consumer has no supported persisted resolution. */\n\t\t\tdefaultResolution?: string;\n\t\t\tdurationsSeconds?: readonly number[];\n\t\t\tmodeCapabilities?: readonly PluginMediaGenerationModeCapability[];\n\t  }\n\t| {\n\t\t\toperation: \"compose\";\n\t\t\tdocumentMimeTypes: readonly string[];\n\t\t\toutputMimeTypes: readonly string[];\n\t  }\n\t| {\n\t\t\toperation: \"transcode\";\n\t\t\tinputMimeTypes: readonly string[];\n\t\t\toutputMimeTypes: readonly string[];\n\t  };\n\nexport interface PluginMediaProviderDescriptor {\n\t/** Host-qualified provider id. */\n\tid: string;\n\tdisplayName?: string;\n\townerId: string;\n\tprotocolVersion: number;\n\tcapabilities: readonly PluginMediaCapability[];\n}\n\nexport type PluginMediaJob = Omit<PluginJob<PluginMediaArtifact>, \"error\"> & {\n\terror?: PluginMediaFailure;\n};\n\n/** A media input exposed to its provider without revealing its storage location. */\nexport interface PluginMediaProviderInput {\n\tid: string;\n\trole?: string;\n\tkind: PluginMediaKind;\n\tmimeType?: string;\n}\n\ntype ProviderRequest<Request extends PluginMediaSubmitRequest> = Omit<Request, \"providerId\" | \"inputs\"> & {\n\treadonly inputs: readonly PluginMediaProviderInput[];\n};\n\nexport type PluginMediaProviderSubmitRequest =\n\tPluginMediaSubmitRequest extends infer Request\n\t\t? Request extends PluginMediaSubmitRequest\n\t\t\t? ProviderRequest<Request>\n\t\t\t: never\n\t\t: never;\n\nexport interface PluginMediaInputUploadRequest {\n\turl: string;\n\tfieldName: string;\n\tfileName?: string;\n\tfields?: Record<string, string>;\n\theaders?: Record<string, string>;\n\ttimeoutMs?: number;\n}\n\nexport interface PluginMediaTransferResponse<T = unknown> {\n\tok: boolean;\n\tstatus: number;\n\tstatusText: string;\n\theaders: Record<string, string>;\n\tbody: T;\n}\n\nexport interface PluginMediaProviderHandlerContext {\n\treadonly invocationId: string;\n\tuploadInput<T = unknown>(\n\t\tinputId: string,\n\t\trequest: PluginMediaInputUploadRequest,\n\t): Promise<PluginMediaTransferResponse<T>>;\n}\n\nexport type PluginMediaProviderArtifactSource =\n\t| { type: \"remote-url\"; url: string; headers?: Record<string, string> }\n\t| { type: \"plugin-blob\"; blobId: string }\n\t| { type: \"workspace-file\"; path: string };\n\nexport interface PluginMediaProviderArtifact {\n\tkind: PluginMediaOutputKind;\n\tmimeType?: string;\n\tname?: string;\n\twidth?: number;\n\theight?: number;\n\tdurationSeconds?: number;\n\tsource: PluginMediaProviderArtifactSource;\n}\n\nexport interface PluginMediaProviderJob {\n\tid: string;\n\tstatus: PluginMediaJob[\"status\"];\n\tprogress?: number;\n\tartifacts?: readonly PluginMediaProviderArtifact[];\n\terror?: PluginMediaFailure;\n}\n\nexport interface PluginMediaProviderRegistration {\n\tid: string;\n\tdisplayName?: string;\n\tcapabilities: readonly PluginMediaCapability[];\n\tsubmit(\n\t\trequest: PluginMediaProviderSubmitRequest,\n\t\tcontext: PluginMediaProviderHandlerContext,\n\t): Promise<PluginMediaProviderJob>;\n\tgetJob?(jobId: string, context: PluginMediaProviderHandlerContext): Promise<PluginMediaProviderJob>;\n\tcancelJob?(jobId: string, context: PluginMediaProviderHandlerContext): Promise<PluginMediaProviderJob>;\n}\n\nexport interface PluginMediaApi {\n\tregisterProvider(registration: PluginMediaProviderRegistration): Disposable;\n\tlistProviders(): Promise<readonly PluginMediaProviderDescriptor[]>;\n\tonProvidersChanged(listener: () => void): Disposable;\n\tsubmit(request: PluginMediaSubmitRequest): Promise<PluginMediaJob>;\n}\n"]}

package/dist/models.d.ts

@@ -0,0 +1,35 @@
+export interface PluginModelDefinition {
+    id: string;
+    name?: string;
+    api?: string;
+    reasoning?: boolean;
+    contextWindow?: number;
+    maxTokens?: number;
+}
+export interface PluginModelProviderConfig {
+    baseUrl?: string;
+    apiKey?: string;
+    api?: string;
+    displayName?: string;
+    authHeader?: boolean;
+    headers?: Record<string, string>;
+    models?: PluginModelDefinition[];
+}
+/** Reconciles the complete set of provider ids owned by the calling plugin. */
+export interface PluginModelsApi {
+    replaceOwnedProviders(providers: Record<string, PluginModelProviderConfig>): Promise<void>;
+    /**
+     * Reads back what the host currently holds for this plugin, keyed by the same
+     * local provider ids `replaceOwnedProviders` accepts.
+     *
+     * `replaceOwnedProviders` deletes by omission, so a plugin that cannot read its
+     * own published state can only clobber it — every write has to reconstruct the
+     * whole truth from whatever its (often eventually consistent) upstream happens
+     * to report at that instant. Read this first and reconcile against it, so a
+     * model that is merely not visible yet is not mistaken for one the user lost.
+     *
+     * `apiKey` comes back masked; supply the real credential on the next write.
+     */
+    listOwnedProviders(): Promise<Record<string, PluginModelProviderConfig>>;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC/B,qBAAqB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F;;;;;;;;;;;OAWG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC;CACzE","sourcesContent":["export interface PluginModelDefinition {\n\tid: string;\n\tname?: string;\n\tapi?: string;\n\treasoning?: boolean;\n\tcontextWindow?: number;\n\tmaxTokens?: number;\n}\n\nexport interface PluginModelProviderConfig {\n\tbaseUrl?: string;\n\tapiKey?: string;\n\tapi?: string;\n\tdisplayName?: string;\n\tauthHeader?: boolean;\n\theaders?: Record<string, string>;\n\tmodels?: PluginModelDefinition[];\n}\n\n/** Reconciles the complete set of provider ids owned by the calling plugin. */\nexport interface PluginModelsApi {\n\treplaceOwnedProviders(providers: Record<string, PluginModelProviderConfig>): Promise<void>;\n\t/**\n\t * Reads back what the host currently holds for this plugin, keyed by the same\n\t * local provider ids `replaceOwnedProviders` accepts.\n\t *\n\t * `replaceOwnedProviders` deletes by omission, so a plugin that cannot read its\n\t * own published state can only clobber it — every write has to reconstruct the\n\t * whole truth from whatever its (often eventually consistent) upstream happens\n\t * to report at that instant. Read this first and reconcile against it, so a\n\t * model that is merely not visible yet is not mistaken for one the user lost.\n\t *\n\t * `apiKey` comes back masked; supply the real credential on the next write.\n\t */\n\tlistOwnedProviders(): Promise<Record<string, PluginModelProviderConfig>>;\n}\n"]}

package/dist/models.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"","sourcesContent":["export interface PluginModelDefinition {\n\tid: string;\n\tname?: string;\n\tapi?: string;\n\treasoning?: boolean;\n\tcontextWindow?: number;\n\tmaxTokens?: number;\n}\n\nexport interface PluginModelProviderConfig {\n\tbaseUrl?: string;\n\tapiKey?: string;\n\tapi?: string;\n\tdisplayName?: string;\n\tauthHeader?: boolean;\n\theaders?: Record<string, string>;\n\tmodels?: PluginModelDefinition[];\n}\n\n/** Reconciles the complete set of provider ids owned by the calling plugin. */\nexport interface PluginModelsApi {\n\treplaceOwnedProviders(providers: Record<string, PluginModelProviderConfig>): Promise<void>;\n\t/**\n\t * Reads back what the host currently holds for this plugin, keyed by the same\n\t * local provider ids `replaceOwnedProviders` accepts.\n\t *\n\t * `replaceOwnedProviders` deletes by omission, so a plugin that cannot read its\n\t * own published state can only clobber it — every write has to reconstruct the\n\t * whole truth from whatever its (often eventually consistent) upstream happens\n\t * to report at that instant. Read this first and reconcile against it, so a\n\t * model that is merely not visible yet is not mistaken for one the user lost.\n\t *\n\t * `apiKey` comes back masked; supply the real credential on the next write.\n\t */\n\tlistOwnedProviders(): Promise<Record<string, PluginModelProviderConfig>>;\n}\n"]}

package/dist/network.d.ts

@@ -30,7 +30,8 @@ export interface PluginNetworkResponse<T = unknown> {
  * Host-mediated network access for trusted plugins.
  *
  * Requests run in the main process so plugins do not depend on renderer CORS
- * behavior. Access requires the `network.fetch` permission.
+ * behavior. Access requires the `network.fetch` permission and a matching
+ * `plugin.json` `network.allowedHosts` declaration.
  */
 export interface PluginNetworkApi {
     request<T = unknown>(request: PluginNetworkRequest): Promise<PluginNetworkResponse<T>>;

package/dist/network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAC1B;IACA,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CACd,GACD;IACA,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,KAAK,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;CACF,CAAC;AAEL,MAAM,WAAW,oBAAoB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACjD,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;CACR;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAChC,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;CACvF","sourcesContent":["export type PluginNetworkBody =\n\t| {\n\t\t\ttype: \"json\";\n\t\t\tvalue: unknown;\n\t  }\n\t| {\n\t\t\ttype: \"multipart\";\n\t\t\tfields?: Record<string, string>;\n\t\t\tfiles?: Array<{\n\t\t\t\tfieldName: string;\n\t\t\t\tfileName: string;\n\t\t\t\tmimeType: string;\n\t\t\t\tdata: string;\n\t\t\t}>;\n\t  };\n\nexport interface PluginNetworkRequest {\n\turl: string;\n\tmethod?: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\theaders?: Record<string, string>;\n\tbody?: PluginNetworkBody;\n\tresponseType?: \"json\" | \"text\" | \"base64\";\n\ttimeoutMs?: number;\n}\n\nexport interface PluginNetworkResponse<T = unknown> {\n\tok: boolean;\n\tstatus: number;\n\tstatusText: string;\n\theaders: Record<string, string>;\n\tbody: T;\n}\n\n/**\n * Host-mediated network access for trusted plugins.\n *\n * Requests run in the main process so plugins do not depend on renderer CORS\n * behavior. Access requires the `network.fetch` permission.\n */\nexport interface PluginNetworkApi {\n\trequest<T = unknown>(request: PluginNetworkRequest): Promise<PluginNetworkResponse<T>>;\n}\n"]}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAC1B;IACA,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CACd,GACD;IACA,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,KAAK,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;CACF,CAAC;AAEL,MAAM,WAAW,oBAAoB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACjD,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;CACR;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAChC,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;CACvF","sourcesContent":["export type PluginNetworkBody =\n\t| {\n\t\t\ttype: \"json\";\n\t\t\tvalue: unknown;\n\t  }\n\t| {\n\t\t\ttype: \"multipart\";\n\t\t\tfields?: Record<string, string>;\n\t\t\tfiles?: Array<{\n\t\t\t\tfieldName: string;\n\t\t\t\tfileName: string;\n\t\t\t\tmimeType: string;\n\t\t\t\tdata: string;\n\t\t\t}>;\n\t  };\n\nexport interface PluginNetworkRequest {\n\turl: string;\n\tmethod?: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\theaders?: Record<string, string>;\n\tbody?: PluginNetworkBody;\n\tresponseType?: \"json\" | \"text\" | \"base64\";\n\ttimeoutMs?: number;\n}\n\nexport interface PluginNetworkResponse<T = unknown> {\n\tok: boolean;\n\tstatus: number;\n\tstatusText: string;\n\theaders: Record<string, string>;\n\tbody: T;\n}\n\n/**\n * Host-mediated network access for trusted plugins.\n *\n * Requests run in the main process so plugins do not depend on renderer CORS\n * behavior. Access requires the `network.fetch` permission and a matching\n * `plugin.json` `network.allowedHosts` declaration.\n */\nexport interface PluginNetworkApi {\n\trequest<T = unknown>(request: PluginNetworkRequest): Promise<PluginNetworkResponse<T>>;\n}\n"]}

package/dist/network.js.map

@@ -1 +1 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"","sourcesContent":["export type PluginNetworkBody =\n\t| {\n\t\t\ttype: \"json\";\n\t\t\tvalue: unknown;\n\t  }\n\t| {\n\t\t\ttype: \"multipart\";\n\t\t\tfields?: Record<string, string>;\n\t\t\tfiles?: Array<{\n\t\t\t\tfieldName: string;\n\t\t\t\tfileName: string;\n\t\t\t\tmimeType: string;\n\t\t\t\tdata: string;\n\t\t\t}>;\n\t  };\n\nexport interface PluginNetworkRequest {\n\turl: string;\n\tmethod?: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\theaders?: Record<string, string>;\n\tbody?: PluginNetworkBody;\n\tresponseType?: \"json\" | \"text\" | \"base64\";\n\ttimeoutMs?: number;\n}\n\nexport interface PluginNetworkResponse<T = unknown> {\n\tok: boolean;\n\tstatus: number;\n\tstatusText: string;\n\theaders: Record<string, string>;\n\tbody: T;\n}\n\n/**\n * Host-mediated network access for trusted plugins.\n *\n * Requests run in the main process so plugins do not depend on renderer CORS\n * behavior. Access requires the `network.fetch` permission.\n */\nexport interface PluginNetworkApi {\n\trequest<T = unknown>(request: PluginNetworkRequest): Promise<PluginNetworkResponse<T>>;\n}\n"]}
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"","sourcesContent":["export type PluginNetworkBody =\n\t| {\n\t\t\ttype: \"json\";\n\t\t\tvalue: unknown;\n\t  }\n\t| {\n\t\t\ttype: \"multipart\";\n\t\t\tfields?: Record<string, string>;\n\t\t\tfiles?: Array<{\n\t\t\t\tfieldName: string;\n\t\t\t\tfileName: string;\n\t\t\t\tmimeType: string;\n\t\t\t\tdata: string;\n\t\t\t}>;\n\t  };\n\nexport interface PluginNetworkRequest {\n\turl: string;\n\tmethod?: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\theaders?: Record<string, string>;\n\tbody?: PluginNetworkBody;\n\tresponseType?: \"json\" | \"text\" | \"base64\";\n\ttimeoutMs?: number;\n}\n\nexport interface PluginNetworkResponse<T = unknown> {\n\tok: boolean;\n\tstatus: number;\n\tstatusText: string;\n\theaders: Record<string, string>;\n\tbody: T;\n}\n\n/**\n * Host-mediated network access for trusted plugins.\n *\n * Requests run in the main process so plugins do not depend on renderer CORS\n * behavior. Access requires the `network.fetch` permission and a matching\n * `plugin.json` `network.allowedHosts` declaration.\n */\nexport interface PluginNetworkApi {\n\trequest<T = unknown>(request: PluginNetworkRequest): Promise<PluginNetworkResponse<T>>;\n}\n"]}

package/dist/npm-package.d.ts

@@ -0,0 +1,17 @@
+import { type Static } from "@sinclair/typebox";
+export declare const VETTA_NPM_PACKAGE_SCHEMA_VERSION: 1;
+export declare const VettaNpmPluginMetadataSchema: import("@sinclair/typebox").TObject<{
+    schemaVersion: import("@sinclair/typebox").TLiteral<1>;
+    type: import("@sinclair/typebox").TLiteral<"desktop-plugin">;
+    pluginId: import("@sinclair/typebox").TString;
+    archive: import("@sinclair/typebox").TString;
+}>;
+export type VettaNpmPluginMetadata = Static<typeof VettaNpmPluginMetadataSchema>;
+export interface VettaNpmPluginPackage {
+    name: string;
+    version: string;
+    vetta: VettaNpmPluginMetadata;
+}
+/** Parse the npm distribution envelope without trusting package-owned metadata. */
+export declare function parseVettaNpmPluginPackage(value: unknown): VettaNpmPluginPackage;
+//# sourceMappingURL=npm-package.d.ts.map

package/dist/npm-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-package.d.ts","sourceRoot":"","sources":["../src/npm-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAKtD,eAAO,MAAM,gCAAgC,GAAa,CAAC;AAE3D,eAAO,MAAM,4BAA4B;;;;;EAQxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEjF,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,sBAAsB,CAAC;CAC9B;AAMD,mFAAmF;AACnF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAqBhF","sourcesContent":["import { Type, type Static } from \"@sinclair/typebox\";\nimport { Value } from \"@sinclair/typebox/value\";\nimport { PluginIdSchema, PluginVersionSchema } from \"./manifest-schema.js\";\nimport { validatePluginRelativePath } from \"./manifest.js\";\n\nexport const VETTA_NPM_PACKAGE_SCHEMA_VERSION = 1 as const;\n\nexport const VettaNpmPluginMetadataSchema = Type.Object(\n\t{\n\t\tschemaVersion: Type.Literal(VETTA_NPM_PACKAGE_SCHEMA_VERSION),\n\t\ttype: Type.Literal(\"desktop-plugin\"),\n\t\tpluginId: PluginIdSchema,\n\t\tarchive: Type.String({ minLength: 1 }),\n\t},\n\t{ additionalProperties: false },\n);\n\nexport type VettaNpmPluginMetadata = Static<typeof VettaNpmPluginMetadataSchema>;\n\nexport interface VettaNpmPluginPackage {\n\tname: string;\n\tversion: string;\n\tvetta: VettaNpmPluginMetadata;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Parse the npm distribution envelope without trusting package-owned metadata. */\nexport function parseVettaNpmPluginPackage(value: unknown): VettaNpmPluginPackage {\n\tif (!isRecord(value)) throw new Error(\"Invalid npm plugin package: package.json must contain an object\");\n\tif (typeof value.name !== \"string\" || value.name.trim().length === 0) {\n\t\tthrow new Error(\"Invalid npm plugin package: name is required\");\n\t}\n\tif (!Value.Check(PluginVersionSchema, value.version)) {\n\t\tthrow new Error(\"Invalid npm plugin package: version must be a semantic version\");\n\t}\n\tif (!Value.Check(VettaNpmPluginMetadataSchema, value.vetta)) {\n\t\tthrow new Error(\"Invalid npm plugin package: package.json#vetta does not match schema version 1\");\n\t}\n\n\tconst metadata = value.vetta as VettaNpmPluginMetadata;\n\treturn {\n\t\tname: value.name.trim(),\n\t\tversion: value.version,\n\t\tvetta: {\n\t\t\t...metadata,\n\t\t\tarchive: validatePluginRelativePath(metadata.archive.trim(), \"npm archive\"),\n\t\t},\n\t};\n}\n"]}

package/dist/npm-package.js

@@ -0,0 +1,38 @@
+import { Type } from "@sinclair/typebox";
+import { Value } from "@sinclair/typebox/value";
+import { PluginIdSchema, PluginVersionSchema } from "./manifest-schema.js";
+import { validatePluginRelativePath } from "./manifest.js";
+export const VETTA_NPM_PACKAGE_SCHEMA_VERSION = 1;
+export const VettaNpmPluginMetadataSchema = Type.Object({
+    schemaVersion: Type.Literal(VETTA_NPM_PACKAGE_SCHEMA_VERSION),
+    type: Type.Literal("desktop-plugin"),
+    pluginId: PluginIdSchema,
+    archive: Type.String({ minLength: 1 }),
+}, { additionalProperties: false });
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Parse the npm distribution envelope without trusting package-owned metadata. */
+export function parseVettaNpmPluginPackage(value) {
+    if (!isRecord(value))
+        throw new Error("Invalid npm plugin package: package.json must contain an object");
+    if (typeof value.name !== "string" || value.name.trim().length === 0) {
+        throw new Error("Invalid npm plugin package: name is required");
+    }
+    if (!Value.Check(PluginVersionSchema, value.version)) {
+        throw new Error("Invalid npm plugin package: version must be a semantic version");
+    }
+    if (!Value.Check(VettaNpmPluginMetadataSchema, value.vetta)) {
+        throw new Error("Invalid npm plugin package: package.json#vetta does not match schema version 1");
+    }
+    const metadata = value.vetta;
+    return {
+        name: value.name.trim(),
+        version: value.version,
+        vetta: {
+            ...metadata,
+            archive: validatePluginRelativePath(metadata.archive.trim(), "npm archive"),
+        },
+    };
+}
+//# sourceMappingURL=npm-package.js.map

package/dist/npm-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-package.js","sourceRoot":"","sources":["../src/npm-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAU,CAAC;AAE3D,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC,MAAM,CACtD;IACC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,gCAAgC,CAAC;IAC7D,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACpC,QAAQ,EAAE,cAAc;IACxB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;CACtC,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAC/B,CAAC;AAUF,SAAS,QAAQ,CAAC,KAAc,EAAoC;IACnE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAAA,CAC5E;AAED,mFAAmF;AACnF,MAAM,UAAU,0BAA0B,CAAC,KAAc,EAAyB;IACjF,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACzG,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;IACnG,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAA+B,CAAC;IACvD,OAAO;QACN,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;QACvB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE;YACN,GAAG,QAAQ;YACX,OAAO,EAAE,0BAA0B,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,CAAC;SAC3E;KACD,CAAC;AAAA,CACF","sourcesContent":["import { Type, type Static } from \"@sinclair/typebox\";\nimport { Value } from \"@sinclair/typebox/value\";\nimport { PluginIdSchema, PluginVersionSchema } from \"./manifest-schema.js\";\nimport { validatePluginRelativePath } from \"./manifest.js\";\n\nexport const VETTA_NPM_PACKAGE_SCHEMA_VERSION = 1 as const;\n\nexport const VettaNpmPluginMetadataSchema = Type.Object(\n\t{\n\t\tschemaVersion: Type.Literal(VETTA_NPM_PACKAGE_SCHEMA_VERSION),\n\t\ttype: Type.Literal(\"desktop-plugin\"),\n\t\tpluginId: PluginIdSchema,\n\t\tarchive: Type.String({ minLength: 1 }),\n\t},\n\t{ additionalProperties: false },\n);\n\nexport type VettaNpmPluginMetadata = Static<typeof VettaNpmPluginMetadataSchema>;\n\nexport interface VettaNpmPluginPackage {\n\tname: string;\n\tversion: string;\n\tvetta: VettaNpmPluginMetadata;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Parse the npm distribution envelope without trusting package-owned metadata. */\nexport function parseVettaNpmPluginPackage(value: unknown): VettaNpmPluginPackage {\n\tif (!isRecord(value)) throw new Error(\"Invalid npm plugin package: package.json must contain an object\");\n\tif (typeof value.name !== \"string\" || value.name.trim().length === 0) {\n\t\tthrow new Error(\"Invalid npm plugin package: name is required\");\n\t}\n\tif (!Value.Check(PluginVersionSchema, value.version)) {\n\t\tthrow new Error(\"Invalid npm plugin package: version must be a semantic version\");\n\t}\n\tif (!Value.Check(VettaNpmPluginMetadataSchema, value.vetta)) {\n\t\tthrow new Error(\"Invalid npm plugin package: package.json#vetta does not match schema version 1\");\n\t}\n\n\tconst metadata = value.vetta as VettaNpmPluginMetadata;\n\treturn {\n\t\tname: value.name.trim(),\n\t\tversion: value.version,\n\t\tvetta: {\n\t\t\t...metadata,\n\t\t\tarchive: validatePluginRelativePath(metadata.archive.trim(), \"npm archive\"),\n\t\t},\n\t};\n}\n"]}

package/dist/ocr.d.ts

@@ -0,0 +1,78 @@
+import type { OcrBlock, OcrErrorCode, OcrItemResult, OcrProviderDescriptor, OcrRequest as DomainOcrRequest, OcrResult } from "@vetta-org/capability-sdk";
+import type { Disposable } from "./disposable.js";
+export type { OcrBlock, OcrErrorCode, OcrItemResult, OcrProviderDescriptor, OcrResult };
+export type OcrInput = {
+    id?: string;
+    mimeType?: string;
+    source: {
+        type: "plugin-blob";
+        blobId: string;
+    } | {
+        type: "workspace-file";
+        path: string;
+    };
+};
+/** Public consumer request. Ownership and storage namespaces are supplied by the host. */
+export type OcrRequest = Omit<DomainOcrRequest, "ownerId" | "providerId" | "inputs"> & {
+    readonly inputs: readonly OcrInput[];
+};
+export type OcrProgress = {
+    phase: "queued" | "uploading" | "processing" | "finalizing";
+    completed: number;
+    total: number;
+    itemId?: string;
+};
+export type OcrProviderRequest = Omit<DomainOcrRequest, "ownerId" | "providerId" | "inputs"> & {
+    readonly inputs: readonly OcrProviderInput[];
+};
+export type OcrProviderInput = {
+    id: string;
+    mimeType?: string;
+};
+export type OcrUploadRequest = {
+    url: string;
+    fieldName: string;
+    fileName?: string;
+    fields?: Record<string, string>;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+};
+export type OcrTransferResponse<T = unknown> = {
+    ok: boolean;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    body: T;
+};
+export type OcrProviderContext = {
+    readonly signal: AbortSignal;
+    readonly invocationId: string;
+    getInputUrl(inputId: string): Promise<string>;
+    uploadInput<T = unknown>(inputId: string, request: OcrUploadRequest): Promise<OcrTransferResponse<T>>;
+    reportProgress(event: OcrProgress): void;
+};
+export type OcrProviderRegistration = {
+    readonly id: string;
+    readonly displayName: string;
+    readonly protocolVersion: 1;
+    readonly processing: OcrProviderDescriptor["processing"];
+    readonly execution: OcrProviderDescriptor["execution"];
+    readonly input: OcrProviderDescriptor["input"];
+    readonly output: OcrProviderDescriptor["output"];
+    readonly network?: OcrProviderDescriptor["network"];
+    readonly configuration?: OcrProviderDescriptor["configuration"];
+    recognize(request: OcrProviderRequest, context: OcrProviderContext): Promise<OcrProviderResult>;
+    dispose?(): void | Promise<void>;
+};
+export type OcrProviderResult = Omit<OcrResult, "providerId">;
+export type OcrClient = {
+    registerProvider(registration: OcrProviderRegistration): Disposable;
+    listProviders(): Promise<readonly OcrProviderDescriptor[]>;
+    onProvidersChanged(listener: () => void): Disposable;
+    recognize(request: OcrRequest, options?: {
+        providerId?: string;
+        signal?: AbortSignal;
+        onProgress?: (event: OcrProgress) => void;
+    }): Promise<OcrResult>;
+};
+//# sourceMappingURL=ocr.d.ts.map

package/dist/ocr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr.d.ts","sourceRoot":"","sources":["../src/ocr.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tOcrBlock,\n\tOcrErrorCode,\n\tOcrItemResult,\n\tOcrProviderDescriptor,\n\tOcrRequest as DomainOcrRequest,\n\tOcrResult,\n} from \"@vetta-org/capability-sdk\";\nimport type { Disposable } from \"./disposable.js\";\n\nexport type { OcrBlock, OcrErrorCode, OcrItemResult, OcrProviderDescriptor, OcrResult };\n\nexport type OcrInput = {\n\tid?: string;\n\tmimeType?: string;\n\tsource:\n\t\t| { type: \"plugin-blob\"; blobId: string }\n\t\t| { type: \"workspace-file\"; path: string };\n};\n\n/** Public consumer request. Ownership and storage namespaces are supplied by the host. */\nexport type OcrRequest = Omit<DomainOcrRequest, \"ownerId\" | \"providerId\" | \"inputs\"> & {\n\treadonly inputs: readonly OcrInput[];\n};\n\nexport type OcrProgress = {\n\tphase: \"queued\" | \"uploading\" | \"processing\" | \"finalizing\";\n\tcompleted: number;\n\ttotal: number;\n\titemId?: string;\n};\n\nexport type OcrProviderRequest = Omit<DomainOcrRequest, \"ownerId\" | \"providerId\" | \"inputs\"> & {\n\treadonly inputs: readonly OcrProviderInput[];\n};\n\nexport type OcrProviderInput = {\n\tid: string;\n\tmimeType?: string;\n};\n\nexport type OcrUploadRequest = {\n\turl: string;\n\tfieldName: string;\n\tfileName?: string;\n\tfields?: Record<string, string>;\n\theaders?: Record<string, string>;\n\ttimeoutMs?: number;\n};\n\nexport type OcrTransferResponse<T = unknown> = {\n\tok: boolean;\n\tstatus: number;\n\tstatusText: string;\n\theaders: Record<string, string>;\n\tbody: T;\n};\n\nexport type OcrProviderContext = {\n\treadonly signal: AbortSignal;\n\treadonly invocationId: string;\n\tgetInputUrl(inputId: string): Promise<string>;\n\tuploadInput<T = unknown>(inputId: string, request: OcrUploadRequest): Promise<OcrTransferResponse<T>>;\n\treportProgress(event: OcrProgress): void;\n};\n\nexport type OcrProviderRegistration = {\n\treadonly id: string;\n\treadonly displayName: string;\n\treadonly protocolVersion: 1;\n\treadonly processing: OcrProviderDescriptor[\"processing\"];\n\treadonly execution: OcrProviderDescriptor[\"execution\"];\n\treadonly input: OcrProviderDescriptor[\"input\"];\n\treadonly output: OcrProviderDescriptor[\"output\"];\n\treadonly network?: OcrProviderDescriptor[\"network\"];\n\treadonly configuration?: OcrProviderDescriptor[\"configuration\"];\n\trecognize(request: OcrProviderRequest, context: OcrProviderContext): Promise<OcrProviderResult>;\n\tdispose?(): void | Promise<void>;\n};\n\nexport type OcrProviderResult = Omit<OcrResult, \"providerId\">;\n\nexport type OcrClient = {\n\tregisterProvider(registration: OcrProviderRegistration): Disposable;\n\tlistProviders(): Promise<readonly OcrProviderDescriptor[]>;\n\tonProvidersChanged(listener: () => void): Disposable;\n\trecognize(request: OcrRequest, options?: {\n\t\tproviderId?: string;\n\t\tsignal?: AbortSignal;\n\t\tonProgress?: (event: OcrProgress) => void;\n\t}): Promise<OcrResult>;\n};\n"]}

package/dist/ocr.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ocr.js.map

package/dist/ocr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocr.js","sourceRoot":"","sources":["../src/ocr.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tOcrBlock,\n\tOcrErrorCode,\n\tOcrItemResult,\n\tOcrProviderDescriptor,\n\tOcrRequest as DomainOcrRequest,\n\tOcrResult,\n} from \"@vetta-org/capability-sdk\";\nimport type { Disposable } from \"./disposable.js\";\n\nexport type { OcrBlock, OcrErrorCode, OcrItemResult, OcrProviderDescriptor, OcrResult };\n\nexport type OcrInput = {\n\tid?: string;\n\tmimeType?: string;\n\tsource:\n\t\t| { type: \"plugin-blob\"; blobId: string }\n\t\t| { type: \"workspace-file\"; path: string };\n};\n\n/** Public consumer request. Ownership and storage namespaces are supplied by the host. */\nexport type OcrRequest = Omit<DomainOcrRequest, \"ownerId\" | \"providerId\" | \"inputs\"> & {\n\treadonly inputs: readonly OcrInput[];\n};\n\nexport type OcrProgress = {\n\tphase: \"queued\" | \"uploading\" | \"processing\" | \"finalizing\";\n\tcompleted: number;\n\ttotal: number;\n\titemId?: string;\n};\n\nexport type OcrProviderRequest = Omit<DomainOcrRequest, \"ownerId\" | \"providerId\" | \"inputs\"> & {\n\treadonly inputs: readonly OcrProviderInput[];\n};\n\nexport type OcrProviderInput = {\n\tid: string;\n\tmimeType?: string;\n};\n\nexport type OcrUploadRequest = {\n\turl: string;\n\tfieldName: string;\n\tfileName?: string;\n\tfields?: Record<string, string>;\n\theaders?: Record<string, string>;\n\ttimeoutMs?: number;\n};\n\nexport type OcrTransferResponse<T = unknown> = {\n\tok: boolean;\n\tstatus: number;\n\tstatusText: string;\n\theaders: Record<string, string>;\n\tbody: T;\n};\n\nexport type OcrProviderContext = {\n\treadonly signal: AbortSignal;\n\treadonly invocationId: string;\n\tgetInputUrl(inputId: string): Promise<string>;\n\tuploadInput<T = unknown>(inputId: string, request: OcrUploadRequest): Promise<OcrTransferResponse<T>>;\n\treportProgress(event: OcrProgress): void;\n};\n\nexport type OcrProviderRegistration = {\n\treadonly id: string;\n\treadonly displayName: string;\n\treadonly protocolVersion: 1;\n\treadonly processing: OcrProviderDescriptor[\"processing\"];\n\treadonly execution: OcrProviderDescriptor[\"execution\"];\n\treadonly input: OcrProviderDescriptor[\"input\"];\n\treadonly output: OcrProviderDescriptor[\"output\"];\n\treadonly network?: OcrProviderDescriptor[\"network\"];\n\treadonly configuration?: OcrProviderDescriptor[\"configuration\"];\n\trecognize(request: OcrProviderRequest, context: OcrProviderContext): Promise<OcrProviderResult>;\n\tdispose?(): void | Promise<void>;\n};\n\nexport type OcrProviderResult = Omit<OcrResult, \"providerId\">;\n\nexport type OcrClient = {\n\tregisterProvider(registration: OcrProviderRegistration): Disposable;\n\tlistProviders(): Promise<readonly OcrProviderDescriptor[]>;\n\tonProvidersChanged(listener: () => void): Disposable;\n\trecognize(request: OcrRequest, options?: {\n\t\tproviderId?: string;\n\t\tsignal?: AbortSignal;\n\t\tonProgress?: (event: OcrProgress) => void;\n\t}): Promise<OcrResult>;\n};\n"]}