Merge branch 'main' into issue-245-branch-commonjs-interop

Author: seratch

.changeset/spotty-nights-tell.md

@@ -0,0 +1,9 @@
+---
+'@openai/agents-extensions': patch
+'@openai/agents-realtime': patch
+'@openai/agents-openai': patch
+'@openai/agents-core': patch
+'@openai/agents': patch
+---
+
+Fix #187 Agent outputType type error with [email protected]+

.changeset/tender-turtles-carry.md

@@ -0,0 +1,48 @@
+name: Create Release Tag
+
+on:
+  push:
+    branches:
+      - main
+
+env:
+  CI: true
+
+jobs:
+  create-tag:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Determine if latest commit is a version bump
+        id: check
+        run: |
+          commit_message=$(git log -1 --pretty=%B)
+          echo "Latest commit message: $commit_message"
+          if [[ "$commit_message" == "chore: update versions"* ]]; then
+            echo "is_version_bump=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "is_version_bump=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create and push git tag
+        if: steps.check.outputs.is_version_bump == 'true'
+        run: |
+          version=$(jq -r '.version' packages/agents/package.json)
+          tag="v${version}"
+          echo "Tag derived from package version: $tag"
+
+          if git rev-parse "refs/tags/$tag" >/dev/null 2>&1; then
+            echo "Tag $tag already exists. Skipping."
+            exit 0
+          fi
+
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag -a "$tag" -m "Release $tag"
+          git push origin "$tag" 

.github/workflows/release-tag.yml

@@ -1,4 +1,4 @@
-name: Changesets
+name: Changesets Release
 
 on:
   workflow_run:
@@ -45,34 +45,10 @@ jobs:
         with:
           commit: 'chore: update versions'
           title: 'chore: update versions'
+          version: pnpm bump-version
           publish: pnpm ci:publish
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           NPM_CONFIG_PROVENANCE: true
           NPM_CONFIG_ACCESS: public
-
-      - name: Push metadata changes
-        run: |
-          files="packages/agents-core/src/metadata.ts packages/agents-extensions/src/metadata.ts packages/agents-openai/src/metadata.ts packages/agents-realtime/src/metadata.ts packages/agents/src/metadata.ts"
-          if git diff --quiet -- $files; then
-            echo "No metadata changes to push"
-          else
-            # -- Commit all the metadata.ts files --
-            git config user.name "github-actions[bot]"
-            git config user.email "github-actions[bot]@users.noreply.github.com"
-            git add $files
-            git commit -m "chore: sync metadata files"
-            git push origin HEAD:main
-            # -- Push a new release tag as well --
-            # We don't use changeset release command because we always do release for all the packages
-            # Thus, creating git tags manually here
-            version=$(jq -r '.version' packages/agents/package.json)
-            tag="v${version}"
-            if git rev-parse "refs/tags/$tag" >/dev/null 2>&1; then
-              echo "Tag $tag already exists"
-            else
-              git tag -a "$tag" -m "Release $tag"
-              git push origin "$tag"
-            fi
-          fi

.github/workflows/release.yml

@@ -37,4 +37,4 @@ jobs:
       - name: Compile examples
         run: pnpm -r build-check
       - name: Run tests
-        run: pnpm test
+        run: pnpm test

.github/workflows/test.yml

@@ -0,0 +1,65 @@
+name: "Update Translated Docs"
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - '!docs/src/content/docs/ja/**'
+
+jobs:
+  update-docs:
+    if: "!contains(github.event.head_commit.message, 'Update all translated document pages')"
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.13.1
+          run_install: false
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: 'pnpm'
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build workspace packages
+        run: pnpm build
+
+      - name: Translate docs
+        env:
+          OPENAI_API_KEY: ${{ secrets.PROD_OPENAI_API_KEY }}
+        run: |
+          pnpm docs:translate
+          pnpm docs:build  # to make sure if the generated docs are valid
+
+      - name: Commit changes
+        id: commit
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add docs/
+          if [ -n "$(git status --porcelain)" ]; then
+            git commit -m "Update all translated document pages"
+            echo "committed=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "No changes to commit"
+            echo "committed=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create Pull Request
+        if: steps.commit.outputs.committed == 'true'
+        uses: peter-evans/create-pull-request@v6
+        with:
+          commit-message: "Update all translated document pages"
+          title: "Update all translated document pages"
+          body: "Automated update of translated documentation"
+          branch: update-translated-docs-${{ github.run_id }}
+          delete-branch: true

.github/workflows/update-docs.yml

@@ -8,5 +8,11 @@ git update-index --again
 
 # check for secrets
 if [ -z "$CI" ] && [ -z "$GITHUB_ACTIONS" ]; then
+  if ! command -v trufflehog >/dev/null 2>&1; then
+    echo "trufflehog' is not installed or not in your PATH."
+    echo "Download it from: https://github.com/trufflesecurity/trufflehog"
+    echo "Skipping secrets check due to missing trufflehog."
+    exit 1
+  fi
   trufflehog git file://. --since-commit HEAD --fail
 fi

.husky/pre-commit

@@ -1,5 +1,8 @@
 # OpenAI Agents SDK (JavaScript/TypeScript)
 
+[![npm version](https://badge.fury.io/js/@openai%2Fagents.svg)](https://badge.fury.io/js/@openai%2Fagents)
+[![CI](https://github.com/openai/openai-agents-js/actions/workflows/test.yml/badge.svg)](https://github.com/openai/openai-agents-js/actions/workflows/test.yml)
+
 The OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows in JavaScript/TypeScript. It is provider-agnostic, supporting OpenAI APIs and more.
 
 <img src="https://cdn.openai.com/API/docs/images/orchestration.png" alt="Image of the Agents Tracing UI" style="max-height: 803px;">

README.md

@@ -11,16 +11,16 @@
     "translate": "tsx src/scripts/translate.ts"
   },
   "dependencies": {
-    "@astrojs/starlight": "^0.34.3",
-    "@astrojs/starlight-tailwind": "^3.0.1",
+    "@astrojs/starlight": "^0.35.2",
+    "@astrojs/starlight-tailwind": "^4.0.1",
     "@openai/agents": "workspace:*",
     "@tailwindcss/vite": "^4.0.17",
-    "astro": "^5.5.3",
+    "astro": "^5.13.0",
     "sharp": "^0.34.2",
-    "starlight-llms-txt": "^0.5.0",
-    "starlight-typedoc": "^0.21.0",
+    "starlight-llms-txt": "^0.6.0",
+    "starlight-typedoc": "^0.21.3",
     "typedoc": "^0.28.1",
-    "typedoc-plugin-markdown": "^4.6.0"
+    "typedoc-plugin-markdown": "^4.8.1"
   },
   "devDependencies": {
     "tailwindcss": "^3.3.3",