a2a-exposed 0.8.20 → 0.8.21

package/lib/deploy.mjs

@@ -11,6 +11,14 @@ import { readHidden } from "./pair.mjs";
 import * as WD from "./workersdev.mjs";
 import { printStar } from "./feedback.mjs";
 
+export const VERSION = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+
+/** Arguments shared by deploy attempts, including workers.dev registration retries. */
+export function deployArgs(version, isoDate) {
+	if (!/^[A-Za-z0-9._-]+$/.test(version)) throw new Error("invalid Worker version tag");
+	return ["deploy", "--message", `a2a-exposed ${version} ${isoDate}`, "--tag", `a2a-exposed-${version}`];
+}
+
 const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 /** Each Claude Code routine fire is a new cloud session: a 2xx only means a session started. */
 export const CLAUDE_CODE_NOTE = [
@@ -392,7 +400,7 @@ function runTee(cmd, args, { cwd, env }) {
 /** cf deploy (secrets via a temporary chmod-600 file). If the account has no workers.dev subdomain yet and
  *  `register` names one, retry through cf's own registration prompt. Returns cf's output. */
 async function cfDeploy(dir, secrets, { register } = {}) {
-	const base = ["deploy", "--message", `a2a-exposed ${new Date().toISOString()}`];
+	const base = deployArgs(VERSION, new Date().toISOString());
 	const go = async (file) => {
 		const args = cfArgs(file ? [...base, "--secrets-file", file] : base);
 		let r = await runTee(cfBin(dir), args, { cwd: dir, env: deployEnv() });

package/lib/main.mjs

@@ -88,7 +88,7 @@ https://github.com/telegraphic-dev/a2a-exposed/blob/main/docs/getting-started.md
                                                e.g. "node /path/to/repo/cli/bin/a2a-exposed.mjs")
                                 --worker-dir   where the Worker project (template copy) lives (default
                                                <config dir>/worker). The config dir is --config-dir / A2A_CONFIG_DIR
-  deploy [same flags]           redeploy with saved settings (secrets persist)
+  deploy [same flags]           redeploy with saved settings (secrets persist); tag the Worker version as a2a-exposed-<version>
   wake set [--preset P] [--agent-id A] [--key-header H] [--key-prefix X] [--body-template JSON]
            [--cli-command CMD] [--debounce S] [--max-per-hour N]
                                 save wake settings, upload wake secrets from env, and redeploy (one step)
@@ -145,11 +145,12 @@ Remove
                                 --dir and --worker-dir are the Worker project directory (default <config dir>/worker)
 
 Status
-  status [--json]               deployment, base URL, agent card check (fetched by the CLI: no curl needed), wake
+  status [--json]               deployment, Worker version, base URL, agent card check (fetched by the CLI), wake
                                 mode (webhook / tunnel / none = polling), tunnel state, proxy mode (--upstream):
                                 upstream card, Access credential and upstream bearer configured (separately), the
                                 live upstream check, the last failed peer call, card-leak check; warnings for peer
                                 token variables shadowing saved tokens; and the next step to run.
+                                Older Workers need deploy (exit 1); npm latest hints use the local update cache.
                                 When GET /owner/mcp reports enabled and the agent card is reachable, prints
                                 \`claude mcp add --transport http a2a-exposed <base URL>/mcp\`.
                                 A failed probe, an unreachable card, or a Worker that reports MCP off leaves that line out.

package/lib/status.mjs

@@ -8,6 +8,17 @@ import { CLI, cardUrlProblem, cfErrorCode, describeHttp, die, fingerprint, httpJ
 import { baseUrl, owner, ownerTry } from "./commands.mjs";
 import * as D from "./deploy.mjs";
 import * as T from "./tunnel.mjs";
+import { cacheFile, readCache, newer } from "./update.mjs";
+
+/** Public health probe. Only a valid health answer establishes missing version reporting. */
+export async function checkHealth(base) {
+	try {
+		const { status, data } = await httpJson(`${base}/health`, { timeout: 15000 });
+		if (status === 200 && data?.ok === true)
+			return { ok: true, version: typeof data.version === "string" && data.version ? data.version : null };
+	} catch { /* unreachable: version stays unknown */ }
+	return { ok: false, version: null };
+}
 
 /** Presets whose webhook usually listens only locally: wakes need the tunnel (or another reverse proxy). */
 export const LOCAL_PRESETS = ["openclaw-wake", "openclaw-agent", "hermes"];
@@ -111,6 +122,9 @@ export function secretsPropagating(tunnel, now = Date.now()) {
  *  as separate lines (so the next step stays one short instruction). */
 export function nextStep(s) {
 	const n = nextStepCore(s);
+	const version = s.cliVersion || D.VERSION;
+	if (s.workerVersion && s.latestVersion && newer(s.latestVersion, s.workerVersion) && !newer(s.workerVersion, version))
+		n.also.push(`a2a-exposed ${s.latestVersion} is available: run npx -y a2a-exposed@latest deploy`);
 	const sh = (s.peerTokenShadowed || []).map((k) => `${k} is set in the environment and overrides the different peer token saved in ${s.configFile} (e.g. a stale value from before \`connect\` stored a new one): send/poll use the environment value. Unset ${k} where it is set to use the saved token`);
 	return sh.length ? { ...n, also: [...n.also, ...sh] } : n;
 }
@@ -133,6 +147,11 @@ function nextStepCore(s) {
 		return fail(/HTTP 401/.test(s.ownerApi.error)
 			? `the owner token in ${s.configFile} does not match the Worker: run \`${CLI} init --rotate-owner-token\` from the machine that owns this deployment`
 			: `the owner API failed (${s.ownerApi.error}): run \`${CLI} deploy\``);
+	const version = s.cliVersion || D.VERSION;
+	if (s.workerVersion && newer(version, s.workerVersion))
+		return fail(`the deployed Worker is ${s.workerVersion}, older than this CLI (${version}): run \`${CLI} deploy\``);
+	if (s.health?.ok && s.health.version === null)
+		return fail(`the deployed Worker predates version reporting (older than ${version}): run \`${CLI} deploy\``);
 	// proxy / expose mode: the upstream answers peers, so wakes are optional (pairing notifications only)
 	const fc = s.facade;
 	if (fc) {
@@ -220,12 +239,14 @@ export async function collect() {
 		upstream: C.get("A2A_UPSTREAM_URL") || null, facade: null, upstreamVerify: null, upstreamVerifyError: "", facadePeerAuth: null,
 		upstreamNoToken: C.get("A2A_UPSTREAM_NO_TOKEN") === "1", localUpstreamToken: fingerprint(process.env.UPSTREAM_TOKEN),
 		peerTokenShadowed: shadowedPeerTokens(),
-		mcp: "unknown",
+		mcp: "unknown", health: null, workerVersion: null, cliVersion: D.VERSION, latestVersion: readCache(cacheFile())?.latest || null,
 	};
 	const envBase = (process.env.A2A_BASE_URL || "").replace(/\/$/, "");
 	if (envBase && envBase !== s.baseUrlSaved) s.baseUrlEnv = envBase;
 	if (!s.deployed || !s.baseUrl) return s;
 	s.card = await checkCard(s.baseUrl);
+	s.health = await checkHealth(s.baseUrl);
+	s.workerVersion = s.health.version;
 	if (s.hasOwnerToken) {
 		try {
 			const p = await owner("GET", "/owner/wake/preview");
@@ -335,6 +356,7 @@ export async function status(o) {
 		if (s.deployed && s.baseUrl) {
 			rows.push(["agent card", !s.card.ok ? `FAILED: ${s.card.error}` : s.card.urlProblem ? `WRONG URL: "${s.card.name}", but ${s.card.urlProblem}`
 				: `OK: "${s.card.name}" (A2A ${s.card.versions.join(", ") || "?"})`]);
+			rows.push(["worker version", `${s.workerVersion || "unknown"} (CLI ${s.cliVersion})`]);
 			rows.push(["owner API", s.ownerApi.ok ? "OK" : `FAILED: ${s.ownerApi.error}`]);
 			if (s.upstream) {
 				const f = s.facade || {};

package/lib/update.mjs

@@ -36,7 +36,7 @@ export function notice(current, cache) {
 
 export const due = (cache, now = Date.now()) => !cache || !(now - (cache.checkedAt || 0) < CHECK_INTERVAL_MS);
 
-function readCache(file) {
+export function readCache(file) {
 	try { return JSON.parse(fs.readFileSync(file, "utf8")); } catch { return null; }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "a2a-exposed",
-	"version": "0.8.20",
+	"version": "0.8.21",
 	"description": "Give any AI agent a public A2A (Agent2Agent) endpoint: a Cloudflare Worker, a wake webhook, or scheduled checks",
 	"type": "module",
 	"bin": {

package/worker/src/index.ts

@@ -4,6 +4,7 @@
 // Worker serves a rewritten agent card and device-flow pairing, and forwards authenticated JSON-RPC to the upstream.
 // Handlers take a TenantContext (tenancy.ts) built from the Worker bindings. With the hosted gates unset, that
 // context is the single self-host tenant and behaviour matches a Worker that read env.* directly.
+import { VERSION } from "./version.ts";
 import * as A from "./a2a.ts";
 import * as F from "./facade.ts";
 import { renderWake, redact, cloudflareErrorHint, wakeUrlIsTunnelHost, defaultDebounceSeconds, defaultMaxPerHour, type WakeConfig, type WakeEvent } from "./wake.ts";
@@ -3404,7 +3405,7 @@ async function handle(req: Request, ctx: TenantContext, ectx: ExecutionContext,
 		// legacy discovery path (A2A 0.2): the 0.3-shaped card that clients of that era parse
 		if (req.method === "GET" && path === "/.well-known/agent.json")
 			return json(agentCard03(ctx, await agentCard(ctx)), 200, { "access-control-allow-origin": "*", "cache-control": cardCacheControl(ctx) });
-		if (req.method === "GET" && path === "/health") return json({ ok: true, publicUrl: ctx.PUBLIC_URL, mode: proxyMode(ctx) ? "proxy" : "inbox", mcp: mcpOn(ctx) });
+		if (req.method === "GET" && path === "/health") return json({ ok: true, version: VERSION, publicUrl: ctx.PUBLIC_URL, mode: proxyMode(ctx) ? "proxy" : "inbox", mcp: mcpOn(ctx) });
 		if (path === "/mcp") return mcpOn(ctx) ? await handleMcp(req, ctx, ectx, url) : json({ error: "not_found", error_description: "the MCP server is turned off on this A2A endpoint (MCP=off)" }, 404);
 		if (mcpOn(ctx)) {
 			if (req.method === "GET" && path === "/.well-known/oauth-protected-resource/mcp") return json(mcpResourceMetadata(ctx), 200, { "access-control-allow-origin": "*" });

package/worker/src/version.ts

@@ -1,2 +1,2 @@
 /** Inbox build. Keep this equal to `version` in cli/package.json. */
-export const VERSION = "0.8.20";
+export const VERSION = "0.8.21";

package/worker/test/hosted.test.ts

@@ -7,6 +7,7 @@ import path from "node:path";
 import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import { Miniflare, convertV4MiniflareOptions } from "miniflare";
+import { VERSION } from "../src/version.ts";
 import worker from "../src/index.ts";
 import { sha256 } from "../src/a2a.ts";
 import { sealWakeSecrets } from "../src/wake-secrets.ts";
@@ -81,6 +82,7 @@ test("gates unset: the hosted entry matches the self-host handler, including TEN
 	const base = "https://agent.example.com";
 	const nodeEnv = { DB: d1(MIGRATIONS), PUBLIC_URL: base, OWNER_TOKEN: "owner-secret" };
 	const nodeHealth = await text(await worker.fetch(new Request(base + "/health"), nodeEnv as never, ectx as never));
+	assert.deepEqual(JSON.parse(nodeHealth), { ok: true, version: VERSION, publicUrl: base, mode: "inbox", mcp: true });
 	const nodeDenied = await text(await worker.fetch(new Request(base + "/", {
 		method: "POST", headers: { "content-type": "application/json" },
 		body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "message/send", params: {} }),
@@ -180,6 +182,9 @@ test("per-tenant SQLite: directory, config push, and isolation", async (t) => {
 	assert.equal(bobPush.result.applied, true, JSON.stringify(bobPush.result));
 	await kv.put("tenant:bobby", JSON.stringify({ id: "id-bobby", status: "active", region: "", version: 1 }));
 
+	assert.deepEqual(await (await mf.dispatchFetch("https://alice.example.com/health")).json(),
+		{ ok: true, version: VERSION, publicUrl: "https://alice.example.com", mode: "inbox", mcp: true });
+
 	const card = async (name: string, headers?: HeadersInit) => (await mf.dispatchFetch(`https://${name}.example.com/.well-known/agent-card.json`, { headers })).json() as Promise<{ name: string }>;
 	const aliceCard = await mf.dispatchFetch("https://alice.example.com/.well-known/agent-card.json");
 	assert.equal(aliceCard.headers.get("cache-control"), "public, max-age=60");

package/worker/test/tenancy.test.ts

@@ -1,5 +1,6 @@
 // Tenant context: gates default off, self-host owner auth and peer-token key stay compatible, hosted uses a hash
 // and TENANT_SECRETS_KEY. Run: npm test
+import { VERSION } from "../src/version.ts";
 import { test } from "node:test";
 import assert from "node:assert/strict";
 import worker from "../src/index.ts";
@@ -258,7 +259,7 @@ test("fetch path: gates set or unset, the self-host Worker still answers from OW
 	const plain = await call(base, "/health");
 	const reserved = await call({ ...base, ...gates }, "/health");
 	const empty = await call({ ...base, TENANCY: "", QUOTAS: "", DATA_REGION: "", SIGNUP_URL: "" }, "/health");
-	assert.deepEqual(plain.data, { ok: true, publicUrl: BASE, mode: "inbox", mcp: true });
+	assert.deepEqual(plain.data, { ok: true, version: VERSION, publicUrl: BASE, mode: "inbox", mcp: true });
 	assert.deepEqual(reserved.data, plain.data);
 	assert.deepEqual(empty.data, plain.data);