silkweave 2.6.1 → 3.1.0

package/README.md

@@ -14,9 +14,9 @@ Silkweave is a TypeScript toolkit that lets you define application logic as port
          ┌──────────────┬───────┼───────┬──────────────┐
          │              │       │       │              │
   ┌──────▼──────┐ ┌─────▼─────┐ │ ┌─────▼──────┐ ┌────▼─────┐
-  │ MCP (stdio) │ │   Fastify │ │ │    CLI     │ │  Vercel  │
+  │ MCP (stdio) │ │   Fastify │ │ │    CLI     │ │   Edge   │
   │ MCP (http)  │ │  REST API │ │ │ commander  │ │serverless│
-  │             │ │ + Swagger │ │ │  + clack   │ │  MCP     │
+  │             │ │ + Swagger │ │ │  console   │ │  MCP     │
   └─────────────┘ └───────────┘ │ └────────────┘ └──────────┘
                                 │
 ```
@@ -37,7 +37,7 @@ Silkweave is a TypeScript toolkit that lets you define application logic as port
   - [MCP Streamable HTTP](#mcp-streamable-http)
   - [Fastify REST API](#fastify-rest-api)
   - [CLI](#cli)
-  - [Vercel Serverless](#vercel-serverless)
+  - [Edge Adapter](#edge-adapter)
 - [Logging and Progress](#logging-and-progress)
 - [Streaming Actions](#streaming-actions)
 - [Plug into Vercel AI SDK](#plug-into-vercel-ai-sdk)
@@ -60,7 +60,7 @@ Silkweave eliminates this duplication. You define an **Action** - a name, a Zod
 
 - **MCP adapters** register your actions as MCP tools with proper notifications, progress reporting, and error handling
 - **Fastify adapter** generates a REST API with full OpenAPI/Swagger documentation derived from your Zod schemas
-- **CLI adapter** builds a complete command-line interface with argument parsing, option flags, and beautiful terminal output via clack
+- **CLI adapter** builds a complete command-line interface with argument parsing, option flags, and plain `console` output
 
 Your action doesn't know or care which transport is running it.
 
@@ -74,11 +74,10 @@ Silkweave is organized as a monorepo with modular packages. Install only what yo
 |---------|-----|-------------|
 | `@silkweave/core` | [![npm](https://img.shields.io/npm/v/@silkweave/core)](https://www.npmjs.com/package/@silkweave/core) | Core library - actions, adapters, builder, context, logger, utilities |
 | `@silkweave/mcp` | [![npm](https://img.shields.io/npm/v/@silkweave/mcp)](https://www.npmjs.com/package/@silkweave/mcp) | MCP adapters - stdio, streamable HTTP, CLI proxy |
-| `@silkweave/cli` | [![npm](https://img.shields.io/npm/v/@silkweave/cli)](https://www.npmjs.com/package/@silkweave/cli) | CLI adapter - commander + clack terminal UI |
+| `@silkweave/cli` | [![npm](https://img.shields.io/npm/v/@silkweave/cli)](https://www.npmjs.com/package/@silkweave/cli) | CLI adapter - commander + plain `console` output |
 | `@silkweave/fastify` | [![npm](https://img.shields.io/npm/v/@silkweave/fastify)](https://www.npmjs.com/package/@silkweave/fastify) | Fastify REST adapter - auto-generated OpenAPI/Swagger docs |
-| `@silkweave/vercel` | [![npm](https://img.shields.io/npm/v/@silkweave/vercel)](https://www.npmjs.com/package/@silkweave/vercel) | Vercel serverless adapter - stateless MCP over Streamable HTTP |
+| `@silkweave/edge` | [![npm](https://img.shields.io/npm/v/@silkweave/edge)](https://www.npmjs.com/package/@silkweave/edge) | Edge / serverless adapter - stateless MCP over Web Standard Streamable HTTP |
 | `@silkweave/ai` | [![npm](https://img.shields.io/npm/v/@silkweave/ai)](https://www.npmjs.com/package/@silkweave/ai) | Vercel AI SDK bridge - `createChatAction()` + `silkweaveTransport()` for `useChat` over tRPC subscriptions |
-| `@silkweave/logger` | [![npm](https://img.shields.io/npm/v/@silkweave/logger)](https://www.npmjs.com/package/@silkweave/logger) | Logging utilities - pino, clack, and MCP notification support |
 
 **`@silkweave/core`** is always required. Then add the adapter packages for the transports you need:
 
@@ -93,13 +92,13 @@ pnpm add @silkweave/core @silkweave/fastify
 pnpm add @silkweave/core @silkweave/cli
 
 # Vercel serverless MCP
-pnpm add @silkweave/core @silkweave/vercel
+pnpm add @silkweave/core @silkweave/edge
 
 # Vercel AI SDK chat (useChat over tRPC subscriptions)
 pnpm add @silkweave/core @silkweave/trpc @silkweave/ai ai @ai-sdk/anthropic
 
 # All of the above
-pnpm add @silkweave/core @silkweave/mcp @silkweave/cli @silkweave/fastify @silkweave/vercel @silkweave/ai
+pnpm add @silkweave/core @silkweave/mcp @silkweave/cli @silkweave/fastify @silkweave/edge @silkweave/ai
 ```
 
 ---
@@ -373,7 +372,7 @@ fastify({
 
 ### CLI
 
-Transforms your actions into a complete command-line application with help text, option parsing, and styled terminal output via clack.
+Transforms your actions into a complete command-line application with help text, option parsing, and plain `console` output.
 
 ```typescript
 import { silkweave } from '@silkweave/core'
@@ -407,17 +406,17 @@ $ mytool greet --name "World" --enthusiastic
 ℹ HELLO, WORLD!!!
 ```
 
-### Vercel Serverless
+### Edge Adapter
 
 Deploy your actions as a stateless MCP server on Vercel. Each request creates a fresh server instance - no sessions, no persistent connections, fully compatible with serverless constraints.
 
 ```typescript
-// api/mcp.ts (Vercel function)
+// api/mcp.ts (edge / serverless function)
 import { silkweave } from '@silkweave/core'
-import { vercel } from '@silkweave/vercel'
+import { edge } from '@silkweave/edge'
 import { SearchAction } from '../actions/search.js'
 
-const { adapter, handler } = vercel()
+const { adapter, handler } = edge()
 
 await silkweave({ name: 'my-tools', description: 'My Tools', version: '1.0.0' })
   .adapter(adapter)
@@ -427,12 +426,12 @@ await silkweave({ name: 'my-tools', description: 'My Tools', version: '1.0.0' })
 export default { fetch: handler }
 ```
 
-The `vercel()` function returns a compound object - `adapter` wires into the Silkweave builder, while `handler`/`GET`/`POST`/`DELETE` are the request handler for your Vercel route.
+The `edge()` function returns a compound object - `adapter` wires into the Silkweave builder, while `handler`/`GET`/`POST`/`DELETE` are the request handler for your Vercel route.
 
 **For Next.js App Router** (`app/api/mcp/route.ts`):
 
 ```typescript
-const { adapter, GET, POST, DELETE } = vercel()
+const { adapter, GET, POST, DELETE } = edge()
 
 await silkweave({ name: 'my-tools', description: 'My Tools', version: '1.0.0' })
   .adapter(adapter)
@@ -449,7 +448,7 @@ export { GET, POST, DELETE }
 - Logging goes to `process.stderr` (Vercel log drain) and MCP client notifications
 - No CORS handling - use Next.js middleware or `vercel.json` headers
 
-**`VercelAdapterOptions`:**
+**`EdgeAdapterOptions`:**
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
@@ -534,7 +533,7 @@ Adapters detect streaming actions via `isStreamingAction()` at registration time
 |---------|-------------|---------------------|-------------------|
 | **MCP stdio** (`@silkweave/mcp`) | `notifications/progress` - one notification per chunk, with the JSON-stringified chunk in the `message` field and a 1-based `progress` counter | Client sends `_meta.progressToken` in the tool call (MCP SDK does this automatically when the host subscribes) | Action runs to completion; chunks are buffered and returned as the final `CallToolResult` |
 | **MCP HTTP** (`@silkweave/mcp`) | Same - `notifications/progress` carried on the session's SSE stream | Same - `_meta.progressToken` | Same |
-| **MCP Vercel** (`@silkweave/vercel`) | Same - `notifications/progress` over Streamable HTTP | Same | Same |
+| **MCP Edge** (`@silkweave/edge`) | Same - `notifications/progress` over Streamable HTTP | Same | Same |
 | **Fastify REST** (`@silkweave/fastify`) | `text/event-stream` (SSE: `data: <json>\n\n`, terminated by `event: done`) **or** `application/x-ndjson` (one JSON chunk per line) | `Accept: text/event-stream` or `Accept: application/x-ndjson` | `200 OK` with the buffered chunk array as JSON |
 | **tRPC** (`@silkweave/trpc`) | Action is registered as a tRPC **`.subscription()`** whose async generator yields chunks directly | Streaming action ⇒ always a subscription, regardless of `kind` | n/a - the consumer iterates the subscription |
 | **CLI** (`@silkweave/cli`) | NDJSON on stdout (one JSON chunk per line, backpressure-aware via `stdout.write` + `drain`) | Streaming action ⇒ always streamed | n/a |
@@ -624,7 +623,7 @@ See [`examples/ai/`](../../examples/ai) in the repo for a complete Vite + React
 
 ## Smart Tool Results
 
-MCP adapters (stdio, HTTP, and Vercel) use `smartToolResult()` by default to format action return values. This is a server-side best practice for managing LLM context bloat:
+MCP adapters (stdio, HTTP, and Edge) use `smartToolResult()` by default to format action return values. This is a server-side best practice for managing LLM context bloat:
 
 - **Small responses** (≤ 4096 chars): returned as inline `TextContent` JSON
 - **Large responses** (> 4096 chars): split into a short text summary + a base64 **embedded resource**, keeping the LLM's context window lean while preserving full data access
@@ -923,17 +922,17 @@ interface FastifyAdapterOptions {
   // ...plus all FastifyHttpOptions (logger, connectionTimeout, etc.)
 }
 
-// CLI via commander + clack - from @silkweave/cli
+// CLI via commander - from @silkweave/cli
 import { cli } from '@silkweave/cli'
 function cli(): AdapterFactory
 
-// Vercel serverless - from @silkweave/vercel
-import { vercel } from '@silkweave/vercel'
-function vercel(options?: VercelAdapterOptions): VercelAdapter
-interface VercelAdapterOptions {
+// Edge / serverless - from @silkweave/edge
+import { edge } from '@silkweave/edge'
+function edge(options?: EdgeAdapterOptions): EdgeAdapter
+interface EdgeAdapterOptions {
   enableJsonResponse?: boolean
 }
-interface VercelAdapter {
+interface EdgeAdapter {
   adapter: AdapterGenerator          // Pass to silkweave().adapter()
   handler: (req: Request) => Promise<Response>
   GET: (req: Request) => Promise<Response>

package/build/auth-oauth.d.mts

@@ -0,0 +1 @@
+export * from "@silkweave/auth/oauth";

package/build/auth-oauth.mjs

@@ -0,0 +1,2 @@
+export * from "@silkweave/auth/oauth";
+export {};

package/build/edge.d.mts

@@ -0,0 +1 @@
+export * from "@silkweave/edge";

package/build/edge.mjs

@@ -0,0 +1,2 @@
+export * from "@silkweave/edge";
+export {};

package/build/logger.d.mts

@@ -1 +1,2 @@
-export * from "@silkweave/logger";
+import { CreateLoggerOptions, LogFn, LogLevel, LogLevels, Logger, MessageOptions, ProgressOptions, buildLogLevels, createConsoleLogger, createLogger } from "@silkweave/core";
+export { type CreateLoggerOptions, type LogFn, type LogLevel, LogLevels, type Logger, type MessageOptions, type ProgressOptions, buildLogLevels, createConsoleLogger, createLogger };

package/build/logger.mjs

@@ -1,2 +1,2 @@
-export * from "@silkweave/logger";
-export {};
+import { LogLevels, buildLogLevels, createConsoleLogger, createLogger } from "@silkweave/core";
+export { LogLevels, buildLogLevels, createConsoleLogger, createLogger };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "silkweave",
-  "version": "2.6.1",
+  "version": "3.1.0",
   "description": "Silkweave Umbrella Package",
   "license": "MIT",
   "homepage": "https://www.silkweave.dev",
@@ -21,6 +21,10 @@
       "types": "./build/auth.d.mts",
       "default": "./build/auth.mjs"
     },
+    "./auth/oauth": {
+      "types": "./build/auth-oauth.d.mts",
+      "default": "./build/auth-oauth.mjs"
+    },
     "./cli": {
       "types": "./build/cli.d.mts",
       "default": "./build/cli.mjs"
@@ -49,20 +53,19 @@
       "types": "./build/typegen.d.mts",
       "default": "./build/typegen.mjs"
     },
-    "./vercel": {
-      "types": "./build/vercel.d.mts",
-      "default": "./build/vercel.mjs"
+    "./edge": {
+      "types": "./build/edge.d.mts",
+      "default": "./build/edge.mjs"
     }
   },
   "dependencies": {
-    "@silkweave/auth": "2.6.1",
-    "@silkweave/cli": "2.6.1",
-    "@silkweave/fastify": "2.6.1",
-    "@silkweave/logger": "2.6.1",
-    "@silkweave/core": "2.6.1",
-    "@silkweave/mcp": "2.6.1",
-    "@silkweave/vercel": "2.6.1",
-    "@silkweave/typegen": "2.6.1"
+    "@silkweave/auth": "3.1.0",
+    "@silkweave/cli": "3.1.0",
+    "@silkweave/core": "3.1.0",
+    "@silkweave/fastify": "3.1.0",
+    "@silkweave/mcp": "3.1.0",
+    "@silkweave/edge": "3.1.0",
+    "@silkweave/typegen": "3.1.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/build/vercel.d.mts

@@ -1 +0,0 @@
-export * from "@silkweave/vercel";

package/build/vercel.mjs

@@ -1,2 +0,0 @@
-export * from "@silkweave/vercel";
-export {};