Add AI Gateway tool calling by IzumiSy · Pull Request #363 · tailor-platform/app-shell

IzumiSy · 2026-07-03T14:50:20Z

Motivation

useAIChat() previously covered only text request/response flows even though the AI Gateway transport can receive function calls. Applications need models to call local functions and use provider-managed tools.

The API should keep provider SDK types out of ordinary AppShell applications while preserving the authenticated user's existing data permissions.

Design Decision

Keep tool ownership explicit

useAIChat() accepts local and provider tools through tools. Local tools use defineAIChatTool(...), validate arguments with the application's Standard Schema-compatible validator, execute in the browser, and return a tool result to the next model turn. Provider tools continue to be passed through to the AI Gateway.

This leaves the hook responsible for local orchestration only and keeps its public messages user/assistant text-first.

                         function definitions
+----------------+ --------------------------------> +--------------------+
| useAIChat      |                                    | AI Gateway / model |
|                | <--------------------------------- |                    |
+--------+-------+          tool calls / next turn    +--------------------+
         |
         +-- local tools -- validate -- execute ---------> tool result

Reuse application schema libraries

Local tools require runtime validation and JSON Schema generation. AppShell accepts Standard Schema and Standard JSON Schema implementations instead of introducing a schema DSL; Zod 4 supports both directly. This avoids duplicating validation and schema-generation behavior.

Summary

add local function tools and provider-backed web search to useAIChat()
preserve per-request cancellation, internal tool transcripts, and text-first public messages
add transport, orchestration, and hook tests; API documentation; and a changeset

…ponsibilities - Extract runAssistantLoop as a pure async generator (assistant-loop.ts) that yields events instead of calling session callbacks - Extract tool execution logic into tool-execution.ts - Introduce ChatRequestContext class to encapsulate per-request state (transcript staging + streaming turn buffer) - Reduce useAIChat hook to thin React orchestrator with single applyEvent dispatch point for all state transitions - Remove the 12-method AIChatSessionRequest god-interface

github-actions · 2026-09-17T05:52:02Z

Code Metrics Report

	main (bad3569)	#363 (2f0f180)	+/-
Coverage	87.5%	87.4%	-0.1%
Test Execution Time	1m25s	2m6s	+41s

Details

  |                     | main (bad3569) | #363 (2f0f180) |  +/-  |
  |---------------------|----------------|----------------|-------|
- | Coverage            |          87.5% |          87.4% | -0.1% |
  |   Files             |            206 |            209 |    +3 |
  |   Lines             |           6084 |           6218 |  +134 |
+ |   Covered           |           5325 |           5438 |  +113 |
- | Test Execution Time |          1m25s |           2m6s |  +41s |

Code coverage of files in pull request scope (88.3% → 86.4%, patch 85.8%)

Files	Coverage	+/-	Patch Coverage	Status
packages/core/package.json	100.0%	0.0%	-	modified
packages/core/src/ai/assistant-loop.ts	100.0%	+100.0%	100.0%	added
packages/core/src/ai/client.ts	79.6%	-2.3%	77.7%	modified
packages/core/src/ai/tool-execution.ts	64.8%	+64.8%	64.8%	added
packages/core/src/ai/tools.ts	100.0%	+100.0%	100.0%	added
packages/core/src/ai/use-ai-chat.ts	95.1%	+4.5%	96.6%	modified
packages/core/src/index.ts	0.0%	0.0%	-	modified

Reported by octocov

pkg-pr-new · 2026-09-18T01:24:24Z

Open in StackBlitz

pnpm add https://pkg.pr.new/@tailor-platform/app-shell@d078fc3

pnpm add https://pkg.pr.new/@tailor-platform/eslint-plugin-app-shell@d078fc3

pnpm add https://pkg.pr.new/@tailor-platform/sdk-plugin-app-shell@d078fc3

pnpm add https://pkg.pr.new/@tailor-platform/vite-plugin-app-shell@d078fc3

commit: d078fc3

This reverts commit 68d4e5b.

IzumiSy · 2026-10-01T07:10:38Z

@copilot resolve the merge conflicts in this pull request

…l-calling # Conflicts: # pnpm-lock.yaml Co-authored-by: IzumiSy <982850+IzumiSy@users.noreply.github.com>

Copilot · 2026-10-01T07:16:19Z

@copilot resolve the merge conflicts in this pull request

Merged the latest main, resolved the lockfile conflict, and cleared stale conflict residue. Merge commit: 4717309.

IzumiSy · 2026-10-02T01:54:39Z

@copilot resolve the merge conflicts in this pull request

…l-calling # Conflicts: # decisions/documentation-management-overhaul.md Co-authored-by: IzumiSy <982850+IzumiSy@users.noreply.github.com>

Copilot · 2026-10-02T01:58:38Z

@copilot resolve the merge conflicts in this pull request

Merged the latest main and resolved the documentation decision file conflict. Merge commit: 4223424.

IzumiSy · 2026-10-02T02:02:25Z

@copilot fix CI errors

Co-authored-by: IzumiSy <982850+IzumiSy@users.noreply.github.com>

Copilot · 2026-10-02T02:05:19Z

@copilot fix CI errors

Fixed the CI formatting failure in decisions/documentation-management-overhaul.md while preserving the paragraph as prose. pnpm fmt:check passes. Commit: 0100b5d.

IzumiSy · 2026-10-02T02:06:36Z

@copilot resolve the merge conflicts in this pull request

…l-calling # Conflicts: # pnpm-lock.yaml

Copilot · 2026-10-02T02:15:06Z

@copilot resolve the merge conflicts in this pull request

Merged the latest main and resolved the lockfile conflict while preserving both dependency updates. I also refreshed the authored AI Gateway docs so docs:check passes. Merge commit: 6669689.

IzumiSy · 2026-10-02T02:33:04Z

@copilot "decisions/documentation-management-overhaul.md"の差分はこのPRとは関係なさそうなので、diffから抜いてください。

Co-authored-by: IzumiSy <982850+IzumiSy@users.noreply.github.com>

Copilot · 2026-10-02T02:36:03Z

@copilot "decisions/documentation-management-overhaul.md"の差分はこのPRとは関係なさそうなので、diffから抜いてください。

Restored decisions/documentation-management-overhaul.md to match current main; it no longer appears in the PR diff. Commit: d078fc3.

IzumiSy requested a review from a team as a code owner July 3, 2026 14:50

IzumiSy marked this pull request as draft July 6, 2026 05:42

Base automatically changed from izumis/ai-gateway-openai-sdk to main July 8, 2026 05:31

IzumiSy force-pushed the izumis/ai-gateway-tool-calling branch from 29987b9 to 4f114b9 Compare July 8, 2026 06:07

IzumiSy added 6 commits September 17, 2026 14:46

Add AI Gateway tool calling support

3a746a6

Document AI tool calling internals and APIs

d05386b

Document AI tool schema helpers

ce7b518

docs: enrich ai-gateway-tools changeset with examples and API reference

126a550

Format files

e03b3e1

IzumiSy force-pushed the izumis/ai-gateway-tool-calling branch from e38d1d2 to e03b3e1 Compare September 17, 2026 05:50

IzumiSy and others added 4 commits September 17, 2026 14:56

Merge branch 'main' into izumis/ai-gateway-tool-calling

a6eebb0

refactor(ai): remove built-in tool schema helpers

6b21958

Merge branch 'main' into izumis/ai-gateway-tool-calling

c74fd8b

feat(ai): add browser MCP tool adapters

68d4e5b

IzumiSy changed the title ~~Add AI Gateway tool calling support~~ Add AI Gateway tools and browser MCP support Sep 18, 2026

IzumiSy self-assigned this Sep 18, 2026

IzumiSy added the preview A trigger label to create preview build by pkg-pr-new label Sep 18, 2026

IzumiSy and others added 2 commits September 25, 2026 10:18

Merge branch 'main' into izumis/ai-gateway-tool-calling

cb3293f

Revert "feat(ai): add browser MCP tool adapters"

d85febb

This reverts commit 68d4e5b.

IzumiSy changed the title ~~Add AI Gateway tools and browser MCP support~~ Add AI Gateway tool calling Sep 25, 2026

Copilot started work on behalf of IzumiSy October 1, 2026 07:11 View session

Merge remote-tracking branch 'origin/main' into izumis/ai-gateway-too…

4717309

…l-calling # Conflicts: # pnpm-lock.yaml Co-authored-by: IzumiSy <982850+IzumiSy@users.noreply.github.com>

Copilot finished work on behalf of IzumiSy October 1, 2026 07:16

Copilot started work on behalf of IzumiSy October 2, 2026 01:55 View session

Merge remote-tracking branch 'origin/main' into izumis/ai-gateway-too…

4223424

…l-calling # Conflicts: # decisions/documentation-management-overhaul.md Co-authored-by: IzumiSy <982850+IzumiSy@users.noreply.github.com>

Copilot finished work on behalf of IzumiSy October 2, 2026 01:59

Merge branch 'main' into izumis/ai-gateway-tool-calling

bb7b432

Copilot started work on behalf of IzumiSy October 2, 2026 02:03 View session

Fix documentation formatting check

0100b5d

Co-authored-by: IzumiSy <982850+IzumiSy@users.noreply.github.com>

Copilot finished work on behalf of IzumiSy October 2, 2026 02:05

Copilot started work on behalf of IzumiSy October 2, 2026 02:07 View session

Merge remote-tracking branch 'origin/main' into izumis/ai-gateway-too…

6669689

…l-calling # Conflicts: # pnpm-lock.yaml

Copilot finished work on behalf of IzumiSy October 2, 2026 02:16

IzumiSy added 2 commits October 2, 2026 11:20

Merge branch 'main' into izumis/ai-gateway-tool-calling

49402ca

Merge branch 'main' into izumis/ai-gateway-tool-calling

979ee3d

IzumiSy marked this pull request as ready for review October 2, 2026 02:29

Copilot started work on behalf of IzumiSy October 2, 2026 02:33 View session

Remove unrelated decision file from PR diff

d078fc3

Co-authored-by: IzumiSy <982850+IzumiSy@users.noreply.github.com>

Copilot finished work on behalf of IzumiSy October 2, 2026 02:36

Navigation Menu

Add AI Gateway tool calling - #363

Add AI Gateway tool calling#363
IzumiSy wants to merge 20 commits into
mainfrom
izumis/ai-gateway-tool-calling

IzumiSy commented Jul 3, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Sep 17, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Sep 18, 2026 •

edited

Loading

Uh oh!

IzumiSy commented Oct 1, 2026

Uh oh!

Copilot AI commented Oct 1, 2026

Uh oh!

IzumiSy commented Oct 2, 2026

Uh oh!

Copilot AI commented Oct 2, 2026

Uh oh!

IzumiSy commented Oct 2, 2026

Uh oh!

Copilot AI commented Oct 2, 2026

Uh oh!

IzumiSy commented Oct 2, 2026

Uh oh!

Copilot AI commented Oct 2, 2026

Uh oh!

IzumiSy commented Oct 2, 2026

Uh oh!

Copilot AI commented Oct 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

IzumiSy commented Jul 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Motivation

Design Decision

Keep tool ownership explicit

Reuse application schema libraries

Summary

Uh oh!

github-actions Bot commented Sep 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Code Metrics Report

Code coverage of files in pull request scope (88.3% → 86.4%, patch 85.8%)

Uh oh!

pkg-pr-new Bot commented Sep 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

IzumiSy commented Oct 1, 2026

Uh oh!

Copilot AI commented Oct 1, 2026

Uh oh!

IzumiSy commented Oct 2, 2026

Uh oh!

Copilot AI commented Oct 2, 2026

Uh oh!

IzumiSy commented Oct 2, 2026

Uh oh!

Copilot AI commented Oct 2, 2026

Uh oh!

IzumiSy commented Oct 2, 2026

Uh oh!

Copilot AI commented Oct 2, 2026

Uh oh!

IzumiSy commented Oct 2, 2026

Uh oh!

Copilot AI commented Oct 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

IzumiSy commented Jul 3, 2026 •

edited

Loading

github-actions Bot commented Sep 17, 2026 •

edited

Loading

pkg-pr-new Bot commented Sep 18, 2026 •

edited

Loading