@falai/agent 3.4.5 → 4.0.0-alpha.10

package/dist/core/Understand.js

@@ -0,0 +1,353 @@
+/**
+ * Understand: the one call that judges the lead's message (design §4.3).
+ *
+ * Runner decides who is eligible and what is pending; this module turns that
+ * into one prompt, one envelope schema and at most one provider call, then
+ * hands back raw values keyed by their real ids. It never writes session
+ * data: Runner validates, coerces and applies.
+ *
+ * Two shortcuts cost zero calls: a single eligible message flow with nothing
+ * else to judge starts outright, and a turn with nothing AI-conditioned
+ * returns an empty Understanding.
+ *
+ * The envelope is built for two kinds of provider at once. Gemini enforces
+ * the schema, so every section is a closed object with every property
+ * required and nullable. GLM follows it by prompt only, so the prompt
+ * restates the shape with a skeleton and the parser tolerates missing keys,
+ * wrong scalar types and stray text around the JSON.
+ */
+import { extractEmbeddedJSONObject, isRecord } from "../utils/json.js";
+import { logger } from "../utils/logger.js";
+import { splitPhrases } from "../utils/phrases.js";
+import { coerceField, isKnown, pendingFields, toWireSchema } from "../utils/schema.js";
+import { render } from "../utils/template.js";
+import { readUsage } from "../utils/usage.js";
+import { describeField, factsSection, joinSections, stablePrefix } from "./Prompt.js";
+export const UNDERSTAND_SCHEMA_NAME = "understand";
+const SECTIONS = ["flows", "mentions", "extract", "branches", "fields"];
+/** Gemini rejects any other character in a property name. */
+const SAFE_KEY = /^[a-zA-Z0-9_-]+$/;
+export class Understand {
+    constructor(options) {
+        this.options = options;
+    }
+    async run(req) {
+        const candidates = candidateFlows(req);
+        const onlyRouting = req.mentionFlows.length === 0 && req.branches.length === 0 && Object.keys(req.fields).length === 0;
+        // Nothing to compare or extract: no candidates, or only the floor's own flow. A lone
+        // candidate with nobody on the floor is here because the runner wants it scored.
+        if (onlyRouting && candidates.length <= (req.floor ? 1 : 0))
+            return empty(0);
+        const aliases = new Aliases();
+        const jsonSchema = buildEnvelope(req, candidates, aliases);
+        const { system, turn: prompt } = this.buildPrompt(req, candidates, aliases, jsonSchema);
+        // Provider failures propagate: in this phase the turn throws and the host retries the input.
+        const out = await this.options.provider.generateMessage({
+            prompt,
+            ...(system ? { system } : {}),
+            history: req.history,
+            context: req.context,
+            parameters: { jsonSchema, schemaName: UNDERSTAND_SCHEMA_NAME },
+        });
+        const reply = usable(out.structured) ? out.structured : extractEmbeddedJSONObject(out.message);
+        if (!usable(reply)) {
+            logger.warn(`[Understand] The reply had no usable structure, so nothing was judged this turn. ` +
+                `Reply started with: ${out.message.slice(0, 200)}`);
+            return empty(1, readUsage(out.metadata));
+        }
+        return { ...parseReply(reply, aliases), ...usageOf(out.metadata) };
+    }
+    buildPrompt(req, candidates, aliases, schema) {
+        const scope = { data: req.data, context: req.context };
+        const t = (text) => render(text, scope);
+        const data = isRecord(req.data) ? req.data : {};
+        const { system, inline } = stablePrefix(this.options, scope);
+        return {
+            system,
+            turn: joinSections(inline, taskSection(), floorSection(req, this.options.fields, data, t), factsSection(this.options.fields, data), flowsSection(candidates, aliases, t), mentionsSection(req.mentionFlows, aliases, t), branchesSection(req.branches, aliases, t), fieldsSection(req.fields, aliases), messageSection(req.text), outputSection(schema)),
+        };
+    }
+}
+// ── Candidates and keys ─────────────────────────────────────────────────
+/** The floor's flow first, then the eligible message flows, each id once. */
+function candidateFlows(req) {
+    const seen = new Map();
+    for (const flow of [...(req.floor ? [req.floor.flow] : []), ...req.messageFlows]) {
+        if (!seen.has(flow.id))
+            seen.set(flow.id, flow);
+    }
+    return [...seen.values()];
+}
+/**
+ * Envelope property names for ids the schema cannot carry. A safe id keeps
+ * its own name; anything else (run ids carry `#`, `:` and `/`) gets a short
+ * alias, mapped back when the reply is parsed.
+ */
+class Aliases {
+    constructor() {
+        this.byReal = new Map();
+        this.byAlias = new Map();
+        this.n = 0;
+    }
+    of(real, prefix = "k") {
+        const seen = this.byReal.get(real);
+        if (seen)
+            return seen;
+        const alias = SAFE_KEY.test(real) && !this.byAlias.has(real) ? real : this.fresh(prefix);
+        this.byAlias.set(alias, real);
+        this.byReal.set(real, alias);
+        return alias;
+    }
+    /** Unknown aliases come back as they are; Runner drops keys it does not know. */
+    real(alias) {
+        return this.byAlias.get(alias) ?? alias;
+    }
+    fresh(prefix) {
+        let alias;
+        do
+            alias = `${prefix}${++this.n}`;
+        while (this.byAlias.has(alias));
+        return alias;
+    }
+}
+function branchKey(branch) {
+    return `${branch.runId}/${branch.stepId}/${branch.index}`;
+}
+// ── Envelope ────────────────────────────────────────────────────────────
+function buildEnvelope(req, candidates, aliases) {
+    const properties = {};
+    if (candidates.length) {
+        properties.flows = toWireSchema(keyed(candidates.map((f) => aliases.of(f.id, "f")), { type: "integer", description: "0-100 fit of the message to this flow" }), { nullable: true });
+    }
+    if (req.mentionFlows.length) {
+        properties.mentions = toWireSchema(keyed(req.mentionFlows.map((f) => aliases.of(f.id, "f")), { type: "boolean", description: "The customer brought this up" }), { nullable: true });
+        const extract = {};
+        for (const flow of req.mentionFlows) {
+            const defs = extractDefs(flow);
+            if (defs)
+                extract[aliases.of(flow.id, "f")] = toWireSchema(defs, { nullable: true });
+        }
+        if (Object.keys(extract).length) {
+            properties.extract = { type: "object", properties: extract, required: Object.keys(extract), additionalProperties: false };
+        }
+    }
+    if (req.branches.length) {
+        properties.branches = toWireSchema(keyed(req.branches.map((b) => aliases.of(branchKey(b), "q")), { type: "boolean", description: "The answer to this question" }), { nullable: true });
+    }
+    if (Object.keys(req.fields).length) {
+        const defs = {};
+        for (const [slug, def] of Object.entries(req.fields))
+            defs[aliases.of(slug, "d")] = def;
+        properties.fields = toWireSchema(defs, { nullable: true });
+    }
+    return { type: "object", properties, required: Object.keys(properties), additionalProperties: false };
+}
+function keyed(keys, def) {
+    return Object.fromEntries(keys.map((key) => [key, def]));
+}
+/** The mention trigger's `extract` definitions, when the flow has any. */
+function extractDefs(flow) {
+    for (const trigger of flow.on ?? []) {
+        if ("mention" in trigger && trigger.extract && Object.keys(trigger.extract).length)
+            return trigger.extract;
+    }
+    return undefined;
+}
+// ── Prompt sections ─────────────────────────────────────────────────────
+function taskSection() {
+    return [
+        "## Task",
+        "Judge the customer's latest message, quoted below, against the conversation so far. " +
+            "Only the customer's own words count as evidence: never treat the assistant's questions or guesses as something the customer said. " +
+            'Answer with one JSON object in the shape given under "Output".',
+    ].join("\n");
+}
+function floorSection(req, fields, data, t) {
+    if (!req.floor)
+        return null;
+    const { run, flow } = req.floor;
+    const lines = [
+        "## Current flow",
+        `The customer is mid-conversation in "${flow.name}" (${flow.id})${flow.description ? `: ${t(flow.description)}` : "."}`,
+    ];
+    const step = flow.steps.find((s) => s.id === run.stepId);
+    if (step && ("collect" in step || "prompt" in step)) {
+        lines.push(`Current step: ${step.id}${step.prompt ? ` — ${t(step.prompt)}` : ""}`);
+        const pending = pendingFields(step, data, run.asked);
+        if (pending.length) {
+            lines.push("This step is waiting for:");
+            lines.push(...pending.map((slug) => `- ${fields[slug] ? describeField(slug, fields[slug]) : slug}`));
+        }
+    }
+    lines.push("The customer may continue here or switch to something else. Score the current flow below like any other.");
+    return lines.join("\n");
+}
+function flowsSection(candidates, aliases, t) {
+    if (candidates.length === 0)
+        return null;
+    const lines = [
+        "## Flows the customer may want",
+        "Score every flow from 0 to 100 by how well the message fits it. Score all of them, the current flow included.",
+    ];
+    candidates.forEach((flow, i) => {
+        lines.push(`${i + 1}. ${aliases.of(flow.id, "f")} — ${flow.name}${flow.description ? `: ${t(flow.description)}` : ""}`);
+        const { counts, excludes } = splitPhrases(triggerPhrases(flow, "message"));
+        if (counts.length)
+            lines.push(`   The customer: ${counts.map(t).join("; ")}`);
+        if (excludes.length)
+            lines.push(`   Score 0 when: ${excludes.map(t).join("; ")}`);
+    });
+    lines.push("", "Scoring rules:", "- 90-100: explicit keywords + clear intent", "- 70-89: strong contextual evidence + relevant keywords", "- 50-69: moderate relevance", "- 30-49: weak connection or ambiguous", "- 0-29: minimal/none");
+    return lines.join("\n");
+}
+function mentionsSection(flows, aliases, t) {
+    if (flows.length === 0)
+        return null;
+    const lines = [
+        "## Things the customer may mention",
+        "For each item, answer true when the customer's message clearly brings it up, false otherwise. " +
+            "Be conservative: true needs clear, explicit evidence in the message. The phrases under an item are alternatives; one match is enough. " +
+            "A 'Does not count when' line overrides a match: if one of those fits, answer false.",
+    ];
+    for (const flow of flows) {
+        lines.push(`- ${aliases.of(flow.id, "f")} — ${flow.name}${flow.description ? `: ${t(flow.description)}` : ""}`);
+        const { counts, excludes } = splitPhrases(triggerPhrases(flow, "mention"));
+        if (counts.length)
+            lines.push(`  Counts when: ${counts.map(t).join("; ")}`);
+        if (excludes.length)
+            lines.push(`  Does not count when: ${excludes.map(t).join("; ")}`);
+        const defs = extractDefs(flow);
+        if (defs) {
+            lines.push("  When true, also extract:");
+            lines.push(...Object.entries(defs).map(([name, def]) => `  - ${describeParam(name, def)}`));
+        }
+    }
+    return lines.join("\n");
+}
+function branchesSection(branches, aliases, t) {
+    if (branches.length === 0)
+        return null;
+    return [
+        "## Questions about this message",
+        "Answer each question with true or false, judging the customer's message in the context of the conversation.",
+        ...branches.map((b) => `- ${aliases.of(branchKey(b), "q")}: ${t(b.when)}`),
+    ].join("\n");
+}
+function fieldsSection(fields, aliases) {
+    const entries = Object.entries(fields);
+    if (entries.length === 0)
+        return null;
+    return [
+        "## Details the customer may have given",
+        "Report a value only when the customer actually gave it in this message. " +
+            "Never guess and never infer it from the assistant's words. Use null when the customer did not give it.",
+        ...entries.map(([slug, def]) => `- ${describeField(aliases.of(slug, "d"), def)}`),
+    ].join("\n");
+}
+function messageSection(text) {
+    return ["## Customer's latest message", '"""', text, '"""'].join("\n");
+}
+const OUTPUT_LINES = {
+    flows: "- flows: one integer from 0 to 100 per flow id listed above",
+    mentions: "- mentions: true or false per item id",
+    extract: "- extract: per item id, an object with the values pulled from the message; null values when the item was not brought up",
+    branches: "- branches: true or false per question id",
+    fields: "- fields: one value per detail, null when the customer did not give it",
+};
+/**
+ * What the skeleton shows in each section: a score of 0, a "no" answer, and
+ * null for anything extracted, so a prompt-only model never reads a
+ * placeholder as a default value.
+ */
+const PLACEHOLDER = { flows: 0, mentions: false, extract: null, branches: false, fields: null };
+function outputSection(schema) {
+    const present = SECTIONS.filter((s) => schema.properties?.[s] !== undefined);
+    const skeleton = Object.fromEntries(present.map((s) => [s, fill(schema.properties?.[s] ?? {}, PLACEHOLDER[s])]));
+    return [
+        "## Output",
+        "Return exactly one JSON object and nothing else: no prose before or after, no code fence. " +
+            "Every key below is required; use null where you have nothing to report.",
+        ...present.map((s) => OUTPUT_LINES[s]),
+        "Shape, with placeholder values:",
+        JSON.stringify(skeleton),
+    ].join("\n");
+}
+/** The schema's shape with one placeholder at every leaf. */
+function fill(schema, placeholder) {
+    const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;
+    if (type !== "object")
+        return placeholder;
+    return Object.fromEntries(Object.entries(schema.properties ?? {}).map(([k, v]) => [k, fill(v, placeholder)]));
+}
+function triggerPhrases(flow, kind) {
+    const phrases = [];
+    for (const trigger of flow.on ?? []) {
+        if (kind === "message" && "message" in trigger)
+            phrases.push(...trigger.message);
+        if (kind === "mention" && "mention" in trigger)
+            phrases.push(...trigger.mention);
+    }
+    return phrases;
+}
+function describeParam(name, def) {
+    if (def.type === "array")
+        return `${name} (list of ${def.items.type})${def.description ? `: ${def.description}` : ""}`;
+    return describeField(name, def);
+}
+// ── Reply parsing ───────────────────────────────────────────────────────
+function empty(llmCalls, usage) {
+    return { flows: {}, mentions: {}, extract: {}, branches: {}, fields: {}, llmCalls, ...(usage ? { usage } : {}) };
+}
+/** `{ usage }` when the provider counted, `{}` when it did not — `exactOptionalPropertyTypes`. */
+function usageOf(metadata) {
+    const usage = readUsage(metadata);
+    return usage ? { usage } : {};
+}
+/** A reply is usable when it is an object carrying at least one envelope section. */
+function usable(value) {
+    return isRecord(value) && SECTIONS.some((s) => s in value);
+}
+function entries(value) {
+    return isRecord(value) ? Object.entries(value) : [];
+}
+function parseReply(reply, aliases) {
+    const flows = {};
+    for (const [key, raw] of entries(reply.flows)) {
+        const n = score(raw);
+        if (n !== undefined)
+            flows[aliases.real(key)] = n;
+    }
+    const extract = {};
+    for (const [key, raw] of entries(reply.extract)) {
+        if (isRecord(raw))
+            extract[aliases.real(key)] = given(raw);
+    }
+    return {
+        flows,
+        mentions: booleans(reply.mentions, aliases),
+        extract,
+        branches: booleans(reply.branches, aliases),
+        fields: given(Object.fromEntries(entries(reply.fields).map(([k, v]) => [aliases.real(k), v]))),
+        llmCalls: 1,
+    };
+}
+/** A finite number, or a numeric string, clamped to 0-100. Anything else is dropped. */
+function score(raw) {
+    const n = typeof raw === "number" ? raw : typeof raw === "string" ? Number(raw.trim()) : NaN;
+    return Number.isFinite(n) ? Math.min(100, Math.max(0, n)) : undefined;
+}
+/** Booleans, with `sim`/`yes`/`true` strings accepted through the shared coercion table. */
+function booleans(value, aliases) {
+    const out = {};
+    for (const [key, raw] of entries(value)) {
+        const coerced = coerceField({ type: "boolean" }, raw);
+        if (coerced.ok && typeof coerced.value === "boolean")
+            out[aliases.real(key)] = coerced.value;
+    }
+    return out;
+}
+/** Raw values the customer gave: `null`, `undefined` and `''` mean nothing was given. */
+function given(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, v]) => isKnown(v)));
+}
+//# sourceMappingURL=Understand.js.map

package/dist/core/Understand.js.map

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

package/dist/core/contracts.d.ts

@@ -0,0 +1,122 @@
+/**
+ * The seams between the turn's phases. Runner decides who is eligible and
+ * what is pending; Understand and Speak turn that into at most one provider
+ * call each and hand back plain data for Runner to apply.
+ *
+ * Runner (code)  ──UnderstandRequest──▶  Understand (≤1 call)  ──Understanding──▶  Runner
+ * Runner (code)  ──SpeakRequest──────▶  Speak (≤1 call + tools) ──SpeakOutcome──▶  Runner
+ */
+import type { TokenUsage } from "../types/ai.js";
+import type { Idle } from "../types/agent.js";
+import type { FieldDef, Flow, Instruction, StepBase, TalkStep } from "../types/flow.js";
+import type { History } from "../types/history.js";
+import type { Run, StepOutcomeCode } from "../types/session.js";
+import type { Tool } from "../types/tool.js";
+export type InputKind = "message" | "wake" | "event" | "start";
+/** Everything the understand call may judge this turn. Runner filters by `if` and `repeat` first. */
+export interface UnderstandRequest<C = unknown, D = unknown> {
+    text: string;
+    history: History;
+    context: C;
+    data: Partial<D>;
+    /** The run holding the floor, always a candidate whatever its trigger. */
+    floor?: {
+        run: Run;
+        flow: Flow<C, D>;
+    };
+    /** Eligible `message` flows, in flow order. `[]` triggers (catch-alls) are excluded. */
+    messageFlows: Flow<C, D>[];
+    /** Eligible `mention` flows with a non-empty `mention[]`, in flow order. */
+    mentionFlows: Flow<C, D>[];
+    /** `when` branches of the asking step. */
+    branches: Array<{
+        runId: string;
+        stepId: string;
+        index: number;
+        when: string;
+    }>;
+    /** Pending fields harvestable from any text (`extract: 'anywhere'`). */
+    fields: Record<string, FieldDef>;
+}
+/** The judged result. Raw values: Runner validates and writes them. */
+export interface Understanding {
+    /** flowId → 0–100 fit of the lead's message to the flow. */
+    flows: Record<string, number>;
+    /** flowId → the lead mentioned it. */
+    mentions: Record<string, boolean>;
+    /** flowId → values extracted for a mention trigger's `extract` schema. */
+    extract: Record<string, Record<string, unknown>>;
+    /** `${runId}/${stepId}/${index}` → the branch condition holds. */
+    branches: Record<string, boolean>;
+    /** field → raw value the lead gave, or nothing. */
+    fields: Record<string, unknown>;
+    llmCalls: number;
+    usage?: TokenUsage;
+}
+/** A talk step queued to speak, with its pending fields already computed. */
+export interface TalkRequest<C = unknown, D = unknown> {
+    run: Run;
+    flow: Flow<C, D>;
+    step: StepBase<D> & TalkStep<C, D>;
+    /** `step.collect` minus known minus at `maxAsks`, in order. */
+    pending: string[];
+}
+/** No run holds the floor; the idle speaker answers. */
+export interface IdleRequest<C = unknown, D = unknown> {
+    idle: Exclude<Idle<C, D>, "silent">;
+}
+export interface SpeakRequest<C = unknown, D = unknown> {
+    talk: TalkRequest<C, D> | IdleRequest<C, D>;
+    /** What started this turn. A wake has no text: the assistant speaks first. */
+    input: {
+        kind: InputKind;
+        text?: string;
+    };
+    context: C;
+    data: Partial<D>;
+    history: History;
+    now: Date;
+    /** Already filtered by their `if`; `when` stays for the prompt. */
+    instructions: Instruction<C, D>[];
+    tools: Tool<C, D>[];
+}
+export interface Spoken {
+    message: string;
+    /** Raw envelope values for the pending fields. Runner validates and writes them. */
+    fields: Record<string, unknown>;
+    /** Data patches returned by tools, merged in call order. */
+    data: Record<string, unknown>;
+    toolCalls: Array<{
+        toolName: string;
+        arguments: Record<string, unknown>;
+    }>;
+    llmCalls: number;
+    usage?: TokenUsage;
+}
+/**
+ * Why a speak call failed, and whether a later wake could still fix it. A kind
+ * no wake can fix — wrong key, a prompt past the context window, a spent
+ * balance with no stated reset — ends the step instead of re-running two model
+ * calls against the same wall every fifteen minutes.
+ */
+export interface Deferral {
+    code: StepOutcomeCode;
+    retryable: boolean;
+    /** When the provider said its limit reopens. Beats the backoff ladder. */
+    resetAtMs?: number;
+}
+/** `deferred` is the provider failing; Runner re-parks the step under a retry wake, or ends it. */
+export type SpeakOutcome = {
+    spoken: Spoken;
+} | {
+    deferred: Deferral;
+    llmCalls: number;
+    usage?: TokenUsage;
+};
+export type SpeakStreamChunk = {
+    delta: string;
+} | {
+    done: true;
+    outcome: SpeakOutcome;
+};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/core/contracts.d.ts.map

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

package/dist/core/contracts.js

@@ -0,0 +1,10 @@
+/**
+ * The seams between the turn's phases. Runner decides who is eligible and
+ * what is pending; Understand and Speak turn that into at most one provider
+ * call each and hand back plain data for Runner to apply.
+ *
+ * Runner (code)  ──UnderstandRequest──▶  Understand (≤1 call)  ──Understanding──▶  Runner
+ * Runner (code)  ──SpeakRequest──────▶  Speak (≤1 call + tools) ──SpeakOutcome──▶  Runner
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/core/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/core/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/core/falai.d.ts

@@ -0,0 +1,57 @@
+/**
+ * `falai()` carries the one explicit generic an app writes: its context type.
+ * Everything else is inferred from values.
+ *
+ * ```ts
+ * const f = falai<LeadContext>().fields({
+ *   nome: { type: 'string', ask: 'Pergunte o nome de um jeito leve.' },
+ * });
+ * const agent = f.agent({ name: 'Ana', provider, flows: [f.flow({ ... })] });
+ * const r = await agent.turn({ sessionId: 'demo', context, message: 'oi' });
+ * ```
+ *
+ * `f.fields(...)` binds the collected-data type, so every `collect`, `ask`,
+ * `clearOnStart` and action `ctx.set` downstream is checked against the
+ * field slugs. Action, event and condition names inside flows stay strings:
+ * they are checked when the agent is built, the same way JSON specs are.
+ */
+import type { AgentOptions } from "../types/agent.js";
+import type { Action, ActionCtx, ActionResult, Condition, EventDef, FieldDefs, Flow, InferData, InferParams, ParamDefs, PredCtx } from "../types/flow.js";
+import { Agent } from "./Agent.js";
+import { type FlowSpec } from "./FlowSpec.js";
+/** The toolkit once fields are bound. `D` is the collected-data type. */
+export interface Falai<C, D, F extends FieldDefs> {
+    /** The field definitions, as given. */
+    readonly fields: F;
+    /** A host action; `params` is typed from `parameters`. */
+    action<const P extends ParamDefs>(def: {
+        description?: string;
+        parameters: P;
+        run: (params: InferParams<P>, ctx: ActionCtx<C, D>) => ActionResult | Promise<ActionResult>;
+    }): Action<C, D, InferParams<P>>;
+    /** A host event; `P` is its payload type. */
+    event<P = undefined>(def?: {
+        direction?: "inbound" | "outbound";
+    }): EventDef<P>;
+    /** A host condition JSON predicates may name. */
+    condition<Arg>(check: (ctx: PredCtx<C, D>, arg: Arg) => boolean): Condition<C, D, Arg>;
+    /** A flow; returns it unchanged, typed. */
+    flow(def: Flow<C, D>): Flow<C, D>;
+    /** A stored flow (JSON) as a typed flow. The agent validates it when built. */
+    fromSpec(spec: FlowSpec): Flow<C, D>;
+    /** The agent; `fields` come from the toolkit. */
+    agent(options: Omit<AgentOptions<C, D>, "fields">): Agent<C, D>;
+}
+/** The toolkit before fields are bound: loose data, plus `fields()` to bind them. */
+export interface FalaiRoot<C> extends Omit<Falai<C, InferData<FieldDefs>, FieldDefs>, "fields"> {
+    fields<const F extends FieldDefs>(defs: F): Falai<C, InferData<F>, F>;
+}
+/** The collected-data type of a bound toolkit: `type Data = DataOf<typeof f>`. */
+export type DataOf<T extends {
+    fields: FieldDefs;
+}> = InferData<T["fields"]>;
+/**
+ * Start here. Pass the host context type; `falai()` alone means no context.
+ */
+export declare function falai<C = undefined>(): FalaiRoot<C>;
+//# sourceMappingURL=falai.d.ts.map

package/dist/core/falai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"falai.d.ts","sourceRoot":"","sources":["../../src/core/falai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EACV,MAAM,EACN,SAAS,EACT,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,SAAS,EACT,WAAW,EACX,SAAS,EACT,OAAO,EACR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,eAAe,CAAC;AAExD,yEAAyE;AACzE,MAAM,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,SAAS;IAC9C,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,0DAA0D;IAC1D,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE;QACrC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,CAAC,CAAC;QACd,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;KAC7F,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,6CAA6C;IAC7C,KAAK,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;KAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChF,iDAAiD;IACjD,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IACvF,2CAA2C;IAC3C,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,iDAAiD;IACjD,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACjE;AAED,qFAAqF;AACrF,MAAM,WAAW,SAAS,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC;IAC7F,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACvE;AAED,kFAAkF;AAClF,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,IAAI,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAc7E;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,CAKnD"}

package/dist/core/falai.js

@@ -0,0 +1,40 @@
+/**
+ * `falai()` carries the one explicit generic an app writes: its context type.
+ * Everything else is inferred from values.
+ *
+ * ```ts
+ * const f = falai<LeadContext>().fields({
+ *   nome: { type: 'string', ask: 'Pergunte o nome de um jeito leve.' },
+ * });
+ * const agent = f.agent({ name: 'Ana', provider, flows: [f.flow({ ... })] });
+ * const r = await agent.turn({ sessionId: 'demo', context, message: 'oi' });
+ * ```
+ *
+ * `f.fields(...)` binds the collected-data type, so every `collect`, `ask`,
+ * `clearOnStart` and action `ctx.set` downstream is checked against the
+ * field slugs. Action, event and condition names inside flows stay strings:
+ * they are checked when the agent is built, the same way JSON specs are.
+ */
+import { Agent } from "./Agent.js";
+import { fromSpec } from "./FlowSpec.js";
+function toolkit(fields) {
+    return {
+        fields,
+        action: (def) => def,
+        event: (def = {}) => def,
+        condition: (check) => ({ check }),
+        flow: (def) => def,
+        fromSpec: (spec) => fromSpec(spec),
+        agent: (options) => new Agent({ ...options, fields }),
+    };
+}
+/**
+ * Start here. Pass the host context type; `falai()` alone means no context.
+ */
+export function falai() {
+    return {
+        ...toolkit({}),
+        fields: (defs) => toolkit(defs),
+    };
+}
+//# sourceMappingURL=falai.js.map

package/dist/core/falai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"falai.js","sourceRoot":"","sources":["../../src/core/falai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAgBH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAiB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAgCxD,SAAS,OAAO,CAA4B,MAAS;IACnD,OAAO;QACL,MAAM;QACN,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG;QACpB,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG;QACxB,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACjC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG;QAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAO,IAAI,CAAC;QACxC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,KAAK,CAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK;IACnB,OAAO;QACL,GAAG,OAAO,CAAqC,EAAE,CAAC;QAClD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/core/predicate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Code predicates: a function runs as is; a `ConditionSpec` is AND over its
+ * keys, with `equals`, `known` and `silenced` built in and every other key
+ * looked up in the agent's conditions.
+ */
+import type { ConditionMap, Pred, PredCtx } from "../types/flow.js";
+export declare function evaluate<C, D, P>(pred: Pred<C, D, P>, ctx: PredCtx<C, D, P>, conditions: ConditionMap<C, D>): boolean;
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=predicate.d.ts.map

package/dist/core/predicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate.d.ts","sourceRoot":"","sources":["../../src/core/predicate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGpE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC9B,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACnB,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACrB,UAAU,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,OAAO,CA8BT;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CASzD"}