signalwire-agents 0.1.0

package/dist/ContextBuilder.js.map

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

package/dist/DataMap.d.ts

@@ -0,0 +1,179 @@
+/**
+ * DataMap - Fluent builder for SWAIG data_map configurations.
+ *
+ * Creates server-side tool definitions that execute on SignalWire
+ * without requiring webhook endpoints.
+ */
+import { SwaigFunctionResult } from './SwaigFunctionResult.js';
+/**
+ * Fluent builder for SWAIG data_map configurations.
+ *
+ * Creates server-side tool definitions that execute on SignalWire
+ * without requiring webhook endpoints.
+ */
+export declare class DataMap {
+    /** The name of the SWAIG function this data map defines. */
+    functionName: string;
+    private _purpose;
+    private _parameters;
+    private _expressions;
+    private _webhooks;
+    private _output;
+    private _errorKeys;
+    private _expandEnv;
+    /**
+     * @param functionName - The unique name for this data map tool.
+     */
+    constructor(functionName: string);
+    /**
+     * Enable `${ENV.*}` variable expansion in URLs, bodies, and outputs.
+     * @param enabled - Whether to enable expansion (defaults to true).
+     * @returns This instance for chaining.
+     */
+    enableEnvExpansion(enabled?: boolean): this;
+    /**
+     * Set the purpose (description) of this data map tool shown to the AI.
+     * @param description - A human-readable description of the tool.
+     * @returns This instance for chaining.
+     */
+    purpose(description: string): this;
+    /**
+     * Alias for {@link purpose}; sets the tool description.
+     * @param description - A human-readable description of the tool.
+     * @returns This instance for chaining.
+     */
+    description(description: string): this;
+    /**
+     * Define a parameter for this data map tool.
+     * @param name - The parameter name.
+     * @param paramType - The JSON Schema type (e.g., "string", "number").
+     * @param description - A description of the parameter shown to the AI.
+     * @param opts - Optional flags for required and enum constraints.
+     * @returns This instance for chaining.
+     */
+    parameter(name: string, paramType: string, description: string, opts?: {
+        required?: boolean;
+        enum?: string[];
+    }): this;
+    /**
+     * Add a pattern-matching expression that evaluates a test value against a regex.
+     * @param testValue - The string or template variable to test.
+     * @param pattern - A regex pattern (string or RegExp) to match against.
+     * @param output - The result to return when the pattern matches.
+     * @param nomatchOutput - Optional result to return when the pattern does not match.
+     * @returns This instance for chaining.
+     */
+    expression(testValue: string, pattern: string | RegExp, output: SwaigFunctionResult, nomatchOutput?: SwaigFunctionResult): this;
+    /**
+     * Add a webhook that is called when this data map tool is invoked.
+     * @param method - HTTP method (e.g., "GET", "POST").
+     * @param url - The webhook URL to call.
+     * @param opts - Optional headers, form parameter name, and argument settings.
+     * @returns This instance for chaining.
+     */
+    webhook(method: string, url: string, opts?: {
+        headers?: Record<string, string>;
+        formParam?: string;
+        inputArgsAsParams?: boolean;
+        requireArgs?: string[];
+    }): this;
+    /**
+     * Set pattern-matching expressions on the most recently added webhook.
+     * @param expressions - Array of expression objects to evaluate against the webhook response.
+     * @returns This instance for chaining.
+     */
+    webhookExpressions(expressions: Record<string, unknown>[]): this;
+    /**
+     * Set the JSON body for the most recently added webhook.
+     * @param data - The request body object.
+     * @returns This instance for chaining.
+     */
+    body(data: Record<string, unknown>): this;
+    /**
+     * Set query or form parameters for the most recently added webhook.
+     * @param data - The parameters object.
+     * @returns This instance for chaining.
+     */
+    params(data: Record<string, unknown>): this;
+    /**
+     * Configure iteration over an array in the webhook response.
+     * @param config - Foreach configuration with input/output keys, append template, and optional max.
+     * @returns This instance for chaining.
+     */
+    foreach(config: {
+        input_key: string;
+        output_key: string;
+        append: string;
+        max?: number;
+    }): this;
+    /**
+     * Set the output template for the most recently added webhook.
+     * @param result - The SwaigFunctionResult to use as the output template.
+     * @returns This instance for chaining.
+     */
+    output(result: SwaigFunctionResult): this;
+    /**
+     * Set a fallback output used when no webhook or expression matches.
+     * @param result - The SwaigFunctionResult to use as the fallback.
+     * @returns This instance for chaining.
+     */
+    fallbackOutput(result: SwaigFunctionResult): this;
+    /**
+     * Set error keys on the most recently added webhook, or globally if no webhook exists.
+     * @param keys - Response keys that indicate an error occurred.
+     * @returns This instance for chaining.
+     */
+    errorKeys(keys: string[]): this;
+    /**
+     * Set error keys at the top-level data map scope, regardless of webhook context.
+     * @param keys - Response keys that indicate an error occurred.
+     * @returns This instance for chaining.
+     */
+    globalErrorKeys(keys: string[]): this;
+    /**
+     * Register this DataMap tool with an AgentBase instance.
+     * @param agent - An object with a registerSwaigFunction method (typically an AgentBase).
+     * @returns This instance for chaining.
+     */
+    registerWithAgent(agent: {
+        registerSwaigFunction(fn: Record<string, unknown>): unknown;
+    }): this;
+    /**
+     * Serialize this data map to a SWAIG function definition object.
+     * @returns A plain object suitable for inclusion in the SWML SWAIG array.
+     */
+    toSwaigFunction(): Record<string, unknown>;
+}
+/**
+ * Create a DataMap tool that calls a single API endpoint and formats the response.
+ * @param opts - Configuration including name, URL, response template, and optional parameters.
+ * @returns A configured DataMap instance ready for registration.
+ */
+export declare function createSimpleApiTool(opts: {
+    name: string;
+    url: string;
+    responseTemplate: string;
+    parameters?: Record<string, {
+        type?: string;
+        description?: string;
+        required?: boolean;
+    }>;
+    method?: string;
+    headers?: Record<string, string>;
+    body?: Record<string, unknown>;
+    errorKeys?: string[];
+}): DataMap;
+/**
+ * Create a DataMap tool that evaluates expressions against patterns without making HTTP calls.
+ * @param opts - Configuration including name, pattern-result pairs, and optional parameters.
+ * @returns A configured DataMap instance ready for registration.
+ */
+export declare function createExpressionTool(opts: {
+    name: string;
+    patterns: Record<string, [string, SwaigFunctionResult]>;
+    parameters?: Record<string, {
+        type?: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}): DataMap;

package/dist/DataMap.js

@@ -0,0 +1,321 @@
+/**
+ * DataMap - Fluent builder for SWAIG data_map configurations.
+ *
+ * Creates server-side tool definitions that execute on SignalWire
+ * without requiring webhook endpoints.
+ */
+import { SwaigFunctionResult } from './SwaigFunctionResult.js';
+const ENV_PATTERN = /\$\{ENV\.([^}]+)\}/g;
+function expandEnvVars(value) {
+    return value.replace(ENV_PATTERN, (_match, varName) => {
+        return process.env[varName] ?? '';
+    });
+}
+function expandEnvInObject(obj) {
+    if (typeof obj === 'string')
+        return expandEnvVars(obj);
+    if (Array.isArray(obj))
+        return obj.map(expandEnvInObject);
+    if (obj && typeof obj === 'object') {
+        const result = {};
+        for (const [k, v] of Object.entries(obj)) {
+            result[k] = expandEnvInObject(v);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Fluent builder for SWAIG data_map configurations.
+ *
+ * Creates server-side tool definitions that execute on SignalWire
+ * without requiring webhook endpoints.
+ */
+export class DataMap {
+    /** The name of the SWAIG function this data map defines. */
+    functionName;
+    _purpose = '';
+    _parameters = {};
+    _expressions = [];
+    _webhooks = [];
+    _output = null;
+    _errorKeys = [];
+    _expandEnv = false;
+    /**
+     * @param functionName - The unique name for this data map tool.
+     */
+    constructor(functionName) {
+        this.functionName = functionName;
+    }
+    /**
+     * Enable `${ENV.*}` variable expansion in URLs, bodies, and outputs.
+     * @param enabled - Whether to enable expansion (defaults to true).
+     * @returns This instance for chaining.
+     */
+    enableEnvExpansion(enabled = true) {
+        this._expandEnv = enabled;
+        return this;
+    }
+    /**
+     * Set the purpose (description) of this data map tool shown to the AI.
+     * @param description - A human-readable description of the tool.
+     * @returns This instance for chaining.
+     */
+    purpose(description) {
+        this._purpose = description;
+        return this;
+    }
+    /**
+     * Alias for {@link purpose}; sets the tool description.
+     * @param description - A human-readable description of the tool.
+     * @returns This instance for chaining.
+     */
+    description(description) {
+        return this.purpose(description);
+    }
+    /**
+     * Define a parameter for this data map tool.
+     * @param name - The parameter name.
+     * @param paramType - The JSON Schema type (e.g., "string", "number").
+     * @param description - A description of the parameter shown to the AI.
+     * @param opts - Optional flags for required and enum constraints.
+     * @returns This instance for chaining.
+     */
+    parameter(name, paramType, description, opts) {
+        const paramDef = { type: paramType, description };
+        if (opts?.enum)
+            paramDef['enum'] = opts.enum;
+        this._parameters[name] = paramDef;
+        if (opts?.required) {
+            if (!this._parameters['_required']) {
+                this._parameters['_required'] = [];
+            }
+            const req = this._parameters['_required'];
+            if (!req.includes(name))
+                req.push(name);
+        }
+        return this;
+    }
+    /**
+     * Add a pattern-matching expression that evaluates a test value against a regex.
+     * @param testValue - The string or template variable to test.
+     * @param pattern - A regex pattern (string or RegExp) to match against.
+     * @param output - The result to return when the pattern matches.
+     * @param nomatchOutput - Optional result to return when the pattern does not match.
+     * @returns This instance for chaining.
+     */
+    expression(testValue, pattern, output, nomatchOutput) {
+        const patternStr = typeof pattern === 'string' ? pattern : pattern.source;
+        const expr = {
+            string: testValue,
+            pattern: patternStr,
+            output: output.toDict(),
+        };
+        if (nomatchOutput) {
+            expr['nomatch-output'] = nomatchOutput.toDict();
+        }
+        this._expressions.push(expr);
+        return this;
+    }
+    /**
+     * Add a webhook that is called when this data map tool is invoked.
+     * @param method - HTTP method (e.g., "GET", "POST").
+     * @param url - The webhook URL to call.
+     * @param opts - Optional headers, form parameter name, and argument settings.
+     * @returns This instance for chaining.
+     */
+    webhook(method, url, opts) {
+        const def = { url, method: method.toUpperCase() };
+        if (opts?.headers)
+            def['headers'] = opts.headers;
+        if (opts?.formParam)
+            def['form_param'] = opts.formParam;
+        if (opts?.inputArgsAsParams)
+            def['input_args_as_params'] = true;
+        if (opts?.requireArgs)
+            def['require_args'] = opts.requireArgs;
+        this._webhooks.push(def);
+        return this;
+    }
+    /**
+     * Set pattern-matching expressions on the most recently added webhook.
+     * @param expressions - Array of expression objects to evaluate against the webhook response.
+     * @returns This instance for chaining.
+     */
+    webhookExpressions(expressions) {
+        if (!this._webhooks.length)
+            throw new Error('Must add webhook before setting webhook expressions');
+        this._webhooks[this._webhooks.length - 1]['expressions'] = expressions;
+        return this;
+    }
+    /**
+     * Set the JSON body for the most recently added webhook.
+     * @param data - The request body object.
+     * @returns This instance for chaining.
+     */
+    body(data) {
+        if (!this._webhooks.length)
+            throw new Error('Must add webhook before setting body');
+        this._webhooks[this._webhooks.length - 1]['body'] = data;
+        return this;
+    }
+    /**
+     * Set query or form parameters for the most recently added webhook.
+     * @param data - The parameters object.
+     * @returns This instance for chaining.
+     */
+    params(data) {
+        if (!this._webhooks.length)
+            throw new Error('Must add webhook before setting params');
+        this._webhooks[this._webhooks.length - 1]['params'] = data;
+        return this;
+    }
+    /**
+     * Configure iteration over an array in the webhook response.
+     * @param config - Foreach configuration with input/output keys, append template, and optional max.
+     * @returns This instance for chaining.
+     */
+    foreach(config) {
+        if (!this._webhooks.length)
+            throw new Error('Must add webhook before setting foreach');
+        this._webhooks[this._webhooks.length - 1]['foreach'] = config;
+        return this;
+    }
+    /**
+     * Set the output template for the most recently added webhook.
+     * @param result - The SwaigFunctionResult to use as the output template.
+     * @returns This instance for chaining.
+     */
+    output(result) {
+        if (!this._webhooks.length)
+            throw new Error('Must add webhook before setting output');
+        this._webhooks[this._webhooks.length - 1]['output'] = result.toDict();
+        return this;
+    }
+    /**
+     * Set a fallback output used when no webhook or expression matches.
+     * @param result - The SwaigFunctionResult to use as the fallback.
+     * @returns This instance for chaining.
+     */
+    fallbackOutput(result) {
+        this._output = result.toDict();
+        return this;
+    }
+    /**
+     * Set error keys on the most recently added webhook, or globally if no webhook exists.
+     * @param keys - Response keys that indicate an error occurred.
+     * @returns This instance for chaining.
+     */
+    errorKeys(keys) {
+        if (this._webhooks.length) {
+            this._webhooks[this._webhooks.length - 1]['error_keys'] = keys;
+        }
+        else {
+            this._errorKeys = keys;
+        }
+        return this;
+    }
+    /**
+     * Set error keys at the top-level data map scope, regardless of webhook context.
+     * @param keys - Response keys that indicate an error occurred.
+     * @returns This instance for chaining.
+     */
+    globalErrorKeys(keys) {
+        this._errorKeys = keys;
+        return this;
+    }
+    /**
+     * Register this DataMap tool with an AgentBase instance.
+     * @param agent - An object with a registerSwaigFunction method (typically an AgentBase).
+     * @returns This instance for chaining.
+     */
+    registerWithAgent(agent) {
+        agent.registerSwaigFunction(this.toSwaigFunction());
+        return this;
+    }
+    /**
+     * Serialize this data map to a SWAIG function definition object.
+     * @returns A plain object suitable for inclusion in the SWML SWAIG array.
+     */
+    toSwaigFunction() {
+        // Build parameter schema
+        let paramSchema;
+        const paramKeys = Object.keys(this._parameters).filter((k) => k !== '_required');
+        if (paramKeys.length) {
+            const properties = {};
+            for (const k of paramKeys) {
+                properties[k] = this._parameters[k];
+            }
+            paramSchema = { type: 'object', properties };
+            const required = this._parameters['_required'];
+            if (required?.length)
+                paramSchema['required'] = required;
+        }
+        else {
+            paramSchema = { type: 'object', properties: {} };
+        }
+        // Build data_map
+        const dataMap = {};
+        if (this._expressions.length)
+            dataMap['expressions'] = this._expressions;
+        if (this._webhooks.length)
+            dataMap['webhooks'] = this._webhooks;
+        if (this._output)
+            dataMap['output'] = this._output;
+        if (this._errorKeys.length)
+            dataMap['error_keys'] = this._errorKeys;
+        let result = {
+            function: this.functionName,
+            description: this._purpose || `Execute ${this.functionName}`,
+            parameters: paramSchema,
+            data_map: dataMap,
+        };
+        if (this._expandEnv) {
+            result = expandEnvInObject(result);
+        }
+        return result;
+    }
+}
+// ── Helper functions ────────────────────────────────────────────────────
+/**
+ * Create a DataMap tool that calls a single API endpoint and formats the response.
+ * @param opts - Configuration including name, URL, response template, and optional parameters.
+ * @returns A configured DataMap instance ready for registration.
+ */
+export function createSimpleApiTool(opts) {
+    const dm = new DataMap(opts.name);
+    if (opts.parameters) {
+        for (const [name, def] of Object.entries(opts.parameters)) {
+            dm.parameter(name, def.type ?? 'string', def.description ?? `${name} parameter`, {
+                required: def.required,
+            });
+        }
+    }
+    dm.webhook(opts.method ?? 'GET', opts.url, { headers: opts.headers });
+    if (opts.body)
+        dm.body(opts.body);
+    if (opts.errorKeys)
+        dm.errorKeys(opts.errorKeys);
+    dm.output(new SwaigFunctionResult(opts.responseTemplate));
+    return dm;
+}
+/**
+ * Create a DataMap tool that evaluates expressions against patterns without making HTTP calls.
+ * @param opts - Configuration including name, pattern-result pairs, and optional parameters.
+ * @returns A configured DataMap instance ready for registration.
+ */
+export function createExpressionTool(opts) {
+    const dm = new DataMap(opts.name);
+    if (opts.parameters) {
+        for (const [name, def] of Object.entries(opts.parameters)) {
+            dm.parameter(name, def.type ?? 'string', def.description ?? `${name} parameter`, {
+                required: def.required,
+            });
+        }
+    }
+    for (const [testValue, [pattern, result]] of Object.entries(opts.patterns)) {
+        dm.expression(testValue, pattern, result);
+    }
+    return dm;
+}
+//# sourceMappingURL=DataMap.js.map

package/dist/DataMap.js.map

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

package/dist/Logger.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Logger - Structured logger with env-var-based configuration.
+ *
+ * SIGNALWIRE_LOG_LEVEL: debug | info | warn | error (default: info)
+ * SIGNALWIRE_LOG_MODE: off to suppress all logging
+ * SIGNALWIRE_LOG_FORMAT: text | json (default: text)
+ * SIGNALWIRE_LOG_COLOR: true | false (default: true when TTY)
+ */
+declare const LEVELS: {
+    readonly debug: 0;
+    readonly info: 1;
+    readonly warn: 2;
+    readonly error: 3;
+};
+/** Log severity level. */
+type LogLevel = keyof typeof LEVELS;
+/** Output format for log entries. */
+type LogFormat = 'text' | 'json';
+/**
+ * Set the minimum log level for all loggers.
+ * @param level - The minimum severity level to emit.
+ */
+export declare function setGlobalLogLevel(level: LogLevel): void;
+/**
+ * Suppress or unsuppress all log output globally.
+ * @param suppress - True to suppress, false to restore (default true).
+ */
+export declare function suppressAllLogs(suppress?: boolean): void;
+/**
+ * Set the output format for all loggers.
+ * @param format - Either 'text' (human-readable) or 'json' (structured).
+ */
+export declare function setGlobalLogFormat(format: LogFormat): void;
+/**
+ * Enable or disable ANSI color codes in text-format output.
+ * @param enabled - True to enable colors, false to disable.
+ */
+export declare function setGlobalLogColor(enabled: boolean): void;
+/** Reset all logging settings to their environment-variable-based defaults. */
+export declare function resetLoggingConfiguration(): void;
+/** Structured logger that respects global level, format, and color settings. */
+export declare class Logger {
+    private name;
+    private context;
+    /**
+     * Create a new Logger instance.
+     * @param name - Logger name shown in log output.
+     * @param context - Optional key-value pairs included in every log entry.
+     */
+    constructor(name: string, context?: Record<string, unknown>);
+    /**
+     * Create a child logger with additional bound context fields merged into the parent's context.
+     * @param context - Key-value pairs to merge into the child logger's context.
+     * @returns A new Logger instance with the merged context.
+     */
+    bind(context: Record<string, unknown>): Logger;
+    /**
+     * Log a message at the debug level.
+     * @param msg - The log message.
+     * @param data - Optional structured data to include.
+     */
+    debug(msg: string, data?: Record<string, unknown>): void;
+    /**
+     * Log a message at the info level.
+     * @param msg - The log message.
+     * @param data - Optional structured data to include.
+     */
+    info(msg: string, data?: Record<string, unknown>): void;
+    /**
+     * Log a message at the warn level.
+     * @param msg - The log message.
+     * @param data - Optional structured data to include.
+     */
+    warn(msg: string, data?: Record<string, unknown>): void;
+    /**
+     * Log a message at the error level.
+     * @param msg - The log message.
+     * @param data - Optional structured data to include.
+     */
+    error(msg: string, data?: Record<string, unknown>): void;
+    private log;
+    private logText;
+    private logJson;
+}
+/**
+ * Create a new Logger instance with the given name.
+ * @param name - Logger name shown in log output.
+ * @returns A new Logger instance.
+ */
+export declare function getLogger(name: string): Logger;
+export {};