@vellumai/plugin-api 0.11.4-dev.202608201142.dc27263 → 0.11.4-dev.202608201321.78202a0

package/index.d.ts

@@ -2624,6 +2624,12 @@ export declare class AssistantEventHub {
      * matched.
      */
     setClientPresence(clientId: string, state: DesktopPresenceState): boolean;
+    /**
+     * Record the web tab visibility/focused-conversation reported by a client.
+     * `reportedAt` always advances. Returns true when at least one active
+     * client entry matched.
+     */
+    setClientWebPresence(clientId: string, report: WebPresenceReport): boolean;
     /**
      * Force-disconnect a client by disposing all subscribers for the given
      * `clientId`. Returns the number of disposed entries.
@@ -4146,6 +4152,11 @@ declare interface ClientEntry extends BaseSubscriberEntry {
      * In-memory only, so consumers must fail open when it is absent.
      */
     presence?: ClientPresence;
+    /**
+     * Last web tab visibility/focus reported by this client, for clients that
+     * report it. In-memory only, so consumers must fail open when it is absent.
+     */
+    webPresence?: ClientWebPresence;
 }
 
 declare interface ClientPresence {
@@ -4154,6 +4165,11 @@ declare interface ClientPresence {
     reportedAt: Date;
 }
 
+declare interface ClientWebPresence extends WebPresenceReport {
+    /** When the daemon last heard from the client. Drives staleness. */
+    reportedAt: Date;
+}
+
 declare interface CliOptionHelp {
     /** Commander flag spec, e.g. `"--path <file>"` or `"-l, --limit <n>"`. */
     flags: string;
@@ -7722,6 +7738,19 @@ export declare interface WebhookUrlOptions {
     sourceIdentifier?: string;
 }
 
+/**
+ * Web tab visibility and conversation focus, as reported by a `web`-interface
+ * client (a browser tab or the Electron renderer). Distinct from
+ * {@link ClientPresence}: scoped to a single conversation rather than app-wide
+ * attendance, and reported by the shared web renderer rather than the macOS
+ * host-proxy bridge. See `runtime/web-presence.ts` for the read-side policy.
+ */
+declare interface WebPresenceReport {
+    visible: boolean;
+    /** The conversation currently focused (chat composer on screen), or `null`. */
+    focusedConversationId: string | null;
+}
+
 declare interface WebSearchMetadata {
     query: string;
     provider: WebSearchProviderId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.11.4-dev.202608201142.dc27263",
+  "version": "0.11.4-dev.202608201321.78202a0",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",