@techdigger/humanode-agentlink-cli 0.3.2 → 0.3.4

package/dist/commands/authorize-link.d.ts

@@ -15,5 +15,5 @@ export interface AuthorizeLinkOverrides {
 export interface AuthorizeLinkDeps {
     createAgentLinkConsent: typeof createAgentLinkConsent;
 }
-export declare function parseAuthorizeLinkOptions(argv: string[], env: EnvSource, now: Date, overrides?: AuthorizeLinkOverrides): AuthorizeLinkOptions;
+export declare function parseAuthorizeLinkOptions(argv: string[], env: EnvSource, now: Date, overrides?: AuthorizeLinkOverrides): Promise<AuthorizeLinkOptions>;
 export declare function runAuthorizeLink(options: AuthorizeLinkOptions, deps?: Partial<AuthorizeLinkDeps>): Promise<AgentLinkConsentOutput>;

package/dist/commands/authorize-link.js

@@ -1,13 +1,27 @@
+import { isAddress } from 'viem';
 import { createAgentLinkConsent } from '@techdigger/humanode-agentlink';
-import { CliError, assertNoExtraPositionals, parseFlags, parseFutureDeadline, parseRequiredAddress, resolveNetwork, resolvePrivateKey, resolveRegistryAddress, resolveRpcUrl, } from '../lib/core.js';
-export function parseAuthorizeLinkOptions(argv, env, now, overrides = {}) {
+import { CliError, assertNoExtraPositionals, createConsolePrompter, defaultDeadline, parseFlags, parseFutureDeadline, parseRequiredAddress, 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);
+    let ownerValue = parsed.values.owner;
+    if (!ownerValue) {
+        const prompter = createConsolePrompter();
+        try {
+            ownerValue = await prompter.text({ message: 'Owner wallet address (biomapped)' });
+        }
+        finally {
+            prompter.close();
+        }
+    }
+    if (!isAddress(ownerValue)) {
+        throw new CliError(`Invalid --owner. Expected a checksummed or lowercase EVM address.`);
+    }
     const network = resolveNetwork(parsed.values.network, env);
     return {
-        owner: parseRequiredAddress('owner', parsed.values.owner),
+        owner: ownerValue,
         registry: resolveRegistryAddress(parsed.values.registry, env, network),
-        deadline: parseFutureDeadline(parsed.values.deadline, now),
+        deadline: parsed.values.deadline ? parseFutureDeadline(parsed.values.deadline, now) : defaultDeadline(now, 1),
         network,
         privateKey: resolvePrivateKey(parsed.values['private-key'], env, overrides.privateKey),
         rpcUrl: resolveRpcUrl(parsed.values['rpc-url'], env),

package/dist/commands/init.js

@@ -1,8 +1,7 @@
 import path from 'node:path';
 import { buildTemplateFiles } from '../templates.js';
-import { CliError, PACKAGE_MANAGERS, TEMPLATE_NAMES, createConsolePrompter, ensureTargetDirectoryIsWritable, getPackageManagerInstallCommand, getPackageManagerRunCommand, installProjectDependencies, parseAddressOrPlaceholder, parseFlags, resolveHumanodePackageSpecs, resolveNetwork, resolvePackageManager, resolvePackageSource, resolveTemplateName, toPackageName, writeGeneratedFiles, } from '../lib/core.js';
+import { CliError, NETWORKS, PACKAGE_MANAGERS, TEMPLATE_NAMES, createConsolePrompter, ensureTargetDirectoryIsWritable, getPackageManagerInstallCommand, getPackageManagerRunCommand, installProjectDependencies, parseAddressOrPlaceholder, parseFlags, resolveHumanodePackageSpecs, resolveNetwork, resolvePackageManager, resolvePackageSource, resolveTemplateName, toPackageName, writeGeneratedFiles, } from '../lib/core.js';
 const DEFAULT_PROJECT_DIR = 'biomapper-agent';
-const DEFAULT_REGISTRY = '0xYourRegistryDeployment';
 export function parseInitOptions(argv, env) {
     const parsed = parseFlags(argv);
     if (parsed.positionals.length > 1) {
@@ -52,10 +51,11 @@ export async function runInit(options, depsInput = {}) {
             ],
             defaultValue: resolveNetwork(undefined, env),
         }));
-        const registry = await resolveInteractiveValue(options.registry, options.yes, () => env.BIOMAPPER_REGISTRY ?? DEFAULT_REGISTRY, async () => parseAddressOrPlaceholder('registry', await getPrompter().text({
+        const networkDefaultRegistry = NETWORKS[network].defaultRegistry;
+        const registry = await resolveInteractiveValue(options.registry, options.yes, () => env.BIOMAPPER_REGISTRY ?? networkDefaultRegistry, async () => parseAddressOrPlaceholder('registry', await getPrompter().text({
             message: 'Biomapper registry address',
-            defaultValue: env.BIOMAPPER_REGISTRY ?? DEFAULT_REGISTRY,
-        }), DEFAULT_REGISTRY));
+            defaultValue: env.BIOMAPPER_REGISTRY ?? networkDefaultRegistry,
+        }), networkDefaultRegistry));
         const packageManager = await resolveInteractiveValue(options.packageManager, options.yes, () => 'npm', () => getPrompter().select({
             message: 'Package manager',
             options: PACKAGE_MANAGERS.map(value => ({ value, label: value })),

package/dist/commands/link.d.ts

@@ -33,6 +33,6 @@ export interface LinkDeps {
     buildLinkUrl: (baseUrl: string, session: AgentLinkSession) => string;
     openUrl: (url: string) => Promise<void>;
 }
-export declare function parseLinkOptions(argv: string[], env: EnvSource, now: Date, overrides?: LinkOptionOverrides): LinkOptions;
+export declare function parseLinkOptions(argv: string[], env: EnvSource, now: Date, overrides?: LinkOptionOverrides): Promise<LinkOptions>;
 export declare function runLink(options: LinkOptions, deps?: Partial<LinkDeps>): Promise<LinkResult>;
 export declare function formatLinkOutput(result: LinkResult, json?: boolean): string;

package/dist/commands/link.js

@@ -1,11 +1,25 @@
+import { isAddress } from 'viem';
 import { buildEmbeddedHostedLinkUrl, createAgentLinkConsent, createLinkSession, } from '@techdigger/humanode-agentlink';
-import { CliError, NETWORKS, assertNoExtraPositionals, defaultDeadline, formatJson, parseFlags, parseFutureDeadline, parseRequiredAddress, resolveLinkerUrl, resolveNetwork, resolvePrivateKey, resolveRegistryAddress, resolveRpcUrl, openUrlInBrowser, } from '../lib/core.js';
-export function parseLinkOptions(argv, env, now, overrides = {}) {
+import { CliError, NETWORKS, assertNoExtraPositionals, createConsolePrompter, defaultDeadline, formatJson, parseFlags, parseFutureDeadline, resolveLinkerUrl, resolveNetwork, resolvePrivateKey, resolveRegistryAddress, resolveRpcUrl, openUrlInBrowser, } from '../lib/core.js';
+export async function parseLinkOptions(argv, env, now, overrides = {}) {
     const parsed = parseFlags(argv);
     assertNoExtraPositionals('link', parsed.positionals);
+    let ownerValue = parsed.values.owner;
+    if (!ownerValue) {
+        const prompter = createConsolePrompter();
+        try {
+            ownerValue = await prompter.text({ message: 'Owner wallet address (biomapped)' });
+        }
+        finally {
+            prompter.close();
+        }
+    }
+    if (!isAddress(ownerValue)) {
+        throw new CliError(`Invalid --owner. Expected a checksummed or lowercase EVM address.`);
+    }
     const network = resolveNetwork(parsed.values.network, env);
     return {
-        owner: parseRequiredAddress('owner', parsed.values.owner),
+        owner: ownerValue,
         registry: resolveRegistryAddress(parsed.values.registry, env, network),
         network,
         deadline: parsed.values.deadline ? parseFutureDeadline(parsed.values.deadline, now) : defaultDeadline(now),

package/dist/commands/request.d.ts

@@ -0,0 +1,23 @@
+import type { Hex } from 'viem';
+import { type EnvSource, type NetworkName } from '../lib/core.js';
+export interface RequestOptions {
+    url: string;
+    method: string;
+    network: NetworkName;
+    count: number;
+    json: boolean;
+    privateKey: Hex;
+}
+export interface RequestResult {
+    request: number;
+    status: number;
+    body: string;
+}
+export interface RequestDeps {
+    fetchImpl: typeof fetch;
+}
+export declare function parseRequestOptions(argv: string[], env: EnvSource, overrides?: {
+    privateKey?: string;
+}): RequestOptions;
+export declare function runRequest(options: RequestOptions, deps?: Partial<RequestDeps>): Promise<RequestResult[]>;
+export declare function formatRequestOutput(results: RequestResult[], json: boolean): string;

package/dist/commands/request.js

@@ -0,0 +1,89 @@
+import { SiweMessage } from 'siwe';
+import { privateKeyToAccount } from 'viem/accounts';
+import { CliError, NETWORKS, assertNoExtraPositionals, parseFlags, resolveNetwork, resolvePrivateKey, } from '../lib/core.js';
+export function parseRequestOptions(argv, env, overrides = {}) {
+    const parsed = parseFlags(argv);
+    if (parsed.positionals.length === 0) {
+        throw new CliError('Missing URL. Usage: agentlink request <url> [options]');
+    }
+    assertNoExtraPositionals('request', parsed.positionals.slice(1));
+    const url = parsed.positionals[0];
+    try {
+        new URL(url);
+    }
+    catch {
+        throw new CliError(`Invalid URL: "${url}"`);
+    }
+    const countRaw = parsed.values.count;
+    const count = countRaw ? parseInt(countRaw, 10) : 1;
+    if (isNaN(count) || count < 1) {
+        throw new CliError(`--count must be a positive integer, got "${countRaw}"`);
+    }
+    const network = resolveNetwork(parsed.values.network, env);
+    return {
+        url,
+        method: (parsed.values.method ?? 'GET').toUpperCase(),
+        network,
+        count,
+        json: parsed.flags.has('json'),
+        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);
+        let response;
+        try {
+            response = await fetchImpl(new Request(options.url, {
+                method: options.method,
+                headers: { agentlink: agentlinkHeader },
+            }));
+        }
+        catch (error) {
+            throw new CliError(`Request ${i} failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        const body = await response.text();
+        results.push({ request: i, status: response.status, body });
+    }
+    return results;
+}
+export function formatRequestOutput(results, json) {
+    if (json) {
+        return JSON.stringify(results, null, 2);
+    }
+    return results.map(r => `Request ${r.request}  ${r.status}  ${r.body.slice(0, 200)}`).join('\n');
+}

package/dist/help.d.ts

@@ -3,4 +3,5 @@ export declare function getKeystoreHelpText(): string;
 export declare function getAuthorizeLinkHelpText(): string;
 export declare function getStatusHelpText(): string;
 export declare function getLinkHelpText(): string;
+export declare function getRequestHelpText(): string;
 export declare function getInitHelpText(): string;

package/dist/help.js

@@ -7,6 +7,7 @@ Commands:
   link             Generate consent and open a linker URL for owner approval
   authorize-link   Generate a one-time EIP-712 consent blob for manual linking
   status           Check whether an agent is linked and active
+  request          Send a signed agentlink request to a protected endpoint
 
 Flags:
   --help, -h       Show this help text
@@ -108,6 +109,32 @@ Options:
   --help         Show this help message
 `;
 }
+export function getRequestHelpText() {
+    return `Usage:
+  agentlink request <url> [options]
+
+Description:
+  Send a signed agentlink request to a URL. Builds a SIWE payload signed with
+  your agent wallet, attaches it as the "agentlink" header, and prints the
+  response. Use --count to repeat the request (e.g. to test free-trial limits).
+
+Options:
+  --method       HTTP method (default: GET)
+  --count        Number of times to send the request (default: 1)
+  --network      base | base-sepolia (default: BIOMAPPER_NETWORK or base-sepolia)
+  --private-key-stdin  Read the agent private key from stdin
+  --private-key  Dev-only: pass key directly as 0x-prefixed hex
+  --json         Output results as JSON
+  --help         Show this help message
+
+Key resolution order: keystore (default) → --private-key-stdin → --private-key → AGENT_PRIVATE_KEY env
+
+Examples:
+  agentlink request http://localhost:3000/data
+  agentlink request http://75.119.141.48:3000/data --count 4
+  agentlink request https://api.example.com/resource --method POST --network base
+`;
+}
 export function getInitHelpText() {
     return `Usage:
   agentlink init [dir] [options]

package/dist/index.d.ts

@@ -13,5 +13,6 @@ export interface CliRuntime {
     openUrl: (url: string) => Promise<void>;
     readStdin: () => Promise<string>;
     readPassword: (prompt: string) => Promise<string>;
+    fetchImpl: typeof fetch;
 }
 export declare function runCli(argv?: string[], overrides?: Partial<CliRuntime>): Promise<number>;

package/dist/index.js

@@ -6,10 +6,11 @@ import { formatInitOutput, parseInitOptions, runInit } from './commands/init.js'
 import { formatLinkOutput, parseLinkOptions, runLink } from './commands/link.js';
 import { formatStatusOutput, parseStatusOptions, runStatus } from './commands/status.js';
 import { parseAuthorizeLinkOptions, runAuthorizeLink } from './commands/authorize-link.js';
+import { formatRequestOutput, parseRequestOptions, runRequest } from './commands/request.js';
 import { runKeystoreAddress, runKeystoreDelete, runKeystoreSet } from './commands/keystore.js';
 import { CliError, formatJson, loadEnvFiles, openUrlInBrowser, parseFlags, readAllFromStdin, readPassword } from './lib/core.js';
 import { decryptKeystore, keystoreExists, keystorePath } from './lib/keystore.js';
-import { getAuthorizeLinkHelpText, getInitHelpText, getKeystoreHelpText, getLinkHelpText, getRootHelpText, getStatusHelpText, } from './help.js';
+import { getAuthorizeLinkHelpText, getInitHelpText, getKeystoreHelpText, getLinkHelpText, getRequestHelpText, getRootHelpText, getStatusHelpText, } from './help.js';
 import { VERSION } from './version.js';
 import { buildEmbeddedHostedLinkUrl, createAgentLinkConsent, createBiomapperQueryClient, createLinkSession, } from '@techdigger/humanode-agentlink';
 function writeLine(write, text) {
@@ -34,6 +35,7 @@ export async function runCli(argv = process.argv.slice(2), overrides = {}) {
         openUrl: overrides.openUrl ?? openUrlInBrowser,
         readStdin: overrides.readStdin ?? readAllFromStdin,
         readPassword: overrides.readPassword ?? readPassword,
+        fetchImpl: overrides.fetchImpl ?? fetch,
     };
     const [command, ...args] = argv;
     try {
@@ -83,7 +85,7 @@ export async function runCli(argv = process.argv.slice(2), overrides = {}) {
                     return 0;
                 }
                 const authorizePrivateKey = await readPrivateKeyFromStdin(args, runtime);
-                writeLine(runtime.stdout, formatJson(await runAuthorizeLink(parseAuthorizeLinkOptions(args, runtime.env, runtime.now, {
+                writeLine(runtime.stdout, formatJson(await runAuthorizeLink(await parseAuthorizeLinkOptions(args, runtime.env, runtime.now, {
                     privateKey: authorizePrivateKey,
                 }), {
                     createAgentLinkConsent: runtime.createAgentLinkConsent,
@@ -136,7 +138,7 @@ export async function runCli(argv = process.argv.slice(2), overrides = {}) {
                     return 0;
                 }
                 const linkPrivateKey = await readPrivateKeyFromStdin(args, runtime);
-                const options = parseLinkOptions(args, runtime.env, runtime.now, {
+                const options = await parseLinkOptions(args, runtime.env, runtime.now, {
                     privateKey: linkPrivateKey,
                 });
                 const result = await runLink(options, {
@@ -183,6 +185,17 @@ export async function runCli(argv = process.argv.slice(2), overrides = {}) {
                 }, runtime.env);
                 return 0;
             }
+            case 'request': {
+                if (args.includes('--help') || args.includes('-h')) {
+                    writeLine(runtime.stdout, getRequestHelpText());
+                    return 0;
+                }
+                const requestPrivateKey = await readPrivateKeyFromStdin(args, runtime);
+                const requestOptions = parseRequestOptions(args, runtime.env, { privateKey: requestPrivateKey });
+                const requestResults = await runRequest(requestOptions, { fetchImpl: runtime.fetchImpl });
+                writeLine(runtime.stdout, formatRequestOutput(requestResults, requestOptions.json));
+                return 0;
+            }
             default:
                 throw new CliError(`Unknown command "${command}". Run "agentlink --help" for available commands.`);
         }

package/dist/lib/core.d.ts

@@ -4,11 +4,13 @@ export declare const NETWORKS: {
         readonly label: "Base mainnet";
         readonly biomapperAppUrl: string;
         readonly defaultRegistry: Address;
+        readonly chainId: 8453;
     };
     readonly 'base-sepolia': {
         readonly label: "Base Sepolia";
         readonly biomapperAppUrl: string;
         readonly defaultRegistry: Address;
+        readonly chainId: 84532;
     };
 };
 export type NetworkName = keyof typeof NETWORKS;

package/dist/lib/core.js

@@ -12,11 +12,13 @@ export const NETWORKS = {
         label: 'Base mainnet',
         biomapperAppUrl: BIOMAPPER_APP_URLS.base,
         defaultRegistry: '0x', // populated at mainnet launch
+        chainId: 8453,
     },
     'base-sepolia': {
         label: 'Base Sepolia',
         biomapperAppUrl: BIOMAPPER_APP_URLS['base-sepolia'],
         defaultRegistry: '0xc0fb26BaACe7E1BCb3aFFD547AD5f2cAc4A4F51b',
+        chainId: 84532,
     },
 };
 export const TEMPLATE_NAMES = ['langchain', 'vercel-ai-sdk', 'mcp'];

package/dist/templates.js

@@ -7,16 +7,11 @@ 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, _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() {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@techdigger/humanode-agentlink-cli",
-	"version": "0.3.2",
+	"version": "0.3.4",
 	"description": "Scaffold, link, and inspect Biomapper-ready agent projects.",
 	"type": "module",
 	"main": "dist/index.js",
@@ -23,8 +23,9 @@
 		"cli": "tsx src/index.ts"
 	},
 	"dependencies": {
-		"@techdigger/humanode-agentlink": "^0.2.0",
+		"@techdigger/humanode-agentlink": "^0.3.0",
 		"posthog-node": "^5.21.2",
+		"siwe": "^2.3.2",
 		"viem": "^2.46.2"
 	},
 	"keywords": [