Resource Governance

Takos の current resource governance は、old docs の space_plans / app_quotas 中心モデルではなく、resource CRUD + access control + runtime settings + billing gates の組み合わせで成立しています。

管理対象

Takos は次の面を別々に管理します。

• resource 自体の CRUD
• space/service/worker への access grant
• connection token の発行
• common env / binding link
• runtime setting / limit
• usage metering と billing gate

current control points

resources

/api/resources family が resource 正本です。

• resource CRUD
• access grant (/access)
• token / connection info (/tokens, /connection)
• D1 introspection / query / export
• R2 object list / stats / delete
• bind / unbind

common env と bindings

state は次に分かれています。

• space-level common env
• service common env links
• worker common env links
• service bindings
• worker bindings

これにより「resource を持つこと」と「どこへ注入するか」を分離しています。

runtime settings

service / worker ごとに runtime setting, limit, flag を持てます。operator が調整する主な対象は次です。

• hostname / route
• common env links
• resource bindings
• runtime flags / settings / limits

billing gate

current implementation では request path ごとに billing/plan gate をかけています。

gate	path family
vector search	/api/spaces/:spaceId/search*
embeddings / index	/api/spaces/:spaceId/index*
sessions exec time	/api/sessions*
service / WFP usage	/api/services*
agent runtime + token preflight	/api/spaces/:spaceId/threads*, /api/runs*, /api/agent-tasks*

agent 系は特に次を併用します。

• weekly runtime limit
• token input billing gate

billing data model

usage と請求は account 中心です。主要な group:

• billingAccounts
• billingPlans
• billingTransactions
• usageEvents
• usageRollups

current public billing API は /api/billing family です。/api/billing/usage は current account の usage rollup を返します。

operator が見るべき state

• resource inventory
• access grants / tokens
• common env drift
• service / worker runtime settings
• usage rollup
• billing status

詳しい public path は API リファレンス を参照してください。billing の詳細は Billing を参照してください。