81 lines
5.3 KiB
Markdown
81 lines
5.3 KiB
Markdown
|
---
|
||
|
|
kind: epic
|
||
|
|
slug: agent-participation
|
||
|
|
title: AI agent studio, marketplace, and chat participation
|
||
|
|
plan_slug: workspace-communications
|
||
|
|
status: ready
|
||
|
|
priority: P1
|
||
|
|
tenant_id: global
|
||
|
|
cursor_epic_id: null
|
||
|
|
updated_at: "2026-10-22"
|
||
|
|
---
|
||
|
|
|
||
|
|
# Epic objective
|
||
|
|
|
||
|
|
Turn the existing AI rail destination into a unified AI workspace where users switch between chatting with agents and creating/managing them through an AI-assisted studio and agent marketplace. Workspace-scoped agents can then join channels, respond to explicit invocations, use approved tools, and stream normalized run events without coupling the UI to a provider or execution runtime.
|
||
|
|
|
||
|
|
## In scope / out of scope
|
||
|
|
|
||
|
|
**In scope**
|
||
|
|
|
||
|
|
- A single `/<workspaceSlug>/ai` destination with URL-backed `Chat` and `Agents` tabs.
|
||
|
|
- A shared composer shell whose behavior changes by tab: conversation in Chat and natural-language agent building in Agents.
|
||
|
|
- A workspace agent registry and marketplace library for templates, installed agents, workspace-created agents, drafts, and new-agent entry points.
|
||
|
|
- AI-assisted agent drafting that produces editable structured configuration before explicit save/install/publish actions.
|
||
|
|
- Agent identities, channel membership, mention resolution, and invocation policy.
|
||
|
|
- Durable agent jobs with claim, retry, cancellation, budget, and idempotency semantics.
|
||
|
|
- A normalized harness event contract for text, tools, approvals, failures, and completion.
|
||
|
|
- Streaming agent state to chat and persisting the final response and run linkage.
|
||
|
|
|
||
|
|
**Out of scope**
|
||
|
|
|
||
|
|
- Autonomous reading of every channel by default.
|
||
|
|
- A chat-specific model registry.
|
||
|
|
- Installing or publishing marketplace agents without an explicit review/confirmation step.
|
||
|
|
- Public ratings, billing, or cross-workspace commercial distribution in the first release.
|
||
|
|
- Bypassing workspace model policy or tenant-scoped MCP authorization.
|
||
|
|
|
||
|
|
## Related tasks
|
||
|
|
|
||
|
|
| Task | Link |
|
||
|
|
|------|------|
|
||
|
|
| Build the AI Chat/Agents workspace shell | `./Task-ai-workspace-tabs.md` |
|
||
|
|
| Define the versioned agent registry schema and contracts | `./Task-agent-registry-marketplace.md` |
|
||
|
|
| Expose the shared catalog and private draft API | `./Task-agent-registry-api.md` |
|
||
|
|
| Enforce reviewed installation and lifecycle | `./Task-agent-install-lifecycle.md` |
|
||
|
|
| Build the agent marketplace library UI | `./Task-agent-marketplace-library-ui.md` |
|
||
|
|
| Generate structured agent drafts with AI | `./Task-ai-assisted-agent-builder.md` |
|
||
|
|
| Edit and persist AI-generated private drafts | `./Task-agent-builder-editor-drafts.md` |
|
||
|
|
| Review, test, and activate agent drafts | `./Task-agent-builder-review-sandbox.md` |
|
||
|
|
| Add durable chat-agent jobs | `./Task-agent-identities-and-jobs.md` |
|
||
|
|
| Chat directly with saved agents | `./Task-direct-agent-chat.md` |
|
||
|
|
| Add agents to workspace channels | `./Task-agent-channel-membership.md` |
|
||
|
|
| Normalize harness run events | `./Task-agent-harness-chat-streaming.md` |
|
||
|
|
| Stream and finalize agent runs in chat | `./Task-agent-chat-run-delivery.md` |
|
||
|
|
|
||
|
|
## Dependencies
|
||
|
|
|
||
|
|
- The AI workspace shell and registry can begin from the existing AI route, model routing, harness registry, template UI patterns, and current AI SDK chat endpoint.
|
||
|
|
- Registry schema → registry API → install/lifecycle are explicit server slices. Library/editor/review UIs consume those APIs. All AI selectors, builders, mentions and jobs share this registry, never a channel-local agent identity.
|
||
|
|
- Durable jobs depend on registry/lifecycle. Direct-agent chat and reviewed channel membership depend on jobs; workspace membership integration needs chat persistence, while project/object participation also waits for authoritative contextual authorization. Unified notifications consumes outcomes later rather than blocking permission enforcement. Harness execution and shared delivery follow these contracts.
|
||
|
|
- Full product includes mention-to-add with authorized confirmation, scoped history/tools, idempotency and revocation per the parent plan. Current AI convoy delivers only shell, schema/contracts and inert builder service. On 2026-10-22 the user approved kickoff and the independent shell implementer is active; no other role completion, DB transition, merge or release is asserted.
|
||
|
|
- Blocks: richer approval cards, marketplace publishing, and autonomous channel workflows.
|
||
|
|
|
||
|
|
## Acceptance criteria
|
||
|
|
|
||
|
|
- [ ] The existing AI rail destination exposes accessible, deep-linkable Chat and Agents tabs without adding another rail item.
|
||
|
|
- [ ] The Agents tab presents templates, installed/workspace agents, drafts, and creation entry points as a coherent library.
|
||
|
|
- [ ] A natural-language request creates an editable agent draft; nothing is installed, published, or granted tools until the user reviews and confirms it.
|
||
|
|
- [ ] Explicitly mentioning an authorized agent creates one idempotent durable job.
|
||
|
|
- [ ] Chat and the builder request roles/capabilities and do not select providers directly.
|
||
|
|
- [ ] Harness adapters emit one normalized event protocol regardless of runtime.
|
||
|
|
- [ ] Tool calls and generated messages preserve workspace authorization and audit linkage.
|
||
|
|
- [ ] Approval-required, failed, and completed runs notify the initiating user.
|
||
|
|
|
||
|
|
## Proposed timeline
|
||
|
|
|
||
|
|
| Phase | Window | Notes |
|
||
|
|
|-------|--------|-------|
|
||
|
|
| Identity and jobs | 1 | Persistence, mention policy, queue semantics |
|
||
|
|
| Harness integration | 2 | Normalized events, streaming, finalization |
|