@vellumai/assistant 0.6.2 → 0.6.4

package/src/daemon/message-types/host-browser.ts

@@ -0,0 +1,100 @@
+// Host browser proxy types.
+// Enables proxying CDP commands to the desktop client (host machine)
+// when running as a managed assistant.
+
+// === Server → Client ===
+
+export interface HostBrowserRequest {
+  type: "host_browser_request";
+  requestId: string;
+  conversationId: string;
+  /** CDP method name, e.g. "Page.navigate", "Runtime.evaluate", "Accessibility.getFullAXTree". */
+  cdpMethod: string;
+  /** Opaque JSON params object forwarded verbatim to CDP. */
+  cdpParams?: Record<string, unknown>;
+  /** Optional CDP target/session ID; omitted = "most-recently-active tab". */
+  cdpSessionId?: string;
+  /** Client-side timeout hint; defaults to 30s in the proxy. */
+  timeout_seconds?: number;
+}
+
+export interface HostBrowserCancelRequest {
+  type: "host_browser_cancel";
+  requestId: string;
+}
+
+// === Client → Server ===
+
+/**
+ * Unsolicited CDP event forwarded from the chrome extension to the
+ * runtime. The extension subscribes to `chrome.debugger.onEvent` and
+ * pushes each event here so the runtime can observe lifecycle signals
+ * (e.g. `Target.targetDestroyed`, `Page.frameNavigated`,
+ * `Network.requestWillBeSent`) without having to round-trip a CDP
+ * command. Events are routed through the relay WebSocket using the
+ * same envelope vocabulary as `host_browser_result`.
+ *
+ * The envelope is transport-level only — the runtime dispatcher in
+ * `resolveHostBrowserEvent` fans out into a module-level event bus
+ * that tool-side consumers (currently just the
+ * BrowserSessionRegistry) subscribe to by method name. No request/
+ * response contract is implied; events can arrive at any time while
+ * a chrome extension is attached and there is no ordering guarantee
+ * relative to `host_browser_result` frames.
+ */
+export interface HostBrowserEvent {
+  type: "host_browser_event";
+  /** CDP event method name, e.g. "Page.frameNavigated", "Target.targetDestroyed". */
+  method: string;
+  /** CDP event params forwarded verbatim. Opaque to the runtime. */
+  params?: unknown;
+  /**
+   * Optional CDP session id — populated for flat child sessions
+   * routed through `Target.attachToTarget` with `flatten: true`.
+   * Matches the `source.sessionId` field surfaced by Chrome 125+ in
+   * its `chrome.debugger.onEvent` callback.
+   */
+  cdpSessionId?: string;
+}
+
+/**
+ * Notification that the chrome extension has lost its debugger
+ * attachment to a target (tab closed, user clicked Cancel on the
+ * infobar, navigation across origins, another debugger took over
+ * via `Target.attachToTarget`, or the extension itself tore the
+ * session down on worker shutdown).
+ *
+ * The runtime dispatcher evicts any in-memory session state that
+ * references the invalidated target so the next CDP command from a
+ * tool force a fresh attach on the extension side. The extension's
+ * `host-browser-dispatcher` clears its local attach cache in the
+ * same way — the two signals are symmetric and together make
+ * reattach deterministic across the round-trip.
+ */
+export interface HostBrowserSessionInvalidated {
+  type: "host_browser_session_invalidated";
+  /**
+   * Opaque target identifier. When the extension detached from a
+   * top-level tab target, this is the tab's id as a string. For a
+   * flat child session it is the CDP sessionId. Matches the shape
+   * used on the `cdpSessionId` field of outbound
+   * `host_browser_request` frames so runtime-side session lookups
+   * can use either field interchangeably.
+   */
+  targetId?: string;
+  /**
+   * Free-form human-readable reason surfaced by Chrome via
+   * `chrome.debugger.onDetach`. Used only for logging.
+   */
+  reason?: string;
+}
+
+// --- Domain-level union aliases (consumed by the barrel file) ---
+
+export type _HostBrowserServerMessages =
+  | HostBrowserRequest
+  | HostBrowserCancelRequest;
+
+export type _HostBrowserClientMessages =
+  | HostBrowserEvent
+  | HostBrowserSessionInvalidated;

package/src/daemon/message-types/meet.ts

@@ -0,0 +1,143 @@
+/**
+ * Meet — server → client push messages for live meeting state.
+ *
+ * Emitted by the assistant daemon as the Meet-bot progresses through its
+ * lifecycle (joining → joined → left) and as in-meeting state changes
+ * (participants, active speaker, transcript chunks).
+ *
+ * Keep payloads small and client-actionable: these events power the
+ * macOS "In meeting" status panel and the conversation bridge's live
+ * transcript feed. A client that missed an event can always refetch
+ * authoritative state from the daemon's HTTP routes.
+ */
+
+/** A single participant in a meeting. Shape mirrors the wire-level type. */
+export interface MeetParticipant {
+  /** Stable participant identifier (provider-specific). */
+  id: string;
+  /** Display name of the participant. */
+  name: string;
+  /** Whether the participant is the meeting host. */
+  isHost?: boolean;
+  /** Whether the participant is the bot itself. */
+  isSelf?: boolean;
+}
+
+/** The bot has started attempting to join a meeting. */
+export interface MeetJoining {
+  type: "meet.joining";
+  meetingId: string;
+  /** The Meet URL the bot was asked to join. */
+  url: string;
+}
+
+/** The bot has successfully joined and is live in the meeting. */
+export interface MeetJoined {
+  type: "meet.joined";
+  meetingId: string;
+}
+
+/** Participants joined and/or left the meeting since the last snapshot. */
+export interface MeetParticipantChanged {
+  type: "meet.participant_changed";
+  meetingId: string;
+  /** Participants who joined since the last snapshot. */
+  joined: MeetParticipant[];
+  /** Participants who left since the last snapshot. */
+  left: MeetParticipant[];
+}
+
+/** The active speaker in the meeting changed. */
+export interface MeetSpeakerChanged {
+  type: "meet.speaker_changed";
+  meetingId: string;
+  /** Stable speaker identifier for the new active speaker. */
+  speakerId: string;
+  /** Display name of the new active speaker. */
+  speakerName: string;
+}
+
+/**
+ * A finalized chunk of transcribed speech. Interim chunks are filtered
+ * out before publication so clients only render stable text.
+ */
+export interface MeetTranscriptChunk {
+  type: "meet.transcript_chunk";
+  meetingId: string;
+  /** The transcribed text. */
+  text: string;
+  /** Human-readable speaker label, if the ASR provided one. */
+  speakerLabel?: string;
+  /** Stable speaker identifier across the meeting, if available. */
+  speakerId?: string;
+  /** ASR confidence in [0, 1], if available. */
+  confidence?: number;
+}
+
+/** The bot has left the meeting. */
+export interface MeetLeft {
+  type: "meet.left";
+  meetingId: string;
+  /** Free-form reason passed to `leave()` (e.g. "user-requested", "timeout"). */
+  reason: string;
+}
+
+/**
+ * The assistant successfully posted a chat message into the meeting via
+ * the bot's `/send_chat` endpoint. Emitted once per successful send so
+ * SSE-subscribed clients can render the outbound chat without waiting for
+ * the bot to echo it back through the transcript/chat stream.
+ */
+export interface MeetChatSent {
+  type: "meet.chat_sent";
+  meetingId: string;
+  /** The text that was posted into the meeting's chat. */
+  text: string;
+}
+
+/** The bot hit a non-recoverable error (container crash, join failure, etc.). */
+export interface MeetError {
+  type: "meet.error";
+  meetingId: string;
+  /** Human-readable error detail. */
+  detail: string;
+}
+
+/**
+ * The assistant has begun speaking into the meeting via the TTS bridge. Fired
+ * once per {@link MeetSessionManager.speak} invocation immediately before the
+ * synthesis stream starts flowing to the bot's `/play_audio` endpoint. Useful
+ * for clients that want to render a "speaking …" indicator.
+ */
+export interface MeetSpeakingStarted {
+  type: "meet.speaking_started";
+  meetingId: string;
+  /** Opaque stream identifier — matches `meet.speaking_ended.streamId`. */
+  streamId: string;
+}
+
+/**
+ * The assistant has finished (or cancelled) a TTS playback stream. Fired
+ * after the bot-side playback request settles — whether normally, via an
+ * explicit cancel, or due to an upstream error.
+ */
+export interface MeetSpeakingEnded {
+  type: "meet.speaking_ended";
+  meetingId: string;
+  /** Opaque stream identifier — matches `meet.speaking_started.streamId`. */
+  streamId: string;
+  /** Why the stream ended: natural completion, caller-initiated cancel, or an upstream error. */
+  reason: "completed" | "cancelled" | "error";
+}
+
+export type _MeetServerMessages =
+  | MeetJoining
+  | MeetJoined
+  | MeetParticipantChanged
+  | MeetSpeakerChanged
+  | MeetTranscriptChunk
+  | MeetLeft
+  | MeetChatSent
+  | MeetError
+  | MeetSpeakingStarted
+  | MeetSpeakingEnded;

package/src/daemon/message-types/messages.ts

@@ -60,6 +60,13 @@ export interface UserMessageEcho {
   type: "user_message_echo";
   text: string;
   conversationId?: string;
+  /** Database ID of the persisted user message, used by the originating
+   *  client to dedupe its optimistic row. Absent for synthetic echoes
+   *  (e.g. surface-action prompts) where no distinct user row is persisted. */
+  messageId?: string;
+  /** Server-generated request ID for the send. Allows correlation with
+   *  `message_queued` / `message_dequeued` events for the same turn. */
+  requestId?: string;
 }
 
 export interface AssistantTextDelta {
@@ -194,6 +201,13 @@ export interface MessageComplete {
   attachmentWarnings?: string[];
   /** Database ID of the persisted assistant message, if any. */
   messageId?: string;
+  /**
+   * Distinguishes a real main-turn completion from auxiliary events such as
+   * call transcripts, call summaries, and watch notifier outputs. Clients
+   * gate turn-completion side effects (e.g. the task_complete sound) on
+   * `source !== "aux"`. Absent is treated as main for backwards compatibility.
+   */
+  source?: "main" | "aux";
 }
 
 export interface ErrorMessage {
@@ -307,10 +321,10 @@ export interface AssistantActivityState {
   statusText?: string;
 }
 
-/** Broadcast to clients when the two-axis permission mode changes. */
-export interface PermissionModeUpdate {
-  type: "permission_mode_update";
-  askBeforeActing: boolean;
+/** Broadcast to clients when a conversation's host-access setting changes. */
+export interface ConversationHostAccessUpdated {
+  type: "conversation_host_access_updated";
+  conversationId: string;
   hostAccess: boolean;
 }
 
@@ -376,4 +390,4 @@ export type _MessagesServerMessages =
   | TraceEvent
   | ConfirmationStateChanged
   | AssistantActivityState
-  | PermissionModeUpdate;
+  | ConversationHostAccessUpdated;

package/src/daemon/message-types/schedules.ts

@@ -54,6 +54,15 @@ export interface HeartbeatChecklistWrite {
   content: string;
 }
 
+export interface FilingConfig {
+  type: "filing_config";
+  action: "get";
+}
+
+export interface FilingRunNow {
+  type: "filing_run_now";
+}
+
 // === Server → Client ===
 
 export interface SchedulesListResponse {
@@ -133,6 +142,25 @@ export interface HeartbeatChecklistWriteResponse {
   error?: string;
 }
 
+export interface FilingConfigResponse {
+  type: "filing_config_response";
+  enabled: boolean;
+  intervalMs: number;
+  activeHoursStart: number | null;
+  activeHoursEnd: number | null;
+  nextRunAt: number | null;
+  lastRunAt: number | null;
+  success: boolean;
+  error?: string;
+}
+
+export interface FilingRunNowResponse {
+  type: "filing_run_now_response";
+  success: boolean;
+  ran: boolean;
+  error?: string;
+}
+
 // --- Domain-level union aliases (consumed by the barrel file) ---
 
 export type _SchedulesClientMessages =
@@ -145,7 +173,9 @@ export type _SchedulesClientMessages =
   | HeartbeatRunsList
   | HeartbeatRunNow
   | HeartbeatChecklistRead
-  | HeartbeatChecklistWrite;
+  | HeartbeatChecklistWrite
+  | FilingConfig
+  | FilingRunNow;
 
 export type _SchedulesServerMessages =
   | SchedulesListResponse
@@ -155,4 +185,6 @@ export type _SchedulesServerMessages =
   | HeartbeatRunsListResponse
   | HeartbeatRunNowResponse
   | HeartbeatChecklistResponse
-  | HeartbeatChecklistWriteResponse;
+  | HeartbeatChecklistWriteResponse
+  | FilingConfigResponse
+  | FilingRunNowResponse;

package/src/daemon/message-types/skills.ts

@@ -1,5 +1,10 @@
 // Skill management types.
 
+import type { PartnerAudit } from "../../skills/skillssh-registry.js";
+
+// Re-export so consumers can access the audit types from this module.
+export type { PartnerAudit } from "../../skills/skillssh-registry.js";
+
 // === Client → Server ===
 
 export interface SkillsListRequest {
@@ -98,6 +103,7 @@ interface ClawhubSlimSkill extends SlimSkillBase {
   installs: number;
   reports: number;
   publishedAt?: string;
+  version: string;
 }
 
 interface SkillsshSlimSkill extends SlimSkillBase {
@@ -105,6 +111,7 @@ interface SkillsshSlimSkill extends SlimSkillBase {
   slug: string;
   sourceRepo: string;
   installs: number;
+  audit?: Record<string, PartnerAudit>;
 }
 
 interface CustomSlimSkill extends SlimSkillBase {
@@ -122,6 +129,13 @@ export interface SkillsListResponse {
   skills: SlimSkillResponse[];
 }
 
+export interface SkillsListFilteredResponse {
+  type: "skills_list_response";
+  skills: SlimSkillResponse[];
+  categoryCounts: Record<string, number>;
+  totalCount: number;
+}
+
 export interface SkillStateChanged {
   type: "skills_state_changed";
   name: string;
@@ -159,6 +173,7 @@ interface ClawhubSkillDetail extends SkillDetailBase {
   installs: number;
   reports: number;
   publishedAt?: string;
+  version: string;
   // Enrichment fields (from clawhubInspect):
   owner?: { handle: string; displayName: string; image?: string } | null;
   stats?: {
@@ -177,6 +192,7 @@ interface SkillsshSkillDetail extends SkillDetailBase {
   slug: string;
   sourceRepo: string;
   installs: number;
+  audit?: Record<string, PartnerAudit>;
 }
 
 interface CustomSkillDetail extends SkillDetailBase {
@@ -189,6 +205,16 @@ export type SkillDetailResponse =
   | SkillsshSkillDetail
   | CustomSkillDetail;
 
+// ─── Single-file content response (HTTP API) ─────────────────────────────
+export interface SkillFileContentResponse {
+  path: string;
+  name: string;
+  size: number;
+  mimeType: string;
+  isBinary: boolean;
+  content: string | null;
+}
+
 export interface SkillsDraftResponse {
   type: "skills_draft_response";
   success: boolean;

package/src/daemon/message-types/subagents.ts

@@ -10,6 +10,7 @@ export interface SubagentSpawned {
   parentConversationId: string;
   label: string;
   objective: string;
+  isFork?: boolean;
 }
 
 export interface SubagentStatusChanged {
@@ -29,6 +30,7 @@ export interface SubagentDetailResponse {
     content: string;
     toolName?: string;
     isError?: boolean;
+    messageId?: string;
   }>;
 }
 

package/src/daemon/message-types/surfaces.ts

@@ -184,6 +184,8 @@ interface UiSurfaceShowBase {
   display?: "inline" | "panel";
   /** The message ID that this surface belongs to (for history loading). */
   messageId?: string;
+  /** When `true`, clicking an action does not dismiss the surface — the client keeps the card visible and only marks the clicked `actionId` as spent so siblings remain clickable. */
+  persistent?: boolean;
 }
 
 export interface UiSurfaceShowCard extends UiSurfaceShowBase {