@openai/codex-sdk 0.43.0-alpha.15 → 0.43.0-alpha.16

package/README.md

@@ -51,3 +51,21 @@ const result = await thread.run("Implement the fix");
 
 console.log(result);
 ```
+
+### Working directory
+
+By default, Codex will run in the current working directory. You can change the working directory by passing the `workingDirectory` option to the when creating a thread.
+
+```typescript
+const thread = codex.startThread({
+  workingDirectory: "/path/to/working/directory",
+});
+```
+
+To avoid unrecoverable errors, Codex requires the working directory to be a git repository. You can skip the git repository check by passing the `skipGitRepoCheck` option to the when creating a thread.
+
+```typescript
+const thread = codex.startThread({
+  skipGitRepoCheck: true,
+});
+```

package/dist/index.d.ts

@@ -148,38 +148,6 @@ type ThreadErrorEvent = {
 /** Top-level JSONL events emitted by codex exec. */
 type ThreadEvent = ThreadStartedEvent | TurnStartedEvent | TurnCompletedEvent | TurnFailedEvent | ItemStartedEvent | ItemUpdatedEvent | ItemCompletedEvent | ThreadErrorEvent;
 
-type CodexOptions = {
-    codexPathOverride?: string;
-    baseUrl?: string;
-    apiKey?: string;
-    workingDirectory?: string;
-};
-
-type ApprovalMode = "never" | "on-request" | "on-failure" | "untrusted";
-type SandboxMode = "read-only" | "workspace-write" | "danger-full-access";
-type TurnOptions = {
-    model?: string;
-    sandboxMode?: SandboxMode;
-    workingDirectory?: string;
-    skipGitRepoCheck?: boolean;
-};
-
-type CodexExecArgs = {
-    input: string;
-    baseUrl?: string;
-    apiKey?: string;
-    threadId?: string | null;
-    model?: string;
-    sandboxMode?: SandboxMode;
-    workingDirectory?: string;
-    skipGitRepoCheck?: boolean;
-};
-declare class CodexExec {
-    private executablePath;
-    constructor(executablePath?: string | null);
-    run(args: CodexExecArgs): AsyncGenerator<string>;
-}
-
 /** Completed turn. */
 type Turn = {
     items: ThreadItem[];
@@ -200,16 +168,32 @@ declare class Thread {
     private _exec;
     private _options;
     private _id;
+    private _threadOptions;
     /** Returns the ID of the thread. Populated after the first turn starts. */
     get id(): string | null;
-    constructor(exec: CodexExec, options: CodexOptions, id?: string | null);
     /** Provides the input to the agent and streams events as they are produced during the turn. */
-    runStreamed(input: string, options?: TurnOptions): Promise<StreamedTurn>;
+    runStreamed(input: string): Promise<StreamedTurn>;
     private runStreamedInternal;
     /** Provides the input to the agent and returns the completed turn. */
-    run(input: string, options?: TurnOptions): Promise<Turn>;
+    run(input: string): Promise<Turn>;
 }
 
+type CodexOptions = {
+    codexPathOverride?: string;
+    baseUrl?: string;
+    apiKey?: string;
+    workingDirectory?: string;
+};
+
+type ApprovalMode = "never" | "on-request" | "on-failure" | "untrusted";
+type SandboxMode = "read-only" | "workspace-write" | "danger-full-access";
+type ThreadOptions = {
+    model?: string;
+    sandboxMode?: SandboxMode;
+    workingDirectory?: string;
+    skipGitRepoCheck?: boolean;
+};
+
 /**
  * Codex is the main class for interacting with the Codex agent.
  *
@@ -223,7 +207,7 @@ declare class Codex {
      * Starts a new conversation with an agent.
      * @returns A new thread instance.
      */
-    startThread(): Thread;
+    startThread(options?: ThreadOptions): Thread;
     /**
      * Resumes a conversation with an agent based on the thread id.
      * Threads are persisted in ~/.codex/sessions.
@@ -231,7 +215,7 @@ declare class Codex {
      * @param id The id of the thread to resume.
      * @returns A new thread instance.
      */
-    resumeThread(id: string): Thread;
+    resumeThread(id: string, options?: ThreadOptions): Thread;
 }
 
-export { type ApprovalMode, type AssistantMessageItem, Codex, type CodexOptions, type CommandExecutionItem, type ErrorItem, type FileChangeItem, type Input, type ItemCompletedEvent, type ItemStartedEvent, type ItemUpdatedEvent, type McpToolCallItem, type ReasoningItem, type RunResult, type RunStreamedResult, type SandboxMode, Thread, type ThreadError, type ThreadErrorEvent, type ThreadEvent, type ThreadItem, type ThreadStartedEvent, type TodoListItem, type TurnCompletedEvent, type TurnFailedEvent, type TurnOptions, type TurnStartedEvent, type WebSearchItem };
+export { type ApprovalMode, type AssistantMessageItem, Codex, type CodexOptions, type CommandExecutionItem, type ErrorItem, type FileChangeItem, type Input, type ItemCompletedEvent, type ItemStartedEvent, type ItemUpdatedEvent, type McpToolCallItem, type ReasoningItem, type RunResult, type RunStreamedResult, type SandboxMode, type ThreadOptions as TheadOptions, Thread, type ThreadError, type ThreadErrorEvent, type ThreadEvent, type ThreadItem, type ThreadStartedEvent, type TodoListItem, type TurnCompletedEvent, type TurnFailedEvent, type TurnStartedEvent, type WebSearchItem };

package/dist/index.js

@@ -3,20 +3,24 @@ var Thread = class {
   _exec;
   _options;
   _id;
+  _threadOptions;
   /** Returns the ID of the thread. Populated after the first turn starts. */
   get id() {
     return this._id;
   }
-  constructor(exec, options, id = null) {
+  /* @internal */
+  constructor(exec, options, threadOptions, id = null) {
     this._exec = exec;
     this._options = options;
     this._id = id;
+    this._threadOptions = threadOptions;
   }
   /** Provides the input to the agent and streams events as they are produced during the turn. */
-  async runStreamed(input, options) {
-    return { events: this.runStreamedInternal(input, options) };
+  async runStreamed(input) {
+    return { events: this.runStreamedInternal(input) };
   }
-  async *runStreamedInternal(input, options) {
+  async *runStreamedInternal(input) {
+    const options = this._threadOptions;
     const generator = this._exec.run({
       input,
       baseUrl: this._options.baseUrl,
@@ -41,8 +45,8 @@ var Thread = class {
     }
   }
   /** Provides the input to the agent and returns the completed turn. */
-  async run(input, options) {
-    const generator = this.runStreamedInternal(input, options);
+  async run(input) {
+    const generator = this.runStreamedInternal(input);
     const items = [];
     let finalResponse = "";
     for await (const event of generator) {
@@ -91,7 +95,7 @@ var CodexExec = class {
       env.OPENAI_BASE_URL = args.baseUrl;
     }
     if (args.apiKey) {
-      env.OPENAI_API_KEY = args.apiKey;
+      env.CODEX_API_KEY = args.apiKey;
     }
     const child = spawn(this.executablePath, commandArgs, {
       env
@@ -214,8 +218,8 @@ var Codex = class {
    * Starts a new conversation with an agent.
    * @returns A new thread instance.
    */
-  startThread() {
-    return new Thread(this.exec, this.options);
+  startThread(options = {}) {
+    return new Thread(this.exec, this.options, options);
   }
   /**
    * Resumes a conversation with an agent based on the thread id.
@@ -224,8 +228,8 @@ var Codex = class {
    * @param id The id of the thread to resume.
    * @returns A new thread instance.
    */
-  resumeThread(id) {
-    return new Thread(this.exec, this.options, id);
+  resumeThread(id, options = {}) {
+    return new Thread(this.exec, this.options, options, id);
   }
 };
 export {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/thread.ts","../src/exec.ts","../src/codex.ts"],"sourcesContent":["import { CodexOptions } from \"./codexOptions\";\nimport { ThreadEvent } from \"./events\";\nimport { CodexExec } from \"./exec\";\nimport { ThreadItem } from \"./items\";\nimport { TurnOptions } from \"./turnOptions\";\n\n/** Completed turn. */\nexport type Turn = {\n  items: ThreadItem[];\n  finalResponse: string;\n};\n\n/** Alias for `Turn` to describe the result of `run()`. */\nexport type RunResult = Turn;\n\n/** The result of the `runStreamed` method. */\nexport type StreamedTurn = {\n  events: AsyncGenerator<ThreadEvent>;\n};\n\n/** Alias for `StreamedTurn` to describe the result of `runStreamed()`. */\nexport type RunStreamedResult = StreamedTurn;\n\n/** An input to send to the agent. */\nexport type Input = string;\n\n/** Respesent a thread of conversation with the agent. One thread can have multiple consecutive turns. */\nexport class Thread {\n  private _exec: CodexExec;\n  private _options: CodexOptions;\n  private _id: string | null;\n\n  /** Returns the ID of the thread. Populated after the first turn starts. */\n  public get id(): string | null {\n    return this._id;\n  }\n\n  constructor(exec: CodexExec, options: CodexOptions, id: string | null = null) {\n    this._exec = exec;\n    this._options = options;\n    this._id = id;\n  }\n\n  /** Provides the input to the agent and streams events as they are produced during the turn. */\n  async runStreamed(input: string, options?: TurnOptions): Promise<StreamedTurn> {\n    return { events: this.runStreamedInternal(input, options) };\n  }\n\n  private async *runStreamedInternal(\n    input: string,\n    options?: TurnOptions,\n  ): AsyncGenerator<ThreadEvent> {\n    const generator = this._exec.run({\n      input,\n      baseUrl: this._options.baseUrl,\n      apiKey: this._options.apiKey,\n      threadId: this._id,\n      model: options?.model,\n      sandboxMode: options?.sandboxMode,\n      workingDirectory: options?.workingDirectory,\n      skipGitRepoCheck: options?.skipGitRepoCheck,\n    });\n    for await (const item of generator) {\n      let parsed: ThreadEvent;\n      try {\n        parsed = JSON.parse(item) as ThreadEvent;\n      } catch (error) {\n        throw new Error(`Failed to parse item: ${item}`, { cause: error });\n      }\n      if (parsed.type === \"thread.started\") {\n        this._id = parsed.thread_id;\n      }\n      yield parsed;\n    }\n  }\n\n  /** Provides the input to the agent and returns the completed turn. */\n  async run(input: string, options?: TurnOptions): Promise<Turn> {\n    const generator = this.runStreamedInternal(input, options);\n    const items: ThreadItem[] = [];\n    let finalResponse: string = \"\";\n    for await (const event of generator) {\n      if (event.type === \"item.completed\") {\n        if (event.item.item_type === \"assistant_message\") {\n          finalResponse = event.item.text;\n        }\n        items.push(event.item);\n      }\n    }\n    return { items, finalResponse };\n  }\n}\n","import { spawn } from \"node:child_process\";\n\nimport readline from \"node:readline\";\n\nimport { SandboxMode } from \"./turnOptions\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nexport type CodexExecArgs = {\n  input: string;\n\n  baseUrl?: string;\n  apiKey?: string;\n  threadId?: string | null;\n  // --model\n  model?: string;\n  // --sandbox\n  sandboxMode?: SandboxMode;\n  // --cd\n  workingDirectory?: string;\n  // --skip-git-repo-check\n  skipGitRepoCheck?: boolean;\n};\n\nexport class CodexExec {\n  private executablePath: string;\n  constructor(executablePath: string | null = null) {\n    this.executablePath = executablePath || findCodexPath();\n  }\n\n  async *run(args: CodexExecArgs): AsyncGenerator<string> {\n    const commandArgs: string[] = [\"exec\", \"--experimental-json\"];\n\n    if (args.model) {\n      commandArgs.push(\"--model\", args.model);\n    }\n\n    if (args.sandboxMode) {\n      commandArgs.push(\"--sandbox\", args.sandboxMode);\n    }\n\n    if (args.workingDirectory) {\n      commandArgs.push(\"--cd\", args.workingDirectory);\n    }\n\n    if (args.skipGitRepoCheck) {\n      commandArgs.push(\"--skip-git-repo-check\");\n    }\n\n    if (args.threadId) {\n      commandArgs.push(\"resume\", args.threadId);\n    }\n\n    const env = {\n      ...process.env,\n    };\n    if (args.baseUrl) {\n      env.OPENAI_BASE_URL = args.baseUrl;\n    }\n    if (args.apiKey) {\n      env.OPENAI_API_KEY = args.apiKey;\n    }\n\n    const child = spawn(this.executablePath, commandArgs, {\n      env,\n    });\n\n    let spawnError: unknown | null = null;\n    child.once(\"error\", (err) => (spawnError = err));\n\n    if (!child.stdin) {\n      child.kill();\n      throw new Error(\"Child process has no stdin\");\n    }\n    child.stdin.write(args.input);\n    child.stdin.end();\n\n    if (!child.stdout) {\n      child.kill();\n      throw new Error(\"Child process has no stdout\");\n    }\n    const stderrChunks: Buffer[] = [];\n\n    if (child.stderr) {\n      child.stderr.on(\"data\", (data) => {\n        stderrChunks.push(data);\n      });\n    }\n\n    const rl = readline.createInterface({\n      input: child.stdout,\n      crlfDelay: Infinity,\n    });\n\n    try {\n      for await (const line of rl) {\n        // `line` is a string (Node sets default encoding to utf8 for readline)\n        yield line as string;\n      }\n\n      const exitCode = new Promise((resolve, reject) => {\n        child.once(\"exit\", (code) => {\n          if (code === 0) {\n            resolve(code);\n          } else {\n            const stderrBuffer = Buffer.concat(stderrChunks);\n            reject(\n              new Error(`Codex Exec exited with code ${code}: ${stderrBuffer.toString(\"utf8\")}`),\n            );\n          }\n        });\n      });\n\n      if (spawnError) throw spawnError;\n      await exitCode;\n    } finally {\n      rl.close();\n      child.removeAllListeners();\n      try {\n        if (!child.killed) child.kill();\n      } catch {\n        // ignore\n      }\n    }\n  }\n}\n\nconst scriptFileName = fileURLToPath(import.meta.url);\nconst scriptDirName = path.dirname(scriptFileName);\n\nfunction findCodexPath() {\n  const { platform, arch } = process;\n\n  let targetTriple = null;\n  switch (platform) {\n    case \"linux\":\n    case \"android\":\n      switch (arch) {\n        case \"x64\":\n          targetTriple = \"x86_64-unknown-linux-musl\";\n          break;\n        case \"arm64\":\n          targetTriple = \"aarch64-unknown-linux-musl\";\n          break;\n        default:\n          break;\n      }\n      break;\n    case \"darwin\":\n      switch (arch) {\n        case \"x64\":\n          targetTriple = \"x86_64-apple-darwin\";\n          break;\n        case \"arm64\":\n          targetTriple = \"aarch64-apple-darwin\";\n          break;\n        default:\n          break;\n      }\n      break;\n    case \"win32\":\n      switch (arch) {\n        case \"x64\":\n          targetTriple = \"x86_64-pc-windows-msvc\";\n          break;\n        case \"arm64\":\n          targetTriple = \"aarch64-pc-windows-msvc\";\n          break;\n        default:\n          break;\n      }\n      break;\n    default:\n      break;\n  }\n\n  if (!targetTriple) {\n    throw new Error(`Unsupported platform: ${platform} (${arch})`);\n  }\n\n  const vendorRoot = path.join(scriptDirName, \"..\", \"vendor\");\n  const archRoot = path.join(vendorRoot, targetTriple);\n  const codexBinaryName = process.platform === \"win32\" ? \"codex.exe\" : \"codex\";\n  const binaryPath = path.join(archRoot, \"codex\", codexBinaryName);\n\n  return binaryPath;\n}\n","import { CodexOptions } from \"./codexOptions\";\nimport { CodexExec } from \"./exec\";\nimport { Thread } from \"./thread\";\n\n/**\n * Codex is the main class for interacting with the Codex agent.\n *\n * Use the `startThread()` method to start a new thread or `resumeThread()` to resume a previously started thread.\n */\nexport class Codex {\n  private exec: CodexExec;\n  private options: CodexOptions;\n\n  constructor(options: CodexOptions = {}) {\n    this.exec = new CodexExec(options.codexPathOverride);\n    this.options = options;\n  }\n\n  /**\n   * Starts a new conversation with an agent.\n   * @returns A new thread instance.\n   */\n  startThread(): Thread {\n    return new Thread(this.exec, this.options);\n  }\n\n  /**\n   * Resumes a conversation with an agent based on the thread id.\n   * Threads are persisted in ~/.codex/sessions.\n   *\n   * @param id The id of the thread to resume.\n   * @returns A new thread instance.\n   */\n  resumeThread(id: string): Thread {\n    return new Thread(this.exec, this.options, id);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/thread.ts","../src/exec.ts","../src/codex.ts"],"sourcesContent":["import { CodexOptions } from \"./codexOptions\";\nimport { ThreadEvent } from \"./events\";\nimport { CodexExec } from \"./exec\";\nimport { ThreadItem } from \"./items\";\nimport { ThreadOptions } from \"./threadOptions\";\n\n/** Completed turn. */\nexport type Turn = {\n  items: ThreadItem[];\n  finalResponse: string;\n};\n\n/** Alias for `Turn` to describe the result of `run()`. */\nexport type RunResult = Turn;\n\n/** The result of the `runStreamed` method. */\nexport type StreamedTurn = {\n  events: AsyncGenerator<ThreadEvent>;\n};\n\n/** Alias for `StreamedTurn` to describe the result of `runStreamed()`. */\nexport type RunStreamedResult = StreamedTurn;\n\n/** An input to send to the agent. */\nexport type Input = string;\n\n/** Respesent a thread of conversation with the agent. One thread can have multiple consecutive turns. */\nexport class Thread {\n  private _exec: CodexExec;\n  private _options: CodexOptions;\n  private _id: string | null;\n  private _threadOptions: ThreadOptions;\n\n  /** Returns the ID of the thread. Populated after the first turn starts. */\n  public get id(): string | null {\n    return this._id;\n  }\n\n  /* @internal */\n  constructor(\n    exec: CodexExec,\n    options: CodexOptions,\n    threadOptions: ThreadOptions,\n    id: string | null = null,\n  ) {\n    this._exec = exec;\n    this._options = options;\n    this._id = id;\n    this._threadOptions = threadOptions;\n  }\n\n  /** Provides the input to the agent and streams events as they are produced during the turn. */\n  async runStreamed(input: string): Promise<StreamedTurn> {\n    return { events: this.runStreamedInternal(input) };\n  }\n\n  private async *runStreamedInternal(input: string): AsyncGenerator<ThreadEvent> {\n    const options = this._threadOptions;\n    const generator = this._exec.run({\n      input,\n      baseUrl: this._options.baseUrl,\n      apiKey: this._options.apiKey,\n      threadId: this._id,\n      model: options?.model,\n      sandboxMode: options?.sandboxMode,\n      workingDirectory: options?.workingDirectory,\n      skipGitRepoCheck: options?.skipGitRepoCheck,\n    });\n    for await (const item of generator) {\n      let parsed: ThreadEvent;\n      try {\n        parsed = JSON.parse(item) as ThreadEvent;\n      } catch (error) {\n        throw new Error(`Failed to parse item: ${item}`, { cause: error });\n      }\n      if (parsed.type === \"thread.started\") {\n        this._id = parsed.thread_id;\n      }\n      yield parsed;\n    }\n  }\n\n  /** Provides the input to the agent and returns the completed turn. */\n  async run(input: string): Promise<Turn> {\n    const generator = this.runStreamedInternal(input);\n    const items: ThreadItem[] = [];\n    let finalResponse: string = \"\";\n    for await (const event of generator) {\n      if (event.type === \"item.completed\") {\n        if (event.item.item_type === \"assistant_message\") {\n          finalResponse = event.item.text;\n        }\n        items.push(event.item);\n      }\n    }\n    return { items, finalResponse };\n  }\n}\n","import { spawn } from \"node:child_process\";\n\nimport readline from \"node:readline\";\n\nimport { SandboxMode } from \"./threadOptions\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nexport type CodexExecArgs = {\n  input: string;\n\n  baseUrl?: string;\n  apiKey?: string;\n  threadId?: string | null;\n  // --model\n  model?: string;\n  // --sandbox\n  sandboxMode?: SandboxMode;\n  // --cd\n  workingDirectory?: string;\n  // --skip-git-repo-check\n  skipGitRepoCheck?: boolean;\n};\n\nexport class CodexExec {\n  private executablePath: string;\n  constructor(executablePath: string | null = null) {\n    this.executablePath = executablePath || findCodexPath();\n  }\n\n  async *run(args: CodexExecArgs): AsyncGenerator<string> {\n    const commandArgs: string[] = [\"exec\", \"--experimental-json\"];\n\n    if (args.model) {\n      commandArgs.push(\"--model\", args.model);\n    }\n\n    if (args.sandboxMode) {\n      commandArgs.push(\"--sandbox\", args.sandboxMode);\n    }\n\n    if (args.workingDirectory) {\n      commandArgs.push(\"--cd\", args.workingDirectory);\n    }\n\n    if (args.skipGitRepoCheck) {\n      commandArgs.push(\"--skip-git-repo-check\");\n    }\n\n    if (args.threadId) {\n      commandArgs.push(\"resume\", args.threadId);\n    }\n\n    const env = {\n      ...process.env,\n    };\n    if (args.baseUrl) {\n      env.OPENAI_BASE_URL = args.baseUrl;\n    }\n    if (args.apiKey) {\n      env.CODEX_API_KEY = args.apiKey;\n    }\n\n    const child = spawn(this.executablePath, commandArgs, {\n      env,\n    });\n\n    let spawnError: unknown | null = null;\n    child.once(\"error\", (err) => (spawnError = err));\n\n    if (!child.stdin) {\n      child.kill();\n      throw new Error(\"Child process has no stdin\");\n    }\n    child.stdin.write(args.input);\n    child.stdin.end();\n\n    if (!child.stdout) {\n      child.kill();\n      throw new Error(\"Child process has no stdout\");\n    }\n    const stderrChunks: Buffer[] = [];\n\n    if (child.stderr) {\n      child.stderr.on(\"data\", (data) => {\n        stderrChunks.push(data);\n      });\n    }\n\n    const rl = readline.createInterface({\n      input: child.stdout,\n      crlfDelay: Infinity,\n    });\n\n    try {\n      for await (const line of rl) {\n        // `line` is a string (Node sets default encoding to utf8 for readline)\n        yield line as string;\n      }\n\n      const exitCode = new Promise((resolve, reject) => {\n        child.once(\"exit\", (code) => {\n          if (code === 0) {\n            resolve(code);\n          } else {\n            const stderrBuffer = Buffer.concat(stderrChunks);\n            reject(\n              new Error(`Codex Exec exited with code ${code}: ${stderrBuffer.toString(\"utf8\")}`),\n            );\n          }\n        });\n      });\n\n      if (spawnError) throw spawnError;\n      await exitCode;\n    } finally {\n      rl.close();\n      child.removeAllListeners();\n      try {\n        if (!child.killed) child.kill();\n      } catch {\n        // ignore\n      }\n    }\n  }\n}\n\nconst scriptFileName = fileURLToPath(import.meta.url);\nconst scriptDirName = path.dirname(scriptFileName);\n\nfunction findCodexPath() {\n  const { platform, arch } = process;\n\n  let targetTriple = null;\n  switch (platform) {\n    case \"linux\":\n    case \"android\":\n      switch (arch) {\n        case \"x64\":\n          targetTriple = \"x86_64-unknown-linux-musl\";\n          break;\n        case \"arm64\":\n          targetTriple = \"aarch64-unknown-linux-musl\";\n          break;\n        default:\n          break;\n      }\n      break;\n    case \"darwin\":\n      switch (arch) {\n        case \"x64\":\n          targetTriple = \"x86_64-apple-darwin\";\n          break;\n        case \"arm64\":\n          targetTriple = \"aarch64-apple-darwin\";\n          break;\n        default:\n          break;\n      }\n      break;\n    case \"win32\":\n      switch (arch) {\n        case \"x64\":\n          targetTriple = \"x86_64-pc-windows-msvc\";\n          break;\n        case \"arm64\":\n          targetTriple = \"aarch64-pc-windows-msvc\";\n          break;\n        default:\n          break;\n      }\n      break;\n    default:\n      break;\n  }\n\n  if (!targetTriple) {\n    throw new Error(`Unsupported platform: ${platform} (${arch})`);\n  }\n\n  const vendorRoot = path.join(scriptDirName, \"..\", \"vendor\");\n  const archRoot = path.join(vendorRoot, targetTriple);\n  const codexBinaryName = process.platform === \"win32\" ? \"codex.exe\" : \"codex\";\n  const binaryPath = path.join(archRoot, \"codex\", codexBinaryName);\n\n  return binaryPath;\n}\n","import { CodexOptions } from \"./codexOptions\";\nimport { CodexExec } from \"./exec\";\nimport { Thread } from \"./thread\";\nimport { ThreadOptions } from \"./threadOptions\";\n\n/**\n * Codex is the main class for interacting with the Codex agent.\n *\n * Use the `startThread()` method to start a new thread or `resumeThread()` to resume a previously started thread.\n */\nexport class Codex {\n  private exec: CodexExec;\n  private options: CodexOptions;\n\n  constructor(options: CodexOptions = {}) {\n    this.exec = new CodexExec(options.codexPathOverride);\n    this.options = options;\n  }\n\n  /**\n   * Starts a new conversation with an agent.\n   * @returns A new thread instance.\n   */\n  startThread(options: ThreadOptions = {}): Thread {\n    return new Thread(this.exec, this.options, options);\n  }\n\n  /**\n   * Resumes a conversation with an agent based on the thread id.\n   * Threads are persisted in ~/.codex/sessions.\n   *\n   * @param id The id of the thread to resume.\n   * @returns A new thread instance.\n   */\n  resumeThread(id: string, options: ThreadOptions = {}): Thread {\n    return new Thread(this.exec, this.options, options, id);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openai/codex-sdk",
-  "version": "0.43.0-alpha.15",
+  "version": "0.43.0-alpha.16",
   "description": "TypeScript SDK for Codex APIs.",
   "repository": {
     "type": "git",