spawnfile 0.1.10 → 0.1.12

package/dist/compiler/upProject.js

@@ -1,37 +1,71 @@
+import path from "node:path";
 import { removeDirectory } from "../filesystem/index.js";
+import { writeDockerDeploymentRecordForRun } from "../deployment/index.js";
 import { buildProject } from "./buildProject.js";
-import { createDockerRunInvocation, runDockerContainer } from "./runProject.js";
+import { createDockerRunInvocation, resolveDetachedDeploymentOptions, runDockerContainer } from "./runProject.js";
 import { requireAuthProfile } from "../auth/index.js";
+import { DEFAULT_OUTPUT_DIRECTORY } from "../shared/index.js";
 export const upProject = async (inputPath, options = {}) => {
+    const resolvedOptions = await resolveDetachedDeploymentOptions(path.resolve(options.outputDirectory ?? DEFAULT_OUTPUT_DIRECTORY), {
+        authProfile: options.authProfile,
+        containerName: options.containerName,
+        deploymentName: options.deploymentName,
+        detach: options.detach,
+        dockerCommand: options.dockerCommand,
+        dockerContext: options.dockerContext,
+        dockerHost: options.dockerHost,
+        envFilePath: options.envFilePath,
+        imageTag: options.imageTag,
+        targetExecFile: options.targetExecFile
+    });
     const buildResult = await buildProject(inputPath, {
         buildRunner: options.buildRunner,
         clean: options.clean,
         dockerCommand: options.dockerCommand,
-        imageTag: options.imageTag,
+        imageTag: resolvedOptions.imageTag,
         outputDirectory: options.outputDirectory
     });
-    const authProfile = options.authProfile
-        ? await requireAuthProfile(options.authProfile)
+    const authProfile = resolvedOptions.authProfile
+        ? await requireAuthProfile(resolvedOptions.authProfile)
         : null;
-    const invocation = await createDockerRunInvocation(buildResult, buildResult.imageTag, {
+    const imageTag = resolvedOptions.imageTag ?? buildResult.imageTag;
+    const invocation = await createDockerRunInvocation(buildResult, imageTag, {
         authProfile,
-        containerName: options.containerName,
+        containerName: resolvedOptions.containerName,
         detach: options.detach,
+        deploymentName: resolvedOptions.deploymentName,
         dockerCommand: options.dockerCommand,
-        envFilePath: options.envFilePath
+        dockerContext: resolvedOptions.dockerContext,
+        dockerHost: resolvedOptions.dockerHost,
+        envFilePath: resolvedOptions.envFilePath
     });
+    let runMetadata;
     try {
-        await (options.runRunner ?? runDockerContainer)(invocation);
+        runMetadata = await (options.runRunner ?? runDockerContainer)(invocation);
     }
     finally {
         if (!invocation.detach) {
             await removeDirectory(invocation.supportDirectory);
         }
     }
+    const deploymentRecordPath = invocation.detach && invocation.deploymentName
+        ? await writeDockerDeploymentRecordForRun({
+            authProfileName: authProfile?.name ?? null,
+            envFilePath: resolvedOptions.envFilePath,
+            imageTag,
+            invocation,
+            outputDirectory: buildResult.outputDirectory,
+            report: buildResult.report,
+            runMetadata: runMetadata ?? undefined,
+            targetExecFile: options.targetExecFile
+        })
+        : null;
     return {
         ...buildResult,
         authProfileName: authProfile?.name ?? null,
         containerName: invocation.containerName,
+        deploymentRecordPath,
+        imageTag,
         supportDirectory: invocation.supportDirectory
     };
 };

package/dist/compiler/view/buildOrganizationView.js

@@ -2,6 +2,7 @@ import path from "node:path";
 import { SpawnfileError } from "../../shared/index.js";
 import { buildCompilePlan } from "../buildCompilePlan.js";
 import { resolveMoltnetRoomMemberships } from "../moltnetRoomMemberships.js";
+import { buildDeclaredNodeView, buildRuntimeViews } from "./declarations.js";
 const createNameCounts = (plan) => {
     const counts = new Map();
     for (const node of plan.nodes) {
@@ -30,7 +31,11 @@ const buildTreeNetworkSummaries = (node) => {
         return [];
     }
     return (node.value.networks ?? []).map((network) => ({
+        agentRegistration: network.server?.auth.agent_registration,
         authMode: network.server?.auth.mode,
+        consoleAnalytics: network.server?.mode === "managed"
+            ? network.server.console?.analytics?.provider
+            : undefined,
         debugEvents: network.server?.mode === "managed" ? network.server.debug_events : undefined,
         directMessages: network.server?.mode === "managed" ? network.server.direct_messages : undefined,
         expose: network.server?.mode === "managed" ? network.server.human_ingress : undefined,
@@ -38,11 +43,14 @@ const buildTreeNetworkSummaries = (node) => {
         id: network.id,
         name: network.name,
         provider: network.provider,
+        publicRead: network.server?.auth.public_read,
         serverMode: network.server?.mode,
         url: network.server?.url,
         rooms: network.rooms.map((room) => ({
             declaredMembers: [...room.members],
-            id: room.id
+            id: room.id,
+            ...(room.visibility ? { visibility: room.visibility } : {}),
+            ...(room.write_policy ? { writePolicy: room.write_policy } : {})
         }))
     }));
 };
@@ -75,7 +83,9 @@ const buildTreeNode = (node, nodeById, edgesBySource, nameCounts, ancestors = []
         kind: node.kind,
         name: node.value.name,
         networks: buildTreeNetworkSummaries(node),
+        declared: buildDeclaredNodeView(node),
         runtimeName: node.runtimeName,
+        slug: node.slug,
         source: node.value.source
     };
 };
@@ -107,7 +117,11 @@ const toNetworkMemberView = (membership) => ({
 });
 const createNetworkKey = (provider, networkId) => `${provider}::${networkId}`;
 const buildNetworkDeclaration = (teamNode, network, roomMemberships) => ({
+    agentRegistration: network.server?.auth.agent_registration,
     authMode: network.server?.auth.mode,
+    consoleAnalytics: network.server?.mode === "managed"
+        ? network.server.console?.analytics?.provider
+        : undefined,
     debugEvents: network.server?.mode === "managed" ? network.server.debug_events : undefined,
     declaringTeamName: teamNode.name,
     declaringTeamSource: teamNode.source,
@@ -115,6 +129,7 @@ const buildNetworkDeclaration = (teamNode, network, roomMemberships) => ({
     expose: network.server?.mode === "managed" ? network.server.human_ingress : undefined,
     httpEnabled: network.server?.mode === "managed" ? network.server.human_ingress === true : false,
     name: network.name,
+    publicRead: network.server?.auth.public_read,
     serverMode: network.server?.mode,
     url: network.server?.url,
     rooms: network.rooms.map((room) => {
@@ -126,7 +141,9 @@ const buildNetworkDeclaration = (teamNode, network, roomMemberships) => ({
         return {
             declaredMembers: [...room.members],
             id: room.id,
-            members: sortNetworkMembers(room.members, members)
+            members: sortNetworkMembers(room.members, members),
+            ...(room.visibility ? { visibility: room.visibility } : {}),
+            ...(room.write_policy ? { writePolicy: room.write_policy } : {})
         };
     })
 });
@@ -151,7 +168,9 @@ const buildNetworks = (plan) => {
                 declaringTeamName: declaration.declaringTeamName,
                 declaringTeamSource: declaration.declaringTeamSource,
                 declarations: [declaration],
+                agentRegistration: declaration.agentRegistration,
                 authMode: declaration.authMode,
+                consoleAnalytics: declaration.consoleAnalytics,
                 debugEvents: declaration.debugEvents,
                 directMessages: declaration.directMessages,
                 expose: declaration.expose,
@@ -159,6 +178,7 @@ const buildNetworks = (plan) => {
                 id: network.id,
                 name: declaration.name,
                 provider: network.provider,
+                publicRead: declaration.publicRead,
                 serverMode: declaration.serverMode,
                 url: declaration.url,
                 rooms: declaration.rooms
@@ -171,11 +191,15 @@ const buildNetworks = (plan) => {
         if (firstDeclaration) {
             network.declaringTeamName = firstDeclaration.declaringTeamName;
             network.declaringTeamSource = firstDeclaration.declaringTeamSource;
+            network.agentRegistration = firstDeclaration.agentRegistration;
             network.authMode = firstDeclaration.authMode;
+            network.consoleAnalytics = firstDeclaration.consoleAnalytics;
+            network.debugEvents = firstDeclaration.debugEvents;
             network.directMessages = firstDeclaration.directMessages;
             network.expose = firstDeclaration.expose;
             network.httpEnabled = firstDeclaration.httpEnabled;
             network.name = firstDeclaration.name;
+            network.publicRead = firstDeclaration.publicRead;
             network.serverMode = firstDeclaration.serverMode;
             network.url = firstDeclaration.url;
             network.rooms = firstDeclaration.rooms;
@@ -198,6 +222,6 @@ export const buildOrganizationView = async (inputPath) => {
         networks: buildNetworks(plan),
         projectRoot: path.dirname(plan.root),
         root,
-        runtimes: []
+        runtimes: buildRuntimeViews(plan)
     };
 };

package/dist/compiler/view/declarations.d.ts

@@ -0,0 +1,4 @@
+import type { CompilePlan, CompilePlanNode } from "../types.js";
+import type { OrganizationRuntimeView, OrganizationViewDeclaredSummary } from "./types.js";
+export declare const buildDeclaredNodeView: (node: CompilePlanNode) => OrganizationViewDeclaredSummary;
+export declare const buildRuntimeViews: (plan: CompilePlan) => OrganizationRuntimeView[];

package/dist/compiler/view/declarations.js

@@ -0,0 +1,104 @@
+import { resolveEffectiveModelTarget } from "../modelEnv.js";
+import { listInteractiveSurfaceScopes } from "../interactiveSurfaceScopes.js";
+const summarizeModel = (node) => {
+    if (node.value.kind !== "agent" || !node.value.execution?.model?.primary) {
+        return null;
+    }
+    const target = resolveEffectiveModelTarget(node.value.execution.model.primary, node.value.execution);
+    return {
+        authMethod: target.auth.method,
+        name: target.name,
+        provider: target.provider
+    };
+};
+const summarizeSchedule = (node) => {
+    if (node.value.kind !== "agent" || !node.value.schedule) {
+        return null;
+    }
+    const schedule = node.value.schedule;
+    if (schedule.kind === "cron") {
+        return {
+            expression: schedule.cron,
+            kind: schedule.kind,
+            ...(schedule.timezone ? { timezone: schedule.timezone } : {})
+        };
+    }
+    if (schedule.kind === "every") {
+        return {
+            expression: schedule.every,
+            kind: schedule.kind,
+            ...(schedule.timezone ? { timezone: schedule.timezone } : {})
+        };
+    }
+    return { kind: schedule.kind };
+};
+const surfaceSummaryFor = (name, surfaces) => {
+    if (!surfaces[name]) {
+        return null;
+    }
+    const scopes = name === "moltnet"
+        ? listInteractiveSurfaceScopes(surfaces).filter((scope) => scope.startsWith("moltnet:"))
+        : listInteractiveSurfaceScopes(surfaces).filter((scope) => scope === name);
+    return {
+        name,
+        scopes: scopes.length > 0 ? scopes : [name]
+    };
+};
+const summarizeSurfaces = (node) => {
+    const surfaces = node.value.kind === "agent" ? node.value.surfaces : undefined;
+    if (!surfaces) {
+        return [];
+    }
+    return ["discord", "http", "moltnet", "slack", "telegram", "webhook", "whatsapp"]
+        .map((name) => surfaceSummaryFor(name, surfaces))
+        .filter((surface) => surface !== null);
+};
+const summarizePackages = (node) => {
+    const packages = node.value.kind === "agent"
+        ? node.value.packages ?? []
+        : node.value.shared.packages ?? [];
+    return packages.map((pkg) => ({
+        id: pkg.id,
+        manager: pkg.manager,
+        name: pkg.name,
+        ...(pkg.scope ? { scope: pkg.scope } : {}),
+        ...(pkg.version ? { version: pkg.version } : {})
+    }));
+};
+const summarizeResources = (node) => (node.value.workspaceResources ?? []).map((resource) => ({
+    id: resource.id,
+    kind: resource.kind,
+    mode: resource.mode,
+    mount: resource.mount,
+    sharing: resource.sharing
+}));
+export const buildDeclaredNodeView = (node) => {
+    const skills = node.value.kind === "agent" ? node.value.skills : node.value.shared.skills;
+    const mcpServers = node.value.kind === "agent"
+        ? node.value.mcpServers
+        : node.value.shared.mcpServers;
+    return {
+        docs: node.value.docs.map((doc) => ({ role: doc.role, source: doc.sourcePath })),
+        mcpServers: mcpServers.map((server) => ({
+            name: server.name,
+            transport: server.transport
+        })),
+        model: summarizeModel(node),
+        packages: summarizePackages(node),
+        policy: {
+            mode: node.value.policyMode,
+            onDegrade: node.value.policyOnDegrade
+        },
+        resources: summarizeResources(node),
+        schedule: summarizeSchedule(node),
+        skills: skills.map((skill) => ({
+            name: skill.name,
+            ref: skill.ref,
+            requiresMcp: [...skill.requiresMcp]
+        })),
+        surfaces: summarizeSurfaces(node)
+    };
+};
+export const buildRuntimeViews = (plan) => Object.entries(plan.runtimes)
+    .map(([name, runtime]) => ({ name, nodeIds: [...runtime.nodeIds].sort() }))
+    .sort((left, right) => left.name.localeCompare(right.name));

package/dist/compiler/view/renderNetworks.js

@@ -8,8 +8,7 @@ const formatPolicy = (member) => {
         return [];
     }
     return [
-        member.policy.read ? `read=${member.policy.read}` : undefined,
-        member.policy.reply ? `reply=${member.policy.reply}` : undefined
+        member.policy.wake ? `wake=${member.policy.wake}` : undefined
     ].filter((entry) => entry !== undefined);
 };
 const formatMember = (member, options, projectRoot) => {
@@ -41,6 +40,8 @@ const formatNetwork = (network, options) => {
 const getDeclarations = (network) => network.declarations ?? [
     {
         authMode: network.authMode,
+        agentRegistration: network.agentRegistration,
+        consoleAnalytics: network.consoleAnalytics,
         declaringTeamName: network.declaringTeamName,
         declaringTeamSource: network.declaringTeamSource,
         debugEvents: network.debugEvents,
@@ -48,6 +49,7 @@ const getDeclarations = (network) => network.declarations ?? [
         expose: network.expose,
         httpEnabled: network.httpEnabled,
         name: network.name,
+        publicRead: network.publicRead,
         rooms: network.rooms,
         serverMode: network.serverMode,
         url: network.url
@@ -58,6 +60,9 @@ const formatDeclaration = (network, declaration, options, projectRoot) => {
         declaration.serverMode ? `server=${declaration.serverMode}` : undefined,
         declaration.url ? `url=${declaration.url}` : undefined,
         declaration.authMode ? `auth=${declaration.authMode}` : undefined,
+        declaration.publicRead !== undefined ? `public_read=${declaration.publicRead}` : undefined,
+        declaration.agentRegistration ? `registration=${declaration.agentRegistration}` : undefined,
+        declaration.consoleAnalytics ? `analytics=${declaration.consoleAnalytics}` : undefined,
         declaration.directMessages === false ? "dms=disabled" : undefined,
         declaration.debugEvents === true ? "debug_events" : undefined,
         declaration.expose === true || declaration.httpEnabled ? "human_ingress" : undefined
@@ -88,7 +93,11 @@ export const renderOrganizationNetworks = (view, options = {}) => {
                 const legacyDeclared = options.declared && !view.projectRoot
                     ? ` room ${room.id} declared [${room.declaredMembers.join(", ")}]`
                     : "";
-                lines.push(`${declarationPrefix}${roomLast ? glyphs.last : glyphs.branch}#${room.id}${legacyDeclared}`);
+                const roomMetadata = [
+                    room.visibility ? `visibility=${room.visibility}` : undefined,
+                    room.writePolicy ? `write=${room.writePolicy}` : undefined
+                ].filter((entry) => entry !== undefined);
+                lines.push(`${declarationPrefix}${roomLast ? glyphs.last : glyphs.branch}#${room.id}${roomMetadata.length > 0 ? ` ${roomMetadata.join(" ")}` : ""}${legacyDeclared}`);
                 if (options.declared) {
                     const declaredMembers = room.declaredMembers.length > 0
                         ? room.declaredMembers.join(", ")

package/dist/compiler/view/renderTree.js

@@ -1,5 +1,9 @@
 import { formatSourceMeta } from "./sourcePaths.js";
 const color = (value, code, options) => options.color ? `\u001b[${code}m${value}\u001b[0m` : value;
+const formatAnnotations = (subjectKey, options) => {
+    const annotations = options.annotationFor?.(subjectKey) ?? [];
+    return annotations.length > 0 ? `  ${annotations.join(" ")}` : "";
+};
 const formatNode = (node, options, projectRoot) => {
     const kind = color(node.kind, node.kind === "team" ? "36" : "32", options);
     const metadata = node.kind === "team"
@@ -17,7 +21,7 @@ const formatNode = (node, options, projectRoot) => {
     const details = metadata.filter((entry) => entry !== undefined);
     const source = options.paths ? formatSourceMeta("source", node.source, projectRoot) : "";
     const separator = details[0]?.startsWith("[") ? " " : "  ";
-    return `${kind} ${node.displayName}${details.length > 0 ? `${separator}${details.join(" ")}` : ""}${source}`;
+    return `${kind} ${node.displayName}${details.length > 0 ? `${separator}${details.join(" ")}` : ""}${source}${formatAnnotations(node.id, options)}`;
 };
 const formatEdgeLabel = (edge) => edge.relation === "subagent"
     ? `subagent ${edge.label}`
@@ -28,14 +32,23 @@ const formatNetworkSummary = (network, options) => {
         network.serverMode ? `server=${network.serverMode}` : undefined,
         network.url ? `url=${network.url}` : undefined,
         network.authMode ? `auth=${network.authMode}` : undefined,
+        network.publicRead !== undefined ? `public_read=${network.publicRead}` : undefined,
+        network.agentRegistration ? `registration=${network.agentRegistration}` : undefined,
+        network.consoleAnalytics ? `analytics=${network.consoleAnalytics}` : undefined,
         network.directMessages === false ? "dms=disabled" : undefined,
         network.debugEvents === true ? "debug_events" : undefined,
         network.expose === true || network.httpEnabled ? "human_ingress" : undefined
     ].filter((entry) => entry !== undefined);
     const rooms = network.rooms
-        .map((room) => `${room.id} [${room.declaredMembers.join(", ")}]`)
+        .map((room) => {
+        const roomMetadata = [
+            room.visibility ? `visibility=${room.visibility}` : undefined,
+            room.writePolicy ? `write=${room.writePolicy}` : undefined
+        ].filter((entry) => entry !== undefined);
+        return `${room.id}${roomMetadata.length > 0 ? ` ${roomMetadata.join(" ")}` : ""} [${room.declaredMembers.join(", ")}]`;
+    })
         .join("; ");
-    return `network ${id} "${network.name}"${metadata.length > 0 ? ` ${metadata.join(" ")}` : ""}: ${rooms}`;
+    return `network ${id} "${network.name}"${metadata.length > 0 ? ` ${metadata.join(" ")}` : ""}: ${rooms}${formatAnnotations(`network:${network.id}`, options)}`;
 };
 const renderChildren = (node, options, projectRoot, prefix = "") => {
     const glyphs = options.ascii

package/dist/compiler/view/types.d.ts

@@ -1,6 +1,63 @@
 import type { ResolvedMoltnetRoomPolicy } from "../types.js";
+export interface OrganizationViewDocSummary {
+    role: string;
+    source: string;
+}
+export interface OrganizationViewSkillSummary {
+    name: string;
+    ref: string;
+    requiresMcp: string[];
+}
+export interface OrganizationViewResourceSummary {
+    id: string;
+    kind: "git" | "volume";
+    mode: "mutable" | "readonly";
+    mount: string;
+    sharing: "per_agent" | "team";
+}
+export interface OrganizationViewPackageSummary {
+    id: string;
+    manager: string;
+    name: string;
+    scope?: string;
+    version?: string;
+}
+export interface OrganizationViewMcpSummary {
+    name: string;
+    transport: "sse" | "stdio" | "streamable_http";
+}
+export interface OrganizationViewModelSummary {
+    authMethod: string;
+    name: string;
+    provider: string;
+}
+export interface OrganizationViewScheduleSummary {
+    expression?: string;
+    kind: "cron" | "disabled" | "every";
+    timezone?: string;
+}
+export interface OrganizationViewSurfaceSummary {
+    name: string;
+    scopes: string[];
+}
+export interface OrganizationViewPolicySummary {
+    mode: string | null;
+    onDegrade: string | null;
+}
+export interface OrganizationViewDeclaredSummary {
+    docs: OrganizationViewDocSummary[];
+    mcpServers: OrganizationViewMcpSummary[];
+    model: OrganizationViewModelSummary | null;
+    packages: OrganizationViewPackageSummary[];
+    policy: OrganizationViewPolicySummary;
+    resources: OrganizationViewResourceSummary[];
+    schedule: OrganizationViewScheduleSummary | null;
+    skills: OrganizationViewSkillSummary[];
+    surfaces: OrganizationViewSurfaceSummary[];
+}
 export interface OrganizationViewTreeNode {
     children: OrganizationViewTreeEdge[];
+    declared?: OrganizationViewDeclaredSummary;
     displayName: string;
     external?: string[];
     id: string;
@@ -10,14 +67,19 @@ export interface OrganizationViewTreeNode {
     name: string;
     networks?: OrganizationTreeNetworkSummary[];
     runtimeName: string | null;
+    slug?: string;
     source: string;
 }
 export interface OrganizationTreeNetworkRoomSummary {
     declaredMembers: string[];
     id: string;
+    visibility?: "public" | "private";
+    writePolicy?: "members" | "operators" | "registered_agents";
 }
 export interface OrganizationTreeNetworkSummary {
+    agentRegistration?: "disabled" | "open" | "token";
     authMode?: "bearer" | "none" | "open";
+    consoleAnalytics?: string;
     debugEvents?: boolean;
     directMessages?: boolean;
     expose?: boolean;
@@ -25,6 +87,7 @@ export interface OrganizationTreeNetworkSummary {
     id: string;
     name: string;
     provider: "moltnet";
+    publicRead?: boolean;
     serverMode?: "external" | "managed";
     url?: string;
     rooms: OrganizationTreeNetworkRoomSummary[];
@@ -48,7 +111,9 @@ export interface OrganizationNetworkMemberView {
     representativePath?: string[];
 }
 export interface OrganizationNetworkDeclarationView {
+    agentRegistration?: "disabled" | "open" | "token";
     authMode?: "bearer" | "none" | "open";
+    consoleAnalytics?: string;
     debugEvents?: boolean;
     declaringTeamName: string;
     declaringTeamSource: string;
@@ -56,6 +121,7 @@ export interface OrganizationNetworkDeclarationView {
     expose?: boolean;
     httpEnabled?: boolean;
     name: string;
+    publicRead?: boolean;
     rooms: OrganizationNetworkRoomView[];
     serverMode?: "external" | "managed";
     url?: string;
@@ -64,9 +130,13 @@ export interface OrganizationNetworkRoomView {
     declaredMembers: string[];
     id: string;
     members: OrganizationNetworkMemberView[];
+    visibility?: "public" | "private";
+    writePolicy?: "members" | "operators" | "registered_agents";
 }
 export interface OrganizationNetworkView {
+    agentRegistration?: "disabled" | "open" | "token";
     authMode?: "bearer" | "none" | "open";
+    consoleAnalytics?: string;
     debugEvents?: boolean;
     declaringTeamName: string;
     declaringTeamSource: string;
@@ -76,11 +146,16 @@ export interface OrganizationNetworkView {
     id: string;
     name: string;
     provider: "moltnet";
+    publicRead?: boolean;
     rooms: OrganizationNetworkRoomView[];
     serverMode?: "external" | "managed";
     url?: string;
     declarations?: OrganizationNetworkDeclarationView[];
 }
+export interface OrganizationRuntimeView {
+    name: string;
+    nodeIds: string[];
+}
 export interface OrganizationView {
     contexts: [];
     diagnostics: [];
@@ -88,9 +163,10 @@ export interface OrganizationView {
     networks: OrganizationNetworkView[];
     projectRoot?: string;
     root: OrganizationViewTreeNode;
-    runtimes: [];
+    runtimes: OrganizationRuntimeView[];
 }
 export interface RenderOrganizationViewOptions {
+    annotationFor?: (subjectKey: string) => string[];
     ascii?: boolean;
     color?: boolean;
     declared?: boolean;

package/dist/deployment/dockerInspect.d.ts

@@ -0,0 +1,29 @@
+import type { DeploymentRecord } from "./record.js";
+export type DockerInspectExecFile = (file: string, args: string[], options: {
+    timeout: number;
+}) => Promise<{
+    stderr: string;
+    stdout: string;
+}>;
+export interface DockerUnitInspection {
+    containerId: string | null;
+    drift: string[];
+    exists: boolean | null;
+    exitCode: number | null;
+    finishedAt: string | null;
+    imageId: string | null;
+    message: string;
+    restartCount: number | null;
+    running: boolean | null;
+    severity: "error" | "ok" | "unknown" | "warn";
+    startedAt: string | null;
+    status: string | null;
+    unitId: string;
+}
+export type DockerInspectionResult = Map<string, DockerUnitInspection>;
+export interface DockerInspectOptions {
+    dockerCommand?: string;
+    execFile?: DockerInspectExecFile;
+    timeoutMs?: number;
+}
+export declare const inspectDockerDeployment: (record: DeploymentRecord, options?: DockerInspectOptions) => Promise<DockerInspectionResult>;