busa-sdk 0.95.1 → 0.96.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as AssetTextStatus, $t as NodeType, A as NodeVO, At as GalleryCardSize, B as UpdatePreviewFileCredentialDTO, Bt as ViewSortVO, C as CommentVO, Ct as ListFormsDTO, D as MentionInboxItemVO, Dt as AssetAttachmentRef, E as LookupRollup, Et as UpdateFormDTO, F as SearchResponseVO, Ft as VIEW_FIELD_MAX_WIDTH, G as VaultItemKind, Gt as CloudContract, H as VaultAccessPolicy, Ht as ViewVO, I as SearchResultKind, It as VIEW_FIELD_MIN_WIDTH, J as VaultScopeType, Jt as NodeIconSchema, K as VaultItemVO, Kt as cloudContract, L as SearchResultVO, Lt as ViewConfigVO, M as OperationVO, Mt as GanttScale, N as ReviewVO, Nt as RecordLinkVO, O as MentionInboxPageVO, Ot as BaseFieldVO, P as ReviewVerdict, Pt as RecordVO, Q as AssetDetailVO, Qt as CreatableNodeType, R as SourceAttributionVO, Rt as ViewFilterOperator, S as CommentSubjectType, St as FormVO, T as FieldType, Tt as SubmitFormDTO, U as VaultEnvironment, Ut as AttachmentRef, V as UpdateVaultSettingsDTO, Vt as ViewType, W as VaultItemInput, Wt as PlaybookAttributionVO, X as FileNodeMetadata, Xt as resolveNodeIconSource, Y as VaultSettingsVO, Yt as NodeIconSource, Z as FileNodeVO, Zt as CREATABLE_NODE_TYPES, _ as ChangeRequestVO, _t as FormFieldBindingVO, a as createBusabaseClient, at as FilePreviewConfigurationStatus, b as CommentMentionTargetType, bt as FormSubmitResultVO, c as AuditAction, ct as FilePreviewUnavailableReason, d as ChangeRequestBatchFailureVO, dt as FileTreeNodeVO, en as OperationKind, et as AssetUsageVO, f as ChangeRequestCountsVO, ft as FileTreeReadFileVO, g as ChangeRequestTargetType, gt as FormBoundFieldVO, h as ChangeRequestStatus, ht as CreateFormDTO, i as ResolvedConfig, it as FilePreviewConfigVO, j as OperationStatus, jt as GalleryCoverFit, k as NodeSearchResultVO, kt as BaseVO, l as AuditEventVO, lt as FilePreviewVO, m as ChangeRequestReviewBatchResultVO, mt as ActivityItemVO, n as BusabaseConfig, nt as GrepInputDTO, o as resolveConfig, ot as FilePreviewCredentialSource, p as ChangeRequestMergeBatchResultVO, pt as NodeDetailVO, q as VaultRuntimeEnv, qt as NodeIcon, r as DEFAULT_BASE_URL, rt as GrepResultVO, s as AgentTaskVO, st as FilePreviewProvider, t as BusabaseClient, tt as AssetVO, u as BusabaseSourceChannel, ut as FileTreeFileVO, v as CommentMentionDispatchStatus, vt as FormPageSourceVO, w as CommitVO, wt as ListFormsVO, x as CommentMentionVO, xt as FormThemeVO, y as CommentMentionInputDTO, yt as FormShareVO, z as UserRefVO, zt as ViewFilterVO } from "./client-BlHnsVv8.js";
+import { $ as AssetDetailVO, $t as CreatableNodeType, A as NodeVO, At as BaseVO, B as UserRefVO, Bt as ViewFilterVO, C as CommentVO, Ct as FormVO, D as MentionInboxItemVO, Dt as UpdateFormDTO, E as LookupRollup, Et as SubmitFormDTO, F as ReviewVerdict, Ft as RecordVO, G as VaultItemInput, Gt as PlaybookAttributionVO, H as UpdateVaultSettingsDTO, Ht as ViewType, I as SearchResponseVO, It as VIEW_FIELD_MAX_WIDTH, J as VaultRuntimeEnv, Jt as NodeIcon, K as VaultItemKind, Kt as CloudContract, L as SearchResultKind, Lt as VIEW_FIELD_MIN_WIDTH, M as OperationVO, Mt as GalleryCoverFit, N as RestoredSlugChangeVO, Nt as GanttScale, O as MentionInboxPageVO, Ot as AssetAttachmentRef, P as ReviewVO, Pt as RecordLinkVO, Q as FileNodeVO, Qt as CREATABLE_NODE_TYPES, R as SearchResultVO, Rt as ViewConfigVO, S as CommentSubjectType, St as FormThemeVO, T as FieldType, Tt as ListFormsVO, U as VaultAccessPolicy, Ut as ViewVO, V as UpdatePreviewFileCredentialDTO, Vt as ViewSortVO, W as VaultEnvironment, Wt as AttachmentRef, X as VaultSettingsVO, Xt as NodeIconSource, Y as VaultScopeType, Yt as NodeIconSchema, Z as FileNodeMetadata, Zt as resolveNodeIconSource, _ as ChangeRequestVO, _t as FormBoundFieldVO, a as createBusabaseClient, at as FilePreviewConfigVO, b as CommentMentionTargetType, bt as FormShareVO, c as AuditAction, ct as FilePreviewProvider, d as ChangeRequestBatchFailureVO, dt as FileTreeFileVO, en as NodeType, et as AssetTextStatus, f as ChangeRequestCountsVO, ft as FileTreeNodeVO, g as ChangeRequestTargetType, gt as CreateFormDTO, h as ChangeRequestStatus, ht as ActivityItemVO, i as ResolvedConfig, it as GrepResultVO, j as OperationStatus, jt as GalleryCardSize, k as NodeSearchResultVO, kt as BaseFieldVO, l as AuditEventVO, lt as FilePreviewUnavailableReason, m as ChangeRequestReviewBatchResultVO, mt as NodeDetailVO, n as BusabaseConfig, nt as AssetVO, o as resolveConfig, ot as FilePreviewConfigurationStatus, p as ChangeRequestMergeBatchResultVO, pt as FileTreeReadFileVO, q as VaultItemVO, qt as cloudContract, r as DEFAULT_BASE_URL, rt as GrepInputDTO, s as AgentTaskVO, st as FilePreviewCredentialSource, t as BusabaseClient, tn as OperationKind, tt as AssetUsageVO, u as BusabaseSourceChannel, ut as FilePreviewVO, v as CommentMentionDispatchStatus, vt as FormFieldBindingVO, w as CommitVO, wt as ListFormsDTO, x as CommentMentionVO, xt as FormSubmitResultVO, y as CommentMentionInputDTO, yt as FormPageSourceVO, z as SourceAttributionVO, zt as ViewFilterOperator } from "./client-CfuVCvxi.js";
 import { z } from "zod";
 //#region src/url.d.ts
 /**
@@ -567,4 +567,4 @@ declare class Busabase {
   }>>>>;
 }
 //#endregion
-export { type ActivityItemVO, type AgentTaskVO, type FileTreeFileVO as AirAppFileVO, type FileTreeFileVO as DriveFileVO, type FileTreeFileVO, type FileTreeFileVO as SkillFileVO, type FileTreeReadFileVO as AirAppReadFileVO, type FileTreeReadFileVO as DriveReadFileVO, type FileTreeReadFileVO, type FileTreeReadFileVO as SkillReadFileVO, type FileTreeNodeVO as AirAppVO, type FileTreeNodeVO as DriveVO, type FileTreeNodeVO, type FileTreeNodeVO as SkillVO, type AssetAttachmentRef, type AssetDetailVO, type AssetTextStatus, type AssetUsageVO, type AssetVO, type AttachmentRef, type AuditAction, type AuditEventVO, type BaseFieldVO, type BaseVO, Busabase, type BusabaseAssetsClient, BusabaseChangeRequestsClient, type BusabaseClient, type BusabaseConfig, type BusabaseRecordsClient, type BusabaseSourceChannel, type BusabaseUploadedAsset, CREATABLE_NODE_TYPES, type ChangeRequestBatchFailureVO, type ChangeRequestCountsVO, type ChangeRequestMergeBatchResultVO, type ChangeRequestReviewBatchResultVO, type ChangeRequestStatus, type ChangeRequestTargetType, type ChangeRequestVO, type CloudContract, type CommentMentionDispatchStatus, type CommentMentionInputDTO, type CommentMentionTargetType, type CommentMentionVO, type CommentSubjectType, type CommentVO, type CommitVO, type CreatableNodeType, type CreateFormDTO, DEFAULT_BASE_URL, type FieldType, type FileNodeMetadata, type FileNodeVO, type FilePreviewConfigVO, type FilePreviewConfigurationStatus, type FilePreviewCredentialSource, type FilePreviewProvider, type FilePreviewUnavailableReason, type FilePreviewVO, type FormBoundFieldVO, type FormFieldBindingVO, type FormPageSourceVO, type FormShareVO, type FormSubmitResultVO, type FormThemeVO, type FormVO, type GalleryCardSize, type GalleryCoverFit, type GanttScale, type ListFormsDTO, type ListFormsVO, type LookupRollup, type MentionInboxItemVO, type MentionInboxPageVO, type NodeDetailVO, type NodeIcon, type NodeIconSchema, type NodeIconSource, type NodeSearchResultVO, type NodeType, type NodeVO, type NodeWebUrlInput, type OperationKind, type OperationStatus, type OperationVO, type PlaybookAttributionVO, type RecordByFieldInput, type RecordLinkVO, type RecordVO, type ResolvedConfig, type ReviewVO, type ReviewVerdict, type SearchResponseVO, type SearchResultKind, type SearchResultVO, type SourceAttributionVO, type SubmitFormDTO, type UpdateFormDTO, type UpdatePreviewFileCredentialDTO, type UpdateVaultSettingsDTO, type UploadAssetOptions, type UserRefVO, type VIEW_FIELD_MAX_WIDTH, type VIEW_FIELD_MIN_WIDTH, type VaultAccessPolicy, type VaultEnvironment, type VaultItemInput, type VaultItemKind, type VaultItemVO, type VaultRuntimeEnv, type VaultScopeType, type VaultSettingsVO, type ViewConfigVO, type ViewFilterOperator, type ViewFilterVO, type ViewSortVO, type ViewType, type ViewVO, cloudContract, createBusabaseClient, getRecordByField, grepAssets, hashBytes, nodeWebUrl, normalizeBaseUrl, resolveConfig, type resolveNodeIconSource, toFilesOnlyGrepResult, toUnifiedFilesGrepInput, uploadAsset };
+export { type ActivityItemVO, type AgentTaskVO, type FileTreeFileVO as AirAppFileVO, type FileTreeFileVO as DriveFileVO, type FileTreeFileVO, type FileTreeFileVO as SkillFileVO, type FileTreeReadFileVO as AirAppReadFileVO, type FileTreeReadFileVO as DriveReadFileVO, type FileTreeReadFileVO, type FileTreeReadFileVO as SkillReadFileVO, type FileTreeNodeVO as AirAppVO, type FileTreeNodeVO as DriveVO, type FileTreeNodeVO, type FileTreeNodeVO as SkillVO, type AssetAttachmentRef, type AssetDetailVO, type AssetTextStatus, type AssetUsageVO, type AssetVO, type AttachmentRef, type AuditAction, type AuditEventVO, type BaseFieldVO, type BaseVO, Busabase, type BusabaseAssetsClient, BusabaseChangeRequestsClient, type BusabaseClient, type BusabaseConfig, type BusabaseRecordsClient, type BusabaseSourceChannel, type BusabaseUploadedAsset, CREATABLE_NODE_TYPES, type ChangeRequestBatchFailureVO, type ChangeRequestCountsVO, type ChangeRequestMergeBatchResultVO, type ChangeRequestReviewBatchResultVO, type ChangeRequestStatus, type ChangeRequestTargetType, type ChangeRequestVO, type CloudContract, type CommentMentionDispatchStatus, type CommentMentionInputDTO, type CommentMentionTargetType, type CommentMentionVO, type CommentSubjectType, type CommentVO, type CommitVO, type CreatableNodeType, type CreateFormDTO, DEFAULT_BASE_URL, type FieldType, type FileNodeMetadata, type FileNodeVO, type FilePreviewConfigVO, type FilePreviewConfigurationStatus, type FilePreviewCredentialSource, type FilePreviewProvider, type FilePreviewUnavailableReason, type FilePreviewVO, type FormBoundFieldVO, type FormFieldBindingVO, type FormPageSourceVO, type FormShareVO, type FormSubmitResultVO, type FormThemeVO, type FormVO, type GalleryCardSize, type GalleryCoverFit, type GanttScale, type ListFormsDTO, type ListFormsVO, type LookupRollup, type MentionInboxItemVO, type MentionInboxPageVO, type NodeDetailVO, type NodeIcon, type NodeIconSchema, type NodeIconSource, type NodeSearchResultVO, type NodeType, type NodeVO, type NodeWebUrlInput, type OperationKind, type OperationStatus, type OperationVO, type PlaybookAttributionVO, type RecordByFieldInput, type RecordLinkVO, type RecordVO, type ResolvedConfig, type RestoredSlugChangeVO, type ReviewVO, type ReviewVerdict, type SearchResponseVO, type SearchResultKind, type SearchResultVO, type SourceAttributionVO, type SubmitFormDTO, type UpdateFormDTO, type UpdatePreviewFileCredentialDTO, type UpdateVaultSettingsDTO, type UploadAssetOptions, type UserRefVO, type VIEW_FIELD_MAX_WIDTH, type VIEW_FIELD_MIN_WIDTH, type VaultAccessPolicy, type VaultEnvironment, type VaultItemInput, type VaultItemKind, type VaultItemVO, type VaultRuntimeEnv, type VaultScopeType, type VaultSettingsVO, type ViewConfigVO, type ViewFilterOperator, type ViewFilterVO, type ViewSortVO, type ViewType, type ViewVO, cloudContract, createBusabaseClient, getRecordByField, grepAssets, hashBytes, nodeWebUrl, normalizeBaseUrl, resolveConfig, type resolveNodeIconSource, toFilesOnlyGrepResult, toUnifiedFilesGrepInput, uploadAsset };

package/dist/index.js

@@ -58,17 +58,42 @@ const toFilesOnlyGrepResult = (result) => ({
 });
 /** Call unified grep as files-only while preserving the former asset helper result shape. */
 const grepAssets = async (client, input) => toFilesOnlyGrepResult(await client.grep(toUnifiedFilesGrepInput(input)));
-//#endregion
-//#region ../../packages/busabase-contract/src/domains/agents/types.ts
-/**
-* Agents domain — DTO (inputs) and VO (outputs) for driving EXTERNAL ACP agents.
-*
-* Standalone zod only: no drizzle, no `~/db`, no server imports. These types are
-* pulled into the browser bundle and the mobile client is generated from them.
-*
-* Vocabulary note: an "agent" here is a *backend we connect out to* (Claude Code,
-* Codex, a remote Buda agent), NOT one of Busabase's own nodes.
-*/
+z.object({ redirectUrl: z.string() });
+z.object({
+	grantId: z.string(),
+	acprouterSpaceName: z.string()
+});
+const RouterGrantVOSchema = z.object({
+	grantId: z.string(),
+	spaceName: z.string()
+});
+const RouterEnrollmentInputSchema = z.object({
+	grantId: z.string().min(1),
+	enrollmentId: z.string().min(1)
+});
+const RouterEnrollmentMintInputSchema = z.object({
+	grantId: z.string().min(1),
+	agentSlug: z.enum(["claude-acp", "codex-acp"])
+});
+const RouterEnrollmentMintVOSchema = z.object({
+	enrollmentId: z.string(),
+	command: z.string(),
+	expiresAt: z.string()
+});
+const RouterEnrollmentStatusVOSchema = z.object({
+	state: z.enum([
+		"not_redeemed",
+		"redeemed_offline",
+		"online",
+		"failed"
+	]),
+	machineId: z.string().optional()
+});
+const RouterEnrollmentCompleteInputSchema = RouterEnrollmentInputSchema.extend({ agentSlug: z.enum(["claude-acp", "codex-acp"]) });
+const RouterEnrollmentConnectionVOSchema = z.object({
+	connectionSlug: z.string(),
+	agentSlug: z.string()
+});
 /**
 * How a backend is reached. This is the axis that decides everything else:
 * `local-subprocess` runs on whichever machine serves the request (the user's
@@ -182,6 +207,11 @@ const AgentConnectionVOSchema = z.object({
 	latest: AgentSessionVOSchema.nullable(),
 	/** Whether Busabase can start another conversation with this agent right now. */
 	connected: z.boolean(),
+	connectionState: z.enum([
+		"ready",
+		"activating",
+		"disconnecting"
+	]).optional(),
 	/** Controls owner-only actions such as deleting the saved OAuth grant. */
 	ownedByCurrentUser: z.boolean()
 });
@@ -279,6 +309,13 @@ const SetAgentSessionConfigOptionInputSchema = z.object({
 * matching how `live.subscribe` is declared.
 */
 const agentsContract = {
+	routerEnrollment: {
+		grants: oc.output(RouterGrantVOSchema.array()),
+		mint: oc.input(RouterEnrollmentMintInputSchema).output(RouterEnrollmentMintVOSchema),
+		status: oc.input(RouterEnrollmentInputSchema).output(RouterEnrollmentStatusVOSchema),
+		complete: oc.input(RouterEnrollmentCompleteInputSchema).output(RouterEnrollmentConnectionVOSchema),
+		cancel: oc.input(RouterEnrollmentInputSchema).output(z.object({ ok: z.boolean() }))
+	},
 	/** Connectable backends. Availability is resolved per request, not cached in the client. */
 	catalog: oc.output(AgentCatalogEntryVOSchema.array()),
 	disconnect: oc.input(DisconnectAgentInputSchema).output(z.object({
@@ -512,7 +549,13 @@ const lookupRollupSchema = z.enum([
 	"max",
 	"concatenate"
 ]).default("values");
+/** Public, plain-text guidance. Examples are hints, never default record values. */
+const fieldHelpSchema = z.object({
+	description: z.string().max(1e3).optional(),
+	example: z.string().max(200).optional()
+});
 const fieldOptionsSchema = z.object({
+	help: fieldHelpSchema.optional(),
 	ai: z.object({
 		model: z.string().optional(),
 		prompt: z.string().optional(),
@@ -543,7 +586,18 @@ const fieldOptionsSchema = z.object({
 		height: z.number().int().positive().max(1200).optional(),
 		providers: z.array(z.string()).optional()
 	}).optional(),
-	formula: z.object({ expression: z.string().min(1) }).optional(),
+	formula: z.object({
+		expression: z.string().min(1),
+		format: z.enum([
+			"auto",
+			"number",
+			"currency",
+			"percent",
+			"date"
+		]).optional(),
+		precision: z.number().int().min(0).max(10).optional(),
+		currency: z.string().regex(/^[A-Z]{3}$/).optional()
+	}).optional(),
 	inverseFieldId: z.string().optional(),
 	lookup: z.object({
 		relationFieldSlug: z.string().min(1).describe("Slug of a `relation` field on THIS Base — the hop to follow."),
@@ -633,7 +687,9 @@ const updateFieldChangeRequestInputSchema = z.object({
 	patch: z.object({
 		name: fieldNameSchema.optional(),
 		required: z.boolean().optional(),
-		options: fieldOptionsSchema.optional(),
+		options: fieldOptionsSchema.removeDefault().optional(),
+		/** Applied against current options at merge time; null removes all guidance. */
+		help: fieldHelpSchema.nullable().optional(),
 		/**
 		* Not a patch key — rejected on purpose, and the only key here that is.
 		*
@@ -1900,7 +1956,7 @@ const changeRequestSchema = z.object({
 	sourceAttribution: sourceAttributionSchema.nullable().optional(),
 	sourceMeta: z.record(z.string(), z.unknown()),
 	reviewPolicySnapshot: z.record(z.string(), z.unknown()),
-	mergeSummary: z.record(z.string(), z.unknown()),
+	mergeSummary: z.record(z.string(), z.unknown()).describe("Filled in when the change request merges. `slugChanges` (present only when non-empty) lists items a restore brought back under a new slug because another item took the old one while they were in the Trash: `{ nodeId, nodeType, name, fromSlug, toSlug }`. Read the new slug from here instead of assuming the old one."),
 	rejectedReason: z.string().nullable(),
 	reviewedAt: z.string().nullable(),
 	mergedAt: z.string().nullable(),
@@ -2413,7 +2469,7 @@ const createFileTreeInputSchema = z.object({
 		"private",
 		"workspace",
 		"public"
-	]).optional().default("private"),
+	]).optional(),
 	version: z.string().optional().default("0.1.0"),
 	/**
 	* Extra node metadata, stored alongside the server-owned keys.
@@ -3246,6 +3302,11 @@ const listRecordsInputSchema = z.object({
 	baseId: z.string().optional().describe("Restrict to one Base. OMITTING it lists records across the WHOLE SPACE, which is rarely what a caller means and is easy to miss — every other parameter still applies, so an unscoped query looks like it worked."),
 	cursor: z.string().optional().describe("Opaque page cursor: pass back the `nextCursor` from the previous response. Do not construct or parse it — it is keyed on `createdAt`, or on the sort field when `sort` is given, and that is an implementation detail."),
 	status: z.enum(["active", "archived"]).optional().default("active").describe("`active` is the live table; `archived` is the Base's trash."),
+	summary: z.union([
+		z.boolean(),
+		z.literal("true"),
+		z.literal("false")
+	]).transform((value) => value === true || value === "true").optional().describe("Return compact list previews: field values larger than 4 KB are replaced with omission markers, and Base field definitions and computed lookup values are omitted. Omit for full records; use records.get to read the complete content of a selected row."),
 	filters: z.array(listRecordsFilterSchema).optional().describe("View filters — a best-effort SUPERSET, not an exact answer. They mean what the grid means (a currency number reads as \"$1,234.00\", a select as its choice label), and the server may return records that do not match, so the caller must narrow them again and must NOT trust `limit` alongside them. Use `valueFilters` when you need an exact row set."),
 	/**
 	* Exact value comparisons. Unlike `filters` these are authoritative — the
@@ -3299,6 +3360,16 @@ const listRecordsPageInputSchema = z.object({
 		gte: z.string().describe("Inclusive lower bound, ISO 8601 UTC instant."),
 		lt: z.string().describe("EXCLUSIVE upper bound, ISO 8601 UTC instant.")
 	}).optional().describe("Scope the page to a `date`/`created_time`/`updated_time` field falling in `[gte, lt)` — a half-open range of absolute UTC instants, not a `filters` condition. Resolve the bounds yourself: a day or a month only means something in a timezone, and the server does not know the viewer's."),
+	/**
+	* The same one-field sort `records.list` takes, with the same semantics —
+	* so an app can jump straight to page N of "newest follow-up first" without
+	* creating a View in the user's Base or walking a cursor through every page.
+	*
+	* It REPLACES the View's saved sort when both are given (the View's filters
+	* still apply). Ties on the value are broken by record id, so consecutive
+	* pages never overlap or skip a record.
+	*/
+	sort: listRecordsSortSchema.optional().describe("Sort by one field. Only number and date fields sort authoritatively (their typed value column matches a client's own ordering); any other field type is returned in the default order and left for the caller to sort. Replaces the saved View's sort when `viewId` is also given (the View's filters still apply). Empty values sort last; ties are broken by record id, so pages never overlap."),
 	page: z.coerce.number().int().min(1).optional().default(1).describe("1-indexed, not 0-indexed."),
 	pageSize: z.coerce.number().int().min(1).max(100).optional().default(50).describe("Records per page. Capped at 100.")
 });
@@ -3562,8 +3633,8 @@ const baseContract = {
 		path: "/bases",
 		tags: ["Bases"],
 		summary: "List Bases",
-		successDescription: "Developer-facing Bases. `status=archived` returns the archived ones instead of the active ones."
-	}).input(listByStatusInputSchema).output(z.array(baseSchema)),
+		successDescription: "Developer-facing Bases. `status=archived` returns the archived ones instead of the active ones. `fields=links` trims each Base to its relation and lookup fields."
+	}).input(listByStatusInputSchema.extend({ fields: z.enum(["all", "links"]).optional().default("all").describe("`all` (default): every live field. `links`: only relation and lookup fields — enough to see how Bases connect (relation targets, lookups, inverse relations) across a large space, not to read or edit records. Fetch one Base with `bases.get` for its full schema.") })).output(z.array(baseSchema)),
 	get: oc.route({
 		method: "GET",
 		path: "/bases/{baseId}",
@@ -3639,7 +3710,7 @@ const baseContract = {
 		path: "/bases/{baseId}/lifecycle/change-requests",
 		tags: ["Bases", "Change Requests"],
 		summary: "Create Base lifecycle change request",
-		successDescription: "Created change request that moves a Base between its lifecycle states. `operation` selects the direction: `archive` (soft-delete a live Base) or `restore` (bring an archived Base back)."
+		successDescription: "Created change request that moves a Base between its lifecycle states. `operation` selects the direction: `archive` (soft-delete a live Base) or `restore` (bring an archived Base back). If another Base took the slug while this one was archived, the restore brings it back under the next free slug (`tasks-2`) and lists the change in `mergeSummary.slugChanges`."
 	}).input(baseLifecycleChangeRequestInputSchema).output(changeRequestSchema)
 };
 const recordContract = {
@@ -3655,7 +3726,7 @@ const recordContract = {
 		path: "/records/page",
 		tags: ["Records"],
 		summary: "List a numbered record page",
-		successDescription: "A random-access page of active records. When viewId is supplied, the saved view is authoritatively filtered and sorted before total and page slicing are calculated. `dateRange` additionally scopes to a `[gte, lt)` UTC instant window on a date/created_time/updated_time field."
+		successDescription: "A random-access page of active records. When viewId is supplied, the saved view is authoritatively filtered and sorted before total and page slicing are calculated. An explicit `sort` (same shape as `records.list`'s) replaces the View's sort, so page N of a number- or date-sorted list is one request. `dateRange` additionally scopes to a `[gte, lt)` UTC instant window on a date/created_time/updated_time field."
 	}).input(listRecordsPageInputSchema).output(listRecordsPageResponseSchema),
 	count: oc.route({
 		method: "GET",
@@ -4045,6 +4116,7 @@ const FormBoundFieldSchema = z.object({
 	slug: z.string(),
 	name: fieldNameSchema,
 	type: fieldTypeSchema,
+	help: fieldHelpSchema.optional(),
 	choices: z.array(z.object({
 		id: z.string(),
 		name: z.string()
@@ -5691,6 +5763,7 @@ const busabaseContractRoutes = {
 			path: "/embed-links",
 			tags: ["Embed Links"],
 			summary: "Create a polymorphic read-only embed link",
+			description: "Record detail requires write on the owning Base node; change requests require changeRequest on every affected node; whole-node links require manage. Listing and revoking links require manage.",
 			successDescription: "The capability URL is returned once; only its secret hash is stored."
 		}).errors(embedLinkErrors).input(CreateEmbedLinkInputSchema).output(CreatedEmbedLinkVOSchema),
 		list: oc.route({
@@ -6090,6 +6163,7 @@ members: oc.output(z.array(userRefSchema)) },
 			successDescription: "A random-access page of change requests plus the total across the whole filter. Same `status`, `mine`, and `affectsNodeId` filters as the cursor listing."
 		}).input(listChangeRequestsPageInputSchema).output(listChangeRequestsPageResponseSchema),
 		inboxSnapshot: oc.input(inboxSnapshotInputSchema).output(inboxSnapshotResponseSchema),
+		reviewCount: oc.output(z.object({ review: z.number().int().min(0) })),
 		counts: oc.route({
 			method: "GET",
 			path: "/change-requests/counts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-sdk",
-  "version": "0.95.1",
+  "version": "0.96.0",
   "description": "Typed TypeScript/JavaScript SDK for the Busabase OpenAPI REST API. Talks to a local or remote `busabase server` (or Busabase Cloud). Short-name alias for busabase-sdk.",
   "license": "MIT",
   "homepage": "https://github.com/busabase/busabase/tree/main/apps/busabase-sdk",