@vellumai/assistant 0.3.4 → 0.3.6

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

@@ -0,0 +1,250 @@
+// Surface types, UI surface lifecycle messages.
+
+// === Surface type definitions ===
+
+export type SurfaceType = 'card' | 'form' | 'list' | 'table' | 'confirmation' | 'dynamic_page' | 'file_upload' | 'browser_view' | 'document_preview';
+
+export const INTERACTIVE_SURFACE_TYPES: SurfaceType[] = ['form', 'confirmation', 'dynamic_page', 'file_upload'];
+
+export interface SurfaceAction {
+  id: string;
+  label: string;
+  style?: 'primary' | 'secondary' | 'destructive';
+}
+
+export interface CardSurfaceData {
+  title: string;
+  subtitle?: string;
+  body: string;
+  metadata?: Array<{ label: string; value: string }>;
+  /** Optional template name for specialized rendering (e.g. "weather_forecast"). */
+  template?: string;
+  /** Arbitrary data consumed by the template renderer. Shape depends on template. */
+  templateData?: Record<string, unknown>;
+}
+
+export interface FormField {
+  id: string;
+  type: 'text' | 'textarea' | 'select' | 'toggle' | 'number' | 'password';
+  label: string;
+  placeholder?: string;
+  required?: boolean;
+  defaultValue?: string | number | boolean;
+  options?: Array<{ label: string; value: string }>;
+}
+
+export interface FormPage {
+  id: string;
+  title: string;
+  description?: string;
+  fields: FormField[];
+}
+
+export interface FormSurfaceData {
+  description?: string;
+  fields: FormField[];
+  submitLabel?: string;
+  pages?: FormPage[];
+  pageLabels?: { next?: string; back?: string; submit?: string };
+}
+
+export interface ListItem {
+  id: string;
+  title: string;
+  subtitle?: string;
+  icon?: string;
+  selected?: boolean;
+}
+
+export interface ListSurfaceData {
+  items: ListItem[];
+  selectionMode: 'single' | 'multiple' | 'none';
+}
+
+export interface ConfirmationSurfaceData {
+  message: string;
+  detail?: string;
+  confirmLabel?: string;
+  cancelLabel?: string;
+  destructive?: boolean;
+}
+
+export interface DynamicPagePreview {
+  title: string;
+  subtitle?: string;
+  description?: string;
+  icon?: string;
+  metrics?: Array<{ label: string; value: string }>;
+}
+
+export interface DynamicPageSurfaceData {
+  html: string;
+  width?: number;
+  height?: number;
+  appId?: string;
+  appType?: string;
+  reloadGeneration?: number;
+  status?: string;
+  preview?: DynamicPagePreview;
+}
+
+export interface FileUploadSurfaceData {
+  prompt: string;
+  acceptedTypes?: string[];
+  maxFiles?: number;
+  maxSizeBytes?: number;
+}
+
+export interface TableColumn {
+  id: string;
+  label: string;
+  width?: number;
+}
+
+export interface TableRow {
+  id: string;
+  cells: Record<string, string>;
+  selectable?: boolean;
+  selected?: boolean;
+}
+
+export interface TableSurfaceData {
+  columns: TableColumn[];
+  rows: TableRow[];
+  selectionMode?: 'none' | 'single' | 'multiple';
+  caption?: string;
+}
+
+export interface BrowserViewSurfaceData {
+  sessionId: string;
+  currentUrl: string;
+  status: 'navigating' | 'idle' | 'interacting';
+  frame?: string; // base64 JPEG
+  actionText?: string; // "Clicking 'Submit' button"
+  highlights?: Array<{ x: number; y: number; w: number; h: number; label: string }>;
+  pages?: Array<{ id: string; title: string; url: string; active: boolean }>;
+}
+
+export interface DocumentPreviewSurfaceData {
+  title: string;
+  surfaceId: string;   // the doc's real surfaceId, for focusing the panel
+  subtitle?: string;
+}
+
+export type SurfaceData = CardSurfaceData | FormSurfaceData | ListSurfaceData | TableSurfaceData | ConfirmationSurfaceData | DynamicPageSurfaceData | FileUploadSurfaceData | BrowserViewSurfaceData | DocumentPreviewSurfaceData;
+
+// === Client → Server ===
+
+export interface UiSurfaceAction {
+  type: 'ui_surface_action';
+  sessionId: string;
+  surfaceId: string;
+  actionId: string;
+  data?: Record<string, unknown>;
+}
+
+export interface UiSurfaceUndoRequest {
+  type: 'ui_surface_undo';
+  sessionId: string;
+  surfaceId: string;
+}
+
+// === Server → Client ===
+
+/** Common fields shared by all UiSurfaceShow variants. */
+interface UiSurfaceShowBase {
+  type: 'ui_surface_show';
+  sessionId: string;
+  surfaceId: string;
+  title?: string;
+  actions?: SurfaceAction[];
+  display?: 'inline' | 'panel';
+  /** The message ID that this surface belongs to (for history loading). */
+  messageId?: string;
+}
+
+export interface UiSurfaceShowCard extends UiSurfaceShowBase {
+  surfaceType: 'card';
+  data: CardSurfaceData;
+}
+
+export interface UiSurfaceShowForm extends UiSurfaceShowBase {
+  surfaceType: 'form';
+  data: FormSurfaceData;
+}
+
+export interface UiSurfaceShowList extends UiSurfaceShowBase {
+  surfaceType: 'list';
+  data: ListSurfaceData;
+}
+
+export interface UiSurfaceShowConfirmation extends UiSurfaceShowBase {
+  surfaceType: 'confirmation';
+  data: ConfirmationSurfaceData;
+}
+
+export interface UiSurfaceShowDynamicPage extends UiSurfaceShowBase {
+  surfaceType: 'dynamic_page';
+  data: DynamicPageSurfaceData;
+}
+
+export interface UiSurfaceShowTable extends UiSurfaceShowBase {
+  surfaceType: 'table';
+  data: TableSurfaceData;
+}
+
+export interface UiSurfaceShowFileUpload extends UiSurfaceShowBase {
+  surfaceType: 'file_upload';
+  data: FileUploadSurfaceData;
+}
+
+export interface UiSurfaceShowBrowserView extends UiSurfaceShowBase {
+  surfaceType: 'browser_view';
+  data: BrowserViewSurfaceData;
+}
+
+export interface UiSurfaceShowDocumentPreview extends UiSurfaceShowBase {
+  surfaceType: 'document_preview';
+  data: DocumentPreviewSurfaceData;
+}
+
+export type UiSurfaceShow =
+  | UiSurfaceShowCard
+  | UiSurfaceShowForm
+  | UiSurfaceShowList
+  | UiSurfaceShowTable
+  | UiSurfaceShowConfirmation
+  | UiSurfaceShowDynamicPage
+  | UiSurfaceShowFileUpload
+  | UiSurfaceShowBrowserView
+  | UiSurfaceShowDocumentPreview;
+
+export interface UiSurfaceUpdate {
+  type: 'ui_surface_update';
+  sessionId: string;
+  surfaceId: string;
+  data: Partial<SurfaceData>;
+}
+
+export interface UiSurfaceDismiss {
+  type: 'ui_surface_dismiss';
+  sessionId: string;
+  surfaceId: string;
+}
+
+export interface UiSurfaceComplete {
+  type: 'ui_surface_complete';
+  sessionId: string;
+  surfaceId: string;
+  summary: string;
+  submittedData?: Record<string, unknown>;
+}
+
+export interface UiSurfaceUndoResult {
+  type: 'ui_surface_undo_result';
+  sessionId: string;
+  surfaceId: string;
+  success: boolean;
+  /** Number of remaining undo entries after this undo. */
+  remainingUndos: number;
+}

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

@@ -0,0 +1,60 @@
+// Trust rule and starter bundle types.
+
+// === Client → Server ===
+
+export interface AddTrustRule {
+  type: 'add_trust_rule';
+  toolName: string;
+  pattern: string;
+  scope: string;
+  decision: 'allow' | 'deny' | 'ask';
+  /** When true, the rule also covers high-risk invocations. */
+  allowHighRisk?: boolean;
+  /** Execution target override for this rule. */
+  executionTarget?: 'host' | 'sandbox';
+}
+
+export interface TrustRulesList {
+  type: 'trust_rules_list';
+}
+
+export interface RemoveTrustRule {
+  type: 'remove_trust_rule';
+  id: string;
+}
+
+export interface UpdateTrustRule {
+  type: 'update_trust_rule';
+  id: string;
+  tool?: string;
+  pattern?: string;
+  scope?: string;
+  decision?: 'allow' | 'deny' | 'ask';
+  priority?: number;
+}
+
+export interface AcceptStarterBundle {
+  type: 'accept_starter_bundle';
+}
+
+// === Server → Client ===
+
+export interface TrustRulesListResponse {
+  type: 'trust_rules_list_response';
+  rules: Array<{
+    id: string;
+    tool: string;
+    pattern: string;
+    scope: string;
+    decision: 'allow' | 'deny' | 'ask';
+    priority: number;
+    createdAt: number;
+  }>;
+}
+
+export interface AcceptStarterBundleResponse {
+  type: 'accept_starter_bundle_response';
+  accepted: boolean;
+  rulesAdded: number;
+  alreadyAccepted: boolean;
+}

package/src/daemon/ipc-contract/work-items.ts

@@ -0,0 +1,225 @@
+// Work item (task queue) types.
+
+// === Client → Server ===
+
+export interface WorkItemsListRequest {
+  type: 'work_items_list';
+  status?: string;  // optional filter
+}
+
+export interface WorkItemGetRequest {
+  type: 'work_item_get';
+  id: string;
+}
+
+export interface WorkItemUpdateRequest {
+  type: 'work_item_update';
+  id: string;
+  title?: string;
+  notes?: string;
+  status?: string;
+  priorityTier?: number;
+  sortIndex?: number;
+}
+
+export interface WorkItemCompleteRequest {
+  type: 'work_item_complete';
+  id: string;
+}
+
+export interface WorkItemDeleteRequest {
+  type: 'work_item_delete';
+  id: string;
+}
+
+export interface WorkItemRunTaskRequest {
+  type: 'work_item_run_task';
+  id: string;
+}
+
+export interface WorkItemOutputRequest {
+  type: 'work_item_output';
+  id: string;
+}
+
+export interface WorkItemPreflightRequest {
+  type: 'work_item_preflight';
+  id: string;  // work item ID
+}
+
+export interface WorkItemApprovePermissionsRequest {
+  type: 'work_item_approve_permissions';
+  id: string;
+  approvedTools: string[];  // tools the user approved
+}
+
+export interface WorkItemCancelRequest {
+  type: 'work_item_cancel';
+  id: string;
+}
+
+// === Server → Client ===
+
+export interface WorkItemsListResponse {
+  type: 'work_items_list_response';
+  items: Array<{
+    id: string;
+    taskId: string;
+    title: string;
+    notes: string | null;
+    status: string;
+    priorityTier: number;
+    sortIndex: number | null;
+    lastRunId: string | null;
+    lastRunConversationId: string | null;
+    lastRunStatus: string | null;
+    sourceType: string | null;
+    sourceId: string | null;
+    createdAt: number;
+    updatedAt: number;
+  }>;
+}
+
+export interface WorkItemGetResponse {
+  type: 'work_item_get_response';
+  item: {
+    id: string;
+    taskId: string;
+    title: string;
+    notes: string | null;
+    status: string;
+    priorityTier: number;
+    sortIndex: number | null;
+    lastRunId: string | null;
+    lastRunConversationId: string | null;
+    lastRunStatus: string | null;
+    sourceType: string | null;
+    sourceId: string | null;
+    createdAt: number;
+    updatedAt: number;
+  } | null;
+}
+
+export interface WorkItemUpdateResponse {
+  type: 'work_item_update_response';
+  item: {
+    id: string;
+    taskId: string;
+    title: string;
+    notes: string | null;
+    status: string;
+    priorityTier: number;
+    sortIndex: number | null;
+    lastRunId: string | null;
+    lastRunConversationId: string | null;
+    lastRunStatus: string | null;
+    sourceType: string | null;
+    sourceId: string | null;
+    createdAt: number;
+    updatedAt: number;
+  } | null;
+}
+
+export interface WorkItemDeleteResponse {
+  type: 'work_item_delete_response';
+  id: string;
+  success: boolean;
+}
+
+export type WorkItemRunTaskErrorCode = 'not_found' | 'already_running' | 'invalid_status' | 'no_task' | 'permission_required';
+
+export interface WorkItemRunTaskResponse {
+  type: 'work_item_run_task_response';
+  id: string;
+  lastRunId: string;
+  success: boolean;
+  error?: string;
+  /** Structured error code so the client can deterministically re-enable buttons or show contextual UI. */
+  errorCode?: WorkItemRunTaskErrorCode;
+}
+
+export interface WorkItemOutputResponse {
+  type: 'work_item_output_response';
+  id: string;
+  success: boolean;
+  error?: string;
+  output?: {
+    title: string;
+    status: string;
+    runId: string | null;
+    conversationId: string | null;
+    completedAt: number | null;
+    summary: string;
+    highlights: string[];
+  };
+}
+
+export interface WorkItemPreflightResponse {
+  type: 'work_item_preflight_response';
+  id: string;
+  success: boolean;
+  error?: string;
+  permissions?: {
+    tool: string;
+    description: string;
+    riskLevel: 'low' | 'medium' | 'high';
+    currentDecision: 'allow' | 'deny' | 'prompt';
+  }[];
+}
+
+export interface WorkItemApprovePermissionsResponse {
+  type: 'work_item_approve_permissions_response';
+  id: string;
+  success: boolean;
+  error?: string;
+}
+
+export interface WorkItemCancelResponse {
+  type: 'work_item_cancel_response';
+  id: string;
+  success: boolean;
+  error?: string;
+}
+
+/** Server push — tells the client to open/focus the tasks window. */
+export interface OpenTasksWindow {
+  type: 'open_tasks_window';
+}
+
+/** Server push — lightweight invalidation signal: the task queue has been mutated, refetch your list. */
+export interface TasksChanged {
+  type: 'tasks_changed';
+}
+
+/** Server push — broadcast when a work item status changes (e.g. running -> awaiting_review). */
+export interface WorkItemStatusChanged {
+  type: 'work_item_status_changed';
+  item: {
+    id: string;
+    taskId: string;
+    title: string;
+    status: string;
+    lastRunId: string | null;
+    lastRunConversationId: string | null;
+    lastRunStatus: string | null;
+    updatedAt: number;
+  };
+}
+
+/** Server push — broadcast when a task run creates a conversation, so the client can show it as a chat thread. */
+export interface TaskRunThreadCreated {
+  type: 'task_run_thread_created';
+  conversationId: string;
+  workItemId: string;
+  title: string;
+}
+
+/** Server push — broadcast when a guardian action request creates a thread for the mac channel. */
+export interface GuardianRequestThreadCreated {
+  type: 'guardian_request_thread_created';
+  conversationId: string;
+  requestId: string;
+  callSessionId: string;
+  title: string;
+  questionText: string;
+}

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

@@ -0,0 +1,113 @@
+// Workspace file, identity, and tool permission types.
+
+// === Client → Server ===
+
+export interface WorkspaceFilesListRequest {
+  type: 'workspace_files_list';
+}
+
+export interface WorkspaceFileReadRequest {
+  type: 'workspace_file_read';
+  /** Relative path within the workspace directory (e.g. "IDENTITY.md"). */
+  path: string;
+}
+
+export interface IdentityGetRequest {
+  type: 'identity_get';
+}
+
+export interface ToolPermissionSimulateRequest {
+  type: 'tool_permission_simulate';
+  /** Tool name to simulate (e.g. 'bash', 'file_write'). */
+  toolName: string;
+  /** Tool input record to simulate. */
+  input: Record<string, unknown>;
+  /** Working directory context; defaults to daemon cwd when omitted. */
+  workingDir?: string;
+  /** Whether the simulated context is interactive (default true). */
+  isInteractive?: boolean;
+  /** When true, side-effect tools that would normally be auto-allowed get promoted to prompt. */
+  forcePromptSideEffects?: boolean;
+}
+
+export interface ToolNamesListRequest {
+  type: 'tool_names_list';
+}
+
+// === Server → Client ===
+
+export interface WorkspaceFilesListResponse {
+  type: 'workspace_files_list_response';
+  files: Array<{
+    /** Relative path within the workspace (e.g. "IDENTITY.md", "skills/my-skill"). */
+    path: string;
+    /** Display name (e.g. "IDENTITY.md"). */
+    name: string;
+    /** Whether the file/directory exists. */
+    exists: boolean;
+  }>;
+}
+
+export interface WorkspaceFileReadResponse {
+  type: 'workspace_file_read_response';
+  path: string;
+  content: string | null;
+  error?: string;
+}
+
+export interface IdentityGetResponse {
+  type: 'identity_get_response';
+  /** Whether an IDENTITY.md file was found. When false, all fields are empty defaults. Optional for backwards compat with older daemons. */
+  found?: boolean;
+  name: string;
+  role: string;
+  personality: string;
+  emoji: string;
+  home: string;
+  version?: string;
+  assistantId?: string;
+  createdAt?: string;
+  originSystem?: string;
+}
+
+export interface ToolPermissionSimulateResponse {
+  type: 'tool_permission_simulate_response';
+  success: boolean;
+  /** The simulated permission decision. */
+  decision?: 'allow' | 'deny' | 'prompt';
+  /** Risk level of the simulated tool invocation. */
+  riskLevel?: string;
+  /** Human-readable reason for the decision. */
+  reason?: string;
+  /** When decision is 'prompt', the data needed to render a ToolConfirmationBubble. */
+  promptPayload?: {
+    allowlistOptions: Array<{ label: string; description: string; pattern: string }>;
+    scopeOptions: Array<{ label: string; scope: string }>;
+    persistentDecisionsAllowed: boolean;
+  };
+  /** Resolved execution target for the tool. */
+  executionTarget?: 'host' | 'sandbox';
+  /** ID of the trust rule that matched (if any). */
+  matchedRuleId?: string;
+  /** Error message when success is false. */
+  error?: string;
+}
+
+export interface ToolInputSchema {
+  type: 'object';
+  properties?: Record<string, {
+    type?: string;
+    description?: string;
+    enum?: string[];
+    [key: string]: unknown;
+  }>;
+  required?: string[];
+}
+
+export interface ToolNamesListResponse {
+  type: 'tool_names_list_response';
+  /** Sorted list of all registered tool names. */
+  names: string[];
+  /** Input schemas keyed by tool name. */
+  schemas?: Record<string, ToolInputSchema>;
+}