@pasko70/pibo 1.9.13 → 1.10.1

package/dist/debug/web.js

@@ -52,98 +52,98 @@ export async function runDebugWeb(args) {
     throw new Error(`Unknown pibo debug web command "${command}". Run pibo debug web --help.`);
 }
 function printWebDiscovery() {
-    console.log(`pibo debug web - inspect browser render state via CDP
-
-Commands:
-  targets      List Chrome CDP targets with Chat auth hints
-  attach-chat  Show the best authenticated Chat Web target
-  snapshot     Capture a scoped compact DOM snapshot
-  diff         Compare current scoped snapshot against previous or artifact
-  watch        Record a bounded scoped DOM/focus/route timeline
-  scenario     Run guided Chat Web debug workflows
-  report       Render saved debug artifacts as reviewer-friendly Markdown
-
-Next:
-  pibo debug web targets
-  pibo debug web snapshot --preset session-list
-  pibo debug web watch --preset chat-shell --duration 5000
-  pibo debug web report streaming-benchmark --from artifact.json
+    console.log(`pibo debug web - inspect browser render state via CDP
+
+Commands:
+  targets      List Chrome CDP targets with Chat auth hints
+  attach-chat  Show the best authenticated Chat Web target
+  snapshot     Capture a scoped compact DOM snapshot
+  diff         Compare current scoped snapshot against previous or artifact
+  watch        Record a bounded scoped DOM/focus/route timeline
+  scenario     Run guided Chat Web debug workflows
+  report       Render saved debug artifacts as reviewer-friendly Markdown
+
+Next:
+  pibo debug web targets
+  pibo debug web snapshot --preset session-list
+  pibo debug web watch --preset chat-shell --duration 5000
+  pibo debug web report streaming-benchmark --from artifact.json
 `);
 }
 function printSnapshotHelp() {
-    console.log(`pibo debug web snapshot - capture a scoped compact DOM snapshot
-
-Usage:
-  pibo debug web snapshot --scope <selector> [--target id|ws] [--json] [--artifact]
-  pibo debug web snapshot --preset session-list
-
-Presets:
-  app | route-shell | sidebar | session-list | chat-shell | composer
-
-Next:
-  pibo debug web diff --preset session-list
-  pibo debug web watch --preset chat-shell --duration 5000
+    console.log(`pibo debug web snapshot - capture a scoped compact DOM snapshot
+
+Usage:
+  pibo debug web snapshot --scope <selector> [--target id|ws] [--json] [--artifact]
+  pibo debug web snapshot --preset session-list
+
+Presets:
+  app | route-shell | sidebar | session-list | chat-shell | composer
+
+Next:
+  pibo debug web diff --preset session-list
+  pibo debug web watch --preset chat-shell --duration 5000
 `);
 }
 function printWatchHelp() {
-    console.log(`pibo debug web watch - record compact render-state changes
-
-Usage:
-  pibo debug web watch --scope <selector> [--duration ms] [--target id|ws] [--json] [--artifact]
-  pibo debug web watch --preset chat-shell --duration 5000
-
-Defaults:
-  duration=5000ms, max=30000ms, event budget=500
-
-Next:
-  pibo debug web diff --preset chat-shell
-  pibo debug web scenario new-session --manual
+    console.log(`pibo debug web watch - record compact render-state changes
+
+Usage:
+  pibo debug web watch --scope <selector> [--duration ms] [--target id|ws] [--json] [--artifact]
+  pibo debug web watch --preset chat-shell --duration 5000
+
+Defaults:
+  duration=5000ms, max=30000ms, event budget=500
+
+Next:
+  pibo debug web diff --preset chat-shell
+  pibo debug web scenario new-session --manual
 `);
 }
 function printScenarioHelp() {
-    console.log(`pibo debug web scenario - guided Chat Web debug workflows
-
-Usage:
-  pibo debug web scenario new-session [--manual|--act] [--duration ms] [--json] [--artifact]
-  pibo debug web scenario streaming-benchmark [--fixture|--backend-fixture] [--fixture-profile steady|jitter|burst|batch] [--fixture-mix text|reasoning-text|markdown|gfm-markdown|gfm-task-markdown|gfm-full-markdown] [--fixture-prelude-messages n] [--simulate-reconnect|--simulate-trace-catchup] [--duration ms] [--runs n] [--from artifact.json] [--provider-request-id pr_...|--provider-session-id ps_...|--provider-turn-id turn_...|--provider-selected-session] [--compare-url url|--compare-hosted|--compare-hosted-if-configured] [--assert] [--expect-regression text] [--negative-profile batch|overlay-drop] [--json] [--artifact]
-
-Defaults:
-  new-session --manual waits while you click New Session yourself.
-  new-session --act clicks the discovered New Session button after the watcher starts.
-  streaming-benchmark enables debugStreaming for future events, observes assistant DOM increments, and snapshots window.__piboStreamingDebug.
-  streaming-benchmark --fixture navigates the target to a deterministic in-browser stream fixture before measuring.
-  streaming-benchmark --backend-fixture posts to /api/chat/debug/streaming-fixture and records EventSource metrics while the real app consumes deterministic /api/chat/events frames.
-  streaming-benchmark --fixture-profile selects steady cadence, deterministic jitter, bursty timing, or intentional batch stress.
-  streaming-benchmark --fixture-mix includes text-only, mixed reasoning/text, CommonMark Markdown, simple GFM Markdown, or full-parser GFM Markdown assistant deltas.
-  streaming-benchmark --fixture-prelude-messages seeds completed live assistant messages before counters reset so large live overlays can be measured without changing fixture preservation denominators.
-  streaming-benchmark --simulate-reconnect reloads the app with an EventSource probe, forces one live stream close, and verifies reconnect/transient ids.
-  streaming-benchmark --simulate-trace-catchup suppresses backend live text deltas and verifies trace snapshot recovery.
-  streaming-benchmark --runs repeats the same scenario and reports medians; --from compares against a prior benchmark artifact.
-  streaming-benchmark --compare-url runs the same backend fixture at another Chat URL, for direct-vs-hosted SSE comparison.
-  streaming-benchmark --compare-hosted uses PIBO_DEV_PUBLIC_URL or PIBO_DEV_BASE_URL from the environment or .env.developer-host as the compare URL.
-  streaming-benchmark --compare-hosted-if-configured runs the hosted comparison when a dev URL is configured; otherwise it records a warning and keeps the primary benchmark.
-  streaming-benchmark --provider-request-id attaches provider/Pi telemetry delta counts, byte stats, gap stats, parse errors, first-text latency, and provider-to-transport preservation ratios from pibo debug telemetry.
-  streaming-benchmark --provider-session-id, --provider-turn-id, or --provider-selected-session discovers the latest provider request from telemetry session/turn metadata after the benchmark window before attaching provider metrics.
-  streaming-benchmark --assert exits non-zero when fixture/debug/DOM/provider preservation gates fail.
-  streaming-benchmark --expect-regression marks a required regression substring for controlled negative benchmarks; unexpected or missing expected regressions still fail with --assert.
-  streaming-benchmark --negative-profile batch expands to the backend batch reasoning/text fixture with required controlled regression assertions.
-  streaming-benchmark --negative-profile overlay-drop preserves SSE/EventSource input but drops live-overlay text/reasoning enqueue for a controlled pipeline-preservation failure.
+    console.log(`pibo debug web scenario - guided Chat Web debug workflows
+
+Usage:
+  pibo debug web scenario new-session [--manual|--act] [--duration ms] [--json] [--artifact]
+  pibo debug web scenario streaming-benchmark [--fixture|--backend-fixture] [--fixture-profile steady|jitter|burst|batch] [--fixture-mix text|reasoning-text|markdown|gfm-markdown|gfm-task-markdown|gfm-full-markdown] [--fixture-prelude-messages n] [--simulate-reconnect|--simulate-trace-catchup] [--duration ms] [--runs n] [--from artifact.json] [--provider-request-id pr_...|--provider-session-id ps_...|--provider-turn-id turn_...|--provider-selected-session] [--compare-url url|--compare-hosted|--compare-hosted-if-configured] [--assert] [--expect-regression text] [--negative-profile batch|overlay-drop] [--json] [--artifact]
+
+Defaults:
+  new-session --manual waits while you click New Session yourself.
+  new-session --act clicks the discovered New Session button after the watcher starts.
+  streaming-benchmark enables debugStreaming for future events, observes assistant DOM increments, and snapshots window.__piboStreamingDebug.
+  streaming-benchmark --fixture navigates the target to a deterministic in-browser stream fixture before measuring.
+  streaming-benchmark --backend-fixture posts to /api/chat/debug/streaming-fixture and records EventSource metrics while the real app consumes deterministic /api/chat/events frames.
+  streaming-benchmark --fixture-profile selects steady cadence, deterministic jitter, bursty timing, or intentional batch stress.
+  streaming-benchmark --fixture-mix includes text-only, mixed reasoning/text, CommonMark Markdown, simple GFM Markdown, or full-parser GFM Markdown assistant deltas.
+  streaming-benchmark --fixture-prelude-messages seeds completed live assistant messages before counters reset so large live overlays can be measured without changing fixture preservation denominators.
+  streaming-benchmark --simulate-reconnect reloads the app with an EventSource probe, forces one live stream close, and verifies reconnect/transient ids.
+  streaming-benchmark --simulate-trace-catchup suppresses backend live text deltas and verifies trace snapshot recovery.
+  streaming-benchmark --runs repeats the same scenario and reports medians; --from compares against a prior benchmark artifact.
+  streaming-benchmark --compare-url runs the same backend fixture at another Chat URL, for direct-vs-hosted SSE comparison.
+  streaming-benchmark --compare-hosted uses PIBO_DEV_PUBLIC_URL or PIBO_DEV_BASE_URL from the environment or .env.developer-host as the compare URL.
+  streaming-benchmark --compare-hosted-if-configured runs the hosted comparison when a dev URL is configured; otherwise it records a warning and keeps the primary benchmark.
+  streaming-benchmark --provider-request-id attaches provider/Pi telemetry delta counts, byte stats, gap stats, parse errors, first-text latency, and provider-to-transport preservation ratios from pibo debug telemetry.
+  streaming-benchmark --provider-session-id, --provider-turn-id, or --provider-selected-session discovers the latest provider request from telemetry session/turn metadata after the benchmark window before attaching provider metrics.
+  streaming-benchmark --assert exits non-zero when fixture/debug/DOM/provider preservation gates fail.
+  streaming-benchmark --expect-regression marks a required regression substring for controlled negative benchmarks; unexpected or missing expected regressions still fail with --assert.
+  streaming-benchmark --negative-profile batch expands to the backend batch reasoning/text fixture with required controlled regression assertions.
+  streaming-benchmark --negative-profile overlay-drop preserves SSE/EventSource input but drops live-overlay text/reasoning enqueue for a controlled pipeline-preservation failure.
 `);
 }
 function printReportHelp() {
-    console.log(`pibo debug web report - render saved debug artifacts
-
-Usage:
-  pibo debug web report streaming-benchmark --from artifact.json [--compact] [--output report.md] [--json-output report.json] [--json] [--artifact]
-
-Reports:
-  streaming-benchmark  Summarize saved pibo debug web scenario streaming-benchmark JSON as Markdown.
-  --compact            Render reviewer-friendly Markdown tables instead of the detailed line report.
-  --output             Write the Markdown report to a specific file path.
-  --json-output        Write the normalized JSON report payload and compact rows to a specific file path.
-
-Next:
-  pibo debug web scenario streaming-benchmark --backend-fixture --assert --artifact
+    console.log(`pibo debug web report - render saved debug artifacts
+
+Usage:
+  pibo debug web report streaming-benchmark --from artifact.json [--compact] [--output report.md] [--json-output report.json] [--json] [--artifact]
+
+Reports:
+  streaming-benchmark  Summarize saved pibo debug web scenario streaming-benchmark JSON as Markdown.
+  --compact            Render reviewer-friendly Markdown tables instead of the detailed line report.
+  --output             Write the Markdown report to a specific file path.
+  --json-output        Write the normalized JSON report payload and compact rows to a specific file path.
+
+Next:
+  pibo debug web scenario streaming-benchmark --backend-fixture --assert --artifact
 `);
 }
 async function runTargets(options) {
@@ -204,13 +204,13 @@ async function runSnapshot(options) {
 }
 async function runDiff(options) {
     if (options.positionals[0] === "--help" || options.positionals[0] === "-h") {
-        console.log(`pibo debug web diff - compare scoped render snapshots
-
-Usage:
-  pibo debug web diff --scope <selector> [--from artifact.json]
-  pibo debug web diff --preset session-list
-
-Default --from is the last snapshot captured by pibo debug web snapshot.
+        console.log(`pibo debug web diff - compare scoped render snapshots
+
+Usage:
+  pibo debug web diff --scope <selector> [--from artifact.json]
+  pibo debug web diff --preset session-list
+
+Default --from is the last snapshot captured by pibo debug web snapshot.
 `);
         return;
     }
@@ -511,9 +511,9 @@ async function prepareStreamingBenchmarkEventSourceProbe(client, targetUrl) {
     await client.send("Page.addScriptToEvaluateOnNewDocument", { source: streamingBenchmarkEventSourceProbeScript() }, 5_000);
     if (targetUrl)
         await navigateStreamingBenchmarkTarget(client, targetUrl);
-    const state = await client.evaluate(`(() => {
-  try { localStorage.setItem('pibo.chat.debugStreaming', '1'); } catch {}
-  return { href: location.href };
+    const state = await client.evaluate(`(() => {
+  try { localStorage.setItem('pibo.chat.debugStreaming', '1'); } catch {}
+  return { href: location.href };
 })()`, 5_000);
     const url = new URL(state.href);
     if (url.protocol !== "http:" && url.protocol !== "https:")
@@ -544,9 +544,9 @@ async function navigateStreamingBenchmarkFixture(client, fixtureProfile, fixture
     await client.evaluate("new Promise((resolve) => { if (document.readyState === 'complete') resolve(true); else addEventListener('load', () => resolve(true), { once: true }); })", 5_000);
 }
 async function enableStreamingDebugForCurrentApp(client) {
-    const state = await client.evaluate(`(() => {
-  try { localStorage.setItem('pibo.chat.debugStreaming', '1'); } catch {}
-  return { href: location.href, hasReset: typeof window.__piboStreamingDebugReset === 'function' };
+    const state = await client.evaluate(`(() => {
+  try { localStorage.setItem('pibo.chat.debugStreaming', '1'); } catch {}
+  return { href: location.href, hasReset: typeof window.__piboStreamingDebugReset === 'function' };
 })()`, 5_000);
     if (state.hasReset)
         return;

package/dist/gateway/cli.js

@@ -609,24 +609,24 @@ export async function runGatewayCli(argv = process.argv) {
     process.exitCode = 1;
 }
 function printGatewayHelp() {
-    console.log(`pibo gateway - Gateway management
-
-Commands:
-  web status       Inspect the production gateway
-  web start        Start the production gateway
-  web restart      Safely restart the production gateway
-  web doctor       Check production gateway health
-  dev status       Inspect the dev gateway
-  dev start        Start the dev gateway
-  dev restart      Restart the dev gateway
-  dev doctor       Check dev gateway health
-
-Options:
-  --force --confirm ${RESTART_CONFIRMATION_TOKEN}
-                 Force a production restart after explicit confirmation
-
-Next:
-  pibo gateway web status
-  pibo gateway dev status
+    console.log(`pibo gateway - Gateway management
+
+Commands:
+  web status       Inspect the production gateway
+  web start        Start the production gateway
+  web restart      Safely restart the production gateway
+  web doctor       Check production gateway health
+  dev status       Inspect the dev gateway
+  dev start        Start the dev gateway
+  dev restart      Restart the dev gateway
+  dev doctor       Check dev gateway health
+
+Options:
+  --force --confirm ${RESTART_CONFIRMATION_TOKEN}
+                 Force a production restart after explicit confirmation
+
+Next:
+  pibo gateway web status
+  pibo gateway dev status
 `);
 }

package/dist/gateway/server.js

@@ -326,8 +326,10 @@ export class PiboGatewayServer {
             getProfiles: () => this.pluginRegistry.getProfileInfos(),
             createProfile: (name) => this.pluginRegistry.createProfile(name),
             getCapabilityCatalog: () => this.pluginRegistry.getCapabilityCatalog(),
-            getRalphStopConditionDefinitions: () => this.pluginRegistry.getRalphStopConditionDefinitions(),
-            getRalphStopConditionInfos: () => this.pluginRegistry.getRalphStopConditionInfos(),
+            getLoopStopConditionDefinitions: () => this.pluginRegistry.getLoopStopConditionDefinitions(),
+            getLoopStopConditionInfos: () => this.pluginRegistry.getLoopStopConditionInfos(),
+            getRalphStopConditionDefinitions: () => this.pluginRegistry.getLoopStopConditionDefinitions(),
+            getRalphStopConditionInfos: () => this.pluginRegistry.getLoopStopConditionInfos(),
             upsertProfile: (profile) => this.pluginRegistry.upsertProfile(profile),
             removeProfile: (name) => this.pluginRegistry.removeProfile(name),
             upsertContextFile: (contextFile) => this.pluginRegistry.upsertContextFile(contextFile),

package/dist/gateway/web.js

@@ -6,7 +6,7 @@ import { createPiboChatWebPlugin } from "../plugins/chat-web.js";
 import { createPiboChatVscodeWebPlugin } from "../plugins/chat-vscode-web.js";
 import { createPiboContextFilesPlugin } from "../plugins/context-files.js";
 import { createPiboCronPlugin } from "../cron/plugin.js";
-import { createPiboRalphPlugin } from "../ralph/plugin.js";
+import { createPiboLoopPlugin } from "../loops/plugin.js";
 import { createPiboDevAuthPlugin } from "../plugins/dev-auth.js";
 import { PiboPluginRegistry } from "../plugins/registry.js";
 import { createPiboWebHostPlugin } from "../plugins/web.js";
@@ -151,7 +151,7 @@ export function createWebPiboPluginRegistry(options = {}) {
                 workspaceRoot: resolvedOptions.chat?.userSkillWorkspaceRoot,
             }),
             createPiboChatCustomAgentProfilesPlugin({ agentStorePath: resolvedOptions.chat?.agentStorePath }),
-            createPiboRalphPlugin({ ralphStorePath: resolvedOptions.chat?.ralphStorePath, dataStorePath: resolvedOptions.chat?.dataStorePath, dataPayloadRootDir: resolvedOptions.chat?.dataPayloadRootDir }),
+            createPiboLoopPlugin({ loopStorePath: resolvedOptions.chat?.ralphStorePath, dataStorePath: resolvedOptions.chat?.dataStorePath, dataPayloadRootDir: resolvedOptions.chat?.dataPayloadRootDir }),
             createPiboContextFilesPlugin(resolvedOptions.contextFiles),
             createPiboChatWebPlugin(resolvedOptions.chat),
             createPiboChatVscodeWebPlugin(),

package/dist/index.js

@@ -19,6 +19,7 @@ export { LOCAL_TUI_CHANNEL_NAME, LocalRoutedTuiClient, createLocalRoutedTuiClien
 export { createWebHostChannel, DEFAULT_WEB_CHANNEL_HOST, DEFAULT_WEB_CHANNEL_PORT, WEB_CHANNEL_NAME } from "./web/channel.js";
 export { sendGatewayEvent, sendGatewayMessageAndWaitForReply } from "./gateway/request.js";
 export { createSubagentToolDefinitions, createSubagentToolName, } from "./subagents/tool.js";
+export { PiboSteeringUnavailableError } from "./core/events.js";
 export { InMemoryPiboSessionStore, createPiSessionId, createPiboSessionId, createPiboSession, } from "./sessions/store.js";
 export { runPiboCli } from "./cli.js";
 export { DEFAULT_PIBO_CONFIG_PATH, PIBO_CONFIG_KEYS, deletePiboConfigValue, getDefaultPiboConfigPath, getDisplayPiboConfigValue, getPiboConfigValue, isPiboConfigKeySecret, loadPiboConfig, redactPiboConfig, savePiboConfig, setPiboConfigValue, } from "./config/config.js";

package/dist/loops/accounting.js

@@ -0,0 +1,19 @@
+export function goalActiveTimeSeconds(job) {
+    return Math.max(0, Math.floor(job.state.activeTimeSeconds ?? job.state.timeUsedSeconds ?? 0));
+}
+export function goalElapsedWallClockSeconds(job, now = new Date()) {
+    if (job.mode !== 'goal' || !job.state.goalStartedAt)
+        return 0;
+    const startedAt = Date.parse(job.state.goalStartedAt);
+    const endedAt = job.state.goalEndedAt ? Date.parse(job.state.goalEndedAt) : now.getTime();
+    if (!Number.isFinite(startedAt) || !Number.isFinite(endedAt))
+        return 0;
+    return Math.max(0, Math.floor((endedAt - startedAt) / 1000));
+}
+export function goalRemainingTokens(job) {
+    return job.tokenBudget === undefined ? undefined : Math.max(0, job.tokenBudget - (job.state.tokensUsed ?? 0));
+}
+export function goalCanStartNextTurn(job) {
+    const remaining = goalRemainingTokens(job);
+    return remaining === undefined || remaining > (job.tokenReserve ?? 0);
+}

package/dist/loops/channel.js

@@ -0,0 +1,8 @@
+import { PiboLoopService } from './service.js';
+import { createDefaultPiboLoopStore } from './store.js';
+let currentLoopService;
+export function getPiboLoopService() { return currentLoopService; }
+export function createPiboLoopChannel(options = {}) {
+    return { name: 'pibo.loop', kind: 'custom', description: 'Runs continuous Loop Pibo agent jobs.', auth: { mode: 'trusted-local' }, start(context) { if (currentLoopService)
+            return; currentLoopService = new PiboLoopService({ ...options, context, store: createDefaultPiboLoopStore({ path: options.loopStorePath }) }); currentLoopService.start(); }, stop() { currentLoopService?.stop(); currentLoopService = undefined; } };
+}

package/dist/loops/cli.js

@@ -0,0 +1,224 @@
+import { readFileSync } from 'node:fs';
+import { Command } from 'commander';
+import { goalActiveTimeSeconds, goalElapsedWallClockSeconds } from './accounting.js';
+import { createDefaultPiboLoopStore } from './store.js';
+import { createBuiltInLoopStopConditions } from './stopping.js';
+import { DEFAULT_PIBO_PROFILE_NAME } from '../plugins/builtin.js';
+import { getLoopJobTemplate, listLoopJobTemplates } from './templates.js';
+import { parsePiboThinkingLevel } from '../core/thinking.js';
+function printDiscovery(commandName = 'pibo loop', legacyRalph = false) {
+    console.log(`${commandName}
+
+${legacyRalph ? 'Legacy alias for Ralph-mode Pibo loops.' : 'Manage continuous Pibo agent loops. Goal mode is the default.'}
+
+Commands:
+  status    Show Loop status
+  list      List Loop jobs
+  add       Create a Loop job
+  edit      Update a Loop job
+  conditions List registered built-in stop conditions
+  templates List built-in Loop job templates
+  policy    Show, set, or clear a job stop policy
+  start     Start a Loop job now
+  stop      Stop after the current session finishes
+  cancel    Abort the current session and stop
+  remove    Delete a Loop job
+  runs      List Loop runs
+
+Next: ${commandName} add --help`);
+}
+function targetFromOptions(options) { if (options.room)
+    return { kind: 'room', roomId: options.room }; if (options.defaultChat)
+    return { kind: 'default-chat' }; throw new Error('Choose a target: --room <room-id> or --default-chat'); }
+function maybeTargetFromOptions(options) { if (options.room || options.defaultChat)
+    return targetFromOptions(options); return undefined; }
+function printJson(value) { console.log(JSON.stringify(value, null, 2)); }
+function maxIterations(value) { if (value === undefined)
+    return undefined; const parsed = Number(value); if (!Number.isInteger(parsed) || parsed < 1)
+    throw new Error('--max-iterations must be a positive integer'); return parsed; }
+function tokenBudget(value) { if (value === undefined)
+    return undefined; const parsed = Number(value); if (!Number.isInteger(parsed) || parsed < 1)
+    throw new Error('--token-budget must be a positive integer'); return parsed; }
+function tokenReserve(value) { if (value === undefined)
+    return undefined; const parsed = Number(value); if (!Number.isInteger(parsed) || parsed < 0)
+    throw new Error('--token-reserve must be a non-negative integer'); return parsed; }
+function loopMode(value) { if (value === undefined)
+    return undefined; if (value !== 'goal' && value !== 'ralph')
+    throw new Error('--mode must be goal or ralph'); return value; }
+function parseModelOverride(value) {
+    if (value === undefined)
+        return undefined;
+    const slash = value.indexOf('/');
+    if (slash <= 0 || slash === value.length - 1)
+        throw new Error('--model must use provider/model syntax, for example openai/gpt-5');
+    const provider = value.slice(0, slash).trim();
+    const id = value.slice(slash + 1).trim();
+    if (!provider || !id)
+        throw new Error('--model must use provider/model syntax, for example openai/gpt-5');
+    return { provider, id };
+}
+function parseThinkingOverride(value) { return value === undefined ? undefined : parsePiboThinkingLevel(value); }
+function applyRuntimeCreateOptions(input, options) {
+    const modelOverride = parseModelOverride(options.model);
+    const thinkingLevel = parseThinkingOverride(options.thinking);
+    if (modelOverride)
+        input.modelOverride = modelOverride;
+    if (thinkingLevel)
+        input.thinkingLevel = thinkingLevel;
+    if (options.fast !== undefined)
+        input.fastMode = options.fast;
+}
+function applyRuntimePatchOptions(patch, options) {
+    if (options.model !== undefined && options.clearModel)
+        throw new Error('Choose either --model or --clear-model, not both');
+    if (options.thinking !== undefined && options.clearThinking)
+        throw new Error('Choose either --thinking or --clear-thinking, not both');
+    if (options.fast !== undefined && options.clearFast)
+        throw new Error('Choose either --fast/--no-fast or --clear-fast, not both');
+    if (options.clearModel)
+        patch.modelOverride = null;
+    else if (options.model !== undefined)
+        patch.modelOverride = parseModelOverride(options.model);
+    if (options.clearThinking)
+        patch.thinkingLevel = null;
+    else if (options.thinking !== undefined)
+        patch.thinkingLevel = parseThinkingOverride(options.thinking);
+    if (options.clearFast)
+        patch.fastMode = null;
+    else if (options.fast !== undefined)
+        patch.fastMode = options.fast;
+}
+function templatePatch(id) {
+    if (!id)
+        return {};
+    const template = getLoopJobTemplate(id);
+    if (!template)
+        throw new Error(`Unknown Loop template: ${id}`);
+    return { mode: template.job.mode, name: template.job.name, description: template.job.description, prompt: template.job.prompt, maxIterations: template.job.maxIterations ?? null, stopPolicy: template.job.stopPolicy ?? null };
+}
+function compactResourceText(value, max = 80) { return value.length <= max ? value : `${value.slice(0, max - 1)}…`; }
+function shellToken(value) { return /^[A-Za-z0-9._:@/-]+$/.test(value) ? value : `'${value.replace(/'/g, `'"'"'`)}'`; }
+export function formatLoopResourceSummary(resources) {
+    if (!resources)
+        return '-';
+    const parts = [
+        resources.workerId ? `worker=${resources.workerId}` : undefined,
+        resources.cleanupState ? `state=${resources.cleanupState}` : undefined,
+        resources.browserLeaseIds?.length ? `leases=${resources.browserLeaseIds.length}` : undefined,
+        resources.retainedUntil ? `retainedUntil=${resources.retainedUntil}` : undefined,
+        resources.dirtyReason ? `dirty=${compactResourceText(resources.dirtyReason)}` : undefined,
+    ].filter((part) => !!part);
+    if (resources.cleanupState === 'dirty')
+        parts.push(`next=${resources.workerId ? `pibo tools browser-use pool reap --worker-id ${shellToken(resources.workerId)} --json` : 'pibo compute reap --dry-run'}`);
+    else if (resources.cleanupState === 'retained')
+        parts.push('next=pibo compute reap --dry-run --include-dev');
+    return parts.length ? parts.join(';') : '-';
+}
+function formatLoopJobLine(job) {
+    const goal = job.mode === 'goal' ? job.state.goalStatus ?? (job.enabled ? 'active' : 'paused') : '-';
+    const budget = job.mode === 'goal' ? job.tokenBudget === undefined ? 'unbounded' : `soft:${job.state.tokensUsed ?? 0}/${job.tokenBudget};reserve=${job.tokenReserve ?? 0}` : '-';
+    const time = job.mode === 'goal' ? `activeAgent=${goalActiveTimeSeconds(job)}s;elapsedWall=${goalElapsedWallClockSeconds(job)}s;paused=included` : '-';
+    return `${job.id}\t${job.mode}\t${job.enabled ? 'running' : 'stopped'}\t${job.state.runningAt ? 'active' : '-'}\tgoal=${goal}\tbudget=${budget}\ttime=${time}\tresources=${formatLoopResourceSummary(job.resources)}\t${job.name}`;
+}
+function formatLoopRunLine(run) {
+    const accounting = run.accounting ? `tokens=${run.accounting.tokensUsed ?? 0};remainingBefore=${run.accounting.remainingTokensBefore ?? 'unbounded'};overshoot=${run.accounting.overshootTokens ?? 0};activeAgent=${run.accounting.activeTimeSeconds ?? 0}s` : '-';
+    return `${run.id}\t${run.jobId}\t${run.status}\t${run.piboSessionId ?? '-'}\t${run.completedAt ?? '-'}\taccounting=${accounting}\tresources=${formatLoopResourceSummary(run.resources)}`;
+}
+export async function runLoopCli(argv = process.argv, defaults = {}) {
+    const program = new Command();
+    program.name(defaults.commandName ?? 'pibo loop').description('Manage continuous Pibo loops').helpOption('-h, --help');
+    program.option('--store <path>', 'Loop store path');
+    program.command('status').description('Show Loop store status').option('--json', 'Print JSON').action((options) => { const store = createDefaultPiboLoopStore({ path: program.opts().store }); const status = store.status(); if (options.json)
+        printJson(status);
+    else {
+        console.log(`jobs\t${status.jobs}`);
+        console.log(`running\t${status.running}`);
+    } store.close(); });
+    program.command('list').description('List Loop jobs').option('--all', 'Include stopped jobs').option('--json', 'Print JSON').action((options) => { const store = createDefaultPiboLoopStore({ path: program.opts().store }); const jobs = store.listJobs({ includeDisabled: options.all }); if (options.json)
+        printJson(jobs);
+    else
+        for (const job of jobs)
+            console.log(formatLoopJobLine(job)); store.close(); });
+    program.command('add').description(defaults.mode === 'ralph' ? 'Create a Ralph job' : 'Create a Loop job').option('--template <id>', 'Built-in job template id').option('--mode <mode>', 'Loop mode: goal or ralph').option('--prompt <text>', 'Task prompt').option('--name <name>', 'Job name').option('--description <text>', 'Job description').option('--profile <profile>', 'Agent profile', DEFAULT_PIBO_PROFILE_NAME).option('--room <room-id>', 'Target room id').option('--default-chat', 'Target the shared default chat').option('--max-iterations <n>', 'Stop after n completed run attempts').option('--token-budget <n>', 'Set a soft Goal token budget; the final turn can overshoot').option('--token-reserve <n>', 'Require more than n tokens to remain before starting another Goal turn').option('--model <provider/model>', 'Runtime model override, for example openai/gpt-5').option('--thinking <level>', 'Runtime thinking level override: off, minimal, low, medium, high, xhigh, max').option('--fast', 'Enable runtime fast mode').option('--no-fast', 'Disable runtime fast mode')
+        .option('--start', 'Start immediately').option('--json', 'Print JSON').action((options) => { const base = templatePatch(options.template); const prompt = options.prompt ?? base.prompt; if (typeof prompt !== 'string' || !prompt.trim())
+        throw new Error('Choose --template <id> or provide --prompt <text>'); const input = { mode: loopMode(options.mode) ?? base.mode ?? defaults.mode ?? 'goal', name: options.name ?? base.name, description: options.description ?? base.description, enabled: options.start === true, target: targetFromOptions(options), profile: options.profile, prompt, maxIterations: options.maxIterations !== undefined ? maxIterations(options.maxIterations) : typeof base.maxIterations === 'number' ? base.maxIterations : undefined, tokenBudget: tokenBudget(options.tokenBudget), tokenReserve: tokenReserve(options.tokenReserve), stopPolicy: base.stopPolicy ?? undefined }; applyRuntimeCreateOptions(input, options); const store = createDefaultPiboLoopStore({ path: program.opts().store }); const job = store.createJob(input); if (options.json)
+        printJson(job);
+    else
+        console.log(`${job.id}\t${job.enabled ? 'running' : 'stopped'}\t${job.name}`); store.close(); });
+    program.command('edit').argument('<id>', defaults.mode === 'ralph' ? 'Ralph job id' : 'Loop job id').description(defaults.mode === 'ralph' ? 'Update a Ralph job' : 'Update a Loop job').option('--template <id>', 'Apply a built-in job template before explicit overrides').option('--mode <mode>', 'Set loop mode: goal or ralph').option('--prompt <text>', 'Task prompt').option('--name <name>', 'Job name').option('--description <text>', 'Job description').option('--profile <profile>', 'Agent profile').option('--room <room-id>', 'Target room id').option('--default-chat', 'Target the shared default chat').option('--max-iterations <n>', 'Stop after n completed run attempts').option('--token-budget <n>', 'Set soft Goal token budget').option('--clear-token-budget', 'Clear Goal token budget').option('--token-reserve <n>', 'Set pre-turn minimum remaining tokens').option('--clear-token-reserve', 'Clear Goal token reserve').option('--model <provider/model>', 'Set runtime model override, for example openai/gpt-5').option('--clear-model', 'Clear runtime model override').option('--thinking <level>', 'Set runtime thinking level override: off, minimal, low, medium, high, xhigh, max').option('--clear-thinking', 'Clear runtime thinking level override').option('--fast', 'Enable runtime fast mode').option('--no-fast', 'Disable runtime fast mode').option('--clear-fast', 'Clear runtime fast mode override').option('--json', 'Print JSON').action((id, options) => { const store = createDefaultPiboLoopStore({ path: program.opts().store }); const patch = { ...templatePatch(options.template) }; if (options.mode !== undefined)
+        patch.mode = loopMode(options.mode); if (options.name !== undefined)
+        patch.name = options.name; if (options.description !== undefined)
+        patch.description = options.description; if (options.profile !== undefined)
+        patch.profile = options.profile; if (options.prompt !== undefined)
+        patch.prompt = options.prompt; if (options.maxIterations !== undefined)
+        patch.maxIterations = maxIterations(options.maxIterations); if (options.tokenBudget !== undefined && options.clearTokenBudget)
+        throw new Error('Choose either --token-budget or --clear-token-budget, not both'); if (options.clearTokenBudget)
+        patch.tokenBudget = null;
+    else if (options.tokenBudget !== undefined)
+        patch.tokenBudget = tokenBudget(options.tokenBudget); if (options.tokenReserve !== undefined && options.clearTokenReserve)
+        throw new Error('Choose either --token-reserve or --clear-token-reserve, not both'); if (options.clearTokenReserve)
+        patch.tokenReserve = null;
+    else if (options.tokenReserve !== undefined)
+        patch.tokenReserve = tokenReserve(options.tokenReserve); applyRuntimePatchOptions(patch, options); const target = maybeTargetFromOptions(options); if (target)
+        patch.target = target; if (Object.keys(patch).length === 0)
+        throw new Error('No Loop job update fields provided'); const job = store.updateJob(id, patch); if (!job)
+        throw new Error('Loop job not found'); if (options.json)
+        printJson(job);
+    else
+        console.log(`${job.id}\tupdated\t${job.name}`); store.close(); });
+    program.command('conditions').description('List built-in Loop stop-condition types').option('--json', 'Print JSON').action((options) => { const conditions = createBuiltInLoopStopConditions().map((condition) => ({ type: condition.type, name: condition.name, description: condition.description, phases: condition.phases, defaultOptions: condition.defaultOptions, optionsSchema: condition.optionsSchema })); if (options.json)
+        printJson(conditions);
+    else
+        for (const condition of conditions)
+            console.log(`${condition.type}	${condition.phases.join(',')}	${condition.name}`); });
+    program.command('templates').description('List built-in Loop job templates').option('--json', 'Print JSON').action((options) => { const templates = listLoopJobTemplates(); if (options.json)
+        printJson(templates);
+    else
+        for (const template of templates)
+            console.log(`${template.id}\t${template.category}\t${template.name}\t${template.description}`); });
+    const policy = program.command('policy').description('Manage a Loop job stop policy');
+    policy.command('show').argument('<id>').option('--json', 'Print JSON').action((id, options) => { const store = createDefaultPiboLoopStore({ path: program.opts().store }); const job = store.getJob(id); if (!job)
+        throw new Error('Loop job not found'); const value = job.stopPolicy ?? null; if (options.json)
+        printJson(value);
+    else
+        console.log(value ? JSON.stringify(value, null, 2) : 'default'); store.close(); });
+    policy.command('set').argument('<id>').requiredOption('--file <path>', 'JSON stop policy file').option('--json', 'Print JSON').action((id, options) => { const store = createDefaultPiboLoopStore({ path: program.opts().store }); const stopPolicy = JSON.parse(readFileSync(options.file, 'utf8')); const job = store.updateJob(id, { stopPolicy }); if (!job)
+        throw new Error('Loop job not found'); if (options.json)
+        printJson(job);
+    else
+        console.log(`${job.id}	policy-updated	${job.name}`); store.close(); });
+    policy.command('clear').argument('<id>').option('--json', 'Print JSON').action((id, options) => { const store = createDefaultPiboLoopStore({ path: program.opts().store }); const job = store.updateJob(id, { stopPolicy: null }); if (!job)
+        throw new Error('Loop job not found'); if (options.json)
+        printJson(job);
+    else
+        console.log(`${job.id}	policy-cleared	${job.name}`); store.close(); });
+    program.command('start').argument('<id>').description('Mark a Loop job running; the gateway service starts the next session').option('--json', 'Print JSON').action((id, options) => { const store = createDefaultPiboLoopStore({ path: program.opts().store }); const job = store.updateJob(id, { enabled: true }); if (!job)
+        throw new Error('Loop job not found'); if (options.json)
+        printJson(job);
+    else
+        console.log(`${job.id}\trunning\t${job.name}`); store.close(); });
+    program.command('stop').argument('<id>').description('Stop after the current session finishes').option('--json', 'Print JSON').action((id, options) => { const store = createDefaultPiboLoopStore({ path: program.opts().store }); const job = store.requestStop(id); if (!job)
+        throw new Error('Loop job not found'); if (options.json)
+        printJson(job);
+    else
+        console.log(`${job.id}\tstopping\t${job.name}`); store.close(); });
+    program.command('cancel').argument('<id>').description('Abort the current session and stop').option('--json', 'Print JSON').action((id, options) => { const store = createDefaultPiboLoopStore({ path: program.opts().store }); const job = store.requestCancel(id); if (!job)
+        throw new Error('Loop job not found'); if (options.json)
+        printJson(job);
+    else
+        console.log(`${job.id}\tcancel-requested\t${job.name}`); store.close(); });
+    program.command('remove').argument('<id>').description('Delete a Loop job').option('--json', 'Print JSON').action((id, options) => { const store = createDefaultPiboLoopStore({ path: program.opts().store }); const removed = store.removeJob(id); if (options.json)
+        printJson({ removed });
+    else
+        console.log(removed ? 'removed' : 'not found'); store.close(); });
+    program.command('runs').description('List Loop runs').option('--job <id>', 'Filter by job').option('--json', 'Print JSON').action((options) => { const store = createDefaultPiboLoopStore({ path: program.opts().store }); const runs = store.listRuns({ jobId: options.job }); if (options.json)
+        printJson(runs);
+    else
+        for (const run of runs)
+            console.log(formatLoopRunLine(run)); store.close(); });
+    if (argv.length <= 2 || (argv.length === 3 && (argv[2] === '--help' || argv[2] === '-h'))) {
+        printDiscovery(defaults.commandName, defaults.mode === 'ralph');
+        return;
+    }
+    await program.parseAsync(argv);
+}

package/dist/loops/plugin.js

@@ -0,0 +1,16 @@
+import { definePiboPlugin } from '../plugins/registry.js';
+import { createPiboLoopChannel } from './channel.js';
+import { createBuiltInLoopStopConditions } from './stopping.js';
+import { configurePiboGoalToolStorePath } from './tools.js';
+export function createPiboLoopPlugin(options = {}) {
+    configurePiboGoalToolStorePath(options.loopStorePath);
+    return definePiboPlugin({
+        id: 'pibo.loop',
+        name: 'Pibo Loop',
+        register(api) {
+            for (const condition of createBuiltInLoopStopConditions())
+                api.registerLoopStopCondition(condition);
+            api.registerChannel(createPiboLoopChannel(options));
+        },
+    });
+}