sandbox-agent/examples/cloudflare/src/prompt-endpoint.ts

import type { Sandbox } from "@cloudflare/sandbox";
import { SandboxAgent } from "sandbox-agent";

export type PromptRequest = {
	agent?: string;
	prompt?: string;
};

export async function runPromptEndpointStream(
	sandbox: Sandbox,
	request: PromptRequest,
	port: number,
	emit: (event: { type: string; [key: string]: unknown }) => Promise<void> | void,
): Promise<void> {
	const client = await SandboxAgent.connect({
		fetch: (req, init) =>
			sandbox.containerFetch(
				req,
				{
					...(init ?? {}),
					// Cloudflare containerFetch may drop long-lived update streams when
					// a forwarded AbortSignal is cancelled; clear it for this path.
					signal: undefined,
				},
				port,
			),
	});

	let unsubscribe: (() => void) | undefined;
	try {
		const session = await client.createSession({
			agent: request.agent ?? "codex",
		});

		const promptText =
			request.prompt?.trim() || "Reply with a short confirmation.";
		await emit({
			type: "session.created",
			sessionId: session.id,
			agent: session.agent,
			prompt: promptText,
		});

		let pendingWrites: Promise<void> = Promise.resolve();
		unsubscribe = session.onEvent((event) => {
			pendingWrites = pendingWrites
				.then(async () => {
					await emit({ type: "session.event", event });
				})
				.catch(() => {});
		});

		const response = await session.prompt([{ type: "text", text: promptText }]);
		await pendingWrites;
		await emit({ type: "prompt.response", response });
		await emit({ type: "prompt.completed" });
	} finally {
		if (unsubscribe) {
			unsubscribe();
		}
		await Promise.race([
			client.dispose(),
			new Promise((resolve) => setTimeout(resolve, 250)),
		]);
	}
}