@estuary-ai/sdk 0.1.1 → 0.1.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 estuary.ai
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 estuary.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,152 +1,152 @@
-# @estuary-ai/sdk
-
-TypeScript SDK for the [Estuary](https://www.estuary-ai.com) real-time AI conversation platform. Build applications with persistent AI characters that remember, hear, and see.
-
-## Installation
-
-```bash
-npm install @estuary-ai/sdk
-```
-
-For LiveKit voice (optional, lower latency):
-
-```bash
-npm install @estuary-ai/sdk livekit-client
-```
-
-## Quick Start
-
-```typescript
-import { EstuaryClient } from '@estuary-ai/sdk';
-
-const client = new EstuaryClient({
-  serverUrl: 'https://api.estuary-ai.com',
-  apiKey: 'est_your_api_key',
-  characterId: 'your-character-id',
-  playerId: 'user-123',
-});
-
-client.on('botResponse', (response) => {
-  process.stdout.write(response.text);
-  if (response.isFinal) console.log();
-});
-
-await client.connect();
-client.sendText('Hello!');
-```
-
-## Features
-
-### Text Chat
-
-```typescript
-client.sendText('What do you remember about me?');
-client.sendText('Just respond in text', true); // textOnly mode
-```
-
-### Voice (WebSocket)
-
-```typescript
-const client = new EstuaryClient({
-  serverUrl: 'https://api.estuary-ai.com',
-  apiKey: 'est_...',
-  characterId: '...',
-  playerId: '...',
-  voiceTransport: 'websocket',
-});
-
-await client.connect();
-await client.startVoice(); // Requests mic permission
-// ... speak, receive audio responses
-client.stopVoice();
-```
-
-### Voice (LiveKit)
-
-```typescript
-const client = new EstuaryClient({
-  // ...
-  voiceTransport: 'livekit', // or 'auto' to prefer LiveKit
-});
-
-await client.connect();
-await client.startVoice();
-client.toggleMute();
-```
-
-### Memory & Knowledge Graph
-
-```typescript
-const memories = await client.memory.getMemories({ status: 'active', limit: 50 });
-const facts = await client.memory.getCoreFacts();
-const graph = await client.memory.getGraph({ includeEntities: true });
-const results = await client.memory.search('favorite food');
-```
-
-### Real-Time Memory Extraction
-
-Enable `realtimeMemory` to receive live notifications when the server extracts memories from conversation:
-
-```typescript
-const client = new EstuaryClient({
-  serverUrl: 'https://api.estuary-ai.com',
-  apiKey: 'est_...',
-  characterId: '...',
-  playerId: '...',
-  realtimeMemory: true,
-});
-
-client.on('memoryUpdated', (event) => {
-  console.log(`Extracted ${event.memoriesExtracted} memories, ${event.factsExtracted} facts`);
-  for (const mem of event.newMemories) {
-    console.log(`  [${mem.memoryType}] ${mem.content} (confidence: ${mem.confidence})`);
-  }
-});
-
-await client.connect();
-```
-
-## Events
-
-```typescript
-client.on('connected', (session) => { /* authenticated */ });
-client.on('disconnected', (reason) => { /* lost connection */ });
-client.on('botResponse', (response) => { /* streaming text */ });
-client.on('botVoice', (voice) => { /* audio chunk */ });
-client.on('sttResponse', (stt) => { /* speech-to-text */ });
-client.on('interrupt', (data) => { /* response interrupted */ });
-client.on('memoryUpdated', (event) => { /* real-time memory extraction */ });
-client.on('error', (error) => { /* EstuaryError */ });
-client.on('quotaExceeded', (data) => { /* rate limited */ });
-```
-
-## Configuration
-
-```typescript
-interface EstuaryConfig {
-  serverUrl: string;           // Server URL
-  apiKey: string;              // API key (est_...)
-  characterId: string;         // Character ID
-  playerId: string;            // End user ID
-  audioSampleRate?: number;    // Default: 16000
-  autoReconnect?: boolean;     // Default: true
-  maxReconnectAttempts?: number; // Default: 5
-  reconnectDelayMs?: number;   // Default: 2000
-  debug?: boolean;             // Default: false
-  voiceTransport?: 'websocket' | 'livekit' | 'auto'; // Default: 'auto'
-  realtimeMemory?: boolean;    // Enable real-time memory extraction events. Default: false
-}
-```
-
-## Requirements
-
-- Node.js 18+ or modern browser
-- Estuary account with API key and Character ID
-
-## Documentation
-
-Full documentation at [docs.estuary-ai.com](https://docs.estuary-ai.com/docs/typescript-sdk/getting-started).
-
-## License
-
-MIT
+# @estuary-ai/sdk
+
+TypeScript SDK for the [Estuary](https://www.estuary-ai.com) real-time AI conversation platform. Build applications with persistent AI characters that remember, hear, and see.
+
+## Installation
+
+```bash
+npm install @estuary-ai/sdk
+```
+
+For LiveKit voice (optional, lower latency):
+
+```bash
+npm install @estuary-ai/sdk livekit-client
+```
+
+## Quick Start
+
+```typescript
+import { EstuaryClient } from '@estuary-ai/sdk';
+
+const client = new EstuaryClient({
+  serverUrl: 'https://api.estuary-ai.com',
+  apiKey: 'est_your_api_key',
+  characterId: 'your-character-id',
+  playerId: 'user-123',
+});
+
+client.on('botResponse', (response) => {
+  process.stdout.write(response.text);
+  if (response.isFinal) console.log();
+});
+
+await client.connect();
+client.sendText('Hello!');
+```
+
+## Features
+
+### Text Chat
+
+```typescript
+client.sendText('What do you remember about me?');
+client.sendText('Just respond in text', true); // textOnly mode
+```
+
+### Voice (WebSocket)
+
+```typescript
+const client = new EstuaryClient({
+  serverUrl: 'https://api.estuary-ai.com',
+  apiKey: 'est_...',
+  characterId: '...',
+  playerId: '...',
+  voiceTransport: 'websocket',
+});
+
+await client.connect();
+await client.startVoice(); // Requests mic permission
+// ... speak, receive audio responses
+client.stopVoice();
+```
+
+### Voice (LiveKit)
+
+```typescript
+const client = new EstuaryClient({
+  // ...
+  voiceTransport: 'livekit', // or 'auto' to prefer LiveKit
+});
+
+await client.connect();
+await client.startVoice();
+client.toggleMute();
+```
+
+### Memory & Knowledge Graph
+
+```typescript
+const memories = await client.memory.getMemories({ status: 'active', limit: 50 });
+const facts = await client.memory.getCoreFacts();
+const graph = await client.memory.getGraph({ includeEntities: true });
+const results = await client.memory.search('favorite food');
+```
+
+### Real-Time Memory Extraction
+
+Enable `realtimeMemory` to receive live notifications when the server extracts memories from conversation:
+
+```typescript
+const client = new EstuaryClient({
+  serverUrl: 'https://api.estuary-ai.com',
+  apiKey: 'est_...',
+  characterId: '...',
+  playerId: '...',
+  realtimeMemory: true,
+});
+
+client.on('memoryUpdated', (event) => {
+  console.log(`Extracted ${event.memoriesExtracted} memories, ${event.factsExtracted} facts`);
+  for (const mem of event.newMemories) {
+    console.log(`  [${mem.memoryType}] ${mem.content} (confidence: ${mem.confidence})`);
+  }
+});
+
+await client.connect();
+```
+
+## Events
+
+```typescript
+client.on('connected', (session) => { /* authenticated */ });
+client.on('disconnected', (reason) => { /* lost connection */ });
+client.on('botResponse', (response) => { /* streaming text */ });
+client.on('botVoice', (voice) => { /* audio chunk */ });
+client.on('sttResponse', (stt) => { /* speech-to-text */ });
+client.on('interrupt', (data) => { /* response interrupted */ });
+client.on('memoryUpdated', (event) => { /* real-time memory extraction */ });
+client.on('error', (error) => { /* EstuaryError */ });
+client.on('quotaExceeded', (data) => { /* rate limited */ });
+```
+
+## Configuration
+
+```typescript
+interface EstuaryConfig {
+  serverUrl: string;           // Server URL
+  apiKey: string;              // API key (est_...)
+  characterId: string;         // Character ID
+  playerId: string;            // End user ID
+  audioSampleRate?: number;    // Default: 16000
+  autoReconnect?: boolean;     // Default: true
+  maxReconnectAttempts?: number; // Default: 5
+  reconnectDelayMs?: number;   // Default: 2000
+  debug?: boolean;             // Default: false
+  voiceTransport?: 'websocket' | 'livekit' | 'auto'; // Default: 'auto'
+  realtimeMemory?: boolean;    // Enable real-time memory extraction events. Default: false
+}
+```
+
+## Requirements
+
+- Node.js 18+ or modern browser
+- Estuary account with API key and Character ID
+
+## Documentation
+
+Full documentation at [docs.estuary-ai.com](https://docs.estuary-ai.com/docs/typescript-sdk/getting-started).
+
+## License
+
+MIT

package/dist/chunk-64CWCRPS.mjs

@@ -0,0 +1,36 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/errors.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["CONNECTION_FAILED"] = "CONNECTION_FAILED";
+  ErrorCode2["AUTH_FAILED"] = "AUTH_FAILED";
+  ErrorCode2["CONNECTION_TIMEOUT"] = "CONNECTION_TIMEOUT";
+  ErrorCode2["QUOTA_EXCEEDED"] = "QUOTA_EXCEEDED";
+  ErrorCode2["VOICE_NOT_SUPPORTED"] = "VOICE_NOT_SUPPORTED";
+  ErrorCode2["VOICE_ALREADY_ACTIVE"] = "VOICE_ALREADY_ACTIVE";
+  ErrorCode2["VOICE_NOT_ACTIVE"] = "VOICE_NOT_ACTIVE";
+  ErrorCode2["LIVEKIT_UNAVAILABLE"] = "LIVEKIT_UNAVAILABLE";
+  ErrorCode2["MICROPHONE_DENIED"] = "MICROPHONE_DENIED";
+  ErrorCode2["NOT_CONNECTED"] = "NOT_CONNECTED";
+  ErrorCode2["REST_ERROR"] = "REST_ERROR";
+  ErrorCode2["UNKNOWN"] = "UNKNOWN";
+  return ErrorCode2;
+})(ErrorCode || {});
+var EstuaryError = class extends Error {
+  code;
+  details;
+  constructor(code, message, details) {
+    super(message);
+    this.name = "EstuaryError";
+    this.code = code;
+    this.details = details;
+  }
+};
+
+export { ErrorCode, EstuaryError, __export };
+//# sourceMappingURL=chunk-64CWCRPS.mjs.map
+//# sourceMappingURL=chunk-64CWCRPS.mjs.map

package/dist/chunk-64CWCRPS.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"names":["ErrorCode"],"mappings":";;;;;;;AAAO,IAAK,SAAA,qBAAAA,UAAAA,KAAL;AACL,EAAAA,WAAA,mBAAA,CAAA,GAAoB,mBAAA;AACpB,EAAAA,WAAA,aAAA,CAAA,GAAc,aAAA;AACd,EAAAA,WAAA,oBAAA,CAAA,GAAqB,oBAAA;AACrB,EAAAA,WAAA,gBAAA,CAAA,GAAiB,gBAAA;AACjB,EAAAA,WAAA,qBAAA,CAAA,GAAsB,qBAAA;AACtB,EAAAA,WAAA,sBAAA,CAAA,GAAuB,sBAAA;AACvB,EAAAA,WAAA,kBAAA,CAAA,GAAmB,kBAAA;AACnB,EAAAA,WAAA,qBAAA,CAAA,GAAsB,qBAAA;AACtB,EAAAA,WAAA,mBAAA,CAAA,GAAoB,mBAAA;AACpB,EAAAA,WAAA,eAAA,CAAA,GAAgB,eAAA;AAChB,EAAAA,WAAA,YAAA,CAAA,GAAa,YAAA;AACb,EAAAA,WAAA,SAAA,CAAA,GAAU,SAAA;AAZA,EAAA,OAAAA,UAAAA;AAAA,CAAA,EAAA,SAAA,IAAA,EAAA;AAeL,IAAM,YAAA,GAAN,cAA2B,KAAA,CAAM;AAAA,EAC7B,IAAA;AAAA,EACA,OAAA;AAAA,EAET,WAAA,CAAY,IAAA,EAAiB,OAAA,EAAiB,OAAA,EAAmB;AAC/D,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,cAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AAAA,EACjB;AACF","file":"chunk-64CWCRPS.mjs","sourcesContent":["export enum ErrorCode {\n  CONNECTION_FAILED = 'CONNECTION_FAILED',\n  AUTH_FAILED = 'AUTH_FAILED',\n  CONNECTION_TIMEOUT = 'CONNECTION_TIMEOUT',\n  QUOTA_EXCEEDED = 'QUOTA_EXCEEDED',\n  VOICE_NOT_SUPPORTED = 'VOICE_NOT_SUPPORTED',\n  VOICE_ALREADY_ACTIVE = 'VOICE_ALREADY_ACTIVE',\n  VOICE_NOT_ACTIVE = 'VOICE_NOT_ACTIVE',\n  LIVEKIT_UNAVAILABLE = 'LIVEKIT_UNAVAILABLE',\n  MICROPHONE_DENIED = 'MICROPHONE_DENIED',\n  NOT_CONNECTED = 'NOT_CONNECTED',\n  REST_ERROR = 'REST_ERROR',\n  UNKNOWN = 'UNKNOWN',\n}\n\nexport class EstuaryError extends Error {\n  readonly code: ErrorCode;\n  readonly details?: unknown;\n\n  constructor(code: ErrorCode, message: string, details?: unknown) {\n    super(message);\n    this.name = 'EstuaryError';\n    this.code = code;\n    this.details = details;\n  }\n}\n"]}