@agent-native/core 0.154.4 → 0.155.0

package/corpus/templates/content/actions/set-document-property.ts

@@ -226,7 +226,10 @@ export default defineAction({
         database.id,
       );
       const [lockedDatabase] = await tx
-        .select({ id: schema.contentDatabases.id })
+        .select({
+          id: schema.contentDatabases.id,
+          naturalKeyPropertyId: schema.contentDatabases.naturalKeyPropertyId,
+        })
         .from(schema.contentDatabases)
         .where(
           and(
@@ -272,6 +275,41 @@ export default defineAction({
       if (isComputedPropertyType(lockedType)) {
         throw new Error("Computed properties cannot be edited.");
       }
+      const isNaturalKey = lockedDatabase.naturalKeyPropertyId === propertyId;
+      if (isNaturalKey) {
+        let parsed: unknown;
+        try {
+          parsed = JSON.parse(valueJson);
+        } catch {
+          parsed = null;
+        }
+        if (typeof parsed !== "string" || !parsed.trim()) {
+          throw new Error(
+            "A database natural key must remain a non-empty string.",
+          );
+        }
+        const [existingNaturalKeyClaim] = await tx
+          .select({
+            keyValueJson: schema.contentDatabaseItemKeyClaims.keyValueJson,
+          })
+          .from(schema.contentDatabaseItemKeyClaims)
+          .where(
+            and(
+              eq(schema.contentDatabaseItemKeyClaims.databaseId, database.id),
+              eq(schema.contentDatabaseItemKeyClaims.propertyId, propertyId),
+              eq(schema.contentDatabaseItemKeyClaims.documentId, documentId),
+            ),
+          )
+          .limit(1);
+        if (
+          existingNaturalKeyClaim &&
+          existingNaturalKeyClaim.keyValueJson !== valueJson
+        ) {
+          throw new Error(
+            "A claimed database natural key cannot be changed. Create a new row instead.",
+          );
+        }
+      }
       const [conflictingClaim] = await tx
         .select({ id: schema.contentDatabaseItemKeyClaims.id })
         .from(schema.contentDatabaseItemKeyClaims)
@@ -314,6 +352,45 @@ export default defineAction({
           updatedAt: now,
         });
       }
+      if (isNaturalKey) {
+        await tx
+          .insert(schema.contentDatabaseItemKeyClaims)
+          .values({
+            id: nanoid(),
+            ownerEmail: database.ownerEmail,
+            orgId: database.orgId,
+            databaseId: database.id,
+            propertyId,
+            keyValueJson: valueJson,
+            itemId: membership.id,
+            documentId,
+            createdAt: now,
+            updatedAt: now,
+          })
+          .onConflictDoNothing();
+        const [claim] = await tx
+          .select({
+            itemId: schema.contentDatabaseItemKeyClaims.itemId,
+            documentId: schema.contentDatabaseItemKeyClaims.documentId,
+          })
+          .from(schema.contentDatabaseItemKeyClaims)
+          .where(
+            and(
+              eq(schema.contentDatabaseItemKeyClaims.databaseId, database.id),
+              eq(schema.contentDatabaseItemKeyClaims.propertyId, propertyId),
+              eq(schema.contentDatabaseItemKeyClaims.keyValueJson, valueJson),
+            ),
+          );
+        if (
+          !claim ||
+          claim.itemId !== membership.id ||
+          claim.documentId !== documentId
+        ) {
+          throw new Error(
+            "This natural key is already claimed by another database row.",
+          );
+        }
+      }
       await tx
         .delete(schema.contentDatabaseItemKeyClaims)
         .where(

package/corpus/templates/content/actions/update-comment.ts

@@ -9,7 +9,7 @@ import { getDb, schema } from "../server/db/index.js";
 
 export default defineAction({
   description:
-    "Update a document comment. Resolving or reopening a comment applies to the full thread.",
+    "Update a document comment. Comment text supports inline Markdown without headings. Resolving or reopening a comment applies to the full thread.",
   schema: z.object({
     id: z.string().describe("Comment ID"),
     documentId: z.string().optional().describe("Document ID"),

package/corpus/templates/content/actions/update-database-item.ts

@@ -0,0 +1,62 @@
+import { defineAction } from "@agent-native/core";
+import { buildDeepLink } from "@agent-native/core/server";
+import { z } from "zod";
+
+import type { ContentDatabaseRowMutationResult } from "../shared/api.js";
+import {
+  databaseMutationEnvelopeSchema,
+  updateDatabaseRow,
+} from "./_database-row-mutation.js";
+
+const schema = databaseMutationEnvelopeSchema.extend({
+  itemId: z.string().min(1).describe("Exact database membership row ID"),
+  documentId: z.string().min(1).describe("Exact row page ID"),
+  expectedRowRevision: z
+    .string()
+    .min(1)
+    .describe("Row revision returned by get-content-database"),
+  title: z.string().trim().min(1).max(500).optional(),
+  propertyValues: z
+    .record(z.string(), z.unknown())
+    .optional()
+    .describe(
+      "Sparse strict patch keyed by property definition ID; omitted fields are preserved and explicit null clears a value",
+    ),
+});
+
+export default defineAction({
+  description:
+    "Sparsely update one exact Content database row by stable item and document IDs. Requires schema and row revisions, validates every non-Blocks property, and returns a verified idempotent receipt.",
+  schema,
+  http: { method: "PUT" },
+  audit: {
+    recordInputs: false,
+    target: (args) => ({
+      type: "document",
+      id: args.documentId,
+      visibility: "private",
+    }),
+    summary: (_args, result) => {
+      const receipt = (result as ContentDatabaseRowMutationResult | null)
+        ?.receipt;
+      return receipt
+        ? `${receipt.outcome === "unchanged" ? "Checked" : "Updated"} Content database row ${receipt.row.itemId}`
+        : "Updated Content database row";
+    },
+  },
+  run: updateDatabaseRow,
+  link: ({ result }) => {
+    const documentId = (result as ContentDatabaseRowMutationResult | null)
+      ?.receipt.row.documentId;
+    if (!documentId) return null;
+    return {
+      url: buildDeepLink({
+        app: "content",
+        view: "editor",
+        params: { documentId },
+      }),
+      label: "Open database row",
+      view: "editor",
+    };
+  },
+});