akanjs 3.0.0-alpha.39 → 3.0.0-alpha.40

package/client/capacitor.ts

@@ -46,6 +46,28 @@ export type CapacitorContactsModule = {
   };
 };
 
+export type CapacitorSpeechRecognitionModule = {
+  SpeechRecognition: {
+    available: () => Promise<{ available: boolean }>;
+    checkPermissions: () => Promise<{ speechRecognition: CapacitorPermissionState }>;
+    requestPermissions: () => Promise<{ speechRecognition: CapacitorPermissionState }>;
+    start: (options: Record<string, unknown>) => Promise<{ matches?: string[] }>;
+    stop: () => Promise<void>;
+    removeAllListeners: () => Promise<void> | void;
+    addListener: (
+      eventName: string,
+      listenerFunc: (data: { matches?: string[] }) => void,
+    ) => Promise<{ remove: () => Promise<void> | void }> | { remove: () => Promise<void> | void };
+  };
+};
+
+export type CapacitorTextToSpeechModule = {
+  TextToSpeech: {
+    speak: (options: { text: string; lang?: string; rate?: number }) => Promise<void>;
+    stop: () => Promise<void>;
+  };
+};
+
 export type CapacitorCoreModule = {
   CapacitorCookies: {
     setCookie: (options: { key: string; value: string; path?: string }) => Promise<void> | void;
@@ -155,6 +177,8 @@ type CapacitorModuleMap = {
   preferences: CapacitorPreferencesModule;
   pushNotifications: CapacitorPushNotificationsModule;
   safeArea: CapacitorSafeAreaModule;
+  speechRecognition: CapacitorSpeechRecognitionModule;
+  textToSpeech: CapacitorTextToSpeechModule;
   updater: CapacitorUpdaterModule;
 };
 
@@ -257,6 +281,16 @@ export const loadCapacitorSafeArea = () =>
     SafeArea: getCapacitorPlugin<CapacitorSafeAreaModule["SafeArea"]>("SafeArea"),
   }));
 
+export const loadCapacitorSpeechRecognition = () =>
+  loadCapacitorModule("speechRecognition", async () => ({
+    SpeechRecognition: getCapacitorPlugin<CapacitorSpeechRecognitionModule["SpeechRecognition"]>("SpeechRecognition"),
+  }));
+
+export const loadCapacitorTextToSpeech = () =>
+  loadCapacitorModule("textToSpeech", async () => ({
+    TextToSpeech: getCapacitorPlugin<CapacitorTextToSpeechModule["TextToSpeech"]>("TextToSpeech"),
+  }));
+
 export const loadCapacitorUpdater = () =>
   loadCapacitorModule("updater", async () => ({
     CapacitorUpdater: getCapacitorPlugin<CapacitorUpdaterModule["CapacitorUpdater"]>("CapacitorUpdater"),

package/dictionary/base.dictionary.ts

@@ -54,6 +54,8 @@ export const baseDictionary = serviceDictionary(["en", "ko"])
     agentClear: ["Clear conversation", "대화 비우기"],
     agentQuestion: ["The agent needs your decision", "에이전트가 결정을 요청합니다"],
     agentAnswer: ["Type your answer...", "답변을 입력하세요..."],
+    agentListen: ["Speak to the agent", "에이전트에게 말하기"],
+    agentVoiceFailed: ["The microphone could not be used.", "마이크를 사용할 수 없습니다."],
     agentAttach: ["Attach a file", "파일 첨부"],
     agentAttachRemove: ["Remove attachment", "첨부 제거"],
     agentAttachTooLarge: ["{name} is too large to attach.", "{name}은(는) 용량이 너무 커서 첨부할 수 없습니다."],

package/index.ts

@@ -26,7 +26,7 @@ export interface AkanRouteConfig {
 
 export type DatabaseMode = "single" | "multiple" | "cluster";
 export type MobileEnv = "local" | "debug" | "develop" | "main";
-export type MobilePermission = "camera" | "contacts" | "location" | "push";
+export type MobilePermission = "camera" | "contacts" | "location" | "push" | "speech";
 
 export interface AkanMobileTargetAssets {
   icon?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "3.0.0-alpha.39",
+  "version": "3.0.0-alpha.40",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {

package/types/client/capacitor.d.ts

@@ -73,6 +73,41 @@ export type CapacitorContactsModule = {
         }>;
     };
 };
+export type CapacitorSpeechRecognitionModule = {
+    SpeechRecognition: {
+        available: () => Promise<{
+            available: boolean;
+        }>;
+        checkPermissions: () => Promise<{
+            speechRecognition: CapacitorPermissionState;
+        }>;
+        requestPermissions: () => Promise<{
+            speechRecognition: CapacitorPermissionState;
+        }>;
+        start: (options: Record<string, unknown>) => Promise<{
+            matches?: string[];
+        }>;
+        stop: () => Promise<void>;
+        removeAllListeners: () => Promise<void> | void;
+        addListener: (eventName: string, listenerFunc: (data: {
+            matches?: string[];
+        }) => void) => Promise<{
+            remove: () => Promise<void> | void;
+        }> | {
+            remove: () => Promise<void> | void;
+        };
+    };
+};
+export type CapacitorTextToSpeechModule = {
+    TextToSpeech: {
+        speak: (options: {
+            text: string;
+            lang?: string;
+            rate?: number;
+        }) => Promise<void>;
+        stop: () => Promise<void>;
+    };
+};
 export type CapacitorCoreModule = {
     CapacitorCookies: {
         setCookie: (options: {
@@ -226,6 +261,8 @@ type CapacitorModuleMap = {
     preferences: CapacitorPreferencesModule;
     pushNotifications: CapacitorPushNotificationsModule;
     safeArea: CapacitorSafeAreaModule;
+    speechRecognition: CapacitorSpeechRecognitionModule;
+    textToSpeech: CapacitorTextToSpeechModule;
     updater: CapacitorUpdaterModule;
 };
 type CapacitorImportCache = Partial<{
@@ -247,5 +284,7 @@ export declare const loadCapacitorKeyboard: () => Promise<CapacitorKeyboardModul
 export declare const loadCapacitorPreferences: () => Promise<CapacitorPreferencesModule>;
 export declare const loadCapacitorPushNotifications: () => Promise<CapacitorPushNotificationsModule>;
 export declare const loadCapacitorSafeArea: () => Promise<CapacitorSafeAreaModule>;
+export declare const loadCapacitorSpeechRecognition: () => Promise<CapacitorSpeechRecognitionModule>;
+export declare const loadCapacitorTextToSpeech: () => Promise<CapacitorTextToSpeechModule>;
 export declare const loadCapacitorUpdater: () => Promise<CapacitorUpdaterModule>;
 export {};

package/types/dictionary/base.dictionary.d.ts

@@ -1 +1 @@
-export declare const baseDictionary: import("./dictInfo.d.ts").ServiceDictInfo<[string, string], "ping" | "pingBody" | "pingParam" | "pingQuery" | "wsPing" | "pubsubPing", never, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view">;
+export declare const baseDictionary: import("./dictInfo.d.ts").ServiceDictInfo<[string, string], "ping" | "pingBody" | "pingParam" | "pingQuery" | "wsPing" | "pubsubPing", never, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view">;

package/types/dictionary/dictionary.d.ts

@@ -1,13 +1,13 @@
 import type { AgentEndpoint, AgentTurn, BaseEndpoint } from "akanjs/signal";
 export declare const dictionary: {
-    base: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view">, never>;
+    base: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view">, never>;
     agentTurn: import("./locale.d.ts").DictModule<import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc`, never>;
     agent: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, "agent.error.llmUnavailable" | "agent.error.deepseekRequestFailed">;
 };
-export declare const Err: import("./trans.d.ts").ErrConstructor<"agent.error.llmUnavailable" | "agent.error.deepseekRequestFailed">, translate: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja", key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, data?: import("./trans.d.ts").TranslationData) => string, msg: {
-    info: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
-    success: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
-    error: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
-    warning: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
-    loading: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
-}, getDictionary: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja") => object, getAllDictionary: () => import("./trans.d.ts").RootDictionary, __Dict_Key__: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, __Error_Key__: "agent.error.llmUnavailable" | "agent.error.deepseekRequestFailed";
+export declare const Err: import("./trans.d.ts").ErrConstructor<"agent.error.llmUnavailable" | "agent.error.deepseekRequestFailed">, translate: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja", key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, data?: import("./trans.d.ts").TranslationData) => string, msg: {
+    info: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
+    success: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
+    error: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
+    warning: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
+    loading: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
+}, getDictionary: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja") => object, getAllDictionary: () => import("./trans.d.ts").RootDictionary, __Dict_Key__: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "remove" | "save" | "refresh" | "password" | "stop" | "send" | "skip" | "agent" | "ok" | "connecting" | "new" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "approve" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "edit" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, __Error_Key__: "agent.error.llmUnavailable" | "agent.error.deepseekRequestFailed";

package/types/index.d.ts

@@ -27,7 +27,7 @@ export interface AkanRouteConfig {
 }
 export type DatabaseMode = "single" | "multiple" | "cluster";
 export type MobileEnv = "local" | "debug" | "develop" | "main";
-export type MobilePermission = "camera" | "contacts" | "location" | "push";
+export type MobilePermission = "camera" | "contacts" | "location" | "push" | "speech";
 export interface AkanMobileTargetAssets {
     icon?: string;
     splash?: string;

package/types/ui/Agent/Chat.d.ts

@@ -2,6 +2,7 @@ import { type ReactNode } from "react";
 import { type AgentRunner } from "../../vendor/use-agentic.d.ts";
 import { type AttachReader } from "./attachment.d.ts";
 import { type PersistOption } from "./sessionHistory.d.ts";
+import { type VoiceEngine } from "./voice.d.ts";
 export interface ChatProps {
     className?: string;
     title?: string;
@@ -22,6 +23,12 @@ export interface ChatProps {
      * the built-in, so it can also replace how an image is prepared.
      */
     attach?: AttachReader;
+    /**
+     * Speech in and out. The engine listens and speaks; this component decides when — a press-to-talk microphone
+     * whose transcript lands in the composer for the user to correct, and a reply read aloud **only when the ask
+     * itself came in by voice**, so a typed question never turns the speakers on.
+     */
+    voice?: VoiceEngine;
 }
 /**
  * The user-facing half of the in-page agent: one floating chat wired to the same surface the dock inspects.
@@ -30,6 +37,6 @@ export interface ChatProps {
  * no history). An enclosing AgentProvider's session wins, which is how an app isolates a surface or swaps the
  * loop while keeping this UI.
  */
-export declare const DefaultChat: ({ className, title, instructions, runner, maxTurns, defaultOpen, persist, inline, attach, }: ChatProps) => ReactNode;
+export declare const DefaultChat: ({ className, title, instructions, runner, maxTurns, defaultOpen, persist, inline, attach, voice, }: ChatProps) => ReactNode;
 declare const _default: import("react").ComponentType<ChatProps>;
 export default _default;

package/types/ui/Agent/Mic.d.ts

@@ -0,0 +1,8 @@
+interface MicProps {
+    className?: string;
+    listening: boolean;
+    label: string;
+    onToggle: () => void;
+}
+export declare const Mic: ({ className, listening, label, onToggle }: MicProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/types/ui/Agent/voice.d.ts

@@ -0,0 +1,66 @@
+/** A recognition run in progress. `stop` ends it; a final result may still arrive after. */
+export interface VoiceListener {
+    stop: () => void;
+}
+/** One utterance being spoken. `cancel` is barge-in; `done` resolves when it finished or was cancelled. */
+export interface VoiceSpeech {
+    cancel: () => void;
+    done: Promise<void>;
+}
+export interface VoiceHandlers {
+    /** Partial text while the user is still speaking. An engine without interim results simply never calls it. */
+    onInterim?: (text: string) => void;
+    onFinal: (text: string) => void;
+    onError: (message: string) => void;
+}
+/**
+ * The seam a voice engine fills — one contract, whatever is behind it: the browser's own recognition, a cloud
+ * STT/TTS pair, or a native plugin. The engine speaks and listens; **the framework owns the policy** — when to
+ * listen, what to speak, sentence chunking, barge-in, and whether a reply is spoken at all.
+ *
+ * Shaped as a subscription rather than `listen(): Promise<string>` on purpose. A promise fits push-to-talk and
+ * nothing else, and continuous listening could then only arrive as a breaking change; this shape carries both, so
+ * hands-free is a later policy decision instead of a later contract.
+ *
+ * `listen` must be reachable from the click that starts it: microphone permission and, on iOS, the first
+ * `speechSynthesis` utterance are both gated on a user gesture.
+ */
+export interface VoiceEngine {
+    listen: (handlers: VoiceHandlers) => VoiceListener;
+    /** One sentence at a time, already stripped of markdown. The framework queues; the engine speaks. */
+    speak: (text: string) => VoiceSpeech;
+    /** Answering false hides the controls — a screen that cannot listen should not offer a microphone. */
+    available?: () => boolean;
+}
+/**
+ * What of a model's answer should be read aloud.
+ *
+ * Code blocks, tables, and rules are dropped rather than spoken: a fence read character by character is noise,
+ * and a table read cell by cell is worse than silence — in push-to-talk the user is looking at the screen that
+ * already renders both. Inline code keeps its content, because that is usually a name worth hearing.
+ *
+ * Monotonic over a growing source, which is what lets the reader below track one offset: new text never changes
+ * how earlier text was rendered, since a fence marker always arrives before the lines it swallows.
+ */
+export declare const speechText: (markdown: string) => string;
+/**
+ * Reads an assistant answer aloud as it streams in, one sentence at a time.
+ *
+ * Sentence-at-a-time rather than delta-at-a-time because a delta cuts words in half, and whole-message-at-a-time
+ * because that waits for the turn to end. The offset is over `speechText` output, not the raw source, so a code
+ * block that arrives mid-answer costs nothing.
+ */
+export declare class VoiceReader {
+    #private;
+    constructor(engine: () => VoiceEngine | undefined);
+    get speaking(): boolean;
+    /** Call with the whole answer so far, as often as it changes; already-spoken text is never repeated. */
+    feed(source: string): void;
+    /**
+     * The turn ended: the last sentence has no whitespace behind it and would otherwise never be spoken. It still
+     * splits what is left, because a whole answer that arrived in one render must not be read as one long utterance.
+     */
+    flush(source: string): void;
+    cancel(): void;
+    reset(): void;
+}

package/types/ui/index.d.ts

@@ -1,5 +1,6 @@
 export { Agent } from "./Agent.d.ts";
 export { type AttachReader, maxAttachmentBytes } from "./Agent/attachment.d.ts";
+export type { VoiceEngine, VoiceHandlers, VoiceListener, VoiceSpeech } from "./Agent/voice.d.ts";
 export { agentAttrs } from "./agentAttrs.d.ts";
 export { animated } from "./animated.d.ts";
 export { Badge } from "./Badge.d.ts";

package/ui/Agent/Chat.tsx

@@ -16,8 +16,10 @@ import Bubble from "./Bubble";
 import { type ChatCommand, ChatCommands } from "./ChatCommands";
 import { fetchRunner } from "./fetchRunner";
 import Menu from "./Menu";
+import { Mic } from "./Mic";
 import Question from "./Question";
 import { type PersistOption, sessionHistoryOf } from "./sessionHistory";
+import { type VoiceEngine, type VoiceListener, VoiceReader } from "./voice";
 
 export interface ChatProps {
   className?: string;
@@ -39,6 +41,12 @@ export interface ChatProps {
    * the built-in, so it can also replace how an image is prepared.
    */
   attach?: AttachReader;
+  /**
+   * Speech in and out. The engine listens and speaks; this component decides when — a press-to-talk microphone
+   * whose transcript lands in the composer for the user to correct, and a reply read aloud **only when the ask
+   * itself came in by voice**, so a typed question never turns the speakers on.
+   */
+  voice?: VoiceEngine;
 }
 
 const isApplePlatform = () => /Mac|iPhone|iPad|iPod/i.test(navigator.platform);
@@ -62,6 +70,7 @@ export const DefaultChat = ({
   persist,
   inline = false,
   attach,
+  voice,
 }: ChatProps) => {
   const { l } = usePage();
   const provided = useContext(SessionContext);
@@ -87,6 +96,18 @@ export const DefaultChat = ({
   const [open, setOpen] = useState(defaultOpen);
   const [draft, setDraft] = useState("");
   const [attached, setAttached] = useState<MessageAttachment[]>([]);
+  const [listening, setListening] = useState(false);
+  
+  const engine = useRef<VoiceEngine | undefined>(voice);
+  engine.current = voice;
+  const listener = useRef<VoiceListener | null>(null);
+  const reader = useRef<VoiceReader | null>(null);
+  reader.current ??= new VoiceReader(() => engine.current);
+  /** Set while the draft came from the microphone, consumed by the send that carries it. */
+  const byVoice = useRef(false);
+  /** The assistant message being read aloud. Null means this turn is not one to read. */
+  const spoken = useRef<{ at: number } | null>(null);
+  const seen = useRef(0);
   const sent = useRef<string[]>([]);
   const stashed = useRef("");
   const [recall, setRecall] = useState(0);
@@ -119,6 +140,39 @@ export const DefaultChat = ({
     if (!open) return;
     inputRef.current?.focus();
   }, [open, session.pendingQuestion?.callId]);
+  useEffect(() => {
+    const speaker = reader.current;
+    
+    if (session.messages.length < seen.current) {
+      speaker?.reset();
+      spoken.current = null;
+    }
+    seen.current = session.messages.length;
+    const reading = spoken.current;
+    if (!reading || !speaker) return;
+    const at = session.messages.findLastIndex(
+      (message) => message.role === "assistant" && !message.local && !!message.text,
+    );
+    if (at < 0) return;
+    
+    if (at !== reading.at) {
+      speaker.reset();
+      reading.at = at;
+    }
+    const text = session.messages[at].text ?? "";
+    if (session.isRunning) speaker.feed(text);
+    else {
+      speaker.flush(text);
+      spoken.current = null;
+    }
+  }, [version]);
+  useEffect(
+    () => () => {
+      listener.current?.stop();
+      reader.current?.cancel();
+    },
+    [],
+  );
   const runPrompt = async (prompt: AgentPrompt, args: string[]) => {
     const usage = `/${prompt.name} ${prompt.args.map((arg) => `<${arg.name}>`).join(" ")}`.trim();
     if (args.length < prompt.args.filter((arg) => arg.required).length) {
@@ -154,6 +208,39 @@ export const DefaultChat = ({
       }
     }
   };
+  /** One press is one utterance, so the engine is told to stop even when it reported a final result itself. */
+  const endListening = () => {
+    const held = listener.current;
+    listener.current = null;
+    held?.stop();
+    setListening(false);
+  };
+  const toggleMic = () => {
+    if (listener.current) {
+      endListening();
+      return;
+    }
+    const voiceEngine = engine.current;
+    if (!voiceEngine) return;
+    
+    reader.current?.cancel();
+    spoken.current = null;
+    listener.current = voiceEngine.listen({
+      onInterim: setDraft,
+      onFinal: (text) => {
+        setDraft(text);
+        byVoice.current = true;
+        endListening();
+      },
+      onError: (message) => {
+        
+        console.warn(`[akan] voice input failed: ${message}`);
+        session.note(l("base.agentVoiceFailed"));
+        endListening();
+      },
+    });
+    setListening(true);
+  };
   const remember = (text: string) => {
     if (sent.current[sent.current.length - 1] !== text) sent.current = [...sent.current, text].slice(-30);
     setRecall(0);
@@ -188,6 +275,7 @@ export const DefaultChat = ({
     const question = session.pendingQuestion;
     if (question && text) {
       setDraft("");
+      byVoice.current = false;
       question.answer(question.multiple ? [text] : text);
       return;
     }
@@ -202,6 +290,9 @@ export const DefaultChat = ({
     const prompt = command ? prompts.current?.find(command.name) : null;
     setDraft("");
     if (text) remember(text);
+    
+    spoken.current = byVoice.current ? { at: -1 } : null;
+    byVoice.current = false;
     if (command && prompt) {
       void runPrompt(prompt, command.args);
       return;
@@ -213,6 +304,8 @@ export const DefaultChat = ({
     setAttached([]);
     void session.send([{ role: "user", ...(text ? { text } : {}), attachments: attached }]);
   };
+  
+  const canListen = !!voice && (voice.available?.() ?? true);
   const query = /^\/[A-Za-z0-9_-]*$/.test(draft) ? draft : "";
   const commandMenu = query ? ChatCommands.list(l).filter((command) => `/${command.name}`.startsWith(query)) : [];
   const promptMenu = query
@@ -323,6 +416,7 @@ export const DefaultChat = ({
           />
         ) : null}
         <div className="flex items-center gap-2">
+          {canListen ? <Mic label={l("base.agentListen")} listening={listening} onToggle={toggleMic} /> : null}
           <Attach label={l("base.agentAttach")} onPick={(files) => void attachFiles(files)} />
           <input
             className={inputRecipe({ size: "sm" }, "flex-1")}
@@ -349,7 +443,15 @@ export const DefaultChat = ({
             value={draft}
           />
           {session.isRunning && !session.pendingQuestion ? (
-            <Button onClick={session.abort} size="sm" variant="outline">
+            <Button
+              onClick={() => {
+                reader.current?.cancel();
+                spoken.current = null;
+                session.abort();
+              }}
+              size="sm"
+              variant="outline"
+            >
               {l("base.stop")}
             </Button>
           ) : (

package/ui/Agent/Mic.tsx

@@ -0,0 +1,27 @@
+"use client";
+import { cn } from "akanjs/client";
+import { AiOutlineAudio, AiOutlineAudioMuted } from "react-icons/ai";
+
+interface MicProps {
+  className?: string;
+  listening: boolean;
+  label: string;
+  onToggle: () => void;
+}
+
+export const Mic = ({ className, listening, label, onToggle }: MicProps) => (
+  <button
+    aria-label={label}
+    aria-pressed={listening}
+    className={cn(
+      "shrink-0 hover:text-foreground",
+      listening ? "animate-pulse text-primary" : "text-foreground/50",
+      className,
+    )}
+    onClick={onToggle}
+    title={label}
+    type="button"
+  >
+    {listening ? <AiOutlineAudioMuted /> : <AiOutlineAudio />}
+  </button>
+);

package/ui/Agent/voice.ts

@@ -0,0 +1,168 @@
+/** A recognition run in progress. `stop` ends it; a final result may still arrive after. */
+export interface VoiceListener {
+  stop: () => void;
+}
+
+/** One utterance being spoken. `cancel` is barge-in; `done` resolves when it finished or was cancelled. */
+export interface VoiceSpeech {
+  cancel: () => void;
+  done: Promise<void>;
+}
+
+export interface VoiceHandlers {
+  /** Partial text while the user is still speaking. An engine without interim results simply never calls it. */
+  onInterim?: (text: string) => void;
+  onFinal: (text: string) => void;
+  onError: (message: string) => void;
+}
+
+/**
+ * The seam a voice engine fills — one contract, whatever is behind it: the browser's own recognition, a cloud
+ * STT/TTS pair, or a native plugin. The engine speaks and listens; **the framework owns the policy** — when to
+ * listen, what to speak, sentence chunking, barge-in, and whether a reply is spoken at all.
+ *
+ * Shaped as a subscription rather than `listen(): Promise<string>` on purpose. A promise fits push-to-talk and
+ * nothing else, and continuous listening could then only arrive as a breaking change; this shape carries both, so
+ * hands-free is a later policy decision instead of a later contract.
+ *
+ * `listen` must be reachable from the click that starts it: microphone permission and, on iOS, the first
+ * `speechSynthesis` utterance are both gated on a user gesture.
+ */
+export interface VoiceEngine {
+  listen: (handlers: VoiceHandlers) => VoiceListener;
+  /** One sentence at a time, already stripped of markdown. The framework queues; the engine speaks. */
+  speak: (text: string) => VoiceSpeech;
+  /** Answering false hides the controls — a screen that cannot listen should not offer a microphone. */
+  available?: () => boolean;
+}
+
+const fenced = /^ {0,3}(?:```|~~~)/;
+const tableRow = /^\s*\|/;
+const horizontalRule = /^ {0,3}(?:-{3,}|\*{3,}|_{3,})\s*$/;
+const lineMarkers = /^\s*(?:#{1,6}\s+|>\s?|[-*+]\s+|\d{1,9}[.)]\s+)/;
+const image = /!\[([^\]]*)\]\([^)]*\)/g;
+const link = /\[([^\]]*)\]\([^)]*\)/g;
+const emphasis = /(\*\*\*|\*\*|\*|___|__|_|~~)/g;
+const inlineCode = /`([^`]*)`/g;
+
+/**
+ * What of a model's answer should be read aloud.
+ *
+ * Code blocks, tables, and rules are dropped rather than spoken: a fence read character by character is noise,
+ * and a table read cell by cell is worse than silence — in push-to-talk the user is looking at the screen that
+ * already renders both. Inline code keeps its content, because that is usually a name worth hearing.
+ *
+ * Monotonic over a growing source, which is what lets the reader below track one offset: new text never changes
+ * how earlier text was rendered, since a fence marker always arrives before the lines it swallows.
+ */
+export const speechText = (markdown: string): string => {
+  const lines = markdown.replace(/\r\n?/g, "\n").split("\n");
+  const kept: string[] = [];
+  let inFence = false;
+  for (const line of lines) {
+    if (fenced.test(line)) {
+      inFence = !inFence;
+      continue;
+    }
+    if (inFence || tableRow.test(line) || horizontalRule.test(line)) continue;
+    const plain = line
+      .replace(lineMarkers, "")
+      .replace(image, "$1")
+      .replace(link, "$1")
+      .replace(inlineCode, "$1")
+      .replace(emphasis, "");
+    kept.push(plain);
+  }
+  return kept.join("\n");
+};
+
+/** A terminator counts only with whitespace behind it, so `1.5` is not a sentence and a stream is never cut early. */
+const sentenceEnd = /[.!?。！？…]+\s|\n/g;
+
+/**
+ * Reads an assistant answer aloud as it streams in, one sentence at a time.
+ *
+ * Sentence-at-a-time rather than delta-at-a-time because a delta cuts words in half, and whole-message-at-a-time
+ * because that waits for the turn to end. The offset is over `speechText` output, not the raw source, so a code
+ * block that arrives mid-answer costs nothing.
+ */
+export class VoiceReader {
+  readonly #engine: () => VoiceEngine | undefined;
+  #queue: string[] = [];
+  #current: VoiceSpeech | null = null;
+  #offset = 0;
+
+  constructor(engine: () => VoiceEngine | undefined) {
+    this.#engine = engine;
+  }
+
+  get speaking() {
+    return !!this.#current;
+  }
+
+  /** Call with the whole answer so far, as often as it changes; already-spoken text is never repeated. */
+  feed(source: string) {
+    this.#chunk(source, false);
+  }
+
+  /**
+   * The turn ended: the last sentence has no whitespace behind it and would otherwise never be spoken. It still
+   * splits what is left, because a whole answer that arrived in one render must not be read as one long utterance.
+   */
+  flush(source: string) {
+    this.#chunk(source, true);
+  }
+
+  cancel() {
+    this.#queue = [];
+    this.#current?.cancel();
+    this.#current = null;
+  }
+
+  reset() {
+    this.cancel();
+    this.#offset = 0;
+  }
+
+  #chunk(source: string, final: boolean) {
+    const text = speechText(source);
+    
+    if (text.length < this.#offset) this.reset();
+    const pending = text.slice(this.#offset);
+    sentenceEnd.lastIndex = 0;
+    let cut = 0;
+    for (let match = sentenceEnd.exec(pending); match; match = sentenceEnd.exec(pending)) {
+      const end = match.index + match[0].length;
+      this.#enqueue(pending.slice(cut, end));
+      cut = end;
+    }
+    if (final) {
+      this.#enqueue(pending.slice(cut));
+      cut = pending.length;
+    }
+    this.#offset += cut;
+    this.#pump();
+  }
+
+  #enqueue(chunk: string) {
+    const text = chunk.trim();
+    if (text) this.#queue.push(text);
+  }
+
+  #pump() {
+    if (this.#current || !this.#queue.length) return;
+    const engine = this.#engine();
+    if (!engine) {
+      this.#queue = [];
+      return;
+    }
+    const next = this.#queue.shift() as string;
+    const speech = engine.speak(next);
+    this.#current = speech;
+    void speech.done.then(() => {
+      if (this.#current !== speech) return;
+      this.#current = null;
+      this.#pump();
+    });
+  }
+}

package/ui/index.ts

@@ -1,5 +1,6 @@
 export { Agent } from "./Agent";
 export { type AttachReader, maxAttachmentBytes } from "./Agent/attachment";
+export type { VoiceEngine, VoiceHandlers, VoiceListener, VoiceSpeech } from "./Agent/voice";
 export { agentAttrs } from "./agentAttrs";
 export { animated } from "./animated";
 export { Badge } from "./Badge";