@elizaos/plugin-linear 2.0.0-beta.1 → 2.0.11-beta.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,83 +1,123 @@
-# @elizaos/plugin-linear-ts
+# @elizaos/plugin-linear
 
-TypeScript implementation of the Linear integration plugin for ElizaOS.
+Linear issue-tracking integration for [elizaOS](https://github.com/elizaos/eliza). Gives Eliza agents full CRUD control over Linear issues, comments, teams, and projects through natural-language commands.
 
-## Features
+## What it does
 
-- **Issue Management**: Create, read, update, delete, and search issues
-- **Comment Management**: Add comments to issues
-- **Team Operations**: List and filter teams
-- **Project Management**: List and filter projects
-- **Activity Tracking**: Track and view Linear operations
-- **Natural Language Understanding**: LLM-powered parsing of user requests
+- Create, read, update, archive, and search Linear issues
+- Add, update, delete, and list comments on issues
+- Browse teams and active projects as agent context
+- Track an in-memory activity log of all Linear operations the agent performs
+- Register as a named search category (`linear_issues`) for structured issue queries
+- Support both API-key and OAuth workspace authentication
+- Multi-account configuration — manage multiple Linear workspaces from one agent
+
+## Requirements
+
+- Node.js runtime (ESM)
+- A Linear API key from [linear.app/settings/api](https://linear.app/settings/api)
 
 ## Installation
 
 ```bash
-npm install @elizaos/plugin-linear-ts
-# or
-bun add @elizaos/plugin-linear-ts
+bun add @elizaos/plugin-linear
 ```
 
 ## Configuration
 
-Set these environment variables:
+### Minimal (single workspace, API key)
 
 ```env
-LINEAR_API_KEY=your_api_key          # Required
-LINEAR_WORKSPACE_ID=your_workspace   # Optional
-LINEAR_DEFAULT_TEAM_KEY=ENG          # Optional
+LINEAR_API_KEY=lin_api_xxxxxxxxxxxxxxxxxxxxx
+```
+
+### Full options
+
+```env
+# Required
+LINEAR_API_KEY=lin_api_xxxxxxxxxxxxxxxxxxxxx
+
+# Optional
+LINEAR_WORKSPACE_ID=your_workspace_id
+LINEAR_DEFAULT_TEAM_KEY=ENG          # default team key for new issues
+LINEAR_ACCOUNT_ID=default            # label for this account in multi-account setups
+
+# Multi-account (JSON array or object keyed by account ID)
+LINEAR_ACCOUNTS=[{"accountId":"work","apiKey":"lin_api_...","defaultTeamKey":"ENG"},{"accountId":"oss","apiKey":"lin_api_..."}]
+
+# OAuth (only needed if using OAuth flow instead of API keys)
+LINEAR_OAUTH_CLIENT_ID=your_client_id
+LINEAR_OAUTH_CLIENT_SECRET=your_client_secret
+LINEAR_OAUTH_REDIRECT_URI=https://your-app/oauth/linear/callback
 ```
 
-## Usage
+Character-file alternative — set `character.settings.linear.accounts` to an array or object of account configs with the same fields.
+
+## Enabling the plugin
+
+Add it to your agent's plugin list:
 
 ```typescript
-import { linearPlugin } from "@elizaos/plugin-linear-ts";
+import { linearPlugin } from "@elizaos/plugin-linear";
 
-// Register with your ElizaOS agent
-agent.registerPlugin(linearPlugin);
+const agent = new AgentRuntime({
+  plugins: [linearPlugin],
+  // ...
+});
 ```
 
-## Actions
+The plugin validates the Linear API key on startup and will throw `LinearAuthenticationError` if none is found or the key is invalid.
 
-| Action                  | Description               |
-| ----------------------- | ------------------------- |
-| `CREATE_LINEAR_ISSUE`   | Create a new issue        |
-| `GET_LINEAR_ISSUE`      | Get issue details         |
-| `UPDATE_LINEAR_ISSUE`   | Update an existing issue  |
-| `DELETE_LINEAR_ISSUE`   | Archive an issue          |
-| `SEARCH_LINEAR_ISSUES`  | Search for issues         |
-| `CREATE_LINEAR_COMMENT` | Add a comment to an issue |
-| `LIST_LINEAR_TEAMS`     | List teams                |
-| `LIST_LINEAR_PROJECTS`  | List projects             |
-| `GET_LINEAR_ACTIVITY`   | View activity log         |
-| `CLEAR_LINEAR_ACTIVITY` | Clear activity log        |
+## Capabilities
 
-## Providers
+### Actions
 
-| Provider          | Description                   |
-| ----------------- | ----------------------------- |
-| `LINEAR_ISSUES`   | Context about recent issues   |
-| `LINEAR_TEAMS`    | Context about teams           |
-| `LINEAR_PROJECTS` | Context about projects        |
-| `LINEAR_ACTIVITY` | Context about recent activity |
+The plugin exposes a single `LINEAR` action that routes to 11 operations. The agent infers the operation from context, or you can pass `action` explicitly.
 
-## Development
+| Operation | What it does |
+|-----------|-------------|
+| `create_issue` | Create a new issue in a team |
+| `get_issue` | Fetch issue details by identifier (e.g. `ENG-123`) |
+| `update_issue` | Change title, description, priority, assignee, labels, state, estimate, or due date |
+| `delete_issue` | Archive an issue |
+| `search_issues` | Filter issues by query, state, assignee, label, project, team, or priority |
+| `create_comment` | Add a comment to an issue |
+| `update_comment` | Edit a comment |
+| `delete_comment` | Remove a comment |
+| `list_comments` | List comments on an issue |
+| `get_activity` | View the agent's operation history log |
+| `clear_activity` | Clear the activity log |
 
-```bash
-# Build
-npm run build
+Example triggers:
 
-# Test
-npm run test
+- "Create a Linear issue for the login bug in team ENG"
+- "What's the status of ENG-456?"
+- "Comment on ENG-123 that QA can retest"
+- "Search open high-priority bugs assigned to alice"
+- "Update ENG-789 priority to urgent"
 
-# Watch mode
-npm run dev
-```
+### Context providers
+
+These inject Linear data into the agent's context window automatically when relevant. All require `ADMIN` role.
+
+| Provider | Data injected |
+|----------|--------------|
+| `LINEAR_ISSUES` | Up to 10 recent issues with state and assignee |
+| `LINEAR_TEAMS` | Up to 20 teams with key, name, description |
+| `LINEAR_PROJECTS` | Up to 10 active projects with state and dates |
+| `LINEAR_ACTIVITY` | Last 10 Linear operations the agent performed |
+
+### Search category
+
+The plugin registers a `linear_issues` search category that accepts structured filters: `query`, `state`, `assignee`, `label`, `project`, `team`, `priority`, `limit`, `accountId`.
 
-## License
+## Priority values
 
-MIT
+Linear uses numeric priorities: `1` = Urgent, `2` = High, `3` = Normal, `4` = Low, `0` = No priority.
 
+## Notes
 
+- "Delete issue" calls Linear's archive endpoint — Linear does not expose hard-delete via the public API.
+- The activity log is in-memory and resets when the agent stops. Maximum 1000 entries.
+- All four providers are gated to the `automation` and `connectors` contexts, so they appear only when those contexts are active.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-linear",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.11-beta.7",
   "description": "Linear integration plugin for ElizaOS (TypeScript)",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -9,10 +9,26 @@
   "exports": {
     "./package.json": "./package.json",
     ".": {
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
       "import": {
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
@@ -32,7 +48,7 @@
     "lint:check": "bunx @biomejs/biome check .",
     "build": "bun run build.ts",
     "build:ts": "bun run build.ts",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsgo --noEmit"
   },
   "repository": {
     "type": "git",
@@ -53,8 +69,8 @@
   },
   "homepage": "https://github.com/elizaos/eliza#readme",
   "dependencies": {
-    "@elizaos/core": "2.0.0-beta.1",
-    "@linear/sdk": "^83.0.0"
+    "@elizaos/core": "2.0.11-beta.7",
+    "@linear/sdk": "^86.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.14",
@@ -93,5 +109,6 @@
     "platformDetails": {
       "node": "ESM build available via exports.import"
     }
-  }
+  },
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e"
 }