@denisixnpm/agent-rdp 0.7.12 → 0.7.13

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.7.13](https://github.com/denisix/agent-rdp/compare/agent-rdp-v0.7.12...agent-rdp-v0.7.13) (2026-09-02)
+
+
+### Bug Fixes
+
+* stop the daemon dying 90s after spawn, plus run/file-pull fixes from the 0.7.11 field report ([c98b42f](https://github.com/denisix/agent-rdp/commit/c98b42fad3807d6c431884783cd849a036512ddb))
+
 ## [0.7.12](https://github.com/denisix/agent-rdp/compare/agent-rdp-v0.7.11...agent-rdp-v0.7.12) (2026-09-02)
 
 

package/README.md

@@ -212,12 +212,19 @@ corrupted transfer fails loudly instead of leaving a plausible-looking file.
 ```bash
 agent-rdp file push ./report.xlsx "C:\\Users\\Admin\\report.xlsx"
 agent-rdp file pull "C:\\Users\\Admin\\export.csv" ./export.csv
+agent-rdp file pull "C:\\out\\result.json" ./result.json --max-age 120   # stale_file if older
 ```
 
 Transfers are byte-exact, which also makes this the reliable way to place a
 script with non-ASCII content on the remote — writing one through the clipboard
 or `Add-Content` re-encodes it and mangles anything outside ASCII. Limit: 128MB.
 
+`pull` reports the remote file's last-write time (`Modified: … (Ns ago by the
+remote clock)`; `modified`/`modified_unix`/`age_secs` in JSON), so a result
+file can be told from yesterday's without reading it; `--max-age <secs>`
+refuses a stale one outright. The age is computed from the remote machine's
+own clock, so it is right even when the two hosts disagree on the time.
+
 ### Locate (OCR)
 
 Finds text on screen with [ocrs](https://github.com/robertknight/ocrs). Use it
@@ -344,25 +351,48 @@ retry that reuses the key — after `indeterminate`, an IPC timeout or
 per agent process (last 64 results) and empty after a reconnect, so after
 `connect` verify the side effect instead of retrying blindly.
 
-**`run` exit codes mean something.** The child runs with
-`$ErrorActionPreference='Stop'`, so a cmdlet that fails non-terminatingly —
-`Add-Content` to a locked file, `Set-Content` to a bad path — exits 1 with the
-error on stderr instead of reporting success for a write that never happened.
-A script that wants continue-on-error sets `$ErrorActionPreference='Continue'`
-on its first line. Do not redirect `*>` into a file the script itself writes:
-the child holds it open and the script's own writes fail with "being used by
-another process" — `run --wait` captures output without a file, and
-`run --stream` + `run-poll` covers long jobs.
+**`run` exit codes mean something, and errors arrive as text.** The child
+runs with `$ErrorActionPreference='Stop'` inside a `try/catch` the agent adds:
+a cmdlet that fails non-terminatingly — `Add-Content` to a locked file,
+`Set-Content` to a bad path — exits 1, and stderr carries the whole exception
+chain as plain text (`ERROR: <type>: <message>`, then `caused by …` for each
+inner exception, the failing line, and the script stack trace). The inner
+exceptions are where a COM error's real message lives — a 1C failure that
+used to surface as a bare `NullReferenceException` now shows the COM text
+under it. Native commands keep their own exit code. Scripts that start with
+`param(...)` or `using` get the prelude but no wrapper (those must be a
+script's first statements). A script that wants continue-on-error sets
+`$ErrorActionPreference='Continue'` on its first line; note that with `Stop`,
+a native command's stderr merged via `2>&1` is an error. Do not redirect `*>`
+into a file the script itself writes: the child holds it open and the script's
+own writes fail with "being used by another process" — `run --wait` captures
+output without a file.
+
+**Detached launches report an immediate death.** `run` without `--wait`
+returns the pid; if the process has already exited ~250ms later the reply
+also carries `early_exit: true` and its `exit_code` — the "it said it started
+but nothing happened" case made visible at launch time.
+
+**Do not `Stop-Process -Name powershell` from a script.** The automation agent
+is a `powershell.exe` process, and so are `run --stream` children; that kills
+them all (`automate restart` brings the agent back, streamed pids are gone).
+Children see the agent's pid as `$env:AGENT_RDP_AGENT_PID`:
+`Get-Process powershell | Where-Object { $_.Id -notin $PID, [int]$env:AGENT_RDP_AGENT_PID } | Stop-Process`.
 
 **Long-running commands** get the time they ask for: the transport deadline,
 the CLI socket timeout and the watchdog all extend to cover
 `--process-timeout`/`--timeout`. But the agent handles one command at a time,
 so a long `run --wait` blocks every other `automate` call — past about a
-minute, prefer `run --stream` plus `run-poll`. Streamed output is captured to
-files on the remote side, so nothing is lost if the process exits between
-polls; a finished process stays pollable for 10 minutes and repeat polls return
-`exited: true` with empty chunks. (If you redirect inside the command instead,
-note that Windows PowerShell 5.1's `>` writes UTF-16LE.)
+minute, prefer `run --stream` plus `run-poll` — that is the detached mode:
+`run-poll <pid> --follow [--follow-timeout <ms>]` keeps polling until the
+process exits, printing output as it arrives and the exit code at the end, so
+one command collects everything (a single plain poll before the child has
+flushed prints nothing, which looks like lost output). Streamed output is
+captured to files on the remote side, so nothing is lost if the process exits
+between polls; a finished process stays pollable for 10 minutes and repeat
+polls return `exited: true` with empty chunks. `--wait --stream` waits (the
+stream flag is ignored, with a note). (If you redirect inside the command
+instead, note that Windows PowerShell 5.1's `>` writes UTF-16LE.)
 
 **`daemon_not_running` vs `daemon_unresponsive`.** The first means no daemon
 process exists — reconnect, and `<session>/daemon.log` says why it exited. The

package/dist/generated/ErrorCode.d.ts

@@ -1,5 +1,5 @@
 /**
  * Error codes for structured error handling.
  */
-export type ErrorCode = "not_connected" | "already_connected" | "connection_failed" | "authentication_failed" | "timeout" | "invalid_request" | "not_supported" | "internal_error" | "session_not_found" | "ipc_error" | "daemon_not_running" | "daemon_unresponsive" | "daemon_version_mismatch" | "clipboard_error" | "drive_error" | "automation_not_enabled" | "automation_error" | "automation_indeterminate" | "element_not_found" | "stale_ref" | "command_failed";
+export type ErrorCode = "not_connected" | "already_connected" | "connection_failed" | "authentication_failed" | "timeout" | "invalid_request" | "not_supported" | "internal_error" | "session_not_found" | "ipc_error" | "daemon_not_running" | "daemon_unresponsive" | "daemon_version_mismatch" | "stale_file" | "clipboard_error" | "drive_error" | "automation_not_enabled" | "automation_error" | "automation_indeterminate" | "element_not_found" | "stale_ref" | "command_failed";
 //# sourceMappingURL=ErrorCode.d.ts.map

package/dist/generated/ErrorCode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorCode.d.ts","sourceRoot":"","sources":["../../src/generated/ErrorCode.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,uBAAuB,GAAG,SAAS,GAAG,iBAAiB,GAAG,eAAe,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,WAAW,GAAG,oBAAoB,GAAG,qBAAqB,GAAG,yBAAyB,GAAG,iBAAiB,GAAG,aAAa,GAAG,wBAAwB,GAAG,kBAAkB,GAAG,0BAA0B,GAAG,mBAAmB,GAAG,WAAW,GAAG,gBAAgB,CAAC"}
+{"version":3,"file":"ErrorCode.d.ts","sourceRoot":"","sources":["../../src/generated/ErrorCode.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,uBAAuB,GAAG,SAAS,GAAG,iBAAiB,GAAG,eAAe,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,WAAW,GAAG,oBAAoB,GAAG,qBAAqB,GAAG,yBAAyB,GAAG,YAAY,GAAG,iBAAiB,GAAG,aAAa,GAAG,wBAAwB,GAAG,kBAAkB,GAAG,0BAA0B,GAAG,mBAAmB,GAAG,WAAW,GAAG,gBAAgB,CAAC"}

package/dist/generated/FilePullRequest.d.ts

@@ -10,5 +10,11 @@ export type FilePullRequest = {
      * Destination path on this machine.
      */
     local_path: string;
+    /**
+     * Refuse (with `stale_file`) if the remote file was last written more
+     * than this many seconds ago, by the remote machine's clock. Nothing is
+     * transferred in that case.
+     */
+    max_age_secs?: number;
 };
 //# sourceMappingURL=FilePullRequest.d.ts.map

package/dist/generated/FilePullRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilePullRequest.d.ts","sourceRoot":"","sources":["../../src/generated/FilePullRequest.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CAAE,CAAC"}
+{"version":3,"file":"FilePullRequest.d.ts","sourceRoot":"","sources":["../../src/generated/FilePullRequest.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist/generated/FileTransferResult.d.ts

@@ -18,5 +18,20 @@ export type FileTransferResult = {
      * Number of chunks the transfer was split into.
      */
     chunks: number;
+    /**
+     * Pull only: the remote file's last-write time (RFC 3339, UTC).
+     */
+    modified?: string;
+    /**
+     * Pull only: the same as Unix seconds.
+     */
+    modified_unix?: number;
+    /**
+     * Pull only: seconds between the remote file's last write and the
+     * remote machine's clock at stat time - the freshness signal that tells
+     * a just-written result from yesterday's, without depending on the two
+     * machines' clocks agreeing.
+     */
+    age_secs?: number;
 };
 //# sourceMappingURL=FileTransferResult.d.ts.map

package/dist/generated/FileTransferResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileTransferResult.d.ts","sourceRoot":"","sources":["../../src/generated/FileTransferResult.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAAE,CAAC"}
+{"version":3,"file":"FileTransferResult.d.ts","sourceRoot":"","sources":["../../src/generated/FileTransferResult.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist/generated/RunResult.d.ts

@@ -24,5 +24,12 @@ export type RunResult = {
      * again.
      */
     replayed: boolean;
+    /**
+     * Detached launch only (`wait: false`): the process had already exited
+     * when the agent checked ~250ms after starting it, and `exit_code`
+     * carries its status. A script that fails before its first real
+     * statement is otherwise indistinguishable from one that is running.
+     */
+    early_exit: boolean;
 };
 //# sourceMappingURL=RunResult.d.ts.map

package/dist/generated/RunResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RunResult.d.ts","sourceRoot":"","sources":["../../src/generated/RunResult.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;CAAE,CAAC"}
+{"version":3,"file":"RunResult.d.ts","sourceRoot":"","sources":["../../src/generated/RunResult.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,UAAU,EAAE,OAAO,CAAC;CAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@denisixnpm/agent-rdp",
-  "version": "0.7.12",
+  "version": "0.7.13",
   "description": "CLI tool for AI agents to control Windows Remote Desktop sessions",
   "repository": {
     "type": "git",
@@ -48,11 +48,11 @@
   },
   "homepage": "https://github.com/denisix/agent-rdp#readme",
   "optionalDependencies": {
-    "@denisixnpm/agent-rdp-darwin-arm64": "^0.7.12",
-    "@denisixnpm/agent-rdp-darwin-x64": "^0.7.12",
-    "@denisixnpm/agent-rdp-linux-x64": "^0.7.12",
-    "@denisixnpm/agent-rdp-linux-arm64": "^0.7.12",
-    "@denisixnpm/agent-rdp-win32-x64": "^0.7.12",
-    "@denisixnpm/agent-rdp-win32-arm64": "^0.7.12"
+    "@denisixnpm/agent-rdp-darwin-arm64": "^0.7.13",
+    "@denisixnpm/agent-rdp-darwin-x64": "^0.7.13",
+    "@denisixnpm/agent-rdp-linux-x64": "^0.7.13",
+    "@denisixnpm/agent-rdp-linux-arm64": "^0.7.13",
+    "@denisixnpm/agent-rdp-win32-x64": "^0.7.13",
+    "@denisixnpm/agent-rdp-win32-arm64": "^0.7.13"
   }
 }