@mjasnikovs/pi-task 0.14.14 → 0.14.15

package/dist/workers/brave-warning.d.ts

@@ -0,0 +1,10 @@
+/**
+ * One-line startup hint shown when no Brave Search key is configured.
+ *
+ * pi-task's web-search worker needs BRAVE_SEARCH_API_KEY (or BRAVE_API_KEY).
+ * When neither is set we surface a single, unobtrusive widget line on session
+ * start so the user knows search is disabled — it never blocks work and clears
+ * itself on the first interaction (any keystroke).
+ */
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export declare function registerBraveKeyWarning(pi: ExtensionAPI): void;

package/dist/workers/brave-warning.js

@@ -0,0 +1,46 @@
+/**
+ * One-line startup hint shown when no Brave Search key is configured.
+ *
+ * pi-task's web-search worker needs BRAVE_SEARCH_API_KEY (or BRAVE_API_KEY).
+ * When neither is set we surface a single, unobtrusive widget line on session
+ * start so the user knows search is disabled — it never blocks work and clears
+ * itself on the first interaction (any keystroke).
+ */
+const WIDGET_KEY = 'pi-task-brave-warning';
+const WARNING = '⚠ pi-task: BRAVE_SEARCH_API_KEY not set — web search is disabled. '
+    + 'Get a free key at https://api.search.brave.com/app/keys';
+/** Mirrors the lookup in search-core so the hint matches what the worker reads. */
+function hasBraveKey() {
+    return Boolean(process.env.BRAVE_SEARCH_API_KEY ?? process.env.BRAVE_API_KEY);
+}
+export function registerBraveKeyWarning(pi) {
+    pi.on('session_start', (_event, ctx) => {
+        // Terminal-only hint: needs an interactive TUI to render and to catch the
+        // keystroke that dismisses it. Skip when a key is already present.
+        if (ctx.mode !== 'tui' || hasBraveKey())
+            return;
+        let unsubscribe = null;
+        const clear = () => {
+            try {
+                ctx.ui.setWidget(WIDGET_KEY, undefined);
+            }
+            catch {
+                /* stale ctx after a session switch — nothing to clear */
+            }
+            unsubscribe?.();
+            unsubscribe = null;
+        };
+        try {
+            ctx.ui.setWidget(WIDGET_KEY, [ctx.ui.theme.fg('warning', WARNING)]);
+        }
+        catch {
+            return;
+        }
+        // Disappear on any interaction — the first raw keystroke clears it.
+        // Returning undefined leaves the input untouched (we only observe it).
+        unsubscribe = ctx.ui.onTerminalInput(() => {
+            clear();
+            return undefined;
+        });
+    });
+}

package/dist/workers/index.js

@@ -2,9 +2,11 @@ import { registerPiWorker } from './pi-worker.js';
 import { registerPiWorkerSearch } from './pi-worker-search.js';
 import { registerPiWorkerFetch } from './pi-worker-fetch.js';
 import { registerPiWorkerDocs } from './pi-worker-docs.js';
+import { registerBraveKeyWarning } from './brave-warning.js';
 export function registerWorkers(pi) {
     registerPiWorker(pi);
     registerPiWorkerSearch(pi);
     registerPiWorkerFetch(pi);
     registerPiWorkerDocs(pi);
+    registerBraveKeyWarning(pi);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mjasnikovs/pi-task",
-    "version": "0.14.14",
+    "version": "0.14.15",
     "description": "Deterministic spec-orchestration for local models, with a bundled real-time remote web view and web/docs/fetch/worker subagent tools.",
     "type": "module",
     "main": "./dist/index.js",