issue-245: fix CommonJS interoperability in tsc-multi and shim files

[CharlieGreenman]

Solves:

1. Cannot use import statement outside a module Node 20 and older versions #213
2. Runtime SyntaxError for typescript 5.8.3 with openai/agents v0.0.12 at agents-core with node v22 locally and AWS lambda #245

I am building my own personal npm package. Will confirm here when works as expected (for AWS Lambda)

[changeset-bot]

⚠️ No Changeset found

Latest commit: 8cfb0a1

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[CharlieGreenman]

I wasn't quite able to get this deployed and I'm not certain this works. If would like I will close

[seratch]

Thank you so much for sending this. As mentioned at one of the comments, this should be good to go, but we need more tests and add automated tests under https://github.com/openai/openai-agents-js/tree/main/integration-tests; I will work on it later this week. If you're willing to help us complete these too, it'd be appreciated.

[seratch]

Thanks for changing this. This change looks reasonable, but we need to verify these before merging the change:

• Do more manual testing
• Add automated tests to ensure this works as expect under https://github.com/openai/openai-agents-js/tree/main/integration-tests

I will spend time on this later this week soon.

[CharlieGreenman]

@seratch sure, feel to work on and close this pull request whenever. Unfortunately. I'm not sure if I will be able to work on in a timely fashion. This is no longer blocking me(was able to work around albeit took time) so no rush. You have my thanks

[vrtnis]

hey @seratch! quick note up front: thanks to @CharlieGreenman for the import.meta shim idea, it’s folded in here.

on the Lambda side: the node 22 runtime still ships without automatic module-syntax detection. i do not believe there is a public commitment from aws to change that e.g. see aws-lambda-base-images#233. NODE_OPTIONS=--experimental-require-module is ignored, and the original Compute blog post hasn’t been updated since launch.

so here we’re still hitting two gaps that need addressing. (1) build artifacts: we need both the ESM and CJS outputs, properly wired via the exports field, so environments like lambda and jest can safely require() the SDK without breaking compatibility for existing ESM consumers.

(2) there’s runtime safety. I think the sdk's shims must avoid unguarded access to import.meta so that CJS environments don’t crash when executing runtime code like loadEnv().

Given everything that needs to land here, I think a fresh PR is the cleanest path forward. I’m putting one together to handle both the dual-build setup and the shim guard. (and would include integration tests that cover import, require, and execution inside the relevant Lamda runtime). I'll have it wrapped up tmrw for review.

[seratch]

Thanks for the inputs. I believe the direction should be good to go, but I just don't have time to do thorough testing right now. Any inputs / suggestions / contributions for this would be greatly appreciated.