poe-code 3.0.183 → 3.0.185

package/dist/providers/poe-agent.js

@@ -16,9 +16,9 @@ var __export = (target, all) => {
 };
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+    for (let key2 of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key2) && key2 !== except)
+        __defProp(to, key2, { get: () => from[key2], enumerable: !(desc = __getOwnPropDesc(from, key2)) || desc.enumerable });
   }
   return to;
 };
@@ -609,8 +609,8 @@ function resourceNotFound(resource) {
     `Resource not found: ${resource}`
   );
 }
-function assertAbsolutePath(path26) {
-  if (!isAbsolute(path26)) {
+function assertAbsolutePath(path28) {
+  if (!isAbsolute(path28)) {
     throw invalidParams('"path" must be an absolute path');
   }
 }
@@ -1411,8 +1411,8 @@ function cloneUnknown(value) {
   }
   if (typeof value === "object" && value !== null) {
     const cloned = {};
-    for (const [key, entry] of Object.entries(value)) {
-      cloned[key] = cloneUnknown(entry);
+    for (const [key2, entry] of Object.entries(value)) {
+      cloned[key2] = cloneUnknown(entry);
     }
     return cloned;
   }
@@ -1572,46 +1572,46 @@ function toOptionsObject(input) {
   return input;
 }
 function rejectUnknownKeys(input, allowedKeys) {
-  for (const key of Object.keys(input)) {
-    if (!allowedKeys.includes(key)) {
-      throw new Error(`${key}: unknown option`);
+  for (const key2 of Object.keys(input)) {
+    if (!allowedKeys.includes(key2)) {
+      throw new Error(`${key2}: unknown option`);
     }
   }
 }
-function readOptionalString(input, key) {
-  const value = input[key];
+function readOptionalString(input, key2) {
+  const value = input[key2];
   if (value === void 0) {
     return void 0;
   }
   if (typeof value !== "string") {
-    throw new Error(`${key}: expected a string`);
+    throw new Error(`${key2}: expected a string`);
   }
   return value;
 }
-function readOptionalStringArray(input, key) {
-  const value = input[key];
+function readOptionalStringArray(input, key2) {
+  const value = input[key2];
   if (value === void 0) {
     return void 0;
   }
   if (!Array.isArray(value) || !value.every((item) => typeof item === "string")) {
-    throw new Error(`${key}: expected an array of strings`);
+    throw new Error(`${key2}: expected an array of strings`);
   }
   return value;
 }
-function readOptionalNonNegativeInteger(input, key) {
-  const value = input[key];
+function readOptionalNonNegativeInteger(input, key2) {
+  const value = input[key2];
   if (value === void 0) {
     return void 0;
   }
   if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
-    throw new Error(`${key}: expected a non-negative integer`);
+    throw new Error(`${key2}: expected a non-negative integer`);
   }
   return value;
 }
-function readRequiredEnum(input, key, allowedValues) {
-  const value = input[key];
+function readRequiredEnum(input, key2, allowedValues) {
+  const value = input[key2];
   if (typeof value !== "string" || !allowedValues.includes(value)) {
-    throw new Error(`${key}: expected one of ${allowedValues.join(", ")}`);
+    throw new Error(`${key2}: expected one of ${allowedValues.join(", ")}`);
   }
   return value;
 }
@@ -1645,12 +1645,7 @@ var init_poe_agent_plugin_policy = __esm({
           },
           async preToolUse(ctx) {
             const mode = ctx.session.get(POLICY_MODE_SESSION_KEY);
-            if (mode === void 0) {
-              return {
-                reject: "Policy mode is unavailable for this session."
-              };
-            }
-            if (mode === "yolo") {
+            if (mode === void 0 || mode === "yolo") {
               return;
             }
             const tool = getTool(ctx.tool);
@@ -2301,8 +2296,12 @@ async function runLoop(options) {
     if (collectedResponse.toolOutcomes.length === 0) {
       return {
         output: collectedResponse.content,
+        stdout: collectedResponse.content,
+        summary: collectedResponse.content,
         messages: [...options.runContext.messages],
-        toolCalls: [...options.toolCalls]
+        toolCalls: [...options.toolCalls],
+        exitCode: 0,
+        stderr: ""
       };
     }
   }
@@ -2922,68 +2921,68 @@ import path7 from "node:path";
 function isObjectRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function getRequiredString(args, key, allowEmptyString = false) {
+function getRequiredString(args, key2, allowEmptyString = false) {
   if (!isObjectRecord4(args)) {
-    throw new Error(`Tool argument "${key}" must be a string`);
+    throw new Error(`Tool argument "${key2}" must be a string`);
   }
-  const value = args[key];
+  const value = args[key2];
   if (typeof value !== "string") {
-    throw new Error(`Tool argument "${key}" must be a string`);
+    throw new Error(`Tool argument "${key2}" must be a string`);
   }
   if (!allowEmptyString && value.trim().length === 0) {
-    throw new Error(`Tool argument "${key}" must not be empty`);
+    throw new Error(`Tool argument "${key2}" must not be empty`);
   }
   return value;
 }
-function getOptionalString(args, key) {
+function getOptionalString(args, key2) {
   if (!isObjectRecord4(args)) {
-    throw new Error(`Tool argument "${key}" must be a string`);
+    throw new Error(`Tool argument "${key2}" must be a string`);
   }
-  const value = args[key];
+  const value = args[key2];
   if (value === void 0) {
     return void 0;
   }
   if (typeof value !== "string") {
-    throw new Error(`Tool argument "${key}" must be a string`);
+    throw new Error(`Tool argument "${key2}" must be a string`);
   }
   return value;
 }
-function getOptionalBoolean(args, key) {
+function getOptionalBoolean(args, key2) {
   if (!isObjectRecord4(args)) {
-    throw new Error(`Tool argument "${key}" must be a boolean`);
+    throw new Error(`Tool argument "${key2}" must be a boolean`);
   }
-  const value = args[key];
+  const value = args[key2];
   if (value === void 0) {
     return void 0;
   }
   if (typeof value !== "boolean") {
-    throw new Error(`Tool argument "${key}" must be a boolean`);
+    throw new Error(`Tool argument "${key2}" must be a boolean`);
   }
   return value;
 }
-function getOptionalNumber(args, key) {
+function getOptionalNumber(args, key2) {
   if (!isObjectRecord4(args)) {
-    throw new Error(`Tool argument "${key}" must be a number`);
+    throw new Error(`Tool argument "${key2}" must be a number`);
   }
-  const value = args[key];
+  const value = args[key2];
   if (value === void 0) {
     return void 0;
   }
   if (typeof value !== "number" || !Number.isFinite(value)) {
-    throw new Error(`Tool argument "${key}" must be a finite number`);
+    throw new Error(`Tool argument "${key2}" must be a finite number`);
   }
   return value;
 }
-function getOptionalNonNegativeInteger(args, key) {
+function getOptionalNonNegativeInteger(args, key2) {
   if (!isObjectRecord4(args)) {
-    throw new Error(`Tool argument "${key}" must be a non-negative integer`);
+    throw new Error(`Tool argument "${key2}" must be a non-negative integer`);
   }
-  const value = args[key];
+  const value = args[key2];
   if (value === void 0) {
     return void 0;
   }
   if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
-    throw new Error(`Tool argument "${key}" must be a non-negative integer`);
+    throw new Error(`Tool argument "${key2}" must be a non-negative integer`);
   }
   return value;
 }
@@ -3013,9 +3012,9 @@ import fsPromises2 from "node:fs/promises";
 import path8 from "node:path";
 import { promisify } from "node:util";
 import fastGlob from "fast-glob";
-async function fileExists(fs3, filePath) {
+async function fileExists(fs4, filePath) {
   try {
-    await fs3.stat(filePath);
+    await fs4.stat(filePath);
     return true;
   } catch {
     return false;
@@ -3033,13 +3032,13 @@ function countOccurrences(text4, search) {
   }
   return count;
 }
-function getOptionalGrepOutputMode(args, key) {
+function getOptionalGrepOutputMode(args, key2) {
   if (!isObjectRecord4(args)) {
     throw new Error(
-      `Tool argument "${key}" must be one of "files_with_matches", "content", or "count"`
+      `Tool argument "${key2}" must be one of "files_with_matches", "content", or "count"`
     );
   }
-  const value = args[key];
+  const value = args[key2];
   if (value === void 0) {
     return void 0;
   }
@@ -3047,17 +3046,17 @@ function getOptionalGrepOutputMode(args, key) {
     return value;
   }
   throw new Error(
-    `Tool argument "${key}" must be one of "files_with_matches", "content", or "count"`
+    `Tool argument "${key2}" must be one of "files_with_matches", "content", or "count"`
   );
 }
 function formatDisplayPath(cwd, filePath) {
   return path8.relative(cwd, filePath) || path8.basename(filePath);
 }
-async function sortPathsByModifiedTime(matches2, fs3) {
+async function sortPathsByModifiedTime(matches2, fs4) {
   const entries = await Promise.all(
     matches2.map(async (match) => ({
       path: match,
-      mtimeMs: (await fs3.stat(match)).mtimeMs
+      mtimeMs: (await fs4.stat(match)).mtimeMs
     }))
   );
   entries.sort((left, right) => {
@@ -3068,8 +3067,8 @@ async function sortPathsByModifiedTime(matches2, fs3) {
   });
   return entries.map((entry) => entry.path);
 }
-async function defaultSearchContent(options, fs3) {
-  const targetStat = await fs3.stat(options.path);
+async function defaultSearchContent(options, fs4) {
+  const targetStat = await fs4.stat(options.path);
   const searchCwd = targetStat.isDirectory() ? options.path : path8.dirname(options.path);
   const searchTarget = targetStat.isDirectory() ? "." : path8.basename(options.path);
   const args = ["--color", "never"];
@@ -3200,8 +3199,8 @@ var init_poe_agent_plugin_files = __esm({
       const allowedPaths = (options.allowedPaths ?? [cwd]).map(
         (allowedPath) => path8.resolve(cwd, allowedPath)
       );
-      const fs3 = options.fs ?? fsPromises2;
-      const searchContent = options.searchContent ?? ((searchOptions) => defaultSearchContent(searchOptions, fs3));
+      const fs4 = options.fs ?? fsPromises2;
+      const searchContent = options.searchContent ?? ((searchOptions) => defaultSearchContent(searchOptions, fs4));
       const globFiles = options.globFiles ?? defaultGlobFiles;
       const readFileTool = {
         name: "read_file",
@@ -3234,14 +3233,14 @@ var init_poe_agent_plugin_files = __esm({
           const filePath = resolveAllowedPath(cwd, allowedPaths, getRequiredString(args, "path"));
           const imageMimeType = detectImageMimeType(filePath);
           if (imageMimeType !== void 0) {
-            const content2 = await fs3.readFile(filePath);
+            const content2 = await fs4.readFile(filePath);
             return {
               type: "image",
               mimeType: imageMimeType,
               data: Buffer.from(content2).toString("base64")
             };
           }
-          const content = await fs3.readFile(filePath, "utf8");
+          const content = await fs4.readFile(filePath, "utf8");
           return sliceLines(
             content,
             getOptionalNonNegativeInteger(args, "offset") ?? 0,
@@ -3295,7 +3294,7 @@ var init_poe_agent_plugin_files = __esm({
             const oldStr = getRequiredString(args, "old_str", true);
             const newStr = getRequiredString(args, "new_str", true);
             const replaceAll = getOptionalBoolean(args, "replace_all") ?? false;
-            const content = await fs3.readFile(filePath, "utf8");
+            const content = await fs4.readFile(filePath, "utf8");
             if (oldStr.length === 0) {
               throw new Error('Tool argument "old_str" must not be empty');
             }
@@ -3306,7 +3305,7 @@ var init_poe_agent_plugin_files = __esm({
             if (!replaceAll && count > 1) {
               throw new Error(`old_str appears ${count} times \u2014 must be unique`);
             }
-            await fs3.writeFile(
+            await fs4.writeFile(
               filePath,
               replaceAll ? content.split(oldStr).join(newStr) : content.replace(oldStr, newStr),
               "utf8"
@@ -3315,17 +3314,17 @@ var init_poe_agent_plugin_files = __esm({
           }
           if (command === "create") {
             const fileText = getRequiredString(args, "file_text", true);
-            if (await fileExists(fs3, filePath)) {
+            if (await fileExists(fs4, filePath)) {
               throw new Error("File already exists \u2014 use str_replace to edit");
             }
-            await fs3.mkdir(path8.dirname(filePath), { recursive: true });
-            await fs3.writeFile(filePath, fileText, "utf8");
+            await fs4.mkdir(path8.dirname(filePath), { recursive: true });
+            await fs4.writeFile(filePath, fileText, "utf8");
             return `Created file: ${displayedPath}`;
           }
           if (command === "overwrite") {
             const fileText = getRequiredString(args, "file_text", true);
-            await fs3.mkdir(path8.dirname(filePath), { recursive: true });
-            await fs3.writeFile(filePath, fileText, "utf8");
+            await fs4.mkdir(path8.dirname(filePath), { recursive: true });
+            await fs4.writeFile(filePath, fileText, "utf8");
             return `Overwrote file: ${displayedPath}`;
           }
           throw new Error(`Unknown edit_file command: ${command}`);
@@ -3350,7 +3349,7 @@ var init_poe_agent_plugin_files = __esm({
         async call(args) {
           const rawPath = getOptionalString(args, "path") ?? ".";
           const directoryPath = resolveAllowedPath(cwd, allowedPaths, rawPath);
-          const entries = await fs3.readdir(directoryPath);
+          const entries = await fs4.readdir(directoryPath);
           const names = entries.sort((left, right) => left.localeCompare(right));
           if (names.length === 0) {
             return "(empty directory)";
@@ -3446,7 +3445,7 @@ var init_poe_agent_plugin_files = __esm({
           });
           const sortedMatches = await sortPathsByModifiedTime(
             matches2.map((match) => resolveAllowedPath(cwd, allowedPaths, match)),
-            fs3
+            fs4
           );
           if (sortedMatches.length === 0) {
             return "(no matches)";
@@ -3609,7 +3608,7 @@ var init_encrypted_file_store = __esm({
         if (!document) {
           return null;
         }
-        const key = await this.getEncryptionKey();
+        const key2 = await this.getEncryptionKey();
         try {
           const iv = Buffer.from(document.iv, "base64");
           const authTag = Buffer.from(document.authTag, "base64");
@@ -3617,7 +3616,7 @@ var init_encrypted_file_store = __esm({
           if (iv.byteLength !== ENCRYPTION_IV_BYTES || authTag.byteLength !== ENCRYPTION_AUTH_TAG_BYTES) {
             return null;
           }
-          const decipher = createDecipheriv(ENCRYPTION_ALGORITHM, key, iv);
+          const decipher = createDecipheriv(ENCRYPTION_ALGORITHM, key2, iv);
           decipher.setAuthTag(authTag);
           const plaintext = Buffer.concat([decipher.update(ciphertext), decipher.final()]);
           return plaintext.toString("utf8");
@@ -3626,9 +3625,9 @@ var init_encrypted_file_store = __esm({
         }
       }
       async set(value) {
-        const key = await this.getEncryptionKey();
+        const key2 = await this.getEncryptionKey();
         const iv = this.getRandomBytes(ENCRYPTION_IV_BYTES);
-        const cipher = createCipheriv(ENCRYPTION_ALGORITHM, key, iv);
+        const cipher = createCipheriv(ENCRYPTION_ALGORITHM, key2, iv);
         const ciphertext = Buffer.concat([
           cipher.update(value, "utf8"),
           cipher.final()
@@ -3838,6 +3837,13 @@ var init_create_secret_store = __esm({
   }
 });
 
+// packages/auth-store/src/provider-store.ts
+var init_provider_store = __esm({
+  "packages/auth-store/src/provider-store.ts"() {
+    "use strict";
+  }
+});
+
 // packages/auth-store/src/index.ts
 var init_src2 = __esm({
   "packages/auth-store/src/index.ts"() {
@@ -3845,6 +3851,7 @@ var init_src2 = __esm({
     init_create_secret_store();
     init_encrypted_file_store();
     init_keychain_store();
+    init_provider_store();
   }
 });
 
@@ -4204,19 +4211,19 @@ function resolveClientBaseUrl(baseUrl) {
   }
   return DEFAULT_BASE_URL;
 }
-function readOptionalStringRecord(input, key) {
-  const value = input[key];
+function readOptionalStringRecord(input, key2) {
+  const value = input[key2];
   if (value === void 0) {
     return void 0;
   }
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    throw new Error(`${key}: expected an object of string values`);
+    throw new Error(`${key2}: expected an object of string values`);
   }
   const entries = Object.entries(value);
   const record = {};
   for (const [entryKey, entryValue] of entries) {
     if (typeof entryValue !== "string") {
-      throw new Error(`${key}: expected an object of string values`);
+      throw new Error(`${key2}: expected an object of string values`);
     }
     record[entryKey] = entryValue;
   }
@@ -4745,28 +4752,28 @@ function resolveClientBaseUrl2(baseUrl) {
   }
   return DEFAULT_BASE_URL2;
 }
-function readOptionalEnum(input, key, allowedValues) {
-  const value = input[key];
+function readOptionalEnum(input, key2, allowedValues) {
+  const value = input[key2];
   if (value === void 0) {
     return void 0;
   }
   if (typeof value !== "string" || !allowedValues.includes(value)) {
-    throw new Error(`${key}: expected one of ${allowedValues.join(", ")}`);
+    throw new Error(`${key2}: expected one of ${allowedValues.join(", ")}`);
   }
   return value;
 }
-function readOptionalStringRecord2(input, key) {
-  const value = input[key];
+function readOptionalStringRecord2(input, key2) {
+  const value = input[key2];
   if (value === void 0) {
     return void 0;
   }
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    throw new Error(`${key}: expected an object of string values`);
+    throw new Error(`${key2}: expected an object of string values`);
   }
   const record = {};
   for (const [entryKey, entryValue] of Object.entries(value)) {
     if (typeof entryValue !== "string") {
-      throw new Error(`${key}: expected an object of string values`);
+      throw new Error(`${key2}: expected an object of string values`);
     }
     record[entryKey] = entryValue;
   }
@@ -5990,11 +5997,11 @@ async function loadMemory(options) {
   }
   return sections.join("\n\n");
 }
-async function findNearestAgentsFile(cwd, fs3) {
+async function findNearestAgentsFile(cwd, fs4) {
   let currentDirectory = cwd;
   while (true) {
     const filePath = path11.join(currentDirectory, AGENTS_FILE);
-    if (await readOptionalFile(filePath, fs3) !== void 0) {
+    if (await readOptionalFile(filePath, fs4) !== void 0) {
       return filePath;
     }
     const parentDirectory = path11.dirname(currentDirectory);
@@ -6004,15 +6011,15 @@ async function findNearestAgentsFile(cwd, fs3) {
     currentDirectory = parentDirectory;
   }
 }
-async function loadOptionalMemoryFile(filePath, fs3) {
-  const content = await readOptionalFile(filePath, fs3);
+async function loadOptionalMemoryFile(filePath, fs4) {
+  const content = await readOptionalFile(filePath, fs4);
   if (content === void 0) {
     return void 0;
   }
   return await expandImports({
     filePath,
     content,
-    fs: fs3,
+    fs: fs4,
     loading: /* @__PURE__ */ new Set()
   });
 }
@@ -6063,9 +6070,9 @@ ${content}`;
 function normalizeLineEndings(content) {
   return content.split("\r\n").join("\n");
 }
-async function readOptionalFile(filePath, fs3) {
+async function readOptionalFile(filePath, fs4) {
   try {
-    return await fs3.readFile(filePath, "utf8");
+    return await fs4.readFile(filePath, "utf8");
   } catch (error2) {
     if (isMissingFileError(error2)) {
       return void 0;
@@ -6073,8 +6080,8 @@ async function readOptionalFile(filePath, fs3) {
     throw error2;
   }
 }
-async function readRequiredFile(filePath, fs3) {
-  const content = await readOptionalFile(filePath, fs3);
+async function readRequiredFile(filePath, fs4) {
+  const content = await readOptionalFile(filePath, fs4);
   if (content !== void 0) {
     return content;
   }
@@ -6096,12 +6103,12 @@ var init_poe_agent_plugin_memory = __esm({
     memoryPlugin = (options = {}) => {
       const cwd = path11.resolve(options.cwd ?? process.cwd());
       const homeDir = path11.resolve(options.homeDir ?? os.homedir());
-      const fs3 = options.fs ?? fsPromises3;
+      const fs4 = options.fs ?? fsPromises3;
       let memoryPromise;
       return {
         name: "poe-agent-plugin-memory",
         async prompt(ctx) {
-          memoryPromise ??= loadMemory({ cwd, homeDir, fs: fs3 });
+          memoryPromise ??= loadMemory({ cwd, homeDir, fs: fs4 });
           const memory = await memoryPromise;
           if (!memory) {
             return ctx;
@@ -6168,9 +6175,9 @@ function parsePluginConfigEntry(input) {
   if (!isPlainObject2(input)) {
     throw new PluginConfigError("agent.plugins: must be an object.");
   }
-  for (const key of Object.keys(input)) {
-    if (key !== "name" && key !== "options") {
-      throw new PluginConfigError(`agent.plugins: unknown key "${key}".`);
+  for (const key2 of Object.keys(input)) {
+    if (key2 !== "name" && key2 !== "options") {
+      throw new PluginConfigError(`agent.plugins: unknown key "${key2}".`);
     }
   }
   const name = input.name;
@@ -8487,7 +8494,115 @@ var init_resolve_provider = __esm({
   }
 });
 
+// packages/poe-agent/src/runtime/transcript.ts
+import path12 from "node:path";
+function mapAcpEventToSessionUpdates(event) {
+  if (event.type === "message.delta") {
+    if (event.content.length === 0) return [];
+    return [{ sessionUpdate: "agent_message_chunk", content: { type: "text", text: event.content } }];
+  }
+  if (event.type === "tool.intent") {
+    return [
+      {
+        sessionUpdate: "tool_call",
+        toolCallId: event.intentId,
+        title: event.tool,
+        kind: "execute",
+        status: "pending",
+        rawInput: event.args
+      },
+      {
+        sessionUpdate: "tool_call_update",
+        toolCallId: event.intentId,
+        kind: "execute",
+        status: "in_progress"
+      }
+    ];
+  }
+  if (event.type === "tool.result") {
+    return [
+      {
+        sessionUpdate: "tool_call_update",
+        toolCallId: event.intentId,
+        kind: "execute",
+        status: "completed",
+        rawOutput: event.result
+      }
+    ];
+  }
+  if (event.type === "tool.error") {
+    return [
+      {
+        sessionUpdate: "tool_call_update",
+        toolCallId: event.intentId,
+        kind: "execute",
+        status: "failed",
+        rawOutput: event.error
+      }
+    ];
+  }
+  if (event.type === "usage") {
+    const { inputTokens, outputTokens, cachedTokens, cacheCreationTokens } = event.usage;
+    const nonCachedInput = Math.max(0, inputTokens - cachedTokens);
+    return [
+      {
+        sessionUpdate: "usage_update",
+        used: nonCachedInput,
+        size: inputTokens,
+        _meta: { inputTokens, outputTokens, cachedTokens, cacheCreationTokens }
+      }
+    ];
+  }
+  return [];
+}
+function createTranscriptWriter(options) {
+  const join2 = options.pathJoin ?? path12.join;
+  const filePath = resolveTranscriptFilePath(options, join2);
+  let dirEnsured;
+  let disabled = false;
+  const logDir = path12.dirname(filePath);
+  const ensureDir = () => {
+    if (!dirEnsured) {
+      dirEnsured = options.fs.mkdir(logDir, { recursive: true });
+    }
+    return dirEnsured;
+  };
+  return {
+    filePath,
+    async write(event) {
+      if (disabled) return;
+      const updates = mapAcpEventToSessionUpdates(event);
+      if (updates.length === 0) return;
+      try {
+        await ensureDir();
+        const payload = updates.map((update) => `${JSON.stringify(update)}
+`).join("");
+        await options.fs.appendFile(filePath, payload);
+      } catch {
+        disabled = true;
+      }
+    },
+    async close() {
+    }
+  };
+}
+function resolveTranscriptFilePath(options, join2) {
+  if (options.logPath) {
+    return options.logPath;
+  }
+  if (options.logDir && options.logFileName) {
+    return join2(options.logDir, options.logFileName);
+  }
+  throw new Error("createTranscriptWriter requires logPath or logDir + logFileName.");
+}
+var init_transcript = __esm({
+  "packages/poe-agent/src/runtime/transcript.ts"() {
+    "use strict";
+  }
+});
+
 // packages/poe-agent/src/agent.ts
+import * as fsPromises4 from "node:fs/promises";
 function agent() {
   return new ImmutableAgentBuilder();
 }
@@ -8515,6 +8630,19 @@ function toSpawnMcpServers(mcpServers) {
   }
   return byName;
 }
+function normalizeMcpConfigs(configsOrMap) {
+  const [first, ...rest] = configsOrMap;
+  if (first === void 0) {
+    return [];
+  }
+  if (rest.length > 0 || isNamedMcpServerConfig(first)) {
+    return [first, ...rest];
+  }
+  return Object.entries(first).map(([name, server]) => ({ name, ...server }));
+}
+function isNamedMcpServerConfig(value) {
+  return typeof value === "object" && value !== null && typeof value.name === "string" && typeof value.command === "string";
+}
 function resolveActiveSkills(options) {
   if (options.skills !== void 0) {
     return options.skills;
@@ -8572,7 +8700,7 @@ function toError4(value) {
   }
   return new Error(String(value));
 }
-var ImmutableAgentBuilder, CallerAcpHost;
+var ImmutableAgentBuilder, defaultTranscriptFs, CallerAcpHost;
 var init_agent = __esm({
   "packages/poe-agent/src/agent.ts"() {
     "use strict";
@@ -8586,6 +8714,7 @@ var init_agent = __esm({
     init_plugin_setup();
     init_resolve_provider();
     init_run_context();
+    init_transcript();
     init_tool_names();
     ImmutableAgentBuilder = class _ImmutableAgentBuilder {
       #config;
@@ -8617,7 +8746,8 @@ var init_agent = __esm({
           tools
         });
       }
-      mcp(...configs) {
+      mcp(...configsOrMap) {
+        const configs = normalizeMcpConfigs(configsOrMap);
         return new _ImmutableAgentBuilder(
           createResolvedAgentConfig({
             ...this.#config,
@@ -8661,32 +8791,124 @@ var init_agent = __esm({
         };
       }
       async run(prompt, options = {}) {
-        const events = await this.#startRun(prompt, options).catch((error2) => {
+        const startedRun = await this.#startRun(prompt, options).catch((error2) => {
           throw toError4(error2);
         });
+        const { events, runContext } = startedRun;
         let completed;
-        let failed = void 0;
-        for await (const event of events) {
-          if (event.type === "session.complete") {
-            completed = event.result;
-            continue;
-          }
-          if (event.type === "session.error") {
-            failed = event.error;
+        let failed;
+        let usage;
+        let streamedOutput = "";
+        const streamedToolCalls = /* @__PURE__ */ new Map();
+        const transcript = options.logPath ? createTranscriptWriter({
+          logPath: options.logPath,
+          fs: defaultTranscriptFs
+        }) : void 0;
+        try {
+          for await (const event of events) {
+            await transcript?.write(event);
+            if (event.type === "message.delta") {
+              options.onStdout?.(event.content);
+              streamedOutput += event.content;
+              continue;
+            }
+            if (event.type === "usage") {
+              usage = event.usage;
+              continue;
+            }
+            if (event.type === "tool.intent") {
+              streamedToolCalls.set(event.intentId, {
+                intentId: event.intentId,
+                tool: event.tool,
+                args: event.args
+              });
+              continue;
+            }
+            if (event.type === "tool.result") {
+              const toolCall = streamedToolCalls.get(event.intentId);
+              if (toolCall) {
+                toolCall.status = "success";
+                toolCall.result = event.result;
+                toolCall.error = void 0;
+              }
+              continue;
+            }
+            if (event.type === "tool.error") {
+              const toolCall = streamedToolCalls.get(event.intentId);
+              if (toolCall) {
+                toolCall.status = "error";
+                toolCall.error = event.error;
+                toolCall.result = void 0;
+              }
+              continue;
+            }
+            if (event.type === "session.complete") {
+              completed = event.result;
+              continue;
+            }
+            if (event.type === "session.error") {
+              failed = event.error;
+            }
           }
+        } finally {
+          await transcript?.close();
         }
+        const logFile = transcript?.filePath ?? completed?.logFile;
+        const resultUsage = usage ?? completed?.usage;
+        const resultMessages = completed?.messages ?? (runContext.messages.length === 1 && runContext.messages[0]?.role === "user" ? [] : [...runContext.messages]);
+        const resultToolCalls = completed?.toolCalls ?? Array.from(streamedToolCalls.values()).map((toolCall) => {
+          if (toolCall.status === "success") {
+            return {
+              intentId: toolCall.intentId,
+              tool: toolCall.tool,
+              args: toolCall.args,
+              status: "success",
+              result: toolCall.result
+            };
+          }
+          return {
+            intentId: toolCall.intentId,
+            tool: toolCall.tool,
+            args: toolCall.args,
+            status: "error",
+            error: toolCall.error ?? failed?.message ?? "Run ended before the tool completed."
+          };
+        });
         if (failed) {
-          throw failed;
+          const fallback = completed ?? {
+            output: streamedOutput,
+            stdout: streamedOutput,
+            messages: resultMessages,
+            toolCalls: resultToolCalls,
+            exitCode: 1,
+            stderr: failed.message
+          };
+          return {
+            ...fallback,
+            ...resultUsage === void 0 ? {} : { usage: resultUsage },
+            ...logFile === void 0 ? {} : { logFile },
+            stdout: fallback.stdout ?? fallback.output,
+            exitCode: 1,
+            stderr: failed.message
+          };
         }
         if (!completed) {
           throw new Error("Run ended without a terminal event.");
         }
-        return completed;
+        return {
+          ...completed,
+          ...resultUsage === void 0 ? {} : { usage: resultUsage },
+          ...logFile === void 0 ? {} : { logFile },
+          stdout: completed.stdout ?? completed.output,
+          summary: completed.summary ?? completed.output,
+          exitCode: completed.exitCode ?? 0,
+          stderr: completed.stderr ?? ""
+        };
       }
       async *stream(prompt, options = {}) {
         try {
-          const events = await this.#startRun(prompt, options);
-          for await (const event of events) {
+          const startedRun = await this.#startRun(prompt, options);
+          for await (const event of startedRun.events) {
             yield event;
           }
         } catch (error2) {
@@ -8705,14 +8927,17 @@ var init_agent = __esm({
           maxIterations: prepared.maxIterations,
           createSpawnSession: prepared.createSpawnSession
         });
-        return runAcpCore({
-          prompt,
-          runContext: prepared.runContext,
-          host,
-          model: prepared.model,
-          baseSystemPrompt: prepared.baseSystemPrompt,
-          maxIterations: prepared.maxIterations
-        });
+        return {
+          ...prepared,
+          events: runAcpCore({
+            prompt,
+            runContext: prepared.runContext,
+            host,
+            model: prepared.model,
+            baseSystemPrompt: prepared.baseSystemPrompt,
+            maxIterations: prepared.maxIterations
+          })
+        };
       }
       async #prepareRun(options) {
         const activeSkills = resolveActiveSkills(options);
@@ -8775,6 +9000,10 @@ var init_agent = __esm({
         }
       }
     };
+    defaultTranscriptFs = {
+      mkdir: (dir, options) => fsPromises4.mkdir(dir, options).then(() => void 0),
+      appendFile: (filePath, contents) => fsPromises4.appendFile(filePath, contents, "utf8")
+    };
     CallerAcpHost = class {
       #runContext;
       #delegate;
@@ -8834,7 +9063,7 @@ var init_agent = __esm({
 });
 
 // packages/poe-agent/src/plugins/poe-agent-plugin-audit-log.ts
-import { appendFile } from "node:fs/promises";
+import { appendFile as appendFile2 } from "node:fs/promises";
 var auditLog, poe_agent_plugin_audit_log_default;
 var init_poe_agent_plugin_audit_log = __esm({
   "packages/poe-agent/src/plugins/poe-agent-plugin-audit-log.ts"() {
@@ -8843,11 +9072,11 @@ var init_poe_agent_plugin_audit_log = __esm({
       name: "audit-log",
       hooks: {
         async postToolUse(ctx) {
-          await appendFile(logPath, `${JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), tool: ctx.tool })}
+          await appendFile2(logPath, `${JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), tool: ctx.tool })}
 `);
         },
         async postCompaction(ctx) {
-          await appendFile(
+          await appendFile2(
             logPath,
             `${JSON.stringify({
               ts: (/* @__PURE__ */ new Date()).toISOString(),
@@ -9209,8 +9438,8 @@ function toTomlArray(values) {
 }
 function toTomlInlineTable(values) {
   const parts = [];
-  for (const [key, value] of Object.entries(values)) {
-    parts.push(`${JSON.stringify(key)}=${toTomlString(value)}`);
+  for (const [key2, value] of Object.entries(values)) {
+    parts.push(`${JSON.stringify(key2)}=${toTomlString(value)}`);
   }
   return `{${parts.join(", ")}}`;
 }
@@ -9572,7 +9801,7 @@ var init_model_utils = __esm({
 // packages/agent-spawn/src/spawn.ts
 import { spawn as spawnChildProcess2 } from "node:child_process";
 import { mkdirSync, openSync, writeSync, closeSync } from "node:fs";
-import path12 from "node:path";
+import path13 from "node:path";
 function createAbortError() {
   const error2 = new Error("Agent spawn aborted");
   error2.name = "AbortError";
@@ -9751,14 +9980,17 @@ async function spawn5(agentId, options, context) {
   });
 }
 function resolveSpawnLogPath(options) {
+  if (options.logPath) {
+    return options.logPath;
+  }
   if (!options.logDir || !options.logFileName) {
     return void 0;
   }
-  return path12.join(options.logDir, options.logFileName);
+  return path13.join(options.logDir, options.logFileName);
 }
 function openSpawnLog(filePath) {
   try {
-    mkdirSync(path12.dirname(filePath), { recursive: true });
+    mkdirSync(path13.dirname(filePath), { recursive: true });
     return openSync(filePath, "a");
   } catch {
     return void 0;
@@ -10449,12 +10681,12 @@ function parseKeyValue(content) {
   if (separator === -1) {
     return null;
   }
-  const key = trimAsciiWhitespace(content.slice(0, separator));
-  if (key.length === 0) {
+  const key2 = trimAsciiWhitespace(content.slice(0, separator));
+  if (key2.length === 0) {
     return null;
   }
   const rawValue = trimAsciiWhitespaceStart(content.slice(separator + 1));
-  return rawValue.length === 0 ? { key } : { key, value: rawValue };
+  return rawValue.length === 0 ? { key: key2 } : { key: key2, value: rawValue };
 }
 function parseArrayItem(content) {
   if (!isArrayItem(content)) {
@@ -10667,8 +10899,8 @@ function trimAsciiWhitespaceEnd(value) {
   }
   return value.slice(0, end);
 }
-function hasOwn3(record, key) {
-  return Object.prototype.hasOwnProperty.call(record, key);
+function hasOwn3(record, key2) {
+  return Object.prototype.hasOwnProperty.call(record, key2);
 }
 function isHexadecimal(value) {
   for (let index = 0; index < value.length; index += 1) {
@@ -13777,7 +14009,7 @@ function renderFrontmatter(data, context) {
     return "";
   }
   const lines = entries.flatMap(
-    ([key, value]) => wrapText(`${key}: ${formatFrontmatterValue(value)}`, context.width).map(
+    ([key2, value]) => wrapText(`${key2}: ${formatFrontmatterValue(value)}`, context.width).map(
       (line) => typography.dim(line)
     )
   );
@@ -15331,9 +15563,10 @@ function statsToLines(stats, width) {
   }
   const mutedStyle = getToneStyle("muted");
   const totalTokens = stats.tokensIn + stats.tokensOut;
+  const iterationsLabel = stats.iterationsLabel ?? "Iteration";
   const lines = [
     createKeyValueLine("Status", formatStatus(stats.status), width, getStatusStyle(stats.status)),
-    createKeyValueLine("Iteration", formatNumber(stats.iterations), width),
+    createKeyValueLine(iterationsLabel, formatNumber(stats.iterations), width),
     createKeyValueLine("Elapsed", formatElapsed(stats.elapsedMs), width),
     createBlankLine(),
     createKeyValueLine("Tokens In", formatNumber(stats.tokensIn), width),
@@ -15455,8 +15688,8 @@ function parseBinding(binding) {
   let ctrl = false;
   let meta = false;
   let shift = false;
-  const key = parts.at(-1);
-  if (key === void 0) {
+  const key2 = parts.at(-1);
+  if (key2 === void 0) {
     return void 0;
   }
   for (const modifier of parts.slice(0, -1)) {
@@ -15474,19 +15707,19 @@ function parseBinding(binding) {
       continue;
     }
   }
-  if (parts.length === 1 && isShiftedCharacter(key)) {
+  if (parts.length === 1 && isShiftedCharacter(key2)) {
     shift = true;
   }
-  if (key.length === 1) {
+  if (key2.length === 1) {
     return {
-      ch: normalizeBindingCharacter(key, shift),
+      ch: normalizeBindingCharacter(key2, shift),
       ctrl,
       meta,
       shift
     };
   }
   return {
-    name: key.toLowerCase(),
+    name: key2.toLowerCase(),
     ctrl,
     meta,
     shift
@@ -15795,8 +16028,8 @@ function createTerminalDriver(opts) {
       return () => {
       };
     }
-    const listener = (str, key) => {
-      const event = toKeypressEvent(str, key);
+    const listener = (str, key2) => {
+      const event = toKeypressEvent(str, key2);
       if (event !== void 0) {
         handler(event);
       }
@@ -15846,19 +16079,19 @@ function createTerminalDriver(opts) {
     destroy
   };
 }
-function toKeypressEvent(str, key) {
-  const ctrl = key?.ctrl ?? false;
-  const meta = key?.meta ?? false;
-  const shift = key?.shift ?? false;
-  const ch = extractPrintableCharacter(str, key?.sequence);
+function toKeypressEvent(str, key2) {
+  const ctrl = key2?.ctrl ?? false;
+  const meta = key2?.meta ?? false;
+  const shift = key2?.shift ?? false;
+  const ch = extractPrintableCharacter(str, key2?.sequence);
   if (ch !== void 0) {
     return { ch, ctrl, meta, shift };
   }
-  if (key?.name === void 0) {
+  if (key2?.name === void 0) {
     return void 0;
   }
   return {
-    name: key.name,
+    name: key2.name,
     ctrl,
     meta,
     shift
@@ -16455,7 +16688,7 @@ var init_autonomous = __esm({
 });
 
 // packages/agent-spawn/src/acp/replay.ts
-import path13 from "node:path";
+import path14 from "node:path";
 import { homedir as homedir3 } from "node:os";
 import { open, readdir } from "node:fs/promises";
 import { createInterface as createInterface2 } from "node:readline";
@@ -16493,8 +16726,8 @@ function extractTitle(name, input) {
   const keys = TITLE_KEYS[name];
   if (keys && input && typeof input === "object") {
     const obj = input;
-    for (const key of keys) {
-      const value = obj[key];
+    for (const key2 of keys) {
+      const value = obj[key2];
       if (typeof value === "string" && value.length > 0) {
         return truncate2(value, 80);
       }
@@ -16575,21 +16808,21 @@ async function* adaptClaude(lines) {
         if (blockType !== "tool_result") continue;
         const kind = toolKindsById.get(item.tool_use_id);
         toolKindsById.delete(item.tool_use_id);
-        let path26;
+        let path28;
         if (typeof item.content === "string") {
-          path26 = item.content;
+          path28 = item.content;
         } else {
           try {
-            path26 = JSON.stringify(item.content);
+            path28 = JSON.stringify(item.content);
           } catch {
-            path26 = String(item.content);
+            path28 = String(item.content);
           }
         }
         yield {
           event: "tool_complete",
           id: item.tool_use_id,
           kind,
-          path: path26
+          path: path28
         };
       }
     }
@@ -16712,10 +16945,10 @@ async function* adaptCodex(lines) {
         const kindFromStart = toolKindById.get(item.id);
         const kind = kindFromStart ?? (itemType === "command_execution" ? "exec" : itemType === "file_edit" ? "edit" : "other");
         const titleFromEvent = isNonEmptyString(item.path) ? item.path : itemType === "mcp_tool_call" ? `${isNonEmptyString(item.server) ? item.server : "unknown"}.${isNonEmptyString(item.tool) ? item.tool : "unknown"}` : void 0;
-        const path26 = titleFromEvent ?? toolTitleById.get(item.id) ?? "";
+        const path28 = titleFromEvent ?? toolTitleById.get(item.id) ?? "";
         toolTitleById.delete(item.id);
         toolKindById.delete(item.id);
-        yield { event: "tool_complete", id: item.id, kind, path: path26 };
+        yield { event: "tool_complete", id: item.id, kind, path: path28 };
       }
     }
   }
@@ -17239,7 +17472,7 @@ function updateSessionFromEvent(ctx, event, toolCallsById) {
   }
   const id = readString(event.id);
   const kind = readString(event.kind);
-  const path26 = readString(event.path);
+  const path28 = readString(event.path);
   let toolCall = id ? toolCallsById.get(id) : void 0;
   if (!toolCall) {
     toolCall = {};
@@ -17254,8 +17487,8 @@ function updateSessionFromEvent(ctx, event, toolCallsById) {
   if (kind) {
     toolCall.kind = kind;
   }
-  if (path26) {
-    toolCall.path = path26;
+  if (path28) {
+    toolCall.path = path28;
   }
 }
 var sessionCapture;
@@ -17341,9 +17574,9 @@ var init_usage_capture = __esm({
 });
 
 // packages/agent-spawn/src/acp/middlewares/spawn-log.ts
-import path14 from "node:path";
+import path15 from "node:path";
 import { homedir as homedir4 } from "node:os";
-import { mkdir, open as open2 } from "node:fs/promises";
+import { mkdir as mkdir2, open as open2 } from "node:fs/promises";
 function pad(value, width) {
   return String(value).padStart(width, "0");
 }
@@ -17375,14 +17608,17 @@ function resolveStartedAt(value) {
   return value;
 }
 function resolveLogFilePath(ctx) {
-  const baseDir = ctx.logDir ?? path14.join(homedir4(), ".poe-code", "spawn-logs");
+  if (ctx.logPath) {
+    return ctx.logPath;
+  }
+  const baseDir = ctx.logDir ?? path15.join(homedir4(), ".poe-code", "spawn-logs");
   if (ctx.logFileName) {
-    return path14.join(baseDir, ctx.logFileName);
+    return path15.join(baseDir, ctx.logFileName);
   }
   const startedAt = resolveStartedAt(ctx.startedAt);
   const { day, time, milliseconds } = formatTimestamp(startedAt);
   const fileName = `${day}-${time}-${milliseconds}-${normalizeAgent(ctx.agent)}.jsonl`;
-  return path14.join(baseDir, fileName);
+  return path15.join(baseDir, fileName);
 }
 async function writePreloadedEvents(writer, events) {
   for (const event of events) {
@@ -17400,7 +17636,7 @@ var init_spawn_log = __esm({
       logDirPath;
       constructor(ctx) {
         this.filePath = resolveLogFilePath(ctx);
-        this.logDirPath = path14.dirname(this.filePath);
+        this.logDirPath = path15.dirname(this.filePath);
       }
       async writeEvent(event) {
         if (this.isDisabled) {
@@ -17436,7 +17672,7 @@ var init_spawn_log = __esm({
           return;
         }
         try {
-          await mkdir(this.logDirPath, { recursive: true });
+          await mkdir2(this.logDirPath, { recursive: true });
           this.fileHandle = await open2(this.filePath, "a");
         } catch {
           this.isDisabled = true;
@@ -17551,9 +17787,9 @@ var init_poe_agent_plugin_scratchpad = __esm({
               edit: true
             },
             call(args) {
-              const { key, value } = args;
-              notes.set(key, value);
-              return `Wrote '${key}'`;
+              const { key: key2, value } = args;
+              notes.set(key2, value);
+              return `Wrote '${key2}'`;
             }
           },
           {
@@ -17713,9 +17949,11 @@ __export(src_exports, {
   collectProviders: () => collectProviders,
   compactionPlugin: () => poe_agent_plugin_compaction_default,
   createAgentSession: () => createAgentSession,
+  createTranscriptWriter: () => createTranscriptWriter,
   environmentPlugin: () => poe_agent_plugin_environment_default,
   filesPlugin: () => poe_agent_plugin_files_default,
   gitContextPlugin: () => poe_agent_plugin_git_context_default,
+  mapAcpEventToSessionUpdates: () => mapAcpEventToSessionUpdates,
   maxIterationsPlugin: () => poe_agent_plugin_max_iterations_default,
   mcpPlugin: () => mcpPlugin,
   memoryPlugin: () => poe_agent_plugin_memory_default,
@@ -17742,6 +17980,7 @@ var init_src7 = __esm({
     init_registry();
     init_resolve_plugins();
     init_resolve_provider();
+    init_transcript();
     init_poe_agent_plugin_audit_log();
     init_poe_agent_plugin_compaction();
     init_poe_agent_plugin_environment();
@@ -17764,7 +18003,7 @@ var init_src7 = __esm({
 });
 
 // src/providers/poe-agent.ts
-import fsPromises7 from "node:fs/promises";
+import fsPromises8 from "node:fs/promises";
 import os3 from "node:os";
 
 // src/cli/constants.ts
@@ -17821,7 +18060,7 @@ import path5 from "node:path";
 
 // packages/config-extends/src/discover.ts
 import path from "node:path";
-async function findBase(name, bases, fs3) {
+async function findBase(name, bases, fs4) {
   const checkedPaths = [];
   for (const basePath of bases) {
     for (const extension of [".md", ".yaml", ".yml", ".json"]) {
@@ -17829,7 +18068,7 @@ async function findBase(name, bases, fs3) {
       checkedPaths.push(filePath);
       try {
         return {
-          content: await fs3.readFile(filePath, "utf8"),
+          content: await fs4.readFile(filePath, "utf8"),
           filePath
         };
       } catch (error2) {
@@ -17909,15 +18148,15 @@ function stripBom(content) {
 function mergeLayers(layers) {
   return mergeObjectLayers(layers, []);
 }
-function mergeObjectLayers(layers, path26) {
+function mergeObjectLayers(layers, path28) {
   const data = {};
   const sources = {};
-  for (const key of collectKeys(layers)) {
-    const resolved = resolveKey(layers, key, path26);
+  for (const key2 of collectKeys(layers)) {
+    const resolved = resolveKey(layers, key2, path28);
     if (resolved === void 0) {
       continue;
     }
-    data[key] = resolved.value;
+    data[key2] = resolved.value;
     Object.assign(sources, resolved.sources);
   }
   return { data, sources };
@@ -17925,19 +18164,19 @@ function mergeObjectLayers(layers, path26) {
 function collectKeys(layers) {
   const keys = /* @__PURE__ */ new Set();
   for (const layer of layers) {
-    for (const key of Object.keys(layer.data)) {
-      keys.add(key);
+    for (const key2 of Object.keys(layer.data)) {
+      keys.add(key2);
     }
   }
   return [...keys];
 }
-function resolveKey(layers, key, path26) {
+function resolveKey(layers, key2, path28) {
   let winningSource;
   let winningValue;
   const objectLayers = [];
   for (const layer of layers) {
-    const candidate = layer.data[key];
-    if (!isWinningCandidate(key, candidate)) {
+    const candidate = layer.data[key2];
+    if (!isWinningCandidate(key2, candidate)) {
       continue;
     }
     if (winningSource === void 0) {
@@ -17961,9 +18200,9 @@ function resolveKey(layers, key, path26) {
   if (winningSource === void 0) {
     return void 0;
   }
-  const fullPath = buildPath(path26, key);
+  const fullPath = buildPath(path28, key2);
   if (isPlainObject(winningValue)) {
-    const merged = mergeObjectLayers(objectLayers, [...path26, key]);
+    const merged = mergeObjectLayers(objectLayers, [...path28, key2]);
     return {
       value: merged.data,
       sources: {
@@ -17979,17 +18218,17 @@ function resolveKey(layers, key, path26) {
     }
   };
 }
-function isWinningCandidate(key, value) {
+function isWinningCandidate(key2, value) {
   if (value === void 0) {
     return false;
   }
-  if (key === "prompt" && value === "") {
+  if (key2 === "prompt" && value === "") {
     return false;
   }
   return true;
 }
-function buildPath(path26, key) {
-  return [...path26, key].join(".");
+function buildPath(path28, key2) {
+  return [...path28, key2].join(".");
 }
 function isPlainObject(value) {
   if (value === null || Array.isArray(value) || typeof value !== "object") {
@@ -18006,8 +18245,8 @@ function cloneValue(value) {
     return value;
   }
   const clone = Object.create(Object.getPrototypeOf(value));
-  for (const [key, entry] of Object.entries(value)) {
-    clone[key] = cloneValue(entry);
+  for (const [key2, entry] of Object.entries(value)) {
+    clone[key2] = cloneValue(entry);
   }
   return clone;
 }
@@ -18356,29 +18595,29 @@ function serialize(obj) {
 }
 function merge(base, patch) {
   const result = { ...base };
-  for (const [key, value] of Object.entries(patch)) {
+  for (const [key2, value] of Object.entries(patch)) {
     if (value === void 0) {
       continue;
     }
-    const existing = result[key];
+    const existing = result[key2];
     if (isConfigObject(existing) && isConfigObject(value)) {
-      result[key] = merge(existing, value);
+      result[key2] = merge(existing, value);
       continue;
     }
-    result[key] = value;
+    result[key2] = value;
   }
   return result;
 }
 function prune(obj, shape) {
   let changed = false;
   const result = { ...obj };
-  for (const [key, pattern] of Object.entries(shape)) {
-    if (!(key in result)) {
+  for (const [key2, pattern] of Object.entries(shape)) {
+    if (!(key2 in result)) {
       continue;
     }
-    const current = result[key];
+    const current = result[key2];
     if (isConfigObject(pattern) && Object.keys(pattern).length === 0) {
-      delete result[key];
+      delete result[key2];
       changed = true;
       continue;
     }
@@ -18391,13 +18630,13 @@ function prune(obj, shape) {
         changed = true;
       }
       if (Object.keys(childResult).length === 0) {
-        delete result[key];
+        delete result[key2];
       } else {
-        result[key] = childResult;
+        result[key2] = childResult;
       }
       continue;
     }
-    delete result[key];
+    delete result[key2];
     changed = true;
   }
   return { changed, result };
@@ -18431,29 +18670,29 @@ function serialize2(obj) {
 }
 function merge2(base, patch) {
   const result = { ...base };
-  for (const [key, value] of Object.entries(patch)) {
+  for (const [key2, value] of Object.entries(patch)) {
     if (value === void 0) {
       continue;
     }
-    const existing = result[key];
+    const existing = result[key2];
     if (isConfigObject2(existing) && isConfigObject2(value)) {
-      result[key] = merge2(existing, value);
+      result[key2] = merge2(existing, value);
       continue;
     }
-    result[key] = value;
+    result[key2] = value;
   }
   return result;
 }
 function prune2(obj, shape) {
   let changed = false;
   const result = { ...obj };
-  for (const [key, pattern] of Object.entries(shape)) {
-    if (!(key in result)) {
+  for (const [key2, pattern] of Object.entries(shape)) {
+    if (!(key2 in result)) {
       continue;
     }
-    const current = result[key];
+    const current = result[key2];
     if (isConfigObject2(pattern) && Object.keys(pattern).length === 0) {
-      delete result[key];
+      delete result[key2];
       changed = true;
       continue;
     }
@@ -18466,13 +18705,13 @@ function prune2(obj, shape) {
         changed = true;
       }
       if (Object.keys(childResult).length === 0) {
-        delete result[key];
+        delete result[key2];
       } else {
-        result[key] = childResult;
+        result[key2] = childResult;
       }
       continue;
     }
-    delete result[key];
+    delete result[key2];
     changed = true;
   }
   return { changed, result };
@@ -18509,29 +18748,29 @@ function serialize3(obj) {
 }
 function merge3(base, patch) {
   const result = { ...base };
-  for (const [key, value] of Object.entries(patch)) {
+  for (const [key2, value] of Object.entries(patch)) {
     if (value === void 0) {
       continue;
     }
-    const existing = result[key];
+    const existing = result[key2];
     if (isConfigObject3(existing) && isConfigObject3(value)) {
-      result[key] = merge3(existing, value);
+      result[key2] = merge3(existing, value);
       continue;
     }
-    result[key] = value;
+    result[key2] = value;
   }
   return result;
 }
 function prune3(obj, shape) {
   let changed = false;
   const result = { ...obj };
-  for (const [key, pattern] of Object.entries(shape)) {
-    if (!(key in result)) {
+  for (const [key2, pattern] of Object.entries(shape)) {
+    if (!(key2 in result)) {
       continue;
     }
-    const current = result[key];
+    const current = result[key2];
     if (isConfigObject3(pattern) && Object.keys(pattern).length === 0) {
-      delete result[key];
+      delete result[key2];
       changed = true;
       continue;
     }
@@ -18541,13 +18780,13 @@ function prune3(obj, shape) {
         changed = true;
       }
       if (Object.keys(childResult).length === 0) {
-        delete result[key];
+        delete result[key2];
       } else {
-        result[key] = childResult;
+        result[key2] = childResult;
       }
       continue;
     }
-    delete result[key];
+    delete result[key2];
     changed = true;
   }
   return { changed, result };
@@ -18584,16 +18823,16 @@ function getConfigFormat(pathOrFormat) {
   }
   return formatRegistry[formatName];
 }
-function detectFormat2(path26) {
-  const ext = getExtension(path26);
+function detectFormat2(path28) {
+  const ext = getExtension(path28);
   return extensionMap[ext];
 }
-function getExtension(path26) {
-  const lastDot = path26.lastIndexOf(".");
+function getExtension(path28) {
+  const lastDot = path28.lastIndexOf(".");
   if (lastDot === -1) {
     return "";
   }
-  return path26.slice(lastDot).toLowerCase();
+  return path28.slice(lastDot).toLowerCase();
 }
 
 // packages/config-mutations/src/execution/path-utils.ts
@@ -18644,9 +18883,9 @@ function resolvePath(rawPath, homeDir, pathMapper) {
 function isNotFound(error2) {
   return typeof error2 === "object" && error2 !== null && "code" in error2 && error2.code === "ENOENT";
 }
-async function readFileIfExists(fs3, target) {
+async function readFileIfExists(fs4, target) {
   try {
-    return await fs3.readFile(target, "utf8");
+    return await fs4.readFile(target, "utf8");
   } catch (error2) {
     if (isNotFound(error2)) {
       return null;
@@ -18654,9 +18893,9 @@ async function readFileIfExists(fs3, target) {
     throw error2;
   }
 }
-async function pathExists(fs3, target) {
+async function pathExists(fs4, target) {
   try {
-    await fs3.stat(target);
+    await fs4.stat(target);
     return true;
   } catch (error2) {
     if (isNotFound(error2)) {
@@ -18680,9 +18919,9 @@ function createInvalidDocumentBackupPath(targetPath) {
   const ext = targetPath.includes(".") ? targetPath.split(".").pop() : "bak";
   return `${targetPath}.invalid-${createTimestamp()}.${ext}`;
 }
-async function backupInvalidDocument(fs3, targetPath, content) {
+async function backupInvalidDocument(fs4, targetPath, content) {
   const backupPath = createInvalidDocumentBackupPath(targetPath);
-  await fs3.writeFile(backupPath, content, { encoding: "utf8" });
+  await fs4.writeFile(backupPath, content, { encoding: "utf8" });
 }
 function describeMutation(kind, targetPath) {
   const displayPath2 = targetPath ?? "target";
@@ -18711,9 +18950,9 @@ function describeMutation(kind, targetPath) {
 }
 function pruneKeysByPrefix(table, prefix) {
   const result = {};
-  for (const [key, value] of Object.entries(table)) {
-    if (!key.startsWith(prefix)) {
-      result[key] = value;
+  for (const [key2, value] of Object.entries(table)) {
+    if (!key2.startsWith(prefix)) {
+      result[key2] = value;
     }
   }
   return result;
@@ -18724,15 +18963,15 @@ function isConfigObject4(value) {
 function mergeWithPruneByPrefix(base, patch, pruneByPrefix) {
   const result = { ...base };
   const prefixMap = pruneByPrefix ?? {};
-  for (const [key, value] of Object.entries(patch)) {
-    const current = result[key];
-    const prefix = prefixMap[key];
+  for (const [key2, value] of Object.entries(patch)) {
+    const current = result[key2];
+    const prefix = prefixMap[key2];
     if (isConfigObject4(current) && isConfigObject4(value)) {
       if (prefix) {
         const pruned = pruneKeysByPrefix(current, prefix);
-        result[key] = { ...pruned, ...value };
+        result[key2] = { ...pruned, ...value };
       } else {
-        result[key] = mergeWithPruneByPrefix(
+        result[key2] = mergeWithPruneByPrefix(
           current,
           value,
           prefixMap
@@ -18740,7 +18979,7 @@ function mergeWithPruneByPrefix(base, patch, pruneByPrefix) {
       }
       continue;
     }
-    result[key] = value;
+    result[key2] = value;
   }
   return result;
 }
@@ -18895,8 +19134,8 @@ async function applyChmod(mutation, context, options) {
     };
   }
   try {
-    const stat6 = await context.fs.stat(targetPath);
-    const currentMode = typeof stat6.mode === "number" ? stat6.mode & 511 : null;
+    const stat7 = await context.fs.stat(targetPath);
+    const currentMode = typeof stat7.mode === "number" ? stat7.mode & 511 : null;
     if (currentMode === mutation.mode) {
       return {
         outcome: { changed: false, effect: "none", detail: "noop" },
@@ -19244,26 +19483,26 @@ import Mustache2 from "mustache";
 var originalEscape = Mustache2.escape;
 
 // packages/poe-code-config/src/store.ts
-async function readDocument(fs3, filePath) {
-  const document = await readStoredDocument(fs3, filePath);
+async function readDocument(fs4, filePath) {
+  const document = await readStoredDocument(fs4, filePath);
   return document.data;
 }
-async function writeScope(fs3, filePath, scope, values) {
-  const document = await readDocument(fs3, filePath);
+async function writeScope(fs4, filePath, scope, values) {
+  const document = await readDocument(fs4, filePath);
   const normalizedValues = normalizeScopeValues(values);
   if (Object.keys(normalizedValues).length === 0) {
     delete document[scope];
   } else {
     document[scope] = normalizedValues;
   }
-  await writeDocument(fs3, filePath, document);
+  await writeDocument(fs4, filePath, document);
 }
-async function readMergedDocument(fs3, globalPath, projectPath) {
-  const globalDocument = await readStoredDocument(fs3, globalPath);
+async function readMergedDocument(fs4, globalPath, projectPath) {
+  const globalDocument = await readStoredDocument(fs4, globalPath);
   if (!projectPath) {
     return globalDocument.data;
   }
-  const projectDocument = await readStoredDocument(fs3, projectPath);
+  const projectDocument = await readStoredDocument(fs4, projectPath);
   const resolved = await resolve(
     [
       {
@@ -19277,16 +19516,16 @@ async function readMergedDocument(fs3, globalPath, projectPath) {
       }
     ],
     {
-      fs: createResolvedConfigFs(fs3, globalPath, globalDocument.content),
+      fs: createResolvedConfigFs(fs4, globalPath, globalDocument.content),
       autoExtend: true
     }
   );
   return normalizeDocument(resolved.data);
 }
-async function readStoredDocument(fs3, filePath) {
+async function readStoredDocument(fs4, filePath) {
   try {
-    const raw = await fs3.readFile(filePath, "utf8");
-    return await parseStoredDocument(fs3, filePath, raw);
+    const raw = await fs4.readFile(filePath, "utf8");
+    return await parseStoredDocument(fs4, filePath, raw);
   } catch (error2) {
     if (isNotFound(error2)) {
       return {
@@ -19297,7 +19536,7 @@ async function readStoredDocument(fs3, filePath) {
     throw error2;
   }
 }
-async function parseStoredDocument(fs3, filePath, raw) {
+async function parseStoredDocument(fs4, filePath, raw) {
   try {
     return {
       content: raw,
@@ -19305,7 +19544,7 @@ async function parseStoredDocument(fs3, filePath, raw) {
     };
   } catch (error2) {
     if (error2 instanceof SyntaxError) {
-      await recoverInvalidDocument(fs3, filePath, raw);
+      await recoverInvalidDocument(fs4, filePath, raw);
       return {
         content: EMPTY_DOCUMENT,
         data: {}
@@ -19332,35 +19571,35 @@ function normalizeScopeValues(value) {
     return {};
   }
   const normalized = {};
-  for (const [key, entry] of Object.entries(value)) {
+  for (const [key2, entry] of Object.entries(value)) {
     if (entry !== void 0) {
-      normalized[key] = entry;
+      normalized[key2] = entry;
     }
   }
   return normalized;
 }
-function createResolvedConfigFs(fs3, globalPath, globalContent) {
+function createResolvedConfigFs(fs4, globalPath, globalContent) {
   return {
     readFile(filePath, _encoding) {
       if (filePath === globalPath) {
         return Promise.resolve(globalContent);
       }
-      return fs3.readFile(filePath, "utf8");
+      return fs4.readFile(filePath, "utf8");
     }
   };
 }
-async function writeDocument(fs3, filePath, document) {
-  await fs3.mkdir(path5.dirname(filePath), { recursive: true });
-  await fs3.writeFile(filePath, `${JSON.stringify(document, null, 2)}
+async function writeDocument(fs4, filePath, document) {
+  await fs4.mkdir(path5.dirname(filePath), { recursive: true });
+  await fs4.writeFile(filePath, `${JSON.stringify(document, null, 2)}
 `, {
     encoding: "utf8"
   });
 }
-async function recoverInvalidDocument(fs3, filePath, content) {
-  await fs3.mkdir(path5.dirname(filePath), { recursive: true });
+async function recoverInvalidDocument(fs4, filePath, content) {
+  await fs4.mkdir(path5.dirname(filePath), { recursive: true });
   const backupPath = createInvalidBackupPath(filePath);
-  await fs3.writeFile(backupPath, content, { encoding: "utf8" });
-  await fs3.writeFile(filePath, EMPTY_DOCUMENT, { encoding: "utf8" });
+  await fs4.writeFile(backupPath, content, { encoding: "utf8" });
+  await fs4.writeFile(filePath, EMPTY_DOCUMENT, { encoding: "utf8" });
 }
 function createInvalidBackupPath(filePath) {
   const directory = path5.dirname(filePath);
@@ -19382,15 +19621,15 @@ var EMPTY_DOCUMENT = `${JSON.stringify({}, null, 2)}
 // packages/poe-code-config/src/resolve.ts
 function resolveScope(schema, fileValues, env = {}) {
   const resolved = {};
-  for (const key of Object.keys(schema)) {
-    const field = schema[key];
-    const envValue = resolveEnvValue(field, env, key);
-    const fileValue = resolveFileValue(field, fileValues?.[key], key);
-    resolved[key] = envValue ?? fileValue ?? field.default;
+  for (const key2 of Object.keys(schema)) {
+    const field = schema[key2];
+    const envValue = resolveEnvValue(field, env, key2);
+    const fileValue = resolveFileValue(field, fileValues?.[key2], key2);
+    resolved[key2] = envValue ?? fileValue ?? field.default;
   }
   return resolved;
 }
-function resolveEnvValue(field, env, key) {
+function resolveEnvValue(field, env, key2) {
   if (!field.env) {
     return void 0;
   }
@@ -19398,12 +19637,12 @@ function resolveEnvValue(field, env, key) {
   if (raw === void 0) {
     return void 0;
   }
-  return coerceValue(field, raw, key);
+  return coerceValue(field, raw, key2);
 }
-function resolveFileValue(field, value, key) {
-  return coerceValue(field, value, key);
+function resolveFileValue(field, value, key2) {
+  return coerceValue(field, value, key2);
 }
-function coerceValue(field, value, key) {
+function coerceValue(field, value, key2) {
   switch (field.type) {
     case "string":
       return typeof value === "string" ? value : void 0;
@@ -19412,7 +19651,7 @@ function coerceValue(field, value, key) {
     case "boolean":
       return coerceBoolean(value);
     case "json":
-      return coerceJson(field, value, key);
+      return coerceJson(field, value, key2);
   }
 }
 function coerceNumber(value) {
@@ -19437,26 +19676,26 @@ function coerceBoolean(value) {
   }
   return void 0;
 }
-function coerceJson(field, value, key) {
+function coerceJson(field, value, key2) {
   if (value === void 0) {
     return void 0;
   }
-  const parsedValue = parseJsonValue(value, key);
+  const parsedValue = parseJsonValue(value, key2);
   try {
     return field.parse(parsedValue);
   } catch (error2) {
     const message2 = error2 instanceof Error ? error2.message : "Invalid JSON value.";
-    throw new Error(`Invalid config value for "${key}": ${message2}`);
+    throw new Error(`Invalid config value for "${key2}": ${message2}`);
   }
 }
-function parseJsonValue(value, key) {
+function parseJsonValue(value, key2) {
   if (typeof value !== "string") {
     return value;
   }
   try {
     return JSON.parse(value);
   } catch {
-    throw new Error(`Invalid config value for "${key}": expected valid JSON.`);
+    throw new Error(`Invalid config value for "${key2}": expected valid JSON.`);
   }
 }
 
@@ -19466,19 +19705,19 @@ function createConfigStore(options) {
   return {
     scope(definition) {
       return {
-        async get(key) {
+        async get(key2) {
           const resolved = await resolveScopedValues(options, definition, env);
-          return resolved[key];
+          return resolved[key2];
         },
         async getAll() {
           return resolveScopedValues(options, definition, env);
         },
-        async set(key, value) {
+        async set(key2, value) {
           const document = await readDocument(options.fs, options.filePath);
           const currentValues = document[definition.scope] ?? {};
           await writeScope(options.fs, options.filePath, definition.scope, {
             ...currentValues,
-            [key]: value
+            [key2]: value
           });
         }
       };
@@ -19649,16 +19888,16 @@ function createInstallRunner(definition) {
 }
 
 // src/services/config.ts
-import path25 from "node:path";
+import path27 from "node:path";
 init_src7();
 
 // packages/superintendent/src/document/parse.ts
-import path15 from "node:path";
+import path16 from "node:path";
 import { parseDocument as parseDocument2 } from "yaml";
 var superintendentDocumentSchemaId = "https://poe-platform.github.io/poe-code/schemas/plans/superintendent.schema.json";
 var validStatusStates = /* @__PURE__ */ new Set(["in_progress", "review", "completed"]);
 function parseSuperintendentDoc(filePath, content) {
-  const resolvedFilePath = path15.resolve(filePath);
+  const resolvedFilePath = path16.resolve(filePath);
   const { frontmatterText, body } = splitFrontmatter(resolvedFilePath, content);
   const parsedFrontmatter = parseYamlFrontmatter(resolvedFilePath, frontmatterText);
   return {
@@ -19848,7 +20087,7 @@ function isRecord3(value) {
 }
 
 // packages/superintendent/src/document/write.ts
-import path16 from "node:path";
+import path17 from "node:path";
 import { isMap, parseDocument as parseDocument3 } from "yaml";
 function updateStatus(filePath, content, status) {
   return updateFrontmatter(filePath, content, (frontmatterDocument) => {
@@ -19869,7 +20108,7 @@ function setStatusReason(filePath, content, reason) {
   });
 }
 function updateFrontmatter(filePath, content, mutate) {
-  const resolvedFilePath = path16.resolve(filePath);
+  const resolvedFilePath = path17.resolve(filePath);
   const parts = splitDocument(resolvedFilePath, content);
   const frontmatterDocument = parseDocument3(parts.frontmatterText);
   if (frontmatterDocument.errors.length > 0) {
@@ -19896,8 +20135,8 @@ function getTopLevelMap(frontmatterDocument) {
 }
 function reorderTopLevelKeys(map, keys) {
   const remaining = [...map.items];
-  const ordered = keys.flatMap((key) => {
-    const index = remaining.findIndex((item) => item.key?.toString() === key);
+  const ordered = keys.flatMap((key2) => {
+    const index = remaining.findIndex((item) => item.key?.toString() === key2);
     return index === -1 ? [] : remaining.splice(index, 1);
   });
   map.items = [...ordered, ...remaining];
@@ -20094,27 +20333,55 @@ function extractText(node) {
 }
 
 // packages/superintendent/src/runtime/loop.ts
-import * as fsPromises5 from "node:fs/promises";
+import path21 from "node:path";
+import * as fsPromises6 from "node:fs/promises";
 
 // packages/agent-kit/src/paths.ts
-import path17 from "node:path";
+import path18 from "node:path";
 function resolveWorkflowPath(inputPath, cwd, homeDir) {
   if (inputPath.startsWith("~/")) {
-    return path17.join(homeDir, inputPath.slice(2));
+    return path18.join(homeDir, inputPath.slice(2));
   }
   if (inputPath === "~") {
     return homeDir;
   }
-  return path17.isAbsolute(inputPath) ? inputPath : path17.resolve(cwd, inputPath);
+  return path18.isAbsolute(inputPath) ? inputPath : path18.resolve(cwd, inputPath);
 }
 
 // packages/agent-kit/src/participant.ts
 init_src4();
 
 // packages/agent-kit/src/lock.ts
-import * as fsPromises4 from "node:fs/promises";
-function sleep(ms) {
-  return new Promise((resolve2) => setTimeout(resolve2, ms));
+import * as fsPromises5 from "node:fs/promises";
+function createAbortError3() {
+  const error2 = new Error("The operation was aborted.");
+  error2.name = "AbortError";
+  return error2;
+}
+function throwIfAborted(signal) {
+  if (signal?.aborted) {
+    throw createAbortError3();
+  }
+}
+function sleep(ms, signal) {
+  if (!signal) {
+    return new Promise((resolve2) => setTimeout(resolve2, ms));
+  }
+  if (signal.aborted) {
+    return Promise.reject(createAbortError3());
+  }
+  return new Promise((resolve2, reject) => {
+    const timeoutId = setTimeout(() => {
+      signal.removeEventListener("abort", onAbort);
+      resolve2();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(timeoutId);
+      signal.removeEventListener("abort", onAbort);
+      reject(createAbortError3());
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+  });
 }
 function backoff(attempt, minTimeout, maxTimeout) {
   const delay = Math.min(maxTimeout, minTimeout * Math.pow(2, attempt));
@@ -20125,23 +20392,23 @@ function hasErrorCode(error2, code) {
 }
 function createDefaultFs() {
   return {
-    mkdir: async (path26, options) => {
-      await fsPromises4.mkdir(path26, options);
+    mkdir: async (path28, options) => {
+      await fsPromises5.mkdir(path28, options);
     },
-    rmdir: fsPromises4.rmdir,
-    stat: async (path26) => {
-      const stat6 = await fsPromises4.stat(path26);
+    rmdir: fsPromises5.rmdir,
+    stat: async (path28) => {
+      const stat7 = await fsPromises5.stat(path28);
       return {
-        isFile: () => stat6.isFile(),
-        isDirectory: () => stat6.isDirectory(),
-        mtimeMs: stat6.mtimeMs
+        isFile: () => stat7.isFile(),
+        isDirectory: () => stat7.isDirectory(),
+        mtimeMs: stat7.mtimeMs
       };
     }
   };
 }
-async function removeLockDirectory(fs3, lockPath) {
+async function removeLockDirectory(fs4, lockPath) {
   try {
-    await fs3.rmdir(lockPath);
+    await fs4.rmdir(lockPath);
   } catch (error2) {
     if (!hasErrorCode(error2, "ENOENT")) {
       throw error2;
@@ -20149,42 +20416,43 @@ async function removeLockDirectory(fs3, lockPath) {
   }
 }
 async function lockWorkflow(docPath, options = {}) {
-  const fs3 = options.fs ?? createDefaultFs();
+  const fs4 = options.fs ?? createDefaultFs();
   const retries = options.retries ?? 20;
   const minTimeout = options.minTimeout ?? 25;
   const maxTimeout = options.maxTimeout ?? 250;
   const staleMs = options.staleMs ?? 3e4;
   const lockPath = `${docPath}.lock`;
   for (let attempt = 0; attempt <= retries; attempt += 1) {
+    throwIfAborted(options.signal);
     try {
-      await fs3.mkdir(lockPath);
+      await fs4.mkdir(lockPath);
       let released = false;
       return async () => {
         if (released) {
           return;
         }
         released = true;
-        await removeLockDirectory(fs3, lockPath);
+        await removeLockDirectory(fs4, lockPath);
       };
     } catch (error2) {
       if (!hasErrorCode(error2, "EEXIST")) {
         throw error2;
       }
-      let stat6;
+      let stat7;
       try {
-        stat6 = await fs3.stat(lockPath);
+        stat7 = await fs4.stat(lockPath);
       } catch (statError) {
         if (hasErrorCode(statError, "ENOENT")) {
           continue;
         }
         throw statError;
       }
-      if (Date.now() - stat6.mtimeMs > staleMs) {
-        await removeLockDirectory(fs3, lockPath);
+      if (Date.now() - stat7.mtimeMs > staleMs) {
+        await removeLockDirectory(fs4, lockPath);
         continue;
       }
       if (attempt < retries) {
-        await sleep(backoff(attempt, minTimeout, maxTimeout));
+        await sleep(backoff(attempt, minTimeout, maxTimeout), options.signal);
       }
     }
   }
@@ -20192,13 +20460,13 @@ async function lockWorkflow(docPath, options = {}) {
 }
 
 // packages/agent-kit/src/run-logs.ts
-import path18 from "node:path";
+import path19 from "node:path";
 function resolveRunLogDir(options) {
   const slug = slugifyPlanPath(options.planPath);
-  return path18.join(options.homeDir, ".poe-code", "logs", options.runner, slug);
+  return path19.join(options.homeDir, ".poe-code", "logs", options.runner, slug);
 }
 function slugifyPlanPath(planPath) {
-  const base = path18.basename(planPath);
+  const base = path19.basename(planPath);
   const dot = base.lastIndexOf(".");
   const stem = dot > 0 ? base.slice(0, dot) : base;
   return slugifyLabel(stem);
@@ -20249,6 +20517,15 @@ function pad2(value, width) {
   return String(value).padStart(width, "0");
 }
 
+// packages/agent-kit/src/skill-config.ts
+function skillPlanConfigSection(subcommand) {
+  return `## Plan Directory
+
+Run \`poe-code ${subcommand} plan-path\` to get the resolved plan directory path.
+
+Write the plan file to \`<plan-directory>/<name>.md\`.`;
+}
+
 // packages/superintendent/src/runtime/loop.ts
 init_src6();
 
@@ -20269,15 +20546,15 @@ function createLoopState(doc) {
 init_src6();
 
 // packages/superintendent/src/runtime/resolve-cwd.ts
-import path19 from "node:path";
+import path20 from "node:path";
 function resolveRoleCwd(role, docPath, defaultCwd) {
   if (role.cwd === void 0) {
     return defaultCwd;
   }
-  if (path19.isAbsolute(role.cwd)) {
+  if (path20.isAbsolute(role.cwd)) {
     return role.cwd;
   }
-  return path19.resolve(path19.dirname(docPath), role.cwd);
+  return path20.resolve(path20.dirname(docPath), role.cwd);
 }
 
 // packages/superintendent/src/runtime/templates.ts
@@ -20312,8 +20589,7 @@ async function runBuilder(doc, context, options) {
     prompt,
     cwd: resolveRoleCwd(doc.frontmatter.builder, doc.filePath, options.defaultCwd),
     mcpServers: buildMcpServers(doc),
-    ...options.logDir ? { logDir: options.logDir } : {},
-    ...options.logFileName ? { logFileName: options.logFileName } : {}
+    ...options.logPath ? { logPath: options.logPath } : {}
   });
   const log2 = extractLog(result);
   return {
@@ -20357,8 +20633,7 @@ async function runAutonomous(input) {
       prompt: input.prompt,
       mode: input.mode,
       ...input.mcpServers ? { mcpServers: input.mcpServers } : {},
-      ...input.logDir ? { logDir: input.logDir } : {},
-      ...input.logFileName ? { logFileName: input.logFileName } : {}
+      ...input.logPath ? { logPath: input.logPath } : {}
     });
   }
   const result = await spawn5(input.agent, {
@@ -20366,8 +20641,7 @@ async function runAutonomous(input) {
     prompt: input.prompt,
     mode: input.mode,
     ...input.mcpServers ? { mcpServers: input.mcpServers } : {},
-    ...input.logDir ? { logDir: input.logDir } : {},
-    ...input.logFileName ? { logFileName: input.logFileName } : {}
+    ...input.logPath ? { logPath: input.logPath } : {}
   });
   return {
     stdout: result.stdout,
@@ -20387,10 +20661,7 @@ function extractLogPath(result, options) {
       return logFile;
     }
   }
-  if (options.logDir && options.logFileName) {
-    return `${options.logDir}/${options.logFileName}`;
-  }
-  return "";
+  return options.logPath ?? "";
 }
 function extractSummary(result, log2) {
   if (typeof result !== "string") {
@@ -20496,8 +20767,7 @@ async function runInspector(name, config, doc, context, options) {
     prompt,
     cwd: resolveRoleCwd(config, doc.filePath, options.defaultCwd),
     mcpServers: buildMcpServers2(doc, config),
-    ...options.logDir ? { logDir: options.logDir } : {},
-    ...options.logFileName ? { logFileName: options.logFileName } : {}
+    ...options.logPath ? { logPath: options.logPath } : {}
   });
   const logPath = extractLogPath2(output);
   return {
@@ -20564,8 +20834,7 @@ async function runAutonomous2(input) {
       prompt: input.prompt,
       mode: input.mode,
       ...input.mcpServers ? { mcpServers: input.mcpServers } : {},
-      ...input.logDir ? { logDir: input.logDir } : {},
-      ...input.logFileName ? { logFileName: input.logFileName } : {}
+      ...input.logPath ? { logPath: input.logPath } : {}
     });
   }
   const result = await spawn5(input.agent, {
@@ -20573,8 +20842,7 @@ async function runAutonomous2(input) {
     prompt: input.prompt,
     mode: input.mode,
     ...input.mcpServers ? { mcpServers: input.mcpServers } : {},
-    ...input.logDir ? { logDir: input.logDir } : {},
-    ...input.logFileName ? { logFileName: input.logFileName } : {}
+    ...input.logPath ? { logPath: input.logPath } : {}
   });
   return {
     stdout: result.stdout,
@@ -20706,8 +20974,7 @@ async function runOwnerReview(doc, context, options) {
     prompt,
     cwd: resolveRoleCwd(doc.frontmatter.owner, doc.filePath, options.defaultCwd),
     mcpServers: buildMcpServers3(doc),
-    ...options.logDir ? { logDir: options.logDir } : {},
-    ...options.logFileName ? { logFileName: options.logFileName } : {}
+    ...options.logPath ? { logPath: options.logPath } : {}
   });
   const logPath = extractLogPath3(result);
   return {
@@ -20754,8 +21021,7 @@ async function runAutonomous3(input) {
       prompt: input.prompt,
       mode: input.mode,
       ...input.mcpServers ? { mcpServers: input.mcpServers } : {},
-      ...input.logDir ? { logDir: input.logDir } : {},
-      ...input.logFileName ? { logFileName: input.logFileName } : {}
+      ...input.logPath ? { logPath: input.logPath } : {}
     });
   }
   const result = await spawn5(input.agent, {
@@ -20763,8 +21029,7 @@ async function runAutonomous3(input) {
     prompt: input.prompt,
     mode: input.mode,
     ...input.mcpServers ? { mcpServers: input.mcpServers } : {},
-    ...input.logDir ? { logDir: input.logDir } : {},
-    ...input.logFileName ? { logFileName: input.logFileName } : {}
+    ...input.logPath ? { logPath: input.logPath } : {}
   });
   return {
     stdout: result.stdout,
@@ -20915,8 +21180,7 @@ async function runSuperintendent(doc, context, options) {
     prompt,
     cwd: resolveRoleCwd(doc.frontmatter.superintendent, doc.filePath, options.defaultCwd),
     mcpServers: buildMcpServers4(doc),
-    ...options.logDir ? { logDir: options.logDir } : {},
-    ...options.logFileName ? { logFileName: options.logFileName } : {}
+    ...options.logPath ? { logPath: options.logPath } : {}
   });
   const transition = extractTransition2(result);
   const logPath = extractLogPath4(result);
@@ -20975,8 +21239,7 @@ async function runAutonomous4(input) {
       prompt: input.prompt,
       mode: input.mode,
       ...input.mcpServers ? { mcpServers: input.mcpServers } : {},
-      ...input.logDir ? { logDir: input.logDir } : {},
-      ...input.logFileName ? { logFileName: input.logFileName } : {}
+      ...input.logPath ? { logPath: input.logPath } : {}
     });
   }
   const result = await spawn5(input.agent, {
@@ -20984,8 +21247,7 @@ async function runAutonomous4(input) {
     prompt: input.prompt,
     mode: input.mode,
     ...input.mcpServers ? { mcpServers: input.mcpServers } : {},
-    ...input.logDir ? { logDir: input.logDir } : {},
-    ...input.logFileName ? { logFileName: input.logFileName } : {}
+    ...input.logPath ? { logPath: input.logPath } : {}
   });
   return {
     stdout: result.stdout,
@@ -21314,46 +21576,46 @@ function normalizeOptions(input, callbacks) {
 }
 function createDefaultFs2() {
   return {
-    readFile: fsPromises5.readFile,
-    writeFile: fsPromises5.writeFile,
-    readdir: fsPromises5.readdir,
+    readFile: fsPromises6.readFile,
+    writeFile: fsPromises6.writeFile,
+    readdir: fsPromises6.readdir,
     stat: async (filePath) => {
-      const stat6 = await fsPromises5.stat(filePath);
+      const stat7 = await fsPromises6.stat(filePath);
       return {
-        isFile: () => stat6.isFile(),
-        isDirectory: () => stat6.isDirectory(),
-        mtimeMs: stat6.mtimeMs
+        isFile: () => stat7.isFile(),
+        isDirectory: () => stat7.isDirectory(),
+        mtimeMs: stat7.mtimeMs
       };
     },
     mkdir: async (filePath, options) => {
-      await fsPromises5.mkdir(filePath, options);
+      await fsPromises6.mkdir(filePath, options);
     },
     rmdir: async (filePath) => {
-      await fsPromises5.rmdir(filePath);
+      await fsPromises6.rmdir(filePath);
     },
     rename: async (oldPath, newPath) => {
-      await fsPromises5.rename(oldPath, newPath);
+      await fsPromises6.rename(oldPath, newPath);
     }
   };
 }
-async function readDocument2(fs3, docPath) {
-  const content = await readDocumentContent(fs3, docPath);
+async function readDocument2(fs4, docPath) {
+  const content = await readDocumentContent(fs4, docPath);
   return parseSuperintendentDoc(docPath, content);
 }
-async function readDocumentContent(fs3, docPath) {
-  return fs3.readFile(docPath, "utf8");
+async function readDocumentContent(fs4, docPath) {
+  return fs4.readFile(docPath, "utf8");
 }
-async function writeLoopState(fs3, docPath, state) {
-  const content = await fs3.readFile(docPath, "utf8");
+async function writeLoopState(fs4, docPath, state) {
+  const content = await fs4.readFile(docPath, "utf8");
   const updatedContent = updateStatus(docPath, content, {
     state: state.state,
     round: state.round,
     review_turn: state.reviewTurn
   });
-  await fs3.writeFile(docPath, updatedContent, { encoding: "utf8" });
+  await fs4.writeFile(docPath, updatedContent, { encoding: "utf8" });
 }
-async function restoreDocument(fs3, docPath, content) {
-  await fs3.writeFile(docPath, content, { encoding: "utf8" });
+async function restoreDocument(fs4, docPath, content) {
+  await fs4.writeFile(docPath, content, { encoding: "utf8" });
 }
 async function rollbackRoundStatus(options, state) {
   await writeLoopState(options.fs, options.docPath, state);
@@ -21420,14 +21682,10 @@ async function executeSuperintendent(options, context) {
   }
 }
 function buildRoleOptions(options, role) {
-  const base = {
-    defaultCwd: options.cwd
+  return {
+    defaultCwd: options.cwd,
+    ...options.logDir ? { logPath: path21.join(options.logDir, makeRunLogFileName(role)) } : {}
   };
-  if (options.logDir) {
-    base.logDir = options.logDir;
-    base.logFileName = makeRunLogFileName(role);
-  }
-  return base;
 }
 function shouldContinueReview(doc) {
   return parseTaskBoard(doc.body).allDone;
@@ -21502,8 +21760,7 @@ async function withInjectedAgentRunner(options, operation) {
       cwd: input.cwd ?? process.cwd(),
       ...input.mode ? { mode: input.mode } : {},
       ...input.mcpServers ? { mcpServers: input.mcpServers } : {},
-      ...input.logDir ? { logDir: input.logDir } : {},
-      ...input.logFileName ? { logFileName: input.logFileName } : {},
+      ...input.logPath ? { logPath: input.logPath } : {},
       ...options.signal ? { signal: options.signal } : {}
     });
     if (!result) {
@@ -21610,7 +21867,7 @@ function cloneSecrets(secrets) {
     return {};
   }
   return Object.fromEntries(
-    Object.entries(secrets).map(([key, secret]) => [key, cloneSecretDefinition(secret)])
+    Object.entries(secrets).map(([key2, secret]) => [key2, cloneSecretDefinition(secret)])
   );
 }
 function cloneRequires(requires) {
@@ -21875,8 +22132,8 @@ var builderRunCommand = defineCommand({
   positional: ["path"],
   params: builderRunParams,
   scope: ["cli", "mcp", "sdk"],
-  handler: async ({ params, fs: fs3 }) => {
-    const content = await readDocument3(params.path, fs3);
+  handler: async ({ params, fs: fs4 }) => {
+    const content = await readDocument3(params.path, fs4);
     const document = parseSuperintendentDoc(params.path, content);
     return runBuilder(document, {}, { defaultCwd: process.cwd() });
   },
@@ -21898,9 +22155,9 @@ var builderGroup = defineGroup({
   scope: ["cli", "mcp", "sdk"],
   children: [builderRunCommand]
 });
-async function readDocument3(filePath, fs3) {
+async function readDocument3(filePath, fs4) {
   try {
-    return await fs3.readFile(filePath, "utf8");
+    return await fs4.readFile(filePath, "utf8");
   } catch (error2) {
     if (hasCode2(error2, "ENOENT")) {
       throw new UserError(`Superintendent document not found: ${filePath}`);
@@ -21929,14 +22186,14 @@ function hasCode2(error2, code) {
 }
 
 // packages/superintendent/src/commands/install.ts
-import path22 from "node:path";
-import { readFile as readFile4, stat as stat4, mkdir as mkdir4, writeFile as writeFile2, unlink, readdir as readdir3, chmod as chmod2 } from "node:fs/promises";
+import path24 from "node:path";
+import { readFile as readFile4, stat as stat4, mkdir as mkdir5, writeFile as writeFile2, unlink, readdir as readdir3, chmod as chmod2 } from "node:fs/promises";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 
 // packages/agent-skill-config/src/configs.ts
 init_src4();
 import os2 from "node:os";
-import path20 from "node:path";
+import path22 from "node:path";
 var agentSkillConfigs = {
   "claude-code": {
     globalSkillDir: "~/.claude/skills",
@@ -21970,7 +22227,7 @@ function resolveAgentSupport(input, registry = agentSkillConfigs) {
 
 // packages/agent-skill-config/src/templates.ts
 import { readFile as readFile3, stat as stat3 } from "node:fs/promises";
-import path21 from "node:path";
+import path23 from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // packages/agent-skill-config/src/apply.ts
@@ -22031,7 +22288,7 @@ async function installSkill(agentId, skill, options) {
 var fs2 = {
   readFile: (p, encoding) => readFile4(p, encoding),
   writeFile: (p, content) => writeFile2(p, content),
-  mkdir: (p, options) => mkdir4(p, options).then(() => void 0),
+  mkdir: (p, options) => mkdir5(p, options).then(() => void 0),
   unlink: (p) => unlink(p),
   stat: (p) => stat4(p).then((s) => ({ mode: s.mode })),
   readdir: (p) => readdir3(p),
@@ -22066,7 +22323,7 @@ var installCommand = defineCommand({
       support.id,
       {
         name: "poe-code-superintendent-plan",
-        content: skillContent
+        content: skillContent + "\n\n" + skillPlanConfigSection("superintendent")
       },
       {
         fs: fs2,
@@ -22079,7 +22336,7 @@ var installCommand = defineCommand({
     const absolutePlanDirectory = resolveAbsoluteDirectory(planDirectory, cwd, homeDir);
     let planDirectoryCreated = false;
     if (!await pathExists2(absolutePlanDirectory)) {
-      await mkdir4(absolutePlanDirectory, { recursive: true });
+      await mkdir5(absolutePlanDirectory, { recursive: true });
       planDirectoryCreated = true;
     }
     return {
@@ -22124,9 +22381,9 @@ async function resolvePlanDirectory(cwd, homeDir, env) {
 }
 function resolveAbsoluteDirectory(dir, cwd, homeDir) {
   if (dir.startsWith("~/")) {
-    return path22.join(homeDir, dir.slice(2));
+    return path24.join(homeDir, dir.slice(2));
   }
-  return path22.isAbsolute(dir) ? dir : path22.resolve(cwd, dir);
+  return path24.isAbsolute(dir) ? dir : path24.resolve(cwd, dir);
 }
 async function pathExists2(targetPath) {
   try {
@@ -22146,15 +22403,15 @@ async function loadSkillTemplate() {
   }
   const packageRoot = await findPackageRoot(fileURLToPath4(import.meta.url));
   const templateRoots = [
-    path22.join(packageRoot, "src", "templates"),
-    path22.join(packageRoot, "dist", "templates")
+    path24.join(packageRoot, "src", "templates"),
+    path24.join(packageRoot, "dist", "templates")
   ];
   for (const templateRoot of templateRoots) {
     if (!await pathExists2(templateRoot)) {
       continue;
     }
     skillTemplateCache = await readFile4(
-      path22.join(templateRoot, "SKILL_superintendent.md"),
+      path24.join(templateRoot, "SKILL_superintendent.md"),
       "utf8"
     );
     return skillTemplateCache;
@@ -22162,12 +22419,12 @@ async function loadSkillTemplate() {
   throw new Error("Unable to locate Superintendent skill template.");
 }
 async function findPackageRoot(entryFilePath) {
-  let currentPath = path22.dirname(entryFilePath);
+  let currentPath = path24.dirname(entryFilePath);
   while (true) {
-    if (await pathExists2(path22.join(currentPath, "package.json"))) {
+    if (await pathExists2(path24.join(currentPath, "package.json"))) {
       return currentPath;
     }
-    const parentPath = path22.dirname(currentPath);
+    const parentPath = path24.dirname(currentPath);
     if (parentPath === currentPath) {
       throw new Error("Unable to locate package root for Superintendent templates.");
     }
@@ -22189,8 +22446,8 @@ var inspectorListCommand = defineCommand({
   positional: ["path"],
   params: inspectorListParams,
   scope: ["cli", "mcp", "sdk"],
-  handler: async ({ params, fs: fs3 }) => {
-    const content = await readDocument4(params.path, fs3);
+  handler: async ({ params, fs: fs4 }) => {
+    const content = await readDocument4(params.path, fs4);
     const document = parseSuperintendentDoc(params.path, content);
     return Object.entries(document.frontmatter.inspectors ?? {}).map(([name, config]) => ({
       name,
@@ -22230,8 +22487,8 @@ var inspectorRunCommand = defineCommand({
   positional: ["path", "name"],
   params: inspectorRunParams,
   scope: ["cli", "mcp", "sdk"],
-  handler: async ({ params, fs: fs3 }) => {
-    const content = await readDocument4(params.path, fs3);
+  handler: async ({ params, fs: fs4 }) => {
+    const content = await readDocument4(params.path, fs4);
     const document = parseSuperintendentDoc(params.path, content);
     const defaultCwd = process.cwd();
     if (params.name === void 0) {
@@ -22264,9 +22521,9 @@ var inspectorGroup = defineGroup({
   scope: ["cli", "mcp", "sdk"],
   children: [inspectorListCommand, inspectorRunCommand]
 });
-async function readDocument4(filePath, fs3) {
+async function readDocument4(filePath, fs4) {
   try {
-    return await fs3.readFile(filePath, "utf8");
+    return await fs4.readFile(filePath, "utf8");
   } catch (error2) {
     if (hasCode3(error2, "ENOENT")) {
       throw new UserError(`Superintendent document not found: ${filePath}`);
@@ -22314,11 +22571,11 @@ var completeCommand = defineCommand({
   positional: ["path"],
   params: completeParams,
   scope: ["cli", "mcp", "sdk"],
-  handler: async ({ params, fs: fs3 }) => {
-    const content = await readDocument5(params.path, fs3);
+  handler: async ({ params, fs: fs4 }) => {
+    const content = await readDocument5(params.path, fs4);
     const completedContent = transitionState(params.path, content, "completed");
     const updatedContent = setStatusReason(params.path, completedContent, params.reason);
-    await fs3.writeFile(params.path, updatedContent);
+    await fs4.writeFile(params.path, updatedContent);
     return {
       path: params.path,
       state: "completed",
@@ -22342,9 +22599,9 @@ var completeCommand = defineCommand({
     json: (result) => result
   }
 });
-async function readDocument5(filePath, fs3) {
+async function readDocument5(filePath, fs4) {
   try {
-    return await fs3.readFile(filePath, "utf8");
+    return await fs4.readFile(filePath, "utf8");
   } catch (error2) {
     if (hasCode4(error2, "ENOENT")) {
       throw new UserError(`Superintendent document not found: ${filePath}`);
@@ -22356,9 +22613,50 @@ function hasCode4(error2, code) {
   return typeof error2 === "object" && error2 !== null && "code" in error2 && error2.code === code;
 }
 
+// packages/superintendent/src/commands/plan-path.ts
+import path25 from "node:path";
+import { readFile as readFile5, writeFile as writeFile3, mkdir as mkdir6, unlink as unlink2, stat as stat5, readdir as readdir4 } from "node:fs/promises";
+var fs3 = {
+  readFile: (p, encoding) => readFile5(p, encoding),
+  writeFile: (p, content) => writeFile3(p, content),
+  mkdir: (p, options) => mkdir6(p, options).then(() => void 0),
+  unlink: (p) => unlink2(p),
+  stat: (p) => stat5(p).then((s) => ({ mode: s.mode })),
+  readdir: (p) => readdir4(p)
+};
+var planPathCommand = defineCommand({
+  name: "plan-path",
+  description: "Print the directory where superintendent plan files should be placed.",
+  params: S.Object({}),
+  scope: ["cli", "sdk"],
+  handler: async () => {
+    const cwd = process.cwd();
+    const homeDir = process.env.HOME ?? process.env.USERPROFILE ?? cwd;
+    const configPath = resolveConfigPath(homeDir);
+    const projectConfigPath = resolveProjectConfigPath(cwd);
+    const document = await readMergedDocument(fs3, configPath, projectConfigPath);
+    const planDirectory = resolveScope(planConfigScope.schema, document.plan, process.env).plan_directory;
+    return { planDirectory: resolveAbsoluteDirectory2(planDirectory, cwd, homeDir) };
+  },
+  render: {
+    rich: (result) => {
+      process.stdout.write(`${result.planDirectory}
+`);
+    },
+    markdown: (result) => result.planDirectory,
+    json: (result) => result
+  }
+});
+function resolveAbsoluteDirectory2(dir, cwd, homeDir) {
+  if (dir.startsWith("~/")) {
+    return path25.join(homeDir, dir.slice(2));
+  }
+  return path25.isAbsolute(dir) ? dir : path25.resolve(cwd, dir);
+}
+
 // packages/superintendent/src/commands/run.ts
-import path24 from "node:path";
-import * as fsPromises6 from "node:fs/promises";
+import path26 from "node:path";
+import * as fsPromises7 from "node:fs/promises";
 import { spawn as nodeSpawn, spawnSync as nodeSpawnSync } from "node:child_process";
 init_src6();
 init_src4();
@@ -22366,182 +22664,19 @@ init_src4();
 // packages/superintendent/src/commands/poe-agent-runner.ts
 init_src4();
 init_src7();
-import { mkdir as mkdir5, appendFile as appendFile2 } from "node:fs/promises";
-
-// packages/superintendent/src/commands/poe-agent-transcript.ts
-import path23 from "node:path";
-function mapAcpEventToSessionUpdates(event) {
-  if (event.type === "message.delta") {
-    if (event.content.length === 0) return [];
-    return [{ sessionUpdate: "agent_message_chunk", content: { type: "text", text: event.content } }];
-  }
-  if (event.type === "tool.intent") {
-    return [
-      {
-        sessionUpdate: "tool_call",
-        toolCallId: event.intentId,
-        title: event.tool,
-        kind: "execute",
-        status: "pending",
-        rawInput: event.args
-      },
-      {
-        sessionUpdate: "tool_call_update",
-        toolCallId: event.intentId,
-        kind: "execute",
-        status: "in_progress"
-      }
-    ];
-  }
-  if (event.type === "tool.result") {
-    return [
-      {
-        sessionUpdate: "tool_call_update",
-        toolCallId: event.intentId,
-        kind: "execute",
-        status: "completed",
-        rawOutput: event.result
-      }
-    ];
-  }
-  if (event.type === "tool.error") {
-    return [
-      {
-        sessionUpdate: "tool_call_update",
-        toolCallId: event.intentId,
-        kind: "execute",
-        status: "failed",
-        rawOutput: event.error
-      }
-    ];
-  }
-  if (event.type === "usage") {
-    const { inputTokens, outputTokens, cachedTokens, cacheCreationTokens } = event.usage;
-    const nonCachedInput = Math.max(0, inputTokens - cachedTokens);
-    return [
-      {
-        sessionUpdate: "usage_update",
-        used: nonCachedInput,
-        size: inputTokens,
-        _meta: { inputTokens, outputTokens, cachedTokens, cacheCreationTokens }
-      }
-    ];
-  }
-  return [];
-}
-function createTranscriptWriter(options) {
-  const join2 = options.pathJoin ?? path23.join;
-  const filePath = join2(options.logDir, options.logFileName);
-  let dirEnsured;
-  let disabled = false;
-  const ensureDir = () => {
-    if (!dirEnsured) {
-      dirEnsured = options.fs.mkdir(options.logDir, { recursive: true });
-    }
-    return dirEnsured;
-  };
-  return {
-    filePath,
-    async write(event) {
-      if (disabled) return;
-      const updates = mapAcpEventToSessionUpdates(event);
-      if (updates.length === 0) return;
-      try {
-        await ensureDir();
-        const payload = updates.map((u) => `${JSON.stringify(u)}
-`).join("");
-        await options.fs.appendFile(filePath, payload);
-      } catch {
-        disabled = true;
-      }
-    },
-    async close() {
-    }
-  };
-}
-
-// packages/superintendent/src/commands/poe-agent-runner.ts
-var defaultTranscriptFs = {
-  mkdir: (dir, options) => mkdir5(dir, options).then(() => void 0),
-  appendFile: (filePath, contents) => appendFile2(filePath, contents, "utf8")
-};
-async function executePoeAgent(agentSpec, input, createAgent = agent, transcriptFs = defaultTranscriptFs) {
+async function executePoeAgent(agentSpec, input, createAgent = agent) {
   const { model } = parseAgentSpecifier(agentSpec);
   if (!model) {
     throw new Error(
       `poe-agent requires a model in the agent specifier (e.g. "poe-agent:openai/gpt-5.4"); got "${agentSpec}".`
     );
   }
-  const mcpConfigs = toPoeMcpConfigs(input.mcpServers);
-  let builder = createAgent().model(model).use(openaiResponsesPlugin()).use(openaiChatCompletionsPlugin()).use(poe_agent_plugin_system_prompt_default()).use(poe_agent_plugin_environment_default(input.cwd)).use(poe_agent_plugin_files_default({ cwd: input.cwd })).use(poe_agent_plugin_shell_default({ cwd: input.cwd })).use(poe_agent_plugin_web_default()).use(poe_agent_plugin_compaction_default()).use(poe_agent_plugin_skills_default({ definitions: {} }));
-  if (input.mode) {
-    builder = builder.use(poe_agent_plugin_policy_default({ mode: input.mode }));
-  }
-  builder = builder.mcp(...mcpConfigs);
-  const streamOptions = {
+  return createAgent().model(model).use(openaiResponsesPlugin()).use(openaiChatCompletionsPlugin()).use(poe_agent_plugin_system_prompt_default()).use(poe_agent_plugin_environment_default(input.cwd)).use(poe_agent_plugin_files_default({ cwd: input.cwd })).use(poe_agent_plugin_shell_default({ cwd: input.cwd })).use(poe_agent_plugin_web_default()).use(poe_agent_plugin_compaction_default()).use(poe_agent_plugin_skills_default({ definitions: {} })).use(poe_agent_plugin_policy_default({ mode: input.mode })).mcp(input.mcpServers ?? {}).run(input.prompt, {
     cwd: input.cwd,
-    ...input.signal ? { signal: input.signal } : {}
-  };
-  const transcript = input.logDir && input.logFileName ? createTranscriptWriter({
-    logDir: input.logDir,
-    logFileName: input.logFileName,
-    fs: transcriptFs
-  }) : void 0;
-  let completed = "";
-  let streamed = "";
-  let failure;
-  let usage;
-  const toolCalls = [];
-  try {
-    for await (const event of builder.stream(input.prompt, streamOptions)) {
-      if (transcript) {
-        await transcript.write(event);
-      }
-      if (event.type === "message.delta") {
-        input.onStdout?.(event.content);
-        streamed += event.content;
-      } else if (event.type === "tool.intent") {
-        toolCalls.push({ title: event.tool, input: event.args });
-      } else if (event.type === "usage") {
-        usage = {
-          inputTokens: event.usage.inputTokens,
-          outputTokens: event.usage.outputTokens,
-          cachedTokens: event.usage.cachedTokens
-        };
-      } else if (event.type === "session.complete") {
-        completed = event.result.output;
-      } else if (event.type === "session.error") {
-        failure = event.error;
-      }
-    }
-  } finally {
-    await transcript?.close();
-  }
-  if (failure) {
-    return {
-      stdout: streamed,
-      stderr: failure.message,
-      exitCode: 1,
-      ...transcript ? { logFile: transcript.filePath } : {},
-      ...usage ? { usage } : {}
-    };
-  }
-  const output = completed || streamed;
-  return {
-    stdout: output,
-    stderr: "",
-    exitCode: 0,
-    summary: output,
-    ...transcript ? { logFile: transcript.filePath } : {},
-    ...toolCalls.length > 0 ? { toolCalls } : {},
-    ...usage ? { usage } : {}
-  };
-}
-function toPoeMcpConfigs(servers) {
-  if (!servers) {
-    return [];
-  }
-  return Object.entries(servers).map(([name, server]) => ({ name, ...server }));
+    signal: input.signal,
+    onStdout: input.onStdout,
+    logPath: input.logPath
+  });
 }
 
 // packages/superintendent/src/commands/run.ts
@@ -22640,12 +22775,12 @@ var runMcpCommand = defineCommand({
   },
   render: runCommand2.render
 });
-async function resolveSuperintendentCommandConfig(cwd, homeDir, env, fs3) {
+async function resolveSuperintendentCommandConfig(cwd, homeDir, env, fs4) {
   const configPath = resolveConfigPath(homeDir);
   const projectConfigPath = resolveProjectConfigPath(cwd);
   try {
     const document = await readMergedDocument(
-      createConfigResolutionFs(fs3),
+      createConfigResolutionFs(fs4),
       configPath,
       projectConfigPath
     );
@@ -22663,48 +22798,48 @@ async function resolveSuperintendentCommandConfig(cwd, homeDir, env, fs3) {
     return { tui: false };
   }
 }
-async function resolveSuperintendentPlanDirectory(cwd, homeDir, env, fs3) {
+async function resolveSuperintendentPlanDirectory(cwd, homeDir, env, fs4) {
   const configPath = resolveConfigPath(homeDir);
   const projectConfigPath = resolveProjectConfigPath(cwd);
   const document = await readMergedDocument(
-    createConfigResolutionFs(fs3),
+    createConfigResolutionFs(fs4),
     configPath,
     projectConfigPath
   );
   return resolveScope(planConfigScope.schema, document.plan, env).plan_directory;
 }
 var configFs = {
-  readFile: (filePath, encoding) => fsPromises6.readFile(filePath, encoding),
+  readFile: (filePath, encoding) => fsPromises7.readFile(filePath, encoding),
   writeFile: async (filePath, content, options) => {
-    await fsPromises6.writeFile(filePath, content, options ?? { encoding: "utf8" });
+    await fsPromises7.writeFile(filePath, content, options ?? { encoding: "utf8" });
   },
   mkdir: async (filePath, options) => {
-    await fsPromises6.mkdir(filePath, options);
+    await fsPromises7.mkdir(filePath, options);
   },
-  unlink: (filePath) => fsPromises6.unlink(filePath),
+  unlink: (filePath) => fsPromises7.unlink(filePath),
   stat: async (filePath) => {
-    const stat6 = await fsPromises6.stat(filePath);
-    return { mode: stat6.mode };
+    const stat7 = await fsPromises7.stat(filePath);
+    return { mode: stat7.mode };
   },
-  readdir: (filePath) => fsPromises6.readdir(filePath)
+  readdir: (filePath) => fsPromises7.readdir(filePath)
 };
-function createConfigResolutionFs(fs3) {
-  if (!fs3) {
+function createConfigResolutionFs(fs4) {
+  if (!fs4) {
     return configFs;
   }
   return {
     ...configFs,
-    readFile: (filePath, encoding) => fs3.readFile(filePath, encoding),
+    readFile: (filePath, encoding) => fs4.readFile(filePath, encoding),
     writeFile: async (filePath, content, options) => {
-      await fs3.writeFile(filePath, content, options);
+      await fs4.writeFile(filePath, content, options);
     },
     mkdir: async (filePath, options) => {
-      await fs3.mkdir(filePath, options);
+      await fs4.mkdir(filePath, options);
     }
   };
 }
 async function runSuperintendentCommand(options) {
-  const fs3 = options.fs ?? createDefaultFs3();
+  const fs4 = options.fs ?? createDefaultFs3();
   const now = options.now ?? Date.now;
   const selectPrompt = options.selectPrompt ?? select2;
   const dashboardFactory = options.createDashboard ?? createDashboard;
@@ -22725,7 +22860,7 @@ async function runSuperintendentCommand(options) {
     assumeYes,
     interactive,
     env,
-    fs: fs3,
+    fs: fs4,
     selectPrompt
   });
   const runLogDir = resolveRunLogDir({
@@ -22733,7 +22868,7 @@ async function runSuperintendentCommand(options) {
     runner: "superintendent",
     homeDir: options.homeDir
   });
-  const document = parseSuperintendentDoc(selectedDocPath, await fs3.readFile(selectedDocPath, "utf8"));
+  const document = parseSuperintendentDoc(selectedDocPath, await fs4.readFile(selectedDocPath, "utf8"));
   const builderAgent = options.builderAgent ?? document.frontmatter.builder.agent;
   const selectedBuilderAgent = resolveAgentId(builderAgent) ?? builderAgent;
   if (!useDashboard) {
@@ -22749,7 +22884,7 @@ async function runSuperintendentCommand(options) {
         docPath: selectedDocPath,
         cwd: options.cwd,
         homeDir: options.homeDir,
-        ...options.fs ? { fs: fs3 } : {},
+        ...options.fs ? { fs: fs4 } : {},
         signal: headlessAbort.signal,
         logDir: runLogDir,
         callbacks: {
@@ -22999,7 +23134,7 @@ async function runSuperintendentCommand(options) {
         session.pauseRequested = true;
       }
       editPlan(session.dashboard, session.latestLogFile, env, options.openInEditor);
-      appendEvent("info", `Log opened: ${path24.basename(session.latestLogFile)}`);
+      appendEvent("info", `Log opened: ${path26.basename(session.latestLogFile)}`);
       syncStats();
     }
   };
@@ -23019,7 +23154,7 @@ async function runSuperintendentCommand(options) {
         docPath: selectedDocPath,
         cwd: options.cwd,
         homeDir: options.homeDir,
-        ...options.fs ? { fs: fs3 } : {},
+        ...options.fs ? { fs: fs4 } : {},
         callbacks,
         signal: abortController.signal,
         logDir: runLogDir,
@@ -23137,24 +23272,24 @@ async function discoverSuperintendentDocs(options) {
   }
   return matches2;
 }
-async function listPlanDirectoryDocs(fs3, planDirectory, cwd, homeDir) {
+async function listPlanDirectoryDocs(fs4, planDirectory, cwd, homeDir) {
   const absoluteDir = resolveAbsolutePlanDirectory(planDirectory, cwd, homeDir);
   let entries;
   try {
-    entries = await fs3.readdir(absoluteDir);
+    entries = await fs4.readdir(absoluteDir);
   } catch (error2) {
     if (isMissingDirectory(error2)) {
       return [];
     }
     throw error2;
   }
-  return entries.filter((entry) => entry.toLowerCase().endsWith(".md")).map((entry) => path24.join(absoluteDir, entry)).sort((left, right) => left.localeCompare(right));
+  return entries.filter((entry) => entry.toLowerCase().endsWith(".md")).map((entry) => path26.join(absoluteDir, entry)).sort((left, right) => left.localeCompare(right));
 }
 function resolveAbsolutePlanDirectory(dir, cwd, homeDir) {
   if (dir.startsWith("~/")) {
-    return path24.join(homeDir, dir.slice(2));
+    return path26.join(homeDir, dir.slice(2));
   }
-  return path24.isAbsolute(dir) ? dir : path24.resolve(cwd, dir);
+  return path26.isAbsolute(dir) ? dir : path26.resolve(cwd, dir);
 }
 function isMissingDirectory(error2) {
   if (!error2 || typeof error2 !== "object" || !("code" in error2)) {
@@ -23251,8 +23386,7 @@ async function executeSpawnAgent(agent2, input) {
     ...input.mode ? { mode: input.mode } : {},
     ...input.mcpServers ? { mcpServers: input.mcpServers } : {},
     ...input.signal ? { signal: input.signal } : {},
-    ...input.logDir ? { logDir: input.logDir } : {},
-    ...input.logFileName ? { logFileName: input.logFileName } : {},
+    ...input.logPath ? { logPath: input.logPath } : {},
     ...tee ? { tee } : {}
   });
   return {
@@ -23291,8 +23425,7 @@ async function executeSpawnAgentStreaming(agent2, input) {
     prompt: input.prompt,
     cwd: input.cwd,
     startedAt: /* @__PURE__ */ new Date(),
-    ...input.logDir ? { logDir: input.logDir } : {},
-    ...input.logFileName ? { logFileName: input.logFileName } : {},
+    ...input.logPath ? { logPath: input.logPath } : {},
     ...input.mode ? { mode: input.mode } : {}
   };
   await applyMiddlewares([spawnLog, usageCapture, sessionCapture], middlewareContext);
@@ -23386,7 +23519,7 @@ function resolveEditor(env) {
   const parts = raw.split(/\s+/);
   const command = parts[0] ?? "vi";
   const args = parts.slice(1);
-  const binary = path24.basename(command);
+  const binary = path26.basename(command);
   const mode = GUI_EDITOR_BINARIES.has(binary) ? "gui" : "tty";
   return { command, args, mode };
 }
@@ -23413,35 +23546,35 @@ function stripStopReason(result) {
   };
 }
 function displayPath(filePath, cwd, homeDir) {
-  if (filePath.startsWith(`${cwd}${path24.sep}`)) {
-    return path24.relative(cwd, filePath);
+  if (filePath.startsWith(`${cwd}${path26.sep}`)) {
+    return path26.relative(cwd, filePath);
   }
-  if (filePath.startsWith(`${homeDir}${path24.sep}`)) {
-    return `~/${path24.relative(homeDir, filePath)}`;
+  if (filePath.startsWith(`${homeDir}${path26.sep}`)) {
+    return `~/${path26.relative(homeDir, filePath)}`;
   }
   return filePath;
 }
 function createDefaultFs3() {
   return {
-    readFile: fsPromises6.readFile,
-    writeFile: fsPromises6.writeFile,
-    readdir: fsPromises6.readdir,
+    readFile: fsPromises7.readFile,
+    writeFile: fsPromises7.writeFile,
+    readdir: fsPromises7.readdir,
     stat: async (filePath) => {
-      const stat6 = await fsPromises6.stat(filePath);
+      const stat7 = await fsPromises7.stat(filePath);
       return {
-        isFile: () => stat6.isFile(),
-        isDirectory: () => stat6.isDirectory(),
-        mtimeMs: stat6.mtimeMs
+        isFile: () => stat7.isFile(),
+        isDirectory: () => stat7.isDirectory(),
+        mtimeMs: stat7.mtimeMs
       };
     },
     mkdir: async (filePath, mkdirOptions) => {
-      await fsPromises6.mkdir(filePath, mkdirOptions);
+      await fsPromises7.mkdir(filePath, mkdirOptions);
     },
     rmdir: async (filePath) => {
-      await fsPromises6.rmdir(filePath);
+      await fsPromises7.rmdir(filePath);
     },
     rename: async (oldPath, newPath) => {
-      await fsPromises6.rename(oldPath, newPath);
+      await fsPromises7.rename(oldPath, newPath);
     }
   };
 }
@@ -23459,8 +23592,8 @@ var validateCommand = defineCommand({
   positional: ["path"],
   params: validateParams,
   scope: ["cli", "mcp", "sdk"],
-  handler: async ({ params, fs: fs3 }) => {
-    const content = await readDocument6(params.path, fs3);
+  handler: async ({ params, fs: fs4 }) => {
+    const content = await readDocument6(params.path, fs4);
     return validateSuperintendentDocument(params.path, content);
   },
   render: {
@@ -23493,7 +23626,7 @@ var superintendentGroup = defineGroup({
   name: "superintendent",
   description: "Superintendent workflow commands.",
   scope: ["cli", "mcp", "sdk"],
-  children: [runCommand2, validateCommand, completeCommand, installCommand, builderGroup, inspectorGroup]
+  children: [runCommand2, validateCommand, completeCommand, installCommand, planPathCommand, builderGroup, inspectorGroup]
 });
 var superintendentMcpGroup = defineGroup({
   name: "superintendent",
@@ -23537,9 +23670,9 @@ function validateSuperintendentDocument(filePath, content) {
   problems.push(...validatePromptVariables(document));
   return toValidationResult(problems);
 }
-async function readDocument6(filePath, fs3) {
+async function readDocument6(filePath, fs4) {
   try {
-    return await fs3.readFile(filePath, "utf8");
+    return await fs4.readFile(filePath, "utf8");
   } catch (error2) {
     if (hasCode5(error2, "ENOENT")) {
       throw new UserError(`Superintendent document not found: ${filePath}`);
@@ -24025,29 +24158,29 @@ function emitEvent(callback, event) {
   callback(event);
 }
 async function loadConfiguredPlugins(options) {
-  const fs3 = createConfigFileSystem(options.fs);
+  const fs4 = createConfigFileSystem(options.fs);
   const homeDir = options.homeDir ?? os3.homedir();
   const store = createConfigStore({
-    fs: fs3,
+    fs: fs4,
     filePath: options.configPath ?? resolveConfigPath(homeDir),
     projectFilePath: options.projectConfigPath ?? resolveProjectConfigPath(options.cwd)
   });
   const plugins = await store.scope(agentConfigScope).get("plugins");
   return plugins ?? void 0;
 }
-function createConfigFileSystem(fs3) {
-  if (fs3) {
-    return fs3;
+function createConfigFileSystem(fs4) {
+  if (fs4) {
+    return fs4;
   }
   return {
     readFile(filePath, encoding) {
-      return encoding ? fsPromises7.readFile(filePath, encoding) : fsPromises7.readFile(filePath);
+      return encoding ? fsPromises8.readFile(filePath, encoding) : fsPromises8.readFile(filePath);
     },
     async writeFile(filePath, data, options) {
-      await fsPromises7.writeFile(filePath, data, options);
+      await fsPromises8.writeFile(filePath, data, options);
     },
     async mkdir(filePath, options) {
-      await fsPromises7.mkdir(filePath, options);
+      await fsPromises8.mkdir(filePath, options);
     }
   };
 }