@vellumai/assistant 0.3.0

package/src/daemon/ipc-contract-inventory.json

@@ -0,0 +1,495 @@
+{
+  "clientMessageTypes": [
+    "AcceptStarterBundle",
+    "AddTrustRule",
+    "AppDataRequest",
+    "AppDiffRequest",
+    "AppFileAtVersionRequest",
+    "AppHistoryRequest",
+    "AppOpenRequest",
+    "AppPreviewRequest",
+    "AppRestoreRequest",
+    "AppUpdatePreviewRequest",
+    "AppsListRequest",
+    "AuthMessage",
+    "BrowserCDPResponse",
+    "BrowserInteractiveMode",
+    "BrowserUserClick",
+    "BrowserUserKeypress",
+    "BrowserUserScroll",
+    "BundleAppRequest",
+    "CancelRequest",
+    "ConfirmationResponse",
+    "CuObservation",
+    "CuSessionAbort",
+    "CuSessionCreate",
+    "DeleteQueuedMessage",
+    "DiagnosticsExportRequest",
+    "DocumentListRequest",
+    "DocumentLoadRequest",
+    "DocumentSaveRequest",
+    "EnvVarsRequest",
+    "ForkSharedAppRequest",
+    "GalleryInstallRequest",
+    "GalleryListRequest",
+    "GetSigningIdentityResponse",
+    "GuardianVerificationRequest",
+    "HistoryRequest",
+    "HomeBaseGetRequest",
+    "IdentityGetRequest",
+    "ImageGenModelSetRequest",
+    "IngressConfigRequest",
+    "IntegrationConnectRequest",
+    "IntegrationDisconnectRequest",
+    "IntegrationListRequest",
+    "IpcBlobProbe",
+    "LinkOpenRequest",
+    "ModelGetRequest",
+    "ModelSetRequest",
+    "OpenBundleRequest",
+    "PingMessage",
+    "PublishPageRequest",
+    "RegenerateRequest",
+    "ReminderCancel",
+    "RemindersList",
+    "RemoveTrustRule",
+    "RideShotgunStart",
+    "RideShotgunStop",
+    "SandboxSetRequest",
+    "ScheduleRemove",
+    "ScheduleToggle",
+    "SchedulesList",
+    "SecretResponse",
+    "SessionCreateRequest",
+    "SessionListRequest",
+    "SessionSwitchRequest",
+    "SessionsClearRequest",
+    "ShareAppCloudRequest",
+    "ShareToSlackRequest",
+    "SharedAppDeleteRequest",
+    "SharedAppsListRequest",
+    "SignBundlePayloadResponse",
+    "SkillDetailRequest",
+    "SkillsCheckUpdatesRequest",
+    "SkillsConfigureRequest",
+    "SkillsDisableRequest",
+    "SkillsEnableRequest",
+    "SkillsInspectRequest",
+    "SkillsInstallRequest",
+    "SkillsListRequest",
+    "SkillsSearchRequest",
+    "SkillsUninstallRequest",
+    "SkillsUpdateRequest",
+    "SlackWebhookConfigRequest",
+    "SubagentAbortRequest",
+    "SubagentDetailRequest",
+    "SubagentMessageRequest",
+    "SubagentStatusRequest",
+    "SuggestionRequest",
+    "TaskSubmit",
+    "TelegramConfigRequest",
+    "ToolNamesListRequest",
+    "ToolPermissionSimulateRequest",
+    "TrustRulesList",
+    "TwitterAuthStartRequest",
+    "TwitterAuthStatusRequest",
+    "TwitterIntegrationConfigRequest",
+    "UiSurfaceAction",
+    "UiSurfaceUndoRequest",
+    "UndoRequest",
+    "UnpublishPageRequest",
+    "UpdateTrustRule",
+    "UsageRequest",
+    "UserMessage",
+    "VercelApiConfigRequest",
+    "WatchObservation",
+    "WorkItemApprovePermissionsRequest",
+    "WorkItemCancelRequest",
+    "WorkItemCompleteRequest",
+    "WorkItemDeleteRequest",
+    "WorkItemGetRequest",
+    "WorkItemOutputRequest",
+    "WorkItemPreflightRequest",
+    "WorkItemRunTaskRequest",
+    "WorkItemUpdateRequest",
+    "WorkItemsListRequest",
+    "WorkspaceFileReadRequest",
+    "WorkspaceFilesListRequest"
+  ],
+  "serverMessageTypes": [
+    "AcceptStarterBundleResponse",
+    "AgentHeartbeatAlert",
+    "AppDataResponse",
+    "AppDiffResponse",
+    "AppFileAtVersionResponse",
+    "AppFilesChanged",
+    "AppHistoryResponse",
+    "AppPreviewResponse",
+    "AppRestoreResponse",
+    "AppUpdatePreviewResponse",
+    "AppsListResponse",
+    "AssistantTextDelta",
+    "AssistantThinkingDelta",
+    "AuthResult",
+    "BrowserCDPRequest",
+    "BrowserFrame",
+    "BrowserHandoffRequest",
+    "BrowserInteractiveModeChanged",
+    "BundleAppResponse",
+    "ConfirmationRequest",
+    "ContextCompacted",
+    "CuAction",
+    "CuComplete",
+    "CuError",
+    "DaemonStatusMessage",
+    "DiagnosticsExportResponse",
+    "DocumentEditorShow",
+    "DocumentEditorUpdate",
+    "DocumentListResponse",
+    "DocumentLoadResponse",
+    "DocumentSaveResponse",
+    "EnvVarsResponse",
+    "ErrorMessage",
+    "ForkSharedAppResponse",
+    "GalleryInstallResponse",
+    "GalleryListResponse",
+    "GenerationCancelled",
+    "GenerationHandoff",
+    "GetSigningIdentityRequest",
+    "GuardianVerificationResponse",
+    "HistoryResponse",
+    "HomeBaseGetResponse",
+    "IdentityGetResponse",
+    "IngressConfigResponse",
+    "IntegrationConnectResult",
+    "IntegrationListResponse",
+    "IpcBlobProbeResult",
+    "MemoryRecalled",
+    "MemoryStatus",
+    "MessageComplete",
+    "MessageDequeued",
+    "MessageQueued",
+    "MessageQueuedDeleted",
+    "ModelInfo",
+    "OpenBundleResponse",
+    "OpenTasksWindow",
+    "OpenUrl",
+    "PongMessage",
+    "PublishPageResponse",
+    "ReminderFired",
+    "RemindersListResponse",
+    "RideShotgunResult",
+    "ScheduleComplete",
+    "SchedulesListResponse",
+    "SecretDetected",
+    "SecretRequest",
+    "SessionErrorMessage",
+    "SessionInfo",
+    "SessionListResponse",
+    "SessionsClearResponse",
+    "ShareAppCloudResponse",
+    "ShareToSlackResponse",
+    "SharedAppDeleteResponse",
+    "SharedAppsListResponse",
+    "SignBundlePayloadRequest",
+    "SkillDetailResponse",
+    "SkillStateChanged",
+    "SkillsInspectResponse",
+    "SkillsListResponse",
+    "SkillsOperationResponse",
+    "SlackWebhookConfigResponse",
+    "SubagentDetailResponse",
+    "SubagentEvent",
+    "SubagentSpawned",
+    "SubagentStatusChanged",
+    "SuggestionResponse",
+    "TaskRouted",
+    "TaskRunThreadCreated",
+    "TasksChanged",
+    "TelegramConfigResponse",
+    "ToolInputDelta",
+    "ToolNamesListResponse",
+    "ToolOutputChunk",
+    "ToolPermissionSimulateResponse",
+    "ToolResult",
+    "ToolUseStart",
+    "TraceEvent",
+    "TrustRulesListResponse",
+    "TwitterAuthResult",
+    "TwitterAuthStatusResponse",
+    "TwitterIntegrationConfigResponse",
+    "UiSurfaceComplete",
+    "UiSurfaceDismiss",
+    "UiSurfaceShow",
+    "UiSurfaceUndoResult",
+    "UiSurfaceUpdate",
+    "UndoComplete",
+    "UnpublishPageResponse",
+    "UsageResponse",
+    "UsageUpdate",
+    "UserMessageEcho",
+    "VercelApiConfigResponse",
+    "WatchCompleteRequest",
+    "WatchStarted",
+    "WatcherEscalation",
+    "WatcherNotification",
+    "WorkItemApprovePermissionsResponse",
+    "WorkItemCancelResponse",
+    "WorkItemDeleteResponse",
+    "WorkItemGetResponse",
+    "WorkItemOutputResponse",
+    "WorkItemPreflightResponse",
+    "WorkItemRunTaskResponse",
+    "WorkItemStatusChanged",
+    "WorkItemUpdateResponse",
+    "WorkItemsListResponse",
+    "WorkspaceFileReadResponse",
+    "WorkspaceFilesListResponse"
+  ],
+  "clientWireTypes": [
+    "accept_starter_bundle",
+    "add_trust_rule",
+    "app_data_request",
+    "app_diff_request",
+    "app_file_at_version_request",
+    "app_history_request",
+    "app_open_request",
+    "app_preview_request",
+    "app_restore_request",
+    "app_update_preview",
+    "apps_list",
+    "auth",
+    "browser_cdp_response",
+    "browser_interactive_mode",
+    "browser_user_click",
+    "browser_user_keypress",
+    "browser_user_scroll",
+    "bundle_app",
+    "cancel",
+    "confirmation_response",
+    "cu_observation",
+    "cu_session_abort",
+    "cu_session_create",
+    "delete_queued_message",
+    "diagnostics_export_request",
+    "document_list",
+    "document_load",
+    "document_save",
+    "env_vars_request",
+    "fork_shared_app",
+    "gallery_install",
+    "gallery_list",
+    "get_signing_identity_response",
+    "guardian_verification",
+    "history_request",
+    "home_base_get",
+    "identity_get",
+    "image_gen_model_set",
+    "ingress_config",
+    "integration_connect",
+    "integration_disconnect",
+    "integration_list",
+    "ipc_blob_probe",
+    "link_open_request",
+    "model_get",
+    "model_set",
+    "open_bundle",
+    "ping",
+    "publish_page",
+    "regenerate",
+    "reminder_cancel",
+    "reminders_list",
+    "remove_trust_rule",
+    "ride_shotgun_start",
+    "ride_shotgun_stop",
+    "sandbox_set",
+    "schedule_remove",
+    "schedule_toggle",
+    "schedules_list",
+    "secret_response",
+    "session_create",
+    "session_list",
+    "session_switch",
+    "sessions_clear",
+    "share_app_cloud",
+    "share_to_slack",
+    "shared_app_delete",
+    "shared_apps_list",
+    "sign_bundle_payload_response",
+    "skill_detail",
+    "skills_check_updates",
+    "skills_configure",
+    "skills_disable",
+    "skills_enable",
+    "skills_inspect",
+    "skills_install",
+    "skills_list",
+    "skills_search",
+    "skills_uninstall",
+    "skills_update",
+    "slack_webhook_config",
+    "subagent_abort",
+    "subagent_detail_request",
+    "subagent_message",
+    "subagent_status",
+    "suggestion_request",
+    "task_submit",
+    "telegram_config",
+    "tool_names_list",
+    "tool_permission_simulate",
+    "trust_rules_list",
+    "twitter_auth_start",
+    "twitter_auth_status",
+    "twitter_integration_config",
+    "ui_surface_action",
+    "ui_surface_undo",
+    "undo",
+    "unpublish_page",
+    "update_trust_rule",
+    "usage_request",
+    "user_message",
+    "vercel_api_config",
+    "watch_observation",
+    "work_item_approve_permissions",
+    "work_item_cancel",
+    "work_item_complete",
+    "work_item_delete",
+    "work_item_get",
+    "work_item_output",
+    "work_item_preflight",
+    "work_item_run_task",
+    "work_item_update",
+    "work_items_list",
+    "workspace_file_read",
+    "workspace_files_list"
+  ],
+  "serverWireTypes": [
+    "accept_starter_bundle_response",
+    "agent_heartbeat_alert",
+    "app_data_response",
+    "app_diff_response",
+    "app_file_at_version_response",
+    "app_files_changed",
+    "app_history_response",
+    "app_preview_response",
+    "app_restore_response",
+    "app_update_preview_response",
+    "apps_list_response",
+    "assistant_text_delta",
+    "assistant_thinking_delta",
+    "auth_result",
+    "browser_cdp_request",
+    "browser_frame",
+    "browser_handoff_request",
+    "browser_interactive_mode_changed",
+    "bundle_app_response",
+    "confirmation_request",
+    "context_compacted",
+    "cu_action",
+    "cu_complete",
+    "cu_error",
+    "daemon_status",
+    "diagnostics_export_response",
+    "document_editor_show",
+    "document_editor_update",
+    "document_list_response",
+    "document_load_response",
+    "document_save_response",
+    "env_vars_response",
+    "error",
+    "fork_shared_app_response",
+    "gallery_install_response",
+    "gallery_list_response",
+    "generation_cancelled",
+    "generation_handoff",
+    "get_signing_identity",
+    "guardian_verification_response",
+    "history_response",
+    "home_base_get_response",
+    "identity_get_response",
+    "ingress_config_response",
+    "integration_connect_result",
+    "integration_list_response",
+    "ipc_blob_probe_result",
+    "memory_recalled",
+    "memory_status",
+    "message_complete",
+    "message_dequeued",
+    "message_queued",
+    "message_queued_deleted",
+    "model_info",
+    "open_bundle_response",
+    "open_tasks_window",
+    "open_url",
+    "pong",
+    "publish_page_response",
+    "reminder_fired",
+    "reminders_list_response",
+    "ride_shotgun_result",
+    "schedule_complete",
+    "schedules_list_response",
+    "secret_detected",
+    "secret_request",
+    "session_error",
+    "session_info",
+    "session_list_response",
+    "sessions_clear_response",
+    "share_app_cloud_response",
+    "share_to_slack_response",
+    "shared_app_delete_response",
+    "shared_apps_list_response",
+    "sign_bundle_payload",
+    "skill_detail_response",
+    "skills_inspect_response",
+    "skills_list_response",
+    "skills_operation_response",
+    "skills_state_changed",
+    "slack_webhook_config_response",
+    "subagent_detail_response",
+    "subagent_event",
+    "subagent_spawned",
+    "subagent_status_changed",
+    "suggestion_response",
+    "task_routed",
+    "task_run_thread_created",
+    "tasks_changed",
+    "telegram_config_response",
+    "tool_input_delta",
+    "tool_names_list_response",
+    "tool_output_chunk",
+    "tool_permission_simulate_response",
+    "tool_result",
+    "tool_use_start",
+    "trace_event",
+    "trust_rules_list_response",
+    "twitter_auth_result",
+    "twitter_auth_status_response",
+    "twitter_integration_config_response",
+    "ui_surface_complete",
+    "ui_surface_dismiss",
+    "ui_surface_undo_result",
+    "ui_surface_update",
+    "undo_complete",
+    "unpublish_page_response",
+    "usage_response",
+    "usage_update",
+    "user_message_echo",
+    "vercel_api_config_response",
+    "watch_complete_request",
+    "watch_started",
+    "watcher_escalation",
+    "watcher_notification",
+    "work_item_approve_permissions_response",
+    "work_item_cancel_response",
+    "work_item_delete_response",
+    "work_item_get_response",
+    "work_item_output_response",
+    "work_item_preflight_response",
+    "work_item_run_task_response",
+    "work_item_status_changed",
+    "work_item_update_response",
+    "work_items_list_response",
+    "workspace_file_read_response",
+    "workspace_files_list_response"
+  ]
+}

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

@@ -0,0 +1,126 @@
+/**
+ * Core logic for extracting the IPC contract inventory from ipc-contract.ts.
+ *
+ * Parses the TypeScript AST to extract sorted union member lists for
+ * ClientMessage and ServerMessage.
+ */
+
+import * as ts from 'typescript';
+import * as path from 'path';
+import * as fs from 'fs';
+
+export interface ContractInventory {
+  clientMessageTypes: string[];
+  serverMessageTypes: string[];
+  /** Wire type string literals (e.g. "user_message") from ClientMessage interfaces. */
+  clientWireTypes: string[];
+  /** Wire type string literals (e.g. "assistant_text_delta") from ServerMessage interfaces. */
+  serverWireTypes: string[];
+}
+
+/** Extract sorted union member names from a type alias declaration. */
+function extractUnionMembers(
+  sourceFile: ts.SourceFile,
+  typeName: string,
+): string[] {
+  const members: string[] = [];
+
+  ts.forEachChild(sourceFile, (node) => {
+    if (
+      ts.isTypeAliasDeclaration(node) &&
+      node.name.text === typeName &&
+      ts.isUnionTypeNode(node.type)
+    ) {
+      for (const member of node.type.types) {
+        if (ts.isTypeReferenceNode(member)) {
+          const name = member.typeName;
+          if (ts.isIdentifier(name)) {
+            members.push(name.text);
+          }
+        }
+      }
+    }
+  });
+
+  return members.sort();
+}
+
+/**
+ * Extract the `type` string literal from an interface declaration.
+ * Looks for `type: 'some_wire_type'` property signatures.
+ */
+function extractWireType(
+  sourceFile: ts.SourceFile,
+  interfaceName: string,
+): string | null {
+  let wireType: string | null = null;
+
+  ts.forEachChild(sourceFile, (node) => {
+    if (
+      ts.isInterfaceDeclaration(node) &&
+      node.name.text === interfaceName
+    ) {
+      for (const member of node.members) {
+        if (
+          ts.isPropertySignature(member) &&
+          member.name &&
+          ts.isIdentifier(member.name) &&
+          member.name.text === 'type' &&
+          member.type &&
+          ts.isLiteralTypeNode(member.type) &&
+          ts.isStringLiteral(member.type.literal)
+        ) {
+          wireType = member.type.literal.text;
+        }
+      }
+    }
+  });
+
+  return wireType;
+}
+
+/**
+ * Extract wire type literals for all members of a union type.
+ */
+function extractWireTypes(
+  sourceFile: ts.SourceFile,
+  memberNames: string[],
+): string[] {
+  const wireTypes: string[] = [];
+  for (const name of memberNames) {
+    const wt = extractWireType(sourceFile, name);
+    if (wt) wireTypes.push(wt);
+  }
+  return wireTypes.sort();
+}
+
+/** Parse the contract file and extract the inventory. */
+export function extractInventory(contractPath?: string): ContractInventory {
+  const resolvedPath = contractPath ?? path.resolve(
+    import.meta.dirname ?? __dirname,
+    'ipc-contract.ts',
+  );
+
+  const source = fs.readFileSync(resolvedPath, 'utf-8');
+  const sourceFile = ts.createSourceFile(
+    path.basename(resolvedPath),
+    source,
+    ts.ScriptTarget.Latest,
+    true,
+  );
+
+  const clientMessageTypes = extractUnionMembers(sourceFile, 'ClientMessage');
+  const serverMessageTypes = extractUnionMembers(sourceFile, 'ServerMessage');
+
+  if (clientMessageTypes.length === 0) {
+    throw new Error('Failed to extract ClientMessage union members from contract');
+  }
+  if (serverMessageTypes.length === 0) {
+    throw new Error('Failed to extract ServerMessage union members from contract');
+  }
+
+  const clientWireTypes = extractWireTypes(sourceFile, clientMessageTypes);
+  const serverWireTypes = extractWireTypes(sourceFile, serverMessageTypes);
+
+  return { clientMessageTypes, serverMessageTypes, clientWireTypes, serverWireTypes };
+}