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

package/packages/typescript/src/features/orchestrator/services/workspace-lifecycle.js

@@ -1,86 +0,0 @@
-/**
- * Workspace lifecycle utilities — garbage collection and scratch directory cleanup.
- *
- * Extracted from workspace-service.ts to reduce module size.
- *
- * @module services/workspace-lifecycle
- */
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-/**
- * Remove a scratch directory (non-git workspace used for ad-hoc tasks).
- * Safe to call for any path under the workspaces base dir.
- */
-export async function removeScratchDir(dirPath, baseDir, log, allowedDirs) {
-    const resolved = path.resolve(dirPath);
-    // Safety: only remove if under baseDir or one of the allowed directories
-    const expandTilde = (p) => p.startsWith("~") ? path.join(os.homedir(), p.slice(1)) : p;
-    const allAllowed = [baseDir, ...(allowedDirs ?? [])];
-    const isAllowed = allAllowed.some((dir) => {
-        const resolvedDir = path.resolve(expandTilde(dir)) + path.sep;
-        return (resolved.startsWith(resolvedDir) ||
-            resolved === path.resolve(expandTilde(dir)));
-    });
-    if (!isAllowed) {
-        console.warn(`[CodingWorkspaceService] Refusing to remove dir outside allowed paths: ${resolved}`);
-        return;
-    }
-    try {
-        await fs.promises.rm(resolved, { recursive: true, force: true });
-        log(`Removed scratch dir ${resolved}`);
-    }
-    catch (err) {
-        console.warn(`[CodingWorkspaceService] Failed to remove scratch dir ${resolved}:`, err);
-    }
-}
-/**
- * Garbage-collect orphaned workspace directories.
- * Removes directories older than the given TTL that aren't tracked by the current session.
- */
-export async function gcOrphanedWorkspaces(baseDir, workspaceTtlMs, trackedWorkspaceIds, log) {
-    if (workspaceTtlMs === 0) {
-        log("Workspace GC disabled (workspaceTtlMs=0)");
-        return;
-    }
-    let entries;
-    try {
-        entries = await fs.promises.readdir(baseDir, { withFileTypes: true });
-    }
-    catch {
-        // Base dir doesn't exist yet — nothing to clean
-        return;
-    }
-    const now = Date.now();
-    let removed = 0;
-    let skipped = 0;
-    for (const entry of entries) {
-        if (!entry.isDirectory())
-            continue;
-        // Skip directories tracked by the current session
-        if (trackedWorkspaceIds.has(entry.name)) {
-            skipped++;
-            continue;
-        }
-        const dirPath = path.join(baseDir, entry.name);
-        try {
-            const stat = await fs.promises.stat(dirPath);
-            const age = now - stat.mtimeMs;
-            if (age > workspaceTtlMs) {
-                await fs.promises.rm(dirPath, { recursive: true, force: true });
-                removed++;
-            }
-            else {
-                skipped++;
-            }
-        }
-        catch (err) {
-            // Stat or remove failed — skip
-            log(`GC: skipping ${entry.name}: ${err}`);
-            skipped++;
-        }
-    }
-    if (removed > 0 || skipped > 0) {
-        console.log(`[CodingWorkspaceService] Startup GC: removed ${removed} orphaned workspace(s), kept ${skipped}`);
-    }
-}

package/packages/typescript/src/features/orchestrator/services/workspace-service.d.ts

@@ -1,118 +0,0 @@
-/**
- * Coding Workspace Service - Manages git workspaces for coding tasks
- *
- * Delegates to:
- * - workspace-github.ts  (issue management, OAuth, PAT auth)
- * - workspace-git-ops.ts (status, commit, push, PR creation)
- * - workspace-lifecycle.ts (GC, scratch dir cleanup)
- * - workspace-types.ts   (shared interface definitions)
- *
- * @module services/workspace-service
- */
-import type { IAgentRuntime } from "@elizaos/core";
-import { type CreateIssueOptions, type IssueComment, type IssueInfo, type IssueState, type PullRequestInfo, type WorkspaceEvent } from "git-workspace-service";
-import type { AuthPromptCallback } from "./workspace-github.ts";
-export type { AuthPromptCallback } from "./workspace-github.ts";
-export type { CodingWorkspaceConfig, CommitOptions, PROptions, ProvisionWorkspaceOptions, PushOptions, WorkspaceResult, WorkspaceStatusResult, } from "./workspace-types.ts";
-import type { CodingWorkspaceConfig, CommitOptions, PROptions, ProvisionWorkspaceOptions, PushOptions, WorkspaceResult, WorkspaceStatusResult } from "./workspace-types.ts";
-type WorkspaceEventCallback = (event: WorkspaceEvent) => void;
-type ScratchTerminalEvent = "stopped" | "task_complete" | "error";
-export interface ScratchWorkspaceRecord {
-    sessionId: string;
-    label: string;
-    path: string;
-    status: "pending_decision" | "kept" | "promoted";
-    createdAt: number;
-    terminalAt: number;
-    terminalEvent: ScratchTerminalEvent;
-    expiresAt?: number;
-}
-export declare class CodingWorkspaceService {
-    static serviceType: string;
-    capabilityDescription: string;
-    private runtime;
-    private workspaceService;
-    private credentialService;
-    private githubClient;
-    private githubAuthInProgress;
-    private serviceConfig;
-    private workspaces;
-    private labels;
-    private scratchBySession;
-    private scratchCleanupTimers;
-    private eventCallbacks;
-    private authPromptCallback;
-    /** Callback fired when a scratch workspace enters pending_decision state. */
-    private scratchDecisionCallback;
-    constructor(runtime: IAgentRuntime, config?: CodingWorkspaceConfig);
-    static start(runtime: IAgentRuntime): Promise<CodingWorkspaceService>;
-    static stopRuntime(runtime: IAgentRuntime): Promise<void>;
-    private initialize;
-    stop(): Promise<void>;
-    /** Provision a new workspace */
-    provisionWorkspace(options: ProvisionWorkspaceOptions): Promise<WorkspaceResult>;
-    getWorkspace(id: string): WorkspaceResult | undefined;
-    listWorkspaces(): WorkspaceResult[];
-    /**
-     * Assign a semantic label to a workspace (e.g. "auth-bugfix").
-     * If the label already exists, it is reassigned to the new workspace.
-     */
-    setLabel(workspaceId: string, label: string): void;
-    getWorkspaceByLabel(label: string): WorkspaceResult | undefined;
-    /** Resolve a workspace by label or ID. */
-    resolveWorkspace(labelOrId: string): WorkspaceResult | undefined;
-    getStatus(workspaceId: string): Promise<WorkspaceStatusResult>;
-    commit(workspaceId: string, options: CommitOptions): Promise<string>;
-    push(workspaceId: string, options?: PushOptions): Promise<void>;
-    createPR(workspaceId: string, options: PROptions): Promise<PullRequestInfo>;
-    private getGitHubContext;
-    /** Set a callback to surface OAuth auth prompts to the user. */
-    setAuthPromptCallback(callback: AuthPromptCallback): void;
-    /**
-     * Register a callback fired when a scratch workspace enters pending_decision.
-     * Used to prompt the user via chat: "Want to keep this code?"
-     */
-    setScratchDecisionCallback(callback: (record: ScratchWorkspaceRecord) => Promise<void>): void;
-    createIssue(repo: string, options: CreateIssueOptions): Promise<IssueInfo>;
-    getIssue(repo: string, issueNumber: number): Promise<IssueInfo>;
-    listIssues(repo: string, options?: {
-        state?: IssueState | "all";
-        labels?: string[];
-        assignee?: string;
-    }): Promise<IssueInfo[]>;
-    updateIssue(repo: string, issueNumber: number, options: {
-        title?: string;
-        body?: string;
-        state?: IssueState;
-        labels?: string[];
-        assignees?: string[];
-    }): Promise<IssueInfo>;
-    addComment(repo: string, issueNumber: number, body: string): Promise<IssueComment>;
-    listComments(repo: string, issueNumber: number): Promise<IssueComment[]>;
-    closeIssue(repo: string, issueNumber: number): Promise<IssueInfo>;
-    reopenIssue(repo: string, issueNumber: number): Promise<IssueInfo>;
-    addLabels(repo: string, issueNumber: number, labels: string[]): Promise<void>;
-    removeWorkspace(workspaceId: string): Promise<void>;
-    onEvent(callback: WorkspaceEventCallback): () => void;
-    private emitEvent;
-    /** Remove a scratch directory — allowed under base dir or user coding directory. */
-    removeScratchDir(dirPath: string): Promise<void>;
-    listScratchWorkspaces(): ScratchWorkspaceRecord[];
-    registerScratchWorkspace(sessionId: string, dirPath: string, label: string, terminalEvent: ScratchTerminalEvent): Promise<ScratchWorkspaceRecord | null>;
-    keepScratchWorkspace(sessionId: string): Promise<ScratchWorkspaceRecord>;
-    deleteScratchWorkspace(sessionId: string): Promise<void>;
-    promoteScratchWorkspace(sessionId: string, name?: string): Promise<ScratchWorkspaceRecord>;
-    /** GC orphaned workspace directories older than workspaceTtlMs. */
-    private gcOrphanedWorkspaces;
-    private log;
-    /** Read a key from the config file's env section (live, no restart needed). */
-    private readConfigEnvKey;
-    private getScratchRetentionPolicy;
-    private getScratchDecisionTtlMs;
-    private requireScratchWorkspace;
-    private clearScratchCleanupTimer;
-    private scheduleScratchCleanup;
-    private sanitizeWorkspaceName;
-    private allocatePromotedPath;
-}
-//# sourceMappingURL=workspace-service.d.ts.map

package/packages/typescript/src/features/orchestrator/services/workspace-service.d.ts.map

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