import type { DevProcessRegistry, DevProcessSummary } from "../dev-process-registry.js";
import type { SessionStore } from "../storage.js";
import type { DetectedDevServer } from "../wire.js";
/**
 * `GET /api/dev-processes` — list machine-level background dev processes.
 *
 * Returns an empty list when the registry has not been constructed yet (tests
 * or a minimal serve setup), matching the MCP-status handler's defensive
 * no-op pattern.
 */
export declare function handleListDevProcesses(registry: DevProcessRegistry | undefined): Promise<DevProcessSummary[]>;
/**
 * `DELETE /api/dev-processes/:id` — kill a machine-level dev process.
 *
 * Throws `NotFoundError` (404) when the process is not tracked by the
 * registry, so the relay dispatcher can return the canonical error payload.
 */
export declare function handleKillDevProcess(registry: DevProcessRegistry | undefined, id: string): {
    ok: true;
};
/**
 * `POST /api/dev-processes` — persist a dev-server definition and spawn it.
 *
 * Security model for the MVP: `cwd` must be an absolute directory that is
 * either a known project path or resolves under the serve cwd. `command` must
 * have no shell metacharacters AND must either be an already-persisted
 * definition or match a fixed allow-list of dev commands.
 */
export declare function handleStartDevProcess(registry: DevProcessRegistry | undefined, store: SessionStore, body: Record<string, unknown>, serveCwd?: string): DevProcessSummary;
/**
 * `POST /api/dev-processes/:id/restart` — kill a dev process and re-spawn it
 * from the definition captured by its live record.
 */
export declare function handleRestartDevProcess(registry: DevProcessRegistry | undefined, id: string): DevProcessSummary;
/**
 * `GET /api/dev-servers` — scan the machine's listening TCP ports and match
 * them against known projects. Includes servers the agent did not start.
 */
export declare function handleScanDevServers(store: SessionStore, registry?: DevProcessRegistry): Promise<DetectedDevServer[]>;
/**
 * `DELETE /api/dev-servers/:pid` — kill a detected dev server.
 *
 * Only servers whose cwd resolves to a known project may be killed, mirroring
 * the project-ownership guard used by the tracked dev-process handlers.
 */
export declare function handleKillDetectedDevServer(store: SessionStore, pid: number, port?: number): Promise<{
    ok: true;
}>;
//# sourceMappingURL=dev-processes.d.ts.map