@nexalab/agent-sdk 0.1.0 → 0.1.6

package/README.md

@@ -20,6 +20,26 @@ For local workspace use:
 }
 ```
 
+## Documentation
+
+The full documentation site is built with VitePress and lives in `docs/`. The API reference under `docs/api` is generated automatically from the TypeScript sources with TypeDoc:
+
+```bash
+# Regenerate the API reference markdown from src/ into docs/api
+pnpm docs:generate
+
+# Develop the docs site (regenerates the API reference, then starts a dev server)
+pnpm docs:dev
+
+# Production build (regenerates the API reference, then builds the static site)
+pnpm docs:build
+
+# Preview the production build locally
+pnpm docs:preview
+```
+
+`docs:build` requires a successful `docs:generate` and is also validated in CI for every push/PR. The generated `docs/api` directory is not committed — it is always produced from source.
+
 ## Quick Start
 
 ### Premium `agent({...})` Kernel API
@@ -193,8 +213,54 @@ import { createSession, loadSession } from "@nexalab/agent-sdk/sessions";
 import { defineGuardrail, runInputGuardrails, runOutputGuardrails } from "@nexalab/agent-sdk/guardrails";
 import { createHookDispatcher } from "@nexalab/agent-sdk/hooks";
 import { zodSchemaToJsonSchema, parseStructuredOutput } from "@nexalab/agent-sdk/structured-output";
+import { defineFlow } from "@nexalab/agent-sdk/guided-flows";
+```
+
+## Guided Flows
+
+Build stateful, multi-turn conversations that must satisfy explicit requirements before completion.
+
+Guided Flows combine natural conversation with typed state, step-specific tools, validation, branching, confirmations, and structured final outputs. Attach one or more to `agent({ flows })`; the runtime fills state from free-form messages in any order, never re-asks for what it already has, scopes tool availability per step (never beyond what the agent itself is permitted), and only returns a Zod-validated structured `output` once every requirement holds.
+
+```ts
+import { agent, defineFlow } from "@nexalab/agent-sdk";
+import { z } from "zod";
+
+const gasOrderFlow = defineFlow({
+  id: "gas-order",
+  version: 1,
+  name: "Gas order",
+  goal: "Crear un pedido de gas valido y confirmado",
+  stateSchema: z.object({
+    customerName: z.string().optional(),
+    phone: z.string().optional(),
+    confirmed: z.boolean().default(false),
+    orderId: z.string().optional()
+  }),
+  initialState: { confirmed: false },
+  requirements: [
+    { id: "customer", description: "Customer identity known", satisfied: ({ state }) => Boolean(state.customerName && state.phone) },
+    { id: "confirmation", description: "Order confirmed", satisfied: ({ state }) => state.confirmed === true }
+  ],
+  steps: [
+    { id: "identify_customer", collect: ["customerName", "phone"] },
+    { id: "confirmation", collect: ["confirmed"], exit: ({ state }) => state.confirmed === true, tools: { denied: ["order.create"] } },
+    { id: "create_order", when: ({ state }) => state.confirmed === true, tools: { required: ["order.create"] }, exit: ({ state }) => Boolean(state.orderId) }
+  ],
+  protectedFields: { orderId: ["tool"] },
+  tools: { bindings: { "order.create": { applyResult: ({ result }) => ({ set: { orderId: result.output.orderId }, source: "tool" } as const) } } },
+  completion: ({ requirements, state }) => requirements.every((r) => r.satisfied) && Boolean(state.orderId),
+  outputSchema: z.object({ type: z.literal("gas_order"), orderId: z.string() }),
+  mapOutput: ({ state }) => ({ type: "gas_order" as const, orderId: state.orderId! })
+});
+
+const salesAgent = await agent({ name: "gas-sales-agent", model: "openai:gpt-4o-mini", flows: [gasOrderFlow], tools: [orderCreateTool] });
+const result = await salesAgent.session("whatsapp:5214771234567").run("Quiero pedir gas");
+console.log(result.text, result.flow, result.state, result.output);
 ```
 
+See the full guide at [docs/guide/guided-flows.md](./docs/guide/guided-flows.md) and a complete runnable conversation at [`examples/guided-gas-order`](./examples/guided-gas-order) (`pnpm demo:guided-flow`).
+
 ## Agent Manifests + CLI
 
 Agents can be declared as YAML and run without writing code for the identity/model/instructions surface:
@@ -505,14 +571,36 @@ Recommended production wiring:
 - Use `pnpm harness` as the production readiness gate.
 - Use `pnpm smoke` and `pnpm pack:check` before publishing.
 
-## Is It Frontier?
+```md
+## Frontier-ready architecture
 
-Yes, this is now a frontier-style agent SDK architecture: native tool calling, structured streaming, durable storage adapters, policy/approvals, evals, telemetry, replay, workflows, routing, multi-agent coordination, vector memory, queue contracts, package smoke checks, and a production harness.
+Nexa Agent SDK is designed with a frontier-style agent architecture: native tool calling, structured streaming, durable storage adapters, policy and approvals, evals, telemetry, replay, workflows, routing, multi-agent coordination, vector memory, queue contracts, package smoke checks, and an extensible `ModelHarness` contract.
 
-The SDK intentionally stays dependency-light. Production apps still provide their actual infrastructure drivers and deployment policy through adapters.
+The SDK remains dependency-light. Production applications provide their own infrastructure drivers and deployment policies through adapters.
 
-## Open-core architecture
+## Extensible by design
 
-This package is designed as the fully-capable public half of an open-core split — see [docs/architecture/open-core-audit.md](./docs/architecture/open-core-audit.md), [open-core-target.md](./docs/architecture/open-core-target.md), and [open-core-migration.md](./docs/architecture/open-core-migration.md) for the module-by-module classification, target architecture, and phased plan. In short: everything in this repository is public and production-capable; strategic/proprietary intelligence (e.g. a future `FrontierHarness`) is designed to live in a separate private repository that *implements* this SDK's public contracts (`ModelHarness`, `ModelRoute`, `ContextEngineConfig`, ...) rather than forking or being vendored into it.
+Nexa is built around stable contracts instead of hardcoded orchestration strategies.
 
-`pnpm verify:boundaries`, `pnpm verify:secrets`, and `pnpm verify:publish-safety` (all folded into `pnpm prepublish:check`) guard against private code or secrets ever entering an npm-published tarball from this repo.
+Developers can extend or replace major runtime behaviors through interfaces for:
+
+- model harnesses
+- providers
+- tools
+- context
+- memory
+- storage
+- routing
+- telemetry
+- evals
+
+This makes it possible to build custom agent architectures without forking the core SDK.
+
+## Release safety
+
+The repository includes automated checks for package boundaries, accidental credential exposure, and npm tarball contents:
+
+```bash
+pnpm verify:boundaries
+pnpm verify:secrets
+pnpm verify:publish-safety

package/dist/file-storage.d.ts

@@ -4,6 +4,7 @@ import type { MemoryRecord } from "./memory.js";
 import type { NexaStorage } from "./storage.js";
 import type { AgentRunSnapshot } from "./types.js";
 import type { WorkflowRun } from "./workflow.js";
+import type { GuidedFlowRunState } from "./guided-flows/index.js";
 export declare class JsonFileStorage implements NexaStorage {
     private readonly rootDir;
     constructor(rootDir: string);
@@ -19,6 +20,8 @@ export declare class JsonFileStorage implements NexaStorage {
     listApprovals(status?: ApprovalRequest["status"]): Promise<ApprovalRequest[]>;
     saveWorkflow(run: WorkflowRun): Promise<void>;
     getWorkflow(id: string): Promise<WorkflowRun | undefined>;
+    saveFlowState(record: GuidedFlowRunState): Promise<void>;
+    getFlowState(sessionId: string, flowId: string): Promise<GuidedFlowRunState | undefined>;
     private path;
 }
 export declare function createJsonFileStorage(rootDir: string): JsonFileStorage;

package/dist/file-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-storage.d.ts","sourceRoot":"","sources":["../src/file-storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,qBAAa,eAAgB,YAAW,WAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAEtC,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAI5D,QAAQ,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIvC,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIrC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIvC,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAStD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAI7D,aAAa,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAK7E,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAI/D,OAAO,CAAC,IAAI;CAGb;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAEtE"}
+{"version":3,"file":"file-storage.d.ts","sourceRoot":"","sources":["../src/file-storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,qBAAa,eAAgB,YAAW,WAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAEtC,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAI5D,QAAQ,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIvC,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIrC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIvC,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAStD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAI7D,aAAa,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAK7E,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAIzD,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAI9F,OAAO,CAAC,IAAI;CAGb;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAEtE"}

package/dist/file-storage.js

@@ -63,6 +63,12 @@ export class JsonFileStorage {
     async getWorkflow(id) {
         return readJson(this.path("workflows", `${id}.json`));
     }
+    async saveFlowState(record) {
+        await writeJson(this.path("guided-flows", flowStateFileName(record.sessionId, record.flowId)), record);
+    }
+    async getFlowState(sessionId, flowId) {
+        return readJson(this.path("guided-flows", flowStateFileName(sessionId, flowId)));
+    }
     path(...parts) {
         return join(this.rootDir, ...parts);
     }
@@ -97,4 +103,7 @@ async function readJsonArray(path) {
 function isMissingFile(error) {
     return Boolean(error && typeof error === "object" && "code" in error && error.code === "ENOENT");
 }
+function flowStateFileName(sessionId, flowId) {
+    return `${encodeURIComponent(sessionId)}__${encodeURIComponent(flowId)}.json`;
+}
 //# sourceMappingURL=file-storage.js.map

package/dist/file-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-storage.js","sourceRoot":"","sources":["../src/file-storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"file-storage.js","sourceRoot":"","sources":["../src/file-storage.ts"],"names":[],"mappings":"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"}

package/dist/guided-flows/define-flow.d.ts

@@ -0,0 +1,4 @@
+import type { z } from "zod";
+import type { GuidedFlow, GuidedFlowConfig } from "./types.js";
+export declare function defineFlow<TStateSchema extends z.AnyZodObject, TOutputSchema extends z.ZodTypeAny>(config: GuidedFlowConfig<TStateSchema, TOutputSchema>): GuidedFlow<TStateSchema, TOutputSchema>;
+//# sourceMappingURL=define-flow.d.ts.map

package/dist/guided-flows/define-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-flow.d.ts","sourceRoot":"","sources":["../../src/guided-flows/define-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE/D,wBAAgB,UAAU,CAAC,YAAY,SAAS,CAAC,CAAC,YAAY,EAAE,aAAa,SAAS,CAAC,CAAC,UAAU,EAChG,MAAM,EAAE,gBAAgB,CAAC,YAAY,EAAE,aAAa,CAAC,GACpD,UAAU,CAAC,YAAY,EAAE,aAAa,CAAC,CAkCzC"}

package/dist/guided-flows/define-flow.js

@@ -0,0 +1,34 @@
+import { GuidedFlowConfigError } from "./errors.js";
+export function defineFlow(config) {
+    if (!config.id)
+        throw new GuidedFlowConfigError("defineFlow: `id` is required.");
+    if (!Number.isInteger(config.version) || config.version < 1) {
+        throw new GuidedFlowConfigError(`defineFlow(${config.id}): \`version\` must be a positive integer.`);
+    }
+    const stepIds = new Set();
+    for (const step of config.steps) {
+        if (stepIds.has(step.id))
+            throw new GuidedFlowConfigError(`defineFlow(${config.id}): duplicate step id "${step.id}".`);
+        stepIds.add(step.id);
+    }
+    const requirementIds = new Set();
+    for (const requirement of config.requirements) {
+        if (requirementIds.has(requirement.id)) {
+            throw new GuidedFlowConfigError(`defineFlow(${config.id}): duplicate requirement id "${requirement.id}".`);
+        }
+        requirementIds.add(requirement.id);
+    }
+    if (config.confirmation) {
+        const field = config.confirmation.stateField;
+        const shapeKeys = Object.keys(config.stateSchema.shape);
+        if (!shapeKeys.includes(String(field))) {
+            throw new GuidedFlowConfigError(`defineFlow(${config.id}): confirmation.stateField "${String(field)}" is not part of stateSchema.`);
+        }
+    }
+    const partialCheck = config.stateSchema.partial().safeParse(config.initialState);
+    if (!partialCheck.success) {
+        throw new GuidedFlowConfigError(`defineFlow(${config.id}): \`initialState\` does not match \`stateSchema\`: ${partialCheck.error.message}`);
+    }
+    return Object.freeze({ config, id: config.id, version: config.version });
+}
+//# sourceMappingURL=define-flow.js.map

package/dist/guided-flows/define-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-flow.js","sourceRoot":"","sources":["../../src/guided-flows/define-flow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpD,MAAM,UAAU,UAAU,CACxB,MAAqD;IAErD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,IAAI,qBAAqB,CAAC,+BAA+B,CAAC,CAAC;IACjF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,qBAAqB,CAAC,cAAc,MAAM,CAAC,EAAE,4CAA4C,CAAC,CAAC;IACvG,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,qBAAqB,CAAC,cAAc,MAAM,CAAC,EAAE,yBAAyB,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACvH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAC9C,IAAI,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,qBAAqB,CAAC,cAAc,MAAM,CAAC,EAAE,gCAAgC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;QAC7G,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC;QAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,qBAAqB,CAAC,cAAc,MAAM,CAAC,EAAE,+BAA+B,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACtI,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACjF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,qBAAqB,CAAC,cAAc,MAAM,CAAC,EAAE,uDAAuD,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9I,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/guided-flows/errors.d.ts

@@ -0,0 +1,11 @@
+export declare class GuidedFlowConfigError extends Error {
+    constructor(message: string);
+}
+export declare class GuidedFlowOutputValidationError extends Error {
+    readonly flowId: string;
+    constructor(message: string, input: {
+        flowId: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/guided-flows/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/guided-flows/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKxE"}

package/dist/guided-flows/errors.js

@@ -0,0 +1,15 @@
+export class GuidedFlowConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GuidedFlowConfigError";
+    }
+}
+export class GuidedFlowOutputValidationError extends Error {
+    flowId;
+    constructor(message, input) {
+        super(message, input.cause !== undefined ? { cause: input.cause } : undefined);
+        this.name = "GuidedFlowOutputValidationError";
+        this.flowId = input.flowId;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/guided-flows/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/guided-flows/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IAC/C,MAAM,CAAS;IAExB,YAAY,OAAe,EAAE,KAA0C;QACrE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC/E,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;CACF"}

package/dist/guided-flows/events.d.ts

@@ -0,0 +1,20 @@
+import type { EventBus } from "../event-bus.js";
+import type { JsonObject } from "../types.js";
+export type FlowEventType = "flow.started" | "flow.resumed" | "flow.step.entered" | "flow.step.exited" | "flow.state.updated" | "flow.requirement.satisfied" | "flow.requirement.invalidated" | "flow.tool.requested" | "flow.tool.completed" | "flow.validation.failed" | "flow.waiting_for_user" | "flow.waiting_for_approval" | "flow.completed" | "flow.cancelled" | "flow.failed";
+/** Input to {@link publishFlowEvent}. */
+export type PublishFlowEventInput = {
+    type: FlowEventType;
+    flowId: string;
+    sessionId: string;
+    stepId?: string;
+    taskId?: string;
+    runId?: string;
+    payload?: JsonObject;
+};
+/**
+ * Publishes onto the agent's existing `EventBus` (`underlying.sdk.events`),
+ * which is already wired to `telemetry` and to storage's `EventJournal` when
+ * present — no parallel event system.
+ */
+export declare function publishFlowEvent(events: EventBus, input: PublishFlowEventInput): Promise<void>;
+//# sourceMappingURL=events.d.ts.map

package/dist/guided-flows/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/guided-flows/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,cAAc,GACd,mBAAmB,GACnB,kBAAkB,GAClB,oBAAoB,GACpB,4BAA4B,GAC5B,8BAA8B,GAC9B,qBAAqB,GACrB,qBAAqB,GACrB,wBAAwB,GACxB,uBAAuB,GACvB,2BAA2B,GAC3B,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,CAAC;AAElB,yCAAyC;AACzC,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUpG"}

package/dist/guided-flows/events.js

@@ -0,0 +1,17 @@
+/**
+ * Publishes onto the agent's existing `EventBus` (`underlying.sdk.events`),
+ * which is already wired to `telemetry` and to storage's `EventJournal` when
+ * present — no parallel event system.
+ */
+export async function publishFlowEvent(events, input) {
+    await events.publish({
+        type: input.type,
+        source: "guided-flow",
+        ...(input.taskId ? { taskId: input.taskId } : {}),
+        ...(input.runId ? { runId: input.runId } : {}),
+        ...(input.stepId ? { stepId: input.stepId } : {}),
+        visibility: input.type.includes("tool") ? "technical" : "user",
+        payload: { flowId: input.flowId, sessionId: input.sessionId, ...(input.payload ?? {}) }
+    });
+}
+//# sourceMappingURL=events.js.map

package/dist/guided-flows/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/guided-flows/events.ts"],"names":[],"mappings":"AA+BA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAgB,EAAE,KAA4B;IACnF,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,aAAa;QACrB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;QAC9D,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE;KACxF,CAAC,CAAC;AACL,CAAC"}

package/dist/guided-flows/index.d.ts

@@ -0,0 +1,10 @@
+export { defineFlow } from "./define-flow.js";
+export type { EvaluatedRequirement, FlowPatchSource, FlowStatePatch, GuidedFlow, GuidedFlowConfig, GuidedFlowConfirmation, GuidedFlowManifestDescriptor, GuidedFlowRequirement, GuidedFlowRunMeta, GuidedFlowRunResult, GuidedFlowRunState, GuidedFlowStatus, GuidedFlowStep, GuidedFlowToolConfig, GuidedFlowTriggers, StepToolPolicy, ToolResultBinding } from "./types.js";
+export { GuidedFlowConfigError, GuidedFlowOutputValidationError } from "./errors.js";
+export { GuidedFlowRuntime } from "./runtime.js";
+export type { GuidedFlowRuntimeOptions, GuidedFlowTurnInput, GuidedFlowTurnOutcome } from "./runtime.js";
+export { createInMemoryGuidedFlowStateStore, hasGuidedFlowStateStore, InMemoryGuidedFlowStateStore, resolveGuidedFlowStateStore } from "./persistence.js";
+export type { GuidedFlowStateStore } from "./persistence.js";
+export { publishFlowEvent } from "./events.js";
+export type { FlowEventType, PublishFlowEventInput } from "./events.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/guided-flows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guided-flows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACzG,OAAO,EACL,kCAAkC,EAClC,uBAAuB,EACvB,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/guided-flows/index.js

@@ -0,0 +1,6 @@
+export { defineFlow } from "./define-flow.js";
+export { GuidedFlowConfigError, GuidedFlowOutputValidationError } from "./errors.js";
+export { GuidedFlowRuntime } from "./runtime.js";
+export { createInMemoryGuidedFlowStateStore, hasGuidedFlowStateStore, InMemoryGuidedFlowStateStore, resolveGuidedFlowStateStore } from "./persistence.js";
+export { publishFlowEvent } from "./events.js";
+//# sourceMappingURL=index.js.map

package/dist/guided-flows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guided-flows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAoB9C,OAAO,EAAE,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EACL,kCAAkC,EAClC,uBAAuB,EACvB,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/guided-flows/persistence.d.ts

@@ -0,0 +1,32 @@
+import type { GuidedFlowRunState } from "./types.js";
+/**
+ * Narrow, domain-specific storage contract — mirrors `workflow.ts`'s
+ * `WorkflowCheckpointStore` precedent instead of growing `NexaStorage` in
+ * `storage.ts`. A caller's `NexaStorage` (or any object) works automatically
+ * as soon as it implements these two methods (duck-typed, see
+ * `hasGuidedFlowStateStore` below) — `file-storage.ts`, `sqlite-storage.ts`,
+ * `postgres-storage.ts` and `redis-storage.ts` all implement it.
+ */
+export type GuidedFlowStateStore = {
+    saveFlowState(record: GuidedFlowRunState): Promise<void> | void;
+    getFlowState(sessionId: string, flowId: string): Promise<GuidedFlowRunState | undefined> | GuidedFlowRunState | undefined;
+    listFlowStates?(sessionId: string): Promise<GuidedFlowRunState[]> | GuidedFlowRunState[];
+    deleteFlowState?(sessionId: string, flowId: string): Promise<void> | void;
+};
+export declare class InMemoryGuidedFlowStateStore implements GuidedFlowStateStore {
+    private readonly records;
+    saveFlowState(record: GuidedFlowRunState): void;
+    getFlowState(sessionId: string, flowId: string): GuidedFlowRunState | undefined;
+    listFlowStates(sessionId: string): GuidedFlowRunState[];
+    deleteFlowState(sessionId: string, flowId: string): void;
+}
+export declare function createInMemoryGuidedFlowStateStore(): InMemoryGuidedFlowStateStore;
+export declare function hasGuidedFlowStateStore(value: unknown): value is GuidedFlowStateStore;
+/**
+ * Resolves the effective store for an agent: prefers a store duck-typed off
+ * `config.storage` (so durable storage "just works" once configured), and
+ * otherwise falls back to a private in-memory store — Guided Flows always
+ * work with zero storage configuration.
+ */
+export declare function resolveGuidedFlowStateStore(storage: unknown): GuidedFlowStateStore;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/guided-flows/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/guided-flows/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChE,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAC1H,cAAc,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC;IACzF,eAAe,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3E,CAAC;AAEF,qBAAa,4BAA6B,YAAW,oBAAoB;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAEjE,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAI/C,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAK/E,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAIvD,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAGzD;AAED,wBAAgB,kCAAkC,IAAI,4BAA4B,CAEjF;AAMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAErF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAGlF"}

package/dist/guided-flows/persistence.js

@@ -0,0 +1,37 @@
+export class InMemoryGuidedFlowStateStore {
+    records = new Map();
+    saveFlowState(record) {
+        this.records.set(recordKey(record.sessionId, record.flowId), structuredClone(record));
+    }
+    getFlowState(sessionId, flowId) {
+        const record = this.records.get(recordKey(sessionId, flowId));
+        return record ? structuredClone(record) : undefined;
+    }
+    listFlowStates(sessionId) {
+        return [...this.records.values()].filter((record) => record.sessionId === sessionId).map((record) => structuredClone(record));
+    }
+    deleteFlowState(sessionId, flowId) {
+        this.records.delete(recordKey(sessionId, flowId));
+    }
+}
+export function createInMemoryGuidedFlowStateStore() {
+    return new InMemoryGuidedFlowStateStore();
+}
+function recordKey(sessionId, flowId) {
+    return `${sessionId}::${flowId}`;
+}
+export function hasGuidedFlowStateStore(value) {
+    return Boolean(value && typeof value === "object" && "saveFlowState" in value && "getFlowState" in value);
+}
+/**
+ * Resolves the effective store for an agent: prefers a store duck-typed off
+ * `config.storage` (so durable storage "just works" once configured), and
+ * otherwise falls back to a private in-memory store — Guided Flows always
+ * work with zero storage configuration.
+ */
+export function resolveGuidedFlowStateStore(storage) {
+    if (hasGuidedFlowStateStore(storage))
+        return storage;
+    return createInMemoryGuidedFlowStateStore();
+}
+//# sourceMappingURL=persistence.js.map

package/dist/guided-flows/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../src/guided-flows/persistence.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,4BAA4B;IACtB,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEjE,aAAa,CAAC,MAA0B;QACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,YAAY,CAAC,SAAiB,EAAE,MAAc;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,CAAC;IAED,cAAc,CAAC,SAAiB;QAC9B,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAChI,CAAC;IAED,eAAe,CAAC,SAAiB,EAAE,MAAc;QAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,UAAU,kCAAkC;IAChD,OAAO,IAAI,4BAA4B,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,SAAS,CAAC,SAAiB,EAAE,MAAc;IAClD,OAAO,GAAG,SAAS,KAAK,MAAM,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,eAAe,IAAI,KAAK,IAAI,cAAc,IAAI,KAAK,CAAC,CAAC;AAC5G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAgB;IAC1D,IAAI,uBAAuB,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACrD,OAAO,kCAAkC,EAAE,CAAC;AAC9C,CAAC"}

package/dist/guided-flows/requirements.d.ts

@@ -0,0 +1,8 @@
+import type { z } from "zod";
+import type { EvaluatedRequirement, GuidedFlowConfig } from "./types.js";
+export declare function evaluateRequirements<TStateSchema extends z.AnyZodObject, TOutputSchema extends z.ZodTypeAny>(config: GuidedFlowConfig<TStateSchema, TOutputSchema>, state: z.infer<TStateSchema>): EvaluatedRequirement[];
+export declare function diffRequirements(previous: EvaluatedRequirement[], next: EvaluatedRequirement[]): {
+    newlySatisfied: string[];
+    newlyInvalidated: string[];
+};
+//# sourceMappingURL=requirements.d.ts.map

package/dist/guided-flows/requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/guided-flows/requirements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzE,wBAAgB,oBAAoB,CAAC,YAAY,SAAS,CAAC,CAAC,YAAY,EAAE,aAAa,SAAS,CAAC,CAAC,UAAU,EAC1G,MAAM,EAAE,gBAAgB,CAAC,YAAY,EAAE,aAAa,CAAC,EACrD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,GAC3B,oBAAoB,EAAE,CAMxB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,GAAG;IAChG,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAUA"}

package/dist/guided-flows/requirements.js

@@ -0,0 +1,21 @@
+export function evaluateRequirements(config, state) {
+    return config.requirements.map((requirement) => ({
+        id: requirement.id,
+        description: requirement.description,
+        satisfied: Boolean(requirement.satisfied({ state }))
+    }));
+}
+export function diffRequirements(previous, next) {
+    const previousById = new Map(previous.map((requirement) => [requirement.id, requirement.satisfied]));
+    const newlySatisfied = [];
+    const newlyInvalidated = [];
+    for (const requirement of next) {
+        const before = previousById.get(requirement.id);
+        if (requirement.satisfied && before !== true)
+            newlySatisfied.push(requirement.id);
+        if (!requirement.satisfied && before === true)
+            newlyInvalidated.push(requirement.id);
+    }
+    return { newlySatisfied, newlyInvalidated };
+}
+//# sourceMappingURL=requirements.js.map

package/dist/guided-flows/requirements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.js","sourceRoot":"","sources":["../../src/guided-flows/requirements.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,oBAAoB,CAClC,MAAqD,EACrD,KAA4B;IAE5B,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC/C,EAAE,EAAE,WAAW,CAAC,EAAE;QAClB,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;KACrD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgC,EAAE,IAA4B;IAI7F,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACrG,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,gBAAgB,GAAa,EAAE,CAAC;IACtC,KAAK,MAAM,WAAW,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAChD,IAAI,WAAW,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;YAAE,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,WAAW,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;YAAE,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;AAC9C,CAAC"}

package/dist/guided-flows/runtime.d.ts

@@ -0,0 +1,74 @@
+import type { ChatMessage, OpenAICompatibleChatClient } from "../openai-compatible.js";
+import type { AgentToolRegistration } from "../openai-agent.js";
+import type { ModelHarness } from "../model-harness.js";
+import type { HookDispatcher } from "../hooks.js";
+import type { EventBus } from "../event-bus.js";
+import type { SkillDefinition } from "../skills.js";
+import { type TenantContext } from "../tenancy.js";
+import type { JsonObject } from "../types.js";
+import type { GuidedFlowStateStore } from "./persistence.js";
+import type { FlowStatePatch, GuidedFlow, GuidedFlowRunMeta, GuidedFlowRunState } from "./types.js";
+export type GuidedFlowRuntimeOptions = {
+    flows: GuidedFlow<any, any>[];
+    client: OpenAICompatibleChatClient;
+    providerId: string;
+    model: string;
+    toolRegistrations: AgentToolRegistration[];
+    skills: SkillDefinition[];
+    hooks: HookDispatcher;
+    events: EventBus;
+    harness?: ModelHarness;
+    store: GuidedFlowStateStore;
+    flowSelector?: (input: {
+        text: string;
+        flows: GuidedFlow<any, any>[];
+    }) => string | undefined | Promise<string | undefined>;
+};
+export type GuidedFlowTurnInput = {
+    text: string;
+    messages: ChatMessage[];
+    sessionId: string;
+    tenant?: TenantContext;
+    explicitFlow?: string;
+};
+export type GuidedFlowTurnOutcome = {
+    handled: false;
+} | {
+    handled: true;
+    text: string;
+    output?: unknown;
+    state: JsonObject;
+    flow: GuidedFlowRunMeta;
+};
+/**
+ * Drives Guided Flow turns. Constructed once per agent (by `kernel.ts` when
+ * `config.flows?.length`) and never streamed — `runStream()` in
+ * `openai-agent.ts` is untouched; internally this still uses the same
+ * `runNativeToolLoop`/`ModelHarness` contracts, just called directly rather
+ * than through `agent.run()`'s normal path.
+ */
+export declare class GuidedFlowRuntime {
+    private readonly options;
+    constructor(options: GuidedFlowRuntimeOptions);
+    private flowById;
+    private requireFlow;
+    private soleFlow;
+    private key;
+    selectFlow(input: {
+        text: string;
+        sessionId: string;
+        tenant?: TenantContext;
+        explicitFlow?: string;
+    }): Promise<GuidedFlow | undefined>;
+    runTurn(input: GuidedFlowTurnInput): Promise<GuidedFlowTurnOutcome>;
+    private driveFlow;
+    private applyPatch;
+    private announceStepChange;
+    private forwardNativeEvent;
+    cancel(sessionId: string, flowId?: string, tenant?: TenantContext): Promise<void>;
+    resume(sessionId: string, flowId?: string, tenant?: TenantContext): Promise<GuidedFlowRunState | undefined>;
+    reset(sessionId: string, flowId?: string, tenant?: TenantContext): Promise<void>;
+    patchState(sessionId: string, flowId: string, patch: FlowStatePatch<Record<string, unknown>>, tenant?: TenantContext): Promise<GuidedFlowRunState>;
+    getState(sessionId: string, flowId?: string, tenant?: TenantContext): Promise<GuidedFlowRunState | undefined>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/guided-flows/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/guided-flows/runtime.ts"],"names":[],"mappings":"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"}