@agentrq/acp-gateway 0.2.3 → 0.2.4

package/dist/registry.js

@@ -0,0 +1,118 @@
+/**
+ * registry.ts
+ *
+ * Resolves ACP agents from the public registry, so an agent can be named by id
+ * instead of being installed and wired up by hand.
+ *
+ * The registry publishes one index of every agent it lists, each entry saying
+ * how the agent is distributed: an npm package run through `npx`, a PyPI
+ * package run through `uvx`, or a platform-specific binary to download.
+ *
+ * See https://github.com/agentclientprotocol/registry
+ */
+/** The registry index, as published by the ACP project. */
+export const DEFAULT_REGISTRY_URL = "https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json";
+/** Node's platform/arch names mapped onto the registry's identifiers. */
+const PLATFORMS = { darwin: "darwin", linux: "linux", win32: "windows" };
+const ARCHITECTURES = { arm64: "aarch64", x64: "x86_64" };
+/**
+ * The registry platform identifier for the machine we are running on, or
+ * undefined where the registry publishes nothing for it.
+ */
+export function hostPlatformTarget(platform = process.platform, arch = process.arch) {
+    const os = PLATFORMS[platform];
+    const cpu = ARCHITECTURES[arch];
+    if (!os || !cpu)
+        return undefined;
+    return `${os}-${cpu}`;
+}
+/** Rejects anything that is not a registry index, so a bad URL fails loudly. */
+function assertRegistry(value, url) {
+    const agents = value?.agents;
+    if (!Array.isArray(agents)) {
+        throw new Error(`${url} did not return an ACP registry index.`);
+    }
+}
+/**
+ * Downloads the registry index.
+ *
+ * `fetchImpl` and `url` are injectable so a pinned or local registry can be
+ * used instead of the published one.
+ */
+export async function fetchRegistry(url = DEFAULT_REGISTRY_URL, fetchImpl = fetch) {
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch the ACP registry from ${url}: ${response.status} ${response.statusText}`);
+    }
+    const body = await response.json();
+    assertRegistry(body, url);
+    return body;
+}
+/** Finds one agent by its registry id. */
+export function findAgent(registry, id) {
+    return registry.agents.find((agent) => agent.id === id);
+}
+/**
+ * Renders the registry as a table for the terminal.
+ *
+ * `target` is passed in rather than defaulted, so that "this machine has no
+ * published build" stays distinguishable from "caller did not say".
+ */
+export function describeAgents(registry, target) {
+    const rows = registry.agents.map((agent) => {
+        const kinds = availableKinds(agent, target);
+        const support = kinds.length ? kinds.join(", ") : "unavailable on this platform";
+        return `  ${agent.id.padEnd(22)} ${agent.name} — ${support}`;
+    });
+    return rows.join("\n");
+}
+/** Which distributions of this agent can actually run on this machine. */
+export function availableKinds(agent, target) {
+    const kinds = [];
+    if (agent.distribution.npx)
+        kinds.push("npx");
+    if (agent.distribution.uvx)
+        kinds.push("uvx");
+    if (target && agent.distribution.binary?.[target])
+        kinds.push("binary");
+    return kinds;
+}
+/**
+ * Picks the binary build for this machine.
+ *
+ * Throws rather than falling back to another platform's build: running the
+ * wrong architecture would fail in a much more confusing way.
+ */
+export function selectBinaryTarget(agent, target) {
+    const binary = agent.distribution.binary;
+    if (!binary) {
+        throw new Error(`Agent "${agent.id}" publishes no binary distribution.`);
+    }
+    if (!target) {
+        throw new Error(`The ACP registry publishes no binaries for ${process.platform}/${process.arch}.`);
+    }
+    const selected = binary[target];
+    if (!selected) {
+        throw new Error(`Agent "${agent.id}" publishes no binary for ${target} ` +
+            `(available: ${Object.keys(binary).join(", ")}).`);
+    }
+    return selected;
+}
+/**
+ * Turns an npm or PyPI distribution into the command that runs it.
+ *
+ * On Windows npm installs `npx` as `npx.cmd`; spawning a bare "npx" there
+ * looks only for `npx.exe` and fails, so the runner is named explicitly.
+ */
+export function packageLaunchSpec(kind, distribution, platform = process.platform) {
+    // `npx -y` skips the install prompt, which would otherwise block a gateway
+    // that nobody is watching.
+    const args = kind === "npx" ? ["-y", distribution.package] : [distribution.package];
+    return {
+        command: kind === "npx" && platform === "win32" ? "npx.cmd" : kind,
+        args: [...args, ...(distribution.args ?? [])],
+        env: distribution.env,
+        kind,
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentrq/acp-gateway",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "ACP+MCP bridge CLI for agentrq workspaces",
   "type": "module",
   "publishConfig": {