@elizaos/ui 2.0.0-alpha.25 → 2.0.0-alpha.334

package/packages/typescript/src/features/advanced-planning/actions/chain-example.js

@@ -0,0 +1,181 @@
+import { v4 as uuidv4 } from "uuid";
+import { findKeywordTermMatch, getValidationKeywordTerms, } from "../../../i18n/validation-keywords.js";
+const CREATE_PLAN_TERMS = getValidationKeywordTerms("action.createPlan.request", {
+    includeAllLocales: true,
+});
+export const analyzeInputAction = {
+    name: "ANALYZE_INPUT",
+    description: "Analyzes user input and extracts key information",
+    validate: async (_runtime, _message) => true,
+    handler: async (_runtime, message, _state, options, _callback) => {
+        if (options?.abortSignal?.aborted) {
+            throw new Error("Analysis aborted");
+        }
+        const text = message.content.text || "";
+        const words = text.trim() ? text.split(/\s+/) : [];
+        const hasNumbers = /\d/.test(text);
+        const lowerText = text.toLowerCase();
+        const sentiment = lowerText.includes("urgent") ||
+            lowerText.includes("emergency") ||
+            lowerText.includes("critical")
+            ? "urgent"
+            : lowerText.includes("good")
+                ? "positive"
+                : lowerText.includes("bad")
+                    ? "negative"
+                    : "neutral";
+        const analysis = {
+            wordCount: words.length,
+            hasNumbers,
+            sentiment,
+            topics: words.filter((w) => w.length >= 5).map((w) => w.toLowerCase()),
+            timestamp: Date.now(),
+        };
+        return {
+            success: true,
+            data: analysis,
+            text: `Analyzed ${words.length} words with ${sentiment} sentiment`,
+        };
+    },
+};
+export const processAnalysisAction = {
+    name: "PROCESS_ANALYSIS",
+    description: "Processes the analysis results and makes decisions",
+    validate: async (_runtime, _message) => true,
+    handler: async (_runtime, _message, _state, options, _callback) => {
+        const previousResults = options?.previousResults ?? options?.actionContext?.previousResults;
+        const previousResult = previousResults?.[0];
+        if (!previousResult?.data) {
+            throw new Error("No analysis data available");
+        }
+        const data = previousResult.data;
+        const decisions = {
+            needsMoreInfo: data.wordCount < 5,
+            isComplex: data.wordCount > 20,
+            requiresAction: data.sentiment !== "neutral" || data.wordCount > 8,
+            suggestedResponse: data.sentiment === "positive"
+                ? "Thank you for the positive feedback!"
+                : data.sentiment === "negative"
+                    ? "I understand your concerns and will help address them."
+                    : "I can help you with that.",
+        };
+        await new Promise((resolve) => setTimeout(resolve, 200));
+        if (options?.abortSignal?.aborted) {
+            throw new Error("Processing aborted");
+        }
+        return {
+            success: true,
+            data: {
+                analysis: data,
+                decisions,
+                processedAt: Date.now(),
+                // Chain control flags stored in data for downstream access
+                shouldContinue: !decisions.needsMoreInfo,
+            },
+            text: decisions.suggestedResponse,
+            continueChain: !decisions.needsMoreInfo,
+        };
+    },
+};
+export const executeFinalAction = {
+    name: "EXECUTE_FINAL",
+    description: "Executes the final action based on processing results",
+    validate: async (_runtime, _message) => true,
+    handler: async (_runtime, _message, _state, options, callback) => {
+        const previousResults = options?.previousResults ?? options?.actionContext?.previousResults;
+        const processingResult = previousResults?.find((r) => r.data?.decisions !==
+            undefined);
+        const processingData = processingResult?.data;
+        if (!processingData?.decisions) {
+            throw new Error("No processing results available");
+        }
+        const execution = {
+            action: processingData.decisions.requiresAction
+                ? "RESPOND"
+                : "ACKNOWLEDGE",
+            message: processingData.decisions.suggestedResponse,
+            metadata: {
+                chainId: options?.chainContext?.chainId,
+                totalSteps: options?.chainContext?.totalActions,
+                completedAt: Date.now(),
+            },
+        };
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        if (callback) {
+            await callback({
+                text: execution.message,
+                source: "chain_example",
+            });
+        }
+        return {
+            success: true,
+            data: {
+                ...execution,
+                metadata: {
+                    chainId: String(execution.metadata.chainId || ""),
+                    totalSteps: Number(execution.metadata.totalSteps || 0),
+                    completedAt: Number(execution.metadata.completedAt || Date.now()),
+                },
+            },
+            text: execution.message,
+            cleanup: () => {
+                // eslint-disable-next-line no-console
+                console.log("[ChainExample] Cleaning up resources...");
+            },
+        };
+    },
+};
+export const createPlanAction = {
+    name: "CREATE_PLAN",
+    description: "Creates a comprehensive project plan with multiple phases and tasks",
+    similes: ["PLAN_PROJECT", "GENERATE_PLAN", "MAKE_PLAN", "PROJECT_PLAN"],
+    validate: async (_runtime, message) => {
+        const text = message.content.text?.trim() ?? "";
+        return findKeywordTermMatch(text, CREATE_PLAN_TERMS) !== undefined;
+    },
+    handler: async (_runtime, _message, _state, _options, callback) => {
+        const plan = {
+            id: uuidv4(),
+            name: "Comprehensive Project Plan",
+            description: "Multi-phase project plan with coordinated execution",
+            createdAt: Date.now(),
+            phases: [
+                {
+                    id: "phase_1",
+                    name: "Setup and Infrastructure",
+                    description: "Initial project setup and infrastructure creation",
+                    tasks: [
+                        {
+                            id: "task_1_1",
+                            name: "Repository Setup",
+                            description: "Create GitHub repository with proper documentation",
+                            action: "CREATE_GITHUB_REPO",
+                            dependencies: [],
+                            estimatedDuration: "30 minutes",
+                        },
+                    ],
+                },
+            ],
+            executionStrategy: "sequential",
+            totalEstimatedDuration: "4 hours",
+            successCriteria: ["All phases completed successfully"],
+        };
+        if (callback) {
+            await callback({
+                text: `I've created a comprehensive project plan with ${plan.phases.length} phase(s).`,
+                actions: ["CREATE_PLAN"],
+                source: "planning",
+            });
+        }
+        return {
+            success: true,
+            data: {
+                actionName: "CREATE_PLAN",
+                phaseCount: plan.phases.length,
+                taskCount: plan.phases.reduce((total, phase) => total + phase.tasks.length, 0),
+                planId: plan.id,
+            },
+            text: `Created ${plan.phases.length}-phase plan`,
+        };
+    },
+};

package/packages/typescript/src/features/advanced-planning/index.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from "../../types/index.ts";
+export declare function createAdvancedPlanningPlugin(): Plugin;
+export { PlanningService } from "./services/planning-service.ts";
+export * from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/packages/typescript/src/features/advanced-planning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../typescript/src/features/advanced-planning/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAUnD,wBAAgB,4BAA4B,IAAI,MAAM,CAcrD;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,cAAc,YAAY,CAAC"}

package/packages/typescript/src/features/advanced-planning/index.js

@@ -0,0 +1,20 @@
+import { analyzeInputAction, createPlanAction, executeFinalAction, processAnalysisAction, } from "./actions/chain-example.js";
+import { messageClassifierProvider } from "./providers/message-classifier.js";
+import { PlanningService } from "./services/planning-service.js";
+export function createAdvancedPlanningPlugin() {
+    return {
+        name: "advanced-planning",
+        description: "Built-in advanced planning and execution capabilities",
+        providers: [messageClassifierProvider],
+        actions: [
+            analyzeInputAction,
+            processAnalysisAction,
+            executeFinalAction,
+            createPlanAction,
+        ],
+        services: [PlanningService],
+        evaluators: [],
+    };
+}
+export { PlanningService } from "./services/planning-service.js";
+export * from "./types.js";

package/packages/typescript/src/features/advanced-planning/providers/message-classifier.d.ts

@@ -0,0 +1,3 @@
+import type { Provider } from "../../../types/index.ts";
+export declare const messageClassifierProvider: Provider;
+//# sourceMappingURL=message-classifier.d.ts.map

package/packages/typescript/src/features/advanced-planning/providers/message-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-classifier.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-planning/providers/message-classifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAKxD,eAAO,MAAM,yBAAyB,EAAE,QAoHvC,CAAC"}

package/packages/typescript/src/features/advanced-planning/providers/message-classifier.js

@@ -0,0 +1,105 @@
+import { messageClassifierTemplate } from "../../../prompts.js";
+import { ModelType } from "../../../types/index.js";
+import { composePrompt } from "../../../utils.js";
+export const messageClassifierProvider = {
+    name: "messageClassifier",
+    description: "Classifies messages by complexity and planning requirements",
+    get: async (runtime, message, _state) => {
+        const text = message.content.text || "";
+        if (!text.trim()) {
+            const data = {
+                classification: "general",
+                confidence: 0.1,
+                complexity: "simple",
+                planningRequired: false,
+                stakeholders: [],
+                constraints: [],
+            };
+            return {
+                text: "Message classified as: general (empty message)",
+                data,
+            };
+        }
+        try {
+            const classificationPrompt = composePrompt({
+                state: {
+                    text,
+                },
+                template: messageClassifierTemplate,
+            });
+            const response = await runtime.useModel(ModelType.TEXT_SMALL, {
+                prompt: classificationPrompt,
+                temperature: 0.3,
+                maxTokens: 300,
+            });
+            const responseText = String(response);
+            const lines = responseText.split("\n");
+            const fields = {};
+            for (const line of lines) {
+                const separatorIndex = line.indexOf(":");
+                if (separatorIndex === -1)
+                    continue;
+                const key = line.slice(0, separatorIndex).trim();
+                const value = line.slice(separatorIndex + 1).trim();
+                if (key) {
+                    fields[key] = value;
+                }
+            }
+            const parseField = (key) => {
+                const value = fields[key];
+                if (!value) {
+                    return [];
+                }
+                return value
+                    .split(",")
+                    .map((s) => s.trim())
+                    .filter((s) => s.length > 0);
+            };
+            const complexity = fields.COMPLEXITY || "simple";
+            const planningType = fields.PLANNING || "direct_action";
+            const confidenceStr = fields.CONFIDENCE || "0.5";
+            const confidence = Math.min(1.0, Math.max(0.0, Number.parseFloat(confidenceStr) || 0.5));
+            const capabilities = parseField("CAPABILITIES:");
+            const stakeholders = parseField("STAKEHOLDERS:");
+            const constraints = parseField("CONSTRAINTS:");
+            const dependencies = parseField("DEPENDENCIES:");
+            const planningRequired = planningType !== "direct_action" && complexity !== "simple";
+            const textLower = text.toLowerCase();
+            let messageClassification = "general";
+            if (textLower.includes("strategic") ||
+                planningType === "strategic_planning") {
+                messageClassification = "strategic";
+            }
+            else if (textLower.includes("analyz")) {
+                messageClassification = "analysis";
+            }
+            else if (textLower.includes("process")) {
+                messageClassification = "processing";
+            }
+            else if (textLower.includes("execute")) {
+                messageClassification = "execution";
+            }
+            const data = {
+                classification: messageClassification,
+                confidence,
+                originalText: text,
+                complexity,
+                planningType,
+                planningRequired,
+                capabilities,
+                stakeholders,
+                constraints,
+                dependencies,
+                analyzedAt: Date.now(),
+                modelUsed: "TEXT_SMALL",
+            };
+            return {
+                text: `Message classified as: ${messageClassification} (${complexity} complexity, ${planningType}) with confidence: ${confidence}`,
+                data,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to classify message: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    },
+};

package/packages/typescript/src/features/advanced-planning/services/planning-service.d.ts

@@ -0,0 +1,77 @@
+import { type ActionParameters, type ActionResult, type Content, type HandlerCallback, type IAgentRuntime, type Memory, Service, type State, type UUID } from "../../../types/index.ts";
+import type { JsonValue, PlanningContext, RetryPolicy } from "../types.ts";
+interface ActionStep {
+    id?: UUID;
+    actionName?: string;
+    status?: "pending" | "completed" | "failed";
+    error?: string;
+    result?: ActionResult;
+    parameters?: ActionParameters;
+    dependencies?: UUID[];
+    retryPolicy?: RetryPolicy;
+    onError?: "abort" | "continue" | "skip";
+    _dependencyStrings?: string[];
+}
+interface PlanState {
+    status: "pending" | "running" | "completed" | "failed" | "cancelled";
+    currentStepIndex?: number;
+    startTime?: number;
+    endTime?: number;
+    error?: string;
+}
+interface ActionPlan {
+    id?: UUID;
+    goal?: string;
+    thought: string;
+    totalSteps: number;
+    currentStep: number;
+    steps: ActionStep[];
+    executionModel?: "sequential" | "parallel" | "dag";
+    state?: PlanState;
+    metadata?: Record<string, JsonValue>;
+}
+interface PlanExecutionResult {
+    planId: UUID;
+    success: boolean;
+    completedSteps: number;
+    totalSteps: number;
+    results: ActionResult[];
+    errors?: Error[];
+    duration?: number;
+}
+export declare class PlanningService extends Service {
+    static serviceType: string;
+    serviceType: string;
+    capabilityDescription: string;
+    private activePlans;
+    private planExecutions;
+    static start(runtime: IAgentRuntime): Promise<PlanningService>;
+    createSimplePlan(_runtime: IAgentRuntime, message: Memory, _state: State, responseContent?: Content): Promise<ActionPlan | null>;
+    createComprehensivePlan(runtime: IAgentRuntime, context: PlanningContext, message?: Memory, state?: State): Promise<ActionPlan>;
+    executePlan(runtime: IAgentRuntime, plan: ActionPlan, message: Memory, callback?: HandlerCallback): Promise<PlanExecutionResult>;
+    validatePlan(runtime: IAgentRuntime, plan: ActionPlan): Promise<{
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+    }>;
+    adaptPlan(runtime: IAgentRuntime, plan: ActionPlan, currentStepIndex: number, results: ActionResult[], error?: Error): Promise<ActionPlan>;
+    getPlanStatus(planId: UUID): Promise<PlanState | null>;
+    cancelPlan(planId: UUID): Promise<boolean>;
+    stop(): Promise<void>;
+    private buildPlanningPrompt;
+    private parsePlanningResponse;
+    private enhancePlan;
+    private executeSequential;
+    private executeParallel;
+    private executeDAG;
+    private executeStep;
+    private detectCycles;
+    private buildActionLookup;
+    private buildDagExecutionOrder;
+    private pushReadyStep;
+    private popReadyStep;
+    private buildAdaptationPrompt;
+    private parseAdaptationResponse;
+}
+export {};
+//# sourceMappingURL=planning-service.d.ts.map

package/packages/typescript/src/features/advanced-planning/services/planning-service.d.ts.map

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