@zengxingyuan/aamp-cli-bridge 0.1.7-dev.1

package/dist/config.js

@@ -0,0 +1,95 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { z } from 'zod';
+export const cliProfileDefinitionSchema = z.object({
+    name: z.string().min(1).optional(),
+    description: z.string().optional(),
+    command: z.string().min(1),
+    args: z.array(z.string()).optional(),
+    stdin: z.string().optional(),
+    env: z.record(z.string()).optional(),
+    cwd: z.string().optional(),
+    shell: z.boolean().optional(),
+    timeoutMs: z.number().int().positive().optional(),
+    successExitCodes: z.array(z.number().int()).optional(),
+    stream: z.object({
+        format: z.enum(['sse', 'ndjson']),
+        enabled: z.boolean().optional(),
+    }).optional(),
+    output: z.object({
+        includeStderr: z.boolean().optional(),
+        stripAnsi: z.boolean().optional(),
+        trim: z.boolean().optional(),
+    }).optional(),
+});
+const senderPolicySchema = z.object({
+    sender: z.string().email(),
+    dispatchContextRules: z.record(z.array(z.string().min(1))).optional(),
+});
+const agentConfigSchema = z.object({
+    name: z.string().min(1),
+    cliProfile: z.union([z.string().min(1), cliProfileDefinitionSchema]),
+    slug: z.string().regex(/^[a-z0-9-]+$/).optional(),
+    description: z.string().optional(),
+    summary: z.string().optional(),
+    cardText: z.string().optional(),
+    cardFile: z.string().optional(),
+    credentialsFile: z.string().optional(),
+    pairingFile: z.string().optional(),
+    senderPoliciesFile: z.string().optional(),
+    senderWhitelist: z.array(z.string().email()).optional(),
+    senderPolicies: z.array(senderPolicySchema).optional(),
+    taskDispatchConcurrency: z.number().int().positive().optional(),
+});
+const bridgeConfigSchema = z.object({
+    aampHost: z.string().url(),
+    rejectUnauthorized: z.boolean().default(false),
+    profiles: z.record(cliProfileDefinitionSchema).optional(),
+    agents: z.array(agentConfigSchema).min(1),
+});
+function normalizeSenderPolicies(senderPolicies, senderWhitelist) {
+    const sourcePolicies = senderPolicies?.length
+        ? senderPolicies
+        : senderWhitelist?.length
+            ? senderWhitelist.map((sender) => ({ sender }))
+            : undefined;
+    if (!sourcePolicies?.length)
+        return undefined;
+    const normalized = sourcePolicies
+        .map((policy) => {
+        let dispatchContextRules;
+        if (policy.dispatchContextRules) {
+            dispatchContextRules = Object.fromEntries(Object.entries(policy.dispatchContextRules)
+                .map(([key, values]) => [
+                key.trim().toLowerCase(),
+                values.map((value) => value.trim()).filter(Boolean),
+            ])
+                .filter(([key, values]) => Boolean(key) && values.length > 0));
+        }
+        return {
+            sender: policy.sender.trim().toLowerCase(),
+            ...(dispatchContextRules && Object.keys(dispatchContextRules).length > 0
+                ? { dispatchContextRules }
+                : {}),
+        };
+    })
+        .filter((policy) => Boolean(policy.sender));
+    return normalized.length > 0 ? normalized : undefined;
+}
+function normalizeAgentConfig(agent) {
+    return {
+        ...agent,
+        senderPolicies: normalizeSenderPolicies(agent.senderPolicies, agent.senderWhitelist),
+    };
+}
+export function loadConfig(path) {
+    if (!existsSync(path)) {
+        throw new Error(`Config file not found: ${path}. Run 'aamp-cli-bridge init' first.`);
+    }
+    const raw = JSON.parse(readFileSync(path, 'utf-8'));
+    const parsed = bridgeConfigSchema.parse(raw);
+    return {
+        ...parsed,
+        agents: parsed.agents.map(normalizeAgentConfig),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { AampClient } from 'aamp-sdk';
+import { AampCliBridge } from './bridge.js';
+import { BUILTIN_CLI_PROFILES, getBuiltinCliProfileNames } from './cli-profiles.js';
+import { renderPairingCode, runInit } from './cli/init.js';
+import { runProfileMaker } from './cli/profile-maker.js';
+import { loadConfig } from './config.js';
+import { resolvePairingFile } from './pairing.js';
+import { getDefaultProfilesDir, resolveConfigPath, resolveCredentialsFile } from './storage.js';
+const args = process.argv.slice(2);
+const command = args[0] ?? 'start';
+const configPath = resolveConfigPath(args.includes('--config') ? (args[args.indexOf('--config') + 1] ?? '') : undefined);
+function getOptionValue(flag) {
+    const idx = args.indexOf(flag);
+    return idx >= 0 ? args[idx + 1] : undefined;
+}
+function getAgent(config, agentName) {
+    const agent = config.agents.find((item) => item.name === agentName);
+    if (!agent) {
+        throw new Error(`Agent "${agentName}" not found in config`);
+    }
+    return agent;
+}
+function getConnectionSetupOption() {
+    const value = getOptionValue('--connection-setup');
+    if (!value)
+        return undefined;
+    if (value === 'pairing-code'
+        || value === 'manual-sender-policy'
+        || value === 'reuse-sender-policy'
+        || value === 'later') {
+        return value;
+    }
+    throw new Error('--connection-setup must be one of pairing-code, manual-sender-policy, reuse-sender-policy, later');
+}
+function loadAgentCredentials(agent) {
+    const credFile = resolveCredentialsFile(agent.credentialsFile, agent.name);
+    const creds = JSON.parse(readFileSync(credFile, 'utf-8'));
+    if (!creds.email || !creds.smtpPassword) {
+        throw new Error(`Credentials file is incomplete: ${credFile}`);
+    }
+    return {
+        email: creds.email,
+        smtpPassword: creds.smtpPassword,
+    };
+}
+function createDirectoryClient(configPathValue, agentName) {
+    const config = loadConfig(configPathValue);
+    const agent = config.agents.find((item) => item.name === agentName);
+    if (!agent) {
+        throw new Error(`Agent "${agentName}" not found in ${configPathValue}`);
+    }
+    const creds = loadAgentCredentials(agent);
+    return AampClient.fromMailboxIdentity({
+        email: creds.email,
+        smtpPassword: creds.smtpPassword,
+        baseUrl: config.aampHost,
+        rejectUnauthorized: config.rejectUnauthorized,
+    });
+}
+function renderPairingForAgent(configPathValue, agentName) {
+    const config = loadConfig(configPathValue);
+    const agent = getAgent(config, agentName);
+    const creds = loadAgentCredentials(agent);
+    renderPairingCode(agent.name, creds.email, resolvePairingFile(agent.pairingFile, agent.name));
+}
+async function startBridge(configPathValue, options = {}) {
+    const config = loadConfig(configPathValue);
+    const agents = options.agent ? [getAgent(config, options.agent)] : config.agents;
+    const bridge = new AampCliBridge({
+        ...config,
+        agents,
+    });
+    const shutdown = () => {
+        console.log('\nShutting down...');
+        bridge.stop();
+        process.exit(0);
+    };
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+    await bridge.start({ quiet: options.quiet });
+    setInterval(() => { }, 60_000);
+}
+async function main() {
+    switch (command) {
+        case 'init': {
+            const initialized = await runInit(configPath, {
+                agent: getOptionValue('--agent'),
+                aampHost: getOptionValue('--aamp-host'),
+                connectionSetup: getConnectionSetupOption(),
+            });
+            if (!initialized)
+                break;
+            if (args.includes('--no-start')) {
+                console.log(`CLI bridge not started because --no-start was provided.`);
+                console.log(`Run: npx aamp-cli-bridge start\n`);
+                break;
+            }
+            await startBridge(configPath, { quiet: true, agent: getOptionValue('--agent') });
+            break;
+        }
+        case 'start': {
+            await startBridge(configPath);
+            break;
+        }
+        case 'pair': {
+            const agentName = getOptionValue('--agent');
+            if (!agentName)
+                throw new Error('Missing required --agent');
+            renderPairingForAgent(configPath, agentName);
+            if (args.includes('--no-start'))
+                break;
+            await startBridge(configPath, { quiet: true, agent: agentName });
+            break;
+        }
+        case 'list': {
+            const config = loadConfig(configPath);
+            console.log(`\nConfigured CLI agents (${config.agents.length}):`);
+            for (const agent of config.agents) {
+                const credFile = resolveCredentialsFile(agent.credentialsFile, agent.name);
+                let email = '(not registered)';
+                try {
+                    const creds = JSON.parse(readFileSync(credFile, 'utf-8'));
+                    email = creds.email ?? email;
+                }
+                catch { /* no credentials yet */ }
+                const profile = typeof agent.cliProfile === 'string'
+                    ? agent.cliProfile
+                    : (agent.cliProfile.name ?? 'inline');
+                console.log(`  ${agent.name}: ${email} (profile:${profile})`);
+            }
+            console.log();
+            break;
+        }
+        case 'status': {
+            const config = loadConfig(configPath);
+            const bridge = new AampCliBridge(config);
+            await bridge.start();
+            bridge.list();
+            bridge.stop();
+            break;
+        }
+        case 'profile-list': {
+            console.log('\nBuilt-in CLI profiles:');
+            for (const name of getBuiltinCliProfileNames()) {
+                const profile = BUILTIN_CLI_PROFILES[name];
+                console.log(`  ${name}: ${profile.description ?? profile.command}`);
+            }
+            const profilesDir = getDefaultProfilesDir();
+            console.log(`\nUser CLI profiles (${profilesDir}):`);
+            if (!existsSync(profilesDir)) {
+                console.log('  (none)');
+            }
+            else {
+                const names = readdirSync(profilesDir)
+                    .filter((item) => item.endsWith('.json'))
+                    .map((item) => item.replace(/\.json$/, ''))
+                    .sort();
+                if (names.length === 0) {
+                    console.log('  (none)');
+                }
+                else {
+                    for (const name of names)
+                        console.log(`  ${name}`);
+                }
+            }
+            console.log();
+            break;
+        }
+        case 'profile-maker': {
+            await runProfileMaker();
+            break;
+        }
+        case 'directory-list': {
+            const agentName = getOptionValue('--agent');
+            if (!agentName)
+                throw new Error('Missing required --agent');
+            const client = createDirectoryClient(configPath, agentName);
+            const agents = await client.listDirectory({
+                includeSelf: args.includes('--include-self'),
+                limit: getOptionValue('--limit') ? Number(getOptionValue('--limit')) : undefined,
+            });
+            console.log(JSON.stringify({ agents }, null, 2));
+            break;
+        }
+        case 'directory-search': {
+            const agentName = getOptionValue('--agent');
+            const query = getOptionValue('--query');
+            if (!agentName)
+                throw new Error('Missing required --agent');
+            if (!query)
+                throw new Error('Missing required --query');
+            const client = createDirectoryClient(configPath, agentName);
+            const agents = await client.searchDirectory({
+                query,
+                includeSelf: args.includes('--include-self'),
+                limit: getOptionValue('--limit') ? Number(getOptionValue('--limit')) : undefined,
+            });
+            console.log(JSON.stringify({ agents }, null, 2));
+            break;
+        }
+        case 'directory-update': {
+            const agentName = getOptionValue('--agent');
+            if (!agentName)
+                throw new Error('Missing required --agent');
+            const summary = getOptionValue('--summary');
+            const cardText = getOptionValue('--card-text');
+            const cardFile = getOptionValue('--card-file');
+            const resolvedCardText = cardText ?? (cardFile ? readFileSync(cardFile, 'utf-8') : undefined);
+            if (!summary && !resolvedCardText) {
+                throw new Error('Provide at least one of --summary, --card-text, or --card-file');
+            }
+            const client = createDirectoryClient(configPath, agentName);
+            const profile = await client.updateDirectoryProfile({
+                ...(summary ? { summary } : {}),
+                ...(resolvedCardText ? { cardText: resolvedCardText } : {}),
+            });
+            console.log(JSON.stringify({ profile }, null, 2));
+            break;
+        }
+        case 'help':
+        default:
+            console.log(`
+AAMP CLI Bridge -- Connect direct CLI agents to the AAMP email network
+
+Usage:
+  aamp-cli-bridge init [--agent NAME] [--aamp-host URL] [--connection-setup METHOD] [--no-start]    Setup wizard, then start bridge
+  aamp-cli-bridge start [--config X]   Start the bridge (default: ~/.aamp/cli-bridge/config.json)
+  aamp-cli-bridge pair --agent NAME [--config X] [--no-start]  Show a pairing QR code, then start that agent
+  aamp-cli-bridge list  [--config X]   List configured agents
+  aamp-cli-bridge status               Show live connection status
+  aamp-cli-bridge profile-list         List built-in and user CLI profiles
+  aamp-cli-bridge profile-maker        Interactive profile maker for custom CLI agents
+  aamp-cli-bridge directory-list --agent NAME [--config X] [--include-self] [--limit N]
+  aamp-cli-bridge directory-search --agent NAME --query TEXT [--config X] [--include-self] [--limit N]
+  aamp-cli-bridge directory-update --agent NAME [--config X] [--summary TEXT] [--card-text TEXT] [--card-file PATH]
+  aamp-cli-bridge help                 Show this help
+
+Examples:
+  npx aamp-cli-bridge profile-maker
+  npx aamp-cli-bridge init
+  npx aamp-cli-bridge init --agent codem --aamp-host https://meshmail.ai --connection-setup pairing-code
+  npx aamp-cli-bridge init --no-start
+  npx aamp-cli-bridge pair --agent codex
+  npx aamp-cli-bridge start
+  npx aamp-cli-bridge start --config production.json
+`);
+            break;
+    }
+}
+main().catch((err) => {
+    console.error(`Error: ${err.message}`);
+    process.exit(1);
+});
+//# 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/dist/pairing.d.ts

@@ -0,0 +1,39 @@
+export interface DispatchContextRules {
+    [key: string]: string[];
+}
+export interface SenderPolicy {
+    sender: string;
+    dispatchContextRules: DispatchContextRules;
+    pairedAt: string;
+}
+export interface PairingCodeState {
+    mailbox: string;
+    pairCode: string;
+    expiresAt: string;
+    connectUrl: string;
+    consumedAt?: string;
+}
+export declare const DEFAULT_PAIRING_WEB_URL = "https://meshmail.ai/pair";
+export declare function defaultPairingFile(name: string): string;
+export declare function defaultSenderPoliciesFile(name: string): string;
+export declare function resolvePairingFile(pathValue: string | undefined, name: string): string;
+export declare function resolveSenderPoliciesFile(pathValue: string | undefined, name: string): string;
+export declare function createPairingCode(params: {
+    mailbox: string;
+    file: string;
+    ttlSeconds?: number;
+}): PairingCodeState;
+export declare function pairingUrlToWebUrl(connectUrl: string): string;
+export declare function consumePairingCode(params: {
+    file: string;
+    mailbox: string;
+    pairCode: string;
+}): PairingCodeState | null;
+export declare function validatePairingCode(params: {
+    file: string;
+    mailbox: string;
+    pairCode: string;
+}): PairingCodeState | null;
+export declare function loadSenderPolicies(file: string): SenderPolicy[];
+export declare function addSenderPolicy(file: string, policy: SenderPolicy): SenderPolicy[];
+export declare function rulesMatch(rules: DispatchContextRules, dispatchContext?: Record<string, string>): boolean;

package/dist/pairing.js

@@ -0,0 +1,110 @@
+import { randomBytes } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { getBridgeHomeDir } from './storage.js';
+export const DEFAULT_PAIRING_WEB_URL = 'https://meshmail.ai/pair';
+function expandHome(pathValue) {
+    if (pathValue === '~')
+        return homedir();
+    if (pathValue.startsWith('~/'))
+        return join(homedir(), pathValue.slice(2));
+    return pathValue;
+}
+export function defaultPairingFile(name) {
+    return join(getBridgeHomeDir(), 'pairing', `${name}.json`);
+}
+export function defaultSenderPoliciesFile(name) {
+    return join(getBridgeHomeDir(), 'sender-policies', `${name}.json`);
+}
+export function resolvePairingFile(pathValue, name) {
+    return expandHome(pathValue?.trim() || defaultPairingFile(name));
+}
+export function resolveSenderPoliciesFile(pathValue, name) {
+    return expandHome(pathValue?.trim() || defaultSenderPoliciesFile(name));
+}
+export function createPairingCode(params) {
+    const mailbox = params.mailbox.trim().toLowerCase();
+    const pairCode = randomBytes(6).toString('base64url');
+    const expiresAt = new Date(Date.now() + (params.ttlSeconds ?? 300) * 1000).toISOString();
+    const connectUrl = `aamp://connect?mailbox=${encodeURIComponent(mailbox)}&pair_code=${encodeURIComponent(pairCode)}`;
+    const state = {
+        mailbox,
+        pairCode,
+        expiresAt,
+        connectUrl,
+    };
+    mkdirSync(dirname(params.file), { recursive: true });
+    writeFileSync(params.file, JSON.stringify(state, null, 2));
+    return state;
+}
+export function pairingUrlToWebUrl(connectUrl) {
+    const parsed = new URL(connectUrl);
+    const url = new URL(DEFAULT_PAIRING_WEB_URL);
+    for (const [key, value] of parsed.searchParams) {
+        url.searchParams.set(key, value);
+    }
+    return url.toString();
+}
+export function consumePairingCode(params) {
+    const state = validatePairingCode(params);
+    if (!state)
+        return null;
+    writeFileSync(params.file, JSON.stringify({ ...state, pairCode: '', consumedAt: new Date().toISOString() }, null, 2));
+    return state;
+}
+export function validatePairingCode(params) {
+    if (!existsSync(params.file))
+        return null;
+    const state = JSON.parse(readFileSync(params.file, 'utf-8'));
+    if (state.mailbox.toLowerCase() !== params.mailbox.toLowerCase())
+        return null;
+    if (state.pairCode !== params.pairCode)
+        return null;
+    if (state.consumedAt)
+        return null;
+    if (new Date(state.expiresAt).getTime() <= Date.now())
+        return null;
+    return state;
+}
+export function loadSenderPolicies(file) {
+    if (!existsSync(file))
+        return [];
+    try {
+        const data = JSON.parse(readFileSync(file, 'utf-8'));
+        return Array.isArray(data) ? data.filter(isSenderPolicy) : [];
+    }
+    catch {
+        return [];
+    }
+}
+export function addSenderPolicy(file, policy) {
+    const policies = loadSenderPolicies(file);
+    const normalizedSender = policy.sender.toLowerCase();
+    const next = [
+        ...policies.filter((item) => item.sender.toLowerCase() !== normalizedSender),
+        { ...policy, sender: normalizedSender },
+    ];
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, JSON.stringify(next, null, 2));
+    return next;
+}
+function isSenderPolicy(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const policy = value;
+    return typeof policy.sender === 'string'
+        && typeof policy.dispatchContextRules === 'object'
+        && typeof policy.pairedAt === 'string';
+}
+export function rulesMatch(rules, dispatchContext) {
+    for (const [key, allowedValues] of Object.entries(rules)) {
+        if (!Array.isArray(allowedValues) || allowedValues.length === 0)
+            continue;
+        const observed = dispatchContext?.[key];
+        if (!observed || !allowedValues.includes(observed))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=pairing.js.map

package/dist/pairing.js.map

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

package/dist/prompt-builder.d.ts

@@ -0,0 +1,15 @@
+import type { StructuredResultField, TaskDispatch } from 'aamp-sdk';
+export interface ResultAttachmentRef {
+    path: string;
+    filename?: string;
+    contentType?: string;
+}
+export declare function buildPrompt(task: TaskDispatch, threadContextText?: string, agentName?: string): string;
+export declare function parseResponse(output: string): {
+    isHelp: boolean;
+    question?: string;
+    output: string;
+    files: string[];
+    structuredResult?: StructuredResultField[];
+    attachments?: ResultAttachmentRef[];
+};