primitive-admin 1.1.0-alpha.9 → 1.1.0

package/dist/src/lib/step-run-table.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The step table — one renderer, two commands.
+ *
+ * Extracted in #3348, when `functions runs steps` joined `workflows runs
+ * steps`. A durable function run's steps are the SAME rows in the same
+ * envelope, and the issue's ask is that they read "in the same shape a DSL
+ * workflow run's steps come back in": two hand-kept tables would have made that
+ * a resemblance, and this makes it the same code.
+ *
+ * `annotateStepGaps` (#1367) and `stepRunDisplayDurationMs` (#2771) moved here
+ * with it and are re-exported from `commands/workflows.ts`, which is where they
+ * were first exported for testability.
+ */
+/**
+ * #2771 — how long a step row has been going.
+ *
+ * A step that is still executing is persisted with status `running` and a
+ * `durationMs` of 0 (the column is required; the real value is written when the
+ * step ends). Printing that 0 hides the one number that matters while a run is
+ * in flight — how long the current step has been stuck — so a running row is
+ * measured from its `startedAt` instead. Finished rows keep their stored
+ * duration.
+ */
+export declare function stepRunDisplayDurationMs(step: any, now?: number): number | null;
+/**
+ * #1367 — annotate step-run rows with the inter-step gap: the wall-clock time
+ * between the previous step's `endedAt` and this step's `startedAt`. Sorts by
+ * `startedAt` when every row has a parseable one (tie-break `stepIndex`),
+ * otherwise by `stepIndex` for the whole list — the ordering mode must be
+ * chosen once for all rows, not per pair: a per-pair timestamp-vs-index
+ * fallback is not transitive when some rows lack a timestamp (A<B by index,
+ * B<C by index, C<A by time), and a non-transitive comparator leaves
+ * Array.prototype.sort free to return an arbitrary order, computing gaps
+ * against the wrong predecessor. The first step has no predecessor, so its
+ * `gapMs` is `null`. A gap is only meaningful when both adjacent timestamps
+ * parse and the gap is positive. When the immediate predecessor lacks a valid
+ * `endedAt`, the gap is left `null` rather than measured from an older,
+ * non-adjacent step — otherwise a later step could raise a false stall
+ * warning against a step it does not actually follow.
+ */
+export declare function annotateStepGaps(steps: any[]): any[];
+/** The step table both `runs steps` verbs print. */
+export declare function renderStepRunTable(items: any[]): string;

package/dist/src/lib/step-run-table.js

@@ -0,0 +1,129 @@
+/**
+ * The step table — one renderer, two commands.
+ *
+ * Extracted in #3348, when `functions runs steps` joined `workflows runs
+ * steps`. A durable function run's steps are the SAME rows in the same
+ * envelope, and the issue's ask is that they read "in the same shape a DSL
+ * workflow run's steps come back in": two hand-kept tables would have made that
+ * a resemblance, and this makes it the same code.
+ *
+ * `annotateStepGaps` (#1367) and `stepRunDisplayDurationMs` (#2771) moved here
+ * with it and are re-exported from `commands/workflows.ts`, which is where they
+ * were first exported for testability.
+ */
+import chalk from "chalk";
+import { formatTable, formatDuration } from "./output.js";
+/**
+ * #2771 — how long a step row has been going.
+ *
+ * A step that is still executing is persisted with status `running` and a
+ * `durationMs` of 0 (the column is required; the real value is written when the
+ * step ends). Printing that 0 hides the one number that matters while a run is
+ * in flight — how long the current step has been stuck — so a running row is
+ * measured from its `startedAt` instead. Finished rows keep their stored
+ * duration.
+ */
+export function stepRunDisplayDurationMs(step, now = Date.now()) {
+    const stored = typeof step?.durationMs === "number" ? step.durationMs : null;
+    if (step?.status !== "running")
+        return stored;
+    const started = step?.startedAt ? new Date(step.startedAt).getTime() : NaN;
+    if (Number.isNaN(started))
+        return stored;
+    return Math.max(0, now - started);
+}
+/**
+ * #1367 — annotate step-run rows with the inter-step gap: the wall-clock time
+ * between the previous step's `endedAt` and this step's `startedAt`. Sorts by
+ * `startedAt` when every row has a parseable one (tie-break `stepIndex`),
+ * otherwise by `stepIndex` for the whole list — the ordering mode must be
+ * chosen once for all rows, not per pair: a per-pair timestamp-vs-index
+ * fallback is not transitive when some rows lack a timestamp (A<B by index,
+ * B<C by index, C<A by time), and a non-transitive comparator leaves
+ * Array.prototype.sort free to return an arbitrary order, computing gaps
+ * against the wrong predecessor. The first step has no predecessor, so its
+ * `gapMs` is `null`. A gap is only meaningful when both adjacent timestamps
+ * parse and the gap is positive. When the immediate predecessor lacks a valid
+ * `endedAt`, the gap is left `null` rather than measured from an older,
+ * non-adjacent step — otherwise a later step could raise a false stall
+ * warning against a step it does not actually follow.
+ */
+export function annotateStepGaps(steps) {
+    const rows = [...(steps || [])];
+    const allTimed = rows.every((r) => r?.startedAt && !Number.isNaN(new Date(r.startedAt).getTime()));
+    rows.sort((a, b) => {
+        if (allTimed) {
+            const sa = new Date(a.startedAt).getTime();
+            const sb = new Date(b.startedAt).getTime();
+            if (sa !== sb)
+                return sa - sb;
+        }
+        return (a?.stepIndex ?? 0) - (b?.stepIndex ?? 0);
+    });
+    let prevEnded = null;
+    for (const row of rows) {
+        const started = row?.startedAt ? new Date(row.startedAt).getTime() : NaN;
+        if (prevEnded != null && !Number.isNaN(started)) {
+            const gap = started - prevEnded;
+            row.gapMs = gap > 0 ? gap : 0;
+        }
+        else {
+            row.gapMs = null;
+        }
+        // Only genuinely adjacent steps yield a gap: if this step lacks a valid
+        // `endedAt`, clear the predecessor so the NEXT step's gap is left null
+        // instead of being measured from a non-adjacent earlier step.
+        const ended = row?.endedAt ? new Date(row.endedAt).getTime() : NaN;
+        prevEnded = Number.isNaN(ended) ? null : ended;
+    }
+    return rows;
+}
+/**
+ * #1367 — inter-step gap: idle time between one step ending and the next
+ * starting. Only surfaced above a 1s threshold so normal back-to-back steps
+ * stay quiet; a large gap flags a mid-run stall.
+ */
+const STEP_GAP_THRESHOLD_MS = 1000;
+/** The step table both `runs steps` verbs print. */
+export function renderStepRunTable(items) {
+    // #2771 — an in-flight run also returns the step executing right now (status
+    // `running`, duration not written yet). Show its elapsed time so a step stuck
+    // retrying is visible as such.
+    const rows = annotateStepGaps(items).map((row) => ({
+        ...row,
+        displayDurationMs: stepRunDisplayDurationMs(row),
+    }));
+    return formatTable(rows, [
+        { header: "STEP", key: "stepId" },
+        { header: "KIND", key: "stepKind" },
+        {
+            header: "STATUS",
+            key: "status",
+            format: (v) => v === "completed" ? chalk.green(v) :
+                v === "failed" ? chalk.red(v) :
+                    v === "skipped" ? chalk.gray(v) :
+                        v === "error_captured" ? chalk.yellow(v) :
+                            // #2771 — the step executing right now.
+                            v === "running" ? chalk.cyan(v) : v,
+        },
+        {
+            header: "GAP",
+            key: "gapMs",
+            format: (v) => typeof v === "number" && v >= STEP_GAP_THRESHOLD_MS
+                ? chalk.yellow(formatDuration(v))
+                : chalk.dim("-"),
+        },
+        { header: "DURATION", key: "displayDurationMs", format: formatDuration },
+        {
+            header: "TOKENS",
+            key: "totalTokens",
+            format: (v) => v ? String(v).replace(/\B(?=(\d{3})+(?!\d))/g, ",") : "-",
+        },
+        {
+            header: "ERROR",
+            key: "error",
+            format: (v) => v ? (v.length > 60 ? v.slice(0, 57) + "..." : v) : "",
+        },
+    ]);
+}
+//# sourceMappingURL=step-run-table.js.map

package/dist/src/lib/step-run-table.js.map

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

package/dist/src/lib/storage-pending-retry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * #3835 — ask again when the server could not confirm its OWN write.
+ *
+ * A create whose row dynamo-bao wrote but could not read back, and whose
+ * consistent confirm read could not vouch for it either, is answered
+ * `503 STORAGE_CONSISTENCY_PENDING` (`src/services/readback-confirm.ts`): the
+ * write may well have landed, and nothing about the request was wrong. A push
+ * that records that as "could not be applied" exits 1 over a change that is
+ * very likely on the server already.
+ *
+ * Only that typed code is retried — a client that retries on it must not also
+ * retry on everything else a 503 covers — and only a bounded number of times,
+ * after which the transient itself is what the caller reports.
+ */
+/** The code the server's read-back transient carries. */
+export declare const STORAGE_CONSISTENCY_PENDING = "STORAGE_CONSISTENCY_PENDING";
+export declare function isStorageConsistencyPending(err: unknown): boolean;
+/**
+ * Run `fn`, and run it again while it fails with the storage-consistency
+ * transient. Any other failure — including the 409 a retried create meets when
+ * its first attempt's row holds the key — is thrown to the caller unchanged.
+ */
+export declare function retryOnStoragePending<T>(fn: () => Promise<T>, opts?: {
+    attempts?: number;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<T>;

package/dist/src/lib/storage-pending-retry.js

@@ -0,0 +1,42 @@
+/**
+ * #3835 — ask again when the server could not confirm its OWN write.
+ *
+ * A create whose row dynamo-bao wrote but could not read back, and whose
+ * consistent confirm read could not vouch for it either, is answered
+ * `503 STORAGE_CONSISTENCY_PENDING` (`src/services/readback-confirm.ts`): the
+ * write may well have landed, and nothing about the request was wrong. A push
+ * that records that as "could not be applied" exits 1 over a change that is
+ * very likely on the server already.
+ *
+ * Only that typed code is retried — a client that retries on it must not also
+ * retry on everything else a 503 covers — and only a bounded number of times,
+ * after which the transient itself is what the caller reports.
+ */
+import { ApiError } from "./api-client.js";
+/** The code the server's read-back transient carries. */
+export const STORAGE_CONSISTENCY_PENDING = "STORAGE_CONSISTENCY_PENDING";
+const DEFAULT_ATTEMPTS = 3;
+const BASE_DELAY_MS = 250;
+export function isStorageConsistencyPending(err) {
+    return err instanceof ApiError && err.code === STORAGE_CONSISTENCY_PENDING;
+}
+/**
+ * Run `fn`, and run it again while it fails with the storage-consistency
+ * transient. Any other failure — including the 409 a retried create meets when
+ * its first attempt's row holds the key — is thrown to the caller unchanged.
+ */
+export async function retryOnStoragePending(fn, opts = {}) {
+    const attempts = Math.max(1, opts.attempts ?? DEFAULT_ATTEMPTS);
+    const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (attempt >= attempts || !isStorageConsistencyPending(err))
+                throw err;
+            await sleep(BASE_DELAY_MS * 2 ** (attempt - 1));
+        }
+    }
+}
+//# sourceMappingURL=storage-pending-retry.js.map

package/dist/src/lib/storage-pending-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-pending-retry.js","sourceRoot":"","sources":["../../../src/lib/storage-pending-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,yDAAyD;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,6BAA6B,CAAC;AAEzE,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,MAAM,UAAU,2BAA2B,CAAC,GAAY;IACtD,OAAO,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,2BAA2B,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,EAAoB,EACpB,OAAqE,EAAE;IAEvE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,IAAI,gBAAgB,CAAC,CAAC;IAChE,MAAM,KAAK,GACT,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9E,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,OAAO,IAAI,QAAQ,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC;gBAAE,MAAM,GAAG,CAAC;YACxE,MAAM,KAAK,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * The Swift half of an agent prompt's client-side types — #3798.
+ *
+ * `functions codegen --lang swift` writes one `<key>.agent.generated.swift`
+ * per `kind = "agent"` prompt, beside the function invokers, carrying:
+ *
+ *   - `<Key>AgentVariables` — the session's variables, from `[prompt].inputSchema`;
+ *   - `<Key>Tool<Name>Input` / `<Key>Tool<Name>Output` for every CLIENT tool
+ *     (a server tool's schemas are its function's, typed in that function's
+ *     own file);
+ *   - `<Key>Event<Name>` for every event kind; and
+ *   - `<Key>Agent`, a namespace enum with the key a session is created with
+ *     and the declared client-tool and event names.
+ *
+ * ── Nothing about the agent is re-derived here ───────────────────────────
+ *
+ * Names, schemas and the declaration's defaults all come from
+ * `describePromptSchema` — the IR the TypeScript artifact reads, itself read
+ * through `normalizeAgentDeclaration` — so the two clients can never disagree
+ * about what an agent's contract is. Only Swift rendering, through the shared
+ * `renderSwiftRootType`, happens in this file.
+ *
+ * Written in the functions run's own `writeOrCheckGeneratedFiles` call
+ * (`generateFunctionSwiftTypes`), which owns both banners: a removed agent's
+ * file is swept, `--check` reports a stale one, and a file another generator
+ * stamped is never overwritten.
+ */
+import { type PromptSchemaSource } from "../prompt-schema-codegen.js";
+import { AGENT_SWIFT_BANNER_PREFIX } from "./banners.js";
+export { AGENT_SWIFT_BANNER_PREFIX };
+/** The file an agent prompt's Swift types are written to: `<key>.agent.generated.swift`. */
+export declare const AGENT_SWIFT_FILE_SUFFIX = ".agent.generated.swift";
+/**
+ * Render the full `<key>.agent.generated.swift` content for one agent prompt.
+ * Pure — exported so tests can assert on the string directly. Throws a
+ * `SwiftCodegenError` naming the file for a prompt that is not an agent.
+ */
+export declare function renderAgentSwiftFile(source: PromptSchemaSource): {
+    key: string;
+    content: string;
+    symbols: string[];
+};

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

@@ -0,0 +1,118 @@
+/**
+ * The Swift half of an agent prompt's client-side types — #3798.
+ *
+ * `functions codegen --lang swift` writes one `<key>.agent.generated.swift`
+ * per `kind = "agent"` prompt, beside the function invokers, carrying:
+ *
+ *   - `<Key>AgentVariables` — the session's variables, from `[prompt].inputSchema`;
+ *   - `<Key>Tool<Name>Input` / `<Key>Tool<Name>Output` for every CLIENT tool
+ *     (a server tool's schemas are its function's, typed in that function's
+ *     own file);
+ *   - `<Key>Event<Name>` for every event kind; and
+ *   - `<Key>Agent`, a namespace enum with the key a session is created with
+ *     and the declared client-tool and event names.
+ *
+ * ── Nothing about the agent is re-derived here ───────────────────────────
+ *
+ * Names, schemas and the declaration's defaults all come from
+ * `describePromptSchema` — the IR the TypeScript artifact reads, itself read
+ * through `normalizeAgentDeclaration` — so the two clients can never disagree
+ * about what an agent's contract is. Only Swift rendering, through the shared
+ * `renderSwiftRootType`, happens in this file.
+ *
+ * Written in the functions run's own `writeOrCheckGeneratedFiles` call
+ * (`generateFunctionSwiftTypes`), which owns both banners: a removed agent's
+ * file is swept, `--check` reports a stale one, and a file another generator
+ * stamped is never overwritten.
+ */
+import { fingerprintToml } from "../db-codegen/dbFingerprint.js";
+import { describePromptSchema, } from "../prompt-schema-codegen.js";
+import { renderSwiftRootType, SwiftCodegenError } from "./schemaToSwift.js";
+import { swiftKeyLiteral } from "./generator.js";
+import { AGENT_SWIFT_BANNER_PREFIX } from "./banners.js";
+import { parseTopLevelSwiftSymbols } from "./siblingSymbols.js";
+export { AGENT_SWIFT_BANNER_PREFIX };
+/** The file an agent prompt's Swift types are written to: `<key>.agent.generated.swift`. */
+export const AGENT_SWIFT_FILE_SUFFIX = ".agent.generated.swift";
+const INDENT = "    ";
+/** A Swift array literal of the declared names, in declaration order. */
+function nameList(names) {
+    return `[${names.map(swiftKeyLiteral).join(", ")}]`;
+}
+/**
+ * Render the full `<key>.agent.generated.swift` content for one agent prompt.
+ * Pure — exported so tests can assert on the string directly. Throws a
+ * `SwiftCodegenError` naming the file for a prompt that is not an agent.
+ */
+export function renderAgentSwiftFile(source) {
+    const prompt = describePromptSchema(source);
+    const agent = prompt.agent;
+    if (!agent) {
+        throw new SwiftCodegenError(`swift agent codegen: ${prompt.fileLabel} is not a kind = "agent" prompt`, { sourceFile: prompt.fileLabel });
+    }
+    const sourceFile = prompt.fileLabel;
+    const rendered = [
+        {
+            path: "inputSchema",
+            decl: renderSwiftRootType(agent.variablesTypeName, agent.inputSchema, { sourceFile }),
+        },
+        ...agent.clientTools.flatMap((tool) => [
+            {
+                path: `tools.${tool.name}.inputSchema`,
+                decl: renderSwiftRootType(tool.input.typeName, tool.input.schema, { sourceFile }),
+            },
+            {
+                path: `tools.${tool.name}.outputSchema`,
+                decl: renderSwiftRootType(tool.output.typeName, tool.output.schema, { sourceFile }),
+            },
+        ]),
+        ...agent.events.map((event) => ({
+            path: `events.${event.name}.schema`,
+            decl: renderSwiftRootType(event.typeName, event.schema, { sourceFile }),
+        })),
+    ];
+    // CSO-3798-002 — a schema's helper types are top-level too (an array of
+    // objects under `data` declares `<Key>EventDataItem`), so two of one agent's
+    // schemas can declare the same symbol. The run-scoped registry only compares
+    // owners, so the file is checked against itself here, naming both paths.
+    const symbolPath = new Map();
+    for (const { path, decl } of rendered) {
+        for (const symbol of new Set(parseTopLevelSwiftSymbols(decl))) {
+            const other = symbolPath.get(symbol);
+            if (other !== undefined) {
+                throw new SwiftCodegenError(`swift agent codegen: ${sourceFile}: \`${other}\` and \`${path}\` both ` +
+                    `produce Swift symbol "${symbol}", which would be declared twice in ` +
+                    `one file — rename one so the two differ after Swift normalization`, { sourceFile });
+            }
+            symbolPath.set(symbol, path);
+        }
+    }
+    const decls = rendered.map((entry) => entry.decl);
+    const namespace = [
+        `/// The \`${prompt.key}\` agent: the key a session is created with, and the`,
+        `/// client tools and event kinds it declares.`,
+        `public enum ${prompt.typeBaseName}Agent {`,
+        `${INDENT}public static let key = ${swiftKeyLiteral(prompt.key)}`,
+        `${INDENT}public static let clientToolNames: [String] = ${nameList(agent.clientTools.map((tool) => tool.name))}`,
+        `${INDENT}public static let eventNames: [String] = ${nameList(agent.events.map((event) => event.name))}`,
+        `}`,
+    ].join("\n");
+    const banner = [
+        `${AGENT_SWIFT_BANNER_PREFIX}${sourceFile.replace(/^prompts\//, "")} — DO NOT EDIT.`,
+        "// Run `primitive functions codegen --lang swift` to regenerate.",
+        `// fingerprint: ${fingerprintToml(source.tomlContent)}`,
+    ].join("\n");
+    // `JsBaoClient` for `JSONValue`, which an open schema renders to — the
+    // import the function invokers carry too.
+    const imports = ["import Foundation", "import JsBaoClient"].join("\n");
+    const content = [banner, imports, ...decls, namespace].join("\n\n") + "\n";
+    return {
+        key: prompt.key,
+        content,
+        // Read back off the rendered source, as the function emitter does
+        // (CR3344-001), so a nested helper type a schema declares is in the
+        // run-scoped registry too.
+        symbols: parseTopLevelSwiftSymbols(content),
+    };
+}
+//# sourceMappingURL=agentGenerator.js.map

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * Ownership banners the CLI's Swift generators stamp and guard against.
+ *
+ * Three generators now write `.generated.swift` files that may share one
+ * output directory — workflows, database types and (since #3344) server
+ * functions. Each one sweeps only the files carrying its OWN banner and
+ * refuses to overwrite a file carrying another's, so each has to name the
+ * other two. The functions banner lives here, with no imports of its own, so
+ * `generator.ts` and `dbGenerator.ts` can both name it without deepening the
+ * import cycle those two already have.
+ */
+/**
+ * Banner prefix stamped at the top of every `functions codegen --lang swift`
+ * file. Distinct from the workflow and database prefixes (and from the Swift
+ * model codegen's `// Generated by swift-bao-codegen` header), so a shared
+ * output directory stays safe in every direction.
+ */
+export declare const FUNCTION_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM functions/";
+/**
+ * Banner prefix of an agent prompt's `<key>.agent.generated.swift` (#3798),
+ * written by the same `functions codegen --lang swift` run as the function
+ * invokers but from `prompts/`, so the two are told apart by content too.
+ */
+export declare const AGENT_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM prompts/";

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

@@ -0,0 +1,25 @@
+/**
+ * Ownership banners the CLI's Swift generators stamp and guard against.
+ *
+ * Three generators now write `.generated.swift` files that may share one
+ * output directory — workflows, database types and (since #3344) server
+ * functions. Each one sweeps only the files carrying its OWN banner and
+ * refuses to overwrite a file carrying another's, so each has to name the
+ * other two. The functions banner lives here, with no imports of its own, so
+ * `generator.ts` and `dbGenerator.ts` can both name it without deepening the
+ * import cycle those two already have.
+ */
+/**
+ * Banner prefix stamped at the top of every `functions codegen --lang swift`
+ * file. Distinct from the workflow and database prefixes (and from the Swift
+ * model codegen's `// Generated by swift-bao-codegen` header), so a shared
+ * output directory stays safe in every direction.
+ */
+export const FUNCTION_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM functions/";
+/**
+ * Banner prefix of an agent prompt's `<key>.agent.generated.swift` (#3798),
+ * written by the same `functions codegen --lang swift` run as the function
+ * invokers but from `prompts/`, so the two are told apart by content too.
+ */
+export const AGENT_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM prompts/";
+//# sourceMappingURL=banners.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banners.js","sourceRoot":"","sources":["../../../../src/lib/swift-codegen/banners.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,mCAAmC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,iCAAiC,CAAC"}

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

@@ -0,0 +1,113 @@
+/**
+ * `databases codegen --lang swift` orchestrator (issue #1547, Phase 4).
+ *
+ * The Swift counterpart of `db-codegen/dbGenerator.ts`. Reads the SAME synced
+ * `database-type-configs/*.toml` and emits ONE `<type>.generated.swift` per database
+ * type. Each file carries the type's record structs (read shape), per-op params
+ * structs (write shape), per-op result typealiases, and a typed `<Type>Ops`
+ * factory over the additive generic `executeOperation` overload on
+ * `DatabasesAPI` (the only published SDK surface for this generator).
+ *
+ * Design decisions realized (issue #1547):
+ *   - Operation + record metadata (which ops exist, their params, their result
+ *     descriptor, and per-model fields) is read from the SHARED `describeDbType`
+ *     IR — the SAME source the TS renderer (`db-codegen/dbGenerator.ts`) reads.
+ *     The Swift renderer reconstructs none of it (binding item 5), so the two
+ *     clients can never disagree on a type's surface.
+ *   - The generic result envelopes (`DBQueryResult<T>`, `DBMutationResult`, …)
+ *     live in the JsBaoClient SDK, NOT emitted per file — a Swift package
+ *     compiles all generated files into one module, so a per-file copy would
+ *     collide. Generated files reference the SDK envelopes (mirrors how Phase 3
+ *     put the workflow result envelopes in the SDK).
+ *   - Swift has no analog of TS `Pick<M, …>` / `Partial<M>`, so a query op with
+ *     a `pick`/`partial` projection types its rows as the open `JSONValue`
+ *     rather than a narrowed record (the same Fork-4 "no clean analog →
+ *     JSONValue" fallback the emitter uses for un-descended schema nodes). A
+ *     `full` projection over a known record types as `DBQueryResult<Record>`.
+ *   - Disk lifecycle (write / `--check` / orphan cleanup) delegates to the
+ *     shared `writeOrCheckGeneratedFiles`, scoped by an ownership BANNER
+ *     distinct from both the workflow Swift banner and the model codegen's, so
+ *     a shared Swift output dir stays safe.
+ */
+import { type WriteOrCheckResult } from "../codegen-shared/generatedFiles.js";
+import { type DbCodegenInput } from "../db-codegen/dbTypeIR.js";
+/**
+ * Banner prefix stamped on every CLI-emitted database `.generated.swift` file.
+ * Distinct from both the workflow Swift banner (`// AUTO-GENERATED FROM
+ * workflows/`) and the model codegen's (`// Generated by swift-bao-codegen`),
+ * so none of the three generators' stale-sweeps ever deletes another's files
+ * when they share an output dir.
+ */
+export declare const DB_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM database-type-configs/";
+/**
+ * The banner this generator stamped before issue #2760 renamed the source
+ * directory. RECOGNITION ONLY — nothing emits it.
+ *
+ * Ownership everywhere is `contents.startsWith(banner)`, so without this a file
+ * generated before the rename would match neither the db banner nor the
+ * workflow one: it would survive the db stale sweep as a stranger, stay
+ * invisible to the sibling-symbol scans, and be silently overwritten by
+ * `workflows codegen --lang swift` on a name collision instead of refused.
+ */
+export declare const LEGACY_DB_SWIFT_BANNER_PREFIX = "// AUTO-GENERATED FROM database-types/";
+/** Both spellings, for every ownership check this generator performs. */
+export declare const DB_SWIFT_BANNER_PREFIXES: string[];
+export interface GenerateDbSwiftTypesOptions {
+    inputs: DbCodegenInput[];
+    /** Directory where the `<type>.generated.swift` files are written. */
+    outputDir: string;
+    /** `--check`: compare against disk, do not write. */
+    check?: boolean;
+    /**
+     * Set when the run was filtered to a single database type. `inputs` is then a
+     * PARTIAL view, so orphan cleanup / stale detection is scoped to the filtered
+     * file. Mirrors the TS generator's `singleType`.
+     */
+    singleType?: boolean;
+}
+/** Swift record struct type name for a model (shared naming + Swift sanitize). */
+export declare function dbRecordSwiftTypeName(modelName: string, className: string | undefined): string;
+/**
+ * Namespace `enum` name for a database type (issue #1687). Every symbol a type
+ * emits is nested under `public enum <Type>` (`securities-ref` →
+ * `SecuritiesRef`), so two DB types can never collide on a shared op symbol.
+ * Reuses the same `structTypeName` sanitizer (keyword suffixing + digit-leading
+ * `_` guard) the old `<Type>Ops` derivation used, so the namespace name is a
+ * legal Swift type identifier.
+ */
+export declare function dbNamespaceName(databaseType: string): string;
+/**
+ * Validate that a database type's derived namespace enum name is safe to emit,
+ * and return it. Throws a named `SwiftCodegenError` (with a rename hint) for
+ * the whole class of unsafe names a server-accepted database type can produce
+ * (#1687):
+ *
+ *   1. **Degenerate `_`** — a type with no retained identifier characters
+ *      (empty after sanitize, or separator/emoji/punctuation-only, e.g. `--`,
+ *      `🎉`) normalizes to `_` via `structTypeName`. Swift reserves `_` as the
+ *      wildcard and rejects `public enum _` (Codex [P2]).
+ *   2. **Stdlib/SDK shadowing** — a name in `RESERVED_NAMESPACE_NAMES` shadows
+ *      a type the generated body references unqualified (Codex [P1]).
+ *
+ * Leading-digit residue (`123` → `_123`) and Swift reserved words (`self` →
+ * `Self_`, `any` → `Any_`) are already lifted into legal, non-shadowing
+ * identifiers by `structTypeName` (digit-leading `_` guard + keyword suffix),
+ * so they need no rejection here — only names that survive that sanitizer as
+ * `_` or as a real type identifier remain unsafe. The two in-run / retained-
+ * sibling namespace-NAME collision guards (two database types whose names
+ * normalize to the SAME enum) live in `generateDbSwiftTypes`; this check
+ * covers the single-type unsafe-name class.
+ */
+export declare function assertSafeNamespaceName(databaseType: string, sourceFile: string): string;
+/**
+ * Render the full `<type>.generated.swift` content for one database-type TOML.
+ * Pure — exported so tests can assert on the string directly. Throws on a Swift
+ * record type-name collision between two models (mirrors the TS collision guard).
+ */
+export declare function renderDbTypeSwiftFile(input: DbCodegenInput): string;
+/**
+ * Run Swift database codegen end-to-end. One `<type>.generated.swift` per
+ * database type; delegates the disk lifecycle to the shared writer/checker with
+ * banner-scoped ownership so a shared Swift output dir stays safe.
+ */
+export declare function generateDbSwiftTypes(options: GenerateDbSwiftTypesOptions): Promise<WriteOrCheckResult>;