@aiden-ade/sandbox-agent 0.1.86 → 0.1.88

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Alan Sandbox Agent
+ * Runs inside E2B sandbox, connects to WS server, executes CoreAgent.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,209 @@
+/**
+ * Alan Sandbox Agent
+ * Runs inside E2B sandbox, connects to WS server, executes CoreAgent.
+ */
+import { spawnSync } from "node:child_process";
+import { getDaemonCliEnvironment } from "./cli-executable.js";
+import { HELP_TEXT, resolveCommand } from "./cli-help.js";
+import { loginWithDeviceCode, logoutDaemon, printDoctor, printScanModels, printStatus, recoverDaemonConnection, revokeRuntimeToken, rotateRuntimeToken, runDaemon, setupDaemon, stopDaemon, } from "./daemon.js";
+import { AgentLifecycleLogger, lifecycleContextFromEnv } from "./lifecycle-logger.js";
+import { decodeResumeFallbackContext, RESUME_FALLBACK_CONTEXT_ENV } from "./resume-fallback-env.js";
+import { runSandbox } from "./sandbox.js";
+import { installDaemonService, printDaemonServiceStatus, uninstallDaemonService, } from "./service-manager.js";
+import { AGENT_VERSION } from "./version.js";
+/**
+ * Report the commit identity this session will actually use.
+ *
+ * Two independent carriers have to agree: the GIT_AUTHOR / GIT_COMMITTER env
+ * injected on this process, and the sandbox's git config. Neither is verified
+ * anywhere else — a mismatch or a missing pair previously surfaced only as a
+ * mis-attributed commit, discovered after the fact. `getDaemonCliEnvironment()`
+ * is the same env the CLI child receives, so this reads what the CLI will read.
+ */
+function logEffectiveGitIdentity(lifecycle, projectPath) {
+    const readConfig = (key) => {
+        try {
+            const result = spawnSync("git", ["config", "--get", key], {
+                cwd: projectPath,
+                env: getDaemonCliEnvironment(),
+                encoding: "utf8",
+                timeout: 5000,
+            });
+            const value = result.status === 0 ? result.stdout.trim() : "";
+            return value || null;
+        }
+        catch {
+            return null;
+        }
+    };
+    const envName = process.env.GIT_AUTHOR_NAME || null;
+    const envEmail = process.env.GIT_AUTHOR_EMAIL || null;
+    const configName = readConfig("user.name");
+    const configEmail = readConfig("user.email");
+    const payload = {
+        projectPath,
+        envAuthorName: envName,
+        envAuthorEmail: envEmail,
+        configUserName: configName,
+        configUserEmail: configEmail,
+    };
+    if (!envEmail && !configEmail) {
+        lifecycle.error("sandbox_agent_git_identity_missing", payload);
+        return;
+    }
+    if (envEmail && configEmail && envEmail !== configEmail) {
+        lifecycle.error("sandbox_agent_git_identity_mismatch", payload);
+        return;
+    }
+    lifecycle.info("sandbox_agent_git_identity", payload);
+}
+async function runSessionFromEnv() {
+    const wsUrl = process.env.ALAN_WS_URL;
+    const sessionId = process.env.ALAN_SESSION_ID;
+    const taskId = process.env.ALAN_TASK_ID;
+    const sessionToken = process.env.ALAN_SESSION_TOKEN;
+    const task = process.env.ALAN_TASK;
+    const teamId = process.env.ALAN_TEAM_ID || undefined;
+    const projectPath = process.env.ALAN_PROJECT_PATH || "/home/user/workspace";
+    const backendKind = process.env.ALAN_BACKEND_KIND || "codex_app_server";
+    const agentId = process.env.ALAN_AGENT_ID || undefined;
+    const agentPrompt = process.env.ALAN_AGENT_PROMPT || undefined;
+    const mode = process.env.ALAN_MODE || "agent";
+    const model = process.env.ALAN_MODEL;
+    const contextWindow = process.env.ALAN_CONTEXT_WINDOW || undefined;
+    const effortLevel = process.env.ALAN_EFFORT_LEVEL || undefined;
+    const providerSessionId = process.env.ALAN_PROVIDER_SESSION_ID || undefined;
+    // Compact recent-transcript for the resume-triggered first turn. Base64 so the
+    // multi-line block survives every provider env-injection path (E2B real env map
+    // and Daytona `su -c` shell interpolation) unmangled — mirrors ALAN_ENV_FILE_B64.
+    const resumeFallbackContext = decodeResumeFallbackContext(process.env[RESUME_FALLBACK_CONTEXT_ENV]);
+    const workflowId = process.env.ALAN_WORKFLOW_ID || undefined;
+    const workflowExecutionId = process.env.ALAN_WORKFLOW_EXECUTION_ID || undefined;
+    const sandboxId = process.env.ALAN_SANDBOX_ID || undefined;
+    const provider = process.env.ALAN_SANDBOX_PROVIDER || undefined;
+    const runId = process.env.ALAN_RUN_ID || undefined;
+    const lifecycle = new AgentLifecycleLogger(lifecycleContextFromEnv(process.env));
+    if (!wsUrl || !sessionId || !taskId || !sessionToken || task == null) {
+        lifecycle.error("sandbox_agent_bootstrap_missing_env", {
+            hasWsUrl: Boolean(wsUrl),
+            hasConversationId: Boolean(sessionId),
+            hasTaskId: Boolean(taskId),
+            hasSessionToken: Boolean(sessionToken),
+            hasTask: task != null,
+        });
+        throw new Error("run-session is an internal Alan sandbox/session command and must be launched by Alan with session env vars. " +
+            "Missing required env vars: ALAN_WS_URL, ALAN_SESSION_ID, ALAN_TASK_ID, ALAN_SESSION_TOKEN, ALAN_TASK");
+    }
+    lifecycle.info("sandbox_agent_process_start", {
+        sessionId,
+        projectPath,
+        agentId,
+        mode,
+        model,
+    });
+    logEffectiveGitIdentity(lifecycle, projectPath);
+    await runSandbox({
+        wsUrl,
+        sessionId,
+        taskId,
+        sessionToken,
+        task,
+        teamId,
+        projectPath,
+        backendKind,
+        agentId,
+        agentPrompt,
+        mode,
+        model,
+        contextWindow,
+        effortLevel,
+        providerSessionId,
+        resumeFallbackContext,
+        workflowId,
+        workflowExecutionId,
+        sandboxId,
+        provider,
+        runId,
+        lifecycle,
+        maxIterations: 50,
+    });
+}
+async function main() {
+    if (process.argv.includes("--version")) {
+        process.stdout.write(`${AGENT_VERSION}\n`);
+        return;
+    }
+    const { command, commandArgs } = resolveCommand(process.argv.slice(2), process.env);
+    if (command === "help") {
+        process.stdout.write(HELP_TEXT);
+        return;
+    }
+    if (command === "setup") {
+        await setupDaemon(commandArgs);
+        return;
+    }
+    if (command === "login") {
+        await loginWithDeviceCode(commandArgs);
+        return;
+    }
+    if (command === "daemon") {
+        await runDaemon(commandArgs);
+        return;
+    }
+    if (command === "service" && commandArgs[0] === "install") {
+        installDaemonService(commandArgs.slice(1));
+        return;
+    }
+    if (command === "service" && commandArgs[0] === "uninstall") {
+        uninstallDaemonService(commandArgs.slice(1));
+        return;
+    }
+    if (command === "service" && commandArgs[0] === "status") {
+        printDaemonServiceStatus(commandArgs.slice(1));
+        return;
+    }
+    if (command === "stop") {
+        await stopDaemon(commandArgs);
+        return;
+    }
+    if (command === "recover") {
+        await recoverDaemonConnection(commandArgs);
+        return;
+    }
+    if (command === "status") {
+        await printStatus();
+        return;
+    }
+    if (command === "doctor") {
+        await printDoctor(commandArgs);
+        return;
+    }
+    if (command === "scan-models") {
+        await printScanModels(commandArgs);
+        return;
+    }
+    if (command === "token" && commandArgs[0] === "rotate") {
+        await rotateRuntimeToken(commandArgs.slice(1));
+        return;
+    }
+    if (command === "token" && commandArgs[0] === "revoke") {
+        await revokeRuntimeToken(commandArgs.slice(1));
+        return;
+    }
+    if (command === "logout") {
+        await logoutDaemon();
+        return;
+    }
+    if (command === "run-session") {
+        await runSessionFromEnv();
+        return;
+    }
+    throw new Error(`Unknown command: ${command}\n\n${HELP_TEXT}`);
+}
+main().catch((error) => {
+    new AgentLifecycleLogger(lifecycleContextFromEnv(process.env)).error("sandbox_agent_fatal", {
+        error: error instanceof Error ? error : new Error(String(error)),
+    });
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lifecycle-logger.d.ts

@@ -0,0 +1,25 @@
+export interface AgentLifecycleContext {
+    taskId?: string;
+    conversationId?: string;
+    runId?: string;
+    sandboxId?: string;
+    provider?: string;
+    backendKind?: string;
+    agentVersion?: string;
+}
+export type AgentLifecycleLevel = "debug" | "info" | "warn" | "error";
+type AgentLifecycleFields = Record<string, unknown>;
+export declare class AgentLifecycleLogger {
+    private context;
+    constructor(context?: AgentLifecycleContext);
+    setContext(context: AgentLifecycleContext): void;
+    child(context: AgentLifecycleContext): AgentLifecycleLogger;
+    debug(event: string, fields?: AgentLifecycleFields): void;
+    info(event: string, fields?: AgentLifecycleFields): void;
+    warn(event: string, fields?: AgentLifecycleFields): void;
+    error(event: string, fields?: AgentLifecycleFields): void;
+    private log;
+}
+export declare function lifecycleContextFromEnv(env: NodeJS.ProcessEnv): AgentLifecycleContext;
+export {};
+//# sourceMappingURL=lifecycle-logger.d.ts.map

package/dist/lifecycle-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-logger.d.ts","sourceRoot":"","sources":["../src/lifecycle-logger.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtE,KAAK,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAwB;gBAE3B,OAAO,GAAE,qBAA0B;IAI/C,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAIhD,KAAK,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB;IAI3D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,oBAAyB,GAAG,IAAI;IAI7D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,oBAAyB,GAAG,IAAI;IAI5D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,oBAAyB,GAAG,IAAI;IAI5D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,oBAAyB,GAAG,IAAI;IAI7D,OAAO,CAAC,GAAG;CAWZ;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,qBAAqB,CAUrF"}

package/dist/lifecycle-logger.js

@@ -0,0 +1,73 @@
+import { AGENT_VERSION } from "./version.js";
+export class AgentLifecycleLogger {
+    context;
+    constructor(context = {}) {
+        this.context = normalizeContext(context);
+    }
+    setContext(context) {
+        this.context = normalizeContext({ ...this.context, ...context });
+    }
+    child(context) {
+        return new AgentLifecycleLogger({ ...this.context, ...context });
+    }
+    debug(event, fields = {}) {
+        this.log("debug", event, fields);
+    }
+    info(event, fields = {}) {
+        this.log("info", event, fields);
+    }
+    warn(event, fields = {}) {
+        this.log("warn", event, fields);
+    }
+    error(event, fields = {}) {
+        this.log("error", event, fields);
+    }
+    log(level, event, fields) {
+        const record = omitUndefined({
+            ts: new Date().toISOString(),
+            level,
+            component: "agent-manager",
+            event,
+            ...this.context,
+            ...normalizeFields(fields),
+        });
+        console[level](JSON.stringify(record));
+    }
+}
+export function lifecycleContextFromEnv(env) {
+    return normalizeContext({
+        taskId: env.ALAN_TASK_ID,
+        conversationId: env.ALAN_SESSION_ID,
+        runId: env.ALAN_RUN_ID,
+        sandboxId: env.ALAN_SANDBOX_ID,
+        provider: env.ALAN_SANDBOX_PROVIDER,
+        backendKind: env.ALAN_BACKEND_KIND,
+        agentVersion: AGENT_VERSION,
+    });
+}
+function normalizeContext(context) {
+    return omitUndefined({
+        ...context,
+        agentVersion: context.agentVersion ?? AGENT_VERSION,
+    });
+}
+function normalizeFields(fields) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(fields)) {
+        if (value instanceof Error) {
+            normalized[key] = {
+                name: value.name,
+                message: value.message,
+                stack: value.stack,
+            };
+        }
+        else {
+            normalized[key] = value;
+        }
+    }
+    return normalized;
+}
+function omitUndefined(record) {
+    return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+}
+//# sourceMappingURL=lifecycle-logger.js.map

package/dist/lifecycle-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-logger.js","sourceRoot":"","sources":["../src/lifecycle-logger.ts"],"names":[],"mappings":"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"}

package/dist/local-skill-scan.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Local (desktop) skill filesystem scan.
+ *
+ * TypeScript mirror of the cloud sandbox scan
+ * (apps/api/src/services/skills/cloud-skill-scan.ts): same directory roots
+ * (SKILL_DIRECTORY_ROOTS), same 8KiB head-read limit, same shared
+ * normalize/dedupe contract (packages/shared/src/agent/skill-discovery.ts) so
+ * a skill scanned locally and one scanned in a cloud sandbox produce
+ * identical identity keys, repo attribution, and descriptions.
+ */
+import { type SkillEntry } from "@alan-ai/shared/agent";
+export interface LocalSkillScanResult {
+    skills: SkillEntry[];
+    errors: string[];
+}
+export declare function scanLocalSkills(homeDir: string, projectPath?: string | null): LocalSkillScanResult;
+/** Cached wrapper — mirrors the cloud scan's per-machine result cache. */
+export declare function scanLocalSkillsCached(homeDir: string, projectPath: string | null | undefined, options?: {
+    refresh?: boolean;
+}): LocalSkillScanResult;
+//# sourceMappingURL=local-skill-scan.d.ts.map

package/dist/local-skill-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-skill-scan.d.ts","sourceRoot":"","sources":["../src/local-skill-scan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAM/B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAiED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,oBAAoB,CAiBtB;AAID,0EAA0E;AAC1E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,oBAAoB,CAUtB"}

package/dist/local-skill-scan.js

@@ -0,0 +1,109 @@
+/**
+ * Local (desktop) skill filesystem scan.
+ *
+ * TypeScript mirror of the cloud sandbox scan
+ * (apps/api/src/services/skills/cloud-skill-scan.ts): same directory roots
+ * (SKILL_DIRECTORY_ROOTS), same 8KiB head-read limit, same shared
+ * normalize/dedupe contract (packages/shared/src/agent/skill-discovery.ts) so
+ * a skill scanned locally and one scanned in a cloud sandbox produce
+ * identical identity keys, repo attribution, and descriptions.
+ */
+import { closeSync, existsSync, openSync, readdirSync, readSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { normalizeSkillEntries, SKILL_DIRECTORY_ROOTS, } from "@alan-ai/shared/agent";
+/** Matches the cloud scan's `head -c 8192` — autocomplete only needs frontmatter. */
+const SKILL_READ_LIMIT_BYTES = 8192;
+const SKILL_CACHE_TTL_MS = 30_000;
+function readSkillHead(path) {
+    const fd = openSync(path, "r");
+    try {
+        const buffer = Buffer.alloc(SKILL_READ_LIMIT_BYTES);
+        const bytesRead = readSync(fd, buffer, 0, SKILL_READ_LIMIT_BYTES, 0);
+        return buffer.subarray(0, bytesRead).toString("utf-8");
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function scanSkillDir(dirPath, source, repoRoot, entries, errors) {
+    if (!existsSync(dirPath))
+        return;
+    let names;
+    try {
+        names = readdirSync(dirPath);
+    }
+    catch (error) {
+        errors.push(`Failed to scan ${dirPath}: ${error instanceof Error ? error.message : error}`);
+        return;
+    }
+    for (const name of names) {
+        const skillPath = join(dirPath, name, "SKILL.md");
+        let isDirectory = false;
+        try {
+            isDirectory = statSync(join(dirPath, name)).isDirectory();
+        }
+        catch {
+            continue;
+        }
+        if (!isDirectory || !existsSync(skillPath))
+            continue;
+        try {
+            entries.push({ content: readSkillHead(skillPath), source, sourcePath: skillPath, repoRoot });
+        }
+        catch (error) {
+            errors.push(`Failed to read ${skillPath}: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+}
+/** Immediate, non-hidden child directories — sibling repos in a workspace root. */
+function discoverChildRepos(parentPath) {
+    let names;
+    try {
+        names = readdirSync(parentPath);
+    }
+    catch {
+        return [];
+    }
+    const children = [];
+    for (const name of names) {
+        if (name.startsWith("."))
+            continue;
+        const childPath = join(parentPath, name);
+        try {
+            if (statSync(childPath).isDirectory())
+                children.push(childPath);
+        }
+        catch { }
+    }
+    return children;
+}
+export function scanLocalSkills(homeDir, projectPath) {
+    const rawEntries = [];
+    const errors = [];
+    for (const root of SKILL_DIRECTORY_ROOTS) {
+        scanSkillDir(join(homeDir, root), "global", undefined, rawEntries, errors);
+    }
+    if (projectPath) {
+        for (const dir of [projectPath, ...discoverChildRepos(projectPath)]) {
+            for (const root of SKILL_DIRECTORY_ROOTS) {
+                scanSkillDir(join(dir, root), "team", dir, rawEntries, errors);
+            }
+        }
+    }
+    return { skills: normalizeSkillEntries(rawEntries, "team"), errors };
+}
+const skillScanCache = new Map();
+/** Cached wrapper — mirrors the cloud scan's per-machine result cache. */
+export function scanLocalSkillsCached(homeDir, projectPath, options) {
+    const key = projectPath ?? "";
+    const now = Date.now();
+    if (!options?.refresh) {
+        const cached = skillScanCache.get(key);
+        if (cached && cached.expiresAt > now)
+            return cached.result;
+    }
+    const result = scanLocalSkills(homeDir, projectPath);
+    skillScanCache.set(key, { expiresAt: now + SKILL_CACHE_TTL_MS, result });
+    return result;
+}
+//# sourceMappingURL=local-skill-scan.js.map

package/dist/local-skill-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-skill-scan.js","sourceRoot":"","sources":["../src/local-skill-scan.ts"],"names":[],"mappings":"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"}

package/dist/local-workspace-migration.d.ts

@@ -0,0 +1,68 @@
+export type GitExecutor = (cwd: string, args: string[]) => string;
+export type DirtyWorkspaceAction = "move_via_stash" | "commit_wip" | "discard" | "leave";
+export type WorkspaceMigrationDirection = "checkout_to_worktree" | "worktree_to_checkout";
+export interface GitTreePreflight {
+    currentBranch: string | null;
+    dirtyFileCount: number;
+    isDirty: boolean;
+}
+export interface WorkspaceMigrationPreflight {
+    direction: WorkspaceMigrationDirection;
+    source: GitTreePreflight;
+    destination: GitTreePreflight | null;
+}
+export interface MigrationStash {
+    oid: string;
+    label: string;
+    createdAt: string;
+}
+export interface DirtyTreeResolution {
+    action: DirtyWorkspaceAction;
+    before: GitTreePreflight;
+    after: GitTreePreflight;
+    stash: MigrationStash | null;
+    commitOid: string | null;
+}
+export interface MigrationGitDependencies {
+    git: GitExecutor;
+    now?: () => Date;
+    createId?: () => string;
+}
+export declare class MigrationStashApplyError extends Error {
+    readonly stash: MigrationStash;
+    readonly stashPreserved = true;
+    constructor(stash: MigrationStash, cause: unknown);
+}
+/**
+ * Count porcelain-v1 NUL records without returning paths to callers. Rename and
+ * copy entries contain an extra path record, which must not be counted as a
+ * second dirty file.
+ */
+export declare function countPorcelainEntries(output: string): number;
+export declare function preflightGitTree(cwd: string, git: GitExecutor): GitTreePreflight;
+export declare function preflightWorkspaceMigration(input: {
+    direction: WorkspaceMigrationDirection;
+    sourcePath: string;
+    destinationPath?: string;
+}, git: GitExecutor): WorkspaceMigrationPreflight;
+export declare function createMigrationStash(input: {
+    cwd: string;
+    operation: string;
+}, dependencies: MigrationGitDependencies): MigrationStash | null;
+export declare function dropMigrationStash(cwd: string, stash: MigrationStash, git: GitExecutor): boolean;
+/**
+ * Apply a transferred stash to the migration destination. A failed apply never
+ * drops the stash, so the caller can surface the stash handle for recovery.
+ */
+export declare function applyMigrationStash(input: {
+    cwd: string;
+    stash: MigrationStash;
+    dropOnSuccess?: boolean;
+}, git: GitExecutor): GitTreePreflight;
+export declare function resolveDirtyTree(input: {
+    cwd: string;
+    action: DirtyWorkspaceAction;
+    operation: string;
+    confirmDiscard?: boolean;
+}, dependencies: MigrationGitDependencies): DirtyTreeResolution;
+//# sourceMappingURL=local-workspace-migration.d.ts.map

package/dist/local-workspace-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-workspace-migration.d.ts","sourceRoot":"","sources":["../src/local-workspace-migration.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzF,MAAM,MAAM,2BAA2B,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAE1F,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,2BAA2B,CAAC;IACvC,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,WAAW,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;CACzB;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,cAAc,QAAQ;gBAEnB,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO;CAKlD;AA0BD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAgB5D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,gBAAgB,CAWhF;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE;IACL,SAAS,EAAE,2BAA2B,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,EACD,GAAG,EAAE,WAAW,GACf,2BAA2B,CAM7B;AAoBD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACzC,YAAY,EAAE,wBAAwB,GACrC,cAAc,GAAG,IAAI,CAYvB;AASD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAKhG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE;IACL,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,cAAc,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,EACD,GAAG,EAAE,WAAW,GACf,gBAAgB,CAWlB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE;IACL,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,EACD,YAAY,EAAE,wBAAwB,GACrC,mBAAmB,CAqCrB"}