@unispark.ai/agent-hub 0.1.0

package/dist/cli/index-DPA4QpYc.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import { n as SdkError, t as AgentHubSDK } from "../sdk-DsYThTRp.js";
+import { Command } from "commander";
+//#region src/cli/output.ts
+/** Write a success JSON envelope to stdout. */
+function success(data) {
+	process.stdout.write(`${JSON.stringify({
+		ok: true,
+		data
+	})}\n`);
+}
+/** Write an error JSON envelope to stderr and exit with the given code. */
+function fail(code, message, exitCode = 1) {
+	process.stderr.write(`${JSON.stringify({
+		ok: false,
+		error: {
+			code,
+			message
+		}
+	})}\n`);
+	process.exit(exitCode);
+}
+//#endregion
+//#region src/cli/index.ts
+function resolveConfig() {
+	const token = process.env.AGENT_HUB_TOKEN;
+	if (!token) fail("MISSING_TOKEN", "AGENT_HUB_TOKEN environment variable is required.", 2);
+	return {
+		serverUrl: process.env.AGENT_HUB_SERVER ?? "http://localhost:8000",
+		token
+	};
+}
+function createSdk() {
+	return new AgentHubSDK(resolveConfig());
+}
+function handleError(error) {
+	if (error instanceof SdkError) {
+		const exitCode = error.statusCode === 401 ? 3 : 1;
+		fail(`HTTP_${error.statusCode}`, error.message, exitCode);
+	}
+	if (error instanceof TypeError && "cause" in error) fail("CONNECTION_ERROR", `Cannot connect to server: ${error.message}`, 6);
+	fail("UNKNOWN_ERROR", error instanceof Error ? error.message : String(error), 1);
+}
+const program = new Command();
+program.name("agent-hub").description("Agent Hub CLI — agent-facing entry point").version("0.1.0");
+program.command("register").description("Register this agent and return identity info").action(async () => {
+	try {
+		success(await createSdk().register());
+	} catch (error) {
+		handleError(error);
+	}
+});
+program.command("pull").description("Pull pending messages from inbox").option("-l, --limit <number>", "Maximum entries to return", "10").option("-a, --ack", "Automatically ACK entries after pulling").action(async (options) => {
+	try {
+		const sdk = createSdk();
+		const limit = Number.parseInt(options.limit, 10);
+		if (Number.isNaN(limit) || limit < 1 || limit > 50) fail("INVALID_LIMIT", "Limit must be between 1 and 50.", 2);
+		const result = await sdk.pull(limit);
+		if (options.ack && result.entries.length > 0) await Promise.all(result.entries.map((entry) => sdk.ack(entry.id)));
+		success(result);
+	} catch (error) {
+		handleError(error);
+	}
+});
+program.parse();
+//#endregion
+export {};
+
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/cli/output.ts","../../src/cli/index.ts"],"sourcesContent":["/** Write a success JSON envelope to stdout. */\nexport function success(data: unknown): void {\n  process.stdout.write(`${JSON.stringify({ ok: true, data })}\\n`);\n}\n\n/** Write an error JSON envelope to stderr and exit with the given code. */\nexport function fail(code: string, message: string, exitCode = 1): never {\n  process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message } })}\\n`);\n  process.exit(exitCode);\n}\n","#!/usr/bin/env node\n\nimport { Command } from \"commander\";\nimport { AgentHubSDK, SdkError } from \"../sdk.js\";\nimport { fail, success } from \"./output.js\";\n\nfunction resolveConfig(): { serverUrl: string; token: string } {\n  const token = process.env.AGENT_HUB_TOKEN;\n  if (!token) {\n    fail(\"MISSING_TOKEN\", \"AGENT_HUB_TOKEN environment variable is required.\", 2);\n  }\n  const serverUrl = process.env.AGENT_HUB_SERVER ?? \"http://localhost:8000\";\n  return { serverUrl, token };\n}\n\nfunction createSdk(): AgentHubSDK {\n  const config = resolveConfig();\n  return new AgentHubSDK(config);\n}\n\nfunction handleError(error: unknown): never {\n  if (error instanceof SdkError) {\n    const exitCode = error.statusCode === 401 ? 3 : 1;\n    fail(`HTTP_${error.statusCode}`, error.message, exitCode);\n  }\n  if (error instanceof TypeError && \"cause\" in error) {\n    fail(\"CONNECTION_ERROR\", `Cannot connect to server: ${error.message}`, 6);\n  }\n  const msg = error instanceof Error ? error.message : String(error);\n  fail(\"UNKNOWN_ERROR\", msg, 1);\n}\n\nconst program = new Command();\n\nprogram.name(\"agent-hub\").description(\"Agent Hub CLI — agent-facing entry point\").version(\"0.1.0\");\n\nprogram\n  .command(\"register\")\n  .description(\"Register this agent and return identity info\")\n  .action(async () => {\n    try {\n      const sdk = createSdk();\n      const result = await sdk.register();\n      success(result);\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram\n  .command(\"pull\")\n  .description(\"Pull pending messages from inbox\")\n  .option(\"-l, --limit <number>\", \"Maximum entries to return\", \"10\")\n  .option(\"-a, --ack\", \"Automatically ACK entries after pulling\")\n  .action(async (options: { limit: string; ack?: boolean }) => {\n    try {\n      const sdk = createSdk();\n      const limit = Number.parseInt(options.limit, 10);\n      if (Number.isNaN(limit) || limit < 1 || limit > 50) {\n        fail(\"INVALID_LIMIT\", \"Limit must be between 1 and 50.\", 2);\n      }\n      const result = await sdk.pull(limit);\n\n      if (options.ack && result.entries.length > 0) {\n        await Promise.all(result.entries.map((entry) => sdk.ack(entry.id)));\n      }\n\n      success(result);\n    } catch (error) {\n      handleError(error);\n    }\n  });\n\nprogram.parse();\n"],"mappings":";;;;;AACA,SAAgB,QAAQ,MAAqB;AAC3C,SAAQ,OAAO,MAAM,GAAG,KAAK,UAAU;EAAE,IAAI;EAAM;EAAM,CAAC,CAAC,IAAI;;;AAIjE,SAAgB,KAAK,MAAc,SAAiB,WAAW,GAAU;AACvE,SAAQ,OAAO,MAAM,GAAG,KAAK,UAAU;EAAE,IAAI;EAAO,OAAO;GAAE;GAAM;GAAS;EAAE,CAAC,CAAC,IAAI;AACpF,SAAQ,KAAK,SAAS;;;;ACFxB,SAAS,gBAAsD;CAC7D,MAAM,QAAQ,QAAQ,IAAI;AAC1B,KAAI,CAAC,MACH,MAAK,iBAAiB,qDAAqD,EAAE;AAG/E,QAAO;EAAE,WADS,QAAQ,IAAI,oBAAoB;EAC9B;EAAO;;AAG7B,SAAS,YAAyB;AAEhC,QAAO,IAAI,YADI,eAAe,CACA;;AAGhC,SAAS,YAAY,OAAuB;AAC1C,KAAI,iBAAiB,UAAU;EAC7B,MAAM,WAAW,MAAM,eAAe,MAAM,IAAI;AAChD,OAAK,QAAQ,MAAM,cAAc,MAAM,SAAS,SAAS;;AAE3D,KAAI,iBAAiB,aAAa,WAAW,MAC3C,MAAK,oBAAoB,6BAA6B,MAAM,WAAW,EAAE;AAG3E,MAAK,iBADO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,EACvC,EAAE;;AAG/B,MAAM,UAAU,IAAI,SAAS;AAE7B,QAAQ,KAAK,YAAY,CAAC,YAAY,2CAA2C,CAAC,QAAQ,QAAQ;AAElG,QACG,QAAQ,WAAW,CACnB,YAAY,+CAA+C,CAC3D,OAAO,YAAY;AAClB,KAAI;AAGF,UADe,MADH,WAAW,CACE,UAAU,CACpB;UACR,OAAO;AACd,cAAY,MAAM;;EAEpB;AAEJ,QACG,QAAQ,OAAO,CACf,YAAY,mCAAmC,CAC/C,OAAO,wBAAwB,6BAA6B,KAAK,CACjE,OAAO,aAAa,0CAA0C,CAC9D,OAAO,OAAO,YAA8C;AAC3D,KAAI;EACF,MAAM,MAAM,WAAW;EACvB,MAAM,QAAQ,OAAO,SAAS,QAAQ,OAAO,GAAG;AAChD,MAAI,OAAO,MAAM,MAAM,IAAI,QAAQ,KAAK,QAAQ,GAC9C,MAAK,iBAAiB,mCAAmC,EAAE;EAE7D,MAAM,SAAS,MAAM,IAAI,KAAK,MAAM;AAEpC,MAAI,QAAQ,OAAO,OAAO,QAAQ,SAAS,EACzC,OAAM,QAAQ,IAAI,OAAO,QAAQ,KAAK,UAAU,IAAI,IAAI,MAAM,GAAG,CAAC,CAAC;AAGrE,UAAQ,OAAO;UACR,OAAO;AACd,cAAY,MAAM;;EAEpB;AAEJ,QAAQ,OAAO"}

package/dist/index-BKH8sT1-.d.ts

@@ -0,0 +1,39 @@
+//#region src/sdk.d.ts
+type SdkConfig = {
+  serverUrl: string;
+  token: string;
+};
+type RegisterResult = {
+  agentId: string;
+  inboxId: string;
+  status: string;
+  displayName: string | null;
+};
+type PullResult = {
+  entries: InboxEntryWithMessage[];
+};
+declare class AgentHubSDK {
+  private readonly baseUrl;
+  private readonly token;
+  constructor(config: SdkConfig);
+  /** Validate token, return agent identity. */
+  register(): Promise<RegisterResult>;
+  /** Fetch pending inbox entries. */
+  pull(limit?: number): Promise<PullResult>;
+  /** Acknowledge an inbox entry. */
+  ack(entryId: number): Promise<void>;
+  /** Renew lease on an inbox entry. */
+  renew(entryId: number): Promise<void>;
+  private requestVoid;
+  private requestJson;
+  private doFetch;
+  private toSdkError;
+}
+declare class SdkError extends Error {
+  readonly statusCode: number;
+  constructor(statusCode: number, message: string);
+}
+//# sourceMappingURL=sdk.d.ts.map
+//#endregion
+export { AgentHubSDK, type PullResult, type RegisterResult, type SdkConfig, SdkError };
+//# sourceMappingURL=index-BKH8sT1-.d.ts.map

package/dist/index-BKH8sT1-.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BKH8sT1-.d.ts","names":[],"sources":["../src/sdk.ts"],"sourcesContent":[],"mappings":";AAEY,KAAA,SAAA,GAAS;EAKT,SAAA,EAAA,MAAc;EAOd,KAAA,EAAA,MAAU;AAItB,CAAA;AAAwB,KAXZ,cAAA,GAWY;SAIF,EAAA,MAAA;SAOM,EAAA,MAAA;QAAR,EAAA,MAAA;aAWc,EAAA,MAAA,GAAA,IAAA;;AAMJ,KAhClB,UAAA,GAgCkB;SAKE,EApCrB,qBAoCqB,EAAA;CAAO;AA4C1B,cA7EA,WAAA,CA6EsB;;;sBAzEb;;cAOF,QAAQ;;wBAWF,QAAQ;;wBAMJ;;0BAKE;;;;;;cA4CnB,QAAA,SAAiB,KAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+import { n as SdkError, t as AgentHubSDK } from "./sdk-DsYThTRp.js";
+export { AgentHubSDK, SdkError };

package/dist/sdk-DsYThTRp.js

@@ -0,0 +1,70 @@
+//#region src/sdk.ts
+var AgentHubSDK = class {
+	baseUrl;
+	token;
+	constructor(config) {
+		this.baseUrl = config.serverUrl.replace(/\/+$/, "");
+		this.token = config.token;
+	}
+	/** Validate token, return agent identity. */
+	async register() {
+		const agent = await this.requestJson("/api/v1/agent/me");
+		return {
+			agentId: agent.id,
+			inboxId: agent.inboxId,
+			status: agent.status,
+			displayName: agent.displayName
+		};
+	}
+	/** Fetch pending inbox entries. */
+	async pull(limit = 10) {
+		return { entries: await this.requestJson(`/api/v1/agent/inbox?limit=${limit}`) };
+	}
+	/** Acknowledge an inbox entry. */
+	async ack(entryId) {
+		await this.requestVoid(`/api/v1/agent/inbox/${entryId}/ack`, { method: "POST" });
+	}
+	/** Renew lease on an inbox entry. */
+	async renew(entryId) {
+		await this.requestVoid(`/api/v1/agent/inbox/${entryId}/renew`, { method: "POST" });
+	}
+	async requestVoid(path, init) {
+		const response = await this.doFetch(path, init);
+		if (!response.ok) throw await this.toSdkError(response);
+	}
+	async requestJson(path, init) {
+		const response = await this.doFetch(path, init);
+		if (!response.ok) throw await this.toSdkError(response);
+		return await response.json();
+	}
+	async doFetch(path, init) {
+		const url = `${this.baseUrl}${path}`;
+		const headers = { Authorization: `Bearer ${this.token}` };
+		if (init?.body) headers["Content-Type"] = "application/json";
+		return fetch(url, {
+			...init,
+			headers
+		});
+	}
+	async toSdkError(response) {
+		const body = await response.text();
+		let message;
+		try {
+			message = JSON.parse(body).error ?? body;
+		} catch {
+			message = body;
+		}
+		return new SdkError(response.status, message);
+	}
+};
+var SdkError = class extends Error {
+	constructor(statusCode, message) {
+		super(message);
+		this.statusCode = statusCode;
+		this.name = "SdkError";
+	}
+};
+//#endregion
+export { SdkError as n, AgentHubSDK as t };
+
+//# sourceMappingURL=sdk-DsYThTRp.js.map

package/dist/sdk-DsYThTRp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-DsYThTRp.js","names":[],"sources":["../src/sdk.ts"],"sourcesContent":["import type { Agent, InboxEntryWithMessage } from \"@agent-hub/shared\";\n\nexport type SdkConfig = {\n  serverUrl: string;\n  token: string;\n};\n\nexport type RegisterResult = {\n  agentId: string;\n  inboxId: string;\n  status: string;\n  displayName: string | null;\n};\n\nexport type PullResult = {\n  entries: InboxEntryWithMessage[];\n};\n\nexport class AgentHubSDK {\n  private readonly baseUrl: string;\n  private readonly token: string;\n\n  constructor(config: SdkConfig) {\n    // Strip trailing slash\n    this.baseUrl = config.serverUrl.replace(/\\/+$/, \"\");\n    this.token = config.token;\n  }\n\n  /** Validate token, return agent identity. */\n  async register(): Promise<RegisterResult> {\n    const agent = await this.requestJson<Agent>(\"/api/v1/agent/me\");\n    return {\n      agentId: agent.id,\n      inboxId: agent.inboxId,\n      status: agent.status,\n      displayName: agent.displayName,\n    };\n  }\n\n  /** Fetch pending inbox entries. */\n  async pull(limit = 10): Promise<PullResult> {\n    const entries = await this.requestJson<InboxEntryWithMessage[]>(`/api/v1/agent/inbox?limit=${limit}`);\n    return { entries };\n  }\n\n  /** Acknowledge an inbox entry. */\n  async ack(entryId: number): Promise<void> {\n    await this.requestVoid(`/api/v1/agent/inbox/${entryId}/ack`, { method: \"POST\" });\n  }\n\n  /** Renew lease on an inbox entry. */\n  async renew(entryId: number): Promise<void> {\n    await this.requestVoid(`/api/v1/agent/inbox/${entryId}/renew`, { method: \"POST\" });\n  }\n\n  private async requestVoid(path: string, init?: RequestInit): Promise<void> {\n    const response = await this.doFetch(path, init);\n    if (!response.ok) {\n      throw await this.toSdkError(response);\n    }\n  }\n\n  private async requestJson<T>(path: string, init?: RequestInit): Promise<T> {\n    const response = await this.doFetch(path, init);\n    if (!response.ok) {\n      throw await this.toSdkError(response);\n    }\n    return (await response.json()) as T;\n  }\n\n  private async doFetch(path: string, init?: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${this.token}`,\n    };\n    // Only set Content-Type for requests with a body — Fastify rejects empty JSON bodies\n    if (init?.body) {\n      headers[\"Content-Type\"] = \"application/json\";\n    }\n    return fetch(url, { ...init, headers });\n  }\n\n  private async toSdkError(response: Response): Promise<SdkError> {\n    const body = await response.text();\n    let message: string;\n    try {\n      const json = JSON.parse(body) as { error?: string };\n      message = json.error ?? body;\n    } catch {\n      message = body;\n    }\n    return new SdkError(response.status, message);\n  }\n}\n\nexport class SdkError extends Error {\n  constructor(\n    public readonly statusCode: number,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"SdkError\";\n  }\n}\n"],"mappings":";AAkBA,IAAa,cAAb,MAAyB;CACvB;CACA;CAEA,YAAY,QAAmB;AAE7B,OAAK,UAAU,OAAO,UAAU,QAAQ,QAAQ,GAAG;AACnD,OAAK,QAAQ,OAAO;;;CAItB,MAAM,WAAoC;EACxC,MAAM,QAAQ,MAAM,KAAK,YAAmB,mBAAmB;AAC/D,SAAO;GACL,SAAS,MAAM;GACf,SAAS,MAAM;GACf,QAAQ,MAAM;GACd,aAAa,MAAM;GACpB;;;CAIH,MAAM,KAAK,QAAQ,IAAyB;AAE1C,SAAO,EAAE,SADO,MAAM,KAAK,YAAqC,6BAA6B,QAAQ,EACnF;;;CAIpB,MAAM,IAAI,SAAgC;AACxC,QAAM,KAAK,YAAY,uBAAuB,QAAQ,OAAO,EAAE,QAAQ,QAAQ,CAAC;;;CAIlF,MAAM,MAAM,SAAgC;AAC1C,QAAM,KAAK,YAAY,uBAAuB,QAAQ,SAAS,EAAE,QAAQ,QAAQ,CAAC;;CAGpF,MAAc,YAAY,MAAc,MAAmC;EACzE,MAAM,WAAW,MAAM,KAAK,QAAQ,MAAM,KAAK;AAC/C,MAAI,CAAC,SAAS,GACZ,OAAM,MAAM,KAAK,WAAW,SAAS;;CAIzC,MAAc,YAAe,MAAc,MAAgC;EACzE,MAAM,WAAW,MAAM,KAAK,QAAQ,MAAM,KAAK;AAC/C,MAAI,CAAC,SAAS,GACZ,OAAM,MAAM,KAAK,WAAW,SAAS;AAEvC,SAAQ,MAAM,SAAS,MAAM;;CAG/B,MAAc,QAAQ,MAAc,MAAuC;EACzE,MAAM,MAAM,GAAG,KAAK,UAAU;EAC9B,MAAM,UAAkC,EACtC,eAAe,UAAU,KAAK,SAC/B;AAED,MAAI,MAAM,KACR,SAAQ,kBAAkB;AAE5B,SAAO,MAAM,KAAK;GAAE,GAAG;GAAM;GAAS,CAAC;;CAGzC,MAAc,WAAW,UAAuC;EAC9D,MAAM,OAAO,MAAM,SAAS,MAAM;EAClC,IAAI;AACJ,MAAI;AAEF,aADa,KAAK,MAAM,KAAK,CACd,SAAS;UAClB;AACN,aAAU;;AAEZ,SAAO,IAAI,SAAS,SAAS,QAAQ,QAAQ;;;AAIjD,IAAa,WAAb,cAA8B,MAAM;CAClC,YACE,YACA,SACA;AACA,QAAM,QAAQ;AAHE,OAAA,aAAA;AAIhB,OAAK,OAAO"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@unispark.ai/agent-hub",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Agent Hub CLI and SDK — agent-facing client for Agent Hub server",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "agent-hub": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.16.0",
+    "tsdown": "^0.12.0",
+    "vitest": "^3.2.0",
+    "@agent-hub/shared": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts src/cli/index.ts --format esm --dts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}