@agenticmail/enterprise 0.5.327 → 0.5.328

package/src/engine/skill-validator.ts

@@ -1,331 +0,0 @@
-/**
- * Community Skill Manifest Validator
- *
- * Standalone strict validator for agenticmail-skill.json manifests.
- * Used by the CLI `validate` command, the CI pipeline, and the
- * CommunitySkillRegistry at publish time.
- *
- * Checks: required fields, format constraints, semver, tool uniqueness,
- * valid categories/risks/side-effects, and duplicate tool ID detection
- * against the entire builtin + community catalog.
- */
-
-// ─── Valid Value Sets ──────────────────────────────────
-
-export const VALID_CATEGORIES = [
-  'communication', 'development', 'productivity', 'research', 'media',
-  'automation', 'smart-home', 'data', 'security', 'social', 'platform',
-  'collaboration', 'crm', 'project-management', 'cloud-infrastructure',
-  'devops', 'finance', 'analytics', 'design', 'ecommerce', 'marketing',
-  'hr', 'legal', 'customer-support', 'storage', 'database', 'monitoring',
-] as const;
-
-export const VALID_TOOL_CATEGORIES = [
-  'read', 'write', 'execute', 'communicate', 'destroy',
-] as const;
-
-export const VALID_RISK_LEVELS = [
-  'low', 'medium', 'high', 'critical',
-] as const;
-
-export const VALID_SIDE_EFFECTS = [
-  'sends-email', 'sends-message', 'sends-sms', 'posts-social',
-  'runs-code', 'modifies-files', 'deletes-data', 'network-request',
-  'controls-device', 'accesses-secrets', 'financial',
-] as const;
-
-export const VALID_SPDX_LICENSES = [
-  'MIT', 'Apache-2.0', 'BSD-2-Clause', 'BSD-3-Clause', 'ISC',
-  'MPL-2.0', 'GPL-2.0', 'GPL-3.0', 'LGPL-2.1', 'LGPL-3.0',
-  'AGPL-3.0', 'Unlicense', 'CC0-1.0', 'CC-BY-4.0', 'CC-BY-SA-4.0',
-  'BSL-1.0', '0BSD', 'Artistic-2.0', 'Zlib', 'PSF-2.0',
-] as const;
-
-// ─── Regex Patterns ─────────────────────────────────────
-
-const ID_RE = /^[a-z0-9][a-z0-9_-]{2,63}$/;
-const TOOL_ID_RE = /^[a-z0-9_]+$/;
-const SEMVER_RE = /^\d+\.\d+\.\d+(-[\w.]+)?(\+[\w.]+)?$/;
-const AUTHOR_RE = /^[a-zA-Z0-9_-]+$/;
-const TAG_RE = /^[a-z0-9][a-z0-9-]*$/;
-
-// ─── Types ──────────────────────────────────────────────
-
-export interface ManifestValidationResult {
-  valid: boolean;
-  errors: string[];
-  warnings: string[];
-}
-
-export interface ValidateOptions {
-  /** Set of existing tool IDs from the builtin catalog (TOOL_INDEX keys) */
-  existingToolIds?: Set<string>;
-  /** Path to community-skills/ directory for cross-skill duplicate detection */
-  communitySkillsDir?: string;
-  /** Current engine version for minEngineVersion comparison */
-  engineVersion?: string;
-  /** Skill ID to exclude from duplicate checks (for re-validation of own manifest) */
-  selfSkillId?: string;
-}
-
-// ─── Main Validator ─────────────────────────────────────
-
-export function validateSkillManifest(
-  manifest: any,
-  opts?: ValidateOptions,
-): ManifestValidationResult {
-  const errors: string[] = [];
-  const warnings: string[] = [];
-
-  if (!manifest || typeof manifest !== 'object') {
-    return { valid: false, errors: ['Manifest must be a JSON object'], warnings: [] };
-  }
-
-  // ── Required String Fields ────────────────────────
-
-  // id
-  if (!manifest.id) {
-    errors.push('id is required');
-  } else if (typeof manifest.id !== 'string') {
-    errors.push('id must be a string');
-  } else if (!ID_RE.test(manifest.id)) {
-    errors.push('id must be 3-64 chars, lowercase alphanumeric with hyphens/underscores, starting with a letter or digit');
-  }
-
-  // name
-  if (!manifest.name) {
-    errors.push('name is required');
-  } else if (typeof manifest.name !== 'string') {
-    errors.push('name must be a string');
-  } else if (manifest.name.length > 100) {
-    errors.push('name must be 100 chars or fewer');
-  }
-
-  // description
-  if (!manifest.description) {
-    errors.push('description is required');
-  } else if (typeof manifest.description !== 'string') {
-    errors.push('description must be a string');
-  } else {
-    if (manifest.description.length < 20) errors.push('description must be at least 20 characters');
-    if (manifest.description.length > 500) errors.push('description must be 500 chars or fewer');
-  }
-
-  // version
-  if (!manifest.version) {
-    errors.push('version is required');
-  } else if (!SEMVER_RE.test(manifest.version)) {
-    errors.push('version must be valid semver (e.g. 1.0.0, 2.1.0-beta.1)');
-  }
-
-  // author
-  if (!manifest.author) {
-    errors.push('author is required');
-  } else if (!AUTHOR_RE.test(manifest.author)) {
-    errors.push('author must be alphanumeric with hyphens/underscores (GitHub username format)');
-  }
-
-  // repository
-  if (!manifest.repository) {
-    errors.push('repository is required');
-  } else if (typeof manifest.repository !== 'string') {
-    errors.push('repository must be a string');
-  } else {
-    try {
-      new URL(manifest.repository);
-    } catch {
-      errors.push('repository must be a valid URL');
-    }
-  }
-
-  // license
-  if (!manifest.license) {
-    errors.push('license is required');
-  } else if (!(VALID_SPDX_LICENSES as readonly string[]).includes(manifest.license)) {
-    warnings.push(`Unknown license "${manifest.license}" — common: ${VALID_SPDX_LICENSES.slice(0, 6).join(', ')}`);
-  }
-
-  // ── Enum Fields ───────────────────────────────────
-
-  // category
-  if (!manifest.category) {
-    errors.push('category is required');
-  } else if (!(VALID_CATEGORIES as readonly string[]).includes(manifest.category)) {
-    errors.push(`Invalid category "${manifest.category}" — valid: ${VALID_CATEGORIES.join(', ')}`);
-  }
-
-  // risk
-  if (!manifest.risk) {
-    errors.push('risk is required');
-  } else if (!(VALID_RISK_LEVELS as readonly string[]).includes(manifest.risk)) {
-    errors.push(`Invalid risk level "${manifest.risk}" — valid: ${VALID_RISK_LEVELS.join(', ')}`);
-  }
-
-  // ── Optional Fields ───────────────────────────────
-
-  // tags
-  if (manifest.tags !== undefined) {
-    if (!Array.isArray(manifest.tags)) {
-      errors.push('tags must be an array');
-    } else {
-      if (manifest.tags.length > 20) errors.push('Maximum 20 tags allowed');
-      for (const tag of manifest.tags) {
-        if (typeof tag !== 'string' || !TAG_RE.test(tag)) {
-          errors.push(`Invalid tag "${tag}" — must be lowercase alphanumeric with hyphens`);
-        }
-      }
-    }
-  }
-
-  // icon
-  if (manifest.icon !== undefined && typeof manifest.icon !== 'string') {
-    warnings.push('icon should be a string (emoji or URL)');
-  }
-
-  // configSchema
-  if (manifest.configSchema !== undefined && (typeof manifest.configSchema !== 'object' || Array.isArray(manifest.configSchema))) {
-    warnings.push('configSchema should be a JSON object');
-  }
-
-  // minEngineVersion
-  if (manifest.minEngineVersion) {
-    if (!SEMVER_RE.test(manifest.minEngineVersion)) {
-      warnings.push('minEngineVersion should be valid semver');
-    } else if (opts?.engineVersion && SEMVER_RE.test(opts.engineVersion)) {
-      if (compareSemver(manifest.minEngineVersion, opts.engineVersion) > 0) {
-        warnings.push(`minEngineVersion ${manifest.minEngineVersion} is newer than current engine ${opts.engineVersion}`);
-      }
-    }
-  }
-
-  // homepage
-  if (manifest.homepage) {
-    try {
-      new URL(manifest.homepage);
-    } catch {
-      warnings.push('homepage should be a valid URL');
-    }
-  }
-
-  // ── Tools Array ───────────────────────────────────
-
-  if (!manifest.tools || !Array.isArray(manifest.tools) || manifest.tools.length === 0) {
-    errors.push('At least one tool definition is required in the tools array');
-  } else {
-    const seenToolIds = new Set<string>();
-
-    for (let i = 0; i < manifest.tools.length; i++) {
-      const tool = manifest.tools[i];
-      const prefix = `tools[${i}]`;
-
-      if (!tool || typeof tool !== 'object') {
-        errors.push(`${prefix}: must be an object`);
-        continue;
-      }
-
-      // tool.id
-      if (!tool.id) {
-        errors.push(`${prefix}: id is required`);
-      } else if (!TOOL_ID_RE.test(tool.id)) {
-        errors.push(`${prefix}: id "${tool.id}" must be lowercase alphanumeric with underscores`);
-      } else {
-        // Check for duplicates within this manifest
-        if (seenToolIds.has(tool.id)) {
-          errors.push(`${prefix}: duplicate tool id "${tool.id}" within this manifest`);
-        }
-        seenToolIds.add(tool.id);
-
-        // Check against existing builtin tools
-        if (opts?.existingToolIds?.has(tool.id)) {
-          errors.push(`${prefix}: tool id "${tool.id}" conflicts with an existing builtin tool`);
-        }
-      }
-
-      // tool.name
-      if (!tool.name) errors.push(`${prefix}: name is required`);
-
-      // tool.description
-      if (!tool.description) errors.push(`${prefix}: description is required`);
-
-      // tool.category (ToolCategory)
-      if (tool.category && !(VALID_TOOL_CATEGORIES as readonly string[]).includes(tool.category)) {
-        warnings.push(`${prefix}: unknown tool category "${tool.category}" — valid: ${VALID_TOOL_CATEGORIES.join(', ')}`);
-      }
-
-      // tool.riskLevel
-      if (tool.riskLevel && !(VALID_RISK_LEVELS as readonly string[]).includes(tool.riskLevel)) {
-        warnings.push(`${prefix}: unknown riskLevel "${tool.riskLevel}" — valid: ${VALID_RISK_LEVELS.join(', ')}`);
-      }
-
-      // tool.sideEffects
-      if (tool.sideEffects) {
-        if (!Array.isArray(tool.sideEffects)) {
-          warnings.push(`${prefix}: sideEffects should be an array`);
-        } else {
-          for (const effect of tool.sideEffects) {
-            if (!(VALID_SIDE_EFFECTS as readonly string[]).includes(effect)) {
-              warnings.push(`${prefix}: unknown sideEffect "${effect}" — valid: ${VALID_SIDE_EFFECTS.join(', ')}`);
-            }
-          }
-        }
-      }
-
-      // tool.parameters
-      if (tool.parameters && typeof tool.parameters !== 'object') {
-        warnings.push(`${prefix}: parameters should be an object`);
-      }
-    }
-  }
-
-  return { valid: errors.length === 0, errors, warnings };
-}
-
-// ─── Helpers ─────────────────────────────────────────────
-
-/** Compare two semver strings. Returns -1, 0, or 1. */
-function compareSemver(a: string, b: string): number {
-  const pa = a.split('-')[0].split('.').map(Number);
-  const pb = b.split('-')[0].split('.').map(Number);
-  for (let i = 0; i < 3; i++) {
-    if ((pa[i] || 0) > (pb[i] || 0)) return 1;
-    if ((pa[i] || 0) < (pb[i] || 0)) return -1;
-  }
-  return 0;
-}
-
-/**
- * Scan a community-skills/ directory and collect all tool IDs
- * from existing manifests (excluding a given skill ID).
- */
-export async function collectCommunityToolIds(
-  dirPath: string,
-  excludeSkillId?: string,
-): Promise<Set<string>> {
-  const ids = new Set<string>();
-  try {
-    const fs = await import('fs/promises');
-    const path = await import('path');
-    const entries = await fs.readdir(dirPath, { withFileTypes: true });
-
-    for (const entry of entries) {
-      if (!entry.isDirectory() || entry.name.startsWith('_') || entry.name.startsWith('.')) continue;
-      if (excludeSkillId && entry.name === excludeSkillId) continue;
-
-      try {
-        const manifestPath = path.join(dirPath, entry.name, 'agenticmail-skill.json');
-        const raw = await fs.readFile(manifestPath, 'utf-8');
-        const manifest = JSON.parse(raw);
-        if (manifest.tools && Array.isArray(manifest.tools)) {
-          for (const tool of manifest.tools) {
-            if (tool.id) ids.add(tool.id);
-          }
-        }
-      } catch {
-        // Skip invalid/missing manifests
-      }
-    }
-  } catch {
-    // Directory doesn't exist or isn't readable
-  }
-  return ids;
-}

package/src/engine/skills/agent-management.ts

@@ -1,119 +0,0 @@
-/**
- * Skill: Agent Management (Hierarchy, Delegation, Escalation)
- *
- * Enables manager agents to delegate tasks to subordinates,
- * subordinates to update status and escalate, and all agents
- * to see their position in the org chart.
- */
-
-import type { SkillDefinition } from '../skills.js';
-
-export const agentManagementSkill: SkillDefinition = {
-  id: 'agent-management',
-  name: 'Agent Management',
-  description: 'Organizational hierarchy — delegation, escalation, team status, org chart',
-  category: 'utility',
-  icon: 'building',
-  risk: 'medium',
-  tools: [
-    {
-      id: 'team_status',
-      name: 'team_status',
-      description: 'Get status of direct reports.',
-      category: 'utility',
-      risk: 'low',
-      skillId: 'agent-management',
-      sideEffects: [],
-    },
-    {
-      id: 'team_delegate_task',
-      name: 'team_delegate_task',
-      description: 'Delegate a task to a subordinate.',
-      category: 'utility',
-      risk: 'medium',
-      skillId: 'agent-management',
-      sideEffects: ['database_write'],
-    },
-    {
-      id: 'team_tasks',
-      name: 'team_tasks',
-      description: 'List delegated tasks.',
-      category: 'utility',
-      risk: 'low',
-      skillId: 'agent-management',
-      sideEffects: [],
-    },
-    {
-      id: 'team_reassign_task',
-      name: 'team_reassign_task',
-      description: 'Reassign a task to a different agent.',
-      category: 'utility',
-      risk: 'medium',
-      skillId: 'agent-management',
-      sideEffects: ['database_write'],
-    },
-    {
-      id: 'team_feedback',
-      name: 'team_feedback',
-      description: 'Provide feedback on a completed task.',
-      category: 'utility',
-      risk: 'low',
-      skillId: 'agent-management',
-      sideEffects: ['database_write'],
-    },
-    {
-      id: 'team_resolve_escalation',
-      name: 'team_resolve_escalation',
-      description: 'Resolve a pending escalation.',
-      category: 'utility',
-      risk: 'medium',
-      skillId: 'agent-management',
-      sideEffects: ['database_write'],
-    },
-    {
-      id: 'team_forward_escalation',
-      name: 'team_forward_escalation',
-      description: 'Forward an escalation up the chain.',
-      category: 'utility',
-      risk: 'medium',
-      skillId: 'agent-management',
-      sideEffects: ['database_write'],
-    },
-    {
-      id: 'team_org_chart',
-      name: 'team_org_chart',
-      description: 'View the organization chart.',
-      category: 'utility',
-      risk: 'low',
-      skillId: 'agent-management',
-      sideEffects: [],
-    },
-    {
-      id: 'task_update',
-      name: 'task_update',
-      description: 'Update a task assigned to you.',
-      category: 'utility',
-      risk: 'low',
-      skillId: 'agent-management',
-      sideEffects: ['database_write'],
-    },
-    {
-      id: 'my_tasks',
-      name: 'my_tasks',
-      description: 'List tasks assigned to you.',
-      category: 'utility',
-      risk: 'low',
-      skillId: 'agent-management',
-      sideEffects: [],
-    },
-    {
-      id: 'escalate',
-      name: 'escalate',
-      description: 'Escalate an issue to your manager.',
-      category: 'utility',
-      risk: 'medium',
-      skillId: 'agent-management',
-      sideEffects: ['database_write'],
-    },
-  ],
-};

package/src/engine/skills/agent-memory.ts

@@ -1,19 +0,0 @@
-import { Emoji } from '../emoji.js';
-import type { SkillDefinition, ToolDefinition } from '../skills.js';
-
-export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
-  id: 'agent-memory',
-  name: 'Agent Memory',
-  description: 'Persistent memory for storing and recalling information across sessions.',
-  category: 'utility',
-  risk: 'low',
-  icon: Emoji.brain,
-  source: 'builtin',
-};
-
-export const TOOLS: ToolDefinition[] = [
-  { id: 'memory', name: 'Memory', description: 'Store or recall a memory', category: 'write', risk: 'low', skillId: 'agent-memory', sideEffects: [] },
-  { id: 'memory_reflect', name: 'Memory Reflect', description: 'Reflect on and consolidate memories', category: 'write', risk: 'low', skillId: 'agent-memory', sideEffects: [] },
-  { id: 'memory_context', name: 'Memory Context', description: 'Get relevant memory context for a topic', category: 'read', risk: 'low', skillId: 'agent-memory', sideEffects: [] },
-  { id: 'memory_stats', name: 'Memory Stats', description: 'Get memory usage statistics', category: 'read', risk: 'low', skillId: 'agent-memory', sideEffects: [] },
-];

package/src/engine/skills/agenticmail.ts

@@ -1,116 +0,0 @@
-import { Emoji } from '../emoji.js';
-/**
- * AgenticMail — Core Email & Agent Communication Platform
- *
- * The company's flagship product. Provides AI agents with full email capabilities,
- * inter-agent communication, storage, SMS, task management, and more.
- */
-
-import type { SkillDefinition, ToolDefinition } from '../skills.js';
-
-export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
-  id: 'agenticmail',
-  name: 'AgenticMail',
-  description: 'AI-native email platform — send/receive email, inter-agent messaging, storage, SMS, task management, and multi-agent coordination.',
-  category: 'communication',
-  risk: 'medium',
-  icon: Emoji.mailbox,
-  source: 'builtin',
-};
-
-const S = 'agenticmail'; // skillId shorthand
-
-export const TOOLS: ToolDefinition[] = [
-  // ─── Email Core ────────────────────────────────────────
-  { id: 'agenticmail_send', name: 'Send Email', description: 'Send an email from the agent mailbox. Outbound guard scans for PII/credentials.', category: 'communicate', risk: 'high', skillId: S, sideEffects: ['sends-email'] },
-  { id: 'agenticmail_reply', name: 'Reply to Email', description: 'Reply to an email by UID. Outbound guard applies.', category: 'communicate', risk: 'high', skillId: S, sideEffects: ['sends-email'] },
-  { id: 'agenticmail_forward', name: 'Forward Email', description: 'Forward an email to another recipient.', category: 'communicate', risk: 'high', skillId: S, sideEffects: ['sends-email'] },
-  { id: 'agenticmail_inbox', name: 'List Inbox', description: 'List recent emails in the inbox.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_read', name: 'Read Email', description: 'Read a specific email by UID with security metadata.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_search', name: 'Search Emails', description: 'Search emails by criteria. Supports relay search for connected Gmail/Outlook.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_digest', name: 'Inbox Digest', description: 'Compact inbox digest with subject, sender, date, and text preview.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_delete', name: 'Delete Email', description: 'Delete an email by UID.', category: 'destroy', risk: 'medium', skillId: S, sideEffects: ['deletes-data'] },
-  { id: 'agenticmail_move', name: 'Move Email', description: 'Move an email to another folder.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_mark_read', name: 'Mark Read', description: 'Mark an email as read.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_mark_unread', name: 'Mark Unread', description: 'Mark an email as unread.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_folders', name: 'List Folders', description: 'List all mail folders.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_create_folder', name: 'Create Folder', description: 'Create a new mail folder.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_list_folder', name: 'List Folder', description: 'List messages in a specific folder (Sent, Drafts, Trash, etc.).', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-
-  // ─── Batch Operations ──────────────────────────────────
-  { id: 'agenticmail_batch_read', name: 'Batch Read', description: 'Read multiple emails at once by UIDs.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_batch_delete', name: 'Batch Delete', description: 'Delete multiple emails by UIDs.', category: 'destroy', risk: 'medium', skillId: S, sideEffects: ['deletes-data'] },
-  { id: 'agenticmail_batch_move', name: 'Batch Move', description: 'Move multiple emails to another folder.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_batch_mark_read', name: 'Batch Mark Read', description: 'Mark multiple emails as read.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_batch_mark_unread', name: 'Batch Mark Unread', description: 'Mark multiple emails as unread.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-
-  // ─── Drafts ────────────────────────────────────────────
-  { id: 'agenticmail_drafts', name: 'Manage Drafts', description: 'List, create, update, delete, or send email drafts.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-
-  // ─── Templates & Signatures ────────────────────────────
-  { id: 'agenticmail_templates', name: 'Email Templates', description: 'List, create, or delete email templates.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_template_send', name: 'Send from Template', description: 'Send email using a saved template with variable substitution.', category: 'communicate', risk: 'high', skillId: S, sideEffects: ['sends-email'] },
-  { id: 'agenticmail_signatures', name: 'Email Signatures', description: 'List, create, or delete email signatures.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-
-  // ─── Tags & Rules ──────────────────────────────────────
-  { id: 'agenticmail_tags', name: 'Manage Tags', description: 'List, create, delete, tag/untag messages, get messages by tag.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_rules', name: 'Email Rules', description: 'Auto-process incoming messages with server-side rules.', category: 'write', risk: 'medium', skillId: S, sideEffects: [] },
-
-  // ─── Scheduling ────────────────────────────────────────
-  { id: 'agenticmail_schedule', name: 'Schedule Email', description: 'Create, list, or cancel scheduled emails.', category: 'communicate', risk: 'medium', skillId: S, sideEffects: ['sends-email'] },
-
-  // ─── Spam Management ───────────────────────────────────
-  { id: 'agenticmail_spam', name: 'Spam Management', description: 'List spam, report/unreport messages, get spam scores.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-
-  // ─── Agent Communication ───────────────────────────────
-  { id: 'agenticmail_list_agents', name: 'List Agents', description: 'Discover all available AI agents and their emails/roles.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_message_agent', name: 'Message Agent', description: 'Send a message to another AI agent by name.', category: 'communicate', risk: 'medium', skillId: S, sideEffects: ['sends-email'] },
-  { id: 'agenticmail_call_agent', name: 'Call Agent', description: 'RPC call to another agent — sync or async. Auto-spawns sessions.', category: 'execute', risk: 'medium', skillId: S, sideEffects: ['spawns-agent'] },
-  { id: 'agenticmail_check_messages', name: 'Check Messages', description: 'Check for new unread messages from other agents or external senders.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_wait_for_email', name: 'Wait for Email', description: 'Push-based wait for new email or task notification (SSE).', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-
-  // ─── Task Management ───────────────────────────────────
-  { id: 'agenticmail_check_tasks', name: 'Check Tasks', description: 'Check for pending tasks assigned to you or tasks you assigned.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_claim_task', name: 'Claim Task', description: 'Claim a pending task to start working on it.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_submit_result', name: 'Submit Result', description: 'Submit result for a claimed task, marking it complete.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_complete_task', name: 'Complete Task', description: 'Claim and submit result in one call.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-
-  // ─── Storage / Database ────────────────────────────────
-  { id: 'agenticmail_storage', name: 'Agent Storage', description: 'Full database management — tables, CRUD, indexes, aggregations, raw SQL.', category: 'write', risk: 'medium', skillId: S, sideEffects: ['writes-data'] },
-
-  // ─── Contacts ──────────────────────────────────────────
-  { id: 'agenticmail_contacts', name: 'Manage Contacts', description: 'List, add, or delete contacts.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-
-  // ─── SMS / Phone ───────────────────────────────────────
-  { id: 'agenticmail_sms_setup', name: 'SMS Setup', description: 'Configure SMS/phone via Google Voice.', category: 'write', risk: 'medium', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_sms_send', name: 'Send SMS', description: 'Send an SMS text message via Google Voice.', category: 'communicate', risk: 'high', skillId: S, sideEffects: ['sends-sms'] },
-  { id: 'agenticmail_sms_messages', name: 'List SMS', description: 'List SMS messages (inbound and outbound).', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_sms_check_code', name: 'Check SMS Code', description: 'Check for recent verification/OTP codes from SMS.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_sms_read_voice', name: 'Read Google Voice', description: 'Read SMS directly from Google Voice web interface.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_sms_record', name: 'Record SMS', description: 'Record an SMS from Google Voice or other source.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_sms_parse_email', name: 'Parse SMS Email', description: 'Parse SMS from forwarded Google Voice email.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_sms_config', name: 'SMS Config', description: 'Get current SMS/phone number configuration.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-
-  // ─── Account & Setup ───────────────────────────────────
-  { id: 'agenticmail_whoami', name: 'Who Am I', description: 'Get the current agent account info — name, email, role, metadata.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_update_metadata', name: 'Update Metadata', description: 'Update the current agent metadata.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_status', name: 'Server Status', description: 'Check AgenticMail server health status.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_gateway_status', name: 'Gateway Status', description: 'Check email gateway status (relay, domain, or none).', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_pending_emails', name: 'Pending Emails', description: 'Check outbound emails blocked by the outbound guard.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-
-  // ─── Admin ─────────────────────────────────────────────
-  { id: 'agenticmail_create_account', name: 'Create Agent Account', description: 'Create a new agent email account (requires master key).', category: 'write', risk: 'high', skillId: S, sideEffects: ['creates-account'] },
-  { id: 'agenticmail_delete_agent', name: 'Delete Agent', description: 'Delete an agent account permanently.', category: 'destroy', risk: 'critical', skillId: S, sideEffects: ['deletes-data'] },
-  { id: 'agenticmail_cleanup', name: 'Cleanup Agents', description: 'List or remove inactive non-persistent agent accounts.', category: 'destroy', risk: 'high', skillId: S, sideEffects: ['deletes-data'] },
-  { id: 'agenticmail_deletion_reports', name: 'Deletion Reports', description: 'List past agent deletion reports.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-
-  // ─── Relay & Domain Setup ──────────────────────────────
-  { id: 'agenticmail_setup_guide', name: 'Setup Guide', description: 'Comparison of email setup modes (Relay vs Domain).', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_setup_relay', name: 'Setup Relay', description: 'Configure Gmail/Outlook relay for real internet email.', category: 'write', risk: 'high', skillId: S, sideEffects: ['configures-email'] },
-  { id: 'agenticmail_setup_domain', name: 'Setup Domain', description: 'Set up custom domain via Cloudflare with DKIM/SPF/DMARC.', category: 'write', risk: 'high', skillId: S, sideEffects: ['configures-email'] },
-  { id: 'agenticmail_setup_gmail_alias', name: 'Gmail Alias Setup', description: 'Instructions to add agent email as Gmail "Send mail as" alias.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_setup_payment', name: 'Payment Setup', description: 'Instructions for adding payment to Cloudflare for domain purchase.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_purchase_domain', name: 'Search Domains', description: 'Search for available domains via Cloudflare Registrar.', category: 'read', risk: 'low', skillId: S, sideEffects: [] },
-  { id: 'agenticmail_test_email', name: 'Test Email', description: 'Send a test email to verify gateway configuration.', category: 'communicate', risk: 'medium', skillId: S, sideEffects: ['sends-email'] },
-  { id: 'agenticmail_import_relay', name: 'Import Relay Email', description: 'Import email from connected Gmail/Outlook into local inbox.', category: 'write', risk: 'low', skillId: S, sideEffects: [] },
-];

package/src/engine/skills/core-tools.ts

@@ -1,25 +0,0 @@
-import { Emoji } from '../emoji.js';
-import type { SkillDefinition, ToolDefinition } from '../skills.js';
-
-export const SKILL_DEF: Omit<SkillDefinition, 'tools'> = {
-  id: 'core-tools',
-  name: 'Core Tools',
-  description: 'File operations, shell, search, and browser automation.',
-  category: 'development',
-  risk: 'high',
-  icon: Emoji.wrench,
-  source: 'builtin',
-};
-
-export const TOOLS: ToolDefinition[] = [
-  { id: 'read', name: 'Read File', description: 'Read file contents', category: 'read', risk: 'low', skillId: 'core-tools', sideEffects: [] },
-  { id: 'write', name: 'Write File', description: 'Write content to a file', category: 'write', risk: 'medium', skillId: 'core-tools', sideEffects: ['modifies-files'] },
-  { id: 'edit', name: 'Edit File', description: 'Edit a file with find/replace', category: 'write', risk: 'medium', skillId: 'core-tools', sideEffects: ['modifies-files'] },
-  { id: 'bash', name: 'Shell Command', description: 'Execute shell commands', category: 'write', risk: 'high', skillId: 'core-tools', sideEffects: ['executes-code'] },
-  { id: 'glob', name: 'Glob', description: 'Find files matching a pattern', category: 'read', risk: 'low', skillId: 'core-tools', sideEffects: [] },
-  { id: 'grep', name: 'Grep', description: 'Search file contents with regex', category: 'read', risk: 'low', skillId: 'core-tools', sideEffects: [] },
-  { id: 'browser', name: 'Browser', description: 'Control a web browser for automation', category: 'write', risk: 'high', skillId: 'core-tools', sideEffects: ['network-request'] },
-  { id: 'web_search', name: 'Web Search', description: 'Search the web', category: 'read', risk: 'low', skillId: 'core-tools', sideEffects: ['network-request'] },
-  { id: 'web_fetch', name: 'Web Fetch', description: 'Fetch and extract content from a URL', category: 'read', risk: 'low', skillId: 'core-tools', sideEffects: ['network-request'] },
-  { id: 'request_tools', name: 'Request Tools', description: 'Dynamically load additional tool sets', category: 'read', risk: 'low', skillId: 'core-tools', sideEffects: [] },
-];