@alasano/pi-linear 0.1.1 → 0.3.0

package/extensions/tools/projects.ts

@@ -1,10 +1,28 @@
 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,
+  renderLinearDeleteProjectCall,
+  renderLinearGetProjectCall,
+  renderLinearProjectListCall,
+  renderLinearProjectListResult,
+  renderLinearProjectResult,
+  renderLinearProjectSuccessResult,
+  renderLinearSaveProjectCall,
+  renderLinearSaveProjectResult,
+  renderLinearUnarchiveProjectCall,
+} from '../renderers/projects';
 
 export function projectTools() {
   return [
@@ -17,21 +35,17 @@ export function projectTools() {
         ...FilterParam,
         ...SortParam,
       }),
+      renderCall: renderLinearProjectListCall,
       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(
@@ -55,7 +69,13 @@ export function projectTools() {
                 sort: $sort
               ) {
                 nodes {
-                  ${PROJECT_SELECTION}
+                  ${PROJECT_LIST_SELECTION}
+                }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
                 }
               }
             }`,
@@ -64,12 +84,14 @@ 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 },
           };
         });
       },
+      renderResult: renderLinearProjectListResult,
     }),
     defineTool({
       name: 'linear_get_project',
@@ -78,13 +100,14 @@ export function projectTools() {
       parameters: Type.Object({
         projectId: Type.String({ description: 'Project id.' }),
       }),
+      renderCall: renderLinearGetProjectCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const data = await linearGraphQL<{ project: JsonObject | null }>(
             apiKey,
             `query GetProject($id: String!) {
               project(id: $id) {
-                ${PROJECT_SELECTION}
+                ${PROJECT_DETAIL_SELECTION}
               }
             }`,
             { id: params.projectId },
@@ -100,6 +123,7 @@ export function projectTools() {
           };
         });
       },
+      renderResult: renderLinearProjectResult('Project'),
     }),
     defineTool({
       name: 'linear_save_project',
@@ -145,6 +169,7 @@ export function projectTools() {
         slackChannelName: Type.Optional(Type.String()),
         ...RawInputParam,
       }),
+      renderCall: renderLinearSaveProjectCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const rawInput = asObject(params.input) || {};
@@ -203,7 +228,7 @@ export function projectTools() {
                 projectUpdate(id: $id, input: $input) {
                   success
                   project {
-                    ${PROJECT_SELECTION}
+                    ${PROJECT_DETAIL_SELECTION}
                   }
                 }
               }`,
@@ -238,7 +263,7 @@ export function projectTools() {
               projectCreate(input: $input, slackChannelName: $slackChannelName) {
                 success
                 project {
-                  ${PROJECT_SELECTION}
+                  ${PROJECT_DETAIL_SELECTION}
                 }
               }
             }`,
@@ -260,6 +285,7 @@ export function projectTools() {
           };
         });
       },
+      renderResult: renderLinearSaveProjectResult,
     }),
     defineTool({
       name: 'linear_delete_project',
@@ -268,6 +294,7 @@ export function projectTools() {
       parameters: Type.Object({
         projectId: Type.String(),
       }),
+      renderCall: renderLinearDeleteProjectCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const data = await linearGraphQL<{
@@ -293,6 +320,7 @@ export function projectTools() {
           };
         });
       },
+      renderResult: renderLinearProjectSuccessResult('Deleted'),
     }),
     defineTool({
       name: 'linear_archive_project',
@@ -302,6 +330,7 @@ export function projectTools() {
         projectId: Type.String(),
         trash: Type.Optional(Type.Boolean()),
       }),
+      renderCall: renderLinearArchiveProjectCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const data = await linearGraphQL<{
@@ -327,6 +356,7 @@ export function projectTools() {
           };
         });
       },
+      renderResult: renderLinearProjectSuccessResult('Archived'),
     }),
     defineTool({
       name: 'linear_unarchive_project',
@@ -335,6 +365,7 @@ export function projectTools() {
       parameters: Type.Object({
         projectId: Type.String(),
       }),
+      renderCall: renderLinearUnarchiveProjectCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const data = await linearGraphQL<{
@@ -360,6 +391,7 @@ export function projectTools() {
           };
         });
       },
+      renderResult: renderLinearProjectSuccessResult('Unarchived'),
     }),
   ];
 }

package/extensions/tools/teams.ts

@@ -1,10 +1,16 @@
 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,
+  renderLinearTeamListCall,
+  renderLinearTeamListResult,
+  renderLinearTeamResult,
+} from '../renderers/teams';
 
 export function teamTools() {
   return [
@@ -17,19 +23,15 @@ export function teamTools() {
         ...PaginationParams,
         ...FilterParam,
       }),
+      renderCall: renderLinearTeamListCall,
       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
@@ -59,6 +61,12 @@ export function teamTools() {
                     }
                   }
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -66,12 +74,14 @@ 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 },
           };
         });
       },
+      renderResult: renderLinearTeamListResult,
     }),
     defineTool({
       name: 'linear_get_team',
@@ -80,6 +90,7 @@ export function teamTools() {
       parameters: Type.Object({
         teamId: Type.String(),
       }),
+      renderCall: renderLinearGetTeamCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const data = await linearGraphQL<{ team: JsonObject | null }>(
@@ -100,6 +111,7 @@ export function teamTools() {
           };
         });
       },
+      renderResult: renderLinearTeamResult('Team'),
     }),
   ];
 }

package/extensions/tools/users.ts

@@ -1,10 +1,16 @@
 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,
+  renderLinearUserListCall,
+  renderLinearUserListResult,
+  renderLinearUserResult,
+} from '../renderers/users';
 
 export function userTools() {
   return [
@@ -18,22 +24,18 @@ export function userTools() {
         ...SortParam,
         includeDisabled: Type.Optional(Type.Boolean()),
       }),
+      renderCall: renderLinearUserListCall,
       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(
@@ -61,6 +63,12 @@ export function userTools() {
                 nodes {
                   ${USER_SELECTION}
                 }
+                pageInfo {
+                  hasNextPage
+                  hasPreviousPage
+                  startCursor
+                  endCursor
+                }
               }
             }`,
             variables,
@@ -68,12 +76,14 @@ 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 },
           };
         });
       },
+      renderResult: renderLinearUserListResult,
     }),
     defineTool({
       name: 'linear_get_user',
@@ -82,6 +92,7 @@ export function userTools() {
       parameters: Type.Object({
         userId: Type.String(),
       }),
+      renderCall: renderLinearGetUserCall,
       async execute(_toolCallId, params, signal, _onUpdate, ctx) {
         return withLinearAuth(ctx, signal, async (apiKey) => {
           const data = await linearGraphQL<{ user: JsonObject | null }>(
@@ -102,6 +113,7 @@ export function userTools() {
           };
         });
       },
+      renderResult: renderLinearUserResult,
     }),
   ];
 }

package/extensions/tools/workspaces.ts

@@ -1,6 +1,10 @@
 import { defineTool } from '@mariozechner/pi-coding-agent';
 import { Type } from '@sinclair/typebox';
 import { switchWorkspace, type WorkspaceCredentials } from '../client';
+import {
+  renderLinearSwitchWorkspaceCall,
+  renderLinearSwitchWorkspaceResult,
+} from '../renderers/workspaces';
 
 export function workspaceTools(creds: WorkspaceCredentials) {
   const names = Object.keys(creds.workspaces);
@@ -16,6 +20,7 @@ export function workspaceTools(creds: WorkspaceCredentials) {
           description: `Workspace name to switch to. One of: ${names.join(', ')}`,
         }),
       }),
+      renderCall: renderLinearSwitchWorkspaceCall,
       async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
         const updated = await switchWorkspace(params.name);
         return {
@@ -28,6 +33,7 @@ export function workspaceTools(creds: WorkspaceCredentials) {
           details: { active: updated.activeWorkspace },
         };
       },
+      renderResult: renderLinearSwitchWorkspaceResult,
     }),
   ];
 }

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.1.1",
+  "version": "0.3.0",
   "description": "Linear integration for pi with 55+ tools, multi-workspace auth, and per-tool settings",
   "keywords": [
     "pi-package"