Kandev Agent
c53f699714
- go plugin backends ship as release tarballs (per-platform binaries, checksums) that kandev installs from url/upload or filesystem sideload+sync, then spawns and supervises via hashicorp/go-plugin (unix socket / loopback tcp+automtls) - strict typed grpc contract (kandev.plugin.v1): DeliverEvent/InvokeTool/HandleWebhook plus a capability-gated host service (state, secrets, emit); author sdk in pkg/pluginsdk; packaging cli in cmd/plugin-pack - native frontend bundles: window.registerKandevPlugin + registry/host loader with dynamic routes, nav items, slots and ws handlers; plugins settings page with install dialog, sync button and enable/disable/uninstall - gated behind the plugins feature flag (prod off, dev/e2e on); covered by unit and integration tests plus playwright e2e against a real packaged fixture plugin Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
52 lines
1.9 KiB
Markdown
52 lines
1.9 KiB
Markdown
---
|
|
id: task-11
|
|
title: Plugins API client + Zustand slice
|
|
status: pending
|
|
wave: 3
|
|
depends_on: [task-09]
|
|
plan: docs/plans/plugins/plan.md
|
|
---
|
|
|
|
# Plugins API client + Zustand slice
|
|
|
|
## Title
|
|
Frontend REST client for `/api/plugins/*` and a Zustand `plugins` slice with unit
|
|
tests.
|
|
|
|
## Inputs
|
|
- Backend API from task-09 (management endpoints + `GET /api/plugins/tools`).
|
|
- Client convention: `apps/web/lib/api/domains/jira-api.ts` (+ `linear-api.ts` and
|
|
its `linear-api.test.ts`). Match fetch/error handling + typing style.
|
|
- Slice convention: `apps/web/lib/state/slices/jira/` and `linear/`. Register the
|
|
new slice in `apps/web/lib/state/slices/index.ts` and `apps/web/lib/state/store.ts`
|
|
(add `createPluginsSlice`).
|
|
- Types shared with backend DTOs (plugin id, display_name, status, categories,
|
|
capabilities, tools, ui.pages).
|
|
|
|
## Acceptance
|
|
1. `apps/web/lib/api/domains/plugins-api.ts`: `listPlugins()`, `getPlugin(id)`,
|
|
`registerPlugin(manifestYaml)`, `updatePluginConfig(id, config)`,
|
|
`enablePlugin(id)`, `disablePlugin(id)`, `uninstallPlugin(id)`,
|
|
`listPluginTools()`. Typed responses.
|
|
2. `apps/web/lib/state/slices/plugins/`: `plugins-slice.ts` (state: `plugins[]`,
|
|
`loading`, `error`; actions: `loadPlugins`, `setPlugins`, `upsertPlugin`,
|
|
`removePlugin`), `types.ts`, wired into store.
|
|
3. Unit tests: `plugins-api.test.ts` (mock fetch, assert URLs/methods/error paths),
|
|
`plugins-slice.test.ts` (state transitions).
|
|
|
|
## Files
|
|
- `apps/web/lib/api/domains/plugins-api.ts` + `plugins-api.test.ts`
|
|
- `apps/web/lib/state/slices/plugins/plugins-slice.ts` + `types.ts` + `plugins-slice.test.ts`
|
|
- edits: `apps/web/lib/state/slices/index.ts`, `apps/web/lib/state/store.ts`
|
|
|
|
## Verification
|
|
- `cd apps/web && pnpm run typecheck && pnpm test -- plugins`
|
|
- `cd apps/web && pnpm lint`
|
|
|
|
## Output contract
|
|
Report: client method list, slice shape, store wiring points. Follow apps/web/AGENTS.md
|
|
lint limits. Do not build the page (task-12).
|
|
|
|
## Dependencies
|
|
task-09.
|