@perkos/perkos-a2a 0.12.64 → 0.12.66

package/dist/platform-control-plane.d.ts

@@ -0,0 +1,9 @@
+import type { A2APluginConfig } from "./types.js";
+export type PlatformControlPlane = {
+    apiBaseUrl: string;
+    agentId: string;
+    relayApiKey: string;
+};
+/** Resolve the same platform identity whether installers persisted it in config or service env. */
+export declare function resolvePlatformControlPlane(config: A2APluginConfig, env?: Record<string, string | undefined>): PlatformControlPlane | null;
+//# sourceMappingURL=platform-control-plane.d.ts.map

package/dist/platform-control-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-control-plane.d.ts","sourceRoot":"","sources":["../src/platform-control-plane.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,eAAe,EACvB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,oBAAoB,GAAG,IAAI,CAgB7B"}

package/dist/platform-control-plane.js

@@ -0,0 +1,25 @@
+/** Resolve the same platform identity whether installers persisted it in config or service env. */
+export function resolvePlatformControlPlane(config, env = process.env) {
+    const heartbeat = config.platform?.heartbeatUrl?.trim() || env.PERKOS_HEARTBEAT_URL?.trim();
+    const relayApiKey = config.relay?.apiKey?.trim()
+        || config.chat?.apiKey?.trim()
+        || env.A2A_RELAY_API_KEY?.trim()
+        || env.A2A_CHAT_API_KEY?.trim();
+    if (!heartbeat || !relayApiKey)
+        return null;
+    let url;
+    try {
+        url = new URL(heartbeat);
+    }
+    catch {
+        return null;
+    }
+    const match = url.pathname.match(/^(.*)\/agents\/([^/]+)\/heartbeat\/?$/u);
+    const agentId = config.platform?.agentId?.trim()
+        || (match ? decodeURIComponent(match[2]) : "")
+        || env.PERKOS_AGENT_ID?.trim();
+    if (!match || !agentId)
+        return null;
+    return { apiBaseUrl: `${url.origin}${match[1]}`, agentId, relayApiKey };
+}
+//# sourceMappingURL=platform-control-plane.js.map

package/dist/platform-control-plane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-control-plane.js","sourceRoot":"","sources":["../src/platform-control-plane.ts"],"names":[],"mappings":"AAQA,mGAAmG;AACnG,MAAM,UAAU,2BAA2B,CACzC,MAAuB,EACvB,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC;IAC5F,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;WAC3C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;WAC3B,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE;WAC7B,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAE5C,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IACxD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;WAC3C,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;WAC5C,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IACjC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAC1E,CAAC"}

package/dist/platform-control-plane.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform-control-plane.test.d.ts.map

package/dist/platform-control-plane.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-control-plane.test.d.ts","sourceRoot":"","sources":["../src/platform-control-plane.test.ts"],"names":[],"mappings":""}

package/dist/platform-control-plane.test.js

@@ -0,0 +1,32 @@
+import { describe, expect, it } from "vitest";
+import { resolvePlatformControlPlane } from "./platform-control-plane.js";
+const baseConfig = {
+    agentName: "Athena",
+    port: 5050,
+    skills: [],
+    peers: {},
+    runtime: { kind: "hermes-api" },
+};
+describe("resolvePlatformControlPlane", () => {
+    it("uses plugin config when the complete identity is persisted there", () => {
+        expect(resolvePlatformControlPlane({
+            ...baseConfig,
+            relay: { enabled: true, url: "wss://dev.transport.perkos.xyz/a2a", apiKey: "rk_config" },
+            platform: { agentId: "athena", heartbeatUrl: "https://dev.api.perkos.xyz/agents/athena/heartbeat" },
+        }, {})).toEqual({ apiBaseUrl: "https://dev.api.perkos.xyz", agentId: "athena", relayApiKey: "rk_config" });
+    });
+    it("uses service env when update-hermes keeps runtime identity outside plugin JSON", () => {
+        expect(resolvePlatformControlPlane(baseConfig, {
+            PERKOS_HEARTBEAT_URL: "https://dev.api.perkos.xyz/agents/athena/heartbeat",
+            A2A_RELAY_API_KEY: "rk_env",
+        })).toEqual({ apiBaseUrl: "https://dev.api.perkos.xyz", agentId: "athena", relayApiKey: "rk_env" });
+    });
+    it("fails closed without a complete validated heartbeat identity", () => {
+        expect(resolvePlatformControlPlane(baseConfig, { A2A_RELAY_API_KEY: "rk_env" })).toBeNull();
+        expect(resolvePlatformControlPlane(baseConfig, {
+            PERKOS_HEARTBEAT_URL: "not-a-url",
+            A2A_RELAY_API_KEY: "rk_env",
+        })).toBeNull();
+    });
+});
+//# sourceMappingURL=platform-control-plane.test.js.map

package/dist/platform-control-plane.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-control-plane.test.js","sourceRoot":"","sources":["../src/platform-control-plane.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAG1E,MAAM,UAAU,GAAoB;IAClC,SAAS,EAAE,QAAQ;IACnB,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;CAChC,CAAC;AAEF,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,2BAA2B,CAAC;YACjC,GAAG,UAAU;YACb,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,oCAAoC,EAAE,MAAM,EAAE,WAAW,EAAE;YACxF,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,oDAAoD,EAAE;SACpG,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,4BAA4B,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACxF,MAAM,CAAC,2BAA2B,CAAC,UAAU,EAAE;YAC7C,oBAAoB,EAAE,oDAAoD;YAC1E,iBAAiB,EAAE,QAAQ;SAC5B,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,4BAA4B,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,2BAA2B,CAAC,UAAU,EAAE,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5F,MAAM,CAAC,2BAA2B,CAAC,UAAU,EAAE;YAC7C,oBAAoB,EAAE,WAAW;YACjC,iBAAiB,EAAE,QAAQ;SAC5B,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/voice-capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voice-capability.d.ts","sourceRoot":"","sources":["../src/voice-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAE/D,eAAO,MAAM,yBAAyB,EAAG,oBAA6B,CAAC;AACvE,eAAO,MAAM,0BAA0B,EAAG,qBAA8B,CAAC;AAEzE,KAAK,WAAW,GAAG;IACjB,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpG,2BAA2B,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxG,CAAC;AAEF,KAAK,iBAAiB,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;AAsCpD;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EACvB,SAAS,GAAE,iBAAiC,GAC3C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBxB"}
+{"version":3,"file":"voice-capability.d.ts","sourceRoot":"","sources":["../src/voice-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAG/D,eAAO,MAAM,yBAAyB,EAAG,oBAA6B,CAAC;AACvE,eAAO,MAAM,0BAA0B,EAAG,qBAA8B,CAAC;AAEzE,KAAK,WAAW,GAAG;IACjB,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpG,2BAA2B,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxG,CAAC;AAEF,KAAK,iBAAiB,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;AA0BpD;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EACvB,SAAS,GAAE,iBAAiC,GAC3C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBxB"}

package/dist/voice-capability.js

@@ -1,3 +1,4 @@
+import { resolvePlatformControlPlane } from "./platform-control-plane.js";
 export const PERKOS_VOICE_PROBE_MARKER = "PERKOS_VOICE_PROBE";
 export const PERKOS_VOICE_ENROLL_MARKER = "PERKOS_VOICE_ENROLL";
 function runtime(runtimeKind) {
@@ -9,28 +10,10 @@ function runtime(runtimeKind) {
         return "zeroclaw";
     return null;
 }
-function controlPlane(config) {
-    const heartbeat = config.platform?.heartbeatUrl;
-    const relayApiKey = config.relay?.apiKey || config.chat?.apiKey;
-    if (!heartbeat || !relayApiKey)
-        return null;
-    let url;
-    try {
-        url = new URL(heartbeat);
-    }
-    catch {
-        return null;
-    }
-    const match = url.pathname.match(/^(.*)\/agents\/([^/]+)\/heartbeat\/?$/u);
-    const agentId = config.platform?.agentId || (match ? decodeURIComponent(match[2]) : "");
-    if (!match || !agentId)
-        return null;
-    return { apiBaseUrl: `${url.origin}${match[1]}`, agentId, relayApiKey };
-}
 async function reportPluginMissing(message, config) {
     if (message !== PERKOS_VOICE_PROBE_MARKER)
         return "PERKOS_VOICE_FAILED:voice_plugin_missing";
-    const target = controlPlane(config);
+    const target = resolvePlatformControlPlane(config);
     if (!target)
         return "PERKOS_VOICE_FAILED:a2a_identity_unavailable";
     const response = await fetch(`${target.apiBaseUrl}/agents/${encodeURIComponent(target.agentId)}/voice-credential/capability-report`, {
@@ -53,7 +36,7 @@ export async function tryHandleInstalledVoiceMarker(message, config, loadVoice =
     const marker = message.trim();
     if (marker !== PERKOS_VOICE_PROBE_MARKER && marker !== PERKOS_VOICE_ENROLL_MARKER)
         return null;
-    const target = controlPlane(config);
+    const target = resolvePlatformControlPlane(config);
     if (!target)
         return "PERKOS_VOICE_FAILED:a2a_identity_unavailable";
     const runtimeKind = runtime(config.runtime?.kind);

package/dist/voice-capability.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice-capability.js","sourceRoot":"","sources":["../src/voice-capability.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"voice-capability.js","sourceRoot":"","sources":["../src/voice-capability.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE1E,MAAM,CAAC,MAAM,yBAAyB,GAAG,oBAA6B,CAAC;AACvE,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAA8B,CAAC;AASzE,SAAS,OAAO,CAAC,WAAoC;IACnD,IAAI,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,YAAY;QAAE,OAAO,QAAQ,CAAC;IAC9E,IAAI,WAAW,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAClD,IAAI,WAAW,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,OAAe,EAAE,MAAuB;IACzE,IAAI,OAAO,KAAK,yBAAyB;QAAE,OAAO,0CAA0C,CAAC;IAC7F,MAAM,MAAM,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM;QAAE,OAAO,8CAA8C,CAAC;IACnE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,UAAU,WAAW,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,qCAAqC,EAAE;QACnI,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC9F,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,sBAAsB,EAAE,CAAC;KACnF,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,+CAA+C,CAAC,CAAC,CAAC,+CAA+C,CAAC;AAC1H,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,SAAS,GAAG,0BAA0B,CAAC;IAC7C,OAAO,MAAM,CAAC,SAAS,CAAyB,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAAe,EACf,MAAuB,EACvB,YAA+B,aAAa;IAE5C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,MAAM,KAAK,yBAAyB,IAAI,MAAM,KAAK,0BAA0B;QAAE,OAAO,IAAI,CAAC;IAC/F,MAAM,MAAM,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM;QAAE,OAAO,8CAA8C,CAAC;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,WAAW;QAAE,OAAO,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7D,IAAI,KAAkB,CAAC;IACvB,IAAI,CAAC;QAAC,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,CAAC;IACxF,IAAI,OAAO,KAAK,CAAC,oBAAoB,KAAK,UAAU,IAAI,OAAO,KAAK,CAAC,2BAA2B,KAAK,UAAU,EAAE,CAAC;QAChH,OAAO,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC,oBAAoB,CAAC,MAAM,EAAE;QACxC,GAAG,MAAM;QACT,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,KAAK,CAAC,2BAA2B;KAC7C,CAAC,CAAC;AACL,CAAC"}

package/docs/plans/2026-09-02-runtime-env-control-plane-design.md

@@ -0,0 +1,15 @@
+# Identidad del control plane desde config o entorno
+
+## Hallazgo
+
+El bridge Hermes instalado por `update-hermes` puede conservar `PERKOS_HEARTBEAT_URL` y `A2A_RELAY_API_KEY` en el entorno del servicio. Heartbeat ya lee ambos orígenes, pero los handlers de mantenimiento y Voice sólo consultaban el JSON del plugin. Así, una instancia podía anunciar una capability Chat-bound válida y responder `a2a_identity_unavailable` al recibir el marcador.
+
+## Decisión
+
+Un resolvedor compartido aplica una precedencia única: configuración explícita del plugin y luego variables del servicio. Valida una URL de heartbeat con la ruta exacta `/agents/<id>/heartbeat`, deriva el API base y nunca registra ni devuelve la credencial fuera del proceso. Mantenimiento y Voice consumen el mismo resolvedor para impedir nuevas divergencias.
+
+## Seguridad y verificación
+
+La ausencia de URL o credencial continúa fallando cerrado. La capability sigue ligada a la conexión Chat y a `bridgeInstanceId`; este cambio sólo hace accesible al handler la misma identidad que ya usa heartbeat. Las pruebas cubren identidad completa en config, fallback completo por entorno y rechazo de identidad incompleta o URL inválida.
+
+> Relacionado: [[PerkOS-Projects/README]] · [[PerkOS-A2A]] · [[PerkOS-API]] · [[PerkOS]] · [[PerkOS-Voice]]

package/docs/plans/2026-09-02-voice-0.1.1-resolution-design.md

@@ -0,0 +1,20 @@
+# Resolución opcional de PerkOS Voice 0.1.1
+
+> Relacionado: `docs/plans/2026-09-01-optional-voice-package-resolution-design.md`
+
+## Objetivo
+
+Distribuir la reducción de polling incluida en `@perkos/perkos-voice@0.1.1` a los agentes que declaren soporte de voz, sin convertir Voice en un requisito para todos los runtimes.
+
+## Diseño
+
+`@perkos/perkos-a2a` conserva Voice en `optionalDependencies` y actualiza el rango mínimo a `^0.1.1`. El lockfile fija exactamente el artefacto público `0.1.1` y su integridad. La carga continúa siendo dinámica mediante el adaptador A2A existente: si Voice está disponible se atienden los marcadores de capacidad y enrolamiento; si no está disponible se reporta `voice_plugin_missing` sin interrumpir chat, tareas ni A2A.
+
+La versión de A2A avanza a `0.12.66` para producir un artefacto nuevo y reproducible. Los agentes instalados no deben compartir credenciales entre Production, Dev y QA. Cada despliegue recibe su propio control plane, identidad y servicio local; la activación ocurre únicamente después de la comprobación de capacidad.
+
+## Verificación
+
+- manifests de A2A con la misma versión;
+- lockfile resolviendo Voice `0.1.1` con el hash publicado;
+- lint, pruebas y build completos;
+- `npm pack --dry-run` confirmando que los adaptadores y scripts requeridos estén incluidos.

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "perkos-a2a",
   "name": "PerkOS A2A",
-  "version": "0.12.64",
+  "version": "0.12.66",
   "description": "Agent-to-Agent (A2A) protocol communication for OpenClaw agents",
   "author": "PerkOS",
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perkos/perkos-a2a",
-  "version": "0.12.64",
+  "version": "0.12.66",
   "description": "A2A Protocol communication plugin for OpenClaw — Agent-to-Agent protocol implementation",
   "type": "module",
   "main": "dist/index.js",
@@ -79,7 +79,7 @@
     "ws": "^8.20.1"
   },
   "optionalDependencies": {
-    "@perkos/perkos-voice": "^0.1.0"
+    "@perkos/perkos-voice": "^0.1.1"
   },
   "overrides": {
     "qs": "^6.15.2"