@nanorail/sdk 0.1.1 → 0.1.2

package/dist/index.d.ts

@@ -134,6 +134,53 @@ export declare class NanoRailEvents {
 	emit(detail: Omit<NanoRailEventDetail, "at">): void;
 	on(label: LifecycleLabel | "lifecycle", handler: (e: NanoRailEventDetail) => void): () => void;
 }
+export interface GenerateManifestOptions {
+	/** DOM subtree to scan; defaults to the whole document. */
+	root?: ParentNode;
+	/** Override the article id (else derived from the chunks' attributes). */
+	articleId?: string;
+	/** Override the publisher id (else derived from the chunks' attributes). */
+	publisherId?: string;
+	/** Override the article title (else taken from <h1> or document.title). */
+	title?: string;
+}
+/**
+ * Build a machine-readable manifest purely from the publisher's
+ * `data-nanorail-*` attributes — no separately-maintained manifest file. The
+ * publisher marks content; this derives article metadata, chunk ids/types/prices,
+ * teasers, and per-chunk unlock endpoints automatically.
+ */
+export declare function generateManifest(opts?: GenerateManifestOptions): ArticleManifest;
+/** A scanned chunk plus the gated content captured from the page. */
+export interface RegisteredChunkInput extends ManifestChunk {
+	/** The publisher's gated content, captured from the element's innerHTML. */
+	content: string;
+}
+/** Payload the SDK sends to the gateway's registration endpoint. */
+export interface ArticleRegistration {
+	publisherId: string;
+	articleId: string;
+	title: string;
+	source: "sdk-scan";
+	chunks: RegisteredChunkInput[];
+}
+/**
+ * Like {@link generateManifest}, but ALSO captures each chunk's gated content
+ * (its current `innerHTML`/`textContent`) so the SDK can register the publisher's
+ * real content with the gateway. **Must run BEFORE the chunk is locked** — locking
+ * replaces the element's children. The captured `content` is sent only to the
+ * registration endpoint; it is never surfaced in the public manifest or discovery.
+ */
+export declare function scanRegistration(opts?: GenerateManifestOptions): ArticleRegistration;
+/** Gateway response to a publisher content registration. */
+export interface RegistrationResult {
+	ok: boolean;
+	/** Total chunks registered (metadata). */
+	chunks?: number;
+	/** How many carried gated content (the rest fall back to seeded demo content). */
+	withContent?: number;
+	source?: string;
+}
 export interface ChunkDescriptor {
 	chunkId: string;
 	type: ContentType;
@@ -199,6 +246,12 @@ export declare class NanoRailClient {
 	session?: Session;
 	spentMicros: number;
 	receipts: Receipt[];
+	/** Content already unlocked this session, by chunkId — lets a re-run reuse what
+	 *  was bought instead of re-paying (the gateway rejects duplicate payments). */
+	unlocked: Map<string, {
+		content: string;
+		title: string;
+	}>;
 	blocked: Array<{
 		chunkId: string;
 		reason: string;
@@ -224,6 +277,13 @@ export declare class NanoRailClient {
 		ok: boolean;
 		chunks?: number;
 	}>;
+	/**
+	 * Register the publisher's scanned chunks WITH their gated content. The gateway
+	 * stores the content server-side and returns it only from a verified unlock;
+	 * discovery/manifest expose only the metadata. This is what makes a real
+	 * publisher's own content (not seeded demo content) the thing that unlocks.
+	 */
+	registerArticle(registration: ArticleRegistration): Promise<RegistrationResult>;
 	/** Open a funded session once; concurrent callers share the same promise. */
 	ensureSession(): Promise<Session>;
 	private openSession;
@@ -294,23 +354,6 @@ export interface ScanOptions {
  * `{ autoUnlock: true }`, policy-eligible chunks unlock themselves on scroll.
  */
 export declare function scanAndLock(client: NanoRailClient, root?: ParentNode, opts?: ScanOptions): HTMLElement[];
-export interface GenerateManifestOptions {
-	/** DOM subtree to scan; defaults to the whole document. */
-	root?: ParentNode;
-	/** Override the article id (else derived from the chunks' attributes). */
-	articleId?: string;
-	/** Override the publisher id (else derived from the chunks' attributes). */
-	publisherId?: string;
-	/** Override the article title (else taken from <h1> or document.title). */
-	title?: string;
-}
-/**
- * Build a machine-readable manifest purely from the publisher's
- * `data-nanorail-*` attributes — no separately-maintained manifest file. The
- * publisher marks content; this derives article metadata, chunk ids/types/prices,
- * teasers, and per-chunk unlock endpoints automatically.
- */
-export declare function generateManifest(opts?: GenerateManifestOptions): ArticleManifest;
 /**
  * The NanoRail **Agent Wallet** — the user-facing control layer for what an agent
  * is allowed to spend money on. Budget, permissions, and purchase rules are the
@@ -369,6 +412,8 @@ export interface AgentResult {
 	purchased: AgentPurchase[];
 	/** Total spent across all purchases, decimal USD string. */
 	totalCost: string;
+	/** A readable answer grounded in the content the agent actually purchased. */
+	answer: string;
 	summary: string;
 }
 /** Staged progress emitted while the agent works, so a UI can render it live. */
@@ -408,11 +453,19 @@ export interface AgentOptions {
 	task?: string;
 	/** Discovery query sent to the publisher (default: derived from the task). */
 	query?: string;
+	/**
+	 * Minimum discovery relevance (0–1) the agent will pay for. Surfaced chunks
+	 * below this bar are skipped as "low relevance" — so the agent does not blindly
+	 * buy everything discovery returns. Default 0.3.
+	 */
+	confidenceThreshold?: number;
 	/** Called at each stage so the demo can render the flow step by step. */
 	onProgress?: (p: AgentProgress) => void;
 	/** Pause between steps (ms) so judges can watch the lifecycle stream. */
 	stepDelayMs?: number;
 }
+/** The agent's default relevance bar: it won't pay for weaker discovery matches. */
+export declare const DEFAULT_CONFIDENCE_THRESHOLD = 0.3;
 /**
  * Simulates an autonomous agent that **discovers before it buys** — so it never
  * pays blindly:
@@ -469,6 +522,12 @@ export interface NanoRailInstance {
 	client: NanoRailClient;
 	widget?: NanoRailWidget;
 	manifest: ArticleManifest;
+	/**
+	 * Resolves once the page's chunks + gated content have been registered with the
+	 * gateway (undefined if there were no chunks or the call failed). Lets a
+	 * publisher page show a "registered N chunks" confirmation.
+	 */
+	registered: Promise<RegistrationResult | undefined>;
 	rescan: () => void;
 	regenerateManifest: () => Promise<ArticleManifest>;
 	runAgent: (opts?: AgentOptions) => Promise<AgentResult>;

package/dist/index.mjs

@@ -594,6 +594,9 @@ var NanoRailClient = class {
     __publicField(this, "session");
     __publicField(this, "spentMicros", 0);
     __publicField(this, "receipts", []);
+    /** Content already unlocked this session, by chunkId — lets a re-run reuse what
+     *  was bought instead of re-paying (the gateway rejects duplicate payments). */
+    __publicField(this, "unlocked", /* @__PURE__ */ new Map());
     __publicField(this, "blocked", []);
     /** Chunk ids the user has manually approved (for amounts above the threshold). */
     __publicField(this, "approvals", /* @__PURE__ */ new Set());
@@ -639,6 +642,20 @@ var NanoRailClient = class {
     });
     return await res.json().catch(() => ({ ok: false }));
   }
+  /**
+   * Register the publisher's scanned chunks WITH their gated content. The gateway
+   * stores the content server-side and returns it only from a verified unlock;
+   * discovery/manifest expose only the metadata. This is what makes a real
+   * publisher's own content (not seeded demo content) the thing that unlocks.
+   */
+  async registerArticle(registration) {
+    const res = await this.fetchImpl(`${this.gatewayUrl}/api/articles/${registration.articleId}/register`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(registration)
+    });
+    return await res.json().catch(() => ({ ok: false }));
+  }
   /** Open a funded session once; concurrent callers share the same promise. */
   async ensureSession() {
     if (this.session) return this.session;
@@ -737,6 +754,7 @@ var NanoRailClient = class {
     }
     const out = await res.json();
     this.receipts.push(out.receipt);
+    this.unlocked.set(chunk.chunkId, { content: out.content, title: out.title });
     this.spentMicros = toMicros(out.session.spent);
     if (this.session) this.session.spentMicros = this.spentMicros;
     this.events.emit({
@@ -1096,6 +1114,33 @@ function generateManifest(opts = {}) {
     chunks
   };
 }
+function scanRegistration(opts = {}) {
+  const root = opts.root ?? document;
+  const els = Array.from(root.querySelectorAll("[data-nanorail-price]"));
+  const chunks = els.map((el) => {
+    const c = readChunk(el);
+    const content = (el.innerHTML || el.textContent || "").trim();
+    return {
+      chunkId: c.chunkId,
+      type: c.type,
+      title: c.title,
+      price: c.price,
+      currency: "USD",
+      recipient: c.recipient,
+      teaser: c.teaser ?? c.title,
+      tags: c.tags ?? [],
+      endpoints: {
+        challenge: `/api/chunks/${c.chunkId}/challenge`,
+        unlock: `/api/chunks/${c.chunkId}/unlock`
+      },
+      content
+    };
+  });
+  const articleId = opts.articleId ?? els[0]?.dataset.nanorailArticle ?? "unknown-article";
+  const publisherId = opts.publisherId ?? els[0]?.dataset.nanorailPublisher ?? "unknown-publisher";
+  const title = opts.title ?? (root instanceof Document ? root.querySelector("h1")?.textContent?.trim() : void 0) ?? (typeof document !== "undefined" ? document.title : void 0) ?? articleId;
+  return { publisherId, articleId, title, source: "sdk-scan", chunks };
+}
 
 // src/widget.ts
 var nrMark = (fill, size = 15) => `<svg width="${size}" height="${size}" viewBox="0 0 64 64" style="vertical-align:-3px;flex:none"><g fill="${fill}"><circle cx="14" cy="12" r="4"/><circle cx="14" cy="22" r="4"/><circle cx="14" cy="32" r="4"/><circle cx="14" cy="42" r="4"/><circle cx="14" cy="52" r="4"/><circle cx="54" cy="12" r="4"/><circle cx="54" cy="22" r="4"/><circle cx="54" cy="42" r="4"/><circle cx="54" cy="52" r="4"/><circle cx="24" cy="22" r="4"/><circle cx="34" cy="32" r="4"/><circle cx="44" cy="42" r="4"/></g></svg>`;
@@ -1168,7 +1213,7 @@ var NanoRailWidget = class {
     const p = s.policy;
     const budgetMicros = toMicros(s.budget);
     const remaining = fromMicros(Math.max(0, budgetMicros - s.spent));
-    const pct2 = Math.min(100, Math.round(s.spent / Math.max(1, budgetMicros) * 100));
+    const pct3 = Math.min(100, Math.round(s.spent / Math.max(1, budgetMicros) * 100));
     if (this.collapsed) {
       this.root.className = "nr-widget nr-collapsed";
       this.root.innerHTML = `<button class="nr-w-fab" title="Agent Wallet">${nrMark("#0A0A0A", 14)} Agent Wallet \xB7 $${remaining}</button>`;
@@ -1197,7 +1242,7 @@ var NanoRailWidget = class {
 
       <div class="nr-w-budget">
         <div class="nr-w-budget-top"><span class="nr-w-budget-label">Remaining today</span><span class="nr-w-budget-val">$${remaining}</span></div>
-        <div class="nr-w-bar"><i style="width:${pct2}%"></i></div>
+        <div class="nr-w-bar"><i style="width:${pct3}%"></i></div>
         <div class="nr-w-budget-foot"><span>Daily budget $${esc(s.budget)}</span><span>Spent $${fromMicros(s.spent)}</span></div>
       </div>
 
@@ -1304,7 +1349,9 @@ function injectStyles() {
 // src/agent.ts
 var DEFAULT_TASK = "Summarize MPP payments and receipts";
 var DEFAULT_QUERY = "MPP payments and receipts";
+var DEFAULT_CONFIDENCE_THRESHOLD = 0.3;
 var sleep2 = (ms) => ms > 0 ? new Promise((r) => setTimeout(r, ms)) : Promise.resolve();
+var pct = (x) => `${Math.round(x * 100)}%`;
 function descriptor(manifest, m) {
   return {
     chunkId: m.chunkId,
@@ -1324,6 +1371,7 @@ async function runAgentSummary(client, articleId = "the-agentic-chronicle", opts
   const delay = opts.stepDelayMs ?? 0;
   const task = opts.task ?? DEFAULT_TASK;
   const query = opts.query ?? DEFAULT_QUERY;
+  const threshold = opts.confidenceThreshold ?? DEFAULT_CONFIDENCE_THRESHOLD;
   emit({ phase: "task", task, query });
   const manifest = await client.getManifest(articleId);
   const matches = await client.discover(articleId, query, "agent");
@@ -1334,13 +1382,17 @@ async function runAgentSummary(client, articleId = "the-agentic-chronicle", opts
     const chunk = descriptor(manifest, m);
     const decision = client.evaluate(chunk);
     const confidence = confidenceById.get(m.chunkId);
+    const base = { chunkId: m.chunkId, type: m.type, title: m.title, price: m.price, confidence };
     if (!decision.allowed) {
-      return { chunkId: m.chunkId, type: m.type, title: m.title, price: m.price, action: "block", reason: decision.reason ?? "blocked by policy", confidence };
+      return { ...base, action: "block", reason: decision.reason ?? "blocked by policy" };
     }
-    if (confidence !== void 0) {
-      return { chunkId: m.chunkId, type: m.type, title: m.title, price: m.price, action: "buy", reason: `discovery match (confidence ${confidence})`, confidence };
+    if (confidence === void 0) {
+      return { ...base, action: "skip", reason: "not relevant to the task" };
     }
-    return { chunkId: m.chunkId, type: m.type, title: m.title, price: m.price, action: "skip", reason: "not surfaced by discovery" };
+    if (confidence < threshold) {
+      return { ...base, action: "skip", reason: `relevance ${pct(confidence)} below ${pct(threshold)} bar` };
+    }
+    return { ...base, action: "buy", reason: `relevance ${pct(confidence)} \xB7 within budget & allowed` };
   });
   emit({ phase: "plan", plan });
   await sleep2(delay);
@@ -1365,6 +1417,18 @@ async function runAgentSummary(client, articleId = "the-agentic-chronicle", opts
       emit({ phase: "blocked", chunkId: item.chunkId, reason: item.reason });
       continue;
     }
+    const ownedReceipt = client.receipts.find((r) => r.chunkId === item.chunkId);
+    if (ownedReceipt) {
+      const cached = client.unlocked.get(item.chunkId);
+      receiptIds.push(ownedReceipt.receiptId);
+      purchased.push({ chunkId: item.chunkId, title: item.title, type: item.type, price: item.price, receiptId: ownedReceipt.receiptId });
+      totalMicros += toMicros(item.price);
+      if (item.type === "text" && cached?.content) boughtText.push(cached.content);
+      steps.push({ chunkId: item.chunkId, type: item.type, decision: "bought", receiptId: ownedReceipt.receiptId, content: cached?.content });
+      emit({ phase: "bought", chunkId: item.chunkId, receiptId: ownedReceipt.receiptId, content: cached?.content });
+      await sleep2(delay);
+      continue;
+    }
     const out = await client.unlock(chunk, { actor: "agent", viaDiscovery: true });
     if (out.ok && out.receipt) {
       receiptIds.push(out.receipt.receiptId);
@@ -1380,8 +1444,12 @@ async function runAgentSummary(client, articleId = "the-agentic-chronicle", opts
     }
     await sleep2(delay);
   }
+  const skippedCount = plan.filter((p) => p.action === "skip").length;
+  const blockedItems = plan.filter((p) => p.action === "block");
+  const totalCost = fromMicros(totalMicros);
+  const answer = buildAnswer({ task, purchased, boughtText, skippedCount, blockedItems, totalCost });
   const summary = `Task: ${task}
-Discovered ${matches.length} relevant chunk(s); bought ${receiptIds.length}; skipped the rest; video blocked by policy.
+Discovered ${matches.length} relevant chunk(s); bought ${receiptIds.length}; skipped ${skippedCount}; blocked ${blockedItems.length} by policy.
 
 ` + boughtText.map((t) => `\u2022 ${t}`).join("\n\n") + `
 
@@ -1394,21 +1462,45 @@ Receipts: ${receiptIds.join(", ") || "none"}`;
     steps,
     receiptIds,
     purchased,
-    totalCost: fromMicros(totalMicros),
+    totalCost,
+    answer,
     summary
   };
   emit({ phase: "done", result });
   return result;
 }
+function buildAnswer(args) {
+  const { task, purchased, boughtText, skippedCount, blockedItems, totalCost } = args;
+  if (purchased.length === 0) {
+    const why = blockedItems.length ? ` Policy blocked ${blockedItems.map((b) => b.title).join(", ")}.` : "";
+    return `The agent did not spend on \u201C${task}\u201D: nothing it discovered was both relevant enough and permitted by your policy.${why}`;
+  }
+  const lead = `Based on the ${purchased.length} source${purchased.length === 1 ? "" : "s"} the agent purchased for \u201C${task}\u201D:`;
+  const body = boughtText.length ? `
+
+${boughtText.join("\n\n")}` : "";
+  const support = purchased.filter((p) => p.type !== "text");
+  const supportLine = support.length ? `
+
+Supporting data purchased: ${support.map((p) => `${p.title} (${p.type.replace(/_/g, " ")})`).join("; ")}.` : "";
+  const decisions = [];
+  if (skippedCount > 0) decisions.push(`skipped ${skippedCount} less-relevant section${skippedCount === 1 ? "" : "s"}`);
+  if (blockedItems.length > 0) decisions.push(`was blocked by your policy from buying ${blockedItems.map((b) => b.title).join(", ")}`);
+  const decisionLine = decisions.length ? ` The agent ${decisions.join(", and ")}.` : "";
+  return `${lead}${body}${supportLine}
+
+Total spend: $${totalCost} across ${purchased.length} receipt${purchased.length === 1 ? "" : "s"}.${decisionLine}`;
+}
 
 // src/agent-console.ts
 var DEFAULT_AGENT_TASKS = [
-  { label: "Find evidence supporting MPP receipts", query: "MPP receipts and payment verification" },
-  { label: "Explain Tempo session payments", query: "Tempo session payments and vouchers" },
-  { label: "Summarize machine vs human readership", query: "machine vs human read trends data chart" }
+  { label: "Find evidence on MPP receipts", query: "MPP receipts citations and sources" },
+  { label: "Chart the machine-vs-human shift", query: "machine vs human read share trends data chart" },
+  { label: "Use the explainer video + the thesis", query: "agentic economy explainer video and the metering thesis" }
 ];
+var ACTION_LABEL = { buy: "BUY", skip: "SKIP", block: "BLOCKED" };
 var esc2 = (s) => s.replace(/[&<>]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;" })[c]);
-var pct = (c) => `${Math.round(c * 100)}%`;
+var pct2 = (c) => `${Math.round(c * 100)}%`;
 function mountAgentConsole(instance, opts = {}) {
   injectStyles2();
   const tasks = opts.tasks ?? DEFAULT_AGENT_TASKS;
@@ -1460,7 +1552,7 @@ function mountAgentConsole(instance, opts = {}) {
     };
   });
   const p = instance.client.getPolicy();
-  policyEl.innerHTML = `<div class="nr-ac-pol-row"><span>Budget</span><strong>$${esc2(p.sessionBudget)}</strong></div><div class="nr-ac-pol-row"><span>Allowed</span><span class="nr-ac-allow">${p.allowedContentTypes.map((t) => esc2(t)).join(", ")}</span></div><div class="nr-ac-pol-row"><span>Blocked</span><span class="nr-ac-block-types">${p.blockedContentTypes.map((t) => esc2(t)).join(", ") || "\u2014"}</span></div>`;
+  policyEl.innerHTML = `<div class="nr-ac-pol-row"><span>Budget</span><strong>$${esc2(p.sessionBudget)}</strong></div><div class="nr-ac-pol-row"><span>Max per purchase</span><strong>$${esc2(p.maxSpendPerChunk)}</strong></div><div class="nr-ac-pol-row"><span>Allowed</span><span class="nr-ac-allow">${p.allowedContentTypes.map((t) => esc2(t)).join(", ")}</span></div><div class="nr-ac-pol-row"><span>Blocked</span><span class="nr-ac-block-types">${p.blockedContentTypes.map((t) => esc2(t)).join(", ") || "\u2014"}</span></div><div class="nr-ac-pol-row"><span>Min. relevance to buy</span><strong>${pct2(DEFAULT_CONFIDENCE_THRESHOLD)}</strong></div>`;
   const open = () => overlay.classList.add("open");
   const close = () => overlay.classList.remove("open");
   fab.onclick = open;
@@ -1497,7 +1589,7 @@ function mountAgentConsole(instance, opts = {}) {
           priceOf.set(m.chunkId, m.price);
         }
         discoveryEl.innerHTML = `<div class="nr-ac-label">Publisher Discovery Agent \u2014 found ${ev.matches.length} relevant paid chunk${ev.matches.length === 1 ? "" : "s"} (no premium content revealed)</div>` + (ev.matches.length ? ev.matches.map(
-          (m, i) => `<div class="nr-ac-disc"><span class="nr-ac-disc-n">${i + 1}</span><div class="nr-ac-disc-main"><b>${esc2(m.title)}</b><span class="nr-ac-disc-teaser">${esc2(m.teaser)}</span><span class="nr-ac-disc-tags">${m.tags.map((t) => `#${esc2(t)}`).join(" ")}</span></div><div class="nr-ac-disc-meta"><span class="nr-ac-type t-${m.type}">${esc2(m.type)}</span><span class="nr-ac-price">$${esc2(m.price)}</span><span class="nr-ac-conf">${pct(m.confidence)} match</span></div></div>`
+          (m, i) => `<div class="nr-ac-disc" data-cid="${esc2(m.chunkId)}"><div class="nr-ac-disc-top"><span class="nr-ac-disc-n">${i + 1}</span><div class="nr-ac-disc-main"><b>${esc2(m.title)}</b><span class="nr-ac-disc-teaser">${esc2(m.teaser)}</span><span class="nr-ac-disc-tags">${m.tags.map((t) => `#${esc2(t)}`).join(" ")}</span></div><div class="nr-ac-disc-meta"><span class="nr-ac-type t-${m.type}">${esc2(m.type)}</span><span class="nr-ac-price">$${esc2(m.price)}</span><span class="nr-ac-conf">${pct2(m.confidence)} match</span></div></div><div class="nr-ac-decision" data-decision="${esc2(m.chunkId)}"><span class="nr-ac-dec-wait">deciding\u2026</span></div></div>`
         ).join("") : '<div class="nr-ac-empty">No relevant paid content \u2014 the agent will not spend.</div>');
         row("found", `<span class="nr-ac-dot"></span> Found <strong>${ev.matches.length}</strong> purchasable chunk${ev.matches.length === 1 ? "" : "s"}`);
       } else if (ev.phase === "plan") {
@@ -1506,18 +1598,20 @@ function mountAgentConsole(instance, opts = {}) {
           priceOf.set(it.chunkId, it.price);
         }
         row("eval", `<span class="nr-ac-dot"></span> Evaluating relevance, price &amp; policy\u2026`);
+        annotateDecisions(discoveryEl, ev.plan);
       } else if (ev.phase === "chunk-start") {
-        if (ev.item.action === "buy") row("buy", `<span class="nr-ac-dot"></span> Purchasing <b>${esc2(ev.item.title)}</b> <span class="nr-ac-cost">$${esc2(ev.item.price)}</span>\u2026`);
+        if (ev.item.action === "buy") row("buy", `<span class="nr-ac-dot"></span> Policy \u2713 \u2014 authorizing <b>${esc2(ev.item.title)}</b> <span class="nr-ac-cost">$${esc2(ev.item.price)}</span>\u2026`);
       } else if (ev.phase === "bought") {
-        row("receipt", `<span class="nr-ac-dot ok"></span> Receipt issued \xB7 <code>${esc2(ev.receiptId)}</code>`);
+        row("receipt", `<span class="nr-ac-dot ok"></span> Voucher authorized \xB7 receipt <code>${esc2(ev.receiptId)}</code>`);
+        row("unlock", `<span class="nr-ac-dot ok"></span> Content unlocked`);
       } else if (ev.phase === "blocked") {
-        row("blocked", `<span class="nr-ac-dot no"></span> Skipped <b>${esc2(titleOf.get(ev.chunkId) ?? ev.chunkId)}</b> \u2014 ${esc2(ev.reason)}`);
+        row("blocked", `<span class="nr-ac-dot no"></span> Blocked <b>${esc2(titleOf.get(ev.chunkId) ?? ev.chunkId)}</b> \u2014 ${esc2(ev.reason)}`);
       } else if (ev.phase === "skipped") {
-        row("skip", `<span class="nr-ac-dot"></span> Skipped <b>${esc2(titleOf.get(ev.chunkId) ?? ev.chunkId)}</b> \u2014 not relevant to the task`);
+        row("skip", `<span class="nr-ac-dot"></span> Skipped <b>${esc2(titleOf.get(ev.chunkId) ?? ev.chunkId)}</b> \u2014 ${esc2(ev.reason)}`);
       } else if (ev.phase === "done") {
-        row("gen", `<span class="nr-ac-dot"></span> Generating answer\u2026`);
+        row("gen", `<span class="nr-ac-dot"></span> Generating answer from purchased content\u2026`);
         row("done", `<span class="nr-ac-dot ok"></span> Done`);
-        renderOutput(outputEl, ev.result.purchased, ev.result.receiptIds, ev.result.totalCost);
+        renderOutput(outputEl, ev.result);
       }
     };
     try {
@@ -1530,9 +1624,29 @@ function mountAgentConsole(instance, opts = {}) {
   };
   return { open, close };
 }
-function renderOutput(el, purchased, receiptIds, totalCost) {
-  const sources = purchased.length ? purchased.map((s) => `<li>${esc2(s.title)} <span class="nr-ac-cost">$${esc2(s.price)}</span></li>`).join("") : '<li class="nr-ac-empty">None \u2014 nothing met the task + policy bar.</li>';
-  el.innerHTML = `<div class="nr-ac-out-h">Generated answer</div><div class="nr-ac-out-grid"><div><div class="nr-ac-out-label">Sources purchased</div><ul class="nr-ac-sources">${sources}</ul></div><div><div class="nr-ac-out-label">Receipts</div><div class="nr-ac-receipts">${receiptIds.map((r) => `<code>${esc2(r)}</code>`).join(" ") || "\u2014"}</div><div class="nr-ac-out-label" style="margin-top:12px">Total cost</div><div class="nr-ac-total">$${esc2(totalCost)}</div></div></div><div class="nr-ac-thesis">The agent discovered what was available, decided what was worth buying, and paid \u2014 on Tempo, with receipts.</div>`;
+function renderOutput(el, result) {
+  const { answer, purchased, totalCost } = result;
+  const sources = purchased.length ? purchased.map(
+    (s) => `<li><span class="nr-ac-src-title">${esc2(s.title)}</span><span class="nr-ac-cost">$${esc2(s.price)}</span><code>${esc2(s.receiptId)}</code></li>`
+  ).join("") : '<li class="nr-ac-empty">None \u2014 nothing met the task + policy bar.</li>';
+  el.innerHTML = `<div class="nr-ac-out-h">Generated answer <em>\u2014 grounded only in what the agent paid for</em></div><div class="nr-ac-answer">${esc2(answer)}</div><div class="nr-ac-out-foot"><div class="nr-ac-out-srcs"><div class="nr-ac-out-label">Purchased sources \xB7 receipts</div><ul class="nr-ac-sources">${sources}</ul></div><div class="nr-ac-out-total"><div class="nr-ac-out-label">Total cost</div><div class="nr-ac-total">$${esc2(totalCost)}</div></div></div><div class="nr-ac-thesis">The agent discovered what was available, decided what was worth buying, and paid \u2014 on Tempo, with receipts.</div>`;
+}
+function decisionHtml(item) {
+  return `<span class="nr-ac-dec-pill ${item.action}">${ACTION_LABEL[item.action]}</span><span class="nr-ac-dec-reason">${esc2(item.reason)}</span>`;
+}
+function annotateDecisions(container, plan) {
+  for (const item of plan) {
+    const slot = container.querySelector(`.nr-ac-decision[data-decision="${item.chunkId}"]`);
+    if (slot) {
+      slot.className = `nr-ac-decision act-${item.action}`;
+      slot.innerHTML = decisionHtml(item);
+    } else if (item.action === "block") {
+      const card = document.createElement("div");
+      card.className = "nr-ac-disc nr-ac-disc-extra";
+      card.innerHTML = `<div class="nr-ac-disc-top"><span class="nr-ac-disc-n no">\u26D4</span><div class="nr-ac-disc-main"><b>${esc2(item.title)}</b><span class="nr-ac-disc-teaser">Not offered by discovery \u2014 your policy blocks it before any purchase.</span></div><div class="nr-ac-disc-meta"><span class="nr-ac-type t-${item.type}">${esc2(item.type)}</span><span class="nr-ac-price">$${esc2(item.price)}</span></div></div><div class="nr-ac-decision act-block">${decisionHtml(item)}</div>`;
+      container.appendChild(card);
+    }
+  }
 }
 function markSvg(fill = "#FFC247") {
   return `<svg width="15" height="15" viewBox="0 0 64 64" style="vertical-align:-2px;flex:none"><g fill="${fill}"><circle cx="14" cy="12" r="4"/><circle cx="14" cy="22" r="4"/><circle cx="14" cy="32" r="4"/><circle cx="14" cy="42" r="4"/><circle cx="14" cy="52" r="4"/><circle cx="54" cy="12" r="4"/><circle cx="54" cy="22" r="4"/><circle cx="54" cy="42" r="4"/><circle cx="54" cy="52" r="4"/><circle cx="24" cy="22" r="4"/><circle cx="34" cy="32" r="4"/><circle cx="44" cy="42" r="4"/></g></svg>`;
@@ -1564,8 +1678,19 @@ function injectStyles2() {
   .nr-ac-run:disabled{opacity:.45;cursor:default}
   .nr-ac-run:not(:disabled):hover{background:#E2A12F}
   .nr-ac-block{margin-top:20px}
-  .nr-ac-disc{display:flex;gap:10px;align-items:flex-start;background:#0E0E0E;border:1px solid #1E1E1E;border-radius:10px;padding:11px 13px;margin-bottom:8px}
+  .nr-ac-disc{display:flex;flex-direction:column;gap:9px;background:#0E0E0E;border:1px solid #1E1E1E;border-radius:10px;padding:11px 13px;margin-bottom:8px}
+  .nr-ac-disc-top{display:flex;gap:10px;align-items:flex-start}
+  .nr-ac-disc.nr-ac-disc-extra{border-style:dashed;border-color:#3b1d1d}
   .nr-ac-disc-n{width:20px;height:20px;flex:none;border-radius:6px;background:#161616;color:#FFC247;font-family:ui-monospace,monospace;font-size:11px;display:flex;align-items:center;justify-content:center;font-weight:700}
+  .nr-ac-disc-n.no{background:#3b1d1d;color:#fca5a5}
+  .nr-ac-decision{display:flex;align-items:center;gap:9px;border-top:1px dashed #1E1E1E;padding-top:8px}
+  .nr-ac-dec-wait{color:#6E6E6E;font-size:11px;font-family:ui-monospace,monospace}
+  .nr-ac-dec-pill{font-size:10px;font-weight:800;letter-spacing:.5px;padding:2px 8px;border-radius:6px;flex:none}
+  .nr-ac-dec-pill.buy{background:#14321f;color:#86efac}
+  .nr-ac-dec-pill.skip{background:#262626;color:#C4C4C4}
+  .nr-ac-dec-pill.block{background:#3b1d1d;color:#fca5a5}
+  .nr-ac-dec-reason{font-size:12px;color:#9A9A9A}
+  .nr-ac-decision.act-buy .nr-ac-dec-reason{color:#86efac}
   .nr-ac-disc-main{flex:1;display:flex;flex-direction:column;gap:2px;min-width:0}
   .nr-ac-disc-main b{font-size:14px}
   .nr-ac-disc-teaser{color:#9A9A9A;font-size:12px}
@@ -1586,14 +1711,19 @@ function injectStyles2() {
   .nr-ac-tl.buy{color:#EDEDED}.nr-ac-tl.blocked{color:#fca5a5}
   .nr-ac-output{background:linear-gradient(180deg,#0E0E0E,#0B0B0B);border:1px solid #FFC247;border-radius:12px;padding:16px 18px}
   .nr-ac-out-h{font-weight:800;color:#FFC247;margin-bottom:12px}
-  .nr-ac-out-grid{display:grid;grid-template-columns:1fr 1fr;gap:18px}
+  .nr-ac-out-h em{color:#8A8A8A;font-style:normal;font-weight:400;font-size:12px}
+  .nr-ac-answer{white-space:pre-wrap;font-size:13.5px;line-height:1.6;color:#E4E4E4;background:#0B0B0B;border:1px solid #1E1E1E;border-radius:10px;padding:13px 15px;margin-bottom:14px}
+  .nr-ac-out-foot{display:grid;grid-template-columns:1fr auto;gap:18px;align-items:start}
   .nr-ac-out-label{font-family:ui-monospace,monospace;font-size:11px;text-transform:uppercase;letter-spacing:.06em;color:#8A8A8A;margin-bottom:6px}
-  .nr-ac-sources{margin:0;padding-left:16px;font-size:13px}.nr-ac-sources li{margin:3px 0}
-  .nr-ac-receipts code{font-family:ui-monospace,monospace;font-size:11px;color:#FFC247;background:#161616;padding:1px 5px;border-radius:4px;margin-right:4px}
-  .nr-ac-total{font-family:ui-monospace,monospace;font-size:22px;font-weight:800;color:#FFC247}
+  .nr-ac-sources{list-style:none;margin:0;padding:0;font-size:13px}
+  .nr-ac-sources li{display:flex;align-items:center;gap:8px;margin:5px 0}
+  .nr-ac-src-title{flex:1;min-width:0;color:#EDEDED}
+  .nr-ac-sources code{font-family:ui-monospace,monospace;font-size:10.5px;color:#FFC247;background:#161616;padding:1px 6px;border-radius:4px}
+  .nr-ac-out-total{text-align:right}
+  .nr-ac-total{font-family:ui-monospace,monospace;font-size:24px;font-weight:800;color:#FFC247}
   .nr-ac-thesis{margin-top:14px;padding-top:12px;border-top:1px solid #1E1E1E;color:#9A9A9A;font-size:13px}
   .nr-ac-empty{color:#8A8A8A}
-  @media (max-width:560px){.nr-ac-out-grid{grid-template-columns:1fr}}
+  @media (max-width:560px){.nr-ac-out-foot{grid-template-columns:1fr}.nr-ac-out-total{text-align:left}}
   `;
   const style = document.createElement("style");
   style.id = "nr-ac-styles";
@@ -1609,20 +1739,20 @@ function initNanoRail(config = {}) {
   const widget = config.mountWidget === false ? void 0 : new NanoRailWidget(client);
   client.ensureSession().then(() => widget?.render());
   client.startSettlementWatch();
-  const buildAndRegister = async () => {
-    const m = generateManifest({ articleId });
-    if (m.chunks.length > 0) await client.registerManifest(m).catch(() => {
-    });
-    return m;
-  };
+  const registration = scanRegistration({ articleId });
+  const registered = registration.chunks.length > 0 ? client.registerArticle(registration).catch(() => void 0) : Promise.resolve(void 0);
   const instance = {
     client,
     widget,
     manifest: generateManifest({ articleId }),
+    registered,
     rescan: () => scanAndLock(client, document, { autoUnlock: config.autoUnlockOnScroll === true }),
     regenerateManifest: async () => {
-      instance.manifest = await buildAndRegister();
-      return instance.manifest;
+      const m = generateManifest({ articleId });
+      if (m.chunks.length > 0) await client.registerManifest(m).catch(() => {
+      });
+      instance.manifest = m;
+      return m;
     },
     runAgent: (opts) => runAgentSummary(client, articleId, opts),
     forceVideoRejection: async () => {
@@ -1633,9 +1763,6 @@ function initNanoRail(config = {}) {
     },
     unlockTempoSnippet: () => client.unlockTempoSnippet()
   };
-  buildAndRegister().then((m) => {
-    instance.manifest = m;
-  });
   if (config.autoScan !== false) {
     scanAndLock(client, document, { autoUnlock: config.autoUnlockOnScroll === true });
   }
@@ -1647,6 +1774,7 @@ function initNanoRail(config = {}) {
 }
 export {
   DEFAULT_AGENT_TASKS,
+  DEFAULT_CONFIDENCE_THRESHOLD,
   NanoRailClient,
   NanoRailEvents,
   NanoRailWidget,
@@ -1658,6 +1786,7 @@ export {
   renderContent,
   runAgentSummary,
   scanAndLock,
+  scanRegistration,
   shouldAutoUnlock
 };
 /*! Bundled license information:

package/dist/nanorail.js

@@ -596,6 +596,9 @@
       __publicField(this, "session");
       __publicField(this, "spentMicros", 0);
       __publicField(this, "receipts", []);
+      /** Content already unlocked this session, by chunkId — lets a re-run reuse what
+       *  was bought instead of re-paying (the gateway rejects duplicate payments). */
+      __publicField(this, "unlocked", /* @__PURE__ */ new Map());
       __publicField(this, "blocked", []);
       /** Chunk ids the user has manually approved (for amounts above the threshold). */
       __publicField(this, "approvals", /* @__PURE__ */ new Set());
@@ -641,6 +644,20 @@
       });
       return await res.json().catch(() => ({ ok: false }));
     }
+    /**
+     * Register the publisher's scanned chunks WITH their gated content. The gateway
+     * stores the content server-side and returns it only from a verified unlock;
+     * discovery/manifest expose only the metadata. This is what makes a real
+     * publisher's own content (not seeded demo content) the thing that unlocks.
+     */
+    async registerArticle(registration) {
+      const res = await this.fetchImpl(`${this.gatewayUrl}/api/articles/${registration.articleId}/register`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(registration)
+      });
+      return await res.json().catch(() => ({ ok: false }));
+    }
     /** Open a funded session once; concurrent callers share the same promise. */
     async ensureSession() {
       if (this.session) return this.session;
@@ -739,6 +756,7 @@
       }
       const out = await res.json();
       this.receipts.push(out.receipt);
+      this.unlocked.set(chunk.chunkId, { content: out.content, title: out.title });
       this.spentMicros = toMicros(out.session.spent);
       if (this.session) this.session.spentMicros = this.spentMicros;
       this.events.emit({
@@ -941,7 +959,7 @@
       const p = s.policy;
       const budgetMicros = toMicros(s.budget);
       const remaining = fromMicros(Math.max(0, budgetMicros - s.spent));
-      const pct2 = Math.min(100, Math.round(s.spent / Math.max(1, budgetMicros) * 100));
+      const pct3 = Math.min(100, Math.round(s.spent / Math.max(1, budgetMicros) * 100));
       if (this.collapsed) {
         this.root.className = "nr-widget nr-collapsed";
         this.root.innerHTML = `<button class="nr-w-fab" title="Agent Wallet">${nrMark("#0A0A0A", 14)} Agent Wallet \xB7 $${remaining}</button>`;
@@ -970,7 +988,7 @@
 
       <div class="nr-w-budget">
         <div class="nr-w-budget-top"><span class="nr-w-budget-label">Remaining today</span><span class="nr-w-budget-val">$${remaining}</span></div>
-        <div class="nr-w-bar"><i style="width:${pct2}%"></i></div>
+        <div class="nr-w-bar"><i style="width:${pct3}%"></i></div>
         <div class="nr-w-budget-foot"><span>Daily budget $${esc(s.budget)}</span><span>Spent $${fromMicros(s.spent)}</span></div>
       </div>
 
@@ -1302,11 +1320,40 @@
       chunks
     };
   }
+  function scanRegistration(opts = {}) {
+    const root = opts.root ?? document;
+    const els = Array.from(root.querySelectorAll("[data-nanorail-price]"));
+    const chunks = els.map((el) => {
+      const c = readChunk(el);
+      const content = (el.innerHTML || el.textContent || "").trim();
+      return {
+        chunkId: c.chunkId,
+        type: c.type,
+        title: c.title,
+        price: c.price,
+        currency: "USD",
+        recipient: c.recipient,
+        teaser: c.teaser ?? c.title,
+        tags: c.tags ?? [],
+        endpoints: {
+          challenge: `/api/chunks/${c.chunkId}/challenge`,
+          unlock: `/api/chunks/${c.chunkId}/unlock`
+        },
+        content
+      };
+    });
+    const articleId = opts.articleId ?? els[0]?.dataset.nanorailArticle ?? "unknown-article";
+    const publisherId = opts.publisherId ?? els[0]?.dataset.nanorailPublisher ?? "unknown-publisher";
+    const title = opts.title ?? (root instanceof Document ? root.querySelector("h1")?.textContent?.trim() : void 0) ?? (typeof document !== "undefined" ? document.title : void 0) ?? articleId;
+    return { publisherId, articleId, title, source: "sdk-scan", chunks };
+  }
 
   // src/agent.ts
   var DEFAULT_TASK = "Summarize MPP payments and receipts";
   var DEFAULT_QUERY = "MPP payments and receipts";
+  var DEFAULT_CONFIDENCE_THRESHOLD = 0.3;
   var sleep2 = (ms) => ms > 0 ? new Promise((r) => setTimeout(r, ms)) : Promise.resolve();
+  var pct = (x) => `${Math.round(x * 100)}%`;
   function descriptor(manifest, m) {
     return {
       chunkId: m.chunkId,
@@ -1326,6 +1373,7 @@
     const delay = opts.stepDelayMs ?? 0;
     const task = opts.task ?? DEFAULT_TASK;
     const query = opts.query ?? DEFAULT_QUERY;
+    const threshold = opts.confidenceThreshold ?? DEFAULT_CONFIDENCE_THRESHOLD;
     emit({ phase: "task", task, query });
     const manifest = await client.getManifest(articleId);
     const matches = await client.discover(articleId, query, "agent");
@@ -1336,13 +1384,17 @@
       const chunk = descriptor(manifest, m);
       const decision = client.evaluate(chunk);
       const confidence = confidenceById.get(m.chunkId);
+      const base = { chunkId: m.chunkId, type: m.type, title: m.title, price: m.price, confidence };
       if (!decision.allowed) {
-        return { chunkId: m.chunkId, type: m.type, title: m.title, price: m.price, action: "block", reason: decision.reason ?? "blocked by policy", confidence };
+        return { ...base, action: "block", reason: decision.reason ?? "blocked by policy" };
       }
-      if (confidence !== void 0) {
-        return { chunkId: m.chunkId, type: m.type, title: m.title, price: m.price, action: "buy", reason: `discovery match (confidence ${confidence})`, confidence };
+      if (confidence === void 0) {
+        return { ...base, action: "skip", reason: "not relevant to the task" };
       }
-      return { chunkId: m.chunkId, type: m.type, title: m.title, price: m.price, action: "skip", reason: "not surfaced by discovery" };
+      if (confidence < threshold) {
+        return { ...base, action: "skip", reason: `relevance ${pct(confidence)} below ${pct(threshold)} bar` };
+      }
+      return { ...base, action: "buy", reason: `relevance ${pct(confidence)} \xB7 within budget & allowed` };
     });
     emit({ phase: "plan", plan });
     await sleep2(delay);
@@ -1367,6 +1419,18 @@
         emit({ phase: "blocked", chunkId: item.chunkId, reason: item.reason });
         continue;
       }
+      const ownedReceipt = client.receipts.find((r) => r.chunkId === item.chunkId);
+      if (ownedReceipt) {
+        const cached = client.unlocked.get(item.chunkId);
+        receiptIds.push(ownedReceipt.receiptId);
+        purchased.push({ chunkId: item.chunkId, title: item.title, type: item.type, price: item.price, receiptId: ownedReceipt.receiptId });
+        totalMicros += toMicros(item.price);
+        if (item.type === "text" && cached?.content) boughtText.push(cached.content);
+        steps.push({ chunkId: item.chunkId, type: item.type, decision: "bought", receiptId: ownedReceipt.receiptId, content: cached?.content });
+        emit({ phase: "bought", chunkId: item.chunkId, receiptId: ownedReceipt.receiptId, content: cached?.content });
+        await sleep2(delay);
+        continue;
+      }
       const out = await client.unlock(chunk, { actor: "agent", viaDiscovery: true });
       if (out.ok && out.receipt) {
         receiptIds.push(out.receipt.receiptId);
@@ -1382,8 +1446,12 @@
       }
       await sleep2(delay);
     }
+    const skippedCount = plan.filter((p) => p.action === "skip").length;
+    const blockedItems = plan.filter((p) => p.action === "block");
+    const totalCost = fromMicros(totalMicros);
+    const answer = buildAnswer({ task, purchased, boughtText, skippedCount, blockedItems, totalCost });
     const summary = `Task: ${task}
-Discovered ${matches.length} relevant chunk(s); bought ${receiptIds.length}; skipped the rest; video blocked by policy.
+Discovered ${matches.length} relevant chunk(s); bought ${receiptIds.length}; skipped ${skippedCount}; blocked ${blockedItems.length} by policy.
 
 ` + boughtText.map((t) => `\u2022 ${t}`).join("\n\n") + `
 
@@ -1396,21 +1464,45 @@ Receipts: ${receiptIds.join(", ") || "none"}`;
       steps,
       receiptIds,
       purchased,
-      totalCost: fromMicros(totalMicros),
+      totalCost,
+      answer,
       summary
     };
     emit({ phase: "done", result });
     return result;
   }
+  function buildAnswer(args) {
+    const { task, purchased, boughtText, skippedCount, blockedItems, totalCost } = args;
+    if (purchased.length === 0) {
+      const why = blockedItems.length ? ` Policy blocked ${blockedItems.map((b) => b.title).join(", ")}.` : "";
+      return `The agent did not spend on \u201C${task}\u201D: nothing it discovered was both relevant enough and permitted by your policy.${why}`;
+    }
+    const lead = `Based on the ${purchased.length} source${purchased.length === 1 ? "" : "s"} the agent purchased for \u201C${task}\u201D:`;
+    const body = boughtText.length ? `
+
+${boughtText.join("\n\n")}` : "";
+    const support = purchased.filter((p) => p.type !== "text");
+    const supportLine = support.length ? `
+
+Supporting data purchased: ${support.map((p) => `${p.title} (${p.type.replace(/_/g, " ")})`).join("; ")}.` : "";
+    const decisions = [];
+    if (skippedCount > 0) decisions.push(`skipped ${skippedCount} less-relevant section${skippedCount === 1 ? "" : "s"}`);
+    if (blockedItems.length > 0) decisions.push(`was blocked by your policy from buying ${blockedItems.map((b) => b.title).join(", ")}`);
+    const decisionLine = decisions.length ? ` The agent ${decisions.join(", and ")}.` : "";
+    return `${lead}${body}${supportLine}
+
+Total spend: $${totalCost} across ${purchased.length} receipt${purchased.length === 1 ? "" : "s"}.${decisionLine}`;
+  }
 
   // src/agent-console.ts
   var DEFAULT_AGENT_TASKS = [
-    { label: "Find evidence supporting MPP receipts", query: "MPP receipts and payment verification" },
-    { label: "Explain Tempo session payments", query: "Tempo session payments and vouchers" },
-    { label: "Summarize machine vs human readership", query: "machine vs human read trends data chart" }
+    { label: "Find evidence on MPP receipts", query: "MPP receipts citations and sources" },
+    { label: "Chart the machine-vs-human shift", query: "machine vs human read share trends data chart" },
+    { label: "Use the explainer video + the thesis", query: "agentic economy explainer video and the metering thesis" }
   ];
+  var ACTION_LABEL = { buy: "BUY", skip: "SKIP", block: "BLOCKED" };
   var esc2 = (s) => s.replace(/[&<>]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;" })[c]);
-  var pct = (c) => `${Math.round(c * 100)}%`;
+  var pct2 = (c) => `${Math.round(c * 100)}%`;
   function mountAgentConsole(instance, opts = {}) {
     injectStyles2();
     const tasks = opts.tasks ?? DEFAULT_AGENT_TASKS;
@@ -1462,7 +1554,7 @@ Receipts: ${receiptIds.join(", ") || "none"}`;
       };
     });
     const p = instance.client.getPolicy();
-    policyEl.innerHTML = `<div class="nr-ac-pol-row"><span>Budget</span><strong>$${esc2(p.sessionBudget)}</strong></div><div class="nr-ac-pol-row"><span>Allowed</span><span class="nr-ac-allow">${p.allowedContentTypes.map((t) => esc2(t)).join(", ")}</span></div><div class="nr-ac-pol-row"><span>Blocked</span><span class="nr-ac-block-types">${p.blockedContentTypes.map((t) => esc2(t)).join(", ") || "\u2014"}</span></div>`;
+    policyEl.innerHTML = `<div class="nr-ac-pol-row"><span>Budget</span><strong>$${esc2(p.sessionBudget)}</strong></div><div class="nr-ac-pol-row"><span>Max per purchase</span><strong>$${esc2(p.maxSpendPerChunk)}</strong></div><div class="nr-ac-pol-row"><span>Allowed</span><span class="nr-ac-allow">${p.allowedContentTypes.map((t) => esc2(t)).join(", ")}</span></div><div class="nr-ac-pol-row"><span>Blocked</span><span class="nr-ac-block-types">${p.blockedContentTypes.map((t) => esc2(t)).join(", ") || "\u2014"}</span></div><div class="nr-ac-pol-row"><span>Min. relevance to buy</span><strong>${pct2(DEFAULT_CONFIDENCE_THRESHOLD)}</strong></div>`;
     const open = () => overlay.classList.add("open");
     const close = () => overlay.classList.remove("open");
     fab.onclick = open;
@@ -1499,7 +1591,7 @@ Receipts: ${receiptIds.join(", ") || "none"}`;
             priceOf.set(m.chunkId, m.price);
           }
           discoveryEl.innerHTML = `<div class="nr-ac-label">Publisher Discovery Agent \u2014 found ${ev.matches.length} relevant paid chunk${ev.matches.length === 1 ? "" : "s"} (no premium content revealed)</div>` + (ev.matches.length ? ev.matches.map(
-            (m, i) => `<div class="nr-ac-disc"><span class="nr-ac-disc-n">${i + 1}</span><div class="nr-ac-disc-main"><b>${esc2(m.title)}</b><span class="nr-ac-disc-teaser">${esc2(m.teaser)}</span><span class="nr-ac-disc-tags">${m.tags.map((t) => `#${esc2(t)}`).join(" ")}</span></div><div class="nr-ac-disc-meta"><span class="nr-ac-type t-${m.type}">${esc2(m.type)}</span><span class="nr-ac-price">$${esc2(m.price)}</span><span class="nr-ac-conf">${pct(m.confidence)} match</span></div></div>`
+            (m, i) => `<div class="nr-ac-disc" data-cid="${esc2(m.chunkId)}"><div class="nr-ac-disc-top"><span class="nr-ac-disc-n">${i + 1}</span><div class="nr-ac-disc-main"><b>${esc2(m.title)}</b><span class="nr-ac-disc-teaser">${esc2(m.teaser)}</span><span class="nr-ac-disc-tags">${m.tags.map((t) => `#${esc2(t)}`).join(" ")}</span></div><div class="nr-ac-disc-meta"><span class="nr-ac-type t-${m.type}">${esc2(m.type)}</span><span class="nr-ac-price">$${esc2(m.price)}</span><span class="nr-ac-conf">${pct2(m.confidence)} match</span></div></div><div class="nr-ac-decision" data-decision="${esc2(m.chunkId)}"><span class="nr-ac-dec-wait">deciding\u2026</span></div></div>`
           ).join("") : '<div class="nr-ac-empty">No relevant paid content \u2014 the agent will not spend.</div>');
           row("found", `<span class="nr-ac-dot"></span> Found <strong>${ev.matches.length}</strong> purchasable chunk${ev.matches.length === 1 ? "" : "s"}`);
         } else if (ev.phase === "plan") {
@@ -1508,18 +1600,20 @@ Receipts: ${receiptIds.join(", ") || "none"}`;
             priceOf.set(it.chunkId, it.price);
           }
           row("eval", `<span class="nr-ac-dot"></span> Evaluating relevance, price &amp; policy\u2026`);
+          annotateDecisions(discoveryEl, ev.plan);
         } else if (ev.phase === "chunk-start") {
-          if (ev.item.action === "buy") row("buy", `<span class="nr-ac-dot"></span> Purchasing <b>${esc2(ev.item.title)}</b> <span class="nr-ac-cost">$${esc2(ev.item.price)}</span>\u2026`);
+          if (ev.item.action === "buy") row("buy", `<span class="nr-ac-dot"></span> Policy \u2713 \u2014 authorizing <b>${esc2(ev.item.title)}</b> <span class="nr-ac-cost">$${esc2(ev.item.price)}</span>\u2026`);
         } else if (ev.phase === "bought") {
-          row("receipt", `<span class="nr-ac-dot ok"></span> Receipt issued \xB7 <code>${esc2(ev.receiptId)}</code>`);
+          row("receipt", `<span class="nr-ac-dot ok"></span> Voucher authorized \xB7 receipt <code>${esc2(ev.receiptId)}</code>`);
+          row("unlock", `<span class="nr-ac-dot ok"></span> Content unlocked`);
         } else if (ev.phase === "blocked") {
-          row("blocked", `<span class="nr-ac-dot no"></span> Skipped <b>${esc2(titleOf.get(ev.chunkId) ?? ev.chunkId)}</b> \u2014 ${esc2(ev.reason)}`);
+          row("blocked", `<span class="nr-ac-dot no"></span> Blocked <b>${esc2(titleOf.get(ev.chunkId) ?? ev.chunkId)}</b> \u2014 ${esc2(ev.reason)}`);
         } else if (ev.phase === "skipped") {
-          row("skip", `<span class="nr-ac-dot"></span> Skipped <b>${esc2(titleOf.get(ev.chunkId) ?? ev.chunkId)}</b> \u2014 not relevant to the task`);
+          row("skip", `<span class="nr-ac-dot"></span> Skipped <b>${esc2(titleOf.get(ev.chunkId) ?? ev.chunkId)}</b> \u2014 ${esc2(ev.reason)}`);
         } else if (ev.phase === "done") {
-          row("gen", `<span class="nr-ac-dot"></span> Generating answer\u2026`);
+          row("gen", `<span class="nr-ac-dot"></span> Generating answer from purchased content\u2026`);
           row("done", `<span class="nr-ac-dot ok"></span> Done`);
-          renderOutput(outputEl, ev.result.purchased, ev.result.receiptIds, ev.result.totalCost);
+          renderOutput(outputEl, ev.result);
         }
       };
       try {
@@ -1532,9 +1626,29 @@ Receipts: ${receiptIds.join(", ") || "none"}`;
     };
     return { open, close };
   }
-  function renderOutput(el, purchased, receiptIds, totalCost) {
-    const sources = purchased.length ? purchased.map((s) => `<li>${esc2(s.title)} <span class="nr-ac-cost">$${esc2(s.price)}</span></li>`).join("") : '<li class="nr-ac-empty">None \u2014 nothing met the task + policy bar.</li>';
-    el.innerHTML = `<div class="nr-ac-out-h">Generated answer</div><div class="nr-ac-out-grid"><div><div class="nr-ac-out-label">Sources purchased</div><ul class="nr-ac-sources">${sources}</ul></div><div><div class="nr-ac-out-label">Receipts</div><div class="nr-ac-receipts">${receiptIds.map((r) => `<code>${esc2(r)}</code>`).join(" ") || "\u2014"}</div><div class="nr-ac-out-label" style="margin-top:12px">Total cost</div><div class="nr-ac-total">$${esc2(totalCost)}</div></div></div><div class="nr-ac-thesis">The agent discovered what was available, decided what was worth buying, and paid \u2014 on Tempo, with receipts.</div>`;
+  function renderOutput(el, result) {
+    const { answer, purchased, totalCost } = result;
+    const sources = purchased.length ? purchased.map(
+      (s) => `<li><span class="nr-ac-src-title">${esc2(s.title)}</span><span class="nr-ac-cost">$${esc2(s.price)}</span><code>${esc2(s.receiptId)}</code></li>`
+    ).join("") : '<li class="nr-ac-empty">None \u2014 nothing met the task + policy bar.</li>';
+    el.innerHTML = `<div class="nr-ac-out-h">Generated answer <em>\u2014 grounded only in what the agent paid for</em></div><div class="nr-ac-answer">${esc2(answer)}</div><div class="nr-ac-out-foot"><div class="nr-ac-out-srcs"><div class="nr-ac-out-label">Purchased sources \xB7 receipts</div><ul class="nr-ac-sources">${sources}</ul></div><div class="nr-ac-out-total"><div class="nr-ac-out-label">Total cost</div><div class="nr-ac-total">$${esc2(totalCost)}</div></div></div><div class="nr-ac-thesis">The agent discovered what was available, decided what was worth buying, and paid \u2014 on Tempo, with receipts.</div>`;
+  }
+  function decisionHtml(item) {
+    return `<span class="nr-ac-dec-pill ${item.action}">${ACTION_LABEL[item.action]}</span><span class="nr-ac-dec-reason">${esc2(item.reason)}</span>`;
+  }
+  function annotateDecisions(container, plan) {
+    for (const item of plan) {
+      const slot = container.querySelector(`.nr-ac-decision[data-decision="${item.chunkId}"]`);
+      if (slot) {
+        slot.className = `nr-ac-decision act-${item.action}`;
+        slot.innerHTML = decisionHtml(item);
+      } else if (item.action === "block") {
+        const card = document.createElement("div");
+        card.className = "nr-ac-disc nr-ac-disc-extra";
+        card.innerHTML = `<div class="nr-ac-disc-top"><span class="nr-ac-disc-n no">\u26D4</span><div class="nr-ac-disc-main"><b>${esc2(item.title)}</b><span class="nr-ac-disc-teaser">Not offered by discovery \u2014 your policy blocks it before any purchase.</span></div><div class="nr-ac-disc-meta"><span class="nr-ac-type t-${item.type}">${esc2(item.type)}</span><span class="nr-ac-price">$${esc2(item.price)}</span></div></div><div class="nr-ac-decision act-block">${decisionHtml(item)}</div>`;
+        container.appendChild(card);
+      }
+    }
   }
   function markSvg(fill = "#FFC247") {
     return `<svg width="15" height="15" viewBox="0 0 64 64" style="vertical-align:-2px;flex:none"><g fill="${fill}"><circle cx="14" cy="12" r="4"/><circle cx="14" cy="22" r="4"/><circle cx="14" cy="32" r="4"/><circle cx="14" cy="42" r="4"/><circle cx="14" cy="52" r="4"/><circle cx="54" cy="12" r="4"/><circle cx="54" cy="22" r="4"/><circle cx="54" cy="42" r="4"/><circle cx="54" cy="52" r="4"/><circle cx="24" cy="22" r="4"/><circle cx="34" cy="32" r="4"/><circle cx="44" cy="42" r="4"/></g></svg>`;
@@ -1566,8 +1680,19 @@ Receipts: ${receiptIds.join(", ") || "none"}`;
   .nr-ac-run:disabled{opacity:.45;cursor:default}
   .nr-ac-run:not(:disabled):hover{background:#E2A12F}
   .nr-ac-block{margin-top:20px}
-  .nr-ac-disc{display:flex;gap:10px;align-items:flex-start;background:#0E0E0E;border:1px solid #1E1E1E;border-radius:10px;padding:11px 13px;margin-bottom:8px}
+  .nr-ac-disc{display:flex;flex-direction:column;gap:9px;background:#0E0E0E;border:1px solid #1E1E1E;border-radius:10px;padding:11px 13px;margin-bottom:8px}
+  .nr-ac-disc-top{display:flex;gap:10px;align-items:flex-start}
+  .nr-ac-disc.nr-ac-disc-extra{border-style:dashed;border-color:#3b1d1d}
   .nr-ac-disc-n{width:20px;height:20px;flex:none;border-radius:6px;background:#161616;color:#FFC247;font-family:ui-monospace,monospace;font-size:11px;display:flex;align-items:center;justify-content:center;font-weight:700}
+  .nr-ac-disc-n.no{background:#3b1d1d;color:#fca5a5}
+  .nr-ac-decision{display:flex;align-items:center;gap:9px;border-top:1px dashed #1E1E1E;padding-top:8px}
+  .nr-ac-dec-wait{color:#6E6E6E;font-size:11px;font-family:ui-monospace,monospace}
+  .nr-ac-dec-pill{font-size:10px;font-weight:800;letter-spacing:.5px;padding:2px 8px;border-radius:6px;flex:none}
+  .nr-ac-dec-pill.buy{background:#14321f;color:#86efac}
+  .nr-ac-dec-pill.skip{background:#262626;color:#C4C4C4}
+  .nr-ac-dec-pill.block{background:#3b1d1d;color:#fca5a5}
+  .nr-ac-dec-reason{font-size:12px;color:#9A9A9A}
+  .nr-ac-decision.act-buy .nr-ac-dec-reason{color:#86efac}
   .nr-ac-disc-main{flex:1;display:flex;flex-direction:column;gap:2px;min-width:0}
   .nr-ac-disc-main b{font-size:14px}
   .nr-ac-disc-teaser{color:#9A9A9A;font-size:12px}
@@ -1588,14 +1713,19 @@ Receipts: ${receiptIds.join(", ") || "none"}`;
   .nr-ac-tl.buy{color:#EDEDED}.nr-ac-tl.blocked{color:#fca5a5}
   .nr-ac-output{background:linear-gradient(180deg,#0E0E0E,#0B0B0B);border:1px solid #FFC247;border-radius:12px;padding:16px 18px}
   .nr-ac-out-h{font-weight:800;color:#FFC247;margin-bottom:12px}
-  .nr-ac-out-grid{display:grid;grid-template-columns:1fr 1fr;gap:18px}
+  .nr-ac-out-h em{color:#8A8A8A;font-style:normal;font-weight:400;font-size:12px}
+  .nr-ac-answer{white-space:pre-wrap;font-size:13.5px;line-height:1.6;color:#E4E4E4;background:#0B0B0B;border:1px solid #1E1E1E;border-radius:10px;padding:13px 15px;margin-bottom:14px}
+  .nr-ac-out-foot{display:grid;grid-template-columns:1fr auto;gap:18px;align-items:start}
   .nr-ac-out-label{font-family:ui-monospace,monospace;font-size:11px;text-transform:uppercase;letter-spacing:.06em;color:#8A8A8A;margin-bottom:6px}
-  .nr-ac-sources{margin:0;padding-left:16px;font-size:13px}.nr-ac-sources li{margin:3px 0}
-  .nr-ac-receipts code{font-family:ui-monospace,monospace;font-size:11px;color:#FFC247;background:#161616;padding:1px 5px;border-radius:4px;margin-right:4px}
-  .nr-ac-total{font-family:ui-monospace,monospace;font-size:22px;font-weight:800;color:#FFC247}
+  .nr-ac-sources{list-style:none;margin:0;padding:0;font-size:13px}
+  .nr-ac-sources li{display:flex;align-items:center;gap:8px;margin:5px 0}
+  .nr-ac-src-title{flex:1;min-width:0;color:#EDEDED}
+  .nr-ac-sources code{font-family:ui-monospace,monospace;font-size:10.5px;color:#FFC247;background:#161616;padding:1px 6px;border-radius:4px}
+  .nr-ac-out-total{text-align:right}
+  .nr-ac-total{font-family:ui-monospace,monospace;font-size:24px;font-weight:800;color:#FFC247}
   .nr-ac-thesis{margin-top:14px;padding-top:12px;border-top:1px solid #1E1E1E;color:#9A9A9A;font-size:13px}
   .nr-ac-empty{color:#8A8A8A}
-  @media (max-width:560px){.nr-ac-out-grid{grid-template-columns:1fr}}
+  @media (max-width:560px){.nr-ac-out-foot{grid-template-columns:1fr}.nr-ac-out-total{text-align:left}}
   `;
     const style = document.createElement("style");
     style.id = "nr-ac-styles";
@@ -1611,20 +1741,20 @@ Receipts: ${receiptIds.join(", ") || "none"}`;
     const widget = config.mountWidget === false ? void 0 : new NanoRailWidget(client);
     client.ensureSession().then(() => widget?.render());
     client.startSettlementWatch();
-    const buildAndRegister = async () => {
-      const m = generateManifest({ articleId });
-      if (m.chunks.length > 0) await client.registerManifest(m).catch(() => {
-      });
-      return m;
-    };
+    const registration = scanRegistration({ articleId });
+    const registered = registration.chunks.length > 0 ? client.registerArticle(registration).catch(() => void 0) : Promise.resolve(void 0);
     const instance = {
       client,
       widget,
       manifest: generateManifest({ articleId }),
+      registered,
       rescan: () => scanAndLock(client, document, { autoUnlock: config.autoUnlockOnScroll === true }),
       regenerateManifest: async () => {
-        instance.manifest = await buildAndRegister();
-        return instance.manifest;
+        const m = generateManifest({ articleId });
+        if (m.chunks.length > 0) await client.registerManifest(m).catch(() => {
+        });
+        instance.manifest = m;
+        return m;
       },
       runAgent: (opts) => runAgentSummary(client, articleId, opts),
       forceVideoRejection: async () => {
@@ -1635,9 +1765,6 @@ Receipts: ${receiptIds.join(", ") || "none"}`;
       },
       unlockTempoSnippet: () => client.unlockTempoSnippet()
     };
-    buildAndRegister().then((m) => {
-      instance.manifest = m;
-    });
     if (config.autoScan !== false) {
       scanAndLock(client, document, { autoUnlock: config.autoUnlockOnScroll === true });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanorail/sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MPP-native metering SDK: turn data-nanorail-* attributes into agent-readable, policy-bounded paid content chunks with discovery, receipts, and Tempo settlement.",
   "license": "MIT",
   "author": "NanoRail",