@absolutejs/voice 0.0.22-beta.190 → 0.0.22-beta.192

package/dist/agent.d.ts

@@ -103,6 +103,7 @@ export type VoiceAgent<TContext = unknown, TSession extends VoiceSessionRecord =
         context: TContext;
         messages?: VoiceAgentMessage[];
         session: TSession;
+        system?: string;
         turn: VoiceTurnRecord;
     }) => Promise<VoiceAgentRunResult<TResult>>;
 };

package/dist/angular/voice-live-ops.service.d.ts

@@ -6,6 +6,6 @@ export declare class VoiceLiveOpsService {
         isRunning: import("@angular/core").Signal<boolean>;
         lastResult: import("@angular/core").Signal<VoiceLiveOpsActionResult | undefined>;
         run: (input: import("..").VoiceLiveOpsActionInput) => Promise<VoiceLiveOpsActionResult | undefined>;
-        runningAction: import("@angular/core").Signal<"escalate" | "assign" | "create-task" | "force-handoff" | "inject-instruction" | "operator-takeover" | "pause-assistant" | "resume-assistant" | "tag" | undefined>;
+        runningAction: import("@angular/core").Signal<"assign" | "create-task" | "escalate" | "force-handoff" | "inject-instruction" | "operator-takeover" | "pause-assistant" | "resume-assistant" | "tag" | undefined>;
     };
 }

package/dist/client/index.d.ts

@@ -37,7 +37,7 @@ export { createVoiceTraceTimelineViewModel, defineVoiceTraceTimelineElement, get
 export { createVoiceWorkflowStatusStore, fetchVoiceWorkflowStatus } from './workflowStatus';
 export type { VoiceOpsStatusClientOptions, VoiceOpsStatusSnapshot } from './opsStatus';
 export type { VoiceOpsActionCenterClientOptions, VoiceOpsActionCenterPresetOptions, VoiceOpsActionCenterSnapshot, VoiceOpsActionDescriptor, VoiceOpsActionMethod, VoiceOpsActionRunResult } from './opsActionCenter';
-export type { VoiceLiveOpsClientOptions, VoiceLiveOpsSnapshot } from './liveOps';
+export type { VoiceLiveOpsClientOptions, VoiceLiveOpsAction, VoiceLiveOpsActionInput, VoiceLiveOpsActionResult, VoiceLiveOpsSnapshot } from './liveOps';
 export type { VoiceOpsActionHistoryClientOptions, VoiceOpsActionHistorySnapshot } from './opsActionHistory';
 export type { VoiceDeliveryRuntimeClientOptions, VoiceDeliveryRuntimeAction, VoiceDeliveryRuntimeActionResult, VoiceDeliveryRuntimeSnapshot } from './deliveryRuntime';
 export type { VoiceBargeInMonitorOptions } from './bargeInMonitor';

package/dist/index.js

@@ -4649,9 +4649,32 @@ var createVoiceSession = (options) => {
     });
   };
   const completeTurn = async (session, turn) => {
+    const liveOpsControl = await options.liveOps?.getControl(options.id);
+    if (liveOpsControl?.assistantPaused || liveOpsControl?.operatorTakeover) {
+      await appendTrace({
+        metadata: {
+          source: "voice-live-ops"
+        },
+        payload: {
+          action: "turn.skipped",
+          control: liveOpsControl,
+          reason: liveOpsControl.operatorTakeover ? "operator-takeover" : "assistant-paused",
+          status: "skipped"
+        },
+        session,
+        turnId: turn.id,
+        type: "operator.action"
+      });
+      return;
+    }
+    const injectedInstruction = liveOpsControl?.injectedInstruction?.trim();
     const committedOutput = await options.route.onTurn({
       api,
       context: options.context,
+      liveOps: liveOpsControl ? {
+        control: liveOpsControl,
+        injectedInstruction
+      } : undefined,
       session,
       turn
     });
@@ -5407,6 +5430,7 @@ var voice = (config) => {
       handoff: config.handoff,
       languageStrategy: config.languageStrategy,
       lexicon,
+      liveOps: config.liveOps,
       logger: sessionOptions.logger,
       phraseHints,
       reconnect: sessionOptions.reconnect,
@@ -6936,11 +6960,14 @@ var createVoiceAgent = (options) => {
   const run = async (input) => {
     const messages = input.messages ?? createHistoryMessages(input.session, input.turn);
     const toolResults = [];
-    const system = typeof options.system === "function" ? await options.system({
+    const baseSystem = typeof options.system === "function" ? await options.system({
       context: input.context,
       session: input.session,
       turn: input.turn
     }) : options.system;
+    const system = [baseSystem, input.system].filter((value) => Boolean(value?.trim())).join(`
+
+`) || undefined;
     let output = {};
     for (let round = 0;round <= maxToolRounds; round += 1) {
       const modelStartedAt = Date.now();
@@ -7994,7 +8021,25 @@ var createVoiceAssistant = (options) => {
       trace: options.trace,
       tools: variant.tools ?? baseModelOptions.tools
     }) : agent;
-    const runResult = await runner.run(input) ?? {};
+    const liveOpsInstruction = input.liveOps?.injectedInstruction?.trim();
+    if (liveOpsInstruction) {
+      await appendAssistantTrace({
+        assistantId: options.id,
+        event: {
+          action: "instruction-injected",
+          artifactPlan: artifactPlanName,
+          instruction: liveOpsInstruction
+        },
+        session: input.session,
+        trace: options.trace,
+        turnId: input.turn.id,
+        type: "assistant.run"
+      });
+    }
+    const runResult = await runner.run({
+      ...input,
+      system: liveOpsInstruction ? `Operator instruction for this turn: ${liveOpsInstruction}` : undefined
+    }) ?? {};
     const result = runResult;
     const guarded = await options.guardrails?.afterTurn?.({
       ...guardrailInput,

package/dist/testing/index.js

@@ -6401,9 +6401,32 @@ var createVoiceSession = (options) => {
     });
   };
   const completeTurn = async (session, turn) => {
+    const liveOpsControl = await options.liveOps?.getControl(options.id);
+    if (liveOpsControl?.assistantPaused || liveOpsControl?.operatorTakeover) {
+      await appendTrace({
+        metadata: {
+          source: "voice-live-ops"
+        },
+        payload: {
+          action: "turn.skipped",
+          control: liveOpsControl,
+          reason: liveOpsControl.operatorTakeover ? "operator-takeover" : "assistant-paused",
+          status: "skipped"
+        },
+        session,
+        turnId: turn.id,
+        type: "operator.action"
+      });
+      return;
+    }
+    const injectedInstruction = liveOpsControl?.injectedInstruction?.trim();
     const committedOutput = await options.route.onTurn({
       api,
       context: options.context,
+      liveOps: liveOpsControl ? {
+        control: liveOpsControl,
+        injectedInstruction
+      } : undefined,
       session,
       turn
     });

package/dist/types.d.ts

@@ -3,6 +3,7 @@ import type { VoiceOpsDispositionTaskPolicies, VoiceOpsTaskAssignmentRule, Voice
 import type { VoiceIntegrationSink } from './opsSinks';
 import type { StoredVoiceCallReviewArtifact, VoiceCallReviewArtifact, VoiceCallReviewStore } from './testing/review';
 import type { VoiceTraceEventStore } from './trace';
+import type { VoiceLiveOpsControlState } from './liveOps';
 export type AudioFormat = {
     container: 'raw';
     encoding: 'alaw' | 'mulaw' | 'pcm_s16le';
@@ -484,6 +485,10 @@ export type VoiceLexiconResolver<TContext = unknown> = (input: {
 }) => Promise<VoiceLexiconEntry[] | void> | VoiceLexiconEntry[] | void;
 export type VoiceOnTurnObjectHandler<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = (input: {
     context: TContext;
+    liveOps?: {
+        control: VoiceLiveOpsControlState;
+        injectedInstruction?: string;
+    };
     session: TSession;
     turn: VoiceTurnRecord;
     api: VoiceSessionHandle<TContext, TSession, TResult>;
@@ -605,6 +610,9 @@ export type VoiceRuntimeOpsConfig<TContext = unknown, TSession extends VoiceSess
     tasks?: VoiceOpsTaskStore;
     webhook?: VoiceIntegrationWebhookConfig;
 };
+export type VoiceLiveOpsRuntimeConfig = {
+    getControl: (sessionId: string) => Promise<VoiceLiveOpsControlState | null | undefined> | VoiceLiveOpsControlState | null | undefined;
+};
 export type VoiceNormalizedRouteConfig<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = Omit<VoiceRouteConfig<TContext, TSession, TResult>, 'onTurn'> & {
     onTurn: VoiceOnTurnObjectHandler<TContext, TSession, TResult>;
 };
@@ -639,6 +647,7 @@ export type VoicePluginConfig<TContext = unknown, TSession extends VoiceSessionR
     htmx?: boolean | VoiceHTMXConfig<TSession, NoInfer<TResult>>;
     handoff?: VoiceHandoffConfig<TContext, TSession, TResult>;
     ops?: VoiceRuntimeOpsConfig<TContext, TSession, TResult>;
+    liveOps?: VoiceLiveOpsRuntimeConfig;
     trace?: VoiceTraceEventStore;
 } & VoiceRouteConfig<TContext, TSession, TResult>;
 export type CreateVoiceSessionOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
@@ -662,6 +671,7 @@ export type CreateVoiceSessionOptions<TContext = unknown, TSession extends Voice
     turnDetection: VoiceResolvedTurnDetectionConfig;
     audioConditioning?: VoiceResolvedAudioConditioningConfig;
     handoff?: VoiceHandoffConfig<TContext, TSession, TResult>;
+    liveOps?: VoiceLiveOpsRuntimeConfig;
     route: VoiceNormalizedRouteConfig<TContext, TSession, TResult>;
     logger?: VoiceLogger;
 };

package/dist/vue/useVoiceLiveOps.d.ts

@@ -4,6 +4,6 @@ export declare function useVoiceLiveOps(options?: VoiceLiveOpsClientOptions): {
     isRunning: import("vue").Ref<boolean, boolean>;
     lastResult: import("vue").ShallowRef<VoiceLiveOpsActionResult | undefined, VoiceLiveOpsActionResult | undefined>;
     run: (input: import("..").VoiceLiveOpsActionInput) => Promise<VoiceLiveOpsActionResult | undefined>;
-    runningAction: import("vue").Ref<"escalate" | "assign" | "create-task" | "force-handoff" | "inject-instruction" | "operator-takeover" | "pause-assistant" | "resume-assistant" | "tag" | undefined, "escalate" | "assign" | "create-task" | "force-handoff" | "inject-instruction" | "operator-takeover" | "pause-assistant" | "resume-assistant" | "tag" | undefined>;
+    runningAction: import("vue").Ref<"assign" | "create-task" | "escalate" | "force-handoff" | "inject-instruction" | "operator-takeover" | "pause-assistant" | "resume-assistant" | "tag" | undefined, "assign" | "create-task" | "escalate" | "force-handoff" | "inject-instruction" | "operator-takeover" | "pause-assistant" | "resume-assistant" | "tag" | undefined>;
     updatedAt: import("vue").Ref<number | undefined, number | undefined>;
 };

package/package.json

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