fix: address review feedback on billing error handling

- Paginate hasPRCommentWithMarker using octokit.paginate to match the
  GitLab counterpart and avoid duplicate billing notices on busy PRs
- Preserve structured error objects in wrapper fallback via JSON.stringify
  instead of discarding them
- Improve cross-reference comments between the duplicate terminal reason
  type definitions in worker-utils and db packages

Author: alex-alecu

cloud-agent-next/wrapper/src/connection.ts

@@ -370,7 +370,9 @@ export function createConnectionManager(
             const errorText =
               typeof properties.error === 'string'
                 ? properties.error
-                : `Insufficient credits: ${eventType}`;
+                : properties.error
+                  ? JSON.stringify(properties.error)
+                  : `Insufficient credits: ${eventType}`;
             callbacks.onTerminalError(errorText);
             return;
           }

packages/db/src/schema-types.ts

@@ -908,8 +908,9 @@ export type StripeSubscriptionStatus =
 
 /**
  * Valid values for cloud_agent_code_reviews.terminal_reason.
- * Canonical list — keep in sync with CloudAgentTerminalReason in
- * packages/worker-utils/src/cloud-agent-next-client.ts if that copy diverges.
+ * KEEP IN SYNC with CloudAgentTerminalReason in
+ * packages/worker-utils/src/cloud-agent-next-client.ts — both lists must
+ * contain the same literal values.
  */
 export const CODE_REVIEW_TERMINAL_REASONS = [
   'billing',

packages/worker-utils/src/cloud-agent-next-client.ts

@@ -87,7 +87,10 @@ export type CloudAgentInterruptOutput = {
 
 /**
  * Valid terminal reasons for code review failures.
- * Keep in sync with CodeReviewTerminalReason in packages/db/src/schema-types.ts.
+ * KEEP IN SYNC with CODE_REVIEW_TERMINAL_REASONS / CodeReviewTerminalReason
+ * in packages/db/src/schema-types.ts — both lists must contain the same
+ * literal values. A mismatch will cause the orchestrator to send a reason
+ * that normalizePayload rejects via its allowlist check.
  */
 export type CloudAgentTerminalReason =
   | 'billing'

src/lib/integrations/platforms/github/adapter.ts

@@ -304,7 +304,7 @@ export async function hasPRCommentWithMarker(
   const tokenData = await generateGitHubInstallationToken(installationId, appType);
   const octokit = new Octokit({ auth: tokenData.token });
 
-  const { data: comments } = await octokit.issues.listComments({
+  const comments = await octokit.paginate(octokit.issues.listComments, {
     owner,
     repo,
     issue_number: prNumber,