@elizaos/plugin-linear 1.2.10 → 1.2.12

package/README.md

@@ -4,10 +4,20 @@ A comprehensive Linear integration plugin for ElizaOS that enables issue trackin
 
 ## Features
 
+### 🤖 Natural Language Understanding
+All actions now support advanced natural language parsing powered by LLM:
+- **Flexible References**: Reference issues by ID, title keywords, assignee, or recency
+- **Smart Filtering**: Use natural language for complex searches and filters
+- **Context Awareness**: Understands relative references like "my issues" or "today's activity"
+- **Graceful Fallbacks**: Falls back to pattern matching when LLM parsing fails
+
+## Core Features
+
 ### 📋 Issue Management
 - **Create Issues**: Create new issues with title, description, priority, assignees, and labels
 - **Get Issue Details**: Retrieve comprehensive information about specific issues
 - **Update Issues**: Modify existing issues with new information
+- **Delete Issues**: Archive issues (move to archived state)
 - **Search Issues**: Find issues using various filters and search criteria
 - **Add Comments**: Comment on existing issues
 
@@ -47,8 +57,23 @@ LINEAR_API_KEY=your_linear_api_key_here
 
 # Optional
 LINEAR_WORKSPACE_ID=your_workspace_id_here
+LINEAR_DEFAULT_TEAM_KEY=your_default_team_key_here  # e.g., ENG, ELIZA, COM2
 ```
 
+### Default Team Behavior
+
+When `LINEAR_DEFAULT_TEAM_KEY` is configured, it affects the following actions:
+
+- **Create Issue**: New issues will be assigned to the default team if no team is specified
+- **Search Issues**: Searches will be filtered by the default team unless:
+  - A team filter is explicitly provided
+  - The user asks for "all" issues
+- **List Projects**: Projects will be filtered by the default team unless:
+  - A specific team is mentioned
+  - The user asks for "all" projects
+
+This helps ensure that actions are scoped to the most relevant team by default while still allowing users to access all data when needed.
+
 ## Usage
 
 ### Register the Plugin
@@ -82,8 +107,11 @@ agent.registerPlugin(linearPlugin);
 
 #### Get Issue
 ```typescript
-// Natural language
-"Show me issue ENG-123"
+// Natural language examples
+"Show me issue ENG-123"  // Direct ID
+"What's the status of the login bug?"  // Search by title
+"Show me the latest high priority issue assigned to Sarah"  // Complex query
+"Get John's most recent task"  // Assignee + recency
 
 // With options
 {
@@ -97,7 +125,9 @@ agent.registerPlugin(linearPlugin);
 #### Search Issues
 ```typescript
 // Natural language
-"Show me all high priority bugs assigned to me"
+"Show me all high priority bugs assigned to me"  // Uses default team if configured
+"Show me all issues across all teams"  // Searches all teams
+"Show me issues in the ELIZA team"  // Searches specific team
 
 // With options
 {
@@ -106,6 +136,7 @@ agent.registerPlugin(linearPlugin);
     query: "bug",
     priority: [1, 2], // Urgent and High
     state: ["in-progress", "todo"],
+    team: "ELIZA",  // Override default team
     limit: 20
   }
 }
@@ -113,22 +144,53 @@ agent.registerPlugin(linearPlugin);
 
 #### Update Issue
 ```typescript
+// Natural language examples
+"Update issue ENG-123 title to 'Fix login button on all devices'"
+"Move issue COM2-7 to the ELIZA team"
+"Change the priority of BUG-456 to high and assign to john@example.com"
+"Update issue PROD-789 status to in-progress"
+
 // With options
 {
   action: "UPDATE_LINEAR_ISSUE",
   options: {
     issueId: "issue-id",
     title: "Updated title",
-    priority: 1,
-    stateId: "state-id"
+    description: "Updated description",
+    priority: 1,  // 1=urgent, 2=high, 3=normal, 4=low
+    teamId: "team-id",  // Move to different team
+    assigneeId: "user-id",
+    stateId: "state-id",
+    labelIds: ["label-id-1", "label-id-2"]
   }
 }
 ```
 
-#### Add Comment
+#### Delete Issue
 ```typescript
 // Natural language
+"Delete issue ENG-123"
+"Remove COM2-7 from Linear"
+"Archive the bug report BUG-456"
+
+// With options
+{
+  action: "DELETE_LINEAR_ISSUE",
+  options: {
+    issueId: "issue-id-or-identifier"
+  }
+}
+```
+
+> **Note**: Linear doesn't support permanent deletion. This action archives the issue, moving it to an archived state where it won't appear in active views.
+
+#### Add Comment
+```typescript
+// Natural language examples
 "Comment on ENG-123: This has been fixed in the latest release"
+"Tell the login bug that we need more information from QA"
+"Reply to COM2-7: Thanks for the update"
+"Add a note to the payment issue saying it's blocked by API changes"
 
 // With options
 {
@@ -142,16 +204,21 @@ agent.registerPlugin(linearPlugin);
 
 #### List Teams
 ```typescript
-// Natural language
-"Show me all teams"
+// Natural language examples
+"Show me all teams"  // Lists all teams
+"Which engineering teams do we have?"  // Filter by name
+"Show me the teams I'm part of"  // Personal teams
+"Show me the ELIZA team details"  // Specific team lookup
 ```
 
 #### List Projects
 ```typescript
 // Natural language
-"Show me all projects"
+"Show me all projects"  // Uses default team filter if configured
+"Show me all projects across all teams"  // Lists all projects
+"Show me projects for the engineering team"  // Lists projects for specific team
 
-// Filter by team
+// With options
 {
   action: "LIST_LINEAR_PROJECTS",
   options: {
@@ -162,8 +229,12 @@ agent.registerPlugin(linearPlugin);
 
 #### Get Activity
 ```typescript
-// Natural language
-"Show me recent Linear activity"
+// Natural language examples
+"Show me recent Linear activity"  // All recent activity
+"What happened in Linear today?"  // Time-based filter
+"Show me what issues John created this week"  // User + action + time
+"Activity on ENG-123"  // Resource-specific activity
+"Show me failed operations"  // Filter by success status
 
 // With options
 {

package/dist/index.d.ts

@@ -73,6 +73,7 @@ declare class LinearService extends Service {
     createIssue(input: LinearIssueInput): Promise<Issue>;
     getIssue(issueId: string): Promise<Issue>;
     updateIssue(issueId: string, updates: Partial<LinearIssueInput>): Promise<Issue>;
+    deleteIssue(issueId: string): Promise<void>;
     searchIssues(filters: LinearSearchFilters): Promise<Issue[]>;
     createComment(input: LinearCommentInput): Promise<Comment>;
     getProjects(teamId?: string): Promise<Project[]>;