@agenticmail/core 0.9.27 → 0.9.28

package/dist/index.cjs

@@ -7514,19 +7514,19 @@ var PHONE_MISSION_STATES = [
   "failed",
   "cancelled"
 ];
-var PHONE_SERVER_MAX_CALL_DURATION_SECONDS = 3600;
+var PHONE_SERVER_MAX_CALL_DURATION_SECONDS = 7200;
 var PHONE_SERVER_MAX_COST_PER_MISSION = 5;
 var PHONE_SERVER_MAX_ATTEMPTS = 3;
 var PHONE_TASK_MAX_LENGTH = 2e3;
-var PHONE_SERVER_MAX_EXTENSION_SECONDS_PER_REQUEST = 300;
-var PHONE_SERVER_MAX_EXTENSION_REQUESTS_PER_CALL = 4;
-var PHONE_SERVER_MAX_TOTAL_EXTENSION_SECONDS = 600;
+var PHONE_SERVER_MAX_EXTENSION_SECONDS_PER_REQUEST = 900;
+var PHONE_SERVER_MAX_EXTENSION_REQUESTS_PER_CALL = 8;
+var PHONE_SERVER_MAX_TOTAL_EXTENSION_SECONDS = 3600;
 var DEFAULT_EXTENSION_POLICY = {
-  maxSecondsPerRequest: 120,
-  // 2 minutes
-  maxRequestsPerCall: 2,
-  maxTotalExtensionSeconds: 300
+  maxSecondsPerRequest: 300,
   // 5 minutes
+  maxRequestsPerCall: 4,
+  maxTotalExtensionSeconds: 1200
+  // 20 minutes
 };
 var PHONE_SERVER_MAX_CALLBACK_CHAIN = 3;
 var DEFAULT_CALLBACK_POLICY = {
@@ -10745,6 +10745,20 @@ var SCHEDULE_CALLBACK_TOOL = {
     required: ["delay_seconds", "summary_for_next_call"]
   }
 };
+var END_CALL_TOOL = {
+  type: "function",
+  name: "end_call",
+  description: `Hang up the call. You MUST call this AFTER you have said goodbye and the conversation is complete \u2014 saying "I'll hang up now" is not enough on its own, the call stays open until you actually call this tool. Use it when: the task is done and you have signed off, the caller has indicated the conversation is over, you have scheduled a callback and said goodbye, or the caller has stopped responding for an extended period. Once called the call drops immediately; you cannot un-hang-up.`,
+  parameters: {
+    type: "object",
+    properties: {
+      reason: {
+        type: "string",
+        description: 'One short line for the audit trail \u2014 e.g. "task complete", "caller said bye", "scheduled callback, signing off". Optional but recommended.'
+      }
+    }
+  }
+};
 var REALTIME_TOOL_DEFINITIONS = {
   ask_operator: ASK_OPERATOR_TOOL,
   web_search: WEB_SEARCH_TOOL,
@@ -10755,7 +10769,8 @@ var REALTIME_TOOL_DEFINITIONS = {
   load_skill: LOAD_SKILL_TOOL,
   get_call_status: GET_CALL_STATUS_TOOL,
   extend_call_time: EXTEND_CALL_TIME_TOOL,
-  schedule_callback: SCHEDULE_CALLBACK_TOOL
+  schedule_callback: SCHEDULE_CALLBACK_TOOL,
+  end_call: END_CALL_TOOL
 };
 function buildRealtimeToolGuidance(tools) {
   if (tools.length === 0) return "";
@@ -10802,6 +10817,24 @@ A skill's rendered playbook is now part of your instructions for the rest of the
       "When in doubt \u2014 out of time, out of extensions, the caller is uncertain \u2014 preferred order is: wrap up gracefully \u2192 schedule_callback \u2192 sign off. Never go silent or invent excuses; the right move is always a clean handoff to a future call."
     );
   }
+  if (names.has("end_call")) {
+    lines.push(
+      "# Hanging up \u2014 you must call end_call to actually drop the line",
+      `SAYING "I'll hang up now" or "goodbye" does NOT drop the call \u2014 the line stays open until you call the end_call tool. This is the single most important habit on a real phone call: after you have said your goodbye sentence, IMMEDIATELY call end_call({ reason: "..." }). Do not wait for the caller to hang up first; do not assume the system will close the line for you. Call end_call yourself.`,
+      "",
+      "When to call end_call:",
+      "- The task is complete and you have just said goodbye.",
+      '- The caller said "thanks, bye" or otherwise signalled they are done.',
+      `- You scheduled a callback and said "I'll call you back at <when>".`,
+      "- The caller has gone silent for an extended stretch and is clearly not coming back.",
+      "- The operator told you to hang up.",
+      "",
+      "Do NOT call end_call:",
+      "- Mid-conversation when there is still pending business.",
+      "- Because you ran into a tool error \u2014 handle it and keep the call going.",
+      "- During a hold while a tool is running \u2014 let the tool finish."
+    );
+  }
   return lines.join("\n");
 }
 function toolErrorText(err) {
@@ -11681,8 +11714,10 @@ var RealtimeVoiceBridge = class {
     }
     let granted = Math.min(asked, pol.maxSecondsPerRequest, remainingBudgetSeconds);
     const elapsedSeconds = Math.floor((this.nowFn() - this.callStartedAtMs) / 1e3);
-    const maxAllowedFromStart = 3600;
-    const hardCeilingRoom = Math.max(0, maxAllowedFromStart - (elapsedSeconds + this.getTimeRemainingSeconds()));
+    const hardCeilingRoom = Math.max(
+      0,
+      PHONE_SERVER_MAX_CALL_DURATION_SECONDS - (elapsedSeconds + this.getTimeRemainingSeconds())
+    );
     granted = Math.min(granted, hardCeilingRoom);
     if (granted <= 0) {
       return {
@@ -11921,6 +11956,31 @@ var RealtimeVoiceBridge = class {
     return "\u2026\n" + joined.slice(joined.length - MAX_CALLBACK_TRANSCRIPT_DIGEST_LENGTH + 2);
   }
   // ─── Teardown ─────────────────────────────────────────
+  /**
+   * v0.9.82 — agent-initiated hangup. Called when the `end_call` tool
+   * fires. Logs a marker, then routes through {@link end} so the
+   * carrier sees the bye frame and `onEnd` fires exactly once (the
+   * same teardown path the human-hangup case takes). The "agent-
+   * requested" reason flows through to the mission transcript so a
+   * post-call audit can tell apart "agent hung up" from "human hung
+   * up" from "time budget exceeded".
+   *
+   * Returns the structured result the tool handler echoes back to the
+   * model — even though by the time the model receives it the line
+   * will already be closed, keeping a consistent return shape lets the
+   * executor JSON-stringify deterministically.
+   */
+  endByAgentRequest(reason) {
+    if (this.ended) {
+      return { ok: false, message: "Call has already ended." };
+    }
+    const trimmed = (reason ?? "").trim();
+    this.emitTranscript("system", `Agent requested hangup. Reason: ${trimmed || "unspecified"}`, {
+      endedByAgent: true
+    });
+    this.end("agent-requested");
+    return { ok: true, message: "Call ended." };
+  }
   /**
    * End the bridge. Idempotent — the first call wins, later calls are
    * no-ops. Sends the carrier's end-of-call frame (if it has one — 46elks

package/dist/index.d.cts

@@ -2618,7 +2618,7 @@ type PhoneNumberRisk = 'invalid' | 'standard' | 'premium_or_special';
  * be MORE restrictive than the server, never less. A phone mission places
  * real, billed calls — these bounds are the financial blast-radius cap.
  */
-declare const PHONE_SERVER_MAX_CALL_DURATION_SECONDS = 3600;
+declare const PHONE_SERVER_MAX_CALL_DURATION_SECONDS = 7200;
 declare const PHONE_SERVER_MAX_COST_PER_MISSION = 5;
 declare const PHONE_SERVER_MAX_ATTEMPTS = 3;
 /** Hard cap on the free-text `task` fed to the voice runtime. */
@@ -3692,6 +3692,24 @@ declare class RealtimeVoiceBridge {
      * Always honours {@link MAX_CALLBACK_TRANSCRIPT_DIGEST_LENGTH}.
      */
     private composeTranscriptDigest;
+    /**
+     * v0.9.82 — agent-initiated hangup. Called when the `end_call` tool
+     * fires. Logs a marker, then routes through {@link end} so the
+     * carrier sees the bye frame and `onEnd` fires exactly once (the
+     * same teardown path the human-hangup case takes). The "agent-
+     * requested" reason flows through to the mission transcript so a
+     * post-call audit can tell apart "agent hung up" from "human hung
+     * up" from "time budget exceeded".
+     *
+     * Returns the structured result the tool handler echoes back to the
+     * model — even though by the time the model receives it the line
+     * will already be closed, keeping a consistent return shape lets the
+     * executor JSON-stringify deterministically.
+     */
+    endByAgentRequest(reason?: string): {
+        ok: boolean;
+        message: string;
+    };
     /**
      * End the bridge. Idempotent — the first call wins, later calls are
      * no-ops. Sends the carrier's end-of-call frame (if it has one — 46elks

package/dist/index.d.ts

@@ -2618,7 +2618,7 @@ type PhoneNumberRisk = 'invalid' | 'standard' | 'premium_or_special';
  * be MORE restrictive than the server, never less. A phone mission places
  * real, billed calls — these bounds are the financial blast-radius cap.
  */
-declare const PHONE_SERVER_MAX_CALL_DURATION_SECONDS = 3600;
+declare const PHONE_SERVER_MAX_CALL_DURATION_SECONDS = 7200;
 declare const PHONE_SERVER_MAX_COST_PER_MISSION = 5;
 declare const PHONE_SERVER_MAX_ATTEMPTS = 3;
 /** Hard cap on the free-text `task` fed to the voice runtime. */
@@ -3692,6 +3692,24 @@ declare class RealtimeVoiceBridge {
      * Always honours {@link MAX_CALLBACK_TRANSCRIPT_DIGEST_LENGTH}.
      */
     private composeTranscriptDigest;
+    /**
+     * v0.9.82 — agent-initiated hangup. Called when the `end_call` tool
+     * fires. Logs a marker, then routes through {@link end} so the
+     * carrier sees the bye frame and `onEnd` fires exactly once (the
+     * same teardown path the human-hangup case takes). The "agent-
+     * requested" reason flows through to the mission transcript so a
+     * post-call audit can tell apart "agent hung up" from "human hung
+     * up" from "time budget exceeded".
+     *
+     * Returns the structured result the tool handler echoes back to the
+     * model — even though by the time the model receives it the line
+     * will already be closed, keeping a consistent return shape lets the
+     * executor JSON-stringify deterministically.
+     */
+    endByAgentRequest(reason?: string): {
+        ok: boolean;
+        message: string;
+    };
     /**
      * End the bridge. Idempotent — the first call wins, later calls are
      * no-ops. Sends the carrier's end-of-call frame (if it has one — 46elks

package/dist/index.js

@@ -5865,19 +5865,19 @@ var PHONE_MISSION_STATES = [
   "failed",
   "cancelled"
 ];
-var PHONE_SERVER_MAX_CALL_DURATION_SECONDS = 3600;
+var PHONE_SERVER_MAX_CALL_DURATION_SECONDS = 7200;
 var PHONE_SERVER_MAX_COST_PER_MISSION = 5;
 var PHONE_SERVER_MAX_ATTEMPTS = 3;
 var PHONE_TASK_MAX_LENGTH = 2e3;
-var PHONE_SERVER_MAX_EXTENSION_SECONDS_PER_REQUEST = 300;
-var PHONE_SERVER_MAX_EXTENSION_REQUESTS_PER_CALL = 4;
-var PHONE_SERVER_MAX_TOTAL_EXTENSION_SECONDS = 600;
+var PHONE_SERVER_MAX_EXTENSION_SECONDS_PER_REQUEST = 900;
+var PHONE_SERVER_MAX_EXTENSION_REQUESTS_PER_CALL = 8;
+var PHONE_SERVER_MAX_TOTAL_EXTENSION_SECONDS = 3600;
 var DEFAULT_EXTENSION_POLICY = {
-  maxSecondsPerRequest: 120,
-  // 2 minutes
-  maxRequestsPerCall: 2,
-  maxTotalExtensionSeconds: 300
+  maxSecondsPerRequest: 300,
   // 5 minutes
+  maxRequestsPerCall: 4,
+  maxTotalExtensionSeconds: 1200
+  // 20 minutes
 };
 var PHONE_SERVER_MAX_CALLBACK_CHAIN = 3;
 var DEFAULT_CALLBACK_POLICY = {
@@ -9096,6 +9096,20 @@ var SCHEDULE_CALLBACK_TOOL = {
     required: ["delay_seconds", "summary_for_next_call"]
   }
 };
+var END_CALL_TOOL = {
+  type: "function",
+  name: "end_call",
+  description: `Hang up the call. You MUST call this AFTER you have said goodbye and the conversation is complete \u2014 saying "I'll hang up now" is not enough on its own, the call stays open until you actually call this tool. Use it when: the task is done and you have signed off, the caller has indicated the conversation is over, you have scheduled a callback and said goodbye, or the caller has stopped responding for an extended period. Once called the call drops immediately; you cannot un-hang-up.`,
+  parameters: {
+    type: "object",
+    properties: {
+      reason: {
+        type: "string",
+        description: 'One short line for the audit trail \u2014 e.g. "task complete", "caller said bye", "scheduled callback, signing off". Optional but recommended.'
+      }
+    }
+  }
+};
 var REALTIME_TOOL_DEFINITIONS = {
   ask_operator: ASK_OPERATOR_TOOL,
   web_search: WEB_SEARCH_TOOL,
@@ -9106,7 +9120,8 @@ var REALTIME_TOOL_DEFINITIONS = {
   load_skill: LOAD_SKILL_TOOL,
   get_call_status: GET_CALL_STATUS_TOOL,
   extend_call_time: EXTEND_CALL_TIME_TOOL,
-  schedule_callback: SCHEDULE_CALLBACK_TOOL
+  schedule_callback: SCHEDULE_CALLBACK_TOOL,
+  end_call: END_CALL_TOOL
 };
 function buildRealtimeToolGuidance(tools) {
   if (tools.length === 0) return "";
@@ -9153,6 +9168,24 @@ A skill's rendered playbook is now part of your instructions for the rest of the
       "When in doubt \u2014 out of time, out of extensions, the caller is uncertain \u2014 preferred order is: wrap up gracefully \u2192 schedule_callback \u2192 sign off. Never go silent or invent excuses; the right move is always a clean handoff to a future call."
     );
   }
+  if (names.has("end_call")) {
+    lines.push(
+      "# Hanging up \u2014 you must call end_call to actually drop the line",
+      `SAYING "I'll hang up now" or "goodbye" does NOT drop the call \u2014 the line stays open until you call the end_call tool. This is the single most important habit on a real phone call: after you have said your goodbye sentence, IMMEDIATELY call end_call({ reason: "..." }). Do not wait for the caller to hang up first; do not assume the system will close the line for you. Call end_call yourself.`,
+      "",
+      "When to call end_call:",
+      "- The task is complete and you have just said goodbye.",
+      '- The caller said "thanks, bye" or otherwise signalled they are done.',
+      `- You scheduled a callback and said "I'll call you back at <when>".`,
+      "- The caller has gone silent for an extended stretch and is clearly not coming back.",
+      "- The operator told you to hang up.",
+      "",
+      "Do NOT call end_call:",
+      "- Mid-conversation when there is still pending business.",
+      "- Because you ran into a tool error \u2014 handle it and keep the call going.",
+      "- During a hold while a tool is running \u2014 let the tool finish."
+    );
+  }
   return lines.join("\n");
 }
 function toolErrorText(err) {
@@ -10032,8 +10065,10 @@ var RealtimeVoiceBridge = class {
     }
     let granted = Math.min(asked, pol.maxSecondsPerRequest, remainingBudgetSeconds);
     const elapsedSeconds = Math.floor((this.nowFn() - this.callStartedAtMs) / 1e3);
-    const maxAllowedFromStart = 3600;
-    const hardCeilingRoom = Math.max(0, maxAllowedFromStart - (elapsedSeconds + this.getTimeRemainingSeconds()));
+    const hardCeilingRoom = Math.max(
+      0,
+      PHONE_SERVER_MAX_CALL_DURATION_SECONDS - (elapsedSeconds + this.getTimeRemainingSeconds())
+    );
     granted = Math.min(granted, hardCeilingRoom);
     if (granted <= 0) {
       return {
@@ -10272,6 +10307,31 @@ var RealtimeVoiceBridge = class {
     return "\u2026\n" + joined.slice(joined.length - MAX_CALLBACK_TRANSCRIPT_DIGEST_LENGTH + 2);
   }
   // ─── Teardown ─────────────────────────────────────────
+  /**
+   * v0.9.82 — agent-initiated hangup. Called when the `end_call` tool
+   * fires. Logs a marker, then routes through {@link end} so the
+   * carrier sees the bye frame and `onEnd` fires exactly once (the
+   * same teardown path the human-hangup case takes). The "agent-
+   * requested" reason flows through to the mission transcript so a
+   * post-call audit can tell apart "agent hung up" from "human hung
+   * up" from "time budget exceeded".
+   *
+   * Returns the structured result the tool handler echoes back to the
+   * model — even though by the time the model receives it the line
+   * will already be closed, keeping a consistent return shape lets the
+   * executor JSON-stringify deterministically.
+   */
+  endByAgentRequest(reason) {
+    if (this.ended) {
+      return { ok: false, message: "Call has already ended." };
+    }
+    const trimmed = (reason ?? "").trim();
+    this.emitTranscript("system", `Agent requested hangup. Reason: ${trimmed || "unspecified"}`, {
+      endedByAgent: true
+    });
+    this.end("agent-requested");
+    return { ok: true, message: "Call ended." };
+  }
   /**
    * End the bridge. Idempotent — the first call wins, later calls are
    * no-ops. Sends the carrier's end-of-call frame (if it has one — 46elks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/core",
-  "version": "0.9.27",
+  "version": "0.9.28",
   "description": "Core SDK for AgenticMail — email, SMS, and phone call-control for AI agents",
   "type": "module",
   "main": "dist/index.js",