@underdogai/mesh-event-schemas 0.1.0

package/dist/surfaces.js

@@ -0,0 +1,523 @@
+/**
+ * Surface 스키마 — 룸의 "셸 서피스"(컨텍스트 패널·캔버스·헤더 등)를 선언형으로 기술한다.
+ *
+ * 핵심: 타임라인 인라인 카드(UiCardContent)를 그리던 것과 *같은 블록 어휘*를 재사용해,
+ * 셸의 패널/캔버스도 데이터로 기술하고 같은 디자인 토큰으로 렌더한다(docs/extensibility.md §10).
+ * 작성자는 의도/데이터만, 클라이언트가 룩을 소유한다(§1)는 원칙을 셸 서피스로 일반화한다.
+ *
+ * 이 파일은 패널(PanelSpec)·헤더(HeaderSpec)·캔버스(CanvasSpec) 스펙을 정의한다. 사이드바 섹션 스펙은 후속.
+ * 데이터 바인딩: 문자열 안의 `{{entity.path}}` 를 resolveBindings 로 룸 엔티티 스냅샷에서 채운다.
+ */
+import { z } from "zod";
+import { ToneSchema } from "./blocks.js";
+import { AgentPlanContentSchema, AgentStepStatusSchema, SCHEMA_VERSION, UiCardContentSchema, } from "./events.js";
+/** 키-값 묶음 (리드 정보 등). value 는 `{{entity.path}}` 바인딩 가능. */
+export const SurfaceFieldsSchema = z.object({
+    kind: z.literal("fields"),
+    items: z.object({ label: z.string(), value: z.string() }).array(),
+});
+/** 컬러 태그 묶음. */
+export const SurfaceTagsSchema = z.object({
+    kind: z.literal("tags"),
+    items: z.object({ label: z.string(), tone: ToneSchema.optional() }).array(),
+});
+/** 단일 선택형 행(상태 등) — 표시용(셀렉트 룩). */
+export const SurfaceSelectSchema = z.object({
+    kind: z.literal("select"),
+    value: z.string(),
+});
+/** 목록(관련 문서 등). */
+export const SurfaceListSchema = z.object({
+    kind: z.literal("list"),
+    items: z.object({ primary: z.string(), secondary: z.string().optional() }).array(),
+});
+/** 활동 타임라인. */
+export const SurfaceActivitySchema = z.object({
+    kind: z.literal("activity"),
+    items: z.object({ who: z.string(), what: z.string(), time: z.string() }).array(),
+});
+/** AI 요약/최근 업데이트 메모. */
+export const SurfaceMemoSchema = z.object({
+    kind: z.literal("memo"),
+    summary: z.string(),
+    updates: z.string().array().optional(),
+});
+/** 인라인 카드 임베드 — 타임라인과 *같은* UiCardContent 를 패널/캔버스에 그대로 렌더(CardRenderer 재사용). */
+export const SurfaceCardSchema = z.object({
+    kind: z.literal("card"),
+    card: UiCardContentSchema,
+});
+/** 섹션 본문 — 블록 어휘를 패널 레이아웃으로 확장한 판별 유니온. */
+export const SurfaceBodySchema = z.discriminatedUnion("kind", [
+    SurfaceFieldsSchema,
+    SurfaceTagsSchema,
+    SurfaceSelectSchema,
+    SurfaceListSchema,
+    SurfaceActivitySchema,
+    SurfaceMemoSchema,
+    SurfaceCardSchema,
+]);
+/** 패널의 한 섹션(카드 박스 1개). */
+export const SurfaceSectionSchema = z.object({
+    id: z.string(),
+    title: z.string().optional(),
+    /** 우상단 보조 액션 라벨(예: "편집", "모두 보기") */
+    action: z.string().optional(),
+    /** 소속 탭 id(PanelTab.id) — 지정 시 그 탭에서만, 미지정이면 모든 탭에서 표시(P3-6 서브탭 전환). */
+    tab: z.string().optional(),
+    body: SurfaceBodySchema,
+});
+export const PanelTabSchema = z.object({ id: z.string(), label: z.string() });
+/** 컨텍스트 패널 스펙 — 탭 + 섹션 목록. */
+export const PanelSpecSchema = z.object({
+    tabs: PanelTabSchema.array().optional(),
+    sections: SurfaceSectionSchema.array(),
+});
+// --- 룸 헤더 스펙 ---
+export const HeaderMetaSchema = z.object({
+    label: z.string(),
+    value: z.string(),
+    /** tabular-nums 강조(금액/건수) */
+    num: z.boolean().optional(),
+});
+export const HeaderMemberSchema = z.object({ label: z.string(), color: z.string() });
+export const PipelineStepSchema = z.object({
+    label: z.string(),
+    state: z.enum(["done", "active", "todo"]),
+});
+/** 룸 헤더 — 제목 + 참여자 + 메타(키-값) + 파이프라인 스테퍼. value 는 `{{entity.path}}` 바인딩 가능. */
+export const HeaderSpecSchema = z.object({
+    title: z.string(),
+    members: HeaderMemberSchema.array().optional(),
+    /** 아바타 스택 뒤 "+N" */
+    extra: z.number().optional(),
+    meta: HeaderMetaSchema.array().optional(),
+    pipeline: PipelineStepSchema.array().optional(),
+});
+// --- 이벤트 캔버스 스펙 ---
+/** 이벤트 캔버스(보드) — 제목 + 탭 + 카드 묶음(UiCardContent, CardRenderer 재사용). */
+export const CanvasSpecSchema = z.object({
+    title: z.string(),
+    tabs: z.string().array().optional(),
+    cards: UiCardContentSchema.array(),
+    /** 카드 id → 소속 탭 매핑(P3-6 서브탭 전환). 미지정 카드는 모든 탭에서 표시. 카드는 바라본 UiCardContent 유지. */
+    cardTabs: z.record(z.string(), z.string()).optional(),
+});
+// --- 에이전트 런 타임라인 스펙 (AgentPlanSpec) ---
+// 도메인 무관 C층 서피스: "에이전트가 어떤 계획으로 어디까지 진행했나"를 우측 런 타임라인으로 그린다.
+// agent.plan/agent.step 텔레메트리(events.ts)가 데이터 토대 — 이 스펙은 그 데이터를 렌더 지시로
+// 격리한 UI 표면이다(작성자는 의도/데이터, 클라가 룩 — §1). PanelSpec 과 동급의 1급 서피스 스펙.
+/** 런 타임라인의 한 단계 — id + 라벨 + 상태(+ 보조 노트·부분 공정률). */
+export const AgentPlanStepSpecSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    status: AgentStepStatusSchema,
+    note: z.string().optional(),
+    /** 이 단계의 부분 공정률 0~100(예: active 단계의 진행 표시). */
+    progress: z.number().int().min(0).max(100).optional(),
+});
+/** 에이전트 런 타임라인 — 제목 + 에이전트 + 단계 리스트 + 전체 공정률 %. */
+export const AgentPlanSpecSchema = z.object({
+    /** 런의 안정적 ID(AgentPlan.run_id) — 합성/키 용도. */
+    run_id: z.string(),
+    title: z.string().optional(),
+    agent: z.string().optional(),
+    steps: AgentPlanStepSpecSchema.array(),
+    /** 전체 공정률 0~100(생략 시 렌더러가 done/total 로 산출). */
+    progress: z.number().int().min(0).max(100).optional(),
+});
+/**
+ * agent.plan content(이벤트 데이터)를 AgentPlanSpec(렌더 지시)으로 변환한다.
+ * 와이어 포맷(버전 `v` 등)을 UI 표면에서 격리하는 봉합선 — P2-5 에서 실 텔레메트리를
+ * 이 함수로 서피스에 흘린다. 누락 키는 zod 가 떨궈내므로 content 를 그대로 넘겨도 된다.
+ */
+export function agentPlanSpec(content) {
+    const plan = AgentPlanContentSchema.parse(content);
+    return AgentPlanSpecSchema.parse({
+        run_id: plan.run_id,
+        title: plan.title,
+        agent: plan.agent,
+        steps: plan.steps,
+        progress: plan.progress,
+    });
+}
+/**
+ * agent.step 텔레메트리를 런 타임라인 스펙 위에 누적한다(원본 불변) — 매칭 단계의 상태/노트/부분 공정률만 갱신.
+ * summarizeTasks(작업 누적)의 에이전트-런 짝. P2-4 라이브 갱신: 누적된 스펙을 다시 렌더해 m.replace 로 흘린다.
+ * 전체 공정률(progress)은 손대지 않는다 — 렌더러가 plan.progress 미지정 시 done/total 로 파생한다.
+ */
+export function applyAgentStep(plan, step) {
+    return {
+        ...plan,
+        steps: plan.steps.map((s) => s.id === step.step_id ? { ...s, status: step.status, note: step.note ?? s.note, progress: step.progress } : s),
+    };
+}
+// --- 에이전트 도크 스펙 (AgentDockSpec) — M3 셸 확장(P3-1) ---
+// 팩이 "패널 외 셸 영역"까지 선언형으로 소유하는 첫 서피스. 우측 도크 = 두 종류의 항목이 흐른다:
+//  (1) run  — 라이브 에이전트 런 요약(agent.plan/agent.step 텔레메트리 = M2 C층 데이터). 도메인 무관.
+//  (2) service — 팩이 저작하는 도메인 "서비스"/퀵액션(열린 PR·CI 등). value 는 `{{entity.path}}` 바인딩 가능.
+// 즉 도크는 "팩이 기여하는 셸 면"과 "도메인 무관 C층 런 텔레메트리"가 만나는 지점이다(본질 = C층의 셸 면).
+// AgentPlanSpec(인라인 타임라인)과 *같은* 텔레메트리를 agentRunItem 으로 도크 항목으로 파생한다.
+/** 도크 런 항목 — 라이브 에이전트 런 요약(agent.plan 에서 파생). 상태 enum 은 C층 공용(AgentStepStatus). */
+export const DockRunItemSchema = z.object({
+    kind: z.literal("run"),
+    run_id: z.string(),
+    label: z.string(),
+    agent: z.string().optional(),
+    status: AgentStepStatusSchema,
+    /** 전체 공정률 0~100. */
+    progress: z.number().int().min(0).max(100).optional(),
+});
+/** 도크 서비스 항목 — 팩이 저작하는 도메인 서비스/퀵액션. detail 은 `{{entity.path}}` 바인딩 가능. */
+export const DockServiceItemSchema = z.object({
+    kind: z.literal("service"),
+    id: z.string(),
+    label: z.string(),
+    /** 짧은 상태/값(예: "3 open", "Passing"). 바인딩 가능. */
+    detail: z.string().optional(),
+    tone: ToneSchema.optional(),
+    /** 선택적 퀵액션 라벨(예: "View") — 있으면 버튼으로 렌더. */
+    action: z.string().optional(),
+});
+/** 도크 항목 — 닫힌 판별 유니온(run | service). SurfaceBody 와 같은 안전 자세. */
+export const DockItemSchema = z.discriminatedUnion("kind", [DockRunItemSchema, DockServiceItemSchema]);
+/** 도크 그룹 — 라벨 + 항목 묶음(예: "Active runs", "Repository services"). */
+export const DockGroupSchema = z.object({
+    id: z.string(),
+    label: z.string().optional(),
+    items: DockItemSchema.array(),
+});
+/** 에이전트 도크 스펙 — 우측 셸 도크(런 + 도메인 서비스)를 선언형으로 기술. PanelSpec 과 동급의 1급 서피스. */
+export const AgentDockSpecSchema = z.object({
+    title: z.string().optional(),
+    groups: DockGroupSchema.array(),
+});
+/** 전체 런 상태 — 하나라도 error → error, 단계 0개 아니고 전부 done → done, active 있으면 active, 그 외 queued. */
+export function agentRunStatus(plan) {
+    if (plan.steps.some((s) => s.status === "error"))
+        return "error";
+    if (plan.steps.length > 0 && plan.steps.every((s) => s.status === "done"))
+        return "done";
+    if (plan.steps.some((s) => s.status === "active"))
+        return "active";
+    return "queued";
+}
+/** 전체 공정률 0~100 — plan.progress 우선, 없으면 done/total. (AgentPlanRenderer 와 동일 규칙) */
+export function agentRunPercent(plan) {
+    const total = plan.steps.length;
+    const done = plan.steps.filter((s) => s.status === "done").length;
+    return Math.max(0, Math.min(100, Math.round(plan.progress ?? (total ? (done / total) * 100 : 0))));
+}
+/**
+ * AgentPlanSpec(인라인 런 타임라인) → 도크 런 항목으로 파생한다. 이것이 본질 봉합선:
+ * M2 의 agent.plan 텔레메트리가 인라인 AgentPlanRenderer 와 *같은 데이터*로 셸 도크도 구동한다.
+ */
+export function agentRunItem(plan) {
+    return {
+        kind: "run",
+        run_id: plan.run_id,
+        label: plan.title ?? "Agent run",
+        agent: plan.agent,
+        status: agentRunStatus(plan),
+        progress: agentRunPercent(plan),
+    };
+}
+// --- 사이드바 섹션 스펙 (SidebarSectionSpec) — M3 셸 확장(P3-2) ---
+// 팩이 좌측 레일에 도메인 네비게이션(섹션 + 항목)을 선언형으로 기여한다. 도크(우측)와 짝 — 패널 외
+// 셸의 또 다른 면. label/hint/badge.label 은 패널/헤더/도크와 *같은* resolveBindings 봉합선으로 바인딩.
+/** 사이드바 항목 — 네비게이션 엔트리(룸/뷰/필터). label/hint/badge.label 은 `{{entity.path}}` 바인딩 가능. */
+export const SidebarItemSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    /** 좌측 글리프(짧은 심볼: "#", "◆" 등). 생략 시 렌더러가 기본 점. */
+    glyph: z.string().optional(),
+    /** 보조 텍스트(우측 흐린 글씨, 예: "3 open"). */
+    hint: z.string().optional(),
+    /** 카운트/상태 배지. */
+    badge: z.object({ label: z.string(), tone: ToneSchema.optional() }).optional(),
+});
+/** 사이드바 섹션 — 라벨 + 항목 묶음(+ 우상단 보조 액션 어포던스). 팩이 여러 섹션을 기여(AppPack.sidebar[]). */
+export const SidebarSectionSpecSchema = z.object({
+    id: z.string(),
+    label: z.string().optional(),
+    /** 우상단 보조 액션 라벨(예: "+", "All") */
+    action: z.string().optional(),
+    items: SidebarItemSchema.array(),
+});
+// --- 컴포저 스펙 (ComposerSpec) — M3 셸 확장(P3-3) ---
+// 팩이 입력창(컴포저)을 선언형으로 소유: 도메인 슬래시 명령 · 퀵액션 칩 · @엔티티 자동완성 후보.
+// 사이드바(좌)·도크(우)에 이어 컴포저(하단) — 패널 외 셸의 세 번째 면. 임의 실행 없는 닫힌 데이터.
+/** 슬래시 명령 — 작성자가 "/" 로 부르는 도메인 액션. */
+export const ComposerCommandSchema = z.object({
+    /** 트리거(예: "/merge", "/review"). "/" 로 시작. */
+    trigger: z.string().regex(/^\/\S+$/, "trigger 는 '/word' 형식"),
+    label: z.string(),
+    hint: z.string().optional(),
+    /**
+     * 실행할 액션 id — 있으면 이 명령을 전송할 때 평범한 m.text 가 아니라 org.corp.ui.action(action_id)로 발행한다
+     * (호스트가 서버 게이트→App 핸들러로 왕복). 없으면(undefined) 트리거는 자동완성 어휘일 뿐, 전송은 일반 채팅.
+     */
+    action_id: z.string().optional(),
+    /**
+     * 인자 값 키 — 있으면 트리거 뒤에 남은 텍스트(선행 "#"·"@" 제거)를 values[arg] 로 담아 액션에 실어 보낸다.
+     * (예: arg="pr" 이면 "/merge #42" → values={ pr: "42" }). action_id 가 있을 때만 의미가 있다.
+     */
+    arg: z.string().optional(),
+});
+/** 퀵액션 칩 — 컴포저 위 한-탭 도메인 액션. */
+export const ComposerQuickActionSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    glyph: z.string().optional(),
+    tone: ToneSchema.optional(),
+});
+/** @엔티티 자동완성 후보 — 작성자가 "@" 로 부르는 사람/엔티티. */
+export const ComposerMentionSchema = z.object({
+    /** 삽입 토큰(예: "@minah", "#42"). */
+    id: z.string(),
+    label: z.string(),
+    /** 종류 태그(예: "Reviewer", "PR"). */
+    type: z.string().optional(),
+    hint: z.string().optional(),
+});
+/** 컴포저 스펙 — 팩이 기여하는 입력창 어휘(명령·퀵액션·멘션). 전부 선택(부분 기여 가능). */
+export const ComposerSpecSchema = z.object({
+    placeholder: z.string().optional(),
+    commands: ComposerCommandSchema.array().optional(),
+    quickActions: ComposerQuickActionSchema.array().optional(),
+    mentions: ComposerMentionSchema.array().optional(),
+});
+// --- 커맨드 팔레트 스펙 (CommandPaletteSpec) — M3 셸 확장(P3-4) ---
+// 팩이 ⌘K 전역 커맨드 팔레트에 도메인 액션을 선언형으로 기여(그룹 + 엔트리). 패널 외 셸의 네 번째 면.
+// 렌더러는 포커스 트랩 모달 오버레이 + 검색 필터 + 키보드 내비. label/hint 는 `{{entity.path}}` 바인딩 가능.
+/** 팔레트 엔트리 — 하나의 실행 가능한 커맨드. */
+export const CommandEntrySchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    hint: z.string().optional(),
+    glyph: z.string().optional(),
+    /** 검색 매칭 보조 키워드(라벨 외). */
+    keywords: z.string().array().optional(),
+});
+/** 팔레트 그룹 — 라벨 + 엔트리 묶음(예: "Pull requests", "CI"). */
+export const CommandGroupSchema = z.object({
+    id: z.string(),
+    label: z.string().optional(),
+    entries: CommandEntrySchema.array(),
+});
+/** 커맨드 팔레트(⌘K) 스펙 — 팩이 기여하는 전역 커맨드 어휘. */
+export const CommandPaletteSpecSchema = z.object({
+    placeholder: z.string().optional(),
+    groups: CommandGroupSchema.array(),
+});
+// --- 토스트 스펙 (ToastSpec) — M3 셸 확장(P3-4) ---
+// 선언형 알림 1급 프리미티브(다이얼로그·알림 면). 런타임 이벤트/액션이 토스트를 띄운다 — 렌더 지시 격리.
+// (Modal/Sheet 일반형은 CommandPalette 가 확립한 오버레이 셸 위에 후속.)
+/** 토스트 — 톤 + 제목 + 선택 메시지 + 선택 액션 라벨. role=status/aria-live 로 렌더. */
+export const ToastSpecSchema = z.object({
+    tone: ToneSchema.optional(),
+    title: z.string(),
+    message: z.string().optional(),
+    /** 선택 액션 버튼 라벨(예: "Undo", "View"). */
+    action: z.string().optional(),
+});
+// --- 모달/시트 스펙 (ModalSpec) — 선언형 오버레이(확인 다이얼로그·시트). ToastSpec 의 짝 ---
+// CommandPalette 가 확립한 포커스 트랩 오버레이 셸 위에 올린 일반형(surfaces.ts 가 약속만 하던 후속).
+// 파괴적 셸 액션(배포/롤백/삭제)을 보내기 전 사람에게 확인을 받는 UX 게이트 — 권한의 최종 결정은 서버.
+// 팩이 AppPack.modals[] 로 선언하고, 같은 id 를 가진 커맨드/도크/사이드바 항목이 이 모달을 연다(확인 시 confirm.action_id 발행).
+/** 모달 확인 버튼 — 라벨 + 발행할 action_id(+톤). */
+export const ModalConfirmSchema = z.object({
+    label: z.string(),
+    /** 확인 시 발행할 액션 id(org.corp.ui.action). */
+    action_id: z.string(),
+    tone: ToneSchema.optional(),
+});
+/** 모달/시트 스펙 — 제목 + 설명 + 톤 + 확인/취소. title/description 은 `{{entity.path}}` 바인딩 가능. */
+export const ModalSpecSchema = z.object({
+    /** 이 모달의 안정적 id — 같은 id 의 셸 액션이 이 모달을 연다. */
+    id: z.string(),
+    /** dialog=중앙 모달(기본), sheet=하단/측면 시트. */
+    variant: z.enum(["dialog", "sheet"]).optional(),
+    title: z.string(),
+    description: z.string().optional(),
+    tone: ToneSchema.optional(),
+    /** 확인 버튼(있으면) — 누르면 confirm.action_id 를 발행하고 닫는다. */
+    confirm: ModalConfirmSchema.optional(),
+    /** 취소/닫기 라벨(기본 "Cancel"). */
+    cancelLabel: z.string().optional(),
+});
+// --- 객체 맵 스펙 (ObjectMapSpec) — M3 셸 확장(P3-5) ---
+// 팩이 도메인 엔티티 간 관계(리드↔연락처↔딜 / repo↔pr↔issue↔사람)를 선언형 그래프로 기여.
+// 렌더러는 정적 원형 레이아웃 SVG(무JS 배치) + 스크린리더용 관계 텍스트 대체(차트 블록의 a11y 자세).
+// label/type 은 `{{entity.path}}` 바인딩 가능.
+/** 그래프 노드 — 하나의 엔티티. */
+export const ObjectMapNodeSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    /** 엔티티 종류 태그(예: "repo", "pr", "issue", "person"). */
+    type: z.string().optional(),
+    tone: ToneSchema.optional(),
+});
+/** 그래프 엣지 — 노드 간 관계(from→to). */
+export const ObjectMapEdgeSchema = z.object({
+    from: z.string(),
+    to: z.string(),
+    /** 관계 라벨(예: "reviews", "blocks", "assigned"). */
+    label: z.string().optional(),
+});
+/** 객체 맵 스펙 — 엔티티 관계 그래프(노드 + 엣지). */
+export const ObjectMapSpecSchema = z.object({
+    title: z.string().optional(),
+    nodes: ObjectMapNodeSchema.array(),
+    edges: ObjectMapEdgeSchema.array(),
+});
+// --- 앱 서피스 와이어 이벤트 (org.corp.app.surface) — "서피스를 데이터로" ---
+// 클라에 팩을 컴파일해 넣는 대신(registerAppPack=클라 평면), 앱(App Service)이 셸 서피스(패널/헤더)를
+// 상태 이벤트로 룸에 실어 보낸다 → "Matrix App Service 만 추가해도" 회사별 UI 가 등록·렌더된다.
+// 닫힌 SurfaceBody + 토큰 오버라이드만 담는다(임의 코드 없음 = 데이터). 클라 SurfaceRenderer 가 그대로 그린다.
+// 카드(메시지)와 짝: 카드=per-message 데이터, 서피스=per-room 상태 데이터. 둘 다 같은 어휘/렌더러/안전 속성.
+export const AppSurfaceContentSchema = z.object({
+    // 버전 전방호환(PLAN-2, App SDK 한정): app.surface 는 App SDK 로 *와이어를 타고* 클라로 가므로 버전 skew(새 에이전트↔
+    // 옛 클라)가 실재한다 → 인바운드 v 를 *정수면 수용*(미래 마이너/메이저 best-effort)하되, 빌더(buildAppSurface)는 항상
+    // 현재 SCHEMA_VERSION 을 주입해 strict(보낼 땐 현재 버전만). 정수 강제 = Matrix canonical JSON(소수 금지) 준수.
+    // 코어 17개 이벤트 v 는 z.literal 유지(PLAN-2: v2 도입 전 lenient 는 죽은 평행 코드 → 보류). 여기만 실제 행사됨.
+    v: z.number().int().min(1).default(SCHEMA_VERSION),
+    /** room.binding 의 app 키와 같은 식별자(작성자/도메인). */
+    app: z.string().min(1),
+    /** 사람이 읽는 앱 이름(탭 라벨 등 표시용). 없으면 클라가 app 키로 폴백. */
+    display_name: z.string().optional(),
+    /** 이 서피스가 다루는 엔티티 타입(표시/진단용). */
+    entity_type: z.string().optional(),
+    /** 우측 컨텍스트 패널(닫힌 SurfaceBody 조합). {{entity.path}} 바인딩은 클라가 resolveBindings 로 해석. */
+    panel: PanelSpecSchema,
+    /**
+     * 메인 영역 서피스(닫힌 SurfaceBody 조합) — 선택. 우측 panel 의 짝으로, 룸 본문(타임라인 대신)에
+     * 탭으로 그릴 중앙 콘텐츠를 데이터로 기술한다. 없으면 이 앱은 사이드바 탭만 제공한다.
+     */
+    main: PanelSpecSchema.optional(),
+    /** 룸 헤더(제목·메타·파이프라인) — 선택. */
+    header: HeaderSpecSchema.optional(),
+    // --- M3 셸 개방(외부 SDK) — AppPack 이 팩(클라 빌드 평면)으로만 갖던 셸 어휘를 와이어로도 연다. ---
+    // 전부 optional + *기존 스펙 스키마 재사용*(새 블록 종류 0) → 이 필드를 모르는 옛 클라는 zod 기본
+    // strip 으로 조용히 무시한다(어휘 버전 결정: v + graceful degrade 현행 유지). AppPack.sidebar(좌측 레일)는
+    // 워크스페이스-수준 표면이라 방-수준 와이어로 열지 않는다(팩 전용 유지 — AppDef.sidebar=panel 과의 혼동 방지).
+    /** 이벤트 캔버스(보드) — 선택(AppPack.canvas 동일 어휘). */
+    canvas: CanvasSpecSchema.optional(),
+    /** 우측 에이전트 도크 — 선택(AppPack.dock 동일). */
+    dock: AgentDockSpecSchema.optional(),
+    /** 컴포저(슬래시 명령·퀵액션·@엔티티 자동완성) — 선택(AppPack.composer 동일). */
+    composer: ComposerSpecSchema.optional(),
+    /** ⌘K 커맨드 팔레트 엔트리 — 선택(AppPack.commandPalette 동일). */
+    commandPalette: CommandPaletteSpecSchema.optional(),
+    /** 객체 맵(엔티티 관계 그래프) — 선택(AppPack.objectMap 동일). */
+    objectMap: ObjectMapSpecSchema.optional(),
+    /** 선언형 모달/시트(확인 다이얼로그) — 선택(AppPack.modals 동일). 같은 id 의 셸 액션이 연다. */
+    modals: ModalSpecSchema.array().optional(),
+    /**
+     * 회사별 브랜드 토큰 오버라이드(--cob-color-* → 값). 클라가 룩(디자인 토큰)을 소유하되,
+     * 테넌트는 토큰만 갈아끼워 자기 브랜드를 입힌다(임의 CSS 아님 = 닫힌 토큰 키). 클라가 inline CSS 변수로 적용.
+     */
+    theme: z.record(z.string()).optional(),
+});
+/** AppSurface content 빌더 — v 주입 + 스키마 검증(앱은 이걸 상태 이벤트로 룸에 게시). 항상 현재 SCHEMA_VERSION(strict). */
+export function buildAppSurface(input) {
+    return AppSurfaceContentSchema.parse({ ...input, v: SCHEMA_VERSION });
+}
+/**
+ * 인바운드 app.surface content 에서 모르는/깨진 섹션을 떨어낸다(전방호환 graceful degrade) — strict 파싱 전 호출.
+ * dropUnknownBlocks(카드, events.ts)의 *서피스 짝*: panel/main 의 섹션 body 는 discriminatedUnion 이라 한 섹션만
+ * 미지(미래 kind)여도 array 전체가 실패 → 서피스 전체(헤더/테마 포함)가 붕괴한다. 그래서 *클라 렌더 경로에 한해*
+ * 각 섹션을 개별 safeParse 해 통과한 것만 남긴다(미지 섹션 드롭, 나머지 섹션 + 헤더/테마 정상 렌더). 빌더는 strict 그대로.
+ * 버전 lenient(위)와 짝 — 새 에이전트가 보낸 v2/새 섹션 서피스를 옛 클라가 알아보는 부분만 그린다(실제 행사되는 경로).
+ */
+export function dropUnknownSurfaceSections(raw) {
+    if (!raw || typeof raw !== "object")
+        return raw;
+    const c = raw;
+    const keepSections = (panel) => {
+        if (!panel || typeof panel !== "object")
+            return panel;
+        const p = panel;
+        if (!Array.isArray(p.sections))
+            return panel;
+        return { ...p, sections: p.sections.filter((s) => SurfaceSectionSchema.safeParse(s).success) };
+    };
+    return {
+        ...c,
+        ...(c.panel !== undefined ? { panel: keepSections(c.panel) } : {}),
+        ...(c.main !== undefined ? { main: keepSections(c.main) } : {}),
+    };
+}
+// --- 데이터 바인딩 ---
+function getPath(obj, path) {
+    return path.split(".").reduce((acc, key) => {
+        if (acc == null || typeof acc !== "object")
+            return undefined;
+        return acc[key];
+    }, obj);
+}
+const BINDING_RE = /\{\{\s*([\w.]+)\s*\}\}/g;
+/**
+ * 스펙(또는 임의 값) 안의 모든 문자열에서 `{{path}}` 를 엔티티 스냅샷 값으로 치환한다.
+ * 선언형/샌드박스(임의 코드 없음) — UI Blocks 와 같은 안전 자세.
+ *
+ * 규칙:
+ *  - **문자열 전용 바인딩.** 문자열 안의 토큰만 치환하므로, zod 가 number 로 받는 필드
+ *    (예: progress.value)는 `{{path}}` 로 바인딩할 수 없다(스키마 검증에서 거부됨). 숫자/불리언은
+ *    작성 시점 리터럴로 둔다.
+ *  - **미해결 경로**(엔티티에 없음/오타)는 `{{path}}` 토큰을 그대로 남겨 가시화한다(빈 문자열로
+ *    조용히 사라지지 않게 — 작성자 footgun 방지).
+ *  - null → 빈 문자열, 객체/배열 → 빈 문자열("[object Object]"/"a,b" 방지). number/boolean/0/false 는 그대로.
+ */
+export function resolveBindings(spec, entity) {
+    const walk = (v) => {
+        if (typeof v === "string") {
+            return v.replace(BINDING_RE, (match, path) => {
+                const resolved = getPath(entity, path);
+                if (resolved === undefined)
+                    return match; // 미해결 → 토큰 유지(가시화)
+                if (resolved === null)
+                    return "";
+                if (typeof resolved === "object")
+                    return ""; // 객체/배열 stringify 방지
+                return String(resolved); // string | number | boolean
+            });
+        }
+        if (Array.isArray(v))
+            return v.map(walk);
+        if (v && typeof v === "object") {
+            const out = {};
+            for (const [k, val] of Object.entries(v))
+                out[k] = walk(val);
+            return out;
+        }
+        return v;
+    };
+    return walk(spec);
+}
+// --- 바인딩 진단 (서피스 빌더 — P3-7) ---
+// 작성자 도구가 "이 스펙이 참조하는 모든 {{path}}" 와 "엔티티에서 해결되는지"를 보여주기 위한 헬퍼.
+// resolveBindings 와 같은 규칙(BINDING_RE/getPath)을 재사용 — 미해결 바인딩 footgun 을 가시화한다.
+/** 스펙(임의 값)의 모든 문자열에서 참조된 고유 `{{path}}` 경로를 수집(정렬). */
+export function collectBindingPaths(spec) {
+    const paths = new Set();
+    const walk = (v) => {
+        if (typeof v === "string") {
+            for (const m of v.matchAll(BINDING_RE))
+                paths.add(m[1]);
+        }
+        else if (Array.isArray(v)) {
+            v.forEach(walk);
+        }
+        else if (v && typeof v === "object") {
+            Object.values(v).forEach(walk);
+        }
+    };
+    walk(spec);
+    return [...paths].sort();
+}
+/** 각 `{{path}}` 가 엔티티에서 해결되는지 보고(빌더의 "미해결 바인딩 리스트"). resolved=false 면 작성자 오타/누락. */
+export function bindingStatus(spec, entity) {
+    return collectBindingPaths(spec).map((path) => ({ path, resolved: getPath(entity, path) !== undefined }));
+}
+//# sourceMappingURL=surfaces.js.map

package/dist/surfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.js","sourceRoot":"","sources":["../src/surfaces.ts"],"names":[],"mappings":"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"}