pwragent 1.3.9 → 1.3.10

package/README.md

@@ -50,6 +50,19 @@ stop the daemon, install the selected version, and start it again. Do not remove
 the PwrAgent root, Codex home or workspace during updates. There is no automatic
 CLI updater or automatic systemd enablement.
 
+`pwragent --version` prints the installed package version. A published package
+also prints its release tag and source commit, for example
+`pwragent 1.3.8 (v1.3.8, commit 0123…)`. `pwragent version` prints the same
+fields as JSON. Neither needs a running daemon.
+
+`pwragent status` reports the daemon's version as `running`, read when that
+daemon started, and the package files as `installed`. `restartRequired` is
+`true` when they differ, so the update has not taken effect yet. A daemon
+started before version reporting has no `running` field and also reports
+`true`. Run `status` from the same installation as the daemon, such as the
+`/opt/pwragent` path in the systemd example; another installation compares its
+own files.
+
 ## systemd installation example
 
 On a Linux host with systemd, an administrator must first create the dedicated
@@ -91,7 +104,8 @@ sudo -u pwragent env PWRAGENT_HOME=/var/lib/pwragent PWRAGENT_PROFILE=outpost \
 For a service update, finish or interrupt active work, run
 `sudo systemctl stop pwragent-headless.service`, repeat the prefix installation
 with the chosen new version (or `pwragent@latest`), then run
-`sudo systemctl start pwragent-headless.service`. Compare the new example unit
+`sudo systemctl start pwragent-headless.service`. Run the `status` command above
+and check that `restartRequired` is `false`. Compare the new example unit
 with the installed one before deliberately updating it; npm does not overwrite
 `/etc/systemd/system`. Stopping during a turn can leave its outcome `unknown`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pwragent",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "private": false,
   "type": "module",
   "description": "Experimental headless PwrAgent daemon and command-line client.",
@@ -53,7 +53,7 @@
   "devDependencies": {
     "@pwragent/federation": "workspace:*",
     "@pwragent/shared": "workspace:*",
-    "esbuild": "0.28.1",
+    "esbuild": "0.28.2",
     "@pwragent/agent-tools": "workspace:*"
   },
   "dependencies": {
@@ -63,7 +63,7 @@
     "node-pty"
   ],
   "pwragentRelease": {
-    "tag": "v1.3.9",
-    "commit": "0fc28acd4318e55e172427b5a694c1a1dd096c15"
+    "tag": "v1.3.10",
+    "commit": "ff9b702144786e162b3e91c78d79791761944350"
   }
 }

package/src/cli.js

@@ -6,6 +6,7 @@ import { setTimeout as delay } from "node:timers/promises";
 import { call } from "./client.js";
 import { serve } from "./daemon.js";
 import { ACTIVE } from "./store.js";
+import { formatVersion, installedVersion, packageVersion, restartRequired } from "./version.js";
 
 const help = `PwrAgent Headless (experimental, Linux/macOS, Node >=22)
 
@@ -16,6 +17,7 @@ const help = `PwrAgent Headless (experimental, Linux/macOS, Node >=22)
   pwragent project-add|project-remove --path /workspace/project
   pwragent git-auth-configure --config-file /outpost/git-auth-settings.json
   pwragent status | list
+  pwragent --version | version
   pwragent submit --id JOB --prompt-file /task.txt [--sandbox read-only|workspace-write]
                   [--model MODEL] [--thread THREAD_ID] [--cwd /workspace/project]
   pwragent show|read|interrupt|wait --id JOB
@@ -36,6 +38,7 @@ No provisioning, login, queue, automatic replay, or local messaging providers.
 export async function main(args) {
   const { values, positionals } = parseArgs({ args, allowPositionals: true, strict: true, options: {
     help: { type: "boolean", short: "h" },
+    version: { type: "boolean" },
     profile: { type: "string" },
     workspace: { type: "string" },
     "codex-home": { type: "string" },
@@ -52,7 +55,9 @@ export async function main(args) {
     peer: { type: "string" },
     name: { type: "string" }, remote: { type: "string" }, path: { type: "string" }, cwd: { type: "string" }, "config-file": { type: "string" },
   } });
-  if (values.help || !positionals.length) { console.log(help); return 0; }
+  if (values.help) { console.log(help); return 0; }
+  if (values.version) { console.log(formatVersion(packageVersion())); return 0; }
+  if (!positionals.length) { console.log(help); return 0; }
   if (positionals.length !== 1) throw new Error("Expected one command; see --help");
   const command = positionals[0];
   const allowed = {
@@ -60,7 +65,7 @@ export async function main(args) {
     submit: ["id", "prompt-file", "thread", "model", "sandbox", "cwd"],
     "project-list": [], "project-create": ["name", "label"], "project-clone": ["name", "remote", "label"],
     "project-add": ["path", "label"], "project-remove": ["path"], "git-auth-configure": ["config-file"],
-    show: ["id"], read: ["id"], interrupt: ["id"], wait: ["id"], status: [], list: [],
+    show: ["id"], read: ["id"], interrupt: ["id"], wait: ["id"], status: [], list: [], version: [],
     "federation-join": ["invite-file", "gateway", "label"],
     "federation-invite": ["port", "label"],
     "federation-status": [], "federation-leave": [], "federation-revoke": ["peer"],
@@ -69,6 +74,7 @@ export async function main(args) {
   for (const option of Object.keys(values)) {
     if (option !== "profile" && !allowed[command].includes(option)) throw new Error(`--${option} does not apply to ${command}`);
   }
+  if (command === "version") { console.log(JSON.stringify(packageVersion())); return 0; }
   const profile = values.profile || process.env.PWRAGENT_PROFILE || "default";
   if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(profile)) throw new Error("Invalid profile name");
   const root = process.env.PWRAGENT_HOME || path.join(homedir(), ".pwragent");
@@ -118,6 +124,12 @@ export async function main(args) {
       await delay(1000);
     }
   }
+  if (command === "status") {
+    const status = await call(directory, "status", {});
+    const installed = installedVersion();
+    console.log(JSON.stringify({ ...status, installed, restartRequired: restartRequired(status.running, installed) }));
+    return 0;
+  }
   console.log(JSON.stringify(await call(directory, command, { id: values.id })));
   return 0;
 }

package/src/daemon.js

@@ -116,7 +116,7 @@ export async function serve({ directory, workspace, home, command, profile }) {
     });
     if (shutdown) { server.close(); return await done; }
     server.on("error", (error) => { void stop(error); });
-    console.log(JSON.stringify({ ready: true, socket: socketPath, pid: process.pid }));
+    console.log(JSON.stringify({ ready: true, socket: socketPath, pid: process.pid, running: runtime.running }));
     return await done;
   } catch (error) {
     await stop(error);

package/src/federation-backend.js

@@ -23,6 +23,11 @@ export function ownerMethodCapabilities(methods, contract = FEDERATION_BACKEND_M
 }
 export const METHOD_CAPABILITIES = ownerMethodCapabilities(OWNER_METHODS);
 
+// The placeholder title desktop gives a new thread. Viewers recognize this
+// exact text as "no name yet".
+export const PLACEHOLDER_THREAD_TITLE = "Untitled thread";
+const LEGACY_PLACEHOLDER_THREAD_TITLE = "New outpost thread";
+
 function mode(sandbox) { return sandbox === "workspace-write" ? "auto" : "default"; }
 function sandboxFor(params, fallback = "read-only") {
   if (params.executionMode && !["default", "auto", "full-access"].includes(params.executionMode)) throw new Error("Unsupported execution mode");
@@ -51,7 +56,9 @@ export class HeadlessBackend {
     try {
       const data = JSON.parse(readFileSync(this.file, "utf8"));
       if (data.version !== 1 || !Array.isArray(data.threads)) throw new Error("Invalid headless thread registry");
-      this.threads = new Map(data.threads.map((thread) => [thread.id, thread]));
+      this.threads = new Map(data.threads.map((thread) => [thread.id,
+        thread.titleSource === "fallback" && thread.title === LEGACY_PLACEHOLDER_THREAD_TITLE
+          ? { ...thread, title: PLACEHOLDER_THREAD_TITLE } : thread]));
     } catch (error) {
       if (error.code !== "ENOENT") throw error;
       this.threads = new Map();
@@ -219,13 +226,18 @@ export class HeadlessBackend {
         for (const key of ["seenAt", "seenUpdatedAt"]) {
           if (params[key] !== undefined && (!Number.isFinite(params[key]) || params[key] < 0)) throw new Error(`Invalid ${key}`);
         }
-        const seenUpdatedAt = params.seenUpdatedAt ?? this.summary(thread).updatedAt;
+        // An omitted watermark keeps the stored one (see MarkThreadSeenRequest).
+        // A thread never given one is pinned to the seenAt it was judged by,
+        // so recording a new seenAt cannot change its unread state.
+        thread.seenUpdatedAt = params.seenUpdatedAt ?? thread.seenUpdatedAt ?? thread.seenAt ?? 0;
         thread.seenAt = params.seenAt ?? Date.now();
-        thread.seenUpdatedAt = seenUpdatedAt;
         this.persist();
         this.forgetSeenAttentionMember(thread.id);
-        this.invalidate(thread.id);
-        return { backend: "codex", threadId: thread.id, seenAt: thread.seenAt, seenUpdatedAt };
+        this.publish({ backend: "codex", notification: { method: "navigation/thread/seen",
+          params: { threadId: thread.id, ...(params.seenUpdatedAt !== undefined ? { seenUpdatedAt: params.seenUpdatedAt } : {}) } } }, "transcript");
+        this.invalidate(thread.id, "navigation/thread/seen");
+        return { backend: "codex", threadId: thread.id, seenAt: thread.seenAt,
+          ...(params.seenUpdatedAt !== undefined ? { seenUpdatedAt: params.seenUpdatedAt } : {}) };
       }
       case "setThreadExecutionMode": {
         const thread = this.owned(params.threadId);
@@ -315,11 +327,11 @@ export class HeadlessBackend {
       const result = await this.runtime.codex.request("thread/start", { cwd, dynamicTools: this.runtime.messagingTools.buildDynamicToolSpecs(), approvalPolicy: "never", sandbox, ...(params.model ? { model: params.model } : {}), ephemeral: false });
       if (!result?.thread?.id || typeof result.thread.id !== "string" || result.thread.id.length > 256) throw new Error("Invalid thread/start response");
       this.runtime.loadedThreads.add(result.thread.id);
-      const thread = { id: result.thread.id, messagingFileTools: true, title: "New outpost thread", titleSource: "fallback", createdAt: Date.now(), cwd, sandbox,
+      const thread = { id: result.thread.id, messagingFileTools: true, title: PLACEHOLDER_THREAD_TITLE, titleSource: "fallback", createdAt: Date.now(), cwd, sandbox,
         model: params.model, reasoningEffort: params.reasoningEffort, serviceTier: params.serviceTier };
       this.threads.set(thread.id, thread);
       this.persist();
-      this.invalidate(thread.id);
+      this.invalidate(thread.id, "thread/started");
       return { backend: "codex", threadId: thread.id, executionMode: mode(sandbox) };
     } finally { this.creating = false; }
   }

package/src/runtime.js

@@ -3,12 +3,16 @@ import path from "node:path";
 import { readFileSync, readdirSync } from "node:fs";
 import { AgentToolRouter, buildPwrAgentMessagingToolDefinitions, readPwrAgentMessagingDynamicToolCall, resolveMessagingOutboundFile, validateMessagingFileMetadata, FILE_PUSH_MAX_BYTES } from "../dist/federation-core.js";
 import { Codex } from "./codex.js";
+import { installedVersion } from "./version.js";
 import { ACTIVE, atomicJson, digest, privateDirectory, validId } from "./store.js";
 
 export class Runtime {
   constructor({ store, workspace, home, command, onFailure }) {
     this.store = store;
     this.workspace = workspace;
+    // Snapshot at startup: upgrading the package files does not change the
+    // code this process is running.
+    this.running = installedVersion();
     this.projects = new OutpostProjects(path.dirname(store.directory), workspace);
     this.messagingTools = new AgentToolRouter(buildPwrAgentMessagingToolDefinitions((request) => this.messagingRequest(request), { nativeDynamicPdfImages: true }));
     this.fileAccess = { privateStorageRoots: [home, process.env.PWRAGENT_HOME].filter(Boolean),
@@ -41,7 +45,7 @@ export class Runtime {
   async handle(method, params = {}) {
     if (this.stopping) throw new Error("Daemon is stopping");
     switch (method) {
-      case "status": return { version: 1, ready: true, pid: process.pid, activeJob: this.active || null, workspace: this.workspace };
+      case "status": return { version: 1, ready: true, pid: process.pid, running: this.running, activeJob: this.active || null, workspace: this.workspace };
       case "project-list": return this.projects.list();
       case "project-create": case "project-clone": return this.projects.create(params);
       case "project-add": return this.projects.add(params);

package/src/version.js

@@ -0,0 +1,36 @@
+import { readFileSync } from "node:fs";
+
+// The release writes pwragentRelease: { tag, commit } into the published
+// manifest. A checkout has none, so only string fields are reported.
+export function versionInfo(pkg) {
+  const source = pkg.pwragentRelease;
+  const release = {};
+  if (typeof source?.tag === "string") release.tag = source.tag;
+  if (typeof source?.commit === "string") release.commit = source.commit;
+  return { name: pkg.name, version: pkg.version, ...(Object.keys(release).length ? { release } : {}) };
+}
+
+// Read on each call from this package's own manifest, so the CLI reports the
+// files currently installed. The daemon reads it once at startup instead.
+export function packageVersion() {
+  return versionInfo(JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")));
+}
+
+// The version fields that status compares, without the package name.
+export function installedVersion() {
+  const { name: _name, ...fields } = packageVersion();
+  return fields;
+}
+
+export function formatVersion({ name, version, release }) {
+  const details = [release?.tag, release?.commit && `commit ${release.commit}`].filter(Boolean);
+  return details.length ? `${name} ${version} (${details.join(", ")})` : `${name} ${version}`;
+}
+
+// A daemon that predates version reporting returns no running version. It is
+// older than this installation, so it needs a restart too.
+export function restartRequired(running, installed) {
+  return !running
+    || running.version !== installed.version
+    || running.release?.commit !== installed.release?.commit;
+}