convex-cms 0.0.1

package/dist/client/agentTools.d.ts

@@ -0,0 +1,933 @@
+/**
+ * @convex-cms/core Agent Tools
+ *
+ * Tool-compatible function wrappers for @convex-dev/agent integration.
+ * Provides structured tool definitions with clear parameter schemas for
+ * content creation, querying, and management.
+ *
+ * @example
+ * ```typescript
+ * import { Agent } from "@convex-dev/agent";
+ * import { createCmsTools } from "@convex-cms/core";
+ * import { components } from "./_generated/api";
+ *
+ * const cmsTools = createCmsTools(components.convexCms);
+ *
+ * const contentAgent = new Agent(components.agent, {
+ *   name: "Content Manager",
+ *   languageModel: openai.chat("gpt-4o"),
+ *   tools: cmsTools,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use individual tools
+ * import { createCmsTools } from "@convex-cms/core";
+ *
+ * const { createContentEntry, listContentEntries, publishEntry } = createCmsTools(api);
+ *
+ * const agent = new Agent(components.agent, {
+ *   tools: { createContentEntry, publishEntry },
+ * });
+ * ```
+ */
+import { z } from "zod";
+/**
+ * The component API type for agent tools.
+ * This represents the actual structure of `components.convexCms` from the generated API.
+ *
+ * Uses `any` for internal function references since the exact types depend on
+ * the generated Convex types which vary per project.
+ *
+ * Note: This matches the actual Convex component module structure:
+ * - contentTypes: queries in contentTypes.ts (get handles both ID and name lookup via args)
+ * - contentTypeMutations: mutations in contentTypeMutations.ts
+ * - contentEntries: queries in contentEntries.ts
+ * - contentEntryMutations: mutations in contentEntryMutations.ts
+ * - scheduledPublish: schedule-related mutations in scheduledPublish.ts (separate module)
+ * - mediaAssets: queries in mediaAssets.ts
+ * - mediaAssetMutations: mutations in mediaAssetMutations.ts
+ * - bulkOperations: bulk mutations in bulkOperations.ts
+ *
+ * IMPORTANT: This type represents the raw component API shape as exported from
+ * `components.convexCms`. It differs from the wrapper API (createCmsClient) which
+ * provides a different, more ergonomic namespace structure.
+ */
+export type AgentComponentApi = {
+    /**
+     * Content type queries (contentTypes.ts module)
+     * @see src/component/contentTypes.ts
+     */
+    contentTypes: {
+        /**
+         * Get content type by ID or name.
+         * Supports lookup by either `id` OR `name` argument (not both).
+         * @example { id: "..." } or { name: "blog_post" }
+         */
+        get: any;
+        /** List content types with filtering and pagination */
+        list: any;
+    };
+    /**
+     * Content type mutations (contentTypeMutations.ts module)
+     * @see src/component/contentTypeMutations.ts
+     */
+    contentTypeMutations: {
+        createContentType: any;
+        updateContentType: any;
+        deleteContentType: any;
+    };
+    /**
+     * Content entry queries (contentEntries.ts module)
+     * @see src/component/contentEntries.ts
+     */
+    contentEntries: {
+        /** Get content entry by ID */
+        get: any;
+        /** Get content entry by slug and content type ID */
+        getBySlug: any;
+        /** Get content entry by slug and content type name */
+        getBySlugAndTypeName: any;
+        /** List content entries with filtering and pagination */
+        list: any;
+    };
+    /**
+     * Content entry mutations (contentEntryMutations.ts module)
+     * @see src/component/contentEntryMutations.ts
+     */
+    contentEntryMutations: {
+        createEntry: any;
+        updateEntry: any;
+        publishEntry: any;
+        unpublishEntry: any;
+        deleteEntry: any;
+        duplicateEntry: any;
+        restoreEntry: any;
+    };
+    /**
+     * Scheduling-related mutations (scheduledPublish.ts module - SEPARATE from contentEntryMutations)
+     * @see src/component/scheduledPublish.ts
+     */
+    scheduledPublish: {
+        /** Schedule an entry for future publication */
+        scheduleEntry: any;
+        /** Cancel a scheduled publication */
+        cancelScheduledPublish: any;
+    };
+    /**
+     * Media asset queries (mediaAssets.ts module)
+     * @see src/component/mediaAssets.ts
+     */
+    mediaAssets: {
+        get: any;
+        list: any;
+    };
+    /**
+     * Media asset mutations (mediaAssetMutations.ts module)
+     * @see src/component/mediaAssetMutations.ts
+     */
+    mediaAssetMutations: {
+        createMediaAsset: any;
+        updateMediaAsset: any;
+        deleteMediaAsset: any;
+    };
+    /**
+     * Bulk operations (bulkOperations.ts module)
+     * @see src/component/bulkOperations.ts
+     */
+    bulkOperations: {
+        bulkPublish: any;
+        bulkUnpublish: any;
+        bulkDelete: any;
+        bulkUpdate: any;
+        bulkRestore: any;
+    };
+};
+/**
+ * Supported field types in the CMS.
+ */
+export declare const fieldTypeSchema: z.ZodEnum<{
+    number: "number";
+    boolean: "boolean";
+    text: "text";
+    richText: "richText";
+    date: "date";
+    datetime: "datetime";
+    reference: "reference";
+    media: "media";
+    json: "json";
+    select: "select";
+    multiSelect: "multiSelect";
+}>;
+/**
+ * Content entry status values.
+ */
+export declare const contentStatusSchema: z.ZodEnum<{
+    draft: "draft";
+    published: "published";
+    archived: "archived";
+    scheduled: "scheduled";
+}>;
+/**
+ * Media type classification.
+ */
+export declare const mediaTypeSchema: z.ZodEnum<{
+    image: "image";
+    video: "video";
+    audio: "audio";
+    document: "document";
+    other: "other";
+}>;
+/**
+ * Field-specific configuration options.
+ */
+export declare const fieldOptionsSchema: z.ZodObject<{
+    minLength: z.ZodOptional<z.ZodNumber>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    pattern: z.ZodOptional<z.ZodString>;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    step: z.ZodOptional<z.ZodNumber>;
+    precision: z.ZodOptional<z.ZodNumber>;
+    allowedContentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    multiple: z.ZodOptional<z.ZodBoolean>;
+    minItems: z.ZodOptional<z.ZodNumber>;
+    allowedMimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxFileSize: z.ZodOptional<z.ZodNumber>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+    allowedBlocks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allowedMarks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * Field definition schema for content types.
+ */
+export declare const fieldDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<{
+        number: "number";
+        boolean: "boolean";
+        text: "text";
+        richText: "richText";
+        date: "date";
+        datetime: "datetime";
+        reference: "reference";
+        media: "media";
+        json: "json";
+        select: "select";
+        multiSelect: "multiSelect";
+    }>;
+    required: z.ZodBoolean;
+    searchable: z.ZodOptional<z.ZodBoolean>;
+    localized: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    defaultValue: z.ZodOptional<z.ZodAny>;
+    options: z.ZodOptional<z.ZodObject<{
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        pattern: z.ZodOptional<z.ZodString>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        precision: z.ZodOptional<z.ZodNumber>;
+        allowedContentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        multiple: z.ZodOptional<z.ZodBoolean>;
+        minItems: z.ZodOptional<z.ZodNumber>;
+        allowedMimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        maxFileSize: z.ZodOptional<z.ZodNumber>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        allowedBlocks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allowedMarks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+/**
+ * Filter operators for content queries.
+ */
+export declare const filterOperatorSchema: z.ZodEnum<{
+    endsWith: "endsWith";
+    startsWith: "startsWith";
+    in: "in";
+    eq: "eq";
+    ne: "ne";
+    gt: "gt";
+    gte: "gte";
+    lt: "lt";
+    lte: "lte";
+    contains: "contains";
+    notIn: "notIn";
+}>;
+/**
+ * Field filter for content queries.
+ */
+export declare const fieldFilterSchema: z.ZodObject<{
+    field: z.ZodString;
+    operator: z.ZodEnum<{
+        endsWith: "endsWith";
+        startsWith: "startsWith";
+        in: "in";
+        eq: "eq";
+        ne: "ne";
+        gt: "gt";
+        gte: "gte";
+        lt: "lt";
+        lte: "lte";
+        contains: "contains";
+        notIn: "notIn";
+    }>;
+    value: z.ZodAny;
+}, z.core.$strip>;
+/**
+ * Arguments for creating a content type.
+ */
+export declare const createContentTypeArgsSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            boolean: "boolean";
+            text: "text";
+            richText: "richText";
+            date: "date";
+            datetime: "datetime";
+            reference: "reference";
+            media: "media";
+            json: "json";
+            select: "select";
+            multiSelect: "multiSelect";
+        }>;
+        required: z.ZodBoolean;
+        searchable: z.ZodOptional<z.ZodBoolean>;
+        localized: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        defaultValue: z.ZodOptional<z.ZodAny>;
+        options: z.ZodOptional<z.ZodObject<{
+            minLength: z.ZodOptional<z.ZodNumber>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            pattern: z.ZodOptional<z.ZodString>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodNumber>;
+            precision: z.ZodOptional<z.ZodNumber>;
+            allowedContentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            multiple: z.ZodOptional<z.ZodBoolean>;
+            minItems: z.ZodOptional<z.ZodNumber>;
+            allowedMimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            maxFileSize: z.ZodOptional<z.ZodNumber>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>>>;
+            allowedBlocks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            allowedMarks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>>;
+    icon: z.ZodOptional<z.ZodString>;
+    singleton: z.ZodOptional<z.ZodBoolean>;
+    slugField: z.ZodOptional<z.ZodString>;
+    titleField: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+    createdBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for updating a content type.
+ */
+export declare const updateContentTypeArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            boolean: "boolean";
+            text: "text";
+            richText: "richText";
+            date: "date";
+            datetime: "datetime";
+            reference: "reference";
+            media: "media";
+            json: "json";
+            select: "select";
+            multiSelect: "multiSelect";
+        }>;
+        required: z.ZodBoolean;
+        searchable: z.ZodOptional<z.ZodBoolean>;
+        localized: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        defaultValue: z.ZodOptional<z.ZodAny>;
+        options: z.ZodOptional<z.ZodObject<{
+            minLength: z.ZodOptional<z.ZodNumber>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            pattern: z.ZodOptional<z.ZodString>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodNumber>;
+            precision: z.ZodOptional<z.ZodNumber>;
+            allowedContentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            multiple: z.ZodOptional<z.ZodBoolean>;
+            minItems: z.ZodOptional<z.ZodNumber>;
+            allowedMimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            maxFileSize: z.ZodOptional<z.ZodNumber>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>>>;
+            allowedBlocks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            allowedMarks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>>>;
+    icon: z.ZodOptional<z.ZodString>;
+    singleton: z.ZodOptional<z.ZodBoolean>;
+    slugField: z.ZodOptional<z.ZodString>;
+    titleField: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    updatedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for listing content types.
+ */
+export declare const listContentTypesArgsSchema: z.ZodObject<{
+    includeInactive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Arguments for getting a single content type.
+ */
+export declare const getContentTypeArgsSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for creating a content entry.
+ */
+export declare const createContentEntryArgsSchema: z.ZodObject<{
+    contentTypeId: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    locale: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+        archived: "archived";
+        scheduled: "scheduled";
+    }>>;
+    createdBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for updating a content entry.
+ */
+export declare const updateContentEntryArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+        archived: "archived";
+        scheduled: "scheduled";
+    }>>;
+    scheduledPublishAt: z.ZodOptional<z.ZodNumber>;
+    updatedBy: z.ZodOptional<z.ZodString>;
+    regenerateSlug: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Arguments for publishing a content entry.
+ */
+export declare const publishEntryArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+    changeDescription: z.ZodOptional<z.ZodString>;
+    updatedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for unpublishing a content entry.
+ */
+export declare const unpublishEntryArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+    updatedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for scheduling a content entry.
+ */
+export declare const scheduleEntryArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+    publishAt: z.ZodNumber;
+    updatedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for deleting a content entry.
+ */
+export declare const deleteContentEntryArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+    deletedBy: z.ZodOptional<z.ZodString>;
+    hardDelete: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Arguments for duplicating a content entry.
+ */
+export declare const duplicateContentEntryArgsSchema: z.ZodObject<{
+    sourceEntryId: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    copyMediaReferences: z.ZodOptional<z.ZodBoolean>;
+    locale: z.ZodOptional<z.ZodString>;
+    createdBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for listing content entries.
+ */
+export declare const listContentEntriesArgsSchema: z.ZodObject<{
+    contentTypeId: z.ZodOptional<z.ZodString>;
+    contentTypeName: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+        archived: "archived";
+        scheduled: "scheduled";
+    }>>;
+    statusIn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+        archived: "archived";
+        scheduled: "scheduled";
+    }>>>;
+    locale: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    includeDeleted: z.ZodOptional<z.ZodBoolean>;
+    fieldFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        operator: z.ZodEnum<{
+            endsWith: "endsWith";
+            startsWith: "startsWith";
+            in: "in";
+            eq: "eq";
+            ne: "ne";
+            gt: "gt";
+            gte: "gte";
+            lt: "lt";
+            lte: "lte";
+            contains: "contains";
+            notIn: "notIn";
+        }>;
+        value: z.ZodAny;
+    }, z.core.$strip>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for getting a single content entry.
+ */
+export declare const getContentEntryArgsSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    contentTypeId: z.ZodOptional<z.ZodString>;
+    contentTypeName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for restoring a soft-deleted content entry.
+ */
+export declare const restoreContentEntryArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+    updatedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for creating a media asset.
+ */
+export declare const createMediaAssetArgsSchema: z.ZodObject<{
+    storageId: z.ZodString;
+    filename: z.ZodString;
+    mimeType: z.ZodString;
+    size: z.ZodNumber;
+    type: z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+        other: "other";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    altText: z.ZodOptional<z.ZodString>;
+    folderId: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    createdBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for updating a media asset.
+ */
+export declare const updateMediaAssetArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    altText: z.ZodOptional<z.ZodString>;
+    folderId: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Arguments for listing media assets.
+ */
+export declare const listMediaAssetsArgsSchema: z.ZodObject<{
+    folderId: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        image: "image";
+        video: "video";
+        audio: "audio";
+        document: "document";
+        other: "other";
+    }>>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    includeDeleted: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for getting a single media asset.
+ */
+export declare const getMediaAssetArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Arguments for deleting a media asset.
+ */
+export declare const deleteMediaAssetArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+    deletedBy: z.ZodOptional<z.ZodString>;
+    hardDelete: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Arguments for bulk publishing content entries.
+ */
+export declare const bulkPublishArgsSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+    changeDescription: z.ZodOptional<z.ZodString>;
+    updatedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for bulk unpublishing content entries.
+ */
+export declare const bulkUnpublishArgsSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+    updatedBy: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Arguments for bulk deleting content entries.
+ */
+export declare const bulkDeleteArgsSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+    deletedBy: z.ZodOptional<z.ZodString>;
+    hardDelete: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Arguments for searching content.
+ */
+export declare const searchContentArgsSchema: z.ZodObject<{
+    query: z.ZodString;
+    contentTypeId: z.ZodOptional<z.ZodString>;
+    contentTypeName: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+        archived: "archived";
+        scheduled: "scheduled";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Options for creating CMS tools.
+ */
+export interface CreateCmsToolsOptions {
+    /**
+     * Optional user ID to use as the creator/updater for all operations.
+     * If not provided, tools will not set createdBy/updatedBy fields.
+     */
+    defaultUserId?: string;
+}
+/**
+ * Creates a set of CMS tools compatible with @convex-dev/agent.
+ *
+ * These tools provide AI agents with structured access to CMS operations
+ * including content type management, content entry CRUD, publishing workflows,
+ * and media asset management.
+ *
+ * @param componentApi - The CMS component API from `components.convexCms`
+ * @param options - Optional configuration for the tools
+ * @returns An object containing all CMS tools
+ *
+ * @example
+ * ```typescript
+ * import { Agent } from "@convex-dev/agent";
+ * import { createCmsTools } from "@convex-cms/core";
+ * import { components } from "./_generated/api";
+ *
+ * // Create all CMS tools
+ * const cmsTools = createCmsTools(components.convexCms);
+ *
+ * // Use with an agent
+ * const contentAgent = new Agent(components.agent, {
+ *   name: "Content Manager",
+ *   languageModel: openai.chat("gpt-4o"),
+ *   tools: cmsTools,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use selected tools with a specialized agent
+ * const { listContentEntries, searchContent, getContentEntry } = createCmsTools(api);
+ *
+ * const researchAgent = new Agent(components.agent, {
+ *   name: "Content Researcher",
+ *   tools: { listContentEntries, searchContent, getContentEntry },
+ * });
+ * ```
+ */
+export declare function createCmsTools(componentApi: AgentComponentApi, options?: CreateCmsToolsOptions): {
+    createContentType: import("ai").Tool<{
+        name: string;
+        displayName: string;
+        fields: {
+            name: string;
+            label: string;
+            type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect";
+            required: boolean;
+            searchable?: boolean | undefined;
+            localized?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: any;
+            options?: {
+                minLength?: number | undefined;
+                maxLength?: number | undefined;
+                pattern?: string | undefined;
+                min?: number | undefined;
+                max?: number | undefined;
+                step?: number | undefined;
+                precision?: number | undefined;
+                allowedContentTypes?: string[] | undefined;
+                multiple?: boolean | undefined;
+                minItems?: number | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                maxFileSize?: number | undefined;
+                options?: {
+                    value: string;
+                    label: string;
+                }[] | undefined;
+                allowedBlocks?: string[] | undefined;
+                allowedMarks?: string[] | undefined;
+            } | undefined;
+        }[];
+        description?: string | undefined;
+        icon?: string | undefined;
+        singleton?: boolean | undefined;
+        slugField?: string | undefined;
+        titleField?: string | undefined;
+        sortOrder?: number | undefined;
+        createdBy?: string | undefined;
+    }, any>;
+    updateContentType: import("ai").Tool<{
+        id: string;
+        displayName?: string | undefined;
+        description?: string | undefined;
+        fields?: {
+            name: string;
+            label: string;
+            type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect";
+            required: boolean;
+            searchable?: boolean | undefined;
+            localized?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: any;
+            options?: {
+                minLength?: number | undefined;
+                maxLength?: number | undefined;
+                pattern?: string | undefined;
+                min?: number | undefined;
+                max?: number | undefined;
+                step?: number | undefined;
+                precision?: number | undefined;
+                allowedContentTypes?: string[] | undefined;
+                multiple?: boolean | undefined;
+                minItems?: number | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                maxFileSize?: number | undefined;
+                options?: {
+                    value: string;
+                    label: string;
+                }[] | undefined;
+                allowedBlocks?: string[] | undefined;
+                allowedMarks?: string[] | undefined;
+            } | undefined;
+        }[] | undefined;
+        icon?: string | undefined;
+        singleton?: boolean | undefined;
+        slugField?: string | undefined;
+        titleField?: string | undefined;
+        sortOrder?: number | undefined;
+        isActive?: boolean | undefined;
+        updatedBy?: string | undefined;
+    }, any>;
+    listContentTypes: import("ai").Tool<{
+        includeInactive?: boolean | undefined;
+    }, any>;
+    getContentType: import("ai").Tool<{
+        id?: string | undefined;
+        name?: string | undefined;
+    }, any>;
+    createContentEntry: import("ai").Tool<{
+        contentTypeId: string;
+        data: Record<string, any>;
+        slug?: string | undefined;
+        locale?: string | undefined;
+        status?: "draft" | "published" | "archived" | "scheduled" | undefined;
+        createdBy?: string | undefined;
+    }, any>;
+    updateContentEntry: import("ai").Tool<{
+        id: string;
+        slug?: string | undefined;
+        data?: Record<string, any> | undefined;
+        status?: "draft" | "published" | "archived" | "scheduled" | undefined;
+        scheduledPublishAt?: number | undefined;
+        updatedBy?: string | undefined;
+        regenerateSlug?: boolean | undefined;
+    }, any>;
+    publishEntry: import("ai").Tool<{
+        id: string;
+        changeDescription?: string | undefined;
+        updatedBy?: string | undefined;
+    }, any>;
+    unpublishEntry: import("ai").Tool<{
+        id: string;
+        updatedBy?: string | undefined;
+    }, any>;
+    scheduleEntry: import("ai").Tool<{
+        id: string;
+        publishAt: number;
+        updatedBy?: string | undefined;
+    }, any>;
+    deleteContentEntry: import("ai").Tool<{
+        id: string;
+        deletedBy?: string | undefined;
+        hardDelete?: boolean | undefined;
+    }, any>;
+    duplicateContentEntry: import("ai").Tool<{
+        sourceEntryId: string;
+        slug?: string | undefined;
+        copyMediaReferences?: boolean | undefined;
+        locale?: string | undefined;
+        createdBy?: string | undefined;
+    }, any>;
+    listContentEntries: import("ai").Tool<{
+        contentTypeId?: string | undefined;
+        contentTypeName?: string | undefined;
+        status?: "draft" | "published" | "archived" | "scheduled" | undefined;
+        statusIn?: ("draft" | "published" | "archived" | "scheduled")[] | undefined;
+        locale?: string | undefined;
+        search?: string | undefined;
+        includeDeleted?: boolean | undefined;
+        fieldFilters?: {
+            field: string;
+            operator: "endsWith" | "startsWith" | "in" | "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "notIn";
+            value: any;
+        }[] | undefined;
+        limit?: number | undefined;
+        cursor?: string | undefined;
+    }, any>;
+    getContentEntry: import("ai").Tool<{
+        id?: string | undefined;
+        slug?: string | undefined;
+        contentTypeId?: string | undefined;
+        contentTypeName?: string | undefined;
+    }, any>;
+    restoreContentEntry: import("ai").Tool<{
+        id: string;
+        updatedBy?: string | undefined;
+    }, any>;
+    createMediaAsset: import("ai").Tool<{
+        storageId: string;
+        filename: string;
+        mimeType: string;
+        size: number;
+        type: "image" | "video" | "audio" | "document" | "other";
+        title?: string | undefined;
+        description?: string | undefined;
+        altText?: string | undefined;
+        folderId?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        duration?: number | undefined;
+        metadata?: Record<string, any> | undefined;
+        tags?: string[] | undefined;
+        createdBy?: string | undefined;
+    }, any>;
+    updateMediaAsset: import("ai").Tool<{
+        id: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        altText?: string | undefined;
+        folderId?: string | undefined;
+        tags?: string[] | undefined;
+    }, any>;
+    listMediaAssets: import("ai").Tool<{
+        folderId?: string | undefined;
+        type?: "image" | "video" | "audio" | "document" | "other" | undefined;
+        mimeType?: string | undefined;
+        search?: string | undefined;
+        tags?: string[] | undefined;
+        includeDeleted?: boolean | undefined;
+        limit?: number | undefined;
+        cursor?: string | undefined;
+    }, any>;
+    getMediaAsset: import("ai").Tool<{
+        id: string;
+    }, any>;
+    deleteMediaAsset: import("ai").Tool<{
+        id: string;
+        deletedBy?: string | undefined;
+        hardDelete?: boolean | undefined;
+    }, any>;
+    bulkPublish: import("ai").Tool<{
+        ids: string[];
+        changeDescription?: string | undefined;
+        updatedBy?: string | undefined;
+    }, any>;
+    bulkUnpublish: import("ai").Tool<{
+        ids: string[];
+        updatedBy?: string | undefined;
+    }, any>;
+    bulkDelete: import("ai").Tool<{
+        ids: string[];
+        deletedBy?: string | undefined;
+        hardDelete?: boolean | undefined;
+    }, any>;
+    searchContent: import("ai").Tool<{
+        query: string;
+        contentTypeId?: string | undefined;
+        contentTypeName?: string | undefined;
+        status?: "draft" | "published" | "archived" | "scheduled" | undefined;
+        limit?: number | undefined;
+    }, any>;
+};
+/**
+ * Type representing all available CMS tools.
+ */
+export type CmsTools = ReturnType<typeof createCmsTools>;
+/**
+ * Tool names available in the CMS tools object.
+ */
+export type CmsToolName = keyof CmsTools;
+//# sourceMappingURL=agentTools.d.ts.map