@contextvm/ctxcn 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ContextVM
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,178 @@
+# ctxcn
+
+`ctxcn` is a command-line utility inspired by `shadcn` that streamlines the integration of ContextVM (CVM) servers into your TypeScript projects. It generates a type-safe client from a CVM server's tool definitions, allowing you to call CVM tools as if they were native TypeScript functions.
+
+## Overview
+
+The `ctxcn` utility provides the following features:
+
+- **Interactive Project Initialization**: Sets up your project with the necessary configuration to connect to CVM servers through an interactive command-line interface.
+- **Code Generation**: Generates a TypeScript client from a CVM server's tool definitions, providing a seamless and type-safe development experience.
+- **Configuration**: Allows you to configure the output directory for the generated client, as well as the relays and private key to use when connecting to CVM servers.
+
+## Installation
+
+### Global Installation
+
+Install ctxcn globally using npm:
+
+```bash
+npm install -g @contextvm/ctxcn
+```
+
+### Local Installation
+
+Install ctxcn as a dev dependency in your project:
+
+```bash
+npm install --save-dev @contextvm/ctxcn
+```
+
+### Development Installation
+
+To get started with the source code, clone the repository and install the dependencies:
+
+```bash
+git clone https://github.com/your-username/ctxcn.git
+cd ctxcn
+bun install
+```
+
+## Usage
+
+The `ctxcn` utility provides four main commands: `init`, `add`, `update`, and `help`.
+
+### `init`
+
+The `init` command initializes your project with a `ctxcn.config.json` file. This command will guide you through the process of creating the configuration file, asking for the source directory and relays.
+
+To run the `init` command, execute the following command in your project's root directory:
+
+```bash
+ctxcn init
+```
+
+If you've installed locally or are working with the source code:
+
+```bash
+npx @contextvm/ctxcn init
+# or
+bun run index.ts init
+```
+
+This will start the interactive initialization process.
+
+### `add`
+
+The `add` command generates a TypeScript client from a CVM server's tool definitions. It takes a CVM server's pubkey as an argument and provides an interactive experience for configuring the client.
+
+To run the `add` command, execute the following command in your project's root directory:
+
+```bash
+ctxcn add <pubkey>
+```
+
+If you've installed locally or are working with the source code:
+
+```bash
+npx @contextvm/ctxcn add <pubkey>
+# or
+bun run index.ts add <pubkey>
+```
+
+This will:
+
+1. Connect to the specified CVM server
+2. Display server information and available tools
+3. Allow you to customize the client name
+4. Provide options to:
+   - Generate and save the client file
+   - Print the generated code to console only
+   - Cancel the operation
+
+### `update`
+
+The `update` command refreshes existing CVM server clients with the latest tool definitions. You can update a specific client or all clients at once.
+
+To update a specific client:
+
+```bash
+ctxcn update <pubkey>
+```
+
+To update all clients or select from a list:
+
+```bash
+ctxcn update
+```
+
+If you've installed locally or are working with the source code:
+
+```bash
+npx @contextvm/ctxcn update <pubkey>
+# or
+bun run index.ts update
+```
+
+The update command will:
+
+1. Check if the server name has changed
+2. Ask if you want to use the new server name or keep the existing one
+3. Display updated server information and tools
+4. Allow you to confirm before updating
+
+### `help`
+
+The `help` command displays a help message with information about the available commands and options.
+
+To run the `help` command, execute the following command:
+
+```bash
+ctxcn help
+```
+
+If you've installed locally or are working with the source code:
+
+```bash
+npx @contextvm/ctxcn help
+# or
+bun run index.ts help
+```
+
+## Configuration
+
+The `ctxcn` utility can be configured via a `ctxcn.config.json` file in your project's root directory. The following options are available:
+
+- `source`: The source directory for the generated client.
+- `relays`: An array of relays to use when connecting to CVM servers.
+- `privateKey`: The private key to use when connecting to CVM servers. If not provided, a new private key will be generated on the fly.
+- `addedClients`: An array of public keys of the clients that have been added. This is automatically managed by the CLI.
+
+## Example
+
+Here is an example of how to use the generated client:
+
+```typescript
+import { AdditionClient } from "./src/ctxcn/AdditionClient.ts";
+import {
+  NostrClientTransport,
+  PrivateKeySigner,
+  ApplesauceRelayPool,
+} from "@contextvm/sdk";
+
+const transport = new NostrClientTransport({
+  signer: new PrivateKeySigner(),
+  relayHandler: new ApplesauceRelayPool(["ws://localhost:10547"]),
+  serverPubkey: "<pubkey>",
+  isStateless: true,
+});
+
+const mcpClient = new AdditionClient(transport);
+await mcpClient.connect();
+
+const result = await mcpClient.add({ a: 5, b: 10 });
+
+console.log(result.result); // 15
+
+await mcpClient.disconnect();
+```

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { handleInit } from "./src/commands/init";
+import { handleAdd } from "./src/commands/add";
+import { handleUpdate } from "./src/commands/update";
+import { handleHelp } from "./src/commands/help";
+async function main() {
+    try {
+        const args = process.argv.slice(2);
+        const command = args[0];
+        if (!command) {
+            handleHelp();
+            return;
+        }
+        switch (command) {
+            case "init":
+                await handleInit(process.cwd());
+                break;
+            case "add":
+                const pubkey = args[1];
+                if (!pubkey) {
+                    console.error("Error: Missing pubkey for 'add' command.");
+                    console.error("Usage: ctxcn add <pubkey>");
+                    process.exit(1);
+                }
+                await handleAdd(pubkey, process.cwd());
+                break;
+            case "update":
+                const updatePubkey = args[1];
+                await handleUpdate(process.cwd(), updatePubkey);
+                break;
+            case "help":
+                handleHelp();
+                break;
+            default:
+                console.error(`Error: Unknown command '${command}'`);
+                handleHelp();
+                process.exit(1);
+                break;
+        }
+    }
+    catch (error) {
+        console.error("An unexpected error occurred:", error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAExB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,UAAU,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,MAAM;gBACT,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,KAAK;gBACR,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;oBAC1D,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;oBAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBACD,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBACvC,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC7B,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;gBAChD,MAAM;YACR,KAAK,MAAM;gBACT,UAAU,EAAE,CAAC;gBACb,MAAM;YACR;gBACE,OAAO,CAAC,KAAK,CAAC,2BAA2B,OAAO,GAAG,CAAC,CAAC;gBACrD,UAAU,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,MAAM;QACV,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/src/__mocks__/mock-server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mock-server.d.ts.map

package/dist/src/__mocks__/mock-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../../../src/__mocks__/mock-server.ts"],"names":[],"mappings":""}

package/dist/src/__mocks__/mock-server.js

@@ -0,0 +1,24 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const server = new McpServer({
+    name: "math-server",
+    version: "1.0.0",
+});
+const outputSchema = z.object({
+    result: z.number(),
+});
+// Add an addition tool
+server.registerTool("add", {
+    title: "Addition Tool",
+    description: "Add two numbers",
+    inputSchema: { a: z.number(), b: z.number() },
+    outputSchema: outputSchema.shape,
+}, async ({ a, b }) => ({
+    content: [{ type: "text", text: String(a + b) }],
+    structuredContent: { result: a + b },
+}));
+// Start receiving messages on stdin and sending messages on stdout
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=mock-server.js.map

package/dist/src/__mocks__/mock-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-server.js","sourceRoot":"","sources":["../../../src/__mocks__/mock-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AACH,uBAAuB;AACvB,MAAM,CAAC,YAAY,CACjB,KAAK,EACL;IACE,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IAC7C,YAAY,EAAE,YAAY,CAAC,KAAK;CACjC,EACD,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACnB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IAChD,iBAAiB,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE;CACrC,CAAC,CACH,CAAC;AAEF,mEAAmE;AACnE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/src/commands/add.d.ts

@@ -0,0 +1,2 @@
+export declare function handleAdd(pubkey: string, cwd: string): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/src/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/commands/add.ts"],"names":[],"mappings":"AAaA,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,iBA+H1D"}

package/dist/src/commands/add.js

@@ -0,0 +1,106 @@
+import { Client } from "@modelcontextprotocol/sdk/client";
+import { mkdir, writeFile, access } from "fs/promises";
+import path from "path";
+import { toPascalCase } from "../utils";
+import { loadConfig, saveConfig } from "../config";
+import { askQuestion, closeReadlineInterface } from "../utils/cli";
+import { generateClientCode } from "../utils/schema";
+import { ApplesauceRelayPool, NostrClientTransport, PrivateKeySigner, } from "@contextvm/sdk";
+export async function handleAdd(pubkey, cwd) {
+    console.log("🔍 Checking for configuration file...");
+    // Check if config file exists
+    const configPath = path.join(cwd, "ctxcn.config.json");
+    try {
+        await access(configPath);
+    }
+    catch (error) {
+        console.error("❌ Error: Configuration file 'ctxcn.config.json' not found.");
+        console.error("Please run 'ctxcn init' first to create a configuration file.");
+        closeReadlineInterface();
+        process.exit(1);
+    }
+    const config = await loadConfig(cwd);
+    // Check if client is already added
+    if (config.addedClients && config.addedClients.includes(pubkey)) {
+        console.log(`⚠️ Client with pubkey ${pubkey} is already added.`);
+        console.log("Use 'ctxcn update' to refresh the client if needed.");
+        closeReadlineInterface();
+        process.exit(0);
+    }
+    console.log(`🔗 Connecting to server ${pubkey}...`);
+    const client = new Client({
+        name: `generator-client`,
+        version: "1.0.0",
+    });
+    const transport = new NostrClientTransport({
+        signer: new PrivateKeySigner(config.privateKey),
+        relayHandler: new ApplesauceRelayPool(config.relays),
+        serverPubkey: pubkey,
+        // isStateless: true,
+    });
+    try {
+        await client.connect(transport);
+        const serverDetails = client.getServerVersion();
+        const toolListResult = await client.listTools();
+        await transport.close();
+        let serverName = toPascalCase(serverDetails?.name || "UnknownServer");
+        // Interactive confirmation
+        console.log(`\n📋 Server Information:`);
+        console.log(`   Name: ${serverDetails?.name || "Unknown"}`);
+        console.log(`   Version: ${serverDetails?.version || "Unknown"}`);
+        console.log(`   Tools found: ${toolListResult.tools.length}`);
+        console.log(`\n🔧 Available Tools:`);
+        toolListResult.tools.forEach((tool, index) => {
+            console.log(`   ${index + 1}. ${tool.name}: ${tool.description || "No description"}`);
+        });
+        console.log(`\n⚙️ Client Configuration:`);
+        console.log(`   Client Name: ${serverName}Client`);
+        console.log(`   Output Directory: ${config.source}`);
+        // Allow user to change client name
+        const customName = await askQuestion("Enter custom client name (leave empty to use default)", "");
+        if (customName.trim()) {
+            serverName = toPascalCase(customName.trim());
+        }
+        // Confirmation options
+        console.log("\n🤔 What would you like to do?");
+        console.log("1. Generate and save the client file");
+        console.log("2. Print the generated code to console only");
+        console.log("3. Cancel");
+        const choice = await askQuestion("Choose an option (1-3)", "1");
+        if (choice === "3") {
+            console.log("❌ Operation cancelled.");
+            closeReadlineInterface();
+            process.exit(0);
+        }
+        const printOnly = choice === "2";
+        const clientName = `${serverName}Client`;
+        const clientCode = await generateClientCode(pubkey, serverDetails, toolListResult, serverName);
+        if (printOnly) {
+            console.log("\n📄 Generated Client Code:");
+            console.log("=".repeat(50));
+            console.log(clientCode);
+            console.log("=".repeat(50));
+        }
+        else {
+            const outputDir = path.join(cwd, config.source);
+            await mkdir(outputDir, { recursive: true });
+            const outputPath = path.join(outputDir, `${clientName}.ts`);
+            await writeFile(outputPath, clientCode);
+            // Add the client to the config
+            if (!config.addedClients) {
+                config.addedClients = [];
+            }
+            config.addedClients.push(pubkey);
+            await saveConfig(cwd, config);
+            console.log(`✅ Generated client for ${serverName} at ${outputPath}`);
+        }
+        closeReadlineInterface();
+        process.exit(0);
+    }
+    catch (error) {
+        console.error("❌ Error connecting to server:", error);
+        closeReadlineInterface();
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/src/commands/add.js.map

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

package/dist/src/commands/help.d.ts

@@ -0,0 +1,2 @@
+export declare function handleHelp(): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/src/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/commands/help.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,SAazB"}

package/dist/src/commands/help.js

@@ -0,0 +1,15 @@
+export function handleHelp() {
+    console.log(`
+  Usage: ctxcn <command> [options]
+
+  Commands:
+    init      Initialize a new project and create a ctxcn.config.json file.
+    add       Add a new CVM server client to your project.
+    update    Update existing CVM server clients with the latest tool definitions.
+    help      Display this help message.
+
+  Options:
+    --help    Display help for a specific command.
+  `);
+}
+//# sourceMappingURL=help.js.map

package/dist/src/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/commands/help.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;GAWX,CAAC,CAAC;AACL,CAAC"}

package/dist/src/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function handleInit(cwd: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/src/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAKA,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,iBAgF3C"}

package/dist/src/commands/init.js

@@ -0,0 +1,61 @@
+import { promises as fs } from "fs";
+import path from "path";
+import { DEFAULT_CONFIG } from "../config";
+import { askQuestion, closeReadlineInterface } from "../utils/cli";
+export async function handleInit(cwd) {
+    console.log("🚀 Initializing project for ctxcn...");
+    console.log("\n🔍 Verifying project structure...");
+    const packageJsonPath = path.join(cwd, "package.json");
+    try {
+        await fs.access(packageJsonPath);
+        console.log("✔️ Project structure seems valid (package.json found).");
+    }
+    catch (error) {
+        console.error("❌ Error: No package.json found. Please run this command in a valid project root directory.");
+        process.exit(1);
+    }
+    const configPath = path.join(cwd, "ctxcn.config.json");
+    try {
+        await fs.access(configPath);
+        const overwrite = await askQuestion("A `ctxcn.config.json` file already exists. Do you want to overwrite it?", "n");
+        if (overwrite.toLowerCase() !== "y") {
+            console.log("Aborting initialization. Your existing configuration is safe.");
+            process.exit(0);
+        }
+    }
+    catch (error) {
+        // Config file doesn't exist, so we can proceed.
+    }
+    console.log("\n⚙️ Please provide your configuration details:");
+    const source = await askQuestion("Enter the source directory for generated clients", DEFAULT_CONFIG.source);
+    const relaysStr = await askQuestion("Enter the relays to connect to (comma-separated)", DEFAULT_CONFIG.relays.join(", "));
+    const relays = relaysStr.split(",").map((r) => r.trim());
+    closeReadlineInterface();
+    const config = {
+        source,
+        relays,
+    };
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2));
+    console.log("\n✔️ Configuration file `ctxcn.config.json` created successfully.");
+    const sourceDir = path.join(cwd, config.source);
+    try {
+        await fs.access(sourceDir);
+    }
+    catch (error) {
+        await fs.mkdir(sourceDir, { recursive: true });
+        console.log(`✔️ Source directory \`${config.source}\` created.`);
+    }
+    console.log("\n📦 Checking for required dependencies...");
+    const packageJsonContent = await fs.readFile(packageJsonPath, "utf-8");
+    const packageJson = JSON.parse(packageJsonContent);
+    const dependencies = packageJson.dependencies || {};
+    const devDependencies = packageJson.devDependencies || {};
+    if (!dependencies["@contextvm/sdk"] && !devDependencies["@contextvm/sdk"]) {
+        console.warn("⚠️ The `@contextvm/sdk` dependency is not found in your `package.json`. Please install it to ensure the generated client works correctly.");
+    }
+    else {
+        console.log("✔️ The `@contextvm/sdk` dependency is already installed.");
+    }
+    console.log("\n✅ Project initialization complete. You can now use the `add` command.");
+}
+//# sourceMappingURL=init.js.map

package/dist/src/commands/init.js.map

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

package/dist/src/commands/update.d.ts

@@ -0,0 +1,2 @@
+export declare function handleUpdate(cwd: string, pubkey?: string): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

package/dist/src/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/update.ts"],"names":[],"mappings":"AA6BA,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,iBA8E9D"}