signalwire-agents 0.1.0

package/dist/skills/SkillManager.d.ts

@@ -0,0 +1,83 @@
+/**
+ * SkillManager - Manages skill lifecycle for an agent.
+ *
+ * Handles loading, unloading, validation, and injection of
+ * skill tools, hints, global data, and prompt sections.
+ */
+import { SkillBase } from './SkillBase.js';
+/**
+ * Manages the lifecycle of skills attached to an agent.
+ *
+ * Handles loading, unloading, validation, and aggregation of skill tools,
+ * hints, global data, and prompt sections.
+ */
+export declare class SkillManager {
+    private skills;
+    /**
+     * Add a skill to the manager, validating env vars and calling setup().
+     * @param skill - The skill instance to add.
+     */
+    addSkill(skill: SkillBase): Promise<void>;
+    /**
+     * Remove a skill by its instance ID, calling cleanup() before removal.
+     * @param instanceId - The unique instance ID of the skill to remove.
+     * @returns True if the skill was found and removed, false otherwise.
+     */
+    removeSkill(instanceId: string): Promise<boolean>;
+    /**
+     * Remove all skill instances matching a given skill name.
+     * @param skillName - The skill name to match against.
+     * @returns The number of skill instances removed.
+     */
+    removeSkillByName(skillName: string): Promise<number>;
+    /**
+     * Check if any skill instance with the given name is currently loaded.
+     * @param skillName - The skill name to check for.
+     * @returns True if at least one instance with this name is loaded.
+     */
+    hasSkill(skillName: string): boolean;
+    /**
+     * Get a skill by its unique instance ID.
+     * @param instanceId - The instance ID to look up.
+     * @returns The skill instance, or undefined if not found.
+     */
+    getSkill(instanceId: string): SkillBase | undefined;
+    /**
+     * List all loaded skill instances with their name, ID, and initialization state.
+     * @returns Array of skill summary objects.
+     */
+    listSkills(): {
+        name: string;
+        instanceId: string;
+        initialized: boolean;
+    }[];
+    /**
+     * Aggregate tool definitions from all loaded skills.
+     * @returns Combined array of all skill tool definitions.
+     */
+    getAllTools(): ReturnType<SkillBase['getTools']>;
+    /**
+     * Aggregate prompt sections from all loaded skills.
+     * @returns Combined array of all skill prompt sections.
+     */
+    getAllPromptSections(): ReturnType<SkillBase['getPromptSections']>;
+    /**
+     * Aggregate speech recognition hints from all loaded skills.
+     * @returns Combined array of all skill hint strings.
+     */
+    getAllHints(): string[];
+    /**
+     * Merge global data from all loaded skills into a single object.
+     * @returns Combined global data (later skills override earlier ones on key conflicts).
+     */
+    getMergedGlobalData(): Record<string, unknown>;
+    /**
+     * Get the number of currently loaded skill instances.
+     * @returns The count of loaded skills.
+     */
+    get size(): number;
+    /**
+     * Remove all skills and clean up.
+     */
+    clear(): Promise<void>;
+}

package/dist/skills/SkillManager.js

@@ -0,0 +1,159 @@
+/**
+ * SkillManager - Manages skill lifecycle for an agent.
+ *
+ * Handles loading, unloading, validation, and injection of
+ * skill tools, hints, global data, and prompt sections.
+ */
+import { getLogger } from '../Logger.js';
+const log = getLogger('SkillManager');
+/**
+ * Manages the lifecycle of skills attached to an agent.
+ *
+ * Handles loading, unloading, validation, and aggregation of skill tools,
+ * hints, global data, and prompt sections.
+ */
+export class SkillManager {
+    skills = new Map();
+    /**
+     * Add a skill to the manager, validating env vars and calling setup().
+     * @param skill - The skill instance to add.
+     */
+    async addSkill(skill) {
+        const name = skill.skillName;
+        if (this.skills.has(skill.instanceId)) {
+            throw new Error(`Skill instance '${skill.instanceId}' is already loaded`);
+        }
+        // Validate required env vars
+        const missingEnvVars = skill.validateEnvVars();
+        if (missingEnvVars.length) {
+            log.warn(`Skill '${name}' missing env vars: ${missingEnvVars.join(', ')}`);
+        }
+        // Setup
+        await skill.setup();
+        skill.markInitialized();
+        this.skills.set(skill.instanceId, skill);
+        log.debug(`Added skill '${name}' (${skill.instanceId})`);
+    }
+    /**
+     * Remove a skill by its instance ID, calling cleanup() before removal.
+     * @param instanceId - The unique instance ID of the skill to remove.
+     * @returns True if the skill was found and removed, false otherwise.
+     */
+    async removeSkill(instanceId) {
+        const skill = this.skills.get(instanceId);
+        if (!skill)
+            return false;
+        await skill.cleanup();
+        this.skills.delete(instanceId);
+        log.debug(`Removed skill '${skill.skillName}' (${instanceId})`);
+        return true;
+    }
+    /**
+     * Remove all skill instances matching a given skill name.
+     * @param skillName - The skill name to match against.
+     * @returns The number of skill instances removed.
+     */
+    async removeSkillByName(skillName) {
+        let count = 0;
+        for (const [id, skill] of this.skills) {
+            if (skill.skillName === skillName) {
+                await skill.cleanup();
+                this.skills.delete(id);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Check if any skill instance with the given name is currently loaded.
+     * @param skillName - The skill name to check for.
+     * @returns True if at least one instance with this name is loaded.
+     */
+    hasSkill(skillName) {
+        for (const skill of this.skills.values()) {
+            if (skill.skillName === skillName)
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Get a skill by its unique instance ID.
+     * @param instanceId - The instance ID to look up.
+     * @returns The skill instance, or undefined if not found.
+     */
+    getSkill(instanceId) {
+        return this.skills.get(instanceId);
+    }
+    /**
+     * List all loaded skill instances with their name, ID, and initialization state.
+     * @returns Array of skill summary objects.
+     */
+    listSkills() {
+        return Array.from(this.skills.values()).map(s => ({
+            name: s.skillName,
+            instanceId: s.instanceId,
+            initialized: s.isInitialized(),
+        }));
+    }
+    /**
+     * Aggregate tool definitions from all loaded skills.
+     * @returns Combined array of all skill tool definitions.
+     */
+    getAllTools() {
+        const tools = [];
+        for (const skill of this.skills.values()) {
+            tools.push(...skill.getTools());
+        }
+        return tools;
+    }
+    /**
+     * Aggregate prompt sections from all loaded skills.
+     * @returns Combined array of all skill prompt sections.
+     */
+    getAllPromptSections() {
+        const sections = [];
+        for (const skill of this.skills.values()) {
+            sections.push(...skill.getPromptSections());
+        }
+        return sections;
+    }
+    /**
+     * Aggregate speech recognition hints from all loaded skills.
+     * @returns Combined array of all skill hint strings.
+     */
+    getAllHints() {
+        const hints = [];
+        for (const skill of this.skills.values()) {
+            hints.push(...skill.getHints());
+        }
+        return hints;
+    }
+    /**
+     * Merge global data from all loaded skills into a single object.
+     * @returns Combined global data (later skills override earlier ones on key conflicts).
+     */
+    getMergedGlobalData() {
+        const data = {};
+        for (const skill of this.skills.values()) {
+            Object.assign(data, skill.getGlobalData());
+        }
+        return data;
+    }
+    /**
+     * Get the number of currently loaded skill instances.
+     * @returns The count of loaded skills.
+     */
+    get size() {
+        return this.skills.size;
+    }
+    /**
+     * Remove all skills and clean up.
+     */
+    async clear() {
+        for (const skill of this.skills.values()) {
+            await skill.cleanup();
+        }
+        this.skills.clear();
+    }
+}
+//# sourceMappingURL=SkillManager.js.map

package/dist/skills/SkillManager.js.map

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

package/dist/skills/SkillRegistry.d.ts

@@ -0,0 +1,105 @@
+/**
+ * SkillRegistry - Global singleton registry for discovering and loading skills.
+ *
+ * Skills can be registered programmatically or discovered from directories.
+ * Supports SIGNALWIRE_SKILL_PATHS env var for custom skill directories.
+ */
+import { SkillBase, type SkillConfig, type SkillManifest } from './SkillBase.js';
+/** Factory function that creates a SkillBase instance from optional configuration. */
+export type SkillFactory = (config?: SkillConfig) => SkillBase;
+/**
+ * Global singleton registry for discovering and instantiating skills.
+ *
+ * Skills can be registered programmatically or auto-discovered from directories.
+ * Supports the SIGNALWIRE_SKILL_PATHS environment variable for custom skill directories.
+ */
+export declare class SkillRegistry {
+    private registry;
+    private searchPaths;
+    constructor();
+    /**
+     * Get the global singleton instance, creating it on first access.
+     * @returns The shared SkillRegistry instance.
+     */
+    static getInstance(): SkillRegistry;
+    /**
+     * Reset the global singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Register a skill factory by name, optionally with a pre-loaded manifest.
+     * @param name - The unique skill name.
+     * @param factory - Factory function to create skill instances.
+     * @param manifest - Optional manifest metadata for the skill.
+     */
+    register(name: string, factory: SkillFactory, manifest?: SkillManifest): void;
+    /**
+     * Unregister a skill by name, removing it from the registry.
+     * @param name - The skill name to unregister.
+     * @returns True if the skill was found and removed.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Create a new skill instance by looking up its factory in the registry.
+     * @param name - The registered skill name.
+     * @param config - Optional configuration to pass to the factory.
+     * @returns A new skill instance, or null if the name is not registered.
+     */
+    create(name: string, config?: SkillConfig): SkillBase | null;
+    /**
+     * Check if a skill name is registered.
+     * @param name - The skill name to check.
+     * @returns True if the skill is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Get the manifest for a registered skill, if available.
+     * @param name - The skill name to look up.
+     * @returns The skill manifest, or undefined if not found or not provided.
+     */
+    getManifest(name: string): SkillManifest | undefined;
+    /**
+     * List all registered skill names.
+     * @returns Array of registered skill name strings.
+     */
+    listRegistered(): string[];
+    /**
+     * List all registered skills with their optional manifests.
+     * @returns Array of objects containing skill name and manifest.
+     */
+    listRegisteredWithManifests(): {
+        name: string;
+        manifest?: SkillManifest;
+    }[];
+    /**
+     * Add a directory path to search during skill discovery.
+     * @param path - Absolute path to a directory containing skill files.
+     */
+    addSearchPath(path: string): void;
+    /**
+     * Get all configured search paths for skill discovery.
+     * @returns Copy of the search paths array.
+     */
+    getSearchPaths(): string[];
+    /**
+     * Discover and register skills from a directory by importing each file.
+     * Looks for modules exporting a `createSkill` factory or a SkillBase default export.
+     * @param dirPath - Absolute path to the directory to scan.
+     * @returns Array of newly discovered skill names.
+     */
+    discoverFromDirectory(dirPath: string): Promise<string[]>;
+    /**
+     * Discover and register skills from all configured search paths.
+     * @returns Array of all newly discovered skill names.
+     */
+    discoverAll(): Promise<string[]>;
+    /**
+     * Get the number of registered skills.
+     * @returns The count of registered skills.
+     */
+    get size(): number;
+    /**
+     * Clear all registrations.
+     */
+    clear(): void;
+}

package/dist/skills/SkillRegistry.js

@@ -0,0 +1,195 @@
+/**
+ * SkillRegistry - Global singleton registry for discovering and loading skills.
+ *
+ * Skills can be registered programmatically or discovered from directories.
+ * Supports SIGNALWIRE_SKILL_PATHS env var for custom skill directories.
+ */
+import { SkillBase } from './SkillBase.js';
+import { getLogger } from '../Logger.js';
+const log = getLogger('SkillRegistry');
+let _instance = null;
+/**
+ * Global singleton registry for discovering and instantiating skills.
+ *
+ * Skills can be registered programmatically or auto-discovered from directories.
+ * Supports the SIGNALWIRE_SKILL_PATHS environment variable for custom skill directories.
+ */
+export class SkillRegistry {
+    registry = new Map();
+    searchPaths;
+    constructor() {
+        const envPaths = process.env['SIGNALWIRE_SKILL_PATHS'];
+        this.searchPaths = envPaths ? envPaths.split(':').filter(Boolean) : [];
+    }
+    /**
+     * Get the global singleton instance, creating it on first access.
+     * @returns The shared SkillRegistry instance.
+     */
+    static getInstance() {
+        if (!_instance) {
+            _instance = new SkillRegistry();
+        }
+        return _instance;
+    }
+    /**
+     * Reset the global singleton (for testing).
+     */
+    static resetInstance() {
+        _instance = null;
+    }
+    /**
+     * Register a skill factory by name, optionally with a pre-loaded manifest.
+     * @param name - The unique skill name.
+     * @param factory - Factory function to create skill instances.
+     * @param manifest - Optional manifest metadata for the skill.
+     */
+    register(name, factory, manifest) {
+        if (this.registry.has(name)) {
+            log.warn(`Overwriting skill registration: ${name}`);
+        }
+        this.registry.set(name, { name, factory, manifest });
+        log.debug(`Registered skill: ${name}`);
+    }
+    /**
+     * Unregister a skill by name, removing it from the registry.
+     * @param name - The skill name to unregister.
+     * @returns True if the skill was found and removed.
+     */
+    unregister(name) {
+        return this.registry.delete(name);
+    }
+    /**
+     * Create a new skill instance by looking up its factory in the registry.
+     * @param name - The registered skill name.
+     * @param config - Optional configuration to pass to the factory.
+     * @returns A new skill instance, or null if the name is not registered.
+     */
+    create(name, config) {
+        const entry = this.registry.get(name);
+        if (!entry) {
+            log.warn(`Skill not found in registry: ${name}`);
+            return null;
+        }
+        return entry.factory(config);
+    }
+    /**
+     * Check if a skill name is registered.
+     * @param name - The skill name to check.
+     * @returns True if the skill is registered.
+     */
+    has(name) {
+        return this.registry.has(name);
+    }
+    /**
+     * Get the manifest for a registered skill, if available.
+     * @param name - The skill name to look up.
+     * @returns The skill manifest, or undefined if not found or not provided.
+     */
+    getManifest(name) {
+        return this.registry.get(name)?.manifest;
+    }
+    /**
+     * List all registered skill names.
+     * @returns Array of registered skill name strings.
+     */
+    listRegistered() {
+        return Array.from(this.registry.keys());
+    }
+    /**
+     * List all registered skills with their optional manifests.
+     * @returns Array of objects containing skill name and manifest.
+     */
+    listRegisteredWithManifests() {
+        return Array.from(this.registry.values()).map(e => ({
+            name: e.name,
+            manifest: e.manifest,
+        }));
+    }
+    /**
+     * Add a directory path to search during skill discovery.
+     * @param path - Absolute path to a directory containing skill files.
+     */
+    addSearchPath(path) {
+        if (!this.searchPaths.includes(path)) {
+            this.searchPaths.push(path);
+        }
+    }
+    /**
+     * Get all configured search paths for skill discovery.
+     * @returns Copy of the search paths array.
+     */
+    getSearchPaths() {
+        return [...this.searchPaths];
+    }
+    /**
+     * Discover and register skills from a directory by importing each file.
+     * Looks for modules exporting a `createSkill` factory or a SkillBase default export.
+     * @param dirPath - Absolute path to the directory to scan.
+     * @returns Array of newly discovered skill names.
+     */
+    async discoverFromDirectory(dirPath) {
+        const { readdir } = await import('node:fs/promises');
+        const { join } = await import('node:path');
+        const { pathToFileURL } = await import('node:url');
+        const discovered = [];
+        let entries;
+        try {
+            const dirEntries = await readdir(dirPath, { withFileTypes: true });
+            entries = dirEntries
+                .filter(e => (e.isFile() && (e.name.endsWith('.ts') || e.name.endsWith('.js'))) || e.isDirectory())
+                .map(e => e.name);
+        }
+        catch {
+            log.warn(`Cannot read skill directory: ${dirPath}`);
+            return discovered;
+        }
+        for (const entry of entries) {
+            const fullPath = join(dirPath, entry);
+            try {
+                const fileUrl = pathToFileURL(entry.endsWith('.ts') || entry.endsWith('.js') ? fullPath : join(fullPath, 'skill.ts')).href;
+                const mod = await import(fileUrl);
+                // Look for a factory function or a SkillBase subclass
+                if (typeof mod.createSkill === 'function') {
+                    const name = entry.replace(/\.(ts|js)$/, '');
+                    this.register(name, mod.createSkill);
+                    discovered.push(name);
+                }
+                else if (typeof mod.default === 'function' && mod.default.prototype instanceof SkillBase) {
+                    const name = entry.replace(/\.(ts|js)$/, '');
+                    this.register(name, (config) => new mod.default(config));
+                    discovered.push(name);
+                }
+            }
+            catch (err) {
+                log.debug(`Could not load skill from ${fullPath}: ${err}`);
+            }
+        }
+        return discovered;
+    }
+    /**
+     * Discover and register skills from all configured search paths.
+     * @returns Array of all newly discovered skill names.
+     */
+    async discoverAll() {
+        const all = [];
+        for (const path of this.searchPaths) {
+            const found = await this.discoverFromDirectory(path);
+            all.push(...found);
+        }
+        return all;
+    }
+    /**
+     * Get the number of registered skills.
+     * @returns The count of registered skills.
+     */
+    get size() {
+        return this.registry.size;
+    }
+    /**
+     * Clear all registrations.
+     */
+    clear() {
+        this.registry.clear();
+    }
+}
+//# sourceMappingURL=SkillRegistry.js.map

package/dist/skills/SkillRegistry.js.map

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

package/dist/skills/builtin/api_ninjas_trivia.d.ts

@@ -0,0 +1,35 @@
+/**
+ * API Ninjas Trivia Skill - Fetches trivia questions from the API Ninjas service.
+ *
+ * Tier 2 built-in skill: requires API_NINJAS_KEY environment variable.
+ * Uses the API Ninjas Trivia endpoint to retrieve random trivia questions
+ * with optional category filtering.
+ */
+import { SkillBase } from '../SkillBase.js';
+import type { SkillManifest, SkillToolDefinition, SkillPromptSection, SkillConfig } from '../SkillBase.js';
+/**
+ * Fetches trivia questions from the API Ninjas service.
+ *
+ * Tier 2 built-in skill. Requires the `API_NINJAS_KEY` environment variable.
+ * Supports optional `default_category` and `reveal_answer` config options.
+ */
+export declare class ApiNinjasTriviaSkill extends SkillBase {
+    /**
+     * @param config - Optional configuration; supports `default_category` and `reveal_answer`.
+     */
+    constructor(config?: SkillConfig);
+    /** @returns Manifest declaring API_NINJAS_KEY as required and config schema for category/reveal. */
+    getManifest(): SkillManifest;
+    /** @returns A single `get_trivia` tool that fetches a random trivia question with optional category. */
+    getTools(): SkillToolDefinition[];
+    /** @returns Prompt section describing trivia capabilities and quiz behavior. */
+    getPromptSections(): SkillPromptSection[];
+    /** @returns Speech recognition hints for trivia-related keywords. */
+    getHints(): string[];
+}
+/**
+ * Factory function for creating ApiNinjasTriviaSkill instances.
+ * @param config - Optional skill configuration.
+ * @returns A new ApiNinjasTriviaSkill instance.
+ */
+export declare function createSkill(config?: SkillConfig): ApiNinjasTriviaSkill;