shakers-cli-beta 0.8.0-beta.0

package/src/model-call-record.js

@@ -0,0 +1,198 @@
+'use strict';
+
+// What happened with each model call, written down (talents-ai-score, issue 109).
+
+// The three keys.
+const MODEL_CALL = Object.freeze({
+  SYNTHESIS: 'agentSynthesis',
+  EVALUATION: 'agentEvaluation',
+  ROADMAP: 'roadmapPersonalization',
+});
+
+const REASON = Object.freeze({
+  // ok:true
+  OK: 'ok',
+  // ok:true AND INCOMPLETE (2026-08-03, from a real incident).
+  OK_PARTIAL: 'ok-partial',
+  // ok:null — never attempted, and NOT a failure
+  NO_AGENTS: 'no-agents',
+  NO_ENDPOINT: 'no-endpoint-configured',
+  MAX_TIER: 'max-tier',
+  NOT_APPLICABLE: 'not-applicable',
+  NO_CONSENT: 'no-consent',
+  // ok:false — attempted, and something was lost
+  TIMEOUT: 'timeout',
+  NETWORK: 'network-error',
+  INVALID_URL: 'invalid-endpoint-url',
+  HTTP: 'http-error',
+  MALFORMED_JSON: 'malformed-json',
+  UNEXPECTED_SHAPE: 'unexpected-shape',
+  LOCAL_ERROR: 'local-error',
+});
+
+// The reasons that mean the call produced usable data (`ok: true`).
+const SUCCESS_REASONS = new Set([REASON.OK, REASON.OK_PARTIAL]);
+
+// "Didn't apply" — the reasons that produce `ok: null`.
+const SKIP_REASONS = new Set([
+  REASON.NO_AGENTS,
+  REASON.NO_ENDPOINT,
+  REASON.MAX_TIER,
+  REASON.NOT_APPLICABLE,
+  REASON.NO_CONSENT,
+]);
+
+const FAILURE_REASONS = new Set([
+  REASON.TIMEOUT,
+  REASON.NETWORK,
+  REASON.INVALID_URL,
+  REASON.HTTP,
+  REASON.MALFORMED_JSON,
+  REASON.UNEXPECTED_SHAPE,
+  REASON.LOCAL_ERROR,
+]);
+
+// The rejection `.kind` tags `src/backend-request.js` attaches, mapped onto this vocabulary.
+function classifyChainError(e) {
+  const kind = e && e.kind;
+  if (kind === 'timeout') return REASON.TIMEOUT;
+  if (kind === 'network-error') return REASON.NETWORK;
+  if (kind === 'invalid-url') return REASON.INVALID_URL;
+  if (kind === 'no-endpoint') return REASON.NO_ENDPOINT;
+  return REASON.LOCAL_ERROR;
+}
+
+// The canonical record.
+function record({ attemptedAt, ok, reason, status = null, backend = null, elapsedMs = null, timeoutMs = null, hops = [], omitted = [] }) {
+  return {
+    attemptedAt: attemptedAt || null,
+    ok,
+    reason,
+    status: typeof status === 'number' ? status : null,
+    backend: backend || null,
+    elapsedMs: typeof elapsedMs === 'number' ? elapsedMs : null,
+    timeoutMs: typeof timeoutMs === 'number' ? timeoutMs : null,
+    hops: Array.isArray(hops) ? hops : [],
+    // What the call did NOT cover, by name.
+    omitted: Array.isArray(omitted) ? omitted.filter((n) => typeof n === 'string' && n) : [],
+  };
+}
+
+// A call that never went out.
+function skipped(reason) {
+  return record({ attemptedAt: null, ok: null, reason: reason || REASON.NOT_APPLICABLE });
+}
+
+// A failure that happened BEFORE the wire (building the request threw: a file that can't be read, a parse that blew up).
+function failedLocally(reason = REASON.LOCAL_ERROR) {
+  return record({ attemptedAt: new Date().toISOString(), ok: false, reason });
+}
+
+// The one-shot reporter each client module uses.
+function reporterFor(onOutcome, { timeoutMs = null } = {}) {
+  const attemptedAt = new Date().toISOString();
+  const startedHr = process.hrtime.bigint();
+  const hops = [];
+  let settled = false;
+
+  const emit = (built) => {
+    if (settled) return null;
+    settled = true;
+    if (typeof onOutcome === 'function') onOutcome(built);
+    return built;
+  };
+  const elapsed = () => Number((process.hrtime.bigint() - startedHr) / 1000000n);
+
+  return {
+    // Handed to `requestBackend` as `trace`.
+    hops,
+    skip(reason) {
+      return emit(skipped(reason));
+    },
+    fail(reason, { status = null, backend = null } = {}) {
+      return emit(record({ attemptedAt, ok: false, reason, status, backend, elapsedMs: elapsed(), timeoutMs, hops }));
+    },
+    failFromError(e) {
+      return this.fail(classifyChainError(e));
+    },
+    // `omitted` non-empty flips the reason to `ok-partial` and NOT `ok` — the one decision that stops a partial answer from being recorded as a clean run.
+    succeed({ status = null, backend = null, omitted = [] } = {}) {
+      const left = Array.isArray(omitted) ? omitted.filter((n) => typeof n === 'string' && n) : [];
+      return emit(record({
+        attemptedAt,
+        ok: true,
+        reason: left.length ? REASON.OK_PARTIAL : REASON.OK,
+        status,
+        backend,
+        elapsedMs: elapsed(),
+        timeoutMs,
+        hops,
+        omitted: left,
+      }));
+    },
+  };
+}
+
+// Attaches a record to the report under its call key.
+function attachModelCall(report, key, built) {
+  if (!report || typeof report !== 'object' || !key) return built;
+  if (!report.modelCalls || typeof report.modelCalls !== 'object') report.modelCalls = {};
+  report.modelCalls[key] = built;
+  return built;
+}
+
+function modelCall(report, key) {
+  const calls = report && report.modelCalls;
+  return calls && typeof calls === 'object' ? calls[key] || null : null;
+}
+
+// The two predicates the render layer is allowed to ask.
+function callFailed(report, key) {
+  const c = modelCall(report, key);
+  return !!c && c.ok === false;
+}
+
+function callSucceeded(report, key) {
+  const c = modelCall(report, key);
+  return !!c && c.ok === true;
+}
+
+// The call worked AND left something out.
+function callPartial(report, key) {
+  const c = modelCall(report, key);
+  return !!c && c.ok === true && Array.isArray(c.omitted) && c.omitted.length > 0;
+}
+
+// THE CALL LOST TIME TO A DEADLINE — and this is NOT `reason === TIMEOUT` (issue 116, found by measuring, not by reading).
+function callTimedOut(report, key) {
+  const c = modelCall(report, key);
+  if (!c || c.ok !== false) return false;
+  if (c.reason === REASON.TIMEOUT) return true;
+  return Array.isArray(c.hops) && c.hops.some((h) => h && h.kind === REASON.TIMEOUT);
+}
+
+// The names the call left out, for the surface that names them. `[]` when the run
+// was complete, so a caller never has to null-check before iterating.
+function omittedByCall(report, key) {
+  const c = modelCall(report, key);
+  return c && Array.isArray(c.omitted) ? c.omitted : [];
+}
+
+module.exports = {
+  MODEL_CALL,
+  REASON,
+  SKIP_REASONS,
+  FAILURE_REASONS,
+  SUCCESS_REASONS,
+  classifyChainError,
+  skipped,
+  failedLocally,
+  reporterFor,
+  attachModelCall,
+  modelCall,
+  callFailed,
+  callSucceeded,
+  callPartial,
+  callTimedOut,
+  omittedByCall,
+};

package/src/onboarding-availability.js

@@ -0,0 +1,26 @@
+'use strict';
+
+const { loadAuthSession, sessionStatus } = require('./auth-session-store');
+const { getOnboardingStatusEndpoint } = require('./config');
+const { requestOnboardingStatus } = require('./onboarding-status-client');
+
+async function checkOnboardingCompleted({
+  env = process.env,
+  session = null,
+  loadSession = loadAuthSession,
+  endpointGetter = getOnboardingStatusEndpoint,
+  fetchStatus = requestOnboardingStatus,
+  timeoutMs,
+} = {}) {
+  const active = session || loadSession();
+  if (sessionStatus(active) !== 'active') return false;
+  const endpoint = endpointGetter(env);
+  if (!endpoint) return false;
+  const res = await fetchStatus(
+    { accessToken: active.accessToken },
+    timeoutMs ? { endpoint, timeoutMs } : { endpoint },
+  );
+  return res.ok ? res.completed === true : false;
+}
+
+module.exports = { checkOnboardingCompleted };

package/src/onboarding-client.js

@@ -0,0 +1,364 @@
+'use strict';
+
+const { postJsonWithTimeout } = require('./backend-request');
+const { WORKS_CODE_TO_REASON } = require('./skills-client');
+const { toLowerLang, toUpperLang } = require('./lang-codes');
+
+const DEFAULT_TIMEOUT_MS = 20000;
+const IMPORT_KICKOFF_TIMEOUT_MS = 90000;
+
+function parseJson(raw) {
+  try {
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return null;
+  }
+}
+
+function hubHeaders({ hubAccessToken } = {}) {
+  const headers = {};
+  if (typeof hubAccessToken === 'string' && hubAccessToken) headers.Authorization = `Bearer ${hubAccessToken}`;
+  return headers;
+}
+
+function bearerHeaders({ accessToken } = {}) {
+  const headers = {};
+  if (typeof accessToken === 'string' && accessToken) headers.Authorization = `Bearer ${accessToken}`;
+  return headers;
+}
+
+function reasonForError(status, raw) {
+  const body = parseJson(raw);
+  const code = body && typeof body.code === 'string' ? body.code : null;
+  return (code && WORKS_CODE_TO_REASON[code]) || `http-${status}`;
+}
+
+function envelopeData(raw) {
+  const json = parseJson(raw);
+  if (!json || typeof json !== 'object' || json.status !== 'OK') return undefined;
+  return json.data;
+}
+
+function buildImportSources({ linkedinUrl, cvPath, githubUrl, websiteUrl, language } = {}) {
+  const sources = { language: toLowerLang(language) };
+  if (typeof linkedinUrl === 'string' && linkedinUrl) sources.linkedinUrl = linkedinUrl;
+  if (typeof cvPath === 'string' && cvPath) sources.cvPath = cvPath;
+  if (typeof githubUrl === 'string' && githubUrl) sources.githubUrl = githubUrl;
+  if (typeof websiteUrl === 'string' && websiteUrl) sources.websiteUrl = websiteUrl;
+  return sources;
+}
+
+async function requestImportProfile(
+  { linkedinUrl, cvPath, githubUrl, websiteUrl, language, accessToken, hubAccessToken } = {},
+  { endpoint, timeoutMs = IMPORT_KICKOFF_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!linkedinUrl) return { ok: false, reason: 'no-linkedin' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+
+  const body = buildImportSources({ linkedinUrl, cvPath, githubUrl, websiteUrl, language });
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, body, timeoutMs, 'POST', null, hubHeaders({ hubAccessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+
+  const data = envelopeData(res.raw);
+  if (data === undefined) return { ok: false, reason: 'bad-response' };
+  const jobId = data && typeof data === 'object' && (data.jobId || data.importId || data.id) || null;
+  const state = data && typeof data === 'object' && typeof data.state === 'string' ? data.state : 'running';
+  return { ok: true, jobId, state };
+}
+
+async function requestImportStatus(
+  { jobId, accessToken, hubAccessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!jobId) return { ok: false, reason: 'no-job' };
+
+  const url = `${endpoint.replace(/\/+$/, '')}/${encodeURIComponent(jobId)}`;
+  let res;
+  try {
+    res = await postJsonWithTimeout(url, null, timeoutMs, 'GET', null, hubHeaders({ hubAccessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+
+  const data = envelopeData(res.raw);
+  if (data === undefined || !data || typeof data !== 'object') return { ok: false, reason: 'bad-response' };
+  const state = typeof data.state === 'string' ? data.state : 'running';
+  return { ok: true, state };
+}
+
+async function requestSetProfessionalDetails(
+  { currentEmploymentStatus, freelanceIntent, changeMotivators, freelanceType, accessToken, hubAccessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+
+  const body = {};
+  if (typeof currentEmploymentStatus === 'string' && currentEmploymentStatus) body.currentEmploymentStatus = currentEmploymentStatus;
+  if (typeof freelanceIntent === 'string' && freelanceIntent) body.freelanceIntent = freelanceIntent;
+  if (typeof changeMotivators === 'string' && changeMotivators) body.changeMotivators = changeMotivators;
+  // freelanceType derived from the work situation (the single place it is asked now).
+  if (typeof freelanceType === 'string' && freelanceType) body.freelanceType = freelanceType;
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, body, timeoutMs, 'PATCH', null, hubHeaders({ hubAccessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+  if (envelopeData(res.raw) === undefined) return { ok: false, reason: 'bad-response' };
+  return { ok: true };
+}
+
+async function requestSetPricingRate(
+  { pricing, accessToken, hubAccessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+  if (!pricing || typeof pricing !== 'object') return { ok: false, reason: 'no-pricing' };
+
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, pricing, timeoutMs, 'PUT', null, hubHeaders({ hubAccessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+  if (envelopeData(res.raw) === undefined) return { ok: false, reason: 'bad-response' };
+  return { ok: true };
+}
+
+async function requestSetAvailability(
+  { availability, accessToken, hubAccessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+  if (!availability || typeof availability !== 'object') return { ok: false, reason: 'no-availability' };
+
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, availability, timeoutMs, 'PUT', null, hubHeaders({ hubAccessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+  if (envelopeData(res.raw) === undefined) return { ok: false, reason: 'bad-response' };
+  return { ok: true };
+}
+
+async function requestLanguagesCatalog(
+  { hubAccessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, null, timeoutMs, 'GET', null, hubHeaders({ hubAccessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+
+  const data = envelopeData(res.raw);
+  if (!Array.isArray(data)) return { ok: false, reason: 'bad-response' };
+  return { ok: true, languages: data };
+}
+
+async function requestSetLanguages(
+  { languages, accessToken, hubAccessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+  if (!Array.isArray(languages) || languages.length === 0) return { ok: false, reason: 'no-languages' };
+
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, { languages }, timeoutMs, 'PATCH', null, hubHeaders({ hubAccessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+  if (envelopeData(res.raw) === undefined) return { ok: false, reason: 'bad-response' };
+  return { ok: true };
+}
+
+async function requestSetTalentPhone(
+  { telephoneCode, telephoneNumber, accessToken, hubAccessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+
+  const body = { telephoneCode, telephoneNumber };
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, body, timeoutMs, 'PATCH', null, hubHeaders({ hubAccessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+  if (envelopeData(res.raw) === undefined) return { ok: false, reason: 'bad-response' };
+  return { ok: true };
+}
+
+async function requestCompleteOnboarding(
+  { accessToken, 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, 'POST', null, hubHeaders({ hubAccessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+
+  const data = envelopeData(res.raw);
+  if (data === undefined) return { ok: false, reason: 'bad-response' };
+  const d = data && typeof data === 'object' ? data : {};
+  return {
+    ok: true,
+    onboardingStatus: typeof d.onboardingStatus === 'string' ? d.onboardingStatus : null,
+    registrationLevel: typeof d.registrationLevel === 'string' ? d.registrationLevel : null,
+    completedProfilePercentage: typeof d.completedProfilePercentage === 'number' ? d.completedProfilePercentage : null,
+  };
+}
+
+// PATCH /interviews/onboarding/restart (no body) — overwrites the taken onboarding interview in-place so it can be re-run.
+async function requestRestartOnboardingInterview(
+  { accessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, null, timeoutMs, 'PATCH', null, bearerHeaders({ accessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw), status: res.status };
+
+  const data = envelopeData(res.raw);
+  const d = data && typeof data === 'object' ? data : {};
+  return { ok: true, interviewId: d.interviewId || null, language: d.language || null };
+}
+
+async function requestCreateOnboardingInterview(
+  { candidateId, accessToken } = {},
+  { base, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!base) return { ok: false, reason: 'no-endpoint' };
+  if (!candidateId) return { ok: false, reason: 'no-candidate' };
+
+  const url = `${base.replace(/\/+$/, '')}/onboarding`;
+  let res;
+  try {
+    res = await postJsonWithTimeout(url, { candidateId }, timeoutMs, 'POST', null, bearerHeaders({ accessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+
+  const data = envelopeData(res.raw);
+  if (data === undefined || !data || typeof data !== 'object' || !data.interviewId) return { ok: false, reason: 'bad-response' };
+  return { ok: true, interviewId: data.interviewId, created: data.created === true, language: data.language || null };
+}
+
+async function requestStartTextSession(
+  { interviewId, language, accessToken } = {},
+  { base, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!base) return { ok: false, reason: 'no-endpoint' };
+  if (!interviewId) return { ok: false, reason: 'no-interview' };
+
+  const url = `${base.replace(/\/+$/, '')}/${encodeURIComponent(interviewId)}/text-session`;
+  const body = { language: toUpperLang(language) };
+  let res;
+  try {
+    res = await postJsonWithTimeout(url, body, timeoutMs, 'POST', null, bearerHeaders({ accessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+
+  const data = envelopeData(res.raw);
+  if (data === undefined || !data || typeof data !== 'object') return { ok: false, reason: 'bad-response' };
+  return { ok: true, interviewId: data.interviewId || interviewId, greeting: typeof data.greeting === 'string' ? data.greeting : '' };
+}
+
+async function requestOnboardingTurn(
+  { interviewId, message, accessToken } = {},
+  { base, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!base) return { ok: false, reason: 'no-endpoint' };
+  if (!interviewId) return { ok: false, reason: 'no-interview' };
+  if (typeof message !== 'string' || !message) return { ok: false, reason: 'no-message' };
+
+  const url = `${base.replace(/\/+$/, '')}/${encodeURIComponent(interviewId)}/text-session/turns`;
+  let res;
+  try {
+    res = await postJsonWithTimeout(url, { message }, timeoutMs, 'POST', null, bearerHeaders({ accessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+
+  const data = envelopeData(res.raw);
+  if (data === undefined || !data || typeof data !== 'object') return { ok: false, reason: 'bad-response' };
+  return { ok: true, response: typeof data.response === 'string' ? data.response : '', ended: data.ended === true };
+}
+
+async function requestCompleteTextSession(
+  { interviewId, accessToken } = {},
+  { base, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!base) return { ok: false, reason: 'no-endpoint' };
+  if (!interviewId) return { ok: false, reason: 'no-interview' };
+
+  const url = `${base.replace(/\/+$/, '')}/${encodeURIComponent(interviewId)}/text-session/complete`;
+  let res;
+  try {
+    res = await postJsonWithTimeout(url, null, timeoutMs, 'POST', null, bearerHeaders({ accessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+
+  const data = envelopeData(res.raw);
+  if (data === undefined || !data || typeof data !== 'object') return { ok: false, reason: 'bad-response' };
+  return { ok: true, state: typeof data.state === 'string' ? data.state : null };
+}
+
+module.exports = {
+  requestImportProfile,
+  requestImportStatus,
+  requestSetProfessionalDetails,
+  requestSetPricingRate,
+  requestSetAvailability,
+  requestLanguagesCatalog,
+  requestSetLanguages,
+  requestSetTalentPhone,
+  requestCompleteOnboarding,
+  requestRestartOnboardingInterview,
+  requestCreateOnboardingInterview,
+  requestStartTextSession,
+  requestOnboardingTurn,
+  requestCompleteTextSession,
+  buildImportSources,
+  reasonForError,
+};