@synap-core/cli 1.11.0 → 1.12.2

package/dist/lib/init-connect.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The agents step of `synap init`: approve every key in one step FIRST, then
+ * install each agent, one line per agent ("✓ Codex connected"). An install's
+ * own output is shown only when it failed.
+ *
+ * "connected" is printed only after `confirm` read back the key the install
+ * wrote and the pod said it works (`confirmSurfaceKey`). A pod "no" prints the
+ * doctor's diagnosis; a check that could not run prints "? … could not
+ * confirm". Either way the agent counts as not connected.
+ *
+ * The approve, install and confirm doors are injected so the order and the
+ * per-agent outcome are testable without a pod.
+ */
+import type { TargetName } from "./targets.js";
+import type { BatchApprovalResult } from "./batch-approval.js";
+import type { SetupCheck } from "./key-doctor.js";
+export interface InstallOutcome {
+    ok: boolean;
+    /** What the installer printed; replayed only on failure. */
+    output: string;
+    error?: string;
+}
+export interface ConnectAgentsDeps<T extends TargetName> {
+    approve: (targets: readonly T[]) => Promise<BatchApprovalResult>;
+    install: (target: T) => Promise<InstallOutcome>;
+    /** Read back what the install wrote and ask the pod (`confirmSurfaceKey`). */
+    confirm: (target: T) => Promise<SetupCheck>;
+    labelOf: (target: T) => string;
+}
+export interface ConnectAgentsResult<T extends TargetName> {
+    connected: T[];
+    notApproved: T[];
+    failed: T[];
+}
+export declare function retryCommand(target: TargetName): string;
+/**
+ * The ONE place a setup prints "<Agent> connected": only for a confirmed key.
+ * Returns whether the agent counts as connected.
+ */
+export declare function reportSetupCheck(label: string, check: SetupCheck, connectedLine?: string): boolean;
+export declare function connectAgents<T extends TargetName>(picked: readonly T[], deps: ConnectAgentsDeps<T>): Promise<ConnectAgentsResult<T>>;

package/dist/lib/init-connect.js

@@ -0,0 +1,75 @@
+/**
+ * The agents step of `synap init`: approve every key in one step FIRST, then
+ * install each agent, one line per agent ("✓ Codex connected"). An install's
+ * own output is shown only when it failed.
+ *
+ * "connected" is printed only after `confirm` read back the key the install
+ * wrote and the pod said it works (`confirmSurfaceKey`). A pod "no" prints the
+ * doctor's diagnosis; a check that could not run prints "? … could not
+ * confirm". Either way the agent counts as not connected.
+ *
+ * The approve, install and confirm doors are injected so the order and the
+ * per-agent outcome are testable without a pod.
+ */
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+export function retryCommand(target) {
+    return chalk.cyan(`synap connect --target=${target}`);
+}
+/**
+ * The ONE place a setup prints "<Agent> connected": only for a confirmed key.
+ * Returns whether the agent counts as connected.
+ */
+export function reportSetupCheck(label, check, connectedLine = `${label} connected`) {
+    if (check.verdict === "active") {
+        log.success(connectedLine);
+        return true;
+    }
+    if (check.verdict === "unchecked") {
+        log.success(`${label} set up — not checked: ${check.reason}`);
+        return true;
+    }
+    if (check.verdict === "unconfirmed") {
+        // A failed check, not a dead key: "?" as the doctor prints it. Still not
+        // counted as connected, so a script's exit code sees it.
+        console.error(chalk.yellow(`  ? ${label} set up — could not confirm: ${check.reason}`));
+        log.hint("→ synap doctor");
+        return false;
+    }
+    log.warn(`${check.title} — not connected.`);
+    if (check.command)
+        log.hint(`→ ${check.command}`);
+    return false;
+}
+export async function connectAgents(picked, deps) {
+    const result = { connected: [], notApproved: [], failed: [] };
+    if (picked.length === 0)
+        return result;
+    const { notApproved, reasons } = await deps.approve(picked);
+    for (const target of picked) {
+        const label = deps.labelOf(target);
+        if (notApproved.includes(target)) {
+            log.warn(`${label} wasn't approved. Retry: ${retryCommand(target)}`);
+            const why = reasons[target];
+            if (why)
+                log.dim(why);
+            result.notApproved.push(target);
+            continue;
+        }
+        const outcome = await deps.install(target);
+        if (!outcome.ok) {
+            if (outcome.output)
+                process.stdout.write(outcome.output);
+            const why = outcome.error ? `: ${outcome.error.replace(/\.$/, "")}.` : ".";
+            log.warn(`${label} wasn't connected${why} Retry: ${retryCommand(target)}`);
+            result.failed.push(target);
+            continue;
+        }
+        if (reportSetupCheck(label, await deps.confirm(target)))
+            result.connected.push(target);
+        else
+            result.failed.push(target);
+    }
+    return result;
+}
+//# sourceMappingURL=init-connect.js.map

package/dist/lib/init-connect.js.map

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

package/dist/lib/init-exit.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `synap init` exit codes: ONE table, read by init and by its --help text,
+ * so a script can tell "no pod" from "cancelled" from "no agent connected".
+ */
+export declare const INIT_EXIT: {
+    readonly ok: 0;
+    readonly usage: 2;
+    readonly noPod: 3;
+    readonly cancelled: 4;
+    readonly noKey: 5;
+    readonly noAgent: 6;
+};
+export type InitExitCode = (typeof INIT_EXIT)[keyof typeof INIT_EXIT];
+export declare const INIT_EXIT_HELP: string;
+/**
+ * A setup step that cannot continue: init prints `message` (unless the step
+ * already `shown` it in its own words), puts it in the `--json` summary, and
+ * exits with `code`.
+ */
+export declare class InitExit extends Error {
+    readonly code: InitExitCode;
+    readonly shown: boolean;
+    constructor(code: InitExitCode, message: string, shown?: boolean);
+}

package/dist/lib/init-exit.js

@@ -0,0 +1,41 @@
+/**
+ * `synap init` exit codes: ONE table, read by init and by its --help text,
+ * so a script can tell "no pod" from "cancelled" from "no agent connected".
+ */
+export const INIT_EXIT = {
+    ok: 0,
+    usage: 2,
+    noPod: 3,
+    cancelled: 4,
+    noKey: 5,
+    noAgent: 6,
+};
+const MEANING = {
+    ok: "at least one agent connected",
+    usage: "not a terminal, or a bad flag (pass --pod-url and --agents)",
+    noPod: "no pod found, created or reachable",
+    cancelled: "cancelled",
+    noKey: "could not get your key for the pod (pass --api-key)",
+    noAgent: "the pod is ready but no agent was connected",
+};
+export const INIT_EXIT_HELP = "\nExit codes:\n" +
+    Object.keys(INIT_EXIT)
+        .map((k) => `  ${INIT_EXIT[k]}  ${MEANING[k]}`)
+        .join("\n") +
+    "\n";
+/**
+ * A setup step that cannot continue: init prints `message` (unless the step
+ * already `shown` it in its own words), puts it in the `--json` summary, and
+ * exits with `code`.
+ */
+export class InitExit extends Error {
+    code;
+    shown;
+    constructor(code, message, shown = false) {
+        super(message);
+        this.code = code;
+        this.shown = shown;
+        this.name = "InitExit";
+    }
+}
+//# sourceMappingURL=init-exit.js.map

package/dist/lib/init-exit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-exit.js","sourceRoot":"","sources":["../../src/lib/init-exit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;CACF,CAAC;AAIX,MAAM,OAAO,GAA2C;IACtD,EAAE,EAAE,8BAA8B;IAClC,KAAK,EAAE,6DAA6D;IACpE,KAAK,EAAE,oCAAoC;IAC3C,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,qDAAqD;IAC5D,OAAO,EAAE,6CAA6C;CACvD,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GACzB,iBAAiB;IAChB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAmC;SACtD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,IAAI,CAAC,IAAI,CAAC;IACb,IAAI,CAAC;AAEP;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEtB;IAEA;IAHX,YACW,IAAkB,EAC3B,OAAe,EACN,QAAQ,KAAK;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAc;QAElB,UAAK,GAAL,KAAK,CAAQ;QAGtB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/lib/init-flow.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `synap init` decisions that don't need a terminal: how the first key for a
+ * pod is offered. Pure, so they can be
+ * tested without spawning the CLI.
+ */
+/** A pod Synap hosts (`*.synap.live`): never on this machine, never has a .env. */
+export declare function isManagedPod(podUrl: string): boolean;
+export type KeyChoice = "device" | "paste";
+/**
+ * How to get the first key for a pod, in order. Connecting this computer first
+ * (the pod's device flow: a code approved on any device, on self-hosted and
+ * managed pods alike); pasting a key is the advanced way. The PROVISIONING_TOKEN
+ * is never offered: it is bootstrap-only on the pod (D9) and stops minting keys
+ * once the pod has an owner. A pod that cannot run the device flow (too old) is
+ * not offered it again; after a denied or expired code it is offered as a retry.
+ */
+export declare function keyChoices(input: {
+    managed: boolean;
+    deviceTried: boolean;
+    deviceAvailable: boolean;
+}): Array<{
+    title: string;
+    description: string;
+    value: KeyChoice;
+}>;

package/dist/lib/init-flow.js

@@ -0,0 +1,40 @@
+/**
+ * `synap init` decisions that don't need a terminal: how the first key for a
+ * pod is offered. Pure, so they can be
+ * tested without spawning the CLI.
+ */
+/** A pod Synap hosts (`*.synap.live`): never on this machine, never has a .env. */
+export function isManagedPod(podUrl) {
+    try {
+        const host = new URL(podUrl).hostname;
+        return host === "synap.live" || host.endsWith(".synap.live");
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * How to get the first key for a pod, in order. Connecting this computer first
+ * (the pod's device flow: a code approved on any device, on self-hosted and
+ * managed pods alike); pasting a key is the advanced way. The PROVISIONING_TOKEN
+ * is never offered: it is bootstrap-only on the pod (D9) and stops minting keys
+ * once the pod has an owner. A pod that cannot run the device flow (too old) is
+ * not offered it again; after a denied or expired code it is offered as a retry.
+ */
+export function keyChoices(input) {
+    const choices = [];
+    if (input.deviceAvailable) {
+        choices.push({
+            title: input.deviceTried ? "Connect this computer again (new code)" : "Connect this computer (recommended)",
+            description: "Gives you a link and a code. Approve it from any device.",
+            value: "device",
+        });
+    }
+    choices.push({
+        title: "Advanced: paste an API key",
+        description: "From your pod: Settings → API keys",
+        value: "paste",
+    });
+    return choices;
+}
+//# sourceMappingURL=init-flow.js.map

package/dist/lib/init-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-flow.js","sourceRoot":"","sources":["../../src/lib/init-flow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;QACtC,OAAO,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAID;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,KAA2E;IAKpG,MAAM,OAAO,GAAoE,EAAE,CAAC;IACpF,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC;YACX,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,qCAAqC;YAC3G,WAAW,EAAE,0DAA0D;YACvE,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,IAAI,CAAC;QACX,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,oCAAoC;QACjD,KAAK,EAAE,OAAO;KACf,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/lib/init-handoff.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The last thing `synap init` prints: one real task to hand the agent, verbatim.
+ *
+ * The first prompt exercises the whole loop — the agent works in a session,
+ * saves what it finds, then ASKS the person (the question lands on their phone)
+ * and resumes on the answer.
+ */
+export interface Handoff {
+    /** The agent to open, e.g. "Claude Code". */
+    agentLabel: string;
+    /** The prompt to paste into the agent, verbatim. */
+    prompt: string;
+    /** Two shorter follow-ups. */
+    more: string[];
+}
+export declare function buildHandoff(connectedLabels: readonly string[]): Handoff;

package/dist/lib/init-handoff.js

@@ -0,0 +1,19 @@
+/**
+ * The last thing `synap init` prints: one real task to hand the agent, verbatim.
+ *
+ * The first prompt exercises the whole loop — the agent works in a session,
+ * saves what it finds, then ASKS the person (the question lands on their phone)
+ * and resumes on the answer.
+ */
+export function buildHandoff(connectedLabels) {
+    return {
+        agentLabel: connectedLabels[0] ?? "your agent",
+        prompt: "Use Synap. Research 10 competitors to <your product>, save them, " +
+            "and ask me which 3 to contact.",
+        more: [
+            "Use Synap. Draft a short outreach email to the 3 I picked, and ask me before sending.",
+            "Use Synap. Find duplicate contacts in my CRM and ask me which to merge.",
+        ],
+    };
+}
+//# sourceMappingURL=init-handoff.js.map

package/dist/lib/init-handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-handoff.js","sourceRoot":"","sources":["../../src/lib/init-handoff.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,UAAU,YAAY,CAAC,eAAkC;IAC7D,OAAO;QACL,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,YAAY;QAC9C,MAAM,EACJ,mEAAmE;YACnE,gCAAgC;QAClC,IAAI,EAAE;YACJ,uFAAuF;YACvF,yEAAyE;SAC1E;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/init-output.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Terminal plumbing for `synap init`: collapse a step's output to one line
+ * unless it fails, and keep stdout clean for `--json`.
+ */
+/**
+ * Run `fn` with everything it writes to stdout/stderr held back. Returns the
+ * held output so the caller can replay it only when the step failed.
+ */
+export declare function withHeldOutput<T>(fn: () => Promise<T>): Promise<{
+    value?: T;
+    error?: unknown;
+    held: string;
+}>;
+/**
+ * For `--json`: send every human line to stderr for the rest of the run and
+ * return the one writer that still reaches stdout, for the JSON summary.
+ */
+export declare function reserveStdoutForJson(): (text: string) => void;

package/dist/lib/init-output.js

@@ -0,0 +1,43 @@
+/**
+ * Terminal plumbing for `synap init`: collapse a step's output to one line
+ * unless it fails, and keep stdout clean for `--json`.
+ */
+/**
+ * Run `fn` with everything it writes to stdout/stderr held back. Returns the
+ * held output so the caller can replay it only when the step failed.
+ */
+export async function withHeldOutput(fn) {
+    const chunks = [];
+    const outWrite = process.stdout.write;
+    const errWrite = process.stderr.write;
+    const hold = ((chunk, ...rest) => {
+        chunks.push(typeof chunk === "string" ? chunk : Buffer.from(chunk).toString());
+        const cb = rest.find((r) => typeof r === "function");
+        cb?.();
+        return true;
+    });
+    process.stdout.write = hold;
+    process.stderr.write = hold;
+    try {
+        return { value: await fn(), held: chunks.join("") };
+    }
+    catch (error) {
+        return { error, held: chunks.join("") };
+    }
+    finally {
+        process.stdout.write = outWrite;
+        process.stderr.write = errWrite;
+    }
+}
+/**
+ * For `--json`: send every human line to stderr for the rest of the run and
+ * return the one writer that still reaches stdout, for the JSON summary.
+ */
+export function reserveStdoutForJson() {
+    const outWrite = process.stdout.write.bind(process.stdout);
+    process.stdout.write = process.stderr.write.bind(process.stderr);
+    return (text) => {
+        outWrite(text);
+    };
+}
+//# sourceMappingURL=init-output.js.map

package/dist/lib/init-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-output.js","sourceRoot":"","sources":["../../src/lib/init-output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAI,EAAoB;IAC1D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,CAAC,KAA0B,EAAE,GAAG,IAAe,EAAE,EAAE;QAC/D,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/E,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,UAAU,CAA6B,CAAC;QACjF,EAAE,EAAE,EAAE,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC,CAAU,CAAC;IACZ,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1C,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC;IAClC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAU,CAAC;IAC1E,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/init-pod.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `synap init` with no pod: create one in the browser and continue here.
+ *
+ * Before this, init exited with code 2 and a help box when it found no pod,
+ * so its own "create one" branch (`waitForPodCallback`) was unreachable. This
+ * is that branch, reachable: open the provision page, wait for the callback,
+ * then wait until the new pod answers `/health` — a pod that is still booting
+ * is "starting", not "failed".
+ *
+ * Deps are injected so the flow is testable without a browser or a network.
+ */
+export interface CreatePodDeps {
+    /** Opens synap.live's provision page and resolves with the new pod's URL. */
+    waitForPodCallback: () => Promise<{
+        podUrl: string;
+    } | null>;
+    checkPodHealth: (podUrl: string) => Promise<{
+        healthy: boolean;
+    }>;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+}
+export type CreatePodResult = {
+    ok: true;
+    podUrl: string;
+}
+/** The browser flow timed out or was closed — nothing was created that we know of. */
+ | {
+    ok: false;
+    reason: "cancelled";
+}
+/** The pod exists but did not answer in time. Resume with `synap init --pod-url`. */
+ | {
+    ok: false;
+    reason: "not-reachable";
+    podUrl: string;
+};
+export declare function waitUntilReachable(podUrl: string, deps: Pick<CreatePodDeps, "checkPodHealth" | "sleep" | "now">, opts?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+}): Promise<boolean>;
+export declare function createPodInBrowser(deps: CreatePodDeps, opts?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+}): Promise<CreatePodResult>;

package/dist/lib/init-pod.js

@@ -0,0 +1,36 @@
+/**
+ * `synap init` with no pod: create one in the browser and continue here.
+ *
+ * Before this, init exited with code 2 and a help box when it found no pod,
+ * so its own "create one" branch (`waitForPodCallback`) was unreachable. This
+ * is that branch, reachable: open the provision page, wait for the callback,
+ * then wait until the new pod answers `/health` — a pod that is still booting
+ * is "starting", not "failed".
+ *
+ * Deps are injected so the flow is testable without a browser or a network.
+ */
+const defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export async function waitUntilReachable(podUrl, deps, opts = {}) {
+    const sleep = deps.sleep ?? defaultSleep;
+    const now = deps.now ?? Date.now;
+    const timeoutMs = opts.timeoutMs ?? 300_000;
+    const intervalMs = opts.intervalMs ?? 5_000;
+    const deadline = now() + timeoutMs;
+    for (;;) {
+        if ((await deps.checkPodHealth(podUrl)).healthy)
+            return true;
+        if (now() >= deadline)
+            return false;
+        await sleep(intervalMs);
+    }
+}
+export async function createPodInBrowser(deps, opts = {}) {
+    const created = await deps.waitForPodCallback();
+    if (!created?.podUrl)
+        return { ok: false, reason: "cancelled" };
+    const reachable = await waitUntilReachable(created.podUrl, deps, opts);
+    return reachable
+        ? { ok: true, podUrl: created.podUrl }
+        : { ok: false, reason: "not-reachable", podUrl: created.podUrl };
+}
+//# sourceMappingURL=init-pod.js.map

package/dist/lib/init-pod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-pod.js","sourceRoot":"","sources":["../../src/lib/init-pod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,MAAM,YAAY,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,IAA6D,EAC7D,OAAoD,EAAE;IAEtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,YAAY,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC;IAC5C,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAG,SAAS,CAAC;IACnC,SAAS,CAAC;QACR,IAAI,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC7D,IAAI,GAAG,EAAE,IAAI,QAAQ;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAmB,EACnB,OAAoD,EAAE;IAEtD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvE,OAAO,SAAS;QACd,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;QACtC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACrE,CAAC"}