@inhuman.tools/harness-tui 0.0.0-stage → 0.3.0

package/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright 2026 Merkle Bonsai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { attachTui, DAEMON_QUIT_ACTION, hostExitCode, sessionTitleOsc } from "./tui/host.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { attachTui, DAEMON_QUIT_ACTION, hostExitCode, sessionTitleOsc } from "./tui/host.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/interpreter/ComputedExecBox.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Observe-on-demand Arrival exec. The box is a MobX atom: first observer
+ * arms membraneClosure tracking; last observer tears the reaction down.
+ */
+import { type ExecOptions } from "@here.build/arrival";
+export type ComputedExecOptions = Omit<ExecOptions, "membraneClosure">;
+export declare class ComputedExecBox<T> {
+    #private;
+    constructor(source: string, opts: ComputedExecOptions);
+    get(): T | undefined;
+}
+//# sourceMappingURL=ComputedExecBox.d.ts.map

package/dist/interpreter/ComputedExecBox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComputedExecBox.d.ts","sourceRoot":"","sources":["../../src/interpreter/ComputedExecBox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG7D,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;AAOvE,qBAAa,eAAe,CAAC,CAAC;;gBAUhB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB;IAUrD,GAAG,IAAI,CAAC,GAAG,SAAS;CAmErB"}

package/dist/interpreter/ComputedExecBox.js

@@ -0,0 +1,88 @@
+/**
+ * Observe-on-demand Arrival exec. The box is a MobX atom: first observer
+ * arms membraneClosure tracking; last observer tears the reaction down.
+ */
+import { exec } from "@here.build/arrival";
+import { comparer, createAtom, Reaction, runInAction } from "mobx";
+export class ComputedExecBox {
+    #source;
+    #opts;
+    #atom;
+    #value;
+    #generation = 0;
+    #controller = null;
+    #rx = null;
+    #probe = null;
+    constructor(source, opts) {
+        this.#source = source;
+        this.#opts = opts;
+        this.#atom = createAtom("computedExec", () => this.#start(), () => this.#stop());
+    }
+    get() {
+        this.#atom.reportObserved();
+        return this.#value;
+    }
+    #start() {
+        this.#controller = new AbortController();
+        this.#rx = new Reaction("computedExec.deps", () => void this.#run(), undefined, false);
+        this.#probe = new Reaction("computedExec.probe", () => undefined, undefined, false);
+        void this.#run();
+    }
+    #stop() {
+        this.#generation += 1;
+        this.#controller?.abort();
+        this.#controller = null;
+        this.#rx?.dispose();
+        this.#rx = null;
+        this.#probe?.dispose();
+        this.#probe = null;
+    }
+    async #run() {
+        const rx = this.#rx;
+        const probe = this.#probe;
+        const controller = this.#controller;
+        if (rx === null || probe === null || controller === null)
+            return;
+        const generation = (this.#generation += 1);
+        const held = new Set();
+        try {
+            const values = await exec(this.#source, {
+                ...this.#opts,
+                signal: AbortSignal.any([this.#opts.signal, controller.signal].filter((v) => v !== undefined)),
+                membraneClosure: (work) => {
+                    let result;
+                    probe.track(() => {
+                        result = work();
+                    });
+                    for (const dep of probe.observing_)
+                        held.add(dep);
+                    return result;
+                },
+            });
+            if (generation !== this.#generation || controller.signal.aborted)
+                return;
+            rx.track(() => {
+                // Every held atom. Returning after the first drops `rows.keys` / `row.name`.
+                for (const dep of held) {
+                    if (typeof dep.reportObserved === "function") {
+                        dep.reportObserved();
+                        continue;
+                    }
+                    dep.get?.();
+                }
+            });
+            const next = values.at(-1);
+            if (comparer.structural(next, this.#value))
+                return;
+            runInAction(() => {
+                this.#value = next;
+                this.#atom.reportChanged();
+            });
+        }
+        catch {
+            if (generation !== this.#generation || controller.signal.aborted)
+                return;
+        }
+    }
+}
+//# sourceMappingURL=ComputedExecBox.js.map

package/dist/interpreter/ComputedExecBox.js.map

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

package/dist/interpreter/imageCapability.d.ts

@@ -0,0 +1,9 @@
+/** Kernel and session reads only. Choice/action constructors are `harness/ui`. */
+import { EnvCapability } from "@here.build/arrival";
+import { KernelRoot, SessionRoot } from "@inhuman.tools/harness-model";
+import { z } from "zod";
+export declare const imageCapability: EnvCapability<{
+    kernel: z.ZodInstanceOf<KernelRoot>;
+    session: z.ZodOptional<z.ZodInstanceOf<SessionRoot>>;
+}, Record<string, never>>;
+//# sourceMappingURL=imageCapability.d.ts.map

package/dist/interpreter/imageCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageCapability.d.ts","sourceRoot":"","sources":["../../src/interpreter/imageCapability.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;yBA0D1B,CAAC"}

package/dist/interpreter/imageCapability.js

@@ -0,0 +1,49 @@
+/** Kernel and session reads only. Choice/action constructors are `harness/ui`. */
+import { EnvCapability } from "@here.build/arrival";
+import { KernelRoot, SessionRoot } from "@inhuman.tools/harness-model";
+import { DriverSpec } from "@inhuman.tools/plexus-expectations";
+import { z } from "zod";
+export const imageCapability = EnvCapability.define("harness/image", {
+    configuration: {
+        kernel: z.instanceof(KernelRoot),
+        session: z.instanceof(SessionRoot).optional(),
+    },
+    symbols: (symbol, sz) => ({
+        "harness/kernel/connections": symbol.rosetta `harness/kernel/connections: live ConnectionSpec list`({ input: [], output: [sz.list(sz.box)], provenance: "source" }, function () {
+            return Object.values(this.configuration.kernel.connections);
+        }),
+        "harness/kernel/drivers": symbol.rosetta `harness/kernel/drivers: live DriverSpec list`({
+            input: [],
+            inputRest: { abilityClaim: sz.foldName.optional() },
+            output: [sz.list(sz.box)],
+            provenance: "source",
+        }, function ({ abilityClaim: want }) {
+            const all = Object.values(this.configuration.kernel.drivers);
+            return want === undefined ? all : all.filter((item) => item.abilityClaim.includes(want));
+        }),
+        // pipe, not source: pure projection of the driver ARGUMENT — mints nothing.
+        "harness/kernel/offers": symbol.rosetta `harness/kernel/offers: class-bootstrap offers on a driver`({ input: [sz.box.pipe(z.instanceof(DriverSpec))], output: [sz.list(sz.box)], provenance: "pipe" }, function (driver) {
+            return [...driver.offers];
+        }),
+        // Total read over a possibly-empty image: sessionless eval (kernel-scope
+        // commands) and a missing key both read as "" — connect.scm's
+        // `(equal? last "")` pins that contract. Not a door candidate.
+        "harness/session/get-current": symbol.rosetta `harness/session/get-current: immutable current kv; "" when unset or sessionless`({ input: [sz.foldName], output: [sz.string], provenance: "source" }, function (key) {
+            const session = this.configuration.session;
+            if (session === undefined)
+                return "";
+            return session.kvs[key] ?? "";
+        }),
+        // Same total-read contract as get-current. A session reads its own snapshot
+        // (mint + this conversation's writes); sessionless eval reads the live
+        // kernel index. connect.scm falls back to a version-derived default.
+        "harness/session/last-used-model": symbol.rosetta `harness/session/last-used-model: model last used on a connection; "" when none`({ input: [sz.foldName], output: [sz.string], provenance: "source" }, function (connection) {
+            const session = this.configuration.session;
+            if (session?.lastUsedConnectionModel[connection] !== undefined) {
+                return session.lastUsedConnectionModel[connection];
+            }
+            return this.configuration.kernel.lastUsedConnectionModel[connection] ?? "";
+        }),
+    }),
+});
+//# sourceMappingURL=imageCapability.js.map

package/dist/interpreter/imageCapability.js.map

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

package/dist/interpreter/rpcCapability.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Host-effect RPC for the command sandbox. The caller is configuration;
+ * named symbols are the methods. Not PEW; not an InhumanAction.
+ */
+import { EnvCapability } from "@here.build/arrival";
+import { z } from "zod";
+export type RpcCall = (method: string, params?: unknown) => unknown | Promise<unknown>;
+export declare const rpcCapability: EnvCapability<{
+    rpc: z.ZodOptional<z.ZodCustom<RpcCall, RpcCall>>;
+}, Record<string, never>>;
+//# sourceMappingURL=rpcCapability.d.ts.map

package/dist/interpreter/rpcCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcCapability.d.ts","sourceRoot":"","sources":["../../src/interpreter/rpcCapability.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAIvF,eAAO,MAAM,aAAa;;yBA6FxB,CAAC"}

package/dist/interpreter/rpcCapability.js

@@ -0,0 +1,91 @@
+/**
+ * Host-effect RPC for the command sandbox. The caller is configuration;
+ * named symbols are the methods. Not PEW; not an InhumanAction.
+ */
+import { EnvCapability } from "@here.build/arrival";
+import { z } from "zod";
+const scope = z.enum(["session", "project", "kernel"]);
+export const rpcCapability = EnvCapability.define("harness/rpc", {
+    configuration: {
+        rpc: z.custom((value) => typeof value === "function").optional(),
+    },
+    symbols: (symbol, sz) => {
+        const params = sz.dictRecord(sz.foldName, sz.union([sz.foldName, sz.string, sz.box])).default({});
+        const kvScope = sz.foldName.pipe(scope).optional();
+        function call(method, body) {
+            // `requiresConfig: ["rpc"]` doors every verb when the key is absent — present here.
+            return this.configuration.rpc(method, body);
+        }
+        return {
+            rpc: symbol.rosetta `rpc: call a named host method`({
+                input: [sz.foldName, params],
+                // The one legitimate z.dynamic: the verb is ∀-polymorphic in the host
+                // method's result and passes it through whole.
+                output: [sz.dynamic],
+                provenance: "source",
+                requiresConfig: ["rpc"],
+            }, async function (method, body) {
+                return call.call(this, method, body);
+            }),
+            "kv/set": symbol.rosetta `kv/set: write a string key`({
+                input: [sz.foldName, sz.string, kvScope],
+                output: [sz.undefinedResult],
+                provenance: "sink",
+                effects: (key, _value, kv) => [["kv", kv ?? "session", key]],
+                requiresConfig: ["rpc"],
+            }, async function (key, value, kv) {
+                const payload = { key, value };
+                if (kv !== undefined)
+                    payload.scope = kv;
+                await call.call(this, "kv/set", payload);
+                return undefined;
+            }),
+            "kv/clear": symbol.rosetta `kv/clear: clear a string key`({
+                input: [sz.foldName, kvScope],
+                output: [sz.undefinedResult],
+                provenance: "sink",
+                effects: (key, kv) => [["kv", kv ?? "session", key]],
+                requiresConfig: ["rpc"],
+            }, async function (key, kv) {
+                const payload = { key };
+                if (kv !== undefined)
+                    payload.scope = kv;
+                await call.call(this, "kv/clear", payload);
+                return undefined;
+            }),
+            "connect/adopt": symbol.rosetta `connect/adopt: adopt a connection; returns the host adoption result`({
+                input: [],
+                inputRest: {
+                    driver: sz.foldName,
+                    name: sz.string.optional(),
+                    settings: sz.box.optional(),
+                },
+                // Source with consequences, not a sink: the host result (adopted id /
+                // follow-up UI form) is real data the caller reads.
+                output: [sz.box],
+                provenance: "source",
+                effects: (kwargs) => [["connections", kwargs.driver]],
+                queries: (kwargs) => [["connections", kwargs.driver]],
+                requiresConfig: ["rpc"],
+            }, async function (kwargs) {
+                const payload = { driver: kwargs.driver };
+                if (kwargs.name !== undefined)
+                    payload.name = kwargs.name;
+                if (kwargs.settings !== undefined)
+                    payload.settings = kwargs.settings;
+                return (await call.call(this, "connect/adopt", payload));
+            }),
+            "connect/drop": symbol.rosetta `connect/drop: remove a connection`({
+                input: [sz.foldName],
+                output: [sz.undefinedResult],
+                provenance: "sink",
+                effects: (id) => [["connections", id]],
+                requiresConfig: ["rpc"],
+            }, async function (id) {
+                await call.call(this, "connect/drop", { id });
+                return undefined;
+            }),
+        };
+    },
+});
+//# sourceMappingURL=rpcCapability.js.map

package/dist/interpreter/rpcCapability.js.map

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

package/dist/interpreter/uiCapability.d.ts

@@ -0,0 +1,34 @@
+/**
+ * ONE NODE, TWO CONSTRUCTORS. Chrome branches on visible children, not on
+ * which constructor minted the node. Activate is Enter on this node: children
+ * present → drill; none → fire `:action` (a list of named leaves, in order)
+ * and pass composer text as `:input`. The list is the sequence; Tea walks it.
+ * Does not apply. Action names and params are plugin-owned — this capability
+ * does not lower them.
+ *
+ * Callback chunks (`harness/confirm`, `harness/input`, `harness/open-url`,
+ * `harness/notice`) are sugar over the same node. They bake `ui/resolve`
+ * leaves; Tea evals them with `pending` in the env.
+ */
+import { EnvCapability } from "@here.build/arrival";
+import { z } from "zod";
+export declare class UiNode {
+    readonly name: string;
+    readonly description: string;
+    readonly aliases: readonly string[];
+    readonly health: "ok" | "degraded" | "failed";
+    readonly healthAnnotation: string;
+    readonly hotkey: string | undefined;
+    readonly action: readonly UiNode[];
+    readonly alternateActions: readonly UiNode[];
+    readonly choices: readonly UiNode[];
+    readonly op: string | null;
+    readonly params: Readonly<Record<string, unknown>>;
+    readonly secret: boolean;
+    readonly annotation: string;
+    constructor(name: string, description: string, aliases: readonly string[], health: "ok" | "degraded" | "failed", healthAnnotation: string, hotkey: string | undefined, action: readonly UiNode[], alternateActions: readonly UiNode[], choices: readonly UiNode[], op: string | null, params: Readonly<Record<string, unknown>>, secret?: boolean, annotation?: string);
+}
+export declare const uiCapability: EnvCapability<{
+    pending: z.ZodOptional<z.ZodString>;
+}, Record<string, never>>;
+//# sourceMappingURL=uiCapability.d.ts.map

package/dist/interpreter/uiCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uiCapability.d.ts","sourceRoot":"","sources":["../../src/interpreter/uiCapability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qBACa,MAAM;IAEf,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE;IACnC,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE;IAClC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAC1B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,OAAO;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAZlB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,EACpC,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,EAAE,EAAE,MAAM,GAAG,IAAI,EACjB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,MAAM,GAAE,OAAe,EACvB,UAAU,GAAE,MAAW;CAEnC;AAMD,eAAO,MAAM,YAAY;;yBA4MvB,CAAC"}

package/dist/interpreter/uiCapability.js

@@ -0,0 +1,207 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+/**
+ * ONE NODE, TWO CONSTRUCTORS. Chrome branches on visible children, not on
+ * which constructor minted the node. Activate is Enter on this node: children
+ * present → drill; none → fire `:action` (a list of named leaves, in order)
+ * and pass composer text as `:input`. The list is the sequence; Tea walks it.
+ * Does not apply. Action names and params are plugin-owned — this capability
+ * does not lower them.
+ *
+ * Callback chunks (`harness/confirm`, `harness/input`, `harness/open-url`,
+ * `harness/notice`) are sugar over the same node. They bake `ui/resolve`
+ * leaves; Tea evals them with `pending` in the env.
+ */
+import { EnvCapability } from "@here.build/arrival";
+import { arrival } from "@here.build/arrival/host-internals";
+import { keywordsOf } from "@inhuman.tools/harness-scheme/keywords";
+import { z } from "zod";
+let UiNode = (() => {
+    var _a;
+    let _classDecorators = [(_a = arrival).private.bind(_a)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    var UiNode = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            UiNode = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        name;
+        description;
+        aliases;
+        health;
+        healthAnnotation;
+        hotkey;
+        action;
+        alternateActions;
+        choices;
+        op;
+        params;
+        secret;
+        annotation;
+        constructor(name, description, aliases, health, healthAnnotation, hotkey, action, alternateActions, choices, op, params, secret = false, annotation = "") {
+            this.name = name;
+            this.description = description;
+            this.aliases = aliases;
+            this.health = health;
+            this.healthAnnotation = healthAnnotation;
+            this.hotkey = hotkey;
+            this.action = action;
+            this.alternateActions = alternateActions;
+            this.choices = choices;
+            this.op = op;
+            this.params = params;
+            this.secret = secret;
+            this.annotation = annotation;
+        }
+    };
+    return UiNode = _classThis;
+})();
+export { UiNode };
+function resolveLeaf(name, pending, params, hotkey) {
+    return new UiNode(name, "", [], "ok", "", hotkey, [], [], [], "ui/resolve", { pending, ...params });
+}
+export const uiCapability = EnvCapability.define("harness/ui", {
+    configuration: {
+        pending: z.string().optional(),
+    },
+    symbols: (symbol, sz) => {
+        const nodes = sz.list(sz.instance(UiNode)).default([]);
+        const health = sz.foldName.pipe(sz.enum(["ok", "degraded", "failed"])).default("ok");
+        const params = sz.dictRecord(sz.foldName, sz.union([sz.foldName, sz.string, sz.box])).default({});
+        return {
+            "harness/choice": symbol.rosetta `harness/choice: a place — chrome, optional activate, children`({
+                input: [],
+                inputRest: {
+                    name: sz.string.default(""),
+                    description: sz.string.default(""),
+                    annotation: sz.string.default(""),
+                    alias: sz.list(sz.string).default([]),
+                    "health-status": health,
+                    "health-annotation": sz.string.default(""),
+                    hotkey: sz.string.optional(),
+                    action: nodes,
+                    "alternate-actions": nodes,
+                    choices: nodes,
+                    secret: sz.boolean.default(false),
+                },
+                output: [sz.instance(UiNode)],
+                provenance: "pipe",
+            }, (kwargs) => new UiNode(kwargs.name, kwargs.description, kwargs.alias, kwargs["health-status"], kwargs["health-annotation"], kwargs.hotkey, kwargs.action, kwargs["alternate-actions"], kwargs.choices, null, {}, kwargs.secret, kwargs.annotation)),
+            "harness/action": symbol.rosetta `harness/action: a named plugin action; does not apply`({
+                input: [sz.foldName],
+                inputRest: sz.dynamic,
+                output: [sz.instance(UiNode)],
+                provenance: "pipe",
+            }, (op, ...rest) => {
+                const kwargs = keywordsOf("harness/action", rest, {
+                    name: sz.string.optional(),
+                    description: sz.string.default(""),
+                    hotkey: sz.string.optional(),
+                    alias: sz.list(sz.string).default([]),
+                    params,
+                });
+                return new UiNode(kwargs.name ?? op, kwargs.description, kwargs.alias, "ok", "", kwargs.hotkey, [], [], [], op, kwargs.params);
+            }),
+            // The four callback sugar verbs are `source`, not `pipe`: each reads
+            // `this.configuration.pending` into the minted node — external config
+            // data enters the result, so the crossing mints an origin.
+            "harness/confirm": symbol.rosetta `harness/confirm: callback confirm in the omnibox`({
+                input: [],
+                inputRest: {
+                    title: sz.string.default("Confirm"),
+                    name: sz.string.optional(),
+                    description: sz.string.default(""),
+                },
+                output: [sz.instance(UiNode)],
+                provenance: "source",
+            }, function (kwargs) {
+                const pending = this.configuration.pending ?? "";
+                const title = kwargs.name ?? kwargs.title;
+                return new UiNode(title, kwargs.description, [], "ok", "", undefined, [resolveLeaf("Confirm", pending, { kind: "accept" })], [resolveLeaf("Cancel", pending, { kind: "cancel" }, "escape")], [], null, {});
+            }),
+            "harness/input": symbol.rosetta `harness/input: callback text in the omnibox remainder`({
+                input: [],
+                inputRest: {
+                    name: sz.string.default("Input"),
+                    description: sz.string.default(""),
+                    secret: sz.boolean.default(false),
+                },
+                output: [sz.instance(UiNode)],
+                provenance: "source",
+            }, function (kwargs) {
+                const pending = this.configuration.pending ?? "";
+                return new UiNode(kwargs.name, kwargs.description, [], "ok", "", undefined, [resolveLeaf(kwargs.name, pending, { kind: "text", input: "" })], [resolveLeaf("Cancel", pending, { kind: "cancel" }, "escape")], [], null, {}, kwargs.secret);
+            }),
+            "harness/open-url": symbol.rosetta `harness/open-url: open a link; optional text/password remainder`({
+                input: [],
+                inputRest: {
+                    url: sz.string,
+                    name: sz.string.default("Continue"),
+                    description: sz.string.default(""),
+                    input: sz.foldName.pipe(sz.enum(["text", "password"])).optional(),
+                },
+                output: [sz.instance(UiNode)],
+                provenance: "source",
+            }, function (kwargs) {
+                const pending = this.configuration.pending ?? "";
+                const wantsInput = kwargs.input !== undefined;
+                return new UiNode(kwargs.name, kwargs.description, [], "ok", "", undefined, [
+                    resolveLeaf("Continue", pending, wantsInput ? { kind: "text", input: "" } : { kind: "opened", url: kwargs.url }),
+                ], [resolveLeaf("Cancel", pending, { kind: "cancel" }, "escape")], [], null, { url: kwargs.url }, kwargs.input === "password");
+            }),
+            "harness/notice": symbol.rosetta `harness/notice: callback notice in the omnibox`({
+                input: [],
+                inputRest: {
+                    message: sz.string.default(""),
+                    name: sz.string.optional(),
+                    description: sz.string.default(""),
+                },
+                output: [sz.instance(UiNode)],
+                provenance: "source",
+            }, function (kwargs) {
+                const pending = this.configuration.pending ?? "";
+                const title = kwargs.name ?? (kwargs.message === "" ? "Notice" : kwargs.message);
+                return new UiNode(title, kwargs.description === "" ? kwargs.message : kwargs.description, [], "ok", "", undefined, [resolveLeaf("Dismiss", pending, { kind: "dismiss" })], [resolveLeaf("Dismiss", pending, { kind: "dismiss" }, "escape")], [], null, {});
+            }),
+        };
+    },
+});
+//# sourceMappingURL=uiCapability.js.map

package/dist/interpreter/uiCapability.js.map

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

package/dist/schemas/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./worker-boot.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,2 @@
+export * from "./worker-boot.js";
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/schemas/worker-boot.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export declare const workerBootSchema: z.ZodObject<{
+    kernel: z.ZodString;
+    path: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    restore: z.ZodOptional<z.ZodBoolean>;
+    draft: z.ZodOptional<z.ZodString>;
+    cols: z.ZodOptional<z.ZodNumber>;
+    rows: z.ZodOptional<z.ZodNumber>;
+    connection: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type WorkerBoot = z.infer<typeof workerBootSchema>;
+//# sourceMappingURL=worker-boot.d.ts.map

package/dist/schemas/worker-boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-boot.d.ts","sourceRoot":"","sources":["../../src/schemas/worker-boot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;;;kBAYlB,CAAC;AAEZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}