@tuturuuu/ai 0.0.10

package/src/tools/definitions/time-tracking.ts

@@ -0,0 +1,381 @@
+import { z } from 'zod';
+import { tool } from '../core';
+
+const flexibleDateTimeInputSchema = z.string();
+
+export const timeTrackingToolDefinitions = {
+  start_timer: tool({
+    description:
+      'Start a time tracking session. Stops any currently running timer first.',
+    inputSchema: z.object({
+      title: z.string().describe('What are you working on?'),
+      description: z
+        .string()
+        .nullish()
+        .describe('Additional details, or null/omit'),
+    }),
+  }),
+
+  stop_timer: tool({
+    description: 'Stop the currently running time tracking session.',
+    inputSchema: z.object({
+      sessionId: z
+        .string()
+        .nullish()
+        .describe('Session UUID, or null/omit for active session'),
+    }),
+  }),
+
+  list_time_tracking_sessions: tool({
+    description:
+      'List your time tracking sessions with cursor pagination. By default pending approval sessions are excluded.',
+    inputSchema: z.object({
+      limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .describe('Page size (default 20, max 50)'),
+      cursor: z
+        .string()
+        .optional()
+        .describe('Pagination cursor from previous response (start_time|id)'),
+      includePending: z
+        .boolean()
+        .optional()
+        .describe('Whether to include pending approval sessions'),
+    }),
+  }),
+
+  get_time_tracking_session: tool({
+    description:
+      'Get one specific time tracking session by ID in the current workspace.',
+    inputSchema: z
+      .object({
+        sessionId: z.string().optional().describe('Session UUID'),
+        id: z
+          .string()
+          .optional()
+          .describe('Alias for sessionId. Use either sessionId or id.'),
+      })
+      .refine((data) => Boolean(data.sessionId || data.id), {
+        message: 'sessionId or id is required',
+        path: ['sessionId'],
+      }),
+  }),
+
+  create_time_tracking_entry: tool({
+    description:
+      'Create a manual (stopped) time tracking entry. If approval is required, it returns requiresApproval=true with next-step guidance for the user/UI to complete approval.',
+    inputSchema: z.object({
+      title: z.string().describe('Entry title'),
+      description: z
+        .string()
+        .nullish()
+        .describe('Entry description, or null/omit'),
+      categoryId: z
+        .string()
+        .nullish()
+        .describe('Time tracking category UUID, or null/omit'),
+      taskId: z.string().nullish().describe('Task UUID, or null/omit'),
+      startTime: flexibleDateTimeInputSchema.describe(
+        'Start time. Accepts ISO 8601, YYYY-MM-DD HH:mm, or HH:mm when date is provided'
+      ),
+      endTime: flexibleDateTimeInputSchema.describe(
+        'End time. Accepts ISO 8601, YYYY-MM-DD HH:mm, or HH:mm when date is provided'
+      ),
+      date: z
+        .string()
+        .optional()
+        .describe('Date anchor (YYYY-MM-DD) required when using HH:mm inputs'),
+    }),
+  }),
+
+  update_time_tracking_session: tool({
+    description:
+      'Update fields of an existing time tracking session. Recomputes duration when times change.',
+    inputSchema: z
+      .object({
+        sessionId: z.string().optional().describe('Session UUID'),
+        id: z
+          .string()
+          .optional()
+          .describe('Alias for sessionId. Use either sessionId or id.'),
+        title: z.string().optional().describe('Updated title'),
+        description: z
+          .string()
+          .nullable()
+          .optional()
+          .describe('Updated description'),
+        categoryId: z
+          .string()
+          .nullable()
+          .optional()
+          .describe('Updated category UUID'),
+        taskId: z.string().nullable().optional().describe('Updated task UUID'),
+        startTime: flexibleDateTimeInputSchema
+          .optional()
+          .describe(
+            'Updated start time. Accepts ISO 8601, YYYY-MM-DD HH:mm, or HH:mm when date is provided'
+          ),
+        endTime: flexibleDateTimeInputSchema
+          .optional()
+          .describe(
+            'Updated end time. Accepts ISO 8601, YYYY-MM-DD HH:mm, or HH:mm when date is provided'
+          ),
+        date: z
+          .string()
+          .optional()
+          .describe(
+            'Date anchor (YYYY-MM-DD) required when using HH:mm inputs'
+          ),
+      })
+      .refine((data) => Boolean(data.sessionId || data.id), {
+        message: 'sessionId or id is required',
+        path: ['sessionId'],
+      }),
+  }),
+
+  delete_time_tracking_session: tool({
+    description: 'Delete a time tracking session by ID.',
+    inputSchema: z
+      .object({
+        sessionId: z.string().optional().describe('Session UUID'),
+        id: z
+          .string()
+          .optional()
+          .describe('Alias for sessionId. Use either sessionId or id.'),
+      })
+      .refine((data) => Boolean(data.sessionId || data.id), {
+        message: 'sessionId or id is required',
+        path: ['sessionId'],
+      }),
+  }),
+
+  move_time_tracking_session: tool({
+    description:
+      'Move a stopped session to another workspace after membership checks, with category/task remapping by name.',
+    inputSchema: z
+      .object({
+        sessionId: z.string().optional().describe('Session UUID'),
+        id: z
+          .string()
+          .optional()
+          .describe('Alias for sessionId. Use either sessionId or id.'),
+        targetWorkspaceId: z.string().describe('Destination workspace UUID'),
+      })
+      .refine((data) => Boolean(data.sessionId || data.id), {
+        message: 'sessionId or id is required',
+        path: ['sessionId'],
+      }),
+  }),
+
+  get_time_tracker_stats: tool({
+    description:
+      'Get time-tracker summary stats (today/week/month/streak) and daily activity for insights.',
+    inputSchema: z.object({
+      timezone: z
+        .string()
+        .optional()
+        .describe(
+          'IANA timezone (defaults to your current chat timezone or UTC)'
+        ),
+      summaryOnly: z
+        .boolean()
+        .optional()
+        .describe('When true, skip daily activity history (default true)'),
+      daysBack: z
+        .number()
+        .int()
+        .min(1)
+        .max(3650)
+        .optional()
+        .describe(
+          'How many days of daily activity to include when summaryOnly=false (default 365)'
+        ),
+    }),
+  }),
+
+  get_time_tracker_goals: tool({
+    description:
+      'List your time-tracker goals (optionally including inactive goals) and computed daily/weekly progress.',
+    inputSchema: z.object({
+      includeInactive: z
+        .boolean()
+        .optional()
+        .describe('Include inactive goals (default false)'),
+      timezone: z
+        .string()
+        .optional()
+        .describe('IANA timezone used for progress calculations'),
+      includeProgress: z
+        .boolean()
+        .optional()
+        .describe(
+          'Include daily/weekly progress percentages using current stats (default true)'
+        ),
+    }),
+  }),
+
+  list_time_tracking_categories: tool({
+    description:
+      'List time-tracking categories in the current workspace so you can map category names to category IDs.',
+    inputSchema: z.object({
+      cursor: z
+        .string()
+        .optional()
+        .describe('Pagination cursor from previous response (name|id)'),
+      limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .describe('Page size (default 20, max 50)'),
+    }),
+  }),
+
+  create_time_tracking_category: tool({
+    description: 'Create a time-tracking category in the current workspace.',
+    inputSchema: z.object({
+      name: z.string().describe('Category name'),
+      description: z
+        .string()
+        .nullish()
+        .describe('Category description, or null/omit'),
+      color: z
+        .string()
+        .nullish()
+        .describe('Category color token, or null/omit (defaults to BLUE)'),
+    }),
+  }),
+
+  update_time_tracking_category: tool({
+    description: 'Update a time-tracking category by categoryId (or id alias).',
+    inputSchema: z
+      .object({
+        categoryId: z.string().optional().describe('Category UUID'),
+        id: z
+          .string()
+          .optional()
+          .describe('Alias for categoryId. Use either categoryId or id.'),
+        name: z.string().nullish().describe('Updated category name'),
+        description: z
+          .string()
+          .nullish()
+          .describe('Updated category description, or null to clear'),
+        color: z
+          .string()
+          .nullish()
+          .describe('Updated category color token, or null'),
+      })
+      .refine((data) => Boolean(data.categoryId || data.id), {
+        message: 'categoryId or id is required',
+        path: ['categoryId'],
+      })
+      .refine(
+        (data) =>
+          data.name !== undefined ||
+          data.description !== undefined ||
+          data.color !== undefined,
+        {
+          message: 'At least one updatable field is required',
+          path: ['name'],
+        }
+      ),
+  }),
+
+  delete_time_tracking_category: tool({
+    description: 'Delete a time-tracking category by categoryId (or id alias).',
+    inputSchema: z
+      .object({
+        categoryId: z.string().optional().describe('Category UUID'),
+        id: z
+          .string()
+          .optional()
+          .describe('Alias for categoryId. Use either categoryId or id.'),
+      })
+      .refine((data) => Boolean(data.categoryId || data.id), {
+        message: 'categoryId or id is required',
+        path: ['categoryId'],
+      }),
+  }),
+
+  create_time_tracker_goal: tool({
+    description:
+      'Create a new time-tracker goal for the current workspace/user.',
+    inputSchema: z.object({
+      categoryId: z
+        .string()
+        .nullish()
+        .describe(
+          'Time tracking category UUID. Use "general", null, or omit for non-category goal.'
+        ),
+      dailyGoalMinutes: z
+        .number()
+        .int()
+        .min(1)
+        .describe('Required daily target in minutes (must be > 0)'),
+      weeklyGoalMinutes: z
+        .number()
+        .int()
+        .min(1)
+        .nullish()
+        .describe('Optional weekly target in minutes. Use null/omit to clear'),
+      isActive: z.boolean().optional().describe('Whether goal is active'),
+    }),
+  }),
+
+  update_time_tracker_goal: tool({
+    description:
+      'Update an existing time-tracker goal by goalId (or id alias).',
+    inputSchema: z
+      .object({
+        goalId: z.string().optional().describe('Goal UUID'),
+        id: z
+          .string()
+          .optional()
+          .describe('Alias for goalId. Use either goalId or id.'),
+        categoryId: z
+          .string()
+          .nullish()
+          .describe(
+            'Time tracking category UUID. Use "general", null, or empty to clear.'
+          ),
+        dailyGoalMinutes: z
+          .number()
+          .int()
+          .min(1)
+          .optional()
+          .describe('Updated daily target in minutes (must be > 0)'),
+        weeklyGoalMinutes: z
+          .number()
+          .int()
+          .min(1)
+          .nullish()
+          .describe('Updated weekly target in minutes. Use null/omit to clear'),
+        isActive: z.boolean().optional().describe('Updated active flag'),
+      })
+      .refine((data) => Boolean(data.goalId || data.id), {
+        message: 'goalId or id is required',
+        path: ['goalId'],
+      }),
+  }),
+
+  delete_time_tracker_goal: tool({
+    description: 'Delete a time-tracker goal by goalId (or id alias).',
+    inputSchema: z
+      .object({
+        goalId: z.string().optional().describe('Goal UUID'),
+        id: z
+          .string()
+          .optional()
+          .describe('Alias for goalId. Use either goalId or id.'),
+      })
+      .refine((data) => Boolean(data.goalId || data.id), {
+        message: 'goalId or id is required',
+        path: ['goalId'],
+      }),
+  }),
+} as const;

package/src/tools/definitions/workspace-context.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { tool } from '../core';
+
+export const workspaceContextToolDefinitions = {
+  list_accessible_workspaces: tool({
+    description:
+      'List all workspaces the user can access, including member counts. Use this before switching workspace context.',
+    inputSchema: z.object({}),
+  }),
+
+  get_workspace_context: tool({
+    description:
+      'Show the current workspace context used for personal task, calendar, and finance queries. Defaults to the personal workspace.',
+    inputSchema: z.object({}),
+  }),
+
+  set_workspace_context: tool({
+    description:
+      'Switch the current workspace context for task, calendar, and finance tools. Use `list_accessible_workspaces` first to get the target workspace ID. Use `personal` to switch back to the personal workspace.',
+    inputSchema: z
+      .object({
+        workspaceId: z
+          .string()
+          .trim()
+          .min(1)
+          .optional()
+          .describe('Target workspace ID, `internal`, or `personal`.'),
+        workspaceContextId: z
+          .string()
+          .trim()
+          .min(1)
+          .optional()
+          .describe(
+            'Alias for workspaceId. Accepts a workspace UUID, `internal`, or `personal`.'
+          ),
+      })
+      .refine(
+        (value) => Boolean(value.workspaceId || value.workspaceContextId),
+        {
+          message: 'workspaceId is required.',
+          path: ['workspaceId'],
+        }
+      ),
+  }),
+} as const;

package/src/tools/definitions/workspace-user-chat.ts

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+import { tool } from '../core';
+
+type SettingsLikeData = {
+  name?: unknown;
+  tone?: unknown;
+  personality?: unknown;
+  boundaries?: unknown;
+  vibe?: unknown;
+  chat_tone?: unknown;
+  displayName?: unknown;
+  fullName?: unknown;
+};
+
+const hasAtLeastOneFieldProvided = (data: SettingsLikeData): boolean =>
+  [
+    data.name,
+    data.tone,
+    data.personality,
+    data.boundaries,
+    data.vibe,
+    data.chat_tone,
+    data.displayName,
+    data.fullName,
+  ].some((value) => value !== null && value !== undefined);
+
+export const workspaceUserChatToolDefinitions = {
+  update_my_settings: tool({
+    description:
+      "Update YOUR OWN (the assistant's) personality. The `name` field is YOUR name, not the user's. Use `remember` for user's name.",
+    inputSchema: z
+      .object({
+        name: z.string().max(50).nullish().describe('New assistant name'),
+        tone: z
+          .enum([
+            'balanced',
+            'casual',
+            'formal',
+            'friendly',
+            'playful',
+            'professional',
+            'warm',
+          ])
+          .nullish()
+          .describe('Communication tone'),
+        personality: z
+          .string()
+          .max(2000)
+          .nullish()
+          .describe('Personality description / behavioral preferences'),
+        boundaries: z
+          .string()
+          .max(2000)
+          .nullish()
+          .describe('Custom boundaries'),
+        vibe: z
+          .enum([
+            'calm',
+            'energetic',
+            'friendly',
+            'neutral',
+            'playful',
+            'warm',
+            'witty',
+          ])
+          .nullish()
+          .describe('Energy/vibe'),
+        chat_tone: z
+          .enum(['thorough', 'concise', 'detailed', 'brief'])
+          .nullish()
+          .describe('Response verbosity'),
+      })
+      .refine((data) => hasAtLeastOneFieldProvided(data), {
+        message: 'At least one field must be provided',
+      }),
+  }),
+
+  set_theme: tool({
+    description:
+      'Switch the UI theme. Use when user asks for dark mode, light mode, or system theme.',
+    inputSchema: z.object({
+      theme: z.enum(['light', 'dark', 'system']).describe('Theme to apply'),
+    }),
+  }),
+
+  list_workspace_members: tool({
+    description:
+      'List all members of the current workspace context from `workspace_members`. Use `get_workspace_context` to inspect the active workspace first, and `list_accessible_workspaces` + `set_workspace_context` when the user names another workspace.',
+    inputSchema: z.object({}),
+  }),
+
+  update_user_name: tool({
+    description: "Update the user's display name or full name.",
+    inputSchema: z
+      .object({
+        displayName: z.string().nullish().describe('New display name'),
+        fullName: z.string().nullish().describe('New full name'),
+      })
+      .refine((data) => hasAtLeastOneFieldProvided(data), {
+        message: 'At least one field must be provided',
+      }),
+  }),
+
+  set_immersive_mode: tool({
+    description:
+      'Enter or exit immersive fullscreen mode for the current chat.',
+    inputSchema: z.object({
+      enabled: z.boolean().describe('Whether to enable immersive mode'),
+    }),
+  }),
+} as const;