Skip to content

v2.8.0 — Three-channel interpretation layer

Latest

Choose a tag to compare

@surendranb surendranb released this 15 Jul 04:33

What's new

Skills were there but invisible. This release wires three communication channels to bring them into every session — proactively, not just on errors.

Channel 1 — Model context (tool descriptions)

get_ga4_data now carries a 4-step workflow directly in its description: check skills first, verify field names, then query. Inline UA→GA4 name table, date syntax, filter structure, and scope rules — everything the model needs before touching the API.

Channel 2 — User-direct (log messages)

ctx.info() tips fire proactively before queries — not only after errors. Every call to search_schema, list_dimension_categories, list_metric_categories, and get_ga4_data sends a skill suggestion to the user in real time. Reactive tips still fire on schema errors, filter failures, IAM denials, and incompatibility errors.

Channel 3 — Model-to-user relay (response fields)

Successful get_ga4_data responses include a _skills_tip field the model can incorporate into its answer, pointing to the relevant skill for deeper analysis.

Two new skills

  • ua-to-ga4 — complete UA→GA4 field name mapping with attribution scope prefix table
  • date-ranges — valid date formats, common windows, period-over-period patterns, partial-day warnings

Skills library is now 15 total.

Telemetry

New skill_tip_shown event tracks every Channel 2 firing: trigger, skill suggested, proactive vs reactive, whether ctx was available. Enables a PostHog funnel from tip to search_skills call to measure actual adoption impact.