feat(kit): support runtime tool providers

[gene9831]

PR 描述

为 message 工具调用增加 runtime tool provider 能力，让插件可以在请求前动态提供工具 schema，并可选绑定本地 handler 直接处理对应 tool call。

主要改动：

• toolPlugin 支持 RuntimeTool，通过 function.name 路由到对应 handler。
• 支持其他插件通过 provideTools(context) 暴露工具，由 toolPlugin 统一收集。
• 为 tool call context 增加 toolSource，标记工具来自 toolPlugin、外部 provider 或未知来源。
• 请求体支持合并已有 tools，并检测重复工具名。
• 增加 toolPlugin 关键流程测试。
• 更新 Vue message mock/tool plugin 适配和 message 文档。

验证：

pnpm -F @opentiny/tiny-robot-kit test -- --run src/message/test/toolPlugin.test.ts
pnpm build

Summary by CodeRabbit

Summary by CodeRabbit

Release Notes

• Documentation
  • Updated toolPlugin documentation with tool aggregation, tool source tracking, and updated callback/context guidance.
• New Features
  • Added support for runtime tools with custom handlers.
  • Added tool source labeling and propagation through tool discovery and tool-call lifecycle.
  • Added dynamic tool injection via tool providers.
• Improvements
  • Plugin hooks now receive access to the active plugin list.
  • Tool arrays are merged into existing request tools.
  • Unified streaming/asynchronous result typing for response providers and tool calls.
• Tests
  • Added end-to-end coverage for runtime tool execution, conflicts, and fallback behavior.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: e5a4991e-bc9f-48dd-ab7f-ccb176763951

📥 Commits

Reviewing files that changed from the base of the PR and between c5b3db3 and 10dfcb8.

📒 Files selected for processing (7)

• docs/src/tools/message.md
• packages/kit/src/message/plugins/toolPlugin.ts
• packages/kit/src/message/types.ts
• packages/kit/src/message/utils.ts
• packages/kit/src/types.ts
• packages/kit/src/vue/message/plugins/toolPlugin.ts
• packages/kit/src/vue/message/types.ts

🚧 Files skipped from review as they are similar to previous changes (2)

• packages/kit/src/message/utils.ts
• packages/kit/src/vue/message/plugins/toolPlugin.ts

---

Walkthrough

toolPlugin gains runtime tool support: new ToolSource, RuntimeTool, ToolProvider, and ToolProviderItem types enable plugins to expose executable tools via provideTools. A new resolveTools routine aggregates and deduplicates tools from all plugins, builds dispatch maps, and wires toolSource into every tool-call context. The Vue wrapper, tests, and docs are updated accordingly.

Changes

Runtime Tool Provisioning and toolSource Tracking

Layer / File(s)	Summary
Async/streaming result type abstraction packages/kit/src/types.ts, packages/kit/src/message/types.ts, packages/kit/src/message/utils.ts, packages/kit/src/vue/message/types.ts	Introduces AsyncStreamableResult<T> (union of Promise, AsyncGenerator, and Promise of AsyncGenerator) and redefines MaybeStreamableResult<T> to include direct values T. Updates ResponseProvider return types in core and Vue to use the unified abstraction; updates normalizeToAsyncGenerator to accept the broader result type.
Tool type contracts and BasePluginContext.plugins packages/kit/src/message/plugins/toolPlugin.ts, packages/kit/src/message/types.ts, packages/kit/src/message/core/engine.ts, packages/kit/src/message/plugins/index.ts	Introduces ToolSource, ToolCallContext (extended with toolSource), RuntimeTool (with executable handler), ToolProviderItem, and ToolProvider types. Extends MessageRequestBody with optional tools field and BasePluginContext with plugins: readonly MessageEnginePlugin[]. Updates OpenAI import paths and re-exports new types via plugins index.
resolveTools routine and per-call dispatch packages/kit/src/message/plugins/toolPlugin.ts	Updates getTools to accept BasePluginContext and return ToolProviderItem[]; updates callTool return type to MaybeStreamableResult<string | Record<string, any>>. Implements resolveTools to aggregate tools from plugins via provideTools(context) and own getTools(context), enforce tool-name uniqueness, and build runtimeToolMap/toolSourceMap. Updates onBeforeRequest to merge with existing requestBody.tools; onAfterRequest to re-resolve; and per-call execution to route to runtime handler or callTool fallback based on toolSourceMap.
Vue wrapper: toolSource threading and getTools context packages/kit/src/vue/message/plugins/toolPlugin.ts	Extends UseMessageToolActionContext with optional toolSource and UseMessageToolCallContext with required toolSource. Updates getTools option to accept BasePluginContext and return MaybePromise<ToolProviderItem[]>. Forwards Vue base context to getTools and passes toolSource: context.toolSource into callTool, onToolCallStart, and onToolCallEnd handlers.
toolPlugin test suite packages/kit/src/message/test/toolPlugin.test.ts	Adds Vitest suite with four scenarios: runtime tool execution suppresses fallback callTool; duplicate tool-name detection within provided definitions; conflicts with requestBody.tools; and cross-plugin tool loading with correct toolSource metadata.
Documentation and import path updates docs/src/tools/message.md, packages/kit/src/message/test/mockResponseProvider.ts, packages/kit/src/vue/message/mockResponseProvider.ts	Updates toolPlugin docs with ToolProvider protocol, toolSource descriptions, callback context tables, and updated example signature. Fixes ChatCompletionChunk import paths to openai/resources.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~50 minutes

Poem

🐇 A rabbit hops into the plugin bazaar,
Each tool now knows from whence and where it are—
toolSource stamped on every call's context,
Runtime handlers leap before the rest.
provideTools, resolveTools, maps all aligned,
No duplicate names shall tangle your mind!
✨ The warren of tools is tidy and kind.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title directly and accurately describes the main change: introducing runtime tool provider support to the kit module.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/src/tools/message.md`:
- Around line 256-257: Update the type signatures in the options table for both
getTools and callTool methods to match the actual plugin contract. For getTools,
add the BasePluginContext parameter to the function signature and change the
return type from Promise<Array<Tool | RuntimeTool>> to
MaybePromise<ToolProviderItem[]> to correctly indicate that it can return either
a synchronous or asynchronous result. For callTool, update the return type to
reflect that it can return either a synchronous value (string | Record<string,
any>) or an async/streaming value, rather than only showing the async variant.
These changes will ensure the documentation accurately represents what the
actual plugin implementation expects and returns.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 4530f256-4fdc-43db-821b-fbe8351c3f94

📥 Commits

Reviewing files that changed from the base of the PR and between 045d26b and c5b3db3.

📒 Files selected for processing (10)

• docs/src/tools/message.md
• packages/kit/src/message/core/engine.ts
• packages/kit/src/message/plugins/index.ts
• packages/kit/src/message/plugins/toolPlugin.ts
• packages/kit/src/message/test/mockResponseProvider.ts
• packages/kit/src/message/test/toolPlugin.test.ts
• packages/kit/src/message/types.ts
• packages/kit/src/message/utils.ts
• packages/kit/src/vue/message/mockResponseProvider.ts
• packages/kit/src/vue/message/plugins/toolPlugin.ts

[github-actions]

✅ Preview build completed successfully!

Click the image above to preview.
Preview will be automatically removed when this PR is closed.

[github-actions]

📦 Package Preview

pnpm add https://pkg.pr.new/@opentiny/tiny-robot@10dfcb8

pnpm add https://pkg.pr.new/@opentiny/tiny-robot-kit@10dfcb8

pnpm add https://pkg.pr.new/@opentiny/tiny-robot-svgs@10dfcb8

commit: 10dfcb8