@piagent/platform 1.1.8 → 1.2.0

package/docs-site/assets/docs.css

@@ -0,0 +1,1001 @@
+:root {
+  color-scheme: dark;
+  --bg: #050505;
+  --bg-soft: #0b0b0d;
+  --panel: #101114;
+  --panel-strong: #15171b;
+  --text: #f4f4ef;
+  --muted: #a4a6ad;
+  --muted-2: #71747d;
+  --line: #24262d;
+  --line-soft: #191b20;
+  --accent: #d8ff7a;
+  --accent-2: #8be9c8;
+  --danger: #ff8f8f;
+  --warning: #ffd166;
+  --ok: #8be9c8;
+  --shadow: 0 24px 90px rgba(0, 0, 0, 0.45);
+  --radius: 22px;
+  --sidebar: 294px;
+  --content: 1260px;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+html {
+  scroll-behavior: smooth;
+}
+
+body {
+  margin: 0;
+  min-height: 100vh;
+  background:
+    radial-gradient(circle at 18% -10%, rgba(216, 255, 122, 0.12), transparent 34rem),
+    radial-gradient(circle at 88% 8%, rgba(139, 233, 200, 0.1), transparent 30rem),
+    linear-gradient(180deg, #050505 0%, #07080a 55%, #050505 100%);
+  color: var(--text);
+  font-family: "Be Vietnam Pro", ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  line-height: 1.65;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+a:hover {
+  color: var(--accent);
+}
+
+code,
+pre {
+  font-family: "JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+}
+
+.topbar {
+  position: sticky;
+  top: 0;
+  z-index: 30;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  height: 62px;
+  padding: 0 28px;
+  border-bottom: 1px solid rgba(255, 255, 255, 0.08);
+  background: rgba(5, 5, 5, 0.78);
+  backdrop-filter: blur(20px);
+}
+
+.brand {
+  display: inline-flex;
+  align-items: center;
+  gap: 12px;
+  min-width: 0;
+  font-weight: 700;
+  letter-spacing: -0.03em;
+}
+
+.brand-mark {
+  display: grid;
+  place-items: center;
+  width: 34px;
+  height: 34px;
+  border: 1px solid rgba(216, 255, 122, 0.32);
+  border-radius: 11px;
+  background:
+    linear-gradient(135deg, rgba(216, 255, 122, 0.12), transparent),
+    #0d0f12;
+  color: var(--accent);
+  font-family: "JetBrains Mono", monospace;
+  font-size: 13px;
+  overflow: hidden;
+  box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.04);
+}
+
+.brand-mark img {
+  display: block;
+  width: 100%;
+  height: 100%;
+}
+
+.brand span:last-child {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.top-actions {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+}
+
+.pill {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  min-height: 34px;
+  padding: 6px 12px;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: 999px;
+  background: rgba(255, 255, 255, 0.035);
+  color: var(--muted);
+  font-size: 12px;
+  font-weight: 600;
+}
+
+.pill-dot {
+  width: 7px;
+  height: 7px;
+  border-radius: 999px;
+  background: var(--ok);
+  box-shadow: 0 0 18px rgba(139, 233, 200, 0.6);
+}
+
+.layout {
+  display: grid;
+  grid-template-columns: var(--sidebar) minmax(0, 1fr);
+  gap: 0;
+  width: 100%;
+}
+
+.sidebar {
+  position: sticky;
+  top: 62px;
+  align-self: start;
+  height: calc(100vh - 62px);
+  padding: 28px 22px 28px 28px;
+  overflow-y: auto;
+  border-right: 1px solid rgba(255, 255, 255, 0.08);
+  background: linear-gradient(180deg, rgba(255, 255, 255, 0.025), rgba(255, 255, 255, 0));
+}
+
+.sidebar-search {
+  position: relative;
+  margin-bottom: 26px;
+}
+
+.sidebar-search input {
+  width: 100%;
+  height: 42px;
+  padding: 0 14px 0 38px;
+  border: 1px solid var(--line);
+  border-radius: 14px;
+  outline: none;
+  background: rgba(255, 255, 255, 0.04);
+  color: var(--text);
+  font: inherit;
+  font-size: 13px;
+}
+
+.sidebar-search input:focus {
+  border-color: rgba(216, 255, 122, 0.5);
+  box-shadow: 0 0 0 4px rgba(216, 255, 122, 0.08);
+}
+
+.sidebar-search svg {
+  position: absolute;
+  left: 13px;
+  top: 50%;
+  width: 15px;
+  height: 15px;
+  color: var(--muted-2);
+  transform: translateY(-50%);
+}
+
+.nav-group {
+  margin: 0 0 22px;
+}
+
+.nav-title {
+  margin: 0 0 9px;
+  color: var(--muted-2);
+  font-size: 11px;
+  font-weight: 700;
+  letter-spacing: 0.11em;
+  text-transform: uppercase;
+}
+
+.nav-link {
+  display: flex;
+  align-items: center;
+  min-height: 34px;
+  padding: 7px 10px;
+  border-radius: 11px;
+  color: var(--muted);
+  font-size: 13px;
+  font-weight: 500;
+  transition: background 160ms ease, color 160ms ease, transform 160ms ease;
+}
+
+.nav-link:hover,
+.nav-link.active {
+  background: rgba(255, 255, 255, 0.06);
+  color: var(--text);
+}
+
+.nav-link.active {
+  box-shadow: inset 2px 0 0 var(--accent);
+}
+
+main {
+  min-width: 0;
+  display: flex;
+  justify-content: center;
+}
+
+.content-shell {
+  width: min(100%, var(--content));
+  padding: 58px 56px 96px;
+}
+
+.hero {
+  position: relative;
+  overflow: hidden;
+  padding: 42px;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: 30px;
+  background:
+    linear-gradient(135deg, rgba(216, 255, 122, 0.13), transparent 38%),
+    linear-gradient(180deg, rgba(255, 255, 255, 0.055), rgba(255, 255, 255, 0.018)),
+    var(--panel);
+  box-shadow: var(--shadow);
+}
+
+.hero::after {
+  content: "";
+  position: absolute;
+  inset: auto -18% -58% 32%;
+  height: 280px;
+  border-radius: 50%;
+  background: radial-gradient(circle, rgba(139, 233, 200, 0.16), transparent 64%);
+  pointer-events: none;
+}
+
+.eyebrow {
+  display: inline-flex;
+  align-items: center;
+  gap: 9px;
+  margin: 0 0 18px;
+  color: var(--accent);
+  font-size: 12px;
+  font-weight: 700;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+}
+
+.eyebrow::before {
+  content: "";
+  width: 8px;
+  height: 8px;
+  border-radius: 999px;
+  background: var(--accent);
+  box-shadow: 0 0 24px rgba(216, 255, 122, 0.8);
+}
+
+h1,
+h2,
+h3 {
+  margin: 0;
+  line-height: 1.12;
+  letter-spacing: -0.055em;
+}
+
+h1 {
+  max-width: 860px;
+  font-size: clamp(42px, 8vw, 82px);
+  font-weight: 800;
+}
+
+h2 {
+  font-size: clamp(30px, 4vw, 48px);
+  font-weight: 800;
+}
+
+h3 {
+  font-size: 20px;
+  font-weight: 700;
+  letter-spacing: -0.035em;
+}
+
+p {
+  margin: 0;
+  color: var(--muted);
+}
+
+.hero p {
+  position: relative;
+  z-index: 1;
+  max-width: 760px;
+  margin-top: 20px;
+  color: #d6d7dc;
+  font-size: 17px;
+}
+
+.hero-actions {
+  position: relative;
+  z-index: 1;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+  margin-top: 28px;
+}
+
+.button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 9px;
+  min-height: 42px;
+  padding: 10px 16px;
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  border-radius: 999px;
+  background: rgba(255, 255, 255, 0.055);
+  color: var(--text);
+  font-size: 13px;
+  font-weight: 700;
+  cursor: pointer;
+  transition: background 160ms ease, border-color 160ms ease, color 160ms ease;
+}
+
+.button:hover,
+.button:focus-visible {
+  border-color: rgba(216, 255, 122, 0.45);
+  background: rgba(216, 255, 122, 0.1);
+  color: var(--accent);
+}
+
+.button.primary {
+  border-color: transparent;
+  background: var(--accent);
+  color: #111300;
+}
+
+.button.primary:hover,
+.button.primary:focus-visible {
+  background: #e5ff98;
+  color: #111300;
+}
+
+.button.social {
+  min-height: 34px;
+  padding: 7px 12px;
+  color: #d6d7dc;
+}
+
+.button.social svg {
+  width: 14px;
+  height: 14px;
+}
+
+.owner-strip {
+  position: relative;
+  z-index: 1;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 10px;
+  margin-top: 18px;
+}
+
+.owner-label {
+  color: var(--muted-2);
+  font-size: 12px;
+  font-weight: 800;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+}
+
+.owner-strip a {
+  display: inline-flex;
+  align-items: center;
+  gap: 7px;
+  padding: 7px 11px;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: 999px;
+  background: rgba(255, 255, 255, 0.04);
+  color: #d6d7dc;
+  font-size: 12px;
+  font-weight: 700;
+}
+
+.owner-strip a:hover,
+.owner-strip a:focus-visible {
+  border-color: rgba(216, 255, 122, 0.42);
+  color: var(--accent);
+}
+
+.section {
+  padding-top: 86px;
+  scroll-margin-top: 86px;
+}
+
+.section-kicker {
+  margin-bottom: 12px;
+  color: var(--accent-2);
+  font-size: 12px;
+  font-weight: 800;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+}
+
+.section-lead {
+  max-width: 820px;
+  margin-top: 18px;
+  font-size: 16px;
+}
+
+.grid {
+  display: grid;
+  gap: 16px;
+  margin-top: 28px;
+}
+
+.grid.cols-2 {
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+.grid.cols-3 {
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+}
+
+.card {
+  padding: 22px;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: var(--radius);
+  background: linear-gradient(180deg, rgba(255, 255, 255, 0.045), rgba(255, 255, 255, 0.018));
+}
+
+.card strong {
+  color: var(--text);
+}
+
+.card p {
+  margin-top: 10px;
+  font-size: 14px;
+}
+
+.steps {
+  display: grid;
+  gap: 14px;
+  margin-top: 28px;
+  counter-reset: steps;
+}
+
+.step {
+  counter-increment: steps;
+  display: grid;
+  grid-template-columns: 44px minmax(0, 1fr);
+  gap: 16px;
+  padding: 20px;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: var(--radius);
+  background: rgba(255, 255, 255, 0.028);
+}
+
+.step::before {
+  content: counter(steps, decimal-leading-zero);
+  display: grid;
+  place-items: center;
+  width: 42px;
+  height: 42px;
+  border-radius: 14px;
+  background: rgba(216, 255, 122, 0.12);
+  color: var(--accent);
+  font-family: "JetBrains Mono", monospace;
+  font-size: 13px;
+  font-weight: 800;
+}
+
+.step p {
+  margin-top: 8px;
+  font-size: 14px;
+}
+
+/* One card per row. Half the content width holds about 45 characters, which is
+   shorter than most of the commands these cards exist to show — the rest ran
+   off the edge behind a scrollbar. Wrapping them instead is no better here,
+   because a wrapped line and a second command look alike. */
+.command-grid {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  gap: 14px;
+  margin-top: 28px;
+}
+
+.command-card {
+  overflow: hidden;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: var(--radius);
+  background: #08090b;
+}
+
+.command-card header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  padding: 14px 16px;
+  border-bottom: 1px solid var(--line-soft);
+  background: rgba(255, 255, 255, 0.025);
+}
+
+.command-card header span {
+  color: var(--text);
+  font-size: 13px;
+  font-weight: 700;
+}
+
+/* The card carries no padding of its own — `header` and `pre` bring theirs. A
+   heading or paragraph placed directly in the card would otherwise sit on the
+   border, where the rounded corner clips its first letter. */
+.command-card > h3,
+.command-card > p {
+  padding: 0 16px;
+}
+
+.command-card > h3 {
+  padding-top: 16px;
+}
+
+.command-card > h3 + p {
+  margin-top: 8px;
+}
+
+.command-card > p:last-child {
+  padding-bottom: 16px;
+}
+
+.command-card > p + pre {
+  margin-top: 14px;
+}
+
+.clip-btn {
+  min-width: 74px;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: 999px;
+  background: rgba(255, 255, 255, 0.05);
+  color: var(--muted);
+  font: inherit;
+  font-size: 12px;
+  font-weight: 700;
+  cursor: pointer;
+  padding: 6px 10px;
+}
+
+.clip-btn:hover,
+.clip-btn:focus-visible {
+  color: var(--accent);
+  border-color: rgba(216, 255, 122, 0.45);
+}
+
+pre {
+  margin: 0;
+  padding: 16px;
+  overflow-x: auto;
+  color: #e9e9e3;
+  font-size: 13px;
+  line-height: 1.65;
+}
+
+code {
+  color: #f5f5f0;
+}
+
+.inline-code {
+  padding: 2px 6px;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: 7px;
+  background: rgba(255, 255, 255, 0.05);
+  color: var(--accent-2);
+  font-family: "JetBrains Mono", monospace;
+  font-size: 0.91em;
+}
+
+.table-wrap {
+  margin-top: 28px;
+  overflow: hidden;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: var(--radius);
+}
+
+table {
+  width: 100%;
+  border-collapse: collapse;
+  background: rgba(255, 255, 255, 0.02);
+}
+
+th,
+td {
+  padding: 16px;
+  border-bottom: 1px solid var(--line-soft);
+  text-align: left;
+  vertical-align: top;
+  font-size: 14px;
+}
+
+th {
+  color: var(--text);
+  font-size: 12px;
+  letter-spacing: 0.09em;
+  text-transform: uppercase;
+}
+
+td {
+  color: var(--muted);
+}
+
+tr:last-child td {
+  border-bottom: 0;
+}
+
+.tag-list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-top: 16px;
+}
+
+.tag {
+  padding: 6px 10px;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: 999px;
+  color: var(--muted);
+  font-family: "JetBrains Mono", monospace;
+  font-size: 12px;
+}
+
+.callout {
+  margin-top: 28px;
+  padding: 20px;
+  border: 1px solid rgba(255, 209, 102, 0.26);
+  border-radius: var(--radius);
+  background: rgba(255, 209, 102, 0.07);
+}
+
+.callout strong {
+  color: var(--warning);
+}
+
+.callout p {
+  margin-top: 8px;
+}
+
+.callout ul {
+  margin: 12px 0 0;
+  padding-left: 20px;
+  color: var(--muted);
+}
+
+.ok-callout {
+  border-color: rgba(139, 233, 200, 0.22);
+  background: rgba(139, 233, 200, 0.065);
+}
+
+.ok-callout strong {
+  color: var(--ok);
+}
+
+.split {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 16px;
+  margin-top: 28px;
+}
+
+.footer {
+  margin-top: 90px;
+  padding-top: 28px;
+  border-top: 1px solid rgba(255, 255, 255, 0.1);
+  color: var(--muted-2);
+  font-size: 13px;
+}
+
+.footer-links {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+  margin-top: 14px;
+}
+
+.footer-links a {
+  color: var(--muted);
+  font-weight: 700;
+}
+
+.footer-links a:hover,
+.footer-links a:focus-visible {
+  color: var(--accent);
+}
+
+.mobile-menu {
+  display: none;
+}
+
+@media (max-width: 1020px) {
+  .layout {
+    grid-template-columns: 1fr;
+  }
+
+  .sidebar {
+    position: fixed;
+    inset: 62px 0 auto;
+    z-index: 25;
+    display: none;
+    height: calc(100vh - 62px);
+    padding: 22px;
+    background: rgba(5, 5, 5, 0.96);
+  }
+
+  .sidebar.open {
+    display: block;
+  }
+
+  .mobile-menu {
+    display: inline-flex;
+  }
+
+  .content-shell {
+    width: min(100%, 980px);
+    padding: 38px 22px 76px;
+  }
+
+  .hero {
+    padding: 30px;
+  }
+}
+
+@media (max-width: 760px) {
+  .topbar {
+    padding: 0 16px;
+  }
+
+  .top-actions .pill {
+    display: none;
+  }
+
+  .button.social {
+    display: none;
+  }
+
+  .grid.cols-2,
+  .grid.cols-3,
+  .split {
+    grid-template-columns: 1fr;
+  }
+
+  th,
+  td {
+    display: block;
+    width: 100%;
+  }
+
+  th {
+    border-bottom: 0;
+    padding-bottom: 4px;
+  }
+
+  td {
+    padding-top: 4px;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  html {
+    scroll-behavior: auto;
+  }
+
+  *,
+  *::before,
+  *::after {
+    transition: none !important;
+  }
+}
+
+/* ---------------------------------------------------------------------------
+   Multi-page shell
+   The single-page site had one column of prose under a sidebar. A page per topic
+   needs three things it did not: a place to say where you are, a map of the page
+   you are on, and a way to the next page without going back to the sidebar.
+   --------------------------------------------------------------------------- */
+
+.layout.with-toc {
+  grid-template-columns: var(--sidebar) minmax(0, 1fr) 232px;
+}
+
+.toc {
+  position: sticky;
+  top: 62px;
+  align-self: start;
+  max-height: calc(100vh - 62px);
+  overflow-y: auto;
+  padding: 58px 26px 60px 8px;
+  border-left: 1px solid var(--line-soft);
+}
+
+.toc-title {
+  margin: 0 0 12px;
+  font-size: 11px;
+  letter-spacing: 0.16em;
+  text-transform: uppercase;
+  color: var(--muted-2);
+}
+
+.toc a {
+  display: block;
+  padding: 5px 0 5px 12px;
+  border-left: 2px solid transparent;
+  color: var(--muted);
+  font-size: 13px;
+  line-height: 1.45;
+  text-decoration: none;
+  transition: color 0.15s ease, border-color 0.15s ease;
+}
+
+.toc a:hover {
+  color: var(--text);
+}
+
+.toc a.active {
+  color: var(--accent);
+  border-left-color: var(--accent);
+}
+
+.toc a.toc-h3 {
+  padding-left: 24px;
+  font-size: 12.5px;
+}
+
+.breadcrumb {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 18px;
+  font-size: 12.5px;
+  color: var(--muted-2);
+}
+
+.breadcrumb a {
+  color: var(--muted);
+  text-decoration: none;
+}
+
+.breadcrumb a:hover {
+  color: var(--text);
+}
+
+.breadcrumb span[aria-hidden] {
+  color: var(--line);
+}
+
+.page-head {
+  margin-bottom: 34px;
+}
+
+.page-head h1 {
+  margin: 0 0 12px;
+  font-size: clamp(30px, 3.4vw, 42px);
+  line-height: 1.12;
+  letter-spacing: -0.02em;
+}
+
+.page-head p {
+  margin: 0;
+  max-width: 62ch;
+  color: var(--muted);
+  font-size: 16px;
+  line-height: 1.6;
+}
+
+.pager {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+  gap: 14px;
+  margin-top: 56px;
+  padding-top: 30px;
+  border-top: 1px solid var(--line-soft);
+}
+
+.pager a {
+  display: flex;
+  flex-direction: column;
+  gap: 5px;
+  padding: 16px 18px;
+  border: 1px solid var(--line);
+  border-radius: 14px;
+  background: var(--panel);
+  color: var(--text);
+  text-decoration: none;
+  transition: border-color 0.15s ease, transform 0.15s ease;
+}
+
+.pager a:hover {
+  border-color: var(--accent);
+  transform: translateY(-1px);
+}
+
+.pager .pager-next {
+  text-align: right;
+  grid-column: -2;
+}
+
+.pager-label {
+  font-size: 11px;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: var(--muted-2);
+}
+
+.pager-title {
+  font-weight: 600;
+  font-size: 15px;
+}
+
+/* Landing-page card grid: the entry points, as cards rather than a wall of prose. */
+.card-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(248px, 1fr));
+  gap: 14px;
+}
+
+.doc-card {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 22px;
+  border: 1px solid var(--line);
+  border-radius: 16px;
+  background: var(--panel);
+  color: inherit;
+  text-decoration: none;
+  transition: border-color 0.15s ease, transform 0.15s ease;
+}
+
+.doc-card:hover {
+  border-color: var(--accent);
+  transform: translateY(-2px);
+}
+
+.doc-card h3 {
+  margin: 0;
+  font-size: 16px;
+}
+
+.doc-card p {
+  margin: 0;
+  color: var(--muted);
+  font-size: 14px;
+  line-height: 1.55;
+}
+
+.doc-card .card-kicker {
+  font-size: 11px;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: var(--accent);
+}
+
+/* An anchor target under a sticky header lands with its heading hidden. */
+.section[id],
+h2[id],
+h3[id] {
+  scroll-margin-top: 84px;
+}
+
+.nav-link.current {
+  color: var(--accent);
+  background: var(--panel-strong);
+}
+
+@media (max-width: 1180px) {
+  .layout.with-toc {
+    grid-template-columns: var(--sidebar) minmax(0, 1fr);
+  }
+
+  .toc {
+    display: none;
+  }
+}