@cursor/july 0.1.108 → 0.1.111

package/templates/demo/agent/channels/github.ts

@@ -6,6 +6,7 @@ import {
   parseGitHubPrRef,
 } from "@cursor/july/channels/github";
 import { startDemo } from "../lib/collect.js";
+import { REPOS } from "../lib/repos.js";
 
 let send: SendMessageFn | undefined;
 
@@ -21,6 +22,7 @@ function wake(url: string, github: GitHubHandle) {
 export default githubChannel({
   botName: "demo-agent",
   webhookEvents: ["pull_request", "issue_comment"],
+  cursorAccount: { repos: REPOS },
   deliverReplies: false,
   onStart: async (args: ChannelStartArgs) => {
     send = args.send;

package/templates/demo/agent/channels/queue.ts

@@ -2,6 +2,7 @@ import { defineChannel, POST } from "@cursor/july/channels";
 import { parseGitHubPrRef } from "@cursor/july/channels/github";
 import { z } from "zod";
 import { startDemo } from "../lib/collect.js";
+import { REPOS, watches } from "../lib/repos.js";
 
 export default defineChannel({
   routes: [
@@ -12,9 +13,12 @@ export default defineChannel({
       }),
       handler: async (_req, { send, host, body }) => {
         const ref = parseGitHubPrRef(body.pr);
-        if (ref === undefined) {
+        if (ref === undefined || !watches(`${ref.owner}/${ref.repo}`)) {
           return Response.json(
-            { ok: false, error: "need a PR URL or owner/repo#N" },
+            {
+              ok: false,
+              error: `need a PR URL or owner/repo#N in ${REPOS.join(", ")}`,
+            },
             { status: 400 }
           );
         }

package/templates/demo/agent/lib/collect.ts

@@ -1,4 +1,8 @@
-import { prompt, type HostGitHubClient, type SendMessageFn } from "@cursor/july";
+import {
+  prompt,
+  type HostGitHubClient,
+  type SendMessageFn,
+} from "@cursor/july";
 import {
   type GitHubPrRef,
   parseGitHubPrRef,
@@ -64,7 +68,7 @@ export async function collectPr(
     ...ref,
     title: pull.data.title,
     body: pull.data.body ?? "",
-    files: listed.data.map((file) => file.filename),
+    files: listed.data.map(file => file.filename),
   };
 }
 

package/templates/demo/agent/lib/repos.ts

@@ -0,0 +1,5 @@
+export const REPOS: readonly string[] = ["owner/repo"];
+
+export function watches(fullName: string): boolean {
+  return REPOS.some(repo => repo.toLowerCase() === fullName.toLowerCase());
+}

package/templates/demo/agent/tools/record_demo.ts

@@ -6,7 +6,7 @@ import { parseToken } from "../lib/collect.js";
 function comment(summary: string, artifacts: string[]): string {
   const lines = ["### Demo", "", summary];
   if (artifacts.length > 0) {
-    lines.push("", ...artifacts.map((path) => `- \`${path}\``));
+    lines.push("", ...artifacts.map(path => `- \`${path}\``));
   }
   return lines.join("\n");
 }

package/templates/demo/evals/demo.eval.ts

@@ -1,9 +1,5 @@
 import { defineEval, includes } from "@cursor/july/evals";
-import {
-  type Collected,
-  filesFor,
-  promptFor,
-} from "../agent/lib/collect.js";
+import { type Collected, filesFor, promptFor } from "../agent/lib/collect.js";
 
 const pr: Collected = {
   owner: "acme",

package/templates/demo/init.json

@@ -0,0 +1,25 @@
+{
+  "questions": [
+    {
+      "id": "repos",
+      "prompt": "Which GitHub repos should this agent record walkthroughs for?",
+      "hint": "Comma-separated owner/repo. One GitHub owner.",
+      "placeholder": "acme/api, acme/web",
+      "parse": "owner-repo-list"
+    }
+  ],
+  "replace": [
+    {
+      "file": "agent/lib/repos.ts",
+      "find": "[\"owner/repo\"]",
+      "answer": "repos",
+      "as": "json-array"
+    },
+    {
+      "file": "README.md",
+      "find": "owner/repo",
+      "answer": "repos",
+      "as": "first"
+    }
+  ]
+}

package/templates/demo/package.json

@@ -13,6 +13,6 @@
   },
   "devDependencies": {
     "@types/node": "^22.14.0",
-    "typescript": "^5.8.0"
+    "typescript": "6.0.3"
   }
 }

package/templates/grokbot-agents/package.json

@@ -12,6 +12,6 @@
   },
   "devDependencies": {
     "@types/node": "^22.14.0",
-    "typescript": "^5.8.0"
+    "typescript": "6.0.3"
   }
 }

package/templates/pr-autofixer/agent/channels/github.ts

@@ -74,17 +74,20 @@ async function flush(event: BufferedWebhookEvent): Promise<void> {
   const continuationToken = continuationTokenFor(pr);
 
   try {
-    const session = await runtime.send(buildGenericPrUpdatePrompt(event.prUrl), {
-      auth: {
-        authenticator: "github-webhook",
-        principalId: "pr-autofixer-webhook",
-        principalType: "service",
-      },
-      continuationToken,
-      title: `PR ${pr.label}`,
-      cloud: cloudOptionsFor(pr),
-      sdkAgentId: bcId,
-    });
+    const session = await runtime.send(
+      buildGenericPrUpdatePrompt(event.prUrl),
+      {
+        auth: {
+          authenticator: "github-webhook",
+          principalId: "pr-autofixer-webhook",
+          principalType: "service",
+        },
+        continuationToken,
+        title: `PR ${pr.label}`,
+        cloud: cloudOptionsFor(pr),
+        sdkAgentId: bcId,
+      }
+    );
     await session.waitForCompletion();
   } catch (error) {
     if (error instanceof SessionBusyError) {
@@ -132,7 +135,7 @@ export default githubChannel({
     return wake(bufferedEventFromPr({ ctx, pr }));
   },
 
-  onComment: (ctx) =>
+  onComment: ctx =>
     wake(bufferedEventFromComment({ ctx, eventName: ctx.eventName })),
 
   onCheckSuite: async (ctx, suite) =>
@@ -146,7 +149,7 @@ export default githubChannel({
 
   onEvent: (ctx, event) => wake(bufferedEventFromRaw({ ctx, event })),
 
-  onStart: async (args) => {
+  onStart: async args => {
     runtime = {
       send: args.send,
       github: args.host.github,

package/templates/pr-autofixer/agent/lib/merge-watch.ts

@@ -111,11 +111,9 @@ export async function cancelRemindersForPr(input: {
     status: "armed",
     purpose: MERGE_CONFLICT_PURPOSE,
   });
-  const matches = armed.filter((rem) =>
-    isMergeConflictWatchForPr(rem, input.pr)
-  );
+  const matches = armed.filter(rem => isMergeConflictWatchForPr(rem, input.pr));
   await Promise.all(
-    matches.map((rem) =>
+    matches.map(rem =>
       input.reminders.cancel(rem.id, input.reason ?? "pr_closed")
     )
   );

package/templates/pr-autofixer/agent/lib/repos.ts

@@ -7,8 +7,8 @@ export function githubRepos(): readonly string[] {
       ? [...GITHUB_REPOS]
       : fromEnv
           .split(",")
-          .map((repo) => repo.trim())
-          .filter((repo) => repo !== "");
+          .map(repo => repo.trim())
+          .filter(repo => repo !== "");
   if (repos.length === 0) {
     throw new Error(
       "Set GITHUB_REPOS in agent/lib/repos.ts or PR_AUTOFIXER_REPOS to a comma-separated owner/repo list."

package/templates/pr-autofixer/agent/lib/webhook-routing.ts

@@ -105,7 +105,7 @@ async function resolvePrFromCommitSha(input: {
         commit_sha: input.sha,
       }
     );
-    const open = pulls.find((pull) => pull.state === "open");
+    const open = pulls.find(pull => pull.state === "open");
     if (open === undefined) {
       return undefined;
     }

package/templates/pr-autofixer/package.json

@@ -13,6 +13,6 @@
   },
   "devDependencies": {
     "@types/node": "^22.14.0",
-    "typescript": "^5.8.0"
+    "typescript": "6.0.3"
   }
 }

package/templates/security-help/agent/lib/repos.ts

@@ -1,5 +1,5 @@
 export const REPOS: readonly string[] = ["owner/repo"];
 
 export function watches(fullName: string): boolean {
-  return REPOS.some((repo) => repo.toLowerCase() === fullName.toLowerCase());
+  return REPOS.some(repo => repo.toLowerCase() === fullName.toLowerCase());
 }

package/templates/security-help/package.json

@@ -12,6 +12,6 @@
   },
   "devDependencies": {
     "@types/node": "^22.14.0",
-    "typescript": "^5.8.0"
+    "typescript": "6.0.3"
   }
 }

package/templates/security-reviewer/agent/lib/repos.ts

@@ -1,5 +1,5 @@
 export const REPOS: readonly string[] = ["owner/repo"];
 
 export function watches(fullName: string): boolean {
-  return REPOS.some((repo) => repo.toLowerCase() === fullName.toLowerCase());
+  return REPOS.some(repo => repo.toLowerCase() === fullName.toLowerCase());
 }

package/templates/security-reviewer/agent/tools/post_findings.ts

@@ -20,9 +20,7 @@ export default defineTool({
   description:
     "Post the security review on this session's pull request. Call once. Empty findings = CLEAN.",
   inputSchema: z.object({
-    findings: z
-      .array(finding)
-      .describe("Exploitable issues. Empty for CLEAN."),
+    findings: z.array(finding).describe("Exploitable issues. Empty for CLEAN."),
   }),
   async execute({ findings }, ctx) {
     if (ctx.session.purpose === "eval") {

package/templates/security-reviewer/package.json

@@ -13,6 +13,6 @@
   },
   "devDependencies": {
     "@types/node": "^22.14.0",
-    "typescript": "^5.8.0"
+    "typescript": "6.0.3"
   }
 }

package/templates/triage/agent/lib/actuate.ts

@@ -33,13 +33,7 @@ const FIELD_ALIASES = {
   query: ["query", "q", "search", "term", "jql", "text"],
   comment: ["comment", "body", "text", "message"],
   issue: ["id", "issueId", "issue_id", "issueKey", "issue_key", "identifier"],
-  commentIssue: [
-    "issueId",
-    "issue_id",
-    "issueKey",
-    "issue_key",
-    "identifier",
-  ],
+  commentIssue: ["issueId", "issue_id", "issueKey", "issue_key", "identifier"],
   priority: ["priority", "priorityId", "priority_id"],
 } as const;
 
@@ -65,7 +59,9 @@ export interface ActuateInput {
   issueTitle?: string | null;
 }
 
-export async function actuate(input: ActuateInput): Promise<RecordTriageResult> {
+export async function actuate(
+  input: ActuateInput
+): Promise<RecordTriageResult> {
   const evaluatedAt = (input.now ?? (() => new Date().toISOString()))();
   const verdict: TriageVerdict = {
     ...input.verdict,
@@ -102,7 +98,7 @@ async function resolveTracker(input: ActuateInput): Promise<TrackerResult> {
     identifier: input.verdict.identifier,
     url: "",
   };
-  const searchTool = tools.find((tool) => SEARCH_ISSUE_TOOL.test(tool.name));
+  const searchTool = tools.find(tool => SEARCH_ISSUE_TOOL.test(tool.name));
   let search: SearchResult = {
     candidates: [],
   };
@@ -127,7 +123,7 @@ async function resolveTracker(input: ActuateInput): Promise<TrackerResult> {
   }
 
   const duplicate = search.duplicate;
-  const commentTool = tools.find((tool) => COMMENT_TOOL.test(tool.name));
+  const commentTool = tools.find(tool => COMMENT_TOOL.test(tool.name));
   if (commentTool === undefined) {
     return {
       status: "failed",
@@ -145,12 +141,7 @@ async function resolveTracker(input: ActuateInput): Promise<TrackerResult> {
   const actions: QueueAction[] = [];
   if (listed.status !== "failed") {
     if (
-      !alreadyCommented(
-        listed,
-        search.candidates,
-        issue.identifier,
-        "Triage:"
-      )
+      !alreadyCommented(listed, search.candidates, issue.identifier, "Triage:")
     ) {
       const comment = await commentOn({
         mcp: input.mcp,
@@ -208,11 +199,7 @@ async function resolveTracker(input: ActuateInput): Promise<TrackerResult> {
       if (!SAVE_OR_UPDATE_ISSUE_TOOL.test(tool.name)) {
         continue;
       }
-      const args = buildPriorityArgs(
-        input.verdict,
-        tool,
-        input.tracker.kind
-      );
+      const args = buildPriorityArgs(input.verdict, tool, input.tracker.kind);
       if (args !== undefined) {
         updateTool = tool;
         updateArgs = args;
@@ -264,7 +251,7 @@ async function resolveHostTitle(input: {
     query: input.identifier,
   });
   const self = listed.find(
-    (candidate) => issueIdentifier(candidate) === input.identifier
+    candidate => issueIdentifier(candidate) === input.identifier
   );
   return self?.title.trim() ?? "";
 }
@@ -325,20 +312,16 @@ async function loadComments(input: {
   tools: HostMcpToolInfo[];
   identifier: string;
 }): Promise<ListedComments> {
-  const tool = input.tools.find((candidate) =>
+  const tool = input.tools.find(candidate =>
     LIST_COMMENT_TOOL.test(candidate.name)
   );
   if (tool === undefined) {
     return { status: "unavailable" };
   }
   try {
-    const result = await input.mcp.callTool(
-      input.connectionName,
-      tool.name,
-      {
-        [pickProperty(tool, FIELD_ALIASES.commentIssue)]: input.identifier,
-      }
-    );
+    const result = await input.mcp.callTool(input.connectionName, tool.name, {
+      [pickProperty(tool, FIELD_ALIASES.commentIssue)]: input.identifier,
+    });
     if (result.isError === true) {
       return { status: "failed" };
     }
@@ -368,7 +351,7 @@ function alreadyCommented(
   prefix: string
 ): boolean {
   if (listed.status === "listed") {
-    return listed.bodies.some((comment) => hasSentinel(comment, prefix));
+    return listed.bodies.some(comment => hasSentinel(comment, prefix));
   }
   return hasCommentStarting(candidates, identifier, prefix);
 }
@@ -446,12 +429,12 @@ function buildPriorityArgs(
   }
   const known = propertyNames(tool);
   const issueProperty =
-    FIELD_ALIASES.issue.find((alias) => known.has(alias)) ??
+    FIELD_ALIASES.issue.find(alias => known.has(alias)) ??
     (UPDATE_ISSUE_TOOL.test(tool.name) ? "id" : undefined);
   if (issueProperty === undefined) {
     return undefined;
   }
-  const priorityProperty = FIELD_ALIASES.priority.find((alias) =>
+  const priorityProperty = FIELD_ALIASES.priority.find(alias =>
     known.has(alias)
   );
   if (priorityProperty === undefined) {
@@ -468,7 +451,7 @@ function pickProperty(
   aliases: readonly string[]
 ): string {
   const known = propertyNames(tool);
-  return aliases.find((alias) => known.has(alias)) ?? aliases[0]!;
+  return aliases.find(alias => known.has(alias)) ?? aliases[0]!;
 }
 
 function propertyNames(tool: HostMcpToolInfo): Set<string> {
@@ -514,7 +497,7 @@ function matchingIssue(
   excludeIdentifier: string
 ): TrackerIssue | undefined {
   const match = candidates.find(
-    (candidate) =>
+    candidate =>
       issueIdentifier(candidate) !== excludeIdentifier &&
       titlesMatch(candidate.title, title)
   );
@@ -575,7 +558,7 @@ function collectIssues(
 }
 
 function issuesFromLines(text: string): CandidateIssue[] {
-  return text.split(/\n/).flatMap((line) => {
+  return text.split(/\n/).flatMap(line => {
     const identifier = line.match(ISSUE_ID)?.[0] ?? "";
     const url = line.match(LINEAR_URL)?.[0] ?? line.match(JIRA_URL)?.[0] ?? "";
     if (identifier === "" && url === "") {
@@ -605,14 +588,14 @@ function hasCommentStarting(
   prefix: string
 ): boolean {
   return candidates.some(
-    (candidate) =>
+    candidate =>
       issueIdentifier(candidate) === identifier &&
-      candidate.comments.some((comment) => hasSentinel(comment, prefix))
+      candidate.comments.some(comment => hasSentinel(comment, prefix))
   );
 }
 
 function hasSentinel(text: string, prefix: string): boolean {
-  return text.split(/\n/).some((line) => {
+  return text.split(/\n/).some(line => {
     const trimmed = line
       .trimStart()
       .replace(/^[-*]\s+/, "")
@@ -744,8 +727,10 @@ function tryParseJson(text: string): unknown {
 
 function resultText(result: HostMcpCallResult): string {
   return result.content
-    .map((part) => ("text" in part && typeof part.text === "string" ? part.text : ""))
-    .filter((part) => part !== "")
+    .map(part =>
+      "text" in part && typeof part.text === "string" ? part.text : ""
+    )
+    .filter(part => part !== "")
     .join("\n")
     .trim();
 }

package/templates/triage/agent/lib/parse-queue-event.ts

@@ -29,7 +29,8 @@ export function pinIssueIdentifier(
 export function isTrackerWebhook(body: unknown): boolean {
   return (
     isRecord(body) &&
-    (typeof body["type"] === "string" || typeof body["webhookEvent"] === "string")
+    (typeof body["type"] === "string" ||
+      typeof body["webhookEvent"] === "string")
   );
 }
 

package/templates/triage/agent/lib/verify-webhook.ts

@@ -2,9 +2,7 @@ import { createHmac, timingSafeEqual } from "node:crypto";
 
 const REPLAY_WINDOW_MS = 60_000;
 
-export type VerifyWebhookResult =
-  | { ok: true }
-  | { ok: false; status: 401 };
+export type VerifyWebhookResult = { ok: true } | { ok: false; status: 401 };
 
 export function verifyTrackerWebhook(input: {
   rawBody: string;
@@ -62,9 +60,16 @@ function linearReplayFresh(
   return { ok: true };
 }
 
-function hmacHexEqual(secret: string, rawBody: string, header: string): boolean {
+function hmacHexEqual(
+  secret: string,
+  rawBody: string,
+  header: string
+): boolean {
   const expected = createHmac("sha256", secret).update(rawBody).digest("hex");
-  const received = header.replace(/^sha256=/i, "").trim().toLowerCase();
+  const received = header
+    .replace(/^sha256=/i, "")
+    .trim()
+    .toLowerCase();
   let expectedBytes: Buffer;
   let receivedBytes: Buffer;
   try {

package/templates/triage/agent/tools/record_triage.ts

@@ -12,10 +12,7 @@ export default defineTool({
       .describe("Identifier of the existing tracker issue."),
     kind: z.enum(["bug", "question", "feedback"]),
     severity: z.enum(["low", "medium", "high", "urgent"]),
-    title: z
-      .string()
-      .max(80)
-      .describe("Short title for the issue."),
+    title: z.string().max(80).describe("Short title for the issue."),
     summary: z
       .string()
       .describe("What the issue says, in two sentences or less."),

package/templates/triage/package.json

@@ -13,6 +13,6 @@
   },
   "devDependencies": {
     "@types/node": "^22.14.0",
-    "typescript": "^5.8.0"
+    "typescript": "6.0.3"
   }
 }