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/storage.py

View on GitHub
"""Shared per-session JSON writer.

Every Data Cloud artifact lands under the nested layout:

    DATA_ROOT/<org_id_15>/<agent_api_name>__<agent_version>/<session_id>/<source>.<name>.json

One save, one shape, one directory convention — imported by every caller.

**Security contract:**
All four path segments (``org_id_15``, ``agent_api_name``, ``agent_version``,
``session_id``) flow through ``paths.session_dir(...)``, which validates
each via fs_guard (regex) before the join. A ``..`` or ``/`` in any
segment raises ``paths.PathValidationError`` — direct
``DATA_ROOT / session_id`` composition is unreachable from this module.

Source-prefix convention:
    Flat directory, prefix filenames with provenance so an `ls` on the
    per-session dir tells you where each artifact came from:

        dc.sessions.json       — from Data Cloud
        dc.interactions.json

    Baking the prefix into the API (vs. leaving it to filename discipline)
    makes it impossible to forget — callers pass ``source`` + ``name``,
    never a raw filename.
"""
from __future__ import annotations

import json
from pathlib import Path

from config import paths


def save(
    data: list[dict] | dict,
    org_id_15: str,
    agent_api_name: str,
    agent_version: str,
    session_id: str,
    source: str,
    name: str,
) -> Path:
    """Write JSON under the nested session dir. Returns the target path.

    Signature:
        save(data, org_id_15, agent_api_name, agent_version, session_id,
             source, name) -> Path

    ``source`` is the leading filename segment for provenance — callers
    pass ``"dc"``. ``name`` is the bare artifact name, no extension —
    ``.json`` is appended.

    Raises ``paths.PathValidationError`` if any of the four identity
    segments fails validation.
    """
    # paths.session_dir() validates org_id_15, agent_api_name, agent_version
    # (via fs_guard) and session_id (via SESSION_ID_RE.fullmatch). Any bad
    # input raises PathValidationError before we touch the filesystem.
    target = paths.session_dir(
        org_id_15, agent_api_name, agent_version, session_id
    )
    target.mkdir(parents=True, exist_ok=True)
    path = target / f"{source}.{name}.json"
    path.write_text(json.dumps(data, indent=2, default=str) + "\n")
    _write_breadcrumb(org_id_15, agent_api_name, agent_version, session_id)
    return path


def _write_breadcrumb(
    org_id_15: str,
    agent_api_name: str,
    agent_version: str,
    session_id: str,
) -> None:
    """Write ``<org>/_sessions/<sid>.link`` pointing at the session dir.

    Plain text, no symlink (Windows-safe). Content is the relative path
    ``../<agent>__<ver>/<sid>\\n``. Idempotent — overwriting with the
    same content is a no-op semantically. Silent on failure; breadcrumbs
    are best-effort (a missing breadcrumb doesn't break the write,
    only handoff-session discovery).
    """
    try:
        link_dir = paths.DATA_ROOT / org_id_15 / "_sessions"
        link_dir.mkdir(parents=True, exist_ok=True)
        link_path = link_dir / f"{session_id}.link"
        link_path.write_text(
            f"../{agent_api_name}__{agent_version}/{session_id}\n"
        )
    except OSError:
        pass
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