@sanoma-ai/workflows 0.0.0-stage → 0.1.0

package/dist/client.js

@@ -0,0 +1,400 @@
+import { randomUUID } from "node:crypto";
+import { isDeepStrictEqual } from "node:util";
+import { Error as DBOSErrors } from "@dbos-inc/dbos-sdk";
+import { z } from "zod";
+import { APPROVALS_EVENT, ApprovalMessage, decisionEventOf, messageKeyOf, topicOf } from "./approvals.js";
+import { resolveConfig } from "./config.js";
+import { deleteCredential, storeCredential, storedCredentials } from "./credentials.js";
+import { dbosClient, lazyPool } from "./db.js";
+import { credentialsOf } from "./env.js";
+import { notApprover, Principal } from "./define.js";
+import { DRIFT_WORKFLOW } from "./drift.js";
+import { parseOrThrow, SanomaError } from "./errors.js";
+import { ownedLedger } from "./ledger.js";
+import { isEnded, mayDecide } from "./shared.js";
+/**
+ * The run status each DBOS status maps to. `waiting` is PENDING with an approval pending, so
+ * only the approvals tell it from `running`. Keyed by every DBOS status, so one a later DBOS
+ * adds fails to compile here until it is mapped.
+ */
+const FROM_DBOS = {
+    ENQUEUED: "queued",
+    DELAYED: "queued",
+    PENDING: "running",
+    SUCCESS: "finished",
+    ERROR: "failed",
+    MAX_RECOVERY_ATTEMPTS_EXCEEDED: "failed",
+    CANCELLED: "cancelled",
+};
+/** A run's status from DBOS's, and whether it has an approval pending. */
+export function runStatus(dbosStatus, approvals) {
+    // A status this DBOS did not have when the table was written: not ended as far as we know.
+    const status = Object.hasOwn(FROM_DBOS, dbosStatus) ? FROM_DBOS[dbosStatus] : "running";
+    return status === "running" && approvals.some((a) => a.status === "pending") ? "waiting" : status;
+}
+/** The DBOS statuses the run statuses come from; `running` and `waiting` both come from PENDING. */
+export const dbosStatusesOf = (...statuses) => Object.keys(FROM_DBOS).filter((s) => statuses.some((status) => FROM_DBOS[s] === (status === "waiting" ? "running" : status)));
+/**
+ * The first `limit` items `keep` accepts, read a page of `pageSize` at a time from `list`, in
+ * its order, until there are enough or a page comes back short (the last one).
+ */
+export async function firstMatching(list, keep, limit, pageSize) {
+    const found = [];
+    for (let offset = 0;; offset += pageSize) {
+        const rows = await list({ limit: pageSize, offset });
+        found.push(...rows.filter(keep));
+        if (found.length >= limit || rows.length < pageSize)
+            return found.slice(0, limit);
+    }
+}
+/** Talks to the runtime from another process (the app, a script), through the shared Postgres. */
+export class SanomaClient {
+    dbos;
+    config;
+    drivers;
+    /** The config's own ledger store, or a Postgres one made for this client, which `close` then closes. */
+    audit;
+    /** On the config's database, for the credentials table: opened on first use. */
+    credentialsPool;
+    constructor(dbos, config, drivers) {
+        this.dbos = dbos;
+        this.config = config;
+        this.drivers = drivers;
+        this.audit = ownedLedger(config);
+        this.credentialsPool = lazyPool(config.databaseUrl, "credentials");
+    }
+    /**
+     * Connects to the runtime's Postgres for the config's app. Checks the config first and throws
+     * what the worker would refuse. Reads ledgers from the config's ledger store, or from the
+     * Postgres store on its database when it has none.
+     */
+    static async connect(config) {
+        const resolved = resolveConfig(config);
+        const dbos = await dbosClient(resolved.databaseUrl, resolved.appName);
+        return new SanomaClient(dbos, resolved, resolved.driversByVendor);
+    }
+    /**
+     * Checks the input against the workflow's schema, then queues a run for the worker. The run
+     * gets the input as sent, not as the schema parsed it: the worker parses it once, so a schema
+     * with a `.transform` or a default sees the caller's value, and `run.started` records it.
+     * `workflow` is a definition, or the name of one in the config's `workflows`.
+     */
+    async start(workflow, input, options) {
+        if (typeof workflow === "string") {
+            const named = this.config.workflows.get(workflow);
+            if (!named) {
+                const known = [...this.config.workflows.keys()];
+                throw new SanomaError("invalid_input", `No workflow named "${workflow}"; the config has ${known.join(", ")}`, {
+                    workflow,
+                    workflows: known,
+                });
+            }
+            workflow = named;
+        }
+        parseOrThrow(workflow.input, input, `The input does not match ${workflow.name}'s schema`);
+        const startedBy = parseOrThrow(Principal, options?.startedBy, '`startedBy` must be a principal, such as { id: "alice" }');
+        const { runId } = options;
+        const sandbox = parseOrThrow(z.string().min(1).optional(), options.sandbox, "`sandbox` must be the name of a scenario in the config's `scenarios/`");
+        const args = { input, startedBy, ...(sandbox === undefined ? {} : { sandbox }) };
+        // An id DBOS has already returns that run, unless it is another workflow's, which DBOS refuses.
+        const handle = await this.dbos
+            .enqueue({
+            queueName: this.config.queueName,
+            workflowName: workflow.name,
+            workflowID: runId,
+            applicationName: this.config.appName,
+            authenticatedUser: startedBy.id,
+            authenticatedRoles: startedBy.groups ?? [],
+            // Kept on the run's status row too, so a listing tells sandbox runs apart without its input.
+            ...(sandbox === undefined ? {} : { attributes: { sandbox } }),
+        }, args)
+            .catch((err) => {
+            if (runId !== undefined && err instanceof DBOSErrors.DBOSConflictingWorkflowError) {
+                throw new SanomaError("invalid_input", `Run ${runId} already exists as another workflow than ${workflow.name}; use another run id`, { runId, differs: ["workflow"] }, { cause: err });
+            }
+            throw err;
+        });
+        // After the enqueue, not before: of two starts racing with one new id, the first's run stands.
+        if (runId !== undefined)
+            await this.mustMatch(runId, args);
+        return handle.workflowID;
+    }
+    /** The run's audit record, in order, from the ledger store. */
+    async ledger(runId) {
+        await this.mustExist(runId);
+        return this.audit.store.read(runId);
+    }
+    /**
+     * The app's runs, newest first: the latest `limit`, or the latest `limit` with a `status`.
+     * Only the approvals tell `running` from `waiting`, so those read PENDING runs a page at a
+     * time until `limit` have that status.
+     */
+    async runs({ limit = 20, status, workflow } = {}) {
+        const list = (more) => this.dbos.listWorkflows({
+            ...more,
+            status: status && dbosStatusesOf(status),
+            workflowName: workflow,
+            sortDesc: true,
+            applicationName: this.config.appName,
+            loadInput: false,
+            // The output holds the error a summary shows; only an ended run can have one.
+            loadOutput: status === undefined || status === "failed" || status === "cancelled",
+        });
+        if (status !== "running" && status !== "waiting") {
+            return Promise.all((await list({ limit })).map((r) => this.summarize(r)));
+        }
+        return firstMatching(async (page) => Promise.all((await list(page)).map((r) => this.summarize(r))), (run) => run.status === status, limit, Math.max(limit * 2, 50));
+    }
+    async run(runId) {
+        const row = await this.dbos.getWorkflow(runId);
+        return row && this.summarize(row);
+    }
+    async approvals(runId) {
+        return (await this.dbos.getEvent(runId, APPROVALS_EVENT, 0)) ?? [];
+    }
+    /**
+     * Sends a decision on the run's pending approval (or the one named), as `message.by`, and
+     * waits for the run to read it. Returns the approval as decided. Throws without sending when
+     * it is decided already (`already_decided`), when the run has finished, failed or been
+     * cancelled (`run_ended`), when there is nothing to decide (`no_pending_approval`,
+     * `run_not_found`), or when `by` may not decide it (`not_approver`); and throws
+     * `already_decided` too when another decision reached the run first, and `not_approver` when
+     * the run read this one and refused it.
+     *
+     * If the run does not read the decision within `timeoutSeconds` (30 by default; the worker
+     * may be down), returns the approval as it stands, still `pending`: the decision stays
+     * queued for the run, which reads it when it next runs.
+     */
+    async decide(runId, message, approvalId, options = {}) {
+        const msg = parseOrThrow(ApprovalMessage, message, "Not a decision");
+        // A run that does not exist has no approvals, so run_not_found never hides already_decided.
+        const [all, row] = await Promise.all([this.approvals(runId), this.mustExist(runId)]);
+        const target = approvalId ? all.find((a) => a.id === approvalId) : all.find((a) => a.status === "pending");
+        if (target && target.status !== "pending")
+            throw alreadyDecided(runId, target);
+        // A run that has ended reads no more messages: a decision sent to it would wait forever.
+        const status = runStatus(row.status, all);
+        if (isEnded(status)) {
+            throw new SanomaError("run_ended", `Run ${runId} has ${status}; it takes no more decisions`, {
+                runId,
+                status,
+                ...(target ? { approvalId: target.id } : {}),
+            });
+        }
+        if (!target) {
+            throw new SanomaError("no_pending_approval", `Run ${runId} has no pending approval${approvalId ? ` "${approvalId}"` : ""}`, { runId, ...(approvalId ? { approvalId } : {}) });
+        }
+        if (!mayDecide(target, msg.by)) {
+            throw new SanomaError("not_approver", `${notApprover(target, msg.by)} (${target.id})`, {
+                runId,
+                approvalId: target.id,
+                approver: target.approver,
+            });
+        }
+        // The id names this message, so the run's answer says whether it decided with it, and is
+        // in its idempotency key, so a retried send queues it once.
+        const id = msg.id ?? randomUUID();
+        await this.dbos.send(runId, { ...msg, id }, topicOf(target.id), messageKeyOf(target.id, id));
+        // DBOSClient does not LISTEN for events: it polls, every 10 s unless told otherwise. A
+        // running worker answers within moments, so poll often at first, then once a second.
+        const event = decisionEventOf(target.id);
+        const timeoutSeconds = options.timeoutSeconds ?? 30;
+        const soon = Math.min(2, timeoutSeconds);
+        const decided = (await this.dbos.getEvent(runId, event, { timeoutSeconds: soon, pollingIntervalMs: 100 })) ??
+            (timeoutSeconds > soon
+                ? await this.dbos.getEvent(runId, event, {
+                    timeoutSeconds: timeoutSeconds - soon,
+                    pollingIntervalMs: 1000,
+                })
+                : null);
+        const now = decided ?? (await this.approvals(runId)).find((a) => a.id === target.id) ?? target;
+        // Read, but refused: the run checks the sender again, and said no.
+        const refused = now.refused.find((r) => r.id === id);
+        if (refused) {
+            throw new SanomaError("not_approver", `${refused.reason} (${target.id})`, {
+                runId,
+                approvalId: target.id,
+                approver: target.approver,
+            });
+        }
+        if (now.status !== "pending" && now.decidedWith !== id)
+            throw alreadyDecided(runId, now);
+        return now;
+    }
+    /**
+     * The run's output once it ends, or its error. Throws `run_running` when it has not ended
+     * within `timeoutMs`; the run goes on.
+     */
+    async result(runId, timeoutMs = 30_000) {
+        await this.mustExist(runId);
+        return this.awaitResult(runId, timeoutMs);
+    }
+    /**
+     * Starts the built-in drift workflow, which reads the config's data files itself: `start`
+     * with its input, `{}`. Returns the run id; `driftReport` waits for its report. Throws
+     * `invalid_input` when the config's connectors declare no resource types, so it has none.
+     */
+    async drift(options) {
+        const drift = this.config.workflows.get(DRIFT_WORKFLOW);
+        if (!drift) {
+            throw new SanomaError("invalid_input", "The config's connectors declare no resource types, so there is nothing to check for drift");
+        }
+        return this.start(drift, {}, options);
+    }
+    /**
+     * The report of a drift run once it ends. Throws `run_not_found`, `invalid_input` for another
+     * workflow's run, the run's error when it failed, and `run_running` when it has not ended
+     * within 30 s.
+     */
+    async driftReport(runId) {
+        const row = await this.mustExist(runId, { loadOutput: true });
+        if (row.workflowName !== DRIFT_WORKFLOW) {
+            throw new SanomaError("invalid_input", `Run ${runId} is a run of ${row.workflowName}, not of ${DRIFT_WORKFLOW}`, {
+                runId,
+                workflow: row.workflowName,
+            });
+        }
+        // A finished run's report came with its row; else wait for the run.
+        return (row.status === "SUCCESS" ? row.output : await this.awaitResult(runId, 30_000));
+    }
+    /**
+     * Stores a value for a variable a driver's `env` declares, as `by`, and tells the workers: each
+     * loads it into its environment, unless its environment sets the variable itself. Refuses
+     * (`invalid_input`) a name no driver declares, and a value the variable's schema refuses, with
+     * the schema's reason and never the value; an empty value too (`clearCredential` unsets one).
+     * Nothing records the value but its row, which records `by` and when.
+     */
+    async setCredential(name, value, options) {
+        // Checked against every declaration of the name, as the worker checks it.
+        const statuses = this.declared(name, (n) => (n === name ? value : undefined));
+        const setBy = actorOf(options);
+        const refused = statuses.find((c) => c.status !== "set");
+        if (refused) {
+            const problem = refused.problem ?? "it is empty; clear it to unset it";
+            throw new SanomaError("invalid_input", `${name} cannot be set: ${problem}`, {
+                name,
+                issues: [{ path: ["value"], message: problem, code: "custom" }],
+            });
+        }
+        await storeCredential(await this.credentialsDb(), { name, value, setBy });
+    }
+    /**
+     * Deletes the stored value of a declared variable, and tells the workers, which unset it unless
+     * their environment sets it. `by` is who asks; nothing records it once the row is gone.
+     * Refuses (`invalid_input`) a name no driver declares.
+     */
+    async clearCredential(name, options) {
+        this.declared(name, () => undefined);
+        actorOf(options);
+        await deleteCredential(await this.credentialsDb(), name);
+    }
+    /**
+     * Each vendor's declared variables and their statuses now: from this process's environment,
+     * which wins, else from the stored credentials, with `source` saying which (a value equal to
+     * the stored one, as a worker in this process loads it, is `stored`), and who set a stored one
+     * and when. Never a value.
+     */
+    async credentials() {
+        const names = [...credentialsOf(this.drivers, () => undefined).values()].flat().map((c) => c.name);
+        if (!names.length)
+            return new Map();
+        const rows = await storedCredentials(await this.credentialsDb(), names);
+        const statuses = credentialsOf(this.drivers, (name) => process.env[name] || rows.get(name)?.value);
+        const sourced = (c) => {
+            const row = rows.get(c.name);
+            const env = process.env[c.name];
+            // A worker in this process loads the stored values into its environment: those are stored.
+            if (env && env !== row?.value)
+                return { ...c, source: "environment" };
+            return row ? { ...c, source: "stored", setBy: row.setBy, setAt: row.setAt } : c;
+        };
+        return new Map([...statuses].map(([vendor, list]) => [vendor, list.map(sourced)]));
+    }
+    async close() {
+        await Promise.all([this.dbos.destroy(), this.credentialsPool.close(), this.audit.close()]);
+    }
+    /**
+     * The name's statuses with `lookup`'s value, one per vendor whose drivers declare it, or
+     * `invalid_input` when none does.
+     */
+    declared(name, lookup) {
+        const all = [...credentialsOf(this.drivers, lookup).values()].flat();
+        const statuses = all.filter((c) => c.name === name);
+        if (statuses.length)
+            return statuses;
+        const known = [...new Set(all.map((c) => c.name))];
+        // A name that is no variable's may be a value sent in its place: it is not repeated.
+        const named = VARIABLE.test(name);
+        const message = `${named ? `No driver declares ${name}` : "That is not a variable name"}; ${known.length ? `the declared variables are ${known.join(", ")}` : "none declares any"}`;
+        throw new SanomaError("invalid_input", message, {
+            ...(named && { name }),
+            issues: [{ path: ["name"], message, code: "custom" }],
+        });
+    }
+    /** The pool the credentials are read and written with, on the database once it is prepared. */
+    credentialsDb() {
+        return this.credentialsPool.db();
+    }
+    /** Refuses a run id whose run, as stored, was started with another input, by someone else, or in another sandbox. */
+    async mustMatch(runId, args) {
+        const [stored] = ((await this.dbos.getWorkflow(runId))?.input ?? []);
+        const differs = ["input", "startedBy", "sandbox"].filter((key) => !stored || !sameJson(stored[key], args[key]));
+        if (differs.length) {
+            throw new SanomaError("invalid_input", `Run ${runId} already exists with a different ${differs.join(", ")}; use another run id`, { runId, differs });
+        }
+    }
+    /** The run's status row, read without its input (and its output, unless asked), or `run_not_found`. */
+    async mustExist(runId, { loadOutput = false } = {}) {
+        const [row] = await this.dbos.listWorkflows({ workflowIDs: [runId], loadInput: false, loadOutput });
+        if (!row)
+            throw new SanomaError("run_not_found", `No run ${runId}`, { runId });
+        return row;
+    }
+    /** The run's output once it ends, or its error, polled every 100 ms; `run_running` after `timeoutMs`. */
+    async awaitResult(runId, timeoutMs) {
+        const running = () => new SanomaError("run_running", `Run ${runId} is still running after ${timeoutMs} ms`, { runId, timeoutMs });
+        let timer;
+        try {
+            // DBOSClient's wait takes no timeout of its own.
+            return await Promise.race([
+                this.dbos.retrieveWorkflow(runId).getResult({ pollingIntervalMs: 100 }),
+                new Promise((_, reject) => {
+                    timer = setTimeout(() => reject(running()), timeoutMs).unref();
+                }),
+            ]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async summarize(r) {
+        const approvals = await this.approvals(r.workflowID);
+        const groups = r.authenticatedRoles ?? [];
+        return {
+            runId: r.workflowID,
+            workflow: r.workflowName,
+            status: runStatus(r.status, approvals),
+            startedBy: r.authenticatedUser ? { id: r.authenticatedUser, ...(groups.length ? { groups } : {}) } : undefined,
+            createdAt: r.createdAt,
+            updatedAt: r.updatedAt,
+            approvals,
+            error: r.error ? String(r.error.message ?? r.error) : undefined,
+            ...(typeof r.attributes?.sandbox === "string" && { sandbox: r.attributes.sandbox }),
+        };
+    }
+}
+/** The value as JSON reads it back: a Date as its string, undefined members gone. */
+const asJson = (v) => (v === undefined ? undefined : JSON.parse(JSON.stringify(v)));
+/** True when the two are the same JSON, whatever the order of their keys. */
+const sameJson = (a, b) => isDeepStrictEqual(asJson(a), asJson(b));
+/** What an environment variable's name looks like. */
+const VARIABLE = /^[A-Z_][A-Z0-9_]*$/;
+/** `options.by`, who sets or clears a credential: a name, or `invalid_input`. */
+const actorOf = (options) => parseOrThrow(z.string().min(1), options?.by, '`by` must name who is asking, such as "alice"');
+const alreadyDecided = (runId, a) => new SanomaError("already_decided", `${a.id} on run ${runId} was already ${a.status} by ${a.decidedBy}`, {
+    runId,
+    approvalId: a.id,
+    status: a.status,
+    decidedBy: a.decidedBy,
+});
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,126 @@
+import { type WorkflowDefinition } from "./define.ts";
+import type { Fake } from "./fake.ts";
+import type { LedgerStore } from "./ledger.ts";
+import { type Connector, type Driver, type DriverFn, type Op } from "./op.ts";
+import type { Policy } from "./policy.ts";
+import { type Resource } from "./resource.ts";
+import type { Steps } from "./steps.ts";
+/**
+ * What a worker runs, on which connectors, under which policy: the argument to `startWorker`.
+ * A project usually keeps it in `sanoma.config.ts` and passes it in; nothing loads that file
+ * automatically. The rest is convention: each connector carries its driver and its fake
+ * (`withSetup`), the app's name is its `package.json`'s, and the scenarios and data files are
+ * `scenarios/` and `resources/` in `root`.
+ */
+export interface SanomaConfig {
+    workflows: WorkflowDefinition<any, any>[];
+    /**
+     * The connectors (from `defineConnector`, as their packages export them). The worker takes
+     * each operation's effect, schemas and retry setting from here, not from the workflow, and
+     * refuses a workflow that declares an operation differently. A live run calls the driver its
+     * connector's package attaches; a sandbox run calls a fake of its own, which the connector's
+     * package attaches the maker of.
+     */
+    connectors: Connector<any, any>[];
+    /** Checked before every operation call. Required: `allowAll` says that every call is allowed. */
+    policy: Policy;
+    /**
+     * Where the audit record goes. Default: `postgresLedger` on the config's database, which the
+     * worker, the app and other processes share; the worker and the client each make their own
+     * and close it with themselves. A store given here is never closed by the runtime.
+     * `jsonlLedger(dir)` keeps it in files instead; `memoryLedger()` keeps it in this process
+     * only, for tests.
+     */
+    ledger?: LedgerStore;
+    /** Postgres for the runtime. Defaults to `SANOMA_DATABASE_URL`, then the local docker compose database. */
+    databaseUrl?: string;
+    /** The file that defined the config, absolute, when known. Set by `defineConfig` from its call site. */
+    file?: string;
+    /**
+     * The directory the config's conventions are relative to: its `package.json` (the app's name),
+     * `scenarios/` and `resources/`. Defaults to `file`'s directory; set it where that is not the
+     * source's, as in a bundle.
+     */
+    root?: string;
+    /** @deprecated Gone: each connector carries its driver (`withSetup`, from its package). Leave it out. */
+    drivers?: never;
+    /** @deprecated Gone: each connector carries the maker of its fake (`withSetup`, from its package). Leave it out. */
+    fakes?: never;
+    /** @deprecated Gone: the app's name is the `name` in `<root>/package.json`, else "sanoma". Leave it out. */
+    appName?: never;
+    /** @deprecated Gone: the scenarios are `<root>/scenarios/`. Leave it out. */
+    scenarios?: never;
+    /** The company's own steps for its scenarios (`defineSteps`), besides those its connectors ship. */
+    steps?: Steps[];
+}
+/** A config, checked, with everything a worker, client or app derives from it. */
+export interface ResolvedConfig {
+    /**
+     * Scopes workflows, queues and versions in the system database: the `name` of
+     * `<root>/package.json` when it names one, else "sanoma".
+     */
+    appName: string;
+    databaseUrl: string;
+    /** The DBOS application version: `<appName>@<DBOS__APPVERSION, or a hash of the workflows>`. */
+    version: string;
+    /** The DBOS queue runs are started on: `sanoma:<appName>`. */
+    queueName: string;
+    /** The operations the connectors declare, by id. */
+    ops: Map<string, Op>;
+    /** The drivers' functions, by operation id, each guarded by its driver's `env` (`indexDrivers`). */
+    drivers: Map<string, DriverFn>;
+    /**
+     * The driver each vendor's connector attaches, made once for this resolution, by vendor id in
+     * `connectors` order: what `drivers` indexes and the credentials are read from (`credentialsOf`).
+     */
+    driversByVendor: Map<string, Driver>;
+    /** The makers of the fakes the connectors attach, by vendor id in `connectors` order: each sandbox run makes its own. */
+    fakes: Map<string, () => Fake<any, any>>;
+    /** `scenarios/` in `root`, as a `file:` URL, when that directory exists. */
+    scenarios?: URL;
+    /** The resource types the connectors declare, by `<vendor>.<type>`: what the drift workflow checks and scenarios seed. */
+    types: ReadonlyMap<string, Resource>;
+    /** The steps scenarios can use besides the generic ones: each connector's (`withSetup`), once each, then the config's own. */
+    steps: readonly Steps[];
+    /**
+     * By name; each checked against `ops` and `drivers`. The config's, and the built-in `drift`
+     * (`DRIFT_WORKFLOW`) when its connectors declare resource types.
+     */
+    workflows: Map<string, WorkflowDefinition<any, any>>;
+    policy: Policy;
+    /** The config's `ledger`, when it gives one; the worker and the client otherwise make `postgresLedger` on `databaseUrl` (`ownedLedger`). */
+    ledger?: LedgerStore;
+    /**
+     * The config's directory, absolute: its `root`, else its `file`'s directory. Its data files
+     * are `resources/` in it. Absent when the config has neither, so it has no data files.
+     */
+    root?: string;
+}
+export declare const DEFAULT_DATABASE_URL = "postgresql://postgres:dbos@localhost:5433/sanoma";
+/** Returns the config, with the file it is called from as its `file`: its directory is the config's `root`. */
+export declare function defineConfig(config: SanomaConfig): SanomaConfig;
+export declare function resolveDatabaseUrl(config: {
+    databaseUrl?: string;
+}, env?: NodeJS.ProcessEnv): string;
+/**
+ * The config's directory, absolute: its `root`, else its `file`'s directory; undefined when it
+ * has neither. No fallback to the working directory: a config found nowhere has no data files,
+ * and says so. What a read that needs only the root calls, rather than `resolveConfig`.
+ */
+export declare function rootOf(config: Pick<SanomaConfig, "root" | "file">): string | undefined;
+/**
+ * Checks a config and derives what the runtime needs from it: the drivers and fakes from the
+ * connectors' setups (`withSetup`), and from `root`, the app's name (`package.json`) and the
+ * scenarios (`scenarios/`). Throws what `startWorker` would refuse, with the same message, so
+ * `describeConfig`, `SanomaClient.connect` and the app fail the same way the worker does. It
+ * opens nothing and reads no file outside `root`. Each entry
+ * point resolves once: the worker and the client when they start, the app at `startApp`, the
+ * `sanoma` bin when it loads the config.
+ */
+export declare function resolveConfig(config: SanomaConfig): ResolvedConfig;
+/**
+ * The drivers' functions by operation id, refusing one no connector declares. A driver that
+ * declares an `env` has each function guarded by it (`guarded`); a fake declares none, so a
+ * sandbox run's calls are not.
+ */
+export declare function indexDrivers(list: Driver[], ops: Map<string, Op>): Map<string, DriverFn>;