@alasano/pi-linear 0.2.0 → 0.3.1

package/README.md

@@ -110,6 +110,8 @@ Run `/linear-settings` to open an overlay where you can choose the default outpu
 | `linear_archive_project`   | Archive or trash a project                       |
 | `linear_unarchive_project` | Restore an archived project                      |
 
+List and search results include `pageInfo` in the JSON output for cursor pagination. Project list results use a bounded summary selection, and `linear_get_project` plus project save results include the project's markdown `content` body.
+
 ### Project Labels
 
 | Tool                          | Description            |

package/extensions/params.ts

@@ -1,5 +1,5 @@
 import { Type } from '@sinclair/typebox';
-import { GenericObjectSchema } from './util';
+import { compactObject, GenericObjectSchema } from './util';
 
 export const PaginationParams = {
   after: Type.Optional(Type.String({ description: 'Pagination cursor.' })),
@@ -26,6 +26,45 @@ export const PaginationParams = {
   ),
 };
 
+type PaginationVariableParams = {
+  after?: string;
+  before?: string;
+  first?: number;
+  includeArchived?: boolean;
+  last?: number;
+  orderBy?: string;
+};
+
+export function paginationVariables(
+  params: PaginationVariableParams,
+  defaultPageSize: number,
+): Partial<PaginationVariableParams> {
+  const hasForwardPagination = params.after !== undefined || params.first !== undefined;
+  const hasBackwardPagination = params.before !== undefined || params.last !== undefined;
+
+  if (hasForwardPagination && hasBackwardPagination) {
+    throw new Error(
+      'Use either forward pagination (first/after) or backward pagination (last/before), not both.',
+    );
+  }
+
+  if (hasBackwardPagination) {
+    return compactObject({
+      before: params.before,
+      includeArchived: params.includeArchived,
+      last: params.last ?? defaultPageSize,
+      orderBy: params.orderBy,
+    });
+  }
+
+  return compactObject({
+    after: params.after,
+    first: params.first ?? defaultPageSize,
+    includeArchived: params.includeArchived,
+    orderBy: params.orderBy,
+  });
+}
+
 export const SortParam = {
   sort: Type.Optional(Type.Array(GenericObjectSchema, { description: 'Sort input array.' })),
 };

package/extensions/renderers/projects.ts

@@ -39,6 +39,7 @@ type ProjectLike = {
   id?: string;
   name?: string | null;
   description?: string | null;
+  content?: string | null;
   state?: string | null;
   status?: { id?: string; name?: string | null } | null;
   priority?: number | null;
@@ -55,6 +56,12 @@ type ProjectLike = {
 type ProjectResultDetails = {
   project?: ProjectLike | null;
   projects?: ProjectLike[];
+  pageInfo?: {
+    hasNextPage?: boolean;
+    hasPreviousPage?: boolean;
+    startCursor?: string | null;
+    endCursor?: string | null;
+  };
   success?: boolean;
 };
 

package/extensions/selections.ts

@@ -94,7 +94,7 @@ export const ISSUE_LABEL_SELECTION = `
     }
   `;
 
-export const PROJECT_SELECTION = `
+const PROJECT_BASE_SELECTION = `
     id
     name
     description
@@ -116,7 +116,7 @@ export const PROJECT_SELECTION = `
     createdAt
     updatedAt
     url
-    teams {
+    teams(first: 10) {
       nodes {
         id
         key
@@ -128,7 +128,7 @@ export const PROJECT_SELECTION = `
       name
       email
     }
-    members {
+    members(first: 10) {
       nodes {
         id
         name
@@ -141,6 +141,13 @@ export const PROJECT_SELECTION = `
     }
   `;
 
+export const PROJECT_LIST_SELECTION = PROJECT_BASE_SELECTION;
+
+export const PROJECT_DETAIL_SELECTION = `
+    ${PROJECT_BASE_SELECTION}
+    content
+  `;
+
 export const PROJECT_LABEL_SELECTION = `
     id
     name

package/extensions/tools/comments.ts

@@ -1,9 +1,9 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL } from '../client';
-import { PaginationParams, FilterParam, RawInputParam } from '../params';
+import { PaginationParams, paginationVariables, FilterParam, RawInputParam } from '../params';
 import { COMMENT_SELECTION } from '../selections';
-import type { JsonObject } from '../types';
+import type { JsonObject, LinearConnection } from '../types';
 import { compactObject, asObject, asString, GenericObjectSchema } from '../util';
 import {
   renderLinearCommentListCall,
@@ -29,17 +29,12 @@ export function commentTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const variables = compactObject({
-            after: params.after,
-            before: params.before,
+            ...paginationVariables(params, 20),
             filter: asObject(params.filter),
-            first: params.first ?? 20,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
           });
 
           const data = await linearGraphQL<{
-            comments: { nodes: Array<JsonObject> };
+            comments: LinearConnection<JsonObject>;
           }>(
             apiKey,
             `query ListComments(
@@ -63,6 +58,12 @@ export function commentTools() {
                 nodes {
                   ${COMMENT_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -70,9 +71,10 @@ export function commentTools() {
           );
 
           const comments = data.comments.nodes;
+          const pageInfo = data.comments.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ comments }, null, 2) }],
-            details: { comments },
+            content: [{ type: 'text', text: JSON.stringify({ comments, pageInfo }, null, 2) }],
+            details: { comments, pageInfo },
           };
         });
       },

package/extensions/tools/documents.ts

@@ -1,9 +1,15 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL, resolveTeamId } from '../client';
-import { PaginationParams, FilterParam, RawInputParam, TeamConvenienceParams } from '../params';
+import {
+  PaginationParams,
+  paginationVariables,
+  FilterParam,
+  RawInputParam,
+  TeamConvenienceParams,
+} from '../params';
 import { DOCUMENT_SELECTION } from '../selections';
-import type { JsonObject } from '../types';
+import type { JsonObject, LinearConnection } from '../types';
 import { compactObject, asObject, asString } from '../util';
 import {
   renderLinearCreateDocumentCall,
@@ -17,6 +23,36 @@ import {
   renderLinearUpdateDocumentCall,
 } from '../renderers/documents';
 
+const DOCUMENT_RELATED_CONTEXT_FIELDS = [
+  'cycleId',
+  'initiativeId',
+  'issueId',
+  'projectId',
+  'releaseId',
+  'resourceFolderId',
+] as const;
+
+type DocumentRelatedContextField = (typeof DOCUMENT_RELATED_CONTEXT_FIELDS)[number];
+
+function hasDocumentRelatedContext(
+  params: Partial<Record<DocumentRelatedContextField, unknown>>,
+  rawInput: JsonObject,
+): boolean {
+  return DOCUMENT_RELATED_CONTEXT_FIELDS.some((field) =>
+    Boolean(asString(params[field]) || asString(rawInput[field])),
+  );
+}
+
+function documentInputBase(rawInput: JsonObject, omitTeamId: boolean): JsonObject {
+  if (!omitTeamId) return rawInput;
+
+  // Linear rejects document inputs with multiple parent/context IDs (for example
+  // issueId + teamId). Treat teamId/teamKey as the document context only when no
+  // more specific relation is provided; issue/project/etc. imply their context.
+  const { teamId: _teamId, ...inputWithoutTeamId } = rawInput;
+  return inputWithoutTeamId;
+}
+
 export function documentTools() {
   return [
     defineTool({
@@ -31,17 +67,12 @@ export function documentTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const variables = compactObject({
-            after: params.after,
-            before: params.before,
+            ...paginationVariables(params, 20),
             filter: asObject(params.filter),
-            first: params.first ?? 20,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
           });
 
           const data = await linearGraphQL<{
-            documents: { nodes: Array<JsonObject> };
+            documents: LinearConnection<JsonObject>;
           }>(
             apiKey,
             `query ListDocuments(
@@ -65,6 +96,12 @@ export function documentTools() {
                 nodes {
                   ${DOCUMENT_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -72,9 +109,10 @@ export function documentTools() {
           );
 
           const documents = data.documents.nodes;
+          const pageInfo = data.documents.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ documents }, null, 2) }],
-            details: { documents },
+            content: [{ type: 'text', text: JSON.stringify({ documents, pageInfo }, null, 2) }],
+            details: { documents, pageInfo },
           };
         });
       },
@@ -116,7 +154,7 @@ export function documentTools() {
       name: 'linear_create_document',
       label: 'Linear Create Document',
       description:
-        'Create a document. Supports top-level DocumentCreateInput fields and raw input.',
+        'Create a document. Supports top-level DocumentCreateInput fields and raw input. Use issueId/projectId/etc. for related documents; teamId/teamKey are only for team-scoped documents.',
       parameters: Type.Object({
         color: Type.Optional(Type.String()),
         content: Type.Optional(Type.String()),
@@ -139,9 +177,10 @@ export function documentTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const rawInput = asObject(params.input) || {};
-          const rawInputTeamId = asString(rawInput.teamId);
+          const hasRelatedContext = hasDocumentRelatedContext(params, rawInput);
+          const rawInputTeamId = hasRelatedContext ? undefined : asString(rawInput.teamId);
           const teamId =
-            params.teamId || params.teamKey || rawInputTeamId
+            !hasRelatedContext && (params.teamId || params.teamKey || rawInputTeamId)
               ? await resolveTeamId(
                   apiKey,
                   {
@@ -153,7 +192,7 @@ export function documentTools() {
               : undefined;
 
           const input = {
-            ...rawInput,
+            ...documentInputBase(rawInput, hasRelatedContext),
             ...compactObject({
               color: params.color,
               content: params.content,
@@ -210,7 +249,7 @@ export function documentTools() {
       name: 'linear_update_document',
       label: 'Linear Update Document',
       description:
-        'Update a document by id. Supports top-level DocumentUpdateInput fields and raw input.',
+        'Update a document by id. Supports top-level DocumentUpdateInput fields and raw input. Use issueId/projectId/etc. for related documents; teamId/teamKey are only for team-scoped documents.',
       parameters: Type.Object({
         documentId: Type.String(),
         color: Type.Optional(Type.String()),
@@ -235,9 +274,10 @@ export function documentTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const rawInput = asObject(params.input) || {};
-          const rawInputTeamId = asString(rawInput.teamId);
+          const hasRelatedContext = hasDocumentRelatedContext(params, rawInput);
+          const rawInputTeamId = hasRelatedContext ? undefined : asString(rawInput.teamId);
           const teamId =
-            params.teamId || params.teamKey || rawInputTeamId
+            !hasRelatedContext && (params.teamId || params.teamKey || rawInputTeamId)
               ? await resolveTeamId(
                   apiKey,
                   {
@@ -249,7 +289,7 @@ export function documentTools() {
               : undefined;
 
           const input = {
-            ...rawInput,
+            ...documentInputBase(rawInput, hasRelatedContext),
             ...compactObject({
               color: params.color,
               content: params.content,

package/extensions/tools/initiatives.ts

@@ -1,9 +1,15 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL } from '../client';
-import { PaginationParams, FilterParam, SortParam, RawInputParam } from '../params';
+import {
+  PaginationParams,
+  paginationVariables,
+  FilterParam,
+  SortParam,
+  RawInputParam,
+} from '../params';
 import { INITIATIVE_SELECTION } from '../selections';
-import type { JsonObject } from '../types';
+import type { JsonObject, LinearConnection } from '../types';
 import { compactObject, asObject, asObjectArray, asString } from '../util';
 import {
   renderLinearArchiveInitiativeCall,
@@ -33,18 +39,13 @@ export function initiativeTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const variables = compactObject({
-            after: params.after,
-            before: params.before,
+            ...paginationVariables(params, 20),
             filter: asObject(params.filter),
-            first: params.first ?? 20,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
             sort: asObjectArray(params.sort),
           });
 
           const data = await linearGraphQL<{
-            initiatives: { nodes: Array<JsonObject> };
+            initiatives: LinearConnection<JsonObject>;
           }>(
             apiKey,
             `query ListInitiatives(
@@ -70,6 +71,12 @@ export function initiativeTools() {
                 nodes {
                   ${INITIATIVE_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -77,9 +84,10 @@ export function initiativeTools() {
           );
 
           const initiatives = data.initiatives.nodes;
+          const pageInfo = data.initiatives.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ initiatives }, null, 2) }],
-            details: { initiatives },
+            content: [{ type: 'text', text: JSON.stringify({ initiatives, pageInfo }, null, 2) }],
+            details: { initiatives, pageInfo },
           };
         });
       },

package/extensions/tools/issue-labels.ts

@@ -1,9 +1,15 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL, resolveTeamId } from '../client';
-import { PaginationParams, FilterParam, RawInputParam, TeamConvenienceParams } from '../params';
+import {
+  PaginationParams,
+  paginationVariables,
+  FilterParam,
+  RawInputParam,
+  TeamConvenienceParams,
+} from '../params';
 import { ISSUE_LABEL_SELECTION } from '../selections';
-import type { JsonObject } from '../types';
+import type { JsonObject, LinearConnection } from '../types';
 import { compactObject, asObject, asString, mergeFilters } from '../util';
 import {
   renderLinearCreateIssueLabelCall,
@@ -45,17 +51,12 @@ export function issueLabelTools() {
           const filter = mergeFilters(asObject(params.filter), convenienceFilter);
 
           const variables = compactObject({
-            after: params.after,
-            before: params.before,
+            ...paginationVariables(params, 50),
             filter,
-            first: params.first ?? 50,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
           });
 
           const data = await linearGraphQL<{
-            issueLabels: { nodes: Array<JsonObject> };
+            issueLabels: LinearConnection<JsonObject>;
           }>(
             apiKey,
             `query ListIssueLabels(
@@ -79,6 +80,12 @@ export function issueLabelTools() {
                 nodes {
                   ${ISSUE_LABEL_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -86,9 +93,10 @@ export function issueLabelTools() {
           );
 
           const labels = data.issueLabels.nodes;
+          const pageInfo = data.issueLabels.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ labels }, null, 2) }],
-            details: { labels },
+            content: [{ type: 'text', text: JSON.stringify({ labels, pageInfo }, null, 2) }],
+            details: { labels, pageInfo },
           };
         });
       },

package/extensions/tools/issue-relations.ts

@@ -1,9 +1,9 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL, resolveIssueId } from '../client';
-import { PaginationParams } from '../params';
+import { PaginationParams, paginationVariables } from '../params';
 import { ISSUE_RELATION_SELECTION } from '../selections';
-import type { JsonObject } from '../types';
+import type { JsonObject, LinearConnection } from '../types';
 import { compactObject } from '../util';
 import {
   renderLinearCreateIssueRelationCall,
@@ -27,17 +27,10 @@ export function issueRelationTools() {
       renderCall: renderLinearIssueRelationListCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
-          const variables = compactObject({
-            after: params.after,
-            before: params.before,
-            first: params.first ?? 20,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
-          });
+          const variables = paginationVariables(params, 20);
 
           const data = await linearGraphQL<{
-            issueRelations: { nodes: Array<JsonObject> };
+            issueRelations: LinearConnection<JsonObject>;
           }>(
             apiKey,
             `query ListIssueRelations(
@@ -59,6 +52,12 @@ export function issueRelationTools() {
                 nodes {
                   ${ISSUE_RELATION_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -66,9 +65,12 @@ export function issueRelationTools() {
           );
 
           const issueRelations = data.issueRelations.nodes;
+          const pageInfo = data.issueRelations.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ issueRelations }, null, 2) }],
-            details: { issueRelations },
+            content: [
+              { type: 'text', text: JSON.stringify({ issueRelations, pageInfo }, null, 2) },
+            ],
+            details: { issueRelations, pageInfo },
           };
         });
       },

package/extensions/tools/issue-statuses.ts

@@ -1,9 +1,9 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL } from '../client';
-import { PaginationParams, FilterParam } from '../params';
+import { PaginationParams, paginationVariables, FilterParam } from '../params';
 import { WORKFLOW_STATE_SELECTION } from '../selections';
-import type { JsonObject } from '../types';
+import type { JsonObject, LinearConnection } from '../types';
 import { compactObject, asObject } from '../util';
 import {
   renderLinearIssueStatusListCall,
@@ -25,17 +25,12 @@ export function issueStatusTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const variables = compactObject({
-            after: params.after,
-            before: params.before,
+            ...paginationVariables(params, 50),
             filter: asObject(params.filter),
-            first: params.first ?? 50,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
           });
 
           const data = await linearGraphQL<{
-            workflowStates: { nodes: Array<JsonObject> };
+            workflowStates: LinearConnection<JsonObject>;
           }>(
             apiKey,
             `query ListIssueStatuses(
@@ -59,6 +54,12 @@ export function issueStatusTools() {
                 nodes {
                   ${WORKFLOW_STATE_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -66,9 +67,10 @@ export function issueStatusTools() {
           );
 
           const states = data.workflowStates.nodes;
+          const pageInfo = data.workflowStates.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ states }, null, 2) }],
-            details: { states },
+            content: [{ type: 'text', text: JSON.stringify({ states, pageInfo }, null, 2) }],
+            details: { states, pageInfo },
           };
         });
       },

package/extensions/tools/issues.ts

@@ -9,13 +9,14 @@ import {
 } from '../client';
 import {
   PaginationParams,
+  paginationVariables,
   FilterParam,
   SortParam,
   TeamConvenienceParams,
   RawInputParam,
 } from '../params';
 import { ISSUE_SELECTION } from '../selections';
-import type { LinearIssue, JsonObject } from '../types';
+import type { LinearIssue, JsonObject, LinearConnection } from '../types';
 import { compactObject, asObject, asObjectArray, asString, mergeFilters } from '../util';
 import {
   renderLinearArchiveIssueCall,
@@ -79,17 +80,12 @@ export function issueTools() {
           );
 
           const variables = compactObject({
-            after: params.after,
-            before: params.before,
+            ...paginationVariables(params, 20),
             filter,
-            first: params.first ?? 20,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
             sort: asObjectArray(params.sort),
           });
 
-          const data = await linearGraphQL<{ issues: { nodes: LinearIssue[] } }>(
+          const data = await linearGraphQL<{ issues: LinearConnection<LinearIssue> }>(
             apiKey,
             `query ListIssues(
               $after: String
@@ -114,6 +110,12 @@ export function issueTools() {
                 nodes {
                   ${ISSUE_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -121,9 +123,10 @@ export function issueTools() {
           );
 
           const issues = data.issues.nodes;
+          const pageInfo = data.issues.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ issues }, null, 2) }],
-            details: { issues },
+            content: [{ type: 'text', text: JSON.stringify({ issues, pageInfo }, null, 2) }],
+            details: { issues, pageInfo },
           };
         });
       },
@@ -641,20 +644,15 @@ export function issueTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const variables = compactObject({
+            ...paginationVariables(params, 20),
             term: params.term,
             includeComments: params.includeComments,
             teamId: params.teamId,
-            after: params.after,
-            before: params.before,
             filter: asObject(params.filter),
-            first: params.first ?? 20,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
           });
 
           const data = await linearGraphQL<{
-            searchIssues: { nodes: LinearIssue[] };
+            searchIssues: LinearConnection<LinearIssue>;
           }>(
             apiKey,
             `query SearchIssues(
@@ -684,6 +682,12 @@ export function issueTools() {
                 nodes {
                   ${ISSUE_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -691,9 +695,10 @@ export function issueTools() {
           );
 
           const issues = data.searchIssues.nodes;
+          const pageInfo = data.searchIssues.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ issues }, null, 2) }],
-            details: { issues },
+            content: [{ type: 'text', text: JSON.stringify({ issues, pageInfo }, null, 2) }],
+            details: { issues, pageInfo },
           };
         });
       },

package/extensions/tools/milestones.ts

@@ -1,9 +1,9 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL } from '../client';
-import { PaginationParams, FilterParam, RawInputParam } from '../params';
+import { PaginationParams, paginationVariables, FilterParam, RawInputParam } from '../params';
 import { MILESTONE_SELECTION } from '../selections';
-import type { JsonObject } from '../types';
+import type { JsonObject, LinearConnection } from '../types';
 import { compactObject, asObject, asString, GenericObjectSchema } from '../util';
 import {
   renderLinearMilestoneDeleteCall,
@@ -30,17 +30,12 @@ export function milestoneTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const variables = compactObject({
-            after: params.after,
-            before: params.before,
+            ...paginationVariables(params, 20),
             filter: asObject(params.filter),
-            first: params.first ?? 20,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
           });
 
           const data = await linearGraphQL<{
-            projectMilestones: { nodes: Array<JsonObject> };
+            projectMilestones: LinearConnection<JsonObject>;
           }>(
             apiKey,
             `query ListMilestones(
@@ -64,6 +59,12 @@ export function milestoneTools() {
                 nodes {
                   ${MILESTONE_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -71,9 +72,10 @@ export function milestoneTools() {
           );
 
           const milestones = data.projectMilestones.nodes;
+          const pageInfo = data.projectMilestones.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ milestones }, null, 2) }],
-            details: { milestones },
+            content: [{ type: 'text', text: JSON.stringify({ milestones, pageInfo }, null, 2) }],
+            details: { milestones, pageInfo },
           };
         });
       },

package/extensions/tools/project-labels.ts

@@ -1,9 +1,9 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL } from '../client';
-import { PaginationParams, FilterParam, RawInputParam } from '../params';
+import { PaginationParams, paginationVariables, FilterParam, RawInputParam } from '../params';
 import { PROJECT_LABEL_SELECTION } from '../selections';
-import type { JsonObject } from '../types';
+import type { JsonObject, LinearConnection } from '../types';
 import { compactObject, asObject, asString } from '../util';
 import {
   renderLinearCreateProjectLabelCall,
@@ -29,17 +29,12 @@ export function projectLabelTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const variables = compactObject({
-            after: params.after,
-            before: params.before,
+            ...paginationVariables(params, 50),
             filter: asObject(params.filter),
-            first: params.first ?? 50,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
           });
 
           const data = await linearGraphQL<{
-            projectLabels: { nodes: Array<JsonObject> };
+            projectLabels: LinearConnection<JsonObject>;
           }>(
             apiKey,
             `query ListProjectLabels(
@@ -63,6 +58,12 @@ export function projectLabelTools() {
                 nodes {
                   ${PROJECT_LABEL_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -70,9 +71,10 @@ export function projectLabelTools() {
           );
 
           const labels = data.projectLabels.nodes;
+          const pageInfo = data.projectLabels.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ labels }, null, 2) }],
-            details: { labels },
+            content: [{ type: 'text', text: JSON.stringify({ labels, pageInfo }, null, 2) }],
+            details: { labels, pageInfo },
           };
         });
       },

package/extensions/tools/project-relations.ts

@@ -1,9 +1,9 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL } from '../client';
-import { PaginationParams } from '../params';
+import { PaginationParams, paginationVariables } from '../params';
 import { PROJECT_RELATION_SELECTION } from '../selections';
-import type { JsonObject } from '../types';
+import type { JsonObject, LinearConnection } from '../types';
 import { compactObject } from '../util';
 import {
   renderLinearCreateProjectRelationCall,
@@ -27,17 +27,10 @@ export function projectRelationTools() {
       renderCall: renderLinearProjectRelationListCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
-          const variables = compactObject({
-            after: params.after,
-            before: params.before,
-            first: params.first ?? 20,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
-          });
+          const variables = paginationVariables(params, 20);
 
           const data = await linearGraphQL<{
-            projectRelations: { nodes: Array<JsonObject> };
+            projectRelations: LinearConnection<JsonObject>;
           }>(
             apiKey,
             `query ListProjectRelations(
@@ -59,6 +52,12 @@ export function projectRelationTools() {
                 nodes {
                   ${PROJECT_RELATION_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -66,9 +65,12 @@ export function projectRelationTools() {
           );
 
           const projectRelations = data.projectRelations.nodes;
+          const pageInfo = data.projectRelations.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ projectRelations }, null, 2) }],
-            details: { projectRelations },
+            content: [
+              { type: 'text', text: JSON.stringify({ projectRelations, pageInfo }, null, 2) },
+            ],
+            details: { projectRelations, pageInfo },
           };
         });
       },

package/extensions/tools/projects.ts

@@ -1,9 +1,15 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL } from '../client';
-import { PaginationParams, FilterParam, SortParam, RawInputParam } from '../params';
-import { PROJECT_SELECTION } from '../selections';
-import type { JsonObject } from '../types';
+import {
+  PaginationParams,
+  paginationVariables,
+  FilterParam,
+  SortParam,
+  RawInputParam,
+} from '../params';
+import { PROJECT_DETAIL_SELECTION, PROJECT_LIST_SELECTION } from '../selections';
+import type { JsonObject, LinearConnection } from '../types';
 import { compactObject, asObject, asObjectArray, asString } from '../util';
 import {
   renderLinearArchiveProjectCall,
@@ -33,18 +39,13 @@ export function projectTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const variables = compactObject({
-            after: params.after,
-            before: params.before,
+            ...paginationVariables(params, 20),
             filter: asObject(params.filter),
-            first: params.first ?? 20,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
             sort: asObjectArray(params.sort),
           });
 
           const data = await linearGraphQL<{
-            projects: { nodes: Array<JsonObject> };
+            projects: LinearConnection<JsonObject>;
           }>(
             apiKey,
             `query ListProjects(
@@ -68,7 +69,13 @@ export function projectTools() {
                 sort: $sort
               ) {
                 nodes {
-                  ${PROJECT_SELECTION}
+                  ${PROJECT_LIST_SELECTION}
+                }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
                 }
               }
             }`,
@@ -77,9 +84,10 @@ export function projectTools() {
           );
 
           const projects = data.projects.nodes;
+          const pageInfo = data.projects.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ projects }, null, 2) }],
-            details: { projects },
+            content: [{ type: 'text', text: JSON.stringify({ projects, pageInfo }, null, 2) }],
+            details: { projects, pageInfo },
           };
         });
       },
@@ -99,7 +107,7 @@ export function projectTools() {
             apiKey,
             `query GetProject($id: String!) {
               project(id: $id) {
-                ${PROJECT_SELECTION}
+                ${PROJECT_DETAIL_SELECTION}
               }
             }`,
             { id: params.projectId },
@@ -220,7 +228,7 @@ export function projectTools() {
                 projectUpdate(id: $id, input: $input) {
                   success
                   project {
-                    ${PROJECT_SELECTION}
+                    ${PROJECT_DETAIL_SELECTION}
                   }
                 }
               }`,
@@ -255,7 +263,7 @@ export function projectTools() {
               projectCreate(input: $input, slackChannelName: $slackChannelName) {
                 success
                 project {
-                  ${PROJECT_SELECTION}
+                  ${PROJECT_DETAIL_SELECTION}
                 }
               }
             }`,

package/extensions/tools/teams.ts

@@ -1,9 +1,9 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL } from '../client';
-import { PaginationParams, FilterParam } from '../params';
+import { PaginationParams, paginationVariables, FilterParam } from '../params';
 import { TEAM_SELECTION } from '../selections';
-import type { LinearTeam, JsonObject } from '../types';
+import type { LinearTeam, JsonObject, LinearConnection } from '../types';
 import { compactObject, asObject } from '../util';
 import {
   renderLinearGetTeamCall,
@@ -27,16 +27,11 @@ export function teamTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const variables = compactObject({
-            after: params.after,
-            before: params.before,
+            ...paginationVariables(params, 50),
             filter: asObject(params.filter),
-            first: params.first,
-            includeArchived: params.includeArchived,
-            last: params.last,
-            orderBy: params.orderBy,
           });
 
-          const data = await linearGraphQL<{ teams: { nodes: LinearTeam[] } }>(
+          const data = await linearGraphQL<{ teams: LinearConnection<LinearTeam> }>(
             apiKey,
             `query ListTeams(
               $after: String
@@ -66,6 +61,12 @@ export function teamTools() {
                     }
                   }
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -73,9 +74,10 @@ export function teamTools() {
           );
 
           const teams = data.teams.nodes;
+          const pageInfo = data.teams.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ teams }, null, 2) }],
-            details: { teams },
+            content: [{ type: 'text', text: JSON.stringify({ teams, pageInfo }, null, 2) }],
+            details: { teams, pageInfo },
           };
         });
       },

package/extensions/tools/users.ts

@@ -1,9 +1,9 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { withLinearAuth, linearGraphQL } from '../client';
-import { PaginationParams, FilterParam, SortParam } from '../params';
+import { PaginationParams, paginationVariables, FilterParam, SortParam } from '../params';
 import { USER_SELECTION } from '../selections';
-import type { JsonObject } from '../types';
+import type { JsonObject, LinearConnection } from '../types';
 import { compactObject, asObject, asObjectArray } from '../util';
 import {
   renderLinearGetUserCall,
@@ -28,19 +28,14 @@ export function userTools() {
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const variables = compactObject({
-            after: params.after,
-            before: params.before,
+            ...paginationVariables(params, 50),
             filter: asObject(params.filter),
-            first: params.first ?? 50,
-            includeArchived: params.includeArchived,
             includeDisabled: params.includeDisabled,
-            last: params.last,
-            orderBy: params.orderBy,
             sort: asObjectArray(params.sort),
           });
 
           const data = await linearGraphQL<{
-            users: { nodes: Array<JsonObject> };
+            users: LinearConnection<JsonObject>;
           }>(
             apiKey,
             `query ListUsers(
@@ -68,6 +63,12 @@ export function userTools() {
                 nodes {
                   ${USER_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -75,9 +76,10 @@ export function userTools() {
           );
 
           const users = data.users.nodes;
+          const pageInfo = data.users.pageInfo;
           return {
-            content: [{ type: 'text', text: JSON.stringify({ users }, null, 2) }],
-            details: { users },
+            content: [{ type: 'text', text: JSON.stringify({ users, pageInfo }, null, 2) }],
+            details: { users, pageInfo },
           };
         });
       },

package/extensions/types.ts

@@ -4,6 +4,18 @@ export type LinearGraphQLError = {
   message: string;
 };
 
+export type LinearPageInfo = {
+  hasNextPage: boolean;
+  hasPreviousPage: boolean;
+  startCursor?: string | null;
+  endCursor?: string | null;
+};
+
+export type LinearConnection<T> = {
+  nodes: T[];
+  pageInfo: LinearPageInfo;
+};
+
 export type LinearIssue = {
   id: string;
   identifier: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alasano/pi-linear",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Linear integration for pi with 55+ tools, multi-workspace auth, and per-tool settings",
   "keywords": [
     "pi-package"