@cydm/pie 1.0.34 → 1.0.36

package/dist/chunks/{test-stream-A7JSM2UM.js → test-stream-L4PUYWQQ.js}

@@ -5,6 +5,28 @@ import {
 import "./chunk-TG2EQLX2.js";
 
 // src/app/test-stream.ts
+function parseSystemPromptExpectations(value) {
+  if (!value) return [];
+  const parsed = JSON.parse(value);
+  const normalize = (item) => {
+    if (typeof item === "string") return [item];
+    if (Array.isArray(item) && item.every((entry) => typeof entry === "string")) return item;
+    throw new Error("PIE_TEST_EXPECT_SYSTEM_PROMPT_INCLUDES entries must be strings");
+  };
+  if (typeof parsed === "string" || Array.isArray(parsed) && parsed.every((entry) => typeof entry === "string")) {
+    return [normalize(parsed)];
+  }
+  if (!Array.isArray(parsed)) throw new Error("PIE_TEST_EXPECT_SYSTEM_PROMPT_INCLUDES must be JSON");
+  return parsed.map(normalize);
+}
+function assertSystemPromptIncludes(systemPrompt, callIndex) {
+  const expectations = parseSystemPromptExpectations(process.env.PIE_TEST_EXPECT_SYSTEM_PROMPT_INCLUDES);
+  for (const expected of expectations[Math.min(callIndex, Math.max(0, expectations.length - 1))] ?? []) {
+    if (!systemPrompt.includes(expected)) {
+      throw new Error(`Expected system prompt to include ${JSON.stringify(expected)}`);
+    }
+  }
+}
 function createAssistantMessage(model, text, stopReason = "stop", errorMessage) {
   return {
     role: "assistant",
@@ -68,8 +90,9 @@ function createTestStreamFnFromSequenceEnv(value = process.env.PIE_TEST_MOCK_STR
   }
   const steps = parseMockStreamSequence(value);
   let callIndex = 0;
-  return async (model) => {
+  return async (model, context) => {
     const step = steps[Math.min(callIndex, steps.length - 1)];
+    assertSystemPromptIncludes(context.systemPrompt, callIndex);
     callIndex += 1;
     const stream = new EventStream(
       (event) => event.type === "done" || event.type === "error",

package/dist/cli.js

@@ -985,15 +985,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path30 = [graph[toModel].parent, toModel];
+      const path31 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path30.unshift(graph[cur].parent);
+        path31.unshift(graph[cur].parent);
         fn = link(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path30;
+      fn.conversion = path31;
       return fn;
     }
     module.exports = function(fromModel) {
@@ -43957,12 +43957,12 @@ var require_dist = __commonJS({
 });
 
 // src/cli.ts
-import * as fs26 from "fs";
-import * as path29 from "path";
+import * as fs27 from "fs";
+import * as path30 from "path";
 
 // src/cli-args.ts
-var FLAGS_WITH_VALUES = /* @__PURE__ */ new Set(["--session-id", "--extension-path"]);
-var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["--raw-output", "--json-output", "--json-events"]);
+var FLAGS_WITH_VALUES = /* @__PURE__ */ new Set(["--session-id", "--extension-path", "--developer-instructions", "--developer-instructions-file"]);
+var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["--raw-output", "--json-output", "--json-events", "--resume-required"]);
 var HELP_FLAGS = /* @__PURE__ */ new Set(["help", "--help", "-h"]);
 var COMMANDS = /* @__PURE__ */ new Set(["chat", "help"]);
 function parseCliInvocation(args) {
@@ -44014,6 +44014,16 @@ function parseCliInvocation(args) {
     initialPrompt: positionals.join(" ").trim() || void 0
   };
 }
+function parseRepeatedFlag(args, flag) {
+  const values = [];
+  for (let i = 0; i < args.length; i += 1) {
+    if (args[i] === flag && args[i + 1]) {
+      values.push(args[i + 1]);
+      i += 1;
+    }
+  }
+  return values;
+}
 
 // src/debug/file-logger.ts
 import * as fs from "fs";
@@ -44551,7 +44561,7 @@ async function acquireRemoteRefreshLock(modelsPath) {
         throw lockError;
       }
       if (Date.now() >= deadline) throw new Error(`timed out waiting for remote catalog refresh lock: ${lockPath}`);
-      await new Promise((resolve5) => setTimeout(resolve5, 25));
+      await new Promise((resolve6) => setTimeout(resolve6, 25));
     }
   }
 }
@@ -46871,15 +46881,15 @@ function activePathEntries(data) {
 }
 function pathToEntry(data, entryId) {
   const byId = new Map(data.entries.map((entry) => [entry.id, entry]));
-  const path30 = [];
+  const path31 = [];
   let current = entryId;
   while (current) {
     const entry = byId.get(current);
     if (!entry) return [];
-    path30.unshift(entry);
+    path31.unshift(entry);
     current = entry.parentId;
   }
-  return path30;
+  return path31;
 }
 function resolveBeforeCursor(events, cursor) {
   if (!cursor) return events.length;
@@ -46942,19 +46952,19 @@ var CommandTree = class {
    *   register(["session", "new"], { description, handler })
    *   register(["tools", "subagent", "spawn", "local"], { description, handler })
    */
-  register(path30, info) {
-    if (path30.length === 0) {
+  register(path31, info) {
+    if (path31.length === 0) {
       throw new Error("Command path cannot be empty");
     }
     let current = this.root;
     const fullPath = [];
-    for (let i = 0; i < path30.length; i++) {
-      const segment = path30[i];
+    for (let i = 0; i < path31.length; i++) {
+      const segment = path31[i];
       fullPath.push(segment);
       if (!current.children) {
         current.children = [];
       }
-      const isLast = i === path30.length - 1;
+      const isLast = i === path31.length - 1;
       let node = current.children.find((n) => n.name === segment);
       if (!node) {
         node = {
@@ -46984,31 +46994,31 @@ var CommandTree = class {
   /**
    * Find a node by path
    */
-  find(path30) {
-    if (path30.length === 0) {
+  find(path31) {
+    if (path31.length === 0) {
       return this.root;
     }
-    const key = path30.join("/");
+    const key = path31.join("/");
     return this.pathCache.get(key) || null;
   }
   /**
    * Get children of a path
    */
-  getChildren(path30) {
-    const node = this.find(path30);
+  getChildren(path31) {
+    const node = this.find(path31);
     return (node?.children || []).filter((child) => !child.hidden);
   }
   /**
    * Check if a path exists (as category or command)
    */
-  exists(path30) {
-    return this.find(path30) !== null;
+  exists(path31) {
+    return this.find(path31) !== null;
   }
   /**
    * Check if path is a category (has children)
    */
-  isCategory(path30) {
-    const node = this.find(path30);
+  isCategory(path31) {
+    const node = this.find(path31);
     return node?.isCategory || false;
   }
   /**
@@ -47087,8 +47097,8 @@ var CommandTree = class {
    * Supports dot notation: "tools.subagent.spawn.local"
    */
   registerFromPath(pathStr, info) {
-    const path30 = pathStr.split(/[./]/).filter(Boolean);
-    this.register(path30, info);
+    const path31 = pathStr.split(/[./]/).filter(Boolean);
+    this.register(path31, info);
   }
 };
 var commandTree = new CommandTree();
@@ -54378,7 +54388,7 @@ var ProcessTerminal = class {
         const timeLeft = endTime - now;
         if (timeLeft <= 0) break;
         if (now - lastDataTime >= idleMs) break;
-        await new Promise((resolve5) => setTimeout(resolve5, Math.min(idleMs, timeLeft)));
+        await new Promise((resolve6) => setTimeout(resolve6, Math.min(idleMs, timeLeft)));
       }
     } finally {
       process.stdin.removeListener("data", onData);
@@ -54912,10 +54922,10 @@ var KeybindingsManager = class _KeybindingsManager {
   static inMemory(config = {}) {
     return new _KeybindingsManager(config);
   }
-  static loadFromFile(path30) {
-    if (!existsSync7(path30)) return {};
+  static loadFromFile(path31) {
+    if (!existsSync7(path31)) return {};
     try {
-      return JSON.parse(readFileSync6(path30, "utf-8"));
+      return JSON.parse(readFileSync6(path31, "utf-8"));
     } catch {
       return {};
     }
@@ -57625,11 +57635,11 @@ var FileCache = class _FileCache {
   // Hash Computation
   // ============================================================================
   async computeHash(filePath) {
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const hash = crypto.createHash("sha256");
       const stream = fs16.createReadStream(filePath);
       stream.on("data", (chunk) => hash.update(chunk));
-      stream.on("end", () => resolve5(hash.digest("hex")));
+      stream.on("end", () => resolve6(hash.digest("hex")));
       stream.on("error", reject);
     });
   }
@@ -58339,17 +58349,17 @@ var FFmpegProcessor = class {
   // Detection
   // ============================================================================
   async checkAvailability() {
-    return new Promise((resolve5) => {
+    return new Promise((resolve6) => {
       const proc = spawn(this.ffmpegPath, ["-version"]);
-      proc.on("error", () => resolve5(false));
-      proc.on("exit", (code) => resolve5(code === 0));
+      proc.on("error", () => resolve6(false));
+      proc.on("exit", (code) => resolve6(code === 0));
     });
   }
   // ============================================================================
   // Video Analysis
   // ============================================================================
   async analyzeVideo(videoPath) {
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const args = [
         "-v",
         "error",
@@ -58378,7 +58388,7 @@ var FFmpegProcessor = class {
         }
         try {
           const info = this.parseProbeOutput(stdout, videoPath);
-          resolve5(info);
+          resolve6(info);
         } catch (err) {
           reject(err);
         }
@@ -58573,7 +58583,7 @@ var FFmpegProcessor = class {
   // FFmpeg Execution
   // ============================================================================
   runFFmpeg(args) {
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const proc = spawn(this.ffmpegPath, args);
       let stderr = "";
       proc.stderr.on("data", (data) => {
@@ -58588,7 +58598,7 @@ var FFmpegProcessor = class {
             )
           );
         } else {
-          resolve5();
+          resolve6();
         }
       });
       proc.on("error", (err) => {
@@ -58605,7 +58615,7 @@ var FFmpegProcessor = class {
   // Progress Monitoring (for future use)
   // ============================================================================
   async runWithProgress(args, onProgress) {
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const progressArgs = [
         ...args,
         "-progress",
@@ -58635,7 +58645,7 @@ var FFmpegProcessor = class {
             )
           );
         } else {
-          resolve5();
+          resolve6();
         }
       });
     });
@@ -59625,7 +59635,7 @@ async function waitForReady(params) {
     if (status.status === "error" || status.status === "expired") {
       throw new Error(`Uploaded file is not ready: ${status.status}${status.error ? ` (${status.error})` : ""}`);
     }
-    await new Promise((resolve5) => setTimeout(resolve5, 1500));
+    await new Promise((resolve6) => setTimeout(resolve6, 1500));
   }
   throw new Error("Timed out waiting for uploaded file to become ready");
 }
@@ -59721,8 +59731,8 @@ function createIsolatedRegexSession(pattern, ignoreCase) {
   let initError;
   let readyResolve;
   let readyReject;
-  const ready = new Promise((resolve5, reject) => {
-    readyResolve = resolve5;
+  const ready = new Promise((resolve6, reject) => {
+    readyResolve = resolve6;
     readyReject = reject;
   });
   void ready.catch(() => void 0);
@@ -59744,7 +59754,7 @@ function createIsolatedRegexSession(pattern, ignoreCase) {
       if (initError) throw initError;
       if (signal?.aborted) throw new Error("Operation aborted");
       const id = nextId++;
-      return new Promise((resolve5, reject) => {
+      return new Promise((resolve6, reject) => {
         let settled = false;
         const finish = (error, matches) => {
           if (settled) return;
@@ -59754,7 +59764,7 @@ function createIsolatedRegexSession(pattern, ignoreCase) {
           worker.off("message", onMessage);
           worker.off("error", onWorkerError);
           if (error) reject(error);
-          else resolve5(matches ?? []);
+          else resolve6(matches ?? []);
         };
         const terminate = (error) => {
           disposed = true;
@@ -60982,7 +60992,7 @@ async function handleCacheTest(host) {
     host.chatContainer.addChild(new Text(theme.fg("dim", `  ${summarizeUsage(result1.usage)}`), 1, 0));
     host.chatContainer.addChild(new Text(theme.fg("dim", "  Waiting 2s before replaying identical request..."), 1, 0));
     host.ui.requestRender();
-    await new Promise((resolve5) => setTimeout(resolve5, 2e3));
+    await new Promise((resolve6) => setTimeout(resolve6, 2e3));
     host.chatContainer.addChild(new Text(theme.fg("accent", "Request 2/2: replaying identical request..."), 1, 0));
     host.ui.requestRender();
     result2 = await completeSimple(model, context, options);
@@ -61972,16 +61982,16 @@ var Diff = class {
       }
     }
   }
-  addToPath(path30, added, removed, oldPosInc, options) {
-    const last = path30.lastComponent;
+  addToPath(path31, added, removed, oldPosInc, options) {
+    const last = path31.lastComponent;
     if (last && !options.oneChangePerToken && last.added === added && last.removed === removed) {
       return {
-        oldPos: path30.oldPos + oldPosInc,
+        oldPos: path31.oldPos + oldPosInc,
         lastComponent: { count: last.count + 1, added, removed, previousComponent: last.previousComponent }
       };
     } else {
       return {
-        oldPos: path30.oldPos + oldPosInc,
+        oldPos: path31.oldPos + oldPosInc,
         lastComponent: { count: 1, added, removed, previousComponent: last }
       };
     }
@@ -62429,13 +62439,13 @@ function formatSize2(bytes) {
 }
 var DEFAULT_MAX_BYTES = 102400;
 var DEFAULT_MAX_LINES = 100;
-function shortenPath(path30) {
-  if (typeof path30 !== "string") return "";
+function shortenPath(path31) {
+  if (typeof path31 !== "string") return "";
   const home = os4.homedir();
-  if (path30.startsWith(home)) {
-    return `~${path30.slice(home.length)}`;
+  if (path31.startsWith(home)) {
+    return `~${path31.slice(home.length)}`;
   }
-  return path30;
+  return path31;
 }
 function replaceTabs(text) {
   return text.replace(/\t/g, "   ");
@@ -62516,14 +62526,14 @@ ${renderManageTodoListResult(this.result, { expanded: this.expanded }, theme)}`;
       }
     } else if (this.toolName === "read_file") {
       const rawPath = str(this.args?.file_path ?? this.args?.path);
-      const path30 = rawPath !== null ? shortenPath(rawPath) : null;
+      const path31 = rawPath !== null ? shortenPath(rawPath) : null;
       const offset = typeof this.args?.offset === "number" ? this.args.offset : void 0;
       const limit = typeof this.args?.limit === "number" ? this.args.limit : void 0;
       let pathDisplay;
-      if (path30 === null) {
+      if (path31 === null) {
         pathDisplay = invalidArg;
-      } else if (path30) {
-        pathDisplay = theme.fg("accent", path30);
+      } else if (path31) {
+        pathDisplay = theme.fg("accent", path31);
       } else {
         const partialPath = partialStr(this.args?.file_path ?? this.args?.path);
         pathDisplay = theme.fg("toolOutput", partialPath);
@@ -62570,12 +62580,12 @@ ${renderManageTodoListResult(this.result, { expanded: this.expanded }, theme)}`;
     } else if (this.toolName === "write_file") {
       const rawPath = str(this.args?.file_path ?? this.args?.path);
       const fileContent = str(this.args?.content);
-      const path30 = rawPath !== null ? shortenPath(rawPath) : null;
+      const path31 = rawPath !== null ? shortenPath(rawPath) : null;
       let pathDisplay;
-      if (path30 === null) {
+      if (path31 === null) {
         pathDisplay = invalidArg;
-      } else if (path30) {
-        pathDisplay = theme.fg("accent", path30);
+      } else if (path31) {
+        pathDisplay = theme.fg("accent", path31);
       } else {
         const partialPath = partialStr(this.args?.file_path ?? this.args?.path);
         pathDisplay = theme.fg("toolOutput", partialPath);
@@ -62612,12 +62622,12 @@ ${theme.fg("error", errorText)}`;
       }
     } else if (this.toolName === "edit_file") {
       const rawPath = str(this.args?.file_path ?? this.args?.path);
-      const path30 = rawPath !== null ? shortenPath(rawPath) : null;
+      const path31 = rawPath !== null ? shortenPath(rawPath) : null;
       let pathDisplay;
-      if (path30 === null) {
+      if (path31 === null) {
         pathDisplay = invalidArg;
-      } else if (path30) {
-        pathDisplay = theme.fg("accent", path30);
+      } else if (path31) {
+        pathDisplay = theme.fg("accent", path31);
       } else {
         const partialPath = partialStr(this.args?.file_path ?? this.args?.path);
         pathDisplay = theme.fg("toolOutput", partialPath);
@@ -62642,7 +62652,7 @@ ${theme.fg("error", errorText)}`;
         const diff = this.result.details.diff;
         const firstChangedLine = this.result.details.firstChangedLine;
         if (firstChangedLine) {
-          text = `${theme.fg("toolTitle", theme.bold("edit_file"))} ${theme.fg("accent", path30 || rawPath)}${theme.fg("warning", `:${firstChangedLine}`)}`;
+          text = `${theme.fg("toolTitle", theme.bold("edit_file"))} ${theme.fg("accent", path31 || rawPath)}${theme.fg("warning", `:${firstChangedLine}`)}`;
         }
         const lines = diff.split("\n");
         const maxLines = this.expanded ? lines.length : 15;
@@ -62662,7 +62672,7 @@ ${theme.fg("error", errorText)}`;
         const diff = generateEditDiff(oldText, newText, rawPath);
         const firstChangedLine = findFirstChangedLine(oldText, newText);
         if (firstChangedLine) {
-          text = `${theme.fg("toolTitle", theme.bold("edit_file"))} ${theme.fg("accent", path30 || rawPath)}${theme.fg("warning", `:${firstChangedLine}`)}`;
+          text = `${theme.fg("toolTitle", theme.bold("edit_file"))} ${theme.fg("accent", path31 || rawPath)}${theme.fg("warning", `:${firstChangedLine}`)}`;
         }
         const lines = diff.split("\n");
         const maxLines = this.expanded ? lines.length : 15;
@@ -62681,9 +62691,9 @@ ${theme.fg("error", errorText)}`;
       }
     } else if (this.toolName === "list_dir") {
       const rawPath = str(this.args?.path);
-      const path30 = rawPath !== null ? shortenPath(rawPath || ".") : null;
+      const path31 = rawPath !== null ? shortenPath(rawPath || ".") : null;
       const limit = this.args?.limit;
-      text = `${theme.fg("toolTitle", theme.bold("list_dir"))} ${path30 === null ? invalidArg : theme.fg("accent", path30)}`;
+      text = `${theme.fg("toolTitle", theme.bold("list_dir"))} ${path31 === null ? invalidArg : theme.fg("accent", path31)}`;
       if (limit !== void 0) {
         text += theme.fg("toolOutput", ` (limit ${limit})`);
       }
@@ -62719,9 +62729,9 @@ ${theme.fg("warning", `[Truncated: ${warnings.join(", ")}]`)}`;
     } else if (this.toolName === "find_files") {
       const pattern = str(this.args?.pattern);
       const rawPath = str(this.args?.path);
-      const path30 = rawPath !== null ? shortenPath(rawPath || ".") : null;
+      const path31 = rawPath !== null ? shortenPath(rawPath || ".") : null;
       const limit = this.args?.limit;
-      text = theme.fg("toolTitle", theme.bold("find_files")) + " " + (pattern === null ? invalidArg : theme.fg("accent", pattern || "")) + theme.fg("toolOutput", ` in ${path30 === null ? invalidArg : path30}`);
+      text = theme.fg("toolTitle", theme.bold("find_files")) + " " + (pattern === null ? invalidArg : theme.fg("accent", pattern || "")) + theme.fg("toolOutput", ` in ${path31 === null ? invalidArg : path31}`);
       if (limit !== void 0) {
         text += theme.fg("toolOutput", ` (limit ${limit})`);
       }
@@ -62757,10 +62767,10 @@ ${theme.fg("warning", `[Truncated: ${warnings.join(", ")}]`)}`;
     } else if (this.toolName === "grep_text") {
       const pattern = str(this.args?.pattern);
       const rawPath = str(this.args?.path);
-      const path30 = rawPath !== null ? shortenPath(rawPath || ".") : null;
+      const path31 = rawPath !== null ? shortenPath(rawPath || ".") : null;
       const glob = str(this.args?.glob);
       const limit = this.args?.limit;
-      text = theme.fg("toolTitle", theme.bold("grep_text")) + " " + (pattern === null ? invalidArg : theme.fg("accent", `/${pattern || ""}/`)) + theme.fg("toolOutput", ` in ${path30 === null ? invalidArg : path30}`);
+      text = theme.fg("toolTitle", theme.bold("grep_text")) + " " + (pattern === null ? invalidArg : theme.fg("accent", `/${pattern || ""}/`)) + theme.fg("toolOutput", ` in ${path31 === null ? invalidArg : path31}`);
       if (glob) {
         text += theme.fg("toolOutput", ` (${glob})`);
       }
@@ -63214,8 +63224,8 @@ async function forkAtEntry(host, entryId) {
       host.showError("Failed to branch at entry");
       return;
     }
-    const path30 = host.sessionManager.getPathToEntry(entryId);
-    const pathNames = path30.map((e) => e.message?.role || "entry").join(" \u2192 ");
+    const path31 = host.sessionManager.getPathToEntry(entryId);
+    const pathNames = path31.map((e) => e.message?.role || "entry").join(" \u2192 ");
     const messages = host.sessionManager.getMessages();
     host.syncAgentFromActiveSession(messages);
     await host.syncSessionScopedState(messages);
@@ -63228,7 +63238,7 @@ async function forkAtEntry(host, entryId) {
     host.updatePendingMessagesDisplay();
     host.renderMessageHistory(messages);
     await host.sessionManager.save();
-    host.showStatus(`Branched at: ${pathNames} (${path30.length} messages). Continue to add to this branch.`);
+    host.showStatus(`Branched at: ${pathNames} (${path31.length} messages). Continue to add to this branch.`);
   } catch (error) {
     host.showError(
       `Failed to branch: ${error instanceof Error ? error.message : String(error)}`
@@ -63256,10 +63266,10 @@ async function navigateToEntry(host, entryId) {
     host.sessionManager.save().catch((err) => {
       console.error("[Session] Save after navigation failed:", err);
     });
-    const path30 = host.sessionManager.getPathToEntry(entryId);
+    const path31 = host.sessionManager.getPathToEntry(entryId);
     const entry = host.sessionManager.getEntry(entryId);
     const role = entry?.message?.role || "entry";
-    host.showStatus(`Switched to branch: ${role} (${path30.length} messages in path)`);
+    host.showStatus(`Switched to branch: ${role} (${path31.length} messages in path)`);
   } catch (error) {
     host.showError(
       `Failed to navigate: ${error instanceof Error ? error.message : String(error)}`
@@ -65049,7 +65059,7 @@ function setupInteractiveEditorSubmitHandler(host) {
     host.chatContainer.addChild(userMsg);
     host.editor.setText("");
     host.ui.requestRender();
-    await new Promise((resolve5) => setImmediate(resolve5));
+    await new Promise((resolve6) => setImmediate(resolve6));
     let finalContent = messageContent;
     const reminderPrefix = host.executionReminder;
     const combinedPrefix = [reminderPrefix].filter((value) => Boolean(value)).join("");
@@ -67703,11 +67713,11 @@ var HierarchicalSelectorComponent = class extends Container {
 // src/runtime/interactive-ui-helpers.ts
 function showHierarchicalMenu(host, initialPath = []) {
   const basePath = [...initialPath];
-  const showAtPath = (path30) => {
+  const showAtPath = (path31) => {
     host.showSelector((done) => {
       const selector = new HierarchicalSelectorComponent({
         tree: commandTree,
-        path: path30,
+        path: path31,
         basePath,
         onNavigate: (newPath) => {
           done();
@@ -67715,7 +67725,7 @@ function showHierarchicalMenu(host, initialPath = []) {
         },
         onSelect: async (selectedPath, node, searchArgs) => {
           if (node.handler) {
-            const args = searchArgs || (selectedPath.length > path30.length ? selectedPath.slice(path30.length).join(" ") : void 0);
+            const args = searchArgs || (selectedPath.length > path31.length ? selectedPath.slice(path31.length).join(" ") : void 0);
             const commandPath = "/" + selectedPath.join("/");
             if (!args && host.isInteractiveCommand(commandPath)) {
               done();
@@ -68394,7 +68404,7 @@ async function handleDirectBash(host, command) {
   child.stderr.on("data", (data) => {
     output.append(data.toString());
   });
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     let settled = false;
     const finish = (code) => {
       if (settled) return;
@@ -68407,7 +68417,7 @@ async function handleDirectBash(host, command) {
       }
       host.chatContainer.addChild(new Spacer(1));
       host.ui.requestRender();
-      resolve5();
+      resolve6();
     };
     child.on("error", (error) => {
       output.append(error.message);
@@ -68450,11 +68460,11 @@ function installInteractiveInteractionHandler(host) {
       if (!("timeoutMs" in request) || !request.timeoutMs || request.timeoutMs <= 0) {
         return { value: await promise, timedOut: false };
       }
-      return await new Promise((resolve5, reject) => {
-        const timer = setTimeout(() => resolve5({ timedOut: true }), request.timeoutMs);
+      return await new Promise((resolve6, reject) => {
+        const timer = setTimeout(() => resolve6({ timedOut: true }), request.timeoutMs);
         promise.then((value) => {
           clearTimeout(timer);
-          resolve5({ value, timedOut: false });
+          resolve6({ value, timedOut: false });
         }).catch((error) => {
           clearTimeout(timer);
           reject(error);
@@ -68554,15 +68564,15 @@ function showExtensionNotification(host, message, type = "info") {
   host.ui.requestRender();
 }
 function showExtensionSelector2(host, title, options, opts) {
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     host.showStatus(`Waiting for selection: ${title}`);
     if (opts?.signal?.aborted) {
-      resolve5(void 0);
+      resolve6(void 0);
       return;
     }
     const onAbort = () => {
       host.restoreEditor();
-      resolve5(void 0);
+      resolve6(void 0);
     };
     opts?.signal?.addEventListener("abort", onAbort, { once: true });
     const selector = new ExtensionSelectorComponent(
@@ -68571,12 +68581,12 @@ function showExtensionSelector2(host, title, options, opts) {
       (option) => {
         opts?.signal?.removeEventListener("abort", onAbort);
         host.restoreEditor();
-        resolve5(option);
+        resolve6(option);
       },
       () => {
         opts?.signal?.removeEventListener("abort", onAbort);
         host.restoreEditor();
-        resolve5(void 0);
+        resolve6(void 0);
       }
     );
     host.editorContainer.clear();
@@ -68592,15 +68602,15 @@ ${message}`, ["Yes", "No"], opts);
   return result === "Yes";
 }
 function showExtensionInput(host, title, placeholder, opts) {
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     host.showStatus(`Waiting for input: ${title}`);
     if (opts?.signal?.aborted) {
-      resolve5(void 0);
+      resolve6(void 0);
       return;
     }
     const onAbort = () => {
       host.restoreEditor();
-      resolve5(void 0);
+      resolve6(void 0);
     };
     opts?.signal?.addEventListener("abort", onAbort, { once: true });
     const input = new ExtensionInputComponent(
@@ -68609,12 +68619,12 @@ function showExtensionInput(host, title, placeholder, opts) {
       (value) => {
         opts?.signal?.removeEventListener("abort", onAbort);
         host.restoreEditor();
-        resolve5(value);
+        resolve6(value);
       },
       () => {
         opts?.signal?.removeEventListener("abort", onAbort);
         host.restoreEditor();
-        resolve5(void 0);
+        resolve6(void 0);
       }
     );
     host.editorContainer.clear();
@@ -68625,7 +68635,7 @@ function showExtensionInput(host, title, placeholder, opts) {
   });
 }
 function showExtensionEditor(host, title, prefill) {
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     host.showStatus(`Waiting for input: ${title}`);
     const container = new Container();
     container.addChild(new Text(theme.bold(theme.fg("accent", title)), 0, 0));
@@ -68647,12 +68657,12 @@ function showExtensionEditor(host, title, prefill) {
         preview: value.slice(0, 120)
       });
       host.restoreEditor();
-      resolve5(value);
+      resolve6(value);
     };
     editor.onEscape = () => {
       host.logDebug("extension:editor:cancel", { title });
       host.restoreEditor();
-      resolve5(void 0);
+      resolve6(void 0);
     };
     container.addChild(editor);
     container.addChild(new Spacer(1));
@@ -68666,14 +68676,14 @@ function showExtensionEditor(host, title, prefill) {
 }
 function showExtensionCustom(host, factory, options) {
   const savedText = host.editor.getText();
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     let closed = false;
     const close = (result) => {
       if (closed) return;
       closed = true;
       host.restoreEditor();
       host.editor.setText(savedText);
-      resolve5(result);
+      resolve6(result);
     };
     Promise.resolve(factory(host.ui, theme, close)).then((component) => {
       if (closed) return;
@@ -68885,8 +68895,8 @@ async function loadInteractiveExtensions(host) {
   );
   host.extensionRunner.setUIContext(host.extensionUIContext);
   if (process.env.PIE_VERBOSE) {
-    for (const { path: path30, error } of errors) {
-      console.error(`[Extension] Failed to load ${path30}: ${error}`);
+    for (const { path: path31, error } of errors) {
+      console.error(`[Extension] Failed to load ${path31}: ${error}`);
     }
   }
   const extensionTools = convertExtensionTools(extensions);
@@ -69594,6 +69604,17 @@ var CliMissingApiKeyError = class extends Error {
     this.name = "CliMissingApiKeyError";
   }
 };
+var CliSessionResumeError = class extends Error {
+  constructor(sessionId, code, message = code === "session_not_found" ? `Session not found: ${sessionId}` : `Session could not be recovered: ${sessionId}`) {
+    super(message);
+    this.sessionId = sessionId;
+    this.code = code;
+    this.name = "CliSessionResumeError";
+  }
+  sessionId;
+  code;
+  recoverable = true;
+};
 function getCliRuntimePaths() {
   const configDir = getConfigDir();
   const sessionsDir = getSessionsDir();
@@ -69666,10 +69687,17 @@ async function composeCliRuntime(params) {
   const cwd = params.cwd ?? process.cwd();
   const sessionManager = createSessionManager({ sessionsDir: paths.sessionsDir });
   if (params.explicitSessionId) {
+    const sessionFileExists = params.requireExistingSession ? await sessionManager.hasSession(params.explicitSessionId) : false;
     const loaded = await sessionManager.loadSession(params.explicitSessionId, {
       warnIfMissing: params.warnIfExplicitSessionMissing
     });
     if (!loaded) {
+      if (params.requireExistingSession) {
+        throw new CliSessionResumeError(
+          params.explicitSessionId,
+          sessionFileExists ? "session_unrecoverable" : "session_not_found"
+        );
+      }
       await sessionManager.createSession(void 0, void 0, params.explicitSessionId);
     } else {
       const restored = restoreSessionModelState({
@@ -70368,7 +70396,7 @@ async function runJsonEventsMode(params) {
     return typeof message.sessionId === "string" && message.sessionId !== sessionId;
   }
   function delay(ms) {
-    return new Promise((resolve5) => setTimeout(resolve5, Math.max(0, ms)));
+    return new Promise((resolve6) => setTimeout(resolve6, Math.max(0, ms)));
   }
   async function waitForActiveController(timeoutMs = 1e3) {
     const deadline = Date.now() + timeoutMs;
@@ -70487,6 +70515,25 @@ async function runJsonEventsMode(params) {
       display(chunk);
     }
   }
+  function failureDetail(detail) {
+    if (!detail) return { error: "turn failed" };
+    if (typeof detail === "string") return { error: detail };
+    return {
+      error: detail.message,
+      code: detail.code,
+      recoverable: detail.recoverable
+    };
+  }
+  function errorToFailureDetail(error) {
+    if (error instanceof CliSessionResumeError) {
+      return {
+        message: error.message,
+        code: error.code,
+        recoverable: error.recoverable
+      };
+    }
+    return error instanceof Error ? error.message : String(error);
+  }
   function finalize(kind, detail) {
     const turn = activeTurn;
     if (!turn || turn.finalized) return;
@@ -70500,10 +70547,10 @@ async function runJsonEventsMode(params) {
     };
     switch (kind) {
       case "completed":
-        writeEvent({ type: "turn.completed", ...base, summary: (detail ?? turn.summary).trim() });
+        writeEvent({ type: "turn.completed", ...base, summary: (typeof detail === "string" ? detail : turn.summary).trim() });
         break;
       case "failed":
-        writeEvent({ type: "turn.failed", ...base, error: detail || "turn failed" });
+        writeEvent({ type: "turn.failed", ...base, ...failureDetail(detail) });
         break;
       case "cancelled":
         writeEvent({ type: "turn.cancelled", ...base, reason: detail || "interrupted" });
@@ -70736,6 +70783,7 @@ async function runJsonEventsMode(params) {
       cwd: runtime.cwd,
       skillsSection: runtime.skillsSection,
       knowledgeSection: runtime.knowledgeSection,
+      appendSystemPrompt: params.developerInstructions,
       tools: tools.map((tool) => ({ name: tool.name, description: tool.description }))
     });
     agent = new AgentClass({
@@ -70926,7 +70974,7 @@ async function runJsonEventsMode(params) {
     try {
       await ensureRuntime(message.cwd);
     } catch (error) {
-      finalize("failed", error instanceof Error ? error.message : String(error));
+      finalize("failed", errorToFailureDetail(error));
       if (activeTurn === turn) emitSettled(turn);
       if (activeTurn === turn) activeTurn = null;
       return;
@@ -71142,20 +71190,44 @@ async function runJsonEventsMode(params) {
   await disposeRuntime();
 }
 
-// src/cli.ts
-enableEarlyLogBuffer();
-var logError = (msg, err) => {
-  const logPath = getRuntimeLogPath();
-  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-  const stack = err instanceof Error ? err.stack || "" : "";
-  fs26.mkdirSync(path29.dirname(logPath), { recursive: true });
-  fs26.appendFileSync(logPath, `[${timestamp}] ${msg}
-${stack}
+// src/developer-instructions.ts
+import * as fs26 from "fs";
+import * as path29 from "path";
+var MAX_DEVELOPER_INSTRUCTIONS_CHARS = 64e3;
+function readTextFileBounded(filePath) {
+  const resolved = path29.resolve(filePath);
+  const stat2 = fs26.statSync(resolved);
+  if (!stat2.isFile()) {
+    throw new Error(`Developer instructions file is not a regular file: ${filePath}`);
+  }
+  if (stat2.size > MAX_DEVELOPER_INSTRUCTIONS_CHARS * 4) {
+    throw new Error(`Developer instructions file is too large: ${filePath}`);
+  }
+  return fs26.readFileSync(resolved, "utf8");
+}
+function collectFlagValues(args, flag) {
+  const values = [];
+  for (let i = 0; i < args.length; i += 1) {
+    if (args[i] === flag && args[i + 1]) {
+      values.push(args[i + 1]);
+      i += 1;
+    }
+  }
+  return values;
+}
+function resolveDeveloperInstructionsFromArgs(args) {
+  const direct = collectFlagValues(args, "--developer-instructions");
+  const files = collectFlagValues(args, "--developer-instructions-file").map(readTextFileBounded);
+  const parts = [...direct, ...files].map((part) => part.trim()).filter(Boolean);
+  if (parts.length === 0) return void 0;
+  const combined = parts.join("\n\n");
+  if (combined.length > MAX_DEVELOPER_INSTRUCTIONS_CHARS) {
+    throw new Error(`Developer instructions exceed ${MAX_DEVELOPER_INSTRUCTIONS_CHARS} characters`);
+  }
+  return combined;
+}
 
-`);
-};
-setupGlobalErrorHandlers(logError);
-migrateConfigFromAgentDir();
+// src/cli-help.ts
 function showHelp() {
   console.log(`
 Pie AI Agent CLI
@@ -71194,11 +71266,37 @@ Print Mode Options:
   --json-output    Print structured JSON in non-interactive mode
   --json-events    Run JSONL protocol mode over stdin/stdout
   --session-id     Reuse or create a specific session in non-interactive mode
+  --resume-required  In JSON-events mode, fail if --session-id cannot be resumed
+  --developer-instructions <text>  Append stable host/developer instructions in JSON-events mode
+  --developer-instructions-file <path>  Read stable host/developer instructions from a file
   --extension-path Add an extra extension search directory (repeatable)
   --no-builtin-extensions  Skip built-in extensions (keep user/project ones)
   --no-extensions    Skip all discovered extensions (keeps --extension-path)
 `);
 }
+
+// src/cli.ts
+enableEarlyLogBuffer();
+var logError = (msg, err) => {
+  const logPath = getRuntimeLogPath();
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const stack = err instanceof Error ? err.stack || "" : "";
+  fs27.mkdirSync(path30.dirname(logPath), { recursive: true });
+  fs27.appendFileSync(logPath, `[${timestamp}] ${msg}
+${stack}
+
+`);
+};
+setupGlobalErrorHandlers(logError);
+migrateConfigFromAgentDir();
+var STABLE_CLI_COMMANDS = {
+  chat: "chat",
+  doctor: "doctor",
+  models: "models",
+  sessions: "sessions",
+  extensions: "extensions",
+  permissions: "permissions"
+};
 async function runDoctorCommand(args) {
   const json = args.includes("--json");
   const report = await runDoctor();
@@ -71273,16 +71371,6 @@ async function runModelsCommand(args) {
   pie models init [--path <path>] [--force] [--stdout]
   pie models validate [--path <path>] [--probe web_search] [--json]`);
 }
-function parseRepeatedFlag(args, flag) {
-  const values = [];
-  for (let i = 0; i < args.length; i += 1) {
-    if (args[i] === flag && args[i + 1]) {
-      values.push(args[i + 1]);
-      i += 1;
-    }
-  }
-  return values;
-}
 async function runWithJsonEventsConsoleIsolation(fn) {
   const originalLog = console.log;
   const originalInfo = console.info;
@@ -71301,34 +71389,47 @@ async function runWithJsonEventsConsoleIsolation(fn) {
 }
 async function createCliTestStreamFnFromEnv() {
   if (!process.env.PIE_TEST_MOCK_STREAM_SEQUENCE) return void 0;
-  return (await import("./chunks/test-stream-A7JSM2UM.js")).createTestStreamFnFromSequenceEnv();
+  return (await import("./chunks/test-stream-L4PUYWQQ.js")).createTestStreamFnFromSequenceEnv();
 }
 async function startChat(initialPrompt, testCommand) {
   const rawOutput = process.argv.includes("--raw-output");
   const jsonOutput = process.argv.includes("--json-output");
   const jsonEvents = process.argv.includes("--json-events");
+  const resumeRequired = process.argv.includes("--resume-required");
   const sessionIdFlagIndex = process.argv.indexOf("--session-id");
   const explicitSessionId = sessionIdFlagIndex >= 0 ? process.argv[sessionIdFlagIndex + 1] : void 0;
   const extensionPaths = parseRepeatedFlag(process.argv, "--extension-path");
   const extensionFlags = parseExtensionFlags(process.argv);
   if (jsonEvents) {
+    let developerInstructions;
+    try {
+      developerInstructions = resolveDeveloperInstructionsFromArgs(process.argv);
+    } catch (error) {
+      console.error(error instanceof Error ? `Error: ${error.message}` : String(error));
+      process.exit(1);
+    }
     await runWithJsonEventsConsoleIsolation(async () => {
       if (process.env.PIE_TEST_MOCK_RESPONSE !== void 0) {
         await runJsonEventsMode({
           explicitSessionId,
+          resumeRequired,
+          developerInstructions,
           mockResponse: process.env.PIE_TEST_MOCK_RESPONSE
         });
         return;
       }
       await runJsonEventsMode({
         explicitSessionId,
+        resumeRequired,
+        developerInstructions,
         streamFn: await createCliTestStreamFnFromEnv(),
         createRuntime: async ({ cwd, sessionId }) => composeCliRuntime({
           explicitSessionId: explicitSessionId ?? sessionId,
           extensionPaths,
           extensionFlags,
           cwd,
-          warnIfExplicitSessionMissing: false
+          warnIfExplicitSessionMissing: false,
+          requireExistingSession: resumeRequired && !!explicitSessionId
         })
       });
     });
@@ -71383,9 +71484,9 @@ async function startChat(initialPrompt, testCommand) {
     flushEarlyLogs();
     if (testCommand) {
       console.log(`[TEST] Auto-executing command: ${testCommand}`);
-      await new Promise((resolve5) => setTimeout(resolve5, 500));
+      await new Promise((resolve6) => setTimeout(resolve6, 500));
       await interactive.executeCommand(testCommand);
-      await new Promise((resolve5) => setTimeout(resolve5, 2e3));
+      await new Promise((resolve6) => setTimeout(resolve6, 2e3));
       console.log("[TEST] Command executed, exiting...");
       process.exit(0);
       return;
@@ -71406,11 +71507,11 @@ async function main() {
     console.log(VERSION);
     return;
   }
-  if (args[0] === "doctor") {
+  if (args[0] === STABLE_CLI_COMMANDS.doctor) {
     await runDoctorCommand(args.slice(1));
     return;
   }
-  if (args[0] === "models") {
+  if (args[0] === STABLE_CLI_COMMANDS.models) {
     try {
       await runModelsCommand(args.slice(1));
     } catch (error) {
@@ -71419,15 +71520,15 @@ async function main() {
     }
     return;
   }
-  if (args[0] === "sessions") {
+  if (args[0] === STABLE_CLI_COMMANDS.sessions) {
     await runSessionsCommand(args.slice(1));
     return;
   }
-  if (args[0] === "extensions") {
+  if (args[0] === STABLE_CLI_COMMANDS.extensions) {
     await runExtensionsCommand(args.slice(1));
     return;
   }
-  if (args[0] === "permissions") {
+  if (args[0] === STABLE_CLI_COMMANDS.permissions) {
     console.log(formatPermissionsHelp());
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cydm/pie",
-	"version": "1.0.34",
+	"version": "1.0.36",
 	"description": "Pie AI Agent CLI",
 	"type": "module",
 	"bin": {