busa-sdk 0.10.2 → 0.10.3

package/dist/index.d.ts

@@ -6,6 +6,253 @@ import { z } from 'zod';
 import * as _orpc_client from '@orpc/client';
 import * as _orpc_shared from '@orpc/shared';
 
+/**
+ * Unified Grep (P2a files+docs, P2b records) — top-level, domain-agnostic
+ * schemas for `POST /grep`. See apps/busabase/content/spec/unified-grep.md.
+ *
+ * Mirrors how `search`'s schemas live top-level in `contract/schemas.ts`
+ * rather than inside a single domain's contract: `grep` composes multiple
+ * domains (files, Docs, Base records), so its schemas belong at the same
+ * level as `search`'s, not inside `domains/assets/` or `domains/base/`.
+ * The internal files scanner and SDK compatibility adapter keep files-only
+ * schemas in `domains/assets/types.ts`. This file intentionally reuses only
+ * their numeric default/cap constants (same budget language), never their
+ * type names (which would collide: `GrepMatchVO` vs `UnifiedGrepMatchVO`).
+ *
+ * Pure zod — no logic/db imports (client-safe: pulled into the browser
+ * bundle and the RN oRPC client's type graph).
+ */
+
+declare const UnifiedGrepInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    flags: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        records: "records";
+        files: "files";
+        docs: "docs";
+    }>>>;
+    scope: z.ZodOptional<z.ZodObject<{
+        files: z.ZodOptional<z.ZodObject<{
+            assetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            drivePath: z.ZodOptional<z.ZodString>;
+            mimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        docs: z.ZodOptional<z.ZodObject<{
+            nodeIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        records: z.ZodOptional<z.ZodObject<{
+            baseIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            baseSlugs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    maxMatches: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    contextLines: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+}, z.core.$strip>;
+/** Caller input before Zod applies grep defaults. */
+type UnifiedGrepInputDTO = z.input<typeof UnifiedGrepInputSchema>;
+declare const UnifiedGrepResultVOSchema: z.ZodObject<{
+    matches: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        text: z.ZodString;
+        before: z.ZodArray<z.ZodString>;
+        after: z.ZodArray<z.ZodString>;
+        source: z.ZodLiteral<"files">;
+        assetId: z.ZodString;
+        fileName: z.ZodString;
+        drivePath: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        text: z.ZodString;
+        before: z.ZodArray<z.ZodString>;
+        after: z.ZodArray<z.ZodString>;
+        source: z.ZodLiteral<"docs">;
+        nodeId: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        text: z.ZodString;
+        before: z.ZodArray<z.ZodString>;
+        after: z.ZodArray<z.ZodString>;
+        source: z.ZodLiteral<"records">;
+        baseId: z.ZodString;
+        baseSlug: z.ZodString;
+        recordId: z.ZodString;
+        fieldSlug: z.ZodString;
+    }, z.core.$strip>], "source">>;
+    coverage: z.ZodObject<{
+        files: z.ZodObject<{
+            scanned: z.ZodNumber;
+            missing: z.ZodArray<z.ZodString>;
+            stale: z.ZodArray<z.ZodString>;
+            unsearchable: z.ZodNumber;
+            errored: z.ZodArray<z.ZodString>;
+            notReached: z.ZodNumber;
+        }, z.core.$strip>;
+        docs: z.ZodObject<{
+            scanned: z.ZodNumber;
+            errored: z.ZodArray<z.ZodString>;
+            notReached: z.ZodNumber;
+        }, z.core.$strip>;
+        records: z.ZodObject<{
+            scanned: z.ZodNumber;
+            errored: z.ZodArray<z.ZodString>;
+            notReached: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+type UnifiedGrepResultVO = z.infer<typeof UnifiedGrepResultVOSchema>;
+
+/**
+ * Assets — VO Zod schemas (the contract's output source of truth). Pure zod, no
+ * logic/db imports (client-safe). `schema/` holds the PO; these are the VOs the
+ * `/assets` library and the "where-used" panel render.
+ */
+
+/**
+ * Derived text-slot status for an Asset (Drive Grep Retrieval). `missing` is
+ * the absence of a `busabase_asset_texts` row (no writer has supplied text
+ * yet, or a pre-existing asset hasn't been lazily self-healed by a grep call);
+ * `present` / `none` / `stale` are the row's own `status` column.
+ */
+declare const AssetTextStatusSchema: z.ZodEnum<{
+    missing: "missing";
+    stale: "stale";
+    none: "none";
+    present: "present";
+}>;
+type AssetTextStatus = z.infer<typeof AssetTextStatusSchema>;
+/** One library entry: the deduped file + its busabase metadata + usage count. */
+declare const AssetVOSchema: z.ZodObject<{
+    id: z.ZodString;
+    attachmentId: z.ZodString;
+    name: z.ZodString;
+    contentKind: z.ZodEnum<{
+        text: "text";
+        binary: "binary";
+    }>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    fileName: z.ZodString;
+    mimeType: z.ZodString;
+    size: z.ZodNumber;
+    url: z.ZodString;
+    contentHash: z.ZodNullable<z.ZodString>;
+    usageCount: z.ZodNumber;
+    textStatus: z.ZodEnum<{
+        missing: "missing";
+        stale: "stale";
+        none: "none";
+        present: "present";
+    }>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type AssetVO = z.infer<typeof AssetVOSchema>;
+/** One place an asset is referenced — the row behind "Where Used". */
+declare const AssetUsageVOSchema: z.ZodObject<{
+    ownerType: z.ZodEnum<{
+        base: "base";
+        skill: "skill";
+        drive: "drive";
+        airapp: "airapp";
+        doc: "doc";
+        file_node: "file_node";
+    }>;
+    nodeId: z.ZodString;
+    nodeName: z.ZodString;
+    nodeType: z.ZodString;
+    nodeSlug: z.ZodString;
+    path: z.ZodNullable<z.ZodString>;
+    recordId: z.ZodNullable<z.ZodString>;
+    fieldSlug: z.ZodNullable<z.ZodString>;
+    blockId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type AssetUsageVO = z.infer<typeof AssetUsageVOSchema>;
+/** Asset detail = the library entry plus every place it is used. */
+declare const AssetDetailVOSchema: z.ZodObject<{
+    asset: z.ZodObject<{
+        id: z.ZodString;
+        attachmentId: z.ZodString;
+        name: z.ZodString;
+        contentKind: z.ZodEnum<{
+            text: "text";
+            binary: "binary";
+        }>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        fileName: z.ZodString;
+        mimeType: z.ZodString;
+        size: z.ZodNumber;
+        url: z.ZodString;
+        contentHash: z.ZodNullable<z.ZodString>;
+        usageCount: z.ZodNumber;
+        textStatus: z.ZodEnum<{
+            missing: "missing";
+            stale: "stale";
+            none: "none";
+            present: "present";
+        }>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>;
+    usages: z.ZodArray<z.ZodObject<{
+        ownerType: z.ZodEnum<{
+            base: "base";
+            skill: "skill";
+            drive: "drive";
+            airapp: "airapp";
+            doc: "doc";
+            file_node: "file_node";
+        }>;
+        nodeId: z.ZodString;
+        nodeName: z.ZodString;
+        nodeType: z.ZodString;
+        nodeSlug: z.ZodString;
+        path: z.ZodNullable<z.ZodString>;
+        recordId: z.ZodNullable<z.ZodString>;
+        fieldSlug: z.ZodNullable<z.ZodString>;
+        blockId: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type AssetDetailVO = z.infer<typeof AssetDetailVOSchema>;
+/** Files-only grep input used internally and by the SDK's `assets.grep` convenience adapter. */
+declare const GrepInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    flags: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    scope: z.ZodOptional<z.ZodObject<{
+        assetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        drivePath: z.ZodOptional<z.ZodString>;
+        mimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    maxMatches: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    contextLines: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+}, z.core.$strip>;
+/** Caller input before Zod applies defaults. */
+type GrepInputDTO = z.input<typeof GrepInputSchema>;
+declare const GrepResultVOSchema: z.ZodObject<{
+    matches: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        fileName: z.ZodString;
+        drivePath: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        text: z.ZodString;
+        before: z.ZodArray<z.ZodString>;
+        after: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    filesScanned: z.ZodNumber;
+    missing: z.ZodArray<z.ZodString>;
+    stale: z.ZodArray<z.ZodString>;
+    unsearchable: z.ZodNumber;
+    errored: z.ZodArray<z.ZodString>;
+    notReached: z.ZodNumber;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+type GrepResultVO = z.infer<typeof GrepResultVOSchema>;
+
 /**
  * Node-type registry. Each node type is its own module (./folder, ./base,
  * ./skill, …); this file **registers** them and derives everything else.
@@ -10324,35 +10571,6 @@ declare const cloudContract: {
             storageKey: z.ZodString;
             expiresIn: z.ZodNumber;
         }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
-        grep: _orpc_contract.ContractProcedure<z.ZodObject<{
-            pattern: z.ZodString;
-            flags: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            scope: z.ZodOptional<z.ZodObject<{
-                assetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                drivePath: z.ZodOptional<z.ZodString>;
-                mimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            }, z.core.$strip>>;
-            maxMatches: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-            contextLines: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-        }, z.core.$strip>, z.ZodObject<{
-            matches: z.ZodArray<z.ZodObject<{
-                assetId: z.ZodString;
-                fileName: z.ZodString;
-                drivePath: z.ZodString;
-                line: z.ZodNumber;
-                column: z.ZodNumber;
-                text: z.ZodString;
-                before: z.ZodArray<z.ZodString>;
-                after: z.ZodArray<z.ZodString>;
-            }, z.core.$strip>>;
-            filesScanned: z.ZodNumber;
-            missing: z.ZodArray<z.ZodString>;
-            stale: z.ZodArray<z.ZodString>;
-            unsearchable: z.ZodNumber;
-            errored: z.ZodArray<z.ZodString>;
-            notReached: z.ZodNumber;
-            truncated: z.ZodBoolean;
-        }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
         readTextLines: _orpc_contract.ContractProcedure<z.ZodObject<{
             assetId: z.ZodString;
             startLine: z.ZodCoercedNumber<unknown>;
@@ -14388,214 +14606,224 @@ declare const cloudContract: {
             }, z.core.$strip>>;
             nextCursor: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
-        count: _orpc_contract.ContractProcedure<z.ZodDefault<z.ZodOptional<z.ZodObject<{
-            baseId: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>, z.ZodObject<{
-            total: z.ZodNumber;
-        }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
-        get: _orpc_contract.ContractProcedure<z.ZodObject<{
-            recordId: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            id: z.ZodString;
+        listPage: _orpc_contract.ContractProcedure<z.ZodObject<{
             baseId: z.ZodString;
-            headCommitId: z.ZodString;
-            parentRecordId: z.ZodNullable<z.ZodString>;
-            parentCommitId: z.ZodNullable<z.ZodString>;
-            status: z.ZodEnum<{
-                active: "active";
-                archived: "archived";
-            }>;
-            createdBy: z.ZodString;
-            createdByUser: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                id: z.ZodString;
-                name: z.ZodNullable<z.ZodString>;
-                email: z.ZodNullable<z.ZodString>;
-                image: z.ZodNullable<z.ZodString>;
-                role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            }, z.core.$strip>>>>;
-            archivedAt: z.ZodNullable<z.ZodString>;
-            createdAt: z.ZodString;
-            updatedAt: z.ZodString;
-            base: z.ZodObject<{
+            viewId: z.ZodOptional<z.ZodString>;
+            page: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            pageSize: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            records: z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
-                nodeId: z.ZodString;
-                slug: z.ZodString;
-                name: z.ZodString;
-                description: z.ZodString;
-                reviewPolicy: z.ZodObject<{
-                    kind: z.ZodLiteral<"single">;
-                    requiredApprovals: z.ZodNumber;
-                }, z.core.$strip>;
+                baseId: z.ZodString;
+                headCommitId: z.ZodString;
+                parentRecordId: z.ZodNullable<z.ZodString>;
+                parentCommitId: z.ZodNullable<z.ZodString>;
+                status: z.ZodEnum<{
+                    active: "active";
+                    archived: "archived";
+                }>;
+                createdBy: z.ZodString;
+                createdByUser: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    id: z.ZodString;
+                    name: z.ZodNullable<z.ZodString>;
+                    email: z.ZodNullable<z.ZodString>;
+                    image: z.ZodNullable<z.ZodString>;
+                    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>>;
+                archivedAt: z.ZodNullable<z.ZodString>;
                 createdAt: z.ZodString;
-                fields: z.ZodArray<z.ZodObject<{
+                updatedAt: z.ZodString;
+                base: z.ZodObject<{
                     id: z.ZodString;
-                    baseId: z.ZodString;
+                    nodeId: z.ZodString;
                     slug: z.ZodString;
-                    name: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodEnum<{
-                        en: "en";
-                        "zh-CN": "zh-CN";
-                        "zh-TW": "zh-TW";
-                        ja: "ja";
-                        ko: "ko";
-                        de: "de";
-                        fr: "fr";
-                        es: "es";
-                        pt: "pt";
-                    }> & z.core.$partial, z.ZodString>]>;
-                    type: z.ZodEnum<{
-                        number: "number";
-                        email: "email";
-                        date: "date";
-                        text: "text";
-                        whiteboard: "whiteboard";
-                        html: "html";
-                        longtext: "longtext";
-                        markdown: "markdown";
-                        attachment: "attachment";
-                        relation: "relation";
-                        checkbox: "checkbox";
-                        select: "select";
-                        multiselect: "multiselect";
-                        url: "url";
-                        embed: "embed";
-                        phone: "phone";
-                        created_time: "created_time";
-                        updated_time: "updated_time";
-                        created_by: "created_by";
-                        updated_by: "updated_by";
-                        auto_number: "auto_number";
-                        ai_summary: "ai_summary";
-                        ai_tags: "ai_tags";
-                        code: "code";
-                        json: "json";
-                        yaml: "yaml";
-                        formula: "formula";
-                        lookup: "lookup";
-                    }>;
-                    required: z.ZodBoolean;
-                    position: z.ZodNumber;
-                    options: z.ZodDefault<z.ZodObject<{
-                        ai: z.ZodOptional<z.ZodObject<{
-                            model: z.ZodOptional<z.ZodString>;
-                            prompt: z.ZodOptional<z.ZodString>;
-                            reviewRequired: z.ZodOptional<z.ZodBoolean>;
-                            sourceFieldIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                        }, z.core.$strip>>;
-                        attachment: z.ZodOptional<z.ZodObject<{
-                            maxFiles: z.ZodOptional<z.ZodNumber>;
-                            allowedMimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                            maxFileSize: z.ZodOptional<z.ZodNumber>;
-                        }, z.core.$strip>>;
-                        choices: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                            color: z.ZodOptional<z.ZodString>;
-                            id: z.ZodString;
-                            name: z.ZodString;
-                        }, z.core.$strip>>>;
-                        code: z.ZodOptional<z.ZodObject<{
-                            language: z.ZodOptional<z.ZodString>;
-                        }, z.core.$strip>>;
-                        embed: z.ZodOptional<z.ZodObject<{
-                            aspectRatio: z.ZodOptional<z.ZodEnum<{
-                                "16:9": "16:9";
-                                "4:3": "4:3";
-                                "1:1": "1:1";
-                            }>>;
-                            height: z.ZodOptional<z.ZodNumber>;
-                            providers: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                        }, z.core.$strip>>;
-                        formula: z.ZodOptional<z.ZodObject<{
-                            expression: z.ZodString;
-                        }, z.core.$strip>>;
-                        inverseFieldId: z.ZodOptional<z.ZodString>;
-                        lookup: z.ZodOptional<z.ZodObject<{
-                            relationFieldSlug: z.ZodString;
-                            targetFieldSlug: z.ZodString;
-                            rollup: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
-                                values: "values";
-                                count: "count";
-                                sum: "sum";
-                                average: "average";
-                                min: "min";
-                                max: "max";
-                                concatenate: "concatenate";
-                            }>>>;
-                            limit: z.ZodOptional<z.ZodEnum<{
-                                all: "all";
-                                first: "first";
-                            }>>;
-                        }, z.core.$strip>>;
-                        multiple: z.ZodOptional<z.ZodBoolean>;
-                        number: z.ZodOptional<z.ZodObject<{
-                            format: z.ZodOptional<z.ZodEnum<{
-                                plain: "plain";
-                                currency: "currency";
-                            }>>;
-                            currency: z.ZodOptional<z.ZodString>;
-                            locale: z.ZodOptional<z.ZodString>;
+                    name: z.ZodString;
+                    description: z.ZodString;
+                    reviewPolicy: z.ZodObject<{
+                        kind: z.ZodLiteral<"single">;
+                        requiredApprovals: z.ZodNumber;
+                    }, z.core.$strip>;
+                    createdAt: z.ZodString;
+                    fields: z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        baseId: z.ZodString;
+                        slug: z.ZodString;
+                        name: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodEnum<{
+                            en: "en";
+                            "zh-CN": "zh-CN";
+                            "zh-TW": "zh-TW";
+                            ja: "ja";
+                            ko: "ko";
+                            de: "de";
+                            fr: "fr";
+                            es: "es";
+                            pt: "pt";
+                        }> & z.core.$partial, z.ZodString>]>;
+                        type: z.ZodEnum<{
+                            number: "number";
+                            email: "email";
+                            date: "date";
+                            text: "text";
+                            whiteboard: "whiteboard";
+                            html: "html";
+                            longtext: "longtext";
+                            markdown: "markdown";
+                            attachment: "attachment";
+                            relation: "relation";
+                            checkbox: "checkbox";
+                            select: "select";
+                            multiselect: "multiselect";
+                            url: "url";
+                            embed: "embed";
+                            phone: "phone";
+                            created_time: "created_time";
+                            updated_time: "updated_time";
+                            created_by: "created_by";
+                            updated_by: "updated_by";
+                            auto_number: "auto_number";
+                            ai_summary: "ai_summary";
+                            ai_tags: "ai_tags";
+                            code: "code";
+                            json: "json";
+                            yaml: "yaml";
+                            formula: "formula";
+                            lookup: "lookup";
+                        }>;
+                        required: z.ZodBoolean;
+                        position: z.ZodNumber;
+                        options: z.ZodDefault<z.ZodObject<{
+                            ai: z.ZodOptional<z.ZodObject<{
+                                model: z.ZodOptional<z.ZodString>;
+                                prompt: z.ZodOptional<z.ZodString>;
+                                reviewRequired: z.ZodOptional<z.ZodBoolean>;
+                                sourceFieldIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                            }, z.core.$strip>>;
+                            attachment: z.ZodOptional<z.ZodObject<{
+                                maxFiles: z.ZodOptional<z.ZodNumber>;
+                                allowedMimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                                maxFileSize: z.ZodOptional<z.ZodNumber>;
+                            }, z.core.$strip>>;
+                            choices: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                color: z.ZodOptional<z.ZodString>;
+                                id: z.ZodString;
+                                name: z.ZodString;
+                            }, z.core.$strip>>>;
+                            code: z.ZodOptional<z.ZodObject<{
+                                language: z.ZodOptional<z.ZodString>;
+                            }, z.core.$strip>>;
+                            embed: z.ZodOptional<z.ZodObject<{
+                                aspectRatio: z.ZodOptional<z.ZodEnum<{
+                                    "16:9": "16:9";
+                                    "4:3": "4:3";
+                                    "1:1": "1:1";
+                                }>>;
+                                height: z.ZodOptional<z.ZodNumber>;
+                                providers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                            }, z.core.$strip>>;
+                            formula: z.ZodOptional<z.ZodObject<{
+                                expression: z.ZodString;
+                            }, z.core.$strip>>;
+                            inverseFieldId: z.ZodOptional<z.ZodString>;
+                            lookup: z.ZodOptional<z.ZodObject<{
+                                relationFieldSlug: z.ZodString;
+                                targetFieldSlug: z.ZodString;
+                                rollup: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                                    values: "values";
+                                    count: "count";
+                                    sum: "sum";
+                                    average: "average";
+                                    min: "min";
+                                    max: "max";
+                                    concatenate: "concatenate";
+                                }>>>;
+                                limit: z.ZodOptional<z.ZodEnum<{
+                                    all: "all";
+                                    first: "first";
+                                }>>;
+                            }, z.core.$strip>>;
+                            multiple: z.ZodOptional<z.ZodBoolean>;
+                            number: z.ZodOptional<z.ZodObject<{
+                                format: z.ZodOptional<z.ZodEnum<{
+                                    plain: "plain";
+                                    currency: "currency";
+                                }>>;
+                                currency: z.ZodOptional<z.ZodString>;
+                                locale: z.ZodOptional<z.ZodString>;
+                            }, z.core.$strip>>;
+                            targetBaseId: z.ZodOptional<z.ZodString>;
+                            targetBaseSlug: z.ZodOptional<z.ZodString>;
                         }, z.core.$strip>>;
-                        targetBaseId: z.ZodOptional<z.ZodString>;
-                        targetBaseSlug: z.ZodOptional<z.ZodString>;
                     }, z.core.$strip>>;
-                }, z.core.$strip>>;
-            }, z.core.$strip>;
-            headCommit: z.ZodObject<{
-                id: z.ZodString;
-                baseId: z.ZodNullable<z.ZodString>;
-                targetType: z.ZodEnum<{
-                    base: "base";
-                    node: "node";
-                }>;
-                nodeId: z.ZodNullable<z.ZodString>;
-                operationId: z.ZodNullable<z.ZodString>;
-                parentCommitId: z.ZodNullable<z.ZodString>;
-                fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-                operation: z.ZodEnum<{
-                    [x: `${string}_file_create`]: `${string}_file_create`;
-                    [x: `${string}_file_update`]: `${string}_file_update`;
-                    [x: `${string}_file_delete`]: `${string}_file_delete`;
-                    [x: `${string}_metadata_update`]: `${string}_metadata_update`;
-                    record_create: "record_create";
-                    record_update: "record_update";
-                    record_delete: "record_delete";
-                    record_variant: "record_variant";
-                    view_create: "view_create";
-                    view_update: "view_update";
-                    view_delete: "view_delete";
-                    view_restore: "view_restore";
-                    base_add_field: "base_add_field";
-                    base_delete_field: "base_delete_field";
-                    base_update_field: "base_update_field";
-                    base_convert_field: "base_convert_field";
-                    base_reorder_fields: "base_reorder_fields";
-                    base_restore_field: "base_restore_field";
-                    base_archive: "base_archive";
-                    base_restore: "base_restore";
-                    record_restore: "record_restore";
-                    doc_update: "doc_update";
-                    node_create: "node_create";
-                    node_rename: "node_rename";
-                    node_delete: "node_delete";
-                    node_restore: "node_restore";
-                    node_move: "node_move";
-                }>;
-                message: z.ZodString;
-                author: z.ZodString;
-                authorUser: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                }, z.core.$strip>;
+                headCommit: z.ZodObject<{
                     id: z.ZodString;
-                    name: z.ZodNullable<z.ZodString>;
-                    email: z.ZodNullable<z.ZodString>;
-                    image: z.ZodNullable<z.ZodString>;
-                    role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                }, z.core.$strip>>>>;
-                createdAt: z.ZodString;
-            }, z.core.$strip>;
+                    baseId: z.ZodNullable<z.ZodString>;
+                    targetType: z.ZodEnum<{
+                        base: "base";
+                        node: "node";
+                    }>;
+                    nodeId: z.ZodNullable<z.ZodString>;
+                    operationId: z.ZodNullable<z.ZodString>;
+                    parentCommitId: z.ZodNullable<z.ZodString>;
+                    fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    operation: z.ZodEnum<{
+                        [x: `${string}_file_create`]: `${string}_file_create`;
+                        [x: `${string}_file_update`]: `${string}_file_update`;
+                        [x: `${string}_file_delete`]: `${string}_file_delete`;
+                        [x: `${string}_metadata_update`]: `${string}_metadata_update`;
+                        record_create: "record_create";
+                        record_update: "record_update";
+                        record_delete: "record_delete";
+                        record_variant: "record_variant";
+                        view_create: "view_create";
+                        view_update: "view_update";
+                        view_delete: "view_delete";
+                        view_restore: "view_restore";
+                        base_add_field: "base_add_field";
+                        base_delete_field: "base_delete_field";
+                        base_update_field: "base_update_field";
+                        base_convert_field: "base_convert_field";
+                        base_reorder_fields: "base_reorder_fields";
+                        base_restore_field: "base_restore_field";
+                        base_archive: "base_archive";
+                        base_restore: "base_restore";
+                        record_restore: "record_restore";
+                        doc_update: "doc_update";
+                        node_create: "node_create";
+                        node_rename: "node_rename";
+                        node_delete: "node_delete";
+                        node_restore: "node_restore";
+                        node_move: "node_move";
+                    }>;
+                    message: z.ZodString;
+                    author: z.ZodString;
+                    authorUser: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                        id: z.ZodString;
+                        name: z.ZodNullable<z.ZodString>;
+                        email: z.ZodNullable<z.ZodString>;
+                        image: z.ZodNullable<z.ZodString>;
+                        role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    }, z.core.$strip>>>>;
+                    createdAt: z.ZodString;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            total: z.ZodNumber;
+            totalPages: z.ZodNumber;
+            page: z.ZodNumber;
+            pageSize: z.ZodNumber;
         }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
-        search: _orpc_contract.ContractProcedure<z.ZodObject<{
+        count: _orpc_contract.ContractProcedure<z.ZodDefault<z.ZodOptional<z.ZodObject<{
             baseId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>, z.ZodObject<{
+            total: z.ZodNumber;
+        }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+        get: _orpc_contract.ContractProcedure<z.ZodUnion<readonly [z.ZodObject<{
+            recordId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            baseId: z.ZodString;
             fieldSlug: z.ZodString;
             valueText: z.ZodString;
-            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        }, z.core.$strict>]>, z.ZodObject<{
             id: z.ZodString;
             baseId: z.ZodString;
             headCommitId: z.ZodString;
@@ -14789,12 +15017,22 @@ declare const cloudContract: {
                 }, z.core.$strip>>>>;
                 createdAt: z.ZodString;
             }, z.core.$strip>;
-        }, z.core.$strip>>, _orpc_contract.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
-        getByField: _orpc_contract.ContractProcedure<z.ZodObject<{
-            baseId: z.ZodString;
+        }, z.core.$strip>, _orpc_contract.MergedErrorMap<Record<never, never>, _orpc_contract.MergedErrorMap<Record<never, never>, {
+            BAD_REQUEST: {
+                status: number;
+                message: string;
+            };
+            NOT_FOUND: {
+                status: number;
+                message: string;
+            };
+        }>>, Record<never, never>>;
+        search: _orpc_contract.ContractProcedure<z.ZodObject<{
+            baseId: z.ZodOptional<z.ZodString>;
             fieldSlug: z.ZodString;
             valueText: z.ZodString;
-        }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
+            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             baseId: z.ZodString;
             headCommitId: z.ZodString;
@@ -16559,6 +16797,12 @@ declare const cloudContract: {
 };
 type CloudContract = typeof cloudContract;
 
+/**
+ * Normalize a user-supplied base URL to the server root. The API contract
+ * already carries `/api/v1`, so accept either form and strip the suffix.
+ */
+declare function normalizeBaseUrl(raw: string): string;
+
 /**
  * The fully-typed Busabase client. Built over the *cloud* contract, which is a
  * strict superset of the OSS workbench contract (it adds the cloud-only `/api/v1`
@@ -16615,12 +16859,6 @@ interface ResolvedConfig {
     headers?: BusabaseConfig["headers"];
     fetch?: typeof fetch;
 }
-/**
- * Normalise a user-supplied base URL to the server root. The contract already
- * carries the `/api/v1` prefix (`OpenAPILink` appends it), so accept either form
- * (`http://host` or `http://host/api/v1`) and strip the suffix if present.
- */
-declare function normalizeBaseUrl(raw: string): string;
 /** Fill in missing config fields from environment variables and defaults. */
 declare function resolveConfig(config?: BusabaseConfig): ResolvedConfig;
 /**
@@ -16648,6 +16886,15 @@ declare function resolveConfig(config?: BusabaseConfig): ResolvedConfig;
  */
 declare function createBusabaseClient(config?: BusabaseConfig): BusabaseClient;
 
+/** The SDK keeps the familiar files-only helper without keeping a second HTTP operation. */
+type BusabaseAssetsClient = BusabaseClient["assets"] & {
+    grep(input: GrepInputDTO): Promise<GrepResultVO>;
+};
+declare const toUnifiedFilesGrepInput: (input: GrepInputDTO) => UnifiedGrepInputDTO;
+declare const toFilesOnlyGrepResult: (result: UnifiedGrepResultVO) => GrepResultVO;
+/** Call unified grep as files-only while preserving the former asset helper result shape. */
+declare const grepAssets: (client: Pick<BusabaseClient, "grep">, input: GrepInputDTO) => Promise<GrepResultVO>;
+
 /**
  * Attachments — DTO/VO Zod schemas + inferred types (the contract's type source
  * of truth). `schema/` is reserved for DB (PO); DTO/VO live here.
@@ -18284,118 +18531,6 @@ interface FileTreeReadFileVO {
     contentHash: string;
 }
 
-/**
- * Assets — VO Zod schemas (the contract's output source of truth). Pure zod, no
- * logic/db imports (client-safe). `schema/` holds the PO; these are the VOs the
- * `/assets` library and the "where-used" panel render.
- */
-
-/**
- * Derived text-slot status for an Asset (Drive Grep Retrieval). `missing` is
- * the absence of a `busabase_asset_texts` row (no writer has supplied text
- * yet, or a pre-existing asset hasn't been lazily self-healed by a grep call);
- * `present` / `none` / `stale` are the row's own `status` column.
- */
-declare const AssetTextStatusSchema: z.ZodEnum<{
-    missing: "missing";
-    stale: "stale";
-    none: "none";
-    present: "present";
-}>;
-type AssetTextStatus = z.infer<typeof AssetTextStatusSchema>;
-/** One library entry: the deduped file + its busabase metadata + usage count. */
-declare const AssetVOSchema: z.ZodObject<{
-    id: z.ZodString;
-    attachmentId: z.ZodString;
-    name: z.ZodString;
-    contentKind: z.ZodEnum<{
-        text: "text";
-        binary: "binary";
-    }>;
-    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    fileName: z.ZodString;
-    mimeType: z.ZodString;
-    size: z.ZodNumber;
-    url: z.ZodString;
-    contentHash: z.ZodNullable<z.ZodString>;
-    usageCount: z.ZodNumber;
-    textStatus: z.ZodEnum<{
-        missing: "missing";
-        stale: "stale";
-        none: "none";
-        present: "present";
-    }>;
-    createdAt: z.ZodString;
-}, z.core.$strip>;
-type AssetVO = z.infer<typeof AssetVOSchema>;
-/** One place an asset is referenced — the row behind "Where Used". */
-declare const AssetUsageVOSchema: z.ZodObject<{
-    ownerType: z.ZodEnum<{
-        base: "base";
-        skill: "skill";
-        drive: "drive";
-        airapp: "airapp";
-        doc: "doc";
-        file_node: "file_node";
-    }>;
-    nodeId: z.ZodString;
-    nodeName: z.ZodString;
-    nodeType: z.ZodString;
-    nodeSlug: z.ZodString;
-    path: z.ZodNullable<z.ZodString>;
-    recordId: z.ZodNullable<z.ZodString>;
-    fieldSlug: z.ZodNullable<z.ZodString>;
-    blockId: z.ZodNullable<z.ZodString>;
-    createdAt: z.ZodString;
-}, z.core.$strip>;
-type AssetUsageVO = z.infer<typeof AssetUsageVOSchema>;
-/** Asset detail = the library entry plus every place it is used. */
-declare const AssetDetailVOSchema: z.ZodObject<{
-    asset: z.ZodObject<{
-        id: z.ZodString;
-        attachmentId: z.ZodString;
-        name: z.ZodString;
-        contentKind: z.ZodEnum<{
-            text: "text";
-            binary: "binary";
-        }>;
-        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        fileName: z.ZodString;
-        mimeType: z.ZodString;
-        size: z.ZodNumber;
-        url: z.ZodString;
-        contentHash: z.ZodNullable<z.ZodString>;
-        usageCount: z.ZodNumber;
-        textStatus: z.ZodEnum<{
-            missing: "missing";
-            stale: "stale";
-            none: "none";
-            present: "present";
-        }>;
-        createdAt: z.ZodString;
-    }, z.core.$strip>;
-    usages: z.ZodArray<z.ZodObject<{
-        ownerType: z.ZodEnum<{
-            base: "base";
-            skill: "skill";
-            drive: "drive";
-            airapp: "airapp";
-            doc: "doc";
-            file_node: "file_node";
-        }>;
-        nodeId: z.ZodString;
-        nodeName: z.ZodString;
-        nodeType: z.ZodString;
-        nodeSlug: z.ZodString;
-        path: z.ZodNullable<z.ZodString>;
-        recordId: z.ZodNullable<z.ZodString>;
-        fieldSlug: z.ZodNullable<z.ZodString>;
-        blockId: z.ZodNullable<z.ZodString>;
-        createdAt: z.ZodString;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-type AssetDetailVO = z.infer<typeof AssetDetailVOSchema>;
-
 declare const FileNodeMetadataSchema: z.ZodObject<{
     assetId: z.ZodString;
 }, z.core.$strip>;
@@ -18799,6 +18934,21 @@ interface AuditEventVO {
     createdAt: string;
 }
 
+interface RecordByFieldInput {
+    baseId: string;
+    fieldSlug: string;
+    valueText: string;
+}
+/** The SDK retains the former field-addressed helper over the canonical get operation. */
+type BusabaseRecordsClient = BusabaseClient["records"] & {
+    getByField(input: RecordByFieldInput): Promise<RecordVO | null>;
+};
+/**
+ * Preserve the former nullable SDK result while the canonical REST operation
+ * consistently reports a missing record as 404 for either selector mode.
+ */
+declare const getRecordByField: (client: Pick<BusabaseClient, "records">, input: RecordByFieldInput) => Promise<RecordVO | null>;
+
 /**
  * Ergonomic entry point to the Busabase API — a thin, fully-typed wrapper around
  * {@link createBusabaseClient}. Prefer this when you want a single object with
@@ -18826,7 +18976,7 @@ declare class Busabase {
     readonly config: ResolvedConfig;
     constructor(config?: BusabaseConfig);
     get bases(): BusabaseClient["bases"];
-    get records(): BusabaseClient["records"];
+    get records(): BusabaseRecordsClient;
     get views(): BusabaseClient["views"];
     get changeRequests(): BusabaseClient["changeRequests"];
     get operations(): BusabaseClient["operations"];
@@ -18834,7 +18984,7 @@ declare class Busabase {
     get comments(): BusabaseClient["comments"];
     get auditEvents(): BusabaseClient["auditEvents"];
     get agent(): BusabaseClient["agent"];
-    get assets(): BusabaseClient["assets"];
+    get assets(): BusabaseAssetsClient;
     /** Skills, Drives, and AirApps — one surface, discriminated by `type`. */
     get fileTrees(): BusabaseClient["fileTrees"];
     get files(): BusabaseClient["files"];
@@ -18864,10 +19014,8 @@ declare class Busabase {
      * source (Drive/Skill files, Doc bodies, and Base records — records read
      * the canonical `headCommit.fields`, never the truncated search
      * projection), with a shared `maxMatches`/deadline budget and per-source
-     * honest coverage. Use this when the answer could live anywhere; use
-     * `client.assets.grep` directly instead when you specifically only care
-     * about files and want its fuller `missing`/`stale`/`unsearchable`
-     * file-only reporting.
+     * honest coverage. `bb.assets.grep` remains available as a files-only SDK
+     * convenience and delegates here with `sources: ["files"]`.
      */
     grep(input: Parameters<BusabaseClient["grep"]>[0]): _orpc_client.ClientPromiseResult<{
         matches: ({
@@ -18960,4 +19108,4 @@ declare class Busabase {
     }>>>>;
 }
 
-export { type ActivityItemVO, type AgentTaskVO, type FileTreeFileVO as AirAppFileVO, type FileTreeReadFileVO as AirAppReadFileVO, type FileTreeNodeVO as AirAppVO, type AssetAttachmentRef, type AssetDetailVO, type AssetTextStatus, type AssetUsageVO, type AssetVO, type AttachmentRef, type AuditAction, type AuditEventVO, type BaseFieldVO, type BaseVO, Busabase, type BusabaseClient, type BusabaseConfig, CREATABLE_NODE_TYPES, type ChangeRequestBatchResultVO, type ChangeRequestCountsVO, type ChangeRequestStatus, type ChangeRequestTargetType, type ChangeRequestVO, type CloudContract, type CommentSubjectType, type CommentVO, type CommitVO, type CreatableNodeType, type CreateFormDTO, DEFAULT_BASE_URL, type FileTreeFileVO as DriveFileVO, type FileTreeReadFileVO as DriveReadFileVO, type FileTreeNodeVO as DriveVO, type FieldType, type FileNodeMetadata, type FileNodeVO, type FileTreeFileVO, type FileTreeNodeVO, type FileTreeReadFileVO, type FormFieldBindingVO, type FormPageSourceVO, type FormShareVO, type FormSubmitResultVO, type FormThemeVO, type FormVO, type GalleryCardSize, type GalleryCoverFit, type GanttScale, type LookupRollup, type NodeSearchResultVO, type NodeType, type NodeVO, type OperationKind, type OperationStatus, type OperationVO, type RecordLinkVO, type RecordVO, type ResolvedConfig, type ReviewVO, type ReviewVerdict, type SearchResponseVO, type SearchResultKind, type SearchResultVO, type FileTreeFileVO as SkillFileVO, type FileTreeReadFileVO as SkillReadFileVO, type FileTreeNodeVO as SkillVO, type SubmitFormDTO, type UpdateFormDTO, type UpdateVaultSettingsDTO, type UserRefVO, VIEW_FIELD_MAX_WIDTH, VIEW_FIELD_MIN_WIDTH, type VaultAccessPolicy, type VaultEnvironment, type VaultItemInput, type VaultItemKind, type VaultItemVO, type VaultRuntimeEnv, type VaultScopeType, type VaultSettingsVO, type ViewConfigVO, type ViewFilterOperator, type ViewFilterVO, type ViewSortVO, type ViewType, type ViewVO, cloudContract, createBusabaseClient, normalizeBaseUrl, resolveConfig };
+export { type ActivityItemVO, type AgentTaskVO, type FileTreeFileVO as AirAppFileVO, type FileTreeReadFileVO as AirAppReadFileVO, type FileTreeNodeVO as AirAppVO, type AssetAttachmentRef, type AssetDetailVO, type AssetTextStatus, type AssetUsageVO, type AssetVO, type AttachmentRef, type AuditAction, type AuditEventVO, type BaseFieldVO, type BaseVO, Busabase, type BusabaseAssetsClient, type BusabaseClient, type BusabaseConfig, type BusabaseRecordsClient, CREATABLE_NODE_TYPES, type ChangeRequestBatchResultVO, type ChangeRequestCountsVO, type ChangeRequestStatus, type ChangeRequestTargetType, type ChangeRequestVO, type CloudContract, type CommentSubjectType, type CommentVO, type CommitVO, type CreatableNodeType, type CreateFormDTO, DEFAULT_BASE_URL, type FileTreeFileVO as DriveFileVO, type FileTreeReadFileVO as DriveReadFileVO, type FileTreeNodeVO as DriveVO, type FieldType, type FileNodeMetadata, type FileNodeVO, type FileTreeFileVO, type FileTreeNodeVO, type FileTreeReadFileVO, type FormFieldBindingVO, type FormPageSourceVO, type FormShareVO, type FormSubmitResultVO, type FormThemeVO, type FormVO, type GalleryCardSize, type GalleryCoverFit, type GanttScale, type LookupRollup, type NodeSearchResultVO, type NodeType, type NodeVO, type OperationKind, type OperationStatus, type OperationVO, type RecordByFieldInput, type RecordLinkVO, type RecordVO, type ResolvedConfig, type ReviewVO, type ReviewVerdict, type SearchResponseVO, type SearchResultKind, type SearchResultVO, type FileTreeFileVO as SkillFileVO, type FileTreeReadFileVO as SkillReadFileVO, type FileTreeNodeVO as SkillVO, type SubmitFormDTO, type UpdateFormDTO, type UpdateVaultSettingsDTO, type UserRefVO, VIEW_FIELD_MAX_WIDTH, VIEW_FIELD_MIN_WIDTH, type VaultAccessPolicy, type VaultEnvironment, type VaultItemInput, type VaultItemKind, type VaultItemVO, type VaultRuntimeEnv, type VaultScopeType, type VaultSettingsVO, type ViewConfigVO, type ViewFilterOperator, type ViewFilterVO, type ViewSortVO, type ViewType, type ViewVO, cloudContract, createBusabaseClient, getRecordByField, grepAssets, normalizeBaseUrl, resolveConfig, toFilesOnlyGrepResult, toUnifiedFilesGrepInput };