@twin3-ai/agent-id 0.3.17 → 0.3.18

package/bin/agent-id.js

@@ -1517,7 +1517,7 @@ async function runCli(argv) {
       "  agent-id site-key-recovery-complete <url> --challenge <id> --capability-file <secret-file> --key-out <secret-file>",
       "  agent-id site-key-rotate <url> --key-file <secret-file> --key-out <secret-file> --approve",
       "  agent-id install-guide <url>",
-      "  agent-id install <url> [--modules identity,audit,measurement,optimization,automation] [--grant identity_publish,public_read,telemetry_submit,insights_read,ai_files_write] [--project-root <dir>] [--public-root <dir>] [--apply]",
+      "  agent-id install <url> [--modules identity,audit,measurement,optimization,automation] [--grant identity_publish,public_read,telemetry_submit,insights_read,ai_files_write] [--environment production|staging] [--method well_known|dns_txt|html_meta] [--project-root <dir>] [--public-root <dir>] [--apply]",
       "  agent-id install-resume [--project-root <dir>]",
       "  agent-id install-uninstall [--project-root <dir>] --approve",
       "  agent-id enterprise-enroll <url> [--environment production|staging] [--method well_known|dns_txt|html_meta] [--project-root <dir>]",
@@ -2196,7 +2196,7 @@ async function runCli(argv) {
     const keyIdx = argv.indexOf("--key");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "insights",
       audit_url: argv.includes("--audit")
     }));
@@ -2209,7 +2209,7 @@ async function runCli(argv) {
     const a2CitationPackage = readJsonFlag(argv, "--a2-package") || readJsonFlag(argv, "--citation-package");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "insights_feed",
       audit_url: argv.includes("--audit"),
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
@@ -2226,7 +2226,7 @@ async function runCli(argv) {
     const a2CitationPackage = readJsonFlag(argv, "--a2-package") || readJsonFlag(argv, "--citation-package");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "refresh_insight_inbox",
       audit_url: argv.includes("--audit"),
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
@@ -2239,7 +2239,7 @@ async function runCli(argv) {
     const keyIdx = argv.indexOf("--key");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "insight_inbox",
       include_acknowledged: argv.includes("--all") || argv.includes("--include-acknowledged")
     }));
@@ -2248,7 +2248,7 @@ async function runCli(argv) {
     const keyIdx = argv.indexOf("--key");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "acknowledge_insight",
       item_id: argv[2] || ""
     }));
@@ -2261,7 +2261,7 @@ async function runCli(argv) {
     const a2CitationPackage = readJsonFlag(argv, "--a2-package") || readJsonFlag(argv, "--citation-package");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "apply_plan",
       audit_url: argv.includes("--audit"),
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
@@ -2278,7 +2278,7 @@ async function runCli(argv) {
     const evidence = evidenceIdx >= 0 ? JSON.parse(fs.readFileSync(argv[evidenceIdx + 1], "utf8")) : undefined;
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "apply_evidence",
       apply_item_id: argv[2],
       evidence_uri: uriIdx >= 0 ? argv[uriIdx + 1] : "",
@@ -2291,7 +2291,7 @@ async function runCli(argv) {
     const keyIdx = argv.indexOf("--key");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "outcome_report"
     }));
   }
@@ -2299,7 +2299,7 @@ async function runCli(argv) {
     const keyIdx = argv.indexOf("--key");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "m1_outcome_evidence_package"
     }));
   }
@@ -2313,7 +2313,7 @@ async function runCli(argv) {
     const a2CitationPackage = readJsonFlag(argv, "--a2-package") || readJsonFlag(argv, "--citation-package");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "m2_monthly_optimization_package",
       audit_url: argv.includes("--audit"),
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
@@ -2334,7 +2334,7 @@ async function runCli(argv) {
     const a2CitationPackage = readJsonFlag(argv, "--a2-package") || readJsonFlag(argv, "--citation-package");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "m3_monthly_execution_tracker",
       audit_url: argv.includes("--audit"),
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
@@ -2355,7 +2355,7 @@ async function runCli(argv) {
     const a2CitationPackage = readJsonFlag(argv, "--a2-package") || readJsonFlag(argv, "--citation-package");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "m4_monthly_outcome_scorecard",
       audit_url: argv.includes("--audit"),
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
@@ -2376,7 +2376,7 @@ async function runCli(argv) {
     const a2CitationPackage = readJsonFlag(argv, "--a2-package") || readJsonFlag(argv, "--citation-package");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "m5_monthly_dashboard",
       audit_url: argv.includes("--audit"),
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
@@ -2397,7 +2397,7 @@ async function runCli(argv) {
     const a2CitationPackage = readJsonFlag(argv, "--a2-package") || readJsonFlag(argv, "--citation-package");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "monthly_evidence_loop",
       audit_url: argv.includes("--audit"),
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
@@ -2412,7 +2412,7 @@ async function runCli(argv) {
     const keyIdx = argv.indexOf("--key");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "optimization_cycle",
       audit_url: argv.includes("--audit")
     }));
@@ -2421,7 +2421,7 @@ async function runCli(argv) {
     const keyIdx = argv.indexOf("--key");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "audit_file_package",
       audit_url: argv.includes("--audit")
     }));
@@ -2430,7 +2430,7 @@ async function runCli(argv) {
     const keyIdx = argv.indexOf("--key");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "skill_package"
     }));
   }
@@ -2438,7 +2438,7 @@ async function runCli(argv) {
     const keyIdx = argv.indexOf("--key");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "implementation_bundle",
       audit_url: argv.includes("--audit")
     }));
@@ -2447,7 +2447,7 @@ async function runCli(argv) {
     const keyIdx = argv.indexOf("--key");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "install_descriptor"
     }));
   }
@@ -2455,7 +2455,7 @@ async function runCli(argv) {
     const keyIdx = argv.indexOf("--key");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "installation_verification",
       audit_url: argv.includes("--audit")
     }));
@@ -2467,7 +2467,7 @@ async function runCli(argv) {
     const competitorIdx = argv.indexOf("--competitor");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "content_optimization_plan",
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
       questions: questionIdx >= 0 ? [argv[questionIdx + 1]] : [],
@@ -2483,7 +2483,7 @@ async function runCli(argv) {
     const engineIdx = argv.indexOf("--engine");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "content_workflow_package",
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
       questions: questionIdx >= 0 ? [argv[questionIdx + 1]] : [],
@@ -2502,7 +2502,7 @@ async function runCli(argv) {
     const publishedItems = evidenceIdx >= 0 ? JSON.parse(fs.readFileSync(argv[evidenceIdx + 1], "utf8")) : [];
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "content_pack",
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
       questions: questionIdx >= 0 ? [argv[questionIdx + 1]] : [],
@@ -2521,7 +2521,7 @@ async function runCli(argv) {
     const reviewGate = reviewGateIdx >= 0 ? JSON.parse(fs.readFileSync(argv[reviewGateIdx + 1], "utf8")) : undefined;
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "content_repair_pack",
       ...(reviewGate ? { review_gate: reviewGate } : {}),
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
@@ -2534,7 +2534,7 @@ async function runCli(argv) {
     const publishedItems = evidenceIdx >= 0 ? JSON.parse(fs.readFileSync(argv[evidenceIdx + 1], "utf8")) : [];
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "content_publication_package",
       published_items: publishedItems,
       audit_url: argv.includes("--audit"),
@@ -2548,7 +2548,7 @@ async function runCli(argv) {
     const competitorIdx = argv.indexOf("--competitor");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "citation_gap_matrix",
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
       questions: questionIdx >= 0 ? [argv[questionIdx + 1]] : [],
@@ -2563,7 +2563,7 @@ async function runCli(argv) {
     const competitorIdx = argv.indexOf("--competitor");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "community_citation_plan",
       content: contentIdx >= 0 ? argv[contentIdx + 1] : "",
       questions: questionIdx >= 0 ? [argv[questionIdx + 1]] : [],
@@ -2580,7 +2580,7 @@ async function runCli(argv) {
     const marketIdx = argv.indexOf("--market");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "prompt_test_run_sheet",
       questions: questionIdx >= 0 ? [argv[questionIdx + 1]] : [],
       topics: topicIdx >= 0 ? [argv[topicIdx + 1]] : [],
@@ -2596,7 +2596,7 @@ async function runCli(argv) {
     return print(await post("/api/site_agents/call", {
       ...payload,
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "prompt_test_results"
     }));
   }
@@ -2606,7 +2606,7 @@ async function runCli(argv) {
     const events = eventsIdx >= 0 ? JSON.parse(fs.readFileSync(argv[eventsIdx + 1], "utf8")) : [];
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "b1_conversion_evidence_package",
       events
     }));
@@ -2618,7 +2618,7 @@ async function runCli(argv) {
     const evaluatorIdx = argv.indexOf("--evaluator");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "job_drafts",
       currency: currencyIdx >= 0 ? argv[currencyIdx + 1] : undefined,
       provider: providerIdx >= 0 ? argv[providerIdx + 1] : undefined,
@@ -2631,7 +2631,7 @@ async function runCli(argv) {
     const draft = JSON.parse(fs.readFileSync(argv[2], "utf8"));
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "accept_job_draft",
       draft
     }));
@@ -2644,7 +2644,7 @@ async function runCli(argv) {
     const draft = argv[2] && !argv[2].startsWith("--") ? JSON.parse(fs.readFileSync(argv[2], "utf8")) : undefined;
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "decide_job_draft",
       decision: decisionIdx >= 0 ? argv[decisionIdx + 1] : "defer",
       draft,
@@ -2658,7 +2658,7 @@ async function runCli(argv) {
     const draftIdIdx = argv.indexOf("--draft-id");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "draft_decisions",
       decision: decisionIdx >= 0 ? argv[decisionIdx + 1] : undefined,
       draft_id: draftIdIdx >= 0 ? argv[draftIdIdx + 1] : undefined
@@ -2670,7 +2670,7 @@ async function runCli(argv) {
     const itemIdx = argv.indexOf("--item-id");
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "decision_reviews",
       decision: decisionIdx >= 0 ? argv[decisionIdx + 1] : undefined,
       apply_item_id: itemIdx >= 0 ? argv[itemIdx + 1] : undefined
@@ -2678,12 +2678,12 @@ async function runCli(argv) {
   }
   if (cmd === "site-jobs") {
     const keyIdx = argv.indexOf("--key");
-    const agentKey = keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY;
+    const agentKey = keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY);
     return print(await post("/api/site_agents/call", { url, agent_key: agentKey, action: "jobs" }));
   }
   if (cmd === "site-c5-repairs") {
     const keyIdx = argv.indexOf("--key");
-    const agentKey = keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY;
+    const agentKey = keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY);
     return print(await post("/api/site_agents/call", { url, agent_key: agentKey, action: "c5_repair_history" }));
   }
   if (cmd === "site-job-evidence") {
@@ -2693,7 +2693,7 @@ async function runCli(argv) {
     const evidence = evidenceIdx >= 0 ? JSON.parse(fs.readFileSync(argv[evidenceIdx + 1], "utf8")) : undefined;
     return print(await post("/api/site_agents/call", {
       url,
-      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : process.env.AEO_AGENT_KEY,
+      agent_key: keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY),
       action: "report_job_evidence",
       job_id: argv[2],
       evidence_uri: uriIdx >= 0 ? argv[uriIdx + 1] : "",
@@ -3278,7 +3278,8 @@ async function runCli(argv) {
     return print(await post("/api/site_agents/verify_domain", { url, method }));
   }
   if (cmd === "verify") {
-    const key = argv[argv.indexOf("--key") + 1] || process.env.AEO_AGENT_KEY;
+    const keyIdx = argv.indexOf("--key");
+    const key = keyIdx >= 0 ? argv[keyIdx + 1] : (process.env.SITE_AGENT_KEY || process.env.AEO_AGENT_KEY);
     return print(await post("/api/site_agents/verify", { url, agent_key: key }));
   }
   if (cmd === "mcp") return runMcp();

package/browser-sdk.js

@@ -1,74 +1,88 @@
 (function () {
-  "use strict";
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    // Not a browser: loaded via require()/import in Node. This module is the
+    // browser sensor script; expose only a descriptor so tooling can locate it.
+    if (typeof module !== "undefined" && module.exports !== undefined) {
+      module.exports = {
+        browser_only: true,
+        script: "browser-sdk.js",
+        usage: "Serve this file to browsers with a <script> tag (see site_agent_install_descriptor); it exposes no Node API."
+      };
+    }
+    return;
+  }
   var w = window;
   var d = document;
-  var script = d.currentScript || {};
-  var previous = w.twin3AEO || {};
-  var endpoint = previous.endpoint || (script.getAttribute && script.getAttribute("data-endpoint")) || "/api/agent/sdk_event";
-  var agentId = previous.agentId || (script.getAttribute && script.getAttribute("data-agent-id")) || "";
-  var defaultEvent = previous.event || "page_view";
-  var aiReferrer = /(chatgpt|openai|perplexity|gemini|bard|claude|anthropic|copilot|bing|you\.com|poe\.com)/i;
-
-  function clip(value, limit) {
+  var s = d.currentScript || {};
+  var cfg = w.twin3AEO || {};
+  var endpoint = cfg.endpoint || s.getAttribute && s.getAttribute("data-endpoint") || "/api/agent/sdk_event";
+  var agentId = cfg.agentId || s.getAttribute && s.getAttribute("data-agent-id") || "";
+  var siteToken = cfg.siteToken || s.getAttribute && s.getAttribute("data-site-token") || "";
+  var eventName = cfg.event || "page_view";
+  var aiRefHosts = /(chatgpt|openai|perplexity|gemini|bard|claude|anthropic|copilot|bing|you\.com|poe\.com)/i;
+  var clsScore = 0;
+  var clsEntries = 0;
+
+  function clip(value, n) {
     value = value == null ? "" : String(value);
-    return value.length > limit ? value.slice(0, limit) : value;
+    return value.length > n ? value.slice(0, n) : value;
   }
 
-  function attr(element, name) {
-    return element && element.getAttribute ? (element.getAttribute(name) || "") : "";
+  function attr(el, name) {
+    return el && el.getAttribute ? (el.getAttribute(name) || "") : "";
   }
 
-  function text(element) {
-    return clip((element && element.textContent || "").replace(/\s+/g, " ").trim(), 160);
+  function text(el) {
+    return clip((el && el.textContent || "").replace(/\s+/g, " ").trim(), 160);
   }
 
   function meta(name) {
-    var element = d.querySelector('meta[name="' + name + '"],meta[property="' + name + '"]');
-    return attr(element, "content");
+    var el = d.querySelector('meta[name="' + name + '"],meta[property="' + name + '"]');
+    return attr(el, "content");
   }
 
-  function hasAccessibleName(element) {
-    if (!element) return false;
-    return !!(attr(element, "aria-label") || attr(element, "title") || attr(element, "alt") || attr(element, "placeholder") || attr(element, "name") || text(element));
+  function hasName(el) {
+    if (!el) return false;
+    return !!(attr(el, "aria-label") || attr(el, "title") || attr(el, "alt") || attr(el, "placeholder") || attr(el, "name") || text(el));
   }
 
-  function cleanData(value, depth) {
-    if (!value || typeof value !== "object" || depth > 2) return value;
-    var output = Array.isArray(value) ? [] : {};
-    Object.keys(value).slice(0, 40).forEach(function (key) {
+  function cleanData(obj, depth) {
+    if (!obj || typeof obj !== "object" || depth > 2) return obj;
+    var out = Array.isArray(obj) ? [] : {};
+    Object.keys(obj).slice(0, 40).forEach(function (key) {
       var low = key.toLowerCase();
       if (/email|phone|tel|name|note|message|token|key|secret|password/.test(low)) {
-        output[key] = "[redacted]";
+        out[key] = "[redacted]";
         return;
       }
-      var item = value[key];
-      if (typeof item === "string") output[key] = clip(item, 160);
-      else if (typeof item === "number" || typeof item === "boolean") output[key] = item;
-      else if (item && typeof item === "object") output[key] = cleanData(item, depth + 1);
+      var v = obj[key];
+      if (typeof v === "string") out[key] = clip(v, 160);
+      else if (typeof v === "number" || typeof v === "boolean") out[key] = v;
+      else if (v && typeof v === "object") out[key] = cleanData(v, depth + 1);
     });
-    return output;
+    return out;
   }
 
   function collectSignals() {
     var forms = Array.prototype.slice.call(d.querySelectorAll("form"));
-    var webmcpForms = forms.filter(function (form) { return attr(form, "toolname") && attr(form, "tooldescription"); });
+    var webmcpForms = forms.filter(function (f) { return attr(f, "toolname") && attr(f, "tooldescription"); });
     var badToolInputs = 0;
-    webmcpForms.forEach(function (form) {
-      Array.prototype.slice.call(form.querySelectorAll("input,select,textarea")).forEach(function (element) {
-        if ((attr(element, "type") || "").toLowerCase() === "hidden") return;
-        if (!attr(element, "name")) badToolInputs += 1;
+    webmcpForms.forEach(function (f) {
+      Array.prototype.slice.call(f.querySelectorAll("input,select,textarea")).forEach(function (el) {
+        if ((attr(el, "type") || "").toLowerCase() === "hidden") return;
+        if (!attr(el, "name")) badToolInputs += 1;
       });
     });
     var interactive = Array.prototype.slice.call(d.querySelectorAll("a,button,input,select,textarea"));
-    var namedInteractive = interactive.filter(function (element) {
-      if (element.tagName === "INPUT" && (attr(element, "type") || "").toLowerCase() === "hidden") return true;
-      return hasAccessibleName(element);
+    var namedInteractive = interactive.filter(function (el) {
+      if (el.tagName === "INPUT" && (attr(el, "type") || "").toLowerCase() === "hidden") return true;
+      return hasName(el);
     });
-    var images = Array.prototype.slice.call(d.querySelectorAll("img"));
-    var missingImageSize = images.filter(function (image) { return !(attr(image, "width") && attr(image, "height")); });
-    var referrer = d.referrer || "";
-    var referrerHost = "";
-    try { referrerHost = referrer ? (new URL(referrer)).hostname : ""; } catch (_) { referrerHost = ""; }
+    var imgs = Array.prototype.slice.call(d.querySelectorAll("img"));
+    var missingImgSize = imgs.filter(function (img) { return !(attr(img, "width") && attr(img, "height")); });
+    var ref = d.referrer || "";
+    var refHost = "";
+    try { refHost = ref ? (new URL(ref)).hostname : ""; } catch (_) { refHost = ""; }
     return {
       title_len: (d.title || "").length,
       description_len: meta("description").length,
@@ -83,30 +97,48 @@
       webmcp_bad_inputs: badToolInputs,
       interactive: interactive.length,
       named_interactive: namedInteractive.length,
-      images: images.length,
-      images_missing_size: missingImageSize.length,
-      referrer_host: clip(referrerHost, 80),
-      ai_referrer: aiReferrer.test(referrer)
+      images: imgs.length,
+      images_missing_size: missingImgSize.length,
+      cls_score: Math.round(clsScore * 10000) / 10000,
+      cls_entries: clsEntries,
+      referrer_host: clip(refHost, 80),
+      ai_referrer: aiRefHosts.test(ref)
     };
   }
 
+  function observeLayoutShift() {
+    if (!("PerformanceObserver" in w)) return;
+    try {
+      var observer = new PerformanceObserver(function (list) {
+        list.getEntries().forEach(function (entry) {
+          if (entry.hadRecentInput) return;
+          clsScore += entry.value || 0;
+          clsEntries += 1;
+        });
+      });
+      observer.observe({ type: "layout-shift", buffered: true });
+    } catch (_) {}
+  }
+
   function payload(event, data) {
-    var output = {
-      sdk: "agent-id-browser-sdk",
-      sdk_version: "0.3.0",
-      event: event || defaultEvent,
+    var out = {
+      sdk: "aeo-site-sdk",
+      sdk_version: "0.2.3",
+      event: event || eventName,
+      timestamp: new Date().toISOString(),
       agent_id: agentId,
       url: location.href,
       path: location.pathname
     };
-    if (data) output.data = cleanData(data, 0);
-    return JSON.stringify(output);
+    if (siteToken) out.site_token = siteToken;
+    if (data) out.data = cleanData(data, 0);
+    return JSON.stringify(out);
   }
 
   function post(body) {
     if (navigator.sendBeacon) {
-      var accepted = navigator.sendBeacon(endpoint, new Blob([body], { type: "application/json" }));
-      if (accepted) return;
+      var ok = navigator.sendBeacon(endpoint, new Blob([body], { type: "application/json" }));
+      if (ok) return;
     }
     fetch(endpoint, {
       method: "POST",
@@ -117,33 +149,38 @@
     }).catch(function () {});
   }
 
-  function track(event, data) {
+  function send(event, data) {
     post(payload(event, data));
   }
 
   function signal(extra) {
-    track("page_signal", { signals: collectSignals(), extra: extra || {} });
+    send("page_signal", { signals: collectSignals(), extra: extra || {} });
   }
 
   function conversion(name, data) {
-    track("conversion", { conversion: clip(name || "conversion", 80), value: cleanData(data || {}, 0) });
+    send("conversion", { conversion: clip(name || "conversion", 80), referrer: d.referrer || "", value: cleanData(data || {}, 0) });
   }
 
   w.twin3AEO = {
     agentId: agentId,
+    siteToken: siteToken,
     endpoint: endpoint,
-    version: "0.3.0",
-    track: track,
+    version: "0.2.3",
+    track: send,
     signal: signal,
     conversion: conversion,
     collectSignals: collectSignals
   };
 
   function boot() {
-    track("page_view");
+    observeLayoutShift();
+    send("page_view");
     setTimeout(function () { signal(); }, 700);
   }
 
-  if (d.readyState === "loading") d.addEventListener("DOMContentLoaded", boot, { once: true });
-  else boot();
+  if (d.readyState === "loading") {
+    d.addEventListener("DOMContentLoaded", boot, { once: true });
+  } else {
+    boot();
+  }
 })();

package/installer.js

@@ -356,6 +356,23 @@ This directory contains only the local install state and a server-side helper te
 `;
 }
 
+function managedIgnoreTemplate(framework) {
+  const keepNote = framework === "static"
+    ? "# runner.cjs and README.md stay committed so the scheduled workflow can run them.\n"
+    : "# site-agent.cjs and README.md stay committed for the website server runtime.\n";
+  return [
+    "# Written by @twin3-ai/agent-id install. Local runtime state stays out of git.",
+    keepNote.trimEnd(),
+    "install-state.json",
+    "install-commit.json",
+    "enterprise-state.json",
+    ".transactions/",
+    "reports/",
+    "secrets/",
+    ""
+  ].join("\n");
+}
+
 function stateTemplate(plan) {
   const state = {
     schema: STATE_SCHEMA,
@@ -491,11 +508,13 @@ function buildInstallPlan({ url, projectRoot = process.cwd(), endpoint = DEFAULT
       { path: `${MANAGED_DIR}/install-state.json`, mode: "private", content: "" },
       { path: `${MANAGED_DIR}/runner.cjs`, mode: "customer_runner", content: staticRunnerTemplate(siteUrl, selection.modules) },
       { path: `${MANAGED_DIR}/README.md`, mode: "documentation", content: readmeTemplate(siteUrl, selectedFramework, selectedPackageManager, parentEndpoint) },
-      { path: ".github/workflows/agent-id-sync.yml", mode: "customer_runner_workflow", content: staticWorkflowTemplate(siteUrl, parentEndpoint) }
+      { path: ".github/workflows/agent-id-sync.yml", mode: "customer_runner_workflow", content: staticWorkflowTemplate(siteUrl, parentEndpoint) },
+      { path: `${MANAGED_DIR}/.gitignore`, mode: "documentation", content: managedIgnoreTemplate(selectedFramework) }
     ] : [
       { path: `${MANAGED_DIR}/install-state.json`, mode: "private", content: "" },
       { path: `${MANAGED_DIR}/site-agent.cjs`, mode: "server_helper", content: runtimeTemplate() },
-      { path: `${MANAGED_DIR}/README.md`, mode: "documentation", content: readmeTemplate(siteUrl, selectedFramework, selectedPackageManager, parentEndpoint) }
+      { path: `${MANAGED_DIR}/README.md`, mode: "documentation", content: readmeTemplate(siteUrl, selectedFramework, selectedPackageManager, parentEndpoint) },
+      { path: `${MANAGED_DIR}/.gitignore`, mode: "documentation", content: managedIgnoreTemplate(selectedFramework) }
     ];
     const base = {
       schema: INSTALL_SCHEMA,
@@ -553,7 +572,7 @@ function buildInstallPlan({ url, projectRoot = process.cwd(), endpoint = DEFAULT
 
 function validatePlan(plan) {
   if (!plan || plan.schema !== INSTALL_SCHEMA || plan.approval_required !== true) throw installError("INVALID_INSTALL_PLAN", "The installation plan is invalid or missing approval metadata.");
-  const expectedCount = plan.framework === "static" ? 4 : 3;
+  const expectedCount = plan.framework === "static" ? 5 : 4;
   if (!Array.isArray(plan.files) || plan.files.length !== expectedCount) throw installError("INVALID_INSTALL_PLAN", `The installation plan must contain exactly ${expectedCount} managed files.`);
   const root = normalizeProjectRoot(plan.project_root);
   for (const file of plan.files) {
@@ -873,6 +892,7 @@ function installContents(plan) {
       [`${MANAGED_DIR}/site-agent.cjs`]: runtimeTemplate(),
       [`${MANAGED_DIR}/runner.cjs`]: staticRunnerTemplate(plan.site_url, plan.modules),
       [`${MANAGED_DIR}/README.md`]: readmeTemplate(plan.site_url, plan.framework, plan.package_manager, plan.parent_endpoint),
+      [`${MANAGED_DIR}/.gitignore`]: managedIgnoreTemplate(plan.framework),
       ".github/workflows/agent-id-sync.yml": staticWorkflowTemplate(plan.site_url)
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twin3-ai/agent-id",
-  "version": "0.3.17",
+  "version": "0.3.18",
   "description": "Domain-bound AgentX portable alias, AEO evidence, and website-Agent integration SDK.",
   "license": "UNLICENSED",
   "private": false,