@gakr-gakr/codex 0.1.0 → 0.1.1

package/src/app-server/protocol-validators.ts

@@ -1,203 +0,0 @@
-import AjvPkg, { type ValidateFunction } from "ajv";
-import dynamicToolCallParamsSchema from "./protocol-generated/json/DynamicToolCallParams.json" with { type: "json" };
-import errorNotificationSchema from "./protocol-generated/json/v2/ErrorNotification.json" with { type: "json" };
-import modelListResponseSchema from "./protocol-generated/json/v2/ModelListResponse.json" with { type: "json" };
-import threadResumeResponseSchema from "./protocol-generated/json/v2/ThreadResumeResponse.json" with { type: "json" };
-import threadStartResponseSchema from "./protocol-generated/json/v2/ThreadStartResponse.json" with { type: "json" };
-import turnCompletedNotificationSchema from "./protocol-generated/json/v2/TurnCompletedNotification.json" with { type: "json" };
-import turnStartResponseSchema from "./protocol-generated/json/v2/TurnStartResponse.json" with { type: "json" };
-import type {
-  CodexDynamicToolCallParams,
-  CodexErrorNotification,
-  CodexModelListResponse,
-  CodexThreadForkResponse,
-  CodexThreadResumeResponse,
-  CodexThreadStartResponse,
-  CodexTurn,
-  CodexTurnCompletedNotification,
-  CodexTurnStartResponse,
-} from "./protocol.js";
-
-type AjvInstance = import("ajv").default;
-
-const AjvCtor = AjvPkg as unknown as new (opts?: object) => AjvInstance;
-const ajv = new AjvCtor({
-  allErrors: true,
-  strict: false,
-  useDefaults: true,
-  validateFormats: false,
-});
-
-const validateDynamicToolCallParams = ajv.compile<CodexDynamicToolCallParams>(
-  dynamicToolCallParamsSchema,
-);
-const validateErrorNotification = ajv.compile<CodexErrorNotification>(errorNotificationSchema);
-const validateModelListResponse = ajv.compile<CodexModelListResponse>(modelListResponseSchema);
-const validateThreadResumeResponse = ajv.compile<CodexThreadResumeResponse>(
-  threadResumeResponseSchema,
-);
-const validateThreadStartResponse =
-  ajv.compile<CodexThreadStartResponse>(threadStartResponseSchema);
-const validateTurnCompletedNotification = ajv.compile<CodexTurnCompletedNotification>(
-  turnCompletedNotificationSchema,
-);
-const validateTurnStartResponse = ajv.compile<CodexTurnStartResponse>(turnStartResponseSchema);
-
-export function assertCodexThreadStartResponse(value: unknown): CodexThreadStartResponse {
-  return assertCodexShape(
-    validateThreadStartResponse,
-    normalizeThreadResponse(value),
-    "thread/start response",
-  );
-}
-
-export function assertCodexThreadForkResponse(value: unknown): CodexThreadForkResponse {
-  return assertCodexShape(
-    validateThreadStartResponse,
-    normalizeThreadResponse(value),
-    "thread/fork response",
-  );
-}
-
-export function assertCodexThreadResumeResponse(value: unknown): CodexThreadResumeResponse {
-  return assertCodexShape(
-    validateThreadResumeResponse,
-    normalizeThreadResponse(value),
-    "thread/resume response",
-  );
-}
-
-export function assertCodexTurnStartResponse(value: unknown): CodexTurnStartResponse {
-  return assertCodexShape(
-    validateTurnStartResponse,
-    normalizeTurnStartResponse(value),
-    "turn/start response",
-  );
-}
-
-export function readCodexDynamicToolCallParams(
-  value: unknown,
-): CodexDynamicToolCallParams | undefined {
-  return readCodexShape(validateDynamicToolCallParams, value);
-}
-
-export function readCodexErrorNotification(value: unknown): CodexErrorNotification | undefined {
-  return readCodexShape(validateErrorNotification, value);
-}
-
-export function readCodexModelListResponse(value: unknown): CodexModelListResponse | undefined {
-  return readCodexShape(validateModelListResponse, value);
-}
-
-export function readCodexTurn(value: unknown): CodexTurn | undefined {
-  const response = readCodexShape(validateTurnStartResponse, { turn: normalizeTurn(value) });
-  return response?.turn;
-}
-
-export function readCodexTurnCompletedNotification(
-  value: unknown,
-): CodexTurnCompletedNotification | undefined {
-  return readCodexShape(
-    validateTurnCompletedNotification,
-    normalizeTurnCompletedNotification(value),
-  );
-}
-
-function assertCodexShape<T>(validate: ValidateFunction<T>, value: unknown, label: string): T {
-  if (validate(value)) {
-    return value;
-  }
-  throw new Error(`Invalid Codex app-server ${label}: ${formatAjvErrors(validate)}`);
-}
-
-function readCodexShape<T>(validate: ValidateFunction<T>, value: unknown): T | undefined {
-  return validate(value) ? value : undefined;
-}
-
-function normalizeTurn(value: unknown): unknown {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return value;
-  }
-  return {
-    error: null,
-    startedAt: null,
-    completedAt: null,
-    durationMs: null,
-    ...value,
-    items: Array.isArray((value as { items?: unknown }).items)
-      ? (value as { items: unknown[] }).items.map(normalizeThreadItem)
-      : [],
-  };
-}
-
-function normalizeThreadItem(value: unknown): unknown {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return value;
-  }
-  const item = value as { type?: unknown };
-  switch (item.type) {
-    case "agentMessage":
-      return { phase: null, memoryCitation: null, ...value };
-    case "plan":
-      return { text: "", ...value };
-    case "reasoning":
-      return { summary: [], content: [], ...value };
-    case "dynamicToolCall":
-      return {
-        namespace: null,
-        arguments: null,
-        status: "completed",
-        contentItems: null,
-        success: null,
-        durationMs: null,
-        ...value,
-      };
-    default:
-      return value;
-  }
-}
-
-function normalizeThreadResponse(value: unknown): unknown {
-  if (!value || typeof value !== "object" || Array.isArray(value) || !("thread" in value)) {
-    return value;
-  }
-  const thread = (value as { thread?: unknown }).thread;
-  if (thread && typeof thread === "object" && !Array.isArray(thread)) {
-    const t = thread as { id?: string; sessionId?: string };
-    if (typeof t.id === "string" && typeof t.sessionId !== "string") {
-      return { ...value, thread: { ...thread, sessionId: t.id } };
-    }
-    if (typeof t.sessionId === "string" && typeof t.id !== "string") {
-      return { ...value, thread: { ...thread, id: t.sessionId } };
-    }
-  }
-  return value;
-}
-
-function normalizeTurnStartResponse(value: unknown): unknown {
-  if (!value || typeof value !== "object" || Array.isArray(value) || !("turn" in value)) {
-    return value;
-  }
-  return {
-    ...value,
-    turn: normalizeTurn((value as { turn?: unknown }).turn),
-  };
-}
-
-function normalizeTurnCompletedNotification(value: unknown): unknown {
-  if (!value || typeof value !== "object" || Array.isArray(value) || !("turn" in value)) {
-    return value;
-  }
-  return {
-    ...value,
-    turn: normalizeTurn((value as { turn?: unknown }).turn),
-  };
-}
-
-function formatAjvErrors(validate: ValidateFunction): string {
-  const errors = validate.errors;
-  if (!errors || errors.length === 0) {
-    return "schema validation failed";
-  }
-  return ajv.errorsText(errors, { separator: "; " });
-}

package/src/app-server/protocol.ts

@@ -1,520 +0,0 @@
-export type JsonValue = null | boolean | number | string | JsonValue[] | JsonObject;
-export type JsonObject = { [key: string]: JsonValue };
-export type CodexServiceTier = string;
-
-export type CodexAppServerRequestMethod = keyof CodexAppServerRequestResultMap | (string & {});
-export type CodexAppServerRequestParams<M extends CodexAppServerRequestMethod> =
-  M extends keyof CodexAppServerRequestParamsOverride
-    ? CodexAppServerRequestParamsOverride[M]
-    : unknown;
-
-export type CodexAppServerRequestResult<M extends CodexAppServerRequestMethod> =
-  M extends keyof CodexAppServerRequestResultMap
-    ? CodexAppServerRequestResultMap[M]
-    : JsonValue | undefined;
-
-export type RpcRequest = {
-  id?: number | string;
-  method: string;
-  params?: JsonValue;
-};
-
-export type RpcResponse = {
-  id: number | string;
-  result?: JsonValue;
-  error?: {
-    code?: number;
-    message: string;
-    data?: JsonValue;
-  };
-};
-
-export type RpcMessage = RpcRequest | RpcResponse;
-
-export type CodexInitializeParams = {
-  clientInfo: {
-    name: string;
-    title?: string;
-    version?: string;
-  };
-  capabilities?: JsonObject;
-};
-
-export type CodexInitializeResponse = {
-  serverInfo?: {
-    name?: string;
-    version?: string;
-  };
-  protocolVersion?: string;
-  userAgent?: string;
-};
-
-export type CodexUserInput =
-  | {
-      type: "text";
-      text: string;
-      text_elements?: JsonValue[];
-    }
-  | {
-      type: "image";
-      url: string;
-    }
-  | {
-      type: "localImage";
-      path: string;
-    };
-
-export type CodexDynamicToolSpec = JsonObject & {
-  name: string;
-  description: string;
-  inputSchema: JsonValue;
-};
-
-export type CodexThreadStartParams = JsonObject & {
-  input?: CodexUserInput[];
-  cwd?: string;
-  model?: string;
-  modelProvider?: string | null;
-  approvalPolicy?: string | JsonObject;
-  approvalsReviewer?: string | null;
-  sandbox?: CodexSandboxPolicy;
-  serviceTier?: CodexServiceTier | null;
-  dynamicTools?: CodexDynamicToolSpec[] | null;
-  developerInstructions?: string;
-  experimentalRawEvents?: boolean;
-  persistExtendedHistory?: boolean;
-};
-
-export type CodexThreadResumeParams = JsonObject & {
-  threadId: string;
-  model?: string;
-  modelProvider?: string | null;
-};
-
-export type CodexThreadStartResponse = {
-  thread: CodexThread;
-  model: string;
-  modelProvider?: string | null;
-};
-
-export type CodexThreadForkParams = CodexThreadStartParams & {
-  threadId: string;
-  baseInstructions?: string;
-  ephemeral?: boolean;
-  threadSource?: string | JsonObject;
-  excludeTurns?: boolean;
-};
-
-export type CodexThreadForkResponse = CodexThreadStartResponse;
-
-export type CodexThreadResumeResponse = {
-  thread: CodexThread;
-  model: string;
-  modelProvider?: string | null;
-};
-
-export type CodexThreadInjectItemsParams = JsonObject & {
-  threadId: string;
-  items: JsonValue[];
-};
-
-export type CodexThreadUnsubscribeParams = JsonObject & {
-  threadId: string;
-};
-
-export type CodexTurnInterruptParams = JsonObject & {
-  threadId: string;
-  turnId: string;
-};
-
-export type CodexTurnStartParams = JsonObject & {
-  threadId: string;
-  input?: CodexUserInput[];
-  cwd?: string;
-  model?: string;
-  approvalPolicy?: string | JsonObject;
-  approvalsReviewer?: string | null;
-  sandboxPolicy?: CodexSandboxPolicy;
-  serviceTier?: CodexServiceTier | null;
-  effort?: string | null;
-  collaborationMode?: {
-    mode: string;
-    settings: JsonObject & {
-      developer_instructions: string | null;
-    };
-  } | null;
-};
-
-export type CodexSandboxPolicy = string | JsonObject;
-
-export type CodexTurnStartResponse = {
-  turn: CodexTurn;
-};
-
-export type CodexTurn = {
-  id: string;
-  threadId: string;
-  status?: string;
-  error?: CodexErrorNotification["error"];
-  startedAt?: string | null;
-  completedAt?: string | null;
-  durationMs?: number | null;
-  items: CodexThreadItem[];
-};
-
-export type CodexThread = {
-  id: string;
-  sessionId?: string;
-  name?: string | null;
-  preview?: string | null;
-  createdAt?: number | null;
-  updatedAt?: number | null;
-  status?: CodexThreadStatus | null;
-  cwd?: string | null;
-  source?: CodexSessionSource | null;
-  threadSource?: string | null;
-  agentNickname?: string | null;
-  agentRole?: string | null;
-};
-
-export type CodexThreadStatus =
-  | { type: "notLoaded" }
-  | { type: "idle" }
-  | { type: "systemError" }
-  | { type: "active"; activeFlags?: string[] };
-
-export type CodexSubAgentThreadSpawnSource = {
-  parent_thread_id: string;
-  depth?: number;
-  agent_path?: string | null;
-  agent_nickname?: string | null;
-  agent_role?: string | null;
-};
-
-export type CodexSubAgentSource =
-  | "review"
-  | "compact"
-  | "memory_consolidation"
-  | { thread_spawn: CodexSubAgentThreadSpawnSource }
-  | { other: string };
-
-export type CodexSessionSource =
-  | "cli"
-  | "vscode"
-  | "exec"
-  | "appServer"
-  | "unknown"
-  | { custom: string }
-  | { subAgent: CodexSubAgentSource };
-
-export type CodexThreadStartedNotification = {
-  thread: CodexThread;
-};
-
-export type CodexThreadStatusChangedNotification = {
-  threadId: string;
-  status: CodexThreadStatus;
-};
-
-export type CodexThreadItem = {
-  id: string;
-  type: string;
-  title: string | null;
-  status: string | null;
-  name: string | null;
-  tool: string | null;
-  server: string | null;
-  command: string | null;
-  cwd: string | null;
-  query: string | null;
-  arguments?: JsonValue;
-  result?: JsonValue;
-  error?: CodexErrorNotification["error"];
-  exitCode?: number | null;
-  durationMs?: number | null;
-  aggregatedOutput: string | null;
-  text: string;
-  contentItems?: CodexDynamicToolCallOutputContentItem[] | null;
-  changes: Array<{ path: string; kind: string }>;
-  [key: string]: unknown;
-};
-
-export type CodexServerNotification = {
-  method: string;
-  params?: JsonValue;
-};
-
-export type CodexDynamicToolCallParams = {
-  namespace?: string | null;
-  threadId: string;
-  turnId: string;
-  callId: string;
-  tool: string;
-  arguments?: JsonValue;
-};
-
-export type CodexDynamicToolCallResponse = {
-  contentItems: CodexDynamicToolCallOutputContentItem[];
-  diagnosticTerminalType?: CodexDynamicToolDiagnosticTerminalType;
-  success: boolean;
-};
-
-export type CodexDynamicToolDiagnosticTerminalType = "blocked" | "completed" | "error";
-
-export type CodexDynamicToolCallOutputContentItem =
-  | {
-      type: "inputText";
-      text: string;
-    }
-  | {
-      type: "inputImage";
-      imageUrl: string;
-    }
-  | JsonObject;
-
-export type CodexErrorNotification = {
-  error: {
-    message?: string;
-    codexErrorInfo?: {
-      message?: string;
-      [key: string]: unknown;
-    };
-    [key: string]: unknown;
-  };
-  message?: string;
-};
-
-export type CodexTurnCompletedNotification = {
-  turn: CodexTurn;
-};
-
-export type CodexModel = {
-  id?: string;
-  model?: string;
-  displayName?: string | null;
-  description?: string | null;
-  hidden: boolean;
-  isDefault: boolean;
-  inputModalities: string[];
-  supportedReasoningEfforts: CodexReasoningEffortOption[];
-  defaultReasoningEffort?: string | null;
-};
-
-export type CodexReasoningEffortOption = {
-  reasoningEffort?: string | null;
-};
-
-export type CodexModelListResponse = {
-  data: CodexModel[];
-  nextCursor?: string | null;
-};
-
-export type CodexGetAccountResponse = {
-  account?: JsonValue;
-  requiresOpenaiAuth?: boolean;
-};
-
-export type CodexChatgptAuthTokensRefreshResponse = {
-  accessToken: string;
-  chatgptAccountId: string;
-  chatgptPlanType: string | null;
-};
-
-export type CodexLoginAccountParams =
-  | {
-      type: "apiKey";
-      apiKey: string;
-    }
-  | {
-      type: "chatgptAuthTokens";
-      accessToken: string;
-      chatgptAccountId: string;
-      chatgptPlanType: string | null;
-    };
-
-export type CodexPluginSummary = {
-  id: string;
-  name: string;
-  source?: JsonObject;
-  installed: boolean;
-  enabled: boolean;
-  installPolicy?: string;
-  authPolicy?: string;
-  availability?: string;
-  interface?: JsonValue;
-};
-
-export type CodexAppSummary = {
-  id: string;
-  name: string;
-  description?: string | null;
-  installUrl?: string | null;
-  needsAuth: boolean;
-};
-
-export type CodexPluginDetail = {
-  marketplaceName?: string;
-  marketplacePath?: string | null;
-  summary: CodexPluginSummary;
-  description?: string | null;
-  skills?: JsonValue[];
-  apps: CodexAppSummary[];
-  mcpServers: string[];
-};
-
-export type CodexPluginMarketplaceEntry = {
-  name: string;
-  path?: string | null;
-  interface?: JsonValue;
-  plugins: CodexPluginSummary[];
-};
-
-export type CodexPluginListResponse = {
-  marketplaces: CodexPluginMarketplaceEntry[];
-  marketplaceLoadErrors?: JsonValue[];
-  featuredPluginIds?: string[];
-};
-
-export type CodexPluginReadResponse = {
-  plugin: CodexPluginDetail;
-};
-
-export type CodexPluginListParams = {
-  cwds: string[];
-};
-
-export type CodexPluginReadParams = {
-  marketplacePath?: string;
-  remoteMarketplaceName?: string;
-  pluginName: string;
-};
-
-export type CodexPluginInstallParams = CodexPluginReadParams;
-
-export type CodexPluginInstallResponse = {
-  authPolicy: string;
-  appsNeedingAuth: CodexAppSummary[];
-};
-
-export type CodexAppInfo = {
-  id: string;
-  name: string;
-  description?: string | null;
-  logoUrl?: string | null;
-  logoUrlDark?: string | null;
-  distributionChannel?: string | null;
-  branding?: JsonValue;
-  appMetadata?: JsonValue;
-  labels?: JsonValue;
-  installUrl?: string | null;
-  isAccessible: boolean;
-  isEnabled: boolean;
-  pluginDisplayNames: string[];
-};
-
-export type CodexAppsListParams = {
-  cursor?: string | null;
-  limit?: number;
-  forceRefetch?: boolean;
-};
-
-export type CodexAppsListResponse = {
-  data: CodexAppInfo[];
-  nextCursor?: string | null;
-};
-
-export type CodexSkillsListParams = {
-  cwds: string[];
-  forceReload?: boolean;
-};
-
-export type CodexSkillsListResponse = {
-  data: JsonValue[];
-  nextCursor?: string | null;
-};
-
-export type CodexHooksListParams = {
-  cwds: string[];
-};
-
-export type CodexHooksListResponse = {
-  data: JsonValue[];
-  nextCursor?: string | null;
-};
-
-export type CodexMcpServerStatus = {
-  name: string;
-  tools: JsonObject;
-};
-
-export type CodexListMcpServerStatusResponse = {
-  data: CodexMcpServerStatus[];
-  nextCursor?: string | null;
-};
-
-export type CodexRequestObject = Record<string, unknown>;
-
-export declare namespace v2 {
-  export type AppInfo = CodexAppInfo;
-  export type AppSummary = CodexAppSummary;
-  export type AppsListParams = CodexAppsListParams;
-  export type AppsListResponse = CodexAppsListResponse;
-  export type HooksListParams = CodexHooksListParams;
-  export type HooksListResponse = CodexHooksListResponse;
-  export type PluginDetail = CodexPluginDetail;
-  export type PluginInstallParams = CodexPluginInstallParams;
-  export type PluginInstallResponse = CodexPluginInstallResponse;
-  export type PluginListParams = CodexPluginListParams;
-  export type PluginListResponse = CodexPluginListResponse;
-  export type PluginMarketplaceEntry = CodexPluginMarketplaceEntry;
-  export type PluginReadParams = CodexPluginReadParams;
-  export type PluginReadResponse = CodexPluginReadResponse;
-  export type PluginSummary = CodexPluginSummary;
-  export type SkillsListParams = CodexSkillsListParams;
-  export type SkillsListResponse = CodexSkillsListResponse;
-}
-
-type CodexAppServerRequestParamsOverride = {
-  "thread/fork": CodexThreadForkParams;
-  "thread/inject_items": CodexThreadInjectItemsParams;
-  "thread/start": CodexThreadStartParams;
-  "thread/unsubscribe": CodexThreadUnsubscribeParams;
-  "turn/interrupt": CodexTurnInterruptParams;
-};
-
-type CodexAppServerRequestResultMap = {
-  initialize: CodexInitializeResponse;
-  "account/rateLimits/read": JsonValue;
-  "account/read": CodexGetAccountResponse;
-  "app/list": CodexAppsListResponse;
-  "config/mcpServer/reload": JsonValue;
-  "experimentalFeature/enablement/set": JsonValue;
-  "feedback/upload": JsonValue;
-  "hooks/list": CodexHooksListResponse;
-  "marketplace/add": JsonValue;
-  "mcpServerStatus/list": CodexListMcpServerStatusResponse;
-  "model/list": CodexModelListResponse;
-  "plugin/install": CodexPluginInstallResponse;
-  "plugin/list": CodexPluginListResponse;
-  "plugin/read": CodexPluginReadResponse;
-  "review/start": JsonValue;
-  "skills/list": CodexSkillsListResponse;
-  "thread/compact/start": JsonValue;
-  "thread/fork": CodexThreadForkResponse;
-  "thread/inject_items": JsonValue;
-  "thread/list": JsonValue;
-  "thread/resume": CodexThreadResumeResponse;
-  "thread/start": CodexThreadStartResponse;
-  "thread/unsubscribe": JsonValue;
-  "turn/interrupt": JsonValue;
-  "turn/start": CodexTurnStartResponse;
-  "turn/steer": JsonValue;
-};
-
-export function isJsonObject(value: JsonValue | undefined): value is JsonObject {
-  return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-
-export function isRpcResponse(message: RpcMessage): message is RpcResponse {
-  return "id" in message && !("method" in message);
-}