How armourpiercer1/dsh-agent-team works
DSH Agent Team vNext is an external plugin that manages team sessions without modifying the host or putting team control-plane facts in session events. The main workflow runs from model-callable tools or the client UI through runtime authorization and orchestration, with durable state owned by TeamDomain; remote projection feeds serve external consumers. Contracts and pure domain rules support these stages. The README documents package boundaries, while sampled source confirms selected runtime, storage, and transport relationships; unsampled implementation links are omitted rather than inferred.
Main entry points: router.ts Action Router · service.ts Control Service · team-remote-client.ts Remote Client · index.ts Storage Schema
Components 24
Contracts
- Shared Contracts
packages/contracts/src/index.ts - Team Session DTO
packages/contracts/src/dto/team-session-record.ts
Domain Rules
- Blueprint Validation
packages/domain/blueprint/src/validate.ts - Policy Resolution
packages/domain/policy/src/resolve.ts - Compatibility Checks
packages/domain/compatibility/src/engine.ts
Runtime
- Action Router
packages/runtime/action-router/router.ts - Control Service
packages/runtime/control/service.ts - Governance Service
packages/runtime/governance/service.ts - Proposal Store
packages/runtime/governance/proposal-store.ts - Handoff Service
packages/runtime/handoff/service.ts - Projection Service
packages/runtime/projection/service.ts
TeamDomain Storage
- Storage Schema
packages/storage/schema/index.ts - Session Bindings
packages/storage/bindings/binding-service.ts - Team Sessions
packages/storage/repositories/team-sessions.ts
Tools And Clients
- Team Tools
packages/tools/src/tools.ts - Remote Handlers
packages/remote/src/handlers/team.ts - Remote Contract
packages/remote/src/contracts/params.ts - Client Plugin
packages/client/src/plugin/client.ts - Team Mount Core
packages/client/src/plugin/team-mount-core.ts - Remote Client
packages/client/src/transport/team-remote-client.ts - Projection Store
packages/client/src/state/team-projection-store.ts - Team UI
packages/client/src/ui/TeamView.tsx
Other components
- Team User
- Remote Consumers
Connections 17
- Team User → Team Tools: invokes tools
- Team Tools → Action Router: routes actions
- Action Router → Control Service: calls control
packages/runtime/action-router/router.ts - Action Router → Blueprint Validation: uses blueprint rules
packages/runtime/action-router/router.ts - Action Router → Shared Contracts: uses contracts
packages/runtime/action-router/router.ts - Control Service → Proposal Store: uses proposal store
packages/runtime/control/service.ts - Control Service → Storage Schema: uses schema
packages/runtime/control/service.ts - Governance Service → Proposal Store: records proposals
packages/runtime/governance/service.ts - Governance Service → Policy Resolution: resolves policy
packages/runtime/governance/service.ts - Session Bindings → Storage Schema: uses schema
packages/storage/bindings/binding-service.ts - Team Sessions → Storage Schema: uses schema
packages/storage/repositories/team-sessions.ts - Client Plugin → Team Mount Core: mounts plugin
packages/client/src/plugin/client.ts - Remote Client → Remote Contract: uses remote API
packages/client/src/transport/team-remote-client.ts - Remote Client → Projection Store: updates projection
packages/client/src/transport/team-remote-client.ts - Team UI → Remote Client: uses remote client
- Remote Handlers → Remote Contract: parses requests
- Remote Consumers → Remote Handlers: reads projections