@steipete/oracle 0.4.0

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@steipete/oracle",
+  "version": "0.4.0",
+  "description": "CLI wrapper around OpenAI Responses API with GPT-5.1 Pro, GPT-5.1, and GPT-5.1 Codex high reasoning modes.",
+  "type": "module",
+  "main": "dist/bin/oracle-cli.js",
+  "bin": {
+    "oracle": "dist/bin/oracle-cli.js",
+    "oracle-mcp": "dist/bin/oracle-mcp.js"
+  },
+  "scripts": {
+    "docs:list": "tsx scripts/docs-list.ts",
+    "build": "tsc -p tsconfig.build.json && pnpm run build:vendor",
+    "build:vendor": "mkdir -p dist/vendor && cp -R vendor/oracle-notifier dist/vendor/oracle-notifier || true",
+    "start": "pnpm run build && node ./dist/scripts/run-cli.js",
+    "oracle": "pnpm start",
+    "check": "pnpm run typecheck",
+    "typecheck": "tsc --noEmit",
+    "lint": "pnpm run typecheck && biome lint .",
+    "test": "vitest run",
+    "test:browser": "pnpm run build && ./scripts/browser-smoke.sh",
+    "test:live": "ORACLE_LIVE_TEST=1 vitest run tests/live --exclude tests/live/openai-live.test.ts",
+    "test:pro": "ORACLE_LIVE_TEST=1 vitest run tests/live/openai-live.test.ts",
+    "test:coverage": "vitest run --coverage",
+    "prepare": "pnpm run build",
+    "mcp": "pnpm run build && node ./dist/bin/oracle-mcp.js"
+  },
+  "files": [
+    "dist/**/*",
+    "assets-oracle-icon.png",
+    "vendor/oracle-notifier/OracleNotifier.swift",
+    "vendor/oracle-notifier/OracleNotifier.app/**",
+    "vendor/oracle-notifier/build-notifier.sh",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/steipete/oracle.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/steipete/oracle/issues"
+  },
+  "homepage": "https://github.com/steipete/oracle#readme",
+  "dependencies": {
+    "@google/genai": "^1.30.0",
+    "@google/generative-ai": "^0.24.1",
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "chalk": "^5.6.2",
+    "chrome-cookies-secure": "3.0.0",
+    "chrome-launcher": "^1.2.1",
+    "chrome-remote-interface": "^0.33.3",
+    "clipboardy": "^4.0.0",
+    "commander": "^14.0.2",
+    "dotenv": "^17.2.3",
+    "fast-glob": "^3.3.3",
+    "gpt-tokenizer": "^3.4.0",
+    "inquirer": "^9.3.8",
+    "json5": "^2.2.3",
+    "keytar": "^7.9.0",
+    "kleur": "^4.1.5",
+    "markdansi": "^0.1.3",
+    "openai": "^6.9.0",
+    "shiki": "^3.15.0",
+    "sqlite3": "^5.1.7",
+    "toasted-notifier": "^10.1.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@anthropic-ai/tokenizer": "^0.0.4",
+    "@biomejs/biome": "^2.3.5",
+    "@types/chrome-remote-interface": "^0.31.14",
+    "@types/inquirer": "^9.0.9",
+    "@types/json5": "^0.0.30",
+    "@types/node": "^24.10.1",
+    "@vitest/coverage-v8": "4.0.9",
+    "devtools-protocol": "^0.0.1545402",
+    "es-toolkit": "^1.42.0",
+    "puppeteer-core": "^24.30.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.9"
+  },
+  "optionalDependencies": {
+    "win-dpapi": "^1.1.0"
+  },
+  "pnpm": {
+    "overrides": {
+      "zod": "3.24.1",
+      "win-dpapi": "npm:@primno/dpapi@2.0.1"
+    },
+    "onlyBuiltDependencies": [
+      "keytar",
+      "sqlite3",
+      "win-dpapi"
+    ]
+  },
+  "packageManager": "pnpm@10.23.0+sha512.21c4e5698002ade97e4efe8b8b4a89a8de3c85a37919f957e7a0f30f38fbc5bbdd05980ffe29179b2fb6e6e691242e098d945d1601772cad0fef5fb6411e2a4b"
+}

package/vendor/oracle-notifier/OracleNotifier.app/Contents/Info.plist

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleIdentifier</key>
+  <string>com.steipete.oracle.notifier</string>
+  <key>CFBundleName</key>
+  <string>OracleNotifier</string>
+  <key>CFBundleDisplayName</key>
+  <string>Oracle Notifier</string>
+  <key>CFBundleExecutable</key>
+  <string>OracleNotifier</string>
+  <key>CFBundleIconFile</key>
+  <string>OracleIcon</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  <key>LSMinimumSystemVersion</key>
+  <string>13.0</string>
+</dict>
+</plist>

package/vendor/oracle-notifier/OracleNotifier.app/Contents/_CodeSignature/CodeResources

@@ -0,0 +1,128 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>files</key>
+	<dict>
+		<key>Resources/OracleIcon.icns</key>
+		<data>
+		edUHAMetayIv3xtc3Vb92VXRLfM=
+		</data>
+	</dict>
+	<key>files2</key>
+	<dict>
+		<key>Resources/OracleIcon.icns</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			AVPJK/6w6IOsDLmZTW4hL+Za+/4wHMxZiIp0t6m3NRA=
+			</data>
+		</dict>
+	</dict>
+	<key>rules</key>
+	<dict>
+		<key>^Resources/</key>
+		<true/>
+		<key>^Resources/.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^Resources/.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Resources/Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^version.plist$</key>
+		<true/>
+	</dict>
+	<key>rules2</key>
+	<dict>
+		<key>.*\.dSYM($|/)</key>
+		<dict>
+			<key>weight</key>
+			<real>11</real>
+		</dict>
+		<key>^(.*/)?\.DS_Store$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>2000</real>
+		</dict>
+		<key>^(Frameworks|SharedFrameworks|PlugIns|Plug-ins|XPCServices|Helpers|MacOS|Library/(Automator|Spotlight|LoginItems))/</key>
+		<dict>
+			<key>nested</key>
+			<true/>
+			<key>weight</key>
+			<real>10</real>
+		</dict>
+		<key>^.*</key>
+		<true/>
+		<key>^Info\.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^PkgInfo$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^Resources/</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^Resources/.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^Resources/.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Resources/Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^[^/]+$</key>
+		<dict>
+			<key>nested</key>
+			<true/>
+			<key>weight</key>
+			<real>10</real>
+		</dict>
+		<key>^embedded\.provisionprofile$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^version\.plist$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/vendor/oracle-notifier/OracleNotifier.swift

@@ -0,0 +1,45 @@
+import Foundation
+import UserNotifications
+
+let args = CommandLine.arguments
+// Usage: OracleNotifier <title> <message> [soundName]
+if args.count < 3 {
+  fputs("usage: OracleNotifier <title> <message> [soundName]\n", stderr)
+  exit(1)
+}
+let title = args[1]
+let message = args[2]
+let soundName = args.count >= 4 ? args[3] : "Glass"
+
+let center = UNUserNotificationCenter.current()
+let group = DispatchGroup()
+group.enter()
+center.requestAuthorization(options: [.alert, .sound, .badge]) { granted, error in
+  if let error = error {
+    fputs("auth error: \(error)\n", stderr)
+    group.leave()
+    return
+  }
+  if !granted {
+    fputs("authorization not granted\n", stderr)
+    group.leave()
+    return
+  }
+  let content = UNMutableNotificationContent()
+  content.title = title
+  content.body = message
+  if !soundName.isEmpty {
+    content.sound = UNNotificationSound(named: UNNotificationSoundName(rawValue: soundName))
+  } else {
+    content.sound = UNNotificationSound.default
+  }
+  let request = UNNotificationRequest(identifier: UUID().uuidString, content: content, trigger: nil)
+  center.add(request) { addError in
+    if let addError = addError {
+      fputs("add error: \(addError)\n", stderr)
+    }
+    group.leave()
+  }
+}
+_ = group.wait(timeout: .now() + 2)
+RunLoop.current.run(until: Date().addingTimeInterval(1))

package/vendor/oracle-notifier/README.md

@@ -0,0 +1,24 @@
+# Oracle Notifier helper (macOS, arm64)
+
+Builds a tiny signed helper app for macOS notifications with the Oracle icon.
+
+## Build
+
+```bash
+cd vendor/oracle-notifier
+# Optional: notarize by setting App Store Connect key credentials
+export APP_STORE_CONNECT_API_KEY_P8="$(cat AuthKey_XXXXXX.p8)" # with literal newlines or \n escaped
+export APP_STORE_CONNECT_KEY_ID=XXXXXX
+export APP_STORE_CONNECT_ISSUER_ID=YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY
+./build-notifier.sh
+```
+
+- Requires Xcode command line tools (swiftc) and a macOS Developer ID certificate. Without a valid cert, the build fails (no ad-hoc fallback).
+- If `APP_STORE_CONNECT_*` vars are set, the script notarizes and staples the ticket.
+- 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.

package/vendor/oracle-notifier/build-notifier.sh

@@ -0,0 +1,93 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")"
+
+ICON_SRC=../../assets-oracle-icon.png
+APP=OracleNotifier.app
+CONTENTS="$APP/Contents"
+MACOS="$CONTENTS/MacOS"
+RESOURCES="$CONTENTS/Resources"
+ICONSET=OracleIcon.iconset
+ICNS=OracleIcon.icns
+IDENTITY="${CODESIGN_ID:-Developer ID Application: Peter Steinberger (Y5PE65HELJ)}"
+ZIP="/tmp/OracleNotifierNotarize.zip"
+
+NOTARY_KEY_P8="${APP_STORE_CONNECT_API_KEY_P8:-}"
+NOTARY_KEY_ID="${APP_STORE_CONNECT_KEY_ID:-}"
+NOTARY_ISSUER_ID="${APP_STORE_CONNECT_ISSUER_ID:-}"
+DITTO_BIN=${DITTO_BIN:-/usr/bin/ditto}
+
+cleanup() {
+  rm -f "$ZIP" /tmp/oracle-notifier-api-key.p8
+}
+trap cleanup EXIT
+
+rm -rf "$APP" "$ICONSET" "$ICNS"
+mkdir -p "$MACOS" "$RESOURCES"
+
+# Build ICNS from PNG
+mkdir "$ICONSET"
+for sz in 16 32 64 128 256 512; do
+  sips -z $sz $sz "$ICON_SRC" --out "$ICONSET/icon_${sz}x${sz}.png" >/dev/null
+  sips -z $((sz*2)) $((sz*2)) "$ICON_SRC" --out "$ICONSET/icon_${sz}x${sz}@2x.png" >/dev/null
+done
+iconutil -c icns --output "$ICNS" "$ICONSET"
+mv "$ICNS" "$RESOURCES/OracleIcon.icns"
+rm -rf "$ICONSET"
+
+# Write Info.plist
+cat > "$CONTENTS/Info.plist" <<'PLIST'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleIdentifier</key>
+  <string>com.steipete.oracle.notifier</string>
+  <key>CFBundleName</key>
+  <string>OracleNotifier</string>
+  <key>CFBundleDisplayName</key>
+  <string>Oracle Notifier</string>
+  <key>CFBundleExecutable</key>
+  <string>OracleNotifier</string>
+  <key>CFBundleIconFile</key>
+  <string>OracleIcon</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  <key>LSMinimumSystemVersion</key>
+  <string>13.0</string>
+</dict>
+</plist>
+PLIST
+
+# Compile Swift helper (arm64)
+swiftc -target arm64-apple-macos13 -o "$MACOS/OracleNotifier" OracleNotifier.swift -framework Foundation -framework UserNotifications
+
+echo "Signing with $IDENTITY"
+if ! codesign --force --deep --options runtime --timestamp --sign "$IDENTITY" "$APP"; then
+  echo "codesign failed. Set CODESIGN_ID to a valid Developer ID Application certificate." >&2
+  exit 1
+fi
+
+# Notarize if credentials are provided
+if [[ -n "$NOTARY_KEY_P8" && -n "$NOTARY_KEY_ID" && -n "$NOTARY_ISSUER_ID" ]]; then
+  echo "$NOTARY_KEY_P8" | sed 's/\\n/\n/g' > /tmp/oracle-notifier-api-key.p8
+  echo "Packaging for notarization"
+  "$DITTO_BIN" -c -k --keepParent --sequesterRsrc "$APP" "$ZIP"
+
+  echo "Submitting for notarization"
+  xcrun notarytool submit "$ZIP" \
+    --key /tmp/oracle-notifier-api-key.p8 \
+    --key-id "$NOTARY_KEY_ID" \
+    --issuer "$NOTARY_ISSUER_ID" \
+    --wait
+
+  echo "Stapling ticket"
+  xcrun stapler staple "$APP"
+  xcrun stapler validate "$APP"
+else
+  echo "Skipping notarization (APP_STORE_CONNECT_* env vars not set)."
+fi
+
+spctl -a -t exec -vv "$APP" || true
+
+echo "Built $APP"