search-price@1.2.0 が価格を検索し、transform がそれを整形し、条件付きの http.post がシークレット webhook に通知します。
用語
| 用語 | 定義 |
|---|---|
| Capability | Tool に使用が許可される、名前付きの効果です。net、fs、browser、clock、random、env、spawn、secrets のいずれかです。Rider は宣言された capabilities だけを正確に注入し、それ以上は注入しないため、何も宣言しない Tool は純粋関数になります。ドメインモデル と 実行 を参照してください。 |
| Composite tool | Flow を 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 model と Authoring を参照してください。 |
| FlowSpec | Flow のコンパイル先となる、単一の正準な 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 compile と browserflow pack add によって書き込まれます。Tools & Packs を参照してください。 |
| Journal | Run の step lifecycle event(step_started、step_succeeded、effect_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 を参照してください。 |
| Pack | Tool と Flow の、バージョン付き content-addressed bundle です。プロジェクトの「SDK」であり、デプロイ、バージョン管理、複製の単位です。一度取得し、すべての digest を検証すれば、以後は永続的にオフラインで実行できます。Tools & Packs を参照してください。 |
| PackManifest | Pack の manifest(pack.json)です。名前、バージョン、含まれるすべての Tool と Flow の digest による一覧、pin された依存関係、そして manifest 自身の不変 identity としての sha256 digest を含みます。スキーマ と ドメインモデル を参照してください。 |
| Provenance | ToolContract の 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 を参照してください。 |
| Registry | Pack が公開、バージョン管理、解決される場所です。ローカル registry はディレクトリで、チーム registry はコントロールプレーンです。Registry 同士は digest によって検証されながら相互に複製されます。ToolsとPacks と コントロールプレーン を参照してください。 |
| Rider | 実行エンジンです。実際に何かを実行する唯一の component であり、model は実行しません。FlowSpec、具体的な入力、注入された capabilities(RunDeps)を受け取り、Journal を持つ Run を生成します。実行 を参照してください。 |
| Run | 具体的な入力に対する FlowSpec の1回の実行です。Journal、status、最終出力を持ちます。Journal によって Run は再開可能かつ検査可能になります。ドメインモデル と 実行 を参照してください。 |
| RunDeps | Rider が必要とするすべてのものです。import ではなく注入されます。store、journal、tools、clock、random、secrets、env、logger、任意の signal が含まれます。実装を差し替えることで、エンジンがどこで実行されるかが変わります。実行 を参照してください。 |
| Secret (boundary) | 値ではなく境界です。secret: true 入力は FlowSpec、Journal、log、Pack のいずれにも現れません。secrets capability を持つ Tool が実行時に解決するまで、参照としてのみ運ばれます。taint rule は、secret. 参照が任意の演算子、メンバーアクセス、または secrets ではない Tool を通過することを静的に禁止します。シークレット を参照してください。 |
| Step | Flow 内での Tool の1回の呼び出しです。id、use ref、input bindings(with)、宣言または推論された needs、任意の when / retry / timeout_ms / foreach policy を持ちます。Domain model と Control flow を参照してください。 |
| Tool | Step が呼び出せる最小の再利用単位です。入力と記録済み効果が与えられれば決定論的であり、自ら判断せず、実行だけを行います。ToolContract と run function によって定義され、factory として作成されます。Kinds は browser、http、shell、transform、code、model、composite です。Tools & Packs を参照してください。 |
| ToolContract | Tool の型付き interface です。name、version、kind、description、型付きの inputs / output、宣言された capabilities、provenance を含みます。型付き I/O はオーサリング時にチェックされ、実行時に検証されます。capabilities は Tool が使用できる効果を制限します。スキーマ と ドメインモデル を参照してください。 |
関連
ドメインモデル
7つの名詞とそのスキーマを、一度だけ定義しています。
アーキテクチャ
Pack、Rider、Launcher が実行時にどのように合成されるか。
スキーマ
このページのすべての用語を支える Zod スキーマ。