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

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 +305 -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 +56 -0
  91. package/dist/errors.js +452 -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 +66 -0
  100. package/dist/invocation.js +343 -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 +132 -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 +452 -0
  137. package/dist/output.js.map +1 -0
  138. package/dist/pickers.d.ts +51 -0
  139. package/dist/pickers.js +283 -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 +178 -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 +187 -0
  157. package/docs/references/auth-and-organizations.md +72 -0
  158. package/docs/references/commands.md +247 -0
  159. package/docs/references/output-and-errors.md +105 -0
  160. package/package.json +39 -5
@@ -0,0 +1,193 @@
1
+ import { dirname, join } from "node:path";
2
+ import { deleteLink, findLink, LINK_FILE, locateLink, writeLink } from "../config/link.js";
3
+ import { readSettings, writeSettings } from "../config/settings.js";
4
+ import { CliError } from "../errors.js";
5
+ import { commandText, invocationOf, suggestedCommand } from "../invocation.js";
6
+ import { escapeControl, notice, writeResult } from "../output.js";
7
+ import { choicesError } from "../pickers.js";
8
+ import { run, runStandalone } from "../program.js";
9
+ import { canPrompt, chooseOne } from "../prompter.js";
10
+ /** `orgs list` no usa `--org`: si el comando que falló lo llevaba (con una organización mala), no se arrastra al `next`. */
11
+ const LIST_NEXT = {
12
+ command: "laburen orgs list",
13
+ when: "to see the organizations you can use",
14
+ omitGlobals: ["--org"],
15
+ };
16
+ /** Trae todas las organizaciones de quien llama, recorriendo las páginas con la puerta. */
17
+ async function listOrganizations(session) {
18
+ const orgs = [];
19
+ for await (const org of session.platform.me.organizations.list()) {
20
+ orgs.push({ id: org.id, name: org.name, role: org.role });
21
+ }
22
+ return orgs;
23
+ }
24
+ /**
25
+ * La organización que se marca como actual: la resuelta, o si no hay, la guardada con `orgs switch`. En modo no
26
+ * interactivo la guardada no se manda (C20), pero igual se marca: es lo que la persona eligió (M11).
27
+ */
28
+ async function currentOrganization(session) {
29
+ return session.organization ?? (await readSettings(session.configDir)).organization_id;
30
+ }
31
+ /** Devuelve `id` si es una organización de la persona; si no, falla con código 1 (un recurso que no existe, como en la API) y `next orgs list`. */
32
+ function requireMember(orgs, id) {
33
+ const found = orgs.find((o) => o.id === id);
34
+ if (!found) {
35
+ throw new CliError("organization_not_found", `You are not a member of organization ${id}.`, 1, [
36
+ LIST_NEXT,
37
+ ]);
38
+ }
39
+ return found;
40
+ }
41
+ /** Pregunta con un `select` cuál organización usar (C31); con una sola la toma y avisa cuál. */
42
+ async function pickOrganization(orgs, current, prompter, ctx, mode) {
43
+ if (orgs.length === 0) {
44
+ throw new CliError("organization_not_found", "You do not belong to any organization.", 1);
45
+ }
46
+ const id = await chooseOne(ctx, mode, prompter, {
47
+ message: "Switch to organization",
48
+ noun: "organization",
49
+ choices: orgs.map((o) => ({
50
+ value: o.id,
51
+ label: o.name,
52
+ hint: o.id,
53
+ current: o.id === current,
54
+ })),
55
+ });
56
+ return requireMember(orgs, id);
57
+ }
58
+ /** `orgs switch` sin id y sin poder preguntar: `choices` con un `next` por organización para que elija la persona (Q15). */
59
+ function missingOrganization(ctx, orgs, current) {
60
+ if (orgs.length === 0) {
61
+ return new CliError("organization_not_found", "You do not belong to any organization.", 1);
62
+ }
63
+ const { args } = invocationOf(ctx);
64
+ const at = args.indexOf("switch");
65
+ const choices = orgs.map((o) => o.id === current ? { id: o.id, name: o.name, current: true } : { id: o.id, name: o.name });
66
+ return choicesError("organization_id", choices, false, (id) => commandText(at === -1 ? ["orgs", "switch", id] : [...args.slice(0, at + 1), id, ...args.slice(at + 1)]));
67
+ }
68
+ /** Dónde escribe `link`: en la carpeta del link.json roto que usa la resolución (aunque sea de un padre), si no en `cwd` (Q14). */
69
+ async function linkFolder(cwd) {
70
+ let located;
71
+ try {
72
+ located = await locateLink(cwd);
73
+ }
74
+ catch (err) {
75
+ if (!(err instanceof CliError) || err.reason !== "invalid_link")
76
+ throw err;
77
+ // Un `.laburen` que es archivo en una carpeta de arriba no impide escribir acá; si es el de `cwd`, `writeLink` falla.
78
+ return cwd;
79
+ }
80
+ if (!located)
81
+ return cwd;
82
+ try {
83
+ await findLink(cwd);
84
+ return cwd;
85
+ }
86
+ catch (err) {
87
+ if (!(err instanceof CliError) || err.reason !== "invalid_link")
88
+ throw err;
89
+ // `<carpeta>/.laburen/link.json` → `<carpeta>`.
90
+ return dirname(dirname(located));
91
+ }
92
+ }
93
+ /** Registra `orgs list`, `orgs switch [id]`, `link` y `unlink`. */
94
+ export function registerOrgCommands(program, ctx, deps) {
95
+ const { prompter } = deps;
96
+ // Ninguno manda el header de organización: se listan las organizaciones de quien llama (C20).
97
+ const session = { fetch: deps.fetch, omitOrganizationHeader: true };
98
+ // `orgs list` y `orgs switch` solo usan la organización resuelta para marcar la actual: un link.json roto o
99
+ // un mismatch no los frena (son justo los comandos para arreglarlo).
100
+ const soft = { ...session, softOrganization: true };
101
+ const orgs = program.command("orgs").description("List and choose organizations");
102
+ orgs
103
+ .command("list")
104
+ .description("List your organizations; the current one is marked")
105
+ .action(async (_opts, self) => {
106
+ const flags = self.optsWithGlobals();
107
+ await run(ctx, async (s, mode) => {
108
+ const all = await listOrganizations(s);
109
+ const current = await currentOrganization(s);
110
+ // Con --json va la lista tal cual y `current` booleano; para humanos, una columna con `*`.
111
+ const rows = all.map((o) => mode.json
112
+ ? { id: o.id, name: o.name, role: o.role, current: o.id === current }
113
+ : {
114
+ current: o.id === current ? "*" : "",
115
+ id: o.id,
116
+ name: o.name,
117
+ role: o.role ?? "",
118
+ });
119
+ writeResult(ctx, mode, rows, "list");
120
+ }, flags, soft);
121
+ });
122
+ orgs
123
+ .command("switch [id]")
124
+ .description("Save the organization to use from now on")
125
+ .action(async (id, _opts, self) => {
126
+ const flags = self.optsWithGlobals();
127
+ await run(ctx, async (s, mode) => {
128
+ const all = await listOrganizations(s);
129
+ const current = await currentOrganization(s);
130
+ if (!id && !canPrompt(ctx, mode))
131
+ throw missingOrganization(ctx, all, current);
132
+ const chosen = id
133
+ ? requireMember(all, id)
134
+ : await pickOrganization(all, current, prompter, ctx, mode);
135
+ await writeSettings(s.configDir, { organization_id: chosen.id });
136
+ const shown = `${escapeControl(chosen.name)} (${escapeControl(chosen.id)})`;
137
+ if (mode.nonInteractive) {
138
+ // Sin "Now using": en este modo la guardada no se usa (C20, M11).
139
+ const link = escapeControl(suggestedCommand(ctx, commandText(["link", "--org", chosen.id])));
140
+ notice(ctx, mode, `Saved ${shown}. Non-interactive runs ignore the saved organization: use --org ${escapeControl(chosen.id)} or ${link}.`);
141
+ }
142
+ else {
143
+ notice(ctx, mode, `Now using ${shown}.`);
144
+ }
145
+ if (mode.json)
146
+ writeResult(ctx, mode, { status: "ok", organization_id: chosen.id }, "item");
147
+ }, flags, soft);
148
+ });
149
+ program
150
+ .command("link")
151
+ .description(`Write ${LINK_FILE} so this folder uses one organization (commit it)`)
152
+ .action(async (_opts, self) => {
153
+ // `--org` es el global del programa: es la organización a vincular.
154
+ const flags = self.optsWithGlobals();
155
+ await run(ctx, async (s, mode) => {
156
+ const target = flags.org || s.organization;
157
+ if (!target) {
158
+ throw new CliError("missing_arguments", "No organization to link.", 2, [
159
+ LIST_NEXT,
160
+ { command: "laburen link --org <id>", when: "to link this folder to one of them" },
161
+ ]);
162
+ }
163
+ const chosen = requireMember(await listOrganizations(s), target);
164
+ const folder = await linkFolder(ctx.cwd);
165
+ await writeLink(folder, { organization_id: chosen.id });
166
+ const where = folder === ctx.cwd ? LINK_FILE : join(folder, LINK_FILE);
167
+ notice(ctx, mode, `Linked this folder to ${escapeControl(chosen.name)} (${escapeControl(chosen.id)}) in ${escapeControl(where)}.`);
168
+ if (mode.json)
169
+ writeResult(ctx, mode, { status: "ok", organization_id: chosen.id }, "item");
170
+ },
171
+ // Con `--org` explícito no se compara contra el link.json que se va a reemplazar.
172
+ { ...flags, org: undefined },
173
+ // Con `--org` se reescribe el archivo sin leerlo (uno roto no impide arreglarlo); sin `--org`
174
+ // vale el orden de C17: el link de la carpeta va antes que la organización guardada.
175
+ { ...session, ignoreLink: Boolean(flags.org) });
176
+ });
177
+ program
178
+ .command("unlink")
179
+ .description(`Delete the ${LINK_FILE} this folder uses (this one or a parent's)`)
180
+ .action(async (_opts, self) => {
181
+ const flags = self.optsWithGlobals();
182
+ await runStandalone(ctx, flags, async (mode) => {
183
+ // Borra el mismo archivo que usa la resolución (sube por las carpetas), esté sano o roto.
184
+ const path = await locateLink(ctx.cwd);
185
+ if (path)
186
+ await deleteLink(path);
187
+ notice(ctx, mode, path ? `Removed ${path}.` : "No linked folder found.");
188
+ if (mode.json)
189
+ writeResult(ctx, mode, { status: "ok" }, "item");
190
+ });
191
+ });
192
+ }
193
+ //# sourceMappingURL=orgs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"orgs.js","sourceRoot":"","sources":["../../src/commands/orgs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import type { Command } from "commander";
2
+ import type { CliContext } from "../context.js";
3
+ /** Lo que se leyó de la carpeta: `files` para la API y lo que se salteó, con el motivo, para avisar. */
4
+ export interface SkillDir {
5
+ files: Record<string, string>;
6
+ skipped: {
7
+ path: string;
8
+ reason: "hidden" | "symlink";
9
+ }[];
10
+ /** Archivos que no son texto UTF-8 (byte NUL o UTF-8 inválido): no se suben. */
11
+ binary: string[];
12
+ }
13
+ /** Lee una carpeta: `files` con `{ ruta relativa con /: contenido UTF-8 }`, sin `.git`, `node_modules`, ocultos ni symlinks. */
14
+ export declare function readSkillDir(dir: string): Promise<SkillDir>;
15
+ /** Lee `dir` (relativa a `cwd`) como `files` de una skill; falla con código 2 nombrando `source` (`--dir` o la pregunta) si no se puede leer, tiene binarios o está vacía. */
16
+ export declare function readSkillFiles(ctx: CliContext, dir: string, source: string, command: string[]): Promise<Record<string, string>>;
17
+ /** Suma `--dir <carpeta>` a `skills create` y `skills versions create`: los archivos salen de la carpeta. */
18
+ export declare function registerSkillDirOption(program: Command, _ctx: CliContext): void;
@@ -0,0 +1,101 @@
1
+ import { readdir, readFile } from "node:fs/promises";
2
+ import { join, resolve } from "node:path";
3
+ import { CliError, helpCommand } from "../errors.js";
4
+ import { extendOperation } from "../operations.js";
5
+ const IGNORED = new Set([".git", "node_modules"]);
6
+ const utf8 = new TextDecoder("utf-8", { fatal: true });
7
+ /** Devuelve el texto del archivo si es UTF-8 válido sin byte NUL; si no, null. */
8
+ function asText(bytes) {
9
+ if (bytes.includes(0))
10
+ return null;
11
+ try {
12
+ return utf8.decode(bytes);
13
+ }
14
+ catch {
15
+ return null;
16
+ }
17
+ }
18
+ /** Recorre `root` y suma cada archivo con su ruta relativa separada por `/`; saltea ocultos y symlinks. */
19
+ async function walk(root, relative, out) {
20
+ const entries = await readdir(join(root, relative), { withFileTypes: true });
21
+ for (const entry of entries) {
22
+ if (IGNORED.has(entry.name))
23
+ continue;
24
+ const path = relative ? `${relative}/${entry.name}` : entry.name;
25
+ if (entry.name.startsWith("."))
26
+ out.skipped.push({ path, reason: "hidden" });
27
+ else if (entry.isSymbolicLink())
28
+ out.skipped.push({ path, reason: "symlink" });
29
+ else if (entry.isDirectory())
30
+ await walk(root, path, out);
31
+ else if (entry.isFile()) {
32
+ const text = asText(await readFile(join(root, path)));
33
+ if (text === null)
34
+ out.binary.push(path);
35
+ else
36
+ out.files[path] = text;
37
+ }
38
+ }
39
+ }
40
+ /** Lee una carpeta: `files` con `{ ruta relativa con /: contenido UTF-8 }`, sin `.git`, `node_modules`, ocultos ni symlinks. */
41
+ export async function readSkillDir(dir) {
42
+ const out = { files: {}, skipped: [], binary: [] };
43
+ await walk(dir, "", out);
44
+ return out;
45
+ }
46
+ function dirError(message, command) {
47
+ return new CliError("invalid_flag_value", message, 2, [
48
+ { command: helpCommand(command), when: "to see how to send the skill files" },
49
+ ]);
50
+ }
51
+ const SKIP_REASON = {
52
+ hidden: "hidden files are not uploaded",
53
+ symlink: "symbolic links are not followed",
54
+ };
55
+ /** Lee `dir` (relativa a `cwd`) como `files` de una skill; falla con código 2 nombrando `source` (`--dir` o la pregunta) si no se puede leer, tiene binarios o está vacía. */
56
+ export async function readSkillFiles(ctx, dir, source, command) {
57
+ let read;
58
+ try {
59
+ read = await readSkillDir(resolve(ctx.cwd, dir));
60
+ }
61
+ catch {
62
+ throw dirError(`Invalid value for ${source}: cannot read folder ${dir}`, command);
63
+ }
64
+ if (read.binary.length > 0) {
65
+ throw dirError(`Invalid value for ${source}: not a UTF-8 text file (binary or invalid UTF-8): ${read.binary.join(", ")}. Remove it from the folder.`, command);
66
+ }
67
+ for (const { path, reason } of read.skipped) {
68
+ ctx.stderr.write(`Skipped ${path}: ${SKIP_REASON[reason]}.\n`);
69
+ }
70
+ if (Object.keys(read.files).length === 0) {
71
+ throw dirError(`Invalid value for ${source}: ${dir} has no files`, command);
72
+ }
73
+ return read.files;
74
+ }
75
+ /** Lee la carpeta de `--dir` como `files`; falla con código 2 si choca con `--files` o un `--data` con files, o no se puede leer. */
76
+ async function filesFromDir(ctx, opts, data, command) {
77
+ if (typeof opts.dir !== "string")
78
+ return undefined;
79
+ // Un `--data` sin files (nombre, descripción) se combina con la carpeta (M16).
80
+ if (opts.files !== undefined || data?.files !== undefined) {
81
+ throw dirError("Use --dir or --files (or files in --data), not both: they both set the skill files.", command);
82
+ }
83
+ return { files: await readSkillFiles(ctx, opts.dir, "--dir", command) };
84
+ }
85
+ /** Suma `--dir <carpeta>` a `skills create` y `skills versions create`: los archivos salen de la carpeta. */
86
+ export function registerSkillDirOption(program, _ctx) {
87
+ for (const path of [
88
+ ["skills", "create"],
89
+ ["skills", "versions", "create"],
90
+ ]) {
91
+ const command = extendOperation(program, path, {
92
+ params: (opts, ctx, data) => filesFromDir(ctx, opts, data, path),
93
+ });
94
+ command.option("--dir <folder>", "read the skill files from a folder instead of --files/--data (UTF-8 text only; hidden files and symlinks are skipped)");
95
+ // `--files` es obligatorio en el contrato, pero `--dir` lo reemplaza: la ayuda no lo marca como "(required)" (C18).
96
+ const files = command.options.find((o) => o.long === "--files");
97
+ if (files)
98
+ files.description = files.description.replace("(required)", "(or --dir)");
99
+ }
100
+ }
101
+ //# sourceMappingURL=skill-dir.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-dir.js","sourceRoot":"","sources":["../../src/commands/skill-dir.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { Command } from "commander";
2
+ import type { CliContext } from "../context.js";
3
+ /** Después de `tokens create` (sin --json) avisa en stderr que el `value` no se vuelve a mostrar. */
4
+ export declare function registerTokenNotice(program: Command, _ctx: CliContext): void;
@@ -0,0 +1,13 @@
1
+ import { extendOperation } from "../operations.js";
2
+ import { notice } from "../output.js";
3
+ /** Después de `tokens create` (sin --json) avisa en stderr que el `value` no se vuelve a mostrar. */
4
+ export function registerTokenNotice(program, _ctx) {
5
+ extendOperation(program, ["tokens", "create"], {
6
+ afterResult: (ctx, mode) => {
7
+ if (mode.json)
8
+ return;
9
+ notice(ctx, mode, "Save the token `value` now: it will not be shown again.");
10
+ },
11
+ });
12
+ }
13
+ //# sourceMappingURL=token-notice.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"token-notice.js","sourceRoot":"","sources":["../../src/commands/token-notice.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,qGAAqG;AACrG,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,IAAgB;IACrE,eAAe,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE;QAC9C,WAAW,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YAC1B,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO;YACtB,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,yDAAyD,CAAC,CAAC;QAC9E,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,8 @@
1
+ import type { Command } from "commander";
2
+ import type { CliContext } from "../context.js";
3
+ /** Piezas reemplazables en tests: el `fetch` de la puerta. */
4
+ export interface WhoamiDeps {
5
+ fetch?: typeof fetch;
6
+ }
7
+ /** Registra `whoami`: quién llama, con qué organización y qué credencial (alias amable de `me get`). */
8
+ export declare function registerWhoamiCommand(program: Command, ctx: CliContext, deps: WhoamiDeps): void;
@@ -0,0 +1,38 @@
1
+ import { escapeControl, writeResult } from "../output.js";
2
+ import { run } from "../program.js";
3
+ /** Arma las líneas `clave valor` para humanos, con las claves alineadas. */
4
+ function renderRows(rows) {
5
+ const width = Math.max(...rows.map(([key]) => key.length));
6
+ return rows.map(([key, value]) => `${key.padEnd(width)} ${escapeControl(value)}`).join("\n");
7
+ }
8
+ /** Registra `whoami`: quién llama, con qué organización y qué credencial (alias amable de `me get`). */
9
+ export function registerWhoamiCommand(program, ctx, deps) {
10
+ program
11
+ .command("whoami")
12
+ .description("Show who you are, the organization in use and your credential")
13
+ .action(async (_opts, self) => {
14
+ const flags = self.optsWithGlobals();
15
+ await run(ctx, async (s, mode) => {
16
+ const me = await s.platform.me.get();
17
+ if (mode.json) {
18
+ writeResult(ctx, mode, me, "item");
19
+ return;
20
+ }
21
+ const { user, organization, credential } = me;
22
+ const person = user
23
+ ? `${user.name ?? "(no name)"}${user.email ? ` <${user.email}>` : ""} (${user.id})`
24
+ : "none (organization credential)";
25
+ const org = organization
26
+ ? `${organization.name} (${organization.id})`
27
+ : "none — pass --org";
28
+ ctx.stdout.write(`${renderRows([
29
+ ["user", person],
30
+ ["organization", org],
31
+ ["credential kind", credential.kind],
32
+ ["permissions", credential.permissions.join(", ")],
33
+ ["expires", credential.expires_at ?? "never"],
34
+ ])}\n`);
35
+ }, flags, { fetch: deps.fetch });
36
+ });
37
+ }
38
+ //# sourceMappingURL=whoami.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../src/commands/whoami.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAQpC,6EAA6E;AAC7E,SAAS,UAAU,CAAC,IAAwB;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/F,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,GAAe,EAAE,IAAgB;IACxF,OAAO;SACL,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+DAA+D,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,KAAc,EAAE,IAAa,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,EAAiB,CAAC;QACpD,MAAM,GAAG,CACR,GAAG,EACH,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;YACjB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;gBACnC,OAAO;YACR,CAAC;YACD,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,IAAI;gBAClB,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,GAAG;gBACnF,CAAC,CAAC,gCAAgC,CAAC;YACpC,MAAM,GAAG,GAAG,YAAY;gBACvB,CAAC,CAAC,GAAG,YAAY,CAAC,IAAI,KAAK,YAAY,CAAC,EAAE,GAAG;gBAC7C,CAAC,CAAC,mBAAmB,CAAC;YACvB,GAAG,CAAC,MAAM,CAAC,KAAK,CACf,GAAG,UAAU,CAAC;gBACb,CAAC,MAAM,EAAE,MAAM,CAAC;gBAChB,CAAC,cAAc,EAAE,GAAG,CAAC;gBACrB,CAAC,iBAAiB,EAAE,UAAU,CAAC,IAAI,CAAC;gBACpC,CAAC,aAAa,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClD,CAAC,SAAS,EAAE,UAAU,CAAC,UAAU,IAAI,OAAO,CAAC;aAC7C,CAAC,IAAI,CACN,CAAC;QACH,CAAC,EACD,KAAK,EACL,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CACrB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Command } from "commander";
2
+ import type { CliContext } from "../context.js";
3
+ /** Engancha los asistentes de `agents create`, `agents versions create`, `tokens create`, `skills create` y `mcp connections create` (C29). */
4
+ export declare function registerCreateWizards(program: Command, _ctx: CliContext): void;
@@ -0,0 +1,210 @@
1
+ import { CliError } from "../errors.js";
2
+ import { OPERATION_COMMANDS } from "../generated/commands.js";
3
+ import { OPERATION_SCHEMAS } from "../generated/schemas.js";
4
+ import { callOperation, extendOperation, fillSingleValues, } from "../operations.js";
5
+ import { escapeControl, notice } from "../output.js";
6
+ import { listAllOptions, platformConfigSources } from "./config-sources.js";
7
+ import { askConfig } from "./config-wizard.js";
8
+ import { readSkillFiles } from "./skill-dir.js";
9
+ function required(value) {
10
+ return value.trim() === "" ? "This field is required." : undefined;
11
+ }
12
+ /** Pregunta un texto obligatorio si `name` no vino por flag ni `--data`. */
13
+ async function askText(step, name, message, placeholder) {
14
+ if (step.params[name] !== undefined)
15
+ return;
16
+ const value = await step.prompter.text({ message, placeholder, validate: required });
17
+ step.params[name] = value.trim();
18
+ }
19
+ /** Los valores que el contrato acepta para `name`, como opciones de una pregunta. */
20
+ function contractOptions(op, name) {
21
+ const values = op.bodyFlags.find((spec) => spec.name === name)?.values ?? [];
22
+ return values.map((value) => ({ value, label: value }));
23
+ }
24
+ /** Pregunta con `multiselect` cuáles del `list` asignar y arma los ítems con `key`; sin ítems no pregunta (C30). */
25
+ async function askAssignments(step, field, listId, key, message, refine) {
26
+ // `answered`: si eligió ninguno no queda nada en `params`, y un reintento de `run` no tiene que volver a preguntar.
27
+ if (step.params[field] !== undefined || step.answered.has(field))
28
+ return;
29
+ const options = await listAllOptions(step.platform, listId);
30
+ if (options.length === 0)
31
+ return;
32
+ const selected = await step.prompter.multiselect({ message, options });
33
+ step.answered.add(field);
34
+ // Lo mínimo válido del contrato: solo el id; el server usa su estrategia por defecto.
35
+ if (selected.length === 0)
36
+ return;
37
+ const items = [];
38
+ for (const id of selected) {
39
+ const option = options.find((o) => o.value === id);
40
+ const item = { [key]: id };
41
+ items.push(refine ? await refine(item, option) : item);
42
+ }
43
+ step.params[field] = items;
44
+ }
45
+ const MAX_HINT = 80;
46
+ /** Recorta un texto largo a una línea para el hint de una opción. */
47
+ function shorten(text) {
48
+ const oneLine = text.replace(/\s+/g, " ").trim();
49
+ return oneLine.length > MAX_HINT ? `${oneLine.slice(0, MAX_HINT - 1)}…` : oneLine;
50
+ }
51
+ /**
52
+ * Le pregunta al usuario cuáles tools de la conexión puede usar el agente (`name`, según el contrato).
53
+ * Si deja todas o el listado falla, no se manda `tools` (ausente = todas).
54
+ */
55
+ async function askConnectionTools(step, item, option) {
56
+ const name = escapeControl(option.label);
57
+ const listOp = OPERATION_COMMANDS.find((op) => op.id === "mcp.connections.tools.list");
58
+ let tools;
59
+ try {
60
+ if (!listOp)
61
+ throw new Error("Operation not generated: mcp.connections.tools.list");
62
+ const all = (await callOperation(step.platform, listOp, [option.value], undefined, true));
63
+ tools = all.data.map((t) => ({ name: t.name, description: t.description ?? "" }));
64
+ }
65
+ catch {
66
+ notice(step.ctx, step.mode, `Could not list the tools of ${name}; the agent will use all of them.`);
67
+ return item;
68
+ }
69
+ if (tools.length === 0)
70
+ return item;
71
+ const chosen = await step.prompter.multiselect({
72
+ message: `Tools of ${name} the agent can use (at least one)`,
73
+ options: tools.map((t) => ({
74
+ value: t.name,
75
+ label: escapeControl(t.name),
76
+ hint: t.description ? escapeControl(shorten(t.description)) : undefined,
77
+ })),
78
+ initialValues: tools.map((t) => t.name),
79
+ required: true,
80
+ });
81
+ return chosen.length === tools.length ? item : { ...item, tools: chosen };
82
+ }
83
+ /** El JSON Schema del `config` del body de la operación: de ahí el asistente arma sus preguntas. */
84
+ function configSchemaOf(op) {
85
+ const body = OPERATION_SCHEMAS[op.id]?.body;
86
+ return body?.properties?.config;
87
+ }
88
+ /** Pregunta el `config` si no vino por flag ni `--data`; elegir los modelos y proyectos requiere la sesión abierta. */
89
+ async function askConfigIfMissing(step) {
90
+ if (step.params.config !== undefined)
91
+ return;
92
+ step.params.config = await askConfig(configSchemaOf(step.op), platformConfigSources(step.platform), step.prompter, (message) => notice(step.ctx, step.mode, message));
93
+ }
94
+ /** Skills y conexiones MCP del agente: se eligen de la lista real de la organización. */
95
+ async function askBodyAssignments(step) {
96
+ await askAssignments(step, "skills", "skills.list", "skill_id", "Skills for the agent");
97
+ await askAssignments(step, "mcp_connections", "mcp.connections.list", "connection_id", "MCP connections for the agent", (item, option) => askConnectionTools(step, item, option));
98
+ }
99
+ /**
100
+ * Si el agente se crea con su primera versión. Sí por defecto; con No se crea sin config (sin skills, MCP ni activate:
101
+ * sin versión no hay dónde guardarlos). No se pregunta si ya vinieron skills, MCP o `--activate`, que necesitan la versión.
102
+ */
103
+ async function askFirstVersion(step) {
104
+ const needsVersion = step.params.skills !== undefined ||
105
+ step.params.mcp_connections !== undefined ||
106
+ step.params.activate === true;
107
+ if (needsVersion)
108
+ return true;
109
+ return step.prompter.confirm({
110
+ message: "Configure the first version now?",
111
+ initialValue: true,
112
+ });
113
+ }
114
+ /** `agents create`: nombre, el config completo, skills, MCP y activate (C30, E11). */
115
+ const agentsCreate = {
116
+ asks: ["name", "harness_type"],
117
+ beforeSession: async (step) => {
118
+ fillSingleValues(step.op, step.params);
119
+ await askText(step, "name", "Agent name");
120
+ },
121
+ withSession: async (step) => {
122
+ if (step.params.config === undefined && !(await askFirstVersion(step)))
123
+ return;
124
+ await askConfigIfMissing(step);
125
+ await askBodyAssignments(step);
126
+ if (step.params.activate === undefined) {
127
+ // Sí por defecto: con `config` y sin `activate` el server activa la versión.
128
+ step.params.activate = await step.prompter.confirm({
129
+ message: "Activate the first version now?",
130
+ initialValue: true,
131
+ });
132
+ }
133
+ },
134
+ };
135
+ /** `agents versions create`: el config completo, skills y MCP; la versión nueva no se activa (E11). */
136
+ const agentsVersionsCreate = {
137
+ asks: ["config"],
138
+ withSession: async (step) => {
139
+ await askConfigIfMissing(step);
140
+ await askBodyAssignments(step);
141
+ },
142
+ };
143
+ /** `tokens create`: nombre, `kind` y `permissions` con los valores del contrato (C30). */
144
+ const tokensCreate = {
145
+ asks: ["name", "kind", "permissions"],
146
+ beforeSession: async (step) => {
147
+ fillSingleValues(step.op, step.params);
148
+ await askText(step, "name", "Token name");
149
+ if (step.params.kind === undefined) {
150
+ step.params.kind = await step.prompter.select({
151
+ message: "Token kind",
152
+ options: contractOptions(step.op, "kind"),
153
+ });
154
+ }
155
+ if (step.params.permissions === undefined) {
156
+ // Al menos uno: un token sin permisos no sirve para nada.
157
+ step.params.permissions = await step.prompter.multiselect({
158
+ message: "Token permissions",
159
+ options: contractOptions(step.op, "permissions"),
160
+ required: true,
161
+ });
162
+ }
163
+ },
164
+ };
165
+ /** `skills create`: nombre y, si no vino `--dir`, `--files` ni `--data` con files, la carpeta con los archivos. */
166
+ const skillsCreate = {
167
+ asks: ["name", "files"],
168
+ beforeSession: async (step) => {
169
+ await askText(step, "name", "Skill name");
170
+ if (step.params.files !== undefined)
171
+ return;
172
+ // Una carpeta mal escrita o vacía no corta el asistente: se avisa por qué y se vuelve a preguntar (Q12).
173
+ for (;;) {
174
+ const dir = await step.prompter.text({
175
+ message: "Folder with the skill files",
176
+ placeholder: "./my-skill",
177
+ validate: required,
178
+ });
179
+ try {
180
+ step.params.files = await readSkillFiles(step.ctx, dir.trim(), "the skill folder", step.op.path);
181
+ return;
182
+ }
183
+ catch (err) {
184
+ if (!(err instanceof CliError))
185
+ throw err;
186
+ notice(step.ctx, step.mode, `${escapeControl(err.message.replace(/\.$/, ""))}. Try another folder.`);
187
+ }
188
+ }
189
+ },
190
+ };
191
+ /** `mcp connections create`: nombre y URL; los headers no se preguntan porque son secretos y van por `--headers`. */
192
+ const mcpConnectionsCreate = {
193
+ asks: ["name", "url"],
194
+ beforeSession: async (step) => {
195
+ await askText(step, "name", "Connection name");
196
+ await askText(step, "url", "MCP server URL", "https://example.com/mcp");
197
+ if (step.params.headers === undefined) {
198
+ notice(step.ctx, step.mode, "Headers are not asked because they are secrets; pass them with --headers @headers.json if the server needs them.");
199
+ }
200
+ },
201
+ };
202
+ /** Engancha los asistentes de `agents create`, `agents versions create`, `tokens create`, `skills create` y `mcp connections create` (C29). */
203
+ export function registerCreateWizards(program, _ctx) {
204
+ extendOperation(program, ["agents", "create"], { wizard: agentsCreate });
205
+ extendOperation(program, ["agents", "versions", "create"], { wizard: agentsVersionsCreate });
206
+ extendOperation(program, ["tokens", "create"], { wizard: tokensCreate });
207
+ extendOperation(program, ["skills", "create"], { wizard: skillsCreate });
208
+ extendOperation(program, ["mcp", "connections", "create"], { wizard: mcpConnectionsCreate });
209
+ }
210
+ //# sourceMappingURL=wizards.js.map