@marcoscale98/pi-extensible-workflows 5.17.0-fork.1 → 6.2.1-fork.1

package/dist/src/background-widget.d.ts

@@ -22,6 +22,11 @@ export type BackgroundWidgetAPI = Pick<ExtensionAPI, "appendEntry" | "on"> & {
     registerEntryRenderer?: ExtensionAPI["registerEntryRenderer"];
     registerShortcut?: ExtensionAPI["registerShortcut"];
 };
+/**
+ * Repaint interval. Fast enough that the spinner reads as motion rather than a
+ * stutter; the underlying data is only re-read when an event says it changed.
+ */
+export declare const REPAINT_MS = 125;
 /**
  * How long an agent may go without an event before the widget says so.
  *
@@ -55,7 +60,6 @@ interface ReceiptAgent {
     name: string;
     state: string;
     model?: string;
-    role?: string;
     requestedModel?: string;
     tools?: readonly string[];
     /** Accepted for rendering older receipt entries; new receipts persist granted tools. */

package/dist/src/background-widget.js

@@ -25,7 +25,7 @@ const ENTRY_TYPE = "piewf-run-receipt";
  * Repaint interval. Fast enough that the spinner reads as motion rather than a
  * stutter; the underlying data is only re-read when an event says it changed.
  */
-const REPAINT_MS = 125;
+export const REPAINT_MS = 125;
 /**
  * Filesystem rescan interval. Shell-only activity has no event, but it does not
  * need to be polled at the animation cadence.
@@ -191,7 +191,7 @@ function renderableAgent(value) {
         return false;
     if (value.model.thinking !== undefined && typeof value.model.thinking !== "string")
         return false;
-    for (const key of ["id", "label", "parentId", "role", "requestedModel"])
+    for (const key of ["id", "label", "parentId", "requestedModel"])
         if (value[key] !== undefined && typeof value[key] !== "string")
             return false;
     for (const key of ["attempts", "startedAt", "durationMs", "lastEventAt"])
@@ -554,8 +554,7 @@ function renderFrame(runs, now, width, offset = 0, theme, scrolling = false, siz
                         ? mark(agent.state, now, paint, run.state)
                         : paint(silent >= STALL_MS ? ROLE.failed : ROLE.warn, "⚠")} ${
                     // The label is what the workflow called this agent — `reviewer #2`,
-                    // `scout (api)` — where the name is the role it was built from. Two
-                    // agents of one role are otherwise indistinguishable.
+                    // `scout (api)` — preserving an explicit label when supplied.
                     agent.label ?? agent.name}${silent === undefined
                         ? ""
                         : `  ${paint(silent >= STALL_MS ? ROLE.failed : ROLE.warn, `${silent >= STALL_MS ? "stalled" : "quiet"} ${formatElapsed(silent)}`)}`}`,
@@ -696,18 +695,15 @@ function receiptFor(run, fallback) {
         agents: agents.map((agent) => ({
             id: agent.id,
             ...(agent.parentId === undefined ? {} : { parentId: agent.parentId }),
-            // What the workflow called it, falling back to the role it was built
-            // from. Two agents of one role are otherwise indistinguishable.
+            // Preserve explicit display labels.
             name: agent.label ?? agent.name,
             state: agent.state,
-            // Model and thinking level together: a role picks both, and the model
-            // name alone does not say whether it reasoned cheaply or deeply.
+            // Show both model and thinking level.
             ...(agent.model.model
                 ? {
                     model: `${agent.model.model}${agent.model.thinking ? `:${agent.model.thinking}` : ""}`,
                 }
                 : {}),
-            ...(agent.role ? { role: agent.role } : {}),
             ...(agent.requestedModel ? { requestedModel: agent.requestedModel } : {}),
             tools: [...agent.tools],
             // Cache reads dwarf real input and cost almost nothing, so the split is
@@ -782,7 +778,6 @@ export function renderReceipt(data, expanded, theme) {
             lines.push(`${prefix}${lastAgent ? "╰─" : "├─"} ${glyph(agent.state)} ${agent.name} ${theme.fg("muted", detail)}`);
             const under = `${prefix}${lastAgent ? "  " : "│ "}   `;
             const meta = [
-                agent.role ? `role ${agent.role}` : "",
                 agent.requestedModel && agent.requestedModel !== agent.model
                     ? `via ${agent.requestedModel}`
                     : "",

package/dist/src/decoders.d.ts

@@ -1,4 +1,4 @@
-import { type AgentDefinition, type BudgetApprovalRequest, type JsonValue, type LaunchSnapshot, type RunRecord, type WorkflowBudgetUsage, type WorkflowExtensionSettings } from "./types.js";
+import { type PreparedAgentConfiguration, type BudgetApprovalRequest, type JsonValue, type LaunchSnapshot, type RunRecord, type WorkflowBudgetUsage, type WorkflowExtensionSettings } from "./types.js";
 import type { OwnershipRecord } from "./agent-execution.js";
 export interface EffectiveSystemPrompt {
     sessionId: string;
@@ -13,7 +13,6 @@ export interface RunSummaryAgent {
     name: string;
     label?: string;
     state: string;
-    role?: string;
     attempts: number;
 }
 export interface RunSummaryArtifacts {
@@ -59,7 +58,7 @@ export type Journal = {
     awaiting?: Record<string, AwaitingCheckpoint>;
     decisions?: Record<string, PendingWorkflowDecision>;
 };
-export declare function decodeAgentDefinition(value: unknown): AgentDefinition | undefined;
+export declare function decodePreparedAgentConfiguration(value: unknown): PreparedAgentConfiguration | undefined;
 export declare function decodeWorkflowExtensions(value: unknown): WorkflowExtensionSettings | undefined;
 export declare function decodePersistedRun(value: unknown, allowLegacyAgentSessions?: boolean): PersistedRun | undefined;
 export declare function isPersistedRun(value: unknown): value is PersistedRun;

package/dist/src/decoders.js

@@ -1,4 +1,4 @@
-import { AGENT_STATES, BUDGET_DIMENSIONS, BUDGET_EVENT_TYPES, RUN_STATES, isContextFileScope } from "./types.js";
+import { AGENT_STATES, BUDGET_DIMENSIONS, BUDGET_EVENT_TYPES, RUN_STATES, isContextFileScope, LAUNCH_SNAPSHOT_IDENTITY_VERSION } from "./types.js";
 import { finiteNumber, isThinkingLevel, isWorkflowErrorCode, jsonValue, object, positiveInteger, validWorkflowExtensionNamespace } from "./utils.js";
 const INVALID_PERSISTED_VALUE = Symbol("invalid persisted value");
 function integer(value) { return finiteNumber(value) && Number.isInteger(value); }
@@ -64,28 +64,21 @@ function decodeAgentResourceSelectors(value) {
     return { ...(skills === undefined ? {} : { skills }), ...(extensions === undefined ? {} : { extensions }), ...(tools === undefined ? {} : { tools }) };
 }
 function decodeContextFileScopes(value) { return decodeArray(value, (scope) => isContextFileScope(scope) ? scope : undefined); }
-export function decodeAgentDefinition(value) {
-    if (!object(value))
+export function decodePreparedAgentConfiguration(value) {
+    if (!object(value) || !jsonValue(value) || typeof value.projectTrusted !== "boolean" || typeof value.systemPromptAppend !== "string")
         return undefined;
-    const prompt = optionalString(value.prompt);
-    const description = optionalString(value.description);
-    const model = optionalString(value.model);
-    const thinking = value.thinking;
-    const tools = value.tools === undefined ? undefined : decodeStringArray(value.tools);
-    const skills = value.skills === undefined ? undefined : decodeStringArray(value.skills);
-    const extensions = value.extensions === undefined ? undefined : decodeStringArray(value.extensions);
-    const overrideSystemPrompt = optionalBoolean(value.overrideSystemPrompt);
+    const model = decodeModelSpec(value.model);
+    const tools = decodeStringArray(value.tools);
+    const skills = decodeStringArray(value.skills);
+    const extensions = decodeStringArray(value.extensions);
+    const settings = decodeWorkflowExtensions(value.settings);
     const contextFiles = value.contextFiles === undefined ? undefined : decodeContextFileScopes(value.contextFiles);
-    const extensionSettings = value.extensionSettings === undefined ? undefined : decodeWorkflowExtensions(value.extensionSettings);
-    if (prompt === INVALID_PERSISTED_VALUE || description === INVALID_PERSISTED_VALUE || model === INVALID_PERSISTED_VALUE || overrideSystemPrompt === INVALID_PERSISTED_VALUE)
-        return undefined;
-    if (thinking !== undefined && !isThinkingLevel(thinking) || value.tools !== undefined && !tools || value.skills !== undefined && !skills || value.extensions !== undefined && !extensions || value.contextFiles !== undefined && !contextFiles || value.extensionSettings !== undefined && !extensionSettings)
+    const label = optionalString(value.label);
+    const systemPrompt = optionalString(value.systemPrompt);
+    const excludeTools = value.excludeTools === undefined ? undefined : decodeStringArray(value.excludeTools);
+    if (!model || !tools || !skills || !extensions || !settings || label === INVALID_PERSISTED_VALUE || systemPrompt === INVALID_PERSISTED_VALUE || value.contextFiles !== undefined && !contextFiles || value.excludeTools !== undefined && !excludeTools)
         return undefined;
-    const foldedModel = typeof model === "string" && thinking !== undefined && !model.includes(":") ? `${model}:${thinking}` : model;
-    return {
-        ...(prompt === undefined ? {} : { prompt }), ...(description === undefined ? {} : { description }), ...(foldedModel === undefined ? {} : { model: foldedModel }),
-        ...(tools === undefined ? {} : { tools }), ...(skills === undefined ? {} : { skills }), ...(extensions === undefined ? {} : { extensions }), ...(overrideSystemPrompt === undefined ? {} : { overrideSystemPrompt }), ...(contextFiles === undefined ? {} : { contextFiles }), ...(extensionSettings === undefined ? {} : { extensionSettings }),
-    };
+    return { model, tools, skills, extensions, settings, projectTrusted: value.projectTrusted, systemPromptAppend: value.systemPromptAppend, ...(contextFiles === undefined ? {} : { contextFiles }), ...(excludeTools === undefined ? {} : { excludeTools }), ...(label === undefined ? {} : { label }), ...(systemPrompt === undefined ? {} : { systemPrompt }) };
 }
 function decodeWorkflowMetadata(value) {
     if (!object(value) || typeof value.name !== "string")
@@ -211,17 +204,25 @@ function decodeScheduledAgentOptions(value) {
     const parentBreadcrumb = optionalString(value.parentBreadcrumb);
     const worktreeOwner = optionalString(value.worktreeOwner);
     const model = optionalString(value.model);
-    const role = typeof value.role === "string" ? value.role : undefined;
     const contextFiles = value.contextFiles === undefined ? undefined : decodeContextFileScopes(value.contextFiles);
     const schema = value.schema === undefined ? undefined : decodeJsonObject(value.schema);
     const retries = optionalNumber(value.retries);
     const timeoutMs = value.timeoutMs;
+    if (value.projectTrusted !== undefined && typeof value.projectTrusted !== "boolean")
+        return undefined;
+    const rawCapabilities = value.capabilities;
+    const capabilities = rawCapabilities === undefined ? undefined : object(rawCapabilities) ? { tools: decodeStringArray(rawCapabilities.tools), skills: decodeStringArray(rawCapabilities.skills), extensions: decodeStringArray(rawCapabilities.extensions) } : undefined;
+    if (rawCapabilities !== undefined && (!capabilities?.tools || !capabilities.skills || !capabilities.extensions))
+        return undefined;
+    const configuration = value.configuration === undefined ? undefined : decodePreparedAgentConfiguration(value.configuration);
+    if (value.configuration !== undefined && configuration === undefined)
+        return undefined;
     const agentOptions = value.agentOptions === undefined ? undefined : decodeJsonObject(value.agentOptions);
     const agentIdentity = value.agentIdentity === undefined ? undefined : decodeIdentity(value.agentIdentity);
     const sessionPath = optionalString(value.sessionPath);
     const continuity = value.continuity === undefined ? undefined : isAgentContinuity(value.continuity) ? value.continuity : INVALID_PERSISTED_VALUE;
     const extensionSettings = value.extensionSettings === undefined ? undefined : decodeWorkflowExtensions(value.extensionSettings);
-    if (sessionPath === INVALID_PERSISTED_VALUE || continuity === INVALID_PERSISTED_VALUE || requestedLabel === INVALID_PERSISTED_VALUE || parentBreadcrumb === INVALID_PERSISTED_VALUE || worktreeOwner === INVALID_PERSISTED_VALUE || model === INVALID_PERSISTED_VALUE || value.skills !== undefined && !skills || value.extensions !== undefined && !extensions || (value.role !== undefined && typeof value.role !== "string") || (value.contextFiles !== undefined && !contextFiles) || (value.schema !== undefined && !schema) || retries === INVALID_PERSISTED_VALUE || (retries !== undefined && !integer(retries)) || (timeoutMs !== undefined && timeoutMs !== null && !finiteNumber(timeoutMs)) || (value.agentOptions !== undefined && !agentOptions) || (value.agentIdentity !== undefined && !agentIdentity) || (value.extensionSettings !== undefined && !extensionSettings))
+    if (sessionPath === INVALID_PERSISTED_VALUE || continuity === INVALID_PERSISTED_VALUE || requestedLabel === INVALID_PERSISTED_VALUE || parentBreadcrumb === INVALID_PERSISTED_VALUE || worktreeOwner === INVALID_PERSISTED_VALUE || model === INVALID_PERSISTED_VALUE || value.skills !== undefined && !skills || value.extensions !== undefined && !extensions || (value.contextFiles !== undefined && !contextFiles) || (value.schema !== undefined && !schema) || retries === INVALID_PERSISTED_VALUE || (retries !== undefined && !integer(retries)) || (timeoutMs !== undefined && timeoutMs !== null && !finiteNumber(timeoutMs)) || (value.agentOptions !== undefined && !agentOptions) || (value.agentIdentity !== undefined && !agentIdentity) || (value.extensionSettings !== undefined && !extensionSettings))
         return undefined;
     return {
         label: value.label,
@@ -232,7 +233,6 @@ function decodeScheduledAgentOptions(value) {
         ...(skills === undefined ? {} : { skills }), ...(extensions === undefined ? {} : { extensions }),
         ...(worktreeOwner === undefined ? {} : { worktreeOwner }),
         ...(model === undefined ? {} : { model }),
-        ...(role === undefined ? {} : { role }),
         ...(contextFiles === undefined ? {} : { contextFiles }),
         ...(schema === undefined ? {} : { schema }),
         ...(retries === undefined ? {} : { retries }),
@@ -240,6 +240,9 @@ function decodeScheduledAgentOptions(value) {
         ...(sessionPath === undefined ? {} : { sessionPath }),
         ...(continuity === undefined ? {} : { continuity }),
         ...(agentOptions === undefined ? {} : { agentOptions }),
+        ...(configuration === undefined ? {} : { configuration }),
+        ...(value.projectTrusted === undefined ? {} : { projectTrusted: value.projectTrusted }),
+        ...(capabilities?.tools && capabilities.skills && capabilities.extensions ? { capabilities: { tools: capabilities.tools, skills: capabilities.skills, extensions: capabilities.extensions } } : {}),
         ...(agentIdentity === undefined ? {} : { agentIdentity }),
         ...(extensionSettings === undefined ? {} : { extensionSettings }),
     };
@@ -288,12 +291,11 @@ function decodeAgentResourceInspection(value) {
     const sources = sourceRecord === undefined ? undefined : {
         global: decodeAgentResourceSelectors(sourceRecord.global),
         project: decodeAgentResourceSelectors(sourceRecord.project),
-        ...(sourceRecord.role === undefined ? {} : { role: decodeAgentResourceSelectors(sourceRecord.role) }),
         ...(sourceRecord.call === undefined ? {} : { call: decodeAgentResourceSelectors(sourceRecord.call) }),
     };
-    if (!selectors || !skills || !extensions || !tools || !unmatchedSkills || !unmatchedExtensions || !unmatchedTools || rawSources !== undefined && (!sources || !sources.global || !sources.project || sources.role === undefined && sourceRecord?.role !== undefined || sources.call === undefined && sourceRecord?.call !== undefined))
+    if (!selectors || !skills || !extensions || !tools || !unmatchedSkills || !unmatchedExtensions || !unmatchedTools || rawSources !== undefined && (!sources || !sources.global || !sources.project || sources.call === undefined && sourceRecord?.call !== undefined))
         return undefined;
-    return { selectors: { skills: [...(selectors.skills ?? [])], extensions: [...(selectors.extensions ?? [])], tools: [...(selectors.tools ?? [])] }, skills, extensions, tools, unmatchedSkills, unmatchedExtensions, unmatchedTools, ...(sources === undefined ? {} : { selectorSources: { global: sources.global ?? {}, project: sources.project ?? {}, ...(sources.role === undefined ? {} : { role: sources.role }), ...(sources.call === undefined ? {} : { call: sources.call }) } }) };
+    return { selectors: { skills: [...(selectors.skills ?? [])], extensions: [...(selectors.extensions ?? [])], tools: [...(selectors.tools ?? [])] }, skills, extensions, tools, unmatchedSkills, unmatchedExtensions, unmatchedTools, ...(sources === undefined ? {} : { selectorSources: { global: sources.global ?? {}, project: sources.project ?? {}, ...(sources.call === undefined ? {} : { call: sources.call }) } }) };
 }
 function decodeAgentSetupSummary(value) {
     if (!object(value) || typeof value.cwd !== "string")
@@ -337,7 +339,6 @@ function decodeAgent(value) {
     const worktreeOwner = optionalString(value.worktreeOwner);
     const handle = optionalString(value.handle);
     const continuity = value.continuity === undefined ? undefined : isAgentContinuity(value.continuity) ? value.continuity : INVALID_PERSISTED_VALUE;
-    const role = optionalString(value.role);
     const requestedModel = optionalString(value.requestedModel);
     const startedAt = optionalNumber(value.startedAt);
     const durationMs = optionalNumber(value.durationMs);
@@ -346,7 +347,7 @@ function decodeAgent(value) {
     const toolCalls = value.toolCalls === undefined ? undefined : decodeArray(value.toolCalls, decodeAgentToolCall);
     const activity = value.activity === undefined ? undefined : decodeAgentActivity(value.activity);
     const lastEventAt = optionalNumber(value.lastEventAt);
-    if (systemPrompt === INVALID_PERSISTED_VALUE || prompt === INVALID_PERSISTED_VALUE || label === INVALID_PERSISTED_VALUE || parentId === INVALID_PERSISTED_VALUE || resultPath === INVALID_PERSISTED_VALUE || parentBreadcrumb === INVALID_PERSISTED_VALUE || worktreeOwner === INVALID_PERSISTED_VALUE || role === INVALID_PERSISTED_VALUE || requestedModel === INVALID_PERSISTED_VALUE || startedAt === INVALID_PERSISTED_VALUE || durationMs === INVALID_PERSISTED_VALUE || lastEventAt === INVALID_PERSISTED_VALUE || handle === INVALID_PERSISTED_VALUE || continuity === INVALID_PERSISTED_VALUE || handle !== undefined && !positiveInteger(value.turn))
+    if (systemPrompt === INVALID_PERSISTED_VALUE || prompt === INVALID_PERSISTED_VALUE || label === INVALID_PERSISTED_VALUE || parentId === INVALID_PERSISTED_VALUE || resultPath === INVALID_PERSISTED_VALUE || parentBreadcrumb === INVALID_PERSISTED_VALUE || worktreeOwner === INVALID_PERSISTED_VALUE || requestedModel === INVALID_PERSISTED_VALUE || startedAt === INVALID_PERSISTED_VALUE || durationMs === INVALID_PERSISTED_VALUE || lastEventAt === INVALID_PERSISTED_VALUE || handle === INVALID_PERSISTED_VALUE || continuity === INVALID_PERSISTED_VALUE || handle !== undefined && !positiveInteger(value.turn))
         return undefined;
     if (!model || !tools || value.structuralPath !== undefined && !structuralPath || value.attemptDetails !== undefined && !attemptDetails || value.accounting !== undefined && !accounting || value.toolCalls !== undefined && !toolCalls || value.activity !== undefined && !activity)
         return undefined;
@@ -365,7 +366,6 @@ function decodeAgent(value) {
         ...(worktreeOwner === undefined ? {} : { worktreeOwner }),
         ...(handle === undefined ? {} : { handle, turn: value.turn }),
         ...(continuity === undefined ? {} : { continuity }),
-        ...(role === undefined ? {} : { role }),
         ...(requestedModel === undefined ? {} : { requestedModel }),
         model,
         tools,
@@ -434,6 +434,28 @@ function decodeRunEvent(value) {
         return undefined;
     return { type: value.type, message: value.message, ...(timestamp === undefined ? {} : { timestamp }) };
 }
+function decodeScriptCall(value) {
+    if (!object(value) || value.kind !== "shell" && value.kind !== "tool" || typeof value.name !== "string" || typeof value.path !== "string" || !finiteNumber(value.startedAt))
+        return undefined;
+    const shell = value.kind === "shell";
+    if (shell && !jsonValue(value.input))
+        return undefined;
+    const inputBytes = shell ? optionalNumber(value.inputBytes) : undefined;
+    const phase = optionalString(value.phase);
+    const finishedAt = optionalNumber(value.finishedAt);
+    let error;
+    if (value.error !== undefined) {
+        if (shell)
+            error = decodeWorkflowError(value.error);
+        else if (object(value.error) && typeof value.error.code === "string")
+            error = { code: isWorkflowErrorCode(value.error.code) ? value.error.code : "INTERNAL_ERROR" };
+        if (!error)
+            return undefined;
+    }
+    if (inputBytes === INVALID_PERSISTED_VALUE || phase === INVALID_PERSISTED_VALUE || finishedAt === INVALID_PERSISTED_VALUE)
+        return undefined;
+    return { kind: value.kind, name: value.name, path: value.path, ...(shell && jsonValue(value.input) ? { input: value.input } : {}), ...(inputBytes === undefined ? {} : { inputBytes }), ...(phase === undefined ? {} : { phase }), startedAt: value.startedAt, ...(finishedAt === undefined ? {} : { finishedAt }), ...(error === undefined ? {} : { error }) };
+}
 function decodeDelivery(value) {
     if (!object(value))
         return undefined;
@@ -467,6 +489,9 @@ export function decodePersistedRun(value, allowLegacyAgentSessions = false) {
     const budgetEvents = value.budgetEvents === undefined ? undefined : decodeArray(value.budgetEvents, decodeBudgetEvent);
     const events = value.events === undefined ? undefined : decodeArray(value.events, decodeRunEvent);
     const delivery = value.delivery === undefined ? undefined : decodeDelivery(value.delivery);
+    const scriptCalls = value.scriptCalls === undefined ? undefined : decodeArray(value.scriptCalls, decodeScriptCall);
+    if (value.scriptCalls !== undefined && !scriptCalls)
+        return undefined;
     if (!agentSessions || !agents || parentRunId === INVALID_PERSISTED_VALUE || value.retry !== undefined && !retry || phase === INVALID_PERSISTED_VALUE || value.phaseHistory !== undefined && !phaseHistory || phaseHistoryIndex === INVALID_PERSISTED_VALUE || activeShells === INVALID_PERSISTED_VALUE || activeShellStartedAt === INVALID_PERSISTED_VALUE || value.activeShellsByPhase !== undefined && !activeShellsByPhase || value.error !== undefined && !error || failedAt === INVALID_PERSISTED_VALUE || value.budget !== undefined && !budget || budgetVersion === INVALID_PERSISTED_VALUE || value.budgetVersion !== undefined && !integer(budgetVersion) || value.usage !== undefined && !usage || value.budgetEvents !== undefined && !budgetEvents || value.events !== undefined && !events || value.delivery !== undefined && !delivery)
         return undefined;
     if (value.agentSessions === undefined && !allowLegacyAgentSessions)
@@ -487,6 +512,7 @@ export function decodePersistedRun(value, allowLegacyAgentSessions = false) {
         ...(activeShells === undefined ? {} : { activeShells }),
         ...(activeShellStartedAt === undefined ? {} : { activeShellStartedAt }),
         ...(activeShellsByPhase === undefined ? {} : { activeShellsByPhase }),
+        ...(scriptCalls === undefined ? {} : { scriptCalls }),
         ...(error === undefined ? {} : { error }),
         ...(failedAt === undefined ? {} : { failedAt }),
         ...(budget === undefined ? {} : { budget }),
@@ -513,14 +539,12 @@ export function decodeLaunchSnapshot(value) {
     const phases = value.phases === undefined ? undefined : decodeStringArray(value.phases);
     const models = decodeStringArray(value.models);
     const tools = decodeStringArray(value.tools);
-    const agentTypes = decodeStringArray(value.agentTypes);
-    const roles = value.roles === undefined ? undefined : decodeRecord(value.roles, decodeAgentDefinition);
-    const projectRoles = value.projectRoles === undefined ? undefined : decodeStringArray(value.projectRoles);
+    const agentConfigurations = decodeRecord(value.agentConfigurations, decodePreparedAgentConfiguration);
     const schemas = decodeArray(value.schemas, decodeJsonObject);
-    if (identityVersion === INVALID_PERSISTED_VALUE || value.identityVersion !== undefined && !integer(identityVersion) || launchMode !== undefined && !isLaunchMode(launchMode) || args === undefined || !metadata || !settings || value.settingsSources !== undefined && !settingsSources || value.budget !== undefined && !budget || settingsPath === INVALID_PERSISTED_VALUE || value.modelAliases !== undefined && !modelAliases || value.phases !== undefined && !phases || !models || !tools || !agentTypes || value.roles !== undefined && !roles || value.projectRoles !== undefined && !projectRoles || !schemas)
+    if (identityVersion !== LAUNCH_SNAPSHOT_IDENTITY_VERSION || launchMode !== undefined && !isLaunchMode(launchMode) || args === undefined || !metadata || !settings || value.settingsSources !== undefined && !settingsSources || value.budget !== undefined && !budget || settingsPath === INVALID_PERSISTED_VALUE || value.modelAliases !== undefined && !modelAliases || value.phases !== undefined && !phases || !models || !tools || !agentConfigurations || !schemas)
         return undefined;
     return {
-        ...(identityVersion === undefined ? {} : { identityVersion }),
+        identityVersion: LAUNCH_SNAPSHOT_IDENTITY_VERSION,
         ...(launchMode === undefined ? {} : { launchMode }),
         script: value.script,
         args,
@@ -533,9 +557,7 @@ export function decodeLaunchSnapshot(value) {
         ...(phases === undefined ? {} : { phases }),
         models,
         tools,
-        agentTypes,
-        ...(roles === undefined ? {} : { roles }),
-        ...(projectRoles === undefined ? {} : { projectRoles }),
+        agentConfigurations,
         schemas,
     };
 }

package/dist/src/execution.d.ts

@@ -1,10 +1,14 @@
 import { RunStore } from "./persistence.js";
 import type { AgentAttempt } from "./agent-execution.js";
-import type { AgentIdentity, JsonValue, ShellIdentity, ShellOptions, ShellResult, WorkflowBridge, WorkflowExecution } from "./types.js";
+import type { AgentIdentity, JsonValue, ShellIdentity, ShellOptions, ShellResult, ToolIdentity, WorkflowBridge, WorkflowExecution } from "./types.js";
 export declare const RPC_LIMIT_BYTES: number;
 export declare const HEARTBEAT_TIMEOUT_MS = 5000;
+/** Script handle names may not start with this: registered-function handles are journaled under it. */
+export declare const FUNCTION_HANDLE_PREFIX = "function-handle";
 export declare function encoded(value: JsonValue): string;
 export declare function encoded(value: unknown): asserts value is JsonValue;
+/** The journal path of a script tool call; the arguments' digest keeps calls with different arguments apart whatever order they start in. */
+export declare function toolIdentityPath(identifier: string, args: JsonValue, identity: ToolIdentity): string;
 export declare function agentHandleTurnPath(handle: string, turn: number): string;
 export declare function agentIdentityPath(identity: AgentIdentity): string;
 export declare function shellIdentityPath(identity: ShellIdentity): string;
@@ -16,4 +20,4 @@ export declare function executeShellCommand(command: string, options: ShellOptio
 export declare function runWorkflow(script: string, args?: JsonValue, bridge?: WorkflowBridge, signal?: AbortSignal): WorkflowExecution;
 export declare function persistActiveAgentAttempt(store: RunStore, id: string, active: AgentAttempt): Promise<void>;
 export declare function persistAgentAttempts(store: RunStore, id: string, attempts: readonly AgentAttempt[]): Promise<void>;
-export type { AgentIdentity, FunctionIdentity, ShellIdentity, WorkflowBridge, WorkflowExecution } from "./types.js";
+export type { AgentIdentity, FunctionIdentity, ShellIdentity, ToolIdentity, WorkflowBridge, WorkflowExecution } from "./types.js";

package/dist/src/execution.js

@@ -4,8 +4,8 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { StringDecoder } from "node:string_decoder";
 import { structuralPath as operationPath } from "./persistence.js";
-import { WorkflowError, roleNameOf, sumAccounting, zeroAccounting } from "./types.js";
-import { asWorkflowError, errorText, fail, isWorkflowAuthored, isWorkflowErrorCode, jsonValue, markWorkflowAuthored, object, positiveInteger } from "./utils.js";
+import { WorkflowError, sumAccounting, zeroAccounting } from "./types.js";
+import { asWorkflowError, errorText, fail, isWorkflowAuthored, isWorkflowErrorCode, jsonDigest, jsonValue, markWorkflowAuthored, object, positiveInteger } from "./utils.js";
 import { instrumentWorkflow, validateAgentOptions, validateShellCommand, validateShellOptions } from "./validation.js";
 export const RPC_LIMIT_BYTES = 10 * 1024 * 1024;
 export const HEARTBEAT_TIMEOUT_MS = 5000;
@@ -35,6 +35,8 @@ function isRpcMessage(value) {
 }
 const HEARTBEAT_INTERVAL_MS = 1000;
 const OUTCOME_ERRORS = new Set(["AGENT_TIMEOUT", "AGENT_FAILED", "RESULT_INVALID"]);
+/** Script handle names may not start with this: registered-function handles are journaled under it. */
+export const FUNCTION_HANDLE_PREFIX = "function-handle";
 const WORK_RESULT_BRAND = "__workResult";
 const childSource = String.raw `
 "use strict";
@@ -145,15 +147,13 @@ const internalAgent = (...values) => {
   void result.then(() => agentInflight.delete(occurrenceKey), () => agentInflight.delete(occurrenceKey));
   return guardedAgentResult(result);
 };
-const AGENT_HANDLE_KEYS = ["name", "role", "model", "tools", "skills", "extensions", "contextFiles", "label"];
 const agentHandleNames = new Set();
 const agentHandleInflight = new Set();
 const internalAgentCreate = (...values) => {
   if (values.length !== 1 || !values[0] || typeof values[0] !== "object" || Array.isArray(values[0])) throw workError("INVALID_METADATA", "agent.create requires one options object");
   const options = values[0];
   const name = named(options.name, "agent.create");
-  const unsupported = Object.keys(options).find(key => !AGENT_HANDLE_KEYS.includes(key));
-  if (unsupported) throw workError("INVALID_METADATA", "agent.create option is unsupported: " + unsupported);
+  if (name.startsWith("${FUNCTION_HANDLE_PREFIX}/")) throw workError("INVALID_METADATA", "Agent handle names may not start with ${FUNCTION_HANDLE_PREFIX}/");
   if (agentHandleNames.has(name)) throw workError("INVALID_METADATA", "Duplicate agent handle name: " + name);
   agentHandleNames.add(name);
   const config = Object.freeze(Object.fromEntries(Object.entries(options).filter(([key]) => key !== "name")));
@@ -268,6 +268,30 @@ const functions = Object.freeze(Object.fromEntries(Object.entries(config.functio
   Object.defineProperty(result, "toJSON", { value() { throw workError("INVALID_METADATA", "Workflow function result is a Promise; await it before serialization"); } });
   return result;
 }])));
+// tools.<id>(args) runs a Pi session tool through the host. Any identifier resolves, so a resumed run
+// replays journaled calls even when the tool is gone; the host rejects identifiers it cannot call.
+// A call is the n-th call with the same arguments in its scope, so replay does not depend on the
+// order in which concurrent calls start.
+const NOT_TOOLS = new Set(["then", "toJSON", "toString", "valueOf", "constructor"]);
+const sortedJson = value => Array.isArray(value) ? value.map(sortedJson) : value && typeof value === "object" ? Object.fromEntries(Object.keys(value).sort().map(key => [key, sortedJson(value[key])])) : value;
+const toolOccurrences = new Map();
+const toolCall = id => (...values) => {
+  if (worktreeOwners.getStore()) throw workError("INVALID_METADATA", "tools." + id + " is unavailable inside withWorktree: session tools resolve paths against the session working directory");
+  if (values.length > 1 || values[0] !== undefined && (!values[0] || typeof values[0] !== "object" || Array.isArray(values[0]))) throw workError("INVALID_METADATA", "tools." + id + " takes one arguments object");
+  const args = values[0] === undefined ? {} : values[0];
+  const structuralPath = inheritedAgentPath.getStore() || [];
+  const key = JSON.stringify([structuralPath, id, sortedJson(args)]);
+  const occurrence = (toolOccurrences.get(key) || 0) + 1;
+  toolOccurrences.set(key, occurrence);
+  return guardedResult(rpc("tool", [id, args, { structuralPath: [...structuralPath], occurrence }]), "tool");
+};
+const tools = new Proxy(Object.create(null), {
+  get: (_target, key) => typeof key === "string" && !NOT_TOOLS.has(key) ? toolCall(key) : undefined,
+  // Probing would branch on the session that resumed the run; the launch already checks named tools.
+  has: () => { throw workError("INVALID_METADATA", "Workflow scripts cannot probe tools with 'in'; call tools.<name>(...) directly, and the launch checks that the tool exists"); },
+  set: () => false,
+  defineProperty: () => false,
+});
 const recordEntries = (value, kind) => {
   if (!value || typeof value !== "object" || Array.isArray(value)) throw workError("INVALID_METADATA", kind + " must be a record");
   return Object.entries(value);
@@ -328,7 +352,7 @@ const pipeline = async (operationName, items, stages) => {
   return Object.fromEntries(results.map(result => [result.name, result.value]));
 };
 const safeMath = Object.fromEntries(Object.getOwnPropertyNames(Math).filter(name => name !== "random").map(name => [name, Math[name]]));
-const sandbox = { agent, shell, withWorktree: rejectWorktree, prompt, checkpoint, parallel, pipeline, phase, log, args: config.args, Promise, JSON, Math: Object.freeze(safeMath) };
+const sandbox = { agent, shell, withWorktree: rejectWorktree, prompt, checkpoint, parallel, pipeline, phase, log, tools, args: config.args, Promise, JSON, Math: Object.freeze(safeMath) };
 for (const [name, fn] of Object.entries(functions)) Object.defineProperty(sandbox, name, { value: fn, writable: false, configurable: false });
 for (const name of ["Date","eval","Function","WebAssembly","process","require","module","exports","console","fetch","XMLHttpRequest","WebSocket","performance","crypto","setTimeout","setInterval","setImmediate","queueMicrotask","Intl","SharedArrayBuffer","Atomics"]) sandbox[name] = undefined;
 const context = vm.createContext(sandbox, { codeGeneration: { strings: false, wasm: false } });
@@ -378,6 +402,15 @@ function readShellIdentity(value) {
     const identity = readAgentIdentity(value);
     return { structuralPath: identity.structuralPath, callSite: identity.callSite, occurrence: identity.occurrence, ...(identity.worktreeOwner ? { worktreeOwner: identity.worktreeOwner } : {}) };
 }
+function readToolIdentity(value) {
+    if (!object(value) || !Array.isArray(value.structuralPath) || !value.structuralPath.every((part) => typeof part === "string" && Boolean(part.trim())) || !positiveInteger(value.occurrence))
+        fail("INTERNAL_ERROR", "Invalid workflow tool identity");
+    return { structuralPath: [...value.structuralPath], occurrence: value.occurrence };
+}
+/** The journal path of a script tool call; the arguments' digest keeps calls with different arguments apart whatever order they start in. */
+export function toolIdentityPath(identifier, args, identity) {
+    return operationPath("tool", ...identity.structuralPath, identifier, `args:${jsonDigest(args)}`, String(identity.occurrence));
+}
 export function agentHandleTurnPath(handle, turn) {
     return operationPath("agent", "handle", handle, `turn:${String(turn)}`);
 }
@@ -622,7 +655,7 @@ export function runWorkflow(script, args = null, bridge = {}, signal) {
                 const opts = validateAgentOptions(values[1]);
                 const identity = readAgentIdentity(values[2]);
                 const path = agentIdentityPath(identity);
-                const label = typeof opts.label === "string" ? opts.label : roleNameOf(opts.role) ?? "agent";
+                const label = typeof opts.label === "string" ? opts.label : "agent";
                 try {
                     const result = await bridge.agent(values[0], opts, controller.signal, identity);
                     value = branded({ name: label, ok: true, value: result ?? null });
@@ -681,6 +714,14 @@ export function runWorkflow(script, args = null, bridge = {}, signal) {
                     value = branded({ name, ok: false, failedAt: name, error: workerErrorShape(typed) });
                 }
             }
+            else if (method === "tool") {
+                if (typeof values[0] !== "string" || !object(values[1]))
+                    fail("INTERNAL_ERROR", "tool requires an identifier and object arguments");
+                const identity = readToolIdentity(values[2]);
+                if (!bridge.tool)
+                    fail("UNKNOWN_TOOL", `tools.${values[0]} is unavailable: this run has no session tools`);
+                value = await bridge.tool(values[0], values[1], controller.signal, identity);
+            }
             else if (method === "worktree") {
                 if (!bridge.worktree || typeof values[0] !== "string" || !values[0])
                     fail("INTERNAL_ERROR", "worktree requires an active host bridge and scope");

package/dist/src/host-delivery.js

@@ -101,13 +101,14 @@ const WORKFLOW_ERROR_PROSE = {
     REGISTRY_FROZEN: (detail) => `Workflow extension registration is closed: ${detail}.`,
     GLOBAL_COLLISION: (detail) => `The workflow global name is already in use: ${detail}.`,
     MISSING_WORKFLOW: (detail) => `The registered workflow function is unavailable: ${detail}.`,
-    UNKNOWN_MODEL: (detail) => `The workflow requested the unavailable model ${detail.replace(/^(?:Unknown model(?: for role [^:]+)?|Invalid model spec):\s*/, "")}.`,
+    UNKNOWN_MODEL: (detail) => `The workflow requested the unavailable model ${detail.replace(/^(?:Unknown model|Invalid model spec|Required model is unavailable):\s*/, "")}.`,
     UNKNOWN_TOOL: (detail) => `The workflow requested the unavailable tool ${detail.replace(/^Unknown tool:\s*/, "")}.`,
-    UNKNOWN_AGENT_TYPE: (detail) => `The workflow requested the unavailable agent role ${detail.replace(/^Unknown agent role:\s*/, "")}.`,
+    UNKNOWN_AGENT: (detail) => `The workflow requested an unavailable owned agent: ${detail}.`,
     RUN_OWNED: (detail) => /already owned|active ownership/.test(detail) ? "The workflow session is already in use." : `The workflow session is already in use: ${detail}.`,
     RUN_NOT_FOUND: (detail) => /^Unknown workflow run\b/.test(detail) ? "The workflow run was not found." : `The workflow run was not found: ${detail}.`,
     RPC_LIMIT_EXCEEDED: (detail) => `The workflow communication data exceeded its size limit: ${detail}.`,
     SHELL_FAILED: (detail) => `The workflow shell command failed: ${detail}.`,
+    TOOL_FAILED: (detail) => `The workflow tool call failed: ${detail}.`,
     AGENT_TIMEOUT: (detail) => `The workflow agent timed out: ${detail}.`,
     AGENT_FAILED: (detail) => `The workflow agent failed: ${detail}.`,
     AGENT_RESULT_COLLECTED: (detail) => `The nested agent result was already collected: ${detail}.`,
@@ -204,7 +205,6 @@ function boundedWorkflowFailureDiagnostics(value) {
         ...(value.failedAgent ? { failedAgent: {
                 id: utf8Prefix(value.failedAgent.id, 128),
                 ...(value.failedAgent.label ? { label: utf8Prefix(value.failedAgent.label, 128) } : {}),
-                ...(value.failedAgent.role ? { role: utf8Prefix(value.failedAgent.role, 128) } : {}),
                 structuralPath: value.failedAgent.structuralPath.slice(0, 8).map((part) => utf8Prefix(part, 128)),
                 attempt: value.failedAgent.attempt,
                 ...(value.failedAgent.transport ? { transport: utf8Prefix(value.failedAgent.transport, 128) } : {}),
@@ -213,7 +213,6 @@ function boundedWorkflowFailureDiagnostics(value) {
         completedSiblingAgents: (value.completedSiblingAgents ?? []).slice(0, 16).map((agent) => ({
             id: utf8Prefix(agent.id, 128),
             ...(agent.label ? { label: utf8Prefix(agent.label, 128) } : {}),
-            ...(agent.role ? { role: utf8Prefix(agent.role, 128) } : {}),
             structuralPath: agent.structuralPath.slice(0, 8).map((part) => utf8Prefix(part, 128)),
         })),
         completedSiblingPaths: value.completedSiblingPaths.slice(0, 16).map((path) => path.slice(0, 8).map((part) => utf8Prefix(part, 128))),
@@ -305,7 +304,6 @@ export async function createWorkflowFailureDiagnostics(store, metadata, error, r
     const failedAgent = failedAgentRecord ? {
         id: failedAgentRecord.id,
         ...(failedAgentRecord.label ?? failedAgentRecord.name ? { label: failedAgentRecord.label ?? failedAgentRecord.name } : {}),
-        ...(failedAgentRecord.role ? { role: failedAgentRecord.role } : {}),
         structuralPath: [...(failedAgentRecord.structuralPath ?? [])],
         attempt: Math.max(1, failedAttempt?.attempt ?? failedAgentRecord.attempts),
         ...(failedAttempt?.transport ? { transport: failedAttempt.transport } : {}),
@@ -318,7 +316,6 @@ export async function createWorkflowFailureDiagnostics(store, metadata, error, r
     }).map((agent) => ({
         id: agent.id,
         ...(agent.label ?? agent.name ? { label: agent.label ?? agent.name } : {}),
-        ...(agent.role ? { role: agent.role } : {}),
         structuralPath: [...(agent.structuralPath ?? [])],
     }));
     const completedSiblingPaths = completedSiblingAgents.map((agent) => [...agent.structuralPath]);
@@ -346,9 +343,9 @@ export async function createWorkflowFailureDiagnostics(store, metadata, error, r
     });
 }
 export function formatWorkflowFailureDiagnostics(diagnostic) {
-    const failedAgent = diagnostic.failedAgent ? `${diagnostic.failedAgent.label ?? diagnostic.failedAgent.id}${diagnostic.failedAgent.role ? ` role=${diagnostic.failedAgent.role}` : ""} attempt=${String(diagnostic.failedAgent.attempt)} path=${diagnostic.failedAgent.structuralPath.join(" > ") || "(root)"}${diagnostic.failedAgent.session ? ` session=${diagnostic.failedAgent.session.transport}/${diagnostic.failedAgent.session.sessionId}` : ""}` : "(not persisted)";
+    const failedAgent = diagnostic.failedAgent ? `${diagnostic.failedAgent.label ?? diagnostic.failedAgent.id} attempt=${String(diagnostic.failedAgent.attempt)} path=${diagnostic.failedAgent.structuralPath.join(" > ") || "(root)"}${diagnostic.failedAgent.session ? ` session=${diagnostic.failedAgent.session.transport}/${diagnostic.failedAgent.session.sessionId}` : ""}` : "(not persisted)";
     const siblingAgents = diagnostic.completedSiblingAgents;
-    const siblings = siblingAgents ? siblingAgents.map((agent) => `${agent.label ?? agent.id}${agent.role ? ` role=${agent.role}` : ""} path=${agent.structuralPath.join(" > ") || "(root)"}`).join(", ") || "(none)" : diagnostic.completedSiblingPaths.map((path) => path.join(" > ") || "(root)").join(", ") || "(none)";
+    const siblings = siblingAgents ? siblingAgents.map((agent) => `${agent.label ?? agent.id} path=${agent.structuralPath.join(" > ") || "(root)"}`).join(", ") || "(none)" : diagnostic.completedSiblingPaths.map((path) => path.join(" > ") || "(root)").join(", ") || "(none)";
     const retry = diagnostic.retry ? [`  Retry: ${diagnostic.retry.action}`, `  Replayable completed paths: ${diagnostic.retry.completedPaths.join(", ") || "(none)"}`, `  Incomplete paths: ${diagnostic.retry.incompletePaths.join(", ") || "(unknown)"}`, `  Named worktrees: ${diagnostic.retry.namedWorktrees.join(", ") || "(none)"}`, `  Warning: ${diagnostic.retry.warning}`] : [];
     return [`✗ Workflow: ${diagnostic.workflowName}`, `  Run: ${diagnostic.runId}`, `  State: ${diagnostic.state}`, `  Error: ${diagnostic.error.code}: ${diagnostic.error.message}`, `  Failed at: ${diagnostic.failedAt ?? "(unknown)"}`, `  Failed agent: ${failedAgent}`, `  Completed sibling ${siblingAgents ? "agents" : "paths"}: ${siblings}`, ...retry, `  Artifacts: state=${diagnostic.artifacts.statePath} journal=${diagnostic.artifacts.journalPath}`].join("\n");
 }

package/dist/src/host-navigator.js

@@ -827,9 +827,10 @@ export function registerWorkflowNavigator(deps) {
                                         const styles = themeWorkflowProgressStyles(theme);
                                         const agent = selectedAgentRecord();
                                         const actions = actionMode ? { title: agent ? "Agent actions" : "Run actions", options: actionOptions(), index: actionIndex } : undefined;
-                                        const phaseLines = formatWorkflowPhaseDashboard(view.run, view.snapshot, width, { nodeId: selectedNodeId, expandedNodeIds: [...expandedNodeIds], ...(narrow && !detailsMode && !actionMode ? { treeOnly: true } : {}), ...(narrow && (detailsMode || actionMode) ? { detailsOnly: true } : {}), ...(actions ? { actions } : {}) }, styles, progressNow());
+                                        const formatPhaseLines = (scrollTop) => formatWorkflowPhaseDashboard(view.run, view.snapshot, width, { scrollTop, nodeId: selectedNodeId, expandedNodeIds: [...expandedNodeIds], ...(narrow && !detailsMode && !actionMode ? { treeOnly: true } : {}), ...(narrow && (detailsMode || actionMode) ? { detailsOnly: true } : {}), ...(actions ? { actions } : {}) }, styles, progressNow());
+                                        const phaseLines = formatPhaseLines(0);
                                         const statusLines = stopStatus ? truncateToVisualLines(styles.error(stopStatus), Number.MAX_SAFE_INTEGER, width, 0).visualLines.map((line) => line.trimEnd()) : [];
-                                        const content = [...statusLines, ...phaseLines];
+                                        let content = [...statusLines, ...phaseLines];
                                         const rows = terminalRows();
                                         const hintRows = rows >= 3 ? 1 : 0;
                                         const confirmRows = inlineConfirm.rows(width, styles);
@@ -857,6 +858,8 @@ export function registerWorkflowNavigator(deps) {
                                             selectionNeedsScroll = false;
                                         }
                                         dashboardOffset = Math.max(0, Math.min(maxOffset, dashboardOffset));
+                                        if (!narrow && !actionMode)
+                                            content = [...statusLines, ...formatPhaseLines(Math.max(0, dashboardOffset - statusLines.length))];
                                         const selectedNode = selectedNodeId ? tree.byId.get(selectedNodeId) : undefined;
                                         const enterAction = selectedNode?.kind === "workflow" ? "run actions" : selectedNode?.kind === "agent" ? "agent actions" : selectedNode?.children.length ? "expand/collapse" : narrow ? "inspect" : "focus details";
                                         const hint = truncateToVisualLines(theme.fg("dim", inlineConfirm.active() ? inlineConfirm.hint(keybindings) : actionMode ? `${keyLabel("tui.select.up", "↑")}/${keyLabel("tui.select.down", "↓")} actions · ${keyLabel("tui.select.confirm", "enter")} run · ${keyLabel("tui.editor.cursorLeft", "←")} tree · ${keyLabel("tui.select.cancel", "esc")} tree` : `${keyLabel("tui.select.up", "↑")}/${keyLabel("tui.select.down", "↓")} tree · ${keyLabel("tui.editor.cursorLeft", "←")}/${keyLabel("tui.editor.cursorRight", "→")} collapse/expand · ${keyLabel("tui.select.confirm", "enter")} ${enterAction} · a actions · ${keyLabel("tui.select.cancel", "esc")} ${narrow && detailsMode ? "tree" : "back"}${content.length > viewport ? ` · ${keyLabel("tui.select.pageUp", "pgup")}/${keyLabel("tui.select.pageDown", "pgdn")} scroll` : ""} · auto-refresh 1s`), Number.MAX_SAFE_INTEGER, width, 1).visualLines[0] ?? "";

package/dist/src/host-phases.d.ts

@@ -45,6 +45,7 @@ export interface WorkflowPhaseSelection {
     expandedNodeIds?: readonly string[] | undefined;
     treeOnly?: boolean | undefined;
     detailsOnly?: boolean | undefined;
+    scrollTop?: number | undefined;
     actions?: {
         title: string;
         options: readonly string[];