mirror of
https://git.undefined-dev.fr/Blendman974/faceclaw.git
synced 2026-11-19 21:03:09 +00:00
Phase 3 of the voice-assistant design: assistant.backend=external routes utterances over a dial-out websocket to faceclaw-agent-bridge (an OpenClaw plugin on the user's machine). The phone serves its ToolRegistry as MCP on the same socket, with proactive gating and rate limiting enforced locally. New Assistant settings section with backend/bridge settings. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XCdkQyB3RUVPTuEmhxVEdp
40 lines
1.4 KiB
TypeScript
40 lines
1.4 KiB
TypeScript
/**
|
|
* Shared assistant types. Kept backend-agnostic so the UI (AssistantLayer)
|
|
* talks to the same session surface whether the turn runs on the phone
|
|
* (direct provider loop) or against the user's own agent (external bridge,
|
|
* later phases).
|
|
*/
|
|
|
|
/** Situational grounding injected per turn (system prompt in direct mode). */
|
|
export type AssistantContext = {
|
|
/** Foreground app id, or null when the sidebar/launcher is all that's up. */
|
|
foregroundApp: string | null;
|
|
foregroundTitle: string | null;
|
|
screenOn: boolean;
|
|
/** Human-readable local time, e.g. "Thu Jul 24, 3:15 PM". */
|
|
localTime: string;
|
|
/** Headset battery percent (0..100), or null if unknown. */
|
|
headsetBattery: number | null;
|
|
};
|
|
|
|
export type AssistantTurnCallbacks = {
|
|
/** Streamed reply text (delta plus the full text so far). */
|
|
onTextDelta: (delta: string, textSoFar: string) => void;
|
|
/** A tool is being invoked; label is display-ready, e.g. "calendar.list_events". */
|
|
onToolActivity: (label: string) => void;
|
|
onTurnDone: (result: { stopReason: string | null }) => void;
|
|
onError: (message: string) => void;
|
|
};
|
|
|
|
/** A handle to an in-flight turn. */
|
|
export type AssistantTurnHandle = {
|
|
cancel(): void;
|
|
};
|
|
|
|
/** Connection settings for the external agent bridge (assistant.bridge* settings). */
|
|
export type AssistantBridgeConfig = {
|
|
host: string;
|
|
port: number;
|
|
token: string;
|
|
};
|