npm - @steipete/oracle - Versions diffs - 0.21.0 → 0.21.2 - Mend

@steipete/oracle 0.21.0 → 0.21.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (47) hide show

package/dist/bin/oracle-cli.js +14 -15
package/dist/src/browser/executor.js +9 -4
package/dist/src/browser/profileState.js +2 -0
package/dist/src/browser/provider.js +15 -1
package/dist/src/browser/sessionRunner.js +2 -2
package/dist/src/gemini-web/browserSessionManager.js +15 -2
package/dist/src/gemini-web/executor.js +1 -1
package/dist/src/gemini-web/http.js +11 -2
package/dist/src/remote/client.js +25 -9
package/dist/src/remote/server.js +19 -5
package/package.json +11 -10
package/dist/docs-site/.nojekyll +0 -0
package/dist/docs-site/CNAME +0 -1
package/dist/docs-site/RELEASING.html +0 -403
package/dist/docs-site/advisor.html +0 -317
package/dist/docs-site/agents.html +0 -375
package/dist/docs-site/anthropic.html +0 -368
package/dist/docs-site/bridge.html +0 -421
package/dist/docs-site/browser-mode.html +0 -636
package/dist/docs-site/chromium-forks.html +0 -355
package/dist/docs-site/cli-reference.html +0 -347
package/dist/docs-site/configuration.html +0 -464
package/dist/docs-site/favicon.svg +0 -14
package/dist/docs-site/followup.html +0 -375
package/dist/docs-site/gemini.html +0 -387
package/dist/docs-site/grok.html +0 -325
package/dist/docs-site/index.html +0 -360
package/dist/docs-site/install.html +0 -335
package/dist/docs-site/linux.html +0 -321
package/dist/docs-site/llms.txt +0 -44
package/dist/docs-site/manual-tests.html +0 -621
package/dist/docs-site/mcp.html +0 -412
package/dist/docs-site/multimodel.html +0 -364
package/dist/docs-site/mythical-pro-agents.html +0 -360
package/dist/docs-site/notifier.html +0 -338
package/dist/docs-site/openai-endpoints.html +0 -417
package/dist/docs-site/openrouter.html +0 -344
package/dist/docs-site/quickstart.html +0 -369
package/dist/docs-site/refactor/ux.html +0 -321
package/dist/docs-site/sessions.html +0 -397
package/dist/docs-site/social-card.png +0 -0
package/dist/docs-site/social-card.svg +0 -79
package/dist/docs-site/spec.html +0 -363
package/dist/docs-site/testing.html +0 -323
package/dist/docs-site/tui-debug.html +0 -326
package/dist/docs-site/windows-work.html +0 -348
package/dist/docs-site/windows.html +0 -320

package/dist/docs-site/spec.html DELETED Viewed

@@ -1,363 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Spec — oracle</title>
-  <meta name="description" content="What Oracle is, what it isn&#39;t, and the design constraints behind the CLI.">
-  <link rel="canonical" href="https://askoracle.sh/spec.html">
-  <meta property="og:type" content="website">
-  <meta property="og:site_name" content="oracle">
-  <meta property="og:title" content="Spec — oracle">
-  <meta property="og:description" content="What Oracle is, what it isn&#39;t, and the design constraints behind the CLI.">
-  <meta property="og:url" content="https://askoracle.sh/spec.html">
-  <meta property="og:image" content="https://askoracle.sh/social-card.png">
-  <meta property="og:image:width" content="1200">
-  <meta property="og:image:height" content="630">
-  <meta name="twitter:card" content="summary_large_image">
-  <meta name="twitter:title" content="Spec — oracle">
-  <meta name="twitter:description" content="What Oracle is, what it isn&#39;t, and the design constraints behind the CLI.">
-  <meta name="twitter:image" content="https://askoracle.sh/social-card.png">
-  <link rel="icon" href="favicon.svg" type="image/svg+xml">
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-  <script>(function(){var s;try{s=localStorage.getItem('theme')}catch(e){}var d=window.matchMedia&&matchMedia('(prefers-color-scheme: dark)').matches;document.documentElement.dataset.theme=s||(d?'dark':'light')})();</script>
-  <style>
-:root{
-  --ink:#0e0a1f;
-  --text:#1d1832;
-  --muted:#6b6582;
-  --subtle:#9c95b5;
-  --bg:#fafaff;
-  --paper:#ffffff;
-  --accent:#7c3aed;
-  --accent-soft:rgba(124,58,237,.10);
-  --accent-strong:#5b21b6;
-  --accent-2:#0ea5e9;
-  --accent-glow:#a78bfa;
-  --line:#e7e3f0;
-  --line-soft:#f2eff8;
-  --code-bg:#0c0a1a;
-  --code-fg:#e9e6f5;
-  --code-inline-fg:#1c1734;
-  --pill-border:#dcd5ec;
-  --shadow-card:0 4px 14px rgba(14,10,31,.08);
-  --scrollbar:#cbc4dc;
-}
-:root[data-theme="dark"]{
-  --ink:#f5f2ff;
-  --text:#cec7e4;
-  --muted:#9189a8;
-  --subtle:#6a6383;
-  --bg:#0a0815;
-  --paper:#15102a;
-  --accent:#a78bfa;
-  --accent-soft:rgba(167,139,250,.18);
-  --accent-strong:#c4b5fd;
-  --accent-2:#38bdf8;
-  --accent-glow:#c4b5fd;
-  --line:#272140;
-  --line-soft:#1c1734;
-  --code-bg:#06040d;
-  --code-fg:#e9e6f5;
-  --code-inline-fg:#e9e6f5;
-  --pill-border:#2c2549;
-  --shadow-card:0 4px 18px rgba(0,0,0,.45);
-  --scrollbar:#3a3358;
-}
-:root{color-scheme:light}
-:root[data-theme="dark"]{color-scheme:dark}
-*{box-sizing:border-box}
-html{scroll-behavior:smooth;scroll-padding-top:24px}
-body{margin:0;background:var(--bg);color:var(--text);font-family:"Inter",ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif;line-height:1.65;overflow-x:hidden;-webkit-font-smoothing:antialiased;font-feature-settings:"cv02","cv03","cv04","cv11";transition:background-color .18s,color .18s}
-::selection{background:var(--accent);color:#fff}
-a{color:var(--accent);text-decoration:none;transition:color .12s}
-a:hover{text-decoration:underline;text-underline-offset:.2em}
-.shell{display:grid;grid-template-columns:268px minmax(0,1fr);min-height:100vh}
-.sidebar{position:sticky;top:0;height:100vh;overflow:auto;padding:24px 22px;background:var(--paper);border-right:1px solid var(--line);scrollbar-width:thin;scrollbar-color:var(--line) transparent;transition:background-color .18s,border-color .18s}
-.sidebar::-webkit-scrollbar{width:6px}
-.sidebar::-webkit-scrollbar-thumb{background:var(--line);border-radius:6px}
-.sidebar-head{display:flex;align-items:center;gap:10px;margin-bottom:24px}
-.brand{display:flex;align-items:center;gap:11px;color:var(--ink);text-decoration:none;flex:1;min-width:0}
-.brand:hover{text-decoration:none}
-.brand .mark{flex:0 0 30px;width:30px;height:30px;border-radius:50%;background:radial-gradient(circle at 32% 32%,#fff 0,#e0d4ff 22%,#7c3aed 60%,#1e1240 100%);box-shadow:0 0 0 1px rgba(124,58,237,.35),0 6px 18px rgba(124,58,237,.35);position:relative}
-.brand .mark::after{content:"";position:absolute;left:50%;top:50%;width:9px;height:9px;border-radius:50%;background:#0c0820;transform:translate(-50%,-50%)}
-.brand strong{display:block;font-size:1.05rem;line-height:1.1;font-weight:600;letter-spacing:0;color:var(--ink)}
-.brand small{display:block;color:var(--muted);font-size:.74rem;margin-top:3px;font-weight:400}
-.theme-toggle{display:inline-flex;align-items:center;justify-content:center;flex:0 0 auto;width:34px;height:34px;border-radius:8px;border:1px solid var(--line);background:var(--paper);color:var(--muted);cursor:pointer;padding:0;transition:border-color .15s,color .15s,background-color .15s,transform .12s}
-.theme-toggle:hover{border-color:var(--ink);color:var(--ink)}
-.theme-toggle:active{transform:scale(.94)}
-.theme-toggle svg{width:16px;height:16px;display:block}
-.theme-icon-sun{display:none}
-:root[data-theme="dark"] .theme-icon-sun{display:block}
-:root[data-theme="dark"] .theme-icon-moon{display:none}
-.search{display:block;margin:0 0 22px}
-.search span{display:block;color:var(--muted);font-size:.7rem;font-weight:600;text-transform:uppercase;letter-spacing:0;margin-bottom:7px}
-.search input{width:100%;border:1px solid var(--line);background:var(--paper);border-radius:8px;padding:9px 12px;font:inherit;font-size:.9rem;color:var(--text);outline:none;transition:border-color .15s,box-shadow .15s,background-color .18s}
-.search input:focus{border-color:var(--accent);box-shadow:0 0 0 3px var(--accent-soft)}
-nav section{margin:0 0 18px}
-nav h2{font-size:.68rem;color:var(--muted);text-transform:uppercase;letter-spacing:0;margin:0 0 6px;font-weight:600}
-.nav-link{display:block;color:var(--text);text-decoration:none;border-radius:6px;padding:5px 10px;margin:1px 0;font-size:.9rem;line-height:1.4;transition:background .12s,color .12s}
-.nav-link:hover{background:var(--line-soft);color:var(--ink);text-decoration:none}
-.nav-link.active{background:var(--accent-soft);color:var(--accent);font-weight:600}
-main{min-width:0;padding:32px clamp(20px,4.5vw,56px) 80px;max-width:1180px;margin:0 auto;width:100%}
-.hero{display:flex;align-items:flex-end;justify-content:space-between;gap:22px;border-bottom:1px solid var(--line);padding:8px 0 22px;margin-bottom:8px;flex-wrap:wrap}
-.hero-text{min-width:0;flex:1 1 320px}
-.eyebrow{margin:0 0 8px;color:var(--muted);font-weight:600;text-transform:uppercase;letter-spacing:0;font-size:.7rem}
-.hero h1{font-size:2.25rem;line-height:1.1;letter-spacing:0;margin:0;font-weight:700;color:var(--ink)}
-.hero-meta{display:flex;gap:8px;flex:0 0 auto;flex-wrap:wrap}
-.repo,.edit,.btn-ghost{border:1px solid var(--line);color:var(--text);text-decoration:none;border-radius:7px;padding:6px 11px;font-weight:500;font-size:.83rem;background:var(--paper);transition:border-color .15s,color .15s,background .15s}
-.repo:hover,.edit:hover,.btn-ghost:hover{border-color:var(--ink);color:var(--ink);text-decoration:none}
-.edit{color:var(--muted)}
-.home-hero{position:relative;padding:24px 0 32px;margin-bottom:8px;border-bottom:1px solid var(--line)}
-.home-hero>*{position:relative;z-index:1}
-.home-hero h1{font-size:3.4rem;line-height:1.04;letter-spacing:0;margin:0 0 .35em;font-weight:700;color:var(--ink);background:linear-gradient(135deg,var(--ink) 0,#7c3aed 60%,#0ea5e9 100%);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:transparent}
-:root[data-theme="dark"] .home-hero h1{background:linear-gradient(135deg,#f5f2ff 0,#c4b5fd 50%,#7dd3fc 100%);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:transparent}
-.home-hero .lede{font-size:1.18rem;line-height:1.55;color:var(--text);margin:0 0 1.2em;max-width:62ch}
-.home-cta{display:flex;flex-wrap:wrap;gap:10px;align-items:center;margin:0 0 18px}
-.home-cta .btn{display:inline-flex;align-items:center;gap:7px;border-radius:8px;padding:10px 16px;font-weight:600;font-size:.92rem;text-decoration:none;transition:background .15s,border-color .15s,color .15s,transform .12s}
-.home-cta .btn-primary{background:linear-gradient(135deg,var(--accent),var(--accent-strong));color:#fff;border:1px solid var(--accent);box-shadow:0 4px 14px rgba(124,58,237,.35)}
-.home-cta .btn-primary:hover{background:var(--accent-strong);border-color:var(--accent-strong);text-decoration:none;transform:translateY(-1px)}
-.home-cta .btn-ghost{padding:10px 16px}
-.home-install{display:flex;align-items:center;gap:12px;background:var(--code-bg);color:var(--code-fg);border-radius:8px;padding:10px 10px 10px 16px;font:500 .9rem/1.2 "JetBrains Mono","SF Mono",ui-monospace,monospace;max-width:34em;border:1px solid #1f1840}
-.home-install .prompt{color:#6f63a3;user-select:none;flex:0 0 auto}
-.home-install code{flex:1;background:transparent;border:0;color:var(--code-fg);font:inherit;padding:0;white-space:pre;overflow:hidden;text-overflow:ellipsis}
-.home-install .copy{flex:0 0 auto;background:rgba(255,255,255,.08);color:var(--code-fg);border:1px solid rgba(255,255,255,.16);border-radius:6px;padding:5px 11px;font:500 .72rem/1 "Inter",sans-serif;cursor:pointer;transition:background .15s,border-color .15s}
-.home-install .copy:hover{background:rgba(255,255,255,.16)}
-.home-install .copy.copied{background:var(--accent);border-color:var(--accent)}
-.home-services{display:flex;flex-wrap:wrap;gap:6px;margin:6px 0 18px}
-.home-services span{display:inline-block;padding:3px 10px;border:1px solid var(--pill-border);border-radius:999px;font-size:.78rem;color:var(--muted);background:var(--paper)}
-.home-services span.pill-pro{background:var(--accent-soft);color:var(--accent);border-color:transparent;font-weight:600}
-.home-visual{display:block;width:min(100%,620px);height:auto;margin:22px 0 0;border-radius:8px;border:1px solid var(--line);box-shadow:var(--shadow-card);background:var(--paper)}
-.doc-grid{display:grid;grid-template-columns:minmax(0,1fr);gap:48px;margin-top:24px}
-.doc-grid-home{margin-top:8px}
-@media(min-width:1180px){.doc-grid{grid-template-columns:minmax(0,72ch) 200px;justify-content:start}.doc-grid-home{grid-template-columns:minmax(0,76ch);justify-content:start}}
-.doc{min-width:0;max-width:72ch;overflow-wrap:break-word}
-.doc-home{max-width:76ch}
-.doc h1{font-size:2.6rem;line-height:1.08;letter-spacing:0;margin:0 0 .4em;font-weight:700;color:var(--ink)}
-body:not(.home) .doc>h1:first-child{display:none}
-.doc h2{font-size:1.45rem;line-height:1.2;margin:2em 0 .5em;font-weight:600;letter-spacing:0;color:var(--ink);position:relative}
-.doc h3{font-size:1.1rem;margin:1.7em 0 .35em;position:relative;font-weight:600;color:var(--ink);letter-spacing:0}
-.doc h4{font-size:.98rem;margin:1.4em 0 .25em;color:var(--ink);position:relative;font-weight:600}
-.doc h2:first-child,.doc h3:first-child,.doc h4:first-child{margin-top:.2em}
-.doc :is(h2,h3,h4) .anchor{position:absolute;left:-1.05em;top:0;color:var(--subtle);opacity:0;text-decoration:none;font-weight:400;padding-right:.3em;transition:opacity .12s,color .12s}
-.doc :is(h2,h3,h4):hover .anchor{opacity:.7}
-.doc :is(h2,h3,h4) .anchor:hover{opacity:1;color:var(--accent);text-decoration:none}
-.doc p{margin:0 0 1.05em}
-.doc ul,.doc ol{padding-left:1.3rem;margin:0 0 1.15em}
-.doc li{margin:.25em 0}
-.doc li>p{margin:0 0 .4em}
-.doc strong{font-weight:600;color:var(--ink)}
-.doc em{font-style:italic}
-.doc code{font-family:"JetBrains Mono","SF Mono",ui-monospace,monospace;font-size:.84em;background:var(--line-soft);border:1px solid var(--line);border-radius:5px;padding:.08em .35em;color:var(--code-inline-fg)}
-.doc pre{position:relative;overflow:auto;background:var(--code-bg);color:var(--code-fg);border-radius:8px;padding:14px 18px;margin:1.3em 0;font-size:.85em;line-height:1.6;scrollbar-width:thin;scrollbar-color:#3a3358 transparent;border:1px solid #221c40}
-.doc pre.shiki{background:var(--code-bg)!important;color:var(--code-fg)!important}
-.doc pre::-webkit-scrollbar{height:8px;width:8px}
-.doc pre::-webkit-scrollbar-thumb{background:#3a3358;border-radius:8px}
-.doc pre code{display:block;background:transparent;border:0;color:inherit;padding:0;font-size:1em;white-space:pre}
-.doc pre code .line{display:block;min-height:1.6em}
-.doc pre .copy{position:absolute;top:8px;right:8px;background:rgba(255,255,255,.06);color:var(--code-fg);border:1px solid rgba(255,255,255,.16);border-radius:6px;padding:3px 9px;font:500 .7rem/1 "Inter",sans-serif;cursor:pointer;opacity:0;transition:opacity .15s,background .15s,border-color .15s}
-.doc pre:hover .copy,.doc pre .copy:focus{opacity:1}
-.doc pre .copy:hover{background:rgba(255,255,255,.12)}
-.doc pre .copy.copied{background:var(--accent);border-color:var(--accent);opacity:1}
-.doc blockquote{margin:1.4em 0;padding:10px 16px;border-left:3px solid var(--accent);background:var(--accent-soft);border-radius:0 8px 8px 0;color:var(--text)}
-.doc blockquote p:last-child{margin-bottom:0}
-.doc table{width:100%;border-collapse:collapse;margin:1.2em 0;font-size:.92em}
-.doc th,.doc td{border-bottom:1px solid var(--line);padding:9px 10px;text-align:left;vertical-align:top}
-.doc th{font-weight:600;color:var(--ink);background:var(--line-soft);border-bottom:1px solid var(--line)}
-.doc hr{border:0;border-top:1px solid var(--line);margin:2.2em 0}
-.toc{position:sticky;top:24px;align-self:start;font-size:.84rem;padding-left:14px;border-left:1px solid var(--line);max-height:calc(100vh - 48px);overflow:auto;scrollbar-width:thin;scrollbar-color:var(--line) transparent}
-.toc::-webkit-scrollbar{width:5px}
-.toc::-webkit-scrollbar-thumb{background:var(--line);border-radius:5px}
-.toc h2{font-size:.66rem;color:var(--muted);text-transform:uppercase;letter-spacing:0;margin:0 0 10px;font-weight:600}
-.toc a{display:block;color:var(--muted);text-decoration:none;padding:4px 0 4px 10px;line-height:1.35;border-left:2px solid transparent;margin-left:-12px;transition:color .12s,border-color .12s}
-.toc a:hover{color:var(--ink);text-decoration:none}
-.toc a.active{color:var(--accent);border-left-color:var(--accent);font-weight:500}
-.toc-l3{padding-left:22px!important;font-size:.94em}
-@media(max-width:1179px){.toc{display:none}}
-.page-nav{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin-top:48px;border-top:1px solid var(--line);padding-top:20px}
-.page-nav>a{display:block;border:1px solid var(--line);background:var(--paper);border-radius:9px;padding:13px 16px;text-decoration:none;color:var(--text);transition:border-color .15s,transform .15s,box-shadow .15s,background-color .18s}
-.page-nav>a:hover{border-color:var(--accent);text-decoration:none;color:var(--ink)}
-.page-nav small{display:block;color:var(--muted);font-size:.7rem;text-transform:uppercase;letter-spacing:0;margin-bottom:5px;font-weight:600}
-.page-nav span{display:block;font-weight:600;line-height:1.3;color:var(--ink)}
-.page-nav-prev{text-align:left}
-.page-nav-next{text-align:right;grid-column:2}
-.page-nav-prev:only-child{grid-column:1}
-.nav-toggle{display:none;position:fixed;top:14px;right:14px;top:calc(14px + env(safe-area-inset-top, 0px));right:calc(14px + env(safe-area-inset-right, 0px));z-index:20;width:40px;height:40px;border-radius:9px;background:var(--paper);border:1px solid var(--line);color:var(--ink);cursor:pointer;padding:10px 9px;flex-direction:column;align-items:stretch;justify-content:space-between;box-shadow:var(--shadow-card)}
-.nav-toggle span{display:block;width:100%;height:2px;flex:0 0 2px;background:currentColor;border-radius:2px;transition:transform .2s,opacity .2s}
-.nav-toggle[aria-expanded="true"] span:nth-child(1){transform:translateY(8px) rotate(45deg)}
-.nav-toggle[aria-expanded="true"] span:nth-child(2){opacity:0}
-.nav-toggle[aria-expanded="true"] span:nth-child(3){transform:translateY(-8px) rotate(-45deg)}
-@media(max-width:900px){
-  .shell{display:block}
-  .sidebar{position:fixed;inset:0 30% 0 0;max-width:320px;height:100vh;z-index:15;transform:translateX(-100%);transition:transform .25s ease,background-color .18s,border-color .18s;box-shadow:0 18px 40px rgba(0,0,0,.18);background:var(--paper);pointer-events:none}
-  .sidebar.open{transform:translateX(0);pointer-events:auto}
-  .nav-toggle{display:flex}
-  main{padding:64px 18px 56px}
-  .hero{padding-top:6px}
-  .hero h1{font-size:1.8rem}
-  .home-hero h1{font-size:2.45rem}
-  .doc h1{font-size:2.1rem}
-  .hero-meta{width:100%;justify-content:flex-start}
-  .home-hero{padding-top:8px}
-  .home-visual{margin-top:18px}
-  .doc{padding:0}
-  .doc-grid{margin-top:18px;gap:24px}
-  .doc :is(h2,h3,h4) .anchor{display:none}
-}
-@media(max-width:520px){
-  main{padding:60px 14px 48px}
-  .doc pre{margin-left:-14px;margin-right:-14px;border-radius:0;border-left:0;border-right:0}
-  .home-install{flex-wrap:wrap}
-}
-</style>
-</head>
-<body>
-  <button class="nav-toggle" type="button" aria-label="Toggle navigation" aria-expanded="false">
-    <span aria-hidden="true"></span><span aria-hidden="true"></span><span aria-hidden="true"></span>
-  </button>
-  <div class="shell">
-    <aside class="sidebar">
-      <div class="sidebar-head">
-        <a class="brand" href="./" aria-label="oracle docs home">
-          <span class="mark" aria-hidden="true"></span>
-          <span><strong>oracle</strong><small>askoracle.sh</small></span>
-        </a>
-        <button class="theme-toggle" type="button" aria-label="Toggle dark mode" aria-pressed="false" data-theme-toggle>
-    <svg class="theme-icon-moon" viewBox="0 0 20 20" aria-hidden="true"><path d="M14.6 12.1A6.5 6.5 0 0 1 7.4 2.7a6.5 6.5 0 1 0 7.2 9.4z" fill="currentColor"/></svg>
-    <svg class="theme-icon-sun" viewBox="0 0 20 20" aria-hidden="true"><circle cx="10" cy="10" r="3.4" fill="currentColor"/><g stroke="currentColor" stroke-width="1.6" stroke-linecap="round"><line x1="10" y1="2" x2="10" y2="4"/><line x1="10" y1="16" x2="10" y2="18"/><line x1="2" y1="10" x2="4" y2="10"/><line x1="16" y1="10" x2="18" y2="10"/><line x1="4.2" y1="4.2" x2="5.6" y2="5.6"/><line x1="14.4" y1="14.4" x2="15.8" y2="15.8"/><line x1="4.2" y1="15.8" x2="5.6" y2="14.4"/><line x1="14.4" y1="5.6" x2="15.8" y2="4.2"/></g></svg>
-  </button>
-      </div>
-      <label class="search"><span>Search</span><input id="doc-search" type="search" placeholder="browser, mcp, sessions"></label>
-      <nav><section><h2>Start</h2><a class="nav-link" href="./">Overview</a><a class="nav-link" href="install.html">Install</a><a class="nav-link" href="quickstart.html">Quickstart</a><a class="nav-link" href="configuration.html">Local configuration (JSON5)</a></section><section><h2>Mythical Pro Agents</h2><a class="nav-link" href="mythical-pro-agents.html">Mythical Pro Agents</a><a class="nav-link" href="openai-endpoints.html">OpenAI-Compatible Endpoints</a><a class="nav-link" href="anthropic.html">Anthropic (Claude) Integration Plan</a><a class="nav-link" href="gemini.html">Gemini Integration</a><a class="nav-link" href="openrouter.html">OpenRouter</a><a class="nav-link" href="grok.html">Grok 4.1 (xAI) Support</a></section><section><h2>Browser Mode</h2><a class="nav-link" href="browser-mode.html">Browser Mode</a><a class="nav-link" href="chromium-forks.html">Chromium-based browsers (Chromium, Edge, Brave variants)</a><a class="nav-link" href="linux.html">Linux Notes</a><a class="nav-link" href="windows.html">Windows compatibility notes</a><a class="nav-link" href="windows-work.html">Windows Work</a><a class="nav-link" href="bridge.html">Bridge (Windows-hosted ChatGPT session → Linux clients)</a></section><section><h2>Agents &amp; MCP</h2><a class="nav-link" href="agents.html">Coding Agents</a><a class="nav-link" href="mcp.html">MCP Server</a></section><section><h2>Workflows</h2><a class="nav-link" href="sessions.html">Sessions</a><a class="nav-link" href="followup.html">Followups &amp; Lineage</a><a class="nav-link" href="multimodel.html">Multi-Model Execution</a></section><section><h2>Reference</h2><a class="nav-link" href="cli-reference.html">CLI Reference</a><a class="nav-link active" href="spec.html">Spec</a><a class="nav-link" href="notifier.html">Session completion notifications</a><a class="nav-link" href="tui-debug.html">TUI navigation crash notes (2025-11-19)</a><a class="nav-link" href="manual-tests.html">Manual Test Suite (Browser Mode + Live API)</a><a class="nav-link" href="testing.html">Testing quickstart</a><a class="nav-link" href="RELEASING.html">Release Checklist (npm + Homebrew)</a></section></nav>
-    </aside>
-    <main>
-      <header class="hero">
-        <div class="hero-text">
-          <p class="eyebrow">Reference</p>
-          <h1>Spec</h1>
-        </div>
-        <div class="hero-meta">
-          <a class="repo" href="https://github.com/steipete/oracle" rel="noopener">GitHub</a>
-          <a class="edit" href="https://github.com/steipete/oracle/edit/main/docs/spec.md" rel="noopener">Edit page</a>
-        </div>
-      </header>
-      <div class="doc-grid">
-        <article class="doc"><p>This page captures the design constraints. The README and the rest of the docs describe how Oracle behaves; this page describes <em>why</em>.</p>
-<h2 id="goals"><a class="anchor" href="#goals" aria-label="Anchor link">#</a>Goals</h2>
-<ol>
-<li><strong>One CLI to every Pro model.</strong> Same flags, same session store, same bundling rules whether the answer comes from GPT-5.5 Pro, Gemini 3 Pro, or Claude Opus.</li>
-<li><strong>Runs on every box.</strong> macOS first, Linux and Windows supported. Browser mode optional.</li>
-<li><strong>Stable artifacts.</strong> <code>--render</code> is contracted; session metadata stays machine-readable; stderr is for humans.</li>
-<li><strong>Bundles, not chats.</strong> Oracle assembles a deterministic prompt+files bundle and ships it once. Chat-style interactivity is the agent&#39;s job, not Oracle&#39;s.</li>
-<li><strong>Storage owned by the user.</strong> Sessions are local files under <code>~/.oracle/sessions/</code> (override with <code>ORACLE_HOME_DIR</code>). No cloud account, no telemetry.</li>
-<li><strong>Built for agents.</strong> Coding agents (Claude Code, Codex, Cursor) and any MCP host should be able to call Oracle without friction.</li>
-</ol>
-<h2 id="non-goals"><a class="anchor" href="#non-goals" aria-label="Anchor link">#</a>Non-goals</h2>
-<ul>
-<li><strong>Not a chat client.</strong> Oracle doesn&#39;t try to replace ChatGPT&#39;s UI. Browser mode drives ChatGPT; it doesn&#39;t reimplement it.</li>
-<li><strong>Not a model.</strong> Oracle has no opinions about reasoning quality. It bundles, ships, and stores.</li>
-<li><strong>Not a security boundary.</strong> API keys live in your environment. Cookies live in your browser profile or in a JSON file you control.</li>
-<li><strong>Not a quota manager.</strong> API mode bills go to your provider account directly. Oracle reports usage, doesn&#39;t gate.</li>
-</ul>
-<h2 id="bundling-rules"><a class="anchor" href="#bundling-rules" aria-label="Anchor link">#</a>Bundling rules</h2>
-<p>The bundle Oracle ships is deterministic given the same args and same files. That means:</p>
-<ul>
-<li>Files are read in glob expansion order, then de-duplicated.</li>
-<li><code>.gitignore</code> is honored.</li>
-<li>Default-ignored dirs: <code>node_modules</code>, <code>dist</code>, <code>coverage</code>, <code>.git</code>, <code>.turbo</code>, <code>.next</code>, <code>build</code>, <code>tmp</code>. Pass them explicitly to override.</li>
-<li>Symlinks are not followed.</li>
-<li>Dotfiles are filtered unless the glob has a dot-segment (<code>--file &quot;.github/**&quot;</code>).</li>
-<li>File size cap defaults to 1 MB. Override with <code>ORACLE_MAX_FILE_SIZE_BYTES</code> or <code>maxFileSizeBytes</code> in config.</li>
-</ul>
-<h2 id="engine-selection"><a class="anchor" href="#engine-selection" aria-label="Anchor link">#</a>Engine selection</h2>
-<p>Auto-pick rules:</p>
-<ol>
-<li>If <code>--engine</code> is set, use it.</li>
-<li>Else if <code>engine</code> is set in the effective config, use it. The effective config starts with <code>~/.oracle/config.json</code>, then layers project <code>.oracle/config.json</code> files from parent folders to the current directory.</li>
-<li>Else if <code>OPENAI_API_KEY</code> (or another supported API key) is set, use API.</li>
-<li>Else use browser.</li>
-</ol>
-<p>Browser engine handles ChatGPT (GPT-\* models) and Gemini (Gemini-\*); everything else is API only.</p>
-<h2 id="session-lifecycle-states"><a class="anchor" href="#session-lifecycle-states" aria-label="Anchor link">#</a>Session lifecycle states</h2>
-<table><thead><tr><th>State</th><th>Meaning</th></tr></thead><tbody><tr><td><code>pending</code></td><td>Created, not started yet (rare; usually a transient state).</td></tr><tr><td><code>running</code></td><td>In progress.</td></tr><tr><td><code>completed</code></td><td>Final answer captured.</td></tr><tr><td><code>failed</code></td><td>Error captured; partial output may still be in <code>response.md</code>.</td></tr><tr><td><code>zombie</code></td><td>No activity past <code>--zombie-timeout</code>; process likely gone.</td></tr></tbody></table>
-<h2 id="compatibility-commitments"><a class="anchor" href="#compatibility-commitments" aria-label="Anchor link">#</a>Compatibility commitments</h2>
-<ul>
-<li>Session metadata schema is stable across minor releases. Keys may be added; existing keys won&#39;t change shape without a major bump.</li>
-<li>Session folder layout (<code>meta.json</code> / <code>prompt.md</code> / <code>response.md</code> / <code>log.jsonl</code> / <code>artifacts/</code>) is stable.</li>
-<li>Top-level commands (<code>status</code>, <code>session</code>, <code>restart</code>, <code>serve</code>, <code>bridge</code>, <code>tui</code>) are stable.</li>
-<li>Flag names are stable; deprecated flags get compatibility warnings before removal.</li>
-</ul>
-<h2 id="versioning"><a class="anchor" href="#versioning" aria-label="Anchor link">#</a>Versioning</h2>
-<p><a href="https://semver.org/">Semver</a>. The CLI surface is the public API. The internal Node modules are not — don&#39;t import from <code>dist/</code> directly.</p>
-<h2 id="source-of-truth"><a class="anchor" href="#source-of-truth" aria-label="Anchor link">#</a>Source of truth</h2>
-<ul>
-<li>Recent changes: <a href="https://github.com/steipete/oracle/blob/main/CHANGELOG.md">CHANGELOG.md</a>.</li>
-<li>Open issues / direction: <a href="https://github.com/steipete/oracle/issues">GitHub Issues</a>.</li>
-<li>Release process: <a href="RELEASING.html">Releasing</a>.</li>
-</ul><nav class="page-nav" aria-label="Pager"><a class="page-nav-prev" href="cli-reference.html"><small>Previous</small><span>CLI Reference</span></a><a class="page-nav-next" href="notifier.html"><small>Next</small><span>Session completion notifications</span></a></nav></article>
-        <nav class="toc" aria-label="On this page"><h2>On this page</h2><a class="toc-l2" href="#goals">Goals</a><a class="toc-l2" href="#non-goals">Non-goals</a><a class="toc-l2" href="#bundling-rules">Bundling rules</a><a class="toc-l2" href="#engine-selection">Engine selection</a><a class="toc-l2" href="#session-lifecycle-states">Session lifecycle states</a><a class="toc-l2" href="#compatibility-commitments">Compatibility commitments</a><a class="toc-l2" href="#versioning">Versioning</a><a class="toc-l2" href="#source-of-truth">Source of truth</a></nav>
-      </div>
-    </main>
-  </div>
-  <script>
-const themeRoot=document.documentElement;
-function applyTheme(mode){themeRoot.dataset.theme=mode;document.querySelectorAll('[data-theme-toggle]').forEach(b=>b.setAttribute('aria-pressed',mode==='dark'?'true':'false'))}
-function storedTheme(){try{return localStorage.getItem('theme')}catch(e){return null}}
-function persistTheme(mode){try{localStorage.setItem('theme',mode)}catch(e){}}
-applyTheme(themeRoot.dataset.theme==='dark'?'dark':'light');
-document.querySelectorAll('[data-theme-toggle]').forEach(btn=>{btn.addEventListener('click',()=>{const next=themeRoot.dataset.theme==='dark'?'light':'dark';applyTheme(next);persistTheme(next)})});
-const systemDark=window.matchMedia&&matchMedia('(prefers-color-scheme: dark)');
-function onSystemChange(e){if(storedTheme())return;applyTheme(e.matches?'dark':'light')}
-if(systemDark){if(systemDark.addEventListener)systemDark.addEventListener('change',onSystemChange);else if(systemDark.addListener)systemDark.addListener(onSystemChange)}
-const sidebar=document.querySelector('.sidebar');
-const toggle=document.querySelector('.nav-toggle');
-const mobileNav=window.matchMedia('(max-width: 900px)');
-const sidebarFocusable='a[href],button,input,select,textarea,[tabindex]';
-function setSidebarFocusable(enabled){
-  sidebar?.querySelectorAll(sidebarFocusable).forEach((el)=>{
-    if(enabled){
-      if(el.dataset.sidebarTabindex!==undefined){
-        if(el.dataset.sidebarTabindex)el.setAttribute('tabindex',el.dataset.sidebarTabindex);
-        else el.removeAttribute('tabindex');
-        delete el.dataset.sidebarTabindex;
-      }
-    }else if(el.dataset.sidebarTabindex===undefined){
-      el.dataset.sidebarTabindex=el.getAttribute('tabindex')??'';
-      el.setAttribute('tabindex','-1');
-    }
-  });
-}
-function setSidebarOpen(open){
-  if(!sidebar||!toggle)return;
-  sidebar.classList.toggle('open',open);
-  toggle.setAttribute('aria-expanded',open?'true':'false');
-  if(mobileNav.matches){
-    sidebar.inert=!open;
-    if(open)sidebar.removeAttribute('aria-hidden');
-    else sidebar.setAttribute('aria-hidden','true');
-    setSidebarFocusable(open);
-  }else{
-    sidebar.inert=false;
-    sidebar.removeAttribute('aria-hidden');
-    setSidebarFocusable(true);
-  }
-}
-setSidebarOpen(false);
-toggle?.addEventListener('click',()=>setSidebarOpen(!sidebar?.classList.contains('open')));
-document.addEventListener('click',(e)=>{if(!sidebar?.classList.contains('open'))return;if(sidebar.contains(e.target)||toggle?.contains(e.target))return;setSidebarOpen(false)});
-document.addEventListener('keydown',(e)=>{if(e.key==='Escape')setSidebarOpen(false)});
-const syncSidebarForViewport=()=>setSidebarOpen(sidebar?.classList.contains('open')??false);
-if(mobileNav.addEventListener)mobileNav.addEventListener('change',syncSidebarForViewport);
-else mobileNav.addListener?.(syncSidebarForViewport);
-const input=document.getElementById('doc-search');
-input?.addEventListener('input',()=>{const q=input.value.trim().toLowerCase();document.querySelectorAll('nav section').forEach(sec=>{let any=false;sec.querySelectorAll('.nav-link').forEach(a=>{const m=!q||a.textContent.toLowerCase().includes(q);a.style.display=m?'block':'none';if(m)any=true});sec.style.display=any?'block':'none'})});
-function attachCopy(target,getText){const btn=document.createElement('button');btn.type='button';btn.className='copy';btn.textContent='Copy';btn.addEventListener('click',async()=>{try{await navigator.clipboard.writeText(getText());btn.textContent='Copied';btn.classList.add('copied');setTimeout(()=>{btn.textContent='Copy';btn.classList.remove('copied')},1400)}catch{btn.textContent='Failed';setTimeout(()=>{btn.textContent='Copy'},1400)}});target.appendChild(btn)}
-document.querySelectorAll('.doc pre').forEach(pre=>attachCopy(pre,()=>pre.querySelector('code')?.textContent??''));
-document.querySelectorAll('.home-install').forEach(el=>attachCopy(el,()=>el.querySelector('code')?.textContent??''));
-const tocLinks=document.querySelectorAll('.toc a');
-if(tocLinks.length){const map=new Map();tocLinks.forEach(a=>{const id=a.getAttribute('href').slice(1);const el=document.getElementById(id);if(el)map.set(el,a)});const setActive=l=>{tocLinks.forEach(x=>x.classList.remove('active'));l.classList.add('active')};const obs=new IntersectionObserver(entries=>{const visible=entries.filter(e=>e.isIntersecting).sort((a,b)=>a.boundingClientRect.top-b.boundingClientRect.top);if(visible.length){const link=map.get(visible[0].target);if(link)setActive(link)}},{rootMargin:'-15% 0px -65% 0px',threshold:0});map.forEach((_,el)=>obs.observe(el))}
-</script>
-</body>
-</html>