@piagent/platform 1.41.0 → 1.42.0

package/docs-site/assets/docs.js

@@ -1,86 +1,494 @@
 // Behaviour shared by every docs page. Loaded with `defer`, so the DOM is parsed
-// before any of this runs and no page needs an inline script of its own.
+// before any of this runs and no page needs an inline script of its own (the
+// theme is the one exception: it is set in <head> so the page never flashes).
 
-const sidebar = document.querySelector("[data-sidebar]");
-const menuButton = document.querySelector("[data-menu]");
-const filterInput = document.querySelector("[data-filter]");
-const navLinks = Array.from(document.querySelectorAll(".nav-link"));
+const root = document.documentElement;
+const reducedMotion = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
 
-menuButton?.addEventListener("click", () => {
-  sidebar?.classList.toggle("open");
+/** Storage can be missing or throw (private windows, blocked site data). */
+const store = {
+  get(key) {
+    try {
+      return window.localStorage.getItem(key);
+    } catch {
+      return null;
+    }
+  },
+  set(key, value) {
+    try {
+      window.localStorage.setItem(key, value);
+    } catch {
+      /* the page works without it */
+    }
+  }
+};
+
+const ICON_COPY = '<svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><rect x="9" y="9" width="11" height="11" rx="2"/><path d="M5 15V6a2 2 0 0 1 2-2h9"/></svg>';
+const ICON_CHECK = '<svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><path d="m5 12 5 5 9-10"/></svg>';
+
+// ---------- Theme ----------
+
+document.querySelector("[data-theme-toggle]")?.addEventListener("click", () => {
+  const current = root.dataset.theme
+    || (window.matchMedia("(prefers-color-scheme: light)").matches ? "light" : "dark");
+  const next = current === "light" ? "dark" : "light";
+  root.dataset.theme = next;
+  store.set("piagent-docs-theme", next);
 });
 
-navLinks.forEach((link) => {
+// ---------- Sidebar (mobile) ----------
+
+const sidebar = document.querySelector("[data-sidebar]");
+document.querySelector("[data-menu]")?.addEventListener("click", () => {
+  sidebar?.classList.toggle("open");
+});
+document.querySelectorAll(".nav-link").forEach((link) => {
   link.addEventListener("click", () => sidebar?.classList.remove("open"));
 });
+document.addEventListener("click", (event) => {
+  if (!sidebar?.classList.contains("open")) return;
+  if (sidebar.contains(event.target) || event.target.closest("[data-menu]")) return;
+  sidebar.classList.remove("open");
+});
+
+// ---------- Copy ----------
+
+async function copyText(text) {
+  try {
+    await navigator.clipboard.writeText(text);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Buttons that carry their command in an attribute keep the visible text
+// formatted; the label says what happened and goes back on its own.
+document.querySelectorAll("[data-clip]").forEach((button) => {
+  button.addEventListener("click", async () => {
+    const ok = await copyText(button.getAttribute("data-clip") || "");
+    const original = button.innerHTML;
+    const iconOnly = !button.textContent.trim();
+    if (iconOnly) {
+      button.innerHTML = ok ? ICON_CHECK : ICON_COPY;
+    } else {
+      button.textContent = ok ? root.dataset.copySuccess || "Copied" : root.dataset.copyFallback || "Select command";
+    }
+    button.classList.toggle("done", ok);
+    setTimeout(() => {
+      button.innerHTML = original;
+      button.classList.remove("done");
+    }, 1400);
+  });
+});
+
+// Every other code block gets an icon button. Comments after `#` are not copied.
+document.querySelectorAll("[data-article] pre").forEach((pre) => {
+  if (pre.closest(".command-card")) return;
+  const button = document.createElement("button");
+  button.type = "button";
+  button.className = "code-copy";
+  button.setAttribute("aria-label", root.dataset.copyLabel || "Copy");
+  button.innerHTML = ICON_COPY;
+  button.addEventListener("click", async () => {
+    const text = pre.innerText.split("\n").map((line) => line.replace(/\s+#\s.*$/, "")).join("\n").trim();
+    const ok = await copyText(text);
+    button.innerHTML = ok ? ICON_CHECK : ICON_COPY;
+    button.classList.toggle("done", ok);
+    setTimeout(() => {
+      button.innerHTML = ICON_COPY;
+      button.classList.remove("done");
+    }, 1400);
+  });
+  pre.append(button);
+});
+
+// ---------- Tabs ----------
+// A tab group with `data-tabs="os"` remembers its choice, and every other group
+// with the same name on the site follows it.
 
-// The filter hides whole groups once none of their links match, so a search that
-// finds nothing in a group does not leave its heading floating over a gap.
-filterInput?.addEventListener("input", (event) => {
-  const value = event.target.value.trim().toLowerCase();
-  navLinks.forEach((link) => {
-    const text = link.textContent.toLowerCase();
-    link.style.display = !value || text.includes(value) ? "flex" : "none";
+function selectTab(group, value) {
+  const buttons = group.querySelectorAll(":scope > .tab-list [data-tab]");
+  if (![...buttons].some((button) => button.dataset.tab === value)) return;
+  buttons.forEach((button) => {
+    const selected = button.dataset.tab === value;
+    button.setAttribute("aria-selected", String(selected));
+    button.tabIndex = selected ? 0 : -1;
+  });
+  group.querySelectorAll(":scope > [data-panel]").forEach((panel) => {
+    panel.hidden = panel.dataset.panel !== value;
   });
-  document.querySelectorAll(".nav-group").forEach((group) => {
-    const visible = Array.from(group.querySelectorAll(".nav-link")).some((link) => link.style.display !== "none");
-    group.style.display = visible ? "" : "none";
+}
+
+function detectOs() {
+  const platform = (navigator.userAgentData?.platform || navigator.platform || "").toLowerCase();
+  if (platform.includes("win")) return "windows";
+  if (platform.includes("mac")) return "macos";
+  return "linux";
+}
+
+document.querySelectorAll("[data-tabs]").forEach((group) => {
+  const name = group.dataset.tabs;
+  const saved = store.get(`piagent-docs-tab-${name}`) || (name === "os" ? detectOs() : null);
+  if (saved) selectTab(group, saved === "linux" && !group.querySelector('[data-tab="linux"]') ? "macos" : saved);
+  group.querySelectorAll(":scope > .tab-list [data-tab]").forEach((button) => {
+    button.addEventListener("click", () => {
+      store.set(`piagent-docs-tab-${name}`, button.dataset.tab);
+      document.querySelectorAll(`[data-tabs="${name}"]`).forEach((peer) => selectTab(peer, button.dataset.tab));
+    });
+    button.addEventListener("keydown", (event) => {
+      if (event.key !== "ArrowRight" && event.key !== "ArrowLeft") return;
+      const all = [...group.querySelectorAll(":scope > .tab-list [data-tab]")];
+      const next = all[(all.indexOf(button) + (event.key === "ArrowRight" ? 1 : all.length - 1)) % all.length];
+      next.focus();
+      next.click();
+    });
   });
 });
 
-// Table of contents, built from the headings the page actually has. Generating it
-// here rather than writing it into each page means a heading can never be renamed
-// in the prose and left stale in the sidebar.
+// ---------- Table of contents and heading anchors ----------
+// Built from the headings the page actually has, so a heading can never be
+// renamed in the prose and left stale in the sidebar.
+
 const tocHost = document.querySelector("[data-toc]");
 const article = document.querySelector("[data-article]");
 
+if (article) {
+  for (const heading of article.querySelectorAll("h2[id], h3[id]")) {
+    const anchor = document.createElement("a");
+    anchor.className = "heading-anchor";
+    anchor.href = `#${heading.id}`;
+    anchor.setAttribute("aria-hidden", "true");
+    anchor.tabIndex = -1;
+    anchor.textContent = "#";
+    heading.prepend(anchor);
+  }
+}
+
 if (tocHost && article) {
-  const headings = Array.from(article.querySelectorAll("h2[id], h3[id]"));
+  const headings = Array.from(article.querySelectorAll("h2[id], h3[id]")).filter((heading) => !heading.hasAttribute("data-toc-skip"));
   if (headings.length < 2) {
-    tocHost.remove();
+    tocHost.closest(".toc")?.remove();
     document.querySelector(".layout")?.classList.remove("with-toc");
   } else {
     for (const heading of headings) {
       const link = document.createElement("a");
       link.href = `#${heading.id}`;
-      link.textContent = heading.textContent.trim();
+      link.textContent = heading.textContent.replace(/^#/, "").trim();
       if (heading.tagName === "H3") link.classList.add("toc-h3");
       tocHost.append(link);
     }
-
     const tocLinks = Array.from(tocHost.querySelectorAll("a"));
     const observer = new IntersectionObserver(
       (entries) => {
         const visible = entries
           .filter((entry) => entry.isIntersecting)
-          .sort((a, b) => b.intersectionRatio - a.intersectionRatio)[0];
+          .sort((a, b) => a.boundingClientRect.top - b.boundingClientRect.top)[0];
         if (!visible) return;
         for (const link of tocLinks) {
           link.classList.toggle("active", link.getAttribute("href") === `#${visible.target.id}`);
         }
       },
-      { rootMargin: "-12% 0px -70% 0px", threshold: [0.1, 0.5, 1] }
+      { rootMargin: "-10% 0px -70% 0px", threshold: [0, 1] }
     );
     for (const heading of headings) observer.observe(heading);
   }
 }
 
-// Copy buttons carry the command in an attribute so the visible text can stay
-// formatted; the label says what happened and goes back on its own.
-document.querySelectorAll("[data-clip]").forEach((button) => {
-  button.addEventListener("click", async () => {
-    const text = button.getAttribute("data-clip") || "";
-    const original = button.textContent;
-    const copySuccess = document.documentElement.dataset.copySuccess || "Copied";
-    const copyFallback = document.documentElement.dataset.copyFallback || "Select command";
-    try {
-      await navigator.clipboard.writeText(text);
-      button.textContent = copySuccess;
-    } catch {
-      button.textContent = copyFallback;
+// ---------- Search palette (⌘K) ----------
+
+const palette = document.querySelector("[data-palette]");
+const paletteInput = palette?.querySelector("input");
+const paletteResults = palette?.querySelector("[data-results]");
+let searchIndex = null;
+let hits = [];
+let active = 0;
+
+function normalize(text) {
+  return text.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/đ/g, "d");
+}
+
+async function loadIndex() {
+  if (searchIndex) return searchIndex;
+  try {
+    const response = await fetch(palette.dataset.index);
+    const pages = await response.json();
+    searchIndex = pages.flatMap((page) => [
+      { title: page.title, sub: page.group, href: page.href, icon: page.icon, text: normalize(`${page.title} ${page.nav} ${page.lead}`), weight: 2 },
+      ...page.headings.map((heading) => ({
+        title: heading.text,
+        sub: page.nav,
+        href: `${page.href}#${heading.id}`,
+        icon: "hash",
+        text: normalize(heading.text),
+        weight: 1
+      }))
+    ]);
+  } catch {
+    searchIndex = [];
+  }
+  return searchIndex;
+}
+
+function iconSvg(name) {
+  return document.querySelector(`#icon-${name}`) ? `<svg class="icon" aria-hidden="true"><use href="#icon-${name}"/></svg>` : "";
+}
+
+function renderHits() {
+  if (!paletteResults) return;
+  if (hits.length === 0) {
+    paletteResults.innerHTML = `<p class="palette-empty">${palette.dataset.empty || "No results"}</p>`;
+    return;
+  }
+  paletteResults.innerHTML = "";
+  hits.forEach((hit, index) => {
+    const link = document.createElement("a");
+    link.href = hit.href;
+    link.setAttribute("role", "option");
+    link.setAttribute("aria-selected", String(index === active));
+    link.innerHTML = `${iconSvg(hit.icon)}<span><span class="hit-title"></span><span class="hit-sub"></span></span>`;
+    link.querySelector(".hit-title").textContent = hit.title;
+    link.querySelector(".hit-sub").textContent = hit.sub;
+    link.addEventListener("mousemove", () => {
+      if (active === index) return;
+      active = index;
+      paletteResults.querySelectorAll("a").forEach((item, i) => item.setAttribute("aria-selected", String(i === active)));
+    });
+    paletteResults.append(link);
+  });
+}
+
+async function runSearch() {
+  const index = await loadIndex();
+  const query = normalize(paletteInput.value.trim());
+  const words = query.split(/\s+/).filter(Boolean);
+  hits = (words.length === 0
+    ? index.filter((item) => item.weight === 2)
+    : index
+      .map((item) => {
+        if (!words.every((word) => item.text.includes(word))) return null;
+        const starts = normalize(item.title).startsWith(words[0]) ? 2 : 0;
+        return { ...item, score: item.weight + starts };
+      })
+      .filter(Boolean)
+      .sort((a, b) => b.score - a.score)
+  ).slice(0, 12);
+  active = 0;
+  renderHits();
+}
+
+function openPalette() {
+  if (!palette) return;
+  palette.classList.add("open");
+  paletteInput.value = "";
+  runSearch();
+  requestAnimationFrame(() => paletteInput.focus());
+}
+
+function closePalette() {
+  palette?.classList.remove("open");
+}
+
+document.querySelectorAll("[data-search]").forEach((button) => button.addEventListener("click", openPalette));
+palette?.addEventListener("click", (event) => {
+  if (event.target === palette) closePalette();
+});
+paletteInput?.addEventListener("input", runSearch);
+paletteInput?.addEventListener("keydown", (event) => {
+  if (event.key === "ArrowDown" || event.key === "ArrowUp") {
+    event.preventDefault();
+    if (hits.length === 0) return;
+    active = (active + (event.key === "ArrowDown" ? 1 : hits.length - 1)) % hits.length;
+    const items = paletteResults.querySelectorAll("a");
+    items.forEach((item, i) => item.setAttribute("aria-selected", String(i === active)));
+    items[active]?.scrollIntoView({ block: "nearest" });
+  } else if (event.key === "Enter" && hits[active]) {
+    window.location.href = hits[active].href;
+    closePalette();
+  }
+});
+document.addEventListener("keydown", (event) => {
+  if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === "k") {
+    event.preventDefault();
+    palette?.classList.contains("open") ? closePalette() : openPalette();
+  } else if (event.key === "Escape") {
+    closePalette();
+    sidebar?.classList.remove("open");
+  } else if (event.key === "/" && !/input|textarea/i.test(document.activeElement?.tagName || "")) {
+    event.preventDefault();
+    openPalette();
+  }
+});
+
+// ---------- Landing page effects ----------
+// Content is in the HTML and readable without JavaScript. Effects only add
+// motion on top, use transform and opacity, and stand down for reduced motion.
+
+const revealTargets = document.querySelectorAll("[data-reveal]");
+if (revealTargets.length > 0 && !reducedMotion && "IntersectionObserver" in window) {
+  root.classList.add("reveal-ready");
+  const revealObserver = new IntersectionObserver((entries) => {
+    for (const entry of entries) {
+      if (!entry.isIntersecting) continue;
+      entry.target.classList.add("in");
+      revealObserver.unobserve(entry.target);
     }
-    setTimeout(() => {
-      button.textContent = original;
-    }, 1200);
+  }, { rootMargin: "0px 0px -8% 0px", threshold: 0.12 });
+  revealTargets.forEach((target) => revealObserver.observe(target));
+} else {
+  revealTargets.forEach((target) => target.classList.add("in"));
+}
+
+// Count-up: the real number is already in the markup; this replays it once.
+document.querySelectorAll("[data-count]").forEach((node) => {
+  const target = Number(node.dataset.count);
+  if (!Number.isFinite(target) || reducedMotion) return;
+  const decimals = Number(node.dataset.decimals || 0);
+  const format = (value) => value.toLocaleString(root.lang === "vi" ? "vi-VN" : "en-US", {
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals
+  });
+  const finalText = node.textContent;
+  const observer = new IntersectionObserver((entries) => {
+    if (!entries[0].isIntersecting) return;
+    observer.disconnect();
+    const start = performance.now();
+    const duration = 1200;
+    const tick = (now) => {
+      const progress = Math.min(1, (now - start) / duration);
+      const eased = 1 - Math.pow(2, -10 * progress);
+      node.textContent = progress < 1 ? format(target * eased) : finalText;
+      if (progress < 1) requestAnimationFrame(tick);
+    };
+    requestAnimationFrame(tick);
+  }, { threshold: 0.6 });
+  observer.observe(node);
+});
+
+// Spotlight on feature tiles: one listener for the grid, one frame per move.
+document.querySelectorAll("[data-spotlight]").forEach((grid) => {
+  if (!window.matchMedia("(hover: hover)").matches) return;
+  let frame = 0;
+  grid.addEventListener("pointermove", (event) => {
+    const tile = event.target.closest(".tile");
+    if (!tile || frame) return;
+    frame = requestAnimationFrame(() => {
+      const rect = tile.getBoundingClientRect();
+      tile.style.setProperty("--mx", `${event.clientX - rect.left}px`);
+      tile.style.setProperty("--my", `${event.clientY - rect.top}px`);
+      frame = 0;
+    });
+  });
+});
+
+// Flow line draws itself when the section comes into view.
+document.querySelectorAll("[data-flow]").forEach((flow) => {
+  if (reducedMotion) {
+    flow.classList.add("in");
+    return;
+  }
+  const observer = new IntersectionObserver((entries) => {
+    if (!entries[0].isIntersecting) return;
+    flow.classList.add("in");
+    observer.disconnect();
+  }, { threshold: 0.4 });
+  observer.observe(flow);
+});
+
+// Terminal demo: lines appear in order, the prompt types, then it loops while
+// on screen. With reduced motion every line is shown at once.
+document.querySelectorAll("[data-term]").forEach((term) => {
+  const lines = [...term.querySelectorAll(".term-line, .term-card, .term-result")];
+  const typed = term.querySelector("[data-type]");
+  const fullText = typed?.dataset.type || "";
+  if (reducedMotion) {
+    lines.forEach((line) => line.classList.add("show"));
+    if (typed) typed.textContent = fullText;
+    return;
+  }
+  let timers = [];
+  let running = false;
+  const clear = () => {
+    timers.forEach(clearTimeout);
+    timers = [];
+  };
+  const play = () => {
+    clear();
+    running = true;
+    lines.forEach((line) => line.classList.remove("show"));
+    if (typed) typed.textContent = "";
+    let at = 300;
+    if (typed) {
+      lines[0]?.classList.add("show");
+      for (let i = 1; i <= fullText.length; i += 1) {
+        timers.push(setTimeout(() => {
+          typed.textContent = fullText.slice(0, i);
+        }, at));
+        at += 28;
+      }
+      at += 350;
+    }
+    lines.forEach((line, index) => {
+      if (typed && index === 0) return;
+      const pause = Number(line.dataset.wait || 520);
+      at += pause;
+      timers.push(setTimeout(() => line.classList.add("show"), at));
+    });
+    timers.push(setTimeout(() => {
+      if (running) play();
+    }, at + 6000));
+  };
+  const observer = new IntersectionObserver((entries) => {
+    if (entries[0].isIntersecting && !running) play();
+    if (!entries[0].isIntersecting && running) {
+      running = false;
+      clear();
+      lines.forEach((line) => line.classList.add("show"));
+      if (typed) typed.textContent = fullText;
+    }
+  }, { threshold: 0.25 });
+  observer.observe(term);
+});
+
+// Screenshot gallery: tab buttons swap the image and caption in place.
+document.querySelectorAll("[data-gallery]").forEach((gallery) => {
+  const image = gallery.querySelector("img");
+  const caption = gallery.querySelector("figcaption");
+  gallery.querySelectorAll("[data-shot]").forEach((button) => {
+    button.addEventListener("click", () => {
+      gallery.querySelectorAll("[data-shot]").forEach((peer) => peer.setAttribute("aria-selected", String(peer === button)));
+      image.style.opacity = "0";
+      const next = new Image();
+      next.src = button.dataset.shot;
+      next.onload = () => {
+        image.src = button.dataset.shot;
+        image.alt = button.dataset.alt || "";
+        caption.textContent = button.dataset.caption || "";
+        image.style.opacity = "1";
+      };
+    });
+  });
+});
+
+// Changelog filter: show only the items of one kind, and hide releases that
+// have none of it.
+const releaseFilter = document.querySelector(".release-filter");
+releaseFilter?.querySelectorAll("[data-filter-kind]").forEach((button) => {
+  button.addEventListener("click", () => {
+    const kind = button.dataset.filterKind;
+    releaseFilter.querySelectorAll("[data-filter-kind]").forEach((peer) => peer.setAttribute("aria-pressed", String(peer === button)));
+    document.querySelectorAll("[data-releases] [data-release], .archive-row").forEach((release) => {
+      let shown = 0;
+      release.querySelectorAll("[data-kind]").forEach((item) => {
+        const visible = kind === "all" || item.dataset.kind === kind;
+        item.hidden = !visible;
+        if (visible) shown += 1;
+      });
+      release.hidden = shown === 0;
+    });
+    document.querySelectorAll(".release-archive").forEach((group) => {
+      group.hidden = !group.querySelector(".archive-row:not([hidden])");
+      if (kind !== "all" && !group.hidden) group.open = true;
+    });
   });
 });

package/docs-site/assets/piagent-logo.svg

@@ -1,35 +1,13 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-labelledby="title desc">
-  <title id="title">Pi Agent Platform logo</title>
-  <desc id="desc">Rounded dark monogram mark with Pi letters and guarded runtime lines.</desc>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-labelledby="title">
+  <title id="title">Piagent</title>
   <defs>
-    <linearGradient id="shell" x1="17" y1="8" x2="111" y2="120" gradientUnits="userSpaceOnUse">
-      <stop offset="0" stop-color="#1c2116"/>
-      <stop offset="0.5" stop-color="#0b0d0f"/>
-      <stop offset="1" stop-color="#131917"/>
+    <linearGradient id="pa-bg" x1="0" y1="0" x2="64" y2="64" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#1b1e17"/>
+      <stop offset="1" stop-color="#09090b"/>
     </linearGradient>
-    <linearGradient id="accent" x1="28" y1="24" x2="100" y2="108" gradientUnits="userSpaceOnUse">
-      <stop offset="0" stop-color="#e6ff8c"/>
-      <stop offset="1" stop-color="#8be9c8"/>
-    </linearGradient>
-    <radialGradient id="glow" cx="38" cy="30" r="86" gradientUnits="userSpaceOnUse">
-      <stop offset="0" stop-color="#d8ff7a" stop-opacity="0.34"/>
-      <stop offset="0.58" stop-color="#8be9c8" stop-opacity="0.08"/>
-      <stop offset="1" stop-color="#8be9c8" stop-opacity="0"/>
-    </radialGradient>
-    <filter id="soft" x="-24" y="-24" width="176" height="176" color-interpolation-filters="sRGB">
-      <feDropShadow dx="0" dy="14" stdDeviation="13" flood-color="#000000" flood-opacity="0.45"/>
-      <feDropShadow dx="0" dy="0" stdDeviation="6" flood-color="#d8ff7a" flood-opacity="0.2"/>
-    </filter>
   </defs>
-  <rect width="128" height="128" rx="32" fill="#050505"/>
-  <rect x="10" y="10" width="108" height="108" rx="28" fill="url(#shell)" filter="url(#soft)"/>
-  <rect x="10.75" y="10.75" width="106.5" height="106.5" rx="27.25" fill="none" stroke="url(#accent)" stroke-opacity="0.72" stroke-width="1.5"/>
-  <path d="M26 76c19-1 23-19 38-22 15-2 20 10 38 8" fill="none" stroke="url(#accent)" stroke-width="6" stroke-linecap="round" stroke-opacity="0.88"/>
-  <path d="M26 90c22 1 30-14 43-15 15-1 20 10 33 7" fill="none" stroke="#f4f4ef" stroke-width="2.5" stroke-linecap="round" stroke-opacity="0.22"/>
-  <circle cx="34" cy="34" r="4" fill="#d8ff7a"/>
-  <circle cx="96" cy="35" r="3" fill="#8be9c8" opacity="0.85"/>
-  <circle cx="94" cy="95" r="2.5" fill="#d8ff7a" opacity="0.72"/>
-  <rect x="25" y="25" width="78" height="78" rx="20" fill="url(#glow)" opacity="0.8"/>
-  <text x="64" y="78" text-anchor="middle" font-family="JetBrains Mono, IBM Plex Mono, ui-monospace, monospace" font-size="42" font-weight="700" letter-spacing="-3" fill="#f4f4ef">Pi</text>
-  <path d="M37 93h54" stroke="#d8ff7a" stroke-width="3" stroke-linecap="round" opacity="0.8"/>
+  <rect width="64" height="64" rx="15" fill="url(#pa-bg)"/>
+  <rect x=".75" y=".75" width="62.5" height="62.5" rx="14.25" fill="none" stroke="#ffffff" stroke-opacity=".12" stroke-width="1.5"/>
+  <path d="M13 21.5h27M21 22v22M32.5 22v17.5c0 3 1.6 4.5 4.5 4.5" fill="none" stroke="#f2f2ed" stroke-width="5.5" stroke-linecap="round"/>
+  <rect x="44" y="19.5" width="6.5" height="25" rx="1.8" fill="#c6f432"/>
 </svg>

package/docs-site/assets/search-en.json

@@ -0,0 +1 @@
+[{"href":"/en/","icon":"home","group":"Get started","nav":"Overview","title":"Pi Agent Platform","lead":"A coding agent for the whole team: a guard checks every tool call, the team's Harness runs checks and review, one dashboard for Terminal and the browser.","headings":[{"id":"different","text":"The agent works fast. The platform keeps it right."},{"id":"one-turn","text":"You say what you need. The rest is verified."},{"id":"screens","text":"Captured from a running dashboard"},{"id":"two-modes","text":"One dashboard, two ways to use models"},{"id":"install","text":"Running in two minutes"},{"id":"latest-updates","text":"Steady releases, every change written down"}]},{"href":"/en/ecosystem","icon":"network","group":"Get started","nav":"Ecosystem","title":"Piagent, Agent Watch and Agent Studio","lead":"What runs on your machine, what runs on the company server, and when to use your own model or the company's.","headings":[{"id":"overview","text":"One dashboard, two ways to use models"},{"id":"parts","text":"Each part does one job"},{"id":"piagent","text":"Piagent"},{"id":"guard","text":"Guard"},{"id":"agent-watch","text":"Agent Watch"},{"id":"agent-studio","text":"Agent Studio"},{"id":"one-turn","text":"From a message to \"A check passed · Review found no blocking issue\""},{"id":"choose","text":"When to use personal, when to use company"}]},{"href":"/en/quickstart","icon":"rocket","group":"Get started","nav":"Install","title":"Install and run your first turn","lead":"Two commands to install. Open a repository, pick its profile and permissions, then ask in plain language.","headings":[{"id":"install","text":"Install"},{"id":"open-project","text":"Open a project"},{"id":"read-project","text":"Let the agent read the project"},{"id":"profile-and-permission","text":"Pick a profile and permission"},{"id":"ask","text":"Ask in plain language"},{"id":"check","text":"Check the installation"},{"id":"supported","text":"Supported systems"},{"id":"next","text":"Next"}]},{"href":"/en/windows","icon":"windows","group":"Get started","nav":"Windows","title":"Install on Windows with one command","lead":"One PowerShell command installs WSL2, Ubuntu, Piagent and Agent Watch, binds the company key and adds Piagent to the Start menu. Run it again to update.","headings":[{"id":"one-command","text":"Install with one command"},{"id":"every-day","text":"Every day"},{"id":"when-setup-fails","text":"When setup fails"},{"id":"why-wsl2","text":"Why WSL2"}]},{"href":"/en/update","icon":"refresh","group":"Get started","nav":"Update & uninstall","title":"Update, roll back and uninstall","lead":"One command moves to a new release, and the dashboard and Terminal tell you when one is out. Rollback and uninstall both preview first.","headings":[{"id":"update","text":"Update"},{"id":"what-it-does","text":"What it does, in order"},{"id":"options","text":"Common options"},{"id":"pin-for-a-team","text":"Pin one release for a team"},{"id":"rollback","text":"Roll back"},{"id":"uninstall","text":"Uninstall"},{"id":"windows","text":"On Windows"}]},{"href":"/en/whats-new","icon":"sparkles","group":"Get started","nav":"Changelog","title":"Changelog","lead":"Every release: what changed and which Studio or Agent Watch it needs. Newest first.","headings":[{"id":"latest","text":"Latest"},{"id":"v1-42-0-title","text":"A redesigned dashboard and older messages that load without jumping"},{"id":"v1-41-0-title","text":"Front-end change reports with before/after screenshots"},{"id":"v1-40-0-title","text":"Local projects are reported to Studio too"},{"id":"v1-39-0-title","text":"Warnings when a team key is used outside its team"},{"id":"v1-38-2-title","text":"Folder tree, colour themes and an editor that stays in view"},{"id":"v1-38-1-title","text":"Published release of v1.38.0"},{"id":"v1-38-0-title","text":"Piagent becomes an editor, and Bypass asks nothing not published"},{"id":"v1-37-1-title","text":"Run closes and helper reports Studio can trust"},{"id":"v1-37-0-title","text":"A cut answer no longer stops a long task"},{"id":"v1-36-1-title","text":"A brief Agent Watch failure no longer stops a task"},{"id":"v1-36-0-title","text":"Team memory learns from what went wrong"},{"id":"v1-35-1-title","text":"A passing model provider failure no longer stops a long task"},{"id":"v1-35-0-title","text":"Long company tasks go on across Studio updates"},{"id":"v1-34-3-title","text":"Agent Watch notifies for company conversations"},{"id":"v1-34-2-title","text":"Helper outcomes reach Studio"},{"id":"v1-34-1-title","text":"Helper outcomes, line review and Agent Watch notifications"},{"id":"v1-33-0-title","text":"Company and personal sessions run on Pi 1.3.0"},{"id":"v1-32-1-title","text":"Bypass survives a reload, and a tab in use stays signed in"},{"id":"v1-32-0-title","text":"Failed or stopped company streams end at Studio too"},{"id":"v1-31-1-title","text":"memory_ask is there from the first conversation after an update"},{"id":"v1-31-0-title","text":"Team memory follows the work"},{"id":"v1-30-1-title","text":"Company Terminal hides model names; clear message in the home folder"},{"id":"v1-30-0-title","text":"Large contexts over slow connections; a clearer company Terminal"},{"id":"v1-29-0-title","text":"Company Terminal shows the Harness and keeps work inside the company"},{"id":"archive","text":"Earlier releases"}]},{"href":"/en/scope","icon":"target","group":"Get started","nav":"Platform scope","title":"What the platform owns","lead":"Every agent has governance primitives. This platform packages one repeatable operating model on Pi for every repository.","headings":[{"id":"not-a-new-agent","text":"This is not a new agent"},{"id":"complementary-layers","text":"The two layers are complementary"},{"id":"lower-layer","text":"The lower layer sees processes"},{"id":"upper-layer","text":"The upper layer sees intent"},{"id":"when-not-needed","text":"When you may not need it"}]},{"href":"/en/profiles","icon":"sliders","group":"Build","nav":"Project profiles","title":"Choose the right profile","lead":"A profile sets protected paths, verification commands and the capabilities a repository is granted.","headings":[]},{"href":"/en/permissions","icon":"key","group":"Build","nav":"Permission modes","title":"Change permissions per task","lead":"Permission modes apply to the current session only. Changing one does not modify the project profile.","headings":[]},{"href":"/en/commands","icon":"terminal","group":"Build","nav":"Command catalog","title":"Short commands, predictable behaviour","lead":"Slash commands package policy and flow, with one inspector for diffs, commands, safety and context.","headings":[{"id":"session-basics","text":"Session basics"},{"id":"project-profile","text":"Project profile"},{"id":"implementation-workflow","text":"Assigning work"},{"id":"git-handoff","text":"Git handoff"},{"id":"fresh-sessions","text":"New sessions"},{"id":"mcp","text":"MCP"},{"id":"subagents","text":"Subagents"},{"id":"product-status-commands","text":"Inspect runtime decisions"},{"id":"skills-and-packages","text":"Audit test quality, run experiment loops"}]},{"href":"/en/workflows","icon":"branch","group":"Build","nav":"Workflows","title":"Day-to-day work","lead":"No workflow launchers: say what you need in plain language. Inspection commands only observe and never start a model turn.","headings":[{"id":"conclusion","text":"No new command is mandatory in the daily flow"},{"id":"command-effects","text":"How far the inspection commands affect a workflow"},{"id":"example-flow","text":"A complete flow can look like this"}]},{"href":"/en/mcp","icon":"plug","group":"MCP","nav":"MCP overview","title":"MCP in Pi Agent Platform","lead":"The platform installs pi-mcp-adapter for token-efficient MCP access and manages servers across four configuration layers.","headings":[{"id":"start","text":"Where to start"},{"id":"three-similar-names","text":"Three similar names that are not connected"},{"id":"four-config-layers","text":"Four configuration layers"},{"id":"presets","text":"Pinned presets"},{"id":"token-efficiency","text":"Token efficiency"}]},{"href":"/en/mcp-servers","icon":"server","group":"MCP","nav":"Server management","title":"Add, inspect and remove MCP servers","lead":"piagent-mcp provides add, remove, get, list, enable and disable across all four scopes.","headings":[{"id":"two-surfaces","text":"Two surfaces for two contexts"},{"id":"commands","text":"Commands"},{"id":"in-session","text":"In a session"},{"id":"add-server","text":"Add a server"},{"id":"inspect","text":"Inspect"},{"id":"disable-remove","text":"Disable and remove"},{"id":"preset-command","text":"Preset"},{"id":"output","text":"Output names the modified file"},{"id":"updates","text":"Custom servers and updates"},{"id":"preserved","text":"Preserved"},{"id":"overwritten","text":"Replaced"}]},{"href":"/en/mcp-auth","icon":"lock","group":"MCP","nav":"Authentication","title":"Authentication and readiness","lead":"The platform stores no tokens and runs no OAuth. It rejects secrets in configuration and reports which servers are actually ready.","headings":[{"id":"no-token-storage","text":"The platform does not store tokens"},{"id":"reject-secrets","text":"Secrets are rejected before configuration is written"},{"id":"field-name","text":"Field-name detection"},{"id":"value-shape","text":"Value-shape detection"},{"id":"readiness","text":"Readiness states"}]},{"href":"/en/mcp-approval","icon":"shield-check","group":"MCP","nav":"Approval gate","title":"Repository servers require approval","lead":"Cloning an untrusted repository must not give its author a process on your machine. Decisions live outside the repository, pinned by digest.","headings":[{"id":"problem","text":"The problem"},{"id":"three-properties","text":"Three properties"},{"id":"outside-repository","text":"The decision lives outside the repository"},{"id":"digest-pinning","text":"Pinned by digest"},{"id":"tool-call-enforcement","text":"Enforced at tool call"},{"id":"limit","text":"Limit"},{"id":"imports","text":"Servers supplied through imports"},{"id":"design-decisions","text":"Design decisions"},{"id":"migration","text":"Migration"}]},{"href":"/en/security","icon":"shield","group":"Operate","nav":"Security model","title":"Policy enforcement, not an OS sandbox","lead":"Controlled tool surfaces fail closed when profiles, integrity locks or permissions are invalid.","headings":[{"id":"protected-paths","text":"Protected paths"},{"id":"shell-hardening","text":"Shell hardening"},{"id":"secret-redaction","text":"Secret redaction"},{"id":"capability-lock","text":"Capability lock"},{"id":"human-action-gate","text":"Human-action gate"},{"id":"verify-evidence","text":"Real checks"}]},{"href":"/en/architecture","icon":"layers","group":"Operate","nav":"Architecture","title":"Repository architecture","lead":"Core holds reusable policy and runtime infrastructure; business logic stays in the project that owns it.","headings":[{"id":"composition","text":"Composition"},{"id":"runtime-adapters","text":"Runtime adapters"},{"id":"core-services","text":"Core services"},{"id":"integrations","text":"Integrations"},{"id":"entrypoints","text":"Entrypoints"},{"id":"product-assets","text":"Product assets"},{"id":"adaptive-runtime","text":"Piagent now separates runtime decisions from Pi wiring"},{"id":"state-ownership","text":"Each state has one source of truth"}]},{"href":"/en/context-engine","icon":"cpu","group":"Operate","nav":"Context Engine","title":"Less context, same model quality","lead":"Local indexing, ranked retrieval, task-driven tool loading, semantic compaction and transparent telemetry.","headings":[{"id":"dynamic-tools","text":"Task-driven tools"},{"id":"local-index","text":"Local index"},{"id":"ranked-context","text":"Ranked context"},{"id":"semantic-compact","text":"Semantic compaction"},{"id":"test-impact","text":"Test impact"},{"id":"agent-watch","text":"Agent Watch"}]},{"href":"/en/benchmark","icon":"chart","group":"Operate","nav":"Benchmark","title":"Quality and efficiency evidence","lead":"Piagent against codex-cli on the same model and thinking level: 18 task families, 108 automatically graded sessions.","headings":[{"id":"benchmark-verdict","text":"Historical fresh-token score: 9.97/10"},{"id":"configuration","text":"Same model, same tasks, automatic grading"},{"id":"scores","text":"Token reduction does not trade away quality"},{"id":"tokens","text":"Measure the fixed workload, not only successful tasks"},{"id":"coverage","text":"Six domains with three families each"},{"id":"benchmark-bands","text":"Use the right suite for the decision"},{"id":"transparency","text":"Interpret results within their measured scope"},{"id":"historical-v1-2-12","text":"v1.2.12 remains historical evidence"}]},{"href":"/en/runtime","icon":"wrench","group":"Operate","nav":"Runtime tools","title":"Terminal commands for operators","lead":"Commands that run outside Pi: setup, updates, doctor, benchmarks, capabilities and MCP.","headings":[]},{"href":"/en/team","icon":"users","group":"Operate","nav":"Team usage","title":"One operating standard for the team","lead":"Each repository links the package, selects a fitting profile and keeps project documentation in its own repository.","headings":[{"id":"do","text":"Do"},{"id":"avoid","text":"Avoid"}]}]