@pixeldojo/mcp 0.3.0 → 0.5.0

package/dist/index.d.cts

@@ -1,70 +1,6 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { PixelDojoClientOptions, PixelDojoClient } from '@pixeldojo/sdk';
 import { z } from 'zod';
-
-/**
- * MCP server bootstrap. Wires the named skills to the MCP `tools/list` +
- * `tools/call` handlers and runs over stdio.
- *
- * Architecture:
- *   - tools/list: returns every skill's name + description + inputSchema.
- *   - tools/call: parses input via Zod, dispatches to the skill module,
- *     converts the SkillResult into MCP content blocks, returns to host.
- *   - errors are translated at the boundary: provider failures, missing
- *     API keys, unknown skills all surface as actionable MCP error
- *     payloads (never raw stack traces).
- */
-
-declare const PACKAGE_VERSION = "0.1.0";
-interface ServerOptions {
-    apiKey: string;
-    baseUrl?: string;
-    packageVersion?: string;
-    /** Inject for tests. Defaults to the real fetch. */
-    baseFetch?: typeof globalThis.fetch;
-}
-/**
- * Build the configured MCP `Server` instance with handlers wired in.
- * Caller is responsible for connecting it to a transport (stdio in
- * production, mock in tests).
- */
-declare function buildServer(options: ServerOptions): Server;
-/**
- * Run the server over stdio. Used by the CLI; tests use buildServer
- * directly with a mock transport.
- */
-declare function runStdio(options: ServerOptions): Promise<void>;
-
-/**
- * Header-injecting wrapper around `@pixeldojo/sdk`'s PixelDojoClient.
- *
- * Per Eng review E2 + E3:
- *   - Depends on @pixeldojo/sdk for run/getJob/listModels/getModelSchema
- *     (DRY — no /api/v1 client duplication).
- *   - Injects `x-pixeldojo-source: mcp/<version>` and `x-pixeldojo-skill:
- *     <skill-name>` headers on every API call so Tool Health can attribute
- *     MCP traffic separately from raw REST.
- *
- * The SDK exposes a `fetch` injection point in its constructor — we wrap
- * the global `fetch` to add headers without monkey-patching anything.
- */
-
-interface MakeClientOptions extends PixelDojoClientOptions {
-    /** MCP package version for the `x-pixeldojo-source` header value. */
-    mcpVersion: string;
-    /** Optional skill name; if set, written to `x-pixeldojo-skill`. */
-    skillName?: string;
-    /** Optional fetch override (tests). Defaults to `globalThis.fetch`. */
-    baseFetch?: typeof globalThis.fetch;
-}
-/**
- * Build a PixelDojoClient with attribution headers baked in.
- *
- * Each call's headers include both the source tag and the requesting
- * skill so the server can record per-skill error rates without the
- * client passing skill metadata explicitly through every call.
- */
-declare function makeAttributedClient(options: MakeClientOptions): PixelDojoClient;
+import { PixelDojoClient, PixelDojoClientOptions } from '@pixeldojo/sdk';
 
 /**
  * Exponential-backoff job poller with a 30-second sync window.
@@ -193,6 +129,89 @@ interface SkillModule<TInput = unknown> {
     run(input: TInput, ctx: SkillContext): Promise<SkillResult>;
 }
 
+/**
+ * MCP server bootstrap. Wires the named skills to the MCP `tools/list` +
+ * `tools/call` handlers and runs over stdio.
+ *
+ * Architecture:
+ *   - tools/list: returns every skill's name + description + inputSchema.
+ *   - tools/call: parses input via Zod, dispatches to the skill module,
+ *     converts the SkillResult into MCP content blocks, returns to host.
+ *   - errors are translated at the boundary: provider failures, missing
+ *     API keys, unknown skills all surface as actionable MCP error
+ *     payloads (never raw stack traces).
+ */
+
+declare const PACKAGE_VERSION = "0.1.0";
+interface ServerOptions {
+    apiKey: string;
+    baseUrl?: string;
+    packageVersion?: string;
+    /** Inject for tests. Defaults to the real fetch. */
+    baseFetch?: typeof globalThis.fetch;
+}
+/**
+ * Build the configured MCP `Server` instance with handlers wired in.
+ * Caller is responsible for connecting it to a transport (stdio in
+ * production, mock in tests).
+ */
+declare function buildServer(options: ServerOptions): Server;
+/**
+ * Translate a SkillResult into MCP content blocks.
+ * The host renders these to the LLM; URLs in `assets` are surfaced as
+ * extra text blocks so the LLM can quote them directly without needing
+ * a separate `assets` shape (no MCP standard for that yet).
+ */
+declare function skillResultToMcpResponse(result: SkillResult): {
+    isError?: boolean;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+/**
+ * Convert SDK / network errors to a single actionable line. Per Eng review:
+ * users should never see raw provider stack traces; errors must include
+ * what to do next.
+ */
+declare function errorToActionableMessage(err: unknown): string;
+/**
+ * Run the server over stdio. Used by the CLI; tests use buildServer
+ * directly with a mock transport.
+ */
+declare function runStdio(options: ServerOptions): Promise<void>;
+
+/**
+ * Header-injecting wrapper around `@pixeldojo/sdk`'s PixelDojoClient.
+ *
+ * Per Eng review E2 + E3:
+ *   - Depends on @pixeldojo/sdk for run/getJob/listModels/getModelSchema
+ *     (DRY — no /api/v1 client duplication).
+ *   - Injects `x-pixeldojo-source: mcp/<version>` and `x-pixeldojo-skill:
+ *     <skill-name>` headers on every API call so Tool Health can attribute
+ *     MCP traffic separately from raw REST.
+ *
+ * The SDK exposes a `fetch` injection point in its constructor — we wrap
+ * the global `fetch` to add headers without monkey-patching anything.
+ */
+
+interface MakeClientOptions extends PixelDojoClientOptions {
+    /** MCP package version for the `x-pixeldojo-source` header value. */
+    mcpVersion: string;
+    /** Optional skill name; if set, written to `x-pixeldojo-skill`. */
+    skillName?: string;
+    /** Optional fetch override (tests). Defaults to `globalThis.fetch`. */
+    baseFetch?: typeof globalThis.fetch;
+}
+/**
+ * Build a PixelDojoClient with attribution headers baked in.
+ *
+ * Each call's headers include both the source tag and the requesting
+ * skill so the server can record per-skill error rates without the
+ * client passing skill metadata explicitly through every call.
+ */
+declare function makeAttributedClient(options: MakeClientOptions): PixelDojoClient;
+
 /**
  * Registry of all named MCP skills shipped by `@pixeldojo/mcp`.
  *
@@ -238,4 +257,4 @@ declare function makeRedactedLogger(target?: Pick<Console, 'error'>): {
     error(msg: string, ...args: unknown[]): void;
 };
 
-export { ALL_SKILLS, type MakeClientOptions, PACKAGE_VERSION, type PollOptions, type PollResult, type PollableJob, type ServerOptions, type SkillContext, type SkillModule, type SkillResult, buildServer, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio };
+export { ALL_SKILLS, type MakeClientOptions, PACKAGE_VERSION, type PollOptions, type PollResult, type PollableJob, type ServerOptions, type SkillContext, type SkillModule, type SkillResult, buildServer, errorToActionableMessage, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio, skillResultToMcpResponse };

package/dist/index.d.ts

@@ -1,70 +1,6 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { PixelDojoClientOptions, PixelDojoClient } from '@pixeldojo/sdk';
 import { z } from 'zod';
-
-/**
- * MCP server bootstrap. Wires the named skills to the MCP `tools/list` +
- * `tools/call` handlers and runs over stdio.
- *
- * Architecture:
- *   - tools/list: returns every skill's name + description + inputSchema.
- *   - tools/call: parses input via Zod, dispatches to the skill module,
- *     converts the SkillResult into MCP content blocks, returns to host.
- *   - errors are translated at the boundary: provider failures, missing
- *     API keys, unknown skills all surface as actionable MCP error
- *     payloads (never raw stack traces).
- */
-
-declare const PACKAGE_VERSION = "0.1.0";
-interface ServerOptions {
-    apiKey: string;
-    baseUrl?: string;
-    packageVersion?: string;
-    /** Inject for tests. Defaults to the real fetch. */
-    baseFetch?: typeof globalThis.fetch;
-}
-/**
- * Build the configured MCP `Server` instance with handlers wired in.
- * Caller is responsible for connecting it to a transport (stdio in
- * production, mock in tests).
- */
-declare function buildServer(options: ServerOptions): Server;
-/**
- * Run the server over stdio. Used by the CLI; tests use buildServer
- * directly with a mock transport.
- */
-declare function runStdio(options: ServerOptions): Promise<void>;
-
-/**
- * Header-injecting wrapper around `@pixeldojo/sdk`'s PixelDojoClient.
- *
- * Per Eng review E2 + E3:
- *   - Depends on @pixeldojo/sdk for run/getJob/listModels/getModelSchema
- *     (DRY — no /api/v1 client duplication).
- *   - Injects `x-pixeldojo-source: mcp/<version>` and `x-pixeldojo-skill:
- *     <skill-name>` headers on every API call so Tool Health can attribute
- *     MCP traffic separately from raw REST.
- *
- * The SDK exposes a `fetch` injection point in its constructor — we wrap
- * the global `fetch` to add headers without monkey-patching anything.
- */
-
-interface MakeClientOptions extends PixelDojoClientOptions {
-    /** MCP package version for the `x-pixeldojo-source` header value. */
-    mcpVersion: string;
-    /** Optional skill name; if set, written to `x-pixeldojo-skill`. */
-    skillName?: string;
-    /** Optional fetch override (tests). Defaults to `globalThis.fetch`. */
-    baseFetch?: typeof globalThis.fetch;
-}
-/**
- * Build a PixelDojoClient with attribution headers baked in.
- *
- * Each call's headers include both the source tag and the requesting
- * skill so the server can record per-skill error rates without the
- * client passing skill metadata explicitly through every call.
- */
-declare function makeAttributedClient(options: MakeClientOptions): PixelDojoClient;
+import { PixelDojoClient, PixelDojoClientOptions } from '@pixeldojo/sdk';
 
 /**
  * Exponential-backoff job poller with a 30-second sync window.
@@ -193,6 +129,89 @@ interface SkillModule<TInput = unknown> {
     run(input: TInput, ctx: SkillContext): Promise<SkillResult>;
 }
 
+/**
+ * MCP server bootstrap. Wires the named skills to the MCP `tools/list` +
+ * `tools/call` handlers and runs over stdio.
+ *
+ * Architecture:
+ *   - tools/list: returns every skill's name + description + inputSchema.
+ *   - tools/call: parses input via Zod, dispatches to the skill module,
+ *     converts the SkillResult into MCP content blocks, returns to host.
+ *   - errors are translated at the boundary: provider failures, missing
+ *     API keys, unknown skills all surface as actionable MCP error
+ *     payloads (never raw stack traces).
+ */
+
+declare const PACKAGE_VERSION = "0.1.0";
+interface ServerOptions {
+    apiKey: string;
+    baseUrl?: string;
+    packageVersion?: string;
+    /** Inject for tests. Defaults to the real fetch. */
+    baseFetch?: typeof globalThis.fetch;
+}
+/**
+ * Build the configured MCP `Server` instance with handlers wired in.
+ * Caller is responsible for connecting it to a transport (stdio in
+ * production, mock in tests).
+ */
+declare function buildServer(options: ServerOptions): Server;
+/**
+ * Translate a SkillResult into MCP content blocks.
+ * The host renders these to the LLM; URLs in `assets` are surfaced as
+ * extra text blocks so the LLM can quote them directly without needing
+ * a separate `assets` shape (no MCP standard for that yet).
+ */
+declare function skillResultToMcpResponse(result: SkillResult): {
+    isError?: boolean;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+/**
+ * Convert SDK / network errors to a single actionable line. Per Eng review:
+ * users should never see raw provider stack traces; errors must include
+ * what to do next.
+ */
+declare function errorToActionableMessage(err: unknown): string;
+/**
+ * Run the server over stdio. Used by the CLI; tests use buildServer
+ * directly with a mock transport.
+ */
+declare function runStdio(options: ServerOptions): Promise<void>;
+
+/**
+ * Header-injecting wrapper around `@pixeldojo/sdk`'s PixelDojoClient.
+ *
+ * Per Eng review E2 + E3:
+ *   - Depends on @pixeldojo/sdk for run/getJob/listModels/getModelSchema
+ *     (DRY — no /api/v1 client duplication).
+ *   - Injects `x-pixeldojo-source: mcp/<version>` and `x-pixeldojo-skill:
+ *     <skill-name>` headers on every API call so Tool Health can attribute
+ *     MCP traffic separately from raw REST.
+ *
+ * The SDK exposes a `fetch` injection point in its constructor — we wrap
+ * the global `fetch` to add headers without monkey-patching anything.
+ */
+
+interface MakeClientOptions extends PixelDojoClientOptions {
+    /** MCP package version for the `x-pixeldojo-source` header value. */
+    mcpVersion: string;
+    /** Optional skill name; if set, written to `x-pixeldojo-skill`. */
+    skillName?: string;
+    /** Optional fetch override (tests). Defaults to `globalThis.fetch`. */
+    baseFetch?: typeof globalThis.fetch;
+}
+/**
+ * Build a PixelDojoClient with attribution headers baked in.
+ *
+ * Each call's headers include both the source tag and the requesting
+ * skill so the server can record per-skill error rates without the
+ * client passing skill metadata explicitly through every call.
+ */
+declare function makeAttributedClient(options: MakeClientOptions): PixelDojoClient;
+
 /**
  * Registry of all named MCP skills shipped by `@pixeldojo/mcp`.
  *
@@ -238,4 +257,4 @@ declare function makeRedactedLogger(target?: Pick<Console, 'error'>): {
     error(msg: string, ...args: unknown[]): void;
 };
 
-export { ALL_SKILLS, type MakeClientOptions, PACKAGE_VERSION, type PollOptions, type PollResult, type PollableJob, type ServerOptions, type SkillContext, type SkillModule, type SkillResult, buildServer, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio };
+export { ALL_SKILLS, type MakeClientOptions, PACKAGE_VERSION, type PollOptions, type PollResult, type PollableJob, type ServerOptions, type SkillContext, type SkillModule, type SkillResult, buildServer, errorToActionableMessage, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio, skillResultToMcpResponse };