dsh-typelens

When driving agents through DeepSeek Harness, a recurring friction is that an agent reading a file has no inherent understanding of the surrounding type structure, and an edit produces no immediate diagnostic feedback unless the developer manually invokes an LSP tool. TypeLens removes that extra step: after every successful file read it appends only the complete type declarations needed to understand the visible code, and after every edit it follows with bounded TypeScript diagnostics, new errors first.

All analysis happens locally. TypeLens makes no outbound requests and never persists source-bearing state. Output is ranked, deduplicated, cycle-safe, and never cut mid-signature. Multiple bounds keep results predictable: workspace scope, file size, timeout, recursion depth, result count, cache size, and token ceiling. A built-in circuit breaker pauses automatic analysis after repeated operational failures while still leaving explicit tools and the health endpoint available, so an analysis hiccup can never turn a successful file operation into a failure.

If you write TypeScript, JavaScript, TSX, or JSX through DSH and want agents to automatically gain type context and immediate post-edit diagnostics without remembering to call an LSP tool, TypeLens is a lightweight plugin built for that. It exposes four explicit tools (lookup a type, list bounded types, run diagnostics, inspect configuration and health state), lifecycle hooks, a health API, and a Web settings panel so you can dial in analysis behavior and limits to match your workflow.