signalwire-agents 0.1.0

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * DataSphere Skill - Searches SignalWire DataSphere for knowledge base content.
+ *
+ * Tier 3 built-in skill: requires SIGNALWIRE_PROJECT_ID, SIGNALWIRE_TOKEN,
+ * and SIGNALWIRE_SPACE environment variables. Uses the SignalWire DataSphere
+ * API to perform semantic search across uploaded documents.
+ */
+import { SkillBase } from '../SkillBase.js';
+import type { SkillManifest, SkillToolDefinition, SkillPromptSection, SkillConfig } from '../SkillBase.js';
+/**
+ * Searches SignalWire DataSphere for knowledge base content using semantic search.
+ *
+ * Tier 3 built-in skill. Requires `SIGNALWIRE_PROJECT_ID`, `SIGNALWIRE_TOKEN`,
+ * and `SIGNALWIRE_SPACE` environment variables. Supports `max_results` and
+ * `distance_threshold` config options.
+ */
+export declare class DataSphereSkill extends SkillBase {
+    /**
+     * @param config - Optional configuration; supports `max_results` and `distance_threshold`.
+     */
+    constructor(config?: SkillConfig);
+    /** @returns Manifest declaring SignalWire credentials as required env vars. */
+    getManifest(): SkillManifest;
+    /** @returns A single `search_datasphere` tool that performs semantic search on uploaded documents. */
+    getTools(): SkillToolDefinition[];
+    /** @returns Prompt section describing DataSphere knowledge base search capabilities. */
+    getPromptSections(): SkillPromptSection[];
+}
+/**
+ * Factory function for creating DataSphereSkill instances.
+ * @param config - Optional skill configuration.
+ * @returns A new DataSphereSkill instance.
+ */
+export declare function createSkill(config?: SkillConfig): DataSphereSkill;

package/dist/skills/builtin/datasphere.js

@@ -0,0 +1,163 @@
+/**
+ * DataSphere Skill - Searches SignalWire DataSphere for knowledge base content.
+ *
+ * Tier 3 built-in skill: requires SIGNALWIRE_PROJECT_ID, SIGNALWIRE_TOKEN,
+ * and SIGNALWIRE_SPACE environment variables. Uses the SignalWire DataSphere
+ * API to perform semantic search across uploaded documents.
+ */
+import { SkillBase } from '../SkillBase.js';
+import { SwaigFunctionResult } from '../../SwaigFunctionResult.js';
+/**
+ * Searches SignalWire DataSphere for knowledge base content using semantic search.
+ *
+ * Tier 3 built-in skill. Requires `SIGNALWIRE_PROJECT_ID`, `SIGNALWIRE_TOKEN`,
+ * and `SIGNALWIRE_SPACE` environment variables. Supports `max_results` and
+ * `distance_threshold` config options.
+ */
+export class DataSphereSkill extends SkillBase {
+    /**
+     * @param config - Optional configuration; supports `max_results` and `distance_threshold`.
+     */
+    constructor(config) {
+        super('datasphere', config);
+    }
+    /** @returns Manifest declaring SignalWire credentials as required env vars. */
+    getManifest() {
+        return {
+            name: 'datasphere',
+            description: 'Searches SignalWire DataSphere for knowledge base content using semantic search across uploaded documents.',
+            version: '1.0.0',
+            author: 'SignalWire',
+            tags: ['search', 'datasphere', 'signalwire', 'knowledge', 'rag', 'external'],
+            requiredEnvVars: ['SIGNALWIRE_PROJECT_ID', 'SIGNALWIRE_TOKEN', 'SIGNALWIRE_SPACE'],
+            configSchema: {
+                max_results: {
+                    type: 'number',
+                    description: 'Maximum number of results to return. Defaults to 5.',
+                    default: 5,
+                },
+                distance_threshold: {
+                    type: 'number',
+                    description: 'Maximum distance threshold for results (0-1, lower is more similar). Defaults to 0.7.',
+                    default: 0.7,
+                },
+            },
+        };
+    }
+    /** @returns A single `search_datasphere` tool that performs semantic search on uploaded documents. */
+    getTools() {
+        const maxResults = this.getConfig('max_results', 5);
+        const distanceThreshold = this.getConfig('distance_threshold', 0.7);
+        return [
+            {
+                name: 'search_datasphere',
+                description: 'Search the SignalWire DataSphere knowledge base for relevant information. Returns the most relevant text chunks from uploaded documents.',
+                parameters: {
+                    query: {
+                        type: 'string',
+                        description: 'The question or topic to search for in the knowledge base.',
+                    },
+                    document_id: {
+                        type: 'string',
+                        description: 'Optional: limit search to a specific document by its ID.',
+                    },
+                },
+                required: ['query'],
+                handler: async (args) => {
+                    const query = args.query;
+                    const documentId = args.document_id;
+                    if (!query || typeof query !== 'string' || query.trim().length === 0) {
+                        return new SwaigFunctionResult('Please provide a query to search the knowledge base.');
+                    }
+                    const projectId = process.env['SIGNALWIRE_PROJECT_ID'];
+                    const token = process.env['SIGNALWIRE_TOKEN'];
+                    const space = process.env['SIGNALWIRE_SPACE'];
+                    if (!projectId || !token || !space) {
+                        return new SwaigFunctionResult('DataSphere is not configured. The SIGNALWIRE_PROJECT_ID, SIGNALWIRE_TOKEN, and SIGNALWIRE_SPACE environment variables are required.');
+                    }
+                    try {
+                        const spaceHost = space.includes('.') ? space : `${space}.signalwire.com`;
+                        const url = `https://${spaceHost}/api/datasphere/documents/search`;
+                        const requestBody = {
+                            query: query.trim(),
+                            count: maxResults,
+                            distance: distanceThreshold,
+                        };
+                        if (documentId && typeof documentId === 'string' && documentId.trim().length > 0) {
+                            requestBody['document_id'] = documentId.trim();
+                        }
+                        const authHeader = Buffer.from(`${projectId}:${token}`).toString('base64');
+                        const response = await fetch(url, {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                                'Authorization': `Basic ${authHeader}`,
+                            },
+                            body: JSON.stringify(requestBody),
+                        });
+                        if (!response.ok) {
+                            const errorText = await response.text();
+                            let errorMsg;
+                            try {
+                                const errorData = JSON.parse(errorText);
+                                errorMsg = errorData.error ?? errorData.message ?? `HTTP ${response.status}`;
+                            }
+                            catch {
+                                errorMsg = `HTTP ${response.status}: ${errorText.slice(0, 200)}`;
+                            }
+                            return new SwaigFunctionResult(`DataSphere search failed: ${errorMsg}`);
+                        }
+                        const data = (await response.json());
+                        if (!data.results || data.results.length === 0) {
+                            return new SwaigFunctionResult(`No relevant results found in the knowledge base for "${query}".`);
+                        }
+                        const parts = [
+                            `Knowledge base results for "${query}" (${data.results.length} results):`,
+                            '',
+                        ];
+                        for (let i = 0; i < data.results.length; i++) {
+                            const result = data.results[i];
+                            const score = (1 - result.score).toFixed(2);
+                            parts.push(`--- Result ${i + 1} (relevance: ${score}) ---`);
+                            parts.push(result.text.trim());
+                            if (result.document_id) {
+                                parts.push(`[Document: ${result.document_id}]`);
+                            }
+                            parts.push('');
+                        }
+                        return new SwaigFunctionResult(parts.join('\n').trim());
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        return new SwaigFunctionResult(`Failed to search DataSphere for "${query}": ${message}`);
+                    }
+                },
+            },
+        ];
+    }
+    /** @returns Prompt section describing DataSphere knowledge base search capabilities. */
+    getPromptSections() {
+        return [
+            {
+                title: 'Knowledge Base Search (DataSphere)',
+                body: 'You have access to a knowledge base of documents that can be searched for relevant information.',
+                bullets: [
+                    'Use the search_datasphere tool when the user asks questions that might be answered by internal documentation or uploaded knowledge.',
+                    'Results are ranked by relevance. Higher relevance scores indicate better matches.',
+                    'You can optionally search within a specific document by providing its ID.',
+                    'Synthesize information from multiple results when appropriate.',
+                    'If no results are found, let the user know and suggest rephrasing their question.',
+                ],
+            },
+        ];
+    }
+}
+/**
+ * Factory function for creating DataSphereSkill instances.
+ * @param config - Optional skill configuration.
+ * @returns A new DataSphereSkill instance.
+ */
+export function createSkill(config) {
+    return new DataSphereSkill(config);
+}
+//# sourceMappingURL=datasphere.js.map

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

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

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

@@ -0,0 +1,54 @@
+/**
+ * DataSphere Serverless Skill - Searches SignalWire DataSphere using a DataMap.
+ *
+ * Tier 3 built-in skill: requires SIGNALWIRE_PROJECT_ID, SIGNALWIRE_TOKEN,
+ * and SIGNALWIRE_SPACE environment variables. Unlike the standard datasphere
+ * skill, this uses a DataMap to execute the search server-side without
+ * requiring a webhook endpoint. Ideal for serverless or edge deployments.
+ */
+import { SkillBase } from '../SkillBase.js';
+import type { SkillManifest, SkillToolDefinition, SkillPromptSection, SkillConfig } from '../SkillBase.js';
+/**
+ * Searches SignalWire DataSphere using a server-side DataMap for serverless execution.
+ *
+ * Tier 3 built-in skill. Requires `SIGNALWIRE_PROJECT_ID`, `SIGNALWIRE_TOKEN`,
+ * and `SIGNALWIRE_SPACE` environment variables. Unlike the standard DataSphere
+ * skill, this generates a DataMap configuration that SignalWire executes directly
+ * without needing a webhook endpoint. Supports `max_results`, `distance_threshold`,
+ * and `document_id` config options.
+ */
+export declare class DataSphereServerlessSkill extends SkillBase {
+    /**
+     * @param config - Optional configuration; supports `max_results`, `distance_threshold`, `document_id`.
+     */
+    constructor(config?: SkillConfig);
+    /** @returns Manifest declaring SignalWire credentials as required env vars. */
+    getManifest(): SkillManifest;
+    /**
+     * Build the DataMap-based SWAIG function definition for server-side
+     * DataSphere search. This generates a data_map configuration that
+     * SignalWire executes directly, without needing a webhook callback.
+     */
+    private buildDataMapFunction;
+    /**
+     * Return a stub tool definition since this skill uses DataMap-based execution.
+     * The actual DataMap function is provided by getDataMapTools().
+     * @returns A single stub `search_datasphere` tool that explains its DataMap nature.
+     */
+    getTools(): SkillToolDefinition[];
+    /**
+     * Get DataMap-based tool definitions for server-side execution.
+     * These are registered directly in the SWML output as data_map functions
+     * rather than as webhook-backed SWAIG tools.
+     * @returns Array containing the DataSphere search DataMap function definition.
+     */
+    getDataMapTools(): Record<string, unknown>[];
+    /** @returns Prompt section describing serverless DataSphere search capabilities. */
+    getPromptSections(): SkillPromptSection[];
+}
+/**
+ * Factory function for creating DataSphereServerlessSkill instances.
+ * @param config - Optional skill configuration.
+ * @returns A new DataSphereServerlessSkill instance.
+ */
+export declare function createSkill(config?: SkillConfig): DataSphereServerlessSkill;

package/dist/skills/builtin/datasphere_serverless.js

@@ -0,0 +1,155 @@
+/**
+ * DataSphere Serverless Skill - Searches SignalWire DataSphere using a DataMap.
+ *
+ * Tier 3 built-in skill: requires SIGNALWIRE_PROJECT_ID, SIGNALWIRE_TOKEN,
+ * and SIGNALWIRE_SPACE environment variables. Unlike the standard datasphere
+ * skill, this uses a DataMap to execute the search server-side without
+ * requiring a webhook endpoint. Ideal for serverless or edge deployments.
+ */
+import { SkillBase } from '../SkillBase.js';
+import { SwaigFunctionResult } from '../../SwaigFunctionResult.js';
+import { DataMap } from '../../DataMap.js';
+/**
+ * Searches SignalWire DataSphere using a server-side DataMap for serverless execution.
+ *
+ * Tier 3 built-in skill. Requires `SIGNALWIRE_PROJECT_ID`, `SIGNALWIRE_TOKEN`,
+ * and `SIGNALWIRE_SPACE` environment variables. Unlike the standard DataSphere
+ * skill, this generates a DataMap configuration that SignalWire executes directly
+ * without needing a webhook endpoint. Supports `max_results`, `distance_threshold`,
+ * and `document_id` config options.
+ */
+export class DataSphereServerlessSkill extends SkillBase {
+    /**
+     * @param config - Optional configuration; supports `max_results`, `distance_threshold`, `document_id`.
+     */
+    constructor(config) {
+        super('datasphere_serverless', config);
+    }
+    /** @returns Manifest declaring SignalWire credentials as required env vars. */
+    getManifest() {
+        return {
+            name: 'datasphere_serverless',
+            description: 'Searches SignalWire DataSphere using a server-side DataMap. No webhook endpoint required; executes entirely on the SignalWire platform.',
+            version: '1.0.0',
+            author: 'SignalWire',
+            tags: ['search', 'datasphere', 'signalwire', 'knowledge', 'rag', 'serverless', 'datamap'],
+            requiredEnvVars: ['SIGNALWIRE_PROJECT_ID', 'SIGNALWIRE_TOKEN', 'SIGNALWIRE_SPACE'],
+            configSchema: {
+                max_results: {
+                    type: 'number',
+                    description: 'Maximum number of results to return. Defaults to 5.',
+                    default: 5,
+                },
+                distance_threshold: {
+                    type: 'number',
+                    description: 'Maximum distance threshold for results (0-1, lower is more similar). Defaults to 0.7.',
+                    default: 0.7,
+                },
+                document_id: {
+                    type: 'string',
+                    description: 'Optional: restrict search to a specific document ID.',
+                },
+            },
+        };
+    }
+    /**
+     * Build the DataMap-based SWAIG function definition for server-side
+     * DataSphere search. This generates a data_map configuration that
+     * SignalWire executes directly, without needing a webhook callback.
+     */
+    buildDataMapFunction() {
+        const maxResults = this.getConfig('max_results', 5);
+        const distanceThreshold = this.getConfig('distance_threshold', 0.7);
+        const documentId = this.getConfig('document_id', undefined);
+        const dm = new DataMap('search_datasphere');
+        dm.enableEnvExpansion(true);
+        dm.purpose('Search the SignalWire DataSphere knowledge base for relevant information. ' +
+            'Returns the most relevant text chunks from uploaded documents.');
+        dm.parameter('query', 'string', 'The question or topic to search for in the knowledge base.', {
+            required: true,
+        });
+        // Build the request body
+        const requestBody = {
+            query: '%{args.query}',
+            count: maxResults,
+            distance: distanceThreshold,
+        };
+        if (documentId) {
+            requestBody['document_id'] = documentId;
+        }
+        // Configure the webhook to call the DataSphere API
+        dm.webhook('POST', 'https://${ENV.SIGNALWIRE_SPACE}.signalwire.com/api/datasphere/documents/search', {
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': 'Basic ${ENV.SIGNALWIRE_AUTH}',
+            },
+        });
+        dm.body(requestBody);
+        dm.output(new SwaigFunctionResult('Knowledge base results for the query: %{array[0].text} %{array[1].text} %{array[2].text}'));
+        dm.errorKeys(['error', 'message']);
+        dm.fallbackOutput(new SwaigFunctionResult('No relevant results found in the knowledge base. Try rephrasing your question.'));
+        return dm.toSwaigFunction();
+    }
+    /**
+     * Return a stub tool definition since this skill uses DataMap-based execution.
+     * The actual DataMap function is provided by getDataMapTools().
+     * @returns A single stub `search_datasphere` tool that explains its DataMap nature.
+     */
+    getTools() {
+        // DataMap-based skills do not use handler-based tools.
+        // The tool is provided via getDataMapTools() instead.
+        // We return a stub handler that explains this to prevent confusion
+        // if something tries to invoke it as a regular tool.
+        return [
+            {
+                name: 'search_datasphere',
+                description: 'Search the SignalWire DataSphere knowledge base for relevant information. (Serverless DataMap mode)',
+                parameters: {
+                    query: {
+                        type: 'string',
+                        description: 'The question or topic to search for in the knowledge base.',
+                    },
+                },
+                required: ['query'],
+                handler: () => {
+                    return new SwaigFunctionResult('This tool is configured for serverless DataMap execution. ' +
+                        'It should be registered as a data_map function, not invoked via webhook.');
+                },
+            },
+        ];
+    }
+    /**
+     * Get DataMap-based tool definitions for server-side execution.
+     * These are registered directly in the SWML output as data_map functions
+     * rather than as webhook-backed SWAIG tools.
+     * @returns Array containing the DataSphere search DataMap function definition.
+     */
+    getDataMapTools() {
+        return [this.buildDataMapFunction()];
+    }
+    /** @returns Prompt section describing serverless DataSphere search capabilities. */
+    getPromptSections() {
+        return [
+            {
+                title: 'Knowledge Base Search (DataSphere - Serverless)',
+                body: 'You have access to a knowledge base of documents that can be searched for relevant information. Searches are executed server-side for optimal performance.',
+                bullets: [
+                    'Use the search_datasphere tool when the user asks questions that might be answered by internal documentation or uploaded knowledge.',
+                    'Results are ranked by relevance and returned automatically.',
+                    'This search runs entirely on the SignalWire platform without requiring external webhooks.',
+                    'Synthesize information from the results when appropriate.',
+                    'If no results are found, let the user know and suggest rephrasing their question.',
+                ],
+            },
+        ];
+    }
+}
+/**
+ * Factory function for creating DataSphereServerlessSkill instances.
+ * @param config - Optional skill configuration.
+ * @returns A new DataSphereServerlessSkill instance.
+ */
+export function createSkill(config) {
+    return new DataSphereServerlessSkill(config);
+}
+//# sourceMappingURL=datasphere_serverless.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * DateTime Skill - Provides current date/time with optional timezone support.
+ *
+ * Tier 1 built-in skill: no external dependencies required.
+ */
+import { SkillBase } from '../SkillBase.js';
+import type { SkillManifest, SkillToolDefinition, SkillPromptSection, SkillConfig } from '../SkillBase.js';
+/**
+ * Provides the current date and time with optional timezone support.
+ *
+ * Tier 1 built-in skill with no external dependencies. Supports all IANA
+ * timezone identifiers via the Intl.DateTimeFormat API.
+ */
+export declare class DateTimeSkill extends SkillBase {
+    /**
+     * @param config - Optional configuration (no config keys used by this skill).
+     */
+    constructor(config?: SkillConfig);
+    /** @returns Manifest with skill metadata and tags. */
+    getManifest(): SkillManifest;
+    /** @returns A single `get_datetime` tool that returns the current date/time in a given timezone. */
+    getTools(): SkillToolDefinition[];
+    /** @returns Prompt section instructing the AI how to use the datetime tool. */
+    getPromptSections(): SkillPromptSection[];
+}
+/**
+ * Factory function for creating DateTimeSkill instances.
+ * @param config - Optional skill configuration.
+ * @returns A new DateTimeSkill instance.
+ */
+export declare function createSkill(config?: SkillConfig): DateTimeSkill;

package/dist/skills/builtin/datetime.js

@@ -0,0 +1,95 @@
+/**
+ * DateTime Skill - Provides current date/time with optional timezone support.
+ *
+ * Tier 1 built-in skill: no external dependencies required.
+ */
+import { SkillBase } from '../SkillBase.js';
+import { SwaigFunctionResult } from '../../SwaigFunctionResult.js';
+/**
+ * Provides the current date and time with optional timezone support.
+ *
+ * Tier 1 built-in skill with no external dependencies. Supports all IANA
+ * timezone identifiers via the Intl.DateTimeFormat API.
+ */
+export class DateTimeSkill extends SkillBase {
+    /**
+     * @param config - Optional configuration (no config keys used by this skill).
+     */
+    constructor(config) {
+        super('datetime', config);
+    }
+    /** @returns Manifest with skill metadata and tags. */
+    getManifest() {
+        return {
+            name: 'datetime',
+            description: 'Provides current date and time information with timezone support.',
+            version: '1.0.0',
+            tags: ['utility', 'datetime', 'timezone'],
+        };
+    }
+    /** @returns A single `get_datetime` tool that returns the current date/time in a given timezone. */
+    getTools() {
+        return [
+            {
+                name: 'get_datetime',
+                description: 'Get the current date and time. Optionally specify a timezone to get the time in that timezone.',
+                parameters: {
+                    timezone: {
+                        type: 'string',
+                        description: 'IANA timezone identifier (e.g., America/New_York, Europe/London, Asia/Tokyo). Defaults to UTC if not specified.',
+                    },
+                },
+                handler: (args) => {
+                    const timezone = args.timezone ?? 'UTC';
+                    const now = new Date();
+                    try {
+                        const dateFormatter = new Intl.DateTimeFormat('en-US', {
+                            timeZone: timezone,
+                            weekday: 'long',
+                            year: 'numeric',
+                            month: 'long',
+                            day: 'numeric',
+                        });
+                        const timeFormatter = new Intl.DateTimeFormat('en-US', {
+                            timeZone: timezone,
+                            hour: '2-digit',
+                            minute: '2-digit',
+                            second: '2-digit',
+                            hour12: true,
+                            timeZoneName: 'short',
+                        });
+                        const dateStr = dateFormatter.format(now);
+                        const timeStr = timeFormatter.format(now);
+                        return new SwaigFunctionResult(`The current date and time in ${timezone} is: ${dateStr}, ${timeStr}.`);
+                    }
+                    catch {
+                        return new SwaigFunctionResult(`Invalid timezone "${timezone}". Please use a valid IANA timezone identifier such as America/New_York, Europe/London, or Asia/Tokyo.`);
+                    }
+                },
+            },
+        ];
+    }
+    /** @returns Prompt section instructing the AI how to use the datetime tool. */
+    getPromptSections() {
+        return [
+            {
+                title: 'Date and Time',
+                body: 'You have the ability to check the current date and time.',
+                bullets: [
+                    'Use the get_datetime tool to retrieve the current date and time.',
+                    'You can specify a timezone using IANA timezone identifiers (e.g., America/New_York, Europe/London, Asia/Tokyo).',
+                    'If no timezone is specified, UTC is used by default.',
+                ],
+            },
+        ];
+    }
+}
+/**
+ * Factory function for creating DateTimeSkill instances.
+ * @param config - Optional skill configuration.
+ * @returns A new DateTimeSkill instance.
+ */
+export function createSkill(config) {
+    return new DateTimeSkill(config);
+}
+//# sourceMappingURL=datetime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../../../src/skills/builtin/datetime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C;;OAEG;IACH,YAAY,MAAoB;QAC9B,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,sDAAsD;IACtD,WAAW;QACT,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,mEAAmE;YAChF,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED,oGAAoG;IACpG,QAAQ;QACN,OAAO;YACL;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EACT,gGAAgG;gBAClG,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,iHAAiH;qBACpH;iBACF;gBACD,OAAO,EAAE,CAAC,IAA6B,EAAE,EAAE;oBACzC,MAAM,QAAQ,GAAI,IAAI,CAAC,QAA+B,IAAI,KAAK,CAAC;oBAChE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;oBAEvB,IAAI,CAAC;wBACH,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;4BACrD,QAAQ,EAAE,QAAQ;4BAClB,OAAO,EAAE,MAAM;4BACf,IAAI,EAAE,SAAS;4BACf,KAAK,EAAE,MAAM;4BACb,GAAG,EAAE,SAAS;yBACf,CAAC,CAAC;wBAEH,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;4BACrD,QAAQ,EAAE,QAAQ;4BAClB,IAAI,EAAE,SAAS;4BACf,MAAM,EAAE,SAAS;4BACjB,MAAM,EAAE,SAAS;4BACjB,MAAM,EAAE,IAAI;4BACZ,YAAY,EAAE,OAAO;yBACtB,CAAC,CAAC;wBAEH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBAC1C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBAE1C,OAAO,IAAI,mBAAmB,CAC5B,gCAAgC,QAAQ,QAAQ,OAAO,KAAK,OAAO,GAAG,CACvE,CAAC;oBACJ,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,IAAI,mBAAmB,CAC5B,qBAAqB,QAAQ,wGAAwG,CACtI,CAAC;oBACJ,CAAC;gBACH,CAAC;aACF;SACF,CAAC;IACJ,CAAC;IAED,+EAA+E;IAC/E,iBAAiB;QACf,OAAO;YACL;gBACE,KAAK,EAAE,eAAe;gBACtB,IAAI,EAAE,0DAA0D;gBAChE,OAAO,EAAE;oBACP,kEAAkE;oBAClE,iHAAiH;oBACjH,sDAAsD;iBACvD;aACF;SACF,CAAC;IACJ,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * 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 type { SkillManifest, SkillToolDefinition, SkillPromptSection, SkillConfig } from '../SkillBase.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 declare class GoogleMapsSkill extends SkillBase {
+    /**
+     * @param config - Optional configuration; supports `default_mode` for travel mode.
+     */
+    constructor(config?: SkillConfig);
+    /** @returns Manifest declaring GOOGLE_MAPS_API_KEY as required and config schema for default_mode. */
+    getManifest(): SkillManifest;
+    /** @returns Two tools: `get_directions` for route info and `find_place` for place discovery. */
+    getTools(): SkillToolDefinition[];
+    /** @returns Prompt section describing directions and place search capabilities. */
+    getPromptSections(): SkillPromptSection[];
+}
+/**
+ * Factory function for creating GoogleMapsSkill instances.
+ * @param config - Optional skill configuration.
+ * @returns A new GoogleMapsSkill instance.
+ */
+export declare function createSkill(config?: SkillConfig): GoogleMapsSkill;