@mastyf_ai/plugin-sdk

@mastyf_ai/plugin-sdk

Stable v3.0 detector plugin API for Mastyf AI.

pnpm add @mastyf_ai/plugin-sdk

import { createDetectorPlugin } from '@mastyf_ai/plugin-sdk';

export default createDetectorPlugin({
  name: 'acme-pii-scanner',
  version: '1.0.0',
  onLoad() { console.error('[acme] loaded'); },
  scanArguments(text, ctx) {
    if (/SSN-\d{3}-\d{2}-\d{4}/.test(text)) {
      return [{ type: 'ssn', location: ctx.location || 'args', severity: 'HIGH', redacted: 'SSN-[REDACTED]' }];
    }
    return [];
  },
});

Enable at runtime:

export MASTYF_AI_PLUGINS_ENABLED=true
export MASTYF_AI_PLUGIN_PATH=/path/to/built/plugins

See docs/PLUGIN_SDK.md for publishing and lifecycle details.