// @effect-diagnostics nodeBuiltinImport:off import * as NodePath from "node:path"; import * as NodeOS from "node:os"; import * as NodeFSP from "node:fs/promises"; import * as NodeURL from "node:url"; import * as NodeServices from "@effect/platform-node/NodeServices"; import { assert, it } from "@effect/vitest"; import * as Deferred from "effect/Deferred"; import * as Effect from "effect/Effect"; import * as Fiber from "effect/Fiber"; import * as Layer from "effect/Layer"; import * as Schema from "effect/Schema"; import * as Stream from "effect/Stream"; import { ApprovalRequestId, GrokSettings, ProviderDriverKind, ThreadId, ProviderInstanceId, type ProviderRuntimeEvent, } from "@t3tools/contracts"; import { ServerConfig } from "../../config.ts"; import { makeGrokAdapter } from "./GrokAdapter.ts"; const decodeGrokSettings = Schema.decodeSync(GrokSettings); const __dirname = NodePath.dirname(NodeURL.fileURLToPath(import.meta.url)); const mockAgentPath = NodePath.join(__dirname, "../../../scripts/acp-mock-agent.ts"); const mockAgentCommand = process.execPath; async function makeMockGrokWrapper(extraEnv?: Record) { const dir = await NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "grok-acp-mock-")); const wrapperPath = NodePath.join(dir, "fake-grok.sh"); const envExports = Object.entries(extraEnv ?? {}) .map(([key, value]) => `export ${key}=${JSON.stringify(value)}`) .join("\n"); const script = `#!/bin/sh ${envExports} exec ${JSON.stringify(mockAgentCommand)} ${JSON.stringify(mockAgentPath)} "$@" `; await NodeFSP.writeFile(wrapperPath, script, "utf8"); await NodeFSP.chmod(wrapperPath, 0o755); return wrapperPath; } function waitForFileContent(filePath: string, attempts = 40): Effect.Effect { const readAttempt = (remainingAttempts: number): Effect.Effect => Effect.gen(function* () { if (remainingAttempts <= 0) { return yield* Effect.die(new Error(`Timed out waiting for file content at ${filePath}`)); } const raw = yield* Effect.tryPromise(() => NodeFSP.readFile(filePath, "utf8")).pipe( Effect.orElseSucceed(() => ""), ); if (raw.trim().length > 0) { return raw; } yield* Effect.sleep("25 millis"); return yield* readAttempt(remainingAttempts - 1); }); return readAttempt(attempts); } async function readJsonLines(filePath: string) { const raw = await NodeFSP.readFile(filePath, "utf8"); return raw .split("\n") .map((line) => line.trim()) .filter((line) => line.length > 0) .map((line) => JSON.parse(line) as Record); } const grokAdapterTestLayer = ServerConfig.layerTest(process.cwd(), { prefix: "t3code-grok-adapter-test-", }).pipe(Layer.provideMerge(NodeServices.layer)); const makeTestAdapter = (binaryPath: string, options?: Parameters[1]) => makeGrokAdapter(decodeGrokSettings({ binaryPath }), options).pipe(Effect.orDie); it.layer(grokAdapterTestLayer)("GrokAdapterLive", (it) => { it.effect("starts a session and maps mock ACP prompt flow to runtime events", () => Effect.gen(function* () { const threadId = ThreadId.make("grok-mock-thread"); const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper()); const adapter = yield* makeTestAdapter(wrapperPath); const runtimeEvents: ProviderRuntimeEvent[] = []; const turnCompleted = yield* Deferred.make(); const runtimeEventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) => Effect.sync(() => { runtimeEvents.push(event); }).pipe( Effect.andThen( event.type === "turn.completed" ? Deferred.succeed(turnCompleted, undefined) : Effect.void, ), ), ).pipe(Effect.forkChild); const session = yield* adapter.startSession({ threadId, provider: ProviderDriverKind.make("grok"), cwd: process.cwd(), runtimeMode: "full-access", modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-mock-alt" }, }); assert.equal(session.provider, "grok"); assert.equal(session.model, "grok-mock-alt"); assert.deepStrictEqual(session.resumeCursor, { schemaVersion: 1, sessionId: "mock-session-1", }); yield* adapter.sendTurn({ threadId, input: "hello grok", attachments: [], }); yield* Deferred.await(turnCompleted); yield* Fiber.interrupt(runtimeEventsFiber); const types = runtimeEvents.map((e) => e.type); assert.includeMembers(types, [ "session.started", "session.state.changed", "thread.started", "turn.started", "item.started", "content.delta", "turn.completed", ] as const); const delta = runtimeEvents.find((e) => e.type === "content.delta"); assert.isDefined(delta); if (delta?.type === "content.delta") { assert.equal(delta.payload.delta, "hello from mock"); } yield* adapter.stopSession(threadId); }), ); it.effect("closes the ACP child process when a session stops", () => Effect.gen(function* () { const threadId = ThreadId.make("grok-stop-session-close"); const tempDir = yield* Effect.promise(() => NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "grok-adapter-exit-log-")), ); const exitLogPath = NodePath.join(tempDir, "exit.log"); const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper({ T3_ACP_EXIT_LOG_PATH: exitLogPath, }), ); const adapter = yield* makeTestAdapter(wrapperPath); yield* adapter.startSession({ threadId, provider: ProviderDriverKind.make("grok"), cwd: process.cwd(), runtimeMode: "full-access", modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" }, }); yield* adapter.stopSession(threadId); const exitLog = yield* waitForFileContent(exitLogPath); assert.include(exitLog, "SIGTERM"); }), ); it.effect("rejects startSession when provider mismatches", () => Effect.gen(function* () { const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper()); const adapter = yield* makeTestAdapter(wrapperPath); const threadId = ThreadId.make("grok-provider-mismatch"); const error = yield* Effect.flip( adapter.startSession({ threadId, provider: ProviderDriverKind.make("cursor"), cwd: process.cwd(), runtimeMode: "full-access", modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" }, }), ); assert.equal(error._tag, "ProviderAdapterValidationError"); }), ); it.effect("rejects sendTurn with empty input and no attachments", () => Effect.gen(function* () { const threadId = ThreadId.make("grok-empty-turn"); const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper()); const adapter = yield* makeTestAdapter(wrapperPath); yield* adapter.startSession({ threadId, provider: ProviderDriverKind.make("grok"), cwd: process.cwd(), runtimeMode: "full-access", modelSelection: { instanceId: ProviderInstanceId.make("grok"), model: "grok-build" }, }); const error = yield* Effect.flip( adapter.sendTurn({ threadId, input: " ", attachments: [], }), ); assert.equal(error._tag, "ProviderAdapterValidationError"); yield* adapter.stopSession(threadId); }), ); it.effect("responds to ACP approvals using provider-supplied option ids", () => Effect.gen(function* () { const threadId = ThreadId.make("grok-custom-approval-option-id"); const tempDir = yield* Effect.promise(() => NodeFSP.mkdtemp(NodePath.join(NodeOS.tmpdir(), "grok-acp-")), ); const requestLogPath = NodePath.join(tempDir, "requests.ndjson"); const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper({ T3_ACP_REQUEST_LOG_PATH: requestLogPath, T3_ACP_EMIT_TOOL_CALLS: "1", T3_ACP_ALLOW_ONCE_OPTION_ID: "agent-defined-approval-id", }), ); const adapter = yield* makeTestAdapter(wrapperPath); const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) => event.type === "request.opened" ? adapter.respondToRequest( threadId, ApprovalRequestId.make(String(event.requestId)), "accept", ) : Effect.void, ).pipe(Effect.forkChild); yield* adapter.startSession({ threadId, provider: ProviderDriverKind.make("grok"), cwd: process.cwd(), runtimeMode: "approval-required", }); yield* adapter.sendTurn({ threadId, input: "approve this", attachments: [] }); const requests = yield* Effect.promise(() => readJsonLines(requestLogPath)); assert.isTrue( requests.some( (entry) => !("method" in entry) && typeof entry.result === "object" && entry.result !== null && "outcome" in entry.result && typeof entry.result.outcome === "object" && entry.result.outcome !== null && "optionId" in entry.result.outcome && entry.result.outcome.optionId === "agent-defined-approval-id", ), ); yield* Fiber.interrupt(eventsFiber); yield* adapter.stopSession(threadId); }), ); it.effect("handles xAI ask_user_question extension requests", () => Effect.gen(function* () { const threadId = ThreadId.make("grok-xai-ask-user-question"); const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper({ T3_ACP_EMIT_XAI_ASK_USER_QUESTION: "1" }), ); const adapter = yield* makeTestAdapter(wrapperPath); const requested = yield* Deferred.make>(); const resolved = yield* Deferred.make>(); const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) => { if (String(event.threadId) !== String(threadId)) { return Effect.void; } if (event.type === "user-input.requested") { return Deferred.succeed(requested, event).pipe(Effect.ignore); } if (event.type === "user-input.resolved") { return Deferred.succeed(resolved, event).pipe(Effect.ignore); } return Effect.void; }).pipe(Effect.forkChild); yield* adapter.startSession({ threadId, provider: ProviderDriverKind.make("grok"), cwd: process.cwd(), runtimeMode: "full-access", }); const sendTurnFiber = yield* adapter .sendTurn({ threadId, input: "ask before continuing", attachments: [] }) .pipe(Effect.forkChild); const requestedEvent = yield* Deferred.await(requested); assert.equal(requestedEvent.payload.questions.length, 1); assert.equal(requestedEvent.payload.questions[0]?.id, "Which scope should Grok use?"); assert.equal(requestedEvent.payload.questions[0]?.question, "Which scope should Grok use?"); assert.equal(requestedEvent.raw?.method, "_x.ai/ask_user_question"); yield* adapter.respondToUserInput( threadId, ApprovalRequestId.make(String(requestedEvent.requestId)), { "Which scope should Grok use?": "Workspace", }, ); const resolvedEvent = yield* Deferred.await(resolved); assert.deepEqual(resolvedEvent.payload.answers, { "Which scope should Grok use?": "Workspace", }); yield* Fiber.join(sendTurnFiber); yield* Fiber.interrupt(eventsFiber); yield* adapter.stopSession(threadId); }), ); it.effect("continues streaming events when native notification logging fails", () => Effect.gen(function* () { const threadId = ThreadId.make("grok-native-log-failure"); const wrapperPath = yield* Effect.promise(() => makeMockGrokWrapper()); const adapter = yield* makeTestAdapter(wrapperPath, { nativeEventLogger: { filePath: "memory://grok-native-events", write: (record: unknown) => typeof record === "object" && record !== null && "event" in record && typeof record.event === "object" && record.event !== null && "kind" in record.event && record.event.kind === "notification" ? Effect.die(new Error("native log write failed")) : Effect.void, close: () => Effect.void, }, }); const contentDelta = yield* Deferred.make(); const eventsFiber = yield* Stream.runForEach(adapter.streamEvents, (event) => event.type === "content.delta" ? Deferred.succeed(contentDelta, undefined) : Effect.void, ).pipe(Effect.forkChild); yield* adapter.startSession({ threadId, provider: ProviderDriverKind.make("grok"), cwd: process.cwd(), runtimeMode: "full-access", }); yield* adapter.sendTurn({ threadId, input: "keep streaming", attachments: [] }); yield* Deferred.await(contentDelta); yield* Fiber.interrupt(eventsFiber); yield* adapter.stopSession(threadId); }), ); });