Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
import {
ApprovalRequestId,
ProviderDriverKind,
ProviderItemId,
type ProviderInstanceId,
type ProviderApprovalDecision,
type ProviderEvent,
type ProviderInteractionMode,
type ProviderRequestKind,
type ProviderSession,
type ProviderTurnStartResult,
type ProviderUserInputAnswers,
RuntimeMode,
ThreadId,
TurnId,
} from "@akeru/contracts";
import * as Deferred from "effect/Deferred";
import * as Effect from "effect/Effect";
import * as Stream from "effect/Stream";
import * as EffectCodexSchema from "effect-codex-app-server/schema";
import { type CodexResumeCursor } from "./CodexRuntimeRequests.ts";
import { type CodexSessionRuntimeError } from "./CodexRuntimeErrors.ts";
export const PROVIDER = ProviderDriverKind.make("codex");
export type CodexServiceTier = NonNullable<EffectCodexSchema.V2ThreadStartParams["serviceTier"]>;
export type CodexThreadItem =
| EffectCodexSchema.V2ThreadReadResponse["thread"]["turns"][number]["items"][number]
| EffectCodexSchema.V2ThreadRollbackResponse["thread"]["turns"][number]["items"][number];
export interface CodexSessionRuntimeOptions {
readonly threadId: ThreadId;
readonly providerInstanceId?: ProviderInstanceId;
readonly binaryPath: string;
readonly homePath?: string;
readonly launchArgs?: string;
readonly environment?: NodeJS.ProcessEnv;
readonly cwd: string;
readonly runtimeMode: RuntimeMode;
readonly model?: string;
readonly serviceTier?: CodexServiceTier | undefined;
readonly resumeCursor?: CodexResumeCursor;
readonly appServerArgs?: ReadonlyArray<string>;
}
export interface CodexSessionRuntimeSendTurnInput {
readonly input?: string;
readonly attachments?: ReadonlyArray<{
readonly type: "image";
readonly url: string;
}>;
readonly model?: string;
readonly serviceTier?: CodexServiceTier | undefined;
readonly effort?: EffectCodexSchema.V2TurnStartParams__ReasoningEffort | undefined;
readonly interactionMode?: ProviderInteractionMode;
}
export interface CodexThreadTurnSnapshot {
readonly id: TurnId;
readonly items: ReadonlyArray<CodexThreadItem>;
}
export interface CodexThreadSnapshot {
readonly threadId: string;
readonly turns: ReadonlyArray<CodexThreadTurnSnapshot>;
}
export interface CodexSessionRuntimeShape {
readonly start: () => Effect.Effect<ProviderSession, CodexSessionRuntimeError>;
readonly getSession: Effect.Effect<ProviderSession>;
readonly sendTurn: (
input: CodexSessionRuntimeSendTurnInput,
) => Effect.Effect<ProviderTurnStartResult, CodexSessionRuntimeError>;
readonly interruptTurn: (turnId?: TurnId) => Effect.Effect<void, CodexSessionRuntimeError>;
readonly readThread: Effect.Effect<CodexThreadSnapshot, CodexSessionRuntimeError>;
readonly rollbackThread: (
numTurns: number,
) => Effect.Effect<CodexThreadSnapshot, CodexSessionRuntimeError>;
readonly uploadFeedback: (
reason?: string,
) => Effect.Effect<EffectCodexSchema.V2FeedbackUploadResponse, CodexSessionRuntimeError>;
readonly respondToRequest: (
requestId: ApprovalRequestId,
decision: ProviderApprovalDecision,
) => Effect.Effect<void, CodexSessionRuntimeError>;
readonly respondToUserInput: (
requestId: ApprovalRequestId,
answers: ProviderUserInputAnswers,
) => Effect.Effect<void, CodexSessionRuntimeError>;
readonly events: Stream.Stream<ProviderEvent, never>;
readonly close: Effect.Effect<void>;
}
export interface PendingApproval {
readonly requestId: ApprovalRequestId;
readonly jsonRpcId: string;
readonly requestKind: ProviderRequestKind;
readonly turnId: TurnId | undefined;
readonly itemId: ProviderItemId | undefined;
readonly decision: Deferred.Deferred<ProviderApprovalDecision>;
}
export interface ApprovalCorrelation {
readonly requestId: ApprovalRequestId;
readonly requestKind: ProviderRequestKind;
readonly turnId: TurnId | undefined;
readonly itemId: ProviderItemId | undefined;
}
export interface PendingUserInput {
readonly requestId: ApprovalRequestId;
readonly turnId: TurnId | undefined;
readonly itemId: ProviderItemId | undefined;
readonly answers: Deferred.Deferred<ProviderUserInputAnswers>;
}