@kya-os/create-mcpi-app 0.6.4-canary.1

package/dist/helpers/fetch-xmcp-template.js

@@ -0,0 +1,127 @@
+import { execSync } from "child_process";
+import fs from "fs-extra";
+import path from "path";
+import chalk from "chalk";
+/**
+ * Scaffold XMCP project using the upstream xmcp npm package
+ * This follows the requirements specification to use the xmcp package
+ * with default caret ^0.3.1 and support for dist-tags
+ */
+export async function fetchXMCPTemplate(projectPath, options = {}) {
+    const { xmcpVersion, xmcpChannel = "latest", packageManager = "npm" } = options;
+    // Get XMCP package configuration from environment or use defaults
+    const xmcpPackageName = process.env.XMCP_PACKAGE_NAME || "xmcp";
+    const defaultCaret = process.env.XMCP_DEFAULT_CARET || "^0.3.1";
+    // Determine which version to use
+    let targetVersion = xmcpVersion || defaultCaret;
+    // If using a channel, check if the dist-tag exists
+    if (xmcpChannel === "next") {
+        try {
+            // Check if 'next' dist-tag exists
+            execSync(`npm view ${xmcpPackageName}@next version`, {
+                stdio: 'pipe'
+            });
+            targetVersion = "next";
+        }
+        catch (error) {
+            console.warn(chalk.yellow(`⚠️  dist-tag 'next' not available for ${xmcpPackageName}, falling back to ${defaultCaret}`));
+            targetVersion = defaultCaret;
+        }
+    }
+    try {
+        console.log(chalk.blue(`📦 Setting up XMCP project with ${xmcpPackageName}@${targetVersion}...`));
+        // Create package.json with xmcp dependency
+        // NOTE: Do NOT add "type": "module" as xmcp framework generates CommonJS code
+        const packageJson = {
+            name: path.basename(projectPath),
+            version: "0.1.0",
+            dependencies: {
+                [xmcpPackageName]: targetVersion,
+                // Other dependencies will be added by apply-identity-preset
+            },
+            scripts: {
+                // Basic scripts - will be enhanced by identity preset
+                dev: "xmcp dev",
+                build: "xmcp build",
+                start: "xmcp start"
+            }
+        };
+        // Write package.json
+        fs.ensureDirSync(projectPath);
+        fs.writeJsonSync(path.join(projectPath, "package.json"), packageJson, { spaces: 2 });
+        // Create basic XMCP project structure
+        const srcDir = path.join(projectPath, "src");
+        const toolsDir = path.join(srcDir, "tools");
+        const promptsDir = path.join(srcDir, "prompts");
+        const resourcesDir = path.join(srcDir, "resources");
+        fs.ensureDirSync(toolsDir);
+        fs.ensureDirSync(promptsDir);
+        fs.ensureDirSync(resourcesDir);
+        // Create a basic greet tool (XMCP default)
+        const greetToolContent = `import { z } from "zod";
+import { type InferSchema, type ToolMetadata } from "${xmcpPackageName}";
+
+// Define the schema for tool parameters
+export const schema = {
+  name: z.string().describe("The name of the user to greet"),
+};
+
+// Define tool metadata
+export const metadata: ToolMetadata = {
+  name: "greet",
+  description: "Greet the user",
+};
+
+// Tool implementation
+export default async function greet({ name }: InferSchema<typeof schema>) {
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: \`Hello, \${name}!\`,
+      },
+    ],
+  };
+}
+`;
+        fs.writeFileSync(path.join(toolsDir, "greet.ts"), greetToolContent);
+        // Create tools index (no .js extension needed for TypeScript imports)
+        const toolsIndexContent = `export * from "./greet";\n`;
+        fs.writeFileSync(path.join(toolsDir, "index.ts"), toolsIndexContent);
+        // Create prompts index (placeholder for xmcp)
+        const promptsIndexContent = `// Prompts can be defined here if needed\nexport {};\n`;
+        fs.writeFileSync(path.join(promptsDir, "index.ts"), promptsIndexContent);
+        // Create resources index with a comment
+        // Note: We don't export anything to avoid "Invalid file path format" warnings
+        // Users can add resources here when needed
+        const resourcesIndexContent = `// Resources can be defined here if needed
+// Example:
+// export const myResource = {
+//   name: "my-resource",
+//   description: "A sample resource",
+//   uri: "file:///path/to/resource"
+// };
+`;
+        fs.writeFileSync(path.join(resourcesDir, "index.ts"), resourcesIndexContent);
+        // Create basic xmcp.config.ts (will be enhanced by generate-config)
+        const configContent = `export default {
+  tools: "./src/tools",
+  transport: "stdio",
+};
+`;
+        fs.writeFileSync(path.join(projectPath, "xmcp.config.ts"), configContent);
+        // Create .gitignore
+        const gitignoreContent = `node_modules/
+dist/
+.env
+.env.local
+`;
+        fs.writeFileSync(path.join(projectPath, ".gitignore"), gitignoreContent);
+        console.log(chalk.green("✅ XMCP project structure created"));
+    }
+    catch (error) {
+        console.error(chalk.red("Failed to set up XMCP project:"), error);
+        throw error;
+    }
+}
+//# sourceMappingURL=fetch-xmcp-template.js.map

package/dist/helpers/fetch-xmcp-template.js.map

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

package/dist/helpers/generate-cloudflare-files.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Programmatic Cloudflare Project File Generation
+ *
+ * This module generates Cloudflare MCP-I project files in-memory,
+ * suitable for committing to GitHub via API (one-click deployment).
+ *
+ * Unlike fetchCloudflareMcpiTemplate (which writes to disk), this function
+ * returns file contents that can be committed programmatically.
+ *
+ * @module @kya-os/create-mcpi-app/helpers/generate-cloudflare-files
+ */
+/**
+ * Represents a generated file with its content
+ */
+export interface GeneratedFile {
+    /** Relative path from project root (e.g., "src/index.ts") */
+    path: string;
+    /** File content as string */
+    content: string;
+    /** Encoding type */
+    encoding: "utf-8" | "base64";
+}
+/**
+ * Options for generating Cloudflare project files
+ */
+export interface GenerateFilesOptions {
+    /** Project name (used for package.json, wrangler.toml, class names) */
+    projectName: string;
+    /** Template variant */
+    template?: "blank" | "ecommerce" | "hardware-world";
+    /** AgentShield project ID (pre-configured in wrangler.toml) */
+    agentShieldProjectId?: string;
+    /** AgentShield API URL (defaults to https://kya.vouched.id) */
+    agentShieldApiUrl?: string;
+    /** AgentShield API key (included in returned secrets for GitHub Secrets) */
+    agentShieldApiKey?: string;
+    /** Skip identity generation (for testing) */
+    skipIdentity?: boolean;
+    /** MCP Server URL for consent pages (e.g., "https://my-agent.user.workers.dev") */
+    serverUrl?: string;
+}
+/**
+ * Result of file generation
+ */
+export interface GenerateFilesResult {
+    /** All generated files */
+    files: GeneratedFile[];
+    /** Generated identity (DID, keys) */
+    identity: {
+        did: string;
+        publicKey: string;
+        privateKey: string;
+    };
+    /** Secrets that should be added to GitHub Secrets (not committed to repo) */
+    secrets: Record<string, string>;
+}
+/**
+ * Generate Cloudflare MCP-I project files in-memory
+ *
+ * This function generates all files needed for a Cloudflare Workers MCP-I project
+ * but returns them as strings instead of writing to disk. This enables
+ * programmatic deployment via GitHub API.
+ *
+ * @example
+ * ```typescript
+ * const result = await generateCloudflareProjectFiles({
+ *   projectName: "my-agent",
+ *   agentShieldProjectId: "my-project-abc123",
+ * });
+ *
+ * // Commit files to GitHub
+ * for (const file of result.files) {
+ *   await octokit.repos.createOrUpdateFileContents({
+ *     owner, repo,
+ *     path: file.path,
+ *     content: Buffer.from(file.content).toString("base64"),
+ *   });
+ * }
+ *
+ * // Add secrets to GitHub
+ * await octokit.actions.createOrUpdateRepoSecret({
+ *   owner, repo,
+ *   secret_name: "MCP_IDENTITY_PRIVATE_KEY",
+ *   encrypted_value: await encrypt(result.secrets.MCP_IDENTITY_PRIVATE_KEY),
+ * });
+ * ```
+ */
+export declare function generateCloudflareProjectFiles(options: GenerateFilesOptions): Promise<GenerateFilesResult>;
+//# sourceMappingURL=generate-cloudflare-files.d.ts.map

package/dist/helpers/generate-cloudflare-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-cloudflare-files.d.ts","sourceRoot":"","sources":["../../src/helpers/generate-cloudflare-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,gBAAgB,CAAC;IACpD,+DAA+D;IAC/D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qCAAqC;IACrC,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAgO9B"}