letagents 0.12.32 → 0.12.33

package/dist/mcp/server/tools/tasks/board-intent-tools.js

@@ -260,7 +260,7 @@ export function registerBoardIntentTools(server) {
         }
     });
     server.tool("list_board_intents", "List Board Manager intents for this room, optionally filtered by status.", {
-        status: z.enum(["pending", "approved", "denied", "expired", "used"]).optional(),
+        status: z.enum(["pending", "approved", "denied", "expired", "used", "superseded"]).optional(),
         room_id: z.string().optional().describe("Canonical room ID. Defaults to current room."),
     }, async ({ status, room_id }) => {
         const targetRoomId = resolveCanonicalRoomId(room_id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "letagents",
-  "version": "0.12.32",
+  "version": "0.12.33",
   "description": "Let Agents Chat \u2014 MCP server for AI agent communication",
   "type": "module",
   "main": "dist/mcp/server.js",

package/shared/room-knowledge.d.mts

@@ -22,4 +22,6 @@ export function createKnowledgeRecord(room_id: string, type: KnowledgeType, inpu
 export function reviseKnowledgeRecord(record: KnowledgeRecord, input: KnowledgeRevisionInput, actor: KnowledgeActor, now?: string): KnowledgeRecord;
 export function assertKnowledgeReplay(existing: KnowledgeRecord, candidate: KnowledgeRecord): void;
 
+export function attentionResponseHandle(agentKey: string | null | undefined): string;
 export function formatAttentionResponse(record: KnowledgeRecord): string;
+export function attentionResponseDisplayText(text: string, agentName: (handle: string) => string | null | undefined): string | null;

package/shared/room-knowledge.mjs

@@ -68,7 +68,38 @@ export function assertKnowledgeReplay(existing, candidate) {
   }
 }
 
+/** The `@agent:` handle an answer uses to wake the agent that asked. */
+export function attentionResponseHandle(agentKey) {
+  return String(agentKey ?? '').trim().replace(/[A-Z]/g, c => c.toLowerCase()).replace(/[^a-z0-9_.:/-]+/g, '');
+}
+
 export function formatAttentionResponse(record) {
-  const handle = record.author.kind === 'agent' ? record.author.id.trim().replace(/[A-Z]/g, c => c.toLowerCase()).replace(/[^a-z0-9_.:/-]+/g, '') : '';
+  const handle = record.author.kind === 'agent' ? attentionResponseHandle(record.author.id) : '';
   return `${handle ? `@agent:${handle}\n\n` : ''}Human response (${record.id}):\n\n${record.response.body}`;
 }
+
+const ATTENTION_RESPONSE_TEXT = /^(?:@agent:([a-z0-9_.:/-]+)\n\n)?Human response \([a-zA-Z0-9_-]{8,80}\):\n\n([\s\S]+)$/;
+// A room display name used as a mention: never markdown, never spaces, and
+// no underscore that could open emphasis (leading, or doubled anywhere).
+const MENTION_NAME = /^(?!_)(?!.*__)[A-Za-z0-9._:-]{1,64}$/;
+// Answers that open with a block (fence, list, heading, quote, table, rule or
+// indented code) keep it as a block instead of joining the mention's line.
+const OPENS_WITH_BLOCK = /^(?: {4}|\t| {0,3}(?:`{3}|~{3}|[-*+](?:\s|$)|\d{1,9}[.)](?:\s|$)|#{1,6}(?:\s|$)|>|\||(?:[-*_] *){3,}$))/;
+
+/**
+ * What people see for a message formatAttentionResponse wrote. The handle and
+ * request id route the answer to the agent that asked; the room reads it as a
+ * reply to that agent by name, or to a neutral @agent when the room no longer
+ * lists it (the visible mention is the record of who was woken). Null for any
+ * other text.
+ */
+export function attentionResponseDisplayText(text, agentName) {
+  const match = ATTENTION_RESPONSE_TEXT.exec(typeof text === 'string' ? text : '');
+  if (!match) return null;
+  const answer = match[2];
+  if (!match[1]) return answer;
+  const name = String(agentName(match[1]) ?? '').trim();
+  const mention = `@${MENTION_NAME.test(name) ? name : 'agent'}`;
+  // trimEnd: a CRLF line keeps its \r, and trailing space must not hide a rule.
+  return OPENS_WITH_BLOCK.test(answer.split('\n', 1)[0].trimEnd()) ? `${mention}\n\n${answer}` : `${mention} ${answer}`;
+}

package/shared/room-turn-no-reply.d.mts

@@ -0,0 +1,7 @@
+export const NO_REPLY_FAILURE: Readonly<{
+  outputLimit: "The model hit its output limit before writing a reply.";
+  emptyAnswer: "The model finished without writing a reply.";
+  contentFilter: "The model provider's content filter stopped the reply before any text was written.";
+}>;
+export type NoReplyFailureKind = keyof typeof NO_REPLY_FAILURE;
+export function noReplyFailureKind(detail: unknown): NoReplyFailureKind | null;

package/shared/room-turn-no-reply.mjs

@@ -0,0 +1,15 @@
+/**
+ * Why a completed provider turn ended without a room reply. The Open Model
+ * adapter reports these as the exact failure detail, and task continuity
+ * reads them back to decide whether a follow-up turn can help.
+ */
+export const NO_REPLY_FAILURE = Object.freeze({
+  outputLimit: "The model hit its output limit before writing a reply.",
+  emptyAnswer: "The model finished without writing a reply.",
+  contentFilter: "The model provider's content filter stopped the reply before any text was written.",
+});
+
+export function noReplyFailureKind(detail) {
+  const text = typeof detail === "string" ? detail.trim() : "";
+  return Object.keys(NO_REPLY_FAILURE).find((kind) => NO_REPLY_FAILURE[kind] === text) ?? null;
+}