@elizaos/core 2.0.0-alpha.21 → 2.0.0-alpha.22

package/dist/services/onboarding-state.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Onboarding State Machine
+ *
+ * A unified state machine for onboarding that can be driven by CLI prompts
+ * OR chat messages. Handles step transitions, validation, and persistence.
+ */
+import { type OnboardingContext, type OnboardingInput, type OnboardingProgress, type OnboardingResult, type OnboardingSettings, OnboardingStep, type OnboardingStepError, type SerializedOnboardingState } from "../types/onboarding";
+import type { UUID } from "../types/primitives";
+/**
+ * Step handler function type.
+ */
+type StepHandler<T> = (data: T, context: OnboardingContext) => Promise<OnboardingResult>;
+/**
+ * Configuration options for the state machine.
+ */
+export interface OnboardingStateMachineConfig {
+    /** Platform identifier (cli, discord, telegram, etc.) */
+    platform: string;
+    /** Onboarding mode */
+    mode: "cli" | "conversational" | "wizard";
+    /** World ID for persistence */
+    worldId?: UUID;
+    /** User ID being onboarded */
+    userId?: UUID;
+    /** Optional existing context to restore from */
+    existingContext?: OnboardingContext;
+    /** Callback when step changes */
+    onStepChange?: (oldStep: OnboardingStep, newStep: OnboardingStep, context: OnboardingContext) => void | Promise<void>;
+    /** Callback when onboarding completes */
+    onComplete?: (context: OnboardingContext) => void | Promise<void>;
+    /** Callback when an error occurs */
+    onError?: (error: OnboardingStepError, context: OnboardingContext) => void;
+}
+/**
+ * Unified Onboarding State Machine.
+ *
+ * Manages the onboarding flow across CLI and conversational interfaces.
+ * Supports step progression, validation, persistence, and event callbacks.
+ *
+ * @example
+ * ```typescript
+ * const machine = new OnboardingStateMachine({
+ *   platform: 'cli',
+ *   mode: 'cli',
+ *   onComplete: (ctx) => console.log('Onboarding complete!')
+ * });
+ *
+ * // Advance through steps
+ * await machine.advanceStep({ step: OnboardingStep.WELCOME, data: { acknowledged: true } });
+ * await machine.advanceStep({ step: OnboardingStep.RISK_ACK, data: { accepted: true } });
+ * // ...
+ * ```
+ */
+export declare class OnboardingStateMachine {
+    private context;
+    private config;
+    private stepHandlers;
+    constructor(config: OnboardingStateMachineConfig);
+    /**
+     * Create the initial context for a new onboarding session.
+     */
+    private createInitialContext;
+    /**
+     * Register the default step handlers.
+     */
+    private registerDefaultHandlers;
+    /**
+     * Get the current onboarding step.
+     */
+    getCurrentStep(): OnboardingStep;
+    /**
+     * Get the full onboarding context.
+     */
+    getContext(): OnboardingContext;
+    /**
+     * Get the current settings.
+     */
+    getSettings(): OnboardingSettings;
+    /**
+     * Check if we can advance from the current step.
+     */
+    canAdvance(): boolean;
+    /**
+     * Get the completion progress.
+     */
+    getProgress(): OnboardingProgress;
+    /**
+     * Process input and advance to the next step.
+     */
+    advanceStep(input: OnboardingInput): Promise<OnboardingResult>;
+    /**
+     * Skip the current step (if allowed).
+     */
+    skipStep(): Promise<OnboardingResult>;
+    /**
+     * Go back to a previous step.
+     */
+    goBack(targetStep?: OnboardingStep): OnboardingResult;
+    /**
+     * Serialize the current state for persistence.
+     */
+    toJSON(): SerializedOnboardingState;
+    /**
+     * Restore state from a serialized representation.
+     */
+    static fromJSON(serialized: SerializedOnboardingState, config: Omit<OnboardingStateMachineConfig, "existingContext">): OnboardingStateMachine;
+    /**
+     * Reset the state machine to the beginning.
+     */
+    reset(): void;
+    /**
+     * Register a custom handler for a step.
+     */
+    registerHandler<T>(step: OnboardingStep, handler: StepHandler<T>): void;
+    /**
+     * Handle the WELCOME step.
+     */
+    private handleWelcome;
+    /**
+     * Handle the RISK_ACK step.
+     */
+    private handleRiskAck;
+    /**
+     * Handle the AUTH step.
+     */
+    private handleAuth;
+    /**
+     * Validate auth input.
+     */
+    private validateAuthInput;
+    /**
+     * Handle the CHANNELS step.
+     */
+    private handleChannels;
+    /**
+     * Handle the SKILLS step.
+     */
+    private handleSkills;
+}
+/**
+ * Create a new onboarding state machine with default configuration.
+ */
+export declare function createOnboardingStateMachine(config: Partial<OnboardingStateMachineConfig> & {
+    platform: string;
+}): OnboardingStateMachine;
+/**
+ * Check if an onboarding context is complete.
+ */
+export declare function isOnboardingComplete(context: OnboardingContext): boolean;
+/**
+ * Get a summary of the onboarding context for display.
+ */
+export declare function getOnboardingSummary(context: OnboardingContext): string;
+export {};
+//# sourceMappingURL=onboarding-state.d.ts.map

package/dist/services/onboarding-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-state.d.ts","sourceRoot":"","sources":["../../src/services/onboarding-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EASN,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,cAAc,EACd,KAAK,mBAAmB,EAExB,KAAK,yBAAyB,EAG9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAKhD;;GAEG;AACH,KAAK,WAAW,CAAC,CAAC,IAAI,CACrB,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,iBAAiB,KACtB,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAW/B;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC5C,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,IAAI,EAAE,KAAK,GAAG,gBAAgB,GAAG,QAAQ,CAAC;IAC1C,+BAA+B;IAC/B,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,8BAA8B;IAC9B,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,gDAAgD;IAChD,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,iCAAiC;IACjC,YAAY,CAAC,EAAE,CACd,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,iBAAiB,KACtB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,yCAAyC;IACzC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,oCAAoC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,sBAAsB;IAClC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,YAAY,CAA4C;gBAEpD,MAAM,EAAE,4BAA4B;IAgBhD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuB/B;;OAEG;IACH,cAAc,IAAI,cAAc;IAIhC;;OAEG;IACH,UAAU,IAAI,iBAAiB;IAI/B;;OAEG;IACH,WAAW,IAAI,kBAAkB;IAIjC;;OAEG;IACH,UAAU,IAAI,OAAO;IAoBrB;;OAEG;IACH,WAAW,IAAI,kBAAkB;IAsCjC;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmIpE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAoE3C;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,cAAc,GAAG,gBAAgB;IAqErD;;OAEG;IACH,MAAM,IAAI,yBAAyB;IAOnC;;OAEG;IACH,MAAM,CAAC,QAAQ,CACd,UAAU,EAAE,yBAAyB,EACrC,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,iBAAiB,CAAC,GAC3D,sBAAsB;IAiBzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAQvE;;OAEG;YACW,aAAa;IAmC3B;;OAEG;YACW,aAAa;IAkC3B;;OAEG;YACW,UAAU;IA2DxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuCzB;;OAEG;YACW,cAAc;IAuD5B;;OAEG;YACW,YAAY;CA+C1B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,OAAO,CAAC,4BAA4B,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClE,sBAAsB,CAKxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAExE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAyBvE"}

package/dist/services/pairing-integration.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Pairing Integration Helpers
+ *
+ * Utility functions for integrating the PairingService with channel plugins.
+ * This provides a consistent interface for handling the pairing workflow
+ * across different messaging platforms.
+ */
+import type { IAgentRuntime } from "../types";
+import type { PairingChannel } from "../types/pairing";
+import type { PairingService } from "./pairing";
+/**
+ * Result of a pairing check
+ */
+export interface PairingCheckResult {
+    /** Whether the sender is allowed to proceed */
+    allowed: boolean;
+    /** If not allowed, the pairing code (if a new request was created) */
+    pairingCode?: string;
+    /** Whether a new pairing request was created */
+    newRequest?: boolean;
+    /** Human-readable message to send to the user */
+    replyMessage?: string;
+    /** The ID label for this channel (e.g., "phoneNumber", "userId") */
+    idLabel?: string;
+}
+/**
+ * Parameters for checking pairing
+ */
+export interface PairingCheckParams {
+    /** The messaging channel (telegram, discord, whatsapp, etc.) */
+    channel: PairingChannel;
+    /** User identifier on the channel */
+    senderId: string;
+    /** Optional metadata about the requester (e.g., name, username) */
+    metadata?: Record<string, string>;
+    /** Whether to suppress sending a pairing reply (e.g., for historical messages) */
+    suppressReply?: boolean;
+}
+/**
+ * Get the PairingService from the runtime, or null if not available.
+ */
+export declare function getPairingService(runtime: IAgentRuntime): PairingService | null;
+/**
+ * Check if a sender is allowed based on the pairing policy.
+ *
+ * This function implements the core pairing workflow:
+ * 1. Check if the sender is already in the allowlist -> allowed
+ * 2. If not, create or update a pairing request
+ * 3. Return the pairing code and reply message
+ *
+ * @example
+ * ```typescript
+ * const result = await checkPairingAllowed(runtime, {
+ *   channel: "whatsapp",
+ *   senderId: "+14155551234",
+ *   metadata: { name: "John Doe" },
+ * });
+ *
+ * if (!result.allowed) {
+ *   if (result.replyMessage) {
+ *     await sendMessage(result.replyMessage);
+ *   }
+ *   return; // Block the message
+ * }
+ * // Process the message...
+ * ```
+ */
+export declare function checkPairingAllowed(runtime: IAgentRuntime, params: PairingCheckParams): Promise<PairingCheckResult>;
+/**
+ * Build the pairing reply message sent to unauthorized users.
+ */
+export declare function buildPairingReplyMessage(params: {
+    channel: PairingChannel;
+    senderId: string;
+    code: string;
+    idLabel?: string;
+}): string;
+/**
+ * Directly add a sender to the allowlist (bypass pairing).
+ * Useful for CLI commands or admin actions.
+ */
+export declare function addToAllowlist(runtime: IAgentRuntime, channel: PairingChannel, senderId: string, metadata?: Record<string, string>): Promise<boolean>;
+/**
+ * Remove a sender from the allowlist.
+ */
+export declare function removeFromAllowlist(runtime: IAgentRuntime, channel: PairingChannel, senderId: string): Promise<boolean>;
+/**
+ * Check if a sender is in the allowlist.
+ */
+export declare function isInAllowlist(runtime: IAgentRuntime, channel: PairingChannel, senderId: string): Promise<boolean>;
+/**
+ * Approve a pairing code and add the sender to the allowlist.
+ * Returns the approved sender ID or null if the code was not found.
+ */
+export declare function approvePairingCode(runtime: IAgentRuntime, channel: PairingChannel, code: string): Promise<string | null>;
+//# sourceMappingURL=pairing-integration.d.ts.map

package/dist/services/pairing-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing-integration.d.ts","sourceRoot":"","sources":["../../src/services/pairing-integration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,gEAAgE;IAChE,OAAO,EAAE,cAAc,CAAC;IACxB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,aAAa,GACpB,cAAc,GAAG,IAAI,CAMvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,kBAAkB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA8C7B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAeT;AAED;;;GAGG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAClC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB"}

package/dist/services/pairing-migration.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Pairing Migration Utility
+ *
+ * Migrates data from the file-based pairing store (otto)
+ * to the database-backed PairingService.
+ *
+ * This utility reads the JSON files used by otto's pairing system
+ * and imports the data into the elizaOS database.
+ */
+import type { IAgentRuntime } from "../types";
+import type { PairingChannel } from "../types/pairing";
+/**
+ * File-based pairing request format from otto.
+ */
+interface FilePairingRequest {
+    id: string;
+    code: string;
+    createdAt: string;
+    lastSeenAt: string;
+    meta?: Record<string, string>;
+}
+/**
+ * File-based pairing store format from otto.
+ */
+interface FilePairingStore {
+    version: number;
+    requests: FilePairingRequest[];
+}
+/**
+ * File-based allowlist store format from otto.
+ */
+interface FileAllowFromStore {
+    version: number;
+    allowFrom: string[];
+}
+/**
+ * Migration result for a single channel.
+ */
+export interface ChannelMigrationResult {
+    channel: PairingChannel;
+    requestsMigrated: number;
+    allowlistEntriesMigrated: number;
+    errors: string[];
+}
+/**
+ * Overall migration result.
+ */
+export interface MigrationResult {
+    success: boolean;
+    channels: ChannelMigrationResult[];
+    totalRequestsMigrated: number;
+    totalAllowlistEntriesMigrated: number;
+    errors: string[];
+}
+/**
+ * Options for the migration.
+ */
+export interface MigrationOptions {
+    /** Dry run - only report what would be migrated, don't actually migrate */
+    dryRun?: boolean;
+    /** Skip expired requests */
+    skipExpired?: boolean;
+    /** Expiration TTL in milliseconds (default: 1 hour) */
+    expirationTtlMs?: number;
+    /** Clear existing data before migration */
+    clearExisting?: boolean;
+}
+/**
+ * Migrate a single channel's pairing data from file-based store to database.
+ *
+ * @param runtime - The agent runtime
+ * @param channel - The channel to migrate
+ * @param pairingData - The pairing requests data
+ * @param allowlistData - The allowlist data
+ * @param options - Migration options
+ * @returns Migration result for this channel
+ */
+export declare function migrateChannelPairingData(runtime: IAgentRuntime, channel: PairingChannel, pairingData: FilePairingStore | null, allowlistData: FileAllowFromStore | null, options?: MigrationOptions): Promise<ChannelMigrationResult>;
+/**
+ * Migrate all channels from a directory of file-based pairing stores.
+ *
+ * This function expects the directory to contain files in the format:
+ * - {channel}-pairing.json (pairing requests)
+ * - {channel}-allowFrom.json (allowlist)
+ *
+ * @param runtime - The agent runtime
+ * @param readFile - Function to read a file (path) => Promise<string>
+ * @param listFiles - Function to list files in the directory
+ * @param options - Migration options
+ * @returns Overall migration result
+ */
+export declare function migrateAllChannels(runtime: IAgentRuntime, readFile: (path: string) => Promise<string>, listFiles: () => Promise<string[]>, options?: MigrationOptions): Promise<MigrationResult>;
+/**
+ * Create a migration from file system paths.
+ *
+ * This is a convenience function for Node.js environments.
+ *
+ * @param runtime - The agent runtime
+ * @param credentialsDir - Path to the credentials directory
+ * @param options - Migration options
+ * @returns Migration result
+ */
+export declare function migrateFromFileSystem(runtime: IAgentRuntime, credentialsDir: string, options?: MigrationOptions): Promise<MigrationResult>;
+export {};
+//# sourceMappingURL=pairing-migration.d.ts.map

package/dist/services/pairing-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing-migration.d.ts","sourceRoot":"","sources":["../../src/services/pairing-migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAQ,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAEX,cAAc,EACd,MAAM,kBAAkB,CAAC;AAI1B;;GAEG;AACH,UAAU,kBAAkB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,UAAU,gBAAgB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,UAAU,kBAAkB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,cAAc,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,6BAA6B,EAAE,MAAM,CAAC;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAsCD;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC9C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,gBAAgB,GAAG,IAAI,EACpC,aAAa,EAAE,kBAAkB,GAAG,IAAI,EACxC,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAiJjC;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC3C,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,EAClC,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,eAAe,CAAC,CA+F1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,aAAa,EACtB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAsB1B"}

package/dist/services/pairing.d.ts

@@ -0,0 +1,80 @@
+/**
+ * PairingService - Manages secure DM access via pairing codes.
+ *
+ * This service handles the pairing workflow for messaging channels:
+ * 1. Unknown users send a DM and receive a pairing code
+ * 2. Bot owner approves the code via CLI or API
+ * 3. User is added to the allowlist and can now send DMs
+ */
+import { type ApprovePairingParams, type ApprovePairingResult, type PairingAllowlistEntry, type PairingChannel, type PairingConfig, type PairingRequest, type UpsertPairingRequestParams, type UpsertPairingRequestResult } from "../types/pairing";
+import type { IAgentRuntime } from "../types/runtime";
+import { Service } from "../types/service";
+/**
+ * PairingService handles secure DM pairing for messaging channels.
+ *
+ * When a user sends a DM to a bot with dmPolicy="pairing":
+ * 1. If not in allowlist, a pairing request is created with a code
+ * 2. The code is sent back to the user
+ * 3. The bot owner approves the code via CLI/API
+ * 4. The user is added to the allowlist
+ */
+export declare class PairingService extends Service {
+    static serviceType: "pairing";
+    capabilityDescription: string;
+    private pairingConfig;
+    constructor(runtime: IAgentRuntime, config?: PairingConfig);
+    /**
+     * Start the PairingService with the given runtime.
+     */
+    static start(runtime: IAgentRuntime): Promise<Service>;
+    /**
+     * Stop the PairingService.
+     */
+    stop(): Promise<void>;
+    /**
+     * Generate a random pairing code.
+     * Uses a human-friendly alphabet that excludes ambiguous characters.
+     */
+    private generateCode;
+    /**
+     * Generate a unique code that doesn't conflict with existing codes.
+     */
+    private generateUniqueCode;
+    /**
+     * Check if a pairing request is expired.
+     */
+    private isExpired;
+    /**
+     * List all pending pairing requests for a channel.
+     * Expired requests are automatically filtered out.
+     */
+    listPendingRequests(channel: PairingChannel): Promise<PairingRequest[]>;
+    /**
+     * Create or update a pairing request for a sender.
+     * If the sender already has a pending request, returns the existing code.
+     * If too many pending requests exist, returns empty code.
+     */
+    upsertRequest(params: UpsertPairingRequestParams): Promise<UpsertPairingRequestResult>;
+    /**
+     * Approve a pairing code and add the sender to the allowlist.
+     * Returns null if the code is not found or expired.
+     */
+    approveCode(params: ApprovePairingParams): Promise<ApprovePairingResult | null>;
+    /**
+     * Get the allowlist for a channel.
+     */
+    getAllowlist(channel: PairingChannel): Promise<PairingAllowlistEntry[]>;
+    /**
+     * Check if a sender is in the allowlist.
+     */
+    isAllowed(channel: PairingChannel, senderId: string): Promise<boolean>;
+    /**
+     * Add a sender directly to the allowlist (bypass pairing).
+     */
+    addToAllowlist(channel: PairingChannel, senderId: string, metadata?: Record<string, string>): Promise<PairingAllowlistEntry>;
+    /**
+     * Remove a sender from the allowlist.
+     */
+    removeFromAllowlist(channel: PairingChannel, senderId: string): Promise<boolean>;
+}
+//# sourceMappingURL=pairing.d.ts.map

package/dist/services/pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../src/services/pairing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAGzB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAe,MAAM,kBAAkB,CAAC;AAGxD;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,OAAO;IAC1C,MAAM,CAAC,WAAW,YAAuB;IACzC,qBAAqB,SACgD;IAErE,OAAO,CAAC,aAAa,CAA0B;gBAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,aAAa;IAQ1D;;OAEG;WACU,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;YACW,kBAAkB;IAiBhC;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;;OAGG;IACG,mBAAmB,CACxB,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,EAAE,CAAC;IA8B5B;;;;OAIG;IACG,aAAa,CAClB,MAAM,EAAE,0BAA0B,GAChC,OAAO,CAAC,0BAA0B,CAAC;IAuEtC;;;OAGG;IACG,WAAW,CAChB,MAAM,EAAE,oBAAoB,GAC1B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAmDvC;;OAEG;IACG,YAAY,CACjB,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAOnC;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5E;;OAEG;IACG,cAAc,CACnB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,qBAAqB,CAAC;IA6BjC;;OAEG;IACG,mBAAmB,CACxB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC;CAiBnB"}

package/dist/services/plugin-hooks.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Plugin Startup Hooks
+ *
+ * Provides a system for registering hooks that run during plugin initialization.
+ * This allows external systems (like Otto) to participate in plugin loading.
+ *
+ * @module services/plugin-hooks
+ */
+import type { Character } from "../types/agent.ts";
+import type { Plugin } from "../types/plugin.ts";
+/**
+ * Context provided to plugin startup hooks.
+ */
+export interface PluginHookContext {
+    /** The character configuration */
+    character: Character;
+    /** Environment variables */
+    env: NodeJS.ProcessEnv;
+    /** Plugins that will be registered */
+    plugins: Plugin[];
+}
+/**
+ * Result from a plugin filter hook.
+ */
+export interface PluginFilterResult {
+    /** Filtered list of plugins */
+    plugins: Plugin[];
+    /** Changes made during filtering */
+    changes: string[];
+}
+/**
+ * Hook function type for pre-registration plugins.
+ */
+export type PluginPreRegisterHook = (context: PluginHookContext) => Promise<PluginFilterResult> | PluginFilterResult;
+/**
+ * Hook function type for post-registration.
+ */
+export type PluginPostRegisterHook = (context: PluginHookContext) => Promise<void> | void;
+/**
+ * Configuration for plugin allow/deny filtering.
+ */
+export interface PluginFilterConfig {
+    /** List of plugin names to allow (whitelist) */
+    allow?: string[];
+    /** List of plugin names to deny (blacklist) */
+    deny?: string[];
+}
+/**
+ * Register a hook that runs before plugins are registered.
+ * The hook can modify the list of plugins that will be registered.
+ *
+ * @param hook - The hook function to register
+ * @returns A function to unregister the hook
+ */
+export declare function registerPreRegisterHook(hook: PluginPreRegisterHook): () => void;
+/**
+ * Register a hook that runs after plugins are registered.
+ *
+ * @param hook - The hook function to register
+ * @returns A function to unregister the hook
+ */
+export declare function registerPostRegisterHook(hook: PluginPostRegisterHook): () => void;
+/**
+ * Run all pre-register hooks and return the filtered plugins.
+ *
+ * @param context - The plugin hook context
+ * @returns The filtered plugins and all changes made
+ */
+export declare function runPreRegisterHooks(context: PluginHookContext): Promise<PluginFilterResult>;
+/**
+ * Run all post-register hooks.
+ *
+ * @param context - The plugin hook context
+ */
+export declare function runPostRegisterHooks(context: PluginHookContext): Promise<void>;
+/**
+ * Apply allow/deny filtering to a list of plugins.
+ *
+ * The filtering logic:
+ * - If `allow` is specified, only plugins in the allow list are kept
+ * - If `deny` is specified, plugins in the deny list are removed
+ * - Both can be specified: allow is applied first, then deny
+ *
+ * Plugin names are matched case-insensitively and support:
+ * - Full plugin name: "@elizaos/plugin-discord"
+ * - Short name: "discord" (matches "@elizaos/plugin-discord")
+ *
+ * @param plugins - The list of plugins to filter
+ * @param config - The filter configuration
+ * @returns The filtered list of plugins and changes made
+ */
+export declare function applyPluginFilter(plugins: Plugin[], config: PluginFilterConfig): PluginFilterResult;
+/**
+ * Create a pre-register hook that applies allow/deny filtering.
+ *
+ * @param config - The filter configuration
+ * @returns A pre-register hook function
+ */
+export declare function createPluginFilterHook(config: PluginFilterConfig): PluginPreRegisterHook;
+/**
+ * Get the current number of registered pre-register hooks.
+ */
+export declare function getPreRegisterHookCount(): number;
+/**
+ * Get the current number of registered post-register hooks.
+ */
+export declare function getPostRegisterHookCount(): number;
+/**
+ * Clear all registered hooks. Useful for testing.
+ */
+export declare function clearAllHooks(): void;
+//# sourceMappingURL=plugin-hooks.d.ts.map

package/dist/services/plugin-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-hooks.d.ts","sourceRoot":"","sources":["../../src/services/plugin-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,kCAAkC;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,sCAAsC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oCAAoC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CACnC,OAAO,EAAE,iBAAiB,KACtB,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACpC,OAAO,EAAE,iBAAiB,KACtB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAMD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,qBAAqB,GACzB,MAAM,IAAI,CAQZ;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,sBAAsB,GAC1B,MAAM,IAAI,CAQZ;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAW7B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,kBAAkB,GACxB,kBAAkB,CA6DpB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,kBAAkB,GACxB,qBAAqB,CAIvB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC"}