primitive-admin 1.0.62 → 1.0.64

package/dist/src/lib/swift-codegen/functionGenerator.d.ts

@@ -0,0 +1,139 @@
+/**
+ * `functions codegen --lang swift` — the third CLI Swift generator (#3344).
+ *
+ * The Swift counterpart of `function-schema-codegen.ts`'s TypeScript invoker,
+ * and the sibling of `generator.ts` (workflows) and `dbGenerator.ts`
+ * (database types). Reads the SAME `functions/<key>.toml` files and emits one
+ * `<key>.generated.swift` per function carrying:
+ *
+ *   - `<Key>Input` / `<Key>Output`, rendered from the declared schemas by the
+ *     shared `renderSwiftRootType` — the same drift-guarded descriptor the
+ *     server validates with, so a generated Swift type can never promise a
+ *     shape an invocation door rejects; and
+ *   - `<Key>Function`, a typed invoker struct carrying every verb, plus a
+ *     free-function factory `<key>(client)`.
+ *
+ * ── Nothing about the function is re-derived here ────────────────────────
+ *
+ * Key, schemas and `inputRequired` all come from `describeFunctionSchemas` —
+ * the IR the TypeScript invoker reads — so the two clients can never disagree
+ * on what a function accepts or whether its input is required. Only Swift
+ * naming (through the workflow emitter's helpers) and Swift rendering happen
+ * in this file.
+ *
+ * ── Verbs ────────────────────────────────────────────────────────────────
+ *
+ * EVERY invoker gets `invoke` plus the four task verbs (`start`, `getStatus`,
+ * `waitFor`, `terminate`). It did once narrow the set by mode, so that the
+ * wrong verb was a compile error; #3482 retired that rule by making the ROUTE
+ * the runtime selector, and the mismatch is a `functionModeMismatch` thrown at
+ * runtime again. Only the INPUT SHAPE is compile-checked here.
+ *
+ * `FUNCTION_INVOKER_VERBS_BY_MODE` below therefore no longer gates emission —
+ * it survives as the verb inventory the signature-parity test reads.
+ *
+ * Every parameter besides `input` mirrors the generic `FunctionsAPI` overload
+ * it delegates to, label, type and default alike — `meta: [String: Any]?`
+ * included. The goldens are app-target code, outside the client's `Any`
+ * budget scan, and the workflow goldens set that precedent. The tables below
+ * are the single source of those parameter lists, and
+ * `swift-codegen-function-signature-parity-3344.test.ts` ties them to the
+ * client's actual declarations so an option added to `FunctionsAPI` later
+ * cannot leave every generated invoker silently behind.
+ *
+ * ── The nullable root input ──────────────────────────────────────────────
+ *
+ * The generic overload maps a `nil` input to an OMITTED `rootInput`, which the
+ * server defaults to `{}` — rejected by a schema that allows only a string or
+ * null. So when the rendered root input type is itself Optional, the generated
+ * body BRANCHES: a value delegates the typed value directly (keeping
+ * `JSONCoding`'s exact `Int64` path), and `nil` delegates `JSONValue.null`,
+ * which is a non-nil `Encodable` and reaches the wire as `rootInput: null`
+ * through the same forwarding path a scalar root already uses. Proved live
+ * before this emitter was written (#3344 step 0).
+ */
+import { type WriteOrCheckResult } from "../codegen-shared/generatedFiles.js";
+import { type FunctionSchemaSource } from "../function-schema-codegen.js";
+import { FUNCTION_SWIFT_BANNER_PREFIX } from "./banners.js";
+import { type PromptSchemaSource } from "../prompt-schema-codegen.js";
+export { FUNCTION_SWIFT_BANNER_PREFIX };
+export interface FunctionInvokerParameter {
+    /** The argument label as the generated method spells it. */
+    label: string;
+    /**
+     * The Swift type, or `null` for the `input` parameter — whose type is bound
+     * per key from the declared schema and whose optionality is the IR's
+     * `inputRequired`, so a literal type comparison against the client's
+     * `Input?` would be meaningless.
+     */
+    type: string | null;
+    /** The default expression, or `null` for a parameter with no default. */
+    defaultValue: string | null;
+}
+export interface FunctionInvokerVerb {
+    /** The method the generated invoker declares. */
+    verb: string;
+    /**
+     * How the verb's parameters are normalized against the client before they
+     * are compared (spec decision 15):
+     *   - `overload`: the typed `FunctionsAPI` method of the same name, minus
+     *     the pinned function-key parameter and any internally bound output
+     *     witness.
+     *   - `ref`: `FunctionRunRef`'s initializer, minus `functionKey` — the
+     *     client takes one ref where the generated wrapper takes its fields.
+     */
+    comparedAgainst: {
+        kind: "overload";
+        method: string;
+        dropLabels: string[];
+    } | {
+        kind: "ref";
+        type: string;
+        dropLabels: string[];
+    };
+    parameters: FunctionInvokerParameter[];
+}
+/**
+ * The verb tables. `invoke` is a request function's whole surface; the other
+ * four are a task function's.
+ */
+export declare const FUNCTION_INVOKER_VERBS: Record<string, FunctionInvokerVerb>;
+/**
+ * The verb inventory, grouped by the mode that once gated it.
+ *
+ * #3454 made `any` the default, exposing BOTH sets because the runner is
+ * chosen at call time; each lock then exposed only its own. #3482 retired the
+ * gating entirely — the ROUTE is the runtime selector, and every invoker is
+ * emitted with every verb (see the header, and the emission site). Nothing
+ * reads this to DECIDE what to emit any more; the signature-parity test reads
+ * it as the list of verbs whose parameters must match `FunctionsAPI`.
+ */
+export declare const FUNCTION_INVOKER_VERBS_BY_MODE: Record<string, string[]>;
+/**
+ * Render the full `<key>.generated.swift` content for one `functions/*.toml`.
+ * Pure — exported so tests can assert on the string directly.
+ */
+export declare function renderFunctionSwiftFile(source: FunctionSchemaSource): {
+    key: string;
+    content: string;
+    symbols: string[];
+};
+export interface GenerateFunctionSwiftTypesOptions {
+    inputs: readonly FunctionSchemaSource[];
+    /**
+     * #3798 — the tree's prompt sources. Each `kind = "agent"` prompt among them
+     * gets a `<key>.agent.generated.swift` in the same output directory, owned
+     * by this run (`agentGenerator.ts`); every other prompt is ignored.
+     */
+    agentInputs?: readonly PromptSchemaSource[];
+    /** Directory where the `<key>.generated.swift` files are written. */
+    outputDir: string;
+    /** `--check`: compare against disk, do not write. */
+    check?: boolean;
+}
+/**
+ * Run Swift function codegen end-to-end. The whole `functions/` directory is
+ * always the input (there is no `--single` form), so the run owns its output
+ * directory's functions-banner files completely and sweeps the orphans.
+ */
+export declare function generateFunctionSwiftTypes(options: GenerateFunctionSwiftTypesOptions): Promise<WriteOrCheckResult>;

package/dist/src/lib/swift-codegen/functionGenerator.js

@@ -0,0 +1,462 @@
+/**
+ * `functions codegen --lang swift` — the third CLI Swift generator (#3344).
+ *
+ * The Swift counterpart of `function-schema-codegen.ts`'s TypeScript invoker,
+ * and the sibling of `generator.ts` (workflows) and `dbGenerator.ts`
+ * (database types). Reads the SAME `functions/<key>.toml` files and emits one
+ * `<key>.generated.swift` per function carrying:
+ *
+ *   - `<Key>Input` / `<Key>Output`, rendered from the declared schemas by the
+ *     shared `renderSwiftRootType` — the same drift-guarded descriptor the
+ *     server validates with, so a generated Swift type can never promise a
+ *     shape an invocation door rejects; and
+ *   - `<Key>Function`, a typed invoker struct carrying every verb, plus a
+ *     free-function factory `<key>(client)`.
+ *
+ * ── Nothing about the function is re-derived here ────────────────────────
+ *
+ * Key, schemas and `inputRequired` all come from `describeFunctionSchemas` —
+ * the IR the TypeScript invoker reads — so the two clients can never disagree
+ * on what a function accepts or whether its input is required. Only Swift
+ * naming (through the workflow emitter's helpers) and Swift rendering happen
+ * in this file.
+ *
+ * ── Verbs ────────────────────────────────────────────────────────────────
+ *
+ * EVERY invoker gets `invoke` plus the four task verbs (`start`, `getStatus`,
+ * `waitFor`, `terminate`). It did once narrow the set by mode, so that the
+ * wrong verb was a compile error; #3482 retired that rule by making the ROUTE
+ * the runtime selector, and the mismatch is a `functionModeMismatch` thrown at
+ * runtime again. Only the INPUT SHAPE is compile-checked here.
+ *
+ * `FUNCTION_INVOKER_VERBS_BY_MODE` below therefore no longer gates emission —
+ * it survives as the verb inventory the signature-parity test reads.
+ *
+ * Every parameter besides `input` mirrors the generic `FunctionsAPI` overload
+ * it delegates to, label, type and default alike — `meta: [String: Any]?`
+ * included. The goldens are app-target code, outside the client's `Any`
+ * budget scan, and the workflow goldens set that precedent. The tables below
+ * are the single source of those parameter lists, and
+ * `swift-codegen-function-signature-parity-3344.test.ts` ties them to the
+ * client's actual declarations so an option added to `FunctionsAPI` later
+ * cannot leave every generated invoker silently behind.
+ *
+ * ── The nullable root input ──────────────────────────────────────────────
+ *
+ * The generic overload maps a `nil` input to an OMITTED `rootInput`, which the
+ * server defaults to `{}` — rejected by a schema that allows only a string or
+ * null. So when the rendered root input type is itself Optional, the generated
+ * body BRANCHES: a value delegates the typed value directly (keeping
+ * `JSONCoding`'s exact `Int64` path), and `nil` delegates `JSONValue.null`,
+ * which is a non-nil `Encodable` and reaches the wire as `rootInput: null`
+ * through the same forwarding path a scalar root already uses. Proved live
+ * before this emitter was written (#3344 step 0).
+ */
+import * as path from "path";
+import { writeOrCheckGeneratedFiles, } from "../codegen-shared/generatedFiles.js";
+import { fingerprintToml } from "../db-codegen/dbFingerprint.js";
+import { describeFunctionSchemas, describeFunctionSchemaSet, FunctionSchemaCodegenError, } from "../function-schema-codegen.js";
+import { renderSwiftRootTypeDetail, SwiftCodegenError } from "./schemaToSwift.js";
+import { workflowSwiftFactoryName } from "./swiftNaming.js";
+import { GENERATED_SWIFT_FILE_SUFFIX, SWIFT_BANNER_PREFIX, swiftKeyLiteral, workflowSwiftTypeBaseName, } from "./generator.js";
+import { DB_SWIFT_BANNER_PREFIXES } from "./dbGenerator.js";
+import { AGENT_SWIFT_BANNER_PREFIX, FUNCTION_SWIFT_BANNER_PREFIX, } from "./banners.js";
+import { AGENT_SWIFT_FILE_SUFFIX, renderAgentSwiftFile, } from "./agentGenerator.js";
+import { describePromptSchema, } from "../prompt-schema-codegen.js";
+import { assertNoForeignGeneratorSymbolCollision, parseTopLevelSwiftSymbols, } from "./siblingSymbols.js";
+export { FUNCTION_SWIFT_BANNER_PREFIX };
+/** The Swift module the generated types + invoker import. */
+const CLIENT_MODULE = "JsBaoClient";
+const INDENT = "    ";
+/** Banners owned by the OTHER two Swift generators, in every spelling. */
+const FOREIGN_SWIFT_BANNERS = [SWIFT_BANNER_PREFIX, ...DB_SWIFT_BANNER_PREFIXES];
+const INPUT_PARAMETER = {
+    label: "input",
+    type: null,
+    defaultValue: null,
+};
+/**
+ * The verb tables. `invoke` is a request function's whole surface; the other
+ * four are a task function's.
+ */
+export const FUNCTION_INVOKER_VERBS = {
+    invoke: {
+        verb: "invoke",
+        comparedAgainst: { kind: "overload", method: "invoke", dropLabels: ["functionKey"] },
+        parameters: [
+            INPUT_PARAMETER,
+            { label: "contextDocId", type: "String?", defaultValue: "nil" },
+            { label: "meta", type: "[String: Any]?", defaultValue: "nil" },
+            { label: "timeout", type: "TimeInterval?", defaultValue: "nil" },
+        ],
+    },
+    start: {
+        verb: "start",
+        comparedAgainst: { kind: "overload", method: "start", dropLabels: ["functionKey"] },
+        parameters: [
+            INPUT_PARAMETER,
+            { label: "runKey", type: "String?", defaultValue: "nil" },
+            { label: "contextDocId", type: "String?", defaultValue: "nil" },
+            { label: "meta", type: "[String: Any]?", defaultValue: "nil" },
+        ],
+    },
+    getStatus: {
+        verb: "getStatus",
+        comparedAgainst: { kind: "overload", method: "getStatus", dropLabels: [] },
+        parameters: [{ label: "runId", type: "String", defaultValue: null }],
+    },
+    waitFor: {
+        verb: "waitFor",
+        // `as:` is the output witness the generated method binds itself.
+        comparedAgainst: { kind: "overload", method: "waitFor", dropLabels: ["as"] },
+        parameters: [
+            { label: "runId", type: "String", defaultValue: null },
+            { label: "options", type: "FunctionWaitOptions?", defaultValue: "nil" },
+        ],
+    },
+    terminate: {
+        verb: "terminate",
+        comparedAgainst: { kind: "ref", type: "FunctionRunRef", dropLabels: ["functionKey"] },
+        parameters: [
+            { label: "runKey", type: "String", defaultValue: null },
+            { label: "contextDocId", type: "String?", defaultValue: "nil" },
+        ],
+    },
+};
+/**
+ * The verb inventory, grouped by the mode that once gated it.
+ *
+ * #3454 made `any` the default, exposing BOTH sets because the runner is
+ * chosen at call time; each lock then exposed only its own. #3482 retired the
+ * gating entirely — the ROUTE is the runtime selector, and every invoker is
+ * emitted with every verb (see the header, and the emission site). Nothing
+ * reads this to DECIDE what to emit any more; the signature-parity test reads
+ * it as the list of verbs whose parameters must match `FunctionsAPI`.
+ */
+export const FUNCTION_INVOKER_VERBS_BY_MODE = {
+    request: ["invoke"],
+    task: ["start", "getStatus", "waitFor", "terminate"],
+    any: ["invoke", "start", "getStatus", "waitFor", "terminate"],
+};
+function parseFunction(source) {
+    const ir = describeFunctionSchemas(source);
+    const base = workflowSwiftTypeBaseName(ir.key);
+    const inputTypeName = `${base}Input`;
+    const outputTypeName = `${base}Output`;
+    // The banner and every schema failure name the FILE, which an authored
+    // `[function] key` can spell differently from the key (E1).
+    const sourceFile = ir.fileLabel;
+    const input = renderSwiftRootTypeDetail(inputTypeName, ir.inputSchema, { sourceFile });
+    const output = renderSwiftRootTypeDetail(outputTypeName, ir.outputSchema, { sourceFile });
+    return {
+        key: ir.key,
+        fileLabel: ir.fileLabel,
+        base,
+        inputTypeName,
+        outputTypeName,
+        structName: `${base}Function`,
+        factoryName: workflowSwiftFactoryName(ir.key),
+        inputRequired: ir.inputRequired,
+        inputOptionalRoot: input.optional,
+        inputDecl: input.decl,
+        outputDecl: output.decl,
+    };
+}
+/**
+ * The `input:` parameter declaration. An already-Optional root type is never
+ * wrapped a second time (spec decision 6) — the alias carries the optionality,
+ * and the branching body below gives its `nil` the meaning the schema gives it.
+ */
+function inputParameter(fn) {
+    if (fn.inputOptionalRoot) {
+        return fn.inputRequired
+            ? `input: ${fn.inputTypeName}`
+            : `input: ${fn.inputTypeName} = nil`;
+    }
+    return fn.inputRequired
+        ? `input: ${fn.inputTypeName}`
+        : `input: ${fn.inputTypeName}? = nil`;
+}
+/** `label: type = default` for a non-input parameter, from the verb table. */
+function renderParameter(parameter) {
+    const withDefault = parameter.defaultValue === null ? "" : ` = ${parameter.defaultValue}`;
+    return `${parameter.label}: ${parameter.type}${withDefault}`;
+}
+/**
+ * The delegation body for a verb that forwards `input`. When the root input
+ * type is Optional the body branches so a `nil` reaches the wire as the
+ * explicit `rootInput: null` the declaration allows, instead of being dropped
+ * into the client's "no input" path (which the server turns into `{}`).
+ */
+function renderForwardingBody(fn, indentLevel, call) {
+    const I = INDENT.repeat(indentLevel);
+    if (!fn.inputOptionalRoot)
+        return call("input", indentLevel);
+    return [
+        `${I}// \`${fn.inputTypeName}\` is Optional, so \`nil\` is the JSON \`null\` the`,
+        `${I}// declared schema allows — not "no input". Delegating \`nil\` would omit`,
+        `${I}// \`rootInput\`, which the server defaults to \`{}\`; \`JSONValue.null\``,
+        `${I}// travels as the null through the same path a scalar root uses.`,
+        `${I}if let input {`,
+        ...call("input", indentLevel + 1),
+        `${I}}`,
+        ...call("JSONValue.null", indentLevel),
+    ];
+}
+function renderInvoke(fn) {
+    const keyLiteral = swiftKeyLiteral(fn.key);
+    const table = FUNCTION_INVOKER_VERBS.invoke;
+    const I = INDENT;
+    const call = (inputExpr, level) => {
+        const B = INDENT.repeat(level);
+        const keyword = fn.inputOptionalRoot ? "return try await " : "try await ";
+        return [
+            `${B}${keyword}client.functions.invoke(`,
+            `${B}${INDENT}${keyLiteral},`,
+            `${B}${INDENT}input: ${inputExpr},`,
+            `${B}${INDENT}contextDocId: contextDocId,`,
+            `${B}${INDENT}meta: meta,`,
+            `${B}${INDENT}timeout: timeout`,
+            `${B})`,
+        ];
+    };
+    return [
+        ``,
+        `${I}/// Invoke the \`${fn.key}\` request function and wait for its result.`,
+        `${I}public func invoke(`,
+        `${I}${I}${inputParameter(fn)},`,
+        ...table.parameters
+            .slice(1)
+            .map((p, index, all) => `${I}${I}${renderParameter(p)}${index === all.length - 1 ? "" : ","}`),
+        `${I}) async throws -> FunctionResult<${fn.outputTypeName}> {`,
+        ...renderForwardingBody(fn, 2, call),
+        `${I}}`,
+    ];
+}
+function renderStart(fn) {
+    const keyLiteral = swiftKeyLiteral(fn.key);
+    const table = FUNCTION_INVOKER_VERBS.start;
+    const I = INDENT;
+    const call = (inputExpr, level) => {
+        const B = INDENT.repeat(level);
+        const keyword = fn.inputOptionalRoot ? "return try await " : "try await ";
+        return [
+            `${B}${keyword}client.functions.start(`,
+            `${B}${INDENT}${keyLiteral},`,
+            `${B}${INDENT}input: ${inputExpr},`,
+            `${B}${INDENT}runKey: runKey,`,
+            `${B}${INDENT}contextDocId: contextDocId,`,
+            `${B}${INDENT}meta: meta`,
+            `${B})`,
+        ];
+    };
+    return [
+        ``,
+        `${I}/// Start the \`${fn.key}\` task function; returns the run handle.`,
+        `${I}@discardableResult`,
+        `${I}public func start(`,
+        `${I}${I}${inputParameter(fn)},`,
+        ...table.parameters
+            .slice(1)
+            .map((p, index, all) => `${I}${I}${renderParameter(p)}${index === all.length - 1 ? "" : ","}`),
+        `${I}) async throws -> FunctionStartResult {`,
+        ...renderForwardingBody(fn, 2, call),
+        `${I}}`,
+    ];
+}
+function renderTaskPollers(fn) {
+    const I = INDENT;
+    const keyLiteral = swiftKeyLiteral(fn.key);
+    const waitFor = FUNCTION_INVOKER_VERBS.waitFor;
+    const terminate = FUNCTION_INVOKER_VERBS.terminate;
+    return [
+        ``,
+        `${I}/// A run's status, with \`output\` bound to \`${fn.outputTypeName}\`.`,
+        `${I}public func getStatus(${renderParameter(FUNCTION_INVOKER_VERBS.getStatus.parameters[0])}) async throws -> FunctionRunResult<${fn.outputTypeName}> {`,
+        `${I}${I}try await client.functions.getStatus(runId: runId)`,
+        `${I}}`,
+        ``,
+        `${I}/// Wait for a run to settle; \`output\` is bound to \`${fn.outputTypeName}\`.`,
+        `${I}public func waitFor(`,
+        ...waitFor.parameters.map((p, index, all) => `${I}${I}${renderParameter(p)}${index === all.length - 1 ? "" : ","}`),
+        `${I}) async throws -> FunctionRunResult<${fn.outputTypeName}> {`,
+        `${I}${I}try await client.functions.waitFor(`,
+        `${I}${I}${I}runId: runId,`,
+        `${I}${I}${I}as: ${fn.outputTypeName}.self,`,
+        `${I}${I}${I}options: options`,
+        `${I}${I})`,
+        `${I}}`,
+        ``,
+        `${I}/// Terminate a run; \`output\` is bound to \`${fn.outputTypeName}\` (a terminated`,
+        `${I}/// run can carry partial output). The function key is pinned.`,
+        `${I}@discardableResult`,
+        `${I}public func terminate(`,
+        ...terminate.parameters.map((p, index, all) => `${I}${I}${renderParameter(p)}${index === all.length - 1 ? "" : ","}`),
+        `${I}) async throws -> FunctionRunResult<${fn.outputTypeName}> {`,
+        `${I}${I}try await client.functions.terminate(`,
+        `${I}${I}${I}FunctionRunRef(`,
+        `${I}${I}${I}${I}functionKey: ${keyLiteral},`,
+        `${I}${I}${I}${I}runKey: runKey,`,
+        `${I}${I}${I}${I}contextDocId: contextDocId`,
+        `${I}${I}${I})`,
+        `${I}${I})`,
+        `${I}}`,
+    ];
+}
+/**
+ * The typed invoker struct + its free-function factory. Since #3482 every
+ * function carries BOTH verb sets: the config says nothing about how a
+ * function runs, and the caller picks the runtime at each call.
+ */
+function renderInvoker(fn) {
+    const lines = [
+        `/// Typed invoker for the \`${fn.key}\` function. Binds`,
+        `/// \`${fn.inputTypeName}\` / \`${fn.outputTypeName}\` over the generic`,
+        `/// \`FunctionsAPI\` overloads. Obtain one with \`${fn.factoryName}(client)\`.`,
+        `public struct ${fn.structName}: Sendable {`,
+        `${INDENT}public let client: JsBaoClient`,
+        ``,
+        `${INDENT}public init(client: JsBaoClient) {`,
+        `${INDENT}${INDENT}self.client = client`,
+        `${INDENT}}`,
+    ];
+    // #3482 — `invoke` first, then the four task verbs, for EVERY function.
+    lines.push(...renderInvoke(fn));
+    lines.push(...renderStart(fn), ...renderTaskPollers(fn));
+    lines.push(`}`);
+    lines.push(``, `/// Typed invoker factory for the \`${fn.key}\` function.`, `public func ${fn.factoryName}(_ client: JsBaoClient) -> ${fn.structName} {`, `${INDENT}${fn.structName}(client: client)`, `}`);
+    return lines.join("\n");
+}
+/**
+ * Render the full `<key>.generated.swift` content for one `functions/*.toml`.
+ * Pure — exported so tests can assert on the string directly.
+ */
+export function renderFunctionSwiftFile(source) {
+    const fn = parseFunction(source);
+    const fingerprint = fingerprintToml(source.tomlContent);
+    const banner = [
+        `${FUNCTION_SWIFT_BANNER_PREFIX}${fn.fileLabel.replace(/^functions\//, "")} — DO NOT EDIT.`,
+        "// Run `primitive functions codegen --lang swift` to regenerate.",
+        `// fingerprint: ${fingerprint}`,
+    ].join("\n");
+    const imports = ["import Foundation", `import ${CLIENT_MODULE}`].join("\n");
+    const content = [banner, imports, fn.inputDecl, fn.outputDecl, renderInvoker(fn)].join("\n\n") +
+        "\n";
+    return {
+        key: fn.key,
+        content,
+        // EVERY top-level declaration the file makes, read back off the rendered
+        // source rather than enumerated by hand (CR3344-001). The obvious four are
+        // `<Key>Input`/`<Key>Output`, the invoker struct and the factory — but a
+        // root that renders as a typealias (an array of objects, say) also declares
+        // its element type, `<Key>InputItem`, at module level. Enumerating the four
+        // left those helpers out of both the run-scoped registry and the
+        // cross-generator scan, so a database type or another function declaring
+        // the same symbol produced Swift that would not compile. This is also the
+        // exact parser the retained-sibling side uses, so the two halves of every
+        // comparison now speak one alphabet (backticks stripped included).
+        symbols: parseTopLevelSwiftSymbols(content),
+    };
+}
+/**
+ * Run Swift function codegen end-to-end. The whole `functions/` directory is
+ * always the input (there is no `--single` form), so the run owns its output
+ * directory's functions-banner files completely and sweeps the orphans.
+ */
+export async function generateFunctionSwiftTypes(options) {
+    const outAbs = path.resolve(options.outputDir);
+    // The shared set-level IR: sorted, and two files resolving to one key
+    // refused naming both (E2). The TS base-name check stays on the TS side —
+    // the registry below is the Swift run's own, and covers the invoker struct
+    // and the factory the TS check knows nothing about.
+    const described = describeFunctionSchemaSet(options.inputs);
+    const symbolOwner = new Map();
+    const filesToWrite = new Map();
+    for (const { source } of described) {
+        const rendered = renderFunctionSwiftFile(source);
+        for (const symbol of rendered.symbols) {
+            const prior = symbolOwner.get(symbol);
+            if (prior !== undefined && prior !== rendered.key) {
+                throw new SwiftCodegenError(`swift function codegen: type-name collision — function keys ` +
+                    `"${prior}" and "${rendered.key}" both produce Swift symbol ` +
+                    `"${symbol}", which redeclare when all .generated.swift files ` +
+                    `compile into one module. Rename one function key so the two differ ` +
+                    `after Swift normalization.`, { sourceFile: `functions/${rendered.key}.toml` });
+            }
+            symbolOwner.set(symbol, rendered.key);
+        }
+        filesToWrite.set(path.join(outAbs, `${rendered.key}${GENERATED_SWIFT_FILE_SUFFIX}`), rendered.content);
+    }
+    // #3798 — the agents' files, in the same registry and the same write: a
+    // symbol an agent and a function both declare is refused naming both.
+    for (const source of options.agentInputs ?? []) {
+        if (!isAgentPromptSource(source))
+            continue;
+        const rendered = renderAgentSwiftFile(source);
+        const owner = `prompt ${rendered.key}`;
+        for (const symbol of rendered.symbols) {
+            const prior = symbolOwner.get(symbol);
+            if (prior !== undefined && prior !== owner) {
+                throw new SwiftCodegenError(`swift function codegen: type-name collision — "${prior}" and ` +
+                    `"${owner}" both produce Swift symbol "${symbol}", which ` +
+                    `redeclare when all .generated.swift files compile into one ` +
+                    `module. Rename one key so the two differ after Swift normalization.`, { sourceFile: `prompts/${rendered.key}.toml` });
+            }
+            symbolOwner.set(symbol, owner);
+        }
+        filesToWrite.set(path.join(outAbs, `${rendered.key}${AGENT_SWIFT_FILE_SUFFIX}`), rendered.content);
+    }
+    // Cross-generator namespace collision (the #1857 scan, a third way round).
+    // A workflow- or database-owned sibling in the same directory declares its
+    // own top-level symbols; a full functions run does not regenerate them, so
+    // the two files coexist and redeclare once everything compiles into one
+    // module. The foreign-banner WRITE guard below is path-only and never sees
+    // it.
+    await assertNoForeignGeneratorSymbolCollision({
+        outputDir: outAbs,
+        foreignBanner: FOREIGN_SWIFT_BANNERS,
+        suffix: GENERATED_SWIFT_FILE_SUFFIX,
+        emitted: symbolOwner,
+        makeError: ({ symbol, owner, siblingStem }) => new SwiftCodegenError(`swift function codegen: type-name collision with another generator's ` +
+            `file — function key "${owner}" emits Swift symbol "${symbol}", but the ` +
+            `existing "${siblingStem}${GENERATED_SWIFT_FILE_SUFFIX}" (owned by the ` +
+            `workflow or database Swift generator) already declares a top-level ` +
+            `"${symbol}" in the same output directory, which redeclares when all ` +
+            `.generated.swift files compile into one module. Rename the function or ` +
+            `the "${siblingStem}" source so the two differ after Swift ` +
+            `normalization, or give one generator a separate -o directory.`, { sourceFile: `functions/${owner}.toml` }),
+    });
+    return await writeOrCheckGeneratedFiles({
+        outputDir: outAbs,
+        filesToWrite,
+        check: options.check,
+        fullOwnership: true,
+        generatedSuffix: GENERATED_SWIFT_FILE_SUFFIX,
+        // #3798 — the run owns the agents' files as well as the invokers.
+        ownershipBanner: [FUNCTION_SWIFT_BANNER_PREFIX, AGENT_SWIFT_BANNER_PREFIX],
+        foreignOwnershipBanners: FOREIGN_SWIFT_BANNERS,
+        onForeignBannerCollision: ({ filePath, foreignBanner }) => new SwiftCodegenError(`swift codegen: output collision — this run would overwrite ` +
+            `"${path.basename(filePath)}" in the shared output directory, which ` +
+            `is already owned by a different generator (banner ` +
+            `"${foreignBanner.trim()}"). A function key and a workflow key or ` +
+            `database type with the same name cannot share an output directory; ` +
+            `give one generator a separate -o directory.`),
+    });
+}
+/**
+ * Whether a prompt source is an agent, read leniently: a prompt file that does
+ * not parse is reported by the commands that push it, not by a Swift run.
+ */
+function isAgentPromptSource(source) {
+    try {
+        return describePromptSchema(source).agent !== null;
+    }
+    catch (error) {
+        if (error instanceof FunctionSchemaCodegenError &&
+            !/does not parse/.test(error.message)) {
+            throw error;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=functionGenerator.js.map

package/dist/src/lib/swift-codegen/functionGenerator.js.map

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

package/dist/src/lib/swift-codegen/generator.d.ts

@@ -2,7 +2,7 @@
  * `workflows codegen --lang swift` orchestrator (issue #1547, Phases 2-3).
  *
  * The Swift counterpart of `workflow-codegen/generator.ts`. Reads the SAME
- * synced workflow TOMLs (`.primitive/sync/<env>/<appId>/workflows/*.toml`) and
+ * synced workflow TOMLs (`primitive/<env>/workflows/*.toml`) and
  * emits ONE `<key>.generated.swift` per workflow. Each file carries the
  * workflow's `<Key>Input`/`<Key>Output` Swift `Codable` types (Phase 1's
  * `renderSwiftRootType`) plus — Phase 3 — a typed invoker factory: a free
@@ -76,6 +76,12 @@ export interface GenerateWorkflowSwiftTypesOptions {
  * `create-checkout-session` → `CreateCheckoutSession`; `123-job` → `_123Job`
  * (digit-leading prefixed, parity with the TS `ensureValidIdentifierStart`). */
 export declare function workflowSwiftTypeBaseName(key: string): string;
+/**
+ * A Swift string literal for a config key (the runtime call passes it
+ * verbatim). Exported so the functions emitter (#3344) pins its key literals
+ * through the SAME escape helper rather than a second copy of these rules.
+ */
+export declare function swiftKeyLiteral(key: string): string;
 /**
  * Render the full `<key>.generated.swift` content for a single workflow TOML.
  * Returns null for a reserved (`__internal.*`) workflow. Pure — exported so