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

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

@@ -1,443 +0,0 @@
-/**
- * Handler logic for the START_CODING_TASK action.
- *
- * handleMultiAgent() handles both multi-agent and single-agent modes.
- * A single-agent call is just a length-1 agent spec.
- *
- * @module actions/coding-task-handlers
- */
-import { logger, ModelType, } from "@elizaos/core";
-import { readConfigEnvKey } from "../services/config-env.js";
-import { getCoordinator } from "../services/pty-service.js";
-import { isPiAgentType, normalizeAgentType, toPiCommand, } from "../services/pty-types.js";
-import { diagnoseWorkspaceBootstrapFailure } from "../services/repo-input.js";
-import { withTrajectoryContext } from "../services/trajectory-context.js";
-import { formatPastExperience, queryPastExperience, } from "../services/trajectory-feedback.js";
-import { createScratchDir, generateLabel, registerSessionEvents, } from "./coding-task-helpers.js";
-import { mergeTaskThreadEvalMetadata } from "./eval-metadata.js";
-/** Maximum number of agents that can be spawned in a single multi-agent call */
-const MAX_CONCURRENT_AGENTS = 8;
-/** Known agent type prefixes used in "agentType:task" spec format. */
-const KNOWN_AGENT_PREFIXES = [
-    "claude",
-    "claude-code",
-    "claudecode",
-    "codex",
-    "openai",
-    "gemini",
-    "google",
-    "aider",
-    "pi",
-    "piai",
-    "pi-coding-agent",
-    "picodingagent",
-    "shell",
-    "bash",
-];
-/**
- * Strip an agent-type prefix from a spec string (e.g. "claude:Fix the bug" → "Fix the bug").
- * Returns the original string if no known prefix is found.
- */
-function stripAgentPrefix(spec) {
-    const colonIdx = spec.indexOf(":");
-    if (colonIdx <= 0 || colonIdx >= 20)
-        return spec;
-    const prefix = spec.slice(0, colonIdx).trim().toLowerCase();
-    if (KNOWN_AGENT_PREFIXES.includes(prefix)) {
-        return spec.slice(colonIdx + 1).trim();
-    }
-    return spec;
-}
-/**
- * Build CLAUDE.md instructions that tell a swarm agent how to coordinate.
- * Each agent gets awareness of its role within the swarm and instructions
- * to surface design decisions explicitly so the orchestrator can share them.
- */
-function buildSwarmMemoryInstructions(agentLabel, agentTask, allSubtasks, agentIndex) {
-    const siblingTasks = allSubtasks
-        .filter((_, i) => i !== agentIndex)
-        .map((t, i) => `  ${i + 1}. ${t}`)
-        .join("\n");
-    return (`# Swarm Coordination\n\n` +
-        `You are agent "${agentLabel}" in a multi-agent swarm of ${allSubtasks.length} agents.\n` +
-        `Your task: ${agentTask}\n\n` +
-        `Other agents are working on:\n${siblingTasks}\n\n` +
-        `## Coordination Rules\n\n` +
-        `- **Follow the Shared Context exactly.** The planning brief above contains ` +
-        `concrete decisions (names, file paths, APIs, conventions). Use them as-is.\n` +
-        `- **Surface design decisions.** If you need to make a creative or architectural ` +
-        `choice not covered by the Shared Context (naming something, choosing a library, ` +
-        `designing an interface, picking an approach), state your decision clearly in your ` +
-        `output so the orchestrator can share it with sibling agents. Write it as:\n` +
-        `  "DECISION: [brief description of what you decided and why]"\n` +
-        `- **Don't contradict sibling work.** If the orchestrator tells you about decisions ` +
-        `other agents have made, align with them.\n` +
-        `- **Ask when uncertain.** If your task depends on another agent's output and you ` +
-        `don't have enough context, ask rather than guessing.\n`);
-}
-/**
- * Generate a shared context brief for a swarm of agents.
- * The LLM produces shared guidance (style, conventions, constraints) from
- * the user's request and subtask list. Task-type agnostic — works for coding,
- * research, writing, or any multi-agent workflow.
- */
-async function generateSwarmContext(runtime, subtasks, userRequest) {
-    const taskList = subtasks.map((t, i) => `  ${i + 1}. ${t}`).join("\n");
-    const prompt = `You are an AI orchestrator about to launch ${subtasks.length} parallel agents. ` +
-        `Before they start, produce a brief shared context document so all agents stay aligned.\n\n` +
-        `User's request: "${userRequest}"\n\n` +
-        `Subtasks being assigned:\n${taskList}\n\n` +
-        `Generate a concise shared context brief (3-10 bullet points) covering:\n` +
-        `- Project intent and overall goal\n` +
-        `- Key constraints or preferences from the user's request\n` +
-        `- Conventions all agents should follow (naming, style, patterns, tone)\n` +
-        `- How subtasks relate to each other (dependencies, shared interfaces, etc.)\n` +
-        `- Any decisions that should be consistent across all agents\n\n` +
-        `CRITICAL — Concrete Decisions:\n` +
-        `If any subtask involves creative choices (naming a feature, choosing an approach, ` +
-        `designing an API, picking a concept), YOU must make those decisions NOW in this brief. ` +
-        `Do NOT leave creative choices to individual agents — they run in parallel and will ` +
-        `each make different choices, causing inconsistency.\n` +
-        `For example: if one agent builds a feature and another writes tests for it, ` +
-        `decide the feature name, file paths, function signatures, and key design choices here ` +
-        `so both agents use the same names and structure.\n\n` +
-        `Only include what's relevant — skip categories that don't apply. ` +
-        `Be specific and actionable, not generic. Be as detailed as the task requires — ` +
-        `a trivial task needs a few bullets, a complex task deserves a thorough roadmap.\n\n` +
-        `Output ONLY the bullet points, no preamble.`;
-    try {
-        // Disable streaming so planning output doesn't pipe to the user's chat.
-        // The action handler runs inside a streaming context; without stream:false,
-        // the planning LLM response would be forwarded as chat text.
-        const result = await withTrajectoryContext(runtime, { source: "orchestrator", decisionType: "swarm-context-generation" }, () => runtime.useModel(ModelType.TEXT_SMALL, {
-            prompt,
-            temperature: 0.3,
-            stream: false,
-        }));
-        return result?.trim() || "";
-    }
-    catch (err) {
-        logger.warn(`Swarm context generation failed: ${err}`);
-        return "";
-    }
-}
-/**
- * Multi-agent mode handler.
- *
- * Parses pipe-delimited agent specs and spawns each agent in its own
- * workspace clone (or scratch directory).
- */
-export async function handleMultiAgent(ctx, agentsParam) {
-    const { runtime, ptyService, wsService, credentials, customCredentials, callback, message, state, repo, defaultAgentType, rawAgentType, agentTypeExplicit, memoryContent, approvalPreset, explicitLabel, } = ctx;
-    // Parse pipe-delimited agent specs: "task1 | task2 | agentType:task3"
-    // A single empty string means "spawn one agent with no initial task".
-    const agentSpecs = agentsParam
-        .split("|")
-        .map((s) => s.trim())
-        .filter(Boolean);
-    // If nothing parsed (e.g. empty string), treat as one agent with no task
-    if (agentSpecs.length === 0) {
-        agentSpecs.push("");
-    }
-    // Cap multi-agent count to the concurrency limit
-    if (agentSpecs.length > MAX_CONCURRENT_AGENTS) {
-        if (callback) {
-            await callback({
-                text: `Too many agents requested (${agentSpecs.length}). Maximum is ${MAX_CONCURRENT_AGENTS}.`,
-            });
-        }
-        return { success: false, error: "TOO_MANY_AGENTS" };
-    }
-    if (repo && !wsService) {
-        if (callback) {
-            await callback({
-                text: "Workspace Service is not available. Cannot clone repository.",
-            });
-        }
-        return { success: false, error: "WORKSPACE_SERVICE_UNAVAILABLE" };
-    }
-    // Skip the spawn callback — the LLM REPLY already says "on it" (character
-    // prompt ack rule) and the task-progress-streamer delivers the final
-    // result. Emitting "Launching N agents..." here duplicates the ack and
-    // spams discord. See eliza nubs/full-working-state clean Discord UX fix.
-    // Planning phase: generate shared context brief for multi-agent coordination.
-    // Strip agent-type prefixes from specs to get clean subtask descriptions.
-    const cleanSubtasks = agentSpecs.map(stripAgentPrefix);
-    const userRequest = message.content?.text ?? agentsParam;
-    const swarmContext = agentSpecs.length > 1
-        ? await generateSwarmContext(runtime, cleanSubtasks, userRequest)
-        : "";
-    // Store swarm context on coordinator for use in decision prompts
-    if (swarmContext) {
-        const coordinator = getCoordinator(runtime);
-        coordinator?.setSwarmContext(swarmContext);
-    }
-    // Query past orchestrator experience for trajectory feedback injection.
-    // This feeds lessons from previous agent sessions back into new agents,
-    // preventing repeated mistakes and maintaining consistency with past decisions.
-    const pastExperience = await queryPastExperience(runtime, {
-        taskDescription: userRequest,
-        lookbackHours: 48,
-        maxEntries: 8,
-        repo,
-    });
-    const pastExperienceBlock = formatPastExperience(pastExperience);
-    const results = [];
-    // Read LLM provider once before the spawn loop to avoid repeated sync I/O
-    // and ensure consistent provider selection across all agents in this swarm.
-    const llmProvider = readConfigEnvKey("PARALLAX_LLM_PROVIDER") || "subscription";
-    const coordinator = getCoordinator(runtime);
-    const threadTitle = explicitLabel || generateLabel(repo, userRequest);
-    const evalMetadata = mergeTaskThreadEvalMetadata(message, {
-        repo: repo ?? null,
-        messageId: message.id,
-        requestedAgents: agentSpecs.length,
-    });
-    const taskThread = coordinator
-        ? await coordinator.createTaskThread({
-            title: threadTitle,
-            originalRequest: userRequest,
-            roomId: message.roomId,
-            worldId: message.worldId,
-            ownerUserId: message.userId ?? message.entityId,
-            scenarioId: evalMetadata.scenarioId,
-            batchId: evalMetadata.batchId,
-            currentPlan: swarmContext && cleanSubtasks.length > 1
-                ? {
-                    sharedContext: swarmContext,
-                    subtasks: cleanSubtasks,
-                }
-                : { subtasks: cleanSubtasks },
-            metadata: evalMetadata.metadata,
-        })
-        : null;
-    const plannedAgents = await Promise.all(agentSpecs.map(async (spec, i) => {
-        let specAgentType = defaultAgentType;
-        let specPiRequested = isPiAgentType(rawAgentType);
-        let specRequestedType = rawAgentType;
-        let specTask = spec;
-        let hasExplicitPrefix = false;
-        const colonIdx = spec.indexOf(":");
-        if (ctx.agentSelectionStrategy !== "fixed" &&
-            colonIdx > 0 &&
-            colonIdx < 20) {
-            const prefix = spec.slice(0, colonIdx).trim().toLowerCase();
-            if (KNOWN_AGENT_PREFIXES.includes(prefix)) {
-                hasExplicitPrefix = true;
-                specRequestedType = prefix;
-                specPiRequested = isPiAgentType(prefix);
-                specAgentType = normalizeAgentType(prefix);
-                specTask = spec.slice(colonIdx + 1).trim();
-            }
-        }
-        else if (ctx.agentSelectionStrategy === "fixed" &&
-            colonIdx > 0 &&
-            colonIdx < 20) {
-            specTask = stripAgentPrefix(spec);
-        }
-        const specLabel = explicitLabel
-            ? `${explicitLabel}-${i + 1}`
-            : generateLabel(repo, specTask);
-        if (!agentTypeExplicit && !hasExplicitPrefix) {
-            specRequestedType = await ptyService.resolveAgentType({
-                task: specTask,
-                repo,
-                subtaskCount: agentSpecs.length,
-            });
-            specPiRequested = isPiAgentType(specRequestedType);
-            specAgentType = normalizeAgentType(specRequestedType);
-        }
-        return {
-            specAgentType,
-            specPiRequested,
-            specRequestedType,
-            specTask,
-            specLabel,
-        };
-    }));
-    const graphPlan = coordinator && taskThread
-        ? await coordinator.planTaskThreadGraph({
-            threadId: taskThread.id,
-            title: threadTitle,
-            originalRequest: userRequest,
-            sharedContext: swarmContext || undefined,
-            subtasks: plannedAgents.map((agent) => ({
-                label: agent.specLabel,
-                originalTask: agent.specTask,
-                agentType: agent.specAgentType,
-                repo,
-            })),
-        })
-        : null;
-    for (const [i, plannedAgent] of plannedAgents.entries()) {
-        const { specAgentType, specPiRequested, specRequestedType, specTask, specLabel, } = plannedAgent;
-        const taskNodeId = graphPlan?.workerNodes[i]?.id;
-        let failureStage = "workspace";
-        try {
-            // Provision workspace (each agent gets its own clone or scratch dir)
-            let workdir;
-            let workspaceId;
-            let branch;
-            if (repo && wsService) {
-                const workspace = await wsService.provisionWorkspace({ repo });
-                workdir = workspace.path;
-                workspaceId = workspace.id;
-                branch = workspace.branch;
-                wsService.setLabel(workspace.id, specLabel);
-            }
-            else {
-                workdir = createScratchDir(runtime, specLabel);
-            }
-            // Preflight check
-            failureStage = "preflight";
-            if (specAgentType !== "shell" && specAgentType !== "pi") {
-                const [preflight] = await ptyService.checkAvailableAgents([
-                    specAgentType,
-                ]);
-                if (preflight && !preflight.installed) {
-                    results.push({
-                        sessionId: "",
-                        agentType: specAgentType,
-                        workdir,
-                        label: specLabel,
-                        status: "failed",
-                        error: `${preflight.adapter} CLI is not installed`,
-                    });
-                    continue;
-                }
-            }
-            // Check if coordinator is active — route blocking prompts through it
-            // Spawn the agent — prepend shared context brief if available
-            const taskWithContext = swarmContext
-                ? `${specTask}\n\n--- Shared Context (from project planning) ---\n${swarmContext}\n--- End Shared Context ---`
-                : specTask;
-            const initialTask = specPiRequested
-                ? toPiCommand(taskWithContext)
-                : taskWithContext;
-            const displayType = specPiRequested ? "pi" : specAgentType;
-            // Append swarm coordination instructions to agent memory so the agent
-            // knows to surface design decisions explicitly for the orchestrator.
-            const swarmMemory = agentSpecs.length > 1 && swarmContext
-                ? buildSwarmMemoryInstructions(specLabel, specTask, cleanSubtasks, i)
-                : undefined;
-            const agentMemory = [memoryContent, swarmMemory, pastExperienceBlock]
-                .filter(Boolean)
-                .join("\n\n") || undefined;
-            const coordinatorManagedSession = !!coordinator && llmProvider === "subscription";
-            const useDirectCallbackResponses = Boolean(callback);
-            failureStage = "spawn";
-            const session = await ptyService.spawnSession({
-                name: `coding-${Date.now()}-${i}`,
-                agentType: specAgentType,
-                workdir,
-                initialTask,
-                memoryContent: agentMemory,
-                credentials,
-                approvalPreset: approvalPreset ??
-                    ptyService.defaultApprovalPreset,
-                customCredentials,
-                ...(coordinatorManagedSession ? { skipAdapterAutoResponse: true } : {}),
-                metadata: {
-                    threadId: taskThread?.id,
-                    taskNodeId,
-                    requestedType: specRequestedType,
-                    messageId: message.id,
-                    userId: message.userId,
-                    workspaceId,
-                    label: specLabel,
-                    multiAgentIndex: i,
-                    // Carry the originating message routing context so deployments can
-                    // post async session updates back to the originating channel.
-                    roomId: message.roomId,
-                    worldId: message.worldId,
-                    source: message.content?.source,
-                },
-            });
-            // Register event handler
-            const isScratch = !repo;
-            const scratchDir = isScratch ? workdir : null;
-            // Pass coordinatorActive=false so the session event handler uses the
-            // DIRECT callback path for chat responses. The coordinator still monitors
-            // lifecycle via its own subscriptions — this only affects who sends the
-            // "done" message to discord. When coordinatorActive=true, the coordinator
-            // generates the reply from originalTask (the user's text), producing the
-            // "done — <echo of user message>" bug. When false, registerSessionEvents
-            // pulls data.response (the subagent's ACTUAL output) and sends that.
-            registerSessionEvents(ptyService, runtime, session.id, specLabel, scratchDir, callback, coordinatorManagedSession && !useDirectCallbackResponses);
-            if (coordinator && specTask) {
-                failureStage = "register";
-                await coordinator.registerTask(session.id, {
-                    threadId: taskThread?.id ?? session.id,
-                    taskNodeId,
-                    agentType: specAgentType,
-                    label: specLabel,
-                    originalTask: specTask,
-                    workdir,
-                    repo,
-                    metadata: session.metadata &&
-                        typeof session.metadata === "object" &&
-                        !Array.isArray(session.metadata)
-                        ? session.metadata
-                        : undefined,
-                });
-            }
-            results.push({
-                sessionId: session.id,
-                agentType: displayType,
-                workdir,
-                workspaceId,
-                branch,
-                label: specLabel,
-                status: session.status,
-            });
-            // Per-agent spawn chatter removed. The streamer reports the final
-            // result; the intermediate "[1/N] Spawned ..." messages are noise.
-        }
-        catch (error) {
-            const rawErrorMessage = error instanceof Error ? error.message : String(error);
-            const errorMessage = repo && failureStage === "workspace"
-                ? `${rawErrorMessage}. ${diagnoseWorkspaceBootstrapFailure(repo, rawErrorMessage)}`
-                : rawErrorMessage;
-            logger.error(`[START_CODING_TASK] Failed to spawn agent ${i + 1}:`, errorMessage);
-            if (callback) {
-                await callback({
-                    text: `[${i + 1}/${agentSpecs.length}] Failed to launch "${specLabel}". ` +
-                        errorMessage,
-                });
-            }
-            results.push({
-                sessionId: "",
-                agentType: specAgentType,
-                workdir: "",
-                label: specLabel,
-                status: "failed",
-                error: errorMessage,
-            });
-        }
-    }
-    // Store all sessions in state
-    if (state) {
-        state.codingSessions = results.filter((r) => r.sessionId);
-    }
-    const succeeded = results.filter((r) => r.sessionId);
-    const failed = results.filter((r) => !r.sessionId);
-    const summary = [
-        `Launched ${succeeded.length}/${agentSpecs.length} agents${repo ? ` on ${repo}` : ""}:`,
-        ...succeeded.map((r) => `  - "${r.label}" (${r.agentType}) [session: ${r.sessionId}]`),
-        ...(failed.length > 0
-            ? [`Failed: ${failed.map((r) => `"${r.label}": ${r.error}`).join(", ")}`]
-            : []),
-    ].join("\n");
-    // The final summary is suppressed from chat in favor of the
-    // task-progress-streamer, which delivers the actual subagent answer.
-    // We still include `summary` in the ActionResult.text so programmatic
-    // consumers (tests, logs) see the full detail.
-    if (callback && failed.length > 0) {
-        await callback({ text: summary });
-    }
-    return {
-        success: failed.length === 0,
-        text: summary,
-        data: { agents: results },
-    };
-}

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

@@ -1,34 +0,0 @@
-/**
- * Helper functions for the START_CODING_TASK action.
- *
- * - createScratchDir()      -- Creates a scratch sandbox directory for non-repo tasks
- * - generateLabel()         -- Generate a short semantic label from repo URL and/or task description
- * - registerSessionEvents() -- Register lifecycle event handlers for a spawned session
- *
- * @module actions/coding-task-helpers
- */
-import type { IAgentRuntime } from "@elizaos/core";
-import { type HandlerCallback } from "@elizaos/core";
-import type { PTYService } from "../services/pty-service.ts";
-/**
- * Create a scratch sandbox directory for non-repo tasks.
- *
- * When `PARALLAX_CODING_DIRECTORY` is set (e.g. `~/Projects`), creates a
- * named subdir like `~/Projects/todo-app/` derived from the task label.
- * Otherwise falls back to `~/.eliza/workspaces/{uuid}`.
- */
-export declare function createScratchDir(runtime?: IAgentRuntime, label?: string): string;
-/**
- * Generate a short semantic label from repo URL and/or task description.
- * e.g. "git-workspace-service-testbed/hello-mima" or "scratch/react-research"
- */
-export declare function generateLabel(repo: string | undefined, task: string | undefined): string;
-/**
- * Register lifecycle event handlers for a spawned session.
- *
- * When `coordinatorActive` is true the SwarmCoordinator owns chat messaging
- * and session lifecycle for blocked / task_complete / error events.
- * This listener still handles scratch-dir cleanup regardless.
- */
-export declare function registerSessionEvents(ptyService: PTYService, runtime: IAgentRuntime, sessionId: string, label: string, scratchDir: string | null, callback?: HandlerCallback, coordinatorActive?: boolean): void;
-//# sourceMappingURL=coding-task-helpers.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"coding-task-helpers.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/orchestrator/actions/coding-task-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,KAAK,eAAe,EAAU,MAAM,eAAe,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAgC7D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,CAAC,EAAE,aAAa,EACvB,KAAK,CAAC,EAAE,MAAM,GACZ,MAAM,CA4BR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,CA4BR;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,QAAQ,CAAC,EAAE,eAAe,EAC1B,iBAAiB,UAAQ,GACvB,IAAI,CAsEN"}

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

@@ -1,171 +0,0 @@
-/**
- * Helper functions for the START_CODING_TASK action.
- *
- * - createScratchDir()      -- Creates a scratch sandbox directory for non-repo tasks
- * - generateLabel()         -- Generate a short semantic label from repo URL and/or task description
- * - registerSessionEvents() -- Register lifecycle event handlers for a spawned session
- *
- * @module actions/coding-task-helpers
- */
-import { randomUUID } from "node:crypto";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { logger } from "@elizaos/core";
-import { readConfigEnvKey } from "../services/config-env.js";
-/**
- * Sanitize a label into a safe directory name.
- * Strips non-alphanumeric chars (keeps hyphens), lowercases, truncates to 60 chars.
- */
-function sanitizeDirName(label) {
-    return (label
-        .toLowerCase()
-        .replace(/[^a-z0-9-]/g, "-")
-        .replace(/-{2,}/g, "-")
-        .replace(/^-|-$/g, "")
-        .slice(0, 60) || "scratch");
-}
-/**
- * Find a non-colliding directory path by appending -2, -3, etc. if needed.
- */
-function resolveNonColliding(baseDir, name) {
-    let candidate = path.join(baseDir, name);
-    if (!fs.existsSync(candidate))
-        return candidate;
-    for (let i = 2; i < 100; i++) {
-        candidate = path.join(baseDir, `${name}-${i}`);
-        if (!fs.existsSync(candidate))
-            return candidate;
-    }
-    // Fallback to uuid to guarantee uniqueness
-    return path.join(baseDir, `${name}-${randomUUID().slice(0, 8)}`);
-}
-/**
- * Create a scratch sandbox directory for non-repo tasks.
- *
- * When `PARALLAX_CODING_DIRECTORY` is set (e.g. `~/Projects`), creates a
- * named subdir like `~/Projects/todo-app/` derived from the task label.
- * Otherwise falls back to `~/.eliza/workspaces/{uuid}`.
- */
-export function createScratchDir(runtime, label) {
-    // Check for user-configured coding directory.
-    // Try runtime settings → config file env → process.env (in priority order).
-    // Config file is checked directly because runtime.getSetting() doesn't read
-    // the config env section, and process.env is only set at boot time.
-    const codingDir = runtime?.getSetting("PARALLAX_CODING_DIRECTORY") ??
-        readConfigEnvKey("PARALLAX_CODING_DIRECTORY") ??
-        process.env.PARALLAX_CODING_DIRECTORY;
-    if (codingDir?.trim()) {
-        const resolved = codingDir.startsWith("~")
-            ? path.join(os.homedir(), codingDir.slice(1))
-            : path.resolve(codingDir);
-        const dirName = label
-            ? sanitizeDirName(label)
-            : `scratch-${randomUUID().slice(0, 8)}`;
-        const scratchDir = resolveNonColliding(resolved, dirName);
-        fs.mkdirSync(scratchDir, { recursive: true });
-        return scratchDir;
-    }
-    // Default: ephemeral UUID-based dir
-    const baseDir = path.join(os.homedir(), ".eliza", "workspaces");
-    const scratchId = randomUUID();
-    const scratchDir = path.join(baseDir, scratchId);
-    fs.mkdirSync(scratchDir, { recursive: true });
-    return scratchDir;
-}
-/**
- * Generate a short semantic label from repo URL and/or task description.
- * e.g. "git-workspace-service-testbed/hello-mima" or "scratch/react-research"
- */
-export function generateLabel(repo, task) {
-    const parts = [];
-    if (repo) {
-        // Extract repo name from URL: "https://github.com/owner/my-repo.git" -> "my-repo"
-        const match = repo.match(/\/([^/]+?)(?:\.git)?$/);
-        parts.push(match ? match[1] : "repo");
-    }
-    else {
-        parts.push("scratch");
-    }
-    if (task) {
-        // Extract a slug from the first few meaningful words of the task
-        const slug = task
-            .toLowerCase()
-            .replace(/[^a-z0-9\s-]/g, "")
-            .split(/\s+/)
-            .filter((w) => w.length > 2 &&
-            !["the", "and", "for", "with", "that", "this", "from"].includes(w))
-            .slice(0, 3)
-            .join("-");
-        if (slug)
-            parts.push(slug);
-    }
-    return parts.join("/");
-}
-/**
- * Register lifecycle event handlers for a spawned session.
- *
- * When `coordinatorActive` is true the SwarmCoordinator owns chat messaging
- * and session lifecycle for blocked / task_complete / error events.
- * This listener still handles scratch-dir cleanup regardless.
- */
-export function registerSessionEvents(ptyService, runtime, sessionId, label, scratchDir, callback, coordinatorActive = false) {
-    let scratchRegistered = false;
-    ptyService.onSessionEvent((sid, event, data) => {
-        if (sid !== sessionId)
-            return;
-        // When coordinator is active it handles chat + lifecycle for these events
-        if (!coordinatorActive) {
-            if (event === "blocked" && callback) {
-                callback({
-                    text: `Agent "${label}" is waiting for input: ${data.prompt ?? "unknown prompt"}`,
-                });
-            }
-            if (event === "task_complete") {
-                if (callback) {
-                    const response = data.response ?? "";
-                    const preview = response.length > 500 ? `${response.slice(0, 500)}...` : response;
-                    callback({
-                        text: preview
-                            ? `Agent "${label}" completed the task.\n\n${preview}`
-                            : `Agent "${label}" completed the task.`,
-                    });
-                }
-                // NOTE: do NOT force-kill the session here. task_complete fires after
-                // every tool call (when the prompt reappears), not only when the agent
-                // is truly finished. killing here causes the agent to be reaped mid-
-                // work (e.g. after WebSearch but before composing the answer). the
-                // session will be cleaned up by the idle watchdog after 5 minutes of
-                // real inactivity, or when the agent naturally exits.
-            }
-            if (event === "error" && callback) {
-                callback({
-                    text: `Agent "${label}" encountered an error: ${data.message ?? "unknown error"}`,
-                });
-            }
-        }
-        // Scratch lifecycle: register terminal scratch workspaces for retention
-        // policy handling (ephemeral / pending_decision / persistent).
-        if ((event === "stopped" || event === "task_complete" || event === "error") &&
-            scratchDir &&
-            !scratchRegistered) {
-            logger.info(`[scratch-lifecycle] Terminal event "${event}" for "${label}" — registering scratch workspace at ${scratchDir}`);
-            const wsService = runtime.getService("CODING_WORKSPACE_SERVICE");
-            if (!wsService) {
-                logger.warn(`[scratch-lifecycle] CODING_WORKSPACE_SERVICE not found — cannot register scratch workspace`);
-                // Leave scratchRegistered false so a later event can retry
-            }
-            else {
-                wsService
-                    .registerScratchWorkspace(sessionId, scratchDir, label, event)
-                    .then(() => {
-                    scratchRegistered = true;
-                })
-                    .catch((err) => {
-                    logger.warn(`[START_CODING_TASK] Failed to register scratch workspace for "${label}": ${err}`);
-                    // Leave scratchRegistered false so a later event can retry
-                });
-            }
-        }
-    });
-}

package/packages/typescript/src/features/orchestrator/actions/eval-metadata.d.ts

@@ -1,11 +0,0 @@
-import type { Memory } from "@elizaos/core";
-export declare function extractEvalRunMetadata(value: Memory | Record<string, unknown> | null | undefined): {
-    scenarioId?: string;
-    batchId?: string;
-};
-export declare function mergeTaskThreadEvalMetadata(message: Memory | null | undefined, metadata: Record<string, unknown> | undefined): {
-    scenarioId?: string;
-    batchId?: string;
-    metadata: Record<string, unknown>;
-};
-//# sourceMappingURL=eval-metadata.d.ts.map

package/packages/typescript/src/features/orchestrator/actions/eval-metadata.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"eval-metadata.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/orchestrator/actions/eval-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAsB5C,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACxD;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CA0BA;AAED,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAkBA"}