Skip to content

feat(specs): add agentic analytics support to insights spec - #6876

Merged
Fluf22 merged 2 commits into
mainfrom
VNTS-166-agentic-insights-spec
Aug 11, 2026
Merged

Fluf22 merged 2 commits into
mainfrom
VNTS-166-agentic-insights-spec

Conversation

@sirockin

@sirockin sirockin commented Aug 11, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds agentic analytics support to the Insights API spec (VNTS-166). These changes are non-breaking and have already been incorporated into and tested in the insights-api.

  • InstantsearchEvent β€” new event type enum (instantsearch)
  • Instantsearch β€” new event schema with eventName, eventType, userToken, authenticatedUserToken, timestamp, and agentID
  • agentID β€” new field for correlating events within an agent session
  • queryID β€” extended pattern to accept message_ prefix for agentic events (maxLength 128, removed minLength)
  • EventsItems β€” added Instantsearch to the oneOf union
  • pushEvents β€” added two request examples (InstantsearchMinimum, InstantsearchWithAgentID) and updated WrongEventType error message

Bundled output verified against the draft spec in go/internal/insights/api/spec/insights_draft.yml β€” all schemas, examples, and error messages match.

Test plan

  • CI passes (spec linting, client generation)
  • Generated clients include Instantsearch event type and agentID field
  • Bundled spec matches insights_draft.yml in the go repo

πŸ€– Generated with Claude Code

Add InstantsearchEvent type, agentID field, and extended queryID pattern
to support agentic analytics telemetry in the Insights API.

VNTS-166

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@algolia-api-clients-automation-bot

algolia-api-clients-automation-bot Bot commented Aug 11, 2026 •

Copy link
Copy Markdown
Contributor

βœ”οΈ Code generated!

Name Link
πŸͺ“ Triggered by f3cc21f19b8de6813ae7a926d7d8c2071da19c37
πŸƒ Generated commit 40d0d59dc4cfef9b4817c87fe29f3a7d2aacacfe
🌲 Generated branch generated/VNTS-166-agentic-insights-spec
πŸ“Š Benchmark results

Benchmarks performed on the method using a mock server, the results might not reflect the real-world performance.

Language Req/s
javascript 2272
php 2068
go 1976
csharp 1492
python 1406
java 1067
ruby 1024
swift 900
scala 657

@sirockin sirockin changed the title feat(insights): add agentic analytics support feat(insights): add agentic analytics support (non-breaking) Aug 11, 2026
Required by automation-custom/has-type lint rule.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@sirockin sirockin changed the title feat(insights): add agentic analytics support (non-breaking) feat(specs): add agentic analytics support to insights spec Aug 11, 2026
@sirockin
sirockin marked this pull request as ready for review August 11, 2026 09:24
@sirockin
sirockin requested a review from a team as a code owner August 11, 2026 09:24
@Fluf22
Fluf22 merged commit 1f389d1 into main Aug 11, 2026
37 of 38 checks passed
@Fluf22
Fluf22 deleted the VNTS-166-agentic-insights-spec branch August 11, 2026 09:49
algolia-api-clients-automation-bot Bot added a commit that referenced this pull request Aug 11, 2026
…generated) [skip ci]

Co-authored-by: Dave Sirockin <dave@sirockin.com>
algolia-api-clients-automation-bot Bot added a commit to algolia/algoliasearch-client-csharp that referenced this pull request Aug 11, 2026
algolia/api-clients-automation#6876

Co-authored-by: algolia-api-clients-automation-bot[bot] <288895823+algolia-api-clients-automation-bot[bot]@users.noreply.github.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>
algolia-api-clients-automation-bot Bot added a commit to algolia/algoliasearch-client-dart that referenced this pull request Aug 11, 2026
algolia/api-clients-automation#6876

Co-authored-by: algolia-api-clients-automation-bot[bot] <288895823+algolia-api-clients-automation-bot[bot]@users.noreply.github.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>
algolia-api-clients-automation-bot Bot added a commit to algolia/algoliasearch-client-go that referenced this pull request Aug 11, 2026
algolia/api-clients-automation#6876

Co-authored-by: algolia-api-clients-automation-bot[bot] <288895823+algolia-api-clients-automation-bot[bot]@users.noreply.github.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>
algolia-api-clients-automation-bot Bot added a commit to algolia/algoliasearch-client-java that referenced this pull request Aug 11, 2026
algolia/api-clients-automation#6876

Co-authored-by: algolia-api-clients-automation-bot[bot] <288895823+algolia-api-clients-automation-bot[bot]@users.noreply.github.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>
algolia-api-clients-automation-bot Bot added a commit to algolia/algoliasearch-client-javascript that referenced this pull request Aug 11, 2026
algolia/api-clients-automation#6876

Co-authored-by: algolia-api-clients-automation-bot[bot] <288895823+algolia-api-clients-automation-bot[bot]@users.noreply.github.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>
algolia-api-clients-automation-bot Bot added a commit to algolia/algoliasearch-client-kotlin that referenced this pull request Aug 11, 2026
algolia/api-clients-automation#6876

Co-authored-by: algolia-api-clients-automation-bot[bot] <288895823+algolia-api-clients-automation-bot[bot]@users.noreply.github.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>
algolia-api-clients-automation-bot Bot added a commit to algolia/algoliasearch-client-php that referenced this pull request Aug 11, 2026
algolia/api-clients-automation#6876

Co-authored-by: algolia-api-clients-automation-bot[bot] <288895823+algolia-api-clients-automation-bot[bot]@users.noreply.github.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>
algolia-api-clients-automation-bot Bot added a commit to algolia/algoliasearch-client-python that referenced this pull request Aug 11, 2026
algolia/api-clients-automation#6876

Co-authored-by: algolia-api-clients-automation-bot[bot] <288895823+algolia-api-clients-automation-bot[bot]@users.noreply.github.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>
algolia-api-clients-automation-bot Bot added a commit to algolia/algoliasearch-client-ruby that referenced this pull request Aug 11, 2026
algolia/api-clients-automation#6876

Co-authored-by: algolia-api-clients-automation-bot[bot] <288895823+algolia-api-clients-automation-bot[bot]@users.noreply.github.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>
algolia-api-clients-automation-bot Bot added a commit to algolia/algoliasearch-client-scala that referenced this pull request Aug 11, 2026
algolia/api-clients-automation#6876

Co-authored-by: algolia-api-clients-automation-bot[bot] <288895823+algolia-api-clients-automation-bot[bot]@users.noreply.github.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>
algolia-api-clients-automation-bot Bot added a commit to algolia/algoliasearch-client-swift that referenced this pull request Aug 11, 2026
algolia/api-clients-automation#6876

Co-authored-by: algolia-api-clients-automation-bot[bot] <288895823+algolia-api-clients-automation-bot[bot]@users.noreply.github.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants