@renseiai/plugin-linear 0.8.6

package/dist/src/types.d.ts

@@ -0,0 +1,492 @@
+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;
+}
+/**
+ * Pluggable rate limiter strategy.
+ *
+ * The default in-memory TokenBucket implements this. Consumers can provide
+ * a Redis-backed implementation for shared rate limiting across processes.
+ */
+export interface RateLimiterStrategy {
+    acquire(): Promise<void>;
+    penalize(seconds: number): void | Promise<void>;
+}
+/**
+ * Pluggable circuit breaker strategy.
+ *
+ * The default in-memory CircuitBreaker implements this. Consumers can provide
+ * a Redis-backed implementation for shared circuit state across processes.
+ */
+export interface CircuitBreakerStrategy {
+    canProceed(): boolean | Promise<boolean>;
+    recordSuccess(): void | Promise<void>;
+    recordAuthFailure(statusCode?: number): void | Promise<void>;
+    isAuthError(error: unknown): boolean;
+    reset(): void | Promise<void>;
+}
+/**
+ * Configuration for the circuit breaker
+ */
+export interface CircuitBreakerConfig {
+    /** Consecutive auth failures before opening (default: 2) */
+    failureThreshold: number;
+    /** Milliseconds before half-open probe (default: 60_000) */
+    resetTimeoutMs: number;
+    /** Maximum reset timeout after exponential backoff (default: 300_000) */
+    maxResetTimeoutMs: number;
+    /** Backoff multiplier for reset timeout after probe failure (default: 2) */
+    backoffMultiplier: number;
+    /** HTTP status codes that count as auth failures (default: [400, 401, 403]) */
+    authErrorCodes: number[];
+}
+/**
+ * Configuration for the Linear Agent Client
+ */
+/**
+ * Quota information extracted from Linear API response headers.
+ */
+export interface LinearApiQuota {
+    /** Remaining requests in the current window */
+    requestsRemaining?: number;
+    /** Total request limit for the current window */
+    requestsLimit?: number;
+    /** Remaining complexity points in the current window */
+    complexityRemaining?: number;
+    /** Total complexity limit for the current window */
+    complexityLimit?: number;
+    /** Seconds until the rate limit window resets */
+    resetSeconds?: number;
+}
+export interface LinearAgentClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+    retry?: RetryConfig;
+    /** Token bucket rate limiter configuration. Applied to all API calls. */
+    rateLimit?: Partial<import('./rate-limiter.js').TokenBucketConfig>;
+    /** Circuit breaker configuration. */
+    circuitBreaker?: Partial<CircuitBreakerConfig>;
+    /**
+     * Injectable rate limiter strategy (e.g., Redis-backed).
+     * When provided, replaces the default in-memory TokenBucket.
+     */
+    rateLimiterStrategy?: RateLimiterStrategy;
+    /**
+     * Injectable circuit breaker strategy (e.g., Redis-backed).
+     * When provided, replaces the default in-memory CircuitBreaker.
+     */
+    circuitBreakerStrategy?: CircuitBreakerStrategy;
+    /**
+     * Optional callback invoked after each successful API response.
+     * Receives quota information extracted from response headers.
+     * Use this to track API consumption across scans.
+     */
+    onApiResponse?: (quota: LinearApiQuota) => void;
+}
+/**
+ * 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                  |
+ * | Rejected     | refinement-coordination| Coordinate refinement across sub-issues       |
+ */
+export type AgentWorkType = 'research' | 'backlog-creation' | 'development' | 'inflight' | 'inflight-coordination' | 'qa' | 'acceptance' | 'refinement' | 'refinement-coordination' | '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>;
+/**
+ * Work types that require an isolated git worktree.
+ * ALL work types now get worktrees to prevent agents from mutating the main
+ * checkout (e.g., running `git checkout` in the IDE's working tree).
+ */
+export declare const WORK_TYPES_REQUIRING_WORKTREE: ReadonlySet<AgentWorkType>;
+/**
+ * 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,148 @@
+/**
+ * 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
+    'inflight-coordination': null, // Already Started, no change
+    'qa': null, // Already Finished
+    'acceptance': null, // Already Delivered
+    'refinement': null, // Already Rejected
+    'refinement-coordination': 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
+    'inflight-coordination': 'Finished', // Started -> Finished when all sub-issues done
+    'qa': 'Delivered', // Finished -> Delivered on QA pass
+    'acceptance': 'Accepted', // Delivered -> Accepted on acceptance pass
+    'refinement': 'Backlog', // Rejected -> Backlog after refinement
+    'refinement-coordination': 'Backlog', // Rejected -> Backlog after coordinated refinement (triggers coordination which re-runs failing sub-issues)
+    '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,
+    'inflight-coordination': null,
+    'qa': 'Backlog', // QA failure -> Backlog (developer/coordinator picks up with failure context)
+    'acceptance': 'Rejected', // Acceptance failure -> Rejected (rejection handler diagnoses next steps)
+    'refinement': null,
+    'refinement-coordination': null,
+    'coordination': null,
+    'qa-coordination': 'Rejected', // QA coordination failure -> Rejected (refinement-coordination reads QA feedback and dispatches targeted fixes to failing sub-issues)
+    'acceptance-coordination': 'Rejected', // Acceptance coordination failure -> Rejected
+};
+/**
+ * Work types that require an isolated git worktree.
+ * ALL work types now get worktrees to prevent agents from mutating the main
+ * checkout (e.g., running `git checkout` in the IDE's working tree).
+ */
+export const WORK_TYPES_REQUIRING_WORKTREE = new Set([
+    'development',
+    'inflight',
+    'inflight-coordination',
+    'qa',
+    'acceptance',
+    'coordination',
+    'qa-coordination',
+    'acceptance-coordination',
+    'research',
+    'backlog-creation',
+    'refinement',
+    'refinement-coordination',
+]);
+/**
+ * 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'],
+    'inflight-coordination': ['Started'],
+    'qa': ['Finished'],
+    'acceptance': ['Delivered'],
+    'refinement': ['Rejected'],
+    'refinement-coordination': ['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', 'inflight-coordination'],
+    'Finished': ['qa', 'qa-coordination'],
+    'Delivered': ['acceptance', 'acceptance-coordination'],
+    'Rejected': ['refinement', 'refinement-coordination'],
+};
+/**
+ * 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 };
+}