@agent-native/core 0.100.2 → 0.101.3

package/dist/review/actions/send-review-thread-to-agent.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { defineAction } from "../../action.js";
+import { assertReviewableResourceAccess } from "../registry.js";
+import { sendReviewThreadToAgent } from "../store.js";
+const schema = z.object({
+    resourceType: z.string().min(1),
+    resourceId: z.string().min(1),
+    threadId: z.string().min(1),
+});
+export default defineAction({
+    description: "Send one open review thread to the agent queue without routing other threads.",
+    schema,
+    run: async (args, ctx) => {
+        const actionCtx = ctx;
+        const access = await assertReviewableResourceAccess(args.resourceType, args.resourceId, actionCtx, "editor");
+        const updatedCount = await sendReviewThreadToAgent(args.threadId, {
+            resourceType: args.resourceType,
+            resourceId: args.resourceId,
+        });
+        if (updatedCount < 1) {
+            throw new Error("Open review thread not found");
+        }
+        return {
+            resourceType: args.resourceType,
+            resourceId: args.resourceId,
+            threadId: args.threadId,
+            resolutionTarget: "agent",
+            consumedAt: null,
+            updatedCount,
+            ownerEmail: access.ownerEmail ?? actionCtx?.userEmail ?? null,
+            orgId: access.orgId ?? actionCtx?.orgId ?? null,
+            visibility: access.visibility ?? "private",
+        };
+    },
+    audit: {
+        target: (args, result) => {
+            const routed = result;
+            return {
+                type: args.resourceType,
+                id: args.resourceId,
+                ownerEmail: routed.ownerEmail,
+                orgId: routed.orgId,
+                visibility: routed.visibility,
+            };
+        },
+        summary: (args) => `Sent review thread ${args.threadId} to the agent`,
+    },
+});
+//# sourceMappingURL=send-review-thread-to-agent.js.map

package/dist/review/actions/send-review-thread-to-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-review-thread-to-agent.js","sourceRoot":"","sources":["../../../src/review/actions/send-review-thread-to-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAGtD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AAEH,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,+EAA+E;IACjF,MAAM;IACN,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,SAAS,GAAG,GAAwC,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,8BAA8B,CACjD,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,UAAU,EACf,SAAS,EACT,QAAQ,CACT,CAAC;QACF,MAAM,YAAY,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,QAAQ,EAAE;YAChE,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;QACH,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QACD,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,gBAAgB,EAAE,OAAgB;YAClC,UAAU,EAAE,IAAI;YAChB,YAAY;YACZ,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS,EAAE,SAAS,IAAI,IAAI;YAC7D,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS,EAAE,KAAK,IAAI,IAAI;YAC/C,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;SAC3C,CAAC;IACJ,CAAC;IACD,KAAK,EAAE;QACL,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,MAId,CAAC;YACF,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,YAAY;gBACvB,EAAE,EAAE,IAAI,CAAC,UAAU;gBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,IAAI,CAAC,QAAQ,eAAe;KACtE;CACF,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../action.js\";\nimport { assertReviewableResourceAccess } from \"../registry.js\";\nimport { sendReviewThreadToAgent } from \"../store.js\";\nimport type { ReviewResourceContext } from \"../types.js\";\n\nconst schema = z.object({\n  resourceType: z.string().min(1),\n  resourceId: z.string().min(1),\n  threadId: z.string().min(1),\n});\n\nexport default defineAction({\n  description:\n    \"Send one open review thread to the agent queue without routing other threads.\",\n  schema,\n  run: async (args, ctx) => {\n    const actionCtx = ctx as ReviewResourceContext | undefined;\n    const access = await assertReviewableResourceAccess(\n      args.resourceType,\n      args.resourceId,\n      actionCtx,\n      \"editor\",\n    );\n    const updatedCount = await sendReviewThreadToAgent(args.threadId, {\n      resourceType: args.resourceType,\n      resourceId: args.resourceId,\n    });\n    if (updatedCount < 1) {\n      throw new Error(\"Open review thread not found\");\n    }\n    return {\n      resourceType: args.resourceType,\n      resourceId: args.resourceId,\n      threadId: args.threadId,\n      resolutionTarget: \"agent\" as const,\n      consumedAt: null,\n      updatedCount,\n      ownerEmail: access.ownerEmail ?? actionCtx?.userEmail ?? null,\n      orgId: access.orgId ?? actionCtx?.orgId ?? null,\n      visibility: access.visibility ?? \"private\",\n    };\n  },\n  audit: {\n    target: (args, result) => {\n      const routed = result as {\n        ownerEmail?: string | null;\n        orgId?: string | null;\n        visibility?: \"private\" | \"org\" | \"public\";\n      };\n      return {\n        type: args.resourceType,\n        id: args.resourceId,\n        ownerEmail: routed.ownerEmail,\n        orgId: routed.orgId,\n        visibility: routed.visibility,\n      };\n    },\n    summary: (args) => `Sent review thread ${args.threadId} to the agent`,\n  },\n});\n"]}

package/dist/review/identity.d.ts

@@ -0,0 +1,6 @@
+import type { ReviewComment, ReviewResourceAccess, ReviewResourceContext, ReviewStatusEntry } from "./types.js";
+export declare function reviewAuthorNameFromContext(ctx: ReviewResourceContext | undefined): string | null;
+export declare function shouldRedactReviewIdentity(ctx: ReviewResourceContext | undefined, access: Pick<ReviewResourceAccess, "role" | "visibility">): boolean;
+export declare function redactPublicReviewCommentIdentity(comment: ReviewComment): ReviewComment;
+export declare function redactPublicReviewStatusIdentity(status: ReviewStatusEntry | null): ReviewStatusEntry | null;
+//# sourceMappingURL=identity.d.ts.map

package/dist/review/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/review/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,qBAAqB,GAAG,SAAS,GACrC,MAAM,GAAG,IAAI,CAMf;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,qBAAqB,GAAG,SAAS,EACtC,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,YAAY,CAAC,GACxD,OAAO,CAKT;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,aAAa,GACrB,aAAa,CAcf;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAC/B,iBAAiB,GAAG,IAAI,CAU1B"}

package/dist/review/identity.js

@@ -0,0 +1,68 @@
+export function reviewAuthorNameFromContext(ctx) {
+    const value = ctx?.userName;
+    if (typeof value !== "string")
+        return null;
+    const name = value.trim();
+    if (!name || /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(name))
+        return null;
+    return name;
+}
+export function shouldRedactReviewIdentity(ctx, access) {
+    return (!ctx?.userEmail ||
+        (access.visibility === "public" && access.role === "viewer"));
+}
+export function redactPublicReviewCommentIdentity(comment) {
+    return {
+        ...comment,
+        authorEmail: null,
+        authorName: safeReviewDisplayName(comment.authorName),
+        mentions: comment.mentions.map((mention) => ({
+            label: safeReviewDisplayName(mention.label) ?? "Mentioned user",
+        })),
+        ownerEmail: null,
+        orgId: null,
+        resolvedBy: null,
+        deletedBy: null,
+        metadata: redactPublicReviewMetadata(comment.metadata),
+    };
+}
+export function redactPublicReviewStatusIdentity(status) {
+    return status
+        ? {
+            ...status,
+            updatedBy: null,
+            ownerEmail: null,
+            orgId: null,
+            metadata: redactPublicReviewMetadata(status.metadata),
+        }
+        : null;
+}
+function safeReviewDisplayName(value) {
+    const name = value?.trim();
+    if (!name || /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(name)) {
+        return null;
+    }
+    return name;
+}
+function redactPublicReviewMetadata(metadata) {
+    if (!metadata) {
+        return null;
+    }
+    return Object.fromEntries(Object.entries(metadata).flatMap(([key, value]) => /^(authorEmail|ownerEmail|orgId|updatedBy|resolvedBy|deletedBy|email|userEmail|userId)$/i.test(key)
+        ? []
+        : [[key, redactPublicReviewMetadataValue(value)]]));
+}
+function redactPublicReviewMetadataValue(value) {
+    if (Array.isArray(value)) {
+        return value.map(redactPublicReviewMetadataValue);
+    }
+    if (typeof value === "object" && value !== null) {
+        return redactPublicReviewMetadata(value);
+    }
+    if (typeof value === "string" &&
+        /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value.trim())) {
+        return null;
+    }
+    return value;
+}
+//# sourceMappingURL=identity.js.map

package/dist/review/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/review/identity.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,2BAA2B,CACzC,GAAsC;IAEtC,MAAM,KAAK,GAAG,GAAG,EAAE,QAAQ,CAAC;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,CAAC,IAAI,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,GAAsC,EACtC,MAAyD;IAEzD,OAAO,CACL,CAAC,GAAG,EAAE,SAAS;QACf,CAAC,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,OAAsB;IAEtB,OAAO;QACL,GAAG,OAAO;QACV,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,qBAAqB,CAAC,OAAO,CAAC,UAAU,CAAC;QACrD,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC3C,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,gBAAgB;SAChE,CAAC,CAAC;QACH,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,0BAA0B,CAAC,OAAO,CAAC,QAAQ,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,MAAgC;IAEhC,OAAO,MAAM;QACX,CAAC,CAAC;YACE,GAAG,MAAM;YACT,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,0BAA0B,CAAC,MAAM,CAAC,QAAQ,CAAC;SACtD;QACH,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAgC;IAEhC,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,IAAI,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,0BAA0B,CACjC,QAAwC;IAExC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAChD,yFAAyF,CAAC,IAAI,CAC5F,GAAG,CACJ;QACC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,+BAA+B,CAAC,KAAK,CAAC,CAAC,CAAC,CACpD,CACF,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CAAC,KAAc;IACrD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,0BAA0B,CAAC,KAAgC,CAAC,CAAC;IACtE,CAAC;IACD,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAC/C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import type {\n  ReviewComment,\n  ReviewResourceAccess,\n  ReviewResourceContext,\n  ReviewStatusEntry,\n} from \"./types.js\";\n\nexport function reviewAuthorNameFromContext(\n  ctx: ReviewResourceContext | undefined,\n): string | null {\n  const value = ctx?.userName;\n  if (typeof value !== \"string\") return null;\n  const name = value.trim();\n  if (!name || /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(name)) return null;\n  return name;\n}\n\nexport function shouldRedactReviewIdentity(\n  ctx: ReviewResourceContext | undefined,\n  access: Pick<ReviewResourceAccess, \"role\" | \"visibility\">,\n): boolean {\n  return (\n    !ctx?.userEmail ||\n    (access.visibility === \"public\" && access.role === \"viewer\")\n  );\n}\n\nexport function redactPublicReviewCommentIdentity(\n  comment: ReviewComment,\n): ReviewComment {\n  return {\n    ...comment,\n    authorEmail: null,\n    authorName: safeReviewDisplayName(comment.authorName),\n    mentions: comment.mentions.map((mention) => ({\n      label: safeReviewDisplayName(mention.label) ?? \"Mentioned user\",\n    })),\n    ownerEmail: null,\n    orgId: null,\n    resolvedBy: null,\n    deletedBy: null,\n    metadata: redactPublicReviewMetadata(comment.metadata),\n  };\n}\n\nexport function redactPublicReviewStatusIdentity(\n  status: ReviewStatusEntry | null,\n): ReviewStatusEntry | null {\n  return status\n    ? {\n        ...status,\n        updatedBy: null,\n        ownerEmail: null,\n        orgId: null,\n        metadata: redactPublicReviewMetadata(status.metadata),\n      }\n    : null;\n}\n\nfunction safeReviewDisplayName(\n  value: string | null | undefined,\n): string | null {\n  const name = value?.trim();\n  if (!name || /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(name)) {\n    return null;\n  }\n  return name;\n}\n\nfunction redactPublicReviewMetadata(\n  metadata: Record<string, unknown> | null,\n): Record<string, unknown> | null {\n  if (!metadata) {\n    return null;\n  }\n  return Object.fromEntries(\n    Object.entries(metadata).flatMap(([key, value]) =>\n      /^(authorEmail|ownerEmail|orgId|updatedBy|resolvedBy|deletedBy|email|userEmail|userId)$/i.test(\n        key,\n      )\n        ? []\n        : [[key, redactPublicReviewMetadataValue(value)]],\n    ),\n  );\n}\n\nfunction redactPublicReviewMetadataValue(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map(redactPublicReviewMetadataValue);\n  }\n  if (typeof value === \"object\" && value !== null) {\n    return redactPublicReviewMetadata(value as Record<string, unknown>);\n  }\n  if (\n    typeof value === \"string\" &&\n    /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value.trim())\n  ) {\n    return null;\n  }\n  return value;\n}\n"]}

package/dist/review/index.d.ts

@@ -1,5 +1,7 @@
 export type { ReviewActorKind, ReviewComment, ReviewCommentKind, ReviewCommentStatus, ReviewMention, ReviewResolutionTarget, ReviewResourceAccess, ReviewResourceContext, ReviewResourceRole, ReviewScope, ReviewStatus, ReviewStatusEntry, ReviewableResourceRegistration, } from "./types.js";
+export { redactPublicReviewCommentIdentity, redactPublicReviewStatusIdentity, reviewAuthorNameFromContext, shouldRedactReviewIdentity, } from "./identity.js";
 export { extractReviewMentions, normalizeReviewMentions } from "./mentions.js";
 export { __resetReviewableResourcesForTests, assertReviewableResourceAccess, getReviewableResource, listReviewableResources, registerReviewableResource, resolveReviewableResourceAccess, } from "./registry.js";
-export { __resetReviewInitForTests, ensureReviewTables, getReviewCommentById, getReviewStatus, queryReviewComments, } from "./store.js";
+export { __resetReviewInitForTests, ensureReviewTables, getReviewCommentById, getReviewStatus, getReviewThreadSummary, getReviewThreadRoot, queryReviewComments, routeReviewThread, sendReviewThreadToAgent, } from "./store.js";
+export type { GetReviewThreadSummaryInput, ReviewThreadSummary, } from "./store.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/review/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/review/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EACL,kCAAkC,EAClC,8BAA8B,EAC9B,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/review/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iCAAiC,EACjC,gCAAgC,EAChC,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EACL,kCAAkC,EAClC,8BAA8B,EAC9B,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/review/index.js

@@ -1,4 +1,5 @@
+export { redactPublicReviewCommentIdentity, redactPublicReviewStatusIdentity, reviewAuthorNameFromContext, shouldRedactReviewIdentity, } from "./identity.js";
 export { extractReviewMentions, normalizeReviewMentions } from "./mentions.js";
 export { __resetReviewableResourcesForTests, assertReviewableResourceAccess, getReviewableResource, listReviewableResources, registerReviewableResource, resolveReviewableResourceAccess, } from "./registry.js";
-export { __resetReviewInitForTests, ensureReviewTables, getReviewCommentById, getReviewStatus, queryReviewComments, } from "./store.js";
+export { __resetReviewInitForTests, ensureReviewTables, getReviewCommentById, getReviewStatus, getReviewThreadSummary, getReviewThreadRoot, queryReviewComments, routeReviewThread, sendReviewThreadToAgent, } from "./store.js";
 //# sourceMappingURL=index.js.map

package/dist/review/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/review/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EACL,kCAAkC,EAClC,8BAA8B,EAC9B,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC","sourcesContent":["export type {\n  ReviewActorKind,\n  ReviewComment,\n  ReviewCommentKind,\n  ReviewCommentStatus,\n  ReviewMention,\n  ReviewResolutionTarget,\n  ReviewResourceAccess,\n  ReviewResourceContext,\n  ReviewResourceRole,\n  ReviewScope,\n  ReviewStatus,\n  ReviewStatusEntry,\n  ReviewableResourceRegistration,\n} from \"./types.js\";\nexport { extractReviewMentions, normalizeReviewMentions } from \"./mentions.js\";\nexport {\n  __resetReviewableResourcesForTests,\n  assertReviewableResourceAccess,\n  getReviewableResource,\n  listReviewableResources,\n  registerReviewableResource,\n  resolveReviewableResourceAccess,\n} from \"./registry.js\";\nexport {\n  __resetReviewInitForTests,\n  ensureReviewTables,\n  getReviewCommentById,\n  getReviewStatus,\n  queryReviewComments,\n} from \"./store.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/review/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,iCAAiC,EACjC,gCAAgC,EAChC,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EACL,kCAAkC,EAClC,8BAA8B,EAC9B,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,YAAY,CAAC","sourcesContent":["export type {\n  ReviewActorKind,\n  ReviewComment,\n  ReviewCommentKind,\n  ReviewCommentStatus,\n  ReviewMention,\n  ReviewResolutionTarget,\n  ReviewResourceAccess,\n  ReviewResourceContext,\n  ReviewResourceRole,\n  ReviewScope,\n  ReviewStatus,\n  ReviewStatusEntry,\n  ReviewableResourceRegistration,\n} from \"./types.js\";\nexport {\n  redactPublicReviewCommentIdentity,\n  redactPublicReviewStatusIdentity,\n  reviewAuthorNameFromContext,\n  shouldRedactReviewIdentity,\n} from \"./identity.js\";\nexport { extractReviewMentions, normalizeReviewMentions } from \"./mentions.js\";\nexport {\n  __resetReviewableResourcesForTests,\n  assertReviewableResourceAccess,\n  getReviewableResource,\n  listReviewableResources,\n  registerReviewableResource,\n  resolveReviewableResourceAccess,\n} from \"./registry.js\";\nexport {\n  __resetReviewInitForTests,\n  ensureReviewTables,\n  getReviewCommentById,\n  getReviewStatus,\n  getReviewThreadSummary,\n  getReviewThreadRoot,\n  queryReviewComments,\n  routeReviewThread,\n  sendReviewThreadToAgent,\n} from \"./store.js\";\nexport type {\n  GetReviewThreadSummaryInput,\n  ReviewThreadSummary,\n} from \"./store.js\";\n"]}

package/dist/review/store.d.ts

@@ -27,8 +27,22 @@ export interface QueryReviewCommentsInput {
     includeResolved?: boolean;
     includeDeleted?: boolean;
     targetId?: string | null;
+    rootOnly?: boolean;
+    resolutionTargets?: readonly (ReviewResolutionTarget | null)[];
+    unconsumedOnly?: boolean;
     limit?: number;
 }
+export interface GetReviewThreadSummaryInput {
+    resourceType: string;
+    resourceId: string;
+    scope: ReviewScope;
+    bypassScope?: boolean;
+    targetId?: string | null;
+}
+export interface ReviewThreadSummary {
+    openCount: number;
+    agentQueueCount: number;
+}
 export interface UpsertReviewStatusInput {
     resourceType: string;
     resourceId: string;
@@ -42,13 +56,35 @@ export interface UpsertReviewStatusInput {
 }
 export declare function ensureReviewTables(): Promise<void>;
 export declare function insertReviewComment(input: InsertReviewCommentInput): Promise<ReviewComment>;
+export declare function insertReviewReply(input: InsertReviewCommentInput & {
+    threadId: string;
+    parentCommentId: string;
+}, routeTarget: ReviewResolutionTarget | null, resource: {
+    resourceType: string;
+    resourceId: string;
+}): Promise<ReviewComment>;
 export declare function queryReviewComments(input: QueryReviewCommentsInput): Promise<ReviewComment[]>;
+export declare function getReviewThreadSummary(input: GetReviewThreadSummaryInput): Promise<ReviewThreadSummary>;
 export declare function getReviewCommentById(id: string, scope: ReviewScope, options?: {
     bypassScope?: boolean;
 }): Promise<ReviewComment | null>;
+export declare function getReviewThreadRoot(threadId: string, resource: {
+    resourceType: string;
+    resourceId: string;
+}, scope: ReviewScope, options?: {
+    bypassScope?: boolean;
+}): Promise<ReviewComment | null>;
 export declare function resolveReviewThread(threadId: string, resolvedBy?: string | null, resource?: {
     resourceType: string;
     resourceId: string;
+}, resolutionNote?: string): Promise<number>;
+export declare function routeReviewThread(threadId: string, resolutionTarget: ReviewResolutionTarget, resource: {
+    resourceType: string;
+    resourceId: string;
+}): Promise<number>;
+export declare function sendReviewThreadToAgent(threadId: string, resource: {
+    resourceType: string;
+    resourceId: string;
 }): Promise<number>;
 export declare function deleteReviewComment(id: string, deletedBy?: string | null): Promise<number>;
 export declare function consumeReviewFeedback(ids: string[], consumedAt?: string, resource?: {

package/dist/review/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/review/store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/review/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EAEjB,aAAa,EACb,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,gBAAgB,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,SAAS,CAAC,sBAAsB,GAAG,IAAI,CAAC,EAAE,CAAC;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CA6FxD;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAGxB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,wBAAwB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB,EACD,WAAW,EAAE,sBAAsB,GAAG,IAAI,EAC1C,QAAQ,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CAAC,aAAa,CAAC,CAsCxB;AA0GD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,aAAa,EAAE,CAAC,CAgF1B;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,mBAAmB,CAAC,CA0C9B;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAe/B;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EACtD,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAmB/B;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,EAC1B,QAAQ,CAAC,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EACvD,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAgED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,sBAAsB,EACxC,QAAQ,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CAAC,MAAM,CAAC,CAQjB;AAgCD,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,EACV,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EAAE,EACb,UAAU,SAA2B,EACrC,QAAQ,CAAC,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAkF5B;AAED,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAenC;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/review/store.js

@@ -55,6 +55,15 @@ export async function ensureReviewTables() {
            ON agent_review_comments (owner_email, created_at)`,
                 `CREATE INDEX IF NOT EXISTS idx_agent_review_comments_org
            ON agent_review_comments (org_id, created_at)`,
+                `CREATE INDEX IF NOT EXISTS idx_agent_review_comments_queue
+           ON agent_review_comments (
+             resource_type,
+             resource_id,
+             parent_comment_id,
+             resolution_target,
+             consumed_at,
+             created_at
+           )`,
                 `CREATE INDEX IF NOT EXISTS idx_agent_review_statuses_resource
            ON agent_review_statuses (resource_type, resource_id)`,
             ];
@@ -65,7 +74,8 @@ export async function ensureReviewTables() {
                 await ensureIndexExists("idx_agent_review_comments_thread", indexes[1]);
                 await ensureIndexExists("idx_agent_review_comments_owner", indexes[2]);
                 await ensureIndexExists("idx_agent_review_comments_org", indexes[3]);
-                await ensureIndexExists("idx_agent_review_statuses_resource", indexes[4]);
+                await ensureIndexExists("idx_agent_review_comments_queue", indexes[4]);
+                await ensureIndexExists("idx_agent_review_statuses_resource", indexes[5]);
             }
             else {
                 await client.execute(createCommentsSql);
@@ -79,8 +89,42 @@ export async function ensureReviewTables() {
     await reviewTablesInitPromise;
 }
 export async function insertReviewComment(input) {
+    await ensureReviewTables();
+    return insertReviewCommentWithClient(input, getDbExec());
+}
+export async function insertReviewReply(input, routeTarget, resource) {
     await ensureReviewTables();
     const client = getDbExec();
+    const insertAndRoute = async (tx) => {
+        if (routeTarget) {
+            const routedCount = await routeReviewThreadWithClient(tx, input.threadId, routeTarget, resource);
+            if (routedCount < 1) {
+                throw new Error("Open review thread not found");
+            }
+        }
+        return insertReviewCommentWithClient(input, tx);
+    };
+    if (client.transaction)
+        return client.transaction(insertAndRoute);
+    const reply = await insertReviewCommentWithClient(input, client);
+    if (!routeTarget)
+        return reply;
+    try {
+        const routedCount = await routeReviewThreadWithClient(client, input.threadId, routeTarget, resource);
+        if (routedCount < 1)
+            throw new Error("Open review thread not found");
+        return reply;
+    }
+    catch (error) {
+        await client.execute({
+            sql: `DELETE FROM agent_review_comments
+             WHERE id = ? AND resource_type = ? AND resource_id = ?`,
+            args: [reply.id, resource.resourceType, resource.resourceId],
+        });
+        throw error;
+    }
+}
+async function insertReviewCommentWithClient(input, client) {
     const id = createReviewId("comment");
     const now = new Date().toISOString();
     const comment = {
@@ -112,6 +156,9 @@ export async function insertReviewComment(input) {
         createdAt: now,
         updatedAt: now,
         metadata: input.metadata ?? null,
+        resolutionNote: typeof input.metadata?.resolutionNote === "string"
+            ? input.metadata.resolutionNote
+            : null,
     };
     await client.execute({
         sql: `INSERT INTO agent_review_comments (
@@ -201,16 +248,93 @@ export async function queryReviewComments(input) {
             filterParams.push(input.targetId);
         }
     }
+    if (input.rootOnly) {
+        filters.push("parent_comment_id IS NULL");
+    }
+    if (input.unconsumedOnly) {
+        filters.push("consumed_at IS NULL");
+    }
+    if (input.resolutionTargets !== undefined) {
+        const targets = Array.from(new Set(input.resolutionTargets.filter((target) => target !== null)));
+        const resolutionFilters = [];
+        if (targets.length > 0) {
+            resolutionFilters.push(`resolution_target IN (${targets.map(() => "?").join(", ")})`);
+            filterParams.push(...targets);
+        }
+        if (input.resolutionTargets.includes(null)) {
+            resolutionFilters.push("resolution_target IS NULL");
+        }
+        filters.push(resolutionFilters.length > 0
+            ? `(${resolutionFilters.join(" OR ")})`
+            : "1 = 0");
+    }
+    const selectSql = input.rootOnly
+        ? `SELECT ${commentColumns()}
+         FROM (
+           SELECT ${commentColumns()},
+                  ROW_NUMBER() OVER (
+                    PARTITION BY thread_id
+                    ORDER BY created_at ASC, id ASC
+                  ) AS review_thread_rank
+             FROM agent_review_comments
+            WHERE ${filters.join(" AND ")}
+         ) AS distinct_review_threads
+        WHERE review_thread_rank = 1`
+        : `SELECT ${commentColumns()}
+         FROM agent_review_comments
+        WHERE ${filters.join(" AND ")}`;
     const result = await client.execute({
-        sql: `SELECT ${commentColumns()}
-       FROM agent_review_comments
-      WHERE ${filters.join(" AND ")}
-      ORDER BY created_at ASC
+        sql: `${selectSql}
+      ORDER BY created_at ASC${input.rootOnly ? ", id ASC" : ""}
       LIMIT ?`,
         args: [...filterParams, clampLimit(input.limit)],
     });
     return (result.rows ?? []).map(mapCommentRow);
 }
+export async function getReviewThreadSummary(input) {
+    await ensureReviewTables();
+    const { clause, params } = input.bypassScope
+        ? { clause: "1 = 1", params: [] }
+        : scopedReviewClause(input.scope);
+    const filters = [
+        "resource_type = ?",
+        "resource_id = ?",
+        clause,
+        "parent_comment_id IS NULL",
+        "deleted_at IS NULL",
+        "status = 'open'",
+    ];
+    const filterParams = [
+        input.resourceType,
+        input.resourceId,
+        ...params,
+    ];
+    if (input.targetId !== undefined) {
+        if (input.targetId === null) {
+            filters.push("target_id IS NULL");
+        }
+        else {
+            filters.push("target_id = ?");
+            filterParams.push(input.targetId);
+        }
+    }
+    const result = await getDbExec().execute({
+        sql: `SELECT COUNT(DISTINCT thread_id) AS open_count,
+                 COUNT(DISTINCT CASE
+                   WHEN (resolution_target IS NULL OR resolution_target <> 'human')
+                    AND consumed_at IS NULL
+                   THEN thread_id
+                 END) AS agent_queue_count
+            FROM agent_review_comments
+           WHERE ${filters.join(" AND ")}`,
+        args: filterParams,
+    });
+    const row = result.rows?.[0];
+    return {
+        openCount: Number(row?.open_count ?? 0),
+        agentQueueCount: Number(row?.agent_queue_count ?? 0),
+    };
+}
 export async function getReviewCommentById(id, scope, options = {}) {
     await ensureReviewTables();
     const client = getDbExec();
@@ -227,29 +351,116 @@ export async function getReviewCommentById(id, scope, options = {}) {
     const row = result.rows?.[0];
     return row ? mapCommentRow(row) : null;
 }
-export async function resolveReviewThread(threadId, resolvedBy, resource) {
+export async function getReviewThreadRoot(threadId, resource, scope, options = {}) {
+    await ensureReviewTables();
+    const { clause, params } = options.bypassScope
+        ? { clause: "1 = 1", params: [] }
+        : scopedReviewClause(scope);
+    const result = await getDbExec().execute({
+        sql: `SELECT ${commentColumns()}
+       FROM agent_review_comments
+      WHERE thread_id = ?
+        AND resource_type = ?
+        AND resource_id = ?
+        AND parent_comment_id IS NULL
+        AND ${clause}
+      ORDER BY created_at ASC, id ASC
+      LIMIT 1`,
+        args: [threadId, resource.resourceType, resource.resourceId, ...params],
+    });
+    const row = result.rows?.[0];
+    return row ? mapCommentRow(row) : null;
+}
+export async function resolveReviewThread(threadId, resolvedBy, resource, resolutionNote) {
     await ensureReviewTables();
+    const client = getDbExec();
+    const resolve = (tx) => resolveReviewThreadWithClient(tx, threadId, resolvedBy, resource, resolutionNote);
+    return client.transaction ? client.transaction(resolve) : resolve(client);
+}
+async function resolveReviewThreadWithClient(client, threadId, resolvedBy, resource, resolutionNote) {
     const now = new Date().toISOString();
     const resourceClause = resource
         ? "AND resource_type = ? AND resource_id = ?"
         : "";
-    const result = await getDbExec().execute({
+    let rootMetadata = null;
+    if (resolutionNote !== undefined) {
+        const root = await client.execute({
+            sql: `SELECT metadata_json
+         FROM agent_review_comments
+        WHERE thread_id = ?
+          AND parent_comment_id IS NULL
+          AND deleted_at IS NULL
+          ${resourceClause}
+        ORDER BY created_at ASC, id ASC
+        LIMIT 1`,
+            args: [
+                threadId,
+                ...(resource ? [resource.resourceType, resource.resourceId] : []),
+            ],
+        });
+        if (!root.rows?.[0]) {
+            return 0;
+        }
+        rootMetadata = {
+            ...(parseObject(root.rows[0].metadata_json) ?? {}),
+            resolutionNote,
+        };
+    }
+    const metadataAssignment = resolutionNote === undefined
+        ? ""
+        : ", metadata_json = CASE WHEN parent_comment_id IS NULL THEN ? ELSE metadata_json END";
+    const result = await client.execute({
         sql: `UPDATE agent_review_comments
         SET status = 'resolved',
             resolved_by = ?,
             resolved_at = ?,
             updated_at = ?
+            ${metadataAssignment}
       WHERE thread_id = ? AND deleted_at IS NULL ${resourceClause}`,
         args: [
             resolvedBy ?? null,
             now,
             now,
+            ...(resolutionNote === undefined
+                ? []
+                : [stringifyOptionalJson(rootMetadata)]),
             threadId,
             ...(resource ? [resource.resourceType, resource.resourceId] : []),
         ],
     });
     return result.rowsAffected ?? 0;
 }
+export async function routeReviewThread(threadId, resolutionTarget, resource) {
+    await ensureReviewTables();
+    return routeReviewThreadWithClient(getDbExec(), threadId, resolutionTarget, resource);
+}
+async function routeReviewThreadWithClient(client, threadId, resolutionTarget, resource) {
+    const now = new Date().toISOString();
+    const result = await client.execute({
+        sql: `UPDATE agent_review_comments
+        SET resolution_target = ?,
+            consumed_at = CASE WHEN ? = 'agent' THEN NULL ELSE consumed_at END,
+            updated_at = ?
+      WHERE thread_id = ?
+        AND resource_type = ?
+        AND resource_id = ?
+        AND parent_comment_id IS NULL
+        AND status = 'open'
+        AND deleted_at IS NULL`,
+        args: [
+            resolutionTarget,
+            resolutionTarget,
+            now,
+            threadId,
+            resource.resourceType,
+            resource.resourceId,
+        ],
+    });
+    return result.rowsAffected ?? 0;
+}
+export async function sendReviewThreadToAgent(threadId, resource) {
+    return routeReviewThread(threadId, "agent", resource);
+}
 export async function deleteReviewComment(id, deletedBy) {
     await ensureReviewTables();
     const now = new Date().toISOString();
@@ -447,6 +658,7 @@ function scopedReviewClause(scope) {
     return { clause: `(${parts.join(" OR ")})`, params };
 }
 function mapCommentRow(row) {
+    const metadata = parseObject(row.metadata_json);
     return {
         id: String(row.id),
         resourceType: String(row.resource_type),
@@ -473,7 +685,10 @@ function mapCommentRow(row) {
         deletedAt: nullableString(row.deleted_at),
         createdAt: String(row.created_at),
         updatedAt: String(row.updated_at),
-        metadata: parseObject(row.metadata_json),
+        metadata,
+        resolutionNote: typeof metadata?.resolutionNote === "string"
+            ? metadata.resolutionNote
+            : null,
     };
 }
 function mapStatusRow(row) {