@slaw-ai/server 2026.611.0

package/dist/services/workspace-realization.js

@@ -0,0 +1,221 @@
+function parseObject(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function readString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function readNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function readWorkspaceRealizationRequest(value) {
+    const parsed = parseObject(value);
+    if (parsed.version !== 1)
+        return null;
+    const source = parseObject(parsed.source);
+    const runtimeOverlay = parseObject(parsed.runtimeOverlay);
+    const localPath = readString(source.localPath);
+    const squadId = readString(parsed.squadId);
+    const environmentId = readString(parsed.environmentId);
+    const heartbeatRunId = readString(parsed.heartbeatRunId);
+    const adapterType = readString(parsed.adapterType);
+    if (!localPath || !squadId || !environmentId || !heartbeatRunId || !adapterType)
+        return null;
+    return {
+        version: 1,
+        adapterType,
+        squadId,
+        environmentId,
+        executionWorkspaceId: readString(parsed.executionWorkspaceId),
+        issueId: readString(parsed.issueId),
+        heartbeatRunId,
+        requestedMode: readString(parsed.requestedMode),
+        source: {
+            kind: source.kind === "task_session" || source.kind === "agent_home"
+                ? source.kind
+                : "project_primary",
+            localPath,
+            projectId: readString(source.projectId),
+            projectWorkspaceId: readString(source.projectWorkspaceId),
+            repoUrl: readString(source.repoUrl),
+            repoRef: readString(source.repoRef),
+            strategy: source.strategy === "git_worktree" ? "git_worktree" : "project_primary",
+            branchName: readString(source.branchName),
+            worktreePath: readString(source.worktreePath),
+        },
+        runtimeOverlay: {
+            provisionCommand: readString(runtimeOverlay.provisionCommand),
+            teardownCommand: readString(runtimeOverlay.teardownCommand),
+            cleanupCommand: readString(runtimeOverlay.cleanupCommand),
+            workspaceRuntime: Object.keys(parseObject(runtimeOverlay.workspaceRuntime)).length > 0
+                ? parseObject(runtimeOverlay.workspaceRuntime)
+                : null,
+        },
+    };
+}
+export function buildWorkspaceRealizationRequest(input) {
+    return {
+        version: 1,
+        adapterType: input.adapterType,
+        squadId: input.squadId,
+        environmentId: input.environmentId,
+        executionWorkspaceId: input.executionWorkspaceId,
+        issueId: input.issueId,
+        heartbeatRunId: input.heartbeatRunId,
+        requestedMode: input.requestedMode,
+        source: {
+            kind: input.workspace.source,
+            localPath: input.workspace.cwd,
+            projectId: input.workspace.projectId,
+            projectWorkspaceId: input.workspace.workspaceId,
+            repoUrl: input.workspace.repoUrl,
+            repoRef: input.workspace.repoRef,
+            strategy: input.workspace.strategy,
+            branchName: input.workspace.branchName,
+            worktreePath: input.workspace.worktreePath,
+        },
+        runtimeOverlay: {
+            provisionCommand: input.workspaceConfig?.provisionCommand ?? null,
+            teardownCommand: input.workspaceConfig?.teardownCommand ?? null,
+            cleanupCommand: input.workspaceConfig?.cleanupCommand ?? null,
+            workspaceRuntime: input.workspaceConfig?.workspaceRuntime ?? null,
+        },
+    };
+}
+export function buildWorkspaceRealizationRecord(input) {
+    const leaseMetadata = input.lease.metadata ?? {};
+    const providerMetadata = input.providerMetadata ?? {};
+    const transport = input.environment.driver === "ssh" || input.environment.driver === "sandbox" || input.environment.driver === "plugin"
+        ? input.environment.driver
+        : "local";
+    const remotePath = readString(providerMetadata.remoteCwd) ??
+        readString(leaseMetadata.remoteCwd) ??
+        readString(providerMetadata.remotePath) ??
+        null;
+    const host = readString(leaseMetadata.host);
+    const port = readNumber(leaseMetadata.port);
+    const username = readString(leaseMetadata.username);
+    const sandboxId = readString(leaseMetadata.sandboxId) ?? readString(providerMetadata.sandboxId);
+    const sync = (() => {
+        if (transport === "local") {
+            return {
+                strategy: "none",
+                prepare: "Use the realized local execution workspace directly.",
+                syncBack: null,
+            };
+        }
+        if (transport === "ssh") {
+            return {
+                strategy: "ssh_git_import_export",
+                prepare: "Import the local git workspace to the remote SSH workspace before adapter execution.",
+                syncBack: "Export remote SSH workspace changes back to the local execution workspace after adapter execution.",
+            };
+        }
+        if (transport === "sandbox") {
+            return {
+                strategy: "sandbox_archive_upload_download",
+                prepare: "Upload a workspace archive into the sandbox filesystem before adapter execution.",
+                syncBack: "Download a workspace archive from the sandbox and mirror it back locally after adapter execution.",
+            };
+        }
+        return {
+            strategy: "provider_defined",
+            prepare: "Delegate workspace materialization to the plugin environment driver.",
+            syncBack: "Delegate result synchronization to the plugin environment driver.",
+        };
+    })();
+    const provider = input.lease.provider ??
+        (transport === "ssh" ? "ssh" : transport === "local" ? "local" : null);
+    const localPath = input.request.source.localPath;
+    const summary = transport === "local"
+        ? `Local workspace realized at ${localPath}.`
+        : transport === "ssh"
+            ? `SSH workspace realized at ${username ?? "user"}@${host ?? "host"}:${port ?? 22}:${remotePath ?? input.request.source.localPath}.`
+            : transport === "sandbox"
+                ? `Sandbox workspace realized at ${remotePath ?? "/"}${sandboxId ? ` in ${sandboxId}` : ""}.`
+                : `Plugin workspace realized at ${input.realizedCwd ?? remotePath ?? localPath}.`;
+    return {
+        version: 1,
+        transport,
+        provider,
+        environmentId: input.environment.id,
+        leaseId: input.lease.id,
+        providerLeaseId: input.lease.providerLeaseId,
+        local: {
+            path: localPath,
+            source: input.request.source.kind,
+            strategy: input.request.source.strategy,
+            projectId: input.request.source.projectId,
+            projectWorkspaceId: input.request.source.projectWorkspaceId,
+            repoUrl: input.request.source.repoUrl,
+            repoRef: input.request.source.repoRef,
+            branchName: input.request.source.branchName,
+            worktreePath: input.request.source.worktreePath,
+        },
+        remote: {
+            path: remotePath,
+            ...(host ? { host } : {}),
+            ...(port ? { port } : {}),
+            ...(username ? { username } : {}),
+            ...(sandboxId ? { sandboxId } : {}),
+        },
+        sync,
+        bootstrap: {
+            command: input.request.runtimeOverlay.provisionCommand,
+        },
+        rebuild: {
+            executionWorkspaceId: input.request.executionWorkspaceId,
+            mode: input.request.requestedMode,
+            repoUrl: input.request.source.repoUrl,
+            repoRef: input.request.source.repoRef,
+            localPath,
+            remotePath,
+            providerLeaseId: input.lease.providerLeaseId,
+            metadata: {
+                source: input.request.source,
+                runtimeOverlay: input.request.runtimeOverlay,
+                environmentDriver: input.environment.driver,
+                provider,
+                providerMetadata,
+            },
+        },
+        summary,
+    };
+}
+export function buildWorkspaceRealizationRecordFromDriverInput(input) {
+    const request = readWorkspaceRealizationRequest(input.workspace.metadata?.workspaceRealizationRequest) ??
+        readWorkspaceRealizationRequest(input.workspace.metadata?.request) ??
+        buildWorkspaceRealizationRequest({
+            adapterType: "unknown",
+            squadId: input.lease.squadId,
+            environmentId: input.environment.id,
+            executionWorkspaceId: input.lease.executionWorkspaceId,
+            issueId: input.lease.issueId,
+            heartbeatRunId: input.lease.heartbeatRunId ?? "unknown",
+            requestedMode: input.workspace.mode ?? null,
+            workspace: {
+                baseCwd: input.workspace.localPath ?? input.cwd ?? input.workspace.remotePath ?? "/",
+                source: "task_session",
+                projectId: null,
+                workspaceId: null,
+                repoUrl: null,
+                repoRef: null,
+                strategy: "project_primary",
+                cwd: input.workspace.localPath ?? input.cwd ?? input.workspace.remotePath ?? "/",
+                branchName: null,
+                worktreePath: null,
+                warnings: [],
+                created: false,
+            },
+            workspaceConfig: null,
+        });
+    return buildWorkspaceRealizationRecord({
+        environment: input.environment,
+        lease: input.lease,
+        request,
+        realizedCwd: input.cwd ?? null,
+        providerMetadata: input.providerMetadata,
+    });
+}
+//# sourceMappingURL=workspace-realization.js.map

package/dist/services/workspace-realization.js.map

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

package/dist/services/workspace-runtime-read-model.d.ts

@@ -0,0 +1,92 @@
+import type { Db } from "@slaw-ai/db";
+import { workspaceRuntimeServices } from "@slaw-ai/db";
+type WorkspaceRuntimeServiceRow = typeof workspaceRuntimeServices.$inferSelect;
+export declare function selectCurrentRuntimeServiceRows(rows: WorkspaceRuntimeServiceRow[]): {
+    id: string;
+    status: string;
+    createdAt: Date;
+    updatedAt: Date;
+    squadId: string;
+    provider: string;
+    url: string | null;
+    issueId: string | null;
+    command: string | null;
+    projectId: string | null;
+    projectWorkspaceId: string | null;
+    executionWorkspaceId: string | null;
+    scopeType: string;
+    scopeId: string | null;
+    serviceName: string;
+    lifecycle: string;
+    reuseKey: string | null;
+    cwd: string | null;
+    port: number | null;
+    providerRef: string | null;
+    ownerAgentId: string | null;
+    startedByRunId: string | null;
+    lastUsedAt: Date;
+    startedAt: Date;
+    stoppedAt: Date | null;
+    stopPolicy: Record<string, unknown> | null;
+    healthStatus: string;
+}[];
+export declare function listCurrentRuntimeServicesForProjectWorkspaces(db: Db, squadId: string, projectWorkspaceIds: string[]): Promise<Map<string, {
+    id: string;
+    status: string;
+    createdAt: Date;
+    updatedAt: Date;
+    squadId: string;
+    provider: string;
+    url: string | null;
+    issueId: string | null;
+    command: string | null;
+    projectId: string | null;
+    projectWorkspaceId: string | null;
+    executionWorkspaceId: string | null;
+    scopeType: string;
+    scopeId: string | null;
+    serviceName: string;
+    lifecycle: string;
+    reuseKey: string | null;
+    cwd: string | null;
+    port: number | null;
+    providerRef: string | null;
+    ownerAgentId: string | null;
+    startedByRunId: string | null;
+    lastUsedAt: Date;
+    startedAt: Date;
+    stoppedAt: Date | null;
+    stopPolicy: Record<string, unknown> | null;
+    healthStatus: string;
+}[]>>;
+export declare function listCurrentRuntimeServicesForExecutionWorkspaces(db: Db, squadId: string, executionWorkspaceIds: string[]): Promise<Map<string, {
+    id: string;
+    status: string;
+    createdAt: Date;
+    updatedAt: Date;
+    squadId: string;
+    provider: string;
+    url: string | null;
+    issueId: string | null;
+    command: string | null;
+    projectId: string | null;
+    projectWorkspaceId: string | null;
+    executionWorkspaceId: string | null;
+    scopeType: string;
+    scopeId: string | null;
+    serviceName: string;
+    lifecycle: string;
+    reuseKey: string | null;
+    cwd: string | null;
+    port: number | null;
+    providerRef: string | null;
+    ownerAgentId: string | null;
+    startedByRunId: string | null;
+    lastUsedAt: Date;
+    startedAt: Date;
+    stoppedAt: Date | null;
+    stopPolicy: Record<string, unknown> | null;
+    healthStatus: string;
+}[]>>;
+export {};
+//# sourceMappingURL=workspace-runtime-read-model.d.ts.map

package/dist/services/workspace-runtime-read-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-runtime-read-model.d.ts","sourceRoot":"","sources":["../../src/services/workspace-runtime-read-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAGvD,KAAK,0BAA0B,GAAG,OAAO,wBAAwB,CAAC,YAAY,CAAC;AAe/E,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,0BAA0B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOjF;AAED,wBAAsB,8CAA8C,CAClE,EAAE,EAAE,EAAE,EACN,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA8B9B;AAED,wBAAsB,gDAAgD,CACpE,EAAE,EAAE,EAAE,EACN,OAAO,EAAE,MAAM,EACf,qBAAqB,EAAE,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA6BhC"}

package/dist/services/workspace-runtime-read-model.js

@@ -0,0 +1,67 @@
+import { workspaceRuntimeServices } from "@slaw-ai/db";
+import { and, desc, eq, inArray } from "drizzle-orm";
+function runtimeServiceIdentityKey(row) {
+    if (row.reuseKey)
+        return row.reuseKey;
+    return [
+        row.scopeType,
+        row.scopeId ?? "",
+        row.projectWorkspaceId ?? "",
+        row.executionWorkspaceId ?? "",
+        row.serviceName,
+        row.command ?? "",
+        row.cwd ?? "",
+    ].join(":");
+}
+export function selectCurrentRuntimeServiceRows(rows) {
+    const current = new Map();
+    for (const row of rows) {
+        const identity = runtimeServiceIdentityKey(row);
+        if (!current.has(identity))
+            current.set(identity, row);
+    }
+    return [...current.values()];
+}
+export async function listCurrentRuntimeServicesForProjectWorkspaces(db, squadId, projectWorkspaceIds) {
+    if (projectWorkspaceIds.length === 0)
+        return new Map();
+    const rows = await db
+        .select()
+        .from(workspaceRuntimeServices)
+        .where(and(eq(workspaceRuntimeServices.squadId, squadId), inArray(workspaceRuntimeServices.projectWorkspaceId, projectWorkspaceIds), eq(workspaceRuntimeServices.scopeType, "project_workspace")))
+        .orderBy(desc(workspaceRuntimeServices.updatedAt), desc(workspaceRuntimeServices.createdAt));
+    const grouped = new Map();
+    for (const row of rows) {
+        if (!row.projectWorkspaceId)
+            continue;
+        const existing = grouped.get(row.projectWorkspaceId) ?? [];
+        existing.push(row);
+        grouped.set(row.projectWorkspaceId, existing);
+    }
+    return new Map(Array.from(grouped.entries()).map(([workspaceId, workspaceRows]) => [
+        workspaceId,
+        selectCurrentRuntimeServiceRows(workspaceRows),
+    ]));
+}
+export async function listCurrentRuntimeServicesForExecutionWorkspaces(db, squadId, executionWorkspaceIds) {
+    if (executionWorkspaceIds.length === 0)
+        return new Map();
+    const rows = await db
+        .select()
+        .from(workspaceRuntimeServices)
+        .where(and(eq(workspaceRuntimeServices.squadId, squadId), inArray(workspaceRuntimeServices.executionWorkspaceId, executionWorkspaceIds)))
+        .orderBy(desc(workspaceRuntimeServices.updatedAt), desc(workspaceRuntimeServices.createdAt));
+    const grouped = new Map();
+    for (const row of rows) {
+        if (!row.executionWorkspaceId)
+            continue;
+        const existing = grouped.get(row.executionWorkspaceId) ?? [];
+        existing.push(row);
+        grouped.set(row.executionWorkspaceId, existing);
+    }
+    return new Map(Array.from(grouped.entries()).map(([workspaceId, workspaceRows]) => [
+        workspaceId,
+        selectCurrentRuntimeServiceRows(workspaceRows),
+    ]));
+}
+//# sourceMappingURL=workspace-runtime-read-model.js.map

package/dist/services/workspace-runtime-read-model.js.map

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

package/dist/services/workspace-runtime.d.ts

@@ -0,0 +1,252 @@
+import type { AdapterRuntimeServiceReport } from "@slaw-ai/adapter-utils";
+import type { Db } from "@slaw-ai/db";
+import { type WorkspaceRuntimeDesiredState, type WorkspaceRuntimeServiceStateMap } from "@slaw-ai/shared";
+import type { WorkspaceOperationRecorder } from "./workspace-operations.js";
+export declare function resolveShell(): string;
+export interface ExecutionWorkspaceInput {
+    baseCwd: string;
+    source: "project_primary" | "task_session" | "agent_home";
+    projectId: string | null;
+    workspaceId: string | null;
+    repoUrl: string | null;
+    repoRef: string | null;
+}
+export interface ExecutionWorkspaceIssueRef {
+    id: string;
+    identifier: string | null;
+    title: string | null;
+    workMode?: string | null;
+}
+export interface ExecutionWorkspaceAgentRef {
+    id: string | null;
+    name: string;
+    squadId: string;
+}
+export interface RealizedExecutionWorkspace extends ExecutionWorkspaceInput {
+    strategy: "project_primary" | "git_worktree";
+    cwd: string;
+    branchName: string | null;
+    worktreePath: string | null;
+    warnings: string[];
+    created: boolean;
+    baseRefSha?: string | null;
+}
+export interface RuntimeServiceRef {
+    id: string;
+    squadId: string;
+    projectId: string | null;
+    projectWorkspaceId: string | null;
+    executionWorkspaceId: string | null;
+    issueId: string | null;
+    serviceName: string;
+    status: "starting" | "running" | "stopped" | "failed";
+    lifecycle: "shared" | "ephemeral";
+    scopeType: "project_workspace" | "execution_workspace" | "run" | "agent";
+    scopeId: string | null;
+    reuseKey: string | null;
+    command: string | null;
+    cwd: string | null;
+    port: number | null;
+    url: string | null;
+    provider: "local_process" | "adapter_managed";
+    providerRef: string | null;
+    ownerAgentId: string | null;
+    startedByRunId: string | null;
+    lastUsedAt: string;
+    startedAt: string;
+    stoppedAt: string | null;
+    stopPolicy: Record<string, unknown> | null;
+    healthStatus: "unknown" | "healthy" | "unhealthy";
+    reused: boolean;
+}
+export declare function resetRuntimeServicesForTests(): Promise<void>;
+export declare function ensureServerWorkspaceLinksCurrent(startCwd: string, opts?: {
+    onLog?: (stream: "stdout" | "stderr", chunk: string) => Promise<void>;
+}): Promise<void>;
+export declare function sanitizeRuntimeServiceBaseEnv(baseEnv: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function inspectExecutionWorkspaceBaseDrift(input: {
+    repoRoot: string;
+    worktreePath: string;
+    branchName: string | null;
+    baseRef: string | null;
+    recordedBaseRefSha?: string | null;
+    skipRefresh?: boolean;
+}): Promise<{
+    warnings: string[];
+    currentBaseRefSha: string | null;
+    branchBaseRefSha: string | null;
+}>;
+export declare function realizeExecutionWorkspace(input: {
+    base: ExecutionWorkspaceInput;
+    config: Record<string, unknown>;
+    issue: ExecutionWorkspaceIssueRef | null;
+    agent: ExecutionWorkspaceAgentRef;
+    recorder?: WorkspaceOperationRecorder | null;
+}): Promise<RealizedExecutionWorkspace>;
+export declare function ensurePersistedExecutionWorkspaceAvailable(input: {
+    base: ExecutionWorkspaceInput;
+    workspace: {
+        mode: string | null | undefined;
+        strategyType: string | null | undefined;
+        cwd: string | null | undefined;
+        providerRef: string | null | undefined;
+        projectId: string | null | undefined;
+        projectWorkspaceId: string | null | undefined;
+        repoUrl: string | null | undefined;
+        baseRef: string | null | undefined;
+        branchName: string | null | undefined;
+        metadata?: Record<string, unknown> | null;
+        config?: {
+            provisionCommand?: string | null;
+        } | null;
+    };
+    issue: ExecutionWorkspaceIssueRef | null;
+    agent: ExecutionWorkspaceAgentRef;
+    recorder?: WorkspaceOperationRecorder | null;
+}): Promise<RealizedExecutionWorkspace | null>;
+export declare function cleanupExecutionWorkspaceArtifacts(input: {
+    workspace: {
+        id: string;
+        cwd: string | null;
+        providerType: string;
+        providerRef: string | null;
+        branchName: string | null;
+        repoUrl: string | null;
+        baseRef: string | null;
+        projectId: string | null;
+        projectWorkspaceId: string | null;
+        sourceIssueId: string | null;
+        metadata?: Record<string, unknown> | null;
+    };
+    projectWorkspace?: {
+        cwd: string | null;
+        cleanupCommand: string | null;
+    } | null;
+    cleanupCommand?: string | null;
+    teardownCommand?: string | null;
+    recorder?: WorkspaceOperationRecorder | null;
+}): Promise<{
+    cleanedPath: string | null;
+    cleaned: boolean;
+    warnings: string[];
+}>;
+export declare function runWorkspaceJobForControl(input: {
+    actor: ExecutionWorkspaceAgentRef;
+    issue: ExecutionWorkspaceIssueRef | null;
+    workspace: RealizedExecutionWorkspace;
+    command: Record<string, unknown>;
+    adapterEnv?: Record<string, string>;
+    recorder?: WorkspaceOperationRecorder | null;
+    metadata?: Record<string, unknown> | null;
+}): Promise<import("@slaw-ai/shared").WorkspaceOperation | null>;
+export declare function resolveWorkspaceRuntimeReadinessTimeoutSec(service: Record<string, unknown>): number;
+export declare function normalizeAdapterManagedRuntimeServices(input: {
+    adapterType: string;
+    runId: string;
+    agent: ExecutionWorkspaceAgentRef;
+    issue: ExecutionWorkspaceIssueRef | null;
+    workspace: RealizedExecutionWorkspace;
+    executionWorkspaceId?: string | null;
+    reports: AdapterRuntimeServiceReport[];
+    now?: Date;
+}): RuntimeServiceRef[];
+export declare function listConfiguredRuntimeServiceEntries(config: Record<string, unknown>): Record<string, unknown>[];
+export declare function buildWorkspaceRuntimeDesiredStatePatch(input: {
+    config: Record<string, unknown>;
+    currentDesiredState: WorkspaceRuntimeDesiredState | null;
+    currentServiceStates: WorkspaceRuntimeServiceStateMap | null | undefined;
+    action: "start" | "stop" | "restart";
+    serviceIndex?: number | null;
+}): {
+    desiredState: WorkspaceRuntimeDesiredState;
+    serviceStates: WorkspaceRuntimeServiceStateMap | null;
+};
+export declare function ensureRuntimeServicesForRun(input: {
+    db?: Db;
+    runId: string;
+    agent: ExecutionWorkspaceAgentRef;
+    issue: ExecutionWorkspaceIssueRef | null;
+    workspace: RealizedExecutionWorkspace;
+    executionWorkspaceId?: string | null;
+    config: Record<string, unknown>;
+    adapterEnv: Record<string, string>;
+    onLog?: (stream: "stdout" | "stderr", chunk: string) => Promise<void>;
+}): Promise<RuntimeServiceRef[]>;
+export declare function startRuntimeServicesForWorkspaceControl(input: {
+    db?: Db;
+    invocationId?: string;
+    actor: ExecutionWorkspaceAgentRef;
+    issue: ExecutionWorkspaceIssueRef | null;
+    workspace: RealizedExecutionWorkspace;
+    executionWorkspaceId?: string | null;
+    config: Record<string, unknown>;
+    adapterEnv: Record<string, string>;
+    onLog?: (stream: "stdout" | "stderr", chunk: string) => Promise<void>;
+    serviceIndex?: number | null;
+    respectDesiredStates?: boolean;
+}): Promise<RuntimeServiceRef[]>;
+export declare function releaseRuntimeServicesForRun(runId: string): Promise<void>;
+export declare function stopRuntimeServicesForExecutionWorkspace(input: {
+    db?: Db;
+    executionWorkspaceId: string;
+    workspaceCwd?: string | null;
+    runtimeServiceId?: string | null;
+}): Promise<void>;
+export declare function stopRuntimeServicesForProjectWorkspace(input: {
+    db?: Db;
+    projectWorkspaceId: string;
+    runtimeServiceId?: string | null;
+}): Promise<void>;
+export declare function listWorkspaceRuntimeServicesForProjectWorkspaces(db: Db, squadId: string, projectWorkspaceIds: string[]): Promise<Map<string, {
+    id: string;
+    status: string;
+    createdAt: Date;
+    updatedAt: Date;
+    squadId: string;
+    provider: string;
+    url: string | null;
+    issueId: string | null;
+    command: string | null;
+    projectId: string | null;
+    projectWorkspaceId: string | null;
+    executionWorkspaceId: string | null;
+    scopeType: string;
+    scopeId: string | null;
+    serviceName: string;
+    lifecycle: string;
+    reuseKey: string | null;
+    cwd: string | null;
+    port: number | null;
+    providerRef: string | null;
+    ownerAgentId: string | null;
+    startedByRunId: string | null;
+    lastUsedAt: Date;
+    startedAt: Date;
+    stoppedAt: Date | null;
+    stopPolicy: Record<string, unknown> | null;
+    healthStatus: string;
+}[]>>;
+export declare function reconcilePersistedRuntimeServicesOnStartup(db: Db): Promise<{
+    reconciled: number;
+    adopted: number;
+    stopped: number;
+}>;
+export declare function restartDesiredRuntimeServicesOnStartup(db: Db): Promise<{
+    restarted: number;
+    failed: number;
+}>;
+export declare function persistAdapterManagedRuntimeServices(input: {
+    db: Db;
+    adapterType: string;
+    runId: string;
+    agent: ExecutionWorkspaceAgentRef;
+    issue: ExecutionWorkspaceIssueRef | null;
+    workspace: RealizedExecutionWorkspace;
+    executionWorkspaceId?: string | null;
+    reports: AdapterRuntimeServiceReport[];
+}): Promise<RuntimeServiceRef[]>;
+export declare function buildWorkspaceReadyComment(input: {
+    workspace: RealizedExecutionWorkspace;
+    runtimeServices: RuntimeServiceRef[];
+}): string;
+//# sourceMappingURL=workspace-runtime.d.ts.map