signalwire-agents 0.1.0

package/dist/skills/builtin/google_maps.js

@@ -0,0 +1,233 @@
+/**
+ * Google Maps Skill - Provides directions and place search via Google Maps APIs.
+ *
+ * Tier 3 built-in skill: requires GOOGLE_MAPS_API_KEY environment variable.
+ * Uses Google Directions API for route information and Google Places API
+ * for place search and discovery.
+ */
+import { SkillBase } from '../SkillBase.js';
+import { SwaigFunctionResult } from '../../SwaigFunctionResult.js';
+/**
+ * Provides driving/walking/transit directions and place search via Google Maps APIs.
+ *
+ * Tier 3 built-in skill. Requires the `GOOGLE_MAPS_API_KEY` environment variable.
+ * Supports a `default_mode` config option ("driving"|"walking"|"bicycling"|"transit").
+ */
+export class GoogleMapsSkill extends SkillBase {
+    /**
+     * @param config - Optional configuration; supports `default_mode` for travel mode.
+     */
+    constructor(config) {
+        super('google_maps', config);
+    }
+    /** @returns Manifest declaring GOOGLE_MAPS_API_KEY as required and config schema for default_mode. */
+    getManifest() {
+        return {
+            name: 'google_maps',
+            description: 'Provides driving/walking/transit directions and place search via Google Maps APIs.',
+            version: '1.0.0',
+            author: 'SignalWire',
+            tags: ['maps', 'directions', 'places', 'google', 'navigation', 'external'],
+            requiredEnvVars: ['GOOGLE_MAPS_API_KEY'],
+            configSchema: {
+                default_mode: {
+                    type: 'string',
+                    description: 'Default travel mode: "driving", "walking", "bicycling", or "transit". Defaults to "driving".',
+                    default: 'driving',
+                },
+            },
+        };
+    }
+    /** @returns Two tools: `get_directions` for route info and `find_place` for place discovery. */
+    getTools() {
+        const defaultMode = this.getConfig('default_mode', 'driving');
+        return [
+            {
+                name: 'get_directions',
+                description: 'Get directions between two locations. Returns distance, duration, and step-by-step directions summary.',
+                parameters: {
+                    origin: {
+                        type: 'string',
+                        description: 'Starting location (address, city name, or place name).',
+                    },
+                    destination: {
+                        type: 'string',
+                        description: 'Destination location (address, city name, or place name).',
+                    },
+                    mode: {
+                        type: 'string',
+                        description: `Travel mode: "driving", "walking", "bicycling", or "transit". Defaults to "${defaultMode}".`,
+                    },
+                },
+                required: ['origin', 'destination'],
+                handler: async (args) => {
+                    const origin = args.origin;
+                    const destination = args.destination;
+                    const mode = args.mode ?? defaultMode;
+                    if (!origin || typeof origin !== 'string' || origin.trim().length === 0) {
+                        return new SwaigFunctionResult('Please provide a starting location (origin).');
+                    }
+                    if (!destination || typeof destination !== 'string' || destination.trim().length === 0) {
+                        return new SwaigFunctionResult('Please provide a destination.');
+                    }
+                    const apiKey = process.env['GOOGLE_MAPS_API_KEY'];
+                    if (!apiKey) {
+                        return new SwaigFunctionResult('Google Maps is not configured. The GOOGLE_MAPS_API_KEY environment variable is required.');
+                    }
+                    const validModes = ['driving', 'walking', 'bicycling', 'transit'];
+                    const travelMode = validModes.includes(mode) ? mode : defaultMode;
+                    try {
+                        const url = `https://maps.googleapis.com/maps/api/directions/json` +
+                            `?origin=${encodeURIComponent(origin.trim())}` +
+                            `&destination=${encodeURIComponent(destination.trim())}` +
+                            `&mode=${travelMode}` +
+                            `&key=${apiKey}`;
+                        const response = await fetch(url);
+                        const data = (await response.json());
+                        if (data.status !== 'OK') {
+                            const errorMsg = data.error_message ?? data.status;
+                            return new SwaigFunctionResult(`Could not get directions from "${origin}" to "${destination}": ${errorMsg}`);
+                        }
+                        if (data.routes.length === 0) {
+                            return new SwaigFunctionResult(`No routes found from "${origin}" to "${destination}".`);
+                        }
+                        const route = data.routes[0];
+                        const leg = route.legs[0];
+                        const parts = [
+                            `Directions from ${leg.start_address} to ${leg.end_address}:`,
+                            `Mode: ${travelMode}`,
+                            `Distance: ${leg.distance.text}`,
+                            `Estimated duration: ${leg.duration.text}`,
+                        ];
+                        if (route.summary) {
+                            parts.push(`Route: via ${route.summary}`);
+                        }
+                        parts.push('');
+                        parts.push('Steps:');
+                        const maxSteps = Math.min(leg.steps.length, 10);
+                        for (let i = 0; i < maxSteps; i++) {
+                            const step = leg.steps[i];
+                            const instruction = step.html_instructions
+                                .replace(/<[^>]*>/g, '')
+                                .replace(/&nbsp;/g, ' ')
+                                .trim();
+                            parts.push(`${i + 1}. ${instruction} (${step.distance.text}, ${step.duration.text})`);
+                        }
+                        if (leg.steps.length > maxSteps) {
+                            parts.push(`... and ${leg.steps.length - maxSteps} more steps.`);
+                        }
+                        if (route.warnings.length > 0) {
+                            parts.push('');
+                            parts.push(`Note: ${route.warnings.join(' ')}`);
+                        }
+                        return new SwaigFunctionResult(parts.join('\n'));
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        return new SwaigFunctionResult(`Failed to get directions: ${message}`);
+                    }
+                },
+            },
+            {
+                name: 'find_place',
+                description: 'Search for a place by name or description. Returns the place name, address, rating, and whether it is currently open.',
+                parameters: {
+                    query: {
+                        type: 'string',
+                        description: 'The place to search for (e.g., "pizza near Times Square", "Eiffel Tower", "pharmacy in Chicago").',
+                    },
+                },
+                required: ['query'],
+                handler: async (args) => {
+                    const query = args.query;
+                    if (!query || typeof query !== 'string' || query.trim().length === 0) {
+                        return new SwaigFunctionResult('Please provide a place to search for.');
+                    }
+                    const apiKey = process.env['GOOGLE_MAPS_API_KEY'];
+                    if (!apiKey) {
+                        return new SwaigFunctionResult('Google Maps is not configured. The GOOGLE_MAPS_API_KEY environment variable is required.');
+                    }
+                    try {
+                        const fields = 'name,formatted_address,geometry,rating,user_ratings_total,opening_hours,business_status,types';
+                        const url = `https://maps.googleapis.com/maps/api/place/findplacefromtext/json` +
+                            `?input=${encodeURIComponent(query.trim())}` +
+                            `&inputtype=textquery` +
+                            `&fields=${fields}` +
+                            `&key=${apiKey}`;
+                        const response = await fetch(url);
+                        const data = (await response.json());
+                        if (data.status !== 'OK' && data.status !== 'ZERO_RESULTS') {
+                            const errorMsg = data.error_message ?? data.status;
+                            return new SwaigFunctionResult(`Place search failed: ${errorMsg}`);
+                        }
+                        if (!data.candidates || data.candidates.length === 0) {
+                            return new SwaigFunctionResult(`No places found for "${query}". Try a different search term.`);
+                        }
+                        const place = data.candidates[0];
+                        const parts = [
+                            `Place found: ${place.name}`,
+                            `Address: ${place.formatted_address}`,
+                        ];
+                        if (place.rating !== undefined) {
+                            const ratingInfo = place.user_ratings_total
+                                ? `${place.rating}/5 (${place.user_ratings_total} reviews)`
+                                : `${place.rating}/5`;
+                            parts.push(`Rating: ${ratingInfo}`);
+                        }
+                        if (place.opening_hours?.open_now !== undefined) {
+                            parts.push(`Currently open: ${place.opening_hours.open_now ? 'Yes' : 'No'}`);
+                        }
+                        if (place.business_status && place.business_status !== 'OPERATIONAL') {
+                            parts.push(`Status: ${place.business_status.toLowerCase().replace(/_/g, ' ')}`);
+                        }
+                        if (place.types && place.types.length > 0) {
+                            const readableTypes = place.types
+                                .filter((t) => !t.startsWith('point_of_interest') && !t.startsWith('establishment'))
+                                .slice(0, 5)
+                                .map((t) => t.replace(/_/g, ' '));
+                            if (readableTypes.length > 0) {
+                                parts.push(`Type: ${readableTypes.join(', ')}`);
+                            }
+                        }
+                        if (place.geometry?.location) {
+                            const { lat, lng } = place.geometry.location;
+                            parts.push(`Coordinates: ${lat}, ${lng}`);
+                        }
+                        return new SwaigFunctionResult(parts.join('\n'));
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        return new SwaigFunctionResult(`Failed to search for place "${query}": ${message}`);
+                    }
+                },
+            },
+        ];
+    }
+    /** @returns Prompt section describing directions and place search capabilities. */
+    getPromptSections() {
+        const defaultMode = this.getConfig('default_mode', 'driving');
+        return [
+            {
+                title: 'Google Maps & Directions',
+                body: 'You can look up directions between locations and search for places.',
+                bullets: [
+                    'Use the get_directions tool to provide driving, walking, bicycling, or transit directions between two locations.',
+                    `The default travel mode is ${defaultMode}. The user can request a different mode.`,
+                    'Directions include total distance, estimated duration, and step-by-step navigation.',
+                    'Use the find_place tool to search for businesses, landmarks, or any point of interest.',
+                    'Place results include address, rating, and whether the place is currently open.',
+                    'Summarize directions naturally rather than reading each step verbatim unless the user asks for details.',
+                ],
+            },
+        ];
+    }
+}
+/**
+ * Factory function for creating GoogleMapsSkill instances.
+ * @param config - Optional skill configuration.
+ * @returns A new GoogleMapsSkill instance.
+ */
+export function createSkill(config) {
+    return new GoogleMapsSkill(config);
+}
+//# sourceMappingURL=google_maps.js.map

package/dist/skills/builtin/google_maps.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * Built-in skills registry for SignalWire AI Agents.
+ *
+ * Import this module to register all built-in skills with the global SkillRegistry.
+ */
+export { DateTimeSkill, createSkill as createDateTimeSkill } from './datetime.js';
+export { MathSkill, createSkill as createMathSkill } from './math.js';
+export { JokeSkill, createSkill as createJokeSkill } from './joke.js';
+export { WeatherApiSkill, createSkill as createWeatherApiSkill } from './weather_api.js';
+export { PlayBackgroundFileSkill, createSkill as createPlayBackgroundFileSkill } from './play_background_file.js';
+export { SwmlTransferSkill, createSkill as createSwmlTransferSkill } from './swml_transfer.js';
+export { ApiNinjasTriviaSkill, createSkill as createApiNinjasTriviaSkill } from './api_ninjas_trivia.js';
+export { InfoGathererSkill, createSkill as createInfoGathererSkill } from './info_gatherer.js';
+export { CustomSkillsSkill, createSkill as createCustomSkillsSkill } from './custom_skills.js';
+export { WebSearchSkill, createSkill as createWebSearchSkill } from './web_search.js';
+export { WikipediaSearchSkill, createSkill as createWikipediaSearchSkill } from './wikipedia_search.js';
+export { GoogleMapsSkill, createSkill as createGoogleMapsSkill } from './google_maps.js';
+export { DataSphereSkill, createSkill as createDataSphereSkill } from './datasphere.js';
+export { DataSphereServerlessSkill, createSkill as createDataSphereServerlessSkill } from './datasphere_serverless.js';
+export { NativeVectorSearchSkill, createSkill as createNativeVectorSearchSkill } from './native_vector_search.js';
+export { SpiderSkill, createSkill as createSpiderSkill } from './spider.js';
+export { ClaudeSkill, createSkill as createClaudeSkill } from './claude_skills.js';
+export { McpGatewaySkill, createSkill as createMcpGatewaySkill } from './mcp_gateway.js';
+/**
+ * Register all 18 built-in skills with the global SkillRegistry singleton.
+ * Skips registration for any skill name already present in the registry.
+ */
+export declare function registerBuiltinSkills(): void;

package/dist/skills/builtin/index.js

@@ -0,0 +1,75 @@
+/**
+ * Built-in skills registry for SignalWire AI Agents.
+ *
+ * Import this module to register all built-in skills with the global SkillRegistry.
+ */
+export { DateTimeSkill, createSkill as createDateTimeSkill } from './datetime.js';
+export { MathSkill, createSkill as createMathSkill } from './math.js';
+export { JokeSkill, createSkill as createJokeSkill } from './joke.js';
+export { WeatherApiSkill, createSkill as createWeatherApiSkill } from './weather_api.js';
+export { PlayBackgroundFileSkill, createSkill as createPlayBackgroundFileSkill } from './play_background_file.js';
+export { SwmlTransferSkill, createSkill as createSwmlTransferSkill } from './swml_transfer.js';
+export { ApiNinjasTriviaSkill, createSkill as createApiNinjasTriviaSkill } from './api_ninjas_trivia.js';
+export { InfoGathererSkill, createSkill as createInfoGathererSkill } from './info_gatherer.js';
+export { CustomSkillsSkill, createSkill as createCustomSkillsSkill } from './custom_skills.js';
+export { WebSearchSkill, createSkill as createWebSearchSkill } from './web_search.js';
+export { WikipediaSearchSkill, createSkill as createWikipediaSearchSkill } from './wikipedia_search.js';
+export { GoogleMapsSkill, createSkill as createGoogleMapsSkill } from './google_maps.js';
+export { DataSphereSkill, createSkill as createDataSphereSkill } from './datasphere.js';
+export { DataSphereServerlessSkill, createSkill as createDataSphereServerlessSkill } from './datasphere_serverless.js';
+export { NativeVectorSearchSkill, createSkill as createNativeVectorSearchSkill } from './native_vector_search.js';
+export { SpiderSkill, createSkill as createSpiderSkill } from './spider.js';
+export { ClaudeSkill, createSkill as createClaudeSkill } from './claude_skills.js';
+export { McpGatewaySkill, createSkill as createMcpGatewaySkill } from './mcp_gateway.js';
+import { SkillRegistry } from '../SkillRegistry.js';
+import { createSkill as createDateTimeSkill } from './datetime.js';
+import { createSkill as createMathSkill } from './math.js';
+import { createSkill as createJokeSkill } from './joke.js';
+import { createSkill as createWeatherApiSkill } from './weather_api.js';
+import { createSkill as createPlayBackgroundFileSkill } from './play_background_file.js';
+import { createSkill as createSwmlTransferSkill } from './swml_transfer.js';
+import { createSkill as createApiNinjasTriviaSkill } from './api_ninjas_trivia.js';
+import { createSkill as createInfoGathererSkill } from './info_gatherer.js';
+import { createSkill as createCustomSkillsSkill } from './custom_skills.js';
+import { createSkill as createWebSearchSkill } from './web_search.js';
+import { createSkill as createWikipediaSearchSkill } from './wikipedia_search.js';
+import { createSkill as createGoogleMapsSkill } from './google_maps.js';
+import { createSkill as createDataSphereSkill } from './datasphere.js';
+import { createSkill as createDataSphereServerlessSkill } from './datasphere_serverless.js';
+import { createSkill as createNativeVectorSearchSkill } from './native_vector_search.js';
+import { createSkill as createSpiderSkill } from './spider.js';
+import { createSkill as createClaudeSkill } from './claude_skills.js';
+import { createSkill as createMcpGatewaySkill } from './mcp_gateway.js';
+/**
+ * Register all 18 built-in skills with the global SkillRegistry singleton.
+ * Skips registration for any skill name already present in the registry.
+ */
+export function registerBuiltinSkills() {
+    const registry = SkillRegistry.getInstance();
+    const skills = [
+        ['datetime', createDateTimeSkill],
+        ['math', createMathSkill],
+        ['joke', createJokeSkill],
+        ['weather_api', createWeatherApiSkill],
+        ['play_background_file', createPlayBackgroundFileSkill],
+        ['swml_transfer', createSwmlTransferSkill],
+        ['api_ninjas_trivia', createApiNinjasTriviaSkill],
+        ['info_gatherer', createInfoGathererSkill],
+        ['custom_skills', createCustomSkillsSkill],
+        ['web_search', createWebSearchSkill],
+        ['wikipedia_search', createWikipediaSearchSkill],
+        ['google_maps', createGoogleMapsSkill],
+        ['datasphere', createDataSphereSkill],
+        ['datasphere_serverless', createDataSphereServerlessSkill],
+        ['native_vector_search', createNativeVectorSearchSkill],
+        ['spider', createSpiderSkill],
+        ['claude_skills', createClaudeSkill],
+        ['mcp_gateway', createMcpGatewaySkill],
+    ];
+    for (const [name, factory] of skills) {
+        if (!registry.has(name)) {
+            registry.register(name, factory);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/builtin/index.js.map

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

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

@@ -0,0 +1,52 @@
+/**
+ * Info Gatherer Skill - Collects structured information from the user.
+ *
+ * Tier 2 built-in skill: no external dependencies required.
+ * Dynamically generates a save_info tool based on configured fields.
+ * Fields can have optional validation patterns and required/optional flags.
+ * Useful for collecting user details like name, email, phone, address, etc.
+ */
+import { SkillBase } from '../SkillBase.js';
+import type { SkillManifest, SkillToolDefinition, SkillPromptSection, SkillConfig } from '../SkillBase.js';
+/** Key-value map of information gathered from a user during a call. */
+interface GatheredInfo {
+    [key: string]: unknown;
+}
+/**
+ * Collects structured information from the user based on configurable fields.
+ *
+ * Tier 2 built-in skill with no external dependencies. Dynamically generates
+ * a `save_info` tool based on the `fields` config array. Fields support
+ * optional validation patterns and required/optional flags. Data is stored
+ * per-call and optionally merged into global data.
+ */
+export declare class InfoGathererSkill extends SkillBase {
+    private gatheredData;
+    /**
+     * @param config - Optional configuration; supports `fields`, `purpose`, `confirmation_message`, `store_globally`.
+     */
+    constructor(config?: SkillConfig);
+    /** @returns Manifest with config schema for fields, purpose, confirmation_message, and store_globally. */
+    getManifest(): SkillManifest;
+    /** @returns A `save_info` tool (dynamic params from config) and a `get_gathered_info` retrieval tool. */
+    getTools(): SkillToolDefinition[];
+    /** @returns Prompt section listing required/optional fields and collection instructions. */
+    getPromptSections(): SkillPromptSection[];
+    /**
+     * Get all gathered data, keyed by call ID.
+     * @returns A copy of the internal gathered data map.
+     */
+    getAllGatheredData(): Map<string, GatheredInfo>;
+    /**
+     * Clear gathered data for a specific call or all calls.
+     * @param callId - If provided, clear data for this call only; otherwise clear all.
+     */
+    clearGatheredData(callId?: string): void;
+}
+/**
+ * Factory function for creating InfoGathererSkill instances.
+ * @param config - Optional skill configuration.
+ * @returns A new InfoGathererSkill instance.
+ */
+export declare function createSkill(config?: SkillConfig): InfoGathererSkill;
+export {};

package/dist/skills/builtin/info_gatherer.js

@@ -0,0 +1,237 @@
+/**
+ * Info Gatherer Skill - Collects structured information from the user.
+ *
+ * Tier 2 built-in skill: no external dependencies required.
+ * Dynamically generates a save_info tool based on configured fields.
+ * Fields can have optional validation patterns and required/optional flags.
+ * Useful for collecting user details like name, email, phone, address, etc.
+ */
+import { SkillBase } from '../SkillBase.js';
+import { SwaigFunctionResult } from '../../SwaigFunctionResult.js';
+/**
+ * Collects structured information from the user based on configurable fields.
+ *
+ * Tier 2 built-in skill with no external dependencies. Dynamically generates
+ * a `save_info` tool based on the `fields` config array. Fields support
+ * optional validation patterns and required/optional flags. Data is stored
+ * per-call and optionally merged into global data.
+ */
+export class InfoGathererSkill extends SkillBase {
+    gatheredData = new Map();
+    /**
+     * @param config - Optional configuration; supports `fields`, `purpose`, `confirmation_message`, `store_globally`.
+     */
+    constructor(config) {
+        super('info_gatherer', config);
+    }
+    /** @returns Manifest with config schema for fields, purpose, confirmation_message, and store_globally. */
+    getManifest() {
+        return {
+            name: 'info_gatherer',
+            description: 'Collects structured information from the user based on configurable fields. Validates and stores gathered data.',
+            version: '1.0.0',
+            author: 'SignalWire',
+            tags: ['data-collection', 'form', 'information', 'utility'],
+            configSchema: {
+                fields: {
+                    type: 'array',
+                    description: 'Array of field definitions to collect: { name, description, required?, validation?, type? }.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string', description: 'Field name (used as the parameter key).' },
+                            description: { type: 'string', description: 'Description of what this field collects.' },
+                            required: { type: 'boolean', description: 'Whether this field is required. Defaults to false.' },
+                            validation: {
+                                type: 'string',
+                                description: 'Optional regex pattern for validation (e.g., "^[\\\\w.+-]+@[\\\\w-]+\\\\.[\\\\w.]+$" for email).',
+                            },
+                            type: {
+                                type: 'string',
+                                description: 'Parameter type for the tool schema. Defaults to "string".',
+                            },
+                        },
+                        required: ['name', 'description'],
+                    },
+                },
+                purpose: {
+                    type: 'string',
+                    description: 'A description of why this information is being collected (shown in prompt).',
+                },
+                confirmation_message: {
+                    type: 'string',
+                    description: 'Custom message returned after successful info collection.',
+                },
+                store_globally: {
+                    type: 'boolean',
+                    description: 'Whether to store gathered info in global data. Defaults to false.',
+                },
+            },
+        };
+    }
+    /** @returns A `save_info` tool (dynamic params from config) and a `get_gathered_info` retrieval tool. */
+    getTools() {
+        const fields = this.getConfig('fields', []);
+        const confirmationMessage = this.getConfig('confirmation_message', 'Information has been saved successfully.');
+        const storeGlobally = this.getConfig('store_globally', false);
+        if (fields.length === 0) {
+            return [];
+        }
+        // Build dynamic parameters from field definitions
+        const parameters = {};
+        const requiredParams = [];
+        for (const field of fields) {
+            parameters[field.name] = {
+                type: field.type ?? 'string',
+                description: field.description,
+            };
+            if (field.required) {
+                requiredParams.push(field.name);
+            }
+        }
+        const tools = [
+            {
+                name: 'save_info',
+                description: 'Save information gathered from the user. Call this once you have collected the required fields.',
+                parameters,
+                required: requiredParams.length > 0 ? requiredParams : undefined,
+                handler: (args, rawData) => {
+                    const errors = [];
+                    const collected = {};
+                    // Validate each field
+                    for (const field of fields) {
+                        const value = args[field.name];
+                        // Check required fields
+                        if (field.required) {
+                            if (value === undefined || value === null || (typeof value === 'string' && value.trim().length === 0)) {
+                                errors.push(`"${field.name}" is required but was not provided.`);
+                                continue;
+                            }
+                        }
+                        // Skip optional fields that weren't provided
+                        if (value === undefined || value === null) {
+                            continue;
+                        }
+                        // Validate against pattern if specified
+                        if (field.validation && typeof value === 'string') {
+                            try {
+                                const regex = new RegExp(field.validation);
+                                if (!regex.test(value)) {
+                                    errors.push(`"${field.name}" value "${value}" does not match the expected format.`);
+                                    continue;
+                                }
+                            }
+                            catch {
+                                // If regex is invalid, skip validation
+                            }
+                        }
+                        collected[field.name] = typeof value === 'string' ? value.trim() : value;
+                    }
+                    if (errors.length > 0) {
+                        return new SwaigFunctionResult(`Could not save information due to validation errors:\n${errors.join('\n')}\nPlease correct these fields and try again.`);
+                    }
+                    if (Object.keys(collected).length === 0) {
+                        return new SwaigFunctionResult('No information was provided. Please collect at least one field before saving.');
+                    }
+                    // Store the gathered data keyed by call ID if available
+                    const callId = rawData['call_id'] ?? 'default';
+                    this.gatheredData.set(callId, {
+                        ...this.gatheredData.get(callId),
+                        ...collected,
+                    });
+                    // Build confirmation with collected fields summary
+                    const fieldSummary = Object.entries(collected)
+                        .map(([key, val]) => `${key}: ${val}`)
+                        .join(', ');
+                    const result = new SwaigFunctionResult(`${confirmationMessage} Saved: ${fieldSummary}.`);
+                    // Optionally store in global data
+                    if (storeGlobally) {
+                        result.updateGlobalData({ gathered_info: collected });
+                    }
+                    return result;
+                },
+            },
+            {
+                name: 'get_gathered_info',
+                description: 'Retrieve previously gathered information for the current call. Useful to review what has already been collected.',
+                parameters: {},
+                handler: (_args, rawData) => {
+                    const callId = rawData['call_id'] ?? 'default';
+                    const info = this.gatheredData.get(callId);
+                    if (!info || Object.keys(info).length === 0) {
+                        return new SwaigFunctionResult('No information has been gathered yet for this call.');
+                    }
+                    const summary = Object.entries(info)
+                        .map(([key, val]) => `${key}: ${val}`)
+                        .join(', ');
+                    return new SwaigFunctionResult(`Previously gathered information: ${summary}.`);
+                },
+            },
+        ];
+        return tools;
+    }
+    /** @returns Prompt section listing required/optional fields and collection instructions. */
+    getPromptSections() {
+        const fields = this.getConfig('fields', []);
+        const purpose = this.getConfig('purpose', undefined);
+        if (fields.length === 0) {
+            return [];
+        }
+        const requiredFields = fields.filter((f) => f.required);
+        const optionalFields = fields.filter((f) => !f.required);
+        const bullets = [];
+        if (purpose) {
+            bullets.push(`Purpose: ${purpose}`);
+        }
+        bullets.push('Use the save_info tool to store information once you have collected it from the user.');
+        if (requiredFields.length > 0) {
+            const reqNames = requiredFields.map((f) => `"${f.name}"`).join(', ');
+            bullets.push(`Required fields (must be collected): ${reqNames}.`);
+        }
+        if (optionalFields.length > 0) {
+            const optNames = optionalFields.map((f) => `"${f.name}"`).join(', ');
+            bullets.push(`Optional fields (collect if available): ${optNames}.`);
+        }
+        // Add field descriptions
+        for (const field of fields) {
+            const reqLabel = field.required ? ' (required)' : ' (optional)';
+            bullets.push(`${field.name}${reqLabel}: ${field.description}`);
+        }
+        bullets.push('Ask for information naturally in conversation rather than as a list of questions.', 'Use get_gathered_info to review what has already been collected.', 'Once all required fields are gathered, call save_info to store the data.');
+        return [
+            {
+                title: 'Information Collection',
+                body: 'You need to collect specific information from the user during this conversation.',
+                bullets,
+            },
+        ];
+    }
+    /**
+     * Get all gathered data, keyed by call ID.
+     * @returns A copy of the internal gathered data map.
+     */
+    getAllGatheredData() {
+        return new Map(this.gatheredData);
+    }
+    /**
+     * Clear gathered data for a specific call or all calls.
+     * @param callId - If provided, clear data for this call only; otherwise clear all.
+     */
+    clearGatheredData(callId) {
+        if (callId) {
+            this.gatheredData.delete(callId);
+        }
+        else {
+            this.gatheredData.clear();
+        }
+    }
+}
+/**
+ * Factory function for creating InfoGathererSkill instances.
+ * @param config - Optional skill configuration.
+ * @returns A new InfoGathererSkill instance.
+ */
+export function createSkill(config) {
+    return new InfoGathererSkill(config);
+}
+//# sourceMappingURL=info_gatherer.js.map