Credits

Credit は、価値の高い agent context の取得や処理に使われる quota です。Pack や track の data model とは別に、利用量を管理するために使われます。

1 credit の price は $0.01 です。Checkout には allocations 全体で最低 500 credits の purchase total が必要です。

Balance

Credit balance は、現在の personal または workspace context で解決されます。API では workspace balance を見るときに workspaceId を使います。CLI では selected workspace または EPISMO_TOKEN が context を決めます。

epismo credit balance

API は次の形を返します。

{
	"balance": 1200,
	"shortfall": 0
}

shortfall は、現在の operation や plan に対して credit が不足している場合に non-zero になります。

Checkout

Checkout は購入 flow を開始し URL を返します。

epismo credit checkout --allocations '[{"userId":"<user-id>","quantity":500}]'

API payload:

{
	"allocations": [{ "userId": "user-id", "quantity": 500 }]
}

Workspace context では allocation はその workspace に紐づきます。Personal space では authenticated user context に適用されます。

各 allocation は non-empty userId と positive integer quantity を要求します。すべての allocations の合計 quantity は最低 500 credits である必要があります。

Credit を消費する操作

Credit は、agent を実行する操作、または agent/user のために価値の高い pack/search context を取得する操作で消費されます。

Outline や metadata だけで十分な場面では、detail を agent context に hydrate する前に search result や outline を確認してください。特に大きい pack では、full=true よりも blockIds / stepIds による selective read を優先すると、不要な context retrieval を避けられます。

現行実装では credit-gated operation の前に availability を確認し、successful retrieval または successful agent usage の後に credit を消費します。Read 後の consumption は fail-open です。Content read が成功し consumption が失敗した場合でも response は返され、失敗は server-side に記録されます。

Credit が不足している場合、credit-gated endpoint は 402 Payment Required を返すことがあります。

Operational guidance

• 多数の search や detail get を行う batch job の前に balance を確認します。
• Agent を長時間動かす workflow の前に、selected workspace の credit を確認します。
• full=true の前に outline/selective pack read を優先します。
• CI では workspace-scoped token を使い、意図した workspace の credit を消費します。