@pinta-ai/types

Single source of truth for shared type definitions across the Pinta platform.

Defines the data structures exchanged between adapters (mcp-logger, etc.) and the backend (aware-backend).

Install

npm install @pinta-ai/types

Usage

import type { IngestTypeMap, IngestType, MCPSpan } from '@pinta-ai/types';

Core Types

| Type | Description | |------|-------------| | IngestTypeMap | Maps ingest.type values to span attribute interfaces | | IngestType | Union of supported ingest types ('mcp' \| ...) | | MCPSpan | Span attribute interface for the MCP adapter |

Adding a New Adapter

1. Define a span attribute interface in src/ingest.ts (e.g., PintaclawSpan)
2. Add mapping to IngestTypeMap (e.g., pintaclaw: PintaclawSpan)
3. Export from src/index.ts

Conventions

• Flat key-value structure only (serialized as OTel span attributes)
• Value types: string | number | boolean | undefined
• Every span interface must include an ingest.type field (discriminator)

License

MIT