@onereach/step-voice 7.0.45 → 7.0.47-VOIC1732knowledgeretrieval.0

package/dst/Idle Music.js

@@ -22,8 +22,8 @@ class IdleMusic extends voice_1.default {
     async runStep() {
         const call = await this.fetchData();
         const { idleDuration, idleMusicDelay, idleMusicEnabled, customIdleMusic, idleMusicUrl } = this.data;
-        const idleDurationMs = (0, timestring_1.default)(lodash_1.default.get(idleDuration, 'input', '30s'), lodash_1.default.get(idleDuration, 'outputMode', 'ms'));
-        const idleMusicDelayMs = (0, timestring_1.default)(lodash_1.default.get(idleMusicDelay, 'input', '3s'), lodash_1.default.get(idleMusicDelay, 'outputMode', 'ms'));
+        const idleDurationMs = (0, timestring_1.default)(lodash_1.default.get(idleDuration, 'input', '30s'), lodash_1.default.get(idleDuration, 'outputMode', 'ms'), {});
+        const idleMusicDelayMs = (0, timestring_1.default)(lodash_1.default.get(idleMusicDelay, 'input', '3s'), lodash_1.default.get(idleMusicDelay, 'outputMode', 'ms'), {});
         const { error: validationError } = await schema.validateAsync({
             idleMusicEnabled,
             customIdleMusic,

package/dst/Subagent Tools Handler.d.ts

@@ -0,0 +1,11 @@
+import VoiceStep from './voice';
+interface INPUT {
+    subagentName?: string;
+}
+export default class SubagentToolsHandler extends VoiceStep<Partial<INPUT>> {
+    runStep(): Promise<void>;
+    private loadToolCallContext;
+    private findExitByLabel;
+    exitToThread(): Promise<void>;
+}
+export {};

package/dst/Subagent Tools Handler.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
+const voice_1 = tslib_1.__importDefault(require("./voice"));
+class SubagentToolsHandler extends voice_1.default {
+    async runStep() {
+        const call = await this.fetchData();
+        const ctx = await this.loadToolCallContext();
+        const toolName = lodash_1.default.trim(String(ctx.name ?? ''));
+        const subagentName = lodash_1.default.trim(String(ctx.subagent ?? this.data.subagentName ?? ''));
+        const arguments_ = (ctx.arguments && typeof ctx.arguments === 'object')
+            ? ctx.arguments
+            : (ctx[toolName] ?? {});
+        const exitId = toolName ? this.findExitByLabel(toolName) : undefined;
+        this.log.info('Subagent Tools Handler: incoming tool_call', {
+            toolName,
+            subagent: subagentName,
+            exitId,
+            threadId: this.thread.id,
+            hasContext: !lodash_1.default.isEmpty(ctx)
+        });
+        if (!exitId) {
+            this.log.warn('Subagent Tools Handler: no exit for tool_call', {
+                name: toolName,
+                subagent: subagentName,
+                exits: (this.step.exits || []).map((e) => e.label)
+            });
+            this.exitFlow();
+            return;
+        }
+        // Same hop as Voice Agent → tool: fork so Voice Agent Tool Result still
+        // finds __voiceAgentContext_ on the child thread. Do not exitFlow() after
+        // this — that would tear down the parent before the tool thread starts.
+        await this.exitStep(exitId, {
+            [toolName]: arguments_,
+            name: toolName,
+            toolCallId: ctx.toolCallId ?? '',
+            arguments: arguments_,
+            subagent: subagentName,
+            __voicecb: ctx.__voicecb,
+            callId: ctx.callId ?? call.id,
+            callType: ctx.callType ?? call.type,
+            callCallback: ctx.callCallback ?? call.callback
+        }, true);
+    }
+    async loadToolCallContext() {
+        const fromState = (this.state?.result && typeof this.state.result === 'object')
+            ? this.state.result
+            : {};
+        let fromThread = {};
+        try {
+            const stored = await this.thread.get(`__voiceAgentContext_${this.thread.id}`);
+            if (stored && typeof stored === 'object')
+                fromThread = stored;
+        }
+        catch {
+            // key absent on this thread — Voice Agent payload may still be in state.result
+        }
+        return { ...fromState, ...fromThread };
+    }
+    findExitByLabel(label) {
+        const needle = lodash_1.default.trim(label);
+        const exit = lodash_1.default.find(this.step.exits, (e) => lodash_1.default.trim(e.label || '') === needle);
+        return exit?.id;
+    }
+    async exitToThread() {
+        const result = this.state.result;
+        await this.thread.set(`__voiceAgentContext_${this.thread.id}`, result);
+        this.thread.exitStep(this.state.exitStep, result);
+    }
+}
+exports.default = SubagentToolsHandler;

package/dst/Update Voice Agent.d.ts

@@ -1,10 +1,13 @@
 import VoiceStep from './voice';
 type SystemInstructionMode = 'append' | 'replace' | 'off';
+type ToolResponseMode = 'sync' | 'async' | 'none';
 interface Tool {
     name: string;
     description: string;
     parameters: string | Record<string, unknown>;
     exitId?: string;
+    timeout_seconds?: number | string | null;
+    response_mode?: ToolResponseMode | string | null;
 }
 interface AgentServiceConfig {
     provider: string;

package/dst/Update Voice Agent.js

@@ -139,12 +139,19 @@ class UpdateVoiceAgent extends voice_1.default {
             else if (t.parameters && typeof t.parameters === 'object') {
                 parameters = t.parameters;
             }
-            return {
+            const tool = {
                 type: 'function',
                 name: lodash_1.default.trim(t.name),
                 description: t.description || '',
                 parameters,
             };
+            if (t.timeout_seconds != null && t.timeout_seconds !== '') {
+                tool.timeout_seconds = Number(t.timeout_seconds);
+            }
+            if (t.response_mode) {
+                tool.response_mode = t.response_mode;
+            }
+            return tool;
         });
     }
     buildOptionalServiceOverride(label, service) {

package/dst/Voice Agent.d.ts

@@ -24,16 +24,22 @@ interface SoftTimeoutConfig {
     phrases: string[];
     mode: SoftTimeoutMode;
 }
+type ToolResponseMode = 'sync' | 'async' | 'none';
 interface Handler {
     name: string;
     description: string;
     parameters: string;
     feedback?: PerToolConfig;
+    timeout_seconds?: number | string | null;
+    response_mode?: ToolResponseMode | string | null;
 }
-interface AgentSystemToolConfig {
+interface SubagentTool {
     name: string;
-    description?: string;
-    parameters?: Record<string, unknown>;
+    description: string;
+    parameters: string;
+    feedback?: PerToolConfig;
+    timeout_seconds?: number | string | null;
+    response_mode?: ToolResponseMode | string | null;
 }
 interface AgentServiceConfig {
     provider: string;
@@ -41,8 +47,30 @@ interface AgentServiceConfig {
     api_key?: string;
     options?: Record<string, unknown>;
 }
+type SubagentContextMode = 'own' | 'shared';
+interface Subagent {
+    id: string;
+    name: string;
+    system_instruction: string;
+    developer_messages?: string[];
+    context?: SubagentContextMode;
+    llm?: Partial<AgentServiceConfig> | null;
+    tools: SubagentTool[];
+    exitId?: string;
+}
+interface AgentSystemToolConfig {
+    name: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+}
+type KnowledgeMode = 'tool' | 'pipeline';
+interface AgentKnowledgeConfig {
+    id: string;
+    mode: KnowledgeMode;
+}
 interface INPUT {
     handlers: Handler[];
+    subagents: Subagent[];
     system_instruction: string;
     developer_messages: string[];
     greeting_message: string;
@@ -69,10 +97,16 @@ interface INPUT {
     tool_feedback?: ToolCallFeedbackConfig;
     soft_timeout?: SoftTimeoutConfig;
     system_tools?: AgentSystemToolConfig[];
+    knowledge?: AgentKnowledgeConfig[];
 }
 export default class VoiceAgent extends VoiceStep<Partial<INPUT>> {
     runStep(): Promise<void>;
     private normalizeIdlePrompts;
+    private serializeTool;
+    private serializeSubagents;
+    private findSubagentForTool;
+    private findSubagentByName;
+    private resolveSubagentExit;
     private findExitByLabel;
     private validateToolFeedback;
     private isStepFlagEnabled;
@@ -81,6 +115,7 @@ export default class VoiceAgent extends VoiceStep<Partial<INPUT>> {
     private validatePerToolFeedback;
     private validateSoftTimeout;
     private validateSystemTools;
+    private validateKnowledge;
     private parseAgentServiceOptions;
     exitToThread(): Promise<void>;
 }

package/dst/Voice Agent.js

@@ -11,21 +11,48 @@ class VoiceAgent extends voice_1.default {
                 case 'tool_call': {
                     if (event.params.type !== 'tool_call')
                         return;
-                    const cb = this.thread.takeCallback();
                     const name = event.params.name ?? 'tool_call';
+                    const cb = this.thread.takeCallback();
                     const params = event.params.arguments ?? {};
                     const toolCallId = event.params.toolCallId ?? '';
+                    const payload = {
+                        [name]: params,
+                        name,
+                        toolCallId,
+                        __voicecb: cb,
+                        callId: call.id,
+                        callType: call.type,
+                        callCallback: call.callback
+                    };
+                    const subagent = this.findSubagentForTool(name)
+                        || this.findSubagentByName(event.params.subagent);
+                    if (subagent) {
+                        const exitId = this.resolveSubagentExit(subagent);
+                        if (exitId) {
+                            this.log.info('Voice Agent: routing tool_call to subagent', {
+                                name,
+                                subagent: subagent.name,
+                                exitId
+                            });
+                            this.exitStep(exitId, {
+                                ...payload,
+                                arguments: params,
+                                subagent: subagent.name
+                            }, true);
+                        }
+                        else {
+                            this.log.warn('no exit for subagent tool_call', {
+                                name,
+                                subagent: subagent.name,
+                                exitId: subagent.exitId,
+                                exits: (this.step.exits || []).map((e) => ({ id: e.id, label: e.label }))
+                            });
+                        }
+                        return;
+                    }
                     const exitId = this.findExitByLabel(name) ?? this.getExitStepId('tool_call');
                     if (exitId) {
-                        this.exitStep(exitId, {
-                            [name]: params,
-                            name,
-                            toolCallId,
-                            __voicecb: cb,
-                            callId: call.id,
-                            callType: call.type,
-                            callCallback: call.callback
-                        }, true);
+                        this.exitStep(exitId, payload, true);
                     }
                     else {
                         this.log.warn('no exit for tool_call', { name });
@@ -52,34 +79,11 @@ class VoiceAgent extends voice_1.default {
             }
         });
         this.triggers.otherwise(async () => {
-            const { handlers = [], system_instruction = '', developer_messages = [], greeting_message = '', prevent_greeting_interruption = false, idle_detection_enabled = false, idle_timeout_secs = 8, idle_max_retries = 3, idle_prompts = [], idle_goodbye_message = '', dtmf_enabled = false, dtmf_timeout = 2, dtmf_termination_digit = '#', dtmf_prefix = 'DTMF: ', custom_config_enabled = false, agent_url_overwritten = false, tool_feedback, soft_timeout, system_tools, agent_url = '', mode = '', stt = {}, llm = {}, tts = {}, realtime = {} } = this.data;
+            const { handlers = [], subagents = [], system_instruction = '', developer_messages = [], greeting_message = '', prevent_greeting_interruption = false, idle_detection_enabled = false, idle_timeout_secs = 8, idle_max_retries = 3, idle_prompts = [], idle_goodbye_message = '', dtmf_enabled = false, dtmf_timeout = 2, dtmf_termination_digit = '#', dtmf_prefix = 'DTMF: ', custom_config_enabled = false, agent_url_overwritten = false, tool_feedback, soft_timeout, system_tools, knowledge = [], agent_url = '', mode = '', stt = {}, llm = {}, tts = {}, realtime = {} } = this.data;
             if (lodash_1.default.isEmpty(system_instruction)) {
                 this.throwError(new Error('Voice Agent: system instruction is required'));
             }
-            const tools = handlers.map(h => {
-                let parameters = h.parameters;
-                if (typeof parameters === 'string') {
-                    try {
-                        parameters = JSON.parse(parameters);
-                    }
-                    catch {
-                        parameters = {};
-                    }
-                }
-                const tool = {
-                    type: 'function',
-                    name: h.name,
-                    description: h.description,
-                    parameters: parameters || {}
-                };
-                if (h.feedback != null) {
-                    const validatedFeedback = this.validatePerToolFeedback(h.feedback, h.name);
-                    if (validatedFeedback) {
-                        tool.feedback = validatedFeedback;
-                    }
-                }
-                return tool;
-            });
+            const tools = handlers.map(h => this.serializeTool(h));
             const config = {
                 system_instruction,
                 developer_messages,
@@ -87,6 +91,10 @@ class VoiceAgent extends voice_1.default {
                 prevent_greeting_interruption,
                 tools
             };
+            const serializedSubagents = this.serializeSubagents(subagents) || [];
+            if (serializedSubagents.length > 0) {
+                config.subagents = serializedSubagents;
+            }
             if (this.isStepFlagEnabled(idle_detection_enabled)) {
                 const timeoutSecs = Number(idle_timeout_secs);
                 const maxRetries = Number(idle_max_retries);
@@ -147,6 +155,9 @@ class VoiceAgent extends voice_1.default {
             if (system_tools != null) {
                 config.system_tools = this.validateSystemTools(system_tools);
             }
+            if (!lodash_1.default.isEmpty(knowledge)) {
+                config.knowledge = this.validateKnowledge(knowledge);
+            }
             const params = { config };
             if (agentCustomUrl) {
                 params.url = agentCustomUrl;
@@ -160,8 +171,83 @@ class VoiceAgent extends voice_1.default {
             .map(item => typeof item === 'string' ? item : item?.prompt ?? '')
             .filter(prompt => !lodash_1.default.isEmpty(lodash_1.default.trim(String(prompt))));
     }
+    serializeTool(h) {
+        let parameters = h.parameters;
+        if (typeof parameters === 'string') {
+            try {
+                parameters = JSON.parse(parameters);
+            }
+            catch {
+                parameters = {};
+            }
+        }
+        const tool = {
+            type: 'function',
+            name: h.name,
+            description: h.description,
+            parameters: parameters || {}
+        };
+        if (h.feedback != null) {
+            const validatedFeedback = this.validatePerToolFeedback(h.feedback, h.name);
+            if (validatedFeedback) {
+                tool.feedback = validatedFeedback;
+            }
+        }
+        if (h.timeout_seconds != null && h.timeout_seconds !== '') {
+            tool.timeout_seconds = Number(h.timeout_seconds);
+        }
+        if (h.response_mode) {
+            tool.response_mode = h.response_mode;
+        }
+        return tool;
+    }
+    serializeSubagents(subagents) {
+        if (!Array.isArray(subagents))
+            return [];
+        return subagents
+            .filter(sa => sa != null && !lodash_1.default.isEmpty(lodash_1.default.trim(sa.name)))
+            .map(sa => {
+            const name = lodash_1.default.trim(sa.name);
+            const serialized = {
+                name,
+                system_instruction: sa.system_instruction || '',
+                developer_messages: (sa.developer_messages || [])
+                    .map(msg => typeof msg === 'string' ? msg : '')
+                    .filter(msg => !lodash_1.default.isEmpty(lodash_1.default.trim(msg))),
+                context: sa.context === 'shared' ? 'shared' : 'own',
+                tools: (sa.tools || [])
+                    .filter(t => t != null && !lodash_1.default.isEmpty(lodash_1.default.trim(t.name)))
+                    .map(t => this.serializeTool(t))
+            };
+            const llm = this.buildAgentServiceConfig(`subagent "${name}" llm`, sa.llm || {});
+            if (llm)
+                serialized.llm = llm;
+            return serialized;
+        });
+    }
+    findSubagentForTool(toolName) {
+        const needle = lodash_1.default.trim(toolName);
+        if (!needle)
+            return undefined;
+        const subagents = this.data.subagents || [];
+        return subagents.find(sa => (sa?.tools || []).some(t => t && lodash_1.default.trim(String(t.name || '')) === needle));
+    }
+    findSubagentByName(name) {
+        if (typeof name !== 'string' || lodash_1.default.isEmpty(lodash_1.default.trim(name)))
+            return undefined;
+        const trimmed = lodash_1.default.trim(name);
+        return (this.data.subagents || []).find(sa => lodash_1.default.trim(sa?.name || '') === trimmed);
+    }
+    resolveSubagentExit(subagent) {
+        if (subagent.exitId && this.getExitStepId(subagent.exitId, false)) {
+            return subagent.exitId;
+        }
+        const name = lodash_1.default.trim(subagent.name || '');
+        return this.findExitByLabel(`subagent_${name}`) || this.findExitByLabel(name);
+    }
     findExitByLabel(label) {
-        const exit = lodash_1.default.find(this.step.exits, (e) => e.label === label);
+        const needle = lodash_1.default.trim(label);
+        const exit = lodash_1.default.find(this.step.exits, (e) => lodash_1.default.trim(e.label || '') === needle);
         return exit?.id;
     }
     validateToolFeedback(config) {
@@ -333,6 +419,20 @@ class VoiceAgent extends voice_1.default {
             description: lodash_1.default.isEmpty(entry.description) ? undefined : entry.description
         }));
     }
+    validateKnowledge(knowledge) {
+        if (!Array.isArray(knowledge)) {
+            this.throwError(new Error('Voice Agent: knowledge must be an array'));
+        }
+        const modes = ['tool', 'pipeline'];
+        return lodash_1.default.uniqBy(knowledge
+            .filter(entry => entry != null && typeof entry === 'object')
+            .map((entry) => ({
+            id: lodash_1.default.trim(String(entry.id ?? '')),
+            // An unrecognised mode degrades to tool search rather than failing a live call.
+            mode: lodash_1.default.includes(modes, entry.mode) ? entry.mode : 'tool'
+        }))
+            .filter(entry => !lodash_1.default.isEmpty(entry.id)), entry => entry.id);
+    }
     parseAgentServiceOptions(label, options) {
         if (options == null || options === '')
             return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onereach/step-voice",
-  "version": "7.0.45",
+  "version": "7.0.47-VOIC1732knowledgeretrieval.0",
   "author": "Roman Zolotarov <roman.zolotarov@onereach.com>",
   "contributors": [
     "Roman Zolotarov",
@@ -16,6 +16,7 @@
     "@onereach/step-conversation": "^1.0.40",
     "lodash": "^4.17.21",
     "nanoid": "^3.3.4",
+    "timestring": "^6.0.0",
     "uuid": "^9.0.0"
   },
   "devDependencies": {