mcpill 1.3.0 → 1.6.0

package/src/compiler/serialize.ts

@@ -1,100 +0,0 @@
-import { writeFileSync, mkdirSync } from 'fs';
-import { join } from 'path';
-import type { ServerDoc, ResourceDoc } from './types.js';
-
-function serializeResources(resources: ResourceDoc[]): string {
-  return resources
-    .map((r) => {
-      let fm = `uri: ${r.uri}`;
-      if (r.name) fm += `\nname: ${r.name}`;
-      if (r.mimeType) fm += `\nmimeType: ${r.mimeType}`;
-      return `${fm}\n---\n${r.content}`;
-    })
-    .join('\n---\n');
-}
-
-export function serializeServerDoc(doc: ServerDoc): string {
-  const configSection =
-    `## Config\n\`\`\`json\n${JSON.stringify(doc.config, null, 2)}\n\`\`\``;
-
-  const toolParts = doc.tools.map((tool) => {
-    let part = `### ${tool.name}\n**Description:** ${tool.description}\n\n`;
-    part += `\`\`\`json\n${JSON.stringify(tool.schema, null, 2)}\n\`\`\``;
-    if (tool.handler !== undefined) {
-      part +=
-        `\n\n\`\`\`js\n// @handler:${tool.name}\n${tool.handler}\n// @end-handler:${tool.name}\n\`\`\``;
-    }
-    return part;
-  });
-  const toolsSection =
-    doc.tools.length > 0
-      ? `## Tools\n\n${toolParts.join('\n\n')}`
-      : `## Tools`;
-
-  const promptsSection =
-    `## Prompts\n\`\`\`json\n${JSON.stringify(doc.prompts, null, 2)}\n\`\`\``;
-
-  const resourcesSection =
-    doc.resources.length > 0
-      ? `## Resources\n${serializeResources(doc.resources)}`
-      : `## Resources`;
-
-  return [configSection, toolsSection, promptsSection, resourcesSection].join('\n\n') + '\n';
-}
-
-export function serializeServerDir(doc: ServerDoc, dir: string): void {
-  mkdirSync(join(dir, 'server', 'tools'), { recursive: true });
-  mkdirSync(join(dir, 'server', 'prompts'), { recursive: true });
-
-  let serverMd = '## Config\n';
-  serverMd += `name: ${doc.config.name}\n`;
-  serverMd += `transport: ${doc.config.transport}\n`;
-  if (doc.config.port !== undefined) serverMd += `port: ${doc.config.port}\n`;
-
-  if (doc.resources.length > 0) {
-    serverMd += `\n## Resources\n${serializeResources(doc.resources)}\n`;
-  } else {
-    serverMd += '\n## Resources\n';
-  }
-
-  writeFileSync(join(dir, 'server.md'), serverMd);
-  console.log('✓ server.md updated');
-
-  for (const tool of doc.tools) {
-    let md = `# ${tool.name}\n\n${tool.description}\n\n## Parameters\n\n`;
-    for (const [pName, pDef] of Object.entries(tool.schema)) {
-      md += `- ${pName} (${pDef.type}): ${pDef.description ?? pName}\n`;
-    }
-    if (tool.handler !== undefined) {
-      const cleanHandler = tool.handler
-        .split('\n')
-        .filter((l) => !l.trim().startsWith('// @handler:') && !l.trim().startsWith('// @end-handler:'))
-        .join('\n')
-        .trim();
-      md += `\n## Handler\n\n\`\`\`js\n${cleanHandler}\n\`\`\`\n`;
-    }
-    writeFileSync(join(dir, 'server', 'tools', `${tool.name}.md`), md);
-  }
-
-  for (const prompt of doc.prompts) {
-    let md = `# ${prompt.name}\n\n`;
-    if (prompt.description) md += `${prompt.description}\n\n`;
-    if (Object.keys(prompt.args).length > 0) {
-      md += '## Args\n\n';
-      for (const [argName, argDef] of Object.entries(prompt.args)) {
-        md += `- ${argName} (${argDef.type}): ${argName}\n`;
-      }
-      md += '\n';
-    }
-    if (prompt.messages.length > 0) {
-      md += '## Message\n\n';
-      for (const msg of prompt.messages) {
-        md += `> ${msg.role}: ${msg.content}\n`;
-      }
-    }
-    writeFileSync(join(dir, 'server', 'prompts', `${prompt.name}.md`), md);
-  }
-
-  console.log(`✓ tools/ updated (${doc.tools.length} files)`);
-  console.log(`✓ prompts/ updated (${doc.prompts.length} files)`);
-}

package/src/compiler/types.ts

@@ -1,27 +0,0 @@
-export type ToolDoc = {
-  name: string;
-  description: string;
-  schema: Record<string, { type: 'string' | 'number' | 'boolean'; description?: string }>;
-  handler?: string;
-};
-
-export type PromptDoc = {
-  name: string;
-  description?: string;
-  args: Record<string, { type: string }>;
-  messages: Array<{ role: string; content: string }>;
-};
-
-export type ResourceDoc = {
-  uri: string;
-  name?: string;
-  mimeType?: string;
-  content: string;
-};
-
-export type ServerDoc = {
-  config: { name: string; transport: 'stdio' | 'http'; port?: number };
-  tools: ToolDoc[];
-  prompts: PromptDoc[];
-  resources: ResourceDoc[];
-};

package/src/loaders/config.ts

@@ -1,25 +0,0 @@
-import fs from "fs";
-import path from "path";
-
-export type CliConfig = {
-  name: string;
-  transport: "stdio" | "http";
-  port: number;
-};
-
-const defaults: CliConfig = {
-  name: "mcpill-server",
-  transport: "stdio",
-  port: 3333,
-};
-
-export async function loadConfig(mcpillDir: string): Promise<CliConfig> {
-  const configPath = path.join(mcpillDir, "mcpill.config.json");
-  if (!fs.existsSync(configPath)) {
-    return { ...defaults };
-  }
-  const raw = JSON.parse(
-    fs.readFileSync(configPath, "utf-8")
-  ) as Partial<CliConfig>;
-  return { ...defaults, ...raw };
-}

package/src/loaders/prompts.ts

@@ -1,60 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { z } from "mcpill-runtime";
-
-type ZodRawShape = Record<string, z.ZodTypeAny>;
-
-export type RawPromptDef = {
-  name: string;
-  description?: string;
-  argsShape: ZodRawShape;
-  messages: Array<{ role: string; content: string }>;
-};
-
-const typeMap: Record<string, z.ZodTypeAny> = {
-  string: z.string(),
-  number: z.number(),
-  boolean: z.boolean(),
-};
-
-export async function loadPrompts(mcpillDir: string): Promise<RawPromptDef[]> {
-  const promptsPath = path.join(mcpillDir, "prompts.json");
-  let raw: unknown;
-  try {
-    const content = fs.readFileSync(promptsPath, "utf-8");
-    raw = JSON.parse(content);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    throw new Error(`prompts.json is not valid JSON: ${msg}`);
-  }
-
-  if (!Array.isArray(raw)) {
-    throw new Error("prompts.json is not valid JSON: must be an array");
-  }
-
-  const prompts: RawPromptDef[] = [];
-
-  for (const entry of raw as Array<Record<string, unknown>>) {
-    const argsShape: ZodRawShape = {};
-    const args = (entry["args"] ?? {}) as Record<string, { type: string }>;
-
-    for (const [argName, argDef] of Object.entries(args)) {
-      const typeName = argDef.type;
-      if (!(typeName in typeMap)) {
-        throw new Error(
-          `Prompt '${entry["name"]}': arg '${argName}' uses unsupported type '${typeName}'. Supported: string, number, boolean`
-        );
-      }
-      argsShape[argName] = typeMap[typeName]!;
-    }
-
-    prompts.push({
-      name: entry["name"] as string,
-      description: entry["description"] as string | undefined,
-      argsShape,
-      messages: entry["messages"] as Array<{ role: string; content: string }>,
-    });
-  }
-
-  return prompts;
-}

package/src/loaders/resources.ts

@@ -1,54 +0,0 @@
-import fs from "fs";
-import path from "path";
-
-export type RawResourceDef = {
-  uri: string;
-  name?: string;
-  mimeType?: string;
-  content: string;
-};
-
-function parseFrontmatter(block: string): Record<string, string> {
-  const result: Record<string, string> = {};
-  for (const line of block.split("\n")) {
-    const colonIdx = line.indexOf(":");
-    if (colonIdx === -1) continue;
-    const key = line.slice(0, colonIdx).trim();
-    const value = line.slice(colonIdx + 1).trim();
-    if (key) result[key] = value;
-  }
-  return result;
-}
-
-export async function loadResources(mcpillDir: string): Promise<RawResourceDef[]> {
-  const resourcesPath = path.join(mcpillDir, "resources.md");
-  const fileContent = fs.readFileSync(resourcesPath, "utf-8");
-  const blocks = fileContent.split("\n---\n");
-
-  const resources: RawResourceDef[] = [];
-
-  // blocks alternate: [frontmatter, body, frontmatter, body, ...]
-  // even indices (0-indexed) = frontmatter = block N (1-indexed odd)
-  for (let i = 0; i < blocks.length; i += 2) {
-    const frontmatterBlock = blocks[i] ?? "";
-    if (frontmatterBlock.trim() === "") continue;
-
-    const bodyBlock = blocks[i + 1] ?? "";
-    const frontmatter = parseFrontmatter(frontmatterBlock);
-
-    if (!frontmatter["uri"]) {
-      throw new Error(
-        `resources.md block ${i + 1} is missing required frontmatter field: uri`
-      );
-    }
-
-    resources.push({
-      uri: frontmatter["uri"],
-      name: frontmatter["name"],
-      mimeType: frontmatter["mimeType"],
-      content: bodyBlock.trim(),
-    });
-  }
-
-  return resources;
-}

package/src/loaders/tools.ts

@@ -1,68 +0,0 @@
-import { pathToFileURL } from "url";
-import path from "path";
-
-export type RawToolDef = {
-  name: string;
-  description: string;
-  schema: Record<string, unknown>;
-  // eslint-disable-next-line @typescript-eslint/ban-types
-  handler: Function;
-};
-
-export async function loadTools(mcpillDir: string): Promise<RawToolDef[]> {
-  const toolsPath = path.join(mcpillDir, "tools.js");
-  let mod: unknown;
-  try {
-    mod = await import(pathToFileURL(toolsPath).href);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    if (msg.includes("mcpill-runtime")) {
-      throw new Error(
-        "tools.js failed to load: mcpill-runtime not found.\nRun: npm install mcpill-runtime"
-      );
-    }
-    throw new Error(`tools.js failed to load: ${msg}`);
-  }
-
-  const tools = (mod as { default?: unknown }).default;
-  if (!Array.isArray(tools)) {
-    throw new Error("tools.js failed to load: default export must be an array");
-  }
-
-  for (let i = 0; i < tools.length; i++) {
-    const tool = tools[i] as Record<string, unknown>;
-
-    for (const field of ["name", "description", "schema", "handler"] as const) {
-      if (tool[field] === undefined || tool[field] === null) {
-        throw new Error(`Tool at index ${i} is missing required field: ${field}`);
-      }
-    }
-
-    if (typeof tool["name"] !== "string") {
-      throw new Error(`Tool at index ${i} is missing required field: name`);
-    }
-    if (typeof tool["description"] !== "string") {
-      throw new Error(`Tool at index ${i} is missing required field: description`);
-    }
-    if (
-      typeof tool["schema"] !== "object" ||
-      Array.isArray(tool["schema"]) ||
-      tool["schema"] === null
-    ) {
-      throw new Error(`Tool at index ${i} is missing required field: schema`);
-    }
-    const name = tool["name"] as string;
-    for (const [key, value] of Object.entries(tool["schema"] as Record<string, unknown>)) {
-      if (value == null || typeof value !== "object" || !("_def" in (value as object))) {
-        throw new Error(
-          `Tool '${name}': schema field '${key}' must be a Zod type (e.g. z.string()). Got a plain value instead.`
-        );
-      }
-    }
-    if (typeof tool["handler"] !== "function") {
-      throw new Error(`Tool '${tool["name"]}': handler must be a function`);
-    }
-  }
-
-  return tools as RawToolDef[];
-}

package/src/templates/prompts/greeting.md

@@ -1,11 +0,0 @@
-# greeting
-
-Generate a greeting
-
-## Args
-
-- name (string): The name to greet
-
-## Message
-
-> user: Say hello to {{name}}

package/src/templates/server.md

@@ -1,9 +0,0 @@
-## Config
-name: my-server
-transport: stdio
-
-## Resources
-uri: info://status
-name: Status
----
-The server is running.

package/src/templates/tools/echo.md

@@ -1,15 +0,0 @@
-# echo
-
-Echo a message back
-
-## Parameters
-
-- message (string): The message to echo
-
-## Handler
-
-```js
-async ({ message }) => {
-  return { content: [{ type: "text", text: message }] };
-}
-```

package/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "strict": true,
-    "outDir": "dist"
-  },
-  "include": ["src"]
-}

package/tsup.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/cli.ts"],
-  format: ["esm"],
-  target: "node18",
-  platform: "node",
-  shims: true,
-  banner: {
-    js: "#!/usr/bin/env node",
-  },
-  clean: true,
-});

package/vitest.config.ts

@@ -1,12 +0,0 @@
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: "node",
-    coverage: {
-      provider: "v8",
-      reporter: ["text", "lcov"],
-    },
-  },
-});