@collage-dam/mcp-server 0.1.0

package/dist/tools/search/types.d.ts

@@ -0,0 +1,1047 @@
+import { z } from 'zod';
+/** Single `field:direction` clause. Matches the upstream regex `[A-Za-z0-9_]+:(asc|desc)`. */
+export declare const SortClauseSchema: z.ZodObject<{
+    field: z.ZodString;
+    direction: z.ZodEnum<["asc", "desc"]>;
+}, "strip", z.ZodTypeAny, {
+    field: string;
+    direction: "asc" | "desc";
+}, {
+    field: string;
+    direction: "asc" | "desc";
+}>;
+export type SortClause = z.infer<typeof SortClauseSchema>;
+/** Default applied when no sort is provided (matches the frontend's default). */
+export declare const DEFAULT_SORT_BY = "_text_match:desc,modified_at:desc";
+/**
+ * `compact` returns minimal fields only ({id, display_file_name,
+ * thumbnail_file, modified_at}); `verbose` hydrates the full indexed
+ * field projection. Default is `compact` to keep token usage small over
+ * 10K+ asset libraries.
+ */
+export declare const ProjectionSchema: z.ZodEnum<["compact", "verbose"]>;
+export type Projection = z.infer<typeof ProjectionSchema>;
+/** Visibility maps to the numeric upstream column (0=public, 1=private). */
+export declare const VisibilitySchema: z.ZodUnion<[z.ZodLiteral<"public">, z.ZodLiteral<"private">, z.ZodLiteral<0>, z.ZodLiteral<1>]>;
+export type Visibility = z.infer<typeof VisibilitySchema>;
+/**
+ * Date filter accepts either a Unix-second integer or an ISO-8601 string.
+ * Coercion happens at the wrapper layer.
+ */
+export declare const DateBoundSchema: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+export type DateBound = z.infer<typeof DateBoundSchema>;
+export declare const SearchAssetFiltersSchema: z.ZodObject<{
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    file_type: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    visibility: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"public">, z.ZodLiteral<"private">, z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+    collection_ids: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>;
+    category_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    created_after: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    created_before: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    modified_after: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    modified_before: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+}, "strict", z.ZodTypeAny, {
+    file_type?: string[] | undefined;
+    category_id?: string | number | undefined;
+    tags?: string[] | undefined;
+    visibility?: 0 | 1 | "public" | "private" | undefined;
+    collection_ids?: (string | number)[] | undefined;
+    created_after?: string | number | undefined;
+    created_before?: string | number | undefined;
+    modified_after?: string | number | undefined;
+    modified_before?: string | number | undefined;
+}, {
+    file_type?: string[] | undefined;
+    category_id?: string | number | undefined;
+    tags?: string[] | undefined;
+    visibility?: 0 | 1 | "public" | "private" | undefined;
+    collection_ids?: (string | number)[] | undefined;
+    created_after?: string | number | undefined;
+    created_before?: string | number | undefined;
+    modified_after?: string | number | undefined;
+    modified_before?: string | number | undefined;
+}>;
+export type SearchAssetFilters = z.infer<typeof SearchAssetFiltersSchema>;
+export declare const SearchCollectionFiltersSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export type SearchCollectionFilters = z.infer<typeof SearchCollectionFiltersSchema>;
+export declare const SearchAssetsInputSchema: z.ZodObject<{
+    q: z.ZodDefault<z.ZodString>;
+    filters: z.ZodOptional<z.ZodObject<{
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        file_type: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        visibility: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"public">, z.ZodLiteral<"private">, z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+        collection_ids: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodString]>, "many">>;
+        category_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        created_after: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        created_before: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        modified_after: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        modified_before: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    }, "strict", z.ZodTypeAny, {
+        file_type?: string[] | undefined;
+        category_id?: string | number | undefined;
+        tags?: string[] | undefined;
+        visibility?: 0 | 1 | "public" | "private" | undefined;
+        collection_ids?: (string | number)[] | undefined;
+        created_after?: string | number | undefined;
+        created_before?: string | number | undefined;
+        modified_after?: string | number | undefined;
+        modified_before?: string | number | undefined;
+    }, {
+        file_type?: string[] | undefined;
+        category_id?: string | number | undefined;
+        tags?: string[] | undefined;
+        visibility?: 0 | 1 | "public" | "private" | undefined;
+        collection_ids?: (string | number)[] | undefined;
+        created_after?: string | number | undefined;
+        created_before?: string | number | undefined;
+        modified_after?: string | number | undefined;
+        modified_before?: string | number | undefined;
+    }>>;
+    page: z.ZodDefault<z.ZodNumber>;
+    per_page: z.ZodDefault<z.ZodNumber>;
+    sort_by: z.ZodDefault<z.ZodString>;
+    projection: z.ZodDefault<z.ZodEnum<["compact", "verbose"]>>;
+    /** Optional infix override; defaults to 'fallback' at the wrapper layer. */
+    infix: z.ZodOptional<z.ZodEnum<["off", "always", "fallback"]>>;
+    /** Optional Typesense `query_by` override. */
+    query_by: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    per_page: number;
+    page: number;
+    sort_by: string;
+    q: string;
+    projection: "compact" | "verbose";
+    filters?: {
+        file_type?: string[] | undefined;
+        category_id?: string | number | undefined;
+        tags?: string[] | undefined;
+        visibility?: 0 | 1 | "public" | "private" | undefined;
+        collection_ids?: (string | number)[] | undefined;
+        created_after?: string | number | undefined;
+        created_before?: string | number | undefined;
+        modified_after?: string | number | undefined;
+        modified_before?: string | number | undefined;
+    } | undefined;
+    infix?: "off" | "always" | "fallback" | undefined;
+    query_by?: string | undefined;
+}, {
+    per_page?: number | undefined;
+    page?: number | undefined;
+    sort_by?: string | undefined;
+    q?: string | undefined;
+    filters?: {
+        file_type?: string[] | undefined;
+        category_id?: string | number | undefined;
+        tags?: string[] | undefined;
+        visibility?: 0 | 1 | "public" | "private" | undefined;
+        collection_ids?: (string | number)[] | undefined;
+        created_after?: string | number | undefined;
+        created_before?: string | number | undefined;
+        modified_after?: string | number | undefined;
+        modified_before?: string | number | undefined;
+    } | undefined;
+    projection?: "compact" | "verbose" | undefined;
+    infix?: "off" | "always" | "fallback" | undefined;
+    query_by?: string | undefined;
+}>;
+export type SearchAssetsInput = z.infer<typeof SearchAssetsInputSchema>;
+export declare const SearchCollectionsInputSchema: z.ZodObject<{
+    q: z.ZodDefault<z.ZodString>;
+    filters: z.ZodOptional<z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>>;
+    page: z.ZodDefault<z.ZodNumber>;
+    per_page: z.ZodDefault<z.ZodNumber>;
+    sort_by: z.ZodDefault<z.ZodString>;
+    projection: z.ZodDefault<z.ZodEnum<["compact", "verbose"]>>;
+    query_by: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    per_page: number;
+    page: number;
+    sort_by: string;
+    q: string;
+    projection: "compact" | "verbose";
+    filters?: {} | undefined;
+    query_by?: string | undefined;
+}, {
+    per_page?: number | undefined;
+    page?: number | undefined;
+    sort_by?: string | undefined;
+    q?: string | undefined;
+    filters?: {} | undefined;
+    projection?: "compact" | "verbose" | undefined;
+    query_by?: string | undefined;
+}>;
+export type SearchCollectionsInput = z.infer<typeof SearchCollectionsInputSchema>;
+/** Compact asset projection — the default `search_assets` shape. */
+export declare const CompactAssetHitSchema: z.ZodObject<{
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type CompactAssetHit = z.infer<typeof CompactAssetHitSchema>;
+/** Verbose asset projection — the full indexed field set. */
+export declare const VerboseAssetHitSchema: z.ZodObject<{
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    instances_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    search_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    file_type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    compress_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    video_preview: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    display_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    file_size: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    height: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    width: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    orientation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    is_external_upload: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+    visibility: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    category_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    is_collection: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+    collection_ids: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>>;
+    created_by: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    created_by_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    tags: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    custom_fields: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    breadcrumb: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    instances_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    search_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    file_type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    compress_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    video_preview: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    display_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    file_size: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    height: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    width: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    orientation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    is_external_upload: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+    visibility: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    category_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    is_collection: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+    collection_ids: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>>;
+    created_by: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    created_by_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    tags: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    custom_fields: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    breadcrumb: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    instances_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    search_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    file_type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    compress_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    video_preview: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    display_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    file_size: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    height: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    width: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    orientation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    is_external_upload: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+    visibility: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    category_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    is_collection: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+    collection_ids: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>>;
+    created_by: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    created_by_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    tags: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    custom_fields: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    breadcrumb: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type VerboseAssetHit = z.infer<typeof VerboseAssetHitSchema>;
+/** Collection hit shape — matches `dam_collections` index minimal fields. */
+export declare const CollectionHitSchema: z.ZodObject<{
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    collection_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    collection_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    collection_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type CollectionHit = z.infer<typeof CollectionHitSchema>;
+export declare const FacetCountSchema: z.ZodObject<{
+    value: z.ZodString;
+    count: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    count: number;
+}, {
+    value: string;
+    count: number;
+}>;
+export type FacetCount = z.infer<typeof FacetCountSchema>;
+export declare const SearchFacetsSchema: z.ZodObject<{
+    tags: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        count: number;
+    }, {
+        value: string;
+        count: number;
+    }>, "many">>;
+    file_type: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        count: number;
+    }, {
+        value: string;
+        count: number;
+    }>, "many">>;
+    /** Bucketed `modified_at` distribution (30d, 90d, 365d, older). */
+    date_histogram: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        count: number;
+    }, {
+        value: string;
+        count: number;
+    }>, "many">>;
+    /** Typesense `_text_match` distribution buckets when available. */
+    score_distribution: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        count: number;
+    }, {
+        value: string;
+        count: number;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    file_type: {
+        value: string;
+        count: number;
+    }[];
+    tags: {
+        value: string;
+        count: number;
+    }[];
+    date_histogram: {
+        value: string;
+        count: number;
+    }[];
+    score_distribution: {
+        value: string;
+        count: number;
+    }[];
+}, {
+    file_type?: {
+        value: string;
+        count: number;
+    }[] | undefined;
+    tags?: {
+        value: string;
+        count: number;
+    }[] | undefined;
+    date_histogram?: {
+        value: string;
+        count: number;
+    }[] | undefined;
+    score_distribution?: {
+        value: string;
+        count: number;
+    }[] | undefined;
+}>;
+export type SearchFacets = z.infer<typeof SearchFacetsSchema>;
+/**
+ * Structured next-step hints surfaced alongside search responses. These
+ * are deliberately machine-readable — the consuming LLM decides what
+ * to do with them. Mirrors the audit tool's hint-shape sibling-side.
+ */
+export declare const SearchNextStepHintSchema: z.ZodObject<{
+    tool: z.ZodString;
+    reason_code: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    /** Suggested arguments to pass to `tool` if the LLM acts on the hint. */
+    suggested_args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    tool: string;
+    reason_code: string;
+    reason?: string | undefined;
+    suggested_args?: Record<string, unknown> | undefined;
+}, {
+    tool: string;
+    reason_code: string;
+    reason?: string | undefined;
+    suggested_args?: Record<string, unknown> | undefined;
+}>;
+export type SearchNextStepHint = z.infer<typeof SearchNextStepHintSchema>;
+export declare const SearchAssetsOutputSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    per_page: z.ZodNumber;
+    next_cursor: z.ZodNullable<z.ZodString>;
+    truncated: z.ZodDefault<z.ZodBoolean>;
+    facets: z.ZodObject<{
+        tags: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            count: number;
+        }, {
+            value: string;
+            count: number;
+        }>, "many">>;
+        file_type: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            count: number;
+        }, {
+            value: string;
+            count: number;
+        }>, "many">>;
+        /** Bucketed `modified_at` distribution (30d, 90d, 365d, older). */
+        date_histogram: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            count: number;
+        }, {
+            value: string;
+            count: number;
+        }>, "many">>;
+        /** Typesense `_text_match` distribution buckets when available. */
+        score_distribution: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            count: number;
+        }, {
+            value: string;
+            count: number;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        file_type: {
+            value: string;
+            count: number;
+        }[];
+        tags: {
+            value: string;
+            count: number;
+        }[];
+        date_histogram: {
+            value: string;
+            count: number;
+        }[];
+        score_distribution: {
+            value: string;
+            count: number;
+        }[];
+    }, {
+        file_type?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        tags?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        date_histogram?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        score_distribution?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+    }>;
+    next_step_hints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        tool: z.ZodString;
+        reason_code: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+        /** Suggested arguments to pass to `tool` if the LLM acts on the hint. */
+        suggested_args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        tool: string;
+        reason_code: string;
+        reason?: string | undefined;
+        suggested_args?: Record<string, unknown> | undefined;
+    }, {
+        tool: string;
+        reason_code: string;
+        reason?: string | undefined;
+        suggested_args?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    request_id: z.ZodString;
+} & {
+    hits: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough">>, z.ZodObject<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        instances_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        search_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        file_type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        compress_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        video_preview: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        display_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        file_size: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        height: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        width: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        orientation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        is_external_upload: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+        visibility: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        category_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        is_collection: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+        collection_ids: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>>;
+        created_by: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        created_by_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        tags: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        custom_fields: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        breadcrumb: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        instances_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        search_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        file_type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        compress_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        video_preview: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        display_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        file_size: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        height: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        width: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        orientation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        is_external_upload: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+        visibility: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        category_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        is_collection: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+        collection_ids: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>>;
+        created_by: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        created_by_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        tags: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        custom_fields: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        breadcrumb: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        instances_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        search_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        file_type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        compress_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        video_preview: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        display_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        file_size: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        height: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        width: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        orientation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        is_external_upload: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+        visibility: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        category_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        is_collection: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+        collection_ids: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>>;
+        created_by: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        created_by_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        tags: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        custom_fields: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        breadcrumb: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>>;
+    }, z.ZodTypeAny, "passthrough">>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    request_id: string;
+    total: number;
+    per_page: number;
+    page: number;
+    truncated: boolean;
+    next_cursor: string | null;
+    facets: {
+        file_type: {
+            value: string;
+            count: number;
+        }[];
+        tags: {
+            value: string;
+            count: number;
+        }[];
+        date_histogram: {
+            value: string;
+            count: number;
+        }[];
+        score_distribution: {
+            value: string;
+            count: number;
+        }[];
+    };
+    next_step_hints: {
+        tool: string;
+        reason_code: string;
+        reason?: string | undefined;
+        suggested_args?: Record<string, unknown> | undefined;
+    }[];
+    hits: (z.objectOutputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough"> | z.objectOutputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        instances_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        search_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        file_type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        compress_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        video_preview: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        display_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        file_size: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        height: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        width: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        orientation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        is_external_upload: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+        visibility: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        category_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        is_collection: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+        collection_ids: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>>;
+        created_by: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        created_by_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        tags: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        custom_fields: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        breadcrumb: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>>;
+    }, z.ZodTypeAny, "passthrough">)[];
+}, {
+    request_id: string;
+    total: number;
+    per_page: number;
+    page: number;
+    next_cursor: string | null;
+    facets: {
+        file_type?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        tags?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        date_histogram?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        score_distribution?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+    };
+    hits: (z.objectInputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough"> | z.objectInputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        instances_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        display_file_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        search_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        file_type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        type: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        thumbnail_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        compress_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        video_preview: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        display_file: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        file_size: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        height: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        width: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        orientation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        is_external_upload: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+        visibility: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        category_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        is_collection: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>>;
+        collection_ids: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">>>;
+        created_by: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        created_by_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        tags: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        custom_fields: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        breadcrumb: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>>;
+    }, z.ZodTypeAny, "passthrough">)[];
+    truncated?: boolean | undefined;
+    next_step_hints?: {
+        tool: string;
+        reason_code: string;
+        reason?: string | undefined;
+        suggested_args?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}>;
+export type SearchAssetsOutput = z.infer<typeof SearchAssetsOutputSchema>;
+export declare const SearchCollectionsOutputSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    per_page: z.ZodNumber;
+    next_cursor: z.ZodNullable<z.ZodString>;
+    truncated: z.ZodDefault<z.ZodBoolean>;
+    facets: z.ZodObject<{
+        tags: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            count: number;
+        }, {
+            value: string;
+            count: number;
+        }>, "many">>;
+        file_type: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            count: number;
+        }, {
+            value: string;
+            count: number;
+        }>, "many">>;
+        /** Bucketed `modified_at` distribution (30d, 90d, 365d, older). */
+        date_histogram: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            count: number;
+        }, {
+            value: string;
+            count: number;
+        }>, "many">>;
+        /** Typesense `_text_match` distribution buckets when available. */
+        score_distribution: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            count: number;
+        }, {
+            value: string;
+            count: number;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        file_type: {
+            value: string;
+            count: number;
+        }[];
+        tags: {
+            value: string;
+            count: number;
+        }[];
+        date_histogram: {
+            value: string;
+            count: number;
+        }[];
+        score_distribution: {
+            value: string;
+            count: number;
+        }[];
+    }, {
+        file_type?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        tags?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        date_histogram?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        score_distribution?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+    }>;
+    next_step_hints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        tool: z.ZodString;
+        reason_code: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+        /** Suggested arguments to pass to `tool` if the LLM acts on the hint. */
+        suggested_args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        tool: string;
+        reason_code: string;
+        reason?: string | undefined;
+        suggested_args?: Record<string, unknown> | undefined;
+    }, {
+        tool: string;
+        reason_code: string;
+        reason?: string | undefined;
+        suggested_args?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    request_id: z.ZodString;
+} & {
+    hits: z.ZodArray<z.ZodObject<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        collection_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        collection_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        collection_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, "strip", z.ZodTypeAny, {
+    request_id: string;
+    total: number;
+    per_page: number;
+    page: number;
+    truncated: boolean;
+    next_cursor: string | null;
+    facets: {
+        file_type: {
+            value: string;
+            count: number;
+        }[];
+        tags: {
+            value: string;
+            count: number;
+        }[];
+        date_histogram: {
+            value: string;
+            count: number;
+        }[];
+        score_distribution: {
+            value: string;
+            count: number;
+        }[];
+    };
+    next_step_hints: {
+        tool: string;
+        reason_code: string;
+        reason?: string | undefined;
+        suggested_args?: Record<string, unknown> | undefined;
+    }[];
+    hits: z.objectOutputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        collection_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough">[];
+}, {
+    request_id: string;
+    total: number;
+    per_page: number;
+    page: number;
+    next_cursor: string | null;
+    facets: {
+        file_type?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        tags?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        date_histogram?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+        score_distribution?: {
+            value: string;
+            count: number;
+        }[] | undefined;
+    };
+    hits: z.objectInputType<{
+        id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+        collection_name: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        workspace_id: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+        modified_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+        created_at: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>>;
+    }, z.ZodTypeAny, "passthrough">[];
+    truncated?: boolean | undefined;
+    next_step_hints?: {
+        tool: string;
+        reason_code: string;
+        reason?: string | undefined;
+        suggested_args?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}>;
+export type SearchCollectionsOutput = z.infer<typeof SearchCollectionsOutputSchema>;
+export declare const SearchErrorOutputSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        code: z.ZodEnum<["UNAUTHORIZED", "FORBIDDEN", "NOT_FOUND", "VALIDATION", "RATE_LIMITED", "UPSTREAM", "CONFIRMATION_STALE", "CONFIRMATION_MISSING", "CONFIRMATION_STATE_DIVERGED", "ENTITLEMENT", "INTERNAL"]>;
+        message: z.ZodString;
+        retriable: z.ZodBoolean;
+        cause: z.ZodOptional<z.ZodObject<{
+            upstream_status: z.ZodOptional<z.ZodNumber>;
+            request_id: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            upstream_status: z.ZodOptional<z.ZodNumber>;
+            request_id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            upstream_status: z.ZodOptional<z.ZodNumber>;
+            request_id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, "strip", z.ZodTypeAny, {
+        code: "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "VALIDATION" | "RATE_LIMITED" | "UPSTREAM" | "CONFIRMATION_STALE" | "CONFIRMATION_MISSING" | "CONFIRMATION_STATE_DIVERGED" | "ENTITLEMENT" | "INTERNAL";
+        message: string;
+        retriable: boolean;
+        cause?: z.objectOutputType<{
+            upstream_status: z.ZodOptional<z.ZodNumber>;
+            request_id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough"> | undefined;
+    }, {
+        code: "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "VALIDATION" | "RATE_LIMITED" | "UPSTREAM" | "CONFIRMATION_STALE" | "CONFIRMATION_MISSING" | "CONFIRMATION_STATE_DIVERGED" | "ENTITLEMENT" | "INTERNAL";
+        message: string;
+        retriable: boolean;
+        cause?: z.objectInputType<{
+            upstream_status: z.ZodOptional<z.ZodNumber>;
+            request_id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough"> | undefined;
+    }>;
+    request_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    error: {
+        code: "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "VALIDATION" | "RATE_LIMITED" | "UPSTREAM" | "CONFIRMATION_STALE" | "CONFIRMATION_MISSING" | "CONFIRMATION_STATE_DIVERGED" | "ENTITLEMENT" | "INTERNAL";
+        message: string;
+        retriable: boolean;
+        cause?: z.objectOutputType<{
+            upstream_status: z.ZodOptional<z.ZodNumber>;
+            request_id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough"> | undefined;
+    };
+    request_id: string;
+}, {
+    error: {
+        code: "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "VALIDATION" | "RATE_LIMITED" | "UPSTREAM" | "CONFIRMATION_STALE" | "CONFIRMATION_MISSING" | "CONFIRMATION_STATE_DIVERGED" | "ENTITLEMENT" | "INTERNAL";
+        message: string;
+        retriable: boolean;
+        cause?: z.objectInputType<{
+            upstream_status: z.ZodOptional<z.ZodNumber>;
+            request_id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough"> | undefined;
+    };
+    request_id: string;
+}>;
+export type SearchErrorOutput = z.infer<typeof SearchErrorOutputSchema>;
+/**
+ * Internal request envelope passed to `searchWorkspaceScoped`. The wrapper
+ * is the *only* place that owns `workspace_id` injection — see
+ * `src/typesense.ts`.
+ */
+export interface ScopedSearchRequest {
+    q: string;
+    query_by: string;
+    /** Caller-supplied `filter_by` clauses (workspace_id is added by the wrapper). */
+    filter_by?: string;
+    sort_by?: string;
+    page: number;
+    per_page: number;
+    facet_by?: string;
+    max_facet_values?: number;
+    infix?: 'off' | 'always' | 'fallback';
+    prefix?: boolean;
+    num_typos?: number;
+    typo_tokens_threshold?: number;
+    include_fields?: string;
+}
+export declare const DEFAULT_QUERY_BY_ASSETS = "display_file_name,search_name,description,tags,custom_fields";
+export declare const DEFAULT_QUERY_BY_COLLECTIONS = "search_name";
+export declare const DEFAULT_FACET_BY_ASSETS = "tags,file_type,modified_at";
+export declare const DEFAULT_FACET_BY_COLLECTIONS = "modified_at";
+export declare const DEFAULT_MAX_FACET_VALUES = 10;
+//# sourceMappingURL=types.d.ts.map