crewly 1.20.225 → 1.20.227

package/dist/cli/backend/src/services/messaging/queue-priority.d.ts

@@ -0,0 +1,127 @@
+/**
+ * What an agent's message queue needs to know about a message beyond its
+ * text: whether the owner wrote it (it goes ahead of system traffic), which
+ * conversation and thread it belongs to (for a colleague's message or a
+ * reminder, a reply there after it was queued means it was answered — never
+ * for the owner's own message), the owner message it carries (so a second
+ * copy is recognised), and which earlier reminder it replaces.
+ *
+ * Callers that know this (the chat dispatcher for an owner's message, the
+ * decision service for an owner's answer, the owner-message watchdog for its
+ * reminder, the open-items service for a "promised work is ready" reminder)
+ * run their delivery inside {@link withQueueMeta}. If the agent is busy and
+ * the delivery path queues the message, {@link SubAgentMessageQueue.enqueue}
+ * picks the meta up from the async context — no delivery signature changes.
+ *
+ * Case that motivated it (2026-10-05, #education, D-270): the owner's answer
+ * to Atlas's decision card was queued at position 7 behind stale reminders,
+ * handed over one per idle moment oldest-first, and reached Atlas after
+ * ~18 minutes; a duplicate of an owner message Atlas had already answered sat
+ * in front of it.
+ *
+ * @module services/messaging/queue-priority
+ */
+/** Where a queued message's answer belongs. */
+export interface QueueConversation {
+    /** chat-v2 channel the message was recorded in */
+    chatChannelId?: string;
+    /** chat-v2 thread the answer belongs in (huddles) */
+    chatThreadId?: string;
+    /** Slack channel / DM */
+    slackChannelId?: string;
+    /** Slack thread root */
+    threadTs?: string;
+}
+/** Metadata stored with a queued message. */
+export interface QueueMessageMeta {
+    /** The owner wrote it (or it carries the owner's words / answer): goes ahead of everything else */
+    owner?: boolean;
+    /** Identity of the owner message it carries (`slack:<ch>:<ts>`, `chat:<ch>:<id>`, `decision:<id>`); a later queued copy is a duplicate */
+    ref?: string;
+    /** Conversation (and thread) the answer belongs in */
+    where?: QueueConversation;
+    /** A newer queued message with the same key replaces an older one (a reminder about the same promise) */
+    supersedeKey?: string;
+    /**
+     * A harness reminder that carries the owner's words (the watchdog's nudge):
+     * owner priority, but — unlike the owner's own message — dropped once the
+     * agent has answered in its thread.
+     */
+    reminder?: boolean;
+}
+/**
+ * Run a delivery with queue metadata for one message to one agent. If the
+ * delivery queues that message for that agent, the queued copy carries the
+ * metadata.
+ *
+ * @param session - The agent the delivery is for
+ * @param data - The exact text being delivered
+ * @param meta - The metadata
+ * @param fn - The delivery
+ * @returns What `fn` returns
+ */
+export declare function withQueueMeta<T>(session: string, data: string, meta: QueueMessageMeta, fn: () => T): T;
+/**
+ * The metadata of the delivery running now, if it is this message for this agent.
+ *
+ * @param session - The agent a message is being queued for
+ * @param data - The message being queued
+ * @returns The metadata, or undefined
+ */
+export declare function currentQueueMeta(session: string, data: string): QueueMessageMeta | undefined;
+/**
+ * The agents' recent posts, by agent. Fed by the chat-v2 turn stream and the
+ * `reply` endpoint; read by the queue when it flushes.
+ */
+export declare class AgentPostLog {
+    private static instance;
+    private readonly posts;
+    /** @returns The process-wide log */
+    static getInstance(): AgentPostLog;
+    /** Reset (tests). */
+    static resetInstance(): void;
+    /**
+     * Record that an agent posted (a real answer, not an interim "working on it").
+     *
+     * @param session - The agent
+     * @param where - Where it posted
+     * @param at - When (default now)
+     */
+    note(session: string, where: QueueConversation, at?: number): void;
+    /**
+     * Whether the agent posted in a conversation (and thread) after a moment.
+     *
+     * Matched by thread only (see {@link sameConversation}).
+     *
+     * @param session - The agent
+     * @param where - The queued message's conversation
+     * @param since - When it was queued
+     * @returns True when the agent spoke there after `since`
+     */
+    postedSince(session: string, where: QueueConversation, since: number): boolean;
+}
+/**
+ * Whether a post landed in the conversation (and thread) a queued message belongs to.
+ *
+ * @param post - Where the agent posted
+ * @param queued - Where the queued message's answer belongs
+ * @returns True on a match
+ */
+export declare function sameConversation(post: QueueConversation, queued: QueueConversation): boolean;
+/**
+ * Feed a recorded chat-v2 turn to the post log: an agent's real answer (not
+ * an interim "working on it") in a conversation, and the Slack thread it
+ * mirrors to when the turn says so.
+ *
+ * @param dto - The turn (sender, channel, thread, metadata)
+ * @param log - The post log (default: the process-wide one)
+ */
+export declare function noteAgentChatTurn(dto: {
+    senderType: string;
+    senderId: string;
+    channelId: string;
+    threadId?: string | null;
+    createdAt?: number;
+    metadata?: Record<string, unknown>;
+}, log?: AgentPostLog): void;
+//# sourceMappingURL=queue-priority.d.ts.map

package/dist/cli/backend/src/services/messaging/queue-priority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-priority.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/queue-priority.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IACjC,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAChC,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0IAA0I;IAC1I,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,yGAAyG;IACzG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAeD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEtG;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAG5F;AAiBD;;;GAGG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IAExD,oCAAoC;IACpC,MAAM,CAAC,WAAW,IAAI,YAAY;IAKlC,qBAAqB;IACrB,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,GAAE,MAAmB,GAAG,IAAI;IAS9E;;;;;;;;;OASG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;CAK9E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAW5F;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAClJ,GAAG,GAAE,YAAyC,GAC5C,IAAI,CAWN"}

package/dist/cli/backend/src/services/messaging/queue-priority.js

@@ -0,0 +1,146 @@
+/**
+ * What an agent's message queue needs to know about a message beyond its
+ * text: whether the owner wrote it (it goes ahead of system traffic), which
+ * conversation and thread it belongs to (for a colleague's message or a
+ * reminder, a reply there after it was queued means it was answered — never
+ * for the owner's own message), the owner message it carries (so a second
+ * copy is recognised), and which earlier reminder it replaces.
+ *
+ * Callers that know this (the chat dispatcher for an owner's message, the
+ * decision service for an owner's answer, the owner-message watchdog for its
+ * reminder, the open-items service for a "promised work is ready" reminder)
+ * run their delivery inside {@link withQueueMeta}. If the agent is busy and
+ * the delivery path queues the message, {@link SubAgentMessageQueue.enqueue}
+ * picks the meta up from the async context — no delivery signature changes.
+ *
+ * Case that motivated it (2026-10-05, #education, D-270): the owner's answer
+ * to Atlas's decision card was queued at position 7 behind stale reminders,
+ * handed over one per idle moment oldest-first, and reached Atlas after
+ * ~18 minutes; a duplicate of an owner message Atlas had already answered sat
+ * in front of it.
+ *
+ * @module services/messaging/queue-priority
+ */
+import { AsyncLocalStorage } from 'async_hooks';
+const context = new AsyncLocalStorage();
+/**
+ * Run a delivery with queue metadata for one message to one agent. If the
+ * delivery queues that message for that agent, the queued copy carries the
+ * metadata.
+ *
+ * @param session - The agent the delivery is for
+ * @param data - The exact text being delivered
+ * @param meta - The metadata
+ * @param fn - The delivery
+ * @returns What `fn` returns
+ */
+export function withQueueMeta(session, data, meta, fn) {
+    return context.run({ session, data, meta }, fn);
+}
+/**
+ * The metadata of the delivery running now, if it is this message for this agent.
+ *
+ * @param session - The agent a message is being queued for
+ * @param data - The message being queued
+ * @returns The metadata, or undefined
+ */
+export function currentQueueMeta(session, data) {
+    const bound = context.getStore();
+    return bound && bound.session === session && bound.data === data ? bound.meta : undefined;
+}
+/** How long posts are remembered; a queued message older than this is judged by the other rules. */
+const POST_KEEP_MS = 24 * 60 * 60 * 1000;
+/** Posts remembered per agent. */
+const POSTS_PER_AGENT = 200;
+/**
+ * The agents' recent posts, by agent. Fed by the chat-v2 turn stream and the
+ * `reply` endpoint; read by the queue when it flushes.
+ */
+export class AgentPostLog {
+    static instance = null;
+    posts = new Map();
+    /** @returns The process-wide log */
+    static getInstance() {
+        if (!AgentPostLog.instance)
+            AgentPostLog.instance = new AgentPostLog();
+        return AgentPostLog.instance;
+    }
+    /** Reset (tests). */
+    static resetInstance() {
+        AgentPostLog.instance = null;
+    }
+    /**
+     * Record that an agent posted (a real answer, not an interim "working on it").
+     *
+     * @param session - The agent
+     * @param where - Where it posted
+     * @param at - When (default now)
+     */
+    note(session, where, at = Date.now()) {
+        if (!session || (!where.chatChannelId && !where.slackChannelId))
+            return;
+        const list = this.posts.get(session) ?? [];
+        list.push({ at, where: { ...where } });
+        const cutoff = Date.now() - POST_KEEP_MS;
+        const kept = list.filter((p) => p.at >= cutoff).slice(-POSTS_PER_AGENT);
+        this.posts.set(session, kept);
+    }
+    /**
+     * Whether the agent posted in a conversation (and thread) after a moment.
+     *
+     * Matched by thread only (see {@link sameConversation}).
+     *
+     * @param session - The agent
+     * @param where - The queued message's conversation
+     * @param since - When it was queued
+     * @returns True when the agent spoke there after `since`
+     */
+    postedSince(session, where, since) {
+        const list = this.posts.get(session);
+        if (!list)
+            return false;
+        return list.some((p) => p.at > since && sameConversation(p.where, where));
+    }
+}
+/**
+ * Whether a post landed in the conversation (and thread) a queued message belongs to.
+ *
+ * @param post - Where the agent posted
+ * @param queued - Where the queued message's answer belongs
+ * @returns True on a match
+ */
+export function sameConversation(post, queued) {
+    // Only a thread identifies one conversation. A top-level DM is never
+    // matched: the agent posting there about something else (an earlier
+    // request finishing) must not make a newer owner message look answered.
+    if (queued.chatChannelId && queued.chatThreadId && post.chatChannelId === queued.chatChannelId && post.chatThreadId === queued.chatThreadId) {
+        return true;
+    }
+    if (queued.slackChannelId && queued.threadTs && post.slackChannelId === queued.slackChannelId && post.threadTs === queued.threadTs) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Feed a recorded chat-v2 turn to the post log: an agent's real answer (not
+ * an interim "working on it") in a conversation, and the Slack thread it
+ * mirrors to when the turn says so.
+ *
+ * @param dto - The turn (sender, channel, thread, metadata)
+ * @param log - The post log (default: the process-wide one)
+ */
+export function noteAgentChatTurn(dto, log = AgentPostLog.getInstance()) {
+    if (dto.senderType !== 'agent' || !dto.senderId)
+        return;
+    const meta = dto.metadata ?? {};
+    if (meta.interim === true)
+        return;
+    const slackChannelId = typeof meta.slackChannelId === 'string' ? meta.slackChannelId : undefined;
+    const threadTs = typeof meta.slackThreadTs === 'string' ? meta.slackThreadTs : undefined;
+    log.note(dto.senderId, {
+        chatChannelId: dto.channelId,
+        ...(dto.threadId ? { chatThreadId: dto.threadId } : {}),
+        ...(slackChannelId && threadTs ? { slackChannelId, threadTs } : {}),
+    });
+}
+//# sourceMappingURL=queue-priority.js.map

package/dist/cli/backend/src/services/messaging/queue-priority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-priority.js","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/queue-priority.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/services/messaging/sub-agent-message-queue.service.d.ts

@@ -10,6 +10,7 @@
  *
  * @module sub-agent-message-queue
  */
+import { type QueueMessageMeta } from './queue-priority.js';
 /**
  * A single queued message destined for a sub-agent.
  */
@@ -38,7 +39,23 @@ export interface QueuedAgentMessage {
      * conversation — runs when it is finally delivered (crewly#1015 review).
      */
     workItemId?: string;
+    /**
+     * Who wrote it and where its answer belongs (see queue-priority.ts):
+     * owner messages go ahead of system traffic, and a message answered in
+     * its thread, a second copy of an owner message, or a reminder replaced
+     * by a newer one is dropped at flush time.
+     */
+    meta?: QueueMessageMeta;
 }
+/**
+ * Owner messages first, each group in its existing order (stable).
+ *
+ * @param list - Queue
+ * @returns The queue in delivery order
+ */
+export declare function ownerFirst(list: QueuedAgentMessage[]): QueuedAgentMessage[];
+/** Why a queued message was dropped before delivery as no longer needed. */
+export type QueuePruneReason = 'answered-in-thread' | 'duplicate-owner-message' | 'superseded';
 /** A hand-over prepared for a queued WorkItem brief (see {@link SubAgentMessageQueue.setHandOverPreparer}). */
 export interface QueuedHandOver {
     /** Text to write */
@@ -198,19 +215,26 @@ export declare class SubAgentMessageQueue {
     }>;
     /**
      * Enqueue a message for a session that is not yet active.
-     * If the queue exceeds MAX_QUEUE_SIZE, the oldest message is dropped.
+     * If the queue exceeds MAX_QUEUE_SIZE, the oldest non-owner message is
+     * dropped (the oldest message when all are the owner's).
      *
      * A message identical to one already waiting for the same session is not
      * added again: the reconciler re-sends the same reminder while an agent
      * is stopped (daily token cap, busy), and each copy would cost the agent
-     * a turn once delivered. The waiting copy keeps its place.
+     * a turn once delivered. The waiting copy keeps its place. Neither is a
+     * second copy of the same owner message (same `ref`).
+     *
+     * Owner messages (see {@link QueueMessageMeta}, taken from `meta.queueMeta`
+     * or the delivery running now — {@link withQueueMeta}) go to the front,
+     * behind owner messages already waiting; everything else goes to the back.
      *
      * @param sessionName - The target agent session name
      * @param data - The raw data string to deliver later
-     * @param meta - `workItemId` when the message hands over a WorkItem
+     * @param meta - `workItemId` when the message hands over a WorkItem; `queueMeta` to override the context
      */
     enqueue(sessionName: string, data: string, meta?: {
         workItemId?: string;
+        queueMeta?: QueueMessageMeta;
     }): void;
     /**
      * Dequeue all pending messages for a session (FIFO order).
@@ -257,6 +281,34 @@ export declare class SubAgentMessageQueue {
         failed: number;
         skippedStale: number;
     }>;
+    /**
+     * Drop queued messages that are no longer needed, before delivery:
+     * a later copy of an owner message already queued (same `ref`), and a
+     * reminder replaced by a newer one (same `supersedeKey`; the newest is
+     * kept). Each drop is logged. Messages without metadata are untouched.
+     *
+     * @param sessionName - The agent
+     * @param pending - Its queue, in delivery order
+     * @param out - Counters (`skippedStale` is incremented per drop)
+     * @returns The messages still to deliver, in order
+     */
+    private pruneNoLongerNeeded;
+    /**
+     * Whether the agent has already posted in the thread a queued message
+     * belongs to, after it was queued — it was answered (the agent read the
+     * thread). Only messages that name a thread are judged this way.
+     *
+     * Never an owner's own message (or the owner's decision answer): the owner
+     * may ask a follow-up in the same thread while the agent is still
+     * answering the first question, and that post must not make the follow-up
+     * look answered. Owner messages are dropped only as exact duplicates.
+     * Harness reminders carrying the owner's words (`reminder`) are judged.
+     *
+     * @param m - Queued message
+     * @returns True when it was answered
+     */
+    private answeredInThread;
+    private logPrune;
     /**
      * Sessions that still have messages waiting for them. A restart must bring
      * these agents back: a message queued for an agent is work in hand even

package/dist/cli/backend/src/services/messaging/sub-agent-message-queue.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sub-agent-message-queue.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/sub-agent-message-queue.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH;;GAEG;AACH,oDAAoD;AACpD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG,eAAe,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;AAEtH,MAAM,WAAW,kBAAkB;IAClC,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,+GAA+G;AAC/G,MAAM,WAAW,cAAc;IAC9B,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,gCAAgC;IAChC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,2FAA2F;IAC3F,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,oFAAoF;AACpF,MAAM,MAAM,sBAAsB,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAExH;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAElG;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqC;IAC5D,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,gGAAgG;IAChG,OAAO,CAAC,aAAa,CAAuB;IAC5C,+EAA+E;IAC/E,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAkC;IACpD,+EAA+E;IAC/E,OAAO,CAAC,YAAY,CAAkC;IACtD,yEAAyE;IACzE,OAAO,CAAC,gBAAgB,CAAuC;IAC/D,kDAAkD;IAClD,OAAO,CAAC,iBAAiB,CAA8D;IACvF,uEAAuE;IACvE,OAAO,CAAC,eAAe,CAA8F;IAErH,OAAO;IAMP;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI;IAyDZ;;;OAGG;IACH,OAAO,CAAC,IAAI;IAyBZ;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,oBAAoB;IAO5D;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpD;;;;;;;;OAQG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAWlD;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI;IAQzD;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAYlB;;;;;;;;;OASG;IACH,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI;IAI3D;;;;;OAKG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,kBAAkB,EAAE;IAIxD;;;;;;;OAOG;IACH,oBAAoB,CAAC,QAAQ,EAAE,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAI1F,OAAO,CAAC,eAAe;IAQvB;;;;;OAKG;IACH,mBAAmB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GAAG,IAAI;IAIlE;;;;;;OAMG;YACW,OAAO;IAarB;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBvE;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IA2CpF;;;;;;OAMG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAkBrD;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;;;;;;;;;;;;;;;OAkBG;IACG,KAAK,CACV,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EACxF,KAAK,SAAI,GACP,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IA0GzF;;;;;;;;OAQG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;;;;OAKG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKxC;;;;OAIG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAYhC;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAKzC;;;;;OAKG;IACH,cAAc,IAAI,MAAM;CAKxB"}
+{"version":3,"file":"sub-agent-message-queue.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/sub-agent-message-queue.service.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/services/messaging/sub-agent-message-queue.service.js

@@ -16,6 +16,28 @@ import { SUB_AGENT_QUEUE_CONSTANTS } from '../../constants.js';
 import { mkdirSync, existsSync } from 'fs';
 import { atomicWriteFileSync, quarantineCorruptFileSync, readJsonStoreSync, CorruptJsonFileError } from '../../utils/file-io.utils.js';
 import { getCrewlyHomePath } from '../core/crewly-home.utils.js';
+import { AgentPostLog, currentQueueMeta } from './queue-priority.js';
+/**
+ * Whether a queued message was written by (or carries the answer of) the owner.
+ *
+ * @param m - Queued message
+ * @returns True for owner traffic
+ */
+function isOwnerItem(m) {
+    return m.meta?.owner === true;
+}
+/**
+ * Owner messages first, each group in its existing order (stable).
+ *
+ * @param list - Queue
+ * @returns The queue in delivery order
+ */
+export function ownerFirst(list) {
+    const owner = list.filter(isOwnerItem);
+    if (owner.length === 0 || owner.length === list.length)
+        return list;
+    return [...owner, ...list.filter((m) => !isOwnerItem(m))];
+}
 /**
  * Singleton service that holds pending messages per agent session.
  *
@@ -103,7 +125,7 @@ export class SubAgentMessageQueue {
             if (usable.length === 0)
                 continue;
             // Restored messages are older than anything queued since: they go first.
-            this.pendingMessages.set(sessionName, [...usable, ...current]);
+            this.pendingMessages.set(sessionName, ownerFirst([...usable, ...current]));
             restored += usable.length;
         }
         if (restored > 0) {
@@ -338,18 +360,25 @@ export class SubAgentMessageQueue {
     }
     /**
      * Enqueue a message for a session that is not yet active.
-     * If the queue exceeds MAX_QUEUE_SIZE, the oldest message is dropped.
+     * If the queue exceeds MAX_QUEUE_SIZE, the oldest non-owner message is
+     * dropped (the oldest message when all are the owner's).
      *
      * A message identical to one already waiting for the same session is not
      * added again: the reconciler re-sends the same reminder while an agent
      * is stopped (daily token cap, busy), and each copy would cost the agent
-     * a turn once delivered. The waiting copy keeps its place.
+     * a turn once delivered. The waiting copy keeps its place. Neither is a
+     * second copy of the same owner message (same `ref`).
+     *
+     * Owner messages (see {@link QueueMessageMeta}, taken from `meta.queueMeta`
+     * or the delivery running now — {@link withQueueMeta}) go to the front,
+     * behind owner messages already waiting; everything else goes to the back.
      *
      * @param sessionName - The target agent session name
      * @param data - The raw data string to deliver later
-     * @param meta - `workItemId` when the message hands over a WorkItem
+     * @param meta - `workItemId` when the message hands over a WorkItem; `queueMeta` to override the context
      */
     enqueue(sessionName, data, meta = {}) {
+        const queueMeta = meta.queueMeta ?? currentQueueMeta(sessionName, data);
         let queue = this.pendingMessages.get(sessionName);
         if (!queue) {
             queue = [];
@@ -363,9 +392,18 @@ export class SubAgentMessageQueue {
             });
             return;
         }
-        // Drop oldest if at capacity
+        if (queueMeta?.ref && queue.some((m) => m.meta?.ref === queueMeta.ref)) {
+            this.logger.info('Same owner message already queued for the agent — not added again', {
+                sessionName,
+                ref: queueMeta.ref,
+                queueSize: queue.length,
+            });
+            return;
+        }
+        // Drop the oldest non-owner message if at capacity (the owner's last).
         if (queue.length >= SUB_AGENT_QUEUE_CONSTANTS.MAX_QUEUE_SIZE) {
-            const dropped = queue.shift();
+            const victim = queue.findIndex((m) => !isOwnerItem(m));
+            const dropped = queue.splice(victim >= 0 ? victim : 0, 1)[0];
             this.logger.warn('Queue at capacity, dropping oldest message', {
                 sessionName,
                 droppedAt: dropped?.queuedAt,
@@ -374,16 +412,27 @@ export class SubAgentMessageQueue {
             if (dropped)
                 this.reportDrop(sessionName, [dropped], 'capacity');
         }
-        queue.push({
+        const item = {
             data,
             queuedAt: Date.now(),
             sessionName,
             ...(meta.workItemId ? { workItemId: meta.workItemId } : {}),
-        });
+            ...(queueMeta && Object.keys(queueMeta).length > 0 ? { meta: { ...queueMeta } } : {}),
+        };
+        // The owner's messages go ahead of system traffic, in the order they came.
+        let position = queue.length;
+        if (isOwnerItem(item)) {
+            const firstOther = queue.findIndex((m) => !isOwnerItem(m));
+            if (firstOther >= 0)
+                position = firstOther;
+        }
+        queue.splice(position, 0, item);
         this.save();
         this.logger.info('Message queued for sub-agent', {
             sessionName,
             queueSize: queue.length,
+            position: position + 1,
+            ...(isOwnerItem(item) ? { owner: true } : {}),
             dataLength: data.length,
         });
     }
@@ -446,8 +495,8 @@ export class SubAgentMessageQueue {
      * @returns How many were delivered, deferred again, failed, and dropped as stale
      */
     async flush(sessionName, send, gapMs = 0) {
-        const pending = this.dequeueAll(sessionName);
         const out = { delivered: 0, deferred: 0, failed: 0, skippedStale: 0 };
+        const pending = this.pruneNoLongerNeeded(sessionName, this.dequeueAll(sessionName), out);
         // A send that failed ("Session does not exist", "Runtime has exited")
         // or threw is not a delivery: the message goes back on the queue, up
         // to MAX_DELIVERY_ATTEMPTS, then the drop is reported (crewly#1014).
@@ -473,6 +522,11 @@ export class SubAgentMessageQueue {
             }
         };
         for (const [i, queued] of pending.entries()) {
+            if (this.answeredInThread(queued)) {
+                out.skippedStale += 1;
+                this.logPrune(sessionName, queued, 'answered-in-thread');
+                continue;
+            }
             if (await this.isStale(queued.data, sessionName)) {
                 out.skippedStale += 1;
                 continue;
@@ -541,7 +595,7 @@ export class SubAgentMessageQueue {
             // Back at the front, in their original order, ahead of anything
             // queued meanwhile (failed ones came before the held one).
             const queue = (this.pendingMessages.get(sessionName) ?? []).filter((m) => !heldAgain.some((h) => h.data === m.data) && !failedAgain.some((f) => f.data === m.data));
-            this.pendingMessages.set(sessionName, [...failedAgain, ...heldAgain, ...queue]);
+            this.pendingMessages.set(sessionName, ownerFirst([...failedAgain, ...heldAgain, ...queue]));
             this.save();
         }
         if (undeliverable.length > 0)
@@ -555,6 +609,84 @@ export class SubAgentMessageQueue {
         }
         return out;
     }
+    /**
+     * Drop queued messages that are no longer needed, before delivery:
+     * a later copy of an owner message already queued (same `ref`), and a
+     * reminder replaced by a newer one (same `supersedeKey`; the newest is
+     * kept). Each drop is logged. Messages without metadata are untouched.
+     *
+     * @param sessionName - The agent
+     * @param pending - Its queue, in delivery order
+     * @param out - Counters (`skippedStale` is incremented per drop)
+     * @returns The messages still to deliver, in order
+     */
+    pruneNoLongerNeeded(sessionName, pending, out) {
+        const newestBySupersede = new Map();
+        for (const m of pending) {
+            const key = m.meta?.supersedeKey;
+            if (!key)
+                continue;
+            const cur = newestBySupersede.get(key);
+            if (!cur || m.queuedAt >= cur.queuedAt)
+                newestBySupersede.set(key, m);
+        }
+        const seenRefs = new Set();
+        const kept = [];
+        for (const m of pending) {
+            const key = m.meta?.supersedeKey;
+            if (key && newestBySupersede.get(key) !== m) {
+                out.skippedStale += 1;
+                this.logPrune(sessionName, m, 'superseded');
+                continue;
+            }
+            const ref = m.meta?.ref;
+            if (ref) {
+                if (seenRefs.has(ref)) {
+                    out.skippedStale += 1;
+                    this.logPrune(sessionName, m, 'duplicate-owner-message');
+                    continue;
+                }
+                seenRefs.add(ref);
+            }
+            kept.push(m);
+        }
+        if (kept.length < pending.length)
+            this.save();
+        return kept;
+    }
+    /**
+     * Whether the agent has already posted in the thread a queued message
+     * belongs to, after it was queued — it was answered (the agent read the
+     * thread). Only messages that name a thread are judged this way.
+     *
+     * Never an owner's own message (or the owner's decision answer): the owner
+     * may ask a follow-up in the same thread while the agent is still
+     * answering the first question, and that post must not make the follow-up
+     * look answered. Owner messages are dropped only as exact duplicates.
+     * Harness reminders carrying the owner's words (`reminder`) are judged.
+     *
+     * @param m - Queued message
+     * @returns True when it was answered
+     */
+    answeredInThread(m) {
+        const where = m.meta?.where;
+        if (!where)
+            return false;
+        if (m.meta?.owner && !m.meta.reminder)
+            return false;
+        return AgentPostLog.getInstance().postedSince(m.sessionName, where, m.queuedAt);
+    }
+    logPrune(sessionName, m, reason) {
+        this.logger.info('Queued message dropped before delivery — no longer needed', {
+            sessionName,
+            reason,
+            queuedAt: new Date(m.queuedAt).toISOString(),
+            ...(m.meta?.owner ? { owner: true } : {}),
+            ...(m.meta?.ref ? { ref: m.meta.ref } : {}),
+            ...(m.meta?.supersedeKey ? { supersedeKey: m.meta.supersedeKey } : {}),
+            preview: m.data.slice(0, 80),
+        });
+    }
     /**
      * Sessions that still have messages waiting for them. A restart must bring
      * these agents back: a message queued for an agent is work in hand even