aimux-cli 0.1.16 → 0.1.19

package/dist/runtime-core/topology-services.js

@@ -0,0 +1,170 @@
+import { basename } from "node:path";
+import { getProjectId, getRepoRoot } from "../paths.js";
+import { createRuntimeTopologyStore, emptyRuntimeTopology, } from "./topology-store.js";
+function serviceNodeId(serviceId) {
+    return `service:${serviceId}`;
+}
+function serviceBindingId(serviceId) {
+    return `tmux:service:${serviceId}`;
+}
+function ensureRig(topology, projectRoot, now) {
+    const id = getProjectId();
+    const existing = topology.rigs.find((rig) => rig.id === id);
+    if (existing) {
+        existing.projectRoot = projectRoot;
+        existing.name = basename(projectRoot);
+        existing.updatedAt = now;
+        return existing.id;
+    }
+    topology.rigs.push({
+        id,
+        name: basename(projectRoot),
+        projectRoot,
+        createdAt: now,
+        updatedAt: now,
+    });
+    return id;
+}
+function upsertServiceNode(topology, service, rigId, now) {
+    const nodeId = serviceNodeId(service.id);
+    const existing = topology.nodes.find((node) => node.id === nodeId);
+    const next = {
+        id: nodeId,
+        rigId,
+        logicalId: service.id,
+        role: "service",
+        runtime: "service",
+        toolConfigKey: "service",
+        cwd: service.cwd ?? service.worktreePath,
+        label: service.label,
+        createdAt: existing?.createdAt ?? service.createdAt ?? now,
+    };
+    if (existing) {
+        Object.assign(existing, next);
+        return existing;
+    }
+    topology.nodes.push(next);
+    return next;
+}
+function serviceToTopologyService(service, rigId, nodeId, status, now) {
+    return {
+        id: service.id,
+        rigId,
+        nodeId,
+        status,
+        command: service.command,
+        args: service.args ?? [],
+        launchCommandLine: service.launchCommandLine,
+        worktreePath: service.worktreePath,
+        cwd: service.cwd,
+        label: service.label,
+        createdAt: service.createdAt ?? now,
+        updatedAt: now,
+        lastSeenAt: status === "running" || status === "starting" ? (service.lastSeenAt ?? now) : undefined,
+    };
+}
+function serviceToBinding(service, nodeId, status, now) {
+    if (status !== "running" && status !== "starting" && status !== "stopped")
+        return undefined;
+    const target = service.tmuxTarget;
+    if (!target)
+        return undefined;
+    return {
+        id: serviceBindingId(service.id),
+        nodeId,
+        tmuxSession: target.sessionName,
+        tmuxWindowId: target.windowId,
+        tmuxWindowIndex: target.windowIndex,
+        tmuxWindowName: target.windowName,
+        updatedAt: now,
+    };
+}
+export function topologyServiceToServiceState(service, topology) {
+    const node = service.nodeId ? topology.nodes.find((entry) => entry.id === service.nodeId) : undefined;
+    const binding = service.nodeId ? topology.bindings.find((entry) => entry.nodeId === service.nodeId) : undefined;
+    return {
+        id: service.id,
+        status: service.status,
+        command: service.command,
+        args: service.args ?? [],
+        launchCommandLine: service.launchCommandLine,
+        worktreePath: service.worktreePath,
+        cwd: service.cwd ?? node?.cwd,
+        label: service.label ?? node?.label,
+        createdAt: service.createdAt,
+        lastSeenAt: service.lastSeenAt,
+        retained: service.status === "stopped" && Boolean(binding),
+        tmuxTarget: binding?.tmuxSession && binding.tmuxWindowId && typeof binding.tmuxWindowIndex === "number"
+            ? {
+                sessionName: binding.tmuxSession,
+                windowId: binding.tmuxWindowId,
+                windowIndex: binding.tmuxWindowIndex,
+                windowName: binding.tmuxWindowName ?? service.label ?? service.id,
+            }
+            : undefined,
+    };
+}
+export function listTopologyServiceStates(input) {
+    const topology = (input?.store ?? createRuntimeTopologyStore()).read();
+    const statuses = input?.statuses ? new Set(input.statuses) : undefined;
+    return topology.services
+        .filter((service) => !statuses || statuses.has(service.status))
+        .map((service) => topologyServiceToServiceState(service, topology));
+}
+export function upsertTopologyService(service, status, input) {
+    const store = input?.store ?? createRuntimeTopologyStore();
+    const now = input?.now ?? new Date().toISOString();
+    const projectRoot = input?.projectRoot ?? getRepoRoot();
+    return store.update((current) => {
+        const topology = current.version ? current : emptyRuntimeTopology(now);
+        topology.generatedAt = now;
+        const rigId = ensureRig(topology, projectRoot, now);
+        const node = upsertServiceNode(topology, service, rigId, now);
+        const nextService = serviceToTopologyService(service, rigId, node.id, status, now);
+        topology.services = [...topology.services.filter((entry) => entry.id !== service.id), nextService];
+        const binding = serviceToBinding(service, node.id, status, now);
+        topology.bindings = binding
+            ? [...topology.bindings.filter((entry) => entry.id !== binding.id), binding]
+            : topology.bindings.filter((entry) => entry.nodeId !== node.id);
+        return topology;
+    });
+}
+export function removeTopologyService(serviceId, input) {
+    const store = input?.store ?? createRuntimeTopologyStore();
+    let removed;
+    store.update((topology) => {
+        const existing = topology.services.find((service) => service.id === serviceId);
+        if (!existing)
+            return topology;
+        removed = topologyServiceToServiceState(existing, topology);
+        topology.generatedAt = input?.now ?? new Date().toISOString();
+        topology.services = topology.services.filter((service) => service.id !== serviceId);
+        if (existing.nodeId) {
+            topology.bindings = topology.bindings.filter((binding) => binding.nodeId !== existing.nodeId);
+            topology.nodes = topology.nodes.filter((node) => node.id !== existing.nodeId);
+        }
+        topology.lifecycleOperations = topology.lifecycleOperations.filter((operation) => !(operation.targetKind === "service" && operation.targetId === serviceId));
+        return topology;
+    });
+    return removed;
+}
+export function removeTopologyServicesForWorktree(worktreePath, input) {
+    const store = input?.store ?? createRuntimeTopologyStore();
+    const now = input?.now ?? new Date().toISOString();
+    let removed = [];
+    store.update((topology) => {
+        const removing = topology.services.filter((service) => service.worktreePath === worktreePath);
+        if (removing.length === 0)
+            return topology;
+        const removingServiceIds = new Set(removing.map((service) => service.id));
+        const removingNodeIds = new Set(removing.map((service) => service.nodeId).filter(Boolean));
+        removed = removing.map((service) => topologyServiceToServiceState(service, topology));
+        topology.generatedAt = now;
+        topology.services = topology.services.filter((service) => !removingServiceIds.has(service.id));
+        topology.bindings = topology.bindings.filter((binding) => !removingNodeIds.has(binding.nodeId));
+        topology.nodes = topology.nodes.filter((node) => !removingNodeIds.has(node.id));
+        topology.lifecycleOperations = topology.lifecycleOperations.filter((operation) => !(operation.targetKind === "service" && removingServiceIds.has(operation.targetId)));
+        return topology;
+    });
+    return removed;
+}

package/dist/runtime-core/topology-sessions.d.ts

@@ -0,0 +1,52 @@
+import { type RuntimeTopology, type RuntimeTopologySession, type RuntimeTopologySessionStatus, type RuntimeTopologyStore } from "./topology-store.js";
+export type RuntimeTopologySessionState = {
+    id: string;
+    tool: string;
+    toolConfigKey: string;
+    command: string;
+    args: string[];
+    status?: RuntimeTopologySessionStatus;
+    lifecycle?: "live" | "offline";
+    createdAt?: string;
+    backendSessionId?: string;
+    team?: unknown;
+    worktreePath?: string;
+    label?: string;
+    headline?: string;
+    tmuxTarget?: {
+        sessionName: string;
+        windowId: string;
+        windowIndex: number;
+        windowName: string;
+    };
+};
+type SaveRuntimeTopologySessionsInput = {
+    sessions: RuntimeTopologySessionState[];
+    projectRoot?: string;
+    now?: string;
+    store?: RuntimeTopologyStore;
+};
+export declare function topologySessionToSessionState(session: RuntimeTopologySession, topology: RuntimeTopology): RuntimeTopologySessionState;
+export declare function listTopologySessionStates(input?: {
+    statuses?: RuntimeTopologySessionStatus[];
+    store?: RuntimeTopologyStore;
+}): RuntimeTopologySessionState[];
+export declare function saveRuntimeTopologySessions(input: SaveRuntimeTopologySessionsInput): RuntimeTopology;
+export declare function upsertTopologySession(session: RuntimeTopologySessionState, status: RuntimeTopologySessionStatus, input?: {
+    store?: RuntimeTopologyStore;
+    now?: string;
+    projectRoot?: string;
+}): RuntimeTopology;
+export declare function moveTopologySessionToGraveyard(sessionId: string, input?: {
+    store?: RuntimeTopologyStore;
+    now?: string;
+}): RuntimeTopologySessionState | undefined;
+export declare function removeTopologySessionsForWorktree(worktreePath: string, input?: {
+    store?: RuntimeTopologyStore;
+    now?: string;
+}): RuntimeTopologySessionState[];
+export declare function resurrectTopologySession(sessionId: string, input?: {
+    store?: RuntimeTopologyStore;
+    now?: string;
+}): RuntimeTopologySessionState | undefined;
+export {};

package/dist/runtime-core/topology-sessions.js

@@ -0,0 +1,238 @@
+import { basename } from "node:path";
+import { getProjectId, getRepoRoot } from "../paths.js";
+import { createRuntimeTopologyStore, emptyRuntimeTopology, } from "./topology-store.js";
+function nodeIdForSession(sessionId) {
+    return `agent:${sessionId}`;
+}
+function bindingIdForSession(sessionId) {
+    return `tmux:${sessionId}`;
+}
+function statusFromLifecycle(lifecycle) {
+    return lifecycle === "offline" ? "offline" : "running";
+}
+function lifecycleFromStatus(status) {
+    if (status === "offline")
+        return "offline";
+    if (status === "graveyard")
+        return undefined;
+    return "live";
+}
+function ensureRig(topology, projectRoot, now) {
+    const id = getProjectId();
+    const existing = topology.rigs.find((rig) => rig.id === id);
+    if (existing) {
+        existing.projectRoot = projectRoot;
+        existing.name = basename(projectRoot);
+        existing.updatedAt = now;
+        return existing.id;
+    }
+    topology.rigs.push({
+        id,
+        name: basename(projectRoot),
+        projectRoot,
+        createdAt: now,
+        updatedAt: now,
+    });
+    return id;
+}
+function upsertNode(topology, session, rigId, now) {
+    const nodeId = nodeIdForSession(session.id);
+    const existing = topology.nodes.find((node) => node.id === nodeId);
+    const next = {
+        id: nodeId,
+        rigId,
+        logicalId: session.id,
+        role: typeof session.team?.role === "string" ? session.team.role : undefined,
+        runtime: session.toolConfigKey ?? session.tool ?? session.command,
+        toolConfigKey: session.toolConfigKey ?? session.tool ?? session.command,
+        cwd: session.worktreePath,
+        label: session.label,
+        createdAt: existing?.createdAt ?? session.createdAt ?? now,
+    };
+    if (existing) {
+        Object.assign(existing, next);
+        return existing;
+    }
+    topology.nodes.push(next);
+    return next;
+}
+function sessionToTopologySession(session, nodeId, now) {
+    return {
+        id: session.id,
+        nodeId,
+        status: statusFromLifecycle(session.lifecycle),
+        tool: session.tool,
+        command: session.command,
+        args: session.args ?? [],
+        backendSessionId: session.backendSessionId,
+        worktreePath: session.worktreePath,
+        label: session.label,
+        headline: session.headline,
+        team: session.team,
+        createdAt: session.createdAt ?? now,
+        updatedAt: now,
+        lastSeenAt: session.lifecycle === "offline" ? undefined : now,
+    };
+}
+function sessionToBinding(session, nodeId, now) {
+    if (session.lifecycle === "offline")
+        return undefined;
+    const target = session.tmuxTarget;
+    if (!target)
+        return undefined;
+    return {
+        id: bindingIdForSession(session.id),
+        nodeId,
+        tmuxSession: target.sessionName,
+        tmuxWindowId: target.windowId,
+        tmuxWindowIndex: target.windowIndex,
+        tmuxWindowName: target.windowName,
+        updatedAt: now,
+    };
+}
+export function topologySessionToSessionState(session, topology) {
+    const node = topology.nodes.find((entry) => entry.id === session.nodeId);
+    const binding = session.status === "running" || session.status === "idle" || session.status === "starting"
+        ? topology.bindings.find((entry) => entry.nodeId === session.nodeId)
+        : undefined;
+    const tool = session.tool ?? node?.toolConfigKey ?? session.command ?? "unknown";
+    return {
+        id: session.id,
+        tool,
+        toolConfigKey: node?.toolConfigKey ?? tool,
+        command: session.command ?? tool,
+        args: session.args ?? [],
+        status: session.status,
+        lifecycle: lifecycleFromStatus(session.status),
+        createdAt: session.createdAt,
+        backendSessionId: session.backendSessionId,
+        team: session.team,
+        worktreePath: session.worktreePath ?? node?.cwd,
+        label: session.label ?? node?.label,
+        headline: session.headline,
+        tmuxTarget: binding?.tmuxSession && binding.tmuxWindowId && typeof binding.tmuxWindowIndex === "number"
+            ? {
+                sessionName: binding.tmuxSession,
+                windowId: binding.tmuxWindowId,
+                windowIndex: binding.tmuxWindowIndex,
+                windowName: binding.tmuxWindowName ?? session.command ?? tool,
+            }
+            : undefined,
+    };
+}
+export function listTopologySessionStates(input) {
+    const topology = (input?.store ?? createRuntimeTopologyStore()).read();
+    const statuses = input?.statuses ? new Set(input.statuses) : undefined;
+    return topology.sessions
+        .filter((session) => !statuses || statuses.has(session.status))
+        .map((session) => topologySessionToSessionState(session, topology));
+}
+export function saveRuntimeTopologySessions(input) {
+    const store = input.store ?? createRuntimeTopologyStore();
+    const now = input.now ?? new Date().toISOString();
+    const projectRoot = input.projectRoot ?? getRepoRoot();
+    return store.update((current) => {
+        const topology = current.version ? current : emptyRuntimeTopology(now);
+        topology.generatedAt = now;
+        const rigId = ensureRig(topology, projectRoot, now);
+        const nextSessionIds = new Set(input.sessions.map((session) => session.id));
+        const preservedGraveyard = topology.sessions.filter((session) => session.status === "graveyard" && !nextSessionIds.has(session.id));
+        const nextNodes = [];
+        const nextBindings = [];
+        const nextSessions = [];
+        for (const session of input.sessions) {
+            const node = upsertNode(topology, session, rigId, now);
+            nextNodes.push(node);
+            const binding = sessionToBinding(session, node.id, now);
+            if (binding)
+                nextBindings.push(binding);
+            nextSessions.push(sessionToTopologySession(session, node.id, now));
+        }
+        const activeNodeIds = new Set(nextNodes.map((node) => node.id));
+        const preservedServiceNodeIds = new Set(topology.services.map((service) => service.nodeId).filter(Boolean));
+        const preservedNodes = topology.nodes.filter((node) => preservedServiceNodeIds.has(node.id) || preservedGraveyard.some((session) => session.nodeId === node.id));
+        topology.nodes = [...preservedNodes.filter((node) => !activeNodeIds.has(node.id)), ...nextNodes];
+        topology.bindings = [
+            ...topology.bindings.filter((binding) => preservedServiceNodeIds.has(binding.nodeId)),
+            ...nextBindings,
+        ];
+        topology.sessions = [...preservedGraveyard, ...nextSessions];
+        const retainedNodeIds = new Set(topology.nodes.map((node) => node.id));
+        topology.edges = topology.edges.filter((edge) => retainedNodeIds.has(edge.sourceNodeId) && retainedNodeIds.has(edge.targetNodeId));
+        const retainedSessionIds = new Set(topology.sessions.map((session) => session.id));
+        topology.exchangeRefs = topology.exchangeRefs.filter((ref) => (!ref.sessionId || retainedSessionIds.has(ref.sessionId)) && (!ref.nodeId || retainedNodeIds.has(ref.nodeId)));
+        return topology;
+    });
+}
+export function upsertTopologySession(session, status, input) {
+    const store = input?.store ?? createRuntimeTopologyStore();
+    const now = input?.now ?? new Date().toISOString();
+    const projectRoot = input?.projectRoot ?? getRepoRoot();
+    return store.update((topology) => {
+        topology.generatedAt = now;
+        const rigId = ensureRig(topology, projectRoot, now);
+        const node = upsertNode(topology, session, rigId, now);
+        const nextSession = { ...sessionToTopologySession(session, node.id, now), status };
+        topology.sessions = [...topology.sessions.filter((entry) => entry.id !== session.id), nextSession];
+        const shouldBind = status === "running" || status === "idle" || status === "starting";
+        const binding = shouldBind ? sessionToBinding({ ...session, lifecycle: "live" }, node.id, now) : undefined;
+        topology.bindings = binding
+            ? [...topology.bindings.filter((entry) => entry.id !== binding.id), binding]
+            : topology.bindings.filter((entry) => entry.nodeId !== node.id);
+        return topology;
+    });
+}
+export function moveTopologySessionToGraveyard(sessionId, input) {
+    const store = input?.store ?? createRuntimeTopologyStore();
+    const now = input?.now ?? new Date().toISOString();
+    let moved;
+    store.update((topology) => {
+        const existing = topology.sessions.find((entry) => entry.id === sessionId);
+        if (existing) {
+            existing.status = "graveyard";
+            existing.updatedAt = now;
+            topology.bindings = topology.bindings.filter((binding) => binding.nodeId !== existing.nodeId);
+            moved = topologySessionToSessionState(existing, topology);
+            return topology;
+        }
+        return topology;
+    });
+    return moved;
+}
+export function removeTopologySessionsForWorktree(worktreePath, input) {
+    const store = input?.store ?? createRuntimeTopologyStore();
+    const now = input?.now ?? new Date().toISOString();
+    let removed = [];
+    store.update((topology) => {
+        const removing = topology.sessions.filter((session) => session.worktreePath === worktreePath);
+        if (removing.length === 0)
+            return topology;
+        const removingSessionIds = new Set(removing.map((session) => session.id));
+        const removingNodeIds = new Set(removing.map((session) => session.nodeId));
+        removed = removing.map((session) => topologySessionToSessionState(session, topology));
+        topology.generatedAt = now;
+        topology.sessions = topology.sessions.filter((session) => !removingSessionIds.has(session.id));
+        topology.bindings = topology.bindings.filter((binding) => !removingNodeIds.has(binding.nodeId));
+        topology.nodes = topology.nodes.filter((node) => !removingNodeIds.has(node.id));
+        topology.lifecycleOperations = topology.lifecycleOperations.filter((operation) => !(operation.targetKind === "session" && removingSessionIds.has(operation.targetId)));
+        topology.exchangeRefs = topology.exchangeRefs.filter((ref) => (!ref.sessionId || !removingSessionIds.has(ref.sessionId)) && (!ref.nodeId || !removingNodeIds.has(ref.nodeId)));
+        return topology;
+    });
+    return removed;
+}
+export function resurrectTopologySession(sessionId, input) {
+    const store = input?.store ?? createRuntimeTopologyStore();
+    const now = input?.now ?? new Date().toISOString();
+    let restored;
+    store.update((topology) => {
+        const session = topology.sessions.find((entry) => entry.id === sessionId && entry.status === "graveyard");
+        if (!session)
+            return topology;
+        session.status = "offline";
+        session.updatedAt = now;
+        topology.bindings = topology.bindings.filter((binding) => binding.nodeId !== session.nodeId);
+        restored = topologySessionToSessionState(session, topology);
+        return topology;
+    });
+    return restored;
+}

package/dist/runtime-core/topology-store.d.ts

@@ -0,0 +1,171 @@
+export declare const RUNTIME_TOPOLOGY_VERSION = 1;
+export type RuntimeTopologySessionStatus = "planned" | "starting" | "running" | "idle" | "offline" | "graveyard" | "error";
+export type RuntimeTopologyServiceStatus = "planned" | "starting" | "running" | "stopped" | "offline" | "error";
+export type RuntimeTopologyWorktreeStatus = "planned" | "creating" | "active" | "removing" | "graveyard" | "missing" | "error";
+export type RuntimeTopologyLifecycleOperationStatus = "pending" | "running" | "succeeded" | "failed" | "cancelled";
+export type RuntimeTopologyLifecycleOperationTargetKind = "session" | "service" | "worktree" | "node" | "rig";
+export interface RuntimeTopologyRig {
+    id: string;
+    name: string;
+    projectRoot: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RuntimeTopologyNode {
+    id: string;
+    rigId: string;
+    logicalId: string;
+    role?: string;
+    runtime?: string;
+    toolConfigKey?: string;
+    model?: string;
+    cwd?: string;
+    label?: string;
+    createdAt: string;
+}
+export interface RuntimeTopologyEdge {
+    id: string;
+    rigId: string;
+    sourceNodeId: string;
+    targetNodeId: string;
+    kind: string;
+    createdAt: string;
+}
+export interface RuntimeTopologyBinding {
+    id: string;
+    nodeId: string;
+    tmuxSession?: string;
+    tmuxWindowId?: string;
+    tmuxWindowIndex?: number;
+    tmuxWindowName?: string;
+    tmuxPane?: string;
+    updatedAt: string;
+}
+export interface RuntimeTopologySession {
+    id: string;
+    nodeId: string;
+    status: RuntimeTopologySessionStatus;
+    tool?: string;
+    command?: string;
+    args?: string[];
+    backendSessionId?: string;
+    worktreePath?: string;
+    label?: string;
+    headline?: string;
+    team?: unknown;
+    createdAt: string;
+    updatedAt: string;
+    lastSeenAt?: string;
+}
+export interface RuntimeTopologyService {
+    id: string;
+    rigId: string;
+    nodeId?: string;
+    status: RuntimeTopologyServiceStatus;
+    command?: string;
+    args?: string[];
+    launchCommandLine?: string;
+    worktreePath?: string;
+    cwd?: string;
+    label?: string;
+    createdAt: string;
+    updatedAt: string;
+    lastSeenAt?: string;
+}
+export interface RuntimeTopologyWorktree {
+    id: string;
+    rigId: string;
+    path: string;
+    name: string;
+    status: RuntimeTopologyWorktreeStatus;
+    branch?: string;
+    head?: string;
+    basePath?: string;
+    createdAt: string;
+    updatedAt: string;
+    removedAt?: string;
+    operationFailure?: string;
+}
+export interface RuntimeTopologyWorktreeGraveyardEntry {
+    id: string;
+    rigId: string;
+    worktreeId?: string;
+    path: string;
+    name?: string;
+    branch?: string;
+    graveyardedAt: string;
+    reason?: string;
+    deletedAt?: string;
+}
+export interface RuntimeTopologyTeamRole {
+    id: string;
+    rigId: string;
+    nodeId?: string;
+    parentNodeId?: string;
+    role: string;
+    label?: string;
+    order?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RuntimeTopologyRemoteClient {
+    id: string;
+    rigId: string;
+    userId?: string;
+    displayName?: string;
+    shareId?: string;
+    ownerUserId?: string;
+    status: "online" | "stale" | "offline";
+    connectedAt?: string;
+    lastSeenAt: string;
+    ownsSessionIds?: string[];
+}
+export interface RuntimeTopologyLifecycleOperation {
+    id: string;
+    rigId: string;
+    kind: string;
+    status: RuntimeTopologyLifecycleOperationStatus;
+    targetKind: RuntimeTopologyLifecycleOperationTargetKind;
+    targetId: string;
+    requestedBy?: string;
+    startedAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    error?: string;
+}
+export interface RuntimeTopologyExchangeRef {
+    id: string;
+    rigId: string;
+    kind: "message" | "handoff" | "task" | "review" | "plan" | "wait" | "continuity" | "attachment";
+    exchangeId: string;
+    nodeId?: string;
+    sessionId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RuntimeTopology {
+    version: typeof RUNTIME_TOPOLOGY_VERSION;
+    generatedAt: string;
+    rigs: RuntimeTopologyRig[];
+    nodes: RuntimeTopologyNode[];
+    edges: RuntimeTopologyEdge[];
+    bindings: RuntimeTopologyBinding[];
+    sessions: RuntimeTopologySession[];
+    services: RuntimeTopologyService[];
+    worktrees: RuntimeTopologyWorktree[];
+    worktreeGraveyard: RuntimeTopologyWorktreeGraveyardEntry[];
+    teamRoles: RuntimeTopologyTeamRole[];
+    remoteClients: RuntimeTopologyRemoteClient[];
+    lifecycleOperations: RuntimeTopologyLifecycleOperation[];
+    exchangeRefs: RuntimeTopologyExchangeRef[];
+}
+export declare function emptyRuntimeTopology(now?: string): RuntimeTopology;
+export declare class RuntimeTopologyStore {
+    readonly path: string;
+    constructor(path?: string);
+    read(): RuntimeTopology;
+    write(topology: RuntimeTopology): RuntimeTopology;
+    private acquireUpdateLock;
+    update(mutator: (topology: RuntimeTopology) => RuntimeTopology): RuntimeTopology;
+}
+export declare function createRuntimeTopologyStore(path?: string): RuntimeTopologyStore;