expect(directContextParams?.sessionCtx?.Provider).toBe("telegram");

expect(directContextParams?.sessionCtx?.ChatType).toBe("direct");

expect(directContextParams?.sourceReplyDeliveryMode).toBe("message_tool_only");

expect(buildInboundUserContextPrefix).toHaveBeenCalledWith(

expect.objectContaining({

ChatType: "direct",

OriginatingChannel: "telegram",

OriginatingTo: "telegram-direct-test-id",

}),

expect.anything(),

{ sourceReplyDeliveryMode: "message_tool_only" },

);

});

it.each(["direct", "dm"] as const)(

}

: { ...sessionCtx, ThreadStarterBody: undefined },

envelopeOptions,

{ sourceReplyDeliveryMode: opts?.sourceReplyDeliveryMode },

);

const inboundUserContextPromptJoiner = resolveInboundUserContextPromptJoiner(sessionCtx);

const hasUserBody =

expect(conversationInfo["conversation_label"]).toBeUndefined();

});

it("adds delivery guidance beside inbound source context for message-tool-only turns", () => {

const text = buildInboundUserContextPrefix(

{

ChatType: "direct",

OriginatingChannel: "telegram",

OriginatingTo: "telegram:849985193",

MessageSid: "776",

SenderName: "Nik",

} as TemplateContext,

undefined,

{ sourceReplyDeliveryMode: "message_tool_only" },

);

expect(text).toContain("Delivery: to send a message, use the `message` tool.");

expect(text.indexOf("Delivery:")).toBeLessThan(text.indexOf("Conversation info"));

expect(text).toContain("Conversation info (untrusted metadata):");

});

it("does not add delivery guidance for automatic source delivery", () => {

const text = buildInboundUserContextPrefix(

{

ChatType: "direct",

OriginatingChannel: "telegram",

OriginatingTo: "telegram:849985193",

MessageSid: "776",

} as TemplateContext,

undefined,

{ sourceReplyDeliveryMode: "automatic" },

);

expect(text).not.toContain("Delivery: to send a message");

expect(text).toContain("Conversation info (untrusted metadata):");

});

it("includes message identifiers for direct chats when channel is inferred from Provider", () => {

const text = buildInboundUserContextPrefix({

ChatType: "direct",

import { truncateUtf16Safe } from "../../utils.js";

import type { EnvelopeFormatOptions } from "../envelope.js";

import { formatEnvelopeTimestamp } from "../envelope.js";

import type { SourceReplyDeliveryMode } from "../get-reply-options.types.js";

import type { TemplateContext } from "../templating.js";

const MAX_UNTRUSTED_JSON_STRING_CHARS = 2_000;

const MAX_UNTRUSTED_HISTORY_ENTRIES = 20;

const MAX_UNTRUSTED_TRANSCRIPT_FIELD_CHARS = 500;

const MESSAGE_TOOL_DELIVERY_HINT = "Delivery: to send a message, use the `message` tool.";

type InboundUserContextPrefixOptions = {

sourceReplyDeliveryMode?: SourceReplyDeliveryMode;

};

function stripNullBytes(value: string): string {

return value.replaceAll("\u0000", "");

export function buildInboundUserContextPrefix(

ctx: TemplateContext,

envelope?: EnvelopeFormatOptions,

options?: InboundUserContextPrefixOptions,

): string {

const blocks: string[] = [];

if (options?.sourceReplyDeliveryMode === "message_tool_only") {

blocks.push(MESSAGE_TOOL_DELIVERY_HINT);

}

const chatType = normalizeChatType(ctx.ChatType);

const isDirect = !chatType || chatType === "direct";

const directChannelValue = resolveInboundChannel(ctx);