@tuturuuu/ai 0.0.10

package/src/tools/mira-tool-definitions.ts

@@ -0,0 +1,55 @@
+import { calendarToolDefinitions } from './definitions/calendar';
+import { financeToolDefinitions } from './definitions/finance';
+import { imageToolDefinitions } from './definitions/image';
+import { memoryToolDefinitions } from './definitions/memory';
+import { metaToolDefinitions } from './definitions/meta';
+import { renderUiToolDefinitions } from './definitions/render-ui';
+import { taskToolDefinitions } from './definitions/tasks';
+import { timeTrackingToolDefinitions } from './definitions/time-tracking';
+import { workspaceContextToolDefinitions } from './definitions/workspace-context';
+import { workspaceUserChatToolDefinitions } from './definitions/workspace-user-chat';
+import type { DefinedMiraToolName, MiraToolName } from './mira-tool-names';
+
+type MiraToolDefinitions = typeof metaToolDefinitions &
+  typeof taskToolDefinitions &
+  typeof calendarToolDefinitions &
+  typeof financeToolDefinitions &
+  typeof timeTrackingToolDefinitions &
+  typeof memoryToolDefinitions &
+  typeof imageToolDefinitions &
+  typeof workspaceContextToolDefinitions &
+  typeof workspaceUserChatToolDefinitions &
+  typeof renderUiToolDefinitions;
+
+function mergeUniqueToolDefinitions(
+  ...sources: ReadonlyArray<Record<string, unknown>>
+): MiraToolDefinitions {
+  const merged: Record<string, unknown> = {};
+
+  for (const source of sources) {
+    for (const [key, value] of Object.entries(source)) {
+      if (key in merged) {
+        throw new Error(`Duplicate Mira tool definition key: ${key}`);
+      }
+
+      merged[key] = value;
+    }
+  }
+
+  return merged as MiraToolDefinitions;
+}
+
+export const miraToolDefinitions = mergeUniqueToolDefinitions(
+  metaToolDefinitions,
+  taskToolDefinitions,
+  calendarToolDefinitions,
+  financeToolDefinitions,
+  timeTrackingToolDefinitions,
+  memoryToolDefinitions,
+  imageToolDefinitions,
+  workspaceContextToolDefinitions,
+  workspaceUserChatToolDefinitions,
+  renderUiToolDefinitions
+);
+
+export type { DefinedMiraToolName, MiraToolName };

package/src/tools/mira-tool-dispatcher.ts

@@ -0,0 +1,265 @@
+import {
+  executeCheckE2EEStatus,
+  executeCreateEvent,
+  executeDeleteEvent,
+  executeEnableE2EE,
+  executeGetUpcomingEvents,
+  executeUpdateEvent,
+} from './executors/calendar';
+import { executeSetImmersiveMode } from './executors/chat';
+import {
+  executeCreateTransactionCategory,
+  executeCreateTransactionTag,
+  executeCreateWallet,
+  executeDeleteTransaction,
+  executeDeleteTransactionCategory,
+  executeDeleteTransactionTag,
+  executeDeleteWallet,
+  executeGetSpendingSummary,
+  executeGetTransaction,
+  executeListTransactionCategories,
+  executeListTransactions,
+  executeListTransactionTags,
+  executeListWallets,
+  executeLogTransaction,
+  executeSetDefaultCurrency,
+  executeUpdateTransaction,
+  executeUpdateTransactionCategory,
+  executeUpdateTransactionTag,
+  executeUpdateWallet,
+} from './executors/finance';
+import { executeGenerateImage } from './executors/image';
+import { executeConvertFileToMarkdown } from './executors/markitdown';
+import {
+  executeDeleteMemory,
+  executeListMemories,
+  executeMergeMemories,
+  executeRecall,
+  executeRemember,
+} from './executors/memory';
+import { executeParallelChecks } from './executors/parallel-checks';
+import { executeCreateQrCode } from './executors/qr';
+import { executeGoogleSearch } from './executors/search';
+import { executeUpdateMySettings } from './executors/settings';
+import {
+  executeAddTaskAssignee,
+  executeAddTaskLabels,
+  executeAddTaskToProject,
+  executeCompleteTask,
+  executeCreateBoard,
+  executeCreateProject,
+  executeCreateTask,
+  executeCreateTaskLabel,
+  executeCreateTaskList,
+  executeDeleteBoard,
+  executeDeleteProject,
+  executeDeleteTask,
+  executeDeleteTaskLabel,
+  executeDeleteTaskList,
+  executeGetMyTasks,
+  executeListBoards,
+  executeListProjects,
+  executeListTaskLabels,
+  executeListTaskLists,
+  executeRemoveTaskAssignee,
+  executeRemoveTaskFromProject,
+  executeRemoveTaskLabels,
+  executeUpdateBoard,
+  executeUpdateProject,
+  executeUpdateTask,
+  executeUpdateTaskLabel,
+  executeUpdateTaskList,
+} from './executors/tasks';
+import { executeSetTheme } from './executors/theme';
+import {
+  executeCreateTimeTrackerGoal,
+  executeCreateTimeTrackingCategory,
+  executeCreateTimeTrackingEntry,
+  executeDeleteTimeTrackerGoal,
+  executeDeleteTimeTrackingCategory,
+  executeDeleteTimeTrackingSession,
+  executeGetTimeTrackerGoals,
+  executeGetTimeTrackerStats,
+  executeGetTimeTrackingSession,
+  executeListTimeTrackingCategories,
+  executeListTimeTrackingSessions,
+  executeMoveTimeTrackingSession,
+  executeStartTimer,
+  executeStopTimer,
+  executeUpdateTimeTrackerGoal,
+  executeUpdateTimeTrackingCategory,
+  executeUpdateTimeTrackingSession,
+} from './executors/timer';
+import { executeUpdateUserName } from './executors/user';
+import {
+  executeGetWorkspaceContext,
+  executeListAccessibleWorkspaces,
+  executeListWorkspaceMembers,
+  executeSetWorkspaceContext,
+} from './executors/workspace';
+import type { DefinedMiraToolName } from './mira-tool-definitions';
+import {
+  buildRenderUiRecoverySpec,
+  isRenderableRenderUiSpec,
+} from './mira-tool-render-ui';
+import type { MiraToolContext } from './mira-tool-types';
+
+type ToolHandler = (
+  args: Record<string, unknown>,
+  ctx: MiraToolContext,
+  options?: { abortSignal?: AbortSignal }
+) => Promise<unknown> | unknown;
+
+const toolHandlers = {
+  select_tools: (args) => ({ ok: true, selectedTools: args.tools }),
+  no_action_needed: () => ({ ok: true }),
+  google_search: executeGoogleSearch,
+  run_parallel_checks: (args, ctx, options) =>
+    executeParallelChecks(args, ctx, options),
+
+  get_my_tasks: executeGetMyTasks,
+  create_task: executeCreateTask,
+  complete_task: executeCompleteTask,
+  update_task: executeUpdateTask,
+  delete_task: executeDeleteTask,
+  list_boards: executeListBoards,
+  create_board: executeCreateBoard,
+  update_board: executeUpdateBoard,
+  delete_board: executeDeleteBoard,
+  list_task_lists: executeListTaskLists,
+  create_task_list: executeCreateTaskList,
+  update_task_list: executeUpdateTaskList,
+  delete_task_list: executeDeleteTaskList,
+  list_task_labels: executeListTaskLabels,
+  create_task_label: executeCreateTaskLabel,
+  update_task_label: executeUpdateTaskLabel,
+  delete_task_label: executeDeleteTaskLabel,
+  add_task_labels: executeAddTaskLabels,
+  remove_task_labels: executeRemoveTaskLabels,
+  list_projects: executeListProjects,
+  create_project: executeCreateProject,
+  update_project: executeUpdateProject,
+  delete_project: executeDeleteProject,
+  add_task_to_project: executeAddTaskToProject,
+  remove_task_from_project: executeRemoveTaskFromProject,
+  add_task_assignee: executeAddTaskAssignee,
+  remove_task_assignee: executeRemoveTaskAssignee,
+
+  get_upcoming_events: executeGetUpcomingEvents,
+  create_event: executeCreateEvent,
+  update_event: executeUpdateEvent,
+  delete_event: executeDeleteEvent,
+  check_e2ee_status: executeCheckE2EEStatus,
+  enable_e2ee: executeEnableE2EE,
+
+  log_transaction: executeLogTransaction,
+  get_spending_summary: executeGetSpendingSummary,
+  list_wallets: executeListWallets,
+  create_wallet: executeCreateWallet,
+  update_wallet: executeUpdateWallet,
+  delete_wallet: executeDeleteWallet,
+  list_transactions: executeListTransactions,
+  get_transaction: executeGetTransaction,
+  update_transaction: executeUpdateTransaction,
+  delete_transaction: executeDeleteTransaction,
+  list_transaction_categories: executeListTransactionCategories,
+  create_transaction_category: executeCreateTransactionCategory,
+  update_transaction_category: executeUpdateTransactionCategory,
+  delete_transaction_category: executeDeleteTransactionCategory,
+  list_transaction_tags: executeListTransactionTags,
+  create_transaction_tag: executeCreateTransactionTag,
+  update_transaction_tag: executeUpdateTransactionTag,
+  delete_transaction_tag: executeDeleteTransactionTag,
+
+  start_timer: executeStartTimer,
+  stop_timer: executeStopTimer,
+  list_time_tracking_sessions: executeListTimeTrackingSessions,
+  list_time_tracking_categories: executeListTimeTrackingCategories,
+  create_time_tracking_category: executeCreateTimeTrackingCategory,
+  update_time_tracking_category: executeUpdateTimeTrackingCategory,
+  delete_time_tracking_category: executeDeleteTimeTrackingCategory,
+  get_time_tracking_session: executeGetTimeTrackingSession,
+  get_time_tracker_stats: executeGetTimeTrackerStats,
+  get_time_tracker_goals: executeGetTimeTrackerGoals,
+  create_time_tracker_goal: executeCreateTimeTrackerGoal,
+  update_time_tracker_goal: executeUpdateTimeTrackerGoal,
+  delete_time_tracker_goal: executeDeleteTimeTrackerGoal,
+  create_time_tracking_entry: executeCreateTimeTrackingEntry,
+  update_time_tracking_session: executeUpdateTimeTrackingSession,
+  delete_time_tracking_session: executeDeleteTimeTrackingSession,
+  move_time_tracking_session: executeMoveTimeTrackingSession,
+
+  remember: executeRemember,
+  recall: executeRecall,
+  list_memories: executeListMemories,
+  delete_memory: executeDeleteMemory,
+  merge_memories: executeMergeMemories,
+
+  create_image: executeGenerateImage,
+  create_qr_code: executeCreateQrCode,
+  convert_file_to_markdown: executeConvertFileToMarkdown,
+  list_accessible_workspaces: executeListAccessibleWorkspaces,
+  get_workspace_context: executeGetWorkspaceContext,
+  set_workspace_context: executeSetWorkspaceContext,
+
+  update_my_settings: executeUpdateMySettings,
+  set_default_currency: executeSetDefaultCurrency,
+  set_theme: executeSetTheme,
+  list_workspace_members: executeListWorkspaceMembers,
+  update_user_name: executeUpdateUserName,
+  set_immersive_mode: executeSetImmersiveMode,
+} satisfies Record<Exclude<DefinedMiraToolName, 'render_ui'>, ToolHandler>;
+
+export async function executeMiraTool(
+  toolName: string,
+  args: Record<string, unknown>,
+  ctx: MiraToolContext,
+  options?: { abortSignal?: AbortSignal }
+): Promise<unknown> {
+  if (toolName === 'render_ui') {
+    if (!isRenderableRenderUiSpec(args)) {
+      const diagnosisParts: string[] = [];
+      if (typeof args.root !== 'string' || args.root.length === 0) {
+        diagnosisParts.push('`root` is missing or not a string');
+      }
+      const elements = args.elements;
+      if (
+        !elements ||
+        typeof elements !== 'object' ||
+        Array.isArray(elements)
+      ) {
+        diagnosisParts.push('`elements` is missing or not an object');
+      } else if (Object.keys(elements as object).length === 0) {
+        diagnosisParts.push(
+          '`elements` is empty — you must define at least elements[root]'
+        );
+      } else if (
+        typeof args.root === 'string' &&
+        args.root.length > 0 &&
+        !(args.root in (elements as Record<string, unknown>))
+      ) {
+        diagnosisParts.push(
+          `elements["${args.root}"] does not exist — the root element ID must be a key in elements`
+        );
+      }
+      const diagnosis =
+        diagnosisParts.length > 0
+          ? ` Diagnosis: ${diagnosisParts.join('; ')}.`
+          : '';
+
+      return {
+        spec: buildRenderUiRecoverySpec(args),
+        recoveredFromInvalidSpec: true,
+        warning: `Invalid render_ui spec was auto-recovered.${diagnosis} Fix: elements MUST contain the root element. Example: { "root": "r", "elements": { "r": { "type": "Card", "props": { "title": "Result" }, "children": ["t"] }, "t": { "type": "Text", "props": { "content": "Your content here" }, "children": [] } } }.`,
+      };
+    }
+    return { spec: args };
+  }
+
+  if (!(toolName in toolHandlers))
+    return { error: `Unknown tool: ${toolName}` };
+
+  const handler = toolHandlers[toolName as keyof typeof toolHandlers];
+
+  return handler(args, ctx, options);
+}

package/src/tools/mira-tool-metadata.ts

@@ -0,0 +1,164 @@
+import type { PermissionId } from '@tuturuuu/types';
+import type { MiraToolName } from './mira-tool-names';
+
+export const MIRA_TOOL_DIRECTORY: Record<MiraToolName, string> = {
+  select_tools: 'Present user with tool selection options',
+  get_my_tasks: 'Get your tasks by status (overdue, today, upcoming)',
+  create_task: 'Create a new task',
+  complete_task: 'Mark a task as completed',
+  update_task: 'Update task fields (name, priority, dates, etc.)',
+  delete_task: 'Soft-delete a task',
+  list_boards: 'List all task boards in the workspace',
+  create_board: 'Create a new task board',
+  update_board: 'Update a task board name',
+  delete_board: 'Delete a task board',
+  list_task_lists: 'List columns/lists within a board',
+  create_task_list: 'Create a new list in a board',
+  update_task_list: 'Update a task list',
+  delete_task_list: 'Delete a task list',
+  list_task_labels: 'List workspace task labels',
+  create_task_label: 'Create a task label',
+  update_task_label: 'Update a task label',
+  delete_task_label: 'Delete a task label',
+  add_task_labels: 'Assign labels to a task',
+  remove_task_labels: 'Remove labels from a task',
+  list_projects: 'List workspace projects',
+  create_project: 'Create a project',
+  update_project: 'Update a project',
+  delete_project: 'Delete a project',
+  add_task_to_project: 'Link a task to a project',
+  remove_task_from_project: 'Unlink a task from a project',
+  add_task_assignee: 'Assign a user to a task',
+  remove_task_assignee: 'Remove a user from a task',
+  get_upcoming_events: 'Get calendar events for the next N days',
+  create_event: 'Create a calendar event',
+  update_event: 'Update a calendar event',
+  delete_event: 'Delete a calendar event',
+  check_e2ee_status: 'Check E2EE encryption status for calendar',
+  enable_e2ee: 'Enable end-to-end encryption for calendar events',
+  log_transaction: 'Log an income or expense transaction',
+  get_spending_summary: 'Get spending/income summary for N days',
+  list_wallets: 'List workspace wallets',
+  create_wallet: 'Create a new wallet',
+  update_wallet: 'Update wallet details',
+  delete_wallet: 'Delete a wallet',
+  list_transactions: 'List recent transactions (with filters)',
+  get_transaction: 'Get a single transaction by ID',
+  update_transaction: 'Update a transaction',
+  delete_transaction: 'Delete a transaction',
+  list_transaction_categories: 'List transaction categories',
+  create_transaction_category: 'Create a transaction category',
+  update_transaction_category: 'Update a transaction category',
+  delete_transaction_category: 'Delete a transaction category',
+  list_transaction_tags: 'List transaction tags',
+  create_transaction_tag: 'Create a transaction tag',
+  update_transaction_tag: 'Update a transaction tag',
+  delete_transaction_tag: 'Delete a transaction tag',
+  set_default_currency: 'Set the default currency for the workspace',
+  start_timer: 'Start a time tracking session',
+  stop_timer: 'Stop the running time tracking session',
+  list_time_tracking_sessions:
+    'List your time tracking history with pagination and filters',
+  list_time_tracking_categories:
+    'List time-tracking categories and IDs for category selection/mapping',
+  create_time_tracking_category:
+    'Create a time-tracking category in the current workspace',
+  update_time_tracking_category:
+    'Update a time-tracking category by ID in the current workspace',
+  delete_time_tracking_category:
+    'Delete a time-tracking category by ID in the current workspace',
+  get_time_tracking_session: 'Get one time tracking session by ID',
+  get_time_tracker_stats:
+    'Get time-tracker summary stats and activity data for insights',
+  get_time_tracker_goals:
+    'List time-tracker goals with optional daily/weekly progress',
+  create_time_tracker_goal: 'Create a time-tracker goal',
+  update_time_tracker_goal: 'Update a time-tracker goal',
+  delete_time_tracker_goal: 'Delete a time-tracker goal',
+  create_time_tracking_entry:
+    'Create a stopped/manual time tracking history entry. If approval is required, it returns requiresApproval with next-step guidance for the user/UI to handle approval.',
+  update_time_tracking_session: 'Update a time tracking history session',
+  delete_time_tracking_session: 'Delete a time tracking history session',
+  move_time_tracking_session:
+    'Move a session to another workspace if you are a member of both',
+  remember: 'Save a fact/preference about the user',
+  recall: 'Search saved memories',
+  list_memories: 'List saved memories with filters/pagination',
+  delete_memory: 'Delete a saved memory',
+  merge_memories: 'Merge multiple memories into one',
+  create_image: 'Generate an image from a text description',
+  create_qr_code:
+    'Generate a QR code from text with custom colors/size and save it to Drive',
+  google_search:
+    'Search the web for real-time info (news, prices, weather, facts).',
+  run_parallel_checks:
+    'Run lightweight parallel subagents for complex verification, planning, or conflicting-assumption checks.',
+  convert_file_to_markdown:
+    'Convert attached files (Excel, Word, PowerPoint, PDF, etc.) into markdown via MarkItDown. Do not use for YouTube links; Google/Gemini handles YouTube URLs as native video input. Costs 100 credits per file conversion.',
+  list_accessible_workspaces:
+    'List every workspace you can access, with member counts',
+  get_workspace_context:
+    'Show the current workspace context used for tasks, calendar, and finance queries',
+  set_workspace_context:
+    'Switch the current workspace context for task, calendar, and finance tools',
+  update_my_settings: "Update the assistant's personality settings",
+  set_theme: 'Switch dark mode, light mode, or system theme',
+  render_ui:
+    'Generate an interactive, actionable UI component or widget instead of plain text when it significantly improves user experience (e.g. for forms, dashboards, blog-like insight layouts, or data visualization).',
+  list_workspace_members: 'List all members of the workspace',
+  update_user_name: "Update the user's display name or full name",
+  set_immersive_mode: 'Enter or exit immersive fullscreen mode for the chat',
+  no_action_needed: 'Conversational message — no tool action required',
+};
+
+export const MIRA_TOOL_PERMISSIONS: Partial<
+  Record<MiraToolName, PermissionId | PermissionId[]>
+> = {
+  create_task: 'manage_projects',
+  complete_task: 'manage_projects',
+  update_task: 'manage_projects',
+  delete_task: 'manage_projects',
+  create_board: 'manage_projects',
+  update_board: 'manage_projects',
+  delete_board: 'manage_projects',
+  create_task_list: 'manage_projects',
+  update_task_list: 'manage_projects',
+  delete_task_list: 'manage_projects',
+  create_task_label: 'manage_projects',
+  update_task_label: 'manage_projects',
+  delete_task_label: 'manage_projects',
+  add_task_labels: 'manage_projects',
+  remove_task_labels: 'manage_projects',
+  create_project: 'manage_projects',
+  update_project: 'manage_projects',
+  delete_project: 'manage_projects',
+  add_task_to_project: 'manage_projects',
+  remove_task_from_project: 'manage_projects',
+  add_task_assignee: 'manage_projects',
+  remove_task_assignee: 'manage_projects',
+  get_upcoming_events: 'manage_calendar',
+  create_event: 'manage_calendar',
+  update_event: 'manage_calendar',
+  delete_event: 'manage_calendar',
+  check_e2ee_status: 'manage_calendar',
+  enable_e2ee: 'manage_calendar',
+  log_transaction: 'manage_finance',
+  get_spending_summary: 'manage_finance',
+  list_wallets: 'manage_finance',
+  create_wallet: 'manage_finance',
+  update_wallet: 'manage_finance',
+  delete_wallet: 'manage_finance',
+  list_transactions: 'manage_finance',
+  get_transaction: 'manage_finance',
+  update_transaction: 'manage_finance',
+  delete_transaction: 'manage_finance',
+  list_transaction_categories: 'manage_finance',
+  create_transaction_category: 'manage_finance',
+  update_transaction_category: 'manage_finance',
+  delete_transaction_category: 'manage_finance',
+  list_transaction_tags: 'manage_finance',
+  create_transaction_tag: 'manage_finance',
+  update_transaction_tag: 'manage_finance',
+  delete_transaction_tag: 'manage_finance',
+  set_default_currency: 'manage_finance',
+};

package/src/tools/mira-tool-names.ts

@@ -0,0 +1,95 @@
+export const MIRA_TOOL_NAMES = [
+  'select_tools',
+  'get_my_tasks',
+  'create_task',
+  'complete_task',
+  'update_task',
+  'delete_task',
+  'list_boards',
+  'create_board',
+  'update_board',
+  'delete_board',
+  'list_task_lists',
+  'create_task_list',
+  'update_task_list',
+  'delete_task_list',
+  'list_task_labels',
+  'create_task_label',
+  'update_task_label',
+  'delete_task_label',
+  'add_task_labels',
+  'remove_task_labels',
+  'list_projects',
+  'create_project',
+  'update_project',
+  'delete_project',
+  'add_task_to_project',
+  'remove_task_from_project',
+  'add_task_assignee',
+  'remove_task_assignee',
+  'get_upcoming_events',
+  'create_event',
+  'update_event',
+  'delete_event',
+  'check_e2ee_status',
+  'enable_e2ee',
+  'log_transaction',
+  'get_spending_summary',
+  'list_wallets',
+  'create_wallet',
+  'update_wallet',
+  'delete_wallet',
+  'list_transactions',
+  'get_transaction',
+  'update_transaction',
+  'delete_transaction',
+  'list_transaction_categories',
+  'create_transaction_category',
+  'update_transaction_category',
+  'delete_transaction_category',
+  'list_transaction_tags',
+  'create_transaction_tag',
+  'update_transaction_tag',
+  'delete_transaction_tag',
+  'set_default_currency',
+  'start_timer',
+  'stop_timer',
+  'list_time_tracking_sessions',
+  'list_time_tracking_categories',
+  'create_time_tracking_category',
+  'update_time_tracking_category',
+  'delete_time_tracking_category',
+  'get_time_tracking_session',
+  'get_time_tracker_stats',
+  'get_time_tracker_goals',
+  'create_time_tracker_goal',
+  'update_time_tracker_goal',
+  'delete_time_tracker_goal',
+  'create_time_tracking_entry',
+  'update_time_tracking_session',
+  'delete_time_tracking_session',
+  'move_time_tracking_session',
+  'remember',
+  'recall',
+  'list_memories',
+  'delete_memory',
+  'merge_memories',
+  'create_image',
+  'create_qr_code',
+  'google_search',
+  'run_parallel_checks',
+  'convert_file_to_markdown',
+  'list_accessible_workspaces',
+  'get_workspace_context',
+  'set_workspace_context',
+  'update_my_settings',
+  'set_theme',
+  'render_ui',
+  'list_workspace_members',
+  'update_user_name',
+  'set_immersive_mode',
+  'no_action_needed',
+] as const;
+
+export type MiraToolName = (typeof MIRA_TOOL_NAMES)[number];
+export type DefinedMiraToolName = MiraToolName;

package/src/tools/mira-tool-render-ui.ts

@@ -0,0 +1,54 @@
+export function isRenderableRenderUiSpec(
+  value: Record<string, unknown> | undefined
+): boolean {
+  if (!value) return false;
+  if (typeof value.root !== 'string' || value.root.length === 0) return false;
+
+  const elements = value.elements;
+  if (!elements || typeof elements !== 'object' || Array.isArray(elements)) {
+    return false;
+  }
+
+  if (!(value.root in elements)) return false;
+
+  const rootElement = (elements as Record<string, unknown>)[value.root];
+  return (
+    !!rootElement &&
+    typeof rootElement === 'object' &&
+    !Array.isArray(rootElement)
+  );
+}
+
+export function buildRenderUiRecoverySpec(args: Record<string, unknown>) {
+  return buildRenderUiCalloutSpec(args, 'render_ui_recovery_root');
+}
+
+function buildRenderUiCalloutSpec(
+  args: Record<string, unknown>,
+  fallbackRoot: string
+) {
+  const requestedRoot =
+    typeof args.root === 'string' && args.root.trim().length > 0
+      ? args.root.trim()
+      : fallbackRoot;
+
+  return {
+    root: requestedRoot,
+    elements: {
+      [requestedRoot]: {
+        type: 'Callout',
+        props: {
+          title: 'UI unavailable',
+          variant: 'warning',
+          content:
+            'Could not render the generated UI spec. Please retry this request.',
+        },
+        children: [],
+      },
+    },
+  };
+}
+
+export function buildRenderUiFailsafeSpec(args: Record<string, unknown>) {
+  return buildRenderUiCalloutSpec(args, 'render_ui_failsafe_root');
+}

package/src/tools/mira-tool-types.ts

@@ -0,0 +1,17 @@
+import type { TypedSupabaseClient } from '@tuturuuu/supabase/next/client';
+import type { MiraWorkspaceContextState } from './workspace-context';
+
+export interface MiraToolContext {
+  userId: string;
+  wsId: string;
+  creditWsId?: string;
+  workspaceContext?: MiraWorkspaceContextState;
+  chatId?: string;
+  supabase: TypedSupabaseClient;
+  timezone?: string;
+  canReadUserGroupStorage?: (input: {
+    groupId: string;
+    storagePath: string;
+    wsId: string;
+  }) => boolean | Promise<boolean>;
+}