@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/interpreter/reactivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactivity.js","sourceRoot":"","sources":["../../src/interpreter/reactivity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAoB,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAgC,QAAQ,EAAE,MAAM,MAAM,CAAC;AASpF,MAAM,OAAO,eAAe;IACjB,OAAO,CAAS;IAChB,KAAK,CAAsB;IAC3B,KAAK,CAAQ;IACtB,MAAM,CAAgB;IACtB,WAAW,GAAG,CAAC,CAAC;IAChB,WAAW,GAA2B,IAAI,CAAC;IAC3C,GAAG,GAAoB,IAAI,CAAC;IAC5B,MAAM,GAAoB,IAAI,CAAC;IAE/B,YAAY,MAAc,EAAE,IAAyB;QACnD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,UAAU,CACrB,cAAc,EACd,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EACnB,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CACnB,CAAC;IACJ,CAAC;IAED,GAAG;QACD,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACvF,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACpF,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAChB,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,EAAE,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO;QAEjE,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAY,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAQ,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;gBAC3C,GAAG,IAAI,CAAC,KAAK;gBACb,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;gBAC5F,eAAe,EAAE,CAAI,IAAa,EAAK,EAAE;oBACvC,IAAI,MAAU,CAAC;oBACf,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE;wBACf,MAAM,GAAG,IAAI,EAAE,CAAC;oBAClB,CAAC,CAAC,CAAC;oBACH,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU;wBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBAClD,OAAO,MAAM,CAAC;gBAChB,CAAC;aACF,CAAC,CAAC;YACH,IAAI,UAAU,KAAK,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;YAEzE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBACZ,6EAA6E;gBAC7E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;wBAC7C,GAAG,CAAC,cAAc,EAAE,CAAC;wBACrB,SAAS;oBACX,CAAC;oBACD,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;gBAAE,OAAO;YACnD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,UAAU,KAAK,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;QAC3E,CAAC;IACH,CAAC;CACF"}

package/dist/interpreter/rpc.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 "@inhuman.tools/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=rpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/interpreter/rpc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,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;AAQvF,eAAO,MAAM,aAAa;;yBA6FxB,CAAC"}

package/dist/interpreter/rpc.js

@@ -0,0 +1,94 @@
+/**
+ * Host-effect RPC for the command sandbox. The caller is configuration;
+ * named symbols are the methods. Not PEW; not an InhumanAction.
+ */
+import { EnvCapability } from "@inhuman.tools/arrival";
+import { z } from "zod";
+function isRpcCall(value) {
+    return typeof value === "function";
+}
+const scope = z.enum(["session", "project", "kernel"]);
+export const rpcCapability = EnvCapability.define("harness/rpc", {
+    configuration: {
+        rpc: z.custom(isRpcCall).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=rpc.js.map

package/dist/interpreter/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/interpreter/rpc.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/ui.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 "@inhuman.tools/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=ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/interpreter/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,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;IAb7B,YACW,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,EAC9B;CACL;AAWD,eAAO,MAAM,YAAY;;yBA2MvB,CAAC"}

package/dist/interpreter/ui.js

@@ -0,0 +1,204 @@
+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 "@inhuman.tools/arrival";
+import { arrival } from "@inhuman.tools/arrival/host-internals";
+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: [],
+                inputRest: {
+                    op: sz.foldName,
+                    name: sz.string.optional(),
+                    description: sz.string.default(""),
+                    hotkey: sz.string.optional(),
+                    alias: sz.list(sz.string).default([]),
+                    params: params,
+                },
+                output: [sz.instance(UiNode)],
+                provenance: "pipe",
+            }, (kwargs) => new UiNode(kwargs.name ?? kwargs.op, kwargs.description, kwargs.alias, "ok", "", kwargs.hotkey, [], [], [], kwargs.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=ui.js.map

package/dist/interpreter/ui.js.map

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