humanish 0.105.0 → 0.106.0

package/dist/comms-agentmail.js.map

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

package/dist/comms-catch-host.d.ts

@@ -1,52 +0,0 @@
-/** The CLI writer surface this command needs (structurally compatible with program.ts CliIo). */
-interface CatchHostIo {
-    writeOut(text: string): void;
-    writeErr(text: string): void;
-    setExitCode(code: number): void;
-}
-export interface CommsCatchHostOptions {
-    port: number;
-    dir: string;
-    /** Bearer token required on GET /deliveries. Strongly recommended when the host is reachable. */
-    token?: string;
-    /** SECOND port for the READ-ONLY inbox listener bound to 0.0.0.0, so a persona on another machine
-     *  (or in a per-lane desktop) can reach the inbox. Omit to stay loopback-only. */
-    inboxPort?: number;
-    /** Optional loopback SMTP listener sharing the HTTP capture and inbox pipeline. */
-    smtpPort?: number;
-    /** Restrict the rendered inbox to these addresses. Omit to render whatever the app actually mailed
-     *  — a standalone catch has no lab roster to read recipients from, and an operator who forgets to
-     *  name one should not get a healthy catch that renders an empty inbox forever (#380). */
-    recipients?: string[];
-    /** Inbox re-render cadence in ms (test seam). */
-    renderIntervalMs?: number;
-}
-/**
- * Render the persona-facing inbox surface from the catch's own deliveries file into `surfaceDir`.
- *
- * This is the half that was missing on an adopter-hosted plane (#380). The catch serves /inbox and
- * /api/inbox as STATIC FILES; in-sandbox, humanish-as-host renders those files on a cadence. On a
- * plane humanish does not provision there is no such host, so nothing wrote them and every persona
- * that reached /inbox got `message not found` against a catch whose /health was green — the funnel
- * dead-ended at a technically-healthy service.
- *
- * Rebuilding from scratch each pass is deliberate and matches refreshInboxSurface: a fresh channel per
- * pass means a send is never routed twice, so the persona never sees duplicates, and a failed write
- * simply retries next tick.
- */
-export declare function renderInboxSurfaceLocally(args: {
-    deliveriesPath: string;
-    surfaceDir: string;
-    recipients?: string[] | undefined;
-}): Promise<{
-    sends: number;
-    messages: number;
-    files: number;
-}>;
-/**
- * Write the catch script and run it in the foreground. Resolves when the child exits; the caller's
- * Ctrl-C reaches the child through the shared process group, so the normal way to stop it is the
- * normal way to stop any foreground server.
- */
-export declare function runCommsCatchHost(options: CommsCatchHostOptions, io: CatchHostIo): Promise<void>;
-export {};

package/dist/comms-catch-host.js

@@ -1,178 +0,0 @@
-// `humanish comms catch` (#328): run the email catch on the OPERATOR's own host.
-//
-// Why this exists. The in-sandbox catch only works when humanish provisions the subject itself —
-// it clones the app into a sandbox, injects the email-API base URL at boot, and hosts the catch
-// alongside it. An adopter whose study runs against their OWN deployed environment (an app-url or
-// operator-provisioned plane) hands humanish a URL instead, so humanish never boots the app and
-// has nowhere to put a catch. Before this, a `comms:` block on that route was warned inert and the
-// personas simply stalled at the verification screen.
-//
-// The fix is to let the adopter host the same catch and declare it (`comms.email.external`).
-// Shipping it as a COMMAND rather than a spec matters: the adopter runs the identical
-// implementation humanish deploys in-sandbox, so the capture shape, the inbox surface, and the
-// drain contract cannot drift between the two planes. Point the app's email-API base URL at this
-// server and point the lab's `catchBaseUrl` at it too.
-//
-// Runtime: the catch is a python3 stdlib server with no dependencies (that was the 0.29.0 lesson —
-// a co-located catcher must use a runtime the environment guarantees). This command writes the
-// same script and runs it in the foreground until interrupted.
-import { spawn } from "node:child_process";
-import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { SANDBOX_CATCH_SCRIPT, capturedRecipientAddresses, inboxMessagesFrom, parseDeliveriesNdjson } from "./comms-sandbox-catch.js";
-import { buildInboxSurface } from "./comms-inbox.js";
-/** How often the host re-renders the inbox surface from the deliveries file. */
-const DEFAULT_RENDER_INTERVAL_MS = 3_000;
-/**
- * Render the persona-facing inbox surface from the catch's own deliveries file into `surfaceDir`.
- *
- * This is the half that was missing on an adopter-hosted plane (#380). The catch serves /inbox and
- * /api/inbox as STATIC FILES; in-sandbox, humanish-as-host renders those files on a cadence. On a
- * plane humanish does not provision there is no such host, so nothing wrote them and every persona
- * that reached /inbox got `message not found` against a catch whose /health was green — the funnel
- * dead-ended at a technically-healthy service.
- *
- * Rebuilding from scratch each pass is deliberate and matches refreshInboxSurface: a fresh channel per
- * pass means a send is never routed twice, so the persona never sees duplicates, and a failed write
- * simply retries next tick.
- */
-export async function renderInboxSurfaceLocally(args) {
-    let text = "";
-    try {
-        text = await readFile(args.deliveriesPath, "utf8");
-    }
-    catch {
-        text = ""; // no mail captured yet — still render, so /inbox answers "No messages yet."
-    }
-    const sends = parseDeliveriesNdjson(text);
-    const addresses = args.recipients && args.recipients.length > 0 ? args.recipients : capturedRecipientAddresses(sends);
-    const recipients = addresses.map((address, index) => ({
-        lane: `catch-${String(index + 1).padStart(2, "0")}`,
-        address
-    }));
-    const messages = await inboxMessagesFrom(sends, recipients);
-    const files = buildInboxSurface(messages, { recipients: addresses });
-    // A reused catch directory can change recipients or truncate its delivery log. Remove ONLY files
-    // recorded as generated routes, so old recipient/message URLs cannot survive that change.
-    const manifestPath = path.join(args.surfaceDir, ".inbox-files.json");
-    let previous = [];
-    try {
-        previous = JSON.parse(await readFile(manifestPath, "utf8"));
-    }
-    catch (error) {
-        if (error.code !== "ENOENT")
-            throw error;
-    }
-    const generatedPath = /^(?:api\/)?inbox\/(?:for\/[a-f0-9]{64}\/)?(?:index|(?:comms-[0-9]+|latest)(?:\/index|\/synth)?)$/;
-    const oldPaths = Array.isArray(previous) ? previous.filter((value) => typeof value === "string" && generatedPath.test(value)) : [];
-    const currentPaths = new Set(files.map((file) => file.path));
-    const dirs = new Set([args.surfaceDir]);
-    for (const file of files) {
-        const slash = file.path.lastIndexOf("/");
-        if (slash > 0)
-            dirs.add(path.join(args.surfaceDir, file.path.slice(0, slash)));
-    }
-    for (const dir of dirs)
-        await mkdir(dir, { recursive: true });
-    const saveManifest = async (paths) => {
-        await writeFile(manifestPath + ".next", JSON.stringify(paths), "utf8");
-        await rename(manifestPath + ".next", manifestPath);
-    };
-    // Record the union first: a partial write is retryable and its new files remain tracked.
-    await saveManifest([...new Set([...oldPaths, ...currentPaths])]);
-    for (const obsolete of oldPaths)
-        if (!currentPaths.has(obsolete))
-            await rm(path.join(args.surfaceDir, obsolete), { force: true });
-    for (const file of files)
-        await writeFile(path.join(args.surfaceDir, file.path), file.body, "utf8");
-    await saveManifest([...currentPaths]);
-    return { sends: sends.length, messages: messages.length, files: files.length };
-}
-/**
- * Write the catch script and run it in the foreground. Resolves when the child exits; the caller's
- * Ctrl-C reaches the child through the shared process group, so the normal way to stop it is the
- * normal way to stop any foreground server.
- */
-export async function runCommsCatchHost(options, io) {
-    const dir = path.resolve(options.dir);
-    const scriptPath = path.join(dir, "catch.py");
-    const deliveriesPath = path.join(dir, "deliveries.ndjson");
-    const surfaceDir = path.join(dir, "surface");
-    await mkdir(surfaceDir, { recursive: true });
-    await writeFile(scriptPath, SANDBOX_CATCH_SCRIPT, "utf8");
-    // Render the EMPTY inbox before the server is announced, so /inbox resolves to the "No messages
-    // yet." page from the first request instead of a bare `message not found` (#380) — a persona reads
-    // that 404 as a broken product and reports a blocker that is really just an empty mailbox.
-    await renderInboxSurfaceLocally({
-        deliveriesPath,
-        surfaceDir,
-        ...(options.recipients === undefined ? {} : { recipients: options.recipients })
-    });
-    const inboxPort = options.inboxPort;
-    const args = [
-        scriptPath,
-        String(options.port),
-        deliveriesPath,
-        surfaceDir,
-        String(inboxPort ?? 0),
-        options.token ?? "",
-        String(options.smtpPort ?? 0)
-    ];
-    io.writeOut([
-        `Starting humanish comms catch on http://127.0.0.1:${options.port}`,
-        ...(options.smtpPort === undefined ? [] : [`  SMTP 127.0.0.1:${options.smtpPort} <- point your app's SMTP transport here`]),
-        ...(inboxPort === undefined
-            ? []
-            : [`  read-only inbox listener on http://0.0.0.0:${inboxPort} (GET only; expose THIS to personas)`]),
-        `  POST /emails        <- point your app's email-API base URL here`,
-        `  GET  /inbox         <- shared operator inbox${inboxPort === undefined ? " (loopback only without --inbox-port)" : ""}`,
-        `  GET  /inbox/for/... <- assigned participant inbox (linked by the lab)`,
-        `  GET  /deliveries    <- humanish drains this${options.token ? " (bearer token required)" : ""}`,
-        `  GET  /health        <- readiness marker humanish probes before a run`,
-        ``,
-        `Declare it in the lab:`,
-        `  comms:`,
-        `    email:`,
-        `      external:`,
-        `        catchBaseUrl: http://<this-host>:${options.port}`,
-        ...(inboxPort === undefined ? [] : [`        inboxBaseUrl: http://<this-host>:${inboxPort}`]),
-        ...(options.token ? [`        authTokenEnv: HUMANISH_COMMS_TOKEN   # value read at runtime, never persisted`] : []),
-        ``,
-        `Captured mail is written to ${deliveriesPath}. Raw bodies stay on THIS host: the run bundle`,
-        `only ever receives digests (from/to/subject/link) and an OTP count.`,
-        ``
-    ].join("\n") + "\n");
-    await new Promise((resolve) => {
-        const child = spawn("python3", args, { stdio: ["ignore", "inherit", "inherit"] });
-        // Keep the inbox current while the catch runs. Failures are swallowed on purpose: a transient
-        // render error must never take down a server that is still capturing mail correctly, and the
-        // next tick rebuilds from scratch anyway.
-        let rendering = false;
-        const renderTimer = setInterval(() => {
-            if (rendering)
-                return;
-            rendering = true;
-            void renderInboxSurfaceLocally({
-                deliveriesPath,
-                surfaceDir,
-                ...(options.recipients === undefined ? {} : { recipients: options.recipients })
-            }).catch(() => { }).finally(() => { rendering = false; });
-        }, options.renderIntervalMs ?? DEFAULT_RENDER_INTERVAL_MS);
-        renderTimer.unref?.();
-        const stopRendering = () => clearInterval(renderTimer);
-        child.on("error", (error) => {
-            stopRendering();
-            io.writeErr(`comms catch failed to start (python3 is required): ${error.message}\n`);
-            io.setExitCode(2);
-            resolve();
-        });
-        child.on("exit", (code) => {
-            stopRendering();
-            if (code !== 0 && code !== null) {
-                io.setExitCode(2);
-            }
-            resolve();
-        });
-    });
-}
-//# sourceMappingURL=comms-catch-host.js.map

package/dist/comms-catch-host.js.map

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

package/dist/comms-connections.d.ts

@@ -1,52 +0,0 @@
-import { type KeyResolutionDeps } from "./key-resolution.js";
-import type { CommsCheckResult } from "./comms-setup.js";
-export declare const COMMS_CONNECTIONS_SCHEMA = "humanish.comms-connections.v1";
-export declare const COMMS_CONFIG_PATH = ".humanish/local/comms.yaml";
-export declare const COMMS_PROVIDERS: readonly [{
-    readonly id: "agentmail";
-    readonly label: "AgentMail";
-    readonly channel: "email";
-    readonly keyEnv: "AGENTMAIL_API_KEY";
-    readonly setupAvailable: true;
-    readonly receivingAvailable: true;
-    readonly description: "A hosted email service with real inbox addresses.";
-    readonly setupUrl: "https://console.agentmail.to";
-    readonly limitation: "Fresh real inboxes for supported computer-use studies. Hosted processing; local evidence review only. Provider charges are separate.";
-}];
-export interface CommsConnection {
-    provider: "agentmail";
-    apiKeyEnv: string;
-}
-export interface CommsConnections {
-    schema: typeof COMMS_CONNECTIONS_SCHEMA;
-    connections: Record<string, CommsConnection>;
-}
-export interface CommsSetupStatus {
-    authentication?: CommsCheckResult;
-    schema: "humanish.comms-setup.v1";
-    ok: boolean;
-    configPath: string;
-    providers: typeof COMMS_PROVIDERS;
-    connections: {
-        name: string;
-        provider: "agentmail";
-        apiKeyEnv: string;
-    }[];
-    credential: {
-        present: boolean;
-        source: string | null;
-        stored: boolean;
-        strict: boolean;
-        explicitlyEmpty: boolean;
-    };
-    message: string;
-}
-export interface CommsSetupResult {
-    ok: boolean;
-    message: string;
-}
-/** Offline and non-mutating. Unsafe storage is an error, never an empty configuration. */
-export declare function readCommsConnections(cwd: string): Promise<CommsConnections>;
-/** Add one exact profile. No lab mutation, network, provider resources or credential values. */
-export declare function saveCommsConnection(cwd: string, name?: string, apiKeyEnv?: string): Promise<CommsSetupResult>;
-export declare function readCommsSetup(cwd: string, env: NodeJS.ProcessEnv, deps?: KeyResolutionDeps): Promise<CommsSetupStatus>;

package/dist/comms-connections.js

@@ -1,123 +0,0 @@
-import { constants } from "node:fs";
-import { lstat, open, unlink } from "node:fs/promises";
-import path from "node:path";
-import { parse, stringify } from "yaml";
-import { listUserKeys, probeKeySources } from "./key-resolution.js";
-import { assertPreparedSelectedOutputDirectory, bindExistingManagedHumanishOutputDirectory, prepareManagedHumanishOutputDirectory, readContainedRegularFile, writeContainedOutputFile } from "./selected-output-paths.js";
-export const COMMS_CONNECTIONS_SCHEMA = "humanish.comms-connections.v1";
-export const COMMS_CONFIG_PATH = ".humanish/local/comms.yaml";
-export const COMMS_PROVIDERS = [{
-        id: "agentmail", label: "AgentMail", channel: "email", keyEnv: "AGENTMAIL_API_KEY",
-        setupAvailable: true, receivingAvailable: true,
-        description: "A hosted email service with real inbox addresses.",
-        setupUrl: "https://console.agentmail.to",
-        limitation: "Fresh real inboxes for supported computer-use studies. Hosted processing; local evidence review only. Provider charges are separate."
-    }];
-const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const validName = (name) => /^[a-z][a-z0-9-]{0,47}$/.test(name) && name !== "constructor" && name !== "prototype";
-const empty = () => ({ schema: COMMS_CONNECTIONS_SCHEMA, connections: {} });
-async function exists(file) {
-    try {
-        await lstat(file);
-        return true;
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return false;
-        throw error;
-    }
-}
-function parseConnections(raw) {
-    if (!record(raw) || raw.schema !== COMMS_CONNECTIONS_SCHEMA || !record(raw.connections)
-        || Object.keys(raw).some(key => key !== "schema" && key !== "connections")
-        || Object.keys(raw.connections).length > 32)
-        throw new Error("Invalid connection configuration.");
-    const connections = {};
-    for (const [name, value] of Object.entries(raw.connections)) {
-        if (!validName(name) || !record(value) || value.provider !== "agentmail"
-            || typeof value.apiKeyEnv !== "string" || !/^[A-Z][A-Z0-9_]{0,99}$/.test(value.apiKeyEnv)
-            || Object.keys(value).some(key => key !== "provider" && key !== "apiKeyEnv"))
-            throw new Error("Invalid connection configuration.");
-        connections[name] = { provider: "agentmail", apiKeyEnv: value.apiKeyEnv };
-    }
-    return { schema: COMMS_CONNECTIONS_SCHEMA, connections };
-}
-/** Offline and non-mutating. Unsafe storage is an error, never an empty configuration. */
-export async function readCommsConnections(cwd) {
-    const root = await bindExistingManagedHumanishOutputDirectory(cwd, "local");
-    if (!root) {
-        if (await exists(path.resolve(cwd, ".humanish", "local")))
-            throw new Error("Unsafe connection directory.");
-        return empty();
-    }
-    const file = path.join(root.physicalPath, "comms.yaml");
-    if (!await exists(file))
-        return empty();
-    if ((await lstat(file)).size > 65_536)
-        throw new Error("Connection configuration is too large.");
-    const bytes = await readContainedRegularFile(root, "comms.yaml");
-    if (!bytes || bytes.length > 65_536)
-        throw new Error("Cannot safely read connection configuration.");
-    // YAML diagnostics may echo the offending value; do not let them reach a status or frame.
-    try {
-        return parseConnections(parse(bytes.toString("utf8"), { maxAliasCount: 0 }));
-    }
-    catch {
-        throw new Error("Invalid connection configuration.");
-    }
-}
-/** Add one exact profile. No lab mutation, network, provider resources or credential values. */
-export async function saveCommsConnection(cwd, name = "agentmail", apiKeyEnv = "AGENTMAIL_API_KEY") {
-    try {
-        parseConnections({ schema: COMMS_CONNECTIONS_SCHEMA, connections: { [name]: { provider: "agentmail", apiKeyEnv } } });
-        // Read before creating storage, so malformed or redirected existing configuration fails first.
-        await readCommsConnections(cwd);
-        const root = await prepareManagedHumanishOutputDirectory(cwd, "local");
-        const lockPath = path.join(root.physicalPath, ".comms-setup.lock");
-        const lock = await open(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | constants.O_NOFOLLOW, 0o600);
-        const identity = await lock.stat();
-        try {
-            await assertPreparedSelectedOutputDirectory(root);
-            const config = await readCommsConnections(cwd);
-            const previous = config.connections[name];
-            if (previous && (previous.provider !== "agentmail" || previous.apiKeyEnv !== apiKeyEnv)) {
-                return { ok: false, message: "That connection name already uses different settings. Choose another name." };
-            }
-            config.connections[name] = { provider: "agentmail", apiKeyEnv };
-            parseConnections(config);
-            await writeContainedOutputFile(root, "comms.yaml", stringify(config), "utf8");
-            return { ok: true, message: "Connection saved for this project. Select it in a supported lab to use fresh real inboxes." };
-        }
-        finally {
-            await lock.close();
-            await assertPreparedSelectedOutputDirectory(root);
-            const current = await lstat(lockPath);
-            if (current.dev === identity.dev && current.ino === identity.ino)
-                await unlink(lockPath);
-        }
-    }
-    catch (error) {
-        return { ok: false, message: error.code === "EEXIST"
-                ? "Connection setup is locked. Close another setup session; after an interrupted save, remove .humanish/local/.comms-setup.lock and retry."
-                : "Could not save the connection. Inspect .humanish/local/comms.yaml and its directory permissions before retrying." };
-    }
-}
-export async function readCommsSetup(cwd, env, deps) {
-    const base = { schema: "humanish.comms-setup.v1", configPath: COMMS_CONFIG_PATH, providers: COMMS_PROVIDERS };
-    const credential = { present: false, source: null, stored: false,
-        strict: env.HUMANISH_STRICT_KEYS?.trim() === "1", explicitlyEmpty: env.AGENTMAIL_API_KEY !== undefined && env.AGENTMAIL_API_KEY.trim() === "" };
-    try {
-        const config = await readCommsConnections(cwd);
-        const [probe] = await probeKeySources(["AGENTMAIL_API_KEY"], { cwd, env, ...(deps ? { deps } : {}) });
-        credential.source = probe?.source ?? null;
-        credential.present = credential.source !== null;
-        credential.stored = listUserKeys(env, deps).includes("AGENTMAIL_API_KEY");
-        return { ...base, ok: true, connections: Object.entries(config.connections).map(([name, value]) => ({ name, ...value })), credential,
-            message: "Checks are local. Authentication, permissions, capacity and delivery have not been verified." };
-    }
-    catch {
-        return { ...base, ok: false, connections: [], credential,
-            message: "Could not read connection setup. Check .humanish/local/comms.yaml and key-store permissions. No changes were made." };
-    }
-}
-//# sourceMappingURL=comms-connections.js.map

package/dist/comms-connections.js.map

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

package/dist/comms-email-catch.d.ts

@@ -1,54 +0,0 @@
-import { type ServerResponse } from "node:http";
-import type { CommsChannel, CommsInlineImage } from "./comms-types.js";
-/** One send, normalized across providers. `body` is html-preferred, else text. */
-export interface NormalizedSend {
-    from: string;
-    to: string[];
-    subject?: string;
-    body: string;
-    inlineImages?: CommsInlineImage[];
-}
-/**
- * A provider wire-shape adapter. Vendor-neutral seam: the server owns the HTTP + routing + bus
- * delivery; a profile only knows how ONE provider (or a custom app) shapes its send request.
- */
-export interface EmailSendProfile {
-    /** Descriptive name (e.g. "generic", "sendgrid"). Not a dependency — just a label. */
-    name: string;
-    /** Request paths (method POST) this profile accepts a send on. */
-    sendPaths: string[];
-    /** Parse a POST body (already JSON-parsed) into zero+ normalized sends (a batch yields many). */
-    parse(path: string, body: unknown): NormalizedSend[];
-    /** Optional provider-faithful success response. Default: 200 `{ id }` (single) / `{ data:[{id}] }`. */
-    respond?: (res: ServerResponse, ids: string[], batch: boolean) => void;
-}
-export interface EmailCatchServer {
-    /** Point the app's email-API base URL here (loopback only). */
-    readonly url: string;
-    readonly port: number;
-    /** Every normalized send accepted this run (runtime-only; for inspection/tests). */
-    readonly received: NormalizedSend[];
-    close(): Promise<void>;
-}
-export interface EmailCatchOptions {
-    /** Bind host. Default 127.0.0.1 (loopback ONLY). */
-    host?: string;
-    /** Port. Default 0 (ephemeral). */
-    port?: number;
-    /** Wire-shape profiles, tried in order by path. Default [genericEmailProfile, sendgridEmailProfile]. */
-    profiles?: EmailSendProfile[];
-    /** Deterministic id for responses (tests). Default a zero-padded counter. */
-    idFor?: (n: number) => string;
-}
-/** The flat-JSON shape: `{ from, to, subject, html, text }`. Matches Resend (POST /emails) AND a
- *  custom app that sends the common shape AND Postmark's TitleCase keys (From/To/HtmlBody/…). */
-export declare const genericEmailProfile: EmailSendProfile;
-/** SendGrid's nested shape: `from.email`, `personalizations[].to[].email`, `content[].value`. Proves
- *  the seam handles a structurally different vendor, not just a field-name rename. */
-export declare const sendgridEmailProfile: EmailSendProfile;
-export declare const DEFAULT_EMAIL_PROFILES: EmailSendProfile[];
-/**
- * Start the vendor-neutral email catch, routing accepted sends into `channel`. Returns the loopback
- * URL to hand the app as its email-API base URL. `close()` in a finally (mirror by-id teardown).
- */
-export declare function startEmailCatchServer(channel: CommsChannel, options?: EmailCatchOptions): Promise<EmailCatchServer>;