ovrule-lab 0.1.3 → 0.2.1

package/README.md

@@ -8,6 +8,8 @@ TypeScript client for Ovrule case-file classification, guardrails, and receipt v
 npm install ovrule-lab
 ```
 
+On the first successful `classify()` or `guard()` call in a process, the SDK prints a one-line ready message plus a permalink to the created case. Later successful audits print only the case permalink. Set `OVRULE_QUIET=1` to suppress those logs.
+
 ## 1. Simple classify
 
 ```ts

package/dist/index.js

@@ -1,3 +1,32 @@
+const DEFAULT_OVRULE_BASE_URL = "https://decision-receipt-lab.vercel.app";
+const SDK_VERSION = "0.2.1";
+let hasShownReadyMessage = false;
+function isQuietModeEnabled() {
+    return (typeof process !== "undefined" &&
+        typeof process.env === "object" &&
+        typeof process.env.OVRULE_QUIET !== "undefined" &&
+        process.env.OVRULE_QUIET !== "");
+}
+function getConsoleBaseUrl(baseUrl) {
+    if (baseUrl) {
+        return baseUrl;
+    }
+    if (typeof window !== "undefined" && window.location?.origin) {
+        return window.location.origin;
+    }
+    return DEFAULT_OVRULE_BASE_URL;
+}
+function logSuccessfulAudit(receipt, baseUrl) {
+    if (isQuietModeEnabled()) {
+        return;
+    }
+    const caseUrl = `${getConsoleBaseUrl(baseUrl)}/case/${receipt.receiptId}`;
+    if (!hasShownReadyMessage) {
+        console.info(`[ovrule-lab v${SDK_VERSION}] ready · docs: ${DEFAULT_OVRULE_BASE_URL}/docs`);
+        hasShownReadyMessage = true;
+    }
+    console.info(`[ovrule-lab] ✓ audited via ${caseUrl}`);
+}
 function normalizeAction(action, options) {
     if (typeof action === "string") {
         return {
@@ -17,11 +46,38 @@ async function readJson(response) {
     }
     return data;
 }
+function parseSseBlock(block) {
+    const lines = block.split("\n");
+    const eventName = lines.find((line) => line.startsWith("event:"))?.slice(6).trim();
+    const data = lines
+        .filter((line) => line.startsWith("data:"))
+        .map((line) => line.slice(5).trim())
+        .join("\n");
+    if (!eventName || !data) {
+        return null;
+    }
+    return {
+        eventName,
+        data: JSON.parse(data),
+    };
+}
+function applySseEvent(parsed, currentReceipt) {
+    if (!parsed) {
+        return currentReceipt;
+    }
+    if (parsed.data.type === "session.error") {
+        throw new Error(parsed.data.message);
+    }
+    if (parsed.data.type === "analysis.completed") {
+        return parsed.data.receipt;
+    }
+    return currentReceipt;
+}
 export class OvruleClient {
     baseUrl;
     fetchImpl;
     constructor(options = {}) {
-        this.baseUrl = options.baseUrl?.replace(/\/$/, "") ?? "";
+        this.baseUrl = options.baseUrl?.replace(/\/$/, "") ?? DEFAULT_OVRULE_BASE_URL;
         this.fetchImpl = options.fetch ?? globalThis.fetch;
         if (!this.fetchImpl) {
             throw new Error("No fetch implementation available. Pass one in OvruleClient options.");
@@ -57,34 +113,26 @@ export class OvruleClient {
         let finalReceipt = null;
         while (true) {
             const { done, value } = await reader.read();
-            if (done) {
-                break;
+            if (value) {
+                buffer += decoder.decode(value, { stream: !done });
             }
-            buffer += decoder.decode(value, { stream: true });
             const blocks = buffer.split("\n\n");
             buffer = blocks.pop() ?? "";
             for (const block of blocks) {
-                const lines = block.split("\n");
-                const eventName = lines.find((line) => line.startsWith("event:"))?.slice(6).trim();
-                const data = lines
-                    .filter((line) => line.startsWith("data:"))
-                    .map((line) => line.slice(5).trim())
-                    .join("\n");
-                if (!eventName || !data) {
-                    continue;
-                }
-                const parsed = JSON.parse(data);
-                if (parsed.type === "analysis.completed") {
-                    finalReceipt = parsed.receipt;
-                }
-                if (parsed.type === "session.error") {
-                    throw new Error(parsed.message);
-                }
+                finalReceipt = applySseEvent(parseSseBlock(block), finalReceipt);
             }
+            if (done) {
+                break;
+            }
+        }
+        buffer += decoder.decode();
+        if (buffer.trim()) {
+            finalReceipt = applySseEvent(parseSseBlock(buffer.trim()), finalReceipt);
         }
         if (!finalReceipt) {
             throw new Error("Ovrule classify stream finished without a final receipt.");
         }
+        logSuccessfulAudit(finalReceipt, this.baseUrl);
         return finalReceipt;
     }
     async guard(action, options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ovrule-lab",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "description": "TypeScript SDK for Ovrule case-file classification, guardrails, and receipt verification.",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,18 +14,12 @@
   },
   "files": [
     "dist",
-    "README.md",
-    "postinstall.js",
-    "bin/welcome.js"
+    "README.md"
   ],
-  "bin": {
-    "ovrule-lab": "./bin/welcome.js"
-  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "clean": "rm -rf dist",
-    "prepublishOnly": "npm run clean && npm run build",
-    "postinstall": "node postinstall.js"
+    "prepublishOnly": "npm run clean && npm run build"
   },
   "keywords": [
     "ovrule",

package/bin/welcome.js

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-/* eslint-disable no-console */
-
-const reset = "\x1b[0m";
-const dim = "\x1b[2m";
-const bold = "\x1b[1m";
-const cyan = "\x1b[36m";
-const magenta = "\x1b[35m";
-const yellow = "\x1b[33m";
-
-const lines = [
-  "",
-  `${bold}${cyan}   ╔═══════════════════════════════════════════════╗${reset}`,
-  `${bold}${cyan}   ║${reset}   ${bold}O${reset}${magenta}━━${reset}${bold}V${reset}   ${bold}Ovrule${reset} · SDK v0.1.3                  ${bold}${cyan}║${reset}`,
-  `${bold}${cyan}   ║${reset}         ${dim}Auditable receipts for AI agents${reset}      ${bold}${cyan}║${reset}`,
-  `${bold}${cyan}   ╚═══════════════════════════════════════════════╝${reset}`,
-  "",
-  `   ${bold}Quickstart${reset}`,
-  `   ${dim}import { classify } from "ovrule-lab";${reset}`,
-  `   ${dim}const receipt = await classify("your agent action", {${reset}`,
-  `   ${dim}  baseUrl: "https://decision-receipt-lab.vercel.app"${reset}`,
-  `   ${dim}});${reset}`,
-  "",
-  `   ${bold}Methods${reset}`,
-  `   ${dim}classify(action, opts)${reset}   — full case file audit`,
-  `   ${dim}guard(action, opts)${reset}      — returns { allowed, decision, ... }`,
-  `   ${dim}verify(receipt, sig, opts)${reset} — verify a signed receipt`,
-  "",
-  `   ${bold}Docs${reset}     ${yellow}https://decision-receipt-lab.vercel.app/docs${reset}`,
-  `   ${bold}GitHub${reset}   ${yellow}https://github.com/elakumuk/decision-receipt-lab${reset}`,
-  "",
-  `   ${dim}Built with Codex for the OpenAI Creator Challenge, April 2026.${reset}`,
-  "",
-];
-
-console.log(lines.join("\n"));

package/postinstall.js

@@ -1,41 +0,0 @@
-#!/usr/bin/env node
-/* eslint-disable no-console */
-
-// Allow users to opt out
-if (process.env.OVRULE_SILENT) {
-  process.exit(0);
-}
-
-// Skip in CI to avoid cluttering build logs
-if (process.env.CI) {
-  process.exit(0);
-}
-
-const reset = "\x1b[0m";
-const dim = "\x1b[2m";
-const bold = "\x1b[1m";
-const cyan = "\x1b[36m";
-const magenta = "\x1b[35m";
-const yellow = "\x1b[33m";
-
-const lines = [
-  "",
-  `${bold}${cyan}   ╔═══════════════════════════════════════════════╗${reset}`,
-  `${bold}${cyan}   ║${reset}   ${bold}O${reset}${magenta}━━${reset}${bold}V${reset}   ${bold}Ovrule${reset} · SDK v0.1.2                  ${bold}${cyan}║${reset}`,
-  `${bold}${cyan}   ║${reset}         ${dim}Auditable receipts for AI agents${reset}      ${bold}${cyan}║${reset}`,
-  `${bold}${cyan}   ╚═══════════════════════════════════════════════╝${reset}`,
-  "",
-  `   ${bold}Quickstart${reset}`,
-  `   ${dim}import { classify } from "ovrule-lab";${reset}`,
-  `   ${dim}const receipt = await classify("your agent action", {${reset}`,
-  `   ${dim}  baseUrl: "https://decision-receipt-lab.vercel.app"${reset}`,
-  `   ${dim}});${reset}`,
-  "",
-  `   ${bold}Docs${reset}     ${yellow}https://decision-receipt-lab.vercel.app/docs${reset}`,
-  `   ${bold}GitHub${reset}   ${yellow}https://github.com/elakumuk/decision-receipt-lab${reset}`,
-  "",
-  `   ${dim}Built with Codex for the OpenAI Creator Challenge, April 2026.${reset}`,
-  "",
-];
-
-console.log(lines.join("\n"));