@underdogai/mesh-event-schemas 0.9.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/README.md +3 -0
  2. package/card.compact.schema.json +1019 -0
  3. package/card.schema.json +1918 -0
  4. package/dist/apppacks.d.ts +48 -0
  5. package/dist/apppacks.d.ts.map +1 -1
  6. package/dist/blocks.d.ts +34 -0
  7. package/dist/blocks.d.ts.map +1 -1
  8. package/dist/blocks.js +15 -0
  9. package/dist/blocks.js.map +1 -1
  10. package/dist/calendar.d.ts +466 -0
  11. package/dist/calendar.d.ts.map +1 -0
  12. package/dist/calendar.js +169 -0
  13. package/dist/calendar.js.map +1 -0
  14. package/dist/card-json-schema.d.ts +426 -0
  15. package/dist/card-json-schema.d.ts.map +1 -0
  16. package/dist/card-json-schema.js +467 -0
  17. package/dist/card-json-schema.js.map +1 -0
  18. package/dist/events.d.ts +457 -2
  19. package/dist/events.d.ts.map +1 -1
  20. package/dist/events.js +207 -3
  21. package/dist/events.js.map +1 -1
  22. package/dist/index.d.ts +5 -0
  23. package/dist/index.d.ts.map +1 -1
  24. package/dist/index.js +5 -0
  25. package/dist/index.js.map +1 -1
  26. package/dist/namespace.d.ts +20 -0
  27. package/dist/namespace.d.ts.map +1 -1
  28. package/dist/namespace.js +20 -0
  29. package/dist/namespace.js.map +1 -1
  30. package/dist/power-levels.d.ts +85 -0
  31. package/dist/power-levels.d.ts.map +1 -0
  32. package/dist/power-levels.js +153 -0
  33. package/dist/power-levels.js.map +1 -0
  34. package/dist/profile.d.ts +26 -0
  35. package/dist/profile.d.ts.map +1 -0
  36. package/dist/profile.js +40 -0
  37. package/dist/profile.js.map +1 -0
  38. package/dist/registry.d.ts +5 -0
  39. package/dist/registry.d.ts.map +1 -1
  40. package/dist/registry.js +17 -2
  41. package/dist/registry.js.map +1 -1
  42. package/dist/room-agents.d.ts +271 -0
  43. package/dist/room-agents.d.ts.map +1 -0
  44. package/dist/room-agents.js +119 -0
  45. package/dist/room-agents.js.map +1 -0
  46. package/dist/surfaces.d.ts +265 -1
  47. package/dist/surfaces.d.ts.map +1 -1
  48. package/dist/surfaces.js +1 -1
  49. package/dist/templates.d.ts +40 -0
  50. package/dist/templates.d.ts.map +1 -1
  51. package/dist/templates.js +37 -0
  52. package/dist/templates.js.map +1 -1
  53. package/package.json +9 -4
  54. package/src/blocks.ts +15 -0
  55. package/src/calendar.ts +248 -0
  56. package/src/card-json-schema.ts +520 -0
  57. package/src/events.ts +234 -3
  58. package/src/index.ts +6 -0
  59. package/src/namespace.ts +21 -0
  60. package/src/power-levels.ts +183 -0
  61. package/src/profile.ts +42 -0
  62. package/src/registry.ts +18 -1
  63. package/src/room-agents.ts +100 -0
  64. package/src/surfaces.ts +1 -1
  65. package/src/templates.ts +64 -0
package/dist/events.d.ts CHANGED
@@ -5,7 +5,7 @@
5
5
  * 모든 형태의 단일 진실 공급원이며, appservice·bridge·client가 공통으로 import 한다.
6
6
  */
7
7
  import { z } from "zod";
8
- import { EventType, UI_CONTENT_KEY } from "./namespace.js";
8
+ import { AGENT_ASSISTED_KEY, EventType, UI_CONTENT_KEY } from "./namespace.js";
9
9
  export declare const SCHEMA_VERSION: 1;
10
10
  export declare const CardStateSchema: z.ZodEnum<["open", "submitted", "cancelled", "expired"]>;
11
11
  export type CardState = z.infer<typeof CardStateSchema>;
@@ -906,6 +906,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
906
906
  widget_id: z.ZodOptional<z.ZodString>;
907
907
  capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
908
908
  height: z.ZodOptional<z.ZodNumber>;
909
+ width: z.ZodOptional<z.ZodEnum<["column", "wide", "full"]>>;
909
910
  }, "strip", z.ZodTypeAny, {
910
911
  type: "widget";
911
912
  url: string;
@@ -913,6 +914,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
913
914
  widget_id?: string | undefined;
914
915
  capabilities?: string[] | undefined;
915
916
  height?: number | undefined;
917
+ width?: "column" | "wide" | "full" | undefined;
916
918
  }, {
917
919
  type: "widget";
918
920
  url: string;
@@ -920,6 +922,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
920
922
  widget_id?: string | undefined;
921
923
  capabilities?: string[] | undefined;
922
924
  height?: number | undefined;
925
+ width?: "column" | "wide" | "full" | undefined;
923
926
  }>, z.ZodObject<{
924
927
  type: z.ZodLiteral<"input">;
925
928
  name: z.ZodString;
@@ -2371,6 +2374,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
2371
2374
  widget_id: z.ZodOptional<z.ZodString>;
2372
2375
  capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2373
2376
  height: z.ZodOptional<z.ZodNumber>;
2377
+ width: z.ZodOptional<z.ZodEnum<["column", "wide", "full"]>>;
2374
2378
  }, "strip", z.ZodTypeAny, {
2375
2379
  type: "widget";
2376
2380
  url: string;
@@ -2378,6 +2382,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
2378
2382
  widget_id?: string | undefined;
2379
2383
  capabilities?: string[] | undefined;
2380
2384
  height?: number | undefined;
2385
+ width?: "column" | "wide" | "full" | undefined;
2381
2386
  }, {
2382
2387
  type: "widget";
2383
2388
  url: string;
@@ -2385,6 +2390,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
2385
2390
  widget_id?: string | undefined;
2386
2391
  capabilities?: string[] | undefined;
2387
2392
  height?: number | undefined;
2393
+ width?: "column" | "wide" | "full" | undefined;
2388
2394
  }>, z.ZodObject<{
2389
2395
  type: z.ZodLiteral<"input">;
2390
2396
  name: z.ZodString;
@@ -3297,6 +3303,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
3297
3303
  widget_id?: string | undefined;
3298
3304
  capabilities?: string[] | undefined;
3299
3305
  height?: number | undefined;
3306
+ width?: "column" | "wide" | "full" | undefined;
3300
3307
  })[];
3301
3308
  title?: string | undefined;
3302
3309
  }, {
@@ -3658,6 +3665,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
3658
3665
  widget_id?: string | undefined;
3659
3666
  capabilities?: string[] | undefined;
3660
3667
  height?: number | undefined;
3668
+ width?: "column" | "wide" | "full" | undefined;
3661
3669
  })[];
3662
3670
  title?: string | undefined;
3663
3671
  }>, "many">>;
@@ -4064,6 +4072,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
4064
4072
  widget_id?: string | undefined;
4065
4073
  capabilities?: string[] | undefined;
4066
4074
  height?: number | undefined;
4075
+ width?: "column" | "wide" | "full" | undefined;
4067
4076
  })[];
4068
4077
  v: 1;
4069
4078
  card_id: string;
@@ -4441,6 +4450,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
4441
4450
  widget_id?: string | undefined;
4442
4451
  capabilities?: string[] | undefined;
4443
4452
  height?: number | undefined;
4453
+ width?: "column" | "wide" | "full" | undefined;
4444
4454
  })[];
4445
4455
  title?: string | undefined;
4446
4456
  }[] | undefined;
@@ -4823,6 +4833,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
4823
4833
  widget_id?: string | undefined;
4824
4834
  capabilities?: string[] | undefined;
4825
4835
  height?: number | undefined;
4836
+ width?: "column" | "wide" | "full" | undefined;
4826
4837
  })[];
4827
4838
  title?: string | undefined;
4828
4839
  }[] | undefined;
@@ -5184,6 +5195,7 @@ export declare const UiCardContentSchema: z.ZodObject<{
5184
5195
  widget_id?: string | undefined;
5185
5196
  capabilities?: string[] | undefined;
5186
5197
  height?: number | undefined;
5198
+ width?: "column" | "wide" | "full" | undefined;
5187
5199
  })[] | undefined;
5188
5200
  v?: 1 | undefined;
5189
5201
  state?: "open" | "submitted" | "cancelled" | "expired" | undefined;
@@ -5618,9 +5630,64 @@ export type RoomAppsContent = z.infer<typeof RoomAppsContentSchema>;
5618
5630
  export declare function buildRoomApps(roomApps: Omit<RoomAppsContent, "v"> & {
5619
5631
  v?: typeof SCHEMA_VERSION;
5620
5632
  }): RoomAppsContent;
5633
+ export declare const AgentPolicyContentSchema: z.ZodObject<{
5634
+ v: z.ZodDefault<z.ZodLiteral<1>>;
5635
+ /** 이 방에서 멤버가 자기 에이전트에 대화 · 파일을 맥락으로 넘길 수 있나. */
5636
+ enabled: z.ZodBoolean;
5637
+ }, "strip", z.ZodTypeAny, {
5638
+ v: 1;
5639
+ enabled: boolean;
5640
+ }, {
5641
+ enabled: boolean;
5642
+ v?: 1 | undefined;
5643
+ }>;
5644
+ export type AgentPolicyContent = z.infer<typeof AgentPolicyContentSchema>;
5645
+ /** 방 에이전트 허용 content 를 만든다(org.corp.agent.policy, state_key=""). */
5646
+ export declare function buildAgentPolicy(policy: Omit<AgentPolicyContent, "v"> & {
5647
+ v?: typeof SCHEMA_VERSION;
5648
+ }): AgentPolicyContent;
5621
5649
  /** 노트 블록의 닫힌 종류 집합 — 모르는 종류는 수신측이 문단으로 관용 처리한다. */
5622
5650
  export declare const NOTE_BLOCK_TYPES: readonly ["paragraph", "heading", "bullet", "numbered", "todo", "quote", "code", "divider"];
5623
5651
  export type NoteBlockType = (typeof NOTE_BLOCK_TYPES)[number];
5652
+ /** 어느 입구의 초안이었나. `outbox` 는 작업 모드(STEP 5), `app-*` 는 SDK(STEP 3 · 4). */
5653
+ export declare const AGENT_ASSISTED_KINDS: readonly ["reply-draft", "note-draft", "form-draft", "outbox", "app-card", "app-request"];
5654
+ export type AgentAssistedKind = (typeof AGENT_ASSISTED_KINDS)[number];
5655
+ export declare const AgentAssistedSchema: z.ZodObject<{
5656
+ v: z.ZodDefault<z.ZodLiteral<1>>;
5657
+ kind: z.ZodEnum<["reply-draft", "note-draft", "form-draft", "outbox", "app-card", "app-request"]>;
5658
+ /** 카탈로그 id("codex") 만 — 버전 · 경로 · 계정은 싣지 않는다. */
5659
+ agent: z.ZodString;
5660
+ /** 사람이 넣은 초안을 고쳐서 보냈나. */
5661
+ edited: z.ZodBoolean;
5662
+ /** 초안이 들어간 칸 이름(폼 제출 — STEP 3). */
5663
+ fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5664
+ /** 작업 세션 이름(STEP 5). */
5665
+ session: z.ZodOptional<z.ZodString>;
5666
+ }, "strip", z.ZodTypeAny, {
5667
+ kind: "reply-draft" | "note-draft" | "form-draft" | "outbox" | "app-card" | "app-request";
5668
+ v: 1;
5669
+ agent: string;
5670
+ edited: boolean;
5671
+ fields?: string[] | undefined;
5672
+ session?: string | undefined;
5673
+ }, {
5674
+ kind: "reply-draft" | "note-draft" | "form-draft" | "outbox" | "app-card" | "app-request";
5675
+ agent: string;
5676
+ edited: boolean;
5677
+ fields?: string[] | undefined;
5678
+ v?: 1 | undefined;
5679
+ session?: string | undefined;
5680
+ }>;
5681
+ export type AgentAssisted = z.infer<typeof AgentAssistedSchema>;
5682
+ /** 실을 값을 만든다 — 싣는 자리는 `[AGENT_ASSISTED_KEY]` 키다. */
5683
+ export declare function buildAgentAssisted(assisted: Omit<AgentAssisted, "v"> & {
5684
+ v?: typeof SCHEMA_VERSION;
5685
+ }): AgentAssisted;
5686
+ /**
5687
+ * content 에서 흔적을 읽는다 — 없거나 모양이 틀리면 `null`(그리는 쪽을 깨뜨리지 않는다).
5688
+ * 받는 쪽 표시는 봇 · 에이전트 배지 통일과 묶여 있어 아직 화면에 안 그린다(값만 싣는다).
5689
+ */
5690
+ export declare function readAgentAssisted(content: unknown): AgentAssisted | null;
5624
5691
  export declare const NoteBlockContentSchema: z.ZodObject<{
5625
5692
  v: z.ZodDefault<z.ZodLiteral<1>>;
5626
5693
  type: z.ZodEnum<["paragraph", "heading", "bullet", "numbered", "todo", "quote", "code", "divider"]>;
@@ -5632,6 +5699,33 @@ export declare const NoteBlockContentSchema: z.ZodObject<{
5632
5699
  level: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
5633
5700
  /** 체크 여부 — type="todo" 일 때만 의미. */
5634
5701
  checked: z.ZodOptional<z.ZodBoolean>;
5702
+ /** 에이전트 초안에서 시작한 줄인가(D16) — optional, 없으면 사람이 쓴 줄이다. */
5703
+ "org.corp.agent.assisted": z.ZodOptional<z.ZodObject<{
5704
+ v: z.ZodDefault<z.ZodLiteral<1>>;
5705
+ kind: z.ZodEnum<["reply-draft", "note-draft", "form-draft", "outbox", "app-card", "app-request"]>;
5706
+ /** 카탈로그 id("codex") 만 — 버전 · 경로 · 계정은 싣지 않는다. */
5707
+ agent: z.ZodString;
5708
+ /** 사람이 넣은 초안을 고쳐서 보냈나. */
5709
+ edited: z.ZodBoolean;
5710
+ /** 초안이 들어간 칸 이름(폼 제출 — STEP 3). */
5711
+ fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5712
+ /** 작업 세션 이름(STEP 5). */
5713
+ session: z.ZodOptional<z.ZodString>;
5714
+ }, "strip", z.ZodTypeAny, {
5715
+ kind: "reply-draft" | "note-draft" | "form-draft" | "outbox" | "app-card" | "app-request";
5716
+ v: 1;
5717
+ agent: string;
5718
+ edited: boolean;
5719
+ fields?: string[] | undefined;
5720
+ session?: string | undefined;
5721
+ }, {
5722
+ kind: "reply-draft" | "note-draft" | "form-draft" | "outbox" | "app-card" | "app-request";
5723
+ agent: string;
5724
+ edited: boolean;
5725
+ fields?: string[] | undefined;
5726
+ v?: 1 | undefined;
5727
+ session?: string | undefined;
5728
+ }>>;
5635
5729
  }, "strip", z.ZodTypeAny, {
5636
5730
  type: "code" | "heading" | "divider" | "todo" | "paragraph" | "bullet" | "numbered" | "quote";
5637
5731
  text: string;
@@ -5639,12 +5733,28 @@ export declare const NoteBlockContentSchema: z.ZodObject<{
5639
5733
  order: string;
5640
5734
  level?: 1 | 2 | 3 | undefined;
5641
5735
  checked?: boolean | undefined;
5736
+ "org.corp.agent.assisted"?: {
5737
+ kind: "reply-draft" | "note-draft" | "form-draft" | "outbox" | "app-card" | "app-request";
5738
+ v: 1;
5739
+ agent: string;
5740
+ edited: boolean;
5741
+ fields?: string[] | undefined;
5742
+ session?: string | undefined;
5743
+ } | undefined;
5642
5744
  }, {
5643
5745
  type: "code" | "heading" | "divider" | "todo" | "paragraph" | "bullet" | "numbered" | "quote";
5644
5746
  order: string;
5645
5747
  text?: string | undefined;
5646
5748
  level?: 1 | 2 | 3 | undefined;
5647
5749
  checked?: boolean | undefined;
5750
+ "org.corp.agent.assisted"?: {
5751
+ kind: "reply-draft" | "note-draft" | "form-draft" | "outbox" | "app-card" | "app-request";
5752
+ agent: string;
5753
+ edited: boolean;
5754
+ fields?: string[] | undefined;
5755
+ v?: 1 | undefined;
5756
+ session?: string | undefined;
5757
+ } | undefined;
5648
5758
  v?: 1 | undefined;
5649
5759
  }>;
5650
5760
  export type NoteBlockContent = z.infer<typeof NoteBlockContentSchema>;
@@ -5936,6 +6046,82 @@ export type AgentStepContent = z.infer<typeof AgentStepContentSchema>;
5936
6046
  /** 작업항목의 라이프사이클 상태. todo → in_progress → done. blocked(막힘)·cancelled(취소)는 분기. */
5937
6047
  export declare const TaskStatusSchema: z.ZodEnum<["todo", "in_progress", "blocked", "done", "cancelled"]>;
5938
6048
  export type TaskStatus = z.infer<typeof TaskStatusSchema>;
6049
+ /**
6050
+ * 태스크 상세의 **탭 종류**(0.10.0, #714 §6-1) — 닫힌 다섯 가지 중 앱이 고르고, 순서와 모양은 렌더러가 정한다.
6051
+ * 0.9.0 의 "작성자는 의도만, 배치는 렌더러"와 같은 결이다.
6052
+ *
6053
+ * - `overview` 개요 — task.create 의 필드(제목·요청자·마감·완료 규칙)와 진행.
6054
+ * - `work` 작업 — 처리 카드(task.create 를 `m.reference` 하는 `org.corp.ui` 카드). **항상 선다** —
6055
+ * 카드는 태스크마다 반드시 있으므로 SDK(`ctx.task.create`)가 빠뜨린 걸 채운다.
6056
+ * - `files` 파일 · `media` 미디어 · `activity` 활동 — 무엇을 어디서 모아 그릴지는 상세 셸(STEP 4)이 정한다.
6057
+ *
6058
+ * 🔴 **닫힌 값이다.** 값을 하나 더하면 그 값을 모르는 클라는 task.create **전체**를 `schema_mismatch` 로
6059
+ * 못 읽는다(블록 하나가 떨어지는 것과 급이 다르다 — 할 일이 인박스에서 사라진다). 더할 때는 읽는 쪽이 먼저
6060
+ * 모르는 값을 견디게 만든 뒤 minor 로 연다(event-model.md §5 의 "닫힌 유니온은 degrade 안 한다").
6061
+ */
6062
+ export declare const TASK_TABS: readonly ["overview", "work", "files", "media", "activity"];
6063
+ export declare const TaskTabSchema: z.ZodEnum<["overview", "work", "files", "media", "activity"]>;
6064
+ export type TaskTab = z.infer<typeof TaskTabSchema>;
6065
+ /**
6066
+ * 완료 규칙(0.10.0) — 여럿에게 팬아웃된 한 태스크(같은 task_id 의 복제본들)가 **언제 끝나는가**.
6067
+ *
6068
+ * - `first`(선점) — 누구든 먼저 처리하면 끝나고 나머지 복제본은 취소된다.
6069
+ * - `quorum`(정족수) — 서로 다른 `min` 명이 처리해야 끝난다. `approval.request` 의 `min_approvals` 와 같은 뜻이라
6070
+ * 진행 파생은 `approvalProgress` 를 재사용한다(STEP 5).
6071
+ *
6072
+ * 집행(취소 update 발행)은 호스트 몫이다 — 이 필드는 "무엇이 규칙인가"를 방 안에 남겨, 호스트가 재시작한 뒤에도
6073
+ * 방 데이터만으로 규칙을 다시 읽게 한다. 🔴 `kind` 도 닫힌 값이다(TASK_TABS 머리말과 같은 경고).
6074
+ */
6075
+ export declare const TaskCompletionSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
6076
+ kind: z.ZodLiteral<"first">;
6077
+ }, "strip", z.ZodTypeAny, {
6078
+ kind: "first";
6079
+ }, {
6080
+ kind: "first";
6081
+ }>, z.ZodObject<{
6082
+ kind: z.ZodLiteral<"quorum">;
6083
+ min: z.ZodNumber;
6084
+ }, "strip", z.ZodTypeAny, {
6085
+ min: number;
6086
+ kind: "quorum";
6087
+ }, {
6088
+ min: number;
6089
+ kind: "quorum";
6090
+ }>]>;
6091
+ export type TaskCompletion = z.infer<typeof TaskCompletionSchema>;
6092
+ /**
6093
+ * 태스크 첨부(0.10.0, #714 §6-6) — 상세의 **파일·미디어 탭**이 그리는 것. 모양은 `file` 블록에서 `type` 을 뺀 것과
6094
+ * 같다(이름·크기·MIME·캡션) — 단 출처는 **`mxc` 하나**다(인증 미디어 — 호스트가 올리고, 클라는 토큰으로 받는다).
6095
+ * https `url` 은 받지 않는다: 태스크는 N 명에게 복제되는 정본이라, 외부 출처 검증을 복제본마다 되풀이할 자리를 만들지 않는다.
6096
+ *
6097
+ * - 파일 탭 = 전부(다운로드 칩 · 데스크톱은 미리보기 패널). 미디어 탭 = `mime` 이 image/·video/·audio/ 인 것(인라인 재생).
6098
+ * - 정본 create 에 실리므로 update 로 바뀌지 않는다 — 나중에 파일을 더하는 자리가 필요하면 update 쪽에 minor 로 연다.
6099
+ */
6100
+ export declare const TaskAttachmentSchema: z.ZodObject<{
6101
+ /** 파일명(표시·다운로드 이름). */
6102
+ name: z.ZodString;
6103
+ /** mxc://<서버>/<id> — 인증 미디어. */
6104
+ mxc: z.ZodString;
6105
+ /** MIME(예: "application/pdf", "video/mp4") — 미디어 탭 분류와 아이콘. 없으면 파일 탭에만 선다. */
6106
+ mime: z.ZodOptional<z.ZodString>;
6107
+ /** 바이트 크기. */
6108
+ size: z.ZodOptional<z.ZodNumber>;
6109
+ /** 보조 설명. */
6110
+ caption: z.ZodOptional<z.ZodString>;
6111
+ }, "strip", z.ZodTypeAny, {
6112
+ mxc: string;
6113
+ name: string;
6114
+ size?: number | undefined;
6115
+ mime?: string | undefined;
6116
+ caption?: string | undefined;
6117
+ }, {
6118
+ mxc: string;
6119
+ name: string;
6120
+ size?: number | undefined;
6121
+ mime?: string | undefined;
6122
+ caption?: string | undefined;
6123
+ }>;
6124
+ export type TaskAttachment = z.infer<typeof TaskAttachmentSchema>;
5939
6125
  export declare const TaskCreateContentSchema: z.ZodObject<{
5940
6126
  v: z.ZodDefault<z.ZodLiteral<1>>;
5941
6127
  /** 이 작업의 안정적 ID. update 가 이 값으로 작업을 가리킨다. */
@@ -5956,6 +6142,111 @@ export declare const TaskCreateContentSchema: z.ZodObject<{
5956
6142
  type: string;
5957
6143
  id: string;
5958
6144
  }>>;
6145
+ /**
6146
+ * 용도 id(`<app>.<용도>`) — 이 태스크가 어느 용도 방에 속하는가. `defineApp({ tasks })` 에 선언된 값이다.
6147
+ * 없으면 인박스 행의 "용도(앱 출처)" 배지를 이벤트만 보고는 못 그린다: 방의 용도 표식(TASK_ROOM_KEY — STEP 2)은
6148
+ * 방 안에서만 읽히고(검색·포워드된 사본은 출처를 잃는다), 방 이름은 바뀔 수 있다. 이벤트가 자기 출처를 들고 다녀야 한다.
6149
+ */
6150
+ purpose: z.ZodOptional<z.ZodString>;
6151
+ /**
6152
+ * 같은 용도 방 안의 분류(표시 문자열) — "같은 관객이면 한 방에 두고 category 로 가른다"(#714 §3).
6153
+ * 없으면 한 용도 방(예: 재무 승인) 안에서 경비·구매·계약을 가를 수 없다 — 방을 더 쪼개는 수밖에 없는데,
6154
+ * 그건 조인 방 수 = 용도 수라는 제약 1 을 깬다.
6155
+ */
6156
+ category: z.ZodOptional<z.ZodString>;
6157
+ /**
6158
+ * 마감 — **epoch ms 정수**. 없으면 인박스 행의 "마감" 배지와 마감순 정렬을 못 한다.
6159
+ * 🔴 정수만 받는다 — Matrix canonical JSON 은 부동소수를 받지 않는다(서명 대상이 달라진다).
6160
+ */
6161
+ due: z.ZodOptional<z.ZodNumber>;
6162
+ /**
6163
+ * 누가 요청했나(참조 값 — 0.8.0 의 Ref). task.create 의 발신자는 **앱 봇**이라, 이게 없으면 상세는
6164
+ * "재무봇이 보냄"까지만 말할 수 있고 실제 요청자(예: 결재를 올린 사람)의 얼굴·이름을 못 그린다.
6165
+ */
6166
+ requested_by: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
6167
+ user: z.ZodString;
6168
+ }, "strip", z.ZodTypeAny, {
6169
+ user: string;
6170
+ }, {
6171
+ user: string;
6172
+ }>, z.ZodObject<{
6173
+ entity: z.ZodObject<{
6174
+ type: z.ZodString;
6175
+ id: z.ZodString;
6176
+ }, "strip", z.ZodTypeAny, {
6177
+ type: string;
6178
+ id: string;
6179
+ }, {
6180
+ type: string;
6181
+ id: string;
6182
+ }>;
6183
+ url: z.ZodOptional<z.ZodString>;
6184
+ }, "strip", z.ZodTypeAny, {
6185
+ entity: {
6186
+ type: string;
6187
+ id: string;
6188
+ };
6189
+ url?: string | undefined;
6190
+ }, {
6191
+ entity: {
6192
+ type: string;
6193
+ id: string;
6194
+ };
6195
+ url?: string | undefined;
6196
+ }>]>>;
6197
+ /**
6198
+ * 완료 규칙(선점 | 정족수). 없으면 `first` 로 읽는다. 없으면 상세가 "3명 중 2명 필요" 같은 진행을
6199
+ * 못 그리고, 호스트는 재시작 뒤 이 태스크를 선점으로 닫을지 정족수로 닫을지 방 데이터만으로 알 수 없다.
6200
+ */
6201
+ completion: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
6202
+ kind: z.ZodLiteral<"first">;
6203
+ }, "strip", z.ZodTypeAny, {
6204
+ kind: "first";
6205
+ }, {
6206
+ kind: "first";
6207
+ }>, z.ZodObject<{
6208
+ kind: z.ZodLiteral<"quorum">;
6209
+ min: z.ZodNumber;
6210
+ }, "strip", z.ZodTypeAny, {
6211
+ min: number;
6212
+ kind: "quorum";
6213
+ }, {
6214
+ min: number;
6215
+ kind: "quorum";
6216
+ }>]>>;
6217
+ /**
6218
+ * 상세에 세울 탭(§6-1 — 닫힌 종류 중 앱이 고른다). 순서는 뜻이 없다(렌더러가 정한다).
6219
+ * 없으면 렌더러 기본값. 이게 없으면 "이 태스크는 파일 탭이 필요하다"는 앱의 의도를 상세가 알 길이 없다.
6220
+ */
6221
+ tabs: z.ZodOptional<z.ZodArray<z.ZodEnum<["overview", "work", "files", "media", "activity"]>, "many">>;
6222
+ /**
6223
+ * 첨부(§6-6) — 파일·미디어 탭의 출처. 없으면 상세가 이 태스크의 근거 자료(인보이스 PDF·확인할 영상)를 보여 줄 수 없고,
6224
+ * 처리 카드 문구에 링크를 적는 수밖에 없다(카드 편집에 휩쓸리고, 인증 미디어를 못 쓴다).
6225
+ */
6226
+ attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
6227
+ /** 파일명(표시·다운로드 이름). */
6228
+ name: z.ZodString;
6229
+ /** mxc://<서버>/<id> — 인증 미디어. */
6230
+ mxc: z.ZodString;
6231
+ /** MIME(예: "application/pdf", "video/mp4") — 미디어 탭 분류와 아이콘. 없으면 파일 탭에만 선다. */
6232
+ mime: z.ZodOptional<z.ZodString>;
6233
+ /** 바이트 크기. */
6234
+ size: z.ZodOptional<z.ZodNumber>;
6235
+ /** 보조 설명. */
6236
+ caption: z.ZodOptional<z.ZodString>;
6237
+ }, "strip", z.ZodTypeAny, {
6238
+ mxc: string;
6239
+ name: string;
6240
+ size?: number | undefined;
6241
+ mime?: string | undefined;
6242
+ caption?: string | undefined;
6243
+ }, {
6244
+ mxc: string;
6245
+ name: string;
6246
+ size?: number | undefined;
6247
+ mime?: string | undefined;
6248
+ caption?: string | undefined;
6249
+ }>, "many">>;
5959
6250
  }, "strip", z.ZodTypeAny, {
5960
6251
  status: "done" | "todo" | "cancelled" | "in_progress" | "blocked";
5961
6252
  title: string;
@@ -5965,7 +6256,33 @@ export declare const TaskCreateContentSchema: z.ZodObject<{
5965
6256
  type: string;
5966
6257
  id: string;
5967
6258
  } | undefined;
6259
+ purpose?: string | undefined;
5968
6260
  assignees?: string[] | undefined;
6261
+ category?: string | undefined;
6262
+ due?: number | undefined;
6263
+ requested_by?: {
6264
+ user: string;
6265
+ } | {
6266
+ entity: {
6267
+ type: string;
6268
+ id: string;
6269
+ };
6270
+ url?: string | undefined;
6271
+ } | undefined;
6272
+ completion?: {
6273
+ kind: "first";
6274
+ } | {
6275
+ min: number;
6276
+ kind: "quorum";
6277
+ } | undefined;
6278
+ tabs?: ("activity" | "overview" | "work" | "files" | "media")[] | undefined;
6279
+ attachments?: {
6280
+ mxc: string;
6281
+ name: string;
6282
+ size?: number | undefined;
6283
+ mime?: string | undefined;
6284
+ caption?: string | undefined;
6285
+ }[] | undefined;
5969
6286
  }, {
5970
6287
  title: string;
5971
6288
  task_id: string;
@@ -5974,8 +6291,34 @@ export declare const TaskCreateContentSchema: z.ZodObject<{
5974
6291
  type: string;
5975
6292
  id: string;
5976
6293
  } | undefined;
6294
+ purpose?: string | undefined;
5977
6295
  v?: 1 | undefined;
5978
6296
  assignees?: string[] | undefined;
6297
+ category?: string | undefined;
6298
+ due?: number | undefined;
6299
+ requested_by?: {
6300
+ user: string;
6301
+ } | {
6302
+ entity: {
6303
+ type: string;
6304
+ id: string;
6305
+ };
6306
+ url?: string | undefined;
6307
+ } | undefined;
6308
+ completion?: {
6309
+ kind: "first";
6310
+ } | {
6311
+ min: number;
6312
+ kind: "quorum";
6313
+ } | undefined;
6314
+ tabs?: ("activity" | "overview" | "work" | "files" | "media")[] | undefined;
6315
+ attachments?: {
6316
+ mxc: string;
6317
+ name: string;
6318
+ size?: number | undefined;
6319
+ mime?: string | undefined;
6320
+ caption?: string | undefined;
6321
+ }[] | undefined;
5979
6322
  }>;
5980
6323
  export type TaskCreateContent = z.infer<typeof TaskCreateContentSchema>;
5981
6324
  export declare const TaskUpdateContentSchema: z.ZodObject<{
@@ -5990,6 +6333,43 @@ export declare const TaskUpdateContentSchema: z.ZodObject<{
5990
6333
  progress: z.ZodOptional<z.ZodNumber>;
5991
6334
  /** 전이 사유/메모. */
5992
6335
  note: z.ZodOptional<z.ZodString>;
6336
+ /**
6337
+ * 이 갱신을 **누가 일으켰나**(0.10.0, #714 STEP 5 — 참조 값). task.update 의 발신자는 앱 봇이라, 이게 없으면
6338
+ * 활동 탭은 "지급봇 · 완료"까지만 말하고 실제로 처리한 사람(선점한 사람 · 정족수의 한 표)을 못 그린다.
6339
+ * 호스트가 **처리 카드 제출에서 온 갱신**에만 채운다(제출한 받는 사람) — 앱은 이 필드를 쓰지 않는다(ctx.task.update 에 없다).
6340
+ * 호스트는 재시작 뒤 복제본의 update 이력에서 이 값으로 "정족수에 누가 이미 셌나"를 되살린다.
6341
+ */
6342
+ by: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
6343
+ user: z.ZodString;
6344
+ }, "strip", z.ZodTypeAny, {
6345
+ user: string;
6346
+ }, {
6347
+ user: string;
6348
+ }>, z.ZodObject<{
6349
+ entity: z.ZodObject<{
6350
+ type: z.ZodString;
6351
+ id: z.ZodString;
6352
+ }, "strip", z.ZodTypeAny, {
6353
+ type: string;
6354
+ id: string;
6355
+ }, {
6356
+ type: string;
6357
+ id: string;
6358
+ }>;
6359
+ url: z.ZodOptional<z.ZodString>;
6360
+ }, "strip", z.ZodTypeAny, {
6361
+ entity: {
6362
+ type: string;
6363
+ id: string;
6364
+ };
6365
+ url?: string | undefined;
6366
+ }, {
6367
+ entity: {
6368
+ type: string;
6369
+ id: string;
6370
+ };
6371
+ url?: string | undefined;
6372
+ }>]>>;
5993
6373
  /** 원본 create 이벤트를 참조(m.reference). */
5994
6374
  "m.relates_to": z.ZodOptional<z.ZodObject<{
5995
6375
  rel_type: z.ZodLiteral<"m.reference">;
@@ -6012,6 +6392,15 @@ export declare const TaskUpdateContentSchema: z.ZodObject<{
6012
6392
  event_id: string;
6013
6393
  } | undefined;
6014
6394
  assignees?: string[] | undefined;
6395
+ by?: {
6396
+ user: string;
6397
+ } | {
6398
+ entity: {
6399
+ type: string;
6400
+ id: string;
6401
+ };
6402
+ url?: string | undefined;
6403
+ } | undefined;
6015
6404
  }, {
6016
6405
  task_id: string;
6017
6406
  status?: "done" | "todo" | "cancelled" | "in_progress" | "blocked" | undefined;
@@ -6023,8 +6412,57 @@ export declare const TaskUpdateContentSchema: z.ZodObject<{
6023
6412
  event_id: string;
6024
6413
  } | undefined;
6025
6414
  assignees?: string[] | undefined;
6415
+ by?: {
6416
+ user: string;
6417
+ } | {
6418
+ entity: {
6419
+ type: string;
6420
+ id: string;
6421
+ };
6422
+ url?: string | undefined;
6423
+ } | undefined;
6026
6424
  }>;
6027
6425
  export type TaskUpdateContent = z.infer<typeof TaskUpdateContentSchema>;
6426
+ /**
6427
+ * 태스크 방의 room type(`m.room.create.type`). 채널·DM·Invites 에서 빠지는 근거가 이 값 하나다(#714 §3.1 —
6428
+ * 태스크 방은 `is_direct` 를 쓰지 않는다). room type 은 만들 때만 정해지고 바꿀 수 없다.
6429
+ */
6430
+ export declare const TASK_ROOM_TYPE: "org.corp.task";
6431
+ /**
6432
+ * 태스크 방의 **용도 표식** — `m.room.create` content 의 이 키에 `{ v, purpose, assignee }` 가 실린다.
6433
+ *
6434
+ * 왜 상태 이벤트를 따로 두지 않고 생성 이벤트에 싣나: 방의 용도와 받는 사람은 **바뀌지 않는다**(사람 × 용도마다
6435
+ * 방 하나). 생성 이벤트는 바꿀 수 없어 PL 로 따로 지킬 필요가 없고, 방 상태도 늘지 않고(규칙 3), 초대의
6436
+ * stripped state 에도 실린다(2026-09-22 dev tuwunel 실측 — 받는 클라가 들어가기 전에 읽는다).
6437
+ *
6438
+ * 🔴 표식은 **누구나 흉내 낼 수 있다** — 사람도 room type `org.corp.task` 에 이 키를 실은 방을 만들 수 있다
6439
+ * (같은 날 실측). 그래서 읽는 쪽은 항상 **만든 사람**(생성 이벤트의 발신자 — room v11 은 content 에 creator 가
6440
+ * 없다)을 같이 본다: 호스트는 자기가 만든 방만, 클라는 신뢰하는 시스템 사용자가 만든 방만 인정한다.
6441
+ */
6442
+ export declare const TASK_ROOM_KEY: "org.corp.task";
6443
+ export declare const TaskRoomMarkerSchema: z.ZodObject<{
6444
+ v: z.ZodDefault<z.ZodLiteral<1>>;
6445
+ /** 용도 id(`<app>.<용도>`) — `defineApp({ tasks })` 의 키. 방 이름은 그 선언의 `name` 이다(바뀔 수 있어 표식이 아니다). */
6446
+ purpose: z.ZodString;
6447
+ /** 받는 사람 MXID — 이 방의 유일한 사람 멤버. 멤버십이 곧 배정이다. */
6448
+ assignee: z.ZodString;
6449
+ }, "strip", z.ZodTypeAny, {
6450
+ purpose: string;
6451
+ v: 1;
6452
+ assignee: string;
6453
+ }, {
6454
+ purpose: string;
6455
+ assignee: string;
6456
+ v?: 1 | undefined;
6457
+ }>;
6458
+ export type TaskRoomMarker = z.infer<typeof TaskRoomMarkerSchema>;
6459
+ /** `m.room.create` content 가 태스크 방의 것인가(room type 만 본다 — 만든 사람은 호출부가 따로 본다). */
6460
+ export declare function isTaskRoomCreateContent(content: unknown): boolean;
6461
+ /**
6462
+ * `m.room.create` content 에서 용도 표식을 읽는다 — 태스크 방이 아니거나 표식이 깨졌으면 null.
6463
+ * ⚠️ 만든 사람을 보지 않는다(content 만 받는다). 신뢰 판정은 호출부 몫이다 — 위 TASK_ROOM_KEY 주석.
6464
+ */
6465
+ export declare function readTaskRoomMarker(content: unknown): TaskRoomMarker | null;
6028
6466
  /** summarizeTasks 가 돌려주는 작업 1건(최신값 병합·렌더 준비). */
6029
6467
  export interface TaskSummaryItem {
6030
6468
  task_id: string;
@@ -6259,6 +6697,23 @@ export declare function buildUiMessageEdit(originalEventId: string, card: Omit<U
6259
6697
  };
6260
6698
  "m.new_content": UiMessageContent;
6261
6699
  };
6700
+ /**
6701
+ * 태스크의 **처리 카드** 메시지를 만든다(0.10.0, #714 방식 A) — `m.room.message` + `org.corp.ui` 카드가
6702
+ * 같은 방의 `org.corp.task.create` 를 `m.reference` 로 가리킨다. 이 관계 하나가 "이 카드는 그 태스크를
6703
+ * 처리하는 화면"이라는 유일한 연결이다(카드 안에 task_id 를 따로 적지 않는다 — 사본은 어긋난다).
6704
+ *
6705
+ * 복제본마다 task.create 의 event_id 가 다르므로(방마다 따로 보낸다) 호스트가 방마다 부른다.
6706
+ * 카드를 나중에 `buildUiMessageEdit` 로 고쳐도 관계는 원본 이벤트에 남는다(Matrix 는 `m.new_content` 안의
6707
+ * 관계를 무시한다) — 그래서 편집 쪽은 관계를 다시 싣지 않는다.
6708
+ */
6709
+ export declare function buildTaskCardMessage(taskEventId: string, card: Omit<UiCardContent, "v"> & {
6710
+ v?: typeof SCHEMA_VERSION;
6711
+ }): UiMessageContent & {
6712
+ "m.relates_to": {
6713
+ rel_type: "m.reference";
6714
+ event_id: string;
6715
+ };
6716
+ };
6262
6717
  /** 라이브 카드 부분 갱신 명세 — 바뀐 progress/steps/state/title 만 담는다. */
6263
6718
  export interface CardPatch {
6264
6719
  /** 첫 progress 블록 갱신 — 숫자면 value, 객체면 value/label 부분 갱신. */
@@ -6376,5 +6831,5 @@ export declare function buildUiActionResult(result: Omit<UiActionResultContent,
6376
6831
  export declare function extractUiActionResult(content: unknown): UiActionResultContent | null;
6377
6832
  /** m.room.message content 또는 임의 객체에서 끼워진 UI 카드를 추출한다(있으면). */
6378
6833
  export declare function extractUiCard(content: unknown): UiCardContent | null;
6379
- export { EventType, UI_CONTENT_KEY };
6834
+ export { AGENT_ASSISTED_KEY, EventType, UI_CONTENT_KEY };
6380
6835
  //# sourceMappingURL=events.d.ts.map