@arizeai/phoenix-cli 1.9.0 → 1.10.0

package/build/oauthCallbackPage.js

@@ -0,0 +1,111 @@
+/**
+ * The Phoenix bird mark, inlined so the loopback callback page renders
+ * without any network access to the Phoenix server.
+ */
+const PHOENIX_MARK_SVG = `<svg width="44" height="50" viewBox="0 0 148 169" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Phoenix"><path d="M147.458 105.593C147.022 103.63 146.028 101.824 144.492 100.222C143.901 99.6064 143.244 99.0233 142.529 98.4978C142.184 98.2432 141.815 98.005 141.437 97.7669C140.969 97.4712 140.484 97.192 139.95 96.921C137.995 95.9191 136.328 94.909 134.866 93.825C134.274 93.3897 133.699 92.9299 133.157 92.4535C131.851 91.312 130.972 90.3348 130.315 89.3C130.102 88.9715 129.913 88.6102 129.732 88.2653C129.658 88.1175 129.543 87.9943 129.412 87.8957C129.173 87.7233 128.869 87.6494 128.565 87.6986C128.097 87.789 127.736 88.1667 127.678 88.6431C127.637 89.0126 127.637 89.4068 127.687 89.8092C127.719 90.0474 127.588 90.2773 127.366 90.3758C127.317 90.4005 127.259 90.4087 127.21 90.4169C126.898 90.4498 126.619 90.6222 126.438 90.885C126.257 91.1478 126.208 91.4681 126.282 91.7719C126.348 92.0347 126.438 92.2236 126.512 92.3714L126.578 92.5028C126.627 92.5931 126.676 92.6917 126.726 92.782C126.873 93.0612 127.021 93.3405 127.202 93.6033C127.547 94.1042 127.933 94.6052 128.393 95.1389C128.541 95.3114 128.565 95.5578 128.459 95.7549C128.352 95.952 128.13 96.0669 127.908 96.0341C125.321 95.681 122.996 95.0979 120.836 94.3013C120.59 94.211 120.335 94.1206 120.097 94.0221C118.158 93.2009 121.658 89.7189 123.259 87.247C130.282 76.4479 131.736 64.0802 131.794 51.5647C131.851 39.4681 130.545 27.5357 128.138 15.7593V15.7429C126.569 5.87173 125.239 2.168 124.401 0.796558C124.22 0.435219 124.023 0.205276 123.818 0.0985162C123.588 -0.0575166 123.465 0.0163937 123.465 0.0163937C123.013 0.0328182 122.495 0.435219 121.871 1.08399C119.251 3.83509 119.399 7.11178 120.122 10.5363C123.432 26.0903 125.921 41.7346 124.787 57.7157C124.007 68.7365 121.953 79.3468 114.248 87.9779C113.789 88.4952 113.287 88.9798 112.786 89.4725C112.211 90.0391 111.316 91.1396 110.651 90.6797C109.764 90.0638 110.552 88.7991 110.831 88.1421C115.341 77.5729 116.639 66.5275 115.949 55.1453C115.932 54.8825 115.908 54.6197 115.891 54.3569V54.3405C115.883 54.1269 115.858 53.9298 115.842 53.7245C115.727 52.2217 115.587 50.7189 115.398 49.2242C113.46 31.1655 111.127 29.9911 111.127 29.9911C110.971 29.8515 110.782 29.7448 110.528 29.6955C109.304 29.4409 108.638 30.5167 108.096 31.3297C105.648 34.9924 106.733 38.8932 107.521 42.753C110.289 56.2703 110.33 69.6645 105.583 82.8124C105.147 84.0113 104.63 85.1775 104.08 86.3272C103.496 87.5508 103.119 89.0783 101.131 88.4213C99.2662 87.8054 99.7918 86.3929 100.03 85.1036C100.654 81.8269 101.155 78.542 101.467 75.2489V75.2653C101.509 74.9368 101.525 74.6247 101.55 74.3127C101.599 73.746 101.632 73.1712 101.665 72.6045C101.689 72.1282 101.714 71.6601 101.739 71.2002C101.747 70.9621 101.763 70.7321 101.763 70.494C102.141 60.0562 100.383 55.3095 99.7179 53.9052C99.644 53.7328 99.5619 53.5767 99.4715 53.4371C98.7815 52.4024 97.6398 52.5256 96.6541 53.5028C94.8388 55.2931 93.8367 57.4118 94.2967 60.0808C95.6438 67.8496 94.8552 75.5445 93.4096 83.1983C93.2124 84.2249 92.7524 86.0973 90.5593 85.6127C89.0644 85.2842 88.7194 84.6437 88.6372 83.3461C88.6537 82.3689 88.6372 81.3916 88.6044 80.4144C88.6044 80.3897 88.6044 80.3651 88.6044 80.3405C88.6044 80.2009 88.588 80.0612 88.588 79.9299C88.588 79.8559 88.5797 79.7902 88.5715 79.7245C88.5058 78.3942 88.399 77.0556 88.2347 75.717C88.2183 75.5856 88.1937 75.4624 88.1773 75.331C87.3394 67.7921 86.247 67.0612 86.247 67.0612C85.5488 66.1497 84.4563 66.3057 83.5117 67.2419C81.6964 69.0322 80.7764 71.1427 81.1543 73.8199C81.4336 75.7745 81.3596 75.175 81.5568 76.8831C81.7128 77.7618 81.8771 79.3632 81.8935 79.8724C81.8525 80.324 81.7375 80.7182 81.4582 81.0139C80.53 82.0076 79.0351 80.9892 77.9015 80.5211C55.9209 71.4302 37.1108 58.6683 20.691 42.523C14.2513 35.945 3.25273 22.6329 3.25273 22.6329C2.84203 22.1566 2.33276 21.8856 1.55243 22.2223C0.114982 22.8383 0.156052 24.6778 0.0246278 26.2217C-0.23822 29.3177 1.42101 31.5597 3.21987 33.662C28.0179 62.5856 58.2783 83.3708 94.8059 93.7675L101.377 95.5085C101.451 95.5249 101.533 95.5496 101.607 95.566C101.624 95.566 101.632 95.566 101.64 95.5742L107.299 97.077L107.456 97.1181C107.267 97.1756 107.061 97.2167 106.839 97.2577C100.613 98.4895 88.2923 96.223 78.3944 93.9153C73.4988 92.8888 68.6854 91.6405 63.9788 90.1541C63.7653 90.0884 63.642 90.0556 63.642 90.0556C45.3577 84.2331 28.6093 74.7972 13.9556 60.4093C12.5674 59.0461 11.286 57.5761 10.0211 56.0897C8.86289 54.71 6.47262 51.8275 5.643 50.8338C5.55265 50.7024 5.45408 50.5875 5.35551 50.4807C5.10909 50.2261 4.80517 50.0619 4.36983 50.1604C3.3513 50.3986 3.05559 51.4498 2.86667 52.3367C2.1192 55.9008 3.25273 58.8983 5.65122 61.5755C20.6582 78.3942 39.4929 89.1358 60.6439 96.1819C72.6528 100.181 85.0067 102.612 97.6069 104.164C90.0911 106.595 82.3617 107.334 74.5667 107.137C59.4775 106.759 45.3248 103.138 32.0264 96.6746C27.1226 94.1535 22.5556 91.3449 21.3564 90.5894C20.6664 90.1213 19.9518 89.8338 19.2454 90.3758C17.9229 91.4024 18.8347 93.2009 19.2618 94.6051C20.075 97.307 21.956 99.1712 24.3956 100.46C46.0641 111.917 68.9401 116.499 93.2946 112.434C95.7588 112.023 98.0998 111.572 100.679 110.701C96.6048 114.224 91.89 116.524 86.9369 118.339C71.6835 123.915 56.5287 123.693 41.4314 119.915C36.5851 118.618 30.9668 116.507 30.9668 116.507C30.1536 116.154 29.3486 116.031 28.7243 116.926C27.6237 118.503 28.5847 120.145 29.5375 121.632C31.7882 125.138 36.1416 125.483 39.5832 126.674C40.7578 127.052 37.5544 129.187 36.5276 129.975C31.5335 133.794 26.6462 137.284 21.6767 140.98L18.424 143.378C17.8654 143.764 17.3726 144.199 17.6272 145.004C17.9229 145.915 18.8675 146.08 19.7875 146.268C23.3442 147.008 26.3833 145.825 29.1925 143.723C35.2134 139.214 41.3493 134.837 47.2387 130.156C49.4811 128.374 51.5182 128.522 54.582 129.31C46.9183 135.083 39.7475 140.495 32.5685 145.899C25.2827 151.376 17.9969 156.854 10.711 162.323L5.89764 165.888C5.82371 165.937 5.758 165.986 5.69229 166.044L5.61836 166.093C5.20766 166.421 4.90374 166.791 4.9941 167.267C5.19123 168.351 6.4644 168.622 7.50758 168.803C11.8117 169.542 14.4813 167.924 17.4219 165.715C32.1496 154.661 46.9266 143.682 61.5721 132.521C64.8577 130.016 68.2337 128.604 72.9731 129.138C68.9401 132.152 65.0631 135.051 61.2436 137.908L50.8611 145.587C50.7871 145.636 50.7132 145.694 50.6475 145.751C50.0972 146.186 49.7111 146.695 49.9247 147.451C50.3189 148.822 51.97 148.987 53.3745 149.2C55.9537 149.586 58.1387 148.675 60.1675 147.164C61.3339 146.293 62.5085 145.439 63.6831 144.593L79.5361 132.004C79.5361 132.004 83.2817 129.327 87.6187 126.871C88.0048 126.633 88.3908 126.387 88.7851 126.148C88.9494 126.075 89.3601 125.886 89.9843 125.59C90.4525 125.352 90.9207 125.114 91.3807 124.892C92.0625 124.547 92.851 124.128 93.7381 123.644C96.2927 122.584 103.611 119.168 109.657 112.73C112.532 110.512 116.581 107.613 119.735 106.217H119.752C119.99 106.111 120.228 106.012 120.458 105.93C120.458 105.93 120.475 105.93 120.483 105.922C120.639 105.864 120.787 105.815 120.935 105.766L121.337 105.61C122.479 105.289 124.335 105.166 124.582 107.679C124.623 108.295 124.615 108.927 124.541 109.593C124.491 110.093 124.393 110.627 124.319 111.054C124.245 111.465 124.417 111.876 124.746 112.122C124.795 112.163 124.853 112.196 124.91 112.22C125.346 112.434 125.871 112.335 126.2 111.974C126.323 111.834 126.446 111.703 126.569 111.572C128.122 109.937 129.699 108.804 131.375 108.114C133.822 107.104 136.303 107.096 138.94 108.106C140.197 108.582 141.379 109.239 142.554 110.102C143.055 110.471 143.556 110.882 144.057 111.334C144.353 111.605 144.648 111.9 144.911 112.163L144.952 112.204L145.166 112.418C145.166 112.418 145.248 112.491 145.289 112.524C145.536 112.705 145.856 112.779 146.168 112.713C146.529 112.631 146.825 112.376 146.957 112.032C146.981 111.966 147.006 111.9 147.031 111.834C147.778 109.617 147.934 107.581 147.499 105.593H147.458Z" fill="url(#px_mark_gradient)"/><defs><linearGradient id="px_mark_gradient" x1="22.0956" y1="10.3474" x2="97.4433" y2="140.879" gradientUnits="userSpaceOnUse"><stop stop-color="#14BAB6"/><stop offset="0.5" stop-color="#00ADEE"/><stop offset="1" stop-color="#0095C4"/></linearGradient></defs></svg>`;
+const CHECK_ICON = `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"><path d="M5 12.5L10 17.5L19 7" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/></svg>`;
+const CROSS_ICON = `<svg width="14" height="14" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"><path d="M6 6L18 18M18 6L6 18" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"/></svg>`;
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+function getCallbackPageContent(result) {
+    switch (result.status) {
+        case "success":
+            return {
+                badgeVariant: "success",
+                badgeIcon: CHECK_ICON,
+                title: "You're all set",
+                body: "The Phoenix CLI is now connected. You can close this tab and return to your terminal.",
+            };
+        case "access_denied":
+            return {
+                badgeVariant: "neutral",
+                badgeIcon: CROSS_ICON,
+                title: "Authorization cancelled",
+                body: "No access was granted. You can close this tab — rerun px auth login if this was a mistake.",
+            };
+        case "invalid":
+            return {
+                badgeVariant: "danger",
+                badgeIcon: CROSS_ICON,
+                title: "Something went wrong",
+                body: `${escapeHtml(result.message)} Return to your terminal and try running px auth login again.`,
+            };
+    }
+}
+/**
+ * Render the standalone HTML page shown in the browser after the OAuth2
+ * authorization redirect lands on the CLI's loopback callback server. The
+ * page is fully self-contained (inline styles and SVG) because the loopback
+ * server serves nothing else.
+ */
+export function renderOAuthCallbackPage(result) {
+    const content = getCallbackPageContent(result);
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<meta name="color-scheme" content="light dark" />
+<title>Phoenix CLI login</title>
+<style>
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  html { color-scheme: light dark; }
+  html, body { height: 100%; }
+  body {
+    font-family: system-ui, sans-serif;
+    background-color: Canvas;
+    color: CanvasText;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    padding: 24px;
+  }
+  main {
+    max-width: 420px;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    text-align: center;
+  }
+  .mark { position: relative; margin-bottom: 24px; }
+  .badge {
+    position: absolute;
+    right: -10px;
+    bottom: -6px;
+    width: 22px;
+    height: 22px;
+    border-radius: 50%;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    background-color: Canvas;
+    box-shadow: inset 0 0 0 1.5px currentColor;
+  }
+  .badge--success { color: #3d9a63; }
+  .badge--danger { color: #d64545; }
+  .badge--neutral { color: GrayText; }
+  h1 { font-size: 20px; font-weight: 600; margin-bottom: 10px; }
+  p { font-size: 14px; line-height: 1.6; color: GrayText; overflow-wrap: anywhere; }
+  p code { font-family: ui-monospace, monospace; font-size: 13px; }
+</style>
+</head>
+<body>
+  <main>
+    <div class="mark">
+      ${PHOENIX_MARK_SVG}
+      <div class="badge badge--${content.badgeVariant}">${content.badgeIcon}</div>
+    </div>
+    <h1>${content.title}</h1>
+    <p>${content.body.replace(/px auth login/g, "<code>px auth login</code>")}</p>
+  </main>
+</body>
+</html>`;
+}
+//# sourceMappingURL=oauthCallbackPage.js.map

package/build/oauthCallbackPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthCallbackPage.js","sourceRoot":"","sources":["../src/oauthCallbackPage.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,gBAAgB,GAAG,48PAA48P,CAAC;AAEt+P,MAAM,UAAU,GAAG,kPAAkP,CAAC;AAEtQ,MAAM,UAAU,GAAG,0NAA0N,CAAC;AAS9O,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI;SACR,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,sBAAsB,CAC7B,MAA2B;IAE3B,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,SAAS;YACZ,OAAO;gBACL,YAAY,EAAE,SAAS;gBACvB,SAAS,EAAE,UAAU;gBACrB,KAAK,EAAE,gBAAgB;gBACvB,IAAI,EAAE,uFAAuF;aAC9F,CAAC;QACJ,KAAK,eAAe;YAClB,OAAO;gBACL,YAAY,EAAE,SAAS;gBACvB,SAAS,EAAE,UAAU;gBACrB,KAAK,EAAE,yBAAyB;gBAChC,IAAI,EAAE,4FAA4F;aACnG,CAAC;QACJ,KAAK,SAAS;YACZ,OAAO;gBACL,YAAY,EAAE,QAAQ;gBACtB,SAAS,EAAE,UAAU;gBACrB,KAAK,EAAE,sBAAsB;gBAC7B,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,+DAA+D;aACnG,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA2B;IACjE,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqDD,gBAAgB;iCACS,OAAO,CAAC,YAAY,KAAK,OAAO,CAAC,SAAS;;UAEjE,OAAO,CAAC,KAAK;SACd,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,4BAA4B,CAAC;;;QAGrE,CAAC;AACT,CAAC"}

package/build/pxi/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/pxi/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,IAAI,CAAC;AAEZ,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,YAAY,EACb,MAAM,SAAS,CAAC;AAsCjB;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAIT;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,GACP,EAAE;IACD,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKzB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,GAAgB,EAChB,QAA2D,GAC5D,EAAE;IACD,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,sBAAsB,EAAE,OAAO,CAAC;IAChC,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,UAAU,EAAE,CAoBf;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,OAAO,EAAE,iBAAiB,CAAC;CAC5B,GAAG,cAAc,CAgBjB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,OAAO,EACP,KAAK,GACN,EAAE;IACD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC,GAAG,YAAY,CAgBf;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,MAAM,EACN,kBAAkB,GACnB,EAAE;IACD,MAAM,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IACvC,kBAAkB,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;CACnD,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAO7B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,SAAmD,GACpD,EAAE;IACD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B,GAAG,aAAa,CAoBhB;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAMxE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/pxi/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,IAAI,CAAC;AAGZ,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,YAAY,EACb,MAAM,SAAS,CAAC;AAsCjB;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAIT;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,GACP,EAAE;IACD,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASzB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,GAAgB,EAChB,QAA2D,GAC5D,EAAE;IACD,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,sBAAsB,EAAE,OAAO,CAAC;IAChC,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,UAAU,EAAE,CAoBf;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,OAAO,EAAE,iBAAiB,CAAC;CAC5B,GAAG,cAAc,CAgBjB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,OAAO,EACP,KAAK,GACN,EAAE;IACD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC,GAAG,YAAY,CAsBf;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,MAAM,EACN,kBAAkB,GACnB,EAAE;IACD,MAAM,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IACvC,kBAAkB,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;CACnD,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAO7B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,SAAmD,GACpD,EAAE;IACD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B,GAAG,aAAa,CAoBhB;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAMxE"}

package/build/pxi/client.js

@@ -1,4 +1,5 @@
 import { DefaultChatTransport, readUIMessageStream, } from "ai";
+import { createOAuthFetch, hasOAuthCredentials } from "../authFetch.js";
 import { formatPxiRuntimeError } from "./preflight.js";
 /**
  * Chat client for the Phoenix server-agent endpoint.
@@ -42,7 +43,11 @@ export function buildServerAgentChatUrl({ endpoint, sessionId, }) {
 export function buildPxiHeaders({ config, }) {
     return {
         ...(config.headers ?? {}),
-        ...(config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : {}),
+        ...(config.apiKey
+            ? { Authorization: `Bearer ${config.apiKey}` }
+            : config.oauthTokens
+                ? { Authorization: `Bearer ${config.oauthTokens.accessToken}` }
+                : {}),
     };
 }
 /**
@@ -104,13 +109,17 @@ export function createServerAgentTransport({ options, fetch, }) {
     if (!options.config.endpoint) {
         throw new Error("Phoenix endpoint not configured.");
     }
+    const transportFetch = fetch ??
+        (hasOAuthCredentials(options.config)
+            ? createOAuthFetch({ config: options.config })
+            : undefined);
     return new DefaultChatTransport({
         api: buildServerAgentChatUrl({
             endpoint: options.config.endpoint,
             sessionId: options.sessionId,
         }),
         headers: buildPxiHeaders({ config: options.config }),
-        fetch,
+        fetch: transportFetch,
         prepareSendMessagesRequest: ({ messages }) => ({
             body: buildPxiChatRequest({ messages, options }),
         }),

package/build/pxi/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/pxi/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/pxi/client.ts"],"names":[],"mappings":"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"}

package/build/settings.d.ts

@@ -8,11 +8,23 @@
  */
 import { z } from "zod";
 import { InvalidArgumentError } from "./exitCodes.js";
+export declare const OAuthTokensSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    refreshToken: z.ZodString;
+    expiresAt: z.ZodString;
+    scope: z.ZodString;
+}, z.core.$strip>;
 export declare const ProfileEntrySchema: z.ZodObject<{
     endpoint: z.ZodOptional<z.ZodString>;
     apiKey: z.ZodOptional<z.ZodString>;
     project: z.ZodOptional<z.ZodString>;
     headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    oauthTokens: z.ZodOptional<z.ZodObject<{
+        accessToken: z.ZodString;
+        refreshToken: z.ZodString;
+        expiresAt: z.ZodString;
+        scope: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const SettingsFileSchema: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
@@ -22,6 +34,12 @@ export declare const SettingsFileSchema: z.ZodObject<{
         apiKey: z.ZodOptional<z.ZodString>;
         project: z.ZodOptional<z.ZodString>;
         headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        oauthTokens: z.ZodOptional<z.ZodObject<{
+            accessToken: z.ZodString;
+            refreshToken: z.ZodString;
+            expiresAt: z.ZodString;
+            scope: z.ZodString;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
@@ -29,6 +47,7 @@ export declare const SettingsFileSchema: z.ZodObject<{
  * override only a subset of configuration values.
  */
 export type ProfileEntry = z.infer<typeof ProfileEntrySchema>;
+export type OAuthTokens = z.infer<typeof OAuthTokensSchema>;
 /**
  * On-disk schema for the CLI settings file.
  */

package/build/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,kBAAkB;;;;;iBAgC7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;iBAiB7B,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAU9D;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,oBAAoB;IAC9D,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,8FAC8D,CAAC;AAE9F;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAGnC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAMrD;AAsGD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG,SAAS,CAGnD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,YAAY,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG,SAAS,CAKnD;AAMD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAmCxE;AAED,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAON"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,iBAAiB;;;;;iBAoB5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;iBAmC7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;iBAiB7B,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAU9D;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,oBAAoB;IAC9D,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,8FAC8D,CAAC;AAE9F;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAGnC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAMrD;AAsGD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG,SAAS,CAGnD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,YAAY,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG,SAAS,CAKnD;AAMD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAmCxE;AAED,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAUN"}

package/build/settings.js

@@ -11,6 +11,23 @@ import * as os from "os";
 import * as path from "path";
 import { z } from "zod";
 import { InvalidArgumentError } from "./exitCodes.js";
+export const OAuthTokensSchema = z.object({
+    accessToken: z
+        .string()
+        .min(1)
+        .describe("OAuth access token used as a bearer token for Phoenix API requests."),
+    refreshToken: z
+        .string()
+        .min(1)
+        .describe("OAuth refresh token used to rotate the access token when it is near expiry."),
+    expiresAt: z
+        .string()
+        .datetime()
+        .describe("ISO timestamp when the OAuth access token expires."),
+    scope: z
+        .string()
+        .describe("OAuth scope string returned by the token endpoint."),
+});
 export const ProfileEntrySchema = z.object({
     // Deliberately looser than `validation/endpoint.ts`: one invalid field makes
     // a non-strict load discard every profile in the file (see `loadSettings`),
@@ -33,6 +50,7 @@ export const ProfileEntrySchema = z.object({
         .record(z.string(), z.string())
         .optional()
         .describe("Extra HTTP headers sent with every request from this profile. Useful for custom auth or routing. Values override defaults."),
+    oauthTokens: OAuthTokensSchema.optional().describe("OAuth token pair created by `px auth login`. Tokens are secrets and are stored in the settings file with mode 0600."),
 });
 export const SettingsFileSchema = z.object({
     $schema: z
@@ -299,5 +317,8 @@ export function saveSettings(data, options) {
         encoding: "utf-8",
         mode: 0o600,
     });
+    // writeFileSync only applies `mode` when it creates the file; the file holds
+    // secrets (API keys, OAuth tokens), so tighten a pre-existing permissive mode.
+    fs.chmodSync(filePath, 0o600);
 }
 //# sourceMappingURL=settings.js.map

package/build/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/build/setup/agents/registry.d.ts

@@ -10,6 +10,61 @@
 import type { CommandSpec, SetupDeps } from "../deps/index.js";
 import type { Connection } from "../steps/establishConnection.js";
 export type CodingAgentId = "claude" | "codex" | "opencode" | "cursor";
+/** The server name the docs MCP is registered under in agent configs. */
+export declare const DOCS_MCP_SERVER_NAME = "phoenix-docs";
+/**
+ * The Mintlify-hosted Phoenix docs MCP server (streamable HTTP). Searching it
+ * returns just the relevant doc sections, so an agent connected to it needs
+ * neither the `.px/docs` download nor whole-page fetches.
+ */
+export declare const DOCS_MCP_SERVER_URL = "https://arizeai-433a7140.mintlify.app/mcp";
+/**
+ * How the docs MCP server is installed for an agent, scoped to the repo setup
+ * runs in. Absent when the agent has no per-project MCP config (Codex reads
+ * only a global TOML).
+ *
+ * `cli` is preferred wherever the agent ships an MCP subcommand: the installed
+ * binary writes the config format that same binary reads, so the CLI can never
+ * drift from the agent's schema. `file` is the fallback for agents whose only
+ * documented mechanism is hand-editing a JSON file — those shapes mirror
+ * `docs/phoenix/integrations/phoenix-mcp-server.mdx`, which is the contract to
+ * keep them true to.
+ */
+export type DocsMcpInstall = {
+    kind: "cli";
+    /**
+     * Best-effort removal of a previous entry, with its exit code ignored.
+     * Run only after an `add` was refused and `verifyArgs` confirmed an
+     * entry exists under our name — `add` refuses a name that already
+     * exists, and remove-then-retry is what makes a setup re-run
+     * idempotent, while removing any earlier would destroy a working
+     * registration a failed retry can't put back.
+     */
+    removeArgs: string[];
+    /** argv (after the binary) that registers the server. */
+    addArgs(serverUrl: string): string[];
+    /**
+     * Read-back of the entry after `add`; a non-zero exit means the server
+     * is not actually registered. This is the drift guard: if the agent's
+     * flags ever change meaning while still parsing, exit codes alone would
+     * lie, but an entry that doesn't show up in the agent's own listing
+     * cannot.
+     */
+    verifyArgs: string[];
+} | {
+    kind: "file";
+    /**
+     * Config file path, relative to the repo root. Always forward-slash:
+     * Node's fs resolves it on every platform, and the setup report stays
+     * platform-stable (`path.join` would put a backslash in the JSON
+     * envelope on Windows).
+     */
+    relativePath: string;
+    /** Keys applied only when the file is being created, e.g. `$schema`. */
+    createDefaults?: Record<string, unknown>;
+    /** The JSON fragment to merge into that file. */
+    patch(serverUrl: string): Record<string, unknown>;
+};
 /**
  * How the agent is run.
  *
@@ -36,6 +91,8 @@ export interface CodingAgent {
      * after the `exec` subcommand, not before it.
      */
     launchArgs(prompt: string, mode: AgentRunMode): string[];
+    /** See {@link DocsMcpInstall}; absent when the agent has none. */
+    docsMcpInstall?: DocsMcpInstall;
 }
 export declare const CODING_AGENTS: readonly CodingAgent[];
 /** The agent with this id, or undefined when the id is unknown. */
@@ -62,6 +119,10 @@ export declare function pathWithoutPackageBins(pathValue: string): string;
  * setup itself runs under `npx @arizeai/phoenix-cli`.
  */
 export declare function probeGlobalBinary(deps: Pick<SetupDeps, "context" | "processes">, binary: string): Promise<boolean>;
+/** The agents whose binary probe succeeds, in the given order. */
+export declare function detectAgents<TAgent extends {
+    binary: string;
+}>(deps: Pick<SetupDeps, "processes">, agents: readonly TAgent[]): Promise<TAgent[]>;
 /** Agents whose binary probe succeeds, in registry order. */
 export declare function detectCodingAgents(deps: Pick<SetupDeps, "processes">): Promise<CodingAgent[]>;
 /**

package/build/setup/agents/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/setup/agents/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEvE;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,aAAa,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;CAC1D;AAED,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EA6C/C,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAElE;AAED,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAEpD,CAAC;AAIF;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAClC,MAAM,EAAE,MAAM,EACd,EAAE,GAAG,EAAE,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC7C,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,CAAC,EAC9C,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,6DAA6D;AAC7D,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,GACjC,OAAO,CAAC,WAAW,EAAE,CAAC,CAKxB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM5E;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB,GACA,WAAW,CAQb"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/setup/agents/registry.ts"],"names":[],"mappings":"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"}

package/build/setup/agents/registry.js

@@ -8,6 +8,14 @@
  * via environment variables; setup resumes when it exits.
  */
 import * as path from "node:path";
+/** The server name the docs MCP is registered under in agent configs. */
+export const DOCS_MCP_SERVER_NAME = "phoenix-docs";
+/**
+ * The Mintlify-hosted Phoenix docs MCP server (streamable HTTP). Searching it
+ * returns just the relevant doc sections, so an agent connected to it needs
+ * neither the `.px/docs` download nor whole-page fetches.
+ */
+export const DOCS_MCP_SERVER_URL = "https://arizeai-433a7140.mintlify.app/mcp";
 export const CODING_AGENTS = [
     {
         id: "claude",
@@ -18,6 +26,22 @@ export const CODING_AGENTS = [
             ...(mode.bypassPermissions ? ["--dangerously-skip-permissions"] : []),
             prompt,
         ],
+        // The default (local) scope is deliberate: nothing lands in the repo, and
+        // unlike a project-scoped .mcp.json the server needs no first-use
+        // approval, so the launched hand-off session can actually use it.
+        docsMcpInstall: {
+            kind: "cli",
+            removeArgs: ["mcp", "remove", DOCS_MCP_SERVER_NAME],
+            addArgs: (serverUrl) => [
+                "mcp",
+                "add",
+                "--transport",
+                "http",
+                DOCS_MCP_SERVER_NAME,
+                serverUrl,
+            ],
+            verifyArgs: ["mcp", "get", DOCS_MCP_SERVER_NAME],
+        },
     },
     {
         id: "codex",
@@ -42,6 +66,20 @@ export const CODING_AGENTS = [
             ...(mode.bypassPermissions ? ["--dangerously-skip-permissions"] : []),
             prompt,
         ],
+        docsMcpInstall: {
+            kind: "file",
+            relativePath: "opencode.json",
+            createDefaults: { $schema: "https://opencode.ai/config.json" },
+            patch: (serverUrl) => ({
+                mcp: {
+                    [DOCS_MCP_SERVER_NAME]: {
+                        type: "remote",
+                        url: serverUrl,
+                        enabled: true,
+                    },
+                },
+            }),
+        },
     },
     {
         id: "cursor",
@@ -52,6 +90,13 @@ export const CODING_AGENTS = [
             ...(mode.bypassPermissions ? ["--force"] : []),
             prompt,
         ],
+        docsMcpInstall: {
+            kind: "file",
+            relativePath: ".cursor/mcp.json",
+            patch: (serverUrl) => ({
+                mcpServers: { [DOCS_MCP_SERVER_NAME]: { url: serverUrl } },
+            }),
+        },
     },
 ];
 /** The agent with this id, or undefined when the id is unknown. */
@@ -101,10 +146,14 @@ export function probeGlobalBinary(deps, binary) {
         ? {}
         : { env: { [pathKey]: pathWithoutPackageBins(pathValue) } });
 }
+/** The agents whose binary probe succeeds, in the given order. */
+export async function detectAgents(deps, agents) {
+    const probes = await Promise.all(agents.map((agent) => probeBinary(deps, agent.binary)));
+    return agents.filter((_, index) => probes[index]);
+}
 /** Agents whose binary probe succeeds, in registry order. */
-export async function detectCodingAgents(deps) {
-    const probes = await Promise.all(CODING_AGENTS.map((agent) => probeBinary(deps, agent.binary)));
-    return CODING_AGENTS.filter((_, index) => probes[index]);
+export function detectCodingAgents(deps) {
+    return detectAgents(deps, CODING_AGENTS);
 }
 /**
  * Env vars the launched agent's shell inherits so the app under test can

package/build/setup/agents/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/setup/agents/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/setup/agents/registry.ts"],"names":[],"mappings":"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"}

package/build/setup/copy.d.ts

@@ -71,6 +71,19 @@ export declare const CONNECT: {
     readonly headlessNeedsApiKey: string;
     readonly headlessAuthRejected: "The API key was rejected. Check PHOENIX_API_KEY.";
 };
+export declare const CREDENTIALS: {
+    readonly methodMessage: "How do you want to connect to Phoenix?";
+    readonly loginLabel: "Log in with your browser (recommended)";
+    readonly loginHint: "approve once in Phoenix; setup creates an API key for you";
+    readonly pasteLabel: "Paste an existing API key";
+    readonly pasteHint: "create or copy one in Phoenix under Settings";
+    readonly authorizationUrl: (url: string) => string;
+    readonly browserOpenFailed: (detail: string) => string;
+    readonly keyCreated: (name: string) => string;
+    readonly loginCancelled: "Login didn't finish — paste an API key instead.";
+    readonly loginFailed: (detail: string) => string;
+    readonly keyCreateFailed: (detail: string) => string;
+};
 export declare const API_KEY: {
     readonly instructionsTitle: "Phoenix API key";
     readonly instructions: string;
@@ -155,6 +168,25 @@ export declare const TOOLING: {
         readonly failed: "Skills install failed — install later with `npx skills add Arize-ai/phoenix`.";
     };
 };
+export declare const DOCS_MCP: {
+    readonly message: (agentLabel: string) => string;
+    readonly yes: "Yes, connect phoenix-docs (recommended)";
+    readonly yesHint: "fastest setup; pulls only the doc sections the agent needs";
+    readonly no: "No, download the docs instead";
+    readonly noHint: "writes ~100 pages to .px/docs for offline reading";
+    /** The decline pair when `--no-docs` means declining downloads nothing. */
+    readonly noWithoutDownload: "No, skip it";
+    readonly noWithoutDownloadHint: "the docs download is off (--no-docs); the agent reads the docs from the web";
+    readonly configured: (files: string[]) => string;
+    readonly configuredCli: (agentLabel: string) => string;
+    readonly failedFor: (agentLabel: string, reason: string) => string;
+    readonly verifyFailed: "the entry did not show up in the agent's own MCP listing after adding it";
+    readonly fallback: "The MCP server was not connected — downloading the docs instead.";
+    readonly fallbackWithoutDownload: "The MCP server was not connected — the agent will read the docs from the web.";
+    /** Printed when an explicit --docs-mcp met a lane with no agent to configure. */
+    readonly noAgentLane: "The clipboard and manual lanes have no coding agent to connect the phoenix-docs MCP server to — skipping the offer.";
+    readonly unsupported: (agentLabel: string) => string;
+};
 export declare const DOCS_PREFETCH: {
     readonly fetching: "Downloading the Phoenix docs so the agent reads them locally...";
     readonly wrote: (pages: number, outputDir: string) => string;

package/build/setup/copy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/setup/copy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/setup/copy.ts"],"names":[],"mappings":"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"}