agentic-relay 4.2.1 → 4.3.1

package/bin/lib/api.mjs

@@ -73,15 +73,15 @@ export function search(query, { apiKey, userContext, maxResults = 25, timeoutMs
 }
 
 export function sessionStart(
-  { capabilityId, adUnitId, clearingPriceCents, initialData },
+  { agentId, initialData, taskContext },
   { apiKey, timeoutMs },
 ) {
   return apiPost(
     "/session/start",
     {
-      capability_id: capabilityId,
-      ad_unit_id: adUnitId,
-      clearing_price_cents: clearingPriceCents,
+      agent_id: agentId,
+      // A2A current-task brief; api-v1 forwards it to capability-session /initiate.
+      ...(taskContext ? { task_context: taskContext } : {}),
       ...(initialData ? { initial_data: initialData } : {}),
     },
     { apiKey, timeoutMs },

package/bin/lib/cache.mjs

@@ -1,7 +1,7 @@
 /**
  * On-disk cache (spec §9). Layout under --cache-dir (default ./.agent-relay):
  *
- *   index.json            { slug: { ts, expires, capability_id, ad_unit_id, last_session_id } }
+ *   index.json            { slug: { ts, expires, agent_id, last_session_id } }
  *   specs/<slug>.json     a Deliverable
  *   search/<hash>.json    { ts, expires, query, capabilities }
  *
@@ -143,7 +143,7 @@ export class Cache {
         name: spec.name ?? null,
         summary: spec.summary ?? null,
         features: Array.isArray(spec.features) ? spec.features.length : null,
-        capability_id: spec.capability_id ?? null,
+        agent_id: spec.agent_id ?? null,
         ts: spec.ts ?? null,
       };
     });

package/bin/lib/commands.mjs

@@ -23,36 +23,25 @@ import { slugify } from "./config.mjs";
 import { Cache } from "./cache.mjs";
 import { cmdFetch } from "./fetch.mjs";
 
-/** Normalize one upstream capability into the spec §4 menu shape. */
+/** Normalize one upstream capability into the lean menu shape. `agent_id` is the only id —
+ *  session start needs nothing else (ad_unit + price are resolved server-side). */
 function normalizeCapability(c) {
   const name = c.name || "";
   return {
     slug: slugify(name),
     name,
-    type: c.type || "dynamic_capability",
+    type: "dynamic_capability", // single type now; kept for the --dynamic-only filter
+    agent_id: c.agent_id || null,
     relevance: typeof c.relevance_score === "number" ? c.relevance_score : null,
-    clearing_price_cents:
-      typeof c.clearing_price_cents === "number" ? c.clearing_price_cents : 0,
-    capability_id: c.capability_id || null,
-    ad_unit_id: c.ad_unit_id || null,
+    reputation: typeof c.reputation_score === "number" ? c.reputation_score : null,
+    total_agent_ratings: typeof c.total_agent_ratings === "number" ? c.total_agent_ratings : 0,
+    sessions_count: typeof c.sessions_count === "number" ? c.sessions_count : 0,
     description: c.description || "",
-    click_url: c.click_url || null,
-    // Track-record evidence card (server-side from capability_profile.fit). The
-    // backend already ranks/trims and strips confidence; pass these through as-is
-    // so --json carries the exact same shape the API and MCP return. Empty arrays
-    // when a capability has no roller profile yet.
-    summary: c.summary || "",
-    feedback_payout:
-      typeof c.feedback_payout === "number"
-        ? c.feedback_payout
-        : typeof c.clearing_price_cents === "number"
-          ? c.clearing_price_cents
-          : 0,
     offers_paid_deliverable: Boolean(c.offers_paid_deliverable),
-    deliverable: c.deliverable || null,
-    proven_for: Array.isArray(c.proven_for) ? c.proven_for : [],
-    watch_out: Array.isArray(c.watch_out) ? c.watch_out : [],
-    works_with: Array.isArray(c.works_with) ? c.works_with : [],
+    deliverable_price_cents: typeof c.deliverable_price_cents === "number" ? c.deliverable_price_cents : null,
+    required_inputs: Array.isArray(c.required_inputs) ? c.required_inputs : [],
+    // Track-record cards are disabled server-side for now; the API returns a note string.
+    fit: typeof c.fit === "string" ? c.fit : "",
   };
 }
 
@@ -92,13 +81,11 @@ export async function cmdSearch(query, opts) {
     paymentContext = data.payment_context ?? null;
     capabilities = dedupeSlugs((data.capabilities || []).map(normalizeCapability));
     cache.writeSearch(query, capabilities, paymentContext);
-    // Seed the index so session start can resolve ids without re-searching.
+    // Seed the index so session start can resolve agent_id without re-searching.
     for (const c of capabilities) {
-      if (c.capability_id && c.ad_unit_id) {
+      if (c.agent_id) {
         cache.updateIndex(c.slug, {
-          capability_id: c.capability_id,
-          ad_unit_id: c.ad_unit_id,
-          clearing_price_cents: c.clearing_price_cents,
+          agent_id: c.agent_id,
           name: c.name,
           ts: new Date().toISOString(),
         });
@@ -122,38 +109,26 @@ export async function cmdSearch(query, opts) {
 }
 
 /**
- * Resolve a slug (or capability_id) to { capabilityId, adUnitId,
- * clearingPriceCents, slug, name }. Order: cache index → banked spec file →
- * fresh search keyed on the de-kebabed slug. The spec-file fallback lets a
- * depth session resolve even when the cache was filled only by `cache put`
- * during the breadth pass (which doesn't write the index).
+ * Resolve a slug (or agent_id) to { agentId, slug, name }. Order: cache index →
+ * banked spec file → fresh search keyed on the de-kebabed slug. The spec-file
+ * fallback lets a depth session resolve even when the cache was filled only by
+ * `cache put` during the breadth pass (which doesn't write the index).
+ * agent_id is the only id needed — the ad_unit + price are resolved server-side.
  */
 export async function resolveCapability(slugOrId, opts) {
   const cache = new Cache(opts.cacheDir, { enabled: !opts.noCache });
   const slug = slugify(slugOrId);
 
   const entry = cache.getIndexEntry(slug) || cache.getIndexEntry(slugOrId);
-  if (entry && entry.capability_id && entry.ad_unit_id && !opts.refresh) {
-    return {
-      capabilityId: entry.capability_id,
-      adUnitId: entry.ad_unit_id,
-      clearingPriceCents: entry.clearing_price_cents || 0,
-      slug,
-      name: entry.name || slug,
-    };
+  if (entry && entry.agent_id && !opts.refresh) {
+    return { agentId: entry.agent_id, slug, name: entry.name || slug };
   }
 
-  // Banked spec fallback — a breadth subagent stored ids here via `cache put`.
+  // Banked spec fallback — a breadth subagent stored the agent_id here via `cache put`.
   if (!opts.refresh) {
     const spec = cache.readSpec(slug, { ttlMs: Infinity });
-    if (spec && spec.capability_id && spec.ad_unit_id) {
-      return {
-        capabilityId: spec.capability_id,
-        adUnitId: spec.ad_unit_id,
-        clearingPriceCents: spec.clearing_price_cents || 0,
-        slug,
-        name: spec.name || slug,
-      };
+    if (spec && spec.agent_id) {
+      return { agentId: spec.agent_id, slug, name: spec.name || slug };
     }
   }
 
@@ -162,20 +137,14 @@ export async function resolveCapability(slugOrId, opts) {
   const found = await cmdSearch(queryGuess, { ...opts, refresh: true, max: 25 });
   const match =
     found.capabilities.find((c) => c.slug === slug) ||
-    found.capabilities.find((c) => c.capability_id === slugOrId) ||
+    found.capabilities.find((c) => c.agent_id === slugOrId) ||
     found.capabilities.find((c) => c.slug.startsWith(slug));
-  if (!match || !match.capability_id || !match.ad_unit_id) {
+  if (!match || !match.agent_id) {
     throw new Error(
-      `could not resolve "${slugOrId}" — run \`agentrelay search\` first or pass a known slug`,
+      `could not resolve "${slugOrId}" — run \`agentrelay search\` first or pass a known agent_id`,
     );
   }
-  return {
-    capabilityId: match.capability_id,
-    adUnitId: match.ad_unit_id,
-    clearingPriceCents: match.clearing_price_cents || 0,
-    slug: match.slug,
-    name: match.name,
-  };
+  return { agentId: match.agent_id, slug: match.slug, name: match.name };
 }
 
 // ── session primitives (thin api_v1 wrappers — the LLM-driven path) ─────────
@@ -234,16 +203,18 @@ export async function cmdSession(sub, positionals, opts) {
   if (sub === "start") {
     const slugOrId = positionals[0];
     if (!slugOrId) {
-      const e = new Error("usage: agentrelay session start <slug|capability_id> [--initial json] [--message m]");
+      const e = new Error("usage: agentrelay session start <slug|agent_id> [--initial json] [--message m]");
       e.usage = true;
       throw e;
     }
     const resolved = await resolveCapability(slugOrId, opts);
     const start = await sessionStart(
       {
-        capabilityId: resolved.capabilityId,
-        adUnitId: resolved.adUnitId,
-        clearingPriceCents: resolved.clearingPriceCents,
+        agentId: resolved.agentId,
+        // A2A current-task brief → forwarded to /session/start → /initiate, where it's
+        // stored on capability_sessions.task_context and rendered as the business agent's
+        // "## Current task" prompt block. Optional on the CLI path (server stores null when absent).
+        taskContext: opts.taskContext || null,
         initialData: parseJsonFlag(opts.initial, "initial"),
       },
       net,

package/bin/relay-core.mjs

@@ -56,6 +56,7 @@ const FLAGS_WITH_VALUE = new Set([
   "--max",
   "--user-context",
   "--initial",
+  "--task-context",
   "--message",
   "--data",
   "--score",
@@ -141,25 +142,18 @@ function fail(message, exitCode, json) {
 const fmtSearch = (e) => {
   const lines = [`${e.count} capabilities for "${e.query}"${e.from_cache ? ` (cached ${e.cached_at})` : ""}`];
   for (const c of e.capabilities) {
-    const price = c.clearing_price_cents ? `$${(c.clearing_price_cents / 100).toFixed(2)}` : "free";
     const rel = c.relevance != null ? c.relevance.toFixed(2) : "—";
-    const kind = c.type === "static_offer" ? "[offer]" : "[agent]";
+    const rep = c.reputation != null ? c.reputation.toFixed(2) : "—";
     const desc = c.description.length > 90 ? c.description.slice(0, 90) + "…" : c.description;
-    lines.push(`  ${kind} ${c.slug}  (rel ${rel}, ${price})  ${c.name}`);
+    lines.push(`  [agent] ${c.slug}  (rel ${rel}, rep ${rep}, ${c.sessions_count ?? 0} sessions/${c.total_agent_ratings ?? 0} ratings)  ${c.name}`);
     if (desc) lines.push(`        ${desc}`);
-    // Track-record evidence card (when the capability has a roller profile). --json
-    // carries the full structured fields; this is the scannable human digest.
-    if (Array.isArray(c.proven_for) && c.proven_for.length) {
-      lines.push(`        proven: ${c.proven_for.map((p) => p.use_case).join("; ")}`);
+    if (Array.isArray(c.required_inputs) && c.required_inputs.length) {
+      lines.push(`        needs: ${c.required_inputs.map((i) => i.field).join(", ")}`);
     }
-    if (Array.isArray(c.watch_out) && c.watch_out.length) {
-      lines.push(`        watch:  ${c.watch_out.map((w) => w.use_case).join("; ")}`);
+    if (c.offers_paid_deliverable) {
+      const dp = typeof c.deliverable_price_cents === "number" ? ` ($${(c.deliverable_price_cents / 100).toFixed(2)})` : "";
+      lines.push(`        offers paid deliverable${dp}`);
     }
-    if (Array.isArray(c.works_with) && c.works_with.length) {
-      const flag = (r) => (r === "conflicts" || r === "requires" ? `${r}!` : r);
-      lines.push(`        works-with: ${c.works_with.map((w) => `${w.companion_tool} (${flag(w.relationship)})`).join(", ")}`);
-    }
-    if (c.offers_paid_deliverable) lines.push(`        offers paid deliverable`);
   }
   // Surface the spend policy in human output too — agents reading --json get
   // the full payment_context object; humans shouldn't be blind to it.
@@ -289,6 +283,7 @@ async function main() {
         const payload = await cmdSession(positionals[0], positionals.slice(1), {
           ...shared,
           initial: flags.initial || null,
+          taskContext: flags["task-context"] || null,
           message: flags.message || null,
           data: flags.data || null,
           credential: flags.credential || null,

package/bin/test/cache.test.mjs

@@ -27,7 +27,7 @@ test("listSpecHeadlines: returns slug+name+summary+feature-count, no index.json
   withCache((dir, cache) => {
     cache.writeSpec("a-tool", {
       slug: "a-tool", name: "A", summary: "does A",
-      features: [{ feature: "x", how: "y" }], capability_id: "cap-a", ts: ISO,
+      features: [{ feature: "x", how: "y" }], agent_id: "agent-a", ts: ISO,
     });
     cache.writeSpec("b-tool", { slug: "b-tool", name: "B", summary: "does B", features: [], ts: ISO });
 
@@ -37,7 +37,7 @@ test("listSpecHeadlines: returns slug+name+summary+feature-count, no index.json
     assert.equal(a.name, "A");
     assert.equal(a.summary, "does A");
     assert.equal(a.features, 1);
-    assert.equal(a.capability_id, "cap-a");
+    assert.equal(a.agent_id, "agent-a");
     // Race-safe: the put path never wrote a shared index.json.
     assert.equal(existsSync(join(dir, "index.json")), false);
   });
@@ -54,17 +54,15 @@ test("listSpecHeadlines: tolerates a spec missing the optional fields", () => {
   });
 });
 
-test("resolveCapability: falls back to the banked spec's ids (no network)", async () => {
+test("resolveCapability: falls back to the banked spec's agent_id (no network)", async () => {
   await withCache(async (dir, cache) => {
     cache.writeSpec("a-tool", {
       slug: "a-tool", name: "A Tool", summary: "s", features: [],
-      capability_id: "cap-a", ad_unit_id: "unit-a", clearing_price_cents: 130, ts: ISO,
+      agent_id: "agent-a", ts: ISO,
     });
     // No index.json, refresh falsy → must resolve from the spec file alone.
     const r = await resolveCapability("a-tool", { cacheDir: dir, noCache: false });
-    assert.equal(r.capabilityId, "cap-a");
-    assert.equal(r.adUnitId, "unit-a");
-    assert.equal(r.clearingPriceCents, 130);
+    assert.equal(r.agentId, "agent-a");
     assert.equal(r.slug, "a-tool");
     assert.equal(r.name, "A Tool");
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-relay",
-  "version": "4.2.1",
+  "version": "4.3.1",
   "description": "Install Agent Relay AI search across 17+ agents — Claude Code, Codex, Cursor, Gemini CLI, Goose, Windsurf, Cline, BoltAI, Claude Desktop, VS Code, Amazon Q, Roo Code, Witsy, LibreChat, OpenClaw, Tome, Raycast — plus the `agentrelay` CLI for live agent sessions, payments, and deliverable fetch",
   "bin": {
     "agentrelay": "bin/cli.mjs"

package/schema/deliverable.json

@@ -39,9 +39,7 @@
         }
       }
     },
-    "capability_id": { "type": ["string", "null"], "description": "So the main agent can open a depth session." },
-    "ad_unit_id": { "type": ["string", "null"] },
-    "clearing_price_cents": { "type": "integer" },
+    "agent_id": { "type": ["string", "null"], "description": "The only id needed to open a session (ad_unit + price resolved server-side)." },
     "ts": { "type": "string", "format": "date-time" }
   }
 }