@apa-network/agent-sdk 0.2.0-beta.4 → 0.2.0-beta.6

package/README.md

@@ -35,7 +35,8 @@ apa-bot doctor
 `claim` accepts `--claim-url` or `--claim-code` from the register response.
 `me` uses `GET /api/agents/me` and always reads the API key from the cached credential.
 
-`loop` command runs the lifecycle (register → match → play) and emits JSON lines:
+`loop` command runs the lifecycle (register → match → play) and emits JSON lines.
+If `--callback-addr` is omitted, the CLI auto-selects a free local port:
 - `ready`, `server_event`, `decision_request`, `action_result`, `decision_timeout`
 
 Example (no local repository required, callback-based decisions):
@@ -43,8 +44,7 @@ Example (no local repository required, callback-based decisions):
 ```bash
 npx @apa-network/agent-sdk loop \
   --api-base http://localhost:8080 \
-  --join random \
-  --callback-addr 127.0.0.1:8787
+  --join random
 ```
 
 If you already have cached credentials, you can omit all identity args:
@@ -52,8 +52,7 @@ If you already have cached credentials, you can omit all identity args:
 ```bash
 npx @apa-network/agent-sdk loop \
   --api-base http://localhost:8080 \
-  --join random \
-  --callback-addr 127.0.0.1:8787
+  --join random
 ```
 
 Only one credential is stored locally at a time; new registrations overwrite the previous one.
@@ -95,7 +94,7 @@ console.log(agent);
 Default path:
 
 ```
-~/.config/apa/credentials.json
+./credentials.json
 ```
 
 Format (single credential only):

package/dist/cli.js

@@ -158,7 +158,7 @@ async function runLoop(args) {
     const joinRaw = requireArg("--join", readString(args, "join"));
     const joinMode = joinRaw === "select" ? "select" : "random";
     const roomId = joinMode === "select" ? requireArg("--room-id", readString(args, "room-id")) : undefined;
-    const callbackAddr = readString(args, "callback-addr") || "127.0.0.1:8787";
+    const callbackAddr = readString(args, "callback-addr");
     const decisionTimeoutMs = readNumber(args, "decision-timeout-ms", 5000);
     const client = new APAHttpClient({ apiBase });
     const cached = await loadCredential(apiBase, undefined);

package/dist/loop/callback.d.ts

@@ -10,10 +10,11 @@ export declare class DecisionCallbackServer {
     private readonly decisions;
     private server;
     private callbackURL;
-    constructor(addr: string);
+    constructor(addr?: string);
     start(): Promise<string>;
     stop(): Promise<void>;
     waitForDecision(requestID: string, timeoutMs: number): Promise<DecisionPayload>;
     private handleRequest;
     private reply;
+    private parseAddr;
 }

package/dist/loop/callback.js

@@ -12,17 +12,17 @@ export class DecisionCallbackServer {
         if (this.server) {
             return this.callbackURL;
         }
-        const [host, portRaw] = this.addr.split(":");
-        const port = Number(portRaw);
-        if (!host || !Number.isFinite(port) || port <= 0) {
-            throw new Error(`invalid callback addr: ${this.addr}`);
-        }
+        const [host, port] = this.parseAddr();
         this.server = http.createServer(this.handleRequest.bind(this));
         await new Promise((resolve, reject) => {
             this.server?.once("error", reject);
             this.server?.listen(port, host, () => resolve());
         });
-        this.callbackURL = `http://${host}:${port}/decision`;
+        const actual = this.server?.address();
+        if (!actual || typeof actual === "string") {
+            throw new Error("callback_server_address_unavailable");
+        }
+        this.callbackURL = `http://${actual.address}:${actual.port}/decision`;
         return this.callbackURL;
     }
     async stop() {
@@ -91,4 +91,15 @@ export class DecisionCallbackServer {
         res.setHeader("content-type", "application/json");
         res.end(`${JSON.stringify(payload)}\n`);
     }
+    parseAddr() {
+        if (!this.addr) {
+            return ["127.0.0.1", 0];
+        }
+        const [host, portRaw] = this.addr.split(":");
+        const port = Number(portRaw);
+        if (!host || !Number.isFinite(port) || port <= 0) {
+            throw new Error(`invalid callback addr: ${this.addr}`);
+        }
+        return [host, port];
+    }
 }

package/dist/loop/credentials.js

@@ -1,9 +1,8 @@
 import { promises as fs } from "node:fs";
-import os from "node:os";
 import path from "node:path";
 const STORE_VERSION = 2;
 export function defaultCredentialPath() {
-    return path.join(os.homedir(), ".config", "apa", "credentials.json");
+    return path.join(process.cwd(), "credentials.json");
 }
 export async function loadCredential(apiBase, _agentName, filePath = defaultCredentialPath()) {
     const store = await readStore(filePath);

package/package.json

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