@homespunapps/mcp 1.6.26 → 1.6.28

package/README.md

@@ -107,7 +107,7 @@ To keep the tool list compact (a flat 50+ tools would bloat client context and d
 | `deploy_app` | Deploy a v2 app: an HTML document plus a capability manifest, hosted at its own URL. Omit `app_id` to create, pass it to redeploy in place (same URL, same data, same members). Takes `html` or `html_path`, optional `assets`, `visibility`, `slug`, `dry_run`, `force`. |
 | `list_rows` | List rows in a collection. Doubles as the poll for a collection's current state: pass the prior `next_cursor` as `since`. |
 | `get_row` | Fetch one row by `key` (a dedicated relay route, not a client-side scan). |
-| `upsert_row` | Create a row, or return the existing one if `key` is already present (`deduped: true`). The only create-shaped verb. |
+| `upsert_row` | Create a row, or return the existing one if `key` is already present (`deduped: true`), or `row_not_found` when the collection's `read` list does not reach that row for you. The only create-shaped verb. |
 | `update_row` | Replace an existing row's `data`. Optional `if_match` optimistic lock. |
 | `delete_row` | Soft-delete a row. Optional `if_match`. |
 | `get_feed_events` | Poll the app's change feed for row creates/updates/deletes from any writer, human or agent. Optional `wait` (0-30s) long-poll. |

package/dist/tools.js

@@ -240,7 +240,7 @@ const upsertRowShape = {
     key: z
         .string()
         .optional()
-        .describe("Optional stable key. Reusing an existing key returns the existing row (deduped:true)."),
+        .describe("Optional stable key. Reusing an existing key returns the existing row (deduped:true), or row_not_found when the collection's read list does not reach that row for you."),
     data: jsonValueSchema.describe("The row body - any JSON value valid against the collection's row schema (an object, or any JSON value for a schemaless collection)."),
 };
 const updateRowShape = {
@@ -894,7 +894,7 @@ export const TOOLS = [
     },
     {
         name: "upsert_row",
-        description: "Create a row in a v2 app's collection, or return the existing row if `key` is already present (deduped:true). This is the ONLY create-shaped verb for app rows (no separate strict create). Omit `key` to add a new row (server-generates one); pass `key` to ensure a row exists at that key. The collection must be declared in the app's manifest with 'agent' in its `write` list, the list that gates creates. Returns { row, deduped? }.",
+        description: "Create a row in a v2 app's collection, or return the existing row if `key` is already present (deduped:true). This is the ONLY create-shaped verb for app rows (no separate strict create). Omit `key` to add a new row (server-generates one); pass `key` to ensure a row exists at that key. The collection must be declared in the app's manifest with 'agent' in its `write` list, the list that gates creates. If `key` matches a row the collection's `read` list does not reach for you, the answer is row_not_found rather than the row, matching what get_row would say, so this verb never reads past `read`. Returns { row, deduped? }.",
         inputSchema: upsertRowShape,
         annotations: {
             title: "Upsert Row",

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.6.26";
+export declare const VERSION = "1.6.28";

package/dist/version.js

@@ -1,3 +1,3 @@
 // Single source of the package version, reported in the MCP server's
 // serverInfo. Kept in sync with package.json by the release tooling.
-export const VERSION = "1.6.26";
+export const VERSION = "1.6.28";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@homespunapps/mcp",
   "mcpName": "dev.homespun/homespun",
-  "version": "1.6.26",
+  "version": "1.6.28",
   "description": "Model Context Protocol (stdio) server for Homespun: lets any MCP client (Claude Desktop, Cursor, …) deploy a multi-user web app with hosting, auth, a shared database and permissions included.",
   "license": "MIT",
   "type": "module",
@@ -46,7 +46,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.0",
-    "@homespunapps/core": "^1.6.26",
+    "@homespunapps/core": "^1.6.28",
     "zod": "^4.4.3"
   },
   "devDependencies": {

package/server.json

@@ -3,14 +3,14 @@
   "name": "dev.homespun/homespun",
   "title": "Homespun",
   "description": "Deploy a multi-user web app from your agent: hosting, auth, database, and permissions.",
-  "version": "1.6.26",
+  "version": "1.6.28",
   "websiteUrl": "https://docs.homespun.dev",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@homespunapps/mcp",
-      "version": "1.6.26",
+      "version": "1.6.28",
       "transport": {
         "type": "stdio"
       },