@getfoyer/mcp 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+import { createInterface } from 'readline';
+import { FoyerClient } from '@getfoyer/client';
+const client = new FoyerClient({
+    baseUrl: process.env.FOYER_API_URL ?? 'http://localhost:3001',
+    token: process.env.FOYER_TOKEN ?? '',
+});
+const tools = [
+    {
+        name: 'foyer_create_feature_with_plan',
+        description: 'Create a Foyer planning feature from an externally generated plan.',
+        inputSchema: {
+            type: 'object',
+            required: ['title', 'description', 'plan', 'agentSource', 'agentRunId'],
+            properties: {
+                repoId: { type: 'string' },
+                workspaceId: { type: 'string' },
+                title: { type: 'string' },
+                description: { type: 'string' },
+                plan: { type: 'string' },
+                agentSource: { type: 'string' },
+                agentRunId: { type: 'string' },
+                metadata: { type: 'object' },
+            },
+        },
+    },
+    {
+        name: 'foyer_get_feature',
+        description: 'Fetch a Foyer feature, including plan and tasks.',
+        inputSchema: {
+            type: 'object',
+            required: ['featureId'],
+            properties: { featureId: { type: 'string' } },
+        },
+    },
+    {
+        name: 'foyer_update_plan',
+        description: 'Update a Foyer feature plan while it is still in planning.',
+        inputSchema: {
+            type: 'object',
+            required: ['featureId', 'plan'],
+            properties: { featureId: { type: 'string' }, plan: { type: 'string' } },
+        },
+    },
+    {
+        name: 'foyer_decompose_feature',
+        description: 'Approve a feature plan and enqueue decomposition.',
+        inputSchema: {
+            type: 'object',
+            required: ['featureId'],
+            properties: { featureId: { type: 'string' } },
+        },
+    },
+    {
+        name: 'foyer_list_comments',
+        description: 'List feature comments for review and revision.',
+        inputSchema: {
+            type: 'object',
+            required: ['featureId'],
+            properties: { featureId: { type: 'string' } },
+        },
+    },
+    {
+        name: 'foyer_handoff_task',
+        description: 'Claim a decomposed Foyer task for an external coding agent and fetch its implementation context.',
+        inputSchema: {
+            type: 'object',
+            required: ['taskId', 'agent'],
+            properties: {
+                taskId: { type: 'string' },
+                agent: {
+                    type: 'string',
+                    enum: ['claude-code', 'codex', 'cursor', 'windsurf', 'generic'],
+                },
+                metadata: { type: 'object' },
+            },
+        },
+    },
+    {
+        name: 'foyer_list_integration_tokens',
+        description: 'List org integration tokens (admin only).',
+        inputSchema: {
+            type: 'object',
+            required: ['orgId'],
+            properties: { orgId: { type: 'string' } },
+        },
+    },
+];
+function textResult(value) {
+    return { content: [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }] };
+}
+function taskHandoffAgent(value) {
+    if (value === 'claude-code' || value === 'codex' || value === 'cursor' || value === 'windsurf' || value === 'generic') {
+        return value;
+    }
+    throw new Error(`Invalid agent: ${String(value)}`);
+}
+async function callTool(name, args) {
+    if (!process.env.FOYER_TOKEN)
+        throw new Error('FOYER_TOKEN is required');
+    switch (name) {
+        case 'foyer_create_feature_with_plan':
+            return textResult(await client.importPlan({
+                repoId: args.repoId,
+                workspaceId: args.workspaceId,
+                title: String(args.title ?? ''),
+                description: String(args.description ?? ''),
+                plan: String(args.plan ?? ''),
+                agentSource: String(args.agentSource ?? ''),
+                agentRunId: String(args.agentRunId ?? ''),
+                metadata: args.metadata,
+            }));
+        case 'foyer_get_feature':
+            return textResult(await client.getFeature(String(args.featureId ?? '')));
+        case 'foyer_update_plan':
+            return textResult(await client.updatePlan(String(args.featureId ?? ''), String(args.plan ?? '')));
+        case 'foyer_decompose_feature':
+            return textResult(await client.decomposeFeature(String(args.featureId ?? '')));
+        case 'foyer_list_comments':
+            return textResult(await client.listFeatureComments(String(args.featureId ?? '')));
+        case 'foyer_handoff_task':
+            return textResult(await client.handoffTask(String(args.taskId ?? ''), taskHandoffAgent(args.agent), args.metadata));
+        case 'foyer_list_integration_tokens':
+            return textResult(await client.listIntegrationTokens(String(args.orgId ?? '')));
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}
+async function handle(request) {
+    switch (request.method) {
+        case 'initialize':
+            return { protocolVersion: '2024-11-05', serverInfo: { name: 'foyer-mcp', version: '0.1.0' }, capabilities: { tools: {} } };
+        case 'tools/list':
+            return { tools };
+        case 'tools/call':
+            return callTool(String(request.params?.name ?? ''), (request.params?.arguments ?? {}));
+        default:
+            return {};
+    }
+}
+const rl = createInterface({ input: process.stdin, crlfDelay: Infinity });
+rl.on('line', async (line) => {
+    if (!line.trim())
+        return;
+    const request = JSON.parse(line);
+    try {
+        const result = await handle(request);
+        process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id: request.id ?? null, result })}\n`);
+    }
+    catch (err) {
+        process.stdout.write(`${JSON.stringify({
+            jsonrpc: '2.0',
+            id: request.id ?? null,
+            error: { code: -32000, message: err instanceof Error ? err.message : String(err) },
+        })}\n`);
+    }
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@getfoyer/mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "foyer-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/index.js",
+    "dist/index.js.map",
+    "dist/index.d.ts",
+    "dist/index.d.ts.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@getfoyer/client": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.2"
+  }
+}