very-happy-cli 0.2.203 → 0.2.204

package/dist/{AcpBackend-CAMuhS0Z.mjs → AcpBackend-BBfcpIDj.mjs}

@@ -1,11 +1,11 @@
 import { spawn } from 'node:child_process';
 import { ndJsonStream, ClientSideConnection } from '@agentclientprotocol/sdk';
 import { randomUUID } from 'node:crypto';
-import { l as logger } from './logger-BiKmiREe.mjs';
-import { d as delay } from './time-Che8GhII.mjs';
+import { l as logger } from './logger-BcdURxNR.mjs';
+import { d as delay } from './time-BWVJTcWI.mjs';
 import { c as contentLogMetadata, e as errorLogMetadata } from './contentLogMetadata-BlWI0egu.mjs';
 import { r as readableStderrTail, a as appendStderrRing, s as stopProcessGracefully, k as killProcessTree } from './processTree-CP5IvQ2Z.mjs';
-import { p as packageJson } from './package-CIW5lwaN.mjs';
+import { p as packageJson } from './package-Dx3hbh9J.mjs';
 
 function acpImageBlocks(attachments, supportsImages) {
   return attachments.filter((file) => ["image/jpeg", "image/png", "image/gif", "image/webp"].includes(file.mimeType)).map((file) => {

package/dist/{AcpBackend-DReFgpYD.cjs → AcpBackend-BupxHXGp.cjs}

@@ -3,11 +3,11 @@
 var node_child_process = require('node:child_process');
 var sdk = require('@agentclientprotocol/sdk');
 var node_crypto = require('node:crypto');
-var logger = require('./logger-BtWBoP60.cjs');
-var time = require('./time-BMCY7zJL.cjs');
+var logger = require('./logger-C8anCmdW.cjs');
+var time = require('./time-UUMqbIq8.cjs');
 var contentLogMetadata = require('./contentLogMetadata-ZSFk_NjQ.cjs');
 var processTree = require('./processTree-CMHWlVse.cjs');
-var _package = require('./package-Djdgx8nb.cjs');
+var _package = require('./package-DkpXQvp1.cjs');
 
 function acpImageBlocks(attachments, supportsImages) {
   return attachments.filter((file) => ["image/jpeg", "image/png", "image/gif", "image/webp"].includes(file.mimeType)).map((file) => {

package/dist/{AcpSessionManager-CJOxMFCF.mjs → AcpSessionManager-B9UkPYGi.mjs}

@@ -1,6 +1,6 @@
 import { createId } from '@paralleldrive/cuid2';
-import { s as streamKeyOf, t as createEnvelope } from './index-CiRMvS73.mjs';
-import { t as textResultPayload, b as toolResultPayload } from './api-D8ZDxBWw.mjs';
+import { s as streamKeyOf, t as createEnvelope } from './index-DWk-WTU-.mjs';
+import { t as textResultPayload, b as toolResultPayload } from './api-BYh1VGBa.mjs';
 
 function turnOptions(turnId, time) {
   return turnId ? { turn: turnId, time } : { time };

package/dist/{AcpSessionManager-BZKM-sCt.cjs → AcpSessionManager-JJrnenKM.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
 var cuid2 = require('@paralleldrive/cuid2');
-var index = require('./index-44o_qMvE.cjs');
-var api = require('./api-ChhFBuB0.cjs');
+var index = require('./index-BYL_X3gP.cjs');
+var api = require('./api-BoJA-zK3.cjs');
 
 function turnOptions(turnId, time) {
   return turnId ? { turn: turnId, time } : { time };

package/dist/{BasePermissionHandler-BBR9Gkob.cjs → BasePermissionHandler-86_xnisC.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var logger = require('./logger-BtWBoP60.cjs');
+var logger = require('./logger-C8anCmdW.cjs');
 
 class BasePermissionHandler {
   pendingRequests = /* @__PURE__ */ new Map();

package/dist/{BasePermissionHandler-BgX73mQ5.mjs → BasePermissionHandler-tGylJLUH.mjs}

@@ -1,4 +1,4 @@
-import { l as logger } from './logger-BiKmiREe.mjs';
+import { l as logger } from './logger-BcdURxNR.mjs';
 
 class BasePermissionHandler {
   pendingRequests = /* @__PURE__ */ new Map();

package/dist/{account-hy0rztXY.mjs → account-BRqUOj_D.mjs}

@@ -1,26 +1,26 @@
 import chalk from 'chalk';
 import { createInterface } from 'node:readline/promises';
-import { c as configuration } from './configuration-i9MVy0a5.mjs';
-import { g as getDaemonAgentProfiles, r as restartDaemonSession, l as listDaemonSessions } from './controlClient-D6vqMUfi.mjs';
-import { A as AccountService, b as bindResultMessages, a as AccountError, l as localRestartFailure } from './accountService-DEpIq6CF.mjs';
+import { c as configuration } from './configuration-D_YrWa_i.mjs';
+import { g as getDaemonAgentProfiles, r as restartDaemonSession, l as listDaemonSessions } from './controlClient-Daki7wgo.mjs';
+import { A as AccountService, b as bindResultMessages, a as AccountError, l as localRestartFailure } from './accountService-CqrWNH8K.mjs';
 import 'node:fs';
 import 'node:os';
 import 'node:path';
-import './package-CIW5lwaN.mjs';
+import './package-Dx3hbh9J.mjs';
 import 'node:fs/promises';
-import './logger-BiKmiREe.mjs';
+import './logger-BcdURxNR.mjs';
 import 'node:util';
-import './persistence-D_zVC4Xz.mjs';
+import './persistence-3iZXGbfb.mjs';
 import 'zod';
 import './authRelay-DhQhkBvX.mjs';
 import 'node:crypto';
 import 'tweetnacl';
-import './index-CiRMvS73.mjs';
+import './index-DWk-WTU-.mjs';
 import '@paralleldrive/cuid2';
 import 'node:child_process';
-import './claudeAccountEnv-DowsOlDB.mjs';
-import './store-DWmjM4Ex.mjs';
-import './codexAccount-CieIQLOX.mjs';
+import './claudeAccountEnv-C6Wl-ZbT.mjs';
+import './store-Fge1h9wy.mjs';
+import './codexAccount-BPQ-lPhH.mjs';
 import 'node:readline';
 
 const ACCOUNT_HELP = `Usage:
@@ -183,7 +183,7 @@ Waiting (expires in 15 minutes; Ctrl-C to cancel)\u2026`);
   }
 }
 async function loginInteractive(target) {
-  const { spawnSetupTokenPty } = await import('./daemonAccounts-D5shoCLt.mjs');
+  const { spawnSetupTokenPty } = await import('./daemonAccounts-BtkmoJmC.mjs');
   const { homedir } = await import('node:os');
   const svc = new AccountService({ home: configuration.happyHomeDir, spawnPty: (env) => spawnSetupTokenPty(homedir(), env) });
   const started = await svc.loginStart({ agent: "claude", kind: "claude-subscription", ...target });

package/dist/{account-41PkJ9nx.cjs → account-C91_R-kw.cjs}

@@ -2,27 +2,27 @@
 
 var chalk = require('chalk');
 var promises = require('node:readline/promises');
-var configuration = require('./configuration-Cl9kOv09.cjs');
-var controlClient = require('./controlClient-DxCQKfqe.cjs');
-var accountService = require('./accountService-Cns8UYGI.cjs');
+var configuration = require('./configuration-CDqmWkHO.cjs');
+var controlClient = require('./controlClient-BS86Ksm8.cjs');
+var accountService = require('./accountService-SOeB_21A.cjs');
 require('node:fs');
 require('node:os');
 require('node:path');
-require('./package-Djdgx8nb.cjs');
+require('./package-DkpXQvp1.cjs');
 require('node:fs/promises');
-require('./logger-BtWBoP60.cjs');
+require('./logger-C8anCmdW.cjs');
 require('node:util');
-require('./persistence-BOEZtiKb.cjs');
+require('./persistence-Ch78xygf.cjs');
 require('zod');
 require('./authRelay-Dy1qU9td.cjs');
 require('node:crypto');
 require('tweetnacl');
-require('./index-44o_qMvE.cjs');
+require('./index-BYL_X3gP.cjs');
 require('@paralleldrive/cuid2');
 require('node:child_process');
-require('./claudeAccountEnv-Btp39mfa.cjs');
-require('./store-Cpb1LMNW.cjs');
-require('./codexAccount-D-OBY29W.cjs');
+require('./claudeAccountEnv-BTZjHTpF.cjs');
+require('./store-DGMILdMn.cjs');
+require('./codexAccount-BjaHvmKH.cjs');
 require('node:readline');
 
 const ACCOUNT_HELP = `Usage:
@@ -185,7 +185,7 @@ Waiting (expires in 15 minutes; Ctrl-C to cancel)\u2026`);
   }
 }
 async function loginInteractive(target) {
-  const { spawnSetupTokenPty } = await Promise.resolve().then(function () { return require('./daemonAccounts-ciidbU2h.cjs'); });
+  const { spawnSetupTokenPty } = await Promise.resolve().then(function () { return require('./daemonAccounts-BOoI7-sw.cjs'); });
   const { homedir } = await import('node:os');
   const svc = new accountService.AccountService({ home: configuration.configuration.happyHomeDir, spawnPty: (env) => spawnSetupTokenPty(homedir(), env) });
   const started = await svc.loginStart({ agent: "claude", kind: "claude-subscription", ...target });

package/dist/{accountService-DEpIq6CF.mjs → accountService-CqrWNH8K.mjs}

@@ -1,12 +1,12 @@
 import { randomUUID } from 'node:crypto';
 import { mkdirSync, writeFileSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { L as AGENT_PROFILE_FEATURE_LAUNCH, M as AgentProfileAddRequestSchema, N as AgentProfileLoginStartRequestSchema, O as AgentProfileLoginSubmitRequestSchema, Q as AgentProfileBindRequestSchema } from './index-CiRMvS73.mjs';
+import { N as AGENT_PROFILE_FEATURE_LAUNCH, O as AgentProfileAddRequestSchema, Q as AgentProfileLoginStartRequestSchema, T as AgentProfileLoginSubmitRequestSchema, U as AgentProfileBindRequestSchema } from './index-DWk-WTU-.mjs';
 import { spawn } from 'node:child_process';
-import { A as ACCOUNT_STRIPPED_ENV_KEYS } from './claudeAccountEnv-DowsOlDB.mjs';
-import { C as CODEX_ALWAYS_STRIPPED_ENV_KEYS, r as readCodexProviders, s as syncCodexOverlay, b as baseCodexHome } from './codexAccount-CieIQLOX.mjs';
+import { A as ACCOUNT_STRIPPED_ENV_KEYS } from './claudeAccountEnv-C6Wl-ZbT.mjs';
+import { C as CODEX_ALWAYS_STRIPPED_ENV_KEYS, r as readCodexProviders, s as syncCodexOverlay, b as baseCodexHome } from './codexAccount-BPQ-lPhH.mjs';
 import { createInterface } from 'node:readline';
-import { h as buildAgentProfilesState, d as defaultSecretProbe, a as readAccounts, s as summarizeAccount, c as readAccountsFileV2, n as newAccountId, i as writeAccountSecret, f as writeAccountsFile, j as sessionsBoundTo, r as readSessionBindings, k as removeAccountSecret, b as accountSecretPath, e as expandHome, l as accountCodexHomePath, m as SUBSCRIPTION_TOKEN_TTL_MS, w as writeSessionBinding, o as readSessionBindingV2 } from './store-DWmjM4Ex.mjs';
+import { h as buildAgentProfilesState, d as defaultSecretProbe, a as readAccounts, s as summarizeAccount, c as readAccountsFileV2, n as newAccountId, i as writeAccountSecret, f as writeAccountsFile, j as sessionsBoundTo, r as readSessionBindings, k as removeAccountSecret, b as accountSecretPath, e as expandHome, l as accountCodexHomePath, m as SUBSCRIPTION_TOKEN_TTL_MS, w as writeSessionBinding, o as readSessionBindingV2 } from './store-Fge1h9wy.mjs';
 
 const CHECK_TIMEOUT_MS = 2e4;
 const DEFAULT_CHECK_MODEL = "claude-haiku-4-5";

package/dist/{accountService-Cns8UYGI.cjs → accountService-SOeB_21A.cjs}

@@ -3,12 +3,12 @@
 var node_crypto = require('node:crypto');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var index = require('./index-44o_qMvE.cjs');
+var index = require('./index-BYL_X3gP.cjs');
 var node_child_process = require('node:child_process');
-var claudeAccountEnv = require('./claudeAccountEnv-Btp39mfa.cjs');
-var codexAccount = require('./codexAccount-D-OBY29W.cjs');
+var claudeAccountEnv = require('./claudeAccountEnv-BTZjHTpF.cjs');
+var codexAccount = require('./codexAccount-BjaHvmKH.cjs');
 var node_readline = require('node:readline');
-var store = require('./store-Cpb1LMNW.cjs');
+var store = require('./store-DGMILdMn.cjs');
 
 const CHECK_TIMEOUT_MS = 2e4;
 const DEFAULT_CHECK_MODEL = "claude-haiku-4-5";

package/dist/{acpSessionResume-5El4xksf.mjs → acpSessionResume-CZQ91ano.mjs}

@@ -1,6 +1,6 @@
 import { mkdirSync, renameSync, existsSync, unlinkSync } from 'node:fs';
 import { join } from 'node:path';
-import { w as writePrivateFileSync, c as configuration } from './configuration-i9MVy0a5.mjs';
+import { w as writePrivateFileSync, c as configuration } from './configuration-D_YrWa_i.mjs';
 
 const SESSION_MODE_DIR = "session-modes";
 const ACP_PERMISSION_MODES = ["default", "acceptEdits", "plan", "bypassPermissions"];

package/dist/{acpSessionResume-DmOPXKpC.cjs → acpSessionResume-DK8EjIY0.cjs}

@@ -2,7 +2,7 @@
 
 var node_fs = require('node:fs');
 var path = require('node:path');
-var configuration = require('./configuration-Cl9kOv09.cjs');
+var configuration = require('./configuration-CDqmWkHO.cjs');
 
 const SESSION_MODE_DIR = "session-modes";
 const ACP_PERMISSION_MODES = ["default", "acceptEdits", "plan", "bypassPermissions"];

package/dist/{agentHome-DUxArmak.mjs → agentHome-71zGywwx.mjs}

@@ -1,13 +1,13 @@
 import chalk from 'chalk';
 import { homedir } from 'node:os';
-import { r as readSettings, u as updateSettings } from './persistence-D_zVC4Xz.mjs';
+import { r as readSettings, u as updateSettings } from './persistence-3iZXGbfb.mjs';
 import 'node:fs';
-import './logger-BiKmiREe.mjs';
+import './logger-BcdURxNR.mjs';
 import { d as describeAgentHome, p as probeLoginShellEnv, r as resolveAgentHomes, e as expandHomePath, A as AGENT_HOME_ENV_NAMES } from './loginShellEnv-Dw8M7tkI.mjs';
 import 'node:fs/promises';
-import './configuration-i9MVy0a5.mjs';
+import './configuration-D_YrWa_i.mjs';
 import 'node:path';
-import './package-CIW5lwaN.mjs';
+import './package-Dx3hbh9J.mjs';
 import 'zod';
 import './authRelay-DhQhkBvX.mjs';
 import 'node:crypto';

package/dist/{agentHome-BXaVMqHX.cjs → agentHome-BZvbPuy1.cjs}

@@ -2,14 +2,14 @@
 
 var chalk = require('chalk');
 var os = require('node:os');
-var persistence = require('./persistence-BOEZtiKb.cjs');
+var persistence = require('./persistence-Ch78xygf.cjs');
 require('node:fs');
-require('./logger-BtWBoP60.cjs');
+require('./logger-C8anCmdW.cjs');
 var loginShellEnv = require('./loginShellEnv-BkuYtExZ.cjs');
 require('node:fs/promises');
-require('./configuration-Cl9kOv09.cjs');
+require('./configuration-CDqmWkHO.cjs');
 require('node:path');
-require('./package-Djdgx8nb.cjs');
+require('./package-DkpXQvp1.cjs');
 require('zod');
 require('./authRelay-Dy1qU9td.cjs');
 require('node:crypto');

package/dist/{api-D8ZDxBWw.mjs → api-BYh1VGBa.mjs}

@@ -1,20 +1,20 @@
 import axios from 'axios';
-import { l as logger, a as redactLogValue } from './logger-BiKmiREe.mjs';
-import { A as AsyncLock, S as SESSION_SUPERSEDED_ERROR, a as agentInstanceAuth, b as MAX_CHAT_ATTACHMENT_ENCRYPTED_BYTES, U as UserMessageSchema, F as FileEventMessageSchema, P as PushNotificationClient } from './pushNotifications-RVpbqrxR.mjs';
-import { R as RpcHandlerManager, a as answerSocketRequest, c as connectGuarded, s as socketConnectGuard, d as describeSocketAckDrop, b as safeAck, i as isRateQuotaCode, p as pauseForRateQuota, e as shouldReconnect, f as createReconnectGate } from './reconnectGate-DSxYUCWy.mjs';
+import { l as logger, a as redactLogValue } from './logger-BcdURxNR.mjs';
+import { A as AsyncLock, S as SESSION_SUPERSEDED_ERROR, a as agentInstanceAuth, b as MAX_CHAT_ATTACHMENT_ENCRYPTED_BYTES, U as UserMessageSchema, F as FileEventMessageSchema, P as PushNotificationClient } from './pushNotifications-Db1NGJiA.mjs';
+import { R as RpcHandlerManager, a as answerSocketRequest, c as connectGuarded, s as socketConnectGuard, d as describeSocketAckDrop, b as safeAck, i as isRateQuotaCode, p as pauseForRateQuota, e as shouldReconnect, f as createReconnectGate } from './reconnectGate-Ie4nSKNl.mjs';
 import { EventEmitter } from 'node:events';
 import { io } from 'socket.io-client';
 import { h as decrypt, d as decodeBase64, i as decryptBlob, e as encodeBase64, g as encrypt, l as libsodiumEncryptForPublicKey, j as libsodiumPublicKeyFromSecretKey, k as getRandomBytes } from './authRelay-DhQhkBvX.mjs';
 import { p as prepareClipboardText, d as prepareClipboardHistoryText } from './limits-DIo7rEBR.mjs';
-import { b as backoff, d as delay, e as exponentialBackoffDelay } from './time-Che8GhII.mjs';
-import { c as configuration } from './configuration-i9MVy0a5.mjs';
+import { b as backoff, d as delay, e as exponentialBackoffDelay } from './time-BWVJTcWI.mjs';
+import { c as configuration } from './configuration-D_YrWa_i.mjs';
 import { createHmac, randomUUID } from 'node:crypto';
-import { t as createEnvelope, s as streamKeyOf, af as ReleaseDrainNoticeSchema, ag as RelayAssignmentResponseSchema } from './index-CiRMvS73.mjs';
-import { r as registerCommonHandlers } from './registerCommonHandlers-CQDRKlkG.mjs';
+import { t as createEnvelope, s as streamKeyOf, ag as ReleaseDrainNoticeSchema, ah as RelayAssignmentResponseSchema } from './index-DWk-WTU-.mjs';
+import { r as registerCommonHandlers } from './registerCommonHandlers-BR7BeGX3.mjs';
 import { createId } from '@paralleldrive/cuid2';
-import { I as InvalidateSync } from './sync-BIXH8ijr.mjs';
+import { I as InvalidateSync } from './sync-BZji3J2r.mjs';
 import { B as BackgroundTaskReporter } from './backgroundTaskActivity-8PdPxrvy.mjs';
-import { q as notifyDaemonTurnEvent, t as notifyDaemonBackgroundTasks } from './controlClient-D6vqMUfi.mjs';
+import { t as notifyDaemonTurnEvent, u as notifyDaemonBackgroundTasks } from './controlClient-Daki7wgo.mjs';
 import chalk from 'chalk';
 
 async function hmac_sha512(key, data) {
@@ -1204,6 +1204,33 @@ class PromptQueueDrain {
   }
 }
 
+const OUTBOX_BATCH_LIMITS = {
+  maxCount: 100,
+  maxBytes: 768 * 1024,
+  maxItemBytes: 1024 * 1024 - 4 * 1024
+};
+function outboxItemBytes(item) {
+  return item.content.length + item.localId.length + 32;
+}
+function planOutboxBatch(items, limits = OUTBOX_BATCH_LIMITS) {
+  const first = items[0];
+  if (!first) return null;
+  const firstBytes = outboxItemBytes(first);
+  if (firstBytes > limits.maxItemBytes) return { kind: "oversize", bytes: firstBytes };
+  const backfill = first.backfill === true;
+  let count = 1;
+  let bytes = firstBytes;
+  while (count < items.length && count < limits.maxCount) {
+    const next = items[count];
+    if (next.backfill === true !== backfill) break;
+    const nextBytes = outboxItemBytes(next);
+    if (nextBytes > limits.maxItemBytes || bytes + nextBytes > limits.maxBytes) break;
+    bytes += nextBytes;
+    count += 1;
+  }
+  return { kind: "send", count, backfill };
+}
+
 function advanceInboundCursor(current, handled) {
   let next = current;
   while (handled.has(next + 1)) {
@@ -1286,6 +1313,10 @@ class ApiSessionClient extends EventEmitter {
   };
   lastSeq = 0;
   pendingOutbox = [];
+  /** B-880: set while a transcript replay enqueues (see `replayHistory`). */
+  replayingHistory = false;
+  /** B-880 PR-2: the server-side backfill quota — declared before the first replay batch, closed after the last. */
+  backfillDeclaration = null;
   sendSync;
   receiveSync;
   directInboundLocalIds = /* @__PURE__ */ new Set();
@@ -1794,18 +1825,23 @@ class ApiSessionClient extends EventEmitter {
     }
     this.awaitingInitialFetch = false;
   }
-  static MAX_OUTBOX_BATCH_SIZE = 50;
   async flushOutbox() {
-    while (this.pendingOutbox.length > 0) {
-      const batchSize = Math.min(this.pendingOutbox.length, ApiSessionClient.MAX_OUTBOX_BATCH_SIZE);
-      const batch = this.pendingOutbox.slice(0, batchSize);
+    for (let plan = planOutboxBatch(this.pendingOutbox); plan; plan = planOutboxBatch(this.pendingOutbox)) {
+      if (plan.kind === "oversize") {
+        const [dropped] = this.pendingOutbox.splice(0, 1);
+        logger.debug(`[API] Dropped an outbound message of ${plan.bytes} bytes (over the server's request limit), localId ${dropped.localId}`);
+        continue;
+      }
+      const batch = this.pendingOutbox.slice(0, plan.count);
+      if (plan.backfill && this.backfillDeclaration === "pending") await this.declareBackfill(this.pendingBackfillCount());
       const response = await axios.post(
         `${configuration.serverUrl}/v3/sessions/${encodeURIComponent(this.sessionId)}/messages`,
         {
-          messages: batch
+          messages: batch.map(({ content, localId }) => ({ content, localId }))
         },
         {
-          headers: this.authHeaders(),
+          // B-880: marks a replayed transcript; the server honours it only for a declared backfill (spec PR-2).
+          headers: plan.backfill ? { ...this.authHeaders(), "X-Happy-Message-Origin": "backfill" } : this.authHeaders(),
           timeout: 6e4
         }
       );
@@ -1813,6 +1849,36 @@ class ApiSessionClient extends EventEmitter {
       this.noteHandledSeqs(messages.map((message) => message.seq));
       this.pushCommittedMessagesToRelay(batch, messages);
       this.pendingOutbox.splice(0, batch.length);
+      if (plan.backfill && this.backfillDeclaration === "declared" && this.pendingBackfillCount() === 0) await this.closeBackfill();
+    }
+  }
+  /**
+   * B-880 PR-2: the server lets a replay use its backfill write budget only up
+   * to what the session declared before its first message. Any answer
+   * (accepted, refused, 404 from an older server) settles it: the replay then
+   * uploads either way, on whichever budget the server picks. A network error
+   * throws, so the outbox retries it with the batch.
+   */
+  async declareBackfill(total) {
+    const response = await axios.post(
+      `${configuration.serverUrl}/v3/sessions/${encodeURIComponent(this.sessionId)}/backfill`,
+      { total },
+      { headers: this.authHeaders(), timeout: 15e3, validateStatus: () => true }
+    );
+    this.backfillDeclaration = response.status === 200 ? "declared" : "closed";
+    logger.debug(`[API] Backfill of ${total} messages declared: HTTP ${response.status}`);
+  }
+  /** B-880 PR-2: the replay is uploaded; later backfill-tagged writes go to the live budget. Best effort. */
+  async closeBackfill() {
+    this.backfillDeclaration = "closed";
+    try {
+      await axios.post(
+        `${configuration.serverUrl}/v3/sessions/${encodeURIComponent(this.sessionId)}/backfill`,
+        { done: true },
+        { headers: this.authHeaders(), timeout: 15e3, validateStatus: () => true }
+      );
+    } catch (error) {
+      logger.debug("[API] Closing the backfill failed (the quota stays as declared):", error);
     }
   }
   /**
@@ -1823,6 +1889,28 @@ class ApiSessionClient extends EventEmitter {
    * the outbox's own (InvalidateSync backoff), so a server that keeps failing
    * keeps this pending rather than resolving early.
    */
+  /**
+   * B-880: enqueue a replayed transcript (import / fork). Everything `replay`
+   * sends is uploaded as a history backfill: its own batches, its own server
+   * rate budget, and counted by `pendingBackfillCount` for the progress the
+   * Web shows. `replay` must be synchronous.
+   */
+  replayHistory(replay) {
+    this.replayingHistory = true;
+    try {
+      return replay();
+    } finally {
+      this.replayingHistory = false;
+      if (this.backfillDeclaration === null && this.pendingBackfillCount() > 0) this.backfillDeclaration = "pending";
+      if (this.pendingOutbox.length > 0) this.sendSync.invalidate();
+    }
+  }
+  /** B-880: replayed messages the server has not accepted yet. */
+  pendingBackfillCount() {
+    let count = 0;
+    for (const item of this.pendingOutbox) if (item.backfill) count += 1;
+    return count;
+  }
   async drainOutbox() {
     const target = new Set(this.pendingOutbox);
     while (this.pendingOutbox.some((item) => target.has(item))) {
@@ -1989,9 +2077,10 @@ class ApiSessionClient extends EventEmitter {
       // Deterministic localIds (terminal mirror, B-105) ride the server's
       // @@unique([sessionId, localId]) for replay idempotency; everything
       // else keeps the fire-once random id.
-      localId: localId ?? randomUUID()
+      localId: localId ?? randomUUID(),
+      ...this.replayingHistory ? { backfill: true } : {}
     });
-    if (invalidate) {
+    if (invalidate && !this.replayingHistory) {
       this.sendSync.invalidate();
     }
   }
@@ -3114,7 +3203,7 @@ class ApiClient {
     return new ApiSessionClient(this.credential.token, session, opts);
   }
   async machineSyncClient(machine) {
-    const { ApiMachineClient } = await import('./apiMachine-qav2pnk5.mjs');
+    const { ApiMachineClient } = await import('./apiMachine--_eI4PTv.mjs');
     return new ApiMachineClient(this.credential.token, machine);
   }
   push() {

package/dist/{api-ChhFBuB0.cjs → api-BoJA-zK3.cjs}

@@ -1,22 +1,22 @@
 'use strict';
 
 var axios = require('axios');
-var logger = require('./logger-BtWBoP60.cjs');
-var pushNotifications = require('./pushNotifications-B19lT5mY.cjs');
-var reconnectGate = require('./reconnectGate-B8ltzSJD.cjs');
+var logger = require('./logger-C8anCmdW.cjs');
+var pushNotifications = require('./pushNotifications-D2ejrxlN.cjs');
+var reconnectGate = require('./reconnectGate-S9yNiuY7.cjs');
 var node_events = require('node:events');
 var socket_ioClient = require('socket.io-client');
 var authRelay = require('./authRelay-Dy1qU9td.cjs');
 var limits = require('./limits-C-a7gr04.cjs');
-var time = require('./time-BMCY7zJL.cjs');
-var configuration = require('./configuration-Cl9kOv09.cjs');
+var time = require('./time-UUMqbIq8.cjs');
+var configuration = require('./configuration-CDqmWkHO.cjs');
 var node_crypto = require('node:crypto');
-var index = require('./index-44o_qMvE.cjs');
-var registerCommonHandlers = require('./registerCommonHandlers-Y2siJGwL.cjs');
+var index = require('./index-BYL_X3gP.cjs');
+var registerCommonHandlers = require('./registerCommonHandlers-51llVpLx.cjs');
 var cuid2 = require('@paralleldrive/cuid2');
-var sync = require('./sync-ni64k2OI.cjs');
+var sync = require('./sync-DzInYE_l.cjs');
 var backgroundTaskActivity = require('./backgroundTaskActivity-CBvUdj39.cjs');
-var controlClient = require('./controlClient-DxCQKfqe.cjs');
+var controlClient = require('./controlClient-BS86Ksm8.cjs');
 var chalk = require('chalk');
 
 async function hmac_sha512(key, data) {
@@ -1206,6 +1206,33 @@ class PromptQueueDrain {
   }
 }
 
+const OUTBOX_BATCH_LIMITS = {
+  maxCount: 100,
+  maxBytes: 768 * 1024,
+  maxItemBytes: 1024 * 1024 - 4 * 1024
+};
+function outboxItemBytes(item) {
+  return item.content.length + item.localId.length + 32;
+}
+function planOutboxBatch(items, limits = OUTBOX_BATCH_LIMITS) {
+  const first = items[0];
+  if (!first) return null;
+  const firstBytes = outboxItemBytes(first);
+  if (firstBytes > limits.maxItemBytes) return { kind: "oversize", bytes: firstBytes };
+  const backfill = first.backfill === true;
+  let count = 1;
+  let bytes = firstBytes;
+  while (count < items.length && count < limits.maxCount) {
+    const next = items[count];
+    if (next.backfill === true !== backfill) break;
+    const nextBytes = outboxItemBytes(next);
+    if (nextBytes > limits.maxItemBytes || bytes + nextBytes > limits.maxBytes) break;
+    bytes += nextBytes;
+    count += 1;
+  }
+  return { kind: "send", count, backfill };
+}
+
 function advanceInboundCursor(current, handled) {
   let next = current;
   while (handled.has(next + 1)) {
@@ -1288,6 +1315,10 @@ class ApiSessionClient extends node_events.EventEmitter {
   };
   lastSeq = 0;
   pendingOutbox = [];
+  /** B-880: set while a transcript replay enqueues (see `replayHistory`). */
+  replayingHistory = false;
+  /** B-880 PR-2: the server-side backfill quota — declared before the first replay batch, closed after the last. */
+  backfillDeclaration = null;
   sendSync;
   receiveSync;
   directInboundLocalIds = /* @__PURE__ */ new Set();
@@ -1796,18 +1827,23 @@ class ApiSessionClient extends node_events.EventEmitter {
     }
     this.awaitingInitialFetch = false;
   }
-  static MAX_OUTBOX_BATCH_SIZE = 50;
   async flushOutbox() {
-    while (this.pendingOutbox.length > 0) {
-      const batchSize = Math.min(this.pendingOutbox.length, ApiSessionClient.MAX_OUTBOX_BATCH_SIZE);
-      const batch = this.pendingOutbox.slice(0, batchSize);
+    for (let plan = planOutboxBatch(this.pendingOutbox); plan; plan = planOutboxBatch(this.pendingOutbox)) {
+      if (plan.kind === "oversize") {
+        const [dropped] = this.pendingOutbox.splice(0, 1);
+        logger.logger.debug(`[API] Dropped an outbound message of ${plan.bytes} bytes (over the server's request limit), localId ${dropped.localId}`);
+        continue;
+      }
+      const batch = this.pendingOutbox.slice(0, plan.count);
+      if (plan.backfill && this.backfillDeclaration === "pending") await this.declareBackfill(this.pendingBackfillCount());
       const response = await axios.post(
         `${configuration.configuration.serverUrl}/v3/sessions/${encodeURIComponent(this.sessionId)}/messages`,
         {
-          messages: batch
+          messages: batch.map(({ content, localId }) => ({ content, localId }))
         },
         {
-          headers: this.authHeaders(),
+          // B-880: marks a replayed transcript; the server honours it only for a declared backfill (spec PR-2).
+          headers: plan.backfill ? { ...this.authHeaders(), "X-Happy-Message-Origin": "backfill" } : this.authHeaders(),
           timeout: 6e4
         }
       );
@@ -1815,6 +1851,36 @@ class ApiSessionClient extends node_events.EventEmitter {
       this.noteHandledSeqs(messages.map((message) => message.seq));
       this.pushCommittedMessagesToRelay(batch, messages);
       this.pendingOutbox.splice(0, batch.length);
+      if (plan.backfill && this.backfillDeclaration === "declared" && this.pendingBackfillCount() === 0) await this.closeBackfill();
+    }
+  }
+  /**
+   * B-880 PR-2: the server lets a replay use its backfill write budget only up
+   * to what the session declared before its first message. Any answer
+   * (accepted, refused, 404 from an older server) settles it: the replay then
+   * uploads either way, on whichever budget the server picks. A network error
+   * throws, so the outbox retries it with the batch.
+   */
+  async declareBackfill(total) {
+    const response = await axios.post(
+      `${configuration.configuration.serverUrl}/v3/sessions/${encodeURIComponent(this.sessionId)}/backfill`,
+      { total },
+      { headers: this.authHeaders(), timeout: 15e3, validateStatus: () => true }
+    );
+    this.backfillDeclaration = response.status === 200 ? "declared" : "closed";
+    logger.logger.debug(`[API] Backfill of ${total} messages declared: HTTP ${response.status}`);
+  }
+  /** B-880 PR-2: the replay is uploaded; later backfill-tagged writes go to the live budget. Best effort. */
+  async closeBackfill() {
+    this.backfillDeclaration = "closed";
+    try {
+      await axios.post(
+        `${configuration.configuration.serverUrl}/v3/sessions/${encodeURIComponent(this.sessionId)}/backfill`,
+        { done: true },
+        { headers: this.authHeaders(), timeout: 15e3, validateStatus: () => true }
+      );
+    } catch (error) {
+      logger.logger.debug("[API] Closing the backfill failed (the quota stays as declared):", error);
     }
   }
   /**
@@ -1825,6 +1891,28 @@ class ApiSessionClient extends node_events.EventEmitter {
    * the outbox's own (InvalidateSync backoff), so a server that keeps failing
    * keeps this pending rather than resolving early.
    */
+  /**
+   * B-880: enqueue a replayed transcript (import / fork). Everything `replay`
+   * sends is uploaded as a history backfill: its own batches, its own server
+   * rate budget, and counted by `pendingBackfillCount` for the progress the
+   * Web shows. `replay` must be synchronous.
+   */
+  replayHistory(replay) {
+    this.replayingHistory = true;
+    try {
+      return replay();
+    } finally {
+      this.replayingHistory = false;
+      if (this.backfillDeclaration === null && this.pendingBackfillCount() > 0) this.backfillDeclaration = "pending";
+      if (this.pendingOutbox.length > 0) this.sendSync.invalidate();
+    }
+  }
+  /** B-880: replayed messages the server has not accepted yet. */
+  pendingBackfillCount() {
+    let count = 0;
+    for (const item of this.pendingOutbox) if (item.backfill) count += 1;
+    return count;
+  }
   async drainOutbox() {
     const target = new Set(this.pendingOutbox);
     while (this.pendingOutbox.some((item) => target.has(item))) {
@@ -1991,9 +2079,10 @@ class ApiSessionClient extends node_events.EventEmitter {
       // Deterministic localIds (terminal mirror, B-105) ride the server's
       // @@unique([sessionId, localId]) for replay idempotency; everything
       // else keeps the fire-once random id.
-      localId: localId ?? node_crypto.randomUUID()
+      localId: localId ?? node_crypto.randomUUID(),
+      ...this.replayingHistory ? { backfill: true } : {}
     });
-    if (invalidate) {
+    if (invalidate && !this.replayingHistory) {
       this.sendSync.invalidate();
     }
   }
@@ -3116,7 +3205,7 @@ class ApiClient {
     return new ApiSessionClient(this.credential.token, session, opts);
   }
   async machineSyncClient(machine) {
-    const { ApiMachineClient } = await Promise.resolve().then(function () { return require('./apiMachine-MPwddFXq.cjs'); });
+    const { ApiMachineClient } = await Promise.resolve().then(function () { return require('./apiMachine-CA58NM_V.cjs'); });
     return new ApiMachineClient(this.credential.token, machine);
   }
   push() {