メインコンテンツまでスキップ

変更履歴

embed SDK と platform API の主な変更点です。wire contract は /embed/v1/* と /inference-api/b2b/v1/* でバージョニングされ、breaking change は 旧 major と並行して新しい major として配信されます（CDN バージョニング）。

2026-09​

  • Capability-policy SSOT。 Product → scope と tier → API-capabilities は @kaleidr/shared-types の1か所に統合されました （B2B_PRODUCT_REQUIRED_SCOPE, B2B_TIER_API_CAPABILITIES）。parity test 付きです。shared-api（mint / rotate / PATCH clamp）、 inference-api（session exchange, runtime credentials）、docs が利用します。
  • 実効 capability = 保存済み key × 現在の tier。 Session exchange と すべての runtime credential path は org の 現在の tier から admission を再計算します — Pro-tier key が Free に downgrade された場合、その時点以降は tile session のみ作成されます。subcode は区別されます： tier_capability_not_allowed（以前は持っていたが tier が許可しなくなった）と insufficient_scope（最初から持っていなかった）。
  • Billing plan の変更で apikey:* cache を invalidate。 Subscription webhook が key ごとの snapshot を破棄し、downgrade/upgrade が runtime に即座に反映されます。session は各 request で key の live policy を 再読み込みするため、downgrade は すでに発行済み の session にも到達します — session TTL に制限されなくなりました。upgrade は引き続き新しい session が必要です。session は parent より権限を狭めることしかできないためです。
  • Free-tier の PATCH 拡張を拒否。 Free-tier key の scopes / allowed_products を tier admission より広げる編集は 403 tier_capability_not_allowed を返します。これには empty-products = all のケースも含まれます。
  • SSE grounding event を削除。 Grounding は引き続き回答形成に影響しますが、 wire 上に frame を送らなくなりました。これを listen していた client は 単に受信しなくなります。

2026-08​

  • Basemap access は key-authorized。 tile.kaleidr.com の 第三者による直接利用は制限されています。<kaleidr-map> embed と Kaleidr-hosted map は影響を受けません。basemap session は org の 共有月間 map-loads allowance を消費します （quota）。
  • Session exchange + refresh。 Publishable key は短期間有効な origin-bound session（kld_sess_{env}_…, 15-min TTL）に交換され、 session refresh は SDK が処理します。
  • Place bridge / iframe seam。 iframe product と parent page の間の cross-frame Place event 用 postMessage seam を標準化しました。
  • Org basemap default。 embed が指定しない場合、/sdk/sessions は org に保存された default basemap_style_id を返します。SDK は kaleidr-morning に fallback する前にそれを適用します。
  • Server key の browser 利用を拒否。 SDK は mount 時に kld_sk_… を拒否します （server key は server-side のみ）。
  • Dev / prod CDN + API bake。 両 environment は version-stable endpoint から提供されます。 viewerBase は loader の base から分離され、 editor の tile CDN 用に tileBase も分離されました。
  • Seam v2 route color。 Route event は stable contract 上で color / label / alternatives / comparison を持ちます。

v1​

  • kaleidr.js loader + <kaleidr-map> element — 1つの façade、4つの product（chat / viewer / editor / tile）、2つの doorway。
  • Publishable browser key（kld_pk_）と server key（kld_sk_）、 scope ai | maps | design | vendor。publishable key は短期間有効な origin-bound session に交換されます。Legacy kld_live_ key も引き続き 動作します。
  • /inference-api/b2b/v1/chat/* (SSE) + /design/* route family。

リリースに合わせてこのページを更新していきます。