@elizaos/agent 0.25.8 → 2.0.0-alpha.83

package/packages/agent/src/hooks/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Hooks Type Definitions
+ *
+ * Core types for Eliza's event-driven hooks system.
+ *
+ * @module hooks/types
+ */
+/** Supported hook event categories. */
+export type HookEventType = "command" | "session" | "agent" | "gateway";
+/** A hook event dispatched to registered handlers. */
+export interface HookEvent {
+    /** Event category. */
+    type: HookEventType;
+    /** Specific action within the category (e.g., "new", "reset", "startup"). */
+    action: string;
+    /** Session key where the event occurred. */
+    sessionKey: string;
+    /** Event timestamp. */
+    timestamp: Date;
+    /** Messages to be sent back to the user. Handlers can push to this array. */
+    messages: string[];
+    /** Additional context data. */
+    context: Record<string, unknown>;
+}
+/** Handler function signature. */
+export type HookHandler = (event: HookEvent) => Promise<void> | void;
+/** Eliza-specific hook metadata from HOOK.md frontmatter. */
+export interface ElizaHookMetadata {
+    /** Bypass eligibility checks. */
+    always?: boolean;
+    /** Config key override (defaults to hook name). */
+    hookKey?: string;
+    /** Display emoji. */
+    emoji?: string;
+    /** Documentation URL. */
+    homepage?: string;
+    /** Events this hook handles. */
+    events: string[];
+    /** Named export to use (defaults to "default"). */
+    export?: string;
+    /** Required platforms (darwin, linux, win32). */
+    os?: string[];
+    /** Requirements for eligibility. */
+    requires?: {
+        /** All listed binaries must exist on PATH. */
+        bins?: string[];
+        /** At least one listed binary must exist on PATH. */
+        anyBins?: string[];
+        /** Required environment variables. */
+        env?: string[];
+        /** Required config paths (must be truthy). */
+        config?: string[];
+    };
+    /** Installation methods for the macOS Skills UI. */
+    install?: HookInstallSpec[];
+}
+/** Hook installation specification. */
+export interface HookInstallSpec {
+    id: string;
+    kind: "bundled" | "npm" | "git" | "download";
+    formula?: string;
+    bins?: string[];
+    label?: string;
+    os?: string[];
+}
+/** Parsed frontmatter from HOOK.md. */
+export interface ParsedHookFrontmatter {
+    name: string;
+    description: string;
+    homepage?: string;
+    metadata?: {
+        eliza?: ElizaHookMetadata;
+    };
+}
+/** Hook source type. */
+export type HookSource = "eliza-bundled" | "eliza-managed" | "eliza-workspace" | "eliza-plugin";
+/** A discovered hook. */
+export interface Hook {
+    name: string;
+    description: string;
+    source: HookSource;
+    pluginId?: string;
+    filePath: string;
+    baseDir: string;
+    handlerPath: string;
+}
+/** Hook entry with parsed metadata. */
+export interface HookEntry {
+    hook: Hook;
+    frontmatter: ParsedHookFrontmatter;
+    metadata?: ElizaHookMetadata;
+}
+/** Hook status for listing/display. */
+export interface HookStatus {
+    name: string;
+    description: string;
+    source: HookSource;
+    emoji?: string;
+    events: string[];
+    enabled: boolean;
+    eligible: boolean;
+    missingRequirements?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/agent/src/hooks/types.d.ts.map

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

package/packages/agent/src/hooks/types.js

@@ -0,0 +1,8 @@
+/**
+ * Hooks Type Definitions
+ *
+ * Core types for Eliza's event-driven hooks system.
+ *
+ * @module hooks/types
+ */
+export {};

package/packages/agent/src/index.d.ts

@@ -0,0 +1,20 @@
+export * from "./api";
+export * from "./auth/index";
+export * from "./config";
+export * from "./diagnostics/integration-observability";
+export * from "./hooks/index";
+export * from "./onboarding-presets";
+export * from "./providers/workspace";
+export * from "./runtime";
+export * from "./runtime/core-plugins";
+export * from "./security/audit-log";
+export * from "./security/network-policy";
+export * from "./server";
+export * from "./services";
+export * from "./triggers/action";
+export * from "./triggers/runtime";
+export * from "./triggers/scheduling";
+export * from "./triggers/types";
+export * from "./utils/number-parsing";
+export * from "./utils/spoken-text";
+//# sourceMappingURL=index.d.ts.map

package/packages/agent/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,yCAAyC,CAAC;AACxD,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC"}

package/packages/agent/src/index.js

@@ -0,0 +1,19 @@
+export * from "./api";
+export * from "./auth/index";
+export * from "./config";
+export * from "./diagnostics/integration-observability";
+export * from "./hooks/index";
+export * from "./onboarding-presets";
+export * from "./providers/workspace";
+export * from "./runtime";
+export * from "./runtime/core-plugins";
+export * from "./security/audit-log";
+export * from "./security/network-policy";
+export * from "./server";
+export * from "./services";
+export * from "./triggers/action";
+export * from "./triggers/runtime";
+export * from "./triggers/scheduling";
+export * from "./triggers/types";
+export * from "./utils/number-parsing";
+export * from "./utils/spoken-text";

package/packages/agent/src/onboarding-presets.d.ts

@@ -0,0 +1,78 @@
+/** Shared rules appended to every template's style.all array. */
+export declare const SHARED_STYLE_RULES: string[];
+export declare const STYLE_PRESETS: {
+    catchphrase: string;
+    hint: string;
+    bio: string[];
+    system: string;
+    adjectives: string[];
+    topics: string[];
+    style: {
+        all: string[];
+        chat: string[];
+        post: string[];
+    };
+    postExamples: string[];
+    postExamples_zhCN: string[];
+    messageExamples: {
+        user: string;
+        content: {
+            text: string;
+        };
+    }[][];
+}[];
+/** Eliza character presets for onboarding. */
+export declare const CHARACTER_PRESETS: readonly [{
+    readonly id: "chen";
+    readonly name: "Chen";
+    readonly catchphrase: "I'm here to help you.";
+    readonly description: "Cute, playful, supportive energy";
+    readonly style: "kawaii";
+}, {
+    readonly id: "jin";
+    readonly name: "Jin";
+    readonly catchphrase: "I'm here to get things done.";
+    readonly description: "Confident, energetic, hype beast";
+    readonly style: "bold";
+}, {
+    readonly id: "kei";
+    readonly name: "Kei";
+    readonly catchphrase: "I'm online and ready.";
+    readonly description: "Chill, sarcastic, lowkey genius";
+    readonly style: "deadpan";
+}, {
+    readonly id: "momo";
+    readonly name: "Momo";
+    readonly catchphrase: "I'm ready to assist.";
+    readonly description: "Precise, professional, organized";
+    readonly style: "corporate";
+}, {
+    readonly id: "rin";
+    readonly name: "Rin";
+    readonly catchphrase: "Let's build something fun.";
+    readonly description: "Sweet, mischievous, creative";
+    readonly style: "playful";
+}, {
+    readonly id: "ryu";
+    readonly name: "Ryu";
+    readonly catchphrase: "I am ready when you are.";
+    readonly description: "Mysterious, minimal, deep thinker";
+    readonly style: "stoic";
+}, {
+    readonly id: "satoshi";
+    readonly name: "Satoshi";
+    readonly catchphrase: "Show me what we're building.";
+    readonly description: "Edgy, self-deprecating, crypto degen";
+    readonly style: "degen";
+}];
+export declare const CHARACTER_PRESET_META: Record<string, {
+    name: string;
+    avatarIndex: number;
+    voicePresetId?: string;
+    catchphrase: string;
+}>;
+/** Return the full list of style presets. */
+export declare function getStylePresets(): typeof STYLE_PRESETS;
+/** Return a name → catchphrase mapping derived from CHARACTER_PRESET_META. */
+export declare function getPresetNameMap(): Record<string, string>;
+//# sourceMappingURL=onboarding-presets.d.ts.map

package/packages/agent/src/onboarding-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-presets.d.ts","sourceRoot":"","sources":["../../../../src/onboarding-presets.ts"],"names":[],"mappings":"AACA,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,UAK9B,CAAC;AACF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;GAytCzB,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDpB,CAAC;AAEX,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,MAAM,EACN;IACE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB,CA4CF,CAAC;AAEF,6CAA6C;AAC7C,wBAAgB,eAAe,IAAI,OAAO,aAAa,CAEtD;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMzD"}