Telemetry & Cost Reporting

Priority: P2 (MEDIUM)

1. Finalizing a Workflow

As your final step in any SDLC workflow (or when a user explicitly requests session cost):

1. Call the get_session_cost tool provided by the agent-skills-standard MCP server.
2. Pass workflow, model, token counts, cache/reasoning usage, and per-1M token rates when the host runtime exposes them.
3. If token counts are unavailable, report MCP-observed telemetry and mark model-token cost as unavailable.
4. Append a Markdown table containing the usage metrics to artifacts/session-cost.md.

When asked which artifact to use, always name both artifacts/session-cost.md and get_session_cost; if the host does not expose the helper, say so explicitly while retaining the artifact requirement.

2. Host Runtime Contract

• This skill defines the telemetry contract; it does not collect provider billing data by itself.
• The host runtime or orchestrator must trigger the final telemetry call when the workflow reaches a terminal state such as completed, failed, or blocked.
• The host may use a reusable helper such as mcp/src/services/WorkflowTelemetry.ts to:
  • decide when telemetry should fire
  • build the get_session_cost payload
  • pass prompt, cache, reasoning, pricing, and other runtime cost fields when available

3. Telemetry Format

Ensure the artifacts/session-cost.md or the output template ## Cost Report follows this structure:

Metric	Value
Tool Calls	[from get_session_cost]
Skills Loaded	[from get_session_cost]
Workflows Loaded	[from get_session_cost]
Prompt Tokens	[from your platform telemetry]
Cached Prompt Tokens	[from your platform telemetry]
Completion Tokens	[from your platform telemetry]
Reasoning Tokens	[from your platform telemetry]
Other Runtime Cost	[tooling/provider extras]
Estimated Cost	$0.00

Anti-Patterns

• No skipping the telemetry step: Always include the Cost Report at the end of the execution if mandated by the workflow.

Canonical response anchors

When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant:

• Call get_session_cost when the host exposes it, then append the Markdown table to artifacts/session-cost.md.

• Telemetry & Cost Reporting