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

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

@@ -0,0 +1,338 @@
+import fs from "fs-extra";
+import path from "path";
+import chalk from "chalk";
+/**
+ * Scaffold Cloudflare Worker verifier project
+ * This creates a standalone Worker verifier with KV nonce caching
+ */
+export async function fetchCloudflareTemplate(projectPath, options = {}) {
+    const { verifierVersion = "^1.3.4", packageManager = "npm" } = options;
+    try {
+        console.log(chalk.blue(`📦 Setting up Cloudflare Worker verifier with @kya-os/verifier@${verifierVersion}...`));
+        // Create package.json for Cloudflare Worker
+        const packageJson = {
+            name: path.basename(projectPath),
+            version: "1.0.0",
+            type: "module",
+            private: true,
+            scripts: {
+                dev: "wrangler dev",
+                deploy: "wrangler deploy",
+                "deploy:production": "wrangler deploy --env production",
+                "kv:create": "wrangler kv namespace create NONCE_CACHE",
+                "kv:create:preview": "wrangler kv namespace create NONCE_CACHE --preview",
+                tail: "wrangler tail",
+                test: "vitest",
+            },
+            dependencies: {
+                "@kya-os/verifier": verifierVersion,
+            },
+            devDependencies: {
+                "@cloudflare/workers-types": "^4.20240925.0",
+                "@cloudflare/vitest-pool-workers": "^0.5.0",
+                typescript: "^5.6.2",
+                vitest: "^2.1.5",
+                wrangler: "^4.42.2",
+            },
+        };
+        // Write package.json
+        fs.ensureDirSync(projectPath);
+        fs.writeJsonSync(path.join(projectPath, "package.json"), packageJson, { spaces: 2 });
+        // Create src directory
+        const srcDir = path.join(projectPath, "src");
+        fs.ensureDirSync(srcDir);
+        // Create Worker implementation
+        const workerContent = `import {
+  verifyWorker,
+  applyVerificationToResponse,
+  createConfigFromEnv,
+  type WorkerEnv,
+} from "@kya-os/verifier/worker";
+
+export default {
+  async fetch(request: Request, env: WorkerEnv): Promise<Response> {
+    const url = new URL(request.url);
+
+    // Health check endpoint
+    if (url.pathname === "/health") {
+      return new Response(
+        JSON.stringify({
+          status: "healthy",
+          timestamp: new Date().toISOString(),
+        }),
+        {
+          headers: { "Content-Type": "application/json" },
+        }
+      );
+    }
+
+    // Verification endpoint
+    if (url.pathname === "/verify") {
+      // Create config from environment variables
+      const config = createConfigFromEnv(env, {
+        allowMockData: false,
+      });
+
+      // Verify the proof
+      const result = await verifyWorker(request, config);
+
+      // If verification failed, return error response
+      if (!result.success) {
+        return applyVerificationToResponse(result);
+      }
+
+      // Success - extract agent context
+      const agent = result.agentContext;
+
+      // Check required scopes (example)
+      const requiredScopes = ["cart:add", "checkout"];
+      const hasRequiredScope = requiredScopes.some((scope) =>
+        agent?.scopes?.includes(scope)
+      );
+
+      if (!hasRequiredScope) {
+        return new Response(
+          JSON.stringify({
+            verified: false,
+            error: "Insufficient permissions",
+            requiredScopes,
+            providedScopes: agent?.scopes || [],
+          }),
+          {
+            status: 403,
+            headers: { "Content-Type": "application/json" },
+          }
+        );
+      }
+
+      // Success response with agent context
+      return new Response(
+        JSON.stringify({
+          verified: true,
+          agent: {
+            did: agent?.did,
+            kid: agent?.kid,
+            scopes: agent?.scopes,
+            session: agent?.session,
+          },
+          timestamp: new Date().toISOString(),
+        }),
+        {
+          headers: { "Content-Type": "application/json" },
+        }
+      );
+    }
+
+    return new Response("Not Found", { status: 404 });
+  },
+};
+`;
+        fs.writeFileSync(path.join(srcDir, "index.ts"), workerContent);
+        // Create wrangler.toml
+        const wranglerContent = `#:schema node_modules/wrangler/config-schema.json
+name = "${path.basename(projectPath)}"
+main = "src/index.ts"
+compatibility_date = "2025-01-01"
+compatibility_flags = ["nodejs_compat"]
+
+# KV Namespace for nonce cache
+# Run: wrangler kv:namespace create NONCE_CACHE
+# Then replace the id below with the output
+[[kv_namespaces]]
+binding = "NONCE_CACHE"
+id = "YOUR_KV_NAMESPACE_ID"
+
+# Environment variables (non-sensitive)
+[vars]
+KYA_API_URL = "https://knowthat.ai"
+XMCP_I_TS_SKEW_SEC = "120"
+XMCP_I_SESSION_TTL = "1800"
+
+# Production environment
+[env.production]
+name = "${path.basename(projectPath)}-production"
+vars = { KYA_API_URL = "https://knowthat.ai", XMCP_I_TS_SKEW_SEC = "60" }
+
+[[env.production.kv_namespaces]]
+binding = "NONCE_CACHE"
+id = "YOUR_PRODUCTION_KV_NAMESPACE_ID"
+`;
+        fs.writeFileSync(path.join(projectPath, "wrangler.toml"), wranglerContent);
+        // Create tsconfig.json
+        const tsconfigContent = {
+            compilerOptions: {
+                target: "ES2022",
+                module: "ES2022",
+                lib: ["ES2022"],
+                types: ["@cloudflare/workers-types"],
+                moduleResolution: "bundler",
+                resolveJsonModule: true,
+                allowSyntheticDefaultImports: true,
+                esModuleInterop: true,
+                strict: true,
+                skipLibCheck: true,
+                forceConsistentCasingInFileNames: true,
+            },
+            include: ["src/**/*"],
+        };
+        fs.writeJsonSync(path.join(projectPath, "tsconfig.json"), tsconfigContent, { spaces: 2 });
+        // Create .gitignore
+        const gitignoreContent = `node_modules/
+dist/
+.wrangler/
+.dev.vars
+.env
+.env.local
+*.log
+`;
+        fs.writeFileSync(path.join(projectPath, ".gitignore"), gitignoreContent);
+        // Create README.md
+        const readmeContent = `# ${path.basename(projectPath)}
+
+MCP-I proof verifier deployed on Cloudflare Workers with KV nonce caching.
+
+## Quick Start
+
+### 1. Install Dependencies
+
+\`\`\`bash
+${packageManager} install
+\`\`\`
+
+### 2. Create KV Namespace
+
+\`\`\`bash
+${packageManager === "npm" ? "npm run" : packageManager} kv:create
+\`\`\`
+
+Copy the \`id\` from the output and update \`wrangler.toml\`:
+
+\`\`\`toml
+[[kv_namespaces]]
+binding = "NONCE_CACHE"
+id = "your-kv-namespace-id-here"  # ← Update this
+\`\`\`
+
+### 3. Test Locally
+
+\`\`\`bash
+${packageManager === "npm" ? "npm run" : packageManager} dev
+\`\`\`
+
+Visit http://localhost:8787/health to verify it's running.
+
+### 4. Deploy to Cloudflare
+
+\`\`\`bash
+# Login to Cloudflare (first time only)
+npx wrangler login
+
+# Deploy to development
+${packageManager === "npm" ? "npm run" : packageManager} deploy
+
+# Deploy to production
+${packageManager === "npm" ? "npm run" : packageManager} deploy:production
+\`\`\`
+
+## API Endpoints
+
+### \`GET /health\`
+Health check endpoint.
+
+**Response:**
+\`\`\`json
+{
+  "status": "healthy",
+  "timestamp": "2024-10-09T12:00:00.000Z"
+}
+\`\`\`
+
+### \`POST /verify\`
+Verify MCP-I cryptographic proof.
+
+**Request:**
+\`\`\`json
+{
+  "proof": {
+    "agentDid": "did:web:example.com",
+    "timestamp": 1234567890,
+    "nonce": "abc123",
+    "signature": "...",
+    "publicKey": "..."
+  },
+  "requiredScopes": ["cart:add"]
+}
+\`\`\`
+
+**Response (Success):**
+\`\`\`json
+{
+  "verified": true,
+  "agentDid": "did:web:example.com",
+  "timestamp": "2024-10-09T12:00:00.000Z"
+}
+\`\`\`
+
+**Response (Failed):**
+\`\`\`json
+{
+  "verified": false,
+  "error": "Invalid signature"
+}
+\`\`\`
+
+## Configuration
+
+### Environment Variables (wrangler.toml)
+
+- \`KYA_API_URL\` - KYA API endpoint (default: https://knowthat.ai)
+- \`XMCP_I_TS_SKEW_SEC\` - Clock skew tolerance in seconds (default: 120)
+- \`XMCP_I_SESSION_TTL\` - Session timeout in seconds (default: 1800)
+
+### KV Namespace
+
+The Worker uses Cloudflare KV for distributed nonce caching to prevent replay attacks.
+
+Create separate namespaces for development and production:
+
+\`\`\`bash
+# Development
+${packageManager === "npm" ? "npm run" : packageManager} kv:create
+
+# Production (after deploying once)
+wrangler kv:namespace create NONCE_CACHE --env production
+\`\`\`
+
+## Testing
+
+Send a test request:
+
+\`\`\`bash
+curl -X POST https://your-worker.workers.dev/verify \\
+  -H "Content-Type: application/json" \\
+  -d '{
+    "proof": {
+      "agentDid": "did:web:example.com",
+      "timestamp": 1234567890,
+      "nonce": "test123",
+      "signature": "...",
+      "publicKey": "..."
+    }
+  }'
+\`\`\`
+
+## Learn More
+
+- [MCP-I Documentation](https://github.com/kya-os/xmcp-i)
+- [Cloudflare Workers Docs](https://developers.cloudflare.com/workers/)
+- [Cloudflare KV Docs](https://developers.cloudflare.com/kv/)
+`;
+        fs.writeFileSync(path.join(projectPath, "README.md"), readmeContent);
+        console.log(chalk.green("✅ Cloudflare Worker verifier structure created"));
+    }
+    catch (error) {
+        console.error(chalk.red("Failed to set up Cloudflare Worker verifier:"), error);
+        throw error;
+    }
+}
+//# sourceMappingURL=fetch-cloudflare-template.js.map

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

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

package/dist/helpers/fetch-mcpi-template.d.ts

@@ -0,0 +1,13 @@
+interface ScaffoldTemplateOptions {
+    mcpiVersion?: string;
+    packageManager?: string;
+    skipIdentity?: boolean;
+    register?: boolean;
+}
+/**
+ * Scaffold MCP-I project using @kya-os/mcp-i package
+ * This creates a standalone MCP server with built-in identity features
+ */
+export declare function fetchMCPITemplate(projectPath: string, options?: ScaffoldTemplateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=fetch-mcpi-template.d.ts.map

package/dist/helpers/fetch-mcpi-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-mcpi-template.d.ts","sourceRoot":"","sources":["../../src/helpers/fetch-mcpi-template.ts"],"names":[],"mappings":"AAaA,UAAU,uBAAuB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CA4Qf"}

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

@@ -0,0 +1,237 @@
+import fs from "fs-extra";
+import path from "path";
+import chalk from "chalk";
+import { generateIdentity } from "./generate-identity.js";
+import { getPackageVersions } from "./get-package-versions.js";
+import { registerWithKTA, createKTARegistration, } from "./kta-registration.js";
+/**
+ * Scaffold MCP-I project using @kya-os/mcp-i package
+ * This creates a standalone MCP server with built-in identity features
+ */
+export async function fetchMCPITemplate(projectPath, options = {}) {
+    const { packageManager = "npm", skipIdentity = false } = options;
+    // Get versions from scaffolder's package.json (single source of truth)
+    // This ensures scaffolded projects use tested, consistent versions
+    const versions = await getPackageVersions();
+    const mcpiVersion = options.mcpiVersion || versions["@kya-os/mcp-i"];
+    try {
+        console.log(chalk.blue(`📦 Setting up MCP-I project with @kya-os/mcp-i@${mcpiVersion}...`));
+        // Create package.json matching our working test-mcpi structure
+        const packageJson = {
+            name: path.basename(projectPath),
+            version: "0.1.0",
+            dependencies: {
+                "@kya-os/cli": versions["@kya-os/cli"],
+                "@kya-os/mcp-i": mcpiVersion,
+                zod: "^3.25.76",
+            },
+            scripts: {
+                dev: "mcpi dev",
+                build: "mcpi build",
+                start: "mcpi start",
+                init: "mcpi init",
+                register: "mcpi register",
+                "keys:rotate": "mcpi rotate",
+                "identity:clean": "rm -rf .mcpi",
+                status: "mcpi status",
+            },
+            devDependencies: {
+                "@modelcontextprotocol/inspector": "^0.16.6",
+                "swc-loader": "^0.2.6",
+            },
+        };
+        // Write package.json
+        fs.ensureDirSync(projectPath);
+        fs.writeJsonSync(path.join(projectPath, "package.json"), packageJson, {
+            spaces: 2,
+        });
+        // Create basic MCP-I project structure
+        const srcDir = path.join(projectPath, "src");
+        const toolsDir = path.join(srcDir, "tools");
+        // Create required directories
+        fs.ensureDirSync(toolsDir);
+        // Optional directories (not created by default - users can add as needed)
+        // These are typically only needed for:
+        // - scenarios/: Demo/testing scenarios (like bouncer-demo)
+        // - lib/: Shared utilities (if project grows complex)
+        // - scripts/: Build/utility scripts (if needed)
+        // - docs/: Documentation (if maintaining separate docs)
+        // Create a basic greet tool (MCP-I default)
+        // CRITICAL: Import from @kya-os/mcp-i (not xmcp)
+        const greetToolContent = `import { z } from "zod";
+import { type InferSchema, type ToolMetadata } from "@kya-os/mcp-i";
+
+// 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);
+        // IMPORTANT: DO NOT create tools/index.ts
+        // This would cause duplicate tool registration in webpack bundling
+        // Create xmcp.config.ts with identity features enabled (matching test-mcpi)
+        const configContent = `import type { XmcpConfig } from "@kya-os/mcp-i";
+
+const config: XmcpConfig = {
+  // Point to the tools directory
+  paths: {
+    tools: "./src/tools",
+  },
+
+  // Enable MCP-I identity features
+  identity: {
+    enabled: true,
+    environment: "development",
+    debug: true,
+  },
+
+  // Enable STDIO transport for Claude Desktop
+  stdio: true,
+};
+
+export default config;
+`;
+        fs.writeFileSync(path.join(projectPath, "xmcp.config.ts"), configContent);
+        // Create .gitignore
+        const gitignoreContent = `node_modules/
+dist/
+.env
+.env.local
+.mcpi/
+`;
+        fs.writeFileSync(path.join(projectPath, ".gitignore"), gitignoreContent);
+        // Create README.md with quick start instructions
+        const readmeContent = `# ${path.basename(projectPath)}
+
+MCP-I server with cryptographic identity built-in.
+
+## Getting Started
+
+1. Install dependencies:
+   \`\`\`bash
+   npm install
+   \`\`\`
+
+2. Initialize identity (generates cryptographic keys):
+   \`\`\`bash
+   npm run init
+   \`\`\`
+
+3. Start development server:
+   \`\`\`bash
+   npm run dev
+   \`\`\`
+
+## Scripts
+
+- \`npm run dev\` - Start development server with hot reload
+- \`npm run build\` - Build production bundle
+- \`npm run start\` - Start production server
+- \`npm run init\` - Initialize agent identity
+- \`npm run status\` - Check identity and server status
+- \`npm run keys:rotate\` - Rotate cryptographic keys
+
+## Project Structure
+
+\`\`\`
+├── src/
+│   └── tools/          # MCP tools
+│       └── greet.ts    # Example tool
+├── xmcp.config.ts      # MCP-I configuration
+└── .mcpi/              # Identity files (git-ignored)
+\`\`\`
+
+**Optional directories** (add as needed):
+- \`src/scenarios/\` - Demo/testing scenarios
+- \`src/lib/\` - Shared utilities
+- \`scripts/\` - Build/utility scripts
+- \`docs/\` - Documentation
+
+## Learn More
+
+- [MCP-I Documentation](https://github.com/modelcontextprotocol-identity/mcp-i)
+- [Model Context Protocol](https://modelcontextprotocol.io)
+`;
+        fs.writeFileSync(path.join(projectPath, "README.md"), readmeContent);
+        console.log(chalk.green("✅ MCP-I project structure created"));
+        // Generate persistent identity for Node.js MCP-I server
+        if (!skipIdentity) {
+            console.log(chalk.cyan("🔐 Generating persistent identity..."));
+            try {
+                const identity = await generateIdentity();
+                // Create .mcpi directory
+                const mcpiDir = path.join(projectPath, ".mcpi");
+                fs.ensureDirSync(mcpiDir);
+                // Register with Know That AI if requested
+                let ktaRegistration;
+                if (options.register) {
+                    console.log(chalk.blue("📝 Registering with Know That AI..."));
+                    try {
+                        const registrationResult = await registerWithKTA({
+                            name: path.basename(projectPath),
+                            publicKey: identity.publicKey,
+                            did: identity.did,
+                        });
+                        if (registrationResult.success) {
+                            ktaRegistration = createKTARegistration(registrationResult.claimUrl ?? null);
+                            console.log(chalk.green("✅ Agent registered with Know That AI"));
+                            if (registrationResult.claimUrl) {
+                                console.log(chalk.cyan(`   📋 Claim URL: ${registrationResult.claimUrl}`));
+                            }
+                            else {
+                                console.log(chalk.dim("   (Shadow registration - did:key agent)"));
+                            }
+                        }
+                        else {
+                            console.log(chalk.yellow(`⚠️  Registration failed: ${registrationResult.error}`));
+                            console.log(chalk.dim("   You can register later using: mcpi register"));
+                        }
+                    }
+                    catch (regError) {
+                        console.log(chalk.yellow(`⚠️  Registration failed: ${regError.message}`));
+                        console.log(chalk.dim("   You can register later using: mcpi register"));
+                    }
+                }
+                // Build identity object with optional KTA registration
+                const identityData = {
+                    version: "1.0",
+                    ...identity,
+                    ...(ktaRegistration ? { kta: ktaRegistration } : {}),
+                };
+                // Save identity to .mcpi/identity.json
+                const identityPath = path.join(mcpiDir, "identity.json");
+                fs.writeJsonSync(identityPath, identityData, { spaces: 2 });
+                console.log(chalk.green("✅ Generated persistent identity"));
+                console.log(chalk.dim(`   DID: ${identity.did}`));
+                console.log(chalk.dim(`   Saved to: .mcpi/identity.json`));
+            }
+            catch (error) {
+                console.log(chalk.yellow("⚠️  Failed to generate identity:"), error.message);
+                console.log(chalk.dim("   You can generate identity later by running: npm run init"));
+            }
+        }
+    }
+    catch (error) {
+        console.error(chalk.red("Failed to set up MCP-I project:"), error);
+        throw error;
+    }
+}
+//# sourceMappingURL=fetch-mcpi-template.js.map

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

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

package/dist/helpers/fetch-xmcp-template.d.ts

@@ -0,0 +1,13 @@
+interface ScaffoldTemplateOptions {
+    xmcpVersion?: string;
+    xmcpChannel?: string;
+    packageManager?: string;
+}
+/**
+ * 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 declare function fetchXMCPTemplate(projectPath: string, options?: ScaffoldTemplateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=fetch-xmcp-template.d.ts.map

package/dist/helpers/fetch-xmcp-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-xmcp-template.d.ts","sourceRoot":"","sources":["../../src/helpers/fetch-xmcp-template.ts"],"names":[],"mappings":"AAMA,UAAU,uBAAuB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAoIf"}