ruvbot 0.1.0

package/dist/esm/core/entities/Skill.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Skill entity - represents an executable skill/capability
+ */
+import { z } from 'zod';
+import type { SkillDefinition, SkillInput, SkillOutput, SkillContext, SkillResult, SkillExample } from '../types.js';
+export type SkillExecutor<TInput = unknown, TOutput = unknown> = (input: TInput, context: SkillContext) => Promise<SkillResult<TOutput>>;
+export interface SkillOptions<TInput = unknown, TOutput = unknown> {
+    definition: SkillDefinition;
+    executor: SkillExecutor<TInput, TOutput>;
+    inputSchema?: z.ZodSchema<TInput>;
+    outputSchema?: z.ZodSchema<TOutput>;
+}
+export declare class SkillEntity<TInput = unknown, TOutput = unknown> {
+    readonly definition: SkillDefinition;
+    private readonly executor;
+    private readonly inputSchema?;
+    private readonly outputSchema?;
+    constructor(options: SkillOptions<TInput, TOutput>);
+    /**
+     * Get skill name
+     */
+    get name(): string;
+    /**
+     * Get skill description
+     */
+    get description(): string;
+    /**
+     * Get skill version
+     */
+    get version(): string;
+    /**
+     * Get skill inputs
+     */
+    get inputs(): SkillInput[];
+    /**
+     * Get skill outputs
+     */
+    get outputs(): SkillOutput[];
+    /**
+     * Get skill examples
+     */
+    get examples(): SkillExample[];
+    /**
+     * Validate input against schema
+     */
+    validateInput(input: unknown): {
+        valid: boolean;
+        errors?: string[];
+    };
+    /**
+     * Validate output against schema
+     */
+    validateOutput(output: unknown): {
+        valid: boolean;
+        errors?: string[];
+    };
+    /**
+     * Execute the skill
+     */
+    execute(input: TInput, context: SkillContext): Promise<SkillResult<TOutput>>;
+    /**
+     * Generate tool definition for LLM
+     */
+    toLLMTool(): {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+    /**
+     * Serialize skill definition to JSON
+     */
+    toJSON(): SkillDefinition;
+    /**
+     * Create a simple skill from a function
+     */
+    static create<TInput, TOutput>(name: string, description: string, executor: SkillExecutor<TInput, TOutput>, options?: {
+        inputs?: SkillInput[];
+        outputs?: SkillOutput[];
+        inputSchema?: z.ZodSchema<TInput>;
+        outputSchema?: z.ZodSchema<TOutput>;
+    }): SkillEntity<TInput, TOutput>;
+}
+//# sourceMappingURL=Skill.d.ts.map

package/dist/esm/core/entities/Skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Skill.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/Skill.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,aAAa,CAAC;AAGrB,MAAM,MAAM,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CAC/D,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,KAClB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AAEnC,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC/D,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;CACrC;AAED,qBAAa,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC1D,SAAgB,UAAU,EAAE,eAAe,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAuB;gBAEzC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC;IAOlD;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,UAAU,EAAE,CAEzB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,WAAW,EAAE,CAE3B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,YAAY,EAAE,CAE7B;IAED;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;IAmBpE;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;IAmBtE;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IA8ClF;;OAEG;IACH,SAAS,IAAI;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC;IA0BD;;OAEG;IACH,MAAM,IAAI,eAAe;IAIzB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;QACtB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;QACxB,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAClC,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;KACrC,GACA,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC;CAchC"}

package/dist/esm/core/entities/Skill.js

@@ -0,0 +1,188 @@
+/**
+ * Skill entity - represents an executable skill/capability
+ */
+import { z } from 'zod';
+export class SkillEntity {
+    definition;
+    executor;
+    inputSchema;
+    outputSchema;
+    constructor(options) {
+        this.definition = options.definition;
+        this.executor = options.executor;
+        this.inputSchema = options.inputSchema;
+        this.outputSchema = options.outputSchema;
+    }
+    /**
+     * Get skill name
+     */
+    get name() {
+        return this.definition.name;
+    }
+    /**
+     * Get skill description
+     */
+    get description() {
+        return this.definition.description;
+    }
+    /**
+     * Get skill version
+     */
+    get version() {
+        return this.definition.version;
+    }
+    /**
+     * Get skill inputs
+     */
+    get inputs() {
+        return this.definition.inputs;
+    }
+    /**
+     * Get skill outputs
+     */
+    get outputs() {
+        return this.definition.outputs;
+    }
+    /**
+     * Get skill examples
+     */
+    get examples() {
+        return this.definition.examples ?? [];
+    }
+    /**
+     * Validate input against schema
+     */
+    validateInput(input) {
+        if (!this.inputSchema) {
+            return { valid: true };
+        }
+        try {
+            this.inputSchema.parse(input);
+            return { valid: true };
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                return {
+                    valid: false,
+                    errors: error.errors.map((e) => `${e.path.join('.')}: ${e.message}`),
+                };
+            }
+            throw error;
+        }
+    }
+    /**
+     * Validate output against schema
+     */
+    validateOutput(output) {
+        if (!this.outputSchema) {
+            return { valid: true };
+        }
+        try {
+            this.outputSchema.parse(output);
+            return { valid: true };
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                return {
+                    valid: false,
+                    errors: error.errors.map((e) => `${e.path.join('.')}: ${e.message}`),
+                };
+            }
+            throw error;
+        }
+    }
+    /**
+     * Execute the skill
+     */
+    async execute(input, context) {
+        const startTime = Date.now();
+        // Validate input
+        const inputValidation = this.validateInput(input);
+        if (!inputValidation.valid) {
+            return {
+                success: false,
+                error: `Input validation failed: ${inputValidation.errors?.join(', ')}`,
+                metadata: { latency: Date.now() - startTime },
+            };
+        }
+        try {
+            // Execute skill
+            const result = await this.executor(input, context);
+            // Validate output if successful
+            if (result.success && result.data) {
+                const outputValidation = this.validateOutput(result.data);
+                if (!outputValidation.valid) {
+                    return {
+                        success: false,
+                        error: `Output validation failed: ${outputValidation.errors?.join(', ')}`,
+                        metadata: { latency: Date.now() - startTime },
+                    };
+                }
+            }
+            return {
+                ...result,
+                metadata: {
+                    ...result.metadata,
+                    latency: Date.now() - startTime,
+                },
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                error: errorMessage,
+                metadata: { latency: Date.now() - startTime },
+            };
+        }
+    }
+    /**
+     * Generate tool definition for LLM
+     */
+    toLLMTool() {
+        const properties = {};
+        const required = [];
+        for (const input of this.definition.inputs) {
+            properties[input.name] = {
+                type: input.type,
+                description: input.description,
+            };
+            if (input.required) {
+                required.push(input.name);
+            }
+        }
+        return {
+            name: this.definition.name,
+            description: this.definition.description,
+            parameters: {
+                type: 'object',
+                properties,
+                required,
+            },
+        };
+    }
+    /**
+     * Serialize skill definition to JSON
+     */
+    toJSON() {
+        return this.definition;
+    }
+    /**
+     * Create a simple skill from a function
+     */
+    static create(name, description, executor, options) {
+        return new SkillEntity({
+            definition: {
+                name,
+                description,
+                version: '1.0.0',
+                inputs: options?.inputs ?? [],
+                outputs: options?.outputs ?? [],
+            },
+            executor,
+            inputSchema: options?.inputSchema,
+            outputSchema: options?.outputSchema,
+        });
+    }
+}
+//# sourceMappingURL=Skill.js.map

package/dist/esm/core/entities/Skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Skill.js","sourceRoot":"","sources":["../../../../src/core/entities/Skill.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB,MAAM,OAAO,WAAW;IACN,UAAU,CAAkB;IAC3B,QAAQ,CAAiC;IACzC,WAAW,CAAuB;IAClC,YAAY,CAAwB;IAErD,YAAY,OAAsC;QAChD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAc;QAC1B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAChC,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBACrE,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAe;QAC5B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAChC,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBACrE,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,OAAqB;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,iBAAiB;QACjB,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,4BAA4B,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;gBACvE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE;aAC9C,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,gBAAgB;YAChB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAEnD,gCAAgC;YAChC,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAClC,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC1D,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;oBAC5B,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,6BAA6B,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;wBACzE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE;qBAC9C,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,OAAO;gBACL,GAAG,MAAM;gBACT,QAAQ,EAAE;oBACR,GAAG,MAAM,CAAC,QAAQ;oBAClB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBAChC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,YAAY;gBACnB,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE;aAC9C,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QAKP,MAAM,UAAU,GAA4B,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAC3C,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;gBACvB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC;YAEF,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;YAC1B,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW;YACxC,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU;gBACV,QAAQ;aACT;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAY,EACZ,WAAmB,EACnB,QAAwC,EACxC,OAKC;QAED,OAAO,IAAI,WAAW,CAAC;YACrB,UAAU,EAAE;gBACV,IAAI;gBACJ,WAAW;gBACX,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,EAAE;gBAC7B,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE;aAChC;YACD,QAAQ;YACR,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,YAAY,EAAE,OAAO,EAAE,YAAY;SACpC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/esm/core/entities/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Core entity exports
+ */
+export * from './Agent.js';
+export * from './Session.js';
+export * from './Message.js';
+export * from './Skill.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/core/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/entities/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/esm/core/entities/index.js

@@ -0,0 +1,8 @@
+/**
+ * Core entity exports
+ */
+export * from './Agent.js';
+export * from './Session.js';
+export * from './Message.js';
+export * from './Skill.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/core/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/entities/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}