@little-samo/samo-ai-sdk 0.1.0-rv1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Little Samo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+<div align="center">
+  <img src="https://media.githubusercontent.com/media/little-samo/CI/master/assets/characters/samo/profile.png" alt="Little Samo Mascot" width="250" />
+  <h1>SamoAI SDK</h1>
+  <p><em>TypeScript SDK for <a href="https://github.com/little-samo/SamoAI">@little-samo/samo-ai</a> with comprehensive DTOs and configuration models</em></p>
+</div>
+
+<p align="center">
+  <a href="#features">Features</a> •
+  <a href="#installation">Installation</a> •
+  <a href="#learn-more">Learn More</a> •
+  <a href="#license">License</a>
+</p>
+
+## Features
+
+- **Type-safe DTOs** for all SamoAI entities (Agents, Users, Locations, Items)
+- **Zod validation schemas** for runtime type checking
+- **Configuration models** with comprehensive validation
+- **Event system** for real-time updates
+- **Request/Response types** for API interactions
+- **Full TypeScript support** with strict type checking
+
+## Installation
+
+Install the package using npm:
+
+```bash
+npm install @little-samo/samo-ai-sdk
+```
+
+Or using yarn:
+
+```bash
+yarn add @little-samo/samo-ai-sdk
+```
+
+## Learn More
+
+- [SamoAI Core Library](https://github.com/little-samo/SamoAI) - The main SamoAI framework
+- [SamoAI Example CLI](https://github.com/little-samo/SamoAI-Example-CLI) - Example implementation
+
+## License
+
+[MIT License](LICENSE)
+
+---
+
+<div align="center">
+  <p>Made with ❤️ by the SamoAI Team</p>
+</div>

package/dist/dto/entities/agents/agent.d.ts

@@ -0,0 +1,13 @@
+import { AgentId, UserId } from '@little-samo/samo-ai';
+import { AgentConfig } from '@little-samo/samo-ai-sdk/models';
+import { EntityDto } from '../entity';
+export interface AgentDto extends EntityDto {
+    id: AgentId;
+}
+export interface AgentPrivateDto {
+    id: AgentId;
+    name: string;
+    username: string | null;
+    ownerUserId: UserId;
+    config: AgentConfig;
+}

package/dist/dto/entities/agents/agent.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agent.js.map

package/dist/dto/entities/agents/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../src/dto/entities/agents/agent.ts"],"names":[],"mappings":""}

package/dist/dto/entities/agents/agent.preset.d.ts

@@ -0,0 +1,10 @@
+import { AgentConfig } from '@little-samo/samo-ai-sdk/models';
+export interface AgentPresetDto {
+    id: bigint;
+    presetName: string;
+    presetShortDescription: string;
+    presetDescription: string;
+    config: AgentConfig;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/dist/dto/entities/agents/agent.preset.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agent.preset.js.map

package/dist/dto/entities/agents/agent.preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.preset.js","sourceRoot":"","sources":["../../../../src/dto/entities/agents/agent.preset.ts"],"names":[],"mappings":""}

package/dist/dto/entities/agents/agent.requests.d.ts

@@ -0,0 +1,537 @@
+import { z } from 'zod';
+import { AgentPrivateDto } from './agent';
+import { AgentPresetDto } from './agent.preset';
+export declare const AgentsPaginationQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    limit: number;
+}, {
+    page?: number | undefined;
+    limit?: number | undefined;
+}>;
+export type AgentsPaginationQueryDto = z.infer<typeof AgentsPaginationQuerySchema>;
+export interface AgentsPaginatedResponseDto {
+    data: AgentPrivateDto[];
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+export declare const AgentUpdateConfigSchema: z.ZodObject<{
+    agentId: z.ZodBigInt;
+    config: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        avatar: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<string>, z.ZodLiteral<string>, ...z.ZodLiteral<string>[], z.ZodString]>>;
+        appearance: z.ZodOptional<z.ZodString>;
+        core: z.ZodOptional<z.ZodObject<{
+            name: z.ZodUnion<[z.ZodLiteral<"evaluate_and_actions">, z.ZodLiteral<"execute_actions">, z.ZodLiteral<"response_every_message">]>;
+        }, "strip", z.ZodTypeAny, {
+            name: "evaluate_and_actions" | "execute_actions" | "response_every_message";
+        }, {
+            name: "evaluate_and_actions" | "execute_actions" | "response_every_message";
+        }>>;
+        llmPreset: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"gemini-low">, z.ZodLiteral<"gemini-medium">, z.ZodLiteral<"gemini-high">, z.ZodLiteral<"openai-low">, z.ZodLiteral<"openai-medium">, z.ZodLiteral<"anthropic-low">, z.ZodLiteral<"anthropic-medium">, z.ZodLiteral<"anthropic-high">, z.ZodLiteral<"deepseek-low">, z.ZodLiteral<"deepseek-medium">]>>;
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        greeting: z.ZodOptional<z.ZodString>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodLiteral<"explore_web">, z.ZodLiteral<"todo">]>, "many">>;
+        character: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            background: z.ZodOptional<z.ZodObject<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            speech: z.ZodOptional<z.ZodObject<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            personality: z.ZodOptional<z.ZodObject<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+        }, "strip", z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodObject<{}, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{}, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{}, z.ZodOptional<z.ZodString>, "strip">>]>, z.objectOutputType<{
+            background: z.ZodOptional<z.ZodObject<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            speech: z.ZodOptional<z.ZodObject<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            personality: z.ZodOptional<z.ZodObject<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+        }, z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodObject<{}, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{}, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{}, z.ZodOptional<z.ZodString>, "strip">>]>, "strip">, z.objectInputType<{
+            background: z.ZodOptional<z.ZodObject<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            speech: z.ZodOptional<z.ZodObject<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            personality: z.ZodOptional<z.ZodObject<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+        }, z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodObject<{}, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{}, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{}, z.ZodOptional<z.ZodString>, "strip">>]>, "strip">>>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        avatar?: string | undefined;
+        appearance?: string | undefined;
+        core?: {
+            name: "evaluate_and_actions" | "execute_actions" | "response_every_message";
+        } | undefined;
+        llmPreset?: "gemini-low" | "gemini-medium" | "gemini-high" | "openai-low" | "openai-medium" | "anthropic-low" | "anthropic-medium" | "anthropic-high" | "deepseek-low" | "deepseek-medium" | undefined;
+        languages?: string[] | undefined;
+        timeZone?: string | undefined;
+        greeting?: string | undefined;
+        actions?: ("explore_web" | "todo")[] | undefined;
+        character?: z.objectOutputType<{
+            background: z.ZodOptional<z.ZodObject<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            speech: z.ZodOptional<z.ZodObject<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            personality: z.ZodOptional<z.ZodObject<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+        }, z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodObject<{}, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{}, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{}, z.ZodOptional<z.ZodString>, "strip">>]>, "strip"> | undefined;
+        rules?: string[] | undefined;
+    }, {
+        name?: string | undefined;
+        avatar?: string | undefined;
+        appearance?: string | undefined;
+        core?: {
+            name: "evaluate_and_actions" | "execute_actions" | "response_every_message";
+        } | undefined;
+        llmPreset?: "gemini-low" | "gemini-medium" | "gemini-high" | "openai-low" | "openai-medium" | "anthropic-low" | "anthropic-medium" | "anthropic-high" | "deepseek-low" | "deepseek-medium" | undefined;
+        languages?: string[] | undefined;
+        timeZone?: string | undefined;
+        greeting?: string | undefined;
+        actions?: ("explore_web" | "todo")[] | undefined;
+        character?: z.objectInputType<{
+            background: z.ZodOptional<z.ZodObject<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            speech: z.ZodOptional<z.ZodObject<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            personality: z.ZodOptional<z.ZodObject<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+        }, z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodObject<{}, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{}, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{}, z.ZodOptional<z.ZodString>, "strip">>]>, "strip"> | undefined;
+        rules?: string[] | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    agentId: bigint;
+    config: {
+        name?: string | undefined;
+        avatar?: string | undefined;
+        appearance?: string | undefined;
+        core?: {
+            name: "evaluate_and_actions" | "execute_actions" | "response_every_message";
+        } | undefined;
+        llmPreset?: "gemini-low" | "gemini-medium" | "gemini-high" | "openai-low" | "openai-medium" | "anthropic-low" | "anthropic-medium" | "anthropic-high" | "deepseek-low" | "deepseek-medium" | undefined;
+        languages?: string[] | undefined;
+        timeZone?: string | undefined;
+        greeting?: string | undefined;
+        actions?: ("explore_web" | "todo")[] | undefined;
+        character?: z.objectOutputType<{
+            background: z.ZodOptional<z.ZodObject<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            speech: z.ZodOptional<z.ZodObject<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            personality: z.ZodOptional<z.ZodObject<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+        }, z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodObject<{}, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{}, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{}, z.ZodOptional<z.ZodString>, "strip">>]>, "strip"> | undefined;
+        rules?: string[] | undefined;
+    };
+}, {
+    agentId: bigint;
+    config: {
+        name?: string | undefined;
+        avatar?: string | undefined;
+        appearance?: string | undefined;
+        core?: {
+            name: "evaluate_and_actions" | "execute_actions" | "response_every_message";
+        } | undefined;
+        llmPreset?: "gemini-low" | "gemini-medium" | "gemini-high" | "openai-low" | "openai-medium" | "anthropic-low" | "anthropic-medium" | "anthropic-high" | "deepseek-low" | "deepseek-medium" | undefined;
+        languages?: string[] | undefined;
+        timeZone?: string | undefined;
+        greeting?: string | undefined;
+        actions?: ("explore_web" | "todo")[] | undefined;
+        character?: z.objectInputType<{
+            background: z.ZodOptional<z.ZodObject<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                role: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                expertise: z.ZodOptional<z.ZodString>;
+                backstory: z.ZodOptional<z.ZodString>;
+                birthDate: z.ZodOptional<z.ZodString>;
+                occupation: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            speech: z.ZodOptional<z.ZodObject<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                tone: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodString>;
+                formality: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+            personality: z.ZodOptional<z.ZodObject<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{
+                traits: z.ZodOptional<z.ZodString>;
+                interests: z.ZodOptional<z.ZodString>;
+                values: z.ZodOptional<z.ZodString>;
+                quirks: z.ZodOptional<z.ZodString>;
+                mbti: z.ZodOptional<z.ZodString>;
+            }, z.ZodOptional<z.ZodString>, "strip">>>;
+        }, z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodObject<{}, "strip", z.ZodOptional<z.ZodString>, z.objectOutputType<{}, z.ZodOptional<z.ZodString>, "strip">, z.objectInputType<{}, z.ZodOptional<z.ZodString>, "strip">>]>, "strip"> | undefined;
+        rules?: string[] | undefined;
+    };
+}>;
+export type AgentUpdateConfigDto = z.infer<typeof AgentUpdateConfigSchema>;
+export declare const AgentPresetsPaginationQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    limit: number;
+}, {
+    page?: number | undefined;
+    limit?: number | undefined;
+}>;
+export type AgentPresetsPaginationQueryDto = z.infer<typeof AgentPresetsPaginationQuerySchema>;
+export interface AgentPresetsPaginatedResponseDto {
+    data: AgentPresetDto[];
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+export declare const CreateAgentFromPresetSchema: z.ZodObject<{
+    presetId: z.ZodBigInt;
+}, "strip", z.ZodTypeAny, {
+    presetId: bigint;
+}, {
+    presetId: bigint;
+}>;
+export type CreateAgentFromPresetDto = z.infer<typeof CreateAgentFromPresetSchema>;
+export interface CreateAgentFromPresetResponseDto {
+    agent: AgentPrivateDto;
+}
+export declare const GetHelperAgentSchema: z.ZodObject<{
+    helperType: z.ZodNativeEnum<{
+        readonly SAMO: "SAMO";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    helperType: "SAMO";
+}, {
+    helperType: "SAMO";
+}>;
+export type GetHelperAgentDto = z.infer<typeof GetHelperAgentSchema>;
+export interface GetHelperAgentResponseDto {
+    agent: AgentPrivateDto;
+}