busabase-sdk 0.1.0 → 0.9.3

package/dist/index.js

@@ -1,6 +1,6 @@
 import { createORPCClient } from '@orpc/client';
 import { OpenAPILink } from '@orpc/openapi-client/fetch';
-import { oc } from '@orpc/contract';
+import { oc, eventIterator } from '@orpc/contract';
 import { z } from 'zod';
 
 // src/client.ts
@@ -44,36 +44,24 @@ var RequestUploadUrlVOSchema = z.object({
    */
   duplicate: z.boolean().optional(),
   /** Existing attachment id — present only when `duplicate` is true. */
-  attachmentId: z.string().optional()
+  attachmentId: z.string().optional(),
+  /** Host-specific logical asset id, when the app maps uploads into an Asset library. */
+  assetId: z.string().optional()
 });
 var ConfirmUploadVOSchema = z.object({
   success: z.boolean(),
   attachmentId: z.string(),
+  /** Host-specific logical asset id, when the app maps uploads into an Asset library. */
+  assetId: z.string().optional(),
   storageKey: z.string(),
   publicUrl: z.string()
 });
-
-// ../../packages/open-domains/attachments/contract.ts
-var attachmentsContract = oc.router({
-  createUploadUrl: oc.route({
-    method: "POST",
-    path: "/attachments/upload-urls",
-    tags: ["Attachments"],
-    summary: "Request upload URL",
-    successDescription: "Presigned (or dev) upload URL plus the public URL the file will resolve to."
-  }).input(RequestUploadUrlInputSchema).output(RequestUploadUrlVOSchema),
-  confirm: oc.route({
-    method: "POST",
-    path: "/attachments/confirmations",
-    tags: ["Attachments"],
-    summary: "Confirm upload",
-    successDescription: "Recorded attachment row and its public URL."
-  }).input(ConfirmUploadInputSchema).output(ConfirmUploadVOSchema)
-});
 var AssetVOSchema = z.object({
   id: z.string(),
   attachmentId: z.string(),
   name: z.string(),
+  contentKind: z.enum(["text", "binary"]),
+  metadata: z.record(z.string(), z.unknown()).default({}),
   fileName: z.string(),
   mimeType: z.string(),
   size: z.number().int().nonnegative(),
@@ -84,15 +72,20 @@ var AssetVOSchema = z.object({
   createdAt: z.string()
 });
 var AssetUsageVOSchema = z.object({
+  ownerType: z.enum(["drive", "skill", "base", "doc", "file_node"]),
   nodeId: z.string(),
   nodeName: z.string(),
   nodeType: z.string(),
   /** Node slug, so the UI can link to the owning Base/Doc (`/{type}/{slug}`). */
   nodeSlug: z.string(),
+  /** Drive/Skill mounted path, or null when the usage is not path-based. */
+  path: z.string().nullable(),
   /** Base record id, or null for whole-node usages (e.g. a Doc body). */
   recordId: z.string().nullable(),
   /** Attachment field slug, or null for whole-node usages. */
   fieldSlug: z.string().nullable(),
+  /** Doc block id, or null when the usage is not block-based. */
+  blockId: z.string().nullable(),
   createdAt: z.string()
 });
 var AssetDetailVOSchema = z.object({
@@ -101,7 +94,26 @@ var AssetDetailVOSchema = z.object({
 });
 
 // ../../packages/busabase-contract/src/domains/assets/contract.ts
+var UpdateAssetMetadataInputSchema = z.object({
+  assetId: z.string(),
+  metadata: z.record(z.string(), z.unknown()),
+  mode: z.enum(["merge", "replace"]).optional().default("merge")
+});
 var assetsContract = {
+  createUploadUrl: oc.route({
+    method: "POST",
+    path: "/assets/upload-urls",
+    tags: ["Assets"],
+    summary: "Request asset upload URL",
+    successDescription: "Presigned (or dev) upload URL plus the public URL and asset id when identical bytes are already in the library."
+  }).input(RequestUploadUrlInputSchema).output(RequestUploadUrlVOSchema),
+  confirm: oc.route({
+    method: "POST",
+    path: "/assets/confirmations",
+    tags: ["Assets"],
+    summary: "Confirm asset upload",
+    successDescription: "Recorded the file and ensured its Busabase Asset library entry."
+  }).input(ConfirmUploadInputSchema).output(ConfirmUploadVOSchema),
   list: oc.route({
     method: "GET",
     path: "/assets",
@@ -116,6 +128,13 @@ var assetsContract = {
     summary: "Get asset detail",
     successDescription: "Asset metadata plus every place it is referenced (where-used)."
   }).input(z.object({ assetId: z.string() })).output(AssetDetailVOSchema),
+  updateMetadata: oc.route({
+    method: "PATCH",
+    path: "/assets/{assetId}/metadata",
+    tags: ["Assets"],
+    summary: "Update asset metadata",
+    successDescription: "Updated AI-readable metadata for a file, such as summary, extracted text, tags, source URL, or schema-specific hints."
+  }).input(UpdateAssetMetadataInputSchema).output(AssetDetailVOSchema),
   delete: oc.route({
     method: "DELETE",
     path: "/assets/{assetId}",
@@ -151,6 +170,7 @@ var fieldTypeSchema = z.enum([
   "select",
   "multiselect",
   "url",
+  "embed",
   "email",
   "phone",
   "created_time",
@@ -160,7 +180,9 @@ var fieldTypeSchema = z.enum([
   "auto_number",
   "ai_summary",
   "ai_tags",
-  "code"
+  "code",
+  "json",
+  "yaml"
 ]);
 var fieldOptionsSchema = z.object({
   ai: z.object({
@@ -186,6 +208,11 @@ var fieldOptionsSchema = z.object({
   code: z.object({
     language: z.string().optional()
   }).optional(),
+  embed: z.object({
+    aspectRatio: z.enum(["16:9", "4:3", "1:1"]).optional(),
+    height: z.number().int().positive().max(1200).optional(),
+    providers: z.array(z.string()).optional()
+  }).optional(),
   inverseFieldId: z.string().optional(),
   multiple: z.boolean().optional(),
   // Display formatting for `number` columns (Notion-style: one number type,
@@ -195,7 +222,10 @@ var fieldOptionsSchema = z.object({
     currency: z.string().optional(),
     locale: z.string().optional()
   }).optional(),
-  targetBaseId: z.string().optional()
+  targetBaseId: z.string().optional().describe("Relation target Base id (bse_\u2026). Or pass targetBaseSlug to name it by slug."),
+  targetBaseSlug: z.string().optional().describe(
+    "Relation target Base by slug \u2014 a convenience alias for targetBaseId, resolved server-side (active bases in the current space). If both are given, targetBaseId wins."
+  )
 }).default({});
 var baseFieldSchema = z.object({
   id: z.string(),
@@ -394,6 +424,52 @@ var docNodeType = {
   ]
 };
 
+// ../../packages/busabase-contract/src/domains/filetree/definition.ts
+var fileTreeOperations = (type) => [
+  {
+    kind: `${type}_file_create`,
+    label: "Create file",
+    tone: "border-emerald-200 bg-emerald-50 text-emerald-800"
+  },
+  {
+    kind: `${type}_file_update`,
+    label: "Update file",
+    tone: "border-blue-200 bg-blue-50 text-blue-800"
+  },
+  {
+    kind: `${type}_file_delete`,
+    label: "Delete file",
+    tone: "border-rose-200 bg-rose-50 text-rose-800"
+  },
+  {
+    kind: `${type}_metadata_update`,
+    label: `Update ${type}`,
+    tone: "border-violet-200 bg-violet-50 text-violet-800"
+  }
+];
+var makeFileTreeNodeType = (config) => ({
+  type: config.type,
+  label: config.label,
+  icon: config.icon,
+  capabilities: { hasDetail: true, creatable: true },
+  operations: fileTreeOperations(config.type)
+});
+
+// ../../packages/busabase-contract/src/domains/drive/definition.ts
+var driveNodeType = makeFileTreeNodeType({
+  type: "drive",
+  label: "Drive",
+  icon: "hard-drive"});
+
+// ../../packages/busabase-contract/src/domains/file-node/definition.ts
+var fileNodeType = {
+  type: "file",
+  label: "File",
+  icon: "file",
+  capabilities: { hasDetail: true, creatable: true },
+  operations: []
+};
+
 // ../../packages/busabase-contract/src/domains/folder/definition.ts
 var folderNodeType = {
   type: "folder",
@@ -404,34 +480,10 @@ var folderNodeType = {
 };
 
 // ../../packages/busabase-contract/src/domains/skill/definition.ts
-var skillNodeType = {
+var skillNodeType = makeFileTreeNodeType({
   type: "skill",
   label: "Skill",
-  icon: "sparkles",
-  capabilities: { hasDetail: true, creatable: true },
-  operations: [
-    {
-      kind: "skill_file_create",
-      label: "Create file",
-      tone: "border-emerald-200 bg-emerald-50 text-emerald-800"
-    },
-    {
-      kind: "skill_file_update",
-      label: "Update file",
-      tone: "border-blue-200 bg-blue-50 text-blue-800"
-    },
-    {
-      kind: "skill_file_delete",
-      label: "Delete file",
-      tone: "border-rose-200 bg-rose-50 text-rose-800"
-    },
-    {
-      kind: "skill_metadata_update",
-      label: "Update skill",
-      tone: "border-violet-200 bg-violet-50 text-violet-800"
-    }
-  ]
-};
+  icon: "sparkles"});
 
 // ../../packages/busabase-contract/src/domains/registry.ts
 var GENERIC_NODE_OPERATIONS = [
@@ -457,6 +509,8 @@ var BUILTIN_NODE_TYPES = [
   folderNodeType,
   baseNodeType,
   skillNodeType,
+  driveNodeType,
+  fileNodeType,
   docNodeType
 ];
 for (const definition of BUILTIN_NODE_TYPES) {
@@ -493,10 +547,10 @@ var nodeSchema = z.lazy(
     name: z.string(),
     description: z.string(),
     metadata: z.object({
-      storagePrefix: z.string().optional(),
       entryFile: z.string().optional(),
       visibility: z.enum(["private", "workspace", "public"]).optional(),
-      version: z.string().optional()
+      version: z.string().optional(),
+      assetId: z.string().optional()
     }).default({}),
     position: z.number(),
     createdAt: z.string(),
@@ -505,6 +559,13 @@ var nodeSchema = z.lazy(
     children: z.array(nodeSchema)
   })
 );
+var userRefSchema = z.object({
+  id: z.string(),
+  name: z.string().nullable(),
+  email: z.string().nullable(),
+  image: z.string().nullable(),
+  role: z.string().nullable().optional()
+});
 var commitSchema = z.object({
   id: z.string(),
   baseId: z.string().nullable(),
@@ -516,6 +577,7 @@ var commitSchema = z.object({
   operation: z.enum(OPERATION_KINDS),
   message: z.string(),
   author: z.string(),
+  authorUser: userRefSchema.nullable().optional().default(null),
   createdAt: z.string()
 });
 var operationSchema = z.object({
@@ -551,6 +613,7 @@ var reviewSchema = z.object({
   id: z.string(),
   changeRequestId: z.string(),
   reviewerId: z.string(),
+  reviewer: userRefSchema.nullable().optional().default(null),
   verdict: z.enum(["approved", "rejected"]),
   reason: z.string().nullable(),
   visibleOperationHeads: z.record(z.string(), z.string()),
@@ -566,26 +629,29 @@ var commentSchema = z.object({
   operationId: z.string().nullable(),
   commitId: z.string().nullable(),
   authorId: z.string(),
+  author: userRefSchema.nullable().optional().default(null),
   body: z.string(),
   mentionsAi: z.boolean(),
   createdAt: z.string(),
   updatedAt: z.string()
 });
+var changeRequestStatusSchema = z.enum([
+  "in_review",
+  "changes_requested",
+  "approved",
+  "rejected",
+  "merged",
+  "abandoned",
+  "conflict"
+]);
 var changeRequestSchema = z.object({
   id: z.string(),
   baseId: z.string().nullable(),
   targetType: z.enum(["base", "node"]),
   nodeId: z.string().nullable(),
-  status: z.enum([
-    "in_review",
-    "changes_requested",
-    "approved",
-    "rejected",
-    "merged",
-    "abandoned",
-    "conflict"
-  ]),
+  status: changeRequestStatusSchema,
   submittedBy: z.string(),
+  submittedByUser: userRefSchema.nullable().optional().default(null),
   sourceMeta: z.record(z.string(), z.unknown()),
   reviewPolicySnapshot: z.record(z.string(), z.unknown()),
   mergeSummary: z.record(z.string(), z.unknown()),
@@ -609,7 +675,7 @@ var agentTaskSchema = z.object({
 });
 var searchResultSchema = z.object({
   id: z.string(),
-  kind: z.enum(["record", "change_request", "base"]),
+  kind: z.enum(["record", "change_request", "base", "file"]),
   title: z.string(),
   body: z.string(),
   eyebrow: z.string(),
@@ -623,6 +689,23 @@ var searchResponseSchema = z.object({
   hasMore: z.boolean(),
   results: z.array(searchResultSchema)
 });
+var liveEventSchema = z.object({
+  kind: z.enum([
+    "change_request.created",
+    "change_request.updated",
+    "change_request.deleted",
+    "change_request.reviewed",
+    "change_request.merged"
+  ]),
+  spaceId: z.string(),
+  actorId: z.string(),
+  changeRequestId: z.string(),
+  baseId: z.string().nullable(),
+  nodeIds: z.array(z.string()),
+  recordIds: z.array(z.string()),
+  viewIds: z.array(z.string()),
+  operationCount: z.number()
+});
 var auditActionSchema = z.enum([
   "record.viewed",
   "change_request.created",
@@ -637,14 +720,18 @@ var auditActionSchema = z.enum([
   "field.created",
   "doc.created",
   "doc.updated",
+  "file.created",
   "skill.created",
+  "drive.created",
   "asset.deleted",
+  "asset.metadata_updated",
   "node.purged"
 ]);
 var auditEventSchema = z.object({
   id: z.string(),
   action: auditActionSchema,
   actorId: z.string(),
+  actor: userRefSchema.nullable().optional().default(null),
   baseId: z.string().nullable(),
   recordId: z.string().nullable(),
   changeRequestId: z.string().nullable(),
@@ -666,7 +753,13 @@ var createAuditEventInputSchema = z.object({
 var nodeOperationInputSchema = z.discriminatedUnion("kind", [
   z.object({
     kind: z.literal("create"),
+    ref: z.string().min(1).optional().describe(
+      'Optional in-change-request temp id for this node. A later operation can set parentNodeRef to this value to nest under it \u2014 e.g. create a folder with ref "growth", then create Bases with parentNodeRef "growth", all in one change request.'
+    ),
     parentNodeId: z.string().optional(),
+    parentNodeRef: z.string().min(1).optional().describe(
+      "Parent this node under a node an EARLIER operation in the same change request created (matched by its ref). Mutually exclusive with parentNodeId."
+    ),
     nodeType: z.enum(CREATABLE_NODE_TYPES),
     slug: z.string().min(1).regex(/^[a-z0-9-]+$/),
     name: z.string().min(1),
@@ -701,7 +794,9 @@ var nodeOperationInputSchema = z.discriminatedUnion("kind", [
   z.object({
     kind: z.literal("move"),
     nodeId: z.string(),
-    parentNodeId: z.string(),
+    // Exactly one of parentNodeId / parentNodeRef (a ref created earlier in this CR).
+    parentNodeId: z.string().optional(),
+    parentNodeRef: z.string().min(1).optional(),
     position: z.number().int().optional()
   })
 ]);
@@ -710,6 +805,9 @@ var createNodeChangeRequestInputSchema = z.object({
     'Explanation shown to the human reviewer. Write a conventional-commit style subject \u2014 imperative verb + what + why, e.g. "Reorganize marketing docs under a Campaigns folder".'
   ),
   submittedBy: z.string().optional().default("local-producer"),
+  autoMerge: z.boolean().optional().default(false).describe(
+    "Whether to approve and merge this structural node change immediately. Defaults to false so node Change Request creation is review-first unless explicitly requested."
+  ),
   operations: z.array(nodeOperationInputSchema).min(1)
 });
 var createDeleteChangeRequestInputSchema = z.object({
@@ -747,6 +845,25 @@ var createCommentInputSchema = commentSubjectInputSchema.extend({
 var listInputSchema = z.object({
   limit: z.coerce.number().int().min(1).max(100).optional().default(50)
 }).optional().default({ limit: 50 });
+var listChangeRequestsPagedInputSchema = z.object({
+  limit: z.coerce.number().int().min(1).max(100).optional().default(50),
+  /** Opaque base64 cursor (`createdAt|id`) for keyset pagination. */
+  cursor: z.string().optional(),
+  status: z.array(changeRequestStatusSchema).optional(),
+  mine: z.boolean().optional()
+}).optional().default({ limit: 50 });
+var listChangeRequestsResponseSchema = z.object({
+  changeRequests: z.array(changeRequestSchema),
+  nextCursor: z.string().nullable()
+});
+var changeRequestCountsSchema = z.object({
+  review: z.number().int().nonnegative(),
+  changes: z.number().int().nonnegative(),
+  created: z.number().int().nonnegative(),
+  approved: z.number().int().nonnegative(),
+  merged: z.number().int().nonnegative(),
+  rejected: z.number().int().nonnegative()
+});
 var searchInputSchema = z.object({
   query: z.string().default(""),
   limit: z.coerce.number().int().min(1).max(100).optional().default(20),
@@ -781,64 +898,6 @@ var authInfoSchema = z.object({
    */
   spaces: z.array(authSpaceSchema)
 });
-
-// ../../packages/busabase-contract/src/domains/base/contract/record-schemas.ts
-var recordSchema = z.object({
-  id: z.string(),
-  baseId: z.string(),
-  headCommitId: z.string(),
-  parentRecordId: z.string().nullable(),
-  parentCommitId: z.string().nullable(),
-  status: z.enum(["active", "archived"]),
-  createdBy: z.string(),
-  archivedAt: z.string().nullable(),
-  createdAt: z.string(),
-  updatedAt: z.string(),
-  base: baseSchema,
-  headCommit: commitSchema
-});
-var listRecordsInputSchema = z.object({
-  limit: z.coerce.number().int().min(1).max(100).optional().default(50),
-  baseId: z.string().optional(),
-  /** Opaque base64 cursor (`createdAt:id`) for keyset pagination. */
-  cursor: z.string().optional()
-}).optional().default({ limit: 50 });
-var listRecordsResponseSchema = z.object({
-  records: z.array(recordSchema),
-  nextCursor: z.string().nullable()
-});
-var createChangeRequestInputSchema = z.object({
-  fields: z.record(z.string(), z.unknown()).describe(
-    "Record field values keyed by field slug. The base's PRIMARY field (its first field) becomes the record's display name and the change request title everywhere \u2014 always give it a short, human-readable value, never an id or placeholder."
-  ),
-  message: z.string().optional().default("Initial change request").describe(
-    'Explanation shown to the human reviewer. Write a conventional-commit style subject \u2014 imperative verb + what + why, e.g. "Add Acme Corp \u2014 qualified lead from the June webinar".'
-  ),
-  submittedBy: z.string().optional().default("local-producer")
-});
-var recordFieldFilterInputSchema = z.object({
-  baseId: z.string().optional(),
-  fieldSlug: z.string().min(1),
-  valueText: z.string().min(1),
-  limit: z.coerce.number().int().min(1).max(100).optional().default(50)
-});
-var restoreRecordInputSchema = z.object({
-  message: z.string().optional(),
-  submittedBy: z.string().optional().default("local-editor")
-});
-var recordLinkSchema = z.object({
-  id: z.string(),
-  baseId: z.string(),
-  fieldId: z.string(),
-  fieldSlug: z.string(),
-  sourceRecordId: z.string(),
-  targetBaseId: z.string(),
-  targetRecordId: z.string(),
-  commitId: z.string(),
-  position: z.number(),
-  createdAt: z.string(),
-  updatedAt: z.string()
-});
 var viewFilterOperatorSchema = z.enum([
   "contains",
   "equals",
@@ -874,6 +933,7 @@ var viewSchema = z.object({
   config: viewConfigSchema,
   status: z.enum(["active", "archived"]),
   createdBy: z.string(),
+  createdByUser: userRefSchema.nullable().optional().default(null),
   archivedAt: z.string().nullable(),
   createdAt: z.string(),
   updatedAt: z.string()
@@ -902,7 +962,95 @@ var restoreViewInputSchema = z.object({
   submittedBy: z.string().optional().default("local-producer")
 });
 
-// ../../packages/busabase-contract/src/domains/base/contract/routes.ts
+// ../../packages/busabase-contract/src/domains/base/contract/record-schemas.ts
+var recordSchema = z.object({
+  id: z.string(),
+  baseId: z.string(),
+  headCommitId: z.string(),
+  parentRecordId: z.string().nullable(),
+  parentCommitId: z.string().nullable(),
+  status: z.enum(["active", "archived"]),
+  createdBy: z.string(),
+  createdByUser: userRefSchema.nullable().optional().default(null),
+  archivedAt: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+  base: baseSchema,
+  headCommit: commitSchema
+});
+var listRecordsFilterSchema = z.object({
+  fieldSlug: z.string(),
+  fieldType: z.string().optional(),
+  operator: viewFilterOperatorSchema,
+  value: z.unknown().optional()
+});
+var listRecordsSortSchema = z.object({
+  fieldSlug: z.string(),
+  fieldType: z.string().optional(),
+  direction: z.enum(["asc", "desc"]).optional().default("asc")
+});
+var listRecordsInputSchema = z.object({
+  limit: z.coerce.number().int().min(1).max(100).optional().default(50),
+  baseId: z.string().optional(),
+  /** Opaque base64 cursor for keyset pagination (createdAt-keyed, or sort-keyed when `sort` is set). */
+  cursor: z.string().optional(),
+  /** View filters for server-side push-down (superset; client still narrows). */
+  filters: z.array(listRecordsFilterSchema).optional(),
+  /** View sort for server-side push-down (number/date fields only). */
+  sort: listRecordsSortSchema.optional()
+}).optional().default({ limit: 50 });
+var listRecordsResponseSchema = z.object({
+  records: z.array(recordSchema),
+  nextCursor: z.string().nullable()
+});
+var countRecordsInputSchema = z.object({
+  baseId: z.string().optional()
+}).optional().default({});
+var countRecordsResponseSchema = z.object({
+  /** Total active records in the space (optionally scoped to a base). */
+  total: z.number().int().nonnegative()
+});
+var createChangeRequestInputSchema = z.object({
+  fields: z.record(z.string(), z.unknown()).describe(
+    "Record field values keyed by field slug. The base's PRIMARY field (its first field) becomes the record's display name and the change request title everywhere \u2014 always give it a short, human-readable value, never an id or placeholder."
+  ),
+  message: z.string().optional().default("Initial change request").describe(
+    'Explanation shown to the human reviewer. Write a conventional-commit style subject \u2014 imperative verb + what + why, e.g. "Add Acme Corp \u2014 qualified lead from the June webinar".'
+  ),
+  submittedBy: z.string().optional().default("local-producer")
+});
+var createBulkChangeRequestInputSchema = z.object({
+  records: z.array(z.record(z.string(), z.unknown())).min(1).max(1e3).describe(
+    "Field-value maps, one per record to create, each keyed by field slug. All records are proposed as a SINGLE change request (one review, one merge) \u2014 use this to import/seed many rows at once instead of one change request per record. Capped at 1000; for very large loads prefer a dedicated import job. Always give each record's PRIMARY field a short human-readable value."
+  ),
+  message: z.string().optional().default("Bulk create records").describe(
+    'Explanation shown to the human reviewer for the whole batch \u2014 e.g. "Import 240 June webinar leads".'
+  ),
+  submittedBy: z.string().optional().default("local-producer")
+});
+var recordFieldFilterInputSchema = z.object({
+  baseId: z.string().optional(),
+  fieldSlug: z.string().min(1),
+  valueText: z.string().min(1),
+  limit: z.coerce.number().int().min(1).max(100).optional().default(50)
+});
+var restoreRecordInputSchema = z.object({
+  message: z.string().optional(),
+  submittedBy: z.string().optional().default("local-editor")
+});
+var recordLinkSchema = z.object({
+  id: z.string(),
+  baseId: z.string(),
+  fieldId: z.string(),
+  fieldSlug: z.string(),
+  sourceRecordId: z.string(),
+  targetBaseId: z.string(),
+  targetRecordId: z.string(),
+  commitId: z.string(),
+  position: z.number(),
+  createdAt: z.string(),
+  updatedAt: z.string()
+});
 var baseContract = {
   list: oc.route({
     method: "GET",
@@ -967,6 +1115,13 @@ var baseContract = {
     summary: "Create Change Request in Base",
     successDescription: "Created change request for review."
   }).input(createChangeRequestInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema),
+  createBulkChangeRequest: oc.route({
+    method: "POST",
+    path: "/bases/{baseId}/records/bulk-change-request",
+    tags: ["Bases", "Change Requests"],
+    summary: "Create bulk record Change Request in Base",
+    successDescription: "Created one change request proposing many record creates."
+  }).input(createBulkChangeRequestInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema),
   createField: oc.route({
     method: "POST",
     path: "/bases/{baseId}/fields",
@@ -1060,6 +1215,13 @@ var recordContract = {
     summary: "List records with keyset pagination",
     successDescription: "A page of canonical records plus an opaque nextCursor (null at the end)."
   }).input(listRecordsInputSchema).output(listRecordsResponseSchema),
+  count: oc.route({
+    method: "GET",
+    path: "/records/count",
+    tags: ["Records"],
+    summary: "Count records",
+    successDescription: "Total active records in the space, optionally scoped to a base."
+  }).input(countRecordsInputSchema).output(countRecordsResponseSchema),
   get: oc.route({
     method: "GET",
     path: "/records/{recordId}",
@@ -1192,67 +1354,65 @@ var docContract = {
     successDescription: "Created a change request that proposes a new Doc body."
   }).input(createDocChangeRequestInputSchema.extend({ nodeId: z.string() })).output(changeRequestSchema)
 };
-var folderSchema = z.object({
-  node: nodeSchema,
-  children: z.array(nodeSchema)
-});
-var folderContract = {
-  list: oc.route({
-    method: "GET",
-    path: "/folders",
-    tags: ["Folders"],
-    summary: "List Folder nodes",
-    successDescription: "Folder nodes with their direct children."
-  }).output(z.array(folderSchema)),
-  get: oc.route({
-    method: "GET",
-    path: "/folders/{nodeId}",
-    tags: ["Folders"],
-    summary: "Get Folder node",
-    successDescription: "Folder node and its direct children."
-  }).input(z.object({ nodeId: z.string() })).output(folderSchema)
-};
-var skillFileSchema = z.object({
+var fileTreeFileSchema = z.object({
   path: z.string(),
   name: z.string(),
-  type: z.enum(["file", "folder"]),
   size: z.number(),
-  updatedAt: z.string().nullable()
-});
-var skillSchema = z.object({
+  updatedAt: z.string().nullable(),
+  mimeType: z.string().nullable(),
+  assetId: z.string(),
+  displayName: z.string().nullable()
+});
+var assetFileInputSchema = z.object({
+  path: z.string().min(1),
+  assetId: z.string().min(1),
+  displayName: z.string().optional(),
+  mimeType: z.string().optional()
+}).strict();
+var textFileInputSchema = z.object({
+  path: z.string().min(1),
+  content: z.string().default(""),
+  mimeType: z.string().optional()
+}).strict();
+var assetFileOperationInputSchema = z.object({
+  kind: z.enum(["create", "update"]),
+  path: z.string().min(1),
+  assetId: z.string().min(1),
+  displayName: z.string().optional(),
+  mimeType: z.string().optional(),
+  baseContentHash: z.string().optional()
+}).strict();
+var textFileOperationInputSchema = z.object({
+  kind: z.enum(["create", "update"]),
+  path: z.string().min(1),
+  content: z.string(),
+  mimeType: z.string().optional(),
+  baseContentHash: z.string().optional()
+}).strict();
+var fileTreeNodeSchema = z.object({
   node: nodeSchema,
-  storagePrefix: z.string(),
   entryFile: z.string(),
   visibility: z.enum(["private", "workspace", "public"]),
   version: z.string(),
-  files: z.array(skillFileSchema)
+  files: z.array(fileTreeFileSchema)
 });
-var createSkillInputSchema = z.object({
+var createFileTreeInputSchema = z.object({
   parentNodeId: z.string().optional(),
   slug: z.string().min(1).regex(/^[a-z0-9-]+$/),
   name: z.string().min(1),
   description: z.string().optional().default(""),
   visibility: z.enum(["private", "workspace", "public"]).optional().default("private"),
   version: z.string().optional().default("0.1.0"),
-  files: z.array(
-    z.object({
-      path: z.string().min(1),
-      content: z.string().default("")
-    })
-  ).optional().default([])
+  files: z.array(z.union([assetFileInputSchema, textFileInputSchema])).optional().default([])
 });
-var skillFileOperationInputSchema = z.discriminatedUnion("kind", [
-  z.object({
-    kind: z.enum(["create", "update"]),
-    path: z.string().min(1),
-    content: z.string(),
-    baseContentHash: z.string().optional()
-  }),
+var fileTreeFileOperationInputSchema = z.union([
+  assetFileOperationInputSchema,
+  textFileOperationInputSchema,
   z.object({
     kind: z.literal("delete"),
     path: z.string().min(1),
     baseContentHash: z.string().optional()
-  }),
+  }).strict(),
   z.object({
     kind: z.literal("metadata_update"),
     metadata: z.object({
@@ -1260,68 +1420,228 @@ var skillFileOperationInputSchema = z.discriminatedUnion("kind", [
       visibility: z.enum(["private", "workspace", "public"]).optional(),
       version: z.string().optional()
     }).default({})
-  })
+  }).strict()
 ]);
-var createSkillChangeRequestInputSchema = z.object({
-  message: z.string().optional().default("Update skill").describe(
-    'Explanation shown to the human reviewer. Write a conventional-commit style subject \u2014 imperative verb + what + why, e.g. "Rewrite SKILL.md quickstart for the new auth flow".'
+var createFileTreeChangeRequestInputSchema = z.object({
+  message: z.string().optional().default("Update file tree").describe(
+    'Explanation shown to the human reviewer. Write a conventional-commit style subject \u2014 imperative verb + what + why, e.g. "Rewrite README.md quickstart for the new auth flow".'
   ),
   submittedBy: z.string().optional().default("local-producer"),
-  operations: z.array(skillFileOperationInputSchema).min(1)
+  operations: z.array(fileTreeFileOperationInputSchema).min(1)
+});
+var makeFileTreeContract = (routeBase, tag) => {
+  const label = tag.endsWith("s") ? tag.slice(0, -1) : tag;
+  const basePath = `/${routeBase}`;
+  return {
+    list: oc.route({
+      method: "GET",
+      path: basePath,
+      tags: [tag],
+      summary: `List ${label} nodes`,
+      successDescription: `${label} nodes with their Asset-backed file trees.`
+    }).output(z.array(fileTreeNodeSchema)),
+    create: oc.route({
+      method: "POST",
+      path: basePath,
+      tags: [tag],
+      summary: `Create ${label} node`,
+      successDescription: `Created ${label} node and initialized file tree.`
+    }).input(createFileTreeInputSchema).output(fileTreeNodeSchema),
+    get: oc.route({
+      method: "GET",
+      path: `${basePath}/{nodeId}`,
+      tags: [tag],
+      summary: `Get ${label} node`,
+      successDescription: `${label} node detail and file tree.`
+    }).input(z.object({ nodeId: z.string() })).output(fileTreeNodeSchema),
+    listFiles: oc.route({
+      method: "GET",
+      path: `${basePath}/{nodeId}/files`,
+      tags: [tag],
+      summary: `List ${label} files`,
+      successDescription: `Asset-backed files mounted under the ${label} node.`
+    }).input(z.object({ nodeId: z.string() })).output(z.array(fileTreeFileSchema)),
+    readFile: oc.route({
+      method: "GET",
+      path: `${basePath}/{nodeId}/files/{+filePath}`,
+      tags: [tag],
+      summary: `Read ${label} file`,
+      successDescription: `${label} file content and content hash.`
+    }).input(z.object({ nodeId: z.string(), filePath: z.string() })).output(
+      z.object({
+        nodeId: z.string(),
+        path: z.string(),
+        encoding: z.enum(["utf8", "url"]),
+        content: z.string(),
+        mimeType: z.string(),
+        assetId: z.string(),
+        displayName: z.string().nullable(),
+        assetUrl: z.string().nullable(),
+        contentHash: z.string()
+      })
+    ),
+    createChangeRequest: oc.route({
+      method: "POST",
+      path: `${basePath}/{nodeId}/change-requests`,
+      tags: [tag, "Change Requests"],
+      summary: `Create ${label} change request`,
+      successDescription: `Created file-tree change request for a ${label} node.`
+    }).input(createFileTreeChangeRequestInputSchema.extend({ nodeId: z.string() })).output(changeRequestSchema)
+  };
+};
+
+// ../../packages/busabase-contract/src/domains/drive/contract.ts
+var driveContract = makeFileTreeContract("drives", "Drives");
+z.object({
+  assetId: z.string()
+});
+var FileNodeVOSchema = z.object({
+  node: nodeSchema,
+  asset: AssetVOSchema
+});
+
+// ../../packages/busabase-contract/src/domains/file-node/contract.ts
+var createFileNodeInputSchema = z.object({
+  parentNodeId: z.string().optional(),
+  slug: z.string().min(1).regex(/^[a-z0-9-]+$/),
+  name: z.string().min(1),
+  description: z.string().optional().default(""),
+  assetId: z.string().min(1)
 });
-var skillContract = {
+var fileContract = {
   list: oc.route({
     method: "GET",
-    path: "/skills",
-    tags: ["Skills"],
-    summary: "List Skill nodes",
-    successDescription: "Skill nodes with their storage-backed file trees."
-  }).output(z.array(skillSchema)),
+    path: "/files",
+    tags: ["Files"],
+    summary: "List File nodes",
+    successDescription: "Workspace File nodes with their backing Asset metadata."
+  }).output(z.array(FileNodeVOSchema)),
   create: oc.route({
     method: "POST",
-    path: "/skills",
-    tags: ["Skills"],
-    summary: "Create Skill node",
-    successDescription: "Created Skill node and initialized file tree."
-  }).input(createSkillInputSchema).output(skillSchema),
+    path: "/files",
+    tags: ["Files"],
+    summary: "Create File node",
+    successDescription: "Created a first-class File node that references an Asset."
+  }).input(createFileNodeInputSchema).output(FileNodeVOSchema),
   get: oc.route({
     method: "GET",
-    path: "/skills/{nodeId}",
-    tags: ["Skills"],
-    summary: "Get Skill node",
-    successDescription: "Skill node detail and file tree."
-  }).input(z.object({ nodeId: z.string() })).output(skillSchema),
-  listFiles: oc.route({
+    path: "/files/{nodeId}",
+    tags: ["Files"],
+    summary: "Get File node",
+    successDescription: "File node detail and backing Asset metadata."
+  }).input(z.object({ nodeId: z.string() })).output(FileNodeVOSchema)
+};
+var folderSchema = z.object({
+  node: nodeSchema,
+  children: z.array(nodeSchema)
+});
+var folderContract = {
+  list: oc.route({
     method: "GET",
-    path: "/skills/{nodeId}/files",
-    tags: ["Skills"],
-    summary: "List Skill files",
-    successDescription: "Storage-backed files under the Skill node prefix."
-  }).input(z.object({ nodeId: z.string() })).output(z.array(skillFileSchema)),
-  readFile: oc.route({
+    path: "/folders",
+    tags: ["Folders"],
+    summary: "List Folder nodes",
+    successDescription: "Folder nodes with their direct children."
+  }).output(z.array(folderSchema)),
+  get: oc.route({
     method: "GET",
-    path: "/skills/{nodeId}/files/{+filePath}",
-    tags: ["Skills"],
-    summary: "Read Skill file",
-    successDescription: "Skill file content and content hash."
-  }).input(z.object({ nodeId: z.string(), filePath: z.string() })).output(
-    z.object({
-      nodeId: z.string(),
-      path: z.string(),
-      content: z.string(),
-      contentHash: z.string()
-    })
-  ),
-  createChangeRequest: oc.route({
-    method: "POST",
-    path: "/skills/{nodeId}/change-requests",
-    tags: ["Skills", "Change Requests"],
-    summary: "Create Skill change request",
-    successDescription: "Created file-tree change request for a Skill node."
-  }).input(createSkillChangeRequestInputSchema.extend({ nodeId: z.string() })).output(changeRequestSchema)
+    path: "/folders/{nodeId}",
+    tags: ["Folders"],
+    summary: "Get Folder node",
+    successDescription: "Folder node and its direct children."
+  }).input(z.object({ nodeId: z.string() })).output(folderSchema)
+};
+
+// ../../packages/busabase-contract/src/domains/skill/contract.ts
+var skillContract = makeFileTreeContract("skills", "Skills");
+var VaultItemKeySchema = z.string().trim().min(1).max(128).regex(/^[A-Z_][A-Z0-9_]*$/, "Use uppercase letters, numbers, and underscores");
+var VaultItemValueSchema = z.string().max(8192);
+var VaultItemKindSchema = z.enum(["secret", "variable"]);
+var VaultScopeTypeSchema = z.enum([
+  "personal",
+  "workspace",
+  "base",
+  "agent",
+  "tool",
+  "api_key"
+]);
+var VaultEnvironmentSchema = z.enum(["local", "development", "staging", "production"]);
+var VaultAccessPolicySchema = z.object({
+  runtime: z.boolean().default(true),
+  reveal: z.boolean().default(true),
+  edit: z.boolean().default(true),
+  share: z.boolean().default(false)
+});
+var VaultItemInputSchema = z.object({
+  id: z.string().optional(),
+  kind: VaultItemKindSchema,
+  key: VaultItemKeySchema,
+  value: VaultItemValueSchema,
+  scopeType: VaultScopeTypeSchema.default("personal"),
+  scopeId: z.string().trim().nullable().optional(),
+  environment: VaultEnvironmentSchema.default("local"),
+  description: z.string().trim().max(512).default(""),
+  access: VaultAccessPolicySchema.default({
+    runtime: true,
+    reveal: true,
+    edit: true,
+    share: false
+  })
+});
+var UpdateVaultSettingsInputSchema = z.object({
+  items: z.array(VaultItemInputSchema).max(200)
+});
+var VaultItemVOSchema = VaultItemInputSchema.extend({
+  id: z.string(),
+  scopeId: z.string().nullable(),
+  updatedAt: z.string(),
+  createdAt: z.string(),
+  lastUsedAt: z.string().nullable()
+});
+var VaultSettingsVOSchema = z.object({
+  ownerId: z.string().nullable(),
+  items: z.array(VaultItemVOSchema),
+  updatedAt: z.string().nullable()
+});
+z.record(VaultItemKeySchema, VaultItemValueSchema).default({});
+var VaultSuccessSchema = z.object({ success: z.boolean() });
+
+// ../../packages/busabase-contract/src/domains/vault/contract.ts
+var vaultContract = {
+  get: oc.route({
+    method: "GET",
+    path: "/vault",
+    tags: ["Vault"],
+    summary: "Get local Vault settings",
+    successDescription: "Local Vault secrets and variables for this Busabase instance."
+  }).output(VaultSettingsVOSchema),
+  update: oc.route({
+    method: "PUT",
+    path: "/vault",
+    tags: ["Vault"],
+    summary: "Replace local Vault settings",
+    successDescription: "Updated local Vault secrets and variables."
+  }).input(UpdateVaultSettingsInputSchema).output(VaultSettingsVOSchema),
+  clear: oc.route({
+    method: "DELETE",
+    path: "/vault",
+    tags: ["Vault"],
+    summary: "Clear local Vault settings",
+    successDescription: "Removed local Vault secrets and variables."
+  }).output(VaultSuccessSchema)
 };
 
 // ../../packages/busabase-contract/src/contract/busabase.ts
+var changeRequestBatchResultSchema = z.object({
+  results: z.array(
+    z.object({
+      changeRequestId: z.string(),
+      ok: z.boolean(),
+      status: z.string().optional(),
+      error: z.string().optional()
+    })
+  )
+});
 var busabaseContractRoutes = {
   auth: {
     verify: oc.route({
@@ -1337,7 +1657,7 @@ var busabaseContractRoutes = {
     path: "/search",
     tags: ["Search"],
     summary: "Search Busabase",
-    successDescription: "Paginated search results across records, change requests, and Bases."
+    successDescription: "Paginated search results across records, change requests, Bases, File nodes, and Assets."
   }).input(searchInputSchema).output(searchResponseSchema),
   nodes: {
     list: oc.route({
@@ -1410,12 +1730,19 @@ var busabaseContractRoutes = {
       successDescription: "Change requests awaiting an external agent (request-changes or @ai mentions)."
     }).output(z.array(agentTaskSchema))
   },
+  live: {
+    // RPC-only by design: no `.route(...)`, so OpenAPI generation and MCP tool
+    // discovery skip this long-lived Event Iterator while `/api/rpc` stays typed.
+    subscribe: oc.output(eventIterator(liveEventSchema))
+  },
   bases: baseContract,
   skills: skillContract,
+  drives: driveContract,
+  files: fileContract,
   docs: docContract,
   folders: folderContract,
-  attachments: attachmentsContract,
   assets: assetsContract,
+  vault: vaultContract,
   changeRequests: {
     list: oc.route({
       method: "GET",
@@ -1424,6 +1751,20 @@ var busabaseContractRoutes = {
       summary: "List change requests",
       successDescription: "Change requests waiting for review or ready to merge."
     }).input(listInputSchema).output(z.array(changeRequestSchema)),
+    listPaged: oc.route({
+      method: "GET",
+      path: "/change-requests/paged",
+      tags: ["Change Requests"],
+      summary: "List change requests with keyset pagination",
+      successDescription: "A page of change requests plus an opaque nextCursor (null at the end). Filter with `status` and/or `mine`."
+    }).input(listChangeRequestsPagedInputSchema).output(listChangeRequestsResponseSchema),
+    counts: oc.route({
+      method: "GET",
+      path: "/change-requests/counts",
+      tags: ["Change Requests"],
+      summary: "Count change requests by inbox tab",
+      successDescription: "Whole-space change request counts per inbox tab (review / changes / created / approved / merged / rejected)."
+    }).output(changeRequestCountsSchema),
     get: oc.route({
       method: "GET",
       path: "/change-requests/{changeRequestId}",
@@ -1438,6 +1779,17 @@ var busabaseContractRoutes = {
       summary: "Review change request",
       successDescription: "Reviewed change request."
     }).input(reviewChangeRequestInputSchema.extend({ changeRequestId: z.string() })).output(changeRequestSchema),
+    reviewMany: oc.route({
+      method: "POST",
+      path: "/change-requests/reviews",
+      tags: ["Change Requests"],
+      summary: "Review many change requests",
+      successDescription: "Per-change-request review results (failures isolated \u2014 one bad id does not abort the rest)."
+    }).input(
+      reviewChangeRequestInputSchema.extend({
+        changeRequestIds: z.array(z.string()).min(1).max(100)
+      })
+    ).output(changeRequestBatchResultSchema),
     close: oc.route({
       method: "POST",
       path: "/change-requests/{changeRequestId}/close",
@@ -1457,7 +1809,14 @@ var busabaseContractRoutes = {
         record: recordSchema.nullable(),
         view: viewSchema.nullable()
       })
-    )
+    ),
+    mergeMany: oc.route({
+      method: "POST",
+      path: "/change-requests/merge",
+      tags: ["Change Requests"],
+      summary: "Merge many change requests",
+      successDescription: "Per-change-request merge results (each merged in its own transaction; failures isolated)."
+    }).input(z.object({ changeRequestIds: z.array(z.string()).min(1).max(100) })).output(changeRequestBatchResultSchema)
   },
   operations: {
     revise: oc.route({
@@ -1527,6 +1886,7 @@ var notFoundErrors = {
     data: ErrorResponseSchema
   }
 };
+var { vault: _localVault, ...cloudWorkbenchRoutes } = busabaseContractRoutes;
 var cloudExtraRoutes = {
   system: {
     health: oc.route({
@@ -1607,7 +1967,7 @@ var cloudExtraRoutes = {
   }
 };
 var cloudContract = oc.prefix("/api/v1").router({
-  ...busabaseContractRoutes,
+  ...cloudWorkbenchRoutes,
   ...cloudExtraRoutes
 });
 
@@ -1688,12 +2048,18 @@ var Busabase = class {
   get agent() {
     return this.client.agent;
   }
-  get attachments() {
-    return this.client.attachments;
+  get assets() {
+    return this.client.assets;
   }
   get skills() {
     return this.client.skills;
   }
+  get drives() {
+    return this.client.drives;
+  }
+  get files() {
+    return this.client.files;
+  }
   get docs() {
     return this.client.docs;
   }