@crestal/nation-sdk 0.1.19 → 0.1.21

package/dist/base.d.ts

@@ -2,7 +2,7 @@
  * Nation IntentKit API
  * API for Nation IntentKit services
  *
- * The version of the OpenAPI document: 0.1.19
+ * The version of the OpenAPI document: 0.1.21
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/base.js

@@ -5,7 +5,7 @@
  * Nation IntentKit API
  * API for Nation IntentKit services
  *
- * The version of the OpenAPI document: 0.1.19
+ * The version of the OpenAPI document: 0.1.21
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/common.d.ts

@@ -2,7 +2,7 @@
  * Nation IntentKit API
  * API for Nation IntentKit services
  *
- * The version of the OpenAPI document: 0.1.19
+ * The version of the OpenAPI document: 0.1.21
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/common.js

@@ -5,7 +5,7 @@
  * Nation IntentKit API
  * API for Nation IntentKit services
  *
- * The version of the OpenAPI document: 0.1.19
+ * The version of the OpenAPI document: 0.1.21
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/configuration.d.ts

@@ -2,7 +2,7 @@
  * Nation IntentKit API
  * API for Nation IntentKit services
  *
- * The version of the OpenAPI document: 0.1.19
+ * The version of the OpenAPI document: 0.1.21
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/configuration.js

@@ -5,7 +5,7 @@
  * Nation IntentKit API
  * API for Nation IntentKit services
  *
- * The version of the OpenAPI document: 0.1.19
+ * The version of the OpenAPI document: 0.1.21
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * Nation IntentKit API
  * API for Nation IntentKit services
  *
- * The version of the OpenAPI document: 0.1.19
+ * The version of the OpenAPI document: 0.1.21
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/index.js

@@ -5,7 +5,7 @@
  * Nation IntentKit API
  * API for Nation IntentKit services
  *
- * The version of the OpenAPI document: 0.1.19
+ * The version of the OpenAPI document: 0.1.21
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/docs/AgentApi.md

@@ -4,14 +4,21 @@ All URIs are relative to *http://localhost*
 
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
-|[**createAgent**](#createagent) | **POST** /agents | Create a new agent|
-|[**getAgentById**](#getagentbyid) | **GET** /agents/{aid} | Get agent by ID|
+|[**createAgent**](#createagent) | **POST** /agents | Create Agent|
+|[**exportAgent**](#exportagent) | **GET** /agents/{agent_id}/export | Export Agent|
+|[**getAgent**](#getagent) | **GET** /agents/{agent_id} | Get Agent|
 |[**getAgentStatistics**](#getagentstatistics) | **GET** /agents/{aid}/statistics | Get Agent Statistics|
+|[**getAgents**](#getagents) | **GET** /agents | Get Agents|
+|[**importAgent**](#importagent) | **PUT** /agents/{agent_id}/import | Import Agent|
+|[**overrideAgent**](#overrideagent) | **PUT** /agents/{agent_id} | Override Agent|
+|[**updateAgent**](#updateagent) | **PATCH** /agents/{agent_id} | Update Agent|
+|[**validateAgentCreate**](#validateagentcreate) | **POST** /agent/validate | Validate Agent Create|
+|[**validateAgentUpdate**](#validateagentupdate) | **POST** /agents/{agent_id}/validate | Validate Agent Update|
 
 # **createAgent**
-> AgentResponse createAgent(agentUpdate)
+> AgentResponse createAgent()
 
-Create a new agent owned by the current user. The agent will be initialized with the provided details.
+Create a new agent.  **Request Body:** * `agent` - Agent configuration  **Returns:** * `AgentResponse` - Created agent configuration with additional processed data  **Raises:** * `HTTPException`:     - 400: Invalid agent ID format or agent ID already exists     - 500: Database error
 
 ### Example
 
@@ -25,7 +32,7 @@ import {
 const configuration = new Configuration();
 const apiInstance = new AgentApi(configuration);
 
-let agentUpdate: AgentUpdate; //
+let agentUpdate: AgentUpdate; // (optional)
 
 const { status, data } = await apiInstance.createAgent(
     agentUpdate
@@ -53,6 +60,61 @@ const { status, data } = await apiInstance.createAgent(
  - **Accept**: application/json
 
 
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Agent already exists |  -  |
+|**201** | Agent created |  -  |
+|**400** | Other client errors except format error |  -  |
+|**422** | Invalid agent configuration |  -  |
+|**500** | Server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **exportAgent**
+> any exportAgent()
+
+Export agent configuration as YAML.  **Path Parameters:** * `agent_id` - ID of the agent to export  **Returns:** * `str` - YAML configuration of the agent  **Raises:** * `HTTPException`:     - 404: Agent not found
+
+### Example
+
+```typescript
+import {
+    AgentApi,
+    Configuration
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new AgentApi(configuration);
+
+let agentId: string; //ID of the agent to export (default to undefined)
+
+const { status, data } = await apiInstance.exportAgent(
+    agentId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **agentId** | [**string**] | ID of the agent to export | defaults to undefined|
+
+
+### Return type
+
+**any**
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
@@ -61,10 +123,10 @@ const { status, data } = await apiInstance.createAgent(
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **getAgentById**
-> AgentResponse getAgentById()
+# **getAgent**
+> any getAgent()
 
-Retrieve a specific agent by its ID. Returns 404 if not found.
+Get a single agent by ID.  **Path Parameters:** * `agent_id` - ID of the agent to retrieve  **Returns:** * `AgentResponse` - Agent configuration with additional processed data  **Raises:** * `HTTPException`:     - 404: Agent not found
 
 ### Example
 
@@ -77,10 +139,10 @@ import {
 const configuration = new Configuration();
 const apiInstance = new AgentApi(configuration);
 
-let aid: string; //Agent ID (default to undefined)
+let agentId: string; //ID of the agent to retrieve (default to undefined)
 
-const { status, data } = await apiInstance.getAgentById(
-    aid
+const { status, data } = await apiInstance.getAgent(
+    agentId
 );
 ```
 
@@ -88,12 +150,12 @@ const { status, data } = await apiInstance.getAgentById(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **aid** | [**string**] | Agent ID | defaults to undefined|
+| **agentId** | [**string**] | ID of the agent to retrieve | defaults to undefined|
 
 
 ### Return type
 
-**AgentResponse**
+**any**
 
 ### Authorization
 
@@ -165,3 +227,337 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
+# **getAgents**
+> AgentListResponse getAgents()
+
+Get all agents with their quota information.  **Query Parameters:** * `sort` - Sort order for the agents list * `cursor` - Cursor for pagination * `limit` - Maximum number of agents to return (1-100)  **Returns:** * `AgentListResponse` - Paginated list of agents with their quota information and additional processed data
+
+### Example
+
+```typescript
+import {
+    AgentApi,
+    Configuration
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new AgentApi(configuration);
+
+let sort: AgentSortOption; //Sort order for agents list (optional) (default to undefined)
+let cursor: string; //Cursor for pagination (optional) (default to undefined)
+let limit: number; //Maximum number of agents to return (optional) (default to 20)
+
+const { status, data } = await apiInstance.getAgents(
+    sort,
+    cursor,
+    limit
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **sort** | **AgentSortOption** | Sort order for agents list | (optional) defaults to undefined|
+| **cursor** | [**string**] | Cursor for pagination | (optional) defaults to undefined|
+| **limit** | [**number**] | Maximum number of agents to return | (optional) defaults to 20|
+
+
+### Return type
+
+**AgentListResponse**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **importAgent**
+> string importAgent()
+
+Import agent configuration from YAML file. Only updates existing agents, will not create new ones.  **Path Parameters:** * `agent_id` - ID of the agent to update  **Request Body:** * `file` - YAML file containing agent configuration  **Returns:** * `str` - Success message  **Raises:** * `HTTPException`:     - 400: Invalid YAML or agent configuration     - 404: Agent not found     - 500: Server error
+
+### Example
+
+```typescript
+import {
+    AgentApi,
+    Configuration
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new AgentApi(configuration);
+
+let agentId: string; // (default to undefined)
+let file: File; //YAML file containing agent configuration (default to undefined)
+
+const { status, data } = await apiInstance.importAgent(
+    agentId,
+    file
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **agentId** | [**string**] |  | defaults to undefined|
+| **file** | [**File**] | YAML file containing agent configuration | defaults to undefined|
+
+
+### Return type
+
+**string**
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+ - **Content-Type**: multipart/form-data
+ - **Accept**: text/plain, application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **overrideAgent**
+> any overrideAgent()
+
+Override an existing agent.  Use input to override agent configuration. If some fields are not provided, they will be reset to default values.  **Path Parameters:** * `agent_id` - ID of the agent to update  **Request Body:** * `agent` - Agent update configuration  **Returns:** * `AgentResponse` - Updated agent configuration with additional processed data  **Raises:** * `HTTPException`:     - 400: Invalid agent ID format     - 404: Agent not found     - 403: Permission denied (if owner mismatch)     - 500: Database error
+
+### Example
+
+```typescript
+import {
+    AgentApi,
+    Configuration,
+    AgentUpdate
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new AgentApi(configuration);
+
+let agentId: string; //ID of the agent to update (default to undefined)
+let agentUpdate: AgentUpdate; // (optional)
+
+const { status, data } = await apiInstance.overrideAgent(
+    agentId,
+    agentUpdate
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **agentUpdate** | **AgentUpdate**|  | |
+| **agentId** | [**string**] | ID of the agent to update | defaults to undefined|
+
+
+### Return type
+
+**any**
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **updateAgent**
+> any updateAgent()
+
+Update an existing agent.  Use input to update agent configuration. If some fields are not provided, they will not be changed.  **Path Parameters:** * `agent_id` - ID of the agent to update  **Request Body:** * `agent` - Agent update configuration  **Returns:** * `AgentResponse` - Updated agent configuration with additional processed data  **Raises:** * `HTTPException`:     - 400: Invalid agent ID format     - 404: Agent not found     - 403: Permission denied (if owner mismatch)     - 500: Database error
+
+### Example
+
+```typescript
+import {
+    AgentApi,
+    Configuration,
+    AgentUpdate
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new AgentApi(configuration);
+
+let agentId: string; //ID of the agent to update (default to undefined)
+let agentUpdate: AgentUpdate; // (optional)
+
+const { status, data } = await apiInstance.updateAgent(
+    agentId,
+    agentUpdate
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **agentUpdate** | **AgentUpdate**|  | |
+| **agentId** | [**string**] | ID of the agent to update | defaults to undefined|
+
+
+### Return type
+
+**any**
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **validateAgentCreate**
+> validateAgentCreate()
+
+Validate agent configuration.  **Request Body:** * `agent` - Agent configuration  **Returns:** * `204 No Content` - Agent configuration is valid  **Raises:** * `HTTPException`:     - 400: Invalid agent configuration     - 422: Invalid agent configuration from intentkit core     - 500: Server error
+
+### Example
+
+```typescript
+import {
+    AgentApi,
+    Configuration,
+    AgentUpdate
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new AgentApi(configuration);
+
+let agentUpdate: AgentUpdate; // (optional)
+
+const { status, data } = await apiInstance.validateAgentCreate(
+    agentUpdate
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **agentUpdate** | **AgentUpdate**|  | |
+
+
+### Return type
+
+void (empty response body)
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**204** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **validateAgentUpdate**
+> validateAgentUpdate()
+
+Validate agent configuration.  **Request Body:** * `agent` - Agent configuration  **Returns:** * `204 No Content` - Agent configuration is valid  **Raises:** * `HTTPException`:     - 400: Invalid agent configuration     - 422: Invalid agent configuration from intentkit core     - 500: Server error
+
+### Example
+
+```typescript
+import {
+    AgentApi,
+    Configuration,
+    AgentUpdate
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new AgentApi(configuration);
+
+let agentId: string; //Agent ID (default to undefined)
+let agentUpdate: AgentUpdate; // (optional)
+
+const { status, data } = await apiInstance.validateAgentUpdate(
+    agentId,
+    agentUpdate
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **agentUpdate** | **AgentUpdate**|  | |
+| **agentId** | [**string**] | Agent ID | defaults to undefined|
+
+
+### Return type
+
+void (empty response body)
+
+### Authorization
+
+[HTTPBearer](../README.md#HTTPBearer)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**204** | Successful Response |  -  |
+|**422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+

package/docs/AgentListResponse.md

@@ -0,0 +1,25 @@
+# AgentListResponse
+
+Paginated response model for agents list.  Contains a list of agents, a flag indicating if more items are available, and a cursor for pagination.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**data** | [**Array<AgentResponse>**](AgentResponse.md) | List of agents | [default to undefined]
+**has_more** | **boolean** | Indicates if there are more items | [default to undefined]
+**next_cursor** | **string** |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AgentListResponse } from '@crestal/nation-sdk';
+
+const instance: AgentListResponse = {
+    data,
+    has_more,
+    next_cursor,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AgentSortOption.md

@@ -0,0 +1,13 @@
+# AgentSortOption
+
+Sort options for agents list.
+
+## Enum
+
+* `CreatedAtDesc` (value: `'created_at desc'`)
+
+* `CreatedAtAsc` (value: `'created_at asc'`)
+
+* `UpdatedAtDesc` (value: `'updated_at desc'`)
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/CreditEvent.md

@@ -13,6 +13,7 @@ Name | Type | Description | Notes
 **upstream_type** | [**UpstreamType**](UpstreamType.md) | Type of upstream transaction | [default to undefined]
 **upstream_tx_id** | **string** | Upstream transaction ID if any | [default to undefined]
 **agent_id** | **string** |  | [optional] [default to undefined]
+**agent_wallet_address** | **string** |  | [optional] [default to undefined]
 **start_message_id** | **string** |  | [optional] [default to undefined]
 **message_id** | **string** |  | [optional] [default to undefined]
 **model** | **string** |  | [optional] [default to undefined]
@@ -61,6 +62,7 @@ const instance: CreditEvent = {
     upstream_type,
     upstream_tx_id,
     agent_id,
+    agent_wallet_address,
     start_message_id,
     message_id,
     model,

package/docs/CreditEventWithAgent.md

@@ -13,6 +13,7 @@ Name | Type | Description | Notes
 **upstream_type** | [**UpstreamType**](UpstreamType.md) | Type of upstream transaction | [default to undefined]
 **upstream_tx_id** | **string** | Upstream transaction ID if any | [default to undefined]
 **agent_id** | **string** |  | [optional] [default to undefined]
+**agent_wallet_address** | **string** |  | [optional] [default to undefined]
 **start_message_id** | **string** |  | [optional] [default to undefined]
 **message_id** | **string** |  | [optional] [default to undefined]
 **model** | **string** |  | [optional] [default to undefined]
@@ -62,6 +63,7 @@ const instance: CreditEventWithAgent = {
     upstream_type,
     upstream_tx_id,
     agent_id,
+    agent_wallet_address,
     start_message_id,
     message_id,
     model,

package/docs/LLMModelInfoWithProviderName.md

@@ -27,8 +27,8 @@ Name | Type | Description | Notes
 **supports_presence_penalty** | **boolean** |  | [optional] [default to true]
 **api_base** | **string** |  | [optional] [default to undefined]
 **timeout** | **number** |  | [optional] [default to 180]
-**created_at** | **string** | Timestamp when this data was created | [optional] [default to 2025-07-15T02:38:33.048+00:00]
-**updated_at** | **string** | Timestamp when this data was updated | [optional] [default to 2025-07-15T02:38:33.048+00:00]
+**created_at** | **string** | Timestamp when this data was created | [optional] [default to 2025-07-17T08:51:32.738+00:00]
+**updated_at** | **string** | Timestamp when this data was updated | [optional] [default to 2025-07-17T08:51:32.738+00:00]
 **provider_name** | **string** |  | [default to undefined]
 
 ## Example

package/index.ts

@@ -4,7 +4,7 @@
  * Nation IntentKit API
  * API for Nation IntentKit services
  *
- * The version of the OpenAPI document: 0.1.19
+ * The version of the OpenAPI document: 0.1.21
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crestal/nation-sdk",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "OpenAPI client for @crestal/nation-sdk",
   "author": "OpenAPI-Generator Contributors",
   "repository": {