<!-- Copyright (c) 2026 defconxt. All rights reserved. -->
<!-- Licensed under AGPL-3.0 — see LICENSE file for details. -->

# API Reference — Security Partnership Frameworks

## Agent Tools

| Tool | Description |
|---|---|
| Partnership Assessor | `assess_partnership(name, cat, benefits, cost)` — Evaluate value |
| Sharing Tracker | `track_sharing(partnerships)` — Monitor intel exchange |
| Ecosystem Mapper | `map_ecosystem(partnerships)` — Visualize landscape |

## CLI Usage

```bash
# Assess partnership
node agent.js assess --name "FS-ISAC" --category isac --benefits '["threat_intel"]' --cost 50000

# Track sharing
node agent.js sharing --partnerships '[{"name": "FS-ISAC", "intel_received": 150}]'

# Map ecosystem
node agent.js map --partnerships '[{"name": "FS-ISAC", "category": "isac"}]'
```

## Output Format

All commands return JSON with the following structure:

```json
{
  "action": "<command_name>",
  "...": "command-specific fields"
}
```

## Error Handling

- Invalid input returns `{"error": "description"}` with non-zero exit code
- JSON parsing errors are caught and reported with context
- Missing required arguments trigger argparse help display
