dvgateway-sdk 1.0.0

package/dist/auth/manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.test.js","sourceRoot":"","sources":["../../src/auth/manager.test.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,154 @@
+/**
+ * DVGatewayClient — Main SDK Entry Point
+ *
+ * Wires together all internal components and exposes a clean,
+ * type-safe public API for integrating with the DVGateway.
+ *
+ * @example
+ * ```typescript
+ * const gw = new DVGatewayClient({
+ *   baseUrl: 'https://gateway.example.com',
+ *   auth: { type: 'apiKey', apiKey: process.env.DV_API_KEY! },
+ * });
+ *
+ * // High-level: 5-line AI voice bot
+ * await gw.pipeline()
+ *   .stt(new DeepgramAdapter({ apiKey: '...' }))
+ *   .llm(new AnthropicAdapter({ apiKey: '...' }))
+ *   .tts(new ElevenLabsAdapter({ apiKey: '...' }))
+ *   .start();
+ * ```
+ */
+import { PipelineBuilder } from './pipeline/builder.js';
+import { PipelineMetrics } from './observability/metrics.js';
+import type { DVGatewayOptions, CallSession, CallEvent, AudioChunk, TranscriptResult, StreamDir, TtsAdapter, Unsubscribe } from './types/index.js';
+export declare class DVGatewayClient {
+    private readonly auth;
+    private readonly wsPool;
+    private readonly http;
+    private readonly callEvents;
+    private readonly ttsInjector;
+    private readonly sessions;
+    private readonly minutes;
+    readonly metrics: PipelineMetrics;
+    private readonly logger;
+    constructor(opts: DVGatewayOptions);
+    /**
+     * Create a fluent AI voice pipeline.
+     *
+     * @example
+     * ```typescript
+     * await gw.pipeline()
+     *   .stt(new DeepgramAdapter({ apiKey: '...' }))
+     *   .llm(new AnthropicAdapter({ apiKey: '...' }))
+     *   .tts(new ElevenLabsAdapter({ apiKey: '...' }))
+     *   .onNewCall((s) => console.log('Call:', s.linkedId))
+     *   .start();
+     * ```
+     */
+    pipeline(): PipelineBuilder;
+    /**
+     * Subscribe to real-time audio from a call.
+     * Returns an AsyncIterable that yields AudioChunk (Float32, 16kHz).
+     *
+     * @example
+     * ```typescript
+     * for await (const chunk of gw.streamAudio('abc123')) {
+     *   // chunk.samples: Float32Array [-1.0, 1.0]
+     *   // 640 bytes = 320 samples = 20ms per chunk
+     * }
+     * ```
+     */
+    streamAudio(linkedId: string, opts?: {
+        dir?: StreamDir;
+    }): AsyncIterable<AudioChunk> & {
+        unsubscribe: () => void;
+    };
+    /**
+     * Inject synthesized speech into an active call.
+     * audioChunks should be 16kHz, 16-bit PCM (slin16) audio.
+     *
+     * @example
+     * ```typescript
+     * const ttsAdapter = new ElevenLabsAdapter({ apiKey: '...' });
+     * await gw.injectTts('abc123', ttsAdapter.synthesize('Hello!'));
+     * ```
+     */
+    injectTts(linkedId: string, audioChunks: AsyncIterable<Buffer>): Promise<void>;
+    /**
+     * Broadcast synthesized speech to all conference participants.
+     */
+    broadcastTts(confId: string, audioChunks: AsyncIterable<Buffer>): Promise<void>;
+    /**
+     * Convenience: synthesize text and inject it directly.
+     * Requires a TtsAdapter instance.
+     *
+     * Tip: Pass a CachedTtsAdapter to avoid redundant API calls
+     * for repeated announcements (e.g. IVR greetings).
+     *
+     * @example
+     * ```typescript
+     * import { CachedTtsAdapter, ElevenLabsAdapter } from 'dvgateway-adapters';
+     *
+     * const tts = new CachedTtsAdapter(
+     *   new ElevenLabsAdapter({ apiKey: '...' }),
+     *   { provider: 'elevenlabs', cacheDir: './tts-cache' },
+     * );
+     * await tts.warmup([{ text: '안녕하세요' }]);
+     * await gw.say(linkedId, '안녕하세요', tts); // cache hit — no API call
+     * ```
+     */
+    say(linkedId: string, text: string, tts: TtsAdapter): Promise<void>;
+    /**
+     * Broadcast synthesized speech to a conference.
+     * Pass a CachedTtsAdapter for zero-cost repeated broadcasts.
+     *
+     * @example
+     * ```typescript
+     * await gw.broadcastSay(confId, '회의를 시작합니다.', cachedTts);
+     * ```
+     */
+    broadcastSay(confId: string, text: string, tts: TtsAdapter): Promise<void>;
+    /**
+     * Subscribe to all call lifecycle events.
+     * Returns an unsubscribe function.
+     *
+     * @example
+     * ```typescript
+     * const unsub = gw.onCallEvent((event) => {
+     *   if (event.type === 'call:new') console.log(event.session.linkedId);
+     * });
+     * // Later: unsub();
+     * ```
+     */
+    onCallEvent(handler: (event: CallEvent) => void | Promise<void>): Unsubscribe;
+    /** Subscribe to a specific call event type */
+    on<T extends CallEvent>(type: T['type'], handler: (event: T) => void | Promise<void>): Unsubscribe;
+    /** List all currently active call sessions */
+    listSessions(): Promise<CallSession[]>;
+    /** List active call sessions filtered by tenant ID */
+    listSessionsByTenant(tenantId: string): Promise<CallSession[]>;
+    /** Update metadata on a session (e.g. customer ID, ticket number) */
+    updateSessionMeta(linkedId: string, meta: Record<string, string>): Promise<void>;
+    /**
+     * Submit an STT transcript result to the gateway's minutes store.
+     * Typically called from an STT adapter's onTranscript callback.
+     */
+    submitTranscript(confId: string, result: TranscriptResult): Promise<void>;
+    /**
+     * Download conference minutes in JSON or plain-text format.
+     */
+    downloadMinutes(confId: string, format?: 'json' | 'txt'): Promise<string>;
+    /**
+     * Returns a function that auto-submits final transcripts to minutes.
+     * Attach to sttAdapter.onTranscript().
+     */
+    autoSubmitTranscripts(confId: string): (result: TranscriptResult) => Promise<void>;
+    /**
+     * Gracefully close all WebSocket connections and release resources.
+     * Call this when your application is shutting down.
+     */
+    close(): void;
+    private normalizeBaseUrl;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,218 @@
+/**
+ * DVGatewayClient — Main SDK Entry Point
+ *
+ * Wires together all internal components and exposes a clean,
+ * type-safe public API for integrating with the DVGateway.
+ *
+ * @example
+ * ```typescript
+ * const gw = new DVGatewayClient({
+ *   baseUrl: 'https://gateway.example.com',
+ *   auth: { type: 'apiKey', apiKey: process.env.DV_API_KEY! },
+ * });
+ *
+ * // High-level: 5-line AI voice bot
+ * await gw.pipeline()
+ *   .stt(new DeepgramAdapter({ apiKey: '...' }))
+ *   .llm(new AnthropicAdapter({ apiKey: '...' }))
+ *   .tts(new ElevenLabsAdapter({ apiKey: '...' }))
+ *   .start();
+ * ```
+ */
+import { AuthManager } from './auth/manager.js';
+import { WsPool } from './transport/ws-pool.js';
+import { HttpClient } from './transport/http-client.js';
+import { CallEventStream } from './streams/call-events.js';
+import { createAudioStream } from './streams/audio-stream.js';
+import { TtsInjector } from './streams/tts-stream.js';
+import { SessionManager } from './session/manager.js';
+import { MinutesManager } from './minutes/manager.js';
+import { PipelineBuilder } from './pipeline/builder.js';
+import { PipelineMetrics } from './observability/metrics.js';
+import { createLogger } from './observability/logger.js';
+export class DVGatewayClient {
+    auth;
+    wsPool;
+    http;
+    callEvents;
+    ttsInjector;
+    sessions;
+    minutes;
+    metrics;
+    logger;
+    constructor(opts) {
+        // Enforce TLS in production
+        const baseUrl = this.normalizeBaseUrl(opts);
+        this.logger = opts.logger ?? createLogger({ level: 'info', redactPii: opts.security?.maskPii !== false });
+        this.auth = new AuthManager(opts.auth, baseUrl, this.logger);
+        this.wsPool = new WsPool(this.auth, opts.reconnect ?? {}, this.logger);
+        this.http = new HttpClient(this.auth, opts.timeout ?? 30_000, this.logger, opts.tenantId);
+        this.callEvents = new CallEventStream(this.wsPool, this.logger);
+        this.ttsInjector = new TtsInjector(this.wsPool, this.http, this.logger);
+        this.sessions = new SessionManager(this.http, this.logger);
+        this.minutes = new MinutesManager(this.http, this.logger);
+        this.metrics = new PipelineMetrics(this.logger);
+    }
+    // ─── High-Level: Pipeline Builder ──────────────────────────────────────
+    /**
+     * Create a fluent AI voice pipeline.
+     *
+     * @example
+     * ```typescript
+     * await gw.pipeline()
+     *   .stt(new DeepgramAdapter({ apiKey: '...' }))
+     *   .llm(new AnthropicAdapter({ apiKey: '...' }))
+     *   .tts(new ElevenLabsAdapter({ apiKey: '...' }))
+     *   .onNewCall((s) => console.log('Call:', s.linkedId))
+     *   .start();
+     * ```
+     */
+    pipeline() {
+        return new PipelineBuilder(this.wsPool, this.callEvents, this.ttsInjector, this.logger);
+    }
+    // ─── Mid-Level: Audio Streaming ─────────────────────────────────────────
+    /**
+     * Subscribe to real-time audio from a call.
+     * Returns an AsyncIterable that yields AudioChunk (Float32, 16kHz).
+     *
+     * @example
+     * ```typescript
+     * for await (const chunk of gw.streamAudio('abc123')) {
+     *   // chunk.samples: Float32Array [-1.0, 1.0]
+     *   // 640 bytes = 320 samples = 20ms per chunk
+     * }
+     * ```
+     */
+    streamAudio(linkedId, opts = {}) {
+        return createAudioStream(this.wsPool, linkedId, this.logger, opts);
+    }
+    // ─── Mid-Level: TTS Injection ───────────────────────────────────────────
+    /**
+     * Inject synthesized speech into an active call.
+     * audioChunks should be 16kHz, 16-bit PCM (slin16) audio.
+     *
+     * @example
+     * ```typescript
+     * const ttsAdapter = new ElevenLabsAdapter({ apiKey: '...' });
+     * await gw.injectTts('abc123', ttsAdapter.synthesize('Hello!'));
+     * ```
+     */
+    async injectTts(linkedId, audioChunks) {
+        return this.ttsInjector.injectStreaming(linkedId, audioChunks);
+    }
+    /**
+     * Broadcast synthesized speech to all conference participants.
+     */
+    async broadcastTts(confId, audioChunks) {
+        return this.ttsInjector.broadcastToConference(confId, audioChunks);
+    }
+    /**
+     * Convenience: synthesize text and inject it directly.
+     * Requires a TtsAdapter instance.
+     *
+     * Tip: Pass a CachedTtsAdapter to avoid redundant API calls
+     * for repeated announcements (e.g. IVR greetings).
+     *
+     * @example
+     * ```typescript
+     * import { CachedTtsAdapter, ElevenLabsAdapter } from 'dvgateway-adapters';
+     *
+     * const tts = new CachedTtsAdapter(
+     *   new ElevenLabsAdapter({ apiKey: '...' }),
+     *   { provider: 'elevenlabs', cacheDir: './tts-cache' },
+     * );
+     * await tts.warmup([{ text: '안녕하세요' }]);
+     * await gw.say(linkedId, '안녕하세요', tts); // cache hit — no API call
+     * ```
+     */
+    async say(linkedId, text, tts) {
+        return this.ttsInjector.injectStreaming(linkedId, tts.synthesize(text));
+    }
+    /**
+     * Broadcast synthesized speech to a conference.
+     * Pass a CachedTtsAdapter for zero-cost repeated broadcasts.
+     *
+     * @example
+     * ```typescript
+     * await gw.broadcastSay(confId, '회의를 시작합니다.', cachedTts);
+     * ```
+     */
+    async broadcastSay(confId, text, tts) {
+        return this.ttsInjector.broadcastToConference(confId, tts.synthesize(text));
+    }
+    // ─── Mid-Level: Call Events ─────────────────────────────────────────────
+    /**
+     * Subscribe to all call lifecycle events.
+     * Returns an unsubscribe function.
+     *
+     * @example
+     * ```typescript
+     * const unsub = gw.onCallEvent((event) => {
+     *   if (event.type === 'call:new') console.log(event.session.linkedId);
+     * });
+     * // Later: unsub();
+     * ```
+     */
+    onCallEvent(handler) {
+        return this.callEvents.on(handler);
+    }
+    /** Subscribe to a specific call event type */
+    on(type, handler) {
+        return this.callEvents.onType(type, handler);
+    }
+    // ─── Session Management ─────────────────────────────────────────────────
+    /** List all currently active call sessions */
+    async listSessions() {
+        return this.sessions.listSessions();
+    }
+    /** List active call sessions filtered by tenant ID */
+    async listSessionsByTenant(tenantId) {
+        return this.sessions.listSessionsByTenant(tenantId);
+    }
+    /** Update metadata on a session (e.g. customer ID, ticket number) */
+    async updateSessionMeta(linkedId, meta) {
+        return this.sessions.updateMetadata(linkedId, meta);
+    }
+    // ─── Minutes / Transcripts ──────────────────────────────────────────────
+    /**
+     * Submit an STT transcript result to the gateway's minutes store.
+     * Typically called from an STT adapter's onTranscript callback.
+     */
+    async submitTranscript(confId, result) {
+        return this.minutes.submitTranscript(confId, result);
+    }
+    /**
+     * Download conference minutes in JSON or plain-text format.
+     */
+    async downloadMinutes(confId, format = 'txt') {
+        return this.minutes.downloadMinutes(confId, format);
+    }
+    /**
+     * Returns a function that auto-submits final transcripts to minutes.
+     * Attach to sttAdapter.onTranscript().
+     */
+    autoSubmitTranscripts(confId) {
+        return this.minutes.createAutoSubmitter(confId);
+    }
+    // ─── Lifecycle ──────────────────────────────────────────────────────────
+    /**
+     * Gracefully close all WebSocket connections and release resources.
+     * Call this when your application is shutting down.
+     */
+    close() {
+        this.wsPool.closeAll();
+        this.logger.info({}, 'DVGatewayClient closed');
+    }
+    // ─── Private helpers ────────────────────────────────────────────────────
+    normalizeBaseUrl(opts) {
+        let url = opts.baseUrl.replace(/\/$/, '');
+        if (opts.security?.forceTls !== false) {
+            if (url.startsWith('http://')) {
+                this.logger.warn({ url }, 'DVGateway: upgrading http:// to https:// (set security.forceTls=false to suppress)');
+                url = url.replace('http://', 'https://');
+            }
+        }
+        return url;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * DVGateway SDK
+ *
+ * Real-time voice AI integration for DVGateway media gateway.
+ *
+ * Quick start:
+ *
+ *   import { DVGatewayClient } from 'dvgateway-sdk';
+ *   import { DeepgramAdapter } from 'dvgateway-adapters/stt';
+ *   import { AnthropicAdapter } from 'dvgateway-adapters/llm';
+ *   import { ElevenLabsAdapter } from 'dvgateway-adapters/tts';
+ *
+ *   const gw = new DVGatewayClient({
+ *     baseUrl: 'https://gateway.example.com',
+ *     auth: { type: 'apiKey', apiKey: process.env.DV_API_KEY! },
+ *   });
+ *
+ *   await gw.pipeline()
+ *     .stt(new DeepgramAdapter({ apiKey: process.env.DEEPGRAM_KEY!, language: 'ko' }))
+ *     .llm(new AnthropicAdapter({ apiKey: process.env.ANTHROPIC_KEY!, model: 'claude-opus-4-6' }))
+ *     .tts(new ElevenLabsAdapter({ apiKey: process.env.ELEVENLABS_KEY! }))
+ *     .start();
+ *
+ * DVGateway port reference:
+ *   :8080 — API server  (AI clients connect here)
+ *   :8081 — Dashboard   (monitoring UI)
+ *   :8092 — Media server (Asterisk ExternalMedia WebSocket, default GW_MEDIA_ADDR)
+ *   :8088 — Asterisk ARI HTTP API (Asterisk's own port, not DVGateway's)
+ */
+export { DVGatewayClient } from './client.js';
+export type { ApiKeyAuth, JwtAuth, Auth, DVGatewayOptions, ReconnectOptions, SecurityOptions, MtlsOptions, CallSession, ConferenceSession, ConferenceParticipant, StreamDir, CallEvent, CallNewEvent, CallEndedEvent, ConfJoinEvent, ConfLeaveEvent, ConfEndedEvent, CallEventType, AudioChunk, RawAudioChunk, SttAdapter, TtsAdapter, LlmAdapter, TranscriptResult, TranscriptWord, SentimentResult, TtsOptions, VoiceInfo, HumanVoiceOptions, SttOptions, Message, LlmOptions, PipelineOptions, PipelineEventHandlers, MinutesDownloadOptions, Logger, Unsubscribe, Result, } from './types/index.js';
+export { HUMAN_VOICE_DEFAULTS_KO, HUMAN_VOICE_DEFAULTS_EN, } from './types/index.js';
+export { slin16ToFloat32, float32ToSlin16, ulawToSlin16, slin16ToUlaw, resample, calculateRms, detectVoiceActivity, } from './audio/codec.js';
+export { createLogger, defaultLogger } from './observability/logger.js';
+export { PipelineMetrics, Histogram, Counter } from './observability/metrics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,YAAY,EAEV,UAAU,EACV,OAAO,EACP,IAAI,EAGJ,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,WAAW,EAGX,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,SAAS,EAGT,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,aAAa,EAGb,UAAU,EACV,aAAa,EAGb,UAAU,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,OAAO,EACP,UAAU,EAGV,eAAe,EACf,qBAAqB,EAGrB,sBAAsB,EAGtB,MAAM,EAGN,WAAW,EACX,MAAM,GACP,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+/**
+ * DVGateway SDK
+ *
+ * Real-time voice AI integration for DVGateway media gateway.
+ *
+ * Quick start:
+ *
+ *   import { DVGatewayClient } from 'dvgateway-sdk';
+ *   import { DeepgramAdapter } from 'dvgateway-adapters/stt';
+ *   import { AnthropicAdapter } from 'dvgateway-adapters/llm';
+ *   import { ElevenLabsAdapter } from 'dvgateway-adapters/tts';
+ *
+ *   const gw = new DVGatewayClient({
+ *     baseUrl: 'https://gateway.example.com',
+ *     auth: { type: 'apiKey', apiKey: process.env.DV_API_KEY! },
+ *   });
+ *
+ *   await gw.pipeline()
+ *     .stt(new DeepgramAdapter({ apiKey: process.env.DEEPGRAM_KEY!, language: 'ko' }))
+ *     .llm(new AnthropicAdapter({ apiKey: process.env.ANTHROPIC_KEY!, model: 'claude-opus-4-6' }))
+ *     .tts(new ElevenLabsAdapter({ apiKey: process.env.ELEVENLABS_KEY! }))
+ *     .start();
+ *
+ * DVGateway port reference:
+ *   :8080 — API server  (AI clients connect here)
+ *   :8081 — Dashboard   (monitoring UI)
+ *   :8092 — Media server (Asterisk ExternalMedia WebSocket, default GW_MEDIA_ADDR)
+ *   :8088 — Asterisk ARI HTTP API (Asterisk's own port, not DVGateway's)
+ */
+// Main client
+export { DVGatewayClient } from './client.js';
+// Human voice presets
+export { HUMAN_VOICE_DEFAULTS_KO, HUMAN_VOICE_DEFAULTS_EN, } from './types/index.js';
+// Audio codec utilities (for custom adapter authors)
+export { slin16ToFloat32, float32ToSlin16, ulawToSlin16, slin16ToUlaw, resample, calculateRms, detectVoiceActivity, } from './audio/codec.js';
+// Logger factory
+export { createLogger, defaultLogger } from './observability/logger.js';
+// Metrics
+export { PipelineMetrics, Histogram, Counter } from './observability/metrics.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,cAAc;AACd,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA+D9C,sBAAsB;AACtB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,qDAAqD;AACrD,OAAO,EACL,eAAe,EACf,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAExE,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/minutes/manager.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Minutes Manager
+ *
+ * Submits STT transcripts to the gateway's minutes store and
+ * downloads completed conference minutes in JSON or TXT format.
+ *
+ * REST API:
+ *   POST /api/v1/minutes/{confId}/transcript   — Submit utterance
+ *   GET  /api/v1/minutes/{confId}/download     — Download minutes
+ */
+import type { TranscriptResult, Logger } from '../types/index.js';
+import type { HttpClient } from '../transport/http-client.js';
+export interface MinutesEntry {
+    linkedId: string;
+    speaker?: string;
+    text: string;
+    isFinal: boolean;
+    timestampMs: number;
+}
+export declare class MinutesManager {
+    private readonly http;
+    private readonly logger;
+    constructor(http: HttpClient, logger: Logger);
+    /**
+     * Submit an STT transcript result to the gateway's minutes store.
+     * Only final transcripts are typically stored, but partials are accepted.
+     */
+    submitTranscript(confId: string, result: TranscriptResult): Promise<void>;
+    /**
+     * Download the minutes for a completed (or in-progress) conference.
+     *
+     * @param confId - Conference identifier
+     * @param format - 'json' (structured) or 'txt' (human-readable)
+     * @returns Minutes content as a string
+     */
+    downloadMinutes(confId: string, format?: 'json' | 'txt'): Promise<string>;
+    /**
+     * Convenience: submit final transcripts automatically.
+     * Attach to an STT adapter's onTranscript callback.
+     */
+    createAutoSubmitter(confId: string): (result: TranscriptResult) => Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/minutes/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/minutes/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM;IAK5C;;;OAGG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/E;;;;;;OAMG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,GAAG,KAAa,GAC7B,OAAO,CAAC,MAAM,CAAC;IAiBlB;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC;CAUjF"}

package/dist/minutes/manager.js

@@ -0,0 +1,71 @@
+/**
+ * Minutes Manager
+ *
+ * Submits STT transcripts to the gateway's minutes store and
+ * downloads completed conference minutes in JSON or TXT format.
+ *
+ * REST API:
+ *   POST /api/v1/minutes/{confId}/transcript   — Submit utterance
+ *   GET  /api/v1/minutes/{confId}/download     — Download minutes
+ */
+export class MinutesManager {
+    http;
+    logger;
+    constructor(http, logger) {
+        this.http = http;
+        this.logger = logger;
+    }
+    /**
+     * Submit an STT transcript result to the gateway's minutes store.
+     * Only final transcripts are typically stored, but partials are accepted.
+     */
+    async submitTranscript(confId, result) {
+        const response = await this.http.post(`/api/v1/minutes/${encodeURIComponent(confId)}/transcript`, {
+            linkedId: result.linkedId,
+            text: result.text,
+            isFinal: result.isFinal,
+            speaker: result.speaker,
+            confidence: result.confidence,
+            timestampMs: result.timestampMs,
+            sentiment: result.sentiment?.sentiment,
+            sentimentScore: result.sentiment?.sentimentScore,
+        });
+        if (response.status !== 200 && response.status !== 201 && response.status !== 204) {
+            throw new Error(`Failed to submit transcript: HTTP ${response.status}`);
+        }
+    }
+    /**
+     * Download the minutes for a completed (or in-progress) conference.
+     *
+     * @param confId - Conference identifier
+     * @param format - 'json' (structured) or 'txt' (human-readable)
+     * @returns Minutes content as a string
+     */
+    async downloadMinutes(confId, format = 'txt') {
+        const response = await this.http.get(`/api/v1/minutes/${encodeURIComponent(confId)}/download`, { headers: { Accept: format === 'json' ? 'application/json' : 'text/plain' } });
+        if (response.status !== 200) {
+            throw new Error(`Failed to download minutes: HTTP ${response.status}`);
+        }
+        if (format === 'json' && typeof response.data === 'object') {
+            return JSON.stringify(response.data, null, 2);
+        }
+        return String(response.data);
+    }
+    /**
+     * Convenience: submit final transcripts automatically.
+     * Attach to an STT adapter's onTranscript callback.
+     */
+    createAutoSubmitter(confId) {
+        return async (result) => {
+            if (!result.isFinal)
+                return; // Only store finals
+            try {
+                await this.submitTranscript(confId, result);
+            }
+            catch (err) {
+                this.logger.warn({ confId, err }, 'Failed to auto-submit transcript to minutes');
+            }
+        };
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/minutes/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/minutes/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,MAAM,OAAO,cAAc;IACR,IAAI,CAAa;IACjB,MAAM,CAAS;IAEhC,YAAY,IAAgB,EAAE,MAAc;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,MAAwB;QAC7D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CACnC,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,aAAa,EAC1D;YACE,QAAQ,EAAS,MAAM,CAAC,QAAQ;YAChC,IAAI,EAAa,MAAM,CAAC,IAAI;YAC5B,OAAO,EAAU,MAAM,CAAC,OAAO;YAC/B,OAAO,EAAU,MAAM,CAAC,OAAO;YAC/B,UAAU,EAAO,MAAM,CAAC,UAAU;YAClC,WAAW,EAAM,MAAM,CAAC,WAAW;YACnC,SAAS,EAAQ,MAAM,CAAC,SAAS,EAAE,SAAS;YAC5C,cAAc,EAAG,MAAM,CAAC,SAAS,EAAE,cAAc;SAClD,CACF,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CACnB,MAAc,EACd,SAAyB,KAAK;QAE9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAClC,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,WAAW,EACxD,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,YAAY,EAAE,EAAE,CAC/E,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,MAAM,KAAK,MAAM,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,MAAc;QAChC,OAAO,KAAK,EAAE,MAAwB,EAAE,EAAE;YACxC,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO,CAAC,oBAAoB;YACjD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,6CAA6C,CAAC,CAAC;YACnF,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;CACF"}

package/dist/observability/logger.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Structured JSON logger with PII redaction support.
+ * Implements the Logger interface — swap to any log library (pino, winston) as needed.
+ */
+import type { Logger } from '../types/index.js';
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface CreateLoggerOptions {
+    /** Minimum log level (default: 'info') */
+    level?: LogLevel;
+    /** Whether to redact PII from log output (default: true) */
+    redactPii?: boolean;
+    /** Additional fixed context merged into every log entry */
+    baseContext?: Record<string, unknown>;
+}
+export declare function createLogger(opts?: CreateLoggerOptions): Logger;
+/** Default singleton logger */
+export declare const defaultLogger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/observability/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAgChD,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AASpD,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,MAAM,CA6BnE;AAED,+BAA+B;AAC/B,eAAO,MAAM,aAAa,QAAmD,CAAC"}