@melaya/runner 1.1.71 → 1.1.73

package/dist/computerHelperManifest.d.ts

@@ -1,4 +1,4 @@
-export declare const COMPUTER_HELPER_VERSION = "1.0.1";
+export declare const COMPUTER_HELPER_VERSION = "1.2.0";
 export declare const COMPUTER_HELPER_MANIFEST: Record<string, {
     url: string;
     sha256: string;

package/dist/computerHelperManifest.js

@@ -5,14 +5,14 @@
 // Pinned computer helper releases for the runner CLI host (computerHostCli.ts),
 // keyed by `${process.platform}-${process.arch}`. A download is only accepted
 // when its sha256 matches.
-export const COMPUTER_HELPER_VERSION = "1.0.1";
+export const COMPUTER_HELPER_VERSION = "1.2.0";
 export const COMPUTER_HELPER_MANIFEST = {
     "linux-arm64": {
-        "url": "https://api.melaya.org/desktop/helpers/1.0.1/melaya-computer-linux-aarch64",
-        "sha256": "f5e6825fc00b589178b0540ed6f2e350dc8ac77bb97e08ae17395282465fec36"
+        "url": "https://api.melaya.org/desktop/helpers/1.2.0/melaya-computer-linux-aarch64",
+        "sha256": "8f1ddb5a4bdcc7bda35439de6ec1aa962e16b199dcb510e52fb48c00782eeef9"
     },
     "linux-x64": {
-        "url": "https://api.melaya.org/desktop/helpers/1.0.1/melaya-computer-linux-x86_64",
-        "sha256": "795933f10803f2bc25c95207e5a196ff6413e2e55f038ccd54c3f6f19e7c764c"
+        "url": "https://api.melaya.org/desktop/helpers/1.2.0/melaya-computer-linux-x86_64",
+        "sha256": "1431df7dd6f6a5d8412e4120fdadc82c247965a1139b03dd585ce93b21d5e88a"
     }
 };

package/dist/computerHostCli.d.ts

@@ -77,10 +77,11 @@ export type ComputerCapabilitiesLike = Record<string, unknown> & {
     kinds: string[];
     host?: "desktop" | "cli";
 };
-export declare const COMPUTER_ACTION_KINDS: readonly ["screen", "screenshot", "find", "get_text", "current_app", "list_windows", "list_apps", "list_displays", "clipboard_read", "ocr", "wait", "hover", "move", "scroll", "focus_window", "open_app", "open_url", "open_file", "click", "type", "press", "drag", "select", "set_value", "toggle", "window", "clipboard_write", "file_dialog", "batch", "zoom", "cursor_position", "read_table", "expect", "mouse", "hold_key", "select_text", "quit_app", "save_dialog", "handoff", "keep_awake"];
+export declare const COMPUTER_ACTION_KINDS: readonly ["screen", "screenshot", "find", "get_text", "current_app", "list_windows", "list_apps", "list_displays", "clipboard_read", "ocr", "wait", "hover", "move", "scroll", "focus_window", "open_app", "open_url", "open_file", "click", "type", "press", "drag", "select", "set_value", "toggle", "window", "clipboard_write", "file_dialog", "batch", "zoom", "cursor_position", "read_table", "expect", "mouse", "hold_key", "select_text", "quit_app", "save_dialog", "handoff", "keep_awake", "path"];
 /** Kinds that do not act on an app window: an empty allowlist does not block them. */
 export declare const APP_INDEPENDENT_KINDS: Set<string>;
-export declare const COMPUTER_MAX_BATCH_STEPS = 100;
+/** Steps per batch: a whole drawing in one call (raised from 100 on 2026-10-23). */
+export declare const COMPUTER_MAX_BATCH_STEPS = 5000;
 /** The lowest app tier that allows this action (same rule as the server and the helpers). */
 export declare function requiredTierOf(action: Record<string, unknown>): ComputerAppTier;
 /**
@@ -120,7 +121,7 @@ export declare function checkCommand(msg: {
  * accepted when its sha256 matches. Empty until the first release: use
  * MELAYA_COMPUTER_HELPER or --computer-helper meanwhile.
  */
-export declare const HELPER_VERSION = "1.0.1";
+export declare const HELPER_VERSION = "1.2.0";
 export declare const HELPER_MANIFEST: Record<string, {
     url: string;
     sha256: string;
@@ -184,6 +185,8 @@ export declare class HelperProcess {
      * Aborts one command (or every one). A command that has not answered `stopped`
      * within the grace period gets the helper killed; it restarts on the next command.
      */
+    /** Releases every key / button the helper holds (helper 1.2.0+; older helpers ignore the op). */
+    release(): void;
     cancel(target?: string): void;
     get running(): boolean;
     dispose(): void;

package/dist/computerHostCli.js

@@ -56,6 +56,8 @@ export const COMPUTER_ACTION_KINDS = [
     "toggle", "window", "clipboard_write", "file_dialog", "batch",
     "zoom", "cursor_position", "read_table", "expect", "mouse", "hold_key", "select_text", "quit_app",
     "save_dialog", "handoff", "keep_awake",
+    // helper 1.2.0 (2026-10-23): pointer paths (planned by the server, replayed by the helper)
+    "path",
 ];
 const READ_KINDS = new Set([
     "screen", "screenshot", "find", "get_text", "current_app", "list_windows", "list_apps",
@@ -67,7 +69,8 @@ const KIND_SET = new Set(COMPUTER_ACTION_KINDS);
 export const APP_INDEPENDENT_KINDS = new Set(["list_apps", "list_displays", "cursor_position", "keep_awake", "handoff"]);
 /** File handles need the desktop app's handle store (it sends `resolved.path`); the CLI has none. */
 const NEEDS_FILE_HANDLES = new Set(["open_file", "file_dialog", "save_dialog"]);
-export const COMPUTER_MAX_BATCH_STEPS = 100;
+/** Steps per batch: a whole drawing in one call (raised from 100 on 2026-10-23). */
+export const COMPUTER_MAX_BATCH_STEPS = 5000;
 const DEFAULT_DEADLINE_MS = 15_000;
 const MAX_DEADLINE_MS = 31 * 60_000;
 const PROTOCOL_VERSION = 1;
@@ -465,6 +468,10 @@ export class HelperProcess {
      * Aborts one command (or every one). A command that has not answered `stopped`
      * within the grace period gets the helper killed; it restarts on the next command.
      */
+    /** Releases every key / button the helper holds (helper 1.2.0+; older helpers ignore the op). */
+    release() {
+        this.send({ op: "release" });
+    }
     cancel(target) {
         this.send(target ? { op: "cancel", target } : { op: "cancel" });
         if (!target || !this.child)
@@ -734,6 +741,11 @@ export function createCliComputerHost(options = {}) {
                 const forced = !expectFailed && ["stopped", "timeout", "user_interrupted", "screen_locked", "secure_desktop"].includes(code);
                 if (onError || forced) {
                     const msg = r.error?.message || "";
+                    // A batch that did not finish leaves nothing pressed (hold_key / mouse down without their up).
+                    try {
+                        helper?.release();
+                    }
+                    catch { /* best effort */ }
                     return { ok: false, kind: "batch", error: { code, message: `Step ${i + 1} failed: ${msg}` }, steps: results, elapsedMs: Date.now() - started };
                 }
             }

package/dist/connection.js

@@ -48,7 +48,7 @@ import { VAULT_HOST_CAPABILITY, VaultHostProcess, VaultRegistry, VaultService, a
 // Local REST API); the REST key stays in ~/.melaya-runner/vaults.
 import { ObsidianAppBridge } from "./obsidianApp.js";
 // Desktop app host channel: state changes for the app's tray and web UI (no-op under npx).
-import { hostStatus, isHosted, hostProgress, sendToHost } from "./hostChannel.js";
+import { hostStatus, isHosted, hostProgress, sendToHost, hostAppVersion } from "./hostChannel.js";
 // Desktop app: files this runner wrote are offered to computer control as handles (no-op under npx).
 import { reportHostFile, reportOutputsSince } from "./hostFiles.js";
 // Computer control: computer:command / computer:stop relayed to the desktop app
@@ -614,6 +614,11 @@ export async function connect(opts) {
                 deviceName: hostname(),
                 platform: process.platform,
             },
+            // Hosted by the Melaya desktop app: say so, with the app's version, so
+            // the server keeps that computer's app version current on every start
+            // (the token row is minted once) and knows this runner updates with the
+            // app, never with a restart command.
+            ...(isHosted() ? { host: { kind: "desktop", ...(hostAppVersion() ? { appVersion: hostAppVersion() } : {}) } } : {}),
         });
         // Index statuses produced while disconnected (or before this socket).
         for (const ev of vaultService.latestStatuses())

package/dist/hostChannel.d.ts

@@ -83,9 +83,12 @@ export type RunnerToHostMessage = {
 /** Mirror of the contract's HostToRunnerMessage (computer messages kept loose). */
 export type HostToRunnerMessage = {
     type: "stop";
-} | {
+}
+/** `appVersion`: the desktop app's own version (additive; reported in runner:hello's `host` block). */
+ | {
     type: "start";
     token: string;
+    appVersion?: string;
 }
 /** Additive: rescan model providers now and publish the list through runner:models. */
  | {
@@ -114,6 +117,9 @@ export declare function redactReason(s: string): string;
 export declare function hostStatus(state: HostedRunnerState, lastError?: string, code?: HostedStatusCode): void;
 /** Background setup progress for the desktop app. No-op outside the app. */
 export declare function hostProgress(state: "running" | "done" | "failed", step?: string, waiting?: boolean): void;
+/** The desktop app's own version, as its start message said; null outside the
+ *  app and with an app older than the field. */
+export declare function hostAppVersion(): string | null;
 /**
  * Wait for the token from the desktop app. Resolves with the token, or rejects
  * when nothing valid arrives within `timeoutMs`.

package/dist/hostChannel.js

@@ -88,6 +88,12 @@ export function hostProgress(state, step, waiting) {
         ...(waiting ? { waiting: true } : {}),
     });
 }
+let _hostAppVersion = null;
+/** The desktop app's own version, as its start message said; null outside the
+ *  app and with an app older than the field. */
+export function hostAppVersion() {
+    return _hostAppVersion;
+}
 /**
  * Wait for the token from the desktop app. Resolves with the token, or rejects
  * when nothing valid arrives within `timeoutMs`.
@@ -102,6 +108,8 @@ export function waitForHostToken(timeoutMs = 30_000) {
             const token = msg.token;
             if (typeof token !== "string" || !token.startsWith("mel_run_"))
                 return;
+            const appVersion = msg.appVersion;
+            _hostAppVersion = typeof appVersion === "string" && /^[0-9A-Za-z.+-]{1,32}$/.test(appVersion) ? appVersion : null;
             clearTimeout(timer);
             off();
             resolve(token);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melaya/runner",
-  "version": "1.1.71",
+  "version": "1.1.73",
   "description": "Run Melaya AI pipelines locally with your own LM Studio or Ollama models",
   "license": "Apache-2.0",
   "author": "Melaya Labs LLC",