@sideboard-ai/core 0.1.184 → 0.1.186

package/dist/index.d.cts

@@ -2213,13 +2213,10 @@ type LinearAssignedIssuesResult = {
 };
 /** `me`, `unassigned`, `all`, a Linear user id, or a display name. */
 type LinearAssigneeFilter = string;
-/**
- * Linear `IssueFilter` for open issues. Default assignee is `me` so existing
- * Home / Create-from callers stay assigned-to-you unless they ask otherwise.
- */
 declare function buildLinearIssueFilter(input?: {
     assignee?: string | null;
     updatedSince?: string | null;
+    query?: string | null;
 }): Record<string, unknown>;
 /**
  * List or search open Linear issues. `assignee` is `me` (default when there is
@@ -2234,13 +2231,16 @@ declare function listLinearIssuesFiltered(opts?: {
     updatedSince?: string | null;
 }): Promise<LinearAssignedIssuesResult>;
 /**
- * Comments created at/after `since` on issues matching the same assignee filter.
- * One GraphQL query — do not get_issue each ticket to check for new comments.
+ * Comments created at/after `since` on issues matching the same assignee / search
+ * filter. One GraphQL query — do not get_issue each ticket to check for new comments.
+ * Pass `issueIdentifiers` (search hits) to keep only those tickets; an empty
+ * allowlist means no comments.
  */
 declare function listLinearCommentsSince(opts: {
     since: string;
     assignee?: string | null;
     query?: string;
+    issueIdentifiers?: string[];
     limit?: number;
     apiKey?: string | null;
 }): Promise<IssueActivityComment[]>;
@@ -2364,7 +2364,8 @@ declare function resolveGitHubIssueRepo(repoPath?: string | null): Promise<{
 declare function toGitHubIssueInfo(issue: GitHubIssue): IssueInfo;
 /**
  * Repo issue comments created at/after `since`. Pass `issueIdentifiers` (#12)
- * to keep only comments on that inbox page — one REST call, not N issue views.
+ * to keep only comments on that inbox page — paginated REST, not N issue views.
+ * An empty allowlist means no comments (do not fall through to the whole repo).
  */
 declare function listGitHubIssueCommentsSince(opts: {
     since: string;

package/dist/index.d.ts

@@ -2213,13 +2213,10 @@ type LinearAssignedIssuesResult = {
 };
 /** `me`, `unassigned`, `all`, a Linear user id, or a display name. */
 type LinearAssigneeFilter = string;
-/**
- * Linear `IssueFilter` for open issues. Default assignee is `me` so existing
- * Home / Create-from callers stay assigned-to-you unless they ask otherwise.
- */
 declare function buildLinearIssueFilter(input?: {
     assignee?: string | null;
     updatedSince?: string | null;
+    query?: string | null;
 }): Record<string, unknown>;
 /**
  * List or search open Linear issues. `assignee` is `me` (default when there is
@@ -2234,13 +2231,16 @@ declare function listLinearIssuesFiltered(opts?: {
     updatedSince?: string | null;
 }): Promise<LinearAssignedIssuesResult>;
 /**
- * Comments created at/after `since` on issues matching the same assignee filter.
- * One GraphQL query — do not get_issue each ticket to check for new comments.
+ * Comments created at/after `since` on issues matching the same assignee / search
+ * filter. One GraphQL query — do not get_issue each ticket to check for new comments.
+ * Pass `issueIdentifiers` (search hits) to keep only those tickets; an empty
+ * allowlist means no comments.
  */
 declare function listLinearCommentsSince(opts: {
     since: string;
     assignee?: string | null;
     query?: string;
+    issueIdentifiers?: string[];
     limit?: number;
     apiKey?: string | null;
 }): Promise<IssueActivityComment[]>;
@@ -2364,7 +2364,8 @@ declare function resolveGitHubIssueRepo(repoPath?: string | null): Promise<{
 declare function toGitHubIssueInfo(issue: GitHubIssue): IssueInfo;
 /**
  * Repo issue comments created at/after `since`. Pass `issueIdentifiers` (#12)
- * to keep only comments on that inbox page — one REST call, not N issue views.
+ * to keep only comments on that inbox page — paginated REST, not N issue views.
+ * An empty allowlist means no comments (do not fall through to the whole repo).
  */
 declare function listGitHubIssueCommentsSince(opts: {
     since: string;

package/dist/index.js

@@ -238,7 +238,7 @@ import {
   worktreeCleanupSettings,
   wrapReviewSkillMarkdown,
   writeWorktreeFile
-} from "./chunk-4IQQEJ2C.js";
+} from "./chunk-VTIVVVEC.js";
 import {
   LEGACY_PLAN_FILE_REL,
   PLAN_FILE_NAME,
@@ -1518,12 +1518,27 @@ var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function assigneeFilterKey(assignee) {
   return (assignee ?? "").trim();
 }
+function applyLinearIssueQueryFilter(filter, query) {
+  const term = query?.trim();
+  if (!term) return;
+  const or = [
+    { title: { containsIgnoreCase: term } },
+    { description: { containsIgnoreCase: term } }
+  ];
+  const identifierMatch = term.match(/^[A-Za-z][\w]*-(\d+)$/);
+  const asNumber = identifierMatch ? Number(identifierMatch[1]) : /^\d+$/.test(term) ? Number(term) : NaN;
+  if (Number.isFinite(asNumber) && asNumber > 0) {
+    or.push({ number: { eq: asNumber } });
+  }
+  filter.or = or;
+}
 function buildLinearIssueFilter(input) {
   const filter = {
     state: { type: { nin: ["completed", "canceled"] } }
   };
   const since = input?.updatedSince?.trim();
   if (since) filter.updatedAt = { gte: since };
+  applyLinearIssueQueryFilter(filter, input?.query);
   const raw = assigneeFilterKey(input?.assignee) || "me";
   const key = raw.toLowerCase();
   if (key === "all" || key === "*") return filter;
@@ -1589,6 +1604,11 @@ async function listLinearIssuesFiltered(opts) {
 async function listLinearCommentsSince(opts) {
   const first = Math.max(1, Math.min(250, opts.limit ?? 200));
   const query = opts.query?.trim() ?? "";
+  const restrictToIssues = opts.issueIdentifiers != null;
+  const allowed = new Set(
+    (opts.issueIdentifiers ?? []).map((id) => id.trim()).filter(Boolean)
+  );
+  if (restrictToIssues && allowed.size === 0) return [];
   const assignee = assigneeFilterKey(opts.assignee) || (query ? "all" : "me");
   const json = await linearGraphql(
     COMMENTS_SINCE_QUERY,
@@ -1596,7 +1616,7 @@ async function listLinearCommentsSince(opts) {
       first,
       filter: {
         createdAt: { gte: opts.since },
-        issue: buildLinearIssueFilter({ assignee })
+        issue: buildLinearIssueFilter({ assignee, query: query || void 0 })
       }
     },
     opts
@@ -1604,6 +1624,7 @@ async function listLinearCommentsSince(opts) {
   const out = [];
   for (const node of json.comments?.nodes ?? []) {
     const identifier = String(node.issue?.identifier ?? "").trim();
+    if (restrictToIssues && !allowed.has(identifier)) continue;
     const body = previewIssueCommentBody(String(node.body ?? ""));
     if (!identifier && !body) continue;
     out.push({
@@ -1833,10 +1854,32 @@ function issueNumberFromApiUrl(url) {
   const number = Number(match[1]);
   return Number.isFinite(number) && number > 0 ? number : null;
 }
+var GITHUB_ISSUE_COMMENTS_PAGE_SIZE = 100;
+var GITHUB_ISSUE_COMMENTS_MAX_PAGES = 5;
+function parseGitHubIssueCommentNode(item, allowed) {
+  const rec = item && typeof item === "object" ? item : null;
+  if (!rec) return null;
+  const issueUrl = typeof rec.issue_url === "string" ? rec.issue_url : "";
+  const number = issueNumberFromApiUrl(issueUrl);
+  if (number == null) return null;
+  if (allowed && !allowed.has(number)) return null;
+  const body = previewIssueCommentBody(typeof rec.body === "string" ? rec.body : "");
+  const user = rec.user && typeof rec.user === "object" ? String(rec.user.login ?? "").trim() : "";
+  const createdAt = typeof rec.created_at === "string" ? rec.created_at : typeof rec.createdAt === "string" ? rec.createdAt : void 0;
+  const url = typeof rec.html_url === "string" ? rec.html_url : void 0;
+  return {
+    identifier: `#${number}`,
+    ...user ? { author: user } : {},
+    ...createdAt ? { createdAt } : {},
+    body,
+    ...url ? { url } : {}
+  };
+}
 async function listGitHubIssueCommentsSince(opts) {
   const limit = Math.max(1, Math.min(250, opts.limit ?? 200));
   const { cwd, slug } = await resolveGitHubIssueRepo(opts.repoPath);
   if (!slug) return [];
+  const restrictToIssues = opts.issueIdentifiers != null;
   const allowed = new Set(
     (opts.issueIdentifiers ?? []).map((id) => {
       try {
@@ -1846,36 +1889,27 @@ async function listGitHubIssueCommentsSince(opts) {
       }
     }).filter((n) => n != null)
   );
-  const path2 = `repos/${slug}/issues/comments?since=${encodeURIComponent(opts.since)}&per_page=${limit + 1}`;
-  const result = await gh(["api", path2], cwd, { reject: false });
-  if (result.exitCode !== 0 || !result.stdout.trim()) return [];
-  let parsed;
-  try {
-    parsed = JSON.parse(result.stdout);
-  } catch {
-    return [];
-  }
-  if (!Array.isArray(parsed)) return [];
+  if (restrictToIssues && allowed.size === 0) return [];
+  const pageSize = Math.min(GITHUB_ISSUE_COMMENTS_PAGE_SIZE, Math.max(1, limit));
   const out = [];
-  for (const item of parsed) {
-    const rec = item && typeof item === "object" ? item : null;
-    if (!rec) continue;
-    const issueUrl = typeof rec.issue_url === "string" ? rec.issue_url : "";
-    const number = issueNumberFromApiUrl(issueUrl);
-    if (number == null) continue;
-    if (allowed.size > 0 && !allowed.has(number)) continue;
-    const body = previewIssueCommentBody(typeof rec.body === "string" ? rec.body : "");
-    const user = rec.user && typeof rec.user === "object" ? String(rec.user.login ?? "").trim() : "";
-    const createdAt = typeof rec.created_at === "string" ? rec.created_at : typeof rec.createdAt === "string" ? rec.createdAt : void 0;
-    const url = typeof rec.html_url === "string" ? rec.html_url : void 0;
-    out.push({
-      identifier: `#${number}`,
-      ...user ? { author: user } : {},
-      ...createdAt ? { createdAt } : {},
-      body,
-      ...url ? { url } : {}
-    });
-    if (out.length >= limit) break;
+  for (let page = 1; page <= GITHUB_ISSUE_COMMENTS_MAX_PAGES; page++) {
+    const path2 = `repos/${slug}/issues/comments?since=${encodeURIComponent(opts.since)}&sort=created&direction=desc&per_page=${pageSize}&page=${page}`;
+    const result = await gh(["api", path2], cwd, { reject: false });
+    if (result.exitCode !== 0 || !result.stdout.trim()) break;
+    let parsed;
+    try {
+      parsed = JSON.parse(result.stdout);
+    } catch {
+      break;
+    }
+    if (!Array.isArray(parsed) || parsed.length === 0) break;
+    for (const item of parsed) {
+      const comment = parseGitHubIssueCommentNode(item, restrictToIssues ? allowed : null);
+      if (!comment) continue;
+      out.push(comment);
+      if (out.length >= limit) return out;
+    }
+    if (parsed.length < pageSize) break;
   }
   return out;
 }
@@ -2081,20 +2115,19 @@ async function listIssues(repoPath, opts) {
   const assignee = opts?.assignee?.trim() || void 0;
   const since = opts?.updatedSince ? parseIssueSince(opts.updatedSince) : void 0;
   if (source === "linear") {
-    const [listed, comments2] = await Promise.all([
-      listLinearIssuesFiltered({
-        assignee,
-        query,
-        limit: opts?.limit,
-        updatedSince: since
-      }),
-      since ? listLinearCommentsSince({
-        since,
-        assignee,
-        query,
-        limit: opts?.limit
-      }) : Promise.resolve(void 0)
-    ]);
+    const listed = await listLinearIssuesFiltered({
+      assignee,
+      query,
+      limit: opts?.limit,
+      updatedSince: since
+    });
+    const comments2 = since ? await listLinearCommentsSince({
+      since,
+      assignee,
+      query,
+      issueIdentifiers: query ? listed.issues.map((issue) => issue.identifier) : void 0,
+      limit: opts?.limit
+    }) : void 0;
     return {
       source,
       preferredSource,
@@ -3762,20 +3795,19 @@ function registerLinearTools(server) {
       try {
         const page = clampMcpIssueLimit(limit);
         const since = updatedSince ? parseIssueSince(updatedSince) : void 0;
-        const [listed, comments] = await Promise.all([
-          listLinearIssuesFiltered({
-            query,
-            assignee,
-            limit: page + 1,
-            updatedSince: since
-          }),
-          since ? listLinearCommentsSince({
-            since,
-            assignee,
-            query,
-            limit: page + 1
-          }) : Promise.resolve(void 0)
-        ]);
+        const listed = await listLinearIssuesFiltered({
+          query,
+          assignee,
+          limit: page + 1,
+          updatedSince: since
+        });
+        const comments = since ? await listLinearCommentsSince({
+          since,
+          assignee,
+          query,
+          issueIdentifiers: query ? listed.issues.map((issue) => issue.identifier) : void 0,
+          limit: page + 1
+        }) : void 0;
         return mcpJson(
           formatListedIssuesForMcp(
             {
@@ -4880,7 +4912,7 @@ async function startMcpServer() {
   );
   server.tool(
     "wait_for_job",
-    "Wait on a detached long job (tests, pack, deploy, connector CLI) started with detached-job.cjs. MCP clients kill tools around 60s, so this returns within 45s. stillRunning is the source of truth \u2014 if true, present_artifact type=log with content=delta (same artifact_id) and call wait_for_job again. If the job is hanging, producing no useful output, or doing the wrong thing, call stop_job instead of looping forever. Do not end the turn or tell the user you will let them know later. If false, ok/failed is the result.",
+    "Wait on a detached long job (tests, pack, deploy, connector CLI) started with detached-job.cjs. MCP clients kill tools around 60s, so this returns within 45s. Sideboard opens a type=log pane from this result (artifact_id = job id, content = delta). stillRunning is the source of truth \u2014 if true, call wait_for_job again. If the job is hanging, producing no useful output, or doing the wrong thing, call stop_job instead of looping forever. Do not end the turn or tell the user you will let them know later. If false, ok/failed is the result.",
     {
       id: z9.string().describe("Detached job id (same kebab-case id passed to detached-job.cjs start)"),
       timeoutMs: z9.number().optional()
@@ -4894,7 +4926,7 @@ async function startMcpServer() {
   );
   server.tool(
     "stop_job",
-    "Stop a detached job you started with detached-job.cjs when it is hanging, producing no useful output, buffering forever, or doing the wrong thing (wrong project, infinite watch, huge dump). Do not stop a pack/test/deploy that is clearly making progress. After stop, present_artifact type=log with status=failed and the last delta, then decide the next step.",
+    "Stop a detached job you started with detached-job.cjs when it is hanging, producing no useful output, buffering forever, or doing the wrong thing (wrong project, infinite watch, huge dump). Do not stop a pack/test/deploy that is clearly making progress. The type=log pane updates to status=failed with the last delta. Then decide the next step.",
     {
       id: z9.string().describe("Detached job id (same kebab-case id passed to detached-job.cjs start)"),
       reason: z9.string().optional().describe("Why you are stopping (hanging, no progress, wrong output, already have the error)")