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

package/dst/Voice Agent.d.ts

@@ -63,6 +63,11 @@ interface AgentSystemToolConfig {
     description?: string;
     parameters?: Record<string, unknown>;
 }
+type KnowledgeMode = 'tool' | 'pipeline';
+interface AgentKnowledgeConfig {
+    id: string;
+    mode: KnowledgeMode;
+}
 interface INPUT {
     handlers: Handler[];
     subagents: Subagent[];
@@ -92,6 +97,7 @@ interface INPUT {
     tool_feedback?: ToolCallFeedbackConfig;
     soft_timeout?: SoftTimeoutConfig;
     system_tools?: AgentSystemToolConfig[];
+    knowledge?: AgentKnowledgeConfig[];
 }
 export default class VoiceAgent extends VoiceStep<Partial<INPUT>> {
     runStep(): Promise<void>;
@@ -109,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

@@ -79,7 +79,7 @@ class VoiceAgent extends voice_1.default {
             }
         });
         this.triggers.otherwise(async () => {
-            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, 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'));
             }
@@ -155,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;
@@ -416,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.46",
+  "version": "7.0.47-VOIC1732knowledgeretrieval.0",
   "author": "Roman Zolotarov <roman.zolotarov@onereach.com>",
   "contributors": [
     "Roman Zolotarov",