busabase-sdk 0.10.0 → 0.10.2

package/dist/index.js

@@ -220,6 +220,15 @@ var restoreFieldChangeRequestInputSchema = z.object({
   message: z.string().optional(),
   submittedBy: z.string().optional().default("local-editor")
 });
+var withBaseId = { baseId: z.string().min(1) };
+var fieldChangeRequestInputSchema = z.discriminatedUnion("operation", [
+  createFieldChangeRequestInputSchema.extend({ operation: z.literal("create"), ...withBaseId }),
+  updateFieldChangeRequestInputSchema.extend({ operation: z.literal("update"), ...withBaseId }),
+  deleteFieldChangeRequestInputSchema.extend({ operation: z.literal("delete"), ...withBaseId }),
+  convertFieldChangeRequestInputSchema.extend({ operation: z.literal("convert"), ...withBaseId }),
+  reorderFieldsChangeRequestInputSchema.extend({ operation: z.literal("reorder"), ...withBaseId }),
+  restoreFieldChangeRequestInputSchema.extend({ operation: z.literal("restore"), ...withBaseId })
+]);
 
 // ../../packages/busabase-contract/src/domains/filetree/definition.ts
 var fileTreeOperations = (type) => [
@@ -521,7 +530,13 @@ var listNodesInputSchema = z.object({
   parentId: z.string().nullable().optional().describe("Node to start from. Omit or null to start from the space root."),
   depth: z.coerce.number().int().min(1).max(5).optional().describe(
     "How many levels beneath the start point to eagerly include (default 2 once either field is set). Capped at 5."
-  )
+  ),
+  /**
+   * `active` (default) walks the live tree. `archived` returns the flat set of
+   * soft-archived nodes for the Trash view — no `parentId`/`depth` walk, since
+   * archived nodes are shown as a list, not a tree.
+   */
+  status: z.enum(["active", "archived"]).optional().default("active")
 }).optional();
 var isDescendantInputSchema = z.object({
   nodeId: z.string(),
@@ -850,6 +865,9 @@ 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 listByStatusInputSchema = z.object({
+  status: z.enum(["active", "archived"]).optional().default("active")
+});
 var listChangeRequestsPagedInputSchema = z.object({
   limit: z.coerce.number().int().min(1).max(100).optional().default(50),
   /** Opaque base64 cursor (`createdAt|id`) for keyset pagination. */
@@ -1032,74 +1050,75 @@ var createFileTreeChangeRequestInputSchema = z.object({
   submittedBy: z.string().optional().default("local-producer"),
   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: `Review-first by default: a pending ChangeRequest proposing the ${label} node (\`materialized: false\`). Returns the materialized ${label} node instead (\`materialized: true\`) when \`autoMerge: true\` is passed.`
-    }).input(createFileTreeInputSchema).output(
-      z.union([
-        fileTreeNodeSchema.extend({ materialized: z.literal(true) }),
-        changeRequestSchema.extend({ materialized: z.literal(false) })
-      ])
-    ),
-    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)
-  };
+var FILE_TREE_NODE_TYPES = ["skill", "drive", "airapp"];
+var fileTreeNodeTypeSchema = z.enum(FILE_TREE_NODE_TYPES);
+var fileTreeRefSchema = z.object({
+  nodeId: z.string(),
+  type: fileTreeNodeTypeSchema.optional()
+});
+var fileTreeContract = {
+  list: oc.route({
+    method: "GET",
+    path: "/file-trees",
+    tags: ["File Trees"],
+    summary: "List file-tree nodes",
+    successDescription: "Skill, Drive, and AirApp nodes with their Asset-backed file trees. Pass `type` to narrow to one kind."
+  }).input(z.object({ type: fileTreeNodeTypeSchema.optional() })).output(z.array(fileTreeNodeSchema)),
+  create: oc.route({
+    method: "POST",
+    path: "/file-trees",
+    tags: ["File Trees"],
+    summary: "Create file-tree node",
+    successDescription: "Review-first by default: a pending ChangeRequest proposing the node (`materialized: false`). Returns the materialized node instead (`materialized: true`) when `autoMerge: true` is passed."
+  }).input(createFileTreeInputSchema.extend({ type: fileTreeNodeTypeSchema })).output(
+    z.union([
+      fileTreeNodeSchema.extend({ materialized: z.literal(true) }),
+      changeRequestSchema.extend({ materialized: z.literal(false) })
+    ])
+  ),
+  get: oc.route({
+    method: "GET",
+    path: "/file-trees/{nodeId}",
+    tags: ["File Trees"],
+    summary: "Get file-tree node",
+    successDescription: "File-tree node detail and its file list."
+  }).input(fileTreeRefSchema).output(fileTreeNodeSchema),
+  listFiles: oc.route({
+    method: "GET",
+    path: "/file-trees/{nodeId}/files",
+    tags: ["File Trees"],
+    summary: "List file-tree files",
+    successDescription: "Asset-backed files mounted under the node."
+  }).input(fileTreeRefSchema).output(z.array(fileTreeFileSchema)),
+  readFile: oc.route({
+    method: "GET",
+    path: "/file-trees/{nodeId}/files/{+filePath}",
+    tags: ["File Trees"],
+    summary: "Read file-tree file",
+    successDescription: "File content and content hash."
+  }).input(fileTreeRefSchema.extend({ 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: "/file-trees/{nodeId}/change-requests",
+    tags: ["File Trees", "Change Requests"],
+    summary: "Create file-tree change request",
+    successDescription: "Created file-tree change request for the node."
+  }).input(createFileTreeChangeRequestInputSchema.extend(fileTreeRefSchema.shape)).output(changeRequestSchema)
 };
 
 // ../../packages/busabase-contract/src/domains/airapp/contract.ts
-var airappContract = makeFileTreeContract("airapps", "AirApps");
 var airAppRunLocalNodeInputSchema = z.object({
   nodeId: z.string(),
   /** Text files to mount into the sandbox workdir before installing, keyed by
@@ -1531,6 +1550,24 @@ var restoreViewInputSchema = z.object({
   message: z.string().optional().default("Restore view"),
   submittedBy: z.string().optional().default("local-producer")
 });
+var viewChangeRequestInputSchema = z.discriminatedUnion("operation", [
+  createViewInputSchema.extend({
+    operation: z.literal("create"),
+    baseId: z.string().min(1).describe("Base the new view belongs to.")
+  }),
+  updateViewInputSchema.extend({
+    operation: z.literal("update"),
+    viewId: z.string().min(1)
+  }),
+  deleteViewInputSchema.extend({
+    operation: z.literal("delete"),
+    viewId: z.string().min(1)
+  }),
+  restoreViewInputSchema.extend({
+    operation: z.literal("restore"),
+    viewId: z.string().min(1)
+  })
+]);
 
 // ../../packages/busabase-contract/src/domains/base/contract/record-schemas.ts
 var recordSchema = z.object({
@@ -1564,21 +1601,21 @@ var listRecordsInputSchema = z.object({
   baseId: z.string().optional(),
   /** Opaque base64 cursor for keyset pagination (createdAt-keyed, or sort-keyed when `sort` is set). */
   cursor: z.string().optional(),
+  /**
+   * `active` (default) is the live table; `archived` is the Base's trash — the
+   * same keyset pagination either way, which is why these are one endpoint
+   * rather than a `/records/archived` twin.
+   */
+  status: z.enum(["active", "archived"]).optional().default("active"),
   /** 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 });
+}).optional().default({ limit: 50, status: "active" });
 var listRecordsResponseSchema = z.object({
   records: z.array(recordSchema),
   nextCursor: z.string().nullable()
 });
-var listArchivedRecordsPagedInputSchema = z.object({
-  baseId: z.string(),
-  limit: z.coerce.number().int().min(1).max(100).optional().default(50),
-  /** Opaque base64 cursor (createdAt-keyed) for keyset pagination. */
-  cursor: z.string().optional()
-});
 var countRecordsInputSchema = z.object({
   baseId: z.string().optional()
 }).optional().default({});
@@ -1633,6 +1670,16 @@ var restoreRecordInputSchema = z.object({
   message: z.string().optional(),
   submittedBy: z.string().optional().default("local-editor")
 });
+var withRecordId = { recordId: z.string().min(1) };
+var recordChangeRequestInputSchema = z.discriminatedUnion("operation", [
+  reviseOperationInputSchema.extend({
+    operation: z.literal("update"),
+    autoMerge: z.boolean().optional(),
+    ...withRecordId
+  }),
+  createDeleteChangeRequestInputSchema.extend({ operation: z.literal("delete"), ...withRecordId }),
+  restoreRecordInputSchema.extend({ operation: z.literal("restore"), ...withRecordId })
+]);
 var recordLinkSchema = z.object({
   id: z.string(),
   baseId: z.string(),
@@ -1652,22 +1699,15 @@ var baseContract = {
     path: "/bases",
     tags: ["Bases"],
     summary: "List Bases",
-    successDescription: "Flat list of developer-facing Bases."
-  }).output(z.array(baseSchema)),
-  listArchived: oc.route({
-    method: "GET",
-    path: "/bases/archived",
-    tags: ["Bases"],
-    summary: "List archived bases",
-    successDescription: "Bases that have been archived."
-  }).output(z.array(baseSchema)),
+    successDescription: "Developer-facing Bases. `status=archived` returns the archived ones instead of the active ones."
+  }).input(listByStatusInputSchema).output(z.array(baseSchema)),
   get: oc.route({
     method: "GET",
     path: "/bases/{baseId}",
     tags: ["Bases"],
     summary: "Get Base",
-    successDescription: "Single Base by id or slug."
-  }).input(z.object({ baseId: z.string() })).output(baseSchema.nullable()),
+    successDescription: "Single Base by id or slug, or 404 when it does not exist or is not visible."
+  }).input(z.object({ baseId: z.string() })).output(baseSchema),
   listDeletedFields: oc.route({
     method: "GET",
     path: "/bases/{baseId}/fields/deleted",
@@ -1679,30 +1719,9 @@ var baseContract = {
     method: "GET",
     path: "/bases/{baseId}/views",
     tags: ["Views"],
-    summary: "List active views for a Base",
-    successDescription: "Saved table views for a Base."
-  }).input(z.object({ baseId: z.string() })).output(z.array(viewSchema)),
-  listArchivedViews: oc.route({
-    method: "GET",
-    path: "/bases/{baseId}/views/archived",
-    tags: ["Views"],
-    summary: "List archived views for a Base",
-    successDescription: "Views that have been archived (soft-deleted) from a Base."
-  }).input(z.object({ baseId: z.string() })).output(z.array(viewSchema)),
-  listArchivedRecords: oc.route({
-    method: "GET",
-    path: "/bases/{baseId}/records/archived",
-    tags: ["Records"],
-    summary: "List archived records for a Base",
-    successDescription: "Records that have been archived (soft-deleted) from a Base."
-  }).input(z.object({ baseId: z.string() })).output(z.array(recordSchema)),
-  listArchivedRecordsPaged: oc.route({
-    method: "GET",
-    path: "/bases/{baseId}/records/archived/paged",
-    tags: ["Records"],
-    summary: "List archived records for a Base with keyset pagination",
-    successDescription: "A page of archived (soft-deleted) records plus an opaque nextCursor (null at the end)."
-  }).input(listArchivedRecordsPagedInputSchema).output(listRecordsResponseSchema),
+    summary: "List views for a Base",
+    successDescription: "Saved table views for a Base. `status=archived` returns the soft-deleted ones instead."
+  }).input(listByStatusInputSchema.extend({ baseId: z.string() })).output(z.array(viewSchema)),
   create: oc.route({
     method: "POST",
     path: "/bases",
@@ -1741,34 +1760,13 @@ var baseContract = {
     summary: "Create Base field",
     successDescription: "Created Base field."
   }).input(createBaseFieldInputSchema.extend({ baseId: z.string() })).output(baseSchema),
-  createFieldChangeRequest: oc.route({
+  fieldChangeRequest: oc.route({
     method: "POST",
     path: "/bases/{baseId}/fields/change-requests",
     tags: ["Bases", "Change Requests"],
-    summary: "Create Add Field change request",
-    successDescription: "Created change request that proposes a new field."
-  }).input(createFieldChangeRequestInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema),
-  createViewChangeRequest: oc.route({
-    method: "POST",
-    path: "/bases/{baseId}/views/change-requests",
-    tags: ["Views", "Change Requests"],
-    summary: "Create View change request",
-    successDescription: "Created change request that proposes a new View."
-  }).input(createViewInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema),
-  deleteFieldChangeRequest: oc.route({
-    method: "DELETE",
-    path: "/bases/{baseId}/fields/change-requests",
-    tags: ["Bases", "Change Requests"],
-    summary: "Create Delete Field change request",
-    successDescription: "Created change request that soft-deletes a field."
-  }).input(deleteFieldChangeRequestInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema),
-  updateFieldChangeRequest: oc.route({
-    method: "PATCH",
-    path: "/bases/{baseId}/fields/change-requests",
-    tags: ["Bases", "Change Requests"],
-    summary: "Create Update Field change request",
-    successDescription: "Created change request that updates field metadata (name, required, options)."
-  }).input(updateFieldChangeRequestInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema),
+    summary: "Create field change request",
+    successDescription: "Created change request proposing a field change. `operation` selects what to propose: `create`, `update`, `delete`, `convert` (change type), `reorder`, or `restore` (undo a soft delete)."
+  }).input(fieldChangeRequestInputSchema).output(changeRequestSchema),
   previewFieldConversion: oc.route({
     method: "POST",
     path: "/bases/{baseId}/fields/convert/preview",
@@ -1776,20 +1774,6 @@ var baseContract = {
     summary: "Preview field type conversion",
     successDescription: "Dry-run statistics for converting a field to a different type."
   }).input(previewFieldConversionInputSchema.extend({ baseId: z.string() })).output(previewFieldConversionOutputSchema),
-  convertFieldChangeRequest: oc.route({
-    method: "POST",
-    path: "/bases/{baseId}/fields/convert/change-requests",
-    tags: ["Bases", "Change Requests"],
-    summary: "Create Convert Field change request",
-    successDescription: "Created change request that converts a field to a different type."
-  }).input(convertFieldChangeRequestInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema),
-  reorderFieldsChangeRequest: oc.route({
-    method: "POST",
-    path: "/bases/{baseId}/fields/reorder/change-requests",
-    tags: ["Bases", "Change Requests"],
-    summary: "Reorder fields",
-    successDescription: "Created change request that reorders fields."
-  }).input(reorderFieldsChangeRequestInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema),
   archiveChangeRequest: oc.route({
     method: "POST",
     path: "/bases/{baseId}/archive/change-requests",
@@ -1803,29 +1787,19 @@ var baseContract = {
     tags: ["Bases", "Change Requests"],
     summary: "Restore base",
     successDescription: "Created change request that restores an archived base."
-  }).input(restoreBaseInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema),
-  restoreFieldChangeRequest: oc.route({
-    method: "POST",
-    path: "/bases/{baseId}/fields/restore/change-requests",
-    tags: ["Bases", "Change Requests"],
-    summary: "Restore deleted field",
-    successDescription: "Created change request that restores a soft-deleted field."
-  }).input(restoreFieldChangeRequestInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema)
+  }).input(restoreBaseInputSchema.extend({ baseId: z.string() })).output(changeRequestSchema)
 };
 var recordContract = {
+  // One listing for records: always keyset-paginated, `baseId` always honoured,
+  // `status` picking live rows or the trash. The old unpaginated `/records`
+  // silently dropped `baseId` (its schema had no such field), so a caller
+  // scoping to one Base quietly got the whole space back.
   list: oc.route({
     method: "GET",
     path: "/records",
     tags: ["Records"],
     summary: "List records",
-    successDescription: "Canonical records created from merged change requests."
-  }).input(listInputSchema).output(z.array(recordSchema)),
-  listPaged: oc.route({
-    method: "GET",
-    path: "/records/paged",
-    tags: ["Records"],
-    summary: "List records with keyset pagination",
-    successDescription: "A page of canonical records plus an opaque nextCursor (null at the end)."
+    successDescription: "A page of canonical records plus an opaque nextCursor (null at the end). `status=archived` lists the Base's trash instead of its live rows."
   }).input(listRecordsInputSchema).output(listRecordsResponseSchema),
   count: oc.route({
     method: "GET",
@@ -1855,20 +1829,18 @@ var recordContract = {
     summary: "Get record by field value",
     successDescription: "Single canonical record whose field value exactly matches, or null when none does \u2014 a scoped point lookup (e.g. by a unique slug or path field), not a list."
   }).input(recordFieldGetInputSchema).output(recordSchema.nullable()),
-  updateChangeRequest: oc.route({
-    method: "PUT",
-    path: "/records/{recordId}/change-requests",
-    tags: ["Records", "Change Requests"],
-    summary: "Create record update change request",
-    successDescription: "Created change request that proposes updating a canonical record."
-  }).input(reviseOperationInputSchema.extend({ recordId: z.string() })).output(changeRequestSchema),
-  deleteChangeRequest: oc.route({
-    method: "DELETE",
+  changeRequest: oc.route({
+    method: "POST",
     path: "/records/{recordId}/change-requests",
     tags: ["Records", "Change Requests"],
-    summary: "Create record delete change request",
-    successDescription: "Created change request that proposes archiving or deleting a record."
-  }).input(createDeleteChangeRequestInputSchema.extend({ recordId: z.string() })).output(changeRequestSchema),
+    summary: "Create record change request",
+    successDescription: "Creates a record change request selected by `operation`. Updates auto-merge when the actor has write access unless `autoMerge: false`; delete and restore remain review-first."
+  }).input(recordChangeRequestInputSchema).output(
+    z.union([
+      recordSchema.extend({ materialized: z.literal(true) }),
+      changeRequestSchema.extend({ materialized: z.literal(false) })
+    ])
+  ),
   listChangeRequests: oc.route({
     method: "GET",
     path: "/records/{recordId}/change-requests",
@@ -1876,13 +1848,6 @@ var recordContract = {
     summary: "List record change request history",
     successDescription: "Change requests and operations connected to the canonical record."
   }).input(z.object({ recordId: z.string() })).output(z.array(changeRequestSchema)),
-  restoreChangeRequest: oc.route({
-    method: "POST",
-    path: "/records/{recordId}/restore/change-requests",
-    tags: ["Records", "Change Requests"],
-    summary: "Create record restore change request",
-    successDescription: "Created change request that restores an archived record."
-  }).input(restoreRecordInputSchema.extend({ recordId: z.string() })).output(changeRequestSchema),
   listLinks: oc.route({
     method: "GET",
     path: "/records/{recordId}/links",
@@ -1892,27 +1857,13 @@ var recordContract = {
   }).input(z.object({ recordId: z.string() })).output(z.array(recordLinkSchema))
 };
 var viewContract = {
-  updateChangeRequest: oc.route({
-    method: "PUT",
-    path: "/views/{viewId}/change-requests",
-    tags: ["Views", "Change Requests"],
-    summary: "Create View update change request",
-    successDescription: "Created change request that proposes updating a View."
-  }).input(updateViewInputSchema.extend({ viewId: z.string() })).output(changeRequestSchema),
-  deleteChangeRequest: oc.route({
-    method: "DELETE",
-    path: "/views/{viewId}/change-requests",
-    tags: ["Views", "Change Requests"],
-    summary: "Create View delete change request",
-    successDescription: "Created change request that proposes archiving a View."
-  }).input(deleteViewInputSchema.extend({ viewId: z.string() })).output(changeRequestSchema),
-  restoreChangeRequest: oc.route({
+  changeRequest: oc.route({
     method: "POST",
-    path: "/views/{viewId}/restore/change-requests",
+    path: "/views/change-requests",
     tags: ["Views", "Change Requests"],
-    summary: "Create View restore change request",
-    successDescription: "Created change request that restores an archived View."
-  }).input(restoreViewInputSchema.extend({ viewId: z.string() })).output(changeRequestSchema)
+    summary: "Create view change request",
+    successDescription: "Created change request proposing a view change. `operation` selects what to propose: `create` (addressed by `baseId`), or `update` / `delete` / `restore` (addressed by `viewId`)."
+  }).input(viewChangeRequestInputSchema).output(changeRequestSchema)
 };
 var ReadDocLinesInputSchema = z.object({
   nodeId: z.string(),
@@ -1999,9 +1950,6 @@ var docContract = {
     successDescription: "Created a change request that proposes a new Doc body."
   }).input(createDocChangeRequestInputSchema.extend({ nodeId: z.string() })).output(changeRequestSchema)
 };
-
-// ../../packages/busabase-contract/src/domains/drive/contract.ts
-var driveContract = makeFileTreeContract("drives", "Drives");
 var DumpTableSchema = z.enum([
   "nodes",
   /** Node-level access grants (permissions). Not secret — restore must keep them
@@ -2456,9 +2404,6 @@ var installContract = {
     successDescription: "Created counts plus the number of change requests left for review. Structure (folders, Bases, fields, views) is created immediately \u2014 a pending Base has no id to attach a view or record to; content (records, docs, skills, AirApps) lands as change requests unless `autoMerge` is set."
   }).input(InstallFromGithubDTOSchema).output(InstallResultVOSchema)
 };
-
-// ../../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"]);
@@ -2895,13 +2840,6 @@ var busabaseContractRoutes = {
       summary: "Check whether a node is a descendant of another",
       successDescription: "Server-authoritative parentId-chain walk from nodeId up to potentialAncestorId. Used to gate cross-branch drag-and-drop drops in the sidebar, since the full tree is no longer guaranteed to be loaded client-side (depth-bounded lazy load) \u2014 a purely local walk could wrongly allow dropping a folder into its own unloaded descendant."
     }).input(isDescendantInputSchema).output(isDescendantOutputSchema),
-    listArchived: oc.route({
-      method: "GET",
-      path: "/nodes/archived",
-      tags: ["Nodes"],
-      summary: "List archived nodes",
-      successDescription: "Soft-archived folders, docs, and skills (for the Trash view)."
-    }).output(z.array(nodeSchema)),
     createChangeRequest: oc.route({
       method: "POST",
       path: "/nodes/change-requests",
@@ -3083,9 +3021,10 @@ var busabaseContractRoutes = {
     subscribe: oc.output(eventIterator(liveEventSchema))
   },
   bases: baseContract,
-  skills: skillContract,
-  drives: driveContract,
-  airapps: { ...airappContract, ...airappRuntimeContract },
+  // Skills, Drives, and AirApps share one transport surface — they differ only
+  // in seed files and entry file, which is a server-side config concern.
+  fileTrees: fileTreeContract,
+  airapps: airappRuntimeContract,
   files: fileContract,
   docs: docContract,
   folders: folderContract,
@@ -3096,18 +3035,13 @@ var busabaseContractRoutes = {
   dump: dumpContract,
   install: installContract,
   changeRequests: {
+    // Always keyset-paginated — the unpaginated twin returned a bare array that
+    // silently truncated at `limit` with no way to ask for the next page.
     list: oc.route({
       method: "GET",
       path: "/change-requests",
       tags: ["Change Requests"],
       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({
@@ -3542,11 +3476,9 @@ var Busabase = class {
   get assets() {
     return this.client.assets;
   }
-  get skills() {
-    return this.client.skills;
-  }
-  get drives() {
-    return this.client.drives;
+  /** Skills, Drives, and AirApps — one surface, discriminated by `type`. */
+  get fileTrees() {
+    return this.client.fileTrees;
   }
   get files() {
     return this.client.files;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busabase-sdk",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Typed TypeScript/JavaScript SDK for the Busabase OpenAPI REST API. Talks to a local or remote `busabase server` (or Busabase Cloud).",
   "license": "MIT",
   "homepage": "https://github.com/busabase/busabase/tree/main/apps/busabase-sdk",
@@ -41,9 +41,9 @@
     "tsx": "^4.20.5",
     "typescript": "^5.9.3",
     "vitest": "^2.1.8",
-    "openlib": "0.1.1",
-    "busabase-contract": "0.10.0",
-    "open-domains": "0.0.2"
+    "busabase-contract": "0.10.2",
+    "open-domains": "0.0.2",
+    "openlib": "0.1.1"
   },
   "engines": {
     "node": ">=24.18.0"