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_resolve_session_main.py

View on GitHub
"""Tests for ``resolve_session.main`` CLI.

Argparse-driven — exercises every branch:
- UUID pass-through
- --disk-only hit / miss
- live path with --org
- disk-first fallback when no --org
- not-found-no-org error (no sf default target org either)
"""
from __future__ import annotations

import io
import unittest
from pathlib import Path
from tempfile import TemporaryDirectory
from unittest import mock

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

import resolve_session  # type: ignore
from .fixtures.synthetic_session import IDS, write_to_disk  # type: ignore


class _MainHarness:
    """Patch sys.argv + stdout/stderr; optionally plant the synthetic
    fixture under DATA_ROOT for disk-resolution tests."""

    def __init__(self, *, argv: list[str], plant_fixture: bool = False):
        self.argv = argv
        self.plant_fixture = plant_fixture

    def __enter__(self):
        self._tmp = TemporaryDirectory()
        self._tmpdir = Path(self._tmp.name)
        if self.plant_fixture:
            write_to_disk(self._tmpdir)
        self._patches = [
            mock.patch.object(resolve_session.sys, "argv",
                              ["resolve_session.py", *self.argv]),
            mock.patch.object(resolve_session, "DATA_ROOT", self._tmpdir),
        ]
        for p in self._patches:
            p.start()
        self.stdout = io.StringIO()
        self.stderr = io.StringIO()
        self._stdout_patch = mock.patch("sys.stdout", self.stdout)
        self._stderr_patch = mock.patch("sys.stderr", self.stderr)
        self._stdout_patch.start()
        self._stderr_patch.start()
        return self

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


# -----------------------------------------------------------------------------
# UUID pass-through
# -----------------------------------------------------------------------------


class UuidPassThroughTests(unittest.TestCase):

    def test_uuid_input_prints_unchanged_returns_zero(self):
        with _MainHarness(argv=["--id", IDS.SID]) as h:
            rc = resolve_session.main()
        self.assertEqual(rc, 0)
        self.assertIn(IDS.SID, h.stdout.getvalue())


# -----------------------------------------------------------------------------
# --disk-only branch
# -----------------------------------------------------------------------------


class DiskOnlyBranchTests(unittest.TestCase):

    def test_disk_only_hit_prints_uuid(self):
        with _MainHarness(
            argv=["--id", "0MwTESTMSG12345AAA", "--disk-only"],
            plant_fixture=True,
        ) as h:
            rc = resolve_session.main()
        self.assertEqual(rc, 0)
        self.assertIn(IDS.SID, h.stdout.getvalue())

    def test_disk_only_miss_returns_one(self):
        with _MainHarness(
            argv=["--id", "0Mw000000000000", "--disk-only"],
            plant_fixture=True,
        ) as h:
            rc = resolve_session.main()
        self.assertEqual(rc, 1)
        self.assertIn("no local session dir matches", h.stderr.getvalue())


# -----------------------------------------------------------------------------
# Live path with --org
# -----------------------------------------------------------------------------


class LiveOrgPathTests(unittest.TestCase):

    def test_live_path_returns_uuid_from_resolver(self):
        with _MainHarness(
            argv=["--id", "0MwTESTMSG12345AAA", "--org", "my-org"],
        ) as h:
            with mock.patch.object(
                resolve_session, "resolve", return_value="resolved-uuid",
            ) as r:
                rc = resolve_session.main()
            r.assert_called_once_with("0MwTESTMSG12345AAA", org="my-org")
        self.assertEqual(rc, 0)
        self.assertIn("resolved-uuid", h.stdout.getvalue())


# -----------------------------------------------------------------------------
# Disk-first convenience fallback
# -----------------------------------------------------------------------------


class DiskFirstFallbackTests(unittest.TestCase):

    def test_disk_hit_when_no_org_supplied(self):
        # No --org but disk resolution succeeds via fixture.
        with _MainHarness(
            argv=["--id", "0MwTESTMSG12345AAA"],
            plant_fixture=True,
        ) as h:
            rc = resolve_session.main()
        self.assertEqual(rc, 0)
        self.assertIn(IDS.SID, h.stdout.getvalue())

    def test_disk_miss_no_org_returns_two_with_hint(self):
        # No --org, disk miss, AND no sf default target org → exit 2 +
        # helpful stderr.
        with _MainHarness(
            argv=["--id", "0Mw000000000000"],
        ) as h:
            with mock.patch.object(
                resolve_session, "default_target_org",
                side_effect=SystemExit("no --org given and no default target org set"),
            ):
                rc = resolve_session.main()
        self.assertEqual(rc, 2)
        self.assertIn("not found on disk", h.stderr.getvalue())
        self.assertIn("--org <alias> required", h.stderr.getvalue())
        self.assertIn("no default target org set", h.stderr.getvalue())


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