@independo/inderun-contracts 0.4.0 → 0.5.0-rc.2

package/dist/validators.d.ts

@@ -1,13 +1,19 @@
+import type { ArtifactReadRequest } from "./generated/artifact-read-request.js";
 import type { ExecutionProvenance } from "./generated/execution-provenance.js";
 import type { IndeRunError } from "./generated/inderun-error.js";
+import type { MediaArtifact } from "./generated/media-artifact.js";
 import type { HttpRequest } from "./generated/http-request.js";
 import type { HttpResponse } from "./generated/http-response.js";
 import type { ModelPackage } from "./generated/model-package.js";
+import type { ProviderCapabilitySnapshot } from "./generated/provider-capability-snapshot.js";
+import type { ProviderDescriptor } from "./generated/provider-descriptor.js";
+import type { ProviderDynamicCapabilities } from "./generated/provider-dynamic-capabilities.js";
 import type { RoutePlan } from "./generated/route-plan.js";
 import type { RoutePlannerInput } from "./generated/route-planner-input.js";
 import type { StreamEvent } from "./generated/stream-event.js";
 import type { StreamRunHandle } from "./generated/stream-run.js";
 import type { StreamTerminalOutcome } from "./generated/stream-terminal-outcome.js";
+import type { TaskOutput } from "./generated/task-output.js";
 import type { TaskRequest } from "./generated/task-request.js";
 import type { TaskResult } from "./generated/task-result.js";
 import type { TelemetryEvent } from "./generated/telemetry-event.js";
@@ -18,6 +24,9 @@ export type ValidationIssue = {
 };
 export declare function validateTaskRequest(value: unknown): value is TaskRequest;
 export declare function validateTaskResult(value: unknown): value is TaskResult;
+export declare function validateTaskOutput(value: unknown): value is TaskOutput;
+export declare function validateMediaArtifact(value: unknown): value is MediaArtifact;
+export declare function validateArtifactReadRequest(value: unknown): value is ArtifactReadRequest;
 export declare function validateIndeRunError(value: unknown): value is IndeRunError;
 export declare function validateHttpRequest(value: unknown): value is HttpRequest;
 export declare function validateHttpResponse(value: unknown): value is HttpResponse;
@@ -25,11 +34,17 @@ export declare function validateTelemetryEvent(value: unknown): value is Telemet
 export declare function validateRoutePlannerInput(value: unknown): value is RoutePlannerInput;
 export declare function validateRoutePlan(value: unknown): value is RoutePlan;
 export declare function validateModelPackage(value: unknown): value is ModelPackage;
+export declare function validateProviderDescriptor(value: unknown): value is ProviderDescriptor;
+export declare function validateProviderDynamicCapabilities(value: unknown): value is ProviderDynamicCapabilities;
+export declare function validateProviderCapabilitySnapshot(value: unknown): value is ProviderCapabilitySnapshot;
 export declare function validateStreamRunHandle(value: unknown): value is StreamRunHandle;
 export declare function validateStreamEvent(value: unknown): value is StreamEvent;
 export declare function validateStreamTerminalOutcome(value: unknown): value is StreamTerminalOutcome;
 export declare function getTaskRequestValidationIssues(value: unknown): ValidationIssue[];
 export declare function getTaskResultValidationIssues(value: unknown): ValidationIssue[];
+export declare function getTaskOutputValidationIssues(value: unknown): ValidationIssue[];
+export declare function getMediaArtifactValidationIssues(value: unknown): ValidationIssue[];
+export declare function getArtifactReadRequestValidationIssues(value: unknown): ValidationIssue[];
 export declare function getIndeRunErrorValidationIssues(value: unknown): ValidationIssue[];
 export declare function validateExecutionProvenance(value: unknown): value is ExecutionProvenance;
 export declare function getExecutionProvenanceValidationIssues(value: unknown): ValidationIssue[];
@@ -39,6 +54,9 @@ export declare function getTelemetryEventValidationIssues(value: unknown): Valid
 export declare function getRoutePlannerInputValidationIssues(value: unknown): ValidationIssue[];
 export declare function getRoutePlanValidationIssues(value: unknown): ValidationIssue[];
 export declare function getModelPackageValidationIssues(value: unknown): ValidationIssue[];
+export declare function getProviderDescriptorValidationIssues(value: unknown): ValidationIssue[];
+export declare function getProviderDynamicCapabilitiesValidationIssues(value: unknown): ValidationIssue[];
+export declare function getProviderCapabilitySnapshotValidationIssues(value: unknown): ValidationIssue[];
 export declare function getStreamRunHandleValidationIssues(value: unknown): ValidationIssue[];
 export declare function getStreamEventValidationIssues(value: unknown): ValidationIssue[];
 export declare function getStreamTerminalOutcomeValidationIssues(value: unknown): ValidationIssue[];

package/dist/validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAChG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAsB5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAqCF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAExE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEtE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEtE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAE5E;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAExF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAE1E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAExE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAE1E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAE9E;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAEpF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAE1E;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEtF;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,2BAA2B,CAEtC;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,0BAA0B,CAErC;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAEhF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAExE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAE5F;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAOhF;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAI/E;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAI/E;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAElF;AAED,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAExF;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAIjF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAExF;AAED,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAIxF;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAEhF;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAEjF;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAInF;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAEtF;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAE9E;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAIjF;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAEvF;AAED,wBAAgB,8CAA8C,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAEhG;AAED,wBAAgB,6CAA6C,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAE/F;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAEpF;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAIhF;AAED,wBAAgB,wCAAwC,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAI1F"}

package/dist/validators.js

@@ -1,5 +1,5 @@
 import Ajv2020 from "ajv/dist/2020.js";
-import { executionProvenanceSchema, httpRequestSchema, httpResponseSchema, inderunErrorSchema, modelPackageSchema, routePlanSchema, routePlannerInputSchema, streamEventSchema, streamRunSchema, streamTerminalOutcomeSchema, taskRequestSchema, taskResultSchema, telemetryEventSchema } from "./generated/index.js";
+import { artifactReadRequestSchema, executionProvenanceSchema, httpRequestSchema, httpResponseSchema, inderunErrorSchema, mediaArtifactSchema, modelPackageSchema, providerCapabilitySnapshotSchema, providerDescriptorSchema, providerDynamicCapabilitiesSchema, routePlanSchema, routePlannerInputSchema, streamEventSchema, streamRunSchema, streamTerminalOutcomeSchema, taskOutputSchema, taskRequestSchema, taskResultSchema, telemetryEventSchema } from "./generated/index.js";
 const Ajv2020Constructor = Ajv2020;
 const ajv = new Ajv2020Constructor({
     allErrors: true,
@@ -10,6 +10,16 @@ const ajv = new Ajv2020Constructor({
 // Referenced by `$ref` from every schema that carries provenance, so it has to be known
 // to Ajv before any of them compiles. Compiling it registers it under its `$id`.
 const validateExecutionProvenanceSchema = ajv.compile(executionProvenanceSchema);
+// Likewise, the provider descriptor and dynamic capabilities are referenced from the
+// capability snapshot and the route-planner input.
+const validateProviderDescriptorSchema = ajv.compile(providerDescriptorSchema);
+const validateProviderDynamicCapabilitiesSchema = ajv.compile(providerDynamicCapabilitiesSchema);
+const validateProviderCapabilitySnapshotSchema = ajv.compile(providerCapabilitySnapshotSchema);
+// The normalized output (and the media artifact it references) is shared by the result
+// and both terminal-outcome copies.
+const validateMediaArtifactSchema = ajv.compile(mediaArtifactSchema);
+const validateTaskOutputSchema = ajv.compile(taskOutputSchema);
+const validateArtifactReadRequestSchema = ajv.compile(artifactReadRequestSchema);
 const validateTaskRequestSchema = ajv.compile(taskRequestSchema);
 const validateTaskResultSchema = ajv.compile(taskResultSchema);
 const validateIndeRunErrorSchema = ajv.compile(inderunErrorSchema);
@@ -28,6 +38,15 @@ export function validateTaskRequest(value) {
 export function validateTaskResult(value) {
     return getTaskResultValidationIssues(value).length === 0;
 }
+export function validateTaskOutput(value) {
+    return getTaskOutputValidationIssues(value).length === 0;
+}
+export function validateMediaArtifact(value) {
+    return getMediaArtifactValidationIssues(value).length === 0;
+}
+export function validateArtifactReadRequest(value) {
+    return getArtifactReadRequestValidationIssues(value).length === 0;
+}
 export function validateIndeRunError(value) {
     return getIndeRunErrorValidationIssues(value).length === 0;
 }
@@ -49,6 +68,15 @@ export function validateRoutePlan(value) {
 export function validateModelPackage(value) {
     return getModelPackageValidationIssues(value).length === 0;
 }
+export function validateProviderDescriptor(value) {
+    return getProviderDescriptorValidationIssues(value).length === 0;
+}
+export function validateProviderDynamicCapabilities(value) {
+    return getProviderDynamicCapabilitiesValidationIssues(value).length === 0;
+}
+export function validateProviderCapabilitySnapshot(value) {
+    return getProviderCapabilitySnapshotValidationIssues(value).length === 0;
+}
 export function validateStreamRunHandle(value) {
     return getStreamRunHandleValidationIssues(value).length === 0;
 }
@@ -70,6 +98,17 @@ export function getTaskResultValidationIssues(value) {
         forbidInlineSecrets: true
     });
 }
+export function getTaskOutputValidationIssues(value) {
+    return getValidationIssues(validateTaskOutputSchema, value, {
+        forbidInlineSecrets: true
+    });
+}
+export function getMediaArtifactValidationIssues(value) {
+    return getValidationIssues(validateMediaArtifactSchema, value);
+}
+export function getArtifactReadRequestValidationIssues(value) {
+    return getValidationIssues(validateArtifactReadRequestSchema, value);
+}
 export function getIndeRunErrorValidationIssues(value) {
     return getValidationIssues(validateIndeRunErrorSchema, value, {
         forbidInlineSecrets: true
@@ -105,6 +144,15 @@ export function getModelPackageValidationIssues(value) {
         forbidInlineSecrets: true
     });
 }
+export function getProviderDescriptorValidationIssues(value) {
+    return getValidationIssues(validateProviderDescriptorSchema, value);
+}
+export function getProviderDynamicCapabilitiesValidationIssues(value) {
+    return getValidationIssues(validateProviderDynamicCapabilitiesSchema, value);
+}
+export function getProviderCapabilitySnapshotValidationIssues(value) {
+    return getValidationIssues(validateProviderCapabilitySnapshotSchema, value);
+}
 export function getStreamRunHandleValidationIssues(value) {
     return getValidationIssues(validateStreamRunHandleSchema, value);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@independo/inderun-contracts",
-  "version": "0.4.0",
+  "version": "0.5.0-rc.2",
   "description": "Canonical JSON Schemas, generated TypeScript types, and validators for the IndeRun task, streaming, error, and routing contracts.",
   "license": "MIT",
   "author": {

package/src/generated/artifact-read-request.ts

@@ -0,0 +1,25 @@
+/* This file was generated from JSON Schema using quicktype. Do not edit by hand. */
+
+/**
+ * A ranged read of an engine-owned media artifact through IndeRunApi.readArtifact (ADR
+ * 017). Reads are repeatable until the artifact is disposed; each returns at most the
+ * engine's configured maximum read size, which bounds what one call -- and one bridge
+ * message -- carries.
+ */
+export type ArtifactReadRequest = {
+    /**
+     * MediaArtifact.id of the artifact to read.
+     */
+    artifactId: string;
+    /**
+     * Most bytes to return. Absent, or larger than the engine's maximum read size, means that
+     * maximum.
+     */
+    maxBytes?: number;
+    /**
+     * Byte offset to read from. Absent means 0. An offset equal to the artifact's size returns
+     * an empty, final chunk; a larger one is rejected.
+     */
+    offset?: number;
+    [property: string]: unknown;
+}

package/src/generated/execution-provenance.ts

@@ -62,6 +62,13 @@ export type ExecutionProvenance = {
 }
 
 export type ExecutionProvenanceAttempt = {
+    /**
+     * Whether the run committed to this provider during the attempt: its first content was
+     * delivered, it signalled the first possible audible effect, or it handed over an artifact.
+     * After commit a failure ends the run instead of falling back. Absent means the attempt did
+     * not commit.
+     */
+    committed?: boolean;
     /**
      * Normalized error class of a failed attempt.
      */
@@ -99,4 +106,4 @@ export type ExecutionProvenanceRouteRejection = {
     [property: string]: unknown;
 }
 
-export type Code = "task_not_supported" | "run_not_supported" | "streaming_not_supported" | "streaming_unavailable" | "privacy_constraint" | "cloud_constraint" | "offline" | "capability_unavailable" | "not_in_model_profile";
+export type Code = "task_not_supported" | "run_not_supported" | "streaming_not_supported" | "streaming_unavailable" | "privacy_constraint" | "cloud_constraint" | "offline" | "capability_unavailable" | "not_in_model_profile" | "input_not_supported" | "output_delivery_not_supported" | "output_format_not_supported" | "locale_not_supported" | "voice_not_available";

package/src/generated/inderun-error.ts

@@ -128,6 +128,13 @@ export type ExecutionProvenance = {
 }
 
 export type ExecutionProvenanceAttempt = {
+    /**
+     * Whether the run committed to this provider during the attempt: its first content was
+     * delivered, it signalled the first possible audible effect, or it handed over an artifact.
+     * After commit a failure ends the run instead of falling back. Absent means the attempt did
+     * not commit.
+     */
+    committed?: boolean;
     /**
      * Normalized error class of a failed attempt.
      */
@@ -160,4 +167,4 @@ export type ExecutionProvenanceRouteRejection = {
     [property: string]: unknown;
 }
 
-export type Code = "task_not_supported" | "run_not_supported" | "streaming_not_supported" | "streaming_unavailable" | "privacy_constraint" | "cloud_constraint" | "offline" | "capability_unavailable" | "not_in_model_profile";
+export type Code = "task_not_supported" | "run_not_supported" | "streaming_not_supported" | "streaming_unavailable" | "privacy_constraint" | "cloud_constraint" | "offline" | "capability_unavailable" | "not_in_model_profile" | "input_not_supported" | "output_delivery_not_supported" | "output_format_not_supported" | "locale_not_supported" | "voice_not_available";

package/src/generated/index.ts

@@ -12,5 +12,11 @@ export type { ModelPackage } from "./model-package.js";
 export type { StreamRunHandle } from "./stream-run.js";
 export type { StreamEvent } from "./stream-event.js";
 export type { StreamTerminalOutcome } from "./stream-terminal-outcome.js";
+export type { ProviderCapabilitySnapshot } from "./provider-capability-snapshot.js";
+export type { ProviderDescriptor } from "./provider-descriptor.js";
+export type { ProviderDynamicCapabilities } from "./provider-dynamic-capabilities.js";
+export type { ArtifactReadRequest } from "./artifact-read-request.js";
+export type { TaskOutput } from "./task-output.js";
+export type { MediaArtifact } from "./media-artifact.js";
 export type { ExecutionProvenance } from "./execution-provenance.js";
 export * from "./schemas.js";

package/src/generated/media-artifact.ts

@@ -0,0 +1,56 @@
+/* This file was generated from JSON Schema using quicktype. Do not edit by hand. */
+
+/**
+ * A reference to retrievable media a run produced (ADR 017). It carries no bytes and no
+ * location: an engine-owned artifact is read through the engine by id, and an
+ * application-owned one was written to an application destination. Media-neutral: audio,
+ * images and video share this shape and differ only in mediaType.
+ */
+export type MediaArtifact = {
+    /**
+     * Size of the media in bytes. Always set for an artifact the engine materialized.
+     */
+    byteLength?: number;
+    /**
+     * The request's delivery.destinationRef the bytes were written to. Set exactly when owner
+     * is 'application'.
+     */
+    destinationRef?: string;
+    /**
+     * Duration of time-based media in milliseconds, where the producer knows it.
+     */
+    durationMs?: number;
+    /**
+     * Opaque, engine-issued identifier. Never a path, URL or provider identifier.
+     */
+    id: string;
+    /**
+     * How long the engine keeps the bytes. 'until_disposed': until the application disposes the
+     * artifact or the process ends; the artifact outlives the run that produced it.
+     */
+    lifetime: "until_disposed";
+    /**
+     * IANA media type of the bytes, e.g. 'audio/wav'. Encoding parameters ride on the media
+     * type (e.g. 'audio/L16;rate=22050').
+     */
+    mediaType: string;
+    /**
+     * 'engine': the engine holds the bytes and the application reads them by id until it
+     * disposes the artifact. 'application': the bytes were written to the application
+     * destination named by destinationRef and the engine holds nothing.
+     */
+    owner: ArtifactOwner;
+    [property: string]: unknown;
+}
+
+/**
+ * How long the engine keeps the bytes. 'until_disposed': until the application disposes the
+ * artifact or the process ends; the artifact outlives the run that produced it.
+ */
+
+/**
+ * 'engine': the engine holds the bytes and the application reads them by id until it
+ * disposes the artifact. 'application': the bytes were written to the application
+ * destination named by destinationRef and the engine holds nothing.
+ */
+export type ArtifactOwner = "engine" | "application";