@camerontaylor/paseo-cli 0.11.0-beta.3.fork.1 → 0.11.1-fork.1

package/dist/commands/agent/attach.js

@@ -4,6 +4,7 @@ export function addAttachOptions(cmd) {
         .argument("<id>", "Agent ID (or prefix)");
 }
 import { connectToDaemon } from "../../utils/client.js";
+import { waitForStop } from "../../utils/wait-for-stop.js";
 import { fetchProjectedTimelineItems, LIVE_HISTORY_FETCH_TIMEOUT_MS, } from "../../utils/timeline.js";
 /**
  * Format and print a timeline item to the terminal
@@ -123,29 +124,10 @@ export async function runAttachCommand(id, options, _command) {
         });
         await unsubscribe.ready;
         console.log(`Attached to agent ${resolvedId.substring(0, 7)}.`);
-        // Handle Ctrl+C to detach gracefully
-        let detached = false;
-        const detach = () => {
-            if (detached)
-                return;
-            detached = true;
-            console.log("\n\nDetaching from agent...");
-            unsubscribe();
-            client
-                .close()
-                .then(() => {
-                process.exit(0);
-            })
-                .catch(() => {
-                process.exit(1);
-            });
-        };
-        process.on("SIGINT", detach);
-        process.on("SIGTERM", detach);
-        // Keep the process alive
-        await new Promise(() => {
-            // Wait indefinitely until interrupted
-        });
+        await waitForStop();
+        console.log("\n\nDetaching from agent...");
+        unsubscribe();
+        await client.close();
     }
     catch (err) {
         await client.close().catch(() => { });

package/dist/commands/agent/delete.js

@@ -11,6 +11,19 @@ export const deleteSchema = {
     idField: (item) => item.agentIds.join("\n"),
     columns: [{ header: "DELETED", field: "deletedCount" }],
 };
+// History includes archived agents and agents whose provider is unavailable.
+async function fetchHistoryAgents(client) {
+    const agents = [];
+    let cursor;
+    do {
+        const payload = await client.fetchAgentHistory({
+            page: { limit: 200, ...(cursor ? { cursor } : {}) },
+        });
+        agents.push(...payload.entries.map((entry) => entry.agent));
+        cursor = payload.pageInfo.nextCursor ?? undefined;
+    } while (cursor);
+    return agents;
+}
 export async function runDeleteCommand(id, options, _command) {
     if (!id && !options.all && !options.cwd) {
         const error = {
@@ -22,20 +35,15 @@ export async function runDeleteCommand(id, options, _command) {
     }
     const client = await connectToDaemon({ target: options.daemonTarget });
     try {
-        const fetchPayload = await client.fetchAgents({ filter: { includeArchived: true } });
-        let agents = fetchPayload.entries.map((entry) => entry.agent);
         const deletedIds = [];
-        if (options.all) {
-            agents = agents.filter((a) => !a.archivedAt);
-        }
-        else if (options.cwd) {
-            agents = agents.filter((a) => {
-                if (a.archivedAt)
-                    return false;
-                return isSameOrDescendantPath(options.cwd, a.cwd);
-            });
+        let agents;
+        if (options.all || options.cwd) {
+            agents = await fetchHistoryAgents(client);
+            if (!options.all) {
+                agents = agents.filter((a) => isSameOrDescendantPath(options.cwd, a.cwd));
+            }
         }
-        else if (id) {
+        else {
             const fetchResult = await client.fetchAgent({ agentId: id });
             if (!fetchResult) {
                 const error = {

package/dist/commands/agent/logs.js

@@ -1,4 +1,5 @@
 import { connectToDaemon } from "../../utils/client.js";
+import { waitForStop } from "../../utils/wait-for-stop.js";
 import { fetchProjectedTimelineItems, LIVE_HISTORY_FETCH_TIMEOUT_MS, } from "../../utils/timeline.js";
 import { curateAgentActivity } from "@camerontaylor/paseo-server/agent-activity";
 export function addLogsOptions(cmd) {
@@ -166,15 +167,8 @@ async function runFollowMode(client, agentId, options) {
     });
     await unsubscribe.ready;
     console.log(`\n--- Following logs (${tailLabel}; Ctrl+C to stop) ---\n`);
-    // Wait for interrupt
-    await new Promise((resolve) => {
-        const cleanup = () => {
-            unsubscribe();
-            resolve();
-        };
-        process.on("SIGINT", cleanup);
-        process.on("SIGTERM", cleanup);
-    });
+    await waitForStop();
+    unsubscribe();
     await client.close();
 }
 //# sourceMappingURL=logs.js.map

package/dist/commands/daemon/restart.js

@@ -59,7 +59,8 @@ export async function runRestartCommand(options, _command) {
             try {
                 if (replacement.getLastServerInfoMessage()?.serverId !== serverId)
                     throw new Error("Connected peer identity changed");
-                const status = await replacement.getDaemonStatus({ timeout: Math.min(1000, remaining()) });
+                // Status probes every provider, so it can take seconds on a healthy worker.
+                const status = await replacement.getDaemonStatus({ timeout: remaining() });
                 if (status.pid !== workerPid) {
                     await checkSupervisor();
                     return {

package/dist/commands/plugin/index.js

@@ -1,7 +1,9 @@
+import path from "node:path";
+import { expandUserPath } from "../../classify.js";
 import { createInterface } from "node:readline/promises";
 import { reviewPluginUpdates } from "./update.js";
 import { Command } from "commander";
-import { formatPluginSourceReference, formatPluginIdentity, } from "@camerontaylor/paseo-protocol/plugin-source-reference";
+import { formatPluginSourceReference, parsePluginSourceReference, formatPluginIdentity, } from "@camerontaylor/paseo-protocol/plugin-source-reference";
 import { withOutput } from "../../output/index.js";
 import { addJsonAndDaemonHostOptions, addJsonOption } from "../../utils/command-options.js";
 import { scaffoldPluginDirectory } from "./scaffold.js";
@@ -73,7 +75,17 @@ export async function runPluginLogsCommand(pluginId, options, _command) {
 }
 export async function runPluginInstallCommand(source, options, _command) {
     process.stderr.write("Trusting plugin code: server code and preparation commands run unsandboxed on the daemon host; client code runs inside Paseo. Dependencies and future updates are part of the codebase you trust.\n");
-    const sourceReference = formatPluginSourceReference(source, options.path);
+    const reference = parsePluginSourceReference(source);
+    let resolvedSource = source;
+    if (reference.kind === "directory") {
+        const directory = expandUserPath(reference.source);
+        // An absolute path can target a daemon on a different operating system.
+        const absoluteDirectory = path.posix.isAbsolute(directory) || path.win32.isAbsolute(directory)
+            ? directory
+            : path.resolve(directory);
+        resolvedSource = formatPluginSourceReference(absoluteDirectory, reference.pluginPath);
+    }
+    const sourceReference = formatPluginSourceReference(resolvedSource, options.path);
     const data = await withPluginSourceClient(options.daemonTarget, (client) => client.installPluginSource({
         source: sourceReference,
         ...(options.id ? { id: options.id } : {}),
@@ -131,8 +143,8 @@ export function createPluginCommand() {
     addJsonAndDaemonHostOptions(plugin
         .command("install")
         .alias("add")
-        .description("Trust and install a plugin from a directory, Git repository, or npm package")
-        .argument("<source>", "Host directory, Git or npm source, optionally followed by :plugin/path")
+        .description("Trust and install a plugin from a registry, directory, Git repository, or npm package")
+        .argument("<source>", "Registry owner/slug or host/owner/slug, host directory, explicit git:owner/repo or Git URL, or npm: source")
         .option("--id <id>", "Runtime plugin ID (defaults to paseo-plugin.json id)")
         .option("--ref <ref>", "Git branch, tag, or commit")
         .option("--path <path>", "Legacy form of the :plugin/path source suffix")).action(withOutput(runPluginInstallCommand));

package/dist/commands/plugin/scaffold.js

@@ -2,6 +2,33 @@ import { mkdir, readdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { PluginIdSchema } from "@camerontaylor/paseo-protocol/messages";
 import { resolveCliVersion } from "../../version.js";
+const OVERVIEW = `<!--
+OVERVIEW.md is required to list your plugin in the registry. Keep it beside
+paseo-plugin.json in your repository at the pinned commit and in your npm package.
+Replace this comment with useful facts before publishing.
+
+This overview is for people choosing a plugin in Paseo, on the plugin page under
+its install command. README assumes a GitHub audience and includes technical
+details, installation instructions, and badges. Long, AI-generated READMEs leave
+people reading past that material to understand what the plugin does.
+
+Write these parts in order, including only what helps someone decide to install:
+
+1. Describe what your plugin is and does in plain terms first.
+2. Explain how it works only when it is not obvious.
+3. Explain setup when needed: settings, accounts, tokens, providers, tools, or
+   other plugins. Include applicable daemon version and operating system
+   requirements. Setup guidance is allowed; installation instructions are not.
+4. Explain capabilities and settings worth understanding, what each option does,
+   what the plugin reads or sends and where, permissions, and known limits.
+
+Length follows complexity; a theme needs one paragraph. Choose headings only
+when they help. Use sentence case and plain factual language, with no em dashes.
+Omit installation commands, badges, changelog, contributing or license sections,
+marketing, and unsupported claims. Avoid implementation filler such as empty
+cleanup functions, theme-token field lists, or lists of absent features.
+-->
+`;
 const TSCONFIG = {
     compilerOptions: {
         target: "ES2020",
@@ -138,6 +165,7 @@ export async function scaffoldPluginDirectory(targetDirectory, requestedId) {
         version: "0.0.0",
         files: [
             "paseo-plugin.json",
+            "OVERVIEW.md",
             "index.client.ts",
             "index.client.tsx",
             "index.server.ts",
@@ -160,8 +188,14 @@ export async function scaffoldPluginDirectory(targetDirectory, requestedId) {
     const files = new Map([
         [
             "paseo-plugin.json",
-            `${JSON.stringify({ id, requirements: { paseo: `>=${version}` } }, null, 2)}\n`,
+            `${JSON.stringify({
+                id,
+                $comment: 'Add "name": "My plugin" to set a display name. Add "icon": "assets/icon.png" for a PNG inside the package. Add image or video paths (relative to this manifest) or HTTPS URLs to media. Include local assets in package.json files.',
+                media: [],
+                requirements: { paseo: `>=${version}` },
+            }, null, 2)}\n`,
         ],
+        ["OVERVIEW.md", OVERVIEW],
         ["package.json", `${JSON.stringify(packageJson, null, 2)}\n`],
         ["tsconfig.json", `${JSON.stringify(TSCONFIG, null, 2)}\n`],
         ["index.client.tsx", CLIENT_ENTRY],

package/dist/commands/schedule/update.d.ts

@@ -12,10 +12,8 @@ export interface ScheduleUpdateOptions extends ScheduleCommandOptions {
     model?: string;
     mode?: string;
     cwd?: string;
-    maxRuns?: string;
-    noMaxRuns?: boolean;
-    expiresIn?: string;
-    noExpiresIn?: boolean;
+    maxRuns?: string | false;
+    expiresIn?: string | false;
 }
 export declare function runUpdateCommand(id: string, options: ScheduleUpdateOptions, _command: Command): Promise<ListResult<ScheduleInspectRow>>;
 //# sourceMappingURL=update.d.ts.map

package/dist/commands/schedule/update.js

@@ -12,10 +12,10 @@ export async function runUpdateCommand(id, options, _command) {
         model: options.model,
         mode: options.mode,
         cwd: options.cwd,
-        maxRuns: options.maxRuns,
-        expiresIn: options.expiresIn,
-        clearMaxRuns: options.noMaxRuns,
-        clearExpires: options.noExpiresIn,
+        maxRuns: options.maxRuns === false ? undefined : options.maxRuns,
+        expiresIn: options.expiresIn === false ? undefined : options.expiresIn,
+        clearMaxRuns: options.maxRuns === false,
+        clearExpires: options.expiresIn === false,
     });
     const { client } = await connectScheduleClient(options.daemonTarget);
     try {

package/dist/run.js

@@ -24,7 +24,19 @@ export function createCliParseArgv(input) {
     }
     return [...nodeArgv, ...cliArgv];
 }
+// The program that started the CLI can close its end of stdout before the output
+// is written, as `paseo ls | head -1` or a launcher that discards output does.
+// Drop the output nobody reads and let the command finish, instead of surfacing
+// the failed write as an uncaught error.
+function ignoreClosedStdout(error) {
+    if (error.code !== "EPIPE") {
+        throw error;
+    }
+}
 export async function runCli(argv, options = {}) {
+    if (!process.stdout.listeners("error").includes(ignoreClosedStdout)) {
+        process.stdout.on("error", ignoreClosedStdout);
+    }
     const parseArgv = createCliParseArgv({
         argv,
         cwd: options.cwd ?? process.cwd(),

package/dist/utils/wait-for-stop.d.ts

@@ -0,0 +1,2 @@
+export declare function waitForStop(): Promise<void>;
+//# sourceMappingURL=wait-for-stop.d.ts.map

package/dist/utils/wait-for-stop.js

@@ -0,0 +1,24 @@
+// Commands that stream until stopped (`paseo agent logs --follow`, `paseo agent
+// attach`) stop on Ctrl+C, a termination signal, or when the program reading
+// their output closes its end, as `| head` does. A closed reader shows up as
+// EPIPE on the next write to stdout, so the command stops at its next line of
+// output.
+export function waitForStop() {
+    return new Promise((resolve) => {
+        const stop = () => {
+            process.off("SIGINT", stop);
+            process.off("SIGTERM", stop);
+            process.stdout.off("error", stopOnClosedStdout);
+            resolve();
+        };
+        const stopOnClosedStdout = (error) => {
+            if (error.code === "EPIPE") {
+                stop();
+            }
+        };
+        process.on("SIGINT", stop);
+        process.on("SIGTERM", stop);
+        process.stdout.on("error", stopOnClosedStdout);
+    });
+}
+//# sourceMappingURL=wait-for-stop.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camerontaylor/paseo-cli",
-  "version": "0.11.0-beta.3.fork.1",
+  "version": "0.11.1-fork.1",
   "description": "Paseo CLI - control your AI coding agents from the command line",
   "bin": {
     "paseo": "bin/paseo"
@@ -28,9 +28,9 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.0.0",
-    "@camerontaylor/paseo-client": "0.11.0-beta.3.fork.1",
-    "@camerontaylor/paseo-protocol": "0.11.0-beta.3.fork.1",
-    "@camerontaylor/paseo-server": "0.11.0-beta.3.fork.1",
+    "@camerontaylor/paseo-client": "0.11.1-fork.1",
+    "@camerontaylor/paseo-protocol": "0.11.1-fork.1",
+    "@camerontaylor/paseo-server": "0.11.1-fork.1",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "mime-types": "^2.1.35",