@voltro/plugin-ai-flows 0.73.0 → 0.75.0

package/dist/index.d.ts

@@ -545,6 +545,21 @@ declare const FlowCapabilityMissing_base: Schema.TaggedErrorClass<FlowCapability
 } & {
     capability: typeof Schema.String;
     message: typeof Schema.String;
+    /** A charge that happened before the failure — the generation succeeded and
+     *  was billed, then storing its artifact did not. The engine records it on
+     *  the failed step, so the run's cost is not reported as unknown when it is
+     *  merely incomplete. */
+    receipt: Schema.optional<Schema.Struct<{
+        costMicroUsd: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+        costSource: Schema.optional<Schema.Literal<["gateway", "estimated", "unpriced"]>>;
+        requestId: Schema.optional<typeof Schema.NonEmptyString>;
+        usage: Schema.optional<Schema.Struct<{
+            status: Schema.Literal<["reported", "unreported"]>;
+            unit: Schema.optional<Schema.Literal<["tokens", "characters", "seconds"]>>;
+            input: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+            output: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+        }>>;
+    }>>;
 }>;
 
 /** Follow-up flow spec. On success, map source → the child's brief. */
@@ -1190,6 +1205,26 @@ export declare interface MediaPersist {
     readonly ingestUrl?: (url: string, run: FlowRunContext) => Effect.Effect<StoredMedia, unknown, unknown>;
 }
 
+/**
+ * The evidence of a charge that happened BEFORE a step failed — a provider that
+ * generated (and billed) while a later part of the step, typically storing the
+ * artifact, did not succeed. A failed step that carries one is priced like a
+ * succeeded one; the run's `costCompleteness` counts it.
+ */
+export declare const MediaReceipt: Schema.Struct<{
+    costMicroUsd: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+    costSource: Schema.optional<Schema.Literal<["gateway", "estimated", "unpriced"]>>;
+    requestId: Schema.optional<typeof Schema.NonEmptyString>;
+    usage: Schema.optional<Schema.Struct<{
+        status: Schema.Literal<["reported", "unreported"]>;
+        unit: Schema.optional<Schema.Literal<["tokens", "characters", "seconds"]>>;
+        input: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+        output: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+    }>>;
+}>;
+
+export declare type MediaReceipt = typeof MediaReceipt.Type;
+
 export declare const MediaResult: Schema.Struct<{
     artifacts: Schema.filter<Schema.Array$<Schema.Struct<{
         url: typeof Schema.NonEmptyString;
@@ -1202,6 +1237,13 @@ export declare const MediaResult: Schema.Struct<{
     costSource: Schema.optional<Schema.Literal<["gateway", "estimated", "unpriced"]>>;
     /** A provider/usage correlation only, never a storage reference. */
     requestId: Schema.optional<typeof Schema.NonEmptyString>;
+    /** What the generation consumed — the quantity behind `costMicroUsd`. */
+    usage: Schema.optional<Schema.Struct<{
+        status: Schema.Literal<["reported", "unreported"]>;
+        unit: Schema.optional<Schema.Literal<["tokens", "characters", "seconds"]>>;
+        input: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+        output: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+    }>>;
 }>;
 
 export declare type MediaResult = typeof MediaResult.Type;
@@ -1384,6 +1426,13 @@ export declare const RunStep: Schema.Struct<{
     costSource: Schema.optional<Schema.Literal<["gateway", "estimated", "unpriced"]>>;
     /** Links a media step to its generation/usage record. */
     requestId: Schema.optional<typeof Schema.String>;
+    /** What the step consumed — also on a FAILED step that was charged. */
+    usage: Schema.optional<Schema.Struct<{
+        status: Schema.Literal<["reported", "unreported"]>;
+        unit: Schema.optional<Schema.Literal<["tokens", "characters", "seconds"]>>;
+        input: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+        output: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+    }>>;
     /** Hosted media artifact URL (image/video/audio), via storage. */
     url: Schema.optional<typeof Schema.String>;
     /** All media variants, including roles and storage references; url projects the primary artifact. */
@@ -1426,6 +1475,8 @@ export declare interface RunStep {
     readonly costMicroUsd?: number | undefined;
     readonly costSource?: CostSource | undefined;
     readonly requestId?: string | undefined;
+    /** What the step consumed — also on a FAILED step that was charged. */
+    readonly usage?: StepUsage | undefined;
     readonly url?: string | undefined;
     readonly artifacts?: ReadonlyArray<MediaArtifact> | undefined;
     readonly output?: {
@@ -1479,6 +1530,25 @@ export declare const StepType: Schema.Literal<["agent", "generate", "structured"
 
 export declare type StepType = typeof StepType.Type;
 
+/**
+ * What a step CONSUMED, in the provider's own unit — the quantity a cost was, or
+ * could have been, priced from. `reported`: the provider said so. `unreported`:
+ * the call returned no tally, so there is nothing to price and nothing to
+ * dispute, and saying that is different from saying zero.
+ *
+ * Without it a step priced `unpriced` read the same whether the provider had
+ * reported 7/150 tokens or nothing at all — and only the first can be priced
+ * later, or reconciled against an invoice.
+ */
+export declare const StepUsage: Schema.Struct<{
+    status: Schema.Literal<["reported", "unreported"]>;
+    unit: Schema.optional<Schema.Literal<["tokens", "characters", "seconds"]>>;
+    input: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+    output: Schema.optional<Schema.filter<typeof Schema.Finite>>;
+}>;
+
+export declare type StepUsage = typeof StepUsage.Type;
+
 /** A persisted artifact — a hosted URL + optional storage ref id. */
 export declare interface StoredMedia {
     readonly url: string;