@absolutejs/voice 0.0.22-beta.491 → 0.0.22-beta.493

package/dist/index.d.ts

@@ -86,6 +86,8 @@ export type { VoiceAgentUIInput, VoiceAgentUIState, } from "./agentState";
 export { createInMemoryDNCList, isPhoneOnDNC, isWithinCampaignWindow, normalizePhoneNumber, shouldRetryCampaignAttempt, summarizeVoiceCampaignDispositions, } from "./campaignControls";
 export type { VoiceCampaignDisposition, VoiceCampaignDispositionRetryPolicy, VoiceCampaignDispositionRetryRule, VoiceCampaignDispositionSummary, VoiceCampaignWindowCheckInput, VoiceDNCList, } from "./campaignControls";
 export { createVoiceBackchannelDriver } from "./backchannel";
+export { createVoiceOAuth2TokenSource } from "./oauth2TokenSource";
+export type { CreateVoiceOAuth2TokenSourceOptions, VoiceOAuth2TokenResponse, VoiceOAuth2TokenSource, } from "./oauth2TokenSource";
 export type { VoiceBackchannelCue, VoiceBackchannelDriver, VoiceBackchannelDriverOptions, } from "./backchannel";
 export { createVoiceIVRSession, describeVoiceIVRPlan, evaluateVoiceIVRPlan, } from "./ivrPlan";
 export type { VoiceIVRBranch, VoiceIVRDecision, VoiceIVRInput, VoiceIVRMatch, VoiceIVRPlan, VoiceIVRSession, } from "./ivrPlan";
@@ -97,8 +99,8 @@ export type { VoiceWebhookVerificationInput, VoiceWebhookVerificationReason, Voi
 export type { CreatePunctuationSemanticTurnDetectorOptions, CreateRegexSemanticTurnDetectorOptions, VoiceSemanticTurnDetector, VoiceSemanticTurnInput, VoiceSemanticTurnVerdict, } from "./semanticTurn";
 export { createMonologueAMDDetector } from "./amdDetector";
 export type { MonologueAMDDetectorOptions, VoiceAMDDetector, VoiceAMDDetectorInput, VoiceAMDVerdict, } from "./amdDetector";
-export { createVoiceRAGTool } from "./ragTool";
-export type { VoiceRAGCollectionLike, VoiceRAGQueryResult, VoiceRAGSearchInput, VoiceRAGToolArgs, VoiceRAGToolOptions, VoiceRAGToolResult, } from "./ragTool";
+export { createVoiceRAGTool, extractVoiceRAGCitations } from "./ragTool";
+export type { VoiceRAGCitationSummary, VoiceRAGCollectionLike, VoiceRAGQueryResult, VoiceRAGSearchInput, VoiceRAGToolArgs, VoiceRAGToolOptions, VoiceRAGToolResult, } from "./ragTool";
 export { createVoiceApiRequestTool, createVoiceDTMFTool, createVoiceEndCallTool, createVoiceTransferCallTool, createVoiceVoicemailDetectionTool, } from "./agentTools";
 export { fromVapiAssistantConfig } from "./vapiAdapter";
 export type { VapiAssistantConfig, VapiAssistantConfigModel, VapiAssistantConfigTool, VapiAssistantConfigTranscriber, VapiAssistantConfigTransferDestination, VapiAssistantConfigVoice, VapiAssistantMessage, VoiceFromVapiAssistantOptions, VoiceFromVapiAssistantResult, VoiceFromVapiCustomToolFactory, VoiceFromVapiCustomToolInput, VoiceFromVapiDTMFFactory, VoiceFromVapiKnowledgeBase, VoiceFromVapiModelFactory, VoiceFromVapiModelFactoryInput, VoiceFromVapiRouteHints, VoiceFromVapiUnsupportedReason, } from "./vapiAdapter";

package/dist/index.js

@@ -35663,6 +35663,66 @@ var createVoiceBackchannelDriver = (options) => {
     }
   };
 };
+// src/oauth2TokenSource.ts
+var createVoiceOAuth2TokenSource = (options) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+  const refreshSkewMs = (options.refreshSkewSeconds ?? 60) * 1000;
+  let cached;
+  let pending;
+  const fetchToken = async () => {
+    const body = new URLSearchParams;
+    body.set("grant_type", options.grantType ?? "client_credentials");
+    body.set("client_id", options.clientId);
+    body.set("client_secret", options.clientSecret);
+    if (options.scope) {
+      body.set("scope", options.scope);
+    }
+    if (options.audience) {
+      body.set("audience", options.audience);
+    }
+    const response = await fetchImpl(options.tokenUrl, {
+      body: body.toString(),
+      headers: {
+        accept: "application/json",
+        "content-type": "application/x-www-form-urlencoded"
+      },
+      method: "POST"
+    });
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      throw new Error(`OAuth2 token request failed: ${response.status} ${response.statusText}${text ? ` \u2014 ${text.slice(0, 200)}` : ""}`);
+    }
+    const json = await response.json();
+    if (!json.access_token) {
+      throw new Error("OAuth2 token response missing access_token");
+    }
+    const ttlMs = typeof json.expires_in === "number" && json.expires_in > 0 ? json.expires_in * 1000 : 5 * 60 * 1000;
+    cached = {
+      expiresAt: Date.now() + ttlMs,
+      value: json.access_token
+    };
+    return json.access_token;
+  };
+  return {
+    invalidate: () => {
+      cached = undefined;
+      pending = undefined;
+    },
+    token: async () => {
+      const now = Date.now();
+      if (cached && cached.expiresAt - refreshSkewMs > now) {
+        return cached.value;
+      }
+      if (pending) {
+        return pending;
+      }
+      pending = fetchToken().finally(() => {
+        pending = undefined;
+      });
+      return pending;
+    }
+  };
+};
 // src/ivrPlan.ts
 var speechMatchesPattern = (pattern, speech) => {
   const normalized = speech.toLowerCase().trim();
@@ -36006,6 +36066,28 @@ var createMonologueAMDDetector = (options = {}) => {
   };
 };
 // src/ragTool.ts
+var extractVoiceRAGCitations = (toolResults, toolName = "searchKnowledgeBase") => {
+  const out = [];
+  for (const entry of toolResults) {
+    if (entry.toolName !== toolName) {
+      continue;
+    }
+    const result = entry.result;
+    const citations = result?.citations;
+    if (!Array.isArray(citations)) {
+      continue;
+    }
+    for (const citation of citations) {
+      out.push({
+        chunkId: citation.chunkId,
+        score: citation.score,
+        source: citation.source,
+        title: citation.title
+      });
+    }
+  }
+  return out;
+};
 var DEFAULT_TOOL_NAME = "searchKnowledgeBase";
 var DEFAULT_DESCRIPTION = "Search the knowledge base and return short grounded citations. Use this whenever the caller asks a question that may be answered by indexed reference material.";
 var DEFAULT_TOP_K = 6;
@@ -46800,6 +46882,7 @@ export {
   fetchVoiceProofTarget,
   failVoiceOpsTask,
   extractVoiceWebhookSignatureFromHeaders,
+  extractVoiceRAGCitations,
   extractVoiceMediaPipelineIssueEntries,
   exportVoiceTrace,
   exportVoiceAuditTrail,
@@ -47052,6 +47135,7 @@ export {
   createVoiceObservabilityExportRoutes,
   createVoiceObservabilityExportReplayRoutes,
   createVoiceOTELHTTPExporter,
+  createVoiceOAuth2TokenSource,
   createVoiceMonitorWebhookNotifier,
   createVoiceMonitorSession,
   createVoiceMonitorRuntimeBinding,

package/dist/oauth2TokenSource.d.ts

@@ -0,0 +1,21 @@
+export type VoiceOAuth2TokenResponse = {
+    access_token: string;
+    expires_in?: number;
+    token_type?: string;
+};
+export type VoiceOAuth2TokenSource = {
+    invalidate: () => void;
+    token: () => Promise<string>;
+};
+export type CreateVoiceOAuth2TokenSourceOptions = {
+    audience?: string;
+    clientId: string;
+    clientSecret: string;
+    fetch?: typeof fetch;
+    grantType?: "client_credentials";
+    /** seconds remaining before expiry to refresh proactively, default 60 */
+    refreshSkewSeconds?: number;
+    scope?: string;
+    tokenUrl: string;
+};
+export declare const createVoiceOAuth2TokenSource: (options: CreateVoiceOAuth2TokenSourceOptions) => VoiceOAuth2TokenSource;

package/dist/ragTool.d.ts

@@ -29,6 +29,16 @@ export type VoiceRAGToolResult = {
     query: string;
     topK: number;
 };
+export type VoiceRAGCitationSummary = {
+    chunkId: string;
+    score: number;
+    source?: string;
+    title?: string;
+};
+export declare const extractVoiceRAGCitations: (toolResults: ReadonlyArray<{
+    result?: unknown;
+    toolName: string;
+}>, toolName?: string) => VoiceRAGCitationSummary[];
 export type VoiceRAGToolOptions<TContext = unknown> = {
     allowedFilterKeys?: readonly string[];
     description?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/voice",
-  "version": "0.0.22-beta.491",
+  "version": "0.0.22-beta.493",
   "description": "Voice primitives and Elysia plugin for AbsoluteJS",
   "repository": {
     "type": "git",