Skip to content

feat(api): add organization Decisions usage reporting - #1165

Merged
jbeckwith-oai merged 1 commit into
mainfrom
castiron/promotions/pr-244
Oct 12, 2026
Merged

jbeckwith-oai merged 1 commit into
mainfrom
castiron/promotions/pr-244

Conversation

@jbeckwith-oai

Copy link
Copy Markdown
Contributor

Summary

Query organization-wide Decisions API usage with the Java client.

Changes

  • Add Decisions usage services and typed request/response models, with filtering, grouping, and page cursors.
  • Read token counts, model request totals, and optional usage-source attribution.

Castiron-Internal-PR: openai/openai-java-internal#244
Castiron-Source-SHA: 510de9989721ecd17a8238ad58488a8bb0162e9d
Castiron-Public-Base-SHA: 3efd4ca
@jbeckwith-oai
jbeckwith-oai marked this pull request as ready for review October 12, 2026 04:48
@jbeckwith-oai
jbeckwith-oai requested a review from a team as a code owner October 12, 2026 04:48
@github-actions

github-actions Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

Castiron custom code

Evaluated main: 3efd4ca9009aadeeb24484216f76344baca1f303.

✅ No new custom-code files detected.

108 mixed files remain; 0 existing customizations changed.

Compared 3efd4ca9009a → ab32e30b421f. Generated baselines verified.

108 existing customizations unchanged
  • openai-java-core/src/main/kotlin/com/openai/models/audio/AudioResponseFormat.kt
  • openai-java-core/src/main/kotlin/com/openai/models/beta/agents/environments/EnvironmentCreateParams.kt
  • openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuth.kt
  • openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuthCreateParam.kt
  • openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuthRotateParam.kt
  • openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponse.kt
  • openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectEvent.kt
  • openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectFailedEvent.kt
  • openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStreamEvent.kt
  • openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemParam.kt
  • openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesServerEvent.kt
  • openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParams.kt
  • openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionMessageFunctionToolCall.kt
  • openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionToolMessageParam.kt
  • openai-java-core/src/main/kotlin/com/openai/models/conversations/ConversationCreateParams.kt
  • openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ItemCreateParams.kt
  • openai-java-core/src/main/kotlin/com/openai/models/embeddings/Embedding.kt
  • openai-java-core/src/main/kotlin/com/openai/models/embeddings/EmbeddingCreateParams.kt
  • openai-java-core/src/main/kotlin/com/openai/models/live/ResponseItemCreateEvent.kt
  • openai-java-core/src/main/kotlin/com/openai/models/responses/Response.kt
  • openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCreateParams.kt
  • openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCall.kt
  • openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionWebSearch.kt
  • openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputItem.kt
  • openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseStreamEvent.kt
  • openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseTextConfig.kt
  • openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemParam.kt
  • openai-java-core/src/main/kotlin/com/openai/models/responses/ResponsesServerEvent.kt
  • openai-java-core/src/main/kotlin/com/openai/models/videos/Video.kt
  • openai-java-core/src/main/kotlin/com/openai/models/webhooks/UnwrapWebhookEvent.kt
  • openai-java-core/src/main/kotlin/com/openai/models/webhooks/WebhookEndpointWithSecret.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/ImageServiceAsyncImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/ResponseServiceAsync.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/ResponseServiceAsyncImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/SkillServiceAsyncImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/VideoServiceAsyncImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/WebhookServiceAsync.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/WebhookServiceAsyncImpl.kt

68 more in the full report.

A changed generated baseline means this report cannot reliably identify which handwritten lines changed.

Inspect the custom-code diff

Download the exact patch produced by this run (requires repository access):

gh run download 38205282700 --repo openai/openai-java \
  --name castiron-custom-code-38205282700-1 --dir /tmp/castiron-custom-code-38205282700-1
git apply --stat /tmp/castiron-custom-code-38205282700-1/custom-code.patch
cat /tmp/castiron-custom-code-38205282700-1/custom-code.patch

Or reproduce it from an SDK checkout containing the vendored reporter:

git fetch --no-tags origin 3efd4ca9009aadeeb24484216f76344baca1f303 ab32e30b421f077e4fc03ec8642cec1beb8787cd
python3 scripts/castiron/custom_code_report.py report \
  --base 3efd4ca9009aadeeb24484216f76344baca1f303 \
  --head ab32e30b421f077e4fc03ec8642cec1beb8787cd --fetch --require-head-hash --public \
  --out /tmp/castiron-custom-code-ab32e30b421f
cat /tmp/castiron-custom-code-ab32e30b421f/custom-code.patch

This is the current full custom patch for mixed files, not an attribution of only the handwritten lines changed by this PR.

Full report and patch

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-12T04:50:37.562377Z ab32e30 Draft marked ready
🔒 Security Review ✅ Completed 2026-10-12T04:51:05.465334Z ab32e30 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@openai-sdks

openai-sdks Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

OkTest Summary

✅ 236/236 SDK tests passed in 16.344s for Java SDK PR #1165.

Test results — 42 files
Test Result Time
tests/chat-completions-complex-body.test.ts ✅ Passed 172ms
tests/chat-completions-create.test.ts ✅ Passed 810ms
tests/chat-completions-stream.test.ts ✅ Passed 971ms
tests/files-content-binary.test.ts ✅ Passed 301ms
tests/files-create-multipart.test.ts ✅ Passed 465ms
tests/files-list-pagination.test.ts ✅ Passed 348ms
tests/initialize-config.test.ts ✅ Passed 220ms
tests/instance-isolation.test.ts ✅ Passed 280ms
tests/models-list.test.ts ✅ Passed 294ms
tests/responses-background-lifecycle.test.ts ✅ Passed 287ms
tests/responses-body-method-errors.test.ts ✅ Passed 526ms
tests/responses-cancel-timeout.test.ts ✅ Passed 256ms
tests/responses-cancel.test.ts ✅ Passed 376ms
tests/responses-compact-retries.test.ts ✅ Passed 456ms
tests/responses-compact.test.ts ✅ Passed 430ms
tests/responses-create-advanced-stream.test.ts ✅ Passed 420ms
tests/responses-create-advanced.test.ts ✅ Passed 1.587s
tests/responses-create-disconnect.test.ts ✅ Passed 1.138s
tests/responses-create-errors.test.ts ✅ Passed 345ms
tests/responses-create-malformed-api-responses.test.ts ✅ Passed 236ms
tests/responses-create-retries.test.ts ✅ Passed 414ms
tests/responses-create-stream-failures.test.ts ✅ Passed 273ms
tests/responses-create-stream-timeout.test.ts ✅ Passed 249ms
tests/responses-create-stream-wire.test.ts ✅ Passed 5.375s
tests/responses-create-stream.test.ts ✅ Passed 704ms
tests/responses-create-terminal-states.test.ts ✅ Passed 299ms
tests/responses-create-timeout.test.ts ✅ Passed 259ms
tests/responses-create.test.ts ✅ Passed 1.14s
tests/responses-delete.test.ts ✅ Passed 314ms
tests/responses-input-items-errors.test.ts ✅ Passed 301ms
tests/responses-input-items-list.test.ts ✅ Passed 397ms
tests/responses-input-items-options.test.ts ✅ Passed 420ms
tests/responses-input-tokens-count-timeout.test.ts ✅ Passed 306ms
tests/responses-input-tokens-count.test.ts ✅ Passed 286ms
tests/responses-malformed-inputs.test.ts ✅ Passed 4.158s
tests/responses-not-found-errors.test.ts ✅ Passed 345ms
tests/responses-parse.test.ts ✅ Passed 790ms
tests/responses-retrieve-retries.test.ts ✅ Passed 303ms
tests/responses-retrieve.test.ts ✅ Passed 337ms
tests/responses-stored-method-errors.test.ts ✅ Passed 1.133s
tests/retry-behavior.test.ts ✅ Passed 3.47s
tests/sdk-error-shape.test.ts ✅ Passed 515ms

View OkTest run #38205258405

SDK merge (2f774b6301ae) · head (ab32e30b421f) · base (3efd4ca9009a) · OkTest (523fbcfab0a7)

@markstuart-oai markstuart-oai left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed ab32e30b421f077e4fc03ec8642cec1beb8787cd against 3efd4ca9009aadeeb24484216f76344baca1f303. No blocking findings.

The blocking and async methods use the admin-key GET route. Query builders preserve false values, omit absent filters, and use the existing array encoding. The typed response includes the token counters, optional source attribution, and fields needed for explicit cursor continuation. The schema adds only the Decisions usage endpoint and its nine schemas.

The new 2,241-line response file follows the generated layout for the page, bucket, and result types. Reusing the broader completions union would admit unrelated result variants. I found no useful manual split for this generated model.

Source-only review, including the committed tests. Lint, build logic, version support, and Castiron checks passed. The main build and OkTest were still running when inspected. I ran no repository workloads.

@jbeckwith-oai
jbeckwith-oai added this pull request to the merge queue Oct 12, 2026
Merged via the queue into main with commit 1b29d6e Oct 12, 2026
17 checks passed
@openai-sdks openai-sdks Bot mentioned this pull request Oct 12, 2026
jaredosgood pushed a commit to jaredosgood/openai-java that referenced this pull request Oct 22, 2026
Automated Release PR
---


##
[4.81.0](openai/openai-java@v4.80.0...v4.81.0)
(2026-10-13)


### Features

* **api:** add organization Decisions usage reporting
([openai#1165](openai#1165))
([1b29d6e](openai@1b29d6e))
* **api:** add shida to named Live voices
([openai#1163](openai#1163))
([22bd97e](openai@22bd97e))
* **api:** share OCI external-storage response types
([openai#1164](openai#1164))
([3efd4ca](openai@3efd4ca))
* **api:** support updating project API key expiry
([openai#1167](openai#1167))
([cefea29](openai@cefea29))


### Bug Fixes

* **auth:** close transport after workload cleanup failure
([openai#1146](openai#1146))
([bdc31c7](openai@bdc31c7))


### Chores

* **api:** refresh API reference examples
([openai#1166](openai#1166))
([df74d10](openai@df74d10))
* **api:** retain existing vault update support
([openai#1161](openai#1161))
([d3f1053](openai@d3f1053))


### Build System

* **deps:** bump actions/cache/restore from 5.1.0 to 6.1.0
([openai#1170](openai#1170))
([101463a](openai@101463a))
* **deps:** bump actions/cache/save from 5.1.0 to 6.1.0
([openai#1171](openai#1171))
([170bc2d](openai@170bc2d))
* **deps:** bump graalvm/setup-graalvm from 1.6.6 to 1.6.7
([openai#1172](openai#1172))
([8edbcff](openai@8edbcff))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: openai-sdks[bot] <284451331+openai-sdks[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants