@techdigger/humanode-agentlink-cli 0.2.0

package/dist/templates.js

@@ -0,0 +1,281 @@
+import { getPackageManagerInstallCommand, getPackageManagerRunCommand } from './lib/core.js';
+const LANGCHAIN_VERSION = '^1.2.37';
+const LANGCHAIN_OPENAI_VERSION = '^1.3.1';
+const AI_SDK_VERSION = '^6.0.138';
+const AI_SDK_OPENAI_VERSION = '^3.0.48';
+const MCP_SDK_VERSION = '^1.12.1';
+const DOTENV_VERSION = '^17.3.1';
+const TSX_VERSION = '^4.19.4';
+const TYPESCRIPT_VERSION = '^5.8.3';
+function buildCommonEnv(input, includeOpenAI) {
+    const lines = [
+        `AGENT_PRIVATE_KEY=0xyouragentprivatekey`,
+        `BIOMAPPER_NETWORK=${input.network}`,
+        `BIOMAPPER_REGISTRY=${input.registry}`,
+        `BIOMAPPER_LINKER_URL=http://localhost:5173/`,
+    ];
+    if (includeOpenAI) {
+        lines.unshift('OPENAI_API_KEY=your-openai-api-key', 'OPENAI_MODEL=gpt-4.1-mini');
+    }
+    return `${lines.join('\n')}\n`;
+}
+function buildGitIgnore() {
+    return `node_modules
+.env
+.env.local
+dist
+`;
+}
+function buildTsconfig() {
+    return `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "types": ["node"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}
+`;
+}
+function buildPackageJson(input) {
+    const base = {
+        name: input.packageName,
+        private: true,
+        type: 'module',
+        scripts: {
+            dev: 'tsx src/index.ts',
+            link: 'agentlink link',
+            status: 'agentlink status',
+            'authorize-link': 'agentlink authorize-link',
+        },
+        devDependencies: {
+            '@techdigger/humanode-agentlink-cli': input.humanodePackages.cli,
+            tsx: TSX_VERSION,
+            typescript: TYPESCRIPT_VERSION,
+        },
+    };
+    switch (input.template) {
+        case 'langchain':
+            return JSON.stringify({
+                ...base,
+                dependencies: {
+                    '@techdigger/humanode-agentlink-langchain': input.humanodePackages.langchain,
+                    '@langchain/openai': LANGCHAIN_OPENAI_VERSION,
+                    dotenv: DOTENV_VERSION,
+                    langchain: LANGCHAIN_VERSION,
+                },
+            }, null, 2);
+        case 'vercel-ai-sdk':
+            return JSON.stringify({
+                ...base,
+                dependencies: {
+                    '@ai-sdk/openai': AI_SDK_OPENAI_VERSION,
+                    '@techdigger/humanode-agentlink-ai-sdk': input.humanodePackages.aiSdk,
+                    ai: AI_SDK_VERSION,
+                    dotenv: DOTENV_VERSION,
+                },
+            }, null, 2);
+        case 'mcp':
+            return JSON.stringify({
+                ...base,
+                dependencies: {
+                    '@techdigger/humanode-agentlink-mcp': input.humanodePackages.mcp,
+                    '@modelcontextprotocol/sdk': MCP_SDK_VERSION,
+                    dotenv: DOTENV_VERSION,
+                },
+            }, null, 2);
+    }
+}
+function buildEnvLoader() {
+    return `import { config as loadEnv } from 'dotenv'
+
+loadEnv({ path: '.env' })
+loadEnv({ path: '.env.local', override: true })
+`;
+}
+function buildLangChainSource() {
+    return `${buildEnvLoader()}
+import { ChatOpenAI } from '@langchain/openai'
+import { createAgent } from 'langchain'
+import { createBiomapperLangChainTools } from '@techdigger/humanode-agentlink-langchain'
+
+async function main() {
+  const prompt =
+    process.argv.slice(2).join(' ') ||
+    'Check the configured Biomapper registry and explain what an agent developer should do next.'
+  const network = (process.env.BIOMAPPER_NETWORK ?? 'base-sepolia') as 'base' | 'base-sepolia'
+  const registryAddress = process.env.BIOMAPPER_REGISTRY as \`0x\${string}\`
+
+  const model = new ChatOpenAI({
+    model: process.env.OPENAI_MODEL ?? 'gpt-4.1-mini',
+  })
+
+  const agent = createAgent({
+    model,
+    tools: createBiomapperLangChainTools({
+      network,
+      registryAddress,
+    }),
+  })
+
+  const result = await agent.invoke({
+    messages: [{ role: 'user', content: prompt }],
+  })
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(error => {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exit(1)
+})
+`;
+}
+function buildAISource() {
+    return `${buildEnvLoader()}
+import { openai } from '@ai-sdk/openai'
+import { generateText } from 'ai'
+import { createBiomapperAISDKTools } from '@techdigger/humanode-agentlink-ai-sdk'
+
+async function main() {
+  const prompt =
+    process.argv.slice(2).join(' ') ||
+    'Check the configured Biomapper registry and explain what an agent developer should do next.'
+  const network = (process.env.BIOMAPPER_NETWORK ?? 'base-sepolia') as 'base' | 'base-sepolia'
+  const registryAddress = process.env.BIOMAPPER_REGISTRY as \`0x\${string}\`
+
+  const result = await generateText({
+    model: openai(process.env.OPENAI_MODEL ?? 'gpt-4.1-mini'),
+    prompt,
+    tools: createBiomapperAISDKTools({
+      network,
+      registryAddress,
+    }),
+  })
+
+  console.log(result.text)
+}
+
+main().catch(error => {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exit(1)
+})
+`;
+}
+function buildMcpSource() {
+    return `${buildEnvLoader()}
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { createBiomapperMcpServer } from '@techdigger/humanode-agentlink-mcp'
+
+async function main() {
+  const server = createBiomapperMcpServer()
+  await server.connect(new StdioServerTransport())
+}
+
+main().catch(error => {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exit(1)
+})
+`;
+}
+function buildLocalSourceNote(input) {
+    if (input.packageSource !== 'local') {
+        return '';
+    }
+    return 'This starter uses local `file:` dependencies that point at the checked-out Biomapper workspace.\n\n';
+}
+function buildReadme(input, opts) {
+    return `# ${input.projectName}
+
+Biomapper-ready ${opts.subtitle} starter.
+
+## Setup
+
+1. Fill in \`.env.local\` with your ${opts.envNote}.
+2. Install dependencies:
+
+\`\`\`bash
+${getPackageManagerInstallCommand(input.packageManager)}
+\`\`\`
+
+3. ${opts.runCmd}
+${opts.extraSetupStep ? `\n4. ${opts.extraSetupStep}\n` : ''}
+${buildLocalSourceNote(input)}## Link Your Agent
+
+\`\`\`bash
+${getPackageManagerRunCommand(input.packageManager, 'link')} -- --owner 0xOwner --open
+\`\`\`
+
+## Check Status
+
+\`\`\`bash
+${getPackageManagerRunCommand(input.packageManager, 'status')}
+\`\`\`
+`;
+}
+function buildLangChainReadme(input) {
+    return buildReadme(input, {
+        subtitle: 'LangChain',
+        envNote: 'OpenAI key, agent private key, and Biomapper registry values',
+        runCmd: `Run the starter:\n\n\`\`\`bash\n${getPackageManagerRunCommand(input.packageManager, 'dev')} -- "Check whether my configured agent is linked"\n\`\`\``,
+    });
+}
+function buildAISDKReadme(input) {
+    return buildReadme(input, {
+        subtitle: 'Vercel AI SDK',
+        envNote: 'OpenAI key, agent private key, and Biomapper registry values',
+        runCmd: `Run the starter:\n\n\`\`\`bash\n${getPackageManagerRunCommand(input.packageManager, 'dev')} -- "Check whether my configured agent is linked"\n\`\`\``,
+    });
+}
+function buildMcpReadme(input) {
+    return buildReadme(input, {
+        subtitle: 'MCP',
+        envNote: 'agent private key and Biomapper registry values',
+        runCmd: `Run the MCP server:\n\n\`\`\`bash\n${getPackageManagerRunCommand(input.packageManager, 'dev')}\n\`\`\``,
+        extraSetupStep: 'Point your MCP-compatible host at `./mcp.config.json`.',
+    });
+}
+const MCP_CONFIG_COMMANDS = {
+    pnpm: { command: 'pnpm', args: ['run', 'dev'] },
+    yarn: { command: 'yarn', args: ['run', 'dev'] },
+    bun: { command: 'bun', args: ['run', 'dev'] },
+    npm: { command: 'npm', args: ['run', 'dev'] },
+};
+function buildMcpConfig(packageManager) {
+    return `${JSON.stringify({ mcpServers: { biomapper: MCP_CONFIG_COMMANDS[packageManager] } }, null, 2)}\n`;
+}
+export function buildTemplateFiles(input) {
+    const commonFiles = [
+        { path: '.gitignore', content: buildGitIgnore() },
+        { path: 'package.json', content: `${buildPackageJson(input)}\n` },
+        { path: 'tsconfig.json', content: buildTsconfig() },
+    ];
+    switch (input.template) {
+        case 'langchain':
+            return [
+                ...commonFiles,
+                { path: '.env.local', content: buildCommonEnv(input, true) },
+                { path: 'README.md', content: buildLangChainReadme(input) },
+                { path: 'src/index.ts', content: buildLangChainSource() },
+            ];
+        case 'vercel-ai-sdk':
+            return [
+                ...commonFiles,
+                { path: '.env.local', content: buildCommonEnv(input, true) },
+                { path: 'README.md', content: buildAISDKReadme(input) },
+                { path: 'src/index.ts', content: buildAISource() },
+            ];
+        case 'mcp':
+            return [
+                ...commonFiles,
+                { path: '.env.local', content: buildCommonEnv(input, false) },
+                { path: 'README.md', content: buildMcpReadme(input) },
+                { path: 'mcp.config.json', content: buildMcpConfig(input.packageManager) },
+                { path: 'src/index.ts', content: buildMcpSource() },
+            ];
+    }
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "@techdigger/humanode-agentlink-cli",
+	"version": "0.2.0",
+	"description": "Scaffold, link, and inspect Biomapper-ready agent projects.",
+	"type": "module",
+	"main": "dist/index.js",
+	"bin": {
+		"agentlink": "dist/index.js"
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"REGISTRATION.md"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"test": "bun test tests/*.test.ts",
+		"prepublishOnly": "npm run build",
+		"publish:npm": "npm publish",
+		"cli": "tsx src/index.ts"
+	},
+	"dependencies": {
+		"@techdigger/humanode-agentlink": "^0.2.0",
+		"posthog-node": "^5.21.2",
+		"viem": "^2.46.2"
+	},
+	"keywords": [
+		"biomapper",
+		"agentlink",
+		"cli",
+		"x402",
+		"mcp"
+	],
+	"devDependencies": {
+		"@types/node": "^24.3.2",
+		"tsx": "^4.19.4",
+		"typescript": "^5.9.3"
+	}
+}