@ouro.bot/cli 0.1.0-alpha.445 → 0.1.0-alpha.447

package/dist/heart/daemon/human-command-screens.js

@@ -17,6 +17,34 @@ function renderScreenEvent(screen) {
         meta: { screen },
     });
 }
+function homeActionSummary(action) {
+    switch (action.kind) {
+        case "chat":
+            return `Open chat with ${action.agent}.`;
+        case "up":
+            return "Start the local runtime and check what still needs attention.";
+        case "connect":
+            return "Set up providers, portable tools, and machine-specific attachments.";
+        case "repair":
+            return "Walk through repairs for anything blocking startup or chat.";
+        case "help":
+            return "Show the command guide.";
+        case "hatch":
+            return "Create a new agent on this machine.";
+        case "clone":
+            return "Bring an existing bundle onto this machine.";
+        case "exit":
+            return "Leave the prompt.";
+    }
+}
+function actionToWizardItem(action) {
+    return {
+        key: action.key,
+        label: action.label,
+        summary: homeActionSummary(action),
+        ...(action.key === "1" ? { recommended: true } : {}),
+    };
+}
 function buildOuroHomeActions(agents) {
     if (agents.length === 0) {
         return [
@@ -57,21 +85,28 @@ function resolveOuroHomeAction(answer, actions) {
 function renderOuroHomeScreen(options) {
     renderScreenEvent("home");
     const actions = buildOuroHomeActions(options.agents);
-    const sections = [
-        {
-            title: options.agents.length === 0 ? "Start here" : "Available agents",
-            lines: options.agents.length === 0
-                ? ["No agents are set up on this machine yet."]
-                : options.agents.map((agent) => `${agent} is available.`),
-        },
-    ];
-    const actionRows = actions.map((action, index) => ({
-        label: action.label,
-        actor: "agent-runnable",
-        command: action.command,
-        ...(index === 0 ? { recommended: true } : {}),
-    }));
-    return (0, terminal_ui_1.renderTerminalBoard)({
+    const chatActions = actions.filter((action) => action.kind === "chat");
+    const setupActions = actions.filter((action) => action.kind !== "chat");
+    const sections = options.agents.length === 0
+        ? [
+            {
+                title: "Start here",
+                summary: "There are no agents on this machine yet.",
+                items: setupActions.map((action) => actionToWizardItem(action)),
+            },
+        ]
+        : [
+            {
+                title: "Agents",
+                summary: "Jump straight into conversation or pick a setup path below.",
+                items: chatActions.map((action) => actionToWizardItem(action)),
+            },
+            {
+                title: "System",
+                items: setupActions.map((action) => actionToWizardItem(action)),
+            },
+        ];
+    return (0, terminal_ui_1.renderTerminalWizard)({
         isTTY: options.isTTY,
         columns: options.columns,
         masthead: {
@@ -84,13 +119,18 @@ function renderOuroHomeScreen(options) {
             ? "Create a new agent or clone an existing bundle to get started."
             : "Choose an agent or a setup task without memorizing commands.",
         sections,
-        actions: actionRows,
+        nextStep: {
+            label: options.agents.length === 0 ? "Start by creating or cloning an agent." : `Start with ${actions[0].label}.`,
+            detail: options.agents.length === 0
+                ? "Once one agent bundle exists here, the rest of the command surface becomes interactive."
+                : "You can always type the number or the agent name instead of remembering a command.",
+        },
         prompt: `Choose [1-${actions.length}] or type a name: `,
     });
 }
 function renderAgentPickerScreen(options) {
     renderScreenEvent("agent-picker");
-    return (0, terminal_ui_1.renderTerminalBoard)({
+    return (0, terminal_ui_1.renderTerminalWizard)({
         isTTY: options.isTTY,
         columns: options.columns,
         masthead: {
@@ -101,7 +141,12 @@ function renderAgentPickerScreen(options) {
         sections: [
             {
                 title: "Agents",
-                lines: options.agents.map((agent, index) => `${index + 1}. ${agent}`),
+                items: options.agents.map((agent, index) => ({
+                    key: String(index + 1),
+                    label: agent,
+                    summary: "Available on this machine.",
+                    ...(index === 0 ? { recommended: true } : {}),
+                })),
             },
         ],
         prompt: `Choose [1-${options.agents.length}] or type a name: `,
@@ -116,32 +161,65 @@ function resolveNamedAgentSelection(answer, agents) {
         return agents[numbered - 1];
     return agents.find((agent) => agent.toLowerCase() === normalized);
 }
-function statusLabel(status) {
-    return status.replace(/-/g, " ");
-}
 function renderHumanReadinessBoard(options) {
     renderScreenEvent("readiness");
-    const sections = options.snapshot.items.map((item) => ({
-        title: item.title,
-        lines: [
-            `${statusLabel(item.status)} — ${item.summary}`,
-            ...item.detailLines,
-        ],
+    const issueItems = options.snapshot.items.map((item) => ({
+        label: item.title,
+        status: item.status,
+        summary: item.summary,
+        detailLines: item.detailLines,
     }));
-    return renderHumanCommandBoard({
-        title: options.title,
-        subtitle: options.subtitle,
-        summary: options.snapshot.summary,
+    const actionItems = options.snapshot.nextActions.map((action, index) => ({
+        key: String(index + 1),
+        label: action.label,
+        actor: action.actor,
+        command: action.command,
+        ...(action.recommended ? { recommended: true } : {}),
+    }));
+    if (options.prompt) {
+        actionItems.push({
+            key: String(actionItems.length + 1),
+            label: "Skip for now",
+        });
+    }
+    return (0, terminal_ui_1.renderTerminalWizard)({
         isTTY: options.isTTY,
         columns: options.columns,
-        sections,
-        actions: options.snapshot.nextActions,
+        masthead: {
+            subtitle: options.subtitle,
+        },
+        title: options.title,
+        summary: options.snapshot.summary,
+        nextStep: options.snapshot.primaryAction
+            ? {
+                label: options.snapshot.primaryAction.label,
+                detail: options.snapshot.summary,
+                command: options.snapshot.primaryAction.command,
+            }
+            : options.snapshot.status === "ready" || options.snapshot.status === "attached"
+                ? {
+                    label: "Everything needed here is ready.",
+                    detail: "You can keep going or leave this area alone.",
+                }
+                : undefined,
+        sections: [
+            {
+                title: "What needs attention",
+                items: issueItems,
+            },
+            ...(actionItems.length > 0
+                ? [{
+                        title: "Ways forward",
+                        items: actionItems,
+                    }]
+                : []),
+        ],
         prompt: options.prompt,
     });
 }
 function renderHumanCommandBoard(options) {
     renderScreenEvent("command-board");
-    return (0, terminal_ui_1.renderTerminalBoard)({
+    return (0, terminal_ui_1.renderTerminalGuide)({
         isTTY: options.isTTY,
         columns: options.columns,
         masthead: {

package/dist/heart/daemon/interactive-repair.js

@@ -11,6 +11,7 @@ exports.isAffirmativeAnswer = isAffirmativeAnswer;
 exports.runInteractiveRepair = runInteractiveRepair;
 const runtime_1 = require("../../nerves/runtime");
 const identity_1 = require("../identity");
+const terminal_ui_1 = require("./terminal-ui");
 function isCredentialIssue(degraded) {
     const reason = degraded.errorReason.toLowerCase();
     const hint = degraded.fixHint.toLowerCase();
@@ -90,6 +91,9 @@ function fallbackCommandsFor(degraded, primaryCommand) {
 function renderRepairChoices(prefix, commands) {
     return commands.map((command, index) => `  ${index === 0 ? prefix : "or"}: ${command}`);
 }
+function repairStatusFor(action) {
+    return action.kind === "vault-unlock" ? "locked" : "needs credentials";
+}
 function renderRepairQueueSummaryLines(degraded) {
     const repairable = degraded
         .map((entry) => ({ entry, action: runnableRepairActionFor(entry) }))
@@ -109,6 +113,34 @@ function renderRepairQueueSummaryLines(degraded) {
     });
     return lines;
 }
+function renderRepairQueueSummary(degraded, deps) {
+    const repairable = degraded
+        .map((entry) => ({ entry, action: runnableRepairActionFor(entry) }))
+        .filter((item) => item.action !== undefined);
+    if (!deps.isTTY) {
+        return renderRepairQueueSummaryLines(degraded).join("\n");
+    }
+    return (0, terminal_ui_1.renderTerminalWizard)({
+        isTTY: true,
+        columns: deps.stdoutColumns,
+        masthead: {
+            subtitle: "Repair paths ready.",
+        },
+        title: "Needs attention before startup can finish",
+        summary: "Ouro found repair steps it can open right now. It will walk through them one at a time.",
+        sections: [{
+                title: "Repair queue",
+                items: repairable.map(({ entry, action }) => ({
+                    label: entry.agent,
+                    status: repairStatusFor(action),
+                    summary: action.label,
+                    detailLines: [entry.errorReason],
+                    command: action.command,
+                })),
+            }],
+        suppressEvent: true,
+    }).trimEnd();
+}
 function renderActionPromptLines(agent, action) {
     const lines = [
         `${agent}`,
@@ -120,11 +152,66 @@ function renderActionPromptLines(agent, action) {
     }
     return lines;
 }
-function renderDeferredRepair(agent, commands) {
-    return [
-        `Leaving ${agent} for later.`,
-        ...renderRepairChoices("next", commands),
-    ].join("\n");
+function renderActionPrompt(entry, action, deps) {
+    if (!deps.isTTY)
+        return renderActionPromptLines(entry.agent, action).join("\n");
+    const footer = action.kind === "vault-unlock"
+        ? "Only say yes if you have the saved vault unlock secret."
+        : "Say yes if you want Ouro to open the auth flow now.";
+    return (0, terminal_ui_1.renderTerminalWizard)({
+        isTTY: true,
+        columns: deps.stdoutColumns,
+        masthead: {
+            subtitle: "One repair step at a time.",
+        },
+        title: `Repair ${entry.agent}`,
+        summary: "Ouro found one clear next move for this agent.",
+        nextStep: {
+            label: action.kind === "vault-unlock"
+                ? "Unlock the credential vault on this machine."
+                : "Refresh provider authentication.",
+            detail: action.kind === "vault-unlock"
+                ? "Use the saved unlock secret if you have it. If not, leave this for later and choose a replacement or recovery path."
+                : "This opens the provider login or refresh flow for the selected provider.",
+            command: action.command,
+        },
+        sections: [{
+                title: "Why startup paused",
+                items: [{
+                        label: entry.agent,
+                        status: repairStatusFor(action),
+                        summary: entry.errorReason,
+                    }],
+            }],
+        footerLines: [footer],
+        suppressEvent: true,
+    }).trimEnd();
+}
+function renderDeferredRepair(agent, commands, deps) {
+    if (!deps.isTTY) {
+        return [
+            `Leaving ${agent} for later.`,
+            ...renderRepairChoices("next", commands),
+        ].join("\n");
+    }
+    return (0, terminal_ui_1.renderTerminalWizard)({
+        isTTY: true,
+        columns: deps.stdoutColumns,
+        masthead: {
+            subtitle: "Nothing changed yet.",
+        },
+        title: `Leaving ${agent} for later`,
+        summary: "Ouro did not open this repair flow right now.",
+        sections: [{
+                title: "Next time",
+                items: commands.map((command, index) => ({
+                    key: String(index + 1),
+                    label: index === 0 ? "Start here" : "Or try this",
+                    command,
+                })),
+            }],
+        suppressEvent: true,
+    }).trimEnd();
 }
 function renderManualRepairHint(agent, fixHint) {
     return [
@@ -140,7 +227,7 @@ function renderUnknownRepair(agent, errorReason) {
     ].join("\n");
 }
 function writeDeclinedRepair(degraded, command, deps) {
-    deps.writeStdout(renderDeferredRepair(degraded.agent, fallbackCommandsFor(degraded, command)));
+    deps.writeStdout(renderDeferredRepair(degraded.agent, fallbackCommandsFor(degraded, command), deps));
 }
 function runnableRepairActionFor(degraded) {
     const typedAction = degraded.issue?.actions
@@ -180,10 +267,10 @@ function typedActionToRunnable(degraded, action) {
 function writeRepairQueueSummary(degraded, deps) {
     const lines = renderRepairQueueSummaryLines(degraded);
     if (lines.length > 0)
-        deps.writeStdout(lines.join("\n"));
+        deps.writeStdout(renderRepairQueueSummary(degraded, deps));
 }
 async function attemptVaultUnlock(entry, action, deps) {
-    deps.writeStdout(renderActionPromptLines(entry.agent, action).join("\n"));
+    deps.writeStdout(renderActionPrompt(entry, action, deps));
     const answer = await deps.promptInput(`Unlock ${entry.agent}'s vault now? [y/N] `);
     if (!isAffirmativeAnswer(answer)) {
         writeDeclinedRepair(entry, action.command, deps);
@@ -211,7 +298,7 @@ async function attemptVaultUnlock(entry, action, deps) {
     }
 }
 async function attemptProviderAuth(entry, action, deps) {
-    deps.writeStdout(renderActionPromptLines(entry.agent, action).join("\n"));
+    deps.writeStdout(renderActionPrompt(entry, action, deps));
     const answer = await deps.promptInput(`Open the auth flow for ${entry.agent} now? [y/N] `);
     if (!isAffirmativeAnswer(answer)) {
         writeDeclinedRepair(entry, action.command, deps);

package/dist/heart/daemon/terminal-ui.js

@@ -7,7 +7,9 @@ exports.wrapPlain = wrapPlain;
 exports.renderOverwriteFrame = renderOverwriteFrame;
 exports.renderOuroMasthead = renderOuroMasthead;
 exports.formatActionActorLabel = formatActionActorLabel;
+exports.renderTerminalWizard = renderTerminalWizard;
 exports.renderTerminalBoard = renderTerminalBoard;
+exports.renderTerminalGuide = renderTerminalGuide;
 exports.renderTerminalOperation = renderTerminalOperation;
 const runtime_1 = require("../../nerves/runtime");
 const RESET = "\x1b[0m";
@@ -145,6 +147,154 @@ function renderOuroMasthead(options) {
 function formatActionActorLabel(actor) {
     return actor.replace(/-/g, " ");
 }
+function formatWizardStatusLabel(status) {
+    return status;
+}
+function isQuietWizardStatus(status) {
+    return status === "ready" || status === "attached" || status === "not attached";
+}
+function renderWizardStatusBadge(status, isTTY) {
+    const symbol = status === "ready" || status === "attached"
+        ? "●"
+        : status === "not attached"
+            ? "◌"
+            : "◆";
+    const label = `${symbol} ${formatWizardStatusLabel(status)}`;
+    if (!isTTY)
+        return label;
+    if (status === "ready" || status === "attached")
+        return color(label, GLOW, true);
+    if (status === "not attached")
+        return color(label, MIST);
+    return color(label, ALERT, true);
+}
+function renderWizardActorBadge(actor, isTTY) {
+    const label = `[${formatActionActorLabel(actor)}]`;
+    if (!isTTY)
+        return label;
+    if (actor === "human-required")
+        return color(label, ALERT, true);
+    if (actor === "human-choice")
+        return color(label, SCALE, true);
+    return color(label, MIST);
+}
+function renderWizardRecommendedBadge(isTTY) {
+    if (!isTTY)
+        return "[recommended]";
+    return color("[recommended]", GLOW, true);
+}
+function wrapWizardDetailLines(lines, width, isTTY, tone) {
+    const rendered = [];
+    for (const line of lines) {
+        const wrapped = wrapPlain(line, width);
+        for (const segment of wrapped) {
+            rendered.push(isTTY ? color(segment, tone) : segment);
+        }
+    }
+    return rendered;
+}
+function renderWizardItem(item, width, isTTY) {
+    const badges = [
+        ...(item.status ? [renderWizardStatusBadge(item.status, isTTY)] : []),
+        ...(item.actor ? [renderWizardActorBadge(item.actor, isTTY)] : []),
+        ...(item.recommended ? [renderWizardRecommendedBadge(isTTY)] : []),
+    ];
+    const keyPrefix = item.key ? `${item.key}. ` : "";
+    const header = `${keyPrefix}${item.label}${badges.length > 0 ? `  ${badges.join("  ")}` : ""}`;
+    const detailWidth = Math.max(18, width - 6);
+    const detailTone = item.status && !isQuietWizardStatus(item.status) ? BONE : MIST;
+    const lines = [isTTY ? color(header, BONE, true) : header];
+    if (item.summary) {
+        lines.push(...wrapWizardDetailLines([item.summary], detailWidth, isTTY, detailTone));
+    }
+    if (item.detailLines && item.detailLines.length > 0) {
+        lines.push(...wrapWizardDetailLines(item.detailLines, detailWidth, isTTY, detailTone));
+    }
+    if (item.command) {
+        lines.push(...wrapWizardDetailLines([`run: ${item.command}`], detailWidth, isTTY, MIST));
+    }
+    return lines.flatMap((line, index) => index === 0 ? [line] : [`   ${line}`]);
+}
+function renderWizardSectionTTY(section, width) {
+    const lines = [];
+    if (section.summary) {
+        lines.push(...wrapWizardDetailLines([section.summary], Math.max(18, width - 4), true, MIST));
+    }
+    for (const [index, item] of section.items.entries()) {
+        if (index > 0)
+            lines.push("");
+        lines.push(...renderWizardItem(item, width, true));
+    }
+    return renderOperationSectionTTY(section.title, lines, width);
+}
+function renderWizardSectionPlain(section, width) {
+    const lines = [];
+    if (section.summary) {
+        lines.push(...wrapWizardDetailLines([section.summary], Math.max(18, width - 4), false, MIST));
+    }
+    for (const [index, item] of section.items.entries()) {
+        if (index > 0)
+            lines.push("");
+        lines.push(...renderWizardItem(item, width, false));
+    }
+    return renderOperationSectionPlain(section.title, lines);
+}
+function renderTerminalWizard(options) {
+    if (!options.suppressEvent) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.terminal_wizard_rendered",
+            message: "rendered shared terminal wizard",
+            meta: {
+                title: options.title,
+                sections: options.sections?.length ?? 0,
+                items: options.sections?.reduce((count, section) => count + section.items.length, 0) ?? 0,
+                hasNextStep: !!options.nextStep,
+                tty: options.isTTY,
+            },
+        });
+    }
+    const width = boardWidth(options.columns);
+    const blocks = [];
+    blocks.push(renderOuroMasthead({
+        isTTY: options.isTTY,
+        columns: width,
+        subtitle: options.masthead?.subtitle,
+    }).trimEnd());
+    const introLines = [
+        options.isTTY ? color(options.title, BONE, true) : options.title,
+        ...(options.summary
+            ? wrapPlain(options.summary, Math.max(20, width - 2)).map((line) => options.isTTY ? color(line, MIST) : line)
+            : []),
+    ];
+    blocks.push(introLines.join("\n"));
+    if (options.nextStep) {
+        const nextStepLines = [
+            options.isTTY ? color(options.nextStep.label, BONE, true) : options.nextStep.label,
+            ...(options.nextStep.detail
+                ? wrapPlain(options.nextStep.detail, Math.max(18, width - 4)).map((line) => options.isTTY ? color(line, MIST) : line)
+                : []),
+            ...(options.nextStep.command
+                ? wrapPlain(`run: ${options.nextStep.command}`, Math.max(18, width - 4)).map((line) => options.isTTY ? color(line, MIST) : line)
+                : []),
+        ];
+        blocks.push((options.isTTY
+            ? renderOperationSectionTTY("Recommended next step", nextStepLines, width)
+            : renderOperationSectionPlain("Recommended next step", nextStepLines)).join("\n"));
+    }
+    for (const section of options.sections ?? []) {
+        blocks.push((options.isTTY
+            ? renderWizardSectionTTY(section, width)
+            : renderWizardSectionPlain(section, width)).join("\n"));
+    }
+    if (options.footerLines && options.footerLines.length > 0) {
+        blocks.push(options.footerLines.map((line) => options.isTTY ? color(line, MIST) : line).join("\n"));
+    }
+    if (options.prompt) {
+        blocks.push(options.isTTY ? color(options.prompt, BONE, true) : options.prompt);
+    }
+    return `${blocks.join("\n\n")}\n`;
+}
 function renderActionLine(action) {
     const chips = [`[${formatActionActorLabel(action.actor)}]`];
     if (action.recommended)
@@ -195,6 +345,56 @@ function renderTerminalBoard(options) {
     }
     return `${blocks.join("\n\n")}\n`;
 }
+function renderTerminalGuide(options) {
+    if (!options.suppressEvent) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.terminal_guide_rendered",
+            message: "rendered shared terminal guide",
+            meta: {
+                title: options.title,
+                sections: options.sections?.length ?? 0,
+                actions: options.actions?.length ?? 0,
+                tty: options.isTTY,
+            },
+        });
+    }
+    const width = boardWidth(options.columns);
+    const blocks = [];
+    blocks.push(renderOuroMasthead({
+        isTTY: options.isTTY,
+        columns: width,
+        subtitle: options.masthead?.subtitle,
+    }).trimEnd());
+    const introLines = [
+        options.isTTY ? color(options.title, BONE, true) : options.title,
+        ...(options.summary
+            ? wrapPlain(options.summary, Math.max(20, width - 2)).map((line) => options.isTTY ? color(line, MIST) : line)
+            : []),
+    ];
+    blocks.push(introLines.join("\n"));
+    for (const section of options.sections ?? []) {
+        const lines = section.lines.map((line) => options.isTTY ? color(line, BONE) : line);
+        blocks.push((options.isTTY
+            ? renderOperationSectionTTY(section.title, lines, width)
+            : renderOperationSectionPlain(section.title, lines)).join("\n"));
+    }
+    const actionList = options.actions ?? [];
+    if (actionList.length > 0) {
+        const lines = [];
+        for (const [index, action] of actionList.entries()) {
+            lines.push(options.isTTY ? color(`${index + 1}. ${renderActionLine(action)}`, BONE, true) : `${index + 1}. ${renderActionLine(action)}`);
+            lines.push(options.isTTY ? color(`run: ${action.command}`, MIST) : `run: ${action.command}`);
+        }
+        blocks.push((options.isTTY
+            ? renderOperationSectionTTY("Next moves", lines, width)
+            : renderOperationSectionPlain("Next moves", lines)).join("\n"));
+    }
+    if (options.prompt) {
+        blocks.push(options.isTTY ? color(options.prompt, BONE, true) : options.prompt);
+    }
+    return `${blocks.join("\n\n")}\n`;
+}
 function formatOperationStep(step) {
     const marker = step.status === "done"
         ? "✓"

package/dist/heart/provider-credentials.js

@@ -209,6 +209,11 @@ function cacheResult(agentName, result) {
     cachedPools.set(agentName, result);
     return result;
 }
+function selectedProviders(providers) {
+    if (!providers || providers.length === 0)
+        return [...VALID_PROVIDERS];
+    return [...new Set(providers)];
+}
 function resultForProvider(poolResult, provider) {
     if (!poolResult.ok)
         return poolResult;
@@ -227,12 +232,13 @@ function readProviderCredentialPool(agentName) {
     return cachedPools.get(agentName) ?? missingPool(agentName);
 }
 async function refreshProviderCredentialPool(agentName, options = {}) {
+    const providersToRead = selectedProviders(options.providers);
     try {
         const store = (0, credential_access_1.getCredentialStore)(agentName);
         options.onProgress?.(`reading vault items for ${agentName}...`);
         const providers = {};
         let updatedAt = new Date(0).toISOString();
-        for (const provider of VALID_PROVIDERS) {
+        for (const provider of providersToRead) {
             const itemName = providerCredentialItemName(provider);
             options.onProgress?.(`reading ${provider} credentials...`);
             let raw;
@@ -261,9 +267,19 @@ async function refreshProviderCredentialPool(agentName, options = {}) {
             component: "config/identity",
             event: "config.provider_credentials_loaded",
             message: "loaded provider credentials from vault",
-            meta: { agentName, providerCount: Object.keys(providers).length },
+            meta: {
+                agentName,
+                providerCount: Object.keys(providers).length,
+                requestedProviderCount: providersToRead.length,
+                cacheSkipped: options.skipCache === true,
+            },
         });
-        return cacheResult(agentName, { ok: true, poolPath: providerCredentialsVaultPath(agentName), pool });
+        const result = {
+            ok: true,
+            poolPath: providerCredentialsVaultPath(agentName),
+            pool,
+        };
+        return options.skipCache ? result : cacheResult(agentName, result);
     }
     catch (error) {
         const cached = cachedPools.get(agentName);
@@ -282,7 +298,7 @@ async function refreshProviderCredentialPool(agentName, options = {}) {
         });
         if (options.preserveCachedOnFailure && cached?.ok)
             return cached;
-        return cacheResult(agentName, result);
+        return options.skipCache ? result : cacheResult(agentName, result);
     }
 }
 function createProviderCredentialRecord(input) {