@steipete/oracle 0.9.0 → 0.11.0

package/dist/src/oracle/tokenEstimate.js

@@ -1,4 +1,4 @@
-import { TOKENIZER_OPTIONS } from './config.js';
+import { TOKENIZER_OPTIONS } from "./config.js";
 /**
  * Estimate input tokens from the full request body instead of just system/user text.
  * This is a conservative approximation: we tokenize the key textual fields and add a fixed buffer
@@ -12,7 +12,7 @@ export function estimateRequestTokens(requestBody, modelConfig, bufferTokens = 2
     }
     for (const turn of requestBody.input ?? []) {
         for (const content of turn.content ?? []) {
-            if (typeof content.text === 'string') {
+            if (typeof content.text === "string") {
                 parts.push(content.text);
             }
         }
@@ -24,14 +24,14 @@ export function estimateRequestTokens(requestBody, modelConfig, bufferTokens = 2
         parts.push(JSON.stringify(requestBody.reasoning));
     }
     if (requestBody.background) {
-        parts.push('background:true');
+        parts.push("background:true");
     }
     if (requestBody.store) {
-        parts.push('store:true');
+        parts.push("store:true");
     }
-    const concatenated = parts.join('\n');
+    const concatenated = parts.join("\n");
     const baseEstimate = modelConfig.tokenizer(concatenated, TOKENIZER_OPTIONS);
-    const hasWebSearch = requestBody.tools?.some((tool) => tool?.type === 'web_search_preview');
+    const hasWebSearch = requestBody.tools?.some((tool) => tool?.type === "web_search_preview");
     const searchBuffer = hasWebSearch ? SEARCH_RESULT_BUFFER_TOKENS : 0;
     return baseEstimate + bufferTokens + searchBuffer;
 }

package/dist/src/oracle/tokenStats.js

@@ -1,5 +1,5 @@
-import chalk from 'chalk';
-import { createFileSections } from './files.js';
+import chalk from "chalk";
+import { createFileSections } from "./files.js";
 export function getFileTokenStats(files, { cwd = process.cwd(), tokenizer, tokenizerOptions, inputTokenBudget, }) {
     if (!files.length) {
         return { stats: [], totalTokens: 0 };
@@ -20,13 +20,13 @@ export function getFileTokenStats(files, { cwd = process.cwd(), tokenizer, token
     const totalTokens = stats.reduce((sum, entry) => sum + entry.tokens, 0);
     return { stats, totalTokens };
 }
-export function printFileTokenStats({ stats, totalTokens }, { inputTokenBudget, log = console.log }) {
+export function printFileTokenStats({ stats, totalTokens }, { inputTokenBudget, log = console.log, }) {
     if (!stats.length) {
         return;
     }
-    log(chalk.bold('File Token Usage'));
+    log(chalk.bold("File Token Usage"));
     for (const entry of stats) {
-        const percentLabel = inputTokenBudget && entry.percent != null ? `${entry.percent.toFixed(2)}%` : 'n/a';
+        const percentLabel = inputTokenBudget && entry.percent != null ? `${entry.percent.toFixed(2)}%` : "n/a";
         log(`${entry.tokens.toLocaleString().padStart(10)}  ${percentLabel.padStart(8)}  ${entry.displayPath}`);
     }
     if (inputTokenBudget) {

package/dist/src/oracle/tokenStringifier.js

@@ -1,14 +1,14 @@
 // Minimal helper to stringify arbitrary input for tokenizer consumption.
 // Anthropic's tokenizer expects a string; we accept unknown and coerce safely.
 export function stringifyTokenizerInput(input) {
-    if (typeof input === 'string')
+    if (typeof input === "string")
         return input;
     if (input === null || input === undefined)
-        return '';
-    if (typeof input === 'number' || typeof input === 'boolean' || typeof input === 'bigint') {
+        return "";
+    if (typeof input === "number" || typeof input === "boolean" || typeof input === "bigint") {
         return String(input);
     }
-    if (typeof input === 'object') {
+    if (typeof input === "object") {
         try {
             return JSON.stringify(input);
         }
@@ -16,7 +16,7 @@ export function stringifyTokenizerInput(input) {
             // fall through to generic stringification
         }
     }
-    if (typeof input === 'function') {
+    if (typeof input === "function") {
         return input.toString();
     }
     return String(input);

package/dist/src/oracle.js

@@ -1,12 +1,12 @@
-export * from './oracle/types.js';
-export { MODEL_CONFIGS, DEFAULT_MODEL, PRO_MODELS, DEFAULT_SYSTEM_PROMPT, TOKENIZER_OPTIONS, } from './oracle/config.js';
-export { readFiles, createFileSections } from './oracle/files.js';
-export { buildPrompt, buildRequestBody, renderPromptMarkdown } from './oracle/request.js';
-export { estimateRequestTokens } from './oracle/tokenEstimate.js';
-export { formatUSD, formatNumber, formatElapsed } from './oracle/format.js';
-export { formatFileSection } from './oracle/markdown.js';
-export { getFileTokenStats, printFileTokenStats } from './oracle/tokenStats.js';
-export { OracleResponseError, OracleTransportError, OracleUserError, FileValidationError, BrowserAutomationError, PromptValidationError, describeTransportError, extractResponseMetadata, asOracleUserError, toTransportError, } from './oracle/errors.js';
-export { createDefaultClientFactory } from './oracle/client.js';
-export { runOracle, extractTextOutput } from './oracle/run.js';
-export { resolveGeminiModelId } from './oracle/gemini.js';
+export * from "./oracle/types.js";
+export { MODEL_CONFIGS, DEFAULT_MODEL, PRO_MODELS, DEFAULT_SYSTEM_PROMPT, TOKENIZER_OPTIONS, } from "./oracle/config.js";
+export { readFiles, createFileSections } from "./oracle/files.js";
+export { buildPrompt, buildRequestBody, renderPromptMarkdown } from "./oracle/request.js";
+export { estimateRequestTokens } from "./oracle/tokenEstimate.js";
+export { formatUSD, formatNumber, formatElapsed } from "./oracle/format.js";
+export { formatFileSection } from "./oracle/markdown.js";
+export { getFileTokenStats, printFileTokenStats } from "./oracle/tokenStats.js";
+export { OracleResponseError, OracleTransportError, OracleUserError, FileValidationError, BrowserAutomationError, PromptValidationError, describeTransportError, extractResponseMetadata, asOracleUserError, toTransportError, } from "./oracle/errors.js";
+export { createDefaultClientFactory } from "./oracle/client.js";
+export { runOracle, extractTextOutput } from "./oracle/run.js";
+export { resolveGeminiModelId } from "./oracle/gemini.js";

package/dist/src/oracleHome.js

@@ -1,5 +1,5 @@
-import os from 'node:os';
-import path from 'node:path';
+import os from "node:os";
+import path from "node:path";
 let oracleHomeDirOverride = null;
 /**
  * Test-only hook: avoid mutating process.env (shared across Vitest worker threads).
@@ -9,5 +9,5 @@ export function setOracleHomeDirOverrideForTest(dir) {
     oracleHomeDirOverride = dir;
 }
 export function getOracleHomeDir() {
-    return oracleHomeDirOverride ?? process.env.ORACLE_HOME_DIR ?? path.join(os.homedir(), '.oracle');
+    return oracleHomeDirOverride ?? process.env.ORACLE_HOME_DIR ?? path.join(os.homedir(), ".oracle");
 }

package/dist/src/projectSources/plan.js

@@ -0,0 +1,27 @@
+import path from "node:path";
+export const PROJECT_SOURCES_MAX_UPLOAD_BATCH = 10;
+export function buildProjectSourcesUploadPlan(files) {
+    return files.map((file, index) => ({
+        path: file.path,
+        displayPath: file.displayPath,
+        name: path.basename(file.path),
+        sizeBytes: file.sizeBytes,
+        batch: Math.floor(index / PROJECT_SOURCES_MAX_UPLOAD_BATCH) + 1,
+    }));
+}
+export function diffAddedProjectSources(before, after) {
+    const remainingBefore = new Map();
+    for (const source of before) {
+        remainingBefore.set(source.name, (remainingBefore.get(source.name) ?? 0) + 1);
+    }
+    const added = [];
+    for (const source of after) {
+        const count = remainingBefore.get(source.name) ?? 0;
+        if (count > 0) {
+            remainingBefore.set(source.name, count - 1);
+            continue;
+        }
+        added.push(source);
+    }
+    return added;
+}

package/dist/src/projectSources/url.js

@@ -0,0 +1,23 @@
+export function normalizeProjectSourcesUrl(rawUrl) {
+    let url;
+    try {
+        url = new URL(rawUrl);
+    }
+    catch (error) {
+        throw new Error(`Invalid ChatGPT project URL: ${rawUrl} (${error instanceof Error ? error.message : String(error)})`);
+    }
+    const hostname = url.hostname.toLowerCase();
+    if (hostname !== "chatgpt.com" && hostname !== "chat.openai.com") {
+        throw new Error(`Project Sources require a ChatGPT URL, received: ${rawUrl}`);
+    }
+    if (!/\/project\/?$/u.test(url.pathname)) {
+        throw new Error(`Project Sources require a ChatGPT project URL ending in /project, received: ${rawUrl}`);
+    }
+    const existingParams = Array.from(url.searchParams.entries()).filter(([key]) => key !== "tab");
+    url.search = "";
+    url.searchParams.set("tab", "sources");
+    for (const [key, value] of existingParams) {
+        url.searchParams.append(key, value);
+    }
+    return url.toString();
+}

package/dist/src/remote/client.js

@@ -1,7 +1,7 @@
-import http from 'node:http';
-import path from 'node:path';
-import { readFile } from 'node:fs/promises';
-import { parseHostPort } from '../bridge/connection.js';
+import http from "node:http";
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { parseHostPort } from "../bridge/connection.js";
 export function createRemoteBrowserExecutor({ host, token }) {
     // Return a drop-in replacement for runBrowserMode so the browser session runner can stay unchanged.
     return async function remoteBrowserExecutor(options) {
@@ -20,11 +20,11 @@ export function createRemoteBrowserExecutor({ host, token }) {
             const req = http.request({
                 hostname,
                 port,
-                path: '/runs',
-                method: 'POST',
+                path: "/runs",
+                method: "POST",
                 headers: {
-                    'Content-Type': 'application/json',
-                    'Content-Length': body.length,
+                    "Content-Type": "application/json",
+                    "Content-Length": body.length,
                     ...(token ? { authorization: `Bearer ${token}` } : {}),
                 },
             }, (res) => {
@@ -34,12 +34,12 @@ export function createRemoteBrowserExecutor({ host, token }) {
                         .catch(reject);
                     return;
                 }
-                res.setEncoding('utf8');
-                let buffer = '';
+                res.setEncoding("utf8");
+                let buffer = "";
                 let resolved = null;
-                res.on('data', (chunk) => {
+                res.on("data", (chunk) => {
                     buffer += chunk;
-                    let newlineIndex = buffer.indexOf('\n');
+                    let newlineIndex = buffer.indexOf("\n");
                     while (newlineIndex !== -1) {
                         const line = buffer.slice(0, newlineIndex).trim();
                         buffer = buffer.slice(newlineIndex + 1);
@@ -48,18 +48,18 @@ export function createRemoteBrowserExecutor({ host, token }) {
                                 resolved = result;
                             }, reject);
                         }
-                        newlineIndex = buffer.indexOf('\n');
+                        newlineIndex = buffer.indexOf("\n");
                     }
                 });
-                res.on('end', () => {
+                res.on("end", () => {
                     if (resolved) {
                         resolve(resolved);
                         return;
                     }
-                    reject(new Error('Remote browser run completed without a result.'));
+                    reject(new Error("Remote browser run completed without a result."));
                 });
             });
-            req.on('error', reject);
+            req.on("error", reject);
             req.write(body);
             req.end();
         });
@@ -74,7 +74,7 @@ async function serializeAttachments(attachments) {
             fileName: path.basename(attachment.path),
             displayPath: attachment.displayPath,
             sizeBytes: attachment.sizeBytes,
-            contentBase64: content.toString('base64'),
+            contentBase64: content.toString("base64"),
         });
     }
     return serialized;
@@ -96,26 +96,26 @@ function handleEvent(line, options, onResult, onError) {
         onError(new Error(`Failed to parse remote event: ${error instanceof Error ? error.message : String(error)}`));
         return;
     }
-    if (event.type === 'log') {
+    if (event.type === "log") {
         options.log?.(event.message);
         return;
     }
-    if (event.type === 'error') {
+    if (event.type === "error") {
         onError(new Error(event.message));
         return;
     }
-    if (event.type === 'result') {
+    if (event.type === "result") {
         onResult(event.result);
     }
 }
 function collectError(res) {
     return new Promise((resolve, reject) => {
         const chunks = [];
-        res.on('data', (chunk) => {
-            chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
+        res.on("data", (chunk) => {
+            chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
         });
-        res.on('end', () => {
-            const raw = Buffer.concat(chunks).toString('utf8');
+        res.on("end", () => {
+            const raw = Buffer.concat(chunks).toString("utf8");
             try {
                 const parsed = JSON.parse(raw);
                 resolve(parsed.error ?? `Remote host responded with status ${res.statusCode}`);
@@ -124,6 +124,6 @@ function collectError(res) {
                 resolve(raw || `Remote host responded with status ${res.statusCode}`);
             }
         });
-        res.on('error', reject);
+        res.on("error", reject);
     });
 }

package/dist/src/remote/health.js

@@ -1,6 +1,6 @@
-import http from 'node:http';
-import net from 'node:net';
-import { parseHostPort } from '../bridge/connection.js';
+import http from "node:http";
+import net from "node:net";
+import { parseHostPort } from "../bridge/connection.js";
 export async function checkTcpConnection(host, timeoutMs = 2000) {
     const { hostname, port } = parseHostPort(host);
     return await new Promise((resolve) => {
@@ -24,14 +24,14 @@ export async function checkTcpConnection(host, timeoutMs = 2000) {
             socket.unref();
         };
         socket.setTimeout(timeoutMs);
-        socket.once('error', onError);
-        socket.once('connect', onConnect);
-        socket.once('timeout', onTimeout);
+        socket.once("error", onError);
+        socket.once("connect", onConnect);
+        socket.once("timeout", onTimeout);
     });
 }
 export async function checkRemoteHealth({ host, token, timeoutMs = 5000, }) {
     const { hostname, port } = parseHostPort(host);
-    const headers = { accept: 'application/json' };
+    const headers = { accept: "application/json" };
     if (token) {
         headers.authorization = `Bearer ${token}`;
     }
@@ -39,26 +39,26 @@ export async function checkRemoteHealth({ host, token, timeoutMs = 5000, }) {
         const response = await requestJson({
             hostname,
             port,
-            path: '/health',
+            path: "/health",
             headers,
             timeoutMs,
         });
-        if (response.statusCode === 200 && typeof response.json === 'object' && response.json) {
+        if (response.statusCode === 200 && typeof response.json === "object" && response.json) {
             const ok = response.json.ok === true;
             const version = response.json.version;
             const uptimeSeconds = response.json.uptimeSeconds;
             return {
                 ok,
                 statusCode: response.statusCode,
-                version: typeof version === 'string' ? version : undefined,
-                uptimeSeconds: typeof uptimeSeconds === 'number' ? uptimeSeconds : undefined,
+                version: typeof version === "string" ? version : undefined,
+                uptimeSeconds: typeof uptimeSeconds === "number" ? uptimeSeconds : undefined,
             };
         }
         if (response.statusCode === 404) {
             return {
                 ok: false,
                 statusCode: response.statusCode,
-                error: 'remote host does not expose /health (upgrade oracle on the host and retry)',
+                error: "remote host does not expose /health (upgrade oracle on the host and retry)",
             };
         }
         const error = extractErrorMessage(response.json, response.bodyText) ?? `HTTP ${response.statusCode}`;
@@ -69,9 +69,9 @@ export async function checkRemoteHealth({ host, token, timeoutMs = 5000, }) {
     }
 }
 function extractErrorMessage(json, bodyText) {
-    if (json && typeof json === 'object') {
+    if (json && typeof json === "object") {
         const err = json.error;
-        if (typeof err === 'string' && err.trim().length > 0) {
+        if (typeof err === "string" && err.trim().length > 0) {
             return err.trim();
         }
     }
@@ -84,15 +84,15 @@ async function requestJson({ hostname, port, path, headers, timeoutMs, }) {
             hostname,
             port,
             path,
-            method: 'GET',
+            method: "GET",
             headers,
         }, (res) => {
-            res.setEncoding('utf8');
-            let body = '';
-            res.on('data', (chunk) => {
+            res.setEncoding("utf8");
+            let body = "";
+            res.on("data", (chunk) => {
                 body += chunk;
             });
-            res.on('end', () => {
+            res.on("end", () => {
                 const statusCode = res.statusCode ?? 0;
                 let json = null;
                 try {
@@ -107,7 +107,7 @@ async function requestJson({ hostname, port, path, headers, timeoutMs, }) {
         req.setTimeout(timeoutMs, () => {
             req.destroy(new Error(`timeout after ${timeoutMs}ms`));
         });
-        req.on('error', reject);
+        req.on("error", reject);
         req.end();
     });
 }

package/dist/src/remote/remoteServiceConfig.js

@@ -1,5 +1,5 @@
 function normalizeString(value) {
-    if (typeof value !== 'string')
+    if (typeof value !== "string")
         return undefined;
     const trimmed = value.trim();
     return trimmed.length ? trimmed : undefined;
@@ -14,18 +14,18 @@ export function resolveRemoteServiceConfig({ cliHost, cliToken, userConfig, env
     const host = cliHostValue ?? configBrowserHost ?? envHost;
     const token = cliTokenValue ?? configBrowserToken ?? envToken;
     const hostSource = cliHostValue
-        ? 'cli'
+        ? "cli"
         : configBrowserHost
-            ? 'config.browser'
+            ? "config.browser"
             : envHost
-                ? 'env'
-                : 'unset';
+                ? "env"
+                : "unset";
     const tokenSource = cliTokenValue
-        ? 'cli'
+        ? "cli"
         : configBrowserToken
-            ? 'config.browser'
+            ? "config.browser"
             : envToken
-                ? 'env'
-                : 'unset';
+                ? "env"
+                : "unset";
     return { host, token, sources: { host: hostSource, token: tokenSource } };
 }