@pasko70/pibo 1.9.13 → 1.10.0

package/dist/tools/index.js

@@ -97,6 +97,10 @@ function printShow(name) {
     if (entry.name === 'agent-browser') {
         console.log('  pibo tools agent-browser');
     }
+    if (entry.name === 'loop') {
+        console.log('  pibo tools loop');
+        console.log('  pibo loop templates');
+    }
     if (entry.name === 'ralph') {
         console.log('  pibo tools ralph');
         console.log('  pibo ralph templates');
@@ -202,31 +206,31 @@ function parseNonNegativeInteger(value) {
     return parsed;
 }
 function printBrowserUseDiscovery() {
-    console.log(`pibo tools browser-use - browser-use helpers
-
-Start:
-  eval "$(pibo tools env browser-use)"
-
-Commands:
-  targets                    List Chrome CDP targets with Chat auth hints
-  attach-chat                Export the best existing authenticated Chat target
-  auth-template path          Print the default authenticated template profile path
-  auth-template env           Print shell exports for preparing the auth template profile
-  lease acquire               Acquire an isolated authenticated browser slot
-  lease list                  List authenticated browser slots
-  lease release <id>          Release one browser slot
-  lease reap-stale            Release expired or dead browser slots
-  pool status                 Show read-only managed browser-pool status
-  pool reap                   Reap an idle managed browser pool
-  health                      Check browser-use health and report issues
-
-Next:
-  pibo tools show browser-use
-  pibo tools guide browser-use browser-use
-  pibo tools browser-use targets
-  pibo tools browser-use auth-template env
-  pibo tools browser-use lease acquire
-  pibo tools browser-use pool status
+    console.log(`pibo tools browser-use - browser-use helpers
+
+Start:
+  eval "$(pibo tools env browser-use)"
+
+Commands:
+  targets                    List Chrome CDP targets with Chat auth hints
+  attach-chat                Export the best existing authenticated Chat target
+  auth-template path          Print the default authenticated template profile path
+  auth-template env           Print shell exports for preparing the auth template profile
+  lease acquire               Acquire an isolated authenticated browser slot
+  lease list                  List authenticated browser slots
+  lease release <id>          Release one browser slot
+  lease reap-stale            Release expired or dead browser slots
+  pool status                 Show read-only managed browser-pool status
+  pool reap                   Reap an idle managed browser pool
+  health                      Check browser-use health and report issues
+
+Next:
+  pibo tools show browser-use
+  pibo tools guide browser-use browser-use
+  pibo tools browser-use targets
+  pibo tools browser-use auth-template env
+  pibo tools browser-use lease acquire
+  pibo tools browser-use pool status
   pibo tools browser-use pool reap --json`);
 }
 function getBrowserPoolStatusIdentity(options) {
@@ -577,62 +581,77 @@ async function printBrowserUseHealth(status, json = false) {
     }
 }
 function printAgentBrowserDiscovery() {
-    console.log(`pibo tools agent-browser - Agent Browser helpers
-
-Start:
-  eval "$(pibo tools env agent-browser)"
-
-Commands:
-  health                      Check Agent Browser health and report issues
-  sessions                    List upstream Agent Browser sessions
-  targets                     List Chrome CDP targets with Chat auth hints
-  attach-chat                 Export the best existing authenticated Chat target
-  auth-template path          Print the default authenticated template profile path
-  auth-template env           Print shell exports for preparing the auth template profile
-  lease acquire               Acquire an isolated authenticated browser slot
-  lease list                  List authenticated browser slots
-  lease release <id>          Release one browser slot
-  lease reap-stale            Release expired browser slots
-
-Next:
-  pibo tools show agent-browser
-  pibo tools guide agent-browser agent-browser
-  pibo tools agent-browser health
+    console.log(`pibo tools agent-browser - Agent Browser helpers
+
+Start:
+  eval "$(pibo tools env agent-browser)"
+
+Commands:
+  health                      Check Agent Browser health and report issues
+  sessions                    List upstream Agent Browser sessions
+  targets                     List Chrome CDP targets with Chat auth hints
+  attach-chat                 Export the best existing authenticated Chat target
+  auth-template path          Print the default authenticated template profile path
+  auth-template env           Print shell exports for preparing the auth template profile
+  lease acquire               Acquire an isolated authenticated browser slot
+  lease list                  List authenticated browser slots
+  lease release <id>          Release one browser slot
+  lease reap-stale            Release expired browser slots
+
+Next:
+  pibo tools show agent-browser
+  pibo tools guide agent-browser agent-browser
+  pibo tools agent-browser health
   pibo tools agent-browser lease acquire`);
 }
+function printLoopDiscovery() {
+    console.log(`pibo tools loop - Goal-first Loop helpers
+
+Commands:
+  pibo loop templates --json
+  pibo loop add --template goal-objective --room <room-id> --start --json
+  pibo loop list --all --json
+  pibo loop runs --job <job-id> --json
+  pibo loop stop <job-id>
+  pibo loop cancel <job-id>
+
+Next:
+  pibo tools guide loop loop
+  pibo loop templates`);
+}
 function printRalphDiscovery() {
-    console.log(`pibo tools ralph - Ralph job helpers
-
-Commands:
-  pibo ralph templates --json
-  pibo ralph add --template <id> --room <room-id> --start --json
-  pibo ralph list --all --json
-  pibo ralph runs --job <job-id> --json
-  pibo ralph stop <job-id>
-  pibo ralph cancel <job-id>
-
-Next:
-  pibo tools guide ralph ralph
+    console.log(`pibo tools ralph - Ralph job helpers
+
+Commands:
+  pibo ralph templates --json
+  pibo ralph add --template <id> --room <room-id> --start --json
+  pibo ralph list --all --json
+  pibo ralph runs --job <job-id> --json
+  pibo ralph stop <job-id>
+  pibo ralph cancel <job-id>
+
+Next:
+  pibo tools guide ralph ralph
   pibo ralph templates`);
 }
 function printToolsDiscovery() {
-    console.log(`pibo tools - curated CLI tools
-
-Commands:
-  list                      List curated tools
-  installed                 List installed tools
-  show <name>               Show one tool
-  install <name>            Install one tool
-  doctor <name>             Check one tool
-  guides <name>             List tool guides
-  guide <name> [guide]      Print one guide
-  path <name>               Print executable path
-  env <name>                Print shell exports
-  browser-use               Browser-use auth slots and helper commands
-  agent-browser             Agent Browser sessions, targets, and auth slots
-  ralph                     Ralph job helper commands
-
-Next:
+    console.log(`pibo tools - curated CLI tools
+
+Commands:
+  list                      List curated tools
+  installed                 List installed tools
+  show <name>               Show one tool
+  install <name>            Install one tool
+  doctor <name>             Check one tool
+  guides <name>             List tool guides
+  guide <name> [guide]      Print one guide
+  path <name>               Print executable path
+  env <name>                Print shell exports
+  browser-use               Browser-use auth slots and helper commands
+  agent-browser             Agent Browser sessions, targets, and auth slots
+  ralph                     Ralph job helper commands
+
+Next:
   pibo tools list`);
 }
 export async function runToolsCli(argv = process.argv) {
@@ -702,6 +721,10 @@ export async function runToolsCli(argv = process.argv) {
         .argument('<name>')
         .description('Print shell exports for using the tool directly')
         .action(printEnv);
+    program
+        .command('loop')
+        .description('Goal-first Loop helper commands')
+        .action(printLoopDiscovery);
     program
         .command('ralph')
         .description('Ralph job helper commands')
@@ -790,10 +813,10 @@ export async function runToolsCli(argv = process.argv) {
         .command('auth-template')
         .description('Manage the Agent Browser authenticated template profile')
         .action(() => {
-        console.log(`pibo tools agent-browser auth-template
-
-Commands:
-  path    Print the default authenticated template profile path
+        console.log(`pibo tools agent-browser auth-template
+
+Commands:
+  path    Print the default authenticated template profile path
   env     Print shell exports for preparing the auth template profile`);
     });
     agentAuthTemplate
@@ -814,12 +837,12 @@ Commands:
         .command('lease')
         .description('Acquire and manage isolated Agent Browser slots')
         .action(() => {
-        console.log(`pibo tools agent-browser lease
-
-Commands:
-  acquire       Acquire an isolated authenticated browser slot
-  list          List authenticated browser slots
-  release <id>  Release one browser slot
+        console.log(`pibo tools agent-browser lease
+
+Commands:
+  acquire       Acquire an isolated authenticated browser slot
+  list          List authenticated browser slots
+  release <id>  Release one browser slot
   reap-stale    Release expired browser slots`);
     });
     agentLease
@@ -911,10 +934,10 @@ Commands:
         .command('pool')
         .description('Inspect and reap the managed browser pool')
         .action(() => {
-        console.log(`pibo tools browser-use pool
-
-Commands:
-  status    Show read-only managed browser-pool status
+        console.log(`pibo tools browser-use pool
+
+Commands:
+  status    Show read-only managed browser-pool status
   reap      Reap an idle managed browser pool`);
     });
     pool
@@ -942,10 +965,10 @@ Commands:
         .command('auth-template')
         .description('Manage the browser-use authenticated template profile')
         .action(() => {
-        console.log(`pibo tools browser-use auth-template
-
-Commands:
-  path    Print the default authenticated template profile path
+        console.log(`pibo tools browser-use auth-template
+
+Commands:
+  path    Print the default authenticated template profile path
   env     Print shell exports for preparing the auth template profile`);
     });
     authTemplate
@@ -964,12 +987,12 @@ Commands:
         .command('lease')
         .description('Acquire and manage isolated authenticated browser-use slots')
         .action(() => {
-        console.log(`pibo tools browser-use lease
-
-Commands:
-  acquire       Acquire an isolated authenticated browser slot
-  list          List authenticated browser slots
-  release <id>  Release one browser slot
+        console.log(`pibo tools browser-use lease
+
+Commands:
+  acquire       Acquire an isolated authenticated browser slot
+  list          List authenticated browser slots
+  release <id>  Release one browser slot
   reap-stale    Release expired or dead browser slots`);
     });
     lease

package/dist/tools/registry.js

@@ -1,7 +1,7 @@
 import { existsSync } from 'node:fs';
 import { ensureAgentBrowserWrapper } from './agent-browser-wrapper.js';
 import { detectDesktopEnv, hasDesktopDisplay, printDesktopEnvStatus, printLinuxVirtualDisplayHint } from './desktop-env.js';
-import { AGENT_BROWSER_GUIDE, BROWSER_USE_GUIDE, GRAPHIFY_GUIDE, RALPH_GUIDE, REMOTE_BROWSER_GUIDE } from './guides.js';
+import { AGENT_BROWSER_GUIDE, BROWSER_USE_GUIDE, GRAPHIFY_GUIDE, LOOP_GUIDE, RALPH_GUIDE, REMOTE_BROWSER_GUIDE } from './guides.js';
 import { ensureLinuxVirtualDisplay } from './linux-virtual-display.js';
 import { getToolNpmRuntimePaths, installToolNpmRuntime, printToolNpmRuntimeDoctor, removeToolNpmRuntime, } from './npm-runtime.js';
 import { getToolPythonRuntimePaths, installToolPythonRuntime, runInheritedCommand, printToolPythonRuntimeDoctor, removeToolPythonRuntime, } from './python-runtime.js';
@@ -83,13 +83,31 @@ const REGISTRY = [
             'Guide: `npm run dev -- tools guide graphify graphify`.',
         ].join('\n'),
     },
+    {
+        name: 'loop',
+        description: 'Pibo-native goal-first continuous agent loop runner.',
+        kind: 'internal',
+        guides: [LOOP_GUIDE],
+        notes: [
+            'Loop is built into the pibo CLI; no external runtime installation is required.',
+            'Goal mode reuses one Pibo Session and is the default; Ralph mode remains available for fresh-session compatibility.',
+            'Goal lifecycle tools and token budgets are available when the selected agent enables pibo-goal-control.',
+        ],
+        agentContextSnippet: [
+            'Goal-first continuous Pibo agent loop runner.',
+            'Use `pibo loop templates`, then create with `pibo loop add --template goal-objective --room <room-id> --start`.',
+            'Optional budgets: `--token-budget <n>` and `--max-iterations <n>`.',
+            'Inspect/control with `pibo loop list --json`, `runs --job <id> --json`, `stop <id>`, `cancel <id>`.',
+            'Guide: `pibo tools guide loop loop`.',
+        ].join('\n'),
+    },
     {
         name: 'ralph',
-        description: 'Pibo-native continuous agent job runner for implementation and debugging loops.',
+        description: 'Legacy Pibo Ralph alias for fresh-session continuous agent jobs.',
         kind: 'internal',
         guides: [RALPH_GUIDE],
         notes: [
-            'Ralph is built into the pibo CLI; no external runtime installation is required.',
+            'Ralph is the legacy fresh-session alias; prefer pibo loop for new Goal work.',
             'Ralph jobs are app-global; use room targets or the shared default target when creating jobs.',
             'Prefer templates for repeatable jobs, and use --json for automation-safe inspection.',
         ],