@agenticmail/enterprise 0.3.2 → 0.4.0

package/src/engine/skills/enterprise-translation.ts

@@ -0,0 +1,111 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'enterprise-translation',
+  name: 'Translation & Localization',
+  description: 'Translate text, documents, and content between languages with enterprise terminology awareness. Supports translation memory, glossaries, and domain-specific translations (legal, medical, technical).',
+  category: 'productivity',
+  risk: 'low',
+  icon: '🌍',
+  source: 'builtin',
+  version: '1.0.0',
+  author: 'AgenticMail',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  {
+    id: 'ent_translate_text',
+    name: 'Translate Text',
+    description: 'Translate text from one language to another. Supports 100+ language pairs with context-aware translation that preserves formatting and tone.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-translation',
+    sideEffects: ['network-request'],
+    parameters: {
+      type: 'object',
+      properties: {
+        text: { type: 'string', description: 'Text to translate' },
+        targetLanguage: { type: 'string', description: 'Target language code (e.g., "fr", "de", "ja", "zh", "es")' },
+        sourceLanguage: { type: 'string', description: 'Source language (auto-detected if omitted)' },
+        domain: { type: 'string', enum: ['general', 'legal', 'medical', 'technical', 'financial', 'marketing'], description: 'Translation domain for terminology', default: 'general' },
+        formality: { type: 'string', enum: ['formal', 'informal', 'auto'], default: 'auto' },
+        glossary: { type: 'object', description: 'Custom term mappings (e.g., {"AgenticMail": "AgenticMail"} to preserve brand names)' },
+      },
+      required: ['text', 'targetLanguage'],
+    },
+  },
+  {
+    id: 'ent_translate_document',
+    name: 'Translate Document',
+    description: 'Translate an entire document file while preserving formatting. Supports PDF, DOCX, HTML, TXT, and SRT subtitle files.',
+    category: 'write',
+    risk: 'medium',
+    skillId: 'enterprise-translation',
+    sideEffects: ['network-request', 'modifies-files'],
+    parameters: {
+      type: 'object',
+      properties: {
+        inputPath: { type: 'string', description: 'Input document path' },
+        outputPath: { type: 'string', description: 'Output document path' },
+        targetLanguage: { type: 'string' },
+        sourceLanguage: { type: 'string' },
+        domain: { type: 'string', enum: ['general', 'legal', 'medical', 'technical', 'financial'], default: 'general' },
+      },
+      required: ['inputPath', 'outputPath', 'targetLanguage'],
+    },
+  },
+  {
+    id: 'ent_translate_detect',
+    name: 'Detect Language',
+    description: 'Detect the language of a given text. Returns language code, name, confidence score, and alternative possibilities.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-translation',
+    sideEffects: [],
+    parameters: {
+      type: 'object',
+      properties: {
+        text: { type: 'string', description: 'Text to analyze' },
+      },
+      required: ['text'],
+    },
+  },
+  {
+    id: 'ent_translate_batch',
+    name: 'Batch Translate',
+    description: 'Translate multiple text strings in a single call. Efficient for translating UI labels, product descriptions, or form fields.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-translation',
+    sideEffects: ['network-request'],
+    parameters: {
+      type: 'object',
+      properties: {
+        texts: { type: 'array', items: { type: 'string' }, description: 'Array of strings to translate' },
+        targetLanguage: { type: 'string' },
+        sourceLanguage: { type: 'string' },
+      },
+      required: ['texts', 'targetLanguage'],
+    },
+  },
+  {
+    id: 'ent_translate_localize',
+    name: 'Localize Content',
+    description: 'Adapt content for a target locale beyond translation: adjust date formats, currency symbols, number formatting, units of measurement, and cultural references.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-translation',
+    sideEffects: ['network-request'],
+    parameters: {
+      type: 'object',
+      properties: {
+        text: { type: 'string', description: 'Content to localize' },
+        targetLocale: { type: 'string', description: 'Target locale (e.g., "fr-FR", "de-DE", "ja-JP")' },
+        adaptDates: { type: 'boolean', default: true },
+        adaptCurrency: { type: 'boolean', default: true },
+        adaptUnits: { type: 'boolean', default: true },
+      },
+      required: ['text', 'targetLocale'],
+    },
+  },
+];

package/src/engine/skills/enterprise-vision.ts

@@ -0,0 +1,107 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'enterprise-vision',
+  name: 'Image & Screenshot Analysis',
+  description: 'Analyze images, screenshots, and visual content. Describe what is in an image, read text from screenshots, identify UI elements, detect objects, and extract visual data for reports and documentation.',
+  category: 'data',
+  risk: 'low',
+  icon: '👁️',
+  source: 'builtin',
+  version: '1.0.0',
+  author: 'AgenticMail',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  {
+    id: 'ent_vision_describe',
+    name: 'Describe Image',
+    description: 'Generate a detailed description of an image including objects, people, text, colors, layout, and context. Useful for accessibility, documentation, and content analysis.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-vision',
+    sideEffects: [],
+    parameters: {
+      type: 'object',
+      properties: {
+        imagePath: { type: 'string', description: 'Path to image file or URL' },
+        detail: { type: 'string', enum: ['brief', 'detailed', 'exhaustive'], default: 'detailed' },
+        focus: { type: 'string', description: 'What to focus on (e.g., "text content", "UI elements", "people", "data")' },
+      },
+      required: ['imagePath'],
+    },
+  },
+  {
+    id: 'ent_vision_read_text',
+    name: 'Read Text from Image',
+    description: 'Extract all visible text from an image or screenshot. More specialized than OCR — understands layout, columns, headers, and reading order.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-vision',
+    sideEffects: [],
+    parameters: {
+      type: 'object',
+      properties: {
+        imagePath: { type: 'string', description: 'Path to image file' },
+        region: { type: 'object', properties: { x: { type: 'number' }, y: { type: 'number' }, width: { type: 'number' }, height: { type: 'number' } }, description: 'Specific region to read (optional)' },
+        language: { type: 'string', default: 'en' },
+      },
+      required: ['imagePath'],
+    },
+  },
+  {
+    id: 'ent_vision_analyze_ui',
+    name: 'Analyze UI Screenshot',
+    description: 'Analyze a UI screenshot to identify interactive elements (buttons, inputs, links, menus), layout structure, and potential usability issues. Useful for QA and support.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-vision',
+    sideEffects: [],
+    parameters: {
+      type: 'object',
+      properties: {
+        imagePath: { type: 'string', description: 'Path to UI screenshot' },
+        platform: { type: 'string', enum: ['web', 'mobile-ios', 'mobile-android', 'desktop', 'auto'], default: 'auto' },
+        findElement: { type: 'string', description: 'Specific element to locate (e.g., "login button", "search field")' },
+      },
+      required: ['imagePath'],
+    },
+  },
+  {
+    id: 'ent_vision_extract_chart',
+    name: 'Extract Chart Data',
+    description: 'Extract data from charts and graphs in images: bar charts, line charts, pie charts. Returns the underlying data values and labels.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-vision',
+    sideEffects: [],
+    parameters: {
+      type: 'object',
+      properties: {
+        imagePath: { type: 'string', description: 'Path to image containing chart' },
+        chartType: { type: 'string', enum: ['auto', 'bar', 'line', 'pie', 'scatter', 'table'], default: 'auto' },
+        format: { type: 'string', enum: ['json', 'csv', 'markdown'], default: 'json' },
+      },
+      required: ['imagePath'],
+    },
+  },
+  {
+    id: 'ent_vision_compare',
+    name: 'Compare Images',
+    description: 'Compare two images and highlight visual differences. Useful for QA screenshot comparison, design review, and document change detection.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-vision',
+    sideEffects: ['modifies-files'],
+    parameters: {
+      type: 'object',
+      properties: {
+        image1: { type: 'string', description: 'Path to first image' },
+        image2: { type: 'string', description: 'Path to second image' },
+        outputPath: { type: 'string', description: 'Path to save diff image highlighting changes' },
+        threshold: { type: 'number', description: 'Pixel difference threshold (0-255)', default: 10 },
+      },
+      required: ['image1', 'image2'],
+    },
+  },
+];

package/src/engine/skills/enterprise-web-research.ts

@@ -0,0 +1,114 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'enterprise-web-research',
+  name: 'Web Research & Scraping',
+  description: 'Research topics on the web, scrape structured data from public websites, monitor web pages for changes, and extract specific data points. Respects robots.txt and rate limits.',
+  category: 'research',
+  risk: 'medium',
+  icon: '🌐',
+  source: 'builtin',
+  version: '1.0.0',
+  author: 'AgenticMail',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  {
+    id: 'ent_web_search',
+    name: 'Web Search',
+    description: 'Search the web for information on any topic. Returns ranked results with titles, URLs, snippets, and publication dates.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-web-research',
+    sideEffects: ['network-request'],
+    parameters: {
+      type: 'object',
+      properties: {
+        query: { type: 'string', description: 'Search query' },
+        maxResults: { type: 'number', default: 10 },
+        dateRestrict: { type: 'string', enum: ['day', 'week', 'month', 'year'], description: 'Limit to recent results' },
+        site: { type: 'string', description: 'Restrict search to a specific domain' },
+        language: { type: 'string', default: 'en' },
+      },
+      required: ['query'],
+    },
+  },
+  {
+    id: 'ent_web_scrape',
+    name: 'Scrape Web Page',
+    description: 'Extract content from a web page. Returns clean text, structured data (tables, lists), metadata (title, description, author), and links. Renders JavaScript if needed.',
+    category: 'read',
+    risk: 'medium',
+    skillId: 'enterprise-web-research',
+    sideEffects: ['network-request'],
+    parameters: {
+      type: 'object',
+      properties: {
+        url: { type: 'string', description: 'URL to scrape' },
+        selector: { type: 'string', description: 'CSS selector to extract specific elements (e.g., "article", ".price", "table")' },
+        format: { type: 'string', enum: ['markdown', 'text', 'html', 'json'], default: 'markdown' },
+        waitForSelector: { type: 'string', description: 'CSS selector to wait for before extraction (for JS-rendered pages)' },
+        extractLinks: { type: 'boolean', default: false },
+        extractImages: { type: 'boolean', default: false },
+      },
+      required: ['url'],
+    },
+  },
+  {
+    id: 'ent_web_extract_data',
+    name: 'Extract Structured Data',
+    description: 'Extract structured data from a web page using AI. Define what data points you want (e.g., product name, price, rating) and get back a clean JSON object.',
+    category: 'read',
+    risk: 'medium',
+    skillId: 'enterprise-web-research',
+    sideEffects: ['network-request'],
+    parameters: {
+      type: 'object',
+      properties: {
+        url: { type: 'string', description: 'URL to extract from' },
+        fields: { type: 'array', items: { type: 'object', properties: { name: { type: 'string' }, description: { type: 'string' }, type: { type: 'string', enum: ['string', 'number', 'boolean', 'array', 'date'] } } }, description: 'Data fields to extract' },
+        multiple: { type: 'boolean', description: 'Extract multiple items (e.g., all products on a page)', default: false },
+      },
+      required: ['url', 'fields'],
+    },
+  },
+  {
+    id: 'ent_web_monitor',
+    name: 'Monitor Web Page',
+    description: 'Set up monitoring for a web page to detect changes. Checks periodically and reports when content at a specific selector changes.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-web-research',
+    sideEffects: ['network-request'],
+    parameters: {
+      type: 'object',
+      properties: {
+        url: { type: 'string', description: 'URL to monitor' },
+        selector: { type: 'string', description: 'CSS selector for the content to watch' },
+        checkInterval: { type: 'string', enum: ['hourly', 'daily', 'weekly'], default: 'daily' },
+        notifyOnChange: { type: 'boolean', default: true },
+      },
+      required: ['url'],
+    },
+  },
+  {
+    id: 'ent_web_screenshot',
+    name: 'Take Screenshot',
+    description: 'Capture a screenshot of a web page. Supports full-page capture, specific element capture, and custom viewport sizes.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-web-research',
+    sideEffects: ['network-request', 'modifies-files'],
+    parameters: {
+      type: 'object',
+      properties: {
+        url: { type: 'string', description: 'URL to screenshot' },
+        outputPath: { type: 'string', description: 'Output image path' },
+        fullPage: { type: 'boolean', default: false },
+        selector: { type: 'string', description: 'Capture specific element only' },
+        viewport: { type: 'object', properties: { width: { type: 'number', default: 1280 }, height: { type: 'number', default: 720 } } },
+      },
+      required: ['url', 'outputPath'],
+    },
+  },
+];

package/src/engine/skills/enterprise-workflow.ts

@@ -0,0 +1,109 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'enterprise-workflow',
+  name: 'Approval Workflow',
+  description: 'Request human approvals, route decisions to the right approvers based on rules, track approval status, and escalate when deadlines are missed. Integrates with org hierarchy for multi-level approvals.',
+  category: 'collaboration',
+  risk: 'medium',
+  icon: '✅',
+  source: 'builtin',
+  version: '1.0.0',
+  author: 'AgenticMail',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  {
+    id: 'ent_wf_request_approval',
+    name: 'Request Approval',
+    description: 'Submit a request for human approval. Sends notification to approvers and tracks the response. Supports multiple approvers, approval chains, and deadline-based escalation.',
+    category: 'communicate',
+    risk: 'medium',
+    skillId: 'enterprise-workflow',
+    sideEffects: ['sends-email', 'sends-message'],
+    parameters: {
+      type: 'object',
+      properties: {
+        title: { type: 'string', description: 'Brief title of what needs approval' },
+        description: { type: 'string', description: 'Detailed description with context for the approver' },
+        approvers: { type: 'array', items: { type: 'string' }, description: 'Email addresses of approvers' },
+        approvalType: { type: 'string', enum: ['any', 'all', 'chain'], description: 'any=first approver wins, all=everyone must approve, chain=sequential approval', default: 'any' },
+        priority: { type: 'string', enum: ['low', 'normal', 'high', 'urgent'], default: 'normal' },
+        deadline: { type: 'string', description: 'ISO 8601 deadline for response' },
+        escalateTo: { type: 'string', description: 'Email to escalate to if deadline passes' },
+        attachments: { type: 'array', items: { type: 'string' }, description: 'File paths to attach as supporting documents' },
+        actions: { type: 'array', items: { type: 'object', properties: { label: { type: 'string' }, value: { type: 'string' } } }, description: 'Custom action buttons (default: Approve/Reject)' },
+        metadata: { type: 'object', description: 'Custom data stored with the request' },
+      },
+      required: ['title', 'description', 'approvers'],
+    },
+  },
+  {
+    id: 'ent_wf_check_status',
+    name: 'Check Approval Status',
+    description: 'Check the status of a pending approval request. Returns current state, who has responded, and time remaining.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-workflow',
+    sideEffects: [],
+    parameters: {
+      type: 'object',
+      properties: {
+        requestId: { type: 'string', description: 'Approval request ID' },
+      },
+      required: ['requestId'],
+    },
+  },
+  {
+    id: 'ent_wf_list_pending',
+    name: 'List Pending Approvals',
+    description: 'List all pending approval requests that are awaiting response, either submitted by this agent or assigned to specific approvers.',
+    category: 'read',
+    risk: 'low',
+    skillId: 'enterprise-workflow',
+    sideEffects: [],
+    parameters: {
+      type: 'object',
+      properties: {
+        submittedBy: { type: 'string', description: 'Filter by submitter' },
+        assignedTo: { type: 'string', description: 'Filter by approver' },
+        status: { type: 'string', enum: ['pending', 'approved', 'rejected', 'expired', 'all'], default: 'pending' },
+        limit: { type: 'number', default: 20 },
+      },
+    },
+  },
+  {
+    id: 'ent_wf_cancel',
+    name: 'Cancel Approval Request',
+    description: 'Cancel a pending approval request. Notifies approvers that the request has been withdrawn.',
+    category: 'write',
+    risk: 'low',
+    skillId: 'enterprise-workflow',
+    sideEffects: ['sends-message'],
+    parameters: {
+      type: 'object',
+      properties: {
+        requestId: { type: 'string' },
+        reason: { type: 'string', description: 'Reason for cancellation' },
+      },
+      required: ['requestId'],
+    },
+  },
+  {
+    id: 'ent_wf_remind',
+    name: 'Send Approval Reminder',
+    description: 'Send a reminder to approvers who have not yet responded to a pending request.',
+    category: 'communicate',
+    risk: 'low',
+    skillId: 'enterprise-workflow',
+    sideEffects: ['sends-email', 'sends-message'],
+    parameters: {
+      type: 'object',
+      properties: {
+        requestId: { type: 'string' },
+        message: { type: 'string', description: 'Custom reminder message' },
+      },
+      required: ['requestId'],
+    },
+  },
+];

package/src/engine/skills/gws-admin.ts

@@ -0,0 +1,17 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'gws-admin',
+  name: 'Google Admin',
+  description: 'User management, security, device management, and organization settings.',
+  category: 'platform',
+  risk: 'critical',
+  icon: '⚙️',
+  source: 'builtin',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  { id: 'gws_admin_users', name: 'Manage Users', description: 'List/create/update Workspace users', category: 'write', risk: 'critical', skillId: 'gws-admin', sideEffects: [] },
+  { id: 'gws_admin_groups', name: 'Manage Groups', description: 'Create/manage Google groups', category: 'write', risk: 'high', skillId: 'gws-admin', sideEffects: [] },
+  { id: 'gws_admin_orgunits', name: 'Manage Org Units', description: 'Manage organizational units', category: 'write', risk: 'high', skillId: 'gws-admin', sideEffects: [] },
+];

package/src/engine/skills/gws-calendar.ts

@@ -0,0 +1,19 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'gws-calendar',
+  name: 'Google Calendar',
+  description: 'Events, scheduling, availability, room booking, and calendar sharing.',
+  category: 'productivity',
+  risk: 'low',
+  icon: '📅',
+  source: 'builtin',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  { id: 'gws_cal_list', name: 'List Events', description: 'List Google Calendar events', category: 'read', risk: 'low', skillId: 'gws-calendar', sideEffects: [] },
+  { id: 'gws_cal_create', name: 'Create Event', description: 'Create calendar event', category: 'write', risk: 'medium', skillId: 'gws-calendar', sideEffects: ['sends-email'] },
+  { id: 'gws_cal_update', name: 'Update Event', description: 'Update calendar event', category: 'write', risk: 'medium', skillId: 'gws-calendar', sideEffects: [] },
+  { id: 'gws_cal_delete', name: 'Delete Event', description: 'Delete calendar event', category: 'destroy', risk: 'medium', skillId: 'gws-calendar', sideEffects: ['deletes-data'] },
+  { id: 'gws_cal_freebusy', name: 'Check Availability', description: 'Check free/busy status', category: 'read', risk: 'low', skillId: 'gws-calendar', sideEffects: [] },
+];

package/src/engine/skills/gws-chat.ts

@@ -0,0 +1,16 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'gws-chat',
+  name: 'Google Chat',
+  description: 'Messaging, spaces, threads, and bot integrations.',
+  category: 'collaboration',
+  risk: 'medium',
+  icon: '💬',
+  source: 'builtin',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  { id: 'gws_chat_send', name: 'Send Chat', description: 'Send Google Chat message', category: 'communicate', risk: 'medium', skillId: 'gws-chat', sideEffects: ['sends-message'] },
+  { id: 'gws_chat_spaces', name: 'List Spaces', description: 'List Chat spaces', category: 'read', risk: 'low', skillId: 'gws-chat', sideEffects: [] },
+];

package/src/engine/skills/gws-docs.ts

@@ -0,0 +1,17 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'gws-docs',
+  name: 'Google Docs',
+  description: 'Collaborative document editing, comments, suggestions, and templates.',
+  category: 'productivity',
+  risk: 'low',
+  icon: '📄',
+  source: 'builtin',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  { id: 'gws_docs_create', name: 'Create Doc', description: 'Create Google Doc', category: 'write', risk: 'low', skillId: 'gws-docs', sideEffects: ['modifies-files'] },
+  { id: 'gws_docs_edit', name: 'Edit Doc', description: 'Edit Google Doc content', category: 'write', risk: 'low', skillId: 'gws-docs', sideEffects: ['modifies-files'] },
+  { id: 'gws_docs_read', name: 'Read Doc', description: 'Read Google Doc content', category: 'read', risk: 'low', skillId: 'gws-docs', sideEffects: [] },
+];

package/src/engine/skills/gws-drive.ts

@@ -0,0 +1,20 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'gws-drive',
+  name: 'Google Drive',
+  description: 'Cloud storage, file sharing, permissions, and team drives.',
+  category: 'storage',
+  risk: 'medium',
+  icon: '💾',
+  source: 'builtin',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  { id: 'gws_drive_list', name: 'List Files', description: 'List Google Drive files', category: 'read', risk: 'low', skillId: 'gws-drive', sideEffects: [] },
+  { id: 'gws_drive_upload', name: 'Upload File', description: 'Upload file to Drive', category: 'write', risk: 'medium', skillId: 'gws-drive', sideEffects: ['modifies-files'] },
+  { id: 'gws_drive_download', name: 'Download File', description: 'Download file from Drive', category: 'read', risk: 'low', skillId: 'gws-drive', sideEffects: [] },
+  { id: 'gws_drive_share', name: 'Share File', description: 'Share Drive file/folder', category: 'write', risk: 'medium', skillId: 'gws-drive', sideEffects: [] },
+  { id: 'gws_drive_delete', name: 'Delete File', description: 'Delete Drive file', category: 'destroy', risk: 'medium', skillId: 'gws-drive', sideEffects: ['deletes-data'] },
+  { id: 'gws_drive_search', name: 'Search Drive', description: 'Search files in Drive', category: 'read', risk: 'low', skillId: 'gws-drive', sideEffects: [] },
+];

package/src/engine/skills/gws-forms.ts

@@ -0,0 +1,16 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'gws-forms',
+  name: 'Google Forms',
+  description: 'Surveys, quizzes, and response collection.',
+  category: 'productivity',
+  risk: 'low',
+  icon: '📋',
+  source: 'builtin',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  { id: 'gws_forms_create', name: 'Create Form', description: 'Create Google Form', category: 'write', risk: 'low', skillId: 'gws-forms', sideEffects: [] },
+  { id: 'gws_forms_responses', name: 'Get Responses', description: 'Get form responses', category: 'read', risk: 'low', skillId: 'gws-forms', sideEffects: [] },
+];

package/src/engine/skills/gws-gmail.ts

@@ -0,0 +1,20 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'gws-gmail',
+  name: 'Gmail',
+  description: 'Google email — send, receive, labels, filters, and smart compose.',
+  category: 'communication',
+  risk: 'medium',
+  icon: '✉️',
+  source: 'builtin',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  { id: 'gws_gmail_send', name: 'Send Email', description: 'Send email via Gmail', category: 'communicate', risk: 'high', skillId: 'gws-gmail', sideEffects: ['sends-email'] },
+  { id: 'gws_gmail_read', name: 'Read Email', description: 'Read Gmail messages', category: 'read', risk: 'low', skillId: 'gws-gmail', sideEffects: [] },
+  { id: 'gws_gmail_search', name: 'Search Gmail', description: 'Search Gmail with queries', category: 'read', risk: 'low', skillId: 'gws-gmail', sideEffects: [] },
+  { id: 'gws_gmail_labels', name: 'Manage Labels', description: 'Create/edit Gmail labels', category: 'write', risk: 'low', skillId: 'gws-gmail', sideEffects: [] },
+  { id: 'gws_gmail_filters', name: 'Manage Filters', description: 'Create/edit Gmail filters', category: 'write', risk: 'medium', skillId: 'gws-gmail', sideEffects: [] },
+  { id: 'gws_gmail_delete', name: 'Delete Email', description: 'Delete Gmail message', category: 'destroy', risk: 'medium', skillId: 'gws-gmail', sideEffects: ['deletes-data'] },
+];

package/src/engine/skills/gws-groups.ts

@@ -0,0 +1,16 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'gws-groups',
+  name: 'Google Groups',
+  description: 'Mailing lists, access groups, and group management.',
+  category: 'communication',
+  risk: 'low',
+  icon: '👥',
+  source: 'builtin',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  { id: 'gws_groups_create', name: 'Create Group', description: 'Create Google Group', category: 'write', risk: 'medium', skillId: 'gws-groups', sideEffects: [] },
+  { id: 'gws_groups_members', name: 'Manage Members', description: 'Add/remove group members', category: 'write', risk: 'medium', skillId: 'gws-groups', sideEffects: [] },
+];

package/src/engine/skills/gws-keep.ts

@@ -0,0 +1,16 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'gws-keep',
+  name: 'Google Keep',
+  description: 'Notes, lists, reminders, and labels.',
+  category: 'productivity',
+  risk: 'low',
+  icon: '📌',
+  source: 'builtin',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  { id: 'gws_keep_create', name: 'Create Note', description: 'Create Google Keep note', category: 'write', risk: 'low', skillId: 'gws-keep', sideEffects: [] },
+  { id: 'gws_keep_list', name: 'List Notes', description: 'List Google Keep notes', category: 'read', risk: 'low', skillId: 'gws-keep', sideEffects: [] },
+];

package/src/engine/skills/gws-meet.ts

@@ -0,0 +1,16 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'gws-meet',
+  name: 'Google Meet',
+  description: 'Video conferencing, screen sharing, recording, and breakout rooms.',
+  category: 'collaboration',
+  risk: 'medium',
+  icon: '📹',
+  source: 'builtin',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  { id: 'gws_meet_create', name: 'Create Meeting', description: 'Create Google Meet link', category: 'write', risk: 'low', skillId: 'gws-meet', sideEffects: [] },
+  { id: 'gws_meet_list', name: 'List Recordings', description: 'List Meet recordings', category: 'read', risk: 'low', skillId: 'gws-meet', sideEffects: [] },
+];

package/src/engine/skills/gws-sheets.ts

@@ -0,0 +1,18 @@
+import type { SkillDefinition, ToolDefinition } from '../skills.js';
+
+export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
+  id: 'gws-sheets',
+  name: 'Google Sheets',
+  description: 'Spreadsheets, formulas, charts, data validation, and Apps Script.',
+  category: 'analytics',
+  risk: 'low',
+  icon: '📊',
+  source: 'builtin',
+};
+
+export const TOOLS: ToolDefinition[] = [
+  { id: 'gws_sheets_read', name: 'Read Sheet', description: 'Read Google Sheets data', category: 'read', risk: 'low', skillId: 'gws-sheets', sideEffects: [] },
+  { id: 'gws_sheets_write', name: 'Write Sheet', description: 'Write data to Google Sheets', category: 'write', risk: 'low', skillId: 'gws-sheets', sideEffects: ['modifies-files'] },
+  { id: 'gws_sheets_create', name: 'Create Sheet', description: 'Create Google Spreadsheet', category: 'write', risk: 'low', skillId: 'gws-sheets', sideEffects: [] },
+  { id: 'gws_sheets_formula', name: 'Run Formula', description: 'Execute Sheets formula', category: 'read', risk: 'low', skillId: 'gws-sheets', sideEffects: [] },
+];