@sonzai-labs/agents 1.0.2 → 1.0.6

package/dist/index.cjs

@@ -71,7 +71,7 @@ var HTTPClient = class {
     this.headers = {
       Authorization: `Bearer ${options.apiKey}`,
       "Content-Type": "application/json",
-      "User-Agent": "sonzai-typescript/1.13.0"
+      "User-Agent": "sonzai-typescript/1.0.3"
     };
     this.timeout = options.timeout;
     this.maxRetries = options.maxRetries;
@@ -115,8 +115,9 @@ var HTTPClient = class {
     throw new InternalServerError("Max retries exceeded");
   }
   async backoff(attempt) {
-    const delay = Math.min(1e3 * 2 ** attempt, 1e4) + Math.random() * 500;
-    await new Promise((resolve) => setTimeout(resolve, delay));
+    const base = Math.min(100 * 2 ** attempt, 5e3);
+    const jitter = Math.random() * base;
+    await new Promise((resolve) => setTimeout(resolve, base + jitter));
   }
   isNetworkError(error) {
     if (error instanceof SonzaiError) return false;
@@ -886,6 +887,53 @@ var Voice = class {
   async stream(token) {
     return VoiceStreamInstance.connect(token);
   }
+  /**
+   * Convert text to speech audio.
+   *
+   * @example
+   * ```ts
+   * const result = await client.agents.voice.tts(agentId, {
+   *   text: "Hello, how are you?",
+   *   voiceName: "Kore",
+   *   outputFormat: "wav",
+   * });
+   * // result.audio is base64-encoded WAV
+   * ```
+   */
+  async tts(agentId, options) {
+    const body = { text: options.text };
+    if (options.voiceName) body.voiceName = options.voiceName;
+    if (options.language) body.language = options.language;
+    if (options.outputFormat) body.outputFormat = options.outputFormat;
+    return this.http.post(
+      `/api/v1/agents/${agentId}/voice/tts`,
+      body
+    );
+  }
+  /**
+   * Transcribe audio to text.
+   *
+   * @example
+   * ```ts
+   * const result = await client.agents.voice.stt(agentId, {
+   *   audio: base64Audio,
+   *   audioFormat: "audio/wav",
+   *   language: "en-US",
+   * });
+   * console.log(result.transcript);
+   * ```
+   */
+  async stt(agentId, options) {
+    const body = {
+      audio: options.audio,
+      audioFormat: options.audioFormat
+    };
+    if (options.language) body.language = options.language;
+    return this.http.post(
+      `/api/v1/agents/${agentId}/voice/stt`,
+      body
+    );
+  }
 };
 var VoiceStreamInstance = class _VoiceStreamInstance {
   ws;
@@ -1464,6 +1512,59 @@ var Agents = class {
   async deleteCustomTool(agentId, toolName) {
     return this.http.delete(`/api/v1/agents/${agentId}/tools/${toolName}`);
   }
+  // -- Avatar Generation --
+  /** Trigger avatar generation for an agent. */
+  async generateAvatar(agentId, options) {
+    return this.http.post(
+      `/api/v1/agents/${agentId}/avatar/generate`,
+      options ?? {}
+    );
+  }
+  // -- Process (full pipeline) --
+  /**
+   * Run the full Context Engine pipeline on conversation messages without
+   * generating a chat response. Extracts side effects via LLM, processes
+   * behavioral updates (mood, personality, habits, interests, relationships),
+   * stores memories, and runs session-end analysis.
+   */
+  async process(agentId, options) {
+    requireNonEmpty(agentId, "agentId");
+    requireNonEmpty(options.userId, "options.userId");
+    const body = {
+      userId: options.userId,
+      messages: options.messages
+    };
+    if (options.sessionId) body.sessionId = options.sessionId;
+    if (options.instanceId) body.instanceId = options.instanceId;
+    if (options.provider) body.provider = options.provider;
+    if (options.model) body.model = options.model;
+    if (options.includeExtractions) body.include_extractions = options.includeExtractions;
+    return this.http.post(`/api/v1/agents/${agentId}/process`, body);
+  }
+  /** Get available LLM providers and models for the /process endpoint. */
+  async getModels(agentId) {
+    return this.http.get(`/api/v1/agents/${agentId}/models`);
+  }
+  // -- Context (single-call enriched context) --
+  /**
+   * Get the full enriched agent context in a single call.
+   * Returns all 7 layers (personality, mood, memory, relationships, goals, etc.)
+   * This replaces multiple individual API calls with one round-trip.
+   */
+  async getContext(agentId, options) {
+    requireNonEmpty(agentId, "agentId");
+    requireNonEmpty(options.userId, "options.userId");
+    const params = { userId: options.userId };
+    if (options.sessionId) params.sessionId = options.sessionId;
+    if (options.instanceId) params.instanceId = options.instanceId;
+    if (options.query) params.query = options.query;
+    if (options.language) params.language = options.language;
+    if (options.timezone) params.timezone = options.timezone;
+    return this.http.get(
+      `/api/v1/agents/${agentId}/context`,
+      params
+    );
+  }
   // -- Consolidation --
   /** Trigger memory consolidation for an agent. */
   async consolidate(agentId, options) {
@@ -1484,6 +1585,17 @@ var Agents = class {
     if (options.instanceId) params.instance_id = options.instanceId;
     return this.http.get(`/api/v1/agents/${agentId}/timemachine`, params);
   }
+  // -- Knowledge Search (tool endpoint) --
+  /** Search the knowledge base for an agent. */
+  async knowledgeSearch(agentId, options) {
+    requireNonEmpty(agentId, "agentId");
+    const body = { query: options.query };
+    if (options.limit != null) body.limit = options.limit;
+    return this.http.post(
+      `/api/v1/agents/${agentId}/tools/knowledge-search`,
+      body
+    );
+  }
   buildChatBody(options) {
     const body = { messages: options.messages };
     if (options.userId) body.user_id = options.userId;
@@ -1510,6 +1622,30 @@ var Agents = class {
   }
 };
 
+// src/resources/custom-llm.ts
+var CustomLLM = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Get the custom LLM config for a project. */
+  async get(projectId) {
+    return this.http.get(
+      `/api/v1/projects/${projectId}/custom-llm`
+    );
+  }
+  /** Set or update the custom LLM config. */
+  async set(projectId, options) {
+    return this.http.put(
+      `/api/v1/projects/${projectId}/custom-llm`,
+      options
+    );
+  }
+  /** Delete the custom LLM config. */
+  async delete(projectId) {
+    await this.http.delete(`/api/v1/projects/${projectId}/custom-llm`);
+  }
+};
+
 // src/resources/eval-runs.ts
 var EvalRuns = class {
   constructor(http) {
@@ -1814,6 +1950,72 @@ var Knowledge = class {
   }
 };
 
+// src/resources/project-config.ts
+var ProjectConfig = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** List all config entries for a project. */
+  async list(projectId) {
+    return this.http.get(
+      `/api/v1/projects/${projectId}/config`
+    );
+  }
+  /** Get a config value by key. Returns the raw JSON value. */
+  async get(projectId, key) {
+    return this.http.get(
+      `/api/v1/projects/${projectId}/config/${key}`
+    );
+  }
+  /** Set a config value. Body must be valid JSON. */
+  async set(projectId, key, value) {
+    return this.http.put(
+      `/api/v1/projects/${projectId}/config/${key}`,
+      value
+    );
+  }
+  /** Delete a config entry. */
+  async delete(projectId, key) {
+    await this.http.delete(`/api/v1/projects/${projectId}/config/${key}`);
+  }
+};
+
+// src/resources/project-notifications.ts
+var ProjectNotifications = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** List pending notifications for a project. */
+  async list(projectId, options = {}) {
+    const params = {};
+    if (options.agentId) params.agent_id = options.agentId;
+    if (options.eventType) params.event_type = options.eventType;
+    if (options.limit) params.limit = String(options.limit);
+    return this.http.get(
+      `/api/v1/projects/${projectId}/notifications`,
+      params
+    );
+  }
+  /** Acknowledge specific notifications by ID. */
+  async acknowledge(projectId, options) {
+    return this.http.post(
+      `/api/v1/projects/${projectId}/notifications/acknowledge`,
+      { notification_ids: options.notificationIds }
+    );
+  }
+  /** Acknowledge all pending notifications for a project. */
+  async acknowledgeAll(projectId, options = {}) {
+    const params = {};
+    if (options.agentId) params.agent_id = options.agentId;
+    if (options.eventType) params.event_type = options.eventType;
+    return this.http.post(
+      `/api/v1/projects/${projectId}/notifications/acknowledge-all`,
+      {},
+      params
+    );
+  }
+};
+
 // src/resources/webhooks.ts
 var Webhooks = class {
   constructor(http) {
@@ -1850,6 +2052,42 @@ var Webhooks = class {
       `/api/v1/webhooks/${eventType}/rotate-secret`
     );
   }
+  // -- Project-scoped webhooks --
+  /** Register (or update) a webhook for a specific project and event type. */
+  async registerForProject(projectId, eventType, options) {
+    const body = {
+      webhook_url: options.webhookUrl
+    };
+    if (options.authHeader) body.auth_header = options.authHeader;
+    return this.http.put(
+      `/api/v1/projects/${projectId}/webhooks/${eventType}`,
+      body
+    );
+  }
+  /** List all webhooks for a project. */
+  async listForProject(projectId) {
+    return this.http.get(
+      `/api/v1/projects/${projectId}/webhooks`
+    );
+  }
+  /** Delete a webhook for a project event type. */
+  async deleteForProject(projectId, eventType) {
+    await this.http.delete(
+      `/api/v1/projects/${projectId}/webhooks/${eventType}`
+    );
+  }
+  /** List delivery attempts for a project webhook event type. */
+  async listDeliveryAttemptsForProject(projectId, eventType) {
+    return this.http.get(
+      `/api/v1/projects/${projectId}/webhooks/${eventType}/attempts`
+    );
+  }
+  /** Rotate the signing secret for a project webhook event type. */
+  async rotateSecretForProject(projectId, eventType) {
+    return this.http.post(
+      `/api/v1/projects/${projectId}/webhooks/${eventType}/rotate-secret`
+    );
+  }
 };
 
 // src/client.ts
@@ -1896,6 +2134,12 @@ var Sonzai = class {
   evalRuns;
   voices;
   webhooks;
+  /** Project-scoped configuration (key-value store). */
+  projectConfig;
+  /** Project-scoped custom LLM provider configuration. */
+  customLLM;
+  /** Project-scoped notification polling for game backends. */
+  projectNotifications;
   http;
   constructor(config) {
     const apiKey = resolveApiKey(config);
@@ -1912,6 +2156,9 @@ var Sonzai = class {
     this.evalRuns = new EvalRuns(this.http);
     this.voices = new Voices(this.http);
     this.webhooks = new Webhooks(this.http);
+    this.projectConfig = new ProjectConfig(this.http);
+    this.customLLM = new CustomLLM(this.http);
+    this.projectNotifications = new ProjectNotifications(this.http);
   }
 };