@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.
- package/LICENSE +21 -0
- package/README.md +33 -2
- package/dist/bin.d.ts +2 -0
- package/dist/bin.js +20 -0
- package/dist/bin.js.map +1 -0
- package/dist/commands/agent-checks.d.ts +5 -0
- package/dist/commands/agent-checks.js +69 -0
- package/dist/commands/agent-checks.js.map +1 -0
- package/dist/commands/agent-run/body.d.ts +22 -0
- package/dist/commands/agent-run/body.js +88 -0
- package/dist/commands/agent-run/body.js.map +1 -0
- package/dist/commands/agent-run/render.d.ts +50 -0
- package/dist/commands/agent-run/render.js +281 -0
- package/dist/commands/agent-run/render.js.map +1 -0
- package/dist/commands/agent-run.d.ts +10 -0
- package/dist/commands/agent-run.js +243 -0
- package/dist/commands/agent-run.js.map +1 -0
- package/dist/commands/agent-tools/add.d.ts +5 -0
- package/dist/commands/agent-tools/add.js +101 -0
- package/dist/commands/agent-tools/add.js.map +1 -0
- package/dist/commands/agent-tools/remove.d.ts +5 -0
- package/dist/commands/agent-tools/remove.js +126 -0
- package/dist/commands/agent-tools/remove.js.map +1 -0
- package/dist/commands/agent-tools/shared.d.ts +283 -0
- package/dist/commands/agent-tools/shared.js +107 -0
- package/dist/commands/agent-tools/shared.js.map +1 -0
- package/dist/commands/agent-tools.d.ts +5 -0
- package/dist/commands/agent-tools.js +11 -0
- package/dist/commands/agent-tools.js.map +1 -0
- package/dist/commands/auth.d.ts +14 -0
- package/dist/commands/auth.js +171 -0
- package/dist/commands/auth.js.map +1 -0
- package/dist/commands/completion.d.ts +4 -0
- package/dist/commands/completion.js +50 -0
- package/dist/commands/completion.js.map +1 -0
- package/dist/commands/config-sources.d.ts +22 -0
- package/dist/commands/config-sources.js +46 -0
- package/dist/commands/config-sources.js.map +1 -0
- package/dist/commands/config-wizard.d.ts +9 -0
- package/dist/commands/config-wizard.js +332 -0
- package/dist/commands/config-wizard.js.map +1 -0
- package/dist/commands/orgs.d.ts +11 -0
- package/dist/commands/orgs.js +193 -0
- package/dist/commands/orgs.js.map +1 -0
- package/dist/commands/skill-dir.d.ts +18 -0
- package/dist/commands/skill-dir.js +101 -0
- package/dist/commands/skill-dir.js.map +1 -0
- package/dist/commands/token-notice.d.ts +4 -0
- package/dist/commands/token-notice.js +13 -0
- package/dist/commands/token-notice.js.map +1 -0
- package/dist/commands/whoami.d.ts +8 -0
- package/dist/commands/whoami.js +38 -0
- package/dist/commands/whoami.js.map +1 -0
- package/dist/commands/wizards.d.ts +4 -0
- package/dist/commands/wizards.js +210 -0
- package/dist/commands/wizards.js.map +1 -0
- package/dist/completion/bash.d.ts +3 -0
- package/dist/completion/bash.js +60 -0
- package/dist/completion/bash.js.map +1 -0
- package/dist/completion/files.d.ts +35 -0
- package/dist/completion/files.js +178 -0
- package/dist/completion/files.js.map +1 -0
- package/dist/completion/powershell.d.ts +9 -0
- package/dist/completion/powershell.js +83 -0
- package/dist/completion/powershell.js.map +1 -0
- package/dist/completion/tree.d.ts +25 -0
- package/dist/completion/tree.js +53 -0
- package/dist/completion/tree.js.map +1 -0
- package/dist/completion/zsh.d.ts +3 -0
- package/dist/completion/zsh.js +76 -0
- package/dist/completion/zsh.js.map +1 -0
- package/dist/config/auth.d.ts +26 -0
- package/dist/config/auth.js +223 -0
- package/dist/config/auth.js.map +1 -0
- package/dist/config/link.d.ts +16 -0
- package/dist/config/link.js +93 -0
- package/dist/config/link.js.map +1 -0
- package/dist/config/paths.d.ts +3 -0
- package/dist/config/paths.js +20 -0
- package/dist/config/paths.js.map +1 -0
- package/dist/config/settings.d.ts +8 -0
- package/dist/config/settings.js +24 -0
- package/dist/config/settings.js.map +1 -0
- package/dist/confirm.d.ts +35 -0
- package/dist/confirm.js +51 -0
- package/dist/confirm.js.map +1 -0
- package/dist/context.d.ts +29 -0
- package/dist/context.js +16 -0
- package/dist/context.js.map +1 -0
- package/dist/errors.d.ts +54 -0
- package/dist/errors.js +413 -0
- package/dist/errors.js.map +1 -0
- package/dist/generated/commands.d.ts +49 -0
- package/dist/generated/commands.js +52 -0
- package/dist/generated/commands.js.map +1 -0
- package/dist/generated/schemas.d.ts +5 -0
- package/dist/generated/schemas.js +20 -0
- package/dist/generated/schemas.js.map +1 -0
- package/dist/invocation.d.ts +64 -0
- package/dist/invocation.js +341 -0
- package/dist/invocation.js.map +1 -0
- package/dist/mode.d.ts +17 -0
- package/dist/mode.js +22 -0
- package/dist/mode.js.map +1 -0
- package/dist/operations/call.d.ts +6 -0
- package/dist/operations/call.js +17 -0
- package/dist/operations/call.js.map +1 -0
- package/dist/operations/extensions.d.ts +46 -0
- package/dist/operations/extensions.js +29 -0
- package/dist/operations/extensions.js.map +1 -0
- package/dist/operations/json-input.d.ts +7 -0
- package/dist/operations/json-input.js +50 -0
- package/dist/operations/json-input.js.map +1 -0
- package/dist/operations/params.d.ts +17 -0
- package/dist/operations/params.js +106 -0
- package/dist/operations/params.js.map +1 -0
- package/dist/operations/register.d.ts +10 -0
- package/dist/operations/register.js +102 -0
- package/dist/operations/register.js.map +1 -0
- package/dist/operations/run-operation.d.ts +8 -0
- package/dist/operations/run-operation.js +148 -0
- package/dist/operations/run-operation.js.map +1 -0
- package/dist/operations/schema-flag.d.ts +8 -0
- package/dist/operations/schema-flag.js +12 -0
- package/dist/operations/schema-flag.js.map +1 -0
- package/dist/operations/skeleton.d.ts +16 -0
- package/dist/operations/skeleton.js +116 -0
- package/dist/operations/skeleton.js.map +1 -0
- package/dist/operations/tables.d.ts +7 -0
- package/dist/operations/tables.js +131 -0
- package/dist/operations/tables.js.map +1 -0
- package/dist/operations.d.ts +5 -0
- package/dist/operations.js +7 -0
- package/dist/operations.js.map +1 -0
- package/dist/output.d.ts +33 -0
- package/dist/output.js +321 -0
- package/dist/output.js.map +1 -0
- package/dist/pickers.d.ts +51 -0
- package/dist/pickers.js +277 -0
- package/dist/pickers.js.map +1 -0
- package/dist/program.d.ts +31 -0
- package/dist/program.js +260 -0
- package/dist/program.js.map +1 -0
- package/dist/prompter.d.ts +54 -0
- package/dist/prompter.js +129 -0
- package/dist/prompter.js.map +1 -0
- package/dist/session.d.ts +45 -0
- package/dist/session.js +170 -0
- package/dist/session.js.map +1 -0
- package/dist/stdout-policy.d.ts +4 -0
- package/dist/stdout-policy.js +11 -0
- package/dist/stdout-policy.js.map +1 -0
- package/dist/update-check.d.ts +4 -0
- package/dist/update-check.js +60 -0
- package/dist/update-check.js.map +1 -0
- package/docs/SKILL.md +175 -0
- package/docs/references/auth-and-organizations.md +72 -0
- package/docs/references/commands.md +217 -0
- package/docs/references/output-and-errors.md +105 -0
- package/package.json +39 -5
|
@@ -0,0 +1,223 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { link, mkdir, open, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
|
|
3
|
+
import { hostname } from "node:os";
|
|
4
|
+
import { join } from "node:path";
|
|
5
|
+
import { CliError } from "../errors.js";
|
|
6
|
+
import { removeFileCommand } from "../invocation.js";
|
|
7
|
+
const AUTH_FILE = "auth.json";
|
|
8
|
+
const LOCK_FILE = "auth.lock";
|
|
9
|
+
const LOCK_RETRY_MS = 100;
|
|
10
|
+
/** Tiempo máximo que un `refreshToken` puede tardar; el lock tiene que durar más que esto. */
|
|
11
|
+
export const REFRESH_TIMEOUT_MS = 20_000;
|
|
12
|
+
/** Un lock más viejo que esto se da por abandonado; tiene que ser mayor que `REFRESH_TIMEOUT_MS` para no robarle el lock a un refresh lento. */
|
|
13
|
+
const LOCK_STALE_MS = 60_000;
|
|
14
|
+
/** Cuánto espera por el lock; mayor que `LOCK_STALE_MS` para llegar a tomar el de un proceso que murió. */
|
|
15
|
+
const LOCK_WAIT_MS = 70_000;
|
|
16
|
+
/** Si la espera por el lock pasa esto, se avisa una vez por stderr para que no parezca colgado. */
|
|
17
|
+
const LOCK_NOTICE_MS = 1_000;
|
|
18
|
+
function isAuthFile(v) {
|
|
19
|
+
if (typeof v !== "object" || v === null)
|
|
20
|
+
return false;
|
|
21
|
+
const o = v;
|
|
22
|
+
return (typeof o.token === "string" &&
|
|
23
|
+
typeof o.refresh_token === "string" &&
|
|
24
|
+
typeof o.expires_at === "number" &&
|
|
25
|
+
typeof o.api_url === "string");
|
|
26
|
+
}
|
|
27
|
+
/** Lee auth.json; devuelve null si no existe, está roto o le falta un campo (cuenta como "sin login"). */
|
|
28
|
+
export async function readAuth(dir) {
|
|
29
|
+
try {
|
|
30
|
+
const parsed = JSON.parse(await readFile(join(dir, AUTH_FILE), "utf8"));
|
|
31
|
+
return isAuthFile(parsed) ? parsed : null;
|
|
32
|
+
}
|
|
33
|
+
catch {
|
|
34
|
+
return null;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
/** Guarda auth.json (600) en una carpeta 700, escribiendo un temporal y renombrándolo. */
|
|
38
|
+
export async function writeAuth(dir, auth) {
|
|
39
|
+
await mkdir(dir, { recursive: true, mode: 0o700 });
|
|
40
|
+
const tmp = join(dir, `${AUTH_FILE}.${process.pid}.${Date.now()}.tmp`);
|
|
41
|
+
try {
|
|
42
|
+
await writeFile(tmp, `${JSON.stringify(auth, null, 2)}\n`, { mode: 0o600 });
|
|
43
|
+
await rename(tmp, join(dir, AUTH_FILE));
|
|
44
|
+
}
|
|
45
|
+
catch (err) {
|
|
46
|
+
await rm(tmp, { force: true });
|
|
47
|
+
throw err;
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
/** Borra auth.json; no falla si no existe. */
|
|
51
|
+
export async function deleteAuth(dir) {
|
|
52
|
+
await rm(join(dir, AUTH_FILE), { force: true });
|
|
53
|
+
}
|
|
54
|
+
/** Token de dueño de un lock o del mutex de robo: `host:pid:uuid`. El host dice si el pid se puede mirar desde acá. */
|
|
55
|
+
function ownerToken() {
|
|
56
|
+
return `${hostname()}:${process.pid}:${randomUUID()}`;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Devuelve si `content` (`host:pid:uuid`) es de un proceso de esta máquina que ya no existe. Con otro host (la carpeta
|
|
60
|
+
* de credenciales compartida por red o montada en un contenedor) el pid no dice nada: vale la regla de `staleMs`.
|
|
61
|
+
*/
|
|
62
|
+
function heldByDeadProcess(content) {
|
|
63
|
+
const parts = content?.split(":") ?? [];
|
|
64
|
+
if (parts.length < 3)
|
|
65
|
+
return false;
|
|
66
|
+
const host = parts.slice(0, -2).join(":");
|
|
67
|
+
const pid = Number(parts.at(-2));
|
|
68
|
+
if (host !== hostname() || !Number.isInteger(pid) || pid <= 0)
|
|
69
|
+
return false;
|
|
70
|
+
try {
|
|
71
|
+
process.kill(pid, 0);
|
|
72
|
+
return false;
|
|
73
|
+
}
|
|
74
|
+
catch (err) {
|
|
75
|
+
// EPERM: existe pero es de otro usuario, sigue vivo.
|
|
76
|
+
return err.code === "ESRCH";
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
function sleep(ms) {
|
|
80
|
+
return new Promise((r) => setTimeout(r, ms));
|
|
81
|
+
}
|
|
82
|
+
/** Un robo que quedó a medias (el ladrón murió con el mutex tomado) se da por abandonado después de esto. */
|
|
83
|
+
const STEAL_STALE_MS = 5_000;
|
|
84
|
+
/**
|
|
85
|
+
* Corre `fn` solo si este proceso toma el mutex `auth.lock.steal` (creado con `wx`); si otro lo tiene, no hace nada y
|
|
86
|
+
* el llamador reintenta. Así un solo proceso a la vez puede renombrar o borrar un lock abandonado (R2).
|
|
87
|
+
*/
|
|
88
|
+
async function withStealMutex(lockPath, fn) {
|
|
89
|
+
const mutex = `${lockPath}.steal`;
|
|
90
|
+
const token = ownerToken();
|
|
91
|
+
try {
|
|
92
|
+
const handle = await open(mutex, "wx");
|
|
93
|
+
try {
|
|
94
|
+
await handle.writeFile(token);
|
|
95
|
+
}
|
|
96
|
+
finally {
|
|
97
|
+
await handle.close();
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
catch (err) {
|
|
101
|
+
if (err.code !== "EEXIST")
|
|
102
|
+
throw err;
|
|
103
|
+
// El de un ladrón que murió o se colgó se borra; el siguiente intento lo toma.
|
|
104
|
+
const content = await readFile(mutex, "utf8").catch(() => null);
|
|
105
|
+
const mtimeMs = await stat(mutex).then((s) => s.mtimeMs, () => Date.now());
|
|
106
|
+
if (heldByDeadProcess(content) || Date.now() - mtimeMs > STEAL_STALE_MS) {
|
|
107
|
+
await rm(mutex, { force: true });
|
|
108
|
+
}
|
|
109
|
+
return;
|
|
110
|
+
}
|
|
111
|
+
try {
|
|
112
|
+
await fn();
|
|
113
|
+
}
|
|
114
|
+
finally {
|
|
115
|
+
if ((await readFile(mutex, "utf8").catch(() => null)) === token) {
|
|
116
|
+
await rm(mutex, { force: true });
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
/** Quita el lock si, mirado de nuevo bajo el mutex, sigue abandonado (proceso muerto o más viejo que `staleMs`). */
|
|
121
|
+
async function stealLock(lockPath, staleMs) {
|
|
122
|
+
await withStealMutex(lockPath, async () => {
|
|
123
|
+
// Desde que lo vimos el lock pudo cambiar de dueño: la decisión se toma recién acá, con el mutex.
|
|
124
|
+
const content = await readFile(lockPath, "utf8").catch(() => null);
|
|
125
|
+
const info = await stat(lockPath).catch(() => null);
|
|
126
|
+
if (content === null || !info)
|
|
127
|
+
return;
|
|
128
|
+
if (!heldByDeadProcess(content) && Date.now() - info.mtimeMs <= staleMs)
|
|
129
|
+
return;
|
|
130
|
+
const mine = `${lockPath}.stolen.${process.pid}.${randomUUID()}`;
|
|
131
|
+
try {
|
|
132
|
+
await rename(lockPath, mine);
|
|
133
|
+
}
|
|
134
|
+
catch {
|
|
135
|
+
return;
|
|
136
|
+
}
|
|
137
|
+
// Entre leerlo y renombrarlo solo pudo cambiar si su dueño lo soltó y otro tomó uno nuevo: se lo devolvemos.
|
|
138
|
+
const moved = await readFile(mine, "utf8").catch(() => null);
|
|
139
|
+
if (moved !== content)
|
|
140
|
+
await link(mine, lockPath).catch(() => { });
|
|
141
|
+
await rm(mine, { force: true });
|
|
142
|
+
});
|
|
143
|
+
}
|
|
144
|
+
/** Toma el lock `auth.lock` escribiendo en él un token propio; si está tomado reintenta, y si es viejo o de un proceso muerto lo roba. */
|
|
145
|
+
async function acquireLock(lockPath, token, { waitMs, staleMs, onWait }) {
|
|
146
|
+
const started = Date.now();
|
|
147
|
+
const deadline = started + waitMs;
|
|
148
|
+
let warned = false;
|
|
149
|
+
for (;;) {
|
|
150
|
+
try {
|
|
151
|
+
const handle = await open(lockPath, "wx");
|
|
152
|
+
try {
|
|
153
|
+
await handle.writeFile(token);
|
|
154
|
+
}
|
|
155
|
+
finally {
|
|
156
|
+
await handle.close();
|
|
157
|
+
}
|
|
158
|
+
return;
|
|
159
|
+
}
|
|
160
|
+
catch (err) {
|
|
161
|
+
if (err.code !== "EEXIST")
|
|
162
|
+
throw err;
|
|
163
|
+
}
|
|
164
|
+
try {
|
|
165
|
+
const { mtimeMs } = await stat(lockPath);
|
|
166
|
+
const content = await readFile(lockPath, "utf8").catch(() => null);
|
|
167
|
+
if (heldByDeadProcess(content) || Date.now() - mtimeMs > staleMs) {
|
|
168
|
+
await stealLock(lockPath, staleMs);
|
|
169
|
+
// Si otro proceso tiene el mutex de robo, se espera un poco en vez de girar en caliente.
|
|
170
|
+
if (await exists(lockPath))
|
|
171
|
+
await sleep(LOCK_RETRY_MS);
|
|
172
|
+
continue;
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
catch (err) {
|
|
176
|
+
// El lock desapareció entre el open y el stat: reintentamos enseguida.
|
|
177
|
+
// Cualquier otro error de stat cae al chequeo de tiempo, para no girar en caliente.
|
|
178
|
+
if (err.code === "ENOENT")
|
|
179
|
+
continue;
|
|
180
|
+
}
|
|
181
|
+
if (Date.now() >= deadline) {
|
|
182
|
+
throw new CliError("auth_lock_timeout", `Timed out waiting for another laburen process to finish updating the credentials (${lockPath}).`, 1, [
|
|
183
|
+
{
|
|
184
|
+
command: removeFileCommand(lockPath),
|
|
185
|
+
when: "if no other laburen command is running, a crashed one left the lock behind",
|
|
186
|
+
},
|
|
187
|
+
]);
|
|
188
|
+
}
|
|
189
|
+
if (!warned && onWait && Date.now() - started > LOCK_NOTICE_MS) {
|
|
190
|
+
warned = true;
|
|
191
|
+
onWait(lockPath);
|
|
192
|
+
}
|
|
193
|
+
await sleep(LOCK_RETRY_MS);
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
async function exists(path) {
|
|
197
|
+
return stat(path).then(() => true, () => false);
|
|
198
|
+
}
|
|
199
|
+
/** Aviso por stderr para `onWait`: otro proceso está renovando las credenciales. */
|
|
200
|
+
export function lockWaitNotice(stderr) {
|
|
201
|
+
return (lockPath) => stderr.write(`Waiting for another laburen process to finish updating the credentials (${lockPath})...\n`);
|
|
202
|
+
}
|
|
203
|
+
/** Corre `fn` con exclusión entre procesos sobre la misma carpeta; el lock se libera siempre, pero solo si sigue siendo el nuestro. */
|
|
204
|
+
export async function withAuthLock(dir, fn, options = {}) {
|
|
205
|
+
await mkdir(dir, { recursive: true, mode: 0o700 });
|
|
206
|
+
const lockPath = join(dir, LOCK_FILE);
|
|
207
|
+
const token = ownerToken();
|
|
208
|
+
await acquireLock(lockPath, token, {
|
|
209
|
+
waitMs: options.waitMs ?? LOCK_WAIT_MS,
|
|
210
|
+
staleMs: options.staleMs ?? LOCK_STALE_MS,
|
|
211
|
+
onWait: options.onWait,
|
|
212
|
+
});
|
|
213
|
+
try {
|
|
214
|
+
return await fn();
|
|
215
|
+
}
|
|
216
|
+
finally {
|
|
217
|
+
// Si el lock quedó viejo y otro proceso lo robó, no le borramos el suyo.
|
|
218
|
+
const current = await readFile(lockPath, "utf8").catch(() => null);
|
|
219
|
+
if (current === token)
|
|
220
|
+
await rm(lockPath, { force: true });
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
//# sourceMappingURL=auth.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/config/auth.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export declare const LINK_FILE = ".laburen/link.json";
|
|
2
|
+
/** Organización a la que apunta una carpeta; solo tiene el id, que no es secreto. */
|
|
3
|
+
export interface LinkFile {
|
|
4
|
+
organization_id: string;
|
|
5
|
+
}
|
|
6
|
+
/** Busca el primer `.laburen/link.json` que exista desde `cwd` hacia arriba, sea válido o no. */
|
|
7
|
+
export declare function locateLink(cwd: string): Promise<string | null>;
|
|
8
|
+
/** Busca `.laburen/link.json` desde `cwd` hacia arriba; si el primero que existe está roto falla, no sigue con otro. */
|
|
9
|
+
export declare function findLink(cwd: string): Promise<{
|
|
10
|
+
path: string;
|
|
11
|
+
link: LinkFile;
|
|
12
|
+
} | null>;
|
|
13
|
+
/** Escribe `.laburen/link.json` dentro de `dir`; si `.laburen` existe y no es una carpeta falla con código 2. */
|
|
14
|
+
export declare function writeLink(dir: string, link: LinkFile): Promise<void>;
|
|
15
|
+
/** Borra el archivo de link en `path` (el que devolvió `locateLink`) y su carpeta `.laburen` si queda vacía. */
|
|
16
|
+
export declare function deleteLink(path: string): Promise<void>;
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import { mkdir, readFile, rm, rmdir, stat, writeFile } from "node:fs/promises";
|
|
2
|
+
import { dirname, join, parse } from "node:path";
|
|
3
|
+
import { CliError } from "../errors.js";
|
|
4
|
+
import { removeFileCommand } from "../invocation.js";
|
|
5
|
+
export const LINK_FILE = ".laburen/link.json";
|
|
6
|
+
/** Busca el primer `.laburen/link.json` que exista desde `cwd` hacia arriba, sea válido o no. */
|
|
7
|
+
export async function locateLink(cwd) {
|
|
8
|
+
const root = parse(cwd).root;
|
|
9
|
+
for (let dir = cwd;; dir = dirname(dir)) {
|
|
10
|
+
const path = join(dir, LINK_FILE);
|
|
11
|
+
try {
|
|
12
|
+
await stat(path);
|
|
13
|
+
return path;
|
|
14
|
+
}
|
|
15
|
+
catch (err) {
|
|
16
|
+
// Que no exista es lo normal; cualquier otro error se trata como "existe".
|
|
17
|
+
const code = err.code;
|
|
18
|
+
// `.laburen` es un archivo: falla igual que `link`, no sigue a buscar el link.json de una carpeta de arriba.
|
|
19
|
+
if (code === "ENOTDIR")
|
|
20
|
+
throw notAFolder(join(dir, dirname(LINK_FILE)));
|
|
21
|
+
if (code !== "ENOENT")
|
|
22
|
+
return path;
|
|
23
|
+
// Windows da ENOENT (no ENOTDIR) cuando `.laburen` es un archivo: se mira la carpeta aparte.
|
|
24
|
+
if (await isNotAFolder(join(dir, dirname(LINK_FILE))))
|
|
25
|
+
throw notAFolder(join(dir, dirname(LINK_FILE)));
|
|
26
|
+
}
|
|
27
|
+
if (dir === root)
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
/** True si `folder` existe y no es una carpeta; false si no existe o no se puede mirar. */
|
|
32
|
+
async function isNotAFolder(folder) {
|
|
33
|
+
try {
|
|
34
|
+
return !(await stat(folder)).isDirectory();
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
return false;
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
/** `.laburen` existe y no es una carpeta: no se puede leer ni escribir el link. */
|
|
41
|
+
function notAFolder(folder) {
|
|
42
|
+
return new CliError("invalid_link", `${folder} exists and is not a folder, so ${LINK_FILE} cannot be used.`, 2, [
|
|
43
|
+
{
|
|
44
|
+
command: removeFileCommand(folder),
|
|
45
|
+
when: "if that file is not needed, then run laburen link again",
|
|
46
|
+
},
|
|
47
|
+
]);
|
|
48
|
+
}
|
|
49
|
+
function invalidLink(path, detail) {
|
|
50
|
+
return new CliError("invalid_link", `${path} is not a valid link file: ${detail}.`, 2, [
|
|
51
|
+
{ command: "laburen link --org <id>", when: "Rewrite the folder link" },
|
|
52
|
+
{ command: "laburen unlink", when: "Remove the folder link" },
|
|
53
|
+
]);
|
|
54
|
+
}
|
|
55
|
+
/** Busca `.laburen/link.json` desde `cwd` hacia arriba; si el primero que existe está roto falla, no sigue con otro. */
|
|
56
|
+
export async function findLink(cwd) {
|
|
57
|
+
const path = await locateLink(cwd);
|
|
58
|
+
if (!path)
|
|
59
|
+
return null;
|
|
60
|
+
let parsed;
|
|
61
|
+
try {
|
|
62
|
+
parsed = JSON.parse(await readFile(path, "utf8"));
|
|
63
|
+
}
|
|
64
|
+
catch (err) {
|
|
65
|
+
throw invalidLink(path, err instanceof Error ? err.message : String(err));
|
|
66
|
+
}
|
|
67
|
+
const id = parsed?.organization_id;
|
|
68
|
+
if (typeof id !== "string" || id === "")
|
|
69
|
+
throw invalidLink(path, "missing organization_id");
|
|
70
|
+
return { path, link: { organization_id: id } };
|
|
71
|
+
}
|
|
72
|
+
/** Escribe `.laburen/link.json` dentro de `dir`; si `.laburen` existe y no es una carpeta falla con código 2. */
|
|
73
|
+
export async function writeLink(dir, link) {
|
|
74
|
+
const path = join(dir, LINK_FILE);
|
|
75
|
+
const folder = dirname(path);
|
|
76
|
+
try {
|
|
77
|
+
await mkdir(folder, { recursive: true });
|
|
78
|
+
}
|
|
79
|
+
catch (err) {
|
|
80
|
+
const code = err.code;
|
|
81
|
+
if (code !== "EEXIST" && code !== "ENOTDIR")
|
|
82
|
+
throw err;
|
|
83
|
+
throw notAFolder(folder);
|
|
84
|
+
}
|
|
85
|
+
await writeFile(path, `${JSON.stringify(link, null, 2)}\n`);
|
|
86
|
+
}
|
|
87
|
+
/** Borra el archivo de link en `path` (el que devolvió `locateLink`) y su carpeta `.laburen` si queda vacía. */
|
|
88
|
+
export async function deleteLink(path) {
|
|
89
|
+
await rm(path, { force: true });
|
|
90
|
+
// Solo si quedó vacía: con otros archivos (o si ya no existe) rmdir falla y se deja como está.
|
|
91
|
+
await rmdir(dirname(path)).catch(() => { });
|
|
92
|
+
}
|
|
93
|
+
//# sourceMappingURL=link.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/config/link.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { homedir } from "node:os";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
const APP_DIR = "laburen";
|
|
4
|
+
/** Carpeta de datos del sistema: Linux XDG, Mac Application Support, Windows APPDATA; una variable vacía cuenta como no puesta. */
|
|
5
|
+
function dataDir(ctx) {
|
|
6
|
+
const home = ctx.env.HOME || homedir();
|
|
7
|
+
switch (process.platform) {
|
|
8
|
+
case "win32":
|
|
9
|
+
return join(ctx.env.APPDATA || join(home, "AppData", "Roaming"), APP_DIR);
|
|
10
|
+
case "darwin":
|
|
11
|
+
return join(home, "Library", "Application Support", APP_DIR);
|
|
12
|
+
default:
|
|
13
|
+
return join(ctx.env.XDG_DATA_HOME || join(home, ".local", "share"), APP_DIR);
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
/** Devuelve la carpeta de config: `--global-config`, si no `LABUREN_CONFIG_DIR`, si no la carpeta de datos. */
|
|
17
|
+
export function resolveConfigDir(ctx, flag) {
|
|
18
|
+
return flag || ctx.env.LABUREN_CONFIG_DIR || dataDir(ctx);
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=paths.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,OAAO,GAAG,SAAS,CAAC;AAE1B,mIAAmI;AACnI,SAAS,OAAO,CAAC,GAAe;IAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACvC,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC1B,KAAK,OAAO;YACX,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAC3E,KAAK,QAAQ;YACZ,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;QAC9D;YACC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;AACF,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,gBAAgB,CAAC,GAAe,EAAE,IAAa;IAC9D,OAAO,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/** Lo que no es secreto: la organización guardada. */
|
|
2
|
+
export interface Settings {
|
|
3
|
+
organization_id?: string;
|
|
4
|
+
}
|
|
5
|
+
/** Lee config.json; devuelve `{}` si no existe o está roto. */
|
|
6
|
+
export declare function readSettings(dir: string): Promise<Settings>;
|
|
7
|
+
/** Guarda config.json sin tocar auth.json. */
|
|
8
|
+
export declare function writeSettings(dir: string, settings: Settings): Promise<void>;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
const SETTINGS_FILE = "config.json";
|
|
4
|
+
/** Lee config.json; devuelve `{}` si no existe o está roto. */
|
|
5
|
+
export async function readSettings(dir) {
|
|
6
|
+
try {
|
|
7
|
+
const parsed = JSON.parse(await readFile(join(dir, SETTINGS_FILE), "utf8"));
|
|
8
|
+
if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
|
|
9
|
+
return {};
|
|
10
|
+
const id = parsed.organization_id;
|
|
11
|
+
return typeof id === "string" ? { organization_id: id } : {};
|
|
12
|
+
}
|
|
13
|
+
catch {
|
|
14
|
+
return {};
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
/** Guarda config.json sin tocar auth.json. */
|
|
18
|
+
export async function writeSettings(dir, settings) {
|
|
19
|
+
await mkdir(dir, { recursive: true, mode: 0o700 });
|
|
20
|
+
const tmp = join(dir, `${SETTINGS_FILE}.${process.pid}.tmp`);
|
|
21
|
+
await writeFile(tmp, `${JSON.stringify(settings, null, 2)}\n`);
|
|
22
|
+
await rename(tmp, join(dir, SETTINGS_FILE));
|
|
23
|
+
}
|
|
24
|
+
//# sourceMappingURL=settings.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/config/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOjC,MAAM,aAAa,GAAG,aAAa,CAAC;AAEpC,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW;IAC7C,IAAI,CAAC;QACJ,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACrF,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QACtF,MAAM,EAAE,GAAI,MAAkC,CAAC,eAAe,CAAC;QAC/D,OAAO,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC;AAED,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,QAAkB;IAClE,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC;AAC7C,CAAC"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { CliContext } from "./context.js";
|
|
2
|
+
import type { Mode } from "./mode.js";
|
|
3
|
+
import { type Prompter } from "./prompter.js";
|
|
4
|
+
/** Saca `--yes`/`-y`: un comando que borra y cuyo id elige la persona tiene que volver a confirmar (C27). */
|
|
5
|
+
export declare function withoutYes(args: string[]): string[];
|
|
6
|
+
/** Qué se va a borrar o revocar, para el texto de la pregunta y el `when` del `next`. */
|
|
7
|
+
export interface ConfirmTarget {
|
|
8
|
+
/** Verbo en inglés: `Delete`, `Revoke`, `Remove`. */
|
|
9
|
+
verb: string;
|
|
10
|
+
/** Nombre del recurso, p. ej. `agent` o `token`. */
|
|
11
|
+
resource: string;
|
|
12
|
+
id: string;
|
|
13
|
+
/** Lo que lo contiene, p. ej. `agent agt_1` al borrar una versión. */
|
|
14
|
+
parent?: string;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* El comando que se corrió con `--yes`, con `<value>` en lugar de los secretos; si no hay invocación guardada, `fallback`
|
|
18
|
+
* (la ruta con sus ids). `args` nunca trae `--yes`: con él no se llega a pedir confirmación sin terminal.
|
|
19
|
+
*/
|
|
20
|
+
export declare function commandWithYes(args: string[], fallback: string): string;
|
|
21
|
+
/**
|
|
22
|
+
* Pide confirmación antes de borrar o revocar (C27).
|
|
23
|
+
* - `--yes` la saltea, salvo `idFromPicker`: un id elegido de una lista siempre se confirma.
|
|
24
|
+
* - Con terminal: `confirm` con No por defecto; decir que no cancela (`cancelled`, código 1).
|
|
25
|
+
* - Sin poder preguntar: `confirmation_required` (código 2) con el comando real + `--yes` en `next`.
|
|
26
|
+
*/
|
|
27
|
+
export declare function confirmDestructive(ctx: CliContext, mode: Mode, prompter: Prompter, params: {
|
|
28
|
+
target: ConfirmTarget;
|
|
29
|
+
yes: boolean;
|
|
30
|
+
args: string[];
|
|
31
|
+
/** Comando a mostrar si no se guardó la invocación. */
|
|
32
|
+
fallbackCommand: string;
|
|
33
|
+
/** `true` cuando el id no lo escribió la persona sino que lo eligió de una lista (Task 15). */
|
|
34
|
+
idFromPicker?: boolean;
|
|
35
|
+
}): Promise<void>;
|
package/dist/confirm.js
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { CliError } from "./errors.js";
|
|
2
|
+
import { commandText } from "./invocation.js";
|
|
3
|
+
import { cancelled, canPrompt } from "./prompter.js";
|
|
4
|
+
/** Saca `--yes`/`-y`: un comando que borra y cuyo id elige la persona tiene que volver a confirmar (C27). */
|
|
5
|
+
export function withoutYes(args) {
|
|
6
|
+
return args.filter((a) => a !== "--yes" && a !== "-y");
|
|
7
|
+
}
|
|
8
|
+
/** `Delete` → `deleting`, para el `when` de C27 ("approves deleting agent agt_1"). */
|
|
9
|
+
function gerund(verb) {
|
|
10
|
+
return `${verb.toLowerCase().replace(/e$/, "")}ing`;
|
|
11
|
+
}
|
|
12
|
+
function targetText(target) {
|
|
13
|
+
const parent = target.parent ? ` of ${target.parent}` : "";
|
|
14
|
+
return `${target.resource} ${target.id}${parent}`;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* El comando que se corrió con `--yes`, con `<value>` en lugar de los secretos; si no hay invocación guardada, `fallback`
|
|
18
|
+
* (la ruta con sus ids). `args` nunca trae `--yes`: con él no se llega a pedir confirmación sin terminal.
|
|
19
|
+
*/
|
|
20
|
+
export function commandWithYes(args, fallback) {
|
|
21
|
+
if (args.length === 0)
|
|
22
|
+
return `${fallback} --yes`;
|
|
23
|
+
return `${commandText(args)} --yes`;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Pide confirmación antes de borrar o revocar (C27).
|
|
27
|
+
* - `--yes` la saltea, salvo `idFromPicker`: un id elegido de una lista siempre se confirma.
|
|
28
|
+
* - Con terminal: `confirm` con No por defecto; decir que no cancela (`cancelled`, código 1).
|
|
29
|
+
* - Sin poder preguntar: `confirmation_required` (código 2) con el comando real + `--yes` en `next`.
|
|
30
|
+
*/
|
|
31
|
+
export async function confirmDestructive(ctx, mode, prompter, params) {
|
|
32
|
+
if (params.yes && !params.idFromPicker)
|
|
33
|
+
return;
|
|
34
|
+
const what = targetText(params.target);
|
|
35
|
+
if (canPrompt(ctx, mode)) {
|
|
36
|
+
const ok = await prompter.confirm({
|
|
37
|
+
message: `${params.target.verb} ${what}?`,
|
|
38
|
+
initialValue: false,
|
|
39
|
+
});
|
|
40
|
+
if (!ok)
|
|
41
|
+
throw cancelled();
|
|
42
|
+
return;
|
|
43
|
+
}
|
|
44
|
+
throw new CliError("confirmation_required", `${params.target.verb} ${what} needs confirmation. Re-run with --yes.`, 2, [
|
|
45
|
+
{
|
|
46
|
+
command: commandWithYes(params.args, params.fallbackCommand),
|
|
47
|
+
when: `Only after the user approves ${gerund(params.target.verb)} ${what}`,
|
|
48
|
+
},
|
|
49
|
+
], undefined, { userActionRequired: true });
|
|
50
|
+
}
|
|
51
|
+
//# sourceMappingURL=confirm.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../src/confirm.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAiB,MAAM,eAAe,CAAC;AAEpE,6GAA6G;AAC7G,MAAM,UAAU,UAAU,CAAC,IAAc;IACxC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;AACxD,CAAC;AAaD,sFAAsF;AACtF,SAAS,MAAM,CAAC,IAAY;IAC3B,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC;AACrD,CAAC;AAED,SAAS,UAAU,CAAC,MAAqB;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAc,EAAE,QAAgB;IAC9D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,QAAQ,QAAQ,CAAC;IAClD,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,GAAe,EACf,IAAU,EACV,QAAkB,EAClB,MAQC;IAED,IAAI,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY;QAAE,OAAO;IAC/C,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;YACjC,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,GAAG;YACzC,YAAY,EAAE,KAAK;SACnB,CAAC,CAAC;QACH,IAAI,CAAC,EAAE;YAAE,MAAM,SAAS,EAAE,CAAC;QAC3B,OAAO;IACR,CAAC;IACD,MAAM,IAAI,QAAQ,CACjB,uBAAuB,EACvB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,yCAAyC,EACtE,CAAC,EACD;QACC;YACC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,eAAe,CAAC;YAC5D,IAAI,EAAE,gCAAgC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE;SAC1E;KACD,EACD,SAAS,EACT,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAC5B,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/** Lo que escribió la persona: los argumentos (sin `node` ni el binario) y la ruta del comando que eligió. */
|
|
2
|
+
export interface Invocation {
|
|
3
|
+
args: string[];
|
|
4
|
+
command: string[];
|
|
5
|
+
}
|
|
6
|
+
/** Todo lo que la CLI toca del proceso (env, streams, reloj), inyectable para que los tests lo armen a mano. */
|
|
7
|
+
export interface CliContext {
|
|
8
|
+
env: Record<string, string | undefined>;
|
|
9
|
+
cwd: string;
|
|
10
|
+
stdout: NodeJS.WritableStream;
|
|
11
|
+
stderr: NodeJS.WritableStream;
|
|
12
|
+
/** Entrada estándar para `--data -`; si falta, se usa la del proceso. */
|
|
13
|
+
stdin?: NodeJS.ReadableStream;
|
|
14
|
+
stdinIsTTY: boolean;
|
|
15
|
+
stdoutIsTTY: boolean;
|
|
16
|
+
/** Ancho de la terminal en columnas; si falta (o no es terminal) las tablas no se recortan. */
|
|
17
|
+
stdoutColumns?: number;
|
|
18
|
+
/** Si falta, se toma igual que `stdoutIsTTY`. */
|
|
19
|
+
stderrIsTTY?: boolean;
|
|
20
|
+
now(): number;
|
|
21
|
+
/** Le pregunta a un PowerShell (`pwsh`, `powershell.exe`) su `$PROFILE`; null si no está o no contesta. Se inyecta en los tests. */
|
|
22
|
+
queryPowerShellProfile?: (exe: string) => string | null;
|
|
23
|
+
/** Quién avisa del Ctrl+C durante `agents run`; devuelve la función que deja de escuchar. Sin él se usa SIGINT del proceso; los tests lo inyectan. */
|
|
24
|
+
onInterrupt?: (cb: () => void) => () => void;
|
|
25
|
+
/** Lo pone `main` antes de parsear, para que los `next` repitan el comando real; sin él, cada error usa su ruta. */
|
|
26
|
+
invocation?: Invocation;
|
|
27
|
+
}
|
|
28
|
+
/** Arma el contexto real a partir del proceso de Node. */
|
|
29
|
+
export declare function processContext(): CliContext;
|
package/dist/context.js
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/** Arma el contexto real a partir del proceso de Node. */
|
|
2
|
+
export function processContext() {
|
|
3
|
+
return {
|
|
4
|
+
env: process.env,
|
|
5
|
+
cwd: process.cwd(),
|
|
6
|
+
stdout: process.stdout,
|
|
7
|
+
stderr: process.stderr,
|
|
8
|
+
stdin: process.stdin,
|
|
9
|
+
stdinIsTTY: Boolean(process.stdin.isTTY),
|
|
10
|
+
stdoutIsTTY: Boolean(process.stdout.isTTY),
|
|
11
|
+
stdoutColumns: process.stdout.columns,
|
|
12
|
+
stderrIsTTY: Boolean(process.stderr.isTTY),
|
|
13
|
+
now: () => Date.now(),
|
|
14
|
+
};
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=context.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AA6BA,0DAA0D;AAC1D,MAAM,UAAU,cAAc;IAC7B,OAAO;QACN,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QACxC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC1C,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;QACrC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC1C,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;KACrB,CAAC;AACH,CAAC"}
|
package/dist/errors.d.ts
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/** Un comando que arregla el error y cuándo conviene correrlo. */
|
|
2
|
+
export interface NextStep {
|
|
3
|
+
command: string;
|
|
4
|
+
when: string;
|
|
5
|
+
/** Flags globales que este comando deja afuera a propósito (no se le suman al mostrarlo, I1). */
|
|
6
|
+
omitGlobals?: string[];
|
|
7
|
+
}
|
|
8
|
+
/** Un campo inválido que devolvió la API (`issues` del error), tal cual llega del SDK. */
|
|
9
|
+
export interface ErrorIssue {
|
|
10
|
+
field: string;
|
|
11
|
+
message: string;
|
|
12
|
+
}
|
|
13
|
+
/** Datos extra del error: los `issues` y `details` de la API, o la causa de un error de red. */
|
|
14
|
+
export interface ErrorExtra {
|
|
15
|
+
issues?: ErrorIssue[];
|
|
16
|
+
details?: Record<string, unknown>;
|
|
17
|
+
/** Hace falta que una persona decida antes de seguir (p. ej. aprobar un borrado). */
|
|
18
|
+
userActionRequired?: boolean;
|
|
19
|
+
/** Las opciones entre las que tiene que elegir la persona cuando falta un id (C28). */
|
|
20
|
+
choices?: ErrorChoice[];
|
|
21
|
+
}
|
|
22
|
+
/** Una opción de `choices`: el id a pasar, el nombre que lo identifica para una persona y si es el actual (Q8). */
|
|
23
|
+
export interface ErrorChoice {
|
|
24
|
+
id: string;
|
|
25
|
+
name: string;
|
|
26
|
+
current?: true;
|
|
27
|
+
}
|
|
28
|
+
/** Error de la CLI con su `reason` estable, el código de salida (1 API/red, 2 mal uso) y los pasos para arreglarlo. */
|
|
29
|
+
export declare class CliError extends Error {
|
|
30
|
+
readonly reason: string;
|
|
31
|
+
readonly exitCode: 1 | 2;
|
|
32
|
+
readonly next: NextStep[];
|
|
33
|
+
readonly requestId?: string | undefined;
|
|
34
|
+
readonly issues: ErrorIssue[];
|
|
35
|
+
readonly details: Record<string, unknown>;
|
|
36
|
+
readonly userActionRequired: boolean;
|
|
37
|
+
readonly choices: ErrorChoice[] | undefined;
|
|
38
|
+
constructor(reason: string, message: string, exitCode: 1 | 2, next?: NextStep[], requestId?: string | undefined, extra?: ErrorExtra);
|
|
39
|
+
}
|
|
40
|
+
/** Lo que se sabe del comando que falló, para que los `next` sean comandos que se pueden correr tal cual. */
|
|
41
|
+
export interface ErrorHints {
|
|
42
|
+
/** Ruta del comando, p. ej. `["agents", "versions", "get"]`. */
|
|
43
|
+
command?: string[];
|
|
44
|
+
/** Los argumentos que escribió la persona, sin `node` ni el binario. */
|
|
45
|
+
args?: string[];
|
|
46
|
+
/** Los posicionales del comando por nombre, p. ej. `{ agent_id: "agt_1" }`. */
|
|
47
|
+
ids?: Record<string, string>;
|
|
48
|
+
/** Comando para seguir una conversación ya empezada (`agents run --thread`); lo usa un error a mitad del turno. */
|
|
49
|
+
continueCommand?: string;
|
|
50
|
+
}
|
|
51
|
+
/** `laburen <ruta> --help` del comando que se corrió, o `laburen --help` si no se sabe cuál. */
|
|
52
|
+
export declare function helpCommand(command?: string[]): string;
|
|
53
|
+
/** Recibe cualquier cosa que se lanzó y devuelve el error de la CLI con su `reason`, código de salida y `next`. */
|
|
54
|
+
export declare function toCliError(err: unknown, hints?: ErrorHints): CliError;
|