104 lines · 3 KBtext/plain; charset=utf-8
The Coline App SDK: apps, tools, file types and surfaces that run inside Coline workspaces, and public websites with Coline Sites. TypeScript, with an in-memory test workspace. MIT.
| /** |
| 5 | * The chat-card tree subset (plan §10.4, open question #4 resolved). |
| 6 | * |
| 7 | * Tool result cards render inside chat bubbles on every platform, so the |
| 8 | * card vocabulary is a strict subset of the tree: presentational nodes, |
| 9 | * references, and buttons (which dispatch ordinary app actions). Form |
| 10 | * inputs, tabs, menus, and other stateful chrome are excluded — a card is |
| 11 | * a result, not an app surface. |
| 12 | * |
| 13 | * Bounds keep cards cheap to render and impossible to abuse as a layout |
| 14 | * engine: max 120 nodes, depth 6, 20 table rows. |
| 15 | */ |
| 16 |
| 17 | export const CHAT_CARD_ALLOWED_NODE_TYPES = new Set<string>([ |
| 18 | "Text", |
| 19 | "Heading", |
| 20 | "Badge", |
| 21 | "Divider", |
| 22 | "FileCard", |
| 23 | "UserChip", |
| 24 | "Image", |
| 25 | "Link", |
| 26 | "CodeBlock", |
| 27 | "Table", |
| 28 | "Avatar", |
| 29 | "Alert", |
| 30 | "Progress", |
| 31 | "Stack", |
| 32 | "Card", |
| 33 | "Button", |
| 34 | "Reference", |
| 35 | ]); |
| 36 |
| 37 | export const CHAT_CARD_MAX_NODES = 120; |
| 38 | export const CHAT_CARD_MAX_DEPTH = 6; |
| 39 | export const CHAT_CARD_MAX_TABLE_ROWS = 20; |
| 40 |
| 41 | export type ChatCardValidation = |
| 42 | | { ok: true; nodeCount: number } |
| 43 | | { ok: false; reason: string }; |
| 44 |
| 45 | interface WalkState { |
| 46 | count: number; |
| 47 | } |
| 48 |
| 49 | function childrenOf(node: ColineUiNode): ColineUiNode[] { |
| 50 | switch (node.type) { |
| 51 | case "Stack": |
| 52 | return node.props.children; |
| 53 | case "Card": |
| 54 | return [...(node.props.children ?? []), ...(node.props.footer ?? [])]; |
| 55 | default: |
| 56 | return []; |
| 57 | } |
| 58 | } |
| 59 |
| 60 | function walk(node: ColineUiNode, depth: number, state: WalkState): string | null { |
| 61 | if (depth > CHAT_CARD_MAX_DEPTH) { |
| 62 | return `Card exceeds the maximum depth of ${CHAT_CARD_MAX_DEPTH}.`; |
| 63 | } |
| 64 | state.count += 1; |
| 65 | if (state.count > CHAT_CARD_MAX_NODES) { |
| 66 | return `Card exceeds the maximum of ${CHAT_CARD_MAX_NODES} nodes.`; |
| 67 | } |
| 68 | if (!CHAT_CARD_ALLOWED_NODE_TYPES.has(node.type)) { |
| 69 | return `"${node.type}" nodes are not allowed in tool result cards.`; |
| 70 | } |
| 71 | if (node.type === "Table" && node.props.rows.length > CHAT_CARD_MAX_TABLE_ROWS) { |
| 72 | return `Card tables are limited to ${CHAT_CARD_MAX_TABLE_ROWS} rows.`; |
| 73 | } |
| 74 | for (const child of childrenOf(node)) { |
| 75 | const issue = walk(child, depth + 1, state); |
| 76 | if (issue) return issue; |
| 77 | } |
| 78 | return null; |
| 79 | } |
| 80 |
| 81 | export function validateChatCardTree(node: unknown): ChatCardValidation { |
| 82 | const parsed = colineUiNodeSchema.safeParse(node); |
| 83 | if (!parsed.success) { |
| 84 | return { ok: false, reason: "Card is not a valid Coline UI tree." }; |
| 85 | } |
| 86 | const state: WalkState = { count: 0 }; |
| 87 | const issue = walk(parsed.data, 1, state); |
| 88 | if (issue) { |
| 89 | return { ok: false, reason: issue }; |
| 90 | } |
| 91 | return { ok: true, nodeCount: state.count }; |
| 92 | } |
| 93 |
| 94 | /** Schema wrapper: parses a tree AND enforces the chat-card subset. */ |
| 95 | export const chatCardTreeSchema = colineUiNodeSchema.superRefine((node, ctx) => { |
| 96 | const state: WalkState = { count: 0 }; |
| 97 | const issue = walk(node, 1, state); |
| 98 | if (issue) { |
| 99 | ctx.addIssue({ code: "custom", message: issue }); |
| 100 | } |
| 101 | }); |
| 102 |
| 103 | export type ChatCardTree = z.infer<typeof chatCardTreeSchema>; |
| 104 |