{"name":"session.usage","slug":"session-usage","family":"setting","title":"Settings keys","noun":"settings key","description":"Plugins and hooks gain new permission scopes: session.usage, settings.read, env.get, env.set","description_source":"entry","described_by":{"version":"2.1.267","anchor":"new-pluginhook-capability-scopes-sessionusage-settingsr"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.319","builds":0,"mined_builds":159,"first_cited":{"version":"2.1.267","released_at":"2026-09-09 18:25:42","spans":1}},"aliases":[],"entries":[{"version":"2.1.280","anchor":"builtin-hooks-module-capability-manifests-expanded","heading":"Builtin hooks-module capability manifests expanded","line":"Builtin plugin hook modules were granted access to more host calls, including two new environment variables","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.271","anchor":"plugin-sessionusage-api-call-now-validates-its-arguments","heading":"Plugin session.usage API call now validates its arguments","line":"Plugin session.usage API now validates its breakdown and columns arguments","released_at":"2026-09-14 19:45:19","reason":"found in this entry's text"},{"version":"2.1.267","anchor":"new-pluginhook-capability-scopes-sessionusage-settingsr","heading":"New plugin\/hook capability scopes: session.usage, settings.read, env.get, env.set","line":"Plugins and hooks gain new permission scopes: session.usage, settings.read, env.get, env.set","released_at":"2026-09-09 18:25:42","reason":"found in this entry's text, named in this entry"},{"version":"2.1.267","anchor":"pluginhook-capability-namespace-gains-session-and-env-acces","heading":"Plugin\/hook capability namespace gains session and env access","line":"Hooks and plugins can now access session usage stats and read\/write environment variables","released_at":"2026-09-09 18:25:42","reason":"found in this entry's text"}],"entries_total":4,"docs":[{"source":"api","path":"api\/beta\/sessions\/events","title":"Events","documented":false},{"source":"api","path":"api\/beta\/sessions\/events\/list","title":"List Events","documented":false},{"source":"api","path":"api\/beta\/sessions\/events\/stream","title":"Stream Events","documented":false},{"source":"api","path":"api\/beta\/sessions\/threads","title":"Threads","documented":false},{"source":"api","path":"api\/beta\/sessions\/threads\/events","title":"Events","documented":false},{"source":"api","path":"api\/beta\/sessions\/threads\/events\/list","title":"List Session Thread Events","documented":false},{"source":"api","path":"api\/beta\/sessions\/threads\/events\/stream","title":"Stream Session Thread Events","documented":false},{"source":"api","path":"managed-agents\/budgets","title":"budgets","documented":false},{"source":"api","path":"managed-agents\/reference","title":"reference","documented":false},{"source":"api","path":"managed-agents\/session-observability","title":"session-observability","documented":false}],"docs_total":10,"gates":[],"related":[{"name":"session","slug":"session","description":"A per-session workshop document gets snapshotted with your session files and is only writable in plan mode."},{"name":"session.attach","slug":"session-attach","description":"Plugin hooks can now react to tool-call dry-runs, config changes, and session attach\/detach events."},{"name":"session.authorize","slug":"session-authorize","description":"Plugins gain $.session.authorize(), which mints an auth handle for the session."},{"name":"session.compact","slug":"session-compact","description":"A new `session.compact` plugin hook can intercept and rewrite conversation compaction"},{"name":"session.detach","slug":"session-detach","description":"Plugin hooks can now react to tool-call dry-runs, config changes, and session attach\/detach events."},{"name":"session.end","slug":"session-end","description":"Two new lifecycle events, `session.end` and `session.measure`, added for plugins and hooks"},{"name":"session.measure","slug":"session-measure","description":"Two new lifecycle events, `session.end` and `session.measure`, added for plugins and hooks"},{"name":"session.receive","slug":"session-receive","description":"A new `session.compact` plugin hook can intercept and rewrite conversation compaction"},{"name":"session.root","slug":"session-root","description":"Plugin API policy list adds session.root, prompt.read, and ui.panes as permitted actions"},{"name":"session.send","slug":"session-send","description":"Plugin hooks can now listen for a new session.send event, alongside session.receive\/detach\/end"}],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/session-usage","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}