@botiverse/raft-sdk 0.3.1 → 0.3.2

package/dist/cjs/index.cjs

@@ -11102,6 +11102,43 @@ function sortBySeq(messages) {
 function projectRaftMessages(envelopes) {
 	return envelopes.map(projectRaftMessage).filter((m) => m !== null);
 }
+/** The conversation fields a target string names; `null` for a shape this cannot read. */
+function identityFromTarget(target) {
+	const dm = /^dm:@([^:\s]+)(?::([^:\s]+))?$/.exec(target);
+	if (dm) return dm[2] ? {
+		channel_type: "thread",
+		channel_name: dm[2],
+		parent_channel_name: dm[1],
+		parent_channel_type: "dm"
+	} : {
+		channel_type: "dm",
+		channel_name: dm[1]
+	};
+	const channel = /^#([^:\s]+)(?::([^:\s]+))?$/.exec(target);
+	if (channel) return channel[2] ? {
+		channel_type: "thread",
+		channel_name: channel[2],
+		parent_channel_name: channel[1],
+		parent_channel_type: "channel"
+	} : {
+		channel_type: "channel",
+		channel_name: channel[1]
+	};
+	return null;
+}
+/**
+* Project envelopes that all belong to one known conversation. Some Server
+* responses (held previews) send envelopes without conversation fields
+* because the request already named the target; fill them from `target`
+* instead of dropping the message.
+*/
+function projectRaftMessagesInTarget(envelopes, target) {
+	const identity = identityFromTarget(target);
+	return envelopes.map((envelope) => projectRaftMessage(identity && !hasAgentMessageIdentity(envelope) ? {
+		...envelope,
+		...identity
+	} : envelope)).filter((m) => m !== null);
+}
 //#endregion
 //#region ../shared/src/agentOps/frontier.ts
 const MAX_EXACT_SEQS = 2500;
@@ -11157,10 +11194,11 @@ var SeenFrontier = class SeenFrontier {
 	* Attest that the model saw the context a held send/claim returned. Call it
 	* only after the held messages actually reached the model (the SDK cannot
 	* know that, so it never records this implicitly). Returns false and records
-	* nothing when the context was withheld or the Server sent no boundary.
+	* nothing when the context was withheld, not fully shown
+	* (`contextComplete: false`), or the Server sent no boundary.
 	*/
 	recordHeld(held) {
-		if (held.withheld || held.seenUpToSeq === null) return false;
+		if (held.withheld || held.contextComplete === false || held.seenUpToSeq === null) return false;
 		this.recordUpTo(held.target, held.seenUpToSeq);
 		return true;
 	}
@@ -11557,6 +11595,7 @@ function heldText(held, action) {
 	if (held.formalMentionCount > 0) lines.push(`Note: ${held.formalMentionCount} of these messages formally @mention you.`);
 	if (held.omittedMessageCount > 0) lines.push(`${held.omittedMessageCount} earlier ${held.omittedMessageCount === 1 ? "message" : "messages"} not shown.`);
 	if (held.heldMessages.length > 0) lines.push(formatAgentMessages(held.heldMessages.map((m) => toAgentMessageLike(m.raw))));
+	if (!held.contextComplete) lines.push("Not all of them are shown here; read the conversation before sending again.");
 	lines.push(`Full text: raft message read --target "${held.target}"`);
 	return lines.join("\n");
 }
@@ -11568,26 +11607,30 @@ function heldNext(held) {
 			target: held.target,
 			...held.continuation
 		},
-		why: held.withheld ? "Newer messages exist in this conversation but were withheld; read them, then send again with the same idempotencyKey." : "Newer messages arrived in this conversation. Show the held messages to the model, call frontier.recordHeld(held) to attest that, then send again with these args (same idempotencyKey, seen.upToSeq)."
+		why: held.withheld ? "Newer messages exist in this conversation but were withheld; read them, then send again with the same idempotencyKey." : !held.contextComplete ? "Newer messages arrived in this conversation and not all of them are shown here; read the conversation, then send again with the same idempotencyKey." : "Newer messages arrived in this conversation. Show the held messages to the model, call frontier.recordHeld(held) to attest that, then send again with these args (same idempotencyKey, seen.upToSeq)."
 	};
 }
 function projectHeld(target, data, idempotencyKey) {
 	const withheld = data.freshnessContextMode === "withheld";
-	const heldMessages = projectRaftMessages(data.heldMessages ?? []);
+	const heldMessages = projectRaftMessagesInTarget(data.heldMessages ?? [], target);
 	const seenUpToSeq = typeof data.seenUpToSeq === "number" ? data.seenUpToSeq : null;
+	const newMessageCount = withheld ? data.withheldMessageCount ?? 0 : data.newMessageCount ?? heldMessages.length;
+	const omittedMessageCount = data.omittedMessageCount ?? 0;
+	const contextComplete = !withheld && heldMessages.length + omittedMessageCount >= newMessageCount;
 	return {
 		target,
 		idempotencyKey,
 		continuation: {
 			idempotencyKey,
-			...!withheld && seenUpToSeq !== null ? { seen: { upToSeq: seenUpToSeq } } : {}
+			...contextComplete && seenUpToSeq !== null ? { seen: { upToSeq: seenUpToSeq } } : {}
 		},
-		newMessageCount: withheld ? data.withheldMessageCount ?? 0 : data.newMessageCount ?? heldMessages.length,
+		newMessageCount,
 		heldMessages,
-		omittedMessageCount: data.omittedMessageCount ?? 0,
+		omittedMessageCount,
 		formalMentionCount: data.mentionAnnotation?.formalMentionCount ?? 0,
 		seenUpToSeq,
-		withheld
+		withheld,
+		contextComplete
 	};
 }
 function isHeldResponse(data) {
@@ -11644,9 +11687,10 @@ async function sendMessage(client, request, frontier, internal = {}) {
 			...request,
 			idempotencyKey
 		};
+		const base = projectHeld(request.target, data, idempotencyKey);
 		const held = {
-			...projectHeld(request.target, data, idempotencyKey),
-			resend: (options) => sendMessage(client, options.seen === "held" && typeof data.seenUpToSeq === "number" ? {
+			...base,
+			resend: (options) => sendMessage(client, options.seen === "held" && base.contextComplete && typeof data.seenUpToSeq === "number" ? {
 				...keyed,
 				seen: {
 					upToSeq: data.seenUpToSeq,

package/dist/esm/index.js

@@ -11101,6 +11101,43 @@ function sortBySeq(messages) {
 function projectRaftMessages(envelopes) {
 	return envelopes.map(projectRaftMessage).filter((m) => m !== null);
 }
+/** The conversation fields a target string names; `null` for a shape this cannot read. */
+function identityFromTarget(target) {
+	const dm = /^dm:@([^:\s]+)(?::([^:\s]+))?$/.exec(target);
+	if (dm) return dm[2] ? {
+		channel_type: "thread",
+		channel_name: dm[2],
+		parent_channel_name: dm[1],
+		parent_channel_type: "dm"
+	} : {
+		channel_type: "dm",
+		channel_name: dm[1]
+	};
+	const channel = /^#([^:\s]+)(?::([^:\s]+))?$/.exec(target);
+	if (channel) return channel[2] ? {
+		channel_type: "thread",
+		channel_name: channel[2],
+		parent_channel_name: channel[1],
+		parent_channel_type: "channel"
+	} : {
+		channel_type: "channel",
+		channel_name: channel[1]
+	};
+	return null;
+}
+/**
+* Project envelopes that all belong to one known conversation. Some Server
+* responses (held previews) send envelopes without conversation fields
+* because the request already named the target; fill them from `target`
+* instead of dropping the message.
+*/
+function projectRaftMessagesInTarget(envelopes, target) {
+	const identity = identityFromTarget(target);
+	return envelopes.map((envelope) => projectRaftMessage(identity && !hasAgentMessageIdentity(envelope) ? {
+		...envelope,
+		...identity
+	} : envelope)).filter((m) => m !== null);
+}
 //#endregion
 //#region ../shared/src/agentOps/frontier.ts
 const MAX_EXACT_SEQS = 2500;
@@ -11156,10 +11193,11 @@ var SeenFrontier = class SeenFrontier {
 	* Attest that the model saw the context a held send/claim returned. Call it
 	* only after the held messages actually reached the model (the SDK cannot
 	* know that, so it never records this implicitly). Returns false and records
-	* nothing when the context was withheld or the Server sent no boundary.
+	* nothing when the context was withheld, not fully shown
+	* (`contextComplete: false`), or the Server sent no boundary.
 	*/
 	recordHeld(held) {
-		if (held.withheld || held.seenUpToSeq === null) return false;
+		if (held.withheld || held.contextComplete === false || held.seenUpToSeq === null) return false;
 		this.recordUpTo(held.target, held.seenUpToSeq);
 		return true;
 	}
@@ -11556,6 +11594,7 @@ function heldText(held, action) {
 	if (held.formalMentionCount > 0) lines.push(`Note: ${held.formalMentionCount} of these messages formally @mention you.`);
 	if (held.omittedMessageCount > 0) lines.push(`${held.omittedMessageCount} earlier ${held.omittedMessageCount === 1 ? "message" : "messages"} not shown.`);
 	if (held.heldMessages.length > 0) lines.push(formatAgentMessages(held.heldMessages.map((m) => toAgentMessageLike(m.raw))));
+	if (!held.contextComplete) lines.push("Not all of them are shown here; read the conversation before sending again.");
 	lines.push(`Full text: raft message read --target "${held.target}"`);
 	return lines.join("\n");
 }
@@ -11567,26 +11606,30 @@ function heldNext(held) {
 			target: held.target,
 			...held.continuation
 		},
-		why: held.withheld ? "Newer messages exist in this conversation but were withheld; read them, then send again with the same idempotencyKey." : "Newer messages arrived in this conversation. Show the held messages to the model, call frontier.recordHeld(held) to attest that, then send again with these args (same idempotencyKey, seen.upToSeq)."
+		why: held.withheld ? "Newer messages exist in this conversation but were withheld; read them, then send again with the same idempotencyKey." : !held.contextComplete ? "Newer messages arrived in this conversation and not all of them are shown here; read the conversation, then send again with the same idempotencyKey." : "Newer messages arrived in this conversation. Show the held messages to the model, call frontier.recordHeld(held) to attest that, then send again with these args (same idempotencyKey, seen.upToSeq)."
 	};
 }
 function projectHeld(target, data, idempotencyKey) {
 	const withheld = data.freshnessContextMode === "withheld";
-	const heldMessages = projectRaftMessages(data.heldMessages ?? []);
+	const heldMessages = projectRaftMessagesInTarget(data.heldMessages ?? [], target);
 	const seenUpToSeq = typeof data.seenUpToSeq === "number" ? data.seenUpToSeq : null;
+	const newMessageCount = withheld ? data.withheldMessageCount ?? 0 : data.newMessageCount ?? heldMessages.length;
+	const omittedMessageCount = data.omittedMessageCount ?? 0;
+	const contextComplete = !withheld && heldMessages.length + omittedMessageCount >= newMessageCount;
 	return {
 		target,
 		idempotencyKey,
 		continuation: {
 			idempotencyKey,
-			...!withheld && seenUpToSeq !== null ? { seen: { upToSeq: seenUpToSeq } } : {}
+			...contextComplete && seenUpToSeq !== null ? { seen: { upToSeq: seenUpToSeq } } : {}
 		},
-		newMessageCount: withheld ? data.withheldMessageCount ?? 0 : data.newMessageCount ?? heldMessages.length,
+		newMessageCount,
 		heldMessages,
-		omittedMessageCount: data.omittedMessageCount ?? 0,
+		omittedMessageCount,
 		formalMentionCount: data.mentionAnnotation?.formalMentionCount ?? 0,
 		seenUpToSeq,
-		withheld
+		withheld,
+		contextComplete
 	};
 }
 function isHeldResponse(data) {
@@ -11643,9 +11686,10 @@ async function sendMessage(client, request, frontier, internal = {}) {
 			...request,
 			idempotencyKey
 		};
+		const base = projectHeld(request.target, data, idempotencyKey);
 		const held = {
-			...projectHeld(request.target, data, idempotencyKey),
-			resend: (options) => sendMessage(client, options.seen === "held" && typeof data.seenUpToSeq === "number" ? {
+			...base,
+			resend: (options) => sendMessage(client, options.seen === "held" && base.contextComplete && typeof data.seenUpToSeq === "number" ? {
 				...keyed,
 				seen: {
 					upToSeq: data.seenUpToSeq,

package/dist/index.d.ts

@@ -457,12 +457,14 @@ export declare class SeenFrontier {
    * Attest that the model saw the context a held send/claim returned. Call it
    * only after the held messages actually reached the model (the SDK cannot
    * know that, so it never records this implicitly). Returns false and records
-   * nothing when the context was withheld or the Server sent no boundary.
+   * nothing when the context was withheld, not fully shown
+   * (`contextComplete: false`), or the Server sent no boundary.
    */
   recordHeld(held: {
     target: string;
     seenUpToSeq: number | null;
     withheld: boolean;
+    contextComplete?: boolean;
   }): boolean;
   /** What to attest on a send or claim to `target`; omits `seenUpToSeq` when nothing contiguous is known. */
   attestation(target: string): SeenAttestation;
@@ -625,6 +627,13 @@ interface RaftHeldBase {
   seenUpToSeq: number | null;
   /** Reviewer isolation: bodies withheld, only a count. */
   withheld: boolean;
+  /**
+   * Whether `heldMessages` plus `omittedMessageCount` account for every one of
+   * `newMessageCount`. When false the model cannot have seen all of them, so
+   * no `seen` is offered and `frontier.recordHeld` records nothing; read the
+   * conversation instead.
+   */
+  contextComplete: boolean;
 }
 interface RaftHeld extends RaftHeldBase {
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botiverse/raft-sdk",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "license": "FSL-1.1-ALv2",
   "description": "Typed Raft Agent API client for external agents and bots.",
   "type": "module",