Takos Docs

テーマ切替

用語集 ​

アーキテクチャ ​

Control Plane ​

API, deploy/rollback/routing, run lifecycle, resource/binding 管理を担当する Takos のサーバー面。takos, takos-dispatch, takos-worker および container host 群で構成される。

Tenant runtime ​

deploy された artifact が実際にリクエストを処理する面。Cloudflare では Workers backend、local では Workers-compatible adapter 上で実行される。

Dispatch ​

hostname から routing target を解決し、tenant runtime へ request を振り分ける中間 worker (takos-dispatch)。WFP dispatch namespace と Routing DO を使って tenant request を正しい runtime へ渡す。

WFP (Workers for Platforms) ​

Cloudflare の dispatch namespace 機構。tenant worker を multi-tenant で管理するために使われる。

Adapter ​

control plane における local / Cloudflare の実行基盤差分を吸収する切り替え層。

Provider ​

deploy backend の種類。workers-dispatch (Cloudflare), oci, ecs, cloud-run, k8s をサポートする。

Snapshot ​

deployment ごとに固定される runtime config, bindings, env vars のセット。bindings と env vars は暗号化されて保存される。rollback や local 再現に使う。

Space / 構成 ​

Workspace / Space ​

所有・隔離の最上位単位。public surface では workspace、internal では space が canonical。user / team / system の種類を持つ。

Principal ​

membership の主体。user, space_agent, service, system, tenant_worker の種類がある。

Common Env ​

space レベルで共有される環境変数。service / worker に links として注入される。

Capability ​

space 内で service が使える権限。storage.read, egress.http, billing.meter など 12 種がある。

Deploy / Release ​

App Deployment ​

repo/ref から manifest と artifact provenance を束ねて作成される deploy の単位。API では /api/spaces/:spaceId/app-deployments が正本。

App Manifest (.takos/app.yml) ​

kind: App の single-document YAML。deploy 対象の service, resource, route, MCP, OAuth 等を宣言する正本。

Rollout ​

app deployment の段階的な公開プロセス。1% → 5% → 25% → 50% → 100% のステージで進み、pause / resume / abort / promote の制御を持つ。

Rollback ​

前の app deployment の状態に戻す操作。resource の即時削除やデータの巻き戻しは含まない。

Worker Bundle ​

tenant の canonical artifact 形式。Cloudflare Workers backend または Workers-compatible adapter 上で実行する。

Container Image ​

OCI provider 用の artifact 形式。Docker image として pull・起動される long-running HTTP service。

Canary ​

新しい deployment にトラフィックの一部だけを流す deploy strategy。routing_weight で割合を制御する。

Workflow Artifact ​

.takos/workflows/ 配下の workflow が出力する build 成果物。app deployment の artifact provenance として参照される。

Service / Resource ​

Repo ​

source と workflow artifact の起点。deploy の source provenance として使われる。

Worker ​

public surface での deployable unit。内部では Service の alias として扱われる。

Service ​

internal model での実行単位。current public manifest では worker service が正本。pending / building / deployed / failed / stopped の status を持つ。

Route ​

service への入口。hostname/path と deploy 時に結びつく。

Resource ​

service が利用する backing capability。D1, R2, KV, Vectorize, Queue, Analytics Engine, Workflow, Durable Object をサポートする。

Binding ​

service へ resource や他 service を渡す名前付き接続。

Custom Domain ​

service に紐づける独自ドメイン。DNS 検証と SSL 設定を経て有効化される。

App ​

deploy された application の identity。platform / builtin / custom の種類を持ち、service / route / resource / OAuth / MCP の reconcile 結果を保持する。

AI 実行 ​

Thread ​

継続する対話や作業コンテキスト。メッセージ列、summary、artifact が紐づく。active / archived / deleted の status を持つ。

Run ​

thread 上の 1 回の実行。pending → queued → running → completed / failed / cancelled のライフサイクルを持つ。

Artifact ​

run の結果物。code / config / doc / patch / report / other の型を持つ。

Agent Task ​

agent が計画・実行するタスク単位。thread/run と紐づき、plan と priority を持つ。

Memory ​

space に紐づく agent の記憶単位。episode / semantic / procedural の型を持ち、semantic search の対象になる。

Session ​

agent の runtime container 上の実行セッション。heartbeat と health check で監視される。

認証 / 課金 ​

PAT (Personal Access Token) ​

CLI / automation 用の認証トークン。tak_pat_... の形式を持つ。

Managed Token (TAKOS_ACCESS_TOKEN) ​

deploy された worker が Takos API を呼ぶために自動発行される内部トークン。spec.takos.scopes で権限を宣言する。

OAuth Client ​

Takos API へアクセスするサードパーティアプリの登録単位。manifest の spec.oauth から自動登録できる。

Scope ​

OAuth / Managed Token のアクセス権限の粒度。spaces:read, threads:write, agents:execute など。

OAuth でユーザーがアプリに付与した権限の許可レコード。一覧・取り消しが可能。

Billing Account ​

ユーザー単位の課金アカウント。plan (Free / Plus / PayG) に紐づく。

Meter ​

使用量の計測単位。llm_tokens_input, exec_seconds, wfp_requests など 10 種がある。

Quota ​

プランごとのメーター上限。超過すると書き込み系 API が 402 Payment Required で拒否される。

パッケージ / エコシステム ​

Store ​

ActivityPub ベースのリポジトリ発見・配布メカニズム。Store Actor を通じてリモートからリポジトリを発見・インストールできる。

Store Registry ​

space にリモートの Store を登録・管理する機能。outbox ポーリングで更新を検出する。

Seed Repository ​

space 作成時に初回クローンされるリポジトリ群。store registry とは独立した一度きりの仕組み。

MCP (Model Context Protocol) ​

repo がツールを公開する主要なプロトコル。manifest の spec.mcpServers で宣言する。

File Handler ​

storage/file 系 UI から app を開く contract。spec.fileHandlers で MIME type / 拡張子マッチングを宣言する。

インフラ ​

Runtime Host / Executor Host / Browser Host ​

container runtime の host worker 群。それぞれ runtime container, agent executor container, browser automation container を管理する。

OCI Orchestrator ​

local backend で Docker Engine API 経由の container lifecycle (pull/create/start/stop/remove) を管理するヘルパー。