@elizaos/core 2.0.0-alpha.52 → 2.0.0-alpha.53

package/dist/services/hook.d.ts

@@ -0,0 +1,85 @@
+/**
+ * HookService - Unified Hook Management Service
+ *
+ * Provides centralized hook registration, management, and execution for the
+ * Eliza agent runtime. Integrates with the runtime event system to dispatch
+ * hooks when events are emitted.
+ *
+ * Key features:
+ * - Unified registry for all hook sources (bundled, workspace, plugin, runtime)
+ * - Priority-based execution with FIFO ordering for same priority
+ * - Eligibility checking based on OS, binaries, env vars, and config
+ * - Directory-based hook discovery and loading
+ * - Integration with runtime event system
+ */
+import type { EventType } from "../types/events";
+import type { HookEligibilityResult, HookHandler, HookLoadResult, HookPriority, HookRegistration, HookRegistrationOptions, HookRequirements, HookSnapshot, HookSource, IHookService } from "../types/hook";
+import type { IAgentRuntime } from "../types/runtime";
+import { Service } from "../types/service";
+/**
+ * HookService implementation
+ */
+export declare class HookService extends Service implements IHookService {
+    static serviceType: "hooks";
+    capabilityDescription: string;
+    /** Hook registry keyed by ID */
+    private registry;
+    /** Index of hook IDs by event type for fast lookup */
+    private eventIndex;
+    /** Counter for generating unique hook IDs */
+    private idCounter;
+    /** Version counter for snapshots */
+    private snapshotVersion;
+    /** Configuration for eligibility checks */
+    private hookConfig;
+    /**
+     * Start the hook service
+     */
+    static start(runtime: IAgentRuntime): Promise<HookService>;
+    /**
+     * Stop the hook service
+     */
+    stop(): Promise<void>;
+    /**
+     * Set up event interceptors to dispatch to hooks
+     */
+    private setupEventInterceptors;
+    /**
+     * Dispatch an event to all registered hooks
+     */
+    private dispatchToHooks;
+    /**
+     * Check eligibility for a registration (internal)
+     */
+    private checkEligibilityInternal;
+    register(events: EventType | EventType[], handler: HookHandler, options: HookRegistrationOptions): string;
+    unregister(hookId: string): boolean;
+    registerFromDirectory(dir: string, source: HookSource, options?: {
+        pluginId?: string;
+    }): Promise<HookLoadResult>;
+    getSnapshot(): HookSnapshot;
+    getHooksByEvent(event: EventType): HookRegistration[];
+    getHook(hookId: string): HookRegistration | undefined;
+    getAllHooks(): HookRegistration[];
+    setEnabled(hookId: string, enabled: boolean): void;
+    setPriority(hookId: string, priority: HookPriority): void;
+    /**
+     * Set configuration for eligibility checks
+     */
+    setConfig(config: Record<string, unknown>): void;
+    checkEligibility(hookId: string): HookEligibilityResult;
+    checkRequirements(requirements: HookRequirements, config?: Record<string, unknown>): HookEligibilityResult;
+    /**
+     * Resolve a dot-separated config path
+     */
+    private resolveConfigPath;
+    /**
+     * Check if a value is truthy
+     */
+    private isTruthy;
+}
+/**
+ * Create and return the HookService class for registration
+ */
+export declare const HookServiceClass: typeof HookService;
+//# sourceMappingURL=hook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/services/hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAEX,qBAAqB,EAErB,WAAW,EACX,cAAc,EAEd,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EAEV,YAAY,EACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAe,MAAM,kBAAkB,CAAC;AA8LxD;;GAEG;AACH,qBAAa,WAAY,SAAQ,OAAQ,YAAW,YAAY;IAC/D,MAAM,CAAC,WAAW,UAAqB;IACvC,qBAAqB,SAAqC;IAE1D,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAuC;IAEvD,sDAAsD;IACtD,OAAO,CAAC,UAAU,CAAqC;IAEvD,6CAA6C;IAC7C,OAAO,CAAC,SAAS,CAAK;IAEtB,oCAAoC;IACpC,OAAO,CAAC,eAAe,CAAK;IAE5B,2CAA2C;IAC3C,OAAO,CAAC,UAAU,CAA+B;IAEjD;;OAEG;WACU,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAUhE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;OAEG;YACW,eAAe;IA+B7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsBhC,QAAQ,CACP,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,EAC/B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,uBAAuB,GAC9B,MAAM;IAsDT,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IA+B7B,qBAAqB,CAC1B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC,cAAc,CAAC;IAmG1B,WAAW,IAAI,YAAY;IAmB3B,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,EAAE;IAWrD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIrD,WAAW,IAAI,gBAAgB,EAAE;IAQjC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQlD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAQzD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQhD,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB;IAQvD,iBAAiB,CAChB,YAAY,EAAE,gBAAgB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,qBAAqB;IAyDxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAehB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,oBAAc,CAAC"}

package/dist/services/message.d.ts

@@ -0,0 +1,71 @@
+import type { HandlerCallback } from "../types/components";
+import type { Room } from "../types/environment";
+import type { Memory } from "../types/memory";
+import type { IMessageService, MessageProcessingOptions, MessageProcessingResult, ResponseDecision } from "../types/message-service";
+import type { Media, MentionContext, UUID } from "../types/primitives";
+import type { IAgentRuntime } from "../types/runtime";
+/**
+ * Default implementation of the MessageService interface.
+ * This service handles the complete message processing pipeline including:
+ * - Message validation and memory creation
+ * - Smart response decision (shouldRespond)
+ * - Single-shot or multi-step processing strategies
+ * - Action execution and evaluation
+ * - Attachment processing
+ * - Message deletion and channel clearing
+ *
+ * This is the standard message handler used by elizaOS and can be replaced
+ * with custom implementations via the IMessageService interface.
+ */
+export declare class DefaultMessageService implements IMessageService {
+    /**
+     * Main message handling entry point
+     */
+    handleMessage(runtime: IAgentRuntime, message: Memory, callback?: HandlerCallback, options?: MessageProcessingOptions): Promise<MessageProcessingResult>;
+    /**
+     * Internal message processing implementation
+     */
+    private processMessage;
+    /**
+     * Determines whether the agent should respond to a message.
+     * Uses simple rules for obvious cases (DM, mentions) and defers to LLM for ambiguous cases.
+     */
+    shouldRespond(runtime: IAgentRuntime, message: Memory, room?: Room, mentionContext?: MentionContext): ResponseDecision;
+    /**
+     * Processes attachments by generating descriptions for supported media types.
+     */
+    processAttachments(runtime: IAgentRuntime, attachments: Media[]): Promise<Media[]>;
+    /**
+     * Single-shot strategy: one LLM call to generate response
+     * Uses dynamicPromptExecFromState for validation-aware structured output
+     */
+    private runSingleShotCore;
+    /**
+     * Multi-step strategy: iterative action execution with final summary
+     */
+    private runMultiStepCore;
+    /**
+     * Helper to emit run ended events
+     */
+    private emitRunEnded;
+    /**
+     * Deletes a message from the agent's memory.
+     * This method handles the actual deletion logic that was previously in event handlers.
+     *
+     * @param runtime - The agent runtime instance
+     * @param message - The message memory to delete
+     * @returns Promise resolving when deletion is complete
+     */
+    deleteMessage(runtime: IAgentRuntime, message: Memory): Promise<void>;
+    /**
+     * Clears all messages from a channel/room.
+     * This method handles bulk deletion of all message memories in a room.
+     *
+     * @param runtime - The agent runtime instance
+     * @param roomId - The room ID to clear messages from
+     * @param channelId - The original channel ID (for logging)
+     * @returns Promise resolving when channel is cleared
+     */
+    clearChannel(runtime: IAgentRuntime, roomId: UUID, channelId: string): Promise<void>;
+}
+//# sourceMappingURL=message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/services/message.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAGX,eAAe,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EACX,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAW,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA0JtD;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC5D;;OAEG;IACG,aAAa,CAClB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC;IA6LnC;;OAEG;YACW,cAAc;IA2uB5B;;;OAGG;IACH,aAAa,CACZ,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,IAAI,EACX,cAAc,CAAC,EAAE,cAAc,GAC7B,gBAAgB;IA4FnB;;OAEG;IACG,kBAAkB,CACvB,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,KAAK,EAAE,GAClB,OAAO,CAAC,KAAK,EAAE,CAAC;IAgRnB;;;OAGG;YACW,iBAAiB;IAmX/B;;OAEG;YACW,gBAAgB;IAwc9B;;OAEG;YACW,YAAY;IAqB1B;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB3E;;;;;;;;OAQG;IACG,YAAY,CACjB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,IAAI,EACZ,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;CA4ChB"}

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

@@ -0,0 +1,240 @@
+/**
+ * CLI Onboarding Adapter
+ *
+ * Wraps the OnboardingStateMachine with CLI-specific logic for terminal prompts.
+ * Provides formatted prompts, input parsing, and step-specific CLI flows.
+ */
+import { type OnboardingContext, type OnboardingInput, type OnboardingProgress, type OnboardingResult, OnboardingStep } from "../types/onboarding";
+import { OnboardingStateMachine, type OnboardingStateMachineConfig } from "./onboarding-state";
+/**
+ * Prompt configuration for CLI display.
+ */
+export interface CliPromptConfig {
+    /** Title for the prompt */
+    title: string;
+    /** Description or instruction text */
+    description: string;
+    /** Type of prompt (confirm, text, select, multiselect, password) */
+    type: "confirm" | "text" | "select" | "multiselect" | "password";
+    /** Options for select/multiselect prompts */
+    options?: Array<{
+        value: string;
+        label: string;
+        hint?: string;
+    }>;
+    /** Default value */
+    defaultValue?: string | boolean | string[];
+    /** Placeholder text for input */
+    placeholder?: string;
+    /** Validation function */
+    validate?: (value: string) => string | undefined;
+    /** Whether the input is required */
+    required?: boolean;
+}
+/**
+ * Result of parsing CLI input.
+ */
+export interface ParsedCliInput {
+    /** Whether parsing was successful */
+    success: boolean;
+    /** The parsed input ready for the state machine */
+    input?: OnboardingInput;
+    /** Error message if parsing failed */
+    error?: string;
+}
+/**
+ * Risk acknowledgement text for display.
+ */
+export declare const RISK_ACKNOWLEDGEMENT_TEXT = "\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n                          IMPORTANT SECURITY INFORMATION\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nBy proceeding with this setup, you acknowledge and accept the following:\n\n1. API KEY SECURITY\n   Your API keys provide access to paid services. Keep them secure and never\n   share them publicly. Leaked keys can result in unauthorized charges.\n\n2. EXECUTION CAPABILITIES\n   This agent can execute commands and code on your system. Always review\n   actions before approving them, especially commands that modify files or\n   access sensitive data.\n\n3. NETWORK ACCESS\n   The agent connects to external services (AI providers, messaging platforms).\n   Ensure you trust all configured services and review their privacy policies.\n\n4. DATA HANDLING\n   Messages and data may be sent to external AI providers for processing.\n   Do not share sensitive personal information through the agent.\n\n5. YOUR RESPONSIBILITY\n   You are responsible for:\n   - Monitoring agent activities\n   - Reviewing execution requests\n   - Keeping your system and credentials secure\n   - Complying with terms of service for all connected platforms\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n";
+/**
+ * Supported model providers.
+ */
+export declare const MODEL_PROVIDERS: readonly [{
+    readonly value: "anthropic";
+    readonly label: "Anthropic (Claude)";
+    readonly hint: "Recommended";
+}, {
+    readonly value: "openai";
+    readonly label: "OpenAI (GPT)";
+    readonly hint: "";
+}, {
+    readonly value: "google";
+    readonly label: "Google (Gemini)";
+    readonly hint: "";
+}, {
+    readonly value: "groq";
+    readonly label: "Groq";
+    readonly hint: "Fast inference";
+}, {
+    readonly value: "xai";
+    readonly label: "xAI (Grok)";
+    readonly hint: "";
+}, {
+    readonly value: "openrouter";
+    readonly label: "OpenRouter";
+    readonly hint: "Multi-provider";
+}, {
+    readonly value: "ollama";
+    readonly label: "Ollama";
+    readonly hint: "Local models";
+}];
+/**
+ * Supported channels.
+ */
+export declare const CHANNELS: readonly [{
+    readonly value: "discord";
+    readonly label: "Discord";
+    readonly hint: "Bot token required";
+}, {
+    readonly value: "telegram";
+    readonly label: "Telegram";
+    readonly hint: "Bot token required";
+}, {
+    readonly value: "twitter";
+    readonly label: "Twitter/X";
+    readonly hint: "Credentials required";
+}, {
+    readonly value: "slack";
+    readonly label: "Slack";
+    readonly hint: "Bot token required";
+}, {
+    readonly value: "web";
+    readonly label: "Web Interface";
+    readonly hint: "Built-in";
+}];
+/**
+ * Authentication methods.
+ */
+export declare const AUTH_METHODS: readonly [{
+    readonly value: "api_key";
+    readonly label: "API Key";
+    readonly hint: "Enter your API key directly";
+}, {
+    readonly value: "oauth";
+    readonly label: "OAuth";
+    readonly hint: "Sign in with your provider account";
+}, {
+    readonly value: "setup_token";
+    readonly label: "Setup Token";
+    readonly hint: "Paste token from CLI command";
+}];
+/**
+ * CLI Onboarding Adapter
+ *
+ * Provides CLI-specific functionality on top of the OnboardingStateMachine.
+ */
+export declare class CLIOnboardingAdapter {
+    private stateMachine;
+    constructor(config?: Partial<Omit<OnboardingStateMachineConfig, "platform" | "mode">>);
+    /**
+     * Get the underlying state machine.
+     */
+    getStateMachine(): OnboardingStateMachine;
+    /**
+     * Get the current context.
+     */
+    getContext(): OnboardingContext;
+    /**
+     * Get the current step.
+     */
+    getCurrentStep(): OnboardingStep;
+    /**
+     * Get progress information.
+     */
+    getProgress(): OnboardingProgress;
+    /**
+     * Generate appropriate CLI prompt(s) for the current step.
+     */
+    promptForStep(step?: OnboardingStep): CliPromptConfig[];
+    /**
+     * Parse CLI input for a specific step.
+     */
+    parseCliInput(input: Record<string, unknown>, step?: OnboardingStep): ParsedCliInput;
+    /**
+     * Process input and advance the state machine.
+     */
+    advanceStep(input: OnboardingInput): Promise<OnboardingResult>;
+    /**
+     * Skip the current step.
+     */
+    skipStep(): Promise<OnboardingResult>;
+    /**
+     * Go back to a previous step.
+     */
+    goBack(targetStep?: OnboardingStep): OnboardingResult;
+    /**
+     * Reset the onboarding flow.
+     */
+    reset(): void;
+    /**
+     * Get prompts for WELCOME step.
+     */
+    private getWelcomePrompts;
+    /**
+     * Get prompts for RISK_ACK step.
+     */
+    private getRiskAckPrompts;
+    /**
+     * Get prompts for AUTH step.
+     */
+    private getAuthPrompts;
+    /**
+     * Get prompts for CHANNELS step.
+     */
+    private getChannelPrompts;
+    /**
+     * Get prompts for SKILLS step.
+     */
+    private getSkillsPrompts;
+    /**
+     * Get prompts for COMPLETE step.
+     */
+    private getCompletePrompts;
+    /**
+     * Parse WELCOME step input.
+     */
+    private parseWelcomeInput;
+    /**
+     * Parse RISK_ACK step input.
+     */
+    private parseRiskAckInput;
+    /**
+     * Parse AUTH step input.
+     */
+    private parseAuthInput;
+    /**
+     * Parse CHANNELS step input.
+     */
+    private parseChannelsInput;
+    /**
+     * Parse SKILLS step input.
+     */
+    private parseSkillsInput;
+    /**
+     * Generate a completion summary.
+     */
+    private generateCompletionSummary;
+    /**
+     * Format a progress bar for CLI display.
+     */
+    formatProgressBar(width?: number): string;
+    /**
+     * Get step-specific help text.
+     */
+    getStepHelp(step?: OnboardingStep): string;
+}
+/**
+ * Create a new CLI onboarding adapter.
+ */
+export declare function createCLIOnboardingAdapter(config?: Partial<Omit<OnboardingStateMachineConfig, "platform" | "mode">>): CLIOnboardingAdapter;
+/**
+ * Run through CLI onboarding with provided answers (for testing/automation).
+ */
+export declare function runNonInteractiveOnboarding(adapter: CLIOnboardingAdapter, answers: {
+    provider?: string;
+    apiKey?: string;
+    channels?: string[];
+    skills?: string[];
+    nodeManager?: "npm" | "pnpm" | "bun";
+}): Promise<OnboardingResult>;
+//# sourceMappingURL=onboarding-cli.d.ts.map

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

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

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

@@ -0,0 +1,225 @@
+/**
+ * Onboarding RPC Methods
+ *
+ * Provides RPC methods for native apps (macOS, iOS) to interact with
+ * the onboarding wizard programmatically.
+ *
+ * Methods:
+ * - wizard.start: Start onboarding, returns initial state
+ * - wizard.step: Advance to next step with input
+ * - wizard.getState: Get current state
+ * - wizard.cancel: Abort onboarding
+ */
+import { type OnboardingContext, type OnboardingInput, type OnboardingProgress, OnboardingStep, type SerializedOnboardingState } from "../types/onboarding";
+import type { UUID } from "../types/primitives";
+/**
+ * RPC method names.
+ */
+export declare const WIZARD_RPC_METHODS: {
+    readonly START: "wizard.start";
+    readonly STEP: "wizard.step";
+    readonly GET_STATE: "wizard.getState";
+    readonly CANCEL: "wizard.cancel";
+    readonly GO_BACK: "wizard.goBack";
+    readonly SKIP: "wizard.skip";
+};
+/**
+ * Parameters for wizard.start RPC.
+ */
+export interface WizardStartParams {
+    /** World ID for context */
+    worldId?: UUID;
+    /** User ID being onboarded */
+    userId?: UUID;
+    /** Platform identifier */
+    platform?: string;
+    /** Restore from existing state if available */
+    restoreState?: SerializedOnboardingState;
+}
+/**
+ * Result of wizard.start RPC.
+ */
+export interface WizardStartResult {
+    /** Whether start was successful */
+    success: boolean;
+    /** Session ID for subsequent calls */
+    sessionId: string;
+    /** Initial state */
+    state: WizardState;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Parameters for wizard.step RPC.
+ */
+export interface WizardStepParams {
+    /** Session ID from wizard.start */
+    sessionId: string;
+    /** Input for the current step */
+    input: OnboardingInput;
+}
+/**
+ * Result of wizard.step RPC.
+ */
+export interface WizardStepResult {
+    /** Whether step was successful */
+    success: boolean;
+    /** Updated state after step */
+    state: WizardState;
+    /** Error if step failed */
+    error?: string;
+    /** Message for the user */
+    message?: string;
+}
+/**
+ * Parameters for wizard.getState RPC.
+ */
+export interface WizardGetStateParams {
+    /** Session ID from wizard.start */
+    sessionId: string;
+}
+/**
+ * Result of wizard.getState RPC.
+ */
+export interface WizardGetStateResult {
+    /** Whether request was successful */
+    success: boolean;
+    /** Current state */
+    state?: WizardState;
+    /** Error if request failed */
+    error?: string;
+}
+/**
+ * Parameters for wizard.cancel RPC.
+ */
+export interface WizardCancelParams {
+    /** Session ID from wizard.start */
+    sessionId: string;
+    /** Whether to save partial progress */
+    saveProgress?: boolean;
+}
+/**
+ * Result of wizard.cancel RPC.
+ */
+export interface WizardCancelResult {
+    /** Whether cancel was successful */
+    success: boolean;
+    /** Serialized state if saveProgress was true */
+    savedState?: SerializedOnboardingState;
+    /** Error if cancel failed */
+    error?: string;
+}
+/**
+ * Parameters for wizard.goBack RPC.
+ */
+export interface WizardGoBackParams {
+    /** Session ID from wizard.start */
+    sessionId: string;
+    /** Target step to go back to (optional, defaults to previous) */
+    targetStep?: OnboardingStep;
+}
+/**
+ * Parameters for wizard.skip RPC.
+ */
+export interface WizardSkipParams {
+    /** Session ID from wizard.start */
+    sessionId: string;
+}
+/**
+ * Wizard state for RPC responses.
+ */
+export interface WizardState {
+    /** Current step */
+    currentStep: OnboardingStep;
+    /** Step label for display */
+    currentStepLabel: string;
+    /** Step description */
+    currentStepDescription: string;
+    /** Progress information */
+    progress: OnboardingProgress;
+    /** Whether onboarding is complete */
+    isComplete: boolean;
+    /** Full context */
+    context: OnboardingContext;
+    /** Available actions for current step */
+    availableActions: string[];
+}
+/**
+ * Callback for wizard state changes (for WebSocket events).
+ */
+export type WizardStateChangeCallback = (sessionId: string, oldState: WizardState, newState: WizardState) => void;
+/**
+ * Onboarding RPC Service
+ *
+ * Manages wizard sessions and handles RPC calls from native apps.
+ */
+export declare class OnboardingRPCService {
+    /** Active wizard sessions keyed by session ID */
+    private sessions;
+    /** State change callbacks for WebSocket notifications */
+    private stateChangeCallbacks;
+    /**
+     * Register a callback for state changes.
+     */
+    onStateChange(callback: WizardStateChangeCallback): () => void;
+    /**
+     * Notify all callbacks of a state change.
+     */
+    private notifyStateChange;
+    /**
+     * Convert context to wizard state.
+     */
+    private toWizardState;
+    /**
+     * Handle wizard.start RPC.
+     */
+    start(params: WizardStartParams): Promise<WizardStartResult>;
+    /**
+     * Handle wizard.step RPC.
+     */
+    step(params: WizardStepParams): Promise<WizardStepResult>;
+    /**
+     * Handle wizard.getState RPC.
+     */
+    getState(params: WizardGetStateParams): WizardGetStateResult;
+    /**
+     * Handle wizard.cancel RPC.
+     */
+    cancel(params: WizardCancelParams): WizardCancelResult;
+    /**
+     * Handle wizard.goBack RPC.
+     */
+    goBack(params: WizardGoBackParams): WizardStepResult;
+    /**
+     * Handle wizard.skip RPC.
+     */
+    skip(params: WizardSkipParams): Promise<WizardStepResult>;
+    /**
+     * Get all active session IDs.
+     */
+    getActiveSessions(): string[];
+    /**
+     * Check if a session exists.
+     */
+    hasSession(sessionId: string): boolean;
+    /**
+     * Clean up all sessions.
+     */
+    dispose(): void;
+}
+/**
+ * Create a new OnboardingRPCService instance.
+ */
+export declare function createOnboardingRPCService(): OnboardingRPCService;
+/**
+ * Helper to create RPC method handlers for integration with existing RPC systems.
+ */
+export declare function createWizardRPCHandlers(service: OnboardingRPCService): {
+    "wizard.start": (params: WizardStartParams) => Promise<WizardStartResult>;
+    "wizard.step": (params: WizardStepParams) => Promise<WizardStepResult>;
+    "wizard.getState": (params: WizardGetStateParams) => WizardGetStateResult;
+    "wizard.cancel": (params: WizardCancelParams) => WizardCancelResult;
+    "wizard.goBack": (params: WizardGoBackParams) => WizardStepResult;
+    "wizard.skip": (params: WizardSkipParams) => Promise<WizardStepResult>;
+};
+//# sourceMappingURL=onboarding-rpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-rpc.d.ts","sourceRoot":"","sources":["../../src/services/onboarding-rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAGN,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,cAAc,EACd,KAAK,yBAAyB,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAMhD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,2BAA2B;IAC3B,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,8BAA8B;IAC9B,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,yBAAyB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,KAAK,EAAE,WAAW,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,EAAE,eAAe,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,UAAU,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,mBAAmB;IACnB,WAAW,EAAE,cAAc,CAAC;IAC5B,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2BAA2B;IAC3B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,qCAAqC;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,mBAAmB;IACnB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,WAAW,KACjB,IAAI,CAAC;AAEV;;;;GAIG;AACH,qBAAa,oBAAoB;IAChC,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAkD;IAClE,yDAAyD;IACzD,OAAO,CAAC,oBAAoB,CAA6C;IAEzE;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,IAAI;IAK9D;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkCrB;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuDlE;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsC/D;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB;IAe5D;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB;IA4BtD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,gBAAgB;IAsCpD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsC/D;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAI7B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,OAAO,IAAI,IAAI;CAKf;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,oBAAoB,CAEjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB;6BAExB,iBAAiB;4BAElB,gBAAgB;gCAEjB,oBAAoB;8BAEvB,kBAAkB;8BAEjB,kBAAkB;4BAEf,gBAAgB;EAG3D"}