@h-ear/openclaw 0.1.0-dev.202603281753 → 0.1.0-dev.202603290313

package/SKILL.md

@@ -1,34 +1,44 @@
 ---
 name: h-ear
-description: Audio classification and noise monitoring. Classify audio files, list 521+ sound classes, check usage, browse jobs, and set up sound alerts.
+description: "H-ear.world transforms sound into an actionable, meaningful translation layer of the world around you. Describe, share and act upon audio as a spatiotemporal annotated soundscape that empowers you, your business and your AI flow."
 version: 0.1.0
 author: H-ear World
 homepage: https://h-ear.world
 openclaw:
   requires:
-    env: [HEAR_API_KEY]
+    env: [HEAR_API_KEY, HEAR_ENV]
     bins: []
   primaryEnv: HEAR_API_KEY
 ---
 
 # H-ear — Sound Intelligence for AI Agents
 
-Classify audio, detect noise events, and set up real-time sound alerts through any messaging channel.
+H-ear.world transforms sound into an actionable, meaningful translation layer of the world around you. Describe, share and act upon audio as a spatiotemporal annotated soundscape that empowers you, your business and your AI flow.
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `classify <url>` | Classify audio from a URL |
-| `classify batch <url1> <url2>...` | Batch classify multiple audio URLs |
-| `sounds [search]` | List supported sound classes (521+) |
-| `usage` | Show API usage statistics |
-| `jobs [last N]` | List recent classification jobs |
-| `job <id>` | Show detailed job results |
-| `alerts on <sound>` | Enable alerts for a sound class |
-| `alerts off <sound>` | Disable alerts for a sound class |
-| `health` | Check API status |
+| `classify <url>` | Classify audio from a URL. Returns detected sound classes with confidence scores. |
+| `classify batch <url1> <url2>...` | Batch classify multiple audio URLs. Results delivered asynchronously via the gateway's webhook endpoint. |
+| `sounds [search]` | List supported sound classes (521+ across 3 taxonomies). |
+| `usage` | Show API usage statistics (minutes, calls, quota). |
+| `jobs [last N]` | List recent classification jobs with status. |
+| `job <id>` | Show detailed job results with classifications. |
+| `alerts on <sound>` | Enable real-time alerts for a sound class. Notifications delivered to your connected channel via the gateway. |
+| `alerts off <sound>` | Disable alerts for a sound class. |
+| `health` | Check API status. |
 
 ## Setup
 
-Set `HEAR_API_KEY` to your H-ear Enterprise API key. Get one at [h-ear.world](https://h-ear.world).
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `HEAR_API_KEY` | Yes | | H-ear Enterprise API key. Get one at [h-ear.world](https://h-ear.world). |
+| `HEAR_ENV` | Yes | | Target environment: `dev`, `staging`, or `prod`. |
+| `HEAR_BASE_URL` | No | Per-environment default | Override API base URL (advanced). |
+
+## Webhook Delivery
+
+Batch classification (`classify batch`) and sound alerts (`alerts on`) use webhook callbacks for asynchronous result delivery. The OpenClaw gateway manages webhook endpoints automatically -- the skill registers callbacks against the gateway's own webhook receiver, which routes results back to your connected messaging channel. No external endpoint configuration is required by the user.
+
+Webhook events: `job.completed`, `job.failed`, `batch.completed`, `quota.warning`.

package/dist/commands/alerts.d.ts

@@ -1,4 +1,6 @@
 import type { HearApiClient } from '@h-ear/core';
-export declare function alertOnCommand(client: HearApiClient, soundClass: string, callbackUrl: string): Promise<string>;
+export declare function alertOnCommand(client: HearApiClient, soundClass: string, options?: {
+    callbackUrl?: string;
+}): Promise<string>;
 export declare function alertOffCommand(client: HearApiClient, webhookId: string, soundClass: string): Promise<string>;
 //# sourceMappingURL=alerts.d.ts.map

package/dist/commands/alerts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/commands/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,wBAAsB,cAAc,CAChC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,wBAAsB,eAAe,CACjC,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAGjB"}
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/commands/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,wBAAsB,cAAc,CAChC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,wBAAsB,eAAe,CACjC,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/commands/alerts.js

@@ -1,7 +1,9 @@
 import { formatAlertRegistered, formatAlertDeregistered } from '../formatter.js';
-export async function alertOnCommand(client, soundClass, callbackUrl) {
+/** Default gateway webhook receiver — OpenClaw routes alerts back to the user's channel. */
+const GATEWAY_CALLBACK = 'https://gateway.openclaw.ai/webhooks/h-ear';
+export async function alertOnCommand(client, soundClass, options) {
     await client.registerWebhook({
-        url: callbackUrl,
+        url: options?.callbackUrl ?? GATEWAY_CALLBACK,
         events: ['job.completed'],
         soundClass,
     });

package/dist/commands/alerts.js.map

@@ -1 +1 @@
-{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/commands/alerts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,MAAqB,EACrB,UAAkB,EAClB,WAAmB;IAEnB,MAAM,MAAM,CAAC,eAAe,CAAC;QACzB,GAAG,EAAE,WAAW;QAChB,MAAM,EAAE,CAAC,eAAe,CAAC;QACzB,UAAU;KACb,CAAC,CAAC;IACH,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,MAAqB,EACrB,SAAiB,EACjB,UAAkB;IAElB,MAAM,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC1C,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/commands/alerts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,4FAA4F;AAC5F,MAAM,gBAAgB,GAAG,4CAA4C,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,MAAqB,EACrB,UAAkB,EAClB,OAAkC;IAElC,MAAM,MAAM,CAAC,eAAe,CAAC;QACzB,GAAG,EAAE,OAAO,EAAE,WAAW,IAAI,gBAAgB;QAC7C,MAAM,EAAE,CAAC,eAAe,CAAC;QACzB,UAAU;KACb,CAAC,CAAC;IACH,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,MAAqB,EACrB,SAAiB,EACjB,UAAkB;IAElB,MAAM,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC1C,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;AAC/C,CAAC"}

package/dist/commands/classify-batch.d.ts

@@ -1,5 +1,6 @@
 import type { HearApiClient } from '@h-ear/core';
-export declare function classifyBatchCommand(client: HearApiClient, urls: string[], callbackUrl: string, options?: {
+export declare function classifyBatchCommand(client: HearApiClient, urls: string[], options?: {
     threshold?: number;
+    callbackUrl?: string;
 }): Promise<string>;
 //# sourceMappingURL=classify-batch.d.ts.map

package/dist/commands/classify-batch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classify-batch.d.ts","sourceRoot":"","sources":["../../src/commands/classify-batch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EAAE,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,OAAO,CAAC,MAAM,CAAC,CAejB"}
+{"version":3,"file":"classify-batch.d.ts","sourceRoot":"","sources":["../../src/commands/classify-batch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/commands/classify-batch.js

@@ -1,8 +1,10 @@
-export async function classifyBatchCommand(client, urls, callbackUrl, options) {
+/** Default gateway webhook receiver — OpenClaw routes results back to the user's channel. */
+const GATEWAY_CALLBACK = 'https://gateway.openclaw.ai/webhooks/h-ear';
+export async function classifyBatchCommand(client, urls, options) {
     const files = urls.map((url, i) => ({ url, id: `file-${i + 1}` }));
     const result = await client.classifyBatch({
         files,
-        callbackUrl,
+        callbackUrl: options?.callbackUrl ?? GATEWAY_CALLBACK,
         threshold: options?.threshold ?? 0.3,
     });
     return [

package/dist/commands/classify-batch.js.map

@@ -1 +1 @@
-{"version":3,"file":"classify-batch.js","sourceRoot":"","sources":["../../src/commands/classify-batch.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,MAAqB,EACrB,IAAc,EACd,WAAmB,EACnB,OAAgC;IAEhC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;QACtC,KAAK;QACL,WAAW;QACX,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,GAAG;KACvC,CAAC,CAAC;IAEH,OAAO;QACH,qBAAqB;QACrB,aAAa,MAAM,CAAC,OAAO,EAAE;QAC7B,UAAU,MAAM,CAAC,SAAS,EAAE;QAC5B,eAAe,MAAM,CAAC,0BAA0B,MAAM;QACtD,WAAW,MAAM,CAAC,MAAM,EAAE;KAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}
+{"version":3,"file":"classify-batch.js","sourceRoot":"","sources":["../../src/commands/classify-batch.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,MAAM,gBAAgB,GAAG,4CAA4C,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,MAAqB,EACrB,IAAc,EACd,OAAsD;IAEtD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;QACtC,KAAK;QACL,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,gBAAgB;QACrD,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,GAAG;KACvC,CAAC,CAAC;IAEH,OAAO;QACH,qBAAqB;QACrB,aAAa,MAAM,CAAC,OAAO,EAAE;QAC7B,UAAU,MAAM,CAAC,SAAS,EAAE;QAC5B,eAAe,MAAM,CAAC,0BAA0B,MAAM;QACtD,WAAW,MAAM,CAAC,MAAM,EAAE;KAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,YAAY,EAAwB,MAAM,aAAa,CAAC;AAEpF,wBAAgB,aAAa,IAAI,YAAY,CAU5C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,YAAY,EAAwB,MAAM,aAAa,CAAC;AAEpF,wBAAgB,aAAa,IAAI,YAAY,CAY5C"}

package/dist/config.js

@@ -4,12 +4,15 @@
  */
 import { ENVIRONMENTS } from '@h-ear/core';
 export function resolveConfig() {
-    const apiKey = process.env.HEAR_API_KEY || '';
+    const apiKey = process.env.HEAR_API_KEY;
+    const bearerToken = process.env.HEAR_BEARER_TOKEN || undefined;
+    if (!apiKey && !bearerToken)
+        throw new Error('HEAR_API_KEY or HEAR_BEARER_TOKEN environment variable is required');
     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 };
+    return { apiKey: apiKey || '', bearerToken, environment, baseUrl, apiPath };
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAA2C,MAAM,aAAa,CAAC;AAEpF,MAAM,UAAU,aAAa;IACzB,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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAA2C,MAAM,aAAa,CAAC;AAEpF,MAAM,UAAU,aAAa;IACzB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACxC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,SAAS,CAAC;IAC/D,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACnH,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,MAAM,IAAI,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAChF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-ear/openclaw",
-  "version": "0.1.0-dev.202603281753",
+  "version": "0.1.0-dev.202603290313",
   "description": "OpenClaw skill for H-ear World audio classification — sound intelligence in WhatsApp, Telegram, Slack, Discord, and Teams",
   "type": "module",
   "main": "./dist/index.js",