@supaku/agentfactory-linear 0.1.0

package/dist/src/checkbox-utils.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Checkbox Utilities
+ *
+ * Parse and update markdown checkboxes in Linear issue descriptions.
+ * Checkboxes follow the standard markdown format:
+ *   - [ ] Unchecked item
+ *   - [x] Checked item
+ */
+/**
+ * Represents a checkbox item parsed from markdown
+ */
+export interface CheckboxItem {
+    /** Zero-based index among all checkboxes in the document */
+    index: number;
+    /** Line number in the markdown (zero-based) */
+    line: number;
+    /** Whether the checkbox is checked */
+    checked: boolean;
+    /** The text content after the checkbox */
+    text: string;
+    /** Indentation level (number of leading spaces) */
+    indentLevel: number;
+    /** The raw line text */
+    raw: string;
+}
+/**
+ * Checkbox update specification
+ */
+export interface CheckboxUpdate {
+    /** Update checkbox by its index */
+    index?: number;
+    /** Update checkbox by matching text pattern */
+    textPattern?: string | RegExp;
+    /** New checked state */
+    checked: boolean;
+}
+/**
+ * Parse markdown and extract checkbox items
+ *
+ * @param markdown - The markdown content to parse
+ * @returns Array of checkbox items found in the markdown
+ */
+export declare function parseCheckboxes(markdown: string): CheckboxItem[];
+/**
+ * Update a checkbox by its index
+ *
+ * @param markdown - The markdown content
+ * @param index - The checkbox index to update
+ * @param checked - The new checked state
+ * @returns The updated markdown, or the original if checkbox not found
+ */
+export declare function updateCheckbox(markdown: string, index: number, checked: boolean): string;
+/**
+ * Update a checkbox by matching its text content
+ *
+ * @param markdown - The markdown content
+ * @param textPattern - String or regex to match against checkbox text
+ * @param checked - The new checked state
+ * @returns The updated markdown, or the original if no match found
+ */
+export declare function updateCheckboxByText(markdown: string, textPattern: string | RegExp, checked: boolean): string;
+/**
+ * Apply multiple checkbox updates at once
+ *
+ * @param markdown - The markdown content
+ * @param updates - Array of updates to apply
+ * @returns The updated markdown
+ */
+export declare function updateCheckboxes(markdown: string, updates: CheckboxUpdate[]): string;
+/**
+ * Check if markdown contains any checkboxes
+ *
+ * @param markdown - The markdown content to check
+ * @returns True if at least one checkbox is found
+ */
+export declare function hasCheckboxes(markdown: string): boolean;
+/**
+ * Get summary of checkbox states
+ *
+ * @param markdown - The markdown content
+ * @returns Object with counts of checked and unchecked items
+ */
+export declare function getCheckboxSummary(markdown: string): {
+    total: number;
+    checked: number;
+    unchecked: number;
+};
+//# sourceMappingURL=checkbox-utils.d.ts.map

package/dist/src/checkbox-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-utils.d.ts","sourceRoot":"","sources":["../../src/checkbox-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAA;IACnB,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC7B,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAA;CACjB;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAuBhE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,MAAM,CAaR;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,OAAO,EAAE,OAAO,GACf,MAAM,CAeR;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EAAE,GACxB,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACpD,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,CASA"}

package/dist/src/checkbox-utils.js

@@ -0,0 +1,120 @@
+/**
+ * Checkbox Utilities
+ *
+ * Parse and update markdown checkboxes in Linear issue descriptions.
+ * Checkboxes follow the standard markdown format:
+ *   - [ ] Unchecked item
+ *   - [x] Checked item
+ */
+// Regex to match markdown checkbox lines
+// Captures: (leading whitespace)(checkbox mark)(text content)
+const CHECKBOX_REGEX = /^(\s*)- \[([ xX])\] (.*)$/;
+/**
+ * Parse markdown and extract checkbox items
+ *
+ * @param markdown - The markdown content to parse
+ * @returns Array of checkbox items found in the markdown
+ */
+export function parseCheckboxes(markdown) {
+    const lines = markdown.split('\n');
+    const checkboxes = [];
+    let checkboxIndex = 0;
+    for (let lineNum = 0; lineNum < lines.length; lineNum++) {
+        const line = lines[lineNum];
+        const match = line.match(CHECKBOX_REGEX);
+        if (match) {
+            const [, indent, mark, text] = match;
+            checkboxes.push({
+                index: checkboxIndex++,
+                line: lineNum,
+                indentLevel: indent.length,
+                checked: mark.toLowerCase() === 'x',
+                text: text.trim(),
+                raw: line,
+            });
+        }
+    }
+    return checkboxes;
+}
+/**
+ * Update a checkbox by its index
+ *
+ * @param markdown - The markdown content
+ * @param index - The checkbox index to update
+ * @param checked - The new checked state
+ * @returns The updated markdown, or the original if checkbox not found
+ */
+export function updateCheckbox(markdown, index, checked) {
+    const checkboxes = parseCheckboxes(markdown);
+    const checkbox = checkboxes.find((c) => c.index === index);
+    if (!checkbox) {
+        return markdown;
+    }
+    const lines = markdown.split('\n');
+    const newCheckmark = checked ? 'x' : ' ';
+    lines[checkbox.line] = checkbox.raw.replace(/\[([ xX])\]/, `[${newCheckmark}]`);
+    return lines.join('\n');
+}
+/**
+ * Update a checkbox by matching its text content
+ *
+ * @param markdown - The markdown content
+ * @param textPattern - String or regex to match against checkbox text
+ * @param checked - The new checked state
+ * @returns The updated markdown, or the original if no match found
+ */
+export function updateCheckboxByText(markdown, textPattern, checked) {
+    const checkboxes = parseCheckboxes(markdown);
+    const pattern = typeof textPattern === 'string'
+        ? new RegExp(textPattern, 'i')
+        : textPattern;
+    const checkbox = checkboxes.find((c) => pattern.test(c.text));
+    if (!checkbox) {
+        return markdown;
+    }
+    return updateCheckbox(markdown, checkbox.index, checked);
+}
+/**
+ * Apply multiple checkbox updates at once
+ *
+ * @param markdown - The markdown content
+ * @param updates - Array of updates to apply
+ * @returns The updated markdown
+ */
+export function updateCheckboxes(markdown, updates) {
+    let result = markdown;
+    for (const update of updates) {
+        if (update.index !== undefined) {
+            result = updateCheckbox(result, update.index, update.checked);
+        }
+        else if (update.textPattern) {
+            result = updateCheckboxByText(result, update.textPattern, update.checked);
+        }
+    }
+    return result;
+}
+/**
+ * Check if markdown contains any checkboxes
+ *
+ * @param markdown - The markdown content to check
+ * @returns True if at least one checkbox is found
+ */
+export function hasCheckboxes(markdown) {
+    const lines = markdown.split('\n');
+    return lines.some((line) => CHECKBOX_REGEX.test(line));
+}
+/**
+ * Get summary of checkbox states
+ *
+ * @param markdown - The markdown content
+ * @returns Object with counts of checked and unchecked items
+ */
+export function getCheckboxSummary(markdown) {
+    const checkboxes = parseCheckboxes(markdown);
+    const checked = checkboxes.filter((c) => c.checked).length;
+    return {
+        total: checkboxes.length,
+        checked,
+        unchecked: checkboxes.length - checked,
+    };
+}

package/dist/src/constants.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Linear API Constants
+ *
+ * Contains API limits, well-known IDs, and configuration values.
+ * All workspace-specific IDs must be provided via environment variables.
+ */
+/**
+ * Maximum length for comment body.
+ * Linear doesn't publicly document this limit, but testing shows ~10k is safe.
+ * We use a conservative limit to avoid truncation issues.
+ */
+export declare const LINEAR_COMMENT_MAX_LENGTH = 10000;
+/**
+ * Marker appended when content is truncated
+ */
+export declare const TRUNCATION_MARKER = "\n\n... (content truncated)";
+/**
+ * Maximum number of comments for a single completion (safety limit)
+ */
+export declare const MAX_COMPLETION_COMMENTS = 10;
+/**
+ * Characters reserved for part markers and overhead
+ */
+export declare const COMMENT_OVERHEAD = 100;
+/**
+ * Continuation marker for multi-part comments
+ */
+export declare const CONTINUATION_MARKER = "\n\n*...continued in next comment*";
+/**
+ * Default team UUID
+ * Must be set via LINEAR_TEAM_ID env var
+ */
+export declare const DEFAULT_TEAM_ID: string;
+/**
+ * Project IDs — must be set via env vars:
+ * - LINEAR_PROJECT_AGENT
+ * - LINEAR_PROJECT_SOCIAL
+ * - LINEAR_PROJECT_TEST
+ */
+export declare const LINEAR_PROJECTS: {
+    readonly AGENT: string;
+    readonly SOCIAL: string;
+    /** Test project for E2E testing of orchestrator */
+    readonly TEST: string;
+};
+/**
+ * Label IDs for issue classification
+ * Must be set via env vars:
+ * - LINEAR_LABEL_BUG
+ * - LINEAR_LABEL_FEATURE
+ * - LINEAR_LABEL_CHORE
+ */
+export declare const LINEAR_LABELS: {
+    readonly BUG: string;
+    readonly FEATURE: string;
+    readonly CHORE: string;
+};
+export declare const TEST_LABEL_NAMES: {
+    /** Mark issues as test fixtures (not for manual processing) */
+    readonly TEST_FIXTURE: "test-fixture";
+    /** Identify issues created by E2E tests */
+    readonly E2E_TEST: "e2e-test";
+};
+/**
+ * Categories of environment issues that agents can report
+ */
+export declare const ENVIRONMENT_ISSUE_TYPES: {
+    readonly PERMISSION: "permission";
+    readonly NETWORK: "network";
+    readonly SANDBOX: "sandbox";
+    readonly LINEAR_CLI: "linear-cli";
+    readonly DEPENDENCY: "dependency";
+    readonly TIMEOUT: "timeout";
+    readonly TOOL: "tool";
+};
+export type EnvironmentIssueType = (typeof ENVIRONMENT_ISSUE_TYPES)[keyof typeof ENVIRONMENT_ISSUE_TYPES];
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAQ,CAAA;AAE9C;;GAEG;AACH,eAAO,MAAM,iBAAiB,gCAAgC,CAAA;AAE9D;;GAEG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAEzC;;GAEG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC;;GAEG;AACH,eAAO,MAAM,mBAAmB,uCAAuC,CAAA;AAQvE;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAmC,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;IAG1B,mDAAmD;;CAE3C,CAAA;AAEV;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;CAIhB,CAAA;AAGV,eAAO,MAAM,gBAAgB;IAC3B,+DAA+D;;IAE/D,2CAA2C;;CAEnC,CAAA;AAMV;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;CAQ1B,CAAA;AAEV,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAA"}

package/dist/src/constants.js

@@ -0,0 +1,87 @@
+/**
+ * Linear API Constants
+ *
+ * Contains API limits, well-known IDs, and configuration values.
+ * All workspace-specific IDs must be provided via environment variables.
+ */
+// ============================================================================
+// LINEAR API LIMITS
+// ============================================================================
+/**
+ * Maximum length for comment body.
+ * Linear doesn't publicly document this limit, but testing shows ~10k is safe.
+ * We use a conservative limit to avoid truncation issues.
+ */
+export const LINEAR_COMMENT_MAX_LENGTH = 10000;
+/**
+ * Marker appended when content is truncated
+ */
+export const TRUNCATION_MARKER = '\n\n... (content truncated)';
+/**
+ * Maximum number of comments for a single completion (safety limit)
+ */
+export const MAX_COMPLETION_COMMENTS = 10;
+/**
+ * Characters reserved for part markers and overhead
+ */
+export const COMMENT_OVERHEAD = 100;
+/**
+ * Continuation marker for multi-part comments
+ */
+export const CONTINUATION_MARKER = '\n\n*...continued in next comment*';
+// ============================================================================
+// WELL-KNOWN LINEAR IDs
+// All workspace-specific IDs are loaded from environment variables.
+// No hardcoded fallback UUIDs — configure via env vars.
+// ============================================================================
+/**
+ * Default team UUID
+ * Must be set via LINEAR_TEAM_ID env var
+ */
+export const DEFAULT_TEAM_ID = process.env.LINEAR_TEAM_ID ?? '';
+/**
+ * Project IDs — must be set via env vars:
+ * - LINEAR_PROJECT_AGENT
+ * - LINEAR_PROJECT_SOCIAL
+ * - LINEAR_PROJECT_TEST
+ */
+export const LINEAR_PROJECTS = {
+    get AGENT() { return process.env.LINEAR_PROJECT_AGENT ?? ''; },
+    get SOCIAL() { return process.env.LINEAR_PROJECT_SOCIAL ?? ''; },
+    /** Test project for E2E testing of orchestrator */
+    get TEST() { return process.env.LINEAR_PROJECT_TEST ?? ''; },
+};
+/**
+ * Label IDs for issue classification
+ * Must be set via env vars:
+ * - LINEAR_LABEL_BUG
+ * - LINEAR_LABEL_FEATURE
+ * - LINEAR_LABEL_CHORE
+ */
+export const LINEAR_LABELS = {
+    get BUG() { return process.env.LINEAR_LABEL_BUG ?? ''; },
+    get FEATURE() { return process.env.LINEAR_LABEL_FEATURE ?? ''; },
+    get CHORE() { return process.env.LINEAR_LABEL_CHORE ?? ''; },
+};
+// Test-related labels (created dynamically, not hardcoded IDs)
+export const TEST_LABEL_NAMES = {
+    /** Mark issues as test fixtures (not for manual processing) */
+    TEST_FIXTURE: 'test-fixture',
+    /** Identify issues created by E2E tests */
+    E2E_TEST: 'e2e-test',
+};
+// ============================================================================
+// ENVIRONMENT ISSUE REPORTING
+// ============================================================================
+/**
+ * Categories of environment issues that agents can report
+ */
+export const ENVIRONMENT_ISSUE_TYPES = {
+    PERMISSION: 'permission',
+    NETWORK: 'network',
+    SANDBOX: 'sandbox',
+    LINEAR_CLI: 'linear-cli',
+    DEPENDENCY: 'dependency',
+    TIMEOUT: 'timeout',
+    TOOL: 'tool',
+};

package/dist/src/errors.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Base error class for Linear Agent SDK errors
+ */
+export declare class LinearAgentError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, context?: Record<string, unknown> | undefined);
+}
+/**
+ * Error thrown when Linear API returns an error response
+ */
+export declare class LinearApiError extends LinearAgentError {
+    readonly statusCode: number;
+    readonly response?: unknown | undefined;
+    constructor(message: string, statusCode: number, response?: unknown | undefined);
+}
+/**
+ * Error thrown when all retry attempts are exhausted
+ */
+export declare class LinearRetryExhaustedError extends LinearAgentError {
+    readonly attempts: number;
+    readonly lastError: Error;
+    constructor(message: string, attempts: number, lastError: Error);
+}
+/**
+ * Error thrown when session operations fail
+ */
+export declare class LinearSessionError extends LinearAgentError {
+    readonly sessionId?: string | undefined;
+    readonly issueId?: string | undefined;
+    constructor(message: string, sessionId?: string | undefined, issueId?: string | undefined);
+}
+/**
+ * Error thrown when activity emission fails
+ */
+export declare class LinearActivityError extends LinearAgentError {
+    readonly activityType: string;
+    readonly sessionId?: string | undefined;
+    constructor(message: string, activityType: string, sessionId?: string | undefined);
+}
+/**
+ * Error thrown when plan update fails
+ */
+export declare class LinearPlanError extends LinearAgentError {
+    readonly sessionId?: string | undefined;
+    constructor(message: string, sessionId?: string | undefined);
+}
+/**
+ * Error thrown when issue status transition fails
+ */
+export declare class LinearStatusTransitionError extends LinearAgentError {
+    readonly issueId: string;
+    readonly fromStatus: string;
+    readonly toStatus: string;
+    constructor(message: string, issueId: string, fromStatus: string, toStatus: string);
+}
+/**
+ * Error thrown when agent spawning fails
+ */
+export declare class AgentSpawnError extends LinearAgentError {
+    readonly issueId: string;
+    readonly sessionId?: string | undefined;
+    readonly isRetryable: boolean;
+    readonly cause?: Error | undefined;
+    constructor(message: string, issueId: string, sessionId?: string | undefined, isRetryable?: boolean, cause?: Error | undefined);
+}
+/**
+ * Type guard to check if an error is a LinearAgentError
+ */
+export declare function isLinearAgentError(error: unknown): error is LinearAgentError;
+/**
+ * Type guard to check if an error is an AgentSpawnError
+ */
+export declare function isAgentSpawnError(error: unknown): error is AgentSpawnError;
+/**
+ * Type guard to check if an error is retryable
+ */
+export declare function isRetryableError(error: unknown, retryableStatusCodes?: number[]): boolean;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAQpD;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;aAGhC,UAAU,EAAE,MAAM;aAClB,QAAQ,CAAC,EAAE,OAAO;gBAFlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,OAAO,YAAA;CAKrC;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;aAG3C,QAAQ,EAAE,MAAM;aAChB,SAAS,EAAE,KAAK;gBAFhC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,KAAK;CAQnC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;aAGpC,SAAS,CAAC,EAAE,MAAM;aAClB,OAAO,CAAC,EAAE,MAAM;gBAFhC,OAAO,EAAE,MAAM,EACC,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,OAAO,CAAC,EAAE,MAAM,YAAA;CAKnC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;aAGrC,YAAY,EAAE,MAAM;aACpB,SAAS,CAAC,EAAE,MAAM;gBAFlC,OAAO,EAAE,MAAM,EACC,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,YAAA;CAKrC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;aACN,SAAS,CAAC,EAAE,MAAM;gBAAnD,OAAO,EAAE,MAAM,EAAkB,SAAS,CAAC,EAAE,MAAM,YAAA;CAIhE;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,gBAAgB;aAG7C,OAAO,EAAE,MAAM;aACf,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;gBAHhC,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;CASnC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;aAGjC,OAAO,EAAE,MAAM;aACf,SAAS,CAAC,EAAE,MAAM;aAClB,WAAW,EAAE,OAAO;aACpB,KAAK,CAAC,EAAE,KAAK;gBAJ7B,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,WAAW,GAAE,OAAe,EAC5B,KAAK,CAAC,EAAE,KAAK,YAAA;CAUhC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,oBAAoB,GAAE,MAAM,EAA8B,GACzD,OAAO,CAkBT"}

package/dist/src/errors.js

@@ -0,0 +1,155 @@
+/**
+ * Base error class for Linear Agent SDK errors
+ */
+export class LinearAgentError extends Error {
+    code;
+    context;
+    constructor(message, code, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = 'LinearAgentError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, LinearAgentError);
+        }
+    }
+}
+/**
+ * Error thrown when Linear API returns an error response
+ */
+export class LinearApiError extends LinearAgentError {
+    statusCode;
+    response;
+    constructor(message, statusCode, response) {
+        super(message, 'LINEAR_API_ERROR', { statusCode, response });
+        this.statusCode = statusCode;
+        this.response = response;
+        this.name = 'LinearApiError';
+    }
+}
+/**
+ * Error thrown when all retry attempts are exhausted
+ */
+export class LinearRetryExhaustedError extends LinearAgentError {
+    attempts;
+    lastError;
+    constructor(message, attempts, lastError) {
+        super(message, 'RETRY_EXHAUSTED', {
+            attempts,
+            lastErrorMessage: lastError.message,
+        });
+        this.attempts = attempts;
+        this.lastError = lastError;
+        this.name = 'LinearRetryExhaustedError';
+    }
+}
+/**
+ * Error thrown when session operations fail
+ */
+export class LinearSessionError extends LinearAgentError {
+    sessionId;
+    issueId;
+    constructor(message, sessionId, issueId) {
+        super(message, 'SESSION_ERROR', { sessionId, issueId });
+        this.sessionId = sessionId;
+        this.issueId = issueId;
+        this.name = 'LinearSessionError';
+    }
+}
+/**
+ * Error thrown when activity emission fails
+ */
+export class LinearActivityError extends LinearAgentError {
+    activityType;
+    sessionId;
+    constructor(message, activityType, sessionId) {
+        super(message, 'ACTIVITY_ERROR', { activityType, sessionId });
+        this.activityType = activityType;
+        this.sessionId = sessionId;
+        this.name = 'LinearActivityError';
+    }
+}
+/**
+ * Error thrown when plan update fails
+ */
+export class LinearPlanError extends LinearAgentError {
+    sessionId;
+    constructor(message, sessionId) {
+        super(message, 'PLAN_ERROR', { sessionId });
+        this.sessionId = sessionId;
+        this.name = 'LinearPlanError';
+    }
+}
+/**
+ * Error thrown when issue status transition fails
+ */
+export class LinearStatusTransitionError extends LinearAgentError {
+    issueId;
+    fromStatus;
+    toStatus;
+    constructor(message, issueId, fromStatus, toStatus) {
+        super(message, 'STATUS_TRANSITION_ERROR', {
+            issueId,
+            fromStatus,
+            toStatus,
+        });
+        this.issueId = issueId;
+        this.fromStatus = fromStatus;
+        this.toStatus = toStatus;
+        this.name = 'LinearStatusTransitionError';
+    }
+}
+/**
+ * Error thrown when agent spawning fails
+ */
+export class AgentSpawnError extends LinearAgentError {
+    issueId;
+    sessionId;
+    isRetryable;
+    cause;
+    constructor(message, issueId, sessionId, isRetryable = false, cause) {
+        super(message, 'AGENT_SPAWN_ERROR', {
+            issueId,
+            sessionId,
+            isRetryable,
+            causeMessage: cause?.message,
+        });
+        this.issueId = issueId;
+        this.sessionId = sessionId;
+        this.isRetryable = isRetryable;
+        this.cause = cause;
+        this.name = 'AgentSpawnError';
+    }
+}
+/**
+ * Type guard to check if an error is a LinearAgentError
+ */
+export function isLinearAgentError(error) {
+    return error instanceof LinearAgentError;
+}
+/**
+ * Type guard to check if an error is an AgentSpawnError
+ */
+export function isAgentSpawnError(error) {
+    return error instanceof AgentSpawnError;
+}
+/**
+ * Type guard to check if an error is retryable
+ */
+export function isRetryableError(error, retryableStatusCodes = [429, 500, 502, 503, 504]) {
+    if (error instanceof LinearApiError) {
+        return retryableStatusCodes.includes(error.statusCode);
+    }
+    if (error instanceof Error) {
+        const networkErrorPatterns = [
+            'ECONNREFUSED',
+            'ECONNRESET',
+            'ETIMEDOUT',
+            'ENOTFOUND',
+            'fetch failed',
+            'network error',
+        ];
+        return networkErrorPatterns.some((pattern) => error.message.toLowerCase().includes(pattern.toLowerCase()));
+    }
+    return false;
+}

package/dist/src/index.d.ts

@@ -0,0 +1,15 @@
+export type { AgentSessionState, AgentActivityType, AgentActivitySignal, AgentActivityContent, AgentActivityContentPayload, ThoughtActivityContent, ActionActivityContent, ResponseActivityContent, ElicitationActivityContent, ErrorActivityContent, PromptActivityContent, AgentActivityCreateInput, AgentActivityResult, CreateActivityOptions, AgentPlanItemState, AgentPlanItem, AgentPlan, AgentSignals, LinearAgentClientConfig, RetryConfig, LinearWorkflowStatus, StatusMapping, AgentSessionConfig, SessionOperationResult, AgentSessionExternalUrl, AgentSessionUpdateInput, AgentSessionUpdateResult, AgentSessionCreateOnIssueInput, AgentSessionCreateResult, AgentWorkType, IssueRelationType, IssueRelationCreateInput, IssueRelationResult, IssueRelationBatchResult, IssueRelationInfo, IssueRelationsResult, SubIssueGraphNode, SubIssueGraph, SubIssueStatus, } from './types';
+export { STATUS_WORK_TYPE_MAP, WORK_TYPE_START_STATUS, WORK_TYPE_COMPLETE_STATUS, WORK_TYPE_FAIL_STATUS, WORK_TYPE_ALLOWED_STATUSES, STATUS_VALID_WORK_TYPES, TERMINAL_STATUSES, validateWorkTypeForStatus, getValidWorkTypesForStatus, } from './types';
+export type { WorkTypeValidationResult } from './types';
+export { LinearAgentError, LinearApiError, LinearRetryExhaustedError, LinearSessionError, LinearActivityError, LinearPlanError, LinearStatusTransitionError, AgentSpawnError, isLinearAgentError, isRetryableError, isAgentSpawnError, } from './errors';
+export { DEFAULT_RETRY_CONFIG, sleep, calculateDelay, withRetry, createRetryWrapper, } from './retry';
+export type { RetryContext, RetryCallback, WithRetryOptions } from './retry';
+export { LINEAR_COMMENT_MAX_LENGTH, TRUNCATION_MARKER, MAX_COMPLETION_COMMENTS, COMMENT_OVERHEAD, CONTINUATION_MARKER, DEFAULT_TEAM_ID, LINEAR_PROJECTS, LINEAR_LABELS, ENVIRONMENT_ISSUE_TYPES, } from './constants';
+export type { EnvironmentIssueType } from './constants';
+export { truncateText, buildCompletionComment, splitContentIntoComments, buildCompletionComments, } from './utils';
+export type { CommentChunk } from './utils';
+export { parseCheckboxes, updateCheckbox, updateCheckboxByText, updateCheckboxes, hasCheckboxes, getCheckboxSummary, } from './checkbox-utils';
+export type { CheckboxItem, CheckboxUpdate } from './checkbox-utils';
+export { LinearAgentClient, createLinearAgentClient } from './agent-client';
+export { AgentSession, createAgentSession } from './agent-session';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,wBAAwB,EACxB,aAAa,EAEb,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EAEpB,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAGvD,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,2BAA2B,EAC3B,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,oBAAoB,EACpB,KAAK,EACL,cAAc,EACd,SAAS,EACT,kBAAkB,GACnB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG5E,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGvD,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAG3C,OAAO,EACL,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGpE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAG3E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,16 @@
+// Work type mappings for status-based routing
+export { STATUS_WORK_TYPE_MAP, WORK_TYPE_START_STATUS, WORK_TYPE_COMPLETE_STATUS, WORK_TYPE_FAIL_STATUS, WORK_TYPE_ALLOWED_STATUSES, STATUS_VALID_WORK_TYPES, TERMINAL_STATUSES, validateWorkTypeForStatus, getValidWorkTypesForStatus, } from './types';
+// Errors
+export { LinearAgentError, LinearApiError, LinearRetryExhaustedError, LinearSessionError, LinearActivityError, LinearPlanError, LinearStatusTransitionError, AgentSpawnError, isLinearAgentError, isRetryableError, isAgentSpawnError, } from './errors';
+// Retry utilities
+export { DEFAULT_RETRY_CONFIG, sleep, calculateDelay, withRetry, createRetryWrapper, } from './retry';
+// Constants
+export { LINEAR_COMMENT_MAX_LENGTH, TRUNCATION_MARKER, MAX_COMPLETION_COMMENTS, COMMENT_OVERHEAD, CONTINUATION_MARKER, DEFAULT_TEAM_ID, LINEAR_PROJECTS, LINEAR_LABELS, ENVIRONMENT_ISSUE_TYPES, } from './constants';
+// Utilities
+export { truncateText, buildCompletionComment, splitContentIntoComments, buildCompletionComments, } from './utils';
+// Checkbox utilities
+export { parseCheckboxes, updateCheckbox, updateCheckboxByText, updateCheckboxes, hasCheckboxes, getCheckboxSummary, } from './checkbox-utils';
+// Client
+export { LinearAgentClient, createLinearAgentClient } from './agent-client';
+// Session
+export { AgentSession, createAgentSession } from './agent-session';