@voxagent/bridge 0.3.6 → 0.4.0

package/dist/trigger/types.d.ts

@@ -0,0 +1,175 @@
+/**
+ * @file Shared types for the trigger layer — the bridge-side "should the
+ * agent act on this utterance?" decision.
+ *
+ * Everything under `trigger/` is transport-agnostic (no LiveKit imports) so
+ * it ports unchanged to the Meet bot's bridge-side ear. `room.ts` is the only
+ * place that wires it to a transport.
+ */
+import type { AgentBackend } from '../protocol.js';
+/** One finalized line of speech, from a human or from the agent itself. */
+export interface TranscriptLine {
+    entryId: string;
+    speaker: string;
+    speakerIdentity: string;
+    text: string;
+    timestampMs: number;
+    /** STT confidence 0-1 when the transport provides one. */
+    confidence?: number;
+    /** True for lines the agent spoke. */
+    fromAgent?: boolean;
+}
+export interface RoomInfo {
+    id: string;
+    name: string;
+    /** Human participant display names (agent excluded). */
+    participants: string[];
+}
+export type AgentRunStatus = 'idle' | 'thinking' | 'speaking' | 'acting';
+/** What the agent is doing right now, as the runtime sees it. */
+export interface RunSnapshot {
+    status: AgentRunStatus;
+    /** Prompt text the active run is working on. */
+    activePromptText: string | null;
+    /** Tail of what the agent has said so far in the active run. */
+    spokenSoFar: string;
+    activeToolName: string | null;
+}
+export interface ChoiceAnswer {
+    choice: string;
+    confidence: number;
+    probabilities: Record<string, number>;
+}
+export interface ScoreAnswer {
+    /** Probability-weighted level, fractional. */
+    score: number;
+    confidence: number;
+    /** Probability per level, index = level. */
+    probabilities: number[];
+}
+export type AddresseeOption = 'agent' | 'specific_person' | 'group' | 'nobody';
+export type RelationOption = 'adds_detail' | 'redirects' | 'unrelated' | 'stop_talking' | 'abort_work' | 'backchannel';
+/** Parsed jev answers for one utterance. Nouls are probabilities of "yes". */
+export interface TriggerAnswers {
+    addressee: ChoiceAnswer;
+    thoughtComplete: number;
+    isRequest: number;
+    agentCapable: number;
+    hypotheticalOrQuoted: number;
+    /** Only asked while a run is active. */
+    relation: ChoiceAnswer | null;
+    effort: ScoreAnswer;
+    risk: ScoreAnswer;
+    humansDisagree: number;
+}
+export interface ClassifyInput {
+    /** The utterance to judge — a merged burst when finals were held. */
+    utterance: TranscriptLine;
+    /** Recent lines, oldest first, NOT including `utterance`. */
+    window: TranscriptLine[];
+    room: RoomInfo;
+    run: RunSnapshot;
+    agent: AgentDescriptor;
+    /** Set when the agent has an unanswered "was that for me?" on screen. */
+    pendingNudgeText: string | null;
+    lastAgentText: string | null;
+    lastAgentSpokeAtMs: number | null;
+    nowMs: number;
+}
+export interface ClassifyResult {
+    answers: TriggerAnswers;
+    latencyMs: number;
+    model: string;
+    inputTokens: number;
+}
+/** The seam tests fake. Must reject (not hang) on timeout. */
+export interface Classifier {
+    classify(input: ClassifyInput): Promise<ClassifyResult>;
+}
+export interface AgentDescriptor {
+    names: string[];
+    backend: AgentBackend;
+    /** Basename of the workspace, never the full path. */
+    workspace: string;
+    tools: string[];
+    hostName: string;
+}
+export type TriggerAction = {
+    kind: 'ignore';
+    reason: string;
+} | {
+    kind: 'hold';
+    reason: string;
+    waitMs: number;
+} | {
+    kind: 'run';
+    reason: string;
+} | {
+    kind: 'nudge';
+    reason: string;
+    nudgeKind: 'unsure' | 'offer';
+} | {
+    kind: 'append';
+    reason: string;
+} | {
+    kind: 'supersede';
+    reason: string;
+} | {
+    kind: 'queue';
+    reason: string;
+} | {
+    kind: 'stop_talking';
+    reason: string;
+} | {
+    kind: 'abort';
+    reason: string;
+};
+export interface TriggerSettings {
+    /** `probabilities.agent` needed to act with no name and several humans. */
+    wakeThreshold: number;
+    /** ...when the utterance contains the agent's name. */
+    wakeThresholdWithName: number;
+    /** ...when only one human is in the room. */
+    wakeThresholdSolo: number;
+    /** Added to the wake threshold per risk level above 0. */
+    riskBump: number;
+    /** Below the wake threshold but at/above this → "was that for me?" nudge. */
+    nudgeFloor: number;
+    /** `thought_complete` below this holds the utterance for more speech. */
+    holdBelow: number;
+    /** Longest a held utterance waits before running anyway. */
+    maxHoldMs: number;
+    /** `hypothetical_or_quoted` at/above this vetoes a nameless wake. */
+    hypotheticalVeto: number;
+    /** stop_talking + abort_work mass needed to silence a speaking agent. */
+    stopTalkingThreshold: number;
+    /** abort_work probability needed to cancel the work itself. */
+    abortThreshold: number;
+    /** `probabilities.agent` floor for stop/abort — lower than wake on purpose. */
+    stopAddressFloor: number;
+    /** Offer help on group requests nobody addressed to the agent. */
+    proactive: 'off' | 'nudge';
+    proactiveThreshold: number;
+    /** `humans_disagree` at/above this adds the both-options instruction. */
+    disagreeThreshold: number;
+    nudgeTtlMs: number;
+    /** Minimum gap between nudges so the pill doesn't nag. */
+    nudgeCooldownMs: number;
+}
+export declare const DEFAULT_TRIGGER_SETTINGS: TriggerSettings;
+/** Per-run routing the engine hands to the runtime alongside a prompt. */
+export interface RunPlan {
+    /** 0-3, from the `effort` score. */
+    effortLevel: number;
+    /** Set only in `--llm-model auto`. */
+    model?: string;
+    /** Claude only. */
+    maxThinkingTokens?: number;
+    /** Codex only. */
+    reasoningEffort?: 'low' | 'medium' | 'high';
+    /** Canned line spoken before the first LLM token. */
+    ack?: string;
+    /** Extra system-prompt lines for this run (e.g. the disagreement note). */
+    addendum?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/trigger/types.d.ts.map

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

package/dist/trigger/types.js

@@ -0,0 +1,29 @@
+/**
+ * @file Shared types for the trigger layer — the bridge-side "should the
+ * agent act on this utterance?" decision.
+ *
+ * Everything under `trigger/` is transport-agnostic (no LiveKit imports) so
+ * it ports unchanged to the Meet bot's bridge-side ear. `room.ts` is the only
+ * place that wires it to a transport.
+ */
+const _actionKindsMatchWire = true;
+void _actionKindsMatchWire;
+export const DEFAULT_TRIGGER_SETTINGS = {
+    wakeThreshold: 0.8,
+    wakeThresholdWithName: 0.45,
+    wakeThresholdSolo: 0.55,
+    riskBump: 0.1,
+    nudgeFloor: 0.45,
+    holdBelow: 0.45,
+    maxHoldMs: 2500,
+    hypotheticalVeto: 0.6,
+    stopTalkingThreshold: 0.5,
+    abortThreshold: 0.7,
+    stopAddressFloor: 0.4,
+    proactive: 'nudge',
+    proactiveThreshold: 0.75,
+    disagreeThreshold: 0.7,
+    nudgeTtlMs: 10_000,
+    nudgeCooldownMs: 20_000,
+};
+//# sourceMappingURL=types.js.map

package/dist/trigger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/trigger/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2HH,MAAM,qBAAqB,GAA0B,IAAI,CAAC;AAC1D,KAAK,qBAAqB,CAAC;AAmC3B,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,aAAa,EAAE,GAAG;IAClB,qBAAqB,EAAE,IAAI;IAC3B,iBAAiB,EAAE,IAAI;IACvB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,gBAAgB,EAAE,GAAG;IACrB,oBAAoB,EAAE,GAAG;IACzB,cAAc,EAAE,GAAG;IACnB,gBAAgB,EAAE,GAAG;IACrB,SAAS,EAAE,OAAO;IAClB,kBAAkB,EAAE,IAAI;IACxB,iBAAiB,EAAE,GAAG;IACtB,UAAU,EAAE,MAAM;IAClB,eAAe,EAAE,MAAM;CACxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxagent/bridge",
-  "version": "0.3.6",
+  "version": "0.4.0",
   "description": "Local bridge process that pairs the host's Claude Code or Codex agent with a VoxAgent meeting.",
   "license": "MIT",
   "repository": {
@@ -40,6 +40,15 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx watch src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "trigger:eval": "tsx src/trigger/jev.smoke.ts",
+    "type-check": "tsc -p tsconfig.json --noEmit"
+  },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.1.13",
     "@livekit/rtc-node": "^0.13.24",
@@ -56,13 +65,5 @@
   },
   "engines": {
     "node": ">=20"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "dev": "tsx watch src/cli.ts",
-    "start": "node dist/cli.js",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "type-check": "tsc -p tsconfig.json --noEmit"
   }
-}
+}