stitchkit 0.93.0 → 0.94.0

package/llms/tools-connections.txt

@@ -0,0 +1,45 @@
+# stitchkit/tools/connections — stitchkit docs slice
+
+> Generated from the `docs/` tree by `bun run gen:llms`. The index of all slices is
+> `llms.txt` in this package.
+
+Contains: API reference: `stitchkit/tools/connections`  (docs/api/reference.md)
+
+Also read:
+- see `llms/tools.txt` for the MCP & agents guide
+
+==============================================================================
+# API reference: `stitchkit/tools/connections`  (docs/api/reference.md)
+==============================================================================
+
+## `stitchkit/tools/connections`
+
+Server-only subexport that consumes external MCP servers and OpenAPI specifications
+as typed tools, without adding a peer dependency to `stitchkit/tools`. Foreign
+operations mount as the same `RuntimeToolDefinition`s our own produce, so
+`mountAgent({ runtimeTools })` runs them through the canonical lifecycle, hooks
+and approval path.
+
+| Export | Kind | Summary |
+|--------|------|---------|
+| `defineMcpClientConnection` | function | declare one external MCP server connection over Streamable HTTP with an optional SSE fallback |
+| `defineOpenApiConnection` | function | declare one OpenAPI document (object, JSON text or JSON URL) as a tool surface |
+| `mountConnections` | function | discover every connection and return readonly `RuntimeToolDefinition`s for `mountAgent` |
+| `ConnectionAuthorizationRequiredError` | class | typed reauthorization signal raised on `401` with credentials resolved again on the next call |
+| `ConnectionBudgetExceededError` | class | the mount would expose more foreign tools than its declared budget |
+| `ConnectionRequestError` | class | any non-`2xx` connection response other than the reauthorization signal |
+| `ConnectionUrlError` | class | a non-http(s) URL or a request host the SSRF fence refused |
+| `ConnectionTokenProvider` | _type_ | `() => string \| undefined \| Promise<string \| undefined>` — the lazily resolved credential |
+| `ConnectionBudget` | _type_ | `{ maxTools? }` ceiling on one `mountConnections` call |
+| `ConnectionDefinition` | _type_ | either a defined MCP client or OpenAPI connection |
+| `ConnectionMountOptions` | _type_ | shared `{ lifecycle?, budget?, onSkippedTool? }` mount policy |
+| `ConnectionToolSkipReporter` | _type_ | `(skipped) => void` — called per discovered tool the mount could not build; defaults to a stderr line, and the rest of the surface still mounts |
+| `SkippedConnectionTool` | _type_ | `{ connection, tool, reason }` — which tool was not mounted, and why |
+| `McpClientConnection` | _type_ | a defined MCP client connection |
+| `McpClientConnectionConfig` | _type_ | name, transport, tool filter, token provider, instance key, allowed hosts and `transports` — naming `['CLI']` makes the whole server's discovered tools commands, with no per-definition rewriting |
+| `McpConnectionTransport` | _type_ | `{ url, headers? }` for one MCP endpoint |
+| `McpToolFilter` | _type_ | `{ allow?, block? }` discovered-tool filter |
+| `OpenApiConnection` | _type_ | a defined OpenAPI connection |
+| `OpenApiConnectionConfig` | _type_ | name, spec, base URL, token provider, instance key, allowed hosts and `transports` |
+
+---

package/llms/tools-contract.txt

@@ -0,0 +1,9 @@
+# stitchkit/tools/contract — stitchkit docs slice
+
+> Generated from the `docs/` tree by `bun run gen:llms`. The index of all slices is
+> `llms.txt` in this package.
+
+Contains: pointers only
+
+Also read:
+- see `llms/tools.txt` for the MCP & agents guide

package/llms/tools-invoker.txt

@@ -0,0 +1,9 @@
+# stitchkit/tools/invoker — stitchkit docs slice
+
+> Generated from the `docs/` tree by `bun run gen:llms`. The index of all slices is
+> `llms.txt` in this package.
+
+Contains: pointers only
+
+Also read:
+- see `llms/tools.txt` for the MCP & agents guide