feat(agent): add addRouter method for custom HTTP routes

[Scra3]

Summary

• Add agent.addRouter() method allowing developers to define custom HTTP routes
• Support authenticated routes (default) that run after Forest Admin auth middleware
• Support public routes (authenticated: false) that run before auth
• Provide context with dataSource, services, options, and logger
• Optional prefix option for route prefixing

Usage Examples

Simple authenticated route

agent.addRouter((router, context) => {
  router.get('/stats', async (ctx) => {
    const users = await context.dataSource
      .getCollection('users')
      .list(caller, new PaginatedFilter({}), new Projection('id'));
    ctx.body = { count: users.length };
  });
});

Public route (no auth)

agent.addRouter(
  (router) => {
    router.get('/health', (ctx) => {
      ctx.body = { status: 'ok' };
    });
  },
  { authenticated: false }
);

Test plan

• Test route type returns CustomRoute when authenticated (default)
• Test route type returns PublicCustomRoute when authenticated=false
• Test callback receives router and context
• Test context provides dataSource, services, options, logger
• Test prefix is applied correctly
• Test addRouter returns agent for chaining
• Test multiple addRouter calls work

🤖 Generated with Claude Code

[qltysh]

2 new issues

Tool	Category	Rule	Count
qlty	Structure	Function with high complexity (count = 19): addAi	1
qlty	Structure	Function with many parameters (count = 5): constructor	1

[qltysh]

Coverage Impact

⬆️ Merging this pull request will increase total coverage on main by 0.01%.

Modified Files with Diff Coverage (4)

Rating	File	% Diff	Uncovered Line #s
	packages/agent/src/agent.ts	100.0%
	packages/agent/src/types.ts	100.0%
	packages/agent/src/routes/custom/custom-route.ts	100.0%
	packages/agent/src/routes/custom/custom-router-context.ts	100.0%
	Total	100.0%

🚦 See full report on Qlty Cloud »

🛟 Help

• Diff Coverage: Coverage for added or modified lines of code (excludes deleted files). Learn more.

• Total Coverage: Coverage for the whole repository, calculated as the sum of all File Coverage. Learn more.

• File Coverage: Covered Lines divided by Covered Lines plus Missed Lines. (Excludes non-executable lines including blank lines and comments.)

  • Indirect Changes: Changes to File Coverage for files that were not modified in this PR. Learn more.