@5ss/ai-tools 2.11.1

package/CHANGELOG.md

@@ -0,0 +1,112 @@
+# Changelog
+
+All notable changes to `@5ss/ai-tools` are documented here.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Releases are cut by [semantic-release](https://semantic-release.gitbook.io/) from [conventional commits](https://www.conventionalcommits.org/).
+
+## [2.11.1](https://github.com/harryy2510/ai-tools/compare/v2.11.0...v2.11.1) (2026-08-07)
+
+## [2.11.0](https://github.com/harryy2510/ai-tools/compare/v2.10.2...v2.11.0) (2026-08-07)
+
+## [2.10.2](https://github.com/harryy2510/ai-tools/compare/v2.10.1...v2.10.2) (2026-08-07)
+
+## [2.10.1](https://github.com/harryy2510/ai-tools/compare/v2.10.0...v2.10.1) (2026-08-05)
+
+## [2.10.0](https://github.com/harryy2510/ai-tools/compare/v2.9.0...v2.10.0) (2026-08-03)
+
+## [2.9.0](https://github.com/harryy2510/ai-tools/compare/v2.8.0...v2.9.0) (2026-08-02)
+
+## [2.8.0](https://github.com/harryy2510/ai-tools/compare/v2.7.1...v2.8.0) (2026-07-29)
+
+## [2.7.1](https://github.com/harryy2510/ai-tools/compare/v2.7.0...v2.7.1) (2026-07-29)
+
+## [2.7.0](https://github.com/harryy2510/ai-tools/compare/v2.6.0...v2.7.0) (2026-07-29)
+
+## [2.6.0](https://github.com/harryy2510/ai-tools/compare/v2.5.1...v2.6.0) (2026-07-29)
+
+## [2.5.1](https://github.com/harryy2510/ai-tools/compare/v2.5.0...v2.5.1) (2026-07-28)
+
+## [2.5.0](https://github.com/harryy2510/ai-tools/compare/v2.4.0...v2.5.0) (2026-07-28)
+
+## [2.4.0](https://github.com/harryy2510/ai-tools/compare/v2.3.0...v2.4.0) (2026-07-28)
+
+## [2.3.0](https://github.com/harryy2510/ai-tools/compare/v2.2.0...v2.3.0) (2026-07-28)
+
+## [2.2.0](https://github.com/harryy2510/ai-tools/compare/v2.1.0...v2.2.0) (2026-07-28)
+
+## [2.1.0](https://github.com/harryy2510/ai-tools/compare/v2.0.1...v2.1.0) (2026-07-28)
+
+## [2.0.1](https://github.com/harryy2510/ai-tools/compare/v2.0.0...v2.0.1) (2026-07-27)
+
+## [2.0.0](https://github.com/harryy2510/ai-tools/compare/v1.6.1...v2.0.0) (2026-07-27)
+
+## [1.6.1](https://github.com/harryy2510/ai-tools/compare/v1.6.0...v1.6.1) (2026-07-24)
+
+## [1.6.0](https://github.com/harryy2510/ai-tools/compare/v1.5.0...v1.6.0) (2026-07-24)
+
+## [1.5.0](https://github.com/harryy2510/ai-tools/compare/v1.4.0...v1.5.0) (2026-07-24)
+
+## [1.4.0](https://github.com/harryy2510/ai-tools/compare/v1.3.0...v1.4.0) (2026-07-23)
+
+## [1.3.0](https://github.com/harryy2510/ai-tools/compare/v1.2.1...v1.3.0) (2026-07-23)
+
+## [1.2.1](https://github.com/harryy2510/ai-tools/compare/v1.2.0...v1.2.1) (2026-07-23)
+
+## [1.2.0](https://github.com/harryy2510/ai-tools/compare/v1.1.0...v1.2.0) (2026-07-23)
+
+## [1.1.0](https://github.com/harryy2510/ai-tools/compare/v1.0.0...v1.1.0) (2026-07-21)
+
+## 1.0.0 (2026-07-21)
+
+# Changelog
+
+All notable changes to `@5ss/ai-tools` are documented here.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+Releases are cut by semantic-release from conventional commits. See [docs/versioning.md](./docs/versioning.md).
+
+## [Unreleased]
+
+Notes for the next cut (hand-maintained until semantic-release rewrites on release). Empty `## [1.x.x]` sections above are produced by release automation.
+
+### BREAKING CHANGE
+
+Public surfaces removed or renamed since **v1.6.1** — next release **must** be a **major** (use `BREAKING CHANGE` footer / `type!:` on the release commit).
+
+| Removed / changed | Migration |
+| --- | --- |
+| `@5ss/ai-tools/mime` | Use `@5ss/ai-tools/email-message` (parse/build) and/or `content-type` |
+| `@5ss/ai-tools/storage` | Use `@5ss/ai-tools/s3` (or nested S3 auth on `files` / messaging media) |
+| `@5ss/ai-tools/r2` | Use `s3` with R2 S3-compatible `endpoint` |
+| `@5ss/ai-tools/supabase-storage` | Use S3-compatible storage or host Supabase client |
+| `messaging-unsend` tool / seam `unsend` | Use `@5ss/ai-tools/imessage` `imessage-unsend` (or channel vendor) |
+| email-message attachment `mimeType` | Renamed to **`mime_type`** |
+| messaging media `source.store: 'host'` | Not accepted; use `store: 'object'` + nested `storage` auth |
+| `messaging-download-file` output | When `destination_key` is set, response may include **`artifact`** and omit `body_base64` — handle both shapes |
+| Messaging host client media | Prefer `MessagingClient.fromContext` / nested `storage` auth for ArtifactRef media; resolve storage before send |
+| Invalid base64 on media/bodies | Always `ToolError` code **`bad_input`** (never raw `DOMException`) |
+| Hooks + output validation | `runTool` owns bind → hooks → execute → output validation; output schema is parsed **once** |
+| `mergeToolContext` / adapter `createContext` | Explicit `undefined` fields **do not** erase base `signal` / `fetch` / `auth` / `now` |
+| MCP `context` | Still accepts static `ToolContext` **or** factory `() => ToolContext \| Promise<…>` (and deprecated `contextFactory`) |
+
+### Notes (compat preserved)
+
+- Adapter `createContext` callbacks use the installed framework execution-context types.
+- S3 `get` / `getBytes({ maxBytes })` use HEAD + conditional Range GET (`If-Match` when etag is known) plus bounded response streaming.
+
+### Historical note
+
+Early public notes under **0.0.1** below are archival. MIME parse/build is **`email-message`** (not a `mime` pack). Object store is **`s3`** (+ nested S3 on `files` / artifact media); there is no multi-provider `storage` seam or published `r2` / `supabase-storage` packs.
+
+## [0.0.1] - 2026-07-21
+
+Initial public package surface (archival).
+
+### Added
+
+- **Kernel (`@5ss/ai-tools/core`)** — `defineTool`, `defineModule`, `withAuth`, `runTool`, contracts, catalog, JSON Schema projection, stable `ToolError` codes.
+- **HTTP** surface and framework adapters (Mastra, AI SDK, TanStack, Cloudflare, MCP).
+- Early product modules and tooling (see git history for full evolution).
+
+[Unreleased]: https://github.com/harryy2510/ai-tools/compare/v1.6.1...HEAD
+[0.0.1]: https://github.com/harryy2510/ai-tools/releases/tag/v0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 harryy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,221 @@
+# @5ss/ai-tools
+
+Reusable **AI tools** with strict Zod schemas and model-facing contracts. Define once in the kernel; project to **Mastra**, **Vercel AI SDK**, **TanStack AI**, **Cloudflare Workers AI**, **MCP**, or call via class clients / `runTool`.
+
+[![ci](https://github.com/harryy2510/ai-tools/actions/workflows/ci.yml/badge.svg)](https://github.com/harryy2510/ai-tools/actions/workflows/ci.yml)
+[![release](https://github.com/harryy2510/ai-tools/actions/workflows/release.yml/badge.svg)](https://github.com/harryy2510/ai-tools/actions/workflows/release.yml)
+
+**Docs:** [docs/README.md](./docs/README.md) · **Changelog:** [CHANGELOG.md](./CHANGELOG.md) · **Release:** [docs/versioning.md](./docs/versioning.md)
+
+## Why
+
+- **One authoring path** — `defineTool` / `defineModule` only; adapters never re-implement business logic.
+- **Host-owned secrets** — auth schemas + `withAuth`; model inputs never carry API keys.
+- **Two product roots** — `modules/` (our seams) vs `vendors/` (3rd-party packs); flat public imports.
+- **Class clients + tools** — host uses `new ResendClient(auth)`; agents use the same implementation via tools.
+- **Subpath imports** — tree-shake friendly; no root mega-barrel.
+- **Honest runtimes** — `node` | `edge` | `both`.
+- **Stable tool ids** — kebab-case, vendor- or capability-prefixed.
+
+## Install
+
+```bash
+bun add @5ss/ai-tools
+
+# optional peers for adapters you use:
+bun add @mastra/core
+bun add ai
+bun add @tanstack/ai
+bun add @modelcontextprotocol/sdk   # registerMcpTools only
+```
+
+Requires **Bun ≥ 1.3.14** or **Node ≥ 24**.
+
+## Quick start
+
+```ts
+import { withAuth } from '@5ss/ai-tools/core'
+import { resendModule, ResendClient } from '@5ss/ai-tools/resend'
+import { createMastraTools } from '@5ss/ai-tools/mastra'
+
+// Host DX (class client)
+const resend = new ResendClient({ api_key: process.env.RESEND_API_KEY! })
+await resend.send({ to: 'a@example.com', from: 'b@example.com', subject: 'Hi', text: 'Hello' })
+
+// Agent tools (same implementation)
+const bound = withAuth(resendModule, { api_key: process.env.RESEND_API_KEY! })
+export const tools = createMastraTools(bound)
+```
+
+Multi-provider **seam** (host picks provider on auth):
+
+```ts
+import { withAuth } from '@5ss/ai-tools/core'
+import { emailModule } from '@5ss/ai-tools/email'
+
+const bound = withAuth(emailModule, {
+  provider: 'resend',
+  api_key: process.env.RESEND_API_KEY!,
+  sender: { email: 'verified@example.com', name: 'Product' },
+})
+```
+
+No-auth pure helpers:
+
+```ts
+import { emailMessageModule } from '@5ss/ai-tools/email-message'
+import { createAiSdkTools } from '@5ss/ai-tools/ai-sdk'
+
+export const tools = createAiSdkTools(emailMessageModule)
+```
+
+## Architecture
+
+```text
+src/
+  core/          kernel (defineTool, withAuth, runTool, …)
+  transport/     HttpService / AwsService  →  @5ss/ai-tools/http
+  adapters/      mastra · ai-sdk · tanstack · cloudflare · mcp
+  modules/       our seams (email, messaging, files, …)
+  vendors/       3rd-party packs (resend, telegram, s3, …)
+                 + vertical kits: _email · _storage · _messaging · _vector (not published)
+  shared/        bytes, batch, artifact, content-type, pagination
+```
+
+| Root | Role |
+| --- | --- |
+| **`modules/`** | Capability seams we own; usually multi-provider, with explicit product-locked host or single-provider seams |
+| **`vendors/`** | Full first-party API of one product; grow tools over time |
+| **`vendors/_…`** | Vertical kits (codegen-skipped); shared by packs in that category |
+
+Public imports are **flat**: `@5ss/ai-tools/resend`, not `@5ss/ai-tools/vendors/resend`.
+
+```text
+defineTool / defineModule
+        │
+        ├─► Host:   Class client  (new ResendClient(auth).send(…))
+        ├─► Agent:  withAuth(module) → tools → adapters
+        └─► Direct: runTool(tool, input, ctx)
+```
+
+## Subpaths
+
+### Brain
+
+| Import | Role | Docs |
+| --- | --- | --- |
+| `@5ss/ai-tools/core` | Kernel, contracts, `withAuth`, `runTool` | [core](./docs/packages/core.md) |
+| `@5ss/ai-tools/http` | `HttpService` / `AwsService` | [http transport](./docs/reference/http-and-aws-services.md) |
+| `@5ss/ai-tools/mastra` | Mastra projector | [mastra](./docs/packages/mastra.md) |
+| `@5ss/ai-tools/ai-sdk` | Vercel AI SDK projector | [ai-sdk](./docs/packages/ai-sdk.md) |
+| `@5ss/ai-tools/tanstack` | TanStack AI projector | [tanstack](./docs/packages/tanstack.md) |
+| `@5ss/ai-tools/cloudflare` | Workers AI tool defs | [cloudflare](./docs/packages/cloudflare.md) |
+| `@5ss/ai-tools/mcp` | MCP list/call + register | [mcp](./docs/packages/mcp.md) |
+
+### Seams (`modules/`)
+
+| Import | Kind | Tools (ids) | Docs |
+| --- | --- | --- | --- |
+| `@5ss/ai-tools/email` | multi-provider | `email-send`, `email-send-batch` | [email](./docs/modules/email.md) |
+| `@5ss/ai-tools/messaging` | multi-provider | `messaging-send-text`, edit, media, reactions, … (telegram/slack/teams/imessage) | [messaging](./docs/modules/messaging.md) |
+| `@5ss/ai-tools/files` | path root over nested S3 | `files-*` | [files](./docs/modules/files.md) |
+| `@5ss/ai-tools/artifacts` | object + host providers | `artifacts-create`, `-read-range`, `-read-lines` | [artifacts](./docs/modules/artifacts.md) |
+| `@5ss/ai-tools/vector-store` | qdrant, pinecone, supabase, mastra | `vector-store-*` | [vector-store](./docs/modules/vector-store.md) |
+| `@5ss/ai-tools/rag` | embed + nested vector-store | `rag-*` | [rag](./docs/modules/rag.md) |
+| `@5ss/ai-tools/document-extract` | multi-provider | `document-extract-text`, `-status`, `-text-batch` | [document-extract](./docs/modules/document-extract.md) |
+| `@5ss/ai-tools/document-render` | multi-provider | `document-render-pdf`, `-screenshot`, batches | [document-render](./docs/modules/document-render.md) |
+| `@5ss/ai-tools/file-convert` | gotenberg LO | `file-convert` (`office-to-pdf`), batch | [file-convert](./docs/modules/file-convert.md) |
+| `@5ss/ai-tools/document` | core reader/builder/editor | read text/PDF/DOCX/XLSX/images; build text/DOCX/XLSX; edit text/DOCX/XLSX/CSV | [document](./docs/modules/document.md) |
+| `@5ss/ai-tools/presentation` | PPTX reader/builder/editor | read, build, and edit PPTX presentations; Node ESM only | [presentation](./docs/modules/presentation.md) |
+| `@5ss/ai-tools/web-fetch` | host policy | `web-fetch-get`, `web-fetch-request` | [web-fetch](./docs/modules/web-fetch.md) |
+| `@5ss/ai-tools/email-message` | pure (no auth) | `email-message-parse`, `email-message-build` | [email-message](./docs/modules/email-message.md) |
+| `@5ss/ai-tools/content-type` | pure (no auth) | `content-type-get`, `-extension`, `-extensions` | [content-type](./docs/modules/content-type.md) |
+| `@5ss/ai-tools/skills` | host-bound catalog | `skills-list`, `skills-get`, `skills-search` | [skills](./docs/modules/skills.md) |
+| `@5ss/ai-tools/tasks` | host-backed definitions | `tasks-create`, `-get`, `-list`, `-update`, `-delete` | [tasks](./docs/modules/tasks.md) |
+| `@5ss/ai-tools/scheduler` | eventbridge provider | `scheduler-create`, `-update`, `-get`, `-list`, `-delete` | [scheduler](./docs/modules/scheduler.md) |
+| `@5ss/ai-tools/pdf` | artifact utilities | inspect, merge, extract, split, rotate | [pdf](./docs/modules/pdf.md) |
+| `@5ss/ai-tools/image` | artifact transforms | metadata, resize, crop, thumbnail, convert | [image](./docs/modules/image.md) |
+| `@5ss/ai-tools/crypto` | Web Crypto | hash, HMAC sign/verify, random bytes | [crypto](./docs/modules/crypto.md) |
+| `@5ss/ai-tools/calendar` | pure iCalendar | build and parse ICS | [calendar](./docs/modules/calendar.md) |
+| `@5ss/ai-tools/queue` | sqs provider | enqueue, receive, acknowledge, extend visibility | [queue](./docs/modules/queue.md) |
+| `@5ss/ai-tools/browser` | AgentCore + Cloudflare providers | start, get, stop | [browser](./docs/modules/browser.md) |
+
+### Vendors (`vendors/`)
+
+| Import | Tools (ids) | Docs |
+| --- | --- | --- |
+| `@5ss/ai-tools/resend` | `resend-send`, `resend-send-batch` | [resend](./docs/vendors/resend.md) |
+| `@5ss/ai-tools/cloudflare-email` | `cloudflare-email-send`, `-send-batch` | [cloudflare-email](./docs/vendors/cloudflare-email.md) |
+| `@5ss/ai-tools/telegram` | `telegram-send-text`, `-edit-text`, media, reactions, … | [telegram](./docs/vendors/telegram.md) |
+| `@5ss/ai-tools/slack` | `slack-send-text`, edit, media, reactions, files, … | [slack](./docs/vendors/slack.md) |
+| `@5ss/ai-tools/teams` | `teams-send-text`, edit, media, Bot Framework activities | [teams](./docs/vendors/teams.md) |
+| `@5ss/ai-tools/imessage` | send/edit/react/unsend/read via Photon Advanced iMessage HTTP | [imessage](./docs/vendors/imessage.md) |
+| `@5ss/ai-tools/s3` | `s3-*` (+ signed URL, multipart) | [s3](./docs/vendors/s3.md) |
+| `@5ss/ai-tools/sqs` | `sqs-send`, `-receive`, `-delete`, `-change-visibility` | [sqs](./docs/vendors/sqs.md) |
+| `@5ss/ai-tools/qdrant` | `qdrant-upsert`, `-query`, `-delete` | [qdrant](./docs/vendors/qdrant.md) |
+| `@5ss/ai-tools/pinecone` | `pinecone-upsert`, `-query`, `-delete` | [pinecone](./docs/vendors/pinecone.md) |
+| `@5ss/ai-tools/supabase-vector` | `supabase-vector-*` (pgvector/PostgREST) | [supabase-vector](./docs/vendors/supabase-vector.md) |
+| `@5ss/ai-tools/mastra-vector` | `mastra-vector-*` (PgVector, node) | [mastra-vector](./docs/vendors/mastra-vector.md) |
+| `@5ss/ai-tools/textract` | `textract-extract-text`, `-get-status`, `-extract-text-batch` | [textract](./docs/vendors/textract.md) |
+| `@5ss/ai-tools/eventbridge-scheduler` | create/update/get/list/delete (task_ref) | [eventbridge-scheduler](./docs/vendors/eventbridge-scheduler.md) |
+| `@5ss/ai-tools/bedrock-agentcore-code-interpreter` | session + execute + files | [bedrock-agentcore-code-interpreter](./docs/vendors/bedrock-agentcore-code-interpreter.md) |
+| `@5ss/ai-tools/bedrock-agentcore-browser` | start/stop/get session + stream endpoints | [bedrock-agentcore-browser](./docs/vendors/bedrock-agentcore-browser.md) |
+
+| `@5ss/ai-tools/gotenberg` | render PDF/screenshot + `office-to-pdf` convert | [gotenberg](./docs/vendors/gotenberg.md) |
+| `@5ss/ai-tools/cloudflare-browser` | sessions + PDF/screenshot quick actions | [cloudflare-browser](./docs/vendors/cloudflare-browser.md) |
+| `@5ss/ai-tools/woocommerce` | orders, notes, refunds, products, variations, customers, coupons, categories | [woocommerce](./docs/vendors/woocommerce.md) |
+| `@5ss/ai-tools/katana` | sales/purchase/manufacturing orders, products, materials, customers, suppliers, inventory | [katana](./docs/vendors/katana.md) |
+| `@5ss/ai-tools/amazon-sp-api` | orders + items, FBA inventory, reports + documents, catalog search | [amazon-sp-api](./docs/vendors/amazon-sp-api.md) |
+
+Auth fields are **snake_case** (`api_key`, `bot_token`, `access_key_id`, …).
+
+## Guides
+
+| Guide | Purpose |
+| --- | --- |
+| [Getting started](./docs/guides/getting-started.md) | Install, import map, first bind |
+| [Auth and binding](./docs/guides/auth-and-binding.md) | Host-owned secrets, `withAuth` |
+| [Adapters](./docs/guides/adapters.md) | Project kernel tools into frameworks |
+| [Authoring packs](./docs/guides/authoring-modules.md) | modules vs vendors, layout, codegen |
+| [Errors](./docs/guides/errors.md) | `ToolError` codes and retry |
+| [HTTP / AWS transport](./docs/reference/http-and-aws-services.md) | `HttpService` / `AwsService` |
+| [Package surface](./docs/specs/package-surface-architecture.md) | modules · vendors architecture |
+| [Provider seam](./docs/specs/provider-seam.md) | Multi-provider capability modules |
+
+## Develop
+
+```bash
+bun install
+bun run hooks:install
+oxfmt --write <touched-paths>
+bun run check          # format:check + lint + codegen:check + test
+bun run codegen
+bun run new-module <kebab-key> [--title …] [--description …] [--auth none|custom]
+bun run build
+```
+
+Codegen owns `package.json` exports for packs under `src/modules|vendors/<key>/` with `index.ts`. Underscore kits (`_email`, `_storage`, `_messaging`) are skipped.
+
+## Artifacts (extract · convert · render)
+
+- Objects are **S3 keys** (`ArtifactRef`), not base64 in the model. Spec: [artifacts-extract-convert](./docs/specs/artifacts-extract-convert.md).
+- **Read / build / edit:** text, PDF, DOCX, spreadsheet, and image-metadata work lives in [`document`](./docs/modules/document.md); PPTX work lives in [`presentation`](./docs/modules/presentation.md). Product lock: [document plane](./docs/specs/document-plane.md).
+- **Extract:** Amazon Textract (object must live in AWS S3 Textract can read).
+- **Convert (office→PDF):** self-host [Gotenberg](https://gotenberg.dev/) LibreOffice (`file-convert` path `office-to-pdf`).
+- **Render (HTML/URL):** Gotenberg Chromium or Cloudflare Browser Rendering → storage `ArtifactRef`.
+
+## Release
+
+**[semantic-release](https://semantic-release.gitbook.io/)** on `main` from **conventional commits**. No manual version bump.
+
+| Commit | Version |
+| --- | --- |
+| `feat:` | minor |
+| `fix:` / `perf:` / `refactor:` | patch |
+| `BREAKING CHANGE` / `type!:` | major |
+
+Details: [docs/versioning.md](./docs/versioning.md).
+
+## License
+
+[MIT](./LICENSE) © harryy

package/dist/ai-sdk/index.d.ts

@@ -0,0 +1,15 @@
+import { g as ToolSource, o as ToolContext, s as ToolDefinition } from "../types-Ccb0DXY9.js";
+import { dynamicTool } from "ai";
+//#region src/adapters/ai-sdk/create-ai-sdk-tool.d.ts
+type AiSdkTool = ReturnType<typeof dynamicTool>;
+/** Exact execute options supplied by the installed AI SDK. */
+type AiSdkExecuteOptions = Parameters<NonNullable<AiSdkTool['execute']>>[1];
+type AiSdkToolsOptions = {
+  context?: ToolContext;
+  createContext?: (options: AiSdkExecuteOptions) => ToolContext | Promise<ToolContext>;
+};
+declare function createAiSdkTool(kernelTool: ToolDefinition, options?: AiSdkToolsOptions): AiSdkTool;
+declare function createAiSdkTools(source: ToolSource, options?: AiSdkToolsOptions): Record<string, AiSdkTool>;
+//#endregion
+export { type AiSdkExecuteOptions, type AiSdkToolsOptions, createAiSdkTool, createAiSdkTools };
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/adapters/ai-sdk/create-ai-sdk-tool.ts"],"mappings":";;;KASK,YAAY,kBAAkB;;KAGvB,sBAAsB,WAAW,YAAY;KAE7C;EACX,UAAU;EACV,iBAAiB,SAAS,wBAAwB,cAAc,QAAQ;;iBAGzD,gBAAgB,YAAY,gBAAgB,UAAS,oBAAyB;iBAW9E,iBAAiB,QAAQ,YAAY,UAAS,oBAAyB,eAAe"}

package/dist/ai-sdk/index.js

@@ -0,0 +1,24 @@
+import { n as runTool, s as resolveTools } from "../with-auth-CpKqTrGK.js";
+import { t as assertUniqueBy } from "../unique-EwBH1JPB.js";
+import { t as mergeAdapterToolContext } from "../framework-context-DVIIY8ZO.js";
+import { keyBy, mapValues } from "es-toolkit";
+import { dynamicTool } from "ai";
+//#region src/adapters/ai-sdk/create-ai-sdk-tool.ts
+function createAiSdkTool(kernelTool, options = {}) {
+	return dynamicTool({
+		description: kernelTool.description,
+		inputSchema: kernelTool.inputSchema,
+		execute: async (input, execOptions) => {
+			return runTool(kernelTool, input, await mergeAdapterToolContext(execOptions, options, "abortSignal"));
+		}
+	});
+}
+function createAiSdkTools(source, options = {}) {
+	const tools = resolveTools(source);
+	assertUniqueBy(tools, (t) => t.id, (id) => `Duplicate tool id when building AI SDK tools: ${id}`);
+	return mapValues(keyBy(tools, (t) => t.id), (tool) => createAiSdkTool(tool, options));
+}
+//#endregion
+export { createAiSdkTool, createAiSdkTools };
+
+//# sourceMappingURL=index.js.map

package/dist/ai-sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/adapters/ai-sdk/create-ai-sdk-tool.ts"],"sourcesContent":["import { dynamicTool } from 'ai'\nimport { keyBy, mapValues } from 'es-toolkit'\n\nimport { mergeAdapterToolContext } from '../framework-context'\nimport { resolveTools } from '../../core/resolve-tools'\nimport type { ToolContext, ToolDefinition, ToolSource } from '../../core/types'\nimport { assertUniqueBy } from '../../core/unique'\nimport { runTool } from '../../core/with-auth'\n\ntype AiSdkTool = ReturnType<typeof dynamicTool>\n\n/** Exact execute options supplied by the installed AI SDK. */\nexport type AiSdkExecuteOptions = Parameters<NonNullable<AiSdkTool['execute']>>[1]\n\nexport type AiSdkToolsOptions = {\n\tcontext?: ToolContext\n\tcreateContext?: (options: AiSdkExecuteOptions) => ToolContext | Promise<ToolContext>\n}\n\nexport function createAiSdkTool(kernelTool: ToolDefinition, options: AiSdkToolsOptions = {}): AiSdkTool {\n\treturn dynamicTool({\n\t\tdescription: kernelTool.description,\n\t\tinputSchema: kernelTool.inputSchema,\n\t\texecute: async (input, execOptions) => {\n\t\t\tconst ctx = await mergeAdapterToolContext(execOptions, options, 'abortSignal')\n\t\t\treturn runTool(kernelTool, input, ctx)\n\t\t}\n\t})\n}\n\nexport function createAiSdkTools(source: ToolSource, options: AiSdkToolsOptions = {}): Record<string, AiSdkTool> {\n\tconst tools = resolveTools(source)\n\tassertUniqueBy(\n\t\ttools,\n\t\t(t) => t.id,\n\t\t(id) => `Duplicate tool id when building AI SDK tools: ${id}`\n\t)\n\treturn mapValues(\n\t\tkeyBy(tools, (t) => t.id),\n\t\t(tool) => createAiSdkTool(tool, options)\n\t)\n}\n"],"mappings":";;;;;;AAmBA,SAAgB,gBAAgB,YAA4B,UAA6B,CAAC,GAAc;CACvG,OAAO,YAAY;EAClB,aAAa,WAAW;EACxB,aAAa,WAAW;EACxB,SAAS,OAAO,OAAO,gBAAgB;GAEtC,OAAO,QAAQ,YAAY,OAAO,MADhB,wBAAwB,aAAa,SAAS,aAAa,CACxC;EACtC;CACD,CAAC;AACF;AAEA,SAAgB,iBAAiB,QAAoB,UAA6B,CAAC,GAA8B;CAChH,MAAM,QAAQ,aAAa,MAAM;CACjC,eACC,QACC,MAAM,EAAE,KACR,OAAO,iDAAiD,IAC1D;CACA,OAAO,UACN,MAAM,QAAQ,MAAM,EAAE,EAAE,IACvB,SAAS,gBAAgB,MAAM,OAAO,CACxC;AACD"}

package/dist/artifact-D064mHfK.js

@@ -0,0 +1,44 @@
+import { isPlainObject } from "es-toolkit";
+import { z } from "zod";
+//#region src/shared/artifact.ts
+/** Durable blob handle — bytes never pass through the LLM. */
+const artifactRefSchema = z.object({
+	store: z.enum(["object", "host"]).describe("Who owns the bytes. object = bound object storage; host = host-mapped key"),
+	key: z.string().min(1).describe("Object key (or host id when store is host)"),
+	media_type: z.string().min(1).optional().describe("MIME or format hint when known"),
+	filename: z.string().min(1).optional().describe("Original or display file name"),
+	byte_length: z.int().min(0).optional().describe("Size in bytes when known")
+});
+/** Find unique ArtifactRefs in a structured tool output, in depth-first order. */
+function findArtifactRefs(output) {
+	const artifacts = [];
+	const identities = /* @__PURE__ */ new Set();
+	const visited = /* @__PURE__ */ new WeakSet();
+	const visit = (value) => {
+		if (Array.isArray(value)) {
+			if (visited.has(value)) return;
+			visited.add(value);
+			for (const item of value) visit(item);
+			return;
+		}
+		if (!isPlainObject(value)) return;
+		if (visited.has(value)) return;
+		visited.add(value);
+		const parsed = artifactRefSchema.safeParse(value);
+		if (parsed.success) {
+			const identity = JSON.stringify([parsed.data.store, parsed.data.key]);
+			if (!identities.has(identity)) {
+				identities.add(identity);
+				artifacts.push(parsed.data);
+			}
+			return;
+		}
+		for (const item of Object.values(value)) visit(item);
+	};
+	visit(output);
+	return artifacts;
+}
+//#endregion
+export { findArtifactRefs as n, artifactRefSchema as t };
+
+//# sourceMappingURL=artifact-D064mHfK.js.map

package/dist/artifact-D064mHfK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-D064mHfK.js","names":[],"sources":["../src/shared/artifact.ts"],"sourcesContent":["import { isPlainObject } from 'es-toolkit'\nimport { z } from 'zod'\n\n/** Durable blob handle — bytes never pass through the LLM. */\nexport const artifactRefSchema = z.object({\n\tstore: z\n\t\t.enum(['object', 'host'])\n\t\t.describe('Who owns the bytes. object = bound object storage; host = host-mapped key'),\n\tkey: z.string().min(1).describe('Object key (or host id when store is host)'),\n\tmedia_type: z.string().min(1).optional().describe('MIME or format hint when known'),\n\tfilename: z.string().min(1).optional().describe('Original or display file name'),\n\tbyte_length: z.int().min(0).optional().describe('Size in bytes when known')\n})\n\nexport type ArtifactRef = z.infer<typeof artifactRefSchema>\n\n/** Find unique ArtifactRefs in a structured tool output, in depth-first order. */\nexport function findArtifactRefs(output: unknown): ArtifactRef[] {\n\tconst artifacts: ArtifactRef[] = []\n\tconst identities = new Set<string>()\n\tconst visited = new WeakSet<object>()\n\n\tconst visit = (value: unknown): void => {\n\t\tif (Array.isArray(value)) {\n\t\t\tif (visited.has(value)) return\n\t\t\tvisited.add(value)\n\t\t\tfor (const item of value) visit(item)\n\t\t\treturn\n\t\t}\n\t\tif (!isPlainObject(value)) return\n\t\tif (visited.has(value)) return\n\t\tvisited.add(value)\n\n\t\tconst parsed = artifactRefSchema.safeParse(value)\n\t\tif (parsed.success) {\n\t\t\tconst identity = JSON.stringify([parsed.data.store, parsed.data.key])\n\t\t\tif (!identities.has(identity)) {\n\t\t\t\tidentities.add(identity)\n\t\t\t\tartifacts.push(parsed.data)\n\t\t\t}\n\t\t\treturn\n\t\t}\n\n\t\tfor (const item of Object.values(value)) visit(item)\n\t}\n\n\tvisit(output)\n\treturn artifacts\n}\n"],"mappings":";;;;AAIA,MAAa,oBAAoB,EAAE,OAAO;CACzC,OAAO,EACL,KAAK,CAAC,UAAU,MAAM,CAAC,CAAC,CACxB,SAAS,2EAA2E;CACtF,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,4CAA4C;CAC5E,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,gCAAgC;CAClF,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,+BAA+B;CAC/E,aAAa,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,0BAA0B;AAC3E,CAAC;;AAKD,SAAgB,iBAAiB,QAAgC;CAChE,MAAM,YAA2B,CAAC;CAClC,MAAM,6BAAa,IAAI,IAAY;CACnC,MAAM,0BAAU,IAAI,QAAgB;CAEpC,MAAM,SAAS,UAAyB;EACvC,IAAI,MAAM,QAAQ,KAAK,GAAG;GACzB,IAAI,QAAQ,IAAI,KAAK,GAAG;GACxB,QAAQ,IAAI,KAAK;GACjB,KAAK,MAAM,QAAQ,OAAO,MAAM,IAAI;GACpC;EACD;EACA,IAAI,CAAC,cAAc,KAAK,GAAG;EAC3B,IAAI,QAAQ,IAAI,KAAK,GAAG;EACxB,QAAQ,IAAI,KAAK;EAEjB,MAAM,SAAS,kBAAkB,UAAU,KAAK;EAChD,IAAI,OAAO,SAAS;GACnB,MAAM,WAAW,KAAK,UAAU,CAAC,OAAO,KAAK,OAAO,OAAO,KAAK,GAAG,CAAC;GACpE,IAAI,CAAC,WAAW,IAAI,QAAQ,GAAG;IAC9B,WAAW,IAAI,QAAQ;IACvB,UAAU,KAAK,OAAO,IAAI;GAC3B;GACA;EACD;EAEA,KAAK,MAAM,QAAQ,OAAO,OAAO,KAAK,GAAG,MAAM,IAAI;CACpD;CAEA,MAAM,MAAM;CACZ,OAAO;AACR"}