@oracle-agent/oracle 0.35.54 → 0.35.56
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.
- package/dist/assets/skills/oracle-desk-product/SKILL.md +1 -1
- package/dist/bin/desk-server.mjs +1 -1
- package/dist/cli/commands/chat.mjs +221 -221
- package/dist/cli/commands/data.mjs +1 -1
- package/dist/cli/commands/doctor.mjs +5 -5
- package/dist/cli/commands/eval.mjs +150 -150
- package/dist/cli/commands/farm.mjs +16 -16
- package/dist/cli/commands/model.mjs +223 -223
- package/dist/cli/commands/quickstart.mjs +6 -6
- package/dist/cli/commands/sign.mjs +14 -14
- package/dist/cli/commands/signer.mjs +32 -25
- package/dist/cli/commands/venues.mjs +2 -2
- package/dist/data/desk-data.mjs +22 -22
- package/dist/data/providers/farming.mjs +2 -2
- package/dist/index.mjs +34 -34
- package/dist/local-signer/anvil-attestation-worker.mjs +1 -1
- package/dist/local-signer/index.mjs +5 -5
- package/dist/local-signer/runtime.mjs +21 -22
- package/dist/teams/index.mjs +7 -7
- package/dist/tui/standalone-client.mjs +102 -102
- package/package.json +1 -1
- package/public/oracle-splash/docs/browser-and-web/index.html +2 -2
- package/public/oracle-splash/docs/connectors/index.html +2 -2
- package/public/oracle-splash/docs/getting-started/index.html +2 -2
- package/public/oracle-splash/docs/index.html +3 -3
- package/public/oracle-splash/docs/reference/index.html +2 -2
- package/public/oracle-splash/docs/security/index.html +2 -2
- package/public/oracle-splash/docs/using-oracle/index.html +2 -2
- package/public/oracle-splash/download/index.html +3 -3
- package/public/oracle-splash/downloads/index.html +1 -1
- package/public/oracle-splash/index.html +6 -6
- package/server.json +2 -2
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!doctype html>
|
|
2
2
|
<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Browser and web tools | Oracle</title><meta name="description" content="Choose the narrowest web surface that can finish the job: search and fetch for public sources, isolated Browser Use for rendered interaction, Oracle Sidecar for an explicitly granted Chrome-profile tab, and xurl for the official X API."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
|
|
3
3
|
<body data-doc-page="browser-and-web"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
|
|
4
|
-
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.
|
|
5
|
-
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link is-active" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.
|
|
4
|
+
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.56</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
|
|
5
|
+
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link is-active" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.56. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Integrations</p><h1>Browser and web tools</h1><p class="docs-lede">Choose the narrowest web surface that can finish the job: search and fetch for public sources, isolated Browser Use for rendered interaction, Oracle Sidecar for an explicitly granted Chrome-profile tab, and xurl for the official X API.</p><div class="docs-meta"><span class="meta-chip">Public web</span><span class="meta-chip">Per-tab grants</span><span class="meta-chip">xurl read-first</span></div>
|
|
6
6
|
<section id="modes"><h2>Choose a web mode</h2><div class="docs-table-wrap"><table><thead><tr><th>Mode</th><th>Use it for</th><th>Boundary</th></tr></thead><tbody><tr><td>web_search + web_fetch</td><td>Discover and read public sources</td><td>No browser session</td></tr><tr><td>browser_exec</td><td>Rendered public pages and bounded interaction</td><td>Oracle-owned isolated profile</td></tr><tr><td>Oracle Sidecar</td><td>Context from a logged-in browser profile</td><td>Explicit grant for one tab and origin</td></tr><tr><td>xurl</td><td>X search, timelines, posts, and account actions</td><td>Official CLI, reads first, writes separately gated</td></tr></tbody></table></div></section>
|
|
7
7
|
<section id="search-fetch"><h2>Search and fetch</h2><p><code>web_search</code> discovers candidate sources. <code>web_fetch</code> reads one exact public URL and returns bounded text. Both refuse private, loopback, metadata, and credential-bearing destinations.</p><p>Search queries use Exa's keyless, rate-limited public service by default. A custom <code>ORACLE_SEARCH_URL</code> JSON backend takes precedence; <code>ORACLE_SEARCH_KEY</code> is sent only to that custom backend. Set <code>ORACLE_SEARCH_PROVIDER=disabled</code> to disable search, or <code>ORACLE_SEARCH_PROVIDER=custom</code> to require your own URL. Failures remain explicit. No Python, system service, local broker or extra MCP configuration is required.</p>
|
|
8
8
|
<div class="callout safe"><span class="callout-title">Research order</span><p>Search, open the primary source, corroborate material claims, and cite the URL. Treat snippets as leads rather than evidence.</p></div></section>
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!doctype html>
|
|
2
2
|
<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>MCP connectors | Oracle</title><meta name="description" content="Use Oracle from the agent client you already run. Generated connector configs expose the read and prepare plane, not a wallet key or control bypass."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
|
|
3
3
|
<body data-doc-page="connectors"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
|
|
4
|
-
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.
|
|
5
|
-
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link is-active" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.
|
|
4
|
+
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.56</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
|
|
5
|
+
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link is-active" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.56. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Integrations</p><h1>MCP connectors</h1><p class="docs-lede">Use Oracle from the agent client you already run. Generated connector configs expose the read and prepare plane, not a wallet key or control bypass.</p><div class="docs-meta"><span class="meta-chip">MCP stdio</span><span class="meta-chip">Registry listed</span><span class="meta-chip">Prepare only</span></div>
|
|
6
6
|
<section id="install"><h2>Install a connector</h2><p>Oracle can print or install MCP configuration for supported clients. Inspect the generated configuration before accepting it.</p>
|
|
7
7
|
<div class="code-block"><div class="code-label">terminal</div><pre><code>oracle mcp print --target claude-code
|
|
8
8
|
oracle mcp install claude-code
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!doctype html>
|
|
2
2
|
<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Getting started | Oracle</title><meta name="description" content="From a clean machine to a verified Oracle chat in a few minutes. The default path needs a model login, not a wallet key."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
|
|
3
3
|
<body data-doc-page="getting-started"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
|
|
4
|
-
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.
|
|
5
|
-
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link is-active" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.
|
|
4
|
+
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.56</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
|
|
5
|
+
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link is-active" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.56. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Start here</p><h1>Getting started</h1><p class="docs-lede">From a clean machine to a verified Oracle chat in a few minutes. The default path needs a model login, not a wallet key.</p><div class="docs-meta"><span class="meta-chip">Linux</span><span class="meta-chip">macOS</span><span class="meta-chip">Windows beta</span></div>
|
|
6
6
|
<section id="requirements"><h2>Requirements</h2><ul><li><strong>Node.js 20.19.0 or newer</strong></li><li>npm</li><li>A supported model OAuth login or API key</li><li>A user-controlled wallet only when you want to sign a prepared action</li></ul></section>
|
|
7
7
|
<section id="install"><h2>Install Oracle</h2><div class="code-block"><div class="code-label">recommended</div><pre><code>curl -fsSL https://oracle.demi.la/install.sh | bash
|
|
8
8
|
oracle --version</code></pre></div>
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
<!doctype html>
|
|
2
2
|
<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Oracle documentation | Oracle</title><meta name="description" content="Install, configure, and operate Oracle as a self-custody multichain agent control plane. Start with reads and quotes, prepare exact artifacts, and keep authorization separate from model output."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="./docs.css"></head>
|
|
3
3
|
<body data-doc-page="overview"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
|
|
4
|
-
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.
|
|
5
|
-
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link is-active" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.
|
|
4
|
+
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.56</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
|
|
5
|
+
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link is-active" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.56. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Documentation</p><h1>Oracle documentation</h1><p class="docs-lede">Install, configure, and operate Oracle as a self-custody multichain agent control plane. Start with reads and quotes, prepare exact artifacts, and keep authorization separate from model output.</p><div class="docs-meta"><span class="meta-chip">Oracle 0.35.56</span><span class="meta-chip">Node 20.19+</span><span class="meta-chip">Public self-host</span></div>
|
|
6
6
|
<section id="install"><h2>Install</h2><p>Oracle runs on Linux, macOS, and Windows. The installer uses a user-local directory and does not require a global npm install.</p>
|
|
7
7
|
<div class="code-block"><div class="code-label">terminal</div><pre><code>curl -fsSL https://oracle.demi.la/install.sh | bash
|
|
8
8
|
oracle --version
|
|
9
9
|
oracle setup model
|
|
10
10
|
oracle</code></pre></div>
|
|
11
|
-
<p>Oracle 0.35.
|
|
11
|
+
<p>Oracle 0.35.56 requires <strong>Node.js 20.19.0 or newer</strong>. If you prefer npm, install <code>@oracle-agent/oracle</code> globally.</p>
|
|
12
12
|
<div class="code-block"><div class="code-label">npm</div><pre><code>npm i -g @oracle-agent/oracle
|
|
13
13
|
oracle --version</code></pre></div>
|
|
14
14
|
<div class="callout safe"><span class="callout-title">Start keyless</span><p>Reads, research, quotes, simulations, and unsigned preparation do not require a wallet key. Never paste a seed phrase, private key, passphrase, or API credential into chat.</p></div></section>
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!doctype html>
|
|
2
2
|
<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>CLI and API reference | Oracle</title><meta name="description" content="The common public commands, executables, import paths, environment settings, and capability tiers in Oracle's published package."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
|
|
3
3
|
<body data-doc-page="reference"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
|
|
4
|
-
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.
|
|
5
|
-
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link is-active" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.
|
|
4
|
+
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.56</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
|
|
5
|
+
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link is-active" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.56. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Reference</p><h1>CLI and API reference</h1><p class="docs-lede">The common public commands, executables, import paths, environment settings, and capability tiers in Oracle's published package.</p><div class="docs-meta"><span class="meta-chip">Package 0.35.56</span><span class="meta-chip">21 executables</span><span class="meta-chip">56 exports</span></div>
|
|
6
6
|
<section id="cli"><h2>CLI commands</h2><div class="docs-table-wrap"><table><thead><tr><th>Command</th><th>Purpose</th></tr></thead><tbody><tr><td>oracle</td><td>Open native Oracle chat</td></tr><tr><td>oracle setup model</td><td>Configure model OAuth or API-key access</td></tr><tr><td>oracle chain list</td><td>List chain selections</td></tr><tr><td>oracle chain use <name></td><td>Select the active chain</td></tr><tr><td>oracle doctor</td><td>Verify installation and local posture</td></tr><tr><td>oracle auth status</td><td>Show provider status without credentials</td></tr><tr><td>oracle mcp install <target></td><td>Install a read and prepare connector</td></tr><tr><td>oracle data serve</td><td>Run the loopback data plane</td></tr><tr><td>oracle public serve --port 8799</td><td>Run the loopback public plane</td></tr><tr><td>oracle eval all --mode playwright</td><td>Run the deterministic evaluation aggregate</td></tr></tbody></table></div></section>
|
|
7
7
|
<section id="executables"><h2>Installed executables</h2><div class="docs-table-wrap"><table><thead><tr><th>Executable</th><th>Purpose</th></tr></thead><tbody><tr><td>oracle</td><td>Main CLI and native chat</td></tr><tr><td>oracle-investigate</td><td>Bounded report-only wallet evidence</td></tr><tr><td>oracle-data</td><td>Local read-plane server</td></tr><tr><td>oracle-public</td><td>Loopback public-plane server</td></tr><tr><td>oracle-data-mcp</td><td>MCP stdio read plane</td></tr><tr><td>oracle-scan</td><td>Token, pool, risk, and exit scanner</td></tr><tr><td>oracle-route</td><td>Swap and bridge route comparison and preparation</td></tr><tr><td>oracle-equities</td><td>Cross-venue on-chain equities desk</td></tr><tr><td>oracle-gateway</td><td>Authenticated messaging transport</td></tr><tr><td>oracle-init</td><td>Dry-run or apply profile and attestation setup</td></tr></tbody></table></div><p>The package currently declares 21 executable bins. Specialized MEV and restoration tools are intentionally not presented as general user commands here. See the package manifest for the complete list.</p></section>
|
|
8
8
|
<section id="library"><h2>Library imports</h2><div class="code-block"><div class="code-label">javascript</div><pre><code>import { data } from "@oracle-agent/oracle";
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!doctype html>
|
|
2
2
|
<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Security and execution | Oracle</title><meta name="description" content="Assume the model can be wrong or adversarially steered. Oracle keeps proposal separate from authorization and verifies the boundaries in code."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
|
|
3
3
|
<body data-doc-page="security"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
|
|
4
|
-
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.
|
|
5
|
-
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link is-active" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.
|
|
4
|
+
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.56</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
|
|
5
|
+
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link is-active" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.56. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">Core concepts</p><h1>Security and execution</h1><p class="docs-lede">Assume the model can be wrong or adversarially steered. Oracle keeps proposal separate from authorization and verifies the boundaries in code.</p><div class="docs-meta"><span class="meta-chip">Disarmed by default</span><span class="meta-chip">Fail closed</span><span class="meta-chip">Exact grants</span></div>
|
|
6
6
|
<section id="planes"><h2>Three planes</h2><div class="plane-grid"><div class="plane"><b>Data</b><span>Chain state, prices, protocol health, reads, and quotes. No key custody.</span></div><div class="plane"><b>Policy</b><span>Destination allowlists, slippage, caps, attestations, and approval binding.</span></div><div class="plane exec"><b>Execution</b><span>User wallet or optional self-hosted local signer. Never model authority.</span></div></div><p>The public import boundary is checked by tests. Hosted and keyless Oracle prepares unsigned artifacts. Self-hosting does not automatically enable signing.</p></section>
|
|
7
7
|
<section id="grants"><h2>Grants and confirmation</h2><p>A grant is authorization. A prompt is not. Live grants bind chain, surface, action, destination, value, expiry, and other action-specific limits. Empty allowlists refuse rather than widening access.</p><ul><li>One exact action cannot be silently reused for another destination or calldata</li><li>Policy is rechecked near sign and broadcast time</li><li>Slippage input is a maximum, not permission to widen automatically</li><li>Disarm and revoke remain dominant</li></ul></section>
|
|
8
8
|
<section id="local-signer"><h2>Optional self-hosted local signer</h2><p>The optional self-hosted local signer uses an encrypted vault, sealed policy, loopback-only service, and one-use confirmation. It stays inert until the owner initializes it.</p>
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!doctype html>
|
|
2
2
|
<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Using Oracle | Oracle</title><meta name="description" content="Oracle separates research, proposal, authorization, broadcast, and proof. That separation is the product, not extra ceremony."><meta name="theme-color" content="#0b1018"><meta name="robots" content="index,follow"><link rel="icon" href="../../favicon.svg" type="image/svg+xml"><link rel="stylesheet" href="../docs.css"></head>
|
|
3
3
|
<body data-doc-page="using-oracle"><a class="skip-link" href="#main-content">Skip to content</a><div class="grain" aria-hidden="true"></div>
|
|
4
|
-
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.
|
|
5
|
-
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link is-active" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.
|
|
4
|
+
<header class="docs-topbar"><a class="docs-brand" href="/"><span class="brand-orbit" aria-hidden="true"></span><span class="docs-word">oracle</span><span class="docs-version">0.35.56</span></a><button class="docs-search-button" id="docs-search-button" type="button" aria-haspopup="dialog"><span class="search-icon" aria-hidden="true">⌕</span><span>Search documentation</span><kbd aria-hidden="true">⌘ K</kbd></button><div class="docs-top-actions"><a class="top-link product-link" href="/">Product</a><a class="top-link download-link" href="/download/">Download</a><button class="mobile-menu" id="docs-menu-button" type="button" aria-label="Open documentation menu" aria-expanded="false" aria-controls="docs-sidebar">☰</button></div></header>
|
|
5
|
+
<div class="docs-shell"><aside class="docs-sidebar" id="docs-sidebar"><div class="side-group"><p class="side-title">Start here</p><a class="side-link" href="/docs/">Overview</a><a class="side-link" href="/docs/getting-started/">Getting started</a></div><div class="side-group"><p class="side-title">User guide</p><a class="side-link is-active" href="/docs/using-oracle/">Using Oracle</a></div><div class="side-group"><p class="side-title">Integrations</p><a class="side-link" href="/docs/connectors/">MCP connectors</a><a class="side-link" href="/docs/browser-and-web/">Browser and web tools</a></div><div class="side-group"><p class="side-title">Core concepts</p><a class="side-link" href="/docs/security/">Security and execution</a></div><div class="side-group"><p class="side-title">Reference</p><a class="side-link" href="/docs/reference/">CLI and API reference</a></div><div class="side-source"><b>Source of truth</b>These pages are generated from Oracle 0.35.56. <a href="https://github.com/demi-hl/oracle/tree/main/packages/oracle" target="_blank" rel="noopener noreferrer">View the repository</a>.</div></aside><main class="docs-main" id="main-content" tabindex="-1"><article class="docs-article"><p class="docs-kicker">User guide</p><h1>Using Oracle</h1><p class="docs-lede">Oracle separates research, proposal, authorization, broadcast, and proof. That separation is the product, not extra ceremony.</p><div class="docs-meta"><span class="meta-chip">Native chat</span><span class="meta-chip">Prepare first</span><span class="meta-chip">Receipt verified</span></div>
|
|
6
6
|
<section id="chat"><h2>Native chat</h2><p>The bare <code>oracle</code> command starts Oracle's own agent loop. The selected model can change without changing the Oracle persona, sessions, or active chain.</p>
|
|
7
7
|
<div class="code-block"><div class="code-label">chat commands</div><pre><code>/sessions list sessions
|
|
8
8
|
/new research ARB create a session
|
|
@@ -1838,9 +1838,9 @@ footer{margin-top:clamp(120px,16vw,220px);border-top:1px solid var(--mk-rule);pa
|
|
|
1838
1838
|
<figcaption>Native desktop. Connect a provider, then chat.</figcaption>
|
|
1839
1839
|
</figure>
|
|
1840
1840
|
<div class="os-dl">
|
|
1841
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.
|
|
1842
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.
|
|
1843
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-Setup-0.4.
|
|
1841
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.29.AppImage">Linux AppImage</a>
|
|
1842
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.29-arm64.dmg">macOS DMG</a>
|
|
1843
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-Setup-0.4.29.exe">Windows Setup</a>
|
|
1844
1844
|
</div>
|
|
1845
1845
|
</section>
|
|
1846
1846
|
</main>
|
|
@@ -27,7 +27,7 @@ section{padding-top:72px;scroll-margin-top:90px}.sub{color:var(--muted);line-hei
|
|
|
27
27
|
<aside class="policy"><h2>Locals Only means 0% Oracle fees</h2><p>A Locals Only NFT waives the <b>Oracle integrator fee</b>. It does not unlock the product, waive provider or network costs, or change the hosted/keyless custody boundary. Self-host execution uses the local signer.</p></aside>
|
|
28
28
|
<section id="cli"><p class="eyebrow">Oracle CLI</p><h2>Install with curl</h2><p class="sub">One line. Linux and macOS. Requires Node 20.19+ (the script checks and tells you how to get it). Installs into <code>~/.local</code> — no sudo, no global npm.</p><div class="install"><div class="cmd"><code id="cmd">curl -fL https://oracle.demi.la/install.sh | bash</code><button class="copy" id="copy" type="button">Copy</button></div><div class="meta"><span>curl install</span><span>hosted keyless</span><span>hosted wallet signs</span><span>user prefix</span></div></div><p class="sub" style="margin-top:18px">npm still works if you prefer: <code>npm i -g @oracle-agent/oracle</code></p></section>
|
|
29
29
|
<section id="windows"><p class="eyebrow">Oracle CLI · Windows</p><h2>Install with PowerShell</h2><p class="sub">Same shape as Hermes: one line. Installs the CLI (<code>npm i -g @oracle-agent/oracle</code>). Never asks for a key or seed.</p><div class="install"><div class="cmd"><code id="cmd-win">iex (irm https://oracle.demi.la/install.ps1)</code><button class="copy" id="copy-win" type="button">Copy</button></div><div class="meta"><span>irm | iex</span><span>CLI only</span><span>no keys ever</span></div></div></section>
|
|
30
|
-
<section id="desktop"><p class="eyebrow">Desktop</p><h2>Linux, macOS, Windows</h2><p class="sub">Packaged <b>0.4.
|
|
30
|
+
<section id="desktop"><p class="eyebrow">Desktop</p><h2>Linux, macOS, Windows</h2><p class="sub">Packaged <b>0.4.29</b>. Settings can Check for updates against this feed.</p><p class="sub">The Windows installer is unsigned and may trigger a SmartScreen warning.</p><div class="artifacts"><div class="artifact"><div><h3>Linux</h3><small>AppImage · x64</small></div><div class="build">Oracle-0.4.29.AppImage</div><div class="hash">sha256 2d0649f37a7d7c4b42f4f6900e4b0c92f54dca868d2d8ff776587ddfd409db22</div><a class="dl-btn" href="/downloads/artifacts/Oracle-0.4.29.AppImage">Download</a></div><div class="artifact"><div><h3>macOS</h3><small>DMG · arm64</small></div><div class="build">Oracle-0.4.29-arm64.dmg</div><div class="hash">sha256 de0946f50143ffd1a6b844b61c9ac329949f46975d8c6186d031aa3d3c92ea2e</div><a class="dl-btn" href="/downloads/artifacts/Oracle-0.4.29-arm64.dmg">Download</a></div><div class="artifact"><div><h3>Windows</h3><small>NSIS Setup · x64</small></div><div class="build">Oracle-Setup-0.4.29.exe</div><div class="hash">sha256 5561d5379e415a044b5f159b6f4d2d7c84dfbc0dee3d8d103b8b242ee563b49b</div><a class="dl-btn" href="/downloads/artifacts/Oracle-Setup-0.4.29.exe">Download</a></div></div><p class="platform-note"><a class="checksum" href="/downloads/SHA256SUMS.txt">SHA256SUMS.txt</a></p></section>
|
|
31
31
|
</main>
|
|
32
32
|
<footer><div class="nav-inner"><span>oracle · locals only labs</span><span>public / self-custody / local signer</span></div></footer>
|
|
33
33
|
<script>
|
|
@@ -1870,9 +1870,9 @@ footer{margin-top:clamp(120px,16vw,220px);border-top:1px solid var(--mk-rule);pa
|
|
|
1870
1870
|
<div class="hero-install-meta"><span>Windows · CLI</span></div>
|
|
1871
1871
|
</div>
|
|
1872
1872
|
<div class="os-dl">
|
|
1873
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.
|
|
1874
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.
|
|
1875
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-Setup-0.4.
|
|
1873
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.29.AppImage">Linux AppImage</a>
|
|
1874
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.29-arm64.dmg">macOS DMG</a>
|
|
1875
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-Setup-0.4.29.exe">Windows Setup</a>
|
|
1876
1876
|
</div>
|
|
1877
1877
|
</div>
|
|
1878
1878
|
|
|
@@ -2006,9 +2006,9 @@ footer{margin-top:clamp(120px,16vw,220px);border-top:1px solid var(--mk-rule);pa
|
|
|
2006
2006
|
<div class="mk-desk-copy">
|
|
2007
2007
|
<p>The same Oracle as a native app for macOS, Windows and Linux. Connect the model you already pay for, pick a chain, and chat. Your wallet signs by default.</p>
|
|
2008
2008
|
<div class="os-dl">
|
|
2009
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.
|
|
2010
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.
|
|
2011
|
-
<a class="os-link" href="/downloads/artifacts/Oracle-Setup-0.4.
|
|
2009
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.29.AppImage">Linux AppImage</a>
|
|
2010
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-0.4.29-arm64.dmg">macOS DMG</a>
|
|
2011
|
+
<a class="os-link" href="/downloads/artifacts/Oracle-Setup-0.4.29.exe">Windows Setup</a>
|
|
2012
2012
|
</div>
|
|
2013
2013
|
</div>
|
|
2014
2014
|
</div>
|
package/server.json
CHANGED
|
@@ -3,12 +3,12 @@
|
|
|
3
3
|
"name": "io.github.demi-hl/oracle",
|
|
4
4
|
"description": "Keyless multichain crypto desk: chain reads + prepare-only unsigned txs. Your wallet signs.",
|
|
5
5
|
"websiteUrl": "https://oracle.demi.la",
|
|
6
|
-
"version": "0.35.
|
|
6
|
+
"version": "0.35.56",
|
|
7
7
|
"packages": [
|
|
8
8
|
{
|
|
9
9
|
"registryType": "npm",
|
|
10
10
|
"identifier": "@oracle-agent/oracle",
|
|
11
|
-
"version": "0.35.
|
|
11
|
+
"version": "0.35.56",
|
|
12
12
|
"transport": {
|
|
13
13
|
"type": "stdio"
|
|
14
14
|
},
|