@txtcel/mcp 0.2.0 → 0.4.0

package/dist/index.js

@@ -3111,9 +3111,9 @@ var require_data = __commonJS({
   }
 });
 
-// node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/utils.js
+// node_modules/.pnpm/fast-uri@3.1.3/node_modules/fast-uri/lib/utils.js
 var require_utils = __commonJS({
-  "node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/utils.js"(exports, module) {
+  "node_modules/.pnpm/fast-uri@3.1.3/node_modules/fast-uri/lib/utils.js"(exports, module) {
     "use strict";
     var isUUID = RegExp.prototype.test.bind(/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu);
     var isIPv4 = RegExp.prototype.test.bind(/^(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/u);
@@ -3424,9 +3424,9 @@ var require_utils = __commonJS({
   }
 });
 
-// node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/schemes.js
+// node_modules/.pnpm/fast-uri@3.1.3/node_modules/fast-uri/lib/schemes.js
 var require_schemes = __commonJS({
-  "node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/lib/schemes.js"(exports, module) {
+  "node_modules/.pnpm/fast-uri@3.1.3/node_modules/fast-uri/lib/schemes.js"(exports, module) {
     "use strict";
     var { isUUID } = require_utils();
     var URN_REG = /([\da-z][\d\-a-z]{0,31}):((?:[\w!$'()*+,\-.:;=@]|%[\da-f]{2})+)/iu;
@@ -3634,9 +3634,9 @@ var require_schemes = __commonJS({
   }
 });
 
-// node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/index.js
+// node_modules/.pnpm/fast-uri@3.1.3/node_modules/fast-uri/index.js
 var require_fast_uri = __commonJS({
-  "node_modules/.pnpm/fast-uri@3.1.2/node_modules/fast-uri/index.js"(exports, module) {
+  "node_modules/.pnpm/fast-uri@3.1.3/node_modules/fast-uri/index.js"(exports, module) {
     "use strict";
     var { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizePercentEncoding, normalizePathEncoding, escapePreservingEscapes, reescapeHostDelimiters, isIPv4, nonSimpleDomain } = require_utils();
     var { SCHEMES, getSchemeHandler } = require_schemes();
@@ -3849,7 +3849,7 @@ var require_fast_uri = __commonJS({
         if (!options.unicodeSupport && (!schemeHandler || !schemeHandler.unicodeSupport)) {
           if (parsed.host && (options.domainHost || schemeHandler && schemeHandler.domainHost) && isIP === false && nonSimpleDomain(parsed.host)) {
             try {
-              parsed.host = URL.domainToASCII(parsed.host.toLowerCase());
+              parsed.host = new URL("http://" + parsed.host).hostname;
             } catch (e) {
               parsed.error = parsed.error || "Host's domain name can not be converted to ASCII: " + e;
             }
@@ -6897,9 +6897,9 @@ var require_dist = __commonJS({
   }
 });
 
-// node_modules/.pnpm/bn.js@5.2.3/node_modules/bn.js/lib/bn.js
+// node_modules/.pnpm/bn.js@5.2.4/node_modules/bn.js/lib/bn.js
 var require_bn = __commonJS({
-  "node_modules/.pnpm/bn.js@5.2.3/node_modules/bn.js/lib/bn.js"(exports, module) {
+  "node_modules/.pnpm/bn.js@5.2.4/node_modules/bn.js/lib/bn.js"(exports, module) {
     "use strict";
     (function(module2, exports2) {
       "use strict";
@@ -7679,6 +7679,10 @@ var require_bn = __commonJS({
         }
         if (bitsLeft > 0) {
           this.words[i] = ~this.words[i] & 67108863 >> 26 - bitsLeft;
+          i++;
+        }
+        for (; i < this.length; i++) {
+          this.words[i] = 0;
         }
         return this._strip();
       };
@@ -12491,9 +12495,9 @@ var init_esm_node = __esm({
   }
 });
 
-// node_modules/.pnpm/jayson@4.3.0/node_modules/jayson/lib/generateRequest.js
+// node_modules/.pnpm/jayson@4.3.0_bufferutil@4.1.0_utf-8-validate@6.0.6/node_modules/jayson/lib/generateRequest.js
 var require_generateRequest = __commonJS({
-  "node_modules/.pnpm/jayson@4.3.0/node_modules/jayson/lib/generateRequest.js"(exports, module) {
+  "node_modules/.pnpm/jayson@4.3.0_bufferutil@4.1.0_utf-8-validate@6.0.6/node_modules/jayson/lib/generateRequest.js"(exports, module) {
     "use strict";
     var uuid2 = (init_esm_node(), __toCommonJS(esm_node_exports)).v4;
     var generateRequest = function(method, params, id, options) {
@@ -12535,9 +12539,9 @@ var require_generateRequest = __commonJS({
   }
 });
 
-// node_modules/.pnpm/jayson@4.3.0/node_modules/jayson/lib/client/browser/index.js
+// node_modules/.pnpm/jayson@4.3.0_bufferutil@4.1.0_utf-8-validate@6.0.6/node_modules/jayson/lib/client/browser/index.js
 var require_browser = __commonJS({
-  "node_modules/.pnpm/jayson@4.3.0/node_modules/jayson/lib/client/browser/index.js"(exports, module) {
+  "node_modules/.pnpm/jayson@4.3.0_bufferutil@4.1.0_utf-8-validate@6.0.6/node_modules/jayson/lib/client/browser/index.js"(exports, module) {
     "use strict";
     var uuid2 = (init_esm_node(), __toCommonJS(esm_node_exports)).v4;
     var generateRequest = require_generateRequest();
@@ -33498,7 +33502,7 @@ var StdioServerTransport = class {
   }
 };
 
-// node_modules/.pnpm/@solana+web3.js@1.98.4_typescript@5.9.3/node_modules/@solana/web3.js/lib/index.esm.js
+// node_modules/.pnpm/@solana+web3.js@1.98.4_bufferutil@4.1.0_typescript@5.9.3_utf-8-validate@6.0.6/node_modules/@solana/web3.js/lib/index.esm.js
 import { Buffer as Buffer2 } from "buffer";
 
 // node_modules/.pnpm/@noble+hashes@1.8.0/node_modules/@noble/hashes/esm/cryptoNode.js
@@ -35735,14 +35739,14 @@ _RistrettoPoint.ZERO = /* @__PURE__ */ (() => new _RistrettoPoint(ed25519.Point.
 _RistrettoPoint.Fp = /* @__PURE__ */ (() => Fp)();
 _RistrettoPoint.Fn = /* @__PURE__ */ (() => Fn)();
 
-// node_modules/.pnpm/@solana+web3.js@1.98.4_typescript@5.9.3/node_modules/@solana/web3.js/lib/index.esm.js
+// node_modules/.pnpm/@solana+web3.js@1.98.4_bufferutil@4.1.0_typescript@5.9.3_utf-8-validate@6.0.6/node_modules/@solana/web3.js/lib/index.esm.js
 var import_bn = __toESM(require_bn());
 var import_bs58 = __toESM(require_bs58());
 
 // node_modules/.pnpm/@noble+hashes@1.8.0/node_modules/@noble/hashes/esm/sha256.js
 var sha2562 = sha256;
 
-// node_modules/.pnpm/@solana+web3.js@1.98.4_typescript@5.9.3/node_modules/@solana/web3.js/lib/index.esm.js
+// node_modules/.pnpm/@solana+web3.js@1.98.4_bufferutil@4.1.0_typescript@5.9.3_utf-8-validate@6.0.6/node_modules/@solana/web3.js/lib/index.esm.js
 var import_borsh = __toESM(require_lib());
 var BufferLayout = __toESM(require_Layout());
 var import_buffer_layout = __toESM(require_Layout());
@@ -36490,7 +36494,7 @@ var getU64Decoder = (config2 = {}) => numberDecoderFactory({
 });
 var getU64Codec = (config2 = {}) => combineCodec(getU64Encoder(config2), getU64Decoder(config2));
 
-// node_modules/.pnpm/@solana+web3.js@1.98.4_typescript@5.9.3/node_modules/@solana/web3.js/lib/index.esm.js
+// node_modules/.pnpm/@solana+web3.js@1.98.4_bufferutil@4.1.0_typescript@5.9.3_utf-8-validate@6.0.6/node_modules/@solana/web3.js/lib/index.esm.js
 import require$$0 from "util";
 import require$$0$1 from "http";
 import require$$0$2, { Agent } from "https";
@@ -36907,7 +36911,7 @@ function coerce2(struct2, condition, coercer) {
   });
 }
 
-// node_modules/.pnpm/@solana+web3.js@1.98.4_typescript@5.9.3/node_modules/@solana/web3.js/lib/index.esm.js
+// node_modules/.pnpm/@solana+web3.js@1.98.4_bufferutil@4.1.0_typescript@5.9.3_utf-8-validate@6.0.6/node_modules/@solana/web3.js/lib/index.esm.js
 var import_browser = __toESM(require_browser());
 
 // node_modules/.pnpm/node-fetch@2.7.0/node_modules/node-fetch/lib/index.mjs
@@ -39795,7 +39799,7 @@ function sqrtMod(y) {
 var Fpk1 = Field(secp256k1_CURVE.p, { sqrt: sqrtMod });
 var secp256k1 = createCurve({ ...secp256k1_CURVE, Fp: Fpk1, lowS: true, endo: secp256k1_ENDO }, sha256);
 
-// node_modules/.pnpm/@solana+web3.js@1.98.4_typescript@5.9.3/node_modules/@solana/web3.js/lib/index.esm.js
+// node_modules/.pnpm/@solana+web3.js@1.98.4_bufferutil@4.1.0_typescript@5.9.3_utf-8-validate@6.0.6/node_modules/@solana/web3.js/lib/index.esm.js
 var generatePrivateKey = ed25519.utils.randomPrivateKey;
 var generateKeypair = () => {
   const privateScalar = ed25519.utils.randomPrivateKey();
@@ -47863,7 +47867,7 @@ function loadWallet() {
   }
 }
 
-// node_modules/.pnpm/file+..+txtcel-protocol_@solana+web3.js@1.98.4/node_modules/@txtcel/protocol/dist/index.js
+// node_modules/.pnpm/@txtcel+protocol@file+..+txtcel-protocol_@solana+web3.js@1.98.4_bufferutil@4.1.0_typescript@5.9.3_utf-8-validate@6.0.6_/node_modules/@txtcel/protocol/dist/index.js
 var import_zorsh = __toESM(require_src2(), 1);
 import { Buffer as Buffer3 } from "buffer";
 var TAG_CONTENT = 1;
@@ -47879,7 +47883,7 @@ var ACCESS_DENIED = 1;
 var ACCESS_FEE_EXEMPT = 2;
 var KIND_TEXT = 0;
 var CONTENT_SLOTS = 32;
-var EXTEND_THRESHOLD = 16;
+var EXTEND_THRESHOLD = 24;
 var MAX_BODY_LEN = 8192;
 var MAX_TITLE_LEN = 64;
 var INDEX_NONE = 4294967295;
@@ -47961,6 +47965,7 @@ var ThreadNodeSchema = import_zorsh.b.struct({
   author: Pubkey,
   messageFee: import_zorsh.b.u64(),
   likeFee: import_zorsh.b.u64(),
+  lastExtendSlot: import_zorsh.b.u64(),
   title: import_zorsh.b.bytes()
 });
 var ProgramSettingsSchema = import_zorsh.b.struct({
@@ -48033,7 +48038,8 @@ var FillSlotInstr = import_zorsh.b.struct({
 });
 var PrepareAllocInstr = import_zorsh.b.struct({
   tag: import_zorsh.b.u8(),
-  allocSeq: import_zorsh.b.u32()
+  allocSeq: import_zorsh.b.u32(),
+  witnessSlots: import_zorsh.b.vec(import_zorsh.b.u8())
 });
 var InitThreadAccessInstr = import_zorsh.b.struct({
   tag: import_zorsh.b.u8(),
@@ -48043,7 +48049,8 @@ var InitThreadAccessInstr = import_zorsh.b.struct({
 var RequestAccessInstr = import_zorsh.b.struct({
   tag: import_zorsh.b.u8(),
   treasuryShardIdx: import_zorsh.b.u16(),
-  authorFeeShardIdx: import_zorsh.b.u8()
+  authorFeeShardIdx: import_zorsh.b.u8(),
+  maxFee: import_zorsh.b.u64()
 });
 var LikeContentInstr = import_zorsh.b.struct({
   tag: import_zorsh.b.u8(),
@@ -48057,7 +48064,8 @@ var AppendContentInstr = import_zorsh.b.struct({
   tag: import_zorsh.b.u8(),
   chunk: import_zorsh.b.bytes(),
   treasuryShardIdx: import_zorsh.b.u16(),
-  authorFeeShardIdx: import_zorsh.b.u8()
+  authorFeeShardIdx: import_zorsh.b.u8(),
+  maxFee: import_zorsh.b.u64()
 });
 var textDecoder = new TextDecoder();
 function decodeContent(pubkey, data) {
@@ -48389,10 +48397,11 @@ function buildFillSlotInstruction(opts) {
     }))
   });
 }
-function buildPrepareAllocInstruction(programId, payer, seed, allocSeq) {
+function buildPrepareAllocInstruction(programId, payer, seed, allocSeq, witnessSlots = []) {
   const currentAllocPda = deriveAllocPda(programId, seed, allocSeq);
   const newAllocPda = deriveAllocPda(programId, seed, allocSeq + 1);
   const threadAccount = deriveThreadPda(programId, seed);
+  const witnessMetas = witnessSlots.map((slot) => readonlyMeta(deriveContentPda(programId, seed, allocSeq, slot)));
   return new TransactionInstruction({
     programId,
     keys: [
@@ -48400,15 +48409,17 @@ function buildPrepareAllocInstruction(programId, payer, seed, allocSeq) {
       writableMeta(currentAllocPda),
       writableMeta(newAllocPda),
       writableMeta(threadAccount),
-      readonlyMeta(SystemProgram.programId)
+      readonlyMeta(SystemProgram.programId),
+      ...witnessMetas
     ],
     data: Buffer3.from(PrepareAllocInstr.serialize({
       tag: Instruction.PrepareAlloc,
-      allocSeq
+      allocSeq,
+      witnessSlots: new Uint8Array(witnessSlots)
     }))
   });
 }
-function buildAppendContentInstruction(programId, payer, contentAccount, threadAccount, settingsAccount, treasuryShard, authorFeeShard, chunk, treasuryShardIdx, authorFeeShardIdx) {
+function buildAppendContentInstruction(programId, payer, contentAccount, threadAccount, settingsAccount, treasuryShard, authorFeeShard, chunk, treasuryShardIdx, authorFeeShardIdx, maxFee) {
   return new TransactionInstruction({
     programId,
     keys: [
@@ -48424,7 +48435,8 @@ function buildAppendContentInstruction(programId, payer, contentAccount, threadA
       tag: Instruction.AppendContent,
       chunk,
       treasuryShardIdx,
-      authorFeeShardIdx
+      authorFeeShardIdx,
+      maxFee
     }))
   });
 }
@@ -48435,7 +48447,6 @@ var CANDIDATE_SIZE = 4 + 1;
 var ACCOUNT_KEY_SIZE = 32;
 var FILL_SLOT_BASE_ACCOUNTS = 6;
 var FILL_SLOT_ACCESS_ACCOUNTS = 2;
-var PREPARE_ALLOC_MARGINAL_SIZE = 2 * ACCOUNT_KEY_SIZE + 1 + 1 + 5 + 1 + (1 + 4);
 var CONTENT_NODE_FIXED_SIZE = 89;
 var MAX_FEE_SLIPPAGE_NUM = 2n;
 var APPEND_INSTR_ACCOUNTS = 7;
@@ -48479,6 +48490,10 @@ function pageCandidates(programId, seed, allocSeq) {
     slot
   }));
 }
+function pickWitnessSlots(occupiedSlots) {
+  if (occupiedSlots.length < EXTEND_THRESHOLD) return null;
+  return shuffle(occupiedSlots).slice(0, EXTEND_THRESHOLD).sort((a, b2) => a - b2);
+}
 async function buildSendMessageTransactions(connection, programId, payerKey, seed, text, replyTo) {
   const textBytes = ensureTextBytes(text);
   const threadPda = deriveThreadPda(programId, seed);
@@ -48489,10 +48504,9 @@ async function buildSendMessageTransactions(connection, programId, payerKey, see
   const freeInWindow = windowCandidates.filter((_, i) => windowInfos[i] === null);
   const treasuryShardIdx = randomTreasuryShard();
   const authorFeeShardIdx = randomAuthorFeeShard();
-  const extendInline = freeInWindow.length === 0;
-  const selected = extendInline ? pageCandidates(programId, seed, lastAllocSeq + 1).slice(0, DESIRED_CANDIDATES) : shuffle(freeInWindow).slice(0, DESIRED_CANDIDATES);
-  const reserve = extendInline ? PREPARE_ALLOC_MARGINAL_SIZE : 0;
-  const maxFirst = maxFillSlotTextLen(selected.length, reserve);
+  const extendFirst = freeInWindow.length === 0;
+  const selected = extendFirst ? pageCandidates(programId, seed, lastAllocSeq + 1).slice(0, DESIRED_CANDIDATES) : shuffle(freeInWindow).slice(0, DESIRED_CANDIDATES);
+  const maxFirst = maxFillSlotTextLen(selected.length);
   const firstChunkLen = Math.min(textBytes.length, maxFirst);
   const firstChunk = textBytes.subarray(0, firstChunkLen);
   const settings = await loadProgramSettings(connection, programId);
@@ -48515,12 +48529,21 @@ async function buildSendMessageTransactions(connection, programId, payerKey, see
     replyAllocSeq: replyTo?.allocSeq ?? null,
     replySlot: replyTo?.slot ?? null
   });
-  const firstTx = new Transaction();
-  if (extendInline) {
-    firstTx.add(buildPrepareAllocInstruction(programId, payerKey, seed, lastAllocSeq));
+  const transactions = [];
+  if (extendFirst) {
+    const isAuthor = payerKey.toBase58() === thread.author;
+    const occupiedTailSlots = windowCandidates.reduce((acc, candidate, index) => {
+      if (candidate.allocSeq === lastAllocSeq && windowInfos[index] !== null) {
+        acc.push(candidate.slot);
+      }
+      return acc;
+    }, []);
+    const witnessSlots = isAuthor ? [] : pickWitnessSlots(occupiedTailSlots) ?? [];
+    transactions.push(
+      new Transaction().add(buildPrepareAllocInstruction(programId, payerKey, seed, lastAllocSeq, witnessSlots))
+    );
   }
-  firstTx.add(fillSlotIx);
-  const transactions = [firstTx];
+  transactions.push(new Transaction().add(fillSlotIx));
   if (firstChunkLen < textBytes.length) {
     const remaining = textBytes.subarray(firstChunkLen);
     const appendMax = maxAppendChunkLen();
@@ -48528,8 +48551,13 @@ async function buildSendMessageTransactions(connection, programId, payerKey, see
     const settingsPda = deriveSettingsPda(programId);
     const treasuryShardPda = deriveTreasuryShardPda(programId, treasuryShardIdx);
     const authorFeeShardPda = deriveAuthorFeePda(programId, seed, authorFeeShardIdx);
+    const emptyRent = BigInt(await connection.getMinimumBalanceForRentExemption(0, "confirmed"));
+    const oneByteRent = BigInt(await connection.getMinimumBalanceForRentExemption(1, "confirmed"));
+    const rentPerByte = oneByteRent - emptyRent;
     for (let offset2 = 0; offset2 < remaining.length; offset2 += appendMax) {
       const chunk = remaining.subarray(offset2, offset2 + appendMax);
+      const appendBaseFee = BigInt(chunk.length) * rentPerByte * baseFeeBps / 10000n;
+      const appendMaxFee = appendBaseFee * MAX_FEE_SLIPPAGE_NUM + 1n;
       const appendIx = buildAppendContentInstruction(
         programId,
         payerKey,
@@ -48540,7 +48568,8 @@ async function buildSendMessageTransactions(connection, programId, payerKey, see
         authorFeeShardPda,
         chunk,
         treasuryShardIdx,
-        authorFeeShardIdx
+        authorFeeShardIdx,
+        appendMaxFee
       );
       transactions.push(new Transaction().add(appendIx));
     }
@@ -48553,10 +48582,18 @@ async function buildExtendAllocTransaction(connection, programId, payerKey, seed
   const lastAllocSeq = thread.lastAllocSeq;
   const tailCandidates = pageCandidates(programId, seed, lastAllocSeq);
   const tailInfos = await connection.getMultipleAccountsInfo(tailCandidates.map((c) => c.pda));
-  const freeOnPageN = tailInfos.filter((info) => info === null).length;
-  const filled = CONTENT_SLOTS - freeOnPageN;
-  if (filled < EXTEND_THRESHOLD) return null;
-  return new Transaction().add(buildPrepareAllocInstruction(programId, payerKey, seed, lastAllocSeq));
+  const occupiedTailSlots = tailCandidates.reduce((acc, candidate, index) => {
+    if (tailInfos[index] !== null) {
+      acc.push(candidate.slot);
+    }
+    return acc;
+  }, []);
+  const witnessSlots = pickWitnessSlots(occupiedTailSlots);
+  if (witnessSlots === null) return null;
+  const isAuthor = payerKey.toBase58() === thread.author;
+  return new Transaction().add(
+    buildPrepareAllocInstruction(programId, payerKey, seed, lastAllocSeq, isAuthor ? [] : witnessSlots)
+  );
 }
 function buildCreateRootAllocInstruction(programId, payer, seed, messageFee = 0n, title = "") {
   const titleBytes = new TextEncoder().encode(title);
@@ -48605,16 +48642,13 @@ async function createRootAlloc(connection, programId, payer, messageFee = 0n, ti
   };
 }
 function buildCloseAccountInstruction(programId, payer, targetAccount, likesAccount) {
-  const keys = [
-    signerMeta(payer),
-    writableMeta(targetAccount)
-  ];
-  if (likesAccount) {
-    keys.push(writableMeta(likesAccount));
-  }
   return new TransactionInstruction({
     programId,
-    keys,
+    keys: [
+      signerMeta(payer),
+      writableMeta(targetAccount),
+      writableMeta(likesAccount)
+    ],
     data: Buffer3.from(TagOnlyInstr.serialize({ tag: Instruction.CloseAccount }))
   });
 }
@@ -48683,7 +48717,7 @@ function buildSetThreadAccessInstruction(programId, authority, accessAccount, en
     }))
   });
 }
-function buildRequestAccessInstruction(programId, payer, seed) {
+function buildRequestAccessInstruction(programId, payer, seed, maxFee) {
   const accessAccount = deriveAccessPda(programId, seed);
   const entryAccount = deriveAccessEntryPda(programId, seed, payer);
   const threadAccount = deriveThreadPda(programId, seed);
@@ -48707,7 +48741,8 @@ function buildRequestAccessInstruction(programId, payer, seed) {
     data: Buffer3.from(RequestAccessInstr.serialize({
       tag: Instruction.RequestAccess,
       treasuryShardIdx,
-      authorFeeShardIdx
+      authorFeeShardIdx,
+      maxFee
     }))
   });
 }
@@ -49076,15 +49111,17 @@ function registerMessagingTools(server) {
         channel: channelArg,
         allocSeq: external_exports.number().int().describe("allocSeq of the target message."),
         slot: external_exports.number().int().describe("slot of the target message."),
-        text: external_exports.string().min(1).describe("Text chunk to append.")
+        text: external_exports.string().min(1).describe("Text chunk to append."),
+        maxFee: external_exports.union([external_exports.number(), external_exports.string()]).optional().describe("Max base fee in lamports willing to pay for the append (slippage cap). Default 100000000 (0.1 SOL).")
       }
     },
-    handler(async ({ channel, allocSeq, slot, text }) => {
+    handler(async ({ channel, allocSeq, slot, text, maxFee }) => {
       const { programId } = loadConfig();
       const payer = loadWallet();
       const seed = resolveSeed(channel);
       const treasuryShardIdx = randomTreasuryShard();
       const authorFeeShardIdx = randomAuthorFeeShard();
+      const cap = maxFee === void 0 ? 100000000n : toLamports(maxFee);
       const ix = buildAppendContentInstruction(
         programId,
         payer.publicKey,
@@ -49095,7 +49132,8 @@ function registerMessagingTools(server) {
         deriveAuthorFeePda(programId, seed, authorFeeShardIdx),
         new TextEncoder().encode(text),
         treasuryShardIdx,
-        authorFeeShardIdx
+        authorFeeShardIdx,
+        cap
       );
       const signature = await sendInstructions(payer, [ix]);
       return jsonResult({ signature, explorer: explorerTx(signature) });
@@ -49105,17 +49143,37 @@ function registerMessagingTools(server) {
     "prepare_alloc",
     {
       title: "Prepare alloc",
-      description: "Manually pre-create the next alloc page (allocSeq + 1) in a channel so there are free slots ahead of demand. send_message already does this best-effort; use this to force-extend a high-traffic channel. Racy by design: it fails with InvalidAllocSeq if the chain tail moved on.",
+      description: "Manually pre-create the next alloc page (allocSeq + 1) in a channel. Extension is occupancy-gated on-chain: unless the agent wallet is the channel author (or the last extension is older than the time hatch), the tail page must hold at least EXTEND_THRESHOLD messages \u2014 this tool gathers the witness proof automatically and fails with an explanation when occupancy is too low. Racy by design: it fails with InvalidAllocSeq if the chain tail moved on.",
       inputSchema: {
         channel: channelArg,
         allocSeq: external_exports.number().int().describe("Current alloc seq to extend from.")
       }
     },
     handler(async ({ channel, allocSeq }) => {
-      const { programId } = loadConfig();
+      const { connection, programId } = loadConfig();
       const payer = loadWallet();
       const seed = resolveSeed(channel);
-      const ix = buildPrepareAllocInstruction(programId, payer.publicKey, seed, allocSeq);
+      const thread = await loadThreadNode(connection, programId, deriveThreadPda(programId, seed));
+      const isAuthor = payer.publicKey.toBase58() === thread.author;
+      let witnessSlots = [];
+      if (!isAuthor) {
+        const pdas = Array.from({ length: CONTENT_SLOTS }, (_, slot) => deriveContentPda(programId, seed, allocSeq, slot));
+        const infos = await connection.getMultipleAccountsInfo(pdas);
+        const occupied = infos.reduce((acc, info, slot) => {
+          if (info !== null) acc.push(slot);
+          return acc;
+        }, []);
+        if (occupied.length < EXTEND_THRESHOLD) {
+          return jsonResult({
+            error: "occupancy below extend threshold",
+            occupied: occupied.length,
+            required: EXTEND_THRESHOLD,
+            hint: "Only the channel author (or the daily time hatch) can extend a page this empty."
+          });
+        }
+        witnessSlots = occupied.slice(0, EXTEND_THRESHOLD);
+      }
+      const ix = buildPrepareAllocInstruction(programId, payer.publicKey, seed, allocSeq, witnessSlots);
       const signature = await sendInstructions(payer, [ix]);
       return jsonResult({ signature, explorer: explorerTx(signature) });
     })
@@ -49171,14 +49229,18 @@ function registerMessagingTools(server) {
     "request_access",
     {
       title: "Request channel access",
-      description: "Pay the entry fee to join a gated channel so the agent wallet can post in it.",
-      inputSchema: { channel: channelArg }
+      description: "Pay the entry fee to join a gated channel so the agent wallet can post in it. The current on-chain entry fee is used as the slippage cap unless maxFee is given.",
+      inputSchema: {
+        channel: channelArg,
+        maxFee: external_exports.union([external_exports.number(), external_exports.string()]).optional().describe("Max entry fee in lamports willing to pay (slippage cap). Defaults to the current on-chain entry fee.")
+      }
     },
-    handler(async ({ channel }) => {
-      const { programId } = loadConfig();
+    handler(async ({ channel, maxFee }) => {
+      const { connection, programId } = loadConfig();
       const payer = loadWallet();
       const seed = resolveSeed(channel);
-      const ix = buildRequestAccessInstruction(programId, payer.publicKey, seed);
+      const cap = maxFee === void 0 ? (await loadThreadAccess(connection, programId, deriveAccessPda(programId, seed))).entryFee : toLamports(maxFee);
+      const ix = buildRequestAccessInstruction(programId, payer.publicKey, seed, cap);
       const signature = await sendInstructions(payer, [ix]);
       return jsonResult({ signature, explorer: explorerTx(signature) });
     })