@salesforce/plugin-agent 1.38.1 → 1.39.1

package/lib/commands/agent/preview/end.js

@@ -13,12 +13,20 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Flags, SfCommand, toHelpSection } from '@salesforce/sf-plugins-core';
-import { Messages, SfError, Lifecycle, EnvironmentVariable } from '@salesforce/core';
+import { Flags, SfCommand, toHelpSection, prompts } from '@salesforce/sf-plugins-core';
+import { Messages, SfError, EnvironmentVariable } from '@salesforce/core';
 import { Agent, ProductionAgent, ScriptAgent } from '@salesforce/agents';
-import { getCachedSessionIds, removeCache, validatePreviewSession } from '../../../previewSessionStore.js';
+import { getCachedSessionIds, listCachedSessions, removeCache, validatePreviewSession, } from '../../../previewSessionStore.js';
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-agent', 'agent.preview.end');
+async function callPreviewEnd(agent) {
+    if (agent instanceof ScriptAgent) {
+        await agent.preview.end();
+    }
+    else if (agent instanceof ProductionAgent) {
+        await agent.preview.end('UserRequest');
+    }
+}
 export default class AgentPreviewEnd extends SfCommand {
     static summary = messages.getMessage('summary');
     static description = messages.getMessage('description');
@@ -27,8 +35,10 @@ export default class AgentPreviewEnd extends SfCommand {
     static envVariablesSection = toHelpSection('ENVIRONMENT VARIABLES', EnvironmentVariable.SF_TARGET_ORG);
     static errorCodes = toHelpSection('ERROR CODES', {
         'Succeeded (0)': 'Preview session ended successfully and traces saved.',
+        'ExactlyOneRequired (2)': 'Neither --api-name nor --authoring-bundle was provided (required when --all is not set).',
         'NotFound (2)': 'Agent not found, or no preview session exists for this agent.',
         'PreviewEndFailed (4)': 'Failed to end the preview session.',
+        'PreviewEndPartialFailure (68)': 'With --all, one or more sessions failed to end while others succeeded.',
         'SessionAmbiguous (5)': 'Multiple preview sessions found; specify --session-id to choose one.',
     });
     static flags = {
@@ -37,77 +47,230 @@ export default class AgentPreviewEnd extends SfCommand {
         'session-id': Flags.string({
             summary: messages.getMessage('flags.session-id.summary'),
             required: false,
+            exclusive: ['all'],
         }),
         'api-name': Flags.string({
             summary: messages.getMessage('flags.api-name.summary'),
             char: 'n',
-            exactlyOne: ['api-name', 'authoring-bundle'],
+            exclusive: ['authoring-bundle'],
         }),
         'authoring-bundle': Flags.string({
             summary: messages.getMessage('flags.authoring-bundle.summary'),
-            exactlyOne: ['api-name', 'authoring-bundle'],
+            exclusive: ['api-name'],
+        }),
+        all: Flags.boolean({
+            summary: messages.getMessage('flags.all.summary'),
+            exclusive: ['session-id'],
+        }),
+        'no-prompt': Flags.boolean({
+            summary: messages.getMessage('flags.no-prompt.summary'),
+            char: 'p',
         }),
     };
     async run() {
         const { flags } = await this.parse(AgentPreviewEnd);
         const conn = flags['target-org'].getConnection(flags['api-version']);
-        const agentIdentifier = flags['authoring-bundle'] ?? flags['api-name'];
-        // Initialize agent with error tracking
-        let agent;
-        try {
-            agent = flags['authoring-bundle']
-                ? await Agent.init({ connection: conn, project: this.project, aabName: flags['authoring-bundle'] })
-                : await Agent.init({ connection: conn, project: this.project, apiNameOrId: flags['api-name'] });
+        if (flags['all']) {
+            return this.endAll(flags, conn);
         }
-        catch (error) {
-            const wrapped = SfError.wrap(error);
-            await Lifecycle.getInstance().emitTelemetry({ eventName: 'agent_preview_end_agent_not_found' });
-            throw new SfError(messages.getMessage('error.agentNotFound', [agentIdentifier]), 'AgentNotFound', [], 2, wrapped);
+        // Without --all, exactly one of --api-name or --authoring-bundle is required.
+        if (!flags['api-name'] && !flags['authoring-bundle']) {
+            throw new SfError(messages.getMessage('error.exactlyOneRequired'), 'ExactlyOneRequired', [], 2);
         }
-        // Get or validate session ID
+        const agent = await this.initAgent(flags, conn);
         let sessionId = flags['session-id'];
         if (sessionId === undefined) {
             const cached = await getCachedSessionIds(this.project, agent);
             if (cached.length === 0) {
-                await Lifecycle.getInstance().emitTelemetry({ eventName: 'agent_preview_end_no_session' });
                 throw new SfError(messages.getMessage('error.noSession'), 'PreviewSessionNotFound', [], 2);
             }
             if (cached.length > 1) {
-                await Lifecycle.getInstance().emitTelemetry({ eventName: 'agent_preview_end_multiple_sessions' });
                 throw new SfError(messages.getMessage('error.multipleSessions', [cached.join(', ')]), 'PreviewSessionAmbiguous', [], 5);
             }
             sessionId = cached[0];
         }
         agent.setSessionId(sessionId);
-        // Validate session
         try {
             await validatePreviewSession(agent);
         }
         catch (error) {
             const wrapped = SfError.wrap(error);
-            await Lifecycle.getInstance().emitTelemetry({ eventName: 'agent_preview_end_session_invalid' });
             throw new SfError(messages.getMessage('error.sessionInvalid', [sessionId]), 'PreviewSessionInvalid', [], 2, wrapped);
         }
         const tracesPath = await agent.getHistoryDir();
-        await removeCache(agent);
-        // End preview with error tracking
         try {
-            if (agent instanceof ScriptAgent) {
-                await agent.preview.end();
-            }
-            else if (agent instanceof ProductionAgent) {
-                await agent.preview.end('UserRequest');
-            }
+            await callPreviewEnd(agent);
         }
         catch (error) {
             const wrapped = SfError.wrap(error);
-            await Lifecycle.getInstance().emitTelemetry({ eventName: 'agent_preview_end_failed' });
             throw new SfError(messages.getMessage('error.endFailed', [wrapped.message]), 'PreviewEndFailed', [wrapped.message], 4, wrapped);
         }
-        await Lifecycle.getInstance().emitTelemetry({ eventName: 'agent_preview_end_success' });
+        // ProductionAgent.endSession() clears this.sessionId after the server call; re-set it so
+        // removeCache can call getHistoryDir() without throwing "No sessionId set on agent".
+        agent.setSessionId(sessionId);
+        await removeCache(agent);
         const result = { sessionId, tracesPath };
         this.log(messages.getMessage('output.tracesPath', [tracesPath]));
         return result;
     }
+    async initAgent(flags, conn) {
+        const agentIdentifier = flags['authoring-bundle'] ?? flags['api-name'];
+        try {
+            return flags['authoring-bundle']
+                ? await Agent.init({
+                    connection: conn,
+                    project: this.project,
+                    aabName: flags['authoring-bundle'],
+                })
+                : await Agent.init({ connection: conn, project: this.project, apiNameOrId: flags['api-name'] });
+        }
+        catch (error) {
+            const wrapped = SfError.wrap(error);
+            throw new SfError(messages.getMessage('error.agentNotFound', [agentIdentifier]), 'AgentNotFound', [], 2, wrapped);
+        }
+    }
+    async endAll(flags, conn) {
+        const hasAgentIdentifier = flags['api-name'] !== undefined || flags['authoring-bundle'] !== undefined;
+        if (hasAgentIdentifier) {
+            return this.endAllForAgent(flags, conn);
+        }
+        return this.endAllAgents(conn, flags['no-prompt'] ?? false);
+    }
+    /**
+     * Path 1: --all + --api-name or --authoring-bundle
+     * Ends all sessions for a single specified agent. This is the original behaviour.
+     */
+    async endAllForAgent(flags, conn) {
+        const agent = await this.initAgent(flags, conn);
+        const agentLabel = flags['api-name'] ?? flags['authoring-bundle'];
+        const sessionIds = await getCachedSessionIds(this.project, agent);
+        const sessionsToEnd = sessionIds.map((sessionId) => ({ sessionId }));
+        if (sessionsToEnd.length === 0) {
+            this.log(messages.getMessage('output.noSessionsFound'));
+            return { ended: [] };
+        }
+        if (!flags['no-prompt']) {
+            const confirmed = await prompts.confirm({
+                message: messages.getMessage('prompt.confirmAll', [sessionsToEnd.length, agentLabel]),
+            });
+            if (!confirmed) {
+                return { ended: [] };
+            }
+        }
+        const { ended, failed } = await endSessionsForAgent(agent, sessionsToEnd);
+        return this.finishEndAll(ended, failed);
+    }
+    /**
+     * Path 2: --all alone (no agent identifier).
+     * Reads all agents from the local cache via listCachedSessions and ends every session.
+     * sessionType 'published' → ProductionAgent (server-side DELETE). 'simulated'/'live' → ScriptAgent (local only).
+     * session-meta.json is always present for entries returned by listCachedSessions, so sessionType is always defined.
+     */
+    async endAllAgents(conn, noPrompt) {
+        const entries = await listCachedSessions(this.project);
+        const totalSessions = entries.reduce((sum, e) => sum + e.sessions.length, 0);
+        if (totalSessions === 0) {
+            this.log(messages.getMessage('output.noSessionsFound'));
+            return { ended: [] };
+        }
+        if (!noPrompt) {
+            const agentBreakdown = entries
+                .map((e) => {
+                const label = e.displayName ?? e.agentId;
+                const type = e.sessions[0]?.sessionType === 'published' ? 'bot' : 'bundle'; // 'bot'/'bundle' labels confirmed by PM — intentional deviation from raw sessionType value
+                return `  - ${label} (${type}): ${e.sessions.length} session(s)`;
+            })
+                .join('\n');
+            const confirmed = await prompts.confirm({
+                message: `${messages.getMessage('prompt.confirmAllAgents', [
+                    totalSessions,
+                    entries.length,
+                ])}\n${agentBreakdown}`,
+            });
+            if (!confirmed) {
+                return { ended: [] };
+            }
+        }
+        const ended = [];
+        const failed = [];
+        for (const entry of entries) {
+            const { agentId, sessions } = entry;
+            let agent;
+            try {
+                const isProduction = sessions[0]?.sessionType === 'published';
+                if (isProduction) {
+                    // eslint-disable-next-line no-await-in-loop
+                    agent = await Agent.init({ connection: conn, project: this.project, apiNameOrId: agentId });
+                }
+                else {
+                    // eslint-disable-next-line no-await-in-loop
+                    agent = await Agent.init({ connection: conn, project: this.project, aabName: agentId });
+                }
+            }
+            catch (error) {
+                // If we can't init the agent, mark all its sessions as failed.
+                const errMsg = SfError.wrap(error).message;
+                for (const s of sessions) {
+                    failed.push({ task: { sessionId: s.sessionId }, error: errMsg });
+                }
+                continue;
+            }
+            // eslint-disable-next-line no-await-in-loop
+            const { ended: agentEnded, failed: agentFailed } = await endSessionsForAgent(agent, sessions.map((s) => ({ sessionId: s.sessionId })));
+            ended.push(...agentEnded);
+            failed.push(...agentFailed);
+        }
+        return this.finishEndAll(ended, failed);
+    }
+    /**
+     * Called by endAllForAgent (single specified agent) and endAllAgents (all agents from cache)
+     * once ended/failed arrays have been fully aggregated.
+     * Throws a partial-failure error if needed; logs success otherwise.
+     */
+    finishEndAll(ended, failed) {
+        if (failed.length > 0) {
+            const failedList = failed.map((f) => `${f.task.sessionId}: ${f.error}`).join(', ');
+            const endedIds = ended.map((e) => e.sessionId).join(', ');
+            const msg = `Failed to end ${failed.length} session(s): [${failedList}]. Successfully ended ${ended.length} session(s)${ended.length > 0 ? `: [${endedIds}]` : ''}.`;
+            throw new SfError(msg, 'PreviewEndPartialFailure', [], 68);
+        }
+        this.log(messages.getMessage('output.endedAll', [ended.length]));
+        return { ended };
+    }
+}
+/**
+ * Ends a list of sessions on the given agent object serially.
+ * Returns { ended, failed } so callers can aggregate results.
+ * Does NOT throw on partial failure — callers decide what to do.
+ * On failure, the local cache entry is NOT removed (consistent with single-session path behaviour).
+ */
+async function endSessionsForAgent(agent, sessionsToEnd) {
+    const ended = [];
+    const failed = [];
+    // Sessions are ended serially because setSessionId mutates shared state on the agent object.
+    // Parallelising would introduce a race condition where concurrent calls overwrite each other's sessionId.
+    for (const task of sessionsToEnd) {
+        const { sessionId } = task;
+        try {
+            agent.setSessionId(sessionId);
+            // eslint-disable-next-line no-await-in-loop
+            await validatePreviewSession(agent);
+            // eslint-disable-next-line no-await-in-loop
+            const tracesPath = await agent.getHistoryDir();
+            // ScriptAgent flushes traces to disk; ProductionAgent issues the server-side end request.
+            // eslint-disable-next-line no-await-in-loop
+            await callPreviewEnd(agent);
+            // ProductionAgent.endSession() clears this.sessionId after the server call; re-set it so
+            // removeCache can call getHistoryDir() without throwing "No sessionId set on agent".
+            agent.setSessionId(sessionId);
+            // eslint-disable-next-line no-await-in-loop
+            await removeCache(agent);
+            ended.push({ sessionId, tracesPath });
+        }
+        catch (error) {
+            failed.push({ task, error: SfError.wrap(error).message });
+        }
+    }
+    return { ended, failed };
 }
 //# sourceMappingURL=end.js.map

package/lib/commands/agent/preview/end.js.map

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

package/messages/agent.preview.end.md

@@ -6,7 +6,9 @@ End an existing programmatic agent preview session and get trace location.
 
 You must have previously started a programmatic agent preview session with the "agent preview start" command to then use this command to end it. This command also displays the local directory where the session trace files are stored.
 
-The original "agent preview start" command outputs a session ID which you then use with the --session-id flag of this command to end the session. You don't have to specify the --session-id flag if an agent has only one active preview session. You must also use either the --authoring-bundle or --api-name flag to specify the API name of the authoring bundle or the published agent, respecitvely. To find either API name, navigate to your package directory in your DX project. The API name of an authoring bundle is the same as its directory name under the "aiAuthoringBundles" metadata directory. Similarly, the published agent's API name is the same as its directory name under the "Bots" metadata directory.
+The original "agent preview start" command outputs a session ID which you then use with the --session-id flag of this command to end the session. You don't have to specify the --session-id flag if an agent has only one active preview session. You must also use either the --authoring-bundle or --api-name flag to specify the API name of the authoring bundle or the published agent, respectively. To find either API name, navigate to your package directory in your DX project. The API name of an authoring bundle is the same as its directory name under the "aiAuthoringBundles" metadata directory. Similarly, the published agent's API name is the same as its directory name under the "Bots" metadata directory.
+
+Use the --all flag to end all active preview sessions at once. You can combine --all with --api-name or --authoring-bundle to end only sessions for a specific agent, or use --all on its own to end every session across all agents in the project.
 
 # flags.session-id.summary
 
@@ -20,6 +22,18 @@ API name of the activated published agent you want to preview.
 
 API name of the authoring bundle metadata component that contains the agent's Agent Script file.
 
+# flags.all.summary
+
+End all active preview sessions. Combine with --api-name or --authoring-bundle to limit to a specific agent, or use with only --target-org to end sessions for all agents found in the local session cache. Requires --target-org.
+
+# flags.no-prompt.summary
+
+Don't prompt for confirmation before ending sessions. Has an effect only when used with --all.
+
+# error.exactlyOneRequired
+
+Exactly one of the following must be provided: --api-name, --authoring-bundle
+
 # error.noSession
 
 No agent preview session found. Run "sf agent preview start" to start a new agent preview session.
@@ -44,9 +58,25 @@ Failed to end preview session: %s
 
 Session traces: %s
 
+# output.noSessionsFound
+
+No active preview sessions found.
+
+# output.endedAll
+
+Ended %s preview session(s).
+
+# prompt.confirmAll
+
+About to end %s preview session(s) for agent '%s'. Continue?
+
+# prompt.confirmAllAgents
+
+About to end %s preview session(s) across %s agent(s). Continue?
+
 # examples
 
-- End a preview session of a published agent by specifying its session ID and API name ; use the default org:
+- End a preview session of a published agent by specifying its session ID and API name; use the default org:
 
   <%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --api-name My_Published_Agent
 
@@ -57,3 +87,11 @@ Session traces: %s
 - End a preview session of an agent using its authoring bundle API name; you get an error if the agent has more than one active session.
 
   <%= config.bin %> <%= command.id %> --authoring-bundle My_Local_Agent
+
+- End all active preview sessions for a specific agent without prompting:
+
+  <%= config.bin %> <%= command.id %> --all --authoring-bundle My_Local_Agent --target-org <target_org> --no-prompt
+
+- End all active preview sessions across every agent in the local session cache for an org:
+
+  <%= config.bin %> <%= command.id %> --all --target-org <target_org>

package/messages/agent.trace.delete.md

@@ -1,24 +1,26 @@
 # summary
 
-Delete agent preview trace files.
+Delete trace files from an agent preview session.
 
 # description
 
-Deletes trace files recorded during agent preview sessions. By default, shows a preview of what will be deleted and prompts for confirmation. Use --no-prompt to skip confirmation.
+When you run an agent preview conversation (either interactive or programmatic), trace files are automatically recorded and saved in your local DX project. Use this command to delete some or all of the trace files.
 
-Without filters, deletes all traces for all agents and sessions. Use flags to narrow the scope: filter by agent name (--agent), by session (--session-id), or by age (--older-than).
+By default, this command shows a preview of what will be deleted and prompts for confirmation. Use --no-prompt to skip confirmation.
+
+Without filters, this comamnd deletes all trace files for all agents and sessions. Use flags to narrow the scope: filter by agent API name (--agent), by session (--session-id), or by age (--older-than).
 
 # flags.agent.summary
 
-Only delete traces for this agent name (substring match). Matches against the name used when starting the session, whether that's an authoring bundle or a published agent API name.
+API name of the agent used to filter the list of trace files you want to delete. Matches against the API name used when starting the session, either an authoring bundle or a published agent API name.
 
 # flags.session-id.summary
 
-Only delete traces from this session ID.
+Session ID used to filter the list of trace files you want to delete. Use the "agent preview sessions" CLI command to list all known agent preview sessions along with their session IDs.
 
 # flags.older-than.summary
 
-Only delete traces older than this duration. Accepts a number followed by a unit: m/minutes, h/hours, d/days, w/weeks (e.g. 7d, 24h, 2w).
+Duration used to filter the list of trace files; only files older than the duration are deleted. Accepts a number followed by a unit: m/minutes, h/hours, d/days, w/weeks. Examples: 7d, 24h, 2w.
 
 # flags.no-prompt.summary
 
@@ -26,11 +28,11 @@ Skip the confirmation prompt and delete immediately.
 
 # error.invalidOlderThan
 
-Invalid --older-than value: '%s'. Use a number followed by a unit: m/minutes, h/hours, d/days, w/weeks (e.g. 7d, 24h, 30m, 2w).
+Invalid --older-than value: '%s'. Use a number followed by a unit: m/minutes, h/hours, d/days, w/weeks, Examples: 7d, 24h, 30m, 2w.
 
 # prompt.confirm
 
-Delete %s trace file(s)? This cannot be undone.
+Delete %s trace file(s)? This can't be undone.
 
 # output.noneFound
 
@@ -62,7 +64,7 @@ Plan ID
 
 # examples
 
-- Delete all traces for all agents and sessions (with confirmation prompt):
+- Delete all traces for all agents and sessions; prompt for confirmation:
 
   <%= config.bin %> <%= command.id %>
 
@@ -78,10 +80,10 @@ Plan ID
 
   <%= config.bin %> <%= command.id %> --older-than 7d
 
-- Delete traces older than 24 hours for a specific agent, no prompt:
+- Delete traces older than 24 hours for a specific agent; don't prompt for confirmation:
 
   <%= config.bin %> <%= command.id %> --agent My_Agent --older-than 24h --no-prompt
 
-- Delete all traces without confirmation:
+- Delete all traces for all agents and sessions; don't prompt for confirmation:
 
   <%= config.bin %> <%= command.id %> --no-prompt

package/messages/agent.trace.list.md

@@ -1,20 +1,20 @@
 # summary
 
-List the trace files that were recorded during all agent preview sessions.
+List the available trace files that were recorded during all agent preview sessions.
 
 # description
 
-Lists trace files recorded during agent preview sessions. By default, lists all traces for all agents and all of their sessions. Use flags to narrow results: filter by agent name (--agent), by session (--session-id), or by date (--since).
+When you run an agent preview conversation (either interactive or programmatic), trace files are automatically recorded and saved in your local DX project. By default, this command lists all trace files for all agents and all of their sessions. Use flags to narrow results: filter by agent name (--agent), by session (--session-id), or by date (--since).
 
 Each row in the output corresponds to one trace file, which in turn corresponds to one agent session. The Agent column shows the authoring bundle or API name used when starting the session.
 
 # flags.agent.summary
 
-Only show traces for this agent name (substring match). Matches against the name used when starting the session, whether that's an authoring bundle or a published agent API name.
+API name of the agent used to filter the list of available trace files. Matches against the API name used when starting the session, either an authoring bundle or a published agent API name.
 
 # flags.session-id.summary
 
-Session ID used to filter the list of trace files.
+Session ID used to filter the list of trace files. Use the "agent preview sessions" CLI command to list all known agent preview sessions along with their session IDs.
 
 # flags.since.summary
 
@@ -58,23 +58,23 @@ Path
 
 # examples
 
-- List all traces for all agents and sessions:
+- List all trace files for all agents and sessions:
 
   <%= config.bin %> <%= command.id %>
 
-- List all traces for a specific agent:
+- List all trace files for a specific agent:
 
   <%= config.bin %> <%= command.id %> --agent My_Agent
 
-- List traces for a specific session:
+- List trace files for a specific session:
 
   <%= config.bin %> <%= command.id %> --session-id <SESSION_ID>
 
-- List traces recorded on or after April 20, 2026 (date-only, interpreted as UTC midnight):
+- List trace files recorded on or after April 20, 2026 (date-only, interpreted as UTC midnight):
 
   <%= config.bin %> <%= command.id %> --since 2026-04-20
 
-- List traces recorded on or after a specific UTC time:
+- List trace files recorded on or after a specific UTC time:
 
   <%= config.bin %> <%= command.id %> --since 2026-04-20T14:00:00Z
 

package/messages/agent.trace.read.md

@@ -1,64 +1,67 @@
 # summary
 
-Read and analyze trace files from an agent preview session.
+Read trace files from an agent preview session.
 
 # description
 
-Reads trace files recorded during an agent preview session and outputs them in one of three formats.
+When you run an agent preview conversation (either interactive or programmatic), trace files are automatically recorded and saved in your local DX project. Each turn (utterance or response) of a conversation creates trace data. Use this command to view trace data for a specific preview session, so you can then analyze the trace data to observe, monitor, investigate, and troubleshoot agent events and behavior.
 
-**--format summary** (default): A per-turn narrative showing topic routing, actions executed, and the agent's response. Use this to quickly understand what happened in a session.
+Use the --format flag to specify one of these formats of the outputted trace data:
 
-**--format detail**: Diagnostic drill-down into a specific dimension (--dimension required). Filters output to only the trace steps relevant to that dimension, minimizing noise.
+- summary (Default): A per-turn narrative showing topic routing, actions executed, and the agent's response. Use this to quickly understand what happened in a preview session.
+- detail: Diagnostic drill-down into a specific dimension. Filters output to only the trace steps relevant to that dimension, minimizing noise.
+- raw: Unprocessed trace JSON. Use this as a fallback when the trace schema has changed or you need to perform custom analysis.
 
-**--format raw**: Unprocessed trace JSON. Use this as a fallback when the trace schema has changed or you need to perform custom analysis.
+If you specify "--format detail", you must also specify a dimension with the --dimension flag. Dimensions are a way to slice and analyze the agent execution trace from a specific angle or concern. Instead of looking at the raw sequence of everything that happened, each dimension filters and organizes the trace data to answer a specific type of question. These are the available dimensions and the information they provide:
 
-Available dimensions for --format detail: actions, grounding, routing, errors.
-
-Use --turn N to scope output to a single conversation turn.
+- actions: The actions the agent executed. Includes action name, input parameters, output, and latency. Use this dimension to understand what the agent actually did when answering an utterance in the preview session.
+- grounding: The reasoning steps used by the LLM. Use this dimension to see how the agent "thought" about the problem - the AI reasoning that determined which actions to take.
+- routing: How the agent navigated between subagents. Use this dimension to understand conversation flow - when and why the agent switched between different subagents or contexts during the conversation.
+- errors: Aggregates all errors during the session. Use this dimension to quickly identify and debug issues across all steps.
 
 # flags.session-id.summary
 
-Session ID to read traces for.
+Session ID to read traces for. Use the "agent preview sessions" CLI command to list all known agent preview sessions along with their session IDs
 
 # flags.format.summary
 
-Output format: summary (default), detail, or raw. Use detail with --dimension to drill into a specific aspect of the trace.
+Output format of the trace data; specifies the level of detail you want in the trace files.
 
 # flags.dimension.summary
 
-Dimension to drill into when using --format detail. One of: actions, grounding, routing, errors. Required when --format is detail.
+Dimension to drill into when using "--format detail"; used to filter and organize the trace data to answer a specific type of question.
 
 # flags.turn.summary
 
-Scope output to this conversation turn number.
+Turn number for which you want trace data. A turn is a single utterance or response in a conversation, starting with 1.
 
 # error.detailRequiresDimension
 
---format detail requires --dimension. Specify one of: actions, grounding, routing, errors.
+The "--format detail" flag requires --dimension. Specify one of: actions, grounding, routing, errors.
 
 # error.sessionNotFound
 
-Session '%s' was not found in the local session cache. Run "sf agent trace list" to see available sessions.
+Session '%s' wasn't found in the local session cache. Run "sf agent trace list" to see available sessions.
 
 # error.turnIndexNotFound
 
-No turn index found for session '%s'. Cannot filter by --turn without a turn index.
+No turn index found for session '%s'. Can't filter by --turn without a turn index.
 
 # error.turnNotFound
 
-Turn %s was not found in session '%s'.
+Turn %s wasn't found in session '%s'.
 
 # error.parseFailedAll
 
-Trace parsing failed for all files: %s. The trace schema may have changed. Try --format raw to access unprocessed trace data.
+Trace parsing failed for all files: %s. The trace schema may have changed. Try "--format raw" to access unprocessed trace data.
 
 # warn.dimensionIgnored
 
---dimension is ignored when --format is '%s'. Use --format detail to drill into a dimension.
+The --dimension flag is ignored when --format is '%s'. Use "--format detail" to drill into a dimension.
 
 # warn.parseFailed
 
-Trace parsing failed for some files (skipped): %s. Try --format raw to access unprocessed trace data.
+Trace parsing failed for some files (skipped): %s. Try "--format raw" to access unprocessed trace data.
 
 # output.empty
 
@@ -142,11 +145,11 @@ Message
 
 # examples
 
-- Show a session summary (all turns):
+- Show a session trace summary for all turns in the session with the specified ID:
 
   <%= config.bin %> <%= command.id %> --session-id <SESSION_ID>
 
-- Show summary for a single turn:
+- Show a trace summary for the second turn (utterance or response) of the conversation:
 
   <%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --turn 2
 
@@ -154,7 +157,7 @@ Message
 
   <%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --format detail --dimension actions
 
-- Drill into routing decisions for a specific turn:
+- Drill into routing decisions for the first turn of the conversation:
 
   <%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --format detail --dimension routing --turn 1