agent/codex
2
0
Fork 0
mirror of https://github.com/pchuan98/codex.git synced 2026-07-01 00:31:56 +08:00
Code Issues Packages Projects Releases Wiki Activity
1,872 Commits 2 Branches 0 Tags
2eecc1a2e4eb380ca9373c186c2b35945b3ecb17
Commit Graph

27 Commits

  • [SDK] Add network_access and web_search options to TypeScript SDK (#6367) 
    ## Summary

This PR adds two new optional boolean fields to `ThreadOptions` in the
TypeScript SDK:

- **`networkAccess`**: Enables network access in the sandbox by setting
`sandbox_workspace_write.network_access` config
- **`webSearch`**: Enables the web search tool by setting
`tools.web_search` config

These options map to existing Codex configuration options and are
properly threaded through the SDK layers:
1. `ThreadOptions` (threadOptions.ts) - User-facing API
2. `CodexExecArgs` (exec.ts) - Internal execution args  
3. CLI flags via `--config` in the `codex exec` command

## Changes

- `sdk/typescript/src/threadOptions.ts`: Added `networkAccess` and
`webSearch` fields to `ThreadOptions` type
- `sdk/typescript/src/exec.ts`: Added fields to `CodexExecArgs` and CLI
flag generation
- `sdk/typescript/src/thread.ts`: Pass options through to exec layer

## Test Plan

- [x] Build succeeds (`pnpm build`)
- [x] Linter passes (`pnpm lint`)
- [x] Type definitions are properly exported
- [ ] Manual testing with sample code (to be done by reviewer)

---------

Co-authored-by: Claude <noreply@anthropic.com>
    Dan Hernandez · 2025-11-07 13:19:34 -08:00
    c76528ca1f
  • Add modelReasoningEffort option to TypeScript SDK (#6237) 
    ## Summary
- Adds `ModelReasoningEffort` type to TypeScript SDK with values:
`minimal`, `low`, `medium`, `high`
- Adds `modelReasoningEffort` option to `ThreadOptions`
- Forwards the option to the codex CLI via `--config
model_reasoning_effort="<value>"`
- Includes test coverage for the new option

## Changes
- `sdk/typescript/src/threadOptions.ts`: Define `ModelReasoningEffort`
type and add to `ThreadOptions`
- `sdk/typescript/src/index.ts`: Export `ModelReasoningEffort` type
- `sdk/typescript/src/exec.ts`: Forward `modelReasoningEffort` to CLI as
config flag
- `sdk/typescript/src/thread.ts`: Pass option through to exec (+ debug
logging)
- `sdk/typescript/tests/run.test.ts`: Add test for
`modelReasoningEffort` flag forwarding

---------

Co-authored-by: Eric Traut <etraut@openai.com>
    Dan Hernandez · 2025-11-05 08:51:03 -08:00
    9a10e80ab7
  • Re-enable SDK image forwarding test (#5934) 
    ## Summary
- re-enable the TypeScript SDK test that verifies local images are
forwarded to `codex exec`

## Testing
- `pnpm test` *(fails: unable to download pnpm 10.8.1 because external
network access is blocked in the sandbox)*

------
https://chatgpt.com/codex/tasks/task_i_690289cb861083209fd006867e2adfb1
    pakrym-oai · 2025-10-29 23:18:26 +00:00
    bf35105af6
  • [exec] Add MCP tool arguments and results (#5899) 
    Extends mcp_tool_call item to include arguments and results.
    pakrym-oai · 2025-10-29 14:23:57 -07:00
    815ae4164a
  • Skip flaky test (#5680) 
    Did an investigation but couldn't find anything obvious. Let's skip for
now.
    pakrym-oai · 2025-10-25 12:11:16 -07:00
    c7e4e6d0ee
  • feat: add images support to the Codex Typescript SDK (#5281) 
    Extend `run` and `runStreamed` input to be either a `string` or
structured input. A structured input is an array of text parts and/or
image paths, which will then be fed to the CLI through the `--image`
argument. Text parts are combined with double newlines. For instance:

```ts
const turn = await thread.run([
  { type: "text", text: "Describe these screenshots" },
  { type: "local_image", path: "./ui.png" },
  { type: "local_image", path: "./diagram.jpg" },
  { type: "text", text: "Thanks!" },
]);
```

Ends up launching the CLI with:

```
codex exec --image foo.png --image bar.png "Describe these screenshots\n\nThanks!" 
```

The complete `Input` type for both function now is:

```ts
export type UserInput =
  | {
      type: "text";
      text: string;
    }
  | {
      type: "local_image";
      path: string;
    };

export type Input = string | UserInput[];
```

This brings the Codex SDK closer to feature parity with the CLI.
Adresses #5280 .
    needs · 2025-10-20 09:54:59 -07:00
    3282e86a60
  • Remove unused type (#5003) 
    It was never exported
    pakrym-oai · 2025-10-09 10:29:22 -07:00
    0308febc23
  • Set codex SDK TypeScript originator (#4894) 
    ## Summary
- ensure the TypeScript SDK sets CODEX_INTERNAL_ORIGINATOR_OVERRIDE to
codex_sdk_ts when spawning the Codex CLI
- extend the responses proxy test helper to capture request headers for
assertions
- add coverage that verifies Codex threads launched from the TypeScript
SDK send the codex_sdk_ts originator header

## Testing
- Not Run (not requested)


------
https://chatgpt.com/codex/tasks/task_i_68e561b125248320a487f129093d16e7
    pakrym-oai · 2025-10-07 14:06:41 -07:00
    60f9e85c16
  • Update README.md (#4794) 
    # External (non-OpenAI) Pull Request Requirements

Before opening this Pull Request, please read the dedicated
"Contributing" markdown file or your PR may be closed:
https://github.com/openai/codex/blob/main/docs/contributing.md

If your PR conforms to our contribution guidelines, replace this text
with a detailed and high quality description of your changes.
    pakrym-oai · 2025-10-05 18:21:29 -07:00
    8cd882c4bd
  • Add structured-output support (#4793) 
    Add samples and docs.
    pakrym-oai · 2025-10-05 18:17:50 -07:00
    90fe5e4a7e
  • Expand TypeScript SDK README (#4779) 
    ## Summary
- expand the TypeScript SDK README with streaming, architecture, and API
docs
- refresh quick start examples and clarify thread management options

## Testing
- Not Run (docs only)

---------

Co-authored-by: pakrym-oai <pakrym@openai.com>
    pranavdesh · 2025-10-05 21:43:34 +00:00
    53504a38d2
  • Misc SDK fixes (#4752) 
    Remove codex-level workingDirectory
Throw on turn.failed in `run()`
Cleanup readme
    pakrym-oai · 2025-10-04 19:55:33 -07:00
    356ea6ea34
  • Expose turn token usage in the SDK (#4700) 
    It's present on the event, add it to the final result as well.
    pakrym-oai · 2025-10-03 17:33:23 -07:00
    848058f05b
  • Rename assistant message to agent message and fix item type field naming (#4610) 
    Naming cleanup
    pakrym-oai · 2025-10-02 15:07:14 -07:00
    c405d8c06c
  • Support CODEX_API_KEY for codex exec (#4615) 
    Allows to set API key per invocation of `codex exec`
    pakrym-oai · 2025-10-02 09:59:45 -07:00
    2f6fb37d72
  • Store settings on the thread instead of turn (#4579) 
    It's much more common to keep the same settings for the entire
conversation, we can add per-turn overrides later.
    pakrym-oai · 2025-10-02 00:31:13 +00:00
    c07fb71186
  • Add initial set of doc comments to the SDK (#4513) 
    Also perform minor code cleanup.
    pakrym-oai · 2025-10-01 13:12:59 -07:00
    31102af54b
  • Explicit node imports (#4567) 
    To help with compatibility
    pakrym-oai · 2025-10-01 12:39:04 -07:00
    170c685882
  • SDK: support working directory and skipGitRepoCheck options (#4563) 
    Make options not required, add support for working directory and
skipGitRepoCheck options on the turn
    pakrym-oai · 2025-10-01 11:26:49 -07:00
    8a367ef6bf
  • chore: introduce publishing logic for @openai/codex-sdk (#4543) 
    There was a bit of copypasta I put up with when were publishing two
packages to npm, but now that it's three, I created some more scripts to
consolidate things.

With this change, I ran:

```shell
./scripts/stage_npm_packages.py --release-version 0.43.0-alpha.8 --package codex --package codex-responses-api-proxy --package codex-sdk
```

Indeed when it finished, I ended up with:

```shell
$ tree dist
dist
└── npm
    ├── codex-npm-0.43.0-alpha.8.tgz
    ├── codex-responses-api-proxy-npm-0.43.0-alpha.8.tgz
    └── codex-sdk-npm-0.43.0-alpha.8.tgz
$ tar tzvf dist/npm/codex-sdk-npm-0.43.0-alpha.8.tgz
-rwxr-xr-x  0 0      0    25476720 Oct 26  1985 package/vendor/aarch64-apple-darwin/codex/codex
-rwxr-xr-x  0 0      0    29871400 Oct 26  1985 package/vendor/aarch64-unknown-linux-musl/codex/codex
-rwxr-xr-x  0 0      0    28368096 Oct 26  1985 package/vendor/x86_64-apple-darwin/codex/codex
-rwxr-xr-x  0 0      0    36029472 Oct 26  1985 package/vendor/x86_64-unknown-linux-musl/codex/codex
-rw-r--r--  0 0      0       10926 Oct 26  1985 package/LICENSE
-rw-r--r--  0 0      0    30187520 Oct 26  1985 package/vendor/aarch64-pc-windows-msvc/codex/codex.exe
-rw-r--r--  0 0      0    35277824 Oct 26  1985 package/vendor/x86_64-pc-windows-msvc/codex/codex.exe
-rw-r--r--  0 0      0        4842 Oct 26  1985 package/dist/index.js
-rw-r--r--  0 0      0        1347 Oct 26  1985 package/package.json
-rw-r--r--  0 0      0        9867 Oct 26  1985 package/dist/index.js.map
-rw-r--r--  0 0      0          12 Oct 26  1985 package/README.md
-rw-r--r--  0 0      0        4287 Oct 26  1985 package/dist/index.d.ts
```
    Michael Bolin · 2025-10-01 08:29:59 -07:00
    f815157dd9
  • Add executable detection and export Codex from the SDK (#4532) 
    Executable detection uses the same rules as the codex wrapper.
    pakrym-oai · 2025-09-30 18:06:16 -07:00
    8dd771d217
  • [SDK] Test that a tread can be continued with extra params (#4508)
    pakrym-oai · 2025-09-30 17:22:14 +00:00
    c89b0e1235
  • Support model and sandbox mode in the sdk (#4503)
    pakrym-oai · 2025-09-30 09:00:39 -07:00
    516acc030b
  • SDK CI (#4483) 
    Build debug codex in SDK configuration
    pakrym-oai · 2025-09-29 21:15:02 -07:00
    27c6c5d7a7
  • Rename conversation to thread in codex exec (#4482)
    pakrym-oai · 2025-09-29 20:18:30 -07:00
    ea82f86662
  • Add some types and a basic test to the SDK (#4472)
    pakrym-oai · 2025-09-29 19:40:08 -07:00
    52e591ce60
  • TypeScript SDK scaffold (#4455)
    pakrym-oai · 2025-09-29 13:27:13 -07:00
    adbc38a978