@salesforce/b2c-tooling-sdk 2.3.0 → 2.4.0

package/dist/esm/test-utils/config-isolation.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-isolation.js","sourceRoot":"","sources":["../../../src/test-utils/config-isolation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAEhD,MAAM,mBAAmB,GAAG,CAAC,0BAA0B,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAMjF,IAAI,KAAK,GAA0B,IAAI,CAAC;AAExC,MAAM,UAAU,aAAa;IAC3B,IAAI,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IAElG,MAAM,YAAY,GAAuC,EAAE,CAAC;IAE5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACpF,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACtC,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,WAAW,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,QAAQ,CAAC;IAEtC,4DAA4D;IAC5D,WAAW,EAAE,CAAC;IAEd,KAAK,GAAG,EAAC,YAAY,EAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,yCAAyC;IACzC,WAAW,EAAE,CAAC;IAEd,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACxC,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAElC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,KAAK,GAAG,IAAI,CAAC;AACf,CAAC"}
+{"version":3,"file":"config-isolation.js","sourceRoot":"","sources":["../../../src/test-utils/config-isolation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAEhD,MAAM,mBAAmB,GAAG,CAAC,0BAA0B,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAEjF,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,CACL,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,CACrH,CAAC;AACJ,CAAC;AAMD,IAAI,KAAK,GAA0B,IAAI,CAAC;AAExC,MAAM,UAAU,aAAa;IAC3B,IAAI,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IAElG,MAAM,YAAY,GAAuC,EAAE,CAAC;IAE5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;IACtC,qCAAqC;IACrC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,EAAE,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,WAAW,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,QAAQ,CAAC;IAEtC,4DAA4D;IAC5D,WAAW,EAAE,CAAC;IAEd,KAAK,GAAG,EAAC,YAAY,EAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,yCAAyC;IACzC,WAAW,EAAE,CAAC;IAEd,8EAA8E;IAC9E,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,gBAAgB,CAAC,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9D,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACpD,CAAC;IAED,KAAK,GAAG,IAAI,CAAC;AACf,CAAC"}

package/dist/esm/ux/agent-context.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Best-effort detection of AI coding agent harnesses (Claude Code, Cursor,
+ * Codex, etc.) from the environment of the current process.
+ *
+ * Detection is advisory: it tailors help output, disables interactive prompts,
+ * and attributes telemetry. It must never block or fail a command.
+ *
+ * Detection relies only on environment variables that harnesses set for their
+ * child processes. Users can override detection with `SFCC_AGENT`:
+ *
+ * - `SFCC_AGENT=<name>` forces agent mode and reports `<name>` as the harness
+ * - `SFCC_AGENT=0` (or `false`/`no`/`off`) disables detection entirely
+ *
+ * @module ux/agent-context
+ */
+/** An AI coding agent harness (the tool driving the CLI). */
+export interface AgentHarness {
+    /** Stable identifier (e.g. `claude-code`). */
+    id: string;
+    /** Human-readable name (e.g. `Claude Code`). */
+    name: string;
+}
+/** A single detector match. */
+export interface AgentMatch {
+    harness: AgentHarness;
+    /** Harness session/thread/conversation identifier, when exposed. */
+    sessionId?: string;
+    /** Environment variable names that produced the match. */
+    signals: readonly string[];
+}
+/** Result of agent detection. */
+export interface AgentContext {
+    /** True when any harness was detected (or forced via `SFCC_AGENT`). */
+    isAgentic: boolean;
+    /** Highest-precedence harness, or null. */
+    harness: AgentHarness | null;
+    /** First available session identifier across matches, or null. */
+    sessionId: null | string;
+    /** All matches in precedence order. */
+    matches: readonly AgentMatch[];
+}
+export type AgentEnvironment = Readonly<Record<string, string | undefined>>;
+export type AgentDetector = (env: AgentEnvironment) => AgentMatch | null;
+/**
+ * Detectors in precedence order. Direct agents precede host surfaces so that,
+ * for example, Claude Code launched inside Warp is reported as Claude Code
+ * while the Warp match is retained in `matches`.
+ */
+export declare const agentDetectors: readonly AgentDetector[];
+/**
+ * Detects whether the current process is being driven by an AI coding agent.
+ *
+ * @param env - Environment to inspect (defaults to `process.env`)
+ * @param detectors - Detectors in precedence order (defaults to {@link agentDetectors})
+ */
+export declare function detectAgentContext(env?: AgentEnvironment, detectors?: readonly AgentDetector[]): AgentContext;
+/**
+ * Cached {@link detectAgentContext} for `process.env`. The environment of a
+ * process does not change in ways relevant to detection, so detect once.
+ */
+export declare function getAgentContext(): AgentContext;
+/** Clears the cached agent context (for tests). */
+export declare function resetAgentContext(): void;
+/**
+ * Whether interactive prompts can be shown: stdin is a TTY and the process is
+ * not driven by an AI agent (agents typically cannot answer prompts, and
+ * hanging on one wastes the agent's turn).
+ */
+export declare function isInteractive(): boolean;

package/dist/esm/ux/agent-context.js

@@ -0,0 +1,133 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+const FALSE_LIKE_VALUES = new Set(['', '0', 'false', 'no', 'off']);
+/** Returns the trimmed value, treating false-like values as unset. */
+function value(env, name) {
+    const raw = env[name];
+    if (typeof raw !== 'string')
+        return undefined;
+    const normalized = raw.trim();
+    return FALSE_LIKE_VALUES.has(normalized.toLowerCase()) ? undefined : normalized;
+}
+/**
+ * Builds a detector that matches when any marker env var equals its expected
+ * value (or is set to any truthy value when `expected` is omitted).
+ */
+function markerDetector(harness, markers, sessionVars = []) {
+    return (env) => {
+        const signals = [];
+        for (const { name, expected } of markers) {
+            const matched = expected === undefined ? value(env, name) !== undefined : env[name] === expected;
+            if (matched)
+                signals.push(name);
+        }
+        if (signals.length === 0)
+            return null;
+        let sessionId;
+        for (const name of sessionVars) {
+            const v = value(env, name);
+            if (v) {
+                signals.push(name);
+                sessionId ??= v;
+            }
+        }
+        return { harness, sessionId, signals };
+    };
+}
+/**
+ * Detectors in precedence order. Direct agents precede host surfaces so that,
+ * for example, Claude Code launched inside Warp is reported as Claude Code
+ * while the Warp match is retained in `matches`.
+ */
+export const agentDetectors = [
+    markerDetector({ id: 'opencode', name: 'OpenCode' }, [{ name: 'OPENCODE', expected: '1' }]),
+    markerDetector({ id: 'qwen-code', name: 'Qwen Code' }, [{ name: 'QWEN_CODE_SESSION_ID' }], ['QWEN_CODE_SESSION_ID']),
+    markerDetector({ id: 'pi', name: 'Pi' }, [
+        { name: 'PI_CODING_AGENT', expected: 'true' },
+        { name: 'AI_AGENT', expected: 'pi' },
+    ], ['PI_SESSION_ID']),
+    markerDetector({ id: 'cursor-agent', name: 'Cursor Agent' }, [{ name: 'CURSOR_AGENT', expected: '1' }], ['CURSOR_CONVERSATION_ID']),
+    markerDetector({ id: 'claude-code', name: 'Claude Code' }, [{ name: 'CLAUDECODE', expected: '1' }], ['CLAUDE_CODE_SESSION_ID']),
+    markerDetector({ id: 'codex', name: 'OpenAI Codex' }, [{ name: 'CODEX_THREAD_ID' }], ['CODEX_THREAD_ID']),
+    markerDetector({ id: 'amp', name: 'Amp' }, [{ name: 'AMP_CURRENT_THREAD_ID' }], ['AMP_CURRENT_THREAD_ID']),
+    markerDetector({ id: 'gemini-cli', name: 'Gemini CLI' }, [{ name: 'GEMINI_CLI', expected: '1' }]),
+    markerDetector({ id: 'auggie', name: 'Auggie' }, [{ name: 'AUGMENT_AGENT', expected: '1' }]),
+    markerDetector({ id: 'crush', name: 'Crush' }, [
+        { name: 'CRUSH', expected: '1' },
+        { name: 'AI_AGENT', expected: 'crush' },
+    ]),
+    markerDetector({ id: 'vscode-copilot-agent', name: 'GitHub Copilot in VS Code' }, [
+        { name: 'AI_AGENT', expected: 'github_copilot_vscode_agent' },
+        { name: 'COPILOT_AGENT', expected: '1' },
+    ]),
+    markerDetector({ id: 'warp', name: 'Warp' }, [{ name: 'OZ_RUN_ID' }], ['OZ_RUN_ID']),
+];
+const NOT_AGENTIC = { isAgentic: false, harness: null, sessionId: null, matches: [] };
+/** Normalizes a user-supplied agent name into an id (lowercase, dash-separated). */
+function toAgentId(name) {
+    return (name
+        .toLowerCase()
+        .replaceAll(/[^a-z0-9]+/g, '-')
+        .replaceAll(/^-|-$/g, '') || 'custom');
+}
+/**
+ * Detects whether the current process is being driven by an AI coding agent.
+ *
+ * @param env - Environment to inspect (defaults to `process.env`)
+ * @param detectors - Detectors in precedence order (defaults to {@link agentDetectors})
+ */
+export function detectAgentContext(env = process.env, detectors = agentDetectors) {
+    const override = env.SFCC_AGENT;
+    if (override !== undefined) {
+        const forced = value(env, 'SFCC_AGENT');
+        if (!forced)
+            return NOT_AGENTIC;
+        // Values like "1"/"true" force agent mode without naming a harness.
+        const generic = ['1', 'true', 'yes', 'on'].includes(forced.toLowerCase());
+        const harness = generic ? { id: 'unknown', name: 'Unknown agent' } : { id: toAgentId(forced), name: forced };
+        const match = { harness, signals: ['SFCC_AGENT'] };
+        return { isAgentic: true, harness, sessionId: null, matches: [match] };
+    }
+    const matches = [];
+    for (const detector of detectors) {
+        try {
+            const match = detector(env);
+            if (match)
+                matches.push(match);
+        }
+        catch {
+            // Detection is advisory and must never prevent a command from running.
+        }
+    }
+    return {
+        isAgentic: matches.length > 0,
+        harness: matches[0]?.harness ?? null,
+        sessionId: matches.find((m) => m.sessionId)?.sessionId ?? null,
+        matches,
+    };
+}
+let cached;
+/**
+ * Cached {@link detectAgentContext} for `process.env`. The environment of a
+ * process does not change in ways relevant to detection, so detect once.
+ */
+export function getAgentContext() {
+    cached ??= detectAgentContext();
+    return cached;
+}
+/** Clears the cached agent context (for tests). */
+export function resetAgentContext() {
+    cached = undefined;
+}
+/**
+ * Whether interactive prompts can be shown: stdin is a TTY and the process is
+ * not driven by an AI agent (agents typically cannot answer prompts, and
+ * hanging on one wastes the agent's turn).
+ */
+export function isInteractive() {
+    return Boolean(process.stdin.isTTY) && !getAgentContext().isAgentic;
+}
+//# sourceMappingURL=agent-context.js.map

package/dist/esm/ux/agent-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.js","sourceRoot":"","sources":["../../../src/ux/agent-context.ts"],"names":[],"mappings":"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"}

package/dist/esm/ux/confirm.d.ts

@@ -1,14 +1,41 @@
 export interface ConfirmOptions {
     /** Default to yes when the user presses Enter without typing. Defaults to false (no). */
     defaultYes?: boolean;
+    /**
+     * Behavior when prompting is not possible (no TTY on stdin, or an AI agent
+     * is driving the process):
+     *
+     * - `'error'` (default): throw {@link ConfirmationRequiredError} so the
+     *   command fails fast with a non-zero exit instead of hanging
+     * - `'default'`: resolve to the default answer (`defaultYes`) without prompting
+     */
+    nonInteractive?: 'default' | 'error';
+}
+/**
+ * Thrown by {@link confirm} when a confirmation is required but cannot be
+ * prompted for. Callers should skip the prompt with an explicit flag
+ * (typically `--force` or `--yes`).
+ */
+export declare class ConfirmationRequiredError extends Error {
+    /** The confirmation message that could not be prompted. */
+    readonly prompt: string;
+    readonly code = "CONFIRMATION_REQUIRED";
+    constructor(
+    /** The confirmation message that could not be prompted. */
+    prompt: string);
 }
 /**
  * Simple yes/no confirmation prompt.
  *
  * Output goes to stderr so it doesn't interfere with structured stdout output.
  *
+ * When prompting is not possible (stdin is not a TTY, or an AI agent is
+ * detected), this throws {@link ConfirmationRequiredError} by default rather
+ * than waiting on input that will never arrive. See {@link ConfirmOptions.nonInteractive}.
+ *
  * @param message - Prompt message (the hint is appended automatically)
  * @param options - Options to control default behavior
  * @returns true if user confirmed, false otherwise
+ * @throws ConfirmationRequiredError when prompting is not possible and `nonInteractive` is `'error'`
  */
 export declare function confirm(message: string, options?: ConfirmOptions): Promise<boolean>;

package/dist/esm/ux/confirm.js

@@ -4,17 +4,49 @@
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
 import * as readline from 'node:readline';
+import { getAgentContext, isInteractive } from './agent-context.js';
+/**
+ * Thrown by {@link confirm} when a confirmation is required but cannot be
+ * prompted for. Callers should skip the prompt with an explicit flag
+ * (typically `--force` or `--yes`).
+ */
+export class ConfirmationRequiredError extends Error {
+    prompt;
+    code = 'CONFIRMATION_REQUIRED';
+    constructor(
+    /** The confirmation message that could not be prompted. */
+    prompt) {
+        const agent = getAgentContext().harness;
+        const reason = agent
+            ? `running under an AI agent (${agent.name}), so interactive prompts are disabled`
+            : 'no interactive terminal is available';
+        super(`Confirmation required but ${reason}:\n  ${prompt.trim()}\n` +
+            `Re-run with the command's --force (or --yes) flag to proceed without prompting.`);
+        this.prompt = prompt;
+        this.name = 'ConfirmationRequiredError';
+    }
+}
 /**
  * Simple yes/no confirmation prompt.
  *
  * Output goes to stderr so it doesn't interfere with structured stdout output.
  *
+ * When prompting is not possible (stdin is not a TTY, or an AI agent is
+ * detected), this throws {@link ConfirmationRequiredError} by default rather
+ * than waiting on input that will never arrive. See {@link ConfirmOptions.nonInteractive}.
+ *
  * @param message - Prompt message (the hint is appended automatically)
  * @param options - Options to control default behavior
  * @returns true if user confirmed, false otherwise
+ * @throws ConfirmationRequiredError when prompting is not possible and `nonInteractive` is `'error'`
  */
 export async function confirm(message, options) {
     const defaultYes = options?.defaultYes ?? false;
+    if (!isInteractive()) {
+        if (options?.nonInteractive === 'default')
+            return defaultYes;
+        throw new ConfirmationRequiredError(message);
+    }
     const hint = defaultYes ? '(Y/n)' : '(y/N)';
     const rl = readline.createInterface({
         input: process.stdin,

package/dist/esm/ux/confirm.js.map

@@ -1 +1 @@
-{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../../src/ux/confirm.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAO1C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,OAAwB;IACrE,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC;IAChD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAE5C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,GAAG,OAAO,IAAI,IAAI,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE;YAC5C,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC/C,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;gBACtB,OAAO,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../../src/ux/confirm.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,eAAe,EAAE,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAgBlE;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAKvC;IAJF,IAAI,GAAG,uBAAuB,CAAC;IAExC;IACE,2DAA2D;IAClD,MAAc;QAEvB,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC,OAAO,CAAC;QACxC,MAAM,MAAM,GAAG,KAAK;YAClB,CAAC,CAAC,8BAA8B,KAAK,CAAC,IAAI,wCAAwC;YAClF,CAAC,CAAC,sCAAsC,CAAC;QAC3C,KAAK,CACH,6BAA6B,MAAM,QAAQ,MAAM,CAAC,IAAI,EAAE,IAAI;YAC1D,iFAAiF,CACpF,CAAC;QATO,WAAM,GAAN,MAAM,CAAQ;QAUvB,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,OAAwB;IACrE,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC;IAEhD,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,IAAI,OAAO,EAAE,cAAc,KAAK,SAAS;YAAE,OAAO,UAAU,CAAC;QAC7D,MAAM,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAE5C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,GAAG,OAAO,IAAI,IAAI,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE;YAC5C,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC/C,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;gBACtB,OAAO,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/ux/index.d.ts

@@ -1 +1,2 @@
-export { confirm, type ConfirmOptions } from './confirm.js';
+export { confirm, ConfirmationRequiredError, type ConfirmOptions } from './confirm.js';
+export { agentDetectors, detectAgentContext, getAgentContext, isInteractive, resetAgentContext, type AgentContext, type AgentDetector, type AgentEnvironment, type AgentHarness, type AgentMatch, } from './agent-context.js';

package/dist/esm/ux/index.js

@@ -3,5 +3,6 @@
  * SPDX-License-Identifier: Apache-2
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
-export { confirm } from './confirm.js';
+export { confirm, ConfirmationRequiredError } from './confirm.js';
+export { agentDetectors, detectAgentContext, getAgentContext, isInteractive, resetAgentContext, } from './agent-context.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/ux/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ux/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,OAAO,EAAsB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ux/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,OAAO,EAAE,yBAAyB,EAAsB,MAAM,cAAc,CAAC;AACrF,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,iBAAiB,GAMlB,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/b2c-tooling-sdk",
   "description": "Core tooling library for Salesforce B2C Commerce CLI",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "author": "Charles Lavery",
   "license": "Apache-2.0",
   "repository": "SalesforceCommerceCloud/b2c-developer-tooling",
@@ -28,6 +28,7 @@
       "default": "./dist/esm/scapi/index.js"
     },
     "./package.json": "./package.json",
+    "./schemas/dw.schema.json": "./data/schemas/dw.schema.json",
     ".": {
       "types": "./dist/esm/index.d.ts",
       "default": "./dist/esm/index.js"
@@ -298,6 +299,8 @@
     "check:guides-links": "tsx scripts/check-guides-links.ts",
     "generate:tooling-index": "tsx scripts/generate-tooling-index.ts",
     "check:tooling-index": "tsx scripts/generate-tooling-index.ts --check",
+    "generate:dw-json-schema": "tsx scripts/generate-dw-json-schema.ts",
+    "check:dw-json-schema": "tsx scripts/generate-dw-json-schema.ts --check",
     "generate:help-corpus": "tsx scripts/generate-help-corpus.ts",
     "enrich:docs": "tsx scripts/enrich-docs.ts"
   }