EveMissLab · Agent Time Infrastructure

共同時間座標層 · CTCL

給 agent 的驗證參考瞬間與異質時間轉換層。不是「現在幾點」,而是「我們共同指向哪一個參考瞬間,它在你的世界裡如何表示」。
Same instant, different representations. A reference layer, not a clock authority.

CTCL /v1/now (edge, verified)
unix_ns (ms-padded)
instant_id
你的瀏覽器本機時間
兩者差 (drift)

↑ 三個時鐘:CTCL 邊緣參考、你的本機、與其漂移。這正是「異質時間系統需要共同參考層」的最小演示。精度誠實標為毫秒級(§16)。

端點 Endpoints

GET
/v1/now
驗證參考瞬間(含來源、不確定度、instant_id)
POST
/v1/convert
跨編碼/時標/時區轉換(保精度)
POST
/v1/transform
映射到自定義倍速世界時間
GET
/v1/timescales
支援的時標
GET
/v1/encodings
支援的編碼
GET
/ai/ctcl.json
agent 工具宣告(先讀這個)

本地 agent 怎麼調用

Agent 先讀 /ai/ctcl.json 發現能力,再呼叫端點。取得驗證瞬間:

curl -s https://www.commoninstant.org/v1/now

把一個 Unix 奈秒值轉成台北時間(保精度):

curl -s https://www.commoninstant.org/v1/convert -H 'content-type: application/json' -d '{
  "input":  {"value":"1783420000.123456789","encoding":"unix_s"},
  "output": {"encoding":"rfc3339","timezone":"Asia/Taipei"}
}'

映射到一個 12 倍速、一年 400 天的遊戲世界:

curl -s https://www.commoninstant.org/v1/transform -H 'content-type: application/json' -d '{
  "value":"1783420000","value_encoding":"unix_s",
  "system":{"parent":"ctcl:system:unix","epoch":{"parent_value":"1780000000"},
            "rate":{"value":12},"calendar":{"day_seconds":72000,"year_days":400}}
}'

試一下 Playground

轉換:把左邊的 Unix 秒轉成右邊時區的 RFC3339。