@tickernelz/paperclip-pro-server 2026.926.6 → 2026.927.1

package/dist/routes/issues.d.ts

@@ -1,6 +1,6 @@
 import type { Db } from "@tickernelz/paperclip-pro-db";
 import type { ChatChannelService } from "../services/chat-channels.js";
-import { type CompanySearchExtractQuery, type CompanySearchExtractResponse, type CompanySearchQuery, type CompanySearchResponse } from "@tickernelz/paperclip-pro-shared";
+import { type CompactIssue, type CompanySearchExtractQuery, type CompanySearchExtractResponse, type CompanySearchQuery, type CompanySearchResponse } from "@tickernelz/paperclip-pro-shared";
 import type { StorageService } from "../storage/types.js";
 import { heartbeatService } from "../services/index.js";
 import type { TaskWatchdogServiceDeps } from "../services/task-watchdogs.js";
@@ -10,6 +10,7 @@ type CompanySearchService = {
     extract(companyId: string, query: CompanySearchExtractQuery): Promise<CompanySearchExtractResponse>;
     search(companyId: string, query: CompanySearchQuery): Promise<CompanySearchResponse>;
 };
+export declare function toCompactIssue(issue: any): CompactIssue;
 export declare const ISSUE_LIST_SERVER_CACHE_MAX_ENTRIES = 256;
 type IssueListStormEvent = {
     event: "request_storm_detected";

package/dist/routes/issues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/routes/issues.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/routes/issues.ts"],"names":[],"mappings":"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"}

package/dist/routes/issues.js

@@ -1797,7 +1797,31 @@ class AutoApprovalIssueMissingError extends Error {
         this.name = "AutoApprovalIssueMissingError";
     }
 }
-function toCompactIssue(issue) {
+function toCompactBlockerAttention(attention) {
+    if (attention.state === "none")
+        return null;
+    return {
+        state: attention.state,
+        reason: attention.reason,
+        unresolvedBlockerCount: attention.unresolvedBlockerCount,
+        coveredBlockerCount: attention.coveredBlockerCount,
+        stalledBlockerCount: attention.stalledBlockerCount,
+        attentionBlockerCount: attention.attentionBlockerCount,
+        sampleBlockerIdentifier: attention.sampleBlockerIdentifier,
+        sampleStalledBlockerIdentifier: attention.sampleStalledBlockerIdentifier,
+        ...(attention.directBlockerIssueId
+            ? { directBlockerIssueId: attention.directBlockerIssueId }
+            : {}),
+        ...(attention.terminalBlockerIssueId
+            ? { terminalBlockerIssueId: attention.terminalBlockerIssueId }
+            : {}),
+        ...(attention.terminalBlocker ? { terminalBlocker: attention.terminalBlocker } : {}),
+    };
+}
+export function toCompactIssue(issue) {
+    const blockerAttention = issue.blockerAttention
+        ? toCompactBlockerAttention(issue.blockerAttention)
+        : null;
     return {
         externalConversationState: issue.externalConversationState ?? null,
         id: issue.id,
@@ -1836,12 +1860,7 @@ function toCompactIssue(issue) {
         ...(issue.labelIds ? { labelIds: issue.labelIds } : {}),
         ...(issue.labels ? { labels: issue.labels } : {}),
         ...(issue.blockedBy ? { blockedBy: issue.blockedBy } : {}),
-        ...(issue.blockerAttention
-            ? { blockerAttention: issue.blockerAttention }
-            : {}),
-        ...(issue.reviewAttention
-            ? { reviewAttention: issue.reviewAttention }
-            : {}),
+        ...(blockerAttention ? { blockerAttention } : {}),
         ...(issue.blockedInboxAttention !== undefined
             ? { blockedInboxAttention: issue.blockedInboxAttention }
             : {}),
@@ -10448,7 +10467,7 @@ export function issueRoutes(db, storage, opts = {}) {
             requestedByActorId: actor.actorId,
         });
         // Merge all wakeups from this update into one enqueue per agent to avoid duplicate runs.
-        void (async () => {
+        const wakeDispatch = (async () => {
             const dependencyReadinessSvc = svc;
             const wakeups = new Map();
             const addWakeup = (agentId, wakeup) => {
@@ -10817,8 +10836,8 @@ export function issueRoutes(db, storage, opts = {}) {
                     });
                 }
             }
-            for (const { agentId, wakeup } of wakeups.values()) {
-                heartbeat
+            await Promise.all([...wakeups.values()].map(async ({ agentId, wakeup }) => {
+                await heartbeat
                     .wakeup(agentId, wakeup)
                     .then((wakeRun) => {
                     if (wakeup.reason !== ISSUE_BLOCKERS_RESOLVED_WAKE_REASON)
@@ -10853,10 +10872,21 @@ export function issueRoutes(db, storage, opts = {}) {
                     });
                 })
                     .catch((err) => logger.warn({ err, issueId: issue.id, agentId }, "failed to wake agent on issue update"));
-            }
-        })();
+            }));
+        })().catch((err) => logger.warn({ err, issueId: issue.id }, "failed to dispatch the issue update wake"));
         await queueTaskWatchdogEvaluation(issue, actor.runId);
         const changes = issueResponse.changes ?? {};
+        const delivery = comment
+            ? await resolveMessageDeliveryDisposition({
+                issue,
+                commentId: comment.id,
+                actor,
+                requested: req.body.commentDeliver,
+                boardUserId: req.actor.type === "board" ? req.actor.userId ?? null : null,
+                wakeDispatch,
+            })
+            : null;
+        const commentResponse = comment && delivery ? { ...comment, ...delivery } : comment;
         if (prefersMinimalIssueUpdateResponse(req)) {
             res.setHeader("Preference-Applied", "return=minimal");
             res.json({
@@ -10864,11 +10894,11 @@ export function issueRoutes(db, storage, opts = {}) {
                 identifier: issueResponse.identifier,
                 updatedAt: issueResponse.updatedAt,
                 changes,
-                comment,
+                comment: commentResponse,
             });
             return;
         }
-        res.json({ ...issueResponse, changes, comment });
+        res.json({ ...issueResponse, changes, comment: commentResponse });
     });
     router.delete("/issues/:id", async (req, res) => {
         const id = req.params.id;
@@ -11271,26 +11301,15 @@ export function issueRoutes(db, storage, opts = {}) {
         });
         res.json(await runRedactions.redactForIssue(issue.companyId, issue.id, queue));
     });
-    router.post("/issues/:id/queued-comments/:commentId/steer", validate(queuedCommentSteeringTargetSchema), async (req, res) => {
-        assertBoard(req);
-        if (!req.actor.userId)
-            throw forbidden("Board user context required");
-        const id = req.params.id;
-        const commentId = req.params.commentId;
-        const issue = await getAccessibleResource(req, res, svc.getById(id), "Issue not found");
-        if (!issue)
-            return;
-        if (issue.conversationAgentId)
-            throw conflict("Conversation messages are processed in order at turn boundaries");
-        const decision = await decideIssueAccess(req, issue, "issue:comment");
-        if (!decision.allowed)
-            throw forbidden(decision.explanation, authorizationDeniedDetails(decision));
-        const actor = getActorInfo(req);
-        const responseWake = await db.select().from(agentWakeupRequests).where(and(eq(agentWakeupRequests.id, req.body.queueId), eq(agentWakeupRequests.companyId, issue.companyId))).then(rows => rows[0]);
-        const response = responseWake ? await readQueuedInteractionResponse(db, issue.companyId, issue.id, responseWake.payload) : null;
+    async function steerQueuedCommentInTransaction(input) {
+        const { issue, actor, commentId } = input;
+        const responseWake = await db.select().from(agentWakeupRequests).where(and(eq(agentWakeupRequests.id, input.queueId), eq(agentWakeupRequests.companyId, issue.companyId))).then(rows => rows[0]);
+        const response = responseWake
+            ? await readQueuedInteractionResponse(db, issue.companyId, issue.id, responseWake.payload)
+            : null;
         const steeringIdentity = await reserveSteeredIdentity(db, {
             companyId: issue.companyId,
-            runId: req.body.targetRunId,
+            runId: input.targetRunId,
             issueId: issue.id,
             messageId: commentId,
             source: response?.comment.id === commentId ? "interaction" : "comment",
@@ -11301,10 +11320,6 @@ export function issueRoutes(db, storage, opts = {}) {
         let queue;
         try {
             queue = await db.transaction(async (tx) => {
-                // A client can lose the successful response after the final queued
-                // message cancels its wake. Lock the original queue and target run
-                // first so that the persisted acknowledgement remains a durable
-                // idempotency record even when no pending queue remains.
                 await tx
                     .select({ id: issueRows.id })
                     .from(issueRows)
@@ -11313,7 +11328,7 @@ export function issueRoutes(db, storage, opts = {}) {
                 const retryWake = await tx
                     .select()
                     .from(agentWakeupRequests)
-                    .where(and(eq(agentWakeupRequests.id, req.body.queueId), eq(agentWakeupRequests.companyId, issue.companyId), issue.assigneeAgentId
+                    .where(and(eq(agentWakeupRequests.id, input.queueId), eq(agentWakeupRequests.companyId, issue.companyId), issue.assigneeAgentId
                     ? eq(agentWakeupRequests.agentId, issue.assigneeAgentId)
                     : undefined))
                     .for("update")
@@ -11323,7 +11338,7 @@ export function issueRoutes(db, storage, opts = {}) {
                     ? await tx
                         .select()
                         .from(heartbeatRuns)
-                        .where(and(eq(heartbeatRuns.id, req.body.targetRunId), eq(heartbeatRuns.companyId, issue.companyId), eq(heartbeatRuns.agentId, retryWake.agentId)))
+                        .where(and(eq(heartbeatRuns.id, input.targetRunId), eq(heartbeatRuns.companyId, issue.companyId), eq(heartbeatRuns.agentId, retryWake.agentId)))
                         .for("update")
                         .limit(1)
                         .then((rows) => rows[0] ?? null)
@@ -11336,7 +11351,7 @@ export function issueRoutes(db, storage, opts = {}) {
                     (retryRunContext.issueId === issue.id ||
                         retryRunContext.taskId === issue.id) &&
                     retryAcknowledgement.status === "acknowledged" &&
-                    retryAcknowledgement.queueId === req.body.queueId) {
+                    retryAcknowledgement.queueId === input.queueId) {
                     duplicate = true;
                     acknowledgedTurnId =
                         typeof retryAcknowledgement.turnId === "string"
@@ -11353,8 +11368,8 @@ export function issueRoutes(db, storage, opts = {}) {
                     tx,
                     issue,
                     actor,
-                    queueId: req.body.queueId,
-                    targetRunId: req.body.targetRunId,
+                    queueId: input.queueId,
+                    targetRunId: input.targetRunId,
                 });
                 if (!locked.activeRun) {
                     throw conflict("The queued message targets a stale run", {
@@ -11365,7 +11380,7 @@ export function issueRoutes(db, storage, opts = {}) {
                 const acknowledgements = readObject(runResult.queuedSteeringAcknowledgements);
                 const priorAcknowledgement = readObject(acknowledgements[commentId]);
                 if (priorAcknowledgement.status === "acknowledged" &&
-                    priorAcknowledgement.queueId === req.body.queueId) {
+                    priorAcknowledgement.queueId === input.queueId) {
                     duplicate = true;
                     acknowledgedTurnId =
                         typeof priorAcknowledgement.turnId === "string"
@@ -11381,8 +11396,8 @@ export function issueRoutes(db, storage, opts = {}) {
                 }
                 assertQueueMutationTarget({
                     queue: locked.queue,
-                    queueId: req.body.queueId,
-                    revision: req.body.revision,
+                    queueId: input.queueId,
+                    revision: input.revision,
                 });
                 if (locked.queue.protocol !== "paperclip_runner_v1") {
                     throw conflict("This runner does not support same-turn steering", {
@@ -11444,7 +11459,7 @@ export function issueRoutes(db, storage, opts = {}) {
                             ...acknowledgements,
                             [commentId]: {
                                 status: "acknowledged",
-                                queueId: req.body.queueId,
+                                queueId: input.queueId,
                                 turnId: acknowledgement.turnId,
                                 acknowledgedAt: now.toISOString(),
                             },
@@ -11475,6 +11490,121 @@ export function issueRoutes(db, storage, opts = {}) {
             }
             throw error;
         }
+        return { queue, duplicate, acknowledgedTurnId };
+    }
+    function steeringUnavailableFromError(error) {
+        const code = error instanceof HttpError &&
+            error.details &&
+            typeof error.details === "object" &&
+            !Array.isArray(error.details) &&
+            typeof error.details.code === "string"
+            ? error.details.code
+            : null;
+        if (code === "steering_unsupported")
+            return "legacy_protocol";
+        if (code === "queued_comment_stale_target" ||
+            code === "queued_comment_not_pending" ||
+            code === "queued_comment_already_dispatching" ||
+            code === "queued_comment_stale_queue" ||
+            code === "queued_comment_revision_conflict" ||
+            code === "queued_response_requires_fresh_session") {
+            return "no_active_run";
+        }
+        return "steering_failed";
+    }
+    /**
+     * Resolve how a freshly posted message was actually delivered, and steer it
+     * when the resolved mode is `"steer"`.
+     *
+     * This never fails the write. Every path that cannot steer returns a queue
+     * disposition with the reason attached, so a caller can always tell "queued
+     * because you asked" from "you asked to steer and got a queue instead".
+     */
+    async function resolveMessageDeliveryDisposition(input) {
+        const effective = input.requested ??
+            (await instanceSettings.getGeneral()).defaultMessageDelivery;
+        if (effective === "queue") {
+            return { deliveredAs: "queued", steeringUnavailable: "not_requested" };
+        }
+        if (input.actor.actorType === "agent" || !input.boardUserId) {
+            return { deliveredAs: "queued", steeringUnavailable: "board_only" };
+        }
+        if (input.issue.conversationAgentId) {
+            return { deliveredAs: "queued", steeringUnavailable: "conversation_issue" };
+        }
+        try {
+            await input.wakeDispatch;
+        }
+        catch (err) {
+            logger.warn({ err, issueId: input.issue.id, commentId: input.commentId }, "failed to complete the comment wake dispatch before steering");
+        }
+        let target = null;
+        try {
+            const issue = await svc.getById(input.issue.id);
+            const activeRun = issue ? await resolveActiveIssueRun(issue) : null;
+            const queue = await buildQueuedCommentQueue({
+                executor: db,
+                issue: issue ?? input.issue,
+                activeRun,
+                actor: input.actor,
+                steeringDisposition: "temporarily_unavailable",
+            });
+            const entry = queue.entries.find((candidate) => candidate.comment.id === input.commentId);
+            if (entry && queue.protocol !== "paperclip_runner_v1") {
+                return { deliveredAs: "queued", steeringUnavailable: "legacy_protocol" };
+            }
+            target =
+                entry && queue.queueId && queue.targetRunId
+                    ? { queueId: queue.queueId, targetRunId: queue.targetRunId, revision: queue.revision }
+                    : null;
+        }
+        catch (err) {
+            logger.warn({ err, issueId: input.issue.id, commentId: input.commentId }, "failed to resolve the steering target for a posted comment");
+        }
+        if (!target) {
+            return { deliveredAs: "queued", steeringUnavailable: "no_active_run" };
+        }
+        try {
+            await steerQueuedCommentInTransaction({
+                issue: input.issue,
+                actor: input.actor,
+                commentId: input.commentId,
+                queueId: target.queueId,
+                targetRunId: target.targetRunId,
+                revision: target.revision,
+            });
+        }
+        catch (error) {
+            return {
+                deliveredAs: "queued",
+                steeringUnavailable: steeringUnavailableFromError(error),
+            };
+        }
+        return { deliveredAs: "steered" };
+    }
+    router.post("/issues/:id/queued-comments/:commentId/steer", validate(queuedCommentSteeringTargetSchema), async (req, res) => {
+        assertBoard(req);
+        if (!req.actor.userId)
+            throw forbidden("Board user context required");
+        const id = req.params.id;
+        const commentId = req.params.commentId;
+        const issue = await getAccessibleResource(req, res, svc.getById(id), "Issue not found");
+        if (!issue)
+            return;
+        if (issue.conversationAgentId)
+            throw conflict("Conversation messages are processed in order at turn boundaries");
+        const decision = await decideIssueAccess(req, issue, "issue:comment");
+        if (!decision.allowed)
+            throw forbidden(decision.explanation, authorizationDeniedDetails(decision));
+        const actor = getActorInfo(req);
+        const { queue, duplicate, acknowledgedTurnId } = await steerQueuedCommentInTransaction({
+            issue,
+            actor,
+            commentId,
+            queueId: req.body.queueId,
+            targetRunId: req.body.targetRunId,
+            revision: req.body.revision,
+        });
         await logActivity(db, {
             companyId: issue.companyId,
             actorType: actor.actorType,
@@ -12621,7 +12751,17 @@ export function issueRoutes(db, storage, opts = {}) {
                 publishActivity(publication);
             await issueReferencesSvc.syncComment(comment.id);
             await deliverConversationComments(db, issue, heartbeat.wakeup);
-            res.status(201).json(comment);
+            res.status(201).json({
+                ...comment,
+                ...(await resolveMessageDeliveryDisposition({
+                    issue,
+                    commentId: comment.id,
+                    actor,
+                    requested: req.body.deliver,
+                    boardUserId: req.actor.userId ?? null,
+                    wakeDispatch: Promise.resolve(),
+                })),
+            });
             return;
         }
         if (req.actor.type === "agent" && req.body.onBehalfOfUserId != null) {
@@ -13145,7 +13285,7 @@ export function issueRoutes(db, storage, opts = {}) {
                 currentIssue.status === "todo",
         });
         // Merge all wakeups from this comment into one enqueue per agent to avoid duplicate runs.
-        void (async () => {
+        const wakeDispatch = (async () => {
             const wakeups = new Map();
             const addWakeup = (agentId, wakeup) => {
                 const wakeIssueId = wakeup.payload &&
@@ -13411,8 +13551,8 @@ export function issueRoutes(db, storage, opts = {}) {
                     });
                 }
             }
-            for (const { agentId, wakeup } of wakeups.values()) {
-                heartbeat
+            await Promise.all([...wakeups.values()].map(async ({ agentId, wakeup }) => {
+                await heartbeat
                     .wakeup(agentId, wakeup)
                     .then((wakeRun) => {
                     if (wakeup.reason !== ISSUE_BLOCKERS_RESOLVED_WAKE_REASON)
@@ -13447,10 +13587,18 @@ export function issueRoutes(db, storage, opts = {}) {
                     });
                 })
                     .catch((err) => logger.warn({ err, issueId: currentIssue.id, agentId }, "failed to wake agent on issue comment"));
-            }
-        })();
+            }));
+        })().catch((err) => logger.warn({ err, issueId: currentIssue.id }, "failed to dispatch the issue comment wake"));
         await queueTaskWatchdogEvaluation(currentIssue, actor.runId);
-        res.status(201).json(comment);
+        const delivery = await resolveMessageDeliveryDisposition({
+            issue: currentIssue,
+            commentId: comment.id,
+            actor,
+            requested: req.body.deliver,
+            boardUserId: req.actor.type === "board" ? req.actor.userId ?? null : null,
+            wakeDispatch,
+        });
+        res.status(201).json({ ...comment, ...delivery });
     });
     router.post("/issues/:id/feedback-votes", validate(upsertIssueFeedbackVoteSchema), async (req, res) => {
         const id = req.params.id;