@supaku/agentfactory-linear 0.1.0

package/dist/src/retry.d.ts

@@ -0,0 +1,43 @@
+import type { RetryConfig } from './types';
+/**
+ * Default retry configuration
+ */
+export declare const DEFAULT_RETRY_CONFIG: Required<RetryConfig>;
+/**
+ * Sleep utility for async delays
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Calculate delay for a given retry attempt with exponential backoff
+ */
+export declare function calculateDelay(attempt: number, config: Required<RetryConfig>): number;
+/**
+ * Retry context passed to callbacks
+ */
+export interface RetryContext {
+    attempt: number;
+    maxRetries: number;
+    lastError?: Error;
+    delay: number;
+}
+/**
+ * Callback for retry events
+ */
+export type RetryCallback = (context: RetryContext) => void;
+/**
+ * Options for withRetry function
+ */
+export interface WithRetryOptions {
+    config?: RetryConfig;
+    onRetry?: RetryCallback;
+    shouldRetry?: (error: unknown) => boolean;
+}
+/**
+ * Execute an async function with exponential backoff retry logic
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: WithRetryOptions): Promise<T>;
+/**
+ * Create a retry wrapper with pre-configured options
+ */
+export declare function createRetryWrapper(defaultOptions?: WithRetryOptions): <T>(fn: () => Promise<T>, options?: WithRetryOptions) => Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/src/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG1C;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,WAAW,CAMtD,CAAA;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,MAAM,CAIR;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CAC1C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,CAAC,CAsCZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,GAAE,gBAAqB,IACrD,CAAC,EAChB,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,gBAAgB,KACzB,OAAO,CAAC,CAAC,CAAC,CAUd"}

package/dist/src/retry.js

@@ -0,0 +1,73 @@
+import { isRetryableError } from './errors';
+/**
+ * Default retry configuration
+ */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    backoffMultiplier: 2,
+    maxDelayMs: 10000,
+    retryableStatusCodes: [429, 500, 502, 503, 504],
+};
+/**
+ * Sleep utility for async delays
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Calculate delay for a given retry attempt with exponential backoff
+ */
+export function calculateDelay(attempt, config) {
+    const delay = config.initialDelayMs * Math.pow(config.backoffMultiplier, attempt);
+    return Math.min(delay, config.maxDelayMs);
+}
+/**
+ * Execute an async function with exponential backoff retry logic
+ */
+export async function withRetry(fn, options = {}) {
+    const config = {
+        ...DEFAULT_RETRY_CONFIG,
+        ...options.config,
+    };
+    const shouldRetry = options.shouldRetry ??
+        ((error) => isRetryableError(error, config.retryableStatusCodes));
+    let lastError = new Error('Unknown error');
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt === config.maxRetries || !shouldRetry(error)) {
+                throw lastError;
+            }
+            const delay = calculateDelay(attempt, config);
+            if (options.onRetry) {
+                options.onRetry({
+                    attempt,
+                    maxRetries: config.maxRetries,
+                    lastError,
+                    delay,
+                });
+            }
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+/**
+ * Create a retry wrapper with pre-configured options
+ */
+export function createRetryWrapper(defaultOptions = {}) {
+    return function (fn, options) {
+        return withRetry(fn, {
+            ...defaultOptions,
+            ...options,
+            config: {
+                ...defaultOptions.config,
+                ...options?.config,
+            },
+        });
+    };
+}

package/dist/src/types.d.ts

@@ -0,0 +1,412 @@
+import type { LinearClient } from '@linear/sdk';
+/**
+ * AgentSession states as defined by Linear Agent SDK
+ */
+export type AgentSessionState = 'pending' | 'active' | 'error' | 'awaitingInput' | 'complete';
+/**
+ * AgentActivity types as defined by Linear Agent API
+ */
+export type AgentActivityType = 'thought' | 'action' | 'response' | 'elicitation' | 'error' | 'prompt';
+/**
+ * AgentActivity signals - modifiers that provide additional instructions
+ * on how the activity should be interpreted
+ */
+export type AgentActivitySignal = 'auth' | 'continue' | 'select' | 'stop';
+/**
+ * Content for a thought activity - reasoning steps
+ */
+export interface ThoughtActivityContent {
+    type: 'thought';
+    body: string;
+}
+/**
+ * Content for an action activity - tool calls
+ */
+export interface ActionActivityContent {
+    type: 'action';
+    action: string;
+    parameter: string;
+    result?: string;
+}
+/**
+ * Content for a response activity - final responses
+ */
+export interface ResponseActivityContent {
+    type: 'response';
+    body: string;
+}
+/**
+ * Content for an elicitation activity - asking for clarification
+ */
+export interface ElicitationActivityContent {
+    type: 'elicitation';
+    body: string;
+}
+/**
+ * Content for an error activity - error reporting
+ */
+export interface ErrorActivityContent {
+    type: 'error';
+    body: string;
+}
+/**
+ * Content for a prompt activity - prompts/instructions
+ */
+export interface PromptActivityContent {
+    type: 'prompt';
+    body: string;
+}
+/**
+ * Union type for all activity content types
+ */
+export type AgentActivityContentPayload = ThoughtActivityContent | ActionActivityContent | ResponseActivityContent | ElicitationActivityContent | ErrorActivityContent | PromptActivityContent;
+/**
+ * Input for creating an agent activity via the native Linear API
+ */
+export interface AgentActivityCreateInput {
+    agentSessionId: string;
+    content: AgentActivityContentPayload;
+    ephemeral?: boolean;
+    id?: string;
+    signal?: AgentActivitySignal;
+}
+/**
+ * Result of creating an agent activity
+ */
+export interface AgentActivityResult {
+    success: boolean;
+    activityId?: string;
+}
+/**
+ * Legacy activity content for backward compatibility
+ * @deprecated Use AgentActivityContentPayload instead
+ */
+export interface AgentActivityContent {
+    text: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Configuration for creating an agent activity (internal use)
+ */
+export interface CreateActivityOptions {
+    type: AgentActivityType;
+    content: AgentActivityContent;
+    ephemeral?: boolean;
+    signals?: AgentSignals;
+}
+/**
+ * AgentPlan item states
+ */
+export type AgentPlanItemState = 'pending' | 'inProgress' | 'completed' | 'canceled';
+/**
+ * Linear's native plan item status values
+ * @see https://linear.app/developers/agents
+ */
+export type LinearPlanStatus = 'pending' | 'inProgress' | 'completed' | 'canceled';
+/**
+ * Linear's native plan item structure for agentSessionUpdate mutation
+ * @see https://linear.app/developers/agents
+ */
+export interface LinearPlanItem {
+    /** The task description */
+    content: string;
+    /** Current status of the task */
+    status: LinearPlanStatus;
+}
+/**
+ * A single item in the agent's plan (internal representation)
+ * Supports nested children for more detailed task tracking
+ */
+export interface AgentPlanItem {
+    id: string;
+    title: string;
+    state: AgentPlanItemState;
+    details?: string;
+    children?: AgentPlanItem[];
+}
+/**
+ * Full agent plan structure (internal representation)
+ */
+export interface AgentPlan {
+    items: AgentPlanItem[];
+}
+/**
+ * Optional metadata for activity interpretation
+ */
+export interface AgentSignals {
+    toolName?: string;
+    toolInput?: Record<string, unknown>;
+    toolOutput?: unknown;
+    error?: {
+        message: string;
+        code?: string;
+        stack?: string;
+    };
+    progress?: number;
+    [key: string]: unknown;
+}
+/**
+ * Configuration for the Linear Agent Client
+ */
+export interface LinearAgentClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+    retry?: RetryConfig;
+}
+/**
+ * Retry configuration with exponential backoff
+ */
+export interface RetryConfig {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    backoffMultiplier?: number;
+    maxDelayMs?: number;
+    retryableStatusCodes?: number[];
+}
+/**
+ * Standard Linear workflow states
+ */
+export type LinearWorkflowStatus = 'Backlog' | 'Started' | 'Finished' | 'Delivered' | 'Accepted' | 'Rejected' | 'Canceled';
+/**
+ * Type of agent work being performed based on issue status
+ *
+ * | Issue Status | Work Type              | Agent Role                                    |
+ * |--------------|------------------------|-----------------------------------------------|
+ * | Icebox       | research               | Research/story-writer                         |
+ * | Icebox       | backlog-creation       | Create backlog issues from research           |
+ * | Backlog      | development            | Developer agents                              |
+ * | Backlog      | coordination           | Coordinate sub-issue execution                |
+ * | Started      | inflight               | Developer (resume/continue)                   |
+ * | Finished     | qa                     | QA agents                                     |
+ * | Finished     | qa-coordination        | Coordinate QA across sub-issues               |
+ * | Delivered    | acceptance             | Acceptance testing                            |
+ * | Delivered    | acceptance-coordination| Coordinate acceptance across sub-issues       |
+ * | Rejected     | refinement             | Refine and return to Backlog                  |
+ */
+export type AgentWorkType = 'research' | 'backlog-creation' | 'development' | 'inflight' | 'qa' | 'acceptance' | 'refinement' | 'coordination' | 'qa-coordination' | 'acceptance-coordination';
+/**
+ * Mapping from Linear issue status to agent work type
+ */
+export declare const STATUS_WORK_TYPE_MAP: Record<string, AgentWorkType>;
+/**
+ * Terminal statuses where no agent work is needed
+ * Issues in these states are considered complete and should not be processed
+ */
+export declare const TERMINAL_STATUSES: readonly ["Accepted", "Canceled", "Duplicate"];
+export type TerminalStatus = typeof TERMINAL_STATUSES[number];
+/**
+ * Status to transition to when agent session STARTS
+ * null means no transition on start
+ */
+export declare const WORK_TYPE_START_STATUS: Record<AgentWorkType, LinearWorkflowStatus | null>;
+/**
+ * Status to transition to when agent session COMPLETES successfully
+ * null means no auto-transition on completion
+ */
+export declare const WORK_TYPE_COMPLETE_STATUS: Record<AgentWorkType, LinearWorkflowStatus | null>;
+/**
+ * Status to transition to when agent work FAILS (e.g., QA rejected)
+ * null means no auto-transition on failure (stays in current status)
+ */
+export declare const WORK_TYPE_FAIL_STATUS: Record<AgentWorkType, LinearWorkflowStatus | null>;
+/**
+ * Allowed statuses for each work type
+ * Used to validate that an agent isn't assigned to an issue in the wrong status
+ */
+export declare const WORK_TYPE_ALLOWED_STATUSES: Record<AgentWorkType, string[]>;
+/**
+ * Valid work types for each status (reverse of WORK_TYPE_ALLOWED_STATUSES)
+ * Used to constrain keyword detection to only valid options for the current status
+ *
+ * For example:
+ * - Icebox issues can use keywords to choose between 'research' and 'backlog-creation'
+ * - Backlog issues only have 'development' as valid, so keywords won't change work type
+ *   but could still provide agent specialization hints
+ */
+export declare const STATUS_VALID_WORK_TYPES: Record<string, AgentWorkType[]>;
+/**
+ * Get valid work types for a given status
+ * Returns empty array if status is unknown
+ */
+export declare function getValidWorkTypesForStatus(status: string): AgentWorkType[];
+/**
+ * Result of work type validation
+ */
+export interface WorkTypeValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validate that a work type is appropriate for an issue's current status
+ *
+ * @param workType - The work type being assigned
+ * @param issueStatus - The current status of the issue
+ * @returns Validation result with error message if invalid
+ */
+export declare function validateWorkTypeForStatus(workType: AgentWorkType, issueStatus: string): WorkTypeValidationResult;
+/**
+ * Mapping of status names to their Linear state IDs
+ */
+export interface StatusMapping {
+    [statusName: string]: string;
+}
+/**
+ * Configuration for creating/managing an agent session
+ */
+export interface AgentSessionConfig {
+    client: LinearClient;
+    issueId: string;
+    sessionId?: string;
+    autoTransition?: boolean;
+    /**
+     * Type of work being performed.
+     * - 'development': Normal development work (transitions to Started on start)
+     * - 'qa': QA validation work (stays at Finished until QA passes, then Delivered)
+     * Defaults to 'development'.
+     */
+    workType?: AgentWorkType;
+}
+/**
+ * Result of session operations
+ */
+export interface SessionOperationResult {
+    success: boolean;
+    sessionId?: string;
+    error?: Error;
+}
+/**
+ * External URL associated with an agent session
+ */
+export interface AgentSessionExternalUrl {
+    /** Label for the URL (e.g., "Dashboard", "Logs") */
+    label: string;
+    /** The URL of the external resource */
+    url: string;
+}
+/**
+ * Input for updating an agent session via the Linear API
+ */
+export interface AgentSessionUpdateInput {
+    /** The agent session ID to update */
+    sessionId: string;
+    /** External URLs linking to agent dashboard/logs */
+    externalUrls?: AgentSessionExternalUrl[];
+    /** External link URL (single, for backward compatibility) */
+    externalLink?: string;
+    /** Plan array showing agent execution strategy (Linear's native format) */
+    plan?: LinearPlanItem[];
+}
+/**
+ * Result of updating an agent session
+ */
+export interface AgentSessionUpdateResult {
+    success: boolean;
+    sessionId?: string;
+}
+/**
+ * Input for creating an agent session on an issue via the Linear API
+ * @see https://linear.app/developers/agents
+ */
+export interface AgentSessionCreateOnIssueInput {
+    /** The issue ID (UUID) or identifier (e.g., 'SUP-123') to create the session on */
+    issueId: string;
+    /** External URLs linking to agent dashboard/logs */
+    externalUrls?: AgentSessionExternalUrl[];
+    /** External link URL (single, for backward compatibility) */
+    externalLink?: string;
+}
+/**
+ * Result of creating an agent session on an issue
+ */
+export interface AgentSessionCreateResult {
+    success: boolean;
+    /** The ID of the created agent session */
+    sessionId?: string;
+}
+/**
+ * Linear issue relationship types
+ * @see https://linear.app/developers/sdk
+ */
+export type IssueRelationType = 'related' | 'blocks' | 'duplicate';
+/**
+ * Input for creating an issue relation
+ */
+export interface IssueRelationCreateInput {
+    issueId: string;
+    relatedIssueId: string;
+    type: IssueRelationType;
+}
+/**
+ * Result of creating/deleting an issue relation
+ */
+export interface IssueRelationResult {
+    success: boolean;
+    relationId?: string;
+}
+/**
+ * Batch result for creating multiple relations
+ */
+export interface IssueRelationBatchResult {
+    success: boolean;
+    relationIds: string[];
+    errors: Array<{
+        targetIssueId: string;
+        error: string;
+    }>;
+}
+/**
+ * Sub-issue with its blocking relations for dependency graph building
+ */
+export interface SubIssueGraphNode {
+    issue: {
+        id: string;
+        identifier: string;
+        title: string;
+        description?: string;
+        status?: string;
+        priority: number;
+        labels: string[];
+        url: string;
+    };
+    /** Identifiers of issues that block this sub-issue */
+    blockedBy: string[];
+    /** Identifiers of issues that this sub-issue blocks */
+    blocks: string[];
+}
+/**
+ * Result of getSubIssueGraph - the complete dependency graph for a parent issue
+ */
+export interface SubIssueGraph {
+    parentId: string;
+    parentIdentifier: string;
+    subIssues: SubIssueGraphNode[];
+}
+/**
+ * Lightweight sub-issue status info (no blocking relations)
+ * Used by QA and acceptance agents to validate sub-issue completion
+ */
+export interface SubIssueStatus {
+    identifier: string;
+    title: string;
+    status: string;
+}
+/**
+ * Representation of an issue relation
+ */
+export interface IssueRelationInfo {
+    id: string;
+    type: string;
+    issueId: string;
+    issueIdentifier?: string;
+    relatedIssueId: string;
+    relatedIssueIdentifier?: string;
+    createdAt: Date;
+}
+/**
+ * Result of querying issue relations
+ */
+export interface IssueRelationsResult {
+    relations: IssueRelationInfo[];
+    inverseRelations: IssueRelationInfo[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,121 @@
+/**
+ * Mapping from Linear issue status to agent work type
+ */
+export const STATUS_WORK_TYPE_MAP = {
+    'Icebox': 'research',
+    'Backlog': 'development',
+    'Started': 'inflight',
+    'Finished': 'qa',
+    'Delivered': 'acceptance',
+    'Rejected': 'refinement',
+};
+/**
+ * Terminal statuses where no agent work is needed
+ * Issues in these states are considered complete and should not be processed
+ */
+export const TERMINAL_STATUSES = ['Accepted', 'Canceled', 'Duplicate'];
+/**
+ * Status to transition to when agent session STARTS
+ * null means no transition on start
+ */
+export const WORK_TYPE_START_STATUS = {
+    'research': null, // No transition from Icebox on start
+    'backlog-creation': null, // No transition from Icebox on start
+    'development': 'Started', // Backlog -> Started when agent begins
+    'inflight': null, // Already Started, no change
+    'qa': null, // Already Finished
+    'acceptance': null, // Already Delivered
+    'refinement': null, // Already Rejected
+    'coordination': 'Started', // Backlog -> Started when coordinator begins
+    'qa-coordination': null, // Already Finished
+    'acceptance-coordination': null, // Already Delivered
+};
+/**
+ * Status to transition to when agent session COMPLETES successfully
+ * null means no auto-transition on completion
+ */
+export const WORK_TYPE_COMPLETE_STATUS = {
+    'research': null, // No auto-transition, user moves to Backlog
+    'backlog-creation': null, // Issues created in Backlog, source stays in Icebox
+    'development': 'Finished', // Started -> Finished when work done
+    'inflight': 'Finished', // Started -> Finished when work done
+    'qa': 'Delivered', // Finished -> Delivered on QA pass
+    'acceptance': 'Accepted', // Delivered -> Accepted on acceptance pass
+    'refinement': 'Backlog', // Rejected -> Backlog after refinement
+    'coordination': 'Finished', // Started -> Finished when all sub-issues done
+    'qa-coordination': 'Delivered', // Finished -> Delivered when QA coordination passes
+    'acceptance-coordination': 'Accepted', // Delivered -> Accepted when acceptance coordination passes
+};
+/**
+ * Status to transition to when agent work FAILS (e.g., QA rejected)
+ * null means no auto-transition on failure (stays in current status)
+ */
+export const WORK_TYPE_FAIL_STATUS = {
+    'research': null,
+    'backlog-creation': null,
+    'development': null,
+    'inflight': null,
+    'qa': 'Rejected', // QA failure -> Rejected (rejection handler diagnoses next steps)
+    'acceptance': 'Rejected', // Acceptance failure -> Rejected (rejection handler diagnoses next steps)
+    'refinement': null,
+    'coordination': null,
+    'qa-coordination': 'Rejected', // QA coordination failure -> Rejected
+    'acceptance-coordination': 'Rejected', // Acceptance coordination failure -> Rejected
+};
+/**
+ * Allowed statuses for each work type
+ * Used to validate that an agent isn't assigned to an issue in the wrong status
+ */
+export const WORK_TYPE_ALLOWED_STATUSES = {
+    'research': ['Icebox'],
+    'backlog-creation': ['Icebox'],
+    'development': ['Backlog'],
+    'inflight': ['Started'],
+    'qa': ['Finished'],
+    'acceptance': ['Delivered'],
+    'refinement': ['Rejected'],
+    'coordination': ['Backlog', 'Started'],
+    'qa-coordination': ['Finished'],
+    'acceptance-coordination': ['Delivered'],
+};
+/**
+ * Valid work types for each status (reverse of WORK_TYPE_ALLOWED_STATUSES)
+ * Used to constrain keyword detection to only valid options for the current status
+ *
+ * For example:
+ * - Icebox issues can use keywords to choose between 'research' and 'backlog-creation'
+ * - Backlog issues only have 'development' as valid, so keywords won't change work type
+ *   but could still provide agent specialization hints
+ */
+export const STATUS_VALID_WORK_TYPES = {
+    'Icebox': ['research', 'backlog-creation'],
+    'Backlog': ['development', 'coordination'],
+    'Started': ['inflight'],
+    'Finished': ['qa', 'qa-coordination'],
+    'Delivered': ['acceptance', 'acceptance-coordination'],
+    'Rejected': ['refinement'],
+};
+/**
+ * Get valid work types for a given status
+ * Returns empty array if status is unknown
+ */
+export function getValidWorkTypesForStatus(status) {
+    return STATUS_VALID_WORK_TYPES[status] ?? [];
+}
+/**
+ * Validate that a work type is appropriate for an issue's current status
+ *
+ * @param workType - The work type being assigned
+ * @param issueStatus - The current status of the issue
+ * @returns Validation result with error message if invalid
+ */
+export function validateWorkTypeForStatus(workType, issueStatus) {
+    const allowedStatuses = WORK_TYPE_ALLOWED_STATUSES[workType];
+    if (!allowedStatuses.includes(issueStatus)) {
+        return {
+            valid: false,
+            error: `Cannot assign ${workType} work to issue in ${issueStatus} status. Expected: ${allowedStatuses.join(', ')}`,
+        };
+    }
+    return { valid: true };
+}