Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Provider plugins v2, daemon ownership and host environment (umbrella)

オープン
  • 何か問題がありますか？
#3,747 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
8/100
issue の種類
リファクタリング
明瞭さ
説明が足りない
活発さ
活発
技術スタック
node.js, typescript
領域
backend, devtools

調査の方向性

This is a tracking umbrella with no code change of its own; the work sits in the child issues listed in the checklist (#3748 to #3759). The unblocked starting points are #3748 (refuse leases for providers without a registered runtime) and #3749 (HostEnvironment captured once at entry points), and the payload names no files or tests. Done means each child lands additively in 0.21.x and the external acceptance items are met.

索引モデルが issue の本文から書いたものです。

説明

enhancement

Purpose

One provider plugin contract loaded three ways, an explicit owner for every daemon, and a daemon that reads no process globals.

The three ways a plugin loads:

  • built-in providers;
  • agent-device plugins add (the store);
  • a JS host that imports the plugin package as an ordinary npm dependency.

This replaces the current workaround in e2e's @e2e-dev/testmu. It fakes the plugin store: it symlinks the package into plugins/<uuid>/node_modules, writes a private AGENT_DEVICE_HOME, and lets a client start a detached daemon implicitly.

Release rule

Every child lands additively in 0.21.x. Superseded shapes keep working until #3759 removes them in 0.22.

Children

  • #3748 — refuse leases for providers without a registered runtime
  • #3749 — HostEnvironment captured once at entry points (foundation)
  • #3750 — HostEnvironment in platform and capture packages (blocked by #3749)
  • #3751 — HostEnvironment in root src and remaining packages (blocked by #3749)
  • #3752 — daemon runtime owns no process globals; ShutdownReport (blocked by #3749)
  • #3794 — explicit host for configuration reads; one entered runtime store (follow-up to #3763/#3772)
  • #3753 — gate: no process globals outside entry points (after #3794 part 1) (blocked by #3750, #3751, #3752)
  • #3754 — explicit daemon lifecycle: ensureDaemon() and attach clients
  • #3755 — plugin contract v2, one provider registry, inventory, ADR 0034 (blocked by #3748)
  • #3756 — @agent-device/testmu on plugin contract v2 (blocked by #3755)
  • #3757 — agent-device/host startAgentDevice() (blocked by #3772 and the HostEnvironment PRs #3763/#3775/#3777; design pass done 2026-10-17)
  • #3758 — proposal: per-lease provider options (not scheduled)
  • #3759 — 0.22 removals (blocked by all of the above and #3311)

Decisions (maintainer, 2026-10-16)

  • Plugins are factories called with options. A store install passes config.json options; a JS host calls testmu({ credentials }) directly.
  • No module-URL identity. Nothing relies on import.meta.url.
  • No Effect dependency.
  • { webDriver } stays a data descriptor. Plugins import only types from agent-device.
  • One registry. Sources compose in the order built-in → store → embedder. A plugin that fails is listed, not fatal.
  • The plugin set is fixed for a daemon's lifetime.
  • Clients never manage the daemon implicitly. Starting or replacing one is an explicit ensureDaemon() call. Embedders own their daemon through agent-device/host.
  • The ADR is brief. ADR 0034 records the plugin registry, with only a short note on daemon ownership.

External acceptance

  • e2e: tester-army/e2e migrates @e2e-dev/testmu and @e2e-dev/limrun to agent-device/host, deleting installPlugin and the CLI-based daemon stop. That work is tracked in e2e after #3757 ships.
  • #3311: the Limrun extraction ships @agent-device/limrun on the v2 contract from #3755.
主要言語
TypeScript
スター
5.1k
フォーク
339
平均マージ
12時間 57分
マージ済み PR（30日）
653

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

callstack/agent-device のほかの issue

callstack/agent-device の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。