@agent-native/core 0.173.1-nightly-20260825142811 → 0.173.1

package/corpus/templates/clips/actions/update-meeting.ts

@@ -2,7 +2,7 @@
  * Update a meeting's metadata. Editor access required.
  */
 
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq } from "drizzle-orm";

package/corpus/templates/clips/actions/update-member-role.ts

@@ -9,7 +9,7 @@
  *   pnpm action update-member-role --email=alice@example.com --role=admin
  */
 
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { orgMembers } from "@agent-native/core/org";
 import { and, eq, sql } from "drizzle-orm";

package/corpus/templates/clips/actions/update-recording.ts

@@ -6,7 +6,7 @@
  *   pnpm action update-recording --id=<id> --title="New title"
  */
 
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { assertAccess } from "@agent-native/core/sharing";
 import { eq } from "drizzle-orm";

package/corpus/templates/clips/actions/update-rewind-extension-request.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import {
   readAppState,
   writeAppState,

package/corpus/templates/clips/actions/view-screen.ts

@@ -10,7 +10,7 @@
  *   pnpm action view-screen
  */
 
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import {
   readAppState,
   readAppStateForCurrentTab,

package/corpus/templates/content/.agents/skills/actions/SKILL.md

@@ -120,8 +120,12 @@ Everything else — CRUD, settings, search, list/detail reads, auth state, anyth
 ## Do / Don't
 
 - **Do** keep one action, one job; document a reusable action (when to use it, key args, return fields to preserve) in `AGENTS.md` once it's called from outside one narrow screen; promote workflow-heavy actions (provider-backed, cross-app, MCP/A2A, multi-step) into a skill.
-- **Do** use `fail()` for user-friendly errors and import primitives from `@agent-native/core`(`/action`) instead of redefining them; use the core `upload-image` action or `uploadFile()` for durable images/files — never base64 into SQL, markdown, or action results.
+- **Do** use `fail(message, { errorCode, statusCode })` for user-friendly errors and import primitives from `@agent-native/core`(`/action`) instead of redefining them; use the core `upload-image` action or `uploadFile()` for durable images/files — never base64 into SQL, markdown, or action results.
 - **Do** signal failure by throwing (`fail()`), never by returning `{ error: ... }`. A returned envelope is a successful return everywhere the framework looks: the retry breakers (`MAX_IDENTICAL_TOOL_ERRORS`, `MAX_SAME_ERROR_ACROSS_ARGUMENTS`) never count it, the call is recorded `completedSideEffect: true` even though nothing was written, and `failed_tools` / `$ai_is_error` stay clean while the model keeps guessing. One production run spent 32% of its cost on three rejected writes that every dashboard reported as successes.
+- **Do** throw through `fail()` rather than `throw new Error()` whenever the message is written for whoever called. The agent reads either one, but the HTTP route can only tell them apart by type: `fail()` raises an `ActionContractError`, whose message, `errorCode`, and `details` reach the browser, while a bare `Error` is indistinguishable from a driver blowup and is replaced by a generic 500 `"Internal server error"` plus an error-tracking report. Keep the bare throw for genuine internal faults — that is what the 500 is for.
+- **Do** give `fail()` the status that matches the cause: it defaults to `400`, and `useActionQuery` retries only `429`, `502`, `503`, and `504`. A refusal sent as `404` or `409` costs one round trip; sent as a `500` (or thrown bare) it used to cost four, plus four duplicate error reports.
+- **Do** render `actionErrorMessage(error) ?? yourCopy` in UI, never bare `error.message`. The message keeps an `Action <name> failed:` prefix that belongs in a console, so a toast built from it reads "Action update-brand-kit failed: That name is taken." The helper returns only what the action wrote, and `undefined` when nothing did (network drop, proxy HTML page), which is why the fallback is not optional.
+- **Do** pass a real `errorCode` when the agent should branch on the failure rather than re-read it. Codes other than the default `action_failed` are appended to the tool result as `(errorCode: not_found)`, on both the in-app agent and MCP; `details` and the status never reach either.
 - **Don't** re-export actions as REST — `/_agent-native/actions/:name` is already the REST surface; duplicating it under `/api/*` hides the operation from agents.
 - **Don't** reach for provider integrations, `outputSchema`, `authorize`, `needsApproval`, or `_agentImages` without checking `references/` first — each has sharp edges covered there, not here.
 

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

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { getRequestUserEmail } from "@agent-native/core/server";
 import { assertAccess } from "@agent-native/core/sharing";
 import { z } from "zod";

package/corpus/templates/content/actions/add-content-database-source-field-property.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { getDialect } from "@agent-native/core/db";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq, isNull, sql } from "drizzle-orm";

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

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { buildDeepLink } from "@agent-native/core/server";
 import { z } from "zod";
 

package/corpus/templates/content/actions/attach-content-database-source.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { assertAccess } from "@agent-native/core/sharing";
 import { eq } from "drizzle-orm";
 import { z } from "zod";

package/corpus/templates/content/actions/backfill-content-files.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { z } from "zod";

package/corpus/templates/content/actions/bind-content-database-source-field.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq, inArray, isNull, ne, sql } from "drizzle-orm";
 import { z } from "zod";

package/corpus/templates/content/actions/cancel-prepared-builder-source-update.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq, inArray } from "drizzle-orm";

package/corpus/templates/content/actions/change-content-database-source-role.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, asc, eq, inArray, isNull, ne, sql } from "drizzle-orm";
 import { z } from "zod";

package/corpus/templates/content/actions/check-builder-doc.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
 import { checkBuilderDocsSource } from "./_builder-docs-client.js";

package/corpus/templates/content/actions/clone-creative-context-document.ts

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import {
   readPrivateBlob,
   type PrivateBlobHandle,

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

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq, sql } from "drizzle-orm";

package/corpus/templates/content/actions/connect-local-folder-source.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { and, eq } from "drizzle-orm";

package/corpus/templates/content/actions/connect-notion-status.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { resolveSecret } from "@agent-native/core/server";
 import { z } from "zod";
 

package/corpus/templates/content/actions/create-and-link-notion-page.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
 import { createAndLinkNotionPage } from "../server/lib/notion-sync.js";

package/corpus/templates/content/actions/create-content-space.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { z } from "zod";
 

package/corpus/templates/content/actions/create-inline-content-database.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { eq } from "drizzle-orm";
 import { z } from "zod";

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

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { assertAccess } from "@agent-native/core/sharing";

package/corpus/templates/content/actions/delete-content-database.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { assertAccess } from "@agent-native/core/sharing";
 import { z } from "zod";

package/corpus/templates/content/actions/delete-content-space.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";
 

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

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq, inArray } from "drizzle-orm";

package/corpus/templates/content/actions/delete-document.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq, inArray, isNotNull, isNull, ne, or } from "drizzle-orm";

package/corpus/templates/content/actions/describe-content-database.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { accessFilter } from "@agent-native/core/sharing";
 import { and, eq } from "drizzle-orm";
 import { z } from "zod";

package/corpus/templates/content/actions/disconnect-content-database-source.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq } from "drizzle-orm";
 import { z } from "zod";

package/corpus/templates/content/actions/disconnect-local-folder-source.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { and, eq, inArray, ne } from "drizzle-orm";
 import { z } from "zod";

package/corpus/templates/content/actions/disconnect-notion.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
 import { disconnectNotionForOwner } from "../server/lib/notion.js";

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

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { assertAccess } from "@agent-native/core/sharing";

package/corpus/templates/content/actions/duplicate-database-items.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { assertAccess } from "@agent-native/core/sharing";

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

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq, sql } from "drizzle-orm";

package/corpus/templates/content/actions/edit-document.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import {
   agentTouchDocument,

package/corpus/templates/content/actions/ensure-content-spaces.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { z } from "zod";

package/corpus/templates/content/actions/execute-builder-source-batch.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { assertAccess } from "@agent-native/core/sharing";
 import { z } from "zod";
 

package/corpus/templates/content/actions/execute-builder-source-execution.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { assertAccess } from "@agent-native/core/sharing";
 import { and, eq, lt, notInArray, or } from "drizzle-orm";
 import { z } from "zod";

package/corpus/templates/content/actions/export-content-source.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { accessFilter } from "@agent-native/core/sharing";
 import { and, asc, eq, inArray } from "drizzle-orm";
 import { z } from "zod";

package/corpus/templates/content/actions/export-document.ts

@@ -1,11 +1,18 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { buildDeepLink } from "@agent-native/core/server";
-import { resolveAccess } from "@agent-native/core/sharing";
-import { asc, eq } from "drizzle-orm";
+import { getRequestUserEmail } from "@agent-native/core/server/request-context";
+import { accessFilter, resolveAccess } from "@agent-native/core/sharing";
+import { and, asc, eq, isNull, or } from "drizzle-orm";
 import { z } from "zod";
 
 import { getDb, schema } from "../server/db/index.js";
+import type {
+  ContentDatabaseItem,
+  ContentDatabaseTableQuery,
+} from "../shared/api.js";
 import { blocksContentHash } from "../shared/blocks-field-identity.js";
+import { renderDatabaseCsv } from "../shared/database-csv-export.js";
+import { applyContentDatabaseTableQuery } from "../shared/database-query.js";
 import {
   buildDocumentExport,
   collectionItemsMarkdown,
@@ -16,11 +23,221 @@ import {
   isPrimaryBlocksField,
 } from "../shared/properties.js";
 import { resolveContentDocumentAccess } from "./_content-document-access.js";
-import { getDatabaseByDocumentId } from "./_database-utils.js";
-import { listPropertiesForAllDocumentDatabases } from "./_property-utils.js";
+import { listContentOrganizationMemberships } from "./_content-space-access.js";
+import {
+  CONTENT_DATABASE_MAX_READ_LIMIT,
+  getDatabaseByDocumentId,
+} from "./_database-utils.js";
+import {
+  listPropertiesForAllDocumentDatabases,
+  listPropertiesForDatabase,
+  listPropertiesForDatabaseDocuments,
+  parseDatabaseViewConfig,
+} from "./_property-utils.js";
 
 const COLLECTION_EXPORT_ACCESS_CONCURRENCY = 8;
 
+const collectionSchema = z.object({
+  scope: z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("all_members") }),
+    z.object({
+      kind: z.literal("current_view"),
+      viewId: z.string().min(1),
+      query: z.object({
+        search: z.string().max(500),
+        filters: z
+          .array(
+            z.object({
+              key: z.string(),
+              label: z.string(),
+              operator: z.enum([
+                "contains",
+                "equals",
+                "does_not_equal",
+                "greater_than",
+                "less_than",
+                "before",
+                "after",
+                "between",
+                "is_checked",
+                "is_unchecked",
+                "is_empty",
+                "is_not_empty",
+              ]),
+              value: z.string(),
+              filterGroupId: z.string().optional(),
+              parentFilterGroupId: z.string().optional(),
+            }),
+          )
+          .max(50),
+        sorts: z
+          .array(
+            z.object({
+              key: z.string(),
+              label: z.string(),
+              direction: z.enum(["asc", "desc"]),
+            }),
+          )
+          .max(20),
+        filterMode: z.enum(["and", "or"]),
+      }),
+    }),
+  ]),
+  propertyIds: z.array(z.string().min(1)).max(200),
+});
+
+type CollectionExport = z.infer<typeof collectionSchema>;
+
+function assertValidQuery(
+  query: ContentDatabaseTableQuery,
+  propertyIds: ReadonlySet<string>,
+) {
+  for (const key of [...query.filters, ...query.sorts].map(({ key }) => key)) {
+    if (key !== "name" && !propertyIds.has(key)) {
+      throw new Error(`Unknown database property "${key}" in export query`);
+    }
+  }
+}
+
+async function databaseCsvContent(
+  documentId: string,
+  collection: CollectionExport,
+) {
+  const database = await getDatabaseByDocumentId(documentId);
+  if (!database) throw new Error("CSV export requires a database document");
+
+  const properties = await listPropertiesForDatabase(database.id);
+  const propertyById = new Map(
+    properties.map((property) => [property.definition.id, property]),
+  );
+  if (new Set(collection.propertyIds).size !== collection.propertyIds.length) {
+    throw new Error("CSV export property IDs must be unique");
+  }
+  const selectedProperties = collection.propertyIds.map((propertyId) => {
+    const property = propertyById.get(propertyId);
+    if (!property) throw new Error(`Unknown database property "${propertyId}"`);
+    return property;
+  });
+
+  const query =
+    collection.scope.kind === "current_view" ? collection.scope.query : null;
+  const scope = collection.scope;
+  if (scope.kind === "current_view") {
+    const view = parseDatabaseViewConfig(database.viewConfigJson).views.find(
+      (candidate) => candidate.id === scope.viewId,
+    );
+    if (!view) throw new Error(`Database view "${scope.viewId}" not found`);
+    assertValidQuery(query!, new Set(propertyById.keys()));
+  }
+  const blocksAreNeeded =
+    selectedProperties.some((property) =>
+      isBlocksPropertyType(property.definition.type),
+    ) ||
+    (!!query &&
+      (query.search.trim().length > 0 ||
+        [...query.filters, ...query.sorts].some((constraint) => {
+          const property = propertyById.get(constraint.key);
+          return !!property && isBlocksPropertyType(property.definition.type);
+        })));
+
+  const userEmail = getRequestUserEmail();
+  const memberships = userEmail
+    ? await listContentOrganizationMemberships(userEmail)
+    : [];
+  const accessClauses = [accessFilter(schema.documents, schema.documentShares)];
+  for (const membership of memberships) {
+    accessClauses.push(
+      accessFilter(schema.documents, schema.documentShares, {
+        userEmail: userEmail!,
+        orgId: membership.orgId,
+      }),
+    );
+  }
+  const rows = await getDb()
+    .select({
+      item: schema.contentDatabaseItems,
+      document: schema.documents,
+    })
+    .from(schema.contentDatabaseItems)
+    .innerJoin(
+      schema.documents,
+      eq(schema.documents.id, schema.contentDatabaseItems.documentId),
+    )
+    .where(
+      and(
+        eq(schema.contentDatabaseItems.databaseId, database.id),
+        isNull(schema.documents.trashedAt),
+        or(...accessClauses),
+      ),
+    )
+    .orderBy(
+      asc(schema.contentDatabaseItems.position),
+      asc(schema.contentDatabaseItems.createdAt),
+      asc(schema.contentDatabaseItems.id),
+    )
+    .limit(CONTENT_DATABASE_MAX_READ_LIMIT + 1);
+  if (rows.length > CONTENT_DATABASE_MAX_READ_LIMIT) {
+    throw new Error(
+      `CSV export supports up to ${CONTENT_DATABASE_MAX_READ_LIMIT} accessible rows.`,
+    );
+  }
+  if (blocksAreNeeded) {
+    for (const { item } of rows) {
+      if (
+        item.bodyHydrationStatus !== "hydrated" &&
+        item.bodyHydrationStatus !== "unavailable"
+      ) {
+        throw new Error(
+          `Database item "${item.documentId}" is not ready for export`,
+        );
+      }
+    }
+  }
+  const documents = rows.map((row) => row.document);
+  const propertiesByDocumentId = await listPropertiesForDatabaseDocuments(
+    database.id,
+    documents,
+  );
+  const queryItems: ContentDatabaseItem[] = rows.map((row) => ({
+    id: row.item.id,
+    databaseId: row.item.databaseId,
+    document: {
+      id: row.document.id,
+      parentId: row.document.parentId,
+      title: row.document.title,
+      content: row.document.content,
+      description: row.document.description ?? undefined,
+      icon: row.document.icon,
+      position: row.document.position,
+      isFavorite: row.document.isFavorite === 1,
+      hideFromSearch: row.document.hideFromSearch === 1,
+      createdAt: row.document.createdAt,
+      updatedAt: row.document.updatedAt,
+    },
+    position: row.item.position,
+    properties: propertiesByDocumentId.get(row.document.id) ?? [],
+  }));
+  const selectedRows = query
+    ? applyContentDatabaseTableQuery(queryItems, properties, query)
+    : queryItems;
+  return renderDatabaseCsv(
+    selectedProperties.map((property) => ({
+      id: property.definition.id,
+      name: property.definition.name,
+      property,
+    })),
+    selectedRows.map((row) => ({
+      title: row.document.title,
+      values: new Map(
+        row.properties.map((property) => [
+          property.definition.id,
+          property.value,
+        ]),
+      ),
+    })),
+  );
+}
+
 async function databaseExportContent(documentId: string) {
   const database = await getDatabaseByDocumentId(documentId);
   if (!database) return null;
@@ -82,9 +299,12 @@ export default defineAction({
   schema: z.object({
     id: z.string().describe("Document ID (required)"),
     format: z
-      .enum(["pdf", "markdown", "html"])
+      .enum(["pdf", "markdown", "html", "csv"])
       .default("pdf")
-      .describe("Export format: pdf, markdown, or html."),
+      .describe("Export format: pdf, markdown, html, or csv."),
+    collection: collectionSchema
+      .optional()
+      .describe("Database CSV export scope and selected property IDs."),
     title: z
       .string()
       .max(500)
@@ -98,11 +318,35 @@ export default defineAction({
   }),
   readOnly: true,
   publicAgent: { expose: true, readOnly: true, requiresAuth: true },
-  run: async ({ id, format, title, content }) => {
+  run: async ({ id, format, title, content, collection }) => {
     const access = await resolveAccess("document", id);
     if (!access) throw new Error(`Document "${id}" not found`);
 
     const doc = access.resource;
+    if (format === "csv") {
+      if (!collection)
+        throw new Error("CSV export requires collection options");
+      const content = await databaseCsvContent(doc.id, collection);
+      return {
+        id: doc.id,
+        title: doc.title || "Untitled",
+        format,
+        filename: `${
+          (doc.title || "untitled")
+            .replace(/[^a-z0-9]+/gi, "-")
+            .replace(/^-+|-+$/g, "")
+            .toLowerCase() || "untitled"
+        }.csv`,
+        mimeType: "text/csv;charset=utf-8",
+        content,
+        print: false,
+        deepLink: buildDeepLink({
+          app: "content",
+          view: "editor",
+          params: { documentId: doc.id },
+        }),
+      };
+    }
     const properties = await listPropertiesForAllDocumentDatabases(doc);
     const blocksFields = properties
       .filter((property) => isBlocksPropertyType(property.definition.type))

package/corpus/templates/content/actions/get-content-database-personal-view.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
 import {

package/corpus/templates/content/actions/get-content-database-source.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { resolveAccess } from "@agent-native/core/sharing";
 import { z } from "zod";
 

package/corpus/templates/content/actions/get-content-database.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
 import type {

package/corpus/templates/content/actions/get-document.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import { buildDeepLink } from "@agent-native/core/server";
 import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { resolveAccess, roleSatisfies } from "@agent-native/core/sharing";

package/corpus/templates/content/actions/get-preview-document-draft.ts

@@ -1,4 +1,4 @@
-import { defineAction } from "@agent-native/core";
+import { defineAction } from "@agent-native/core/action";
 import {
   getRequestOrgId,
   getRequestUserEmail,