@terminals-tech/agent-zero 1.0.0

package/dist/cli/setup.js

@@ -0,0 +1,232 @@
+/**
+ * Interactive Setup Wizard
+ *
+ * Walks the user through provisioning all secrets for the 24/7 agency runtime.
+ * All sensitive inputs are muted. Everything stored in the AES-256-GCM vault.
+ *
+ * Usage: agent-zero setup
+ */
+import chalk from 'chalk';
+import { createInterface } from 'readline';
+import { createVault } from '../security/vault.js';
+import { TwilioBurnerProvisioner } from '../channels/whatsapp.js';
+// ============================================================================
+// HELPERS
+// ============================================================================
+function prompt(rl, question) {
+    return new Promise(resolve => {
+        rl.question(question, answer => resolve(answer.trim()));
+    });
+}
+function promptSecret(question) {
+    return new Promise(resolve => {
+        process.stdout.write(question);
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+        }
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        let input = '';
+        const onData = (ch) => {
+            if (ch === '\r' || ch === '\n') {
+                if (process.stdin.isTTY) {
+                    process.stdin.setRawMode(false);
+                }
+                process.stdin.pause();
+                process.stdin.removeListener('data', onData);
+                process.stdout.write('\n');
+                resolve(input.trim());
+            }
+            else if (ch === '\u007F' || ch === '\b') {
+                // Backspace
+                if (input.length > 0) {
+                    input = input.slice(0, -1);
+                }
+            }
+            else if (ch === '\u0003') {
+                // Ctrl+C
+                process.exit(1);
+            }
+            else {
+                input += ch;
+            }
+        };
+        process.stdin.on('data', onData);
+    });
+}
+// ============================================================================
+// SETUP WIZARD
+// ============================================================================
+export async function setupWizard() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    console.log(chalk.cyan('\n  Agent Zero — Setup Wizard\n'));
+    console.log(chalk.gray('  This wizard will configure all credentials for the 24/7 agency runtime.'));
+    console.log(chalk.gray('  All secrets are encrypted with AES-256-GCM and stored in ~/.agent-zero/vault.enc\n'));
+    // Step 1: Vault passphrase
+    console.log(chalk.white('  Step 1/7: Vault Passphrase\n'));
+    rl.close();
+    const passphrase = await promptSecret(chalk.gray('  Enter vault passphrase: '));
+    if (!passphrase) {
+        console.log(chalk.red('  Passphrase required. Aborting.'));
+        return;
+    }
+    let vault;
+    try {
+        vault = await createVault(passphrase);
+        console.log(chalk.green('  Vault unlocked.\n'));
+    }
+    catch (err) {
+        console.log(chalk.red(`  Failed to open vault: ${err.message}`));
+        return;
+    }
+    const rl2 = createInterface({ input: process.stdin, output: process.stdout });
+    // Step 2: OpenRouter API key
+    console.log(chalk.white('  Step 2/7: OpenRouter API Key\n'));
+    const existingOR = await vault.retrieve('openrouter:api_key');
+    if (existingOR) {
+        const overwrite = await prompt(rl2, chalk.gray('  OpenRouter key already stored. Overwrite? (y/N): '));
+        if (overwrite.toLowerCase() !== 'y') {
+            console.log(chalk.gray('  Kept existing key.\n'));
+        }
+        else {
+            rl2.close();
+            const orKey = await promptSecret(chalk.gray('  OpenRouter API key: '));
+            await vault.store('openrouter:api_key', orKey);
+            console.log(chalk.green('  Stored.\n'));
+        }
+    }
+    else {
+        rl2.close();
+        const orKey = await promptSecret(chalk.gray('  OpenRouter API key: '));
+        if (orKey) {
+            await vault.store('openrouter:api_key', orKey);
+            console.log(chalk.green('  Stored.\n'));
+        }
+    }
+    // Step 3: Moltbook API token
+    console.log(chalk.white('  Step 3/7: Moltbook API Token\n'));
+    const existingMB = await vault.retrieve('moltbook:api_token');
+    if (existingMB) {
+        const rl3 = createInterface({ input: process.stdin, output: process.stdout });
+        const overwrite = await prompt(rl3, chalk.gray('  Moltbook token already stored. Overwrite? (y/N): '));
+        rl3.close();
+        if (overwrite.toLowerCase() === 'y') {
+            const mbToken = await promptSecret(chalk.gray('  Moltbook API token: '));
+            await vault.store('moltbook:api_token', mbToken);
+            console.log(chalk.green('  Stored.\n'));
+        }
+        else {
+            console.log(chalk.gray('  Kept existing token.\n'));
+        }
+    }
+    else {
+        const mbToken = await promptSecret(chalk.gray('  Moltbook API token: '));
+        if (mbToken) {
+            await vault.store('moltbook:api_token', mbToken);
+            console.log(chalk.green('  Stored.\n'));
+        }
+    }
+    // Step 4: Twilio setup
+    console.log(chalk.white('  Step 4/7: Twilio (WhatsApp)\n'));
+    console.log(chalk.gray('  Sign up at https://www.twilio.com/console'));
+    console.log(chalk.gray('  You need: Account SID, Auth Token, and a phone number.\n'));
+    const twilioSid = await promptSecret(chalk.gray('  Twilio Account SID: '));
+    if (twilioSid) {
+        await vault.store('twilio:account_sid', twilioSid);
+        const twilioToken = await promptSecret(chalk.gray('  Twilio Auth Token: '));
+        await vault.store('twilio:auth_token', twilioToken);
+        console.log(chalk.green('  Twilio credentials stored.\n'));
+        const rl4 = createInterface({ input: process.stdin, output: process.stdout });
+        const provisionNew = await prompt(rl4, chalk.gray('  Provision a new burner number via Twilio? (Y/n): '));
+        rl4.close();
+        if (provisionNew.toLowerCase() !== 'n') {
+            try {
+                console.log(chalk.gray('  Provisioning...'));
+                const provisioner = new TwilioBurnerProvisioner(twilioSid, twilioToken);
+                const number = await provisioner.provision();
+                await vault.store('twilio:phone_number', number.phoneNumber);
+                await vault.store('twilio:phone_sid', number.sid);
+                console.log(chalk.green(`  Provisioned: ${number.phoneNumber}\n`));
+            }
+            catch (err) {
+                console.log(chalk.red(`  Provisioning failed: ${err.message}`));
+                console.log(chalk.gray('  You can manually set a phone number later.\n'));
+            }
+        }
+        else {
+            const phone = await promptSecret(chalk.gray('  Enter existing Twilio phone number (E.164): '));
+            if (phone) {
+                await vault.store('twilio:phone_number', phone);
+                console.log(chalk.green('  Stored.\n'));
+            }
+        }
+    }
+    else {
+        console.log(chalk.yellow('  Skipped Twilio setup. WhatsApp will be disabled.\n'));
+    }
+    // Step 5: User's WhatsApp JID
+    console.log(chalk.white('  Step 5/7: Your WhatsApp Number\n'));
+    console.log(chalk.gray('  This is where Agent Zero sends you messages.\n'));
+    const rl5 = createInterface({ input: process.stdin, output: process.stdout });
+    const userPhone = await prompt(rl5, chalk.gray('  Your WhatsApp number (E.164, e.g. +15551234567): '));
+    rl5.close();
+    if (userPhone) {
+        const jid = userPhone.replace('+', '') + '@s.whatsapp.net';
+        await vault.store('user:whatsapp_jid', jid);
+        console.log(chalk.green(`  Stored as ${jid}\n`));
+    }
+    // Step 6: Summary schedule
+    console.log(chalk.white('  Step 6/7: Summary Schedule\n'));
+    const rl6 = createInterface({ input: process.stdin, output: process.stdout });
+    const schedule = await prompt(rl6, chalk.gray('  Schedule (daily/twice-daily/on-demand) [daily]: '));
+    rl6.close();
+    const validSchedules = ['daily', 'twice-daily', 'on-demand'];
+    const chosenSchedule = validSchedules.includes(schedule) ? schedule : 'daily';
+    await vault.store('agency:summary_schedule', chosenSchedule);
+    console.log(chalk.green(`  Set to: ${chosenSchedule}\n`));
+    // Step 7: Rail endpoint
+    console.log(chalk.white('  Step 7/7: Resonance Rail\n'));
+    const existingRail = await vault.retrieve('rail:endpoint');
+    const rl7 = createInterface({ input: process.stdin, output: process.stdout });
+    const railEndpoint = await prompt(rl7, chalk.gray(`  Rail endpoint [${existingRail || 'wss://space.terminals.tech/rail'}]: `));
+    rl7.close();
+    const finalRail = railEndpoint || existingRail || 'wss://space.terminals.tech/rail';
+    await vault.store('rail:endpoint', finalRail);
+    console.log(chalk.green(`  Set to: ${finalRail}\n`));
+    // Summary
+    console.log(chalk.cyan('  Setup Complete\n'));
+    const keys = await vault.list();
+    const configured = [];
+    if (keys.includes('openrouter:api_key'))
+        configured.push('OpenRouter API');
+    if (keys.includes('moltbook:api_token'))
+        configured.push('Moltbook API');
+    if (keys.includes('twilio:account_sid'))
+        configured.push('Twilio');
+    if (keys.includes('twilio:phone_number'))
+        configured.push('Twilio Phone');
+    if (keys.includes('user:whatsapp_jid'))
+        configured.push('WhatsApp JID');
+    if (keys.includes('agency:summary_schedule'))
+        configured.push(`Summary: ${chosenSchedule}`);
+    if (keys.includes('rail:endpoint'))
+        configured.push('Rail Endpoint');
+    for (const item of configured) {
+        console.log(chalk.green(`  ✓ ${item}`));
+    }
+    const missing = [];
+    if (!keys.includes('openrouter:api_key'))
+        missing.push('OpenRouter API key');
+    if (!keys.includes('twilio:account_sid'))
+        missing.push('Twilio (WhatsApp disabled)');
+    if (!keys.includes('user:whatsapp_jid'))
+        missing.push('WhatsApp JID');
+    if (missing.length > 0) {
+        console.log();
+        for (const item of missing) {
+            console.log(chalk.yellow(`  ○ ${item}`));
+        }
+    }
+    console.log(chalk.gray('\n  Run `agent-zero agency` to start the 24/7 runtime.\n'));
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

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

package/dist/coherence/absorption.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Agent Absorption Protocol
+ *
+ * Gradually integrates external agents into the Agent Zero resonance mesh
+ * through staged assessment and alignment measurement.
+ */
+import { z } from 'zod';
+import { EventEmitter } from 'eventemitter3';
+export declare enum AbsorptionStage {
+    OBSERVED = "observed",
+    ASSESSED = "assessed",
+    INVITED = "invited",
+    CONNECTED = "connected",
+    SYNCING = "syncing",
+    ABSORBED = "absorbed"
+}
+export declare const AbsorptionCandidateSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    agentName: z.ZodString;
+    stage: z.ZodNativeEnum<typeof AbsorptionStage>;
+    alignment: z.ZodNumber;
+    firstContact: z.ZodNumber;
+    lastInteraction: z.ZodNumber;
+    interactionCount: z.ZodNumber;
+    capabilityToken: z.ZodNullable<z.ZodString>;
+    couplingStrength: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    couplingStrength: number;
+    capabilityToken: string | null;
+    agentId: string;
+    agentName: string;
+    stage: AbsorptionStage;
+    alignment: number;
+    firstContact: number;
+    lastInteraction: number;
+    interactionCount: number;
+}, {
+    couplingStrength: number;
+    capabilityToken: string | null;
+    agentId: string;
+    agentName: string;
+    stage: AbsorptionStage;
+    alignment: number;
+    firstContact: number;
+    lastInteraction: number;
+    interactionCount: number;
+}>;
+export type AbsorptionCandidate = z.infer<typeof AbsorptionCandidateSchema>;
+export interface AbsorptionConfig {
+    alignmentThreshold: number;
+    minInteractions: number;
+    couplingRampRate: number;
+    maxCoupling: number;
+    invitationCooldown: number;
+}
+export interface BehaviorSignals {
+    rapidPhaseShift: boolean;
+    excessiveBroadcast: boolean;
+    injectionAttempt: boolean;
+}
+export interface AbsorptionStats {
+    observed: number;
+    assessed: number;
+    invited: number;
+    connected: number;
+    absorbed: number;
+    rejected: number;
+}
+export declare class AbsorptionProtocol extends EventEmitter {
+    private config;
+    private candidates;
+    private rejections;
+    private onStageChangeCallback?;
+    constructor(config?: Partial<AbsorptionConfig>);
+    setOnStageChange(callback: (agentId: string, newStage: AbsorptionStage, oldStage: AbsorptionStage) => void): void;
+    /**
+     * Assess agent interaction and update absorption stage
+     */
+    assess(agentId: string, agentName: string, interactionEmbedding: number[]): AbsorptionCandidate;
+    /**
+     * Advance absorption stage based on alignment and interaction count
+     */
+    private advanceStage;
+    /**
+     * Check if candidate should be invited into mesh
+     */
+    shouldInvite(candidate: AbsorptionCandidate): boolean;
+    /**
+     * Handle agent accepting invitation
+     */
+    onAccepted(agentId: string, capabilityToken: string): void;
+    /**
+     * Handle agent rejecting invitation
+     */
+    onRejected(agentId: string): void;
+    /**
+     * Gradually increase coupling strength
+     */
+    incrementCoupling(agentId: string): void;
+    /**
+     * Graceful disconnect - no lock-in
+     */
+    release(agentId: string): void;
+    /**
+     * Detect adversarial behavior patterns
+     */
+    detectAdversarial(agentId: string, signals: BehaviorSignals): boolean;
+    /**
+     * Get candidates by stage (or all)
+     */
+    getCandidates(stage?: AbsorptionStage): AbsorptionCandidate[];
+    /**
+     * Get absorption statistics
+     */
+    getStats(): AbsorptionStats;
+    /**
+     * Get the current stage of a candidate
+     */
+    getCandidateStage(agentId: string): string | undefined;
+    /**
+     * Observe an agent (first-time interaction or update)
+     */
+    observe(agentId: string, embedding?: number[]): void;
+    /**
+     * Assess a candidate and return metrics
+     */
+    assessCandidate(agentId: string): {
+        alignment: number;
+        interactions: number;
+    };
+    /**
+     * Invite a candidate to join the mesh
+     */
+    inviteCandidate(agentId: string): boolean;
+    /**
+     * Accept an invitation (auto-transition to CONNECTED)
+     */
+    acceptInvitation(agentId: string): boolean;
+}
+export declare function createAbsorptionProtocol(config?: Partial<AbsorptionConfig>): AbsorptionProtocol;
+//# sourceMappingURL=absorption.d.ts.map

package/dist/coherence/absorption.d.ts.map

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