@dualityinstitute/blink 0.0.3 → 0.0.5

package/README.md

@@ -1,13 +1,12 @@
 # Blink
 
-Blink is a macOS menu-bar meeting copilot. Monitor answers new screenshots
-automatically, while Meeting privately stages the latest transcript and captured
-screenshots until you explicitly Ask. Blink Cloud streams every answer into a
-floating popup.
+Blink is a macOS menu-bar meeting copilot. Monitor privately stages captured
+screenshots, and Meeting adds the live transcript, until you explicitly Ask.
+Blink Cloud streams every answer into a floating popup.
 
-- Fresh Monitor answers from a watched folder or global capture hotkeys
+- Global capture hotkeys that stage screenshots for the next Ask
 - Live `Them`/`You` Meeting transcript and private screenshot context
-- Explicit Ask button and `Ctrl+Cmd+Return` submission
+- Explicit Ask button and `⇧⌘Return` submission
 - Presenter notes that remain local to the Mac
 - Privacy mode for excluding Blink windows from supported screen capture
 - One-command Bun installation with an interactive terminal setup
@@ -24,7 +23,7 @@ credentials on the Mac.
 ## Install
 
 ```bash
-bunx @dualityinstitute/blink install
+bunx @dualityinstitute/blink@latest install
 ```
 
 The terminal UI asks for the access token, writes `~/.blink/config.json`, and
@@ -34,7 +33,7 @@ at its default URL, so only the token is needed.
 For non-interactive installation:
 
 ```bash
-bunx @dualityinstitute/blink install --token blink_customer_token
+bunx @dualityinstitute/blink@latest install --token blink_customer_token
 ```
 
 Pass `--api-url` as well to point the app at a different gateway, such as a
@@ -51,19 +50,20 @@ the app bundle, gateway health, and token.
 
 ## Monitor
 
-Anything that puts a PNG in `~/blinkDir` is submitted automatically while
-Monitor is on. Every Monitor screenshot receives a fresh server-side
-conversation. Two global capture shortcuts are registered while Monitor or
-Meeting is on:
+Monitor stages screenshots for an explicit Ask. Nothing is sent until you
+submit, so one Ask can carry several captures at once, and every Monitor Ask
+receives a fresh server-side conversation. Two global capture shortcuts are
+registered while Monitor or Meeting is on:
 
 | Capture | Shortcut |
 |---|---|
 | Select a region | `⇧⌘2` |
 | Whole main display | `⇧⌘1` |
 
-When Meeting is off, these shortcuts write into the watched directory for an
-automatic Monitor answer. When Meeting is active, the same shortcuts stage
-private Meeting screenshots instead and never answer automatically.
+Captures are staged privately under `~/.blink/captures/` in both modes and are
+never answered automatically. Select **Ask** or press `⇧⌘Return` to submit every
+staged screenshot in one request; with Meeting active the current transcript is
+included as well.
 
 The first capture asks for **Screen & System Audio Recording** permission under
 the signed **Blink** app identity.
@@ -72,11 +72,13 @@ the signed **Blink** app identity.
 
 Enable **Meeting** in the tray or popup. Blink starts a new identity-scoped
 Meeting conversation, captures system audio as `Them` and microphone audio as
-`You`, and keeps a rolling two-minute transcript locally. Captures made with the
+`You`, and keeps a rolling two-minute transcript for the model. The popup widens
+to show the full running transcript beside the answer; scroll back at any point
+and it stops following new speech until you return to the bottom. Captures made with the
 global shortcuts are retained in a private staging directory. The popup shows
 which transcript and screenshot context is ready.
 
-Select **Ask** or press `Ctrl+Cmd+Return` to submit one snapshot containing the
+Select **Ask** or press `⇧⌘Return` to submit one snapshot containing the
 available transcript and staged screenshots. Subsequent Asks reuse the same
 Meeting conversation. A failed Ask retains its context for retry; after a
 successful Ask, only the screenshots included in that submission are removed.
@@ -89,19 +91,22 @@ Run `blink ungrant` to clear both permission records and make macOS ask again.
 
 ### Saving transcripts
 
-**Save transcript** is off by default. When enabled, the entire Meeting is
-appended to a Markdown file under:
+Every Meeting is appended to a Markdown file on your Mac, one per session:
 
 ```text
 ~/.blink/transcripts/2026-08-30-143022.md
 ```
 
-This local setting is independent from submission: Ask always sends the current
-two-minute transcript snapshot when one is available.
+Saving is local only and independent from submission: Ask always sends the
+current two-minute transcript snapshot when one is available, no more.
+
+Open **Meeting Transcripts…** from the tray to read, search, and filter past
+sessions by date. Search runs across every saved transcript and reports how many
+times each session matched.
 
 ## Answer lifecycle and cancellation
 
-- Monitor answers are always fresh and independent.
+- Monitor Asks are always fresh and independent.
 - Starting Meeting resets that access identity's Meeting conversation.
 - Every Ask during the active Meeting continues that conversation.
 - **Stop** cancels the active request both locally and at the gateway.
@@ -110,9 +115,9 @@ two-minute transcript snapshot when one is available.
 
 Subscribe at [duality.institute/blink](https://duality.institute/blink). After
 Stripe Checkout the claim page shows your access token exactly once; paste it
-into `bunx @dualityinstitute/blink install`.
+into `bunx @dualityinstitute/blink@latest install`.
 
-Every Monitor screenshot and every Meeting Ask counts as one answer against
+Every Monitor Ask and every Meeting Ask counts as one answer against
 your monthly limit. The popup shows `used / limit` for the current period, and
 `blink doctor` prints the same together with the account email and status.
 Cancelled or failed answers are not counted. When the limit is reached, or the
@@ -131,16 +136,16 @@ Cloud.
 
 Blink Cloud receives:
 
-- A new watched-directory PNG while Monitor is on
 - The current two-minute transcript and staged screenshots only when Ask is used
 - The bearer access token needed to authorize and isolate the request
 
 The desktop stores the access token in `~/.blink/config.json`. Answer metadata
-and text are appended locally to `~/.blink/answers.jsonl`. Presenter Notes stay
-local in `~/.blink/presenter.md` and are never submitted. Meeting captures are
-staged under `~/.blink/meeting-captures/` and cleared when Meeting ends.
+and text are appended locally to `~/.blink/answers.jsonl`, and meeting
+transcripts to `~/.blink/transcripts/`. Presenter Notes stay
+local in `~/.blink/presenter.md` and are never submitted. Captures are staged
+under `~/.blink/captures/` and cleared when Monitor and Meeting are both off.
 
-Blink Cloud does not retain your content: a Monitor screenshot's conversation is
+Blink Cloud does not retain your content: a Monitor Ask's conversation is
 deleted as soon as the answer is returned, and a Meeting conversation is deleted
 when you turn Meeting off (or after two hours without an Ask). Only usage counts
 and token totals are kept for billing.
@@ -151,11 +156,9 @@ and token totals are kept for billing.
 |---|---|---|
 | `apiUrl` | Blink Cloud | Gateway base URL; override only for a self-hosted or local gateway |
 | `accessToken` | Empty | Bearer token issued for Blink Cloud |
-| `screenshotDir` | `~/blinkDir/` | Watched PNG directory |
 | `hideFromCapture` | `true` | Enables privacy mode |
-| `showTranscript` | `true` | Shows the live transcript strip |
-| `saveTranscript` | `false` | Saves full meeting transcripts locally |
+| `showTranscript` | `true` | Shows the live transcript panel during a meeting |
 
 Blink materializes new defaults without deleting unrelated settings from an
-existing config file. The obsolete `sessionMode` and `hotkeyPreset` keys are
-removed automatically.
+existing config file. The obsolete `sessionMode`, `hotkeyPreset`, and
+`screenshotDir` keys are removed automatically.

package/dist/cli.js

@@ -19862,14 +19862,17 @@ function date4(params) {
   return _coercedDate(ZodDate, params);
 }
 // src/core/cloud-protocol.ts
+var OptionalPrompt = exports_external.preprocess((value) => value === null || value === "" ? undefined : value, exports_external.string().trim().min(1).max(4000).optional());
 var MonitorRequestSchema = exports_external.object({
   kind: exports_external.literal("monitor"),
-  image: exports_external.instanceof(File)
+  images: exports_external.array(exports_external.instanceof(File)).min(1).readonly(),
+  prompt: OptionalPrompt
 });
 var MeetingRequestSchema = exports_external.object({
   kind: exports_external.literal("meeting"),
   text: exports_external.preprocess((value) => value === null ? undefined : value, exports_external.string().trim().min(1).optional()),
-  images: exports_external.array(exports_external.instanceof(File)).readonly()
+  images: exports_external.array(exports_external.instanceof(File)).readonly(),
+  prompt: OptionalPrompt
 });
 var CloudAnswerRequestSchema = exports_external.discriminatedUnion("kind", [MonitorRequestSchema, MeetingRequestSchema]).superRefine((request, context) => {
   if (request.kind === "meeting" && request.text === undefined && request.images.length === 0) {
@@ -19962,9 +19965,15 @@ var DEFAULTS = {
   accessToken: "",
   hideFromCapture: true,
   showTranscript: true,
-  saveTranscript: false
+  monitorPrompt: "",
+  meetingPrompt: ""
 };
-var OBSOLETE_KEYS = ["sessionMode", "hotkeyPreset"];
+var OBSOLETE_KEYS = [
+  "sessionMode",
+  "hotkeyPreset",
+  "saveTranscript",
+  "screenshotDir"
+];
 var RawConfigSchema = exports_external.record(exports_external.string(), exports_external.unknown());
 var HttpUrlSchema = exports_external.url().refine((value) => {
   const protocol = new URL(value).protocol;
@@ -19980,9 +19989,6 @@ function getBlinkHome() {
 function getConfigPath() {
   return path.join(getBlinkHome(), "config.json");
 }
-function expandTilde(filePath) {
-  return filePath.startsWith("~") ? path.join(os.homedir(), filePath.slice(1)) : filePath;
-}
 function parseHttpUrl(value) {
   const parsed = HttpUrlSchema.safeParse(value);
   if (!parsed.success)
@@ -20035,21 +20041,19 @@ function loadConfig() {
       throw new ConfigFileError("accessToken must be a string");
     merged.accessToken = token.data;
   }
-  if (user["screenshotDir"] !== undefined) {
-    const directory = exports_external.string().safeParse(user["screenshotDir"]);
-    if (!directory.success) {
-      throw new ConfigFileError("screenshotDir must be a string");
-    }
-    merged.screenshotDir = expandTilde(directory.data);
-  }
   if (user["hideFromCapture"] !== undefined) {
     merged.hideFromCapture = user["hideFromCapture"] === true;
   }
   if (user["showTranscript"] !== undefined) {
     merged.showTranscript = user["showTranscript"] === true;
   }
-  if (user["saveTranscript"] !== undefined) {
-    merged.saveTranscript = user["saveTranscript"] === true;
+  for (const key of ["monitorPrompt", "meetingPrompt"]) {
+    if (user[key] === undefined)
+      continue;
+    const prompt = exports_external.string().safeParse(user[key]);
+    if (!prompt.success)
+      throw new ConfigFileError(`${key} must be a string`);
+    merged[key] = prompt.data.trim();
   }
   const missing = Object.keys(merged).filter((key) => !(key in persisted));
   if (missing.length > 0 || hadObsolete) {