@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/mode.d.ts ADDED
@@ -0,0 +1,17 @@
1
+ import type { CliContext } from "./context.js";
2
+ import type { GlobalFlags } from "./session.js";
3
+ /** Cómo conversa la CLI: si lo corre un agente de IA, si puede preguntar, si imprime JSON y colores. */
4
+ export interface Mode {
5
+ isAgent: boolean;
6
+ agentName?: string;
7
+ nonInteractive: boolean;
8
+ json: boolean;
9
+ /** Colores en stdout (tablas y fichas). */
10
+ color: boolean;
11
+ /** Colores en stderr (errores y avisos): se decide aparte porque stderr puede ir a un archivo. */
12
+ stderrColor: boolean;
13
+ /** El comando lo prende cuando su stdout es el contenido (`agents run`): el error va a stderr aunque sea JSON. */
14
+ errorsToStderr?: boolean;
15
+ }
16
+ /** Resuelve el modo (C19, C20): no interactivo si se pide, o si es un agente sin terminal; `--no-non-interactive` lo apaga. El color de cada salida depende de si esa salida es una terminal (C10). */
17
+ export declare function resolveMode(ctx: CliContext, flags: GlobalFlags): Promise<Mode>;
package/dist/mode.js ADDED
@@ -0,0 +1,22 @@
1
+ import { determineAgent } from "@vercel/detect-agent";
2
+ /** Resuelve el modo (C19, C20): no interactivo si se pide, o si es un agente sin terminal; `--no-non-interactive` lo apaga. El color de cada salida depende de si esa salida es una terminal (C10). */
3
+ export async function resolveMode(ctx, flags) {
4
+ const agent = await determineAgent();
5
+ const isAgent = agent.isAgent;
6
+ // `--no-non-interactive` llega como `false` y gana a la detección de agente.
7
+ const nonInteractive = flags.nonInteractive ?? (isAgent && !ctx.stdinIsTTY);
8
+ const colorOff = flags.color === false ||
9
+ Boolean(ctx.env.NO_COLOR) ||
10
+ ctx.env.FORCE_COLOR === "0" ||
11
+ ctx.env.TERM === "dumb" ||
12
+ nonInteractive;
13
+ return {
14
+ isAgent,
15
+ agentName: agent.agent?.name,
16
+ nonInteractive,
17
+ json: Boolean(flags.json),
18
+ color: !colorOff && ctx.stdoutIsTTY,
19
+ stderrColor: !colorOff && (ctx.stderrIsTTY ?? ctx.stdoutIsTTY),
20
+ };
21
+ }
22
+ //# sourceMappingURL=mode.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mode.js","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAkBtD,uMAAuM;AACvM,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAe,EAAE,KAAkB;IACpE,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,6EAA6E;IAC7E,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5E,MAAM,QAAQ,GACb,KAAK,CAAC,KAAK,KAAK,KAAK;QACrB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,GAAG;QAC3B,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM;QACvB,cAAc,CAAC;IAChB,OAAO;QACN,OAAO;QACP,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI;QAC5B,cAAc;QACd,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QACzB,KAAK,EAAE,CAAC,QAAQ,IAAI,GAAG,CAAC,WAAW;QACnC,WAAW,EAAE,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC;KAC9D,CAAC;AACH,CAAC"}
@@ -0,0 +1,6 @@
1
+ import type { Resources } from "@laburen/delta-sdk/platform";
2
+ import type { OperationCommand } from "../generated/commands.js";
3
+ type Params = Record<string, unknown>;
4
+ /** Llama al método de la puerta que tiene el `operationId` de la operación; con `paginate` junta todas las páginas en `{ data }`. */
5
+ export declare function callOperation(platform: Resources, op: OperationCommand, positionals: string[], params: Params | undefined, paginate?: boolean): Promise<unknown>;
6
+ export {};
@@ -0,0 +1,17 @@
1
+ /** Llama al método de la puerta que tiene el `operationId` de la operación; con `paginate` junta todas las páginas en `{ data }`. */
2
+ export async function callOperation(platform, op, positionals, params, paginate = false) {
3
+ let node = platform;
4
+ for (const segment of op.id.split("."))
5
+ node = node[segment];
6
+ // Sin body ni query el método del SDK es (...ids, options?): no tiene slot de params.
7
+ const takesParams = op.hasBody || op.queryFlags.length > 0;
8
+ const args = takesParams ? [...positionals, params] : positionals;
9
+ const result = node(...args);
10
+ if (!paginate)
11
+ return result;
12
+ const data = [];
13
+ for await (const item of result)
14
+ data.push(item);
15
+ return { data };
16
+ }
17
+ //# sourceMappingURL=call.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"call.js","sourceRoot":"","sources":["../../src/operations/call.ts"],"names":[],"mappings":"AAKA,qIAAqI;AACrI,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,QAAmB,EACnB,EAAoB,EACpB,WAAqB,EACrB,MAA0B,EAC1B,QAAQ,GAAG,KAAK;IAEhB,IAAI,IAAI,GAAY,QAAQ,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,IAAI,GAAI,IAAgC,CAAC,OAAO,CAAC,CAAC;IAC1F,sFAAsF;IACtF,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IAClE,MAAM,MAAM,GAAI,IAAwC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClE,IAAI,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC7B,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAgC;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,EAAE,IAAI,EAAE,CAAC;AACjB,CAAC"}
@@ -0,0 +1,46 @@
1
+ import type { Resources } from "@laburen/delta-sdk/platform";
2
+ import type { Command } from "commander";
3
+ import type { CliContext } from "../context.js";
4
+ import type { OperationCommand } from "../generated/commands.js";
5
+ import type { Mode } from "../mode.js";
6
+ import type { Prompter } from "../prompter.js";
7
+ type Params = Record<string, unknown>;
8
+ /** Punto de extensión de un comando generado: suma params desde flags propios y avisa tras el resultado. */
9
+ export interface OperationExtension {
10
+ /** Params extra (antes de abrir la sesión) según los flags y el `--data` ya parseado; puede lanzar `CliError` de código 2. */
11
+ params?: (opts: Record<string, unknown>, ctx: CliContext, data: Params | undefined) => Promise<Params | undefined>;
12
+ /** Revisa los params ya armados antes de abrir la sesión: lanza `CliError` de código 2 o avisa por stderr. `prompting` dice si el asistente va a preguntar lo que falte. */
13
+ check?: (params: Params, ctx: CliContext, mode: Mode, prompting: boolean) => void;
14
+ /** Corre después de escribir el resultado. */
15
+ afterResult?: (ctx: CliContext, mode: Mode, result: unknown, ids: Record<string, string>) => void;
16
+ /** Preguntas de un `create` para lo que no vino por flag ni `--data` (C29); solo corre si se puede preguntar. */
17
+ wizard?: Wizard;
18
+ }
19
+ /** Lo que recibe un paso del asistente: completa `params` en el lugar con lo que contesta la persona. */
20
+ export interface WizardStep {
21
+ ctx: CliContext;
22
+ mode: Mode;
23
+ prompter: Prompter;
24
+ op: OperationCommand;
25
+ params: Params;
26
+ /** Campos ya preguntados en esta corrida aunque la respuesta no dejó nada en `params` (elegir ninguno). */
27
+ answered: Set<string>;
28
+ }
29
+ /** Asistente de un `create`: las preguntas sin API van antes de abrir la sesión y las que eligen de un `list`, después. */
30
+ export interface Wizard {
31
+ /** Campos obligatorios que el asistente completa si faltan: `buildParams` no los exige cuando se puede preguntar. */
32
+ asks: string[];
33
+ /** Corre en `prepare`, antes de abrir la sesión: textos, valores del contrato, carpetas. */
34
+ beforeSession?: (step: WizardStep) => Promise<void>;
35
+ /** Corre una sola vez con la sesión abierta, antes de llamar a la API: elegir de `skills.list` o `mcp.connections.list`. */
36
+ withSession?: (step: WizardStep & {
37
+ platform: Resources;
38
+ }) => Promise<void>;
39
+ }
40
+ /** La extensión enganchada a un comando generado, si tiene. */
41
+ export declare function extensionOf(command: Command): OperationExtension | undefined;
42
+ /** Devuelve el comando de `program` en `path` (p. ej. `["skills", "create"]`) o lanza si no existe. */
43
+ export declare function findCommand(program: Command, path: string[]): Command;
44
+ /** Engancha una extensión al comando generado de `path`; se suma a la que ya tenía (p. ej. `--dir` y el asistente). */
45
+ export declare function extendOperation(program: Command, path: string[], extension: OperationExtension): Command;
46
+ export {};
@@ -0,0 +1,29 @@
1
+ const extensions = new WeakMap();
2
+ /** La extensión enganchada a un comando generado, si tiene. */
3
+ export function extensionOf(command) {
4
+ return extensions.get(command);
5
+ }
6
+ /** Devuelve el comando de `program` en `path` (p. ej. `["skills", "create"]`) o lanza si no existe. */
7
+ export function findCommand(program, path) {
8
+ let node = program;
9
+ for (const name of path) {
10
+ const next = node.commands.find((c) => c.name() === name);
11
+ if (!next)
12
+ throw new Error(`Command not registered: ${path.join(" ")}`);
13
+ node = next;
14
+ }
15
+ return node;
16
+ }
17
+ /** Engancha una extensión al comando generado de `path`; se suma a la que ya tenía (p. ej. `--dir` y el asistente). */
18
+ export function extendOperation(program, path, extension) {
19
+ const command = findCommand(program, path);
20
+ const current = extensions.get(command);
21
+ for (const key of Object.keys(extension)) {
22
+ if (current?.[key] !== undefined) {
23
+ throw new Error(`Command ${path.join(" ")} already has an extension for ${key}`);
24
+ }
25
+ }
26
+ extensions.set(command, { ...current, ...extension });
27
+ return command;
28
+ }
29
+ //# sourceMappingURL=extensions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../src/operations/extensions.ts"],"names":[],"mappings":"AA8CA,MAAM,UAAU,GAAG,IAAI,OAAO,EAA+B,CAAC;AAE9D,+DAA+D;AAC/D,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC3C,OAAO,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE,IAAc;IAC3D,IAAI,IAAI,GAAG,OAAO,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxE,IAAI,GAAG,IAAI,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,eAAe,CAC9B,OAAgB,EAChB,IAAc,EACd,SAA6B;IAE7B,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAiC,EAAE,CAAC;QAC1E,IAAI,OAAO,EAAE,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;QAClF,CAAC;IACF,CAAC;IACD,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC;AAChB,CAAC"}
@@ -0,0 +1,7 @@
1
+ import type { CliContext } from "../context.js";
2
+ import { CliError } from "../errors.js";
3
+ /** Nombre con el que commander guarda un flag: `--change-message` es `changeMessage`. */
4
+ export declare function optionKey(flag: string): string;
5
+ export declare function invalidValue(flag: string, detail: string, command?: string[]): CliError;
6
+ /** Parsea el valor JSON de `flag` (texto, `@archivo` o `-` si `allowStdin`); falla con código 2 nombrando el flag. */
7
+ export declare function parseJson(ctx: CliContext, flag: string, value: string, allowStdin: boolean, command?: string[]): Promise<unknown>;
@@ -0,0 +1,50 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { resolve } from "node:path";
3
+ import { CliError, helpCommand } from "../errors.js";
4
+ /** Nombre con el que commander guarda un flag: `--change-message` es `changeMessage`. */
5
+ export function optionKey(flag) {
6
+ return flag.replace(/^--/, "").replace(/-(\w)/g, (_, letter) => letter.toUpperCase());
7
+ }
8
+ export function invalidValue(flag, detail, command) {
9
+ return new CliError("invalid_flag_value", `Invalid value for ${flag}: ${detail}`, 2, [
10
+ { command: helpCommand(command), when: "to see what the flag accepts" },
11
+ ]);
12
+ }
13
+ /** Lee stdin completo; si es una terminal avisa en stderr, porque si no la CLI parece colgada esperando. */
14
+ async function readStdin(ctx) {
15
+ if (ctx.stdinIsTTY)
16
+ ctx.stderr.write("Reading JSON from stdin (end with Ctrl-D)...\n");
17
+ const chunks = [];
18
+ for await (const chunk of ctx.stdin ?? process.stdin) {
19
+ chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
20
+ }
21
+ return Buffer.concat(chunks).toString("utf8");
22
+ }
23
+ /** Lee el texto de un valor JSON: `@archivo` lo lee de disco, `-` de stdin, si no es el valor mismo. */
24
+ async function readJsonText(ctx, flag, value, allowStdin, command) {
25
+ if (allowStdin && value === "-")
26
+ return readStdin(ctx);
27
+ if (!value.startsWith("@"))
28
+ return value;
29
+ const file = value.slice(1);
30
+ try {
31
+ return await readFile(resolve(ctx.cwd, file), "utf8");
32
+ }
33
+ catch {
34
+ throw invalidValue(flag, `cannot read file ${file}`, command);
35
+ }
36
+ }
37
+ /** Parsea el valor JSON de `flag` (texto, `@archivo` o `-` si `allowStdin`); falla con código 2 nombrando el flag. */
38
+ export async function parseJson(ctx, flag, value, allowStdin, command) {
39
+ const text = await readJsonText(ctx, flag, value, allowStdin, command);
40
+ try {
41
+ return JSON.parse(text);
42
+ }
43
+ catch {
44
+ const accepted = allowStdin
45
+ ? "expected JSON, a @file with JSON or - for stdin"
46
+ : "expected JSON or a @file with JSON";
47
+ throw invalidValue(flag, accepted, command);
48
+ }
49
+ }
50
+ //# sourceMappingURL=json-input.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json-input.js","sourceRoot":"","sources":["../../src/operations/json-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAErD,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAc,EAAE,OAAkB;IAC5E,OAAO,IAAI,QAAQ,CAAC,oBAAoB,EAAE,qBAAqB,IAAI,KAAK,MAAM,EAAE,EAAE,CAAC,EAAE;QACpF,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,8BAA8B,EAAE;KACvE,CAAC,CAAC;AACJ,CAAC;AAED,4GAA4G;AAC5G,KAAK,UAAU,SAAS,CAAC,GAAe;IACvC,IAAI,GAAG,CAAC,UAAU;QAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACvF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAgB,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,wGAAwG;AACxG,KAAK,UAAU,YAAY,CAC1B,GAAe,EACf,IAAY,EACZ,KAAa,EACb,UAAmB,EACnB,OAAkB;IAElB,IAAI,UAAU,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC;QACJ,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,YAAY,CAAC,IAAI,EAAE,oBAAoB,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;AACF,CAAC;AAED,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC9B,GAAe,EACf,IAAY,EACZ,KAAa,EACb,UAAmB,EACnB,OAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACvE,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,QAAQ,GAAG,UAAU;YAC1B,CAAC,CAAC,iDAAiD;YACnD,CAAC,CAAC,oCAAoC,CAAC;QACxC,MAAM,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;AACF,CAAC"}
@@ -0,0 +1,17 @@
1
+ import type { CliContext } from "../context.js";
2
+ import type { OperationCommand } from "../generated/commands.js";
3
+ type Params = Record<string, unknown>;
4
+ /** Los ids de la ruta que escribió la persona y los que faltan, para que el `next` los muestre (Q4). */
5
+ export interface MissingIds {
6
+ given: string[];
7
+ missing: string[];
8
+ }
9
+ /** Completa sin preguntar los obligatorios con un solo valor posible (`harness_type: mastra`, C29), salvo los de `skip`. */
10
+ export declare function fillSingleValues(op: OperationCommand, params: Params, skip?: string[]): void;
11
+ /** Arma el `params` del método de la puerta desde `--data`, el `preset` y los flags; los flags pisan a `--data`. Falla con código 2 antes de llamar a la API. */
12
+ export declare function buildParams(op: OperationCommand, opts: Record<string, unknown>, ctx: CliContext,
13
+ /** Params extra que se suman según lo que trajo `--data` (p. ej. `files` desde --dir). */
14
+ preset?: (data: Params | undefined) => Promise<Params | undefined>,
15
+ /** Campos obligatorios que no se exigen porque se van a preguntar (`from`/`to` de un compare). */
16
+ asked?: string[], ids?: MissingIds): Promise<Params | undefined>;
17
+ export {};
@@ -0,0 +1,106 @@
1
+ import { CliError } from "../errors.js";
2
+ import { commandText, invocationOf } from "../invocation.js";
3
+ import { argsWithIds } from "../pickers.js";
4
+ import { invalidValue, optionKey, parseJson } from "./json-input.js";
5
+ async function flagValue(ctx, op, spec, raw) {
6
+ // Regla de Stainless: solo la palabra `null` exacta, y solo si el campo acepta null; si no, es texto.
7
+ if (spec.nullable && raw === "null")
8
+ return null;
9
+ if (spec.type === "json")
10
+ return parseJson(ctx, spec.flag, String(raw), false, op.path);
11
+ if (spec.type === "number") {
12
+ const n = Number(raw);
13
+ if (typeof raw === "boolean" || String(raw).trim() === "" || Number.isNaN(n)) {
14
+ throw invalidValue(spec.flag, "expected a number", op.path);
15
+ }
16
+ return n;
17
+ }
18
+ return raw;
19
+ }
20
+ /** Falla con código 2 si un campo con valores enumerados en el contrato trae otro (M8), antes de llamar a la API. */
21
+ function checkEnumValues(op, params) {
22
+ for (const spec of [...op.queryFlags, ...op.bodyFlags]) {
23
+ const value = params[spec.name];
24
+ if (!spec.values || value === undefined)
25
+ continue;
26
+ const allowed = spec.values;
27
+ const ok = spec.type === "json"
28
+ ? Array.isArray(value) && value.every((v) => typeof v === "string" && allowed.includes(v))
29
+ : typeof value === "string" && allowed.includes(value);
30
+ if (!ok) {
31
+ const expected = spec.type === "json" ? "a JSON list of" : "one of";
32
+ throw invalidValue(spec.flag, `expected ${expected} ${allowed.join(", ")}`, op.path);
33
+ }
34
+ }
35
+ }
36
+ /** El comando que se corrió con los ids que faltan como `<nombre>` y los flags que faltan agregados; sin invocación guardada, la ruta con sus posicionales. */
37
+ function commandWithFlags(ctx, op, flags, ids = { given: [], missing: [] }) {
38
+ const base = invocationOf(ctx).args.length > 0
39
+ ? commandText(argsWithIds(ctx, op, ids.given, ids.missing.map((name) => `<${name}>`)))
40
+ : ["laburen", ...op.path, ...op.positionals.map((p) => `<${p}>`)].join(" ");
41
+ return [base, ...flags.map((f) => `${f} <value>`)].join(" ");
42
+ }
43
+ /** Completa sin preguntar los obligatorios con un solo valor posible (`harness_type: mastra`, C29), salvo los de `skip`. */
44
+ export function fillSingleValues(op, params, skip = []) {
45
+ for (const spec of op.bodyFlags) {
46
+ if (spec.required && spec.values?.length === 1 && params[spec.name] === undefined) {
47
+ if (!skip.includes(spec.name))
48
+ params[spec.name] = spec.values[0];
49
+ }
50
+ }
51
+ }
52
+ /** Arma el `params` del método de la puerta desde `--data`, el `preset` y los flags; los flags pisan a `--data`. Falla con código 2 antes de llamar a la API. */
53
+ export async function buildParams(op, opts, ctx,
54
+ /** Params extra que se suman según lo que trajo `--data` (p. ej. `files` desde --dir). */
55
+ preset,
56
+ /** Campos obligatorios que no se exigen porque se van a preguntar (`from`/`to` de un compare). */
57
+ asked = [], ids) {
58
+ const specs = [...op.queryFlags, ...op.bodyFlags];
59
+ if (!op.hasBody && specs.length === 0)
60
+ return undefined;
61
+ let params = {};
62
+ let data;
63
+ if (op.hasBody && typeof opts.data === "string") {
64
+ const parsed = await parseJson(ctx, "--data", opts.data, true, op.path);
65
+ if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
66
+ throw invalidValue("--data", "expected a JSON object", op.path);
67
+ }
68
+ data = parsed;
69
+ params = { ...data };
70
+ }
71
+ // `preset` (p. ej. `files` desde --dir) va después de --data y antes de los flags, que lo pisan.
72
+ const extra = await preset?.(data);
73
+ if (extra)
74
+ params = { ...params, ...extra };
75
+ for (const spec of specs) {
76
+ const raw = opts[optionKey(spec.flag)];
77
+ if (raw !== undefined)
78
+ params[spec.name] = await flagValue(ctx, op, spec, raw);
79
+ }
80
+ checkEnumValues(op, params);
81
+ // Sin terminal también (Q11); lo que va a preguntar el asistente lo completa él, en su orden.
82
+ fillSingleValues(op, params, asked);
83
+ const missing = specs.filter((spec) => spec.required && params[spec.name] === undefined && !asked.includes(spec.name));
84
+ if (missing.length > 0) {
85
+ const flags = missing.map((spec) => spec.flag);
86
+ const plural = flags.length > 1 ? "options" : "option";
87
+ const next = [
88
+ {
89
+ command: commandWithFlags(ctx, op, flags, ids),
90
+ when: op.hasBody
91
+ ? "to set them (or send the whole body with --data)"
92
+ : "to set the required options",
93
+ },
94
+ ];
95
+ // Los archivos de una skill casi siempre salen de una carpeta (`--dir`), no de un JSON escrito a mano.
96
+ if (op.id === "skills.create" && flags.includes("--files")) {
97
+ next.push({
98
+ command: `${commandWithFlags(ctx, op, flags.filter((flag) => flag !== "--files"), ids)} --dir <path>`,
99
+ when: "to read the skill files from a folder",
100
+ });
101
+ }
102
+ throw new CliError("missing_required", `Missing required ${plural} ${flags.join(", ")}.`, 2, next);
103
+ }
104
+ return params;
105
+ }
106
+ //# sourceMappingURL=params.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/operations/params.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import { type Command } from "commander";
2
+ import type { CliContext } from "../context.js";
3
+ import type { Prompter } from "../prompter.js";
4
+ /** Busca el subcomando `name` de `parent` o lo crea; los grupos (`agents`, `versions`) se arman así. */
5
+ export declare function groupFor(parent: Command, name: string, description?: string): Command;
6
+ /** Registra en `program` un comando por cada operación generada; la acción llama a la puerta. */
7
+ export declare function registerOperationCommands(program: Command, ctx: CliContext, deps: {
8
+ fetch?: typeof fetch;
9
+ prompter: Prompter;
10
+ }): void;
@@ -0,0 +1,102 @@
1
+ import { Option } from "commander";
2
+ import { setCompletionValues } from "../completion/tree.js";
3
+ import { GROUP_DESCRIPTIONS, OPERATION_COMMANDS } from "../generated/commands.js";
4
+ import { pickableIds } from "../pickers.js";
5
+ import { resolveApiUrl } from "../session.js";
6
+ import { runOperation } from "./run-operation.js";
7
+ import { commandSchema } from "./schema-flag.js";
8
+ import { hasConfigBody, skeletonDocument, toolTypesOf } from "./skeleton.js";
9
+ /** Busca el subcomando `name` de `parent` o lo crea; los grupos (`agents`, `versions`) se arman así. */
10
+ export function groupFor(parent, name, description) {
11
+ const existing = parent.commands.find((c) => c.name() === name);
12
+ if (existing)
13
+ return existing;
14
+ // Sin acción propia: sin subcomando commander imprime la ayuda en stderr y `main` sale con 2, y un
15
+ // subcomando que no existe da `unknown command`.
16
+ const group = parent.command(name);
17
+ if (description)
18
+ group.description(description);
19
+ return group;
20
+ }
21
+ /** Texto de ayuda de un flag con lo que dice el contrato: qué es, si es obligatorio y los valores que acepta. */
22
+ function flagHelp(spec) {
23
+ // Obligatorio con un solo valor posible: la CLI lo completa sola (C29), así que no se pide (M8).
24
+ if (spec.required && spec.values?.length === 1) {
25
+ return [spec.description, `(default: ${spec.values[0]})`].filter(Boolean).join(" ");
26
+ }
27
+ const parts = [];
28
+ if (spec.description)
29
+ parts.push(spec.description);
30
+ if (spec.required)
31
+ parts.push("(required)");
32
+ if (spec.values) {
33
+ const label = spec.type === "json" ? "list of" : "one of";
34
+ parts.push(`${label}: ${spec.values.join(", ")}`);
35
+ }
36
+ return parts.join(" ");
37
+ }
38
+ function addFlag(command, spec) {
39
+ if (spec.type === "boolean") {
40
+ command.addOption(new Option(spec.flag, flagHelp(spec)));
41
+ command.addOption(new Option(spec.flag.replace(/^--/, "--no-")));
42
+ }
43
+ else {
44
+ const placeholder = spec.type === "json" ? "<json|@file>" : `<${spec.type}>`;
45
+ const option = new Option(`${spec.flag} ${placeholder}`, flagHelp(spec));
46
+ // Los valores del contrato solo alimentan el autocompletado; la API sigue validando.
47
+ if (spec.values && spec.type === "string")
48
+ setCompletionValues(option, spec.values);
49
+ command.addOption(option);
50
+ }
51
+ }
52
+ /** Registra en `program` un comando por cada operación generada; la acción llama a la puerta. */
53
+ export function registerOperationCommands(program, ctx, deps) {
54
+ for (const op of OPERATION_COMMANDS) {
55
+ let parent = program;
56
+ op.path.slice(0, -1).forEach((segment, index) => {
57
+ // El tag de un grupo es el camino hasta él unido por `.` (`agents.versions`).
58
+ const tag = op.path.slice(0, index + 1).join(".");
59
+ parent = groupFor(parent, segment, GROUP_DESCRIPTIONS[tag]);
60
+ });
61
+ const command = parent.command(op.path.at(-1)).description(op.summary);
62
+ // Un id con `list` es opcional en commander: si falta se elige de la lista o se avisa con `choices` (C28).
63
+ const pickable = pickableIds(op);
64
+ for (const name of op.positionals) {
65
+ command.argument(pickable.has(name) ? `[${name}]` : `<${name}>`);
66
+ }
67
+ for (const spec of [...op.queryFlags, ...op.bodyFlags])
68
+ addFlag(command, spec);
69
+ if (op.hasBody) {
70
+ command.option("--data <json|@file|->", "whole request body as JSON, @file or - for stdin");
71
+ }
72
+ if (op.hasBody) {
73
+ command.option("--schema", "print the JSON Schema of the request and response and exit");
74
+ }
75
+ if (hasConfigBody(op)) {
76
+ command.option("--skeleton", "print an example config with the required fields and the published defaults, and exit");
77
+ }
78
+ if (op.paginated)
79
+ command.option("--paginate", "fetch every page instead of just the first");
80
+ if (op.destructive)
81
+ command.option("-y, --yes", "skip the confirmation");
82
+ command.action((...args) => {
83
+ // Sin sesión ni llamada a la API: solo imprime lo que dice el contrato (E8).
84
+ if (args.at(-2).schema) {
85
+ ctx.stdout.write(`${JSON.stringify(commandSchema(op), null, 2)}\n`);
86
+ return;
87
+ }
88
+ // Igual: sin sesión ni llamada, y va a stdout aunque haya --json o no haya TTY (no es una pregunta) (E9).
89
+ if (args.at(-2).skeleton) {
90
+ const flags = args.at(-1).optsWithGlobals();
91
+ ctx.stdout.write(`${JSON.stringify(skeletonDocument(op, resolveApiUrl(ctx, flags)), null, 2)}\n`);
92
+ const toolTypes = toolTypesOf(op);
93
+ if (toolTypes.length > 0) {
94
+ ctx.stderr.write(`tool types: ${toolTypes.join(", ")} \u2192 see --schema\n`);
95
+ }
96
+ return;
97
+ }
98
+ return runOperation(ctx, op, deps, args);
99
+ });
100
+ }
101
+ }
102
+ //# sourceMappingURL=register.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/operations/register.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { CliContext } from "../context.js";
2
+ import type { OperationCommand } from "../generated/commands.js";
3
+ import { type Prompter } from "../prompter.js";
4
+ /** Corre un comando generado: elige los ids que faltan, arma los params, confirma lo que borra, llama a la puerta y escribe el resultado. */
5
+ export declare function runOperation(ctx: CliContext, op: OperationCommand, deps: {
6
+ fetch?: typeof fetch;
7
+ prompter: Prompter;
8
+ }, args: unknown[]): Promise<void>;