@apa-network/agent-sdk 0.2.0-beta.10 → 0.2.0-beta.13

package/README.md

@@ -123,6 +123,8 @@ Default path:
 ./credentials.json
 ```
 
+You should not create this file manually. `apa-bot register` writes it automatically.
+
 Format (single credential only):
 
 ```json

package/bin/apa-bot.js

@@ -1,7 +1,12 @@
 #!/usr/bin/env node
 import("../dist/cli.js")
-  .then((mod) => mod.runCLI())
+  .then((mod) => mod.runCLIEntrypoint())
   .catch((err) => {
-    console.error(err instanceof Error ? err.message : String(err));
+    const payload = {
+      type: "error",
+      error: "cli_bootstrap_error",
+      message: err instanceof Error ? err.message : String(err)
+    };
+    process.stdout.write(`${JSON.stringify(payload)}\n`);
     process.exit(1);
   });

package/dist/cli.d.ts

@@ -1 +1,2 @@
 export declare function runCLI(argv?: string[]): Promise<void>;
+export declare function runCLIEntrypoint(argv?: string[]): Promise<void>;

package/dist/cli.js

@@ -1,6 +1,6 @@
 import { APAHttpClient } from "./http/client.js";
 import { resolveApiBase, requireArg } from "./utils/config.js";
-import { loadCredential, saveCredential } from "./loop/credentials.js";
+import { defaultCredentialPath, loadCredential, saveCredential } from "./loop/credentials.js";
 import { loadDecisionState, saveDecisionState } from "./loop/decision_state.js";
 import { TurnTracker } from "./loop/state.js";
 import { buildCredentialFromRegisterResult } from "./commands/register.js";
@@ -65,7 +65,8 @@ Config priority: CLI args > env (API_BASE) > defaults.`);
 async function requireApiKey(apiBase) {
     const cached = await loadCredential(apiBase, undefined);
     if (!cached?.api_key) {
-        throw new Error("api_key_not_found (run apa-bot register)");
+        const path = defaultCredentialPath();
+        throw new Error(`api_key_not_found for api_base=${apiBase} (run apa-bot register). path=${path}`);
     }
     return cached.api_key;
 }
@@ -82,6 +83,16 @@ function claimCodeFromUrl(raw) {
 function emit(message) {
     process.stdout.write(`${JSON.stringify(message)}\n`);
 }
+function toErrorPayload(err) {
+    const apiErr = err;
+    const code = apiErr?.code || "cli_error";
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        type: "error",
+        error: code,
+        message
+    };
+}
 function readLegalActions(state) {
     const raw = state["legal_actions"];
     if (!Array.isArray(raw)) {
@@ -591,3 +602,12 @@ export async function runCLI(argv = process.argv.slice(2)) {
             throw new Error(`unknown command: ${command}`);
     }
 }
+export async function runCLIEntrypoint(argv = process.argv.slice(2)) {
+    try {
+        await runCLI(argv);
+    }
+    catch (err) {
+        emit(toErrorPayload(err));
+        process.exitCode = 1;
+    }
+}

package/dist/commands/register.js

@@ -3,9 +3,13 @@ export function buildCredentialFromRegisterResult(result, apiBase, fallbackName)
     if (!obj) {
         return null;
     }
-    const agentID = typeof obj.agent_id === "string" ? obj.agent_id : "";
-    const apiKey = typeof obj.api_key === "string" ? obj.api_key : "";
-    const agentName = typeof obj.name === "string" && obj.name.trim() ? obj.name : fallbackName;
+    const agent = (obj.agent && typeof obj.agent === "object" ? obj.agent : null);
+    if (!agent) {
+        return null;
+    }
+    const agentID = typeof agent.agent_id === "string" ? agent.agent_id : "";
+    const apiKey = typeof agent.api_key === "string" ? agent.api_key : "";
+    const agentName = typeof agent.name === "string" && agent.name.trim() ? agent.name : fallbackName;
     if (!agentID || !apiKey || !agentName) {
         return null;
     }

package/dist/commands/register.test.js

@@ -3,9 +3,11 @@ import assert from "node:assert/strict";
 import { buildCredentialFromRegisterResult } from "./register.js";
 test("buildCredentialFromRegisterResult returns credential when response has required fields", () => {
     const out = buildCredentialFromRegisterResult({
-        agent_id: "agent_123",
-        api_key: "apa_123",
-        name: "BotX"
+        agent: {
+            agent_id: "agent_123",
+            api_key: "apa_123",
+            name: "BotX"
+        }
     }, "http://localhost:8080/api", "FallbackBot");
     assert.ok(out);
     assert.equal(out?.agent_id, "agent_123");
@@ -14,13 +16,17 @@ test("buildCredentialFromRegisterResult returns credential when response has req
 });
 test("buildCredentialFromRegisterResult falls back to CLI name and rejects incomplete payload", () => {
     const fallback = buildCredentialFromRegisterResult({
-        agent_id: "agent_abc",
-        api_key: "apa_abc"
+        agent: {
+            agent_id: "agent_abc",
+            api_key: "apa_abc"
+        }
     }, "http://localhost:8080/api", "FallbackBot");
     assert.ok(fallback);
     assert.equal(fallback?.agent_name, "FallbackBot");
     const bad = buildCredentialFromRegisterResult({
-        api_key: "apa_missing_agent"
+        agent: {
+            api_key: "apa_missing_agent"
+        }
     }, "http://localhost:8080/api", "FallbackBot");
     assert.equal(bad, null);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apa-network/agent-sdk",
-  "version": "0.2.0-beta.10",
+  "version": "0.2.0-beta.13",
   "description": "APA Agent SDK and CLI",
   "type": "module",
   "bin": {