Workspace

このページでわかること: Takos Workspace の役割と、旧 Space 語彙との違い。

Takos の current product copy では Workspace を使います。chat、agent、memory、Git repository、app launcher、MCP tools をまとめる Takos 内の作業領域です。旧 docs / DB / route 名に残る space は Takos product-local な互換語彙であり、 Takosumi の OpenTofu Capsule owner namespace ではありません。

Takosumi Resource Shape API には Space がありますが、これは shape namespace / policy scope の語彙です。OpenTofu stack flow の正本語彙は Workspace / Project / Capsule / Source / ProviderConnection / CredentialRecipe / ProviderBinding / Run / StateVersion / Output です。

txt

Takos
  ├─ user Workspace
  ├─ team Workspace
  └─ system Workspace
        └─ installed app / user content

Capsule lifecycle の詳細は Takosumi model を参照。

Workspace の種類

kind	説明
`user`	個人用 space。ユーザー作成時に自動生成され、UI では personal と表示する
`team`	チーム用 space。複数メンバーで共同利用する
`system`	システム管理用 space

Organization は Workspace kind ではなく membership / billing / policy の上位構造です。大規模な組織利用でも、Takos Workspace の kind は user / team / system のいずれかに閉じます。

Personal space は GET /api/me/personal-space で取得。slug で一意に識別でき、/api/spaces/me で personal space を指す shortcut もある。

Git state

Workspace の作成は Workspace row と owner membership だけを作り、空の default repository は自動作成しません。 POST /api/spaces、GET /api/spaces/:spaceId、Workspace export も repository record を埋め込みません。Git は明示的に作成・install された Git capability（通常は takos-git の Interface）として接続します。

旧 version で作成済みの repository row はこの変更では削除しません。互換 read や利用者による明示的な移行を壊さず、新しい Workspace lifecycle と repository lifecycle を分離するためです。

Role

role	level	説明
`owner`	4	全操作が可能
`admin`	3	member 管理、deploy、resource 操作
`editor`	2	コンテンツの作成・編集
`viewer`	1	読み取りのみ

Principal

membership の主体。ユーザーだけでなく agent や service も principal として操作できる。

kind	説明
`user`	人間のユーザー
`space_agent`	AI agent
`service`	deploy された service
`system`	システム
`tenant_worker`	tenant worker

Capability

Workspace 内で service が使える capability:

storage.read/write / repo.read/write / egress.http / oauth.exchange / vectorize.write / queue.write / analytics.write / workflow.invoke / durable_object.use / billing.meter

課金との関係

Workspace は親 Takosumi Account の billing account に紐づき、プランに応じたクォータが適用される。請求主体は operator account plane (リファレンス実装: Takosumi Accounts) / BillingPort であり、Workspace 単位の usage は Takosumi Account の invoice line item として集計される。詳しくは課金と Takosumi operator model を参照。

Workspace ​

Workspace の種類 ​

Git state ​

Role ​

Principal ​

Capability ​

課金との関係 ​

関連ドキュメント ​