primitive-admin 1.1.0-alpha.78 → 1.1.0-alpha.79

package/dist/src/lib/function-schema-codegen.js

@@ -0,0 +1,402 @@
+/**
+ * Schema-typed codegen for server functions — #3281, project
+ * `server-functions` phase 4.
+ *
+ * The intent's "Schema-typed codegen on every push": `<Key>Input` and
+ * `<Key>Output` from the declared schemas, a handler helper so function code
+ * is typed from the declaration, and a typed per-key invoker with the MODE
+ * fixed at generation time so a mismatch is a compile error. Two artifacts,
+ * both rendered from the same `functions/<key>.toml` and both regenerated by
+ * `config push`, `config pull` and `primitive functions codegen`:
+ *
+ *   - `functions/primitive-function-types.d.ts` — every key's input and
+ *     output types, and a `FunctionSchemas` augmentation keyed by function
+ *     key (the `DatabaseSchemas` shape `primitive-db-types.d.ts` uses), which
+ *     is what types `defineFunction("<key>", handler)`: `input` is the
+ *     declared input, the return is checked against the declared output, and
+ *     a key the tree does not declare is a compile error.
+ *   - `functions/generated/<key>.generated.ts` — the client invoker, the
+ *     `workflows codegen` layout: imports only from `js-bao-wss-client`,
+ *     exports the two types and a `<key>(client)` factory whose members are
+ *     the verbs the MODE allows and nothing else. A request function's
+ *     invoker has exactly `invoke`; a task function's exactly `start`,
+ *     `getStatus`, `waitFor` and `terminate`. The task `waitFor` binds
+ *     `<Key>Output`, so the completion path is typed too (D3281-SO-003).
+ *
+ * ── The same descriptor the platform validates with ──────────────────────
+ *
+ * Schemas are interpreted through the vendored descriptor `workflows codegen`
+ * already reads (`workflow-codegen/schemaToTs.ts`, a byte copy of the server's
+ * `schema-descriptor.ts`), so what compiles is what every invocation door
+ * accepts: `input` is a REQUIRED option iff the schema rejects `{}` (the
+ * client sends `rootInput` only when `input !== undefined`, and the server
+ * defaults an absent one to `{}`), an absent schema is `unknown`, and a
+ * malformed schema fails naming the file rather than typing something false.
+ *
+ * ── Identifiers ──────────────────────────────────────────────────────────
+ *
+ * Names come from the workflow naming helpers (PascalCase, the digit-leading
+ * and reserved-word rules), and the runtime call always passes the ORIGINAL
+ * key. Two keys that sanitize to one identifier would render one file over the
+ * other, so that is refused naming both.
+ *
+ * FORMATTING CONTRACT (#1565): the invoker is emitted as a fixed point of
+ * Prettier's default config through `codegen-shared/prettierStable.ts`, like
+ * the other two generators, because `--check` byte-compares.
+ */
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { basename, join } from "path";
+import { parseConfigToml } from "./config-toml.js";
+import { safeJsonParse } from "./workflow-payload.js";
+import { resolveDeclaredMode, } from "./generated-config-surfaces.js";
+import { schemaRejectsEmptyObject, schemaToTypeNode, } from "./workflow-codegen/schemaToTs.js";
+import { describeSchema } from "./workflow-codegen/generated-schema-descriptor.js";
+import { workflowFactoryName, workflowTypeBaseName, } from "./workflow-codegen/naming.js";
+import { fingerprintToml } from "./db-codegen/dbFingerprint.js";
+import { atom, generic, indent, intersection, objectType, printType, renderArrowCall, renderArrowProperty, renderParenList, renderTypeAlias, tsStringLiteral, union, } from "./codegen-shared/prettierStable.js";
+/** The regenerated declaration beside `primitive-db-types.d.ts`. */
+export const FUNCTION_TYPES_DECLARATION_FILE = "primitive-function-types.d.ts";
+/** Where the per-key invokers go, under `functions/`, unless `-o` says otherwise. */
+export const FUNCTION_INVOKERS_DIR = "generated";
+/** Suffix identifying a generated invoker (shared with the other generators). */
+export const GENERATED_FILE_SUFFIX = ".generated.ts";
+/** The client package the invoker imports its types from. */
+const CLIENT_PACKAGE = "js-bao-wss-client";
+export class FunctionSchemaCodegenError extends Error {
+}
+/**
+ * The key push will identify this file by, resolved exactly the way push
+ * resolves it (CR3281-001).
+ *
+ * Push reads `tomlData.function?.key || basename(file, ".toml")`, so a file
+ * named `local.toml` carrying `key = "remote"` is pushed, collected and
+ * key-checked as `remote`. Reading only the stem here would have generated a
+ * `remote`-less declaration and an invoker calling a function that does not
+ * exist, while the collect step compared the exported handler against
+ * `remote` — three spellings of one identity. The file stem stays the
+ * fallback, which is what a pulled tree always uses.
+ *
+ * Same rule, same reason as `databaseTypeSources` (SO3182-003): the generator
+ * reads the key the platform will hear about, never the file name alone.
+ */
+function resolveFunctionKey(source, table) {
+    return table?.key ? String(table.key) : source.key;
+}
+/**
+ * Every `functions/*.toml` in a tree, read once. The key is the one push
+ * uses: the file name (push takes the identity from it and attaches
+ * `functionKey` itself).
+ */
+export function functionSchemaSources(configDir) {
+    const dir = join(configDir, "functions");
+    if (!existsSync(dir))
+        return [];
+    const sources = [];
+    for (const file of readdirSync(dir).filter((f) => f.endsWith(".toml"))) {
+        const tomlPath = join(dir, file);
+        let tomlContent;
+        try {
+            tomlContent = readFileSync(tomlPath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        sources.push({ key: basename(file, ".toml"), tomlPath, tomlContent });
+    }
+    return sources;
+}
+/** The tree-relative spelling of a source, for a message an author acts on. */
+function fileLabel(source) {
+    const at = source.tomlPath.lastIndexOf("/functions/");
+    return at >= 0 ? source.tomlPath.slice(at + 1) : source.tomlPath;
+}
+/**
+ * Parse one file into the data both renderers need. Throws a
+ * `FunctionSchemaCodegenError` naming the file for malformed schema JSON or an
+ * unresolvable mode — the honest `unknown` is for an ABSENT schema, never a
+ * broken one.
+ */
+export function describeFunctionSchemas(source) {
+    let table;
+    try {
+        table = parseConfigToml(source.tomlContent)?.function ?? {};
+    }
+    catch (error) {
+        throw new FunctionSchemaCodegenError(`${fileLabel(source)}: the file does not parse as TOML (${error?.message ?? error})`);
+    }
+    // The key push identifies this file by — an authored `[function] key` when
+    // there is one, the file stem otherwise (CR3281-001).
+    const key = resolveFunctionKey(source, table);
+    const mode = resolveDeclaredMode({ mode: table.mode, durable: table.durable });
+    if (mode.ok === false) {
+        throw new FunctionSchemaCodegenError(`${fileLabel(source)}: ${mode.error}`);
+    }
+    const schema = (field) => {
+        try {
+            return safeJsonParse(table[field]);
+        }
+        catch (error) {
+            throw new FunctionSchemaCodegenError(`${fileLabel(source)}: \`${field}\` is not valid JSON (${error?.message ?? error})`);
+        }
+    };
+    const inputSchema = schema("inputSchema");
+    const outputSchema = schema("outputSchema");
+    const typeBaseName = workflowTypeBaseName(key);
+    return {
+        key,
+        mode: mode.mode,
+        fileLabel: fileLabel(source),
+        inputSchema,
+        outputSchema,
+        inputRequired: inputSchema !== undefined && schemaRejectsEmptyObject(inputSchema),
+        typeBaseName,
+        inputTypeName: `${typeBaseName}Input`,
+        outputTypeName: `${typeBaseName}Output`,
+        factoryName: workflowFactoryName(key),
+    };
+}
+/**
+ * Describe every source, sorted by key, refusing two keys that sanitize to
+ * one identifier: they would render one file over the other and one type
+ * name for two schemas.
+ */
+function describeAll(sources) {
+    const described = sources.map((source) => ({ fn: describeFunctionSchemas(source), source }));
+    described.sort((a, b) => (a.fn.key < b.fn.key ? -1 : a.fn.key > b.fn.key ? 1 : 0));
+    // Two files resolving to ONE key — only reachable through an authored
+    // `[function] key` (CR3281-001), since file stems are unique by
+    // construction. They would render one invoker over the other and push one
+    // function twice, so name both files rather than pick a winner.
+    const byKey = new Map();
+    for (const { fn, source } of described) {
+        const other = byKey.get(fn.key);
+        if (other !== undefined) {
+            throw new FunctionSchemaCodegenError(`${fileLabel(other)} and ${fileLabel(source)} both declare the function ` +
+                `key '${fn.key}' — one file is one function, so rename or remove one ` +
+                `\`[function] key\``);
+        }
+        byKey.set(fn.key, source);
+    }
+    const byBaseName = new Map();
+    for (const { fn } of described) {
+        const other = byBaseName.get(fn.typeBaseName);
+        if (other !== undefined && other !== fn.key) {
+            throw new FunctionSchemaCodegenError(`function keys '${other}' and '${fn.key}' both name the generated type ` +
+                `\`${fn.typeBaseName}Input\` — rename one so the two do not collide after sanitizing`);
+        }
+        byBaseName.set(fn.typeBaseName, fn.key);
+    }
+    return described;
+}
+/**
+ * A top-level `<Name>Input`/`<Name>Output` declaration: an absent schema →
+ * `unknown`, a plain object → an `interface`, anything else (a `oneOf` above
+ * all, which begins with `{` too) → a `type` alias. Same decision as the
+ * workflow generator, through the shared descriptor rather than a heuristic.
+ */
+function renderTypeDecl(name, schema) {
+    if (schema === undefined)
+        return renderTypeAlias(name, atom("unknown"));
+    const node = schemaToTypeNode(schema);
+    if (node.kind === "block" && !describeSchema(schema).oneOf) {
+        return `export interface ${name} ${printType(node, 0, 0)}`;
+    }
+    return renderTypeAlias(name, node);
+}
+/**
+ * `renderTypeDecl` for one declared field, with a failure that names the file
+ * and the field (CR3281-004).
+ *
+ * The shared renderer refuses a schema it cannot type — a `oneOf` of objects
+ * with no usable discriminator, above all — by throwing a plain `Error` that
+ * says "workflows codegen" and names neither. Push catches
+ * `FunctionSchemaCodegenError` per tree and lets the rest of it land, so an
+ * unconverted throw took the whole command down before a single healthy
+ * function was sent, over a file the author could not identify from the
+ * message.
+ */
+function renderDeclaredType(fn, field) {
+    const name = field === "inputSchema" ? fn.inputTypeName : fn.outputTypeName;
+    const schema = field === "inputSchema" ? fn.inputSchema : fn.outputSchema;
+    try {
+        return renderTypeDecl(name, schema);
+    }
+    catch (error) {
+        if (error instanceof FunctionSchemaCodegenError)
+            throw error;
+        throw new FunctionSchemaCodegenError(`${fn.fileLabel}: \`${field}\` cannot be rendered as a TypeScript type ` +
+            `(${error?.message ?? error})`);
+    }
+}
+const DECLARATION_HEADER = `// GENERATED by \`primitive config push\` from functions/*.toml.
+// DO NOT EDIT — your changes are overwritten on the next push.
+//
+// It gives \`defineFunction("<key>", handler)\` its types: \`input\` is the
+// function's declared inputSchema and the return is checked against its
+// declared outputSchema. A key this tree does not declare is a compile error.
+// The client-side invokers are the \`generated/<key>.generated.ts\` files beside
+// this one.
+`;
+/**
+ * The declaration for a whole tree's functions. Sorted by key so the bytes
+ * depend on the files and not on the order they were read in. The
+ * augmentation is emitted even when the tree has no function yet: an empty
+ * `FunctionSchemas` keeps `FunctionKeys` open (`string`), so nothing breaks.
+ */
+export function renderFunctionSchemasDeclaration(sources) {
+    const functions = describeAll(sources).map((entry) => entry.fn);
+    const lines = [DECLARATION_HEADER];
+    for (const fn of functions) {
+        lines.push(renderDeclaredType(fn, "inputSchema"));
+        lines.push("");
+        lines.push(renderDeclaredType(fn, "outputSchema"));
+        lines.push("");
+    }
+    if (functions.length === 0) {
+        lines.push("export interface PrimitiveFunctionSchemas {}");
+    }
+    else {
+        lines.push("export interface PrimitiveFunctionSchemas {");
+        for (const fn of functions) {
+            lines.push(`  ${JSON.stringify(fn.key)}: {`);
+            lines.push(`    input: ${fn.inputTypeName};`);
+            lines.push(`    output: ${fn.outputTypeName};`);
+            lines.push(`    mode: ${JSON.stringify(fn.mode)};`);
+            lines.push(`  };`);
+        }
+        lines.push("}");
+    }
+    lines.push("");
+    lines.push(`declare module "primitive-functions" {`);
+    lines.push(`  interface FunctionSchemas extends PrimitiveFunctionSchemas {}`);
+    lines.push(`}`);
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * The invoker factory for one function — the verbs its mode allows and
+ * nothing else, so the wrong verb is a compile error, not a runtime
+ * `FUNCTION_MODE_MISMATCH`.
+ *
+ * `invoke`/`start` take the key POSITIONALLY (`client.functions.<verb>(key,
+ * opts)`), so the key cannot ride in through `opts`; `terminate` addresses a
+ * run by a ref object, where the spread comes first and the pinned key last —
+ * a caller passing a ref variable carrying another key still terminates this
+ * function's run.
+ */
+function renderFactory(fn) {
+    const keyLiteral = tsStringLiteral(fn.key);
+    const inputMember = fn.inputRequired
+        ? `input: ${fn.inputTypeName}`
+        : `input?: ${fn.inputTypeName}`;
+    const lines = [
+        renderParenList(`export function ${fn.factoryName}`, ["client: JsBaoClient"], " {", 0),
+        `  return {`,
+    ];
+    // `opts: { input: X } & Omit<<Options><X>, "input">` — always broken onto its
+    // own line: the shortest possible form is already wider than 80 columns.
+    const optsParam = (optionsTypeName) => {
+        const node = intersection([
+            objectType([inputMember]),
+            generic("Omit", [
+                generic(optionsTypeName, [atom(fn.inputTypeName)]),
+                union([atom(`"input"`)]),
+            ]),
+        ]);
+        const head = `${indent(3)}opts: `;
+        return `${head}${printType(node, head.length, 3, 1)},`;
+    };
+    const invocation = (method, typeArgs, optionsTypeName) => renderArrowCall({
+        head: [`${indent(2)}${method}: (`, optsParam(optionsTypeName), `${indent(2)}) =>`].join("\n"),
+        callee: generic(`client.functions.${method}`, typeArgs.map(atom)),
+        leadingArgs: [keyLiteral],
+        objectMembers: ["...opts"],
+        level: 3,
+        tail: ",",
+    });
+    if (fn.mode === "request") {
+        lines.push(invocation("invoke", [fn.outputTypeName, fn.inputTypeName], "FunctionInvokeOptions"));
+    }
+    else {
+        lines.push(invocation("start", [fn.inputTypeName], "FunctionStartOptions"));
+        lines.push(renderArrowProperty({
+            level: 2,
+            key: "getStatus",
+            params: ["runId: string"],
+            signatureTail: " =>",
+            callee: generic("client.functions.getStatus", [atom(fn.outputTypeName)]),
+            leadingArgs: ["runId"],
+            tail: ",",
+        }));
+        lines.push(renderArrowProperty({
+            level: 2,
+            key: "waitFor",
+            params: ["runId: string", "options?: WaitForWorkflowOptions"],
+            signatureTail: " =>",
+            callee: generic("client.functions.waitFor", [atom(fn.outputTypeName)]),
+            leadingArgs: ["runId", "options"],
+            tail: ",",
+        }));
+        lines.push(renderArrowProperty({
+            level: 2,
+            key: "terminate",
+            params: [`ref: Omit<FunctionRunRef, "functionKey">`],
+            signatureTail: " =>",
+            callee: generic("client.functions.terminate", [atom(fn.outputTypeName)]),
+            leadingArgs: [],
+            objectMembers: ["...ref", { key: "functionKey", value: keyLiteral }],
+            tail: ",",
+        }));
+    }
+    lines.push(`  };`, `}`);
+    return lines.join("\n");
+}
+/**
+ * `import type { … } from "js-bao-wss-client"`, the way Prettier prints it:
+ * on one line when it fits, one specifier per line (trailing comma) when not.
+ */
+function renderImport(names) {
+    const inline = `import type { ${names.join(", ")} } from "${CLIENT_PACKAGE}";`;
+    if (inline.length <= 80)
+        return inline;
+    return `import type {\n${names.map((i) => `  ${i},`).join("\n")}\n} from "${CLIENT_PACKAGE}";`;
+}
+/**
+ * The full `<key>.generated.ts` for one function. Pure — exported so tests
+ * can assert on the string directly.
+ */
+export function renderFunctionInvokerFile(source) {
+    const fn = describeFunctionSchemas(source);
+    const fingerprint = fingerprintToml(source.tomlContent);
+    // Only the option types the mode's verbs reference, so the file compiles
+    // under a consumer's `noUnusedLocals`.
+    const imports = fn.mode === "request"
+        ? ["FunctionInvokeOptions", "JsBaoClient"]
+        : ["FunctionRunRef", "FunctionStartOptions", "JsBaoClient", "WaitForWorkflowOptions"];
+    const blocks = [
+        [
+            `// AUTO-GENERATED FROM ${fn.fileLabel} — DO NOT EDIT.`,
+            "// Run `primitive functions codegen` to regenerate.",
+            `// fingerprint: ${fingerprint}`,
+        ].join("\n"),
+        renderImport(imports),
+        renderDeclaredType(fn, "inputSchema"),
+        renderDeclaredType(fn, "outputSchema"),
+        renderFactory(fn),
+    ];
+    return { key: fn.key, content: blocks.join("\n\n") + "\n" };
+}
+/**
+ * Every invoker for a tree, keyed by the file name the generator writes
+ * (`<key>.generated.ts`), with the identifier-collision refusal applied
+ * across the set.
+ */
+export function renderFunctionInvokers(sources) {
+    // `describeAll` is the collision check; the per-file render repeats the
+    // (cheap) parse rather than threading the IR through.
+    return describeAll(sources).map(({ fn, source }) => ({
+        fileName: `${fn.key}${GENERATED_FILE_SUFFIX}`,
+        content: renderFunctionInvokerFile(source).content,
+    }));
+}
+//# sourceMappingURL=function-schema-codegen.js.map

package/dist/src/lib/function-schema-codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-schema-codegen.js","sourceRoot":"","sources":["../../../src/lib/function-schema-codegen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,mBAAmB,GAEpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AACnF,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EACL,IAAI,EACJ,OAAO,EACP,MAAM,EACN,YAAY,EACZ,UAAU,EACV,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,eAAe,EACf,KAAK,GACN,MAAM,oCAAoC,CAAC;AAE5C,oEAAoE;AACpE,MAAM,CAAC,MAAM,+BAA+B,GAAG,+BAA+B,CAAC;AAE/E,qFAAqF;AACrF,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC;AAEjD,iFAAiF;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAErD,6DAA6D;AAC7D,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAE3C,MAAM,OAAO,0BAA2B,SAAQ,KAAK;CAAG;AAYxD;;;;;;;;;;;;;;GAcG;AACH,SAAS,kBAAkB,CAAC,MAA4B,EAAE,KAAU;IAClE,OAAO,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;AACrD,CAAC;AAoBD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+EAA+E;AAC/E,SAAS,SAAS,CAAC,MAA4B;IAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IACtD,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA4B;IAClE,IAAI,KAAU,CAAC;IACf,IAAI,CAAC;QACH,KAAK,GAAI,eAAe,CAAC,MAAM,CAAC,WAAW,CAAS,EAAE,QAAQ,IAAI,EAAE,CAAC;IACvE,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,IAAI,0BAA0B,CAClC,GAAG,SAAS,CAAC,MAAM,CAAC,sCAAsC,KAAK,EAAE,OAAO,IAAI,KAAK,GAAG,CACrF,CAAC;IACJ,CAAC;IACD,2EAA2E;IAC3E,sDAAsD;IACtD,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE9C,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/E,IAAI,IAAI,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,0BAA0B,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,KAAqC,EAAW,EAAE;QAChE,IAAI,CAAC;YACH,OAAO,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,IAAI,0BAA0B,CAClC,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,KAAK,yBAAyB,KAAK,EAAE,OAAO,IAAI,KAAK,GAAG,CACpF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IAE5C,MAAM,YAAY,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO;QACL,GAAG;QACH,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC;QAC5B,WAAW;QACX,YAAY;QACZ,aAAa,EAAE,WAAW,KAAK,SAAS,IAAI,wBAAwB,CAAC,WAAW,CAAC;QACjF,YAAY;QACZ,aAAa,EAAE,GAAG,YAAY,OAAO;QACrC,cAAc,EAAE,GAAG,YAAY,QAAQ;QACvC,WAAW,EAAE,mBAAmB,CAAC,GAAG,CAAC;KACtC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAClB,OAAwC;IAExC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7F,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,sEAAsE;IACtE,gEAAgE;IAChE,0EAA0E;IAC1E,gEAAgE;IAChE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IACtD,KAAK,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,0BAA0B,CAClC,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,SAAS,CAAC,MAAM,CAAC,6BAA6B;gBACvE,QAAQ,EAAE,CAAC,GAAG,wDAAwD;gBACtE,oBAAoB,CACvB,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,SAAS,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;QAC9C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC;YAC5C,MAAM,IAAI,0BAA0B,CAClC,kBAAkB,KAAK,UAAU,EAAE,CAAC,GAAG,iCAAiC;gBACtE,KAAK,EAAE,CAAC,YAAY,iEAAiE,CACxF,CAAC;QACJ,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,IAAY,EAAE,MAAe;IACnD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3D,OAAO,oBAAoB,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,kBAAkB,CACzB,EAAoB,EACpB,KAAqC;IAErC,MAAM,IAAI,GAAG,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC;IAC5E,MAAM,MAAM,GAAG,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC;IAC1E,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,KAAK,YAAY,0BAA0B;YAAE,MAAM,KAAK,CAAC;QAC7D,MAAM,IAAI,0BAA0B,CAClC,GAAG,EAAE,CAAC,SAAS,OAAO,KAAK,6CAA6C;YACtE,IAAI,KAAK,EAAE,OAAO,IAAI,KAAK,GAAG,CACjC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,kBAAkB,GAAG;;;;;;;;CAQ1B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAAwC;IAExC,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChE,MAAM,KAAK,GAAa,CAAC,kBAAkB,CAAC,CAAC;IAC7C,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC1D,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,aAAa,GAAG,CAAC,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,cAAc,GAAG,CAAC,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,aAAa,CAAC,EAAoB;IACzC,MAAM,UAAU,GAAG,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,EAAE,CAAC,aAAa;QAClC,CAAC,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE;QAC9B,CAAC,CAAC,WAAW,EAAE,CAAC,aAAa,EAAE,CAAC;IAClC,MAAM,KAAK,GAAa;QACtB,eAAe,CAAC,mBAAmB,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACtF,YAAY;KACb,CAAC;IAEF,8EAA8E;IAC9E,yEAAyE;IACzE,MAAM,SAAS,GAAG,CAAC,eAAuB,EAAU,EAAE;QACpD,MAAM,IAAI,GAAG,YAAY,CAAC;YACxB,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;YACzB,OAAO,CAAC,MAAM,EAAE;gBACd,OAAO,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;gBAClD,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;aACzB,CAAC;SACH,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAClC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC;IACzD,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,QAAkB,EAAE,eAAuB,EAAU,EAAE,CACzF,eAAe,CAAC;QACd,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,EAAE,SAAS,CAAC,eAAe,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7F,MAAM,EAAE,OAAO,CAAC,oBAAoB,MAAM,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjE,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,aAAa,EAAE,CAAC,SAAS,CAAC;QAC1B,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,GAAG;KACV,CAAC,CAAC;IAEL,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC;IACnG,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CACR,mBAAmB,CAAC;YAClB,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,WAAW;YAChB,MAAM,EAAE,CAAC,eAAe,CAAC;YACzB,aAAa,EAAE,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,4BAA4B,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;YACxE,WAAW,EAAE,CAAC,OAAO,CAAC;YACtB,IAAI,EAAE,GAAG;SACV,CAAC,CACH,CAAC;QACF,KAAK,CAAC,IAAI,CACR,mBAAmB,CAAC;YAClB,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,CAAC,eAAe,EAAE,kCAAkC,CAAC;YAC7D,aAAa,EAAE,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,0BAA0B,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;YACtE,WAAW,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;YACjC,IAAI,EAAE,GAAG;SACV,CAAC,CACH,CAAC;QACF,KAAK,CAAC,IAAI,CACR,mBAAmB,CAAC;YAClB,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,WAAW;YAChB,MAAM,EAAE,CAAC,0CAA0C,CAAC;YACpD,aAAa,EAAE,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,4BAA4B,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;YACxE,WAAW,EAAE,EAAE;YACf,aAAa,EAAE,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;YACpE,IAAI,EAAE,GAAG;SACV,CAAC,CACH,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,KAAwB;IAC5C,MAAM,MAAM,GAAG,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,cAAc,IAAI,CAAC;IAC/E,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IACvC,OAAO,kBAAkB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,cAAc,IAAI,CAAC;AACjG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAA4B;IAE5B,MAAM,EAAE,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAExD,yEAAyE;IACzE,uCAAuC;IACvC,MAAM,OAAO,GACX,EAAE,CAAC,IAAI,KAAK,SAAS;QACnB,CAAC,CAAC,CAAC,uBAAuB,EAAE,aAAa,CAAC;QAC1C,CAAC,CAAC,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,aAAa,EAAE,wBAAwB,CAAC,CAAC;IAE1F,MAAM,MAAM,GAAa;QACvB;YACE,0BAA0B,EAAE,CAAC,SAAS,iBAAiB;YACvD,qDAAqD;YACrD,mBAAmB,WAAW,EAAE;SACjC,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,YAAY,CAAC,OAAO,CAAC;QACrB,kBAAkB,CAAC,EAAE,EAAE,aAAa,CAAC;QACrC,kBAAkB,CAAC,EAAE,EAAE,cAAc,CAAC;QACtC,aAAa,CAAC,EAAE,CAAC;KAClB,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAwC;IAExC,wEAAwE;IACxE,sDAAsD;IACtD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACnD,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,qBAAqB,EAAE;QAC7C,OAAO,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,OAAO;KACnD,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/src/lib/function-sync.d.ts

@@ -31,6 +31,7 @@
  * directory inside the tree, so the write step resolves the real path one last
  * time and refuses a destination that lands outside the real root.
  */
+import { type FunctionMode, type TriggerDeclaration } from "./generated-config-surfaces.js";
 import { type FunctionManifest as CollectedManifest } from "./function-collect.js";
 /**
  * Collect one function's manifest, or answer from this command's memo.
@@ -47,6 +48,26 @@ export declare function collectManifestForBundle(options: {
     /** The built bundle's source, for the static scan (#3279). */
     bundle?: string;
 }): Promise<CollectedManifest>;
+/**
+ * The server's own `[function.triggers.*]` rules, applied to a parsed
+ * `[function]` table, with "nothing declared" spelled as null so a caller can
+ * skip the work.
+ *
+ * `normalizeTriggerDeclaration` comes from `generated-config-surfaces.ts` —
+ * `src/config-surface/trigger-declaration.ts` vendored verbatim. Until #3320
+ * the CLI ran a hand-written restatement of those rules
+ * (`cli/src/lib/function-triggers.ts`), kept in step only by a paired-fixture
+ * test; the artifact's `--check` makes drift a build failure instead.
+ *
+ * One check is the CLI's OWN and is deliberately not on that path: the cron
+ * expression's field count. The authority for cron grammar is the server's
+ * `src/cron-parser.ts` (`parseCron`, run at the push boundary), which the
+ * declaration rules never call — so this is a shape precheck that turns the
+ * commonest typo into a named local error, not a second copy of a rule.
+ */
+export declare function normalizeFunctionTriggers(functionTable: any, options?: {
+    mode?: FunctionMode;
+}): TriggerDeclaration | null;
 export interface FunctionConfigPush {
     entry: string;
     /** base64 of the authored `functions/<key>.toml` bytes. */
@@ -65,15 +86,62 @@ export interface FunctionConfigPush {
     manifest: string | null;
     /** The number BOTH sides compare to decide "is this a no-op?". */
     envelopeHash: string;
+    /** `mode = "request" | "task"` (#3281), resolved from the file's two spellings. */
+    mode: FunctionMode;
+    /**
+     * The same resolution as `mode`, in the alias's spelling: a new CLI against
+     * a server that predates `mode` still pushes a task function as a task.
+     */
     durable: boolean;
     limits?: Record<string, unknown>;
 }
+/**
+ * Resolve the file's mode — `mode`, its alias `durable`, or neither — through
+ * the ONE vendored rule (#3281). A disagreement or an unknown word is a
+ * `FunctionBuildError` naming the function, like every other preflight
+ * refusal, so nothing is built or sent for that file.
+ */
+export declare function resolveFunctionMode(functionKey: string, table: any): FunctionMode;
+/**
+ * Everything about one `functions/<key>.toml` that `config push` can decide
+ * from the file alone (#3320).
+ *
+ * This is the seam the issue is about. These checks used to run inside the
+ * APPLY loop, so a `durable = true` beside a webhook block — or a missing
+ * `entry`, or a signed scheme with no `signingSecret` — was raised after app
+ * settings, vars, integrations, webhooks, cron triggers and database types had
+ * already been written, while the command's own framing promised that a
+ * refusal meant nothing was applied. Running them in the front-loaded pass
+ * (#976) makes that framing true for this class of error.
+ *
+ * Every rule here is the SERVER's, reached through the generated surface
+ * artifact (#3320 part 0), not a local imitation of it. What is deliberately
+ * absent is app-state-dependent by construction: whether the referenced secret
+ * exists, whether the scheme's `config` is valid under this environment's JWKS
+ * policy, per-app caps, key collisions, archived tombstones. A local guess at
+ * any of those would be a preflight that gives a false all-clear.
+ *
+ * Returns the messages the apply loop would have raised, verbatim — so the
+ * author reads the same sentence wherever it reaches them, and `config diff`
+ * can report it under Invalid (#2880 symmetry).
+ */
+export declare function functionTomlPreflightErrors(options: {
+    filePath: string;
+    functionKey: string;
+    /** The already-parsed document, so the file is read once. */
+    tomlData: any;
+}): string[];
 /**
  * Build everything the config-version route needs for one function file.
  *
  * Throws `FunctionBuildError` for a missing `entry`, a missing entry file, a
  * build error, or an import that escapes the config tree — one class, so the
  * push loop has one thing to report and pushes nothing for that function.
+ *
+ * The file-decidable checks are `functionTomlPreflightErrors`', kept here as
+ * defense in depth (#3179's dual-validation shape): `config push` runs them in
+ * its preflight now, but `functions` commands and a direct caller reach this
+ * function without one.
  */
 export declare function buildFunctionConfigPush(options: {
     configDir: string;
@@ -93,11 +161,21 @@ export declare function buildFunctionCreatePayload(functionKey: string, table: a
  * The update body. The key is NOT re-sent — it is the function's claim on the
  * app's single key namespace and the URL already names the row — and `status`
  * is server-owned on the sixth carrying type as on the other five.
+ *
+ * #3317 — the schemas are TOML-owned on exactly the terms `description` is
+ * (#1567), which is what prompts have sent since then: the update handler
+ * preserves a field the body omits, so dropping the key would leave a schema
+ * live that the file no longer declares, and the comparison — which reads an
+ * absent schema as `null` — would report that difference again on every run.
+ * Removing `[function.inputSchema]` clears it, and the next diff is Synced.
  */
 export declare function buildFunctionUpdatePayload(table: any): Record<string, any>;
 /** The version-carried keys, as the config-version row holds them. */
 export interface ActiveFunctionVersion {
     entry?: string;
+    /** #3281 — serialized beside `durable` by a server that knows the word. */
+    mode?: string;
+    /** The stored column; the only thing an older server serializes. */
     durable?: boolean;
     /** JSON string on the row; an object is accepted too. */
     limits?: unknown;
@@ -109,10 +187,15 @@ export interface ActiveFunctionVersion {
  * created through the API that has never had code pushed. When bytes exist,
  * pull writes THOSE; this is the fallback that still produces a pushable file.
  */
-export declare function serializeFunction(record: any, active?: ActiveFunctionVersion): string;
+export declare function serializeFunction(record: any, active?: ActiveFunctionVersion, log?: (message: string) => void): string;
+/**
+ * The mode a server's config-version row is in, whichever of the two fields
+ * this server serializes: `mode` since #3281, `durable` before it.
+ */
+export declare function activeVersionMode(active?: ActiveFunctionVersion | null): FunctionMode;
 /**
  * The entity both sides of `config diff` are projected onto: the header's
- * authored fields plus the three keys the VERSION carries. Stated once so a
+ * authored fields plus the keys the VERSION carries. Stated once so a
  * local file and a server record cannot be read into different shapes.
  *
  * Text the server rewrites on the way in is read the same way it will come