nimble_python 1.0.0__tar.gz → 1.1.0__tar.gz

nimble_python-1.1.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.1.0"
+}

{nimble_python-1.0.0 → nimble_python-1.1.0}/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.1.0 (2026-07-21)
+
+Full Changelog: [v1.0.0...v1.1.0](https://github.com/Nimbleway/nimble-python/compare/v1.0.0...v1.1.0)
+
+### Features
+
+* **api:** api update ([eb7a6d1](https://github.com/Nimbleway/nimble-python/commit/eb7a6d1eb27a62f0dcb852b287f2dfb64dcce1b1))
+* **api:** manual updates ([40714b6](https://github.com/Nimbleway/nimble-python/commit/40714b60e42e35f79f6263b0705c03c97a244d2d))
+
 ## 1.0.0 (2026-07-20)
 
 Full Changelog: [v0.24.0...v1.0.0](https://github.com/Nimbleway/nimble-python/compare/v0.24.0...v1.0.0)

{nimble_python-1.0.0 → nimble_python-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nimble_python
-Version: 1.0.0
+Version: 1.1.0
 Summary: The official Python library for the nimble API
 Project-URL: Homepage, https://github.com/Nimbleway/nimble-python
 Project-URL: Repository, https://github.com/Nimbleway/nimble-python

{nimble_python-1.0.0 → nimble_python-1.1.0}/api.md

@@ -106,6 +106,7 @@ from nimble_python.types import (
     AgentUpdateResponse,
     AgentListResponse,
     AgentGetResponse,
+    AgentRunResponse,
 )
 ```
 
@@ -116,6 +117,7 @@ Methods:
 - <code title="get /v2/agents">client.agents.<a href="./src/nimble_python/resources/agents/agents.py">list</a>(\*\*<a href="src/nimble_python/types/agent_list_params.py">params</a>) -> <a href="./src/nimble_python/types/agent_list_response.py">AgentListResponse</a></code>
 - <code title="delete /v2/agents/{agent_id}">client.agents.<a href="./src/nimble_python/resources/agents/agents.py">delete</a>(agent_id) -> None</code>
 - <code title="get /v2/agents/{agent_id}">client.agents.<a href="./src/nimble_python/resources/agents/agents.py">get</a>(agent_id) -> <a href="./src/nimble_python/types/agent_get_response.py">AgentGetResponse</a></code>
+- <code title="post /v2/agents/runs">client.agents.<a href="./src/nimble_python/resources/agents/agents.py">run</a>(\*\*<a href="src/nimble_python/types/agent_run_params.py">params</a>) -> <a href="./src/nimble_python/types/agent_run_response.py">AgentRunResponse</a></code>
 
 ## Templates
 

{nimble_python-1.0.0 → nimble_python-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nimble_python"
-version = "1.0.0"
+version = "1.1.0"
 description = "The official Python library for the nimble API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{nimble_python-1.0.0 → nimble_python-1.1.0}/src/nimble_python/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "nimble_python"
-__version__ = "1.0.0"  # x-release-please-version
+__version__ = "1.1.0"  # x-release-please-version

{nimble_python-1.0.0 → nimble_python-1.1.0}/src/nimble_python/resources/agents/agents.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, Iterable, Optional
+from typing import Dict, Union, Iterable, Optional
 from typing_extensions import Literal
 
 import httpx
@@ -15,7 +15,7 @@ from .runs import (
     RunsResourceWithStreamingResponse,
     AsyncRunsResourceWithStreamingResponse,
 )
-from ...types import agent_list_params, agent_create_params, agent_update_params
+from ...types import agent_run_params, agent_list_params, agent_create_params, agent_update_params
 from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import path_template, maybe_transform, async_maybe_transform
 from ..._compat import cached_property
@@ -36,6 +36,7 @@ from ..._response import (
 )
 from ..._base_client import make_request_options
 from ...types.agent_get_response import AgentGetResponse
+from ...types.agent_run_response import AgentRunResponse
 from ...types.agent_list_response import AgentListResponse
 from ...types.agent_create_response import AgentCreateResponse
 from ...types.agent_update_response import AgentUpdateResponse
@@ -77,12 +78,12 @@ class AgentsResource(SyncAPIResource):
         agent_name: Optional[str] | Omit = omit,
         description: Optional[str] | Omit = omit,
         display_name: Optional[str] | Omit = omit,
-        domain_expertise: Optional[str] | Omit = omit,
         effort: Literal["low", "medium", "high", "x-high", "max"] | Omit = omit,
         goals: SequenceNotStr[str] | Omit = omit,
         icon: Optional[str] | Omit = omit,
         is_active: bool | Omit = omit,
         output_schema: Optional[Dict[str, object]] | Omit = omit,
+        skill: Optional[str] | Omit = omit,
         sources: agent_create_params.Sources | Omit = omit,
         suggested_questions: SequenceNotStr[str] | Omit = omit,
         template: Optional[str] | Omit = omit,
@@ -108,8 +109,6 @@ class AgentsResource(SyncAPIResource):
 
           display_name: Human-friendly agent name shown to users.
 
-          domain_expertise: Domain expertise or operating context for the agent.
-
           effort: Default effort level for this agent's runs.
 
           goals: Ordered goals for the agent to follow.
@@ -120,6 +119,8 @@ class AgentsResource(SyncAPIResource):
 
           output_schema: JSON schema describing the structured output the agent should produce.
 
+          skill: Skill or operating context for the agent.
+
           sources: Source guidance for the agent.
 
           suggested_questions: Suggested prompts users can run with this agent.
@@ -144,12 +145,12 @@ class AgentsResource(SyncAPIResource):
                     "agent_name": agent_name,
                     "description": description,
                     "display_name": display_name,
-                    "domain_expertise": domain_expertise,
                     "effort": effort,
                     "goals": goals,
                     "icon": icon,
                     "is_active": is_active,
                     "output_schema": output_schema,
+                    "skill": skill,
                     "sources": sources,
                     "suggested_questions": suggested_questions,
                     "template": template,
@@ -320,6 +321,72 @@ class AgentsResource(SyncAPIResource):
             cast_to=AgentGetResponse,
         )
 
+    def run(
+        self,
+        *,
+        input: str,
+        effort: Optional[Literal["low", "medium", "high", "x-high", "max"]] | Omit = omit,
+        enable_events: bool | Omit = omit,
+        input_data: Union[Iterable[Dict[str, object]], Dict[str, object], None] | Omit = omit,
+        output_schema: Optional[Dict[str, object]] | Omit = omit,
+        previous_interaction_id: Optional[str] | Omit = omit,
+        sources: Optional[agent_run_params.Sources] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AgentRunResponse:
+        """Creates a minimal persistent Web Search Agent and starts a run for it.
+
+        The
+        response includes `web_search_agent_id` for later agent and run queries.
+
+        Args:
+          input: User prompt or task instructions for the run.
+
+          effort: Canonical effort tier names for the research graph.
+
+          enable_events: Whether to stream run events when supported.
+
+          input_data: Existing records to ENRICH: a list of partial rows, or a single object,
+              mirroring output_schema's shape.
+
+          output_schema: JSON schema overriding the agent's default structured output for this run.
+
+          previous_interaction_id: Previous interaction identifier used to continue a conversation.
+
+          sources: Source guidance overriding the agent default.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/v2/agents/runs",
+            body=maybe_transform(
+                {
+                    "input": input,
+                    "effort": effort,
+                    "enable_events": enable_events,
+                    "input_data": input_data,
+                    "output_schema": output_schema,
+                    "previous_interaction_id": previous_interaction_id,
+                    "sources": sources,
+                },
+                agent_run_params.AgentRunParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AgentRunResponse,
+        )
+
 
 class AsyncAgentsResource(AsyncAPIResource):
     @cached_property
@@ -355,12 +422,12 @@ class AsyncAgentsResource(AsyncAPIResource):
         agent_name: Optional[str] | Omit = omit,
         description: Optional[str] | Omit = omit,
         display_name: Optional[str] | Omit = omit,
-        domain_expertise: Optional[str] | Omit = omit,
         effort: Literal["low", "medium", "high", "x-high", "max"] | Omit = omit,
         goals: SequenceNotStr[str] | Omit = omit,
         icon: Optional[str] | Omit = omit,
         is_active: bool | Omit = omit,
         output_schema: Optional[Dict[str, object]] | Omit = omit,
+        skill: Optional[str] | Omit = omit,
         sources: agent_create_params.Sources | Omit = omit,
         suggested_questions: SequenceNotStr[str] | Omit = omit,
         template: Optional[str] | Omit = omit,
@@ -386,8 +453,6 @@ class AsyncAgentsResource(AsyncAPIResource):
 
           display_name: Human-friendly agent name shown to users.
 
-          domain_expertise: Domain expertise or operating context for the agent.
-
           effort: Default effort level for this agent's runs.
 
           goals: Ordered goals for the agent to follow.
@@ -398,6 +463,8 @@ class AsyncAgentsResource(AsyncAPIResource):
 
           output_schema: JSON schema describing the structured output the agent should produce.
 
+          skill: Skill or operating context for the agent.
+
           sources: Source guidance for the agent.
 
           suggested_questions: Suggested prompts users can run with this agent.
@@ -422,12 +489,12 @@ class AsyncAgentsResource(AsyncAPIResource):
                     "agent_name": agent_name,
                     "description": description,
                     "display_name": display_name,
-                    "domain_expertise": domain_expertise,
                     "effort": effort,
                     "goals": goals,
                     "icon": icon,
                     "is_active": is_active,
                     "output_schema": output_schema,
+                    "skill": skill,
                     "sources": sources,
                     "suggested_questions": suggested_questions,
                     "template": template,
@@ -598,6 +665,72 @@ class AsyncAgentsResource(AsyncAPIResource):
             cast_to=AgentGetResponse,
         )
 
+    async def run(
+        self,
+        *,
+        input: str,
+        effort: Optional[Literal["low", "medium", "high", "x-high", "max"]] | Omit = omit,
+        enable_events: bool | Omit = omit,
+        input_data: Union[Iterable[Dict[str, object]], Dict[str, object], None] | Omit = omit,
+        output_schema: Optional[Dict[str, object]] | Omit = omit,
+        previous_interaction_id: Optional[str] | Omit = omit,
+        sources: Optional[agent_run_params.Sources] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AgentRunResponse:
+        """Creates a minimal persistent Web Search Agent and starts a run for it.
+
+        The
+        response includes `web_search_agent_id` for later agent and run queries.
+
+        Args:
+          input: User prompt or task instructions for the run.
+
+          effort: Canonical effort tier names for the research graph.
+
+          enable_events: Whether to stream run events when supported.
+
+          input_data: Existing records to ENRICH: a list of partial rows, or a single object,
+              mirroring output_schema's shape.
+
+          output_schema: JSON schema overriding the agent's default structured output for this run.
+
+          previous_interaction_id: Previous interaction identifier used to continue a conversation.
+
+          sources: Source guidance overriding the agent default.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/v2/agents/runs",
+            body=await async_maybe_transform(
+                {
+                    "input": input,
+                    "effort": effort,
+                    "enable_events": enable_events,
+                    "input_data": input_data,
+                    "output_schema": output_schema,
+                    "previous_interaction_id": previous_interaction_id,
+                    "sources": sources,
+                },
+                agent_run_params.AgentRunParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AgentRunResponse,
+        )
+
 
 class AgentsResourceWithRawResponse:
     def __init__(self, agents: AgentsResource) -> None:
@@ -618,6 +751,9 @@ class AgentsResourceWithRawResponse:
         self.get = to_raw_response_wrapper(
             agents.get,
         )
+        self.run = to_raw_response_wrapper(
+            agents.run,
+        )
 
     @cached_property
     def templates(self) -> TemplatesResourceWithRawResponse:
@@ -647,6 +783,9 @@ class AsyncAgentsResourceWithRawResponse:
         self.get = async_to_raw_response_wrapper(
             agents.get,
         )
+        self.run = async_to_raw_response_wrapper(
+            agents.run,
+        )
 
     @cached_property
     def templates(self) -> AsyncTemplatesResourceWithRawResponse:
@@ -676,6 +815,9 @@ class AgentsResourceWithStreamingResponse:
         self.get = to_streamed_response_wrapper(
             agents.get,
         )
+        self.run = to_streamed_response_wrapper(
+            agents.run,
+        )
 
     @cached_property
     def templates(self) -> TemplatesResourceWithStreamingResponse:
@@ -705,6 +847,9 @@ class AsyncAgentsResourceWithStreamingResponse:
         self.get = async_to_streamed_response_wrapper(
             agents.get,
         )
+        self.run = async_to_streamed_response_wrapper(
+            agents.run,
+        )
 
     @cached_property
     def templates(self) -> AsyncTemplatesResourceWithStreamingResponse:

{nimble_python-1.0.0 → nimble_python-1.1.0}/src/nimble_python/types/__init__.py

@@ -21,6 +21,7 @@ from .map_response import MapResponse as MapResponse
 from .job_list_params import JobListParams as JobListParams
 from .search_response import SearchResponse as SearchResponse
 from .serp_run_params import SerpRunParams as SerpRunParams
+from .agent_run_params import AgentRunParams as AgentRunParams
 from .crawl_run_params import CrawlRunParams as CrawlRunParams
 from .job_get_response import JobGetResponse as JobGetResponse
 from .media_run_params import MediaRunParams as MediaRunParams
@@ -34,6 +35,7 @@ from .job_update_params import JobUpdateParams as JobUpdateParams
 from .serp_run_response import SerpRunResponse as SerpRunResponse
 from .task_get_response import TaskGetResponse as TaskGetResponse
 from .agent_get_response import AgentGetResponse as AgentGetResponse
+from .agent_run_response import AgentRunResponse as AgentRunResponse
 from .batch_get_response import BatchGetResponse as BatchGetResponse
 from .crawl_run_response import CrawlRunResponse as CrawlRunResponse
 from .extract_run_params import ExtractRunParams as ExtractRunParams

{nimble_python-1.0.0 → nimble_python-1.1.0}/src/nimble_python/types/agent_create_params.py

@@ -20,9 +20,6 @@ class AgentCreateParams(TypedDict, total=False):
     display_name: Optional[str]
     """Human-friendly agent name shown to users."""
 
-    domain_expertise: Optional[str]
-    """Domain expertise or operating context for the agent."""
-
     effort: Literal["low", "medium", "high", "x-high", "max"]
     """Default effort level for this agent's runs."""
 
@@ -38,6 +35,9 @@ class AgentCreateParams(TypedDict, total=False):
     output_schema: Optional[Dict[str, object]]
     """JSON schema describing the structured output the agent should produce."""
 
+    skill: Optional[str]
+    """Skill or operating context for the agent."""
+
     sources: Sources
     """Source guidance for the agent."""
 

{nimble_python-1.0.0 → nimble_python-1.1.0}/src/nimble_python/types/agent_create_response.py

@@ -88,9 +88,6 @@ class AgentCreateResponse(BaseModel):
     display_name: str
     """Human-friendly agent name shown to users."""
 
-    domain_expertise: str
-    """Domain expertise or operating context for the agent."""
-
     effort: Literal["low", "medium", "high", "x-high", "max"]
     """Default effort level for this agent's runs."""
 
@@ -106,6 +103,9 @@ class AgentCreateResponse(BaseModel):
     output_schema: Optional[Dict[str, object]] = None
     """JSON schema describing the structured output the agent should produce."""
 
+    skill: str
+    """Skill or operating context for the agent."""
+
     sources: Sources
     """Source guidance for the agent."""
 

{nimble_python-1.0.0 → nimble_python-1.1.0}/src/nimble_python/types/agent_get_response.py

@@ -88,9 +88,6 @@ class AgentGetResponse(BaseModel):
     display_name: str
     """Human-friendly agent name shown to users."""
 
-    domain_expertise: str
-    """Domain expertise or operating context for the agent."""
-
     effort: Literal["low", "medium", "high", "x-high", "max"]
     """Default effort level for this agent's runs."""
 
@@ -106,6 +103,9 @@ class AgentGetResponse(BaseModel):
     output_schema: Optional[Dict[str, object]] = None
     """JSON schema describing the structured output the agent should produce."""
 
+    skill: str
+    """Skill or operating context for the agent."""
+
     sources: Sources
     """Source guidance for the agent."""
 

{nimble_python-1.0.0 → nimble_python-1.1.0}/src/nimble_python/types/agent_list_response.py

@@ -96,9 +96,6 @@ class Item(BaseModel):
     display_name: str
     """Human-friendly agent name shown to users."""
 
-    domain_expertise: str
-    """Domain expertise or operating context for the agent."""
-
     effort: Literal["low", "medium", "high", "x-high", "max"]
     """Default effort level for this agent's runs."""
 
@@ -114,6 +111,9 @@ class Item(BaseModel):
     output_schema: Optional[Dict[str, object]] = None
     """JSON schema describing the structured output the agent should produce."""
 
+    skill: str
+    """Skill or operating context for the agent."""
+
     sources: ItemSources
     """Source guidance for the agent."""
 

nimble_python-1.1.0/src/nimble_python/types/agent_run_params.py

@@ -0,0 +1,74 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Union, Iterable, Optional
+from typing_extensions import Literal, Required, TypedDict
+
+from .._types import SequenceNotStr
+
+__all__ = ["AgentRunParams", "Sources", "SourcesAllow", "SourcesBlock"]
+
+
+class AgentRunParams(TypedDict, total=False):
+    input: Required[str]
+    """User prompt or task instructions for the run."""
+
+    effort: Optional[Literal["low", "medium", "high", "x-high", "max"]]
+    """Canonical effort tier names for the research graph."""
+
+    enable_events: bool
+    """Whether to stream run events when supported."""
+
+    input_data: Union[Iterable[Dict[str, object]], Dict[str, object], None]
+    """
+    Existing records to ENRICH: a list of partial rows, or a single object,
+    mirroring output_schema's shape.
+    """
+
+    output_schema: Optional[Dict[str, object]]
+    """JSON schema overriding the agent's default structured output for this run."""
+
+    previous_interaction_id: Optional[str]
+    """Previous interaction identifier used to continue a conversation."""
+
+    sources: Optional[Sources]
+    """Source guidance overriding the agent default."""
+
+
+class SourcesAllow(TypedDict, total=False):
+    domains: Required[SequenceNotStr[str]]
+    """Domains included in this source group."""
+
+    title: Required[str]
+    """Source group title."""
+
+    order: int
+    """Zero-based source group position."""
+
+
+class SourcesBlock(TypedDict, total=False):
+    domains: Required[SequenceNotStr[str]]
+    """Domains included in this source group."""
+
+    title: Required[str]
+    """Source group title."""
+
+    order: int
+    """Zero-based source group position."""
+
+
+class Sources(TypedDict, total=False):
+    """Source guidance overriding the agent default."""
+
+    allow: Iterable[SourcesAllow]
+    """Source groups the agent is allowed to use."""
+
+    avoid: Optional[str]
+    """Free-text guidance describing sources or domains to avoid."""
+
+    block: Iterable[SourcesBlock]
+    """Source groups the agent should not use."""
+
+    prioritize: Optional[str]
+    """Free-text guidance describing sources or domains to prioritize."""

nimble_python-1.1.0/src/nimble_python/types/agent_run_response.py

@@ -0,0 +1,54 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["AgentRunResponse", "Error"]
+
+
+class Error(BaseModel):
+    """Error details when the run failed."""
+
+    message: str
+    """Human-readable error description."""
+
+    ref_id: str
+    """Reference ID (equals the run id)."""
+
+
+class AgentRunResponse(BaseModel):
+    id: str
+    """Run identifier, format "task*run*{uuid}"."""
+
+    created_at: datetime
+    """When the run was created."""
+
+    effort: Literal["low", "medium", "high", "x-high", "max"]
+    """Effort level used for the run."""
+
+    interaction_id: str
+    """Interaction ID."""
+
+    is_active: bool
+    """True while status is 'queued' or 'running'."""
+
+    status: Literal["queued", "running", "completed", "failed", "cancelled"]
+    """Current run status."""
+
+    web_search_agent_id: str
+    """Web Search Agent instance this run belongs to."""
+
+    completed_at: Optional[datetime] = None
+    """When the run completed."""
+
+    error: Optional[Error] = None
+    """Error details when the run failed."""
+
+    prompt: Optional[str] = None
+    """Prompt submitted for the run."""
+
+    started_at: Optional[datetime] = None
+    """When the run started executing."""

{nimble_python-1.0.0 → nimble_python-1.1.0}/src/nimble_python/types/agent_update_response.py

@@ -88,9 +88,6 @@ class AgentUpdateResponse(BaseModel):
     display_name: str
     """Human-friendly agent name shown to users."""
 
-    domain_expertise: str
-    """Domain expertise or operating context for the agent."""
-
     effort: Literal["low", "medium", "high", "x-high", "max"]
     """Default effort level for this agent's runs."""
 
@@ -106,6 +103,9 @@ class AgentUpdateResponse(BaseModel):
     output_schema: Optional[Dict[str, object]] = None
     """JSON schema describing the structured output the agent should produce."""
 
+    skill: str
+    """Skill or operating context for the agent."""
+
     sources: Sources
     """Source guidance for the agent."""
 

{nimble_python-1.0.0 → nimble_python-1.1.0}/src/nimble_python/types/agents/template_get_response.py

@@ -58,9 +58,6 @@ class TemplateGetResponse(BaseModel):
     display_name: str
     """Human-friendly template name shown to users."""
 
-    domain_expertise: str
-    """Domain expertise or operating context for the template."""
-
     effort: Literal["low", "medium", "high", "x-high", "max"]
     """Default effort level for runs created from this template."""
 
@@ -73,6 +70,9 @@ class TemplateGetResponse(BaseModel):
     output_schema: Optional[Dict[str, object]] = None
     """JSON schema describing the structured output the agent should produce."""
 
+    skill: str
+    """Skill or operating context for the template."""
+
     sources: List[Source]
     """Ordered source groups for the template."""
 

{nimble_python-1.0.0 → nimble_python-1.1.0}/src/nimble_python/types/agents/template_list_response.py

@@ -58,9 +58,6 @@ class Item(BaseModel):
     display_name: str
     """Human-friendly template name shown to users."""
 
-    domain_expertise: str
-    """Domain expertise or operating context for the template."""
-
     effort: Literal["low", "medium", "high", "x-high", "max"]
     """Default effort level for runs created from this template."""
 
@@ -73,6 +70,9 @@ class Item(BaseModel):
     output_schema: Optional[Dict[str, object]] = None
     """JSON schema describing the structured output the agent should produce."""
 
+    skill: str
+    """Skill or operating context for the template."""
+
     sources: List[ItemSource]
     """Ordered source groups for the template."""