@pasko70/pibo 3.6.1 → 3.6.3

package/dist/runs/windows-process-tree.js

@@ -0,0 +1,132 @@
+import { execFile } from "node:child_process";
+import { existsSync, readFileSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export function windowsProcessTreeCommand(command, pidPath) {
+    const portablePidPath = pidPath.replaceAll("\\", "/");
+    return [
+        "__pibo_win_pid=\"$(ps -W | awk -v p=$$ 'NR > 1 && $1 == p { print $4; exit }')\"",
+        "if [ -z \"$__pibo_win_pid\" ]; then printf '%s\\n' 'Pibo could not identify the Windows Bash process.' >&2; exit 125; fi",
+        `printf '%s %s' "$$" "$__pibo_win_pid" > ${bashSingleQuote(portablePidPath)}`,
+        "unset __pibo_win_pid",
+        command,
+    ].join("\n");
+}
+export async function terminateWindowsProcessTree(pidPath) {
+    const identity = await waitForWindowsProcessIdentity(pidPath);
+    if (!identity)
+        return;
+    try {
+        const rows = await listWindowsProcessTree(identity.msysPid);
+        for (const row of rows) {
+            try {
+                process.kill(row.windowsPid, "SIGKILL");
+            }
+            catch {
+                // The process may have exited between the snapshot and termination.
+            }
+        }
+        for (let attempt = 0; attempt < 100 && processIsAlive(identity.windowsPid); attempt += 1) {
+            await new Promise((resolveWait) => setTimeout(resolveWait, 25));
+        }
+        if (processIsAlive(identity.windowsPid)) {
+            throw new Error(`Windows yielded-run process tree rooted at PID ${identity.windowsPid} is still active after termination.`);
+        }
+    }
+    finally {
+        removeWindowsProcessIdentity(pidPath);
+    }
+}
+async function waitForWindowsProcessIdentity(pidPath) {
+    for (let attempt = 0; attempt < 80; attempt += 1) {
+        try {
+            const match = readFileSync(pidPath, "utf8").trim().match(/^([1-9]\d*)\s+([1-9]\d*)$/);
+            if (match)
+                return { msysPid: Number(match[1]), windowsPid: Number(match[2]) };
+        }
+        catch {
+            // The Bash wrapper may still be starting.
+        }
+        await new Promise((resolveWait) => setTimeout(resolveWait, 25));
+    }
+    return undefined;
+}
+async function listWindowsProcessTree(rootMsysPid) {
+    const { stdout } = await execFileAsync(windowsBashExecutable(), ["-lc", "ps -W"], {
+        encoding: "utf8",
+        timeout: 5_000,
+        windowsHide: true,
+    });
+    return parseWindowsProcessTreeSnapshot(stdout, rootMsysPid);
+}
+export function parseWindowsProcessTreeSnapshot(stdout, rootMsysPid) {
+    const rows = stdout.split(/\r?\n/).flatMap((line) => {
+        const fields = line.trim().split(/\s+/);
+        if (fields.length < 4 || !fields.slice(0, 4).every((field) => /^\d+$/.test(field)))
+            return [];
+        return [{
+                msysPid: Number(fields[0]),
+                parentMsysPid: Number(fields[1]),
+                processGroupId: Number(fields[2]),
+                windowsPid: Number(fields[3]),
+            }];
+    });
+    const selected = new Set([rootMsysPid]);
+    for (let changed = true; changed;) {
+        changed = false;
+        for (const row of rows) {
+            if (selected.has(row.msysPid))
+                continue;
+            if (row.processGroupId === rootMsysPid || selected.has(row.parentMsysPid)) {
+                selected.add(row.msysPid);
+                changed = true;
+            }
+        }
+    }
+    const byPid = new Map(rows.map((row) => [row.msysPid, row]));
+    return rows
+        .filter((row) => selected.has(row.msysPid) && row.windowsPid > 0)
+        .sort((left, right) => processTreeDepth(right, byPid) - processTreeDepth(left, byPid));
+}
+function processTreeDepth(row, byPid) {
+    let depth = 0;
+    let current = row;
+    const seen = new Set();
+    while (!seen.has(current.msysPid)) {
+        seen.add(current.msysPid);
+        const parent = byPid.get(current.parentMsysPid);
+        if (!parent)
+            break;
+        depth += 1;
+        current = parent;
+    }
+    return depth;
+}
+function windowsBashExecutable() {
+    const candidates = [
+        process.env.ProgramFiles ? join(process.env.ProgramFiles, "Git", "bin", "bash.exe") : undefined,
+        process.env["ProgramFiles(x86)"] ? join(process.env["ProgramFiles(x86)"], "Git", "bin", "bash.exe") : undefined,
+    ].filter((candidate) => Boolean(candidate));
+    return candidates.find((candidate) => existsSync(candidate)) ?? "bash.exe";
+}
+function processIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function removeWindowsProcessIdentity(path) {
+    try {
+        unlinkSync(path);
+    }
+    catch {
+        // Best-effort transient process metadata cleanup.
+    }
+}
+function bashSingleQuote(value) {
+    return `'${value.replaceAll("'", `'"'"'`)}'`;
+}

package/dist/session-ui/terminalRows.js

@@ -23,14 +23,18 @@ export function buildCompactTerminalRows(traceView, options) {
     const candidates = syncThinkingToolRows(flatNodes.map((item) => createRowCandidate(item.node, item.turnId)));
     applyCompletedTurnTiming(candidates, turnById);
     const reconciled = reconcileConceptualRowCandidates(candidates);
-    const toolDisplayMode = options.toolDisplayMode ?? "default";
-    const rows = toolDisplayMode === "default" || toolDisplayMode === "slim"
-        ? groupRelatedToolCandidates(reconciled, showToolDebugMetrics || toolDisplayMode === "slim").map((candidate) => candidate.row)
-        : reconciled.map((candidate) => candidate.row);
+    const toolDisplayMode = options.toolDisplayMode ?? "full";
+    const rows = toolDisplayMode === "full"
+        ? groupRelatedToolCandidates(reconciled, showToolDebugMetrics).map((candidate) => candidate.row)
+        : toolDisplayMode === "default"
+            ? groupConsecutiveToolCandidates(reconciled).map((candidate) => candidate.row)
+            : toolDisplayMode === "slim"
+                ? groupRelatedToolCandidates(reconciled, true).map((candidate) => candidate.row)
+                : reconciled.map((candidate) => candidate.row);
     return applyToolDisplayMode(rows, toolDisplayMode);
 }
 function applyToolDisplayMode(rows, mode) {
-    if (mode === "default")
+    if (mode === "default" || mode === "full")
         return rows;
     if (mode === "hide")
         return rows.filter((row) => !isToolDisplayRow(row));
@@ -40,11 +44,7 @@ function applyToolDisplayMode(rows, mode) {
         const intent = row.intent?.trim();
         if (mode === "intent" && !intent)
             return [];
-        const slimRow = {
-            ...row,
-            lines: row.lines.slice(0, 1),
-            singleLine: true,
-        };
+        const slimRow = compactToolDisplayRow(row);
         if (mode !== "intent")
             return [slimRow];
         return [{
@@ -65,11 +65,19 @@ function applyToolDisplayMode(rows, mode) {
             }];
     });
 }
+function compactToolDisplayRow(row) {
+    return {
+        ...row,
+        lines: row.lines.slice(0, 1),
+        singleLine: true,
+    };
+}
 function isToolDisplayRow(row) {
     return row.sourceNodeIds.some((nodeId) => parseTraceToolNodeIdentity(nodeId) !== undefined)
         || row.id.startsWith("terminal:tool:")
         || row.kind === "tool.call"
         || row.kind === "tool.image"
+        || row.kind === "tool.group.calls"
         || row.kind === "tool.group.exploring"
         || row.kind === "tool.group.images"
         || row.kind === "agent.delegation";
@@ -387,6 +395,16 @@ function debugFields(node) {
 }
 function createUserMessageRow(node) {
     const text = stringValue(node.output) || stringValue(node.summary) || node.title;
+    const imagePreviews = node.fileAttachments?.flatMap((attachment, index) => {
+        if (!isImageFileAttachment(attachment.path, attachment.contentType))
+            return [];
+        return [{
+                id: `${node.id}:attachment:${index}`,
+                label: attachment.name,
+                path: attachment.path,
+                mimeType: attachment.contentType,
+            }];
+    });
     return {
         id: node.id,
         kind: "message.user",
@@ -399,8 +417,13 @@ function createUserMessageRow(node) {
         startedAt: node.startedAt,
         output: text,
         payloadRefs: node.payloadRefs,
+        imagePreviews: imagePreviews?.length ? imagePreviews : undefined,
     };
 }
+function isImageFileAttachment(path, contentType) {
+    return contentType?.toLowerCase().startsWith("image/") === true
+        || /\.(?:avif|bmp|gif|jpe?g|png|svg|webp)$/i.test(path);
+}
 function createAssistantMessageRow(node) {
     return {
         id: node.id,
@@ -548,7 +571,7 @@ function createImageToolRow(node, image) {
         lines: [
             {
                 prefix: "bullet",
-                tokens: [token(image.verb, toneForStatus(node.status), "semibold")],
+                tokens: [token(image.verb, node.status === "done" ? "purple" : toneForStatus(node.status), "semibold")],
             },
             {
                 prefix: "detail",
@@ -943,6 +966,77 @@ function isThinkingOutput(value) {
 function isThinkingLevelSetOutput(value) {
     return isRecord(value) && value.action === "set_thinking_level";
 }
+function groupConsecutiveToolCandidates(candidates) {
+    const grouped = [];
+    for (let index = 0; index < candidates.length; index += 1) {
+        const candidate = candidates[index];
+        const groupKind = defaultToolGroupKind(candidate);
+        if (!groupKind) {
+            grouped.push(candidate);
+            continue;
+        }
+        const run = [candidate];
+        let cursor = index + 1;
+        while (cursor < candidates.length && defaultToolGroupKind(candidates[cursor]) === groupKind && candidates[cursor].turnId === candidate.turnId) {
+            run.push(candidates[cursor]);
+            cursor += 1;
+        }
+        if (groupKind === "images") {
+            grouped.push(run.length === 1 ? candidate : { row: createImageGroup(run), turnId: candidate.turnId });
+        }
+        else if (run.length === 1) {
+            grouped.push({ ...candidate, row: compactToolDisplayRow(candidate.row) });
+        }
+        else {
+            grouped.push({ row: createToolCallGroup(run), turnId: candidate.turnId });
+        }
+        index = cursor - 1;
+    }
+    return grouped;
+}
+function defaultToolGroupKind(candidate) {
+    if (candidate.image)
+        return "images";
+    if (candidate.row.kind === "tool.image" || candidate.row.kind === "tool.group.images")
+        return undefined;
+    return isBundledToolDisplayRow(candidate.row) ? "calls" : undefined;
+}
+function isBundledToolDisplayRow(row) {
+    return isToolDisplayRow(row) && row.kind !== "agent.delegation";
+}
+function createToolCallGroup(candidates) {
+    const groupRows = candidates.map((candidate) => compactToolDisplayRow(candidate.row));
+    const firstRow = groupRows[0];
+    const latestRow = groupRows[groupRows.length - 1];
+    const hasError = groupRows.some((row) => row.status === "error");
+    const status = groupRows.some((row) => row.status === "running")
+        ? "running"
+        : hasError
+            ? "error"
+            : "done";
+    return {
+        id: `group:tools:${firstRow.id}`,
+        kind: "tool.group.calls",
+        status,
+        errorKind: hasError ? "tool" : undefined,
+        lines: latestRow.lines.slice(0, 1),
+        sourceNodeIds: groupRows.flatMap((row) => row.sourceNodeIds),
+        isToolCall: true,
+        toolMetrics: latestRow.toolMetrics,
+        modelInferences: latestRow.modelInferences,
+        title: latestRow.title,
+        eventId: latestRow.eventId,
+        runId: latestRow.runId,
+        orderSource: firstRow.orderSource,
+        orderStreamId: firstRow.orderStreamId,
+        orderStreamFrameIndex: firstRow.orderStreamFrameIndex,
+        startedAt: firstRow.startedAt,
+        completedAt: latestRow.completedAt,
+        expandable: true,
+        singleLine: true,
+        groupRows,
+    };
+}
 function groupRelatedToolCandidates(candidates, imagesOnly = false) {
     const grouped = [];
     for (let index = 0; index < candidates.length; index += 1) {
@@ -1042,7 +1136,7 @@ function createImageGroup(candidates) {
         lines: [
             {
                 prefix: "bullet",
-                tokens: [token(status === "running" ? `Viewing ${detailItems.length} images` : status === "error" ? `${detailItems.length} image reads · error` : `${detailItems.length} Viewed ${detailItems.length === 1 ? "Image" : "Images"}`, toneForStatus(status), "semibold")],
+                tokens: [token(status === "running" ? `Viewing ${detailItems.length} images` : status === "error" ? `${detailItems.length} image reads · error` : `${detailItems.length} Viewed ${detailItems.length === 1 ? "Image" : "Images"}`, status === "done" ? "purple" : toneForStatus(status), "semibold")],
             },
             ...visibleDetailItems.map((item, index) => ({
                 prefix: index === 0 ? "detail" : "continuation",

package/dist/shared/trace-engine.js

@@ -1,5 +1,5 @@
 import { reconcileAsyncAgentRunStatuses } from "./trace-async-agent-runs.js";
-import { applySingleEventToNodes, dedupeTraceEvents, findOpenTranscriptEventIds, latestTraceStreamId, markIncompletePersistedTurns, mergeMessageTurnTimings, messageTurnTimingsFromEvents, reconcileTranscriptUserMessages, } from "./trace-event-projection.js";
+import { applySingleEventToNodes, dedupeTraceEvents, findOpenTranscriptEventIds, latestTraceStreamId, markIncompletePersistedTurns, mergeMessageTurnTimings, messageTurnTimingsFromEvents, reconcileAcceptedUserMessageMetadata, reconcileTranscriptUserMessages, } from "./trace-event-projection.js";
 import { flattenTraceNodes, mapTraceNodesById, nestTraceNodes } from "./trace-nodes.js";
 import { mapTraceChildSessionsByParent, mapTraceSubagentSessionLinks, } from "./trace-subagent-links.js";
 import { projectHistoryEntries, traceNodesFromHistoryEntries } from "./trace-history.js";
@@ -43,6 +43,7 @@ export function buildTraceViewFromEvents(input) {
     for (const storedEvent of events) {
         applySingleEventToNodes(nodes, byId, input.session.id, storedEvent, childByParent, linkedChildByToolCallId, historyCoverage, openHistoryEventIds, sessionStatus);
     }
+    reconcileAcceptedUserMessageMetadata(nodes, events);
     const hasIncompleteTurns = markIncompletePersistedTurns(nodes, byId, input.session.id, events, turnTimings, sessionStatus);
     const nestedNodes = nestTraceNodes(nodes);
     reconcileAsyncAgentRunStatuses(nestedNodes);

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

@@ -7,6 +7,8 @@ import { qualifiedToolNodeId } from "./trace-tool-identity.js";
 import { observeCacheUsage } from "./cache-observability.js";
 import { compareInferenceCompletion } from "./model-inference-metrics.js";
 export function applySingleEventToNodes(nodes, byId, piboSessionId, storedEvent, childByParent, linkedChildByToolCallId, historyCoverage, openTranscriptEventIds, sessionStatus) {
+    if (applyAcceptedUserMessageMetadata(nodes, storedEvent))
+        return;
     const payload = storedEvent.payload;
     if (payload.type === "assistant_usage") {
         attachModelInferenceToLatestOutput(nodes, byId, payload, storedEvent);
@@ -127,6 +129,7 @@ export function applySingleEventToNodes(nodes, byId, piboSessionId, storedEvent,
             if (node.type === "user.message") {
                 existing.status = node.status;
                 existing.parentId = node.parentId ?? existing.parentId;
+                existing.fileAttachments = node.fileAttachments ?? existing.fileAttachments;
                 existing.summary = node.summary ?? existing.summary;
                 existing.output = node.output ?? existing.output;
             }
@@ -498,6 +501,82 @@ function normalizedUserMessageText(value) {
     const normalized = value?.replace(/\s+/g, " ").trim();
     return normalized || undefined;
 }
+export function reconcileAcceptedUserMessageMetadata(nodes, events) {
+    for (const event of events)
+        applyAcceptedUserMessageMetadata(nodes, event);
+}
+function applyAcceptedUserMessageMetadata(nodes, storedEvent) {
+    const payload = storedEvent.payload;
+    if (!isRecord(payload) || payload.type !== "user.message.accepted")
+        return false;
+    const clientTxnId = typeof payload.clientTxnId === "string" ? payload.clientTxnId : undefined;
+    if (!clientTxnId)
+        return true;
+    const attachments = normalizeTraceFileAttachments(payload.fileAttachments, payload.fileAttachmentPaths);
+    if (!attachments.length)
+        return true;
+    const delivery = payload.delivery === "steer" ? "message_steered" : "message_queued";
+    const canonicalId = `event:${delivery}:${clientTxnId}`;
+    const target = flattenTraceNodes([...nodes]).find((node) => node.type === "user.message"
+        && (node.id === canonicalId || node.stableKey === canonicalId || node.eventId === clientTxnId));
+    if (target) {
+        target.fileAttachments = attachments;
+        const displayText = acceptedUserMessageDisplayText(payload);
+        if (displayText) {
+            target.summary = displayText;
+            target.output = displayText;
+        }
+    }
+    return true;
+}
+function acceptedUserMessageDisplayText(payload) {
+    if (typeof payload.userText === "string" && payload.userText.trim())
+        return payload.userText;
+    if (typeof payload.text !== "string")
+        return undefined;
+    let text = payload.text;
+    for (const key of ["fileAttachmentContext", "webAnnotationContext"]) {
+        const context = typeof payload[key] === "string" ? payload[key] : undefined;
+        if (!context || !text.trimEnd().endsWith(context))
+            continue;
+        text = text.trimEnd().slice(0, -context.length).trimEnd();
+    }
+    return text.trim() || undefined;
+}
+function traceFileAttachmentsFromMessageEvent(event) {
+    const record = event;
+    const attachments = normalizeTraceFileAttachments(record.fileAttachments, record.fileAttachmentPaths);
+    return attachments.length ? attachments : undefined;
+}
+function normalizeTraceFileAttachments(attachmentsValue, pathsValue) {
+    const attachments = Array.isArray(attachmentsValue) ? attachmentsValue.flatMap((value) => {
+        if (!isRecord(value) || typeof value.path !== "string" || !value.path.trim())
+            return [];
+        const path = value.path.trim();
+        return [{
+                path,
+                name: typeof value.name === "string" && value.name.trim() ? value.name.trim() : traceAttachmentName(path),
+                ...(typeof value.bytes === "number" && Number.isFinite(value.bytes) && value.bytes >= 0 ? { bytes: value.bytes } : {}),
+                ...(typeof value.contentType === "string" && value.contentType.trim() ? { contentType: value.contentType.trim() } : {}),
+            }];
+    }) : [];
+    if (attachments.length)
+        return attachments.slice(0, 10);
+    if (!Array.isArray(pathsValue))
+        return [];
+    return pathsValue.flatMap((value) => {
+        if (typeof value !== "string" || !value.trim())
+            return [];
+        const path = value.trim();
+        return [{ path, name: traceAttachmentName(path) }];
+    }).slice(0, 10);
+}
+function traceAttachmentName(path) {
+    return path.split(/[\\/]/).filter(Boolean).at(-1) ?? path;
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function traceNodeText(node) {
     if (typeof node.output === "string")
         return node.output;
@@ -654,6 +733,7 @@ function traceNodeFromEvent(piboSessionId, event, childByParent, linkedChildByTo
                 title: "User Message",
                 status: isOptimisticUserMessageEvent(event) ? "running" : "done",
                 messageDeliveryState: isOptimisticUserMessageEvent(event) ? "sending" : undefined,
+                fileAttachments: traceFileAttachmentsFromMessageEvent(event),
                 summary: event.text,
                 output: event.text,
             };

package/dist/shared/trace-patch-nodes.js

@@ -60,6 +60,7 @@ function traceNodeShallowEqual(left, right) {
         left.startedAt === right.startedAt &&
         left.completedAt === right.completedAt &&
         left.durationMs === right.durationMs &&
+        traceFileAttachmentsEqual(left.fileAttachments, right.fileAttachments) &&
         left.toolMetrics?.durationMs === right.toolMetrics?.durationMs &&
         left.toolMetrics?.inputTokens === right.toolMetrics?.inputTokens &&
         left.toolMetrics?.outputTokens === right.toolMetrics?.outputTokens &&
@@ -74,6 +75,19 @@ function traceNodeShallowEqual(left, right) {
         left.stableKey === right.stableKey &&
         traceOrderKeyEqual(left.orderKey, right.orderKey));
 }
+function traceFileAttachmentsEqual(left, right) {
+    if (left === right)
+        return true;
+    if (!left || !right || left.length !== right.length)
+        return false;
+    return left.every((attachment, index) => {
+        const other = right[index];
+        return attachment.name === other?.name
+            && attachment.path === other.path
+            && attachment.bytes === other.bytes
+            && attachment.contentType === other.contentType;
+    });
+}
 function modelInferenceRecordsEqual(left, right) {
     if (left === right)
         return true;

package/dist/subagents/context.js

@@ -27,7 +27,7 @@ export function getDelegatedAgentContextFile(subagents) {
             "```text",
             "pibo_run_start({",
             "  toolName: \"pibo_agents_send_message\",",
-            "  arguments: { name, sessionName, message, threadKey? },",
+            "  arguments: { name, sessionName, message, threadKey?, queue? },",
             "  completionPolicy?: \"tracked\" | \"detached\"",
             "}) -> { runId }",
             "",
@@ -40,9 +40,15 @@ export function getDelegatedAgentContextFile(subagents) {
             "pibo_agents_kill({ agentId })              # terminate one persistent child session subtree",
             "```",
             "",
-            "Set `sessionName` on every send to a nonblank human-readable child title of at most 40 Unicode code points. Pibo trims surrounding whitespace and rejects missing, blank, non-string, or oversized names before creating a yielded run or child session. Reuse a stable `threadKey` to continue the same child Pibo Session; a new `sessionName` updates its title without changing identity. A wait timeout only wakes the orchestrator. Observe uses `cursorMode: \"auto\"` by default: the first equivalent query returns the newest completed assistant messages, and later calls return only unread messages. Use `cursorMode: \"history\"` only to reread earlier observations. Streaming deltas, duplicate tool progress events, and tools are hidden by default. Inspect tools only when a child stalls, reports an error, or needs targeted diagnosis; prefer exact `toolCallIds`, then `includeTools: true`, and use `toolDetail: \"full\"` only when summaries are insufficient. Use `textContains` for case-insensitive substring matching or `textRegex` for rg/Rust-regex matching; both must match when supplied together. Text, regex, identity, and event filters create separate automatic query cursors; an explicit `afterSequence` overrides and advances the matching automatic cursor.",
+            "Set `sessionName` on every send to a nonblank human-readable child title of at most 40 Unicode code points. Pibo trims surrounding whitespace and rejects missing, blank, non-string, or oversized names before creating a yielded run or child session. Reuse a stable `threadKey` to continue the same child Pibo Session; a new `sessionName` updates its title without changing identity.",
             "",
-            "Observe progress and decide whether to continue waiting, steer through a new message after the current turn, cancel the request, or kill the child session.",
+            "## Steering and queue delivery",
+            "",
+            "When the reused child has an active turn that accepts steering, omit `queue` or set `queue: false`: Pibo sends the message into that active turn at the next steering boundary. Use this default for corrections, changed priorities, additional constraints, or information the child should apply before finishing its current work. When the child is idle, the same call automatically queues a normal new turn; steering cannot be forced while idle. Set `queue: true` only when you deliberately want a separate follow-up turn after the active turn finishes. The result reports the actual `delivery` as `steer` or `queue`. Cancelling a run after its steering message was accepted stops waiting for the shared active-turn result but cannot retract the steering message or cancel that active turn.",
+            "",
+            "A wait timeout only wakes the orchestrator. Observe uses `cursorMode: \"auto\"` by default: the first equivalent query returns the newest completed assistant messages, and later calls return only unread messages. Use `cursorMode: \"history\"` only to reread earlier observations. Streaming deltas, duplicate tool progress events, and tools are hidden by default. Inspect tools only when a child stalls, reports an error, or needs targeted diagnosis; prefer exact `toolCallIds`, then `includeTools: true`, and use `toolDetail: \"full\"` only when summaries are insufficient. Use `textContains` for case-insensitive substring matching or `textRegex` for rg/Rust-regex matching; both must match when supplied together. Text, regex, identity, and event filters create separate automatic query cursors; an explicit `afterSequence` overrides and advances the matching automatic cursor.",
+            "",
+            "Observe progress and decide whether to continue waiting, send default steering to an active child, set `queue: true` for a separate follow-up turn, cancel the request, or kill the child session.",
             "",
             "For substantial reports, ask the child to persist a Markdown artifact and include its path in the complete final message.",
         ].join("\n"),

package/dist/subagents/observations.js

@@ -3,7 +3,7 @@ export const PIBO_AGENT_OBSERVATION_TOOL_SUMMARY_MAX_BYTES = 768;
 export const PIBO_AGENT_OBSERVATION_DETAILS_MAX_BYTES = 32 * 1024;
 export const PIBO_AGENT_OBSERVATION_DEFAULT_LIMIT = 20;
 export const PIBO_AGENT_OBSERVATION_MAX_LIMIT = 200;
-export const PIBO_AGENT_OBSERVATION_DEFAULT_EVENT_TYPES = ["assistant_message"];
+export const PIBO_AGENT_OBSERVATION_DEFAULT_EVENT_TYPES = ["assistant_message", "session_error"];
 export const PIBO_AGENT_OBSERVATION_DEFAULT_TOOL_EVENT_TYPES = ["tool_call", "tool_execution_finished"];
 export function piboAgentObservationSourceFromEvent(event) {
     const source = {

package/dist/subagents/tool.js

@@ -93,6 +93,7 @@ function normalizeAgentSendMessageResult(result, fallbackRequestId) {
     return {
         ...result,
         requestId: result.requestId?.trim() || fallbackRequestId,
+        delivery: result.delivery ?? "queue",
         finalMessage: typeof result.finalMessage === "string" ? result.finalMessage : result.reply.text,
     };
 }
@@ -114,11 +115,11 @@ export function createAgentToolDefinitions(subagents, controller) {
             name: "pibo_agents_send_message",
             title: "Pibo Agents Send Message",
             description: [
-                "Yielded-only delegated send with a required sessionName. It must be a nonblank string of at most 40 Unicode code points and is trimmed before use. name selects the configured agent, sessionName is the human-readable child-session title, and threadKey controls conversation reuse. Invalid arguments fail before a run or child session is created. Start this tool through pibo_run_start; bounded waits do not limit the child lifetime.",
+                "Yielded-only delegated send with a required sessionName. It must be a nonblank string of at most 40 Unicode code points and is trimmed before use. name selects the configured agent, sessionName is the human-readable child-session title, and threadKey controls conversation reuse. By default, a reused child with an active steerable turn receives the message as steering; an idle child receives a queued turn. Set queue=true only when the message must run as a separate next turn even while the child is active. Steering is never attempted for an idle child. Invalid arguments fail before a run or child session is created. Start this tool through pibo_run_start; bounded waits do not limit the child lifetime.",
                 "Available agents:",
                 catalog,
             ].join("\n"),
-            promptSnippet: "Start pibo_agents_send_message through pibo_run_start. Provide a nonblank sessionName of at most 40 Unicode code points on every call; Pibo trims it and rejects invalid input before creating a run. Follow-up calls update the reused child title without changing identity. Reuse threadKey to continue its child session, and use run wait/status/read/cancel plus agent observe for lifecycle control.",
+            promptSnippet: "Start pibo_agents_send_message through pibo_run_start. Reuse threadKey to address the same child session. Omit queue to steer its active turn automatically; if the child is idle, Pibo queues a normal turn instead. Set queue=true only when you deliberately want a separate follow-up turn after the active turn. You cannot force steering on an idle child. Provide a nonblank sessionName of at most 40 Unicode code points on every call; follow-up calls update the reused child title without changing identity. Use run wait/status/read/cancel plus agent observe for lifecycle control.",
             executionMode: "parallel",
             inputSchema: Type.Object({
                 name: piboStringEnum(names, { description: "Configured delegated-agent selector; not the child title or reuse key" }),
@@ -133,6 +134,10 @@ export function createAgentToolDefinitions(subagents, controller) {
                     description: "Stable reuse key for one delegated-agent conversation; independent of sessionName. Omit it to create a new child session.",
                     maxLength: 256,
                 })),
+                queue: Type.Optional(Type.Boolean({
+                    description: "Force this message into the child's next-turn queue. Omit or set false to steer an active steerable child automatically; idle children are always queued.",
+                    default: false,
+                })),
             }),
             prepareInput: preparePiboAgentToolInput,
             async execute(toolCallId, params, signal, _onUpdate, context) {
@@ -148,6 +153,7 @@ export function createAgentToolDefinitions(subagents, controller) {
                     sessionName: preparedParams.sessionName,
                     message: preparedParams.message,
                     threadKey: preparedParams.threadKey,
+                    queue: preparedParams.queue,
                     toolCallId,
                     requestId: context.yieldedRunId,
                     parentProvenance: context.getActiveMessage?.()?.provenance,
@@ -156,7 +162,7 @@ export function createAgentToolDefinitions(subagents, controller) {
                 return {
                     content: [{
                             type: "text",
-                            text: `Agent request ${result.requestId} completed (${result.name}, ${result.agentId}, thread ${result.threadKey}).\n\n${result.finalMessage}`,
+                            text: `Agent request ${result.requestId} completed via ${result.delivery} (${result.name}, ${result.agentId}, thread ${result.threadKey}).\n\n${result.finalMessage}`,
                         }],
                     structuredContent: {
                         status: "completed",
@@ -164,6 +170,8 @@ export function createAgentToolDefinitions(subagents, controller) {
                         agentId: result.agentId,
                         threadKey: result.threadKey,
                         eventId: result.eventId,
+                        delivery: result.delivery,
+                        ...(result.activeEventId ? { activeEventId: result.activeEventId } : {}),
                         finalMessage: result.finalMessage,
                     },
                     details: result,
@@ -190,11 +198,11 @@ export function createAgentToolDefinitions(subagents, controller) {
             name: "pibo_agents_observe",
             title: "Pibo Agents Observe",
             description: [
-                "Read completed delegated-agent messages with bounded cursor, identity, event, time, substring, regex, order, and limit filters.",
-                "Default cursorMode=auto: the first equivalent query returns the newest 20 completed assistant messages; later calls return only unread messages. Streaming deltas, duplicate tool progress events, and tools stay hidden.",
+                "Read completed delegated-agent messages and session errors with bounded cursor, identity, event, time, substring, regex, order, and limit filters.",
+                "Default cursorMode=auto: the first equivalent query returns the newest 20 completed assistant messages and session errors; later calls return only unread observations. Streaming deltas, duplicate tool progress events, and tools stay hidden.",
                 "Use cursorMode=history only to reread earlier observations. Inspect tools only when an agent appears stuck, reports a problem, or needs targeted diagnosis; prefer exact toolCallIds, then includeTools=true, and use toolDetail=full only when compact summaries are insufficient.",
             ].join("\n"),
-            promptSnippet: "Observe child progress through completed assistant messages. cursorMode=auto is the default and remembers each equivalent query, so repeated calls return only unread messages; use cursorMode=history to reread earlier observations. Streaming deltas, duplicate tool progress events, and tools are hidden by default. Inspect tools only for stalls, errors, or targeted diagnosis: prefer exact toolCallIds, use includeTools=true only when broader context is needed, and use toolDetail=full only when summaries are insufficient. Use textContains or textRegex for focused matching; different filters use separate automatic cursors. An explicit afterSequence overrides the stored cursor and advances that automatic query cursor.",
+            promptSnippet: "Observe child progress through completed assistant messages and session errors. cursorMode=auto is the default and remembers each equivalent query, so repeated calls return only unread observations; use cursorMode=history to reread earlier observations. Streaming deltas, duplicate tool progress events, and tools are hidden by default. Inspect tools only for stalls, errors, or targeted diagnosis: prefer exact toolCallIds, use includeTools=true only when broader context is needed, and use toolDetail=full only when summaries are insufficient. Use textContains or textRegex for focused matching; different filters use separate automatic cursors. An explicit afterSequence overrides the stored cursor and advances that automatic query cursor.",
             executionMode: "parallel",
             annotations: { readOnly: true },
             inputSchema: Type.Object({

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@pasko70/pibo",
-  "version": "3.6.1",
+  "version": "3.6.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@pasko70/pibo",
-      "version": "3.6.1",
+      "version": "3.6.3",
       "workspaces": [
         "packages/workflows"
       ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pasko70/pibo",
-  "version": "3.6.1",
+  "version": "3.6.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/packages/workflows/dist/runtime/adapter-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-node.d.ts","sourceRoot":"","sources":["../../src/runtime/adapter-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAgB1D,MAAM,MAAM,kCAAkC,GAAG;IAC/C,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAC7C,GAAG,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,aAAa,CAAC;IAC1C,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,EAAE,EAAE,IAAI,CAAC;IACT,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,EAAE,EAAE,KAAK,CAAC;IACV,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,KAAK,EAAE,oBAAoB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GACzC,kCAAkC,GAClC,kCAAkC,CAAC;AAEvC,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,kBAAkB,EAC9B,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,iCAAiC,CAAC,CAsK5C"}
+{"version":3,"file":"adapter-node.d.ts","sourceRoot":"","sources":["../../src/runtime/adapter-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAiB1D,MAAM,MAAM,kCAAkC,GAAG;IAC/C,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAC7C,GAAG,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,aAAa,CAAC;IAC1C,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,EAAE,EAAE,IAAI,CAAC;IACT,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,EAAE,EAAE,KAAK,CAAC;IACV,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,KAAK,EAAE,oBAAoB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GACzC,kCAAkC,GAClC,kCAAkC,CAAC;AAEvC,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,kBAAkB,EAC9B,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,iCAAiC,CAAC,CAsK5C"}

package/packages/workflows/dist/runtime/adapter-node.js

@@ -1,6 +1,6 @@
 import { resolveWorkflowAdapter } from "../registry/index.js";
 import { validateNodeOutput, validateWorkflowPortValue } from "../validation/index.js";
-import { adapterNodeDispatchFailure, failAdapterNodeDispatch, } from "./dispatch-failures.js";
+import { adapterErrorSummaryFromCaught, adapterNodeDispatchFailure, failAdapterNodeDispatch, } from "./dispatch-failures.js";
 import { createWorkflowRuntimeId as createId } from "./ids.js";
 import { emitWorkflowRuntimeEvent, persistWorkflowNodeAttempt, persistWorkflowRun, } from "./persistence.js";
 import { createNodeScopedWorkflowRun, localStateSnapshotForNode } from "./state.js";
@@ -157,16 +157,4 @@ export async function dispatchWorkflowAdapterNode(definition, run, nodeId, input
         });
     }
 }
-function adapterErrorSummaryFromCaught(caught) {
-    if (caught instanceof Error) {
-        return {
-            code: "WorkflowRuntimeError.adapterFailed",
-            message: caught.message,
-        };
-    }
-    return {
-        code: "WorkflowRuntimeError.adapterFailed",
-        message: "Workflow adapter failed with a non-Error value.",
-    };
-}
 //# sourceMappingURL=adapter-node.js.map