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

package/dist/models/entities/agents/agent.config.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentConfigSchema = exports.AgentConfigCoreSchema = exports.PREDEFINED_AVATARS = void 0;
+const zod_1 = require("zod");
+exports.PREDEFINED_AVATARS = {
+    Mimo: 'A lively 2D cartoon-style character with a square-shaped coral-pink body, bright round eyes, small energetic arms, and cute green ears. Radiates intelligence and confidence.',
+    Tamo: 'A vibrant 2D cartoon-style character with a sky-blue rounded body, wide curious eyes, energetic arms raised high, and playful yellow horns. Embodies bravery and enthusiasm.',
+    Zemo: 'A sleek, calm-looking 2D cartoon character with a deep-blue angular body, half-closed eyes suggesting skepticism, and small orange spikes on top. Portrays intelligence and analytical sharpness.',
+    Marimo: 'A gentle, soft-looking 2D cartoon character with a round lime-green body, large innocent eyes, raised curved arms, and a small blue sprout on top. Expresses innocence and curiosity.',
+    Casimo: 'An eccentric, quirky 2D cartoon character with a pinkish body, mischievous half-closed eyes, flexible arms in playful positions, and teal spikes on her head. Exudes unpredictability and whimsy.',
+};
+exports.AgentConfigCoreSchema = zod_1.z.object({
+    name: zod_1.z.union([
+        zod_1.z
+            .literal('evaluate_and_actions')
+            .describe('Evaluates conditions and context before taking actions. Best for thoughtful, context-aware responses that require analysis of the situation before acting.'),
+        zod_1.z
+            .literal('execute_actions')
+            .describe('Executes actions immediately without preliminary evaluation. Best for reactive agents that should respond quickly without extensive analysis.'),
+        zod_1.z
+            .literal('response_every_message')
+            .describe('Responds to every new message in the location. Best for conversational agents that should actively participate in all discussions.'),
+    ]),
+});
+const CharacterPropertySchema = zod_1.z.string().max(500).optional();
+const CharacterBackgroundSchema = zod_1.z
+    .object({
+    role: CharacterPropertySchema.describe("Agent's primary role or profession (e.g., 'professor', 'assistant', 'coach', 'mentor'). This shapes how they approach interactions and what expertise they offer."),
+    gender: CharacterPropertySchema.describe('Gender identity of the agent, which may influence their communication style and perspective.'),
+    expertise: CharacterPropertySchema.describe("Specific areas of knowledge or skills (e.g., 'machine learning', 'creative writing', 'financial planning'). Determines what topics the agent can provide authoritative guidance on."),
+    backstory: CharacterPropertySchema.describe('Personal history and experiences that shaped the agent. This background informs their worldview, reactions, and decision-making patterns.'),
+    birthDate: CharacterPropertySchema.describe('Birth date in YYYY-MM-DD format'),
+    occupation: CharacterPropertySchema.describe('Current or past occupation'),
+})
+    .catchall(CharacterPropertySchema)
+    .optional();
+const CharacterSpeechSchema = zod_1.z
+    .object({
+    tone: CharacterPropertySchema.describe("Overall emotional quality of communication (e.g., 'friendly', 'formal', 'enthusiastic', 'calm'). Affects how messages are perceived by others."),
+    style: CharacterPropertySchema.describe("Conversation approach and structure (e.g., 'concise', 'detailed', 'humorous', 'analytical'). Determines message length and information density."),
+    formality: CharacterPropertySchema.describe("Level of formal language usage (e.g., 'casual', 'professional', 'academic'). Affects vocabulary choice and sentence structure."),
+})
+    .catchall(CharacterPropertySchema)
+    .optional();
+const CharacterPersonalitySchema = zod_1.z
+    .object({
+    traits: CharacterPropertySchema.describe("Core personality characteristics (e.g., 'empathetic', 'analytical', 'creative', 'decisive'). These drive behavioral patterns and response tendencies."),
+    interests: CharacterPropertySchema.describe('Topics and activities the agent finds engaging or enjoys discussing. Influences conversation direction and enthusiasm levels.'),
+    values: CharacterPropertySchema.describe('Fundamental beliefs and principles that guide decision-making. Affects moral stances and advice given to others.'),
+    quirks: CharacterPropertySchema.describe('Unique habits, mannerisms, or characteristics that make the agent distinctive. Adds personality depth and memorability.'),
+    mbti: CharacterPropertySchema.describe("Myers-Briggs personality type (e.g., 'ENFP', 'INTJ'). Provides structured personality framework for consistent behavior patterns."),
+})
+    .catchall(CharacterPropertySchema)
+    .optional();
+const CharacterSchema = zod_1.z
+    .object({
+    background: CharacterBackgroundSchema,
+    speech: CharacterSpeechSchema,
+    personality: CharacterPersonalitySchema,
+})
+    .catchall(zod_1.z.union([
+    CharacterPropertySchema,
+    zod_1.z.object({}).catchall(CharacterPropertySchema),
+]))
+    .optional();
+const LlmPresetSchema = zod_1.z.union([
+    zod_1.z.literal('gemini-low').describe('Gemini - Low cost'),
+    zod_1.z.literal('gemini-medium').describe('Gemini - Balanced'),
+    zod_1.z.literal('gemini-high').describe('Gemini - High performance'),
+    zod_1.z.literal('openai-low').describe('OpenAI - Low cost'),
+    zod_1.z.literal('openai-medium').describe('OpenAI - Balanced'),
+    zod_1.z.literal('anthropic-low').describe('Anthropic - Low cost'),
+    zod_1.z.literal('anthropic-medium').describe('Anthropic - Balanced'),
+    zod_1.z.literal('anthropic-high').describe('Anthropic - High performance'),
+    zod_1.z.literal('deepseek-low').describe('DeepSeek - Low cost'),
+    zod_1.z.literal('deepseek-medium').describe('DeepSeek - Balanced'),
+]);
+exports.AgentConfigSchema = zod_1.z.object({
+    name: zod_1.z.string().max(64).describe('Agent name'),
+    avatar: zod_1.z
+        .union([
+        ...Object.entries(exports.PREDEFINED_AVATARS).map(([key, description]) => zod_1.z.literal(key).describe(description)),
+        zod_1.z
+            .string()
+            .max(2048)
+            .describe('Custom avatar identifier or URL (system use only)'),
+    ])
+        .describe('Visual representation identifier for the agent. Supports predefined avatar options or custom identifiers/URLs for system use. When a predefined avatar is selected, the appearance field will automatically update to match the avatar description.'),
+    appearance: zod_1.z
+        .string()
+        .max(500)
+        .describe("Internal character description used by the agent for role-playing and behavioral consistency. This field is automatically updated when avatar changes to a predefined option, but can also be manually edited independently. Helps the agent understand and embody its character during interactions, influencing communication style, decision-making patterns, and personality expression. Primarily for agent's internal reference rather than user display."),
+    core: exports.AgentConfigCoreSchema.describe('Fundamental behavior pattern that determines how the agent decides when to take actions'),
+    llmPreset: LlmPresetSchema.describe('AI model selection that balances cost, performance, and capabilities. Higher tiers provide better reasoning but cost more per interaction.'),
+    languages: zod_1.z
+        .array(zod_1.z.string())
+        .max(4)
+        .describe('Communication language settings for the agent (max 4). Examples: ["English"] = English only, ["ALL", "English"] = English-based but can adapt to other languages, ["Spanish", "French"] = specific languages only.'),
+    timeZone: zod_1.z
+        .string()
+        .max(32)
+        .describe('Agent timezone for time-based operations (e.g., "America/New_York")'),
+    greeting: zod_1.z
+        .string()
+        .max(500)
+        .describe("Initial message the agent sends when first interacting or joining a location. Should reflect the agent's character and set expectations for interaction style."),
+    actions: zod_1.z
+        .array(zod_1.z.union([
+        zod_1.z
+            .literal('explore_web')
+            .describe('Enables web exploration of the currently active browser tab when Chrome extension is activated. Allows the agent to navigate, interact with, and extract information from web pages.'),
+        zod_1.z
+            .literal('todo')
+            .describe('Placeholder for future action capabilities - to be implemented'),
+    ]))
+        .max(4)
+        .describe("Additional capabilities the agent can perform beyond basic conversation. Each action expands the agent's toolkit for specific use cases."),
+    character: CharacterSchema.describe('Comprehensive personality and background configuration that shapes how the agent behaves, communicates, and makes decisions. This creates consistency and authenticity in interactions.'),
+    rules: zod_1.z
+        .array(zod_1.z.string().max(200))
+        .max(20)
+        .describe('Custom behavioral constraints and guidelines specific to this agent (max 20 rules, 200 chars each). These override default behaviors and enforce specific interaction patterns.'),
+});
+//# sourceMappingURL=agent.config.js.map

package/dist/models/entities/agents/agent.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.config.js","sourceRoot":"","sources":["../../../../src/models/entities/agents/agent.config.ts"],"names":[],"mappings":"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"}

package/dist/models/entities/agents/agent.constants.d.ts

@@ -0,0 +1,4 @@
+export declare const AgentHelperType: {
+    readonly SAMO: "SAMO";
+};
+export type AgentHelperType = (typeof AgentHelperType)[keyof typeof AgentHelperType];

package/dist/models/entities/agents/agent.constants.js

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

package/dist/models/entities/agents/agent.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.constants.js","sourceRoot":"","sources":["../../../../src/models/entities/agents/agent.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM;CACJ,CAAC"}

package/dist/models/entities/agents/index.d.ts

@@ -0,0 +1,2 @@
+export * from './agent.config';
+export * from './agent.constants';

package/dist/models/entities/agents/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./agent.config"), exports);
+__exportStar(require("./agent.constants"), exports);
+//# sourceMappingURL=index.js.map

package/dist/models/entities/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/models/entities/agents/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,oDAAkC"}

package/dist/models/entities/index.d.ts

@@ -0,0 +1 @@
+export * from './agents';

package/dist/models/entities/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./agents"), exports);
+//# sourceMappingURL=index.js.map

package/dist/models/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/entities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB"}

package/dist/models/index.d.ts

@@ -0,0 +1,2 @@
+export * from './entities';
+export * from './locations';

package/dist/models/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./entities"), exports);
+__exportStar(require("./locations"), exports);
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B"}

package/dist/models/locations/index.d.ts

@@ -0,0 +1,2 @@
+export * from './location.config';
+export * from './location.constants';

package/dist/models/locations/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./location.config"), exports);
+__exportStar(require("./location.constants"), exports);
+//# sourceMappingURL=index.js.map

package/dist/models/locations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/locations/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,uDAAqC"}

package/dist/models/locations/location.config.d.ts

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+export declare const LocationEnvironmentSchema: z.ZodUnion<[z.ZodLiteral<"CHAT">, z.ZodLiteral<"WEB_BROWSER">]>;
+export declare const LocationConfigCoreSchema: z.ZodObject<{
+    name: z.ZodUnion<[z.ZodLiteral<"round_robin">, z.ZodLiteral<"update_forever">, z.ZodLiteral<"update_once">]>;
+    sequential: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: "round_robin" | "update_forever" | "update_once";
+    sequential?: boolean | undefined;
+}, {
+    name: "round_robin" | "update_forever" | "update_once";
+    sequential?: boolean | undefined;
+}>;
+export type LocationConfigCore = z.infer<typeof LocationConfigCoreSchema>;
+export declare const LocationConfigCanvasSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    maxLength: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    maxLength: number;
+}, {
+    name: string;
+    description: string;
+    maxLength: number;
+}>;
+export declare const LocationConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    thumbnail: z.ZodOptional<z.ZodString>;
+    environment: z.ZodUnion<[z.ZodLiteral<"CHAT">, z.ZodLiteral<"WEB_BROWSER">]>;
+    core: z.ZodObject<{
+        name: z.ZodUnion<[z.ZodLiteral<"round_robin">, z.ZodLiteral<"update_forever">, z.ZodLiteral<"update_once">]>;
+        sequential: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: "round_robin" | "update_forever" | "update_once";
+        sequential?: boolean | undefined;
+    }, {
+        name: "round_robin" | "update_forever" | "update_once";
+        sequential?: boolean | undefined;
+    }>;
+    description: z.ZodString;
+    rules: z.ZodArray<z.ZodString, "many">;
+    canvases: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        maxLength: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        maxLength: number;
+    }, {
+        name: string;
+        description: string;
+        maxLength: number;
+    }>, "many">;
+    agentCanvases: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        maxLength: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        maxLength: number;
+    }, {
+        name: string;
+        description: string;
+        maxLength: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    core: {
+        name: "round_robin" | "update_forever" | "update_once";
+        sequential?: boolean | undefined;
+    };
+    rules: string[];
+    environment: "CHAT" | "WEB_BROWSER";
+    canvases: {
+        name: string;
+        description: string;
+        maxLength: number;
+    }[];
+    agentCanvases: {
+        name: string;
+        description: string;
+        maxLength: number;
+    }[];
+    thumbnail?: string | undefined;
+}, {
+    name: string;
+    description: string;
+    core: {
+        name: "round_robin" | "update_forever" | "update_once";
+        sequential?: boolean | undefined;
+    };
+    rules: string[];
+    environment: "CHAT" | "WEB_BROWSER";
+    canvases: {
+        name: string;
+        description: string;
+        maxLength: number;
+    }[];
+    agentCanvases: {
+        name: string;
+        description: string;
+        maxLength: number;
+    }[];
+    thumbnail?: string | undefined;
+}>;
+export type LocationConfig = z.infer<typeof LocationConfigSchema>;
+export declare const DEFAULT_LOCATION_CONFIG: LocationConfig;

package/dist/models/locations/location.config.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LOCATION_CONFIG = exports.LocationConfigSchema = exports.LocationConfigCanvasSchema = exports.LocationConfigCoreSchema = exports.LocationEnvironmentSchema = void 0;
+const zod_1 = require("zod");
+const location_constants_1 = require("./location.constants");
+exports.LocationEnvironmentSchema = zod_1.z.union([
+    zod_1.z
+        .literal(location_constants_1.LocationEnvironment.CHAT)
+        .describe('Standard conversational environment for general agent interactions'),
+    zod_1.z
+        .literal(location_constants_1.LocationEnvironment.WEB_BROWSER)
+        .describe('Web browser environment that provides web browser content to agents'),
+]);
+exports.LocationConfigCoreSchema = zod_1.z.object({
+    name: zod_1.z.union([
+        zod_1.z.literal('round_robin').describe('Execute agents in rotating order'),
+        zod_1.z
+            .literal('update_forever')
+            .describe('Continuously update agents without stopping'),
+        zod_1.z.literal('update_once').describe('Execute agents only once per cycle'),
+    ]),
+    sequential: zod_1.z.boolean().optional().describe('Execute agents in fixed order'),
+});
+exports.LocationConfigCanvasSchema = zod_1.z.object({
+    name: zod_1.z
+        .string()
+        .max(16)
+        .regex(/^[a-zA-Z_]+$/, 'Name must contain only letters and underscores'),
+    description: zod_1.z.string().max(500),
+    maxLength: zod_1.z.number().min(100).max(1000),
+});
+exports.LocationConfigSchema = zod_1.z.object({
+    name: zod_1.z.string().max(64).describe('Location name'),
+    thumbnail: zod_1.z
+        .string()
+        .max(2048)
+        .optional()
+        .describe('Location thumbnail URL that can only be modified by the system'),
+    environment: exports.LocationEnvironmentSchema.describe('Location environment that determines the context and behavior'),
+    core: exports.LocationConfigCoreSchema.describe('Core behavior configuration that determines how agents are executed in this location'),
+    description: zod_1.z
+        .string()
+        .max(500)
+        .describe('Description of the location that provides context to agents about where they are'),
+    rules: zod_1.z
+        .array(zod_1.z.string().max(200))
+        .max(20)
+        .describe('Location-specific rules that agents must follow in addition to their core rules'),
+    canvases: zod_1.z
+        .array(exports.LocationConfigCanvasSchema)
+        .max(4)
+        .describe('Shared canvases that all entities in the location can access and collaborate on'),
+    agentCanvases: zod_1.z
+        .array(exports.LocationConfigCanvasSchema)
+        .max(4)
+        .describe('Private agent canvases for individual agent use, separate per location context'),
+});
+exports.DEFAULT_LOCATION_CONFIG = {
+    name: 'Empty Location',
+    environment: location_constants_1.LocationEnvironment.CHAT,
+    core: {
+        name: 'round_robin',
+    },
+    description: '',
+    rules: [],
+    canvases: [],
+    agentCanvases: [
+        {
+            name: 'plan',
+            description: 'Your private workspace for strategic thinking and task management. **Use this canvas CONSISTENTLY for any task requiring multiple steps, long-term tracking, or persistent information.** Break down complex goals into actionable steps (Plan-Do-Check-Act cycle recommended: 1. Outline steps, 2. Execute first step(s), 3. Check progress/results, 4. Adjust plan). Draft sequences of actions, list required resources, track progress, and refine strategies here before using tools. Keep it updated and organized to ensure effective execution.',
+            maxLength: 1000,
+        },
+    ],
+};
+//# sourceMappingURL=location.config.js.map

package/dist/models/locations/location.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.config.js","sourceRoot":"","sources":["../../../src/models/locations/location.config.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,6DAA2D;AAE9C,QAAA,yBAAyB,GAAG,OAAC,CAAC,KAAK,CAAC;IAC/C,OAAC;SACE,OAAO,CAAC,wCAAmB,CAAC,IAAI,CAAC;SACjC,QAAQ,CACP,oEAAoE,CACrE;IACH,OAAC;SACE,OAAO,CAAC,wCAAmB,CAAC,WAAW,CAAC;SACxC,QAAQ,CACP,qEAAqE,CACtE;CACJ,CAAC,CAAC;AAEU,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC;QACZ,OAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACrE,OAAC;aACE,OAAO,CAAC,gBAAgB,CAAC;aACzB,QAAQ,CAAC,6CAA6C,CAAC;QAC1D,OAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;KACxE,CAAC;IACF,UAAU,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CAC7E,CAAC,CAAC;AAIU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,OAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,KAAK,CAAC,cAAc,EAAE,gDAAgD,CAAC;IAC1E,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;CACzC,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;IAClD,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAE7E,WAAW,EAAE,iCAAyB,CAAC,QAAQ,CAC7C,+DAA+D,CAChE;IAED,IAAI,EAAE,gCAAwB,CAAC,QAAQ,CACrC,sFAAsF,CACvF;IACD,WAAW,EAAE,OAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,kFAAkF,CACnF;IAEH,KAAK,EAAE,OAAC;SACL,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SAC1B,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CACP,iFAAiF,CAClF;IAEH,QAAQ,EAAE,OAAC;SACR,KAAK,CAAC,kCAA0B,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,iFAAiF,CAClF;IACH,aAAa,EAAE,OAAC;SACb,KAAK,CAAC,kCAA0B,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,gFAAgF,CACjF;CACJ,CAAC,CAAC;AAIU,QAAA,uBAAuB,GAAmB;IACrD,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,wCAAmB,CAAC,IAAI;IAErC,IAAI,EAAE;QACJ,IAAI,EAAE,aAAa;KACpB;IACD,WAAW,EAAE,EAAE;IAEf,KAAK,EAAE,EAAE;IAET,QAAQ,EAAE,EAAE;IACZ,aAAa,EAAE;QACb;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,yhBAAyhB;YAC3hB,SAAS,EAAE,IAAI;SAChB;KACF;CACF,CAAC"}

package/dist/models/locations/location.constants.d.ts

@@ -0,0 +1,8 @@
+export declare const LocationEnvironment: {
+    readonly CHAT: "CHAT";
+    readonly AGENT_HELPER: "AGENT_HELPER";
+    readonly LOCATION_HELPER: "LOCATION_HELPER";
+    readonly WEB_BROWSER: "WEB_BROWSER";
+    readonly VIDEO_GAME: "VIDEO_GAME";
+};
+export type LocationEnvironment = (typeof LocationEnvironment)[keyof typeof LocationEnvironment];

package/dist/models/locations/location.constants.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocationEnvironment = void 0;
+exports.LocationEnvironment = {
+    CHAT: 'CHAT',
+    AGENT_HELPER: 'AGENT_HELPER',
+    LOCATION_HELPER: 'LOCATION_HELPER',
+    WEB_BROWSER: 'WEB_BROWSER',
+    VIDEO_GAME: 'VIDEO_GAME',
+};
+//# sourceMappingURL=location.constants.js.map

package/dist/models/locations/location.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.constants.js","sourceRoot":"","sources":["../../../src/models/locations/location.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,mBAAmB,GAAG;IACjC,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;CAChB,CAAC"}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@little-samo/samo-ai-sdk",
+  "version": "0.1.0-rv1",
+  "description": "SamoAI SDK",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/little-samo/SamoAI-SDK.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "packageManager": "yarn@4.6.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./dto": {
+      "types": "./dist/dto/index.d.ts",
+      "default": "./dist/dto/index.js"
+    },
+    "./models": {
+      "types": "./dist/models/index.d.ts",
+      "default": "./dist/models/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/index.d.ts"
+      ],
+      "dto": [
+        "./dist/dto/index.d.ts"
+      ],
+      "models": [
+        "./dist/models/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "lint": "eslint --fix",
+    "deps:check": "ts-node detect-cycles.ts",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
+    "test:cov": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage",
+    "test:debug": "node --experimental-vm-modules --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/jest/bin/jest.js --runInBand",
+    "test:e2e": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config ./test/jest-e2e.json"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.1.0",
+    "@eslint/js": "^9.13.0",
+    "@little-samo/samo-ai": "^0.1.0",
+    "@types/lodash": "^4",
+    "@types/node": "^20.3.1",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-prettier": "^5.0.0",
+    "eslint-plugin-unused-imports": "^4.1.4",
+    "globals": "^15.11.0",
+    "prettier": "^3.0.0",
+    "source-map-support": "^0.5.21",
+    "ts-loader": "^9.4.3",
+    "ts-morph": "^25.0.1",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.7.2",
+    "zod": "^3.24.1"
+  },
+  "peerDependencies": {
+    "@little-samo/samo-ai": "^0.1.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
+    "zod": "^3.24.1"
+  }
+}