@wibeco/bridge 0.2.9 → 0.2.12

package/dist/{chunk-6P6IVLMW.js → chunk-7AU52DBJ.js}

@@ -15,18 +15,75 @@ import {
   observeRepositoryTransitions,
   pollDeviceToken,
   requestDeviceAuthorization,
+  resolveLatestPresenceSession,
   startPresenceSession,
   stopPresenceSession,
   updatePresenceSession
-} from "./chunk-DSMXRUNM.js";
+} from "./chunk-JXH47J5I.js";
 
 // src/cli/commands.ts
 import { access, cp, mkdir, readFile, writeFile } from "fs/promises";
 import { homedir, hostname } from "os";
-import { join, resolve } from "path";
+import { basename, join, resolve } from "path";
 import { fileURLToPath } from "url";
 import { execFile } from "child_process";
 var ADAPTERS = ["cursor", "claude-code", "codex"];
+var MAX_SCREENSHOT_BYTES = 5 * 1024 * 1024;
+function screenshotMimeType(bytes) {
+  if ([137, 80, 78, 71, 13, 10, 26, 10].every(
+    (byte, index) => bytes[index] === byte
+  )) {
+    return "image/png";
+  }
+  if (bytes[0] === 255 && bytes[1] === 216 && bytes[2] === 255) {
+    return "image/jpeg";
+  }
+  if (new TextDecoder().decode(bytes.slice(0, 4)) === "RIFF" && new TextDecoder().decode(bytes.slice(8, 12)) === "WEBP") {
+    return "image/webp";
+  }
+  return void 0;
+}
+async function uploadProgressScreenshot(screenshotPath, altText, credential, cwd) {
+  try {
+    const resolvedPath = resolve(cwd, screenshotPath);
+    const bytes = await readFile(resolvedPath);
+    if (!bytes.length || bytes.length > MAX_SCREENSHOT_BYTES) {
+      return {
+        warning: "Screenshot skipped: image must be between 1 byte and 5 MB."
+      };
+    }
+    const mimeType = screenshotMimeType(bytes);
+    if (!mimeType) {
+      return {
+        warning: "Screenshot skipped: only PNG, JPEG, and WebP are supported."
+      };
+    }
+    const form = new FormData();
+    form.set(
+      "screenshot",
+      new Blob([new Uint8Array(bytes)], { type: mimeType }),
+      basename(resolvedPath)
+    );
+    form.set("alt_text", altText);
+    const response = await fetch(`${credential.appUrl}/api/artifacts`, {
+      method: "POST",
+      headers: { authorization: `Bearer ${credential.accessToken}` },
+      body: form,
+      signal: AbortSignal.timeout(1e4)
+    });
+    const body = await response.json().catch(() => ({}));
+    if (!response.ok || typeof body.artifact_id !== "string") {
+      return {
+        warning: `Screenshot skipped: ${typeof body.error === "string" ? body.error : `upload failed with status ${response.status}`}.`
+      };
+    }
+    return { artifactId: body.artifact_id };
+  } catch (error) {
+    return {
+      warning: `Screenshot skipped: ${error instanceof Error ? error.message : "upload failed"}.`
+    };
+  }
+}
 async function setupCommand(requestedAdapter, options = {}) {
   const cwd = options.cwd ?? process.cwd();
   const expectedRepository = options.expectedRepository ? normalizeGitHubRepository(options.expectedRepository) : void 0;
@@ -351,6 +408,10 @@ async function shareProgressCommand(options, cwd = process.cwd()) {
   if (title && title.length > 120) {
     throw new Error("Progress title must be 120 characters or fewer.");
   }
+  const screenshotAlt = options.screenshotAlt?.trim() || (title ? `${title} screenshot` : "Agent update screenshot");
+  if (screenshotAlt.length > 240) {
+    throw new Error("Screenshot alt text must be 240 characters or fewer.");
+  }
   const phases = [
     "planning",
     "implementing",
@@ -366,14 +427,26 @@ async function shareProgressCommand(options, cwd = process.cwd()) {
   }
   const repo = await detectRepository(cwd);
   const workingTree = repo ? await detectWorkingTreeMetrics(repo.root) : void 0;
+  const sessionId = await resolveLatestPresenceSession(
+    projectConfig.adapter,
+    cwd
+  );
+  const screenshot = options.screenshot?.trim() ? await uploadProgressScreenshot(
+    options.screenshot.trim(),
+    screenshotAlt,
+    credential,
+    cwd
+  ) : {};
   const event = createHookEvent({
     source: projectConfig.adapter,
     kind: "progress.shared",
+    ...sessionId ? { sessionId } : {},
     metadata: {
       summary,
       ...title ? { title } : {},
       ...options.phase ? { phase: options.phase } : {},
       ...options.confidence !== void 0 ? { confidence: options.confidence } : {},
+      ...screenshot.artifactId ? { artifact_id: screenshot.artifactId } : {},
       ...workingTree ? {
         paths: workingTree.paths,
         lines_added: workingTree.linesAdded,
@@ -393,7 +466,7 @@ async function shareProgressCommand(options, cwd = process.cwd()) {
   }).capture(event);
   return {
     exitCode: result.error ? 1 : 0,
-    message: result.error ? `Progress was queued; delivery failed: ${result.error}` : `Shared progress with Wibe; ${result.remaining} event(s) queued.`
+    message: result.error ? `Progress was queued; delivery failed: ${result.error}` : `Shared progress with Wibe; ${result.remaining} event(s) queued.${screenshot.warning ? ` ${screenshot.warning}` : ""}`
   };
 }
 async function doctorCommand(cwd = process.cwd(), requestedRepository) {

package/dist/{chunk-DSMXRUNM.js → chunk-JXH47J5I.js}

@@ -389,6 +389,7 @@ function toEnvelope(event, options) {
     paths,
     phase: event.metadata.phase,
     confidence: event.metadata.confidence,
+    artifact_id: typeof event.metadata.artifact_id === "string" ? event.metadata.artifact_id : void 0,
     lines_added: typeof event.metadata.lines_added === "number" ? event.metadata.lines_added : void 0,
     lines_deleted: typeof event.metadata.lines_deleted === "number" ? event.metadata.lines_deleted : void 0
   } : event.kind === "file.changed" ? {
@@ -628,7 +629,7 @@ var JsonFileOfflineQueue = class {
 // src/presence.ts
 import { createHash, randomUUID as randomUUID3 } from "crypto";
 import { spawn } from "child_process";
-import { mkdir as mkdir2, readFile as readFile2, rm, writeFile as writeFile2 } from "fs/promises";
+import { mkdir as mkdir2, readFile as readFile2, readdir, rm, writeFile as writeFile2 } from "fs/promises";
 import { homedir } from "os";
 import { join } from "path";
 var PRESENCE_HEARTBEAT_INTERVAL_MS = 45e3;
@@ -815,6 +816,35 @@ function presenceStatePath(source, sessionId, cwd = process.cwd()) {
   const key = createHash("sha256").update(`${source}\0${sessionId ?? ""}\0${cwd}`).digest("hex");
   return join(presenceDirectory(), `${key}.json`);
 }
+async function resolveLatestPresenceSession(source, cwd = process.cwd(), maxAgeMs = 5 * 6e4) {
+  let names;
+  try {
+    names = await readdir(presenceDirectory());
+  } catch {
+    return void 0;
+  }
+  const now = Date.now();
+  let latest;
+  for (const name of names) {
+    if (!name.endsWith(".json")) continue;
+    const path = join(presenceDirectory(), name);
+    const state = await readPresenceState(path);
+    if (!state?.sessionId || state.source !== source || path !== presenceStatePath(source, state.sessionId, cwd)) {
+      continue;
+    }
+    const lastActivity = Date.parse(state.lastActivityAt);
+    if (!Number.isFinite(lastActivity) || lastActivity > now + 6e4 || now - lastActivity > maxAgeMs) {
+      continue;
+    }
+    if (!latest || state.lastActivityAt > latest.lastActivityAt) {
+      latest = {
+        sessionId: state.sessionId,
+        lastActivityAt: state.lastActivityAt
+      };
+    }
+  }
+  return latest?.sessionId;
+}
 function presenceDirectory() {
   return process.env.WIBE_PRESENCE_DIR ?? join(homedir(), ".wibe", "presence");
 }
@@ -1417,6 +1447,7 @@ export {
   stopPresenceSession,
   runPresenceHeartbeat,
   presenceStatePath,
+  resolveLatestPresenceSession,
   classifyHeadTransition,
   isObservedPush,
   detectRepository,

package/dist/cli.js

@@ -6,10 +6,10 @@ import {
   setupCommand,
   shareProgressCommand,
   statusCommand
-} from "./chunk-6P6IVLMW.js";
+} from "./chunk-7AU52DBJ.js";
 import {
   runPresenceHeartbeat
-} from "./chunk-DSMXRUNM.js";
+} from "./chunk-JXH47J5I.js";
 
 // src/cli.ts
 var HELP = `wibe-bridge <command>
@@ -21,7 +21,7 @@ Commands:
         Use --reauthorize only to replace a rejected or revoked device token.
   status
   emit --adapter <name> --event <hook-name>  (JSON payload on stdin)
-  share-progress --summary <20-55 words> [--title <title>] [--phase <phase>] [--confidence <0-1>]
+  share-progress --summary <20-55 words> [--title <title>] [--phase <phase>] [--confidence <0-1>] [--screenshot <path>] [--screenshot-alt <text>]
   doctor [--repository <owner/repo>]`;
 async function main() {
   const [command, ...args] = process.argv.slice(2);
@@ -54,7 +54,9 @@ async function main() {
       summary: option(args, "--summary"),
       title: option(args, "--title"),
       phase: option(args, "--phase"),
-      confidence: confidence === void 0 ? void 0 : Number(confidence)
+      confidence: confidence === void 0 ? void 0 : Number(confidence),
+      screenshot: option(args, "--screenshot"),
+      screenshotAlt: option(args, "--screenshot-alt")
     });
   } else if (command === "_presence-heartbeat") {
     parseAdapter(option(args, "--adapter"));

package/dist/codex-hook.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   emitCommand
-} from "./chunk-6P6IVLMW.js";
-import "./chunk-DSMXRUNM.js";
+} from "./chunk-7AU52DBJ.js";
+import "./chunk-JXH47J5I.js";
 
 // src/codex-hook.ts
 async function main() {

package/dist/index.d.ts

@@ -304,6 +304,7 @@ declare function updatePresenceSession(source: AgentSource, sessionId: string |
 declare function stopPresenceSession(source: AgentSource, sessionId: string | undefined, cwd?: string): Promise<PresenceMetrics | undefined>;
 declare function runPresenceHeartbeat(statePath: string, expectedInstanceId: string, emit: (source: AgentSource, eventName: string, payload: Record<string, unknown>) => Promise<unknown>, intervalMs?: number): Promise<void>;
 declare function presenceStatePath(source: AgentSource, sessionId: string | undefined, cwd?: string): string;
+declare function resolveLatestPresenceSession(source: AgentSource, cwd?: string, maxAgeMs?: number): Promise<string | undefined>;
 
 interface RedactionOptions {
     allowContent?: boolean;
@@ -345,4 +346,4 @@ declare function sanitizeRemote(remote: string): string;
 declare function normalizeGitHubRepository(value: string): string | undefined;
 declare function matchesGitHubRepository(remote: string | undefined, expected: string): boolean;
 
-export { type AgentSource, type CanonicalHookEvent, type CredentialStore, type DeviceAuthorization, type DeviceTokenResponse, type FlushResult, type HookEventKind, JsonFileOfflineQueue, MemoryOfflineQueue, type OfflineQueue, PRESENCE_HEARTBEAT_INTERVAL_MS, type PresenceMetrics, type RedactionOptions, type RepositoryInfo, type RepositoryTransition, type SafeValue, SignedBatchClient, type SignedBatchClientOptions, type StoredCredential, SystemCredentialStore, type WorkingTreeMetrics, agentSourceSchema, canonicalHookEventSchema, classifyHeadTransition, createHookEvent, detectRepository, detectWorkingTreeMetrics, deviceAuthorizationSchema, deviceTokenResponseSchema, eventTypeForHook, hookEventKindSchema, isObservedPush, mapClaudeCodeHook, mapCodexHook, mapCursorHook, matchesGitHubRepository, normalizeGitHubRepository, observeRepositoryTransitions, pollDeviceToken, presenceStatePath, redact, requestDeviceAuthorization, runPresenceHeartbeat, safeMetadata, safeValueSchema, sanitizeRemote, startPresenceSession, stopPresenceSession, updatePresenceSession };
+export { type AgentSource, type CanonicalHookEvent, type CredentialStore, type DeviceAuthorization, type DeviceTokenResponse, type FlushResult, type HookEventKind, JsonFileOfflineQueue, MemoryOfflineQueue, type OfflineQueue, PRESENCE_HEARTBEAT_INTERVAL_MS, type PresenceMetrics, type RedactionOptions, type RepositoryInfo, type RepositoryTransition, type SafeValue, SignedBatchClient, type SignedBatchClientOptions, type StoredCredential, SystemCredentialStore, type WorkingTreeMetrics, agentSourceSchema, canonicalHookEventSchema, classifyHeadTransition, createHookEvent, detectRepository, detectWorkingTreeMetrics, deviceAuthorizationSchema, deviceTokenResponseSchema, eventTypeForHook, hookEventKindSchema, isObservedPush, mapClaudeCodeHook, mapCodexHook, mapCursorHook, matchesGitHubRepository, normalizeGitHubRepository, observeRepositoryTransitions, pollDeviceToken, presenceStatePath, redact, requestDeviceAuthorization, resolveLatestPresenceSession, runPresenceHeartbeat, safeMetadata, safeValueSchema, sanitizeRemote, startPresenceSession, stopPresenceSession, updatePresenceSession };

package/dist/index.js

@@ -25,6 +25,7 @@ import {
   presenceStatePath,
   redact,
   requestDeviceAuthorization,
+  resolveLatestPresenceSession,
   runPresenceHeartbeat,
   safeMetadata,
   safeValueSchema,
@@ -32,7 +33,7 @@ import {
   startPresenceSession,
   stopPresenceSession,
   updatePresenceSession
-} from "./chunk-DSMXRUNM.js";
+} from "./chunk-JXH47J5I.js";
 export {
   JsonFileOfflineQueue,
   MemoryOfflineQueue,
@@ -60,6 +61,7 @@ export {
   presenceStatePath,
   redact,
   requestDeviceAuthorization,
+  resolveLatestPresenceSession,
   runPresenceHeartbeat,
   safeMetadata,
   safeValueSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wibeco/bridge",
-  "version": "0.2.9",
+  "version": "0.2.12",
   "description": "Privacy-first live activity bridge for Cursor, Claude Code, and Codex.",
   "repository": {
     "type": "git",

package/templates/cursor/wibe-activity.mdc.example

@@ -7,7 +7,10 @@ alwaysApply: true
 
 - This repository is connected to Wibe project `${WIBE_PROJECT_ID}`.
 - For most tasks, publish one update only after the requested outcome is complete. Do not publish plans, routine progress, or separate updates for editing, testing, committing, or pushing.
-- Use `wibe_share_progress` with phase `shipped` at completion. Publish earlier only with phase `blocked` when a material blocker leaves the task unfinished.
+- For text-only outcomes, use `wibe_share_progress` with phase `shipped` at completion. Publish earlier only with phase `blocked` when a material blocker leaves the task unfinished.
 - Write one self-contained paragraph of 20–55 words in past tense. Lead with what now works, then explain the user or team impact and meaningful validation. Mention important limitations when present.
 - Describe the outcome, not the agent’s process. Never include first-person narration, prompts, source code, secrets, raw commands, routine tool calls, filenames, line counts, praise, hype, or speculation; Wibe displays code and file changes separately.
+- Bias frontend outcomes toward visual evidence without asking for per-task approval. For UI components, pages, styling, responsive behavior, interactions, and visual fixes, attach one screenshot when the app or preview is already runnable. Prefer a screenshot already made during visual QA; otherwise capture the clearest final state.
+- Skip screenshots for backend, infrastructure, documentation, refactors, and non-visual frontend logic. Never launch or repair an app solely for Wibe, and omit the image when navigation needs manual authentication, the state contains sensitive data, visual validation is blocked, or the project has visual updates disabled.
+- When a screenshot is available, do not call `wibe_share_progress`. Instead run `npx --yes --package @wibeco/bridge@latest wibe share-progress --summary "<summary>" --phase <shipped|blocked> --screenshot "<path>"` so the local bridge uploads the image and publishes the outcome together.
 - If the Wibe MCP tool is unavailable, run `npx --yes --package @wibeco/bridge@latest wibe share-progress --summary "<summary>" --phase <shipped|blocked>`.