@kynetic-ai/spec 0.1.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 (278) hide show
  1. package/README.md +263 -0
  2. package/dist/acp/client.d.ts +159 -0
  3. package/dist/acp/client.d.ts.map +1 -0
  4. package/dist/acp/client.js +255 -0
  5. package/dist/acp/client.js.map +1 -0
  6. package/dist/acp/framing.d.ts +119 -0
  7. package/dist/acp/framing.d.ts.map +1 -0
  8. package/dist/acp/framing.js +302 -0
  9. package/dist/acp/framing.js.map +1 -0
  10. package/dist/acp/index.d.ts +14 -0
  11. package/dist/acp/index.d.ts.map +1 -0
  12. package/dist/acp/index.js +13 -0
  13. package/dist/acp/index.js.map +1 -0
  14. package/dist/acp/types.d.ts +89 -0
  15. package/dist/acp/types.d.ts.map +1 -0
  16. package/dist/acp/types.js +99 -0
  17. package/dist/acp/types.js.map +1 -0
  18. package/dist/agents/adapters.d.ts +55 -0
  19. package/dist/agents/adapters.d.ts.map +1 -0
  20. package/dist/agents/adapters.js +84 -0
  21. package/dist/agents/adapters.js.map +1 -0
  22. package/dist/agents/index.d.ts +8 -0
  23. package/dist/agents/index.d.ts.map +1 -0
  24. package/dist/agents/index.js +10 -0
  25. package/dist/agents/index.js.map +1 -0
  26. package/dist/agents/spawner.d.ts +53 -0
  27. package/dist/agents/spawner.d.ts.map +1 -0
  28. package/dist/agents/spawner.js +83 -0
  29. package/dist/agents/spawner.js.map +1 -0
  30. package/dist/cli/batch.d.ts +82 -0
  31. package/dist/cli/batch.d.ts.map +1 -0
  32. package/dist/cli/batch.js +162 -0
  33. package/dist/cli/batch.js.map +1 -0
  34. package/dist/cli/commands/clone-for-testing.d.ts +6 -0
  35. package/dist/cli/commands/clone-for-testing.d.ts.map +1 -0
  36. package/dist/cli/commands/clone-for-testing.js +176 -0
  37. package/dist/cli/commands/clone-for-testing.js.map +1 -0
  38. package/dist/cli/commands/derive.d.ts +6 -0
  39. package/dist/cli/commands/derive.d.ts.map +1 -0
  40. package/dist/cli/commands/derive.js +450 -0
  41. package/dist/cli/commands/derive.js.map +1 -0
  42. package/dist/cli/commands/help.d.ts +6 -0
  43. package/dist/cli/commands/help.d.ts.map +1 -0
  44. package/dist/cli/commands/help.js +196 -0
  45. package/dist/cli/commands/help.js.map +1 -0
  46. package/dist/cli/commands/inbox.d.ts +6 -0
  47. package/dist/cli/commands/inbox.d.ts.map +1 -0
  48. package/dist/cli/commands/inbox.js +235 -0
  49. package/dist/cli/commands/inbox.js.map +1 -0
  50. package/dist/cli/commands/index.d.ts +20 -0
  51. package/dist/cli/commands/index.d.ts.map +1 -0
  52. package/dist/cli/commands/index.js +21 -0
  53. package/dist/cli/commands/index.js.map +1 -0
  54. package/dist/cli/commands/init.d.ts +6 -0
  55. package/dist/cli/commands/init.d.ts.map +1 -0
  56. package/dist/cli/commands/init.js +245 -0
  57. package/dist/cli/commands/init.js.map +1 -0
  58. package/dist/cli/commands/item.d.ts +6 -0
  59. package/dist/cli/commands/item.d.ts.map +1 -0
  60. package/dist/cli/commands/item.js +1311 -0
  61. package/dist/cli/commands/item.js.map +1 -0
  62. package/dist/cli/commands/link.d.ts +6 -0
  63. package/dist/cli/commands/link.d.ts.map +1 -0
  64. package/dist/cli/commands/link.js +288 -0
  65. package/dist/cli/commands/link.js.map +1 -0
  66. package/dist/cli/commands/log.d.ts +16 -0
  67. package/dist/cli/commands/log.d.ts.map +1 -0
  68. package/dist/cli/commands/log.js +291 -0
  69. package/dist/cli/commands/log.js.map +1 -0
  70. package/dist/cli/commands/meta.d.ts +15 -0
  71. package/dist/cli/commands/meta.d.ts.map +1 -0
  72. package/dist/cli/commands/meta.js +1378 -0
  73. package/dist/cli/commands/meta.js.map +1 -0
  74. package/dist/cli/commands/module.d.ts +6 -0
  75. package/dist/cli/commands/module.d.ts.map +1 -0
  76. package/dist/cli/commands/module.js +102 -0
  77. package/dist/cli/commands/module.js.map +1 -0
  78. package/dist/cli/commands/ralph.d.ts +9 -0
  79. package/dist/cli/commands/ralph.d.ts.map +1 -0
  80. package/dist/cli/commands/ralph.js +465 -0
  81. package/dist/cli/commands/ralph.js.map +1 -0
  82. package/dist/cli/commands/search.d.ts +6 -0
  83. package/dist/cli/commands/search.d.ts.map +1 -0
  84. package/dist/cli/commands/search.js +134 -0
  85. package/dist/cli/commands/search.js.map +1 -0
  86. package/dist/cli/commands/session.d.ts +164 -0
  87. package/dist/cli/commands/session.d.ts.map +1 -0
  88. package/dist/cli/commands/session.js +745 -0
  89. package/dist/cli/commands/session.js.map +1 -0
  90. package/dist/cli/commands/setup.d.ts +26 -0
  91. package/dist/cli/commands/setup.d.ts.map +1 -0
  92. package/dist/cli/commands/setup.js +586 -0
  93. package/dist/cli/commands/setup.js.map +1 -0
  94. package/dist/cli/commands/shadow.d.ts +6 -0
  95. package/dist/cli/commands/shadow.d.ts.map +1 -0
  96. package/dist/cli/commands/shadow.js +299 -0
  97. package/dist/cli/commands/shadow.js.map +1 -0
  98. package/dist/cli/commands/task.d.ts +6 -0
  99. package/dist/cli/commands/task.d.ts.map +1 -0
  100. package/dist/cli/commands/task.js +1514 -0
  101. package/dist/cli/commands/task.js.map +1 -0
  102. package/dist/cli/commands/tasks.d.ts +6 -0
  103. package/dist/cli/commands/tasks.d.ts.map +1 -0
  104. package/dist/cli/commands/tasks.js +347 -0
  105. package/dist/cli/commands/tasks.js.map +1 -0
  106. package/dist/cli/commands/trait.d.ts +10 -0
  107. package/dist/cli/commands/trait.d.ts.map +1 -0
  108. package/dist/cli/commands/trait.js +295 -0
  109. package/dist/cli/commands/trait.js.map +1 -0
  110. package/dist/cli/commands/validate.d.ts +6 -0
  111. package/dist/cli/commands/validate.d.ts.map +1 -0
  112. package/dist/cli/commands/validate.js +626 -0
  113. package/dist/cli/commands/validate.js.map +1 -0
  114. package/dist/cli/exit-codes.d.ts +62 -0
  115. package/dist/cli/exit-codes.d.ts.map +1 -0
  116. package/dist/cli/exit-codes.js +65 -0
  117. package/dist/cli/exit-codes.js.map +1 -0
  118. package/dist/cli/help/content.d.ts +35 -0
  119. package/dist/cli/help/content.d.ts.map +1 -0
  120. package/dist/cli/help/content.js +312 -0
  121. package/dist/cli/help/content.js.map +1 -0
  122. package/dist/cli/index.d.ts +5 -0
  123. package/dist/cli/index.d.ts.map +1 -0
  124. package/dist/cli/index.js +85 -0
  125. package/dist/cli/index.js.map +1 -0
  126. package/dist/cli/introspection.d.ts +87 -0
  127. package/dist/cli/introspection.d.ts.map +1 -0
  128. package/dist/cli/introspection.js +127 -0
  129. package/dist/cli/introspection.js.map +1 -0
  130. package/dist/cli/output.d.ts +56 -0
  131. package/dist/cli/output.d.ts.map +1 -0
  132. package/dist/cli/output.js +467 -0
  133. package/dist/cli/output.js.map +1 -0
  134. package/dist/cli/suggest.d.ts +16 -0
  135. package/dist/cli/suggest.d.ts.map +1 -0
  136. package/dist/cli/suggest.js +72 -0
  137. package/dist/cli/suggest.js.map +1 -0
  138. package/dist/index.d.ts +3 -0
  139. package/dist/index.d.ts.map +1 -0
  140. package/dist/index.js +5 -0
  141. package/dist/index.js.map +1 -0
  142. package/dist/parser/alignment.d.ts +113 -0
  143. package/dist/parser/alignment.d.ts.map +1 -0
  144. package/dist/parser/alignment.js +261 -0
  145. package/dist/parser/alignment.js.map +1 -0
  146. package/dist/parser/assess.d.ts +81 -0
  147. package/dist/parser/assess.d.ts.map +1 -0
  148. package/dist/parser/assess.js +197 -0
  149. package/dist/parser/assess.js.map +1 -0
  150. package/dist/parser/convention-validation.d.ts +48 -0
  151. package/dist/parser/convention-validation.d.ts.map +1 -0
  152. package/dist/parser/convention-validation.js +167 -0
  153. package/dist/parser/convention-validation.js.map +1 -0
  154. package/dist/parser/fix.d.ts +38 -0
  155. package/dist/parser/fix.d.ts.map +1 -0
  156. package/dist/parser/fix.js +185 -0
  157. package/dist/parser/fix.js.map +1 -0
  158. package/dist/parser/index.d.ts +12 -0
  159. package/dist/parser/index.d.ts.map +1 -0
  160. package/dist/parser/index.js +13 -0
  161. package/dist/parser/index.js.map +1 -0
  162. package/dist/parser/items.d.ts +138 -0
  163. package/dist/parser/items.d.ts.map +1 -0
  164. package/dist/parser/items.js +321 -0
  165. package/dist/parser/items.js.map +1 -0
  166. package/dist/parser/meta.d.ts +120 -0
  167. package/dist/parser/meta.d.ts.map +1 -0
  168. package/dist/parser/meta.js +441 -0
  169. package/dist/parser/meta.js.map +1 -0
  170. package/dist/parser/refs.d.ts +185 -0
  171. package/dist/parser/refs.d.ts.map +1 -0
  172. package/dist/parser/refs.js +404 -0
  173. package/dist/parser/refs.js.map +1 -0
  174. package/dist/parser/shadow.d.ts +253 -0
  175. package/dist/parser/shadow.d.ts.map +1 -0
  176. package/dist/parser/shadow.js +1053 -0
  177. package/dist/parser/shadow.js.map +1 -0
  178. package/dist/parser/traits.d.ts +72 -0
  179. package/dist/parser/traits.d.ts.map +1 -0
  180. package/dist/parser/traits.js +120 -0
  181. package/dist/parser/traits.js.map +1 -0
  182. package/dist/parser/validate.d.ts +89 -0
  183. package/dist/parser/validate.d.ts.map +1 -0
  184. package/dist/parser/validate.js +817 -0
  185. package/dist/parser/validate.js.map +1 -0
  186. package/dist/parser/yaml.d.ts +326 -0
  187. package/dist/parser/yaml.d.ts.map +1 -0
  188. package/dist/parser/yaml.js +1383 -0
  189. package/dist/parser/yaml.js.map +1 -0
  190. package/dist/ralph/cli-renderer.d.ts +20 -0
  191. package/dist/ralph/cli-renderer.d.ts.map +1 -0
  192. package/dist/ralph/cli-renderer.js +179 -0
  193. package/dist/ralph/cli-renderer.js.map +1 -0
  194. package/dist/ralph/events.d.ts +65 -0
  195. package/dist/ralph/events.d.ts.map +1 -0
  196. package/dist/ralph/events.js +397 -0
  197. package/dist/ralph/events.js.map +1 -0
  198. package/dist/ralph/index.d.ts +8 -0
  199. package/dist/ralph/index.d.ts.map +1 -0
  200. package/dist/ralph/index.js +10 -0
  201. package/dist/ralph/index.js.map +1 -0
  202. package/dist/schema/common.d.ts +46 -0
  203. package/dist/schema/common.d.ts.map +1 -0
  204. package/dist/schema/common.js +71 -0
  205. package/dist/schema/common.js.map +1 -0
  206. package/dist/schema/inbox.d.ts +90 -0
  207. package/dist/schema/inbox.d.ts.map +1 -0
  208. package/dist/schema/inbox.js +30 -0
  209. package/dist/schema/inbox.js.map +1 -0
  210. package/dist/schema/index.d.ts +6 -0
  211. package/dist/schema/index.d.ts.map +1 -0
  212. package/dist/schema/index.js +7 -0
  213. package/dist/schema/index.js.map +1 -0
  214. package/dist/schema/meta.d.ts +762 -0
  215. package/dist/schema/meta.d.ts.map +1 -0
  216. package/dist/schema/meta.js +144 -0
  217. package/dist/schema/meta.js.map +1 -0
  218. package/dist/schema/spec.d.ts +912 -0
  219. package/dist/schema/spec.d.ts.map +1 -0
  220. package/dist/schema/spec.js +104 -0
  221. package/dist/schema/spec.js.map +1 -0
  222. package/dist/schema/task.d.ts +664 -0
  223. package/dist/schema/task.d.ts.map +1 -0
  224. package/dist/schema/task.js +130 -0
  225. package/dist/schema/task.js.map +1 -0
  226. package/dist/sessions/index.d.ts +11 -0
  227. package/dist/sessions/index.d.ts.map +1 -0
  228. package/dist/sessions/index.js +13 -0
  229. package/dist/sessions/index.js.map +1 -0
  230. package/dist/sessions/store.d.ts +144 -0
  231. package/dist/sessions/store.d.ts.map +1 -0
  232. package/dist/sessions/store.js +325 -0
  233. package/dist/sessions/store.js.map +1 -0
  234. package/dist/sessions/types.d.ts +157 -0
  235. package/dist/sessions/types.d.ts.map +1 -0
  236. package/dist/sessions/types.js +90 -0
  237. package/dist/sessions/types.js.map +1 -0
  238. package/dist/strings/errors.d.ts +420 -0
  239. package/dist/strings/errors.d.ts.map +1 -0
  240. package/dist/strings/errors.js +282 -0
  241. package/dist/strings/errors.js.map +1 -0
  242. package/dist/strings/guidance.d.ts +65 -0
  243. package/dist/strings/guidance.d.ts.map +1 -0
  244. package/dist/strings/guidance.js +66 -0
  245. package/dist/strings/guidance.js.map +1 -0
  246. package/dist/strings/index.d.ts +12 -0
  247. package/dist/strings/index.d.ts.map +1 -0
  248. package/dist/strings/index.js +12 -0
  249. package/dist/strings/index.js.map +1 -0
  250. package/dist/strings/labels.d.ts +74 -0
  251. package/dist/strings/labels.d.ts.map +1 -0
  252. package/dist/strings/labels.js +75 -0
  253. package/dist/strings/labels.js.map +1 -0
  254. package/dist/strings/validation.d.ts +126 -0
  255. package/dist/strings/validation.d.ts.map +1 -0
  256. package/dist/strings/validation.js +135 -0
  257. package/dist/strings/validation.js.map +1 -0
  258. package/dist/utils/commit.d.ts +23 -0
  259. package/dist/utils/commit.d.ts.map +1 -0
  260. package/dist/utils/commit.js +67 -0
  261. package/dist/utils/commit.js.map +1 -0
  262. package/dist/utils/git.d.ts +57 -0
  263. package/dist/utils/git.d.ts.map +1 -0
  264. package/dist/utils/git.js +192 -0
  265. package/dist/utils/git.js.map +1 -0
  266. package/dist/utils/grep.d.ts +28 -0
  267. package/dist/utils/grep.d.ts.map +1 -0
  268. package/dist/utils/grep.js +86 -0
  269. package/dist/utils/grep.js.map +1 -0
  270. package/dist/utils/index.d.ts +8 -0
  271. package/dist/utils/index.d.ts.map +1 -0
  272. package/dist/utils/index.js +6 -0
  273. package/dist/utils/index.js.map +1 -0
  274. package/dist/utils/time.d.ts +18 -0
  275. package/dist/utils/time.d.ts.map +1 -0
  276. package/dist/utils/time.js +61 -0
  277. package/dist/utils/time.js.map +1 -0
  278. package/package.json +62 -0
@@ -0,0 +1,762 @@
1
+ import { z } from 'zod';
2
+ /**
3
+ * Agent session protocol - commands to run at session lifecycle events
4
+ */
5
+ export declare const SessionProtocolSchema: z.ZodObject<{
6
+ start: z.ZodOptional<z.ZodNullable<z.ZodString>>;
7
+ checkpoint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
8
+ end: z.ZodOptional<z.ZodNullable<z.ZodString>>;
9
+ }, "strip", z.ZodTypeAny, {
10
+ start?: string | null | undefined;
11
+ checkpoint?: string | null | undefined;
12
+ end?: string | null | undefined;
13
+ }, {
14
+ start?: string | null | undefined;
15
+ checkpoint?: string | null | undefined;
16
+ end?: string | null | undefined;
17
+ }>;
18
+ /**
19
+ * Agent definition - describes an agent's role and capabilities
20
+ */
21
+ export declare const AgentSchema: z.ZodObject<{
22
+ _ulid: z.ZodString;
23
+ id: z.ZodString;
24
+ name: z.ZodString;
25
+ description: z.ZodOptional<z.ZodString>;
26
+ capabilities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
27
+ tools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
28
+ session_protocol: z.ZodOptional<z.ZodObject<{
29
+ start: z.ZodOptional<z.ZodNullable<z.ZodString>>;
30
+ checkpoint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
31
+ end: z.ZodOptional<z.ZodNullable<z.ZodString>>;
32
+ }, "strip", z.ZodTypeAny, {
33
+ start?: string | null | undefined;
34
+ checkpoint?: string | null | undefined;
35
+ end?: string | null | undefined;
36
+ }, {
37
+ start?: string | null | undefined;
38
+ checkpoint?: string | null | undefined;
39
+ end?: string | null | undefined;
40
+ }>>;
41
+ conventions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
42
+ }, "strip", z.ZodTypeAny, {
43
+ _ulid: string;
44
+ id: string;
45
+ name: string;
46
+ capabilities: string[];
47
+ tools: string[];
48
+ conventions: string[];
49
+ description?: string | undefined;
50
+ session_protocol?: {
51
+ start?: string | null | undefined;
52
+ checkpoint?: string | null | undefined;
53
+ end?: string | null | undefined;
54
+ } | undefined;
55
+ }, {
56
+ _ulid: string;
57
+ id: string;
58
+ name: string;
59
+ description?: string | undefined;
60
+ capabilities?: string[] | undefined;
61
+ tools?: string[] | undefined;
62
+ session_protocol?: {
63
+ start?: string | null | undefined;
64
+ checkpoint?: string | null | undefined;
65
+ end?: string | null | undefined;
66
+ } | undefined;
67
+ conventions?: string[] | undefined;
68
+ }>;
69
+ /**
70
+ * Workflow step types
71
+ */
72
+ export declare const WorkflowStepTypeSchema: z.ZodEnum<["check", "action", "decision"]>;
73
+ /**
74
+ * Workflow step execution hints
75
+ */
76
+ export declare const StepExecutionSchema: z.ZodObject<{
77
+ mode: z.ZodDefault<z.ZodEnum<["prompt", "silent", "skip"]>>;
78
+ timeout: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
79
+ }, "strip", z.ZodTypeAny, {
80
+ mode: "prompt" | "silent" | "skip";
81
+ timeout?: number | null | undefined;
82
+ }, {
83
+ mode?: "prompt" | "silent" | "skip" | undefined;
84
+ timeout?: number | null | undefined;
85
+ }>;
86
+ /**
87
+ * Workflow step - a single step in a workflow
88
+ */
89
+ export declare const WorkflowStepSchema: z.ZodObject<{
90
+ type: z.ZodEnum<["check", "action", "decision"]>;
91
+ content: z.ZodString;
92
+ on_fail: z.ZodOptional<z.ZodString>;
93
+ options: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
94
+ execution: z.ZodOptional<z.ZodObject<{
95
+ mode: z.ZodDefault<z.ZodEnum<["prompt", "silent", "skip"]>>;
96
+ timeout: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
97
+ }, "strip", z.ZodTypeAny, {
98
+ mode: "prompt" | "silent" | "skip";
99
+ timeout?: number | null | undefined;
100
+ }, {
101
+ mode?: "prompt" | "silent" | "skip" | undefined;
102
+ timeout?: number | null | undefined;
103
+ }>>;
104
+ }, "strip", z.ZodTypeAny, {
105
+ type: "decision" | "check" | "action";
106
+ content: string;
107
+ options?: string[] | undefined;
108
+ on_fail?: string | undefined;
109
+ execution?: {
110
+ mode: "prompt" | "silent" | "skip";
111
+ timeout?: number | null | undefined;
112
+ } | undefined;
113
+ }, {
114
+ type: "decision" | "check" | "action";
115
+ content: string;
116
+ options?: string[] | undefined;
117
+ on_fail?: string | undefined;
118
+ execution?: {
119
+ mode?: "prompt" | "silent" | "skip" | undefined;
120
+ timeout?: number | null | undefined;
121
+ } | undefined;
122
+ }>;
123
+ /**
124
+ * Workflow definition - structured process definition
125
+ */
126
+ export declare const WorkflowSchema: z.ZodObject<{
127
+ _ulid: z.ZodString;
128
+ id: z.ZodString;
129
+ trigger: z.ZodString;
130
+ description: z.ZodOptional<z.ZodString>;
131
+ steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
132
+ type: z.ZodEnum<["check", "action", "decision"]>;
133
+ content: z.ZodString;
134
+ on_fail: z.ZodOptional<z.ZodString>;
135
+ options: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
136
+ execution: z.ZodOptional<z.ZodObject<{
137
+ mode: z.ZodDefault<z.ZodEnum<["prompt", "silent", "skip"]>>;
138
+ timeout: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
139
+ }, "strip", z.ZodTypeAny, {
140
+ mode: "prompt" | "silent" | "skip";
141
+ timeout?: number | null | undefined;
142
+ }, {
143
+ mode?: "prompt" | "silent" | "skip" | undefined;
144
+ timeout?: number | null | undefined;
145
+ }>>;
146
+ }, "strip", z.ZodTypeAny, {
147
+ type: "decision" | "check" | "action";
148
+ content: string;
149
+ options?: string[] | undefined;
150
+ on_fail?: string | undefined;
151
+ execution?: {
152
+ mode: "prompt" | "silent" | "skip";
153
+ timeout?: number | null | undefined;
154
+ } | undefined;
155
+ }, {
156
+ type: "decision" | "check" | "action";
157
+ content: string;
158
+ options?: string[] | undefined;
159
+ on_fail?: string | undefined;
160
+ execution?: {
161
+ mode?: "prompt" | "silent" | "skip" | undefined;
162
+ timeout?: number | null | undefined;
163
+ } | undefined;
164
+ }>, "many">>;
165
+ }, "strip", z.ZodTypeAny, {
166
+ _ulid: string;
167
+ id: string;
168
+ trigger: string;
169
+ steps: {
170
+ type: "decision" | "check" | "action";
171
+ content: string;
172
+ options?: string[] | undefined;
173
+ on_fail?: string | undefined;
174
+ execution?: {
175
+ mode: "prompt" | "silent" | "skip";
176
+ timeout?: number | null | undefined;
177
+ } | undefined;
178
+ }[];
179
+ description?: string | undefined;
180
+ }, {
181
+ _ulid: string;
182
+ id: string;
183
+ trigger: string;
184
+ description?: string | undefined;
185
+ steps?: {
186
+ type: "decision" | "check" | "action";
187
+ content: string;
188
+ options?: string[] | undefined;
189
+ on_fail?: string | undefined;
190
+ execution?: {
191
+ mode?: "prompt" | "silent" | "skip" | undefined;
192
+ timeout?: number | null | undefined;
193
+ } | undefined;
194
+ }[] | undefined;
195
+ }>;
196
+ /**
197
+ * Convention example (good/bad)
198
+ */
199
+ export declare const ConventionExampleSchema: z.ZodObject<{
200
+ good: z.ZodString;
201
+ bad: z.ZodString;
202
+ }, "strip", z.ZodTypeAny, {
203
+ good: string;
204
+ bad: string;
205
+ }, {
206
+ good: string;
207
+ bad: string;
208
+ }>;
209
+ /**
210
+ * Convention validation configuration
211
+ */
212
+ export declare const ConventionValidationSchema: z.ZodObject<{
213
+ type: z.ZodEnum<["regex", "enum", "range", "prose"]>;
214
+ pattern: z.ZodOptional<z.ZodString>;
215
+ message: z.ZodOptional<z.ZodString>;
216
+ allowed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
217
+ min: z.ZodOptional<z.ZodNumber>;
218
+ max: z.ZodOptional<z.ZodNumber>;
219
+ unit: z.ZodOptional<z.ZodEnum<["words", "chars", "lines"]>>;
220
+ }, "strip", z.ZodTypeAny, {
221
+ type: "regex" | "enum" | "range" | "prose";
222
+ message?: string | undefined;
223
+ pattern?: string | undefined;
224
+ allowed?: string[] | undefined;
225
+ min?: number | undefined;
226
+ max?: number | undefined;
227
+ unit?: "lines" | "words" | "chars" | undefined;
228
+ }, {
229
+ type: "regex" | "enum" | "range" | "prose";
230
+ message?: string | undefined;
231
+ pattern?: string | undefined;
232
+ allowed?: string[] | undefined;
233
+ min?: number | undefined;
234
+ max?: number | undefined;
235
+ unit?: "lines" | "words" | "chars" | undefined;
236
+ }>;
237
+ /**
238
+ * Convention definition - project-specific rules and standards
239
+ */
240
+ export declare const ConventionSchema: z.ZodObject<{
241
+ _ulid: z.ZodString;
242
+ domain: z.ZodString;
243
+ rules: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
244
+ examples: z.ZodDefault<z.ZodArray<z.ZodObject<{
245
+ good: z.ZodString;
246
+ bad: z.ZodString;
247
+ }, "strip", z.ZodTypeAny, {
248
+ good: string;
249
+ bad: string;
250
+ }, {
251
+ good: string;
252
+ bad: string;
253
+ }>, "many">>;
254
+ validation: z.ZodOptional<z.ZodObject<{
255
+ type: z.ZodEnum<["regex", "enum", "range", "prose"]>;
256
+ pattern: z.ZodOptional<z.ZodString>;
257
+ message: z.ZodOptional<z.ZodString>;
258
+ allowed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
259
+ min: z.ZodOptional<z.ZodNumber>;
260
+ max: z.ZodOptional<z.ZodNumber>;
261
+ unit: z.ZodOptional<z.ZodEnum<["words", "chars", "lines"]>>;
262
+ }, "strip", z.ZodTypeAny, {
263
+ type: "regex" | "enum" | "range" | "prose";
264
+ message?: string | undefined;
265
+ pattern?: string | undefined;
266
+ allowed?: string[] | undefined;
267
+ min?: number | undefined;
268
+ max?: number | undefined;
269
+ unit?: "lines" | "words" | "chars" | undefined;
270
+ }, {
271
+ type: "regex" | "enum" | "range" | "prose";
272
+ message?: string | undefined;
273
+ pattern?: string | undefined;
274
+ allowed?: string[] | undefined;
275
+ min?: number | undefined;
276
+ max?: number | undefined;
277
+ unit?: "lines" | "words" | "chars" | undefined;
278
+ }>>;
279
+ }, "strip", z.ZodTypeAny, {
280
+ _ulid: string;
281
+ domain: string;
282
+ rules: string[];
283
+ examples: {
284
+ good: string;
285
+ bad: string;
286
+ }[];
287
+ validation?: {
288
+ type: "regex" | "enum" | "range" | "prose";
289
+ message?: string | undefined;
290
+ pattern?: string | undefined;
291
+ allowed?: string[] | undefined;
292
+ min?: number | undefined;
293
+ max?: number | undefined;
294
+ unit?: "lines" | "words" | "chars" | undefined;
295
+ } | undefined;
296
+ }, {
297
+ _ulid: string;
298
+ domain: string;
299
+ validation?: {
300
+ type: "regex" | "enum" | "range" | "prose";
301
+ message?: string | undefined;
302
+ pattern?: string | undefined;
303
+ allowed?: string[] | undefined;
304
+ min?: number | undefined;
305
+ max?: number | undefined;
306
+ unit?: "lines" | "words" | "chars" | undefined;
307
+ } | undefined;
308
+ rules?: string[] | undefined;
309
+ examples?: {
310
+ good: string;
311
+ bad: string;
312
+ }[] | undefined;
313
+ }>;
314
+ /**
315
+ * Observation types
316
+ */
317
+ export declare const ObservationTypeSchema: z.ZodEnum<["friction", "success", "question", "idea"]>;
318
+ /**
319
+ * Observation - feedback about workflows and conventions
320
+ */
321
+ export declare const ObservationSchema: z.ZodObject<{
322
+ _ulid: z.ZodString;
323
+ type: z.ZodEnum<["friction", "success", "question", "idea"]>;
324
+ workflow_ref: z.ZodOptional<z.ZodString>;
325
+ content: z.ZodString;
326
+ created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
327
+ author: z.ZodOptional<z.ZodString>;
328
+ resolved: z.ZodDefault<z.ZodBoolean>;
329
+ resolution: z.ZodOptional<z.ZodNullable<z.ZodString>>;
330
+ resolved_at: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString]>>;
331
+ resolved_by: z.ZodOptional<z.ZodString>;
332
+ promoted_to: z.ZodOptional<z.ZodString>;
333
+ }, "strip", z.ZodTypeAny, {
334
+ type: "friction" | "success" | "question" | "idea";
335
+ _ulid: string;
336
+ created_at: string;
337
+ content: string;
338
+ resolved: boolean;
339
+ author?: string | undefined;
340
+ promoted_to?: string | undefined;
341
+ workflow_ref?: string | undefined;
342
+ resolution?: string | null | undefined;
343
+ resolved_at?: string | undefined;
344
+ resolved_by?: string | undefined;
345
+ }, {
346
+ type: "friction" | "success" | "question" | "idea";
347
+ _ulid: string;
348
+ created_at: string;
349
+ content: string;
350
+ author?: string | undefined;
351
+ promoted_to?: string | undefined;
352
+ workflow_ref?: string | undefined;
353
+ resolved?: boolean | undefined;
354
+ resolution?: string | null | undefined;
355
+ resolved_at?: string | undefined;
356
+ resolved_by?: string | undefined;
357
+ }>;
358
+ /**
359
+ * Session context schema - ephemeral session state
360
+ */
361
+ export declare const SessionContextSchema: z.ZodObject<{
362
+ focus: z.ZodNullable<z.ZodString>;
363
+ threads: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
364
+ open_questions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
365
+ updated_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
366
+ }, "strip", z.ZodTypeAny, {
367
+ focus: string | null;
368
+ threads: string[];
369
+ open_questions: string[];
370
+ updated_at: string;
371
+ }, {
372
+ focus: string | null;
373
+ updated_at: string;
374
+ threads?: string[] | undefined;
375
+ open_questions?: string[] | undefined;
376
+ }>;
377
+ /**
378
+ * Meta manifest schema - the root structure for kynetic.meta.yaml
379
+ */
380
+ export declare const MetaManifestSchema: z.ZodObject<{
381
+ kynetic_meta: z.ZodDefault<z.ZodString>;
382
+ agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
383
+ _ulid: z.ZodString;
384
+ id: z.ZodString;
385
+ name: z.ZodString;
386
+ description: z.ZodOptional<z.ZodString>;
387
+ capabilities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
388
+ tools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
389
+ session_protocol: z.ZodOptional<z.ZodObject<{
390
+ start: z.ZodOptional<z.ZodNullable<z.ZodString>>;
391
+ checkpoint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
392
+ end: z.ZodOptional<z.ZodNullable<z.ZodString>>;
393
+ }, "strip", z.ZodTypeAny, {
394
+ start?: string | null | undefined;
395
+ checkpoint?: string | null | undefined;
396
+ end?: string | null | undefined;
397
+ }, {
398
+ start?: string | null | undefined;
399
+ checkpoint?: string | null | undefined;
400
+ end?: string | null | undefined;
401
+ }>>;
402
+ conventions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
403
+ }, "strip", z.ZodTypeAny, {
404
+ _ulid: string;
405
+ id: string;
406
+ name: string;
407
+ capabilities: string[];
408
+ tools: string[];
409
+ conventions: string[];
410
+ description?: string | undefined;
411
+ session_protocol?: {
412
+ start?: string | null | undefined;
413
+ checkpoint?: string | null | undefined;
414
+ end?: string | null | undefined;
415
+ } | undefined;
416
+ }, {
417
+ _ulid: string;
418
+ id: string;
419
+ name: string;
420
+ description?: string | undefined;
421
+ capabilities?: string[] | undefined;
422
+ tools?: string[] | undefined;
423
+ session_protocol?: {
424
+ start?: string | null | undefined;
425
+ checkpoint?: string | null | undefined;
426
+ end?: string | null | undefined;
427
+ } | undefined;
428
+ conventions?: string[] | undefined;
429
+ }>, "many">>;
430
+ workflows: z.ZodDefault<z.ZodArray<z.ZodObject<{
431
+ _ulid: z.ZodString;
432
+ id: z.ZodString;
433
+ trigger: z.ZodString;
434
+ description: z.ZodOptional<z.ZodString>;
435
+ steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
436
+ type: z.ZodEnum<["check", "action", "decision"]>;
437
+ content: z.ZodString;
438
+ on_fail: z.ZodOptional<z.ZodString>;
439
+ options: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
440
+ execution: z.ZodOptional<z.ZodObject<{
441
+ mode: z.ZodDefault<z.ZodEnum<["prompt", "silent", "skip"]>>;
442
+ timeout: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
443
+ }, "strip", z.ZodTypeAny, {
444
+ mode: "prompt" | "silent" | "skip";
445
+ timeout?: number | null | undefined;
446
+ }, {
447
+ mode?: "prompt" | "silent" | "skip" | undefined;
448
+ timeout?: number | null | undefined;
449
+ }>>;
450
+ }, "strip", z.ZodTypeAny, {
451
+ type: "decision" | "check" | "action";
452
+ content: string;
453
+ options?: string[] | undefined;
454
+ on_fail?: string | undefined;
455
+ execution?: {
456
+ mode: "prompt" | "silent" | "skip";
457
+ timeout?: number | null | undefined;
458
+ } | undefined;
459
+ }, {
460
+ type: "decision" | "check" | "action";
461
+ content: string;
462
+ options?: string[] | undefined;
463
+ on_fail?: string | undefined;
464
+ execution?: {
465
+ mode?: "prompt" | "silent" | "skip" | undefined;
466
+ timeout?: number | null | undefined;
467
+ } | undefined;
468
+ }>, "many">>;
469
+ }, "strip", z.ZodTypeAny, {
470
+ _ulid: string;
471
+ id: string;
472
+ trigger: string;
473
+ steps: {
474
+ type: "decision" | "check" | "action";
475
+ content: string;
476
+ options?: string[] | undefined;
477
+ on_fail?: string | undefined;
478
+ execution?: {
479
+ mode: "prompt" | "silent" | "skip";
480
+ timeout?: number | null | undefined;
481
+ } | undefined;
482
+ }[];
483
+ description?: string | undefined;
484
+ }, {
485
+ _ulid: string;
486
+ id: string;
487
+ trigger: string;
488
+ description?: string | undefined;
489
+ steps?: {
490
+ type: "decision" | "check" | "action";
491
+ content: string;
492
+ options?: string[] | undefined;
493
+ on_fail?: string | undefined;
494
+ execution?: {
495
+ mode?: "prompt" | "silent" | "skip" | undefined;
496
+ timeout?: number | null | undefined;
497
+ } | undefined;
498
+ }[] | undefined;
499
+ }>, "many">>;
500
+ conventions: z.ZodDefault<z.ZodArray<z.ZodObject<{
501
+ _ulid: z.ZodString;
502
+ domain: z.ZodString;
503
+ rules: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
504
+ examples: z.ZodDefault<z.ZodArray<z.ZodObject<{
505
+ good: z.ZodString;
506
+ bad: z.ZodString;
507
+ }, "strip", z.ZodTypeAny, {
508
+ good: string;
509
+ bad: string;
510
+ }, {
511
+ good: string;
512
+ bad: string;
513
+ }>, "many">>;
514
+ validation: z.ZodOptional<z.ZodObject<{
515
+ type: z.ZodEnum<["regex", "enum", "range", "prose"]>;
516
+ pattern: z.ZodOptional<z.ZodString>;
517
+ message: z.ZodOptional<z.ZodString>;
518
+ allowed: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
519
+ min: z.ZodOptional<z.ZodNumber>;
520
+ max: z.ZodOptional<z.ZodNumber>;
521
+ unit: z.ZodOptional<z.ZodEnum<["words", "chars", "lines"]>>;
522
+ }, "strip", z.ZodTypeAny, {
523
+ type: "regex" | "enum" | "range" | "prose";
524
+ message?: string | undefined;
525
+ pattern?: string | undefined;
526
+ allowed?: string[] | undefined;
527
+ min?: number | undefined;
528
+ max?: number | undefined;
529
+ unit?: "lines" | "words" | "chars" | undefined;
530
+ }, {
531
+ type: "regex" | "enum" | "range" | "prose";
532
+ message?: string | undefined;
533
+ pattern?: string | undefined;
534
+ allowed?: string[] | undefined;
535
+ min?: number | undefined;
536
+ max?: number | undefined;
537
+ unit?: "lines" | "words" | "chars" | undefined;
538
+ }>>;
539
+ }, "strip", z.ZodTypeAny, {
540
+ _ulid: string;
541
+ domain: string;
542
+ rules: string[];
543
+ examples: {
544
+ good: string;
545
+ bad: string;
546
+ }[];
547
+ validation?: {
548
+ type: "regex" | "enum" | "range" | "prose";
549
+ message?: string | undefined;
550
+ pattern?: string | undefined;
551
+ allowed?: string[] | undefined;
552
+ min?: number | undefined;
553
+ max?: number | undefined;
554
+ unit?: "lines" | "words" | "chars" | undefined;
555
+ } | undefined;
556
+ }, {
557
+ _ulid: string;
558
+ domain: string;
559
+ validation?: {
560
+ type: "regex" | "enum" | "range" | "prose";
561
+ message?: string | undefined;
562
+ pattern?: string | undefined;
563
+ allowed?: string[] | undefined;
564
+ min?: number | undefined;
565
+ max?: number | undefined;
566
+ unit?: "lines" | "words" | "chars" | undefined;
567
+ } | undefined;
568
+ rules?: string[] | undefined;
569
+ examples?: {
570
+ good: string;
571
+ bad: string;
572
+ }[] | undefined;
573
+ }>, "many">>;
574
+ observations: z.ZodDefault<z.ZodArray<z.ZodObject<{
575
+ _ulid: z.ZodString;
576
+ type: z.ZodEnum<["friction", "success", "question", "idea"]>;
577
+ workflow_ref: z.ZodOptional<z.ZodString>;
578
+ content: z.ZodString;
579
+ created_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
580
+ author: z.ZodOptional<z.ZodString>;
581
+ resolved: z.ZodDefault<z.ZodBoolean>;
582
+ resolution: z.ZodOptional<z.ZodNullable<z.ZodString>>;
583
+ resolved_at: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString]>>;
584
+ resolved_by: z.ZodOptional<z.ZodString>;
585
+ promoted_to: z.ZodOptional<z.ZodString>;
586
+ }, "strip", z.ZodTypeAny, {
587
+ type: "friction" | "success" | "question" | "idea";
588
+ _ulid: string;
589
+ created_at: string;
590
+ content: string;
591
+ resolved: boolean;
592
+ author?: string | undefined;
593
+ promoted_to?: string | undefined;
594
+ workflow_ref?: string | undefined;
595
+ resolution?: string | null | undefined;
596
+ resolved_at?: string | undefined;
597
+ resolved_by?: string | undefined;
598
+ }, {
599
+ type: "friction" | "success" | "question" | "idea";
600
+ _ulid: string;
601
+ created_at: string;
602
+ content: string;
603
+ author?: string | undefined;
604
+ promoted_to?: string | undefined;
605
+ workflow_ref?: string | undefined;
606
+ resolved?: boolean | undefined;
607
+ resolution?: string | null | undefined;
608
+ resolved_at?: string | undefined;
609
+ resolved_by?: string | undefined;
610
+ }>, "many">>;
611
+ includes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
612
+ }, "strip", z.ZodTypeAny, {
613
+ includes: string[];
614
+ conventions: {
615
+ _ulid: string;
616
+ domain: string;
617
+ rules: string[];
618
+ examples: {
619
+ good: string;
620
+ bad: string;
621
+ }[];
622
+ validation?: {
623
+ type: "regex" | "enum" | "range" | "prose";
624
+ message?: string | undefined;
625
+ pattern?: string | undefined;
626
+ allowed?: string[] | undefined;
627
+ min?: number | undefined;
628
+ max?: number | undefined;
629
+ unit?: "lines" | "words" | "chars" | undefined;
630
+ } | undefined;
631
+ }[];
632
+ kynetic_meta: string;
633
+ agents: {
634
+ _ulid: string;
635
+ id: string;
636
+ name: string;
637
+ capabilities: string[];
638
+ tools: string[];
639
+ conventions: string[];
640
+ description?: string | undefined;
641
+ session_protocol?: {
642
+ start?: string | null | undefined;
643
+ checkpoint?: string | null | undefined;
644
+ end?: string | null | undefined;
645
+ } | undefined;
646
+ }[];
647
+ workflows: {
648
+ _ulid: string;
649
+ id: string;
650
+ trigger: string;
651
+ steps: {
652
+ type: "decision" | "check" | "action";
653
+ content: string;
654
+ options?: string[] | undefined;
655
+ on_fail?: string | undefined;
656
+ execution?: {
657
+ mode: "prompt" | "silent" | "skip";
658
+ timeout?: number | null | undefined;
659
+ } | undefined;
660
+ }[];
661
+ description?: string | undefined;
662
+ }[];
663
+ observations: {
664
+ type: "friction" | "success" | "question" | "idea";
665
+ _ulid: string;
666
+ created_at: string;
667
+ content: string;
668
+ resolved: boolean;
669
+ author?: string | undefined;
670
+ promoted_to?: string | undefined;
671
+ workflow_ref?: string | undefined;
672
+ resolution?: string | null | undefined;
673
+ resolved_at?: string | undefined;
674
+ resolved_by?: string | undefined;
675
+ }[];
676
+ }, {
677
+ includes?: string[] | undefined;
678
+ conventions?: {
679
+ _ulid: string;
680
+ domain: string;
681
+ validation?: {
682
+ type: "regex" | "enum" | "range" | "prose";
683
+ message?: string | undefined;
684
+ pattern?: string | undefined;
685
+ allowed?: string[] | undefined;
686
+ min?: number | undefined;
687
+ max?: number | undefined;
688
+ unit?: "lines" | "words" | "chars" | undefined;
689
+ } | undefined;
690
+ rules?: string[] | undefined;
691
+ examples?: {
692
+ good: string;
693
+ bad: string;
694
+ }[] | undefined;
695
+ }[] | undefined;
696
+ kynetic_meta?: string | undefined;
697
+ agents?: {
698
+ _ulid: string;
699
+ id: string;
700
+ name: string;
701
+ description?: string | undefined;
702
+ capabilities?: string[] | undefined;
703
+ tools?: string[] | undefined;
704
+ session_protocol?: {
705
+ start?: string | null | undefined;
706
+ checkpoint?: string | null | undefined;
707
+ end?: string | null | undefined;
708
+ } | undefined;
709
+ conventions?: string[] | undefined;
710
+ }[] | undefined;
711
+ workflows?: {
712
+ _ulid: string;
713
+ id: string;
714
+ trigger: string;
715
+ description?: string | undefined;
716
+ steps?: {
717
+ type: "decision" | "check" | "action";
718
+ content: string;
719
+ options?: string[] | undefined;
720
+ on_fail?: string | undefined;
721
+ execution?: {
722
+ mode?: "prompt" | "silent" | "skip" | undefined;
723
+ timeout?: number | null | undefined;
724
+ } | undefined;
725
+ }[] | undefined;
726
+ }[] | undefined;
727
+ observations?: {
728
+ type: "friction" | "success" | "question" | "idea";
729
+ _ulid: string;
730
+ created_at: string;
731
+ content: string;
732
+ author?: string | undefined;
733
+ promoted_to?: string | undefined;
734
+ workflow_ref?: string | undefined;
735
+ resolved?: boolean | undefined;
736
+ resolution?: string | null | undefined;
737
+ resolved_at?: string | undefined;
738
+ resolved_by?: string | undefined;
739
+ }[] | undefined;
740
+ }>;
741
+ export type SessionProtocol = z.infer<typeof SessionProtocolSchema>;
742
+ export type Agent = z.infer<typeof AgentSchema>;
743
+ export type WorkflowStepType = z.infer<typeof WorkflowStepTypeSchema>;
744
+ export type StepExecution = z.infer<typeof StepExecutionSchema>;
745
+ export type WorkflowStep = z.infer<typeof WorkflowStepSchema>;
746
+ export type Workflow = z.infer<typeof WorkflowSchema>;
747
+ export type ConventionExample = z.infer<typeof ConventionExampleSchema>;
748
+ export type ConventionValidation = z.infer<typeof ConventionValidationSchema>;
749
+ export type Convention = z.infer<typeof ConventionSchema>;
750
+ export type ObservationType = z.infer<typeof ObservationTypeSchema>;
751
+ export type Observation = z.infer<typeof ObservationSchema>;
752
+ export type SessionContext = z.infer<typeof SessionContextSchema>;
753
+ export type MetaManifest = z.infer<typeof MetaManifestSchema>;
754
+ /**
755
+ * Meta item type - union of all meta item types
756
+ */
757
+ export type MetaItem = Agent | Workflow | Convention | Observation;
758
+ /**
759
+ * Determine the type of a meta item
760
+ */
761
+ export declare function getMetaItemType(item: MetaItem): 'agent' | 'workflow' | 'convention' | 'observation';
762
+ //# sourceMappingURL=meta.d.ts.map