@datarails-ai/dr-cli 1.6.154 → 1.6.155

package/dist/cli.js

@@ -8,7 +8,7 @@ import { fileURLToPath as fileURLToPath3 } from "url";
 // package.json
 var package_default = {
   name: "@datarails-ai/dr-cli",
-  version: "1.6.154",
+  version: "1.6.155",
   description: "Datarails CLI",
   type: "module",
   engines: {
@@ -69,7 +69,7 @@ var package_default = {
 };
 
 // src/buildInfo.ts
-var BUILD_TIME = "2026-10-22T15:15:19.668Z";
+var BUILD_TIME = "2026-10-23T09:17:56.480Z";
 function formatBuildTime(iso) {
   if (iso === "") return "";
   const d = new Date(iso);
@@ -46485,12 +46485,15 @@ async function listPollItems(client, queryId, query = {}, reqOptions) {
   }
   return out;
 }
-async function retryPollItem(client, queryId, itemId, reqOptions) {
-  const path13 = `/connector-queries/${queryId}/poll/items/${itemId}/retry`;
+function outputQuery(outputId) {
+  return outputId === void 0 ? "" : `?output=${outputId}`;
+}
+async function retryPollItem(client, queryId, itemId, reqOptions, outputId) {
+  const path13 = `/connector-queries/${queryId}/poll/items/${itemId}/retry${outputQuery(outputId)}`;
   return postPollJSON(client, path13, {}, "poll item retry", reqOptions);
 }
-async function skipPollItem(client, queryId, itemId, reqOptions) {
-  const path13 = `/connector-queries/${queryId}/poll/items/${itemId}/skip`;
+async function skipPollItem(client, queryId, itemId, reqOptions, outputId) {
+  const path13 = `/connector-queries/${queryId}/poll/items/${itemId}/skip${outputQuery(outputId)}`;
   return postPollJSON(client, path13, {}, "poll item skip", reqOptions);
 }
 function toControlPlaneError(method, path13, err) {
@@ -46782,6 +46785,11 @@ function renderPoll(out, headline, binding, p) {
     p.poll_run_rekey_to === null ? "-" : `to ${sameNameLabel(p.poll_run_rekey_to)}`
   );
   row("Items", counts === "" ? "(none)" : counts);
+  const outputs = p.outputs ?? [];
+  row(
+    "Outputs",
+    outputs.length === 0 ? "-" : outputs.map((o) => `filebox ${o.filebox_uuid} (query #${o.connector_query_id})`).join(", ")
+  );
 }
 function writeTable26(out, rows) {
   const widths = [];
@@ -46798,8 +46806,18 @@ function writeTable26(out, rows) {
 `);
   }
 }
+function formatItemOutputs(it) {
+  const outputs = it.outputs ?? [];
+  if (outputs.length === 0) return "-";
+  return outputs.map((o) => {
+    const error = o.last_error ?? (o.skip_reason === null ? null : `skipped: ${o.skip_reason}`);
+    return `#${o.connector_query_id}=${o.state}${error === null ? "" : ` (${truncate3(oneLine3(error), 40)})`}`;
+  }).join(" ");
+}
 function renderItemTable(out, items) {
-  const rows = [["ID", "LABEL", "DATE", "STATE", "ATTEMPTS", "VERSION", "ERROR"]];
+  const multi = items.some((it) => (it.outputs ?? []).length > 0);
+  const header = ["ID", "LABEL", "DATE", "STATE", "ATTEMPTS", "VERSION"];
+  const rows = [[...header, ...multi ? ["OUTPUTS"] : [], "ERROR"]];
   for (const it of items) {
     const error = it.last_error ?? (it.skip_reason === null ? null : `skipped: ${it.skip_reason}`);
     rows.push([
@@ -46809,6 +46827,7 @@ function renderItemTable(out, items) {
       it.state,
       String(it.attempts),
       it.version_id === null ? "-" : String(it.version_id),
+      ...multi ? [formatItemOutputs(it)] : [],
       error === null ? "-" : truncate3(oneLine3(error), 80)
     ]);
   }
@@ -46960,10 +46979,10 @@ function pollConfirmAction(filebox, verb, scope, payload = {}) {
     verb
   };
 }
-function pollItemConfirmAction(filebox, item, scope) {
+function pollItemConfirmAction(filebox, item, scope, output) {
   return {
     resource: "connector-poll-item",
-    id: `${filebox.trim()}/${item}#${confirmDigest(scope, {})}`,
+    id: `${filebox.trim()}/${item}#${confirmDigest(scope, output === void 0 ? {} : { output: output.trim() })}`,
     verb: "skip"
   };
 }
@@ -47167,6 +47186,10 @@ More: dr connectors poll items ${cfg.filebox}${state}${limit} --after ${page.nex
     );
   }
 }
+async function resolveItemOutput(cfg) {
+  if (cfg.output === void 0) return void 0;
+  return (await resolvePollBinding(cfg.client, cfg.output, cfg.signal)).query_id;
+}
 function renderItemResult(cfg, binding, headline, item) {
   if (cfg.asJson) {
     writeJSONIndented(cfg.out, item);
@@ -47178,37 +47201,109 @@ function renderItemResult(cfg, binding, headline, item) {
 }
 async function runPollRetry(cfg) {
   const binding = await resolvePollBinding(cfg.client, cfg.filebox, cfg.signal);
+  const outputId = await resolveItemOutput(cfg);
   const item = await explainNotPolled(
     cfg.filebox,
-    retryPollItem(cfg.client, binding.query_id, cfg.itemId, { signal: cfg.signal })
+    retryPollItem(
+      cfg.client,
+      binding.query_id,
+      cfg.itemId,
+      { signal: cfg.signal },
+      outputId
+    )
   );
-  renderItemResult(cfg, binding, `Item ${cfg.itemId} queued for retry`, item);
+  const what = outputId === void 0 ? "" : ` (output #${outputId})`;
+  renderItemResult(cfg, binding, `Item ${cfg.itemId}${what} queued for retry`, item);
 }
 async function runPollSkip(cfg) {
   const binding = await resolvePollBinding(cfg.client, cfg.filebox, cfg.signal);
+  const outputId = await resolveItemOutput(cfg);
+  const outputArg = cfg.output === void 0 ? "" : ` --output ${cfg.output.trim()}`;
   cfg.deadline?.pause();
   await twoStepConfirm({
     out: cfg.out,
-    action: pollItemConfirmAction(cfg.filebox, cfg.itemId, cfg.scope),
+    action: pollItemConfirmAction(cfg.filebox, cfg.itemId, cfg.scope, cfg.output),
     token: cfg.token,
     server: cfg.scope.serverKey,
-    confirmCmd: `dr connectors poll skip ${cfg.filebox} ${cfg.itemId}${cfg.targetArgs}`,
+    confirmCmd: `dr connectors poll skip ${cfg.filebox} ${cfg.itemId}${outputArg}${cfg.targetArgs}`,
     describe: async () => [
       `item:        ${cfg.itemId} of ${bindingTarget(binding)}`,
-      "effect:      the item is never landed (dr connectors poll retry queues it again)"
+      ...outputId === void 0 ? ["effect:      the item is never landed (dr connectors poll retry queues it again)"] : [
+        `output:      query #${outputId} only`,
+        "effect:      the item is never landed in that output; its other outputs still land (dr connectors poll retry --output queues it again)"
+      ]
     ],
     execute: async () => {
       cfg.deadline?.resume();
       const item = await explainNotPolled(
         cfg.filebox,
-        skipPollItem(cfg.client, binding.query_id, cfg.itemId, {
-          signal: cfg.signal
-        })
+        skipPollItem(
+          cfg.client,
+          binding.query_id,
+          cfg.itemId,
+          { signal: cfg.signal },
+          outputId
+        )
       );
-      renderItemResult(cfg, binding, `Item ${cfg.itemId} skipped`, item);
+      const what = outputId === void 0 ? "" : ` (output #${outputId})`;
+      renderItemResult(cfg, binding, `Item ${cfg.itemId}${what} skipped`, item);
     }
   });
 }
+async function runPollOutputs(cfg) {
+  const binding = await resolvePollBinding(cfg.client, cfg.filebox, cfg.signal);
+  const current = await explainNotPolled(
+    cfg.filebox,
+    getPoll(cfg.client, binding.query_id, { signal: cfg.signal })
+  );
+  if (cfg.add.length === 0 && cfg.remove.length === 0 && !cfg.clear) {
+    if (cfg.asJson) {
+      writeJSONIndented(cfg.out, current.outputs ?? []);
+      return;
+    }
+    renderPoll(cfg.out, "Polling", binding, current);
+    return;
+  }
+  const kept = new Map(
+    cfg.clear ? [] : (current.outputs ?? []).map((o) => [o.connector_query_id, o.date_tag])
+  );
+  for (const filebox of cfg.remove) {
+    const stored2 = (current.outputs ?? []).find(
+      (o) => o.filebox_uuid.toLowerCase() === filebox.trim().toLowerCase()
+    );
+    const queryId = stored2?.connector_query_id ?? (await resolvePollBinding(cfg.client, filebox, cfg.signal)).query_id;
+    if (!kept.delete(queryId)) {
+      throw new Error(`filebox ${filebox} is not an output of ${bindingTarget(binding)}`);
+    }
+  }
+  for (const filebox of cfg.add) {
+    const output = await resolvePollBinding(cfg.client, filebox, cfg.signal);
+    if (output.query_id === binding.query_id) {
+      throw new Error(`filebox ${filebox} is the binding's own filebox, always its first output`);
+    }
+    if (output.filebox_id <= 0) {
+      throw new Error(
+        `connector-query #${output.query_id} has no filebox id recorded, so its date tag cannot be read; record it with dr connectors query repoint ${output.query_id} --filebox-id <id>`
+      );
+    }
+    kept.set(
+      output.query_id,
+      await readFileboxDateTag(cfg.monolith, output.filebox_id, cfg.signal)
+    );
+  }
+  const outputs = [...kept].map(([id, tag]) => ({ connector_query_id: id, date_tag: tag }));
+  const stored = await putPoll(
+    cfg.client,
+    binding.query_id,
+    { outputs },
+    { signal: cfg.signal }
+  );
+  if (cfg.asJson) {
+    writeJSONIndented(cfg.out, stored);
+    return;
+  }
+  renderPoll(cfg.out, "Polling outputs updated", binding, stored);
+}
 async function withMonolith(opts, action) {
   const monolithHost = resolve(resolveServer(opts.server)).host;
   const setup = await setupCall(opts.server, opts.account, {
@@ -47465,13 +47560,14 @@ ${POLL_CONFIRM_HELP}`)
     }
   );
   addCommonFlags(itemsCmd, "Output the raw page as JSON");
-  const retryCmd = poll2.command("retry").description("Queue a failed, waiting or skipped item again").argument("<filebox>", "filebox id or uuid").argument("<item>", "item id (from poll items)").action(async (filebox, item, opts) => {
+  const retryCmd = poll2.command("retry").description("Queue a failed, waiting or skipped item again").argument("<filebox>", "filebox id or uuid").argument("<item>", "item id (from poll items)").option("--output <filebox>", "a multi-output item: retry only its landing in this filebox").action(async (filebox, item, opts) => {
     const itemId = parsePositiveIntArg2(item, "item id");
     await withConnectorsSetup(opts, async ({ client, signal }) => {
       await runPollRetry({
         client,
         filebox,
         itemId,
+        ...opts.output !== void 0 ? { output: opts.output } : {},
         asJson: opts.json === true,
         signal,
         out: process.stdout
@@ -47480,32 +47576,67 @@ ${POLL_CONFIRM_HELP}`)
   });
   addCommonFlags(retryCmd, "Output the item as JSON");
   const skipCmd = addConfirmTokenFlag(
-    poll2.command("skip").description("Skip an item so it is never landed (two-step confirmation)").argument("<filebox>", "filebox id or uuid").argument("<item>", "item id (from poll items)")
-  ).action(async (filebox, item, opts) => {
-    const itemId = parsePositiveIntArg2(item, "item id");
-    await preflightConfirmToken(
-      pollItemConfirmAction(filebox, itemId, scopeOf(opts)),
-      opts.confirmToken
-    );
-    await withConnectorsSetup(opts, async (setup) => {
-      await runPollSkip({
-        client: setup.client,
-        filebox,
-        itemId,
-        deadline: {
-          pause: () => setup.pauseTimeout(),
-          resume: () => setup.extendTimeout(DEFAULT_CALL_TIMEOUT_MS)
-        },
-        ...opts.confirmToken !== void 0 ? { token: opts.confirmToken } : {},
-        scope: scopeOf(opts),
-        targetArgs: targetArgsOf(opts),
-        asJson: opts.json === true,
-        signal: setup.signal,
-        out: process.stdout
+    poll2.command("skip").description("Skip an item so it is never landed (two-step confirmation)").argument("<filebox>", "filebox id or uuid").argument("<item>", "item id (from poll items)").option("--output <filebox>", "a multi-output item: skip only its landing in this filebox")
+  ).action(
+    async (filebox, item, opts) => {
+      const itemId = parsePositiveIntArg2(item, "item id");
+      await preflightConfirmToken(
+        pollItemConfirmAction(filebox, itemId, scopeOf(opts), opts.output),
+        opts.confirmToken
+      );
+      await withConnectorsSetup(opts, async (setup) => {
+        await runPollSkip({
+          client: setup.client,
+          filebox,
+          itemId,
+          ...opts.output !== void 0 ? { output: opts.output } : {},
+          deadline: {
+            pause: () => setup.pauseTimeout(),
+            resume: () => setup.extendTimeout(DEFAULT_CALL_TIMEOUT_MS)
+          },
+          ...opts.confirmToken !== void 0 ? { token: opts.confirmToken } : {},
+          scope: scopeOf(opts),
+          targetArgs: targetArgsOf(opts),
+          asJson: opts.json === true,
+          signal: setup.signal,
+          out: process.stdout
+        });
       });
-    });
-  });
+    }
+  );
   addCommonFlags(skipCmd, "Output the item as JSON");
+  const collect2 = (value, previous) => [...previous, value];
+  const outputsCmd = poll2.command("outputs").description(
+    "Show or change the other fileboxes each file lands in, from one read of the source"
+  ).argument("<filebox>", "the binding's filebox id or uuid").option("--add <filebox>", "land each file in this filebox too (repeatable)", collect2, []).option("--remove <filebox>", "stop landing in this filebox (repeatable)", collect2, []).option("--clear", "remove every extra output", false).addHelpText(
+    "after",
+    [
+      "",
+      "For a source that deletes a file once it is read (a bank SFTP): one binding reads each",
+      "file once and lands it in its own filebox and in every output, each through its own",
+      "Sync-query (e.g. a BAI2 feed). The outputs must use the same connection and code.",
+      "Set the Sync-query `dated_by` to `fetch` so discover never opens a file."
+    ].join("\n")
+  ).action(
+    async (filebox, opts) => {
+      await withConnectorsSetup(opts, async ({ client, signal }) => {
+        await withMonolith(opts, async (monolith) => {
+          await runPollOutputs({
+            client,
+            monolith,
+            filebox,
+            add: opts.add,
+            remove: opts.remove,
+            clear: opts.clear === true,
+            asJson: opts.json === true,
+            signal,
+            out: process.stdout
+          });
+        });
+      });
+    }
+  );
+  addCommonFlags(outputsCmd, "Output the outputs (or the stored binding) as JSON");
   const seedCmd = addConfirmTokenFlag(
     poll2.command("seed").description(
       "Mark items modified at or before --until as already landed (cut-over; token, no dialog)"

package/dist/scopes-map.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "cliVersion": "1.6.154",
+  "cliVersion": "1.6.155",
   "_contract": "Resolve a command path through `aliases` (canonical prefix + alias segment -> canonical path) before any lookup. A path listed in `pendingCommands`, or whose first segment is a key of `pending`, is UNDECIDED, not unrestricted: fail closed or skip it, and never read a path's absence from `commands` as 'no requirement'. An entry carrying `denied` is UNAVAILABLE to any AGENT-SCOPED credential — one whose `scopes` claim carries at least one `resource:action` entry; a claim that is absent, empty, capability-only or wholly unparseable is UNRESTRICTED, and this mark does not apply to it — whatever else that entry says: it is not a ceiling and it is not always-available, its `denied.reason` says why and `denied.until` names the ticket that lifts it, and the absence of `requires` on it must NEVER be read as 'no requirement'. Only an entry in `commands` with an empty `requires` means always-available.",
   "commands": {
     "login": {
@@ -2117,6 +2117,12 @@
         "until": "DR-56164"
       }
     },
+    "connectors poll outputs": {
+      "denied": {
+        "reason": "The connectors control plane runs no dr-auth-sdk guard and checks no scope, so the `integrations` ceiling this command declares would be enforced by nobody. Closed to scoped credentials until that control plane adopts the SDK.",
+        "until": "DR-56164"
+      }
+    },
     "connectors poll seed": {
       "denied": {
         "reason": "The connectors control plane runs no dr-auth-sdk guard and checks no scope, so the `integrations` ceiling this command declares would be enforced by nobody. Closed to scoped credentials until that control plane adopts the SDK.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datarails-ai/dr-cli",
-  "version": "1.6.154",
+  "version": "1.6.155",
   "description": "Datarails CLI",
   "type": "module",
   "engines": {