@supaku/agentfactory-linear 0.7.18 → 0.7.19

package/dist/src/circuit-breaker.test.js

@@ -0,0 +1,292 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { CircuitBreaker, DEFAULT_CIRCUIT_BREAKER_CONFIG } from './circuit-breaker.js';
+import { CircuitOpenError } from './errors.js';
+describe('CircuitBreaker', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    // ========================================================================
+    // Construction & defaults
+    // ========================================================================
+    it('starts in closed state', () => {
+        const cb = new CircuitBreaker();
+        expect(cb.state).toBe('closed');
+    });
+    it('uses default config when none provided', () => {
+        const cb = new CircuitBreaker();
+        const status = cb.getStatus();
+        expect(status.state).toBe('closed');
+        expect(status.consecutiveFailures).toBe(0);
+        expect(status.currentResetTimeoutMs).toBe(DEFAULT_CIRCUIT_BREAKER_CONFIG.resetTimeoutMs);
+    });
+    it('accepts custom config', () => {
+        const cb = new CircuitBreaker({ failureThreshold: 5, resetTimeoutMs: 30_000 });
+        // Trip it 4 times — should still be closed
+        for (let i = 0; i < 4; i++) {
+            cb.recordAuthFailure(401);
+        }
+        expect(cb.state).toBe('closed');
+        // 5th failure trips it
+        cb.recordAuthFailure(401);
+        expect(cb.state).toBe('open');
+    });
+    // ========================================================================
+    // canProceed
+    // ========================================================================
+    it('allows calls when closed', () => {
+        const cb = new CircuitBreaker();
+        expect(cb.canProceed()).toBe(true);
+    });
+    it('blocks calls when open', () => {
+        const cb = new CircuitBreaker({ failureThreshold: 1 });
+        cb.recordAuthFailure(401);
+        expect(cb.state).toBe('open');
+        expect(cb.canProceed()).toBe(false);
+    });
+    it('allows one probe call when half-open', () => {
+        const cb = new CircuitBreaker({ failureThreshold: 1, resetTimeoutMs: 1000 });
+        cb.recordAuthFailure(401);
+        expect(cb.state).toBe('open');
+        // Advance past reset timeout
+        vi.advanceTimersByTime(1001);
+        expect(cb.state).toBe('half-open');
+        // First call should be allowed (probe)
+        expect(cb.canProceed()).toBe(true);
+        // Second call should be blocked (probe already in-flight)
+        expect(cb.canProceed()).toBe(false);
+    });
+    // ========================================================================
+    // State transitions: closed → open
+    // ========================================================================
+    it('trips after consecutive auth failures reach threshold', () => {
+        const cb = new CircuitBreaker({ failureThreshold: 2 });
+        cb.recordAuthFailure(400);
+        expect(cb.state).toBe('closed');
+        cb.recordAuthFailure(401);
+        expect(cb.state).toBe('open');
+    });
+    it('ignores non-auth status codes for failure counting', () => {
+        const cb = new CircuitBreaker({ failureThreshold: 2 });
+        cb.recordAuthFailure(500); // not in authErrorCodes
+        cb.recordAuthFailure(502);
+        expect(cb.state).toBe('closed');
+        expect(cb.getStatus().consecutiveFailures).toBe(0);
+    });
+    it('resets failure count on success', () => {
+        const cb = new CircuitBreaker({ failureThreshold: 3 });
+        cb.recordAuthFailure(401); // 1
+        cb.recordAuthFailure(403); // 2
+        cb.recordSuccess(); // reset to 0
+        cb.recordAuthFailure(400); // 1 — should NOT trip
+        expect(cb.state).toBe('closed');
+    });
+    // ========================================================================
+    // State transitions: open → half-open
+    // ========================================================================
+    it('transitions from open to half-open after resetTimeoutMs', () => {
+        const cb = new CircuitBreaker({ failureThreshold: 1, resetTimeoutMs: 5000 });
+        cb.recordAuthFailure(401);
+        expect(cb.state).toBe('open');
+        // Not enough time
+        vi.advanceTimersByTime(4999);
+        expect(cb.state).toBe('open');
+        // Exactly enough time
+        vi.advanceTimersByTime(1);
+        expect(cb.state).toBe('half-open');
+    });
+    // ========================================================================
+    // State transitions: half-open → closed (probe success)
+    // ========================================================================
+    it('closes circuit on successful probe in half-open', () => {
+        const cb = new CircuitBreaker({ failureThreshold: 1, resetTimeoutMs: 1000 });
+        cb.recordAuthFailure(401);
+        vi.advanceTimersByTime(1001);
+        expect(cb.state).toBe('half-open');
+        // Probe succeeds
+        cb.canProceed(); // acquire probe
+        cb.recordSuccess();
+        expect(cb.state).toBe('closed');
+        expect(cb.getStatus().consecutiveFailures).toBe(0);
+    });
+    // ========================================================================
+    // State transitions: half-open → open (probe failure + exponential backoff)
+    // ========================================================================
+    it('reopens circuit on failed probe with exponential backoff', () => {
+        const cb = new CircuitBreaker({
+            failureThreshold: 1,
+            resetTimeoutMs: 1000,
+            maxResetTimeoutMs: 16000,
+            backoffMultiplier: 2,
+        });
+        // First trip
+        cb.recordAuthFailure(401);
+        expect(cb.state).toBe('open');
+        expect(cb.getStatus().currentResetTimeoutMs).toBe(1000);
+        // Wait for half-open
+        vi.advanceTimersByTime(1001);
+        expect(cb.state).toBe('half-open');
+        // Probe fails → reopen with backoff
+        cb.canProceed();
+        cb.recordAuthFailure(401);
+        expect(cb.state).toBe('open');
+        expect(cb.getStatus().currentResetTimeoutMs).toBe(2000); // 1000 * 2
+        // Wait 2000ms for next half-open
+        vi.advanceTimersByTime(2001);
+        expect(cb.state).toBe('half-open');
+        // Probe fails again → further backoff
+        cb.canProceed();
+        cb.recordAuthFailure(401);
+        expect(cb.state).toBe('open');
+        expect(cb.getStatus().currentResetTimeoutMs).toBe(4000); // 2000 * 2
+    });
+    it('caps reset timeout at maxResetTimeoutMs', () => {
+        const cb = new CircuitBreaker({
+            failureThreshold: 1,
+            resetTimeoutMs: 1000,
+            maxResetTimeoutMs: 3000,
+            backoffMultiplier: 2,
+        });
+        // Trip → open (1000ms)
+        cb.recordAuthFailure(401);
+        vi.advanceTimersByTime(1001);
+        // Probe fail → 2000ms
+        cb.canProceed();
+        cb.recordAuthFailure(401);
+        vi.advanceTimersByTime(2001);
+        // Probe fail → 3000ms (capped at max)
+        cb.canProceed();
+        cb.recordAuthFailure(401);
+        expect(cb.getStatus().currentResetTimeoutMs).toBe(3000);
+        vi.advanceTimersByTime(3001);
+        // Probe fail → still 3000ms (capped)
+        cb.canProceed();
+        cb.recordAuthFailure(401);
+        expect(cb.getStatus().currentResetTimeoutMs).toBe(3000);
+    });
+    it('resets backoff on successful recovery', () => {
+        const cb = new CircuitBreaker({
+            failureThreshold: 1,
+            resetTimeoutMs: 1000,
+            maxResetTimeoutMs: 16000,
+            backoffMultiplier: 2,
+        });
+        // Trip and backoff to 2000ms
+        cb.recordAuthFailure(401);
+        vi.advanceTimersByTime(1001);
+        cb.canProceed();
+        cb.recordAuthFailure(401);
+        expect(cb.getStatus().currentResetTimeoutMs).toBe(2000);
+        // Recover
+        vi.advanceTimersByTime(2001);
+        cb.canProceed();
+        cb.recordSuccess();
+        expect(cb.state).toBe('closed');
+        expect(cb.getStatus().currentResetTimeoutMs).toBe(1000); // reset to original
+    });
+    // ========================================================================
+    // reset()
+    // ========================================================================
+    it('reset() returns to closed from any state', () => {
+        const cb = new CircuitBreaker({ failureThreshold: 1 });
+        cb.recordAuthFailure(401);
+        expect(cb.state).toBe('open');
+        cb.reset();
+        expect(cb.state).toBe('closed');
+        expect(cb.getStatus().consecutiveFailures).toBe(0);
+        expect(cb.getStatus().currentResetTimeoutMs).toBe(DEFAULT_CIRCUIT_BREAKER_CONFIG.resetTimeoutMs);
+    });
+    // ========================================================================
+    // isAuthError
+    // ========================================================================
+    it('detects auth errors by HTTP status code', () => {
+        const cb = new CircuitBreaker();
+        expect(cb.isAuthError({ status: 400 })).toBe(true);
+        expect(cb.isAuthError({ status: 401 })).toBe(true);
+        expect(cb.isAuthError({ status: 403 })).toBe(true);
+        expect(cb.isAuthError({ statusCode: 401 })).toBe(true);
+        expect(cb.isAuthError({ response: { status: 403 } })).toBe(true);
+    });
+    it('does not flag non-auth status codes', () => {
+        const cb = new CircuitBreaker();
+        expect(cb.isAuthError({ status: 200 })).toBe(false);
+        expect(cb.isAuthError({ status: 404 })).toBe(false);
+        expect(cb.isAuthError({ status: 500 })).toBe(false);
+        expect(cb.isAuthError({ status: 429 })).toBe(false); // rate limit is handled separately
+    });
+    it('detects GraphQL RATELIMITED error code', () => {
+        const cb = new CircuitBreaker();
+        // Direct extensions.code
+        expect(cb.isAuthError({ extensions: { code: 'RATELIMITED' } })).toBe(true);
+        // Nested errors array
+        expect(cb.isAuthError({
+            errors: [{ extensions: { code: 'RATELIMITED' } }],
+        })).toBe(true);
+        // In response body
+        expect(cb.isAuthError({
+            response: {
+                body: {
+                    errors: [{ extensions: { code: 'RATELIMITED' } }],
+                },
+            },
+        })).toBe(true);
+        // In response data (alternative shape)
+        expect(cb.isAuthError({
+            response: {
+                data: {
+                    errors: [{ extensions: { code: 'RATELIMITED' } }],
+                },
+            },
+        })).toBe(true);
+    });
+    it('detects auth errors by message pattern', () => {
+        const cb = new CircuitBreaker();
+        expect(cb.isAuthError({ message: 'Access denied - Only app users can create agent activities' })).toBe(true);
+        expect(cb.isAuthError({ message: 'Unauthorized request' })).toBe(true);
+        expect(cb.isAuthError({ message: 'Forbidden: insufficient permissions' })).toBe(true);
+    });
+    it('rejects non-error inputs', () => {
+        const cb = new CircuitBreaker();
+        expect(cb.isAuthError(null)).toBe(false);
+        expect(cb.isAuthError(undefined)).toBe(false);
+        expect(cb.isAuthError('string')).toBe(false);
+        expect(cb.isAuthError(42)).toBe(false);
+    });
+    it('detects RATELIMITED in error message', () => {
+        const cb = new CircuitBreaker();
+        expect(cb.isAuthError({ message: 'GraphQL Error: RATELIMITED' })).toBe(true);
+    });
+    // ========================================================================
+    // createOpenError
+    // ========================================================================
+    it('creates a CircuitOpenError with remaining time info', () => {
+        const cb = new CircuitBreaker({ failureThreshold: 1, resetTimeoutMs: 10_000 });
+        cb.recordAuthFailure(401);
+        // 3 seconds have passed
+        vi.advanceTimersByTime(3000);
+        const error = cb.createOpenError();
+        expect(error).toBeInstanceOf(CircuitOpenError);
+        expect(error.code).toBe('CIRCUIT_OPEN');
+        expect(error.retryAfterMs).toBeGreaterThan(0);
+        expect(error.retryAfterMs).toBeLessThanOrEqual(7000);
+        expect(error.message).toMatch(/Circuit breaker is open/);
+    });
+    // ========================================================================
+    // getStatus diagnostic info
+    // ========================================================================
+    it('provides diagnostic status info', () => {
+        const cb = new CircuitBreaker({ failureThreshold: 1, resetTimeoutMs: 5000 });
+        let status = cb.getStatus();
+        expect(status.state).toBe('closed');
+        expect(status.consecutiveFailures).toBe(0);
+        expect(status.msSinceOpened).toBeNull();
+        cb.recordAuthFailure(401);
+        vi.advanceTimersByTime(2000);
+        status = cb.getStatus();
+        expect(status.state).toBe('open');
+        expect(status.consecutiveFailures).toBe(1);
+        expect(status.msSinceOpened).toBeGreaterThanOrEqual(2000);
+    });
+});

package/dist/src/errors.d.ts

@@ -54,6 +54,14 @@ export declare class LinearStatusTransitionError extends LinearAgentError {
     readonly toStatus: string;
     constructor(message: string, issueId: string, fromStatus: string, toStatus: string);
 }
+/**
+ * Error thrown when the circuit breaker is open.
+ * All API calls are blocked to prevent wasting rate limit quota.
+ */
+export declare class CircuitOpenError extends LinearAgentError {
+    readonly retryAfterMs: number;
+    constructor(message: string, retryAfterMs: number);
+}
 /**
  * Error thrown when agent spawning fails
  */
@@ -72,6 +80,10 @@ export declare function isLinearAgentError(error: unknown): error is LinearAgent
  * 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 a CircuitOpenError
+ */
+export declare function isCircuitOpenError(error: unknown): error is CircuitOpenError;
 /**
  * Type guard to check if an error is retryable
  */

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

@@ -1 +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"}
+{"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;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;aAGlC,YAAY,EAAE,MAAM;gBADpC,OAAO,EAAE,MAAM,EACC,YAAY,EAAE,MAAM;CAKvC;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,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,oBAAoB,GAAE,MAAM,EAA8B,GACzD,OAAO,CAkBT"}

package/dist/src/errors.js

@@ -99,6 +99,18 @@ export class LinearStatusTransitionError extends LinearAgentError {
         this.name = 'LinearStatusTransitionError';
     }
 }
+/**
+ * Error thrown when the circuit breaker is open.
+ * All API calls are blocked to prevent wasting rate limit quota.
+ */
+export class CircuitOpenError extends LinearAgentError {
+    retryAfterMs;
+    constructor(message, retryAfterMs) {
+        super(message, 'CIRCUIT_OPEN', { retryAfterMs });
+        this.retryAfterMs = retryAfterMs;
+        this.name = 'CircuitOpenError';
+    }
+}
 /**
  * Error thrown when agent spawning fails
  */
@@ -133,6 +145,12 @@ export function isLinearAgentError(error) {
 export function isAgentSpawnError(error) {
     return error instanceof AgentSpawnError;
 }
+/**
+ * Type guard to check if an error is a CircuitOpenError
+ */
+export function isCircuitOpenError(error) {
+    return error instanceof CircuitOpenError;
+}
 /**
  * Type guard to check if an error is retryable
  */

package/dist/src/index.d.ts

@@ -1,7 +1,7 @@
-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.js';
+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, RateLimiterStrategy, CircuitBreakerStrategy, CircuitBreakerConfig, } from './types.js';
 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.js';
 export type { WorkTypeValidationResult } from './types.js';
-export { LinearAgentError, LinearApiError, LinearRetryExhaustedError, LinearSessionError, LinearActivityError, LinearPlanError, LinearStatusTransitionError, AgentSpawnError, isLinearAgentError, isRetryableError, isAgentSpawnError, } from './errors.js';
+export { LinearAgentError, LinearApiError, LinearRetryExhaustedError, LinearSessionError, LinearActivityError, LinearPlanError, LinearStatusTransitionError, AgentSpawnError, CircuitOpenError, isLinearAgentError, isRetryableError, isAgentSpawnError, isCircuitOpenError, } from './errors.js';
 export { DEFAULT_RETRY_CONFIG, sleep, calculateDelay, withRetry, createRetryWrapper, } from './retry.js';
 export type { RetryContext, RetryCallback, WithRetryOptions } from './retry.js';
 export { LINEAR_COMMENT_MAX_LENGTH, TRUNCATION_MARKER, MAX_COMPLETION_COMMENTS, COMMENT_OVERHEAD, CONTINUATION_MARKER, getDefaultTeamId, getDefaultTeamName, LINEAR_PROJECTS, LINEAR_LABELS, ENVIRONMENT_ISSUE_TYPES, } from './constants.js';
@@ -12,6 +12,11 @@ export { parseCheckboxes, updateCheckbox, updateCheckboxByText, updateCheckboxes
 export type { CheckboxItem, CheckboxUpdate } from './checkbox-utils.js';
 export { TokenBucket, DEFAULT_RATE_LIMIT_CONFIG, extractRetryAfterMs } from './rate-limiter.js';
 export type { TokenBucketConfig } from './rate-limiter.js';
+export { CircuitBreaker, DEFAULT_CIRCUIT_BREAKER_CONFIG } from './circuit-breaker.js';
+export type { CircuitState } from './circuit-breaker.js';
+export type { ProxyRequest, ProxyResponse, IssueTrackerMethod, SerializedIssue, SerializedComment, SerializedViewer, SerializedTeam, ProxyHealthStatus, } from './issue-tracker-proxy.js';
+export { ProxyIssueTrackerClient, createProxyClientIfConfigured } from './proxy-client.js';
+export type { ProxyClientConfig } from './proxy-client.js';
 export { LinearAgentClient, createLinearAgentClient } from './agent-client.js';
 export { AgentSession, createAgentSession } from './agent-session.js';
 export * from './webhook-types.js';

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

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

package/dist/src/index.js

@@ -1,7 +1,7 @@
 // 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.js';
 // Errors
-export { LinearAgentError, LinearApiError, LinearRetryExhaustedError, LinearSessionError, LinearActivityError, LinearPlanError, LinearStatusTransitionError, AgentSpawnError, isLinearAgentError, isRetryableError, isAgentSpawnError, } from './errors.js';
+export { LinearAgentError, LinearApiError, LinearRetryExhaustedError, LinearSessionError, LinearActivityError, LinearPlanError, LinearStatusTransitionError, AgentSpawnError, CircuitOpenError, isLinearAgentError, isRetryableError, isAgentSpawnError, isCircuitOpenError, } from './errors.js';
 // Retry utilities
 export { DEFAULT_RETRY_CONFIG, sleep, calculateDelay, withRetry, createRetryWrapper, } from './retry.js';
 // Constants
@@ -12,6 +12,10 @@ export { truncateText, buildCompletionComment, splitContentIntoComments, buildCo
 export { parseCheckboxes, updateCheckbox, updateCheckboxByText, updateCheckboxes, hasCheckboxes, getCheckboxSummary, } from './checkbox-utils.js';
 // Rate limiter
 export { TokenBucket, DEFAULT_RATE_LIMIT_CONFIG, extractRetryAfterMs } from './rate-limiter.js';
+// Circuit breaker
+export { CircuitBreaker, DEFAULT_CIRCUIT_BREAKER_CONFIG } from './circuit-breaker.js';
+// Proxy client (routes calls through dashboard instead of Linear directly)
+export { ProxyIssueTrackerClient, createProxyClientIfConfigured } from './proxy-client.js';
 // Client
 export { LinearAgentClient, createLinearAgentClient } from './agent-client.js';
 // Session

package/dist/src/issue-tracker-proxy.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Platform-Agnostic Issue Tracker Proxy Interface
+ *
+ * Defines the contract between agents/governors and the centralized proxy.
+ * Agents call these methods without knowing whether the backend is Linear,
+ * Jira, GitHub Issues, or any future platform.
+ *
+ * The proxy translates these generic operations into platform-specific API calls.
+ */
+/**
+ * Every proxy request carries authentication and workspace context.
+ */
+export interface ProxyRequest {
+    /** The operation to perform */
+    method: IssueTrackerMethod;
+    /** Arguments for the operation (method-specific) */
+    args: unknown[];
+    /** Workspace/organization ID for multi-tenant routing */
+    organizationId?: string;
+}
+/**
+ * Standard proxy response envelope.
+ */
+export interface ProxyResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+    /** Rate limit info from the upstream platform */
+    quota?: {
+        requestsRemaining?: number;
+        complexityRemaining?: number;
+        resetAt?: number;
+    };
+}
+/**
+ * All operations that can be routed through the proxy.
+ *
+ * Named generically (not Linear-specific) so future platforms
+ * can implement the same interface.
+ */
+export type IssueTrackerMethod = 'getIssue' | 'updateIssue' | 'createIssue' | 'createComment' | 'getIssueComments' | 'getTeamStatuses' | 'updateIssueStatus' | 'createAgentActivity' | 'updateAgentSession' | 'createAgentSessionOnIssue' | 'createIssueRelation' | 'getIssueRelations' | 'deleteIssueRelation' | 'getSubIssues' | 'getSubIssueStatuses' | 'getSubIssueGraph' | 'isParentIssue' | 'isChildIssue' | 'listProjectIssues' | 'getProjectRepositoryUrl' | 'getViewer' | 'getTeam' | 'unassignIssue';
+/**
+ * Serialized issue — all relations pre-resolved to plain JSON.
+ * No SDK-specific Promise fields or lazy loaders.
+ */
+export interface SerializedIssue {
+    id: string;
+    identifier: string;
+    title: string;
+    description?: string;
+    url: string;
+    priority: number;
+    state?: {
+        id: string;
+        name: string;
+        type: string;
+    };
+    labels: Array<{
+        id: string;
+        name: string;
+    }>;
+    assignee?: {
+        id: string;
+        name: string;
+        email?: string;
+    } | null;
+    team?: {
+        id: string;
+        name: string;
+        key: string;
+    };
+    parent?: {
+        id: string;
+        identifier: string;
+    } | null;
+    project?: {
+        id: string;
+        name: string;
+    } | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Serialized comment.
+ */
+export interface SerializedComment {
+    id: string;
+    body: string;
+    createdAt: string;
+    updatedAt: string;
+    user?: {
+        id: string;
+        name: string;
+    } | null;
+}
+/**
+ * Serialized viewer (authenticated user).
+ */
+export interface SerializedViewer {
+    id: string;
+    name: string;
+    email: string;
+}
+/**
+ * Serialized team.
+ */
+export interface SerializedTeam {
+    id: string;
+    name: string;
+    key: string;
+}
+/**
+ * Health status for the proxy endpoint.
+ */
+export interface ProxyHealthStatus {
+    /** Whether the proxy can process requests */
+    healthy: boolean;
+    /** Circuit breaker state */
+    circuitBreaker: {
+        state: string;
+        failures: number;
+        msSinceOpened: number | null;
+    };
+    /** Rate limiter status */
+    rateLimiter: {
+        availableTokens: number;
+    };
+    /** Upstream platform quota from response headers */
+    quota: {
+        requestsRemaining: number | null;
+        complexityRemaining: number | null;
+        resetAt: number | null;
+        updatedAt: number;
+    };
+}
+//# sourceMappingURL=issue-tracker-proxy.d.ts.map

package/dist/src/issue-tracker-proxy.d.ts.map

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

package/dist/src/issue-tracker-proxy.js

@@ -0,0 +1,10 @@
+/**
+ * Platform-Agnostic Issue Tracker Proxy Interface
+ *
+ * Defines the contract between agents/governors and the centralized proxy.
+ * Agents call these methods without knowing whether the backend is Linear,
+ * Jira, GitHub Issues, or any future platform.
+ *
+ * The proxy translates these generic operations into platform-specific API calls.
+ */
+export {};