@smartpointstech/sptflo-tools

SPTFlo tools - plugins, codex, guidance, testing, deployment, AI defence, browser automation, and agent definitions

Overview

This package consolidates the SPTFlo tooling ecosystem into a single module. It provides a plugin SDK with lifecycle management and hook systems, a codex for agent knowledge, guidance for prompt engineering, testing utilities, deployment automation, AI defence mechanisms, and browser automation capabilities. Each domain is available as a separate subpath export.

Installation

npm install @smartpointstech/sptflo-tools

Key Features

• Plugin SDK -- PluginBuilder with hooks, workers, LLM providers, MCP tools, and security
• Codex -- agent knowledge base and retrieval system
• Guidance -- prompt engineering and agent guidance templates
• Testing -- test harnesses and assertion utilities for agent workflows
• AI Defence -- adversarial detection and input sanitization
• Browser Automation -- headless browser control for web-based agent tasks

Dependencies

Key internal dependencies:

• @smartpointstech/sptflo-shared -- shared types and utilities
• @smartpointstech/sptflo-engine (optional) -- engine integration
• @smartpointstech/sptflo-memory (optional) -- persistent memory
• @smartpointstech/learning-wasm (optional) -- WASM learning module
• fs-extra -- enhanced filesystem operations

Quick Start

import { plugins } from '@smartpointstech/sptflo-tools';

const myPlugin = new plugins.PluginBuilder('my-plugin', '1.0.0')
  .withDescription('My plugin')
  .withMCPTools([/* tools */])
  .withHooks([/* hooks */])
  .build();

API Reference

Module Exports

Export	Type	Description
plugins	namespace	Plugin SDK: PluginBuilder, HookEvent, WorkerFactory, ProviderFactory
codex	namespace	Agent knowledge base and retrieval
guidance	namespace	Prompt engineering and guidance templates
testing	namespace	Test harnesses for agent workflows
deployment	namespace	Deployment automation utilities
aidefence	namespace	Adversarial detection and input sanitization
browser	namespace	Headless browser automation