@habemus-papadum/aiui 0.1.0 → 0.2.0

package/dist/util/chrome.d.ts

@@ -77,8 +77,9 @@ export declare function devtoolsExtensionDir(): string | undefined;
 /**
  * Rebuild the aiui-devtools-extension package so the auto-loaded panel is never stale.
  *
- * A full tsc of the extension is ~0.3s — cheap enough to run on every launch
- * rather than tracking staleness. Best-effort by design: outside a dev
+ * A full tsc of the extension (plus the debug-ui esbuild bundle) is well
+ * under a second — cheap enough to run on every launch rather than tracking
+ * staleness. Best-effort by design: outside a dev
  * checkout (no devtools package, no typescript) it silently does nothing, and
  * a failing compile warns loudly but never blocks the launch — whatever
  * `extension/js` already holds is what gets loaded.

package/dist/util/openai-preflight.d.ts

@@ -0,0 +1,65 @@
+/**
+ * OpenAI key preflight for `aiui claude`.
+ *
+ * Once the multimodal intent modality is the overlay's default, its speech
+ * transcription and correction-diff calls need an OpenAI key — and they run in
+ * the *channel* process, which inherits the environment `aiui claude` launches
+ * in. The adopted key story (see the multimodal-intent-graduation handoff) is
+ * deliberately narrow: the key comes from **`OPENAI_API_KEY` in the
+ * environment**, never from `config.json` (a shareable, eventually-committed
+ * file must not hold secrets) and never from an `aiui claude` flag.
+ *
+ * So the launcher's whole job is to *preflight* that env var and tell the user
+ * what it found — degradation, not refusal. A missing or rejected key never
+ * blocks the launch; the modality still mounts and transcription/correction
+ * fall back to mock/off. The most valuable case this catches is the one that
+ * bit the bench twice (see workbench field-notes, "Keys & config"): a **stale
+ * shell export** shadowing the real key, which surfaces as a confusing 401 deep
+ * in the pipeline rather than a clear message up front.
+ *
+ * We record only a {@link OpenAiKeyStatus} — never the key or any prefix of it —
+ * so the launch-info summary (and the DevTools panel that renders it) can
+ * explain a degraded pipeline without ever seeing the secret.
+ */
+import type { OpenAiKeyStatus } from "@habemus-papadum/aiui-claude-channel";
+export type { OpenAiKeyStatus };
+export interface PreflightOptions {
+    /**
+     * Perform the authenticated network check. True only for interactive,
+     * non-CI launches (the same gate as the Chrome-for-Testing prompts). When
+     * false — CI or any non-interactive session — the check is skipped silently
+     * and a present key is reported as "unverified", never contacted.
+     */
+    verify?: boolean;
+    /** Injectable for tests; defaults to the process environment. */
+    env?: NodeJS.ProcessEnv;
+    /** Injectable for tests; defaults to global `fetch`. */
+    fetchImpl?: typeof fetch;
+    /** Network budget for the status check (default {@link DEFAULT_TIMEOUT_MS}). */
+    timeoutMs?: number;
+}
+/**
+ * Determine the status of `OPENAI_API_KEY` for this launch.
+ *
+ * Never throws, never prints, never returns the key. Absent env var →
+ * "missing". Present but `verify` off → "unverified" (no network touched).
+ * Present and verifying → a single `GET /v1/models` with the bearer, read for
+ * **status only**: 2xx → "valid", 401/403 → "invalid", anything else (5xx,
+ * 429, a network error, or the timeout) → "unverified" — a key we couldn't
+ * confirm is not a key we condemn.
+ */
+export declare function preflightOpenAiKey(opts?: PreflightOptions): Promise<OpenAiKeyStatus>;
+interface PreflightMessage {
+    level: "warn" | "note";
+    title: string;
+    detail: string;
+}
+/**
+ * The user-facing message for a preflight status, or `null` when there's
+ * nothing to say. A valid key is silent — the launcher's terminal stays quiet
+ * until something's actually wrong (the same posture as {@link printNote} &c).
+ * The copy is data (not printed here) so it can be unit-tested per case.
+ */
+export declare function openAiPreflightMessage(status: OpenAiKeyStatus): PreflightMessage | null;
+/** Print the preflight message for `status` (nothing, for a valid key). */
+export declare function reportOpenAiPreflight(status: OpenAiKeyStatus): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@habemus-papadum/aiui",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "ai ui frontends",
   "type": "module",
   "license": "MIT",
@@ -36,10 +36,10 @@
     "commander": "^15.0.0",
     "execa": "^9.6.1",
     "vite": "^6.4.3",
-    "@habemus-papadum/aiui-claude-channel": "^0.1.0",
-    "@habemus-papadum/aiui-devtools-extension": "^0.1.0",
-    "@habemus-papadum/aiui-claude-plugin": "^0.1.0",
-    "@habemus-papadum/aiui-util": "^0.1.0"
+    "@habemus-papadum/aiui-claude-plugin": "^0.2.0",
+    "@habemus-papadum/aiui-util": "^0.2.0",
+    "@habemus-papadum/aiui-claude-channel": "^0.2.0",
+    "@habemus-papadum/aiui-devtools-extension": "^0.2.0"
   },
   "scripts": {
     "build": "tsc --emitDeclarationOnly -p tsconfig.json && vite build",

package/templates/demo/package.json

@@ -14,6 +14,7 @@
     "@habemus-papadum/aiui-dev-overlay": "__AIUI_VERSION_RANGE__"
   },
   "devDependencies": {
+    "@babel/core": "^7.29.7",
     "@habemus-papadum/aiui": "__AIUI_VERSION_RANGE__",
     "vite": "^6.4.1"
   }

package/templates/demo/vite.config.ts

@@ -6,6 +6,12 @@ import { defineConfig } from "vite";
 // message format the tool speaks, and bridges the channel port from
 // `aiui vite` (VITE_AIUI_PORT in this dev server's env) plus this app's source
 // root into the browser.
+//
+// `locator` turns on compile-time source stamping: every host JSX element gets
+// data-source-loc = "src/…:line:col", and `cell()` call sites get their
+// `{ name, loc }` identity injected — so anything you build here is legible to
+// an agent (the `locate` tool) out of the box. It needs @babel/core (an
+// optional peer, provided as a devDependency of this sandbox).
 export default defineConfig({
-  plugins: [aiuiDevOverlay({ format: "text-concat" })],
+  plugins: [aiuiDevOverlay({ format: "text-concat", locator: { cellFactories: ["cell"] } })],
 });