@fdekit/connector-linear

Purpose

@fdekit/connector-linear lets FDEKit agents create Linear issues through both linear.issue.create and the common issue.create capability, read linked tickets through linear.issue.get (for PR intent checks), and post status comments through linear.issue.comment. Local mode returns deterministic issues; API mode calls Linear GraphQL.

Who should use this package

• Deployment authors who want issue creation in Linear.
• Recipe authors using the common issue.create capability across GitHub, Jira, and Linear.
• Connector contributors maintaining Linear API behavior and local-mode parity.

Choose GitHub or Jira connectors when the customer issue tracker is not Linear.

5-minute quick example

import { defineDeployment } from '@fdekit/core';
import { linearConnector } from '@fdekit/connector-linear';

const linear = linearConnector({
  mode: process.env.FDEKIT_CONNECTOR_MODE === 'api' ? 'api' : 'local',
  teamId: process.env.LINEAR_TEAM_ID,
});

export default defineDeployment({
  name: 'linear-escalation',
  environment: 'local',
  connectors: { linear },
  providers: {
    mock: { name: 'mock' },
  },
  agents: {
    // ...
  },
});

Set LINEAR_API_KEY and optionally LINEAR_TEAM_ID for API mode.

The common issue.create priority field accepts Linear's numeric priority values and backend-neutral labels such as low, normal, high, and urgent; labels are mapped to Linear's 0-4 priority scale before calling the API.

Public API surface

Import from the package root:

import { linearConnector } from '@fdekit/connector-linear';
import type { LinearConnectorOptions, CreateLinearIssueResult } from '@fdekit/connector-linear';

Root exports include linearConnector, LinearConnectorConfig, LinearConnectorMode, LinearConnectorOptions, CreateLinearIssueArgs, and CreateLinearIssueResult. The connector family is summarized in the public API index: Public API Reference.

Stability/backward-compat notes

@fdekit/connector-linear is public but pre-1.0. The package-root factory, option/result types, local/API modes, linear.issue.create, and issue.create tool names are compatibility-sensitive.

Subpath imports are internal. Keep local mode deterministic so demos and tests do not require Linear credentials.

See also

• Connector authoring contracts: @fdekit/core
• Runtime execution: @fdekit/runtime
• Issue connector neighbors: GitHub, Jira
• Connector family: customer API, codebase, Slack, Postgres, k6, HubSpot, Salesforce