@alfe.ai/agent-api-client 0.3.0 → 0.5.0

package/README.md

@@ -0,0 +1,16 @@
+# @alfe.ai/agent-api-client
+
+Agent self-service API client — agents calling /agents/ endpoints
+
+Part of [**Alfe**](https://alfe.ai) — the operating system for AI agents: build, deploy, and run agents with persistent memory, identity, integrations, and channels. See the [documentation](https://docs.alfe.ai) to get started.
+
+## Install
+
+```bash
+npm install @alfe.ai/agent-api-client
+```
+
+## Links
+
+- 🌐 Website: <https://alfe.ai>
+- 📚 Docs: <https://docs.alfe.ai>

package/dist/index.cjs

@@ -590,12 +590,86 @@ var AgentApiClient = class {
 			body: JSON.stringify({ files })
 		});
 	}
+	/**
+	* Generate an image from a text prompt and get back a STABLE, public URL
+	* (served from the agent-assets CDN — it does not expire). The image is
+	* generated + stored server-side; embed the returned `imageUrl` in a reply as
+	* markdown to show it to the user.
+	*
+	* Unlike most methods this reads the server's error body so a bad-request
+	* detail (e.g. an unsupported `size`) reaches the caller instead of an opaque
+	* "request failed (400)". Not retried — generation is expensive and
+	* non-idempotent.
+	*/
+	async generateImage(args) {
+		const headers = new Headers();
+		headers.set("Authorization", `Bearer ${this.apiKey}`);
+		headers.set("Content-Type", "application/json");
+		const res = await fetch(`${this.apiUrl}/agent/images/generate`, {
+			method: "POST",
+			headers,
+			body: JSON.stringify(args),
+			signal: AbortSignal.timeout(33e3)
+		});
+		if (!res.ok) {
+			const body = await res.text().catch(() => "");
+			let detail = "";
+			try {
+				const parsed = JSON.parse(body);
+				const msg = typeof parsed.message === "string" ? parsed.message : typeof parsed.error === "string" ? parsed.error : "";
+				if (msg) detail = `: ${msg}`;
+			} catch {}
+			throw new Error(`Image generation failed (${String(res.status)})${detail}`);
+		}
+		return (await res.json()).data;
+	}
 	async recordActivity(data) {
 		return this.request("/agent/activity", {
 			method: "POST",
 			body: JSON.stringify(data)
 		});
 	}
+	/** Update the agent's own name and/or voice config. Returns the updated agent. */
+	async updateSelf(update) {
+		return this.request("/agent/self", {
+			method: "PATCH",
+			body: JSON.stringify(update)
+		});
+	}
+	/**
+	* Generate the agent's own avatar from a text prompt. The image is generated,
+	* stored, and set on the agent server-side; returns the updated agent.
+	*/
+	async generateAvatar(args) {
+		return this.request("/agent/avatar/generate", {
+			method: "POST",
+			body: JSON.stringify(args)
+		});
+	}
+	/**
+	* Get a presigned PUT URL to upload a new avatar image. Upload the bytes to
+	* `uploadUrl`, then call `finalizeAvatar(s3Key)` to set it on the agent.
+	*/
+	async presignAvatar(args) {
+		return this.request("/agent/avatar/presign", {
+			method: "POST",
+			body: JSON.stringify(args)
+		});
+	}
+	/**
+	* Finalize an avatar upload — validates ownership + size, then sets the
+	* agent's `avatarUrl` server-side. Returns the updated agent.
+	*/
+	async finalizeAvatar(s3Key) {
+		return this.request("/agent/avatar", {
+			method: "POST",
+			body: JSON.stringify({ s3Key })
+		});
+	}
+	/** List the platform voice catalogue (ElevenLabs) so the agent can pick its own voice. */
+	async listVoices() {
+		return this.request("/agent/voices");
+	}
 	/**
 	* Mint a fresh AES-256 data key for a specific (secret, field) pair. The
 	* encryption context is rebuilt server-side from `auth.tenantId` + the body
@@ -991,6 +1065,104 @@ var AgentApiClient = class {
 			body: JSON.stringify(entry)
 		}).catch(() => {});
 	}
+	async requestBrowserTakeover(args) {
+		return this.request("/agent/remote/takeover", {
+			method: "POST",
+			body: JSON.stringify(args)
+		});
+	}
+	async getRemoteSession(sessionId) {
+		return this.request(`/agent/remote/sessions/${encodeURIComponent(sessionId)}`);
+	}
+	async completeRemoteSession(sessionId) {
+		return this.request(`/agent/remote/sessions/${encodeURIComponent(sessionId)}/complete`, {
+			method: "POST",
+			body: JSON.stringify({})
+		});
+	}
+	/**
+	* Issue a request that returns the raw `Response` (no JSON parsing, no
+	* forced Content-Type). The caller sets `Content-Type`/`Accept` on `headers`
+	* and reads the body itself (`arrayBuffer()` / `json()`).
+	*
+	* A single retry fires only on the same transient statuses `request()`
+	* retries (authorizer-timeout 500 + LB 502/503/504) and transient network
+	* errors — before the route handler runs — so re-issuing a POST does not
+	* risk a duplicate side effect. Voice TTS/STT are effectively idempotent
+	* (re-synthesize / re-transcribe) and meter server-side keyed on the
+	* gateway requestId, so a retried transcription doesn't double-bill.
+	*/
+	async rawFetch(path, init) {
+		const url = `${this.apiUrl}${path}`;
+		init.headers.set("Authorization", `Bearer ${this.apiKey}`);
+		let lastError;
+		for (let attempt = 1; attempt <= 2; attempt++) try {
+			const res = await fetch(url, {
+				method: init.method,
+				headers: init.headers,
+				body: init.body,
+				signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+			});
+			if (!res.ok) {
+				await res.text();
+				const error = /* @__PURE__ */ new Error(`Agent API request failed (${String(res.status)})`);
+				if (attempt === 1 && RETRYABLE_STATUS.has(res.status)) {
+					lastError = error;
+					await sleep(RETRY_DELAY_MS);
+					continue;
+				}
+				throw error;
+			}
+			return res;
+		} catch (err) {
+			if (attempt === 1 && isRetryableNetworkError(err)) {
+				lastError = err;
+				await sleep(RETRY_DELAY_MS);
+				continue;
+			}
+			throw err;
+		}
+		throw lastError instanceof Error ? lastError : new Error(String(lastError));
+	}
+	/**
+	* Text-to-speech. Returns raw PCM audio bytes plus their framing — the
+	* voice service defaults to 24 kHz / mono / 16-bit. Wrap in a WAV container
+	* to produce a playable file. Metered per character against the tenant
+	* credit pool server-side; TTS completes regardless of metering outcome.
+	*/
+	async tts(args) {
+		const headers = new Headers();
+		headers.set("Content-Type", "application/json");
+		headers.set("Accept", "audio/pcm");
+		const res = await this.rawFetch("/voice/tts", {
+			method: "POST",
+			headers,
+			body: JSON.stringify(args)
+		});
+		return {
+			audio: Buffer.from(await res.arrayBuffer()),
+			sampleRate: parseInt(res.headers.get("x-sample-rate") ?? "24000", 10),
+			channels: parseInt(res.headers.get("x-channels") ?? "1", 10),
+			bitDepth: parseInt(res.headers.get("x-bit-depth") ?? "16", 10)
+		};
+	}
+	/**
+	* Speech-to-text. Accepts raw linear16 (16-bit LE) mono PCM — NOT a WAV or
+	* other container (the endpoint transcribes with a fixed linear16 encoding,
+	* so a container header would be transcribed as noise). Strip any WAV header
+	* and pass `sampleRate` from it before calling. Metered by transcribed
+	* duration against the tenant credit pool server-side.
+	*/
+	async stt(args) {
+		const headers = new Headers();
+		headers.set("Content-Type", "application/octet-stream");
+		headers.set("x-sample-rate", String(args.sampleRate));
+		return (await (await this.rawFetch("/voice/stt", {
+			method: "POST",
+			headers,
+			body: args.audio
+		})).json()).data;
+	}
 };
 //#endregion
 exports.AgentApiClient = AgentApiClient;

package/dist/index.d.cts

@@ -6,6 +6,15 @@ interface AgentApiClientConfig {
   apiKey: string;
   apiUrl: string;
 }
+interface RemoteSessionInfo {
+  sessionId: string;
+  agentId: string;
+  surface: "browser" | "terminal";
+  status: "agent_driving" | "awaiting_human" | "human_in_control" | "resuming" | "completed" | "expired" | "failed";
+  url?: string;
+  instructions?: string;
+  requestedAt?: string;
+}
 interface SyncAgentInfo {
   agentId: string;
   tenantId: string;
@@ -146,6 +155,79 @@ interface KnowledgeDoc {
   createdAt: string;
   updatedAt: string;
 }
+/** Voice settings — core agent config. Mirrors `VoiceConfig` in `@alfe/types`. */
+interface AgentVoiceConfig {
+  /** ElevenLabs voice ID; platform default when unset. */
+  voiceId?: string;
+  ttsModel?: string;
+  enabled?: boolean;
+}
+/**
+ * The agent's own public identity, as returned by `updateSelf`, `generateAvatar`,
+ * `presignAvatar`'s finalize (`finalizeAvatar`). This is the public agent
+ * projection; only the identity-relevant fields are typed here — the response
+ * carries the full public agent record.
+ */
+interface AgentSelf {
+  agentId: string;
+  tenantId: string;
+  name: string;
+  avatarUrl?: string;
+  voiceConfig?: AgentVoiceConfig;
+  status: string;
+}
+/** Result of `presignAvatar` — the agent PUTs bytes to `uploadUrl`, then finalizes with `s3Key`. */
+interface AgentAvatarPresign {
+  /** Presigned PUT URL to upload the image bytes to. */
+  uploadUrl: string;
+  /** Object key — echoed back to `finalizeAvatar`. */
+  s3Key: string;
+  /** Stable public URL the avatar will be served from once finalized. */
+  publicUrl: string;
+  /** ISO expiry of the presigned PUT URL. */
+  expiresAt: string;
+}
+/** A voice in the platform catalogue (ElevenLabs), from `listVoices`. */
+interface AgentVoice {
+  id: string;
+  name: string;
+  previewUrl: string;
+  description: string;
+  labels: Record<string, string>;
+  category: string;
+}
+/** The ElevenLabs models with a pricing row — the TTS endpoint rejects any other value. */
+type VoiceTtsModel = "eleven_turbo_v2_5" | "eleven_multilingual_v2";
+interface VoiceTtsArgs {
+  /** Text to synthesize (1–5000 chars — the endpoint enforces this). */
+  text: string;
+  /** ElevenLabs voice id; platform default when unset. */
+  voiceId?: string;
+  /** TTS model; `eleven_turbo_v2_5` (lower latency) when unset. */
+  model?: VoiceTtsModel;
+}
+/** Raw synthesized audio plus its PCM framing (from the response headers). */
+interface VoiceTtsResult {
+  /** Raw little-endian PCM samples — no container. Wrap in WAV to make a playable file. */
+  audio: Buffer;
+  /** Samples per second (e.g. 24000). */
+  sampleRate: number;
+  /** Channel count (mono = 1). */
+  channels: number;
+  /** Bits per sample (e.g. 16). */
+  bitDepth: number;
+}
+interface VoiceSttArgs {
+  /** Raw linear16 (16-bit little-endian) mono PCM samples — no WAV/container header. */
+  audio: Uint8Array;
+  /** Sample rate of `audio` in Hz (8000–48000). */
+  sampleRate: number;
+}
+interface VoiceSttResult {
+  text: string;
+  /** Deepgram confidence in (0,1]. */
+  confidence: number;
+}
 declare class AgentApiClient {
   private readonly apiKey;
   private readonly apiUrl;
@@ -662,6 +744,26 @@ declare class AgentApiClient {
       expiresAt: string;
     }[];
   }>;
+  /**
+   * Generate an image from a text prompt and get back a STABLE, public URL
+   * (served from the agent-assets CDN — it does not expire). The image is
+   * generated + stored server-side; embed the returned `imageUrl` in a reply as
+   * markdown to show it to the user.
+   *
+   * Unlike most methods this reads the server's error body so a bad-request
+   * detail (e.g. an unsupported `size`) reaches the caller instead of an opaque
+   * "request failed (400)". Not retried — generation is expensive and
+   * non-idempotent.
+   */
+  generateImage(args: {
+    prompt: string;
+    model?: string;
+    size?: string;
+    quality?: string;
+  }): Promise<{
+    imageUrl: string;
+    model: string;
+  }>;
   recordActivity(data: {
     userId?: string;
     channel: string;
@@ -669,6 +771,35 @@ declare class AgentApiClient {
   }): Promise<{
     recorded: boolean;
   }>;
+  /** Update the agent's own name and/or voice config. Returns the updated agent. */
+  updateSelf(update: {
+    name?: string;
+    voiceConfig?: AgentVoiceConfig;
+  }): Promise<AgentSelf>;
+  /**
+   * Generate the agent's own avatar from a text prompt. The image is generated,
+   * stored, and set on the agent server-side; returns the updated agent.
+   */
+  generateAvatar(args: {
+    prompt: string;
+  }): Promise<AgentSelf>;
+  /**
+   * Get a presigned PUT URL to upload a new avatar image. Upload the bytes to
+   * `uploadUrl`, then call `finalizeAvatar(s3Key)` to set it on the agent.
+   */
+  presignAvatar(args: {
+    mimeType: string;
+    size: number;
+  }): Promise<AgentAvatarPresign>;
+  /**
+   * Finalize an avatar upload — validates ownership + size, then sets the
+   * agent's `avatarUrl` server-side. Returns the updated agent.
+   */
+  finalizeAvatar(s3Key: string): Promise<AgentSelf>;
+  /** List the platform voice catalogue (ElevenLabs) so the agent can pick its own voice. */
+  listVoices(): Promise<{
+    voices: AgentVoice[];
+  }>;
   /**
    * Mint a fresh AES-256 data key for a specific (secret, field) pair. The
    * encryption context is rebuilt server-side from `auth.tenantId` + the body
@@ -1163,8 +1294,48 @@ declare class AgentApiClient {
     operation: string;
     summary?: string;
   }): Promise<void>;
+  requestBrowserTakeover(args: {
+    instructions: string;
+    url?: string;
+    conversationId?: string;
+  }): Promise<{
+    sessionId: string;
+    status: string;
+  }>;
+  getRemoteSession(sessionId: string): Promise<RemoteSessionInfo>;
+  completeRemoteSession(sessionId: string): Promise<{
+    ok: boolean;
+  }>;
+  /**
+   * Issue a request that returns the raw `Response` (no JSON parsing, no
+   * forced Content-Type). The caller sets `Content-Type`/`Accept` on `headers`
+   * and reads the body itself (`arrayBuffer()` / `json()`).
+   *
+   * A single retry fires only on the same transient statuses `request()`
+   * retries (authorizer-timeout 500 + LB 502/503/504) and transient network
+   * errors — before the route handler runs — so re-issuing a POST does not
+   * risk a duplicate side effect. Voice TTS/STT are effectively idempotent
+   * (re-synthesize / re-transcribe) and meter server-side keyed on the
+   * gateway requestId, so a retried transcription doesn't double-bill.
+   */
+  private rawFetch;
+  /**
+   * Text-to-speech. Returns raw PCM audio bytes plus their framing — the
+   * voice service defaults to 24 kHz / mono / 16-bit. Wrap in a WAV container
+   * to produce a playable file. Metered per character against the tenant
+   * credit pool server-side; TTS completes regardless of metering outcome.
+   */
+  tts(args: VoiceTtsArgs): Promise<VoiceTtsResult>;
+  /**
+   * Speech-to-text. Accepts raw linear16 (16-bit LE) mono PCM — NOT a WAV or
+   * other container (the endpoint transcribes with a fixed linear16 encoding,
+   * so a container header would be transcribed as noise). Strip any WAV header
+   * and pass `sampleRate` from it before calling. Metered by transcribed
+   * duration against the tenant credit pool server-side.
+   */
+  stt(args: VoiceSttArgs): Promise<VoiceSttResult>;
 }
 //# sourceMappingURL=index.d.ts.map
 //#endregion
-export { AgentApiClient, AgentApiClientConfig, type ChangelogAction, type ChangelogActor, type ChangelogEntry, type EncryptedEnvelopeV1, type Field, type FieldEnvelope, type FieldFormat, type FieldSensitivity, type FieldView, type GeneratedDataKey, type IntegrationConfigResult, type IntegrationConfigSchemaField, type IntegrationInstall, KnowledgeDoc, KnowledgeFact, KnowledgeProfile, KnowledgeProfileLink, KnowledgeScope, KnowledgeScopeType, KnowledgeSearchHit, KnowledgeSearchResult, type RegistryEntry, type ScopeInfo, type SecretAggregate, type SecretCategory, type SecretMetadata, type SecretScope, SharedFileEntry, SyncAgentInfo, SyncAgentStats, SyncConfirmedUpload, SyncFileEntry, SyncManifest, SyncManifestEntry, SyncPresignedUrl, SyncReconstructBundle, SyncReconstructFile, SyncSessionContent, SyncSessionEntry };
+export { AgentApiClient, AgentApiClientConfig, AgentAvatarPresign, AgentSelf, AgentVoice, AgentVoiceConfig, type ChangelogAction, type ChangelogActor, type ChangelogEntry, type EncryptedEnvelopeV1, type Field, type FieldEnvelope, type FieldFormat, type FieldSensitivity, type FieldView, type GeneratedDataKey, type IntegrationConfigResult, type IntegrationConfigSchemaField, type IntegrationInstall, KnowledgeDoc, KnowledgeFact, KnowledgeProfile, KnowledgeProfileLink, KnowledgeScope, KnowledgeScopeType, KnowledgeSearchHit, KnowledgeSearchResult, type RegistryEntry, RemoteSessionInfo, type ScopeInfo, type SecretAggregate, type SecretCategory, type SecretMetadata, type SecretScope, SharedFileEntry, SyncAgentInfo, SyncAgentStats, SyncConfirmedUpload, SyncFileEntry, SyncManifest, SyncManifestEntry, SyncPresignedUrl, SyncReconstructBundle, SyncReconstructFile, SyncSessionContent, SyncSessionEntry, VoiceSttArgs, VoiceSttResult, VoiceTtsArgs, VoiceTtsModel, VoiceTtsResult };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;AA8ES,UA/BQ,oBAAA,CA+BR;EAAM,MAAA,EAAA,MAAA;EAGE,MAAA,EAAA,MAAA;AAMjB;AAQiB,UAzCA,aAAA,CAyCmB;EAQnB,OAAA,EAAA,MAAA;EASA,QAAA,EAAA,MAAA;EAQA,WAAA,EAAA,MAAa;EASb,QAAA,EAAA,MAAA;EAQA,MAAA,EAAA,OAAA,GAAA,SAAkB,GAAA,QAAA;EAMlB,SAAA,CAAA,EAAA,MAAe;EAepB,SAAA,CAAA,EAAA,MAAA;EAEK,QAAA,CAAA,EAAA,MAAc;AAM/B;AAciB,UAnHA,iBAAA,CAmHqB;EAMrB,IAAA,EAAA,MAAA;EAKA,IAAA,EAAA,MAAA;EAAgB,QAAA,EAAA,MAAA;MACpB,CAAA,EAAA,MAAA;cAIJ,CAAA,EAAA,MAAA;EAAoB,UAAA,CAAA,EAAA,OAAA;AAK7B;AAWiB,UA1IA,YAAA,CA0IY;EA4ChB,OAAA,EAAA,CAAA;EAAc,OAAA,EAAA,MAAA;UAIL,EAAA,MAAA;OAoEkD,EA1P/D,MA0P+D,CAAA,MAAA,EA1PhD,iBA0PgD,CAAA;;AAOrC,UA9PlB,gBAAA,CA8PkB;MAAR,EAAA,MAAA;KAML,EAAA,MAAA;WAAhB,EAAA,MAAA;;AAYA,UA1QW,mBAAA,CA0QX;UASQ,EAAA,MAAA;MAAR,EAAA,MAAA;MAO0B,EAAA,MAAA;cAAR,EAAA,UAAA,GAAA,YAAA;UAI4C,EAAA,MAAA;;AAOpB,UA7R/B,mBAAA,CA6R+B;MAApB,EAAA,MAAA;MAIuB,EAAA,MAAA;KAAR,EAAA,MAAA;cAID,CAAA,EAAA,MAAA;YAcnB,CAAA,EAAA,OAAA;;AAUjB,UArTW,qBAAA,CAqTX;SAM8B,EAAA,MAAA;MAAR,EAAA,MAAA,GAAA,QAAA,GAAA,QAAA;WAIiC,EAAA,MAAA;WAAR,EAAA,MAAA;OAQzC,EAlUH,mBAkUG,EAAA;WACP,EAAA,MAAA;;AAaQ,UA5UI,cAAA,CA4UJ;SAAR,EAAA,MAAA;eAWqD,EAAA,MAAA;cAAR,EAAA,MAAA;WAU7C,EAAA,MAAA;YAQyD,EAAA,MAAA,GAAA,IAAA;;AAMf,UAvW9B,aAAA,CAuW8B;UAAxB,EAAA,MAAA;MAcS,EAAA,MAAA;UAoCgB,EAAA,MAAA;aAiBZ,EAAA,MAAA;cA4Bb,CAAA,EAAA,MAAA;YALiC,CAAA,EAAA,OAAA;;AAmD3B,UA3eZ,gBAAA,CA2eY;WAyCC,EAAA,MAAA;MA2BH,EAAA,MAAA;cAoCC,EAAA,MAAA;cAa2B,CAAA,EAAA,MAAA;YAwBvB,EAAA,OAAA;;AAuEG,UAvrBlB,kBAAA,CAurBkB;WAoCF,EAAA,MAAA;SA6BD,EAAA,MAAA;YA4EiC,EAAA,OAAA;;AAsDtC,UAp3BV,eAAA,CAo3BU;UAwCC,EAAA,MAAA;UAYQ,EAAA,MAAA;MA0BH,EAAA,MAAA;aA4CqB,CAAA,EAAA,MAAA;;AA+EtB,KA9iCpB,kBAAA,GA8iCoB,KAAA,GAAA,MAAA,GAAA,SAAA;AAgEiC,UA5mChD,cAAA,CA4mCgD;WAmBlC,EA9nClB,kBA8nCkB;SAgBZ,EAAA,MAAA;MACb,EAAA,MAAA;;AAaqF,UAvpC1E,kBAAA,CAupC0E;MAarF,MAAA;MAmCK,EAAA,MAAA;;OAIL,EAAA,MAAA;WAcK,EAptCE,kBAotCF;SAKL,EAAA,MAAA;QAcK,EAAA,KAAA,GAAA,MAAA;;UASI,CAAA,EAAA,MAAA;;QAGE,CAAA,EAAA,MAAA;;AAGX,UA7uCW,qBAAA,CA6uCX;SAaK,EAzvCA,kBAyvCA,EAAA;;iBAG4C,EAAA,OAAA;;AAQ5C,UA/vCM,oBAAA,CA+vCN;OAMM,EAAA,MAAA;KACJ,EAAA,MAAA;;AAHP,UA9vCW,gBAAA,CA8vCX;WAiBK,EA9wCE,kBA8wCF;SAIM,EAAA,MAAA;OACJ,EAAA,MAAA,GAAA,IAAA;aAEE,EAAA,MAAA,GAAA,IAAA;OAET,EAnxCG,oBAmxCH,EAAA;WAUK,EAAA,MAAA,GAAA,IAAA;WAIL,EAAA,MAAA,GAAA,IAAA;;AAeS,UA3yCE,aAAA,CA2yCF;QAED,EAAA,MAAA;WAAR,EA3yCO,kBA2yCP;SAUK,EAAA,MAAA;MAEI,EAAA,MAAA;YAGD,EAAA,MAAA;WAAR,EAAA,MAAA;WAcK,EAAA,MAAA;WAKc,EAAA,MAAA;;AAYd,UAh1CM,YAAA,CAg1CN;UAGL,EAAA,MAAA;UAQ8B,EAAA,MAAA;aAAR,CAAA,EAAA,MAAA;MAmBV,EAAA,MAAA;YASZ,CAAA,EAAA,MAAA;WAsBA,EAAA,MAAA;WAS0C,EAAA,MAAA;;AAkB1C,cA53CO,cAAA,CA43CP;mBAWA,MAAA;mBAWA,MAAA;aASA,CAAA,MAAA,EAv5CgB,oBAu5ChB;UAUA,OAAA;cAkBA,CAAA,KAAA,EAAA;IAiBA,WAAA,CAAA,EAAA,MAAA;MAh4CiD,OA25ClD,CAAA;IAeC,KAAA,EA16CkE,aA06ClE;;iBA2CA,CAAA,CAAA,EA98CqB,OA88CrB,CA98C6B,YA88C7B,CAAA;aAsBA,CAAA,IAAA,EAAA;IAYwD,KAAA,EAAA;MAWjB,IAAA,EAAA,MAAA;MAOnB,SAAA,EAAA,KAAA,GAAA,KAAA;MAOc,WAAA,CAAA,EAAA,MAAA;IAMjB,CAAA,EAAA;MAzgDjB,OAuhDA,CAAA;IAiB2B,IAAA,EAxiDX,gBAwiDW,EAAA;;mBAgB3B,CAAA,IAAA,EAAA;IAUA,QAAA,EAAA,MAAA;IAWA,IAAA,EAAA,MAAA;IA2BmC,IAAA,EAAA,MAAA;IAC5B,YAAA,CAAA,EAAA,UAAA,GAAA,YAAA;MA7lDP,OA6lDD,CA7lDS,mBA6lDT,CAAA;iBAamC,CAAA,IAAA,EAAA;IAAlB,IAAA,EAAA,MAAA,GAAA,QAAA,GAAA,QAAA;MAjmDhB,OAumDS,CAvmDD,qBAumDC,CAAA;cAEF,CAAA,CAAA,EAlmDW,OAkmDX,CAlmDmB,cAkmDnB,CAAA;eAAR,CAAA,KAAA,EAAA;IAQU,MAAA,CAAA,EAAA,MAAA;MAtmDoC,OAymD7B,CAAA;IAAjB,KAAA,EAzmD+D,aAymD/D,EAAA;;kBAoBQ,CAAA,CAAA,EAtnDe,OAsnDf,CAAA;IAAR,QAAA,EAtnD2C,gBAsnD3C,EAAA;;gBAYA,CAAA,SAAA,EAAA,MAAA,CAAA,EA9nDsC,OA8nDtC,CA9nD8C,kBA8nD9C,CAAA;gBASU,CAAA,QAAA,EAAA,MAAA,CAAA,EAnoD2B,OAmoD3B,CAAA;IAGO,OAAA,EAAA,OAAA;;iBAgBP,CAAA,IAAA,EAAA;IAGV,KAAA,EAAA,KAAA,GAAA,MAAA,GAAA,SAAA;IAqBU,OAAA,EAAA,MAAA;MAhqDT,OAqqDD,CAAA;IAgCkC,KAAA,EArsDhB,eAqsDgB,EAAA;IAcjC,UAAA,EAAA,MAAA,GAAA,IAAA;EAAO,CAAA,CAAA;;;;;MAzsDP;;;;sBAMsB,QAAQ;+CAIiB,QAAQ;yDAQjD,0BACP;;;aAYsC;MACtC,QAAQ;4CAWqC,QAAQ;oDAUrD;;;;;oCAQA;;;aAAyD;;iBAMvC;kBAAwB;;;;;;;;;;;;0BAcf;;;;;;;;;;0CAoCgB;;;;;;;8BAiBZ;;;;;;;;;;;;;;;;;;;;kDAuBoB;;;;;uBAKjC;;;;;;;;;;;0BAgBS;;;;;;;;;;;;;;;;;;uBA8BH;;;;;;;;;;;;;;;;;wBAyCC;;;;;;;;;;;;;;qBA2BH;;;;;;;;;;;sBAoCC;;;;;;;;;;iDAa2B;;;;;;;;;;0BAwBvB;;;;;;;;;;;;uBA0BH;;;;;;;;;;;;;;;;;;;6BA6CM;;;;;;;;;;;;2BAoCF;;;;;;;;;;;;;;;;;;;;;;;;;;0BA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DA4EiC;;;;;;;;;;wBAwBnC;;;;;;;;;;;;;;qBA8BH;;;;;;;;;;;;sBAwCC;;;;;;;;;8BAYQ;;;;;;;;;;;;2BA0BH;;;;;;;;;;;;;;;;;gDA4CqB;;;;;;;;;;;;;;;;;;6BA+BnB;;;;;;;;;;;;;;;;;;;;;;;;;0BAgDH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DAgEiC;;;;;yBAmBlC;;;;;;;;;;;;;mBAgBZ;MACb;;;;uBAOuB;;;;;;;;;;;QAM8D;;;;;;;;;;;;;MAarF;;;;;;;;;;;;WAmCK;;;;MAIL,QAAQ;;;;;;;;WAcH;;;;;MAKL;;;;;;;;;;WAcK;;;;eAII;;;;;eAKA;mBACI;;iBAEF;;;MAGX,QAAQ;;;WAaH;;;MAGL;eAAqB;eAA4B;;;;WAQ5C;;;;MAIL;;iBAEW;aACJ;;eAEE;;;;;;;WAYJ;;;;iBAIM;aACJ;;eAEE;;MAET;;;;;;WAUK;;;;MAIL;;;WASK;;;;;;eAMI;;MAET,QAAQ;;;WAUH;;eAEI;;;MAGT,QAAQ;;;WAcH;;;;;MAKL;aAAmB;;;;;WAYd;;;MAGL;;sBAQsB,QAAQ;;;;;;;;;;YAmBlB;;;;;;;;;MASZ;;;;;;;;;;;;;;;;MAsBA;;;0CAS0C;;;;;;;;;;MAS1C;;;;;;;;;;MASA;;;;;;;;;;;;MAWA;;;;;;;;;;;MAWA;;;;;MASA;;;;;;;;;;MAUA;;;;;;;;;;;;;;;;;;MAkBA;;;;;;;;;;;;;;;;MAiBA;;;;;;;;;;;;;;;;;;MA2BD;;;;;;;;;;;MAeC;;;;;;;;;;MAqBA;;;;;;;;;;;;;;;;;;;;;;;;MAsBA;;;;;;;;;;;;MAsBA;;;;wDAYwD;;;;uCAWjB;;;;;;;;;;;oBAOnB;;;;;;;;kCAOc;;;iBAMjB;;;;;;;;;;;;;;;MAcjB;;;;;;2BAiB2B;;;;+BAII;;;;;;;;;;MAY/B;;;;MAUA;;;;;MAWA;;;;;;;;;gBA2BmC;;MACpC,QAAQ;;gBAaS;YAAkB;;;6BAMzB,sCAEV,QAAQ;;4BAQE;;;MAGV;WAAiB;;;;;;;;;6BAiBP,oDAGV,QAAQ;;6BASE,sDAGV;;;;2BASU;;;MAGV;WAAiB;;;;;;;;0BAgBP,wDAGV;;;;;;;;;;;2BAqBU;;;MAKV;;;iCAgCkC;;;;;;;;;;;MAcjC"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;AAiGwB,UAlDP,oBAAA,CAkDO;QAAf,EAAA,MAAA;EAAM,MAAA,EAAA,MAAA;AAGf;AAMiB,UApDA,iBAAA,CAoDmB;EAQnB,SAAA,EAAA,MAAA;EAQA,OAAA,EAAA,MAAA;EASA,OAAA,EAAA,SAAc,GAAA,UAAA;EAQd,MAAA,EAAA,eAAa,GAAA,gBAAA,GAAA,kBAAA,GAAA,UAAA,GAAA,WAAA,GAAA,SAAA,GAAA,QAAA;EASb,GAAA,CAAA,EAAA,MAAA;EAQA,YAAA,CAAA,EAAA,MAAkB;EAMlB,WAAA,CAAA,EAAA,MAAe;AAehC;AAEiB,UA1GA,aAAA,CA0Gc;EAMd,OAAA,EAAA,MAAA;EAcA,QAAA,EAAA,MAAA;EAMA,WAAA,EAAA,MAAA;EAKA,QAAA,EAAA,MAAA;EAAgB,MAAA,EAAA,OAAA,GAAA,SAAA,GAAA,QAAA;WACpB,CAAA,EAAA,MAAA;WAIJ,CAAA,EAAA,MAAA;EAAoB,QAAA,CAAA,EAAA,MAAA;AAK7B;AAWiB,UAnJA,iBAAA,CAmJY;EAkDZ,IAAA,EAAA,MAAA;EAaA,IAAA,EAAA,MAAS;EAUT,QAAA,EAAA,MAAA;EAYA,IAAA,CAAA,EAAA,MAAU;EAoBf,YAAA,CAAA,EAAA,MAAa;EAER,UAAA,CAAA,EAAA,OAAY;AAU7B;AAWiB,UA1QA,YAAA,CA4QR;EAKQ,OAAA,EAAA,CAAA;EAMJ,OAAA,EAAA,MAAA;EAAc,QAAA,EAAA,MAAA;OAIL,EAvRb,MAuRa,CAAA,MAAA,EAvRE,iBAuRF,CAAA;;AAoEiC,UAxVtC,gBAAA,CAwVsC;MAOpB,EAAA,MAAA;KAAR,EAAA,MAAA;WAML,EAAA,MAAA;;AAYR,UA3WG,mBAAA,CA2WH;UAAR,EAAA,MAAA;MASQ,EAAA,MAAA;MAAR,EAAA,MAAA;cAO0B,EAAA,UAAA,GAAA,YAAA;UAAR,EAAA,MAAA;;AAI2B,UAvXlC,mBAAA,CAuXkC;MAOH,EAAA,MAAA;MAApB,EAAA,MAAA;KAIuB,EAAA,MAAA;cAAR,CAAA,EAAA,MAAA;YAID,CAAA,EAAA,OAAA;;AAcpC,UA5YW,qBAAA,CA4YX;SAUA,EAAA,MAAA;MAM8B,EAAA,MAAA,GAAA,QAAA,GAAA,QAAA;WAAR,EAAA,MAAA;WAIiC,EAAA,MAAA;OAAR,EA3Z5C,mBA2Z4C,EAAA;WAQzC,EAAA,MAAA;;AAa+B,UA5a1B,cAAA,CA4a0B;SAC9B,EAAA,MAAA;eAAR,EAAA,MAAA;cAWqD,EAAA,MAAA;WAAR,EAAA,MAAA;YAU7C,EAAA,MAAA,GAAA,IAAA;;AAQA,UAlcY,aAAA,CAkcZ;UAM0C,EAAA,MAAA;MAAxB,EAAA,MAAA;UAcS,EAAA,MAAA;aAoCgB,EAAA,MAAA;cAiBZ,CAAA,EAAA,MAAA;YA4Bb,CAAA,EAAA,OAAA;;AAgBS,UA9iBf,gBAAA,CA8iBe;WA8BH,EAAA,MAAA;MAyCC,EAAA,MAAA;cA2BH,EAAA,MAAA;cAoCC,CAAA,EAAA,MAAA;YAa2B,EAAA,OAAA;;AAkD1B,UA3uBZ,kBAAA,CA2uBY;WA6CM,EAAA,MAAA;SAoCF,EAAA,MAAA;YA6BD,EAAA,OAAA;;AAoGF,UAv7Bb,eAAA,CAu7Ba;UA8BH,EAAA,MAAA;UAwCC,EAAA,MAAA;MAYQ,EAAA,MAAA;aA0BH,CAAA,EAAA,MAAA;;AA2EE,KA/lCvB,kBAAA,GA+lCuB,KAAA,GAAA,MAAA,GAAA,SAAA;AAgDH,UA7oCf,cAAA,CA6oCe;WAgEiC,EA5sCpD,kBA4sCoD;SAmBlC,EAAA,MAAA;MAgBZ,EAAA,MAAA;;AAQU,UAlvCZ,kBAAA,CAkvCY;MAM8D,MAAA;MAyBrF,EAAA,MAAA;;OAuDoD,EAAA,MAAA;WAA6B,EAn0C1E,kBAm0C0E;SAAR,EAAA,MAAA;QAWrB,EAAA,KAAA,GAAA,MAAA;;UAWe,CAAA,EAAA,MAAA;;QAW1B,CAAA,EAAA,MAAA;;AAQP,UAn2CvB,qBAAA,CAm2CuB;SAAlB,EAl2CX,kBAk2CW,EAAA;;iBAoCR,EAAA,OAAA;;AAcH,UA/4CM,oBAAA,CA+4CN;OAKL,EAAA,MAAA;KAcK,EAAA,MAAA;;AASI,UAt6CE,gBAAA,CAs6CF;WACI,EAt6CN,kBAs6CM;SAEF,EAAA,MAAA;OAGH,EAAA,MAAA,GAAA,IAAA;aAAR,EAAA,MAAA,GAAA,IAAA;OAaK,EAp7CF,oBAo7CE,EAAA;WAGgB,EAAA,MAAA,GAAA,IAAA;WAA4B,EAAA,MAAA,GAAA,IAAA;;AAQ5C,UA17CM,aAAA,CA07CN;QAMM,EAAA,MAAA;WACJ,EA/7CA,kBA+7CA;SAEE,EAAA,MAAA;MALT,EAAA,MAAA;YAiBK,EAAA,MAAA;WAIM,EAAA,MAAA;WACJ,EAAA,MAAA;WAEE,EAAA,MAAA;;AAYJ,UAv9CM,YAAA,CAu9CN;UAIL,EAAA,MAAA;UASK,EAAA,MAAA;aAMI,CAAA,EAAA,MAAA;MAED,EAAA,MAAA;YAAR,CAAA,EAAA,MAAA;WAUK,EAAA,MAAA;WAEI,EAAA,MAAA;;;AAiBJ,UAv9CM,gBAAA,CAu9CN;;SAKL,CAAA,EAAA,MAAA;UAYK,CAAA,EAAA,MAAA;SAGL,CAAA,EAAA,OAAA;;;;;;;;AAqFA,UAnjDW,SAAA,CAmjDX;SAWA,EAAA,MAAA;UAWA,EAAA,MAAA;MASA,EAAA,MAAA;WAUA,CAAA,EAAA,MAAA;aAkBA,CAAA,EAzmDU,gBAymDV;QAiBA,EAAA,MAAA;;;AA+DA,UAprDW,kBAAA,CAorDX;;WA4CA,EAAA,MAAA;;OAuBuC,EAAA,MAAA;;WAcL,EAAA,MAAA;;WAoBlC,EAAA,MAAA;;;AAiCA,UA9yDW,UAAA,CA8yDX;MAUA,MAAA;MAWA,EAAA,MAAA;YA2BmC,EAAA,MAAA;aAC5B,EAAA,MAAA;QAAR,EA11DK,MA01DL,CAAA,MAAA,EAAA,MAAA,CAAA;UAamC,EAAA,MAAA;;;AAQ3B,KAh2DD,aAAA,GAg2DC,mBAAA,GAAA,wBAAA;AAAR,UA91DY,YAAA,CA81DZ;;MAWiB,EAAA,MAAA;;SAiBP,CAAA,EAAA,MAAA;;OAGV,CAAA,EAv3DK,aAu3DL;;;AAqBU,UAx4DE,cAAA,CAw4DF;;OAGV,EAz4DI,MAy4DJ;;YAmBA,EAAA,MAAA;;UA0BA,EAAA,MAAA;;UA8CC,EAAA,MAAA;;AA4B+C,UAv/DpC,YAAA,CAu/DoC;;OAIH,EAz/DzC,UAy/DyC;;YA0ET,EAAA,MAAA;;AAyBvB,UAvlED,cAAA,CAulEC;MAAuB,EAAA,MAAA;;EAAD,UAAA,EAAA,MAAA;;cAjlE3B,cAAA;;;sBAIS;;;;MAoEiC;WAAiB;;qBAO7C,QAAQ;;;;;;;MAM7B;UAAgB;;;;;;;MAYhB,QAAQ;;;MASR,QAAQ;kBAOU,QAAQ;;;MAImB;WAAiB;;sBAOxC;cAAoB;;qCAIL,QAAQ;oCAIT;;;;;;MAcpC;WAAiB;;;;;;;MAUjB;;;;sBAMsB,QAAQ;+CAIiB,QAAQ;yDAQjD,0BACP;;;aAYsC;MACtC,QAAQ;4CAWqC,QAAQ;oDAUrD;;;;;oCAQA;;;aAAyD;;iBAMvC;kBAAwB;;;;;;;;;;;;0BAcf;;;;;;;;;;0CAoCgB;;;;;;;8BAiBZ;;;;;;;;;;;;;;;;;;;;kDAuBoB;;;;;uBAKjC;;;;;;;;;;;0BAgBS;;;;;;;;;;;;;;;;;;uBA8BH;;;;;;;;;;;;;;;;;wBAyCC;;;;;;;;;;;;;;qBA2BH;;;;;;;;;;;sBAoCC;;;;;;;;;;iDAa2B;;;;;;;;;;0BAwBvB;;;;;;;;;;;;uBA0BH;;;;;;;;;;;;;;;;;;;6BA6CM;;;;;;;;;;;;2BAoCF;;;;;;;;;;;;;;;;;;;;;;;;;;0BA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DA4EiC;;;;;;;;;;wBAwBnC;;;;;;;;;;;;;;qBA8BH;;;;;;;;;;;;sBAwCC;;;;;;;;;8BAYQ;;;;;;;;;;;;2BA0BH;;;;;;;;;;;;;;;;;gDA4CqB;;;;;;;;;;;;;;;;;;6BA+BnB;;;;;;;;;;;;;;;;;;;;;;;;;0BAgDH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DAgEiC;;;;;yBAmBlC;;;;;;;;;;;;;mBAgBZ;MACb;;;;uBAOuB;;;;;;;;;;;QAM8D;;;;;;;;;;;;;;;;;;;;;;;;;MAyBrF;;;;;;;;MAwCA;;;;;;kBAeoD;MAAqB,QAAQ;;;;;;;MAWrC,QAAQ;;;;;;;;MAWO,QAAQ;;;;;iCAWlC,QAAQ;;gBAQzB;YAAkB;;;;;;;;;;;WAgC7B;;;;MAIL,QAAQ;;;;;;;;WAcH;;;;;MAKL;;;;;;;;;;WAcK;;;;eAII;;;;;eAKA;mBACI;;iBAEF;;;MAGX,QAAQ;;;WAaH;;;MAGL;eAAqB;eAA4B;;;;WAQ5C;;;;MAIL;;iBAEW;aACJ;;eAEE;;;;;;;WAYJ;;;;iBAIM;aACJ;;eAEE;;MAET;;;;;;WAUK;;;;MAIL;;;WASK;;;;;;eAMI;;MAET,QAAQ;;;WAUH;;eAEI;;;MAGT,QAAQ;;;WAcH;;;;;MAKL;aAAmB;;;;;WAYd;;;MAGL;;sBAQsB,QAAQ;;;;;;;;;;YAmBlB;;;;;;;;;MASZ;;;;;;;;;;;;;;;;MAsBA;;;0CAS0C;;;;;;;;;;MAS1C;;;;;;;;;;MASA;;;;;;;;;;;;MAWA;;;;;;;;;;;MAWA;;;;;MASA;;;;;;;;;;MAUA;;;;;;;;;;;;;;;;;;MAkBA;;;;;;;;;;;;;;;;MAiBA;;;;;;;;;;;;;;;;;;MA2BD;;;;;;;;;;;MAeC;;;;;;;;;;MAqBA;;;;;;;;;;;;;;;;;;;;;;;;MAsBA;;;;;;;;;;;;MAsBA;;;;wDAYwD;;;;uCAWjB;;;;;;;;;;;oBAOnB;;;;;;;;kCAOc;;;iBAMjB;;;;;;;;;;;;;;;MAcjB;;;;;;2BAiB2B;;;;+BAII;;;;;;;;;;MAY/B;;;;MAUA;;;;;MAWA;;;;;;;;;gBA2BmC;;MACpC,QAAQ;;gBAaS;YAAkB;;;6BAMzB,sCAEV,QAAQ;;4BAQE;;;MAGV;WAAiB;;;;;;;;;6BAiBP,oDAGV,QAAQ;;6BASE,sDAGV;;;;2BASU;;;MAGV;WAAiB;;;;;;;;0BAgBP,wDAGV;;;;;;;;;;;2BAqBU;;;MAKV;;;iCAgCkC;;;;;;;;;;;MAcjC;;;;;MAqBA;;;;uCAOuC,QAAQ;4CAIH;;;;;;;;;;;;;;;;;;;;;;YA0EhC,eAAe,QAAQ;;;;;;;;YAyBvB,eAAe,QAAQ"}

package/dist/index.d.ts

@@ -6,6 +6,15 @@ interface AgentApiClientConfig {
   apiKey: string;
   apiUrl: string;
 }
+interface RemoteSessionInfo {
+  sessionId: string;
+  agentId: string;
+  surface: "browser" | "terminal";
+  status: "agent_driving" | "awaiting_human" | "human_in_control" | "resuming" | "completed" | "expired" | "failed";
+  url?: string;
+  instructions?: string;
+  requestedAt?: string;
+}
 interface SyncAgentInfo {
   agentId: string;
   tenantId: string;
@@ -146,6 +155,79 @@ interface KnowledgeDoc {
   createdAt: string;
   updatedAt: string;
 }
+/** Voice settings — core agent config. Mirrors `VoiceConfig` in `@alfe/types`. */
+interface AgentVoiceConfig {
+  /** ElevenLabs voice ID; platform default when unset. */
+  voiceId?: string;
+  ttsModel?: string;
+  enabled?: boolean;
+}
+/**
+ * The agent's own public identity, as returned by `updateSelf`, `generateAvatar`,
+ * `presignAvatar`'s finalize (`finalizeAvatar`). This is the public agent
+ * projection; only the identity-relevant fields are typed here — the response
+ * carries the full public agent record.
+ */
+interface AgentSelf {
+  agentId: string;
+  tenantId: string;
+  name: string;
+  avatarUrl?: string;
+  voiceConfig?: AgentVoiceConfig;
+  status: string;
+}
+/** Result of `presignAvatar` — the agent PUTs bytes to `uploadUrl`, then finalizes with `s3Key`. */
+interface AgentAvatarPresign {
+  /** Presigned PUT URL to upload the image bytes to. */
+  uploadUrl: string;
+  /** Object key — echoed back to `finalizeAvatar`. */
+  s3Key: string;
+  /** Stable public URL the avatar will be served from once finalized. */
+  publicUrl: string;
+  /** ISO expiry of the presigned PUT URL. */
+  expiresAt: string;
+}
+/** A voice in the platform catalogue (ElevenLabs), from `listVoices`. */
+interface AgentVoice {
+  id: string;
+  name: string;
+  previewUrl: string;
+  description: string;
+  labels: Record<string, string>;
+  category: string;
+}
+/** The ElevenLabs models with a pricing row — the TTS endpoint rejects any other value. */
+type VoiceTtsModel = "eleven_turbo_v2_5" | "eleven_multilingual_v2";
+interface VoiceTtsArgs {
+  /** Text to synthesize (1–5000 chars — the endpoint enforces this). */
+  text: string;
+  /** ElevenLabs voice id; platform default when unset. */
+  voiceId?: string;
+  /** TTS model; `eleven_turbo_v2_5` (lower latency) when unset. */
+  model?: VoiceTtsModel;
+}
+/** Raw synthesized audio plus its PCM framing (from the response headers). */
+interface VoiceTtsResult {
+  /** Raw little-endian PCM samples — no container. Wrap in WAV to make a playable file. */
+  audio: Buffer;
+  /** Samples per second (e.g. 24000). */
+  sampleRate: number;
+  /** Channel count (mono = 1). */
+  channels: number;
+  /** Bits per sample (e.g. 16). */
+  bitDepth: number;
+}
+interface VoiceSttArgs {
+  /** Raw linear16 (16-bit little-endian) mono PCM samples — no WAV/container header. */
+  audio: Uint8Array;
+  /** Sample rate of `audio` in Hz (8000–48000). */
+  sampleRate: number;
+}
+interface VoiceSttResult {
+  text: string;
+  /** Deepgram confidence in (0,1]. */
+  confidence: number;
+}
 declare class AgentApiClient {
   private readonly apiKey;
   private readonly apiUrl;
@@ -662,6 +744,26 @@ declare class AgentApiClient {
       expiresAt: string;
     }[];
   }>;
+  /**
+   * Generate an image from a text prompt and get back a STABLE, public URL
+   * (served from the agent-assets CDN — it does not expire). The image is
+   * generated + stored server-side; embed the returned `imageUrl` in a reply as
+   * markdown to show it to the user.
+   *
+   * Unlike most methods this reads the server's error body so a bad-request
+   * detail (e.g. an unsupported `size`) reaches the caller instead of an opaque
+   * "request failed (400)". Not retried — generation is expensive and
+   * non-idempotent.
+   */
+  generateImage(args: {
+    prompt: string;
+    model?: string;
+    size?: string;
+    quality?: string;
+  }): Promise<{
+    imageUrl: string;
+    model: string;
+  }>;
   recordActivity(data: {
     userId?: string;
     channel: string;
@@ -669,6 +771,35 @@ declare class AgentApiClient {
   }): Promise<{
     recorded: boolean;
   }>;
+  /** Update the agent's own name and/or voice config. Returns the updated agent. */
+  updateSelf(update: {
+    name?: string;
+    voiceConfig?: AgentVoiceConfig;
+  }): Promise<AgentSelf>;
+  /**
+   * Generate the agent's own avatar from a text prompt. The image is generated,
+   * stored, and set on the agent server-side; returns the updated agent.
+   */
+  generateAvatar(args: {
+    prompt: string;
+  }): Promise<AgentSelf>;
+  /**
+   * Get a presigned PUT URL to upload a new avatar image. Upload the bytes to
+   * `uploadUrl`, then call `finalizeAvatar(s3Key)` to set it on the agent.
+   */
+  presignAvatar(args: {
+    mimeType: string;
+    size: number;
+  }): Promise<AgentAvatarPresign>;
+  /**
+   * Finalize an avatar upload — validates ownership + size, then sets the
+   * agent's `avatarUrl` server-side. Returns the updated agent.
+   */
+  finalizeAvatar(s3Key: string): Promise<AgentSelf>;
+  /** List the platform voice catalogue (ElevenLabs) so the agent can pick its own voice. */
+  listVoices(): Promise<{
+    voices: AgentVoice[];
+  }>;
   /**
    * Mint a fresh AES-256 data key for a specific (secret, field) pair. The
    * encryption context is rebuilt server-side from `auth.tenantId` + the body
@@ -1163,8 +1294,48 @@ declare class AgentApiClient {
     operation: string;
     summary?: string;
   }): Promise<void>;
+  requestBrowserTakeover(args: {
+    instructions: string;
+    url?: string;
+    conversationId?: string;
+  }): Promise<{
+    sessionId: string;
+    status: string;
+  }>;
+  getRemoteSession(sessionId: string): Promise<RemoteSessionInfo>;
+  completeRemoteSession(sessionId: string): Promise<{
+    ok: boolean;
+  }>;
+  /**
+   * Issue a request that returns the raw `Response` (no JSON parsing, no
+   * forced Content-Type). The caller sets `Content-Type`/`Accept` on `headers`
+   * and reads the body itself (`arrayBuffer()` / `json()`).
+   *
+   * A single retry fires only on the same transient statuses `request()`
+   * retries (authorizer-timeout 500 + LB 502/503/504) and transient network
+   * errors — before the route handler runs — so re-issuing a POST does not
+   * risk a duplicate side effect. Voice TTS/STT are effectively idempotent
+   * (re-synthesize / re-transcribe) and meter server-side keyed on the
+   * gateway requestId, so a retried transcription doesn't double-bill.
+   */
+  private rawFetch;
+  /**
+   * Text-to-speech. Returns raw PCM audio bytes plus their framing — the
+   * voice service defaults to 24 kHz / mono / 16-bit. Wrap in a WAV container
+   * to produce a playable file. Metered per character against the tenant
+   * credit pool server-side; TTS completes regardless of metering outcome.
+   */
+  tts(args: VoiceTtsArgs): Promise<VoiceTtsResult>;
+  /**
+   * Speech-to-text. Accepts raw linear16 (16-bit LE) mono PCM — NOT a WAV or
+   * other container (the endpoint transcribes with a fixed linear16 encoding,
+   * so a container header would be transcribed as noise). Strip any WAV header
+   * and pass `sampleRate` from it before calling. Metered by transcribed
+   * duration against the tenant credit pool server-side.
+   */
+  stt(args: VoiceSttArgs): Promise<VoiceSttResult>;
 }
 //# sourceMappingURL=index.d.ts.map
 //#endregion
-export { AgentApiClient, AgentApiClientConfig, type ChangelogAction, type ChangelogActor, type ChangelogEntry, type EncryptedEnvelopeV1, type Field, type FieldEnvelope, type FieldFormat, type FieldSensitivity, type FieldView, type GeneratedDataKey, type IntegrationConfigResult, type IntegrationConfigSchemaField, type IntegrationInstall, KnowledgeDoc, KnowledgeFact, KnowledgeProfile, KnowledgeProfileLink, KnowledgeScope, KnowledgeScopeType, KnowledgeSearchHit, KnowledgeSearchResult, type RegistryEntry, type ScopeInfo, type SecretAggregate, type SecretCategory, type SecretMetadata, type SecretScope, SharedFileEntry, SyncAgentInfo, SyncAgentStats, SyncConfirmedUpload, SyncFileEntry, SyncManifest, SyncManifestEntry, SyncPresignedUrl, SyncReconstructBundle, SyncReconstructFile, SyncSessionContent, SyncSessionEntry };
+export { AgentApiClient, AgentApiClientConfig, AgentAvatarPresign, AgentSelf, AgentVoice, AgentVoiceConfig, type ChangelogAction, type ChangelogActor, type ChangelogEntry, type EncryptedEnvelopeV1, type Field, type FieldEnvelope, type FieldFormat, type FieldSensitivity, type FieldView, type GeneratedDataKey, type IntegrationConfigResult, type IntegrationConfigSchemaField, type IntegrationInstall, KnowledgeDoc, KnowledgeFact, KnowledgeProfile, KnowledgeProfileLink, KnowledgeScope, KnowledgeScopeType, KnowledgeSearchHit, KnowledgeSearchResult, type RegistryEntry, RemoteSessionInfo, type ScopeInfo, type SecretAggregate, type SecretCategory, type SecretMetadata, type SecretScope, SharedFileEntry, SyncAgentInfo, SyncAgentStats, SyncConfirmedUpload, SyncFileEntry, SyncManifest, SyncManifestEntry, SyncPresignedUrl, SyncReconstructBundle, SyncReconstructFile, SyncSessionContent, SyncSessionEntry, VoiceSttArgs, VoiceSttResult, VoiceTtsArgs, VoiceTtsModel, VoiceTtsResult };
 //# sourceMappingURL=index.d.ts.map