@voltro/plugin-ai-flows 0.83.0 → 0.84.0

package/dist/errors.js

@@ -1,4 +1,4 @@
-import { C as e } from "./ir-DcPJp738.js";
+import { C as e } from "./ir-CdDUTf98.js";
 import { Schema as t } from "effect";
 //#region src/errors.ts
 var n = class extends t.TaggedError()("FlowNotFound", {

package/dist/index.d.ts

@@ -434,6 +434,13 @@ export declare interface EngineDeps {
     readonly resolveTools?: (flowRef: string, run: FlowRunContext, planner: {
         readonly provider: () => ProviderConfig | undefined;
     }) => Effect.Effect<Record<string, AnyTool>, FlowCapabilityMissing, unknown>;
+    /** The agents the agentic planner may delegate to in this run — the same set
+     *  `resolveAgent` admits. With it, `run_agent` accepts exactly these refs and
+     *  the planner reads their descriptions; without it, the agent refs the plan's
+     *  own agent steps name. A planner given no list guesses, and a guess is a
+     *  failed step. An explicit empty list removes `run_agent`; a listing failure
+     *  refuses planning instead of broadening delegation. */
+    readonly listAgents?: (run: FlowRunContext) => Effect.Effect<ReadonlyArray<PlannerAgent>, FlowCapabilityMissing, unknown>;
     /** Media generator for image/video/audio steps (`makeMediaGenerator` in
      *  `mediaAdapter.ts` is the @voltro/ai-backed implementation). */
     readonly generateMedia?: MediaGenerator;
@@ -1318,6 +1325,13 @@ export declare const nonContiguousGroups: (segments: ReadonlyArray<FlowSegment>)
  */
 export declare const normalizeFlow: (def: FlowDefinitionInput) => FlowIR;
 
+/** One agent the agentic planner may call, as `listAgents` reports it. */
+export declare interface PlannerAgent {
+    readonly ref: string;
+    /** What the agent is for, in a sentence the planner reads. */
+    readonly description?: string;
+}
+
 /**
  * Converge every pending flow run whose start was recorded as `queued` onto
  * what that start has become. Bounded by `take` (newest-first is not needed:
@@ -1470,6 +1484,11 @@ export declare const RunStep: Schema.Struct<{
     description: Schema.optional<typeof Schema.String>;
     type: Schema.Literal<["agent", "generate", "structured", "note", "human"]>;
     status: Schema.Literal<["pending", "running", "waiting", "succeeded", "failed", "skipped"]>;
+    /** The agent an `agent` step delegated to — a field, so a run view never
+     *  parses it out of `title`. */
+    agentRef: Schema.optional<typeof Schema.String>;
+    /** What a `generate` step produced. */
+    modality: Schema.optional<Schema.Literal<["text", "image", "video", "audio"]>>;
     startedAt: Schema.optional<typeof Schema.String>;
     completedAt: Schema.optional<typeof Schema.String>;
     /** Per-step cost in micro-USD (the app view projects to €/cents). */
@@ -1523,6 +1542,8 @@ export declare interface RunStep {
     readonly description?: string | undefined;
     readonly type: StepType;
     readonly status: RunStepStatus;
+    readonly agentRef?: string | undefined;
+    readonly modality?: Modality | undefined;
     readonly startedAt?: string | undefined;
     readonly completedAt?: string | undefined;
     readonly costMicroUsd?: number | undefined;