@agentorg/cli 0.0.4 → 0.0.6

package/dist/node_modules/@agentorg/sdk/dist/src/build.d.ts

@@ -1,2 +0,0 @@
-export { BuildError, type BuildOptions, type Built, buildPackage, verifyPackage, } from "./package.js";
-export { writeTar } from "./tar.js";

package/dist/node_modules/@agentorg/sdk/dist/src/build.js

@@ -1,2 +0,0 @@
-export { BuildError, buildPackage, verifyPackage, } from "./package.js";
-export { writeTar } from "./tar.js";

package/dist/node_modules/@agentorg/sdk/dist/src/client-http.d.ts

@@ -1,24 +0,0 @@
-import type { Duplex, Log } from "./module.js";
-/**
- * The header that carries an SDK error a provider's handler threw, as its error body in JSON, on a
- * 502: the consumer's `fetch` throws that error instead of returning the response.
- */
-export declare const ERROR_HEADER = "agentorg-error";
-/**
- * Send one request over the stream and read its response. The request line carries the request's
- * absolute URL, so the provider sees exactly what was asked for. Aborting the request's signal
- * resets the stream; once the response's body has ended, so is the stream, since nothing more is
- * read. A provider whose handler threw one of the SDK's errors makes this throw it (`target`
- * names the slot in a NotConnected).
- */
-export declare function fetchOver(stream: Duplex, request: Request, target?: string): Promise<Response>;
-/**
- * Serve requests arriving on the stream with `handle`, until the stream ends. The handler's
- * `request.url` is the consumer's absolute URL, from the request line; a request line that isn't
- * absolute, or whose host isn't the `Host` header's, is answered 400. A handler that throws one
- * of the SDK's errors before answering reaches the consumer's `fetch` as that error (a 502 with
- * the error header); any other throw answers 500 with its message. A body that fails once sent
- * ends the response abruptly, so the consumer's read fails rather than looking complete. The
- * handler's request is aborted if the consumer goes before the response is done.
- */
-export declare function serveOver(stream: Duplex, handle: (request: Request) => Promise<Response>, log: Log): Promise<void>;

package/dist/node_modules/@agentorg/sdk/dist/src/client-http.js

@@ -1,247 +0,0 @@
-import { createServer, request as httpRequest } from "node:http";
-import { Duplex as NodeDuplex, Readable } from "node:stream";
-import { pipeline } from "node:stream/promises";
-import { errorBodyOf, errorFromBody, NotConnected, OutcomeUnknown, Refused, } from "./errors.js";
-/**
- * The header that carries an SDK error a provider's handler threw, as its error body in JSON, on a
- * 502: the consumer's `fetch` throws that error instead of returning the response.
- */
-export const ERROR_HEADER = "agentorg-error";
-const ERROR_NAMES = new Set(["Refused", "NotConnected", "OutcomeUnknown"]);
-/** The error a response carries, if it is a 502 whose error header is one of the SDK's three. */
-function carriedError(status, header) {
-    if (status !== 502 || typeof header !== "string")
-        return undefined;
-    try {
-        const body = JSON.parse(header);
-        if (typeof body !== "object" || body === null || !ERROR_NAMES.has(String(body.name)))
-            return undefined;
-        return {
-            name: body.name,
-            message: String(body.message ?? ""),
-            ...(typeof body.code === "string" ? { code: body.code } : {}),
-        };
-    }
-    catch {
-        return undefined;
-    }
-}
-/** JSON with everything past ASCII escaped, so it fits in a header. */
-const asciiJson = (value) => JSON.stringify(value).replace(/[\u007f-\uffff]/g, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, "0")}`);
-/**
- * HTTP/1.1 over one of the Hub's byte streams, with `node:http` on both ends, one request per
- * stream. `node:http` wants a socket; a stream adapted from the web pair, with the few socket
- * methods it calls, serves. Destroying it resets the Hub's stream.
- */
-function socketOf(stream) {
-    // Built by hand rather than with Duplex.fromWeb, whose destroy throws on Node 22.
-    const reader = stream.readable.getReader();
-    const writer = stream.writable.getWriter();
-    const socket = new NodeDuplex({
-        read() {
-            reader.read().then(({ value, done }) => {
-                this.push(done ? null : value);
-            }, (error) => this.destroy(error));
-        },
-        write(chunk, _encoding, callback) {
-            writer.write(chunk).then(() => callback(), callback);
-        },
-        final(callback) {
-            writer.close().then(() => callback(), callback);
-        },
-        destroy(error, callback) {
-            // Either half going resets the Hub's stream.
-            reader.cancel(error ?? undefined).catch(() => { });
-            writer.abort(error ?? undefined).catch(() => { });
-            callback(error);
-        },
-    });
-    return Object.assign(socket, {
-        setTimeout: () => socket,
-        setNoDelay: () => socket,
-        setKeepAlive: () => socket,
-        // node:http ends a finished connection this way: our side closes once its writes are out,
-        // and the other side, done reading, resets the stream.
-        destroySoon: () => socket.end(),
-        remoteAddress: "hub",
-    });
-}
-/** Headers that describe one hop, not the message: node:http sets its own on each side. */
-const HOP = new Set([
-    "connection",
-    "keep-alive",
-    "transfer-encoding",
-    "te",
-    "trailer",
-    "upgrade",
-    "proxy-authenticate",
-    "proxy-authorization",
-    "proxy-connection",
-]);
-function headersOf(raw) {
-    const headers = new Headers();
-    for (const [name, value] of Object.entries(raw)) {
-        if (HOP.has(name))
-            continue;
-        if (Array.isArray(value))
-            for (const one of value)
-                headers.append(name, one);
-        else if (value !== undefined)
-            headers.set(name, value);
-    }
-    return headers;
-}
-/** Headers to send: hop-by-hop ones dropped, each `set-cookie` kept apart. */
-function outgoingHeaders(headers) {
-    const out = {};
-    headers.forEach((value, name) => {
-        if (!HOP.has(name) && name !== "set-cookie")
-            out[name] = value;
-    });
-    const cookies = headers.getSetCookie();
-    if (cookies.length)
-        out["set-cookie"] = cookies;
-    return out;
-}
-const noBody = (method) => method === "GET" || method === "HEAD";
-/**
- * Send one request over the stream and read its response. The request line carries the request's
- * absolute URL, so the provider sees exactly what was asked for. Aborting the request's signal
- * resets the stream; once the response's body has ended, so is the stream, since nothing more is
- * read. A provider whose handler threw one of the SDK's errors makes this throw it (`target`
- * names the slot in a NotConnected).
- */
-export function fetchOver(stream, request, target = "the http slot") {
-    const socket = socketOf(stream);
-    const url = new URL(request.url);
-    const headers = outgoingHeaders(request.headers);
-    headers.host = url.host;
-    headers.connection = "close";
-    return new Promise((resolve, reject) => {
-        const outgoing = httpRequest({
-            // No agent: with createConnection, node:http uses this stream and pools nothing.
-            createConnection: () => socket,
-            method: request.method,
-            path: url.href,
-            headers,
-        }, (incoming) => {
-            const status = incoming.statusCode ?? 502;
-            const carried = carriedError(status, incoming.headers[ERROR_HEADER]);
-            if (carried) {
-                incoming.resume();
-                socket.destroy();
-                return reject(errorFromBody(carried, target));
-            }
-            const empty = request.method === "HEAD" || status === 204 || status === 205 || status === 304;
-            // The response is whole: an upload the provider never read stops here.
-            incoming.once("end", () => socket.destroy());
-            // Whatever the provider answers, it ends as a response or an error, never a throw here.
-            try {
-                if (status < 200 || status > 599)
-                    throw new Error(`a status of ${status}`);
-                const response = new Response(empty ? null : Readable.toWeb(incoming), {
-                    status,
-                    statusText: incoming.statusMessage ?? "",
-                    headers: headersOf(incoming.headers),
-                });
-                if (empty)
-                    incoming.resume();
-                resolve(response);
-            }
-            catch (error) {
-                socket.destroy();
-                reject(new OutcomeUnknown(`The provider answered what isn't a response: ${error.message}`));
-            }
-        });
-        const abort = () => {
-            const reason = request.signal.reason ?? new Error("The request was aborted.");
-            outgoing.destroy(reason);
-            socket.destroy();
-            reject(reason);
-        };
-        // Listened for first: node:http settles a request destroyed at once a tick later, with an
-        // error of its own ("socket hang up"), which would otherwise be thrown at the process.
-        outgoing.on("error", reject);
-        if (request.signal.aborted)
-            return abort();
-        request.signal.addEventListener("abort", abort, { once: true });
-        outgoing.once("close", () => request.signal.removeEventListener("abort", abort));
-        if (!request.body || noBody(request.method))
-            return void outgoing.end();
-        pipeline(Readable.fromWeb(request.body), outgoing).catch(() => { });
-    });
-}
-/**
- * Serve requests arriving on the stream with `handle`, until the stream ends. The handler's
- * `request.url` is the consumer's absolute URL, from the request line; a request line that isn't
- * absolute, or whose host isn't the `Host` header's, is answered 400. A handler that throws one
- * of the SDK's errors before answering reaches the consumer's `fetch` as that error (a 502 with
- * the error header); any other throw answers 500 with its message. A body that fails once sent
- * ends the response abruptly, so the consumer's read fails rather than looking complete. The
- * handler's request is aborted if the consumer goes before the response is done.
- */
-export function serveOver(stream, handle, log) {
-    const server = createServer(async (incoming, outgoing) => {
-        const method = incoming.method ?? "GET";
-        const left = new AbortController();
-        outgoing.once("close", () => {
-            if (!outgoing.writableFinished)
-                left.abort(new Error("The consumer went away."));
-        });
-        let target;
-        try {
-            target = new URL(incoming.url ?? "");
-        }
-        catch {
-            target = undefined;
-        }
-        if (!target ||
-            (target.protocol !== "http:" && target.protocol !== "https:") ||
-            target.host !== incoming.headers.host) {
-            outgoing.writeHead(400, { "content-type": "text/plain" });
-            return void outgoing.end("A request names its absolute URL, whose host is the Host header's.");
-        }
-        try {
-            const request = new Request(target.href, {
-                method,
-                headers: headersOf(incoming.headers),
-                signal: left.signal,
-                ...(noBody(method)
-                    ? {}
-                    : { body: Readable.toWeb(incoming), duplex: "half" }),
-            });
-            const response = await handle(request);
-            outgoing.writeHead(response.status, response.statusText, outgoingHeaders(response.headers));
-            if (!response.body || method === "HEAD")
-                return void outgoing.end();
-            // Paced by the consumer: the next chunk is read once the last one is taken.
-            await pipeline(Readable.fromWeb(response.body), outgoing);
-        }
-        catch (error) {
-            if (outgoing.headersSent) {
-                log.error("An http handler failed.", { error: String(error) });
-                return void outgoing.destroy(error);
-            }
-            if (error instanceof Refused ||
-                error instanceof NotConnected ||
-                error instanceof OutcomeUnknown) {
-                const body = errorBodyOf(error);
-                body.message = body.message.slice(0, 1024);
-                outgoing.writeHead(502, {
-                    "content-type": "text/plain",
-                    [ERROR_HEADER]: asciiJson(body),
-                });
-                return void outgoing.end(body.message);
-            }
-            log.error("An http handler failed.", { error: String(error) });
-            outgoing.writeHead(500, { "content-type": "text/plain" });
-            outgoing.end(error instanceof Error ? error.message : String(error));
-        }
-    });
-    const socket = socketOf(stream);
-    return new Promise((resolve) => {
-        socket.once("close", () => resolve());
-        socket.once("error", () => resolve());
-        server.emit("connection", socket);
-    });
-}

package/dist/node_modules/@agentorg/sdk/dist/src/describe.d.ts

@@ -1,13 +0,0 @@
-import { type DescribedInterface } from "./interface.js";
-import { type Placement } from "./module.js";
-/** A module as the build reads it from its code. */
-export interface ModuleDescription {
-    placement: Placement;
-    slots: Record<string, DescribedInterface>;
-    exports: Record<string, DescribedInterface>;
-}
-/**
- * Describe a module's default export. The build bundles this with the author's own module, so it
- * uses the same SDK and zod copies as the module, and runs it in a permission-limited process.
- */
-export declare function describeModule(definition: unknown): ModuleDescription;

package/dist/node_modules/@agentorg/sdk/dist/src/describe.js

@@ -1,16 +0,0 @@
-import { describeInterface } from "./interface.js";
-import { isModuleDefinition } from "./module.js";
-/**
- * Describe a module's default export. The build bundles this with the author's own module, so it
- * uses the same SDK and zod copies as the module, and runs it in a permission-limited process.
- */
-export function describeModule(definition) {
-    if (!isModuleDefinition(definition))
-        throw new TypeError("The default export isn't a module: define it with defineActor or defineWidget.");
-    const describe = (interfaces) => Object.fromEntries(Object.entries(interfaces).map(([name, iface]) => [name, describeInterface(iface)]));
-    return {
-        placement: definition.placement,
-        slots: describe(definition.slots),
-        exports: describe(definition.exports),
-    };
-}

package/dist/node_modules/@agentorg/sdk/dist/src/frame-base.d.ts

@@ -1,8 +0,0 @@
-/**
- * The base stylesheet every view's frame gets first, before the view's own: the document fills the
- * frame on a transparent background, and plain HTML looks like the shell, drawn with the theme's
- * tokens (`--fg`, `--surface`, `--accent`, … as the shell sends them at mount). Every rule is in
- * `:where()`, so it has no specificity: any selector a view writes wins, and a view that wants its
- * own look draws it.
- */
-export declare const FRAME_BASE = "\n:where(*, *::before, *::after) { box-sizing: border-box; }\n:where(html, body) { height: 100%; margin: 0; background: transparent; }\n:where(body) {\n  overflow: auto; scrollbar-width: none;\n  color: var(--fg); font: 14px/1.45 var(--font, ui-sans-serif, system-ui, sans-serif);\n  -webkit-font-smoothing: antialiased;\n}\n:where(body)::-webkit-scrollbar { display: none; }\n:where(body > :only-child) { min-height: 100%; }\n:where(h1, h2, h3, h4) { margin: 0 0 8px; font-weight: 600; letter-spacing: -0.01em; }\n:where(h1) { font-size: 20px; }\n:where(h2) { font-size: 16px; }\n:where(h3, h4) { font-size: 14px; }\n:where(p) { margin: 0 0 8px; }\n:where(small) { color: var(--muted); font-size: 12.5px; }\n:where(a) { color: inherit; text-underline-offset: 2px; }\n:where(hr) { border: 0; border-top: 1px solid var(--line); margin: 10px 0; }\n:where(ul, ol) { margin: 0 0 10px; padding: 0; list-style: none; display: flex; flex-direction: column; gap: 6px; }\n:where(li) { display: flex; align-items: center; gap: 10px; padding: 8px 10px; border-radius: 10px; background: var(--raised); }\n:where(button) {\n  height: 34px; padding: 0 12px; border: 0; border-radius: 9px; cursor: pointer;\n  background: var(--hover); color: var(--fg); font: inherit; font-weight: 500;\n}\n:where(button:hover) { background: var(--selected); }\n:where(button:disabled) { opacity: 0.5; cursor: default; }\n:where(button[type=\"submit\"], button.primary) { background: var(--accent); color: var(--accent-fg); font-weight: 600; }\n:where(input:not([type]), input[type=\"text\"], input[type=\"search\"], input[type=\"number\"], input[type=\"url\"], input[type=\"email\"], select) {\n  height: 34px; padding: 0 10px; border: 0; border-radius: 9px; outline: 0;\n  background: var(--raised); color: var(--fg); font: inherit;\n}\n:where(textarea) { padding: 8px 10px; border: 0; border-radius: 9px; outline: 0; resize: none; background: var(--raised); color: var(--fg); font: inherit; }\n:where(input:focus-visible, textarea:focus-visible, select:focus-visible, button:focus-visible) { box-shadow: 0 0 0 1.5px var(--ring); outline: 0; }\n:where(input[type=\"checkbox\"]) {\n  appearance: none; width: 16px; height: 16px; margin: 0; flex: none; display: grid; place-items: center;\n  border: 1.5px solid var(--faint); border-radius: 5px; cursor: pointer;\n}\n:where(input[type=\"checkbox\"]:checked) { background: var(--ok); border-color: var(--ok); }\n:where(input[type=\"checkbox\"]:checked)::after {\n  content: \"\"; width: 4px; height: 8px; border: solid white; border-width: 0 2px 2px 0;\n  transform: translateY(-1px) rotate(45deg);\n}\n:where(li:has(> input[type=\"checkbox\"]:checked) > span) { color: var(--faint); text-decoration: line-through; }\n:where(form) { display: flex; gap: 6px; }\n:where(form > input, form > textarea) { flex: 1; min-width: 0; }\n:where(table) { width: 100%; border-collapse: collapse; font-size: 13px; }\n:where(th) { padding: 0 8px 6px; text-align: left; color: var(--faint); font-weight: 500; font-size: 12px; }\n:where(td) { padding: 7px 8px; border-top: 1px solid var(--line); }\n:where(code, pre) { font: 12.5px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace; }\n:where(code) { padding: 1px 5px; border-radius: 5px; background: var(--raised); }\n:where(pre) { margin: 0 0 10px; padding: 10px 12px; border-radius: 10px; background: var(--raised); overflow: auto; }\n:where(pre code) { padding: 0; background: none; }\n:where(progress) { appearance: none; width: 100%; height: 4px; border: 0; border-radius: 2px; background: var(--raised); }\n:where(progress)::-webkit-progress-bar { background: var(--raised); border-radius: 2px; }\n:where(progress)::-webkit-progress-value { background: var(--ok); border-radius: 2px; }\n:where(progress)::-moz-progress-bar { background: var(--ok); border-radius: 2px; }\n";

package/dist/node_modules/@agentorg/sdk/dist/src/frame-base.js

@@ -1,64 +0,0 @@
-/**
- * The base stylesheet every view's frame gets first, before the view's own: the document fills the
- * frame on a transparent background, and plain HTML looks like the shell, drawn with the theme's
- * tokens (`--fg`, `--surface`, `--accent`, … as the shell sends them at mount). Every rule is in
- * `:where()`, so it has no specificity: any selector a view writes wins, and a view that wants its
- * own look draws it.
- */
-export const FRAME_BASE = `
-:where(*, *::before, *::after) { box-sizing: border-box; }
-:where(html, body) { height: 100%; margin: 0; background: transparent; }
-:where(body) {
-  overflow: auto; scrollbar-width: none;
-  color: var(--fg); font: 14px/1.45 var(--font, ui-sans-serif, system-ui, sans-serif);
-  -webkit-font-smoothing: antialiased;
-}
-:where(body)::-webkit-scrollbar { display: none; }
-:where(body > :only-child) { min-height: 100%; }
-:where(h1, h2, h3, h4) { margin: 0 0 8px; font-weight: 600; letter-spacing: -0.01em; }
-:where(h1) { font-size: 20px; }
-:where(h2) { font-size: 16px; }
-:where(h3, h4) { font-size: 14px; }
-:where(p) { margin: 0 0 8px; }
-:where(small) { color: var(--muted); font-size: 12.5px; }
-:where(a) { color: inherit; text-underline-offset: 2px; }
-:where(hr) { border: 0; border-top: 1px solid var(--line); margin: 10px 0; }
-:where(ul, ol) { margin: 0 0 10px; padding: 0; list-style: none; display: flex; flex-direction: column; gap: 6px; }
-:where(li) { display: flex; align-items: center; gap: 10px; padding: 8px 10px; border-radius: 10px; background: var(--raised); }
-:where(button) {
-  height: 34px; padding: 0 12px; border: 0; border-radius: 9px; cursor: pointer;
-  background: var(--hover); color: var(--fg); font: inherit; font-weight: 500;
-}
-:where(button:hover) { background: var(--selected); }
-:where(button:disabled) { opacity: 0.5; cursor: default; }
-:where(button[type="submit"], button.primary) { background: var(--accent); color: var(--accent-fg); font-weight: 600; }
-:where(input:not([type]), input[type="text"], input[type="search"], input[type="number"], input[type="url"], input[type="email"], select) {
-  height: 34px; padding: 0 10px; border: 0; border-radius: 9px; outline: 0;
-  background: var(--raised); color: var(--fg); font: inherit;
-}
-:where(textarea) { padding: 8px 10px; border: 0; border-radius: 9px; outline: 0; resize: none; background: var(--raised); color: var(--fg); font: inherit; }
-:where(input:focus-visible, textarea:focus-visible, select:focus-visible, button:focus-visible) { box-shadow: 0 0 0 1.5px var(--ring); outline: 0; }
-:where(input[type="checkbox"]) {
-  appearance: none; width: 16px; height: 16px; margin: 0; flex: none; display: grid; place-items: center;
-  border: 1.5px solid var(--faint); border-radius: 5px; cursor: pointer;
-}
-:where(input[type="checkbox"]:checked) { background: var(--ok); border-color: var(--ok); }
-:where(input[type="checkbox"]:checked)::after {
-  content: ""; width: 4px; height: 8px; border: solid white; border-width: 0 2px 2px 0;
-  transform: translateY(-1px) rotate(45deg);
-}
-:where(li:has(> input[type="checkbox"]:checked) > span) { color: var(--faint); text-decoration: line-through; }
-:where(form) { display: flex; gap: 6px; }
-:where(form > input, form > textarea) { flex: 1; min-width: 0; }
-:where(table) { width: 100%; border-collapse: collapse; font-size: 13px; }
-:where(th) { padding: 0 8px 6px; text-align: left; color: var(--faint); font-weight: 500; font-size: 12px; }
-:where(td) { padding: 7px 8px; border-top: 1px solid var(--line); }
-:where(code, pre) { font: 12.5px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace; }
-:where(code) { padding: 1px 5px; border-radius: 5px; background: var(--raised); }
-:where(pre) { margin: 0 0 10px; padding: 10px 12px; border-radius: 10px; background: var(--raised); overflow: auto; }
-:where(pre code) { padding: 0; background: none; }
-:where(progress) { appearance: none; width: 100%; height: 4px; border: 0; border-radius: 2px; background: var(--raised); }
-:where(progress)::-webkit-progress-bar { background: var(--raised); border-radius: 2px; }
-:where(progress)::-webkit-progress-value { background: var(--ok); border-radius: 2px; }
-:where(progress)::-moz-progress-bar { background: var(--ok); border-radius: 2px; }
-`;

package/dist/node_modules/@agentorg/sdk/dist/src/frame-entry.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/node_modules/@agentorg/sdk/dist/src/frame-entry.js

@@ -1,35 +0,0 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-import { runFrame } from "./frame.js";
-import { FRAME_BASE } from "./frame-base.js";
-import { FRAME_HELLO } from "./frame-protocol.js";
-const self = globalThis;
-let frame;
-const base = self.document.createElement("style");
-base.textContent = FRAME_BASE;
-self.document.head.prepend(base);
-self.addEventListener("message", (event) => {
-    const port = event.ports[0];
-    if (frame || event.source !== self.parent || event.data !== FRAME_HELLO || !port)
-        return;
-    frame = runFrame({
-        port,
-        root: self.document.body,
-        // A computed specifier: the bundler leaves it to the browser.
-        load: (src) => import(__rewriteRelativeImportExtension(src)),
-        theme(tokens) {
-            for (const [name, value] of Object.entries(tokens))
-                if (name.startsWith("--"))
-                    self.document.documentElement.style.setProperty(name, value);
-        },
-    });
-});
-// What the view doesn't catch goes to its Actor's log.
-self.addEventListener("error", (event) => frame?.failed(event.error ?? event.message));
-self.addEventListener("unhandledrejection", (event) => frame?.failed(event.reason));

package/dist/node_modules/@agentorg/sdk/dist/src/frame-host.d.ts

@@ -1,57 +0,0 @@
-import { type PortLike } from "./frame-protocol.js";
-/** Where a frame's requests go: its slots, run as the view's Actor, and the shell itself. */
-export interface FrameHandlers {
-    /** A call on one of the view's slots. */
-    call(slot: string, method: string, input: unknown): Promise<unknown>;
-    /**
-     * Events of one of the view's slots until `end` or the returned stop; `end` is for the shell's
-     * side ending it (an unbind, or the provider gone).
-     */
-    subscribe(slot: string, event: string, send: (payload: unknown) => void, end: () => void): () => void;
-    /** `ui.shell@1`, which the shell serves to every view with no binding. */
-    shell: {
-        /** Open the URL, which the host has checked is https, in a new tab with no opener (`noopener`). */
-        openExternal(url: string): void | Promise<void>;
-        /** Start the shell's own sign-in, as its first run does. */
-        signIn(): void | Promise<void>;
-    };
-    /** A line for the view's Actor's log. */
-    log(level: "info" | "warn" | "error", message: string, fields?: Record<string, unknown>): void;
-}
-type Size = {
-    width: number;
-    height: number;
-};
-/**
- * Hand a frame its port: post the hello with the other end to the frame's window, which has an
- * opaque origin, so the target origin is `*`; the frame accepts it only from its parent.
- */
-export declare function openFrame(frameWindow: {
-    postMessage(message: unknown, targetOrigin: string, transfer: unknown[]): void;
-}): PortLike;
-/**
- * The shell's end of a view's frame. It drives `ui.view@1` (load, mount, resize, unmount), tells
- * the frame which slots are bound, and serves what the frame asks: calls and subscriptions on the
- * view's slots through `handlers`, and `ui.shell@1` itself. The frame isn't trusted: every message
- * is checked, and one that doesn't fit is dropped or refused.
- */
-export declare class FrameHost {
-    #private;
-    /** The latest height not yet passed on, and the wait before the next may be. */
-    constructor(port: PortLike, handlers: FrameHandlers);
-    /** Import the view's bundle in the frame and run its `start`; `slots` says which are bound. */
-    load(options: {
-        src: string;
-        actorId: string;
-        module: string;
-        slots: Record<string, boolean>;
-    }): Promise<void>;
-    /** A slot became bound or unbound; `bound` again for a bound slot means its provider came back. */
-    slot(name: string, bound: boolean): void;
-    mount(theme: Record<string, string>, size: Size): Promise<void>;
-    resize(size: Size): Promise<void>;
-    unmount(): Promise<void>;
-    /** Stop: every subscription ends, and what waits on the frame fails. */
-    close(): void;
-}
-export {};