wehub-resource-sync
426e9eeabd
Voice Workbench / headless workbench (mocked backends) (push) Has been cancelled
Voice Workbench / real acoustic lane (nightly, provisioned only) (push) Has been cancelled
ci / test (push) Has been cancelled
ci / lint-and-format (push) Has been cancelled
ci / build (push) Has been cancelled
ci / dev-startup (push) Has been cancelled
gitleaks / gitleaks (push) Has been cancelled
Markdown Links / Relative Markdown Links (push) Has been cancelled
Quality (Extended) / Homepage Build (PR smoke) (push) Has been cancelled
Quality (Extended) / Comment-only diff guard (push) Has been cancelled
Quality (Extended) / Format + Type Safety Ratchet (push) Has been cancelled
Quality (Extended) / Develop Gate (secret scan + UI determinism) (push) Has been cancelled
Quality (Extended) / Develop Gate (lint) (push) Has been cancelled
Chat shell gestures / Chat shell gesture + parity e2e (push) Has been cancelled
Cloud Gateway Discord / Test (push) Has been cancelled
Benchmark Bridge Tests / benchmark (bunx @biomejs/biome check packages/lifeops-bench/src, benchmark-lint) (push) Has been cancelled
Benchmark Bridge Tests / benchmark (bunx vitest run --config packages/lifeops-bench/vitest.config.ts --root packages/lifeops-bench --passWithNoTests, benchmark-tests) (push) Has been cancelled
Build Agent Image / build-and-push (push) Has been cancelled
Dev Smoke / bun run dev onboarding chat (push) Has been cancelled
Dev Smoke / Vite HMR dependency-level smoke (push) Has been cancelled
Electrobun Submodule Guard / electrobun gitlink is fetchable (push) Has been cancelled
Publish @elizaos/example-code / check_npm (push) Has been cancelled
Publish @elizaos/example-code / publish_npm (push) Has been cancelled
Publish @elizaos/plugin-elizacloud / verify_version (push) Has been cancelled
Publish @elizaos/plugin-elizacloud / publish_npm (push) Has been cancelled
Sandbox Live Smoke / Sandbox live smoke (push) Has been cancelled
Snap Build & Test / Build Snap (amd64) (push) Has been cancelled
Snap Build & Test / Build Snap (arm64) (push) Has been cancelled
Test Packaging / elizaos CLI global-install smoke (node + bun) (push) Has been cancelled
Cloud Gateway Webhook / Test (push) Has been cancelled
Cloud Tests / lint-and-types (push) Has been cancelled
Cloud Tests / unit-tests (push) Has been cancelled
Cloud Tests / integration-tests (push) Has been cancelled
Cloud Tests / e2e-tests (push) Has been cancelled
CodeQL Advanced / Analyze (javascript-typescript) (push) Has been cancelled
Deploy Apps Worker (Product 2) / Determine environment (push) Has been cancelled
Deploy Apps Worker (Product 2) / Deploy apps worker to apps-control host (${{ needs.determine-env.outputs.environment }}) (push) Has been cancelled
Deploy Eliza Provisioning Worker / Determine environment (push) Has been cancelled
Deploy Eliza Provisioning Worker / Deploy worker to Hetzner host (${{ needs.determine-env.outputs.environment }} @ ${{ needs.determine-env.outputs.deployment_sha }}) (push) Has been cancelled
Dev Smoke / Classify changed paths (push) Has been cancelled
supply-chain / sbom (push) Has been cancelled
supply-chain / vulnerability-scan (push) Has been cancelled
Build, Push & Deploy to Phala Cloud / build-and-push (push) Has been cancelled
Test Packaging / Validate Packaging Configs (push) Has been cancelled
Test Packaging / Build & Test PyPI Package (push) Has been cancelled
Test Packaging / PyPI on Python ${{ matrix.python }} (push) Has been cancelled
Test Packaging / Pack & Test JS Tarballs (push) Has been cancelled
UI Fixture E2E / ui-fixture-e2e (push) Has been cancelled
UI Fixture E2E / fixture-e2e (push) Has been cancelled
UI Story Gate / story-gate (push) Has been cancelled
vault-ci / test (macos-latest) (push) Has been cancelled
vault-ci / test (ubuntu-latest) (push) Has been cancelled
vault-ci / test (windows-latest) (push) Has been cancelled
vault-ci / app-core wiring tests (push) Has been cancelled
verify-patches / verify patches/CHECKSUMS.sha256 (push) Has been cancelled
Voice Benchmark Smoke / voice-emotion fixture smoke (push) Has been cancelled
Voice Benchmark Smoke / voiceagentbench fixture smoke (push) Has been cancelled
Voice Benchmark Smoke / voicebench-quality unit smoke (push) Has been cancelled
Voice Benchmark Smoke / voicebench TypeScript unit (no audio) (push) Has been cancelled
Voice Benchmark Smoke / voice bench smoke summary (push) Has been cancelled
Windows CI / windows ([bun run --cwd packages/app-core test bun run --cwd packages/elizaos test bun run --cwd packages/cloud/shared test], app-and-cli) (push) Has been cancelled
Windows CI / windows ([bun run --cwd packages/scenario-runner test bun run --cwd packages/vault test bun run --cwd packages/security test bun run --cwd plugins/plugin-coding-tools test], framework-packages) (push) Has been cancelled
Windows CI / windows ([bun run --cwd plugins/plugin-elizacloud test bun run --cwd plugins/plugin-discord test bun run --cwd plugins/plugin-anthropic test bun run --cwd plugins/plugin-openai test bun run --cwd plugins/plugin-app-control test bun run --cwd plugins/pl… (push) Has been cancelled
Windows CI / windows ([node packages/scripts/run-turbo.mjs run build --filter=@elizaos/core --filter=@elizaos/shared --filter=@elizaos/agent --concurrency=4 node packages/scripts/run-bash-linux-only.mjs scripts/verify-riscv64-buildpaths.sh node packages/scripts/run… (push) Has been cancelled
Windows CI / windows ([node packages/scripts/run-turbo.mjs run typecheck --filter=@elizaos/core --filter=@elizaos/shared --filter=@elizaos/cloud-shared --concurrency=4 bun run --cwd packages/core test bun run --cwd packages/shared test], core-runtime, 75) (push) Has been cancelled
71 lines
3.3 KiB
Markdown
71 lines
3.3 KiB
Markdown
# @elizaos/plugin-blocker
|
|
|
|
Focus / distraction control for Eliza agents: website blocking via a
|
|
SelfControl-style hosts engine and macOS / mobile app blocking. Exposes
|
|
two providers (`websiteBlocker`, `appBlocker`),
|
|
`WebsiteBlockerService` + `AppBlockerService`, a drizzle `pgSchema('app_blocker')`,
|
|
and a `focus` overlay view for the dashboard shell.
|
|
|
|
## Status
|
|
|
|
This plugin owns the focus/blocking platform, schema, providers, services, and
|
|
view. The `BLOCK` umbrella action is still registered by
|
|
`@elizaos/plugin-personal-assistant` because its owner gating, scheduler hooks,
|
|
and chat-oriented dispatch flow remain PA-resident. It is intentionally not
|
|
registered or exported here to avoid duplicate action registration.
|
|
|
|
## Migration mapping from `@elizaos/plugin-personal-assistant`
|
|
|
|
| New location (this plugin) | Source in `@elizaos/plugin-personal-assistant` |
|
|
|---|---|
|
|
| `src/providers/website-blocker.ts` | `plugins/plugin-personal-assistant/src/providers/website-blocker.ts` |
|
|
| `src/providers/app-blocker.ts` | `plugins/plugin-personal-assistant/src/providers/app-blocker.ts` |
|
|
| `src/services/website-blocker.ts` (`WebsiteBlockerService`) | `plugins/plugin-personal-assistant/src/website-blocker/` (`engine.ts`, `service.ts`, `access.ts`, `permissions.ts`, `public.ts`, `proactive-block-bridge.ts`, `roles.ts`, `chat-integration/`) |
|
|
| `src/services/app-blocker.ts` (`AppBlockerService`) | `plugins/plugin-personal-assistant/src/app-blocker/` (`engine.ts`, `access.ts`, `types.ts`) |
|
|
| `src/db/schema.ts` (`pgSchema('app_blocker')`) | new — there was no previous drizzle table; state lived in disk-backed engine files. The schema gives the services a persistent store and lets the runtime own migrations through `@elizaos/plugin-sql`. |
|
|
| `src/components/focus/FocusView.tsx` | new dashboard view for the extracted plugin. |
|
|
|
|
## Surface
|
|
|
|
### Providers
|
|
- `websiteBlocker` — active website block sessions and override state.
|
|
- `appBlocker` — active app block sessions and override state.
|
|
|
|
Both gate to `contexts: ["focus", "automation"]`.
|
|
|
|
### Services
|
|
- `WebsiteBlockerService` (`serviceType = "website-blocker"`)
|
|
- `AppBlockerService` (`serviceType = "app-blocker"`)
|
|
|
|
### Schema
|
|
- `pgSchema('app_blocker')` with tables:
|
|
- `block_rules` — host or bundle id rules per `(agentId, entityId)`.
|
|
- `active_sessions` — running block sessions with end timestamps.
|
|
- `allow_list` — exempted hosts / bundle ids per `(agentId, entityId)`.
|
|
|
|
### View
|
|
- `focus` — path `/focus`, component `FocusView`, bundled to
|
|
`dist/views/bundle.js` by `vite.config.views.ts`.
|
|
|
|
### Action
|
|
- None registered here. `BLOCK` is host-adapted by
|
|
`@elizaos/plugin-personal-assistant`.
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
bun run --cwd plugins/plugin-blocker typecheck # tsc --noEmit
|
|
bun run --cwd plugins/plugin-blocker lint # biome check src/
|
|
bun run --cwd plugins/plugin-blocker test # vitest run
|
|
bun run --cwd plugins/plugin-blocker build # build:js + build:views + build:types
|
|
bun run --cwd plugins/plugin-blocker clean # rm -rf dist
|
|
```
|
|
|
|
## Conventions
|
|
|
|
- Hard-depends on `@elizaos/plugin-sql` for migrations and `runtime.db`.
|
|
- Services log with the `[Blocker]` prefix.
|
|
- Two providers, one schema — the same shape as the other
|
|
decomposed lifeops plugins.
|
|
- See the root `AGENTS.md` for repo-wide architecture rules.
|