@ansible-flow/node 0.0.0-stage → 0.85.0

package/dist/run/segments.js

@@ -0,0 +1,157 @@
+import {
+  runFlow
+} from "../chunks/chunk-LGUG2Q7Z.js";
+import "../chunks/chunk-RETJPSKL.js";
+import "../chunks/chunk-THNSGAKN.js";
+import "../chunks/chunk-FG53MLUX.js";
+import {
+  runsDir
+} from "../chunks/chunk-4FHPTGI4.js";
+import "../chunks/chunk-SSZNBJZQ.js";
+import "../chunks/chunk-JDPN3LTT.js";
+import "../chunks/chunk-NTZRNEZM.js";
+import "../chunks/chunk-SUV3VHKR.js";
+import "../chunks/chunk-I6FIOP7G.js";
+import {
+  withoutBookkeeping
+} from "../chunks/chunk-A2NMQGQE.js";
+import "../chunks/chunk-GAL5LW6Y.js";
+import "../chunks/chunk-IIFP6UQR.js";
+
+// src/node/run/segments.ts
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { summarizeRun } from "@ansible-flow/core/run/events";
+function segmentOutcome(segment, events) {
+  let carried = {};
+  for (const line of events.split("\n")) {
+    if (!line.includes('"stats"')) continue;
+    try {
+      const e = JSON.parse(line);
+      if (e.event === "stats" && e.custom) carried = e.custom;
+    } catch {
+    }
+  }
+  const empty = String(carried.afd_gate_empty).toLowerCase() === "true";
+  return { carried, waiting: !!segment.gate && !empty && "afd_hostsets" in carried, empty };
+}
+function nextSegment(segments, from, decision) {
+  if (decision === "empty") return segments.find((s) => s.finish);
+  const outcome = decision === "approved" ? "approved" : "rejected";
+  return segments.find((s) => s.parent === from && s.entry?.outcome === outcome);
+}
+function segmentInputs(inputs, carried, decision) {
+  return { ...inputs, ...carried, ...decision ? { afd_gate_outcome: decision } : {} };
+}
+function segmentsSummary(events, routes) {
+  return withoutBookkeeping(summarizeRun(events.filter(Boolean).join("\n"), routes));
+}
+async function runSegments(request, segments, hooks) {
+  const generated = request.playbook.slice(0, request.playbook.lastIndexOf("/") + 1);
+  const approvals = {};
+  const events = [];
+  let segment = segments.find((s) => s.name === "start");
+  let inputs = request.inputs;
+  let last;
+  const view = (run) => ({
+    ...run,
+    id: request.id,
+    summary: segmentsSummary(events, request.code.routes),
+    ...Object.keys(approvals).length ? { approvals: { ...approvals } } : {}
+  });
+  for (let k = 0; segment; k++) {
+    const current = segment;
+    const id = `${request.id}-${k}`;
+    const run = await runFlow(
+      { ...request, id, playbook: `${generated}${current.file}`, inputs },
+      {
+        ...hooks,
+        // While a segment runs: what the ones before did, and what this one does so far.
+        report: (r) => hooks.report({
+          ...r,
+          id: request.id,
+          ...r.summary ? { summary: mergeLive(events, r.summary, request.code.routes) } : {},
+          ...Object.keys(approvals).length ? { approvals: { ...approvals } } : {}
+        })
+      }
+    );
+    last = run;
+    const text = await readFile(
+      join(runsDir(request.storage, request.doc.flow.id), id, "events.jsonl"),
+      "utf8"
+    ).catch(() => "");
+    events.push(text);
+    if (run.state === "error" && run.errorCode === "cancelled") break;
+    const outcome = segmentOutcome(current, text);
+    if (!current.gate) break;
+    if (outcome.empty) {
+      segment = nextSegment(segments, current.name, "empty");
+      inputs = segmentInputs(request.inputs, outcome.carried);
+      continue;
+    }
+    if (!outcome.waiting) break;
+    approvals[current.gate] = { status: "waiting" };
+    const waiting = view({ ...run, state: "running" });
+    hooks.report(waiting);
+    let decided;
+    try {
+      decided = await hooks.decide(current.gate, waiting);
+    } catch {
+      approvals[current.gate] = { status: "waiting" };
+      const stopped = view({
+        ...run,
+        state: "error",
+        error: "Stopped while waiting for approval",
+        errorCode: "cancelled",
+        finishedAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      hooks.report(stopped);
+      return stopped;
+    }
+    const { decision, ...said } = decided;
+    approvals[current.gate] = {
+      ...said,
+      status: decision === "approved" ? "approved" : decision === "timeout" ? "timed out" : "rejected"
+    };
+    segment = nextSegment(segments, current.name, decision);
+    inputs = segmentInputs(request.inputs, outcome.carried, decision);
+  }
+  const done = view(
+    last ?? {
+      id: request.id,
+      mode: request.mode,
+      state: "error",
+      startedAt: request.startedAt,
+      error: "The flow has no start segment"
+    }
+  );
+  hooks.report(done);
+  return done;
+}
+function mergeLive(before, live, routes) {
+  if (before.length === 0) return withoutBookkeeping(live);
+  const earlier = segmentsSummary(before, routes);
+  const nodes = structuredClone(earlier.nodes);
+  for (const [node, ports] of Object.entries(live.nodes))
+    for (const [port, hosts] of Object.entries(ports)) {
+      nodes[node] ??= {};
+      const into = nodes[node];
+      into[port] = [.../* @__PURE__ */ new Set([...into[port] ?? [], ...hosts])];
+    }
+  return withoutBookkeeping({
+    ...live,
+    nodes,
+    hosts: [.../* @__PURE__ */ new Set([...earlier.hosts, ...live.hosts])],
+    failures: [...earlier.failures, ...live.failures],
+    outcome: { ...earlier.outcome, ...live.outcome },
+    unreachable: [.../* @__PURE__ */ new Set([...earlier.unreachable, ...live.unreachable])]
+  });
+}
+export {
+  nextSegment,
+  runSegments,
+  segmentInputs,
+  segmentOutcome,
+  segmentsSummary
+};
+//# sourceMappingURL=segments.js.map

package/dist/run/segments.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/node/run/segments.ts"],
+  "sourcesContent": ["// Runs of a flow with top-level approvals outside AWX (AFD-272, ADR-0016). The flow's code comes\n// in segments (engine/optionA): `start` runs until the hosts reach an approval and carries the\n// host sets in set_stats; after a decision `<gate>-approved` or `<gate>-rejected` restores them\n// and goes on; `finish` runs the outcome when no host reached the gate. AWX chains them as a\n// workflow; here they are chained step by step:\n//\n// - `segmentOutcome` reads what a segment's run ended with (its events): the host sets it\n//   carried, and whether hosts wait at its gate.\n// - `nextSegment` names the segment to run after a decision (or after an empty gate).\n// - `segmentInputs` are the next segment's inputs: the run's, the carried sets, the decision.\n// - `segmentsSummary` is the run as one: every segment's events, summarized with the flow's routes.\n//\n// A host that waits for a decision longer than a process should (a server that may restart)\n// keeps the carried sets itself and calls these between processes. `runSegments` chains them in\n// one call, with a `decide` that waits for each gate's decision.\nimport { readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport type { SegmentFile } from '../../core/engine/types';\nimport type { Ulid } from '../../core/flow/types';\nimport type { RunApproval, RunView } from '../../core/protocol';\nimport { type RunSummary, summarizeRun } from '../../core/run/events';\nimport { withoutBookkeeping } from '../awx/awxWorkflow';\nimport { runsDir } from './pastRuns';\nimport { type RunFlowHooks, type RunFlowRequest, runFlow } from './runFlow';\n\n/** How a gate was decided. `timeout` takes the approval's timeout port (else rejected's). */\nexport type GateDecision = 'approved' | 'rejected' | 'timeout';\n\n/** What a segment's run left for the next one. */\nexport interface SegmentOutcome {\n  /** The set_stats data the segment carried (`afd_hostsets`, `afd_gate_empty`); empty if none. */\n  carried: Record<string, unknown>;\n  /** Hosts wait at the segment's gate: a decision is needed. */\n  waiting: boolean;\n  /** The gate had no host: the flow goes on with `finish`. */\n  empty: boolean;\n}\n\n/** The carried data of a segment's run, from its events (the last stats event's `custom`). */\nexport function segmentOutcome(segment: SegmentFile, events: string): SegmentOutcome {\n  let carried: Record<string, unknown> = {};\n  for (const line of events.split('\\n')) {\n    if (!line.includes('\"stats\"')) continue;\n    try {\n      const e = JSON.parse(line) as { event?: string; custom?: Record<string, unknown> };\n      if (e.event === 'stats' && e.custom) carried = e.custom;\n    } catch {}\n  }\n  const empty = String(carried.afd_gate_empty).toLowerCase() === 'true';\n  return { carried, waiting: !!segment.gate && !empty && 'afd_hostsets' in carried, empty };\n}\n\n/**\n * The segment after `from`: its approved or rejected continuation for a decision (a timeout runs\n * the rejected one, which then takes the timeout port), `finish` when nobody reached its gate.\n * Undefined when there is none: the run has ended.\n */\nexport function nextSegment(\n  segments: SegmentFile[],\n  from: string,\n  decision: GateDecision | 'empty',\n): SegmentFile | undefined {\n  if (decision === 'empty') return segments.find((s) => s.finish);\n  const outcome = decision === 'approved' ? 'approved' : 'rejected';\n  return segments.find((s) => s.parent === from && s.entry?.outcome === outcome);\n}\n\n/** The inputs of the segment after a decision: the run's, the carried host sets, the decision. */\nexport function segmentInputs(\n  inputs: Record<string, unknown>,\n  carried: Record<string, unknown>,\n  decision?: GateDecision,\n): Record<string, unknown> {\n  return { ...inputs, ...carried, ...(decision ? { afd_gate_outcome: decision } : {}) };\n}\n\n/** The run as one: the events of its segments in order, summarized with the flow's routes. */\nexport function segmentsSummary(\n  events: string[],\n  routes: Parameters<typeof summarizeRun>[1],\n): RunSummary {\n  // The plays that restore and carry host sets run on localhost outside any node.\n  return withoutBookkeeping(summarizeRun(events.filter(Boolean).join('\\n'), routes));\n}\n\nexport interface SegmentsHooks extends RunFlowHooks {\n  /**\n   * The decision for the approval `gate`, when hosts wait there. Called with the run as it is\n   * then (state `running`, the gate's approval `waiting`). Rejects to stop the run.\n   */\n  decide(gate: Ulid, run: RunView): Promise<{ decision: GateDecision } & Partial<RunApproval>>;\n}\n\n/**\n * Runs a flow with approval gates segment by segment in one call: each segment is a `runFlow` of\n * its playbook (folder `<id>-<n>`), each gate waits for `decide`. Reports the run as one (id\n * `request.id`), with its approvals; resolves with the finished run. Never rejects.\n */\nexport async function runSegments(\n  request: RunFlowRequest,\n  segments: SegmentFile[],\n  hooks: SegmentsHooks,\n): Promise<RunView> {\n  const generated = request.playbook.slice(0, request.playbook.lastIndexOf('/') + 1);\n  const approvals: Record<Ulid, RunApproval> = {};\n  const events: string[] = [];\n  let segment = segments.find((s) => s.name === 'start');\n  let inputs = request.inputs;\n  let last: RunView | undefined;\n  /** The run as one, with what the segments that ended did. */\n  const view = (run: RunView): RunView => ({\n    ...run,\n    id: request.id,\n    summary: segmentsSummary(events, request.code.routes),\n    ...(Object.keys(approvals).length ? { approvals: { ...approvals } } : {}),\n  });\n  for (let k = 0; segment; k++) {\n    const current = segment;\n    const id = `${request.id}-${k}`;\n    const run = await runFlow(\n      { ...request, id, playbook: `${generated}${current.file}`, inputs },\n      {\n        ...hooks,\n        // While a segment runs: what the ones before did, and what this one does so far.\n        report: (r) =>\n          hooks.report({\n            ...r,\n            id: request.id,\n            ...(r.summary ? { summary: mergeLive(events, r.summary, request.code.routes) } : {}),\n            ...(Object.keys(approvals).length ? { approvals: { ...approvals } } : {}),\n          }),\n      },\n    );\n    last = run;\n    const text = await readFile(\n      join(runsDir(request.storage, request.doc.flow.id), id, 'events.jsonl'),\n      'utf8',\n    ).catch(() => '');\n    events.push(text);\n    if (run.state === 'error' && run.errorCode === 'cancelled') break;\n    const outcome = segmentOutcome(current, text);\n    if (!current.gate) break;\n    if (outcome.empty) {\n      segment = nextSegment(segments, current.name, 'empty');\n      inputs = segmentInputs(request.inputs, outcome.carried);\n      continue;\n    }\n    if (!outcome.waiting) break;\n    approvals[current.gate] = { status: 'waiting' };\n    const waiting = view({ ...run, state: 'running' });\n    hooks.report(waiting);\n    let decided: { decision: GateDecision } & Partial<RunApproval>;\n    try {\n      decided = await hooks.decide(current.gate, waiting);\n    } catch {\n      approvals[current.gate] = { status: 'waiting' };\n      const stopped: RunView = view({\n        ...run,\n        state: 'error',\n        error: 'Stopped while waiting for approval',\n        errorCode: 'cancelled',\n        finishedAt: new Date().toISOString(),\n      });\n      hooks.report(stopped);\n      return stopped;\n    }\n    const { decision, ...said } = decided;\n    approvals[current.gate] = {\n      ...said,\n      status:\n        decision === 'approved' ? 'approved' : decision === 'timeout' ? 'timed out' : 'rejected',\n    };\n    segment = nextSegment(segments, current.name, decision);\n    inputs = segmentInputs(request.inputs, outcome.carried, decision);\n  }\n  const done = view(\n    last ?? {\n      id: request.id,\n      mode: request.mode,\n      state: 'error',\n      startedAt: request.startedAt,\n      error: 'The flow has no start segment',\n    },\n  );\n  hooks.report(done);\n  return done;\n}\n\n/** A live segment's summary added to what the segments before it did. */\nfunction mergeLive(\n  before: string[],\n  live: RunSummary,\n  routes: Parameters<typeof summarizeRun>[1],\n): RunSummary {\n  if (before.length === 0) return withoutBookkeeping(live);\n  const earlier = segmentsSummary(before, routes);\n  const nodes: RunSummary['nodes'] = structuredClone(earlier.nodes);\n  for (const [node, ports] of Object.entries(live.nodes))\n    for (const [port, hosts] of Object.entries(ports)) {\n      nodes[node] ??= {};\n      const into = nodes[node] as Record<string, string[]>;\n      into[port] = [...new Set([...(into[port] ?? []), ...hosts])];\n    }\n  return withoutBookkeeping({\n    ...live,\n    nodes,\n    hosts: [...new Set([...earlier.hosts, ...live.hosts])],\n    failures: [...earlier.failures, ...live.failures],\n    outcome: { ...earlier.outcome, ...live.outcome },\n    unreachable: [...new Set([...earlier.unreachable, ...live.unreachable])],\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/run/stop.d.ts

@@ -0,0 +1,3 @@
+import type { ProcessSpec } from '@ansible-flow/core/run/command';
+/** Runs `spec.stop` when it has one. Resolves once it ended or after `timeoutMs`; never rejects. */
+export declare function stopStarted(spec: ProcessSpec, timeoutMs?: number): Promise<void>;

package/dist/run/stop.js

@@ -0,0 +1,7 @@
+import {
+  stopStarted
+} from "../chunks/chunk-JDPN3LTT.js";
+export {
+  stopStarted
+};
+//# sourceMappingURL=stop.js.map

package/dist/run/stop.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/run/storage.d.ts

@@ -0,0 +1,16 @@
+/** Run folders kept per flow when `afd.runs.keep` is not set. */
+export declare const KEEP_RUNS = 30;
+/** Removes a run's vars.json once ansible-playbook is done with it. */
+export declare function dropVars(runDir: string): Promise<void>;
+/** Keeps the newest `keep` run folders of a flow (run ids are sortable time stamps). */
+export declare function pruneRuns(storage: string, flowId: string, keep: number): Promise<void>;
+/**
+ * At startup, when no run is going: removes the vars.json files earlier versions left behind (they
+ * held every input, secrets included) and applies the retention to every flow.
+ */
+export declare function sweepRuns(storage: string, keep: number): Promise<void>;
+/**
+ * Rotates `<name>.jsonl` once it reaches `limit` bytes: it becomes `<name>.1.jsonl`, the older ones
+ * move up, and only `old` of them are kept.
+ */
+export declare function rotateLog(file: string, limit: number, old: number): Promise<void>;

package/dist/run/storage.js

@@ -0,0 +1,15 @@
+import {
+  KEEP_RUNS,
+  dropVars,
+  pruneRuns,
+  rotateLog,
+  sweepRuns
+} from "../chunks/chunk-SUV3VHKR.js";
+export {
+  KEEP_RUNS,
+  dropVars,
+  pruneRuns,
+  rotateLog,
+  sweepRuns
+};
+//# sourceMappingURL=storage.js.map

package/dist/run/storage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/run/tail.d.ts

@@ -0,0 +1,5 @@
+export interface Tail {
+    /** One last read; a final line without a line break counts too. */
+    stop(): Promise<void>;
+}
+export declare function tailFile(path: string, onLines: (lines: string[]) => void, intervalMs?: number): Tail;

package/dist/run/tail.js

@@ -0,0 +1,7 @@
+import {
+  tailFile
+} from "../chunks/chunk-SSZNBJZQ.js";
+export {
+  tailFile
+};
+//# sourceMappingURL=tail.js.map

package/dist/run/tail.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runner/client.d.ts

@@ -0,0 +1,149 @@
+export declare class RunnerError extends Error {
+    readonly status?: number | undefined;
+    /** The server's error code (`not_found`, `read_only_token`, …). */
+    readonly code?: string | undefined;
+    /** A launch's problems, by field. */
+    readonly problems?: {
+        field?: string;
+        message: string;
+    }[] | undefined;
+    constructor(message: string, status?: number | undefined, 
+    /** The server's error code (`not_found`, `read_only_token`, …). */
+    code?: string | undefined, 
+    /** A launch's problems, by field. */
+    problems?: {
+        field?: string;
+        message: string;
+    }[] | undefined);
+}
+export interface RunnerMeta {
+    name: string;
+    version: string;
+    api: string;
+    designer: {
+        version: string;
+        format: number;
+        formats?: number[];
+        bundle?: string;
+    };
+    features?: string[];
+}
+export interface RunnerProject {
+    id: string;
+    key: string;
+    name: string;
+    gitPath: string;
+    gitRef: string;
+    commit?: string;
+}
+export interface RunnerConfig {
+    id: string;
+    name: string;
+    flowFile: string;
+    mode: 'check' | 'real';
+    inventory?: string;
+    gitRef?: string;
+    commit?: string;
+}
+/** What a launch would run (the server's PreparedLaunch, without its inputs). */
+export interface RunnerLaunch {
+    commit: string;
+    ref?: string;
+    flow: {
+        file: string;
+        key: string;
+        name: string;
+        version: number;
+    };
+    mode: 'check' | 'real';
+    inventory?: string;
+    targets: string[];
+}
+export interface RunnerRun {
+    id: string;
+    number: number;
+    project: string;
+    commit: string;
+    flow: {
+        file: string;
+        key: string;
+        name: string;
+    };
+    mode: 'check' | 'real';
+    state: 'queued' | 'running' | 'waiting' | 'succeeded' | 'failed' | 'cancelled' | 'lost';
+    error?: string;
+    endedAt?: string;
+    /** AFD-282: a check run of someone's unpushed work. */
+    dev?: true;
+}
+export interface RunnerGate {
+    node: {
+        id: string;
+        key: string;
+        title: string;
+    };
+    status: string;
+    mayDecide: boolean;
+    why?: string;
+}
+export interface LaunchRequest {
+    mode?: 'check' | 'real';
+    /** AFD-282: a dev bundle's id: the server runs its commit, in check mode. */
+    dev?: string;
+    limit?: string;
+    /** The flow's inputs as typed text, by name. */
+    inputs?: Record<string, string>;
+}
+/** The REST API this client speaks. */
+export declare const RUNNER_API = "v1";
+/** Why this client and the server do not fit for a flow in `format`, or undefined. */
+export declare function incompatible(meta: RunnerMeta, format: number): string | undefined;
+export interface RunnerOptions {
+    verifyTls?: boolean;
+    /** Send the token over plain http to another machine (a lab only). */
+    allowHttp?: boolean;
+    timeoutMs?: number;
+}
+export declare class RunnerClient {
+    private readonly token;
+    private readonly options;
+    readonly base: string;
+    private readonly origin;
+    constructor(url: string, token: string, options?: RunnerOptions);
+    /** A run's page on the server. */
+    runUrl(id: string): string;
+    /** The answer's body as text, and its status. */
+    private send;
+    request<T>(method: string, path: string, body?: unknown, raw?: {
+        bytes: Buffer;
+        type: string;
+    }): Promise<T>;
+    /** The output of a request whose answer is plain text. */
+    text(path: string): Promise<string>;
+    meta: () => Promise<RunnerMeta>;
+    me: () => Promise<{
+        login: string;
+        name: string;
+    }>;
+    projects: (workspace: string) => Promise<RunnerProject[]>;
+    project: (id: string) => Promise<RunnerProject>;
+    configs: (project: string) => Promise<RunnerConfig[]>;
+    check: (config: string, req: LaunchRequest) => Promise<RunnerLaunch>;
+    launch: (config: string, req: LaunchRequest) => Promise<RunnerRun>;
+    run: (id: string) => Promise<RunnerRun>;
+    /** How the run went, as the designer shows it (the server's RunView); 404 until it has one. */
+    view: (id: string) => Promise<Record<string, unknown> | undefined>;
+    gates: (id: string) => Promise<RunnerGate[]>;
+    cancel: (id: string) => Promise<RunnerRun>;
+    decide: (id: string, node: string, decision: 'approved' | 'rejected', comment?: string) => Promise<unknown>;
+    /** AFD-282: unpushed work for a dev run; resolves with the bundle's id and commit. */
+    devBundle: (project: string, bytes: Buffer) => Promise<{
+        id: string;
+        commit: string;
+        expiresAt: string;
+    }>;
+    /** What one host did in one step of the run. */
+    hostOutput: (id: string, node: string, host: string) => Promise<{
+        entries?: unknown[];
+    }>;
+}

package/dist/runner/client.js

@@ -0,0 +1,168 @@
+import {
+  cleartextTo
+} from "../chunks/chunk-GAL5LW6Y.js";
+import {
+  TIMEOUTS
+} from "../chunks/chunk-IIFP6UQR.js";
+
+// src/node/runner/client.ts
+import * as http from "node:http";
+import * as https from "node:https";
+var RunnerError = class extends Error {
+  constructor(message, status, code, problems) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.problems = problems;
+    this.name = "RunnerError";
+  }
+  status;
+  code;
+  problems;
+};
+var RUNNER_API = "v1";
+function incompatible(meta, format) {
+  if (meta.name !== "Ansible Flow Server") return "The address is not an Ansible Flow Server";
+  if (meta.api !== RUNNER_API)
+    return `The server speaks API ${meta.api}; this extension speaks ${RUNNER_API}: update the one that is older`;
+  const formats = meta.designer.formats ?? [meta.designer.format];
+  if (!formats.includes(format))
+    return `The flow is in format ${format}; the server (${meta.version}) reads formats ${formats.join(", ")}: upgrade the server`;
+  return void 0;
+}
+var MAX_BODY = 32 * 1024 * 1024;
+var enc = encodeURIComponent;
+var RunnerClient = class {
+  constructor(url, token, options = {}) {
+    this.token = token;
+    this.options = options;
+    this.base = url.replace(/\/+$/, "");
+    this.origin = new URL(this.base).origin;
+  }
+  token;
+  options;
+  base;
+  origin;
+  /** A run's page on the server. */
+  runUrl(id) {
+    return `${this.base}/runs/${enc(id)}`;
+  }
+  /** The answer's body as text, and its status. */
+  send(method, path, body, raw) {
+    const url = new URL(`${this.base}${path}`);
+    if (url.origin !== this.origin)
+      return Promise.reject(new RunnerError(`Not sending the token to ${url.origin}`));
+    if (cleartextTo(url) && !this.options.allowHttp)
+      return Promise.reject(
+        new RunnerError(
+          `Not sending the token unencrypted to ${url.origin}: use an https address, or turn on afd.runner.allowHttp in your user settings (a lab server only)`
+        )
+      );
+    const lib = url.protocol === "https:" ? https : http;
+    const data = raw?.bytes ?? (body === void 0 ? void 0 : JSON.stringify(body));
+    const type = raw?.type ?? "application/json";
+    return new Promise((resolve, reject) => {
+      const req = lib.request(
+        url,
+        {
+          method,
+          headers: {
+            Authorization: `Bearer ${this.token}`,
+            Accept: "application/json",
+            ...data ? { "Content-Type": type, "Content-Length": Buffer.byteLength(data) } : {}
+          },
+          timeout: this.options.timeoutMs ?? TIMEOUTS.runnerRequest,
+          ...url.protocol === "https:" ? { rejectUnauthorized: this.options.verifyTls !== false } : {}
+        },
+        (res) => {
+          const chunks = [];
+          let size = 0;
+          res.on("data", (c) => {
+            size += c.length;
+            if (size > MAX_BODY) {
+              req.destroy(new Error("the answer is too large"));
+              return;
+            }
+            chunks.push(c);
+          });
+          res.on(
+            "end",
+            () => resolve({ status: res.statusCode ?? 0, text: Buffer.concat(chunks).toString("utf8") })
+          );
+          res.on("error", reject);
+        }
+      );
+      req.on("timeout", () => req.destroy(new Error("no answer in time")));
+      req.on(
+        "error",
+        (e) => reject(new RunnerError(`The server at ${this.base} does not answer: ${e.message}`))
+      );
+      req.end(data);
+    });
+  }
+  async request(method, path, body, raw) {
+    const { status, text } = await this.send(method, path, body, raw);
+    let json;
+    try {
+      json = text ? JSON.parse(text) : void 0;
+    } catch {
+      json = void 0;
+    }
+    if (status >= 200 && status < 300) return json;
+    const e = json ?? {};
+    const why = status === 401 ? "The server does not take the token: set it again (it may have expired or been revoked)" : status === 413 ? "The work is larger than the server takes (AFS_DEV_BUNDLE_MAX_MB)" : e.message ?? `The server answered ${status}`;
+    throw new RunnerError(why, status, e.error, e.problems);
+  }
+  /** The output of a request whose answer is plain text. */
+  async text(path) {
+    const { status, text } = await this.send("GET", path);
+    if (status >= 200 && status < 300) return text;
+    throw new RunnerError(`The server answered ${status}`, status);
+  }
+  meta = () => this.request("GET", "/api/v1/meta");
+  me = () => this.request("GET", "/api/v1/session");
+  projects = (workspace) => this.request("GET", `/api/v1/workspaces/${enc(workspace)}/projects`);
+  project = (id) => this.request("GET", `/api/v1/projects/${enc(id)}`);
+  configs = (project) => this.request("GET", `/api/v1/projects/${enc(project)}/launch-configs`);
+  check = async (config, req) => (await this.request(
+    "POST",
+    `/api/v1/launch-configs/${enc(config)}/check`,
+    req
+  )).launch;
+  launch = (config, req) => this.request("POST", `/api/v1/launch-configs/${enc(config)}/launch`, req);
+  run = (id) => this.request("GET", `/api/v1/runs/${enc(id)}`);
+  /** How the run went, as the designer shows it (the server's RunView); 404 until it has one. */
+  view = async (id) => {
+    try {
+      return await this.request("GET", `/api/v1/runs/${enc(id)}/view`);
+    } catch (e) {
+      if (e instanceof RunnerError && e.status === 404) return void 0;
+      throw e;
+    }
+  };
+  gates = (id) => this.request("GET", `/api/v1/runs/${enc(id)}/approvals`);
+  cancel = (id) => this.request("POST", `/api/v1/runs/${enc(id)}/cancel`);
+  decide = (id, node, decision, comment) => this.request("POST", `/api/v1/runs/${enc(id)}/approvals/${enc(node)}`, {
+    decision,
+    ...comment?.trim() ? { comment: comment.trim() } : {}
+  });
+  /** AFD-282: unpushed work for a dev run; resolves with the bundle's id and commit. */
+  devBundle = (project, bytes) => this.request(
+    "POST",
+    `/api/v1/projects/${enc(project)}/dev-bundles`,
+    void 0,
+    { bytes, type: "application/x-git-bundle" }
+  );
+  /** What one host did in one step of the run. */
+  hostOutput = (id, node, host) => this.request(
+    "GET",
+    `/api/v1/runs/${enc(id)}/hosts/${enc(node)}/${enc(host)}`
+  );
+};
+export {
+  RUNNER_API,
+  RunnerClient,
+  RunnerError,
+  incompatible
+};
+//# sourceMappingURL=client.js.map

package/dist/runner/client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/node/runner/client.ts"],
+  "sourcesContent": ["// A client of Ansible Flow Server (AFD-276): the routes the extension's server target uses, as\n// the designer's contract with the server names them (contract/server-api.json, AFD-280).\n// node:http(s) rather than fetch so TLS verification can be turned off for a lab server, as the\n// AWX client does; the token travels only in the Authorization header, to the configured server.\nimport * as http from 'node:http';\nimport * as https from 'node:https';\nimport { cleartextTo } from '../awx/client';\nimport { TIMEOUTS } from '../timeouts';\n\nexport class RunnerError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number,\n    /** The server's error code (`not_found`, `read_only_token`, \u2026). */\n    readonly code?: string,\n    /** A launch's problems, by field. */\n    readonly problems?: { field?: string; message: string }[],\n  ) {\n    super(message);\n    this.name = 'RunnerError';\n  }\n}\n\nexport interface RunnerMeta {\n  name: string;\n  version: string;\n  api: string;\n  designer: { version: string; format: number; formats?: number[]; bundle?: string };\n  features?: string[];\n}\n\nexport interface RunnerProject {\n  id: string;\n  key: string;\n  name: string;\n  gitPath: string;\n  gitRef: string;\n  commit?: string;\n}\n\nexport interface RunnerConfig {\n  id: string;\n  name: string;\n  flowFile: string;\n  mode: 'check' | 'real';\n  inventory?: string;\n  gitRef?: string;\n  commit?: string;\n}\n\n/** What a launch would run (the server's PreparedLaunch, without its inputs). */\nexport interface RunnerLaunch {\n  commit: string;\n  ref?: string;\n  flow: { file: string; key: string; name: string; version: number };\n  mode: 'check' | 'real';\n  inventory?: string;\n  targets: string[];\n}\n\nexport interface RunnerRun {\n  id: string;\n  number: number;\n  project: string;\n  commit: string;\n  flow: { file: string; key: string; name: string };\n  mode: 'check' | 'real';\n  state: 'queued' | 'running' | 'waiting' | 'succeeded' | 'failed' | 'cancelled' | 'lost';\n  error?: string;\n  endedAt?: string;\n  /** AFD-282: a check run of someone's unpushed work. */\n  dev?: true;\n}\n\nexport interface RunnerGate {\n  node: { id: string; key: string; title: string };\n  status: string;\n  mayDecide: boolean;\n  why?: string;\n}\n\nexport interface LaunchRequest {\n  mode?: 'check' | 'real';\n  /** AFD-282: a dev bundle's id: the server runs its commit, in check mode. */\n  dev?: string;\n  limit?: string;\n  /** The flow's inputs as typed text, by name. */\n  inputs?: Record<string, string>;\n}\n\n/** The REST API this client speaks. */\nexport const RUNNER_API = 'v1';\n\n/** Why this client and the server do not fit for a flow in `format`, or undefined. */\nexport function incompatible(meta: RunnerMeta, format: number): string | undefined {\n  if (meta.name !== 'Ansible Flow Server') return 'The address is not an Ansible Flow Server';\n  if (meta.api !== RUNNER_API)\n    return `The server speaks API ${meta.api}; this extension speaks ${RUNNER_API}: update the one that is older`;\n  const formats = meta.designer.formats ?? [meta.designer.format];\n  if (!formats.includes(format))\n    return `The flow is in format ${format}; the server (${meta.version}) reads formats ${formats.join(', ')}: upgrade the server`;\n  return undefined;\n}\n\nexport interface RunnerOptions {\n  verifyTls?: boolean;\n  /** Send the token over plain http to another machine (a lab only). */\n  allowHttp?: boolean;\n  timeoutMs?: number;\n}\n\nconst MAX_BODY = 32 * 1024 * 1024;\nconst enc = encodeURIComponent;\n\nexport class RunnerClient {\n  readonly base: string;\n  private readonly origin: string;\n\n  constructor(\n    url: string,\n    private readonly token: string,\n    private readonly options: RunnerOptions = {},\n  ) {\n    this.base = url.replace(/\\/+$/, '');\n    this.origin = new URL(this.base).origin;\n  }\n\n  /** A run's page on the server. */\n  runUrl(id: string): string {\n    return `${this.base}/runs/${enc(id)}`;\n  }\n\n  /** The answer's body as text, and its status. */\n  private send(\n    method: string,\n    path: string,\n    body?: unknown,\n    /** A body sent as it is, with its content type (a git bundle). */\n    raw?: { bytes: Buffer; type: string },\n  ): Promise<{ status: number; text: string }> {\n    const url = new URL(`${this.base}${path}`);\n    if (url.origin !== this.origin)\n      return Promise.reject(new RunnerError(`Not sending the token to ${url.origin}`));\n    if (cleartextTo(url) && !this.options.allowHttp)\n      return Promise.reject(\n        new RunnerError(\n          `Not sending the token unencrypted to ${url.origin}: use an https address, or turn on afd.runner.allowHttp in your user settings (a lab server only)`,\n        ),\n      );\n    const lib = url.protocol === 'https:' ? https : http;\n    const data = raw?.bytes ?? (body === undefined ? undefined : JSON.stringify(body));\n    const type = raw?.type ?? 'application/json';\n    return new Promise((resolve, reject) => {\n      const req = lib.request(\n        url,\n        {\n          method,\n          headers: {\n            Authorization: `Bearer ${this.token}`,\n            Accept: 'application/json',\n            ...(data ? { 'Content-Type': type, 'Content-Length': Buffer.byteLength(data) } : {}),\n          },\n          timeout: this.options.timeoutMs ?? TIMEOUTS.runnerRequest,\n          ...(url.protocol === 'https:'\n            ? { rejectUnauthorized: this.options.verifyTls !== false }\n            : {}),\n        },\n        (res) => {\n          const chunks: Buffer[] = [];\n          let size = 0;\n          res.on('data', (c: Buffer) => {\n            size += c.length;\n            if (size > MAX_BODY) {\n              req.destroy(new Error('the answer is too large'));\n              return;\n            }\n            chunks.push(c);\n          });\n          res.on('end', () =>\n            resolve({ status: res.statusCode ?? 0, text: Buffer.concat(chunks).toString('utf8') }),\n          );\n          res.on('error', reject);\n        },\n      );\n      req.on('timeout', () => req.destroy(new Error('no answer in time')));\n      req.on('error', (e) =>\n        reject(new RunnerError(`The server at ${this.base} does not answer: ${e.message}`)),\n      );\n      req.end(data);\n    });\n  }\n\n  async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n    raw?: { bytes: Buffer; type: string },\n  ): Promise<T> {\n    const { status, text } = await this.send(method, path, body, raw);\n    let json: unknown;\n    try {\n      json = text ? JSON.parse(text) : undefined;\n    } catch {\n      json = undefined;\n    }\n    if (status >= 200 && status < 300) return json as T;\n    const e = (json ?? {}) as {\n      error?: string;\n      message?: string;\n      problems?: { field?: string; message: string }[];\n    };\n    const why =\n      status === 401\n        ? 'The server does not take the token: set it again (it may have expired or been revoked)'\n        : status === 413\n          ? 'The work is larger than the server takes (AFS_DEV_BUNDLE_MAX_MB)'\n          : (e.message ?? `The server answered ${status}`);\n    throw new RunnerError(why, status, e.error, e.problems);\n  }\n\n  /** The output of a request whose answer is plain text. */\n  async text(path: string): Promise<string> {\n    const { status, text } = await this.send('GET', path);\n    if (status >= 200 && status < 300) return text;\n    throw new RunnerError(`The server answered ${status}`, status);\n  }\n\n  meta = () => this.request<RunnerMeta>('GET', '/api/v1/meta');\n  me = () => this.request<{ login: string; name: string }>('GET', '/api/v1/session');\n  projects = (workspace: string) =>\n    this.request<RunnerProject[]>('GET', `/api/v1/workspaces/${enc(workspace)}/projects`);\n  project = (id: string) => this.request<RunnerProject>('GET', `/api/v1/projects/${enc(id)}`);\n  configs = (project: string) =>\n    this.request<RunnerConfig[]>('GET', `/api/v1/projects/${enc(project)}/launch-configs`);\n  check = async (config: string, req: LaunchRequest) =>\n    (\n      await this.request<{ launch: RunnerLaunch }>(\n        'POST',\n        `/api/v1/launch-configs/${enc(config)}/check`,\n        req,\n      )\n    ).launch;\n  launch = (config: string, req: LaunchRequest) =>\n    this.request<RunnerRun>('POST', `/api/v1/launch-configs/${enc(config)}/launch`, req);\n  run = (id: string) => this.request<RunnerRun>('GET', `/api/v1/runs/${enc(id)}`);\n  /** How the run went, as the designer shows it (the server's RunView); 404 until it has one. */\n  view = async (id: string) => {\n    try {\n      return await this.request<Record<string, unknown>>('GET', `/api/v1/runs/${enc(id)}/view`);\n    } catch (e) {\n      if (e instanceof RunnerError && e.status === 404) return undefined;\n      throw e;\n    }\n  };\n  gates = (id: string) => this.request<RunnerGate[]>('GET', `/api/v1/runs/${enc(id)}/approvals`);\n  cancel = (id: string) => this.request<RunnerRun>('POST', `/api/v1/runs/${enc(id)}/cancel`);\n  decide = (id: string, node: string, decision: 'approved' | 'rejected', comment?: string) =>\n    this.request<unknown>('POST', `/api/v1/runs/${enc(id)}/approvals/${enc(node)}`, {\n      decision,\n      ...(comment?.trim() ? { comment: comment.trim() } : {}),\n    });\n  /** AFD-282: unpushed work for a dev run; resolves with the bundle's id and commit. */\n  devBundle = (project: string, bytes: Buffer) =>\n    this.request<{ id: string; commit: string; expiresAt: string }>(\n      'POST',\n      `/api/v1/projects/${enc(project)}/dev-bundles`,\n      undefined,\n      { bytes, type: 'application/x-git-bundle' },\n    );\n  /** What one host did in one step of the run. */\n  hostOutput = (id: string, node: string, host: string) =>\n    this.request<{ entries?: unknown[] }>(\n      'GET',\n      `/api/v1/runs/${enc(id)}/hosts/${enc(node)}/${enc(host)}`,\n    );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runner/devBundle.d.ts

@@ -0,0 +1,14 @@
+export interface DevWork {
+    /** The commit the bundle holds: HEAD, or the commit of the working tree. */
+    commit: string;
+    /** It has uncommitted changes in it. */
+    uncommitted: boolean;
+    /** Bundled from the server's commit (else the whole history). */
+    fromServer: boolean;
+    bundle: Buffer;
+}
+/**
+ * The work in the repository at `root` as a bundle, or undefined when it is the server's commit
+ * (nothing to send).
+ */
+export declare function devBundle(root: string, serverCommit: string): Promise<DevWork | undefined>;