@usegraft/mcp 1.0.0-beta.2 → 1.0.0-beta.3

package/dist/index.js

@@ -184,7 +184,7 @@ var ERROR_KNOWLEDGE = {
   },
   NEEDS_DATABASE: {
     code: "NEEDS_DATABASE",
-    meaning: 'This project runs in static index mode (index = "static" in graft.config), and the requested feature is Postgres-tier: db-authoritative collections, typed functions, or database branching.',
+    meaning: 'This project runs on the static storage engine (index = "static" in graft.config), and the requested feature needs the Postgres engine: db-authoritative collections, typed functions, or database branching.',
     typicalCauses: [
       "A db-authoritative collection or a defineFunction was added to a static-mode project",
       "graft compile --branch <name> was run in static mode (branches are git branches there)"
@@ -238,6 +238,14 @@ var ERROR_KNOWLEDGE = {
     typicalCauses: ["Node older than 22.16 running the CLI or the app server"],
     howToRecover: 'Upgrade Node to 22.16+ (24 LTS recommended), or switch the project to the Postgres index (DATABASE_URL + `export const index = "postgres"`).'
   },
+  FRAMEWORK_VERSION_UNSUPPORTED: {
+    code: "FRAMEWORK_VERSION_UNSUPPORTED",
+    meaning: "An adapter API needs a newer version of the framework than the app has installed. The rest of the adapter still works.",
+    typicalCauses: [
+      "Calling `updateContent` from @usegraft/sdk-next on Next.js 15. It needs `updateTag`, which Next.js added in 16"
+    ],
+    howToRecover: "Use the fallback the error's `fix` names. For `updateContent` that is `revalidateContent(branch, changes)`, which works on Next.js 15 and 16. Or upgrade the framework."
+  },
   SLUG_NOT_UNIQUE: {
     code: "SLUG_NOT_UNIQUE",
     meaning: "Two documents in the same collection resolve to the same slug.",
@@ -389,7 +397,7 @@ var ERROR_KNOWLEDGE = {
     meaning: "`graft add` was asked for a registry item (a copy-in primitive) that does not exist.",
     typicalCauses: [
       "A typo in the item name",
-      "Expecting a community/remote item \u2014 only the bundled Tier-1 registry ships today",
+      "Expecting a community/remote item \u2014 only the bundled core registry ships today",
       "The item was renamed or removed"
     ],
     howToRecover: "The error's `details.available` lists every item you can add. Run `graft add <name>` with one of those, or build the primitive by hand as owned code under graft/."
@@ -420,7 +428,7 @@ var ERROR_KNOWLEDGE = {
       "Re-uploading with the same key instead of picking a new one",
       "Two documents' assets colliding on a generic key like assets/hero.png"
     ],
-    howToRecover: "Pick a distinct key (e.g. prefix it with the document: pages/pricing/hero.png) \u2014 that is almost always right. Only pass `overwrite: true` when replacing the existing binary is the actual intent; every document referencing that key will show the new bytes."
+    howToRecover: "Pick a distinct key (e.g. prefix it with the document: pages/pricing/hero.png) \u2014 that is almost always right. Only pass `overwrite: true` (put_asset) or `--overwrite` (graft asset put) when replacing the existing binary is the actual intent; every document referencing that key will show the new bytes."
   },
   NOT_IMPLEMENTED: {
     code: "NOT_IMPLEMENTED",
@@ -498,6 +506,10 @@ var DESTROYS = {
   idempotentHint: false,
   openWorldHint: false
 };
+var RUNS_PROJECT_CODE = {
+  ...DESTROYS,
+  openWorldHint: true
+};
 
 // src/tools/outputs.ts
 import { FunctionDescriptor, RegistryItemDescriptor, SchemaDescription } from "@usegraft/contracts";
@@ -739,7 +751,7 @@ var registerApprovalTools = (server, deps) => {
 
 // src/tools/assets.ts
 import { readFileSync } from "fs";
-import { contentTypeFor, defaultKeyFor } from "@usegraft/assets";
+import { AssetKeyTakenError, contentTypeFor, defaultKeyFor } from "@usegraft/assets";
 import { AssetRef } from "@usegraft/core";
 import { resolveContained } from "@usegraft/compiler";
 import { GraftError as GraftError3 } from "@usegraft/contracts";
@@ -827,16 +839,20 @@ var registerAssetTools = (server, deps) => {
         });
       }
       const storage = await getStorage();
-      if (overwrite !== true && await storage.exists(key)) {
-        throw new GraftError3({
-          code: "ASSET_EXISTS",
-          message: `Asset key "${key}" already holds a binary.`,
-          fix: "Pick a distinct key (the store keeps no version history), or pass overwrite: true if replacing the existing binary is the actual intent.",
-          details: { key }
-        });
-      }
+      const keyTaken = () => new GraftError3({
+        code: "ASSET_EXISTS",
+        message: `Asset key "${key}" already holds a binary.`,
+        fix: "Pick a distinct key (the store keeps no version history), or pass overwrite: true if replacing the existing binary is the actual intent.",
+        details: { key }
+      });
+      if (overwrite !== true && await storage.exists(key)) throw keyTaken();
       const type = contentType ?? contentTypeFor(key);
-      await storage.put(key, bytes, type);
+      try {
+        await storage.put(key, bytes, type, { ifAbsent: overwrite !== true });
+      } catch (error) {
+        if (error instanceof AssetKeyTakenError) throw keyTaken();
+        throw error;
+      }
       return {
         key,
         contentType: type,
@@ -1527,7 +1543,7 @@ var registerFunctionTools = (server, deps) => {
     "run_function",
     {
       title: "Run a typed function",
-      annotations: DESTROYS,
+      annotations: RUNS_PROJECT_CODE,
       description: "Invoke a defineFunction by name with a JSON input object. Same pipeline as POST /api/fn/<name>: Zod validation, access rules, rate limits, audit log, and the human gate for destructive ops. The server may already act with a configured identity (graft mcp uses GRAFT_DEV_TOKEN; over HTTP your connection's bearer is forwarded) \u2014 only pass authorization to override it. Pass approval after a human runs `graft approve <id>` for gated calls \u2014 or, where the server has opted into elicited approvals and your client supports elicitation, expect to be asked to confirm in-band and the call completes in one step. The gate is the same either way. Success returns { data, correlationId }; failures are GraftError JSON with a fix.",
       inputSchema: {
         name: z8.string().describe("Function name (defineFunction name, not the export key)"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usegraft/mcp",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.3",
   "description": "An MCP server over your content, schema and typed functions, with errors an agent can act on.",
   "keywords": [
     "agent",
@@ -39,13 +39,13 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@usegraft/assets": "1.0.0-beta.2",
-    "@usegraft/compiler": "1.0.0-beta.2",
-    "@usegraft/contracts": "1.0.0-beta.2",
-    "@usegraft/core": "1.0.0-beta.2",
-    "@usegraft/db": "1.0.0-beta.2",
-    "@usegraft/mdx-safety": "1.0.0-beta.2",
-    "@usegraft/registry": "1.0.0-beta.2",
+    "@usegraft/assets": "1.0.0-beta.3",
+    "@usegraft/compiler": "1.0.0-beta.3",
+    "@usegraft/contracts": "1.0.0-beta.3",
+    "@usegraft/core": "1.0.0-beta.3",
+    "@usegraft/db": "1.0.0-beta.3",
+    "@usegraft/mdx-safety": "1.0.0-beta.3",
+    "@usegraft/registry": "1.0.0-beta.3",
     "gray-matter": "^4.0.3",
     "zod": "^4.5.4"
   },