@nexalab/agent-sdk 0.1.0 → 0.1.6

package/dist/guided-flows/runtime.js

@@ -0,0 +1,423 @@
+import { randomUUID } from "node:crypto";
+import { runNativeToolLoop } from "../native-tool-loop.js";
+import { namespaceKey } from "../tenancy.js";
+import { parseStructuredOutput, structuredOutputInstruction } from "../structured-output.js";
+import { GuidedFlowOutputValidationError } from "./errors.js";
+import { applyConfirmationReset, applyStatePatch, buildModelPatchSchema } from "./state.js";
+import { diffRequirements, evaluateRequirements } from "./requirements.js";
+import { missingCollectFields, resolveActiveStep } from "./steps.js";
+import { missingRequiredBeforeExitTools, missingRequiredTools, resolveStepTools } from "./tool-policy.js";
+import { publishFlowEvent } from "./events.js";
+const ONGOING_STATUSES = ["active", "waiting_for_user", "waiting_for_tool", "waiting_for_approval"];
+function isOngoing(status) {
+    return ONGOING_STATUSES.includes(status);
+}
+/**
+ * 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 class GuidedFlowRuntime {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    flowById(id) {
+        return this.options.flows.find((flow) => flow.id === id);
+    }
+    requireFlow(id) {
+        const flow = this.flowById(id);
+        if (!flow)
+            throw new Error(`GuidedFlowRuntime: unknown flow id "${id}".`);
+        return flow;
+    }
+    soleFlow() {
+        if (this.options.flows.length !== 1) {
+            throw new Error("GuidedFlowRuntime: a flowId must be specified when an agent has more than one flow.");
+        }
+        return this.options.flows[0];
+    }
+    key(tenant, sessionId) {
+        return tenant && (tenant.tenantId || tenant.userId) ? namespaceKey(tenant, sessionId) : sessionId;
+    }
+    async selectFlow(input) {
+        const key = this.key(input.tenant, input.sessionId);
+        for (const flow of this.options.flows) {
+            const existing = await this.options.store.getFlowState(key, flow.id);
+            if (existing && isOngoing(existing.status))
+                return flow;
+        }
+        if (input.explicitFlow)
+            return this.flowById(input.explicitFlow);
+        if (this.options.flowSelector) {
+            const id = await this.options.flowSelector({ text: input.text, flows: this.options.flows });
+            if (id)
+                return this.flowById(id);
+        }
+        if (this.options.flows.length === 1)
+            return this.options.flows[0];
+        const lowered = input.text.toLowerCase();
+        for (const flow of this.options.flows) {
+            const triggers = flow.config.triggers;
+            if (!triggers)
+                continue;
+            const phrases = [...(triggers.examples ?? []), ...(triggers.intents ?? [])];
+            if (phrases.some((phrase) => lowered.includes(phrase.toLowerCase())))
+                return flow;
+        }
+        return undefined;
+    }
+    async runTurn(input) {
+        const flow = await this.selectFlow(input);
+        if (!flow)
+            return { handled: false };
+        const driven = await this.driveFlow(flow, input);
+        return { handled: true, ...driven };
+    }
+    async driveFlow(flow, input) {
+        const config = flow.config;
+        const key = this.key(input.tenant, input.sessionId);
+        const taskId = randomUUID();
+        const runId = randomUUID();
+        const now = () => new Date().toISOString();
+        const existing = await this.options.store.getFlowState(key, flow.id);
+        let record = existing ?? {
+            flowId: flow.id,
+            flowVersion: flow.version,
+            sessionId: key,
+            status: "active",
+            state: { ...config.initialState },
+            completedRequirementIds: [],
+            missingRequirementIds: [],
+            stepToolLog: {},
+            startedAt: now(),
+            updatedAt: now()
+        };
+        if (!existing) {
+            await this.options.hooks.fire("beforeFlowStart", { flowId: flow.id, sessionId: key, context: { taskId, runId } });
+            await publishFlowEvent(this.options.events, { type: "flow.started", flowId: flow.id, sessionId: key, taskId, runId, payload: { state: record.state } });
+            await this.options.hooks.fire("afterFlowStart", { flowId: flow.id, sessionId: key, context: { taskId, runId } });
+        }
+        else if (existing.status === "cancelled") {
+            record = { ...existing, status: "active" };
+            await publishFlowEvent(this.options.events, { type: "flow.resumed", flowId: flow.id, sessionId: key, taskId, runId, payload: { state: record.state } });
+        }
+        let state = record.state;
+        const previousStepId = record.currentStepId;
+        const stepToolLog = { ...record.stepToolLog };
+        let requirements = evaluateRequirements(config, state);
+        let step = resolveActiveStep(config, state);
+        await this.announceStepChange(flow, key, previousStepId, step?.id, taskId, runId);
+        // --- Extraction sub-call: pull a Zod-validated partial state patch out of free text ---
+        const modelPatchSchema = buildModelPatchSchema(config.stateSchema, config.protectedFields);
+        let modelPatch = {};
+        try {
+            const extraction = await this.options.client.complete({
+                providerId: this.options.providerId,
+                model: this.options.model,
+                messages: [
+                    {
+                        role: "system",
+                        content: `${buildGuidedInstructions(config, step, state, this.options.skills)}\n\n${structuredOutputInstruction(modelPatchSchema, "StatePatch")}\nOnly include fields the user explicitly provided in their latest message. Omit fields that are unknown, already known, or not mentioned.`
+                    },
+                    ...input.messages,
+                    { role: "user", content: input.text }
+                ]
+            });
+            const parsed = parseStructuredOutput(modelPatchSchema, extraction.text);
+            if (parsed.ok)
+                modelPatch = parsed.data;
+            else {
+                await publishFlowEvent(this.options.events, {
+                    type: "flow.validation.failed",
+                    flowId: flow.id,
+                    sessionId: key,
+                    taskId,
+                    runId,
+                    payload: { stage: "extraction", reason: parsed.error }
+                });
+            }
+        }
+        catch (error) {
+            await publishFlowEvent(this.options.events, {
+                type: "flow.validation.failed",
+                flowId: flow.id,
+                sessionId: key,
+                taskId,
+                runId,
+                payload: { stage: "extraction", reason: error instanceof Error ? error.message : String(error) }
+            });
+        }
+        ({ state, requirements, step } = await this.applyPatch(flow, key, taskId, runId, config, state, { set: modelPatch, source: "model" }, requirements));
+        // --- Tool-scoped reply pass: never offers tools beyond the active step's policy ---
+        const effectiveTools = resolveStepTools(this.options.toolRegistrations, step?.tools);
+        const maxRounds = 6;
+        const loopInput = {
+            client: this.options.client,
+            providerId: this.options.providerId,
+            model: this.options.model,
+            messages: [
+                { role: "system", content: buildGuidedInstructions(config, step, state, this.options.skills) },
+                ...input.messages,
+                { role: "user", content: input.text }
+            ],
+            tools: effectiveTools,
+            taskId,
+            runId,
+            maxRounds,
+            onEvent: (event) => this.forwardNativeEvent(flow, key, taskId, runId, event)
+        };
+        const native = this.options.harness ? await this.options.harness.run(loopInput) : await runNativeToolLoop(loopInput);
+        const activeStepId = step?.id;
+        if (activeStepId)
+            stepToolLog[activeStepId] = stepToolLog[activeStepId] ?? [];
+        let pendingApproval = false;
+        for (const toolResult of native.toolResults) {
+            if (toolResult.result.status === "pending_approval")
+                pendingApproval = true;
+            if (toolResult.result.status === "ok" && activeStepId) {
+                stepToolLog[activeStepId] = [...(stepToolLog[activeStepId] ?? []), toolResult.tool.id];
+            }
+            const binding = config.tools?.bindings?.[toolResult.tool.id];
+            if (binding) {
+                const patch = binding.applyResult({ result: toolResult.result, state });
+                if (patch) {
+                    ({ state, requirements, step } = await this.applyPatch(flow, key, taskId, runId, config, state, patch, requirements));
+                }
+            }
+        }
+        // Don't let the resolved step silently skip past one whose requiredBeforeExit tools haven't run yet.
+        let finalStep = resolveActiveStep(config, state);
+        if (activeStepId && finalStep?.id !== activeStepId) {
+            const previousStepDef = config.steps.find((candidate) => candidate.id === activeStepId);
+            const stillMissing = missingRequiredBeforeExitTools(previousStepDef?.tools, stepToolLog[activeStepId] ?? []);
+            if (stillMissing.length)
+                finalStep = previousStepDef;
+        }
+        step = finalStep;
+        await this.announceStepChange(flow, key, activeStepId, step?.id, taskId, runId);
+        requirements = evaluateRequirements(config, state);
+        const missingRequirementIds = requirements.filter((requirement) => !requirement.satisfied).map((requirement) => requirement.id);
+        const completedRequirementIds = requirements.filter((requirement) => requirement.satisfied).map((requirement) => requirement.id);
+        const stepRequiredMissing = missingRequiredTools(step?.tools, activeStepId ? stepToolLog[activeStepId] ?? [] : []);
+        const isComplete = requirements.every((requirement) => requirement.satisfied) && stepRequiredMissing.length === 0 && config.completion({ state, requirements });
+        let output;
+        let status;
+        let completedAt = record.completedAt;
+        if (isComplete) {
+            await this.options.hooks.fire("beforeFlowComplete", { flowId: flow.id, sessionId: key, state, context: { taskId, runId } });
+            const mapped = config.mapOutput({ state });
+            const validated = config.outputSchema.safeParse(mapped);
+            if (!validated.success) {
+                await publishFlowEvent(this.options.events, {
+                    type: "flow.validation.failed",
+                    flowId: flow.id,
+                    sessionId: key,
+                    taskId,
+                    runId,
+                    payload: { stage: "output", reason: validated.error.message }
+                });
+                await this.options.hooks.fire("onFlowError", { flowId: flow.id, sessionId: key, error: validated.error, context: { taskId, runId } });
+                throw new GuidedFlowOutputValidationError(`Guided flow "${flow.id}" satisfied completion() but mapOutput() failed outputSchema validation: ${validated.error.message}`, { flowId: flow.id, cause: validated.error });
+            }
+            output = validated.data;
+            status = "completed";
+            completedAt = now();
+            await this.options.hooks.fire("afterFlowComplete", { flowId: flow.id, sessionId: key, output, context: { taskId, runId } });
+            await publishFlowEvent(this.options.events, { type: "flow.completed", flowId: flow.id, sessionId: key, taskId, runId, payload: { output: output } });
+        }
+        else if (pendingApproval) {
+            status = "waiting_for_approval";
+            await publishFlowEvent(this.options.events, { type: "flow.waiting_for_approval", flowId: flow.id, sessionId: key, taskId, runId, payload: {} });
+        }
+        else if (native.rounds >= maxRounds && native.toolCalls.length > 0) {
+            status = "waiting_for_tool";
+        }
+        else {
+            status = "waiting_for_user";
+            await publishFlowEvent(this.options.events, { type: "flow.waiting_for_user", flowId: flow.id, sessionId: key, taskId, runId, payload: {} });
+        }
+        const updated = {
+            flowId: flow.id,
+            flowVersion: flow.version,
+            sessionId: key,
+            status,
+            ...(step ? { currentStepId: step.id } : {}),
+            state: state,
+            completedRequirementIds,
+            missingRequirementIds,
+            stepToolLog,
+            ...(record.startedAt ? { startedAt: record.startedAt } : {}),
+            updatedAt: now(),
+            ...(completedAt ? { completedAt } : {}),
+            ...(output !== undefined ? { output: output } : {})
+        };
+        await this.options.store.saveFlowState(updated);
+        return {
+            text: native.text,
+            ...(output !== undefined ? { output } : {}),
+            state: state,
+            flow: {
+                id: flow.id,
+                version: flow.version,
+                status,
+                ...(step ? { currentStepId: step.id } : {}),
+                completedRequirementIds,
+                missingRequirementIds,
+                ...(updated.startedAt ? { startedAt: updated.startedAt } : {}),
+                updatedAt: updated.updatedAt,
+                ...(completedAt ? { completedAt } : {})
+            }
+        };
+    }
+    async applyPatch(flow, key, taskId, runId, config, state, patch, previousRequirements) {
+        await this.options.hooks.fire("beforeFlowStatePatch", { flowId: flow.id, sessionId: key, patch, context: { taskId, runId } });
+        const applied = applyStatePatch(config, state, patch);
+        const confirmationResult = applyConfirmationReset(config, applied.state, applied.changedKeys);
+        const nextState = confirmationResult.state;
+        const changedKeys = confirmationResult.reset && config.confirmation ? [...applied.changedKeys, String(config.confirmation.stateField)] : applied.changedKeys;
+        if (changedKeys.length) {
+            await publishFlowEvent(this.options.events, {
+                type: "flow.state.updated",
+                flowId: flow.id,
+                sessionId: key,
+                taskId,
+                runId,
+                payload: { changedKeys, source: patch.source }
+            });
+        }
+        await this.options.hooks.fire("afterFlowStatePatch", { flowId: flow.id, sessionId: key, state: nextState, context: { taskId, runId } });
+        const requirements = evaluateRequirements(config, nextState);
+        const diff = diffRequirements(previousRequirements, requirements);
+        for (const id of diff.newlySatisfied) {
+            await publishFlowEvent(this.options.events, { type: "flow.requirement.satisfied", flowId: flow.id, sessionId: key, taskId, runId, payload: { requirementId: id } });
+        }
+        for (const id of diff.newlyInvalidated) {
+            await publishFlowEvent(this.options.events, { type: "flow.requirement.invalidated", flowId: flow.id, sessionId: key, taskId, runId, payload: { requirementId: id } });
+        }
+        return { state: nextState, requirements, step: resolveActiveStep(config, nextState) };
+    }
+    async announceStepChange(flow, key, previousStepId, nextStepId, taskId, runId) {
+        if (previousStepId === nextStepId)
+            return;
+        if (previousStepId) {
+            await this.options.hooks.fire("afterFlowStep", { flowId: flow.id, sessionId: key, stepId: previousStepId, context: { taskId, runId } });
+            await publishFlowEvent(this.options.events, { type: "flow.step.exited", flowId: flow.id, sessionId: key, stepId: previousStepId, taskId, runId, payload: {} });
+        }
+        if (nextStepId) {
+            await this.options.hooks.fire("beforeFlowStep", { flowId: flow.id, sessionId: key, stepId: nextStepId, context: { taskId, runId } });
+            await publishFlowEvent(this.options.events, { type: "flow.step.entered", flowId: flow.id, sessionId: key, stepId: nextStepId, taskId, runId, payload: {} });
+        }
+    }
+    forwardNativeEvent(flow, key, taskId, runId, event) {
+        if (event.type === "native.tool.started") {
+            void publishFlowEvent(this.options.events, { type: "flow.tool.requested", flowId: flow.id, sessionId: key, taskId, runId, payload: { toolId: event.toolId } });
+        }
+        if (event.type === "native.tool.completed") {
+            void publishFlowEvent(this.options.events, {
+                type: "flow.tool.completed",
+                flowId: flow.id,
+                sessionId: key,
+                taskId,
+                runId,
+                payload: { toolId: event.toolId, status: event.result.status }
+            });
+        }
+    }
+    async cancel(sessionId, flowId, tenant) {
+        const flow = flowId ? this.requireFlow(flowId) : this.soleFlow();
+        const key = this.key(tenant, sessionId);
+        const record = await this.options.store.getFlowState(key, flow.id);
+        if (!record)
+            return;
+        const now = new Date().toISOString();
+        await this.options.store.saveFlowState({ ...record, status: "cancelled", cancelledAt: now, updatedAt: now });
+        await publishFlowEvent(this.options.events, { type: "flow.cancelled", flowId: flow.id, sessionId: key, payload: {} });
+    }
+    async resume(sessionId, flowId, tenant) {
+        const flow = flowId ? this.requireFlow(flowId) : this.soleFlow();
+        const key = this.key(tenant, sessionId);
+        const record = await this.options.store.getFlowState(key, flow.id);
+        if (!record)
+            return undefined;
+        const updated = { ...record, status: record.status === "completed" ? record.status : "active", updatedAt: new Date().toISOString() };
+        await this.options.store.saveFlowState(updated);
+        await publishFlowEvent(this.options.events, { type: "flow.resumed", flowId: flow.id, sessionId: key, payload: {} });
+        return updated;
+    }
+    async reset(sessionId, flowId, tenant) {
+        const flow = flowId ? this.requireFlow(flowId) : this.soleFlow();
+        const key = this.key(tenant, sessionId);
+        const now = new Date().toISOString();
+        await this.options.store.saveFlowState({
+            flowId: flow.id,
+            flowVersion: flow.version,
+            sessionId: key,
+            status: "idle",
+            state: { ...flow.config.initialState },
+            completedRequirementIds: [],
+            missingRequirementIds: [],
+            stepToolLog: {},
+            startedAt: now,
+            updatedAt: now
+        });
+    }
+    async patchState(sessionId, flowId, patch, tenant) {
+        const flow = this.requireFlow(flowId);
+        const config = flow.config;
+        const key = this.key(tenant, sessionId);
+        const now = new Date().toISOString();
+        const record = (await this.options.store.getFlowState(key, flow.id)) ?? {
+            flowId: flow.id,
+            flowVersion: flow.version,
+            sessionId: key,
+            status: "active",
+            state: { ...config.initialState },
+            completedRequirementIds: [],
+            missingRequirementIds: [],
+            stepToolLog: {},
+            startedAt: now,
+            updatedAt: now
+        };
+        const taskId = randomUUID();
+        const runId = randomUUID();
+        const requirements = evaluateRequirements(config, record.state);
+        const step = resolveActiveStep(config, record.state);
+        const applied = await this.applyPatch(flow, key, taskId, runId, config, record.state, { ...patch, source: "system" }, requirements);
+        const updated = {
+            ...record,
+            state: applied.state,
+            ...(applied.step ? { currentStepId: applied.step.id } : {}),
+            completedRequirementIds: applied.requirements.filter((requirement) => requirement.satisfied).map((requirement) => requirement.id),
+            missingRequirementIds: applied.requirements.filter((requirement) => !requirement.satisfied).map((requirement) => requirement.id),
+            updatedAt: new Date().toISOString()
+        };
+        await this.options.store.saveFlowState(updated);
+        return updated;
+    }
+    async getState(sessionId, flowId, tenant) {
+        const flow = flowId ? this.requireFlow(flowId) : this.soleFlow();
+        const key = this.key(tenant, sessionId);
+        return this.options.store.getFlowState(key, flow.id);
+    }
+}
+function buildGuidedInstructions(config, step, state, skills) {
+    const known = Object.entries(state)
+        .filter(([, value]) => value !== undefined && value !== null && value !== "")
+        .map(([key, value]) => `${key}: ${JSON.stringify(value)}`);
+    const missing = missingCollectFields(step, state);
+    const stepSkills = (step?.skills ?? [])
+        .map((id) => skills.find((skill) => skill.id === id))
+        .filter((skill) => Boolean(skill));
+    const lines = [
+        `You are guiding the user through the "${config.name}" flow. Goal: ${config.goal}`,
+        known.length ? `Known so far: ${known.join(", ")}.` : "Nothing is known about the user yet.",
+        missing.length ? `Still missing: ${missing.join(", ")}. Ask only for what's missing — never re-ask for known fields.` : "",
+        step?.instructions ? `Current step instructions: ${step.instructions}` : "",
+        ...stepSkills.map((skill) => `Skill "${skill.id}": ${skill.instructions}`)
+    ];
+    return lines.filter(Boolean).join("\n");
+}
+//# sourceMappingURL=runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/guided-flows/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,OAAO,EAAE,iBAAiB,EAAiF,MAAM,wBAAwB,CAAC;AAI1I,OAAO,EAAE,YAAY,EAAsB,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAG7F,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAuC/C,MAAM,gBAAgB,GAAuB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,sBAAsB,CAAC,CAAC;AAExH,SAAS,SAAS,CAAC,MAAwB;IACzC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAKD;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,OAAiC;QAAjC,YAAO,GAAP,OAAO,CAA0B;IAAG,CAAC;IAE1D,QAAQ,CAAC,EAAU;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAEO,WAAW,CAAC,EAAU;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,EAAE,IAAI,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,QAAQ;QACd,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,qFAAqF,CAAC,CAAC;QACzG,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAe,CAAC;IAC7C,CAAC;IAEO,GAAG,CAAC,MAAiC,EAAE,SAAiB;QAC9D,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpG,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAyF;QACxG,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAEpD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACrE,IAAI,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC1D,CAAC;QAED,IAAI,KAAK,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAEjE,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5F,IAAI,EAAE;gBAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAElE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACtC,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5E,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QACpF,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA0B;QACtC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,IAAgB,EAAE,KAA0B;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAmB,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,GAAW,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAEnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACrE,IAAI,MAAM,GAAuB,QAAQ,IAAI;YAC3C,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,EAAE,GAAI,MAAM,CAAC,YAA2B,EAAE;YACjD,uBAAuB,EAAE,EAAE;YAC3B,qBAAqB,EAAE,EAAE;YACzB,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,GAAG,EAAE;YAChB,SAAS,EAAE,GAAG,EAAE;SACjB,CAAC;QAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAClH,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACxJ,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACnH,CAAC;aAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3C,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC3C,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1J,CAAC;QAED,IAAI,KAAK,GAAa,MAAM,CAAC,KAAiB,CAAC;QAC/C,MAAM,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC;QAC5C,MAAM,WAAW,GAA6B,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAExE,IAAI,YAAY,GAAG,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvD,IAAI,IAAI,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC5C,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAElF,yFAAyF;QACzF,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3F,IAAI,UAAU,GAA4B,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;gBACpD,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;gBACnC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;gBACzB,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,GAAG,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,2BAA2B,CAAC,gBAAgB,EAAE,YAAY,CAAC,4IAA4I;qBAC5R;oBACD,GAAG,KAAK,CAAC,QAAQ;oBACjB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;iBACtC;aACF,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,qBAAqB,CAAC,gBAAgB,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YACxE,IAAI,MAAM,CAAC,EAAE;gBAAE,UAAU,GAAG,MAAM,CAAC,IAA+B,CAAC;iBAC9D,CAAC;gBACJ,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;oBAC1C,IAAI,EAAE,wBAAwB;oBAC9B,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,SAAS,EAAE,GAAG;oBACd,MAAM;oBACN,KAAK;oBACL,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE;iBACvD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;gBAC1C,IAAI,EAAE,wBAAwB;gBAC9B,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,SAAS,EAAE,GAAG;gBACd,MAAM;gBACN,KAAK;gBACL,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aACjG,CAAC,CAAC;QACL,CAAC;QAED,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QAErJ,qFAAqF;QACrF,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACrF,MAAM,SAAS,GAAG,CAAC,CAAC;QACpB,MAAM,SAAS,GAAwB;YACrC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC3B,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YACnC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACzB,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;gBAC9F,GAAG,KAAK,CAAC,QAAQ;gBACjB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;aACtC;YACD,KAAK,EAAE,cAAc;YACrB,MAAM;YACN,KAAK;YACL,SAAS;YACT,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;SAC7E,CAAC;QAEF,MAAM,MAAM,GAAyB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAE3I,MAAM,YAAY,GAAG,IAAI,EAAE,EAAE,CAAC;QAC9B,IAAI,YAAY;YAAE,WAAW,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC9E,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,KAAK,kBAAkB;gBAAE,eAAe,GAAG,IAAI,CAAC;YAC5E,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,YAAY,EAAE,CAAC;gBACtD,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzF,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7D,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;gBACxE,IAAI,KAAK,EAAE,CAAC;oBACV,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;gBACxH,CAAC;YACH,CAAC;QACH,CAAC;QAED,qGAAqG;QACrG,IAAI,SAAS,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,YAAY,IAAI,SAAS,EAAE,EAAE,KAAK,YAAY,EAAE,CAAC;YACnD,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC;YACxF,MAAM,YAAY,GAAG,8BAA8B,CAAC,eAAe,EAAE,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7G,IAAI,YAAY,CAAC,MAAM;gBAAE,SAAS,GAAG,eAAe,CAAC;QACvD,CAAC;QACD,IAAI,GAAG,SAAS,CAAC;QACjB,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAEhF,YAAY,GAAG,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACnD,MAAM,qBAAqB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAChI,MAAM,uBAAuB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACjI,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAEnH,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QAEhK,IAAI,MAAe,CAAC;QACpB,IAAI,MAAwB,CAAC;QAC7B,IAAI,WAAW,GAAuB,MAAM,CAAC,WAAW,CAAC;QAEzD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5H,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACxD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACvB,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;oBAC1C,IAAI,EAAE,wBAAwB;oBAC9B,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,SAAS,EAAE,GAAG;oBACd,MAAM;oBACN,KAAK;oBACL,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE;iBAC9D,CAAC,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBACtI,MAAM,IAAI,+BAA+B,CACvC,gBAAgB,IAAI,CAAC,EAAE,4EAA4E,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,EAC5H,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAC5C,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC;YACxB,MAAM,GAAG,WAAW,CAAC;YACrB,WAAW,GAAG,GAAG,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5H,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAoB,EAAE,EAAE,CAAC,CAAC;QACrK,CAAC;aAAM,IAAI,eAAe,EAAE,CAAC;YAC3B,MAAM,GAAG,sBAAsB,CAAC;YAChC,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,2BAA2B,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAClJ,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,IAAI,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrE,MAAM,GAAG,kBAAkB,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,kBAAkB,CAAC;YAC5B,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9I,CAAC;QAED,MAAM,OAAO,GAAuB;YAClC,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,SAAS,EAAE,GAAG;YACd,MAAM;YACN,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,KAAK,EAAE,KAAmB;YAC1B,uBAAuB;YACvB,qBAAqB;YACrB,WAAW;YACX,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,SAAS,EAAE,GAAG,EAAE;YAChB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC;QACF,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEhD,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,KAAK,EAAE,KAAmB;YAC1B,IAAI,EAAE;gBACJ,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM;gBACN,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,uBAAuB;gBACvB,qBAAqB;gBACrB,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxC;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,IAAgB,EAChB,GAAW,EACX,MAAc,EACd,KAAa,EACb,MAAiB,EACjB,KAAe,EACf,KAA+B,EAC/B,oBAA4C;QAE5C,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAE9H,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9F,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC;QAC3C,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;QAE7J,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;gBAC1C,IAAI,EAAE,oBAAoB;gBAC1B,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,SAAS,EAAE,GAAG;gBACd,MAAM;gBACN,KAAK;gBACL,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;aAC/C,CAAC,CAAC;QACL,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAExI,MAAM,YAAY,GAAG,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,gBAAgB,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAC;QAClE,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACrC,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,4BAA4B,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACtK,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACvC,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,8BAA8B,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACxK,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;IACxF,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,IAAgB,EAAE,GAAW,EAAE,cAAkC,EAAE,UAA8B,EAAE,MAAc,EAAE,KAAa;QAC/J,IAAI,cAAc,KAAK,UAAU;YAAE,OAAO;QAC1C,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACxI,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACjK,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACrI,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9J,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,IAAgB,EAAE,GAAW,EAAE,MAAc,EAAE,KAAa,EAAE,KAA0B;QACjH,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACzC,KAAK,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjK,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;YAC3C,KAAK,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;gBACzC,IAAI,EAAE,qBAAqB;gBAC3B,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,SAAS,EAAE,GAAG;gBACd,MAAM;gBACN,KAAK;gBACL,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;aAC/D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,MAAe,EAAE,MAAsB;QACrE,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7G,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACxH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,MAAe,EAAE,MAAsB;QACrE,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,MAAM,OAAO,GAAuB,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACzJ,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACpH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,MAAe,EAAE,MAAsB;QACpE,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;YACrC,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,EAAE,GAAI,IAAI,CAAC,MAAM,CAAC,YAA2B,EAAE;YACtD,uBAAuB,EAAE,EAAE;YAC3B,qBAAqB,EAAE,EAAE;YACzB,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,MAAc,EAAE,KAA8C,EAAE,MAAsB;QACxH,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAmB,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAuB,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI;YAC1F,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,EAAE,GAAI,MAAM,CAAC,YAA2B,EAAE;YACjD,uBAAuB,EAAE,EAAE;YAC3B,qBAAqB,EAAE,EAAE;YACzB,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;QACF,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,KAAiB,CAAC,CAAC;QAC5E,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,KAAiB,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAiB,EAAE,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,YAAY,CAAC,CAAC;QAChJ,MAAM,OAAO,GAAuB;YAClC,GAAG,MAAM;YACT,KAAK,EAAE,OAAO,CAAC,KAAmB;YAClC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,uBAAuB,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;YACjI,qBAAqB,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;YAChI,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,MAAe,EAAE,MAAsB;QACvE,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;CACF;AAED,SAAS,uBAAuB,CAAC,MAAiB,EAAE,IAA0C,EAAE,KAAe,EAAE,MAAyB;IACxI,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;SAC5E,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;SACpC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;SACpD,MAAM,CAAC,CAAC,KAAK,EAA4B,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAE/D,MAAM,KAAK,GAAG;QACZ,yCAAyC,MAAM,CAAC,IAAI,iBAAiB,MAAM,CAAC,IAAI,EAAE;QAClF,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,sCAAsC;QAC5F,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC,CAAC,EAAE;QAC1H,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,8BAA8B,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;QAC3E,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;KAC3E,CAAC;IACF,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,30 @@
+import type { z } from "zod";
+import type { FlowPatchSource, FlowStatePatch, GuidedFlowConfig } from "./types.js";
+export type ApplyPatchResult<TState> = {
+    state: TState;
+    changedKeys: string[];
+    droppedKeys: string[];
+};
+/**
+ * Applies a `FlowStatePatch` to `state`, enforcing two code-level invariants:
+ *  - only fields declared on `stateSchema` are ever written (unknown keys dropped);
+ *  - `protectedFields` may only be written by an allow-listed `FlowPatchSource`
+ *    (e.g. a model-sourced patch can never set a tool-reserved field like `orderId`).
+ */
+export declare function applyStatePatch<TStateSchema extends z.AnyZodObject, TOutputSchema extends z.ZodTypeAny>(config: GuidedFlowConfig<TStateSchema, TOutputSchema>, state: z.infer<TStateSchema>, patch: FlowStatePatch<z.infer<TStateSchema>>): ApplyPatchResult<z.infer<TStateSchema>>;
+/**
+ * Code-enforced confirmation reset: if a `confirmation.resetOnChange` field
+ * actually changed this turn and the flow was previously confirmed, force
+ * `confirmed` back to `false`. Never relies on the model remembering to ask again.
+ */
+export declare function applyConfirmationReset<TStateSchema extends z.AnyZodObject, TOutputSchema extends z.ZodTypeAny>(config: GuidedFlowConfig<TStateSchema, TOutputSchema>, state: z.infer<TStateSchema>, changedKeys: string[]): {
+    state: z.infer<TStateSchema>;
+    reset: boolean;
+};
+/**
+ * Builds the Zod schema the extraction sub-call must satisfy: a `.partial()` of
+ * `stateSchema` with any field whose `protectedFields` allow-list excludes
+ * `"model"` omitted entirely, so the model is never even prompted to guess it.
+ */
+export declare function buildModelPatchSchema<TStateSchema extends z.AnyZodObject>(stateSchema: TStateSchema, protectedFields: Partial<Record<string, FlowPatchSource[]>> | undefined): z.ZodTypeAny;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/guided-flows/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEpF,MAAM,MAAM,gBAAgB,CAAC,MAAM,IAAI;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,YAAY,SAAS,CAAC,CAAC,YAAY,EAAE,aAAa,SAAS,CAAC,CAAC,UAAU,EACrG,MAAM,EAAE,gBAAgB,CAAC,YAAY,EAAE,aAAa,CAAC,EACrD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAC5B,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAC3C,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CA8CzC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,SAAS,CAAC,CAAC,YAAY,EAAE,aAAa,SAAS,CAAC,CAAC,UAAU,EAC5G,MAAM,EAAE,gBAAgB,CAAC,YAAY,EAAE,aAAa,CAAC,EACrD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAC5B,WAAW,EAAE,MAAM,EAAE,GACpB;IAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAWlD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,SAAS,CAAC,CAAC,YAAY,EACvE,WAAW,EAAE,YAAY,EACzB,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,GAAG,SAAS,GACtE,CAAC,CAAC,UAAU,CAOd"}

package/dist/guided-flows/state.js

@@ -0,0 +1,84 @@
+/**
+ * Applies a `FlowStatePatch` to `state`, enforcing two code-level invariants:
+ *  - only fields declared on `stateSchema` are ever written (unknown keys dropped);
+ *  - `protectedFields` may only be written by an allow-listed `FlowPatchSource`
+ *    (e.g. a model-sourced patch can never set a tool-reserved field like `orderId`).
+ */
+export function applyStatePatch(config, state, patch) {
+    const protectedFields = (config.protectedFields ?? {});
+    const next = { ...state };
+    const changedKeys = [];
+    const droppedKeys = [];
+    if (patch.set) {
+        const shape = config.stateSchema.shape;
+        const setValues = patch.set;
+        for (const key of Object.keys(setValues)) {
+            const fieldSchema = shape[key];
+            if (!fieldSchema) {
+                droppedKeys.push(key);
+                continue;
+            }
+            const allowedSources = protectedFields[key];
+            if (allowedSources && !allowedSources.includes(patch.source)) {
+                droppedKeys.push(key);
+                continue;
+            }
+            const parsed = fieldSchema.safeParse(setValues[key]);
+            if (!parsed.success) {
+                droppedKeys.push(key);
+                continue;
+            }
+            if (next[key] !== parsed.data)
+                changedKeys.push(key);
+            next[key] = parsed.data;
+        }
+    }
+    if (patch.unset) {
+        for (const rawKey of patch.unset) {
+            const key = String(rawKey);
+            const allowedSources = protectedFields[key];
+            if (allowedSources && !allowedSources.includes(patch.source)) {
+                droppedKeys.push(key);
+                continue;
+            }
+            if (key in next) {
+                changedKeys.push(key);
+                delete next[key];
+            }
+        }
+    }
+    return { state: next, changedKeys, droppedKeys };
+}
+/**
+ * Code-enforced confirmation reset: if a `confirmation.resetOnChange` field
+ * actually changed this turn and the flow was previously confirmed, force
+ * `confirmed` back to `false`. Never relies on the model remembering to ask again.
+ */
+export function applyConfirmationReset(config, state, changedKeys) {
+    const confirmation = config.confirmation;
+    const resetOnChange = confirmation?.resetOnChange;
+    if (!confirmation || !resetOnChange || !resetOnChange.length)
+        return { state, reset: false };
+    const touchedMaterialField = resetOnChange.some((field) => changedKeys.includes(String(field)));
+    const stateField = String(confirmation.stateField);
+    const currentlyConfirmed = Boolean(state[stateField]);
+    if (touchedMaterialField && currentlyConfirmed) {
+        return { state: { ...state, [stateField]: false }, reset: true };
+    }
+    return { state, reset: false };
+}
+/**
+ * Builds the Zod schema the extraction sub-call must satisfy: a `.partial()` of
+ * `stateSchema` with any field whose `protectedFields` allow-list excludes
+ * `"model"` omitted entirely, so the model is never even prompted to guess it.
+ */
+export function buildModelPatchSchema(stateSchema, protectedFields) {
+    const omit = {};
+    for (const [key, sources] of Object.entries(protectedFields ?? {})) {
+        if (sources && !sources.includes("model"))
+            omit[key] = true;
+    }
+    const partial = stateSchema.partial();
+    return Object.keys(omit).length ? partial.omit(omit) : partial;
+}
+//# sourceMappingURL=state.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { z } from "zod";
+import type { GuidedFlowConfig, GuidedFlowStep } from "./types.js";
+/**
+ * Resolves the active step for the current `state`: the first step (in
+ * declared order) whose `when` predicate passes (branches that don't apply
+ * are skipped, never entered) and that isn't already satisfied. This is a
+ * pure function of `state`, never a model decision.
+ */
+export declare function resolveActiveStep<TStateSchema extends z.AnyZodObject, TOutputSchema extends z.ZodTypeAny>(config: GuidedFlowConfig<TStateSchema, TOutputSchema>, state: z.infer<TStateSchema>): GuidedFlowStep<z.infer<TStateSchema>> | undefined;
+export declare function isStepSatisfied<TState>(step: GuidedFlowStep<TState>, state: TState): boolean;
+export declare function missingCollectFields<TState>(step: GuidedFlowStep<TState> | undefined, state: TState): string[];
+//# sourceMappingURL=steps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../src/guided-flows/steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,SAAS,CAAC,CAAC,YAAY,EAAE,aAAa,SAAS,CAAC,CAAC,UAAU,EACvG,MAAM,EAAE,gBAAgB,CAAC,YAAY,EAAE,aAAa,CAAC,EACrD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,GAC3B,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,SAAS,CAOnD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAO5F;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ9G"}

package/dist/guided-flows/steps.js

@@ -0,0 +1,37 @@
+/**
+ * Resolves the active step for the current `state`: the first step (in
+ * declared order) whose `when` predicate passes (branches that don't apply
+ * are skipped, never entered) and that isn't already satisfied. This is a
+ * pure function of `state`, never a model decision.
+ */
+export function resolveActiveStep(config, state) {
+    for (const step of config.steps) {
+        if (step.when && !step.when({ state }))
+            continue;
+        if (isStepSatisfied(step, state))
+            continue;
+        return step;
+    }
+    return undefined;
+}
+export function isStepSatisfied(step, state) {
+    if (step.exit)
+        return Boolean(step.exit({ state }));
+    if (!step.collect || step.collect.length === 0)
+        return false;
+    return step.collect.every((field) => {
+        const value = state[String(field)];
+        return value !== undefined && value !== null && value !== "";
+    });
+}
+export function missingCollectFields(step, state) {
+    if (!step?.collect)
+        return [];
+    return step.collect
+        .map(String)
+        .filter((field) => {
+        const value = state[field];
+        return value === undefined || value === null || value === "";
+    });
+}
+//# sourceMappingURL=steps.js.map