beam-protocol-cli 0.2.0

package/dist/commands/init.d.ts

@@ -0,0 +1,9 @@
+interface InitOptions {
+    agent: string;
+    org: string;
+    force?: boolean;
+    directory?: string;
+}
+export declare function cmdInit(options: InitOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAKA,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CjE"}

package/dist/commands/init.js

@@ -0,0 +1,45 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { BeamIdentity } from 'beam-protocol-sdk';
+import { configExists, saveConfig, DEFAULT_DIRECTORY_URL } from '../config.js';
+export async function cmdInit(options) {
+    const { agent, org, force, directory = DEFAULT_DIRECTORY_URL } = options;
+    // Validate inputs
+    if (!/^[a-z0-9_-]+$/.test(agent)) {
+        console.error(chalk.red('✖ Agent name must match [a-z0-9_-]'));
+        process.exit(1);
+    }
+    if (!/^[a-z0-9_-]+$/.test(org)) {
+        console.error(chalk.red('✖ Org name must match [a-z0-9_-]'));
+        process.exit(1);
+    }
+    if (configExists() && !force) {
+        console.error(chalk.yellow('⚠ Identity already exists at .beam/identity.json'));
+        console.error(chalk.dim('  Use --force to overwrite'));
+        process.exit(1);
+    }
+    const spinner = ora('Generating Ed25519 keypair...').start();
+    const identity = BeamIdentity.generate({ agentName: agent, orgName: org });
+    const identityData = identity.export();
+    saveConfig({
+        identity: identityData,
+        directoryUrl: directory,
+        createdAt: new Date().toISOString()
+    });
+    spinner.succeed('Identity generated');
+    console.log('');
+    console.log(chalk.bold('🔑 Beam Identity Created'));
+    console.log(chalk.dim('─'.repeat(40)));
+    console.log(`${chalk.cyan('Beam ID:')}     ${chalk.bold(identityData.beamId)}`);
+    console.log(`${chalk.cyan('Directory:')}   ${directory}`);
+    console.log(`${chalk.cyan('Config:')}      ${process.cwd()}/.beam/identity.json`);
+    console.log('');
+    console.log(chalk.dim('Public key (SPKI/DER/base64):'));
+    console.log(chalk.dim(identityData.publicKeyBase64.substring(0, 64) + '...'));
+    console.log('');
+    console.log(chalk.yellow('⚠  Keep .beam/identity.json secret — it contains your private key!'));
+    console.log(chalk.dim('   Add .beam/ to your .gitignore'));
+    console.log('');
+    console.log(chalk.green('Next step:'), `beam register --display-name "My Agent" --capabilities "query,answer"`);
+}
+//# sourceMappingURL=init.js.map

package/dist/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/commands/lookup.d.ts

@@ -0,0 +1,7 @@
+interface LookupOptions {
+    directory?: string;
+    json?: boolean;
+}
+export declare function cmdLookup(beamId: string, options: LookupOptions): Promise<void>;
+export {};
+//# sourceMappingURL=lookup.d.ts.map

package/dist/commands/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/commands/lookup.ts"],"names":[],"mappings":"AAMA,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDrF"}

package/dist/commands/lookup.js

@@ -0,0 +1,58 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { BeamDirectory } from 'beam-protocol-sdk';
+import { loadConfig } from '../config.js';
+export async function cmdLookup(beamId, options) {
+    const config = loadConfig();
+    const directoryUrl = options.directory ?? config.directoryUrl;
+    // Validate beam ID format
+    if (!beamId.match(/^[a-z0-9_-]+@[a-z0-9_-]+\.beam\.directory$/)) {
+        console.error(chalk.red(`✖ Invalid Beam ID format: ${beamId}`));
+        console.error(chalk.dim('  Expected: agent@org.beam.directory'));
+        process.exit(1);
+    }
+    const spinner = ora(`Looking up ${chalk.bold(beamId)}...`).start();
+    try {
+        const directory = new BeamDirectory({ baseUrl: directoryUrl });
+        const record = await directory.lookup(beamId);
+        if (!record) {
+            spinner.fail(`Agent not found: ${beamId}`);
+            process.exit(1);
+        }
+        spinner.stop();
+        if (options.json) {
+            console.log(JSON.stringify(record, null, 2));
+            return;
+        }
+        const trustBar = getTrustBar(record.trustScore);
+        console.log('');
+        console.log(chalk.bold(`🤖 ${record.displayName}`));
+        console.log(chalk.dim('─'.repeat(40)));
+        console.log(`${chalk.cyan('Beam ID:')}      ${chalk.bold(record.beamId)}`);
+        console.log(`${chalk.cyan('Org:')}          ${record.org}`);
+        console.log(`${chalk.cyan('Trust Score:')} ${trustBar} ${(record.trustScore * 100).toFixed(0)}%`);
+        console.log(`${chalk.cyan('Verified:')}     ${record.verified ? chalk.green('✓ Verified') : chalk.yellow('Unverified')}`);
+        if (record.capabilities.length > 0) {
+            console.log(`${chalk.cyan('Capabilities:')} ${record.capabilities.map(c => chalk.blue(c)).join(', ')}`);
+        }
+        console.log(`${chalk.cyan('Last Seen:')}   ${new Date(record.lastSeen).toLocaleString()}`);
+        console.log(`${chalk.cyan('Registered:')}  ${new Date(record.createdAt).toLocaleString()}`);
+        console.log('');
+    }
+    catch (err) {
+        spinner.fail('Lookup failed');
+        console.error(chalk.red(`✖ ${err.message}`));
+        process.exit(1);
+    }
+}
+function getTrustBar(score) {
+    const filled = Math.round(score * 10);
+    const empty = 10 - filled;
+    const bar = '█'.repeat(filled) + '░'.repeat(empty);
+    if (score >= 0.8)
+        return chalk.green(bar);
+    if (score >= 0.5)
+        return chalk.yellow(bar);
+    return chalk.red(bar);
+}
+//# sourceMappingURL=lookup.js.map

package/dist/commands/lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../src/commands/lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,GAAG,MAAM,KAAK,CAAA;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAOzC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc,EAAE,OAAsB;IACpE,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,YAAY,CAAA;IAE7D,0BAA0B;IAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4CAA4C,CAAC,EAAE,CAAC;QAChE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,6BAA6B,MAAM,EAAE,CAAC,CAAC,CAAA;QAC/D,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC,CAAA;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAA;IAElE,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAA;QAC9D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,MAAsB,CAAC,CAAA;QAE7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAA;YAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,OAAO,CAAC,IAAI,EAAE,CAAA;QAEd,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;YAC5C,OAAM;QACR,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAE/C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;QACnD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACtC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAC1E,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;QAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,QAAQ,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QACjG,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;QACzH,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACzG,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;QAC1F,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;QAC3F,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QAC7B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,EAAE,GAAG,MAAM,CAAA;IACzB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAClD,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACzC,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC1C,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AACvB,CAAC"}

package/dist/commands/register.d.ts

@@ -0,0 +1,8 @@
+interface RegisterOptions {
+    displayName?: string;
+    capabilities?: string;
+    directory?: string;
+}
+export declare function cmdRegister(options: RegisterOptions): Promise<void>;
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/commands/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/commands/register.ts"],"names":[],"mappings":"AAKA,UAAU,eAAe;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CzE"}

package/dist/commands/register.js

@@ -0,0 +1,46 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { BeamClient, BeamIdentity } from 'beam-protocol-sdk';
+import { loadConfig } from '../config.js';
+export async function cmdRegister(options) {
+    const config = loadConfig();
+    const directoryUrl = options.directory ?? config.directoryUrl;
+    const parsed = BeamIdentity.parseBeamId(config.identity.beamId);
+    if (!parsed) {
+        console.error(chalk.red('✖ Invalid Beam ID in config'));
+        process.exit(1);
+    }
+    const displayName = options.displayName ?? parsed.agent;
+    const capabilities = options.capabilities
+        ? options.capabilities.split(',').map(c => c.trim()).filter(Boolean)
+        : [];
+    const spinner = ora(`Registering ${chalk.bold(config.identity.beamId)}...`).start();
+    try {
+        const client = new BeamClient({
+            identity: config.identity,
+            directoryUrl
+        });
+        const record = await client.register(displayName, capabilities);
+        spinner.succeed('Agent registered successfully');
+        console.log('');
+        console.log(chalk.bold('✅ Registration Complete'));
+        console.log(chalk.dim('─'.repeat(40)));
+        console.log(`${chalk.cyan('Beam ID:')}      ${chalk.bold(record.beamId)}`);
+        console.log(`${chalk.cyan('Display:')}      ${record.displayName}`);
+        console.log(`${chalk.cyan('Org:')}          ${record.org}`);
+        console.log(`${chalk.cyan('Trust Score:')} ${(record.trustScore * 100).toFixed(0)}%`);
+        console.log(`${chalk.cyan('Verified:')}     ${record.verified ? chalk.green('Yes ✓') : chalk.yellow('No')}`);
+        if (record.capabilities.length > 0) {
+            console.log(`${chalk.cyan('Capabilities:')} ${record.capabilities.join(', ')}`);
+        }
+        console.log(`${chalk.cyan('Registered:')}  ${new Date(record.createdAt).toLocaleString()}`);
+        console.log('');
+        console.log(chalk.green('Next step:'), `beam lookup ${record.beamId}`);
+    }
+    catch (err) {
+        spinner.fail('Registration failed');
+        console.error(chalk.red(`✖ ${err.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/commands/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/commands/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,GAAG,MAAM,KAAK,CAAA;AACrB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAQzC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAwB;IACxD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,YAAY,CAAA;IAE7D,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC/D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAA;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,CAAA;IACvD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY;QACvC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACpE,CAAC,CAAC,EAAE,CAAA;IAEN,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAA;IAEnF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;YAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY;SACb,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;QAE/D,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAA;QAEhD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAA;QAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACtC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAC1E,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;QACnE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;QAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QACrF,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC5G,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACjF,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;QAC3F,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,eAAe,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;IACxE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;QACnC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC"}

package/dist/commands/search.d.ts

@@ -0,0 +1,11 @@
+interface SearchOptions {
+    org?: string;
+    capability?: string;
+    minTrust?: string;
+    limit?: string;
+    directory?: string;
+    json?: boolean;
+}
+export declare function cmdSearch(options: SearchOptions): Promise<void>;
+export {};
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAKA,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DrE"}

package/dist/commands/search.js

@@ -0,0 +1,73 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { BeamDirectory } from 'beam-protocol-sdk';
+import { loadConfig } from '../config.js';
+export async function cmdSearch(options) {
+    const config = loadConfig();
+    const directoryUrl = options.directory ?? config.directoryUrl;
+    const query = {
+        org: options.org,
+        capabilities: options.capability ? [options.capability] : undefined,
+        minTrustScore: options.minTrust ? parseFloat(options.minTrust) : undefined,
+        limit: options.limit ? parseInt(options.limit, 10) : 20
+    };
+    const parts = [];
+    if (query.org)
+        parts.push(`org=${query.org}`);
+    if (query.capabilities)
+        parts.push(`capability=${query.capabilities[0]}`);
+    const label = parts.length ? parts.join(', ') : 'all agents';
+    const spinner = ora(`Searching ${label}...`).start();
+    try {
+        const directory = new BeamDirectory({ baseUrl: directoryUrl });
+        const agents = await directory.search(query);
+        spinner.stop();
+        if (options.json) {
+            console.log(JSON.stringify(agents, null, 2));
+            return;
+        }
+        if (agents.length === 0) {
+            console.log(chalk.yellow(`\n  No agents found matching your query.\n`));
+            return;
+        }
+        console.log('');
+        console.log(chalk.bold(`🔍 Found ${agents.length} agent${agents.length !== 1 ? 's' : ''}`));
+        console.log(chalk.dim('─'.repeat(60)));
+        for (const agent of agents) {
+            const trustPct = (agent.trustScore * 100).toFixed(0);
+            const verified = agent.verified ? chalk.green('✓') : chalk.dim('○');
+            const caps = agent.capabilities.length > 0
+                ? chalk.dim(` [${agent.capabilities.join(', ')}]`)
+                : '';
+            console.log(`  ${verified} ${chalk.bold(agent.beamId)}${caps}`);
+            console.log(`     ${chalk.dim(agent.displayName)} · Trust: ${getTrustColored(agent.trustScore, trustPct + '%')} · Last seen: ${formatRelative(agent.lastSeen)}`);
+            console.log('');
+        }
+    }
+    catch (err) {
+        spinner.fail('Search failed');
+        console.error(chalk.red(`✖ ${err.message}`));
+        process.exit(1);
+    }
+}
+function getTrustColored(score, label) {
+    if (score >= 0.8)
+        return chalk.green(label);
+    if (score >= 0.5)
+        return chalk.yellow(label);
+    return chalk.red(label);
+}
+function formatRelative(iso) {
+    const ms = Date.now() - new Date(iso).getTime();
+    const minutes = Math.floor(ms / 60000);
+    if (minutes < 1)
+        return chalk.dim('just now');
+    if (minutes < 60)
+        return chalk.dim(`${minutes}m ago`);
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return chalk.dim(`${hours}h ago`);
+    const days = Math.floor(hours / 24);
+    return chalk.dim(`${days}d ago`);
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

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

package/dist/commands/send.d.ts

@@ -0,0 +1,8 @@
+interface SendOptions {
+    directory?: string;
+    timeout?: string;
+    json?: boolean;
+}
+export declare function cmdSend(to: string, intent: string, paramsJson: string | undefined, options: SendOptions): Promise<void>;
+export {};
+//# sourceMappingURL=send.d.ts.map

package/dist/commands/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/commands/send.ts"],"names":[],"mappings":"AAMA,UAAU,WAAW;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,wBAAsB,OAAO,CAC3B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CA+Ef"}

package/dist/commands/send.js

@@ -0,0 +1,78 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { BeamClient } from 'beam-protocol-sdk';
+import { loadConfig } from '../config.js';
+export async function cmdSend(to, intent, paramsJson, options) {
+    const config = loadConfig();
+    const directoryUrl = options.directory ?? config.directoryUrl;
+    const timeoutMs = options.timeout ? parseInt(options.timeout, 10) * 1000 : 10000;
+    // Validate beam ID format
+    if (!to.match(/^[a-z0-9_-]+@[a-z0-9_-]+\.beam\.directory$/)) {
+        console.error(chalk.red(`✖ Invalid Beam ID: ${to}`));
+        console.error(chalk.dim('  Expected: agent@org.beam.directory'));
+        process.exit(1);
+    }
+    // Parse params
+    let params = {};
+    if (paramsJson) {
+        try {
+            const parsed = JSON.parse(paramsJson);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                params = parsed;
+            }
+            else {
+                throw new Error('Params must be a JSON object');
+            }
+        }
+        catch (err) {
+            console.error(chalk.red(`✖ Invalid params JSON: ${err.message}`));
+            process.exit(1);
+        }
+    }
+    const spinner = ora(`Sending ${chalk.bold(intent)} to ${chalk.bold(to)}...`).start();
+    const startTime = Date.now();
+    try {
+        const client = new BeamClient({
+            identity: config.identity,
+            directoryUrl
+        });
+        const result = await client.send(to, intent, params, timeoutMs);
+        const elapsed = Date.now() - startTime;
+        spinner.stop();
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        if (result.success) {
+            console.log('');
+            console.log(chalk.bold.green('✅ Intent delivered successfully'));
+            console.log(chalk.dim('─'.repeat(40)));
+            console.log(`${chalk.cyan('From:')}    ${config.identity.beamId}`);
+            console.log(`${chalk.cyan('To:')}      ${to}`);
+            console.log(`${chalk.cyan('Intent:')} ${intent}`);
+            console.log(`${chalk.cyan('Latency:')} ${elapsed}ms`);
+            if (result.payload && Object.keys(result.payload).length > 0) {
+                console.log('');
+                console.log(chalk.bold('📦 Result Payload:'));
+                console.log(JSON.stringify(result.payload, null, 2));
+            }
+        }
+        else {
+            console.log('');
+            console.log(chalk.bold.red('✖ Intent failed'));
+            console.log(chalk.dim('─'.repeat(40)));
+            console.log(`${chalk.cyan('Error:')}     ${result.error ?? 'Unknown error'}`);
+            if (result.errorCode) {
+                console.log(`${chalk.cyan('Code:')}      ${result.errorCode}`);
+            }
+            console.log(`${chalk.cyan('Latency:')} ${elapsed}ms`);
+        }
+        console.log('');
+    }
+    catch (err) {
+        spinner.fail('Send failed');
+        console.error(chalk.red(`✖ ${err.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=send.js.map

package/dist/commands/send.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+import type { BeamIdentityData } from 'beam-protocol-sdk';
+export interface BeamConfig {
+    identity: BeamIdentityData;
+    directoryUrl: string;
+    createdAt: string;
+}
+export declare function getConfigDir(cwd?: string): string;
+export declare function getConfigPath(cwd?: string): string;
+export declare function configExists(cwd?: string): boolean;
+export declare function loadConfig(cwd?: string): BeamConfig;
+export declare function saveConfig(config: BeamConfig, cwd?: string): void;
+export declare const DEFAULT_DIRECTORY_URL: string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,YAAY,CAAC,GAAG,SAAgB,GAAG,MAAM,CAExD;AAED,wBAAgB,aAAa,CAAC,GAAG,SAAgB,GAAG,MAAM,CAEzD;AAED,wBAAgB,YAAY,CAAC,GAAG,SAAgB,GAAG,OAAO,CAEzD;AAED,wBAAgB,UAAU,CAAC,GAAG,SAAgB,GAAG,UAAU,CAS1D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,SAAgB,GAAG,IAAI,CAIxE;AAED,eAAO,MAAM,qBAAqB,QAAoE,CAAA"}

package/dist/config.js

@@ -0,0 +1,26 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+export function getConfigDir(cwd = process.cwd()) {
+    return join(cwd, '.beam');
+}
+export function getConfigPath(cwd = process.cwd()) {
+    return join(getConfigDir(cwd), 'identity.json');
+}
+export function configExists(cwd = process.cwd()) {
+    return existsSync(getConfigPath(cwd));
+}
+export function loadConfig(cwd = process.cwd()) {
+    const path = getConfigPath(cwd);
+    if (!existsSync(path)) {
+        throw new Error(`No Beam identity found. Run 'beam init' first.`);
+    }
+    const raw = readFileSync(path, 'utf8');
+    return JSON.parse(raw);
+}
+export function saveConfig(config, cwd = process.cwd()) {
+    const dir = getConfigDir(cwd);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(getConfigPath(cwd), JSON.stringify(config, null, 2), 'utf8');
+}
+export const DEFAULT_DIRECTORY_URL = process.env['BEAM_DIRECTORY_URL'] ?? 'https://api.beam.directory';
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAShC,MAAM,UAAU,YAAY,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC9C,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC/C,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC9C,OAAO,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC5C,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,gDAAgD,CACjD,CAAA;IACH,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAChE,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;IAC7B,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnC,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;AAC5E,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,4BAA4B,CAAA"}

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":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { cmdInit } from './commands/init.js';
+import { cmdRegister } from './commands/register.js';
+import { cmdLookup } from './commands/lookup.js';
+import { cmdSearch } from './commands/search.js';
+import { cmdSend } from './commands/send.js';
+const program = new Command();
+program
+    .name('beam')
+    .description(chalk.bold('Beam Protocol CLI') + '\n' +
+    chalk.dim('SMTP for AI Agents — agent identity, registration & intent routing'))
+    .version('0.1.0');
+// ─── beam init ────────────────────────────────────────────────────────────────
+program
+    .command('init')
+    .description('Generate a new Beam identity (writes .beam/identity.json)')
+    .requiredOption('-a, --agent <name>', 'Agent name (e.g. jarvis)')
+    .requiredOption('-o, --org <name>', 'Organisation name (e.g. coppen)')
+    .option('-d, --directory <url>', 'Directory server URL', process.env['BEAM_DIRECTORY_URL'] ?? 'https://api.beam.directory')
+    .option('-f, --force', 'Overwrite existing identity')
+    .action(async (opts) => {
+    await cmdInit(opts);
+});
+// ─── beam register ────────────────────────────────────────────────────────────
+program
+    .command('register')
+    .description('Register this agent with a Beam directory')
+    .option('-n, --display-name <name>', 'Human-readable display name')
+    .option('-c, --capabilities <list>', 'Comma-separated capabilities (e.g. query,answer,write)')
+    .option('-d, --directory <url>', 'Override directory URL')
+    .action(async (opts) => {
+    await cmdRegister(opts);
+});
+// ─── beam lookup ──────────────────────────────────────────────────────────────
+program
+    .command('lookup <beamId>')
+    .description('Look up an agent by Beam ID')
+    .option('-d, --directory <url>', 'Override directory URL')
+    .option('--json', 'Output raw JSON')
+    .action(async (beamId, opts) => {
+    await cmdLookup(beamId, opts);
+});
+// ─── beam search ──────────────────────────────────────────────────────────────
+program
+    .command('search')
+    .description('Search for agents in the directory')
+    .option('--org <org>', 'Filter by organisation')
+    .option('--capability <cap>', 'Filter by capability')
+    .option('--min-trust <score>', 'Minimum trust score (0.0-1.0)')
+    .option('--limit <n>', 'Max results', '20')
+    .option('-d, --directory <url>', 'Override directory URL')
+    .option('--json', 'Output raw JSON')
+    .action(async (opts) => {
+    await cmdSearch(opts);
+});
+// ─── beam send ────────────────────────────────────────────────────────────────
+program
+    .command('send <to> <intent> [params]')
+    .description('Send an intent to an agent and print the result')
+    .option('-d, --directory <url>', 'Override directory URL')
+    .option('-t, --timeout <seconds>', 'Timeout in seconds', '10')
+    .option('--json', 'Output raw JSON')
+    .action(async (to, intent, params, opts) => {
+    await cmdSend(to, intent, params, opts);
+});
+// ─── Error handling ───────────────────────────────────────────────────────────
+program.configureOutput({
+    writeErr: str => process.stderr.write(chalk.red(str))
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "beam-protocol-cli",
+  "version": "0.2.0",
+  "description": "Beam Protocol CLI \u2014 manage Beam identities, register agents, send intents",
+  "type": "module",
+  "bin": {
+    "beam": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "node --watch dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@beam-protocol/sdk": "*",
+    "beam-protocol-sdk": "^0.2.2",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "inquirer": "^9.2.15",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "Apache-2.0",
+  "keywords": [
+    "beam-protocol",
+    "a2a",
+    "ai-agents",
+    "cli"
+  ]
+}

package/src/commands/init.ts

@@ -0,0 +1,59 @@
+import chalk from 'chalk'
+import ora from 'ora'
+import { BeamIdentity } from 'beam-protocol-sdk'
+import { configExists, saveConfig, DEFAULT_DIRECTORY_URL } from '../config.js'
+
+interface InitOptions {
+  agent: string
+  org: string
+  force?: boolean
+  directory?: string
+}
+
+export async function cmdInit(options: InitOptions): Promise<void> {
+  const { agent, org, force, directory = DEFAULT_DIRECTORY_URL } = options
+
+  // Validate inputs
+  if (!/^[a-z0-9_-]+$/.test(agent)) {
+    console.error(chalk.red('✖ Agent name must match [a-z0-9_-]'))
+    process.exit(1)
+  }
+  if (!/^[a-z0-9_-]+$/.test(org)) {
+    console.error(chalk.red('✖ Org name must match [a-z0-9_-]'))
+    process.exit(1)
+  }
+
+  if (configExists() && !force) {
+    console.error(chalk.yellow('⚠ Identity already exists at .beam/identity.json'))
+    console.error(chalk.dim('  Use --force to overwrite'))
+    process.exit(1)
+  }
+
+  const spinner = ora('Generating Ed25519 keypair...').start()
+
+  const identity = BeamIdentity.generate({ agentName: agent, orgName: org })
+  const identityData = identity.export()
+
+  saveConfig({
+    identity: identityData,
+    directoryUrl: directory,
+    createdAt: new Date().toISOString()
+  })
+
+  spinner.succeed('Identity generated')
+
+  console.log('')
+  console.log(chalk.bold('🔑 Beam Identity Created'))
+  console.log(chalk.dim('─'.repeat(40)))
+  console.log(`${chalk.cyan('Beam ID:')}     ${chalk.bold(identityData.beamId)}`)
+  console.log(`${chalk.cyan('Directory:')}   ${directory}`)
+  console.log(`${chalk.cyan('Config:')}      ${process.cwd()}/.beam/identity.json`)
+  console.log('')
+  console.log(chalk.dim('Public key (SPKI/DER/base64):'))
+  console.log(chalk.dim(identityData.publicKeyBase64.substring(0, 64) + '...'))
+  console.log('')
+  console.log(chalk.yellow('⚠  Keep .beam/identity.json secret — it contains your private key!'))
+  console.log(chalk.dim('   Add .beam/ to your .gitignore'))
+  console.log('')
+  console.log(chalk.green('Next step:'), `beam register --display-name "My Agent" --capabilities "query,answer"`)
+}

package/src/commands/lookup.ts

@@ -0,0 +1,70 @@
+import chalk from 'chalk'
+import ora from 'ora'
+import { BeamDirectory } from 'beam-protocol-sdk'
+import type { BeamIdString } from 'beam-protocol-sdk'
+import { loadConfig } from '../config.js'
+
+interface LookupOptions {
+  directory?: string
+  json?: boolean
+}
+
+export async function cmdLookup(beamId: string, options: LookupOptions): Promise<void> {
+  const config = loadConfig()
+  const directoryUrl = options.directory ?? config.directoryUrl
+
+  // Validate beam ID format
+  if (!beamId.match(/^[a-z0-9_-]+@[a-z0-9_-]+\.beam\.directory$/)) {
+    console.error(chalk.red(`✖ Invalid Beam ID format: ${beamId}`))
+    console.error(chalk.dim('  Expected: agent@org.beam.directory'))
+    process.exit(1)
+  }
+
+  const spinner = ora(`Looking up ${chalk.bold(beamId)}...`).start()
+
+  try {
+    const directory = new BeamDirectory({ baseUrl: directoryUrl })
+    const record = await directory.lookup(beamId as BeamIdString)
+
+    if (!record) {
+      spinner.fail(`Agent not found: ${beamId}`)
+      process.exit(1)
+    }
+
+    spinner.stop()
+
+    if (options.json) {
+      console.log(JSON.stringify(record, null, 2))
+      return
+    }
+
+    const trustBar = getTrustBar(record.trustScore)
+
+    console.log('')
+    console.log(chalk.bold(`🤖 ${record.displayName}`))
+    console.log(chalk.dim('─'.repeat(40)))
+    console.log(`${chalk.cyan('Beam ID:')}      ${chalk.bold(record.beamId)}`)
+    console.log(`${chalk.cyan('Org:')}          ${record.org}`)
+    console.log(`${chalk.cyan('Trust Score:')} ${trustBar} ${(record.trustScore * 100).toFixed(0)}%`)
+    console.log(`${chalk.cyan('Verified:')}     ${record.verified ? chalk.green('✓ Verified') : chalk.yellow('Unverified')}`)
+    if (record.capabilities.length > 0) {
+      console.log(`${chalk.cyan('Capabilities:')} ${record.capabilities.map(c => chalk.blue(c)).join(', ')}`)
+    }
+    console.log(`${chalk.cyan('Last Seen:')}   ${new Date(record.lastSeen).toLocaleString()}`)
+    console.log(`${chalk.cyan('Registered:')}  ${new Date(record.createdAt).toLocaleString()}`)
+    console.log('')
+  } catch (err) {
+    spinner.fail('Lookup failed')
+    console.error(chalk.red(`✖ ${(err as Error).message}`))
+    process.exit(1)
+  }
+}
+
+function getTrustBar(score: number): string {
+  const filled = Math.round(score * 10)
+  const empty = 10 - filled
+  const bar = '█'.repeat(filled) + '░'.repeat(empty)
+  if (score >= 0.8) return chalk.green(bar)
+  if (score >= 0.5) return chalk.yellow(bar)
+  return chalk.red(bar)
+}

package/src/commands/register.ts

@@ -0,0 +1,58 @@
+import chalk from 'chalk'
+import ora from 'ora'
+import { BeamClient, BeamIdentity } from 'beam-protocol-sdk'
+import { loadConfig } from '../config.js'
+
+interface RegisterOptions {
+  displayName?: string
+  capabilities?: string
+  directory?: string
+}
+
+export async function cmdRegister(options: RegisterOptions): Promise<void> {
+  const config = loadConfig()
+  const directoryUrl = options.directory ?? config.directoryUrl
+
+  const parsed = BeamIdentity.parseBeamId(config.identity.beamId)
+  if (!parsed) {
+    console.error(chalk.red('✖ Invalid Beam ID in config'))
+    process.exit(1)
+  }
+
+  const displayName = options.displayName ?? parsed.agent
+  const capabilities = options.capabilities
+    ? options.capabilities.split(',').map(c => c.trim()).filter(Boolean)
+    : []
+
+  const spinner = ora(`Registering ${chalk.bold(config.identity.beamId)}...`).start()
+
+  try {
+    const client = new BeamClient({
+      identity: config.identity,
+      directoryUrl
+    })
+
+    const record = await client.register(displayName, capabilities)
+
+    spinner.succeed('Agent registered successfully')
+
+    console.log('')
+    console.log(chalk.bold('✅ Registration Complete'))
+    console.log(chalk.dim('─'.repeat(40)))
+    console.log(`${chalk.cyan('Beam ID:')}      ${chalk.bold(record.beamId)}`)
+    console.log(`${chalk.cyan('Display:')}      ${record.displayName}`)
+    console.log(`${chalk.cyan('Org:')}          ${record.org}`)
+    console.log(`${chalk.cyan('Trust Score:')} ${(record.trustScore * 100).toFixed(0)}%`)
+    console.log(`${chalk.cyan('Verified:')}     ${record.verified ? chalk.green('Yes ✓') : chalk.yellow('No')}`)
+    if (record.capabilities.length > 0) {
+      console.log(`${chalk.cyan('Capabilities:')} ${record.capabilities.join(', ')}`)
+    }
+    console.log(`${chalk.cyan('Registered:')}  ${new Date(record.createdAt).toLocaleString()}`)
+    console.log('')
+    console.log(chalk.green('Next step:'), `beam lookup ${record.beamId}`)
+  } catch (err) {
+    spinner.fail('Registration failed')
+    console.error(chalk.red(`✖ ${(err as Error).message}`))
+    process.exit(1)
+  }
+}

package/src/commands/search.ts

@@ -0,0 +1,90 @@
+import chalk from 'chalk'
+import ora from 'ora'
+import { BeamDirectory } from 'beam-protocol-sdk'
+import { loadConfig } from '../config.js'
+
+interface SearchOptions {
+  org?: string
+  capability?: string
+  minTrust?: string
+  limit?: string
+  directory?: string
+  json?: boolean
+}
+
+export async function cmdSearch(options: SearchOptions): Promise<void> {
+  const config = loadConfig()
+  const directoryUrl = options.directory ?? config.directoryUrl
+
+  const query = {
+    org: options.org,
+    capabilities: options.capability ? [options.capability] : undefined,
+    minTrustScore: options.minTrust ? parseFloat(options.minTrust) : undefined,
+    limit: options.limit ? parseInt(options.limit, 10) : 20
+  }
+
+  const parts = []
+  if (query.org) parts.push(`org=${query.org}`)
+  if (query.capabilities) parts.push(`capability=${query.capabilities[0]}`)
+  const label = parts.length ? parts.join(', ') : 'all agents'
+
+  const spinner = ora(`Searching ${label}...`).start()
+
+  try {
+    const directory = new BeamDirectory({ baseUrl: directoryUrl })
+    const agents = await directory.search(query)
+
+    spinner.stop()
+
+    if (options.json) {
+      console.log(JSON.stringify(agents, null, 2))
+      return
+    }
+
+    if (agents.length === 0) {
+      console.log(chalk.yellow(`\n  No agents found matching your query.\n`))
+      return
+    }
+
+    console.log('')
+    console.log(chalk.bold(`🔍 Found ${agents.length} agent${agents.length !== 1 ? 's' : ''}`))
+    console.log(chalk.dim('─'.repeat(60)))
+
+    for (const agent of agents) {
+      const trustPct = (agent.trustScore * 100).toFixed(0)
+      const verified = agent.verified ? chalk.green('✓') : chalk.dim('○')
+      const caps = agent.capabilities.length > 0
+        ? chalk.dim(` [${agent.capabilities.join(', ')}]`)
+        : ''
+
+      console.log(
+        `  ${verified} ${chalk.bold(agent.beamId)}${caps}`
+      )
+      console.log(
+        `     ${chalk.dim(agent.displayName)} · Trust: ${getTrustColored(agent.trustScore, trustPct + '%')} · Last seen: ${formatRelative(agent.lastSeen)}`
+      )
+      console.log('')
+    }
+  } catch (err) {
+    spinner.fail('Search failed')
+    console.error(chalk.red(`✖ ${(err as Error).message}`))
+    process.exit(1)
+  }
+}
+
+function getTrustColored(score: number, label: string): string {
+  if (score >= 0.8) return chalk.green(label)
+  if (score >= 0.5) return chalk.yellow(label)
+  return chalk.red(label)
+}
+
+function formatRelative(iso: string): string {
+  const ms = Date.now() - new Date(iso).getTime()
+  const minutes = Math.floor(ms / 60000)
+  if (minutes < 1) return chalk.dim('just now')
+  if (minutes < 60) return chalk.dim(`${minutes}m ago`)
+  const hours = Math.floor(minutes / 60)
+  if (hours < 24) return chalk.dim(`${hours}h ago`)
+  const days = Math.floor(hours / 24)
+  return chalk.dim(`${days}d ago`)
+}

package/src/commands/send.ts

@@ -0,0 +1,97 @@
+import chalk from 'chalk'
+import ora from 'ora'
+import { BeamClient } from 'beam-protocol-sdk'
+import type { BeamIdString } from 'beam-protocol-sdk'
+import { loadConfig } from '../config.js'
+
+interface SendOptions {
+  directory?: string
+  timeout?: string
+  json?: boolean
+}
+
+export async function cmdSend(
+  to: string,
+  intent: string,
+  paramsJson: string | undefined,
+  options: SendOptions
+): Promise<void> {
+  const config = loadConfig()
+  const directoryUrl = options.directory ?? config.directoryUrl
+  const timeoutMs = options.timeout ? parseInt(options.timeout, 10) * 1000 : 10000
+
+  // Validate beam ID format
+  if (!to.match(/^[a-z0-9_-]+@[a-z0-9_-]+\.beam\.directory$/)) {
+    console.error(chalk.red(`✖ Invalid Beam ID: ${to}`))
+    console.error(chalk.dim('  Expected: agent@org.beam.directory'))
+    process.exit(1)
+  }
+
+  // Parse params
+  let params: Record<string, unknown> = {}
+  if (paramsJson) {
+    try {
+      const parsed: unknown = JSON.parse(paramsJson)
+      if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+        params = parsed as Record<string, unknown>
+      } else {
+        throw new Error('Params must be a JSON object')
+      }
+    } catch (err) {
+      console.error(chalk.red(`✖ Invalid params JSON: ${(err as Error).message}`))
+      process.exit(1)
+    }
+  }
+
+  const spinner = ora(
+    `Sending ${chalk.bold(intent)} to ${chalk.bold(to)}...`
+  ).start()
+
+  const startTime = Date.now()
+
+  try {
+    const client = new BeamClient({
+      identity: config.identity,
+      directoryUrl
+    })
+
+    const result = await client.send(to as BeamIdString, intent, params, timeoutMs)
+    const elapsed = Date.now() - startTime
+
+    spinner.stop()
+
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2))
+      return
+    }
+
+    if (result.success) {
+      console.log('')
+      console.log(chalk.bold.green('✅ Intent delivered successfully'))
+      console.log(chalk.dim('─'.repeat(40)))
+      console.log(`${chalk.cyan('From:')}    ${config.identity.beamId}`)
+      console.log(`${chalk.cyan('To:')}      ${to}`)
+      console.log(`${chalk.cyan('Intent:')} ${intent}`)
+      console.log(`${chalk.cyan('Latency:')} ${elapsed}ms`)
+      if (result.payload && Object.keys(result.payload).length > 0) {
+        console.log('')
+        console.log(chalk.bold('📦 Result Payload:'))
+        console.log(JSON.stringify(result.payload, null, 2))
+      }
+    } else {
+      console.log('')
+      console.log(chalk.bold.red('✖ Intent failed'))
+      console.log(chalk.dim('─'.repeat(40)))
+      console.log(`${chalk.cyan('Error:')}     ${result.error ?? 'Unknown error'}`)
+      if (result.errorCode) {
+        console.log(`${chalk.cyan('Code:')}      ${result.errorCode}`)
+      }
+      console.log(`${chalk.cyan('Latency:')} ${elapsed}ms`)
+    }
+    console.log('')
+  } catch (err) {
+    spinner.fail('Send failed')
+    console.error(chalk.red(`✖ ${(err as Error).message}`))
+    process.exit(1)
+  }
+}

package/src/config.ts

@@ -0,0 +1,40 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'
+import { join } from 'node:path'
+import type { BeamIdentityData } from 'beam-protocol-sdk'
+
+export interface BeamConfig {
+  identity: BeamIdentityData
+  directoryUrl: string
+  createdAt: string
+}
+
+export function getConfigDir(cwd = process.cwd()): string {
+  return join(cwd, '.beam')
+}
+
+export function getConfigPath(cwd = process.cwd()): string {
+  return join(getConfigDir(cwd), 'identity.json')
+}
+
+export function configExists(cwd = process.cwd()): boolean {
+  return existsSync(getConfigPath(cwd))
+}
+
+export function loadConfig(cwd = process.cwd()): BeamConfig {
+  const path = getConfigPath(cwd)
+  if (!existsSync(path)) {
+    throw new Error(
+      `No Beam identity found. Run 'beam init' first.`
+    )
+  }
+  const raw = readFileSync(path, 'utf8')
+  return JSON.parse(raw) as BeamConfig
+}
+
+export function saveConfig(config: BeamConfig, cwd = process.cwd()): void {
+  const dir = getConfigDir(cwd)
+  mkdirSync(dir, { recursive: true })
+  writeFileSync(getConfigPath(cwd), JSON.stringify(config, null, 2), 'utf8')
+}
+
+export const DEFAULT_DIRECTORY_URL = process.env['BEAM_DIRECTORY_URL'] ?? 'https://api.beam.directory'

package/src/index.ts

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import { Command } from 'commander'
+import chalk from 'chalk'
+import { cmdInit } from './commands/init.js'
+import { cmdRegister } from './commands/register.js'
+import { cmdLookup } from './commands/lookup.js'
+import { cmdSearch } from './commands/search.js'
+import { cmdSend } from './commands/send.js'
+
+const program = new Command()
+
+program
+  .name('beam')
+  .description(
+    chalk.bold('Beam Protocol CLI') + '\n' +
+    chalk.dim('SMTP for AI Agents — agent identity, registration & intent routing')
+  )
+  .version('0.1.0')
+
+// ─── beam init ────────────────────────────────────────────────────────────────
+program
+  .command('init')
+  .description('Generate a new Beam identity (writes .beam/identity.json)')
+  .requiredOption('-a, --agent <name>', 'Agent name (e.g. jarvis)')
+  .requiredOption('-o, --org <name>', 'Organisation name (e.g. coppen)')
+  .option('-d, --directory <url>', 'Directory server URL', process.env['BEAM_DIRECTORY_URL'] ?? 'https://api.beam.directory')
+  .option('-f, --force', 'Overwrite existing identity')
+  .action(async (opts: { agent: string; org: string; directory?: string; force?: boolean }) => {
+    await cmdInit(opts)
+  })
+
+// ─── beam register ────────────────────────────────────────────────────────────
+program
+  .command('register')
+  .description('Register this agent with a Beam directory')
+  .option('-n, --display-name <name>', 'Human-readable display name')
+  .option('-c, --capabilities <list>', 'Comma-separated capabilities (e.g. query,answer,write)')
+  .option('-d, --directory <url>', 'Override directory URL')
+  .action(async (opts: { displayName?: string; capabilities?: string; directory?: string }) => {
+    await cmdRegister(opts)
+  })
+
+// ─── beam lookup ──────────────────────────────────────────────────────────────
+program
+  .command('lookup <beamId>')
+  .description('Look up an agent by Beam ID')
+  .option('-d, --directory <url>', 'Override directory URL')
+  .option('--json', 'Output raw JSON')
+  .action(async (beamId: string, opts: { directory?: string; json?: boolean }) => {
+    await cmdLookup(beamId, opts)
+  })
+
+// ─── beam search ──────────────────────────────────────────────────────────────
+program
+  .command('search')
+  .description('Search for agents in the directory')
+  .option('--org <org>', 'Filter by organisation')
+  .option('--capability <cap>', 'Filter by capability')
+  .option('--min-trust <score>', 'Minimum trust score (0.0-1.0)')
+  .option('--limit <n>', 'Max results', '20')
+  .option('-d, --directory <url>', 'Override directory URL')
+  .option('--json', 'Output raw JSON')
+  .action(async (opts: { org?: string; capability?: string; minTrust?: string; limit?: string; directory?: string; json?: boolean }) => {
+    await cmdSearch(opts)
+  })
+
+// ─── beam send ────────────────────────────────────────────────────────────────
+program
+  .command('send <to> <intent> [params]')
+  .description('Send an intent to an agent and print the result')
+  .option('-d, --directory <url>', 'Override directory URL')
+  .option('-t, --timeout <seconds>', 'Timeout in seconds', '10')
+  .option('--json', 'Output raw JSON')
+  .action(async (to: string, intent: string, params: string | undefined, opts: { directory?: string; timeout?: string; json?: boolean }) => {
+    await cmdSend(to, intent, params, opts)
+  })
+
+// ─── Error handling ───────────────────────────────────────────────────────────
+program.configureOutput({
+  writeErr: str => process.stderr.write(chalk.red(str))
+})
+
+program.parse()

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}