feat(a365): add typed ExecuteTool schemas

[Nikhil Navakiran (nikhilNava)]

Summary

• add typed, extensible ExecuteTool argument and result schema models
• preserve existing generic payload behavior while adding safe typed serialization
• add focused public type checking and comprehensive schema/scope tests

Validation

• npm run typecheck:test
• npm run build
• npm run docs (existing warnings only)
• npm run format
• npm run lint (warnings only)
• npm run test:unit
• npm run test:functional
• npm run test:esm-build

Parity with microsoft/opentelemetry-distro-dotnet#149. ETW logger changes are out of scope.

[Copilot]

Copilot review overview

🟢 Approval recommended

The implementation and tests are coherent; only a minor duplicated documentation line remains.

Review effort: Balanced
Findings: 1

Open (1)

• Remove duplicated continuation line · New

What changed in this PR

Adds typed, extensible ExecuteTool argument/result schemas while preserving generic payload serialization.

Changes:

• Adds public schema models, enums, and exports.
• Integrates safe serialization into ExecuteToolScope.
• Adds type-checking, unit coverage, CI validation, and documentation.

File	Description
src/​a365/​tool-call-models.ts	Defines typed ExecuteTool schemas.
src/​a365/​contracts.ts	Extends tool-call contracts and exports.
src/​a365/​message-utils.ts	Adds typed payload serialization.
src/​a365/​scopes/​ExecuteToolScope.ts	Records typed arguments and results.
src/​a365/​index.ts	Exposes A365 schema APIs.
src/​index.ts	Exposes schemas from the package root.
test/​internal/​unit/​a365/​executeToolJsonModels.test.ts	Tests models and public exports.
test/​internal/​unit/​a365/​messageUtils.test.ts	Tests serialization and fallbacks.
test/​internal/​unit/​a365/​scopes.test.ts	Tests span attribute integration.
tsconfig.type-tests.json	Configures focused type checking.
package.json	Adds the type-check script.
.github/​workflows/​pr-validation.yml	Runs type checking in CI.
A365_DOCUMENTATION.md	Documents typed ExecuteTool usage.
CHANGELOG.md	Records the feature.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Copilot review overview

🟡 Changes recommended

Extension data uses a wire format inconsistent with the stated .NET parity, and the documentation contains a duplicated line.

Review effort: Balanced
Findings: 1

Open (1)

• Align extension-data serialization with the .NET wire schema · New

Resolved since last review (1)

• Remove duplicated continuation line