npm - @pasko70/pibo - Versions diffs - 1.10.0 → 1.10.1 - Mend

@pasko70/pibo 1.10.0 → 1.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (54) hide show

package/dist/apps/chat/chat-request-normalizers.js +7 -0
package/dist/apps/chat/data/chat-data-mappers.js +2 -0
package/dist/apps/chat/loop-api.js +11 -6
package/dist/apps/chat/web-app.js +30 -10
package/dist/apps/chat-ui/assets/{dist-LHRs1Nhr.js → dist-3Sts0Afa.js} +1 -1
package/dist/apps/chat-ui/assets/{dist-wE9nop9V.js → dist-4NlLjLs7.js} +1 -1
package/dist/apps/chat-ui/assets/{dist-BwKObYnX.js → dist-BA6mhAec.js} +1 -1
package/dist/apps/chat-ui/assets/{dist-Y-AA2omI.js → dist-BPl-fzRB.js} +1 -1
package/dist/apps/chat-ui/assets/{dist-GdEM8UW1.js → dist-BPnn9e2B.js} +1 -1
package/dist/apps/chat-ui/assets/{dist-DlATLa-U.js → dist-BpfBSMzK.js} +1 -1
package/dist/apps/chat-ui/assets/{dist-CS7wdk0Z.js → dist-Cvx5M97R.js} +1 -1
package/dist/apps/chat-ui/assets/{dist-nOLTkZrJ.js → dist-DnXWNQRm.js} +1 -1
package/dist/apps/chat-ui/assets/{dist-DUlaXAk7.js → dist-hU-2oAb6.js} +1 -1
package/dist/apps/chat-ui/assets/{dist-CKtT8YGm.js → dist-r31x5Fcc.js} +1 -1
package/dist/apps/chat-ui/assets/{dist-D-cxLQO1.js → dist-uF6UXzI7.js} +1 -1
package/dist/apps/chat-ui/assets/index-CaTGYBOS.js +173 -0
package/dist/apps/chat-ui/assets/{index-C0x9nEcf.css → index-al8DeEjA.css} +1 -1
package/dist/apps/chat-ui/index.html +2 -2
package/dist/apps/chat-vscode-web/assets/index-CK4SMZuu.js +41 -0
package/dist/apps/chat-vscode-web/index.html +1 -1
package/dist/cli-session/localSessionSource.js +34 -12
package/dist/compute/resource-health.js +35 -2
package/dist/core/events.js +6 -1
package/dist/core/routed-session.js +67 -4
package/dist/core/session-router.js +23 -6
package/dist/data/ingest-service.js +3 -1
package/dist/debug/index.js +4 -0
package/dist/debug/trace.js +42 -7
package/dist/index.js +1 -0
package/dist/loops/accounting.js +19 -0
package/dist/loops/cli.js +22 -6
package/dist/loops/prompts.js +4 -1
package/dist/loops/service.js +97 -8
package/dist/loops/store.js +128 -17
package/dist/loops/tools.js +24 -7
package/dist/reliability/store.js +34 -7
package/dist/runs/lifecycle.js +59 -0
package/dist/runs/registry.js +47 -1
package/dist/runs/tools.js +31 -13
package/dist/session-ui/terminalRows.js +66 -2
package/dist/shared/trace-async-agent-runs.js +4 -4
package/dist/shared/trace-event-projection.js +59 -19
package/dist/shared/trace-nodes.js +5 -0
package/dist/shared/trace-page-merge.js +15 -0
package/dist/shared/trace-run-notifications.js +3 -1
package/dist/signals/projector.js +6 -2
package/dist/tools/browser-pool.js +50 -0
package/dist/tools/browser-use-leases.js +12 -8
package/dist/tools/guides.js +8 -1
package/dist/tools/index.js +1 -0
package/package.json +2 -1
package/skills/builtin/loop/SKILL.md +12 -3
package/dist/apps/chat-ui/assets/index-8W_yMHQI.js +0 -173
package/dist/apps/chat-vscode-web/assets/index-BAMxIaI_.js +0 -41

package/dist/apps/chat-vscode-web/index.html CHANGED Viewed

@@ -5,7 +5,7 @@
 		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
 		<meta name="theme-color" content="#101d22" />
 		<title>Pibo</title>
-		<script type="module" crossorigin src="/apps/chat-vscode/assets/index-BAMxIaI_.js"></script>
+		<script type="module" crossorigin src="/apps/chat-vscode/assets/index-CK4SMZuu.js"></script>
 		<link rel="stylesheet" crossorigin href="/apps/chat-vscode/assets/index-B5QK07zO.css">
 	</head>
 	<body>

package/dist/cli-session/localSessionSource.js CHANGED Viewed

@@ -29,6 +29,8 @@ export class LocalCliSessionSource {
     listeners = new Map();
     openHandles = new Set();
     closed = false;
+    closing = false;
+    closePromise;
     constructor(options = {}) {
         this.sessionStore =
             options.sessionStore ?? createDefaultPiboDataSessionStore();
@@ -349,19 +351,39 @@ export class LocalCliSessionSource {
         };
     }
     async close() {
+        if (this.closePromise)
+            return this.closePromise;
+        this.closePromise = this.closeUnsafe();
+        return this.closePromise;
+    }
+    async closeUnsafe() {
         if (this.closed)
             return;
-        this.closed = true;
-        for (const handle of [...this.openHandles])
-            handle.close();
-        this.listeners.clear();
-        this.unsubscribeRouter?.();
-        if (this.ownsRouter)
-            await this.router?.disposeAll?.();
-        if (this.ownsSessionStore)
-            this.sessionStore.close?.();
-        if (this.ownsDataStore)
-            this.dataStore?.close();
+        this.closing = true;
+        let routerError;
+        try {
+            if (this.ownsRouter)
+                await this.router?.disposeAll?.();
+        }
+        catch (error) {
+            routerError = error;
+        }
+        try {
+            this.closed = true;
+            for (const handle of [...this.openHandles])
+                handle.close();
+            this.listeners.clear();
+            this.unsubscribeRouter?.();
+            if (this.ownsSessionStore)
+                this.sessionStore.close?.();
+            if (this.ownsDataStore)
+                this.dataStore?.close();
+        }
+        finally {
+            this.closing = false;
+        }
+        if (routerError)
+            throw routerError;
     }
     listenerCount(sessionId) {
         if (sessionId)
@@ -825,7 +847,7 @@ export class LocalCliSessionSource {
             listener(update);
     }
     assertOpen() {
-        if (this.closed)
+        if (this.closed || this.closing)
             throw new CliSourceError("source_closed", "Local CLI session source is closed");
     }
 }

package/dist/compute/resource-health.js CHANGED Viewed

@@ -73,8 +73,11 @@ export function buildComputeResourceHealth(options = {}) {
             if (browserProcessMatchesPool(process, pool.state))
                 assignedMainPids.add(process.pid);
     }
+    const activeWorkerOwnedMainPids = new Set(mainProcesses
+        .filter((process) => Boolean(findOwningActiveWorker(process, processes, workers)))
+        .map((process) => process.pid));
     const unassignedMainProcessDetails = mainProcesses
-        .filter((process) => !assignedMainPids.has(process.pid))
+        .filter((process) => !assignedMainPids.has(process.pid) && !activeWorkerOwnedMainPids.has(process.pid))
         .map((process) => describeUnassignedBrowserProcess(process, workers));
     const unassignedChromiumMainProcesses = unassignedMainProcessDetails.length;
     const activePoolIds = perWorker.filter((pool) => pool.activeLeaseCount > 0).map((pool) => `${pool.workerId}/${pool.poolId}`);
@@ -148,6 +151,28 @@ function browserLeakMessage(unassignedCount) {
         return `${unassignedCount} unmanaged Chromium main process(es) are not associated with a managed browser pool.`;
     return "Chromium main-process count exceeds managed pool expectations.";
 }
+function findOwningActiveWorker(process, processes, workers) {
+    const containerId = process.containerId;
+    if (containerId && containerId.length >= 12) {
+        const byContainer = workers.find((worker) => worker.state === "running" && (worker.id === containerId || worker.id.startsWith(containerId) || containerId.startsWith(worker.id)));
+        if (byContainer)
+            return byContainer;
+    }
+    const activeWorkersByPid = new Map(workers
+        .filter((worker) => worker.state === "running" && worker.hostPid !== undefined && worker.hostPid > 1)
+        .map((worker) => [worker.hostPid, worker]));
+    const processByPid = new Map(processes.map((candidate) => [candidate.pid, candidate]));
+    const visited = new Set();
+    let current = process;
+    while (current && current.pid > 1 && !visited.has(current.pid)) {
+        visited.add(current.pid);
+        const direct = activeWorkersByPid.get(current.pid) ?? activeWorkersByPid.get(current.ppid);
+        if (direct)
+            return direct;
+        current = processByPid.get(current.ppid);
+    }
+    return undefined;
+}
 function describeUnassignedBrowserProcess(process, workers) {
     const worker = workers.find((candidate) => candidate.hostPid !== undefined && candidate.hostPid > 0 && candidate.hostPid === process.ppid);
     const userDataDir = readChromeArg(process.args, "user-data-dir");
@@ -248,7 +273,12 @@ async function collectWorkers() {
 async function collectProcesses() {
     try {
         const { stdout } = await execFileAsync("ps", ["-eo", "pid=,ppid=,pgid=,etimes=,comm=,args="], { maxBuffer: 10 * 1024 * 1024 });
-        return { processes: parseProcessList(stdout) };
+        const processes = parseProcessList(stdout);
+        await Promise.all(processes.filter((process) => process.isChromium && process.isMainProcess).map(async (process) => {
+            const cgroup = await readFile(`/proc/${process.pid}/cgroup`, "utf8").catch(() => "");
+            process.containerId = parseDockerContainerIdFromCgroup(cgroup);
+        }));
+        return { processes };
     }
     catch (error) {
         return { processes: [], error: error instanceof Error ? error.message : String(error) };
@@ -299,6 +329,9 @@ function detectReaperTimerStatus() {
     }
     return readResourceReaperTimerStatus();
 }
+export function parseDockerContainerIdFromCgroup(value) {
+    return value.match(/(?:^|\/)docker[-/]([a-f0-9]{12,64})(?:\.scope|\/|$)/im)?.[1];
+}
 function browserProcessMatchesPool(process, state) {
     if (state.pid && process.pid === state.pid)
         return true;

package/dist/core/events.js CHANGED Viewed

@@ -1 +1,6 @@
-export {};
+export class PiboSteeringUnavailableError extends Error {
+    constructor(message = "The active session cannot accept steering right now.", options) {
+        super(message, options);
+        this.name = "PiboSteeringUnavailableError";
+    }
+}

package/dist/core/routed-session.js CHANGED Viewed

@@ -1,4 +1,5 @@
 import { SessionManager, shouldCompact } from "@earendil-works/pi-coding-agent";
+import { PiboSteeringUnavailableError } from "./events.js";
 import { getOpenAiCodexProviderUsageForActiveModel } from "../auth/openai-codex-usage.js";
 import { normalizeSessionErrorDetails, runtimeSessionErrorDetails } from "./session-errors.js";
 import { expandInlineSkills } from "./skill-expansion.js";
@@ -422,6 +423,8 @@ export class RoutedSession {
     queue = [];
     processing = false;
     disposed = false;
+    disposePromise;
+    drainPromise;
     fastMode = false;
     fastModePatchedAgents = new WeakSet();
     activeMessage;
@@ -683,7 +686,32 @@ export class RoutedSession {
         };
         this.emit(output);
         this.onStateChange?.({ processing: this.processing, queuedMessages: this.queue.length, disposed: this.disposed });
-        void this.drain();
+        this.startDrain();
+        return output;
+    }
+    async steerMessage(event) {
+        this.assertActive();
+        const activeMessage = this.activeMessage;
+        if (!activeMessage || !this.processing || !this.runtime.session.isStreaming) {
+            throw new PiboSteeringUnavailableError();
+        }
+        const session = this.runtime.session;
+        const expandedText = expandInlineSkills(event.text, session.resourceLoader.getSkills().skills);
+        try {
+            await session.steer(expandedText);
+        }
+        catch (error) {
+            throw new PiboSteeringUnavailableError(`The active session could not accept steering: ${errorMessage(error)}`, { cause: error });
+        }
+        const output = {
+            type: "message_steered",
+            piboSessionId: this.piboSessionId,
+            eventId: event.id,
+            activeEventId: activeMessage.id,
+            text: event.text,
+            source: event.source,
+        };
+        this.emit(output);
         return output;
     }
     async executeAction(event) {
@@ -875,9 +903,26 @@ export class RoutedSession {
         return await this.runtime.session.compact(customInstructions);
     }
     async dispose() {
+        if (this.disposePromise)
+            return this.disposePromise;
+        this.disposePromise = this.disposeUnsafe();
+        return this.disposePromise;
+    }
+    async disposeUnsafe() {
         if (this.disposed)
             return;
+        const activeMessage = this.activeMessage;
         this.notifyMessagesInterrupted(this.activeAndQueuedMessages(), "session disposed");
+        if (activeMessage) {
+            const error = "Session disposed while a message was active.";
+            this.emit({
+                type: "session_error",
+                piboSessionId: this.piboSessionId,
+                eventId: activeMessage.id,
+                error,
+                errorDetails: runtimeSessionErrorDetails(error),
+            });
+        }
         this.cancelProviderRecovery();
         this.queue.length = 0;
         this.onStateChange?.({ processing: this.processing, queuedMessages: this.queue.length, disposed: true });
@@ -888,7 +933,15 @@ export class RoutedSession {
             this.recoverySession = undefined;
         }
         this.disposed = true;
-        await this.runtime.dispose();
+        const abort = this.runtime.session.abort;
+        if (abort)
+            await Promise.allSettled([abort.call(this.runtime.session)]);
+        try {
+            await this.drainPromise;
+        }
+        finally {
+            await this.runtime.dispose();
+        }
     }
     async kill() {
         this.notifyMessagesInterrupted(this.activeAndQueuedMessages(), "session killed");
@@ -918,6 +971,16 @@ export class RoutedSession {
         }
         return false;
     }
+    startDrain() {
+        if (this.drainPromise)
+            return;
+        const drain = this.drain();
+        this.drainPromise = drain;
+        void drain.finally(() => {
+            if (this.drainPromise === drain)
+                this.drainPromise = undefined;
+        });
+    }
     async drain() {
         if (this.processing || this.disposed)
             return;
@@ -974,7 +1037,7 @@ export class RoutedSession {
             }
         }
         catch (error) {
-            if (error instanceof PiboProviderRecoveryCancelledError)
+            if (error instanceof PiboProviderRecoveryCancelledError || this.disposed)
                 return;
             const message = errorMessage(error);
             this.emit({
@@ -1030,7 +1093,7 @@ export class RoutedSession {
         };
         this.emit(output);
         this.onStateChange?.({ processing: this.processing, queuedMessages: this.queue.length, disposed: this.disposed });
-        void this.drain();
+        this.startDrain();
         return output;
     }
     async runAction(event) {

package/dist/core/session-router.js CHANGED Viewed

@@ -6,6 +6,7 @@ import { RoutedSession } from "./routed-session.js";
 import { runtimeSessionErrorDetails } from "./session-errors.js";
 import { createSubagentToolName } from "../subagents/tool.js";
 import { PiboRunRegistry } from "../runs/registry.js";
+import { PiboRunExecutionTimeoutError } from "../runs/lifecycle.js";
 import { createPiboSignalRegistry } from "../signals/registry.js";
 import { createDefaultPiboReliabilityStore } from "../reliability/store.js";
 import { InMemoryPiboSessionStore, } from "../sessions/store.js";
@@ -85,6 +86,15 @@ function formatRunReminderMessage(notification) {
                 toolName: run.toolName,
                 summary: run.summary,
             })),
+            timedOut: notification.timedOut.map((run) => ({
+                runId: run.runId,
+                kind: run.kind,
+                status: run.status,
+                toolName: run.toolName,
+                summary: run.summary,
+                timeoutMs: run.timeoutMs,
+                timeoutPhase: run.timeoutPhase,
+            })),
             cancelled: notification.cancelled.map((run) => ({
                 runId: run.runId,
                 kind: run.kind,
@@ -99,7 +109,7 @@ function formatRunReminderMessage(notification) {
                 toolName: run.toolName,
                 summary: run.summary,
             })),
-            instruction: "Use pibo_run_read for completed or failed runs. Use pibo_run_wait, pibo_run_status, pibo_run_cancel, or pibo_run_ack for runs you still need to manage.",
+            instruction: "Use pibo_run_read for completed, failed, or timed_out runs. Use pibo_run_wait, pibo_run_status, pibo_run_cancel, or pibo_run_ack for runs you still need to manage.",
         }),
         "</pibo_run_notification>",
     ].join("\n");
@@ -108,7 +118,7 @@ function isRunReminderServiceMessage(event) {
     return event.source === "service" && event.text.startsWith("<pibo_run_notification>");
 }
 function isTerminalRunStatus(status) {
-    return status === "completed" || status === "failed" || status === "cancelled";
+    return status === "completed" || status === "failed" || status === "timed_out" || status === "cancelled";
 }
 function asJsonObject(value) {
     return value ?? {};
@@ -212,7 +222,9 @@ export class PiboSessionRouter {
         this.clearIdleSessionTimer(event.piboSessionId);
         try {
             if (event.type === "message") {
-                return session.enqueueMessage(event);
+                return event.delivery === "steer"
+                    ? await session.steerMessage(event)
+                    : session.enqueueMessage(event);
             }
             if (event.action === "abort") {
                 this.signalRegistry.project({ type: "session_interrupted", piboSessionId: event.piboSessionId, reason: "abort action" });
@@ -667,7 +679,7 @@ export class PiboSessionRouter {
     }
     createRunToolController(parentPiboSessionId) {
         return {
-            startToolRun: ({ toolName, params, completionPolicy, retryable, maxAttempts, execute }) => {
+            startToolRun: ({ toolName, params, completionPolicy, retryable, maxAttempts, timeoutMs, serviceWarning, execute }) => {
                 assertGatewayResourceAvailableForWork(`yielded run ${toolName}`);
                 const run = this.runRegistry.startToolRun({
                     controllerPiboSessionId: parentPiboSessionId,
@@ -676,6 +688,8 @@ export class PiboSessionRouter {
                     completionPolicy,
                     retryable,
                     maxAttempts,
+                    timeoutMs,
+                    serviceWarning,
                 });
                 void (async () => {
                     try {
@@ -685,8 +699,11 @@ export class PiboSessionRouter {
                             this.scheduleRunReminder(parentPiboSessionId, false);
                     }
                     catch (error) {
-                        const failed = this.runRegistry.fail(run.runId, error instanceof Error ? error.message : String(error));
-                        if (failed)
+                        const message = error instanceof Error ? error.message : String(error);
+                        const terminalRun = error instanceof PiboRunExecutionTimeoutError
+                            ? this.runRegistry.timeOut(run.runId, message, error.timeoutPhase)
+                            : this.runRegistry.fail(run.runId, message);
+                        if (terminalRun)
                             this.scheduleRunReminder(parentPiboSessionId, false);
                     }
                 })();

package/dist/data/ingest-service.js CHANGED Viewed

@@ -303,7 +303,7 @@ function payloadForOutputEvent(event) {
 function previewTextForOutputEvent(event) {
     if (event.type === "assistant_message" || event.type === "assistant_delta" || event.type === "thinking_delta" || event.type === "thinking_finished")
         return previewText(event.text ?? "");
-    if (event.type === "message_queued" || event.type === "message_started")
+    if (event.type === "message_queued" || event.type === "message_steered" || event.type === "message_started")
         return previewText(event.text);
     if (event.type === "tool_call" || event.type === "tool_execution_started" || event.type === "tool_execution_updated" || event.type === "tool_execution_finished")
         return event.toolName;
@@ -320,6 +320,8 @@ function previewTextForOutputEvent(event) {
 function attributesForOutputEvent(event) {
     if (event.type === "message_queued")
         return { inlineText: event.text, source: event.source, queuedMessages: event.queuedMessages };
+    if (event.type === "message_steered")
+        return { inlineText: event.text, source: event.source, activeEventId: event.activeEventId };
     if (event.type === "assistant_message" || event.type === "assistant_delta")
         return { assistantIndex: event.assistantIndex, contentIndex: event.contentIndex };
     if (event.type === "thinking_started" || event.type === "thinking_delta" || event.type === "thinking_finished")

package/dist/debug/index.js CHANGED Viewed

@@ -985,6 +985,10 @@ function compactRunRow(run) {
         policy: run.completionPolicy,
         consumed: run.consumed,
         updatedAt: run.updatedAt,
+        timeoutMs: run.timeoutMs,
+        timeoutAt: run.timeoutAt,
+        timeoutPhase: run.timeoutPhase,
+        serviceWarning: run.serviceWarning,
         summary: run.summary,
     };
 }

package/dist/debug/trace.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import { buildTraceView } from "../apps/chat/trace.js";
 import { normalizeSessionErrorDetails } from "../core/session-errors.js";
-import { compareTraceOrder } from "../shared/trace-order.js";
+import { compareTraceNodes } from "../shared/trace-nodes.js";
 import { openReadOnlyDebugDatabase, withStorePath } from "./sql.js";
 import { formatNextCommands } from "./next-commands.js";
 export async function inspectDebugTrace(piboSessionId, stores, options = {}) {
@@ -16,10 +16,11 @@ export async function inspectDebugTrace(piboSessionId, stores, options = {}) {
             throw new Error(`Pibo session "${piboSessionId}" not found`);
         const session = sessionFromRow(sessionRow);
         const sessions = sessionsDb.prepare("SELECT * FROM sessions").all().map(sessionFromRow);
+        const adapterIssues = [];
         const events = tableExists(chatDb, "event_log")
             ? chatDb
                 .prepare("SELECT stream_id, session_id, session_sequence, event_id, type, created_at, preview_text, attributes_json FROM event_log WHERE session_id = ? ORDER BY stream_id ASC")
-                .all(piboSessionId).map(eventFromRow).filter((event) => event !== undefined)
+                .all(piboSessionId).map((row) => eventFromRow(row, adapterIssues)).filter((event) => event !== undefined)
             : [];
         const view = await buildTraceView({
             session,
@@ -36,7 +37,7 @@ export async function inspectDebugTrace(piboSessionId, stores, options = {}) {
             status: traceStatus(view),
             nodes: filtered,
             rawNodeCount: rows.length,
-            ...(options.check ? { checks: checkTraceView(view) } : {}),
+            ...(options.check ? { checks: checkTraceView(view, adapterIssues) } : {}),
             nextCommands: buildTraceNextCommands(view.piboSessionId, filtered),
         };
     }
@@ -168,10 +169,11 @@ function traceStatus(view) {
         return "running";
     return "done";
 }
-function checkTraceView(view) {
-    const issues = [];
+export function checkTraceView(view, adapterIssues = []) {
+    const issues = [...adapterIssues];
     const all = flattenPiboTraceNodes(view.nodes);
     const ids = new Set();
+    const stableKeyOwners = new Map();
     for (const node of all) {
         if (ids.has(node.id)) {
             issues.push({
@@ -206,6 +208,20 @@ function checkTraceView(view) {
                 message: "Trace node has no conceptual stable key.",
             });
         }
+        else {
+            const existingOwner = stableKeyOwners.get(node.stableKey);
+            if (existingOwner && existingOwner !== node.id) {
+                issues.push({
+                    severity: "warning",
+                    code: "duplicate_stable_key",
+                    nodeId: node.id,
+                    message: `Stable key "${node.stableKey}" is already used by node "${existingOwner}".`,
+                });
+            }
+            else {
+                stableKeyOwners.set(node.stableKey, node.id);
+            }
+        }
     }
     for (const node of all) {
         if (node.parentId && !ids.has(node.parentId)) {
@@ -235,7 +251,7 @@ function checkSiblingOrder(nodes, issues) {
         checkSiblingOrder(node.children, issues);
 }
 function compareOrder(left, right) {
-    return compareTraceOrder(left.orderKey, right.orderKey) || left.id.localeCompare(right.id);
+    return compareTraceNodes(left, right);
 }
 function flattenPiboTraceNodes(nodes) {
     return nodes.flatMap((node) => [node, ...flattenPiboTraceNodes(node.children)]);
@@ -288,10 +304,18 @@ function sessionFromRow(row) {
         updatedAt: row.updated_at,
     };
 }
-function eventFromRow(row) {
+function eventFromRow(row, issues) {
     const payload = outputPayloadFromV2Row(row);
     if (!payload)
         return undefined;
+    if ((row.type === "assistant_delta" || row.type === "thinking_delta") && !nonEmptyEventText(payload)) {
+        issues.push({
+            severity: "warning",
+            code: "missing_delta_text",
+            nodeId: row.event_id ?? String(row.stream_id),
+            message: `Persisted ${row.type} event has no readable text payload.`,
+        });
+    }
     return {
         id: String(row.stream_id),
         piboSessionId: row.session_id ?? undefined,
@@ -315,12 +339,16 @@ function outputPayloadFromV2Row(row) {
     const base = { piboSessionId, eventId: row.event_id ?? undefined };
     if (row.type === "assistant_message")
         return compactObject({ ...base, type: "assistant_message", text: row.preview_text ?? "" });
+    if (row.type === "assistant_delta")
+        return compactObject({ ...base, type: "assistant_delta", text: inlineTextPayload(inlinePayload) ?? row.preview_text ?? "" });
     if (row.type === "message_started")
         return compactObject({ ...base, type: "message_started", text: row.preview_text ?? "" });
     if (row.type === "message_finished")
         return compactObject({ ...base, type: "message_finished" });
     if (row.type === "thinking_started")
         return compactObject({ ...base, type: "thinking_started" });
+    if (row.type === "thinking_delta")
+        return compactObject({ ...base, type: "thinking_delta", text: inlineTextPayload(inlinePayload) ?? row.preview_text ?? "" });
     if (row.type === "thinking_finished")
         return compactObject({ ...base, type: "thinking_finished", text: row.preview_text ?? "" });
     if (row.type === "tool_call")
@@ -337,6 +365,13 @@ function outputPayloadFromV2Row(row) {
     }
     return compactObject({ ...base, type: row.type });
 }
+function inlineTextPayload(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function nonEmptyEventText(event) {
+    const text = event.text;
+    return typeof text === "string" && text.length > 0;
+}
 function stringAttribute(attributes, key) {
     const value = attributes[key];
     return typeof value === "string" ? value : undefined;

package/dist/index.js CHANGED Viewed

@@ -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 ADDED Viewed

@@ -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/cli.js CHANGED Viewed

@@ -1,5 +1,6 @@
 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';
@@ -38,6 +39,9 @@ function maxIterations(value) { if (value === undefined)
 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; }
@@ -110,8 +114,16 @@ export function formatLoopResourceSummary(resources) {
         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 tokens = job.mode === 'goal' ? `${job.state.tokensUsed ?? 0}/${job.tokenBudget ?? 'unbounded'}` : '-'; return `${job.id}\t${job.mode}\t${job.enabled ? 'running' : 'stopped'}\t${job.state.runningAt ? 'active' : '-'}\tgoal=${goal}\ttokens=${tokens}\tresources=${formatLoopResourceSummary(job.resources)}\t${job.name}`; }
-function formatLoopRunLine(run) { return `${run.id}\t${run.jobId}\t${run.status}\t${run.piboSessionId ?? '-'}\t${run.completedAt ?? '-'}\tresources=${formatLoopResourceSummary(run.resources)}`; }
+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');
@@ -127,13 +139,13 @@ export async function runLoopCli(argv = process.argv, defaults = {}) {
     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>', 'Stop a Goal loop after reported model usage reaches n tokens').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')
+    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), stopPolicy: base.stopPolicy ?? undefined }; applyRuntimeCreateOptions(input, options); const store = createDefaultPiboLoopStore({ path: program.opts().store }); const job = store.createJob(input); if (options.json)
+        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 Goal token budget').option('--clear-token-budget', 'Clear Goal token budget').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)
+    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)
@@ -143,7 +155,11 @@ export async function runLoopCli(argv = process.argv, defaults = {}) {
         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); applyRuntimePatchOptions(patch, options); const target = maybeTargetFromOptions(options); if (target)
+        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)

package/dist/loops/prompts.js CHANGED Viewed

@@ -21,6 +21,7 @@ function buildGoalTurnPrompt(job, continuation, goalToolsAvailable) {
     const tokensUsed = job.state.tokensUsed ?? 0;
     const tokenBudget = job.tokenBudget;
     const remainingTokens = tokenBudget === undefined ? 'unbounded' : String(Math.max(0, tokenBudget - tokensUsed));
+    const tokenReserve = job.tokenReserve ?? 0;
     return [
         continuation ? 'Continue working toward the active Pibo loop goal.' : 'Start working toward the active Pibo loop goal.',
         '',
@@ -36,8 +37,10 @@ function buildGoalTurnPrompt(job, continuation, goalToolsAvailable) {
         '- Temporary rough edges are acceptable while work moves toward the requested end state. Completion still requires the requested end state to be true and verified.',
         '',
         'Budget:',
+        '- Budget enforcement: soft; model usage is reported after a response and the current turn can overshoot the limit.',
         `- Reported tokens used before this turn: ${tokensUsed}`,
-        `- Token budget: ${tokenBudget ?? 'none'}`,
+        `- Soft token budget: ${tokenBudget ?? 'none'}`,
+        `- Pre-turn token reserve: ${tokenReserve}`,
         `- Reported tokens remaining before this turn: ${remainingTokens}`,
         '',
         'Work from evidence:',