# Drillso

Drillso turns shared reading sessions into drillable knowledge trees. Public shared sessions can expose an agent-friendly JSON packet so local agents can use a shared article/session as reference material without scraping HTML.

## Agent JSON

Shared sessions expose:

```txt
/{locale}/share/sessions/{shareId}/agent.json
/{locale}/share/sessions/{shareId}/agent.json?node={nodeSlug}
/{locale}/share/sessions/{shareId}/agent.json?node={nodeSlug}&scope=full
```

Parameters:

- `node`: optional canonical node slug. When omitted, the root node is returned.
- `scope`: optional. Defaults to `node`. Use `scope=full` to return the full non-deleted drill tree.

The JSON response uses schema `drillso.agent.session.v1` and includes plain text, markdown, structured props, breadcrumbs, parent links, child links, the canonical public page URL, and the corresponding agent URL.

## Privacy

This file documents the agent entry format but does not enumerate user-generated shared content. Unlisted shares remain accessible only to callers that already have the share URL.