Skip to content

forcedotcom/sf-skills / plugins/builder/agentforce-adlc/skills/agentforce-d360-analyze

agentforce-d360-analyze

Verified

Data Cloud 360° view of a single Agentforce session. TRIGGER when user asks to trace, inspect, summarize, or describe a specific Agentforce session by session id (Agent Session UUID `019d…` or MessagingSession id `0Mw…`). Also triggers on session discovery — find/list/search sessions by time, agent, channel, outcome, or conversation text — when the user has no session id yet. DO NOT TRIGGER for design-time architecture questions (use agentforce-architecture-analyze instead) or for runtime perf/latency/SLO questions that require platform telemetry beyond Data Cloud.

FileKindSize
README.mdmarkdown6.2 KB
SKILL.mdskill md13.2 KB
assets/dc/app_generation.sqlother1.9 KB
assets/dc/content_category.sqlother1.5 KB
assets/dc/content_quality.sqlother1.3 KB
assets/dc/discover_sessions.sqlother2.3 KB
assets/dc/feedback.sqlother1.5 KB
assets/dc/feedback_details.sqlother1.3 KB
assets/dc/gateway_records.sqlother1.6 KB
assets/dc/gateway_request_llm.sqlother1.6 KB
assets/dc/gateway_request_metadata.sqlother1.5 KB
assets/dc/gateway_request_tags.sqlother1.4 KB
assets/dc/gateway_requests.sqlother3.4 KB
assets/dc/gateway_responses.sqlother1.7 KB
assets/dc/generations.sqlother1.9 KB
assets/dc/interactions.sqlother2.0 KB
assets/dc/messages.sqlother2.1 KB
assets/dc/messaging_session.sqlother1.7 KB
assets/dc/moment_interactions.sqlother1.4 KB
assets/dc/moments.sqlother1.5 KB
assets/dc/participants.sqlother1.8 KB
assets/dc/sessions.sqlother3.0 KB
assets/dc/steps.sqlother2.6 KB
assets/dc/tag_associations.sqlother1.7 KB
assets/dc/tag_definition_associations.sqlother1.4 KB
assets/dc/tag_definitions.sqlother1.8 KB
assets/dc/tags.sqlother1.3 KB
assets/dc/telemetry_spans.sqlother2.1 KB
references/artifacts.mdmarkdown2.7 KB
references/dc_dmo_fields.mdmarkdown42.1 KB
references/dc_pipeline_contract.mdmarkdown26.3 KB
scripts/_shared/__init__.pyscript122 B
scripts/_shared/cli_override.pyscript3.3 KB
scripts/_shared/fs_guard.pyexecutablescript13.2 KB
scripts/_shared/paths.pyscript5.8 KB
scripts/_shared/runtime.pyscript2.0 KB
scripts/_shared/sql.pyscript548 B
scripts/assemble_dc.pyscript69.6 KB
scripts/config.pyscript1.8 KB
scripts/dc.pyscript13.8 KB
scripts/discover_sessions.pyscript21.1 KB
scripts/fetch_dc.pyscript45.1 KB
scripts/render_dc.pyscript69.7 KB
scripts/resolve_session.pyscript10.8 KB
scripts/storage.pyscript3.1 KB
scripts/tests/__init__.pyscript0 B
scripts/tests/_bootstrap.pyscript483 B
scripts/tests/fixtures/__init__.pyscript0 B
scripts/tests/fixtures/synthetic_session.pyscript14.6 KB
scripts/tests/test_assemble_dc_bootstrap_and_mode.pyscript4.2 KB
scripts/tests/test_assemble_dc_gateway_direct.pyscript8.3 KB
scripts/tests/test_assemble_dc_gateway_direct_integration.pyscript6.4 KB
scripts/tests/test_assemble_dc_helpers.pyscript10.0 KB
scripts/tests/test_assemble_dc_integration.pyscript9.3 KB
scripts/tests/test_dc_and_resolve_session.pyscript26.7 KB
scripts/tests/test_default_target_org.pyscript18.8 KB
scripts/tests/test_discover_sessions.pyscript19.0 KB
scripts/tests/test_discover_sessions_grep_ci.pyscript8.2 KB
scripts/tests/test_fetch_dc_helpers.pyscript10.6 KB
scripts/tests/test_fetch_dc_identity.pyscript22.0 KB
scripts/tests/test_fetch_dc_main.pyscript9.4 KB
scripts/tests/test_fetch_dc_waterfall.pyscript8.6 KB
scripts/tests/test_fetch_dc_waterfall_full.pyscript11.2 KB
scripts/tests/test_identity_coherence.pyscript13.8 KB
scripts/tests/test_render_dc_branches.pyscript9.9 KB
scripts/tests/test_render_dc_gateway_direct.pyscript5.1 KB
scripts/tests/test_render_dc_helpers.pyscript10.5 KB
scripts/tests/test_render_dc_integration.pyscript7.7 KB
scripts/tests/test_render_dc_planner_llm_calls.pyscript11.8 KB
scripts/tests/test_render_dc_show_prompts_gating.pyscript8.7 KB
scripts/tests/test_resolve_from_disk.pyscript4.1 KB
scripts/tests/test_resolve_session_main.pyscript5.2 KB
scripts/tests/test_runtime_override.pyscript4.2 KB
scripts/tests/test_session_shape.pyscript3.5 KB
scripts/tests/test_session_shape_dropped_by_stdm.pyscript3.5 KB
scripts/tests/test_skill_md_prefix_block.pyscript6.8 KB

scripts/tests/test_fetch_dc_main.py

View on GitHub
"""Tests for ``fetch_dc.main`` orchestration.

Drives the CLI via ``argv`` patching. Mocks at three boundaries so we
exercise the orchestration without spawning real DC/HTTP/sf-CLI work:

- ``preflight_dc_access``           returns (url, token) or raises DcAccessDenied
- ``_run_waterfall``                stubbed; mutates ctx the way the real waterfall would
- ``assemble_dc.main_for_session``  patched to no-op
- ``render_dc.main_for_session``    patched to no-op
"""
from __future__ import annotations

import io
import json
import unittest
from datetime import datetime, timezone
from pathlib import Path
from tempfile import TemporaryDirectory
from unittest import mock

from . import _bootstrap  # noqa: F401  — sys.path setup

import fetch_dc  # type: ignore
from config import paths  # type: ignore
from .fixtures.synthetic_session import IDS, write_to_disk  # type: ignore


def _fake_waterfall(ctx: dict) -> None:
    """Mutate ctx the way the real waterfall would: stamp identity +
    append a few query entries. Keeps `_write_manifest` happy."""
    ctx["org_id_15"] = IDS.ORG_ID_15
    ctx["agent_api_name"] = IDS.AGENT_API
    ctx["agent_version"] = IDS.AGENT_VERSION
    ctx["session_shape"] = "complete"
    ctx["queries"].append({
        "name": "sessions", "wave": 1, "rows": 1,
        "elapsed_ms": 50, "status": "ok",
    })
    ctx["queries"].append({
        "name": "interactions", "wave": 1, "rows": 3,
        "elapsed_ms": 60, "status": "ok",
    })


class _MainHarness:
    """Patch DATA_ROOT + the 4 boundary functions so main() runs offline."""

    def __init__(self, *, raise_dc_access_denied=None,
                 is_tty: bool = False):
        self.raise_dc_access_denied = raise_dc_access_denied
        self.is_tty = is_tty

    def __enter__(self):
        self._tmp = TemporaryDirectory()
        self._tmpdir = Path(self._tmp.name)
        # Pre-create the session dir so _write_manifest's mkdir works
        # without surprises.
        write_to_disk(self._tmpdir)
        if self.raise_dc_access_denied is not None:
            preflight_mock = mock.patch.object(
                fetch_dc, "preflight_dc_access",
                side_effect=self.raise_dc_access_denied,
            )
        else:
            preflight_mock = mock.patch.object(
                fetch_dc, "preflight_dc_access",
                return_value=("https://example.salesforce.com", "TOKEN"),
            )
        self._patches = [
            mock.patch.object(paths, "DATA_ROOT", self._tmpdir),
            preflight_mock,
            mock.patch.object(fetch_dc, "_run_waterfall",
                              side_effect=_fake_waterfall),
            mock.patch("assemble_dc.main_for_session", return_value=0),
            mock.patch("render_dc.main_for_session", return_value=0),
            mock.patch.object(fetch_dc.sys.stdin, "isatty",
                              return_value=self.is_tty),
        ]
        for p in self._patches:
            p.start()
        return self

    def __exit__(self, *exc):
        for p in self._patches:
            p.stop()
        self._tmp.cleanup()


# -----------------------------------------------------------------------------
# Happy path
# -----------------------------------------------------------------------------


class MainHappyPathTests(unittest.TestCase):

    def test_main_returns_zero_with_no_assemble_no_render(self):
        with _MainHarness():
            with mock.patch.object(
                fetch_dc.sys, "argv",
                ["fetch_dc.py", "--session", IDS.SID, "--org", "my-org",
                 "--no-assemble", "--no-render"],
            ):
                rc = fetch_dc.main()
        self.assertEqual(rc, 0)

    def test_main_writes_manifest_under_data_root(self):
        with _MainHarness() as h:
            with mock.patch.object(
                fetch_dc.sys, "argv",
                ["fetch_dc.py", "--session", IDS.SID, "--org", "my-org",
                 "--no-assemble", "--no-render"],
            ):
                fetch_dc.main()
            manifest_path = (
                h._tmpdir
                / IDS.ORG_ID_15
                / f"{IDS.AGENT_API}__{IDS.AGENT_VERSION}"
                / IDS.SID
                / "dc._session_manifest.json"
            )
            self.assertTrue(manifest_path.is_file())
            manifest = json.loads(manifest_path.read_text())
        self.assertEqual(manifest["session_id"], IDS.SID)
        self.assertEqual(manifest["session_shape"], "complete")

    def test_main_invokes_assemble_and_render_by_default(self):
        # Without --no-assemble / --no-render, both should be called once.
        with _MainHarness():
            with mock.patch.object(
                fetch_dc.sys, "argv",
                ["fetch_dc.py", "--session", IDS.SID, "--org", "my-org"],
            ):
                # Re-patch the targets at call site to capture.
                with mock.patch("assemble_dc.main_for_session") as ams:
                    with mock.patch("render_dc.main_for_session") as rms:
                        rc = fetch_dc.main()
        self.assertEqual(rc, 0)
        ams.assert_called_once_with(IDS.SID)
        rms.assert_called_once_with(IDS.SID)

    def test_main_skips_assemble_when_flag_set(self):
        with _MainHarness():
            with mock.patch.object(
                fetch_dc.sys, "argv",
                ["fetch_dc.py", "--session", IDS.SID, "--org", "my-org",
                 "--no-assemble"],
            ):
                with mock.patch("assemble_dc.main_for_session") as ams:
                    with mock.patch("render_dc.main_for_session") as rms:
                        rc = fetch_dc.main()
        self.assertEqual(rc, 0)
        ams.assert_not_called()
        rms.assert_called_once()

    def test_main_skips_render_when_flag_set(self):
        with _MainHarness():
            with mock.patch.object(
                fetch_dc.sys, "argv",
                ["fetch_dc.py", "--session", IDS.SID, "--org", "my-org",
                 "--no-render"],
            ):
                with mock.patch("assemble_dc.main_for_session") as ams:
                    with mock.patch("render_dc.main_for_session") as rms:
                        rc = fetch_dc.main()
        self.assertEqual(rc, 0)
        ams.assert_called_once()
        rms.assert_not_called()

    def test_main_verbose_flag_propagates_to_ctx(self):
        captured_ctx = {}

        def capture(ctx):
            captured_ctx.update(ctx)
            _fake_waterfall(ctx)

        with _MainHarness():
            # Override the waterfall mock to capture ctx
            with mock.patch.object(fetch_dc, "_run_waterfall",
                                   side_effect=capture):
                with mock.patch.object(
                    fetch_dc.sys, "argv",
                    ["fetch_dc.py", "--session", IDS.SID, "--org", "my-org",
                     "--verbose", "--no-assemble", "--no-render"],
                ):
                    fetch_dc.main()
        self.assertTrue(captured_ctx["verbose"])


# -----------------------------------------------------------------------------
# Messaging-id input
# -----------------------------------------------------------------------------


class MainMessagingIdTests(unittest.TestCase):

    def test_messaging_id_resolves_to_uuid_via_disk(self):
        # Fixture's session row has the messaging id wired up. Patch the
        # resolver at the source module so fetch_dc's lazy import sees it.
        with _MainHarness():
            with mock.patch(
                "resolve_session.resolve_disk_or_live",
                return_value=IDS.SID,
            ):
                with mock.patch.object(
                    fetch_dc.sys, "argv",
                    ["fetch_dc.py",
                     "--session", "0MwTESTMSG12345AAA",
                     "--org", "my-org",
                     "--no-assemble", "--no-render"],
                ):
                    rc = fetch_dc.main()
        self.assertEqual(rc, 0)


# -----------------------------------------------------------------------------
# DcAccessDenied → routes through _handle_dc_access_denied
# -----------------------------------------------------------------------------


class MainDcAccessDeniedTests(unittest.TestCase):

    def test_returns_exit_dc_access_denied_in_headless(self):
        exc = fetch_dc.DcAccessDenied("401", "Unauthorized")
        with _MainHarness(raise_dc_access_denied=exc, is_tty=False):
            with mock.patch.object(
                fetch_dc.sys, "argv",
                ["fetch_dc.py", "--session", IDS.SID, "--org", "my-org"],
            ):
                with mock.patch("sys.stdout", io.StringIO()):
                    rc = fetch_dc.main()
        self.assertEqual(rc, fetch_dc.EXIT_DC_ACCESS_DENIED)

    def test_returns_exit_dc_access_denied_in_tty_choice_1(self):
        exc = fetch_dc.DcAccessDenied("403", "Forbidden")
        with _MainHarness(raise_dc_access_denied=exc, is_tty=True):
            with mock.patch.object(
                fetch_dc.sys, "argv",
                ["fetch_dc.py", "--session", IDS.SID, "--org", "my-org"],
            ):
                # Interactive prompt: feed "1" via stdin.
                with mock.patch.object(
                    fetch_dc.sys, "stdin",
                    io.StringIO("1\n"),
                ):
                    with mock.patch.object(fetch_dc, "_log"):
                        rc = fetch_dc.main()
        self.assertEqual(rc, fetch_dc.EXIT_DC_ACCESS_DENIED)


if __name__ == "__main__":
    unittest.main()
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall