@makaio/contracts 1.0.0-dev-1779051654000

package/dist/capabilities/voice/types.d.ts

@@ -0,0 +1,188 @@
+import type { ICapabilityProvider } from '../../capability/types.js';
+import type { STTResult, VoiceStatusState } from './schemas.js';
+import type { STTMode, TTSMode } from './modes.js';
+export type { STTResult, VoiceStatusState };
+/** Runtime capabilities of an STT provider, used for provider selection. */
+export interface STTProviderCapabilities {
+    /** Supported transcription modes. */
+    readonly modes: readonly STTMode[];
+    /** Whether vocabulary/terminology biasing is supported. */
+    readonly vocabularyBiasing: boolean;
+}
+/** Runtime capabilities of a TTS provider, used for provider selection. */
+export interface TTSProviderCapabilities {
+    /** Supported synthesis modes. */
+    readonly modes: readonly TTSMode[];
+    /** Whether voice preset selection is supported. */
+    readonly voiceSelection: boolean;
+    /** Whether style/tone instructions are supported. */
+    readonly voiceInstructions: boolean;
+    /** Supported output audio formats. */
+    readonly outputFormats: readonly string[];
+}
+/** Where the provider executes — determines audio routing strategy. */
+export type ProviderRuntime = 'server' | 'client';
+/**
+ * Raw audio input for speech-to-text transcription.
+ */
+export interface STTRequest {
+    /** Raw PCM audio samples as a binary buffer */
+    audio: ArrayBuffer;
+    /** Sample rate of the audio in Hz (e.g. 16000, 44100) */
+    sampleRate: number;
+    /** BCP-47 language tag to guide transcription (e.g. "en-US") */
+    language?: string;
+    /** Custom vocabulary words to bias recognition toward */
+    vocabulary?: string[];
+}
+/**
+ * Text input for speech synthesis.
+ */
+export interface TTSRequest {
+    /** Text to synthesize into audio */
+    text: string;
+    /** BCP-47 language tag for the desired voice (e.g. "en-US") */
+    language?: string;
+    /** Voice preset name (e.g. "default"). Provider uses its default if omitted. */
+    voice?: string;
+}
+/**
+ * A streamed chunk of synthesized PCM audio.
+ * @remarks
+ * This type is used exclusively in the local provider interface ({@link ITTSProvider}).
+ * It is NOT JSON-serializable and must never appear as a bus event payload.
+ * `Float32Array` does not survive JSON round-trips.
+ */
+export interface AudioChunk {
+    /** Interleaved PCM float samples in the range [-1, 1] */
+    data: Float32Array;
+    /** Sample rate of this chunk in Hz */
+    sampleRate: number;
+}
+/**
+ * Speech-to-text capability provider.
+ *
+ * Providers implement audio transcription for the voice pipeline.
+ * Register via the capability registry so the runtime can resolve the
+ * active provider at session start.
+ */
+export interface ISTTProvider extends ICapabilityProvider {
+    /** Discriminant that identifies the STT capability slot in the registry. */
+    readonly capabilityId: 'stt';
+    /** Where this provider runs. Server providers receive audio via WebSocket;
+     *  client providers run locally in the browser/app. */
+    readonly runtime: ProviderRuntime;
+    /** Structured capabilities for provider selection. */
+    readonly capabilities: STTProviderCapabilities;
+    /**
+     * Transcribe a raw audio buffer into text.
+     * @param request - Audio data and transcription options
+     * @returns Transcription result with detected language and optional confidence
+     */
+    transcribe(request: STTRequest): Promise<STTResult>;
+    /**
+     * Check whether this provider is ready to accept requests.
+     * @returns `true` when the underlying adapter is initialised and reachable
+     */
+    isAvailable(): Promise<boolean>;
+}
+/**
+ * Text-to-speech capability provider.
+ *
+ * Providers implement audio synthesis for the voice pipeline.
+ * The response is an async iterable so callers can stream audio to
+ * the client progressively without buffering the full utterance.
+ */
+export interface ITTSProvider extends ICapabilityProvider {
+    /** Discriminant that identifies the TTS capability slot in the registry. */
+    readonly capabilityId: 'tts';
+    /** Where this provider runs. */
+    readonly runtime: ProviderRuntime;
+    /** Structured capabilities for provider selection. */
+    readonly capabilities: TTSProviderCapabilities;
+    /**
+     * Synthesize text into a stream of PCM audio chunks.
+     * @param request - Text content and optional language preference
+     * @returns Async iterable of audio chunks, delivered in order
+     */
+    synthesize(request: TTSRequest): AsyncIterable<AudioChunk>;
+    /**
+     * Check whether this provider is ready to accept requests.
+     * @returns `true` when the underlying adapter is initialised and reachable
+     */
+    isAvailable(): Promise<boolean>;
+}
+/** Strategy for a single voice pipeline leg (STT or TTS). */
+export interface VoicePipelineLeg {
+    /** Where processing runs. */
+    readonly runtime: ProviderRuntime;
+    /** Provider ID selected for this session. */
+    readonly providerId: string;
+    /** Display name for UI feedback. */
+    readonly providerName: string;
+}
+/** Pipeline strategy returned to the client on voice session start. */
+export interface VoicePipelineStrategy {
+    /** How STT will work for this session. */
+    readonly stt: VoicePipelineLeg;
+    /** How TTS will work for this session. */
+    readonly tts: VoicePipelineLeg;
+}
+/**
+ * JSON-serializable descriptor for a client-runtime voice provider.
+ *
+ * Emitted across the bus for provider discovery; the actual executable
+ * implementation is registered locally via `clientVoiceRuntimeRegistry`.
+ */
+export type ClientVoiceProviderDescriptor = {
+    /** Unique provider identifier. */
+    readonly id: string;
+    /** Human-readable name for UI. */
+    readonly displayName: string;
+    /** Always 'client' for client-side providers. */
+    readonly runtime: 'client';
+    /** Capability type this descriptor represents. */
+    readonly capabilityId: 'stt';
+    /** STT structured capabilities. */
+    readonly capabilities: STTProviderCapabilities;
+} | {
+    /** Unique provider identifier. */
+    readonly id: string;
+    /** Human-readable name for UI. */
+    readonly displayName: string;
+    /** Always 'client' for client-side providers. */
+    readonly runtime: 'client';
+    /** Capability type this descriptor represents. */
+    readonly capabilityId: 'tts';
+    /** TTS structured capabilities. */
+    readonly capabilities: TTSProviderCapabilities;
+};
+/** User preference for voice provider selection. */
+export interface VoiceProviderPreference {
+    /** Preferred STT provider ID, or 'auto' for best-available heuristic. */
+    readonly stt: string;
+    /** Preferred TTS provider ID, or 'auto' for best-available heuristic. */
+    readonly tts: string;
+}
+/**
+ * Provides context-derived vocabulary terms for ASR bias.
+ *
+ * Implementations extract terms from open files, codebase indexes,
+ * or agent/session metadata. Used by VoiceService to merge with
+ * user-managed vocabulary before transcription.
+ *
+ * Register via the capability registry with
+ * `capabilityId: 'voice-vocabulary'` so VoiceService can discover
+ * and query all active providers at transcription time.
+ */
+export interface IVocabularyProvider extends ICapabilityProvider {
+    /** Discriminant that identifies the vocabulary capability slot in the registry. */
+    readonly capabilityId: 'voice-vocabulary';
+    /**
+     * Get vocabulary terms relevant to the current session context.
+     * @param sessionId - The active session
+     * @returns Domain-specific terms to bias ASR toward
+     */
+    getTerms(sessionId: string): Promise<string[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/capabilities/voice/types.d.ts.map

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

package/dist/capability/index.d.ts

@@ -0,0 +1,5 @@
+export { CapabilitySchemas } from './schemas.js';
+export type { ListProvidersRequest, ListProvidersResponse, ProviderRegistration, ProviderSummary, ProviderUnregistration, ValidateRequest, ValidateResponse, ValidationResult, } from './schemas.js';
+export { CapabilityNamespace, CapabilitySubjects } from './namespace.js';
+export type { ICapabilityProvider, ICapabilityBasedService } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/capability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzE,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/capability/namespace.d.ts

@@ -0,0 +1,69 @@
+export declare const CapabilityNamespace: import("@makaio/framework/core").BusNamespaceDefinition<"capability", {
+    listProviders: {
+        request: import("zod").ZodObject<{
+            capabilityId: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>;
+        response: import("zod").ZodObject<{
+            providers: import("zod").ZodArray<import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                displayName: import("zod").ZodString;
+                providerKey: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+    };
+    validate: {
+        request: import("zod").ZodObject<{
+            capabilityId: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>;
+        response: import("zod").ZodObject<{
+            results: import("zod").ZodArray<import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                valid: import("zod").ZodBoolean;
+                error: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+    };
+    register: import("zod").ZodObject<{
+        capabilityId: import("zod").ZodString;
+        provider: import("zod").ZodUnknown;
+    }, import("zod/v4/core").$strip>;
+    unregister: import("zod").ZodObject<{
+        capabilityId: import("zod").ZodString;
+        providerId: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>;
+}>;
+export declare const CapabilitySubjects: import("@makaio/framework/core").BusSubjects<import("@makaio/framework/core").FlatSubjectDefinitions<"capability", {
+    listProviders: {
+        request: import("zod").ZodObject<{
+            capabilityId: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>;
+        response: import("zod").ZodObject<{
+            providers: import("zod").ZodArray<import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                displayName: import("zod").ZodString;
+                providerKey: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+    };
+    validate: {
+        request: import("zod").ZodObject<{
+            capabilityId: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>;
+        response: import("zod").ZodObject<{
+            results: import("zod").ZodArray<import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                valid: import("zod").ZodBoolean;
+                error: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+    };
+    register: import("zod").ZodObject<{
+        capabilityId: import("zod").ZodString;
+        provider: import("zod").ZodUnknown;
+    }, import("zod/v4/core").$strip>;
+    unregister: import("zod").ZodObject<{
+        capabilityId: import("zod").ZodString;
+        providerId: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>;
+}>, "capability">;
+//# sourceMappingURL=namespace.d.ts.map

package/dist/capability/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/capability/namespace.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAsD,CAAC;AAEvF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA+B,CAAC"}

package/dist/capability/schemas.d.ts

@@ -0,0 +1,135 @@
+import { z } from 'zod';
+/**
+ * Provider summary for list responses.
+ */
+declare const ProviderSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    displayName: z.ZodString;
+    providerKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Validation result for a single provider.
+ */
+declare const ValidationResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    valid: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Capability provider registration payload.
+ *
+ * Note: Provider is typed as unknown at the Zod level because providers
+ * are runtime objects with methods that Zod cannot validate.
+ * Type safety is enforced via typed registration helpers in service packages.
+ */
+declare const ProviderRegistrationSchema: z.ZodObject<{
+    capabilityId: z.ZodString;
+    provider: z.ZodUnknown;
+}, z.core.$strip>;
+/**
+ * Capability provider unregistration payload.
+ */
+declare const ProviderUnregistrationSchema: z.ZodObject<{
+    capabilityId: z.ZodString;
+    providerId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Capability domain schemas.
+ *
+ * Subjects for capability-related bus communication.
+ * Each key becomes a subject identifier as: `capability.{key}`
+ * @example
+ * ```typescript
+ * // List all push notification providers
+ * const result = await bus.request(CapabilitySubjects.listProviders, {
+ *   capabilityId: 'push-notification',
+ * });
+ * ```
+ */
+export declare const CapabilitySchemas: {
+    /**
+     * List all providers for a capability.
+     *
+     * Subject: `capability.listProviders`
+     * Type: Request (RPC)
+     * Purpose: Returns all registered providers for a given capability.
+     */
+    listProviders: {
+        request: z.ZodObject<{
+            capabilityId: z.ZodString;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            providers: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                displayName: z.ZodString;
+                providerKey: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
+    /**
+     * Validate all providers for a capability.
+     *
+     * Subject: `capability.validate`
+     * Type: Request (RPC)
+     * Purpose: Validates all providers for a capability and returns results.
+     */
+    validate: {
+        request: z.ZodObject<{
+            capabilityId: z.ZodString;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            results: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                valid: z.ZodBoolean;
+                error: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
+    /**
+     * Register a capability provider.
+     *
+     * Subject: `capability.register`
+     * Type: Event (fire-and-forget)
+     * Purpose: Plugins emit this to register their capability providers.
+     * @example
+     * ```typescript
+     * bus.emit(CapabilitySubjects.register, {
+     *   capabilityId: 'push-notification',
+     *   provider: new PushoverProvider(config),
+     * });
+     * ```
+     */
+    register: z.ZodObject<{
+        capabilityId: z.ZodString;
+        provider: z.ZodUnknown;
+    }, z.core.$strip>;
+    /**
+     * Unregister a capability provider.
+     *
+     * Subject: `capability.unregister`
+     * Type: Event (fire-and-forget)
+     * Purpose: Plugins emit this to remove providers that are no longer available.
+     * @example
+     * ```typescript
+     * bus.emit(CapabilitySubjects.unregister, {
+     *   capabilityId: 'push-notification',
+     *   providerId: 'pushover-primary',
+     * });
+     * ```
+     */
+    unregister: z.ZodObject<{
+        capabilityId: z.ZodString;
+        providerId: z.ZodString;
+    }, z.core.$strip>;
+};
+/** Type exports for external use */
+export type ProviderSummary = z.infer<typeof ProviderSummarySchema>;
+export type ValidationResult = z.infer<typeof ValidationResultSchema>;
+export type ListProvidersRequest = z.infer<typeof CapabilitySchemas.listProviders.request>;
+export type ListProvidersResponse = z.infer<typeof CapabilitySchemas.listProviders.response>;
+export type ValidateRequest = z.infer<typeof CapabilitySchemas.validate.request>;
+export type ValidateResponse = z.infer<typeof CapabilitySchemas.validate.response>;
+export type ProviderRegistration = z.infer<typeof ProviderRegistrationSchema>;
+export type ProviderUnregistration = z.infer<typeof ProviderUnregistrationSchema>;
+export {};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/capability/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/capability/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,QAAA,MAAM,qBAAqB;;;;iBAOzB,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,sBAAsB;;;;iBAO1B,CAAC;AAEH;;;;;;GAMG;AACH,QAAA,MAAM,0BAA0B;;;iBAK9B,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,4BAA4B;;;iBAKhC,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;;;;OAMG;;;;;;;;;;;;;IAYH;;;;;;OAMG;;;;;;;;;;;;;IAYH;;;;;;;;;;;;;OAaG;;;;;IAGH;;;;;;;;;;;;;OAaG;;;;;CAEmB,CAAC;AAEzB,oCAAoC;AACpC,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAC3F,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;AAC7F,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACjF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACnF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/capability/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Base interface all capability providers must implement.
+ *
+ * Capability providers are registered by extensions to provide
+ * platform-specific or service-specific functionality.
+ */
+export interface ICapabilityProvider {
+    /** Unique identifier for this provider instance */
+    readonly id: string;
+    /** Human-readable name for display in UI */
+    readonly displayName: string;
+    /**
+     * Stable provider identity used for joins across registries.
+     *
+     * Unlike {@link id}, this should remain stable across runtime re-registration.
+     */
+    readonly providerKey?: string;
+    /**
+     * Optional validation method to check provider configuration/credentials.
+     * @returns Validation result with optional error message
+     */
+    validate?(): Promise<{
+        valid: boolean;
+        error?: string;
+    }>;
+}
+/**
+ * Interface for capability-based services that can be auto-wired by the runtime.
+ *
+ * Services implementing this interface can be registered declaratively
+ * and the runtime will handle initialization and shutdown automatically.
+ */
+export interface ICapabilityBasedService {
+    /** The capability ID this service handles */
+    readonly capabilityId: string;
+    /** Initialize the service and register bus handlers */
+    init(): Promise<void>;
+    /** Destroy the service and cleanup handlers. Async teardown is allowed. */
+    destroy(): Promise<void> | void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/capability/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/capability/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,uDAAuD;IACvD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,2EAA2E;IAC3E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjC"}