busa-sdk 0.97.0 → 0.99.0

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,4 +1,4 @@
-import { i as uploadAsset, n as TemplateRiskLevelSchema, r as hashBytes } from "./template-DRMp6tKv.js";
+import { a as hashBytes, i as TemplateVideoSchema, n as TemplateLocalesSchema, o as uploadAsset, r as TemplateRiskLevelSchema } from "./template-Bnkq4diD.js";
 import { t as normalizeBaseUrl } from "./url-B8GMXalA.js";
 import { ORPCError, createORPCClient } from "@orpc/client";
 import { OpenAPILink } from "@orpc/openapi-client/fetch";
@@ -599,6 +599,7 @@ const fieldOptionsSchema = z.object({
 		currency: z.string().regex(/^[A-Z]{3}$/).optional()
 	}).optional(),
 	inverseFieldId: z.string().optional(),
+	reverseOfFieldId: z.string().optional().describe("Relation fields only. Makes this a read-only reverse column of the relation field with this id on the target Base, which must point back at this Base. Its value is computed from that field's links; edit the forward field instead."),
 	lookup: z.object({
 		relationFieldSlug: z.string().min(1).describe("Slug of a `relation` field on THIS Base — the hop to follow."),
 		targetFieldSlug: z.string().min(1).describe("Slug of the field on the related Base whose values are pulled over."),
@@ -1000,7 +1001,7 @@ const driveNodeType = makeFileTreeNodeType({
 	routeBase: "drives",
 	tag: "Drives",
 	entryFile: "README.md",
-	publicAccess: "no"
+	publicAccess: "detail"
 });
 //#endregion
 //#region ../../packages/busabase-contract/src/domains/file-node/definition.ts
@@ -1099,7 +1100,7 @@ const htmlNodeType = {
 	capabilities: {
 		hasDetail: true,
 		creatable: true,
-		publicAccess: "no"
+		publicAccess: "detail"
 	},
 	operations: [{
 		kind: "html_document_update",
@@ -1117,7 +1118,7 @@ const skillNodeType = makeFileTreeNodeType({
 	routeBase: "skills",
 	tag: "Skills",
 	entryFile: "SKILL.md",
-	publicAccess: "no"
+	publicAccess: "detail"
 });
 //#endregion
 //#region ../../packages/busabase-contract/src/domains/whiteboard/definition.ts
@@ -1273,6 +1274,14 @@ const NodeIconSchema = z.discriminatedUnion("type", [z.object({
 	}).optional()
 })]);
 //#endregion
+//#region ../../packages/busabase-contract/src/contract/agent-client.ts
+const AgentClientVOSchema = z.object({
+	/** Normalized, lowercase `[a-z0-9-]`, at most 40 characters (e.g. `codex`). */
+	id: z.string(),
+	/** Display name: a known agent's product name, otherwise derived from the id. */
+	name: z.string()
+});
+//#endregion
 //#region ../../packages/busabase-contract/src/contract/node-agent-prompt-schemas.ts
 /**
 * Per-node custom scenario prompts (`node.agentPrompts`) — the single
@@ -1775,7 +1784,12 @@ const sourceAttributionSchema = z.object({
 	ownerName: z.string().nullable(),
 	channel: sourceChannelSchema.nullable(),
 	/** Present only when the write declared a playbook the server could validate. */
-	playbook: PlaybookAttributionVOSchema.nullable().optional()
+	playbook: PlaybookAttributionVOSchema.nullable().optional(),
+	/**
+	* Present only when the write named its agent client (`x-busabase-agent`;
+	* busabase-cli sends it automatically). Self-reported — a label, not identity.
+	*/
+	agent: AgentClientVOSchema.nullable().optional()
 });
 const commitSchema = z.object({
 	id: z.string(),
@@ -2087,6 +2101,7 @@ const liveEventSchema = z.object({
 		"node.metadata_updated",
 		"node.settings_updated"
 	]),
+	reason: z.literal("acl").optional(),
 	spaceId: z.string(),
 	actorId: z.string(),
 	changeRequestId: z.string().nullable(),
@@ -3126,6 +3141,23 @@ const viewFilterSchema = z.object({
 	operator: viewFilterOperatorSchema,
 	value: z.unknown().optional()
 });
+const viewFilterConjunctionSchema = z.enum(["and", "or"]);
+const deepestViewFilterGroupSchema = z.object({
+	conjunction: viewFilterConjunctionSchema,
+	conditions: z.array(viewFilterSchema).min(1).max(100)
+});
+const viewFilterGroupSchema = z.object({
+	conjunction: viewFilterConjunctionSchema,
+	conditions: z.array(z.union([viewFilterSchema, deepestViewFilterGroupSchema])).min(1).max(100)
+});
+const viewFilterConditionSchema = z.union([viewFilterSchema, viewFilterGroupSchema]);
+const viewFiltersSchema = z.array(viewFilterConditionSchema).max(100).superRefine((conditions, ctx) => {
+	const count = (items) => items.reduce((total, item) => total + ("conditions" in item ? count(item.conditions) : 1), 0);
+	if (count(conditions) > 100) ctx.addIssue({
+		code: "custom",
+		message: "A view supports at most 100 filter conditions."
+	});
+});
 const viewSortSchema = z.object({
 	direction: z.enum(["asc", "desc"]),
 	fieldSlug: z.string(),
@@ -3146,7 +3178,8 @@ const galleryCardSizeSchema = z.enum([
 	"large"
 ]);
 const viewConfigSchema = z.object({
-	filters: z.array(viewFilterSchema).default([]),
+	filters: viewFiltersSchema.default([]),
+	filterConjunction: viewFilterConjunctionSchema.optional(),
 	sorts: z.array(viewSortSchema).default([]),
 	visibleFieldSlugs: z.array(z.string()).nullable().optional(),
 	fieldWidths: z.record(z.string().min(1), z.number().int().min(92).max(640)).optional(),
@@ -3194,7 +3227,7 @@ const viewConfigPatchSchema = viewConfigSchema.omit({
 	filters: true,
 	sorts: true
 }).extend({
-	filters: z.array(viewFilterSchema).optional(),
+	filters: viewFiltersSchema.optional(),
 	sorts: z.array(viewSortSchema).optional()
 });
 const updateViewInputSchema = z.object({
@@ -3243,6 +3276,38 @@ const viewChangeRequestInputSchema = z.discriminatedUnion("operation", [
 ]);
 //#endregion
 //#region ../../packages/busabase-contract/src/domains/base/contract/record-schemas.ts
+const lookupComputedSchema = z.object({
+	status: z.enum([
+		"ready",
+		"unlinked",
+		"empty",
+		"invalid",
+		"inaccessible"
+	]),
+	reason: z.enum([
+		"missing_configuration",
+		"missing_relation",
+		"missing_source_configuration",
+		"missing_target_field",
+		"unsupported_source",
+		"unsupported_rollup",
+		"source_base_mismatch",
+		"source_record_archived"
+	]).optional(),
+	value: z.unknown(),
+	targetField: baseFieldSchema.optional(),
+	sourceBaseId: z.string().optional(),
+	sourceBaseSlug: z.string().optional(),
+	sources: z.array(z.object({
+		recordId: z.string(),
+		title: z.string(),
+		value: z.unknown(),
+		headCommitId: z.string()
+	})).max(25).default([]),
+	sourcesTruncated: z.boolean().optional(),
+	dependencyVersion: z.string(),
+	dependencyReadAt: z.number().finite().nonnegative().optional()
+});
 const recordSchema = z.object({
 	id: z.string(),
 	baseId: z.string(),
@@ -3253,6 +3318,7 @@ const recordSchema = z.object({
 	createdBy: z.string(),
 	createdByUser: userRefSchema.nullable().optional().default(null),
 	fieldUsers: z.record(z.string(), userRefSchema).optional().default({}),
+	computedFields: z.record(z.string(), lookupComputedSchema).optional(),
 	archivedAt: z.string().nullable(),
 	createdAt: z.string(),
 	updatedAt: z.string(),
@@ -3830,8 +3896,11 @@ const recordContract = {
 		path: "/records/{recordId}/links",
 		tags: ["Records"],
 		summary: "List record links",
-		successDescription: "Active outbound links from a canonical record."
-	}).input(z.object({ recordId: z.string() })).output(z.array(recordLinkSchema))
+		successDescription: "Active links of a canonical record: outbound (this record's relation fields) by default, or inbound (other records whose relation fields link here)."
+	}).input(z.object({
+		recordId: z.string(),
+		direction: z.enum(["outbound", "inbound"]).optional().describe("`outbound` (default): links stored on this record. `inbound`: links from other live records that point at this record — the reverse side of a relation, i.e. 'who links here'.")
+	})).output(z.array(recordLinkSchema))
 };
 const viewContract = { changeRequest: oc.route({
 	method: "POST",
@@ -4600,9 +4669,10 @@ const installContract = {
 * The catalog is the file `busabase-cli index` builds from a skills repository
 * — see `busabase-package/index-build`. Most shapes are re-declared here rather
 * than imported because that module is Node-only (it reads packages) and these
-* are rendered in a browser; `TemplateRiskLevelSchema` is the one exception,
-* imported from the package domain because it is already pure zod and a third
-* copy of the same enum is a worse outcome than the cross-domain import.
+* are rendered in a browser; `TemplateRiskLevelSchema` and
+* `TemplateLocalesSchema` are the exceptions, imported from the package domain
+* because they are already pure zod and a second copy of the same shape is a
+* worse outcome than the cross-domain import.
 *
 * Spec: `apps/busabase/content/spec/template-center.md` §6.4.
 */
@@ -4653,6 +4723,24 @@ const TemplateCardVOSchema = z.object({
 	* than the screenshots — see `videoUrl` in the catalog logic.
 	*/
 	video: z.string().optional(),
+	/**
+	* Every default clip, absolute URLs, in display order. `video` is always the
+	* first of these (kept for clients built before this field existed — the
+	* mobile app ships separately from the server). Render through
+	* `pickTemplateMedia(card, locale)`, never from this directly.
+	*/
+	videos: z.array(TemplateVideoSchema).optional(),
+	/**
+	* Per-locale screenshots/clips, absolute URLs like the fields above,
+	* keyed by locale. Absent when the template declares none — and on every
+	* card an older catalog produced. Never read it directly: render through
+	* `pickTemplateMedia(card, locale)` (`domains/templates/media`), which owns
+	* the fallback to `screenshots` / `video`.
+	*
+	* Declared here because this is a plain `z.object`: an undeclared key would
+	* be stripped by `.output()` before it ever reached a client.
+	*/
+	locales: TemplateLocalesSchema.optional(),
 	agentPrompts: z.array(z.string()).default([]),
 	version: z.string().optional(),
 	author: z.string().optional(),

package/dist/{template-DRMp6tKv.js → template-Bnkq4diD.js}

@@ -130,6 +130,45 @@ const TemplateSecretSchema = z.object({
 	description: z.string().default(""),
 	required: z.boolean().default(true)
 });
+/**
+* One demo clip in a template's gallery.
+*
+* An object rather than a bare path, on purpose, and from the first release: the
+* catalog is read at runtime by servers that were deployed before this existed,
+* so a list of strings that later became a list of objects would break exactly
+* the servers in between. `title` is what tells two clips of one template apart
+* ("30-second tour", "Full walkthrough"); a locale that wants the title in its
+* own language declares its own `videos` list.
+*
+* `src` is package-relative in `busabase.json` and an absolute URL on the card.
+*/
+const TemplateVideoSchema = z.object({
+	src: z.string().min(1),
+	title: z.string().optional()
+});
+/**
+* One locale's own gallery media — the value side of `template.locales`.
+*
+* All fields optional and independent: a locale that only re-recorded the clip
+* declares just `video` (or `videos`) and keeps the default screenshots. Paths
+* are package-relative in `busabase.json` and absolute URLs on the catalog card;
+* the shape is the same, which is why the card VO reuses this schema.
+*/
+const TemplateLocaleMediaSchema = z.object({
+	/** Replaces the default list WHOLE for this locale — never merged per index. */
+	screenshots: z.array(z.string()).optional(),
+	video: z.string().optional(),
+	/** Replaces the default clips WHOLE for this locale; wins over `video` here. */
+	videos: z.array(TemplateVideoSchema).optional()
+});
+/**
+* Per-locale media keyed by locale (`"zh-CN"`, `"ja"`).
+*
+* Keys are plain strings on purpose, not the supported-locale enum: a template
+* written for a locale this server does not know yet must still install. The
+* audit warns about such keys; the schema never rejects them.
+*/
+const TemplateLocalesSchema = z.record(z.string(), TemplateLocaleMediaSchema);
 z.object({
 	/** Template Center category, e.g. `"crm"`, `"email"`, `"content"`. */
 	category: z.string().min(1),
@@ -150,6 +189,31 @@ z.object({
 	*/
 	video: z.string().optional(),
 	/**
+	* Several demo clips, in the order they are shown (cover first, then these,
+	* then the screenshots), at most `TEMPLATE_VIDEO_LIMIT`.
+	*
+	* `video` stays the one-clip shorthand and is unchanged. When `videos` is
+	* declared it wins, and the catalog index still writes `video` as the first
+	* entry's path so servers deployed before this field existed keep showing one
+	* clip instead of none.
+	*/
+	videos: z.array(TemplateVideoSchema).optional(),
+	/**
+	* Localized gallery media, the App Store / Google Play rule: a viewer whose
+	* locale has an entry sees that entry's `screenshots` / `video` / `videos`; anything the
+	* entry leaves out, and every locale without an entry, falls back to the two
+	* fields above. Those stay the English/default set — they are what every
+	* deployed server and CLI already reads, so their meaning cannot change.
+	*
+	* `{ "zh-CN": { "screenshots": ["assets/screenshots/cover-zh-CN.webp"],
+	*               "video": "assets/recordings/busa-rnd-zh-CN.mp4" } }`
+	*
+	* Additive by construction: an older parser strips the key (see the note on
+	* `video`), so an older server simply shows the defaults. Selection lives in
+	* one place — `pickTemplateMedia` in `domains/templates/media`.
+	*/
+	locales: TemplateLocalesSchema.optional(),
+	/**
 	* Ready-made prompts shown after install ("Ask agent" prefills the first).
 	*
 	* They are the difference between a folder of tables and something a user can
@@ -235,4 +299,4 @@ z.object({
 	["isTemplateSkill"]: z.literal(true)
 });
 //#endregion
-export { uploadAsset as i, TemplateRiskLevelSchema as n, hashBytes as r, APP_ROOT_RESOURCE_KEY as t };
+export { hashBytes as a, TemplateVideoSchema as i, TemplateLocalesSchema as n, uploadAsset as o, TemplateRiskLevelSchema as r, APP_ROOT_RESOURCE_KEY as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-sdk",
-  "version": "0.97.0",
+  "version": "0.99.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",