@techdigger/humanode-agentlink-cli 0.3.4 → 0.3.5

package/README.md

@@ -30,6 +30,8 @@ After the owner completes linking in the browser, check the result:
 agentlink status
 ```
 
+For the first protected-route test, start with a `free-trial` route before moving to stricter gating or more complex payment flows.
+
 ## Commands
 
 ### `agentlink init`

package/REGISTRATION.md

@@ -1,10 +1,10 @@
 # Humanode Agentlink — Agent Developer Guide
 
-Link your AI agent to a biomapped human and unlock free or discounted access to x402 APIs.
+Link your AI agent to a biomapped human and unlock verified-human access on x402 APIs.
 
 ## What linking does
 
-When your agent is linked to a biomapped owner, platforms using Humanode Agentlink can identify your agent as acting on behalf of a real human. This unlocks better pricing: free tiers, free trials, or discounts that are unavailable to unlinked agents.
+When your agent is linked to a biomapped owner, platforms using Humanode Agentlink can identify your agent as acting on behalf of a real human. This unlocks better route behavior: free tiers, free trials, or linked-only gating that are unavailable to unlinked agents.
 
 ## Prerequisites
 
@@ -112,6 +112,8 @@ Possible results:
 
 Use `--json` for machine-readable output.
 
+For the first protected-route test, start with a `free-trial` route. It is the fastest way to prove the linked-human path end to end.
+
 ## Manual consent flow
 
 If you do not want the CLI to create a link session URL, use the lower-level `authorize-link` command:

package/dist/commands/authorize-link.js

@@ -1,6 +1,6 @@
 import { isAddress } from 'viem';
 import { createAgentLinkConsent } from '@techdigger/humanode-agentlink';
-import { CliError, assertNoExtraPositionals, createConsolePrompter, defaultDeadline, parseFlags, parseFutureDeadline, parseRequiredAddress, resolveNetwork, resolvePrivateKey, resolveRegistryAddress, resolveRpcUrl, } from '../lib/core.js';
+import { CliError, assertNoExtraPositionals, createConsolePrompter, defaultDeadline, parseFlags, parseFutureDeadline, resolveNetwork, resolvePrivateKey, resolveRegistryAddress, resolveRpcUrl, } from '../lib/core.js';
 export async function parseAuthorizeLinkOptions(argv, env, now, overrides = {}) {
     const parsed = parseFlags(argv);
     assertNoExtraPositionals('authorize-link', parsed.positionals);

package/dist/commands/request.js

@@ -1,6 +1,5 @@
-import { SiweMessage } from 'siwe';
-import { privateKeyToAccount } from 'viem/accounts';
-import { CliError, NETWORKS, assertNoExtraPositionals, parseFlags, resolveNetwork, resolvePrivateKey, } from '../lib/core.js';
+import { buildAgentLinkHeader } from '@techdigger/humanode-agentlink';
+import { CliError, assertNoExtraPositionals, parseFlags, resolveNetwork, resolvePrivateKey, } from '../lib/core.js';
 export function parseRequestOptions(argv, env, overrides = {}) {
     const parsed = parseFlags(argv);
     if (parsed.positionals.length === 0) {
@@ -29,43 +28,14 @@ export function parseRequestOptions(argv, env, overrides = {}) {
         privateKey: resolvePrivateKey(parsed.values['private-key'], env, overrides.privateKey),
     };
 }
-async function buildAgentLinkHeader(privateKey, url, network) {
-    const account = privateKeyToAccount(privateKey);
-    const parsed = new URL(url);
-    const chainId = NETWORKS[network].chainId;
-    const nonce = Math.random().toString(36).slice(2) + Date.now().toString(36);
-    const issuedAt = new Date().toISOString();
-    const siwe = new SiweMessage({
-        domain: parsed.hostname,
-        address: account.address,
-        uri: url,
-        version: '1',
-        chainId,
-        nonce,
-        issuedAt,
-        statement: 'Agentlink access request',
-    });
-    const message = siwe.prepareMessage();
-    const signature = await account.signMessage({ message });
-    const payload = {
-        domain: parsed.hostname,
-        address: account.address,
-        statement: 'Agentlink access request',
-        uri: url,
-        version: '1',
-        chainId: `eip155:${chainId}`,
-        type: 'eip191',
-        nonce,
-        issuedAt,
-        signature,
-    };
-    return Buffer.from(JSON.stringify(payload)).toString('base64');
-}
 export async function runRequest(options, deps = {}) {
     const fetchImpl = deps.fetchImpl ?? fetch;
     const results = [];
     for (let i = 1; i <= options.count; i++) {
-        const agentlinkHeader = await buildAgentLinkHeader(options.privateKey, options.url, options.network);
+        const agentlinkHeader = await buildAgentLinkHeader(options.url, {
+            privateKey: options.privateKey,
+            network: options.network,
+        });
         let response;
         try {
             response = await fetchImpl(new Request(options.url, {

package/dist/lib/core.js

@@ -241,17 +241,16 @@ export function getPackageManagerInstallCommand(packageManager) {
 export function getPackageManagerRunCommand(packageManager, script) {
     return `${PM_COMMANDS[packageManager].run} ${script}`;
 }
-const HUMANODE_PACKAGE_VERSION = '^0.2.0';
 const HUMANODE_PACKAGE_META = {
-    agentlink: { dirName: 'agentlink', packageName: '@techdigger/humanode-agentlink', version: HUMANODE_PACKAGE_VERSION },
+    agentlink: { dirName: 'agentlink', packageName: '@techdigger/humanode-agentlink', version: '^0.3.0' },
     langchain: {
         dirName: 'langchain',
         packageName: '@techdigger/humanode-agentlink-langchain',
-        version: HUMANODE_PACKAGE_VERSION,
+        version: '^0.1.0',
     },
-    aiSdk: { dirName: 'ai-sdk', packageName: '@techdigger/humanode-agentlink-ai-sdk', version: HUMANODE_PACKAGE_VERSION },
-    mcp: { dirName: 'mcp', packageName: '@techdigger/humanode-agentlink-mcp', version: HUMANODE_PACKAGE_VERSION },
-    cli: { dirName: 'cli', packageName: '@techdigger/humanode-agentlink-cli', version: HUMANODE_PACKAGE_VERSION },
+    aiSdk: { dirName: 'ai-sdk', packageName: '@techdigger/humanode-agentlink-ai-sdk', version: '^0.1.0' },
+    mcp: { dirName: 'mcp', packageName: '@techdigger/humanode-agentlink-mcp', version: '^0.1.0' },
+    cli: { dirName: 'cli', packageName: '@techdigger/humanode-agentlink-cli', version: '^0.3.5' },
 };
 async function pathExists(targetPath) {
     try {

package/dist/templates.js

@@ -7,7 +7,7 @@ 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) {
+function buildCommonEnv(input) {
     const lines = [
         `BIOMAPPER_NETWORK=${input.network}`,
         `BIOMAPPER_REGISTRY=${input.registry}`,
@@ -210,6 +210,10 @@ ${getPackageManagerRunCommand(input.packageManager, 'link')} -- --owner 0xOwner
 \`\`\`bash
 ${getPackageManagerRunCommand(input.packageManager, 'status')}
 \`\`\`
+
+## Recommended First Route Test
+
+After linking succeeds, start by pointing the agent at a \`free-trial\` route. That proves the linked-human path before you move to stricter gating or more advanced payment flows.
 `;
 }
 function buildLangChainReadme(input) {
@@ -253,21 +257,21 @@ export function buildTemplateFiles(input) {
         case 'langchain':
             return [
                 ...commonFiles,
-                { path: '.env.local', content: buildCommonEnv(input, true) },
+                { path: '.env.local', content: buildCommonEnv(input) },
                 { 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: '.env.local', content: buildCommonEnv(input) },
                 { path: 'README.md', content: buildAISDKReadme(input) },
                 { path: 'src/index.ts', content: buildAISource() },
             ];
         case 'mcp':
             return [
                 ...commonFiles,
-                { path: '.env.local', content: buildCommonEnv(input, false) },
+                { path: '.env.local', content: buildCommonEnv(input) },
                 { path: 'README.md', content: buildMcpReadme(input) },
                 { path: 'mcp.config.json', content: buildMcpConfig(input.packageManager) },
                 { path: 'src/index.ts', content: buildMcpSource() },

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@techdigger/humanode-agentlink-cli",
-	"version": "0.3.4",
+	"version": "0.3.5",
 	"description": "Scaffold, link, and inspect Biomapper-ready agent projects.",
 	"type": "module",
 	"main": "dist/index.js",
@@ -36,7 +36,7 @@
 		"mcp"
 	],
 	"devDependencies": {
-		"@types/node": "^24.3.2",
+		"@types/node": "^24.12.2",
 		"tsx": "^4.19.4",
 		"typescript": "^5.9.3"
 	}