@steipete/oracle 0.9.0 → 0.11.0

package/dist/src/sessionManager.js

@@ -1,23 +1,23 @@
-import path from 'node:path';
-import fs from 'node:fs/promises';
-import { createWriteStream } from 'node:fs';
-import net from 'node:net';
-import { DEFAULT_MODEL, formatElapsed } from './oracle.js';
-import { safeModelSlug } from './oracle/modelResolver.js';
-import { getOracleHomeDir } from './oracleHome.js';
+import path from "node:path";
+import fs from "node:fs/promises";
+import { createWriteStream } from "node:fs";
+import net from "node:net";
+import { DEFAULT_MODEL, formatElapsed } from "./oracle.js";
+import { safeModelSlug } from "./oracle/modelResolver.js";
+import { getOracleHomeDir } from "./oracleHome.js";
 export function getSessionsDir() {
-    return path.join(getOracleHomeDir(), 'sessions');
-}
-const METADATA_FILENAME = 'meta.json';
-const LEGACY_SESSION_FILENAME = 'session.json';
-const LEGACY_REQUEST_FILENAME = 'request.json';
-const MODELS_DIRNAME = 'models';
-const MODEL_JSON_EXTENSION = '.json';
-const MODEL_LOG_EXTENSION = '.log';
+    return path.join(getOracleHomeDir(), "sessions");
+}
+const METADATA_FILENAME = "meta.json";
+const LEGACY_SESSION_FILENAME = "session.json";
+const LEGACY_REQUEST_FILENAME = "request.json";
+const MODELS_DIRNAME = "models";
+const MODEL_JSON_EXTENSION = ".json";
+const MODEL_LOG_EXTENSION = ".log";
 const MAX_STATUS_LIMIT = 1000;
 const ZOMBIE_MAX_AGE_MS = 60 * 60 * 1000; // 60 minutes
 const CHROME_RUNTIME_TIMEOUT_MS = 250;
-const DEFAULT_SLUG = 'session';
+const DEFAULT_SLUG = "session";
 const MAX_SLUG_WORDS = 5;
 const MIN_CUSTOM_SLUG_WORDS = 3;
 const MAX_SLUG_WORD_LENGTH = 10;
@@ -28,15 +28,13 @@ export async function ensureSessionStorage() {
     await ensureDir(getSessionsDir());
 }
 function slugify(text, maxWords = MAX_SLUG_WORDS) {
-    const normalized = text?.toLowerCase() ?? '';
+    const normalized = text?.toLowerCase() ?? "";
     const words = normalized.match(/[a-z0-9]+/g) ?? [];
-    const trimmed = words
-        .slice(0, maxWords)
-        .map((word) => word.slice(0, MAX_SLUG_WORD_LENGTH));
-    return trimmed.length > 0 ? trimmed.join('-') : DEFAULT_SLUG;
+    const trimmed = words.slice(0, maxWords).map((word) => word.slice(0, MAX_SLUG_WORD_LENGTH));
+    return trimmed.length > 0 ? trimmed.join("-") : DEFAULT_SLUG;
 }
 function countSlugWords(slug) {
-    return slug.split('-').filter(Boolean).length;
+    return slug.split("-").filter(Boolean).length;
 }
 function normalizeCustomSlug(candidate) {
     const slug = slugify(candidate, MAX_SLUG_WORDS);
@@ -65,7 +63,7 @@ function legacySessionPath(id) {
     return path.join(sessionDir(id), LEGACY_SESSION_FILENAME);
 }
 function logPath(id) {
-    return path.join(sessionDir(id), 'output.log');
+    return path.join(sessionDir(id), "output.log");
 }
 function modelsDir(id) {
     return path.join(sessionDir(id), MODELS_DIRNAME);
@@ -106,7 +104,7 @@ async function listModelRunFiles(sessionId) {
         }
         const jsonPath = path.join(dir, entry);
         try {
-            const raw = await fs.readFile(jsonPath, 'utf8');
+            const raw = await fs.readFile(jsonPath, "utf8");
             const parsed = JSON.parse(raw);
             const normalized = ensureModelLogReference(sessionId, parsed);
             result.push(normalized);
@@ -126,7 +124,7 @@ function ensureModelLogReference(sessionId, record) {
 }
 async function readModelRunFile(sessionId, model) {
     try {
-        const raw = await fs.readFile(modelJsonPath(sessionId, model), 'utf8');
+        const raw = await fs.readFile(modelJsonPath(sessionId, model), "utf8");
         const parsed = JSON.parse(raw);
         return ensureModelLogReference(sessionId, parsed);
     }
@@ -138,14 +136,14 @@ export async function updateModelRunMetadata(sessionId, model, updates) {
     await ensureDir(modelsDir(sessionId));
     const existing = (await readModelRunFile(sessionId, model)) ?? {
         model,
-        status: 'pending',
+        status: "pending",
     };
     const next = ensureModelLogReference(sessionId, {
         ...existing,
         ...updates,
         model,
     });
-    await fs.writeFile(modelJsonPath(sessionId, model), JSON.stringify(next, null, 2), 'utf8');
+    await fs.writeFile(modelJsonPath(sessionId, model), JSON.stringify(next, null, 2), "utf8");
     return next;
 }
 export async function readModelRunMetadata(sessionId, model) {
@@ -157,7 +155,7 @@ export async function initializeSession(options, cwd, notifications, baseSlugOve
     const sessionId = await ensureUniqueSessionId(baseSlug);
     const dir = sessionDir(sessionId);
     await ensureDir(dir);
-    const mode = options.mode ?? 'api';
+    const mode = options.mode ?? "api";
     const browserConfig = options.browserConfig;
     const modelList = Array.isArray(options.models) && options.models.length > 0
         ? options.models
@@ -167,12 +165,12 @@ export async function initializeSession(options, cwd, notifications, baseSlugOve
     const metadata = {
         id: sessionId,
         createdAt: new Date().toISOString(),
-        status: 'pending',
-        promptPreview: (options.prompt || '').slice(0, 160),
+        status: "pending",
+        promptPreview: (options.prompt || "").slice(0, 160),
         model: modelList[0] ?? options.model,
         models: modelList.map((modelName) => ({
             model: modelName,
-            status: 'pending',
+            status: "pending",
         })),
         cwd,
         mode,
@@ -215,24 +213,25 @@ export async function initializeSession(options, cwd, notifications, baseSlugOve
             generateImage: options.generateImage,
             editImage: options.editImage,
             outputPath: options.outputPath,
+            browserFollowUps: options.browserFollowUps,
             aspectRatio: options.aspectRatio,
             geminiShowThoughts: options.geminiShowThoughts,
         },
     };
     await ensureDir(modelsDir(sessionId));
-    await fs.writeFile(metaPath(sessionId), JSON.stringify(metadata, null, 2), 'utf8');
+    await fs.writeFile(metaPath(sessionId), JSON.stringify(metadata, null, 2), "utf8");
     await Promise.all((modelList.length > 0 ? modelList : [metadata.model ?? DEFAULT_MODEL]).map(async (modelName) => {
         const jsonPath = modelJsonPath(sessionId, modelName);
         const logFilePath = modelLogPath(sessionId, modelName);
         const modelRecord = {
             model: modelName,
-            status: 'pending',
+            status: "pending",
             log: { path: path.relative(sessionDir(sessionId), logFilePath) },
         };
-        await fs.writeFile(jsonPath, JSON.stringify(modelRecord, null, 2), 'utf8');
-        await fs.writeFile(logFilePath, '', 'utf8');
+        await fs.writeFile(jsonPath, JSON.stringify(modelRecord, null, 2), "utf8");
+        await fs.writeFile(logFilePath, "", "utf8");
     }));
-    await fs.writeFile(logPath(sessionId), '', 'utf8');
+    await fs.writeFile(logPath(sessionId), "", "utf8");
     return metadata;
 }
 export async function readSessionMetadata(sessionId) {
@@ -251,12 +250,12 @@ export async function updateSessionMetadata(sessionId, updates) {
         (await readLegacySessionMetadata(sessionId)) ??
         { id: sessionId };
     const next = { ...existing, ...updates };
-    await fs.writeFile(metaPath(sessionId), JSON.stringify(next, null, 2), 'utf8');
+    await fs.writeFile(metaPath(sessionId), JSON.stringify(next, null, 2), "utf8");
     return next;
 }
 async function readModernSessionMetadata(sessionId) {
     try {
-        const raw = await fs.readFile(metaPath(sessionId), 'utf8');
+        const raw = await fs.readFile(metaPath(sessionId), "utf8");
         const parsed = JSON.parse(raw);
         if (!isSessionMetadataRecord(parsed)) {
             return null;
@@ -271,7 +270,7 @@ async function readModernSessionMetadata(sessionId) {
 }
 async function readLegacySessionMetadata(sessionId) {
     try {
-        const raw = await fs.readFile(legacySessionPath(sessionId), 'utf8');
+        const raw = await fs.readFile(legacySessionPath(sessionId), "utf8");
         const parsed = JSON.parse(raw);
         const enriched = await attachModelRuns(parsed, sessionId);
         const runtimeChecked = await markDeadBrowser(enriched, { persist: false });
@@ -282,7 +281,7 @@ async function readLegacySessionMetadata(sessionId) {
     }
 }
 function isSessionMetadataRecord(value) {
-    return Boolean(value && typeof value.id === 'string' && value.status);
+    return Boolean(value && typeof value.id === "string" && value.status);
 }
 async function attachModelRuns(meta, sessionId) {
     const runs = await listModelRunFiles(sessionId);
@@ -296,8 +295,8 @@ export function createSessionLogWriter(sessionId, model) {
     if (model) {
         void ensureDir(modelsDir(sessionId));
     }
-    const stream = createWriteStream(targetPath, { flags: 'a' });
-    const logLine = (line = '') => {
+    const stream = createWriteStream(targetPath, { flags: "a" });
+    const logLine = (line = "") => {
         stream.write(`${line}\n`);
     };
     const writeChunk = (chunk) => {
@@ -320,7 +319,7 @@ export async function listSessionsMetadata() {
     }
     return metas.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
 }
-export function filterSessionsByRange(metas, { hours = 24, includeAll = false, limit = 100 }) {
+export function filterSessionsByRange(metas, { hours = 24, includeAll = false, limit = 100, }) {
     const maxLimit = Math.min(limit, MAX_STATUS_LIMIT);
     let filtered = metas;
     if (!includeAll) {
@@ -335,29 +334,31 @@ export async function readSessionLog(sessionId) {
     const runs = await listModelRunFiles(sessionId);
     if (runs.length === 0) {
         try {
-            return await fs.readFile(logPath(sessionId), 'utf8');
+            return await fs.readFile(logPath(sessionId), "utf8");
         }
         catch {
-            return '';
+            return "";
         }
     }
     const sections = [];
     let hasContent = false;
     const ordered = runs
         .slice()
-        .sort((a, b) => (a.startedAt && b.startedAt ? a.startedAt.localeCompare(b.startedAt) : a.model.localeCompare(b.model)));
+        .sort((a, b) => a.startedAt && b.startedAt
+        ? a.startedAt.localeCompare(b.startedAt)
+        : a.model.localeCompare(b.model));
     for (const run of ordered) {
         const logFile = run.log?.path
             ? path.isAbsolute(run.log.path)
                 ? run.log.path
                 : path.join(sessionDir(sessionId), run.log.path)
             : modelLogPath(sessionId, run.model);
-        let body = '';
+        let body = "";
         try {
-            body = await fs.readFile(logFile, 'utf8');
+            body = await fs.readFile(logFile, "utf8");
         }
         catch {
-            body = '';
+            body = "";
         }
         if (body.length > 0) {
             hasContent = true;
@@ -366,20 +367,20 @@ export async function readSessionLog(sessionId) {
     }
     if (!hasContent) {
         try {
-            return await fs.readFile(logPath(sessionId), 'utf8');
+            return await fs.readFile(logPath(sessionId), "utf8");
         }
         catch {
             // ignore and return structured header-only log
         }
     }
-    return sections.join('\n\n');
+    return sections.join("\n\n");
 }
 export async function readModelLog(sessionId, model) {
     try {
-        return await fs.readFile(modelLogPath(sessionId, model), 'utf8');
+        return await fs.readFile(modelLogPath(sessionId, model), "utf8");
     }
     catch {
-        return '';
+        return "";
     }
 }
 export async function readSessionRequest(sessionId) {
@@ -388,7 +389,7 @@ export async function readSessionRequest(sessionId) {
         return modern.options;
     }
     try {
-        const raw = await fs.readFile(requestPath(sessionId), 'utf8');
+        const raw = await fs.readFile(requestPath(sessionId), "utf8");
         const parsed = JSON.parse(raw);
         if (isSessionMetadataRecord(parsed)) {
             return parsed.options ?? null;
@@ -452,7 +453,7 @@ export async function getSessionPaths(sessionId) {
         }
     }
     if (missing.length > 0) {
-        throw new Error(`Session "${sessionId}" is missing: ${missing.join(', ')}`);
+        throw new Error(`Session "${sessionId}" is missing: ${missing.join(", ")}`);
     }
     return { dir, metadata, log, request };
 }
@@ -460,7 +461,7 @@ async function markZombie(meta, { persist }) {
     if (!(await isZombie(meta))) {
         return meta;
     }
-    if (meta.mode === 'browser') {
+    if (meta.mode === "browser") {
         const runtime = meta.browser?.runtime;
         if (runtime) {
             const signals = [];
@@ -468,7 +469,7 @@ async function markZombie(meta, { persist }) {
                 signals.push(isProcessAlive(runtime.chromePid));
             }
             if (runtime.chromePort) {
-                const host = runtime.chromeHost ?? '127.0.0.1';
+                const host = runtime.chromeHost ?? "127.0.0.1";
                 signals.push(await isPortOpen(host, runtime.chromePort));
             }
             if (signals.some(Boolean)) {
@@ -479,17 +480,17 @@ async function markZombie(meta, { persist }) {
     const maxAgeMs = resolveZombieMaxAgeMs(meta);
     const updated = {
         ...meta,
-        status: 'error',
+        status: "error",
         errorMessage: `Session marked as zombie (> ${formatElapsed(maxAgeMs)} stale)`,
         completedAt: new Date().toISOString(),
     };
     if (persist) {
-        await fs.writeFile(metaPath(meta.id), JSON.stringify(updated, null, 2), 'utf8');
+        await fs.writeFile(metaPath(meta.id), JSON.stringify(updated, null, 2), "utf8");
     }
     return updated;
 }
 async function markDeadBrowser(meta, { persist }) {
-    if (meta.status !== 'running' || meta.mode !== 'browser') {
+    if (meta.status !== "running" || meta.mode !== "browser") {
         return meta;
     }
     const runtime = meta.browser?.runtime;
@@ -501,7 +502,7 @@ async function markDeadBrowser(meta, { persist }) {
         signals.push(isProcessAlive(runtime.chromePid));
     }
     if (runtime.chromePort) {
-        const host = runtime.chromeHost ?? '127.0.0.1';
+        const host = runtime.chromeHost ?? "127.0.0.1";
         signals.push(await isPortOpen(host, runtime.chromePort));
     }
     if (signals.length === 0 || signals.some(Boolean)) {
@@ -510,24 +511,24 @@ async function markDeadBrowser(meta, { persist }) {
     const response = meta.response
         ? {
             ...meta.response,
-            status: 'error',
-            incompleteReason: meta.response.incompleteReason ?? 'chrome-disconnected',
+            status: "error",
+            incompleteReason: meta.response.incompleteReason ?? "chrome-disconnected",
         }
-        : { status: 'error', incompleteReason: 'chrome-disconnected' };
+        : { status: "error", incompleteReason: "chrome-disconnected" };
     const updated = {
         ...meta,
-        status: 'error',
-        errorMessage: 'Browser session ended (Chrome is no longer reachable)',
+        status: "error",
+        errorMessage: "Browser session ended (Chrome is no longer reachable)",
         completedAt: new Date().toISOString(),
         response,
     };
     if (persist) {
-        await fs.writeFile(metaPath(meta.id), JSON.stringify(updated, null, 2), 'utf8');
+        await fs.writeFile(metaPath(meta.id), JSON.stringify(updated, null, 2), "utf8");
     }
     return updated;
 }
 async function isZombie(meta) {
-    if (meta.status !== 'running') {
+    if (meta.status !== "running") {
         return false;
     }
     const reference = meta.startedAt ?? meta.createdAt;
@@ -546,11 +547,13 @@ async function isZombie(meta) {
 }
 function resolveZombieMaxAgeMs(meta) {
     const explicit = meta.options?.zombieTimeoutMs;
-    const hasExplicit = typeof explicit === 'number' && Number.isFinite(explicit) && explicit > 0;
+    const hasExplicit = typeof explicit === "number" && Number.isFinite(explicit) && explicit > 0;
     let maxAgeMs = hasExplicit ? explicit : ZOMBIE_MAX_AGE_MS;
     if (!hasExplicit) {
         const timeoutSeconds = meta.options?.timeoutSeconds;
-        if (typeof timeoutSeconds === 'number' && Number.isFinite(timeoutSeconds) && timeoutSeconds > 0) {
+        if (typeof timeoutSeconds === "number" &&
+            Number.isFinite(timeoutSeconds) &&
+            timeoutSeconds > 0) {
             const timeoutMs = timeoutSeconds * 1000;
             if (timeoutMs > maxAgeMs) {
                 maxAgeMs = timeoutMs;
@@ -563,7 +566,7 @@ async function getLastActivityMs(meta) {
     const candidates = new Set();
     candidates.add(logPath(meta.id));
     const modelNames = new Set();
-    if (typeof meta.model === 'string' && meta.model.length > 0) {
+    if (typeof meta.model === "string" && meta.model.length > 0) {
         modelNames.add(meta.model);
     }
     if (Array.isArray(meta.models)) {
@@ -602,10 +605,10 @@ function isProcessAlive(pid) {
     }
     catch (error) {
         const code = error instanceof Error ? error.code : undefined;
-        if (code === 'ESRCH' || code === 'EINVAL') {
+        if (code === "ESRCH" || code === "EINVAL") {
             return false;
         }
-        if (code === 'EPERM') {
+        if (code === "EPERM") {
             return true;
         }
         return true;
@@ -629,11 +632,11 @@ async function isPortOpen(host, port) {
             resolve(result);
         };
         const timer = setTimeout(() => cleanup(false), CHROME_RUNTIME_TIMEOUT_MS);
-        socket.once('connect', () => {
+        socket.once("connect", () => {
             clearTimeout(timer);
             cleanup(true);
         });
-        socket.once('error', () => {
+        socket.once("error", () => {
             clearTimeout(timer);
             cleanup(false);
         });

package/dist/src/sessionStore.js

@@ -1,4 +1,4 @@
-import { ensureSessionStorage, initializeSession, readSessionMetadata, updateSessionMetadata, createSessionLogWriter, readSessionLog, readModelLog, readSessionRequest, listSessionsMetadata, filterSessionsByRange, deleteSessionsOlderThan, updateModelRunMetadata, getSessionPaths, getSessionsDir, } from './sessionManager.js';
+import { ensureSessionStorage, initializeSession, readSessionMetadata, updateSessionMetadata, createSessionLogWriter, readSessionLog, readModelLog, readSessionRequest, listSessionsMetadata, filterSessionsByRange, deleteSessionsOlderThan, updateModelRunMetadata, getSessionPaths, getSessionsDir, } from "./sessionManager.js";
 class FileSessionStore {
     ensureStorage() {
         return ensureSessionStorage();
@@ -44,9 +44,9 @@ class FileSessionStore {
     }
 }
 export const sessionStore = new FileSessionStore();
-export { wait } from './sessionManager.js';
+export { wait } from "./sessionManager.js";
 export async function pruneOldSessions(hours, log) {
-    if (typeof hours !== 'number' || Number.isNaN(hours) || hours <= 0) {
+    if (typeof hours !== "number" || Number.isNaN(hours) || hours <= 0) {
         return;
     }
     const result = await sessionStore.deleteOlderThan({ hours });

package/dist/src/version.js

@@ -1,6 +1,6 @@
-import { readFileSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
 let cachedVersion = null;
 export function getCliVersion() {
     if (cachedVersion) {
@@ -15,18 +15,18 @@ function readVersionFromPackage() {
     const filesystemRoot = path.parse(currentDir).root;
     // biome-ignore lint/nursery/noUnnecessaryConditions: deliberate sentinel loop to walk up directories
     while (true) {
-        const candidate = path.join(currentDir, 'package.json');
+        const candidate = path.join(currentDir, "package.json");
         try {
-            const raw = readFileSync(candidate, 'utf8');
+            const raw = readFileSync(candidate, "utf8");
             const parsed = JSON.parse(raw);
-            const version = typeof parsed.version === 'string' && parsed.version.trim().length > 0
+            const version = typeof parsed.version === "string" && parsed.version.trim().length > 0
                 ? parsed.version.trim()
-                : '0.0.0';
+                : "0.0.0";
             return version;
         }
         catch (error) {
-            const code = error instanceof Error && 'code' in error ? error.code : undefined;
-            if (code && code !== 'ENOENT') {
+            const code = error instanceof Error && "code" in error ? error.code : undefined;
+            if (code && code !== "ENOENT") {
                 break;
             }
         }
@@ -35,5 +35,5 @@ function readVersionFromPackage() {
         }
         currentDir = path.dirname(currentDir);
     }
-    return '0.0.0';
+    return "0.0.0";
 }

package/dist/vendor/oracle-notifier/README.md

@@ -18,7 +18,9 @@ export APP_STORE_CONNECT_ISSUER_ID=YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY
 - Output: `OracleNotifier.app` (arm64 only), bundled with `OracleIcon.icns`.
 
 ## Usage
+
 The CLI prefers this helper on macOS; if it fails or is missing, it falls back to toasted-notifier/terminal-notifier.
 
 ## Permissions
+
 After first run, allow notifications for “Oracle Notifier” in System Settings → Notifications.