@crestal/nation-sdk 0.1.19

package/docs/EventType.md

@@ -0,0 +1,31 @@
+# EventType
+
+Type of credit event.
+
+## Enum
+
+* `Memory` (value: `'memory'`)
+
+* `Message` (value: `'message'`)
+
+* `SkillCall` (value: `'skill_call'`)
+
+* `Voice` (value: `'voice'`)
+
+* `KnowledgeBase` (value: `'knowledge_base'`)
+
+* `Recharge` (value: `'recharge'`)
+
+* `Refund` (value: `'refund'`)
+
+* `Adjustment` (value: `'adjustment'`)
+
+* `Refill` (value: `'refill'`)
+
+* `Reward` (value: `'reward'`)
+
+* `EventReward` (value: `'event_reward'`)
+
+* `RechargeBonus` (value: `'recharge_bonus'`)
+
+[[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/FeePercentage.md

@@ -0,0 +1,19 @@
+# FeePercentage
+
+Fee percentage of the agent
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+## Example
+
+```typescript
+import { FeePercentage } from '@crestal/nation-sdk';
+
+const instance: FeePercentage = {
+};
+```
+
+[[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/HTTPValidationError.md

@@ -0,0 +1,20 @@
+# HTTPValidationError
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**detail** | [**Array<ValidationError>**](ValidationError.md) |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { HTTPValidationError } from '@crestal/nation-sdk';
+
+const instance: HTTPValidationError = {
+    detail,
+};
+```
+
+[[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/HealthApi.md

@@ -0,0 +1,52 @@
+# HealthApi
+
+All URIs are relative to *http://localhost*
+
+|Method | HTTP request | Description|
+|------------- | ------------- | -------------|
+|[**healthCheckHealthGet**](#healthcheckhealthget) | **GET** /health | Health check endpoint|
+
+# **healthCheckHealthGet**
+> any healthCheckHealthGet()
+
+Returns the health status of the API server
+
+### Example
+
+```typescript
+import {
+    HealthApi,
+    Configuration
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new HealthApi(configuration);
+
+const { status, data } = await apiInstance.healthCheckHealthGet();
+```
+
+### Parameters
+This endpoint does not have any parameters.
+
+
+### Return type
+
+**any**
+
+### 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 |  -  |
+
+[[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/LLMModelInfoWithProviderName.md

@@ -0,0 +1,67 @@
+# LLMModelInfoWithProviderName
+
+LLM model information with provider display name.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **string** |  | [default to undefined]
+**name** | **string** |  | [default to undefined]
+**provider** | [**LLMProvider**](LLMProvider.md) |  | [default to undefined]
+**enabled** | **boolean** |  | [optional] [default to true]
+**input_price** | **string** |  | [default to undefined]
+**output_price** | **string** |  | [default to undefined]
+**price_level** | **number** |  | [optional] [default to undefined]
+**context_length** | **number** |  | [default to undefined]
+**output_length** | **number** |  | [default to undefined]
+**intelligence** | **number** |  | [default to undefined]
+**speed** | **number** |  | [default to undefined]
+**supports_image_input** | **boolean** |  | [optional] [default to false]
+**supports_skill_calls** | **boolean** |  | [optional] [default to false]
+**supports_structured_output** | **boolean** |  | [optional] [default to false]
+**has_reasoning** | **boolean** |  | [optional] [default to false]
+**supports_search** | **boolean** |  | [optional] [default to false]
+**supports_temperature** | **boolean** |  | [optional] [default to true]
+**supports_frequency_penalty** | **boolean** |  | [optional] [default to true]
+**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]
+**provider_name** | **string** |  | [default to undefined]
+
+## Example
+
+```typescript
+import { LLMModelInfoWithProviderName } from '@crestal/nation-sdk';
+
+const instance: LLMModelInfoWithProviderName = {
+    id,
+    name,
+    provider,
+    enabled,
+    input_price,
+    output_price,
+    price_level,
+    context_length,
+    output_length,
+    intelligence,
+    speed,
+    supports_image_input,
+    supports_skill_calls,
+    supports_structured_output,
+    has_reasoning,
+    supports_search,
+    supports_temperature,
+    supports_frequency_penalty,
+    supports_presence_penalty,
+    api_base,
+    timeout,
+    created_at,
+    updated_at,
+    provider_name,
+};
+```
+
+[[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/LLMProvider.md

@@ -0,0 +1,18 @@
+# LLMProvider
+
+
+## Enum
+
+* `Openai` (value: `'openai'`)
+
+* `Deepseek` (value: `'deepseek'`)
+
+* `Xai` (value: `'xai'`)
+
+* `Eternal` (value: `'eternal'`)
+
+* `Reigent` (value: `'reigent'`)
+
+* `Venice` (value: `'venice'`)
+
+[[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/MetadataApi.md

@@ -0,0 +1,258 @@
+# MetadataApi
+
+All URIs are relative to *http://localhost*
+
+|Method | HTTP request | Description|
+|------------- | ------------- | -------------|
+|[**getAgentSchema**](#getagentschema) | **GET** /metadata/agent/schema.json | Get agent schema|
+|[**getLlmsMetadataLlmsGet**](#getllmsmetadatallmsget) | **GET** /metadata/llms | Get all LLM models|
+|[**getSkillIcon**](#getskillicon) | **GET** /metadata/skills/{skill}/{icon_name}.{ext} | Get skill icon|
+|[**getSkillSchema**](#getskillschema) | **GET** /metadata/skills/{skill}/schema.json | Get skill schema|
+|[**getSkillsMetadataSkillsGet**](#getskillsmetadataskillsget) | **GET** /metadata/skills | Get all skills|
+
+# **getAgentSchema**
+> any getAgentSchema()
+
+Get the JSON schema for Agent model with all $ref references resolved
+
+### Example
+
+```typescript
+import {
+    MetadataApi,
+    Configuration
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new MetadataApi(configuration);
+
+const { status, data } = await apiInstance.getAgentSchema();
+```
+
+### Parameters
+This endpoint does not have any parameters.
+
+
+### Return type
+
+**any**
+
+### 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 |  -  |
+
+[[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)
+
+# **getLlmsMetadataLlmsGet**
+> Array<LLMModelInfoWithProviderName> getLlmsMetadataLlmsGet()
+
+Returns a list of all available LLM models in the system
+
+### Example
+
+```typescript
+import {
+    MetadataApi,
+    Configuration
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new MetadataApi(configuration);
+
+const { status, data } = await apiInstance.getLlmsMetadataLlmsGet();
+```
+
+### Parameters
+This endpoint does not have any parameters.
+
+
+### Return type
+
+**Array<LLMModelInfoWithProviderName>**
+
+### 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 |  -  |
+
+[[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)
+
+# **getSkillIcon**
+> any getSkillIcon()
+
+Get the icon for a specific skill
+
+### Example
+
+```typescript
+import {
+    MetadataApi,
+    Configuration
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new MetadataApi(configuration);
+
+let skill: string; //Skill name (default to undefined)
+let iconName: string; //Icon name (default to undefined)
+let ext: string; //Icon file extension (default to undefined)
+
+const { status, data } = await apiInstance.getSkillIcon(
+    skill,
+    iconName,
+    ext
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **skill** | [**string**] | Skill name | defaults to undefined|
+| **iconName** | [**string**] | Icon name | defaults to undefined|
+| **ext** | [**string**] | Icon file extension | defaults to undefined|
+
+
+### Return type
+
+**any**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Success |  -  |
+|**404** | Skill icon not found |  -  |
+|**400** | Invalid skill name or extension |  -  |
+|**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)
+
+# **getSkillSchema**
+> any getSkillSchema()
+
+Get the JSON schema for a specific skill
+
+### Example
+
+```typescript
+import {
+    MetadataApi,
+    Configuration
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new MetadataApi(configuration);
+
+let skill: string; //Skill name (default to undefined)
+
+const { status, data } = await apiInstance.getSkillSchema(
+    skill
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **skill** | [**string**] | Skill name | defaults to undefined|
+
+
+### Return type
+
+**any**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Success |  -  |
+|**404** | Skill not found |  -  |
+|**400** | Invalid skill name |  -  |
+|**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)
+
+# **getSkillsMetadataSkillsGet**
+> Array<Skill> getSkillsMetadataSkillsGet()
+
+Returns a list of all available skills in the system
+
+### Example
+
+```typescript
+import {
+    MetadataApi,
+    Configuration
+} from '@crestal/nation-sdk';
+
+const configuration = new Configuration();
+const apiInstance = new MetadataApi(configuration);
+
+const { status, data } = await apiInstance.getSkillsMetadataSkillsGet();
+```
+
+### Parameters
+This endpoint does not have any parameters.
+
+
+### Return type
+
+**Array<Skill>**
+
+### 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 |  -  |
+
+[[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/OwnerType.md

@@ -0,0 +1,13 @@
+# OwnerType
+
+Type of credit account owner.
+
+## Enum
+
+* `User` (value: `'user'`)
+
+* `Agent` (value: `'agent'`)
+
+* `Platform` (value: `'platform'`)
+
+[[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/Skill.md

@@ -0,0 +1,43 @@
+# Skill
+
+Pydantic model for Skill.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**name** | **string** | Name of the skill | [default to undefined]
+**enabled** | **boolean** | Is this skill enabled? | [default to undefined]
+**category** | **string** | Category of the skill | [default to undefined]
+**config_name** | **string** |  | [default to undefined]
+**price_level** | **number** |  | [default to undefined]
+**price** | **string** | Price for this skill | [optional] [default to '1']
+**price_self_key** | **string** | Price for this skill with self key | [optional] [default to '1']
+**rate_limit_count** | **number** |  | [default to undefined]
+**rate_limit_minutes** | **number** |  | [default to undefined]
+**author** | **string** |  | [default to undefined]
+**created_at** | **string** | Timestamp when this record was created | [default to undefined]
+**updated_at** | **string** | Timestamp when this record was last updated | [default to undefined]
+
+## Example
+
+```typescript
+import { Skill } from '@crestal/nation-sdk';
+
+const instance: Skill = {
+    name,
+    enabled,
+    category,
+    config_name,
+    price_level,
+    price,
+    price_self_key,
+    rate_limit_count,
+    rate_limit_minutes,
+    author,
+    created_at,
+    updated_at,
+};
+```
+
+[[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/TransactionType.md

@@ -0,0 +1,39 @@
+# TransactionType
+
+Type of credit transaction.
+
+## Enum
+
+* `Pay` (value: `'pay'`)
+
+* `ReceiveBaseLlm` (value: `'receive_base_llm'`)
+
+* `ReceiveBaseSkill` (value: `'receive_base_skill'`)
+
+* `ReceiveBaseMemory` (value: `'receive_base_memory'`)
+
+* `ReceiveBaseVoice` (value: `'receive_base_voice'`)
+
+* `ReceiveBaseKnowledge` (value: `'receive_base_knowledge'`)
+
+* `ReceiveFeeDev` (value: `'receive_fee_dev'`)
+
+* `ReceiveFeeAgent` (value: `'receive_fee_agent'`)
+
+* `ReceiveFeePlatform` (value: `'receive_fee_platform'`)
+
+* `Recharge` (value: `'recharge'`)
+
+* `Refund` (value: `'refund'`)
+
+* `Adjustment` (value: `'adjustment'`)
+
+* `Refill` (value: `'refill'`)
+
+* `Reward` (value: `'reward'`)
+
+* `EventReward` (value: `'event_reward'`)
+
+* `RechargeBonus` (value: `'recharge_bonus'`)
+
+[[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/UpstreamType.md

@@ -0,0 +1,15 @@
+# UpstreamType
+
+Type of upstream transaction.
+
+## Enum
+
+* `Api` (value: `'api'`)
+
+* `Scheduler` (value: `'scheduler'`)
+
+* `Executor` (value: `'executor'`)
+
+* `Initializer` (value: `'initializer'`)
+
+[[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/ValidationError.md

@@ -0,0 +1,24 @@
+# ValidationError
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**loc** | [**Array<ValidationErrorLocInner>**](ValidationErrorLocInner.md) |  | [default to undefined]
+**msg** | **string** |  | [default to undefined]
+**type** | **string** |  | [default to undefined]
+
+## Example
+
+```typescript
+import { ValidationError } from '@crestal/nation-sdk';
+
+const instance: ValidationError = {
+    loc,
+    msg,
+    type,
+};
+```
+
+[[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/ValidationErrorLocInner.md

@@ -0,0 +1,18 @@
+# ValidationErrorLocInner
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+## Example
+
+```typescript
+import { ValidationErrorLocInner } from '@crestal/nation-sdk';
+
+const instance: ValidationErrorLocInner = {
+};
+```
+
+[[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/git_push.sh

@@ -0,0 +1,57 @@
+#!/bin/sh
+# ref: https://help.github.com/articles/adding-an-existing-project-to-github-using-the-command-line/
+#
+# Usage example: /bin/sh ./git_push.sh wing328 openapi-petstore-perl "minor update" "gitlab.com"
+
+git_user_id=$1
+git_repo_id=$2
+release_note=$3
+git_host=$4
+
+if [ "$git_host" = "" ]; then
+    git_host="github.com"
+    echo "[INFO] No command line input provided. Set \$git_host to $git_host"
+fi
+
+if [ "$git_user_id" = "" ]; then
+    git_user_id="crestalnetwork"
+    echo "[INFO] No command line input provided. Set \$git_user_id to $git_user_id"
+fi
+
+if [ "$git_repo_id" = "" ]; then
+    git_repo_id="nation-intentkit"
+    echo "[INFO] No command line input provided. Set \$git_repo_id to $git_repo_id"
+fi
+
+if [ "$release_note" = "" ]; then
+    release_note="Minor update"
+    echo "[INFO] No command line input provided. Set \$release_note to $release_note"
+fi
+
+# Initialize the local directory as a Git repository
+git init
+
+# Adds the files in the local repository and stages them for commit.
+git add .
+
+# Commits the tracked changes and prepares them to be pushed to a remote repository.
+git commit -m "$release_note"
+
+# Sets the new remote
+git_remote=$(git remote)
+if [ "$git_remote" = "" ]; then # git remote not defined
+
+    if [ "$GIT_TOKEN" = "" ]; then
+        echo "[INFO] \$GIT_TOKEN (environment variable) is not set. Using the git credential in your environment."
+        git remote add origin https://${git_host}/${git_user_id}/${git_repo_id}.git
+    else
+        git remote add origin https://${git_user_id}:"${GIT_TOKEN}"@${git_host}/${git_user_id}/${git_repo_id}.git
+    fi
+
+fi
+
+git pull origin master
+
+# Pushes (Forces) the changes in the local repository up to the remote repository
+echo "Git pushing to https://${git_host}/${git_user_id}/${git_repo_id}.git"
+git push origin master 2>&1 | grep -v 'To https'