AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.
fix(platform): Improve Linear Search Block [SECRT-1880] (#11967)
Otto4f908d5cb32e
diff --git a/autogpt_platform/backend/backend/blocks/linear/_api.py b/autogpt_platform/backend/backend/blocks/linear/_api.pyindex 477b8a209c..ea609d515a 100644--- a/autogpt_platform/backend/backend/blocks/linear/_api.py+++ b/autogpt_platform/backend/backend/blocks/linear/_api.py@@ -162,8 +162,16 @@ class LinearClient:"searchTerm": team_name,}- team_id = await self.query(query, variables)- return team_id["teams"]["nodes"][0]["id"]+ result = await self.query(query, variables)+ nodes = result["teams"]["nodes"]++ if not nodes:+ raise LinearAPIException(+ f"Team '{team_name}' not found. Check the team name or key and try again.",+ status_code=404,+ )++ return nodes[0]["id"]except LinearAPIException as e:raise e@@ -240,17 +248,44 @@ class LinearClient:except LinearAPIException as e:raise e- async def try_search_issues(self, term: str) -> list[Issue]:+ async def try_search_issues(+ self,+ term: str,+ max_results: int = 10,+ team_id: str | None = None,+ ) -> list[Issue]:try:query = """- query SearchIssues($term: String!, $includeComments: Boolean!) {- searchIssues(term: $term, includeComments: $includeComments) {+ query SearchIssues(+ $term: String!,+ $first: Int,+ $teamId: String+ ) {+ searchIssues(+ term: $term,+ first: $first,+ teamId: $teamId+ ) {nodes {ididentifiertitledescriptionpriority+ createdAt+ state {+ id+ name+ type+ }+ project {+ id+ name+ }+ assignee {+ id+ name+ }}}}@@ -258,7 +293,8 @@ class LinearClient:variables: dict[str, Any] = {"term": term,- "includeComments": True,+ "first": max_results,+ "teamId": team_id,}issues = await self.query(query, variables)diff --git a/autogpt_platform/backend/backend/blocks/linear/issues.py b/autogpt_platform/backend/backend/blocks/linear/issues.pyindex baac01214c..165178f8ee 100644--- a/autogpt_platform/backend/backend/blocks/linear/issues.py+++ b/autogpt_platform/backend/backend/blocks/linear/issues.py@@ -17,7 +17,7 @@ from ._config import (LinearScope,linear,)-from .models import CreateIssueResponse, Issue+from .models import CreateIssueResponse, Issue, Stateclass LinearCreateIssueBlock(Block):@@ -135,9 +135,20 @@ class LinearSearchIssuesBlock(Block):description="Linear credentials with read permissions",required_scopes={LinearScope.READ},)+ max_results: int = SchemaField(+ description="Maximum number of results to return",+ default=10,+ ge=1,+ le=100,+ )+ team_name: str | None = SchemaField(+ description="Optional team name to filter results (e.g., 'Internal', 'Open Source')",+ default=None,+ )class Output(BlockSchemaOutput):issues: list[Issue] = SchemaField(description="List of issues")+ error: str = SchemaField(description="Error message if the search failed")def __init__(self):super().__init__(@@ -145,8 +156,11 @@ class LinearSearchIssuesBlock(Block):description="Searches for issues on Linear",input_schema=self.Input,output_schema=self.Output,+ categories={BlockCategory.PRODUCTIVITY, BlockCategory.ISSUE_TRACKING},test_input={"term": "Test issue",+ "max_results": 10,+ "team_name": None,"credentials": TEST_CREDENTIALS_INPUT_OAUTH,},test_credentials=TEST_CREDENTIALS_OAUTH,@@ -156,10 +170,14 @@ class LinearSearchIssuesBlock(Block):[Issue(id="abc123",- identifier="abc123",+ identifier="TST-123",title="Test issue",description="Test description",priority=1,+ state=State(+ id="state1", name="In Progress", type="started"+ ),+ createdAt="2026-01-15T10:00:00.000Z",)],)@@ -168,10 +186,12 @@ class LinearSearchIssuesBlock(Block):"search_issues": lambda *args, **kwargs: [Issue(id="abc123",- identifier="abc123",+ identifier="TST-123",title="Test issue",description="Test description",priority=1,+ state=State(id="state1", name="In Progress", type="started"),+ createdAt="2026-01-15T10:00:00.000Z",)]},@@ -181,10 +201,22 @@ class LinearSearchIssuesBlock(Block):async def search_issues(credentials: OAuth2Credentials | APIKeyCredentials,term: str,+ max_results: int = 10,+ team_name: str | None = None,) -> list[Issue]:client = LinearClient(credentials=credentials)- response: list[Issue] = await client.try_search_issues(term=term)- return response++ # Resolve team name to ID if provided+ # Raises LinearAPIException with descriptive message if team not found+ team_id: str | None = None+ if team_name:+ team_id = await client.try_get_team_by_name(team_name=team_name)++ return await client.try_search_issues(+ term=term,+ max_results=max_results,+ team_id=team_id,+ )async def run(self,@@ -196,7 +228,10 @@ class LinearSearchIssuesBlock(Block):"""Execute the issue search"""try:issues = await self.search_issues(- credentials=credentials, term=input_data.term+ credentials=credentials,+ term=input_data.term,+ max_results=input_data.max_results,+ team_name=input_data.team_name,)yield "issues", issuesexcept LinearAPIException as e:diff --git a/autogpt_platform/backend/backend/blocks/linear/models.py b/autogpt_platform/backend/backend/blocks/linear/models.pyindex bfeaa13656..dd1f603459 100644--- a/autogpt_platform/backend/backend/blocks/linear/models.py+++ b/autogpt_platform/backend/backend/blocks/linear/models.py@@ -36,12 +36,21 @@ class Project(BaseModel):content: str | None = None+class State(BaseModel):+ id: str+ name: str+ type: str | None = (+ None # Workflow state type (e.g., "triage", "backlog", "started", "completed", "canceled")+ )++class Issue(BaseModel):id: stridentifier: strtitle: strdescription: str | Nonepriority: int+ state: State | None = Noneproject: Project | None = NonecreatedAt: str | None = Nonecomments: list[Comment] | None = Nonediff --git a/docs/integrations/README.md b/docs/integrations/README.mdindex 263d7e6365..7f2ea19721 100644--- a/docs/integrations/README.md+++ b/docs/integrations/README.md@@ -62,7 +62,6 @@ Below is a comprehensive list of all available blocks, categorized by their prim| [Get Store Agent Details](block-integrations/system/store_operations.md#get-store-agent-details) | Get detailed information about an agent from the store || [Get Weather Information](block-integrations/basic.md#get-weather-information) | Retrieves weather information for a specified location using OpenWeatherMap API || [Human In The Loop](block-integrations/basic.md#human-in-the-loop) | Pause execution and wait for human approval or modification of data |-| [Linear Search Issues](block-integrations/linear/issues.md#linear-search-issues) | Searches for issues on Linear || [List Is Empty](block-integrations/basic.md#list-is-empty) | Checks if a list is empty || [List Library Agents](block-integrations/system/library_operations.md#list-library-agents) | List all agents in your personal library || [Note](block-integrations/basic.md#note) | A visual annotation block that displays a sticky note in the workflow editor for documentation and organization purposes |@@ -571,6 +570,7 @@ Below is a comprehensive list of all available blocks, categorized by their prim| [Linear Create Comment](block-integrations/linear/comment.md#linear-create-comment) | Creates a new comment on a Linear issue || [Linear Create Issue](block-integrations/linear/issues.md#linear-create-issue) | Creates a new issue on Linear || [Linear Get Project Issues](block-integrations/linear/issues.md#linear-get-project-issues) | Gets issues from a Linear project filtered by status and assignee |+| [Linear Search Issues](block-integrations/linear/issues.md#linear-search-issues) | Searches for issues on Linear || [Linear Search Projects](block-integrations/linear/projects.md#linear-search-projects) | Searches for projects on Linear |## Hardwarediff --git a/docs/integrations/block-integrations/linear/issues.md b/docs/integrations/block-integrations/linear/issues.mdindex 8955ba761e..fffd1a97c7 100644--- a/docs/integrations/block-integrations/linear/issues.md+++ b/docs/integrations/block-integrations/linear/issues.md@@ -90,9 +90,9 @@ Searches for issues on Linear### How it works<!-- MANUAL: how_it_works -->-This block searches for issues in Linear using a text query. It searches across issue titles, descriptions, and other fields to find matching issues.+This block searches for issues in Linear using a text query. It searches across issue titles, descriptions, and other fields to find matching issues. You can limit the number of results returned using the `max_results` parameter (default: 10, max: 100) to control token consumption and response size.-Returns a list of issues matching the search term.+Optionally filter results by team name to narrow searches to specific workspaces. If a team name is provided, the block resolves it to a team ID before searching. Returns matching issues with their state, creation date, project, and assignee information. If the search or team resolution fails, an error message is returned.<!-- END MANUAL -->### Inputs@@ -100,12 +100,14 @@ Returns a list of issues matching the search term.| Input | Description | Type | Required ||-------|-------------|------|----------|| term | Term to search for issues | str | Yes |+| max_results | Maximum number of results to return | int | No |+| team_name | Optional team name to filter results (e.g., 'Internal', 'Open Source') | str | No |### Outputs| Output | Description | Type ||--------|-------------|------|-| error | Error message if the operation failed | str |+| error | Error message if the search failed | str || issues | List of issues | List[Issue] |### Possible use case