@tickernelz/paperclip-pro-server 2026.929.3 → 2026.929.5

package/dist/build-info.json

@@ -1,3 +1,3 @@
 {
-  "commit": "0feafec5a0e82d4af1a7e4ac3fb0e22b0fe8c403"
+  "commit": "6d94a1bd4d8c0a15b332cbca3e377eafb06a7eb2"
 }

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

@@ -13,7 +13,7 @@ import { createHash, randomUUID } from "node:crypto";
 import { Router } from "express";
 import multer from "multer";
 import { z } from "zod";
-import { and, asc, desc, eq, inArray, isNull, notInArray, sql, } from "drizzle-orm";
+import { and, asc, desc, eq, inArray, isNull, or, notInArray, sql, } from "drizzle-orm";
 import { activityLog, agentWakeupRequests, agents, approvals, chatConversations, chatEndpoints, chatPublications, companyMemberships, documents, executionWorkspaces, heartbeatRuns, issueApprovals, issueComments, issueDocuments, issueExecutionDecisions, issueRelations, issueRecoveryActions, issueThreadInteractions, issues as issueRows, issueWorkProducts, pipelineCaseIssueLinks, pipelineCases, pipelineStages, pipelines, projectWorkspaces, } from "@tickernelz/paperclip-pro-db";
 import { addIssueCommentSchema, acceptIssueThreadInteractionSchema, attachmentArtifactWorkProductMetadataSchema, cancelIssueThreadInteractionSchema, skipIssueThreadInteractionSchema, withdrawIssueThreadInteractionSchema, companySearchExtractQuerySchema, companySearchQuerySchema, createIssueAttachmentMetadataSchema, createIssueThreadInteractionSchema, createIssueWorkProductSchema, createIssueLabelSchema, createAcceptedPlanDecompositionSchema, checkoutIssueSchema, createDocumentAnnotationCommentSchema, createDocumentAnnotationThreadSchema, createChildIssueSchema, createIssueSchema, resolveCreateIssueStatusDefault, resolveIssueRecoveryActionSchema, runnerGoalActionRequestSchema, issueRunModelOverrideUpdateSchema, feedbackTargetTypeSchema, feedbackTraceStatusSchema, feedbackVoteValueSchema, upsertIssueFeedbackVoteSchema, upsertIssueWatchdogSchema, linkIssueApprovalSchema, issueDocumentKeySchema, ISSUE_CONTINUATION_SUMMARY_DOCUMENT_KEY, ISSUE_WATCHDOG_DISCOVERY_KINDS, TASK_WATCHDOG_PRODUCT_BUG_ORIGIN_KIND, ONBOARDING_FIRST_TASK_ORIGIN_KIND, rejectIssueThreadInteractionSchema, restoreIssueDocumentRevisionSchema, respondIssueThreadInteractionSchema, stalledReviewDecisionSchema, submitIssueThreadInteractionVerdictsSchema, updateIssueWorkProductSchema, updateDocumentAnnotationThreadSchema, upsertIssueDocumentSchema, updateIssueSchema, isClosedIsolatedExecutionWorkspace, isMarkdownArtifactWorkProduct, isMarkdownAttachmentContent, isUuidLike, normalizeIssueIdentifier as normalizeIssueReferenceIdentifier, issueWriteDenialCodeForResponsibleUserDenial, issueWriteDenialResponse, } from "@tickernelz/paperclip-pro-shared";
 import { trackAgentTaskCompleted } from "@tickernelz/paperclip-pro-shared/telemetry";
@@ -1135,7 +1135,15 @@ const INVALID_AGENT_IN_REVIEW_DISPOSITION_MESSAGE = "invalid_issue_disposition:
     "This request would leave the issue in_review without anyone or anything owning the next action. " +
     "Keep working instead of moving to review, create a request_confirmation or ask_user_questions interaction, " +
     "link or request a pending approval, assign a human reviewer with assigneeUserId, set a typed executionState.currentParticipant through an execution policy, " +
+    "create a review subtask with paperclipCreateChildIssue assigned to the reviewer and list it in blockedByIssueIds, " +
     "or schedule an issue monitor for an external review/check. After creating one of those review paths, retry the status update.";
+const AGENT_REVIEW_SUBTASK_INSTRUCTION = "Create a review subtask with paperclipCreateChildIssue assigned to the reviewer with a self-contained description " +
+    "(full instructions, acceptance criteria, and the material to review), add that subtask id to blockedByIssueIds on this issue, " +
+    "then set status to in_review. You stay the assignee and are woken when the review subtask is done.";
+const AGENT_REVIEW_HANDOFF_REQUIRES_SUBTASK_MESSAGE = "agent_review_handoff_requires_subtask: Agents cannot hand this task to a reviewer through review or approval stages they authored themselves. " +
+    AGENT_REVIEW_SUBTASK_INSTRUCTION;
+const AGENT_REASSIGN_REQUIRES_SUBTASK_MESSAGE = "agent_reassign_requires_subtask: Agents cannot move the assignee of the task they are working on to someone else. " +
+    AGENT_REVIEW_SUBTASK_INSTRUCTION;
 function executionPrincipalsEqual(left, right) {
     if (!left || !right || left.type !== right.type)
         return false;
@@ -1293,6 +1301,16 @@ function summarizeExecutionParticipants(policy, stageType) {
         userId: participant.userId ?? null,
     })) ?? []);
 }
+function executionStageShape(policy) {
+    return JSON.stringify((policy?.stages ?? []).map((stage) => [
+        stage.type,
+        stage.participants
+            .map((participant) => participant.type === "agent"
+            ? `agent:${participant.agentId ?? ""}`
+            : `user:${participant.userId ?? ""}`)
+            .sort(),
+    ]));
+}
 function isClosedIssueStatus(status) {
     return status === "done" || status === "cancelled";
 }
@@ -2974,6 +2992,51 @@ export function issueRoutes(db, storage, opts = {}) {
             return;
         await assertEnvironmentSelectionForCompany(environmentsSvc, companyId, environmentId, { allowedDrivers: ["local", "ssh", "sandbox"] });
     }
+    async function executionStageParticipantsAuthoredByAgent(input) {
+        const latestParticipantChange = await db
+            .select({ actorType: activityLog.actorType })
+            .from(activityLog)
+            .where(and(eq(activityLog.companyId, input.companyId), eq(activityLog.entityType, "issue"), eq(activityLog.entityId, input.issueId), inArray(activityLog.action, [
+            "issue.reviewers_updated",
+            "issue.approvers_updated",
+        ])))
+            .orderBy(desc(activityLog.createdAt))
+            .limit(1)
+            .then((rows) => rows[0] ?? null);
+        if (latestParticipantChange) {
+            return latestParticipantChange.actorType === "agent";
+        }
+        return Boolean(input.createdByAgentId) && (input.policy?.stages.length ?? 0) > 0;
+    }
+    async function agentReleasedIssue(input) {
+        const latestAssignmentEvent = await db
+            .select({ action: activityLog.action, agentId: activityLog.agentId })
+            .from(activityLog)
+            .where(and(eq(activityLog.companyId, input.companyId), eq(activityLog.entityType, "issue"), eq(activityLog.entityId, input.issueId), or(inArray(activityLog.action, [
+            "issue.released",
+            "issue.checked_out",
+            "issue.admin_force_release",
+        ]), and(eq(activityLog.action, "issue.updated"), sql `(${activityLog.details} ? 'assigneeAgentId' or ${activityLog.details} ? 'assigneeUserId')`))))
+            .orderBy(desc(activityLog.createdAt))
+            .limit(1)
+            .then((rows) => rows[0] ?? null);
+        return (latestAssignmentEvent?.action === "issue.released" &&
+            latestAssignmentEvent.agentId === input.agentId);
+    }
+    async function hasOpenBlockingIssue(input) {
+        if (input.requestedBlockerIssueIds) {
+            if (input.requestedBlockerIssueIds.length === 0)
+                return false;
+            return await db
+                .select({ id: issueRows.id })
+                .from(issueRows)
+                .where(and(eq(issueRows.companyId, input.companyId), inArray(issueRows.id, input.requestedBlockerIssueIds), notInArray(issueRows.status, ["done", "cancelled"])))
+                .limit(1)
+                .then((rows) => rows.length > 0);
+        }
+        const relations = await svc.getRelationSummaries(input.issueId);
+        return relations.blockedBy.some((blocker) => blocker.status !== "done" && blocker.status !== "cancelled");
+    }
     async function assertInReviewReviewPath(input) {
         const nextStatus = typeof input.updateFields.status === "string"
             ? input.updateFields.status
@@ -3054,6 +3117,12 @@ export function issueRoutes(db, storage, opts = {}) {
         const approvals = await issueApprovalsSvc.listApprovalsForIssue(input.existing.id);
         if (approvals.some((approval) => ACTIVE_REVIEW_APPROVAL_STATUSES.has(String(approval.status))))
             return null;
+        if (await hasOpenBlockingIssue({
+            companyId: input.existing.companyId,
+            issueId: input.existing.id,
+            requestedBlockerIssueIds: input.requestedBlockerIssueIds ?? null,
+        }))
+            return null;
         throw unprocessable(INVALID_AGENT_IN_REVIEW_DISPOSITION_MESSAGE, {
             code: "invalid_issue_disposition",
             missing: "review_path",
@@ -3063,6 +3132,7 @@ export function issueRoutes(db, storage, opts = {}) {
                 "human_assignee_user_id",
                 "typed_execution_state_current_participant",
                 "scheduled_issue_monitor",
+                "open_blocking_issue",
             ],
         });
     }
@@ -9502,6 +9572,40 @@ export function issueRoutes(db, storage, opts = {}) {
             };
         }
         Object.assign(updateFields, transition.patch);
+        if (actor.actorType === "agent" && transition.workflowControlledAssignment) {
+            const previousExecutionState = parseIssueExecutionState(existing.executionState);
+            const stageWorkflowAlreadyRunning = Boolean(previousExecutionState &&
+                (previousExecutionState.currentStageId ||
+                    previousExecutionState.status === "pending" ||
+                    previousExecutionState.status === "changes_requested" ||
+                    (previousExecutionState.completedStageIds?.length ?? 0) > 0));
+            const handoffAssigneeAgentId = updateFields.assigneeAgentId === undefined
+                ? existing.assigneeAgentId
+                : updateFields.assigneeAgentId;
+            const handoffAssigneeUserId = updateFields.assigneeUserId === undefined
+                ? existing.assigneeUserId
+                : updateFields.assigneeUserId;
+            const stageHandoffChangesAssignee = handoffAssigneeAgentId !== existing.assigneeAgentId ||
+                handoffAssigneeUserId !== existing.assigneeUserId;
+            const stagesAuthoredInRequest = req.body.executionPolicy !== undefined &&
+                executionStageShape(previousExecutionPolicy) !==
+                    executionStageShape(nextExecutionPolicy);
+            const agentAuthoredStageHandoff = stageHandoffChangesAssignee &&
+                (stagesAuthoredInRequest ||
+                    (!stageWorkflowAlreadyRunning &&
+                        (await executionStageParticipantsAuthoredByAgent({
+                            companyId: existing.companyId,
+                            issueId: existing.id,
+                            createdByAgentId: existing.createdByAgentId,
+                            policy: nextExecutionPolicy,
+                        }))));
+            if (agentAuthoredStageHandoff) {
+                throw unprocessable(AGENT_REVIEW_HANDOFF_REQUIRES_SUBTASK_MESSAGE, {
+                    code: "agent_review_handoff_requires_subtask",
+                    issueId: existing.id,
+                });
+            }
+        }
         const nextStatus = updateFields.status ?? existing.status;
         if (updateFields.unblockDescriptor && nextStatus !== "blocked") {
             throw unprocessable("unblockDescriptor requires blocked status");
@@ -9605,6 +9709,9 @@ export function issueRoutes(db, storage, opts = {}) {
             actorAgentId: actor.agentId,
             actorRunId: actor.runId,
             reviewInteractionId: requestedReviewInteractionId,
+            requestedBlockerIssueIds: Array.isArray(req.body.blockedByIssueIds)
+                ? [...new Set(req.body.blockedByIssueIds)]
+                : null,
         });
         const enteringReviewRequested = existing.status !== "in_review" && updateFields.status === "in_review";
         const persistReviewActivityTransactionally = enteringReviewRequested || Boolean(reviewInteractionId);
@@ -9698,6 +9805,36 @@ export function issueRoutes(db, storage, opts = {}) {
                 code: "interaction_response_queued",
             });
         }
+        const agentActsOnOwnTask = actor.actorType === "agent" &&
+            !!actor.agentId &&
+            !transition.workflowControlledAssignment;
+        const requestedAssigneeAgentIdChanged = normalizedAssigneeAgentId !== undefined &&
+            normalizedAssigneeAgentId !== existing.assigneeAgentId;
+        const requestedAssigneeUserIdChanged = req.body.assigneeUserId !== undefined &&
+            req.body.assigneeUserId !== existing.assigneeUserId;
+        const agentRequestedOwnTaskAssigneeChange = agentActsOnOwnTask &&
+            existing.assigneeAgentId === actor.agentId &&
+            (requestedAssigneeAgentIdChanged || requestedAssigneeUserIdChanged);
+        const agentRequestedHandoffOnIssueItReleased = agentActsOnOwnTask &&
+            !existing.assigneeAgentId &&
+            !existing.assigneeUserId &&
+            ((typeof normalizedAssigneeAgentId === "string" &&
+                normalizedAssigneeAgentId !== actor.agentId) ||
+                (typeof req.body.assigneeUserId === "string" &&
+                    req.body.assigneeUserId !== existing.createdByUserId)) &&
+            (await agentReleasedIssue({
+                companyId: existing.companyId,
+                issueId: existing.id,
+                agentId: actor.agentId,
+            }));
+        if ((agentRequestedOwnTaskAssigneeChange ||
+            agentRequestedHandoffOnIssueItReleased) &&
+            !isAgentReturningIssueToCreator) {
+            throw unprocessable(AGENT_REASSIGN_REQUIRES_SUBTASK_MESSAGE, {
+                code: "agent_reassign_requires_subtask",
+                issueId: existing.id,
+            });
+        }
         if (assigneeWillChange && !transition.workflowControlledAssignment) {
             if (!isAgentReturningIssueToCreator) {
                 await assertCanAssignTasks(req, existing.companyId, {