busabase-sdk 0.1.0 → 0.9.2

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}",
@@ -160,7 +179,9 @@ var fieldTypeSchema = z.enum([
   "auto_number",
   "ai_summary",
   "ai_tags",
-  "code"
+  "code",
+  "json",
+  "yaml"
 ]);
 var fieldOptionsSchema = z.object({
   ai: z.object({
@@ -195,7 +216,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 +418,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 +474,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 +503,8 @@ var BUILTIN_NODE_TYPES = [
   folderNodeType,
   baseNodeType,
   skillNodeType,
+  driveNodeType,
+  fileNodeType,
   docNodeType
 ];
 for (const definition of BUILTIN_NODE_TYPES) {
@@ -493,10 +541,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 +553,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 +571,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 +607,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,6 +623,7 @@ 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(),
@@ -586,6 +644,7 @@ var changeRequestSchema = z.object({
     "conflict"
   ]),
   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 +668,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 +682,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 +713,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 +746,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 +787,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 +798,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({
@@ -791,6 +882,7 @@ var recordSchema = z.object({
   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(),
@@ -816,6 +908,15 @@ var createChangeRequestInputSchema = z.object({
   ),
   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),
@@ -874,6 +975,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()
@@ -967,6 +1069,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",
@@ -1192,67 +1301,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 +1367,152 @@ 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");
+
 // ../../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 +1528,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,11 +1601,17 @@ 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,
   changeRequests: {
     list: oc.route({
@@ -1438,6 +1635,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 +1665,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({
@@ -1688,12 +1903,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;
   }