@vellumai/assistant 0.4.26 → 0.4.30

package/src/daemon/ipc-contract/apps.ts

@@ -1,72 +1,77 @@
 // App management, gallery, publishing, and sharing types.
 
-import type { GalleryManifest } from '../../gallery/gallery-manifest.js';
+import type { GalleryManifest } from "../../gallery/gallery-manifest.js";
 
 // === Client → Server ===
 
 export interface AppDataRequest {
-  type: 'app_data_request';
+  type: "app_data_request";
   surfaceId: string;
   callId: string;
-  method: 'query' | 'create' | 'update' | 'delete';
+  method: "query" | "create" | "update" | "delete";
   appId: string;
   recordId?: string;
   data?: Record<string, unknown>;
 }
 
 export interface AppsListRequest {
-  type: 'apps_list';
+  type: "apps_list";
 }
 
 export interface HomeBaseGetRequest {
-  type: 'home_base_get';
+  type: "home_base_get";
   /** If true, daemon ensures a durable Home Base link exists before responding. */
   ensureLinked?: boolean;
 }
 
 export interface AppOpenRequest {
-  type: 'app_open_request';
+  type: "app_open_request";
   appId: string;
 }
 
 export interface SharedAppsListRequest {
-  type: 'shared_apps_list';
+  type: "shared_apps_list";
+}
+
+export interface AppDeleteRequest {
+  type: "app_delete";
+  appId: string;
 }
 
 export interface SharedAppDeleteRequest {
-  type: 'shared_app_delete';
+  type: "shared_app_delete";
   uuid: string;
 }
 
 export interface ForkSharedAppRequest {
-  type: 'fork_shared_app';
+  type: "fork_shared_app";
   uuid: string;
 }
 
 export interface BundleAppRequest {
-  type: 'bundle_app';
+  type: "bundle_app";
   appId: string;
 }
 
 export interface AppUpdatePreviewRequest {
-  type: 'app_update_preview';
+  type: "app_update_preview";
   appId: string;
   /** Base64-encoded PNG screenshot thumbnail. */
   preview: string;
 }
 
 export interface AppPreviewRequest {
-  type: 'app_preview_request';
+  type: "app_preview_request";
   appId: string;
 }
 
 export interface OpenBundleRequest {
-  type: 'open_bundle';
+  type: "open_bundle";
   filePath: string;
 }
 
 export interface SignBundlePayloadResponse {
-  type: 'sign_bundle_payload_response';
+  type: "sign_bundle_payload_response";
   requestId: string;
   signature?: string;
   keyId?: string;
@@ -75,7 +80,7 @@ export interface SignBundlePayloadResponse {
 }
 
 export interface GetSigningIdentityResponse {
-  type: 'get_signing_identity_response';
+  type: "get_signing_identity_response";
   requestId: string;
   keyId?: string;
   publicKey?: string;
@@ -83,66 +88,66 @@ export interface GetSigningIdentityResponse {
 }
 
 export interface GalleryListRequest {
-  type: 'gallery_list';
+  type: "gallery_list";
 }
 
 export interface GalleryInstallRequest {
-  type: 'gallery_install';
+  type: "gallery_install";
   galleryAppId: string;
 }
 
 export interface AppHistoryRequest {
-  type: 'app_history_request';
+  type: "app_history_request";
   appId: string;
   limit?: number;
 }
 
 export interface AppDiffRequest {
-  type: 'app_diff_request';
+  type: "app_diff_request";
   appId: string;
   fromCommit: string;
   toCommit?: string;
 }
 
 export interface AppFileAtVersionRequest {
-  type: 'app_file_at_version_request';
+  type: "app_file_at_version_request";
   appId: string;
   path: string;
   commitHash: string;
 }
 
 export interface AppRestoreRequest {
-  type: 'app_restore_request';
+  type: "app_restore_request";
   appId: string;
   commitHash: string;
 }
 
 export interface ShareAppCloudRequest {
-  type: 'share_app_cloud';
+  type: "share_app_cloud";
   appId: string;
 }
 
 export interface ShareToSlackRequest {
-  type: 'share_to_slack';
+  type: "share_to_slack";
   appId: string;
 }
 
 export interface PublishPageRequest {
-  type: 'publish_page';
+  type: "publish_page";
   html: string;
   title?: string;
   appId?: string;
 }
 
 export interface UnpublishPageRequest {
-  type: 'unpublish_page';
+  type: "unpublish_page";
   deploymentId: string;
 }
 
 // === Server → Client ===
 
 export interface AppDataResponse {
-  type: 'app_data_response';
+  type: "app_data_response";
   surfaceId: string;
   callId: string;
   success: boolean;
@@ -151,19 +156,19 @@ export interface AppDataResponse {
 }
 
 export interface AppUpdatePreviewResponse {
-  type: 'app_update_preview_response';
+  type: "app_update_preview_response";
   success: boolean;
   appId: string;
 }
 
 export interface AppPreviewResponse {
-  type: 'app_preview_response';
+  type: "app_preview_response";
   appId: string;
   preview?: string;
 }
 
 export interface AppsListResponse {
-  type: 'apps_list_response';
+  type: "apps_list_response";
   apps: Array<{
     id: string;
     name: string;
@@ -173,12 +178,11 @@ export interface AppsListResponse {
     createdAt: number;
     version?: string;
     contentId?: string;
-    appType?: string;
   }>;
 }
 
 export interface HomeBaseGetResponse {
-  type: 'home_base_get_response';
+  type: "home_base_get_response";
   homeBase: {
     appId: string;
     source: string;
@@ -195,7 +199,7 @@ export interface HomeBaseGetResponse {
 }
 
 export interface SharedAppsListResponse {
-  type: 'shared_apps_list_response';
+  type: "shared_apps_list_response";
   apps: Array<{
     uuid: string;
     name: string;
@@ -213,13 +217,18 @@ export interface SharedAppsListResponse {
   }>;
 }
 
+export interface AppDeleteResponse {
+  type: "app_delete_response";
+  success: boolean;
+}
+
 export interface SharedAppDeleteResponse {
-  type: 'shared_app_delete_response';
+  type: "shared_app_delete_response";
   success: boolean;
 }
 
 export interface ForkSharedAppResponse {
-  type: 'fork_shared_app_response';
+  type: "fork_shared_app_response";
   success: boolean;
   appId?: string;
   name?: string;
@@ -227,7 +236,7 @@ export interface ForkSharedAppResponse {
 }
 
 export interface BundleAppResponse {
-  type: 'bundle_app_response';
+  type: "bundle_app_response";
   bundlePath: string;
   manifest: {
     format_version: number;
@@ -244,7 +253,7 @@ export interface BundleAppResponse {
 }
 
 export interface OpenBundleResponse {
-  type: 'open_bundle_response';
+  type: "open_bundle_response";
   manifest: {
     format_version: number;
     name: string;
@@ -261,7 +270,7 @@ export interface OpenBundleResponse {
     warnings: string[];
   };
   signatureResult: {
-    trustTier: 'verified' | 'signed' | 'unsigned' | 'tampered';
+    trustTier: "verified" | "signed" | "unsigned" | "tampered";
     signerKeyId?: string;
     signerDisplayName?: string;
     signerAccount?: string;
@@ -270,18 +279,18 @@ export interface OpenBundleResponse {
 }
 
 export interface SignBundlePayloadRequest {
-  type: 'sign_bundle_payload';
+  type: "sign_bundle_payload";
   requestId: string;
   payload: string;
 }
 
 export interface GetSigningIdentityRequest {
-  type: 'get_signing_identity';
+  type: "get_signing_identity";
   requestId: string;
 }
 
 export interface ShareAppCloudResponse {
-  type: 'share_app_cloud_response';
+  type: "share_app_cloud_response";
   success: boolean;
   shareToken?: string;
   shareUrl?: string;
@@ -289,12 +298,12 @@ export interface ShareAppCloudResponse {
 }
 
 export interface GalleryListResponse {
-  type: 'gallery_list_response';
+  type: "gallery_list_response";
   gallery: GalleryManifest;
 }
 
 export interface GalleryInstallResponse {
-  type: 'gallery_install_response';
+  type: "gallery_install_response";
   success: boolean;
   appId?: string;
   name?: string;
@@ -302,7 +311,7 @@ export interface GalleryInstallResponse {
 }
 
 export interface AppHistoryResponse {
-  type: 'app_history_response';
+  type: "app_history_response";
   appId: string;
   versions: Array<{
     commitHash: string;
@@ -312,32 +321,32 @@ export interface AppHistoryResponse {
 }
 
 export interface AppDiffResponse {
-  type: 'app_diff_response';
+  type: "app_diff_response";
   appId: string;
   diff: string;
 }
 
 export interface AppFileAtVersionResponse {
-  type: 'app_file_at_version_response';
+  type: "app_file_at_version_response";
   appId: string;
   path: string;
   content: string;
 }
 
 export interface AppRestoreResponse {
-  type: 'app_restore_response';
+  type: "app_restore_response";
   success: boolean;
   error?: string;
 }
 
 export interface ShareToSlackResponse {
-  type: 'share_to_slack_response';
+  type: "share_to_slack_response";
   success: boolean;
   error?: string;
 }
 
 export interface PublishPageResponse {
-  type: 'publish_page_response';
+  type: "publish_page_response";
   success: boolean;
   publicUrl?: string;
   deploymentId?: string;
@@ -346,13 +355,13 @@ export interface PublishPageResponse {
 }
 
 export interface UnpublishPageResponse {
-  type: 'unpublish_page_response';
+  type: "unpublish_page_response";
   success: boolean;
   error?: string;
 }
 
 export interface AppFilesChanged {
-  type: 'app_files_changed';
+  type: "app_files_changed";
   appId: string;
 }
 
@@ -364,6 +373,7 @@ export type _AppsClientMessages =
   | HomeBaseGetRequest
   | AppOpenRequest
   | SharedAppsListRequest
+  | AppDeleteRequest
   | SharedAppDeleteRequest
   | ForkSharedAppRequest
   | BundleAppRequest
@@ -388,6 +398,7 @@ export type _AppsServerMessages =
   | AppsListResponse
   | HomeBaseGetResponse
   | SharedAppsListResponse
+  | AppDeleteResponse
   | SharedAppDeleteResponse
   | ForkSharedAppResponse
   | BundleAppResponse

package/src/daemon/ipc-contract/computer-use.ts

@@ -1,26 +1,30 @@
 // Computer use, task routing, ride shotgun, and watch observation types.
 
-import type { CommandIntent, IpcBlobRef,UserMessageAttachment } from './shared.js';
+import type {
+  CommandIntent,
+  IpcBlobRef,
+  UserMessageAttachment,
+} from "./shared.js";
 
 // === Client → Server ===
 
 export interface CuSessionCreate {
-  type: 'cu_session_create';
+  type: "cu_session_create";
   sessionId: string;
   task: string;
   screenWidth: number;
   screenHeight: number;
   attachments?: UserMessageAttachment[];
-  interactionType?: 'computer_use' | 'text_qa';
+  interactionType?: "computer_use" | "text_qa";
 }
 
 export interface CuSessionAbort {
-  type: 'cu_session_abort';
+  type: "cu_session_abort";
   sessionId: string;
 }
 
 export interface CuObservation {
-  type: 'cu_observation';
+  type: "cu_observation";
   sessionId: string;
   axTree?: string;
   axDiff?: string;
@@ -35,7 +39,7 @@ export interface CuObservation {
   /** Screen height in macOS points (`Pt`) used by native execution. */
   screenHeightPt?: number;
   /** Coordinate origin convention used by the observation payload. */
-  coordinateOrigin?: 'top_left';
+  coordinateOrigin?: "top_left";
   /** Display ID used by screenshot capture for this observation. */
   captureDisplayId?: number;
   executionResult?: string;
@@ -47,21 +51,21 @@ export interface CuObservation {
 }
 
 export interface TaskSubmit {
-  type: 'task_submit';
+  type: "task_submit";
   task: string;
   screenWidth: number;
   screenHeight: number;
   attachments?: UserMessageAttachment[];
-  source?: 'voice' | 'text';
+  source?: "voice" | "text";
   /** Structured command intent — bypasses text parsing when present. */
   commandIntent?: CommandIntent;
 }
 
 export interface RideShotgunStart {
-  type: 'ride_shotgun_start';
+  type: "ride_shotgun_start";
   durationSeconds: number;
   intervalSeconds: number;
-  mode?: 'observe' | 'learn';
+  mode?: "observe" | "learn";
   targetDomain?: string;
   /** Domain to auto-navigate (may differ from targetDomain, e.g. open.spotify.com vs spotify.com). */
   navigateDomain?: string;
@@ -69,12 +73,12 @@ export interface RideShotgunStart {
 }
 
 export interface RideShotgunStop {
-  type: 'ride_shotgun_stop';
+  type: "ride_shotgun_stop";
   watchId: string;
 }
 
 export interface WatchObservation {
-  type: 'watch_observation';
+  type: "watch_observation";
   watchId: string;
   sessionId: string;
   ocrText: string;
@@ -90,22 +94,28 @@ export interface WatchObservation {
 
 /** Recording options shared across standalone and CU recording flows. */
 export interface RecordingOptions {
-  captureScope?: 'display' | 'window';
-  displayId?: string;        // CGDirectDisplayID as string
-  windowId?: number;          // CGWindowID
+  captureScope?: "display" | "window";
+  displayId?: string; // CGDirectDisplayID as string
+  windowId?: number; // CGWindowID
   includeAudio?: boolean;
   includeMicrophone?: boolean;
-  promptForSource?: boolean;  // show source picker
+  promptForSource?: boolean; // show source picker
 }
 
 /** Client → Server: recording lifecycle status update. */
 export interface RecordingStatus {
-  type: 'recording_status';
-  sessionId: string;          // matches recordingId from RecordingStart
-  status: 'started' | 'stopped' | 'failed' | 'restart_cancelled' | 'paused' | 'resumed';
-  filePath?: string;          // on stop
-  durationMs?: number;        // on stop
-  error?: string;             // on failure
+  type: "recording_status";
+  sessionId: string; // matches recordingId from RecordingStart
+  status:
+    | "started"
+    | "stopped"
+    | "failed"
+    | "restart_cancelled"
+    | "paused"
+    | "resumed";
+  filePath?: string; // on stop
+  durationMs?: number; // on stop
+  error?: string; // on failure
   attachToConversationId?: string;
   /** Operation token for restart race hardening — matches the token from RecordingStart. */
   operationToken?: string;
@@ -115,8 +125,8 @@ export interface RecordingStatus {
 
 /** Server → Client: start a recording. */
 export interface RecordingStart {
-  type: 'recording_start';
-  recordingId: string;        // daemon-assigned UUID
+  type: "recording_start";
+  recordingId: string; // daemon-assigned UUID
   attachToConversationId?: string;
   options?: RecordingOptions;
   /** Operation token for restart race hardening — stale completions with mismatched tokens are rejected. */
@@ -125,24 +135,24 @@ export interface RecordingStart {
 
 /** Server → Client: stop a recording. */
 export interface RecordingStop {
-  type: 'recording_stop';
-  recordingId: string;        // matches RecordingStart.recordingId
+  type: "recording_stop";
+  recordingId: string; // matches RecordingStart.recordingId
 }
 
 /** Server → Client: pause the active recording. */
 export interface RecordingPause {
-  type: 'recording_pause';
+  type: "recording_pause";
   recordingId: string;
 }
 
 /** Server → Client: resume a paused recording. */
 export interface RecordingResume {
-  type: 'recording_resume';
+  type: "recording_resume";
   recordingId: string;
 }
 
 export interface CuAction {
-  type: 'cu_action';
+  type: "cu_action";
   sessionId: string;
   toolName: string;
   input: Record<string, unknown>;
@@ -151,7 +161,7 @@ export interface CuAction {
 }
 
 export interface CuComplete {
-  type: 'cu_complete';
+  type: "cu_complete";
   sessionId: string;
   summary: string;
   stepCount: number;
@@ -159,15 +169,15 @@ export interface CuComplete {
 }
 
 export interface CuError {
-  type: 'cu_error';
+  type: "cu_error";
   sessionId: string;
   message: string;
 }
 
 export interface TaskRouted {
-  type: 'task_routed';
+  type: "task_routed";
   sessionId: string;
-  interactionType: 'computer_use' | 'text_qa';
+  interactionType: "computer_use" | "text_qa";
   /** The task text passed to the escalated session. */
   task?: string;
   /** Set when a text_qa session escalates to computer_use via computer_use_request_control. */
@@ -175,7 +185,7 @@ export interface TaskRouted {
 }
 
 export interface RideShotgunProgress {
-  type: 'ride_shotgun_progress';
+  type: "ride_shotgun_progress";
   watchId: string;
   message: string;
   networkEntryCount?: number;
@@ -184,7 +194,7 @@ export interface RideShotgunProgress {
 }
 
 export interface RideShotgunResult {
-  type: 'ride_shotgun_result';
+  type: "ride_shotgun_result";
   sessionId: string;
   watchId: string;
   summary: string;
@@ -194,7 +204,7 @@ export interface RideShotgunResult {
 }
 
 export interface WatchStarted {
-  type: 'watch_started';
+  type: "watch_started";
   sessionId: string;
   watchId: string;
   durationSeconds: number;
@@ -202,7 +212,7 @@ export interface WatchStarted {
 }
 
 export interface WatchCompleteRequest {
-  type: 'watch_complete_request';
+  type: "watch_complete_request";
   sessionId: string;
   watchId: string;
 }

package/src/daemon/ipc-contract/contacts.ts

@@ -0,0 +1,69 @@
+// Contact management: list, get, and update channel status.
+
+// === Client → Server ===
+
+export interface ContactsRequest {
+  type: "contacts";
+  action: "list" | "get" | "update_channel";
+  /** Contact ID (get only). */
+  contactId?: string;
+  /** Channel ID (update_channel only). */
+  channelId?: string;
+  /** New status for channel (update_channel only). */
+  status?: "active" | "pending" | "revoked" | "blocked" | "unverified";
+  /** New policy for channel (update_channel only). */
+  policy?: "allow" | "deny" | "escalate";
+  /** Reason for status change (update_channel only). */
+  reason?: string;
+  /** Filter by role (list only). */
+  role?: "guardian" | "contact";
+  /** Limit (list only). */
+  limit?: number;
+}
+
+// === Server → Client ===
+
+export interface ContactsResponse {
+  type: "contacts_response";
+  success: boolean;
+  error?: string;
+  contact?: ContactPayload;
+  contacts?: ContactPayload[];
+}
+
+/** Server push — lightweight invalidation signal: the contacts table has been mutated, refetch your list. */
+export interface ContactsChanged {
+  type: "contacts_changed";
+}
+
+export interface ContactPayload {
+  id: string;
+  displayName: string;
+  role: "guardian" | "contact";
+  relationship?: string;
+  importance: number;
+  lastInteraction?: number;
+  interactionCount: number;
+  channels: ContactChannelPayload[];
+}
+
+export interface ContactChannelPayload {
+  id: string;
+  type: string;
+  address: string;
+  isPrimary: boolean;
+  externalUserId?: string;
+  status: string;
+  policy: string;
+  verifiedAt?: number;
+  verifiedVia?: string;
+  lastSeenAt?: number;
+  revokedReason?: string;
+  blockedReason?: string;
+}
+
+// --- Domain-level union aliases (consumed by the barrel file) ---
+
+export type _ContactsClientMessages = ContactsRequest;
+
+export type _ContactsServerMessages = ContactsResponse | ContactsChanged;