happy-imou-cloud 2.1.37 → 2.1.39

package/dist/{registerKillSessionHandler-CLFQ8bQP.mjs → registerKillSessionHandler-Buc97BEh.mjs}

@@ -1,5 +1,5 @@
-import { k as initialMachineMetadata, R as RuntimeShell, f as formatDisplayMessage, l as resolveCanonicalToolNameV2, m as isTerminalReferenceOnlyPayload } from './index-4t8rMnvz.mjs';
-import { r as readSettings, H as HeadTailPreviewBuffer, d as HAPPY_ORG_REPLY_ACK_VERSION, e as HAPPY_ORG_TURN_REPORT_TAG, f as HAPPY_ORG_SUMMARY_MAX_LENGTH, g as HAPPY_ORG_REPEAT_THRESHOLD, l as logger } from './api-CMJhY7of.mjs';
+import { k as initialMachineMetadata, R as RuntimeShell, f as formatDisplayMessage, l as resolveCanonicalToolNameV2, m as isTerminalReferenceOnlyPayload } from './index-B9mt95QV.mjs';
+import { r as readSettings, H as HeadTailPreviewBuffer, d as HAPPY_ORG_REPLY_ACK_VERSION, e as HAPPY_ORG_TURN_REPORT_TAG, f as HAPPY_ORG_SUMMARY_MAX_LENGTH, g as HAPPY_ORG_REPEAT_THRESHOLD, l as logger } from './api-wcqkneTg.mjs';
 import { randomUUID } from 'node:crypto';
 import { basename } from 'node:path';
 import { createHash } from 'crypto';
@@ -115,11 +115,11 @@ function renderTerminalOutputPreview(value, opts) {
 }
 
 const DISPLAY_FRIENDLY_TOOL_FIELDS = ["stdout", "stderr", "output", "text", "message", "detail", "reason", "data"];
-function isRecord(value) {
+function isRecord$1(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
 function stripInternalToolMeta(value) {
-  if (!isRecord(value)) {
+  if (!isRecord$1(value)) {
     return value;
   }
   const {
@@ -140,7 +140,7 @@ function extractNestedTextContent(value) {
     const parts = value.map((item) => extractNestedTextContent(item)).filter((item) => typeof item === "string" && item.length > 0);
     return parts.length > 0 ? parts.join("\n") : null;
   }
-  if (!isRecord(value)) {
+  if (!isRecord$1(value)) {
     return null;
   }
   if (typeof value.text === "string" && value.text.trim().length > 0) {
@@ -160,7 +160,7 @@ function humanizeToolLabel(rawToolName) {
   return spaced.charAt(0).toUpperCase() + spaced.slice(1).toLowerCase();
 }
 function isToolLifecycleResult(value) {
-  if (!isRecord(value)) {
+  if (!isRecord$1(value)) {
     return false;
   }
   return typeof value.state === "string" && ("messages" in value || "description" in value || "createdAt" in value || "startedAt" in value || "completedAt" in value);
@@ -209,7 +209,7 @@ function normalizeCodexToolOutput(rawToolName, value) {
   if (isTerminalReferenceOnlyPayload(normalizedLifecyclePayload)) {
     return void 0;
   }
-  if (!isRecord(normalizedLifecyclePayload)) {
+  if (!isRecord$1(normalizedLifecyclePayload)) {
     return normalizedLifecyclePayload;
   }
   const hasDisplayFriendlyField = DISPLAY_FRIENDLY_TOOL_FIELDS.some((field) => field in normalizedLifecyclePayload);
@@ -236,7 +236,7 @@ function truncateProviderOutputValue(value, label, seen = /* @__PURE__ */ new We
   if (Array.isArray(value)) {
     return renderOutputPreview(value, label);
   }
-  if (!isRecord(value)) {
+  if (!isRecord$1(value)) {
     return value;
   }
   if (seen.has(value)) {
@@ -307,7 +307,7 @@ function hasDisplayPayload(value) {
   if (Array.isArray(sanitized)) {
     return sanitized.length > 0;
   }
-  if (isRecord(sanitized)) {
+  if (isRecord$1(sanitized)) {
     return Object.keys(sanitized).length > 0;
   }
   return true;
@@ -504,6 +504,242 @@ async function syncControlledByUserState(sessionClient, controlledByUser) {
   });
 }
 
+const SESSION_LABEL_MAX_LENGTH = 60;
+const TITLE_MAX_LENGTH = 80;
+const BODY_MAX_LENGTH = 140;
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeText(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const normalized = value.replace(/\s+/g, " ").trim();
+  return normalized.length > 0 ? normalized : null;
+}
+function truncateText(value, maxLength) {
+  if (value.length <= maxLength) {
+    return value;
+  }
+  return `${value.slice(0, maxLength - 1).trimEnd()}\u2026`;
+}
+function toProviderKey(providerLabel) {
+  const normalized = normalizeText(providerLabel)?.toLowerCase();
+  if (!normalized) {
+    return "unknown";
+  }
+  if (normalized === "claude" || normalized === "claude code" || normalized === "cloud code") {
+    return "claude";
+  }
+  if (normalized === "codex") {
+    return "codex";
+  }
+  if (normalized === "gemini") {
+    return "gemini";
+  }
+  return normalized.replace(/\s+/g, "-");
+}
+function deriveNotificationProviderLabel(providerLabel) {
+  const normalized = normalizeText(providerLabel)?.toLowerCase();
+  if (!normalized) {
+    return "Agent";
+  }
+  if (normalized === "claude" || normalized === "claude code" || normalized === "cloud code") {
+    return "Claude";
+  }
+  if (normalized === "codex") {
+    return "Codex";
+  }
+  if (normalized === "gemini") {
+    return "Gemini";
+  }
+  return normalizeText(providerLabel) ?? "Agent";
+}
+function buildNotificationTitle(sessionLabel, providerLabel, actionLabel) {
+  const providerDisplayLabel = deriveNotificationProviderLabel(providerLabel);
+  const suffix = ` \xB7 ${providerDisplayLabel} \xB7 ${actionLabel}`;
+  const maxSessionLength = Math.max(12, TITLE_MAX_LENGTH - suffix.length);
+  return `${truncateText(sessionLabel, maxSessionLength)}${suffix}`;
+}
+function derivePathLabel(path) {
+  const normalized = normalizeText(path);
+  if (!normalized) {
+    return null;
+  }
+  const segments = normalized.split(/[\\/]+/).filter(Boolean);
+  return segments[segments.length - 1] ?? normalized;
+}
+function deriveHomeLabel(homeSlug) {
+  const normalized = normalizeText(homeSlug);
+  if (!normalized) {
+    return null;
+  }
+  return normalized.replace(/[_-]+/g, " ");
+}
+function deriveNotificationSessionLabel(metadata, providerLabel) {
+  const label = normalizeText(metadata?.name) ?? normalizeText(metadata?.summary?.text) ?? deriveHomeLabel(metadata?.happyOrg?.specialistHome?.homeSlug) ?? derivePathLabel(metadata?.path) ?? normalizeText(providerLabel) ?? "Session";
+  return truncateText(label, SESSION_LABEL_MAX_LENGTH);
+}
+function deriveNotificationSummary(candidates, fallback, sessionLabel) {
+  for (const candidate of candidates) {
+    const normalized = normalizeText(candidate);
+    if (!normalized) {
+      continue;
+    }
+    const truncated = truncateText(normalized, BODY_MAX_LENGTH);
+    if (truncated.toLowerCase() !== sessionLabel.toLowerCase()) {
+      return truncated;
+    }
+  }
+  return truncateText(fallback, BODY_MAX_LENGTH);
+}
+function cleanExtraData(extraData) {
+  return Object.fromEntries(
+    Object.entries(extraData).filter(([, value]) => {
+      if (value === null || value === void 0) {
+        return false;
+      }
+      if (typeof value === "string") {
+        return value.trim().length > 0;
+      }
+      return true;
+    })
+  );
+}
+function buildRouteData(opts) {
+  const taskContext = opts.metadata?.happyOrg?.taskContext ?? null;
+  const routeTaskId = opts.report?.taskId ?? taskContext?.taskId ?? null;
+  const routePositionId = opts.report?.positionId ?? taskContext?.positionId ?? null;
+  const routeSessionId = normalizeText(opts.sessionId);
+  const data = {
+    notificationKind: opts.notificationKind,
+    provider: toProviderKey(opts.providerLabel)
+  };
+  if (opts.routePreference === "session" && routeSessionId) {
+    data.sessionId = routeSessionId;
+  } else if (routeTaskId) {
+    data.taskId = routeTaskId;
+  } else if (routeSessionId) {
+    data.sessionId = routeSessionId;
+  } else if (routePositionId) {
+    data.positionId = routePositionId;
+  }
+  Object.assign(data, cleanExtraData({
+    contextTaskId: data.taskId ? null : routeTaskId,
+    contextPositionId: data.positionId ? null : routePositionId,
+    memberAgentId: opts.report?.memberAgentId ?? taskContext?.memberAgentId ?? null,
+    supervisorAgentId: opts.report?.supervisorAgentId ?? taskContext?.supervisorAgentId ?? null
+  }));
+  if (opts.extraData) {
+    Object.assign(data, cleanExtraData(opts.extraData));
+  }
+  return data;
+}
+function humanizeToolName(toolName) {
+  const normalized = normalizeText(toolName);
+  if (!normalized) {
+    return "continue";
+  }
+  const replacements = {
+    bash: "run a command",
+    execute: "run a command",
+    read: "read a file",
+    write: "write a file",
+    edit: "edit a file",
+    multiedit: "edit files",
+    patch: "apply a patch",
+    fetch: "fetch a page",
+    search: "search the web"
+  };
+  const replacement = replacements[normalized.toLowerCase()];
+  if (replacement) {
+    return replacement;
+  }
+  return normalized.replace(/[_-]+/g, " ");
+}
+function extractPermissionRequestPushContext(message) {
+  const payload = isRecord(message.payload) ? message.payload : null;
+  const toolName = normalizeText(payload?.toolName) ?? normalizeText(message.reason);
+  const payloadDescription = normalizeText(payload?.description);
+  const reasonDescription = normalizeText(message.reason);
+  let description = payloadDescription;
+  if (!description && reasonDescription && reasonDescription.toLowerCase() !== (toolName ?? "").toLowerCase()) {
+    description = reasonDescription;
+  }
+  if (description && toolName && description.toLowerCase() === toolName.toLowerCase()) {
+    description = null;
+  }
+  return {
+    requestId: message.id,
+    toolName,
+    description
+  };
+}
+function buildReadyPushNotification(opts) {
+  const sessionLabel = deriveNotificationSessionLabel(opts.metadata, opts.providerLabel);
+  const providerDisplayLabel = deriveNotificationProviderLabel(opts.providerLabel);
+  return {
+    title: buildNotificationTitle(sessionLabel, opts.providerLabel, "Ready"),
+    body: truncateText(`${providerDisplayLabel} is waiting for your next message`, BODY_MAX_LENGTH),
+    data: buildRouteData({
+      ...opts,
+      notificationKind: "ready",
+      routePreference: "session"
+    })
+  };
+}
+function buildPermissionPushNotification(opts) {
+  const sessionLabel = deriveNotificationSessionLabel(opts.metadata, opts.providerLabel);
+  const providerDisplayLabel = deriveNotificationProviderLabel(opts.providerLabel);
+  const fallback = `${providerDisplayLabel} needs your approval to ${humanizeToolName(opts.toolName)}`;
+  const body = deriveNotificationSummary([opts.description], fallback, sessionLabel);
+  return {
+    title: buildNotificationTitle(sessionLabel, opts.providerLabel, "Permission needed"),
+    body,
+    data: buildRouteData({
+      ...opts,
+      notificationKind: "permission_request",
+      routePreference: "session",
+      extraData: {
+        requestId: opts.requestId,
+        tool: opts.toolName ?? null,
+        ...opts.extraData
+      }
+    })
+  };
+}
+function buildTurnResultPushNotification(opts) {
+  const sessionLabel = deriveNotificationSessionLabel(opts.metadata, opts.providerLabel);
+  const providerDisplayLabel = deriveNotificationProviderLabel(opts.providerLabel);
+  const report = opts.report ?? null;
+  const explicitSummary = normalizeText(report?.summary) ?? normalizeText(opts.responseText);
+  if (!explicitSummary) {
+    return null;
+  }
+  const fallback = `${providerDisplayLabel} has a new result ready`;
+  const body = deriveNotificationSummary(
+    [
+      explicitSummary
+    ],
+    fallback,
+    sessionLabel
+  );
+  const action = report?.turnStatus === "task_complete" ? "Task complete" : "New result";
+  return {
+    title: buildNotificationTitle(sessionLabel, opts.providerLabel, action),
+    body,
+    data: buildRouteData({
+      ...opts,
+      report,
+      notificationKind: "turn_result",
+      routePreference: "session",
+      extraData: {
+        turnStatus: report?.turnStatus ?? "turn_update"
+      }
+    })
+  };
+}
+
 const STRUCTURED_FIELD_PATTERN = /^\s*([a-z_]+)\s*=\s*(.*?)\s*$/;
 const KEY_VALUE_LINE_PATTERN = /^([A-Za-z0-9_]+)=(.*)$/;
 const HAPPY_ORG_READ_ACK = "yes";
@@ -2486,4 +2722,4 @@ function registerKillSessionHandler(rpcHandlerManager, killThisHappy) {
   });
 }
 
-export { BasePermissionHandler as B, ConversationHistory$1 as C, INTERACTION_SUPERSEDED_ERROR as I, MissingMachineIdError as M, INTERACTION_TIMED_OUT_ERROR as a, MessageQueue2 as b, registerKillSessionHandler as c, MessageBuffer as d, ensureManagedProviderMachine as e, buildHappyOrgTurnPrompt as f, getPendingInteractionTimeoutMs as g, hashObject as h, finalizeHappyOrgTurnWithBusinessAck as i, renderTerminalOutputPreview as j, inferToolResultError as k, launchRuntimeHandleWithFactoryResult as l, forwardAgentMessageToProviderSession as m, resolveHappyOrgQueuedTurn as r, syncControlledByUserState as s, waitForResponseCompleteWithAbort as w };
+export { BasePermissionHandler as B, ConversationHistory$1 as C, INTERACTION_SUPERSEDED_ERROR as I, MissingMachineIdError as M, INTERACTION_TIMED_OUT_ERROR as a, MessageQueue2 as b, registerKillSessionHandler as c, MessageBuffer as d, ensureManagedProviderMachine as e, buildHappyOrgTurnPrompt as f, getPendingInteractionTimeoutMs as g, hashObject as h, finalizeHappyOrgTurnWithBusinessAck as i, buildTurnResultPushNotification as j, buildReadyPushNotification as k, launchRuntimeHandleWithFactoryResult as l, extractPermissionRequestPushContext as m, buildPermissionPushNotification as n, renderTerminalOutputPreview as o, inferToolResultError as p, forwardAgentMessageToProviderSession as q, resolveHappyOrgQueuedTurn as r, syncControlledByUserState as s, waitForResponseCompleteWithAbort as w };

package/dist/{registerKillSessionHandler-C1PIogKI.cjs → registerKillSessionHandler-DtXhn2Cd.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var index = require('./index-CQ2Yq72y.cjs');
-var persistence = require('./api-CexMNqai.cjs');
+var index = require('./index-Cgor8CE7.cjs');
+var persistence = require('./api-BoeZDGwx.cjs');
 var node_crypto = require('node:crypto');
 var path = require('node:path');
 var crypto = require('crypto');
@@ -117,11 +117,11 @@ function renderTerminalOutputPreview(value, opts) {
 }
 
 const DISPLAY_FRIENDLY_TOOL_FIELDS = ["stdout", "stderr", "output", "text", "message", "detail", "reason", "data"];
-function isRecord(value) {
+function isRecord$1(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
 function stripInternalToolMeta(value) {
-  if (!isRecord(value)) {
+  if (!isRecord$1(value)) {
     return value;
   }
   const {
@@ -142,7 +142,7 @@ function extractNestedTextContent(value) {
     const parts = value.map((item) => extractNestedTextContent(item)).filter((item) => typeof item === "string" && item.length > 0);
     return parts.length > 0 ? parts.join("\n") : null;
   }
-  if (!isRecord(value)) {
+  if (!isRecord$1(value)) {
     return null;
   }
   if (typeof value.text === "string" && value.text.trim().length > 0) {
@@ -162,7 +162,7 @@ function humanizeToolLabel(rawToolName) {
   return spaced.charAt(0).toUpperCase() + spaced.slice(1).toLowerCase();
 }
 function isToolLifecycleResult(value) {
-  if (!isRecord(value)) {
+  if (!isRecord$1(value)) {
     return false;
   }
   return typeof value.state === "string" && ("messages" in value || "description" in value || "createdAt" in value || "startedAt" in value || "completedAt" in value);
@@ -211,7 +211,7 @@ function normalizeCodexToolOutput(rawToolName, value) {
   if (index.isTerminalReferenceOnlyPayload(normalizedLifecyclePayload)) {
     return void 0;
   }
-  if (!isRecord(normalizedLifecyclePayload)) {
+  if (!isRecord$1(normalizedLifecyclePayload)) {
     return normalizedLifecyclePayload;
   }
   const hasDisplayFriendlyField = DISPLAY_FRIENDLY_TOOL_FIELDS.some((field) => field in normalizedLifecyclePayload);
@@ -238,7 +238,7 @@ function truncateProviderOutputValue(value, label, seen = /* @__PURE__ */ new We
   if (Array.isArray(value)) {
     return renderOutputPreview(value, label);
   }
-  if (!isRecord(value)) {
+  if (!isRecord$1(value)) {
     return value;
   }
   if (seen.has(value)) {
@@ -309,7 +309,7 @@ function hasDisplayPayload(value) {
   if (Array.isArray(sanitized)) {
     return sanitized.length > 0;
   }
-  if (isRecord(sanitized)) {
+  if (isRecord$1(sanitized)) {
     return Object.keys(sanitized).length > 0;
   }
   return true;
@@ -506,6 +506,242 @@ async function syncControlledByUserState(sessionClient, controlledByUser) {
   });
 }
 
+const SESSION_LABEL_MAX_LENGTH = 60;
+const TITLE_MAX_LENGTH = 80;
+const BODY_MAX_LENGTH = 140;
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeText(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const normalized = value.replace(/\s+/g, " ").trim();
+  return normalized.length > 0 ? normalized : null;
+}
+function truncateText(value, maxLength) {
+  if (value.length <= maxLength) {
+    return value;
+  }
+  return `${value.slice(0, maxLength - 1).trimEnd()}\u2026`;
+}
+function toProviderKey(providerLabel) {
+  const normalized = normalizeText(providerLabel)?.toLowerCase();
+  if (!normalized) {
+    return "unknown";
+  }
+  if (normalized === "claude" || normalized === "claude code" || normalized === "cloud code") {
+    return "claude";
+  }
+  if (normalized === "codex") {
+    return "codex";
+  }
+  if (normalized === "gemini") {
+    return "gemini";
+  }
+  return normalized.replace(/\s+/g, "-");
+}
+function deriveNotificationProviderLabel(providerLabel) {
+  const normalized = normalizeText(providerLabel)?.toLowerCase();
+  if (!normalized) {
+    return "Agent";
+  }
+  if (normalized === "claude" || normalized === "claude code" || normalized === "cloud code") {
+    return "Claude";
+  }
+  if (normalized === "codex") {
+    return "Codex";
+  }
+  if (normalized === "gemini") {
+    return "Gemini";
+  }
+  return normalizeText(providerLabel) ?? "Agent";
+}
+function buildNotificationTitle(sessionLabel, providerLabel, actionLabel) {
+  const providerDisplayLabel = deriveNotificationProviderLabel(providerLabel);
+  const suffix = ` \xB7 ${providerDisplayLabel} \xB7 ${actionLabel}`;
+  const maxSessionLength = Math.max(12, TITLE_MAX_LENGTH - suffix.length);
+  return `${truncateText(sessionLabel, maxSessionLength)}${suffix}`;
+}
+function derivePathLabel(path) {
+  const normalized = normalizeText(path);
+  if (!normalized) {
+    return null;
+  }
+  const segments = normalized.split(/[\\/]+/).filter(Boolean);
+  return segments[segments.length - 1] ?? normalized;
+}
+function deriveHomeLabel(homeSlug) {
+  const normalized = normalizeText(homeSlug);
+  if (!normalized) {
+    return null;
+  }
+  return normalized.replace(/[_-]+/g, " ");
+}
+function deriveNotificationSessionLabel(metadata, providerLabel) {
+  const label = normalizeText(metadata?.name) ?? normalizeText(metadata?.summary?.text) ?? deriveHomeLabel(metadata?.happyOrg?.specialistHome?.homeSlug) ?? derivePathLabel(metadata?.path) ?? normalizeText(providerLabel) ?? "Session";
+  return truncateText(label, SESSION_LABEL_MAX_LENGTH);
+}
+function deriveNotificationSummary(candidates, fallback, sessionLabel) {
+  for (const candidate of candidates) {
+    const normalized = normalizeText(candidate);
+    if (!normalized) {
+      continue;
+    }
+    const truncated = truncateText(normalized, BODY_MAX_LENGTH);
+    if (truncated.toLowerCase() !== sessionLabel.toLowerCase()) {
+      return truncated;
+    }
+  }
+  return truncateText(fallback, BODY_MAX_LENGTH);
+}
+function cleanExtraData(extraData) {
+  return Object.fromEntries(
+    Object.entries(extraData).filter(([, value]) => {
+      if (value === null || value === void 0) {
+        return false;
+      }
+      if (typeof value === "string") {
+        return value.trim().length > 0;
+      }
+      return true;
+    })
+  );
+}
+function buildRouteData(opts) {
+  const taskContext = opts.metadata?.happyOrg?.taskContext ?? null;
+  const routeTaskId = opts.report?.taskId ?? taskContext?.taskId ?? null;
+  const routePositionId = opts.report?.positionId ?? taskContext?.positionId ?? null;
+  const routeSessionId = normalizeText(opts.sessionId);
+  const data = {
+    notificationKind: opts.notificationKind,
+    provider: toProviderKey(opts.providerLabel)
+  };
+  if (opts.routePreference === "session" && routeSessionId) {
+    data.sessionId = routeSessionId;
+  } else if (routeTaskId) {
+    data.taskId = routeTaskId;
+  } else if (routeSessionId) {
+    data.sessionId = routeSessionId;
+  } else if (routePositionId) {
+    data.positionId = routePositionId;
+  }
+  Object.assign(data, cleanExtraData({
+    contextTaskId: data.taskId ? null : routeTaskId,
+    contextPositionId: data.positionId ? null : routePositionId,
+    memberAgentId: opts.report?.memberAgentId ?? taskContext?.memberAgentId ?? null,
+    supervisorAgentId: opts.report?.supervisorAgentId ?? taskContext?.supervisorAgentId ?? null
+  }));
+  if (opts.extraData) {
+    Object.assign(data, cleanExtraData(opts.extraData));
+  }
+  return data;
+}
+function humanizeToolName(toolName) {
+  const normalized = normalizeText(toolName);
+  if (!normalized) {
+    return "continue";
+  }
+  const replacements = {
+    bash: "run a command",
+    execute: "run a command",
+    read: "read a file",
+    write: "write a file",
+    edit: "edit a file",
+    multiedit: "edit files",
+    patch: "apply a patch",
+    fetch: "fetch a page",
+    search: "search the web"
+  };
+  const replacement = replacements[normalized.toLowerCase()];
+  if (replacement) {
+    return replacement;
+  }
+  return normalized.replace(/[_-]+/g, " ");
+}
+function extractPermissionRequestPushContext(message) {
+  const payload = isRecord(message.payload) ? message.payload : null;
+  const toolName = normalizeText(payload?.toolName) ?? normalizeText(message.reason);
+  const payloadDescription = normalizeText(payload?.description);
+  const reasonDescription = normalizeText(message.reason);
+  let description = payloadDescription;
+  if (!description && reasonDescription && reasonDescription.toLowerCase() !== (toolName ?? "").toLowerCase()) {
+    description = reasonDescription;
+  }
+  if (description && toolName && description.toLowerCase() === toolName.toLowerCase()) {
+    description = null;
+  }
+  return {
+    requestId: message.id,
+    toolName,
+    description
+  };
+}
+function buildReadyPushNotification(opts) {
+  const sessionLabel = deriveNotificationSessionLabel(opts.metadata, opts.providerLabel);
+  const providerDisplayLabel = deriveNotificationProviderLabel(opts.providerLabel);
+  return {
+    title: buildNotificationTitle(sessionLabel, opts.providerLabel, "Ready"),
+    body: truncateText(`${providerDisplayLabel} is waiting for your next message`, BODY_MAX_LENGTH),
+    data: buildRouteData({
+      ...opts,
+      notificationKind: "ready",
+      routePreference: "session"
+    })
+  };
+}
+function buildPermissionPushNotification(opts) {
+  const sessionLabel = deriveNotificationSessionLabel(opts.metadata, opts.providerLabel);
+  const providerDisplayLabel = deriveNotificationProviderLabel(opts.providerLabel);
+  const fallback = `${providerDisplayLabel} needs your approval to ${humanizeToolName(opts.toolName)}`;
+  const body = deriveNotificationSummary([opts.description], fallback, sessionLabel);
+  return {
+    title: buildNotificationTitle(sessionLabel, opts.providerLabel, "Permission needed"),
+    body,
+    data: buildRouteData({
+      ...opts,
+      notificationKind: "permission_request",
+      routePreference: "session",
+      extraData: {
+        requestId: opts.requestId,
+        tool: opts.toolName ?? null,
+        ...opts.extraData
+      }
+    })
+  };
+}
+function buildTurnResultPushNotification(opts) {
+  const sessionLabel = deriveNotificationSessionLabel(opts.metadata, opts.providerLabel);
+  const providerDisplayLabel = deriveNotificationProviderLabel(opts.providerLabel);
+  const report = opts.report ?? null;
+  const explicitSummary = normalizeText(report?.summary) ?? normalizeText(opts.responseText);
+  if (!explicitSummary) {
+    return null;
+  }
+  const fallback = `${providerDisplayLabel} has a new result ready`;
+  const body = deriveNotificationSummary(
+    [
+      explicitSummary
+    ],
+    fallback,
+    sessionLabel
+  );
+  const action = report?.turnStatus === "task_complete" ? "Task complete" : "New result";
+  return {
+    title: buildNotificationTitle(sessionLabel, opts.providerLabel, action),
+    body,
+    data: buildRouteData({
+      ...opts,
+      report,
+      notificationKind: "turn_result",
+      routePreference: "session",
+      extraData: {
+        turnStatus: report?.turnStatus ?? "turn_update"
+      }
+    })
+  };
+}
+
 const STRUCTURED_FIELD_PATTERN = /^\s*([a-z_]+)\s*=\s*(.*?)\s*$/;
 const KEY_VALUE_LINE_PATTERN = /^([A-Za-z0-9_]+)=(.*)$/;
 const HAPPY_ORG_READ_ACK = "yes";
@@ -2496,7 +2732,11 @@ exports.MessageBuffer = MessageBuffer;
 exports.MessageQueue2 = MessageQueue2;
 exports.MissingMachineIdError = MissingMachineIdError;
 exports.buildHappyOrgTurnPrompt = buildHappyOrgTurnPrompt;
+exports.buildPermissionPushNotification = buildPermissionPushNotification;
+exports.buildReadyPushNotification = buildReadyPushNotification;
+exports.buildTurnResultPushNotification = buildTurnResultPushNotification;
 exports.ensureManagedProviderMachine = ensureManagedProviderMachine;
+exports.extractPermissionRequestPushContext = extractPermissionRequestPushContext;
 exports.finalizeHappyOrgTurnWithBusinessAck = finalizeHappyOrgTurnWithBusinessAck;
 exports.forwardAgentMessageToProviderSession = forwardAgentMessageToProviderSession;
 exports.getPendingInteractionTimeoutMs = getPendingInteractionTimeoutMs;