chore(docs): prevent 'npx typedoc' failure in scripts/reference-generation/weave/generate_typescript_sdk_docs.py

[drtangible]

Description

• The Generate Weave references GH action is currently throwing an exception on npx typedoc:

[info] Loaded plugin typedoc-plugin-markdown
src/esm/instrument.mts:35:43 - error TS1343: The 'import.meta' meta-property is only allowed when the '--module' option is 'es2020', 'es2022', 'esnext', 'system', 'node16', or 'nodenext'.

35 register('import-in-the-middle/hook.mjs', import.meta.url, registerOptions);
                                             ~~~~~~~~~~~

src/table.ts:76:41 - error TS1323: Dynamic imports are only supported when the '--module' flag is set to 'es2020', 'es2022', 'esnext', 'commonjs', 'amd', 'system', 'umd', 'node16', or 'nodenext'.

76     const {requireGlobalClient} = await import('./clientApi');
                                           ~~~~~~~~~~~~~~~~~~~~~

src/weaveClient.ts:443:36 - error TS1323: Dynamic imports are only supported when the '--module' flag is set to 'es2020', 'es2022', 'esnext', 'commonjs', 'amd', 'system', 'umd', 'node16', or 'nodenext'.

443       const {StringPrompt} = await import('./prompt');
                                       ~~~~~~~~~~~~~~~~~~

src/weaveClient.ts:459:38 - error TS1323: Dynamic imports are only supported when the '--module' flag is set to 'es2020', 'es2022', 'esnext', 'commonjs', 'amd', 'system', 'umd', 'node16', or 'nodenext'.

459       const {MessagesPrompt} = await import('./prompt');
                                         ~~~~~~~~~~~~~~~~~~

src/weaveClient.ts:476:31 - error TS1323: Dynamic imports are only supported when the '--module' flag is set to 'es2020', 'es2022', 'esnext', 'commonjs', 'amd', 'system', 'umd', 'node16', or 'nodenext'.

476       const {Dataset} = await import('./dataset');
                                  ~~~~~~~~~~~~~~~~~~~

✗ Failed to generate documentation: Command '['npx', 'typedoc']' returned non-zero exit status 3.

• This change configures typedoc to point to tsconfig.esm.json to prevent this failure:

[info] Documentation generated at /var/folders/4c/m8pw00dj0tbb_zld746q7ksr0000gp/T/tmpkaf7lz3a
  ✓ Documentation generated

Converting to Mintlify format...
  ✓ Converted README.md → readme.mdx
  ✓ Converted StringPrompt.md → stringprompt.mdx
  ✓ Converted EvaluationLogger.md → evaluationlogger.mdx
  ✓ Converted WeaveClient.md → weaveclient.mdx
  ✓ Converted Dataset.md → dataset.mdx
  ✓ Converted WeaveObject.md → weaveobject.mdx
  ✓ Converted MessagesPrompt.md → messagesprompt.mdx
  ✓ Converted ObjectRef.md → objectref.mdx
  ✓ Converted ScoreLogger.md → scorelogger.mdx
  ✓ Converted Evaluation.md → evaluation.mdx
  ✓ Converted WeaveAudio.md → weaveaudio.mdx
  ✓ Converted CallsFilter.md → callsfilter.mdx
  ✓ Converted WeaveImage.md → weaveimage.mdx
  ✓ Converted SortBy.md → sortby.mdx
  ✓ Converted Query.md → query.mdx
  ✓ Converted CallSchema.md → callschema.mdx
  ✓ Converted GetCallsOptions.md → getcallsoptions.mdx

Organizing documentation structure...
  ✓ Created typescript-sdk.mdx landing page from readme.mdx
  Extracting consolidated members to separate files...
    ✓ Extracted createopenaiagentstracingprocessor.mdx
    ✓ Extracted createotelextension.mdx
    ✓ Extracted init.mdx
    ✓ Extracted instrumentopenaiagents.mdx
    ✓ Extracted login.mdx
    ✓ Extracted op.mdx
    ✓ Extracted patchrealtimesession.mdx
    ✓ Extracted requirecurrentcallstackentry.mdx
    ✓ Extracted requirecurrentchildsummary.mdx
    ✓ Extracted weaveaudio.mdx
    ✓ Extracted weaveimage.mdx
    ✓ Extracted withattributes.mdx
    ✓ Extracted wrapgooglegenai.mdx
    ✓ Extracted wrapopenai.mdx
    ✓ Extracted op.mdx
    ✓ Extracted opdecorator.mdx
  ✓ Updated typescript-sdk.mdx landing page
  ✓ Documentation organized

✓ TypeScript SDK documentation generation complete!

Testing

• Local build succeeds without errors (mint dev)
• Local link check succeeds without errors (mint broken-links)
• PR tests succeed

[drtangible]

• chore(docs): prevent 'npx typedoc' failure in scripts/reference-generation/weave/generate_typescript_sdk_docs.py #2675 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
wandb	🟢 Ready	View Preview	May 27, 2026, 3:00 PM

[dbrian57]

Tested these fixes and they work.