@supaku/agentfactory-linear 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Supaku
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/src/agent-client.d.ts

@@ -0,0 +1,195 @@
+import { LinearClient } from '@linear/sdk';
+import type { Issue, Comment } from '@linear/sdk';
+import type { LinearAgentClientConfig, LinearWorkflowStatus, StatusMapping, AgentActivityCreateInput, AgentActivityResult, AgentSessionUpdateInput, AgentSessionUpdateResult, AgentSessionCreateOnIssueInput, AgentSessionCreateResult, IssueRelationCreateInput, IssueRelationResult, IssueRelationBatchResult, IssueRelationsResult, IssueRelationType, SubIssueGraph, SubIssueStatus } from './types';
+/**
+ * Core Linear Agent Client
+ * Wraps @linear/sdk with retry logic and helper methods
+ */
+export declare class LinearAgentClient {
+    private readonly client;
+    private readonly retryConfig;
+    private statusCache;
+    constructor(config: LinearAgentClientConfig);
+    /**
+     * Get the underlying LinearClient instance
+     */
+    get linearClient(): LinearClient;
+    /**
+     * Execute an operation with retry logic
+     */
+    private withRetry;
+    /**
+     * Fetch an issue by ID or identifier (e.g., "SUP-50")
+     */
+    getIssue(issueIdOrIdentifier: string): Promise<Issue>;
+    /**
+     * Update an issue's properties
+     */
+    updateIssue(issueId: string, data: {
+        title?: string;
+        description?: string;
+        stateId?: string;
+        assigneeId?: string | null;
+        priority?: number;
+        labelIds?: string[];
+    }): Promise<Issue>;
+    /**
+     * Remove the assignee from an issue (unassign)
+     * Used when agent completes work to enable clean handoff visibility
+     */
+    unassignIssue(issueId: string): Promise<Issue>;
+    /**
+     * Get workflow states for a team (cached)
+     */
+    getTeamStatuses(teamId: string): Promise<StatusMapping>;
+    /**
+     * Update issue status by name (e.g., "Started", "Finished")
+     */
+    updateIssueStatus(issueId: string, statusName: LinearWorkflowStatus): Promise<Issue>;
+    /**
+     * Create a comment on an issue
+     */
+    createComment(issueId: string, body: string): Promise<Comment>;
+    /**
+     * Get comments for an issue
+     */
+    getIssueComments(issueId: string): Promise<Comment[]>;
+    /**
+     * Create a new issue
+     */
+    createIssue(input: {
+        title: string;
+        description?: string;
+        teamId: string;
+        projectId?: string;
+        stateId?: string;
+        labelIds?: string[];
+        parentId?: string;
+        priority?: number;
+    }): Promise<Issue>;
+    /**
+     * Get the authenticated user (the agent)
+     */
+    getViewer(): Promise<import("@linear/sdk").User>;
+    /**
+     * Get a team by ID or key
+     */
+    getTeam(teamIdOrKey: string): Promise<import("@linear/sdk").Team>;
+    /**
+     * Create an agent activity using the native Linear Agent API
+     *
+     * @param input - The activity input containing session ID, content, and options
+     * @returns Result indicating success and the created activity ID
+     */
+    createAgentActivity(input: AgentActivityCreateInput): Promise<AgentActivityResult>;
+    /**
+     * Update an agent session
+     *
+     * Use this to set the externalUrl (linking to agent dashboard/logs)
+     * within 10 seconds of receiving a webhook to avoid appearing unresponsive.
+     *
+     * @param input - The session update input containing sessionId and updates
+     * @returns Result indicating success and the session ID
+     */
+    updateAgentSession(input: AgentSessionUpdateInput): Promise<AgentSessionUpdateResult>;
+    /**
+     * Create an agent session on an issue
+     *
+     * Use this to programmatically create a Linear AgentSession when status transitions
+     * occur without explicit agent mention/delegation (e.g., Icebox -> Backlog).
+     *
+     * This enables the Linear Agent Session UI to show real-time activities even when
+     * the agent work is triggered by status changes rather than user mentions.
+     *
+     * @param input - The session creation input containing issueId and optional external URLs
+     * @returns Result indicating success and the created session ID
+     */
+    createAgentSessionOnIssue(input: AgentSessionCreateOnIssueInput): Promise<AgentSessionCreateResult>;
+    /**
+     * Create a relation between two issues
+     *
+     * @param input - The relation input containing issue IDs and relation type
+     * @returns Result indicating success and the created relation ID
+     *
+     * Relation types:
+     * - 'related': General association between issues
+     * - 'blocks': Source issue blocks the related issue from progressing
+     * - 'duplicate': Source issue is a duplicate of the related issue
+     */
+    createIssueRelation(input: IssueRelationCreateInput): Promise<IssueRelationResult>;
+    /**
+     * Create multiple relations from a source issue to multiple target issues
+     *
+     * @param input - Batch input containing source issue, target issues, and relation type
+     * @returns Batch result with successful relation IDs and any errors
+     */
+    createIssueRelationsBatch(input: {
+        sourceIssueId: string;
+        targetIssueIds: string[];
+        type: IssueRelationType;
+    }): Promise<IssueRelationBatchResult>;
+    /**
+     * Get all relations for an issue (both outgoing and incoming)
+     *
+     * @param issueId - The issue ID or identifier (e.g., "SUP-123")
+     * @returns Relations result with both directions of relationships
+     */
+    getIssueRelations(issueId: string): Promise<IssueRelationsResult>;
+    /**
+     * Delete an issue relation
+     *
+     * @param relationId - The relation ID to delete
+     * @returns Result indicating success
+     */
+    deleteIssueRelation(relationId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Fetch all child issues (sub-issues) of a parent issue
+     *
+     * @param issueIdOrIdentifier - The parent issue ID or identifier (e.g., "SUP-100")
+     * @returns Array of child issues
+     */
+    getSubIssues(issueIdOrIdentifier: string): Promise<Issue[]>;
+    /**
+     * Check if an issue has a parent (is a child/sub-issue)
+     *
+     * @param issueIdOrIdentifier - The issue ID or identifier
+     * @returns True if the issue has a parent issue
+     */
+    isChildIssue(issueIdOrIdentifier: string): Promise<boolean>;
+    /**
+     * Check if an issue has child issues (is a parent issue)
+     *
+     * @param issueIdOrIdentifier - The issue ID or identifier
+     * @returns True if the issue has at least one child issue
+     */
+    isParentIssue(issueIdOrIdentifier: string): Promise<boolean>;
+    /**
+     * Get lightweight sub-issue statuses (no blocking relations)
+     *
+     * Returns identifier, title, and status for each sub-issue.
+     * Used by QA and acceptance agents to validate sub-issue completion
+     * without the overhead of fetching the full dependency graph.
+     *
+     * @param issueIdOrIdentifier - The parent issue ID or identifier
+     * @returns Array of sub-issue statuses
+     */
+    getSubIssueStatuses(issueIdOrIdentifier: string): Promise<SubIssueStatus[]>;
+    /**
+     * Get sub-issues with their blocking relations for dependency graph building
+     *
+     * Builds a complete dependency graph of a parent issue's children, including
+     * which sub-issues block which other sub-issues. This is used by the coordinator
+     * agent to determine execution order.
+     *
+     * @param issueIdOrIdentifier - The parent issue ID or identifier
+     * @returns The sub-issue dependency graph
+     */
+    getSubIssueGraph(issueIdOrIdentifier: string): Promise<SubIssueGraph>;
+}
+/**
+ * Create a configured LinearAgentClient instance
+ */
+export declare function createLinearAgentClient(config: LinearAgentClientConfig): LinearAgentClient;
+//# sourceMappingURL=agent-client.d.ts.map

package/dist/src/agent-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client.d.ts","sourceRoot":"","sources":["../../src/agent-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGb,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EAEb,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EAExB,oBAAoB,EACpB,iBAAiB,EAEjB,aAAa,EACb,cAAc,EACf,MAAM,SAAS,CAAA;AAIhB;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,WAAW,CAAwC;gBAE/C,MAAM,EAAE,uBAAuB;IAW3C;;OAEG;IACH,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED;;OAEG;YACW,SAAS;IAYvB;;OAEG;IACG,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAa3D;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QACJ,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,GACA,OAAO,CAAC,KAAK,CAAC;IAUjB;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAapD;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAmB7D;;OAEG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,KAAK,CAAC;IA0BjB;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BpE;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQ3D;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE;QACvB,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,GAAG,OAAO,CAAC,KAAK,CAAC;IAwBlB;;OAEG;IACG,SAAS;IAIf;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM;IAIjC;;;;;OAKG;IACG,mBAAmB,CACvB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,mBAAmB,CAAC;IAiC/B;;;;;;;;OAQG;IACG,kBAAkB,CACtB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;IAwBpC;;;;;;;;;;;OAWG;IACG,yBAAyB,CAC7B,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,wBAAwB,CAAC;IA4BpC;;;;;;;;;;OAUG;IACG,mBAAmB,CACvB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,mBAAmB,CAAC;IA+B/B;;;;;OAKG;IACG,yBAAyB,CAAC,KAAK,EAAE;QACrC,aAAa,EAAE,MAAM,CAAA;QACrB,cAAc,EAAE,MAAM,EAAE,CAAA;QACxB,IAAI,EAAE,iBAAiB,CAAA;KACxB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA6BrC;;;;;OAKG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6CvE;;;;;OAKG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAoB5E;;;;;OAKG;IACG,YAAY,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAejE;;;;;OAKG;IACG,YAAY,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAejE;;;;;OAKG;IACG,aAAa,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAelE;;;;;;;;;OASG;IACG,mBAAmB,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA0BjF;;;;;;;;;OASG;IACG,gBAAgB,CAAC,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CA2E5E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,iBAAiB,CAEnB"}