pi-web-ui 0.9.1 → 0.9.2

package/deploy/com.xingshuyin.pi-web-ui.plist

@@ -1,48 +1,48 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<!--
-  pi-web-ui launchd agent — macOS auto-start at login.
-
-  Install:
-    npm i -g pi-web-ui
-    cp deploy/com.xingshuyin.pi-web-ui.plist ~/Library/LaunchAgents/
-    # edit ProgramArguments / WorkingDirectory / PI_WEB_CWD for your setup
-    launchctl load ~/Library/LaunchAgents/com.xingshuyin.pi-web-ui.plist
-    # (or: launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.xingshuyin.pi-web-ui.plist)
-
-  Find the pi-web-ui binary path with: which pi-web-ui
--->
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>com.xingshuyin.pi-web-ui</string>
-
-  <key>ProgramArguments</key>
-  <array>
-    <string>/usr/local/bin/pi-web-ui</string>
-  </array>
-
-  <key>RunAtLoad</key>
-  <true/>
-
-  <!-- Restart if it crashes -->
-  <key>KeepAlive</key>
-  <true/>
-
-  <key>WorkingDirectory</key>
-  <string>/Users/YOUR_USER</string>
-
-  <key>EnvironmentVariables</key>
-  <dict>
-    <key>PORT</key>
-    <string>8787</string>
-    <key>PI_WEB_CWD</key>
-    <string>/Users/YOUR_USER</string>
-  </dict>
-
-  <key>StandardOutPath</key>
-  <string>/tmp/pi-web-ui.log</string>
-  <key>StandardErrorPath</key>
-  <string>/tmp/pi-web-ui.err</string>
-</dict>
-</plist>
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<!--
+  pi-web-ui launchd agent — macOS auto-start at login.
+
+  Install:
+    npm i -g pi-web-ui
+    cp deploy/com.xingshuyin.pi-web-ui.plist ~/Library/LaunchAgents/
+    # edit ProgramArguments / WorkingDirectory / PI_WEB_CWD for your setup
+    launchctl load ~/Library/LaunchAgents/com.xingshuyin.pi-web-ui.plist
+    # (or: launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.xingshuyin.pi-web-ui.plist)
+
+  Find the pi-web-ui binary path with: which pi-web-ui
+-->
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.xingshuyin.pi-web-ui</string>
+
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/local/bin/pi-web-ui</string>
+  </array>
+
+  <key>RunAtLoad</key>
+  <true/>
+
+  <!-- Restart if it crashes -->
+  <key>KeepAlive</key>
+  <true/>
+
+  <key>WorkingDirectory</key>
+  <string>/Users/YOUR_USER</string>
+
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PORT</key>
+    <string>8787</string>
+    <key>PI_WEB_CWD</key>
+    <string>/Users/YOUR_USER</string>
+  </dict>
+
+  <key>StandardOutPath</key>
+  <string>/tmp/pi-web-ui.log</string>
+  <key>StandardErrorPath</key>
+  <string>/tmp/pi-web-ui.err</string>
+</dict>
+</plist>

package/deploy/pi-web-ui-task.xml

@@ -1,71 +1,71 @@
-<?xml version="1.0" encoding="UTF-16"?>
-<!--
-  pi-web-ui Task Scheduler task — Windows auto-start at logon.
-
-  The easy way (no admin needed, generates everything for you):
-    npm i -g pi-web-ui
-    pi-web-ui server install --port 8787 --cwd C:\path\to\project
-    pi-web-ui server status | restart | stop | uninstall
-
-  Manual install with this template (edit the paths below first):
-    schtasks /Create /TN "pi-web-ui" /XML pi-web-ui-task.xml /F
-    schtasks /Run /TN "pi-web-ui"
-
-  Notes:
-    - The task runs the PowerShell launcher the CLI generates at
-      %APPDATA%\pi-web-ui\pi-web-ui.ps1 with -WindowStyle Hidden, so the
-      server runs with no black console window (nothing to accidentally
-      close/kill). The ps1 sets PORT/PI_WEB_CWD, cd's to the workspace,
-      launches node, and appends output to %USERPROFILE%\pi-web-ui.log.
-      Preview both generated files with: pi-web-ui server install --print
-    - Save this file as UTF-16 LE (schtasks requires it; the CLI does this
-      automatically when it writes the task XML).
-    - LogonTrigger = starts when you log in, same as a launchd user agent.
-      For boot-start without login, use Docker instead (see README).
--->
-<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
-  <RegistrationInfo>
-    <Description>pi-web-ui — web chat for the pi coding agent (auto-start at logon)</Description>
-  </RegistrationInfo>
-  <Triggers>
-    <LogonTrigger>
-      <Enabled>true</Enabled>
-    </LogonTrigger>
-  </Triggers>
-  <Principals>
-    <Principal id="Author">
-      <LogonType>InteractiveToken</LogonType>
-      <RunLevel>LeastPrivilege</RunLevel>
-    </Principal>
-  </Principals>
-  <Settings>
-    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
-    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
-    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
-    <AllowHardTerminate>true</AllowHardTerminate>
-    <StartWhenAvailable>false</StartWhenAvailable>
-    <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>
-    <IdleSettings>
-      <StopOnIdleEnd>false</StopOnIdleEnd>
-      <RestartOnIdle>false</RestartOnIdle>
-    </IdleSettings>
-    <AllowStartOnDemand>true</AllowStartOnDemand>
-    <Enabled>true</Enabled>
-    <Hidden>false</Hidden>
-    <RunOnlyIfIdle>false</RunOnlyIfIdle>
-    <WakeToRun>false</WakeToRun>
-    <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>
-    <Priority>7</Priority>
-    <RestartOnFailure>
-      <Interval>PT1M</Interval>
-      <Count>3</Count>
-    </RestartOnFailure>
-  </Settings>
-  <Actions Context="Author">
-    <Exec>
-      <Command>C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe</Command>
-      <Arguments>-NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File "%APPDATA%\pi-web-ui\pi-web-ui.ps1"</Arguments>
-      <WorkingDirectory>%USERPROFILE%</WorkingDirectory>
-    </Exec>
-  </Actions>
-</Task>
+<?xml version="1.0" encoding="UTF-16"?>
+<!--
+  pi-web-ui Task Scheduler task — Windows auto-start at logon.
+
+  The easy way (no admin needed, generates everything for you):
+    npm i -g pi-web-ui
+    pi-web-ui server install --port 8787 --cwd C:\path\to\project
+    pi-web-ui server status | restart | stop | uninstall
+
+  Manual install with this template (edit the paths below first):
+    schtasks /Create /TN "pi-web-ui" /XML pi-web-ui-task.xml /F
+    schtasks /Run /TN "pi-web-ui"
+
+  Notes:
+    - The task runs the PowerShell launcher the CLI generates at
+      %APPDATA%\pi-web-ui\pi-web-ui.ps1 with -WindowStyle Hidden, so the
+      server runs with no black console window (nothing to accidentally
+      close/kill). The ps1 sets PORT/PI_WEB_CWD, cd's to the workspace,
+      launches node, and appends output to %USERPROFILE%\pi-web-ui.log.
+      Preview both generated files with: pi-web-ui server install --print
+    - Save this file as UTF-16 LE (schtasks requires it; the CLI does this
+      automatically when it writes the task XML).
+    - LogonTrigger = starts when you log in, same as a launchd user agent.
+      For boot-start without login, use Docker instead (see README).
+-->
+<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
+  <RegistrationInfo>
+    <Description>pi-web-ui — web chat for the pi coding agent (auto-start at logon)</Description>
+  </RegistrationInfo>
+  <Triggers>
+    <LogonTrigger>
+      <Enabled>true</Enabled>
+    </LogonTrigger>
+  </Triggers>
+  <Principals>
+    <Principal id="Author">
+      <LogonType>InteractiveToken</LogonType>
+      <RunLevel>LeastPrivilege</RunLevel>
+    </Principal>
+  </Principals>
+  <Settings>
+    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
+    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
+    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
+    <AllowHardTerminate>true</AllowHardTerminate>
+    <StartWhenAvailable>false</StartWhenAvailable>
+    <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>
+    <IdleSettings>
+      <StopOnIdleEnd>false</StopOnIdleEnd>
+      <RestartOnIdle>false</RestartOnIdle>
+    </IdleSettings>
+    <AllowStartOnDemand>true</AllowStartOnDemand>
+    <Enabled>true</Enabled>
+    <Hidden>false</Hidden>
+    <RunOnlyIfIdle>false</RunOnlyIfIdle>
+    <WakeToRun>false</WakeToRun>
+    <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>
+    <Priority>7</Priority>
+    <RestartOnFailure>
+      <Interval>PT1M</Interval>
+      <Count>3</Count>
+    </RestartOnFailure>
+  </Settings>
+  <Actions Context="Author">
+    <Exec>
+      <Command>C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe</Command>
+      <Arguments>-NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File "%APPDATA%\pi-web-ui\pi-web-ui.ps1"</Arguments>
+      <WorkingDirectory>%USERPROFILE%</WorkingDirectory>
+    </Exec>
+  </Actions>
+</Task>

package/deploy/pi-web-ui.service

@@ -1,31 +1,31 @@
-# pi-web-ui systemd unit — Linux auto-start on boot.
-#
-# Install (adjust User/WorkingDirectory/Environment to taste):
-#   sudo npm i -g pi-web-ui
-#   sudo cp deploy/pi-web-ui.service /etc/systemd/system/
-#   sudo systemctl daemon-reload
-#   sudo systemctl enable --now pi-web-ui
-#   sudo systemctl status pi-web-ui
-#
-# Logs: journalctl -u pi-web-ui -f
-
-[Unit]
-Description=pi-web-ui — web chat for the pi coding agent
-After=network.target
-
-[Service]
-Type=simple
-# Run as an unprivileged user (change to your user, e.g. yourname)
-User=YOUR_USER
-# The workspace the agent operates in (read/edit/bash/write)
-WorkingDirectory=/home/YOUR_USER
-Environment=PORT=8787
-# Point at your pi config dir if it's not the default ~/.pi/agent
-#Environment=PI_CODING_AGENT_DIR=/home/YOUR_USER/.pi/agent
-ExecStart=/usr/bin/pi-web-ui
-Restart=on-failure
-RestartSec=5
-# npm global bin may live elsewhere (nvm, etc.) — find with: which pi-web-ui
-
-[Install]
-WantedBy=multi-user.target
+# pi-web-ui systemd unit — Linux auto-start on boot.
+#
+# Install (adjust User/WorkingDirectory/Environment to taste):
+#   sudo npm i -g pi-web-ui
+#   sudo cp deploy/pi-web-ui.service /etc/systemd/system/
+#   sudo systemctl daemon-reload
+#   sudo systemctl enable --now pi-web-ui
+#   sudo systemctl status pi-web-ui
+#
+# Logs: journalctl -u pi-web-ui -f
+
+[Unit]
+Description=pi-web-ui — web chat for the pi coding agent
+After=network.target
+
+[Service]
+Type=simple
+# Run as an unprivileged user (change to your user, e.g. yourname)
+User=YOUR_USER
+# The workspace the agent operates in (read/edit/bash/write)
+WorkingDirectory=/home/YOUR_USER
+Environment=PORT=8787
+# Point at your pi config dir if it's not the default ~/.pi/agent
+#Environment=PI_CODING_AGENT_DIR=/home/YOUR_USER/.pi/agent
+ExecStart=/usr/bin/pi-web-ui
+Restart=on-failure
+RestartSec=5
+# npm global bin may live elsewhere (nvm, etc.) — find with: which pi-web-ui
+
+[Install]
+WantedBy=multi-user.target

package/dist/server/agent-service.js

@@ -617,7 +617,8 @@ class ClientStateStore {
         this.save();
     }
 }
-/** Cap on simultaneously open conversations (each keeps a full runtime alive). */
+/** Cap on simultaneously open conversations of ONE project (each keeps a full
+ *  runtime alive; conversations of other projects keep their own lists). */
 const MAX_OPEN_CONVERSATIONS = 8;
 const DEFAULT_CONV_TITLE = "新对话";
 /** First user text in a session, truncated for the conversation list. */
@@ -769,6 +770,11 @@ export class ClientSession {
             session: runtime.session,
             cwd: runtime.cwd,
             createdAt: Date.now(),
+            // A brand-new conversation is not yet in the running list — it enters
+            // only when it is displaced to the background while still streaming.
+            listed: false,
+            promptedSinceActive: false,
+            lastActiveAt: Date.now(),
             msgIds: new Map(),
             nextMsgId: 1,
             uiMessageCache: new Map(),
@@ -792,8 +798,9 @@ export class ClientSession {
         const statuses = this.webUi.statusSnapshot();
         if (statuses.length > 0)
             send({ type: "statuses", statuses });
-        // Reconnect: push the open-conversation list so the left panel shows
-        // every chat (a fresh socket never got the newChat/switch pushes).
+        // Reconnect: push the current project's running-conversation list so the
+        // left panel shows every background chat (a fresh socket never got the
+        // newChat/switch pushes).
         this.emitConversations();
     }
     detachSink(send) {
@@ -1574,6 +1581,11 @@ export class ClientSession {
             conv.title = trimmed.length > 30 ? `${trimmed.slice(0, 30)}…` : trimmed;
             this.emitConversations();
         }
+        // The active conversation has been continued since it was opened — it
+        // must not be dismissed when the user switches away. (Also bumps the
+        // per-project "most recently active" order used by set_cwd.)
+        conv.promptedSinceActive = true;
+        conv.lastActiveAt = Date.now();
         this.flushSnapshot();
     }
     /**
@@ -1865,7 +1877,9 @@ export class ClientSession {
     async newChat() {
         // Reuse an already-open blank conversation instead of piling up new ones
         // on every click: if the active chat has no messages it IS the new chat
-        // (focus already on it); otherwise switch to the first blank one.
+        // (focus already on it); otherwise switch to the first blank one (under
+        // the per-project running-list model displaced blanks are disposed, so
+        // this branch normally can't exist — kept as a safety net).
         const isBlank = (c) => {
             try {
                 return c.session.getSessionStats().totalMessages === 0;
@@ -1889,14 +1903,21 @@ export class ClientSession {
                 return;
             }
         }
-        if (this.convs.size >= MAX_OPEN_CONVERSATIONS) {
+        // Cap is per project — conversations of other projects keep their own
+        // lists and don't consume this project's slots.
+        const openInProject = [...this.convs.values()].filter((c) => c.cwd === this.cwd).length;
+        if (openInProject >= MAX_OPEN_CONVERSATIONS) {
             this.emit({
                 type: "notice",
                 level: "warning",
-                text: `打开的对话已达上限（${MAX_OPEN_CONVERSATIONS} 个），请先切换或重载页面关闭`,
+                text: `当前项目运行的对话已达上限（${MAX_OPEN_CONVERSATIONS} 个），请先打开某个对话并离开（不继续对话）以移出列表`,
             });
             return;
         }
+        // The outgoing conversation is left behind — apply the running-list
+        // lifecycle. Removal is deferred until the new chat exists so the active
+        // conversation stays valid during the (async) runtime creation.
+        const displaced = this.displaceActive();
         try {
             const runtime = await createAgentSessionRuntime(this.makeRuntimeFactory(), {
                 cwd: this.cwd,
@@ -1906,6 +1927,8 @@ export class ClientSession {
             const conv = this.makeConversation(runtime);
             this.convs.set(conv.id, conv);
             this.activeId = conv.id;
+            if (displaced)
+                this.removeConversation(displaced.id);
             await this.bindSession();
             this.emitConversations();
         }
@@ -1918,35 +1941,63 @@ export class ClientSession {
         }
         this.flushSnapshot();
     }
+    /**
+     * The active conversation is being left (new_chat / switch_conversation /
+     * set_cwd). Runs the running-list lifecycle:
+     *
+     * - still streaming → it becomes a background run: ensure it is listed;
+     * - idle + listed + continued → keep it (the user did continue it);
+     * - idle + listed + opened-but-not-continued, or never listed at all → the
+     *   caller must drop it (returns it so removal happens only after the
+     *   active conversation has been switched away).
+     */
+    displaceActive() {
+        const conv = this.conv;
+        if (conv.session.isStreaming) {
+            conv.listed = true;
+            return null;
+        }
+        if (conv.listed && conv.promptedSinceActive)
+            return null;
+        return conv;
+    }
+    /** Remove a conversation from the running list and free its runtime. The
+     *  session stays persisted on disk, so it remains recoverable from the
+     *  history list. Never removes the active conversation. */
+    removeConversation(id) {
+        const conv = this.convs.get(id);
+        if (!conv || id === this.activeId)
+            return;
+        this.convs.delete(id);
+        conv.unsubscribe?.();
+        conv.unsubscribe = undefined;
+        void conv.runtime.dispose().catch(() => { });
+    }
     /** Switch the ACTIVE conversation without interrupting any other chat. */
     async switchConversation(id) {
         if (!this.convs.has(id) || id === this.activeId)
             return;
-        const prevCwd = this.cwd;
+        const displaced = this.displaceActive();
         this.activeId = id;
         this.cwd = this.conv.cwd;
-        // Cross-directory jump: make the workspace switch explicit so the user
-        // isn't surprised when the file tree / footer / history all change.
-        if (this.cwd !== prevCwd) {
-            this.emit({
-                type: "notice",
-                level: "info",
-                text: `已切换到工作目录：${this.cwd}`,
-            });
-        }
+        // All listed conversations share the current project's cwd, so this is
+        // normally a no-op — kept defensive for stale clients.
+        if (displaced)
+            this.removeConversation(displaced.id);
+        this.conv.promptedSinceActive = false;
+        this.conv.lastActiveAt = Date.now();
         this.webUi.refresh();
         this.emitConversations();
-        // Workspace-bound panels (session list / file tree / commands) follow
-        // the active conversation's cwd.
-        void this.refreshSessions();
-        void this.listFiles(undefined);
-        void this.listCommands();
         this.flushSnapshot();
     }
-    /** Push the open-conversation list to the client. */
+    /** Push the current project's running-conversation list to the client. */
     emitConversations() {
         const conversations = [];
         for (const conv of this.convs.values()) {
+            // The running-conversation list is per project and only contains
+            // conversations that were displaced to the background while running.
+            if (conv.cwd !== this.cwd || !conv.listed)
+                continue;
             let messageCount = 0;
             let isStreaming = false;
             try {
@@ -2030,6 +2081,9 @@ export class ClientSession {
             this.conv.cwd = this.runtime.cwd;
             this.cwd = this.runtime.cwd;
             this.conv.title = conversationTitle(this.runtime.session);
+            // Deliberately resumed — must not be dismissed when the user later
+            // switches away without sending a new message.
+            this.conv.promptedSinceActive = true;
             this.emitConversations();
         }
         catch (err) {
@@ -2371,9 +2425,12 @@ export class ClientSession {
         }
     }
     /**
-     * Switch the agent's working directory by rebuilding the runtime for the new
-     * cwd (services are cwd-bound). Resumes that directory's most recent session;
-     * refreshes snapshot, session list, and file tree.
+     * Switch the agent's working directory by switching the ACTIVE conversation
+     * to the target project's own most recently active conversation (creating a
+     * fresh one that resumes that project's most recent session on first
+     * visit). Conversations of other projects keep running untouched in their
+     * own per-project lists — nothing is rebuilt, so titles/cwds never leak
+     * between projects.
      */
     async setCwd(newCwd) {
         try {
@@ -2393,40 +2450,57 @@ export class ClientSession {
                 this.flushSnapshot();
                 return;
             }
-            // Build the new runtime first — only swap the ACTIVE conversation on
-            // success (other open conversations keep their own cwd + runtime).
-            const newRuntime = await createAgentSessionRuntime(this.makeRuntimeFactory(), {
-                cwd: abs,
-                agentDir: this.agentDir,
-                sessionManager: SessionManager.continueRecent(abs, this.sessionDir),
-            });
-            const conv = this.conv;
-            const oldRuntime = conv.runtime;
-            conv.runtime = newRuntime;
-            conv.session = newRuntime.session;
-            conv.cwd = abs;
-            // The rebuilt runtime resumed the new project's most recent session —
-            // refresh the title too, or the conversation list shows the old name.
-            conv.title = conversationTitle(newRuntime.session);
+            // The outgoing conversation is left behind — apply the running-list
+            // lifecycle (removal is deferred until the active conversation is
+            // safely switched away).
+            const displaced = this.displaceActive();
+            // Prefer the target project's own most recently active conversation;
+            // only create a fresh one (resuming its most recent session) when the
+            // project has none open yet.
+            let target;
+            for (const c of this.convs.values()) {
+                if (c.cwd === abs &&
+                    (!target || c.lastActiveAt > target.lastActiveAt)) {
+                    target = c;
+                }
+            }
+            if (target) {
+                this.activeId = target.id;
+                if (displaced)
+                    this.removeConversation(displaced.id);
+            }
+            else {
+                // First visit to this project: resume its most recent session.
+                const newRuntime = await createAgentSessionRuntime(this.makeRuntimeFactory(), {
+                    cwd: abs,
+                    agentDir: this.agentDir,
+                    sessionManager: SessionManager.continueRecent(abs, this.sessionDir),
+                });
+                const conv = this.makeConversation(newRuntime);
+                this.convs.set(conv.id, conv);
+                this.activeId = conv.id;
+                if (displaced)
+                    this.removeConversation(displaced.id);
+                for (const d of newRuntime.diagnostics) {
+                    if (d.type !== "info") {
+                        this.emit({ type: "notice", level: d.type, text: d.message });
+                    }
+                }
+                await this.bindSession();
+            }
+            this.conv.promptedSinceActive = false;
+            this.conv.lastActiveAt = Date.now();
             this.cwd = abs;
             // Remember the new workspace (restore target + recent-project entry).
             this.stateStore.remember(this.clientId, abs);
             void this.pushProjects();
-            conv.unsubscribe?.();
-            conv.unsubscribe = undefined;
-            await this.bindSession();
-            await oldRuntime.dispose().catch(() => { });
-            for (const d of newRuntime.diagnostics) {
-                if (d.type !== "info") {
-                    this.emit({ type: "notice", level: d.type, text: d.message });
-                }
-            }
+            this.webUi.refresh();
+            this.emitConversations();
             this.emit({
                 type: "notice",
                 level: "info",
                 text: `已切换到工作目录：${abs}`,
             });
-            this.emitConversations();
             void this.refreshSessions();
             void this.listFiles(undefined);
             // Commands are per-project (.pi/commands.json in the current cwd).

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "pi-web-ui",
-  "version": "0.9.1",
+  "version": "0.9.2",
+  "version": "0.9.2",
   "description": "Web chat interface for the pi coding agent, powered by the pi SDK (@earendil-works/pi-coding-agent) — one-command run, Docker/systemd/launchd deployable",
   "license": "MIT",
   "type": "module",