@opentabs-dev/opentabs-plugin-linear 0.0.74

package/dist/tools/list-projects.js

@@ -0,0 +1,45 @@
+import { graphql } from '../linear-api.js';
+import { ToolError, defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { mapProject, paginationSchema, projectSchema } from './schemas.js';
+export const listProjects = defineTool({
+    name: 'list_projects',
+    displayName: 'List Projects',
+    description: 'List all projects in the Linear workspace. Supports pagination.',
+    summary: 'List all projects',
+    icon: 'folder',
+    group: 'Projects',
+    input: z.object({
+        limit: z.number().optional().describe('Maximum number of projects to return (default 25, max 50)'),
+        after: z.string().optional().describe('Pagination cursor from a previous response'),
+    }),
+    output: z.object({
+        projects: z.array(projectSchema).describe('List of projects'),
+        pagination: paginationSchema.describe('Pagination info for fetching more results'),
+    }),
+    handle: async (params) => {
+        const limit = Math.min(params.limit ?? 25, 50);
+        const data = await graphql(`query ListProjects($first: Int, $after: String) {
+        projects(first: $first, after: $after, orderBy: updatedAt) {
+          nodes {
+            id name description url createdAt updatedAt
+            targetDate startDate
+            status { name }
+            lead { name displayName }
+          }
+          pageInfo { hasNextPage endCursor }
+        }
+      }`, { first: limit, after: params.after });
+        if (!data.projects)
+            throw ToolError.internal('Projects query returned no results object');
+        const result = data.projects;
+        return {
+            projects: result.nodes.map(n => mapProject(n)),
+            pagination: {
+                has_next_page: result.pageInfo?.hasNextPage ?? false,
+                end_cursor: result.pageInfo?.endCursor ?? '',
+            },
+        };
+    },
+});
+//# sourceMappingURL=list-projects.js.map

package/dist/tools/list-projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-projects.js","sourceRoot":"","sources":["../../src/tools/list-projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;IACrC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,eAAe;IAC5B,WAAW,EAAE,iEAAiE;IAC9E,OAAO,EAAE,mBAAmB;IAC5B,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;QAClG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KACpF,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC7D,UAAU,EAAE,gBAAgB,CAAC,QAAQ,CAAC,2CAA2C,CAAC;KACnF,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAE/C,MAAM,IAAI,GAAG,MAAM,OAAO,CAMxB;;;;;;;;;;QAUE,EACF,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CACtC,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,2CAA2C,CAAC,CAAC;QAC1F,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC7B,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAqC,CAAC,CAAC;YAClF,UAAU,EAAE;gBACV,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,IAAI,KAAK;gBACpD,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,IAAI,EAAE;aAC7C;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/list-teams.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export declare const listTeams: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+    teams: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        key: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=list-teams.d.ts.map

package/dist/tools/list-teams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-teams.d.ts","sourceRoot":"","sources":["../../src/tools/list-teams.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,SAAS;;;;;;;kBA4BpB,CAAC"}

package/dist/tools/list-teams.js

@@ -0,0 +1,29 @@
+import { graphql } from '../linear-api.js';
+import { defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { mapTeam, teamSchema } from './schemas.js';
+export const listTeams = defineTool({
+    name: 'list_teams',
+    displayName: 'List Teams',
+    description: 'List all teams in the Linear workspace that the current user can access.',
+    summary: 'List teams in the workspace',
+    icon: 'users',
+    group: 'Teams & Users',
+    input: z.object({}),
+    output: z.object({
+        teams: z.array(teamSchema).describe('List of teams'),
+    }),
+    handle: async () => {
+        const data = await graphql(`query ListTeams {
+        teams {
+          nodes {
+            id key name description
+          }
+        }
+      }`);
+        return {
+            teams: data.teams.nodes.map(n => mapTeam(n)),
+        };
+    },
+});
+//# sourceMappingURL=list-teams.js.map

package/dist/tools/list-teams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-teams.js","sourceRoot":"","sources":["../../src/tools/list-teams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,0EAA0E;IACvF,OAAO,EAAE,6BAA6B;IACtC,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,eAAe;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;KACrD,CAAC;IACF,MAAM,EAAE,KAAK,IAAI,EAAE;QACjB,MAAM,IAAI,GAAG,MAAM,OAAO,CAGxB;;;;;;QAME,CACH,CAAC;QAEF,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAkC,CAAC,CAAC;SAC9E,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/list-users.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export declare const listUsers: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    after: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    users: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        email: z.ZodString;
+        display_name: z.ZodString;
+        active: z.ZodBoolean;
+        admin: z.ZodBoolean;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        has_next_page: z.ZodBoolean;
+        end_cursor: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>>;
+//# sourceMappingURL=list-users.d.ts.map

package/dist/tools/list-users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-users.d.ts","sourceRoot":"","sources":["../../src/tools/list-users.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;kBA6CpB,CAAC"}

package/dist/tools/list-users.js

@@ -0,0 +1,42 @@
+import { graphql } from '../linear-api.js';
+import { ToolError, defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { mapUser, paginationSchema, userSchema } from './schemas.js';
+export const listUsers = defineTool({
+    name: 'list_users',
+    displayName: 'List Users',
+    description: 'List all users in the Linear organization. Use this to find user IDs for assigning issues.',
+    summary: 'List all users in the organization',
+    icon: 'users',
+    group: 'Teams & Users',
+    input: z.object({
+        limit: z.number().optional().describe('Maximum number of users to return (default 50, max 100)'),
+        after: z.string().optional().describe('Pagination cursor from a previous response'),
+    }),
+    output: z.object({
+        users: z.array(userSchema).describe('List of users'),
+        pagination: paginationSchema.describe('Pagination info for fetching more results'),
+    }),
+    handle: async (params) => {
+        const limit = Math.min(params.limit ?? 50, 100);
+        const data = await graphql(`query ListUsers($first: Int, $after: String) {
+        users(first: $first, after: $after) {
+          nodes {
+            id name email displayName active admin
+          }
+          pageInfo { hasNextPage endCursor }
+        }
+      }`, { first: limit, after: params.after });
+        if (!data.users)
+            throw ToolError.internal('Users query returned no results object');
+        const result = data.users;
+        return {
+            users: result.nodes.map(n => mapUser(n)),
+            pagination: {
+                has_next_page: result.pageInfo?.hasNextPage ?? false,
+                end_cursor: result.pageInfo?.endCursor ?? '',
+            },
+        };
+    },
+});
+//# sourceMappingURL=list-users.js.map

package/dist/tools/list-users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-users.js","sourceRoot":"","sources":["../../src/tools/list-users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,4FAA4F;IACzG,OAAO,EAAE,oCAAoC;IAC7C,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,eAAe;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;QAChG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KACpF,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;QACpD,UAAU,EAAE,gBAAgB,CAAC,QAAQ,CAAC,2CAA2C,CAAC;KACnF,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAEhD,MAAM,IAAI,GAAG,MAAM,OAAO,CAMxB;;;;;;;QAOE,EACF,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CACtC,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC;QACpF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAkC,CAAC,CAAC;YACzE,UAAU,EAAE;gBACV,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,IAAI,KAAK;gBACpD,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,IAAI,EAAE;aAC7C;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/list-workflow-states.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const listWorkflowStates: import("@opentabs-dev/plugin-sdk").ToolDefinition<z.ZodObject<{
+    team_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    states: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodString;
+        color: z.ZodString;
+        position: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=list-workflow-states.d.ts.map

package/dist/tools/list-workflow-states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-workflow-states.d.ts","sourceRoot":"","sources":["../../src/tools/list-workflow-states.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,kBAAkB;;;;;;;;;;kBAuC7B,CAAC"}

package/dist/tools/list-workflow-states.js

@@ -0,0 +1,36 @@
+import { graphql } from '../linear-api.js';
+import { ToolError, defineTool } from '@opentabs-dev/plugin-sdk';
+import { z } from 'zod';
+import { mapWorkflowState, workflowStateSchema } from './schemas.js';
+export const listWorkflowStates = defineTool({
+    name: 'list_workflow_states',
+    displayName: 'List Workflow States',
+    description: 'List all workflow states for a team. Use this to find state IDs for filtering issues or updating issue state.',
+    summary: 'List workflow states for a team',
+    icon: 'git-branch',
+    group: 'Workflow',
+    input: z.object({
+        team_id: z.string().describe('Team UUID to list workflow states for (use list_teams to find IDs)'),
+    }),
+    output: z.object({
+        states: z.array(workflowStateSchema).describe('List of workflow states ordered by position'),
+    }),
+    handle: async (params) => {
+        const data = await graphql(`query ListWorkflowStates($id: String!) {
+        team(id: $id) {
+          states {
+            nodes {
+              id name type color position
+            }
+          }
+        }
+      }`, { id: params.team_id });
+        if (!data.team)
+            throw ToolError.notFound('Team not found');
+        const nodes = data.team.states.nodes
+            .map(n => mapWorkflowState(n))
+            .sort((a, b) => a.position - b.position);
+        return { states: nodes };
+    },
+});
+//# sourceMappingURL=list-workflow-states.js.map

package/dist/tools/list-workflow-states.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-workflow-states.js","sourceRoot":"","sources":["../../src/tools/list-workflow-states.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;IAC3C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,sBAAsB;IACnC,WAAW,EACT,+GAA+G;IACjH,OAAO,EAAE,iCAAiC;IAC1C,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;KACnG,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KAC7F,CAAC;IACF,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QACrB,MAAM,IAAI,GAAG,MAAM,OAAO,CAKxB;;;;;;;;QAQE,EACF,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,CACvB,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAA2C,CAAC,CAAC;aACvE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAE3C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/schemas.d.ts

@@ -0,0 +1,269 @@
+import { z } from 'zod';
+export declare const issueSchema: z.ZodObject<{
+    id: z.ZodString;
+    identifier: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    priority: z.ZodNumber;
+    priority_label: z.ZodString;
+    state_name: z.ZodString;
+    state_type: z.ZodString;
+    assignee_name: z.ZodString;
+    team_key: z.ZodString;
+    team_name: z.ZodString;
+    label_names: z.ZodArray<z.ZodString>;
+    project_name: z.ZodString;
+    cycle_number: z.ZodNumber;
+    due_date: z.ZodString;
+    estimate: z.ZodNumber;
+    url: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export declare const commentSchema: z.ZodObject<{
+    id: z.ZodString;
+    body: z.ZodString;
+    user_name: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    edited_at: z.ZodString;
+}, z.core.$strip>;
+export declare const projectSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    state: z.ZodString;
+    lead_name: z.ZodString;
+    target_date: z.ZodString;
+    start_date: z.ZodString;
+    url: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export declare const teamSchema: z.ZodObject<{
+    id: z.ZodString;
+    key: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strip>;
+export declare const workflowStateSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodString;
+    color: z.ZodString;
+    position: z.ZodNumber;
+}, z.core.$strip>;
+export declare const labelSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    color: z.ZodString;
+    description: z.ZodString;
+    is_group: z.ZodBoolean;
+    parent_name: z.ZodString;
+}, z.core.$strip>;
+export declare const userSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    email: z.ZodString;
+    display_name: z.ZodString;
+    active: z.ZodBoolean;
+    admin: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const cycleSchema: z.ZodObject<{
+    id: z.ZodString;
+    number: z.ZodNumber;
+    name: z.ZodString;
+    starts_at: z.ZodString;
+    ends_at: z.ZodString;
+    is_active: z.ZodBoolean;
+    completed_at: z.ZodString;
+}, z.core.$strip>;
+export declare const paginationSchema: z.ZodObject<{
+    has_next_page: z.ZodBoolean;
+    end_cursor: z.ZodString;
+}, z.core.$strip>;
+interface RawIssue {
+    id?: string;
+    identifier?: string;
+    title?: string;
+    description?: string;
+    priority?: number;
+    priorityLabel?: string;
+    state?: {
+        name?: string;
+        type?: string;
+    };
+    assignee?: {
+        name?: string;
+        displayName?: string;
+    };
+    team?: {
+        key?: string;
+        name?: string;
+    };
+    labels?: {
+        nodes?: Array<{
+            name?: string;
+        }>;
+    };
+    project?: {
+        name?: string;
+    };
+    cycle?: {
+        number?: number;
+    };
+    dueDate?: string;
+    estimate?: number;
+    url?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export declare const mapIssue: (i: RawIssue | undefined) => {
+    id: string;
+    identifier: string;
+    title: string;
+    description: string;
+    priority: number;
+    priority_label: string;
+    state_name: string;
+    state_type: string;
+    assignee_name: string;
+    team_key: string;
+    team_name: string;
+    label_names: string[];
+    project_name: string;
+    cycle_number: number;
+    due_date: string;
+    estimate: number;
+    url: string;
+    created_at: string;
+    updated_at: string;
+};
+interface RawComment {
+    id?: string;
+    body?: string;
+    user?: {
+        name?: string;
+        displayName?: string;
+    };
+    createdAt?: string;
+    updatedAt?: string;
+    editedAt?: string;
+}
+export declare const mapComment: (c: RawComment | undefined) => {
+    id: string;
+    body: string;
+    user_name: string;
+    created_at: string;
+    updated_at: string;
+    edited_at: string;
+};
+interface RawProject {
+    id?: string;
+    name?: string;
+    description?: string;
+    status?: {
+        name?: string;
+    };
+    lead?: {
+        name?: string;
+        displayName?: string;
+    };
+    targetDate?: string;
+    startDate?: string;
+    url?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export declare const mapProject: (p: RawProject | undefined) => {
+    id: string;
+    name: string;
+    description: string;
+    state: string;
+    lead_name: string;
+    target_date: string;
+    start_date: string;
+    url: string;
+    created_at: string;
+    updated_at: string;
+};
+interface RawTeam {
+    id?: string;
+    key?: string;
+    name?: string;
+    description?: string;
+}
+export declare const mapTeam: (t: RawTeam | undefined) => {
+    id: string;
+    key: string;
+    name: string;
+    description: string;
+};
+interface RawWorkflowState {
+    id?: string;
+    name?: string;
+    type?: string;
+    color?: string;
+    position?: number;
+}
+export declare const mapWorkflowState: (s: RawWorkflowState | undefined) => {
+    id: string;
+    name: string;
+    type: string;
+    color: string;
+    position: number;
+};
+interface RawLabel {
+    id?: string;
+    name?: string;
+    color?: string;
+    description?: string;
+    isGroup?: boolean;
+    parent?: {
+        name?: string;
+    };
+}
+export declare const mapLabel: (l: RawLabel | undefined) => {
+    id: string;
+    name: string;
+    color: string;
+    description: string;
+    is_group: boolean;
+    parent_name: string;
+};
+interface RawUser {
+    id?: string;
+    name?: string;
+    email?: string;
+    displayName?: string;
+    active?: boolean;
+    admin?: boolean;
+}
+export declare const mapUser: (u: RawUser | undefined) => {
+    id: string;
+    name: string;
+    email: string;
+    display_name: string;
+    active: boolean;
+    admin: boolean;
+};
+interface RawCycle {
+    id?: string;
+    number?: number;
+    name?: string;
+    startsAt?: string;
+    endsAt?: string;
+    isActive?: boolean;
+    completedAt?: string;
+}
+export declare const mapCycle: (c: RawCycle | undefined) => {
+    id: string;
+    number: number;
+    name: string;
+    starts_at: string;
+    ends_at: string;
+    is_active: boolean;
+    completed_at: string;
+};
+export {};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"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"}

package/dist/tools/schemas.js

@@ -0,0 +1,165 @@
+import { z } from 'zod';
+// --- Shared output schemas ---
+export const issueSchema = z.object({
+    id: z.string().describe('Issue UUID'),
+    identifier: z.string().describe('Human-readable issue identifier (e.g. ENG-123)'),
+    title: z.string().describe('Issue title'),
+    description: z.string().describe('Issue description in markdown'),
+    priority: z.number().describe('Priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)'),
+    priority_label: z.string().describe('Human-readable priority label'),
+    state_name: z.string().describe('Current workflow state name'),
+    state_type: z.string().describe('Workflow state type (triage, backlog, unstarted, started, completed, canceled)'),
+    assignee_name: z.string().describe('Assignee display name, or empty if unassigned'),
+    team_key: z.string().describe('Team key/identifier'),
+    team_name: z.string().describe('Team name'),
+    label_names: z.array(z.string()).describe('List of label names applied to this issue'),
+    project_name: z.string().describe('Project name, or empty if not in a project'),
+    cycle_number: z.number().describe('Cycle number, or 0 if not in a cycle'),
+    due_date: z.string().describe('Due date (YYYY-MM-DD), or empty if none'),
+    estimate: z.number().describe('Estimate points, or 0 if none'),
+    url: z.string().describe('URL to the issue in Linear'),
+    created_at: z.string().describe('ISO 8601 creation timestamp'),
+    updated_at: z.string().describe('ISO 8601 last update timestamp'),
+});
+export const commentSchema = z.object({
+    id: z.string().describe('Comment UUID'),
+    body: z.string().describe('Comment body in markdown'),
+    user_name: z.string().describe('Author display name'),
+    created_at: z.string().describe('ISO 8601 creation timestamp'),
+    updated_at: z.string().describe('ISO 8601 last update timestamp'),
+    edited_at: z.string().describe('ISO 8601 edited timestamp, or empty if not edited'),
+});
+export const projectSchema = z.object({
+    id: z.string().describe('Project UUID'),
+    name: z.string().describe('Project name'),
+    description: z.string().describe('Project description'),
+    state: z.string().describe('Project status name'),
+    lead_name: z.string().describe('Project lead display name, or empty if none'),
+    target_date: z.string().describe('Target completion date (YYYY-MM-DD), or empty'),
+    start_date: z.string().describe('Start date (YYYY-MM-DD), or empty'),
+    url: z.string().describe('URL to the project in Linear'),
+    created_at: z.string().describe('ISO 8601 creation timestamp'),
+    updated_at: z.string().describe('ISO 8601 last update timestamp'),
+});
+export const teamSchema = z.object({
+    id: z.string().describe('Team UUID'),
+    key: z.string().describe('Team key used as issue identifier prefix'),
+    name: z.string().describe('Team name'),
+    description: z.string().describe('Team description'),
+});
+export const workflowStateSchema = z.object({
+    id: z.string().describe('Workflow state UUID'),
+    name: z.string().describe('State name (e.g. Todo, In Progress, Done)'),
+    type: z.string().describe('State type (triage, backlog, unstarted, started, completed, canceled)'),
+    color: z.string().describe('State color hex code'),
+    position: z.number().describe('Sort position within the workflow'),
+});
+export const labelSchema = z.object({
+    id: z.string().describe('Label UUID'),
+    name: z.string().describe('Label name'),
+    color: z.string().describe('Label color hex code'),
+    description: z.string().describe('Label description'),
+    is_group: z.boolean().describe('Whether this is a group label (parent)'),
+    parent_name: z.string().describe('Parent group label name, or empty if top-level'),
+});
+export const userSchema = z.object({
+    id: z.string().describe('User UUID'),
+    name: z.string().describe('User display name'),
+    email: z.string().describe('User email address'),
+    display_name: z.string().describe('User display name'),
+    active: z.boolean().describe('Whether the user is active'),
+    admin: z.boolean().describe('Whether the user is an admin'),
+});
+export const cycleSchema = z.object({
+    id: z.string().describe('Cycle UUID'),
+    number: z.number().describe('Cycle number'),
+    name: z.string().describe('Cycle name, or empty'),
+    starts_at: z.string().describe('ISO 8601 cycle start date'),
+    ends_at: z.string().describe('ISO 8601 cycle end date'),
+    is_active: z.boolean().describe('Whether this is the currently active cycle'),
+    completed_at: z.string().describe('ISO 8601 completion timestamp, or empty'),
+});
+export const paginationSchema = z.object({
+    has_next_page: z.boolean().describe('Whether there are more results after this page'),
+    end_cursor: z.string().describe('Cursor for fetching the next page, or empty'),
+});
+export const mapIssue = (i) => ({
+    id: i?.id ?? '',
+    identifier: i?.identifier ?? '',
+    title: i?.title ?? '',
+    description: i?.description ?? '',
+    priority: i?.priority ?? 0,
+    priority_label: i?.priorityLabel ?? '',
+    state_name: i?.state?.name ?? '',
+    state_type: i?.state?.type ?? '',
+    assignee_name: i?.assignee?.displayName ?? i?.assignee?.name ?? '',
+    team_key: i?.team?.key ?? '',
+    team_name: i?.team?.name ?? '',
+    label_names: (i?.labels?.nodes ?? []).map(l => l?.name ?? '').filter(Boolean),
+    project_name: i?.project?.name ?? '',
+    cycle_number: i?.cycle?.number ?? 0,
+    due_date: i?.dueDate ?? '',
+    estimate: i?.estimate ?? 0,
+    url: i?.url ?? '',
+    created_at: i?.createdAt ?? '',
+    updated_at: i?.updatedAt ?? '',
+});
+export const mapComment = (c) => ({
+    id: c?.id ?? '',
+    body: c?.body ?? '',
+    user_name: c?.user?.displayName ?? c?.user?.name ?? '',
+    created_at: c?.createdAt ?? '',
+    updated_at: c?.updatedAt ?? '',
+    edited_at: c?.editedAt ?? '',
+});
+export const mapProject = (p) => ({
+    id: p?.id ?? '',
+    name: p?.name ?? '',
+    description: p?.description ?? '',
+    state: p?.status?.name ?? '',
+    lead_name: p?.lead?.displayName ?? p?.lead?.name ?? '',
+    target_date: p?.targetDate ?? '',
+    start_date: p?.startDate ?? '',
+    url: p?.url ?? '',
+    created_at: p?.createdAt ?? '',
+    updated_at: p?.updatedAt ?? '',
+});
+export const mapTeam = (t) => ({
+    id: t?.id ?? '',
+    key: t?.key ?? '',
+    name: t?.name ?? '',
+    description: t?.description ?? '',
+});
+export const mapWorkflowState = (s) => ({
+    id: s?.id ?? '',
+    name: s?.name ?? '',
+    type: s?.type ?? '',
+    color: s?.color ?? '',
+    position: s?.position ?? 0,
+});
+export const mapLabel = (l) => ({
+    id: l?.id ?? '',
+    name: l?.name ?? '',
+    color: l?.color ?? '',
+    description: l?.description ?? '',
+    is_group: l?.isGroup ?? false,
+    parent_name: l?.parent?.name ?? '',
+});
+export const mapUser = (u) => ({
+    id: u?.id ?? '',
+    name: u?.name ?? '',
+    email: u?.email ?? '',
+    display_name: u?.displayName ?? u?.name ?? '',
+    active: u?.active ?? false,
+    admin: u?.admin ?? false,
+});
+export const mapCycle = (c) => ({
+    id: c?.id ?? '',
+    number: c?.number ?? 0,
+    name: c?.name ?? '',
+    starts_at: c?.startsAt ?? '',
+    ends_at: c?.endsAt ?? '',
+    is_active: c?.isActive ?? false,
+    completed_at: c?.completedAt ?? '',
+});
+//# sourceMappingURL=schemas.js.map