@aaronsb/google-workspace-mcp 2.0.0-alpha.4

package/build/executor/workspace.js

@@ -0,0 +1,146 @@
+/**
+ * Workspace directory — safe sandbox for file I/O operations.
+ *
+ * All file operations (Drive upload/download, Docs export, Sheets CSV export)
+ * are jailed to this directory. Prevents agents from accidentally operating on
+ * home directories, document folders, or Google Drive mount points.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { dataDir } from './paths.js';
+const DEFAULT_WORKSPACE = path.join(dataDir(), 'workspace');
+/** Paths that must never be used as the workspace root. */
+const FORBIDDEN_PATHS = [
+    // Home directory itself
+    () => process.env.HOME ?? '',
+    () => process.env.USERPROFILE ?? '',
+    // Common document directories (only when HOME/USERPROFILE is set)
+    () => process.env.HOME ? path.join(process.env.HOME, 'Documents') : '',
+    () => process.env.HOME ? path.join(process.env.HOME, 'Desktop') : '',
+    () => process.env.HOME ? path.join(process.env.HOME, 'Downloads') : '',
+    // Windows equivalents
+    () => process.env.USERPROFILE ? path.join(process.env.USERPROFILE, 'Documents') : '',
+    () => process.env.USERPROFILE ? path.join(process.env.USERPROFILE, 'Desktop') : '',
+    () => process.env.USERPROFILE ? path.join(process.env.USERPROFILE, 'Downloads') : '',
+];
+/** Path substrings that indicate a Google Drive mount. */
+const GDRIVE_PATTERNS = [
+    'google-drive',
+    'Google Drive',
+    'GoogleDrive',
+    'gdrive',
+    'My Drive',
+];
+/** Validate and return the workspace directory path. */
+export function getWorkspaceDir() {
+    const configured = process.env.WORKSPACE_DIR;
+    // Ignore unresolved mcpb template variables (e.g. "${user_config.workspace_dir}")
+    if (configured && !configured.includes('${')) {
+        return configured;
+    }
+    return DEFAULT_WORKSPACE;
+}
+/**
+ * Validate workspace dir is safe. Throws if it IS a protected directory.
+ * Being a subdirectory OF a protected directory is fine (e.g. ~/Documents/mcp-workspace/).
+ */
+export function validateWorkspaceDir(dir) {
+    const resolved = path.resolve(dir);
+    // Must not BE a protected directory (subdirectories are OK)
+    for (const getForbidden of FORBIDDEN_PATHS) {
+        const forbidden = getForbidden();
+        if (forbidden && path.resolve(forbidden) === resolved) {
+            throw new Error(`Workspace directory cannot be ${resolved} itself — ` +
+                `use a subdirectory like ${resolved}/mcp-workspace or ${DEFAULT_WORKSPACE}`);
+        }
+    }
+    // Check for Google Drive mount points
+    for (const pattern of GDRIVE_PATTERNS) {
+        if (resolved.toLowerCase().includes(pattern.toLowerCase())) {
+            throw new Error(`Workspace directory cannot be inside a Google Drive mount (${resolved}) — ` +
+                `this could cause sync conflicts and data loss`);
+        }
+    }
+    // Must not be the filesystem root
+    if (resolved === '/' || resolved === 'C:\\') {
+        throw new Error('Workspace directory cannot be the filesystem root');
+    }
+}
+/** Check workspace directory status without crashing. */
+export function checkWorkspaceStatus() {
+    const dir = getWorkspaceDir();
+    try {
+        validateWorkspaceDir(dir);
+        return { path: dir, valid: true };
+    }
+    catch (err) {
+        return {
+            path: dir,
+            valid: false,
+            warning: err.message,
+        };
+    }
+}
+/** Ensure the workspace directory exists and is validated. Returns status instead of throwing. */
+export async function ensureWorkspaceDir() {
+    const status = checkWorkspaceStatus();
+    if (status.valid) {
+        await fs.mkdir(status.path, { recursive: true, mode: 0o755 });
+    }
+    return status;
+}
+/**
+ * Sanitize a filename from external sources (email attachments, Drive metadata).
+ * Strips null bytes, control characters, path separators, and other dangerous chars.
+ */
+export function sanitizeFilename(filename) {
+    return filename
+        // Remove null bytes and control characters
+        .replace(/[\x00-\x1f\x7f]/g, '')
+        // Remove path separators (prevent directory traversal via filename)
+        .replace(/[/\\]/g, '_')
+        // Remove other potentially dangerous characters
+        .replace(/[<>:"|?*]/g, '_')
+        // Collapse multiple underscores
+        .replace(/_+/g, '_')
+        // Remove leading dots (hidden files) and trailing dots/spaces (Windows)
+        .replace(/^\.+/, '')
+        .replace(/[. ]+$/, '')
+        // Fallback if nothing remains
+        || 'unnamed';
+}
+/**
+ * Resolve a file path within the workspace directory.
+ * Prevents path traversal (e.g. ../../etc/passwd) and sanitizes the filename.
+ */
+export function resolveWorkspacePath(filename) {
+    const dir = getWorkspaceDir();
+    const sanitized = sanitizeFilename(filename);
+    const resolved = path.resolve(dir, sanitized);
+    // Ensure the resolved path is still inside the workspace
+    const resolvedDir = path.resolve(dir);
+    if (!resolved.startsWith(resolvedDir + path.sep) && resolved !== resolvedDir) {
+        throw new Error(`Path traversal detected: "${filename}" resolves outside workspace directory`);
+    }
+    return resolved;
+}
+/**
+ * Verify a file path is safe to read/write after symlink resolution.
+ * Must be called before any fs operation on a workspace path.
+ */
+export async function verifyPathSafety(filePath) {
+    const dir = path.resolve(getWorkspaceDir());
+    try {
+        const real = await fs.realpath(filePath);
+        if (!real.startsWith(dir + path.sep) && real !== dir) {
+            throw new Error(`Symlink escape detected: "${filePath}" resolves to "${real}" outside workspace`);
+        }
+    }
+    catch (err) {
+        // ENOENT is OK — file doesn't exist yet (write case)
+        if (err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/build/executor/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/executor/workspace.ts"],"names":[],"mappings":"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"}

package/build/factory/defaults.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Default formatters — generic markdown renderers for list/detail/action
+ * responses. Used when a service has no patch formatter override.
+ */
+import type { HandlerResponse } from '../server/formatting/markdown.js';
+import type { OperationDef } from './types.js';
+/** Route to the appropriate default formatter based on operation type. */
+export declare function formatDefault(data: unknown, opDef: OperationDef): HandlerResponse;

package/build/factory/defaults.js

@@ -0,0 +1,101 @@
+/**
+ * Default formatters — generic markdown renderers for list/detail/action
+ * responses. Used when a service has no patch formatter override.
+ */
+/** Route to the appropriate default formatter based on operation type. */
+export function formatDefault(data, opDef) {
+    switch (opDef.type) {
+        case 'list':
+            return formatDefaultList(data);
+        case 'detail':
+            return formatDefaultDetail(data);
+        case 'action':
+            return formatDefaultAction(data);
+        default:
+            return formatDefaultDetail(data);
+    }
+}
+/** Generic list formatter — renders array items as pipe-delimited rows. */
+function formatDefaultList(data) {
+    const raw = data;
+    // Try common list wrapper keys
+    const items = findArray(raw);
+    if (items.length === 0) {
+        return { text: 'No results found.', refs: { count: 0 } };
+    }
+    const lines = items.map(item => {
+        const obj = item;
+        const id = String(obj.id ?? '');
+        const parts = [id];
+        // Include a few meaningful string fields
+        for (const [key, val] of Object.entries(obj)) {
+            if (key === 'id')
+                continue;
+            if (typeof val === 'string' && val.length < 100) {
+                parts.push(val);
+            }
+            if (parts.length >= 5)
+                break;
+        }
+        return parts.join(' | ');
+    });
+    return {
+        text: `## Results (${items.length})\n\n${lines.join('\n')}`,
+        refs: {
+            count: items.length,
+            id: String(items[0]?.id ?? ''),
+            ids: items.map(i => String(i?.id ?? '')),
+        },
+    };
+}
+/** Generic detail formatter — renders object fields as bold key/value pairs. */
+function formatDefaultDetail(data) {
+    const obj = data;
+    const title = String(obj.name ?? obj.summary ?? obj.subject ?? obj.title ?? 'Details');
+    const id = String(obj.id ?? '');
+    const parts = [`## ${title}`, ''];
+    for (const [key, val] of Object.entries(obj)) {
+        if (val === null || val === undefined)
+            continue;
+        if (typeof val === 'object')
+            continue; // skip nested objects
+        parts.push(`**${key}:** ${val}`);
+    }
+    return {
+        text: parts.join('\n'),
+        refs: { id, ...extractScalarRefs(obj) },
+    };
+}
+/** Generic action formatter — confirmation message with returned fields. */
+function formatDefaultAction(data) {
+    const obj = (data ?? {});
+    const id = String(obj.id ?? 'unknown');
+    const parts = ['Operation completed.'];
+    if (obj.id)
+        parts.push(`\n**ID:** ${id}`);
+    return {
+        text: parts.join(''),
+        refs: { id, ...extractScalarRefs(obj) },
+    };
+}
+/** Find the first array in a response object (items, files, messages, etc). */
+function findArray(obj) {
+    if (Array.isArray(obj))
+        return obj;
+    for (const val of Object.values(obj)) {
+        if (Array.isArray(val))
+            return val;
+    }
+    return [];
+}
+/** Pull scalar values from an object for refs. */
+function extractScalarRefs(obj) {
+    const refs = {};
+    for (const [key, val] of Object.entries(obj)) {
+        if (typeof val === 'string' || typeof val === 'number' || typeof val === 'boolean') {
+            refs[key] = val;
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=defaults.js.map

package/build/factory/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/factory/defaults.ts"],"names":[],"mappings":"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"}

package/build/factory/generator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Factory generator — reads the manifest and produces MCP tools.
+ *
+ * For each service in the manifest, generates:
+ * 1. A JSON Schema tool definition (operation enum, typed params)
+ * 2. A handler function (maps operations to gws CLI calls, applies formatting)
+ *
+ * Patches are optional per-service hooks that override default behavior.
+ */
+import type { Manifest, ServiceDef, ServicePatch, GeneratedTool, GeneratedToolSchema, GeneratedHandler } from './types.js';
+/** Called by registry.ts to inject the ESM module directory. */
+export declare function setModuleDir(dir: string): void;
+/**
+ * Load and parse the manifest YAML.
+ * Searches module-relative paths first, then cwd fallbacks.
+ */
+export declare function loadManifest(path?: string): Manifest;
+/** Generate all tools from the manifest with optional patches. */
+export declare function generateTools(manifest: Manifest, patches?: Record<string, ServicePatch>): GeneratedTool[];
+/** Generate the JSON Schema tool definition from a service declaration. */
+export declare function generateSchema(service: ServiceDef): GeneratedToolSchema;
+/** Generate a handler function for a service. */
+export declare function generateHandler(service: ServiceDef, patch?: ServicePatch): GeneratedHandler;

package/build/factory/generator.js

@@ -0,0 +1,253 @@
+/**
+ * Factory generator — reads the manifest and produces MCP tools.
+ *
+ * For each service in the manifest, generates:
+ * 1. A JSON Schema tool definition (operation enum, typed params)
+ * 2. A handler function (maps operations to gws CLI calls, applies formatting)
+ *
+ * Patches are optional per-service hooks that override default behavior.
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parse as parseYaml } from '../factory/yaml.js';
+import { execute } from '../executor/gws.js';
+import { requireEmail, clamp } from '../server/handlers/validate.js';
+import { formatDefault } from './defaults.js';
+import { nextSteps } from '../server/formatting/next-steps.js';
+import { evaluatePolicies } from './safety.js';
+/**
+ * Module directory for manifest resolution.
+ * Set by registry.ts via setModuleDir() using import.meta.url (ESM only).
+ * Null in Jest (CJS) — falls back to cwd-based resolution.
+ */
+let _moduleDir;
+/** Called by registry.ts to inject the ESM module directory. */
+export function setModuleDir(dir) {
+    _moduleDir = dir;
+}
+/**
+ * Load and parse the manifest YAML.
+ * Searches module-relative paths first, then cwd fallbacks.
+ */
+export function loadManifest(path) {
+    if (path) {
+        return parseYaml(readFileSync(path, 'utf-8'));
+    }
+    // Search for manifest relative to known anchors.
+    // moduleDir is injected by registry.ts using import.meta.url (ESM only).
+    // cwd fallbacks handle Jest/dev where cwd is the project root.
+    const candidates = [];
+    if (_moduleDir) {
+        candidates.push(resolve(_moduleDir, 'manifest.yaml')); // build/factory/manifest.yaml
+        candidates.push(resolve(_moduleDir, '../../src/factory/manifest.yaml')); // dev: from build/ to src/
+    }
+    candidates.push(resolve(process.cwd(), 'src/factory/manifest.yaml'));
+    candidates.push(resolve(process.cwd(), 'build/factory/manifest.yaml'));
+    for (const candidate of candidates) {
+        try {
+            return parseYaml(readFileSync(candidate, 'utf-8'));
+        }
+        catch {
+            continue;
+        }
+    }
+    throw new Error(`Could not find manifest.yaml. Searched:\n${candidates.join('\n')}`);
+}
+/** Generate all tools from the manifest with optional patches. */
+export function generateTools(manifest, patches) {
+    const tools = [];
+    for (const [serviceName, serviceDef] of Object.entries(manifest.services)) {
+        const patch = patches?.[serviceName];
+        const schema = generateSchema(serviceDef);
+        const handler = generateHandler(serviceDef, patch);
+        tools.push({ schema, handler });
+    }
+    return tools;
+}
+/** Generate the JSON Schema tool definition from a service declaration. */
+export function generateSchema(service) {
+    const operationNames = Object.keys(service.operations);
+    const operationDescriptions = operationNames
+        .map(name => `${name}: ${service.operations[name].description}`)
+        .join(' | ');
+    // Collect all unique params across operations
+    const allParams = {};
+    for (const op of Object.values(service.operations)) {
+        if (!op.params)
+            continue;
+        for (const [paramName, paramDef] of Object.entries(op.params)) {
+            if (!allParams[paramName]) {
+                allParams[paramName] = {
+                    type: paramDef.type,
+                    description: paramDef.description,
+                    ...(paramDef.enum ? { enum: paramDef.enum } : {}),
+                };
+            }
+        }
+    }
+    const properties = {
+        operation: {
+            type: 'string',
+            enum: operationNames,
+            description: operationDescriptions,
+        },
+    };
+    if (service.requires_email) {
+        properties.email = { type: 'string', description: 'Account email address' };
+    }
+    for (const [name, def] of Object.entries(allParams)) {
+        properties[name] = { type: def.type, description: def.description, ...(def.enum ? { enum: def.enum } : {}) };
+    }
+    const required = service.requires_email ? ['operation', 'email'] : ['operation'];
+    return {
+        name: service.tool_name,
+        description: service.description,
+        inputSchema: {
+            type: 'object',
+            properties,
+            required,
+            additionalProperties: false,
+        },
+    };
+}
+/** Generate a handler function for a service. */
+export function generateHandler(service, patch) {
+    // Map tool_name to the next-steps domain key
+    const domainMap = {
+        manage_email: 'email',
+        manage_calendar: 'calendar',
+        manage_drive: 'drive',
+    };
+    const domain = domainMap[service.tool_name] ?? service.gws_service;
+    return async (params) => {
+        const operation = params.operation;
+        const opDef = service.operations[operation];
+        if (!opDef) {
+            throw new Error(`Unknown ${service.gws_service} operation: ${operation}`);
+        }
+        const account = service.requires_email ? requireEmail(params) : '';
+        const ctx = { operation, params, account };
+        // Safety policies — run before anything else, including custom handlers.
+        // A blocked operation never reaches the handler or gws.
+        const policyResult = evaluatePolicies([], ctx, service.gws_service);
+        if (policyResult.action === 'block') {
+            return {
+                text: `**Blocked by safety policy:** ${policyResult.reason}`,
+                refs: { blocked: true, policy: policyResult.reason },
+            };
+        }
+        // Check for a fully custom handler first
+        if (patch?.customHandlers?.[operation]) {
+            return patch.customHandlers[operation](params, account);
+        }
+        // Build gws args
+        let args = policyResult.action === 'downgrade' && policyResult.replacementArgs
+            ? policyResult.replacementArgs
+            : buildArgs(service.gws_service, opDef, params);
+        // beforeExecute hook (service-specific)
+        if (patch?.beforeExecute?.[operation]) {
+            args = await patch.beforeExecute[operation](args, ctx);
+        }
+        // Execute gws
+        const result = await execute(args, { account, format: 'json' });
+        // afterExecute hook
+        let data = result.data;
+        if (patch?.afterExecute?.[operation]) {
+            data = await patch.afterExecute[operation](data, ctx);
+        }
+        // Format response
+        const contextMap = { email: account };
+        // Add relevant param values to context for next-steps placeholder resolution
+        for (const [key, value] of Object.entries(params)) {
+            if (typeof value === 'string')
+                contextMap[key] = value;
+        }
+        let formatted;
+        // Check for patch formatters by operation type
+        if (opDef.type === 'list' && patch?.formatList) {
+            formatted = patch.formatList(data, ctx);
+        }
+        else if (opDef.type === 'detail' && patch?.formatDetail) {
+            formatted = patch.formatDetail(data, ctx);
+        }
+        else if (opDef.type === 'action' && patch?.formatAction) {
+            formatted = patch.formatAction(data, ctx);
+        }
+        else {
+            formatted = formatDefault(data, opDef);
+        }
+        // Append next-steps
+        const stepsText = patch?.nextSteps
+            ? patch.nextSteps(operation, contextMap)
+            : nextSteps(domain, operation, contextMap);
+        return {
+            text: formatted.text + stepsText,
+            refs: formatted.refs,
+        };
+    };
+}
+/** Build gws CLI args from an operation definition and user params. */
+function buildArgs(gwsService, opDef, params) {
+    // Helper-based operations use positional/flag args
+    if (opDef.helper) {
+        return buildHelperArgs(gwsService, opDef, params);
+    }
+    // Resource-based operations use --params JSON
+    if (opDef.resource) {
+        return buildResourceArgs(gwsService, opDef, params);
+    }
+    throw new Error(`Operation must define either 'resource' or 'helper'`);
+}
+/** Build args for gws resource calls: `gws service resource method --params '{...}'` */
+function buildResourceArgs(gwsService, opDef, params) {
+    const resourceParts = opDef.resource.split('.');
+    const args = [gwsService, ...resourceParts];
+    // Build the --params JSON object
+    const gwsParams = { ...opDef.defaults };
+    if (opDef.params) {
+        for (const [paramName, paramDef] of Object.entries(opDef.params)) {
+            const value = params[paramName];
+            const targetKey = paramDef.maps_to ?? paramName;
+            if (value !== undefined && value !== null) {
+                gwsParams[targetKey] = paramDef.max
+                    ? clamp(value, paramDef.default ?? 10, paramDef.max)
+                    : value;
+            }
+            else if (paramDef.default !== undefined) {
+                gwsParams[targetKey] = paramDef.default;
+            }
+        }
+    }
+    // Clean undefined values
+    for (const [key, val] of Object.entries(gwsParams)) {
+        if (val === undefined)
+            delete gwsParams[key];
+    }
+    if (Object.keys(gwsParams).length > 0) {
+        args.push('--params', JSON.stringify(gwsParams));
+    }
+    return args;
+}
+/** Build args for gws helper calls: `gws service +helper --flag value ...` */
+function buildHelperArgs(gwsService, opDef, params) {
+    const args = [gwsService, opDef.helper];
+    // Some helpers take a positional arg (e.g. +reply messageId)
+    // Check for required params that aren't in cli_args — those are positional
+    if (opDef.params) {
+        for (const [paramName, paramDef] of Object.entries(opDef.params)) {
+            const value = params[paramName];
+            if (value === undefined || value === null)
+                continue;
+            if (opDef.cli_args?.[paramName]) {
+                // Flag-style arg
+                args.push(opDef.cli_args[paramName], String(value));
+            }
+            else if (paramDef.required) {
+                // Positional arg
+                args.push(String(value));
+            }
+        }
+    }
+    return args;
+}
+//# sourceMappingURL=generator.js.map

package/build/factory/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/factory/generator.ts"],"names":[],"mappings":"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"}