dsh-cc-monitor

dsh-cc-monitor

A host-side DSH plugin that reports session activity to a cc-monitor server. It maps DSH session events to the same normalized hook payloads the server already accepts, then POSTs them to /api/event with agent: dsh.

Install

dsh plugin --profile web add link:/path/to/cc-monitor/dsh-cc-monitor

Then make sure the profile's package.json lists dsh-cc-monitor in dsh.profile.bundles (the dsh plugin add command normally handles this for out-of-tree bundles; verify with dsh --profile web --dump-config).

First npm publish: npm Trusted Publishing can only publish subsequent versions once the package already exists. Publish the first version once from a machine with npm login (npm login && npm publish --access public), then the GitHub Actions trusted-publisher job can publish future versions.

Configuration

Defaults are designed for a local cc-monitor server on 127.0.0.1:9876. Override them with environment variables or a patch entry:

- insert:
    - id: cc-monitor
      name: 'dsh-cc-monitor'
      config:
        # Full override; host/port below are ignored when this is set.
        serverUrl: 'https://192.168.1.100:9876'
        # Or configure host + port separately:
        # host: '192.168.1.100'
        # port: 9876
        uid: 'my-dsh-instance'

If serverUrl is set, port overrides its port. If serverUrl is omitted, host + port are used to build http://<host>:<port>.

How it maps