oh-my-opencode 3.8.1 → 3.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/dist/agents/atlas/agent.d.ts +3 -2
  2. package/dist/agents/atlas/gemini.d.ts +11 -0
  3. package/dist/agents/atlas/index.d.ts +1 -0
  4. package/dist/agents/prometheus/gemini.d.ts +12 -0
  5. package/dist/agents/prometheus/index.d.ts +1 -0
  6. package/dist/agents/prometheus/system-prompt.d.ts +2 -1
  7. package/dist/agents/sisyphus-gemini-overlays.d.ts +15 -0
  8. package/dist/agents/sisyphus-junior/agent.d.ts +3 -2
  9. package/dist/agents/sisyphus-junior/gemini.d.ts +10 -0
  10. package/dist/agents/sisyphus-junior/index.d.ts +1 -0
  11. package/dist/agents/types.d.ts +1 -0
  12. package/dist/cli/index.js +8 -8
  13. package/dist/hooks/atlas/system-reminder-templates.d.ts +1 -0
  14. package/dist/hooks/session-notification.d.ts +2 -0
  15. package/dist/index.js +1999 -367
  16. package/dist/shared/command-executor/execute-hook-command.d.ts +2 -0
  17. package/dist/shared/session-tools-store.d.ts +1 -0
  18. package/dist/tools/glob/constants.d.ts +1 -1
  19. package/dist/tools/glob/types.d.ts +1 -0
  20. package/dist/tools/grep/constants.d.ts +2 -1
  21. package/dist/tools/grep/types.d.ts +3 -0
  22. package/dist/tools/hashline-edit/autocorrect-replacement-lines.d.ts +6 -0
  23. package/dist/tools/hashline-edit/edit-deduplication.d.ts +5 -0
  24. package/dist/tools/hashline-edit/edit-operation-primitives.d.ts +12 -0
  25. package/dist/tools/hashline-edit/edit-operations.d.ts +1 -6
  26. package/dist/tools/hashline-edit/edit-ordering.d.ts +3 -0
  27. package/dist/tools/hashline-edit/file-text-canonicalization.d.ts +7 -0
  28. package/dist/tools/hashline-edit/hashline-edit-diff.d.ts +1 -0
  29. package/dist/tools/hashline-edit/hashline-edit-executor.d.ts +10 -0
  30. package/dist/tools/hashline-edit/index.d.ts +1 -1
  31. package/dist/tools/hashline-edit/tool-description.d.ts +1 -1
  32. package/dist/tools/hashline-edit/types.d.ts +9 -1
  33. package/dist/tools/lsp/lsp-manager-process-cleanup.d.ts +4 -1
  34. package/dist/tools/lsp/lsp-server.d.ts +2 -1
  35. package/dist/tools/shared/semaphore.d.ts +14 -0
  36. package/package.json +8 -8
package/dist/index.js CHANGED
@@ -15029,8 +15029,11 @@ function findBashPath() {
15029
15029
  }
15030
15030
 
15031
15031
  // src/shared/command-executor/execute-hook-command.ts
15032
+ var DEFAULT_HOOK_TIMEOUT_MS = 30000;
15033
+ var SIGKILL_GRACE_MS = 5000;
15032
15034
  async function executeHookCommand(command, stdin, cwd, options) {
15033
15035
  const home = getHomeDirectory();
15036
+ const timeoutMs = options?.timeoutMs ?? DEFAULT_HOOK_TIMEOUT_MS;
15034
15037
  const expandedCommand = command.replace(/^~(?=\/|$)/g, home).replace(/\s~(?=\/)/g, ` ${home}`).replace(/\$CLAUDE_PROJECT_DIR/g, cwd).replace(/\$\{CLAUDE_PROJECT_DIR\}/g, cwd);
15035
15038
  let finalCommand = expandedCommand;
15036
15039
  if (options?.forceZsh) {
@@ -15046,9 +15049,13 @@ async function executeHookCommand(command, stdin, cwd, options) {
15046
15049
  }
15047
15050
  }
15048
15051
  return new Promise((resolve) => {
15052
+ let settled = false;
15053
+ let killTimer = null;
15054
+ const isWin32 = process.platform === "win32";
15049
15055
  const proc = spawn(finalCommand, {
15050
15056
  cwd,
15051
15057
  shell: true,
15058
+ detached: !isWin32,
15052
15059
  env: { ...process.env, HOME: home, CLAUDE_PROJECT_DIR: cwd }
15053
15060
  });
15054
15061
  let stdout = "";
@@ -15059,18 +15066,57 @@ async function executeHookCommand(command, stdin, cwd, options) {
15059
15066
  proc.stderr?.on("data", (data) => {
15060
15067
  stderr += data.toString();
15061
15068
  });
15069
+ proc.stdin?.on("error", () => {});
15062
15070
  proc.stdin?.write(stdin);
15063
15071
  proc.stdin?.end();
15072
+ const settle = (result) => {
15073
+ if (settled)
15074
+ return;
15075
+ settled = true;
15076
+ if (killTimer)
15077
+ clearTimeout(killTimer);
15078
+ if (timeoutTimer)
15079
+ clearTimeout(timeoutTimer);
15080
+ resolve(result);
15081
+ };
15064
15082
  proc.on("close", (code) => {
15065
- resolve({
15066
- exitCode: code ?? 0,
15083
+ settle({
15084
+ exitCode: code ?? 1,
15067
15085
  stdout: stdout.trim(),
15068
15086
  stderr: stderr.trim()
15069
15087
  });
15070
15088
  });
15071
15089
  proc.on("error", (err) => {
15072
- resolve({ exitCode: 1, stderr: err.message });
15090
+ settle({ exitCode: 1, stderr: err.message });
15073
15091
  });
15092
+ const killProcessGroup = (signal) => {
15093
+ try {
15094
+ if (!isWin32 && proc.pid) {
15095
+ try {
15096
+ process.kill(-proc.pid, signal);
15097
+ } catch {
15098
+ proc.kill(signal);
15099
+ }
15100
+ } else {
15101
+ proc.kill(signal);
15102
+ }
15103
+ } catch {}
15104
+ };
15105
+ const timeoutTimer = setTimeout(() => {
15106
+ if (settled)
15107
+ return;
15108
+ killProcessGroup("SIGTERM");
15109
+ killTimer = setTimeout(() => {
15110
+ if (settled)
15111
+ return;
15112
+ killProcessGroup("SIGKILL");
15113
+ }, SIGKILL_GRACE_MS);
15114
+ stderr += `
15115
+ Hook command timed out after ${timeoutMs}ms`;
15116
+ }, timeoutMs);
15117
+ if (timeoutTimer && typeof timeoutTimer === "object" && "unref" in timeoutTimer) {
15118
+ timeoutTimer.unref();
15119
+ }
15074
15120
  });
15075
15121
  }
15076
15122
  // src/shared/command-executor/execute-command.ts
@@ -19037,6 +19083,9 @@ function getSessionTools(sessionID) {
19037
19083
  const tools = store.get(sessionID);
19038
19084
  return tools ? { ...tools } : undefined;
19039
19085
  }
19086
+ function deleteSessionTools(sessionID) {
19087
+ store.delete(sessionID);
19088
+ }
19040
19089
 
19041
19090
  // src/shared/prompt-tools.ts
19042
19091
  function normalizePromptTools(tools) {
@@ -20047,6 +20096,8 @@ function createSessionNotification(ctx, config = {}) {
20047
20096
  const mergedConfig = {
20048
20097
  title: "OpenCode",
20049
20098
  message: "Agent is ready for input",
20099
+ questionMessage: "Agent is asking a question",
20100
+ permissionMessage: "Agent needs permission to continue",
20050
20101
  playSound: false,
20051
20102
  soundPath: defaultSoundPath,
20052
20103
  idleConfirmationDelay: 1500,
@@ -20062,6 +20113,51 @@ function createSessionNotification(ctx, config = {}) {
20062
20113
  send: sendSessionNotification,
20063
20114
  playSound: playSessionNotificationSound
20064
20115
  });
20116
+ const QUESTION_TOOLS = new Set(["question", "ask_user_question", "askuserquestion"]);
20117
+ const PERMISSION_EVENTS = new Set(["permission.ask", "permission.asked", "permission.updated", "permission.requested"]);
20118
+ const PERMISSION_HINT_PATTERN = /\b(permission|approve|approval|allow|deny|consent)\b/i;
20119
+ const getSessionID = (properties) => {
20120
+ const sessionID = properties?.sessionID;
20121
+ if (typeof sessionID === "string" && sessionID.length > 0)
20122
+ return sessionID;
20123
+ const sessionId = properties?.sessionId;
20124
+ if (typeof sessionId === "string" && sessionId.length > 0)
20125
+ return sessionId;
20126
+ const info = properties?.info;
20127
+ const infoSessionID = info?.sessionID;
20128
+ if (typeof infoSessionID === "string" && infoSessionID.length > 0)
20129
+ return infoSessionID;
20130
+ const infoSessionId = info?.sessionId;
20131
+ if (typeof infoSessionId === "string" && infoSessionId.length > 0)
20132
+ return infoSessionId;
20133
+ return;
20134
+ };
20135
+ const shouldNotifyForSession = (sessionID) => {
20136
+ if (subagentSessions.has(sessionID))
20137
+ return false;
20138
+ const mainSessionID = getMainSessionID();
20139
+ if (mainSessionID && sessionID !== mainSessionID)
20140
+ return false;
20141
+ return true;
20142
+ };
20143
+ const getEventToolName = (properties) => {
20144
+ const tool = properties?.tool;
20145
+ if (typeof tool === "string" && tool.length > 0)
20146
+ return tool;
20147
+ const name = properties?.name;
20148
+ if (typeof name === "string" && name.length > 0)
20149
+ return name;
20150
+ return;
20151
+ };
20152
+ const getQuestionText = (properties) => {
20153
+ const args = properties?.args;
20154
+ const questions = args?.questions;
20155
+ if (!Array.isArray(questions) || questions.length === 0)
20156
+ return "";
20157
+ const firstQuestion = questions[0];
20158
+ const questionText = firstQuestion?.question;
20159
+ return typeof questionText === "string" ? questionText : "";
20160
+ };
20065
20161
  return async ({ event }) => {
20066
20162
  if (currentPlatform === "unsupported")
20067
20163
  return;
@@ -20075,29 +20171,52 @@ function createSessionNotification(ctx, config = {}) {
20075
20171
  return;
20076
20172
  }
20077
20173
  if (event.type === "session.idle") {
20078
- const sessionID = props?.sessionID;
20174
+ const sessionID = getSessionID(props);
20079
20175
  if (!sessionID)
20080
20176
  return;
20081
- if (subagentSessions.has(sessionID))
20082
- return;
20083
- const mainSessionID = getMainSessionID();
20084
- if (mainSessionID && sessionID !== mainSessionID)
20177
+ if (!shouldNotifyForSession(sessionID))
20085
20178
  return;
20086
20179
  scheduler.scheduleIdleNotification(sessionID);
20087
20180
  return;
20088
20181
  }
20089
20182
  if (event.type === "message.updated") {
20090
20183
  const info = props?.info;
20091
- const sessionID = info?.sessionID;
20184
+ const sessionID = getSessionID({ ...props, info });
20092
20185
  if (sessionID) {
20093
20186
  scheduler.markSessionActivity(sessionID);
20094
20187
  }
20095
20188
  return;
20096
20189
  }
20190
+ if (PERMISSION_EVENTS.has(event.type)) {
20191
+ const sessionID = getSessionID(props);
20192
+ if (!sessionID)
20193
+ return;
20194
+ if (!shouldNotifyForSession(sessionID))
20195
+ return;
20196
+ scheduler.markSessionActivity(sessionID);
20197
+ await sendSessionNotification(ctx, currentPlatform, mergedConfig.title, mergedConfig.permissionMessage);
20198
+ if (mergedConfig.playSound && mergedConfig.soundPath) {
20199
+ await playSessionNotificationSound(ctx, currentPlatform, mergedConfig.soundPath);
20200
+ }
20201
+ return;
20202
+ }
20097
20203
  if (event.type === "tool.execute.before" || event.type === "tool.execute.after") {
20098
- const sessionID = props?.sessionID;
20204
+ const sessionID = getSessionID(props);
20099
20205
  if (sessionID) {
20100
20206
  scheduler.markSessionActivity(sessionID);
20207
+ if (event.type === "tool.execute.before") {
20208
+ const toolName = getEventToolName(props)?.toLowerCase();
20209
+ if (toolName && QUESTION_TOOLS.has(toolName)) {
20210
+ if (!shouldNotifyForSession(sessionID))
20211
+ return;
20212
+ const questionText = getQuestionText(props);
20213
+ const message = PERMISSION_HINT_PATTERN.test(questionText) ? mergedConfig.permissionMessage : mergedConfig.questionMessage;
20214
+ await sendSessionNotification(ctx, currentPlatform, mergedConfig.title, message);
20215
+ if (mergedConfig.playSound && mergedConfig.soundPath) {
20216
+ await playSessionNotificationSound(ctx, currentPlatform, mergedConfig.soundPath);
20217
+ }
20218
+ }
20219
+ }
20101
20220
  }
20102
20221
  return;
20103
20222
  }
@@ -38863,6 +38982,15 @@ function isGptModel(model) {
38863
38982
  const modelName = extractModelName(model).toLowerCase();
38864
38983
  return GPT_MODEL_PREFIXES.some((prefix) => modelName.startsWith(prefix));
38865
38984
  }
38985
+ var GEMINI_PROVIDERS = ["google/", "google-vertex/"];
38986
+ function isGeminiModel(model) {
38987
+ if (GEMINI_PROVIDERS.some((prefix) => model.startsWith(prefix)))
38988
+ return true;
38989
+ if (model.startsWith("github-copilot/") && extractModelName(model).toLowerCase().startsWith("gemini"))
38990
+ return true;
38991
+ const modelName = extractModelName(model).toLowerCase();
38992
+ return modelName.startsWith("gemini-");
38993
+ }
38866
38994
 
38867
38995
  // src/hooks/keyword-detector/ultrawork/source-detector.ts
38868
38996
  function isPlannerAgent(agentName) {
@@ -48710,10 +48838,9 @@ function createRuntimeFallbackHook(ctx, options) {
48710
48838
  }
48711
48839
  // src/hooks/write-existing-file-guard/hook.ts
48712
48840
  import { existsSync as existsSync48, realpathSync as realpathSync4 } from "fs";
48713
- import { basename as basename4, dirname as dirname15, isAbsolute as isAbsolute7, join as join59, normalize, relative as relative5, resolve as resolve7, sep } from "path";
48841
+ import { basename as basename4, dirname as dirname15, isAbsolute as isAbsolute7, join as join59, normalize, relative as relative5, resolve as resolve7 } from "path";
48714
48842
  var MAX_TRACKED_SESSIONS = 256;
48715
48843
  var MAX_TRACKED_PATHS_PER_SESSION = 1024;
48716
- var OUTSIDE_SESSION_MESSAGE = "Path must be inside session directory.";
48717
48844
  function asRecord(value) {
48718
48845
  if (!value || typeof value !== "object" || Array.isArray(value)) {
48719
48846
  return;
@@ -48758,7 +48885,6 @@ function createWriteExistingFileGuardHook(ctx) {
48758
48885
  const readPermissionsBySession = new Map;
48759
48886
  const sessionLastAccess = new Map;
48760
48887
  const canonicalSessionRoot = toCanonicalPath(resolveInputPath(ctx, ctx.directory));
48761
- const sisyphusRoot = join59(canonicalSessionRoot, ".sisyphus") + sep;
48762
48888
  const touchSession = (sessionID) => {
48763
48889
  sessionLastAccess.set(sessionID, Date.now());
48764
48890
  };
@@ -48839,15 +48965,7 @@ function createWriteExistingFileGuardHook(ctx) {
48839
48965
  const canonicalPath = toCanonicalPath(resolvedPath);
48840
48966
  const isInsideSessionDirectory = isPathInsideDirectory(canonicalPath, canonicalSessionRoot);
48841
48967
  if (!isInsideSessionDirectory) {
48842
- if (toolName === "read") {
48843
- return;
48844
- }
48845
- log("[write-existing-file-guard] Blocking write outside session directory", {
48846
- sessionID: input.sessionID,
48847
- filePath,
48848
- resolvedPath
48849
- });
48850
- throw new Error(OUTSIDE_SESSION_MESSAGE);
48968
+ return;
48851
48969
  }
48852
48970
  if (toolName === "read") {
48853
48971
  if (!existsSync48(resolvedPath) || !input.sessionID) {
@@ -48863,7 +48981,7 @@ function createWriteExistingFileGuardHook(ctx) {
48863
48981
  if (!existsSync48(resolvedPath)) {
48864
48982
  return;
48865
48983
  }
48866
- const isSisyphusPath2 = canonicalPath.startsWith(sisyphusRoot);
48984
+ const isSisyphusPath2 = canonicalPath.includes("/.sisyphus/");
48867
48985
  if (isSisyphusPath2) {
48868
48986
  log("[write-existing-file-guard] Allowing .sisyphus/** overwrite", {
48869
48987
  sessionID: input.sessionID,
@@ -49831,55 +49949,6 @@ function spawnProcess(command, options) {
49831
49949
  });
49832
49950
  return proc;
49833
49951
  }
49834
- // src/tools/lsp/lsp-manager-process-cleanup.ts
49835
- function registerLspManagerProcessCleanup(options) {
49836
- const syncCleanup = () => {
49837
- for (const [, managed] of options.getClients()) {
49838
- try {
49839
- managed.client.stop().catch(() => {});
49840
- } catch {}
49841
- }
49842
- options.clearClients();
49843
- options.clearCleanupInterval();
49844
- };
49845
- const asyncCleanup = async () => {
49846
- const stopPromises = [];
49847
- for (const [, managed] of options.getClients()) {
49848
- stopPromises.push(managed.client.stop().catch(() => {}));
49849
- }
49850
- await Promise.allSettled(stopPromises);
49851
- options.clearClients();
49852
- options.clearCleanupInterval();
49853
- };
49854
- process.on("exit", syncCleanup);
49855
- process.on("SIGINT", () => void asyncCleanup().catch(() => {}));
49856
- process.on("SIGTERM", () => void asyncCleanup().catch(() => {}));
49857
- if (process.platform === "win32") {
49858
- process.on("SIGBREAK", () => void asyncCleanup().catch(() => {}));
49859
- }
49860
- }
49861
-
49862
- // src/tools/lsp/lsp-manager-temp-directory-cleanup.ts
49863
- async function cleanupTempDirectoryLspClients(clients) {
49864
- const keysToRemove = [];
49865
- for (const [key, managed] of clients.entries()) {
49866
- const isTempDir = key.startsWith("/tmp/") || key.startsWith("/var/folders/");
49867
- const isIdle = managed.refCount === 0;
49868
- if (isTempDir && isIdle) {
49869
- keysToRemove.push(key);
49870
- }
49871
- }
49872
- for (const key of keysToRemove) {
49873
- const managed = clients.get(key);
49874
- if (managed) {
49875
- clients.delete(key);
49876
- try {
49877
- await managed.client.stop();
49878
- } catch {}
49879
- }
49880
- }
49881
- }
49882
-
49883
49952
  // src/tools/lsp/lsp-client.ts
49884
49953
  import { readFileSync as readFileSync38 } from "fs";
49885
49954
  import { extname as extname2, resolve as resolve8 } from "path";
@@ -50241,6 +50310,69 @@ class LSPClient extends LSPClientConnection {
50241
50310
  }
50242
50311
  }
50243
50312
 
50313
+ // src/tools/lsp/lsp-manager-process-cleanup.ts
50314
+ function registerLspManagerProcessCleanup(options) {
50315
+ const handlers = [];
50316
+ const syncCleanup = () => {
50317
+ for (const [, managed] of options.getClients()) {
50318
+ try {
50319
+ managed.client.stop().catch(() => {});
50320
+ } catch {}
50321
+ }
50322
+ options.clearClients();
50323
+ options.clearCleanupInterval();
50324
+ };
50325
+ const asyncCleanup = async () => {
50326
+ const stopPromises = [];
50327
+ for (const [, managed] of options.getClients()) {
50328
+ stopPromises.push(managed.client.stop().catch(() => {}));
50329
+ }
50330
+ await Promise.allSettled(stopPromises);
50331
+ options.clearClients();
50332
+ options.clearCleanupInterval();
50333
+ };
50334
+ const registerHandler = (event, listener) => {
50335
+ handlers.push({ event, listener });
50336
+ process.on(event, listener);
50337
+ };
50338
+ registerHandler("exit", syncCleanup);
50339
+ const signalCleanup = () => void asyncCleanup().catch(() => {});
50340
+ registerHandler("SIGINT", signalCleanup);
50341
+ registerHandler("SIGTERM", signalCleanup);
50342
+ if (process.platform === "win32") {
50343
+ registerHandler("SIGBREAK", signalCleanup);
50344
+ }
50345
+ return {
50346
+ unregister: () => {
50347
+ for (const { event, listener } of handlers) {
50348
+ process.off(event, listener);
50349
+ }
50350
+ handlers.length = 0;
50351
+ }
50352
+ };
50353
+ }
50354
+
50355
+ // src/tools/lsp/lsp-manager-temp-directory-cleanup.ts
50356
+ async function cleanupTempDirectoryLspClients(clients) {
50357
+ const keysToRemove = [];
50358
+ for (const [key, managed] of clients.entries()) {
50359
+ const isTempDir = key.startsWith("/tmp/") || key.startsWith("/var/folders/");
50360
+ const isIdle = managed.refCount === 0;
50361
+ if (isTempDir && isIdle) {
50362
+ keysToRemove.push(key);
50363
+ }
50364
+ }
50365
+ for (const key of keysToRemove) {
50366
+ const managed = clients.get(key);
50367
+ if (managed) {
50368
+ clients.delete(key);
50369
+ try {
50370
+ await managed.client.stop();
50371
+ } catch {}
50372
+ }
50373
+ }
50374
+ }
50375
+
50244
50376
  // src/tools/lsp/lsp-server.ts
50245
50377
  class LSPServerManager {
50246
50378
  static instance;
@@ -50248,12 +50380,13 @@ class LSPServerManager {
50248
50380
  cleanupInterval = null;
50249
50381
  IDLE_TIMEOUT = 5 * 60 * 1000;
50250
50382
  INIT_TIMEOUT = 60 * 1000;
50383
+ cleanupHandle = null;
50251
50384
  constructor() {
50252
50385
  this.startCleanupTimer();
50253
50386
  this.registerProcessCleanup();
50254
50387
  }
50255
50388
  registerProcessCleanup() {
50256
- registerLspManagerProcessCleanup({
50389
+ this.cleanupHandle = registerLspManagerProcessCleanup({
50257
50390
  getClients: () => this.clients.entries(),
50258
50391
  clearClients: () => {
50259
50392
  this.clients.clear();
@@ -50403,6 +50536,8 @@ class LSPServerManager {
50403
50536
  return managed?.isInitializing ?? false;
50404
50537
  }
50405
50538
  async stopAll() {
50539
+ this.cleanupHandle?.unregister();
50540
+ this.cleanupHandle = null;
50406
50541
  for (const [, managed] of this.clients) {
50407
50542
  await managed.client.stop();
50408
50543
  }
@@ -51663,8 +51798,9 @@ var DEFAULT_MAX_DEPTH = 20;
51663
51798
  var DEFAULT_MAX_FILESIZE = "10M";
51664
51799
  var DEFAULT_MAX_COUNT = 500;
51665
51800
  var DEFAULT_MAX_COLUMNS = 1000;
51666
- var DEFAULT_TIMEOUT_MS3 = 300000;
51667
- var DEFAULT_MAX_OUTPUT_BYTES2 = 10 * 1024 * 1024;
51801
+ var DEFAULT_TIMEOUT_MS3 = 60000;
51802
+ var DEFAULT_MAX_OUTPUT_BYTES2 = 256 * 1024;
51803
+ var DEFAULT_RG_THREADS = 4;
51668
51804
  var RG_SAFETY_FLAGS = [
51669
51805
  "--no-follow",
51670
51806
  "--color=never",
@@ -51674,10 +51810,40 @@ var RG_SAFETY_FLAGS = [
51674
51810
  ];
51675
51811
  var GREP_SAFETY_FLAGS = ["-n", "-H", "--color=never"];
51676
51812
 
51813
+ // src/tools/shared/semaphore.ts
51814
+ class Semaphore {
51815
+ max;
51816
+ queue = [];
51817
+ running = 0;
51818
+ constructor(max) {
51819
+ this.max = max;
51820
+ }
51821
+ async acquire() {
51822
+ if (this.running < this.max) {
51823
+ this.running++;
51824
+ return;
51825
+ }
51826
+ return new Promise((resolve10) => {
51827
+ this.queue.push(() => {
51828
+ this.running++;
51829
+ resolve10();
51830
+ });
51831
+ });
51832
+ }
51833
+ release() {
51834
+ this.running--;
51835
+ const next = this.queue.shift();
51836
+ if (next)
51837
+ next();
51838
+ }
51839
+ }
51840
+ var rgSemaphore = new Semaphore(2);
51841
+
51677
51842
  // src/tools/grep/cli.ts
51678
51843
  function buildRgArgs(options) {
51679
51844
  const args = [
51680
51845
  ...RG_SAFETY_FLAGS,
51846
+ `--threads=${Math.min(options.threads ?? DEFAULT_RG_THREADS, DEFAULT_RG_THREADS)}`,
51681
51847
  `--max-depth=${Math.min(options.maxDepth ?? DEFAULT_MAX_DEPTH, DEFAULT_MAX_DEPTH)}`,
51682
51848
  `--max-filesize=${options.maxFilesize ?? DEFAULT_MAX_FILESIZE}`,
51683
51849
  `--max-count=${Math.min(options.maxCount ?? DEFAULT_MAX_COUNT, DEFAULT_MAX_COUNT)}`,
@@ -51713,6 +51879,11 @@ function buildRgArgs(options) {
51713
51879
  args.push(`--glob=!${glob}`);
51714
51880
  }
51715
51881
  }
51882
+ if (options.outputMode === "files_with_matches") {
51883
+ args.push("--files-with-matches");
51884
+ } else if (options.outputMode === "count") {
51885
+ args.push("--count");
51886
+ }
51716
51887
  return args;
51717
51888
  }
51718
51889
  function buildGrepArgs(options) {
@@ -51742,7 +51913,7 @@ function buildGrepArgs(options) {
51742
51913
  function buildArgs(options, backend) {
51743
51914
  return backend === "rg" ? buildRgArgs(options) : buildGrepArgs(options);
51744
51915
  }
51745
- function parseOutput(output) {
51916
+ function parseOutput(output, filesOnly = false) {
51746
51917
  if (!output.trim())
51747
51918
  return [];
51748
51919
  const matches = [];
@@ -51751,6 +51922,14 @@ function parseOutput(output) {
51751
51922
  for (const line of lines) {
51752
51923
  if (!line.trim())
51753
51924
  continue;
51925
+ if (filesOnly) {
51926
+ matches.push({
51927
+ file: line.trim(),
51928
+ line: 0,
51929
+ text: ""
51930
+ });
51931
+ continue;
51932
+ }
51754
51933
  const match = line.match(/^(.+?):(\d+):(.*)$/);
51755
51934
  if (match) {
51756
51935
  matches.push({
@@ -51762,7 +51941,34 @@ function parseOutput(output) {
51762
51941
  }
51763
51942
  return matches;
51764
51943
  }
51944
+ function parseCountOutput(output) {
51945
+ if (!output.trim())
51946
+ return [];
51947
+ const results = [];
51948
+ const lines = output.split(`
51949
+ `);
51950
+ for (const line of lines) {
51951
+ if (!line.trim())
51952
+ continue;
51953
+ const match = line.match(/^(.+?):(\d+)$/);
51954
+ if (match) {
51955
+ results.push({
51956
+ file: match[1],
51957
+ count: parseInt(match[2], 10)
51958
+ });
51959
+ }
51960
+ }
51961
+ return results;
51962
+ }
51765
51963
  async function runRg(options) {
51964
+ await rgSemaphore.acquire();
51965
+ try {
51966
+ return await runRgInternal(options);
51967
+ } finally {
51968
+ rgSemaphore.release();
51969
+ }
51970
+ }
51971
+ async function runRgInternal(options) {
51766
51972
  const cli = resolveGrepCli();
51767
51973
  const args = buildArgs(options, cli.backend);
51768
51974
  const timeout = Math.min(options.timeout ?? DEFAULT_TIMEOUT_MS3, DEFAULT_TIMEOUT_MS3);
@@ -51799,13 +52005,14 @@ async function runRg(options) {
51799
52005
  error: stderr.trim()
51800
52006
  };
51801
52007
  }
51802
- const matches = parseOutput(outputToProcess);
51803
- const filesSearched = new Set(matches.map((m) => m.file)).size;
52008
+ const matches = parseOutput(outputToProcess, options.outputMode === "files_with_matches");
52009
+ const limited = options.headLimit && options.headLimit > 0 ? matches.slice(0, options.headLimit) : matches;
52010
+ const filesSearched = new Set(limited.map((m) => m.file)).size;
51804
52011
  return {
51805
- matches,
51806
- totalMatches: matches.length,
52012
+ matches: limited,
52013
+ totalMatches: limited.length,
51807
52014
  filesSearched,
51808
- truncated
52015
+ truncated: truncated || (options.headLimit ? matches.length > options.headLimit : false)
51809
52016
  };
51810
52017
  } catch (e) {
51811
52018
  return {
@@ -51817,6 +52024,43 @@ async function runRg(options) {
51817
52024
  };
51818
52025
  }
51819
52026
  }
52027
+ async function runRgCount(options) {
52028
+ await rgSemaphore.acquire();
52029
+ try {
52030
+ return await runRgCountInternal(options);
52031
+ } finally {
52032
+ rgSemaphore.release();
52033
+ }
52034
+ }
52035
+ async function runRgCountInternal(options) {
52036
+ const cli = resolveGrepCli();
52037
+ const args = buildArgs({ ...options, context: 0 }, cli.backend);
52038
+ if (cli.backend === "rg") {
52039
+ args.push("--count", "--", options.pattern);
52040
+ } else {
52041
+ args.push("-c", "-e", options.pattern);
52042
+ }
52043
+ const paths = options.paths?.length ? options.paths : ["."];
52044
+ args.push(...paths);
52045
+ const timeout = Math.min(options.timeout ?? DEFAULT_TIMEOUT_MS3, DEFAULT_TIMEOUT_MS3);
52046
+ const proc = spawn11([cli.path, ...args], {
52047
+ stdout: "pipe",
52048
+ stderr: "pipe"
52049
+ });
52050
+ const timeoutPromise = new Promise((_, reject) => {
52051
+ const id = setTimeout(() => {
52052
+ proc.kill();
52053
+ reject(new Error(`Search timeout after ${timeout}ms`));
52054
+ }, timeout);
52055
+ proc.exited.then(() => clearTimeout(id));
52056
+ });
52057
+ try {
52058
+ const stdout = await Promise.race([new Response(proc.stdout).text(), timeoutPromise]);
52059
+ return parseCountOutput(stdout);
52060
+ } catch (e) {
52061
+ throw new Error(`Count search failed: ${e instanceof Error ? e.message : String(e)}`);
52062
+ }
52063
+ }
51820
52064
 
51821
52065
  // src/tools/grep/result-formatter.ts
51822
52066
  function formatGrepResult(result) {
@@ -51827,6 +52071,7 @@ function formatGrepResult(result) {
51827
52071
  return "No matches found";
51828
52072
  }
51829
52073
  const lines = [];
52074
+ const isFilesOnlyMode = result.matches.every((match) => match.line === 0 && match.text.trim() === "");
51830
52075
  lines.push(`Found ${result.totalMatches} match(es) in ${result.filesSearched} file(s)`);
51831
52076
  if (result.truncated) {
51832
52077
  lines.push("[Output truncated due to size limit]");
@@ -51840,34 +52085,68 @@ function formatGrepResult(result) {
51840
52085
  }
51841
52086
  for (const [file2, matches] of byFile) {
51842
52087
  lines.push(file2);
51843
- for (const match of matches) {
51844
- lines.push(` ${match.line}: ${match.text.trim()}`);
52088
+ if (!isFilesOnlyMode) {
52089
+ for (const match of matches) {
52090
+ const trimmedText = match.text.trim();
52091
+ if (match.line === 0 && trimmedText === "") {
52092
+ continue;
52093
+ }
52094
+ lines.push(` ${match.line}: ${trimmedText}`);
52095
+ }
51845
52096
  }
51846
52097
  lines.push("");
51847
52098
  }
51848
52099
  return lines.join(`
51849
52100
  `);
51850
52101
  }
52102
+ function formatCountResult(results) {
52103
+ if (results.length === 0) {
52104
+ return "No matches found";
52105
+ }
52106
+ const total = results.reduce((sum, r) => sum + r.count, 0);
52107
+ const lines = [`Found ${total} match(es) in ${results.length} file(s):`, ""];
52108
+ const sorted = [...results].sort((a, b) => b.count - a.count);
52109
+ for (const { file: file2, count } of sorted) {
52110
+ lines.push(` ${count.toString().padStart(6)}: ${file2}`);
52111
+ }
52112
+ return lines.join(`
52113
+ `);
52114
+ }
51851
52115
 
51852
52116
  // src/tools/grep/tools.ts
51853
52117
  function createGrepTools(ctx) {
51854
52118
  const grep = tool({
51855
- description: "Fast content search tool with safety limits (60s timeout, 10MB output). " + "Searches file contents using regular expressions. " + 'Supports full regex syntax (eg. "log.*Error", "function\\s+\\w+", etc.). ' + 'Filter files by pattern with the include parameter (eg. "*.js", "*.{ts,tsx}"). ' + "Returns file paths with matches sorted by modification time.",
52119
+ description: "Fast content search tool with safety limits (60s timeout, 256KB output). " + "Searches file contents using regular expressions. " + 'Supports full regex syntax (eg. "log.*Error", "function\\s+\\w+", etc.). ' + 'Filter files by pattern with the include parameter (eg. "*.js", "*.{ts,tsx}"). ' + 'Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts per file.',
51856
52120
  args: {
51857
52121
  pattern: tool.schema.string().describe("The regex pattern to search for in file contents"),
51858
52122
  include: tool.schema.string().optional().describe('File pattern to include in the search (e.g. "*.js", "*.{ts,tsx}")'),
51859
- path: tool.schema.string().optional().describe("The directory to search in. Defaults to the current working directory.")
52123
+ path: tool.schema.string().optional().describe("The directory to search in. Defaults to the current working directory."),
52124
+ output_mode: tool.schema.enum(["content", "files_with_matches", "count"]).optional().describe('Output mode: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts per file.'),
52125
+ head_limit: tool.schema.number().optional().describe("Limit output to first N entries. 0 or omitted means no limit.")
51860
52126
  },
51861
52127
  execute: async (args) => {
51862
52128
  try {
51863
52129
  const globs = args.include ? [args.include] : undefined;
51864
52130
  const searchPath = args.path ?? ctx.directory;
51865
52131
  const paths = [searchPath];
52132
+ const outputMode = args.output_mode ?? "files_with_matches";
52133
+ const headLimit = args.head_limit ?? 0;
52134
+ if (outputMode === "count") {
52135
+ const results = await runRgCount({
52136
+ pattern: args.pattern,
52137
+ paths,
52138
+ globs
52139
+ });
52140
+ const limited = headLimit > 0 ? results.slice(0, headLimit) : results;
52141
+ return formatCountResult(limited);
52142
+ }
51866
52143
  const result = await runRg({
51867
52144
  pattern: args.pattern,
51868
52145
  paths,
51869
52146
  globs,
51870
- context: 0
52147
+ context: 0,
52148
+ outputMode,
52149
+ headLimit
51871
52150
  });
51872
52151
  return formatGrepResult(result);
51873
52152
  } catch (e) {
@@ -51896,6 +52175,7 @@ import { stat } from "fs/promises";
51896
52175
  function buildRgArgs2(options) {
51897
52176
  const args = [
51898
52177
  ...RG_FILES_FLAGS,
52178
+ `--threads=${Math.min(options.threads ?? DEFAULT_RG_THREADS, DEFAULT_RG_THREADS)}`,
51899
52179
  `--max-depth=${Math.min(options.maxDepth ?? DEFAULT_MAX_DEPTH2, DEFAULT_MAX_DEPTH2)}`
51900
52180
  ];
51901
52181
  if (options.hidden !== false)
@@ -51944,6 +52224,14 @@ async function getFileMtime(filePath) {
51944
52224
  }
51945
52225
  }
51946
52226
  async function runRgFiles(options, resolvedCli) {
52227
+ await rgSemaphore.acquire();
52228
+ try {
52229
+ return await runRgFilesInternal(options, resolvedCli);
52230
+ } finally {
52231
+ rgSemaphore.release();
52232
+ }
52233
+ }
52234
+ async function runRgFilesInternal(options, resolvedCli) {
51947
52235
  const cli = resolvedCli ?? resolveGrepCli();
51948
52236
  const timeout = Math.min(options.timeout ?? DEFAULT_TIMEOUT_MS4, DEFAULT_TIMEOUT_MS4);
51949
52237
  const limit = Math.min(options.limit ?? DEFAULT_LIMIT, DEFAULT_LIMIT);
@@ -56838,30 +57126,281 @@ function stripRangeBoundaryEcho(lines, startLine, endLine, newLines) {
56838
57126
  return out;
56839
57127
  }
56840
57128
 
56841
- // src/tools/hashline-edit/edit-operations.ts
56842
- function applySetLine(lines, anchor, newText) {
56843
- validateLineRef(lines, anchor);
57129
+ // src/tools/hashline-edit/edit-deduplication.ts
57130
+ function normalizeEditPayload(payload) {
57131
+ return toNewLines(payload).join(`
57132
+ `);
57133
+ }
57134
+ function buildDedupeKey(edit) {
57135
+ switch (edit.type) {
57136
+ case "set_line":
57137
+ return `set_line|${edit.line}|${normalizeEditPayload(edit.text)}`;
57138
+ case "replace_lines":
57139
+ return `replace_lines|${edit.start_line}|${edit.end_line}|${normalizeEditPayload(edit.text)}`;
57140
+ case "insert_after":
57141
+ return `insert_after|${edit.line}|${normalizeEditPayload(edit.text)}`;
57142
+ case "insert_before":
57143
+ return `insert_before|${edit.line}|${normalizeEditPayload(edit.text)}`;
57144
+ case "insert_between":
57145
+ return `insert_between|${edit.after_line}|${edit.before_line}|${normalizeEditPayload(edit.text)}`;
57146
+ case "replace":
57147
+ return `replace|${edit.old_text}|${normalizeEditPayload(edit.new_text)}`;
57148
+ case "append":
57149
+ return `append|${normalizeEditPayload(edit.text)}`;
57150
+ case "prepend":
57151
+ return `prepend|${normalizeEditPayload(edit.text)}`;
57152
+ default:
57153
+ return JSON.stringify(edit);
57154
+ }
57155
+ }
57156
+ function dedupeEdits(edits) {
57157
+ const seen = new Set;
57158
+ const deduped = [];
57159
+ let deduplicatedEdits = 0;
57160
+ for (const edit of edits) {
57161
+ const key = buildDedupeKey(edit);
57162
+ if (seen.has(key)) {
57163
+ deduplicatedEdits += 1;
57164
+ continue;
57165
+ }
57166
+ seen.add(key);
57167
+ deduped.push(edit);
57168
+ }
57169
+ return { edits: deduped, deduplicatedEdits };
57170
+ }
57171
+
57172
+ // src/tools/hashline-edit/edit-ordering.ts
57173
+ function getEditLineNumber(edit) {
57174
+ switch (edit.type) {
57175
+ case "set_line":
57176
+ return parseLineRef(edit.line).line;
57177
+ case "replace_lines":
57178
+ return parseLineRef(edit.end_line).line;
57179
+ case "insert_after":
57180
+ return parseLineRef(edit.line).line;
57181
+ case "insert_before":
57182
+ return parseLineRef(edit.line).line;
57183
+ case "insert_between":
57184
+ return parseLineRef(edit.before_line).line;
57185
+ case "append":
57186
+ return Number.NEGATIVE_INFINITY;
57187
+ case "prepend":
57188
+ return Number.NEGATIVE_INFINITY;
57189
+ case "replace":
57190
+ return Number.NEGATIVE_INFINITY;
57191
+ default:
57192
+ return Number.POSITIVE_INFINITY;
57193
+ }
57194
+ }
57195
+ function collectLineRefs(edits) {
57196
+ return edits.flatMap((edit) => {
57197
+ switch (edit.type) {
57198
+ case "set_line":
57199
+ return [edit.line];
57200
+ case "replace_lines":
57201
+ return [edit.start_line, edit.end_line];
57202
+ case "insert_after":
57203
+ return [edit.line];
57204
+ case "insert_before":
57205
+ return [edit.line];
57206
+ case "insert_between":
57207
+ return [edit.after_line, edit.before_line];
57208
+ case "append":
57209
+ case "prepend":
57210
+ case "replace":
57211
+ return [];
57212
+ default:
57213
+ return [];
57214
+ }
57215
+ });
57216
+ }
57217
+
57218
+ // src/tools/hashline-edit/autocorrect-replacement-lines.ts
57219
+ function normalizeTokens(text) {
57220
+ return text.replace(/\s+/g, "");
57221
+ }
57222
+ function stripAllWhitespace(text) {
57223
+ return normalizeTokens(text);
57224
+ }
57225
+ function stripTrailingContinuationTokens(text) {
57226
+ return text.replace(/(?:&&|\|\||\?\?|\?|:|=|,|\+|-|\*|\/|\.|\()\s*$/u, "");
57227
+ }
57228
+ function stripMergeOperatorChars(text) {
57229
+ return text.replace(/[|&?]/g, "");
57230
+ }
57231
+ function leadingWhitespace2(text) {
57232
+ const match = text.match(/^\s*/);
57233
+ return match ? match[0] : "";
57234
+ }
57235
+ function restoreOldWrappedLines(originalLines, replacementLines) {
57236
+ if (originalLines.length === 0 || replacementLines.length < 2)
57237
+ return replacementLines;
57238
+ const canonicalToOriginal = new Map;
57239
+ for (const line of originalLines) {
57240
+ const canonical = stripAllWhitespace(line);
57241
+ const existing = canonicalToOriginal.get(canonical);
57242
+ if (existing) {
57243
+ existing.count += 1;
57244
+ } else {
57245
+ canonicalToOriginal.set(canonical, { line, count: 1 });
57246
+ }
57247
+ }
57248
+ const candidates = [];
57249
+ for (let start = 0;start < replacementLines.length; start += 1) {
57250
+ for (let len = 2;len <= 10 && start + len <= replacementLines.length; len += 1) {
57251
+ const canonicalSpan = stripAllWhitespace(replacementLines.slice(start, start + len).join(""));
57252
+ const original = canonicalToOriginal.get(canonicalSpan);
57253
+ if (original && original.count === 1 && canonicalSpan.length >= 6) {
57254
+ candidates.push({ start, len, replacement: original.line, canonical: canonicalSpan });
57255
+ }
57256
+ }
57257
+ }
57258
+ if (candidates.length === 0)
57259
+ return replacementLines;
57260
+ const canonicalCounts = new Map;
57261
+ for (const candidate of candidates) {
57262
+ canonicalCounts.set(candidate.canonical, (canonicalCounts.get(candidate.canonical) ?? 0) + 1);
57263
+ }
57264
+ const uniqueCandidates = candidates.filter((candidate) => (canonicalCounts.get(candidate.canonical) ?? 0) === 1);
57265
+ if (uniqueCandidates.length === 0)
57266
+ return replacementLines;
57267
+ uniqueCandidates.sort((a, b) => b.start - a.start);
57268
+ const correctedLines = [...replacementLines];
57269
+ for (const candidate of uniqueCandidates) {
57270
+ correctedLines.splice(candidate.start, candidate.len, candidate.replacement);
57271
+ }
57272
+ return correctedLines;
57273
+ }
57274
+ function maybeExpandSingleLineMerge(originalLines, replacementLines) {
57275
+ if (replacementLines.length !== 1 || originalLines.length <= 1) {
57276
+ return replacementLines;
57277
+ }
57278
+ const merged = replacementLines[0];
57279
+ const parts = originalLines.map((line) => line.trim()).filter((line) => line.length > 0);
57280
+ if (parts.length !== originalLines.length)
57281
+ return replacementLines;
57282
+ const indices = [];
57283
+ let offset = 0;
57284
+ let orderedMatch = true;
57285
+ for (const part of parts) {
57286
+ let idx = merged.indexOf(part, offset);
57287
+ let matchedLen = part.length;
57288
+ if (idx === -1) {
57289
+ const stripped = stripTrailingContinuationTokens(part);
57290
+ if (stripped !== part) {
57291
+ idx = merged.indexOf(stripped, offset);
57292
+ if (idx !== -1)
57293
+ matchedLen = stripped.length;
57294
+ }
57295
+ }
57296
+ if (idx === -1) {
57297
+ const segment = merged.slice(offset);
57298
+ const segmentStripped = stripMergeOperatorChars(segment);
57299
+ const partStripped = stripMergeOperatorChars(part);
57300
+ const fuzzyIdx = segmentStripped.indexOf(partStripped);
57301
+ if (fuzzyIdx !== -1) {
57302
+ let strippedPos = 0;
57303
+ let originalPos = 0;
57304
+ while (strippedPos < fuzzyIdx && originalPos < segment.length) {
57305
+ if (!/[|&?]/.test(segment[originalPos]))
57306
+ strippedPos += 1;
57307
+ originalPos += 1;
57308
+ }
57309
+ idx = offset + originalPos;
57310
+ matchedLen = part.length;
57311
+ }
57312
+ }
57313
+ if (idx === -1) {
57314
+ orderedMatch = false;
57315
+ break;
57316
+ }
57317
+ indices.push(idx);
57318
+ offset = idx + matchedLen;
57319
+ }
57320
+ const expanded = [];
57321
+ if (orderedMatch) {
57322
+ for (let i2 = 0;i2 < indices.length; i2 += 1) {
57323
+ const start = indices[i2];
57324
+ const end = i2 + 1 < indices.length ? indices[i2 + 1] : merged.length;
57325
+ const candidate = merged.slice(start, end).trim();
57326
+ if (candidate.length === 0) {
57327
+ orderedMatch = false;
57328
+ break;
57329
+ }
57330
+ expanded.push(candidate);
57331
+ }
57332
+ }
57333
+ if (orderedMatch && expanded.length === originalLines.length) {
57334
+ return expanded;
57335
+ }
57336
+ const semicolonSplit = merged.split(/;\s+/).map((line, idx, arr) => {
57337
+ if (idx < arr.length - 1 && !line.endsWith(";")) {
57338
+ return `${line};`;
57339
+ }
57340
+ return line;
57341
+ }).map((line) => line.trim()).filter((line) => line.length > 0);
57342
+ if (semicolonSplit.length === originalLines.length) {
57343
+ return semicolonSplit;
57344
+ }
57345
+ return replacementLines;
57346
+ }
57347
+ function restoreIndentForPairedReplacement(originalLines, replacementLines) {
57348
+ if (originalLines.length !== replacementLines.length) {
57349
+ return replacementLines;
57350
+ }
57351
+ return replacementLines.map((line, idx) => {
57352
+ if (line.length === 0)
57353
+ return line;
57354
+ if (leadingWhitespace2(line).length > 0)
57355
+ return line;
57356
+ const indent = leadingWhitespace2(originalLines[idx]);
57357
+ if (indent.length === 0)
57358
+ return line;
57359
+ return `${indent}${line}`;
57360
+ });
57361
+ }
57362
+ function autocorrectReplacementLines(originalLines, replacementLines) {
57363
+ let next = replacementLines;
57364
+ next = maybeExpandSingleLineMerge(originalLines, next);
57365
+ next = restoreOldWrappedLines(originalLines, next);
57366
+ next = restoreIndentForPairedReplacement(originalLines, next);
57367
+ return next;
57368
+ }
57369
+
57370
+ // src/tools/hashline-edit/edit-operation-primitives.ts
57371
+ function shouldValidate(options) {
57372
+ return options?.skipValidation !== true;
57373
+ }
57374
+ function applySetLine(lines, anchor, newText, options) {
57375
+ if (shouldValidate(options))
57376
+ validateLineRef(lines, anchor);
56844
57377
  const { line } = parseLineRef(anchor);
56845
57378
  const result = [...lines];
56846
- const replacement = toNewLines(newText).map((entry, idx) => {
57379
+ const originalLine = lines[line - 1] ?? "";
57380
+ const corrected = autocorrectReplacementLines([originalLine], toNewLines(newText));
57381
+ const replacement = corrected.map((entry, idx) => {
56847
57382
  if (idx !== 0)
56848
57383
  return entry;
56849
- return restoreLeadingIndent(lines[line - 1], entry);
57384
+ return restoreLeadingIndent(originalLine, entry);
56850
57385
  });
56851
57386
  result.splice(line - 1, 1, ...replacement);
56852
57387
  return result;
56853
57388
  }
56854
- function applyReplaceLines(lines, startAnchor, endAnchor, newText) {
56855
- validateLineRef(lines, startAnchor);
56856
- validateLineRef(lines, endAnchor);
57389
+ function applyReplaceLines(lines, startAnchor, endAnchor, newText, options) {
57390
+ if (shouldValidate(options)) {
57391
+ validateLineRef(lines, startAnchor);
57392
+ validateLineRef(lines, endAnchor);
57393
+ }
56857
57394
  const { line: startLine } = parseLineRef(startAnchor);
56858
57395
  const { line: endLine } = parseLineRef(endAnchor);
56859
57396
  if (startLine > endLine) {
56860
57397
  throw new Error(`Invalid range: start line ${startLine} cannot be greater than end line ${endLine}`);
56861
57398
  }
56862
57399
  const result = [...lines];
57400
+ const originalRange = lines.slice(startLine - 1, endLine);
56863
57401
  const stripped = stripRangeBoundaryEcho(lines, startLine, endLine, toNewLines(newText));
56864
- const restored = stripped.map((entry, idx) => {
57402
+ const corrected = autocorrectReplacementLines(originalRange, stripped);
57403
+ const restored = corrected.map((entry, idx) => {
56865
57404
  if (idx !== 0)
56866
57405
  return entry;
56867
57406
  return restoreLeadingIndent(lines[startLine - 1], entry);
@@ -56869,8 +57408,9 @@ function applyReplaceLines(lines, startAnchor, endAnchor, newText) {
56869
57408
  result.splice(startLine - 1, endLine - startLine + 1, ...restored);
56870
57409
  return result;
56871
57410
  }
56872
- function applyInsertAfter(lines, anchor, text) {
56873
- validateLineRef(lines, anchor);
57411
+ function applyInsertAfter(lines, anchor, text, options) {
57412
+ if (shouldValidate(options))
57413
+ validateLineRef(lines, anchor);
56874
57414
  const { line } = parseLineRef(anchor);
56875
57415
  const result = [...lines];
56876
57416
  const newLines = stripInsertAnchorEcho(lines[line - 1], toNewLines(text));
@@ -56880,8 +57420,9 @@ function applyInsertAfter(lines, anchor, text) {
56880
57420
  result.splice(line, 0, ...newLines);
56881
57421
  return result;
56882
57422
  }
56883
- function applyInsertBefore(lines, anchor, text) {
56884
- validateLineRef(lines, anchor);
57423
+ function applyInsertBefore(lines, anchor, text, options) {
57424
+ if (shouldValidate(options))
57425
+ validateLineRef(lines, anchor);
56885
57426
  const { line } = parseLineRef(anchor);
56886
57427
  const result = [...lines];
56887
57428
  const newLines = stripInsertBeforeEcho(lines[line - 1], toNewLines(text));
@@ -56891,9 +57432,11 @@ function applyInsertBefore(lines, anchor, text) {
56891
57432
  result.splice(line - 1, 0, ...newLines);
56892
57433
  return result;
56893
57434
  }
56894
- function applyInsertBetween(lines, afterAnchor, beforeAnchor, text) {
56895
- validateLineRef(lines, afterAnchor);
56896
- validateLineRef(lines, beforeAnchor);
57435
+ function applyInsertBetween(lines, afterAnchor, beforeAnchor, text, options) {
57436
+ if (shouldValidate(options)) {
57437
+ validateLineRef(lines, afterAnchor);
57438
+ validateLineRef(lines, beforeAnchor);
57439
+ }
56897
57440
  const { line: afterLine } = parseLineRef(afterAnchor);
56898
57441
  const { line: beforeLine } = parseLineRef(beforeAnchor);
56899
57442
  if (beforeLine <= afterLine) {
@@ -56907,58 +57450,36 @@ function applyInsertBetween(lines, afterAnchor, beforeAnchor, text) {
56907
57450
  result.splice(beforeLine - 1, 0, ...newLines);
56908
57451
  return result;
56909
57452
  }
56910
- function getEditLineNumber(edit) {
56911
- switch (edit.type) {
56912
- case "set_line":
56913
- return parseLineRef(edit.line).line;
56914
- case "replace_lines":
56915
- return parseLineRef(edit.end_line).line;
56916
- case "insert_after":
56917
- return parseLineRef(edit.line).line;
56918
- case "insert_before":
56919
- return parseLineRef(edit.line).line;
56920
- case "insert_between":
56921
- return parseLineRef(edit.before_line).line;
56922
- case "replace":
56923
- return Number.NEGATIVE_INFINITY;
56924
- default:
56925
- return Number.POSITIVE_INFINITY;
57453
+ function applyAppend(lines, text) {
57454
+ const normalized = toNewLines(text);
57455
+ if (normalized.length === 0) {
57456
+ throw new Error("append requires non-empty text");
56926
57457
  }
57458
+ if (lines.length === 1 && lines[0] === "") {
57459
+ return [...normalized];
57460
+ }
57461
+ return [...lines, ...normalized];
56927
57462
  }
56928
- function normalizeEditPayload(payload) {
56929
- return toNewLines(payload).join(`
56930
- `);
57463
+ function applyPrepend(lines, text) {
57464
+ const normalized = toNewLines(text);
57465
+ if (normalized.length === 0) {
57466
+ throw new Error("prepend requires non-empty text");
57467
+ }
57468
+ if (lines.length === 1 && lines[0] === "") {
57469
+ return [...normalized];
57470
+ }
57471
+ return [...normalized, ...lines];
56931
57472
  }
56932
- function dedupeEdits(edits) {
56933
- const seen = new Set;
56934
- const deduped = [];
56935
- let deduplicatedEdits = 0;
56936
- for (const edit of edits) {
56937
- const key = (() => {
56938
- switch (edit.type) {
56939
- case "set_line":
56940
- return `set_line|${edit.line}|${normalizeEditPayload(edit.text)}`;
56941
- case "replace_lines":
56942
- return `replace_lines|${edit.start_line}|${edit.end_line}|${normalizeEditPayload(edit.text)}`;
56943
- case "insert_after":
56944
- return `insert_after|${edit.line}|${normalizeEditPayload(edit.text)}`;
56945
- case "insert_before":
56946
- return `insert_before|${edit.line}|${normalizeEditPayload(edit.text)}`;
56947
- case "insert_between":
56948
- return `insert_between|${edit.after_line}|${edit.before_line}|${normalizeEditPayload(edit.text)}`;
56949
- case "replace":
56950
- return `replace|${edit.old_text}|${normalizeEditPayload(edit.new_text)}`;
56951
- }
56952
- })();
56953
- if (seen.has(key)) {
56954
- deduplicatedEdits += 1;
56955
- continue;
56956
- }
56957
- seen.add(key);
56958
- deduped.push(edit);
57473
+ function applyReplace(content, oldText, newText) {
57474
+ if (!content.includes(oldText)) {
57475
+ throw new Error(`Text not found: "${oldText}"`);
56959
57476
  }
56960
- return { edits: deduped, deduplicatedEdits };
57477
+ const replacement = Array.isArray(newText) ? newText.join(`
57478
+ `) : newText;
57479
+ return content.replaceAll(oldText, replacement);
56961
57480
  }
57481
+
57482
+ // src/tools/hashline-edit/edit-operations.ts
56962
57483
  function applyHashlineEditsWithReport(content, edits) {
56963
57484
  if (edits.length === 0) {
56964
57485
  return {
@@ -56971,39 +57492,22 @@ function applyHashlineEditsWithReport(content, edits) {
56971
57492
  const sortedEdits = [...dedupeResult.edits].sort((a, b) => getEditLineNumber(b) - getEditLineNumber(a));
56972
57493
  let noopEdits = 0;
56973
57494
  let result = content;
56974
- let lines = result.split(`
57495
+ let lines = result.length === 0 ? [] : result.split(`
56975
57496
  `);
56976
- const refs = sortedEdits.flatMap((edit) => {
56977
- switch (edit.type) {
56978
- case "set_line":
56979
- return [edit.line];
56980
- case "replace_lines":
56981
- return [edit.start_line, edit.end_line];
56982
- case "insert_after":
56983
- return [edit.line];
56984
- case "insert_before":
56985
- return [edit.line];
56986
- case "insert_between":
56987
- return [edit.after_line, edit.before_line];
56988
- case "replace":
56989
- return [];
56990
- default:
56991
- return [];
56992
- }
56993
- });
57497
+ const refs = collectLineRefs(sortedEdits);
56994
57498
  validateLineRefs(lines, refs);
56995
57499
  for (const edit of sortedEdits) {
56996
57500
  switch (edit.type) {
56997
57501
  case "set_line": {
56998
- lines = applySetLine(lines, edit.line, edit.text);
57502
+ lines = applySetLine(lines, edit.line, edit.text, { skipValidation: true });
56999
57503
  break;
57000
57504
  }
57001
57505
  case "replace_lines": {
57002
- lines = applyReplaceLines(lines, edit.start_line, edit.end_line, edit.text);
57506
+ lines = applyReplaceLines(lines, edit.start_line, edit.end_line, edit.text, { skipValidation: true });
57003
57507
  break;
57004
57508
  }
57005
57509
  case "insert_after": {
57006
- const next = applyInsertAfter(lines, edit.line, edit.text);
57510
+ const next = applyInsertAfter(lines, edit.line, edit.text, { skipValidation: true });
57007
57511
  if (next.join(`
57008
57512
  `) === lines.join(`
57009
57513
  `)) {
@@ -57014,7 +57518,7 @@ function applyHashlineEditsWithReport(content, edits) {
57014
57518
  break;
57015
57519
  }
57016
57520
  case "insert_before": {
57017
- const next = applyInsertBefore(lines, edit.line, edit.text);
57521
+ const next = applyInsertBefore(lines, edit.line, edit.text, { skipValidation: true });
57018
57522
  if (next.join(`
57019
57523
  `) === lines.join(`
57020
57524
  `)) {
@@ -57025,7 +57529,29 @@ function applyHashlineEditsWithReport(content, edits) {
57025
57529
  break;
57026
57530
  }
57027
57531
  case "insert_between": {
57028
- const next = applyInsertBetween(lines, edit.after_line, edit.before_line, edit.text);
57532
+ const next = applyInsertBetween(lines, edit.after_line, edit.before_line, edit.text, { skipValidation: true });
57533
+ if (next.join(`
57534
+ `) === lines.join(`
57535
+ `)) {
57536
+ noopEdits += 1;
57537
+ break;
57538
+ }
57539
+ lines = next;
57540
+ break;
57541
+ }
57542
+ case "append": {
57543
+ const next = applyAppend(lines, edit.text);
57544
+ if (next.join(`
57545
+ `) === lines.join(`
57546
+ `)) {
57547
+ noopEdits += 1;
57548
+ break;
57549
+ }
57550
+ lines = next;
57551
+ break;
57552
+ }
57553
+ case "prepend": {
57554
+ const next = applyPrepend(lines, edit.text);
57029
57555
  if (next.join(`
57030
57556
  `) === lines.join(`
57031
57557
  `)) {
@@ -57038,12 +57564,7 @@ function applyHashlineEditsWithReport(content, edits) {
57038
57564
  case "replace": {
57039
57565
  result = lines.join(`
57040
57566
  `);
57041
- if (!result.includes(edit.old_text)) {
57042
- throw new Error(`Text not found: "${edit.old_text}"`);
57043
- }
57044
- const replacement = Array.isArray(edit.new_text) ? edit.new_text.join(`
57045
- `) : edit.new_text;
57046
- const replaced = result.replaceAll(edit.old_text, replacement);
57567
+ const replaced = applyReplace(result, edit.old_text, edit.new_text);
57047
57568
  if (replaced === result) {
57048
57569
  noopEdits += 1;
57049
57570
  break;
@@ -57062,53 +57583,57 @@ function applyHashlineEditsWithReport(content, edits) {
57062
57583
  deduplicatedEdits: dedupeResult.deduplicatedEdits
57063
57584
  };
57064
57585
  }
57065
- // src/tools/hashline-edit/tool-description.ts
57066
- var HASHLINE_EDIT_DESCRIPTION = `Edit files using LINE#ID format for precise, safe modifications.
57067
-
57068
- WORKFLOW:
57069
- 1. Read the file and copy exact LINE#ID anchors.
57070
- 2. Submit one edit call with all related operations for that file.
57071
- 3. If more edits are needed after success, use the latest anchors from read/edit output.
57072
- 4. Use anchors as "LINE#ID" only (never include trailing ":content").
57073
-
57074
- VALIDATION:
57075
- - Payload shape: { "filePath": string, "edits": [...], "delete"?: boolean, "rename"?: string }
57076
- - Each edit must be one of: set_line, replace_lines, insert_after, insert_before, insert_between, replace
57077
- - text/new_text must contain plain replacement text only (no LINE#ID prefixes, no diff + markers)
57078
-
57079
- LINE#ID FORMAT (CRITICAL - READ CAREFULLY):
57080
- Each line reference must be in "LINE#ID" format where:
57081
- - LINE: 1-based line number
57082
- - ID: Two CID letters from the set ZPMQVRWSNKTXJBYH
57083
-
57084
- OPERATION TYPES:
57085
- 1. set_line
57086
- 2. replace_lines
57087
- 3. insert_after
57088
- 4. insert_before
57089
- 5. insert_between
57090
- 6. replace
57091
-
57092
- FILE MODES:
57093
- - delete=true deletes file and requires edits=[] with no rename
57094
- - rename moves final content to a new path and removes old path
57095
-
57096
- CONTENT FORMAT:
57097
- - text/new_text can be a string (single line) or string[] (multi-line, preferred).
57098
- - If you pass a multi-line string, it is split by real newline characters.
57099
- - Literal "\\n" is preserved as text.`;
57100
-
57101
- // src/tools/hashline-edit/tools.ts
57102
- function resolveToolCallID2(ctx) {
57103
- if (typeof ctx.callID === "string" && ctx.callID.trim() !== "")
57104
- return ctx.callID;
57105
- if (typeof ctx.callId === "string" && ctx.callId.trim() !== "")
57106
- return ctx.callId;
57107
- if (typeof ctx.call_id === "string" && ctx.call_id.trim() !== "")
57108
- return ctx.call_id;
57109
- return;
57586
+ // src/tools/hashline-edit/file-text-canonicalization.ts
57587
+ function detectLineEnding(content) {
57588
+ const crlfIndex = content.indexOf(`\r
57589
+ `);
57590
+ const lfIndex = content.indexOf(`
57591
+ `);
57592
+ if (lfIndex === -1)
57593
+ return `
57594
+ `;
57595
+ if (crlfIndex === -1)
57596
+ return `
57597
+ `;
57598
+ return crlfIndex < lfIndex ? `\r
57599
+ ` : `
57600
+ `;
57601
+ }
57602
+ function stripBom(content) {
57603
+ if (!content.startsWith("\uFEFF")) {
57604
+ return { content, hadBom: false };
57605
+ }
57606
+ return { content: content.slice(1), hadBom: true };
57607
+ }
57608
+ function normalizeToLf(content) {
57609
+ return content.replace(/\r\n/g, `
57610
+ `).replace(/\r/g, `
57611
+ `);
57612
+ }
57613
+ function restoreLineEndings(content, lineEnding) {
57614
+ if (lineEnding === `
57615
+ `)
57616
+ return content;
57617
+ return content.replace(/\n/g, `\r
57618
+ `);
57619
+ }
57620
+ function canonicalizeFileText(content) {
57621
+ const stripped = stripBom(content);
57622
+ return {
57623
+ content: normalizeToLf(stripped.content),
57624
+ hadBom: stripped.hadBom,
57625
+ lineEnding: detectLineEnding(stripped.content)
57626
+ };
57110
57627
  }
57111
- function generateDiff(oldContent, newContent, filePath) {
57628
+ function restoreFileText(content, envelope) {
57629
+ const withLineEnding = restoreLineEndings(content, envelope.lineEnding);
57630
+ if (!envelope.hadBom)
57631
+ return withLineEnding;
57632
+ return `\uFEFF${withLineEnding}`;
57633
+ }
57634
+
57635
+ // src/tools/hashline-edit/hashline-edit-diff.ts
57636
+ function generateHashlineDiff(oldContent, newContent, filePath) {
57112
57637
  const oldLines = oldContent.split(`
57113
57638
  `);
57114
57639
  const newLines = newContent.split(`
@@ -57117,7 +57642,7 @@ function generateDiff(oldContent, newContent, filePath) {
57117
57642
  +++ ${filePath}
57118
57643
  `;
57119
57644
  const maxLines = Math.max(oldLines.length, newLines.length);
57120
- for (let i2 = 0;i2 < maxLines; i2++) {
57645
+ for (let i2 = 0;i2 < maxLines; i2 += 1) {
57121
57646
  const oldLine = oldLines[i2] ?? "";
57122
57647
  const newLine = newLines[i2] ?? "";
57123
57648
  const lineNum = i2 + 1;
@@ -57125,10 +57650,14 @@ function generateDiff(oldContent, newContent, filePath) {
57125
57650
  if (i2 >= oldLines.length) {
57126
57651
  diff += `+ ${lineNum}#${hash2}:${newLine}
57127
57652
  `;
57128
- } else if (i2 >= newLines.length) {
57653
+ continue;
57654
+ }
57655
+ if (i2 >= newLines.length) {
57129
57656
  diff += `- ${lineNum}# :${oldLine}
57130
57657
  `;
57131
- } else if (oldLine !== newLine) {
57658
+ continue;
57659
+ }
57660
+ if (oldLine !== newLine) {
57132
57661
  diff += `- ${lineNum}# :${oldLine}
57133
57662
  `;
57134
57663
  diff += `+ ${lineNum}#${hash2}:${newLine}
@@ -57137,6 +57666,182 @@ function generateDiff(oldContent, newContent, filePath) {
57137
57666
  }
57138
57667
  return diff;
57139
57668
  }
57669
+
57670
+ // src/tools/hashline-edit/hashline-edit-executor.ts
57671
+ function resolveToolCallID2(ctx) {
57672
+ if (typeof ctx.callID === "string" && ctx.callID.trim() !== "")
57673
+ return ctx.callID;
57674
+ if (typeof ctx.callId === "string" && ctx.callId.trim() !== "")
57675
+ return ctx.callId;
57676
+ if (typeof ctx.call_id === "string" && ctx.call_id.trim() !== "")
57677
+ return ctx.call_id;
57678
+ return;
57679
+ }
57680
+ function canCreateFromMissingFile(edits) {
57681
+ if (edits.length === 0)
57682
+ return false;
57683
+ return edits.every((edit) => edit.type === "append" || edit.type === "prepend");
57684
+ }
57685
+ function buildSuccessMeta(effectivePath, beforeContent, afterContent, noopEdits, deduplicatedEdits) {
57686
+ const unifiedDiff = generateUnifiedDiff(beforeContent, afterContent, effectivePath);
57687
+ const { additions, deletions } = countLineDiffs(beforeContent, afterContent);
57688
+ return {
57689
+ title: effectivePath,
57690
+ metadata: {
57691
+ filePath: effectivePath,
57692
+ path: effectivePath,
57693
+ file: effectivePath,
57694
+ diff: unifiedDiff,
57695
+ noopEdits,
57696
+ deduplicatedEdits,
57697
+ filediff: {
57698
+ file: effectivePath,
57699
+ path: effectivePath,
57700
+ filePath: effectivePath,
57701
+ before: beforeContent,
57702
+ after: afterContent,
57703
+ additions,
57704
+ deletions
57705
+ }
57706
+ }
57707
+ };
57708
+ }
57709
+ async function executeHashlineEditTool(args, context) {
57710
+ try {
57711
+ const metadataContext = context;
57712
+ const filePath = args.filePath;
57713
+ const { edits, delete: deleteMode, rename } = args;
57714
+ if (deleteMode && rename) {
57715
+ return "Error: delete and rename cannot be used together";
57716
+ }
57717
+ if (!deleteMode && (!edits || !Array.isArray(edits) || edits.length === 0)) {
57718
+ return "Error: edits parameter must be a non-empty array";
57719
+ }
57720
+ if (deleteMode && edits.length > 0) {
57721
+ return "Error: delete mode requires edits to be an empty array";
57722
+ }
57723
+ const file2 = Bun.file(filePath);
57724
+ const exists = await file2.exists();
57725
+ if (!exists && !deleteMode && !canCreateFromMissingFile(edits)) {
57726
+ return `Error: File not found: ${filePath}`;
57727
+ }
57728
+ if (deleteMode) {
57729
+ if (!exists)
57730
+ return `Error: File not found: ${filePath}`;
57731
+ await Bun.file(filePath).delete();
57732
+ return `Successfully deleted ${filePath}`;
57733
+ }
57734
+ const rawOldContent = exists ? Buffer.from(await file2.arrayBuffer()).toString("utf8") : "";
57735
+ const oldEnvelope = canonicalizeFileText(rawOldContent);
57736
+ const applyResult = applyHashlineEditsWithReport(oldEnvelope.content, edits);
57737
+ const canonicalNewContent = applyResult.content;
57738
+ const writeContent = restoreFileText(canonicalNewContent, oldEnvelope);
57739
+ await Bun.write(filePath, writeContent);
57740
+ if (rename && rename !== filePath) {
57741
+ await Bun.write(rename, writeContent);
57742
+ await Bun.file(filePath).delete();
57743
+ }
57744
+ const effectivePath = rename && rename !== filePath ? rename : filePath;
57745
+ const diff = generateHashlineDiff(oldEnvelope.content, canonicalNewContent, effectivePath);
57746
+ const newHashlined = toHashlineContent(canonicalNewContent);
57747
+ const meta = buildSuccessMeta(effectivePath, oldEnvelope.content, canonicalNewContent, applyResult.noopEdits, applyResult.deduplicatedEdits);
57748
+ if (typeof metadataContext.metadata === "function") {
57749
+ metadataContext.metadata(meta);
57750
+ }
57751
+ const callID = resolveToolCallID2(metadataContext);
57752
+ if (callID) {
57753
+ storeToolMetadata(context.sessionID, callID, meta);
57754
+ }
57755
+ return `Successfully applied ${edits.length} edit(s) to ${effectivePath}
57756
+ No-op edits: ${applyResult.noopEdits}, deduplicated edits: ${applyResult.deduplicatedEdits}
57757
+
57758
+ ${diff}
57759
+
57760
+ Updated file (LINE#ID:content):
57761
+ ${newHashlined}`;
57762
+ } catch (error45) {
57763
+ const message = error45 instanceof Error ? error45.message : String(error45);
57764
+ if (message.toLowerCase().includes("hash")) {
57765
+ return `Error: hash mismatch - ${message}
57766
+ Tip: reuse LINE#ID entries from the latest read/edit output, or batch related edits in one call.`;
57767
+ }
57768
+ return `Error: ${message}`;
57769
+ }
57770
+ }
57771
+
57772
+ // src/tools/hashline-edit/tool-description.ts
57773
+ var HASHLINE_EDIT_DESCRIPTION = `Edit files using LINE#ID format for precise, safe modifications.
57774
+
57775
+ WORKFLOW:
57776
+ 1. Read target file/range and copy exact LINE#ID tags.
57777
+ 2. Pick the smallest operation per logical mutation site.
57778
+ 3. Submit one edit call per file with all related operations.
57779
+ 4. If same file needs another call, re-read first.
57780
+ 5. Use anchors as "LINE#ID" only (never include trailing ":content").
57781
+
57782
+ VALIDATION:
57783
+ Payload shape: { "filePath": string, "edits": [...], "delete"?: boolean, "rename"?: string }
57784
+ Each edit must be one of: set_line, replace_lines, insert_after, insert_before, insert_between, replace, append, prepend
57785
+ text/new_text must contain plain replacement text only (no LINE#ID prefixes, no diff + markers)
57786
+ CRITICAL: all operations validate against the same pre-edit file snapshot and apply bottom-up. Refs/tags are interpreted against the last-read version of the file.
57787
+
57788
+ LINE#ID FORMAT (CRITICAL):
57789
+ Each line reference must be in "LINE#ID" format where:
57790
+ LINE: 1-based line number
57791
+ ID: Two CID letters from the set ZPMQVRWSNKTXJBYH
57792
+
57793
+ FILE MODES:
57794
+ delete=true deletes file and requires edits=[] with no rename
57795
+ rename moves final content to a new path and removes old path
57796
+
57797
+ CONTENT FORMAT:
57798
+ text/new_text can be a string (single line) or string[] (multi-line, preferred).
57799
+ If you pass a multi-line string, it is split by real newline characters.
57800
+ Literal "\\n" is preserved as text.
57801
+
57802
+ FILE CREATION:
57803
+ append: adds content at EOF. If file does not exist, creates it.
57804
+ prepend: adds content at BOF. If file does not exist, creates it.
57805
+ CRITICAL: append/prepend are the only operations that work without an existing file.
57806
+
57807
+ OPERATION CHOICE:
57808
+ One line wrong -> set_line
57809
+ Adjacent block rewrite or swap/move -> replace_lines (prefer one range op over many single-line ops)
57810
+ Both boundaries known -> insert_between (ALWAYS prefer over insert_after/insert_before)
57811
+ One boundary known -> insert_after or insert_before
57812
+ New file or EOF/BOF addition -> append or prepend
57813
+ No LINE#ID available -> replace (last resort)
57814
+
57815
+ RULES (CRITICAL):
57816
+ 1. Minimize scope: one logical mutation site per operation.
57817
+ 2. Preserve formatting: keep indentation, punctuation, line breaks, trailing commas, brace style.
57818
+ 3. Prefer insertion over neighbor rewrites: anchor to structural boundaries (}, ], },), not interior property lines.
57819
+ 4. No no-ops: replacement content must differ from current content.
57820
+ 5. Touch only requested code: avoid incidental edits.
57821
+ 6. Use exact current tokens: NEVER rewrite approximately.
57822
+ 7. For swaps/moves: prefer one range operation over multiple single-line operations.
57823
+ 8. Output tool calls only; no prose or commentary between them.
57824
+
57825
+ TAG CHOICE (ALWAYS):
57826
+ - Copy tags exactly from read output or >>> mismatch output.
57827
+ - NEVER guess tags.
57828
+ - Prefer insert_between over insert_after/insert_before when both boundaries are known.
57829
+ - Anchor to structural lines (function/class/brace), NEVER blank lines.
57830
+ - Anti-pattern warning: blank/whitespace anchors are fragile.
57831
+ - Re-read after each successful edit call before issuing another on the same file.
57832
+
57833
+ AUTOCORRECT (built-in - you do NOT need to handle these):
57834
+ Merged lines are auto-expanded back to original line count.
57835
+ Indentation is auto-restored from original lines.
57836
+ BOM and CRLF line endings are preserved automatically.
57837
+ Hashline prefixes and diff markers in text are auto-stripped.
57838
+
57839
+ RECOVERY (when >>> mismatch error appears):
57840
+ Copy the updated LINE#ID tags shown in the error output directly.
57841
+ Re-read only if the needed tags are missing from the error snippet.
57842
+ ALWAYS batch all edits for one file in a single call.`;
57843
+
57844
+ // src/tools/hashline-edit/tools.ts
57140
57845
  function createHashlineEditTool() {
57141
57846
  return tool({
57142
57847
  description: HASHLINE_EDIT_DESCRIPTION,
@@ -57176,88 +57881,18 @@ function createHashlineEditTool() {
57176
57881
  type: tool.schema.literal("replace"),
57177
57882
  old_text: tool.schema.string().describe("Text to find"),
57178
57883
  new_text: tool.schema.union([tool.schema.string(), tool.schema.array(tool.schema.string())]).describe("Replacement text (string or string[] for multiline)")
57884
+ }),
57885
+ tool.schema.object({
57886
+ type: tool.schema.literal("append"),
57887
+ text: tool.schema.union([tool.schema.string(), tool.schema.array(tool.schema.string())]).describe("Content to append at EOF; also creates missing file")
57888
+ }),
57889
+ tool.schema.object({
57890
+ type: tool.schema.literal("prepend"),
57891
+ text: tool.schema.union([tool.schema.string(), tool.schema.array(tool.schema.string())]).describe("Content to prepend at BOF; also creates missing file")
57179
57892
  })
57180
57893
  ])).describe("Array of edit operations to apply (empty when delete=true)")
57181
57894
  },
57182
- execute: async (args, context) => {
57183
- try {
57184
- const metadataContext = context;
57185
- const filePath = args.filePath;
57186
- const { edits, delete: deleteMode, rename } = args;
57187
- if (deleteMode && rename) {
57188
- return "Error: delete and rename cannot be used together";
57189
- }
57190
- if (!deleteMode && (!edits || !Array.isArray(edits) || edits.length === 0)) {
57191
- return "Error: edits parameter must be a non-empty array";
57192
- }
57193
- if (deleteMode && edits.length > 0) {
57194
- return "Error: delete mode requires edits to be an empty array";
57195
- }
57196
- const file2 = Bun.file(filePath);
57197
- const exists = await file2.exists();
57198
- if (!exists) {
57199
- return `Error: File not found: ${filePath}`;
57200
- }
57201
- if (deleteMode) {
57202
- await Bun.file(filePath).delete();
57203
- return `Successfully deleted ${filePath}`;
57204
- }
57205
- const oldContent = await file2.text();
57206
- const applyResult = applyHashlineEditsWithReport(oldContent, edits);
57207
- const newContent = applyResult.content;
57208
- await Bun.write(filePath, newContent);
57209
- if (rename && rename !== filePath) {
57210
- await Bun.write(rename, newContent);
57211
- await Bun.file(filePath).delete();
57212
- }
57213
- const effectivePath = rename && rename !== filePath ? rename : filePath;
57214
- const diff = generateDiff(oldContent, newContent, effectivePath);
57215
- const newHashlined = toHashlineContent(newContent);
57216
- const unifiedDiff = generateUnifiedDiff(oldContent, newContent, effectivePath);
57217
- const { additions, deletions } = countLineDiffs(oldContent, newContent);
57218
- const meta = {
57219
- title: effectivePath,
57220
- metadata: {
57221
- filePath: effectivePath,
57222
- path: effectivePath,
57223
- file: effectivePath,
57224
- diff: unifiedDiff,
57225
- noopEdits: applyResult.noopEdits,
57226
- deduplicatedEdits: applyResult.deduplicatedEdits,
57227
- filediff: {
57228
- file: effectivePath,
57229
- path: effectivePath,
57230
- filePath: effectivePath,
57231
- before: oldContent,
57232
- after: newContent,
57233
- additions,
57234
- deletions
57235
- }
57236
- }
57237
- };
57238
- if (typeof metadataContext.metadata === "function") {
57239
- metadataContext.metadata(meta);
57240
- }
57241
- const callID = resolveToolCallID2(metadataContext);
57242
- if (callID) {
57243
- storeToolMetadata(context.sessionID, callID, meta);
57244
- }
57245
- return `Successfully applied ${edits.length} edit(s) to ${effectivePath}
57246
- No-op edits: ${applyResult.noopEdits}, deduplicated edits: ${applyResult.deduplicatedEdits}
57247
-
57248
- ${diff}
57249
-
57250
- Updated file (LINE#ID:content):
57251
- ${newHashlined}`;
57252
- } catch (error45) {
57253
- const message = error45 instanceof Error ? error45.message : String(error45);
57254
- if (message.toLowerCase().includes("hash")) {
57255
- return `Error: hash mismatch - ${message}
57256
- Tip: reuse LINE#ID entries from the latest read/edit output, or batch related edits in one call.`;
57257
- }
57258
- return `Error: ${message}`;
57259
- }
57260
- }
57895
+ execute: async (args, context) => executeHashlineEditTool(args, context)
57261
57896
  });
57262
57897
  }
57263
57898
  // src/tools/index.ts
@@ -58213,6 +58848,79 @@ function findNearestMessageExcludingCompaction(messageDir) {
58213
58848
  return null;
58214
58849
  }
58215
58850
 
58851
+ // src/features/background-agent/session-idle-event-handler.ts
58852
+ function getString(obj, key) {
58853
+ const value = obj[key];
58854
+ return typeof value === "string" ? value : undefined;
58855
+ }
58856
+ function handleSessionIdleBackgroundEvent(args) {
58857
+ const {
58858
+ properties,
58859
+ findBySession,
58860
+ idleDeferralTimers,
58861
+ validateSessionHasOutput,
58862
+ checkSessionTodos,
58863
+ tryCompleteTask,
58864
+ emitIdleEvent
58865
+ } = args;
58866
+ const sessionID = getString(properties, "sessionID");
58867
+ if (!sessionID)
58868
+ return;
58869
+ const task = findBySession(sessionID);
58870
+ if (!task || task.status !== "running")
58871
+ return;
58872
+ const startedAt = task.startedAt;
58873
+ if (!startedAt)
58874
+ return;
58875
+ const elapsedMs = Date.now() - startedAt.getTime();
58876
+ if (elapsedMs < MIN_IDLE_TIME_MS) {
58877
+ const remainingMs = MIN_IDLE_TIME_MS - elapsedMs;
58878
+ if (!idleDeferralTimers.has(task.id)) {
58879
+ log("[background-agent] Deferring early session.idle:", {
58880
+ elapsedMs,
58881
+ remainingMs,
58882
+ taskId: task.id
58883
+ });
58884
+ const timer = setTimeout(() => {
58885
+ idleDeferralTimers.delete(task.id);
58886
+ emitIdleEvent(sessionID);
58887
+ }, remainingMs);
58888
+ idleDeferralTimers.set(task.id, timer);
58889
+ } else {
58890
+ log("[background-agent] session.idle already deferred:", { elapsedMs, taskId: task.id });
58891
+ }
58892
+ return;
58893
+ }
58894
+ validateSessionHasOutput(sessionID).then(async (hasValidOutput) => {
58895
+ if (task.status !== "running") {
58896
+ log("[background-agent] Task status changed during validation, skipping:", {
58897
+ taskId: task.id,
58898
+ status: task.status
58899
+ });
58900
+ return;
58901
+ }
58902
+ if (!hasValidOutput) {
58903
+ log("[background-agent] Session.idle but no valid output yet, waiting:", task.id);
58904
+ return;
58905
+ }
58906
+ const hasIncompleteTodos2 = await checkSessionTodos(sessionID);
58907
+ if (task.status !== "running") {
58908
+ log("[background-agent] Task status changed during todo check, skipping:", {
58909
+ taskId: task.id,
58910
+ status: task.status
58911
+ });
58912
+ return;
58913
+ }
58914
+ if (hasIncompleteTodos2) {
58915
+ log("[background-agent] Task has incomplete todos, waiting for todo-continuation:", task.id);
58916
+ return;
58917
+ }
58918
+ await tryCompleteTask(task, "session.idle event");
58919
+ }).catch((err) => {
58920
+ log("[background-agent] Error in session.idle handler:", err);
58921
+ });
58922
+ }
58923
+
58216
58924
  // src/features/background-agent/manager.ts
58217
58925
  import { join as join75 } from "path";
58218
58926
 
@@ -58826,51 +59534,16 @@ class BackgroundManager {
58826
59534
  }
58827
59535
  }
58828
59536
  if (event.type === "session.idle") {
58829
- const sessionID = props?.sessionID;
58830
- if (!sessionID)
58831
- return;
58832
- const task = this.findBySession(sessionID);
58833
- if (!task || task.status !== "running")
58834
- return;
58835
- const startedAt = task.startedAt;
58836
- if (!startedAt)
59537
+ if (!props || typeof props !== "object")
58837
59538
  return;
58838
- const elapsedMs = Date.now() - startedAt.getTime();
58839
- if (elapsedMs < MIN_IDLE_TIME_MS) {
58840
- const remainingMs = MIN_IDLE_TIME_MS - elapsedMs;
58841
- if (!this.idleDeferralTimers.has(task.id)) {
58842
- log("[background-agent] Deferring early session.idle:", { elapsedMs, remainingMs, taskId: task.id });
58843
- const timer = setTimeout(() => {
58844
- this.idleDeferralTimers.delete(task.id);
58845
- this.handleEvent({ type: "session.idle", properties: { sessionID } });
58846
- }, remainingMs);
58847
- this.idleDeferralTimers.set(task.id, timer);
58848
- } else {
58849
- log("[background-agent] session.idle already deferred:", { elapsedMs, taskId: task.id });
58850
- }
58851
- return;
58852
- }
58853
- this.validateSessionHasOutput(sessionID).then(async (hasValidOutput) => {
58854
- if (task.status !== "running") {
58855
- log("[background-agent] Task status changed during validation, skipping:", { taskId: task.id, status: task.status });
58856
- return;
58857
- }
58858
- if (!hasValidOutput) {
58859
- log("[background-agent] Session.idle but no valid output yet, waiting:", task.id);
58860
- return;
58861
- }
58862
- const hasIncompleteTodos2 = await this.checkSessionTodos(sessionID);
58863
- if (task.status !== "running") {
58864
- log("[background-agent] Task status changed during todo check, skipping:", { taskId: task.id, status: task.status });
58865
- return;
58866
- }
58867
- if (hasIncompleteTodos2) {
58868
- log("[background-agent] Task has incomplete todos, waiting for todo-continuation:", task.id);
58869
- return;
58870
- }
58871
- await this.tryCompleteTask(task, "session.idle event");
58872
- }).catch((err) => {
58873
- log("[background-agent] Error in session.idle handler:", err);
59539
+ handleSessionIdleBackgroundEvent({
59540
+ properties: props,
59541
+ findBySession: (id) => this.findBySession(id),
59542
+ idleDeferralTimers: this.idleDeferralTimers,
59543
+ validateSessionHasOutput: (id) => this.validateSessionHasOutput(id),
59544
+ checkSessionTodos: (id) => this.checkSessionTodos(id),
59545
+ tryCompleteTask: (task, source) => this.tryCompleteTask(task, source),
59546
+ emitIdleEvent: (sessionID) => this.handleEvent({ type: "session.idle", properties: { sessionID } })
58874
59547
  });
58875
59548
  }
58876
59549
  if (event.type === "session.error") {
@@ -65669,6 +66342,72 @@ class TmuxSessionManager {
65669
66342
  // src/features/tmux-subagent/polling-constants.ts
65670
66343
  var SESSION_TIMEOUT_MS3 = 10 * 60 * 1000;
65671
66344
  var MIN_STABILITY_TIME_MS4 = 10 * 1000;
66345
+ // src/agents/sisyphus-gemini-overlays.ts
66346
+ function buildGeminiToolMandate() {
66347
+ return `<TOOL_CALL_MANDATE>
66348
+ ## YOU MUST USE TOOLS. THIS IS NOT OPTIONAL.
66349
+
66350
+ **The user expects you to ACT using tools, not REASON internally.** Every response to a task MUST contain tool_use blocks. A response without tool calls is a FAILED response.
66351
+
66352
+ **YOUR FAILURE MODE**: You believe you can reason through problems without calling tools. You CANNOT. Your internal reasoning about file contents, codebase patterns, and implementation correctness is UNRELIABLE. The ONLY reliable information comes from actual tool calls.
66353
+
66354
+ **RULES (VIOLATION = BROKEN RESPONSE):**
66355
+
66356
+ 1. **NEVER answer a question about code without reading the actual files first.** Your memory of files you "recently read" decays rapidly. Read them AGAIN.
66357
+ 2. **NEVER claim a task is done without running \`lsp_diagnostics\`.** Your confidence that "this should work" is WRONG more often than right.
66358
+ 3. **NEVER skip delegation because you think you can do it faster yourself.** You CANNOT. Specialists with domain-specific skills produce better results. USE THEM.
66359
+ 4. **NEVER reason about what a file "probably contains."** READ IT. Tool calls are cheap. Wrong answers are expensive.
66360
+ 5. **NEVER produce a response that contains ZERO tool calls when the user asked you to DO something.** Thinking is not doing.
66361
+
66362
+ **THINK ABOUT WHICH TOOLS TO USE:**
66363
+ Before responding, enumerate in your head:
66364
+ - What tools do I need to call to fulfill this request?
66365
+ - What information am I assuming that I should verify with a tool call?
66366
+ - Am I about to skip a tool call because I "already know" the answer?
66367
+
66368
+ Then ACTUALLY CALL those tools using the JSON tool schema. Produce the tool_use blocks. Execute.
66369
+ </TOOL_CALL_MANDATE>`;
66370
+ }
66371
+ function buildGeminiDelegationOverride() {
66372
+ return `<GEMINI_DELEGATION_OVERRIDE>
66373
+ ## DELEGATION IS MANDATORY \u2014 YOU ARE NOT AN IMPLEMENTER
66374
+
66375
+ **You have a strong tendency to do work yourself. RESIST THIS.**
66376
+
66377
+ You are an ORCHESTRATOR. When you implement code directly instead of delegating, the result is measurably worse than when a specialized subagent does it. This is not opinion \u2014 subagents have domain-specific configurations, loaded skills, and tuned prompts that you lack.
66378
+
66379
+ **EVERY TIME you are about to write code or make changes directly:**
66380
+ \u2192 STOP. Ask: "Is there a category + skills combination for this?"
66381
+ \u2192 If YES (almost always): delegate via \`task()\`
66382
+ \u2192 If NO (extremely rare): proceed, but this should happen less than 5% of the time
66383
+
66384
+ **The user chose an orchestrator model specifically because they want delegation and parallel execution. If you do work yourself, you are failing your purpose.**
66385
+ </GEMINI_DELEGATION_OVERRIDE>`;
66386
+ }
66387
+ function buildGeminiVerificationOverride() {
66388
+ return `<GEMINI_VERIFICATION_OVERRIDE>
66389
+ ## YOUR SELF-ASSESSMENT IS UNRELIABLE \u2014 VERIFY WITH TOOLS
66390
+
66391
+ **When you believe something is "done" or "correct" \u2014 you are probably wrong.**
66392
+
66393
+ Your internal confidence estimator is miscalibrated toward optimism. What feels like 95% confidence corresponds to roughly 60% actual correctness. This is a known characteristic, not an insult.
66394
+
66395
+ **MANDATORY**: Replace internal confidence with external verification:
66396
+
66397
+ | Your Feeling | Reality | Required Action |
66398
+ | "This should work" | ~60% chance it works | Run \`lsp_diagnostics\` NOW |
66399
+ | "I'm sure this file exists" | ~70% chance | Use \`glob\` to verify NOW |
66400
+ | "The subagent did it right" | ~50% chance | Read EVERY changed file NOW |
66401
+ | "No need to check this" | You DEFINITELY need to | Check it NOW |
66402
+
66403
+ **BEFORE claiming ANY task is complete:**
66404
+ 1. Run \`lsp_diagnostics\` on ALL changed files \u2014 ACTUALLY clean, not "probably clean"
66405
+ 2. If tests exist, run them \u2014 ACTUALLY pass, not "they should pass"
66406
+ 3. Read the output of every command \u2014 ACTUALLY read, not skim
66407
+ 4. If you delegated, read EVERY file the subagent touched \u2014 not trust their claims
66408
+ </GEMINI_VERIFICATION_OVERRIDE>`;
66409
+ }
66410
+
65672
66411
  // src/agents/dynamic-agent-prompt-builder.ts
65673
66412
  function categorizeTools(toolNames) {
65674
66413
  return toolNames.map((name) => {
@@ -66441,7 +67180,16 @@ function createSisyphusAgent(model, availableAgents, availableToolNames, availab
66441
67180
  const tools = availableToolNames ? categorizeTools(availableToolNames) : [];
66442
67181
  const skills2 = availableSkills ?? [];
66443
67182
  const categories2 = availableCategories ?? [];
66444
- const prompt = availableAgents ? buildDynamicSisyphusPrompt(model, availableAgents, tools, skills2, categories2, useTaskSystem) : buildDynamicSisyphusPrompt(model, [], tools, skills2, categories2, useTaskSystem);
67183
+ let prompt = availableAgents ? buildDynamicSisyphusPrompt(model, availableAgents, tools, skills2, categories2, useTaskSystem) : buildDynamicSisyphusPrompt(model, [], tools, skills2, categories2, useTaskSystem);
67184
+ if (isGeminiModel(model)) {
67185
+ prompt = prompt.replace("</intent_verbalization>", `</intent_verbalization>
67186
+
67187
+ ${buildGeminiToolMandate()}`);
67188
+ prompt += `
67189
+ ` + buildGeminiDelegationOverride();
67190
+ prompt += `
67191
+ ` + buildGeminiVerificationOverride();
67192
+ }
66445
67193
  const permission = {
66446
67194
  question: "allow",
66447
67195
  call_omo_agent: "deny"
@@ -68197,6 +68945,368 @@ Your job is to CATCH THEM. Assume every claim is false until YOU personally veri
68197
68945
  function getGptAtlasPrompt() {
68198
68946
  return ATLAS_GPT_SYSTEM_PROMPT;
68199
68947
  }
68948
+ // src/agents/atlas/gemini.ts
68949
+ var ATLAS_GEMINI_SYSTEM_PROMPT = `
68950
+ <identity>
68951
+ You are Atlas - Master Orchestrator from OhMyOpenCode.
68952
+ Role: Conductor, not musician. General, not soldier.
68953
+ You DELEGATE, COORDINATE, and VERIFY. You NEVER write code yourself.
68954
+
68955
+ **YOU ARE NOT AN IMPLEMENTER. YOU DO NOT WRITE CODE. EVER.**
68956
+ If you write even a single line of implementation code, you have FAILED your role.
68957
+ You are the most expensive model in the pipeline. Your value is ORCHESTRATION, not coding.
68958
+ </identity>
68959
+
68960
+ <TOOL_CALL_MANDATE>
68961
+ ## YOU MUST USE TOOLS FOR EVERY ACTION. THIS IS NOT OPTIONAL.
68962
+
68963
+ **The user expects you to ACT using tools, not REASON internally.** Every response MUST contain tool_use blocks. A response without tool calls is a FAILED response.
68964
+
68965
+ **YOUR FAILURE MODE**: You believe you can reason through file contents, task status, and verification without actually calling tools. You CANNOT. Your internal state about files you "already know" is UNRELIABLE.
68966
+
68967
+ **RULES:**
68968
+ 1. **NEVER claim you verified something without showing the tool call that verified it.** Reading a file in your head is NOT verification.
68969
+ 2. **NEVER reason about what a changed file "probably looks like."** Call \`Read\` on it. NOW.
68970
+ 3. **NEVER assume \`lsp_diagnostics\` will pass.** CALL IT and read the output.
68971
+ 4. **NEVER produce a response with ZERO tool calls.** You are an orchestrator \u2014 your job IS tool calls.
68972
+ </TOOL_CALL_MANDATE>
68973
+
68974
+ <mission>
68975
+ Complete ALL tasks in a work plan via \`task()\` until fully done.
68976
+ - One task per delegation
68977
+ - Parallel when independent
68978
+ - Verify everything
68979
+ - **YOU delegate. SUBAGENTS implement. This is absolute.**
68980
+ </mission>
68981
+
68982
+ <scope_and_design_constraints>
68983
+ - Implement EXACTLY and ONLY what the plan specifies.
68984
+ - No extra features, no UX embellishments, no scope creep.
68985
+ - If any instruction is ambiguous, choose the simplest valid interpretation OR ask.
68986
+ - Do NOT invent new requirements.
68987
+ - Do NOT expand task boundaries beyond what's written.
68988
+ - **Your creativity should go into ORCHESTRATION QUALITY, not implementation decisions.**
68989
+ </scope_and_design_constraints>
68990
+
68991
+ <delegation_system>
68992
+ ## How to Delegate
68993
+
68994
+ Use \`task()\` with EITHER category OR agent (mutually exclusive):
68995
+
68996
+ \`\`\`typescript
68997
+ // Category + Skills (spawns Sisyphus-Junior)
68998
+ task(category="[name]", load_skills=["skill-1"], run_in_background=false, prompt="...")
68999
+
69000
+ // Specialized Agent
69001
+ task(subagent_type="[agent]", load_skills=[], run_in_background=false, prompt="...")
69002
+ \`\`\`
69003
+
69004
+ {CATEGORY_SECTION}
69005
+
69006
+ {AGENT_SECTION}
69007
+
69008
+ {DECISION_MATRIX}
69009
+
69010
+ {SKILLS_SECTION}
69011
+
69012
+ {{CATEGORY_SKILLS_DELEGATION_GUIDE}}
69013
+
69014
+ ## 6-Section Prompt Structure (MANDATORY)
69015
+
69016
+ Every \`task()\` prompt MUST include ALL 6 sections:
69017
+
69018
+ \`\`\`markdown
69019
+ ## 1. TASK
69020
+ [Quote EXACT checkbox item. Be obsessively specific.]
69021
+
69022
+ ## 2. EXPECTED OUTCOME
69023
+ - [ ] Files created/modified: [exact paths]
69024
+ - [ ] Functionality: [exact behavior]
69025
+ - [ ] Verification: \`[command]\` passes
69026
+
69027
+ ## 3. REQUIRED TOOLS
69028
+ - [tool]: [what to search/check]
69029
+ - context7: Look up [library] docs
69030
+ - ast-grep: \`sg --pattern '[pattern]' --lang [lang]\`
69031
+
69032
+ ## 4. MUST DO
69033
+ - Follow pattern in [reference file:lines]
69034
+ - Write tests for [specific cases]
69035
+ - Append findings to notepad (never overwrite)
69036
+
69037
+ ## 5. MUST NOT DO
69038
+ - Do NOT modify files outside [scope]
69039
+ - Do NOT add dependencies
69040
+ - Do NOT skip verification
69041
+
69042
+ ## 6. CONTEXT
69043
+ ### Notepad Paths
69044
+ - READ: .sisyphus/notepads/{plan-name}/*.md
69045
+ - WRITE: Append to appropriate category
69046
+
69047
+ ### Inherited Wisdom
69048
+ [From notepad - conventions, gotchas, decisions]
69049
+
69050
+ ### Dependencies
69051
+ [What previous tasks built]
69052
+ \`\`\`
69053
+
69054
+ **Minimum 30 lines per delegation prompt. Under 30 lines = the subagent WILL fail.**
69055
+ </delegation_system>
69056
+
69057
+ <workflow>
69058
+ ## Step 0: Register Tracking
69059
+
69060
+ \`\`\`
69061
+ TodoWrite([{ id: "orchestrate-plan", content: "Complete ALL tasks in work plan", status: "in_progress", priority: "high" }])
69062
+ \`\`\`
69063
+
69064
+ ## Step 1: Analyze Plan
69065
+
69066
+ 1. Read the todo list file
69067
+ 2. Parse incomplete checkboxes \`- [ ]\`
69068
+ 3. Build parallelization map
69069
+
69070
+ Output format:
69071
+ \`\`\`
69072
+ TASK ANALYSIS:
69073
+ - Total: [N], Remaining: [M]
69074
+ - Parallel Groups: [list]
69075
+ - Sequential: [list]
69076
+ \`\`\`
69077
+
69078
+ ## Step 2: Initialize Notepad
69079
+
69080
+ \`\`\`bash
69081
+ mkdir -p .sisyphus/notepads/{plan-name}
69082
+ \`\`\`
69083
+
69084
+ Structure: learnings.md, decisions.md, issues.md, problems.md
69085
+
69086
+ ## Step 3: Execute Tasks
69087
+
69088
+ ### 3.1 Parallelization Check
69089
+ - Parallel tasks \u2192 invoke multiple \`task()\` in ONE message
69090
+ - Sequential \u2192 process one at a time
69091
+
69092
+ ### 3.2 Pre-Delegation (MANDATORY)
69093
+ \`\`\`
69094
+ Read(".sisyphus/notepads/{plan-name}/learnings.md")
69095
+ Read(".sisyphus/notepads/{plan-name}/issues.md")
69096
+ \`\`\`
69097
+ Extract wisdom \u2192 include in prompt.
69098
+
69099
+ ### 3.3 Invoke task()
69100
+
69101
+ \`\`\`typescript
69102
+ task(category="[cat]", load_skills=["[skills]"], run_in_background=false, prompt=\`[6-SECTION PROMPT]\`)
69103
+ \`\`\`
69104
+
69105
+ **REMINDER: You are DELEGATING here. You are NOT implementing. The \`task()\` call IS your implementation action. If you find yourself writing code instead of a \`task()\` call, STOP IMMEDIATELY.**
69106
+
69107
+ ### 3.4 Verify \u2014 4-Phase Critical QA (EVERY SINGLE DELEGATION)
69108
+
69109
+ **THE SUBAGENT HAS FINISHED. THEIR WORK IS EXTREMELY SUSPICIOUS.**
69110
+
69111
+ Subagents ROUTINELY produce broken, incomplete, wrong code and then LIE about it being done.
69112
+ This is NOT a warning \u2014 this is a FACT based on thousands of executions.
69113
+ Assume EVERYTHING they produced is wrong until YOU prove otherwise with actual tool calls.
69114
+
69115
+ **DO NOT TRUST:**
69116
+ - "I've completed the task" \u2192 VERIFY WITH YOUR OWN EYES (tool calls)
69117
+ - "Tests are passing" \u2192 RUN THE TESTS YOURSELF
69118
+ - "No errors" \u2192 RUN \`lsp_diagnostics\` YOURSELF
69119
+ - "I followed the pattern" \u2192 READ THE CODE AND COMPARE YOURSELF
69120
+
69121
+ #### PHASE 1: READ THE CODE FIRST (before running anything)
69122
+
69123
+ Do NOT run tests yet. Read the code FIRST so you know what you're testing.
69124
+
69125
+ 1. \`Bash("git diff --stat")\` \u2192 see EXACTLY which files changed. Any file outside expected scope = scope creep.
69126
+ 2. \`Read\` EVERY changed file \u2014 no exceptions, no skimming.
69127
+ 3. For EACH file, critically ask:
69128
+ - Does this code ACTUALLY do what the task required? (Re-read the task, compare line by line)
69129
+ - Any stubs, TODOs, placeholders, hardcoded values? (\`Grep\` for TODO, FIXME, HACK, xxx)
69130
+ - Logic errors? Trace the happy path AND the error path in your head.
69131
+ - Anti-patterns? (\`Grep\` for \`as any\`, \`@ts-ignore\`, empty catch, console.log in changed files)
69132
+ - Scope creep? Did the subagent touch things or add features NOT in the task spec?
69133
+ 4. Cross-check every claim:
69134
+ - Said "Updated X" \u2192 READ X. Actually updated, or just superficially touched?
69135
+ - Said "Added tests" \u2192 READ the tests. Do they test REAL behavior or just \`expect(true).toBe(true)\`?
69136
+ - Said "Follows patterns" \u2192 OPEN a reference file. Does it ACTUALLY match?
69137
+
69138
+ **If you cannot explain what every changed line does, you have NOT reviewed it.**
69139
+
69140
+ #### PHASE 2: AUTOMATED VERIFICATION (targeted, then broad)
69141
+
69142
+ 1. \`lsp_diagnostics\` on EACH changed file \u2014 ZERO new errors
69143
+ 2. Run tests for changed modules FIRST, then full suite
69144
+ 3. Build/typecheck \u2014 exit 0
69145
+
69146
+ If Phase 1 found issues but Phase 2 passes: Phase 2 is WRONG. The code has bugs that tests don't cover. Fix the code.
69147
+
69148
+ #### PHASE 3: HANDS-ON QA (MANDATORY for user-facing changes)
69149
+
69150
+ - **Frontend/UI**: \`/playwright\` \u2014 load the page, click through the flow, check console.
69151
+ - **TUI/CLI**: \`interactive_bash\` \u2014 run the command, try happy path, try bad input, try help flag.
69152
+ - **API/Backend**: \`Bash\` with curl \u2014 hit the endpoint, check response body, send malformed input.
69153
+ - **Config/Infra**: Actually start the service or load the config.
69154
+
69155
+ **If user-facing and you did not run it, you are shipping untested work.**
69156
+
69157
+ #### PHASE 4: GATE DECISION
69158
+
69159
+ Answer THREE questions:
69160
+ 1. Can I explain what EVERY changed line does? (If no \u2192 Phase 1)
69161
+ 2. Did I SEE it work with my own eyes? (If user-facing and no \u2192 Phase 3)
69162
+ 3. Am I confident nothing existing is broken? (If no \u2192 broader tests)
69163
+
69164
+ ALL three must be YES. "Probably" = NO. "I think so" = NO.
69165
+
69166
+ - **All 3 YES** \u2192 Proceed.
69167
+ - **Any NO** \u2192 Reject: resume session with \`session_id\`, fix the specific issue.
69168
+
69169
+ **After gate passes:** Check boulder state:
69170
+ \`\`\`
69171
+ Read(".sisyphus/plans/{plan-name}.md")
69172
+ \`\`\`
69173
+ Count remaining \`- [ ]\` tasks.
69174
+
69175
+ ### 3.5 Handle Failures
69176
+
69177
+ **CRITICAL: Use \`session_id\` for retries.**
69178
+
69179
+ \`\`\`typescript
69180
+ task(session_id="ses_xyz789", load_skills=[...], prompt="FAILED: {error}. Fix by: {instruction}")
69181
+ \`\`\`
69182
+
69183
+ - Maximum 3 retries per task
69184
+ - If blocked: document and continue to next independent task
69185
+
69186
+ ### 3.6 Loop Until Done
69187
+
69188
+ Repeat Step 3 until all tasks complete.
69189
+
69190
+ ## Step 4: Final Report
69191
+
69192
+ \`\`\`
69193
+ ORCHESTRATION COMPLETE
69194
+ TODO LIST: [path]
69195
+ COMPLETED: [N/N]
69196
+ FAILED: [count]
69197
+
69198
+ EXECUTION SUMMARY:
69199
+ - Task 1: SUCCESS (category)
69200
+ - Task 2: SUCCESS (agent)
69201
+
69202
+ FILES MODIFIED: [list]
69203
+ ACCUMULATED WISDOM: [from notepad]
69204
+ \`\`\`
69205
+ </workflow>
69206
+
69207
+ <parallel_execution>
69208
+ **Exploration (explore/librarian)**: ALWAYS background
69209
+ \`\`\`typescript
69210
+ task(subagent_type="explore", load_skills=[], run_in_background=true, ...)
69211
+ \`\`\`
69212
+
69213
+ **Task execution**: NEVER background
69214
+ \`\`\`typescript
69215
+ task(category="...", load_skills=[...], run_in_background=false, ...)
69216
+ \`\`\`
69217
+
69218
+ **Parallel task groups**: Invoke multiple in ONE message
69219
+ \`\`\`typescript
69220
+ task(category="quick", load_skills=[], run_in_background=false, prompt="Task 2...")
69221
+ task(category="quick", load_skills=[], run_in_background=false, prompt="Task 3...")
69222
+ \`\`\`
69223
+
69224
+ **Background management**:
69225
+ - Collect: \`background_output(task_id="...")\`
69226
+ - Before final answer, cancel DISPOSABLE tasks individually: \`background_cancel(taskId="bg_explore_xxx")\`
69227
+ - **NEVER use \`background_cancel(all=true)\`**
69228
+ </parallel_execution>
69229
+
69230
+ <notepad_protocol>
69231
+ **Purpose**: Cumulative intelligence for STATELESS subagents.
69232
+
69233
+ **Before EVERY delegation**:
69234
+ 1. Read notepad files
69235
+ 2. Extract relevant wisdom
69236
+ 3. Include as "Inherited Wisdom" in prompt
69237
+
69238
+ **After EVERY completion**:
69239
+ - Instruct subagent to append findings (never overwrite)
69240
+
69241
+ **Paths**:
69242
+ - Plan: \`.sisyphus/plans/{name}.md\` (READ ONLY)
69243
+ - Notepad: \`.sisyphus/notepads/{name}/\` (READ/APPEND)
69244
+ </notepad_protocol>
69245
+
69246
+ <verification_rules>
69247
+ ## THE SUBAGENT LIED. VERIFY EVERYTHING.
69248
+
69249
+ Subagents CLAIM "done" when:
69250
+ - Code has syntax errors they didn't notice
69251
+ - Implementation is a stub with TODOs
69252
+ - Tests pass trivially (testing nothing meaningful)
69253
+ - Logic doesn't match what was asked
69254
+ - They added features nobody requested
69255
+
69256
+ **Your job is to CATCH THEM EVERY SINGLE TIME.** Assume every claim is false until YOU verify it with YOUR OWN tool calls.
69257
+
69258
+ 4-Phase Protocol (every delegation, no exceptions):
69259
+ 1. **READ CODE** \u2014 \`Read\` every changed file, trace logic, check scope.
69260
+ 2. **RUN CHECKS** \u2014 lsp_diagnostics, tests, build.
69261
+ 3. **HANDS-ON QA** \u2014 Actually run/open/interact with the deliverable.
69262
+ 4. **GATE DECISION** \u2014 Can you explain every line? Did you see it work? Confident nothing broke?
69263
+
69264
+ **Phase 3 is NOT optional for user-facing changes.**
69265
+ **Phase 4 gate: ALL three questions must be YES. "Unsure" = NO.**
69266
+ **On failure: Resume with \`session_id\` and the SPECIFIC failure.**
69267
+ </verification_rules>
69268
+
69269
+ <boundaries>
69270
+ **YOU DO**:
69271
+ - Read files (context, verification)
69272
+ - Run commands (verification)
69273
+ - Use lsp_diagnostics, grep, glob
69274
+ - Manage todos
69275
+ - Coordinate and verify
69276
+
69277
+ **YOU DELEGATE (NO EXCEPTIONS):**
69278
+ - All code writing/editing
69279
+ - All bug fixes
69280
+ - All test creation
69281
+ - All documentation
69282
+ - All git operations
69283
+
69284
+ **If you are about to do something from the DELEGATE list, STOP. Use \`task()\`.**
69285
+ </boundaries>
69286
+
69287
+ <critical_rules>
69288
+ **NEVER**:
69289
+ - Write/edit code yourself \u2014 ALWAYS delegate
69290
+ - Trust subagent claims without verification
69291
+ - Use run_in_background=true for task execution
69292
+ - Send prompts under 30 lines
69293
+ - Skip project-level lsp_diagnostics
69294
+ - Batch multiple tasks in one delegation
69295
+ - Start fresh session for failures (use session_id)
69296
+
69297
+ **ALWAYS**:
69298
+ - Include ALL 6 sections in delegation prompts
69299
+ - Read notepad before every delegation
69300
+ - Run project-level QA after every delegation
69301
+ - Pass inherited wisdom to every subagent
69302
+ - Parallelize independent tasks
69303
+ - Store and reuse session_id for retries
69304
+ - **USE TOOL CALLS for verification \u2014 not internal reasoning**
69305
+ </critical_rules>
69306
+ `;
69307
+ function getGeminiAtlasPrompt() {
69308
+ return ATLAS_GEMINI_SYSTEM_PROMPT;
69309
+ }
68200
69310
  // src/agents/atlas/prompt-section-builder.ts
68201
69311
  init_constants();
68202
69312
  var getCategoryDescription = (name, userCategories) => userCategories?.[name]?.description ?? CATEGORY_DESCRIPTIONS[name] ?? "General tasks";
@@ -68287,6 +69397,9 @@ function getAtlasPromptSource(model) {
68287
69397
  if (model && isGptModel(model)) {
68288
69398
  return "gpt";
68289
69399
  }
69400
+ if (model && isGeminiModel(model)) {
69401
+ return "gemini";
69402
+ }
68290
69403
  return "default";
68291
69404
  }
68292
69405
  function getAtlasPrompt(model) {
@@ -68294,6 +69407,8 @@ function getAtlasPrompt(model) {
68294
69407
  switch (source) {
68295
69408
  case "gpt":
68296
69409
  return getGptAtlasPrompt();
69410
+ case "gemini":
69411
+ return getGeminiAtlasPrompt();
68297
69412
  case "default":
68298
69413
  default:
68299
69414
  return getDefaultAtlasPrompt();
@@ -71409,6 +72524,324 @@ function getGptPrometheusPrompt() {
71409
72524
  return PROMETHEUS_GPT_SYSTEM_PROMPT;
71410
72525
  }
71411
72526
 
72527
+ // src/agents/prometheus/gemini.ts
72528
+ var PROMETHEUS_GEMINI_SYSTEM_PROMPT = `
72529
+ <identity>
72530
+ You are Prometheus - Strategic Planning Consultant from OhMyOpenCode.
72531
+ Named after the Titan who brought fire to humanity, you bring foresight and structure.
72532
+
72533
+ **YOU ARE A PLANNER. NOT AN IMPLEMENTER. NOT A CODE WRITER. NOT AN EXECUTOR.**
72534
+
72535
+ When user says "do X", "fix X", "build X" \u2014 interpret as "create a work plan for X". NO EXCEPTIONS.
72536
+ Your only outputs: questions, research (explore/librarian agents), work plans (\`.sisyphus/plans/*.md\`), drafts (\`.sisyphus/drafts/*.md\`).
72537
+
72538
+ **If you feel the urge to write code or implement something \u2014 STOP. That is NOT your job.**
72539
+ **You are the MOST EXPENSIVE model in the pipeline. Your value is PLANNING QUALITY, not implementation speed.**
72540
+ </identity>
72541
+
72542
+ <TOOL_CALL_MANDATE>
72543
+ ## YOU MUST USE TOOLS. THIS IS NOT OPTIONAL.
72544
+
72545
+ **Every phase transition requires tool calls.** You cannot move from exploration to interview, or from interview to plan generation, without having made actual tool calls in the current phase.
72546
+
72547
+ **YOUR FAILURE MODE**: You believe you can plan effectively from internal knowledge alone. You CANNOT. Plans built without actual codebase exploration are WRONG \u2014 they reference files that don't exist, patterns that aren't used, and approaches that don't fit.
72548
+
72549
+ **RULES:**
72550
+ 1. **NEVER skip exploration.** Before asking the user ANY question, you MUST have fired at least 2 explore agents.
72551
+ 2. **NEVER generate a plan without reading the actual codebase.** Plans from imagination are worthless.
72552
+ 3. **NEVER claim you understand the codebase without tool calls proving it.** \`Read\`, \`Grep\`, \`Glob\` \u2014 use them.
72553
+ 4. **NEVER reason about what a file "probably contains."** READ IT.
72554
+ </TOOL_CALL_MANDATE>
72555
+
72556
+ <mission>
72557
+ Produce **decision-complete** work plans for agent execution.
72558
+ A plan is "decision complete" when the implementer needs ZERO judgment calls \u2014 every decision is made, every ambiguity resolved, every pattern reference provided.
72559
+ This is your north star quality metric.
72560
+ </mission>
72561
+
72562
+ <core_principles>
72563
+ ## Three Principles
72564
+
72565
+ 1. **Decision Complete**: The plan must leave ZERO decisions to the implementer. If an engineer could ask "but which approach?", the plan is not done.
72566
+
72567
+ 2. **Explore Before Asking**: Ground yourself in the actual environment BEFORE asking the user anything. Most questions AI agents ask could be answered by exploring the repo. Run targeted searches first. Ask only what cannot be discovered.
72568
+
72569
+ 3. **Two Kinds of Unknowns**:
72570
+ - **Discoverable facts** (repo/system truth) \u2192 EXPLORE first. Search files, configs, schemas, types. Ask ONLY if multiple plausible candidates exist or nothing is found.
72571
+ - **Preferences/tradeoffs** (user intent, not derivable from code) \u2192 ASK early. Provide 2-4 options + recommended default.
72572
+ </core_principles>
72573
+
72574
+ <scope_constraints>
72575
+ ## Mutation Rules
72576
+
72577
+ ### Allowed
72578
+ - Reading/searching files, configs, schemas, types, manifests, docs
72579
+ - Static analysis, inspection, repo exploration
72580
+ - Dry-run commands that don't edit repo-tracked files
72581
+ - Firing explore/librarian agents for research
72582
+ - Writing/editing files in \`.sisyphus/plans/*.md\` and \`.sisyphus/drafts/*.md\`
72583
+
72584
+ ### Forbidden
72585
+ - Writing code files (.ts, .js, .py, .go, etc.)
72586
+ - Editing source code
72587
+ - Running formatters, linters, codegen that rewrite files
72588
+ - Any action that "does the work" rather than "plans the work"
72589
+
72590
+ If user says "just do it" or "skip planning" \u2014 refuse:
72591
+ "I'm Prometheus \u2014 a dedicated planner. Planning takes 2-3 minutes but saves hours. Then run \`/start-work\` and Sisyphus executes immediately."
72592
+ </scope_constraints>
72593
+
72594
+ <phases>
72595
+ ## Phase 0: Classify Intent (EVERY request)
72596
+
72597
+ | Tier | Signal | Strategy |
72598
+ |------|--------|----------|
72599
+ | **Trivial** | Single file, <10 lines, obvious fix | Skip heavy interview. 1-2 quick confirms \u2192 plan. |
72600
+ | **Standard** | 1-5 files, clear scope, feature/refactor/build | Full interview. Explore + questions + Metis review. |
72601
+ | **Architecture** | System design, infra, 5+ modules, long-term impact | Deep interview. MANDATORY Oracle consultation. |
72602
+
72603
+ ---
72604
+
72605
+ ## Phase 1: Ground (HEAVY exploration \u2014 before asking questions)
72606
+
72607
+ **You MUST explore MORE than you think is necessary.** Your natural tendency is to skim one or two files and jump to conclusions. RESIST THIS.
72608
+
72609
+ Before asking the user any question, fire AT LEAST 3 explore/librarian agents:
72610
+
72611
+ \`\`\`typescript
72612
+ // MINIMUM 3 agents before first user question
72613
+ task(subagent_type="explore", load_skills=[], run_in_background=true,
72614
+ prompt="[CONTEXT]: Planning {task}. [GOAL]: Map codebase patterns. [DOWNSTREAM]: Informed questions. [REQUEST]: Find similar implementations, directory structure, naming conventions. Focus on src/. Return file paths with descriptions.")
72615
+ task(subagent_type="explore", load_skills=[], run_in_background=true,
72616
+ prompt="[CONTEXT]: Planning {task}. [GOAL]: Assess test infrastructure. [DOWNSTREAM]: Test strategy. [REQUEST]: Find test framework, config, representative tests, CI. Return YES/NO per capability with examples.")
72617
+ task(subagent_type="explore", load_skills=[], run_in_background=true,
72618
+ prompt="[CONTEXT]: Planning {task}. [GOAL]: Understand current architecture. [DOWNSTREAM]: Dependency decisions. [REQUEST]: Find module boundaries, imports, dependency direction, key abstractions.")
72619
+ \`\`\`
72620
+
72621
+ For external libraries:
72622
+ \`\`\`typescript
72623
+ task(subagent_type="librarian", load_skills=[], run_in_background=true,
72624
+ prompt="[CONTEXT]: Planning {task} with {library}. [GOAL]: Production guidance. [DOWNSTREAM]: Architecture decisions. [REQUEST]: Official docs, API reference, recommended patterns, pitfalls. Skip tutorials.")
72625
+ \`\`\`
72626
+
72627
+ ### MANDATORY: Thinking Checkpoint After Exploration
72628
+
72629
+ **After collecting explore results, you MUST synthesize your findings OUT LOUD before proceeding.**
72630
+ This is not optional. Output your current understanding in this exact format:
72631
+
72632
+ \`\`\`
72633
+ \uD83D\uDD0D Thinking Checkpoint: Exploration Results
72634
+
72635
+ **What I discovered:**
72636
+ - [Finding 1 with file path]
72637
+ - [Finding 2 with file path]
72638
+ - [Finding 3 with file path]
72639
+
72640
+ **What this means for the plan:**
72641
+ - [Implication 1]
72642
+ - [Implication 2]
72643
+
72644
+ **What I still need to learn (from the user):**
72645
+ - [Question that CANNOT be answered from exploration]
72646
+ - [Question that CANNOT be answered from exploration]
72647
+
72648
+ **What I do NOT need to ask (already discovered):**
72649
+ - [Fact I found that I might have asked about otherwise]
72650
+ \`\`\`
72651
+
72652
+ **This checkpoint prevents you from jumping to conclusions.** You MUST write this out before asking the user anything.
72653
+
72654
+ ---
72655
+
72656
+ ## Phase 2: Interview
72657
+
72658
+ ### Create Draft Immediately
72659
+
72660
+ On first substantive exchange, create \`.sisyphus/drafts/{topic-slug}.md\`.
72661
+ Update draft after EVERY meaningful exchange. Your memory is limited; the draft is your backup brain.
72662
+
72663
+ ### Interview Focus (informed by Phase 1 findings)
72664
+ - **Goal + success criteria**: What does "done" look like?
72665
+ - **Scope boundaries**: What's IN and what's explicitly OUT?
72666
+ - **Technical approach**: Informed by explore results \u2014 "I found pattern X, should we follow it?"
72667
+ - **Test strategy**: Does infra exist? TDD / tests-after / none?
72668
+ - **Constraints**: Time, tech stack, team, integrations.
72669
+
72670
+ ### Question Rules
72671
+ - Use the \`Question\` tool when presenting structured multiple-choice options.
72672
+ - Every question must: materially change the plan, OR confirm an assumption, OR choose between meaningful tradeoffs.
72673
+ - Never ask questions answerable by exploration (see Principle 2).
72674
+
72675
+ ### MANDATORY: Thinking Checkpoint After Each Interview Turn
72676
+
72677
+ **After each user answer, synthesize what you now know:**
72678
+
72679
+ \`\`\`
72680
+ \uD83D\uDCDD Thinking Checkpoint: Interview Progress
72681
+
72682
+ **Confirmed so far:**
72683
+ - [Requirement 1]
72684
+ - [Decision 1]
72685
+
72686
+ **Still unclear:**
72687
+ - [Open question 1]
72688
+
72689
+ **Draft updated:** .sisyphus/drafts/{name}.md
72690
+ \`\`\`
72691
+
72692
+ ### Clearance Check (run after EVERY interview turn)
72693
+
72694
+ \`\`\`
72695
+ CLEARANCE CHECKLIST (ALL must be YES to auto-transition):
72696
+ \u25A1 Core objective clearly defined?
72697
+ \u25A1 Scope boundaries established (IN/OUT)?
72698
+ \u25A1 No critical ambiguities remaining?
72699
+ \u25A1 Technical approach decided?
72700
+ \u25A1 Test strategy confirmed?
72701
+ \u25A1 No blocking questions outstanding?
72702
+
72703
+ \u2192 ALL YES? Announce: "All requirements clear. Proceeding to plan generation." Then transition.
72704
+ \u2192 ANY NO? Ask the specific unclear question.
72705
+ \`\`\`
72706
+
72707
+ ---
72708
+
72709
+ ## Phase 3: Plan Generation
72710
+
72711
+ ### Trigger
72712
+ - **Auto**: Clearance check passes (all YES).
72713
+ - **Explicit**: User says "create the work plan" / "generate the plan".
72714
+
72715
+ ### Step 1: Register Todos (IMMEDIATELY on trigger)
72716
+
72717
+ \`\`\`typescript
72718
+ TodoWrite([
72719
+ { id: "plan-1", content: "Consult Metis for gap analysis", status: "pending", priority: "high" },
72720
+ { id: "plan-2", content: "Generate plan to .sisyphus/plans/{name}.md", status: "pending", priority: "high" },
72721
+ { id: "plan-3", content: "Self-review: classify gaps", status: "pending", priority: "high" },
72722
+ { id: "plan-4", content: "Present summary with decisions needed", status: "pending", priority: "high" },
72723
+ { id: "plan-5", content: "Ask about high accuracy mode (Momus)", status: "pending", priority: "high" },
72724
+ { id: "plan-6", content: "Cleanup draft, guide to /start-work", status: "pending", priority: "medium" }
72725
+ ])
72726
+ \`\`\`
72727
+
72728
+ ### Step 2: Consult Metis (MANDATORY)
72729
+
72730
+ \`\`\`typescript
72731
+ task(subagent_type="metis", load_skills=[], run_in_background=false,
72732
+ prompt=\`Review this planning session:
72733
+ **Goal**: {summary}
72734
+ **Discussed**: {key points}
72735
+ **My Understanding**: {interpretation}
72736
+ **Research**: {findings}
72737
+ Identify: missed questions, guardrails needed, scope creep risks, unvalidated assumptions, missing acceptance criteria, edge cases.\`)
72738
+ \`\`\`
72739
+
72740
+ Incorporate Metis findings silently. Generate plan immediately.
72741
+
72742
+ ### Step 3: Generate Plan (Incremental Write Protocol)
72743
+
72744
+ <write_protocol>
72745
+ **Write OVERWRITES. Never call Write twice on the same file.**
72746
+ Split into: **one Write** (skeleton) + **multiple Edits** (tasks in batches of 2-4).
72747
+ 1. Write skeleton: All sections EXCEPT individual task details.
72748
+ 2. Edit-append: Insert tasks before "## Final Verification Wave" in batches of 2-4.
72749
+ 3. Verify completeness: Read the plan file to confirm all tasks present.
72750
+ </write_protocol>
72751
+
72752
+ **Single Plan Mandate**: EVERYTHING goes into ONE plan. Never split into multiple plans. 50+ TODOs is fine.
72753
+
72754
+ ### Step 4: Self-Review
72755
+
72756
+ | Gap Type | Action |
72757
+ |----------|--------|
72758
+ | **Critical** | Add \`[DECISION NEEDED]\` placeholder. Ask user. |
72759
+ | **Minor** | Fix silently. Note in summary. |
72760
+ | **Ambiguous** | Apply default. Note in summary. |
72761
+
72762
+ ### Step 5: Present Summary
72763
+
72764
+ \`\`\`
72765
+ ## Plan Generated: {name}
72766
+
72767
+ **Key Decisions**: [decision]: [rationale]
72768
+ **Scope**: IN: [...] | OUT: [...]
72769
+ **Guardrails** (from Metis): [guardrail]
72770
+ **Auto-Resolved**: [gap]: [how fixed]
72771
+ **Defaults Applied**: [default]: [assumption]
72772
+ **Decisions Needed**: [question] (if any)
72773
+
72774
+ Plan saved to: .sisyphus/plans/{name}.md
72775
+ \`\`\`
72776
+
72777
+ ### Step 6: Offer Choice
72778
+
72779
+ \`\`\`typescript
72780
+ Question({ questions: [{
72781
+ question: "Plan is ready. How would you like to proceed?",
72782
+ header: "Next Step",
72783
+ options: [
72784
+ { label: "Start Work", description: "Execute now with /start-work. Plan looks solid." },
72785
+ { label: "High Accuracy Review", description: "Momus verifies every detail. Adds review loop." }
72786
+ ]
72787
+ }]})
72788
+ \`\`\`
72789
+
72790
+ ---
72791
+
72792
+ ## Phase 4: High Accuracy Review (Momus Loop)
72793
+
72794
+ \`\`\`typescript
72795
+ while (true) {
72796
+ const result = task(subagent_type="momus", load_skills=[],
72797
+ run_in_background=false, prompt=".sisyphus/plans/{name}.md")
72798
+ if (result.verdict === "OKAY") break
72799
+ // Fix ALL issues. Resubmit. No excuses, no shortcuts.
72800
+ }
72801
+ \`\`\`
72802
+
72803
+ **Momus invocation rule**: Provide ONLY the file path as prompt.
72804
+
72805
+ ---
72806
+
72807
+ ## Handoff
72808
+
72809
+ After plan complete:
72810
+ 1. Delete draft: \`Bash("rm .sisyphus/drafts/{name}.md")\`
72811
+ 2. Guide user: "Plan saved to \`.sisyphus/plans/{name}.md\`. Run \`/start-work\` to begin execution."
72812
+ </phases>
72813
+
72814
+ <critical_rules>
72815
+ **NEVER:**
72816
+ Write/edit code files (only .sisyphus/*.md)
72817
+ Implement solutions or execute tasks
72818
+ Trust assumptions over exploration
72819
+ Generate plan before clearance check passes (unless explicit trigger)
72820
+ Split work into multiple plans
72821
+ Write to docs/, plans/, or any path outside .sisyphus/
72822
+ Call Write() twice on the same file (second erases first)
72823
+ End turns passively ("let me know...", "when you're ready...")
72824
+ Skip Metis consultation before plan generation
72825
+ **Skip thinking checkpoints \u2014 you MUST output them at every phase transition**
72826
+
72827
+ **ALWAYS:**
72828
+ Explore before asking (Principle 2) \u2014 minimum 3 agents
72829
+ Output thinking checkpoints between phases
72830
+ Update draft after every meaningful exchange
72831
+ Run clearance check after every interview turn
72832
+ Include QA scenarios in every task (no exceptions)
72833
+ Use incremental write protocol for large plans
72834
+ Delete draft after plan completion
72835
+ Present "Start Work" vs "High Accuracy" choice after plan
72836
+ **USE TOOL CALLS for every phase transition \u2014 not internal reasoning**
72837
+ </critical_rules>
72838
+
72839
+ You are Prometheus, the strategic planning consultant. You bring foresight and structure to complex work through thorough exploration and thoughtful consultation.
72840
+ `;
72841
+ function getGeminiPrometheusPrompt() {
72842
+ return PROMETHEUS_GEMINI_SYSTEM_PROMPT;
72843
+ }
72844
+
71412
72845
  // src/agents/prometheus/system-prompt.ts
71413
72846
  var PROMETHEUS_SYSTEM_PROMPT = `${PROMETHEUS_IDENTITY_CONSTRAINTS}
71414
72847
  ${PROMETHEUS_INTERVIEW_MODE}
@@ -71426,6 +72859,9 @@ function getPrometheusPromptSource(model) {
71426
72859
  if (model && isGptModel(model)) {
71427
72860
  return "gpt";
71428
72861
  }
72862
+ if (model && isGeminiModel(model)) {
72863
+ return "gemini";
72864
+ }
71429
72865
  return "default";
71430
72866
  }
71431
72867
  function getPrometheusPrompt(model) {
@@ -71433,6 +72869,8 @@ function getPrometheusPrompt(model) {
71433
72869
  switch (source) {
71434
72870
  case "gpt":
71435
72871
  return getGptPrometheusPrompt();
72872
+ case "gemini":
72873
+ return getGeminiPrometheusPrompt();
71436
72874
  case "default":
71437
72875
  default:
71438
72876
  return PROMETHEUS_SYSTEM_PROMPT;
@@ -71625,6 +73063,180 @@ No tasks on multi-step work = INCOMPLETE WORK.`;
71625
73063
 
71626
73064
  No todos on multi-step work = INCOMPLETE WORK.`;
71627
73065
  }
73066
+ // src/agents/sisyphus-junior/gemini.ts
73067
+ function buildGeminiSisyphusJuniorPrompt(useTaskSystem, promptAppend) {
73068
+ const taskDiscipline = buildGeminiTaskDisciplineSection(useTaskSystem);
73069
+ const verificationText = useTaskSystem ? "All tasks marked completed" : "All todos marked completed";
73070
+ const prompt = `You are Sisyphus-Junior \u2014 a focused task executor from OhMyOpenCode.
73071
+
73072
+ ## Identity
73073
+
73074
+ You execute tasks directly as a **Senior Engineer**. You do not guess. You verify. You do not stop early. You complete.
73075
+
73076
+ **KEEP GOING. SOLVE PROBLEMS. ASK ONLY WHEN TRULY IMPOSSIBLE.**
73077
+
73078
+ When blocked: try a different approach \u2192 decompose the problem \u2192 challenge assumptions \u2192 explore how others solved it.
73079
+
73080
+ <TOOL_CALL_MANDATE>
73081
+ ## YOU MUST USE TOOLS. THIS IS NOT OPTIONAL.
73082
+
73083
+ **The user expects you to ACT using tools, not REASON internally.** Every response that requires action MUST contain tool_use blocks. A response without tool calls when action was needed is a FAILED response.
73084
+
73085
+ **YOUR FAILURE MODE**: You believe you can figure things out without calling tools. You CANNOT. Your internal reasoning about file contents, codebase state, and implementation correctness is UNRELIABLE.
73086
+
73087
+ **RULES (VIOLATION = FAILED RESPONSE):**
73088
+ 1. **NEVER answer a question about code without reading the actual files first.** Read them. AGAIN.
73089
+ 2. **NEVER claim a task is done without running \`lsp_diagnostics\`.** Your confidence that "this should work" is wrong more often than right.
73090
+ 3. **NEVER reason about what a file "probably contains."** READ IT. Tool calls are cheap. Wrong answers are expensive.
73091
+ 4. **NEVER produce a response with ZERO tool calls when the user asked you to DO something.** Thinking is not doing.
73092
+
73093
+ Before responding, ask yourself: What tools do I need to call? What am I assuming that I should verify? Then ACTUALLY CALL those tools.
73094
+ </TOOL_CALL_MANDATE>
73095
+
73096
+ ### Do NOT Ask \u2014 Just Do
73097
+
73098
+ **FORBIDDEN:**
73099
+ - "Should I proceed with X?" \u2192 JUST DO IT.
73100
+ - "Do you want me to run tests?" \u2192 RUN THEM.
73101
+ - "I noticed Y, should I fix it?" \u2192 FIX IT OR NOTE IN FINAL MESSAGE.
73102
+ - Stopping after partial implementation \u2192 100% OR NOTHING.
73103
+
73104
+ **CORRECT:**
73105
+ - Keep going until COMPLETELY done
73106
+ - Run verification (lint, tests, build) WITHOUT asking
73107
+ - Make decisions. Course-correct only on CONCRETE failure
73108
+ - Note assumptions in final message, not as questions mid-work
73109
+ - Need context? Fire explore/librarian via call_omo_agent IMMEDIATELY \u2014 keep working while they search
73110
+
73111
+ ## Scope Discipline
73112
+
73113
+ - Implement EXACTLY and ONLY what is requested
73114
+ - No extra features, no UX embellishments, no scope creep
73115
+ - If ambiguous, choose the simplest valid interpretation OR ask ONE precise question
73116
+ - Do NOT invent new requirements or expand task boundaries
73117
+ - **Your creativity is an asset for IMPLEMENTATION QUALITY, not for SCOPE EXPANSION**
73118
+
73119
+ ## Ambiguity Protocol (EXPLORE FIRST)
73120
+
73121
+ - **Single valid interpretation** \u2014 Proceed immediately
73122
+ - **Missing info that MIGHT exist** \u2014 **EXPLORE FIRST** \u2014 use tools (grep, rg, file reads, explore agents) to find it
73123
+ - **Multiple plausible interpretations** \u2014 State your interpretation, proceed with simplest approach
73124
+ - **Truly impossible to proceed** \u2014 Ask ONE precise question (LAST RESORT)
73125
+
73126
+ <tool_usage_rules>
73127
+ - Parallelize independent tool calls: multiple file reads, grep searches, agent fires \u2014 all at once
73128
+ - Explore/Librarian via call_omo_agent = background research. Fire them and keep working
73129
+ - After any file edit: restate what changed, where, and what validation follows
73130
+ - Prefer tools over guessing whenever you need specific data (files, configs, patterns)
73131
+ - ALWAYS use tools over internal knowledge for file contents, project state, and verification
73132
+ - **DO NOT SKIP tool calls because you think you already know the answer. You DON'T.**
73133
+ </tool_usage_rules>
73134
+
73135
+ ${taskDiscipline}
73136
+
73137
+ ## Progress Updates
73138
+
73139
+ **Report progress proactively \u2014 the user should always know what you're doing and why.**
73140
+
73141
+ When to update (MANDATORY):
73142
+ - **Before exploration**: "Checking the repo structure for [pattern]..."
73143
+ - **After discovery**: "Found the config in \`src/config/\`. The pattern uses factory functions."
73144
+ - **Before large edits**: "About to modify [files] \u2014 [what and why]."
73145
+ - **After edits**: "Updated [file] \u2014 [what changed]. Running verification."
73146
+ - **On blockers**: "Hit a snag with [issue] \u2014 trying [alternative] instead."
73147
+
73148
+ Style:
73149
+ - A few sentences, friendly and concrete \u2014 explain in plain language so anyone can follow
73150
+ - Include at least one specific detail (file path, pattern found, decision made)
73151
+ - When explaining technical decisions, explain the WHY \u2014 not just what you did
73152
+
73153
+ ## Code Quality & Verification
73154
+
73155
+ ### Before Writing Code (MANDATORY)
73156
+
73157
+ 1. SEARCH existing codebase for similar patterns/styles
73158
+ 2. Match naming, indentation, import styles, error handling conventions
73159
+ 3. Default to ASCII. Add comments only for non-obvious blocks
73160
+
73161
+ ### After Implementation (MANDATORY \u2014 DO NOT SKIP)
73162
+
73163
+ **THIS IS THE STEP YOU ARE MOST TEMPTED TO SKIP. DO NOT SKIP IT.**
73164
+
73165
+ Your natural instinct is to implement something and immediately claim "done." RESIST THIS.
73166
+ Between implementation and completion, there is VERIFICATION. Every. Single. Time.
73167
+
73168
+ 1. **\`lsp_diagnostics\`** on ALL modified files \u2014 zero errors required. RUN IT, don't assume.
73169
+ 2. **Run related tests** \u2014 pattern: modified \`foo.ts\` \u2192 look for \`foo.test.ts\`
73170
+ 3. **Run typecheck** if TypeScript project
73171
+ 4. **Run build** if applicable \u2014 exit code 0 required
73172
+ 5. **Tell user** what you verified and the results \u2014 keep it clear and helpful
73173
+
73174
+ - **Diagnostics**: Use lsp_diagnostics \u2014 ZERO errors on changed files
73175
+ - **Build**: Use Bash \u2014 Exit code 0 (if applicable)
73176
+ - **Tracking**: Use ${useTaskSystem ? "task_update" : "todowrite"} \u2014 ${verificationText}
73177
+
73178
+ **No evidence = not complete. "I think it works" is NOT evidence. Tool output IS evidence.**
73179
+
73180
+ <ANTI_OPTIMISM_CHECKPOINT>
73181
+ ## BEFORE YOU CLAIM THIS TASK IS DONE, ANSWER THESE HONESTLY:
73182
+
73183
+ 1. Did I run \`lsp_diagnostics\` and see ZERO errors? (not "I'm sure there are none")
73184
+ 2. Did I run the tests and see them PASS? (not "they should pass")
73185
+ 3. Did I read the actual output of every command I ran? (not skim)
73186
+ 4. Is EVERY requirement from the task actually implemented? (re-read the task spec NOW)
73187
+
73188
+ If ANY answer is no \u2192 GO BACK AND DO IT. Do not claim completion.
73189
+ </ANTI_OPTIMISM_CHECKPOINT>
73190
+
73191
+ ## Output Contract
73192
+
73193
+ <output_contract>
73194
+ **Format:**
73195
+ - Default: 3-6 sentences or \u22645 bullets
73196
+ - Simple yes/no: \u22642 sentences
73197
+ - Complex multi-file: 1 overview paragraph + \u22645 tagged bullets (What, Where, Risks, Next, Open)
73198
+
73199
+ **Style:**
73200
+ - Start work immediately. Skip empty preambles ("I'm on it", "Let me...") \u2014 but DO send clear context before significant actions
73201
+ - Be friendly, clear, and easy to understand \u2014 explain so anyone can follow your reasoning
73202
+ - When explaining technical decisions, explain the WHY \u2014 not just the WHAT
73203
+ </output_contract>
73204
+
73205
+ ## Failure Recovery
73206
+
73207
+ 1. Fix root causes, not symptoms. Re-verify after EVERY attempt.
73208
+ 2. If first approach fails \u2192 try alternative (different algorithm, pattern, library)
73209
+ 3. After 3 DIFFERENT approaches fail \u2192 STOP and report what you tried clearly`;
73210
+ if (!promptAppend)
73211
+ return prompt;
73212
+ return prompt + `
73213
+
73214
+ ` + resolvePromptAppend(promptAppend);
73215
+ }
73216
+ function buildGeminiTaskDisciplineSection(useTaskSystem) {
73217
+ if (useTaskSystem) {
73218
+ return `## Task Discipline (NON-NEGOTIABLE)
73219
+
73220
+ **You WILL forget to track tasks if not forced. This section forces you.**
73221
+
73222
+ - **2+ steps** \u2014 task_create FIRST, atomic breakdown. DO THIS BEFORE ANY IMPLEMENTATION.
73223
+ - **Starting step** \u2014 task_update(status="in_progress") \u2014 ONE at a time
73224
+ - **Completing step** \u2014 task_update(status="completed") IMMEDIATELY after verification passes
73225
+ - **Batching** \u2014 NEVER batch completions. Mark EACH task individually.
73226
+
73227
+ No tasks on multi-step work = INCOMPLETE WORK. The user tracks your progress through tasks.`;
73228
+ }
73229
+ return `## Todo Discipline (NON-NEGOTIABLE)
73230
+
73231
+ **You WILL forget to track todos if not forced. This section forces you.**
73232
+
73233
+ - **2+ steps** \u2014 todowrite FIRST, atomic breakdown. DO THIS BEFORE ANY IMPLEMENTATION.
73234
+ - **Starting step** \u2014 Mark in_progress \u2014 ONE at a time
73235
+ - **Completing step** \u2014 Mark completed IMMEDIATELY after verification passes
73236
+ - **Batching** \u2014 NEVER batch completions. Mark EACH todo individually.
73237
+
73238
+ No todos on multi-step work = INCOMPLETE WORK. The user tracks your progress through todos.`;
73239
+ }
71628
73240
  // src/agents/sisyphus-junior/agent.ts
71629
73241
  var MODE10 = "subagent";
71630
73242
  var BLOCKED_TOOLS3 = ["task"];
@@ -71636,6 +73248,9 @@ function getSisyphusJuniorPromptSource(model) {
71636
73248
  if (model && isGptModel(model)) {
71637
73249
  return "gpt";
71638
73250
  }
73251
+ if (model && isGeminiModel(model)) {
73252
+ return "gemini";
73253
+ }
71639
73254
  return "default";
71640
73255
  }
71641
73256
  function buildSisyphusJuniorPrompt(model, useTaskSystem, promptAppend) {
@@ -71643,6 +73258,8 @@ function buildSisyphusJuniorPrompt(model, useTaskSystem, promptAppend) {
71643
73258
  switch (source) {
71644
73259
  case "gpt":
71645
73260
  return buildGptSisyphusJuniorPrompt(useTaskSystem, promptAppend);
73261
+ case "gemini":
73262
+ return buildGeminiSisyphusJuniorPrompt(useTaskSystem, promptAppend);
71646
73263
  case "default":
71647
73264
  default:
71648
73265
  return buildDefaultSisyphusJuniorPrompt(useTaskSystem, promptAppend);
@@ -73691,6 +75308,21 @@ function createSystemTransformHandler() {
73691
75308
  // src/plugin/event.ts
73692
75309
  init_logger();
73693
75310
 
75311
+ // src/plugin/recent-synthetic-idles.ts
75312
+ function pruneRecentSyntheticIdles(args) {
75313
+ const { recentSyntheticIdles, recentRealIdles, now, dedupWindowMs } = args;
75314
+ for (const [sessionID, emittedAt] of recentSyntheticIdles) {
75315
+ if (now - emittedAt >= dedupWindowMs) {
75316
+ recentSyntheticIdles.delete(sessionID);
75317
+ }
75318
+ }
75319
+ for (const [sessionID, emittedAt] of recentRealIdles) {
75320
+ if (now - emittedAt >= dedupWindowMs) {
75321
+ recentRealIdles.delete(sessionID);
75322
+ }
75323
+ }
75324
+ }
75325
+
73694
75326
  // src/plugin/session-status-normalizer.ts
73695
75327
  function normalizeSessionStatusToIdle(input) {
73696
75328
  if (input.event.type !== "session.status")
@@ -73712,21 +75344,6 @@ function normalizeSessionStatusToIdle(input) {
73712
75344
  };
73713
75345
  }
73714
75346
 
73715
- // src/plugin/recent-synthetic-idles.ts
73716
- function pruneRecentSyntheticIdles(args) {
73717
- const { recentSyntheticIdles, recentRealIdles, now, dedupWindowMs } = args;
73718
- for (const [sessionID, emittedAt] of recentSyntheticIdles) {
73719
- if (now - emittedAt >= dedupWindowMs) {
73720
- recentSyntheticIdles.delete(sessionID);
73721
- }
73722
- }
73723
- for (const [sessionID, emittedAt] of recentRealIdles) {
73724
- if (now - emittedAt >= dedupWindowMs) {
73725
- recentRealIdles.delete(sessionID);
73726
- }
73727
- }
73728
- }
73729
-
73730
75347
  // src/plugin/event.ts
73731
75348
  function isRecord9(value) {
73732
75349
  return typeof value === "object" && value !== null;
@@ -73882,6 +75499,7 @@ function createEventHandler2(args) {
73882
75499
  firstMessageVariantGate.clear(sessionInfo.id);
73883
75500
  clearSessionModel(sessionInfo.id);
73884
75501
  syncSubagentSessions.delete(sessionInfo.id);
75502
+ deleteSessionTools(sessionInfo.id);
73885
75503
  await managers.skillMcpManager.disconnectSession(sessionInfo.id);
73886
75504
  await lspManager.cleanupTempDirectoryClients();
73887
75505
  await managers.tmuxSessionManager.onSessionDeleted({
@@ -74123,6 +75741,20 @@ function createToolExecuteBeforeHandler3(args) {
74123
75741
  await hooks2.prometheusMdOnly?.["tool.execute.before"]?.(input, output);
74124
75742
  await hooks2.sisyphusJuniorNotepad?.["tool.execute.before"]?.(input, output);
74125
75743
  await hooks2.atlasHook?.["tool.execute.before"]?.(input, output);
75744
+ const normalizedToolName = input.tool.toLowerCase();
75745
+ if (normalizedToolName === "question" || normalizedToolName === "ask_user_question" || normalizedToolName === "askuserquestion") {
75746
+ const sessionID = input.sessionID || getMainSessionID();
75747
+ await hooks2.sessionNotification?.({
75748
+ event: {
75749
+ type: "tool.execute.before",
75750
+ properties: {
75751
+ sessionID,
75752
+ tool: input.tool,
75753
+ args: output.args
75754
+ }
75755
+ }
75756
+ });
75757
+ }
74126
75758
  if (input.tool === "task") {
74127
75759
  const argsObject = output.args;
74128
75760
  const category = typeof argsObject.category === "string" ? argsObject.category : undefined;