@roilab/crm-cli 0.1.0 → 0.6.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 (69) hide show
  1. package/CHANGELOG.md +195 -25
  2. package/SKILL.md +256 -7
  3. package/SURFACE.txt +237 -69
  4. package/dist/bin/crm.js +28 -2
  5. package/dist/bin/crm.js.map +1 -1
  6. package/dist/src/commands/access.js +104 -0
  7. package/dist/src/commands/access.js.map +1 -0
  8. package/dist/src/commands/brief.js +52 -0
  9. package/dist/src/commands/brief.js.map +1 -0
  10. package/dist/src/commands/chat.js +220 -0
  11. package/dist/src/commands/chat.js.map +1 -0
  12. package/dist/src/commands/commands.js +89 -0
  13. package/dist/src/commands/commands.js.map +1 -0
  14. package/dist/src/commands/comment.js +1 -0
  15. package/dist/src/commands/comment.js.map +1 -1
  16. package/dist/src/commands/generic.js +335 -5
  17. package/dist/src/commands/generic.js.map +1 -1
  18. package/dist/src/commands/integrations.js +236 -0
  19. package/dist/src/commands/integrations.js.map +1 -0
  20. package/dist/src/commands/mention.js +139 -0
  21. package/dist/src/commands/mention.js.map +1 -0
  22. package/dist/src/commands/options.js +21 -1
  23. package/dist/src/commands/options.js.map +1 -1
  24. package/dist/src/commands/rank.js +300 -0
  25. package/dist/src/commands/rank.js.map +1 -0
  26. package/dist/src/commands/report.js +209 -0
  27. package/dist/src/commands/report.js.map +1 -0
  28. package/dist/src/commands/review.js +136 -0
  29. package/dist/src/commands/review.js.map +1 -1
  30. package/dist/src/commands/skill.js +1005 -0
  31. package/dist/src/commands/skill.js.map +1 -0
  32. package/dist/src/commands/task.js +298 -4
  33. package/dist/src/commands/task.js.map +1 -1
  34. package/dist/src/commands/time.js +242 -0
  35. package/dist/src/commands/time.js.map +1 -0
  36. package/dist/src/lib/skillBundles.js +84 -0
  37. package/dist/src/lib/skillBundles.js.map +1 -0
  38. package/dist/src/lib/skillManifest.js +77 -0
  39. package/dist/src/lib/skillManifest.js.map +1 -0
  40. package/dist/src/lib/skillSidecar.js +69 -0
  41. package/dist/src/lib/skillSidecar.js.map +1 -0
  42. package/dist/src/lib/skillWriter.js +162 -0
  43. package/dist/src/lib/skillWriter.js.map +1 -0
  44. package/dist/src/transport/envelope.js +12 -2
  45. package/dist/src/transport/envelope.js.map +1 -1
  46. package/dist/src/transport/http.js +27 -0
  47. package/dist/src/transport/http.js.map +1 -1
  48. package/dist/src/transport/run.js +6 -0
  49. package/dist/src/transport/run.js.map +1 -1
  50. package/dist/src/types.js.map +1 -1
  51. package/dist/src/utils/server-nudge.js +57 -0
  52. package/dist/src/utils/server-nudge.js.map +1 -0
  53. package/dist/src/utils/version-check.js +68 -0
  54. package/dist/src/utils/version-check.js.map +1 -1
  55. package/package.json +58 -57
  56. package/skill-bundles/tools/ahrefs-tool/SKILL.md +134 -0
  57. package/skill-bundles/tools/brightlocal-tool/SKILL.md +154 -0
  58. package/skill-bundles/tools/dataforseo-tool/SKILL.md +118 -0
  59. package/skill-bundles/tools/google-analytics-tool/SKILL.md +143 -0
  60. package/skill-bundles/tools/google-search-console-tool/SKILL.md +133 -0
  61. package/skill-bundles/tools/local-falcon-tool/SKILL.md +142 -0
  62. package/skill-bundles/tools/localseodata-tool/SKILL.md +388 -0
  63. package/skill-bundles/tools/lsa-spy-tool/SKILL.md +113 -0
  64. package/skill-bundles/tools/screaming-frog-tool/SKILL.md +166 -0
  65. package/skill-bundles/tools/semrush-tool/SKILL.md +121 -0
  66. package/skill-bundles/tools/serpapi-tool/SKILL.md +148 -0
  67. package/skill-bundles/tools/task-preflight/SKILL.md +149 -0
  68. package/skill-bundles/tools/tool-routing/SKILL.md +59 -0
  69. package/skill-bundles/tools/whitespark-tool/SKILL.md +129 -0
@@ -0,0 +1,220 @@
1
+ /**
2
+ * `crm chat` — list, read, send, reply, react, dm, mark-read, and resolve chat threads.
3
+ *
4
+ * Threads anchor to workspace/client plus explicit DMs/groups (task discussions
5
+ * live in comments). Use `crm chat thread` to resolve or auto-create the
6
+ * canonical thread for a CRM object, then pipe the id into `crm chat send`.
7
+ * For agents that need to start a 1:1 or group conversation, use `crm chat dm`.
8
+ *
9
+ * TID=$(crm chat thread --client cli_xxx --shared --ids-only)
10
+ * crm chat send "$TID" --body "@[Lucía](mid_yyy) revisado"
11
+ * crm chat react <messageId> --emoji "👍"
12
+ * crm chat dm --user user_zzz --body "ping"
13
+ */
14
+ import { run } from "../transport/run.js";
15
+ import { outputFromFlags, readFlags } from "./options.js";
16
+ export function registerChat(program) {
17
+ const chat = program
18
+ .command("chat")
19
+ .description("Chats — conversaciones ancladas a workspace/cliente/dominio + DMs/grupos");
20
+ chat
21
+ .command("list")
22
+ .description("Lista los chats visibles, opcionalmente filtrados por scope")
23
+ .option("--scope <scope>", "workspace | client | dm")
24
+ .option("--client <id>", "sólo hilos de este cliente")
25
+ .action(async (opts, cmd) => {
26
+ const flags = readFlags(cmd);
27
+ await run({
28
+ method: "GET",
29
+ path: "/chats",
30
+ request: {
31
+ query: {
32
+ scope: opts.scope,
33
+ clientId: opts.client,
34
+ },
35
+ },
36
+ output: outputFromFlags(flags),
37
+ profile: flags.profile,
38
+ });
39
+ });
40
+ chat
41
+ .command("get")
42
+ .description("Devuelve un hilo con metadata (unreadCount, anchor, participants) + los últimos mensajes.")
43
+ .argument("<threadId>", "id del hilo")
44
+ .option("--message-limit <n>", "máximo de mensajes recientes a incluir (default 50, max 200)", (v) => parseInt(v, 10))
45
+ .action(async (threadId, opts, cmd) => {
46
+ const flags = readFlags(cmd);
47
+ await run({
48
+ method: "GET",
49
+ path: `/chats/${encodeURIComponent(threadId)}`,
50
+ request: {
51
+ query: { messageLimit: opts.messageLimit },
52
+ },
53
+ output: outputFromFlags(flags),
54
+ profile: flags.profile,
55
+ });
56
+ });
57
+ chat
58
+ .command("read")
59
+ .description("Devuelve los últimos mensajes de un chat (ascendente por fecha)")
60
+ .argument("<threadId>", "id del hilo")
61
+ .option("--page-limit <n>", "tamaño de página (por defecto 50)", (v) => parseInt(v, 10))
62
+ .option("--before <ms>", "epoch ms — sólo mensajes anteriores", (v) => parseInt(v, 10))
63
+ .action(async (threadId, opts, cmd) => {
64
+ const flags = readFlags(cmd);
65
+ await run({
66
+ method: "GET",
67
+ path: `/chats/${encodeURIComponent(threadId)}/messages`,
68
+ request: {
69
+ query: {
70
+ limit: opts.pageLimit,
71
+ before: opts.before,
72
+ },
73
+ },
74
+ output: outputFromFlags(flags),
75
+ profile: flags.profile,
76
+ });
77
+ });
78
+ chat
79
+ .command("thread")
80
+ .description("Resuelve (o crea) el hilo canónico de un objeto. Idempotente — útil para piping con `chat send`.")
81
+ .option("--workspace", "hilo de workspace (sólo staff, siempre interno)")
82
+ .option("--client <id>", "hilo de este cliente")
83
+ .option("--shared", "usa el hilo compartido con cliente (default: interno staff-only)")
84
+ .action(async (opts, cmd) => {
85
+ const flags = readFlags(cmd);
86
+ const clientVisible = opts.shared === true;
87
+ let body;
88
+ if (opts.client) {
89
+ body = { scope: "client", clientVisible, clientId: opts.client };
90
+ }
91
+ else if (opts.workspace) {
92
+ body = { scope: "workspace", clientVisible: false };
93
+ }
94
+ else {
95
+ throw new Error("Especifica uno de --client / --workspace.");
96
+ }
97
+ await run({
98
+ method: "POST",
99
+ path: "/chats",
100
+ request: {
101
+ body,
102
+ idempotencyKey: flags.idempotencyKey,
103
+ },
104
+ output: outputFromFlags(flags),
105
+ profile: flags.profile,
106
+ });
107
+ });
108
+ chat
109
+ .command("send")
110
+ .description("Envía un mensaje a un hilo existente")
111
+ .argument("<threadId>", "id del hilo (usa `crm chat thread` para resolverlo)")
112
+ .requiredOption("--body <text>", "contenido del mensaje (markdown + @menciones)")
113
+ .option("--kind <kind>", "message | agent_log (los agentes usan agent_log por defecto)")
114
+ .option("--parent <messageId>", "id del mensaje padre — convierte el envío en respuesta a un hilo")
115
+ .action(async (threadId, opts, cmd) => {
116
+ const flags = readFlags(cmd);
117
+ await run({
118
+ method: "POST",
119
+ path: `/chats/${encodeURIComponent(threadId)}/messages`,
120
+ request: {
121
+ body: {
122
+ content: opts.body,
123
+ kind: opts.kind,
124
+ parentMessageId: opts.parent,
125
+ },
126
+ idempotencyKey: flags.idempotencyKey,
127
+ },
128
+ output: outputFromFlags(flags),
129
+ profile: flags.profile,
130
+ asAgent: flags.asAgent,
131
+ });
132
+ });
133
+ chat
134
+ .command("reply")
135
+ .description("Atajo para responder a un mensaje (alias de `chat send` con --parent rellenado)")
136
+ .argument("<messageId>", "id del mensaje al que responder")
137
+ .requiredOption("--body <text>", "contenido de la respuesta (markdown + @menciones)")
138
+ .requiredOption("--thread <id>", "id del hilo donde vive el mensaje")
139
+ .option("--kind <kind>", "message | agent_log")
140
+ .action(async (messageId, opts, cmd) => {
141
+ const flags = readFlags(cmd);
142
+ await run({
143
+ method: "POST",
144
+ path: `/chats/${encodeURIComponent(opts.thread)}/messages`,
145
+ request: {
146
+ body: {
147
+ content: opts.body,
148
+ kind: opts.kind,
149
+ parentMessageId: messageId,
150
+ },
151
+ idempotencyKey: flags.idempotencyKey,
152
+ },
153
+ output: outputFromFlags(flags),
154
+ profile: flags.profile,
155
+ asAgent: flags.asAgent,
156
+ });
157
+ });
158
+ chat
159
+ .command("react")
160
+ .description("Activa o desactiva una reacción en un mensaje (👍 ✅ 👀 🙏 ❤️ ❓ 🔥 🚀)")
161
+ .argument("<messageId>", "id del mensaje")
162
+ .requiredOption("--emoji <emoji>", "emoji curado (uno de los 8 permitidos)")
163
+ .action(async (messageId, opts, cmd) => {
164
+ const flags = readFlags(cmd);
165
+ await run({
166
+ method: "POST",
167
+ path: `/chats/messages/${encodeURIComponent(messageId)}/reactions`,
168
+ request: {
169
+ body: { emoji: opts.emoji },
170
+ idempotencyKey: flags.idempotencyKey,
171
+ },
172
+ output: outputFromFlags(flags),
173
+ profile: flags.profile,
174
+ asAgent: flags.asAgent,
175
+ });
176
+ });
177
+ chat
178
+ .command("dm")
179
+ .description("Crea un DM 1:1 o grupo personalizado. Idempotente para 1:1 (mismos miembros → mismo hilo).")
180
+ .requiredOption("--member <id...>", "ids de miembro o usuario (acepta varios con --member id1 --member id2)")
181
+ .option("--title <name>", "nombre opcional para grupos")
182
+ .option("--client <id>", "ancla el grupo a este cliente (necesario si incluye un cliente)")
183
+ .action(async (opts, cmd) => {
184
+ const flags = readFlags(cmd);
185
+ await run({
186
+ method: "POST",
187
+ path: "/chats/dm",
188
+ request: {
189
+ body: {
190
+ memberIds: opts.member,
191
+ title: opts.title,
192
+ parentClientId: opts.client,
193
+ },
194
+ idempotencyKey: flags.idempotencyKey,
195
+ },
196
+ output: outputFromFlags(flags),
197
+ profile: flags.profile,
198
+ asAgent: flags.asAgent,
199
+ });
200
+ });
201
+ chat
202
+ .command("mark-read")
203
+ .description("Marca un chat como leído (avanza el cursor de lectura)")
204
+ .argument("<threadId>", "id del hilo")
205
+ .option("--message <id>", "última message id leída (opcional)")
206
+ .action(async (threadId, opts, cmd) => {
207
+ const flags = readFlags(cmd);
208
+ await run({
209
+ method: "POST",
210
+ path: `/chats/${encodeURIComponent(threadId)}/read`,
211
+ request: {
212
+ body: { lastReadMessageId: opts.message },
213
+ idempotencyKey: flags.idempotencyKey,
214
+ },
215
+ output: outputFromFlags(flags),
216
+ profile: flags.profile,
217
+ });
218
+ });
219
+ }
220
+ //# sourceMappingURL=chat.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/commands/chat.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,89 @@
1
+ /**
2
+ * `crm commands` — dump the full CLI surface as a JSON catalog so agents can
3
+ * introspect commands without hitting the API. SKILL.md promises this as the
4
+ * "v2 escape hatch"; this is that.
5
+ *
6
+ * Output shape is a tree of {name, description, args, options, subcommands}.
7
+ * Every node mirrors the commander Command — names are the resolved
8
+ * subcommand chain (e.g. "task create"), descriptions are the Spanish strings
9
+ * already on each command. Options preserve flags, required-ness, and the
10
+ * description verbatim.
11
+ */
12
+ import { renderSuccess } from "../transport/envelope.js";
13
+ import { outputFromFlags, readFlags } from "./options.js";
14
+ /** Describe one option without leaking commander internals to callers. */
15
+ function describeOption(opt) {
16
+ return {
17
+ flags: opt.flags,
18
+ description: opt.description ?? "",
19
+ required: opt.required ?? false,
20
+ isBoolean: !opt.flags.includes("<") && !opt.flags.includes("["),
21
+ isNegated: opt.negate === true,
22
+ defaultValue: opt.defaultValue,
23
+ };
24
+ }
25
+ function describeArg(arg) {
26
+ return {
27
+ name: arg.name(),
28
+ description: arg.description ?? "",
29
+ required: arg.required,
30
+ variadic: arg.variadic,
31
+ };
32
+ }
33
+ /** Walk the commander tree producing the catalog. The root command (the
34
+ * `program` itself) gets dropped — we only emit user-facing verbs. */
35
+ function walk(cmd, parentPath) {
36
+ const out = [];
37
+ for (const child of cmd.commands) {
38
+ // Skip the auto-generated help command.
39
+ if (child.name() === "help")
40
+ continue;
41
+ const path = parentPath ? `${parentPath} ${child.name()}` : child.name();
42
+ out.push({
43
+ path,
44
+ name: child.name(),
45
+ description: child.description() ?? "",
46
+ args: (child.registeredArguments ?? []).map(describeArg),
47
+ options: child.options.map(describeOption),
48
+ subcommands: walk(child, path),
49
+ });
50
+ }
51
+ return out;
52
+ }
53
+ export function registerCommands(program) {
54
+ program
55
+ .command("commands")
56
+ .description("Dump del catálogo completo del CLI como JSON (verbos, args, flags). Útil para introspección de agentes.")
57
+ .action((_opts, cmd) => {
58
+ const flags = readFlags(cmd);
59
+ // Walk from the program root so we get every top-level verb.
60
+ const root = cmd.parent ?? cmd;
61
+ const tree = walk(root, "");
62
+ // Flat index by path — agents can `--jq .data.flat[]` to iterate.
63
+ const flat = [];
64
+ const pushFlat = (n) => {
65
+ flat.push({
66
+ path: n.path,
67
+ name: n.name,
68
+ description: n.description,
69
+ args: n.args,
70
+ options: n.options,
71
+ });
72
+ for (const sub of n.subcommands)
73
+ pushFlat(sub);
74
+ };
75
+ for (const n of tree)
76
+ pushFlat(n);
77
+ const envelope = {
78
+ ok: true,
79
+ data: { tree, flat },
80
+ summary: `${flat.length} comando(s) registrados`,
81
+ meta: {
82
+ requestId: `commands_${Date.now()}`,
83
+ timestamp: new Date().toISOString(),
84
+ },
85
+ };
86
+ renderSuccess(envelope, outputFromFlags(flags));
87
+ });
88
+ }
89
+ //# sourceMappingURL=commands.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/commands/commands.ts"],"names":[],"mappings":"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"}
@@ -39,6 +39,7 @@ export function registerComment(program) {
39
39
  profile: flags.profile,
40
40
  waitForApproval: flags.waitForApproval,
41
41
  waitTimeoutMs: parseDurationMs(flags.timeout),
42
+ asAgent: flags.asAgent,
42
43
  });
43
44
  });
44
45
  }
@@ -1 +1 @@
1
- {"version":3,"file":"comment.js","sourceRoot":"","sources":["../../../src/commands/comment.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAGxD,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAE/E,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,oCAAoC,CAAC;SACjD,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;SACnC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,KAAK,EAAE,GAAY,EAAE,EAAE;QACpD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,WAAW;YACrD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,mEAAmE,CAAC;SAChF,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC;SAC5C,cAAc,CAAC,eAAe,EAAE,gEAAgE,CAAC;SACjG,MAAM,CACL,eAAe,EACf,sEAAsE,CACvE;SACA,MAAM,CACL,KAAK,EACH,IAA8E,EAC9E,GAAY,EACZ,EAAE;QACF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW;YACxD,OAAO,EAAE;gBACP,IAAI,EAAE;oBACJ,OAAO,EAAE,IAAI,CAAC,IAAI;oBAClB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1C;gBACD,cAAc,EAAE,KAAK,CAAC,cAAc;aACrC;YACD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACN,CAAC"}
1
+ {"version":3,"file":"comment.js","sourceRoot":"","sources":["../../../src/commands/comment.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAGxD,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAE/E,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,oCAAoC,CAAC;SACjD,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;SACnC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,KAAK,EAAE,GAAY,EAAE,EAAE;QACpD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,WAAW;YACrD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,mEAAmE,CAAC;SAChF,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC;SAC5C,cAAc,CAAC,eAAe,EAAE,gEAAgE,CAAC;SACjG,MAAM,CACL,eAAe,EACf,sEAAsE,CACvE;SACA,MAAM,CACL,KAAK,EACH,IAA8E,EAC9E,GAAY,EACZ,EAAE;QACF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC;YACR,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW;YACxD,OAAO,EAAE;gBACP,IAAI,EAAE;oBACJ,OAAO,EAAE,IAAI,CAAC,IAAI;oBAClB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1C;gBACD,cAAc,EAAE,KAAK,CAAC,cAAc;aACrC;YACD,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC;YAC7C,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACN,CAAC"}