@absolutejs/voice 0.0.22-beta.644 → 0.0.22-beta.646

package/dist/client/index.d.ts

@@ -1,6 +1,8 @@
 export { bindVoiceReactiveSource, voiceSseReactiveSource, } from "./reactiveSource";
 export type { VoiceReactiveSource, VoiceSseReactiveSourceOptions, } from "./reactiveSource";
 export { createVoiceConnection } from "./connection";
+export { checkBrowserVoiceSupport, probeBrowserVoiceSupport, } from "./browserVoiceSupport";
+export type { BrowserVoiceSupportProbe, BrowserVoiceSupportReport, } from "./browserVoiceSupport";
 export { createVoiceAudioPlayer, decodeVoiceAudioChunk } from "./audioPlayer";
 export { createTimeStretcher, type TimeStretcher } from "./timeStretch";
 export { createVoiceStream } from "./createVoiceStream";

package/dist/client/index.js

@@ -375,6 +375,88 @@ var createVoiceConnection = (path, options = {}) => {
     getSessionId: () => state.sessionId
   };
 };
+// src/client/browserVoiceSupport.ts
+var safeGet = (fn) => {
+  try {
+    return fn();
+  } catch {
+    return;
+  }
+};
+var detectMediaRecorderOpus = (ctor) => {
+  if (!ctor || typeof ctor.isTypeSupported !== "function")
+    return false;
+  try {
+    return ctor.isTypeSupported("audio/webm;codecs=opus");
+  } catch {
+    return false;
+  }
+};
+var checkBrowserVoiceSupport = (globalScope = globalThis) => {
+  const capabilities = probeBrowserVoiceSupport(globalScope);
+  const blockers = [];
+  const warnings = [];
+  if (!capabilities.hasWebSocket) {
+    blockers.push("WebSocket is not available \u2014 voice runtime cannot stream audio.");
+  }
+  if (!capabilities.hasGetUserMedia) {
+    blockers.push("navigator.mediaDevices.getUserMedia is not available \u2014 cannot capture microphone.");
+  }
+  if (capabilities.isInsecureContext) {
+    blockers.push("Page is served from an insecure context; getUserMedia requires HTTPS or localhost.");
+  }
+  if (!capabilities.hasAudioContext) {
+    blockers.push("AudioContext is not available \u2014 cannot decode or play TTS audio.");
+  }
+  if (!capabilities.hasAudioWorklet) {
+    warnings.push("AudioWorklet is unavailable \u2014 noise suppression and custom audio processors won't run.");
+  }
+  if (!capabilities.hasRTCPeerConnection) {
+    warnings.push("RTCPeerConnection is unavailable \u2014 WebRTC transport paths are disabled.");
+  }
+  if (!capabilities.hasOpusEncoding) {
+    warnings.push("MediaRecorder does not advertise Opus support \u2014 fall back to PCM streaming.");
+  }
+  if (capabilities.requiresUserGestureToResumeAudio) {
+    warnings.push("Safari / iOS requires a user gesture before audioContext.resume() succeeds.");
+  }
+  return {
+    blockers,
+    capabilities,
+    ok: blockers.length === 0,
+    warnings
+  };
+};
+var probeBrowserVoiceSupport = (globalScope = globalThis) => {
+  const win = globalScope;
+  const userAgent = win.navigator?.userAgent ?? "";
+  const audioContextCtor = win.AudioContext ?? win.webkitAudioContext;
+  const hasAudioContext = typeof audioContextCtor === "function";
+  const hasAudioWorklet = hasAudioContext ? safeGet(() => ("audioWorklet" in audioContextCtor.prototype)) === true : false;
+  const hasGetUserMedia = Boolean(win.navigator?.mediaDevices && typeof win.navigator.mediaDevices.getUserMedia === "function");
+  const hasMediaRecorder = typeof win.MediaRecorder === "function";
+  const hasRTCPeerConnection = typeof win.RTCPeerConnection === "function";
+  const hasWebSocket = typeof win.WebSocket === "function";
+  const isInsecureContext = typeof win.isSecureContext === "boolean" ? !win.isSecureContext : false;
+  const isSafari = /^((?!chrome|android).)*safari/i.test(userAgent);
+  const isIos = /iPad|iPhone|iPod/.test(userAgent);
+  const requiresUserGestureToResumeAudio = isSafari || isIos;
+  const hasOpusEncoding = detectMediaRecorderOpus(win.MediaRecorder);
+  return {
+    hasAudioContext,
+    hasAudioWorklet,
+    hasGetUserMedia,
+    hasMediaRecorder,
+    hasOpusEncoding,
+    hasRTCPeerConnection,
+    hasWebSocket,
+    isInsecureContext,
+    isIos,
+    isSafari,
+    requiresUserGestureToResumeAudio,
+    userAgent
+  };
+};
 // src/client/timeStretch.ts
 var HOP_MS = 10;
 var SEEK_MS = 5;
@@ -12464,6 +12546,7 @@ export {
   renderVoiceCallDebuggerLaunchHTML,
   renderVoiceAgentSquadStatusHTML,
   recordVoiceOpsActionResult,
+  probeBrowserVoiceSupport,
   postVoiceLiveOpsAction,
   mountVoiceTurnQuality,
   mountVoiceTurnLatency,
@@ -12609,6 +12692,7 @@ export {
   createVoiceAgentSquadStatusStore,
   createTimeStretcher,
   createMicrophoneCapture,
+  checkBrowserVoiceSupport,
   buildVoiceAgentSquadStatusReport,
   bindVoiceReactiveSource,
   bindVoiceProviderSimulationControls,

package/dist/manifest.d.ts

@@ -1,2 +1,17 @@
 import type { VoicePluginConfig, VoiceSessionStore } from "./core/types";
-export declare const manifest: import("@absolutejs/manifest").PackageManifest<VoicePluginConfig, VoiceSessionStore>;
+export declare const manifest: Omit<import("@absolutejs/manifest").PackageManifest<VoicePluginConfig, VoiceSessionStore>, "tools" | "contract" | "settings"> & (({
+    contract: 1;
+    tools?: Record<string, import("@absolutejs/manifest").LegacyManifestTool<VoiceSessionStore>> | undefined;
+} | {
+    contract: 2;
+    tools?: Record<string, import("@absolutejs/manifest").AuthorizedManifestTool<VoiceSessionStore>> | undefined;
+}) & {
+    settings: import("@sinclair/typebox").TObject<{
+        backchannelBargeInGuard: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        greeting: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        normalizeNumbers: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        preset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"default">, import("@sinclair/typebox").TLiteral<"chat">, import("@sinclair/typebox").TLiteral<"guided-intake">, import("@sinclair/typebox").TLiteral<"dictation">, import("@sinclair/typebox").TLiteral<"noisy-room">, import("@sinclair/typebox").TLiteral<"pstn-balanced">, import("@sinclair/typebox").TLiteral<"pstn-fast">, import("@sinclair/typebox").TLiteral<"reliability">]>>;
+        resumeGreeting: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+});

package/dist/manifest.js

@@ -102,14 +102,19 @@ var defineImplementation = () => (implementation) => {
   const defined = implementation;
   return defined;
 };
-var defineManifest = () => (manifest) => {
-  const defined = manifest;
-  return defined;
+var defineManifest = () => (manifest) => manifest;
+var literal = (value) => value;
+var RUNTIME_KIND = literal("runtime");
+var WORKSPACE_KIND = literal("workspace");
+var toolFactory = () => {
+  function runtime(definition) {
+    return { kind: RUNTIME_KIND, ...definition };
+  }
+  function workspace(definition) {
+    return { kind: WORKSPACE_KIND, ...definition };
+  }
+  return { runtime, workspace };
 };
-var toolFactory = () => ({
-  runtime: (definition) => ({ kind: "runtime", ...definition }),
-  workspace: (definition) => ({ kind: "workspace", ...definition })
-});
 function IsAsyncIterator(value) {
   return IsObject(value) && globalThis.Symbol.asyncIterator in value;
 }
@@ -847,7 +852,7 @@ function String2(options) {
 function* FromUnion(syntax) {
   const trim = syntax.trim().replace(/"|'/g, "");
   return trim === "boolean" ? yield Boolean() : trim === "number" ? yield Number2() : trim === "bigint" ? yield BigInt2() : trim === "string" ? yield String2() : yield (() => {
-    const literals = trim.split("|").map((literal) => Literal(literal.trim()));
+    const literals = trim.split("|").map((literal2) => Literal(literal2.trim()));
     return literals.length === 0 ? Never() : literals.length === 1 ? literals[0] : UnionEvaluated(literals);
   })();
 }
@@ -3555,10 +3560,10 @@ function ScoreUnion(schema, references, value) {
     const keys = Object.getOwnPropertyNames(value);
     const entries = Object.entries(object.properties);
     return entries.reduce((acc, [key, schema2]) => {
-      const literal = schema2[Kind] === "Literal" && schema2.const === value[key] ? 100 : 0;
+      const literal2 = schema2[Kind] === "Literal" && schema2.const === value[key] ? 100 : 0;
       const checks = Check(schema2, references, value[key]) ? 10 : 0;
       const exists = keys.includes(key) ? 1 : 0;
-      return acc + (literal + checks + exists);
+      return acc + (literal2 + checks + exists);
     }, 0);
   } else if (schema[Kind] === "Union") {
     const schemas = schema.anyOf.map((schema2) => Deref(schema2, references));
@@ -5895,7 +5900,13 @@ var wiringSnippet = Type.Object({
     Type.Literal("server-plugin")
   ]))
 });
-var clientFrameworks = ["angular", "client", "react", "svelte", "vue"];
+var clientFrameworks = [
+  "angular",
+  "client",
+  "react",
+  "svelte",
+  "vue"
+];
 var wiringRecipe = Type.Object({
   client: Type.Optional(Type.Partial(Type.Object(Object.fromEntries(clientFrameworks.map((framework) => [framework, wiringSnippet]))))),
   description: Type.Optional(Type.String()),
@@ -5960,8 +5971,47 @@ var toolAnnotations = Type.Object({
   readOnlyHint: Type.Optional(Type.Boolean()),
   title: Type.Optional(Type.String())
 });
+var toolAuthorization = Type.Object({
+  approval: Type.Union([
+    Type.Literal("always"),
+    Type.Literal("never"),
+    Type.Literal("policy")
+  ]),
+  audience: Type.Union([
+    Type.Literal("admin"),
+    Type.Literal("authenticated"),
+    Type.Literal("owner"),
+    Type.Literal("public")
+  ]),
+  compensatingTool: Type.Optional(Type.String({ pattern: TOOL_NAME_PATTERN.source })),
+  destinationFields: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 })),
+  destinations: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 })),
+  effects: Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }),
+  idempotency: Type.Optional(Type.Union([
+    Type.Object({
+      field: Type.String({ minLength: 1 }),
+      mode: Type.Literal("field")
+    }),
+    Type.Object({ mode: Type.Literal("host") }),
+    Type.Object({ mode: Type.Literal("resource") })
+  ])),
+  requiredScopes: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 })),
+  resource: Type.Optional(Type.Object({
+    idField: Type.Optional(Type.String({ minLength: 1 })),
+    ownerIdField: Type.Optional(Type.String({ minLength: 1 })),
+    tenantIdField: Type.Optional(Type.String({ minLength: 1 })),
+    type: Type.String({ minLength: 1 })
+  })),
+  reversible: Type.Optional(Type.Boolean()),
+  spend: Type.Optional(Type.Object({
+    amountMinorField: Type.String({ minLength: 1 }),
+    currencyField: Type.String({ minLength: 1 }),
+    maximumAmountMinor: Type.Optional(Type.Integer({ minimum: 0 }))
+  }))
+});
 var serializedTool = Type.Object({
   annotations: Type.Optional(toolAnnotations),
+  authorization: Type.Optional(toolAuthorization),
   capabilities: Type.Optional(Type.Array(Type.Union([
     Type.Literal("exec"),
     Type.Literal("glob"),
@@ -5973,7 +6023,15 @@ var serializedTool = Type.Object({
   kind: Type.Union([Type.Literal("runtime"), Type.Literal("workspace")])
 });
 var manifestSchema = Type.Object({
-  contract: Type.Literal(1),
+  contract: Type.Union([Type.Literal(1), Type.Literal(2)]),
+  discovery: Type.Optional(Type.Object({
+    audiences: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    certificationUrl: Type.Optional(Type.String()),
+    intents: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    keywords: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    protocols: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    url: Type.Optional(Type.String())
+  })),
   identity: Type.Object({
     accent: Type.Optional(Type.String({ pattern: "^#[0-9a-fA-F]{3,8}$" })),
     category: Type.String({ minLength: 1 }),
@@ -5983,7 +6041,9 @@ var manifestSchema = Type.Object({
       svg: Type.Optional(Type.String()),
       url: Type.Optional(Type.String())
     })),
-    name: Type.String({ pattern: "^(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*$" }),
+    name: Type.String({
+      pattern: "^(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*$"
+    }),
     tagline: Type.String({ minLength: 1 })
   }),
   implements: Type.Optional(Type.Array(adapterImplementation)),
@@ -6956,7 +7016,7 @@ function String3(options) {
 function* FromUnion21(syntax) {
   const trim = syntax.trim().replace(/"|'/g, "");
   return trim === "boolean" ? yield Boolean2() : trim === "number" ? yield Number3() : trim === "bigint" ? yield BigInt3() : trim === "string" ? yield String3() : yield (() => {
-    const literals = trim.split("|").map((literal) => Literal2(literal.trim()));
+    const literals = trim.split("|").map((literal2) => Literal2(literal2.trim()));
     return literals.length === 0 ? Never2() : literals.length === 1 ? literals[0] : UnionEvaluated2(literals);
   })();
 }
@@ -8557,7 +8617,7 @@ var tool = toolFactory();
 var MAX_LIST_LIMIT = 200;
 var MAX_TRANSCRIPT_TURNS = 20;
 var manifest = defineManifest()({
-  contract: 1,
+  contract: 2,
   identity: {
     accent: "#f43f5e",
     category: "voice",
@@ -8760,6 +8820,15 @@ var manifest = defineManifest()({
   tools: {
     delete_session: tool.runtime({
       annotations: { destructiveHint: true, idempotentHint: true },
+      authorization: {
+        approval: "policy",
+        audience: "owner",
+        effects: ["delete"],
+        idempotency: { mode: "resource" },
+        requiredScopes: ["voice:sessions:delete"],
+        resource: { idField: "id", type: "voice-session" },
+        reversible: false
+      },
       description: "Delete one call session (its transcript and state) by id. Deleting an unknown id succeeds.",
       input: Type2.Object({ id: Type2.String({ minLength: 1 }) }),
       handler: async ({ id }, store) => {
@@ -8769,6 +8838,13 @@ var manifest = defineManifest()({
     }),
     get_session: tool.runtime({
       annotations: { readOnlyHint: true },
+      authorization: {
+        approval: "never",
+        audience: "owner",
+        effects: ["read"],
+        requiredScopes: ["voice:sessions:read"],
+        resource: { idField: "id", type: "voice-session" }
+      },
       description: "Fetch one call session by id: status, timing, and the committed conversation turns (caller text and assistant reply), most recent last.",
       input: Type2.Object({
         id: Type2.String({ minLength: 1 }),
@@ -8796,6 +8872,12 @@ var manifest = defineManifest()({
     }),
     list_sessions: tool.runtime({
       annotations: { readOnlyHint: true },
+      authorization: {
+        approval: "never",
+        audience: "owner",
+        effects: ["read"],
+        requiredScopes: ["voice:sessions:read"]
+      },
       description: "List call sessions with status, creation time, last activity, and turn count \u2014 most recently active first.",
       input: Type2.Object({
         limit: Type2.Optional(Type2.Integer({ maximum: MAX_LIST_LIMIT, minimum: 1 }))

package/dist/manifest.json

@@ -1,5 +1,5 @@
 {
-	"contract": 1,
+	"contract": 2,
 	"identity": {
 		"accent": "#f43f5e",
 		"category": "voice",
@@ -325,6 +325,24 @@
 				"destructiveHint": true,
 				"idempotentHint": true
 			},
+			"authorization": {
+				"approval": "policy",
+				"audience": "owner",
+				"effects": [
+					"delete"
+				],
+				"idempotency": {
+					"mode": "resource"
+				},
+				"requiredScopes": [
+					"voice:sessions:delete"
+				],
+				"resource": {
+					"idField": "id",
+					"type": "voice-session"
+				},
+				"reversible": false
+			},
 			"description": "Delete one call session (its transcript and state) by id. Deleting an unknown id succeeds.",
 			"input": {
 				"type": "object",
@@ -344,6 +362,20 @@
 			"annotations": {
 				"readOnlyHint": true
 			},
+			"authorization": {
+				"approval": "never",
+				"audience": "owner",
+				"effects": [
+					"read"
+				],
+				"requiredScopes": [
+					"voice:sessions:read"
+				],
+				"resource": {
+					"idField": "id",
+					"type": "voice-session"
+				}
+			},
 			"description": "Fetch one call session by id: status, timing, and the committed conversation turns (caller text and assistant reply), most recent last.",
 			"input": {
 				"type": "object",
@@ -368,6 +400,16 @@
 			"annotations": {
 				"readOnlyHint": true
 			},
+			"authorization": {
+				"approval": "never",
+				"audience": "owner",
+				"effects": [
+					"read"
+				],
+				"requiredScopes": [
+					"voice:sessions:read"
+				]
+			},
 			"description": "List call sessions with status, creation time, last activity, and turn count — most recently active first.",
 			"input": {
 				"type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/voice",
-  "version": "0.0.22-beta.644",
+  "version": "0.0.22-beta.646",
   "description": "Voice primitives and Elysia plugin for AbsoluteJS",
   "repository": {
     "type": "git",
@@ -140,13 +140,13 @@
     }
   },
   "dependencies": {
-    "@absolutejs/manifest": "^0.1.0",
+    "@absolutejs/manifest": "^0.4.0",
     "@absolutejs/media": "0.0.1-beta.19",
     "@sinclair/typebox": "^0.34.0"
   },
   "devDependencies": {
     "@absolutejs/absolute": "0.19.0-beta.1009",
-    "@absolutejs/ai": "0.0.5",
+    "@absolutejs/ai": "0.0.46",
     "@angular/core": "^21.0.0",
     "@electric-sql/pglite": "^0.4.5",
     "@eslint/js": "^10.0.1",
@@ -169,6 +169,6 @@
     "vue": "3.5.27"
   },
   "absolutejs": {
-    "manifestContract": 1
+    "manifestContract": 2
   }
 }