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

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/package.json

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