プラットフォーム

Takos プラットフォームは、アプリの実行基盤（runtime / deploy）の上位に位置するサービスレイヤーです。アプリ間の連携、ユーザー管理、課金、分散カタログなど、プロダクト運用に必要な機能を提供します。

プラットフォームとアプリ / ランタイムの違い

レイヤー	担当	例
アプリ	宣言的な manifest (`app.yml`) によるワークロード定義	Workers, Containers, Resources, Routes
ランタイム	manifest を実際の backend に反映する実行基盤	Cloudflare Workers, CF Containers, D1, R2
プラットフォーム	アプリ横断の管理機能	Store, Spaces, 課金, Federation

アプリレイヤーが「何をデプロイするか」を定義し、ランタイムが「どこで動かすか」を実現するのに対し、プラットフォームは「誰が使い、どう配布し、どう課金するか」を管理します。

主要コンセプト

Spaces

Space は Takos の最上位の隔離単位です。メンバー、リポジトリ、Worker、リソース、スレッド、ファイルをまとめて管理します。

個人用 (user): ユーザー作成時に自動生成
チーム用 (team): 複数メンバーで共同利用
ロールベースのアクセス制御 (owner / admin / editor / viewer)
Principal としてユーザー・agent・service が操作可能

Store

アプリの公開・配信・インストールを担う分散カタログです。

public リポジトリに .takos/app.yml と Release があれば自動掲載
takos install で Store package を Space にインストール
Official Packages と Seed Repositories による推奨管理
ActivityPub ベースの分散カタログ連携

課金

使用量ベースの課金システムです。

Free: 個人の検証・小規模利用向け
Plus: サブスクリプション型の個人向け有料プラン
Pay As You Go: プリペイド残高からの従量課金
メーターごとのクォータ管理と自動リセット

ActivityPub Federation

ActivityPub と ForgeFed をベースとした、インスタンス間のリポジトリカタログ連携です。

git データは各インスタンスに分散したまま、メタデータのみを共有
Store actor がリポジトリ参照を集約するカタログとして機能
WebFinger による発見、Follow による購読
リモート Store のリポジトリを import して利用可能

アーキテクチャ

text

┌─────────────────────────────────────────────────┐
│                  Platform Layer                  │
│                                                  │
│  ┌──────────┐  ┌─────────┐  ┌────────────────┐  │
│  │  Spaces   │  │  Store  │  │    Billing     │  │
│  │ (テナント) │  │ (配布)  │  │    (課金)      │  │
│  └────┬─────┘  └────┬────┘  └───────┬────────┘  │
│       │             │               │            │
│  ┌────┴─────────────┴───────────────┴────────┐   │
│  │           ActivityPub Federation           │   │
│  └────────────────────────────────────────────┘   │
├─────────────────────────────────────────────────┤
│                  Runtime Layer                    │
│  Deploy Groups / Workers / Containers / Resources │
├─────────────────────────────────────────────────┤
│                    App Layer                     │
│           app.yml (Manifest / Spec)              │
└─────────────────────────────────────────────────┘

Threads & Runs

AI エージェントの実行モデルです。

Thread: 会話のコンテキストを保持する単位
Run: Thread 上でのエージェント実行
Space 内でスレッドとランの実行履歴を管理
メーターによる使用量トラッキング

各ページへのリンク

ページ	説明
Store	アプリの公開・配信・インストール
Spaces	マルチテナントの隔離単位
課金	プラン・使用量・決済
ActivityPub	連合プロトコル対応

プラットフォーム ​

プラットフォームとアプリ / ランタイムの違い ​

主要コンセプト ​

Spaces ​

Store ​

課金 ​

ActivityPub Federation ​

アーキテクチャ ​

Threads & Runs ​

各ページへのリンク ​