@marcoscale98/pi-extensible-workflows 5.14.1-fork.1 → 5.19.1-fork.1

package/dist/trajectory/index.js

@@ -5,7 +5,7 @@ import { mkdir as mkdir3, open as open3, readFile as readFile6, rm as rm5 } from
 import { existsSync } from "node:fs";
 import { dirname as dirname5, join as join8 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
-import { getAgentDir as getAgentDir3 } from "@earendil-works/pi-coding-agent";
+import { getAgentDir as getAgentDir4 } from "@earendil-works/pi-coding-agent";
 
 // src/trajectory-host-handle.ts
 var TRAJECTORY_HOST_KEY = /* @__PURE__ */ Symbol.for("pi-extensible-workflows.trajectory-host");
@@ -47,6 +47,7 @@ var ERROR_CODES = [
   "AGENT_FAILED",
   "AGENT_RESULT_COLLECTED",
   "RESULT_INVALID",
+  "TOOL_FAILED",
   "CANCELLED",
   "WORKER_UNRESPONSIVE",
   "WORKTREE_FAILED",
@@ -260,6 +261,12 @@ function resourcePatternHasMagic(pattern) {
 function loadLaunchSnapshot(input) {
   return deepFreeze(structuredClone(input));
 }
+function validateSchema(schema, at = "schema") {
+  if (!object(schema) || Object.getPrototypeOf(schema) !== Object.prototype || !jsonValue(schema)) fail("INVALID_SCHEMA", `${at} must be a plain JSON-compatible Schema object`);
+  if (typeof schema.type !== "string" && !Array.isArray(schema.type) && schema.$ref === void 0 && schema.anyOf === void 0 && schema.oneOf === void 0 && schema.allOf === void 0 && schema.const === void 0 && schema.enum === void 0) fail("INVALID_SCHEMA", `${at} has no JSON Schema shape`);
+  if (schema.required !== void 0 && (!Array.isArray(schema.required) || schema.required.some((key) => typeof key !== "string"))) fail("INVALID_SCHEMA", `${at}.required must be an array of strings`);
+  if (schema.properties !== void 0 && !object(schema.properties)) fail("INVALID_SCHEMA", `${at}.properties must be an object`);
+}
 
 // src/decoders.ts
 var INVALID_PERSISTED_VALUE = /* @__PURE__ */ Symbol("invalid persisted value");
@@ -394,7 +401,7 @@ function decodeWorkflowExtensions(value) {
     }
     if (namespace === "trajectory") {
       if (!object(raw) || Object.keys(raw).some((key) => key !== "port" && key !== "themes") || raw.port !== void 0 && (typeof raw.port !== "number" || !Number.isSafeInteger(raw.port) || raw.port < 1 || raw.port > 65535) || raw.themes !== void 0 && typeof raw.themes !== "boolean") return void 0;
-      normalized.trajectory = { ...raw.port === void 0 ? {} : { port: raw.port }, ...raw.themes === void 0 ? {} : { themes: raw.themes } };
+      normalized.trajectory = { ...raw.port === void 0 ? {} : { port: raw.port } };
       continue;
     }
     if (!jsonValue(raw)) return void 0;
@@ -678,6 +685,22 @@ function decodeRunEvent(value) {
   if (timestamp === INVALID_PERSISTED_VALUE) return void 0;
   return { type: value.type, message: value.message, ...timestamp === void 0 ? {} : { 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 void 0;
+  const shell = value.kind === "shell";
+  if (shell && !jsonValue(value.input)) return void 0;
+  const inputBytes = shell ? optionalNumber(value.inputBytes) : void 0;
+  const phase = optionalString(value.phase);
+  const finishedAt = optionalNumber(value.finishedAt);
+  let error;
+  if (value.error !== void 0) {
+    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 void 0;
+  }
+  if (inputBytes === INVALID_PERSISTED_VALUE || phase === INVALID_PERSISTED_VALUE || finishedAt === INVALID_PERSISTED_VALUE) return void 0;
+  return { kind: value.kind, name: value.name, path: value.path, ...shell && jsonValue(value.input) ? { input: value.input } : {}, ...inputBytes === void 0 ? {} : { inputBytes }, ...phase === void 0 ? {} : { phase }, startedAt: value.startedAt, ...finishedAt === void 0 ? {} : { finishedAt }, ...error === void 0 ? {} : { error } };
+}
 function decodeDelivery(value) {
   if (!object(value)) return void 0;
   const mode = value.mode;
@@ -707,6 +730,8 @@ function decodePersistedRun(value, allowLegacyAgentSessions = false) {
   const budgetEvents = value.budgetEvents === void 0 ? void 0 : decodeArray(value.budgetEvents, decodeBudgetEvent);
   const events = value.events === void 0 ? void 0 : decodeArray(value.events, decodeRunEvent);
   const delivery = value.delivery === void 0 ? void 0 : decodeDelivery(value.delivery);
+  const scriptCalls = value.scriptCalls === void 0 ? void 0 : decodeArray(value.scriptCalls, decodeScriptCall);
+  if (value.scriptCalls !== void 0 && !scriptCalls) return void 0;
   if (!agentSessions || !agents || parentRunId === INVALID_PERSISTED_VALUE || value.retry !== void 0 && !retry || phase === INVALID_PERSISTED_VALUE || value.phaseHistory !== void 0 && !phaseHistory || phaseHistoryIndex === INVALID_PERSISTED_VALUE || activeShells === INVALID_PERSISTED_VALUE || activeShellStartedAt === INVALID_PERSISTED_VALUE || value.activeShellsByPhase !== void 0 && !activeShellsByPhase || value.error !== void 0 && !error || failedAt === INVALID_PERSISTED_VALUE || value.budget !== void 0 && !budget || budgetVersion === INVALID_PERSISTED_VALUE || value.budgetVersion !== void 0 && !integer(budgetVersion) || value.usage !== void 0 && !usage || value.budgetEvents !== void 0 && !budgetEvents || value.events !== void 0 && !events || value.delivery !== void 0 && !delivery) return void 0;
   if (value.agentSessions === void 0 && !allowLegacyAgentSessions) return void 0;
   return {
@@ -725,6 +750,7 @@ function decodePersistedRun(value, allowLegacyAgentSessions = false) {
     ...activeShells === void 0 ? {} : { activeShells },
     ...activeShellStartedAt === void 0 ? {} : { activeShellStartedAt },
     ...activeShellsByPhase === void 0 ? {} : { activeShellsByPhase },
+    ...scriptCalls === void 0 ? {} : { scriptCalls },
     ...error === void 0 ? {} : { error },
     ...failedAt === void 0 ? {} : { failedAt },
     ...budget === void 0 ? {} : { budget },
@@ -1012,8 +1038,8 @@ async function listRunIds(cwd, sessionId, home = homedir2(), cleanTemps = true)
 // src/trajectory.ts
 import { open as open2, readFile as readFile4, readdir as readdir3, stat as stat3 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
-import { basename as basename4, dirname as dirname4, join as join6, resolve as resolve4 } from "node:path";
-import { createBashToolDefinition, createEditToolDefinition, createFindToolDefinition, createGrepToolDefinition, createLsToolDefinition, createReadToolDefinition, createWriteToolDefinition, DefaultPackageManager, getAgentDir as getAgentDir2, SettingsManager, DEFAULT_MAX_BYTES } from "@earendil-works/pi-coding-agent";
+import { basename as basename3, dirname as dirname4, join as join6, resolve as resolve4 } from "node:path";
+import { createBashToolDefinition, createEditToolDefinition, createFindToolDefinition, createGrepToolDefinition, createLsToolDefinition, createReadToolDefinition, createWriteToolDefinition, DefaultPackageManager, getAgentDir as getAgentDir3, SettingsManager, DEFAULT_MAX_BYTES } from "@earendil-works/pi-coding-agent";
 
 // src/store.ts
 import { execFile as execFile2 } from "node:child_process";
@@ -1878,7 +1904,7 @@ var RunStore = class _RunStore {
 
 // src/host-view.ts
 import { keyHint, truncateToVisualLines } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth as truncateToWidth2 } from "@earendil-works/pi-tui";
+import { truncateToWidth as truncateToWidth2, visibleWidth as visibleWidth2 } from "@earendil-works/pi-tui";
 
 // src/background-widget.ts
 import { isKeyRelease, Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
@@ -1892,19 +1918,211 @@ var ANSI_SGR = new RegExp(ANSI_SGR_SOURCE);
 import { Type } from "@earendil-works/pi-ai";
 
 // src/validation.ts
-import { mkdirSync, readFileSync as readFileSync2, readdirSync, statSync } from "node:fs";
-import { homedir as homedir4 } from "node:os";
-import { basename as basename3, dirname as dirname3, extname, join as join5, resolve as resolve3 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
 import * as acorn from "acorn";
-import { getAgentDir, parseFrontmatter } from "@earendil-works/pi-coding-agent";
+
+// src/roles.ts
+import { getAgentDir as getAgentDir2, parseFrontmatter } from "@earendil-works/pi-coding-agent";
 
 // src/registry.ts
-import { readFileSync } from "node:fs";
-import { basename as basename2, dirname as dirname2, isAbsolute, join as join4 } from "node:path";
-import { fileURLToPath } from "node:url";
+import { readFileSync as readFileSync2 } from "node:fs";
+import { basename as basename2, dirname as dirname3, isAbsolute, join as join5 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { Value } from "typebox/value";
 
+// src/settings.ts
+import { mkdirSync, readFileSync } from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import { dirname as dirname2, join as join4, resolve as resolve3 } from "node:path";
+import { fileURLToPath } from "node:url";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+var ROLE_DIRECTORY = "pi-extensible-workflows";
+var DEFAULT_SETTINGS = Object.freeze({ concurrency: 8, backgroundWidget: true });
+function workflowSettingsPath(agentDir = getAgentDir()) {
+  return join4(agentDir, ROLE_DIRECTORY, "settings.json");
+}
+function normalizedResourcePath(value, settingsPath) {
+  if (value === "*" || value.startsWith("builtin:")) return value;
+  let expanded = value === "~" ? homedir4() : value.startsWith("~/") || value.startsWith("~\\") ? join4(homedir4(), value.slice(2)) : value;
+  if (expanded.startsWith("file://")) expanded = fileURLToPath(expanded);
+  const resolved = resolve3(dirname2(settingsPath), expanded);
+  if (expanded === "**" || expanded.startsWith("**/") || expanded.startsWith("**\\")) return expanded;
+  if (resourcePatternHasMagic(expanded)) {
+    const magicIndex = resolved.search(/[*?\x5b\x5d{}()]/);
+    const separatorIndex = Math.max(resolved.lastIndexOf("/", magicIndex), resolved.lastIndexOf("\\", magicIndex));
+    const rootBoundary = separatorIndex === 0 || separatorIndex === 2 && /^[A-Za-z]:[\\/]/.test(resolved);
+    const prefix = rootBoundary ? resolved.slice(0, separatorIndex + 1) : separatorIndex >= 0 ? resolved.slice(0, separatorIndex) : resolved;
+    const suffix = rootBoundary ? resolved.slice(separatorIndex + 1) : separatorIndex >= 0 ? resolved.slice(separatorIndex) : "";
+    return `${canonicalPath(prefix)}${suffix}`;
+  }
+  return canonicalPath(resolved);
+}
+function validateSelectorList(value, path, kind, errorCode2 = "INVALID_SETTINGS", normalizeExtensions = true) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value)) fail(errorCode2, `${path}.${kind} must be an array`);
+  const normalized = [];
+  for (const [index, entry] of value.entries()) {
+    if (typeof entry !== "string" || !entry.trim()) fail(errorCode2, `${path}.${kind}[${String(index)}] must be a non-empty string`);
+    let selector = entry.trim();
+    if (kind === "extensions" && normalizeExtensions) {
+      const negated = selector.startsWith("!");
+      const body = negated ? selector.slice(1) : selector;
+      if (!body) fail(errorCode2, `${path}.${kind}[${String(index)}] must be a valid minimatch pattern: Empty minimatch pattern ${JSON.stringify(selector)}`);
+      try {
+        selector = `${negated ? "!" : ""}${normalizedResourcePath(body, path)}`;
+      } catch (error) {
+        fail(errorCode2, `${path}.${kind}[${String(index)}] must be a valid path: ${errorText(error)}`);
+      }
+    }
+    try {
+      validateResourcePattern(selector);
+    } catch (error) {
+      fail(errorCode2, `${path}.${kind}[${String(index)}] must be a valid minimatch pattern: ${errorText(error)}`);
+    }
+    normalized.push(selector);
+  }
+  return Object.freeze(normalized);
+}
+function validateWorktreePostCreateCommand(value, settingsPath) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value) || value.length === 0) fail("INVALID_SETTINGS", `${settingsPath}.worktreePostCreateCommand must be a non-empty array`);
+  return Object.freeze(value.map((entry, index) => {
+    if (typeof entry !== "string" || !entry.trim()) fail("INVALID_SETTINGS", `${settingsPath}.worktreePostCreateCommand[${String(index)}] must be a non-empty string`);
+    return entry;
+  }));
+}
+function selectorsFromSettings(settings) {
+  return {
+    ...settings.skills === void 0 ? {} : { skills: settings.skills },
+    ...settings.extensions === void 0 ? {} : { extensions: settings.extensions },
+    ...settings.tools === void 0 ? {} : { tools: settings.tools }
+  };
+}
+function selectorSet(value) {
+  return { skills: [...value?.skills ?? []], extensions: [...value?.extensions ?? []], ...value?.tools === void 0 ? {} : { tools: [...value.tools] } };
+}
+function validateWorkflowExtensionSettings(value, settingsPath, errorCode2 = "INVALID_SETTINGS") {
+  if (value === void 0) return void 0;
+  const base = `${settingsPath}.extensionSettings`;
+  if (!object(value)) fail(errorCode2, `${base} must be an object`);
+  const normalized = {};
+  for (const [namespace, raw] of Object.entries(value)) {
+    if (!validWorkflowExtensionNamespace(namespace)) fail(errorCode2, `${base} contains an invalid namespace: ${namespace}`);
+    if (namespace === "herdr") {
+      if (!object(raw)) fail(errorCode2, `${base}.herdr must be an object`);
+      if (Object.keys(raw).some((key) => key !== "enableFullyInspectableMode")) fail(errorCode2, `${base}.herdr contains an unsupported setting`);
+      if (raw.enableFullyInspectableMode !== void 0 && typeof raw.enableFullyInspectableMode !== "boolean") fail(errorCode2, `${base}.herdr.enableFullyInspectableMode must be a boolean`);
+      normalized.herdr = Object.freeze({ ...raw.enableFullyInspectableMode === void 0 ? {} : { enableFullyInspectableMode: raw.enableFullyInspectableMode } });
+      continue;
+    }
+    if (namespace === "trajectory") {
+      if (!object(raw)) fail(errorCode2, `${base}.trajectory must be an object`);
+      if (Object.keys(raw).some((key) => key !== "port")) fail(errorCode2, `${base}.trajectory contains an unsupported setting`);
+      if (raw.port !== void 0 && (!positiveInteger(raw.port) || raw.port > 65535)) fail(errorCode2, `${base}.trajectory.port must be an integer from 1 to 65535`);
+      normalized.trajectory = Object.freeze({ ...raw.port === void 0 ? {} : { port: raw.port } });
+      continue;
+    }
+    if (!jsonValue(raw)) fail(errorCode2, `${base}.${namespace} must be JSON-compatible`);
+    normalized[namespace] = structuredClone(raw);
+  }
+  return deepFreeze(normalized);
+}
+function positiveRetentionInteger(value) {
+  return positiveInteger(value) && Number.isSafeInteger(value);
+}
+function validateRetention(value, settingsPath) {
+  if (value === void 0) return void 0;
+  const base = `${settingsPath}.retention`;
+  if (!object(value)) fail("INVALID_SETTINGS", `${base} must be an object`);
+  const unknown = Object.keys(value).find((key) => key !== "olderThanDays" && key !== "maxTerminalRuns");
+  if (unknown) fail("INVALID_SETTINGS", `Unknown retention setting at ${base}: ${unknown}`);
+  if (value.olderThanDays !== void 0 && !positiveRetentionInteger(value.olderThanDays)) fail("INVALID_SETTINGS", `${base}.olderThanDays must be a positive integer`);
+  if (value.maxTerminalRuns !== void 0 && !positiveRetentionInteger(value.maxTerminalRuns)) fail("INVALID_SETTINGS", `${base}.maxTerminalRuns must be a positive integer`);
+  return Object.freeze({ ...value.olderThanDays === void 0 ? {} : { olderThanDays: value.olderThanDays }, ...value.maxTerminalRuns === void 0 ? {} : { maxTerminalRuns: value.maxTerminalRuns } });
+}
+function parseSettings(path, partial) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(path, "utf8"));
+  } catch (error) {
+    if (isNodeError(error, "ENOENT")) return partial ? Object.freeze({}) : DEFAULT_SETTINGS;
+    fail("CONFIG_ERROR", `Invalid workflow settings JSON at ${path}: ${errorText(error)}`);
+  }
+  if (!object(parsed)) fail("INVALID_SETTINGS", `Workflow settings at ${path} must be an object`);
+  const allowed = /* @__PURE__ */ new Set(["concurrency", "modelAliases", "skills", "extensions", "extensionSettings", "tools", "retention", "worktreePostCreateCommand", ...partial ? [] : ["backgroundWidget", "codemodeTools"]]);
+  const unknown = Object.keys(parsed).find((key) => !allowed.has(key));
+  if (Object.prototype.hasOwnProperty.call(parsed, "disabledAgentResources")) fail("INVALID_SETTINGS", `disabledAgentResources is no longer supported; use skills, extensions, and tools selectors (settings: ${path})`);
+  if (unknown) fail("INVALID_SETTINGS", `Unknown workflow setting at ${path}: ${unknown}`);
+  const concurrency = parsed.concurrency === void 0 ? partial ? void 0 : DEFAULT_SETTINGS.concurrency : parsed.concurrency;
+  if (concurrency !== void 0 && (!positiveInteger(concurrency) || concurrency > 16)) fail("INVALID_SETTINGS", `${path}.concurrency must be an integer from 1 to 16`);
+  const backgroundWidget = parsed.backgroundWidget === void 0 ? partial ? void 0 : DEFAULT_SETTINGS.backgroundWidget : parsed.backgroundWidget;
+  if (backgroundWidget !== void 0 && typeof backgroundWidget !== "boolean") fail("INVALID_SETTINGS", `${path}.backgroundWidget must be a boolean`);
+  const codemodeTools = parsed.codemodeTools;
+  if (codemodeTools !== void 0 && codemodeTools !== "all" && codemodeTools !== "read-only" && codemodeTools !== "none") fail("INVALID_SETTINGS", `${path}.codemodeTools must be "all", "read-only", or "none"`);
+  const modelAliases = parsed.modelAliases === void 0 ? void 0 : validateModelAliases(parsed.modelAliases, path);
+  const skills = validateSelectorList(parsed.skills, path, "skills");
+  const tools = validateSelectorList(parsed.tools, path, "tools");
+  const extensions = validateSelectorList(parsed.extensions, path, "extensions");
+  const extensionSettings = parsed.extensionSettings === void 0 ? void 0 : validateWorkflowExtensionSettings(parsed.extensionSettings, path, "INVALID_SETTINGS");
+  const retention = validateRetention(parsed.retention, path);
+  const worktreePostCreateCommand = validateWorktreePostCreateCommand(parsed.worktreePostCreateCommand, path);
+  return Object.freeze({
+    ...concurrency === void 0 ? {} : { concurrency },
+    ...backgroundWidget === void 0 ? {} : { backgroundWidget },
+    ...codemodeTools === void 0 ? {} : { codemodeTools },
+    ...modelAliases === void 0 ? {} : { modelAliases },
+    ...skills === void 0 ? {} : { skills },
+    ...extensions === void 0 ? {} : { extensions },
+    ...extensionSettings === void 0 ? {} : { extensionSettings },
+    ...tools === void 0 ? {} : { tools },
+    ...retention === void 0 ? {} : { retention },
+    ...worktreePostCreateCommand === void 0 ? {} : { worktreePostCreateCommand }
+  });
+}
+function loadSettings(path = workflowSettingsPath()) {
+  return parseSettings(path, false);
+}
+function loadSettingsOverrides(path) {
+  return parseSettings(path, true);
+}
+function resolveWorkflowSettings(cwd, projectTrusted, globalSettingsPath = workflowSettingsPath()) {
+  const projectSettingsPath = workflowProjectSettingsPath(cwd);
+  const global = loadSettings(globalSettingsPath);
+  const project = projectTrusted ? loadSettingsOverrides(projectSettingsPath) : Object.freeze({});
+  const projectHas = (key) => Object.prototype.hasOwnProperty.call(project, key);
+  const sourceFor = (key) => projectHas(key) ? projectSettingsPath : globalSettingsPath;
+  const globalSelectors = selectorsFromSettings(global);
+  const projectSelectors = selectorsFromSettings(project);
+  const effectiveSelectors = selectorSet({
+    skills: [...globalSelectors.skills ?? [], ...projectSelectors.skills ?? []],
+    extensions: [...globalSelectors.extensions ?? [], ...projectSelectors.extensions ?? []],
+    ...globalSelectors.tools === void 0 && projectSelectors.tools === void 0 ? {} : { tools: [...globalSelectors.tools ?? [], ...projectSelectors.tools ?? []] }
+  });
+  const hasExtensionSelectors = global.extensions !== void 0 || project.extensions !== void 0;
+  const extensionSettings = projectHas("extensionSettings") ? project.extensionSettings : global.extensionSettings;
+  const sources = {
+    concurrency: projectHas("concurrency") ? projectSettingsPath : globalSettingsPath,
+    modelAliases: projectHas("modelAliases") ? projectSettingsPath : globalSettingsPath,
+    skills: sourceFor("skills"),
+    extensions: sourceFor("extensions"),
+    tools: sourceFor("tools"),
+    ...extensionSettings === void 0 ? {} : { extensionSettings: projectHas("extensionSettings") ? projectSettingsPath : globalSettingsPath },
+    ...project.retention === void 0 && global.retention === void 0 ? {} : { retention: project.retention === void 0 ? globalSettingsPath : projectSettingsPath },
+    ...projectHas("worktreePostCreateCommand") || global.worktreePostCreateCommand !== void 0 ? { worktreePostCreateCommand: projectHas("worktreePostCreateCommand") ? projectSettingsPath : globalSettingsPath } : {}
+  };
+  const effective = Object.freeze({
+    concurrency: project.concurrency ?? global.concurrency,
+    backgroundWidget: global.backgroundWidget ?? true,
+    ...projectHas("modelAliases") ? { modelAliases: project.modelAliases } : global.modelAliases === void 0 ? {} : { modelAliases: global.modelAliases },
+    ...effectiveSelectors.skills.length ? { skills: effectiveSelectors.skills } : global.skills !== void 0 || project.skills !== void 0 ? { skills: effectiveSelectors.skills } : {},
+    ...hasExtensionSelectors ? { extensions: effectiveSelectors.extensions } : {},
+    ...extensionSettings === void 0 ? {} : { extensionSettings },
+    ...effectiveSelectors.tools?.length ? { tools: effectiveSelectors.tools } : global.tools !== void 0 || project.tools !== void 0 ? { tools: effectiveSelectors.tools } : {},
+    ...(project.retention ?? global.retention) === void 0 ? {} : { retention: project.retention ?? global.retention },
+    ...projectHas("worktreePostCreateCommand") ? { worktreePostCreateCommand: project.worktreePostCreateCommand } : global.worktreePostCreateCommand === void 0 ? {} : { worktreePostCreateCommand: global.worktreePostCreateCommand }
+  });
+  return { globalSettingsPath, projectSettingsPath, projectTrusted, global, project, effective, sources };
+}
+
 // src/package-identity.ts
 var CORE_PACKAGE_NAME = "@marcoscale98/pi-extensible-workflows";
 var CORE_PACKAGE_COMPATIBILITY_NAME = "pi-extensible-workflows";
@@ -1914,7 +2132,7 @@ function isCorePackageName(value) {
 }
 
 // src/registry.ts
-var RESERVED_GLOBALS = /* @__PURE__ */ new Set(["agent", "shell", "prompt", "checkpoint", "parallel", "pipeline", "phase", "withWorktree", "log", "args", "Promise", "JSON", "Math", "Date", "eval", "Function", "WebAssembly", "process", "require", "module", "exports", "console", "fetch", "XMLHttpRequest", "WebSocket", "performance", "crypto", "setTimeout", "setInterval", "setImmediate", "queueMicrotask", "Intl", "SharedArrayBuffer", "Atomics", "globalThis", "global", "undefined", "NaN", "Infinity", "extensions", "workflow_catalog"]);
+var RESERVED_GLOBALS = /* @__PURE__ */ new Set(["agent", "shell", "tools", "prompt", "checkpoint", "parallel", "pipeline", "phase", "withWorktree", "log", "args", "Promise", "JSON", "Math", "Date", "eval", "Function", "WebAssembly", "process", "require", "module", "exports", "console", "fetch", "XMLHttpRequest", "WebSocket", "performance", "crypto", "setTimeout", "setInterval", "setImmediate", "queueMicrotask", "Intl", "SharedArrayBuffer", "Atomics", "globalThis", "global", "undefined", "NaN", "Infinity", "extensions", "workflow_catalog"]);
 var IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
 var SEMVER = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
 var PACKAGE_NAME = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
@@ -1922,10 +2140,10 @@ function normalizeRoleDirectory(value) {
   try {
     if (value instanceof URL) {
       if (value.protocol !== "file:") fail("INVALID_METADATA", "Workflow role directories require file URLs or absolute filesystem paths");
-      return fileURLToPath(value);
+      return fileURLToPath2(value);
     }
     if (typeof value === "string") {
-      if (value.startsWith("file:")) return fileURLToPath(value);
+      if (value.startsWith("file:")) return fileURLToPath2(value);
       if (isAbsolute(value)) return value;
     }
   } catch (error) {
@@ -1935,12 +2153,12 @@ function normalizeRoleDirectory(value) {
 }
 function isBuiltinRoleDirectory(path) {
   const canonical = canonicalPath(path);
-  const starterDirectory = dirname2(canonical);
+  const starterDirectory = dirname3(canonical);
   if (basename2(canonical) !== "roles" || basename2(starterDirectory) !== "starter") return false;
-  const distributionDirectory = dirname2(starterDirectory);
-  const packageRoot = basename2(distributionDirectory) === "dist" ? dirname2(distributionDirectory) : distributionDirectory;
+  const distributionDirectory = dirname3(starterDirectory);
+  const packageRoot = basename2(distributionDirectory) === "dist" ? dirname3(distributionDirectory) : distributionDirectory;
   try {
-    const metadata = JSON.parse(readFileSync(join4(packageRoot, "package.json"), "utf8"));
+    const metadata = JSON.parse(readFileSync2(join5(packageRoot, "package.json"), "utf8"));
     return object(metadata) && isCorePackageName(metadata.name);
   } catch {
     return false;
@@ -2214,199 +2432,6 @@ function beginWorkflowExtensionLoading() {
 }
 beginWorkflowExtensionLoading();
 
-// src/validation.ts
-var DEFAULT_SETTINGS = Object.freeze({ concurrency: 8, backgroundWidget: true });
-function workflowSettingsPath(agentDir = getAgentDir()) {
-  return join5(agentDir, ROLE_DIRECTORY, "settings.json");
-}
-function normalizedResourcePath(value, settingsPath) {
-  if (value === "*") return value;
-  let expanded = value === "~" ? homedir4() : value.startsWith("~/") || value.startsWith("~\\") ? join5(homedir4(), value.slice(2)) : value;
-  if (expanded.startsWith("file://")) expanded = fileURLToPath2(expanded);
-  const resolved = resolve3(dirname3(settingsPath), expanded);
-  if (expanded === "**" || expanded.startsWith("**/") || expanded.startsWith("**\\")) return expanded;
-  if (resourcePatternHasMagic(expanded)) {
-    const magicIndex = resolved.search(/[*?\x5b\x5d{}()]/);
-    const separatorIndex = Math.max(resolved.lastIndexOf("/", magicIndex), resolved.lastIndexOf("\\", magicIndex));
-    const rootBoundary = separatorIndex === 0 || separatorIndex === 2 && /^[A-Za-z]:[\\/]/.test(resolved);
-    const prefix = rootBoundary ? resolved.slice(0, separatorIndex + 1) : separatorIndex >= 0 ? resolved.slice(0, separatorIndex) : resolved;
-    const suffix = rootBoundary ? resolved.slice(separatorIndex + 1) : separatorIndex >= 0 ? resolved.slice(separatorIndex) : "";
-    return `${canonicalPath(prefix)}${suffix}`;
-  }
-  return canonicalPath(resolved);
-}
-function validateSelectorList(value, path, kind, errorCode2 = "INVALID_SETTINGS", normalizeExtensions = true) {
-  if (value === void 0) return void 0;
-  if (!Array.isArray(value)) fail(errorCode2, `${path}.${kind} must be an array`);
-  const normalized = [];
-  for (const [index, entry] of value.entries()) {
-    if (typeof entry !== "string" || !entry.trim()) fail(errorCode2, `${path}.${kind}[${String(index)}] must be a non-empty string`);
-    let selector = entry.trim();
-    if (kind === "extensions" && normalizeExtensions) {
-      const negated = selector.startsWith("!");
-      const body = negated ? selector.slice(1) : selector;
-      if (!body) fail(errorCode2, `${path}.${kind}[${String(index)}] must be a valid minimatch pattern: Empty minimatch pattern ${JSON.stringify(selector)}`);
-      try {
-        selector = `${negated ? "!" : ""}${normalizedResourcePath(body, path)}`;
-      } catch (error) {
-        fail(errorCode2, `${path}.${kind}[${String(index)}] must be a valid path: ${errorText(error)}`);
-      }
-    }
-    try {
-      validateResourcePattern(selector);
-    } catch (error) {
-      fail(errorCode2, `${path}.${kind}[${String(index)}] must be a valid minimatch pattern: ${errorText(error)}`);
-    }
-    normalized.push(selector);
-  }
-  return Object.freeze(normalized);
-}
-function validateWorktreePostCreateCommand(value, settingsPath) {
-  if (value === void 0) return void 0;
-  if (!Array.isArray(value) || value.length === 0) fail("INVALID_SETTINGS", `${settingsPath}.worktreePostCreateCommand must be a non-empty array`);
-  return Object.freeze(value.map((entry, index) => {
-    if (typeof entry !== "string" || !entry.trim()) fail("INVALID_SETTINGS", `${settingsPath}.worktreePostCreateCommand[${String(index)}] must be a non-empty string`);
-    return entry;
-  }));
-}
-function selectorsFromSettings(settings) {
-  return {
-    ...settings.skills === void 0 ? {} : { skills: settings.skills },
-    ...settings.extensions === void 0 ? {} : { extensions: settings.extensions },
-    ...settings.tools === void 0 ? {} : { tools: settings.tools }
-  };
-}
-function selectorSet(value) {
-  return { skills: [...value?.skills ?? []], extensions: [...value?.extensions ?? []], ...value?.tools === void 0 ? {} : { tools: [...value.tools] } };
-}
-function validateWorkflowExtensionSettings(value, settingsPath, errorCode2 = "INVALID_SETTINGS", applyDefaults = true) {
-  if (value === void 0) return void 0;
-  const base = `${settingsPath}.extensionSettings`;
-  if (!object(value)) fail(errorCode2, `${base} must be an object`);
-  const normalized = {};
-  for (const [namespace, raw] of Object.entries(value)) {
-    if (!validWorkflowExtensionNamespace(namespace)) fail(errorCode2, `${base} contains an invalid namespace: ${namespace}`);
-    if (namespace === "herdr") {
-      if (!object(raw)) fail(errorCode2, `${base}.herdr must be an object`);
-      if (Object.keys(raw).some((key) => key !== "enableFullyInspectableMode")) fail(errorCode2, `${base}.herdr contains an unsupported setting`);
-      if (raw.enableFullyInspectableMode !== void 0 && typeof raw.enableFullyInspectableMode !== "boolean") fail(errorCode2, `${base}.herdr.enableFullyInspectableMode must be a boolean`);
-      normalized.herdr = Object.freeze({ ...raw.enableFullyInspectableMode === void 0 ? {} : { enableFullyInspectableMode: raw.enableFullyInspectableMode } });
-      continue;
-    }
-    if (namespace === "trajectory") {
-      if (!object(raw)) fail(errorCode2, `${base}.trajectory must be an object`);
-      if (Object.keys(raw).some((key) => key !== "port" && key !== "themes")) fail(errorCode2, `${base}.trajectory contains an unsupported setting`);
-      if (raw.port !== void 0 && (!positiveInteger(raw.port) || raw.port > 65535)) fail(errorCode2, `${base}.trajectory.port must be an integer from 1 to 65535`);
-      if (raw.themes !== void 0 && typeof raw.themes !== "boolean") fail(errorCode2, `${base}.trajectory.themes must be a boolean`);
-      normalized.trajectory = Object.freeze({ ...raw.port === void 0 ? {} : { port: raw.port }, ...raw.themes === void 0 ? applyDefaults ? { themes: false } : {} : { themes: raw.themes } });
-      continue;
-    }
-    if (!jsonValue(raw)) fail(errorCode2, `${base}.${namespace} must be JSON-compatible`);
-    normalized[namespace] = structuredClone(raw);
-  }
-  return deepFreeze(normalized);
-}
-function positiveRetentionInteger(value) {
-  return positiveInteger(value) && Number.isSafeInteger(value);
-}
-function validateRetention(value, settingsPath) {
-  if (value === void 0) return void 0;
-  const base = `${settingsPath}.retention`;
-  if (!object(value)) fail("INVALID_SETTINGS", `${base} must be an object`);
-  const unknown = Object.keys(value).find((key) => key !== "olderThanDays" && key !== "maxTerminalRuns");
-  if (unknown) fail("INVALID_SETTINGS", `Unknown retention setting at ${base}: ${unknown}`);
-  if (value.olderThanDays !== void 0 && !positiveRetentionInteger(value.olderThanDays)) fail("INVALID_SETTINGS", `${base}.olderThanDays must be a positive integer`);
-  if (value.maxTerminalRuns !== void 0 && !positiveRetentionInteger(value.maxTerminalRuns)) fail("INVALID_SETTINGS", `${base}.maxTerminalRuns must be a positive integer`);
-  return Object.freeze({ ...value.olderThanDays === void 0 ? {} : { olderThanDays: value.olderThanDays }, ...value.maxTerminalRuns === void 0 ? {} : { maxTerminalRuns: value.maxTerminalRuns } });
-}
-function parseSettings(path, partial) {
-  let parsed;
-  try {
-    parsed = JSON.parse(readFileSync2(path, "utf8"));
-  } catch (error) {
-    if (isNodeError(error, "ENOENT")) return partial ? Object.freeze({}) : DEFAULT_SETTINGS;
-    fail("CONFIG_ERROR", `Invalid workflow settings JSON at ${path}: ${errorText(error)}`);
-  }
-  if (!object(parsed)) fail("INVALID_SETTINGS", `Workflow settings at ${path} must be an object`);
-  const allowed = /* @__PURE__ */ new Set(["concurrency", "modelAliases", "skills", "extensions", "extensionSettings", "tools", "retention", "worktreePostCreateCommand", ...partial ? [] : ["backgroundWidget"]]);
-  const unknown = Object.keys(parsed).find((key) => !allowed.has(key));
-  if (Object.prototype.hasOwnProperty.call(parsed, "disabledAgentResources")) fail("INVALID_SETTINGS", `disabledAgentResources is no longer supported; use skills, extensions, and tools selectors (settings: ${path})`);
-  if (unknown) fail("INVALID_SETTINGS", `Unknown workflow setting at ${path}: ${unknown}`);
-  const concurrency = parsed.concurrency === void 0 ? partial ? void 0 : DEFAULT_SETTINGS.concurrency : parsed.concurrency;
-  if (concurrency !== void 0 && (!positiveInteger(concurrency) || concurrency > 16)) fail("INVALID_SETTINGS", `${path}.concurrency must be an integer from 1 to 16`);
-  const backgroundWidget = parsed.backgroundWidget === void 0 ? partial ? void 0 : DEFAULT_SETTINGS.backgroundWidget : parsed.backgroundWidget;
-  if (backgroundWidget !== void 0 && typeof backgroundWidget !== "boolean") fail("INVALID_SETTINGS", `${path}.backgroundWidget must be a boolean`);
-  const modelAliases = parsed.modelAliases === void 0 ? void 0 : validateModelAliases(parsed.modelAliases, path);
-  const skills = validateSelectorList(parsed.skills, path, "skills");
-  const tools = validateSelectorList(parsed.tools, path, "tools");
-  const extensions = validateSelectorList(parsed.extensions, path, "extensions");
-  const extensionSettings = parsed.extensionSettings === void 0 ? void 0 : validateWorkflowExtensionSettings(parsed.extensionSettings, path, "INVALID_SETTINGS", !partial);
-  const retention = validateRetention(parsed.retention, path);
-  const worktreePostCreateCommand = validateWorktreePostCreateCommand(parsed.worktreePostCreateCommand, path);
-  return Object.freeze({
-    ...concurrency === void 0 ? {} : { concurrency },
-    ...backgroundWidget === void 0 ? {} : { backgroundWidget },
-    ...modelAliases === void 0 ? {} : { modelAliases },
-    ...skills === void 0 ? {} : { skills },
-    ...extensions === void 0 ? {} : { extensions },
-    ...extensionSettings === void 0 ? {} : { extensionSettings },
-    ...tools === void 0 ? {} : { tools },
-    ...retention === void 0 ? {} : { retention },
-    ...worktreePostCreateCommand === void 0 ? {} : { worktreePostCreateCommand }
-  });
-}
-function loadSettings(path = workflowSettingsPath()) {
-  return parseSettings(path, false);
-}
-function loadSettingsOverrides(path) {
-  return parseSettings(path, true);
-}
-function resolveWorkflowSettings(cwd, projectTrusted, globalSettingsPath = workflowSettingsPath()) {
-  const projectSettingsPath = workflowProjectSettingsPath(cwd);
-  const global = loadSettings(globalSettingsPath);
-  const project = projectTrusted ? loadSettingsOverrides(projectSettingsPath) : Object.freeze({});
-  const projectHas = (key) => Object.prototype.hasOwnProperty.call(project, key);
-  const sourceFor = (key) => projectHas(key) ? projectSettingsPath : globalSettingsPath;
-  const globalSelectors = selectorsFromSettings(global);
-  const projectSelectors = selectorsFromSettings(project);
-  const effectiveSelectors = selectorSet({
-    skills: [...globalSelectors.skills ?? [], ...projectSelectors.skills ?? []],
-    extensions: [...globalSelectors.extensions ?? [], ...projectSelectors.extensions ?? []],
-    ...globalSelectors.tools === void 0 && projectSelectors.tools === void 0 ? {} : { tools: [...globalSelectors.tools ?? [], ...projectSelectors.tools ?? []] }
-  });
-  const hasExtensionSelectors = global.extensions !== void 0 || project.extensions !== void 0;
-  const extensionSettings = projectHas("extensionSettings") ? project.extensionSettings : global.extensionSettings;
-  const sources = {
-    concurrency: projectHas("concurrency") ? projectSettingsPath : globalSettingsPath,
-    modelAliases: projectHas("modelAliases") ? projectSettingsPath : globalSettingsPath,
-    skills: sourceFor("skills"),
-    extensions: sourceFor("extensions"),
-    tools: sourceFor("tools"),
-    ...extensionSettings === void 0 ? {} : { extensionSettings: projectHas("extensionSettings") ? projectSettingsPath : globalSettingsPath },
-    ...project.retention === void 0 && global.retention === void 0 ? {} : { retention: project.retention === void 0 ? globalSettingsPath : projectSettingsPath },
-    ...projectHas("worktreePostCreateCommand") || global.worktreePostCreateCommand !== void 0 ? { worktreePostCreateCommand: projectHas("worktreePostCreateCommand") ? projectSettingsPath : globalSettingsPath } : {}
-  };
-  const effective = Object.freeze({
-    concurrency: project.concurrency ?? global.concurrency,
-    backgroundWidget: global.backgroundWidget ?? true,
-    ...projectHas("modelAliases") ? { modelAliases: project.modelAliases } : global.modelAliases === void 0 ? {} : { modelAliases: global.modelAliases },
-    ...effectiveSelectors.skills.length ? { skills: effectiveSelectors.skills } : global.skills !== void 0 || project.skills !== void 0 ? { skills: effectiveSelectors.skills } : {},
-    ...hasExtensionSelectors ? { extensions: effectiveSelectors.extensions } : {},
-    ...extensionSettings === void 0 ? {} : { extensionSettings },
-    ...effectiveSelectors.tools?.length ? { tools: effectiveSelectors.tools } : global.tools !== void 0 || project.tools !== void 0 ? { tools: effectiveSelectors.tools } : {},
-    ...(project.retention ?? global.retention) === void 0 ? {} : { retention: project.retention ?? global.retention },
-    ...projectHas("worktreePostCreateCommand") ? { worktreePostCreateCommand: project.worktreePostCreateCommand } : global.worktreePostCreateCommand === void 0 ? {} : { worktreePostCreateCommand: global.worktreePostCreateCommand }
-  });
-  return { globalSettingsPath, projectSettingsPath, projectTrusted, global, project, effective, sources };
-}
-var ROLE_DIRECTORY = "pi-extensible-workflows";
-function validateSchema(schema, at = "schema") {
-  if (!object(schema) || Object.getPrototypeOf(schema) !== Object.prototype || !jsonValue(schema)) fail("INVALID_SCHEMA", `${at} must be a plain JSON-compatible Schema object`);
-  if (typeof schema.type !== "string" && !Array.isArray(schema.type) && schema.$ref === void 0 && schema.anyOf === void 0 && schema.oneOf === void 0 && schema.allOf === void 0 && schema.const === void 0 && schema.enum === void 0) fail("INVALID_SCHEMA", `${at} has no JSON Schema shape`);
-  if (schema.required !== void 0 && (!Array.isArray(schema.required) || schema.required.some((key) => typeof key !== "string"))) fail("INVALID_SCHEMA", `${at}.required must be an array of strings`);
-  if (schema.properties !== void 0 && !object(schema.properties)) fail("INVALID_SCHEMA", `${at}.properties must be an object`);
-}
-
 // subagents/src/contracts.ts
 import { Value as Value2 } from "typebox/value";
 var SUBAGENT_MAX_RETRIES = 255;
@@ -2431,7 +2456,8 @@ var SUBAGENTS_RUN_PARAMETERS = Type.Object({
   timeoutMs: Type.Optional(Type.Union([Type.Integer({ minimum: 1, description: "Optional execution timeout in milliseconds" }), Type.Null()]))
 }, { additionalProperties: false });
 var SUBAGENTS_INSPECT_PARAMETERS = Type.Object({
-  id: Type.Optional(Type.String({ description: "Subagent ID; omit to list ordered run summaries" }))
+  id: Type.Optional(Type.String({ description: "Subagent ID; omit to list ordered run summaries" })),
+  scope: Type.Optional(Type.Union([Type.Literal("session"), Type.Literal("all")], { description: "List scope when id is omitted: session (default) lists runs from the current Pi session; all lists every stored run" }))
 }, { additionalProperties: false });
 var SUBAGENTS_ID_PARAMETERS = Type.Object({
   id: Type.String({ description: "Subagent ID" })
@@ -2446,6 +2472,24 @@ var SUBAGENTS_STOP_PARAMETERS = Type.Object({
 var SUBAGENTS_RETRY_PARAMETERS = Type.Object({
   id: Type.String({ description: "Failed or stopped subagent ID to retry" })
 }, { additionalProperties: false });
+var SUBAGENT_STATUS_OUTPUT = Type.Object({
+  id: Type.String(),
+  state: Type.String(),
+  sessionId: Type.Optional(Type.String()),
+  startedAt: Type.Optional(Type.Number()),
+  finishedAt: Type.Optional(Type.Number()),
+  attempts: Type.Optional(Type.Number()),
+  attemptDetails: Type.Optional(Type.Array(Type.Unknown())),
+  worktree: Type.Optional(Type.Object({ path: Type.String(), branch: Type.String() })),
+  error: Type.Optional(Type.Object({ code: Type.String(), message: Type.String() })),
+  progress: Type.Optional(Type.Unknown()),
+  value: Type.Optional(Type.Unknown())
+});
+var SUBAGENTS_INSPECT_OUTPUT = Type.Union([SUBAGENT_STATUS_OUTPUT, Type.Array(Type.Object({ id: Type.String(), state: Type.String() }))]);
+var SUBAGENTS_STEER_OUTPUT = Type.Object({ id: Type.String(), accepted: Type.Boolean() });
+
+// src/tool-timing.ts
+var TOOL_TIMING_ENTRY_TYPE = "pi-workflows:tool-timing";
 
 // src/trajectory-contracts.ts
 var TRAJECTORY_ACTIONS = ["checkpoint-approve", "checkpoint-reject", "pause", "resume", "steer", "stop", "retry", "share"];
@@ -2478,7 +2522,7 @@ function transcriptToolCallId(value) {
   return void 0;
 }
 function isTimingTranscriptEntry(value) {
-  return object(value) && value.type === "custom" && value.customType === "pi-workflows:tool-timing";
+  return object(value) && value.type === "custom" && value.customType === TOOL_TIMING_ENTRY_TYPE;
 }
 function timingToolCallId(value) {
   if (!object(value) || !isTimingTranscriptEntry(value) || !object(value.data)) return void 0;
@@ -2599,21 +2643,21 @@ function withPiToolDescriptions(run) {
 function canonicalExtensionSelector(selector, base) {
   const negated = selector.startsWith("!");
   const body = negated ? selector.slice(1) : selector;
-  if (body === "*" || body === "**" || body.startsWith("**/")) return selector;
+  if (body === "*" || body === "**" || body.startsWith("**/") || body.startsWith("builtin:")) return selector;
   const resolved = resolve4(base, body);
   if (resourcePatternHasMagic(body)) return `${negated ? "!" : ""}${resolved}`;
   return `${negated ? "!" : ""}${canonicalPath(resolved)}`;
 }
 function skillNameFromPath(path) {
-  const file = basename4(path);
-  return file.toLowerCase() === "skill.md" ? basename4(dirname4(path)) : file;
+  const file = basename3(path);
+  return file.toLowerCase() === "skill.md" ? basename3(dirname4(path)) : file;
 }
 var discoveredResourcesByCwd = /* @__PURE__ */ new Map();
 async function discoveredResources(cwd) {
   const cached = discoveredResourcesByCwd.get(cwd);
   if (cached) return cached;
   const pending = (async () => {
-    const agentDir = getAgentDir2();
+    const agentDir = getAgentDir3();
     const settingsManager = SettingsManager.create(cwd, agentDir, { projectTrusted: false });
     const packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });
     const resolved = await packageManager.resolve();
@@ -2660,11 +2704,62 @@ function withoutAgentActivities(run) {
   });
   return agents.every((agent, index) => agent === run.agents[index]) ? run : { ...run, agents };
 }
+function serializedJsonBytes(value) {
+  const serialized = JSON.stringify(value);
+  return Buffer.byteLength(serialized, "utf8");
+}
+function failedAgentOutput(agent) {
+  const error = [...agent.attemptDetails ?? []].reverse().find((attempt) => attempt.error)?.error;
+  const status = agent.state === "cancelled" ? "cancelled" : "failed";
+  return { status, code: error?.code ?? (status === "cancelled" ? "CANCELLED" : "AGENT_FAILED"), message: error?.message ?? `Agent ${agent.state}` };
+}
+function operationOutput(operation) {
+  const bytes = serializedJsonBytes(operation.value);
+  return bytes > DEFAULT_MAX_BYTES ? { status: "truncated", kind: "result", bytes } : { status: "available", value: operation.value, bytes };
+}
+function outputForCall(call, operation) {
+  if (operation !== void 0) return call.kind === "tool" ? { status: "completed" } : operationOutput(operation);
+  if (call.error) return { status: call.error.code === "CANCELLED" ? "cancelled" : "failed", code: call.error.code, ...call.kind === "shell" ? { message: call.error.message ?? "Shell failed" } : {} };
+  return call.finishedAt === void 0 ? { status: "pending" } : { status: "unavailable" };
+}
+function outputForAgent(agent, operation) {
+  if (operation !== void 0) return operationOutput(operation);
+  if (agent.state === "failed" || agent.state === "cancelled") return failedAgentOutput(agent);
+  if (agent.state === "completed") return { status: "unavailable" };
+  return { status: "pending" };
+}
+function applyTrajectoryAgentOutputs(run, operations) {
+  const byPath = new Map(operations.map((operation) => [operation.path, operation]));
+  const agents = run.agents.map((agent) => ({ ...agent, output: outputForAgent(agent, agent.resultPath === void 0 ? void 0 : byPath.get(agent.resultPath)) }));
+  const scriptCalls = run.scriptCalls?.map((call) => {
+    const recorded = { ...call, output: outputForCall(call, byPath.get(call.path)) };
+    if (call.kind === "tool") {
+      delete recorded.input;
+      delete recorded.inputBytes;
+      if (call.error) recorded.error = { code: call.error.code };
+    }
+    return recorded;
+  });
+  const rest = run;
+  return { ...rest, agents, ...scriptCalls === void 0 ? {} : { scriptCalls } };
+}
+function overlayTrajectoryRun(run, overlay) {
+  const overlaid = overlay(run);
+  const outputs = new Map(run.agents.map((agent) => [agent.id, agent.output]));
+  const agents = overlaid.agents.map((agent) => {
+    const previous = outputs.get(agent.id);
+    const output = previous?.status === "available" || previous?.status === "truncated" ? previous : outputForAgent(agent, void 0);
+    return { ...agent, output };
+  });
+  return { ...overlaid, agents, ...run.scriptCalls === void 0 ? {} : { scriptCalls: run.scriptCalls } };
+}
 async function loadTrajectoryRun(store, includeTranscripts = true) {
   const value = await store.load();
   const summary = await store.loadSummary().catch(() => void 0);
   const prompts = await store.systemPrompts().catch(() => []);
-  const run = withoutAgentActivities(await withResolvedResources(withPiToolDescriptions(applySystemPrompts(value.run, prompts)), store.cwd));
+  const prepared = withoutAgentActivities(await withResolvedResources(withPiToolDescriptions(applySystemPrompts(value.run, prompts)), store.cwd));
+  const operations = await store.replayableOperations().catch(() => []);
+  const run = applyTrajectoryAgentOutputs(prepared, operations);
   return { run, snapshot: value.snapshot, awaiting: await store.awaitingCheckpoints(), ...summary?.createdAt === void 0 ? {} : { createdAt: summary.createdAt }, transcripts: includeTranscripts ? await runTranscripts(run) : {} };
 }
 async function loadTrajectoryRuns(cwd, sessionId, home = homedir5(), overlay) {
@@ -2672,7 +2767,7 @@ async function loadTrajectoryRuns(cwd, sessionId, home = homedir5(), overlay) {
   for (const runId of await listRunIds(cwd, sessionId, home, false)) {
     try {
       const value = await loadTrajectoryRun(new RunStore(cwd, sessionId, runId, home));
-      loaded.push(overlay ? { ...value, run: overlay(value.run) } : value);
+      loaded.push(overlay ? { ...value, run: overlayTrajectoryRun(value.run, overlay) } : value);
     } catch {
     }
   }
@@ -2695,15 +2790,16 @@ async function exportTrajectoryRunHtml(options) {
   const run = runs.find((candidate) => candidate.run.id === options.runId);
   if (!run) throw new Error(`Workflow run ${options.runId} was not found for session ${options.sessionId}`);
   const assets = new URL("./assets/", import.meta.url);
-  const [html, marked, morphdom, favicon] = await Promise.all([
+  const [html, marked, morphdom, prism, favicon] = await Promise.all([
     readFile5(new URL("index.html", assets), "utf8"),
     readFile5(new URL("marked.min.js", assets)),
     readFile5(new URL("morphdom.min.js", assets)),
+    readFile5(new URL("prism.min.js", assets)),
     readFile5(new URL("favicon.png", assets))
   ]);
   const state = {
     type: "state",
-    publishers: [{ id: `export-${options.runId}`, title: `run ${options.runId.slice(0, 8)}`, cwd: options.cwd, sessionId: options.sessionId, themes: true, connected: true, runs: [run], subagents: [] }],
+    publishers: [{ id: `export-${options.runId}`, title: `run ${options.runId.slice(0, 8)}`, cwd: options.cwd, sessionId: options.sessionId, connected: true, runs: [run], subagents: [] }],
     updatedAt: Date.now()
   };
   const script = (source) => `<script src="data:text/javascript;base64,${source.toString("base64")}"></script>`;
@@ -2711,6 +2807,7 @@ async function exportTrajectoryRunHtml(options) {
   output = inlineAsset(output, '<link rel="icon" type="image/png" href="./favicon.png" />', `<link rel="icon" type="image/png" href="data:image/png;base64,${favicon.toString("base64")}" />`);
   output = inlineAsset(output, '<script src="./marked.min.js"></script>', script(marked));
   output = inlineAsset(output, '<script src="./morphdom.min.js"></script>', script(morphdom));
+  output = inlineAsset(output, '<script src="./prism.min.js"></script>', script(prism));
   output = inlineAsset(output, '<body data-view="run">', `<body data-view="run">
   <script>window.__PIEWF_STATIC__ = ${JSON.stringify(state).replace(/</g, "\\u003c")};</script>`);
   return output;
@@ -2771,14 +2868,20 @@ function trajectoryPort(value) {
 function delay(ms) {
   return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
-async function serverHealthy(port) {
+async function serverHealth(port) {
   try {
     const response = await fetch(`http://127.0.0.1:${String(port)}/health`, { signal: AbortSignal.timeout(300) });
-    return response.ok;
+    if (!response.ok) return void 0;
+    const body = await response.json().catch(() => void 0);
+    if (!object(body)) return {};
+    return { ...positiveInteger(body.pid) ? { pid: body.pid } : {}, ...typeof body.fingerprint === "string" ? { fingerprint: body.fingerprint } : {}, ...positiveInteger(body.startedAt) ? { startedAt: body.startedAt } : {} };
   } catch {
-    return false;
+    return void 0;
   }
 }
+async function serverHealthy(port) {
+  return await serverHealth(port) !== void 0;
+}
 function signalProcess(pid, signal) {
   try {
     process.kill(pid, signal);
@@ -2811,23 +2914,27 @@ async function readLock(path) {
     return void 0;
   }
 }
-async function waitForServer(port) {
+async function waitForServer(port, fingerprint) {
+  let foreign = false;
   for (let attempt = 0; attempt < 60; attempt += 1) {
-    if (await serverHealthy(port)) return;
+    const health = await serverHealth(port);
+    if (health?.fingerprint === fingerprint) return;
+    foreign = health !== void 0;
     await delay(50);
   }
-  throw new Error(`Trajectory server did not start on port ${String(port)}`);
+  throw new Error(foreign ? `Trajectory port ${String(port)} is held by another Trajectory server; stop it and retry` : `Trajectory server did not start on port ${String(port)}`);
 }
 async function resolveExistingServer(lockPath, existing, fingerprint) {
-  if (await serverHealthy(existing.port)) {
-    if (existing.fingerprint === fingerprint) return existing;
+  const health = await serverHealth(existing.port);
+  if (health) {
+    if (existing.fingerprint === fingerprint && health.fingerprint === fingerprint) return existing;
     await stopStaleServer(existing);
     await rm5(lockPath, { force: true });
     return void 0;
   }
   if (await processAlive(existing.pid, existing.startedAt)) {
     try {
-      await waitForServer(existing.port);
+      await waitForServer(existing.port, fingerprint);
       return existing;
     } catch {
       await stopStaleServer(existing);
@@ -2870,13 +2977,15 @@ async function ensureTrajectoryServer(agentDir, configuredPort) {
   } finally {
     await lockHandle?.close();
   }
+  const occupant = await serverHealth(configuredPort);
+  if (occupant?.pid !== void 0 && occupant.fingerprint !== fingerprint) await stopStaleServer({ pid: occupant.pid, port: configuredPort, ...occupant.startedAt === void 0 ? {} : { startedAt: occupant.startedAt } });
   try {
     const child = spawn(process.versions.bun ? "node" : process.execPath, [serverPath, "--port", String(configuredPort), "--lock", lockPath, "--fingerprint", fingerprint], { detached: true, stdio: "ignore" });
     const startupError = new Promise((_resolve, reject) => {
       child.once("error", reject);
     });
     child.unref();
-    await Promise.race([waitForServer(configuredPort), startupError]);
+    await Promise.race([waitForServer(configuredPort, fingerprint), startupError]);
     return { port: configuredPort };
   } catch (error) {
     await rm5(lockPath, { force: true });
@@ -2907,11 +3016,10 @@ var MAX_FRAME_BYTES = 32 * 1024 * 1024;
 var MAX_LIVE_STATE_BYTES = MAX_FRAME_BYTES - 1024;
 var MAX_TRANSCRIPT_REQUESTS = 64;
 var TRANSCRIPT_REQUEST_TIMEOUT_MS = 1e4;
+var ACTIVE_POLL_MS = 1e3;
+var IDLE_POLL_MS = 1e4;
 var RECONNECT_INITIAL_DELAY_MS = 100;
 var RECONNECT_MAX_DELAY_MS = 5e3;
-function isTimingEntry(value) {
-  return object(value) && value.type === "custom" && value.customType === "pi-workflows:tool-timing";
-}
 function boundedString(value, maxLength = 1024) {
   if (typeof value !== "string") return value;
   const bytes = Buffer.from(value);
@@ -2921,46 +3029,91 @@ var MAX_LIVE_STRING_BYTES = 64 * 1024;
 var MAX_LIVE_ARRAY_ENTRIES = 256;
 var MAX_LIVE_OBJECT_KEYS = 64;
 var LIVE_METADATA_ARRAY_KEYS = /* @__PURE__ */ new Set(["agents", "runs", "subagents"]);
-var LIVE_TRUNCATABLE_ARRAY_KEYS = /* @__PURE__ */ new Set(["events", "phaseHistory"]);
+var LIVE_TRUNCATABLE_ARRAY_KEYS = /* @__PURE__ */ new Set(["events", "phaseHistory", "scriptCalls"]);
 var LIVE_METADATA_OBJECT_KEYS = /* @__PURE__ */ new Set(["transcripts"]);
+function liveValueWillBeBounded(value, key = "", depth = 0) {
+  if (typeof value === "string") return Buffer.byteLength(value) > MAX_LIVE_STRING_BYTES;
+  if (typeof value !== "object" || value === null) return false;
+  if (depth >= 12) return true;
+  if (Array.isArray(value)) {
+    const maxEntries = LIVE_TRUNCATABLE_ARRAY_KEYS.has(key) ? MAX_LIVE_ARRAY_ENTRIES - 1 : MAX_LIVE_ARRAY_ENTRIES;
+    if (key === "attemptDetails" && value.length > 8 || !LIVE_METADATA_ARRAY_KEYS.has(key) && value.length > maxEntries) return true;
+    return value.some((entry) => liveValueWillBeBounded(entry, "", depth + 1));
+  }
+  if (!object(value)) return false;
+  const properties = LIVE_METADATA_OBJECT_KEYS.has(key) ? Object.keys(value) : Object.keys(value).sort().slice(0, MAX_LIVE_OBJECT_KEYS);
+  if (!LIVE_METADATA_OBJECT_KEYS.has(key) && Object.keys(value).length > MAX_LIVE_OBJECT_KEYS) return true;
+  return properties.some((property) => liveValueWillBeBounded(value[property], property, depth + 1));
+}
+var MAX_LIVE_TIMING_BYTES = 64 * 1024;
 function boundedTiming(value) {
-  const entries = Array.isArray(value) ? value.filter(isTimingEntry) : [];
+  const entries = Array.isArray(value) ? value.filter(isTimingTranscriptEntry) : [];
   const retained = [];
   let bytes = 2;
-  for (const entry of entries) {
+  for (let index = entries.length - 1; index >= 0; index -= 1) {
     let serialized;
     try {
-      serialized = JSON.stringify(entry);
+      serialized = JSON.stringify(entries[index]);
     } catch {
       continue;
     }
     const nextBytes = bytes + (retained.length ? 1 : 0) + Buffer.byteLength(serialized);
-    if (nextBytes >= 64 * 1024) break;
-    retained.push(entry);
+    if (nextBytes >= MAX_LIVE_TIMING_BYTES) break;
+    retained.push(entries[index]);
     bytes = nextBytes;
   }
-  return retained;
+  return retained.reverse();
 }
-function boundedLiveValue(value, key = "", depth = 0) {
-  if (typeof value === "string") return boundedString(value, MAX_LIVE_STRING_BYTES);
-  if (typeof value === "number" || typeof value === "boolean" || value === null) return value;
-  if (depth >= 12) return void 0;
-  if (key === "timing") return boundedTiming(value);
-  if (Array.isArray(value)) {
-    const array = value;
-    const maxEntries = LIVE_TRUNCATABLE_ARRAY_KEYS.has(key) ? MAX_LIVE_ARRAY_ENTRIES - 1 : MAX_LIVE_ARRAY_ENTRIES;
-    const entries = key === "attemptDetails" ? array.slice(-8) : LIVE_METADATA_ARRAY_KEYS.has(key) ? array : array.length <= maxEntries ? array : [...array.slice(0, 32), ...array.slice(-maxEntries + 32)];
-    const bounded = entries.map((entry) => boundedLiveValue(entry, "", depth + 1));
-    if (entries.length !== array.length && LIVE_TRUNCATABLE_ARRAY_KEYS.has(key)) bounded.push({ type: "trajectory:truncated", field: key, omitted: array.length - entries.length });
-    return bounded;
-  }
-  if (object(value)) {
-    const result = {};
-    const properties = LIVE_METADATA_OBJECT_KEYS.has(key) ? Object.keys(value).sort() : Object.keys(value).sort().slice(0, MAX_LIVE_OBJECT_KEYS);
-    for (const property of properties) result[property] = boundedLiveValue(value[property], property, depth + 1);
-    return result;
+function boundedLiveValue(value, key = "", depth = 0, bounds) {
+  const pathLength = bounds?.path.length ?? 0;
+  if (bounds && key) bounds.path.push(key);
+  const argsValue = bounds !== void 0 && bounds.path.length >= 3 && bounds.path[0] === "runs" && bounds.path[1] === "snapshot" && bounds.path[2] === "args";
+  const markArgsTruncated = () => {
+    if (argsValue && bounds.runIndex !== void 0) bounds.argsTruncatedRuns.add(bounds.runIndex);
+  };
+  try {
+    if (typeof value === "string") {
+      if (argsValue && Buffer.byteLength(value) > MAX_LIVE_STRING_BYTES) markArgsTruncated();
+      return boundedString(value, MAX_LIVE_STRING_BYTES);
+    }
+    if (typeof value === "number" || typeof value === "boolean" || value === null) return value;
+    if (depth >= 12) {
+      markArgsTruncated();
+      return void 0;
+    }
+    if (key === "timing" && !argsValue) return boundedTiming(value);
+    if (key === "output" && object(value) && value.status === "available") {
+      const boundedOutput = boundedLiveValue(value.value, "value", depth + 1, bounds);
+      return liveValueWillBeBounded(value.value, "value", depth + 1) ? { status: "truncated", kind: "result", bytes: value.bytes } : { ...value, value: boundedOutput };
+    }
+    if (Array.isArray(value)) {
+      const array = value;
+      const maxEntries = !argsValue && LIVE_TRUNCATABLE_ARRAY_KEYS.has(key) ? MAX_LIVE_ARRAY_ENTRIES - 1 : MAX_LIVE_ARRAY_ENTRIES;
+      const entries = !argsValue && key === "attemptDetails" ? array.slice(-8) : !argsValue && LIVE_METADATA_ARRAY_KEYS.has(key) ? array : array.length <= maxEntries ? array : [...array.slice(0, 32), ...array.slice(-maxEntries + 32)];
+      if (entries.length !== array.length) markArgsTruncated();
+      const publisherRuns = bounds?.path.length === 1 && bounds.path[0] === "runs";
+      const bounded = entries.map((entry, index) => {
+        const previousRunIndex = bounds?.runIndex;
+        if (publisherRuns) bounds.runIndex = index;
+        const result = boundedLiveValue(entry, "", depth + 1, bounds);
+        if (bounds) bounds.runIndex = previousRunIndex;
+        return result;
+      });
+      if (entries.length !== array.length && LIVE_TRUNCATABLE_ARRAY_KEYS.has(key)) bounded.push({ type: "trajectory:truncated", field: key, omitted: array.length - entries.length });
+      return bounded;
+    }
+    if (object(value)) {
+      const result = {};
+      const keys = Object.keys(value).sort();
+      const properties = !argsValue && LIVE_METADATA_OBJECT_KEYS.has(key) ? keys : keys.slice(0, MAX_LIVE_OBJECT_KEYS);
+      if (properties.length !== keys.length) markArgsTruncated();
+      for (const property of properties) result[property] = boundedLiveValue(value[property], property, depth + 1, bounds);
+      return result;
+    }
+    return void 0;
+  } finally {
+    if (bounds) bounds.path.length = pathLength;
   }
-  return void 0;
 }
 function transcriptRevisionProjection(value, depth = 0) {
   if (depth >= 8) return typeof value === "string" ? boundedString(value, 1024) : typeof value === "number" || typeof value === "boolean" || value === null ? value : void 0;
@@ -3007,7 +3160,19 @@ function projectPublisher(metadata, publisher, revisions) {
   return { ...publisher, runs: metadata.runs.map((run) => projectRun(run, `${publisherId2}	${run.run.id}`, revisions)), subagents: metadata.subagents.map((subagent) => projectSubagent(subagent, `${publisherId2}	subagent	${subagent.id}`, revisions)) };
 }
 function minimalStatePublisher(publisher) {
-  return boundedLiveValue(publisher) ?? {};
+  const bounds = { argsTruncatedRuns: /* @__PURE__ */ new Set(), path: [], runIndex: void 0 };
+  const bounded = boundedLiveValue(publisher, "", 0, bounds) ?? {};
+  const sourceRuns = Array.isArray(publisher.runs) ? publisher.runs : [];
+  const boundedRuns = Array.isArray(bounded.runs) ? bounded.runs : [];
+  if (!sourceRuns.length || !boundedRuns.length) return bounded;
+  const runs = boundedRuns.map((run, index) => {
+    const sourceRun = sourceRuns[index];
+    const sourceSnapshot = object(sourceRun) && object(sourceRun.snapshot) ? sourceRun.snapshot : void 0;
+    const boundedSnapshot = object(run) && object(run.snapshot) ? run.snapshot : void 0;
+    const argsUnavailable = sourceSnapshot !== void 0 && sourceSnapshot.args !== void 0 && sourceSnapshot.args !== null && (boundedSnapshot === void 0 || !Object.prototype.hasOwnProperty.call(boundedSnapshot, "args"));
+    return (bounds.argsTruncatedRuns.has(index) || argsUnavailable) && object(run) ? { ...run, snapshotArgsTruncated: true } : run;
+  });
+  return { ...bounded, runs };
 }
 function publisherStateFrame(publisher, runs, subagents, truncated = false) {
   const publisherSummary = { ...publisher };
@@ -3077,18 +3242,19 @@ function createTrajectoryController(agentDir) {
     for (const request of pendingTranscripts.values()) clearTimeout(request.timer);
     pendingTranscripts.clear();
   };
+  let viewers = 0;
   const startPolling = () => {
     stopPolling();
     pollTimer = setInterval(() => {
       void sendState().catch((error) => {
         if (!closing) console.error(`Trajectory state publish failed: ${errorText(error)}`);
       });
-    }, 1e3);
+    }, viewers > 0 ? ACTIVE_POLL_MS : IDLE_POLL_MS);
     pollTimer.unref();
   };
   let stateLoad;
   let lastState;
-  const publisherValue = (input) => ({ id: publisherId(input.cwd, input.sessionId), title: `session ${input.sessionId.slice(0, 8)}`, cwd: input.cwd, sessionId: input.sessionId, themes: input.themes, connected: true });
+  const publisherValue = (input) => ({ id: publisherId(input.cwd, input.sessionId), title: `session ${input.sessionId.slice(0, 8)}`, cwd: input.cwd, sessionId: input.sessionId, connected: true });
   const sendState = async () => {
     const activeSocket = socket;
     if (activeSocket !== void 0 && stateLoad?.socket === activeSocket) return stateLoad.task;
@@ -3130,22 +3296,15 @@ function createTrajectoryController(agentDir) {
     }
   };
   const transcriptFromFallback = async (input, request) => {
-    const boundedTranscriptResult = (result) => {
-      try {
-        if (result.status === "available" && Buffer.byteLength(JSON.stringify(result.entries)) > TRAJECTORY_MAX_TRANSCRIPT_BYTES) return { status: "oversized", revision: result.revision, entries: [], error: "Transcript is too large" };
-      } catch {
-        return { status: "failed", revision: result.revision, entries: [], error: "Transcript failed" };
-      }
-      return result;
-    };
-    const boundedResult = (entries, revision) => {
+    const oversized = (entries, revision) => {
       try {
-        if (Buffer.byteLength(JSON.stringify(entries)) > TRAJECTORY_MAX_TRANSCRIPT_BYTES) return { status: "oversized", revision, entries: [], error: "Transcript is too large" };
+        return Buffer.byteLength(JSON.stringify(entries)) > TRAJECTORY_MAX_TRANSCRIPT_BYTES ? { status: "oversized", revision, entries: [], error: "Transcript is too large" } : void 0;
       } catch {
         return { status: "failed", revision, entries: [], error: "Transcript failed" };
       }
-      return { status: entries.length ? "available" : "empty", revision, entries };
     };
+    const boundedTranscriptResult = (result) => (result.status === "available" ? oversized(result.entries, result.revision) : void 0) ?? result;
+    const boundedResult = (entries, revision) => oversized(entries, revision) ?? { status: entries.length ? "available" : "empty", revision, entries };
     if (input.loadTranscript) {
       const result = await input.loadTranscript(request);
       const revisionChanged = request.revision !== void 0 && result.revision !== request.revision && result.status !== "missing" && result.status !== "failed" && result.status !== "oversized" && result.status !== "disconnected";
@@ -3244,6 +3403,14 @@ function createTrajectoryController(agentDir) {
           established = false;
           return;
         }
+        if (message.type === "publisher:viewers" && typeof message.count === "number") {
+          const watched = viewers > 0;
+          viewers = message.count;
+          if (watched === viewers > 0) return;
+          if (socket === next && !closing) startPolling();
+          if (viewers > 0) void sendState().catch(() => void 0);
+          return;
+        }
         if (message.type === "publisher:transcript" && typeof message.requestId === "string" && typeof message.publisherId === "string" && (typeof message.runId === "string" && typeof message.agentId === "string" || typeof message.subagentId === "string")) {
           handleTranscriptRequest(next, generation, message, input);
           return;
@@ -3398,7 +3565,7 @@ function createTrajectoryController(agentDir) {
   };
 }
 function registerTrajectoryExtension(pi, options = {}) {
-  const controller = options.controller ?? createTrajectoryController(options.agentDir ?? getAgentDir3());
+  const controller = options.controller ?? createTrajectoryController(options.agentDir ?? getAgentDir4());
   const openUrl = options.openUrl ?? openTrajectoryUrl;
   let autoAttached = false;
   const notify = (context, message, level) => {
@@ -3450,6 +3617,7 @@ export {
   createTrajectoryController,
   extension as default,
   exportTrajectoryRunHtml,
+  minimalStatePublisher,
   openTrajectoryUrl,
   registerTrajectoryExtension,
   shareTrajectoryRun,