charness 3.6.1 → 3.7.0

package/dist/postToSession.d.ts

@@ -4,11 +4,12 @@
  * conversation's own sleeping session, else starts one if needed — let a
  * BUSY session finish its turn (up to {@link waitIdleTimeoutMs} — live work is
  * never interrupted on purpose; after the bound the forward takes the normal
- * interrupt path), then forward — unless an armed usage-limit wait holds the
- * prompt, checked before the session is touched and again right before the
- * forward (R23). The scheduler's fire (steps 3–4) and the Jira
- * connector's requests share it. Every side effect is injected, so the wait
- * loop runs on a fake clock in tests.
+ * interrupt path) and ensure the session again once it did (the stop that
+ * follows a per-turn conversation's turn may have put it to sleep), then forward —
+ * unless an armed usage-limit wait holds the prompt, checked before the session
+ * is touched and again right before the forward (R23). The scheduler's fire
+ * (steps 3–4) and the Jira connector's requests share it. Every side effect is
+ * injected, so the wait loop runs on a fake clock in tests.
  */
 /** Poll cadence for the wait-for-idle loop: re-check the busy probe every 5s. */
 export declare const busyPollIntervalMs = 5000;
@@ -91,4 +92,18 @@ export type PostToSessionResult = {
 export declare function postToSession(deps: PostToSessionDeps, conversationKey: string, prompt: string | SessionPromptText, fallbackAdapterName?: string, options?: {
     heldText?: string;
 }): Promise<PostToSessionResult>;
+/**
+ * @name PostToIdleSessionDeps
+ * @description `checkIsIdle` = the session is live and not working right now; `forward` writes the prompt.
+ */
+export interface PostToIdleSessionDeps {
+    checkIsIdle: () => boolean;
+    forward: () => Promise<void>;
+}
+/**
+ * @description The idle-only sibling of {@link postToSession} for a bot-made technical prompt (the todo list's
+ * staleness reminder): it never ensures, resumes or starts a session and never waits for a turn — a session that is
+ * not idle at this moment gets nothing (`false`). A forward that throws is logged and reads as not posted.
+ */
+export declare function postToIdleSession(deps: PostToIdleSessionDeps): Promise<boolean>;
 //# sourceMappingURL=postToSession.d.ts.map

package/dist/postToSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postToSession.d.ts","sourceRoot":"","sources":["../src/postToSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,CAAC;AAEnF,iHAAiH;AACjH,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,CAAC;AAErH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3F,sFAAsF;IACtF,SAAS,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD;iGAC6F;IAC7F,aAAa,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvG,sDAAsD;IACtD,aAAa,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,GACjD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAU3D,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,EACvB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAClC,mBAAmB,CAAC,EAAE,MAAM,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAiB9B"}
+{"version":3,"file":"postToSession.d.ts","sourceRoot":"","sources":["../src/postToSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,CAAC;AAEnF,iHAAiH;AACjH,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,CAAC;AAErH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3F,sFAAsF;IACtF,SAAS,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD;iGAC6F;IAC7F,aAAa,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvG,sDAAsD;IACtD,aAAa,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,GACjD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAU3D,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,EACvB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAClC,mBAAmB,CAAC,EAAE,MAAM,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,mBAAmB,CAAC,CA4B9B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CASrF"}

package/dist/postToSession.js

@@ -5,15 +5,17 @@
  * conversation's own sleeping session, else starts one if needed — let a
  * BUSY session finish its turn (up to {@link waitIdleTimeoutMs} — live work is
  * never interrupted on purpose; after the bound the forward takes the normal
- * interrupt path), then forward — unless an armed usage-limit wait holds the
- * prompt, checked before the session is touched and again right before the
- * forward (R23). The scheduler's fire (steps 3–4) and the Jira
- * connector's requests share it. Every side effect is injected, so the wait
- * loop runs on a fake clock in tests.
+ * interrupt path) and ensure the session again once it did (the stop that
+ * follows a per-turn conversation's turn may have put it to sleep), then forward —
+ * unless an armed usage-limit wait holds the prompt, checked before the session
+ * is touched and again right before the forward (R23). The scheduler's fire
+ * (steps 3–4) and the Jira connector's requests share it. Every side effect is
+ * injected, so the wait loop runs on a fake clock in tests.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.waitIdleTimeoutMs = exports.busyPollIntervalMs = void 0;
 exports.postToSession = postToSession;
+exports.postToIdleSession = postToIdleSession;
 /** Poll cadence for the wait-for-idle loop: re-check the busy probe every 5s. */
 exports.busyPollIntervalMs = 5000;
 /**
@@ -40,17 +42,46 @@ async function postToSession(deps, conversationKey, prompt, fallbackAdapterName,
     const session = await deps.ensureSession(conversationKey, fallbackAdapterName);
     if (!session.ok)
         return { ok: false, reason: session.reason };
-    if (deps.checkBusy(conversationKey))
+    const isWaitingForTurn = deps.checkBusy(conversationKey);
+    if (isWaitingForTurn)
         await waitForIdle(deps, conversationKey);
     // Again: the turn waited out above may itself have hit the limit and armed a wait.
     if (deps.holdForLimitResume?.(conversationKey, text, heldText))
         return { ok: true, isHeld: true };
+    let isFresh = session.isFresh;
+    if (isWaitingForTurn) {
+        // The session found live may be asleep by now: a per-turn conversation stops its process right after the turn
+        // waited out above, and a prompt written to the stopped process is dropped. The ensure queues behind a stop in
+        // progress, resumes the session when it is over, and is a no-op on a live one. It cannot slip in BESIDE the stop:
+        // the stop is queued in the same tick the turn ends (`handleAgentTurnEnded`), before any poll can see the idle.
+        const woken = await deps.ensureSession(conversationKey, fallbackAdapterName);
+        if (!woken.ok)
+            return { ok: false, reason: woken.reason };
+        isFresh = isFresh || woken.isFresh;
+    }
     try {
-        await deps.forwardPrompt(conversationKey, typeof prompt === 'string' ? prompt : prompt.buildText({ isFresh: session.isFresh }));
+        await deps.forwardPrompt(conversationKey, typeof prompt === 'string' ? prompt : prompt.buildText({ isFresh }));
     }
     catch (error) {
         return { ok: false, reason: 'forward-failed', error: error instanceof Error ? error.message : String(error) };
     }
     return { ok: true, isHeld: false };
 }
+/**
+ * @description The idle-only sibling of {@link postToSession} for a bot-made technical prompt (the todo list's
+ * staleness reminder): it never ensures, resumes or starts a session and never waits for a turn — a session that is
+ * not idle at this moment gets nothing (`false`). A forward that throws is logged and reads as not posted.
+ */
+async function postToIdleSession(deps) {
+    if (!deps.checkIsIdle())
+        return false;
+    try {
+        await deps.forward();
+        return true;
+    }
+    catch (error) {
+        console.warn('[postToIdleSession] the forward failed:', error instanceof Error ? error.message : error);
+        return false;
+    }
+}
 //# sourceMappingURL=postToSession.js.map

package/dist/postToSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"postToSession.js","sourceRoot":"","sources":["../src/postToSession.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAgFH,sCAuBC;AArGD,iFAAiF;AACpE,QAAA,kBAAkB,GAAG,IAAI,CAAC;AAEvC;;;;GAIG;AACU,QAAA,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AA8DhD,KAAK,UAAU,WAAW,CAAC,IAAuB,EAAE,eAAuB;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,yBAAiB,CAAC;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;YAAE,OAAO;QACnC,MAAM,IAAI,CAAC,KAAK,CAAC,0BAAkB,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,IAAuB,EACvB,eAAuB,EACvB,MAAkC,EAClC,mBAA4B,EAC5B,UAAiC,EAAE;IAEnC,2FAA2F;IAC3F,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACnE,gEAAgE;IAChE,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClG,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;IAC/E,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAC9D,IAAI,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;QAAE,MAAM,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC9E,mFAAmF;IACnF,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClG,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAClI,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAChH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC"}
+{"version":3,"file":"postToSession.js","sourceRoot":"","sources":["../src/postToSession.ts"],"names":[],"mappings":"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"}

package/dist/remoteRun/cliArgs.d.ts

@@ -0,0 +1,73 @@
+import { type RunnerCapability } from './probe';
+/**
+ * @description The command line of `charness remote-run`, parsed. Options come only BEFORE the command and parsing stops at the first
+ * non-option word (like `env` and `ssh`); a command whose first word is a subcommand name goes after `--`. A subcommand is recognised
+ * only as the very first word, so `remote-run --bg ls build` runs `ls build` and `remote-run ls` lists jobs.
+ */
+export interface RemoteRunOptions {
+    /** `--runner`: use this one. */
+    runner: string | null;
+    /** `--needs`: the first runner that has this capability. */
+    needs: RunnerCapability | null;
+    /** `--group`: the Pueue group the job joins. */
+    group: string | null;
+    /** `--timeout` in seconds; `null` = the default. */
+    timeoutSeconds: number | null;
+    /** `--with-git`: send `.git` too. */
+    isWithGit: boolean;
+    /** `-e NAME=VALUE`, in order. */
+    env: Array<{
+        name: string;
+        value: string;
+    }>;
+    /** `--bg`: print the job id and return. */
+    isBackground: boolean;
+}
+export type RemoteRunCommand = {
+    kind: 'help';
+} | {
+    kind: 'run';
+    options: RemoteRunOptions;
+    command: string;
+} | {
+    kind: 'ls';
+    isAll: boolean;
+} | {
+    kind: 'status';
+    jobId: string;
+} | {
+    kind: 'logs';
+    jobId: string;
+    isFollow: boolean;
+    tail: number | null;
+} | {
+    kind: 'wait';
+    jobId: string;
+} | {
+    kind: 'kill';
+    jobId: string;
+} | {
+    kind: 'fetch';
+    jobId: string;
+} | {
+    kind: 'exec';
+    runner: string | null;
+    command: string;
+} | {
+    kind: 'runners';
+};
+export type RemoteRunArgsParse = {
+    ok: true;
+    command: RemoteRunCommand;
+} | {
+    ok: false;
+    error: string;
+};
+export declare const defaultTimeoutSeconds: number;
+/** The longest `--timeout`: Node's timers keep delays only up to 2^31 ms (~24.8 days), a longer one fires at once and would kill the job. */
+export declare const maxTimeoutSeconds: number;
+/** @description `90m`, `3h`, `1h30m`, `45s`, `600` (seconds) as seconds; `null` when it is none of those or zero. */
+export declare function parseDuration(text: string): number | null;
+/** @description Parse the words after `charness remote-run`. */
+export declare function parseRemoteRunArgs(words: readonly string[]): RemoteRunArgsParse;
+//# sourceMappingURL=cliArgs.d.ts.map

package/dist/remoteRun/cliArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliArgs.d.ts","sourceRoot":"","sources":["../../src/remoteRun/cliArgs.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4DAA4D;IAC5D,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,gDAAgD;IAChD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oDAAoD;IACpD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,GAAG,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,2CAA2C;IAC3C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExG,eAAO,MAAM,qBAAqB,QAAc,CAAC;AACjD,6IAA6I;AAC7I,eAAO,MAAM,iBAAiB,QAAmB,CAAC;AAOlD,qHAAqH;AACrH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKzD;AA+HD,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CAwB/E"}

package/dist/remoteRun/cliArgs.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maxTimeoutSeconds = exports.defaultTimeoutSeconds = void 0;
+exports.parseDuration = parseDuration;
+exports.parseRemoteRunArgs = parseRemoteRunArgs;
+const jobId_1 = require("./jobId");
+const probe_1 = require("./probe");
+exports.defaultTimeoutSeconds = 3 * 60 * 60;
+/** The longest `--timeout`: Node's timers keep delays only up to 2^31 ms (~24.8 days), a longer one fires at once and would kill the job. */
+exports.maxTimeoutSeconds = 7 * 24 * 60 * 60;
+const groupNamePattern = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
+const envNamePattern = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const durationPartPattern = /(\d+)([hms]?)/g;
+const secondsPerUnit = { h: 3600, m: 60, s: 1, '': 1 };
+/** @description `90m`, `3h`, `1h30m`, `45s`, `600` (seconds) as seconds; `null` when it is none of those or zero. */
+function parseDuration(text) {
+    if (!/^(\d+[hms]?)+$/.test(text))
+        return null;
+    let totalSeconds = 0;
+    for (const part of text.matchAll(durationPartPattern))
+        totalSeconds += Number(part[1]) * secondsPerUnit[part[2]];
+    return totalSeconds > 0 ? totalSeconds : null;
+}
+function createDefaultOptions() {
+    return { runner: null, needs: null, group: null, timeoutSeconds: null, isWithGit: false, env: [], isBackground: false };
+}
+/** The value of `--name value` / `--name=value` at `index`, and how many words it took; `null` when this word is not that option. */
+function readOptionValue(words, index, name) {
+    const word = words[index];
+    if (word === name) {
+        const value = words[index + 1];
+        return value === undefined ? { value: undefined, consumed: 1 } : { value, consumed: 2 };
+    }
+    return word.startsWith(`${name}=`) ? { value: word.slice(name.length + 1), consumed: 1 } : null;
+}
+function parseJobIdArgument(words, commandName) {
+    const [jobId, ...extra] = words;
+    if (jobId === undefined)
+        return { ok: false, error: `${commandName} needs a job id` };
+    if ((0, jobId_1.parseJobId)(jobId) === null)
+        return { ok: false, error: `"${jobId}" is not a job id (they look like box1-abc234)` };
+    if (extra.length > 0)
+        return { ok: false, error: `${commandName} takes one job id, got extra: ${extra.join(' ')}` };
+    return { ok: true, jobId };
+}
+function parseLogsArguments(words) {
+    let isFollow = false;
+    let tail = null;
+    const positional = [];
+    for (let index = 0; index < words.length; index += 1) {
+        const word = words[index];
+        const tailOption = readOptionValue(words, index, '--tail');
+        if (word === '-f' || word === '--follow')
+            isFollow = true;
+        else if (tailOption !== null) {
+            const lineCount = Number(tailOption.value);
+            if (tailOption.value === undefined || !Number.isInteger(lineCount) || lineCount < 1)
+                return { ok: false, error: '--tail needs a whole number of lines, 1 or more' };
+            tail = lineCount;
+            index += tailOption.consumed - 1;
+        }
+        else if (word.startsWith('-'))
+            return { ok: false, error: `unknown option for logs: ${word}` };
+        else
+            positional.push(word);
+    }
+    const jobId = parseJobIdArgument(positional, 'logs');
+    return jobId.ok ? { ok: true, command: { kind: 'logs', jobId: jobId.jobId, isFollow, tail } } : jobId;
+}
+function parseExecArguments(words) {
+    let runner = null;
+    let index = 0;
+    for (; index < words.length; index += 1) {
+        const word = words[index];
+        if (word === '--') {
+            index += 1;
+            break;
+        }
+        const runnerOption = readOptionValue(words, index, '--runner');
+        if (runnerOption !== null) {
+            if (runnerOption.value === undefined || runnerOption.value === '')
+                return { ok: false, error: '--runner needs a runner name' };
+            runner = runnerOption.value;
+            index += runnerOption.consumed - 1;
+        }
+        else if (word.startsWith('-'))
+            return { ok: false, error: `unknown option for exec: ${word}` };
+        else
+            break;
+    }
+    const commandWords = words.slice(index);
+    if (commandWords.length === 0)
+        return { ok: false, error: 'exec needs a command' };
+    return { ok: true, command: { kind: 'exec', runner, command: commandWords.join(' ') } };
+}
+/** The value-taking options of a run, each as the code that stores the value. */
+function applyRunOption(options, name, value) {
+    if (name === '--runner') {
+        if (value === '' || value.startsWith('-'))
+            return '--runner needs a runner name';
+        options.runner = value;
+    }
+    else if (name === '--needs') {
+        const capability = probe_1.runnerCapabilities.find((candidate) => candidate === value);
+        if (capability === undefined)
+            return `--needs must be one of: ${probe_1.runnerCapabilities.join(', ')}`;
+        options.needs = capability;
+    }
+    else if (name === '--group') {
+        if (!groupNamePattern.test(value))
+            return '--group needs a Pueue group name (letters, digits, - and _)';
+        options.group = value;
+    }
+    else if (name === '--timeout') {
+        const seconds = parseDuration(value);
+        if (seconds === null)
+            return '--timeout needs a duration such as 90m, 3h, 1h30m or 600 (seconds)';
+        if (seconds > exports.maxTimeoutSeconds)
+            return '--timeout is at most 7 days';
+        options.timeoutSeconds = seconds;
+    }
+    else {
+        const separator = value.indexOf('=');
+        const envName = separator > 0 ? value.slice(0, separator) : '';
+        const envValue = separator > 0 ? value.slice(separator + 1) : '';
+        if (!envNamePattern.test(envName))
+            return '-e needs NAME=VALUE (NAME: letters, digits, _)';
+        if (/[\n\0]/.test(envValue))
+            return `-e ${envName}: the value must not hold a newline`;
+        options.env.push({ name: envName, value: envValue });
+    }
+    return null;
+}
+const runValueOptions = ['--runner', '--needs', '--group', '--timeout'];
+function parseRunArguments(words) {
+    const options = createDefaultOptions();
+    let index = 0;
+    for (; index < words.length; index += 1) {
+        const word = words[index];
+        if (word === '--') {
+            index += 1;
+            break;
+        }
+        if (!word.startsWith('-') || word === '-')
+            break;
+        if (word === '--bg') {
+            options.isBackground = true;
+            continue;
+        }
+        if (word === '--with-git') {
+            options.isWithGit = true;
+            continue;
+        }
+        const optionName = word === '-e' ? '-e' : runValueOptions.find((name) => word === name || word.startsWith(`${name}=`));
+        if (optionName === undefined)
+            return { ok: false, error: `unknown option: ${word} (options go before the command; a command that starts with "-" goes after --)` };
+        const reading = readOptionValue(words, index, optionName);
+        if (reading === null || reading.value === undefined)
+            return { ok: false, error: `${optionName} needs a value` };
+        const problem = applyRunOption(options, optionName, reading.value);
+        if (problem !== null)
+            return { ok: false, error: problem };
+        index += reading.consumed - 1;
+    }
+    const commandWords = words.slice(index);
+    if (commandWords.length === 0)
+        return { ok: false, error: 'no command given' };
+    return { ok: true, command: { kind: 'run', options, command: commandWords.join(' ') } };
+}
+/** @description Parse the words after `charness remote-run`. */
+function parseRemoteRunArgs(words) {
+    const [first, ...rest] = words;
+    if (first === undefined || first === '--help' || first === '-h' || first === 'help')
+        return { ok: true, command: { kind: 'help' } };
+    switch (first) {
+        case 'ls': {
+            const unknown = rest.find((word) => word !== '--all');
+            return unknown === undefined ? { ok: true, command: { kind: 'ls', isAll: rest.length > 0 } } : { ok: false, error: `unknown argument for ls: ${unknown}` };
+        }
+        case 'runners':
+            return rest.length === 0 ? { ok: true, command: { kind: 'runners' } } : { ok: false, error: 'runners takes no arguments' };
+        case 'logs':
+            return parseLogsArguments(rest);
+        case 'exec':
+            return parseExecArguments(rest);
+        case 'status':
+        case 'wait':
+        case 'kill':
+        case 'fetch': {
+            const jobId = parseJobIdArgument(rest, first);
+            return jobId.ok ? { ok: true, command: { kind: first, jobId: jobId.jobId } } : jobId;
+        }
+        default:
+            return parseRunArguments(words);
+    }
+}
+//# sourceMappingURL=cliArgs.js.map

package/dist/remoteRun/cliArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliArgs.js","sourceRoot":"","sources":["../../src/remoteRun/cliArgs.ts"],"names":[],"mappings":"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"}

package/dist/remoteRun/commands.d.ts

@@ -0,0 +1,56 @@
+import type { RemoteRunCommand } from './cliArgs';
+import { type InterruptSignal } from './exitCodes';
+import { type CliIo } from './output';
+import { type RunnerClient, type RunnerScript } from './runnerClient';
+import type { RunnersConfig } from './runnersConfig';
+/**
+ * @description The commands of `charness remote-run`, each as a function from its parsed arguments to an exit code. They share one
+ * context: the runners file, the local cache, the script to upload and the lease in force. Failures that are remote-run's own are
+ * {@link RemoteRunError}s; the entry point turns them into a `remote-run:` line on stderr and their exit code.
+ */
+export interface CommandContext {
+    io: CliIo;
+    config: RunnersConfig;
+    cacheDir: string;
+    script: RunnerScript;
+    leaseMs: number;
+    now: () => number;
+}
+export declare function runRunCommand(command: Extract<RemoteRunCommand, {
+    kind: 'run';
+}>, context: CommandContext): Promise<number>;
+export declare function runRunnersCommand(context: CommandContext): Promise<number>;
+export declare function runLsCommand(command: Extract<RemoteRunCommand, {
+    kind: 'ls';
+}>, context: CommandContext): Promise<number>;
+export declare function runStatusCommand(command: Extract<RemoteRunCommand, {
+    kind: 'status';
+}>, context: CommandContext): Promise<number>;
+export declare function runLogsCommand(command: Extract<RemoteRunCommand, {
+    kind: 'logs';
+}>, context: CommandContext): Promise<number>;
+export interface WaitRetryPolicy {
+    attempts: number;
+    delayMs: number;
+}
+/**
+ * @description Block until the runner says the job is done. A connection that drops is opened again a few times (the job is Pueue's, it
+ * keeps running); a refusal of the runner itself — no such job (never submitted, pruned, a submit that failed half-way) — is final and
+ * says so at once instead of passing for a bad network. Resolves with the signal that interrupted the wait, if one did.
+ */
+export declare function waitForJob(client: RunnerClient, jobId: string, retry?: WaitRetryPolicy): Promise<InterruptSignal | null>;
+export declare function runWaitCommand(command: Extract<RemoteRunCommand, {
+    kind: 'wait';
+}>, context: CommandContext): Promise<number>;
+export declare function runFetchCommand(command: Extract<RemoteRunCommand, {
+    kind: 'fetch';
+}>, context: CommandContext): Promise<number>;
+export declare function runKillCommand(command: Extract<RemoteRunCommand, {
+    kind: 'kill';
+}>, context: CommandContext): Promise<number>;
+/** @description What `kill` tells the user: the runner answers `killed`, or `already-ended <code>` for a job that had finished (nothing was killed then). */
+export declare function describeKillResult(jobId: string, runnerAnswer: string): string;
+export declare function runExecCommand(command: Extract<RemoteRunCommand, {
+    kind: 'exec';
+}>, context: CommandContext): Promise<number>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/remoteRun/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/remoteRun/commands.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAqC,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAUtF,OAAO,EAAiC,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAIrE,OAAO,EAA6C,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAuCD,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBjI;AAID,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAKhF;AAyBD,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB/H;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAOvI;AAID,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BnI;AAID,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,eAAoF,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAoBlM;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBnI;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAOrI;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAMnI;AAED,6JAA6J;AAC7J,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAG9E;AAID,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAMnI"}