@pasko70/pibo 1.9.11 → 1.10.0

package/dist/resources/reaper.js

@@ -9,6 +9,7 @@ export class ResourceReaperService {
     plan;
     apply;
     now;
+    writeState;
     timer;
     running = false;
     stopped = true;
@@ -23,6 +24,7 @@ export class ResourceReaperService {
         this.plan = options.plan ?? planResourceReap;
         this.apply = options.apply ?? applyResourceReapPlan;
         this.now = options.clock ?? (() => new Date());
+        this.writeState = options.writeState ?? writeResourceReaperState;
     }
     async start() {
         if (!this.stopped)
@@ -47,19 +49,24 @@ export class ResourceReaperService {
         if (this.timer)
             clearTimeout(this.timer);
         this.timer = undefined;
-        if (this.state && this.ownsTimer) {
-            this.state = { ...this.state, status: "stopped", nextRunAt: undefined };
-            await this.persist();
+        try {
+            if (this.state && this.ownsTimer) {
+                this.state = { ...this.state, status: "stopped", nextRunAt: undefined };
+                await this.persist();
+            }
+        }
+        finally {
+            if (this.ownsTimer)
+                await releaseResourceReaperOwnership(this.lockPath);
+            this.ownsTimer = false;
         }
-        if (this.ownsTimer)
-            await releaseResourceReaperOwnership(this.lockPath);
-        this.ownsTimer = false;
     }
     async runNow() {
         if (!this.ownsTimer || this.running)
             return undefined;
         this.running = true;
         const runAt = this.now();
+        let result;
         try {
             const plan = await this.plan({
                 includeDev: this.options.includeDev,
@@ -71,7 +78,7 @@ export class ResourceReaperService {
                 exemptBrowserPids: this.options.exemptBrowserPids,
                 now: runAt,
             });
-            const result = await this.apply(plan);
+            result = await this.apply(plan);
             this.state = {
                 ...(this.state ?? {
                     status: "running",
@@ -91,8 +98,6 @@ export class ResourceReaperService {
                 lastError: undefined,
             };
             console.error(JSON.stringify({ event: "resource_reaper_finished", at: runAt.toISOString(), ...this.state.lastResult }));
-            await this.persist();
-            return result;
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
@@ -109,12 +114,16 @@ export class ResourceReaperService {
                 lastError: message,
             };
             console.error(JSON.stringify({ event: "resource_reaper_failed", at: runAt.toISOString(), error: message }));
-            await this.persist();
-            return undefined;
         }
         finally {
-            this.running = false;
+            try {
+                await this.persist();
+            }
+            finally {
+                this.running = false;
+            }
         }
+        return result;
     }
     arm(delayMs) {
         if (this.stopped)
@@ -122,13 +131,32 @@ export class ResourceReaperService {
         if (this.timer)
             clearTimeout(this.timer);
         this.timer = setTimeout(() => {
-            void this.runNow().finally(() => this.arm(this.intervalMs));
+            void this.runNow()
+                .catch((error) => {
+                console.error(JSON.stringify({
+                    event: "resource_reaper_timer_failed",
+                    at: new Date().toISOString(),
+                    error: error instanceof Error ? error.message : String(error),
+                }));
+            })
+                .finally(() => this.arm(this.intervalMs));
         }, delayMs);
         this.timer.unref?.();
     }
     async persist() {
-        if (this.state)
-            await writeResourceReaperState(this.statePath, this.state);
+        if (!this.state)
+            return;
+        try {
+            await this.writeState(this.statePath, this.state);
+        }
+        catch (error) {
+            console.error(JSON.stringify({
+                event: "resource_reaper_state_persist_failed",
+                at: new Date().toISOString(),
+                path: this.statePath,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        }
     }
 }
 function readPositiveInteger(value) {

package/dist/shared/trace-engine.js

@@ -1,5 +1,5 @@
 import { reconcileAsyncAgentRunStatuses } from "./trace-async-agent-runs.js";
-import { applySingleEventToNodes, contentDeltaPatchNodeId, dedupeTraceEvents, eventsCanAffectAsyncAgentRunStatus, findOpenTranscriptEventIds, isConfirmedUserMessageEcho, latestTraceStreamId, messageTurnTimingsFromEvents, reconcileTranscriptUserMessageTimestamps, traceEventDedupeKey, } from "./trace-event-projection.js";
+import { applySingleEventToNodes, contentDeltaPatchNodeId, dedupeTraceEvents, eventsCanAffectAsyncAgentRunStatus, findOpenTranscriptEventIds, isConfirmedUserMessageEcho, latestTraceStreamId, mergeMessageTurnTimings, messageTurnTimingsFromEvents, reconcileTranscriptUserMessageTimestamps, traceEventDedupeKey, } from "./trace-event-projection.js";
 import { flattenTraceNodes, mapTraceNodesById, nestTraceNodes } from "./trace-nodes.js";
 import { nestMutableCopiedTraceNodes, shareUnchangedTraceNodes } from "./trace-patch-nodes.js";
 import { mapTraceChildSessionsByParent, mapTraceSubagentSessionLinks, } from "./trace-subagent-links.js";
@@ -14,7 +14,8 @@ export function buildTraceViewFromEvents(input) {
     const allEntries = input.transcriptEntries ?? [];
     const openTranscriptEventIds = findOpenTranscriptEventIds(events, sessionStatus);
     const entries = projectTranscriptEntries(allEntries, sessionStatus, openTranscriptEventIds);
-    const nodes = traceNodesFromEntries(input.session.id, entries, messageTurnTimingsFromEvents(events));
+    const turnTimings = mergeMessageTurnTimings(input.turnTimings ?? [], messageTurnTimingsFromEvents(events));
+    const nodes = traceNodesFromEntries(input.session.id, entries, turnTimings);
     reconcileTranscriptUserMessageTimestamps(nodes, events);
     const byId = mapTraceNodesById(nodes);
     const childByParent = mapTraceChildSessionsByParent(input.sessions ?? []);

package/dist/shared/trace-event-projection.js

@@ -531,6 +531,32 @@ function shouldKeepTranscriptEchoEvent(event, openTranscriptEventIds) {
 function isStaleToolCallEchoEvent(event, sessionStatus) {
     return sessionStatus !== "running" && event.type === "tool_call";
 }
+export function mergeMessageTurnTimings(...groups) {
+    const byEventId = new Map();
+    for (const timing of groups.flat()) {
+        const existing = byEventId.get(timing.eventId);
+        if (!existing) {
+            byEventId.set(timing.eventId, timing);
+            continue;
+        }
+        const merged = {
+            eventId: timing.eventId,
+            userText: timing.userText ?? existing.userText,
+            startedAt: timing.startedAt ?? existing.startedAt,
+            completedAt: timing.completedAt ?? existing.completedAt,
+            durationMs: timing.durationMs ?? existing.durationMs,
+        };
+        if (merged.durationMs === undefined) {
+            const startedAtMs = parseTimestamp(merged.startedAt);
+            const completedAtMs = parseTimestamp(merged.completedAt);
+            if (startedAtMs !== undefined && completedAtMs !== undefined) {
+                merged.durationMs = Math.max(0, completedAtMs - startedAtMs);
+            }
+        }
+        byEventId.set(timing.eventId, merged);
+    }
+    return [...byEventId.values()];
+}
 export function messageTurnTimingsFromEvents(events) {
     const timings = new Map();
     const completedEventIds = [];

package/dist/tools/guides.js

@@ -1,3 +1,54 @@
+export const LOOP_GUIDE = {
+    name: 'loop',
+    description: 'Create, inspect, and control Pibo Goal and legacy Ralph loops from the CLI.',
+    content: `---
+name: loop
+description: Creates and controls persistent Goal Loops and legacy fresh-session Ralph loops.
+allowed-tools: Bash(pibo:*), Bash(npm:*)
+---
+
+# Loop CLI Tool
+
+Use \`pibo loop\` as the standard continuous-work CLI. Goal mode is the default and continues one Pibo Session across turns. Use \`--mode ralph\` or \`pibo ralph\` only for legacy fresh-session runs.
+
+## Discover
+
+\`\`\`bash
+pibo loop --help
+pibo loop add --help
+pibo loop templates --json
+pibo loop conditions
+\`\`\`
+
+## Create a Goal Loop
+
+\`\`\`bash
+pibo loop add \\
+  --room <room-id> \\
+  --profile <profile> \\
+  --prompt "<complete objective>" \\
+  --token-budget <optional-positive-token-count> \\
+  --max-iterations <optional-run-fallback> \\
+  --start
+\`\`\`
+
+Goal-capable agents use native \`get_goal\`, \`create_goal\`, and \`update_goal\` tools. Agent Designer can disable the default-enabled \`pibo-goal-control\` package.
+
+Use \`update_goal\` with \`complete\` only after current evidence proves every requirement. Use \`blocked\` only after the same impasse repeats for at least three consecutive Goal turns and progress requires user input or external change.
+
+## Inspect and Control
+
+\`\`\`bash
+pibo loop list --all --json
+pibo loop runs --job <job-id> --json
+pibo loop start <job-id>
+pibo loop stop <job-id>
+pibo loop cancel <job-id>
+\`\`\`
+
+Token budgets count usage reported by completed assistant model messages. One request can overshoot because usage is known after the response returns.
+`,
+};
 export const RALPH_GUIDE = {
     name: 'ralph',
     description: 'Create, inspect, and control Pibo Ralph jobs from the CLI.',

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');
@@ -600,6 +604,21 @@ Next:
   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
 
@@ -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')

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.',
         ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pasko70/pibo",
-  "version": "1.9.11",
+  "version": "1.10.0",
   "type": "module",
   "imports": {
     "vscode": "./src/apps/chat-vscode/extension/src/vscode-shim.js"
@@ -56,6 +56,8 @@
     "@earendil-works/pi-ai": "0.80.6",
     "@earendil-works/pi-coding-agent": "0.80.6",
     "@earendil-works/pi-tui": "0.80.6",
+    "@langchain/core": "^1.2.3",
+    "@langchain/langgraph": "^1.4.8",
     "@mdxeditor/editor": "^3.55.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@tailwindcss/vite": "^4.2.4",
@@ -76,7 +78,8 @@
     "react-markdown": "^10.1.0",
     "react-virtuoso": "^4.18.6",
     "remark-gfm": "^4.0.1",
-    "tailwindcss": "^4.2.4"
+    "tailwindcss": "^4.2.4",
+    "zod": "4.4.1"
   },
   "devDependencies": {
     "@tanstack/router-plugin": "^1.167.28",

package/skills/builtin/loop/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: loop
+description: Plan, create, run, monitor, resume, and review Pibo Goal Loops and legacy Ralph loops. Use whenever the user asks for a persistent goal, continuous loop, autonomous multi-turn objective, token-budgeted goal, Loop job, Goal status, blocked Goal, or the pibo loop CLI.
+---
+
+# Pibo Loop Workflow
+
+Use Goal mode for persistent objectives that should continue in the same Pibo Session. Use legacy Ralph mode only when each run should start with fresh session context.
+
+Discover the live CLI progressively:
+
+```bash
+pibo loop --help
+pibo loop add --help
+pibo loop templates --json
+pibo loop conditions
+```
+
+## Goal lifecycle
+
+Goal-capable profiles expose native tools:
+
+- `get_goal`: inspect authoritative status, objective, token budget, tokens used, remaining tokens, and elapsed active time.
+- `create_goal`: create a persistent Goal only when the user or system explicitly requests one.
+- `update_goal`: mark the current Goal `complete` after a strict completion audit, or `blocked` after the same impasse repeats for at least three consecutive Goal turns.
+
+These are native Pibo tools, not MCP tools. Agent Designer exposes them as the default-enabled `pibo-goal-control` package. If that package is disabled, the agent cannot change Goal lifecycle status itself.
+
+## CLI creation
+
+```bash
+pibo loop add \
+  --room <room-id> \
+  --profile <profile> \
+  --prompt "<complete objective>" \
+  --token-budget <optional-positive-token-count> \
+  --max-iterations <optional-run-fallback> \
+  --start
+```
+
+Prefer creating the job stopped when its prompt, target, profile, or safety boundaries still need review.
+
+## Completion and blocked rules
+
+- Treat completion as unproven until current evidence covers every explicit requirement and deliverable.
+- Do not use `complete` for partial progress, a plausible result, budget exhaustion, or because the current turn is ending.
+- Do not use `blocked` on the first blocker occurrence.
+- Use `blocked` only after the same condition repeats for at least three consecutive Goal turns and meaningful progress requires user input or an external-state change.
+- Resuming a blocked Goal begins a fresh blocked audit.
+
+## Token budgets
+
+Pibo accumulates model usage reported by completed assistant model messages. A Goal becomes `budget_limited` when reported usage reaches or exceeds its budget. One provider request can overshoot because usage is known only after the response reports it.
+
+Increase or clear the token budget before resuming a budget-limited Goal.
+
+## Operations
+
+```bash
+pibo loop list --all --json
+pibo loop runs --job <job-id> --json
+pibo loop start <job-id>
+pibo loop stop <job-id>
+pibo loop cancel <job-id>
+```
+
+Use `stop` for graceful pause after the current session. Use `cancel` only when the active session must be aborted.
+
+For implementation work involving Docker workers, worktrees, browser checks, or pull requests, also use `pibo-docker-system` and `github-server-flow`.

package/skills/builtin/ralph-loop/SKILL.md

@@ -1,11 +1,13 @@
 ---
 name: ralph-loop
-description: Plan, create, run, monitor, and review Ralph implementation loops with reusable Docker workers, git worktrees, PRD batches, stop policies, maxIterations, progress files, commits, and safe agent instructions. Use whenever the user wants to start a Ralph job, run an implementation loop, prepare autonomous PRD execution, monitor Ralph, debug Ralph job behavior, or capture the standard Ralph loop workflow.
+description: Plan, create, run, monitor, and review legacy Ralph fresh-session implementation loops. Use when the user explicitly asks for Ralph compatibility, Ralph PRD batches, or a new Pibo Session per run; use the loop skill for standard persistent Goal Loops.
 ---
 
 # Ralph Loop Workflow
 
-Use this skill to create and operate a Ralph implementation loop safely. Ralph runs repeated Pibo agent sessions against an objective, usually from PRD stories. The core pattern is:
+Use this skill to create and operate a legacy Ralph implementation loop safely. Ralph starts a fresh Pibo Session for each run. For new same-session persistent goals, use the `loop` skill and `pibo loop` instead.
+
+Ralph runs repeated Pibo agent sessions against an objective, usually from PRD stories. The core pattern is:
 
 1. Prepare a clean git worktree.
 2. Reuse a dedicated Docker dev worker for runtime, builds, tests, gateway, and browser checks.