Skip to content

New fleetd table: ai_tools - #47641

Merged
noahtalerman merged 10 commits into
docs-v4.89.0from
add-ai-tools-table
Jun 16, 2026
Merged

New fleetd table: ai_tools#47641
noahtalerman merged 10 commits into
docs-v4.89.0from
add-ai-tools-table

Conversation

@kilo-code-bot

@kilo-code-bot kilo-code-bot Bot commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds schema/tables/ai_tools.yml documenting the ai_tools osquery extension table from karmine05/agentic-detector.
  • This cross-platform table surfaces AI tools on the host: MCP servers, AI agent CLIs, AI desktop apps, IDE plugins, live AI/MCP network sockets, and agent instruction files.
  • Follows existing Fleet schema table conventions (YAML format, column definitions with types/descriptions, examples, notes).

Details

The ai_tools table is provided by the agentic-detector osquery extension and uses a single unified schema with a kind discriminator column covering six row types: mcp_server, ide_plugins, agents, apps, sockets, and agent_instruction. Each row carries security posture via risk_flags and a sha256 content fingerprint.

Built for Noah Talerman by Kilo for Slack

Add documentation for the ai_tools osquery extension table provided by
karmine05/agentic-detector. This table surfaces AI tools on the host
including MCP servers, AI agent CLIs, AI desktop apps, IDE plugins,
live AI/MCP network sockets, and agent instruction files.
Comment thread schema/tables/ai_tools.yml Outdated
Comment thread schema/tables/ai_tools.yml Outdated
Comment thread schema/tables/ai_tools.yml Outdated
Comment thread schema/tables/ai_tools.yml Outdated
Comment thread schema/tables/ai_tools.yml Outdated
@noahtalerman noahtalerman changed the title Add ai_tools table schema from agentic-detector extension New fleetd table: ai_tools Jun 15, 2026
@noahtalerman
noahtalerman merged commit b47a196 into docs-v4.89.0 Jun 16, 2026
5 checks passed
@noahtalerman
noahtalerman deleted the add-ai-tools-table branch June 16, 2026 13:20
@dantecatalfamo dantecatalfamo mentioned this pull request Jul 13, 2026
7 tasks
dantecatalfamo added a commit that referenced this pull request Jul 14, 2026
Pulls the ai_tools schema documentation from #47641 into this PR so the table
is documented alongside the code, and reconciles it with what the extension
actually ships:

- discriminator column stays `type` (matches the code and #47641's own YAML,
  despite that PR's description saying `kind`);
- adds the `browser_extension` row type, which the vendored collectors emit but
  the original doc omitted;
- lists the full set of risk_flags the collectors produce.

Regenerated schema/osquery_fleet_schema.json via
`cd website && ./node_modules/sails/bin/sails.js run generate-merged-schema`.
rachaelshaw pushed a commit that referenced this pull request Jul 15, 2026
**Related issue:** Resolves #47619 (docs reconciliation)

Updates the `ai_tools` table schema doc so it matches the extension
actually shipped in fleetd.

The doc (originally #47641) was generated from a pre-v0.3.0 snapshot of
`karmine05/agentic-detector` and predates two things that landed in
v0.3.0 — the version vendored into fleetd in #49243:

- the **`browser_extension`** row type (added upstream *after* the doc
was written);
- several **`risk_flags`** the collectors emit.

### Changes
- Add `browser_extension` to the `type` column options, the table
description, and a new example query.
- List the full set of 15 `risk_flags` the collectors produce (was 8).
- Regenerate `schema/osquery_fleet_schema.json` via `cd website &&
./node_modules/sails/bin/sails.js run generate-merged-schema`.

This brings the published schema in line with the vendored code in
#49243 (which ships 7 row types and 15 risk flags). No other tables are
touched.

# Checklist for submitter

- [x] Documentation updated to match shipped behavior (schema table
doc).
- [x] Regenerated `schema/osquery_fleet_schema.json` (the automated-doc
CI check runs the same generator).
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