@elizaos/agent 2.0.0-alpha.144 → 2.0.0-alpha.152

package/packages/typescript/src/features/orchestrator/actions/start-coding-task.js

@@ -1,270 +0,0 @@
-/**
- * CREATE_TASK action - Unified action to set up and launch task agents.
- *
- * Combines workspace provisioning and agent spawning into a single atomic action.
- * - If a repo URL is provided, clones it into a fresh workspace
- * - If no repo, creates a scratch sandbox directory
- * - Spawns the specified task agent(s) in that workspace with the given task
- * - Supports multi-agent mode via pipe-delimited `agents` param
- *
- * This eliminates the need for multi-action chaining (PROVISION_WORKSPACE -> SPAWN_AGENT)
- * and ensures agents always run in an isolated directory.
- *
- * @module actions/start-coding-task
- */
-import { logger, } from "@elizaos/core";
-import { buildAgentCredentials, isAnthropicOAuthToken, sanitizeCustomCredentials, } from "../services/agent-credentials.js";
-import { getCoordinator } from "../services/pty-service.js";
-import { normalizeAgentType } from "../services/pty-types.js";
-import { normalizeRepositoryInput } from "../services/repo-input.js";
-import { requireTaskAgentAccess } from "../services/task-policy.js";
-import { handleMultiAgent, } from "./coding-task-handlers.js";
-export const startCodingTaskAction = {
-    name: "CREATE_TASK",
-    similes: [
-        "START_CODING_TASK",
-        "LAUNCH_CODING_TASK",
-        "RUN_CODING_TASK",
-        "START_AGENT_TASK",
-        "SPAWN_AND_PROVISION",
-        "CODE_THIS",
-        "LAUNCH_TASK",
-        "CREATE_SUBTASK",
-    ],
-    description: "Create one or more asynchronous task agents for any open-ended multi-step job. " +
-        "These task agents can code, debug, research, write, analyze, plan, document, and automate while the main agent stays free to keep talking with the user. " +
-        "If a repo URL is provided, a workspace is provisioned automatically; if no repo is provided, the task agent runs in a safe scratch directory. " +
-        "Use this whenever the work is more involved than a simple direct reply. " +
-        "IMPORTANT: If the user references a repository from conversation history (e.g. 'in the same repo', " +
-        "'on that project', 'add a feature to it'), you MUST include the repo URL in the `repo` parameter. " +
-        "If the task involves code changes to a real project but you don't know the repo URL, ASK the user for it " +
-        "before calling this action — do not default to a scratch directory for real project work.",
-    suppressPostActionContinuation: true,
-    examples: [
-        [
-            {
-                name: "{{user1}}",
-                content: {
-                    text: "Take a deep pass on https://github.com/acme/my-app: debug the auth failure, fix it, run the tests, and summarize what changed.",
-                },
-            },
-            {
-                name: "{{agentName}}",
-                content: {
-                    text: "I'll create a background task agent for that repo and keep track of its progress.",
-                    action: "CREATE_TASK",
-                },
-            },
-        ],
-        [
-            {
-                name: "{{user1}}",
-                content: {
-                    text: "Spin up a couple of sub-agents to research current browser automation frameworks, compare them, and draft a recommendation.",
-                },
-            },
-            {
-                name: "{{agentName}}",
-                content: {
-                    text: "I'll coordinate parallel task agents for that and keep the results organized.",
-                    action: "CREATE_TASK",
-                },
-            },
-        ],
-    ],
-    validate: async (runtime, _message) => {
-        const ptyService = runtime.getService("PTY_SERVICE");
-        return ptyService != null;
-    },
-    handler: async (runtime, message, state, options, callback) => {
-        const access = await requireTaskAgentAccess(runtime, message, "create");
-        if (access.allowed === false) {
-            if (callback) {
-                await callback({
-                    text: access.reason,
-                });
-            }
-            return { success: false, error: "FORBIDDEN", text: access.reason };
-        }
-        const ptyService = runtime.getService("PTY_SERVICE");
-        if (!ptyService) {
-            if (callback) {
-                await callback({
-                    text: "PTY Service is not available. Cannot create the task.",
-                });
-            }
-            return { success: false, error: "SERVICE_UNAVAILABLE" };
-        }
-        const wsService = runtime.getService("CODING_WORKSPACE_SERVICE");
-        // Extract parameters
-        const params = options?.parameters;
-        const content = message.content;
-        const explicitRawType = params?.agentType ?? content.agentType;
-        const memoryContent = params?.memoryContent ?? content.memoryContent;
-        const approvalPreset = params?.approvalPreset ?? content.approvalPreset;
-        // Repo is optional -- extract from params, content, or text
-        let repo = params?.repo ?? content.repo;
-        if (!repo && content.text) {
-            const urlMatch = content.text.match(/https?:\/\/(?:github\.com|gitlab\.com|bitbucket\.org)\/[\w.-]+\/[\w.-]+(?:\.git)?/i);
-            if (urlMatch) {
-                repo = urlMatch[0];
-            }
-        }
-        // Fallback chain: coordinator memory → disk history → workspace service.
-        // Only use these fallbacks when the request implies working on an existing
-        // project (e.g. "in the same repo", "continue", "fix this") rather than a
-        // fresh scratch task. The reuseRepo flag or same-project language triggers it.
-        const reuseRepo = params?.reuseRepo ??
-            content.reuseRepo ??
-            // Implicit intent: task text references an existing context
-            /\b(same\s+repo|same\s+project|continue|that\s+repo|the\s+repo|this\s+repo|in\s+the\s+repo)\b/i.test(content.text ?? "");
-        if (!repo && reuseRepo) {
-            const coordinator = getCoordinator(runtime);
-            const lastRepo = await coordinator?.getLastUsedRepoAsync();
-            if (lastRepo) {
-                repo = lastRepo;
-            }
-        }
-        if (!repo && reuseRepo) {
-            const wsService = runtime.getService("CODING_WORKSPACE_SERVICE");
-            if (wsService && typeof wsService.listWorkspaces === "function") {
-                const withRepo = wsService.listWorkspaces().find((ws) => ws.repo);
-                if (withRepo) {
-                    repo = withRepo.repo;
-                }
-            }
-        }
-        if (repo) {
-            repo = normalizeRepositoryInput(repo);
-        }
-        const selectionTask = params?.task ??
-            content.task ??
-            content.text;
-        const rawAgentType = explicitRawType ??
-            (await ptyService.resolveAgentType({
-                task: selectionTask,
-                repo,
-                subtaskCount: typeof params?.agents === "string" ||
-                    typeof content.agents === "string"
-                    ? (params?.agents ?? content.agents)
-                        .split("|")
-                        .map((value) => value.trim())
-                        .filter(Boolean).length || 1
-                    : 1,
-            }));
-        const defaultAgentType = normalizeAgentType(rawAgentType);
-        // Build credentials (shared across all agents)
-        const customCredentialKeys = runtime.getSetting("CUSTOM_CREDENTIAL_KEYS");
-        let customCredentials;
-        if (customCredentialKeys) {
-            customCredentials = {};
-            for (const key of customCredentialKeys.split(",").map((k) => k.trim())) {
-                const val = runtime.getSetting(key);
-                if (val)
-                    customCredentials[key] = val;
-            }
-        }
-        const rawAnthropicKey = runtime.getSetting("ANTHROPIC_API_KEY");
-        customCredentials = sanitizeCustomCredentials(customCredentials, isAnthropicOAuthToken(rawAnthropicKey) ? [rawAnthropicKey] : []);
-        let credentials;
-        try {
-            credentials = buildAgentCredentials(runtime);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : "Failed to build credentials";
-            logger.error(`[start-coding-task] ${msg}`);
-            if (callback) {
-                await callback({ text: msg });
-            }
-            return { success: false, error: "INVALID_CREDENTIALS" };
-        }
-        const explicitLabel = params?.label ?? content.label;
-        // Build shared context for handlers
-        const ctx = {
-            runtime,
-            ptyService,
-            wsService,
-            credentials,
-            customCredentials,
-            callback,
-            message,
-            state,
-            repo,
-            defaultAgentType,
-            rawAgentType,
-            agentTypeExplicit: Boolean(explicitRawType),
-            agentSelectionStrategy: ptyService.agentSelectionStrategy,
-            memoryContent,
-            approvalPreset,
-            explicitLabel,
-        };
-        // --- Dispatch: build a pipe-delimited agents string for handleMultiAgent ---
-        const agentsParam = params?.agents ?? content.agents;
-        if (agentsParam) {
-            return handleMultiAgent(ctx, agentsParam);
-        }
-        // Single-agent mode: build a single-element agents string so we can
-        // reuse handleMultiAgent (which handles length-1 specs fine).
-        // Fall back to the user's message text when params extraction fails —
-        // the user's request IS the task (e.g. "build me a todo app").
-        const task = params?.task ?? content.task;
-        const userText = content.text?.trim() || "";
-        const singleAgentSpec = task || userText;
-        return handleMultiAgent(ctx, singleAgentSpec);
-    },
-    parameters: [
-        {
-            name: "repo",
-            description: "Git repository to clone (e.g. https://github.com/owner/repo or owner/repo). " +
-                "ALWAYS provide this when the user is working on a real project or references a repo from context. " +
-                "Only omit for pure research/scratch tasks with no target repository. " +
-                "If unsure which repo, ask the user before spawning.",
-            required: false,
-            schema: { type: "string" },
-        },
-        {
-            name: "agentType",
-            description: "Specific task-agent framework to use. Options: claude, codex, gemini, aider, pi, shell. " +
-                "If omitted, the orchestrator picks the current preferred framework automatically.",
-            required: false,
-            schema: { type: "string" },
-        },
-        {
-            name: "task",
-            description: "The open-ended task or prompt to send once the task agent is ready. Used for single-agent mode.",
-            required: false,
-            schema: { type: "string" },
-        },
-        {
-            name: "agents",
-            description: "Pipe-delimited list of task-agent assignments for multi-agent mode. Each segment is a task description. " +
-                "Optionally prefix with an agent type: 'claude:Fix auth | gemini:Write tests | codex:Update docs'. " +
-                "Each task agent gets its own workspace clone. If provided, the 'task' parameter is ignored.",
-            required: false,
-            schema: { type: "string" },
-        },
-        {
-            name: "memoryContent",
-            description: "Instructions or shared context to write to each task agent's memory file before spawning.",
-            required: false,
-            schema: { type: "string" },
-        },
-        {
-            name: "label",
-            description: "Short semantic label for this workspace. In multi-agent mode, each agent gets '{label}-1', '{label}-2', etc. " +
-                "Auto-generated from repo/task if not provided.",
-            required: false,
-            schema: { type: "string" },
-        },
-        {
-            name: "approvalPreset",
-            description: "Permission level for all task agents: readonly, standard, permissive, autonomous.",
-            required: false,
-            schema: {
-                type: "string",
-                enum: ["readonly", "standard", "permissive", "autonomous"],
-            },
-        },
-    ],
-};
-export const createTaskAction = startCodingTaskAction;

package/packages/typescript/src/features/orchestrator/actions/stop-agent.d.ts

@@ -1,12 +0,0 @@
-/**
- * STOP_AGENT action - Stop a running task-agent session.
- *
- * Terminates an active PTY session. Use when the agent is done,
- * stuck, or needs to be cancelled.
- *
- * @module actions/stop-agent
- */
-import { type Action } from "@elizaos/core";
-export declare const stopAgentAction: Action;
-export declare const stopTaskAgentAction: Action;
-//# sourceMappingURL=stop-agent.d.ts.map

package/packages/typescript/src/features/orchestrator/actions/stop-agent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stop-agent.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/orchestrator/actions/stop-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACN,KAAK,MAAM,EAQX,MAAM,eAAe,CAAC;AAIvB,eAAO,MAAM,eAAe,EAAE,MA0N7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAkB,CAAC"}

package/packages/typescript/src/features/orchestrator/actions/stop-agent.js

@@ -1,192 +0,0 @@
-/**
- * STOP_AGENT action - Stop a running task-agent session.
- *
- * Terminates an active PTY session. Use when the agent is done,
- * stuck, or needs to be cancelled.
- *
- * @module actions/stop-agent
- */
-import { logger, } from "@elizaos/core";
-import { requireTaskAgentAccess } from "../services/task-policy.js";
-export const stopAgentAction = {
-    name: "STOP_AGENT",
-    similes: [
-        "STOP_CODING_AGENT",
-        "KILL_CODING_AGENT",
-        "TERMINATE_AGENT",
-        "END_CODING_SESSION",
-        "CANCEL_AGENT",
-        "CANCEL_TASK_AGENT",
-        "STOP_SUB_AGENT",
-    ],
-    description: "Stop a running task-agent session. " +
-        "Terminates the PTY session and cleans up resources.",
-    examples: [
-        [
-            {
-                name: "{{user1}}",
-                content: { text: "Stop the task agent" },
-            },
-            {
-                name: "{{agentName}}",
-                content: {
-                    text: "I'll stop the task-agent session.",
-                    action: "STOP_AGENT",
-                },
-            },
-        ],
-        [
-            {
-                name: "{{user1}}",
-                content: { text: "Kill the stuck agent" },
-            },
-            {
-                name: "{{agentName}}",
-                content: {
-                    text: "Terminating the task agent.",
-                    action: "STOP_AGENT",
-                },
-            },
-        ],
-    ],
-    validate: async (runtime, _message) => {
-        const ptyService = runtime.getService("PTY_SERVICE");
-        if (!ptyService) {
-            return false;
-        }
-        try {
-            const sessions = await Promise.race([
-                ptyService.listSessions(),
-                new Promise((_, reject) => setTimeout(() => reject(new Error("validate timeout")), 2000)),
-            ]);
-            return sessions.length > 0;
-        }
-        catch {
-            return false;
-        }
-    },
-    handler: async (runtime, message, state, options, callback) => {
-        const access = await requireTaskAgentAccess(runtime, message, "interact");
-        if (access.allowed === false) {
-            if (callback) {
-                await callback({
-                    text: access.reason,
-                });
-            }
-            return { success: false, error: "FORBIDDEN", text: access.reason };
-        }
-        const ptyService = runtime.getService("PTY_SERVICE");
-        if (!ptyService) {
-            if (callback) {
-                await callback({
-                    text: "PTY Service is not available.",
-                });
-            }
-            return { success: false, error: "SERVICE_UNAVAILABLE" };
-        }
-        const params = options?.parameters;
-        const content = message.content;
-        // Stop all sessions if requested
-        if (params?.all ?? content.all) {
-            const sessions = await ptyService.listSessions();
-            if (sessions.length === 0) {
-                if (callback) {
-                    await callback({
-                        text: "No active task-agent sessions to stop.",
-                    });
-                }
-                return { success: true, text: "No sessions to stop" };
-            }
-            for (const session of sessions) {
-                try {
-                    await ptyService.stopSession(session.id);
-                }
-                catch (err) {
-                    logger.error(`Failed to stop session ${session.id}: ${err}`);
-                }
-            }
-            // Clear state
-            if (state?.codingSession) {
-                delete state.codingSession;
-            }
-            if (callback) {
-                await callback({
-                    text: `Stopped ${sessions.length} task-agent session(s).`,
-                });
-            }
-            return {
-                success: true,
-                text: `Stopped ${sessions.length} sessions`,
-                data: { stoppedCount: sessions.length },
-            };
-        }
-        // Stop specific session
-        let sessionId = params?.sessionId ?? content.sessionId;
-        if (!sessionId && state?.codingSession) {
-            sessionId = state.codingSession.id;
-        }
-        if (!sessionId) {
-            const sessions = await ptyService.listSessions();
-            if (sessions.length === 0) {
-                if (callback) {
-                    await callback({
-                        text: "No active task-agent sessions to stop.",
-                    });
-                }
-                return { success: true, text: "No sessions to stop" };
-            }
-            sessionId = sessions[sessions.length - 1].id;
-        }
-        const session = ptyService.getSession(sessionId);
-        if (!session) {
-            if (callback) {
-                await callback({
-                    text: `Session ${sessionId} not found.`,
-                });
-            }
-            return { success: false, error: "SESSION_NOT_FOUND" };
-        }
-        try {
-            await ptyService.stopSession(sessionId);
-            // Clear state if this was the current session
-            if (state?.codingSession &&
-                state.codingSession.id === sessionId) {
-                delete state.codingSession;
-            }
-            if (callback) {
-                await callback({
-                    text: `Stopped task-agent session ${sessionId}.`,
-                });
-            }
-            return {
-                success: true,
-                text: `Stopped session ${sessionId}`,
-                data: { sessionId, agentType: session.agentType },
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            if (callback) {
-                await callback({
-                    text: `Failed to stop agent: ${errorMessage}`,
-                });
-            }
-            return { success: false, error: errorMessage };
-        }
-    },
-    parameters: [
-        {
-            name: "sessionId",
-            description: "ID of the session to stop. If not specified, stops the current session.",
-            required: false,
-            schema: { type: "string" },
-        },
-        {
-            name: "all",
-            description: "If true, stop all active task-agent sessions.",
-            required: false,
-            schema: { type: "boolean" },
-        },
-    ],
-};
-export const stopTaskAgentAction = stopAgentAction;

package/packages/typescript/src/features/orchestrator/actions/task-control.d.ts

@@ -1,3 +0,0 @@
-import type { Action } from "@elizaos/core";
-export declare const taskControlAction: Action;
-//# sourceMappingURL=task-control.d.ts.map

package/packages/typescript/src/features/orchestrator/actions/task-control.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"task-control.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/orchestrator/actions/task-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,MAAM,EAON,MAAM,eAAe,CAAC;AA6CvB,eAAO,MAAM,iBAAiB,EAAE,MAiN/B,CAAC"}