@mseep/claudian 2.0.25

package/src/providers/codex/runtime/codexAppServerTypes.ts

@@ -0,0 +1,705 @@
+// Local protocol subset for Codex app-server stdio JSON-RPC.
+// Field names match the wire format (camelCase).
+// Probed against codex-cli 0.118.0 on 2026-04-01.
+
+// ---------------------------------------------------------------------------
+// JSON-RPC base
+// ---------------------------------------------------------------------------
+
+export interface JsonRpcRequest {
+  jsonrpc: '2.0';
+  id: number;
+  method: string;
+  params?: unknown;
+}
+
+export interface JsonRpcNotification {
+  jsonrpc: '2.0';
+  method: string;
+  params?: unknown;
+}
+
+export interface JsonRpcResponse {
+  jsonrpc: '2.0';
+  id: number;
+  result?: unknown;
+  error?: JsonRpcError;
+}
+
+export interface JsonRpcError {
+  code: number;
+  message: string;
+  data?: unknown;
+}
+
+// ---------------------------------------------------------------------------
+// Initialize
+// ---------------------------------------------------------------------------
+
+export interface InitializeParams {
+  clientInfo: { name: string; version: string };
+  capabilities: { experimentalApi?: boolean };
+}
+
+export interface InitializeResult {
+  userAgent: string;
+  codexHome?: string;
+  platformFamily: string;
+  platformOs: string;
+}
+
+// ---------------------------------------------------------------------------
+// Thread
+// ---------------------------------------------------------------------------
+
+export interface Thread {
+  id: string;
+  preview: string;
+  ephemeral: boolean;
+  path: string;
+  cwd: string;
+  cliVersion: string;
+  status: ThreadStatus;
+  turns: Turn[];
+  createdAt: number;
+  updatedAt: number;
+  name: string | null;
+  modelProvider: string;
+  source: string;
+  agentNickname: string | null;
+  agentRole: string | null;
+  gitInfo: GitInfo | null;
+}
+
+export interface ThreadStatus {
+  type: 'idle' | 'active' | 'systemError';
+  activeFlags?: string[];
+}
+
+export interface GitInfo {
+  sha: string;
+  branch: string;
+  originUrl: string;
+}
+
+export interface Turn {
+  id: string;
+  items: ThreadItem[];
+  status: 'inProgress' | 'completed' | 'failed' | 'interrupted';
+  error: TurnError | null;
+}
+
+export interface TurnError {
+  message: string;
+  codexErrorInfo: string | Record<string, unknown>;
+  additionalDetails: string | null;
+}
+
+// ---------------------------------------------------------------------------
+// Thread items
+// ---------------------------------------------------------------------------
+
+export type ThreadItem =
+  | UserMessageItem
+  | AgentMessageItem
+  | PlanItem
+  | ReasoningItem
+  | CommandExecutionItem
+  | FileChangeItem
+  | ImageViewItem
+  | WebSearchItem
+  | CollabAgentToolCallItem
+  | McpToolCallItem
+  | ContextCompactionItem;
+
+export interface UserMessageItem {
+  type: 'userMessage';
+  id: string;
+  content: UserInput[];
+}
+
+export interface AgentMessageItem {
+  type: 'agentMessage';
+  id: string;
+  text: string;
+  phase: string;
+  memoryCitation: unknown;
+}
+
+export interface PlanItem {
+  type: 'plan';
+  id: string;
+  text: string;
+}
+
+export interface ReasoningItem {
+  type: 'reasoning';
+  id: string;
+  summary: string[];
+  content: string[];
+}
+
+export interface CommandExecutionItem {
+  type: 'commandExecution';
+  id: string;
+  command: string;
+  cwd: string;
+  processId: string;
+  source: string;
+  status: string;
+  commandActions: CommandAction[];
+  aggregatedOutput: string | null;
+  exitCode: number | null;
+  durationMs: number | null;
+}
+
+export interface CommandAction {
+  type: string;
+  command: string;
+}
+
+export interface FileChangeItem {
+  type: 'fileChange';
+  id: string;
+  changes: FileChangeEntry[];
+  status?: string;
+}
+
+export interface FileChangeEntry {
+  path: string;
+  type?: string;
+  kind?: string | { type?: string; move_path?: string | null };
+  diff?: string;
+}
+
+export interface FileChangePatchUpdatedNotification {
+  threadId: string;
+  turnId: string;
+  itemId: string;
+  changes: FileChangeEntry[];
+}
+
+export interface ImageViewItem {
+  type: 'imageView';
+  id: string;
+  path: string;
+}
+
+export interface WebSearchItem {
+  type: 'webSearch';
+  id: string;
+  query?: string;
+  queries?: string[];
+  url?: string;
+  pattern?: string;
+  action?: {
+    type?: string;
+    query?: string;
+    queries?: string[];
+    url?: string;
+    pattern?: string;
+  };
+  status?: string;
+}
+
+export interface CollabAgentToolCallItem {
+  type: 'collabAgentToolCall';
+  id: string;
+  tool: string;
+  status?: string;
+  arguments?: Record<string, unknown>;
+  result?: unknown;
+}
+
+export interface McpToolCallItem {
+  type: 'mcpToolCall';
+  id: string;
+  server: string;
+  tool: string;
+  status?: string;
+  arguments?: Record<string, unknown>;
+  result?: { content?: Array<{ type?: string; text?: string }> } | null;
+  error?: string | null;
+  durationMs?: number | null;
+}
+
+export interface ContextCompactionItem {
+  type: 'contextCompaction';
+  id: string;
+}
+
+// ---------------------------------------------------------------------------
+// User input
+// ---------------------------------------------------------------------------
+
+export interface TextInput {
+  type: 'text';
+  text: string;
+  text_elements?: unknown[];
+}
+
+export interface LocalImageInput {
+  type: 'localImage';
+  path: string;
+}
+
+export interface SkillInput {
+  type: 'skill';
+  name: string;
+  path: string;
+}
+
+export interface MentionInput {
+  type: 'mention';
+  name: string;
+  path: string;
+}
+
+export type UserInput = TextInput | LocalImageInput | SkillInput | MentionInput;
+
+// ---------------------------------------------------------------------------
+// skills/list
+// ---------------------------------------------------------------------------
+
+export type SkillScope = 'user' | 'repo' | 'system' | 'admin';
+
+export interface SkillInterface {
+  displayName?: string;
+  shortDescription?: string;
+}
+
+export interface SkillMetadata {
+  name: string;
+  description: string;
+  shortDescription?: string;
+  interface?: SkillInterface;
+  path: string;
+  scope: SkillScope;
+  enabled: boolean;
+}
+
+export interface SkillErrorInfo {
+  path: string;
+  message: string;
+}
+
+export interface SkillsListEntry {
+  cwd: string;
+  skills: SkillMetadata[];
+  errors: SkillErrorInfo[];
+}
+
+export interface SkillsListParams {
+  cwds?: string[];
+  forceReload?: boolean;
+  perCwdExtraUserRoots?: Array<{
+    cwd: string;
+    extraUserRoots: string[];
+  }> | null;
+}
+
+export interface SkillsListResult {
+  data: SkillsListEntry[];
+}
+
+// ---------------------------------------------------------------------------
+// thread/start
+// ---------------------------------------------------------------------------
+
+export interface ThreadStartParams {
+  model: string;
+  cwd: string;
+  approvalPolicy: string;
+  sandbox: string;
+  serviceTier?: string | null;
+  baseInstructions?: string;
+  experimentalRawEvents?: boolean;
+  persistExtendedHistory?: boolean;
+  sandboxPolicy?: SandboxPolicy;
+}
+
+export interface ThreadStartResult {
+  thread: Thread;
+  model: string;
+  modelProvider: string;
+  serviceTier: string | null;
+  cwd: string;
+  approvalPolicy: string;
+  approvalsReviewer: string;
+  sandbox: SandboxPolicy;
+  reasoningEffort: string;
+}
+
+export type SandboxPolicy =
+  | { type: 'dangerFullAccess' }
+  | {
+    type: 'workspaceWrite';
+    writableRoots: string[];
+    readOnlyAccess: { type: string };
+    networkAccess: boolean;
+    excludeTmpdirEnvVar: boolean;
+    excludeSlashTmp: boolean;
+  }
+  | {
+    type: 'readOnly';
+    access: { type: string };
+    networkAccess: boolean;
+  }
+  | {
+    type: 'externalSandbox';
+    networkAccess: string;
+  };
+
+// ---------------------------------------------------------------------------
+// thread/resume
+// ---------------------------------------------------------------------------
+
+export interface ThreadResumeParams {
+  threadId: string;
+  model?: string;
+  approvalPolicy?: string;
+  sandbox?: string;
+  serviceTier?: string | null;
+  baseInstructions?: string;
+  experimentalRawEvents?: boolean;
+  persistExtendedHistory?: boolean;
+}
+
+export type ThreadResumeResult = ThreadStartResult;
+
+// ---------------------------------------------------------------------------
+// thread/fork
+// ---------------------------------------------------------------------------
+
+export interface ThreadForkParams {
+  threadId: string;
+}
+
+export type ThreadForkResult = ThreadStartResult;
+
+// ---------------------------------------------------------------------------
+// thread/rollback
+// ---------------------------------------------------------------------------
+
+export interface ThreadRollbackParams {
+  threadId: string;
+  numTurns: number;
+}
+
+export interface ThreadRollbackResult {
+  thread: Thread;
+}
+
+// ---------------------------------------------------------------------------
+// thread/compact/start
+// ---------------------------------------------------------------------------
+
+export interface ThreadCompactStartParams {
+  threadId: string;
+}
+
+export type ThreadCompactStartResult = Record<string, never>;
+
+// ---------------------------------------------------------------------------
+// turn/start
+// ---------------------------------------------------------------------------
+
+export interface CollaborationModeSettings {
+  model: string;
+  reasoning_effort: string | null;
+  developer_instructions: string | null;
+}
+
+export interface CollaborationMode {
+  mode: 'plan' | 'default';
+  settings: CollaborationModeSettings;
+}
+
+export interface TurnStartParams {
+  threadId: string;
+  input: UserInput[];
+  cwd?: string;
+  approvalPolicy?: string;
+  approvalsReviewer?: string;
+  model?: string;
+  serviceTier?: string | null;
+  effort?: string;
+  summary?: 'auto' | 'concise' | 'detailed' | 'none';
+  sandboxPolicy?: SandboxPolicy | null;
+  personality?: string;
+  outputSchema?: unknown;
+  collaborationMode?: CollaborationMode;
+}
+
+export interface TurnStartResult {
+  turn: Turn;
+}
+
+// ---------------------------------------------------------------------------
+// turn/steer
+// ---------------------------------------------------------------------------
+
+export interface TurnSteerParams {
+  threadId: string;
+  input: UserInput[];
+  expectedTurnId: string;
+}
+
+export interface TurnSteerResult {
+  turnId: string;
+}
+
+// ---------------------------------------------------------------------------
+// turn/interrupt
+// ---------------------------------------------------------------------------
+
+export interface TurnInterruptParams {
+  threadId: string;
+  turnId: string;
+}
+
+// ---------------------------------------------------------------------------
+// Server notifications
+// ---------------------------------------------------------------------------
+
+export interface ThreadStartedNotification {
+  thread: Thread;
+}
+
+export interface ThreadStatusChangedNotification {
+  threadId: string;
+  status: ThreadStatus;
+}
+
+export interface TurnStartedNotification {
+  threadId: string;
+  turn: Turn;
+}
+
+export interface TurnCompletedNotification {
+  threadId: string;
+  turn: Turn;
+}
+
+export interface ItemStartedNotification {
+  item: ThreadItem;
+  threadId: string;
+  turnId: string;
+}
+
+export interface ItemCompletedNotification {
+  item: ThreadItem;
+  threadId: string;
+  turnId: string;
+}
+
+export interface AgentMessageDeltaNotification {
+  threadId: string;
+  turnId: string;
+  itemId: string;
+  delta: string;
+}
+
+export interface TokenUsage {
+  totalTokens: number;
+  inputTokens: number;
+  cachedInputTokens: number;
+  outputTokens: number;
+  reasoningOutputTokens: number;
+}
+
+export interface TokenUsageUpdatedNotification {
+  threadId: string;
+  turnId: string;
+  tokenUsage: {
+    total: TokenUsage;
+    last: TokenUsage;
+    modelContextWindow: number;
+  };
+}
+
+export interface PlanStep {
+  step: string;
+  status: string;
+}
+
+export interface TurnPlanUpdatedNotification {
+  threadId: string;
+  turnId: string;
+  explanation: string | null;
+  plan: PlanStep[];
+}
+
+export interface ErrorNotification {
+  error: TurnError;
+  willRetry: boolean;
+  threadId: string;
+  turnId: string;
+}
+
+export interface ReasoningSummaryPartAddedNotification {
+  threadId: string;
+  turnId: string;
+  itemId: string;
+  summaryIndex: number;
+}
+
+export interface ReasoningSummaryTextDeltaNotification {
+  threadId: string;
+  turnId: string;
+  itemId: string;
+  summaryIndex: number;
+  delta: string;
+}
+
+export interface ReasoningTextDeltaNotification {
+  threadId: string;
+  turnId: string;
+  itemId: string;
+  contentIndex: number;
+  delta: string;
+}
+
+export interface PlanDeltaNotification {
+  threadId: string;
+  turnId: string;
+  itemId: string;
+  delta: string;
+}
+
+export type RequestId = string | number;
+
+export interface ServerRequestResolvedNotification {
+  threadId: string;
+  requestId: RequestId;
+}
+
+// ---------------------------------------------------------------------------
+// Server requests (require client response)
+// ---------------------------------------------------------------------------
+
+// -- Command execution approval (item/commandExecution/requestApproval) ------
+
+export interface CommandApprovalRequest {
+  threadId: string;
+  turnId: string;
+  itemId: string;
+  command: string | null;
+  cwd: string | null;
+  reason?: string | null;
+  commandActions?: CommandAction[] | null;
+  approvalId?: string | null;
+  networkApprovalContext?: {
+    host: string;
+    protocol: string;
+  } | null;
+  additionalPermissions?: AdditionalPermissionProfile | null;
+  skillMetadata?: { pathToSkillsMd: string } | null;
+  proposedExecpolicyAmendment?: string[] | null;
+  proposedNetworkPolicyAmendments?: Array<{
+    host: string;
+    action: 'allow' | 'deny';
+  }> | null;
+  availableDecisions?: CommandExecutionApprovalDecision[] | null;
+}
+
+export type CommandExecutionApprovalDecision =
+  | 'accept'
+  | 'acceptForSession'
+  | { acceptWithExecpolicyAmendment: { execpolicy_amendment: string[] } }
+  | { applyNetworkPolicyAmendment: { network_policy_amendment: { host: string; action: 'allow' | 'deny' } } }
+  | 'decline'
+  | 'cancel';
+
+export interface CommandExecutionApprovalResponse {
+  decision: CommandExecutionApprovalDecision;
+}
+
+// -- File change approval (item/fileChange/requestApproval) ------------------
+
+export interface FileChangeApprovalRequest {
+  threadId: string;
+  turnId: string;
+  itemId: string;
+  reason?: string | null;
+  grantRoot?: string | null;
+}
+
+export type FileChangeApprovalDecision =
+  | 'accept'
+  | 'acceptForSession'
+  | 'decline'
+  | 'cancel';
+
+export interface FileChangeApprovalResponse {
+  decision: FileChangeApprovalDecision;
+}
+
+// -- Permissions approval (item/permissions/requestApproval) -----------------
+
+export interface AdditionalFileSystemPermissions {
+  read?: string[] | null;
+  write?: string[] | null;
+}
+
+export interface AdditionalNetworkPermissions {
+  enabled?: boolean | null;
+}
+
+export interface AdditionalPermissionProfile {
+  fileSystem?: AdditionalFileSystemPermissions | null;
+  network?: AdditionalNetworkPermissions | null;
+  macos?: Record<string, unknown> | null;
+}
+
+export interface RequestPermissionProfile {
+  fileSystem?: AdditionalFileSystemPermissions | null;
+  network?: AdditionalNetworkPermissions | null;
+}
+
+export interface GrantedPermissionProfile {
+  fileSystem?: AdditionalFileSystemPermissions | null;
+  network?: AdditionalNetworkPermissions | null;
+}
+
+export type PermissionGrantScope = 'turn' | 'session';
+
+export interface PermissionsApprovalRequest {
+  threadId: string;
+  turnId: string;
+  itemId: string;
+  permissions: RequestPermissionProfile;
+  reason?: string | null;
+}
+
+export interface PermissionsApprovalResponse {
+  permissions: GrantedPermissionProfile;
+  scope?: PermissionGrantScope;
+}
+
+// -- Tool request user input (item/tool/requestUserInput) --------------------
+
+export interface UserInputQuestionOption {
+  label: string;
+  description: string;
+}
+
+export interface UserInputQuestion {
+  id: string;
+  header: string;
+  question: string;
+  options: UserInputQuestionOption[] | null;
+  isOther: boolean;
+  isSecret: boolean;
+}
+
+export interface UserInputRequest {
+  threadId: string;
+  turnId: string;
+  itemId: string;
+  questions: UserInputQuestion[];
+}
+
+export interface UserInputResponse {
+  answers: Record<string, { answers: string[] }>;
+}

package/src/providers/codex/runtime/codexLaunchTypes.ts

@@ -0,0 +1,30 @@
+import type { CodexInstallationMethod } from '../settings';
+
+export type CodexExecutionMethod = 'host-native' | CodexInstallationMethod;
+export type CodexExecutionPlatformOs = 'windows' | 'linux' | 'macos';
+export type CodexExecutionPlatformFamily = 'windows' | 'unix';
+
+export interface CodexExecutionTarget {
+  method: CodexExecutionMethod;
+  platformFamily: CodexExecutionPlatformFamily;
+  platformOs: CodexExecutionPlatformOs;
+  distroName?: string;
+}
+
+export interface CodexPathMapper {
+  target: CodexExecutionTarget;
+  toTargetPath(hostPath: string): string | null;
+  toHostPath(targetPath: string): string | null;
+  mapTargetPathList(hostPaths: string[]): string[];
+  canRepresentHostPath(hostPath: string): boolean;
+}
+
+export interface CodexLaunchSpec {
+  target: CodexExecutionTarget;
+  command: string;
+  args: string[];
+  spawnCwd: string;
+  targetCwd: string;
+  env: Record<string, string>;
+  pathMapper: CodexPathMapper;
+}