@supaku/agentfactory-linear

Linear issue tracker integration for AgentFactory. Provides the Linear API client, agent sessions, status transitions, activity streaming, and work type routing.

Installation

npm install @supaku/agentfactory-linear

Quick Start

Linear Client

import { createLinearAgentClient } from '@supaku/agentfactory-linear'

const client = createLinearAgentClient({ apiKey: process.env.LINEAR_API_KEY! })

const issue = await client.getIssue('PROJ-123')
await client.updateIssueStatus('PROJ-123', 'Started')
await client.createComment(issue.id, 'Work in progress...')

Agent Sessions

Manage the lifecycle of an agent working on an issue:

import { createAgentSession } from '@supaku/agentfactory-linear'

const session = createAgentSession({
  client: linearClient.linearClient,
  issueId: 'issue-uuid',
  autoTransition: true,
  workType: 'development',
})

await session.start()                              // Status -> Started
await session.emitThought('Analyzing requirements...')
await session.updatePlan([
  { title: 'Read code', state: 'completed' },
  { title: 'Implement feature', state: 'inProgress' },
  { title: 'Write tests', state: 'pending' },
])
await session.complete('Feature implemented')      // Status -> Finished

Work Type Routing

Issues are automatically routed to work types based on their Linear status:

| Status | Work Type | Agent Role | |--------|-----------|------------| | Backlog | development | Implement the feature/fix | | Started | inflight | Continue in-progress work | | Finished | qa | Validate implementation | | Delivered | acceptance | Final acceptance testing | | Rejected | refinement | Address feedback |

Default Prompt Templates

Sensible defaults for new projects — override per work type as needed:

import {
  defaultGeneratePrompt,
  defaultDetectWorkTypeFromPrompt,
  defaultGetPriority,
} from '@supaku/agentfactory-linear'

Key Exports

• LinearAgentClient / createLinearAgentClient — Linear API client with retry logic
• AgentSession / createAgentSession — agent lifecycle management
• defaultGeneratePrompt — default prompt generation
• defaultDetectWorkTypeFromPrompt — work type detection from free text
• defaultGetPriority — priority mapping for work types
• Work type constants, error types, webhook event types

Related Packages

| Package | Description | |---------|-------------| | @supaku/agentfactory | Core orchestrator | | @supaku/agentfactory-nextjs | Next.js webhook server |

License

MIT