@alfe.ai/agent-api-client 0.2.3 → 0.4.0

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;
@@ -283,7 +365,7 @@ declare class AgentApiClient {
    * @deprecated Returns a single primary credential blob (legacy "pick-the-
    * default-connection" shape). Use `getGithubAccounts()` for the multi-
    * account shape required by Pattern A — explicit selector args on every
-   * tool. Retained because the `@alfe.ai/openclaw-github` proxy is the
+   * tool. Retained because the `@alfe.ai/github-mcp` proxy is the
    * only consumer that knows about Pattern A; legacy env-interpolation
    * callers will keep hitting `/credentials` until they move to the proxy.
    */
@@ -512,6 +594,45 @@ declare class AgentApiClient {
     accessToken: string;
     expiresAt: string;
   }>;
+  /**
+   * @deprecated Returns a single primary credential blob. Use
+   * `getSalesforceAccounts()` for the multi-account shape required by
+   * Pattern A.
+   */
+  getSalesforceCredentials(): Promise<{
+    accessToken: string;
+    accessTokenExpiresAt: string;
+    instanceUrl: string;
+    orgId: string;
+  }>;
+  /**
+   * Pattern A: multi-account credential fetch for Salesforce. Returns every
+   * agent-scoped Salesforce connection. One OAuth grant maps to one org, so
+   * `accounts[i].accountIdentifier` (and `orgId`) is the Salesforce org id —
+   * the selector every credential-touching tool requires.
+   */
+  getSalesforceAccounts(): Promise<{
+    accounts: {
+      connectionId: string;
+      accountIdentifier: string;
+      displayName: string | null;
+      connectedAt: string;
+      accessToken: string;
+      accessTokenExpiresAt: string;
+      instanceUrl: string;
+      orgId: string;
+    }[];
+  }>;
+  /**
+   * Refresh the access token for a specific Salesforce org. Salesforce
+   * tokens aren't interchangeable across orgs, so the connection is targeted
+   * by `accountIdentifier` (the org id) — mirrors `refreshXeroAccountToken`.
+   */
+  refreshSalesforceAccountToken(orgId: string): Promise<{
+    accessToken: string;
+    accessTokenExpiresAt: string;
+    expiresAt: string;
+  }>;
   /**
    * Microsoft 365 (delegated OAuth) credential fetch — single-account shape.
    *
@@ -630,6 +751,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
@@ -1124,8 +1274,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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":"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"}

package/dist/index.js

@@ -202,7 +202,7 @@ var AgentApiClient = class {
 	* @deprecated Returns a single primary credential blob (legacy "pick-the-
 	* default-connection" shape). Use `getGithubAccounts()` for the multi-
 	* account shape required by Pattern A — explicit selector args on every
-	* tool. Retained because the `@alfe.ai/openclaw-github` proxy is the
+	* tool. Retained because the `@alfe.ai/github-mcp` proxy is the
 	* only consumer that knows about Pattern A; legacy env-interpolation
 	* callers will keep hitting `/credentials` until they move to the proxy.
 	*/
@@ -446,6 +446,52 @@ var AgentApiClient = class {
 		return this.request("/agent/connect/myob/refresh", { method: "POST" });
 	}
 	/**
+	* @deprecated Returns a single primary credential blob. Use
+	* `getSalesforceAccounts()` for the multi-account shape required by
+	* Pattern A.
+	*/
+	async getSalesforceCredentials() {
+		const raw = await this.request("/agent/connect/salesforce/credentials");
+		return {
+			accessToken: raw.accessToken,
+			accessTokenExpiresAt: raw.accessTokenExpiresAt ?? "",
+			instanceUrl: raw.instanceUrl ?? "",
+			orgId: raw.orgId ?? ""
+		};
+	}
+	/**
+	* Pattern A: multi-account credential fetch for Salesforce. Returns every
+	* agent-scoped Salesforce connection. One OAuth grant maps to one org, so
+	* `accounts[i].accountIdentifier` (and `orgId`) is the Salesforce org id —
+	* the selector every credential-touching tool requires.
+	*/
+	async getSalesforceAccounts() {
+		return { accounts: (await this.request("/agent/connect/salesforce/accounts")).accounts.map((a) => ({
+			connectionId: a.connectionId,
+			accountIdentifier: a.accountIdentifier,
+			displayName: a.displayName,
+			connectedAt: a.connectedAt,
+			accessToken: a.accessToken,
+			accessTokenExpiresAt: a.accessTokenExpiresAt ?? "",
+			instanceUrl: a.instanceUrl ?? "",
+			orgId: a.orgId ?? a.accountIdentifier
+		})) };
+	}
+	/**
+	* Refresh the access token for a specific Salesforce org. Salesforce
+	* tokens aren't interchangeable across orgs, so the connection is targeted
+	* by `accountIdentifier` (the org id) — mirrors `refreshXeroAccountToken`.
+	*/
+	async refreshSalesforceAccountToken(orgId) {
+		const path = `/agent/connect/salesforce/accounts/${encodeURIComponent(orgId)}/refresh`;
+		const raw = await this.request(path, { method: "POST" });
+		return {
+			accessToken: raw.accessToken,
+			accessTokenExpiresAt: raw.accessTokenExpiresAt ?? "",
+			expiresAt: raw.expiresAt ?? ""
+		};
+	}
+	/**
 	* Microsoft 365 (delegated OAuth) credential fetch — single-account shape.
 	*
 	* @deprecated Use `getMicrosoftAccounts()` and dispatch via the `email`
@@ -549,6 +595,47 @@ var AgentApiClient = class {
 			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
@@ -944,6 +1031,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
 export { AgentApiClient };