@ryubyte/dsh-a2a 0.1.4 → 0.2.0

package/lib/index.js

@@ -1,6 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir, networkInterfaces } from "node:os";
 import { dirname, join } from "node:path";
-import { homedir } from "node:os";
 //#region src/protocol.ts
 /**
 * A2A (Agent2Agent) Protocol v1.0 — TypeScript type definitions.
@@ -575,6 +575,7 @@ var A2AServer = class {
 	options;
 	store;
 	card;
+	/** JSON-RPC route path. Mutable: `updateCard` can move it at runtime. */
 	endpointPath;
 	execute;
 	listeners = /* @__PURE__ */ new Set();
@@ -595,6 +596,14 @@ var A2AServer = class {
 	*/
 	setBaseUrl(baseUrl) {
 		this.baseUrl = baseUrl.replace(/\/$/, "");
+		this.rebuildInterfaceUrls();
+	}
+	/** The base URL currently advertised in the AgentCard. */
+	getBaseUrl() {
+		return this.baseUrl;
+	}
+	/** Rebuild the advertised interface URL(s) from the current baseUrl + path. */
+	rebuildInterfaceUrls() {
 		this.card.supportedInterfaces = this.card.supportedInterfaces.map((iface) => ({
 			...iface,
 			url: `${this.baseUrl}${this.endpointPath}`
@@ -619,6 +628,43 @@ var A2AServer = class {
 	get authConfigured() {
 		return Boolean(this.options.authToken);
 	}
+	/**
+	* Update the advertised identity (name/description/version/baseUrl/
+	* endpointPath/skills) at runtime, in place. Mirrors setBaseUrl/setAuthToken:
+	* mutates `this.options` and the existing `this.card` object's properties —
+	* never reassigns `this.card`, so the route handler closure that reads
+	* `server.card` per request keeps seeing the live card.
+	*
+	* Returns `{ endpointChanged }`: when the JSON-RPC path moved, the caller
+	* (which owns route registration) must re-register routes on the new path —
+	* `updateCard` only mutates the advertised URL, not the live HTTP routes.
+	*/
+	updateCard(patch) {
+		let endpointChanged = false;
+		if (patch.agentName !== void 0) {
+			this.options.agentName = patch.agentName;
+			this.card.name = patch.agentName;
+		}
+		if (patch.agentDescription !== void 0) {
+			this.options.agentDescription = patch.agentDescription;
+			this.card.description = patch.agentDescription;
+		}
+		if (patch.agentVersion !== void 0) {
+			this.options.agentVersion = patch.agentVersion;
+			this.card.version = patch.agentVersion;
+		}
+		if (patch.skills !== void 0) {
+			this.options.skills = patch.skills;
+			this.card.skills = patch.skills;
+		}
+		if (patch.endpointPath !== void 0 && patch.endpointPath !== this.endpointPath) {
+			this.endpointPath = patch.endpointPath || "/a2a";
+			endpointChanged = true;
+		}
+		if (patch.baseUrl !== void 0) this.baseUrl = patch.baseUrl.replace(/\/$/, "");
+		if (patch.baseUrl !== void 0 || endpointChanged) this.rebuildInterfaceUrls();
+		return { endpointChanged };
+	}
 	buildCard() {
 		const iface = {
 			url: `${this.baseUrl.replace(/\/$/, "")}${this.endpointPath}`,
@@ -1398,6 +1444,29 @@ var DashboardRegistry = class {
 				ok: false,
 				message: "server-status is not wired (server mode not mounted)"
 			};
+			case "set-server-identity":
+				if (!this.hooks.setServerIdentity) return {
+					ok: false,
+					message: "set-server-identity is not wired (server not mounted)"
+				};
+				return this.hooks.setServerIdentity({
+					agentName: payload?.agentName,
+					agentDescription: payload?.agentDescription,
+					agentVersion: payload?.agentVersion,
+					baseUrl: payload?.baseUrl,
+					endpointPath: payload?.endpointPath,
+					skills: payload?.skills
+				});
+			case "update-agent":
+				if (!this.hooks.updateAgent) return {
+					ok: false,
+					message: "update-agent is not wired (client mode not mounted)"
+				};
+				return this.hooks.updateAgent(target, {
+					timeoutMs: typeof payload?.timeoutMs === "number" ? payload.timeoutMs : void 0,
+					mapSkills: typeof payload?.mapSkills === "boolean" ? payload.mapSkills : void 0,
+					bearerToken: payload?.bearerToken || void 0
+				});
 			default: return {
 				ok: false,
 				message: `unknown action ${action}`
@@ -1479,6 +1548,30 @@ function profileNameFromArgv() {
 	}
 }
 /**
+* Best-effort profile-name fallback for launchers that resolve a profile
+* WITHOUT writing `--profile` back into argv.
+*
+* The dsh `web` subcommand is a hardcoded alias for `--profile web`: the
+* launcher resolves the name internally and boots the web profile, but the
+* process argv keeps the original tokens (`node …/dsh web [flags]`) — there
+* is no `--profile` flag and no environment variable naming the profile. So
+* when {@link profileNameFromArgv} finds nothing, check whether the first
+* non-flag token after argv[0] is a known dsh subcommand alias:
+*
+*   - `web`            → boot profile `web` (alias, never followed by a name)
+*   - `--profile <n>`  → already handled above
+*   - anything else    → unknown/not a profile alias (e.g. `plugin`, which
+*                        is a management mode, not a boot; returns undefined)
+*
+* Returns undefined when argv carries no recognizable alias, letting the
+* caller fall through to the cwd-based resolution steps.
+*/
+function profileNameFromDshAlias() {
+	const argv = process.argv ?? [];
+	if (argv.includes("--profile") || argv.some((a) => a.startsWith("--profile="))) return void 0;
+	if (argv[2] === "web") return "web";
+}
+/**
 * Resolve the a2a.json path for the current process, without depending on
 * the launch directory. The plugin must work no matter where `dsh` was
 * started from (dsh does NOT chdir into the profile directory), so this
@@ -1488,7 +1581,9 @@ function profileNameFromArgv() {
 *
 * Order:
 *   0. `$DSH_HOME/profiles/<argv --profile>/a2a.json` — the active profile
-*      as named on the command line (most authoritative; works from ANY cwd)
+*      as named on the command line (most authoritative; works from ANY cwd).
+*      Also matches the `dsh web` alias, which boots profile `web` without
+*      writing `--profile` into argv.
 *   1. `cwd/a2a.json` — explicit when launched inside a profile dir
 *   2. outward from cwd: the nearest ancestor holding `a2a.json` — covers
 *      launching from e.g. a repo checkout whose parent chain includes the
@@ -1506,7 +1601,7 @@ function resolveConfigPath() {
 	const cwd = process.cwd();
 	const home = process.env.DSH_HOME ?? join(homedir(), ".dsh");
 	const base = cwd.split(/[\\/]/).pop() ?? "";
-	const profileName = profileNameFromArgv();
+	const profileName = profileNameFromArgv() ?? profileNameFromDshAlias();
 	if (profileName && profileName !== "." && profileName !== ".." && !profileName.includes("/") && !profileName.includes("\\")) {
 		const argvFile = join(home, "profiles", profileName, A2A_CONFIG_FILENAME);
 		if (existsSync(argvFile)) return argvFile;
@@ -1525,6 +1620,7 @@ function resolveConfigPath() {
 	if (base && existsSync(profileFile)) return profileFile;
 	const globalFile = join(home, A2A_CONFIG_FILENAME);
 	if (existsSync(globalFile)) return globalFile;
+	if (profileName && profileName !== "." && profileName !== ".." && !profileName.includes("/") && !profileName.includes("\\")) return join(home, "profiles", profileName, A2A_CONFIG_FILENAME);
 	return cwdFile;
 }
 /** Read the persisted config (empty object when absent or unreadable). */
@@ -1976,6 +2072,53 @@ function apply(ctx, config = {}) {
 						ok: true,
 						message: `agent ${connectionId} removed`
 					};
+				},
+				updateAgent: async (connectionId, patch) => {
+					const entry = live.get(connectionId);
+					const snap = dashboard.snapshot().outbound.find((o) => o.connectionId === connectionId);
+					const name = entry?.name ?? snap?.name;
+					const url = entry?.agentCardUrl ?? snap?.agentCardUrl;
+					entry?.configured ?? snap?.configured;
+					if (!name || !url) return {
+						ok: false,
+						message: `connection ${connectionId} not found`
+					};
+					const found = findInitial({
+						name,
+						agentCardUrl: url
+					});
+					if (!found) return {
+						ok: false,
+						message: "only saved (configured) agents can be edited"
+					};
+					if (patch.timeoutMs !== void 0) found.item.timeoutMs = patch.timeoutMs;
+					if (patch.mapSkills !== void 0) found.item.mapSkills = patch.mapSkills;
+					if (patch.bearerToken !== void 0) found.item.bearerToken = patch.bearerToken || void 0;
+					persistAgents();
+					const item = found.item;
+					if (item.enabled === false) return {
+						ok: true,
+						message: `agent ${connectionId} updated (config kept, still disabled)`
+					};
+					if (entry) {
+						entry.disposeAll();
+						live.delete(connectionId);
+					}
+					dashboard.setAgentState(connectionId, "reconnecting");
+					const newId = await connect(item.name, item.agentCardUrl, item.configured, {
+						bearerToken: item.bearerToken,
+						timeoutMs: item.timeoutMs,
+						mapSkills: item.mapSkills
+					});
+					if (!newId) return {
+						ok: false,
+						message: `update of ${connectionId} failed to reconnect`
+					};
+					dashboard.removeAgent(connectionId);
+					return {
+						ok: true,
+						message: `agent ${connectionId} updated as ${newId} (saved to ${configPath})`
+					};
 				}
 			});
 			ctx.effect(() => {
@@ -2008,15 +2151,19 @@ function apply(ctx, config = {}) {
 			}, "a2a: client tools");
 		});
 	}
-	if (wantsServer) {
+	{
 		const store = new TaskStore();
 		const taskPeer = /* @__PURE__ */ new Map();
 		const pendingSettled = /* @__PURE__ */ new Set();
 		ctx.inject(["webServer"], (ctx) => {
 			ctx.effect(() => {
 				const webServer = ctx.webServer;
-				const baseUrl = mergedConfig.baseUrl ?? `http://${webServer.host === "0.0.0.0" ? "127.0.0.1" : webServer.host}:${webServer.port}`;
+				const baseUrl = mergedConfig.baseUrl ?? inferBaseUrl(webServer.host, webServer.port);
 				const endpointPath = mergedConfig.endpointPath ?? DEFAULT_ENDPOINT;
+				if (mergedConfig.baseUrl) try {
+					const pinnedPort = new URL(mergedConfig.baseUrl).port;
+					if (pinnedPort && Number(pinnedPort) !== webServer.port) logger?.warn?.(`[a2a] pinned baseUrl ${mergedConfig.baseUrl} port ${pinnedPort} != listen port ${webServer.port}; remote callers may be unreachable. Clear baseUrl in settings to auto-infer.`);
+				} catch {}
 				let execute = mergedConfig.execute;
 				let executorKind = execute ? "custom" : "none";
 				let disposeExecutor;
@@ -2073,7 +2220,7 @@ function apply(ctx, config = {}) {
 						} else pendingSettled.add(taskId);
 					}
 				}, store);
-				let enabled = true;
+				let enabled = wantsServer;
 				let disposers = [];
 				const registerRoutes = () => {
 					disposers.push(webServer.register({
@@ -2126,19 +2273,23 @@ function apply(ctx, config = {}) {
 					for (const d of disposers) d();
 					disposers = [];
 				};
-				registerRoutes();
-				logger?.info?.(`[a2a] A2A server mounted: AgentCard at ${baseUrl}/.well-known/agent-card.json, JSON-RPC at ${server.endpointPath}`);
+				if (enabled) {
+					registerRoutes();
+					logger?.info?.(`[a2a] A2A server mounted: AgentCard at ${baseUrl}/.well-known/agent-card.json, JSON-RPC at ${server.endpointPath}`);
+				} else logger?.info?.("[a2a] A2A server ready but not serving (enable via settings)");
 				const serverCard = () => ({
-					baseUrl,
+					baseUrl: server.getBaseUrl(),
 					agentName: server.card.name,
 					agentDescription: server.card.description,
 					agentVersion: server.card.version,
-					endpoint: `${baseUrl}${server.endpointPath}`,
-					agentCardUrl: `${baseUrl}/.well-known/agent-card.json`,
+					endpointPath: server.endpointPath,
+					endpoint: `${server.getBaseUrl()}${server.endpointPath}`,
+					agentCardUrl: `${server.getBaseUrl()}/.well-known/agent-card.json`,
 					skills: (server.card.skills ?? []).map((s) => ({
 						id: s.id,
 						name: s.name,
-						description: s.description
+						description: s.description,
+						tags: s.tags
 					})),
 					customExecutor: Boolean(mergedConfig.execute),
 					executor: executorKind,
@@ -2154,17 +2305,63 @@ function apply(ctx, config = {}) {
 							registerRoutes();
 							enabled = true;
 							logger?.info?.("[a2a] A2A server enabled");
+						} else {
+							unregisterRoutes();
+							enabled = false;
+							logger?.info?.("[a2a] A2A server disabled");
+						}
+						const next = loadConfig();
+						next.server = {
+							...next.server ?? {},
+							enabled
+						};
+						const res = saveConfig(next);
+						if (!res.ok) {
+							logger?.error?.(`[a2a] failed to persist server.enabled to ${res.path}: ${res.message}`);
+							return {
+								ok: false,
+								message: `applied in-memory but failed to save: ${res.message}`
+							};
+						}
+						return {
+							ok: true,
+							message: enable ? "A2A server enabled" : "A2A server disabled"
+						};
+					},
+					setServerIdentity: async (patch) => {
+						const clearBaseUrl = patch.baseUrl === "";
+						const cardPatch = clearBaseUrl ? {
+							...patch,
+							baseUrl: void 0
+						} : patch;
+						const { endpointChanged } = server.updateCard(cardPatch);
+						if (clearBaseUrl) server.setBaseUrl(inferBaseUrl(webServer.host, webServer.port));
+						if (endpointChanged && enabled) {
+							unregisterRoutes();
+							registerRoutes();
+						}
+						const next = loadConfig();
+						const s = { ...next.server ?? {} };
+						if (patch.agentName !== void 0) s.agentName = patch.agentName;
+						if (patch.agentDescription !== void 0) s.agentDescription = patch.agentDescription;
+						if (patch.agentVersion !== void 0) s.agentVersion = patch.agentVersion;
+						if (clearBaseUrl) delete s.baseUrl;
+						else if (patch.baseUrl !== void 0) s.baseUrl = patch.baseUrl;
+						if (patch.endpointPath !== void 0) s.endpointPath = patch.endpointPath;
+						if (patch.skills !== void 0) s.skills = patch.skills;
+						next.server = s;
+						const res = saveConfig(next);
+						if (!res.ok) {
+							logger?.error?.(`[a2a] failed to persist server identity to ${res.path}: ${res.message}`);
 							return {
-								ok: true,
-								message: "A2A server enabled"
+								ok: false,
+								message: `applied in-memory but failed to save: ${res.message}`
 							};
 						}
-						unregisterRoutes();
-						enabled = false;
-						logger?.info?.("[a2a] A2A server disabled");
+						logger?.info?.(`[a2a] server identity updated (saved to ${res.path})`);
 						return {
 							ok: true,
-							message: "A2A server disabled"
+							message: `已更新对外服务 (saved to ${res.path})`
 						};
 					},
 					setServerAuthToken: async (token) => {
@@ -2281,6 +2478,57 @@ function inboundSessionCwd(configPath) {
 		return process.cwd();
 	}
 }
+/**
+* Derive the public base URL advertised in the AgentCard from the real wire
+* listen address, when the operator did not pin `baseUrl` in config.
+*
+* The A2A AgentCard must carry a URL a REMOTE caller can reach. When the web
+* server binds only loopback (`127.0.0.1`), that address is correct. But when
+* it binds every interface (`0.0.0.0`), advertising `127.0.0.1` is wrong for
+* every non-local caller — it points at the caller's own loopback. In that
+* case pick the machine's best-known LAN address (the primary non-loopback
+* IPv4 of the interface that routes to the default gateway), and only fall
+* back to loopback when no such address exists. IPv6 link-local is skipped
+* (not reachable without a scope id).
+*
+* @param host - the web server's configured bind host ('127.0.0.1' | '0.0.0.0').
+* @param port - the OS-assigned (or configured) listen port.
+* @returns a scheme+host+port URL for Agents to call back into this DSH.
+*/
+function inferBaseUrl(host, port) {
+	return `http://${host === "0.0.0.0" ? primaryLanAddress() ?? "127.0.0.1" : host || "127.0.0.1"}:${port}`;
+}
+/**
+* Best single LAN IPv4 for this machine: the address of the non-loopback
+* interface whose route reaches the default gateway (the address a remote
+* peer on the same subnet would use to reach us). Returns undefined when the
+* machine has no non-loopback IPv4 (e.g. offline / containers).
+*
+* Prefers IPv4 (A2A URLs here are v4-style), skips link-local (169.254.0.0/16)
+* and CGNAT (100.64.0.0/10) ranges, which are useless to advertise.
+*/
+function primaryLanAddress() {
+	try {
+		const ifaces = networkInterfaces();
+		let candidate;
+		for (const name of Object.keys(ifaces)) {
+			const addrs = ifaces[name] ?? [];
+			for (const a of addrs) {
+				if (a.family !== "IPv4" || a.internal) continue;
+				const ip = a.address;
+				if (ip.startsWith("169.254.")) continue;
+				const first = Number(ip.split(".")[0]);
+				const second = Number(ip.split(".")[1]);
+				if (first === 100 && second >= 64 && second <= 127) continue;
+				if (!candidate) candidate = ip;
+				if (name === "en0" || name === "eth0" || name === "ens3" || name === "ens5") return ip;
+			}
+		}
+		return candidate;
+	} catch {
+		return;
+	}
+}
 /** Drain the request body from a Node IncomingMessage. */
 async function readBody(req) {
 	return new Promise((resolve, reject) => {
@@ -2321,4 +2569,4 @@ function toServerReq(req) {
 	};
 }
 //#endregion
-export { A2AClient, A2AError, A2AServer, A2A_ERROR_CODES, A2A_METHODS, DashboardRegistry, Role, TaskState, TaskStore, apply, createDshAgentExecutor, defaultExecutor, defaultSkills, fetchAgentCard, getSharedRegistry, inject, isTerminal, name, notConfiguredExecutor, registerAgentTools, shellExecutor };
+export { A2AClient, A2AError, A2AServer, A2A_ERROR_CODES, A2A_METHODS, DashboardRegistry, Role, TaskState, TaskStore, apply, createDshAgentExecutor, defaultExecutor, defaultSkills, fetchAgentCard, getSharedRegistry, inferBaseUrl, inject, isTerminal, name, notConfiguredExecutor, registerAgentTools, shellExecutor };

package/lib/types/a2a-config.d.ts

@@ -68,6 +68,26 @@ export interface PersistedA2AConfig {
  * guessing from cwd's basename.
  */
 export declare function profileNameFromArgv(): string | undefined;
+/**
+ * Best-effort profile-name fallback for launchers that resolve a profile
+ * WITHOUT writing `--profile` back into argv.
+ *
+ * The dsh `web` subcommand is a hardcoded alias for `--profile web`: the
+ * launcher resolves the name internally and boots the web profile, but the
+ * process argv keeps the original tokens (`node …/dsh web [flags]`) — there
+ * is no `--profile` flag and no environment variable naming the profile. So
+ * when {@link profileNameFromArgv} finds nothing, check whether the first
+ * non-flag token after argv[0] is a known dsh subcommand alias:
+ *
+ *   - `web`            → boot profile `web` (alias, never followed by a name)
+ *   - `--profile <n>`  → already handled above
+ *   - anything else    → unknown/not a profile alias (e.g. `plugin`, which
+ *                        is a management mode, not a boot; returns undefined)
+ *
+ * Returns undefined when argv carries no recognizable alias, letting the
+ * caller fall through to the cwd-based resolution steps.
+ */
+export declare function profileNameFromDshAlias(): string | undefined;
 /**
  * Resolve the a2a.json path for the current process, without depending on
  * the launch directory. The plugin must work no matter where `dsh` was
@@ -78,7 +98,9 @@ export declare function profileNameFromArgv(): string | undefined;
  *
  * Order:
  *   0. `$DSH_HOME/profiles/<argv --profile>/a2a.json` — the active profile
- *      as named on the command line (most authoritative; works from ANY cwd)
+ *      as named on the command line (most authoritative; works from ANY cwd).
+ *      Also matches the `dsh web` alias, which boots profile `web` without
+ *      writing `--profile` into argv.
  *   1. `cwd/a2a.json` — explicit when launched inside a profile dir
  *   2. outward from cwd: the nearest ancestor holding `a2a.json` — covers
  *      launching from e.g. a repo checkout whose parent chain includes the

package/lib/types/a2a-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"a2a-config.d.ts","sourceRoot":"","sources":["../../src/a2a-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACzG;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAaxD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAqC1C;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,IAAI,kBAAkB,CAW/C;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,MAAM,EAAE,kBAAkB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAatG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,kBAAkB,GAAG,eAAe,CAmBpG"}
+{"version":3,"file":"a2a-config.d.ts","sourceRoot":"","sources":["../../src/a2a-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACzG;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAaxD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,SAAS,CAW5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAoD1C;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,IAAI,kBAAkB,CAW/C;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,MAAM,EAAE,kBAAkB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAatG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,kBAAkB,GAAG,eAAe,CAmBpG"}

package/lib/types/client/dashboard.css.d.ts

@@ -0,0 +1,20 @@
+/**
+ * dsh-a2a — dashboard stylesheet.
+ *
+ * The browser half is a compiled bundle (not a dynamic cordis plugin), so it
+ * injects its own stylesheet the same way first-party DSH client UI packages
+ * do: a single idempotent <style> tag, styled entirely with the product's
+ * `--dsw-alias-*` design tokens (so light/dark themes and future token
+ * changes apply automatically), plus `@media` queries for narrow windows.
+ *
+ * Class names are prefixed with `a2a-` to avoid collisions with product or
+ * third-party styles.
+ */
+export declare const DASHBOARD_CSS_ID = "@ryubyte/dsh-a2a/dashboard.css";
+/**
+ * Idempotently inject the dashboard stylesheet into <head>. Returns a
+ * disposer that removes the tag; safe to call repeatedly (a second call is a
+ * no-op and returns a no-op disposer).
+ */
+export declare function injectDashboardStyles(): () => void;
+//# sourceMappingURL=dashboard.css.d.ts.map

package/lib/types/client/dashboard.css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.css.d.ts","sourceRoot":"","sources":["../../../src/client/dashboard.css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,gBAAgB,mCAAmC,CAAC;AAmQjE;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,IAAI,CAiBlD"}

package/lib/types/client/index.d.ts

@@ -8,6 +8,10 @@
  * The data and the controls live behind the host's `/a2a/api` routes
  * (served by the node half on the same webserver); the browser half is a
  * thin read/write client with no protocol knowledge.
+ *
+ * Styling: a single idempotent stylesheet (dashboard.css.ts) built entirely
+ * on the product's `--dsw-alias-*` design tokens, so light/dark themes and
+ * narrow-window layouts follow the DSH shell. No inline styles.
  */
 import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
 import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';

package/lib/types/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAE9E,0DAA0D;AAC1D,eAAO,MAAM,MAAM,UAAY,CAAC;AAEhC,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAmB9C;AA6DD,KAAK,YAAY,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AAErD,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA0UnE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAsC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAG9E,0DAA0D;AAC1D,eAAO,MAAM,MAAM,UAAY,CAAC;AAEhC,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAyB9C;AA8DD,KAAK,YAAY,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AA+FrD,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA8UnE"}

package/lib/types/dashboard.d.ts

@@ -105,6 +105,26 @@ export interface DashboardControlHooks {
     serverStatus?: () => ControlResult;
     /** Runtime-remove an outbound agent by its connection id. */
     removeAgent?: (connectionId: string) => Promise<ControlResult>;
+    /** Update the outbound-server identity (AgentCard) at runtime (persisted). */
+    setServerIdentity?: (patch: {
+        agentName?: string;
+        agentDescription?: string;
+        agentVersion?: string;
+        baseUrl?: string;
+        endpointPath?: string;
+        skills?: Array<{
+            id: string;
+            name: string;
+            description: string;
+            tags?: string[];
+        }>;
+    }) => Promise<ControlResult>;
+    /** Update a saved outbound agent's advanced fields, reconnecting to apply. */
+    updateAgent?: (connectionId: string, patch: {
+        timeoutMs?: number;
+        mapSkills?: boolean;
+        bearerToken?: string;
+    }) => Promise<ControlResult>;
 }
 /** Registry of live A2A connections, both directions. */
 export declare class DashboardRegistry {

package/lib/types/dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/dashboard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/dashboard.ts"],"names":[],"mappings":"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"}

package/lib/types/index.d.ts

@@ -125,4 +125,22 @@ export declare const name = "a2a";
  */
 export declare const inject: readonly ["webServer", "tools"];
 export declare function apply(ctx: Context, config?: A2APluginConfig): void;
+/**
+ * Derive the public base URL advertised in the AgentCard from the real wire
+ * listen address, when the operator did not pin `baseUrl` in config.
+ *
+ * The A2A AgentCard must carry a URL a REMOTE caller can reach. When the web
+ * server binds only loopback (`127.0.0.1`), that address is correct. But when
+ * it binds every interface (`0.0.0.0`), advertising `127.0.0.1` is wrong for
+ * every non-local caller — it points at the caller's own loopback. In that
+ * case pick the machine's best-known LAN address (the primary non-loopback
+ * IPv4 of the interface that routes to the default gateway), and only fall
+ * back to loopback when no such address exists. IPv6 link-local is skipped
+ * (not reachable without a scope id).
+ *
+ * @param host - the web server's configured bind host ('127.0.0.1' | '0.0.0.0').
+ * @param port - the OS-assigned (or configured) listen port.
+ * @returns a scheme+host+port URL for Agents to call back into this DSH.
+ */
+export declare function inferBaseUrl(host: string, port: number): string;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/lib/types/server.d.ts

@@ -14,6 +14,19 @@ import type { AgentCard, AgentSkill, Message, Part, Task } from './protocol.js';
 import { TaskState } from './protocol.js';
 export interface ServerSkill extends AgentSkill {
 }
+/**
+ * Runtime-editable slice of the advertised AgentCard identity. Every field is
+ * optional; only the provided ones change. Applied in place by
+ * {@link A2AServer.updateCard} (mirrors setBaseUrl/setAuthToken).
+ */
+export interface CardIdentityPatch {
+    agentName?: string;
+    agentDescription?: string;
+    agentVersion?: string;
+    baseUrl?: string;
+    endpointPath?: string;
+    skills?: ServerSkill[];
+}
 export interface ServerOptions {
     /** Public base URL (scheme + host + optional prefix) where this DSH is exposed. */
     baseUrl: string;
@@ -94,7 +107,8 @@ export declare class A2AServer {
     readonly options: ServerOptions;
     readonly store: TaskStore;
     readonly card: AgentCard;
-    readonly endpointPath: string;
+    /** JSON-RPC route path. Mutable: `updateCard` can move it at runtime. */
+    endpointPath: string;
     private execute;
     private listeners;
     private baseUrl;
@@ -106,6 +120,10 @@ export declare class A2AServer {
      * address is known (e.g. ephemeral port). Mutates `card` in place.
      */
     setBaseUrl(baseUrl: string): void;
+    /** The base URL currently advertised in the AgentCard. */
+    getBaseUrl(): string;
+    /** Rebuild the advertised interface URL(s) from the current baseUrl + path. */
+    private rebuildInterfaceUrls;
     /**
      * Set or clear the shared bearer token that gates the inbound endpoint at
      * runtime. Rebuilds the AgentCard so the `bearerAuth` security scheme is
@@ -116,6 +134,20 @@ export declare class A2AServer {
     setAuthToken(token?: string): void;
     /** Whether the inbound endpoint is currently token-gated. */
     get authConfigured(): boolean;
+    /**
+     * Update the advertised identity (name/description/version/baseUrl/
+     * endpointPath/skills) at runtime, in place. Mirrors setBaseUrl/setAuthToken:
+     * mutates `this.options` and the existing `this.card` object's properties —
+     * never reassigns `this.card`, so the route handler closure that reads
+     * `server.card` per request keeps seeing the live card.
+     *
+     * Returns `{ endpointChanged }`: when the JSON-RPC path moved, the caller
+     * (which owns route registration) must re-register routes on the new path —
+     * `updateCard` only mutates the advertised URL, not the live HTTP routes.
+     */
+    updateCard(patch: CardIdentityPatch): {
+        endpointChanged: boolean;
+    };
     private buildCard;
     /** True when the request carries the configured bearer token. */
     private authorized;