@enderfga/claw-orchestrator 3.7.1 → 4.0.3

package/dist/src/ultraapp/host-strategy.js

@@ -0,0 +1,205 @@
+/**
+ * Host-spawn runtime strategy — runs the generated app as a regular Node
+ * process on the host, no Docker. The natural default for personal /
+ * internal-tool use; Docker is the opt-in mode for shared production
+ * hosts where isolation matters.
+ *
+ * Mirrors the docker.ts shape (`build / run / stop / start / rm`) so the
+ * deploy orchestrator and lifecycle helpers stay the same.
+ *
+ * State persistence:
+ *   ~/.claw-orchestrator/host-procs.json keyed by container-name (we keep
+ *   the term to match the rest of the API) → { pid, port, cwd, env, since }.
+ *   Survives orchestrator restarts: hostStart re-spawns from the saved
+ *   metadata, hostStop kills the recorded pid + child group.
+ */
+import { spawn } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+const STATE_FILE = path.join(os.homedir(), '.claw-orchestrator', 'host-procs.json');
+function readState() {
+    try {
+        return JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeState(state) {
+    fs.mkdirSync(path.dirname(STATE_FILE), { recursive: true });
+    fs.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2));
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Host build = `npm install` + `npm run build` (if a build script exists).
+ * No isolation; we mutate the worktree directly. The "tag" is metadata only
+ * — host-mode doesn't have container images.
+ */
+export async function hostBuild(args) {
+    if (!fs.existsSync(path.join(args.cwd, 'package.json'))) {
+        return { ok: false, error: `no package.json at ${args.cwd}` };
+    }
+    const install = await runCmd('npm', ['install'], { cwd: args.cwd, env: args.buildArgs });
+    if (!install.ok)
+        return { ok: false, error: `npm install failed: ${install.stderr.slice(0, 500)}` };
+    // Only run build if the script exists.
+    const pkg = JSON.parse(fs.readFileSync(path.join(args.cwd, 'package.json'), 'utf8'));
+    if (pkg.scripts?.build) {
+        const build = await runCmd('npm', ['run', 'build'], { cwd: args.cwd, env: args.buildArgs });
+        if (!build.ok)
+            return { ok: false, error: `npm run build failed: ${build.stderr.slice(0, 500)}` };
+    }
+    return { ok: true, imageId: `host:${args.tag}` };
+}
+/**
+ * Host run = spawn `npm start` (or `node server.js` fallback) detached, with
+ * PORT + caller env. Records pid in host-procs.json keyed by name.
+ */
+export async function hostRun(args) {
+    // image arg is repurposed to mean "cwd of the codebase" in host mode. The
+    // caller (deploy orchestrator) passes `tag` as image; we accept either
+    // a tag (which we look up — but we don't have a registry, so we expect
+    // the caller passes the cwd directly via image).
+    // NOTE: deploy.ts currently passes `tag` not `cwd`. We need the cwd
+    // separately — passed via env.HOST_CWD as a contract for host mode.
+    const cwd = args.env.HOST_CWD || args.image;
+    if (!fs.existsSync(path.join(cwd, 'package.json'))) {
+        return { ok: false, error: `no package.json at ${cwd}` };
+    }
+    // Strip the contract env keys from what gets exported to the child
+    const childEnv = { ...process.env, ...args.env };
+    delete childEnv.HOST_CWD;
+    childEnv.PORT = String(args.hostPort);
+    const pkg = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'));
+    let cmd;
+    let cmdArgs;
+    if (pkg.scripts?.start) {
+        cmd = 'npm';
+        cmdArgs = ['start'];
+    }
+    else if (pkg.main) {
+        cmd = 'node';
+        cmdArgs = [pkg.main];
+    }
+    else {
+        return { ok: false, error: 'no scripts.start and no main entry in package.json' };
+    }
+    const child = spawn(cmd, cmdArgs, {
+        cwd,
+        env: childEnv,
+        detached: true,
+        stdio: 'ignore',
+    });
+    child.unref();
+    const pid = child.pid;
+    if (typeof pid !== 'number') {
+        return { ok: false, error: 'spawn returned no pid' };
+    }
+    const state = readState();
+    state[args.name] = {
+        pid,
+        port: args.hostPort,
+        cwd,
+        env: args.env,
+        since: new Date().toISOString(),
+    };
+    writeState(state);
+    return { ok: true, containerName: args.name };
+}
+export async function hostStop(name) {
+    const state = readState();
+    const entry = state[name];
+    if (!entry)
+        return { ok: false, error: `no host proc named ${name}` };
+    if (isAlive(entry.pid)) {
+        try {
+            // Kill the process group (child + grandchildren via npm)
+            process.kill(-entry.pid, 'SIGTERM');
+        }
+        catch {
+            try {
+                process.kill(entry.pid, 'SIGTERM');
+            }
+            catch {
+                /* already dead */
+            }
+        }
+        // Give it a beat then SIGKILL if still alive
+        await new Promise((r) => setTimeout(r, 250));
+        if (isAlive(entry.pid)) {
+            try {
+                process.kill(-entry.pid, 'SIGKILL');
+            }
+            catch {
+                try {
+                    process.kill(entry.pid, 'SIGKILL');
+                }
+                catch {
+                    /* already dead */
+                }
+            }
+        }
+    }
+    return { ok: true };
+}
+export async function hostStart(name) {
+    const state = readState();
+    const entry = state[name];
+    if (!entry)
+        return { ok: false, error: `no host proc named ${name}` };
+    if (isAlive(entry.pid))
+        return { ok: true }; // already running
+    // Re-spawn using saved metadata
+    const r = await hostRun({
+        image: entry.cwd,
+        name,
+        hostPort: entry.port,
+        env: { ...entry.env, HOST_CWD: entry.cwd },
+    });
+    return r.ok ? { ok: true } : { ok: false, error: r.error };
+}
+export async function hostRm(name) {
+    await hostStop(name).catch(() => ({ ok: true }));
+    const state = readState();
+    delete state[name];
+    writeState(state);
+    return { ok: true };
+}
+/** Stub matching dockerRmi — host mode has no images, so this is a no-op. */
+export async function hostRmi(_tag) {
+    return { ok: true };
+}
+export async function hostPs() {
+    const state = readState();
+    const containers = Object.entries(state).map(([name, entry]) => ({
+        name,
+        state: isAlive(entry.pid) ? 'running' : 'exited',
+        ports: `${entry.port}->${entry.port}`,
+    }));
+    return { containers };
+}
+function runCmd(cmd, args, opts) {
+    return new Promise((resolve) => {
+        const child = spawn(cmd, args, {
+            cwd: opts.cwd,
+            env: { ...process.env, ...(opts.env ?? {}) },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (d) => (stdout += d.toString()));
+        child.stderr?.on('data', (d) => (stderr += d.toString()));
+        child.on('close', (code) => resolve({ ok: code === 0, stdout, stderr }));
+        child.on('error', (e) => resolve({ ok: false, stdout, stderr: stderr + e.message }));
+    });
+}
+//# sourceMappingURL=host-strategy.js.map

package/dist/src/ultraapp/host-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-strategy.js","sourceRoot":"","sources":["../../../src/ultraapp/host-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;AAUpF,SAAS,SAAS;IAChB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAkC,CAAC;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAoC;IACtD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,OAAO,CAAC,GAAW;IAC1B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAQD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB;IACjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAChE,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACzF,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAEpG,uCAAuC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAElF,CAAC;IACF,IAAI,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5F,IAAI,CAAC,KAAK,CAAC,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IACpG,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AACnD,CAAC;AAWD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,0EAA0E;IAC1E,uEAAuE;IACvE,uEAAuE;IACvE,iDAAiD;IACjD,oEAAoE;IACpE,oEAAoE;IACpE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;QACnD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,GAAG,EAAE,EAAE,CAAC;IAC3D,CAAC;IACD,mEAAmE;IACnE,MAAM,QAAQ,GAA2B,EAAE,GAAI,OAAO,CAAC,GAA8B,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACrG,OAAO,QAAQ,CAAC,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAG7E,CAAC;IACF,IAAI,GAAW,CAAC;IAChB,IAAI,OAAiB,CAAC;IACtB,IAAI,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACvB,GAAG,GAAG,KAAK,CAAC;QACZ,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;SAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACpB,GAAG,GAAG,MAAM,CAAC;QACb,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oDAAoD,EAAE,CAAC;IACpF,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE;QAChC,GAAG;QACH,GAAG,EAAE,QAAQ;QACb,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACtB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACjB,GAAG;QACH,IAAI,EAAE,IAAI,CAAC,QAAQ;QACnB,GAAG;QACH,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAChC,CAAC;IACF,UAAU,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,IAAI,EAAE,EAAE,CAAC;IACtE,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,yDAAyD;YACzD,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;QACH,CAAC;QACD,6CAA6C;QAC7C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACrC,CAAC;gBAAC,MAAM,CAAC;oBACP,kBAAkB;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,IAAI,EAAE,EAAE,CAAC;IACtE,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB;IAC/D,gCAAgC;IAChC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC;QACtB,KAAK,EAAE,KAAK,CAAC,GAAG;QAChB,IAAI;QACJ,QAAQ,EAAE,KAAK,CAAC,IAAI;QACpB,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE;KAC3C,CAAC,CAAC;IACH,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY;IACvC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,UAAU,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY;IACxC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI;QACJ,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;QAChD,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE;KACtC,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC;AAQD,SAAS,MAAM,CAAC,GAAW,EAAE,IAAc,EAAE,IAAmD;IAC9F,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAiB,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;YAC3C,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,EAAE,GAAI,OAAO,CAAC,GAA8B,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;YACxE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAClE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAClE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACzE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/ultraapp/interview-parser.d.ts

@@ -0,0 +1,41 @@
+export interface QuestionEnvelope {
+    question: string;
+    options: Array<{
+        label: string;
+        value: string;
+    }>;
+    recommended: string;
+    freeformAccepted: boolean;
+    context?: string;
+}
+export interface ToolCall {
+    name: string;
+    argsRaw: string;
+}
+export type ParsedReply = {
+    kind: 'question';
+    question: QuestionEnvelope;
+    rawText: string;
+} | {
+    kind: 'complete';
+    summary: string;
+} | {
+    /** Tool calls AND a question in the same reply. The manager runs the
+        tools, sends the tool_result followup (background), and emits the
+        question to the user without waiting for another LLM round-trip. */
+    kind: 'tools-and-question';
+    toolCalls: ToolCall[];
+    question: QuestionEnvelope;
+    rawText: string;
+} | {
+    kind: 'tools';
+    toolCalls: ToolCall[];
+    rawText: string;
+} | {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'error';
+    reason: string;
+};
+export declare function parseInterviewReply(reply: string): ParsedReply;

package/dist/src/ultraapp/interview-parser.js

@@ -0,0 +1,83 @@
+const FENCE_RE = /```question\s*\n([\s\S]*?)\n```/;
+const COMPLETE_RE = /^\[INTERVIEW:\s*COMPLETE\]\s*$/m;
+const TOOL_RE = /<tool\s+name="([a-z_]+)"\s*>([\s\S]*?)<\/tool>/g;
+export function parseInterviewReply(reply) {
+    const tools = [];
+    let m;
+    TOOL_RE.lastIndex = 0;
+    while ((m = TOOL_RE.exec(reply)) !== null) {
+        tools.push({ name: m[1], argsRaw: m[2].trim() });
+    }
+    // Try to also parse a fenced question — it's common (and previously
+    // dropped silently) for Claude to emit tool calls AND the next question
+    // in a single reply.
+    const parsedQuestion = (() => {
+        const fence = FENCE_RE.exec(reply);
+        if (!fence)
+            return null;
+        let parsed;
+        try {
+            parsed = JSON.parse(fence[1]);
+        }
+        catch {
+            return null;
+        }
+        const v = validateQuestion(parsed);
+        return v.ok ? v.value : null;
+    })();
+    if (tools.length > 0 && parsedQuestion) {
+        return { kind: 'tools-and-question', toolCalls: tools, question: parsedQuestion, rawText: reply };
+    }
+    if (tools.length > 0) {
+        return { kind: 'tools', toolCalls: tools, rawText: reply };
+    }
+    if (COMPLETE_RE.test(reply)) {
+        return { kind: 'complete', summary: reply.replace(COMPLETE_RE, '').trim() };
+    }
+    if (parsedQuestion) {
+        return { kind: 'question', question: parsedQuestion, rawText: reply };
+    }
+    // Re-run the parse to surface a malformed-fence error if a fence was present
+    // but its JSON was bad.
+    const fence = FENCE_RE.exec(reply);
+    if (fence) {
+        try {
+            JSON.parse(fence[1]);
+            return { kind: 'error', reason: 'invalid question envelope' };
+        }
+        catch (e) {
+            return { kind: 'error', reason: `malformed JSON in question fence: ${e.message}` };
+        }
+    }
+    return { kind: 'text', text: reply.trim() };
+}
+function validateQuestion(x) {
+    if (!x || typeof x !== 'object')
+        return { ok: false, reason: 'envelope is not an object' };
+    const o = x;
+    if (typeof o.question !== 'string' || o.question.length === 0)
+        return { ok: false, reason: 'missing .question' };
+    if (!Array.isArray(o.options) || o.options.length < 1)
+        return { ok: false, reason: 'missing .options' };
+    for (const opt of o.options) {
+        if (!opt || typeof opt !== 'object')
+            return { ok: false, reason: 'option is not an object' };
+        const oo = opt;
+        if (typeof oo.label !== 'string' || typeof oo.value !== 'string') {
+            return { ok: false, reason: 'option missing label/value' };
+        }
+    }
+    if (typeof o.recommended !== 'string')
+        return { ok: false, reason: 'missing .recommended' };
+    return {
+        ok: true,
+        value: {
+            question: o.question,
+            options: o.options,
+            recommended: o.recommended,
+            freeformAccepted: o.freeformAccepted === true,
+            context: typeof o.context === 'string' ? o.context : undefined,
+        },
+    };
+}
+//# sourceMappingURL=interview-parser.js.map

package/dist/src/ultraapp/interview-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interview-parser.js","sourceRoot":"","sources":["../../../src/ultraapp/interview-parser.ts"],"names":[],"mappings":"AA6BA,MAAM,QAAQ,GAAG,iCAAiC,CAAC;AACnD,MAAM,WAAW,GAAG,iCAAiC,CAAC;AACtD,MAAM,OAAO,GAAG,iDAAiD,CAAC;AAElE,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;IACtB,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,oEAAoE;IACpE,wEAAwE;IACxE,qBAAqB;IACrB,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE;QAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/B,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACpG,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC7D,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC9E,CAAC;IAED,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACxE,CAAC;IAED,6EAA6E;IAC7E,wBAAwB;IACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACrB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,qCAAsC,CAAW,CAAC,OAAO,EAAE,EAAE,CAAC;QAChG,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAU;IAClC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;IAC3F,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACjH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACxG,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;QAC7F,MAAM,EAAE,GAAG,GAA8B,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IAC5F,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK,EAAE;YACL,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,OAAO,EAAE,CAAC,CAAC,OAAkD;YAC7D,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,KAAK,IAAI;YAC7C,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SAC/D;KACF,CAAC;AACJ,CAAC"}

package/dist/src/ultraapp/interview-tools.d.ts

@@ -0,0 +1,16 @@
+import type { UltraappStore } from './store.js';
+import type { ToolCall } from './interview-parser.js';
+import type { FileMetadata } from './files.js';
+export interface ToolResult {
+    name: string;
+    ok: boolean;
+    result?: unknown;
+    error?: string;
+}
+export interface RunToolsArgs {
+    runId: string;
+    store: UltraappStore;
+    extractMetadata: (ref: string) => Promise<FileMetadata>;
+    calls: ToolCall[];
+}
+export declare function runToolCalls(args: RunToolsArgs): Promise<ToolResult[]>;

package/dist/src/ultraapp/interview-tools.js

@@ -0,0 +1,36 @@
+import { applyPatch } from './json-patch.js';
+import { isComplete } from './spec.js';
+export async function runToolCalls(args) {
+    const out = [];
+    for (const call of args.calls) {
+        out.push(await dispatch(call, args));
+    }
+    return out;
+}
+async function dispatch(call, args) {
+    try {
+        if (call.name === 'update_spec') {
+            const patch = JSON.parse(call.argsRaw);
+            const spec = await args.store.readSpec(args.runId);
+            const next = applyPatch(spec, patch);
+            await args.store.writeSpec(args.runId, next);
+            return { name: call.name, ok: true, result: { applied: patch.length } };
+        }
+        if (call.name === 'extract_metadata') {
+            const a = JSON.parse(call.argsRaw);
+            if (typeof a.ref !== 'string')
+                throw new Error('extract_metadata requires .ref');
+            const meta = await args.extractMetadata(a.ref);
+            return { name: call.name, ok: true, result: meta };
+        }
+        if (call.name === 'check_completeness') {
+            const spec = await args.store.readSpec(args.runId);
+            return { name: call.name, ok: true, result: isComplete(spec) };
+        }
+        return { name: call.name, ok: false, error: `unknown tool: ${call.name}` };
+    }
+    catch (e) {
+        return { name: call.name, ok: false, error: e.message };
+    }
+}
+//# sourceMappingURL=interview-tools.js.map

package/dist/src/ultraapp/interview-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interview-tools.js","sourceRoot":"","sources":["../../../src/ultraapp/interview-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAmBvC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAkB;IACnD,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAc,EAAE,IAAkB;IACxD,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAInC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACrC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAmB,CAAC,CAAC;YAC5D,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1E,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAoB,CAAC;YACtD,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC/C,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACjE,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IAC7E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;IACrE,CAAC;AACH,CAAC"}

package/dist/src/ultraapp/json-patch.d.ts

@@ -0,0 +1,6 @@
+export interface PatchOp {
+    op: string;
+    path: string;
+    value?: unknown;
+}
+export declare function applyPatch<T>(doc: T, ops: PatchOp[]): T;

package/dist/src/ultraapp/json-patch.js

@@ -0,0 +1,78 @@
+export function applyPatch(doc, ops) {
+    let next = deepClone(doc);
+    for (const op of ops) {
+        next = applyOne(next, op);
+    }
+    return next;
+}
+function applyOne(doc, op) {
+    const tokens = parsePath(op.path);
+    if (tokens.length === 0) {
+        if (op.op === 'replace' || op.op === 'add')
+            return op.value;
+        throw new Error(`unsupported root op ${op.op}`);
+    }
+    const last = tokens[tokens.length - 1];
+    const parent = walk(doc, tokens.slice(0, -1));
+    if (op.op === 'add' || op.op === 'replace') {
+        setIn(parent, last, op.value);
+        return doc;
+    }
+    if (op.op === 'remove') {
+        removeIn(parent, last);
+        return doc;
+    }
+    throw new Error(`unsupported op ${op.op}`);
+}
+function parsePath(path) {
+    if (path === '')
+        return [];
+    if (!path.startsWith('/'))
+        throw new Error(`bad path ${path}`);
+    return path
+        .slice(1)
+        .split('/')
+        .map((t) => t.replace(/~1/g, '/').replace(/~0/g, '~'));
+}
+function walk(doc, tokens) {
+    let cur = doc;
+    for (const t of tokens) {
+        if (Array.isArray(cur)) {
+            const i = t === '-' ? cur.length : Number(t);
+            cur = cur[i];
+        }
+        else if (cur && typeof cur === 'object') {
+            cur = cur[t];
+        }
+        else {
+            throw new Error(`cannot walk into ${typeof cur} at ${t}`);
+        }
+    }
+    return cur;
+}
+function setIn(parent, key, value) {
+    if (Array.isArray(parent)) {
+        if (key === '-')
+            parent.push(value);
+        else
+            parent.splice(Number(key), 0, value);
+    }
+    else if (parent && typeof parent === 'object') {
+        parent[key] = value;
+    }
+    else {
+        throw new Error(`cannot set into ${typeof parent}`);
+    }
+}
+function removeIn(parent, key) {
+    if (Array.isArray(parent)) {
+        parent.splice(Number(key), 1);
+    }
+    else if (parent && typeof parent === 'object') {
+        delete parent[key];
+    }
+}
+function deepClone(x) {
+    return JSON.parse(JSON.stringify(x));
+}
+//# sourceMappingURL=json-patch.js.map

package/dist/src/ultraapp/json-patch.js.map

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

package/dist/src/ultraapp/lifecycle.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Container lifecycle helpers — start / stop / delete with router (de)registration,
+ * plus cold-eligibility logic for the periodic GC sweeper.
+ *
+ * The actual GC sweeper itself is wired in v0.4+ (it needs lastAccess
+ * accounting from the router, which is not present in v0.3). This module
+ * only exposes the pure predicate findColdContainers.
+ */
+import { dockerStart, dockerStop, dockerRm } from './docker.js';
+import type { UltraappRouter } from './router.js';
+export interface ContainerLastAccess {
+    containerName: string;
+    lastAccess: number;
+    slug?: string;
+    port?: number;
+}
+export declare function findColdContainers(items: ContainerLastAccess[], now: number, days: number): ContainerLastAccess[];
+export interface StartOpts {
+    dockerStartFn?: typeof dockerStart;
+}
+export declare function startContainerAndRegister(containerName: string, slug: string, port: number, router: UltraappRouter, opts?: StartOpts): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export interface StopOpts {
+    dockerStopFn?: typeof dockerStop;
+}
+export declare function stopContainerAndDeregister(containerName: string, slug: string, router: UltraappRouter, opts?: StopOpts): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export interface DeleteOpts {
+    dockerRmFn?: typeof dockerRm;
+}
+export declare function deleteContainerAndDeregister(containerName: string, slug: string, router: UltraappRouter, opts?: DeleteOpts): Promise<{
+    ok: boolean;
+    error?: string;
+}>;

package/dist/src/ultraapp/lifecycle.js

@@ -0,0 +1,31 @@
+/**
+ * Container lifecycle helpers — start / stop / delete with router (de)registration,
+ * plus cold-eligibility logic for the periodic GC sweeper.
+ *
+ * The actual GC sweeper itself is wired in v0.4+ (it needs lastAccess
+ * accounting from the router, which is not present in v0.3). This module
+ * only exposes the pure predicate findColdContainers.
+ */
+import { dockerStart, dockerStop, dockerRm } from './docker.js';
+export function findColdContainers(items, now, days) {
+    const cutoff = now - days * 86400000;
+    return items.filter((i) => i.lastAccess < cutoff);
+}
+export async function startContainerAndRegister(containerName, slug, port, router, opts = {}) {
+    const fn = opts.dockerStartFn ?? dockerStart;
+    const r = await fn(containerName);
+    if (r.ok)
+        router.register(slug, port);
+    return r;
+}
+export async function stopContainerAndDeregister(containerName, slug, router, opts = {}) {
+    const fn = opts.dockerStopFn ?? dockerStop;
+    router.deregister(slug);
+    return fn(containerName);
+}
+export async function deleteContainerAndDeregister(containerName, slug, router, opts = {}) {
+    const fn = opts.dockerRmFn ?? dockerRm;
+    router.deregister(slug);
+    return fn(containerName);
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/src/ultraapp/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/ultraapp/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAUhE,MAAM,UAAU,kBAAkB,CAAC,KAA4B,EAAE,GAAW,EAAE,IAAY;IACxF,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,QAAQ,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC;AACpD,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,aAAqB,EACrB,IAAY,EACZ,IAAY,EACZ,MAAsB,EACtB,OAAkB,EAAE;IAEpB,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,IAAI,WAAW,CAAC;IAC7C,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,EAAE;QAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC;AACX,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,aAAqB,EACrB,IAAY,EACZ,MAAsB,EACtB,OAAiB,EAAE;IAEnB,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,IAAI,UAAU,CAAC;IAC3C,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC,aAAa,CAAC,CAAC;AAC3B,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,aAAqB,EACrB,IAAY,EACZ,MAAsB,EACtB,OAAmB,EAAE;IAErB,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC;IACvC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC,aAAa,CAAC,CAAC;AAC3B,CAAC"}