@tuturuuu/ai 0.13.0 → 0.15.0

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

@@ -0,0 +1,138 @@
+import { DEV_MODE } from '@tuturuuu/utils/constants';
+import { MIRA_TOOL_DIRECTORY } from './mira-tool-metadata';
+import type { MiraToolName } from './mira-tool-names';
+
+const normalize = (value: string) =>
+  value
+    .normalize('NFD')
+    .replace(/\p{Diacritic}/gu, '')
+    .toLowerCase()
+    .replace(/_/g, ' ');
+const matchesTerm = (word: string, term: string) =>
+  word.startsWith(term) || term === `${word}s`;
+const domains = {
+  tasks: {
+    keywords:
+      'task tasks board list label project assignee assign priority deadline cong viec nhiem vu nhan du an',
+    matches: /task|board|project/,
+    guidance:
+      'Discover board/list and member/label/project IDs before writes. Tasks require a list. Read a task before editing ambiguous fields. Use assignment tools for labels, projects, and people. Dates use the user timezone. Keep operations in the requested workspace; report the workspace and resulting task ID after creation.',
+  },
+  calendar: {
+    keywords:
+      'calendar event schedule scheduling google microsoft sync reclaim lock availability habit focus meeting lich dong bo su kien',
+    matches: /calendar|event|schedule|e2ee/,
+    guidance:
+      'Use existing connected accounts; an unconnected Google account needs user OAuth consent. Inspect sync health before retrying. Locked events must stay fixed. Preview scheduling before applying it; preserve hard commitments and explain conflicts. Use actual priorities, deadlines, availability, and durations, never invented free time.',
+  },
+  finance: {
+    keywords:
+      'finance wallet transaction money expense income currency category tag tai chinh vi giao dich',
+    matches: /wallet|transaction|spending|currency/,
+    guidance:
+      'Discover wallets and categories before writes. Positive amounts are income, negative amounts expenses. Keep currencies separate. Report actual tool outcomes and never infer a successful financial write from a visualization.',
+  },
+  time: {
+    keywords: 'time timer tracking goal hours duration thoi gian theo doi',
+    matches: /timer|time_track/,
+    guidance:
+      'Discover categories and sessions before edits. Respect the user timezone and running session state. Use history pagination and date filters to keep results small.',
+  },
+  memory: {
+    keywords:
+      'memory remember recall preference personality name settings nho so thich',
+    matches: /memor|recall|remember|settings|user_name/,
+    guidance:
+      'Recall relevant memories before personalization. Store durable preferences, not transient tool output. Behavior settings use update_my_settings; user naming uses update_user_name. Avoid duplicate memories.',
+  },
+  workspace: {
+    keywords:
+      'workspace member context sidebar artifact panel theme layout screen khong gian thanh ben giao dien',
+    matches: /workspace|sidebar|theme|immersive/,
+    guidance:
+      'Resolve named workspaces before operations. Opening artifacts fetches data in the UI, not in the model. Keep explanations in chat. Make each UI change once and finish after success. Replace a panel with close_artifact plus show_workspace_artifact; focus_artifact closes all other panels.',
+  },
+  creative: {
+    keywords:
+      'image qr file document convert markdown visualization render hinh anh tep tai lieu',
+    matches: /image|qr_code|convert_file|render_ui/,
+    guidance:
+      'Use Markdown for code, math, diagrams, and tables. Convert attached documents when their contents are needed. Google models receive YouTube URLs as video input; do not send YouTube links to file conversion. Use image generation only for requested images.',
+  },
+  research: {
+    keywords:
+      'search web current news weather research verify tim kiem tin tuc thoi tiet',
+    matches: /google_search|parallel_checks/,
+    guidance:
+      'Use web search for current external facts and cite sources. Use parallel checks for explicit deeper verification; summarize the results rather than dumping raw output.',
+  },
+} as const;
+
+export function searchMiraTools(
+  args: { query: string; limit?: number },
+  allowed?: ReadonlySet<string>
+) {
+  const query = normalize(args.query);
+  const terms = query
+    .split(/[^\p{L}\p{N}]+/u)
+    .filter((term) => term.length > 2);
+  const matchingDomains = Object.entries(domains).filter(([, domain]) =>
+    terms.some((term) =>
+      normalize(domain.keywords)
+        .split(' ')
+        .some((word) => word === term || term === `${word}s`)
+    )
+  );
+  const matches = (
+    Object.entries(MIRA_TOOL_DIRECTORY) as [MiraToolName, string][]
+  )
+    .filter(
+      ([name]) =>
+        !['search_tools', 'select_tools', 'no_action_needed'].includes(name) &&
+        (DEV_MODE || name !== 'render_ui') &&
+        (!allowed || allowed.has(name))
+    )
+    .map(([name, description]) => {
+      const words = normalize(`${name} ${description}`).split(
+        /[^\p{L}\p{N}]+/u
+      );
+      const nameWords = normalize(name).split(' ');
+      const score =
+        (normalize(name) === query ? 100 : 0) +
+        terms.reduce(
+          (total, term) =>
+            total +
+            (nameWords.some((word) => matchesTerm(word, term))
+              ? 6
+              : words.some((word) => matchesTerm(word, term))
+                ? 2
+                : 0),
+          0
+        ) +
+        matchingDomains.reduce(
+          (total, [, domain]) => total + (domain.matches.test(name) ? 1 : 0),
+          0
+        );
+      return { name, description, score };
+    })
+    .filter((entry) => entry.score > 0)
+    .sort((a, b) => b.score - a.score || a.name.localeCompare(b.name))
+    .slice(0, Math.min(8, Math.max(1, args.limit ?? 6)));
+  return {
+    ok: true,
+    selectedTools: matches.map(({ name }) => name),
+    matches: matches.map(({ name, description }) => ({ name, description })),
+    guidance: matchingDomains.map(([domain, { guidance }]) => ({
+      domain,
+      guidance,
+    })),
+    ...(matches.length
+      ? {
+          next: 'Use the activated tools. Search again only for a different operation or missing capability.',
+        }
+      : {
+          next: 'No matching authorized tools. Try a specific app or operation.',
+          domains: Object.keys(domains),
+        }),
+  };
+}

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

@@ -6,6 +6,7 @@ import {
   executeGetUpcomingEvents,
   executeUpdateEvent,
 } from './executors/calendar';
+import { executeCalendarAutomation } from './executors/calendar-automation';
 import { executeSetImmersiveMode } from './executors/chat';
 import {
   executeCreateTransactionCategory,
@@ -41,6 +42,7 @@ import { executeParallelChecks } from './executors/parallel-checks';
 import { executeCreateQrCode } from './executors/qr';
 import { executeGoogleSearch } from './executors/search';
 import { executeUpdateMySettings } from './executors/settings';
+import { executeGetTask, executeSearchTasks } from './executors/task-read';
 import {
   executeAddTaskAssignee,
   executeAddTaskLabels,
@@ -70,7 +72,12 @@ import {
   executeUpdateTaskLabel,
   executeUpdateTaskList,
 } from './executors/tasks';
-import { executeSetTheme } from './executors/theme';
+import {
+  executeManageWorkspace,
+  executeSetSidebar,
+  executeSetTheme,
+  executeShowWorkspaceArtifact,
+} from './executors/theme';
 import {
   executeCreateTimeTrackerGoal,
   executeCreateTimeTrackingCategory,
@@ -98,6 +105,7 @@ import {
   executeSetWorkspaceContext,
 } from './executors/workspace';
 import type { DefinedMiraToolName } from './mira-tool-definitions';
+import { searchMiraTools } from './mira-tool-discovery';
 import {
   buildRenderUiRecoverySpec,
   isRenderableRenderUiSpec,
@@ -111,12 +119,19 @@ type ToolHandler = (
 ) => Promise<unknown> | unknown;
 
 const toolHandlers = {
+  search_tools: (args) =>
+    searchMiraTools({
+      query: String(args.query ?? ''),
+      limit: typeof args.limit === 'number' ? args.limit : undefined,
+    }),
   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_task: executeGetTask,
+  search_tasks: executeSearchTasks,
   get_my_tasks: executeGetMyTasks,
   create_task: executeCreateTask,
   complete_task: executeCompleteTask,
@@ -145,6 +160,20 @@ const toolHandlers = {
   add_task_assignee: executeAddTaskAssignee,
   remove_task_assignee: executeRemoveTaskAssignee,
 
+  get_calendar_connections: (args, ctx) =>
+    executeCalendarAutomation('get_calendar_connections', args, ctx),
+  connect_google_calendar: (args, ctx) =>
+    executeCalendarAutomation('connect_google_calendar', args, ctx),
+  sync_calendar: (args, ctx) =>
+    executeCalendarAutomation('sync_calendar', args, ctx),
+  set_event_locked: (args, ctx) =>
+    executeCalendarAutomation('set_event_locked', args, ctx),
+  preview_calendar_schedule: (args, ctx) =>
+    executeCalendarAutomation('preview_calendar_schedule', args, ctx),
+  apply_calendar_schedule: (args, ctx) =>
+    executeCalendarAutomation('apply_calendar_schedule', args, ctx),
+  get_schedulable_tasks: (args, ctx) =>
+    executeCalendarAutomation('get_schedulable_tasks', args, ctx),
   get_upcoming_events: executeGetUpcomingEvents,
   create_event: executeCreateEvent,
   update_event: executeUpdateEvent,
@@ -205,6 +234,9 @@ const toolHandlers = {
   update_my_settings: executeUpdateMySettings,
   set_default_currency: executeSetDefaultCurrency,
   set_theme: executeSetTheme,
+  set_sidebar: executeSetSidebar,
+  manage_workspace: executeManageWorkspace,
+  show_workspace_artifact: executeShowWorkspaceArtifact,
   list_workspace_members: executeListWorkspaceMembers,
   update_user_name: executeUpdateUserName,
   set_immersive_mode: executeSetImmersiveMode,

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

@@ -2,7 +2,10 @@ 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',
+  select_tools: 'Activate a small working set of tools',
+  search_tools: 'Discover tools and domain guidance for an operation',
+  get_task: 'Read saved task details and location by ID',
+  search_tasks: 'Search tasks by title with pagination',
   get_my_tasks: 'Get your tasks by status (overdue, today, upcoming)',
   create_task: 'Create a new task',
   complete_task: 'Mark a task as completed',
@@ -30,6 +33,20 @@ export const MIRA_TOOL_DIRECTORY: Record<MiraToolName, string> = {
   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_calendar_connections:
+    'List linked external calendar accounts and their sync status',
+  connect_google_calendar:
+    'Start the Google Calendar OAuth connection flow for this workspace',
+  sync_calendar:
+    'Synchronize events with a connected external calendar in a given direction',
+  set_event_locked:
+    'Lock or unlock a calendar event so automatic scheduling cannot move it',
+  preview_calendar_schedule:
+    'Preview a proposed schedule for tasks without writing events',
+  apply_calendar_schedule:
+    'Apply a previously previewed schedule and create calendar events',
+  get_schedulable_tasks:
+    'List tasks eligible for automatic calendar scheduling',
   get_upcoming_events: 'Get calendar events for the next N days',
   create_event: 'Create a calendar event',
   update_event: 'Update a calendar event',
@@ -102,6 +119,10 @@ export const MIRA_TOOL_DIRECTORY: Record<MiraToolName, string> = {
   set_workspace_context:
     'Switch the current workspace context for task, calendar, and finance tools',
   update_my_settings: "Update the assistant's personality settings",
+  manage_workspace: 'Close, focus, or arrange the conversation workspace',
+  set_sidebar: 'Control navigation sidebar visibility and hover expansion',
+  show_workspace_artifact:
+    'Open tasks, calendar, finance, or meetings beside the chat',
   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).',
@@ -136,6 +157,13 @@ export const MIRA_TOOL_PERMISSIONS: Partial<
   remove_task_from_project: 'manage_projects',
   add_task_assignee: 'manage_projects',
   remove_task_assignee: 'manage_projects',
+  get_calendar_connections: 'manage_calendar',
+  connect_google_calendar: 'manage_calendar',
+  sync_calendar: 'manage_calendar',
+  set_event_locked: 'manage_calendar',
+  preview_calendar_schedule: 'manage_calendar',
+  apply_calendar_schedule: 'manage_calendar',
+  get_schedulable_tasks: 'manage_calendar',
   get_upcoming_events: 'manage_calendar',
   create_event: 'manage_calendar',
   update_event: 'manage_calendar',

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

@@ -1,5 +1,8 @@
 export const MIRA_TOOL_NAMES = [
   'select_tools',
+  'search_tools',
+  'get_task',
+  'search_tasks',
   'get_my_tasks',
   'create_task',
   'complete_task',
@@ -27,6 +30,13 @@ export const MIRA_TOOL_NAMES = [
   'remove_task_from_project',
   'add_task_assignee',
   'remove_task_assignee',
+  'get_calendar_connections',
+  'connect_google_calendar',
+  'sync_calendar',
+  'set_event_locked',
+  'preview_calendar_schedule',
+  'apply_calendar_schedule',
+  'get_schedulable_tasks',
   'get_upcoming_events',
   'create_event',
   'update_event',
@@ -84,6 +94,9 @@ export const MIRA_TOOL_NAMES = [
   'set_workspace_context',
   'update_my_settings',
   'set_theme',
+  'set_sidebar',
+  'show_workspace_artifact',
+  'manage_workspace',
   'render_ui',
   'list_workspace_members',
   'update_user_name',

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

@@ -1,4 +1,5 @@
 import type { TypedSupabaseClient } from '@tuturuuu/supabase/next/client';
+import type { PermissionId } from '@tuturuuu/types';
 import type { MiraWorkspaceContextState } from './workspace-context';
 
 export interface MiraToolContext {
@@ -9,6 +10,12 @@ export interface MiraToolContext {
   chatId?: string;
   supabase: TypedSupabaseClient;
   timezone?: string;
+  requestHeaders?: Pick<Headers, 'get'>;
+  executionState?: object;
+  authorizeWorkspaceTools?: (
+    wsId: string,
+    permissions: PermissionId[]
+  ) => Promise<boolean>;
   canReadUserGroupStorage?: (input: {
     groupId: string;
     storagePath: string;

package/src/tools/mira-tools.ts

@@ -2,7 +2,9 @@ import type { PermissionId } from '@tuturuuu/types';
 import { DEV_MODE } from '@tuturuuu/utils/constants';
 import type { Tool, ToolSet } from 'ai';
 import { createStreamRenderUiTool } from './definitions/render-ui';
+import { createTaskWriteGuard } from './mira-task-write-guard';
 import { miraToolDefinitions } from './mira-tool-definitions';
+import { searchMiraTools } from './mira-tool-discovery';
 import { executeMiraTool } from './mira-tool-dispatcher';
 import {
   MIRA_TOOL_DIRECTORY,
@@ -14,6 +16,7 @@ import {
   isRenderableRenderUiSpec,
 } from './mira-tool-render-ui';
 import type { MiraToolContext } from './mira-tool-types';
+import { getWorkspaceContextWorkspaceId } from './workspace-context';
 
 export type { MiraToolContext } from './mira-tool-types';
 export type { MiraToolName };
@@ -31,6 +34,9 @@ export function createMiraStreamTools(
 ): ToolSet {
   const tools: ToolSet = {};
   let renderUiInvalidAttempts = 0;
+  const permittedNames = new Set<string>();
+  const guardTaskWrite = createTaskWriteGuard();
+  ctx.executionState ??= {};
 
   // Create a per-stream render_ui tool with stateful preprocessor.
   // The preprocessor auto-populates a context-aware fallback on the first
@@ -63,7 +69,38 @@ export function createMiraStreamTools(
       }
     }
 
-    if (isMissingPermission) {
+    if (!isMissingPermission) permittedNames.add(name);
+
+    if (name === 'search_tools') {
+      tools[name] = {
+        ...def,
+        execute: async (args: { query: string; limit?: number }) => {
+          const workspaceId = getWorkspaceContextWorkspaceId(ctx);
+          const allowed = new Set<string>();
+          for (const candidate of Object.keys(
+            miraToolDefinitions
+          ) as MiraToolName[]) {
+            const permission = MIRA_TOOL_PERMISSIONS[candidate];
+            const required = permission
+              ? Array.isArray(permission)
+                ? permission
+                : [permission]
+              : [];
+            if (
+              ctx.authorizeWorkspaceTools
+                ? !required.length ||
+                  (await ctx.authorizeWorkspaceTools(workspaceId, required))
+                : permittedNames.has(candidate)
+            )
+              allowed.add(candidate);
+          }
+          return searchMiraTools(args, allowed);
+        },
+      } as Tool;
+      continue;
+    }
+
+    if (isMissingPermission && !ctx.authorizeWorkspaceTools) {
       tools[name] = {
         ...def,
         execute: async () => ({
@@ -159,7 +196,38 @@ export function createMiraStreamTools(
       execute: async (
         args: Record<string, unknown>,
         options?: { abortSignal?: AbortSignal }
-      ) => executeMiraTool(name, args, ctx, options),
+      ) => {
+        const executionCtx =
+          name === 'set_workspace_context'
+            ? ctx
+            : {
+                ...ctx,
+                workspaceContext: ctx.workspaceContext
+                  ? { ...ctx.workspaceContext }
+                  : undefined,
+              };
+        const targetWsId = getWorkspaceContextWorkspaceId(executionCtx);
+        const required = requiredPerm
+          ? Array.isArray(requiredPerm)
+            ? requiredPerm
+            : [requiredPerm]
+          : [];
+        if (
+          required.length &&
+          ctx.authorizeWorkspaceTools &&
+          !(await ctx.authorizeWorkspaceTools(targetWsId, required))
+        )
+          return {
+            success: false,
+            error:
+              'The current workspace does not grant permission for this operation.',
+          };
+        return name === 'create_task'
+          ? guardTaskWrite(targetWsId, args, () =>
+              executeMiraTool(name, args, executionCtx, options)
+            )
+          : executeMiraTool(name, args, executionCtx, options);
+      },
     } as Tool;
   }
 

package/src/workspace-artifacts.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+
+export const artifactKindSchema = z.enum([
+  'tasks',
+  'calendar',
+  'finance',
+  'meetings',
+]);
+export const artifactLayoutSchema = z.enum([
+  'auto',
+  'horizontal',
+  'vertical',
+  'grid',
+]);
+export const artifactPresentationSchema = z.object({
+  title: z.string().trim().min(1).max(80).optional(),
+  description: z.string().trim().max(240).optional(),
+  highlights: z.array(z.string().trim().min(1).max(160)).max(3).optional(),
+  search: z.string().trim().max(120).optional(),
+  taskStatus: z.enum(['all', 'overdue', 'today', 'upcoming']).optional(),
+  currency: z
+    .string()
+    .trim()
+    .max(8)
+    .toUpperCase()
+    .optional()
+    .describe('Finance only: ISO currency code'),
+  date: z.iso
+    .date()
+    .optional()
+    .describe('Calendar only: start the seven-day view on this local date'),
+  itemIds: z.array(z.string().min(1).max(80)).max(50).optional(),
+});
+export type ArtifactPresentation = z.infer<typeof artifactPresentationSchema>;
+export const showWorkspaceArtifactSchema = z.object({
+  kind: artifactKindSchema,
+  layout: artifactLayoutSchema.optional(),
+  presentation: artifactPresentationSchema.optional(),
+});
+export const manageWorkspaceSchema = z
+  .object({
+    operation: z.enum([
+      'close_artifact',
+      'close_all',
+      'focus_artifact',
+      'set_layout',
+    ]),
+    kind: artifactKindSchema.optional(),
+    layout: artifactLayoutSchema.optional(),
+  })
+  .refine(
+    (value) =>
+      value.operation === 'close_all' ||
+      (value.operation === 'set_layout' ? !!value.layout : !!value.kind),
+    {
+      message: 'Provide kind for artifact operations or layout for set_layout.',
+    }
+  );