// @effect-diagnostics nodeBuiltinImport:off globalConsole:off -- The guard runs in Node's unhandled-rejection callback, outside an Effect runtime. stderr must match Node's default unhandled-rejection print.
import * as Context from "effect/Context";
import * as Effect from "effect/Effect";
import * as Layer from "effect/Layer";
import { loadCursorSdk, loadCursorSqlite } from "./sdk.ts";
// The SDK leaves a shell-error promise unhandled, which would exit the server.
const CURSOR_SHELL_SPAWN_MARKERS = [
"dump_zsh_state",
"dump_bash_state",
"__CURSOR_SANDBOX_ENV_RESTORE",
] as const;
function isCursorShellSpawnFailure(reason: unknown): boolean {
if (typeof reason !== "object" || reason === null) {
return false;
}
const syscall = Reflect.get(reason, "syscall");
const code = Reflect.get(reason, "code");
const spawnargs = Reflect.get(reason, "spawnargs");
if (typeof syscall !== "string" || !syscall.startsWith("spawn") || typeof code !== "string") {
return false;
}
if (!Array.isArray(spawnargs)) {
return false;
}
return spawnargs.some(
(arg) =>
typeof arg === "string" && CURSOR_SHELL_SPAWN_MARKERS.some((marker) => arg.includes(marker)),
);
}
/**
* The SDK writes final frames from promises nothing awaits. A closed stream rejects them
* with WriteIterableClosedError; an ended request body rejects them with the Aborted
* ConnectError its connect-node pump wraps around ERR_STREAM_WRITE_AFTER_END. The classes
* are minified, so only `name` identifies them.
*/
function isCursorClosedStreamWrite(reason: unknown): boolean {
if (!(reason instanceof Error)) {
return false;
}
if (reason.name === "WriteIterableClosedError") {
return true;
}
return (
reason.name === "ConnectError" &&
reason.cause instanceof Error &&
Reflect.get(reason.cause, "code") === "ERR_STREAM_WRITE_AFTER_END"
);
}
function onUnhandledRejection(reason: unknown): void {
if (isCursorShellSpawnFailure(reason)) {
console.error("Cursor shell spawn failed. The server will keep running.", reason);
return;
}
if (isCursorClosedStreamWrite(reason)) {
console.error("Cursor SDK wrote to a closed stream. The server will keep running.");
return;
}
if (process.listenerCount("unhandledRejection") > 1) {
return;
}
console.error(reason);
process.exit(1);
}
/** Keeps the shell spawn guard armed while in-process agents run. */
export class CursorSdk extends Context.Service<
CursorSdk,
{
readonly load: typeof loadCursorSdk;
readonly loadSqlite: typeof loadCursorSqlite;
}
>()("@t3tools/provider-cursor/server/CursorSdk") {}
/** Provide once per process: a second guard would defer to the first and swallow real rejections. */
export const layer = Layer.effect(
CursorSdk,
Effect.acquireRelease(
Effect.sync(() => {
process.on("unhandledRejection", onUnhandledRejection);
}),
() =>
Effect.sync(() => {
process.off("unhandledRejection", onUnhandledRejection);
}),
).pipe(Effect.as(CursorSdk.of({ load: loadCursorSdk, loadSqlite: loadCursorSqlite }))),
);