@laburen/delta-cli 0.0.0-stage → 0.2.0-canary.10

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 (160) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +33 -2
  3. package/dist/bin.d.ts +2 -0
  4. package/dist/bin.js +20 -0
  5. package/dist/bin.js.map +1 -0
  6. package/dist/commands/agent-checks.d.ts +5 -0
  7. package/dist/commands/agent-checks.js +69 -0
  8. package/dist/commands/agent-checks.js.map +1 -0
  9. package/dist/commands/agent-run/body.d.ts +22 -0
  10. package/dist/commands/agent-run/body.js +88 -0
  11. package/dist/commands/agent-run/body.js.map +1 -0
  12. package/dist/commands/agent-run/render.d.ts +50 -0
  13. package/dist/commands/agent-run/render.js +281 -0
  14. package/dist/commands/agent-run/render.js.map +1 -0
  15. package/dist/commands/agent-run.d.ts +10 -0
  16. package/dist/commands/agent-run.js +243 -0
  17. package/dist/commands/agent-run.js.map +1 -0
  18. package/dist/commands/agent-tools/add.d.ts +5 -0
  19. package/dist/commands/agent-tools/add.js +101 -0
  20. package/dist/commands/agent-tools/add.js.map +1 -0
  21. package/dist/commands/agent-tools/remove.d.ts +5 -0
  22. package/dist/commands/agent-tools/remove.js +126 -0
  23. package/dist/commands/agent-tools/remove.js.map +1 -0
  24. package/dist/commands/agent-tools/shared.d.ts +283 -0
  25. package/dist/commands/agent-tools/shared.js +107 -0
  26. package/dist/commands/agent-tools/shared.js.map +1 -0
  27. package/dist/commands/agent-tools.d.ts +5 -0
  28. package/dist/commands/agent-tools.js +11 -0
  29. package/dist/commands/agent-tools.js.map +1 -0
  30. package/dist/commands/auth.d.ts +14 -0
  31. package/dist/commands/auth.js +171 -0
  32. package/dist/commands/auth.js.map +1 -0
  33. package/dist/commands/completion.d.ts +4 -0
  34. package/dist/commands/completion.js +50 -0
  35. package/dist/commands/completion.js.map +1 -0
  36. package/dist/commands/config-sources.d.ts +22 -0
  37. package/dist/commands/config-sources.js +46 -0
  38. package/dist/commands/config-sources.js.map +1 -0
  39. package/dist/commands/config-wizard.d.ts +9 -0
  40. package/dist/commands/config-wizard.js +332 -0
  41. package/dist/commands/config-wizard.js.map +1 -0
  42. package/dist/commands/orgs.d.ts +11 -0
  43. package/dist/commands/orgs.js +193 -0
  44. package/dist/commands/orgs.js.map +1 -0
  45. package/dist/commands/skill-dir.d.ts +18 -0
  46. package/dist/commands/skill-dir.js +101 -0
  47. package/dist/commands/skill-dir.js.map +1 -0
  48. package/dist/commands/token-notice.d.ts +4 -0
  49. package/dist/commands/token-notice.js +13 -0
  50. package/dist/commands/token-notice.js.map +1 -0
  51. package/dist/commands/whoami.d.ts +8 -0
  52. package/dist/commands/whoami.js +38 -0
  53. package/dist/commands/whoami.js.map +1 -0
  54. package/dist/commands/wizards.d.ts +4 -0
  55. package/dist/commands/wizards.js +210 -0
  56. package/dist/commands/wizards.js.map +1 -0
  57. package/dist/completion/bash.d.ts +3 -0
  58. package/dist/completion/bash.js +60 -0
  59. package/dist/completion/bash.js.map +1 -0
  60. package/dist/completion/files.d.ts +35 -0
  61. package/dist/completion/files.js +178 -0
  62. package/dist/completion/files.js.map +1 -0
  63. package/dist/completion/powershell.d.ts +9 -0
  64. package/dist/completion/powershell.js +83 -0
  65. package/dist/completion/powershell.js.map +1 -0
  66. package/dist/completion/tree.d.ts +25 -0
  67. package/dist/completion/tree.js +53 -0
  68. package/dist/completion/tree.js.map +1 -0
  69. package/dist/completion/zsh.d.ts +3 -0
  70. package/dist/completion/zsh.js +76 -0
  71. package/dist/completion/zsh.js.map +1 -0
  72. package/dist/config/auth.d.ts +26 -0
  73. package/dist/config/auth.js +223 -0
  74. package/dist/config/auth.js.map +1 -0
  75. package/dist/config/link.d.ts +16 -0
  76. package/dist/config/link.js +93 -0
  77. package/dist/config/link.js.map +1 -0
  78. package/dist/config/paths.d.ts +3 -0
  79. package/dist/config/paths.js +20 -0
  80. package/dist/config/paths.js.map +1 -0
  81. package/dist/config/settings.d.ts +8 -0
  82. package/dist/config/settings.js +24 -0
  83. package/dist/config/settings.js.map +1 -0
  84. package/dist/confirm.d.ts +35 -0
  85. package/dist/confirm.js +51 -0
  86. package/dist/confirm.js.map +1 -0
  87. package/dist/context.d.ts +29 -0
  88. package/dist/context.js +16 -0
  89. package/dist/context.js.map +1 -0
  90. package/dist/errors.d.ts +54 -0
  91. package/dist/errors.js +413 -0
  92. package/dist/errors.js.map +1 -0
  93. package/dist/generated/commands.d.ts +49 -0
  94. package/dist/generated/commands.js +52 -0
  95. package/dist/generated/commands.js.map +1 -0
  96. package/dist/generated/schemas.d.ts +5 -0
  97. package/dist/generated/schemas.js +20 -0
  98. package/dist/generated/schemas.js.map +1 -0
  99. package/dist/invocation.d.ts +64 -0
  100. package/dist/invocation.js +341 -0
  101. package/dist/invocation.js.map +1 -0
  102. package/dist/mode.d.ts +17 -0
  103. package/dist/mode.js +22 -0
  104. package/dist/mode.js.map +1 -0
  105. package/dist/operations/call.d.ts +6 -0
  106. package/dist/operations/call.js +17 -0
  107. package/dist/operations/call.js.map +1 -0
  108. package/dist/operations/extensions.d.ts +46 -0
  109. package/dist/operations/extensions.js +29 -0
  110. package/dist/operations/extensions.js.map +1 -0
  111. package/dist/operations/json-input.d.ts +7 -0
  112. package/dist/operations/json-input.js +50 -0
  113. package/dist/operations/json-input.js.map +1 -0
  114. package/dist/operations/params.d.ts +17 -0
  115. package/dist/operations/params.js +106 -0
  116. package/dist/operations/params.js.map +1 -0
  117. package/dist/operations/register.d.ts +10 -0
  118. package/dist/operations/register.js +102 -0
  119. package/dist/operations/register.js.map +1 -0
  120. package/dist/operations/run-operation.d.ts +8 -0
  121. package/dist/operations/run-operation.js +148 -0
  122. package/dist/operations/run-operation.js.map +1 -0
  123. package/dist/operations/schema-flag.d.ts +8 -0
  124. package/dist/operations/schema-flag.js +12 -0
  125. package/dist/operations/schema-flag.js.map +1 -0
  126. package/dist/operations/skeleton.d.ts +16 -0
  127. package/dist/operations/skeleton.js +116 -0
  128. package/dist/operations/skeleton.js.map +1 -0
  129. package/dist/operations/tables.d.ts +7 -0
  130. package/dist/operations/tables.js +131 -0
  131. package/dist/operations/tables.js.map +1 -0
  132. package/dist/operations.d.ts +5 -0
  133. package/dist/operations.js +7 -0
  134. package/dist/operations.js.map +1 -0
  135. package/dist/output.d.ts +33 -0
  136. package/dist/output.js +321 -0
  137. package/dist/output.js.map +1 -0
  138. package/dist/pickers.d.ts +51 -0
  139. package/dist/pickers.js +277 -0
  140. package/dist/pickers.js.map +1 -0
  141. package/dist/program.d.ts +31 -0
  142. package/dist/program.js +260 -0
  143. package/dist/program.js.map +1 -0
  144. package/dist/prompter.d.ts +54 -0
  145. package/dist/prompter.js +129 -0
  146. package/dist/prompter.js.map +1 -0
  147. package/dist/session.d.ts +45 -0
  148. package/dist/session.js +170 -0
  149. package/dist/session.js.map +1 -0
  150. package/dist/stdout-policy.d.ts +4 -0
  151. package/dist/stdout-policy.js +11 -0
  152. package/dist/stdout-policy.js.map +1 -0
  153. package/dist/update-check.d.ts +4 -0
  154. package/dist/update-check.js +60 -0
  155. package/dist/update-check.js.map +1 -0
  156. package/docs/SKILL.md +175 -0
  157. package/docs/references/auth-and-organizations.md +72 -0
  158. package/docs/references/commands.md +217 -0
  159. package/docs/references/output-and-errors.md +105 -0
  160. package/package.json +39 -5
package/dist/errors.js ADDED
@@ -0,0 +1,413 @@
1
+ import { isLaburenApiError, isLaburenConnectionError, isLaburenOAuthError, isLaburenTimeoutError, } from "@laburen/delta-sdk/platform";
2
+ import { CommanderError } from "commander";
3
+ import { OPERATION_COMMANDS } from "./generated/commands.js";
4
+ import { commandText, redactSecrets, shellQuote, VALUE_PLACEHOLDER, withoutOption, } from "./invocation.js";
5
+ /** Error de la CLI con su `reason` estable, el código de salida (1 API/red, 2 mal uso) y los pasos para arreglarlo. */
6
+ export class CliError extends Error {
7
+ reason;
8
+ exitCode;
9
+ next;
10
+ requestId;
11
+ issues;
12
+ details;
13
+ userActionRequired;
14
+ choices;
15
+ constructor(reason, message, exitCode, next = [], requestId, extra = {}) {
16
+ super(message);
17
+ this.reason = reason;
18
+ this.exitCode = exitCode;
19
+ this.next = next;
20
+ this.requestId = requestId;
21
+ this.name = "CliError";
22
+ this.issues = extra.issues ?? [];
23
+ this.details = extra.details ?? {};
24
+ this.userActionRequired = extra.userActionRequired ?? false;
25
+ this.choices = extra.choices;
26
+ }
27
+ }
28
+ const ORGANIZATION_HEADER = "x-laburen-organization";
29
+ /** `laburen <ruta> --help` del comando que se corrió, o `laburen --help` si no se sabe cuál. */
30
+ export function helpCommand(command = []) {
31
+ return ["laburen", ...command, "--help"].join(" ");
32
+ }
33
+ /** Para cada `*_not_found`: el `list` que muestra los ids que sí existen; `<x>` se reemplaza por el id si se conoce. */
34
+ const NOT_FOUND_LIST = {
35
+ agent_not_found: ["agents", "list"],
36
+ config_version_not_found: ["agents", "versions", "list", "<agent_id>"],
37
+ skill_not_found: ["skills", "list"],
38
+ skill_version_not_found: ["skills", "versions", "list", "<skill_id>"],
39
+ mcp_connection_not_found: ["mcp", "connections", "list"],
40
+ mcp_connection_version_not_found: ["mcp", "connections", "versions", "list", "<connection_id>"],
41
+ token_not_found: ["tokens", "list"],
42
+ };
43
+ /** Reemplaza cada `<nombre>` por el id que vino en el comando; si no vino, queda el marcador. */
44
+ function fillIds(parts, ids = {}) {
45
+ const words = parts.map((part) => {
46
+ const name = /^<(\w+)>$/.exec(part)?.[1];
47
+ if (!name)
48
+ return shellQuote(part);
49
+ const id = ids[name];
50
+ return id ? shellQuote(id) : part;
51
+ });
52
+ return ["laburen", ...words].join(" ");
53
+ }
54
+ /** El valor de una opción (`--name x` o `--name=x`) en los argumentos que escribió la persona. */
55
+ function optionValue(args = [], flag) {
56
+ for (let i = 0; i < args.length; i++) {
57
+ const arg = args[i];
58
+ if (arg === "--")
59
+ return undefined;
60
+ if (arg === flag)
61
+ return args[i + 1];
62
+ if (arg.startsWith(`${flag}=`))
63
+ return arg.slice(flag.length + 1);
64
+ }
65
+ return undefined;
66
+ }
67
+ /** Los campos de `details.field` que se arreglan eligiendo otro modelo o nivel de reasoning de los que ofrece la API. */
68
+ const MODEL_FIELDS = new Set([
69
+ "model",
70
+ "model_settings.reasoning",
71
+ "config.model.id",
72
+ "config.model.reasoningEffort",
73
+ "config.model.reasoning_effort",
74
+ ]);
75
+ function agentVersionsOf(details) {
76
+ if (!Array.isArray(details.agent_versions))
77
+ return [];
78
+ return details.agent_versions.filter((v) => typeof v === "object" &&
79
+ v !== null &&
80
+ typeof v.agent_id === "string" &&
81
+ typeof v.version_id === "string");
82
+ }
83
+ /** `args` con el flag en `value`: si ya estaba se reemplaza, y se suma antes de un `--` para que siga siendo un flag. */
84
+ function withOptionValue(args, flag, value) {
85
+ const rest = withoutOption(args, flag);
86
+ const end = rest.indexOf("--");
87
+ return end === -1
88
+ ? [...rest, flag, value]
89
+ : [...rest.slice(0, end), flag, value, ...rest.slice(end)];
90
+ }
91
+ /**
92
+ * El comando que muestra si un pedido que sigue corriendo ya hizo efecto: el `list` (o `get`) del recurso que
93
+ * crea o edita el comando. `agents run` no tiene uno: no hay cómo ver desde la CLI un turno en curso.
94
+ */
95
+ function idempotencyCheckCommand(hints) {
96
+ const path = hints.command;
97
+ if (!path || path.length < 2)
98
+ return undefined;
99
+ const group = path.slice(0, -1);
100
+ const verb = path[path.length - 1];
101
+ const candidates = verb === "create"
102
+ ? [[...group, "list"]]
103
+ : verb === "update" || verb === "restore" || verb === "activate"
104
+ ? [
105
+ [...group, "versions", "list"],
106
+ [...group, "get"],
107
+ [...group, "list"],
108
+ ]
109
+ : [];
110
+ for (const candidate of candidates) {
111
+ const op = OPERATION_COMMANDS.find((o) => o.path.join(" ") === candidate.join(" "));
112
+ if (!op)
113
+ continue;
114
+ const parts = [...candidate, ...op.positionals.map((name) => `<${name}>`)];
115
+ const name = optionValue(hints.args, "--name");
116
+ if (name !== undefined && op.queryFlags.some((f) => f.flag === "--search")) {
117
+ parts.push("--search", name);
118
+ }
119
+ return fillIds(parts, hints.ids);
120
+ }
121
+ return undefined;
122
+ }
123
+ /** `next` de los errores comunes de la API (Q9): a qué comando ir según el `code`. */
124
+ function apiNext(code, hints, details = {}, message = "") {
125
+ // Una versión con la tool `thinking` y un modelo que razona: `models list` no lo arregla, hay que apagar el reasoning de la corrida o correr otra versión.
126
+ if (code === "invalid_request" &&
127
+ details.field === "model_settings.reasoning" &&
128
+ /thinking tool/.test(message)) {
129
+ const steps = [];
130
+ // Solo si el modelo puede apagar el reasoning; uno que "always reasons" no acepta `off`.
131
+ if (/already reasons/.test(message)) {
132
+ steps.push({
133
+ command: hints.args?.length
134
+ ? commandText(withOptionValue(hints.args, "--reasoning", "off"))
135
+ : "laburen agents run <agent_id> <message> --reasoning off",
136
+ when: "to run it with reasoning off, which the thinking tool allows",
137
+ });
138
+ }
139
+ steps.push({
140
+ command: fillIds(["agents", "versions", "list", "<agent_id>"], hints.ids),
141
+ when: "to find a version without the thinking tool; run it with --version-id",
142
+ });
143
+ return steps;
144
+ }
145
+ // El nombre o el nivel de reasoning no es de los que ofrece la API: `models list` dice cuáles hay.
146
+ // Hay errores de forma ("must be a non-empty string") que `models list` no arregla: solo cuando el mensaje dice que no se ofrece.
147
+ if ((code === "invalid_request" || code === "invalid_agent_config") &&
148
+ typeof details.field === "string" &&
149
+ MODEL_FIELDS.has(details.field) &&
150
+ /not offered|is invalid|not allowed/.test(message)) {
151
+ return [
152
+ {
153
+ command: "laburen models list",
154
+ when: "the model or reasoning level is not available; to see the offered models and their reasoning levels",
155
+ },
156
+ ];
157
+ }
158
+ // Repetir el comando manda un pedido nuevo (otra key) y puede duplicar: primero se mira si el primero ya hizo efecto.
159
+ if (code === "idempotency_key_in_progress") {
160
+ const check = idempotencyCheckCommand(hints);
161
+ return check
162
+ ? [
163
+ {
164
+ command: check,
165
+ when: "the first request is still running and may finish; wait, then check here that it did not apply before running the command again (running it again sends a new request and can duplicate)",
166
+ },
167
+ ]
168
+ : [];
169
+ }
170
+ if (code === "organization_access_denied") {
171
+ return [
172
+ {
173
+ command: "laburen orgs list",
174
+ when: "to see the organizations you can use",
175
+ omitGlobals: ["--org"],
176
+ },
177
+ ];
178
+ }
179
+ // `whoami` muestra los permisos del token y anda con cualquier token.
180
+ if (code === "insufficient_permissions") {
181
+ return [
182
+ {
183
+ command: "laburen whoami",
184
+ when: "the token you used does not have the permission this command needs; whoami shows the permissions it has",
185
+ },
186
+ ];
187
+ }
188
+ if (code === "skill_name_taken") {
189
+ const name = optionValue(hints.args, "--name");
190
+ return [
191
+ name === undefined
192
+ ? {
193
+ command: "laburen skills list --search <value>",
194
+ when: "to find the skill that already has this name (put the name instead of <value>)",
195
+ }
196
+ : {
197
+ command: fillIds(["skills", "list", "--search", name]),
198
+ when: "to find the skill that already has this name",
199
+ },
200
+ ];
201
+ }
202
+ if (code === "mcp_connection_name_taken") {
203
+ const name = optionValue(hints.args, "--name");
204
+ return [
205
+ name === undefined
206
+ ? {
207
+ command: "laburen mcp connections list --search <value>",
208
+ when: "to find the connection that already has this name (put the name instead of <value>)",
209
+ }
210
+ : {
211
+ command: fillIds(["mcp", "connections", "list", "--search", name]),
212
+ when: "to find the connection that already has this name",
213
+ },
214
+ ];
215
+ }
216
+ // `details.agent_ids` dice qué agentes usan el recurso: se ve de cada uno qué versión lo tiene.
217
+ if (code === "resource_in_use") {
218
+ // Con `agent_versions` se sabe cuáles borrar: solo `is_active === false` se borra; la activa o dudosa, esa se mira para cambiarla primero.
219
+ const versions = agentVersionsOf(details);
220
+ if (versions.length > 0) {
221
+ return versions.map((v) => v.is_active !== false
222
+ ? {
223
+ command: fillIds(["agents", "versions", "get", v.agent_id, v.version_id]),
224
+ when: "this is the active version: create a new version without the resource (agents update … --activate) before deleting",
225
+ }
226
+ : {
227
+ command: fillIds(["agents", "versions", "delete", v.agent_id, v.version_id]),
228
+ when: "this inactive version uses the resource; delete it, then retry",
229
+ });
230
+ }
231
+ const agentIds = Array.isArray(details.agent_ids)
232
+ ? details.agent_ids.filter((id) => typeof id === "string")
233
+ : [];
234
+ if (agentIds.length > 0) {
235
+ return agentIds.map((id) => ({
236
+ command: fillIds(["agents", "versions", "list", id]),
237
+ when: "this agent has versions that use the resource; versions are not editable: delete those versions (inactive ones can be deleted) or the agent itself, then retry",
238
+ }));
239
+ }
240
+ return [
241
+ {
242
+ command: helpCommand(hints.command),
243
+ when: "it is still used by agent versions (details.versions_count says how many); to see what the command accepts",
244
+ },
245
+ ];
246
+ }
247
+ // El mismo comando sin el flag que no encaja con la conversación existente.
248
+ if (code === "thread_resource_mismatch" || code === "conversation_not_found") {
249
+ const flag = code === "thread_resource_mismatch" ? "--resource" : "--thread";
250
+ return [
251
+ {
252
+ command: hints.args?.length
253
+ ? commandText(withoutOption(hints.args, flag))
254
+ : `laburen agents run <agent_id> <message>`,
255
+ when: code === "thread_resource_mismatch"
256
+ ? "to run it without --resource (the thread already belongs to another end user)"
257
+ : "to run it without --thread and start a new conversation",
258
+ },
259
+ ];
260
+ }
261
+ // La IA está apagada en ese hilo (la tomó una persona): el mismo comando sin `--thread` abre una conversación nueva.
262
+ if (code === "ai_disabled_for_conversation") {
263
+ return [
264
+ {
265
+ command: hints.args?.length
266
+ ? commandText(withoutOption(hints.args, "--thread"))
267
+ : "laburen agents run <agent_id> <message>",
268
+ when: "the AI is off in that thread (a human took over); to run it without --thread and start a new conversation",
269
+ },
270
+ ];
271
+ }
272
+ // Un id de `config.knowledge.project_ids` que no existe en la organización: `knowledge projects list` dice cuáles hay.
273
+ if ((code === "invalid_request" || code === "invalid_agent_config") &&
274
+ typeof details.field === "string" &&
275
+ details.field.startsWith("config.knowledge.project_ids")) {
276
+ return [
277
+ {
278
+ command: "laburen knowledge projects list",
279
+ when: "to see the knowledge project ids of this organization",
280
+ },
281
+ ];
282
+ }
283
+ // `mcp connections versions list` tiene la columna HOST: ahí se ve a qué host apunta cada versión.
284
+ if (code === "mcp_server_unreachable") {
285
+ return [
286
+ {
287
+ command: fillIds(["mcp", "connections", "versions", "list", "<connection_id>"], hints.ids),
288
+ when: "to see the host each version of the connection points to (HOST column)",
289
+ },
290
+ ];
291
+ }
292
+ // Alguien creó otra versión después de la lectura (E19): se ven las versiones y se corre de nuevo el comando.
293
+ if (code === "base_version_mismatch") {
294
+ const parent = hints.command?.[0] === "mcp" ? "mcp" : "agents";
295
+ const versions = parent === "mcp"
296
+ ? ["mcp", "connections", "versions", "list", "<connection_id>"]
297
+ : ["agents", "versions", "list", "<agent_id>"];
298
+ return [
299
+ {
300
+ command: fillIds(versions, hints.ids),
301
+ when: "the resource changed after you read it; see the latest version, then run the command again",
302
+ },
303
+ ];
304
+ }
305
+ // Un agente sin versión activa no se puede correr: se ven sus versiones y se activa una.
306
+ // Otros invalid_agent_config (una versión con la config rota) no se arreglan activando: caen en el `--help` genérico.
307
+ if (code === "invalid_agent_config" &&
308
+ hints.command?.join(" ") === "agents run" &&
309
+ /no active version/i.test(message)) {
310
+ return [
311
+ {
312
+ command: fillIds(["agents", "versions", "list", "<agent_id>"], hints.ids),
313
+ when: "the agent has no active version; see its versions",
314
+ },
315
+ {
316
+ command: fillIds(["agents", "versions", "activate", "<agent_id>", "<version_id>"], hints.ids),
317
+ when: "to make one the active version, then run again",
318
+ },
319
+ {
320
+ command: fillIds(["agents", "versions", "create", "<agent_id>", "--config", "@config.json"], hints.ids),
321
+ when: "or create a first version from a config file, then activate it",
322
+ },
323
+ ];
324
+ }
325
+ const list = NOT_FOUND_LIST[code];
326
+ if (list)
327
+ return [{ command: fillIds(list, hints.ids), when: "to see the ids that exist" }];
328
+ if (code === "version_in_use" && hints.command && hints.command.length > 1) {
329
+ const group = hints.command.slice(0, -1);
330
+ const activate = OPERATION_COMMANDS.find((op) => op.path.join(" ") === [...group, "activate"].join(" "));
331
+ if (!activate)
332
+ return [];
333
+ const parent = fillIds([...group, "activate", `<${activate.positionals[0]}>`], hints.ids);
334
+ return [
335
+ {
336
+ // `<version_id>` queda como marcador: es otra versión, la que elija la persona.
337
+ command: `${parent} <version_id>`,
338
+ when: "to make another version the active one first, then retry",
339
+ },
340
+ {
341
+ command: fillIds([...group, "list", `<${activate.positionals[0]}>`], hints.ids),
342
+ when: "to see the versions",
343
+ },
344
+ ];
345
+ }
346
+ return [];
347
+ }
348
+ /** Recibe cualquier cosa que se lanzó y devuelve el error de la CLI con su `reason`, código de salida y `next`. */
349
+ export function toCliError(err, hints = {}) {
350
+ if (err instanceof CliError)
351
+ return err;
352
+ if (err instanceof CommanderError) {
353
+ // Commander repite el flag tal cual (`unknown option '--api-key=x'`): sin ningún valor, sea o no secreto (M6).
354
+ const message = redactSecrets(err.message.replace(/^error: /, ""), hints.args ?? []).replace(/(--[\w-]+)=[^'\s]*/g, `$1=${VALUE_PLACEHOLDER}`);
355
+ const missing = err.code.includes("missing") || err.code.includes("Missing");
356
+ // Un valor fuera de la lista de un flag de opciones (`--reasoning ultra`) es un valor inválido, no argumentos mal armados (C12).
357
+ const reason = missing
358
+ ? "missing_arguments"
359
+ : err.code === "commander.invalidArgument"
360
+ ? "invalid_flag_value"
361
+ : "invalid_arguments";
362
+ return new CliError(reason, message, 2, [
363
+ { command: helpCommand(hints.command), when: "to see the arguments and flags it accepts" },
364
+ ]);
365
+ }
366
+ if (isLaburenApiError(err)) {
367
+ const reason = err.code ?? "api_error";
368
+ const requestId = err.requestId ?? undefined;
369
+ const extra = { issues: err.issues, details: err.details };
370
+ if (reason === "invalid_token") {
371
+ return new CliError("login_required", err.message, 1, [{ command: "laburen login", when: "to sign in again and save new credentials" }], requestId, extra);
372
+ }
373
+ if (reason === "invalid_request" && err.details.header === ORGANIZATION_HEADER) {
374
+ const rerun = hints.args?.length
375
+ ? `${commandText(withoutOption(hints.args, "--org"))} --org <id>`
376
+ : "laburen <command> --org <id>";
377
+ return new CliError(reason, err.message, 1, [
378
+ { command: "laburen orgs list", when: "to see the organizations you can use" },
379
+ { command: rerun, when: "to run it for one of those organizations" },
380
+ ], requestId, extra);
381
+ }
382
+ const next = apiNext(reason, hints, err.details, err.message);
383
+ if (hints.continueCommand) {
384
+ // Un error a mitad del stream (de cualquier familia) no es un pedido mal armado: `--help` no sirve, seguir el thread sí.
385
+ next.push({
386
+ command: hints.continueCommand,
387
+ when: "to keep going with the same conversation",
388
+ });
389
+ }
390
+ else if (next.length === 0 && err.type === "invalid_request_error" && hints.command?.length) {
391
+ // Un pedido que la API rechaza por inválido se arregla mirando qué acepta el comando (Q16).
392
+ next.push({
393
+ command: helpCommand(hints.command),
394
+ when: "to see the arguments and flags it accepts",
395
+ });
396
+ }
397
+ return new CliError(reason, err.message, 1, next, requestId, extra);
398
+ }
399
+ if (isLaburenConnectionError(err)) {
400
+ // El mensaje del SDK queda en details; el de la CLI es propio y en inglés (C14).
401
+ const message = isLaburenTimeoutError(err)
402
+ ? "The Laburen API did not answer in time."
403
+ : "Could not reach the Laburen API. Check your connection and the API URL (--api-url or LABUREN_API_URL).";
404
+ return new CliError("network_error", message, 1, [], undefined, {
405
+ details: { cause: err.message },
406
+ });
407
+ }
408
+ if (isLaburenOAuthError(err)) {
409
+ return new CliError(err.error, err.message, 1);
410
+ }
411
+ return new CliError("unexpected_error", err instanceof Error ? err.message : String(err), 1);
412
+ }
413
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,49 @@
1
+ /** Un flag de un comando: `name` es el campo de la API (snake_case) y `flag` el de la terminal. */
2
+ export interface FlagSpec {
3
+ name: string;
4
+ flag: string;
5
+ type: "string" | "number" | "boolean" | "json";
6
+ required: boolean;
7
+ /** El campo acepta null en el contrato: el valor `null` del flag manda null de verdad. */
8
+ nullable?: boolean;
9
+ /** Qué es el campo, tal como lo dice el contrato; el `--help` la muestra. */
10
+ description?: string;
11
+ /** Valores que acepta, si el contrato los enumera (`enum` o `const`); en un flag `json` de lista, los de cada ítem. */
12
+ values?: string[];
13
+ }
14
+ /** Ficha de un comando de recurso: una por operación del contrato, salvo oauth.* y meta.*. */
15
+ export interface OperationCommand {
16
+ id: string;
17
+ path: string[];
18
+ summary: string;
19
+ positionals: string[];
20
+ queryFlags: FlagSpec[];
21
+ bodyFlags: FlagSpec[];
22
+ hasBody: boolean;
23
+ /** Si el contrato declara el header de organización en esta operación; si no, no se manda (C20). */
24
+ organizationHeader: boolean;
25
+ paginated: boolean;
26
+ /** Si borra o revoca: la CLI pide confirmación antes de llamar a la API (C27). */
27
+ destructive: boolean;
28
+ /** Por cada id de la ruta, el `list` que lo lista y los ids previos que pide: de ahí se elige si falta (C28). */
29
+ idSources: Record<string, IdSource>;
30
+ /** En los `list`: qué campo del ítem es la etiqueta y cuál marca el actual al elegir de la lista. */
31
+ choice?: ChoiceSpec;
32
+ /** En un `compare`: el `list` de donde se eligen `--from` y `--to` si faltan (C29). */
33
+ compareSource?: IdSource;
34
+ }
35
+ /** De dónde sale un id de ruta: `list` es el operationId y `needs` los ids que esa operación pide antes. */
36
+ export interface IdSource {
37
+ list: string;
38
+ needs: string[];
39
+ }
40
+ /** Cómo se muestra un ítem al elegirlo: `label` es el campo legible y `current` el booleano que marca el actual. */
41
+ export interface ChoiceSpec {
42
+ label: string;
43
+ current?: string;
44
+ }
45
+ export declare const OPERATION_COMMANDS: readonly OperationCommand[];
46
+ /** Descripción de cada grupo de comandos (`agents.versions`), de los `tags` de la raíz del contrato. */
47
+ export declare const GROUP_DESCRIPTIONS: Record<string, string>;
48
+ /** Los `type` de tool que acepta `config.tools` del contrato (`agents.update`). */
49
+ export declare const TOOL_TYPES: readonly string[];