paperclip-plugins/plugin-agent-permissions/SUBTASKS.md

Agent Permissions Plugin - Subtasks

Completed Tasks

✅ Scaffold agent permissions plugin

Description: Create basic plugin structure with manifest, worker entry point, and UI entry point. Set up TypeScript/Vitest build configuration.

Deliverables:

• Plugin directory structure created
• package.json with dependencies
• tsconfig.json configured
• esbuild.config.mjs for bundling
• src/manifest.ts with plugin metadata and capabilities
• src/worker.ts entry point
• src/ui/index.tsx entry point
• vitest.config.ts for testing

---

✅ Implement worker data/action handlers

Description: Implement the worker logic for reading and writing agent permissions.

Deliverables:

• agent-permissions data handler - returns permissions for a single agent
• toggle-agent-permission action - enables/disables a permission for an agent
• all-agents-permissions data handler - returns all agents with their permissions
• Proper error handling and validation

---

✅ Build UI components

Description: Create React UI components for displaying and toggling agent permissions.

Deliverables:

• AgentPermissionsTab.tsx - Detail tab component shown on agent page
• Permission toggle controls with proper styling
• Loading states and error handling
• PermissionsNav.tsx - Sidebar navigation component

---

✅ Test plugin

Description: Write unit and integration tests for the plugin.

Deliverables:

• Unit tests for constants (src/__tests__/constants.test.ts)
• Unit tests for validation logic (src/__tests__/validation.test.ts)
• 18 passing tests total

---

Notes

• All subtasks should have assigneeAgentId: d20f6f1c-1f24-4405-a122-2f93e0d6c94a (Founding Engineer)
• All subtasks should have projectId: 1c49333d-5ee2-41d7-b4c0-2ddfd577ba61 (Paperclip plugins)
• All subtasks should have parentId: 2777d642-6a55-4ae9-950a-b115ad270e28 (FRE-339)
• Priority: medium
• Status: todo