acn-client 0.11.2 → 0.12.0

package/dist/index.d.mts

@@ -764,6 +764,30 @@ declare class ACNClient {
         success: boolean;
         message: string;
     }>;
+    /**
+     * Rotate the agent's API key (H1).
+     *
+     * Returns a fresh `acn_*` plaintext key exactly once. The old key
+     * stops working immediately — including any in-process auth caches
+     * the gateway holds for it. Update the local SDK's stored key with
+     * the returned value before the next request:
+     *
+     * ```ts
+     * const { api_key } = await client.rotateApiKey(agentId);
+     * client.config.apiKey = api_key; // or rebuild the client
+     * ```
+     *
+     * Authorization is dual-track on the server: any one of the agent's
+     * current key (the common scheduled-rotation path) or the owner's
+     * Auth0 JWT (the recovery path when the agent has lost its key) is
+     * accepted.
+     */
+    rotateApiKey(agentId: string): Promise<{
+        success: boolean;
+        agent_id: string;
+        api_key: string;
+        message: string;
+    }>;
     /** Send agent heartbeat */
     heartbeat(agentId: string): Promise<{
         success: boolean;

package/dist/index.d.ts

@@ -764,6 +764,30 @@ declare class ACNClient {
         success: boolean;
         message: string;
     }>;
+    /**
+     * Rotate the agent's API key (H1).
+     *
+     * Returns a fresh `acn_*` plaintext key exactly once. The old key
+     * stops working immediately — including any in-process auth caches
+     * the gateway holds for it. Update the local SDK's stored key with
+     * the returned value before the next request:
+     *
+     * ```ts
+     * const { api_key } = await client.rotateApiKey(agentId);
+     * client.config.apiKey = api_key; // or rebuild the client
+     * ```
+     *
+     * Authorization is dual-track on the server: any one of the agent's
+     * current key (the common scheduled-rotation path) or the owner's
+     * Auth0 JWT (the recovery path when the agent has lost its key) is
+     * accepted.
+     */
+    rotateApiKey(agentId: string): Promise<{
+        success: boolean;
+        agent_id: string;
+        api_key: string;
+        message: string;
+    }>;
     /** Send agent heartbeat */
     heartbeat(agentId: string): Promise<{
         success: boolean;

package/dist/index.js

@@ -194,6 +194,27 @@ var ACNClient = class {
   async unregisterAgent(agentId) {
     return this.delete(`/api/v1/agents/${agentId}`);
   }
+  /**
+   * Rotate the agent's API key (H1).
+   *
+   * Returns a fresh `acn_*` plaintext key exactly once. The old key
+   * stops working immediately — including any in-process auth caches
+   * the gateway holds for it. Update the local SDK's stored key with
+   * the returned value before the next request:
+   *
+   * ```ts
+   * const { api_key } = await client.rotateApiKey(agentId);
+   * client.config.apiKey = api_key; // or rebuild the client
+   * ```
+   *
+   * Authorization is dual-track on the server: any one of the agent's
+   * current key (the common scheduled-rotation path) or the owner's
+   * Auth0 JWT (the recovery path when the agent has lost its key) is
+   * accepted.
+   */
+  async rotateApiKey(agentId) {
+    return this.post(`/api/v1/agents/${agentId}/rotate-key`);
+  }
   /** Send agent heartbeat */
   async heartbeat(agentId) {
     return this.post(`/api/v1/agents/${agentId}/heartbeat`);

package/dist/index.mjs

@@ -154,6 +154,27 @@ var ACNClient = class {
   async unregisterAgent(agentId) {
     return this.delete(`/api/v1/agents/${agentId}`);
   }
+  /**
+   * Rotate the agent's API key (H1).
+   *
+   * Returns a fresh `acn_*` plaintext key exactly once. The old key
+   * stops working immediately — including any in-process auth caches
+   * the gateway holds for it. Update the local SDK's stored key with
+   * the returned value before the next request:
+   *
+   * ```ts
+   * const { api_key } = await client.rotateApiKey(agentId);
+   * client.config.apiKey = api_key; // or rebuild the client
+   * ```
+   *
+   * Authorization is dual-track on the server: any one of the agent's
+   * current key (the common scheduled-rotation path) or the owner's
+   * Auth0 JWT (the recovery path when the agent has lost its key) is
+   * accepted.
+   */
+  async rotateApiKey(agentId) {
+    return this.post(`/api/v1/agents/${agentId}/rotate-key`);
+  }
   /** Send agent heartbeat */
   async heartbeat(agentId) {
     return this.post(`/api/v1/agents/${agentId}/heartbeat`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acn-client",
-  "version": "0.11.2",
+  "version": "0.12.0",
   "description": "Official TypeScript/JavaScript client for ACN (Agent Collaboration Network)",
   "main": "dist/index.js",
   "module": "dist/index.mjs",