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

package/build/server/handlers/workspace.js

@@ -0,0 +1,110 @@
+/**
+ * Workspace handler — file CRUD within the sandboxed workspace directory.
+ *
+ * The workspace is the exchange point between the MCP server and the agent.
+ * Files saved by getAttachment, download, and export land here. The agent
+ * can also read, write, and manage files directly.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { ensureWorkspaceDir, resolveWorkspacePath, verifyPathSafety, getWorkspaceDir } from '../../executor/workspace.js';
+import { isTextFile } from '../../executor/file-output.js';
+export async function handleWorkspace(params) {
+    const operation = params.operation;
+    switch (operation) {
+        case 'list': {
+            const wsStatus = await ensureWorkspaceDir();
+            if (!wsStatus.valid) {
+                return { text: `Workspace invalid: ${wsStatus.warning}`, refs: { valid: false } };
+            }
+            const dir = getWorkspaceDir();
+            let files;
+            try {
+                files = await fs.readdir(dir);
+            }
+            catch {
+                files = [];
+            }
+            if (files.length === 0) {
+                return {
+                    text: `## Workspace (empty)\n\n**Path:** ${dir}`,
+                    refs: { count: 0, path: dir },
+                };
+            }
+            const entries = await Promise.all(files.map(async (name) => {
+                const filePath = path.join(dir, name);
+                const stat = await fs.stat(filePath);
+                const size = stat.isDirectory() ? 'dir' :
+                    stat.size < 1024 ? `${stat.size} B` :
+                        `${(stat.size / 1024).toFixed(1)} KB`;
+                return `${name} (${size})`;
+            }));
+            return {
+                text: `## Workspace (${files.length} files)\n\n**Path:** ${dir}\n\n${entries.map((e, i) => `${i + 1}. ${e}`).join('\n')}`,
+                refs: { count: files.length, path: dir, files },
+            };
+        }
+        case 'read': {
+            const filename = params.filename;
+            if (!filename)
+                throw new Error('filename is required');
+            const filePath = resolveWorkspacePath(filename);
+            await verifyPathSafety(filePath);
+            const stat = await fs.stat(filePath);
+            if (stat.size > 100_000) {
+                return {
+                    text: `File too large to return inline (${(stat.size / 1024).toFixed(1)} KB). Use the file path directly:\n\n**Path:** ${filePath}`,
+                    refs: { filename, path: filePath, size: stat.size },
+                };
+            }
+            const buffer = await fs.readFile(filePath);
+            if (isTextFile(filename)) {
+                const content = buffer.toString('utf-8');
+                const safeContent = content.replace(/```/g, '` ` `');
+                return {
+                    text: `## ${filename}\n\n\`\`\`\n${safeContent}\n\`\`\``,
+                    refs: { filename, path: filePath, size: stat.size, content },
+                };
+            }
+            return {
+                text: `Binary file: **${filename}** (${(stat.size / 1024).toFixed(1)} KB)\n\n**Path:** ${filePath}`,
+                refs: { filename, path: filePath, size: stat.size },
+            };
+        }
+        case 'write': {
+            const filename = params.filename;
+            const content = params.content;
+            if (!filename)
+                throw new Error('filename is required');
+            if (content === undefined)
+                throw new Error('content is required');
+            const wsStatus = await ensureWorkspaceDir();
+            if (!wsStatus.valid) {
+                throw new Error(`Workspace invalid: ${wsStatus.warning}`);
+            }
+            const filePath = resolveWorkspacePath(filename);
+            await verifyPathSafety(filePath);
+            await fs.mkdir(path.dirname(filePath), { recursive: true });
+            await fs.writeFile(filePath, content, 'utf-8');
+            return {
+                text: `File written: **${filename}** (${Buffer.byteLength(content)} bytes)\n\n**Path:** ${filePath}`,
+                refs: { filename, path: filePath, size: Buffer.byteLength(content) },
+            };
+        }
+        case 'delete': {
+            const filename = params.filename;
+            if (!filename)
+                throw new Error('filename is required');
+            const filePath = resolveWorkspacePath(filename);
+            await verifyPathSafety(filePath);
+            await fs.unlink(filePath);
+            return {
+                text: `File deleted: **${filename}**`,
+                refs: { filename, status: 'deleted' },
+            };
+        }
+        default:
+            throw new Error(`Unknown workspace operation: ${operation}`);
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/build/server/handlers/workspace.js.map

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

package/build/server/index.d.ts

@@ -0,0 +1,4 @@
+export { createServer, startServer } from './server.js';
+export { toolSchemas, getToolSchema } from './tools.js';
+export type { ToolSchema } from './tools.js';
+export { handleToolCall } from './handler.js';

package/build/server/index.js

@@ -0,0 +1,4 @@
+export { createServer, startServer } from './server.js';
+export { toolSchemas, getToolSchema } from './tools.js';
+export { handleToolCall } from './handler.js';
+//# sourceMappingURL=index.js.map

package/build/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/build/server/queue.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Queue handler — execute multiple operations sequentially with
+ * result references ($N.field) for chaining outputs.
+ *
+ * Handlers return { text, refs }. Queue uses refs for $N.field
+ * resolution and text for the final response.
+ */
+import type { HandlerResponse } from './handler.js';
+type ToolHandler = (params: Record<string, unknown>) => Promise<HandlerResponse>;
+export declare function handleQueue(params: Record<string, unknown>, handlers: Record<string, ToolHandler>): Promise<HandlerResponse>;
+export {};

package/build/server/queue.js

@@ -0,0 +1,141 @@
+/**
+ * Queue handler — execute multiple operations sequentially with
+ * result references ($N.field) for chaining outputs.
+ *
+ * Handlers return { text, refs }. Queue uses refs for $N.field
+ * resolution and text for the final response.
+ */
+const NEXT_STEPS_SEPARATOR = '\n\n---\n**Next steps:**';
+function stripNextSteps(text) {
+    const idx = text.indexOf(NEXT_STEPS_SEPARATOR);
+    return idx >= 0 ? text.slice(0, idx) : text;
+}
+export async function handleQueue(params, handlers) {
+    const operations = params.operations;
+    if (!Array.isArray(operations) || operations.length === 0) {
+        throw new Error('operations array is required and must not be empty');
+    }
+    const detail = params.detail ?? 'summary';
+    const results = [];
+    let bailedAt = -1;
+    let lastSuccessText = '';
+    for (let i = 0; i < operations.length; i++) {
+        const op = operations[i];
+        const errorStrategy = op.onError ?? 'bail';
+        if (bailedAt >= 0) {
+            results.push({ index: i, tool: op.tool, status: 'skipped' });
+            continue;
+        }
+        const handler = handlers[op.tool];
+        if (!handler) {
+            results.push({ index: i, tool: op.tool, status: 'error', error: `Unknown tool: ${op.tool}` });
+            if (errorStrategy === 'bail')
+                bailedAt = i;
+            continue;
+        }
+        // Resolve $N.field references
+        let resolvedArgs;
+        try {
+            resolvedArgs = resolveReferences(op.args, results);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            results.push({ index: i, tool: op.tool, status: 'error', error: msg });
+            if (errorStrategy === 'bail')
+                bailedAt = i;
+            continue;
+        }
+        try {
+            const response = await handler(resolvedArgs);
+            const text = stripNextSteps(response.text);
+            results.push({ index: i, tool: op.tool, status: 'success', text, refs: response.refs });
+            lastSuccessText = response.text; // keep next-steps from last success
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            results.push({ index: i, tool: op.tool, status: 'error', error: msg });
+            if (errorStrategy === 'bail')
+                bailedAt = i;
+        }
+    }
+    const succeeded = results.filter(r => r.status === 'success').length;
+    const failed = results.filter(r => r.status === 'error').length;
+    const skipped = results.filter(r => r.status === 'skipped').length;
+    // Build markdown output
+    const lines = [
+        `## Queue Results (${succeeded}/${results.length} succeeded)`,
+        '',
+    ];
+    for (const r of results) {
+        const icon = r.status === 'success' ? '✓' : r.status === 'error' ? '✗' : '○';
+        const headline = r.status === 'error' ? r.error
+            : r.text ? firstLine(r.text)
+                : r.status;
+        lines.push(`${icon} ${r.tool} — ${headline}`);
+        // Full mode: include complete operation output below the summary line
+        if (detail === 'full' && r.status === 'success' && r.text) {
+            lines.push('', r.text, '');
+        }
+    }
+    // Append consolidated next-steps from last successful operation
+    const nextStepsSuffix = extractNextSteps(lastSuccessText);
+    const text = lines.join('\n') + nextStepsSuffix;
+    const refs = {
+        total: results.length,
+        succeeded,
+        failed,
+        skipped,
+        // Per-operation refs keyed by index for downstream access
+        results: results.map(r => ({
+            tool: r.tool,
+            status: r.status,
+            ...(r.refs ?? {}),
+        })),
+    };
+    return { text, refs };
+}
+// --- Reference resolution ---
+function resolveReferences(args, results) {
+    const resolved = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (typeof value === 'string' && /\$\d+\./.test(value)) {
+            resolved[key] = resolveRef(value, results);
+        }
+        else {
+            resolved[key] = value;
+        }
+    }
+    return resolved;
+}
+function resolveRef(value, results) {
+    return value.replace(/\$(\d+)\.(\w+)/g, (_match, indexStr, field) => {
+        const index = parseInt(indexStr, 10);
+        if (index >= results.length) {
+            throw new Error(`$${index}.${field}: operation ${index} hasn't run yet`);
+        }
+        const result = results[index];
+        if (result.status !== 'success') {
+            throw new Error(`$${index}.${field}: operation ${index} ${result.status}`);
+        }
+        const extracted = result.refs?.[field];
+        if (extracted === undefined) {
+            throw new Error(`$${index}.${field}: field '${field}' not found in result`);
+        }
+        return String(extracted);
+    });
+}
+function firstLine(text) {
+    // Skip markdown headings to get the first content line
+    for (const line of text.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('---')) {
+            return trimmed.length > 80 ? trimmed.slice(0, 79) + '…' : trimmed;
+        }
+    }
+    return text.split('\n')[0] ?? '';
+}
+function extractNextSteps(text) {
+    const idx = text.indexOf(NEXT_STEPS_SEPARATOR);
+    return idx >= 0 ? text.slice(idx) : '';
+}
+//# sourceMappingURL=queue.js.map

package/build/server/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/server/queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAExD,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/C,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAA+B,EAC/B,QAAqC;IAErC,MAAM,UAAU,GAAG,MAAM,CAAC,UAA8B,CAAC;IACzD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAAI,MAAM,CAAC,MAAiB,IAAI,SAAS,CAAC;IAEtD,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClB,IAAI,eAAe,GAAG,EAAE,CAAC;IAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,IAAI,MAAM,CAAC;QAE3C,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YAC7D,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9F,IAAI,aAAa,KAAK,MAAM;gBAAE,QAAQ,GAAG,CAAC,CAAC;YAC3C,SAAS;QACX,CAAC;QAED,8BAA8B;QAC9B,IAAI,YAAqC,CAAC;QAC1C,IAAI,CAAC;YACH,YAAY,GAAG,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACvE,IAAI,aAAa,KAAK,MAAM;gBAAE,QAAQ,GAAG,CAAC,CAAC;YAC3C,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YACxF,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,oCAAoC;QACvE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACvE,IAAI,aAAa,KAAK,MAAM;gBAAE,QAAQ,GAAG,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAEnE,wBAAwB;IACxB,MAAM,KAAK,GAAa;QACtB,qBAAqB,SAAS,IAAI,OAAO,CAAC,MAAM,aAAa;QAC7D,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC7E,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK;YAChC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC5B,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,MAAM,QAAQ,EAAE,CAAC,CAAC;QAE9C,sEAAsE;QACtE,IAAI,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,MAAM,eAAe,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC;IAEhD,MAAM,IAAI,GAA4B;QACpC,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,SAAS;QACT,MAAM;QACN,OAAO;QACP,0DAA0D;QAC1D,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;SAClB,CAAC,CAAC;KACJ,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,+BAA+B;AAE/B,SAAS,iBAAiB,CACxB,IAA6B,EAC7B,OAA0B;IAE1B,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,QAAQ,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,OAA0B;IAC3D,OAAO,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QAClE,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,KAAK,eAAe,KAAK,iBAAiB,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,KAAK,eAAe,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,KAAK,YAAY,KAAK,uBAAuB,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,uDAAuD;IACvD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtE,OAAO,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;QACpE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/C,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzC,CAAC"}

package/build/server/server.d.ts

@@ -0,0 +1,3 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare function createServer(): Server;
+export declare function startServer(): Promise<void>;

package/build/server/server.js

@@ -0,0 +1,214 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { toolSchemas } from './tools.js';
+import { handleToolCall } from './handler.js';
+import { GwsError, GwsExitCode } from '../executor/errors.js';
+import { nextSteps } from './formatting/next-steps.js';
+import { manifest } from '../factory/registry.js';
+import { checkWorkspaceStatus } from '../executor/workspace.js';
+import { configurePolicies, getActivePolicies, draftOnlyEmail, noDelete, readOnly, auditLog, } from '../factory/safety.js';
+function log(msg) {
+    process.stderr.write(`[gws-mcp] ${msg}\n`);
+}
+/** Configure safety policies from GWS_SAFETY_POLICY env var. */
+function initSafetyPolicies() {
+    const policyEnv = process.env.GWS_SAFETY_POLICY || '';
+    if (!policyEnv)
+        return;
+    const policyMap = {
+        'draft-only-email': draftOnlyEmail,
+        'no-delete': noDelete,
+        'read-only': readOnly,
+        'audit': auditLog,
+    };
+    const names = policyEnv.split(',').map(s => s.trim()).filter(Boolean);
+    const unknown = names.filter(name => !policyMap[name]);
+    if (unknown.length > 0) {
+        const valid = Object.keys(policyMap).join(', ');
+        throw new Error(`Unknown safety policy(ies): ${unknown.join(', ')}. ` +
+            `Valid policies: ${valid}`);
+    }
+    const policies = names.map(name => policyMap[name]);
+    configurePolicies(policies);
+}
+export function createServer() {
+    initSafetyPolicies();
+    log(`startup: ${toolSchemas.length} tools loaded`);
+    const server = new Server({
+        name: '@aaronsb/google-workspace-mcp',
+        version: '2.0.0-alpha.1',
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: toolSchemas.map(tool => ({
+                name: tool.name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+            })),
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            log(`call: ${name} ${JSON.stringify(args ?? {}).slice(0, 200)}`);
+            const result = await handleToolCall(name, (args ?? {}));
+            log(`done: ${name}`);
+            return {
+                content: [{ type: 'text', text: result.text }],
+            };
+        }
+        catch (err) {
+            if (err instanceof GwsError) {
+                // Append auth remediation guidance for auth errors
+                const email = args?.email;
+                const guidance = err.exitCode === GwsExitCode.AuthError
+                    ? nextSteps('accounts', 'auth_error', email ? { email } : undefined)
+                    : '';
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({
+                                error: err.message,
+                                exitCode: err.exitCode,
+                                reason: err.reason,
+                                stderr: err.stderr,
+                            }, null, 2) + guidance }],
+                    isError: true,
+                };
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // --- Resources ---
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return {
+            resources: [
+                {
+                    uri: 'gws://safety/policies',
+                    name: 'Active Safety Policies',
+                    description: 'Current safety policies controlling what operations are allowed, blocked, or audited',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'gws://config/services',
+                    name: 'Available Services',
+                    description: 'Google Workspace services and operations available through this server',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'gws://config/workspace',
+                    name: 'Workspace Directory',
+                    description: 'File I/O workspace directory status and path',
+                    mimeType: 'application/json',
+                },
+            ],
+        };
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        switch (uri) {
+            case 'gws://safety/policies': {
+                const policies = getActivePolicies();
+                const content = {
+                    active: policies.length > 0,
+                    policies: policies.map(p => ({
+                        name: p.name,
+                        description: p.description,
+                    })),
+                    summary: policies.length === 0
+                        ? 'No safety policies active — all operations are allowed.'
+                        : `${policies.length} policy(ies) active: ${policies.map(p => p.name).join(', ')}. ` +
+                            'Operations that violate these policies will be blocked with an explanation.',
+                };
+                return {
+                    contents: [{
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify(content, null, 2),
+                        }],
+                };
+            }
+            case 'gws://config/services': {
+                const services = Object.entries(manifest.services).map(([name, def]) => ({
+                    service: name,
+                    tool: def.tool_name,
+                    operations: Object.keys(def.operations),
+                    operationCount: Object.keys(def.operations).length,
+                }));
+                const content = {
+                    totalServices: services.length,
+                    totalOperations: services.reduce((sum, s) => sum + s.operationCount, 0),
+                    services,
+                };
+                return {
+                    contents: [{
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify(content, null, 2),
+                        }],
+                };
+            }
+            case 'gws://config/workspace': {
+                const status = checkWorkspaceStatus();
+                return {
+                    contents: [{
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify(status, null, 2),
+                        }],
+                };
+            }
+            default:
+                throw new Error(`Unknown resource: ${uri}`);
+        }
+    });
+    return server;
+}
+/** Warm up credentials on startup — validates accounts and refreshes tokens. */
+async function warmupAccounts() {
+    try {
+        const { listAccounts } = await import('../accounts/registry.js');
+        const accounts = await listAccounts();
+        if (accounts.length === 0) {
+            log('startup: no accounts configured');
+            return;
+        }
+        log(`startup: warming ${accounts.length} account(s)`);
+        for (const account of accounts) {
+            const email = account.email;
+            try {
+                const { hasCredential } = await import('../accounts/credentials.js');
+                if (await hasCredential(email)) {
+                    const { execute } = await import('../executor/gws.js');
+                    await execute(['gmail', 'users', 'getProfile', '--params', JSON.stringify({ userId: 'me' })], { account: email });
+                    log(`startup: ${email} — token valid`);
+                }
+                else {
+                    log(`startup: ${email} — no credential file`);
+                }
+            }
+            catch (err) {
+                log(`startup: ${email} — token invalid (${err.message})`);
+            }
+        }
+    }
+    catch (err) {
+        log(`startup: warmup failed (${err.message})`);
+    }
+}
+export async function startServer() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Non-blocking warmup — don't delay MCP handshake
+    warmupAccounts().catch(() => { });
+}
+//# sourceMappingURL=server.js.map

package/build/server/server.js.map

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

package/build/server/tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tool registry — combines factory-generated schemas with hand-coded tools.
+ *
+ * Factory tools come from the manifest (ADR-300). Hand-coded tools are
+ * manage_accounts (not a gws wrapper) and queue_operations (meta-tool).
+ */
+export interface ToolSchema {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export declare const toolSchemas: ToolSchema[];
+export declare function getToolSchema(name: string): ToolSchema | undefined;

package/build/server/tools.js

@@ -0,0 +1,99 @@
+/**
+ * Tool registry — combines factory-generated schemas with hand-coded tools.
+ *
+ * Factory tools come from the manifest (ADR-300). Hand-coded tools are
+ * manage_accounts (not a gws wrapper) and queue_operations (meta-tool).
+ */
+import { generatedTools } from '../factory/registry.js';
+// Hand-coded tools that don't go through the factory
+const handCodedSchemas = [
+    {
+        name: 'manage_accounts',
+        description: 'Manage Google Workspace account lifecycle: list, authenticate, check status, refresh credentials, update scopes, or remove accounts.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operation: {
+                    type: 'string',
+                    enum: ['list', 'authenticate', 'remove', 'status', 'refresh', 'scopes', 'capabilities'],
+                    description: 'list: show all accounts | authenticate: add new account (opens browser) | remove: delete account and credentials | status: check token validity and scopes | refresh: re-export credentials from gws | scopes: re-auth with different services | capabilities: show available services, safety policies, and workspace status',
+                },
+                email: { type: 'string', description: 'Required for remove, status, refresh, scopes' },
+                category: { type: 'string', enum: ['personal', 'work', 'other'], description: 'For authenticate (default: personal)' },
+                description: { type: 'string', description: 'For authenticate — optional label' },
+                services: { type: 'string', description: 'For scopes — comma-separated service names (e.g. gmail,drive,calendar,sheets)' },
+            },
+            required: ['operation'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'manage_workspace',
+        description: 'Read, write, list, or delete files in the workspace directory. The workspace is the exchange point for file operations (attachments, downloads, exports).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operation: {
+                    type: 'string',
+                    enum: ['list', 'read', 'write', 'delete'],
+                    description: 'list: show files in workspace | read: get file content | write: save content to file | delete: remove a file',
+                },
+                filename: { type: 'string', description: 'File name (for read, write, delete)' },
+                content: { type: 'string', description: 'File content to write (for write)' },
+            },
+            required: ['operation'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'queue_operations',
+        description: 'Execute multiple operations in sequence. Operations run in order with result references ($0.field) to chain outputs. Use for multi-step workflows.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operations: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            tool: {
+                                type: 'string',
+                                enum: ['manage_email', 'manage_calendar', 'manage_drive', 'manage_accounts'],
+                                description: 'Tool to call',
+                            },
+                            args: {
+                                type: 'object',
+                                description: 'Arguments for the tool. Use $N.field to reference results from earlier operations.',
+                            },
+                            onError: {
+                                type: 'string',
+                                enum: ['bail', 'continue'],
+                                description: 'bail: stop on error (default) | continue: skip and proceed',
+                            },
+                        },
+                        required: ['tool', 'args'],
+                    },
+                    maxItems: 10,
+                    description: 'Operations to execute sequentially',
+                },
+                detail: {
+                    type: 'string',
+                    enum: ['summary', 'full'],
+                    description: 'summary: one-line status per operation (default) | full: include complete output from each operation',
+                },
+            },
+            required: ['operations'],
+            additionalProperties: false,
+        },
+    },
+];
+// Factory-generated schemas from the shared registry
+const factorySchemas = generatedTools.map(t => t.schema);
+export const toolSchemas = [
+    ...handCodedSchemas,
+    ...factorySchemas,
+];
+export function getToolSchema(name) {
+    return toolSchemas.find(t => t.name === name);
+}
+//# sourceMappingURL=tools.js.map

package/build/server/tools.js.map

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