@alasano/pi-linear 0.1.1 → 0.3.0

package/extensions/tools/issue-statuses.ts

@@ -1,10 +1,14 @@
 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,
+  renderLinearIssueStatusListResult,
+} from '../renderers/issue-statuses';
 
 export function issueStatusTools() {
   return [
@@ -17,20 +21,16 @@ export function issueStatusTools() {
         ...PaginationParams,
         ...FilterParam,
       }),
+      renderCall: renderLinearIssueStatusListCall,
       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(
@@ -54,6 +54,12 @@ export function issueStatusTools() {
                 nodes {
                   ${WORKFLOW_STATE_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -61,12 +67,14 @@ 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 },
           };
         });
       },
+      renderResult: renderLinearIssueStatusListResult,
     }),
   ];
 }

package/extensions/tools/issues.ts

@@ -9,14 +9,28 @@ 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,
+  renderLinearCreateIssueCall,
+  renderLinearDeleteIssueCall,
+  renderLinearGetIssueCall,
+  renderLinearIssueListCall,
+  renderLinearIssueListResult,
+  renderLinearIssueResult,
+  renderLinearIssueSearchCall,
+  renderLinearIssueSuccessResult,
+  renderLinearUnarchiveIssueCall,
+  renderLinearUpdateIssueCall,
+} from '../renderers/issues';
 
 export function issueTools() {
   return [
@@ -46,6 +60,7 @@ export function issueTools() {
         ...FilterParam,
         ...SortParam,
       }),
+      renderCall: renderLinearIssueListCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const convenienceFilter = compactObject({
@@ -65,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
@@ -100,6 +110,12 @@ export function issueTools() {
                 nodes {
                   ${ISSUE_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -107,12 +123,14 @@ 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 },
           };
         });
       },
+      renderResult: renderLinearIssueListResult,
     }),
     defineTool({
       name: 'linear_get_issue',
@@ -123,6 +141,7 @@ export function issueTools() {
           description: 'Issue identifier (ENG-123) or issue id.',
         }),
       }),
+      renderCall: renderLinearGetIssueCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const issueRef = params.issue.trim();
@@ -149,6 +168,7 @@ export function issueTools() {
           };
         });
       },
+      renderResult: renderLinearIssueResult('Issue'),
     }),
     defineTool({
       name: 'linear_create_issue',
@@ -232,6 +252,7 @@ export function issueTools() {
         ),
         ...RawInputParam,
       }),
+      renderCall: renderLinearCreateIssueCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const rawInput = asObject(params.input) || {};
@@ -320,6 +341,7 @@ export function issueTools() {
           };
         });
       },
+      renderResult: renderLinearIssueResult('Created issue'),
     }),
     defineTool({
       name: 'linear_update_issue',
@@ -404,6 +426,7 @@ export function issueTools() {
         trashed: Type.Optional(Type.Boolean({ description: 'IssueUpdateInput.trashed' })),
         ...RawInputParam,
       }),
+      renderCall: renderLinearUpdateIssueCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const issueId = await resolveIssueId(apiKey, params.issue, signal);
@@ -484,6 +507,7 @@ export function issueTools() {
           };
         });
       },
+      renderResult: renderLinearIssueResult('Updated issue'),
     }),
     defineTool({
       name: 'linear_delete_issue',
@@ -495,6 +519,7 @@ export function issueTools() {
         }),
         permanentlyDelete: Type.Optional(Type.Boolean()),
       }),
+      renderCall: renderLinearDeleteIssueCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const issueId = await resolveIssueId(apiKey, params.issue, signal);
@@ -522,6 +547,7 @@ export function issueTools() {
           };
         });
       },
+      renderResult: renderLinearIssueSuccessResult('Deleted'),
     }),
     defineTool({
       name: 'linear_archive_issue',
@@ -534,6 +560,7 @@ export function issueTools() {
         }),
         trash: Type.Optional(Type.Boolean()),
       }),
+      renderCall: renderLinearArchiveIssueCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const issueId = await resolveIssueId(apiKey, params.issue, signal);
@@ -561,6 +588,7 @@ export function issueTools() {
           };
         });
       },
+      renderResult: renderLinearIssueSuccessResult('Archived'),
     }),
     defineTool({
       name: 'linear_unarchive_issue',
@@ -571,6 +599,7 @@ export function issueTools() {
           description: 'Issue identifier (ENG-123) or issue id.',
         }),
       }),
+      renderCall: renderLinearUnarchiveIssueCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const issueId = await resolveIssueId(apiKey, params.issue, signal);
@@ -598,6 +627,7 @@ export function issueTools() {
           };
         });
       },
+      renderResult: renderLinearIssueSuccessResult('Unarchived'),
     }),
     defineTool({
       name: 'linear_search_issues',
@@ -610,23 +640,19 @@ export function issueTools() {
         ...PaginationParams,
         ...FilterParam,
       }),
+      renderCall: renderLinearIssueSearchCall,
       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(
@@ -656,6 +682,12 @@ export function issueTools() {
                 nodes {
                   ${ISSUE_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -663,12 +695,14 @@ 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 },
           };
         });
       },
+      renderResult: renderLinearIssueListResult,
     }),
   ];
 }

package/extensions/tools/milestones.ts

@@ -1,10 +1,20 @@
 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,
+  renderLinearMilestoneDeleteResult,
+  renderLinearMilestoneGetCall,
+  renderLinearMilestoneListCall,
+  renderLinearMilestoneListResult,
+  renderLinearMilestoneResult,
+  renderLinearMilestoneSaveCall,
+  renderLinearMilestoneSaveResult,
+} from '../renderers/milestones';
 
 export function milestoneTools() {
   return [
@@ -16,20 +26,16 @@ export function milestoneTools() {
         ...PaginationParams,
         ...FilterParam,
       }),
+      renderCall: renderLinearMilestoneListCall,
       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(
@@ -53,6 +59,12 @@ export function milestoneTools() {
                 nodes {
                   ${MILESTONE_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -60,12 +72,14 @@ 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 },
           };
         });
       },
+      renderResult: renderLinearMilestoneListResult,
     }),
     defineTool({
       name: 'linear_get_milestone',
@@ -74,6 +88,7 @@ export function milestoneTools() {
       parameters: Type.Object({
         milestoneId: Type.String(),
       }),
+      renderCall: renderLinearMilestoneGetCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const data = await linearGraphQL<{
@@ -98,6 +113,7 @@ export function milestoneTools() {
           };
         });
       },
+      renderResult: renderLinearMilestoneResult('Milestone'),
     }),
     defineTool({
       name: 'linear_save_milestone',
@@ -115,6 +131,7 @@ export function milestoneTools() {
         targetDate: Type.Optional(Type.String()),
         ...RawInputParam,
       }),
+      renderCall: renderLinearMilestoneSaveCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const rawInput = asObject(params.input) || {};
@@ -212,6 +229,7 @@ export function milestoneTools() {
           };
         });
       },
+      renderResult: renderLinearMilestoneSaveResult(),
     }),
     defineTool({
       name: 'linear_delete_milestone',
@@ -220,6 +238,7 @@ export function milestoneTools() {
       parameters: Type.Object({
         milestoneId: Type.String(),
       }),
+      renderCall: renderLinearMilestoneDeleteCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const data = await linearGraphQL<{
@@ -245,6 +264,7 @@ export function milestoneTools() {
           };
         });
       },
+      renderResult: renderLinearMilestoneDeleteResult,
     }),
   ];
 }

package/extensions/tools/project-labels.ts

@@ -1,10 +1,19 @@
 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,
+  renderLinearDeleteProjectLabelCall,
+  renderLinearProjectLabelDeleteResult,
+  renderLinearProjectLabelListCall,
+  renderLinearProjectLabelListResult,
+  renderLinearProjectLabelResult,
+  renderLinearUpdateProjectLabelCall,
+} from '../renderers/project-labels';
 
 export function projectLabelTools() {
   return [
@@ -16,20 +25,16 @@ export function projectLabelTools() {
         ...PaginationParams,
         ...FilterParam,
       }),
+      renderCall: renderLinearProjectLabelListCall,
       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(
@@ -53,6 +58,12 @@ export function projectLabelTools() {
                 nodes {
                   ${PROJECT_LABEL_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -60,12 +71,14 @@ 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 },
           };
         });
       },
+      renderResult: renderLinearProjectLabelListResult,
     }),
     defineTool({
       name: 'linear_create_project_label',
@@ -79,6 +92,7 @@ export function projectLabelTools() {
         isGroup: Type.Optional(Type.Boolean()),
         ...RawInputParam,
       }),
+      renderCall: renderLinearCreateProjectLabelCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const rawInput = asObject(params.input) || {};
@@ -127,6 +141,7 @@ export function projectLabelTools() {
           };
         });
       },
+      renderResult: renderLinearProjectLabelResult('Created project label'),
     }),
     defineTool({
       name: 'linear_update_project_label',
@@ -141,6 +156,7 @@ export function projectLabelTools() {
         isGroup: Type.Optional(Type.Boolean()),
         ...RawInputParam,
       }),
+      renderCall: renderLinearUpdateProjectLabelCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const rawInput = asObject(params.input) || {};
@@ -189,6 +205,7 @@ export function projectLabelTools() {
           };
         });
       },
+      renderResult: renderLinearProjectLabelResult('Updated project label'),
     }),
     defineTool({
       name: 'linear_delete_project_label',
@@ -197,6 +214,7 @@ export function projectLabelTools() {
       parameters: Type.Object({
         id: Type.String(),
       }),
+      renderCall: renderLinearDeleteProjectLabelCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const data = await linearGraphQL<{
@@ -222,6 +240,7 @@ export function projectLabelTools() {
           };
         });
       },
+      renderResult: renderLinearProjectLabelDeleteResult,
     }),
   ];
 }

package/extensions/tools/project-relations.ts

@@ -1,10 +1,19 @@
 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,
+  renderLinearDeleteProjectRelationCall,
+  renderLinearDeleteProjectRelationResult,
+  renderLinearProjectRelationListCall,
+  renderLinearProjectRelationListResult,
+  renderLinearProjectRelationResult,
+  renderLinearUpdateProjectRelationCall,
+} from '../renderers/project-relations';
 
 export function projectRelationTools() {
   return [
@@ -15,19 +24,13 @@ export function projectRelationTools() {
       parameters: Type.Object({
         ...PaginationParams,
       }),
+      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(
@@ -49,6 +52,12 @@ export function projectRelationTools() {
                 nodes {
                   ${PROJECT_RELATION_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -56,12 +65,16 @@ 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 },
           };
         });
       },
+      renderResult: renderLinearProjectRelationListResult,
     }),
     defineTool({
       name: 'linear_create_project_relation',
@@ -78,6 +91,7 @@ export function projectRelationTools() {
         projectMilestoneId: Type.Optional(Type.String()),
         relatedProjectMilestoneId: Type.Optional(Type.String()),
       }),
+      renderCall: renderLinearCreateProjectRelationCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const input = compactObject({
@@ -120,6 +134,7 @@ export function projectRelationTools() {
           };
         });
       },
+      renderResult: renderLinearProjectRelationResult('Created project relation'),
     }),
     defineTool({
       name: 'linear_update_project_relation',
@@ -135,6 +150,7 @@ export function projectRelationTools() {
         projectMilestoneId: Type.Optional(Type.String()),
         relatedProjectMilestoneId: Type.Optional(Type.String()),
       }),
+      renderCall: renderLinearUpdateProjectRelationCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const input = compactObject({
@@ -181,6 +197,7 @@ export function projectRelationTools() {
           };
         });
       },
+      renderResult: renderLinearProjectRelationResult('Updated project relation'),
     }),
     defineTool({
       name: 'linear_delete_project_relation',
@@ -189,6 +206,7 @@ export function projectRelationTools() {
       parameters: Type.Object({
         id: Type.String(),
       }),
+      renderCall: renderLinearDeleteProjectRelationCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const data = await linearGraphQL<{
@@ -214,6 +232,7 @@ export function projectRelationTools() {
           };
         });
       },
+      renderResult: renderLinearDeleteProjectRelationResult,
     }),
   ];
 }