@voltro/plugin-ai-flows 0.28.0 → 0.30.0

package/THIRD-PARTY-NOTICES.md

@@ -5,7 +5,7 @@ property of its respective copyright holders and is used under the terms of
 its license. This file is provided for attribution; it grants no rights in
 @voltro/plugin-ai-flows itself, which is proprietary (see LICENSE).
 
-Generated from the resolved runtime dependency closure (60 packages).
+Generated from the resolved runtime dependency closure (63 packages).
 
 ---
 
@@ -4336,6 +4336,34 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 ```
 
+## isomorphic.js@0.2.5
+
+License: MIT
+
+```
+The MIT License (MIT)
+
+Copyright (c) 2020 Kevin Jahns <kevin.jahns@protonmail.com>.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
 ## jose@6.2.4
 
 License: MIT
@@ -4600,6 +4628,34 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
+## lib0@0.2.117
+
+License: MIT
+
+```
+The MIT License (MIT)
+
+Copyright (c) 2019 Kevin Jahns <kevin.jahns@protonmail.com>.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
 ## mime@3.0.0
 
 License: MIT
@@ -5148,3 +5204,33 @@ IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
+## yjs@13.6.31
+
+License: MIT
+
+```
+The MIT License (MIT)
+
+Copyright (c) 2023
+  - Kevin Jahns <kevin.jahns@protonmail.com>.
+  - Chair of Computer Science 5 (Databases & Information Systems), RWTH Aachen University, Germany
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+

package/dist/index.d.ts

@@ -38,30 +38,7 @@ export declare const aiFlowRunsTable: Table<"_voltro_ai_flow_runs", FieldDefinit
     /** The result bundle: `outputKey → value` (what the UI's result dialog reads). */
     readonly output: ColumnBuilder<Record<string, unknown> | null, "json", boolean>;
     /** Live per-step timeline (`RunStep[]`); the engine writes it on every step. */
-    readonly steps: ColumnBuilder<readonly {
-        readonly id: number;
-        readonly url?: string | undefined;
-        readonly type: "generate" | "agent" | "structured" | "note" | "human";
-        readonly description?: string | undefined;
-        readonly status: "failed" | "running" | "succeeded" | "pending" | "waiting";
-        readonly errorMessage?: string | undefined;
-        readonly output?: {
-            readonly text: string;
-        } | undefined;
-        readonly startedAt?: string | undefined;
-        readonly completedAt?: string | undefined;
-        readonly title: string;
-        readonly costMicroUsd?: number | undefined;
-        readonly requestId?: string | undefined;
-        readonly review?: {
-            readonly prompt: string;
-            readonly options?: readonly {
-                readonly value: string;
-                readonly label: string;
-            }[] | undefined;
-            readonly mode: "text" | "approve" | "choice";
-        } | undefined;
-    }[] | null, "json", boolean>;
+    readonly steps: ColumnBuilder<readonly RunStep[] | null, "json", boolean>;
     readonly currentStep: ColumnBuilder<number, "integer", true>;
     readonly totalSteps: ColumnBuilder<number, "integer", true>;
     /** The HITL answer, written by `respond`. */
@@ -136,37 +113,7 @@ export declare const aiFlowsTable: Table<"_voltro_ai_flows", FieldDefinitions<{
     /** Agentic loop bound; clamped [1,100] at run (default 30). */
     readonly maxSteps: ColumnBuilder<number, "integer", true>;
     /** The ordered plan (`FlowStep[]`); null ≡ empty. */
-    readonly steps: ColumnBuilder<readonly {
-        readonly id: string;
-        readonly type: "generate" | "agent" | "structured" | "note" | "human";
-        readonly description?: string | undefined;
-        readonly outputKey?: string | undefined;
-        readonly schema?: {
-            readonly [x: string]: unknown;
-        } | undefined;
-        readonly title?: string | undefined;
-        readonly prompt?: string | undefined;
-        readonly modality?: "text" | "image" | "video" | "audio" | undefined;
-        readonly model?: string | undefined;
-        readonly params?: {
-            readonly [x: string]: unknown;
-        } | undefined;
-        readonly mediaInputs?: {
-            readonly [x: string]: {
-                readonly from: "upload";
-                readonly url: string;
-            } | {
-                readonly from: "step";
-                readonly ref: string;
-            };
-        } | undefined;
-        readonly agentRef?: string | undefined;
-        readonly reviewMode?: "text" | "approve" | "choice" | undefined;
-        readonly options?: readonly {
-            readonly value: string;
-            readonly label: string;
-        }[] | undefined;
-    }[] | null, "json", boolean>;
+    readonly steps: ColumnBuilder<readonly FlowStep[] | null, "json", boolean>;
     /** The launch-form brief (`BriefField[]`). */
     readonly inputSchema: ColumnBuilder<readonly {
         readonly key: string;
@@ -534,7 +481,45 @@ export declare const FlowStep: Schema.Struct<{
     }>>>;
 }>;
 
-export declare type FlowStep = typeof FlowStep.Type;
+/**
+ * An INTERFACE, not `typeof FlowStep.Type` — and the difference is load-bearing
+ * for the published API report rather than for any consumer.
+ *
+ * `type X = typeof Schema.Type` is an alias to a MAPPED type, and TypeScript's
+ * declaration emit expands an alias like that structurally instead of printing
+ * its name. This type is reached from an exported table
+ * (`aiFlows.steps: json<ReadonlyArray<FlowStep>>()`), so the whole 60-line
+ * expansion landed inline in `etc/plugin-ai-flows.api.md` — and the ORDER of
+ * those members is not stable: a full-monorepo `turbo build` and a
+ * single-package `--force` build emit `params` and `schema` (structurally
+ * identical, both `Schema.optional(Json)`) in different positions.
+ *
+ * That made the api-report drift gate reject a push over a file nobody had
+ * touched, with a diff showing the same member moving. Committing either order
+ * is a coin flip that the next build with a different scope undoes — and CI
+ * builds a different scope than a dev machine does.
+ *
+ * An `interface` is a real declaration TypeScript prints BY NAME, so the report
+ * says `ColumnBuilder<readonly FlowStep[]>` and cannot churn. The `Equals` pin
+ * below makes a divergence between this and the schema a compile error, so the
+ * hand-written shape cannot drift from the runtime one.
+ */
+export declare interface FlowStep {
+    readonly id: string;
+    readonly title?: string | undefined;
+    readonly description?: string | undefined;
+    readonly type: StepType;
+    readonly outputKey?: string | undefined;
+    readonly prompt?: string | undefined;
+    readonly modality?: Modality | undefined;
+    readonly model?: string | undefined;
+    readonly params?: Json | undefined;
+    readonly mediaInputs?: MediaInputs | undefined;
+    readonly agentRef?: string | undefined;
+    readonly schema?: Json | undefined;
+    readonly reviewMode?: ReviewMode | undefined;
+    readonly options?: ReadonlyArray<ReviewOption> | undefined;
+}
 
 /** Typed builders for each step kind — terser + safer than hand-writing the
  *  union. Every builder returns a draft; `defineFlow` assigns the id. */
@@ -858,7 +843,26 @@ export declare const RunStep: Schema.Struct<{
     }>>;
 }>;
 
-export declare type RunStep = typeof RunStep.Type;
+/** An interface for the same reason as {@link FlowStep} — it is reached from
+ *  an exported table (`aiFlowRuns.steps`), so an alias would be expanded
+ *  structurally into the api report and churn with build scope. */
+export declare interface RunStep {
+    readonly id: number;
+    readonly title: string;
+    readonly description?: string | undefined;
+    readonly type: StepType;
+    readonly status: RunStepStatus;
+    readonly startedAt?: string | undefined;
+    readonly completedAt?: string | undefined;
+    readonly costMicroUsd?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly url?: string | undefined;
+    readonly output?: {
+        readonly text: string;
+    } | undefined;
+    readonly errorMessage?: string | undefined;
+    readonly review?: RunReview | undefined;
+}
 
 export declare const RunStepStatus: Schema.Literal<["pending", "running", "waiting", "succeeded", "failed"]>;
 

package/dist/ir.d.ts

@@ -134,7 +134,45 @@ export declare const FlowStep: Schema.Struct<{
     }>>>;
 }>;
 
-export declare type FlowStep = typeof FlowStep.Type;
+/**
+ * An INTERFACE, not `typeof FlowStep.Type` — and the difference is load-bearing
+ * for the published API report rather than for any consumer.
+ *
+ * `type X = typeof Schema.Type` is an alias to a MAPPED type, and TypeScript's
+ * declaration emit expands an alias like that structurally instead of printing
+ * its name. This type is reached from an exported table
+ * (`aiFlows.steps: json<ReadonlyArray<FlowStep>>()`), so the whole 60-line
+ * expansion landed inline in `etc/plugin-ai-flows.api.md` — and the ORDER of
+ * those members is not stable: a full-monorepo `turbo build` and a
+ * single-package `--force` build emit `params` and `schema` (structurally
+ * identical, both `Schema.optional(Json)`) in different positions.
+ *
+ * That made the api-report drift gate reject a push over a file nobody had
+ * touched, with a diff showing the same member moving. Committing either order
+ * is a coin flip that the next build with a different scope undoes — and CI
+ * builds a different scope than a dev machine does.
+ *
+ * An `interface` is a real declaration TypeScript prints BY NAME, so the report
+ * says `ColumnBuilder<readonly FlowStep[]>` and cannot churn. The `Equals` pin
+ * below makes a divergence between this and the schema a compile error, so the
+ * hand-written shape cannot drift from the runtime one.
+ */
+export declare interface FlowStep {
+    readonly id: string;
+    readonly title?: string | undefined;
+    readonly description?: string | undefined;
+    readonly type: StepType;
+    readonly outputKey?: string | undefined;
+    readonly prompt?: string | undefined;
+    readonly modality?: Modality | undefined;
+    readonly model?: string | undefined;
+    readonly params?: Json | undefined;
+    readonly mediaInputs?: MediaInputs | undefined;
+    readonly agentRef?: string | undefined;
+    readonly schema?: Json | undefined;
+    readonly reviewMode?: ReviewMode | undefined;
+    readonly options?: ReadonlyArray<ReviewOption> | undefined;
+}
 
 /** The HITL answer, written by `respond`. */
 export declare const HumanResponse: Schema.Struct<{
@@ -257,7 +295,26 @@ export declare const RunStep: Schema.Struct<{
     }>>;
 }>;
 
-export declare type RunStep = typeof RunStep.Type;
+/** An interface for the same reason as {@link FlowStep} — it is reached from
+ *  an exported table (`aiFlowRuns.steps`), so an alias would be expanded
+ *  structurally into the api report and churn with build scope. */
+export declare interface RunStep {
+    readonly id: number;
+    readonly title: string;
+    readonly description?: string | undefined;
+    readonly type: StepType;
+    readonly status: RunStepStatus;
+    readonly startedAt?: string | undefined;
+    readonly completedAt?: string | undefined;
+    readonly costMicroUsd?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly url?: string | undefined;
+    readonly output?: {
+        readonly text: string;
+    } | undefined;
+    readonly errorMessage?: string | undefined;
+    readonly review?: RunReview | undefined;
+}
 
 export declare const RunStepStatus: Schema.Literal<["pending", "running", "waiting", "succeeded", "failed"]>;
 

package/dist/web.d.ts

@@ -101,7 +101,60 @@ export declare const FlowStep: Schema.Struct<{
     }>>>;
 }>;
 
-export declare type FlowStep = typeof FlowStep.Type;
+/**
+ * An INTERFACE, not `typeof FlowStep.Type` — and the difference is load-bearing
+ * for the published API report rather than for any consumer.
+ *
+ * `type X = typeof Schema.Type` is an alias to a MAPPED type, and TypeScript's
+ * declaration emit expands an alias like that structurally instead of printing
+ * its name. This type is reached from an exported table
+ * (`aiFlows.steps: json<ReadonlyArray<FlowStep>>()`), so the whole 60-line
+ * expansion landed inline in `etc/plugin-ai-flows.api.md` — and the ORDER of
+ * those members is not stable: a full-monorepo `turbo build` and a
+ * single-package `--force` build emit `params` and `schema` (structurally
+ * identical, both `Schema.optional(Json)`) in different positions.
+ *
+ * That made the api-report drift gate reject a push over a file nobody had
+ * touched, with a diff showing the same member moving. Committing either order
+ * is a coin flip that the next build with a different scope undoes — and CI
+ * builds a different scope than a dev machine does.
+ *
+ * An `interface` is a real declaration TypeScript prints BY NAME, so the report
+ * says `ColumnBuilder<readonly FlowStep[]>` and cannot churn. The `Equals` pin
+ * below makes a divergence between this and the schema a compile error, so the
+ * hand-written shape cannot drift from the runtime one.
+ */
+export declare interface FlowStep {
+    readonly id: string;
+    readonly title?: string | undefined;
+    readonly description?: string | undefined;
+    readonly type: StepType;
+    readonly outputKey?: string | undefined;
+    readonly prompt?: string | undefined;
+    readonly modality?: Modality | undefined;
+    readonly model?: string | undefined;
+    readonly params?: Json | undefined;
+    readonly mediaInputs?: MediaInputs | undefined;
+    readonly agentRef?: string | undefined;
+    readonly schema?: Json | undefined;
+    readonly reviewMode?: ReviewMode | undefined;
+    readonly options?: ReadonlyArray<ReviewOption> | undefined;
+}
+
+/** A JSON value (for `params` / `input` / a `structured` step's JSON Schema). */
+declare const Json: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+
+declare type Json = typeof Json.Type;
+
+declare const MediaInputs: Schema.Record$<typeof Schema.String, Schema.Union<[Schema.Struct<{
+    from: Schema.Literal<["upload"]>;
+    url: typeof Schema.String;
+}>, Schema.Struct<{
+    from: Schema.Literal<["step"]>;
+    ref: typeof Schema.String;
+}>]>>;
+
+declare type MediaInputs = typeof MediaInputs.Type;
 
 export declare const Modality: Schema.Literal<["text", "image", "video", "audio"]>;
 
@@ -125,6 +178,18 @@ export declare const ReviewOption: Schema.Struct<{
 
 export declare type ReviewOption = typeof ReviewOption.Type;
 
+/** Human-review config projected onto a `waiting` run step. */
+declare const RunReview: Schema.Struct<{
+    mode: Schema.Literal<["approve", "choice", "text"]>;
+    options: Schema.optional<Schema.Array$<Schema.Struct<{
+        value: typeof Schema.String;
+        label: typeof Schema.String;
+    }>>>;
+    prompt: typeof Schema.String;
+}>;
+
+declare type RunReview = typeof RunReview.Type;
+
 /** Run status — ONE canonical set (the legacy vocabulary; the Voltro-port
  *  additions `awaiting_human`/`completed`/`rejected` are collapsed: `waiting`
  *  covers the human pause, `succeeded` is the single terminal-success literal). */
@@ -161,7 +226,30 @@ export declare const RunStep: Schema.Struct<{
     }>>;
 }>;
 
-export declare type RunStep = typeof RunStep.Type;
+/** An interface for the same reason as {@link FlowStep} — it is reached from
+ *  an exported table (`aiFlowRuns.steps`), so an alias would be expanded
+ *  structurally into the api report and churn with build scope. */
+export declare interface RunStep {
+    readonly id: number;
+    readonly title: string;
+    readonly description?: string | undefined;
+    readonly type: StepType;
+    readonly status: RunStepStatus;
+    readonly startedAt?: string | undefined;
+    readonly completedAt?: string | undefined;
+    readonly costMicroUsd?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly url?: string | undefined;
+    readonly output?: {
+        readonly text: string;
+    } | undefined;
+    readonly errorMessage?: string | undefined;
+    readonly review?: RunReview | undefined;
+}
+
+declare const RunStepStatus: Schema.Literal<["pending", "running", "waiting", "succeeded", "failed"]>;
+
+declare type RunStepStatus = typeof RunStepStatus.Type;
 
 /** The five step types. `generate` fans out to four modalities. */
 export declare const StepType: Schema.Literal<["agent", "generate", "structured", "note", "human"]>;

package/dist/workflow.d.ts

@@ -1,5 +1,6 @@
 import { Schema } from 'effect';
 import { Workflow } from '@effect/workflow/Workflow';
+import { WorkflowMessagesCarrier } from '@voltro/workflow';
 
 /** The canonical name the launch action starts + the app re-export registers. */
 export declare const FLOW_RUN_WORKFLOW = "flow.run";
@@ -32,7 +33,11 @@ export declare const flowRunWorkflow: Workflow<"flow.run", Schema.Struct<{
 }>, Schema.Struct<{
     runId: typeof Schema.String;
     status: Schema.Literal<["succeeded", "failed", "cancelled", "waiting"]>;
-}>, typeof Schema.Never>;
+}>, typeof Schema.Never> & WorkflowMessagesCarrier<{
+    readonly signals: {};
+    readonly updates: {};
+    readonly queries: {};
+}>;
 
 /** The signal a `human` step parks on; `respondToFlow` sends it to resume. */
 export declare const HUMAN_RESPONSE_SIGNAL = "flow-human-response";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-ai-flows",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "description": "AI Flows — durable multi-step AI pipelines (deterministic + agentic) with human-in-the-loop, chaining, and cadence. Author flows in code (defineFlow) or as data (visual editor rows); one engine runs both on @voltro/workflow durability, @voltro/ai generation, storage artifacts, and notifications.",
   "keywords": [
     "voltro",
@@ -57,15 +57,15 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/ai": "0.28.0",
-    "@voltro/database": "0.28.0",
-    "@voltro/env": "0.28.0",
-    "@voltro/plugin-audit": "0.28.0",
-    "@voltro/plugin-multitenancy": "0.28.0",
-    "@voltro/plugin-soft-delete": "0.28.0",
-    "@voltro/protocol": "0.28.0",
-    "@voltro/runtime": "0.28.0",
-    "@voltro/workflow": "0.28.0"
+    "@voltro/ai": "0.30.0",
+    "@voltro/database": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/plugin-audit": "0.30.0",
+    "@voltro/plugin-multitenancy": "0.30.0",
+    "@voltro/plugin-soft-delete": "0.30.0",
+    "@voltro/protocol": "0.30.0",
+    "@voltro/runtime": "0.30.0",
+    "@voltro/workflow": "0.30.0"
   },
   "peerDependencies": {
     "effect": "^3.22.0"