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

package/dist/generated/stream-event.d.ts

@@ -105,6 +105,7 @@ export type Payload = {
     finalText?: string;
     finishReason?: FinishReason;
     outcome?: Outcome;
+    output?: TaskOutput;
     /**
      * Normalized execution provenance: which target ran, its declared locality, the configured
      * and reported model, and how fallback and routing played out. See
@@ -207,6 +208,13 @@ export type ExecutionProvenance = {
     [property: string]: unknown;
 };
 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.
      */
@@ -235,9 +243,136 @@ export type ExecutionProvenanceRouteRejection = {
     providerId: string;
     [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";
 export type FinishReason = "stop" | "length" | "cancelled" | "error";
 export type Outcome = "completed" | "error" | "cancelled";
+/**
+ * The normalized output of a run, shared by TaskResult and the completed and cancelled
+ * stream terminal outcomes (ADR 016). 'type' describes the content representation, not the
+ * task: 'text' carries inline text, 'playback' reports a managed, audible effect that has
+ * no retrievable bytes, and 'artifact' references retrievable media (ADR 017). A playback
+ * output is never an artifact, and an artifact output never implies that anything was
+ * played.
+ */
+export type TaskOutput = {
+    /**
+     * The retrievable media the run produced. Required when type is 'artifact'.
+     */
+    artifact?: MediaArtifact;
+    /**
+     * Completion of managed playback. Required when type is 'playback'. Carries no media.
+     */
+    playback?: PlaybackOutput;
+    /**
+     * The locale and voice traits a text-to-speech run actually used, so an unmet preference is
+     * visible without being an error.
+     */
+    speech?: SpeechOutput;
+    /**
+     * The text the run produced. Required when type is 'text'.
+     */
+    text?: string;
+    /**
+     * The content representation: 'text', 'playback' or 'artifact'.
+     */
+    type: TaskOutputType;
+    [property: string]: unknown;
+};
+/**
+ * The retrievable media the run produced. Required when type is 'artifact'.
+ *
+ * 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";
+/**
+ * Completion of managed playback. Required when type is 'playback'. Carries no media.
+ */
+export type PlaybackOutput = {
+    /**
+     * How long audible playback lasted, in milliseconds. For a cancelled run, how long it
+     * played before it was stopped.
+     */
+    durationMs?: number;
+    [property: string]: unknown;
+};
+/**
+ * The locale and voice traits a text-to-speech run actually used, so an unmet preference is
+ * visible without being an error.
+ */
+export type SpeechOutput = {
+    /**
+     * BCP 47 tag of the locale that was spoken.
+     */
+    locale: string;
+    /**
+     * Provider-neutral traits of the voice that spoke. Carries no provider voice identifier.
+     */
+    voice?: SpeechOutputVoice;
+    [property: string]: unknown;
+};
+/**
+ * Provider-neutral traits of the voice that spoke. Carries no provider voice identifier.
+ */
+export type SpeechOutputVoice = {
+    gender?: VoiceGender;
+    [property: string]: unknown;
+};
+/**
+ * Perceived gender of a voice, as the platform reports it.
+ */
+export type VoiceGender = "female" | "male" | "neutral";
+/**
+ * The content representation: 'text', 'playback' or 'artifact'.
+ */
+export type TaskOutputType = "text" | "playback" | "artifact";
 /**
  * The lifecycle phase reached.
  */

package/dist/generated/stream-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-event.d.ts","sourceRoot":"","sources":["../../src/generated/stream-event.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stream-event.d.ts","sourceRoot":"","sources":["../../src/generated/stream-event.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAS,KAAK,CAAC;IACrB,SAAS,CAAC,EAAK,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,OAAO,CAAC,EAAO,OAAO,CAAC;IACvB,MAAM,CAAC,EAAQ,UAAU,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAK,mBAAmB,CAAC;IACpC,KAAK,CAAC,EAAU,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,SAAS,CAAC,EAAM,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAU,KAAK,CAAC;IACtB,KAAK,CAAC,EAAU,KAAK,CAAC;IACtB,WAAW,CAAC,EAAI,MAAM,CAAC;IACvB,MAAM,CAAC,EAAS,MAAM,CAAC;IACvB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IAChB,OAAO,CAAC,EAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACvC,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAK,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAI,mBAAmB,CAAC;IACnC,UAAU,CAAC,EAAI,MAAM,CAAC;IACtB,SAAS,CAAC,EAAK,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,KAAK,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAEjI;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,EAAE,QAAQ,CAAC;IACnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,eAAe,EAAE,iCAAiC,EAAE,CAAC;IACrD;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACrC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,OAAO,EAAK,cAAc,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,iCAAiC,GAAG;IAC5C,KAAK,EAAO,IAAI,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,IAAI,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,yBAAyB,GAAG,uBAAuB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,SAAS,GAAG,wBAAwB,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,+BAA+B,GAAG,6BAA6B,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AAE3W,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,EAAE,aAAa,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,aAAa,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,mBAAmB,GAAG,SAAS,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAO,MAAM,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IAChB,WAAW,CAAC,EAAG,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAG,MAAM,CAAC;IACtB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA"}

package/dist/generated/stream-terminal-outcome.d.ts

@@ -2,23 +2,25 @@
  * How a Mode 2 stream run ended. Completion, error, and cancellation are mutually exclusive
  * terminal outcomes, enforced here as a closed set of three oneOf branches discriminated by
  * 'outcome' (unlike StreamEvent.type, this set is not open-ended: the three-way terminal
- * outcome is a fixed architectural guarantee, not something new outcome kinds get added
- * to). Exactly one StreamTerminalOutcome is produced per run, and no further StreamEvent is
- * delivered after it (see docs/architecture/architecture.md, 'Cancellation And Fallback').
- * This shape is also embedded by value as the payload of the terminal StreamEvent
- * (stream-event.schema.json) so it can additionally be exposed standalone, e.g. as a
- * completion future/promise a stream handle resolves independently of consuming the full
- * event sequence; the two copies must stay structurally identical. Note on
- * additionalProperties: per this repo's forward-compatible convention every branch permits
- * unknown extra fields, so mutual exclusivity is enforced via the required 'outcome'
- * discriminator plus each branch's own required peer field (finalText/error/partialText)
- * being present, not by forbidding a payload from also carrying an unrelated stray field
- * from another branch's vocabulary.
+ * outcome is a fixed architectural guarantee, not something new outcome kinds get added to;
+ * the payload of each branch may grow additively). Exactly one StreamTerminalOutcome is
+ * produced per run, and no further StreamEvent is delivered after it (see
+ * docs/architecture/architecture.md, 'Cancellation And Fallback'). This shape is also
+ * embedded by value as the payload of the terminal StreamEvent (stream-event.schema.json)
+ * so it can additionally be exposed standalone, e.g. as a completion future/promise a
+ * stream handle resolves independently of consuming the full event sequence; the two copies
+ * must stay structurally identical. Note on additionalProperties: per this repo's
+ * forward-compatible convention every branch permits unknown extra fields, so mutual
+ * exclusivity is enforced via the required 'outcome' discriminator plus each branch's own
+ * required peer field being present (finalText or output / error), and for 'cancelled' by
+ * the discriminator alone, not by forbidding a payload from also carrying an unrelated
+ * stray field from another branch's vocabulary.
  */
 export type StreamTerminalOutcome = {
     /**
-     * The full, cumulative text produced by the run. Equivalent in role to
-     * TaskResult.output.text for Mode 1.
+     * The full, cumulative text produced by a text run. Equivalent in role to
+     * TaskResult.output.text for Mode 1. A text run sets it; a non-text run carries output
+     * instead.
      */
     finalText?: string;
     /**
@@ -40,6 +42,19 @@ export type StreamTerminalOutcome = {
      * further fallback attempt is made, per the engine's cancellation guarantee.
      */
     outcome: Outcome;
+    /**
+     * The normalized output of the run, the same shape run() returns in TaskResult.output. Set
+     * for every non-text run; a text run may set it alongside finalText. See
+     * task-output.schema.json.
+     *
+     * What a cancelled non-text run had already produced: a playback run that committed (audio
+     * may have been heard) carries a playback output, and an artifact run cancelled while the
+     * engine was writing its artifact to an application destination carries that
+     * application-owned artifact, whose bytes the write left at the destination. Absent when
+     * nothing was produced, e.g. an artifact run cancelled before its artifact was handed over,
+     * whose partial media the engine discards. See task-output.schema.json.
+     */
+    output?: TaskOutput;
     /**
      * Normalized execution provenance: which target ran, its declared locality, the configured
      * and reported model, and how fallback and routing played out. See
@@ -74,9 +89,13 @@ export type StreamTerminalOutcome = {
      */
     error?: Error;
     /**
-     * Whatever cumulative text had already been delivered via content_delta/content_snapshot
-     * StreamEvents before the cancellation point. May be empty if cancellation occurred before
-     * any content was produced.
+     * Whatever cumulative text a text run had already delivered before it failed after
+     * committing to its provider. Absent when nothing was delivered.
+     *
+     * Whatever cumulative text a text run had already delivered via
+     * content_delta/content_snapshot StreamEvents before the cancellation point. Always set for
+     * a text run, and empty if cancellation occurred before any content was produced. A
+     * non-text run never sets it.
      */
     partialText?: string;
     /**
@@ -212,6 +231,13 @@ export type ExecutionProvenance = {
     [property: string]: unknown;
 };
 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.
      */
@@ -240,7 +266,7 @@ export type ExecutionProvenanceRouteRejection = {
     providerId: string;
     [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";
 /**
  * How generation ended, mirroring TaskResult.finishReason for Mode 1: 'stop' (natural end),
  * 'length' (hit maxOutputTokens), 'error' (provider reported a non-fatal issue on an
@@ -250,6 +276,144 @@ export type Code = "task_not_supported" | "run_not_supported" | "streaming_not_s
  */
 export type FinishReason = "stop" | "length" | "cancelled" | "error";
 export type Outcome = "completed" | "error" | "cancelled";
+/**
+ * The normalized output of the run, the same shape run() returns in TaskResult.output. Set
+ * for every non-text run; a text run may set it alongside finalText. See
+ * task-output.schema.json.
+ *
+ * The normalized output of a run, shared by TaskResult and the completed and cancelled
+ * stream terminal outcomes (ADR 016). 'type' describes the content representation, not the
+ * task: 'text' carries inline text, 'playback' reports a managed, audible effect that has
+ * no retrievable bytes, and 'artifact' references retrievable media (ADR 017). A playback
+ * output is never an artifact, and an artifact output never implies that anything was
+ * played.
+ *
+ * What a cancelled non-text run had already produced: a playback run that committed (audio
+ * may have been heard) carries a playback output, and an artifact run cancelled while the
+ * engine was writing its artifact to an application destination carries that
+ * application-owned artifact, whose bytes the write left at the destination. Absent when
+ * nothing was produced, e.g. an artifact run cancelled before its artifact was handed over,
+ * whose partial media the engine discards. See task-output.schema.json.
+ */
+export type TaskOutput = {
+    /**
+     * The retrievable media the run produced. Required when type is 'artifact'.
+     */
+    artifact?: MediaArtifact;
+    /**
+     * Completion of managed playback. Required when type is 'playback'. Carries no media.
+     */
+    playback?: PlaybackOutput;
+    /**
+     * The locale and voice traits a text-to-speech run actually used, so an unmet preference is
+     * visible without being an error.
+     */
+    speech?: SpeechOutput;
+    /**
+     * The text the run produced. Required when type is 'text'.
+     */
+    text?: string;
+    /**
+     * The content representation: 'text', 'playback' or 'artifact'.
+     */
+    type: TaskOutputType;
+    [property: string]: unknown;
+};
+/**
+ * The retrievable media the run produced. Required when type is 'artifact'.
+ *
+ * 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";
+/**
+ * Completion of managed playback. Required when type is 'playback'. Carries no media.
+ */
+export type PlaybackOutput = {
+    /**
+     * How long audible playback lasted, in milliseconds. For a cancelled run, how long it
+     * played before it was stopped.
+     */
+    durationMs?: number;
+    [property: string]: unknown;
+};
+/**
+ * The locale and voice traits a text-to-speech run actually used, so an unmet preference is
+ * visible without being an error.
+ */
+export type SpeechOutput = {
+    /**
+     * BCP 47 tag of the locale that was spoken.
+     */
+    locale: string;
+    /**
+     * Provider-neutral traits of the voice that spoke. Carries no provider voice identifier.
+     */
+    voice?: SpeechOutputVoice;
+    [property: string]: unknown;
+};
+/**
+ * Provider-neutral traits of the voice that spoke. Carries no provider voice identifier.
+ */
+export type SpeechOutputVoice = {
+    gender?: VoiceGender;
+    [property: string]: unknown;
+};
+/**
+ * Perceived gender of a voice, as the platform reports it.
+ */
+export type VoiceGender = "female" | "male" | "neutral";
+/**
+ * The content representation: 'text', 'playback' or 'artifact'.
+ */
+export type TaskOutputType = "text" | "playback" | "artifact";
 /**
  * Required metadata providing an overview of the execution result and performance metrics.
  * Same shape as TaskResult.telemetry.

package/dist/generated/stream-terminal-outcome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-terminal-outcome.d.ts","sourceRoot":"","sources":["../../src/generated/stream-terminal-outcome.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stream-terminal-outcome.d.ts","sourceRoot":"","sources":["../../src/generated/stream-terminal-outcome.ts"],"names":[],"mappings":"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"}

package/dist/generated/task-output.d.ts

@@ -0,0 +1,128 @@
+/**
+ * The normalized output of a run, shared by TaskResult and the completed and cancelled
+ * stream terminal outcomes (ADR 016). 'type' describes the content representation, not the
+ * task: 'text' carries inline text, 'playback' reports a managed, audible effect that has
+ * no retrievable bytes, and 'artifact' references retrievable media (ADR 017). A playback
+ * output is never an artifact, and an artifact output never implies that anything was
+ * played.
+ */
+export type TaskOutput = {
+    /**
+     * The retrievable media the run produced. Required when type is 'artifact'.
+     */
+    artifact?: MediaArtifact;
+    /**
+     * Completion of managed playback. Required when type is 'playback'. Carries no media.
+     */
+    playback?: PlaybackOutput;
+    /**
+     * The locale and voice traits a text-to-speech run actually used, so an unmet preference is
+     * visible without being an error.
+     */
+    speech?: SpeechOutput;
+    /**
+     * The text the run produced. Required when type is 'text'.
+     */
+    text?: string;
+    /**
+     * The content representation: 'text', 'playback' or 'artifact'.
+     */
+    type: TaskOutputType;
+    [property: string]: unknown;
+};
+/**
+ * The retrievable media the run produced. Required when type is 'artifact'.
+ *
+ * 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";
+/**
+ * Completion of managed playback. Required when type is 'playback'. Carries no media.
+ */
+export type PlaybackOutput = {
+    /**
+     * How long audible playback lasted, in milliseconds. For a cancelled run, how long it
+     * played before it was stopped.
+     */
+    durationMs?: number;
+    [property: string]: unknown;
+};
+/**
+ * The locale and voice traits a text-to-speech run actually used, so an unmet preference is
+ * visible without being an error.
+ */
+export type SpeechOutput = {
+    /**
+     * BCP 47 tag of the locale that was spoken.
+     */
+    locale: string;
+    /**
+     * Provider-neutral traits of the voice that spoke. Carries no provider voice identifier.
+     */
+    voice?: SpeechOutputVoice;
+    [property: string]: unknown;
+};
+/**
+ * Provider-neutral traits of the voice that spoke. Carries no provider voice identifier.
+ */
+export type SpeechOutputVoice = {
+    gender?: VoiceGender;
+    [property: string]: unknown;
+};
+/**
+ * Perceived gender of a voice, as the platform reports it.
+ */
+export type VoiceGender = "female" | "male" | "neutral";
+/**
+ * The content representation: 'text', 'playback' or 'artifact'.
+ */
+export type TaskOutputType = "text" | "playback" | "artifact";
+//# sourceMappingURL=task-output.d.ts.map

package/dist/generated/task-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-output.d.ts","sourceRoot":"","sources":["../../src/generated/task-output.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,EAAE,aAAa,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,aAAa,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC"}

package/dist/generated/task-output.js

@@ -0,0 +1,2 @@
+/* This file was generated from JSON Schema using quicktype. Do not edit by hand. */
+export {};