@pikku/cli 0.12.105 → 0.12.107

package/dist/.pikku/workflow/meta/allWorkflow.gen.json

@@ -11,9 +11,15 @@
         "Bootstrap scope definition types": {
             "nodeId": "Bootstrap scope definition types",
             "rpcName": "pikkuScopeDefinitionTypes",
-            "next": "Bootstrap scopes",
+            "next": "Bootstrap error types",
             "stepHash": "94d48581c462"
         },
+        "Bootstrap error types": {
+            "nodeId": "Bootstrap error types",
+            "rpcName": "pikkuErrorTypes",
+            "next": "Bootstrap scopes",
+            "stepHash": "509ac0ac3e23"
+        },
         "Bootstrap scopes": {
             "nodeId": "Bootstrap scopes",
             "rpcName": "pikkuScopes",
@@ -41,14 +47,8 @@
         "Bootstrap auth types": {
             "nodeId": "Bootstrap auth types",
             "rpcName": "pikkuAuth",
-            "next": "Bootstrap function types",
-            "stepHash": "7448f14a2363"
-        },
-        "Bootstrap function types": {
-            "nodeId": "Bootstrap function types",
-            "rpcName": "pikkuFunctionTypes",
             "next": "Bootstrap addon types",
-            "stepHash": "f0ed26a5a99b"
+            "stepHash": "7448f14a2363"
         },
         "Bootstrap addon types": {
             "nodeId": "Bootstrap addon types",
@@ -65,20 +65,8 @@
         "Bootstrap channel types": {
             "nodeId": "Bootstrap channel types",
             "rpcName": "pikkuChannelTypes",
-            "next": "Bootstrap scheduler types",
-            "stepHash": "106bc6b98409"
-        },
-        "Bootstrap scheduler types": {
-            "nodeId": "Bootstrap scheduler types",
-            "rpcName": "pikkuSchedulerTypes",
-            "next": "Bootstrap queue types",
-            "stepHash": "23bd821f9ee3"
-        },
-        "Bootstrap queue types": {
-            "nodeId": "Bootstrap queue types",
-            "rpcName": "pikkuQueueTypes",
             "next": "Bootstrap workflow",
-            "stepHash": "46cd97f1fe31"
+            "stepHash": "106bc6b98409"
         },
         "Bootstrap workflow": {
             "nodeId": "Bootstrap workflow",
@@ -101,49 +89,91 @@
         "Bootstrap AI agent types": {
             "nodeId": "Bootstrap AI agent types",
             "rpcName": "pikkuAgentTypes",
-            "next": "Bootstrap Node types",
+            "next": "Bootstrap scheduler types",
             "stepHash": "e86763caa30e"
         },
-        "Bootstrap Node types": {
-            "nodeId": "Bootstrap Node types",
-            "rpcName": "pikkuNodeTypes",
+        "Bootstrap scheduler types": {
+            "nodeId": "Bootstrap scheduler types",
+            "rpcName": "pikkuSchedulerTypes",
+            "next": "Bootstrap queue types",
+            "stepHash": "23bd821f9ee3"
+        },
+        "Bootstrap queue types": {
+            "nodeId": "Bootstrap queue types",
+            "rpcName": "pikkuQueueTypes",
+            "next": "Bootstrap gateway types",
+            "stepHash": "46cd97f1fe31"
+        },
+        "Bootstrap gateway types": {
+            "nodeId": "Bootstrap gateway types",
+            "rpcName": "pikkuGatewayTypes",
             "next": "Bootstrap Secret definition types",
-            "stepHash": "0a4c29a70251"
+            "stepHash": "daaa1caeda6e"
         },
         "Bootstrap Secret definition types": {
             "nodeId": "Bootstrap Secret definition types",
             "rpcName": "pikkuSecretDefinitionTypes",
-            "next": "Bootstrap CLI types",
+            "next": "Bootstrap Variable definition types",
             "stepHash": "faff6f53d82f"
         },
+        "Bootstrap Variable definition types": {
+            "nodeId": "Bootstrap Variable definition types",
+            "rpcName": "pikkuVariableDefinitionTypes",
+            "next": "Bootstrap CLI types",
+            "stepHash": "aaf0487a2c65"
+        },
         "Bootstrap CLI types": {
             "nodeId": "Bootstrap CLI types",
             "rpcName": "pikkuCLITypes",
-            "next": "Bootstrap re-inspect",
+            "next": "Bootstrap leaf subpath entries",
             "stepHash": "bc3a92886cb6"
         },
+        "Bootstrap leaf subpath entries": {
+            "nodeId": "Bootstrap leaf subpath entries",
+            "rpcName": "pikkuLeafIndexes",
+            "next": "Bootstrap re-inspect",
+            "stepHash": "e8de032c9bc4"
+        },
         "Bootstrap re-inspect": {
             "nodeId": "Bootstrap re-inspect",
             "flow": "inline",
-            "next": "Generate function types"
+            "next": "Secret definition types"
         },
-        "Generate function types": {
-            "nodeId": "Generate function types",
-            "rpcName": "pikkuFunctionTypes",
-            "next": "Re-inspect after types",
-            "stepHash": "37e261039283"
+        "Secret definition types": {
+            "nodeId": "Secret definition types",
+            "rpcName": "pikkuSecretDefinitionTypes",
+            "next": "Scope definition types",
+            "stepHash": "fbfdf42a3974"
         },
-        "Re-inspect after types": {
-            "nodeId": "Re-inspect after types",
-            "flow": "inline",
-            "next": "Function types split"
+        "Scope definition types": {
+            "nodeId": "Scope definition types",
+            "rpcName": "pikkuScopeDefinitionTypes",
+            "next": "Variable definition types",
+            "stepHash": "578ebaf38e55"
+        },
+        "Variable definition types": {
+            "nodeId": "Variable definition types",
+            "rpcName": "pikkuVariableDefinitionTypes",
+            "next": "Function types split",
+            "stepHash": "f0b1834d8da2"
         },
         "Function types split": {
             "nodeId": "Function types split",
             "rpcName": "pikkuFunctionTypesSplit",
-            "next": "Trigger types",
+            "next": "Leaf subpath entries",
             "stepHash": "5ee720286ba3"
         },
+        "Leaf subpath entries": {
+            "nodeId": "Leaf subpath entries",
+            "rpcName": "pikkuLeafIndexes",
+            "next": "Surface usage",
+            "stepHash": "a7b8498e2848"
+        },
+        "Re-inspect after types": {
+            "nodeId": "Re-inspect after types",
+            "flow": "inline",
+            "next": "Trigger types"
+        },
         "Trigger types": {
             "nodeId": "Trigger types",
             "rpcName": "pikkuTriggerTypes",
@@ -165,9 +195,21 @@
         "Channel types": {
             "nodeId": "Channel types",
             "rpcName": "pikkuChannelTypes",
-            "next": "Scheduler types",
+            "next": "MCP types",
             "stepHash": "61560f2f0c8d"
         },
+        "MCP types": {
+            "nodeId": "MCP types",
+            "rpcName": "pikkuMCPTypes",
+            "next": "Gateway types",
+            "stepHash": "685cbd3c2f83"
+        },
+        "Gateway types": {
+            "nodeId": "Gateway types",
+            "rpcName": "pikkuGatewayTypes",
+            "next": "Scheduler types",
+            "stepHash": "8bd91c97f303"
+        },
         "Scheduler types": {
             "nodeId": "Scheduler types",
             "rpcName": "pikkuSchedulerTypes",
@@ -177,20 +219,8 @@
         "Queue types": {
             "nodeId": "Queue types",
             "rpcName": "pikkuQueueTypes",
-            "next": "MCP types",
-            "stepHash": "32340a713206"
-        },
-        "MCP types": {
-            "nodeId": "MCP types",
-            "rpcName": "pikkuMCPTypes",
-            "next": "Node types",
-            "stepHash": "685cbd3c2f83"
-        },
-        "Node types": {
-            "nodeId": "Node types",
-            "rpcName": "pikkuNodeTypes",
             "next": "CLI types",
-            "stepHash": "fa0e98ce519c"
+            "stepHash": "32340a713206"
         },
         "CLI types": {
             "nodeId": "CLI types",
@@ -285,14 +315,14 @@
         "Emails": {
             "nodeId": "Emails",
             "rpcName": "pikkuEmails",
-            "next": "Secret definition types",
+            "next": "Error types",
             "stepHash": "bb8361cb96cf"
         },
-        "Secret definition types": {
-            "nodeId": "Secret definition types",
-            "rpcName": "pikkuSecretDefinitionTypes",
+        "Error types": {
+            "nodeId": "Error types",
+            "rpcName": "pikkuErrorTypes",
             "next": "Auth",
-            "stepHash": "fbfdf42a3974"
+            "stepHash": "3d95fef2aa87"
         },
         "Auth": {
             "nodeId": "Auth",
@@ -309,14 +339,8 @@
         "Credentials": {
             "nodeId": "Credentials",
             "rpcName": "pikkuCredentials",
-            "next": "Scope definition types",
-            "stepHash": "3e4cb364d6f2"
-        },
-        "Scope definition types": {
-            "nodeId": "Scope definition types",
-            "rpcName": "pikkuScopeDefinitionTypes",
             "next": "Scopes",
-            "stepHash": "578ebaf38e55"
+            "stepHash": "3e4cb364d6f2"
         },
         "Scopes": {
             "nodeId": "Scopes",
@@ -333,14 +357,8 @@
         "Personas": {
             "nodeId": "Personas",
             "rpcName": "pikkuPersonas",
-            "next": "Variable definition types",
-            "stepHash": "c17594d64ea5"
-        },
-        "Variable definition types": {
-            "nodeId": "Variable definition types",
-            "rpcName": "pikkuVariableDefinitionTypes",
             "next": "Variables",
-            "stepHash": "f0b1834d8da2"
+            "stepHash": "c17594d64ea5"
         },
         "Variables": {
             "nodeId": "Variables",
@@ -617,9 +635,14 @@
         "Versions update": {
             "nodeId": "Versions update",
             "rpcName": "pikkuVersionsUpdate",
-            "next": "Bootstrap",
+            "next": "Leaf subpath entries",
             "stepHash": "181615f07c8d"
         },
+        "Surface usage": {
+            "nodeId": "Surface usage",
+            "flow": "inline",
+            "next": "Bootstrap"
+        },
         "Bootstrap": {
             "nodeId": "Bootstrap",
             "rpcName": "pikkuBootstrap",
@@ -640,5 +663,5 @@
     "entryNodeIds": [
         "Bootstrap inspect"
     ],
-    "graphHash": "95d5c83b8c0b"
+    "graphHash": "46fc9dfc4d55"
 }

package/dist/.pikku/workflow/pikku-personas.gen.d.ts

@@ -1,6 +1,4 @@
-import type { HttpPersonasConfig } from '@pikku/core/ecosystem/persona';
-import type { ScenarioPersona } from '@pikku/core/services';
-import type { ResolvedPersona } from '@pikku/core/ecosystem/services';
+import type { HttpPersonasConfig, ScenarioPersona, ResolvedPersona } from '@pikku/core/services';
 import type { AgentMap } from '../agent/pikku-agent-map.gen.d.js';
 import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.gen.d.js';
 export declare const personaConfigs: {};

package/dist/.pikku/workflow/pikku-personas.gen.js

@@ -1,8 +1,8 @@
 /**
- * This file was generated by @pikku/cli@0.12.105
+ * This file was generated by @pikku/cli@0.12.96
  */
 /** Personas declared with definePersonas() */
-import { createHttpPersonas } from '@pikku/core/ecosystem/persona';
+import { createHttpPersonas } from '@pikku/core/persona';
 export const personaConfigs = {};
 /**
  * The same personas as a list, widened to `ResolvedPersona`. Iterating

package/dist/.pikku/workflow/pikku-workflow-types.gen.d.ts

@@ -1,51 +1,28 @@
 /**
- * This file was generated by @pikku/cli@0.12.105
+ * This file was generated by @pikku/cli@0.12.107
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
-import { template } from '@pikku/core/ecosystem/workflow';
-import type { PikkuWorkflowGraphConfig, PikkuWorkflowGraphResult } from '@pikku/core/ecosystem/workflow';
-import type { PikkuWorkflowWire, WorkflowStepOptions } from '@pikku/core/ecosystem/workflow';
-import type { PikkuScenarioWire, ScenarioStepOptions } from '@pikku/core/ecosystem/scenario';
+import type { PikkuWorkflowGraphConfig, PikkuWorkflowGraphResult } from '@pikku/core/workflow';
+import type { PikkuWorkflowWire, WorkflowStepOptions } from '@pikku/core/workflow';
 export { WorkflowCancelledException };
-import type { PikkuFunctionSessionless, PikkuFunctionConfig, WiredServices } from '../function/pikku-function-types.gen.js';
+import type { PikkuFunctionSessionless, PikkuFunctionConfig } from '../function/pikku-function-types.gen.js';
 import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js';
 import type { FlattenedWorkflowMap } from './pikku-workflow-map.gen.d.js';
 import type { AgentMap as FlattenedAgentMap } from '../agent/pikku-agent-map.gen.d.js';
-import type { FlattenedScenarioStepMap } from './pikku-scenario-step-map.gen.d.js';
-import type { TypedPersonas } from './pikku-personas.gen.js';
-export type { TypedPersonas };
-export { template };
 export interface TypedWorkflow extends PikkuWorkflowWire {
     do<K extends keyof FlattenedRPCMap>(stepName: string, rpcName: K, data: FlattenedRPCMap[K]['input'], options?: WorkflowStepOptions): Promise<FlattenedRPCMap[K]['output']>;
     do<K extends keyof FlattenedWorkflowMap>(stepName: string, workflowName: K, data: FlattenedWorkflowMap[K]['input'], options?: WorkflowStepOptions): Promise<FlattenedWorkflowMap[K]['output']>;
     do<T>(stepName: string, fn: () => T | Promise<T>, options?: WorkflowStepOptions): Promise<T>;
 }
-/**
- * The typed half of a scenario wire: `given`/`when`/`then`, narrowed to the
- * names declared by `pikkuScenarioStep` in this project. `given` and `when`
- * differ only in the prose the reporter renders; `then` additionally makes the
- * step's bindings witnesses rather than alternatives.
- */
-export interface TypedScenarioSteps {
-    given<K extends keyof FlattenedScenarioStepMap>(stepName: string, stepFunc: K, data?: FlattenedScenarioStepMap[K]['input'], options?: ScenarioStepOptions): Promise<FlattenedScenarioStepMap[K]['output']>;
-    when<K extends keyof FlattenedScenarioStepMap>(stepName: string, stepFunc: K, data?: FlattenedScenarioStepMap[K]['input'], options?: ScenarioStepOptions): Promise<FlattenedScenarioStepMap[K]['output']>;
-    then<K extends keyof FlattenedScenarioStepMap>(stepName: string, stepFunc: K, data?: FlattenedScenarioStepMap[K]['input'], options?: ScenarioStepOptions): Promise<FlattenedScenarioStepMap[K]['output']>;
-}
-/** `Out` types `scenario.context`. */
-export type TypedScenario<Out = unknown> = TypedWorkflow & Omit<PikkuScenarioWire<Out>, keyof PikkuWorkflowWire | keyof TypedScenarioSteps> & TypedScenarioSteps;
 import type { StandardSchemaV1 } from '@standard-schema/spec';
-import type { InferSchemaOutput, PikkuPermission, PikkuMiddleware, NodeConfig, PikkuApprovalDescription } from '../function/pikku-function-types.gen.js';
+import type { InferSchemaOutput, NodeConfig, PikkuApprovalDescription } from '../function/pikku-function-types.gen.js';
+import type { PikkuPermission } from '../auth/pikku-auth-types.gen.js';
+import type { PikkuMiddleware } from '../middleware/pikku-middleware-types.gen.js';
 import type { ScopeId } from '../scopes/pikku-scopes.gen.js';
 import { PikkuError } from '@pikku/core/errors';
-import type { CorePermissionGroup } from '@pikku/core/ecosystem/types';
+import type { CorePermissionGroup } from '@pikku/core/function';
 export type PikkuFunctionWorkflow<In = unknown, Out = never> = PikkuFunctionSessionless<In, Out, 'workflow'>;
-/**
- * `Ctx` types `scenario.context`, defaulting to the body's own output. A hook
- * returns void but shares the scenario's context, so it passes that scenario's
- * output here instead.
- */
-export type PikkuFunctionScenario<In = unknown, Out = never, Ctx = Out> = PikkuFunctionSessionless<In, Out, 'scenario' | 'actors', WiredServices, Ctx>;
-export type PikkuWorkflowConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = {
+type PikkuWorkflowConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = {
     title?: string;
     description?: string;
     tags?: string[];
@@ -58,6 +35,12 @@ export type PikkuWorkflowConfigWithSchema<InputSchema extends StandardSchemaV1 |
     readonly?: boolean;
     approvalRequired?: boolean;
     approvalDescription?: InputSchema extends StandardSchemaV1 ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>> : never;
+    middleware?: PikkuMiddleware[];
+    input?: InputSchema;
+    output?: OutputSchema;
+    node?: NodeConfig;
+    errors?: Array<typeof PikkuError>;
+    inline?: boolean;
     func: PikkuFunctionWorkflow<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>;
     auth?: boolean;
     /**
@@ -66,242 +49,11 @@ export type PikkuWorkflowConfigWithSchema<InputSchema extends StandardSchemaV1 |
      */
     scopes?: ScopeId[];
     permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
-    middleware?: PikkuMiddleware[];
-    input?: InputSchema;
-    output?: OutputSchema;
-    node?: NodeConfig;
-    errors?: Array<typeof PikkuError>;
-    inline?: boolean;
 };
 export declare function pikkuWorkflowFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuWorkflowConfigWithSchema<InputSchema, OutputSchema>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'workflow', PikkuFunctionWorkflow<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>, InputSchema, OutputSchema>;
 export declare function pikkuWorkflowFunc<In, Out = unknown>(func: PikkuFunctionWorkflow<In, Out> | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>): PikkuFunctionConfig<In, Out, 'workflow'>;
 export declare function pikkuWorkflowComplexFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuWorkflowConfigWithSchema<InputSchema, OutputSchema>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'workflow', PikkuFunctionWorkflow<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>, InputSchema, OutputSchema>;
 export declare function pikkuWorkflowComplexFunc<In, Out = unknown>(func: PikkuFunctionWorkflow<In, Out> | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>): PikkuFunctionConfig<In, Out, 'workflow'>;
-export type PikkuScenarioConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = Omit<PikkuWorkflowConfigWithSchema<InputSchema, OutputSchema>, 'func' | 'auth' | 'scopes' | 'permissions'> & {
-    func: PikkuFunctionScenario<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>;
-    /**
-     * Runs before the scenario body. Same signature as `func`, but its return
-     * value is discarded — a hook is setup, not a step, so it is never recorded
-     * on the ladder. Throwing skips the body and fails the run; `after` still
-     * runs.
-     */
-    before?: PikkuScenarioHook<InputSchema, OutputSchema>;
-    /**
-     * Always runs after the scenario body, in a `finally`, whether it passed or
-     * failed. Throwing fails a run that would otherwise have passed; on an
-     * already-failed run it attaches as the `cause` and never replaces the
-     * original error. Reads `scenario.context` for whatever the body managed to
-     * record before it stopped.
-     */
-    after?: PikkuScenarioHook<InputSchema, OutputSchema>;
-    /**
-     * Why this scenario is held out of a default run, stated where the scenario
-     * is. The scenario still appears in the plan and is reported as skipped
-     * rather than quietly omitted; naming it directly with `--flows` runs it
-     * anyway.
-     */
-    skip?: string;
-};
-/**
- * A scenario lifecycle hook: the scenario's own `(services, data, wire)`
- * signature with its result discarded. `OutputSchema` types
- * `scenario.context` while the return type stays `void`.
- */
-export type PikkuScenarioHook<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = PikkuFunctionScenario<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, void, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>;
-/**
- * Declares a scenario hook. Returns the function verbatim — a hook is never
- * registered, so this exists purely to give an inline hook a call site to be
- * contextually typed from, the way every other pikku primitive is.
- */
-export declare function pikkuScenarioHook<In = unknown, Ctx = unknown>(hook: PikkuFunctionScenario<In, void, Ctx>): PikkuFunctionScenario<In, void, Ctx>;
-/**
- * A scenario: a complex workflow that drives the app the way users do.
- * Steps run as actors over the REAL transport — `scenario.do(step, rpc,
- * data, { actor: actors.yasser })` — so flows double as e2e tests and
- * staged/production health checks (no state reset; scope what you create).
- */
-export declare function pikkuScenario<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuScenarioConfigWithSchema<InputSchema, OutputSchema>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'scenario' | 'actors', PikkuFunctionScenario<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>, InputSchema, OutputSchema>;
-export declare function pikkuScenario<In, Out = unknown>(func: PikkuFunctionScenario<In, Out> | PikkuFunctionConfig<In, Out, 'scenario' | 'actors', PikkuFunctionScenario<In, Out>>): PikkuFunctionConfig<In, Out, 'scenario' | 'actors'>;
-/**
- * A scenario as a feature references it. Any `pikkuScenario` export is
- * assignable; `In` is recovered from it so the paired form's `data` is
- * checked against that scenario's own input.
- */
-export type PikkuScenarioRef<In = any, Out = any> = PikkuFunctionConfig<In, Out, 'scenario' | 'actors', PikkuFunctionScenario<In, Out>, any, any>;
-/**
- * One entry in a feature's `scenarios` list, validated against itself: a bare
- * scenario, or a scenario paired with the input to run it with. The paired form
- * is gherkin's `Examples:` written as an ordinary loop.
- */
-export type PikkuFeatureEntry<Entry> = Entry extends {
-    scenario: PikkuScenarioRef<infer In>;
-} ? {
-    scenario: PikkuScenarioRef<In>;
-    data: In;
-} : Entry extends PikkuScenarioRef ? Entry : never;
-export type PikkuFeatureConfig<Scenarios extends readonly unknown[]> = {
-    /** Human-readable name. The export identifier is the id. */
-    name: string;
-    description?: string;
-    tags?: string[];
-    scenarios: {
-        [K in keyof Scenarios]: PikkuFeatureEntry<Scenarios[K]>;
-    };
-    /**
-     * Runs ONCE before the whole group — not before each scenario. Per-scenario
-     * setup is the scenario's own `before`; gherkin's `Background:` is
-     * deliberately not expressible here.
-     */
-    before?: PikkuScenarioHook;
-    after?: PikkuScenarioHook;
-};
-/**
- * A feature: an ordered group of scenarios, mirroring gherkin's Feature ↔
- * Scenario structure. Scenarios are referenced by imported identifier, so a
- * renamed or deleted scenario is a compile error rather than a silent skip.
- *
- * A scenario does not have to belong to a feature — a void-input scenario
- * still runs standalone.
- *
- * ```ts
- * export const credentialFeature = pikkuFeature({
- *   name: 'Credential API',
- *   tags: ['credential'],
- *   before: startsMockOAuthServer,
- *   after: stopsMockOAuthServer,
- *   scenarios: [
- *     credentialLazyLoadScenario,
- *     ...['stripe', 'google'].map((name) => ({
- *       scenario: credentialRoundTripScenario,
- *       data: { name },
- *     })),
- *   ],
- * })
- * ```
- */
-export declare function pikkuFeature<const Scenarios extends readonly unknown[]>(config: PikkuFeatureConfig<Scenarios>): PikkuFeatureConfig<Scenarios>;
-/**
- * One surface's implementation of a step.
- *
- * Each binding is typed independently, so a browser binding gets a non-optional
- * `wire.browser` and a cli binding a non-optional `wire.cli` without either
- * leaking into the other.
- */
-export type PikkuFunctionScenarioStep<In = unknown, Out = never, Surface extends 'browser' | 'cli' | 'default' = 'default'> = PikkuFunctionSessionless<In, Out, Surface extends 'default' ? 'scenarioStep' : 'scenarioStep' | Surface>;
-export type PikkuScenarioStepConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = {
-    /** Registered name — this is the string `scenario.given()` references. */
-    name: string;
-    /**
-     * What this step does, for the console and for whoever reads the source. It
-     * is also the fallback prose when no `template` is declared, in which case a
-     * reporter renders "Given the shopper buys an apple". Defaults to the call
-     * site's step name.
-     */
-    description?: string;
-    /**
-     * The prose a reporter renders for this step, with `{placeholders}` filled
-     * from the input the step was called with — `'sees {packageName}'` reports as
-     * "Then the admin sees @pikku/addon-todos". Every input field should appear,
-     * so the report names the values under test rather than repeating one
-     * sentence per call site.
-     */
-    template?: string;
-    title?: string;
-    tags?: string[];
-    input?: InputSchema;
-    output?: OutputSchema;
-    errors?: Array<typeof PikkuError>;
-    /**
-     * Drive this step through a real browser, as a human would. The runner
-     * provisions a window for the step's actor first — which makes an actor
-     * mandatory — and `wire.browser` is non-optional inside it.
-     *
-     * Compose shared utilities here rather than writing raw clicks: the step says
-     * what the actor is doing, the utilities say how.
-     */
-    browser?: PikkuFunctionScenarioStep<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'browser'>;
-    /** Drive this step remotely, over the websocket. */
-    cli?: PikkuFunctionScenarioStep<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'cli'>;
-    /**
-     * The server-side path — the fast suite, and the floor every other surface
-     * falls back to.
-     *
-     * On a `then`, this is not an alternative to the other bindings but a second
-     * **witness**: the run executes every binding it has and fails if they
-     * disagree, because "the row says paid" and "the page says paid" are different
-     * claims and the gap between them is the bug nobody catches.
-     */
-    default?: PikkuFunctionScenarioStep<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'default'>;
-};
-export type PikkuScenarioStepConfig<In, Out> = Omit<PikkuScenarioStepConfigWithSchema<undefined, undefined>, 'browser' | 'cli' | 'default' | 'input' | 'output'> & {
-    browser?: PikkuFunctionScenarioStep<In, Out, 'browser'>;
-    cli?: PikkuFunctionScenarioStep<In, Out, 'cli'>;
-    default?: PikkuFunctionScenarioStep<In, Out, 'default'>;
-};
-/**
- * A named, reusable scenario step, declaring one implementation per surface an
- * actor can drive it through.
- *
- * The step's identity is what the actor is trying to do; which surface carries
- * it out is a binding. That is what lets one ladder run through a real browser,
- * over the websocket, or entirely server-side — and what makes "how much of this
- * flow can a human actually reach" a number rather than a guess.
- *
- * Steps are deliberately NOT registered as RPCs: a browser-driving step must
- * never be network-callable.
- */
-export declare function pikkuScenarioStep<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuScenarioStepConfigWithSchema<InputSchema, OutputSchema>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'scenarioStep' | 'browser' | 'cli', PikkuFunctionScenarioStep<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'browser' | 'cli' | 'default'>, InputSchema, OutputSchema>;
-export declare function pikkuScenarioStep<In, Out = unknown>(config: PikkuScenarioStepConfig<In, Out>): PikkuFunctionConfig<In, Out, 'scenarioStep' | 'browser' | 'cli'>;
-/**
- * What a step declares when nobody drives it: one implementation, and no
- * surfaces to choose between.
- *
- * `func` rather than `default` is the point. `default` means *the fallback when
- * no other surface applies*, which implies others could exist; `func` says
- * structurally that there is one way this happens. That also keeps the phase
- * rule coherent — an assertion runs every witness it has and fails if they
- * disagree, and this has exactly one by construction.
- */
-export type PikkuSubjectScenarioStepConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = Omit<PikkuScenarioStepConfigWithSchema<InputSchema, OutputSchema>, 'browser' | 'cli' | 'default'> & {
-    func: PikkuFunctionScenarioStep<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'default'>;
-};
-export type PikkuSubjectScenarioStepConfig<In, Out> = Omit<PikkuScenarioStepConfig<In, Out>, 'browser' | 'cli' | 'default'> & {
-    func: PikkuFunctionScenarioStep<In, Out, 'default'>;
-};
-/**
- * A step in which the app acts on itself — "Given the platform has expired the
- * trial".
- *
- * The grammatical subject of that sentence is not a user of your app; it **is**
- * your app, which is why it is its own declaration rather than a persona with an
- * asterisk. A persona is a person.
- *
- * Local-test-only, and never in a virtual user's catalogue: a virtual user that
- * could expire its own trial is manufacturing the outcome it exists to discover.
- */
-export declare function pikkuPlatformScenarioStep<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuSubjectScenarioStepConfigWithSchema<InputSchema, OutputSchema>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'scenarioStep', PikkuFunctionScenarioStep<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'default'>, InputSchema, OutputSchema>;
-export declare function pikkuPlatformScenarioStep<In, Out = unknown>(config: PikkuSubjectScenarioStepConfig<In, Out>): PikkuFunctionConfig<In, Out, 'scenarioStep'>;
-/**
- * A step in which a third-party system acts — "Given Stripe's webhook arrives",
- * "When Mailgun bounces it".
- *
- * `addon` names the addon that wraps that service, the same name its
- * `wireAddon` declares. These steps *are* the mock its consumers currently
- * hand-write: shipped by the addon author, maintained with the addon, and the
- * same artifact that appears in the prose.
- *
- * Note that arranging and asserting are different — "Stripe's webhook arrives"
- * stubs, "Then Stripe was charged" asserts, and only the first is a stub.
- *
- * Local-test-only, and never in a virtual user's catalogue: one that could
- * invoke this would forge its own payment success.
- */
-export declare function pikkuAddonScenarioStep<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuSubjectScenarioStepConfigWithSchema<InputSchema, OutputSchema> & {
-    addon: string;
-}): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'scenarioStep', PikkuFunctionScenarioStep<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'default'>, InputSchema, OutputSchema>;
-export declare function pikkuAddonScenarioStep<In, Out = unknown>(config: PikkuSubjectScenarioStepConfig<In, Out> & {
-    addon: string;
-}): PikkuFunctionConfig<In, Out, 'scenarioStep'>;
 type TypedRef<T> = {
     $ref: string;
     path?: string;
@@ -330,10 +82,16 @@ type RefFunction<FuncMap extends Record<string, string>> = {
     (nodeId: 'trigger' | '$item', path?: string): TypedRef<unknown>;
 };
 type TemplateFunction = (templateStr: string, refs: TypedRef<unknown>[]) => TemplateString;
+type ItemFunction = (path?: string) => TypedRef<unknown>;
+type ForEachConfig<FuncMap extends Record<string, string>> = Extract<keyof FuncMap, string> | ((ref: RefFunction<FuncMap>) => TypedRef<unknown>);
 type GraphNodeConfigMap<FuncMap extends Record<string, string>> = {
     [K in Extract<keyof FuncMap, string>]?: {
         next?: NextConfig<Extract<keyof FuncMap, string>>;
-        input?: NodeInputType<FuncMap, K> | (() => NodeInputType<FuncMap, K>) | ((ref: RefFunction<FuncMap>, template: TemplateFunction) => NodeInputType<FuncMap, K>);
+        /** Run this node once per element of an upstream array. Its result becomes the ordered array of per-item results. */
+        forEach?: ForEachConfig<FuncMap>;
+        /** How the per-item instances of a forEach node run. Defaults to 'parallel'. */
+        mode?: 'parallel' | 'sequential';
+        input?: NodeInputType<FuncMap, K> | (() => NodeInputType<FuncMap, K>) | ((ref: RefFunction<FuncMap>, template: TemplateFunction, $item: ItemFunction) => NodeInputType<FuncMap, K>);
         onError?: Extract<keyof FuncMap, string> | Extract<keyof FuncMap, string>[];
         /** Free-text node documentation. Non-semantic — excluded from graphHash. */
         notes?: string;