@elizaos/autonomous 2.0.0-alpha.10

package/src/contracts/apps.ts

@@ -0,0 +1,46 @@
+/**
+ * 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;
+}

package/src/contracts/awareness.ts

@@ -0,0 +1,56 @@
+/**
+ * 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 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;
+
+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;
+}

package/src/contracts/config.ts

@@ -0,0 +1,172 @@
+/**
+ * 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;
+};

package/src/contracts/drop.ts

@@ -0,0 +1,21 @@
+/**
+ * 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;
+}

package/src/contracts/index.ts

@@ -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";