browser-flow のすべての名詞には、定義が1つだけあります。このページはアルファベット順の索引で、各用語はその詳細を完全に定義しているページにリンクしています。ドキュメント全体で使う標準例は daily-price-watch Flow です。ブラウザ Tool search-price@1.2.0 が価格を検索し、transform がそれを整形し、条件付きの http.post がシークレット webhook に通知します。

用語

用語定義
CapabilityTool に使用が許可される、名前付きの効果です。netfsbrowserclockrandomenvspawnsecrets のいずれかです。Rider は宣言された capabilities だけを正確に注入し、それ以上は注入しないため、何も宣言しない Tool は純粋関数になります。ドメインモデル実行 を参照してください。
Composite toolFlow を Tool として再公開し、Flow をネストできるようにしたものです。その capabilities は内側にあるすべての Tool の capabilities の和集合です(ネストによって効果が隠れることはありません)。また、外側の secret: true 入力は、内側の Flow に参照として渡されます。Domain model を参照してください。
Content-addressed可変のタグではなく、正準内容の sha256 digest によって識別されることです。FlowSpec、ToolContract、Recording、Journal output、Pack はすべて content-addressed であり、これによって検証と複製の信頼性が成り立ちます。FlowSpec IR を参照してください。
Digest正準化された artifact(ソート済みのキー、正規化済みの式、解決済みのバージョン)の sha256 ハッシュです。FlowSpec の digest は、キャッシュ、pin、複製における identity です。Tool の contract digest は、その入力、出力、または capabilities が変わるたびに変わります。FlowSpec IR を参照してください。
Flow型付きの input contract と型付きの output projection を持ち、SDK または YAML で一度だけ作成される、Step の名前付き DAG です。制御フローは宣言的で、branch、foreach、parallel、nesting を使います。Flow は FlowSpec にコンパイルされます。Domain modelAuthoring を参照してください。
FlowSpecFlow のコンパイル先となる、単一の正準な content-addressed IR です。どちらのオーサリング方式も FlowSpec を生成し、FlowSpec は YAML にラウンドトリップできます。正準化され、sha256 digest にハッシュされます。FlowSpec IR を参照してください。
Idempotency key呼び出しごとに安定したキー、hash(run_id, step_id, inputs_digest) です。試行回数を意図的に除外しているため、同じ論理呼び出しのすべての retry は同じキーを持ちます。効果を持つ Tool はそれを(たとえば Idempotency-Key header として)そのまま渡せるため、retry された実行が二重に発火しません。実行 を参照してください。
browserflow.lockすべての tool ref について、解決済みの正確なバージョンおよび contract digest{ "entries": [{ref, version, contract_digest}] })を記録する lockfile です。そのため、同じ lockfile からコンパイルする2台のマシンは、バイト単位で同一の Tool を解決します。browserflow compilebrowserflow pack add によって書き込まれます。Tools & Packs を参照してください。
JournalRun の step lifecycle event(step_startedstep_succeededeffect_recorded、…)に、解決済み入力と最終出力を加えた、追記専用で順序付きの content-addressed log です。Journal によって Run は再開可能かつ検査可能になります。実行 を参照してください。
Launcherある環境向けの capabilities を構築し、Rider を呼び出す薄いホストです。browserflow run(CLI)、HTTP route(REST)、MCP tool(agents)、cron tick、CI step などがあります。同じ FlowSpec は、どの Launcher の下でも変更なしに実行されます。Launcher を参照してください。
PackTool と Flow の、バージョン付き content-addressed bundle です。プロジェクトの「SDK」であり、デプロイ、バージョン管理、複製の単位です。一度取得し、すべての digest を検証すれば、以後は永続的にオフラインで実行できます。Tools & Packs を参照してください。
PackManifestPack の manifest(pack.json)です。名前、バージョン、含まれるすべての Tool と Flow の digest による一覧、pin された依存関係、そして manifest 自身の不変 identity としての sha256 digest を含みます。スキーマドメインモデル を参照してください。
ProvenanceToolContract の provenance record です。Tool 本体を作成したもの(たとえば記録されたブラウザセッション)を content-addressing する source_digest と、その pack を含みます。これにより Tool は pin 可能かつ監査可能になります。Domain model を参照してください。
Recordingオーサリング時に browser.record が取得した、順序付きで解決済みの Playwright operations と DOM evidence です。Recording は正準化され content-addressed になり、その digest がブラウザ Tool の provenance.source_digest になります。Browser tools を参照してください。
RegistryPack が公開、バージョン管理、解決される場所です。ローカル registry はディレクトリで、チーム registry はコントロールプレーンです。Registry 同士は digest によって検証されながら相互に複製されます。ToolsとPacksコントロールプレーン を参照してください。
Rider実行エンジンです。実際に何かを実行する唯一の component であり、model は実行しません。FlowSpec、具体的な入力、注入された capabilities(RunDeps)を受け取り、Journal を持つ Run を生成します。実行 を参照してください。
Run具体的な入力に対する FlowSpec の1回の実行です。Journal、status、最終出力を持ちます。Journal によって Run は再開可能かつ検査可能になります。ドメインモデル実行 を参照してください。
RunDepsRider が必要とするすべてのものです。import ではなく注入されます。storejournaltoolsclockrandomsecretsenvlogger、任意の signal が含まれます。実装を差し替えることで、エンジンがどこで実行されるかが変わります。実行 を参照してください。
Secret (boundary)値ではなく境界です。secret: true 入力は FlowSpec、Journal、log、Pack のいずれにも現れません。secrets capability を持つ Tool が実行時に解決するまで、参照としてのみ運ばれます。taint rule は、secret. 参照が任意の演算子、メンバーアクセス、または secrets ではない Tool を通過することを静的に禁止します。シークレット を参照してください。
StepFlow 内での Tool の1回の呼び出しです。iduse ref、input bindings(with)、宣言または推論された needs、任意の when / retry / timeout_ms / foreach policy を持ちます。Domain modelControl flow を参照してください。
ToolStep が呼び出せる最小の再利用単位です。入力と記録済み効果が与えられれば決定論的であり、自ら判断せず、実行だけを行います。ToolContractrun function によって定義され、factory として作成されます。Kinds は browserhttpshelltransformcodemodelcomposite です。Tools & Packs を参照してください。
ToolContractTool の型付き interface です。nameversionkinddescription、型付きの inputs / output、宣言された capabilitiesprovenance を含みます。型付き I/O はオーサリング時にチェックされ、実行時に検証されます。capabilities は Tool が使用できる効果を制限します。スキーマドメインモデル を参照してください。
有用なメンタルモデルは次のとおりです。FlowFlowSpec(1つの digest)にコンパイルされます。RiderLauncher の下でその FlowSpec を RunJournal 付き)として実行します。ToolsPacks に含まれ、Registry から提供され、browserflow.lock に pin されます。

関連

ドメインモデル

7つの名詞とそのスキーマを、一度だけ定義しています。

アーキテクチャ

Pack、Rider、Launcher が実行時にどのように合成されるか。

スキーマ

このページのすべての用語を支える Zod スキーマ。