@peakflo/agent-harness 0.2.11-rc.4 → 0.2.11-rc.5

package/README.md

@@ -54,7 +54,8 @@ Optional flags include `--health-port <port>`, `--runtime <desktop|self-hosted>`
 
 ## Connect your own agent in one command
 
-The Welcome window in Spaces shows one command for Codex, Claude Code, or
+Agents → "Connect your own agent" in Spaces (and the Welcome window during
+onboarding) shows one command for Codex, Claude Code, or
 Cursor, for example:
 
 ```sh
@@ -129,7 +130,8 @@ New service files start with `--service --stored-credential`. Older service
 files with only `--stored-credential` still work after an upgrade. Run
 `service repair` to update the file. The runner reads its saved credential
 from the workspace. If that credential is missing, expired, or
-rejected, start the runner once in a terminal to sign in again. The service
+rejected, open Agents → "Connect your own agent" in Spaces (or "Reconnect" on
+that machine) to get a new command, and run it on the machine. The service
 file and the service settings contain no enrolment token or runner credential.
 It stops after an invalid option, a refused harness version, an unusable
 credential, or a local port conflict. Linux waits 30 seconds before it retries

package/dist/cli.js

@@ -46,7 +46,8 @@ const USAGE = `pf-agent-harness — headless Peakflo coding-agent harness
 
 Usage:
   pf-agent-harness connect <codex|claude-code|cursor> --connection <id> [--control-plane <url>]
-                                one command from the Welcome window: approve
+                                one command from Agents → "Connect your own
+                                agent" in Spaces (or the Welcome window): approve
                                 this computer in the browser, connect the agent
                                 as your personal agent, run it in the background
   pf-agent-harness start [options]

package/dist/connect/connect.d.ts

@@ -1,7 +1,8 @@
 /**
  * `pf-agent-harness connect <vendor> --connection <id> [--control-plane <url>]`
  *
- * ONE COMMAND, copied from the Welcome window, that:
+ * ONE COMMAND, copied from Agents → "Connect your own agent" (or the
+ * Welcome window), that:
  *   1. checks the vendor CLI is installed and signed in;
  *   2. asks the signed-in user to approve this computer in the browser
  *      (loopback + PKCE + `state`; see workflow-api `byo-connect.ts`);
@@ -34,7 +35,7 @@ export interface ConnectArgs {
     appUrl?: string;
     openBrowser: boolean;
 }
-export declare const CONNECT_USAGE = "Usage: pf-agent-harness connect <codex|claude-code|cursor> --connection <id> [--control-plane <url>]\n\nCopy this command from the Welcome window in Spaces. It approves this computer\nin your browser, connects the agent as your personal agent, and keeps it\nrunning in the background.";
+export declare const CONNECT_USAGE = "Usage: pf-agent-harness connect <codex|claude-code|cursor> --connection <id> [--control-plane <url>]\n\nCopy this command from Agents \u2192 \"Connect your own agent\" in Spaces (or\n\"Reconnect\" on your machine there). It approves this computer\nin your browser, connects the agent as your personal agent, and keeps it\nrunning in the background.";
 export declare function parseConnectArgs(argv: string[], env?: NodeJS.ProcessEnv): ConnectArgs;
 /** The machine name the approval page shows. Must match the API's rule. */
 export declare function machineName(raw: string): string;

package/dist/connect/connect.js

@@ -2,7 +2,8 @@
 /**
  * `pf-agent-harness connect <vendor> --connection <id> [--control-plane <url>]`
  *
- * ONE COMMAND, copied from the Welcome window, that:
+ * ONE COMMAND, copied from Agents → "Connect your own agent" (or the
+ * Welcome window), that:
  *   1. checks the vendor CLI is installed and signed in;
  *   2. asks the signed-in user to approve this computer in the browser
  *      (loopback + PKCE + `state`; see workflow-api `byo-connect.ts`);
@@ -74,7 +75,8 @@ exports.VENDOR_SETUP = {
 };
 exports.CONNECT_USAGE = `Usage: pf-agent-harness connect <codex|claude-code|cursor> --connection <id> [--control-plane <url>]
 
-Copy this command from the Welcome window in Spaces. It approves this computer
+Copy this command from Agents → "Connect your own agent" in Spaces (or
+"Reconnect" on your machine there). It approves this computer
 in your browser, connects the agent as your personal agent, and keeps it
 running in the background.`;
 function flag(argv, name) {
@@ -124,7 +126,7 @@ function parseConnectArgs(argv, env = {}) {
     // `--token` is refused on purpose: this command never takes a secret.
     const connection = flag(argv, 'connection');
     if (!connection || !UUID.test(connection))
-        throw new ConnectError(`Copy the command from the Welcome window: it includes --connection <id>.\n\n${exports.CONNECT_USAGE}`);
+        throw new ConnectError(`Copy the command from Agents → "Connect your own agent" in Spaces: it includes --connection <id>.\n\n${exports.CONNECT_USAGE}`);
     const appUrl = flag(argv, 'app-url') ?? env.PF_APP_URL;
     return {
         vendor,
@@ -205,7 +207,7 @@ async function runConnect(args, deps) {
     const setup = exports.VENDOR_SETUP[vendor];
     const log = deps.log;
     if (deps.platform !== 'darwin' && deps.platform !== 'linux')
-        throw new ConnectError('connect needs macOS or Linux. On Windows, use "Ask my agent to do it" in the Welcome window.');
+        throw new ConnectError('connect needs macOS or Linux. On Windows, open Agents → "Connect your own agent" in Spaces and use "Ask my agent to do it instead".');
     const machine = machineName(deps.hostname());
     log(`Connecting ${setup.label} on ${machine}…`);
     /* 1. The vendor CLI must be installed and signed in. */
@@ -265,7 +267,7 @@ async function runConnect(args, deps) {
         exchange.json.vendor !== vendor)
         throw new ConnectError(typeof exchange.json.error === 'string'
             ? printable(exchange.json.error)
-            : `The approval could not be used (${exchange.status}). Get a new command from the Welcome window.`);
+            : `The approval could not be used (${exchange.status}). Open Agents → "Connect your own agent" in Spaces (or "Reconnect" on this machine) to get a new command.`);
     const company = typeof exchange.json.companyName === 'string'
         ? exchange.json.companyName
         : 'your company';
@@ -301,7 +303,7 @@ async function runConnect(args, deps) {
     if (!healthy)
         log(`! The service has not answered yet (it may still be starting, or a local port was taken). Check it with: npx @peakflo/agent-harness service status --vendor ${vendor}`);
     log('');
-    log(`✓ ${setup.label} is connected to ${company} on ${machine}. Return to the Welcome window.`);
+    log(`✓ ${setup.label} is connected to ${company} on ${machine}. Return to Spaces.`);
 }
 /* -------------------------------------------------------------------------- */
 /* Real dependencies                                                           */

package/dist/harness.js

@@ -116,7 +116,7 @@ exports.VersionRefusedError = VersionRefusedError;
 /** A service cannot re-enrol without a new one-time token from a user. */
 class StoredCredentialUnavailableError extends Error {
     constructor() {
-        super('No usable stored runner credential. Start the runner in a terminal to sign in again.');
+        super('No usable stored runner credential. For your own agent, open Agents in Spaces and use "Reconnect" on this machine (or "Connect your own agent") to get a new command, then run it here. For a self-hosted runner, start it once in a terminal to sign in again.');
         this.name = 'StoredCredentialUnavailableError';
     }
 }

package/dist/service.js

@@ -305,7 +305,7 @@ class ServiceManager {
         if (!stored ||
             (stored.credentialExpiresAt &&
                 Date.parse(stored.credentialExpiresAt) <= Date.now())) {
-            throw new Error('No usable saved runner credential. Start the runner once in a terminal, then install the service.');
+            throw new Error('No usable saved runner credential. For your own agent, open Agents in Spaces and use "Reconnect" on this machine (or "Connect your own agent") to get a new command, then run it here. For a self-hosted runner, start it once in a terminal to sign in again.');
         }
     }
     writeAndStart(config) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peakflo/agent-harness",
-  "version": "0.2.11-rc.4",
+  "version": "0.2.11-rc.5",
   "description": "Headless Peakflo coding-agent harness. One codebase, three hosting modes: a Daytona cloud sandbox, a customer VM, and the 20x desktop.",
   "license": "MIT",
   "type": "commonjs",