@h-ear/core 0.1.0-dev.202603280856

package/dist/api-client.d.ts

@@ -0,0 +1,51 @@
+/**
+ * HTTP client for the H-ear Enterprise API.
+ * All classify operations are async: submit -> poll -> return results.
+ */
+import type { ServerConfig } from './config.js';
+import type { ClassifyRequest, ClassifyResult, AsyncAccepted, BatchRequest, BatchAccepted, ClassesResult, HealthResult, UsageResult, JobsResult, JobResult, WebhookRegister, WebhookResult } from './types.js';
+export declare class HearApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly requestId?: string | undefined;
+    constructor(status: number, code: string, message: string, requestId?: string | undefined);
+}
+/** Progress callback for polling -- allows consumers to log status */
+export type ProgressCallback = (message: string) => void;
+export declare class HearApiClient {
+    private config;
+    constructor(config: ServerConfig);
+    private headers;
+    /**
+     * Submit audio for classification (always async).
+     * Returns 202 with requestId + pollUrl.
+     */
+    submitClassify(params: ClassifyRequest): Promise<AsyncAccepted>;
+    /**
+     * Poll job status until complete or failed.
+     * Returns full classification results.
+     */
+    pollJob(jobId: string, onProgress?: ProgressCallback): Promise<ClassifyResult>;
+    /**
+     * Classify audio end-to-end: submit async -> poll -> return results.
+     */
+    classify(params: ClassifyRequest, onProgress?: ProgressCallback): Promise<ClassifyResult>;
+    classifyBatch(params: BatchRequest): Promise<BatchAccepted>;
+    listClasses(params?: {
+        taxonomy?: string;
+        category?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ClassesResult>;
+    health(): Promise<HealthResult>;
+    usage(): Promise<UsageResult>;
+    listJobs(params?: {
+        limit?: number;
+        offset?: number;
+        status?: string;
+    }): Promise<JobsResult>;
+    getJob(jobId: string): Promise<JobResult>;
+    registerWebhook(params: WebhookRegister): Promise<WebhookResult>;
+    deregisterWebhook(webhookId: string): Promise<void>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EACR,eAAe,EAAE,cAAc,EAAE,aAAa,EAC9C,YAAY,EAAE,aAAa,EAC3B,aAAa,EAAE,YAAY,EAC3B,WAAW,EAAE,UAAU,EAAE,SAAS,EAClC,eAAe,EAAE,aAAa,EACjC,MAAM,YAAY,CAAC;AAGpB,qBAAa,YAAa,SAAQ,KAAK;aAEf,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;aAEZ,SAAS,CAAC,EAAE,MAAM;gBAHlB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,SAAS,CAAC,EAAE,MAAM,YAAA;CAKzC;AA4BD,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzD,qBAAa,aAAa;IACV,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAExC,OAAO,CAAC,OAAO;IAUf;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAkBrE;;;OAGG;IACG,OAAO,CACT,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,gBAAgB,GAC9B,OAAO,CAAC,cAAc,CAAC;IAyC1B;;OAEG;IACG,QAAQ,CACV,MAAM,EAAE,eAAe,EACvB,UAAU,CAAC,EAAE,gBAAgB,GAC9B,OAAO,CAAC,cAAc,CAAC;IASpB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAe3D,WAAW,CAAC,MAAM,CAAC,EAAE;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,aAAa,CAAC;IAqBpB,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAc/B,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAc7B,QAAQ,CAAC,MAAM,CAAC,EAAE;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBjB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAczC,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAahE,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoB5D"}

package/dist/api-client.js

@@ -0,0 +1,218 @@
+/**
+ * HTTP client for the H-ear Enterprise API.
+ * All classify operations are async: submit -> poll -> return results.
+ */
+import { apiUrl } from './config.js';
+import { HEAR_API } from './constants.js';
+export class HearApiError extends Error {
+    status;
+    code;
+    requestId;
+    constructor(status, code, message, requestId) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.requestId = requestId;
+        this.name = 'HearApiError';
+    }
+}
+async function handleResponse(response) {
+    const text = await response.text();
+    let body;
+    try {
+        body = JSON.parse(text);
+    }
+    catch {
+        throw new HearApiError(response.status, `HTTP_${response.status}`, `Non-JSON response (${response.status}): ${text.substring(0, 200)}`);
+    }
+    if (!response.ok && response.status !== 202) {
+        throw new HearApiError(response.status, body.code || `HTTP_${response.status}`, body.error || response.statusText, body.requestId);
+    }
+    return body;
+}
+export class HearApiClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    headers(auth) {
+        const h = { 'Content-Type': 'application/json' };
+        if (auth && this.config.apiKey) {
+            h['X-NCM-Api-Key'] = this.config.apiKey;
+        }
+        return h;
+    }
+    // --- Classify ------------------------------------------------------------
+    /**
+     * Submit audio for classification (always async).
+     * Returns 202 with requestId + pollUrl.
+     */
+    async submitClassify(params) {
+        const url = apiUrl(this.config, '/v1/classify');
+        const asyncParams = {
+            ...params,
+            callbackUrl: HEAR_API.NOOP_CALLBACK_URL,
+        };
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: this.headers(true),
+            body: JSON.stringify(asyncParams),
+            signal: AbortSignal.timeout(30000),
+        });
+        return handleResponse(response);
+    }
+    /**
+     * Poll job status until complete or failed.
+     * Returns full classification results.
+     */
+    async pollJob(jobId, onProgress) {
+        const startMs = Date.now();
+        const pollUrl = apiUrl(this.config, `/v1/jobs/${jobId}`);
+        let attempts = 0;
+        while (Date.now() - startMs < HEAR_API.POLL_TIMEOUT_MS) {
+            await new Promise(resolve => setTimeout(resolve, HEAR_API.POLL_INTERVAL_MS));
+            attempts++;
+            const elapsedSec = ((Date.now() - startMs) / 1000).toFixed(0);
+            onProgress?.(`Polling job ${jobId}... (${elapsedSec}s, attempt ${attempts})`);
+            try {
+                const response = await fetch(pollUrl, {
+                    method: 'GET',
+                    headers: this.headers(true),
+                    signal: AbortSignal.timeout(10000),
+                });
+                const result = await handleResponse(response);
+                if (result.status === 'completed' || (result.classifications && result.classifications.length > 0)) {
+                    onProgress?.(`Job ${jobId} completed in ${elapsedSec}s`);
+                    return result;
+                }
+                if (result.status === 'failed') {
+                    throw new HearApiError(500, 'JOB_FAILED', `Job ${jobId} failed`, jobId);
+                }
+            }
+            catch (err) {
+                // 404 means job not yet visible in Cosmos -- keep polling
+                if (err instanceof HearApiError && err.status === 404) {
+                    continue;
+                }
+                throw err;
+            }
+        }
+        throw new HearApiError(408, 'POLL_TIMEOUT', `Job ${jobId} did not complete within ${HEAR_API.POLL_TIMEOUT_MS / 1000}s`, jobId);
+    }
+    /**
+     * Classify audio end-to-end: submit async -> poll -> return results.
+     */
+    async classify(params, onProgress) {
+        onProgress?.('Submitting audio for classification...');
+        const accepted = await this.submitClassify(params);
+        onProgress?.(`Job queued: ${accepted.requestId}`);
+        return this.pollJob(accepted.requestId, onProgress);
+    }
+    // --- Batch ---------------------------------------------------------------
+    async classifyBatch(params) {
+        const url = apiUrl(this.config, '/v1/classify/batch');
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: this.headers(true),
+            body: JSON.stringify(params),
+            signal: AbortSignal.timeout(30000),
+        });
+        return handleResponse(response);
+    }
+    // --- Classes -------------------------------------------------------------
+    async listClasses(params) {
+        const query = new URLSearchParams();
+        if (params?.taxonomy)
+            query.set('taxonomy', params.taxonomy);
+        if (params?.category)
+            query.set('category', params.category);
+        if (params?.limit !== undefined)
+            query.set('limit', String(params.limit));
+        if (params?.offset !== undefined)
+            query.set('offset', String(params.offset));
+        const qs = query.toString();
+        const url = apiUrl(this.config, `/v1/classes${qs ? `?${qs}` : ''}`);
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: { 'Content-Type': 'application/json' },
+            signal: AbortSignal.timeout(15000),
+        });
+        return handleResponse(response);
+    }
+    // --- Health --------------------------------------------------------------
+    async health() {
+        const url = apiUrl(this.config, '/v1/health');
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: { 'Content-Type': 'application/json' },
+            signal: AbortSignal.timeout(10000),
+        });
+        return handleResponse(response);
+    }
+    // --- Usage ---------------------------------------------------------------
+    async usage() {
+        const url = apiUrl(this.config, '/v1/usage');
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: this.headers(true),
+            signal: AbortSignal.timeout(10000),
+        });
+        return handleResponse(response);
+    }
+    // --- Jobs ----------------------------------------------------------------
+    async listJobs(params) {
+        const query = new URLSearchParams();
+        if (params?.limit !== undefined)
+            query.set('limit', String(params.limit));
+        if (params?.offset !== undefined)
+            query.set('offset', String(params.offset));
+        if (params?.status)
+            query.set('status', params.status);
+        const qs = query.toString();
+        const url = apiUrl(this.config, `/v1/jobs${qs ? `?${qs}` : ''}`);
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: this.headers(true),
+            signal: AbortSignal.timeout(15000),
+        });
+        return handleResponse(response);
+    }
+    async getJob(jobId) {
+        const url = apiUrl(this.config, `/v1/jobs/${jobId}`);
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: this.headers(true),
+            signal: AbortSignal.timeout(10000),
+        });
+        return handleResponse(response);
+    }
+    // --- Webhooks ------------------------------------------------------------
+    async registerWebhook(params) {
+        const url = apiUrl(this.config, '/v1/webhooks');
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: this.headers(true),
+            body: JSON.stringify(params),
+            signal: AbortSignal.timeout(10000),
+        });
+        return handleResponse(response);
+    }
+    async deregisterWebhook(webhookId) {
+        const url = apiUrl(this.config, `/v1/webhooks/${webhookId}`);
+        const response = await fetch(url, {
+            method: 'DELETE',
+            headers: this.headers(true),
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            let body = {};
+            try {
+                body = JSON.parse(text);
+            }
+            catch { /* non-JSON */ }
+            throw new HearApiError(response.status, body.code || `HTTP_${response.status}`, body.error || response.statusText);
+        }
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/chunker.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Audio file chunking for large files that exceed the API size limit.
+ * Uses ffmpeg to split audio into overlapping chunks, preserving temporal connectivity.
+ *
+ * Overlap: 30s between chunks so boundary events are not lost.
+ */
+import type { ClassifyResult } from './types.js';
+/** Chunk duration (seconds). Keeps each chunk under API 25MB limit. */
+export declare const CHUNK_DURATION_SEC = 120;
+/** Chunk overlap (seconds). Preserves temporal connectivity at chunk boundaries. */
+export declare const CHUNK_OVERLAP_SEC = 30;
+export interface ChunkInfo {
+    path: string;
+    startTime: number;
+    duration: number;
+    index: number;
+}
+/** Check if ffmpeg is available */
+export declare function hasFFmpeg(): boolean;
+/** Get audio duration in seconds using ffprobe */
+export declare function getAudioDuration(filePath: string): number;
+/**
+ * Split audio file into overlapping chunks using ffmpeg.
+ * Returns array of chunk file paths with their time offsets.
+ */
+export declare function splitAudioFile(filePath: string, totalDuration: number, options?: {
+    chunkDurationSec?: number;
+    overlapSec?: number;
+}): ChunkInfo[];
+/** Clean up chunk temp files */
+export declare function cleanupChunks(chunks: ChunkInfo[]): void;
+/**
+ * Merge classification results from multiple chunks into a unified result.
+ * Adjusts timestamps by chunk startTime offset.
+ * Deduplicates overlapping events (same className within overlap window).
+ */
+export declare function mergeChunkResults(chunkResults: Array<{
+    chunk: ChunkInfo;
+    result: ClassifyResult;
+}>, originalFileName: string, totalDuration: number): ClassifyResult;
+//# sourceMappingURL=chunker.d.ts.map

package/dist/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../src/chunker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,mCAAmC;AACnC,wBAAgB,SAAS,IAAI,OAAO,CAOnC;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,SAAS,EAAE,CA2Cb;AAED,gCAAgC;AAChC,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAOvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC7B,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC,EACjE,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,GACtB,cAAc,CA2BhB"}

package/dist/chunker.js

@@ -0,0 +1,141 @@
+/**
+ * Audio file chunking for large files that exceed the API size limit.
+ * Uses ffmpeg to split audio into overlapping chunks, preserving temporal connectivity.
+ *
+ * Overlap: 30s between chunks so boundary events are not lost.
+ */
+import { execSync, spawnSync } from 'child_process';
+import { existsSync, mkdirSync, unlinkSync, rmdirSync } from 'fs';
+import { join, basename } from 'path';
+import { tmpdir } from 'os';
+/** Chunk duration (seconds). Keeps each chunk under API 25MB limit. */
+export const CHUNK_DURATION_SEC = 120;
+/** Chunk overlap (seconds). Preserves temporal connectivity at chunk boundaries. */
+export const CHUNK_OVERLAP_SEC = 30;
+/** Check if ffmpeg is available */
+export function hasFFmpeg() {
+    try {
+        execSync('ffmpeg -version', { stdio: 'pipe', timeout: 5000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Get audio duration in seconds using ffprobe */
+export function getAudioDuration(filePath) {
+    try {
+        const result = execSync(`ffprobe -v error -show_entries format=duration -of csv=p=0 "${filePath}"`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10000 });
+        return parseFloat(result.trim());
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Split audio file into overlapping chunks using ffmpeg.
+ * Returns array of chunk file paths with their time offsets.
+ */
+export function splitAudioFile(filePath, totalDuration, options) {
+    const chunkDuration = options?.chunkDurationSec ?? CHUNK_DURATION_SEC;
+    const overlap = options?.overlapSec ?? CHUNK_OVERLAP_SEC;
+    const chunkDir = join(tmpdir(), `h-ear-chunks-${Date.now()}`);
+    mkdirSync(chunkDir, { recursive: true });
+    const chunks = [];
+    const name = basename(filePath, '.mp3').replace(/\.[^.]+$/, '');
+    let startTime = 0;
+    let index = 0;
+    while (startTime < totalDuration) {
+        const chunkFile = join(chunkDir, `${name}_chunk${index}.mp3`);
+        const duration = Math.min(chunkDuration, totalDuration - startTime);
+        const result = spawnSync('ffmpeg', [
+            '-y',
+            '-ss', String(startTime),
+            '-i', filePath,
+            '-t', String(duration),
+            '-acodec', 'libmp3lame',
+            '-q:a', '4', // Good quality MP3 (~128kbps)
+            chunkFile,
+        ], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            encoding: 'utf-8',
+            timeout: 30000,
+        });
+        if (result.status !== 0 || !existsSync(chunkFile)) {
+            process.stderr.write(`[h-ear-core] ffmpeg chunk ${index} failed: ${(result.stderr || '').split('\n').pop()}\n`);
+            break;
+        }
+        chunks.push({ path: chunkFile, startTime, duration, index });
+        // Advance by (chunkDuration - overlap) to create overlap
+        startTime += chunkDuration - overlap;
+        index++;
+    }
+    return chunks;
+}
+/** Clean up chunk temp files */
+export function cleanupChunks(chunks) {
+    if (chunks.length === 0)
+        return;
+    const chunkDir = join(chunks[0].path, '..');
+    for (const chunk of chunks) {
+        try {
+            unlinkSync(chunk.path);
+        }
+        catch { /* ignore */ }
+    }
+    try {
+        rmdirSync(chunkDir);
+    }
+    catch { /* ignore */ }
+}
+/**
+ * Merge classification results from multiple chunks into a unified result.
+ * Adjusts timestamps by chunk startTime offset.
+ * Deduplicates overlapping events (same className within overlap window).
+ */
+export function mergeChunkResults(chunkResults, originalFileName, totalDuration) {
+    const allClassifications = [];
+    for (const { chunk, result } of chunkResults) {
+        if (!result.classifications)
+            continue;
+        for (const cls of result.classifications) {
+            allClassifications.push({
+                ...cls,
+                startTime: (cls.startTime || 0) + chunk.startTime,
+                endTime: (cls.endTime || 0) + chunk.startTime,
+            });
+        }
+    }
+    const deduplicated = deduplicateOverlaps(allClassifications);
+    // Sort by startTime
+    deduplicated.sort((a, b) => (a.startTime || 0) - (b.startTime || 0));
+    return {
+        requestId: `merged-${Date.now()}`,
+        duration: totalDuration,
+        processingTimeMs: 0,
+        eventCount: deduplicated.length,
+        classifications: deduplicated,
+    };
+}
+function deduplicateOverlaps(events) {
+    if (events.length <= 1)
+        return events;
+    const sorted = [...events].sort((a, b) => (a.startTime || 0) - (b.startTime || 0));
+    const kept = [];
+    for (const event of sorted) {
+        const duplicate = kept.find(k => k.className === event.className &&
+            Math.abs((k.startTime || 0) - (event.startTime || 0)) < CHUNK_OVERLAP_SEC &&
+            Math.abs((k.endTime || 0) - (event.endTime || 0)) < CHUNK_OVERLAP_SEC);
+        if (duplicate) {
+            if ((event.confidence || 0) > (duplicate.confidence || 0)) {
+                const idx = kept.indexOf(duplicate);
+                kept[idx] = event;
+            }
+        }
+        else {
+            kept.push(event);
+        }
+    }
+    return kept;
+}
+//# sourceMappingURL=chunker.js.map

package/dist/chunker.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Config schema and URL helpers for the H-ear API client.
+ * CLI arg parsing is left to each consumer (mcp-server, openclaw).
+ */
+import { type HearEnvironment } from './constants.js';
+export interface ServerConfig {
+    apiKey: string;
+    environment: HearEnvironment;
+    baseUrl: string;
+    apiPath: string;
+}
+/** Resolve config from environment variables only (no CLI args). */
+export declare function resolveConfigFromEnv(): ServerConfig;
+/** Build full API URL for a path like /v1/health */
+export declare function apiUrl(config: ServerConfig, path: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,eAAe,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,IAAI,YAAY,CAUnD;AAED,oDAAoD;AACpD,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/config.js

@@ -0,0 +1,20 @@
+/**
+ * Config schema and URL helpers for the H-ear API client.
+ * CLI arg parsing is left to each consumer (mcp-server, openclaw).
+ */
+import { ENVIRONMENTS } from './constants.js';
+/** Resolve config from environment variables only (no CLI args). */
+export function resolveConfigFromEnv() {
+    const apiKey = process.env.HEAR_API_KEY || '';
+    const envStr = process.env.HEAR_ENV || 'prod';
+    const environment = (Object.keys(ENVIRONMENTS).includes(envStr) ? envStr : 'prod');
+    const envConfig = ENVIRONMENTS[environment];
+    const baseUrl = process.env.HEAR_BASE_URL || envConfig.baseUrl;
+    const apiPath = envConfig.apiPath;
+    return { apiKey, environment, baseUrl, apiPath };
+}
+/** Build full API URL for a path like /v1/health */
+export function apiUrl(config, path) {
+    return `${config.baseUrl}${config.apiPath}${path}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAwB,MAAM,gBAAgB,CAAC;AASpE,oEAAoE;AACpE,MAAM,UAAU,oBAAoB;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC;IAE9C,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAoB,CAAC;IACtG,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS,CAAC,OAAO,CAAC;IAC/D,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;IAElC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACrD,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,MAAM,CAAC,MAAoB,EAAE,IAAY;IACrD,OAAO,GAAG,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;AACvD,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Standalone API constants for the H-ear API client.
+ * Duplicated from @ncm/config ENTERPRISE_API to maintain zero monorepo dependencies.
+ */
+export declare const HEAR_API: {
+    readonly MAX_FILE_SIZE_BYTES: number;
+    readonly MAX_DURATION_SECONDS: 600;
+    readonly POLL_INTERVAL_MS: 3000;
+    readonly POLL_TIMEOUT_MS: number;
+    readonly MAX_BATCH_FILES: 50;
+    readonly SUPPORTED_FORMATS: readonly ["MP3", "WAV", "FLAC", "OGG", "M4A"];
+    readonly NOOP_CALLBACK_URL: "https://mcp.h-ear.world/noop";
+};
+export declare const ENVIRONMENTS: {
+    readonly dev: {
+        readonly baseUrl: "https://api-dev.h-ear.world";
+        readonly apiPath: "/api";
+    };
+    readonly staging: {
+        readonly baseUrl: "https://api-staging.h-ear.world";
+        readonly apiPath: "/api";
+    };
+    readonly prod: {
+        readonly baseUrl: "https://api.h-ear.world";
+        readonly apiPath: "/api";
+    };
+};
+export type HearEnvironment = keyof typeof ENVIRONMENTS;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,QAAQ;;;;;;;;CASX,CAAC;AAGX,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAIf,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,YAAY,CAAC"}

package/dist/constants.js

@@ -0,0 +1,21 @@
+/**
+ * Standalone API constants for the H-ear API client.
+ * Duplicated from @ncm/config ENTERPRISE_API to maintain zero monorepo dependencies.
+ */
+export const HEAR_API = {
+    MAX_FILE_SIZE_BYTES: 25 * 1024 * 1024, // 25 MB
+    MAX_DURATION_SECONDS: 600, // 10 minutes
+    POLL_INTERVAL_MS: 3000, // 3 second polling interval
+    POLL_TIMEOUT_MS: 5 * 60 * 1000, // 5 minutes max poll wait
+    MAX_BATCH_FILES: 50, // max files per batch
+    SUPPORTED_FORMATS: ['MP3', 'WAV', 'FLAC', 'OGG', 'M4A'],
+    // Noop callback URL -- triggers async 202 response from the API
+    NOOP_CALLBACK_URL: 'https://mcp.h-ear.world/noop',
+};
+// Front Door URLs -- async submit returns 202 in ~1s, no timeout concern
+export const ENVIRONMENTS = {
+    dev: { baseUrl: 'https://api-dev.h-ear.world', apiPath: '/api' },
+    staging: { baseUrl: 'https://api-staging.h-ear.world', apiPath: '/api' },
+    prod: { baseUrl: 'https://api.h-ear.world', apiPath: '/api' },
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,mBAAmB,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAW,QAAQ;IACxD,oBAAoB,EAAE,GAAG,EAAwB,aAAa;IAC9D,gBAAgB,EAAE,IAAI,EAA4B,4BAA4B;IAC9E,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAoB,0BAA0B;IAC5E,eAAe,EAAE,EAAE,EAA+B,sBAAsB;IACxE,iBAAiB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAU;IAChE,gEAAgE;IAChE,iBAAiB,EAAE,8BAA8B;CAC3C,CAAC;AAEX,yEAAyE;AACzE,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,GAAG,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,OAAO,EAAE,MAAM,EAAE;IAChE,OAAO,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,OAAO,EAAE,MAAM,EAAE;IACxE,IAAI,EAAE,EAAE,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,EAAE;CACvD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @h-ear/core — Shared API client for H-ear World audio classification.
+ */
+export { HearApiClient, HearApiError } from './api-client.js';
+export type { ProgressCallback } from './api-client.js';
+export { resolveConfigFromEnv, apiUrl } from './config.js';
+export type { ServerConfig } from './config.js';
+export { HEAR_API, ENVIRONMENTS } from './constants.js';
+export type { HearEnvironment } from './constants.js';
+export { hasFFmpeg, getAudioDuration, splitAudioFile, cleanupChunks, mergeChunkResults, CHUNK_DURATION_SEC, CHUNK_OVERLAP_SEC, } from './chunker.js';
+export type { ChunkInfo } from './chunker.js';
+export type { ClassifyRequest, ClassifyResult, Classification, NoiseEvent, AsyncAccepted, BatchFile, BatchRequest, BatchAccepted, AudioClass, ClassesResult, HealthResult, UsageResult, JobSummary, JobsResult, JobResult, WebhookRegister, WebhookResult, ApiErrorBody, } from './types.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;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EACH,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAC3C,aAAa,EAAE,iBAAiB,EAChC,kBAAkB,EAAE,iBAAiB,GACxC,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,YAAY,EACR,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAC1E,SAAS,EAAE,YAAY,EAAE,aAAa,EACtC,UAAU,EAAE,aAAa,EACzB,YAAY,EACZ,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAC9C,eAAe,EAAE,aAAa,EAC9B,YAAY,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @h-ear/core — Shared API client for H-ear World audio classification.
+ */
+// API Client
+export { HearApiClient, HearApiError } from './api-client.js';
+// Config
+export { resolveConfigFromEnv, apiUrl } from './config.js';
+// Constants
+export { HEAR_API, ENVIRONMENTS } from './constants.js';
+// Chunker
+export { hasFFmpeg, getAudioDuration, splitAudioFile, cleanupChunks, mergeChunkResults, CHUNK_DURATION_SEC, CHUNK_OVERLAP_SEC, } from './chunker.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;;GAEG;AAEH,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG9D,SAAS;AACT,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG3D,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGxD,UAAU;AACV,OAAO,EACH,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAC3C,aAAa,EAAE,iBAAiB,EAChC,kBAAkB,EAAE,iBAAiB,GACxC,MAAM,cAAc,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,162 @@
+/**
+ * TypeScript types for H-ear Enterprise API request/response.
+ */
+export interface ClassifyRequest {
+    base64?: string;
+    url?: string;
+    fileName?: string;
+    threshold?: number;
+    modelId?: string;
+    callbackUrl?: string;
+    callbackSecret?: string;
+    filterMinDurationSeconds?: number;
+    latitude?: number;
+    longitude?: number;
+}
+export interface Classification {
+    class?: string;
+    className?: string;
+    confidence: number;
+    category?: string;
+    startTime?: number;
+    endTime?: number;
+    tier1?: string;
+    tier2?: string;
+    tier3?: string;
+    sourceId?: string;
+    decibelLevel?: number;
+    taxonomy?: string;
+    modelIndex?: number;
+    tierDepth?: number;
+    [key: string]: unknown;
+}
+export interface NoiseEvent {
+    label: string;
+    startTime: number;
+    confidence: number;
+}
+export interface ClassifyResult {
+    requestId: string;
+    duration: number;
+    processingTimeMs: number;
+    eventCount: number;
+    classifications: Classification[];
+    noiseEvents?: NoiseEvent[];
+    reportUrl?: string;
+}
+export interface AsyncAccepted {
+    requestId: string;
+    status: 'processing';
+    message: string;
+    callbackUrl?: string;
+    pollUrl: string;
+}
+export interface BatchFile {
+    url: string;
+    id?: string;
+    metadata?: Record<string, string>;
+}
+export interface BatchRequest {
+    files: BatchFile[];
+    callbackUrl: string;
+    callbackSecret?: string;
+    threshold?: number;
+    modelId?: string;
+    filterMinDurationSeconds?: number;
+}
+export interface BatchAccepted {
+    batchId: string;
+    fileCount: number;
+    jobIds: string[];
+    status: 'processing';
+    estimatedCompletionMinutes: number;
+    message: string;
+    pollUrls: string[];
+}
+export interface AudioClass {
+    index: number;
+    name: string;
+    category: string;
+    tier1?: string;
+    tier2?: string;
+}
+export interface ClassesResult {
+    taxonomy: string;
+    classes: AudioClass[];
+    total: number;
+    totalFiltered: number;
+    totalAvailable: number;
+    categories: string[];
+    availableTaxonomies: string[];
+    pagination?: {
+        offset: number;
+        limit: number;
+        hasMore: boolean;
+    };
+}
+export interface HealthResult {
+    status: string;
+    version: string;
+    deployedTimestamp: string;
+}
+export interface UsageResult {
+    plan: string;
+    minutesUsed: number;
+    minutesTotal: number;
+    callsToday: number;
+    callsLimit: number;
+    activeKeys: number;
+    periodStart: string;
+    periodEnd: string;
+}
+export interface JobSummary {
+    jobId: string;
+    status: string;
+    fileName?: string;
+    duration?: number;
+    eventCount?: number;
+    createdAt: string;
+    completedAt?: string;
+}
+export interface JobsResult {
+    jobs: JobSummary[];
+    total: number;
+    pagination: {
+        offset: number;
+        limit: number;
+        hasMore: boolean;
+    };
+}
+export interface JobResult {
+    jobId: string;
+    status: string;
+    fileName?: string;
+    duration?: number;
+    eventCount?: number;
+    createdAt: string;
+    completedAt?: string;
+    classifications?: Classification[];
+    noiseEvents?: NoiseEvent[];
+    reportUrl?: string;
+}
+export interface WebhookRegister {
+    url: string;
+    events: string[];
+    secret?: string;
+    soundClass?: string;
+}
+export interface WebhookResult {
+    webhookId: string;
+    url: string;
+    events: string[];
+    soundClass?: string;
+    status: string;
+    createdAt: string;
+}
+export interface ApiErrorBody {
+    error: string;
+    code: string;
+    requestId?: string;
+    hint?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * TypeScript types for H-ear Enterprise API request/response.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@h-ear/core",
+  "version": "0.1.0-dev.202603280856",
+  "description": "Shared API client for H-ear World audio classification — used by @h-ear/mcp-server and @h-ear/openclaw",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./api-client": {
+      "import": "./dist/api-client.js",
+      "types": "./dist/api-client.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types.js",
+      "types": "./dist/types.d.ts"
+    },
+    "./chunker": {
+      "import": "./dist/chunker.js",
+      "types": "./dist/chunker.d.ts"
+    },
+    "./constants": {
+      "import": "./dist/constants.js",
+      "types": "./dist/constants.d.ts"
+    },
+    "./config": {
+      "import": "./dist/config.js",
+      "types": "./dist/config.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "h-ear",
+    "audio",
+    "classification",
+    "noise",
+    "sound",
+    "api-client"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/noise-control-monitor/ncm-monorepo",
+    "directory": "packages/core"
+  }
+}