@pushary/agent-hooks 1.9.51 → 1.9.53

package/dist/{chunk-PMJEN6CX.js → chunk-JPABKXK6.js}

@@ -1,7 +1,7 @@
 import {
   announceSubscriptionRequired,
   isDeferAnswer
-} from "./chunk-26MUPAKS.js";
+} from "./chunk-DHJSBK63.js";
 import {
   AUTO_DECISION_WINDOW_MS,
   DEFAULT_SESSION,
@@ -10,18 +10,18 @@ import {
   permissionDeniedAction,
   releaseThrottle,
   reportEvent
-} from "./chunk-DT5CACWZ.js";
+} from "./chunk-U2L42GVI.js";
 import {
   askUser,
   isDecisionStopped,
   waitForQuestion
-} from "./chunk-2QPHUCXU.js";
+} from "./chunk-ZMPR436Z.js";
 import {
   SubscriptionRequiredError
-} from "./chunk-3OLEGCMU.js";
+} from "./chunk-P2546BBI.js";
 import {
   getMachineId
-} from "./chunk-KQBXPGXO.js";
+} from "./chunk-T6RIKJUO.js";
 import {
   machineDecisionFor,
   parseAgentQuestionAnswers,

package/dist/{chunk-DT5Y55FI.js → chunk-K23WMLPY.js}

@@ -1,12 +1,12 @@
 import {
   compatibleConfigFile
-} from "./chunk-4JM2CK2A.js";
+} from "./chunk-N77BH7H2.js";
 import {
   hookOwnerOf,
   hookOwnerOfCommands,
   liveBridgeProbe,
   resolveBridgeStub
-} from "./chunk-2YSCVT6Q.js";
+} from "./chunk-Q7OXI6VS.js";
 import {
   AGENT_CHOICES
 } from "./chunk-BUXDR6US.js";
@@ -18,7 +18,7 @@ import {
   guardedArgv,
   pusharyDir,
   vscodePluginDir
-} from "./chunk-YQDZ7ZIL.js";
+} from "./chunk-OML4YFBN.js";
 import {
   readJsonSafe
 } from "./chunk-AQFEP65J.js";

package/dist/{chunk-SRXBOMSR.js → chunk-L5YTS2BP.js}

@@ -1,6 +1,6 @@
 import {
   pusharyFetch
-} from "./chunk-UR7XX2DV.js";
+} from "./chunk-EK7SZJ4K.js";
 import {
   NetworkError
 } from "./chunk-7QLSKOSU.js";

package/dist/{chunk-GTSI6NG6.js → chunk-LD4MWJMD.js}

@@ -10,7 +10,7 @@ import {
   describeIdleWindow,
   idleDeadlinePassed,
   startProcessOwnership
-} from "./chunk-EJCPHLY2.js";
+} from "./chunk-56ZTIY6D.js";
 import {
   spawnClaude
 } from "./chunk-XHKBHWLX.js";
@@ -23,11 +23,11 @@ import {
   isWaitForAnswerResponse,
   withdrawQuestion,
   writeDegraded
-} from "./chunk-2QPHUCXU.js";
+} from "./chunk-ZMPR436Z.js";
 import {
   callMcpTool,
   isRetryable
-} from "./chunk-3OLEGCMU.js";
+} from "./chunk-P2546BBI.js";
 import {
   AGENT_QUESTION_DESCRIPTION_MAX,
   AGENT_QUESTION_HEADER_MAX,

package/dist/{chunk-EGKD4S5H.js → chunk-LIESRXK5.js}

@@ -1,6 +1,6 @@
 import {
   guardBinary
-} from "./chunk-YQDZ7ZIL.js";
+} from "./chunk-OML4YFBN.js";
 
 // src/bell/install.ts
 import { join } from "path";

package/dist/{chunk-PTNSIGLB.js → chunk-MHQB62K5.js}

@@ -1,12 +1,12 @@
 import {
   macAppBridgeAvailable
-} from "./chunk-DT5Y55FI.js";
+} from "./chunk-K23WMLPY.js";
 import {
   keyPrefix
 } from "./chunk-VYBH6D4X.js";
 import {
   bridgeAgentKey
-} from "./chunk-YQDZ7ZIL.js";
+} from "./chunk-OML4YFBN.js";
 import {
   readJsonSafe
 } from "./chunk-AQFEP65J.js";

package/dist/{chunk-AZHTI5JX.js → chunk-MTKV4RUQ.js}

@@ -1,6 +1,6 @@
 import {
   MCP_BRIDGE_BINARY
-} from "./chunk-X5GHIFST.js";
+} from "./chunk-46TC24ET.js";
 import {
   KEY_FILE_MODE
 } from "./chunk-VYBH6D4X.js";
@@ -8,7 +8,7 @@ import {
   NpmInstallError,
   NpmMissingError,
   NpmPermissionError
-} from "./chunk-JZDRR7BL.js";
+} from "./chunk-XUW2DRAQ.js";
 import {
   readJsonSafe,
   writeFileAtomic,
@@ -22,7 +22,7 @@ import {
 } from "./chunk-LF3TLC7B.js";
 
 // src/instruction-file.ts
-import { existsSync, readFileSync, writeFileSync, mkdirSync, rmSync } from "fs";
+import { accessSync, constants, existsSync, readFileSync, statSync, writeFileSync, mkdirSync, rmSync } from "fs";
 import { dirname } from "path";
 var PUSHARY_BEGIN = "<!-- BEGIN PUSHARY (managed by @pushary/agent-hooks; do not edit this block) -->";
 var PUSHARY_END = "<!-- END PUSHARY -->";
@@ -44,6 +44,9 @@ You have Pushary MCP tools that reach the user on their phone. Use them proactiv
 
 Pass \`agentName\` as "${label} - <project folder name>" so the user knows which session is asking. If a question times out, follow \`handoffAction\` when present, otherwise \`nextAction\`: keep waiting with the same correlationId while pending. A poll ending is not question expiry. Cancel only for an explicit handoff or when the answer is no longer needed. If cancellation returns \`handoffAction: "stop"\`, stop. Otherwise, if cancellation returns false, poll once for 1 second and honor the answer that won the race.`;
 var SHARED_AGENTS_MD_LABEL = "<your agent's name, such as Codex or Hermes>";
+var CODEX_INSTRUCTIONS_LABEL = "Codex";
+var GEMINI_INSTRUCTIONS_LABEL = "Gemini";
+var OPENCODE_INSTRUCTIONS_LABEL = "OpenCode";
 var renderAgentInstructions = (label) => instructionBody(label);
 var KEYLESS_FALLBACK_LINE = "This repo uses Pushary phone approvals. Your teammates get agent questions on their lock screens; you do not have a key yet, so questions will fall back to the terminal. Get your own key (3-day trial): https://pushary.com/sign-up?utm_source=agents-md&utm_medium=teammate";
 var renderProjectAgentInstructions = (label) => `${instructionBody(label)}
@@ -52,6 +55,19 @@ If this environment has no Pushary API key (no PUSHARY_API_KEY and no key in ~/.
 var wrap = (body) => `${PUSHARY_BEGIN}
 ${body}
 ${PUSHARY_END}`;
+var withInstructionBlockAppended = (existing, body) => {
+  const prefix = existing.trim() ? existing.replace(/\s*$/, "") + "\n\n" : "";
+  return prefix + wrap(body) + "\n";
+};
+var managedBlockRange = (text) => {
+  const start = text.indexOf(PUSHARY_BEGIN);
+  const end = text.indexOf(PUSHARY_END);
+  return start !== -1 && end > start ? { start, end: end + PUSHARY_END.length } : null;
+};
+var withInstructionBlockReplaced = (existing, body) => {
+  const range = managedBlockRange(existing);
+  return range ? existing.slice(0, range.start) + wrap(body) + existing.slice(range.end) : null;
+};
 var writeInstructionBlock = (filePath, body) => {
   const dir = dirname(filePath);
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
@@ -60,17 +76,53 @@ var writeInstructionBlock = (filePath, body) => {
     existing = readFileSync(filePath, "utf-8");
   } catch {
   }
-  const block = wrap(body);
-  const start = existing.indexOf(PUSHARY_BEGIN);
-  const end = existing.indexOf(PUSHARY_END);
-  let next;
-  if (start !== -1 && end !== -1 && end > start) {
-    next = existing.slice(0, start) + block + existing.slice(end + PUSHARY_END.length);
-  } else {
-    const prefix = existing.trim() ? existing.replace(/\s*$/, "") + "\n\n" : "";
-    next = prefix + block + "\n";
+  writeFileSync(filePath, withInstructionBlockReplaced(existing, body) ?? withInstructionBlockAppended(existing, body), "utf-8");
+};
+var occurrencesOf = (marker, text) => text.split(marker).length - 1;
+var soleManagedBlock = (text) => {
+  const begins = occurrencesOf(PUSHARY_BEGIN, text);
+  const ends = occurrencesOf(PUSHARY_END, text);
+  if (begins === 0 && ends === 0) return { kind: "none" };
+  const range = managedBlockRange(text);
+  return begins === 1 && ends === 1 && range ? { kind: "one", range } : { kind: "ambiguous" };
+};
+var CRLF = "\r\n";
+var withLineEndingsOf = (sample, block) => sample.includes(CRLF) ? block.replaceAll("\n", CRLF) : block;
+var readUtf8 = (filePath) => {
+  try {
+    const bytes = readFileSync(filePath);
+    const text = bytes.toString("utf-8");
+    return Buffer.from(text, "utf-8").equals(bytes) ? { kind: "text", text } : { kind: "not_utf8" };
+  } catch {
+    return { kind: "unreadable" };
+  }
+};
+var isWritable = (filePath) => {
+  try {
+    accessSync(filePath, constants.W_OK);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var refreshInstructionBlock = (filePath, body) => {
+  if (!existsSync(filePath)) return "absent";
+  const read = readUtf8(filePath);
+  if (read.kind !== "text") return read.kind;
+  const block = soleManagedBlock(read.text);
+  if (block.kind === "none") return "absent";
+  if (block.kind === "ambiguous") return "ambiguous_markers";
+  const existing = read.text.slice(block.range.start, block.range.end);
+  const fresh = withLineEndingsOf(existing, wrap(body));
+  if (existing === fresh) return "current";
+  if (!isWritable(filePath)) return "read_only";
+  try {
+    const refreshed = read.text.slice(0, block.range.start) + fresh + read.text.slice(block.range.end);
+    writeFileAtomic(filePath, refreshed, statSync(filePath).mode & 511);
+    return "refreshed";
+  } catch {
+    return "write_failed";
   }
-  writeFileSync(filePath, next, "utf-8");
 };
 var removeInstructionBlock = (filePath) => {
   let existing = "";
@@ -550,6 +602,7 @@ var agentFailureWire = (failures) => readSetupAgentFailures(failures);
 
 // src/fx-lifecycle.ts
 import { existsSync as existsSync3 } from "fs";
+import { join } from "path";
 var fxRetryHint = () => `Fix it, then run ${retryAgentCommand("fx")}.`;
 var readFxProfileForSetup = (filePath) => {
   const read = readFxFile(filePath, readFxProfile);
@@ -571,6 +624,13 @@ var writeFxProfile = (filePath, profile) => {
   }
   writeFileAtomic(filePath, rendered.text, KEY_FILE_MODE);
 };
+var macAppFxBridge = (pusharyDir) => join(pusharyDir, "bin", MCP_BRIDGE_BINARY);
+var fxServerHolder = (profilePath, appBridge) => {
+  const read = readFxFile(profilePath, readFxProfile);
+  const entry = read.kind === "profile" ? fxPusharyEntryOf(read.profile) : void 0;
+  if (!isFxPusharyEntry(entry)) return "none";
+  return fxBridgeTargetOf(entry) === appBridge ? "app" : "cli";
+};
 var fxSettingsReadRefusal = (filePath, read) => {
   if (read.kind === "unreadable") return `${filePath} could not be read`;
   if (read.kind === "refused") return `${filePath} ${FX_SETTINGS_REFUSALS[read.reason]}`;
@@ -665,9 +725,13 @@ var planFxRemoval = (profilePath, settingsPath, receiptPath) => {
 
 export {
   SHARED_AGENTS_MD_LABEL,
+  CODEX_INSTRUCTIONS_LABEL,
+  GEMINI_INSTRUCTIONS_LABEL,
+  OPENCODE_INSTRUCTIONS_LABEL,
   renderAgentInstructions,
   renderProjectAgentInstructions,
   writeInstructionBlock,
+  refreshInstructionBlock,
   removeInstructionBlock,
   hasInstructionBlock,
   FX_PUSHARY_TOOLS_RULE,
@@ -691,6 +755,8 @@ export {
   agentFailureWire,
   readFxProfileForSetup,
   writeFxProfile,
+  macAppFxBridge,
+  fxServerHolder,
   configureFxSettings,
   inspectFxInstallation,
   planFxRemoval

package/dist/{chunk-4JM2CK2A.js → chunk-N77BH7H2.js}

@@ -3,19 +3,20 @@ import {
   addGeminiMcpServer,
   removeGeminiMcpServer,
   supportedClaudeEvents
-} from "./chunk-3ICRY72Q.js";
+} from "./chunk-6C4S3QYD.js";
 import {
   CLAUDE_CODE_AGENT,
   compatibleToolLookup
-} from "./chunk-DT5CACWZ.js";
+} from "./chunk-U2L42GVI.js";
 import {
   guardBinary,
   guardBinaryRefusing,
   holdBudgetOf,
   isProtectedByScope,
   registerHookEntry
-} from "./chunk-YQDZ7ZIL.js";
+} from "./chunk-OML4YFBN.js";
 import {
+  HOOK_COMPATIBLE_PROFILES,
   HOOK_LOCATOR_BINARY,
   PHONE_ANSWERED_TOOLS,
   compatibleTargetFiles,
@@ -280,6 +281,10 @@ var compatibleDocuments = (profile, home) => {
   }
   return documents;
 };
+var compatibleRecord = (of) => HOOK_COMPATIBLE_PROFILES.reduce(
+  (record, profile) => ({ ...record, [profile.agentType]: of(profile) }),
+  {}
+);
 var compatibleTargetPaths = (profile, home) => compatibleTargetFiles(profile).map((file) => compatibleFilePath(file, home));
 var compatibleConfigFile = (profile, home) => compatibleFilePath(profile.configFile, home);
 var compatibleMcpFile = (profile, home) => profile.mcp ? compatibleFilePath(profile.mcp.file, home) : null;
@@ -489,6 +494,7 @@ export {
   grokHome,
   compatibleFilePath,
   compatibleDocuments,
+  compatibleRecord,
   compatibleTargetPaths,
   compatibleConfigFile,
   compatibleMcpFile,

package/dist/{chunk-DUMZORSL.js → chunk-NECZKPJN.js}

@@ -4,7 +4,7 @@ import {
   forkFinishWithUpgradeLock,
   installWithUpgradeLock,
   releaseAutoUpdateLock
-} from "./chunk-K3BIMGP4.js";
+} from "./chunk-H57DXSHR.js";
 import {
   describeAutoUpdateCheck,
   globalInstallLocation,
@@ -14,7 +14,7 @@ import {
   readAutoUpdateState,
   updateAutoUpdateState,
   upgradeEntryFor
-} from "./chunk-RLADRNPV.js";
+} from "./chunk-QKU46TK5.js";
 import {
   EXIT
 } from "./chunk-KZERVKTD.js";
@@ -22,14 +22,14 @@ import {
   autoUpdateLock,
   autoUpdateLog,
   autoUpdateState
-} from "./chunk-YQDZ7ZIL.js";
+} from "./chunk-OML4YFBN.js";
 import {
   execNpm,
   fetchLatestPublishedVersion,
   npmErrorMessage,
   readGlobalCliInstallAt,
   readGlobalPrefix
-} from "./chunk-JZDRR7BL.js";
+} from "./chunk-XUW2DRAQ.js";
 import {
   NPX_LATEST_COMMAND
 } from "./chunk-MC4VY5LK.js";
@@ -52,6 +52,26 @@ import { dirname } from "path";
 
 // src/upgrade-finish.ts
 var FINISHED_UPGRADE = { kind: "finished" };
+var refreshedPartsOf = (agent) => [
+  ...agent.result.hooks ? ["hooks"] : [],
+  ...agent.result.mcp ? ["MCP key"] : [],
+  ...agent.instructions?.outcome === "refreshed" ? ["instructions"] : []
+];
+var wasRefreshed = (agent) => refreshedPartsOf(agent).length > 0;
+var INSTRUCTIONS_LEFT_BECAUSE = {
+  refreshed: null,
+  current: null,
+  absent: null,
+  read_only: "the file is read-only",
+  ambiguous_markers: "its Pushary markers do not form exactly one block",
+  not_utf8: "the file is not UTF-8 text",
+  unreadable: "the file could not be read",
+  write_failed: "the file could not be written"
+};
+var instructionsLeftNoteOf = (agent) => {
+  const reason = agent.instructions ? INSTRUCTIONS_LEFT_BECAUSE[agent.instructions.outcome] : null;
+  return agent.instructions && reason ? `${agent.instructions.file}: ${reason}` : null;
+};
 var RETRYABLE_UPGRADE_FINISH = { kind: "retryable" };
 var SETTLED_UPGRADE_FINISH = { kind: "settled" };
 var controlWaitsOnThePerson = (readings) => readings.controlPolicy === "legacy" || readings.controlMode === "on" && readings.controlPolicy === "unsupported";
@@ -275,6 +295,9 @@ var upgradeInstalledPackage = async (subject, effects) => {
 };
 
 export {
+  refreshedPartsOf,
+  wasRefreshed,
+  instructionsLeftNoteOf,
   upgradeFinishOutcome,
   upgradeFinishExitCode,
   FINISH_UPGRADE_FLAG,

package/dist/{chunk-43NXSBNZ.js → chunk-NELH25J7.js}

@@ -4,7 +4,7 @@ import {
   outcomeOfFailedAsk,
   reportMachineDenial,
   storedWaitDeadline
-} from "./chunk-PMJEN6CX.js";
+} from "./chunk-JPABKXK6.js";
 import {
   isGatingMoment,
   recordKeylessMoment
@@ -12,11 +12,11 @@ import {
 import {
   isDeferAnswer,
   oncePerSession
-} from "./chunk-26MUPAKS.js";
+} from "./chunk-DHJSBK63.js";
 import {
   activeHookSource,
   activeIdentity
-} from "./chunk-4JM2CK2A.js";
+} from "./chunk-N77BH7H2.js";
 import {
   DEFAULT_SESSION,
   UNNAMED_ACTION,
@@ -40,7 +40,7 @@ import {
   reportEvent,
   scopePathFor,
   settleQuestionsForToolUse
-} from "./chunk-DT5CACWZ.js";
+} from "./chunk-U2L42GVI.js";
 import {
   repoKeyFor
 } from "./chunk-JBT3ZSJS.js";
@@ -56,10 +56,10 @@ import {
   sendNotification,
   waitForQuestion,
   waitsForThePhone
-} from "./chunk-2QPHUCXU.js";
+} from "./chunk-ZMPR436Z.js";
 import {
   getMachineId
-} from "./chunk-KQBXPGXO.js";
+} from "./chunk-T6RIKJUO.js";
 import {
   getApiKey,
   getBaseUrl

package/dist/{chunk-TQ6AGJVH.js → chunk-NHVEQLQC.js}

@@ -1,6 +1,6 @@
 import {
   CODEX_HOOK_STATUS
-} from "./chunk-6QPRQVQM.js";
+} from "./chunk-FCMWUYIE.js";
 import {
   NPX_LATEST_COMMAND
 } from "./chunk-MC4VY5LK.js";

package/dist/{chunk-YQDZ7ZIL.js → chunk-OML4YFBN.js}

@@ -1,6 +1,6 @@
 import {
   quoteIfNeeded
-} from "./chunk-JZDRR7BL.js";
+} from "./chunk-XUW2DRAQ.js";
 import {
   CODEX_QUESTION_TOOLS,
   HOOK_BUDGETS,

package/dist/{chunk-3OLEGCMU.js → chunk-P2546BBI.js}

@@ -1,9 +1,9 @@
 import {
   keyCheckFromResponse
-} from "./chunk-SRXBOMSR.js";
+} from "./chunk-L5YTS2BP.js";
 import {
   installNetworkDefaults
-} from "./chunk-UR7XX2DV.js";
+} from "./chunk-EK7SZJ4K.js";
 import {
   getBaseUrl
 } from "./chunk-CQ5JGRML.js";

package/dist/{chunk-2YSCVT6Q.js → chunk-Q7OXI6VS.js}

@@ -2,18 +2,18 @@ import {
   CLAUDE_HOOK_EVENTS,
   GEMINI_HOOK_EVENTS,
   hasGeminiHooks
-} from "./chunk-3ICRY72Q.js";
+} from "./chunk-6C4S3QYD.js";
 import {
   AGENT_CHOICES
 } from "./chunk-BUXDR6US.js";
 import {
   BELL_HOOK_BINARY
-} from "./chunk-EGKD4S5H.js";
+} from "./chunk-LIESRXK5.js";
 import {
   CODEX_HOOK_EVENTS,
   hasCodexHooks,
   holdBudgetOf
-} from "./chunk-YQDZ7ZIL.js";
+} from "./chunk-OML4YFBN.js";
 import {
   CURSOR_GATE_EVENTS,
   HOOK_LOCATOR_BINARY,

package/dist/{chunk-RLADRNPV.js → chunk-QKU46TK5.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-POFBE6ZY.js";
 import {
   autoUpdateState
-} from "./chunk-YQDZ7ZIL.js";
+} from "./chunk-OML4YFBN.js";
 import {
   readJsonSafe,
   writeJsonAtomic

package/dist/{chunk-7DBTOPOT.js → chunk-RH6KR6EH.js}

@@ -1,9 +1,9 @@
 import {
   APPROVAL_SETTINGS_PATH
-} from "./chunk-VD2OAF7Q.js";
+} from "./chunk-JOWF4Y4P.js";
 import {
   readMacAppAgentKey
-} from "./chunk-PTNSIGLB.js";
+} from "./chunk-MHQB62K5.js";
 import {
   findExportedKeyLines,
   isAdoptedMacAppKey,
@@ -16,7 +16,7 @@ import {
 } from "./chunk-VYBH6D4X.js";
 import {
   absoluteUrl
-} from "./chunk-SRXBOMSR.js";
+} from "./chunk-L5YTS2BP.js";
 import {
   isValidApiKey
 } from "./chunk-LF3TLC7B.js";