@pagelines/sdk 1.0.878 → 1.0.880

package/dist/contract/build.d.ts

@@ -25,8 +25,7 @@ export interface WireContract {
  *
  * Schema discovery walks every export of `@pagelines/core`, picks values
  * that are Zod schemas, and derives the contract name from the export
- * name (`zAgentState` → `AgentState`, `EnrichedAgentSchema` →
- * `EnrichedAgent`). `*Wire` namespace exports get the same treatment for
+ * name (`zComputer` → `Computer`). `*Wire` namespace exports get the same treatment for
  * their immediate children. Anything else is ignored — types, constants
  * like `ERROR_CODES`, helper functions all skip naturally.
  */

package/dist/index.d.ts

@@ -1,13 +1,14 @@
 import { PageLinesSDK } from './sdkClient';
 export { PageLinesSDK };
 export type { PageLinesSDKSettings } from './sdkClient';
-export { AgentClient } from './clients/AgentClient';
+export { BotClient } from './clients/BotClient';
+export { ComputerClient } from './clients/ComputerClient';
 export { AuthClient } from './clients/AuthClient';
 export { BillingClient } from './clients/BillingClient';
 export { ChatClient } from './clients/ChatClient';
 export { UserClient } from './clients/UserClient';
 export type { SDKContext } from './clients/types';
 export { MediaSchema } from '@pagelines/core';
-export type { Agent, User, EnrichedUser, MediaObject, ApiResponse, } from '@pagelines/core';
+export type { Bot, User, EnrichedUser, MediaObject, ApiResponse, } from '@pagelines/core';
 export { SOCIAL_PLATFORMS } from './constants/socialPlatforms';
 export type { SocialPlatform } from './constants/socialPlatforms';

package/dist/provider.js

@@ -1,5 +1,5 @@
 import "./rolldown-runtime.js";
-//#region agent/voice/provider.ts
+//#region bot/voice/provider.ts
 function isVoiceAudible(e) {
 	return e >= .08;
 }

package/dist/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","names":[],"sources":["../agent/voice/provider.ts"],"sourcesContent":["import type { VoiceSessionMint } from '@pagelines/core'\n\nexport interface VoiceLevelEvent {\n  source: 'mic' | 'playback'\n  /** Normalized 0..1 signal level. */\n  level: number\n  /** Speech-spectrum energies, low pitch first. */\n  bands?: readonly number[]\n}\n\n/** One speech/noise boundary shared by audible UI state and work-cue ducking. */\nexport function isVoiceAudible(level: number): boolean {\n  return level >= 0.08\n}\n\nexport interface VoiceSessionError {\n  code: string\n  message: string\n}\n\nexport type VoiceDisconnectCause = 'agent' | 'error' | 'network' | 'unknown'\n\n/**\n * Who the transport says is talking. Raw energy is not a speech signal — room\n * tone and the speaker's own playback both read as audible — so ducking,\n * tone, and which meter the surface follows come from here.\n */\nexport interface VoiceSpeakingState {\n  user: boolean\n  agent: boolean\n}\n\nexport interface VoiceProviderClient {\n  connect: (handlers: {\n    onDisconnected: (cause: VoiceDisconnectCause) => void\n    onError: (error: VoiceSessionError) => void\n    onThinkingChange?: (thinking: boolean) => void\n    onSpeakingChange?: (state: VoiceSpeakingState) => void\n  }) => Promise<void>\n  disconnect: () => Promise<void>\n  /** Loudest source by default; `prefer` pins a meter while someone is known to be speaking. */\n  sampleLevel: (prefer?: VoiceLevelEvent['source']) => VoiceLevelEvent | undefined\n  /** Self-mute without ending the live session. */\n  setMuted?: (muted: boolean) => Promise<void>\n  /**\n   * Hand the provider text the caller typed during a live call, as though\n   * they had said it — the assistant answers aloud and the turn lands in the\n   * transcript through the normal provider path. Optional: a provider that\n   * cannot inject text simply omits it and the surface hides the affordance.\n   */\n  sendUserMessage?: (text: string) => void\n}\n\nexport type CreateVoiceProviderClient = (mint: VoiceSessionMint) => Promise<VoiceProviderClient>\n\n/** Keep the realtime SDK out of the initial chat bundle. */\nexport const createVoiceProviderClient: CreateVoiceProviderClient = async (mint) => {\n  const { LiveKitVoiceProvider } = await import('./providers/livekit/provider')\n  return new LiveKitVoiceProvider(mint)\n}\n\nexport const VOICE_SPECTRUM_BANDS = 9\n\n/** Log-spaced speech spectrum for transports that expose FFT bins. */\nexport function voiceSpectrum(frequencies: Uint8Array, sampleRate: number, fftSize: number, bandCount = VOICE_SPECTRUM_BANDS): readonly number[] {\n  if (!Number.isFinite(sampleRate) || sampleRate <= 0 || !Number.isFinite(fftSize) || fftSize <= 0 || bandCount <= 0)\n    return []\n\n  const hzPerBin = sampleRate / fftSize\n  const fromHz = 80\n  const ratio = 4_000 / fromHz\n  const bands: number[] = []\n  for (let band = 0; band < bandCount; band++) {\n    const start = Math.max(0, Math.ceil((fromHz * ratio ** (band / bandCount)) / hzPerBin))\n    const end = Math.min(frequencies.length, Math.ceil((fromHz * ratio ** ((band + 1) / bandCount)) / hzPerBin))\n    if (end <= start) {\n      bands.push(0)\n      continue\n    }\n    let squared = 0\n    for (let index = start; index < end; index++)\n      squared += (frequencies[index] / 255) ** 2\n    bands.push(Math.sqrt(squared / (end - start)))\n  }\n  return bands\n}\n\n/** Equal-width bands for SDKs that already expose voice-range FFT bins. */\nexport function voiceRangeSpectrum(frequencies: Uint8Array, bandCount = VOICE_SPECTRUM_BANDS): readonly number[] {\n  if (!frequencies.length || bandCount <= 0)\n    return []\n  return Array.from({ length: bandCount }, (_, band) => {\n    const start = Math.floor((band * frequencies.length) / bandCount)\n    const end = Math.max(start + 1, Math.floor(((band + 1) * frequencies.length) / bandCount))\n    let squared = 0\n    for (let index = start; index < Math.min(end, frequencies.length); index++)\n      squared += (frequencies[index] / 255) ** 2\n    return Math.sqrt(squared / Math.max(1, Math.min(end, frequencies.length) - start))\n  })\n}\n"],"mappings":";;AAWA,SAAgB,eAAe,GAAwB;CACrD,OAAO,KAAS;AAClB;AA2CA,IAAa,4BAAuD,OAAO,MAAS;CAClF,IAAM,EAAE,4BAAyB,MAAM,OAAO;CAC9C,OAAO,IAAI,EAAqB,CAAI;AACtC;AAKA,SAAgB,cAAc,GAAyB,GAAoB,GAAiB,IAAA,GAAqD;CAC/I,IAAI,CAAC,OAAO,SAAS,CAAU,KAAK,KAAc,KAAK,CAAC,OAAO,SAAS,CAAO,KAAK,KAAW,KAAK,KAAa,GAC/G,OAAO,CAAC;CAEV,IAAM,IAAW,IAAa,GAGxB,IAAkB,CAAC;CACzB,KAAK,IAAI,IAAO,GAAG,IAAO,GAAW,KAAQ;EAC3C,IAAM,IAAQ,KAAK,IAAI,GAAG,KAAK,KAAM,KAAS,OAAU,IAAO,KAAc,CAAQ,CAAC,GAChF,IAAM,KAAK,IAAI,EAAY,QAAQ,KAAK,KAAM,KAAS,QAAW,IAAO,KAAK,KAAc,CAAQ,CAAC;EAC3G,IAAI,KAAO,GAAO;GAChB,EAAM,KAAK,CAAC;GACZ;EACF;EACA,IAAI,IAAU;EACd,KAAK,IAAI,IAAQ,GAAO,IAAQ,GAAK,KACnC,MAAY,EAAY,KAAS,QAAQ;EAC3C,EAAM,KAAK,KAAK,KAAK,KAAW,IAAM,EAAM,CAAC;CAC/C;CACA,OAAO;AACT"}
+{"version":3,"file":"provider.js","names":[],"sources":["../bot/voice/provider.ts"],"sourcesContent":["import type { VoiceSessionMint } from '@pagelines/core'\n\nexport interface VoiceLevelEvent {\n  source: 'mic' | 'playback'\n  /** Normalized 0..1 signal level. */\n  level: number\n  /** Speech-spectrum energies, low pitch first. */\n  bands?: readonly number[]\n}\n\n/** One speech/noise boundary shared by audible UI state and work-cue ducking. */\nexport function isVoiceAudible(level: number): boolean {\n  return level >= 0.08\n}\n\nexport interface VoiceSessionError {\n  code: string\n  message: string\n}\n\nexport type VoiceDisconnectCause = 'bot' | 'error' | 'network' | 'unknown'\n\n/**\n * Who the transport says is talking. Raw energy is not a speech signal — room\n * tone and the speaker's own playback both read as audible — so ducking,\n * tone, and which meter the surface follows come from here.\n */\nexport interface VoiceSpeakingState {\n  user: boolean\n  bot: boolean\n}\n\nexport interface VoiceProviderClient {\n  connect: (handlers: {\n    onDisconnected: (cause: VoiceDisconnectCause) => void\n    onError: (error: VoiceSessionError) => void\n    onThinkingChange?: (thinking: boolean) => void\n    onSpeakingChange?: (state: VoiceSpeakingState) => void\n  }) => Promise<void>\n  disconnect: () => Promise<void>\n  /** Loudest source by default; `prefer` pins a meter while someone is known to be speaking. */\n  sampleLevel: (prefer?: VoiceLevelEvent['source']) => VoiceLevelEvent | undefined\n  /** Self-mute without ending the live session. */\n  setMuted?: (muted: boolean) => Promise<void>\n  /**\n   * Hand the provider text the caller typed during a live call, as though\n   * they had said it — the assistant answers aloud and the turn lands in the\n   * transcript through the normal provider path. Optional: a provider that\n   * cannot inject text simply omits it and the surface hides the affordance.\n   */\n  sendUserMessage?: (text: string) => void\n}\n\nexport type CreateVoiceProviderClient = (mint: VoiceSessionMint) => Promise<VoiceProviderClient>\n\n/** Keep the realtime SDK out of the initial chat bundle. */\nexport const createVoiceProviderClient: CreateVoiceProviderClient = async (mint) => {\n  const { LiveKitVoiceProvider } = await import('./providers/livekit/provider')\n  return new LiveKitVoiceProvider(mint)\n}\n\nexport const VOICE_SPECTRUM_BANDS = 9\n\n/** Log-spaced speech spectrum for transports that expose FFT bins. */\nexport function voiceSpectrum(frequencies: Uint8Array, sampleRate: number, fftSize: number, bandCount = VOICE_SPECTRUM_BANDS): readonly number[] {\n  if (!Number.isFinite(sampleRate) || sampleRate <= 0 || !Number.isFinite(fftSize) || fftSize <= 0 || bandCount <= 0)\n    return []\n\n  const hzPerBin = sampleRate / fftSize\n  const fromHz = 80\n  const ratio = 4_000 / fromHz\n  const bands: number[] = []\n  for (let band = 0; band < bandCount; band++) {\n    const start = Math.max(0, Math.ceil((fromHz * ratio ** (band / bandCount)) / hzPerBin))\n    const end = Math.min(frequencies.length, Math.ceil((fromHz * ratio ** ((band + 1) / bandCount)) / hzPerBin))\n    if (end <= start) {\n      bands.push(0)\n      continue\n    }\n    let squared = 0\n    for (let index = start; index < end; index++)\n      squared += (frequencies[index] / 255) ** 2\n    bands.push(Math.sqrt(squared / (end - start)))\n  }\n  return bands\n}\n\n/** Equal-width bands for SDKs that already expose voice-range FFT bins. */\nexport function voiceRangeSpectrum(frequencies: Uint8Array, bandCount = VOICE_SPECTRUM_BANDS): readonly number[] {\n  if (!frequencies.length || bandCount <= 0)\n    return []\n  return Array.from({ length: bandCount }, (_, band) => {\n    const start = Math.floor((band * frequencies.length) / bandCount)\n    const end = Math.max(start + 1, Math.floor(((band + 1) * frequencies.length) / bandCount))\n    let squared = 0\n    for (let index = start; index < Math.min(end, frequencies.length); index++)\n      squared += (frequencies[index] / 255) ** 2\n    return Math.sqrt(squared / Math.max(1, Math.min(end, frequencies.length) - start))\n  })\n}\n"],"mappings":";;AAWA,SAAgB,eAAe,GAAwB;CACrD,OAAO,KAAS;AAClB;AA2CA,IAAa,4BAAuD,OAAO,MAAS;CAClF,IAAM,EAAE,4BAAyB,MAAM,OAAO;CAC9C,OAAO,IAAI,EAAqB,CAAI;AACtC;AAKA,SAAgB,cAAc,GAAyB,GAAoB,GAAiB,IAAA,GAAqD;CAC/I,IAAI,CAAC,OAAO,SAAS,CAAU,KAAK,KAAc,KAAK,CAAC,OAAO,SAAS,CAAO,KAAK,KAAW,KAAK,KAAa,GAC/G,OAAO,CAAC;CAEV,IAAM,IAAW,IAAa,GAGxB,IAAkB,CAAC;CACzB,KAAK,IAAI,IAAO,GAAG,IAAO,GAAW,KAAQ;EAC3C,IAAM,IAAQ,KAAK,IAAI,GAAG,KAAK,KAAM,KAAS,OAAU,IAAO,KAAc,CAAQ,CAAC,GAChF,IAAM,KAAK,IAAI,EAAY,QAAQ,KAAK,KAAM,KAAS,QAAW,IAAO,KAAK,KAAc,CAAQ,CAAC;EAC3G,IAAI,KAAO,GAAO;GAChB,EAAM,KAAK,CAAC;GACZ;EACF;EACA,IAAI,IAAU;EACd,KAAK,IAAI,IAAQ,GAAO,IAAQ,GAAK,KACnC,MAAY,EAAY,KAAS,QAAQ;EAC3C,EAAM,KAAK,KAAK,KAAK,KAAW,IAAM,EAAM,CAAC;CAC/C;CACA,OAAO;AACT"}

package/dist/provider2.js

@@ -1,5 +1,5 @@
 import "./rolldown-runtime.js";
-import { s as e } from "./sdkClient.js";
+import { c as e } from "./sdkClient.js";
 import { r as t } from "./provider.js";
 //#region ../../node_modules/.pnpm/livekit-client@2.21.0_@types+dom-mediacapture-record@1.0.22/node_modules/livekit-client/dist/livekit-client.esm.mjs
 function _mergeNamespaces(e, t) {
@@ -18330,26 +18330,26 @@ var JWSSignatureVerificationFailed = class extends JOSEError {
 };
 _defineProperty(JWSSignatureVerificationFailed, "code", "ERR_JWS_SIGNATURE_VERIFICATION_FAILED");
 //#endregion
-//#region agent/voice/providers/livekit/provider.ts
-var $a = 1e4, eo = "lk.agent.state", LiveKitVoiceProvider = class {
+//#region bot/voice/providers/livekit/provider.ts
+var $a = 1e4, eo = "lk.bot.state", LiveKitVoiceProvider = class {
 	constructor(t, n = {}) {
-		e(this, "mint", void 0), e(this, "room", void 0), e(this, "createAnalyser", void 0), e(this, "handlers", void 0), e(this, "cancelReadyWait", void 0), e(this, "analysers", []), e(this, "levelSources", []), e(this, "attachedElements", []), e(this, "closing", !1), e(this, "userSpeaking", !1), e(this, "agentActiveSpeaker", !1), e(this, "agentStateSpeaking", !1), e(this, "lastSpeaking", void 0), this.mint = t, this.room = n.createRoom?.() ?? new Za(), this.createAnalyser = n.createAnalyser;
+		e(this, "mint", void 0), e(this, "room", void 0), e(this, "createAnalyser", void 0), e(this, "handlers", void 0), e(this, "cancelReadyWait", void 0), e(this, "analysers", []), e(this, "levelSources", []), e(this, "attachedElements", []), e(this, "closing", !1), e(this, "userSpeaking", !1), e(this, "botActiveSpeaker", !1), e(this, "botStateSpeaking", !1), e(this, "lastSpeaking", void 0), this.mint = t, this.room = n.createRoom?.() ?? new Za(), this.createAnalyser = n.createAnalyser;
 	}
 	async connect(e) {
 		this.handlers = e, this.room.on(P.TrackSubscribed, (e) => {
 			e.kind === z.Kind.Audio && this.attachRemoteAudio(e);
 		}), this.room.on(P.ParticipantAttributesChanged, (e, t) => {
-			if (!t.isAgent) return;
+			if (!t.isBot) return;
 			let n = t.attributes[eo];
-			this.handlers?.onThinkingChange?.(n === "thinking"), this.agentStateSpeaking = n === "speaking", this.publishSpeaking();
+			this.handlers?.onThinkingChange?.(n === "thinking"), this.botStateSpeaking = n === "speaking", this.publishSpeaking();
 		}), this.room.on(P.ActiveSpeakersChanged, (e) => {
-			this.userSpeaking = e.some((e) => e.isLocal), this.agentActiveSpeaker = e.some((e) => e.isAgent), this.publishSpeaking();
+			this.userSpeaking = e.some((e) => e.isLocal), this.botActiveSpeaker = e.some((e) => e.isBot), this.publishSpeaking();
 		}), this.room.on(P.Disconnected, (e) => {
 			this.closing || this.handlers?.onDisconnected(disconnectCause(e));
 		});
 		let t = "VOICE_CONNECT_FAILED";
 		try {
-			if (await this.room.connect(this.mint.url, this.mint.token), this.closing || (t = "VOICE_MIC_UNAVAILABLE", await this.setMuted(!1), this.closing) || (t = "VOICE_AGENT_UNAVAILABLE", await this.waitForAgentReady(), this.closing)) return;
+			if (await this.room.connect(this.mint.url, this.mint.token), this.closing || (t = "VOICE_MIC_UNAVAILABLE", await this.setMuted(!1), this.closing) || (t = "VOICE_BOT_UNAVAILABLE", await this.waitForBotReady(), this.closing)) return;
 			t = "VOICE_PLAYBACK_UNAVAILABLE", await this.room.startAudio();
 		} catch (e) {
 			let n = e instanceof Error ? e : /* @__PURE__ */ Error("Could not open the voice connection.");
@@ -18393,14 +18393,14 @@ var $a = 1e4, eo = "lk.agent.state", LiveKitVoiceProvider = class {
 	publishSpeaking() {
 		let e = {
 			user: this.userSpeaking,
-			agent: this.agentActiveSpeaker || this.agentStateSpeaking
+			bot: this.botActiveSpeaker || this.botStateSpeaking
 		};
-		this.lastSpeaking?.user === e.user && this.lastSpeaking?.agent === e.agent || (this.lastSpeaking = e, this.handlers?.onSpeakingChange?.(e));
+		this.lastSpeaking?.user === e.user && this.lastSpeaking?.bot === e.bot || (this.lastSpeaking = e, this.handlers?.onSpeakingChange?.(e));
 	}
-	async waitForAgentReady() {
+	async waitForBotReady() {
 		let ready = (e) => {
 			let t = e.attributes[eo];
-			return e.isAgent && (t === "listening" || t === "thinking" || t === "speaking");
+			return e.isBot && (t === "listening" || t === "thinking" || t === "speaking");
 		};
 		[...this.room.remoteParticipants.values()].some(ready) || await new Promise((e, t) => {
 			let n = !1, finish = (i) => {
@@ -18409,7 +18409,7 @@ var $a = 1e4, eo = "lk.agent.state", LiveKitVoiceProvider = class {
 				ready(e) && finish();
 			}, onAttributes = (e, t) => {
 				ready(t) && finish();
-			}, r = setTimeout(() => finish(Object.assign(/* @__PURE__ */ Error("The voice assistant did not become ready."), { code: "VOICE_AGENT_UNAVAILABLE" })), $a);
+			}, r = setTimeout(() => finish(Object.assign(/* @__PURE__ */ Error("The voice assistant did not become ready."), { code: "VOICE_BOT_UNAVAILABLE" })), $a);
 			this.room.on(P.ParticipantConnected, onParticipant), this.room.on(P.ParticipantAttributesChanged, onAttributes), this.cancelReadyWait = () => finish();
 		});
 	}
@@ -18453,7 +18453,7 @@ var $a = 1e4, eo = "lk.agent.state", LiveKitVoiceProvider = class {
 	}
 };
 function disconnectCause(e) {
-	return e === S.ROOM_DELETED || e === S.PARTICIPANT_REMOVED ? "agent" : e === void 0 || e === S.UNKNOWN_REASON ? "unknown" : "network";
+	return e === S.ROOM_DELETED || e === S.PARTICIPANT_REMOVED ? "bot" : e === void 0 || e === S.UNKNOWN_REASON ? "unknown" : "network";
 }
 //#endregion
 export { LiveKitVoiceProvider };