Files

22 lines
1.9 KiB
YAML

name: hermes-call-ledger
repo: https://github.com/skappafrost/hermes-call-ledger
sha: c55671dd61becb30a8b4d5e53cba9926938fb299
description: >-
Per-call cost ledger for Hermes Desktop: every model call Hermes makes is recorded from the observer hooks (provider, model, tokens, duration, outcome) and paired with the charge the billing provider actually took; works with no billing account, priced by Hermes' own estimate where the price book knows the model. English or Vietnamese; dong or dollars. Disclosure — three observer hooks (post_api_request, post_auxiliary_call, api_request_error) record per-call metadata from every profile in the install (session id, platform, task, provider, model, token counts, duration, finish reason, context length; never prompt, response or tool-argument text) into one shared SQLite ledger at <install root>/plugin-data/call-ledger/calls.sqlite, and import this plugin's own older per-profile ledgers into it once. It caches the vilao.ai model list there and the USD-to-VND rate under the active profile's plugin-data/call-ledger. Network is GET-only: vilao.ai (wallet balance, per-request usage, consumer keys) with VILAO_PAT read through Hermes's secret scope (vilao issues one full-scope token per account, including wallet writes; this plugin only reads), the public vilao.ai model list with no credential, and open.er-api.com for the dollar rate. The first full billing pull pages back through up to ten years of the account's usage. Nothing runs while the Desktop page is closed. Derived from hermes-resetwatch (Adolanium, MIT).
maintainer: skappafrost
tier: community
category: desktop
requires_hermes: ">=0.21.6"
docs_url: https://github.com/skappafrost/hermes-call-ledger#readme
version: "1.0.0"
platforms: []
capabilities:
provides_tools: []
provides_hooks:
- post_api_request
- post_auxiliary_call
- api_request_error
provides_middleware: []
requires_env:
- VILAO_PAT