Function codingSpawnRoute

packages/cli/src/server/api/coding/coding_spawn.ts:36–162

(app)

 * what happened.
 */
export const codingSpawnRoute: FastifyPluginAsync = async (app) => {
	app.post<{
		Body: {agent?: string; dir?: string; sessionId?: string};
	}>('/spawn', async (req, reply) => {
		const body = (req.body ?? {}) as {
			agent?: string;
			dir?: string;
			sessionId?: string;
		};

		if (!body.agent || !body.dir) {
			reply.code(400);
			return {ok: false, error: 'agent and dir are required'};
		}
		if (!existsSync(body.dir)) {
			reply.code(400);
			return {ok: false, error: `dir "${body.dir}" does not exist`};
		}
		if (listFolders().length > 0) {
			const folder = resolveFolderForPath(body.dir, 'coding');
			if (!folder) {
				reply.code(403);
				return {
					ok: false,
					error: `dir "${body.dir}" is not inside a coding-scoped folder`,
				};
			}
		}
		const config = getAgentConfig(body.agent);
		if (!config) {
			reply.code(400);
			return {
				ok: false,
				error: `agent "${body.agent}" is not configured on this gateway`,
			};
		}

		const isResume = Boolean(body.sessionId);

		// Reconnect short-circuit: if the PTY is live for this id, don't respawn
		// — xterm `attach` will replay the scrollback and keep streaming. Stale
		// (exited) handles at the same id are dropped by `ptyManager.spawn`.
		if (isResume && ptyManager.isRunning(body.sessionId!)) {
			return {
				ok: true,
				sessionId: body.sessionId,
				pid: ptyManager.getPid(body.sessionId!),
				status: 'reconnect',
			};
		}

		let sessionId = body.sessionId ?? randomUUID();
		const args = isResume
			? buildResumeArgs(config, {sessionId})
			: buildStartArgs(config, {sessionId});

		if (isResume && args.length === 0) {
			reply.code(400);