@elizaos/agent 0.25.8 → 2.0.0-alpha.83

package/packages/agent/src/config/zod-schema.session.d.ts

@@ -0,0 +1,183 @@
+import { z } from "zod";
+export declare const SessionSendPolicySchema: z.ZodOptional<z.ZodObject<{
+    default: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"allow">, z.ZodLiteral<"deny">]>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        action: z.ZodUnion<readonly [z.ZodLiteral<"allow">, z.ZodLiteral<"deny">]>;
+        match: z.ZodOptional<z.ZodObject<{
+            channel: z.ZodOptional<z.ZodString>;
+            chatType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"direct">, z.ZodLiteral<"group">, z.ZodLiteral<"channel">]>>;
+            keyPrefix: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>>;
+export declare const SessionSchema: z.ZodOptional<z.ZodObject<{
+    scope: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"per-sender">, z.ZodLiteral<"global">]>>;
+    dmScope: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"main">, z.ZodLiteral<"per-peer">, z.ZodLiteral<"per-channel-peer">, z.ZodLiteral<"per-account-channel-peer">]>>;
+    identityLinks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    resetTriggers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    idleMinutes: z.ZodOptional<z.ZodNumber>;
+    reset: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"daily">, z.ZodLiteral<"idle">]>>;
+        atHour: z.ZodOptional<z.ZodNumber>;
+        idleMinutes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    resetByType: z.ZodOptional<z.ZodObject<{
+        dm: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"daily">, z.ZodLiteral<"idle">]>>;
+            atHour: z.ZodOptional<z.ZodNumber>;
+            idleMinutes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        group: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"daily">, z.ZodLiteral<"idle">]>>;
+            atHour: z.ZodOptional<z.ZodNumber>;
+            idleMinutes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        thread: z.ZodOptional<z.ZodObject<{
+            mode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"daily">, z.ZodLiteral<"idle">]>>;
+            atHour: z.ZodOptional<z.ZodNumber>;
+            idleMinutes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    resetByChannel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        mode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"daily">, z.ZodLiteral<"idle">]>>;
+        atHour: z.ZodOptional<z.ZodNumber>;
+        idleMinutes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    store: z.ZodOptional<z.ZodString>;
+    typingIntervalSeconds: z.ZodOptional<z.ZodNumber>;
+    typingMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"never">, z.ZodLiteral<"instant">, z.ZodLiteral<"thinking">, z.ZodLiteral<"message">]>>;
+    mainKey: z.ZodOptional<z.ZodString>;
+    sendPolicy: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"allow">, z.ZodLiteral<"deny">]>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            action: z.ZodUnion<readonly [z.ZodLiteral<"allow">, z.ZodLiteral<"deny">]>;
+            match: z.ZodOptional<z.ZodObject<{
+                channel: z.ZodOptional<z.ZodString>;
+                chatType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"direct">, z.ZodLiteral<"group">, z.ZodLiteral<"channel">]>>;
+                keyPrefix: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    agentToAgent: z.ZodOptional<z.ZodObject<{
+        maxPingPongTurns: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>;
+export declare const MessagesSchema: z.ZodOptional<z.ZodObject<{
+    messagePrefix: z.ZodOptional<z.ZodString>;
+    responsePrefix: z.ZodOptional<z.ZodString>;
+    groupChat: z.ZodOptional<z.ZodObject<{
+        mentionPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        historyLimit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    queue: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"steer">, z.ZodLiteral<"followup">, z.ZodLiteral<"collect">, z.ZodLiteral<"steer-backlog">, z.ZodLiteral<"steer+backlog">, z.ZodLiteral<"queue">, z.ZodLiteral<"interrupt">]>>;
+        byChannel: z.ZodOptional<z.ZodObject<{
+            whatsapp: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"steer">, z.ZodLiteral<"followup">, z.ZodLiteral<"collect">, z.ZodLiteral<"steer-backlog">, z.ZodLiteral<"steer+backlog">, z.ZodLiteral<"queue">, z.ZodLiteral<"interrupt">]>>;
+            telegram: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"steer">, z.ZodLiteral<"followup">, z.ZodLiteral<"collect">, z.ZodLiteral<"steer-backlog">, z.ZodLiteral<"steer+backlog">, z.ZodLiteral<"queue">, z.ZodLiteral<"interrupt">]>>;
+            discord: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"steer">, z.ZodLiteral<"followup">, z.ZodLiteral<"collect">, z.ZodLiteral<"steer-backlog">, z.ZodLiteral<"steer+backlog">, z.ZodLiteral<"queue">, z.ZodLiteral<"interrupt">]>>;
+            slack: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"steer">, z.ZodLiteral<"followup">, z.ZodLiteral<"collect">, z.ZodLiteral<"steer-backlog">, z.ZodLiteral<"steer+backlog">, z.ZodLiteral<"queue">, z.ZodLiteral<"interrupt">]>>;
+            mattermost: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"steer">, z.ZodLiteral<"followup">, z.ZodLiteral<"collect">, z.ZodLiteral<"steer-backlog">, z.ZodLiteral<"steer+backlog">, z.ZodLiteral<"queue">, z.ZodLiteral<"interrupt">]>>;
+            signal: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"steer">, z.ZodLiteral<"followup">, z.ZodLiteral<"collect">, z.ZodLiteral<"steer-backlog">, z.ZodLiteral<"steer+backlog">, z.ZodLiteral<"queue">, z.ZodLiteral<"interrupt">]>>;
+            imessage: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"steer">, z.ZodLiteral<"followup">, z.ZodLiteral<"collect">, z.ZodLiteral<"steer-backlog">, z.ZodLiteral<"steer+backlog">, z.ZodLiteral<"queue">, z.ZodLiteral<"interrupt">]>>;
+            msteams: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"steer">, z.ZodLiteral<"followup">, z.ZodLiteral<"collect">, z.ZodLiteral<"steer-backlog">, z.ZodLiteral<"steer+backlog">, z.ZodLiteral<"queue">, z.ZodLiteral<"interrupt">]>>;
+            webchat: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"steer">, z.ZodLiteral<"followup">, z.ZodLiteral<"collect">, z.ZodLiteral<"steer-backlog">, z.ZodLiteral<"steer+backlog">, z.ZodLiteral<"queue">, z.ZodLiteral<"interrupt">]>>;
+        }, z.core.$strict>>;
+        debounceMs: z.ZodOptional<z.ZodNumber>;
+        debounceMsByChannel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        cap: z.ZodOptional<z.ZodNumber>;
+        drop: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"old">, z.ZodLiteral<"new">, z.ZodLiteral<"summarize">]>>;
+    }, z.core.$strict>>;
+    inbound: z.ZodOptional<z.ZodObject<{
+        debounceMs: z.ZodOptional<z.ZodNumber>;
+        byChannel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    }, z.core.$strict>>;
+    ackReaction: z.ZodOptional<z.ZodString>;
+    ackReactionScope: z.ZodOptional<z.ZodEnum<{
+        direct: "direct";
+        all: "all";
+        "group-mentions": "group-mentions";
+        "group-all": "group-all";
+    }>>;
+    removeAckAfterReply: z.ZodOptional<z.ZodBoolean>;
+    tts: z.ZodOptional<z.ZodObject<{
+        auto: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            always: "always";
+            inbound: "inbound";
+            tagged: "tagged";
+        }>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            final: "final";
+        }>>;
+        provider: z.ZodOptional<z.ZodEnum<{
+            openai: "openai";
+            elevenlabs: "elevenlabs";
+            edge: "edge";
+        }>>;
+        summaryModel: z.ZodOptional<z.ZodString>;
+        modelOverrides: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            allowText: z.ZodOptional<z.ZodBoolean>;
+            allowProvider: z.ZodOptional<z.ZodBoolean>;
+            allowVoice: z.ZodOptional<z.ZodBoolean>;
+            allowModelId: z.ZodOptional<z.ZodBoolean>;
+            allowVoiceSettings: z.ZodOptional<z.ZodBoolean>;
+            allowNormalization: z.ZodOptional<z.ZodBoolean>;
+            allowSeed: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        elevenlabs: z.ZodOptional<z.ZodObject<{
+            apiKey: z.ZodOptional<z.ZodString>;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            voiceId: z.ZodOptional<z.ZodString>;
+            modelId: z.ZodOptional<z.ZodString>;
+            seed: z.ZodOptional<z.ZodNumber>;
+            applyTextNormalization: z.ZodOptional<z.ZodEnum<{
+                off: "off";
+                auto: "auto";
+                on: "on";
+            }>>;
+            languageCode: z.ZodOptional<z.ZodString>;
+            voiceSettings: z.ZodOptional<z.ZodObject<{
+                stability: z.ZodOptional<z.ZodNumber>;
+                similarityBoost: z.ZodOptional<z.ZodNumber>;
+                style: z.ZodOptional<z.ZodNumber>;
+                useSpeakerBoost: z.ZodOptional<z.ZodBoolean>;
+                speed: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        openai: z.ZodOptional<z.ZodObject<{
+            apiKey: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            voice: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        edge: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            voice: z.ZodOptional<z.ZodString>;
+            lang: z.ZodOptional<z.ZodString>;
+            outputFormat: z.ZodOptional<z.ZodString>;
+            pitch: z.ZodOptional<z.ZodString>;
+            rate: z.ZodOptional<z.ZodString>;
+            volume: z.ZodOptional<z.ZodString>;
+            saveSubtitles: z.ZodOptional<z.ZodBoolean>;
+            proxy: z.ZodOptional<z.ZodString>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        prefsPath: z.ZodOptional<z.ZodString>;
+        maxTextLength: z.ZodOptional<z.ZodNumber>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>;
+export declare const CommandsSchema: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    native: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>>;
+    nativeSkills: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"auto">]>>>;
+    text: z.ZodOptional<z.ZodBoolean>;
+    bash: z.ZodOptional<z.ZodBoolean>;
+    bashForegroundMs: z.ZodOptional<z.ZodNumber>;
+    config: z.ZodOptional<z.ZodBoolean>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    restart: z.ZodOptional<z.ZodBoolean>;
+    useAccessGroups: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>>>;
+//# sourceMappingURL=zod-schema.session.d.ts.map

package/packages/agent/src/config/zod-schema.session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-schema.session.d.ts","sourceRoot":"","sources":["../../../../../src/config/zod-schema.session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB,eAAO,MAAM,uBAAuB;;;;;;;;;;mBAAsB,CAAC;AAE3D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBA4Cb,CAAC;AAEd,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAed,CAAC;AAEd,eAAO,MAAM,cAAc;;;;;;;;;;oBAcyB,CAAC"}

package/packages/agent/src/config/zod-schema.session.js

@@ -0,0 +1,86 @@
+import { z } from "zod";
+import { GroupChatSchema, InboundDebounceSchema, MessagePolicySchema, NativeCommandsSettingSchema, QueueSchema, TtsConfigSchema, } from "./zod-schema.core";
+const SessionResetConfigSchema = z
+    .object({
+    mode: z.union([z.literal("daily"), z.literal("idle")]).optional(),
+    atHour: z.number().int().min(0).max(23).optional(),
+    idleMinutes: z.number().int().positive().optional(),
+})
+    .strict();
+export const SessionSendPolicySchema = MessagePolicySchema;
+export const SessionSchema = z
+    .object({
+    scope: z.union([z.literal("per-sender"), z.literal("global")]).optional(),
+    dmScope: z
+        .union([
+        z.literal("main"),
+        z.literal("per-peer"),
+        z.literal("per-channel-peer"),
+        z.literal("per-account-channel-peer"),
+    ])
+        .optional(),
+    identityLinks: z.record(z.string(), z.array(z.string())).optional(),
+    resetTriggers: z.array(z.string()).optional(),
+    idleMinutes: z.number().int().positive().optional(),
+    reset: SessionResetConfigSchema.optional(),
+    resetByType: z
+        .object({
+        dm: SessionResetConfigSchema.optional(),
+        group: SessionResetConfigSchema.optional(),
+        thread: SessionResetConfigSchema.optional(),
+    })
+        .strict()
+        .optional(),
+    resetByChannel: z.record(z.string(), SessionResetConfigSchema).optional(),
+    store: z.string().optional(),
+    typingIntervalSeconds: z.number().int().positive().optional(),
+    typingMode: z
+        .union([
+        z.literal("never"),
+        z.literal("instant"),
+        z.literal("thinking"),
+        z.literal("message"),
+    ])
+        .optional(),
+    mainKey: z.string().optional(),
+    sendPolicy: SessionSendPolicySchema.optional(),
+    agentToAgent: z
+        .object({
+        maxPingPongTurns: z.number().int().min(0).max(5).optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict()
+    .optional();
+export const MessagesSchema = z
+    .object({
+    messagePrefix: z.string().optional(),
+    responsePrefix: z.string().optional(),
+    groupChat: GroupChatSchema,
+    queue: QueueSchema,
+    inbound: InboundDebounceSchema,
+    ackReaction: z.string().optional(),
+    ackReactionScope: z
+        .enum(["group-mentions", "group-all", "direct", "all"])
+        .optional(),
+    removeAckAfterReply: z.boolean().optional(),
+    tts: TtsConfigSchema,
+})
+    .strict()
+    .optional();
+export const CommandsSchema = z
+    .object({
+    native: NativeCommandsSettingSchema.optional().default("auto"),
+    nativeSkills: NativeCommandsSettingSchema.optional().default("auto"),
+    text: z.boolean().optional(),
+    bash: z.boolean().optional(),
+    bashForegroundMs: z.number().int().min(0).max(30_000).optional(),
+    config: z.boolean().optional(),
+    debug: z.boolean().optional(),
+    restart: z.boolean().optional(),
+    useAccessGroups: z.boolean().optional(),
+})
+    .strict()
+    .optional()
+    .default({ native: "auto", nativeSkills: "auto" });

package/packages/agent/src/contracts/apps.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Shared app manager contracts.
+ */
+export interface AppViewerAuthMessage {
+    type: string;
+    authToken?: string;
+    characterId?: string;
+    sessionToken?: string;
+    agentId?: string;
+}
+export interface AppViewerConfig {
+    url: string;
+    embedParams?: Record<string, string>;
+    postMessageAuth?: boolean;
+    sandbox?: string;
+    authMessage?: AppViewerAuthMessage;
+}
+export interface AppLaunchResult {
+    pluginInstalled: boolean;
+    needsRestart: boolean;
+    displayName: string;
+    launchType: string;
+    launchUrl: string | null;
+    viewer: AppViewerConfig | null;
+}
+export interface InstalledAppInfo {
+    name: string;
+    displayName: string;
+    pluginName: string;
+    version: string;
+    installedAt: string;
+}
+export interface AppStopResult {
+    success: boolean;
+    appName: string;
+    stoppedAt: string;
+    pluginUninstalled: boolean;
+    needsRestart: boolean;
+    stopScope: "plugin-uninstalled" | "viewer-session" | "no-op";
+    message: string;
+}
+//# sourceMappingURL=apps.d.ts.map

package/packages/agent/src/contracts/apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../../../../src/contracts/apps.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,oBAAoB,GAAG,gBAAgB,GAAG,OAAO,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/packages/agent/src/contracts/apps.js

@@ -0,0 +1,4 @@
+/**
+ * Shared app manager contracts.
+ */
+export {};

package/packages/agent/src/contracts/awareness.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Self-Awareness System v1 — shared contracts.
+ *
+ * @architecture Layered lazy-load + declarative AwarenessContributor
+ * @see docs/plans/2026-03-01-self-awareness-design.md
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+export declare const SELF_STATUS_SCHEMA_VERSION = 1;
+/** Max chars for a single contributor summary line. */
+export declare const SUMMARY_CHAR_LIMIT = 80;
+/** Max total chars for the composed Layer 1 output (~300 tokens). */
+export declare const SUMMARY_TOTAL_CHAR_LIMIT = 1200;
+/** Default cache TTL in ms (1 minute). */
+export declare const DEFAULT_CACHE_TTL_MS = 60000;
+export type AwarenessInvalidationEvent = "permission-changed" | "plugin-changed" | "wallet-updated" | "provider-changed" | "config-changed" | "runtime-restarted" | "opinion-updated";
+export interface AwarenessContributor {
+    /** Unique identifier, e.g. "wallet", "permissions". */
+    id: string;
+    /** Sort priority (lower = higher in output).
+     *  10=runtime, 20=permissions, 30=wallet, 40=provider,
+     *  50=pluginHealth, 60=connectors, 70=cloud, 80=features */
+    position: number;
+    /** Layer 1 summary — injected every LLM turn.
+     *  MUST return plain text, never secrets/keys/tokens.
+     *  MUST be <= SUMMARY_CHAR_LIMIT chars. Return "" if nothing to show. */
+    summary: (runtime: IAgentRuntime) => Promise<string>;
+    /** Layer 2 detail — called via GET_SELF_STATUS action.
+     *  "brief" ~= 200 tokens, "full" ~= 2000 tokens. */
+    detail?: (runtime: IAgentRuntime, level: "brief" | "full") => Promise<string>;
+    /** Cache TTL in ms. Default DEFAULT_CACHE_TTL_MS. */
+    cacheTtl?: number;
+    /** Events that proactively clear the cache (don't wait for TTL). */
+    invalidateOn?: AwarenessInvalidationEvent[];
+    /** Only built-in contributors set trusted=true.
+     *  Untrusted contributor output is sanitized before injection. */
+    trusted?: boolean;
+}
+//# sourceMappingURL=awareness.d.ts.map

package/packages/agent/src/contracts/awareness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../../../../src/contracts/awareness.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C,MAAM,MAAM,0BAA0B,GAClC,oBAAoB,GACpB,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,GACnB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IAEX;;gEAE4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IAEjB;;6EAEyE;IACzE,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAErD;wDACoD;IACpD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9E,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oEAAoE;IACpE,YAAY,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAE5C;sEACkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/packages/agent/src/contracts/awareness.js

@@ -0,0 +1,7 @@
+export const SELF_STATUS_SCHEMA_VERSION = 1;
+/** Max chars for a single contributor summary line. */
+export const SUMMARY_CHAR_LIMIT = 80;
+/** Max total chars for the composed Layer 1 output (~300 tokens). */
+export const SUMMARY_TOTAL_CHAR_LIMIT = 1200;
+/** Default cache TTL in ms (1 minute). */
+export const DEFAULT_CACHE_TTL_MS = 60_000;

package/packages/agent/src/contracts/config.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Shared configuration contracts used across runtime, server, and app client.
+ */
+export type DatabaseProviderType = "pglite" | "postgres";
+export type MediaMode = "cloud" | "own-key";
+export type ImageProvider = "cloud" | "fal" | "openai" | "google" | "xai";
+export type ImageFalConfig = {
+    apiKey?: string;
+    model?: string;
+    baseUrl?: string;
+};
+export type ImageOpenaiConfig = {
+    apiKey?: string;
+    model?: string;
+    quality?: "standard" | "hd";
+    style?: "natural" | "vivid";
+};
+export type ImageGoogleConfig = {
+    apiKey?: string;
+    model?: string;
+    aspectRatio?: string;
+};
+export type ImageXaiConfig = {
+    apiKey?: string;
+    model?: string;
+};
+export type ImageConfig = {
+    enabled?: boolean;
+    mode?: MediaMode;
+    provider?: ImageProvider;
+    defaultSize?: string;
+    fal?: ImageFalConfig;
+    openai?: ImageOpenaiConfig;
+    google?: ImageGoogleConfig;
+    xai?: ImageXaiConfig;
+};
+export type VideoProvider = "cloud" | "fal" | "openai" | "google";
+export type VideoFalConfig = {
+    apiKey?: string;
+    model?: string;
+    baseUrl?: string;
+};
+export type VideoOpenaiConfig = {
+    apiKey?: string;
+    model?: string;
+};
+export type VideoGoogleConfig = {
+    apiKey?: string;
+    model?: string;
+};
+export type VideoConfig = {
+    enabled?: boolean;
+    mode?: MediaMode;
+    provider?: VideoProvider;
+    defaultDuration?: number;
+    fal?: VideoFalConfig;
+    openai?: VideoOpenaiConfig;
+    google?: VideoGoogleConfig;
+};
+export type AudioGenProvider = "cloud" | "suno" | "elevenlabs";
+export type AudioSunoConfig = {
+    apiKey?: string;
+    model?: string;
+    baseUrl?: string;
+};
+export type AudioElevenlabsSfxConfig = {
+    apiKey?: string;
+    duration?: number;
+};
+export type AudioGenConfig = {
+    enabled?: boolean;
+    mode?: MediaMode;
+    provider?: AudioGenProvider;
+    suno?: AudioSunoConfig;
+    elevenlabs?: AudioElevenlabsSfxConfig;
+};
+export type VisionProvider = "cloud" | "openai" | "google" | "anthropic" | "xai" | "ollama";
+export type VisionOpenaiConfig = {
+    apiKey?: string;
+    model?: string;
+    maxTokens?: number;
+};
+export type VisionGoogleConfig = {
+    apiKey?: string;
+    model?: string;
+};
+export type VisionAnthropicConfig = {
+    apiKey?: string;
+    model?: string;
+};
+export type VisionXaiConfig = {
+    apiKey?: string;
+    model?: string;
+};
+export type VisionOllamaConfig = {
+    baseUrl?: string;
+    model?: string;
+    maxTokens?: number;
+    autoDownload?: boolean;
+};
+export type VisionConfig = {
+    enabled?: boolean;
+    mode?: MediaMode;
+    provider?: VisionProvider;
+    openai?: VisionOpenaiConfig;
+    google?: VisionGoogleConfig;
+    anthropic?: VisionAnthropicConfig;
+    xai?: VisionXaiConfig;
+    ollama?: VisionOllamaConfig;
+};
+export type MediaConfig = {
+    image?: ImageConfig;
+    video?: VideoConfig;
+    audio?: AudioGenConfig;
+    vision?: VisionConfig;
+};
+export type ReleaseChannel = "stable" | "beta" | "nightly";
+export type CustomActionHandler = {
+    type: "http";
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    bodyTemplate?: string;
+} | {
+    type: "shell";
+    command: string;
+} | {
+    type: "code";
+    code: string;
+};
+export type CustomActionDef = {
+    id: string;
+    name: string;
+    description: string;
+    similes?: string[];
+    parameters: Array<{
+        name: string;
+        description: string;
+        required: boolean;
+    }>;
+    handler: CustomActionHandler;
+    enabled: boolean;
+    createdAt: string;
+    updatedAt: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/packages/agent/src/contracts/config.d.ts.map

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

package/packages/agent/src/contracts/config.js

@@ -0,0 +1,4 @@
+/**
+ * Shared configuration contracts used across runtime, server, and app client.
+ */
+export {};

package/packages/agent/src/contracts/drop.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared drop/mint API contracts.
+ */
+export interface DropStatus {
+    dropEnabled: boolean;
+    publicMintOpen: boolean;
+    whitelistMintOpen: boolean;
+    mintedOut: boolean;
+    currentSupply: number;
+    maxSupply: number;
+    shinyPrice: string;
+    userHasMinted: boolean;
+}
+export interface MintResult {
+    agentId: number;
+    mintNumber: number;
+    txHash: string;
+    isShiny: boolean;
+}
+//# sourceMappingURL=drop.d.ts.map

package/packages/agent/src/contracts/drop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop.d.ts","sourceRoot":"","sources":["../../../../../src/contracts/drop.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/packages/agent/src/contracts/drop.js

@@ -0,0 +1,4 @@
+/**
+ * Shared drop/mint API contracts.
+ */
+export {};

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

@@ -0,0 +1,9 @@
+export * from "./apps";
+export * from "./awareness";
+export * from "./config";
+export * from "./drop";
+export * from "./onboarding";
+export * from "./permissions";
+export * from "./verification";
+export * from "./wallet";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}

package/packages/agent/src/contracts/index.js

@@ -0,0 +1,8 @@
+export * from "./apps";
+export * from "./awareness";
+export * from "./config";
+export * from "./drop";
+export * from "./onboarding";
+export * from "./permissions";
+export * from "./verification";
+export * from "./wallet";