golutra-mcp 0.1.0

package/dist/lib/toolkit.js

@@ -0,0 +1,354 @@
+import { z } from "zod";
+import { findProjectSkillByName, readProjectSkillDocument } from "./project-skills.js";
+import { buildToolError, buildToolSuccess } from "./tool-results.js";
+const optionalWorkspacePath = z.string().trim().min(1).optional();
+const optionalCliPath = z.string().trim().min(1).optional();
+const optionalProfile = z.enum(["dev", "canary", "stable"]).optional();
+const optionalTimeout = z.number().int().positive().max(300_000).optional();
+const optionalConversationId = z.string().trim().min(1).optional();
+const roadmapTaskSchema = z.object({
+    id: z.number().int().positive(),
+    number: z.string().trim().optional(),
+    title: z.string().trim().min(1),
+    status: z.enum(["pending", "in-progress", "done"]),
+    pinned: z.boolean().optional()
+});
+const roadmapSchema = z.object({
+    objective: z.string(),
+    tasks: z.array(roadmapTaskSchema)
+});
+export function registerTools(server, contextStore, gateway) {
+    server.registerTool("golutra-get-context", {
+        title: "Get Golutra MCP context",
+        description: "Read the current default golutra-cli path, profile, workspace path, and timeout."
+    }, () => buildToolSuccess("Current MCP context.", contextStore.getSnapshot()));
+    server.registerTool("golutra-set-context", {
+        title: "Set Golutra MCP context",
+        description: "Update the default golutra-cli path, profile, workspace path, or timeout for later tool calls.",
+        inputSchema: {
+            cliPath: optionalCliPath,
+            profile: optionalProfile,
+            workspacePath: optionalWorkspacePath,
+            timeoutMs: optionalTimeout
+        }
+    }, (input) => {
+        try {
+            const nextContext = contextStore.update(input);
+            return buildToolSuccess("Updated MCP context.", nextContext);
+        }
+        catch (error) {
+            return buildToolError(error);
+        }
+    });
+    server.registerTool("golutra-reset-context", {
+        title: "Reset Golutra MCP context",
+        description: "Reset the stored CLI path, profile, workspace path, and timeout back to the startup environment defaults."
+    }, () => buildToolSuccess("Reset MCP context to startup defaults.", contextStore.reset()));
+    server.registerTool("golutra-diagnose", {
+        title: "Diagnose Golutra connectivity",
+        description: "Check whether golutra-cli is callable and, when workspacePath and userId are available, whether the running Golutra app accepts workspace-scoped commands.",
+        inputSchema: {
+            userId: z.string().trim().min(1).optional(),
+            workspacePath: optionalWorkspacePath,
+            profile: optionalProfile,
+            cliPath: optionalCliPath,
+            timeoutMs: optionalTimeout
+        }
+    }, async (input) => {
+        const runtimeContext = contextStore.resolveCommandContext(input);
+        const diagnosis = {
+            context: runtimeContext,
+            checks: {
+                cli: {
+                    ok: false
+                },
+                app: {
+                    ok: false,
+                    skipped: true
+                }
+            }
+        };
+        try {
+            const skills = await gateway.listSkills(runtimeContext, {});
+            diagnosis.checks = {
+                ...diagnosis.checks,
+                cli: {
+                    ok: true,
+                    builtInSkillNames: Object.keys(skills.skills ?? {})
+                }
+            };
+        }
+        catch (error) {
+            diagnosis.checks = {
+                ...diagnosis.checks,
+                cli: {
+                    ok: false,
+                    error: buildToolError(error).structuredContent
+                }
+            };
+            return buildToolSuccess("Golutra diagnosis completed.", diagnosis);
+        }
+        const workspacePath = runtimeContext.workspacePath;
+        if (!workspacePath || !input.userId) {
+            diagnosis.checks = {
+                ...diagnosis.checks,
+                app: {
+                    ok: false,
+                    skipped: true,
+                    reason: "workspacePath and userId are both required for an app-backed chat.conversations.list probe."
+                }
+            };
+            return buildToolSuccess("Golutra diagnosis completed.", diagnosis);
+        }
+        try {
+            const conversations = await gateway.listConversations(runtimeContext, {
+                workspacePath,
+                userId: input.userId
+            });
+            diagnosis.checks = {
+                ...diagnosis.checks,
+                app: {
+                    ok: true,
+                    skipped: false,
+                    channelCount: Array.isArray(conversations.channels)
+                        ? conversations.channels.length
+                        : 0,
+                    defaultChannelId: conversations.defaultChannelId
+                }
+            };
+        }
+        catch (error) {
+            diagnosis.checks = {
+                ...diagnosis.checks,
+                app: {
+                    ok: false,
+                    skipped: false,
+                    error: buildToolError(error).structuredContent
+                }
+            };
+        }
+        return buildToolSuccess("Golutra diagnosis completed.", diagnosis);
+    });
+    server.registerTool("golutra-list-conversations", {
+        title: "List Golutra conversations",
+        description: "List channel and direct-message conversations visible to a workspace member.",
+        inputSchema: {
+            userId: z.string().trim().min(1),
+            workspacePath: optionalWorkspacePath,
+            profile: optionalProfile
+        }
+    }, async (input) => {
+        try {
+            const workspacePath = contextStore.requireWorkspacePath(input);
+            const runtimeContext = contextStore.resolveCommandContext(input);
+            const result = await gateway.listConversations(runtimeContext, {
+                workspacePath,
+                userId: input.userId
+            });
+            return buildToolSuccess("Listed conversations.", result);
+        }
+        catch (error) {
+            return buildToolError(error);
+        }
+    });
+    server.registerTool("golutra-list-messages", {
+        title: "List Golutra messages",
+        description: "Read recent messages from a Golutra channel or direct conversation.",
+        inputSchema: {
+            conversationId: z.string().trim().min(1),
+            workspacePath: optionalWorkspacePath,
+            profile: optionalProfile,
+            limit: z.number().int().positive().max(200).optional(),
+            beforeId: z.string().trim().min(1).optional()
+        }
+    }, async (input) => {
+        try {
+            const workspacePath = contextStore.requireWorkspacePath(input);
+            const runtimeContext = contextStore.resolveCommandContext(input);
+            const result = await gateway.listMessages(runtimeContext, {
+                workspacePath,
+                conversationId: input.conversationId,
+                limit: input.limit,
+                beforeId: input.beforeId
+            });
+            return buildToolSuccess("Listed messages.", result);
+        }
+        catch (error) {
+            return buildToolError(error);
+        }
+    });
+    server.registerTool("golutra-send-message", {
+        title: "Send a Golutra message",
+        description: "Send a Golutra chat message through golutra-cli using a structured chat.send payload.",
+        inputSchema: {
+            conversationId: z.string().trim().min(1),
+            senderId: z.string().trim().min(1),
+            text: z.string().trim().min(1),
+            mentionIds: z.array(z.string().trim().min(1)).min(1),
+            workspacePath: optionalWorkspacePath,
+            profile: optionalProfile
+        }
+    }, async (input) => {
+        try {
+            const workspacePath = contextStore.requireWorkspacePath(input);
+            const runtimeContext = contextStore.resolveCommandContext(input);
+            const result = await gateway.sendMessage(runtimeContext, {
+                workspacePath,
+                conversationId: input.conversationId,
+                senderId: input.senderId,
+                text: input.text,
+                mentionIds: input.mentionIds
+            });
+            return buildToolSuccess("Sent message.", result);
+        }
+        catch (error) {
+            return buildToolError(error);
+        }
+    });
+    server.registerTool("golutra-read-roadmap", {
+        title: "Read Golutra roadmap",
+        description: "Read the workspace roadmap or a conversation-specific roadmap through golutra-cli.",
+        inputSchema: {
+            conversationId: optionalConversationId,
+            workspacePath: optionalWorkspacePath,
+            profile: optionalProfile
+        }
+    }, async (input) => {
+        try {
+            const workspacePath = contextStore.requireWorkspacePath(input);
+            const runtimeContext = contextStore.resolveCommandContext(input);
+            const result = await gateway.readRoadmap(runtimeContext, {
+                workspacePath,
+                ...(input.conversationId ? { conversationId: input.conversationId } : {})
+            });
+            return buildToolSuccess("Read roadmap.", result);
+        }
+        catch (error) {
+            return buildToolError(error);
+        }
+    });
+    server.registerTool("golutra-update-roadmap", {
+        title: "Update Golutra roadmap",
+        description: "Replace the current workspace or conversation roadmap through golutra-cli.",
+        inputSchema: {
+            conversationId: optionalConversationId,
+            workspacePath: optionalWorkspacePath,
+            profile: optionalProfile,
+            readOnly: z.boolean().optional(),
+            roadmap: roadmapSchema
+        }
+    }, async (input) => {
+        try {
+            const workspacePath = contextStore.requireWorkspacePath(input);
+            const runtimeContext = contextStore.resolveCommandContext(input);
+            const result = await gateway.updateRoadmap(runtimeContext, {
+                workspacePath,
+                ...(input.conversationId ? { conversationId: input.conversationId } : {}),
+                ...(typeof input.readOnly === "boolean" ? { readOnly: input.readOnly } : {}),
+                roadmap: input.roadmap
+            });
+            return buildToolSuccess("Updated roadmap.", result);
+        }
+        catch (error) {
+            return buildToolError(error);
+        }
+    });
+    server.registerTool("golutra-list-skills", {
+        title: "List Golutra CLI skills",
+        description: "List built-in golutra-cli skills and optionally append workspace project skills.",
+        inputSchema: {
+            workspacePath: optionalWorkspacePath,
+            profile: optionalProfile
+        }
+    }, async (input) => {
+        try {
+            const runtimeContext = contextStore.resolveCommandContext(input);
+            const workspacePath = runtimeContext.workspacePath;
+            const result = await gateway.listSkills(runtimeContext, {
+                ...(workspacePath ? { workspacePath } : {})
+            });
+            return buildToolSuccess("Listed skills.", result);
+        }
+        catch (error) {
+            return buildToolError(error);
+        }
+    });
+    server.registerTool("golutra-get-skill", {
+        title: "Get Golutra CLI skill detail",
+        description: "Read the detailed schema for a built-in golutra-cli skill.",
+        inputSchema: {
+            skillName: z.string().trim().min(1),
+            profile: optionalProfile
+        }
+    }, async (input) => {
+        try {
+            const runtimeContext = contextStore.resolveCommandContext(input);
+            const result = await gateway.getSkill(runtimeContext, input.skillName);
+            return buildToolSuccess(`Loaded skill ${input.skillName}.`, result);
+        }
+        catch (error) {
+            return buildToolError(error);
+        }
+    });
+    server.registerTool("golutra-validate-skill", {
+        title: "Validate a Golutra skill directory",
+        description: "Run golutra-cli skill-validate against a local skill directory that contains SKILL.md.",
+        inputSchema: {
+            skillPath: z.string().trim().min(1),
+            profile: optionalProfile
+        }
+    }, async (input) => {
+        try {
+            const runtimeContext = contextStore.resolveCommandContext(input);
+            const result = await gateway.validateSkill(runtimeContext, input.skillPath);
+            return buildToolSuccess("Validated skill.", result);
+        }
+        catch (error) {
+            return buildToolError(error);
+        }
+    });
+    server.registerTool("golutra-list-project-skills", {
+        title: "List Golutra project skills",
+        description: "List only workspace-resolved project skills discovered from .golutra/skills.",
+        inputSchema: {
+            workspacePath: optionalWorkspacePath,
+            profile: optionalProfile
+        }
+    }, async (input) => {
+        try {
+            const workspacePath = contextStore.requireWorkspacePath(input);
+            const runtimeContext = contextStore.resolveCommandContext(input);
+            const result = await gateway.listSkills(runtimeContext, { workspacePath });
+            return buildToolSuccess("Listed project skills.", {
+                projectSkillsRoot: result.projectSkillsRoot,
+                projectSkills: result.projectSkills ?? [],
+                projectSkillsNote: result.projectSkillsNote
+            });
+        }
+        catch (error) {
+            return buildToolError(error);
+        }
+    });
+    server.registerTool("golutra-read-project-skill", {
+        title: "Read a Golutra project skill document",
+        description: "Discover a workspace project skill by name and return its SKILL.md content.",
+        inputSchema: {
+            skillName: z.string().trim().min(1),
+            workspacePath: optionalWorkspacePath,
+            profile: optionalProfile
+        }
+    }, async (input) => {
+        try {
+            const workspacePath = contextStore.requireWorkspacePath(input);
+            const runtimeContext = contextStore.resolveCommandContext(input);
+            const skills = await gateway.listSkills(runtimeContext, { workspacePath });
+            const projectSkill = findProjectSkillByName(skills, input.skillName);
+            const result = await readProjectSkillDocument(projectSkill);
+            return buildToolSuccess(`Read project skill ${input.skillName}.`, result);
+        }
+        catch (error) {
+            return buildToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=toolkit.js.map

package/dist/lib/toolkit.js.map

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

package/dist/lib/types.d.ts

@@ -0,0 +1,116 @@
+export declare const GOLUTRA_PROFILES: readonly ["dev", "canary", "stable"];
+export type GolutraProfile = (typeof GOLUTRA_PROFILES)[number];
+export interface RuntimeContextSnapshot {
+    cliPath: string;
+    profile?: GolutraProfile | undefined;
+    workspacePath?: string | undefined;
+    timeoutMs: number;
+}
+export interface CommandContextInput {
+    cliPath?: string | undefined;
+    profile?: GolutraProfile | undefined;
+    workspacePath?: string | undefined;
+    timeoutMs?: number | undefined;
+}
+export interface CliCommandRequest {
+    cliPath: string;
+    args: string[];
+    timeoutMs: number;
+}
+export interface StructuredCommandEnvelope {
+    ok: boolean;
+    requestId?: string | undefined;
+    result?: {
+        status: string;
+        message?: string | undefined;
+        data?: unknown;
+    } | undefined;
+    error?: string | undefined;
+}
+export interface ListSkillsResponse {
+    skills?: Record<string, {
+        description?: string | undefined;
+    }> | undefined;
+    projectSkillsRoot?: string | undefined;
+    projectSkills?: ProjectSkillDescriptor[] | undefined;
+    projectSkillsNote?: string | undefined;
+}
+export interface ProjectSkillDescriptor {
+    name: string;
+    targetPath: string;
+    skillMdPath: string;
+    relativePath: string;
+}
+export interface SkillValidationResult {
+    ok?: boolean | undefined;
+    message?: string | undefined;
+    errors?: unknown[] | undefined;
+}
+export interface ChatConversationsListData {
+    channels?: unknown[] | undefined;
+    directs?: unknown[] | undefined;
+    conversations?: unknown[] | undefined;
+    defaultChannelId?: string | undefined;
+}
+export interface ChatMessagesListData {
+    messages?: unknown[] | undefined;
+}
+export interface ChatSendData {
+    messageId?: string | undefined;
+}
+export interface RoadmapResultData {
+    workspaceId?: string | undefined;
+    workspacePath?: string | undefined;
+    conversationId?: string | null | undefined;
+    roadmap?: unknown;
+    source?: string | undefined;
+    storage?: string | undefined;
+    warning?: string | undefined;
+}
+export type StructuredCommand = {
+    type: "chat.send";
+    payload: {
+        workspacePath: string;
+        conversationId: string;
+        senderId: string;
+        text: string;
+        mentionIds: string[];
+    };
+} | {
+    type: "chat.conversations.list";
+    payload: {
+        workspacePath: string;
+        userId: string;
+    };
+} | {
+    type: "chat.messages.list";
+    payload: {
+        workspacePath: string;
+        conversationId: string;
+        limit?: number | undefined;
+        beforeId?: string | undefined;
+    };
+} | {
+    type: "roadmap.read";
+    payload: {
+        workspacePath: string;
+        conversationId?: string | undefined;
+    };
+} | {
+    type: "roadmap.update";
+    payload: {
+        workspacePath: string;
+        conversationId?: string | undefined;
+        readOnly?: boolean | undefined;
+        roadmap: {
+            objective: string;
+            tasks: Array<{
+                id: number;
+                number?: string | undefined;
+                title: string;
+                status: "pending" | "in-progress" | "done";
+                pinned?: boolean | undefined;
+            }>;
+        };
+    };
+};

package/dist/lib/types.js

@@ -0,0 +1,2 @@
+export const GOLUTRA_PROFILES = ["dev", "canary", "stable"];
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "golutra-mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for Golutra via golutra-cli.",
+  "type": "module",
+  "private": false,
+  "author": "Golutra Contributors",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/golutra/golutra-mcp.git"
+  },
+  "homepage": "https://github.com/golutra/golutra-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/golutra/golutra-mcp/issues"
+  },
+  "bin": {
+    "golutra-mcp": "dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    ".env.example",
+    "README.md",
+    "startup_processmd.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.11"
+  },
+  "keywords": [
+    "golutra",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "cli"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.21.0",
+    "@types/node": "^22.13.0",
+    "eslint": "^9.21.0",
+    "globals": "^15.15.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0",
+    "typescript-eslint": "^8.25.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "npm run lint && npm run typecheck && npm run test && npm run build",
+    "clean": "node --eval \"for (const path of ['dist','coverage']) { try { require('node:fs').rmSync(path, { recursive: true, force: true }); } catch {} }\"",
+    "dev": "tsx src/index.ts",
+    "lint": "eslint .",
+    "package:check": "npm pack --dry-run",
+    "prepack": "npm run build",
+    "test:e2e": "npm run build && node scripts/e2e-smoke.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}