feat: add tools with instructions and examples to completion and agent config types

[ld-paul]

Requirements

• I have added test coverage for new or changed functionality
• I have followed the repository's pull request submission guidelines
• I have validated my changes against all supported platform versions

Related issues

Part of a coordinated multi-repo change to add instructions and examples fields to AI Tools:

• Gonfalon (backend + frontend): https://github.com/launchdarkly/gonfalon/pull/59653
• Python Server SDK AI: feat: add tools with instructions and examples to completion and agent configs python-server-sdk-ai#106

Describe the solution you've provided

Adds a new LDTool interface and wires tools through both completion and agent configuration types so the SDK can surface tool metadata (including the new instructions and examples fields) returned by the LaunchDarkly API.

Changes:

• types.ts: New LDTool interface with key, version, instructions?, examples?, customParameters?. Added optional tools array to LDAIAgentConfigDefault, LDAIAgentConfig, LDAICompletionConfigDefault, and LDAICompletionConfig.
• LDAIConfigUtils.ts: Added tools to the internal LDAIConfigFlagValue interface, toFlagValue() conversion (default → flag value), toCompletionConfig(), and toAgentConfig() conversions (flag value → config).
• LDAIClientImpl.test.ts: 6 new tests covering tools on both completion configs (3 tests) and agent configs (3 tests): tools from variation, tools from defaults, and undefined tools scenarios.

Updates since last revision

• Tools are now available on both completion and agent configs (previously agent-only)
• Added 6 new test cases in LDAIClientImpl.test.ts — all 103 tests pass
• toCompletionConfig() now includes tools: flagValue.tools

⚠️ Items for reviewer

1. Verify LDTool shape matches backend contract — key, version, instructions?, examples?, customParameters?. Confirm this aligns with the Gonfalon API response.
2. No runtime validation of tool data — Tool arrays from flag values are passed through without runtime validation, consistent with how other fields (messages, model, etc.) are handled in this SDK.
3. Public API surface — LDTool is exported via export * from types.ts through index.ts. Confirm this is the desired public API shape.

Describe alternatives you've considered

• Could add tools at the base LDAIConfig level instead of on completion and agent configs separately, but judge configs do not use tools.
• Could add runtime type validation for the tools array, but that would be inconsistent with the existing pattern for other fields.

Additional context

• Link to Devin session
• Requested by: @ld-paul

---

Note

Medium Risk
Additive but public API/type changes and config serialization/deserialization updates could impact consumers or compatibility with backend flag payloads if the LDTool shape diverges.

Overview
AI configs can now surface tool metadata (including optional instructions, examples, and customParameters) on both completion and agent configurations.

This adds a new exported LDTool type and threads an optional tools array through the default/config interfaces and the LDAIConfigUtils flag-value conversions (toFlagValue, toCompletionConfig, toAgentConfig). Test coverage is expanded with new cases verifying tools are preserved from flag variations and defaults, and omitted when not provided.

^{Written by Cursor Bugbot for commit 1baf4a0. This will update automatically on new commits. Configure here.}

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[github-actions]

@launchdarkly/js-sdk-common size report
This is the brotli compressed size of the ESM build.
Compressed size: 25566 bytes
Compressed size limit: 26000
Uncompressed size: 125383 bytes

[github-actions]

@launchdarkly/browser size report
This is the brotli compressed size of the ESM build.
Compressed size: 172466 bytes
Compressed size limit: 200000
Uncompressed size: 802026 bytes

[github-actions]

@launchdarkly/js-client-sdk size report
This is the brotli compressed size of the ESM build.
Compressed size: 24534 bytes
Compressed size limit: 25000
Uncompressed size: 84907 bytes

[github-actions]

@launchdarkly/js-client-sdk-common size report
This is the brotli compressed size of the ESM build.
Compressed size: 22062 bytes
Compressed size limit: 24000
Uncompressed size: 114438 bytes

[devin-ai-integration]

Note: This PR needs the devin-pr label added.