shakers-cli-beta 0.8.0-beta.0

package/src/profile-client.js

@@ -0,0 +1,125 @@
+'use strict';
+
+// AI-profile client (hub `works/me/ai-profile`, talent Bearer). The "My work
+// with AI" read model: setup/usage tier+level, 3x3 cell, vision, howIWork.
+
+const { postJsonWithTimeout } = require('./backend-request');
+const { reasonForError } = require('./onboarding-client');
+
+const DEFAULT_TIMEOUT_MS = 20000;
+
+function parseJson(raw) {
+  try {
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return null;
+  }
+}
+
+function bearerHeaders(accessToken) {
+  const headers = {};
+  if (typeof accessToken === 'string' && accessToken) headers.Authorization = `Bearer ${accessToken}`;
+  return headers;
+}
+
+function str(v) {
+  return typeof v === 'string' && v ? v : null;
+}
+
+async function requestAiProfile({ hubAccessToken } = {}, { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, null, timeoutMs, 'GET', null, bearerHeaders(hubAccessToken));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status === 404) return { ok: false, reason: 'not-found' };
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+
+  const env = parseJson(res.raw);
+  const data = env && env.status === 'OK' ? env.data : env;
+  if (!data || typeof data !== 'object') return { ok: false, reason: 'bad-response' };
+  const setup = data.setup && typeof data.setup === 'object' ? data.setup : {};
+  const usage = data.usage && typeof data.usage === 'object' ? data.usage : {};
+  const traction = data.traction && typeof data.traction === 'object' ? data.traction : {};
+  return {
+    ok: true,
+    aiProfile: {
+      setupTier: str(setup.tier),
+      setupLevel: str(setup.level),
+      usageLevel: str(usage.level),
+      cell: str(data.cell),
+      isAiNative: data.isAiNative === true,
+      agentsOnProfile: typeof traction.agentsOnProfile === 'number' ? traction.agentsOnProfile : null,
+      vision: data.vision && typeof data.vision === 'object' ? str(data.vision.text) : null,
+      howIWork: data.howIWork && typeof data.howIWork === 'object' ? str(data.howIWork.body) : null,
+    },
+  };
+}
+
+async function fetchAiProfile(deps = {}, { hubAccessToken, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  const {
+    getAiProfileEndpoint = require('./config').getAiProfileEndpoint,
+    requestAiProfile: request = requestAiProfile,
+  } = deps;
+  const endpoint = getAiProfileEndpoint();
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  return request({ hubAccessToken }, { endpoint, timeoutMs });
+}
+
+// GET on a hub endpoint that returns a `{status,data}` envelope, mapped by `map`.
+async function getMapped(endpoint, hubAccessToken, timeoutMs, map) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, null, timeoutMs, 'GET', null, bearerHeaders(hubAccessToken));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status === 404) return { ok: false, reason: 'not-found' };
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+  const env = parseJson(res.raw);
+  const data = env && env.status === 'OK' ? env.data : env;
+  if (data === undefined || data === null) return { ok: false, reason: 'bad-response' };
+  return { ok: true, ...map(data) };
+}
+
+// `works/me/profile` -> headline (basic profile text).
+async function fetchMeProfile(deps = {}, { hubAccessToken, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  const getEndpoint = deps.getMeProfileEndpoint || require('./config').getMeProfileEndpoint;
+  const req = deps.getMapped || getMapped;
+  return req(getEndpoint(), hubAccessToken, timeoutMs, (d) => ({ headline: str(d && d.headline) }));
+}
+
+// `works/talents/me/profile` -> completion %, freelance type, onboarding status.
+async function fetchTalentMeProfile(deps = {}, { hubAccessToken, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  const getEndpoint = deps.getTalentMeProfileEndpoint || require('./config').getTalentMeProfileEndpoint;
+  const req = deps.getMapped || getMapped;
+  return req(getEndpoint(), hubAccessToken, timeoutMs, (d) => ({
+    completedProfilePercentage: typeof (d && d.completedProfilePercentage) === 'number' ? d.completedProfilePercentage : null,
+    freelanceType: str(d && d.freelanceType),
+    onboardingStatus: str(d && d.onboardingStatus),
+  }));
+}
+
+// `works/talents/me/work-details/languages` -> count + codes.
+async function fetchLanguages(deps = {}, { hubAccessToken, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  const getEndpoint = deps.getLanguagesEndpoint || require('./config').getLanguagesEndpoint;
+  const req = deps.getMapped || getMapped;
+  return req(getEndpoint(), hubAccessToken, timeoutMs, (d) => {
+    const rows = Array.isArray(d) ? d : (Array.isArray(d && d.items) ? d.items : []);
+    const codes = rows.map((r) => (r && r.language && str(r.language.code)) || str(r && r.code)).filter(Boolean);
+    return { languageCodes: codes, languageCount: rows.length };
+  });
+}
+
+module.exports = {
+  requestAiProfile,
+  fetchAiProfile,
+  fetchMeProfile,
+  fetchTalentMeProfile,
+  fetchLanguages,
+};

package/src/profile-flow.js

@@ -0,0 +1,115 @@
+'use strict';
+
+// `me` / `profile` flow: a summary combining the "My work with AI" read model,
+// the main role (from certifications) and the per-project rate. Read-only.
+
+const { styleLabelPrefix } = require('./ansi');
+
+function makeProfileDeps(overrides = {}) {
+  const profile = require('./profile-client');
+  const rate = require('./rate-client');
+  const certs = require('./certifications-client');
+  const availability = require('./availability-client');
+  return {
+    fetchAiProfile: (opts) => profile.fetchAiProfile({}, opts),
+    fetchPricingRate: (opts) => rate.fetchPricingRate({}, opts),
+    fetchMeCertifications: (opts) => certs.fetchMeCertifications({}, opts),
+    fetchMeProfile: (opts) => profile.fetchMeProfile({}, opts),
+    fetchTalentMeProfile: (opts) => profile.fetchTalentMeProfile({}, opts),
+    fetchLanguages: (opts) => profile.fetchLanguages({}, opts),
+    fetchAvailability: (opts) => availability.fetchAvailability({}, opts),
+    ...overrides,
+  };
+}
+
+function trim(text, max) {
+  if (!text) return null;
+  const t = String(text).trim();
+  return t.length > max ? `${t.slice(0, max - 1)}…` : t;
+}
+
+async function runProfile({ io, rawOut, session, catalog, opts = {}, deps = makeProfileDeps() }) {
+  const fp = catalog.profile;
+  const hubAccessToken = session ? session.hubAccessToken : null;
+
+  // Independent reads; each degrades to null so one outage never blanks the
+  // whole summary.
+  const doFetch = () => Promise.all([
+    deps.fetchAiProfile({ hubAccessToken }),
+    deps.fetchPricingRate({ hubAccessToken }),
+    deps.fetchMeCertifications({ hubAccessToken }),
+    deps.fetchMeProfile({ hubAccessToken }),
+    deps.fetchTalentMeProfile({ hubAccessToken }),
+    deps.fetchLanguages({ hubAccessToken }),
+    deps.fetchAvailability({ hubAccessToken }),
+  ]);
+  const [ai, rate, certs, meProfile, talentProfile, languages, availability] = opts.json ? await doFetch() : await io.withProgress(fp.loading, doFetch);
+
+  if (!ai.ok && !rate.ok && !certs.ok && !meProfile.ok && !talentProfile.ok) {
+    io.error(fp.fetchFailed(ai.reason || rate.reason || certs.reason));
+    return { ok: false, reason: ai.reason || rate.reason || certs.reason };
+  }
+
+  const aiProfile = ai.ok ? ai.aiProfile : null;
+  const pricing = rate.ok ? rate.pricing : null;
+  const mainRole = certs.ok ? certs.mainRole : null;
+  const headline = meProfile.ok ? meProfile.headline : null;
+  const completion = talentProfile.ok ? talentProfile.completedProfilePercentage : null;
+  const freelanceType = talentProfile.ok ? talentProfile.freelanceType : null;
+  const languageCodes = languages.ok ? languages.languageCodes : [];
+  const availabilitySummary = availability.ok ? availability.availability : null;
+  const skillsCount = certs.ok && certs.skillsRatio && typeof certs.skillsRatio.total === 'number' ? certs.skillsRatio.total : null;
+  const agentsCount = aiProfile ? aiProfile.agentsOnProfile : null;
+
+  if (opts.json) {
+    (rawOut || ((s) => process.stdout.write(s)))(`${JSON.stringify({
+      ok: true, mainRole, headline, completedProfilePercentage: completion, freelanceType,
+      languageCodes, skillsCount, agentsCount, availability: availabilitySummary, aiProfile, pricing,
+    }, null, 2)}\n`);
+    return { ok: true, mainRole, aiProfile, pricing };
+  }
+
+  io.section(fp.title);
+  if (headline) io.notify(styleLabelPrefix(fp.headline(headline)));
+  if (mainRole && mainRole.name) io.notify(styleLabelPrefix(fp.role(mainRole.name)));
+  if (freelanceType) io.notify(styleLabelPrefix(fp.freelanceType(freelanceType)));
+  if (completion != null) io.notify(styleLabelPrefix(fp.completion(completion)));
+  if (pricing) {
+    const m = pricing.fullTimeSelected ? pricing.fullTimePrice : null;
+    io.notify(styleLabelPrefix(fp.rate(m && m.amount != null ? `${m.amount}${m.currency ? ` ${m.currency}` : ''}` : fp.rateNotSet)));
+  }
+  if (availabilitySummary) {
+    io.notify(styleLabelPrefix(fp.availability(
+      availabilitySummary.available === true ? fp.availYes : availabilitySummary.available === false ? fp.availNo : fp.availUnknown,
+      availabilitySummary.monthlyHours || fp.availUnknown,
+    )));
+  }
+  if (languageCodes.length) io.notify(styleLabelPrefix(fp.languages(languageCodes.join(', '))));
+  const counts = [
+    skillsCount != null ? fp.skillsCount(skillsCount) : null,
+    agentsCount != null ? fp.agentsCount(agentsCount) : null,
+  ].filter(Boolean);
+  if (counts.length) io.notify(counts.join(' · '));
+  if (aiProfile) {
+    if (aiProfile.cell) io.notify(styleLabelPrefix(fp.cell(aiProfile.cell)));
+    const axes = [
+      aiProfile.setupTier ? styleLabelPrefix(fp.setup(aiProfile.setupTier, aiProfile.setupLevel || '—')) : null,
+      aiProfile.usageLevel ? styleLabelPrefix(fp.usage(aiProfile.usageLevel)) : null,
+    ].filter(Boolean);
+    if (axes.length) io.notify(axes.join(' · '));
+    if (aiProfile.isAiNative) io.notify(fp.aiNative);
+    const vision = trim(aiProfile.vision, 240);
+    if (vision) { io.section(fp.visionHeading); io.notify(vision); }
+    const howIWork = trim(aiProfile.howIWork, 240);
+    if (howIWork) { io.section(fp.howIWorkHeading); io.notify(howIWork); }
+  } else {
+    io.notify(fp.noAiProfile);
+  }
+  io.success(fp.done);
+  return { ok: true, mainRole, aiProfile, pricing };
+}
+
+module.exports = {
+  makeProfileDeps,
+  runProfile,
+};

package/src/profile-switch.js

@@ -0,0 +1,46 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const { getConfigDir } = require('./config-dir');
+const { loadConfigFile, saveConfigFile, VALID_PROFILES } = require('./config');
+const { clearAuthSession } = require('./auth-session-store');
+
+function reportStatePath(env) {
+  return path.join(getConfigDir(env), 'report-state.json');
+}
+function consentStatePath(env) {
+  return path.join(getConfigDir(env), 'consent.json');
+}
+
+// Best-effort delete: a file that doesn't exist (nothing to purge yet, e.g.
+// a superadmin who never ran `usage` in this profile) is not a failure.
+function unlinkIfExists(p) {
+  try {
+    fs.unlinkSync(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// `switchProfile(target, env)`.
+function switchProfile(target, env = process.env) {
+  if (!VALID_PROFILES.has(target)) return { ok: false, reason: 'invalid-profile' };
+
+  const config = loadConfigFile(env);
+  const from = VALID_PROFILES.has(config.profile) ? config.profile : 'talent';
+  config.profile = target;
+  saveConfigFile(config, env);
+
+  const purged = {
+    reportState: unlinkIfExists(reportStatePath(env)),
+    consent: unlinkIfExists(consentStatePath(env)),
+    authSession: clearAuthSession(env),
+  };
+
+  return { ok: true, from, to: target, purged };
+}
+
+module.exports = { switchProfile, reportStatePath, consentStatePath };

package/src/prompt-select.js

@@ -0,0 +1,29 @@
+'use strict';
+
+const { runInteractiveMultiSelect } = require('./interactive-select');
+
+async function promptSelect({ ask, stdinIsTTY, out, items, labelFor = (x) => String(x), header = '', hint = '', input, output } = {}) {
+  if (stdinIsTTY && typeof ask.suspend === 'function') {
+    ask.suspend();
+    const picked = await runInteractiveMultiSelect({
+      items,
+      labelFor,
+      header,
+      hint,
+      single: true,
+      ...(input ? { input } : {}),
+      ...(output ? { output } : {}),
+    });
+    ask.resume();
+    return picked && picked.length ? picked[0] : null;
+  }
+  if (header) out(header);
+  items.forEach((it, i) => out(`  ${i + 1}) ${labelFor(it)}`));
+  const raw = (await ask('  > ')).trim();
+  const n = parseInt(raw, 10);
+  if (Number.isInteger(n) && n >= 1 && n <= items.length) return items[n - 1];
+  const lowered = raw.toLowerCase();
+  return items.find((it) => labelFor(it).toLowerCase() === lowered || String(it).toLowerCase() === lowered) || null;
+}
+
+module.exports = { promptSelect };

package/src/rate-client.js

@@ -0,0 +1,82 @@
+'use strict';
+
+// Pricing-rate client (hub `works/talents/me/work-details/pricing-rate`, talent
+// Bearer). READ-ONLY here: setting the rate is a financial PUT, left to register.
+
+const { postJsonWithTimeout } = require('./backend-request');
+const { reasonForError } = require('./onboarding-client');
+
+const DEFAULT_TIMEOUT_MS = 20000;
+
+function parseJson(raw) {
+  try {
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return null;
+  }
+}
+
+function bearerHeaders(accessToken) {
+  const headers = {};
+  if (typeof accessToken === 'string' && accessToken) headers.Authorization = `Bearer ${accessToken}`;
+  return headers;
+}
+
+function money(m) {
+  if (!m || typeof m !== 'object') return null;
+  return { amount: typeof m.amount === 'number' ? m.amount : null, currency: typeof m.currency === 'string' ? m.currency : null };
+}
+
+async function requestPricingRate({ hubAccessToken } = {}, { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, null, timeoutMs, 'GET', null, bearerHeaders(hubAccessToken));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status === 404) return { ok: false, reason: 'not-found' };
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+
+  const env = parseJson(res.raw);
+  const data = env && env.status === 'OK' ? env.data : env;
+  if (!data || typeof data !== 'object') return { ok: false, reason: 'bad-response' };
+  return {
+    ok: true,
+    pricing: {
+      fullTimeSelected: data.fullTimeProjectSelected === true,
+      fullTimePrice: money(data.fullTimeProjectPrice),
+      partTimeSelected: data.partTimeProjectSelected === true,
+      partTimePrice: money(data.partTimeProjectPrice),
+    },
+  };
+}
+
+async function fetchPricingRate(deps = {}, { hubAccessToken, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  const {
+    getPricingRateEndpoint = require('./config').getPricingRateEndpoint,
+    requestPricingRate: request = requestPricingRate,
+  } = deps;
+  const endpoint = getPricingRateEndpoint();
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  return request({ hubAccessToken }, { endpoint, timeoutMs });
+}
+
+// PUT the pricing (upsert). Reuses the SAME endpoint + request the register
+// pricing step uses, so `rate --set` and onboarding never diverge on the wire.
+async function savePricingRate(deps = {}, { hubAccessToken, pricing, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  const {
+    getPricingRateEndpoint = require('./config').getPricingRateEndpoint,
+    requestSetPricingRate = require('./onboarding-client').requestSetPricingRate,
+  } = deps;
+  const endpoint = getPricingRateEndpoint();
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  return requestSetPricingRate({ pricing, hubAccessToken }, { endpoint, timeoutMs });
+}
+
+module.exports = {
+  requestPricingRate,
+  fetchPricingRate,
+  savePricingRate,
+};

package/src/rate-flow.js

@@ -0,0 +1,137 @@
+'use strict';
+
+// `rate` flow: view the talent's per-project pricing, and `--set` to change it
+// (interactive, explicit confirmation — it changes what clients pay).
+
+const { styleLabelPrefix } = require('./ansi');
+
+const CURRENCIES = ['EUR', 'USD', 'GBP'];
+const MAX_AMOUNT = 999999.99;
+
+function makeRateDeps(overrides = {}) {
+  const client = require('./rate-client');
+  return {
+    fetchPricingRate: (opts) => client.fetchPricingRate({}, opts),
+    savePricingRate: (opts) => client.savePricingRate({}, opts),
+    promptSelect: (opts) => require('./prompt-select').promptSelect(opts),
+    ...overrides,
+  };
+}
+
+function priceLine(fp, money) {
+  if (!money || money.amount == null) return fp.notSet;
+  return `${money.amount}${money.currency ? ` ${money.currency}` : ''}`;
+}
+
+// Empty pricing when the talent has none yet (upsert still works).
+const EMPTY_PRICING = { fullTimeSelected: false, fullTimePrice: null, partTimeSelected: false, partTimePrice: null };
+
+function parseAmount(raw) {
+  const s = String(raw == null ? '' : raw).trim().replace(',', '.');
+  if (!/^\d+(\.\d+)?$/.test(s)) return null;
+  const n = Number.parseFloat(s);
+  if (!Number.isFinite(n) || n < 0 || n > MAX_AMOUNT) return null;
+  return n;
+}
+
+// Merge the chosen modality's new price into the current pricing → the PUT body
+// (full object, so the untouched modality is preserved, never cleared).
+function buildBody(current, modality, amount, currency) {
+  const body = {
+    fullTimeProjectSelected: current.fullTimeSelected === true,
+    fullTimeProjectPrice: current.fullTimePrice ? { amount: current.fullTimePrice.amount, currency: current.fullTimePrice.currency } : null,
+    partTimeProjectSelected: current.partTimeSelected === true,
+    partTimeProjectPrice: current.partTimePrice ? { amount: current.partTimePrice.amount, currency: current.partTimePrice.currency } : null,
+  };
+  if (modality === 'full') { body.fullTimeProjectSelected = true; body.fullTimeProjectPrice = { amount, currency }; }
+  else { body.partTimeProjectSelected = true; body.partTimeProjectPrice = { amount, currency }; }
+  return body;
+}
+
+function renderView(io, fp, p) {
+  io.section(fp.title);
+  io.notify(styleLabelPrefix(fp.fullTime(priceLine(fp, p.fullTimeSelected ? p.fullTimePrice : null))));
+  if (p.partTimeSelected) io.notify(styleLabelPrefix(fp.partTime(priceLine(fp, p.partTimePrice))));
+  io.success(fp.done);
+}
+
+async function runSet({ io, ask, session, catalog, opts, deps }) {
+  const fp = catalog.rate;
+  const hubAccessToken = session ? session.hubAccessToken : null;
+  if (!opts.stdinIsTTY) {
+    io.error(fp.setNeedsInteractive);
+    return { ok: false, reason: 'non-interactive' };
+  }
+  const selOut = (s) => io.notify(s);
+
+  // Read current so we can show it, preserve the other modality, and diff.
+  const read = await io.withProgress(fp.loading, () => deps.fetchPricingRate({ hubAccessToken }));
+  if (!read.ok && read.reason !== 'not-found') {
+    io.error(fp.fetchFailed(read.reason));
+    return { ok: false, reason: read.reason };
+  }
+  const current = read.ok ? read.pricing : EMPTY_PRICING;
+
+  io.section(fp.setTitle);
+  io.notify(styleLabelPrefix(fp.fullTime(priceLine(fp, current.fullTimeSelected ? current.fullTimePrice : null))));
+  io.notify(styleLabelPrefix(fp.partTime(priceLine(fp, current.partTimeSelected ? current.partTimePrice : null))));
+
+  // Arrow-key pickers for every discrete choice (modality, currency).
+  const modItem = await deps.promptSelect({
+    ask, stdinIsTTY: opts.stdinIsTTY, out: selOut, header: fp.setWhich,
+    items: [{ label: fp.modalityFull, value: 'full' }, { label: fp.modalityPart, value: 'part' }],
+    labelFor: (x) => x.label, input: opts.input, output: opts.output,
+  });
+  if (!modItem) { io.notify(fp.setCancelled); return { ok: true, cancelled: true }; }
+  const modality = modItem.value;
+  const modalityLabel = modality === 'full' ? fp.modalityFull : fp.modalityPart;
+
+  const amount = parseAmount(await io.ask(fp.setAmount(modalityLabel)));
+  if (amount === null) { io.error(fp.setAmountInvalid); return { ok: false, reason: 'bad-amount' }; }
+
+  const currency = await deps.promptSelect({
+    ask, stdinIsTTY: opts.stdinIsTTY, out: selOut, header: fp.setCurrency,
+    items: CURRENCIES, labelFor: (x) => x, input: opts.input, output: opts.output,
+  });
+  if (!currency) { io.notify(fp.setCancelled); return { ok: true, cancelled: true }; }
+
+  const oldMoney = modality === 'full' ? (current.fullTimeSelected ? current.fullTimePrice : null) : (current.partTimeSelected ? current.partTimePrice : null);
+  const oldStr = priceLine(fp, oldMoney);
+  const newStr = `${amount} ${currency}`;
+  io.notify(fp.setDiff(modalityLabel, oldStr, newStr));
+  const confirmed = await io.confirm(fp.setConfirm);
+  if (!confirmed) { io.notify(fp.setCancelled); return { ok: true, cancelled: true }; }
+
+  const body = buildBody(current, modality, amount, currency);
+  const res = await io.withProgress(fp.setSaving, () => deps.savePricingRate({ hubAccessToken, pricing: body }));
+  if (!res.ok) { io.error(fp.setFailed(res.reason)); return { ok: false, reason: res.reason }; }
+  io.success(fp.setDone(modalityLabel, newStr));
+  return { ok: true, set: { modality, amount, currency } };
+}
+
+async function runRate({ io, rawOut, ask, session, catalog, opts = {}, deps = makeRateDeps() }) {
+  const fp = catalog.rate;
+  if (opts.set) return runSet({ io, ask, session, catalog, opts, deps });
+
+  const hubAccessToken = session ? session.hubAccessToken : null;
+  const doFetch = () => deps.fetchPricingRate({ hubAccessToken });
+  const res = opts.json ? await doFetch() : await io.withProgress(fp.loading, doFetch);
+  if (!res.ok) {
+    io.error(res.reason === 'not-found' ? fp.notFound : fp.fetchFailed(res.reason));
+    return { ok: false, reason: res.reason };
+  }
+  if (opts.json) {
+    (rawOut || ((s) => process.stdout.write(s)))(`${JSON.stringify({ ok: true, pricing: res.pricing }, null, 2)}\n`);
+    return { ok: true, pricing: res.pricing };
+  }
+  renderView(io, fp, res.pricing);
+  return { ok: true, pricing: res.pricing };
+}
+
+module.exports = {
+  makeRateDeps,
+  runRate,
+  parseAmount,
+  buildBody,
+  CURRENCIES,
+};