@jaypie/mcp 0.2.10 → 0.3.0

package/prompts/Jaypie_Express_Package.md

@@ -407,50 +407,6 @@ expressHandler automatically sets these headers:
 
 When Datadog environment variables are configured, expressHandler automatically submits metrics for each request including status code and path.
 
-## Server Creation
-
-Use `createServer` to quickly set up an Express server with standard Jaypie middleware.
-
-### Basic Server Usage
-
-```typescript
-import express from "express";
-import { createServer, expressHandler } from "jaypie";
-
-const app = express();
-
-app.get("/", expressHandler(async (req, res) => {
-  return { message: "Hello World" };
-}));
-
-const { server, port } = await createServer(app);
-console.log(`Server running on port ${port}`);
-```
-
-### Server Options
-
-```typescript
-import { createServer } from "jaypie";
-import type { CreateServerOptions } from "jaypie";
-
-const options: CreateServerOptions = {
-  port: 3000,              // Port to listen on (default: PORT env var or 8080)
-  cors: { origin: "*" },   // CORS config (false to disable)
-  jsonLimit: "10mb",       // JSON body parser limit (default: "1mb")
-  middleware: [myMiddleware], // Additional middleware to apply
-};
-
-const { server, port } = await createServer(app, options);
-```
-
-### Server Result
-
-```typescript
-import type { ServerResult } from "jaypie";
-
-// { server: Server, port: number }
-```
-
 ## Streaming Responses
 
 Use `expressStreamHandler` for Server-Sent Events (SSE) streaming responses. Ideal for real-time updates, LLM streaming, and long-running operations.

package/prompts/{Jaypie_Vocabulary_Commander.md → Jaypie_Fabric_Commander.md}

@@ -1,28 +1,28 @@
 ---
-description: Commander.js CLI integration with serviceHandler callbacks (onMessage, onComplete, onError, onFatal)
+description: Commander.js CLI integration with fabricService callbacks (onMessage, onComplete, onError, onFatal)
 include: "**/cli/**"
 ---
 
-# Jaypie Vocabulary Commander Adapter
+# Jaypie Fabric Commander Adapter
 
-The Commander adapter (`@jaypie/vocabulary/commander`) integrates Jaypie service handlers with Commander.js CLI applications, providing automatic option generation, type coercion, and callback hooks for progress reporting.
+The Commander adapter (`@jaypie/fabric/commander`) integrates Jaypie service handlers with Commander.js CLI applications, providing automatic option generation, type conversion, and callback hooks for progress reporting.
 
-**See also:** [Jaypie_Vocabulary_Package.md](Jaypie_Vocabulary_Package.md) for core serviceHandler documentation.
+**See also:** [Jaypie_Fabric_Package.md](Jaypie_Fabric_Package.md) for core fabricService documentation.
 
 ## Installation
 
 ```bash
-npm install @jaypie/vocabulary commander
+npm install @jaypie/fabric commander
 ```
 
 ## Quick Start
 
 ```typescript
 import { Command } from "commander";
-import { serviceHandler } from "@jaypie/vocabulary";
-import { registerServiceCommand } from "@jaypie/vocabulary/commander";
+import { fabricService } from "@jaypie/fabric";
+import { fabricCommand } from "@jaypie/fabric/commander";
 
-const handler = serviceHandler({
+const handler = fabricService({
   alias: "greet",
   description: "Greet a user",
   input: {
@@ -36,12 +36,12 @@ const handler = serviceHandler({
 });
 
 const program = new Command();
-registerServiceCommand({ handler, program });
+fabricCommand({ service: handler, program });
 program.parse();
 // Usage: greet --user Alice -l
 ```
 
-## registerServiceCommand
+## fabricCommand
 
 The primary function for registering a service handler as a Commander command.
 
@@ -49,7 +49,7 @@ The primary function for registering a service handler as a Commander command.
 
 | Option | Type | Description |
 |--------|------|-------------|
-| `handler` | `ServiceHandlerFunction` | Required. The service handler to register |
+| `service` | `Service` | Required. The service handler to register |
 | `program` | `Command` | Required. Commander program or command |
 | `name` | `string` | Override command name (default: handler.alias) |
 | `description` | `string` | Override description (default: handler.description) |
@@ -68,10 +68,10 @@ Receives progress messages sent by the service via `context.sendMessage`:
 
 ```typescript
 import { Command } from "commander";
-import { serviceHandler } from "@jaypie/vocabulary";
-import { registerServiceCommand } from "@jaypie/vocabulary/commander";
+import { fabricService } from "@jaypie/fabric";
+import { fabricCommand } from "@jaypie/fabric/commander";
 
-const handler = serviceHandler({
+const handler = fabricService({
   alias: "process",
   input: { jobId: { type: String, letter: "j" } },
   service: async ({ jobId }, context) => {
@@ -91,8 +91,8 @@ const handler = serviceHandler({
 });
 
 const program = new Command();
-registerServiceCommand({
-  handler,
+fabricCommand({
+  service: handler,
   program,
   onMessage: (msg) => {
     // msg: { content: string, level?: "trace"|"debug"|"info"|"warn"|"error" }
@@ -110,8 +110,8 @@ program.parse();
 Called with the handler's return value on successful completion:
 
 ```typescript
-registerServiceCommand({
-  handler,
+fabricCommand({
+  service: handler,
   program,
   onComplete: (response) => {
     // Called after service completes successfully
@@ -130,8 +130,8 @@ registerServiceCommand({
 Receives errors that the service explicitly reports via `context.onError()`. Use this for recoverable errors that don't halt execution:
 
 ```typescript
-registerServiceCommand({
-  handler,
+fabricCommand({
+  service: handler,
   program,
   onError: (error) => {
     // Log recoverable errors
@@ -145,8 +145,8 @@ registerServiceCommand({
 Receives fatal errors - either thrown errors or errors reported via `context.onFatal()`. Any error that escapes the service (is thrown) is treated as fatal:
 
 ```typescript
-registerServiceCommand({
-  handler,
+fabricCommand({
+  service: handler,
   program,
   onFatal: (error) => {
     console.error("Fatal error:", error.message);
@@ -164,10 +164,10 @@ registerServiceCommand({
 
 ```typescript
 import { Command } from "commander";
-import { serviceHandler } from "@jaypie/vocabulary";
-import { registerServiceCommand } from "@jaypie/vocabulary/commander";
+import { fabricService } from "@jaypie/fabric";
+import { fabricCommand } from "@jaypie/fabric/commander";
 
-const evaluateHandler = serviceHandler({
+const evaluateHandler = fabricService({
   alias: "evaluate",
   description: "Run an evaluation job",
   input: {
@@ -231,8 +231,8 @@ const evaluateHandler = serviceHandler({
 const program = new Command();
 program.version("1.0.0").description("Evaluation CLI");
 
-registerServiceCommand({
-  handler: evaluateHandler,
+fabricCommand({
+  service: evaluateHandler,
   program,
   onMessage: (msg) => {
     const prefix = msg.level === "warn" ? "WARNING: " :
@@ -309,13 +309,13 @@ For more control, use `createCommanderOptions` and `parseCommanderOptions`:
 
 ```typescript
 import { Command } from "commander";
-import { serviceHandler } from "@jaypie/vocabulary";
+import { fabricService } from "@jaypie/fabric";
 import {
   createCommanderOptions,
   parseCommanderOptions,
-} from "@jaypie/vocabulary/commander";
+} from "@jaypie/fabric/commander";
 
-const handler = serviceHandler({
+const handler = fabricService({
   input: {
     userName: { type: String, description: "User name" },
     maxRetries: { type: Number, default: 3 },
@@ -351,14 +351,14 @@ import type {
   CommanderOptionOverride,
   CreateCommanderOptionsConfig,
   CreateCommanderOptionsResult,
+  FabricCommandConfig,
+  FabricCommandResult,
   OnCompleteCallback,
   OnErrorCallback,
   OnFatalCallback,
   OnMessageCallback,
   ParseCommanderOptionsConfig,
-  RegisterServiceCommandConfig,
-  RegisterServiceCommandResult,
-} from "@jaypie/vocabulary/commander";
+} from "@jaypie/fabric/commander";
 ```
 
 ### Callback Type Definitions
@@ -386,26 +386,26 @@ type OnFatalCallback = (error: unknown) => void | Promise<void>;
 ## Exports
 
 ```typescript
-// @jaypie/vocabulary/commander
+// @jaypie/fabric/commander
 export { createCommanderOptions } from "./createCommanderOptions.js";
 export { parseCommanderOptions } from "./parseCommanderOptions.js";
-export { registerServiceCommand } from "./registerServiceCommand.js";
+export { fabricCommand } from "./fabricCommand.js";
 
 export type {
   CommanderOptionOverride,
   CreateCommanderOptionsConfig,
   CreateCommanderOptionsResult,
+  FabricCommandConfig,
+  FabricCommandResult,
   OnCompleteCallback,
   OnErrorCallback,
   OnFatalCallback,
   OnMessageCallback,
   ParseCommanderOptionsConfig,
-  RegisterServiceCommandConfig,
-  RegisterServiceCommandResult,
 } from "./types.js";
 ```
 
 ## Related
 
 - [Jaypie_Commander_CLI_Package.md](Jaypie_Commander_CLI_Package.md) - Setting up a Commander CLI project from scratch
-- [Jaypie_Vocabulary_Package.md](Jaypie_Vocabulary_Package.md) - Core serviceHandler and type coercion
+- [Jaypie_Fabric_Package.md](Jaypie_Fabric_Package.md) - Core fabricService and type conversion

package/prompts/{Jaypie_Vocabulary_LLM.md → Jaypie_Fabric_LLM.md}

@@ -1,27 +1,27 @@
 ---
-description: LLM tool creation from serviceHandler for use with @jaypie/llm Toolkit
+description: LLM tool creation from fabricService for use with @jaypie/llm Toolkit
 ---
 
-# Jaypie Vocabulary LLM Adapter
+# Jaypie Fabric LLM Adapter
 
-The LLM adapter (`@jaypie/vocabulary/llm`) creates LLM tools from Jaypie service handlers for use with `@jaypie/llm` Toolkit, automatically generating JSON Schema from input definitions.
+The LLM adapter (`@jaypie/fabric/llm`) creates LLM tools from Jaypie service handlers for use with `@jaypie/llm` Toolkit, automatically generating JSON Schema from input definitions.
 
-**See also:** [Jaypie_Vocabulary_Package.md](Jaypie_Vocabulary_Package.md) for core serviceHandler documentation.
+**See also:** [Jaypie_Fabric_Package.md](Jaypie_Fabric_Package.md) for core fabricService documentation.
 
 ## Installation
 
 ```bash
-npm install @jaypie/vocabulary @jaypie/llm
+npm install @jaypie/fabric @jaypie/llm
 ```
 
 ## Quick Start
 
 ```typescript
-import { serviceHandler } from "@jaypie/vocabulary";
-import { createLlmTool } from "@jaypie/vocabulary/llm";
+import { fabricService } from "@jaypie/fabric";
+import { fabricTool } from "@jaypie/fabric/llm";
 import { Toolkit } from "@jaypie/llm";
 
-const handler = serviceHandler({
+const handler = fabricService({
   alias: "greet",
   description: "Greet a user by name",
   input: {
@@ -34,19 +34,19 @@ const handler = serviceHandler({
   },
 });
 
-const { tool } = createLlmTool({ handler });
+const { tool } = fabricTool({ service: handler });
 const toolkit = new Toolkit([tool]);
 ```
 
-## createLlmTool
+## fabricTool
 
-Creates an LLM tool from a serviceHandler.
+Creates an LLM tool from a fabricService.
 
 ### Options
 
 | Option | Type | Description |
 |--------|------|-------------|
-| `handler` | `ServiceHandlerFunction` | Required. The service handler to adapt |
+| `service` | `Service` | Required. The service handler to adapt |
 | `name` | `string` | Override tool name (defaults to handler.alias) |
 | `description` | `string` | Override tool description (defaults to handler.description) |
 | `message` | `string \| function` | Custom message for logging |
@@ -59,10 +59,10 @@ Creates an LLM tool from a serviceHandler.
 ### Basic Usage
 
 ```typescript
-import { serviceHandler } from "@jaypie/vocabulary";
-import { createLlmTool } from "@jaypie/vocabulary/llm";
+import { fabricService } from "@jaypie/fabric";
+import { fabricTool } from "@jaypie/fabric/llm";
 
-const calculateHandler = serviceHandler({
+const calculateHandler = fabricService({
   alias: "calculate",
   description: "Perform a mathematical calculation",
   input: {
@@ -80,7 +80,7 @@ const calculateHandler = serviceHandler({
   },
 });
 
-const { tool } = createLlmTool({ handler: calculateHandler });
+const { tool } = fabricTool({ service: calculateHandler });
 
 // Tool has these properties:
 // tool.name: "calculate"
@@ -92,8 +92,8 @@ const { tool } = createLlmTool({ handler: calculateHandler });
 ### Overriding Name and Description
 
 ```typescript
-const { tool } = createLlmTool({
-  handler,
+const { tool } = fabricTool({
+  service: handler,
   name: "math_calculator",
   description: "A tool for performing basic math operations",
 });
@@ -102,7 +102,7 @@ const { tool } = createLlmTool({
 ### Excluding Fields
 
 ```typescript
-const handler = serviceHandler({
+const handler = fabricService({
   alias: "search",
   input: {
     query: { type: String },
@@ -112,8 +112,8 @@ const handler = serviceHandler({
   service: async (params) => { /* ... */ },
 });
 
-const { tool } = createLlmTool({
-  handler,
+const { tool } = fabricTool({
+  service: handler,
   exclude: ["_internalId"],  // Not exposed to LLM
 });
 ```
@@ -123,7 +123,7 @@ const { tool } = createLlmTool({
 Services can use context callbacks to report progress, errors, and completion:
 
 ```typescript
-const handler = serviceHandler({
+const handler = fabricService({
   alias: "evaluate",
   input: { jobId: { type: String } },
   service: async ({ jobId }, context) => {
@@ -139,8 +139,8 @@ const handler = serviceHandler({
   },
 });
 
-const { tool } = createLlmTool({
-  handler,
+const { tool } = fabricTool({
+  service: handler,
   onComplete: (result) => console.log("Tool completed:", result),
   onError: (error) => console.warn("Recoverable error:", error),
   onFatal: (error) => console.error("Fatal error:", error),
@@ -152,10 +152,10 @@ const { tool } = createLlmTool({
 
 ## inputToJsonSchema
 
-Converts vocabulary input definitions to JSON Schema:
+Converts fabric input definitions to JSON Schema:
 
 ```typescript
-import { inputToJsonSchema } from "@jaypie/vocabulary/llm";
+import { inputToJsonSchema } from "@jaypie/fabric/llm";
 
 const schema = inputToJsonSchema({
   userName: { type: String, description: "User's name" },
@@ -177,8 +177,8 @@ const schema = inputToJsonSchema({
 
 ### Type Mappings
 
-| Vocabulary Type | JSON Schema |
-|-----------------|-------------|
+| Fabric Type | JSON Schema |
+|-------------|-------------|
 | `String` | `{ type: "string" }` |
 | `Number` | `{ type: "number" }` |
 | `Boolean` | `{ type: "boolean" }` |
@@ -201,12 +201,12 @@ const schema = inputToJsonSchema(handler.input, {
 ## Complete Example
 
 ```typescript
-import { serviceHandler } from "@jaypie/vocabulary";
-import { createLlmTool } from "@jaypie/vocabulary/llm";
+import { fabricService } from "@jaypie/fabric";
+import { fabricTool } from "@jaypie/fabric/llm";
 import { Llm, Toolkit } from "@jaypie/llm";
 
 // Define service handlers
-const weatherHandler = serviceHandler({
+const weatherHandler = fabricService({
   alias: "get_weather",
   description: "Get current weather for a location",
   input: {
@@ -224,7 +224,7 @@ const weatherHandler = serviceHandler({
   },
 });
 
-const searchHandler = serviceHandler({
+const searchHandler = fabricService({
   alias: "search_web",
   description: "Search the web for information",
   input: {
@@ -237,8 +237,8 @@ const searchHandler = serviceHandler({
 });
 
 // Create tools
-const { tool: weatherTool } = createLlmTool({ handler: weatherHandler });
-const { tool: searchTool } = createLlmTool({ handler: searchHandler });
+const { tool: weatherTool } = fabricTool({ service: weatherHandler });
+const { tool: searchTool } = fabricTool({ service: searchHandler });
 
 // Use with Toolkit
 const toolkit = new Toolkit([weatherTool, searchTool]);
@@ -251,14 +251,14 @@ const response = await llm.ask("What's the weather in Tokyo?");
 
 ```typescript
 import type {
-  CreateLlmToolConfig,
-  CreateLlmToolResult,
+  FabricToolConfig,
+  FabricToolResult,
   LlmTool,
   OnCompleteCallback,
   OnErrorCallback,
   OnFatalCallback,
   OnMessageCallback,
-} from "@jaypie/vocabulary/llm";
+} from "@jaypie/fabric/llm";
 ```
 
 ### Type Definitions
@@ -271,8 +271,8 @@ interface LlmTool {
   function: (params: Record<string, unknown>) => Promise<unknown>;
 }
 
-interface CreateLlmToolConfig {
-  handler: ServiceHandlerFunction;
+interface FabricToolConfig {
+  service: Service;
   name?: string;
   description?: string;
   message?: string | ((params: Record<string, unknown>) => string);
@@ -283,7 +283,7 @@ interface CreateLlmToolConfig {
   onMessage?: OnMessageCallback;
 }
 
-interface CreateLlmToolResult {
+interface FabricToolResult {
   tool: LlmTool;
 }
 ```
@@ -291,13 +291,13 @@ interface CreateLlmToolResult {
 ## Exports
 
 ```typescript
-// @jaypie/vocabulary/llm
-export { createLlmTool } from "./createLlmTool.js";
+// @jaypie/fabric/llm
+export { fabricTool } from "./fabricTool.js";
 export { inputToJsonSchema } from "./inputToJsonSchema.js";
 
 export type {
-  CreateLlmToolConfig,
-  CreateLlmToolResult,
+  FabricToolConfig,
+  FabricToolResult,
   LlmTool,
   OnCompleteCallback,
   OnErrorCallback,
@@ -308,5 +308,5 @@ export type {
 
 ## Related
 
-- [Jaypie_Vocabulary_Package.md](Jaypie_Vocabulary_Package.md) - Core serviceHandler and type coercion
+- [Jaypie_Fabric_Package.md](Jaypie_Fabric_Package.md) - Core fabricService and type conversion
 - [Jaypie_Llm_Tools.md](Jaypie_Llm_Tools.md) - LLM tools and Toolkit usage