@agentorg/cli 0.0.4 → 0.0.6

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

@@ -1,293 +0,0 @@
-import { errorBodyOf, errorFromBody, OutcomeUnknown, Refused } from "./errors.js";
-import { FRAME_HELLO } from "./frame-protocol.js";
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const isId = (value) => Number.isSafeInteger(value) && value > 0;
-const isName = (value) => typeof value === "string" && value.length <= 256;
-const LEVELS = new Set(["info", "warn", "error"]);
-/** A log line's text from a frame is cut to this. */
-const MAX_LOG = 4096;
-/** A log line's fields from a frame: this many keys at most, each value cut to this length. */
-const MAX_FIELDS = 16;
-const MAX_FIELD = 1024;
-/** Log lines a frame may send per window; the rest of the window is dropped, and that's said once. */
-const LOG_LINES = 50;
-const LOG_WINDOW_MS = 10_000;
-/** Live subscriptions one frame may hold. */
-const MAX_SUBSCRIPTIONS = 64;
-/** Calls on its slots one frame may have in flight; past it, `busy`. */
-const MAX_CALLS = 64;
-/**
- * A frame's log fields, rebuilt: a fresh object of at most `MAX_FIELDS` plain keys (no prototype
- * keys), each value a primitive or JSON text, cut to `MAX_FIELD`.
- */
-function fieldsOf(value) {
-    if (!isRecord(value))
-        return undefined;
-    const fields = {};
-    let kept = 0;
-    for (const key of Object.keys(value)) {
-        if (kept >= MAX_FIELDS)
-            break;
-        if (key === "__proto__" || key === "constructor" || key === "prototype" || key.length > 64)
-            continue;
-        const field = value[key];
-        let text;
-        if (field === null || typeof field === "number" || typeof field === "boolean")
-            text = field;
-        else if (typeof field === "string")
-            text = field.slice(0, MAX_FIELD);
-        else
-            try {
-                text = String(JSON.stringify(field)).slice(0, MAX_FIELD);
-            }
-            catch {
-                text = "[unreadable]";
-            }
-        Object.defineProperty(fields, key, {
-            value: text,
-            enumerable: true,
-            writable: true,
-            configurable: true,
-        });
-        kept++;
-    }
-    return fields;
-}
-/** A frame's error body, read as no more than it claims: one of the three names, as text. */
-function portErrorOf(error) {
-    const name = error.name === "NotConnected" || error.name === "OutcomeUnknown" ? error.name : "Refused";
-    return {
-        name,
-        message: String(error.message ?? "").slice(0, MAX_LOG),
-        ...(typeof error.code === "string" ? { code: error.code.slice(0, 64) } : {}),
-    };
-}
-/** `ui.shell@1.openExternal`'s URL, if it is one the shell opens: https only. */
-function externalUrl(input) {
-    const url = isRecord(input) ? input.url : undefined;
-    if (typeof url !== "string" || url.length > 8192)
-        throw new Refused("invalid", "openExternal takes {url}.");
-    let parsed;
-    try {
-        parsed = new URL(url);
-    }
-    catch {
-        throw new Refused("invalid", "openExternal: the URL doesn't parse.");
-    }
-    if (parsed.protocol !== "https:")
-        throw new Refused("invalid", "openExternal opens https URLs only.");
-    return parsed.href;
-}
-/**
- * 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 function openFrame(frameWindow) {
-    const channel = new MessageChannel();
-    frameWindow.postMessage(FRAME_HELLO, "*", [channel.port2]);
-    return channel.port1;
-}
-/**
- * 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 class FrameHost {
-    #port;
-    #handlers;
-    #nextId = 0;
-    #pending = new Map();
-    /** Live subscriptions by id, and the id of each slot and event's one subscription. */
-    #subscriptions = new Map();
-    #byEvent = new Map();
-    /** ui.shell@1 methods with a call in flight: one at a time each. */
-    #shellBusy = new Set();
-    #logWindow = { start: 0, lines: 0 };
-    #calls = 0;
-    #closed = false;
-    /** The latest height not yet passed on, and the wait before the next may be. */
-    constructor(port, handlers) {
-        this.#port = port;
-        this.#handlers = handlers;
-        port.onmessage = (event) => this.#receive(event.data);
-    }
-    /** Import the view's bundle in the frame and run its `start`; `slots` says which are bound. */
-    load(options) {
-        return this.#request((id) => ({
-            op: "load",
-            id,
-            src: options.src,
-            self: { actorId: options.actorId, module: options.module },
-            slots: options.slots,
-        }));
-    }
-    /** A slot became bound or unbound; `bound` again for a bound slot means its provider came back. */
-    slot(name, bound) {
-        this.#post({ op: "slot", name, bound });
-    }
-    mount(theme, size) {
-        return this.#request((id) => ({ op: "mount", id, theme, size }));
-    }
-    resize(size) {
-        return this.#request((id) => ({ op: "resize", id, size }));
-    }
-    unmount() {
-        return this.#request((id) => ({ op: "unmount", id }));
-    }
-    /** Stop: every subscription ends, and what waits on the frame fails. */
-    close() {
-        if (this.#closed)
-            return;
-        this.#closed = true;
-        this.#port.onmessage = null;
-        for (const { stop } of this.#subscriptions.values())
-            stop();
-        this.#subscriptions.clear();
-        this.#byEvent.clear();
-        for (const waiting of this.#pending.values())
-            waiting.reject(new OutcomeUnknown("The frame closed."));
-        this.#pending.clear();
-        this.#port.close();
-    }
-    #post(message) {
-        if (!this.#closed)
-            this.#port.postMessage(message);
-    }
-    #request(make) {
-        if (this.#closed)
-            return Promise.reject(new OutcomeUnknown("The frame closed."));
-        const id = ++this.#nextId;
-        return new Promise((resolve, reject) => {
-            this.#pending.set(id, { resolve, reject });
-            this.#post(make(id));
-        }).then(() => undefined);
-    }
-    async #answer(id, run) {
-        try {
-            this.#post({ op: "reply", id, result: (await run()) ?? {} });
-        }
-        catch (error) {
-            this.#post({ op: "reply", id, error: errorBodyOf(error) });
-        }
-    }
-    #receive(data) {
-        if (!isRecord(data))
-            return;
-        const message = data;
-        switch (message.op) {
-            case "call":
-                if (!isId(message.id))
-                    return;
-                if (!isName(message.slot) || !isName(message.method))
-                    return void this.#answer(message.id, () => {
-                        throw new Refused("invalid", "A call names its slot and method.");
-                    });
-                return void this.#answer(message.id, async () => {
-                    // One view can't flood the gateway and the Hub: past the cap, it waits its turn.
-                    if (this.#calls >= MAX_CALLS)
-                        throw new Refused("busy", `A view has ${MAX_CALLS} calls in flight at most.`);
-                    this.#calls++;
-                    try {
-                        return await this.#handlers.call(message.slot, message.method, message.input);
-                    }
-                    finally {
-                        this.#calls--;
-                    }
-                });
-            case "shell": {
-                if (!isId(message.id))
-                    return;
-                const { method, input } = message;
-                return void this.#answer(message.id, async () => {
-                    if (method !== "openExternal" && method !== "signIn")
-                        throw new Refused("invalid", "ui.shell@1 has openExternal and signIn.");
-                    const url = method === "openExternal" ? externalUrl(input) : undefined;
-                    if (this.#shellBusy.has(method))
-                        throw new Refused("busy", `ui.shell@1.${method} is already running.`);
-                    this.#shellBusy.add(method);
-                    try {
-                        if (url !== undefined)
-                            await this.#handlers.shell.openExternal(url);
-                        else
-                            await this.#handlers.shell.signIn();
-                    }
-                    finally {
-                        this.#shellBusy.delete(method);
-                    }
-                    return {};
-                });
-            }
-            case "subscribe": {
-                const { sub, slot, event } = message;
-                if (!isId(sub) || !isName(slot) || !isName(event) || this.#subscriptions.has(sub))
-                    return;
-                const key = `${slot}\0${event}`;
-                let ended = false;
-                const end = () => {
-                    if (ended)
-                        return;
-                    ended = true;
-                    if (this.#subscriptions.get(sub)?.key === key) {
-                        this.#subscriptions.delete(sub);
-                        this.#byEvent.delete(key);
-                    }
-                    this.#post({ op: "end", sub });
-                };
-                // One subscription per slot and event, as the frame keeps; past the cap, none.
-                if (this.#byEvent.has(key) || this.#subscriptions.size >= MAX_SUBSCRIPTIONS)
-                    return end();
-                try {
-                    const stop = this.#handlers.subscribe(slot, event, (payload) => {
-                        if (!ended)
-                            this.#post({ op: "event", sub, payload });
-                    }, end);
-                    if (ended)
-                        stop();
-                    else {
-                        this.#subscriptions.set(sub, { key, stop });
-                        this.#byEvent.set(key, sub);
-                    }
-                }
-                catch {
-                    end();
-                }
-                return;
-            }
-            case "unsubscribe": {
-                const live = isId(message.sub) ? this.#subscriptions.get(message.sub) : undefined;
-                if (!live)
-                    return;
-                this.#subscriptions.delete(message.sub);
-                this.#byEvent.delete(live.key);
-                live.stop();
-                return;
-            }
-            case "log": {
-                if (!LEVELS.has(message.level) || typeof message.message !== "string")
-                    return;
-                const now = Date.now();
-                if (now - this.#logWindow.start > LOG_WINDOW_MS)
-                    this.#logWindow = { start: now, lines: 0 };
-                const lines = ++this.#logWindow.lines;
-                if (lines > LOG_LINES + 1)
-                    return;
-                if (lines === LOG_LINES + 1)
-                    return this.#handlers.log("warn", "The view logged too much; its lines are dropped for a while.");
-                this.#handlers.log(message.level, message.message.slice(0, MAX_LOG), fieldsOf(message.fields));
-                return;
-            }
-            case "reply": {
-                const waiting = isId(message.id) ? this.#pending.get(message.id) : undefined;
-                if (!waiting)
-                    return;
-                this.#pending.delete(message.id);
-                if (isRecord(message.error))
-                    waiting.reject(errorFromBody(portErrorOf(message.error), "view"));
-                else
-                    waiting.resolve(message.result);
-                return;
-            }
-        }
-    }
-}

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

@@ -1,124 +0,0 @@
-import type { ErrorBody } from "./errors.js";
-import type { Interface } from "./interface.js";
-/**
- * The messages between a shell and a view's sandboxed frame, over the one `MessagePort` the shell
- * hands the frame. The frame has no network and no shell state: everything it reaches goes
- * through these. The shell is trusted by the frame; the frame is not trusted by the shell, so
- * `FrameHost` checks every message it gets.
- */
-/** What the shell posts to the frame's window, with the port, to start. */
-export declare const FRAME_HELLO = "frame/1";
-/** From the shell to the frame. */
-export type ToFrame = 
-/** Import the view's bundle, run its `start`, then answer. `slots` says which are bound now. */
-{
-    op: "load";
-    id: number;
-    src: string;
-    self: {
-        actorId: string;
-        module: string;
-    };
-    slots: Record<string, boolean>;
-}
-/** A slot became bound or unbound; `bound` again for a bound slot means its provider came back. */
- | {
-    op: "slot";
-    name: string;
-    bound: boolean;
-} | {
-    op: "mount";
-    id: number;
-    theme: Record<string, string>;
-    size: {
-        width: number;
-        height: number;
-    };
-} | {
-    op: "resize";
-    id: number;
-    size: {
-        width: number;
-        height: number;
-    };
-} | {
-    op: "unmount";
-    id: number;
-}
-/** An event of a subscription the frame opened. */
- | {
-    op: "event";
-    sub: number;
-    payload: unknown;
-}
-/** A subscription ended from the shell's side: an unbind, or its provider gone. */
- | {
-    op: "end";
-    sub: number;
-}
-/** The answer to one of the frame's requests. */
- | {
-    op: "reply";
-    id: number;
-    result: unknown;
-} | {
-    op: "reply";
-    id: number;
-    error: ErrorBody;
-};
-/** From the frame to the shell. */
-export type FromFrame = 
-/** A call on one of the view's slots, run as the view's Actor. */
-{
-    op: "call";
-    id: number;
-    slot: string;
-    method: string;
-    input: unknown;
-} | {
-    op: "subscribe";
-    sub: number;
-    slot: string;
-    event: string;
-} | {
-    op: "unsubscribe";
-    sub: number;
-}
-/** A call on `ui.shell@1`, which the shell itself serves, with no binding. */
- | {
-    op: "shell";
-    id: number;
-    method: string;
-    input: unknown;
-}
-/** A line for the view's Actor's log: the view's own, or an error it didn't catch. */
- | {
-    op: "log";
-    level: "info" | "warn" | "error";
-    message: string;
-    fields?: Record<string, unknown>;
-}
-/** The answer to one of the shell's requests. */
- | {
-    op: "reply";
-    id: number;
-    result: unknown;
-} | {
-    op: "reply";
-    id: number;
-    error: ErrorBody;
-};
-/** A port both sides speak on: the browser's `MessagePort`, or Node's in tests. */
-export interface PortLike {
-    postMessage(message: unknown): void;
-    onmessage: ((event: {
-        data: unknown;
-    }) => void) | null;
-    close(): void;
-}
-/**
- * Whether an interface is `ui.shell@1`: the shell's own in-frame interface, the mirror of
- * `ui.view@1`. The frame runtime binds a slot of it to the shell itself, so it is always bound and
- * no binding in the Hub ever names it.
- */
-export declare function isShellInterface(iface: Interface): boolean;

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

@@ -1,16 +0,0 @@
-/**
- * The messages between a shell and a view's sandboxed frame, over the one `MessagePort` the shell
- * hands the frame. The frame has no network and no shell state: everything it reaches goes
- * through these. The shell is trusted by the frame; the frame is not trusted by the shell, so
- * `FrameHost` checks every message it gets.
- */
-/** What the shell posts to the frame's window, with the port, to start. */
-export const FRAME_HELLO = "frame/1";
-/**
- * Whether an interface is `ui.shell@1`: the shell's own in-frame interface, the mirror of
- * `ui.view@1`. The frame runtime binds a slot of it to the shell itself, so it is always bound and
- * no binding in the Hub ever names it.
- */
-export function isShellInterface(iface) {
-    return iface.kind === "rpc" && iface.name === "ui.shell" && iface.major === 1;
-}

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

@@ -1,25 +0,0 @@
-import { type PortLike } from "./frame-protocol.js";
-import { type FrameRoot } from "./module.js";
-export interface FrameOptions {
-    /** The port the shell handed this frame. */
-    port: PortLike;
-    /** The element the view renders into. */
-    root: FrameRoot;
-    /** Import a view's bundle, as `import(src)` does in a browser. */
-    load(src: string): Promise<unknown>;
-    /** Set the shell's theme tokens, CSS variables by name, on the frame's document. */
-    theme?(tokens: Record<string, string>): void;
-}
-/** A running frame: report what the view didn't catch, or stop. */
-export interface Frame {
-    /** An error the view didn't catch, for its Actor's log. */
-    failed(error: unknown): void;
-    close(): void;
-}
-/**
- * Run a view module in a frame, on the same runtime as a host module, so a view behaves as it does
- * in tests. Every slot of `ui.shell@1` is served by the shell and always bound; every other slot is
- * served over the port while the shell says it is bound. The shell drives `ui.view@1`: `mount`,
- * `resize` and `unmount` reach the view's handle. Only `ui.view@1` is served among its exports.
- */
-export declare function runFrame(options: FrameOptions): Frame;