@zenalexa/unicli 0.225.0 → 0.225.2

package/dist/commands/schema.js

@@ -11,6 +11,8 @@
 import chalk from "chalk";
 import { getAllAdapters, resolveCommand } from "../registry.js";
 import { ExitCode } from "../types.js";
+import { buildCoreCommandContract } from "../core/command-contract.js";
+import { getCoreDiscoveryCommand, listCoreDiscoveryCommands, } from "../discovery/core-catalog.js";
 import { buildInputSchema, buildOutputSchema, } from "../mcp/schema.js";
 import { format, detectFormat } from "../output/formatter.js";
 import { makeCtx } from "../output/envelope.js";
@@ -23,6 +25,16 @@ function buildCommandSchema(site, cmdName, cmd) {
         output: buildOutputSchema(cmd, "flat"),
     };
 }
+function buildCoreCommandSchema(cmd) {
+    const contract = buildCoreCommandContract({ command: cmd });
+    return {
+        site: cmd.site,
+        command: cmd.command,
+        description: cmd.description,
+        input: contract.schemas.input,
+        output: { type: "object", properties: {}, additionalProperties: true },
+    };
+}
 // ── Command registration ─────────────────────────────────────────────────
 export function registerSchemaCommand(program) {
     program
@@ -42,6 +54,9 @@ export function registerSchemaCommand(program) {
                     schemas.push(buildCommandSchema(adapter.name, cmdName, cmd));
                 }
             }
+            for (const coreCommand of listCoreDiscoveryCommands()) {
+                schemas.push(buildCoreCommandSchema(coreCommand));
+            }
             if (schemas.length === 0) {
                 ctx.error = {
                     code: "not_found",
@@ -69,6 +84,13 @@ export function registerSchemaCommand(program) {
             console.error(format(null, undefined, fmt, ctx));
             process.exit(ExitCode.USAGE_ERROR);
         }
+        const coreCommand = getCoreDiscoveryCommand(site, command);
+        if (coreCommand) {
+            const schema = buildCoreCommandSchema(coreCommand);
+            ctx.duration_ms = Date.now() - startedAt;
+            console.log(format(schema, undefined, fmt, ctx));
+            return;
+        }
         const resolved = resolveCommand(site, command);
         if (!resolved) {
             // Try to suggest similar commands

package/dist/commands/schema.js.map

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

package/dist/commands/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2D5D"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmE5D"}

package/dist/commands/search.js

@@ -10,6 +10,8 @@
 import chalk from "chalk";
 import { search } from "../discovery/search.js";
 import { format, detectFormat } from "../output/formatter.js";
+import { printErrorEnvelope } from "../output/error-writer.js";
+import { emptySearchResultError } from "../output/error-map.js";
 export function registerSearchCommand(program) {
     program
         .command("search [query...]")
@@ -26,12 +28,21 @@ export function registerSearchCommand(program) {
             return;
         }
         const results = search(query, limit, { category: opts.category });
+        const fmt = detectFormat(program.opts().format);
         if (results.length === 0) {
-            console.error(chalk.yellow(`No commands found for: ${[opts.category, query].filter(Boolean).join(" ")}`));
-            process.exitCode = 66; // EX_EMPTY
+            const queryLabel = [opts.category, query].filter(Boolean).join(" ");
+            printErrorEnvelope({
+                fmt,
+                exitCode: 66, // EX_EMPTY
+                ctx: {
+                    command: "core.search",
+                    duration_ms: Date.now() - searchStarted,
+                    surface: "web",
+                    error: emptySearchResultError(queryLabel, query.replace(/"/g, "").trim()),
+                },
+            });
             return;
         }
-        const fmt = detectFormat(program.opts().format);
         const rows = results.map((r) => ({
             command: `${r.site} ${r.command}`,
             description: r.description || `${r.command} for ${r.site}`,

package/dist/commands/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI9D,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CACV,oEAAoE,CACrE;SACA,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,GAAG,CAAC;SAC7C,MAAM,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;SAChD,MAAM,CACL,CAAC,UAAoB,EAAE,IAA0C,EAAE,EAAE;QACnE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CACP,kEAAkE,CACnE,CACF,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAElE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,MAAM,CACV,0BAA0B,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAC7E,CACF,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,WAAW;YAClC,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,YAAY,CACtB,OAAO,CAAC,IAAI,EAAE,CAAC,MAAkC,CAClD,CAAC;QAEF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE;YACjC,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,IAAI,EAAE;YAC1D,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC,CAAC;QAEJ,MAAM,GAAG,GAAiB;YACxB,OAAO,EAAE,aAAa;YACtB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa;YACvC,OAAO,EAAE,KAAK;SACf,CAAC;QAEF,OAAO,CAAC,GAAG,CACT,MAAM,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CACrE,CAAC;IACJ,CAAC,CACF,CAAC;AACN,CAAC"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"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"}

package/dist/compute/contracts.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @owner   src/compute/contracts.ts
+ * @does    Define the shared compute command and ref-provenance contract projected into CLI discovery, schema, and MCP.
+ * @needs   none
+ * @feeds   src/discovery/core-catalog.ts, src/mcp/profiles/computer-use.ts, src/transport/cascade.ts
+ * @breaks  Drift here makes agents compile invalid computer-use calls or route refs to the wrong provider.
+ * @invariants Ref-consuming commands declare accepted namespaces in the same description used by describe/schema/MCP.
+ * @side-effects none
+ * @perf    Static data and O(argument count) schema projection.
+ * @concurrency immutable constants.
+ * @test    tests/unit/command-contract.test.ts, tests/unit/mcp/tools.test.ts, tests/unit/compute-cascade.test.ts
+ * @stability provisional
+ * @since   0.225.1
+ */
+export type ComputeArgType = "str" | "int" | "float" | "bool";
+export interface ComputeCommandArg {
+    readonly name: string;
+    readonly type?: ComputeArgType;
+    readonly default?: unknown;
+    readonly required?: boolean;
+    readonly positional?: boolean;
+    readonly choices?: readonly string[];
+    readonly description?: string;
+}
+export interface ComputeCommandContract {
+    readonly command: string;
+    readonly mcpSuffix: string;
+    readonly kind: string;
+    readonly description: string;
+    readonly args: readonly ComputeCommandArg[];
+    readonly readOnly?: boolean;
+    readonly channels?: Record<string, string>;
+}
+export interface ComputeJsonSchemaProperty {
+    type: string;
+    description?: string;
+    default?: unknown;
+    enum?: string[];
+}
+export interface ComputeJsonSchemaObject {
+    type: "object";
+    properties: Record<string, ComputeJsonSchemaProperty>;
+    required?: string[];
+    additionalProperties?: false;
+}
+export declare const COMPUTE_REF_ACCEPTED_NAMESPACES: readonly ["@e* aliases allocated by the latest Uni-CLI compute snapshot, find, observe, or capture result", "desktop-ax:* stable refs from the Uni-CLI macOS AX transport", "desktop-uia:* stable refs from the Uni-CLI Windows UIA transport", "desktop-atspi:* stable refs from the Uni-CLI Linux AT-SPI transport", "cdp-browser:* or cdp:* stable refs allocated by Uni-CLI compute CDP snapshots"];
+export declare const COMPUTE_FOREIGN_REF_NAMESPACES: readonly ["olo:accessibility:* refs are OLo-owned and must be executed by OLo's accessibility provider", "browser-scoped DOM refs must be executed by the browser provider that created them"];
+export declare const COMPUTE_REF_DESCRIPTION: string;
+export declare const COMPUTE_COMMAND_CONTRACTS: readonly ComputeCommandContract[];
+export declare function getComputeCommandContract(command: string): ComputeCommandContract | undefined;
+export declare function getComputeCommandContractByMcpSuffix(suffix: string): ComputeCommandContract | undefined;
+export declare function buildComputeInputSchema(args: readonly ComputeCommandArg[]): ComputeJsonSchemaObject;
+export declare function isComputeStableRefNamespace(ref: string): boolean;
+export declare function readForeignComputeRefOwner(ref: string): string | undefined;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/compute/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/compute/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IACtD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,KAAK,CAAC;CAC9B;AAED,eAAO,MAAM,+BAA+B,yYAMlC,CAAC;AAEX,eAAO,MAAM,8BAA8B,gMAGjC,CAAC;AAEX,eAAO,MAAM,uBAAuB,QAIzB,CAAC;AAmEZ,eAAO,MAAM,yBAAyB,EAAE,SAAS,sBAAsB,EA4V7D,CAAC;AAEX,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,GACd,sBAAsB,GAAG,SAAS,CAIpC;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,GACb,sBAAsB,GAAG,SAAS,CAIpC;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS,iBAAiB,EAAE,GACjC,uBAAuB,CAqBzB;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQhE;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO1E"}

package/dist/compute/contracts.js

@@ -0,0 +1,487 @@
+/**
+ * @owner   src/compute/contracts.ts
+ * @does    Define the shared compute command and ref-provenance contract projected into CLI discovery, schema, and MCP.
+ * @needs   none
+ * @feeds   src/discovery/core-catalog.ts, src/mcp/profiles/computer-use.ts, src/transport/cascade.ts
+ * @breaks  Drift here makes agents compile invalid computer-use calls or route refs to the wrong provider.
+ * @invariants Ref-consuming commands declare accepted namespaces in the same description used by describe/schema/MCP.
+ * @side-effects none
+ * @perf    Static data and O(argument count) schema projection.
+ * @concurrency immutable constants.
+ * @test    tests/unit/command-contract.test.ts, tests/unit/mcp/tools.test.ts, tests/unit/compute-cascade.test.ts
+ * @stability provisional
+ * @since   0.225.1
+ */
+export const COMPUTE_REF_ACCEPTED_NAMESPACES = [
+    "@e* aliases allocated by the latest Uni-CLI compute snapshot, find, observe, or capture result",
+    "desktop-ax:* stable refs from the Uni-CLI macOS AX transport",
+    "desktop-uia:* stable refs from the Uni-CLI Windows UIA transport",
+    "desktop-atspi:* stable refs from the Uni-CLI Linux AT-SPI transport",
+    "cdp-browser:* or cdp:* stable refs allocated by Uni-CLI compute CDP snapshots",
+];
+export const COMPUTE_FOREIGN_REF_NAMESPACES = [
+    "olo:accessibility:* refs are OLo-owned and must be executed by OLo's accessibility provider",
+    "browser-scoped DOM refs must be executed by the browser provider that created them",
+];
+export const COMPUTE_REF_DESCRIPTION = [
+    "Uni-CLI compute element ref.",
+    `Accepts ${COMPUTE_REF_ACCEPTED_NAMESPACES.join("; ")}.`,
+    `Does not accept ${COMPUTE_FOREIGN_REF_NAMESPACES.join("; ")}.`,
+].join(" ");
+const APP_ARG = {
+    name: "app",
+    type: "str",
+    description: 'App name, bundle id, or process name, e.g. "Slack"',
+};
+const FOCUS_ARG = {
+    name: "focus",
+    type: "bool",
+    default: false,
+    description: "Focus the target app before the action.",
+};
+const OVERLAY_ARG = {
+    name: "overlay",
+    type: "bool",
+    default: false,
+    description: "Render the system-level virtual cursor HUD for this action.",
+};
+const REF_ARG = {
+    name: "ref",
+    type: "str",
+    required: true,
+    positional: true,
+    description: COMPUTE_REF_DESCRIPTION,
+};
+const SNAPSHOT_FORMAT_ARG = {
+    name: "format",
+    type: "str",
+    default: "compact",
+    choices: ["compact", "tree", "json"],
+    description: "Snapshot encoding for accessibility refs",
+};
+const MAX_DEPTH_ARG = {
+    name: "maxDepth",
+    type: "int",
+    default: 64,
+    description: "Maximum accessibility tree depth",
+};
+const ROLE_CHOICES = [
+    "button",
+    "input",
+    "textarea",
+    "text",
+    "menuitem",
+    "checkbox",
+    "radio",
+    "link",
+    "image",
+    "window",
+    "group",
+    "list",
+    "listitem",
+    "tab",
+    "tree",
+    "treeitem",
+    "slider",
+    "combobox",
+    "spinbutton",
+];
+export const COMPUTE_COMMAND_CONTRACTS = [
+    {
+        command: "apps",
+        mcpSuffix: "apps",
+        kind: "compute_apps",
+        readOnly: true,
+        args: [],
+        description: "List currently running applications visible to the native computer-control layer.",
+    },
+    {
+        command: "windows",
+        mcpSuffix: "windows",
+        kind: "compute_windows",
+        readOnly: true,
+        args: [APP_ARG],
+        description: "List top-level windows, optionally scoped to an app.",
+    },
+    {
+        command: "snapshot",
+        mcpSuffix: "snapshot",
+        kind: "compute_snapshot",
+        readOnly: true,
+        args: [
+            APP_ARG,
+            SNAPSHOT_FORMAT_ARG,
+            {
+                name: "interactiveOnly",
+                type: "bool",
+                default: false,
+                description: "Only include interactive elements",
+            },
+            MAX_DEPTH_ARG,
+        ],
+        description: "Capture a compact accessibility snapshot with Uni-CLI-owned refs for later compute actions.",
+    },
+    {
+        command: "capture",
+        mcpSuffix: "capture",
+        kind: "compute_capture",
+        args: [
+            APP_ARG,
+            SNAPSHOT_FORMAT_ARG,
+            {
+                name: "include",
+                type: "str",
+                default: "snapshot,screenshot",
+                description: "Comma-separated capture parts: snapshot,screenshot",
+            },
+            MAX_DEPTH_ARG,
+            {
+                name: "screenshotPath",
+                type: "str",
+                description: "Optional screenshot output path",
+            },
+            {
+                name: "saveReference",
+                type: "bool",
+                default: false,
+                description: "Persist app-shot handoff artifacts",
+            },
+            {
+                name: "copyReference",
+                type: "bool",
+                default: false,
+                description: "Persist and copy app-shot handoff markup",
+            },
+            {
+                name: "referenceRoot",
+                type: "str",
+                description: "Directory for saved app-shot artifacts",
+            },
+        ],
+        channels: {
+            shell: "unicli compute capture [--app <name>] [--include snapshot,screenshot] [--format compact] [--copy-reference]",
+            args_file: "unicli compute capture --args-file <path.json>",
+            stdin: "echo '{...}' | unicli compute capture",
+        },
+        description: "Capture local computer-use context by combining accessibility refs, app state, screenshot evidence, image metadata, app-shot reference artifacts, clipboard handoff markup, and replayable capture trajectory.",
+    },
+    {
+        command: "find",
+        mcpSuffix: "find",
+        kind: "compute_find",
+        readOnly: true,
+        args: [
+            {
+                name: "role",
+                type: "str",
+                required: true,
+                choices: ROLE_CHOICES,
+                description: "Element role to match from the latest Uni-CLI compute ref store",
+            },
+            {
+                name: "name",
+                type: "str",
+                description: "Substring match against the accessible name",
+            },
+            {
+                name: "text",
+                type: "str",
+                description: "Match visible or current text value",
+            },
+            APP_ARG,
+            {
+                name: "first",
+                type: "bool",
+                default: false,
+                description: "Return the first unambiguous match",
+            },
+        ],
+        description: "Find elements from the latest Uni-CLI compute snapshot by role, name, or visible/current text value.",
+    },
+    {
+        command: "click",
+        mcpSuffix: "click",
+        kind: "compute_click",
+        args: [REF_ARG, FOCUS_ARG, OVERLAY_ARG],
+        description: "Click a Uni-CLI compute element by ref.",
+    },
+    {
+        command: "type",
+        mcpSuffix: "type",
+        kind: "compute_type",
+        args: [
+            REF_ARG,
+            {
+                name: "text",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "Text to type or set into the target element",
+            },
+            {
+                name: "clear",
+                type: "bool",
+                default: false,
+                description: "Clear the field before entering text when supported",
+            },
+            FOCUS_ARG,
+            OVERLAY_ARG,
+        ],
+        description: "Type text into a Uni-CLI compute element ref.",
+    },
+    {
+        command: "press",
+        mcpSuffix: "press",
+        kind: "compute_press",
+        args: [
+            {
+                name: "combo",
+                type: "str",
+                required: true,
+                positional: true,
+                description: 'Keyboard combo, e.g. "cmd+s" or "ctrl+shift+p"',
+            },
+            APP_ARG,
+            FOCUS_ARG,
+        ],
+        description: 'Press a keyboard combo, e.g. "cmd+s" or "ctrl+shift+p".',
+    },
+    {
+        command: "scroll",
+        mcpSuffix: "scroll",
+        kind: "compute_scroll",
+        args: [
+            REF_ARG,
+            {
+                name: "direction",
+                type: "str",
+                choices: ["up", "down", "left", "right"],
+                default: "down",
+                description: "Scroll direction",
+            },
+            {
+                name: "amount",
+                type: "int",
+                default: 300,
+                description: "Pixels or transport-native scroll amount",
+            },
+            FOCUS_ARG,
+            OVERLAY_ARG,
+        ],
+        description: "Scroll a Uni-CLI compute element or active view.",
+    },
+    {
+        command: "launch",
+        mcpSuffix: "launch",
+        kind: "compute_launch",
+        args: [
+            {
+                name: "app",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "App name, bundle id, process name, or path",
+            },
+            {
+                name: "debugPort",
+                type: "int",
+                description: "Electron CDP debug port",
+            },
+        ],
+        description: "Launch an app by name, bundle id, process name, or path.",
+    },
+    {
+        command: "screenshot",
+        mcpSuffix: "screenshot",
+        kind: "compute_screenshot",
+        readOnly: true,
+        args: [
+            {
+                name: "path",
+                type: "str",
+                positional: true,
+                description: "Optional output path",
+            },
+            APP_ARG,
+        ],
+        description: "Capture a pixel screenshot. Prefer snapshot unless accessibility data is unavailable.",
+    },
+    {
+        command: "attach",
+        mcpSuffix: "attach",
+        kind: "compute_cdp_attach",
+        args: [
+            APP_ARG,
+            {
+                name: "port",
+                type: "int",
+                description: "CDP port",
+            },
+            {
+                name: "confirmRelaunch",
+                type: "bool",
+                default: false,
+                description: "Allow relaunching apps that may lose session state",
+            },
+        ],
+        description: "Attach to an Electron app or explicit CDP port.",
+    },
+    {
+        command: "eval",
+        mcpSuffix: "evaluate",
+        kind: "compute_evaluate",
+        args: [
+            {
+                name: "js",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "JavaScript to evaluate in the attached CDP renderer",
+            },
+            {
+                name: "targetId",
+                type: "str",
+                description: "Optional CDP target id",
+            },
+        ],
+        description: "Run JavaScript in the attached CDP renderer.",
+    },
+    {
+        command: "wait",
+        mcpSuffix: "wait",
+        kind: "compute_wait",
+        readOnly: true,
+        args: [
+            {
+                ...REF_ARG,
+                required: false,
+                positional: false,
+            },
+            {
+                name: "text",
+                type: "str",
+                description: "Text to wait for",
+            },
+            APP_ARG,
+            {
+                name: "state",
+                type: "str",
+                choices: ["appear", "disappear", "focused"],
+                description: "State condition to wait for",
+            },
+            {
+                name: "timeoutMs",
+                type: "int",
+                default: 10_000,
+                description: "Timeout in milliseconds",
+            },
+        ],
+        description: "Wait for a ref, text, or state condition.",
+    },
+    {
+        command: "observe",
+        mcpSuffix: "observe",
+        kind: "compute_observe",
+        readOnly: true,
+        args: [
+            {
+                name: "goal",
+                type: "str",
+                required: true,
+                positional: true,
+                description: "Natural-language goal used to rank candidate refs",
+            },
+            APP_ARG,
+            {
+                name: "topK",
+                type: "int",
+                default: 5,
+                description: "Maximum candidate refs to return",
+            },
+        ],
+        description: "Rank candidate refs for a natural-language goal from the latest Uni-CLI compute snapshot.",
+    },
+    {
+        command: "assert",
+        mcpSuffix: "assert",
+        kind: "compute_assert",
+        readOnly: true,
+        args: [
+            {
+                ...REF_ARG,
+                required: false,
+                positional: false,
+            },
+            {
+                name: "text",
+                type: "str",
+                description: "Expected text",
+            },
+            {
+                name: "state",
+                type: "str",
+                choices: ["enabled", "focused", "checked", "visible"],
+                description: "State to assert",
+            },
+        ],
+        description: "Assert a UI condition by ref, text, or state.",
+    },
+];
+export function getComputeCommandContract(command) {
+    return COMPUTE_COMMAND_CONTRACTS.find((candidate) => candidate.command === command);
+}
+export function getComputeCommandContractByMcpSuffix(suffix) {
+    return COMPUTE_COMMAND_CONTRACTS.find((candidate) => candidate.mcpSuffix === suffix);
+}
+export function buildComputeInputSchema(args) {
+    const properties = {};
+    const required = [];
+    for (const arg of args) {
+        const property = {
+            type: jsonTypeForComputeArg(arg.type),
+        };
+        if (arg.description !== undefined)
+            property.description = arg.description;
+        if (arg.default !== undefined)
+            property.default = arg.default;
+        if (arg.choices !== undefined && arg.choices.length > 0) {
+            property.enum = [...arg.choices];
+        }
+        properties[arg.name] = property;
+        if (arg.required === true)
+            required.push(arg.name);
+    }
+    return {
+        type: "object",
+        properties,
+        ...(required.length > 0 ? { required } : {}),
+        additionalProperties: false,
+    };
+}
+export function isComputeStableRefNamespace(ref) {
+    return (ref.startsWith("desktop-ax:") ||
+        ref.startsWith("desktop-uia:") ||
+        ref.startsWith("desktop-atspi:") ||
+        ref.startsWith("cdp-browser:") ||
+        ref.startsWith("cdp:"));
+}
+export function readForeignComputeRefOwner(ref) {
+    if (ref.startsWith("olo:accessibility:"))
+        return "olo.accessibility";
+    if (ref.startsWith("browser:") || ref.startsWith("dom:")) {
+        return "browser";
+    }
+    if (ref.includes(":") && !isComputeStableRefNamespace(ref))
+        return "unknown";
+    return undefined;
+}
+function jsonTypeForComputeArg(type) {
+    if (type === "int")
+        return "integer";
+    if (type === "float")
+        return "number";
+    if (type === "bool")
+        return "boolean";
+    return "string";
+}
+//# sourceMappingURL=contracts.js.map