@pikku/addon-ollama 0.1.5 → 0.1.7

package/dist/.pikku/addon/trigger/pikku-trigger-types.gen.ts

@@ -1,10 +1,12 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Trigger-specific type definitions for tree-shaking optimization
  */
 
+import type { PikkuHTTP } from '@pikku/core/http'
+import type { CoreTriggerWebhookSource, WebhookVerify, WebhookRequest, WebhookReceiveResult, WebhookLifecycleInput, WebhookCheckResult, WebhookSetupResult, WebhookTeardownInput, WebhookTeardownResult } from '@pikku/core/trigger'
 import {
   CorePikkuTriggerFunction,
   CorePikkuTriggerFunctionConfig,
@@ -69,6 +71,30 @@ type PikkuTriggerFunctionConfigWithSchema<
  */
 
 
+/** A webhook source is only reached over HTTP, so its request and response are always there. */
+type WebhookHTTP = Required<Pick<PikkuHTTP, 'request' | 'response'>>
+
+/**
+ * One step of a webhook source: inline, a pikku function, or `ref('addon:fn')`.
+ */
+type WebhookSourceStep<In, Out> = {
+  func: (services: any, data: In, wire: any) => Promise<Out | void>
+}
+
+/**
+ * A webhook source, using project-specific services.
+ */
+type TriggerWebhookSource<Events extends Record<string, StandardSchemaV1>> =
+  Omit<CoreTriggerWebhookSource<Events>, 'verify' | 'receive' | 'check' | 'setup' | 'teardown'> & {
+    verify?: WebhookVerify<any>
+    receive?: {
+      func: (services: any, data: WebhookRequest, wire: { http: WebhookHTTP }) => Promise<WebhookReceiveResult | void>
+    }
+    check?: WebhookSourceStep<WebhookLifecycleInput, WebhookCheckResult>
+    setup?: WebhookSourceStep<WebhookLifecycleInput, WebhookSetupResult>
+    teardown?: WebhookSourceStep<WebhookTeardownInput, WebhookTeardownResult>
+  }
+
 /**
  * Creates a trigger function configuration.
  * Use this to define trigger functions that set up subscriptions.
@@ -122,3 +148,34 @@ export function pikkuTriggerFunc(triggerOrConfig: any) {
   return triggerOrConfig
 }
 
+/**
+ * A webhook source's `receive`: reads the request into events, or answers a
+ * handshake through `http.response`. It is public (`auth: false`) and only its source's route runs it,
+ * so it is never callable as an RPC. Signatures are the source's `verify`.
+ *
+ * @example snippet: pikkuWebhookReceive
+ */
+export const pikkuWebhookReceive = (config: {
+  /** A short name for the function in the console. */
+  title?: string
+  /** What this receive reads, shown wherever the function is listed. */
+  description?: string
+  /** Groups the function with others in the console and in `pikku info`. */
+  tags?: string[]
+  /** Turns the raw request into `{ events }`. A handshake returns nothing and answers through `http.response`. */
+  func: (services: Omit<SingletonServices, 'secrets'>, request: WebhookRequest, wire: { http: WebhookHTTP }) => Promise<WebhookReceiveResult | void>
+}) => ({ ...config, auth: false as const })
+
+
+/**
+ * Declares a webhook source this addon ships. An app that wires the addon
+ * mounts its route and can register it with the provider, but the source
+ * stays off until someone turns it on. Declaration only: nothing runs here.
+ *
+ * @param source - Webhook source with name, events and its steps
+ */
+export const wireTriggerWebhookSource = <
+  Events extends Record<string, StandardSchemaV1> = Record<string, StandardSchemaV1>
+>(
+  _source: TriggerWebhookSource<Events>
+) => {}

package/dist/.pikku/addon/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * Subpath entry — `#pikku/utils` resolves here.
+ */
+export * from './pikku-utils-types.gen.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/.pikku/addon/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,cAAc,4BAA4B,CAAA"}

package/dist/.pikku/addon/utils/index.js

@@ -0,0 +1,8 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * Subpath entry — `#pikku/utils` resolves here.
+ */
+export * from './pikku-utils-types.gen.js';
+//# sourceMappingURL=index.js.map

package/dist/.pikku/addon/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../.pikku/addon/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,cAAc,4BAA4B,CAAA"}

package/dist/.pikku/addon/utils/index.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * Subpath entry — `#pikku/utils` resolves here.
+ */
+
+export * from './pikku-utils-types.gen.js'

package/dist/.pikku/addon/utils/pikku-utils-types.gen.d.ts

@@ -0,0 +1,5 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+export { parseJson } from '@pikku/core/utils';
+//# sourceMappingURL=pikku-utils-types.gen.d.ts.map

package/dist/.pikku/addon/utils/pikku-utils-types.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-utils-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/utils/pikku-utils-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/.pikku/addon/utils/pikku-utils-types.gen.js

@@ -0,0 +1,5 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+export { parseJson } from '@pikku/core/utils';
+//# sourceMappingURL=pikku-utils-types.gen.js.map

package/dist/.pikku/addon/utils/pikku-utils-types.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-utils-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/utils/pikku-utils-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/.pikku/addon/utils/pikku-utils-types.gen.ts

@@ -0,0 +1,4 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+export { parseJson } from '@pikku/core/utils'

package/dist/.pikku/addon/variables/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/variables` resolves here.

package/dist/.pikku/addon/variables/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/variables` resolves here.

package/dist/.pikku/addon/variables/index.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/variables` resolves here.

package/dist/.pikku/addon/variables/pikku-variable-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 export { defineVariable } from '@pikku/core/variable';
 //# sourceMappingURL=pikku-variable-types.gen.d.ts.map

package/dist/.pikku/addon/variables/pikku-variable-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 export { defineVariable } from '@pikku/core/variable';
 //# sourceMappingURL=pikku-variable-types.gen.js.map

package/dist/.pikku/addon/variables/pikku-variable-types.gen.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 export { defineVariable } from '@pikku/core/variable'

package/dist/.pikku/addon/variables/pikku-variables.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { TypedVariablesService as CoreTypedVariablesService } from '@pikku/core/services';
 import type { VariablesService } from '@pikku/core/services';
@@ -13,9 +13,17 @@ import type { VariablesService } from '@pikku/core/services';
 import './pikku-variables-meta.gen.json';
 import type { z } from 'zod';
 import { ollamaBaseUrlSchema } from '../../../src/ollama.variable.js';
+/**
+ * Every variable this project declares with `defineVariable`, keyed by name. It
+ * is what gives `variables.get('NAME')` a real type.
+ */
 export interface VariablesMap {
     'OLLAMA_BASE_URL': z.infer<typeof ollamaBaseUrlSchema>;
 }
+/**
+ * The `variables` service as this project sees it: `get('NAME')` resolves the
+ * value's type from `VariablesMap` instead of returning `unknown`.
+ */
 export declare class TypedVariablesService extends CoreTypedVariablesService<VariablesMap> {
     constructor(variables: VariablesService);
 }

package/dist/.pikku/addon/variables/pikku-variables.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-variables.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/variables/pikku-variables.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,qBAAqB,IAAI,yBAAyB,EAEnD,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D;;;;;;GAMG;AACH,OAAO,iCAAiC,CAAsB;AAC9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAErE,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;CACvD;AAMD,qBAAa,qBAAsB,SAAQ,yBAAyB,CAAC,YAAY,CAAC;gBACpE,SAAS,EAAE,gBAAgB;CAGxC"}
+{"version":3,"file":"pikku-variables.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/variables/pikku-variables.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,qBAAqB,IAAI,yBAAyB,EAEnD,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D;;;;;;GAMG;AACH,OAAO,iCAAiC,CAAsB;AAC9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAErE;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;CACvD;AAMD;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,yBAAyB,CAAC,YAAY,CAAC;IAChF,YAAY,SAAS,EAAE,gBAAgB,EAEtC;CACF"}

package/dist/.pikku/addon/variables/pikku-variables.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { TypedVariablesService as CoreTypedVariablesService, } from '@pikku/core/services';
 /**
@@ -10,9 +10,14 @@ import { TypedVariablesService as CoreTypedVariablesService, } from '@pikku/core
  * sidecar is not part of `#pikku/variables`.
  */
 import './pikku-variables-meta.gen.json' with { type: 'json' };
+import { ollamaBaseUrlSchema } from '../../../src/ollama.variable.js';
 const TYPED_VARIABLES_META = {
-    'OLLAMA_BASE_URL': { name: 'ollama_base_url', displayName: "Ollama Base URL" }
+    'OLLAMA_BASE_URL': { name: 'ollama_base_url', displayName: "Ollama Base URL", schema: () => ollamaBaseUrlSchema }
 };
+/**
+ * The `variables` service as this project sees it: `get('NAME')` resolves the
+ * value's type from `VariablesMap` instead of returning `unknown`.
+ */
 export class TypedVariablesService extends CoreTypedVariablesService {
     constructor(variables) {
         super(variables, TYPED_VARIABLES_META);

package/dist/.pikku/addon/variables/pikku-variables.gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-variables.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/variables/pikku-variables.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,qBAAqB,IAAI,yBAAyB,GAEnD,MAAM,sBAAsB,CAAA;AAE7B;;;;;;GAMG;AACH,OAAO,iCAAiC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAQ9D,MAAM,oBAAoB,GAAiC;IACzD,iBAAiB,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE;CAC/E,CAAA;AAED,MAAM,OAAO,qBAAsB,SAAQ,yBAAuC;IAChF,YAAY,SAA2B;QACrC,KAAK,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAA;IACxC,CAAC;CACF"}
+{"version":3,"file":"pikku-variables.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/variables/pikku-variables.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,qBAAqB,IAAI,yBAAyB,GAEnD,MAAM,sBAAsB,CAAA;AAE7B;;;;;;GAMG;AACH,OAAO,iCAAiC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAE9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAUrE,MAAM,oBAAoB,GAAiC;IACzD,iBAAiB,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,mBAAmB,EAAE;CAClH,CAAA;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,yBAAuC;IAChF,YAAY,SAA2B;QACrC,KAAK,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAA;IACxC,CAAC;CACF"}

package/dist/.pikku/addon/variables/pikku-variables.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import {
   TypedVariablesService as CoreTypedVariablesService,
@@ -17,14 +17,22 @@ import './pikku-variables-meta.gen.json' with { type: 'json' }
 import type { z } from 'zod'
 import { ollamaBaseUrlSchema } from '../../../src/ollama.variable.js'
 
+/**
+ * Every variable this project declares with `defineVariable`, keyed by name. It
+ * is what gives `variables.get('NAME')` a real type.
+ */
 export interface VariablesMap {
   'OLLAMA_BASE_URL': z.infer<typeof ollamaBaseUrlSchema>
 }
 
 const TYPED_VARIABLES_META: Record<string, VariableMeta> = {
-  'OLLAMA_BASE_URL': { name: 'ollama_base_url', displayName: "Ollama Base URL" }
+  'OLLAMA_BASE_URL': { name: 'ollama_base_url', displayName: "Ollama Base URL", schema: () => ollamaBaseUrlSchema }
 }
 
+/**
+ * The `variables` service as this project sees it: `get('NAME')` resolves the
+ * value's type from `VariablesMap` instead of returning `unknown`.
+ */
 export class TypedVariablesService extends CoreTypedVariablesService<VariablesMap> {
   constructor(variables: VariablesService) {
     super(variables, TYPED_VARIABLES_META)

package/dist/.pikku/addon/webhooks/pikku-outgoing-webhooks-meta.gen.json

@@ -0,0 +1 @@
+{}

package/dist/.pikku/addon/webhooks/pikku-outgoing-webhooks.gen.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+import type { TypedWebhookService as CoreTypedWebhookService } from '@pikku/core/webhook';
+import type { WebhookService } from '@pikku/core/services';
+import './pikku-outgoing-webhooks-meta.gen.json';
+export interface OutgoingWebhooksMap {
+}
+export type OutgoingWebhookEvent = keyof OutgoingWebhooksMap;
+export type TypedWebhookService = CoreTypedWebhookService<OutgoingWebhooksMap>;
+export declare const typedWebhookService: (service: WebhookService) => TypedWebhookService;
+//# sourceMappingURL=pikku-outgoing-webhooks.gen.d.ts.map

package/dist/.pikku/addon/webhooks/pikku-outgoing-webhooks.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-outgoing-webhooks.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/webhooks/pikku-outgoing-webhooks.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,yCAAyC,CAAsB;AAEtE,MAAM,WAAW,mBAAmB;CAAG;AAEvC,MAAM,MAAM,oBAAoB,GAAG,MAAM,mBAAmB,CAAA;AAE5D,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,mBAAmB,CAAC,CAAA;AAE9E,eAAO,MAAM,mBAAmB,YAAa,cAAc,KAAG,mBACnB,CAAA"}

package/dist/.pikku/addon/webhooks/pikku-outgoing-webhooks.gen.js

@@ -0,0 +1,3 @@
+import './pikku-outgoing-webhooks-meta.gen.json' with { type: 'json' };
+export const typedWebhookService = (service) => service;
+//# sourceMappingURL=pikku-outgoing-webhooks.gen.js.map

package/dist/.pikku/addon/webhooks/pikku-outgoing-webhooks.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-outgoing-webhooks.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/webhooks/pikku-outgoing-webhooks.gen.ts"],"names":[],"mappings":"AAKA,OAAO,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAQtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAuB,EAAuB,EAAE,CAClF,OAAyC,CAAA"}

package/dist/.pikku/addon/webhooks/pikku-outgoing-webhooks.gen.ts

@@ -0,0 +1,15 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+import type { TypedWebhookService as CoreTypedWebhookService } from '@pikku/core/webhook'
+import type { WebhookService } from '@pikku/core/services'
+import './pikku-outgoing-webhooks-meta.gen.json' with { type: 'json' }
+
+export interface OutgoingWebhooksMap {}
+
+export type OutgoingWebhookEvent = keyof OutgoingWebhooksMap
+
+export type TypedWebhookService = CoreTypedWebhookService<OutgoingWebhooksMap>
+
+export const typedWebhookService = (service: WebhookService): TypedWebhookService =>
+  service as unknown as TypedWebhookService

package/dist/.pikku/addon/workflow/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/workflow` resolves here.

package/dist/.pikku/addon/workflow/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/workflow` resolves here.

package/dist/.pikku/addon/workflow/index.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/workflow` resolves here.

package/dist/.pikku/addon/workflow/pikku-scenario-step-map.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Scenario step map: the names `scenario.given/when/then` accepts, with

package/dist/.pikku/addon/workflow/pikku-workflow-map.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Workflow type map with input/output types for each workflow

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import type { PikkuWorkflowGraphConfig, PikkuWorkflowGraphResult } from '@pikku/core/workflow';
@@ -9,6 +9,10 @@ import type { PikkuFunctionSessionless, PikkuFunctionConfig } from '../function/
 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';
+/**
+ * The wire a workflow step is handed: `step` to run one durably, plus sleeping,
+ * waiting for a signal and asking for approval.
+ */
 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']>;
@@ -21,6 +25,9 @@ import type { PikkuMiddleware } from '../middleware/pikku-middleware-types.gen.j
 import type { ScopeId } from '../scopes/pikku-scopes.gen.js';
 import { PikkuError } from '@pikku/core/errors';
 import type { CorePermissionGroup } from '@pikku/core/function';
+/**
+ * The shape of a workflow's body — services, input, and the workflow wire.
+ */
 export type PikkuFunctionWorkflow<In = unknown, Out = never> = PikkuFunctionSessionless<In, Out, 'workflow'>;
 type PikkuWorkflowConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = {
     title?: string;
@@ -50,8 +57,22 @@ type PikkuWorkflowConfigWithSchema<InputSchema extends StandardSchemaV1 | undefi
     scopes?: ScopeId[];
     permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
 };
+/**
+ * Declares a workflow: the DSL form, where each step is awaited in order and
+ * the runner persists progress between them so a restart resumes rather than
+ * replays. The default choice for a workflow.
+ *
+ * @example snippet: workflowSteps
+ */
 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'>;
+/**
+ * Declares a workflow whose control flow the DSL cannot express - a loop whose
+ * bound is only known at runtime, or branching that rejoins. An escape hatch:
+ * reach for `pikkuWorkflowFunc` unless the shape genuinely needs this.
+ *
+ * @example snippet: workflowComplexFunc
+ */
 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'>;
 type TypedRef<T> = {
@@ -97,10 +118,13 @@ type GraphNodeConfigMap<FuncMap extends Record<string, string>> = {
         notes?: string;
     };
 };
-type NextConfig<NodeIds extends string> = NodeIds | NodeIds[] | {
-    if: string;
-    then: NodeIds;
-    else?: NodeIds;
-};
+type NextConfig<NodeIds extends string> = NodeIds | NodeIds[] | Record<string, NodeIds | NodeIds[]>;
+/**
+ * Declares a workflow as an explicit node graph, for a genuine cyclic
+ * dependency or a Node-only import the DSL cannot carry. The last resort of the
+ * three.
+ *
+ * @example snippet: workflowGraph
+ */
 export declare function pikkuWorkflowGraph<const FuncMap extends Record<string, (keyof FlattenedRPCMap & string) | (keyof FlattenedWorkflowMap & string) | (keyof FlattenedAgentMap & string)>>(config: PikkuWorkflowGraphConfig<FuncMap, GraphNodeConfigMap<FuncMap>>): PikkuWorkflowGraphResult;
 //# sourceMappingURL=pikku-workflow-types.gen.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pikku-workflow-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/workflow/pikku-workflow-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AAEjE,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,0BAA0B,EAAE,CAAA;AACrC,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAC5G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAA;AACrF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,KAAK,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAEtF,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,EAAE,CAAC,CAAC,SAAS,MAAM,eAAe,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,EACV,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAExC,EAAE,CAAC,CAAC,SAAS,MAAM,oBAAoB,EACrC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,CAAC,EACf,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EACtC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAE7C,EAAE,CAAC,CAAC,EACF,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,CAAC,CAAA;CACd;AAED,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAA;AACtH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE/D,MAAM,MAAM,qBAAqB,CAC/B,EAAE,GAAG,OAAO,EACZ,GAAG,GAAG,KAAK,IACT,wBAAwB,CAAC,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;AAEjD,KAAK,6BAA6B,CAChC,WAAW,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAC5D,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,IAC3D;IACF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,mBAAmB,CAAC,EAAE,WAAW,SAAS,gBAAgB,GAAG,wBAAwB,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,GAAG,KAAK,CAAA;IAC7H,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;IAC9B,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,qBAAqB,CACzB,WAAW,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,WAAW,CAAC,GAAG,OAAO,EAC/E,YAAY,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,YAAY,CAAC,GAAG,OAAO,CAClF,CAAA;IACD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;IAClB,WAAW,CAAC,EAAE,WAAW,SAAS,gBAAgB,GAAG,mBAAmB,CAAC,eAAe,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;CACtI,CAAA;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAC5D,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAE7D,MAAM,EAAE,6BAA6B,CAAC,WAAW,EAAE,YAAY,CAAC,GAC/D,mBAAmB,CAAC,WAAW,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,WAAW,CAAC,GAAG,OAAO,EAAE,YAAY,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,YAAY,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,qBAAqB,CAAC,WAAW,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,WAAW,CAAC,GAAG,OAAO,EAAE,YAAY,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;AAC5Z,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,EACjD,IAAI,EACA,qBAAqB,CAAC,EAAE,EAAE,GAAG,CAAC,GAC9B,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,qBAAqB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,GAC3E,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;AAK3C,wBAAgB,wBAAwB,CACtC,WAAW,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAC5D,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAE7D,MAAM,EAAE,6BAA6B,CAAC,WAAW,EAAE,YAAY,CAAC,GAC/D,mBAAmB,CAAC,WAAW,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,WAAW,CAAC,GAAG,OAAO,EAAE,YAAY,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,YAAY,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,qBAAqB,CAAC,WAAW,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,WAAW,CAAC,GAAG,OAAO,EAAE,YAAY,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;AAC5Z,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,EACxD,IAAI,EACA,qBAAqB,CAAC,EAAE,EAAE,GAAG,CAAC,GAC9B,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,qBAAqB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,GAC3E,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;AAK3C,KAAK,QAAQ,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,aAAa,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAE1E,KAAK,cAAc,GAAG;IACpB,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,WAAW,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KACpD,CAAA;CACF,GAAG;IAAE,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAA;AAEjC,KAAK,aAAa,CAAC,CAAC,IAAI;KACrB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,cAAc;CAC5E,CAAA;AAED,KAAK,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,SAAS,MAAM,OAAO,IAChF,OAAO,CAAC,CAAC,CAAC,SAAS,MAAM,eAAe,GACpC,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GACnD,OAAO,CAAC,CAAC,CAAC,SAAS,MAAM,oBAAoB,GAC3C,aAAa,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GACxD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE/B,KAAK,cAAc,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,SAAS,MAAM,IAC1E,CAAC,SAAS,MAAM,OAAO,GACnB,OAAO,CAAC,CAAC,CAAC,SAAS,MAAM,eAAe,GACtC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,MAAM,GACpD,OAAO,CAAC,CAAC,CAAC,SAAS,MAAM,oBAAoB,GAC3C,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,MAAM,GACzD,OAAO,CAAC,CAAC,CAAC,SAAS,MAAM,iBAAiB,GACxC,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,MAAM,GACtD,MAAM,GACZ,MAAM,CAAA;AAEZ,KAAK,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI;IACzD,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,EACvC,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,GAC/B,QAAQ,CAAC,OAAO,CAAC,CAAA;IACpB,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IACxE,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;CAChE,CAAA;AAED,KAAK,gBAAgB,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,cAAc,CAAA;AAE1F,KAAK,YAAY,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAA;AAExD,KAAK,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IACrD,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,GAC9B,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;AAEtD,KAAK,kBAAkB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI;KAC/D,CAAC,IAAI,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE;QACtC,IAAI,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;QACjD,qHAAqH;QACrH,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;QAChC,gFAAgF;QAChF,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,CAAA;QAChC,KAAK,CAAC,EACF,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,GACzB,CAAC,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GACjC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,YAAY,KAAK,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;QAC/G,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,EAAE,CAAA;QAC3E,4EAA4E;QAC5E,KAAK,CAAC,EAAE,MAAM,CAAA;KACf;CACF,CAAA;AAED,KAAK,UAAU,CAAC,OAAO,SAAS,MAAM,IAAI,OAAO,GAAG,OAAO,EAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE7G,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,OAAO,SAAS,MAAM,CAC1B,MAAM,EACJ,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAChC,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GACrC,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,CACrC,EAED,MAAM,EAAE,wBAAwB,CAAC,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,GACrE,wBAAwB,CAE1B"}
+{"version":3,"file":"pikku-workflow-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/workflow/pikku-workflow-types.gen.ts"],"names":[],"mappings":"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"}

package/dist/.pikku/addon/workflow/pikku-workflow-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import { pikkuWorkflowGraph as corePikkuWorkflowGraph } from '@pikku/core/workflow';
@@ -10,6 +10,13 @@ export function pikkuWorkflowFunc(func) {
 export function pikkuWorkflowComplexFunc(func) {
     return typeof func === 'function' ? { func } : func;
 }
+/**
+ * Declares a workflow as an explicit node graph, for a genuine cyclic
+ * dependency or a Node-only import the DSL cannot carry. The last resort of the
+ * three.
+ *
+ * @example snippet: workflowGraph
+ */
 export function pikkuWorkflowGraph(config) {
     return corePikkuWorkflowGraph(config);
 }

package/dist/.pikku/addon/workflow/pikku-workflow-types.gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-workflow-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/workflow/pikku-workflow-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAUnF,OAAO,EAAE,0BAA0B,EAAE,CAAA;AAuFrC,MAAM,UAAU,iBAAiB,CAAC,IAAS;IACzC,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAaD,MAAM,UAAU,wBAAwB,CAAC,IAAS;IAChD,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAqED,MAAM,UAAU,kBAAkB,CAQhC,MAAsE;IAEtE,OAAO,sBAAsB,CAAC,MAAa,CAAC,CAAA;AAC9C,CAAC"}
+{"version":3,"file":"pikku-workflow-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/workflow/pikku-workflow-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAUnF,OAAO,EAAE,0BAA0B,EAAE,CAAA;AAqGrC,MAAM,UAAU,iBAAiB,CAAC,IAAS;IACzC,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAoBD,MAAM,UAAU,wBAAwB,CAAC,IAAS;IAChD,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAwED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAQhC,MAAsE;IAEtE,OAAO,sBAAsB,CAAC,MAAa,CAAC,CAAA;AAC9C,CAAC"}

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow'
 import { pikkuWorkflowGraph as corePikkuWorkflowGraph } from '@pikku/core/workflow'
@@ -18,6 +18,10 @@ import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.
 import type { FlattenedWorkflowMap } from './pikku-workflow-map.gen.d.js'
 import type { AgentMap as FlattenedAgentMap } from '../agent/pikku-agent-map.gen.d.js'
 
+/**
+ * The wire a workflow step is handed: `step` to run one durably, plus sleeping,
+ * waiting for a signal and asking for approval.
+ */
 export interface TypedWorkflow extends PikkuWorkflowWire {
   do<K extends keyof FlattenedRPCMap>(
     stepName: string,
@@ -48,6 +52,9 @@ import type { ScopeId } from '../scopes/pikku-scopes.gen.js'
 import { PikkuError } from '@pikku/core/errors'
 import type { CorePermissionGroup } from '@pikku/core/function'
 
+/**
+ * The shape of a workflow's body — services, input, and the workflow wire.
+ */
 export type PikkuFunctionWorkflow<
   In = unknown,
   Out = never
@@ -88,6 +95,13 @@ type PikkuWorkflowConfigWithSchema<
   permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined
 }
 
+/**
+ * Declares a workflow: the DSL form, where each step is awaited in order and
+ * the runner persists progress between them so a restart resumes rather than
+ * replays. The default choice for a workflow.
+ *
+ * @example snippet: workflowSteps
+ */
 export function pikkuWorkflowFunc<
   InputSchema extends StandardSchemaV1 | undefined = undefined,
   OutputSchema extends StandardSchemaV1 | undefined = undefined
@@ -103,6 +117,13 @@ export function pikkuWorkflowFunc(func: any) {
   return typeof func === 'function' ? { func } : func
 }
 
+/**
+ * Declares a workflow whose control flow the DSL cannot express - a loop whose
+ * bound is only known at runtime, or branching that rejoins. An escape hatch:
+ * reach for `pikkuWorkflowFunc` unless the shape genuinely needs this.
+ *
+ * @example snippet: workflowComplexFunc
+ */
 export function pikkuWorkflowComplexFunc<
   InputSchema extends StandardSchemaV1 | undefined = undefined,
   OutputSchema extends StandardSchemaV1 | undefined = undefined
@@ -183,8 +204,18 @@ type GraphNodeConfigMap<FuncMap extends Record<string, string>> = {
   }
 }
 
-type NextConfig<NodeIds extends string> = NodeIds | NodeIds[] | { if: string; then: NodeIds; else?: NodeIds }
+type NextConfig<NodeIds extends string> =
+  | NodeIds
+  | NodeIds[]
+  | Record<string, NodeIds | NodeIds[]>
 
+/**
+ * Declares a workflow as an explicit node graph, for a genuine cyclic
+ * dependency or a Node-only import the DSL cannot carry. The last resort of the
+ * three.
+ *
+ * @example snippet: workflowGraph
+ */
 export function pikkuWorkflowGraph<
   const FuncMap extends Record<
     string,

package/dist/.pikku/addon/workflow/pikku-workflow-wirings-meta.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { pikkuState } from '@pikku/core/state';
 const workflowsMeta = {};

package/dist/.pikku/addon/workflow/pikku-workflow-wirings-meta.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { pikkuState } from '@pikku/core/state'
 import type { WorkflowsRuntimeMeta } from '@pikku/core/workflow'

package/dist/.pikku/addon/workflow/pikku-workflow-wirings.gen.d.ts

@@ -1,5 +1,5 @@
 export {};
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 //# sourceMappingURL=pikku-workflow-wirings.gen.d.ts.map

package/dist/.pikku/addon/workflow/pikku-workflow-wirings.gen.js

@@ -1,5 +1,5 @@
 export {};
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 //# sourceMappingURL=pikku-workflow-wirings.gen.js.map

package/dist/.pikku/addon/workflow/pikku-workflow-wirings.gen.ts

@@ -1,3 +1,3 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */

package/dist/.pikku/addon/workflow/virtual-users.gen.json

@@ -0,0 +1 @@
+{}