@kya-os/create-mcpi-app 1.8.45 → 1.8.47

package/dist/helpers/generate-cloudflare-files.js

@@ -0,0 +1,800 @@
+/**
+ * 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
+ */
+import crypto from "crypto";
+import { generateIdentity, } from "./generate-identity.js";
+/**
+ * KV binding names (matches env-mapper.ts for consistency)
+ */
+const KV_BINDING_NAMES = [
+    "NONCE_CACHE",
+    "PROOF_ARCHIVE",
+    "IDENTITY_STORAGE",
+    "DELEGATION_STORAGE",
+    "TOOL_PROTECTION_KV",
+];
+/**
+ * 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 async function generateCloudflareProjectFiles(options) {
+    const { projectName, template = "blank", agentShieldProjectId, agentShieldApiUrl = "https://kya.vouched.id", agentShieldApiKey, skipIdentity = false, } = options;
+    const projectNameUpper = projectName.toUpperCase().replace(/-/g, "_");
+    const pascalCaseName = toPascalCase(projectName);
+    // Generate identity
+    let identity;
+    if (skipIdentity) {
+        identity = {
+            did: "did:key:zTestMockIdentity",
+            kid: "did:key:zTestMockIdentity#key-1",
+            privateKey: "mock-private-key",
+            publicKey: "mock-public-key",
+            createdAt: new Date().toISOString(),
+            type: "development",
+        };
+    }
+    else {
+        identity = await generateIdentity();
+    }
+    // Generate OAuth encryption secret
+    const oauthEncryptionSecret = crypto.randomBytes(32).toString("hex");
+    const files = [];
+    // 1. package.json
+    files.push({
+        path: "package.json",
+        content: JSON.stringify({
+            name: projectName,
+            version: "0.1.0",
+            private: true,
+            scripts: {
+                deploy: "wrangler deploy",
+                dev: "wrangler dev",
+                start: "wrangler dev",
+                test: "vitest",
+                "cf-typegen": "wrangler types",
+            },
+            dependencies: {
+                "@kya-os/mcp-i-cloudflare": "^1.6.45",
+                "@modelcontextprotocol/sdk": "1.24.0",
+                agents: "0.2.30",
+                hono: "4.10.3",
+            },
+            devDependencies: {
+                "@cloudflare/vitest-pool-workers": "^0.5.41",
+                "@cloudflare/workers-types": "^4.20251126.0",
+                "@types/node": "^20.8.3",
+                typescript: "^5.5.2",
+                vitest: "^2.0.5",
+                wrangler: "^4.53.0",
+            },
+        }, null, 2),
+        encoding: "utf-8",
+    });
+    // 2. wrangler.toml (NO private key - that goes to GitHub Secrets)
+    files.push({
+        path: "wrangler.toml",
+        content: generateWranglerToml({
+            projectName,
+            projectNameUpper,
+            pascalCaseName,
+            agentDid: identity.did,
+            publicKey: identity.publicKey,
+            agentShieldProjectId,
+            agentShieldApiUrl,
+        }),
+        encoding: "utf-8",
+    });
+    // 3. .dev.vars.example (template for local dev, not the actual secrets)
+    files.push({
+        path: ".dev.vars.example",
+        content: `# Copy this to .dev.vars for local development
+# For production, secrets are managed via GitHub Secrets + Cloudflare
+
+# Agent Identity (DO NOT COMMIT .dev.vars)
+MCP_IDENTITY_PRIVATE_KEY="your-private-key-here"
+
+# OAuth Encryption Secret (required for OAuth/delegation flows)
+OAUTH_ENCRYPTION_SECRET="your-oauth-secret-here"
+
+# AgentShield API Key
+AGENTSHIELD_API_KEY="sk_your_api_key_here"
+
+# Admin API Key (optional, falls back to AGENTSHIELD_API_KEY)
+# ADMIN_API_KEY="sk_your_admin_key_here"
+`,
+        encoding: "utf-8",
+    });
+    // 4. .gitignore
+    files.push({
+        path: ".gitignore",
+        content: `node_modules/
+dist/
+.wrangler/
+.dev.vars
+*.log
+.DS_Store
+`,
+        encoding: "utf-8",
+    });
+    // 5. tsconfig.json
+    files.push({
+        path: "tsconfig.json",
+        content: JSON.stringify({
+            compilerOptions: {
+                target: "esnext",
+                module: "esnext",
+                moduleResolution: "bundler",
+                types: ["@cloudflare/workers-types", "vitest/globals"],
+                strict: true,
+                skipLibCheck: true,
+                noEmit: true,
+            },
+            include: ["src/**/*"],
+            exclude: ["node_modules"],
+        }, null, 2),
+        encoding: "utf-8",
+    });
+    // 6. src/index.ts
+    files.push({
+        path: "src/index.ts",
+        content: generateIndexTs(projectName, projectNameUpper, pascalCaseName),
+        encoding: "utf-8",
+    });
+    // 7. src/agent.ts
+    files.push({
+        path: "src/agent.ts",
+        content: generateAgentTs(projectName, projectNameUpper, pascalCaseName),
+        encoding: "utf-8",
+    });
+    // 8. src/mcpi-runtime-config.ts
+    files.push({
+        path: "src/mcpi-runtime-config.ts",
+        content: generateRuntimeConfigTs(template),
+        encoding: "utf-8",
+    });
+    // 9. src/tools/greet.ts (always included)
+    files.push({
+        path: "src/tools/greet.ts",
+        content: generateGreetToolTs(projectName),
+        encoding: "utf-8",
+    });
+    // 10. Add template-specific tools
+    if (template === "ecommerce") {
+        files.push(...generateEcommerceTools());
+    }
+    else if (template === "hardware-world") {
+        files.push(...generateHardwareWorldTools());
+    }
+    // 11. GitHub Actions workflow
+    files.push({
+        path: ".github/workflows/deploy.yml",
+        content: generateDeployWorkflow(),
+        encoding: "utf-8",
+    });
+    // 12. README.md
+    files.push({
+        path: "README.md",
+        content: generateReadme(projectName, agentShieldProjectId),
+        encoding: "utf-8",
+    });
+    // Build secrets object - always include identity and OAuth secrets
+    const secrets = {
+        MCP_IDENTITY_PRIVATE_KEY: identity.privateKey,
+        OAUTH_ENCRYPTION_SECRET: oauthEncryptionSecret,
+    };
+    // Include AgentShield API key if provided
+    if (agentShieldApiKey) {
+        secrets.AGENTSHIELD_API_KEY = agentShieldApiKey;
+    }
+    return {
+        files,
+        identity: {
+            did: identity.did,
+            publicKey: identity.publicKey,
+            privateKey: identity.privateKey,
+        },
+        secrets,
+    };
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function toPascalCase(str) {
+    const result = str
+        .replace(/(?:^\w|[A-Z]|\b\w)/g, (word) => word.toUpperCase())
+        .replace(/\s+/g, "")
+        .replace(/-/g, "")
+        .replace(/[^a-zA-Z0-9]/g, "");
+    let className = result || "Project";
+    if (/^\d/.test(className)) {
+        className = "_" + className;
+    }
+    return className;
+}
+function generateWranglerToml(opts) {
+    const { projectName, projectNameUpper, pascalCaseName, agentDid, publicKey, agentShieldProjectId, agentShieldApiUrl, } = opts;
+    return `#:schema node_modules/wrangler/config-schema.json
+name = "${projectName}"
+main = "src/index.ts"
+compatibility_date = "2025-01-01"
+compatibility_flags = ["nodejs_compat"]
+
+# Durable Object binding for MCP Agent state
+[[durable_objects.bindings]]
+name = "MCP_OBJECT"
+class_name = "${pascalCaseName}MCP"
+
+[[migrations]]
+tag = "v1"
+new_sqlite_classes = ["${pascalCaseName}MCP"]
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# KV NAMESPACES - Auto-provisioned by Wrangler v4.45+
+# ═══════════════════════════════════════════════════════════════════════════════
+# Just run: npm run deploy (KV namespaces are created automatically!)
+
+[[kv_namespaces]]
+binding = "${projectNameUpper}_${KV_BINDING_NAMES[0]}"
+
+[[kv_namespaces]]
+binding = "${projectNameUpper}_${KV_BINDING_NAMES[1]}"
+
+[[kv_namespaces]]
+binding = "${projectNameUpper}_${KV_BINDING_NAMES[2]}"
+
+[[kv_namespaces]]
+binding = "${projectNameUpper}_${KV_BINDING_NAMES[3]}"
+
+[[kv_namespaces]]
+binding = "${projectNameUpper}_${KV_BINDING_NAMES[4]}"
+
+[vars]
+# Agent DID (public identifier - safe to commit)
+MCP_IDENTITY_AGENT_DID = "${agentDid}"
+
+# Public identity key (safe to commit)
+MCP_IDENTITY_PUBLIC_KEY = "${publicKey}"
+
+# CORS origins
+ALLOWED_ORIGINS = "https://claude.ai,https://app.anthropic.com"
+
+# Durable Object routing
+DO_ROUTING_STRATEGY = "session"
+DO_SHARD_COUNT = "10"
+
+XMCP_I_TS_SKEW_SEC = "120"
+XMCP_I_SESSION_TTL = "1800"
+
+# AgentShield Integration
+AGENTSHIELD_API_URL = "${agentShieldApiUrl}"
+${agentShieldProjectId ? `AGENTSHIELD_PROJECT_ID = "${agentShieldProjectId}"` : '# AGENTSHIELD_PROJECT_ID = "your-project-id"'}
+
+MCPI_ENV = "development"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+# SECRETS (managed via GitHub Secrets + wrangler secret)
+# ═══════════════════════════════════════════════════════════════════════════════
+# These are automatically deployed via GitHub Actions workflow.
+# For local development, copy .dev.vars.example to .dev.vars
+`;
+}
+function generateIndexTs(projectName, projectNameUpper, pascalCaseName) {
+    return `import { createMCPIApp } from "@kya-os/mcp-i-cloudflare";
+import { ${pascalCaseName}MCP } from "./agent";
+import { getRuntimeConfig } from "./mcpi-runtime-config";
+
+export default createMCPIApp({
+  AgentClass: ${pascalCaseName}MCP,
+  getRuntimeConfig,
+  envPrefix: "${projectNameUpper}",
+});
+
+// Export Durable Object class for Cloudflare Workers binding
+export { ${pascalCaseName}MCP };
+`;
+}
+function generateAgentTs(projectName, projectNameUpper, pascalCaseName) {
+    return `import { MCPICloudflareAgent, type CloudflareEnv } from "@kya-os/mcp-i-cloudflare";
+import { getRuntimeConfig, getTools } from "./mcpi-runtime-config";
+import type { CloudflareRuntimeConfig } from "@kya-os/mcp-i-cloudflare";
+
+/**
+ * MCP-I Agent Implementation
+ */
+export class ${pascalCaseName}MCP extends MCPICloudflareAgent {
+  protected getAgentName(): string {
+    return "${projectName}";
+  }
+
+  protected getAgentVersion(): string {
+    return "1.0.0";
+  }
+
+  protected getEnvPrefix(): string | undefined {
+    return "${projectNameUpper}";
+  }
+
+  protected getRuntimeConfigInternal(env: CloudflareEnv): CloudflareRuntimeConfig {
+    return getRuntimeConfig(env);
+  }
+
+  protected async registerTools(): Promise<void> {
+    const tools = getTools();
+    for (const toolDef of tools) {
+      this.registerToolWithProof(
+        toolDef.name,
+        toolDef.description,
+        toolDef.inputSchema,
+        toolDef.handler
+      );
+    }
+  }
+}
+`;
+}
+function generateRuntimeConfigTs(template) {
+    const imports = [`import { greetTool } from "./tools/greet";`];
+    const tools = ["greetTool"];
+    if (template === "ecommerce") {
+        imports.push(`import { addToCartTool } from "./tools/add-to-cart";`);
+        imports.push(`import { getCartTool } from "./tools/get-cart";`);
+        imports.push(`import { checkoutTool } from "./tools/checkout";`);
+        tools.push("addToCartTool", "getCartTool", "checkoutTool");
+    }
+    else if (template === "hardware-world") {
+        imports.push(`import { addToCartTool } from "./tools/add-to-cart";`);
+        imports.push(`import { getCartTool } from "./tools/get-cart";`);
+        imports.push(`import { removeFromCartTool } from "./tools/remove-from-cart";`);
+        imports.push(`import { searchProductsTool } from "./tools/search-products";`);
+        tools.push("addToCartTool", "getCartTool", "removeFromCartTool", "searchProductsTool");
+    }
+    return `import { defineConfig, type CloudflareRuntimeConfig } from "@kya-os/mcp-i-cloudflare";
+import type { CloudflareEnv } from "@kya-os/mcp-i-cloudflare";
+${imports.join("\n")}
+
+export function getRuntimeConfig(env: CloudflareEnv): CloudflareRuntimeConfig {
+  const environment = (env.MCPI_ENV || env.ENVIRONMENT || "development") as "development" | "production";
+
+  const proofingConfig = env.AGENTSHIELD_API_KEY
+    ? {
+        enabled: true,
+        batchQueue: {
+          destinations: [
+            {
+              type: "agentshield" as const,
+              apiKey: env.AGENTSHIELD_API_KEY,
+              apiUrl: env.AGENTSHIELD_API_URL || "https://kya.vouched.id",
+            },
+          ],
+        },
+      }
+    : undefined;
+
+  return defineConfig({
+    environment,
+    proofing: proofingConfig,
+    vars: {
+      ENVIRONMENT: environment,
+      AGENTSHIELD_API_KEY: env.AGENTSHIELD_API_KEY,
+      AGENTSHIELD_API_URL: env.AGENTSHIELD_API_URL,
+      AGENTSHIELD_PROJECT_ID: env.AGENTSHIELD_PROJECT_ID,
+    },
+  });
+}
+
+export function getTools() {
+  return [
+    ${tools.join(",\n    ")},
+  ];
+}
+`;
+}
+function generateGreetToolTs(projectName) {
+    return `import type { ToolDefinition } from "@kya-os/mcp-i-cloudflare";
+
+export const greetTool: ToolDefinition = {
+  name: "greet",
+  description: "Greet the user",
+  inputSchema: {
+    type: "object",
+    properties: {
+      name: { type: "string", description: "Name of the person to greet" },
+    },
+    required: ["name"],
+  },
+  handler: async (args: { name: string }) => {
+    return {
+      content: [
+        {
+          type: "text",
+          text: \`Hello, \${args.name}! Welcome to ${projectName}.\`,
+        },
+      ],
+    };
+  },
+};
+`;
+}
+function generateEcommerceTools() {
+    return [
+        {
+            path: "src/tools/add-to-cart.ts",
+            content: `import type { ToolDefinition } from "@kya-os/mcp-i-cloudflare";
+
+export const addToCartTool: ToolDefinition = {
+  name: "add_to_cart",
+  description: "Add an item to the shopping cart",
+  inputSchema: {
+    type: "object",
+    properties: {
+      productId: { type: "string", description: "Product ID to add" },
+      quantity: { type: "number", description: "Quantity to add", default: 1 },
+    },
+    required: ["productId"],
+  },
+  handler: async (args: { productId: string; quantity?: number }) => {
+    const quantity = args.quantity || 1;
+    return {
+      content: [
+        {
+          type: "text",
+          text: \`Added \${quantity}x product \${args.productId} to cart.\`,
+        },
+      ],
+    };
+  },
+};
+`,
+            encoding: "utf-8",
+        },
+        {
+            path: "src/tools/get-cart.ts",
+            content: `import type { ToolDefinition } from "@kya-os/mcp-i-cloudflare";
+
+export const getCartTool: ToolDefinition = {
+  name: "get_cart",
+  description: "Get the current shopping cart contents",
+  inputSchema: {
+    type: "object",
+    properties: {},
+  },
+  handler: async () => {
+    return {
+      content: [
+        {
+          type: "text",
+          text: "Your cart is currently empty. Add some items!",
+        },
+      ],
+    };
+  },
+};
+`,
+            encoding: "utf-8",
+        },
+        {
+            path: "src/tools/checkout.ts",
+            content: `import type { ToolDefinition } from "@kya-os/mcp-i-cloudflare";
+
+export const checkoutTool: ToolDefinition = {
+  name: "checkout",
+  description: "Proceed to checkout with the current cart",
+  inputSchema: {
+    type: "object",
+    properties: {
+      paymentMethod: {
+        type: "string",
+        description: "Payment method (credit_card, paypal, etc.)",
+      },
+    },
+    required: ["paymentMethod"],
+  },
+  handler: async (args: { paymentMethod: string }) => {
+    return {
+      content: [
+        {
+          type: "text",
+          text: \`Checkout initiated with \${args.paymentMethod}. Redirecting to payment...\`,
+        },
+      ],
+    };
+  },
+};
+`,
+            encoding: "utf-8",
+        },
+    ];
+}
+function generateHardwareWorldTools() {
+    return [
+        {
+            path: "src/tools/add-to-cart.ts",
+            content: `import type { ToolDefinition } from "@kya-os/mcp-i-cloudflare";
+
+export const addToCartTool: ToolDefinition = {
+  name: "add_to_cart",
+  description: "Add a hardware product to the cart",
+  inputSchema: {
+    type: "object",
+    properties: {
+      productId: { type: "string", description: "Hardware product ID" },
+      quantity: { type: "number", description: "Quantity", default: 1 },
+    },
+    required: ["productId"],
+  },
+  handler: async (args: { productId: string; quantity?: number }) => {
+    const quantity = args.quantity || 1;
+    return {
+      content: [
+        {
+          type: "text",
+          text: \`Added \${quantity}x \${args.productId} to your Hardware World cart.\`,
+        },
+      ],
+    };
+  },
+};
+`,
+            encoding: "utf-8",
+        },
+        {
+            path: "src/tools/get-cart.ts",
+            content: `import type { ToolDefinition } from "@kya-os/mcp-i-cloudflare";
+
+export const getCartTool: ToolDefinition = {
+  name: "get_cart",
+  description: "View your Hardware World shopping cart",
+  inputSchema: {
+    type: "object",
+    properties: {},
+  },
+  handler: async () => {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            items: [],
+            total: 0,
+            message: "Your Hardware World cart is empty!",
+          }),
+        },
+      ],
+    };
+  },
+};
+`,
+            encoding: "utf-8",
+        },
+        {
+            path: "src/tools/remove-from-cart.ts",
+            content: `import type { ToolDefinition } from "@kya-os/mcp-i-cloudflare";
+
+export const removeFromCartTool: ToolDefinition = {
+  name: "remove_from_cart",
+  description: "Remove an item from the Hardware World cart",
+  inputSchema: {
+    type: "object",
+    properties: {
+      productId: { type: "string", description: "Product ID to remove" },
+    },
+    required: ["productId"],
+  },
+  handler: async (args: { productId: string }) => {
+    return {
+      content: [
+        {
+          type: "text",
+          text: \`Removed \${args.productId} from your cart.\`,
+        },
+      ],
+    };
+  },
+};
+`,
+            encoding: "utf-8",
+        },
+        {
+            path: "src/tools/search-products.ts",
+            content: `import type { ToolDefinition } from "@kya-os/mcp-i-cloudflare";
+
+export const searchProductsTool: ToolDefinition = {
+  name: "search_products",
+  description: "Search Hardware World product catalog",
+  inputSchema: {
+    type: "object",
+    properties: {
+      query: { type: "string", description: "Search query" },
+      category: {
+        type: "string",
+        description: "Product category (tools, lumber, plumbing, electrical)",
+      },
+    },
+    required: ["query"],
+  },
+  handler: async (args: { query: string; category?: string }) => {
+    const categoryFilter = args.category ? \` in \${args.category}\` : "";
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            query: args.query,
+            category: args.category,
+            results: [
+              { id: "hw-001", name: "Power Drill", price: 79.99 },
+              { id: "hw-002", name: "Hammer", price: 24.99 },
+              { id: "hw-003", name: "Screwdriver Set", price: 34.99 },
+            ],
+            message: \`Found 3 products matching "\${args.query}"\${categoryFilter}\`,
+          }),
+        },
+      ],
+    };
+  },
+};
+`,
+            encoding: "utf-8",
+        },
+    ];
+}
+function generateDeployWorkflow() {
+    return `name: Deploy to Cloudflare
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    name: Deploy
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Deploy to Cloudflare
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: \${{ secrets.CLOUDFLARE_API_TOKEN }}
+          secrets: |
+            MCP_IDENTITY_PRIVATE_KEY
+            OAUTH_ENCRYPTION_SECRET
+            AGENTSHIELD_API_KEY
+        env:
+          MCP_IDENTITY_PRIVATE_KEY: \${{ secrets.MCP_IDENTITY_PRIVATE_KEY }}
+          OAUTH_ENCRYPTION_SECRET: \${{ secrets.OAUTH_ENCRYPTION_SECRET }}
+          AGENTSHIELD_API_KEY: \${{ secrets.AGENTSHIELD_API_KEY }}
+`;
+}
+function generateReadme(projectName, projectId) {
+    const dashboardUrl = projectId
+        ? `https://kya.vouched.id/dashboard/bouncer/${projectId}`
+        : "https://kya.vouched.id/dashboard/bouncer";
+    return `# ${projectName}
+
+MCP-I Agent deployed on Cloudflare Workers with AgentShield integration.
+
+## Quick Start
+
+1. **Clone this repository**
+   \`\`\`bash
+   git clone https://github.com/YOUR_USERNAME/${projectName}.git
+   cd ${projectName}
+   \`\`\`
+
+2. **Install dependencies**
+   \`\`\`bash
+   npm install
+   \`\`\`
+
+3. **Local Development**
+   \`\`\`bash
+   # Copy secrets template
+   cp .dev.vars.example .dev.vars
+
+   # Add your secrets to .dev.vars
+
+   # Start dev server
+   npm run dev
+   \`\`\`
+
+4. **Deploy**
+   \`\`\`bash
+   npm run deploy
+   \`\`\`
+
+## AgentShield Dashboard
+
+Configure your agent at: ${dashboardUrl}
+
+- Add tool protections
+- Configure OAuth providers
+- View delegations and proofs
+
+## Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| \`MCP_IDENTITY_PRIVATE_KEY\` | Agent's private key | Yes |
+| \`OAUTH_ENCRYPTION_SECRET\` | OAuth state encryption | Yes |
+| \`AGENTSHIELD_API_KEY\` | AgentShield API key | Yes |
+| \`CLOUDFLARE_API_TOKEN\` | Wrangler deployment token | For CI/CD |
+
+## Adding Tools
+
+Add new tools in \`src/tools/\`:
+
+\`\`\`typescript
+// src/tools/my-tool.ts
+import type { ToolDefinition } from "@kya-os/mcp-i-cloudflare";
+
+export const myTool: ToolDefinition = {
+  name: "my_tool",
+  description: "Description of my tool",
+  inputSchema: {
+    type: "object",
+    properties: {
+      param1: { type: "string" },
+    },
+    required: ["param1"],
+  },
+  handler: async (args) => {
+    return {
+      content: [{ type: "text", text: \`Result: \${args.param1}\` }],
+    };
+  },
+};
+\`\`\`
+
+Then register in \`src/mcpi-runtime-config.ts\`.
+
+## License
+
+MIT
+`;
+}
+//# sourceMappingURL=generate-cloudflare-files.js.map