@shipstatic/mcp 2.8.0-beta.3 → 2.8.0-beta.5

package/dist/call.d.ts

@@ -74,4 +74,19 @@ export interface AuthFailure {
  * kept equal by review.
  */
 export declare function createCall(options: CallOptions): CallFn;
+/**
+ * Where an error result carries the wire's own `ErrorResponse`: a key of the
+ * result's `_meta`, named under the platform's domain as the specification
+ * asks of a `_meta` key.
+ *
+ * Not `structuredContent`, because that field belongs to the tool's
+ * `outputSchema`, which describes a SUCCESS. The specification's error example
+ * carries no structure, and the TypeScript SDK's client validates
+ * `structuredContent` against the output schema even on an `isError` result
+ * (modelcontextprotocol/typescript-sdk#1943, fix open as #1945), so a client
+ * built on it shows "Structured content does not match the tool's output
+ * schema" instead of the refusal. `_meta` is read by whoever asks for it and
+ * validated by nobody, and the deploy card reads its notice from here.
+ */
+export declare const ERROR_META_KEY = "com.shipstatic/error";
 export declare const call: CallFn;

package/dist/call.js

@@ -80,29 +80,35 @@ function requiredScopeOf(details) {
 function isPlainObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+/**
+ * Where an error result carries the wire's own `ErrorResponse`: a key of the
+ * result's `_meta`, named under the platform's domain as the specification
+ * asks of a `_meta` key.
+ *
+ * Not `structuredContent`, because that field belongs to the tool's
+ * `outputSchema`, which describes a SUCCESS. The specification's error example
+ * carries no structure, and the TypeScript SDK's client validates
+ * `structuredContent` against the output schema even on an `isError` result
+ * (modelcontextprotocol/typescript-sdk#1943, fix open as #1945), so a client
+ * built on it shows "Structured content does not match the tool's output
+ * schema" instead of the refusal. `_meta` is read by whoever asks for it and
+ * validated by nobody, and the deploy card reads its notice from here.
+ */
+export const ERROR_META_KEY = 'com.shipstatic/error';
 /**
  * The failure envelope: authoritative prose, with the wire's own structure
  * riding beside it.
  *
- * The TEXT is unchanged and stays the contract — hints included. It has to be:
- * the API authors its messages for the end user at the throw site
- * (`cloudflare/api/CLAUDE.md`, "Message authoring law"), so the sentence
- * always contains what the agent needs, and a client that ignores everything
- * else still works.
- *
- * `structuredContent` carries `ShipError.toResponse()` verbatim — the same
- * `ErrorResponse` the wire itself uses. Until 1.0.0-beta.8 the typed contract
- * terminated here: `status`, `ErrorType`, and every `details` payload except
- * the Validation arm's were dropped, so the platform's own law — *clients
- * branch on error type and status, never on message strings* — held for every
- * consumer EXCEPT the one best equipped to obey it. The recorded bite was a
- * 429: `details.expires` died at this boundary, leaving the caller most in
- * need of a precise backoff to parse "try again in 9 minutes" out of English.
+ * The TEXT is the contract, hints included. The API authors its messages for
+ * the end user at the throw site (`cloudflare/api/CLAUDE.md`, "Message
+ * authoring law"), so the sentence always contains what the agent needs, and
+ * a client that reads nothing else still works.
  *
- * Safe on every arm, and checked rather than assumed: the MCP SDK validates
- * `structuredContent` against a declared `outputSchema` only when `isError`
- * is not set, so an error envelope never meets a success schema. Every tool
- * declares one (imported from the constitution), and this arm is unaffected.
+ * `_meta[ERROR_META_KEY]` carries `ShipError.toResponse()` verbatim, the same
+ * `ErrorResponse` the wire uses, so a client that branches on error type and
+ * status (the platform's law: never on message strings) reads exactly what
+ * every other client sees, `details` included: a 429's `details.expires` is
+ * the precise backoff its sentence rounds into words.
  */
 function toErrorResult(error, hints, onAuthFailure) {
     if (isShipError(error)) {
@@ -131,7 +137,7 @@ function toErrorResult(error, hints, onAuthFailure) {
         }
         return {
             content: [{ type: 'text', text: message }],
-            structuredContent: { ...error.toResponse() },
+            _meta: { [ERROR_META_KEY]: { ...error.toResponse() } },
             isError: true,
         };
     }

package/dist/index.d.ts

@@ -64,7 +64,7 @@
  * extra — because adding an export is the quiet failure: everything published
  * becomes a breaking change to remove.
  */
-export { type AuthFailure, type CallFn, type CallOptions, createCall, type ErrorHints, } from './call.js';
+export { type AuthFailure, type CallFn, type CallOptions, createCall, ERROR_META_KEY, type ErrorHints, } from './call.js';
 export { createServer } from './server.js';
 export { ACCOUNT_TOOL_NAMES, type AccountToolName, registerAccountTools, TOOLS, type ToolName, } from './tools.js';
 export { annotate, DESCRIPTION_BLOCKS, INSTRUCTION_BLOCKS, PARAM_DESCRIPTIONS, PUBLIC_EXPIRY, SERVER_INFO, SERVER_NAME, type ToolContract, titled, UPLOAD_TOOL_NAME, UPLOAD_TOOL_TITLE, } from './vocabulary.js';

package/dist/index.js

@@ -64,7 +64,7 @@
  * extra — because adding an export is the quiet failure: everything published
  * becomes a breaking change to remove.
  */
-export { createCall, } from './call.js';
+export { createCall, ERROR_META_KEY, } from './call.js';
 export { createServer } from './server.js';
 export { ACCOUNT_TOOL_NAMES, registerAccountTools, TOOLS, } from './tools.js';
 export { annotate, DESCRIPTION_BLOCKS, INSTRUCTION_BLOCKS, PARAM_DESCRIPTIONS, PUBLIC_EXPIRY, SERVER_INFO, SERVER_NAME, titled, UPLOAD_TOOL_NAME, UPLOAD_TOOL_TITLE, } from './vocabulary.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipstatic/mcp",
-  "version": "2.8.0-beta.3",
+  "version": "2.8.0-beta.5",
   "description": "Deploy static websites, landing pages, and prototypes instantly. Free, no account needed. Start with the hosted endpoint at mcp.shipstatic.com, or run the same fifteen tools on your own machine with this package.",
   "type": "module",
   "main": "./dist/index.js",
@@ -67,8 +67,8 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@shipstatic/ship": "3.10.0-beta.3",
-    "@shipstatic/types": "3.15.0-beta.3",
+    "@shipstatic/ship": "3.10.0-beta.4",
+    "@shipstatic/types": "3.15.0-beta.4",
     "zod": "^4.4.3"
   },
   "devDependencies": {