@brightsy/types

Shared TypeScript types for Brightsy applications: agents, chat, messages, tool calls, and plans.

Use this package in @brightsy/client, apps/web, apps/desktop, and other packages that need a single canonical shape for:

• Message – OpenAI/OpenRouter-style chat message (role, content, tool_calls, tool_call_id, usage)
• ToolCall / ToolDefinition – tool invocation and tool schema
• Agent – agent metadata (id, model, instructions, capabilities)
• Chat – conversation container
• Plan / PlanTodo – workflow plan and todo items

Install

pnpm add @brightsy/types

Usage

import type { Message, ToolCall, Agent, Plan } from '@brightsy/types';

Compatibility

Types are kept compatible with:

• OpenAI/OpenRouter API message and tool formats
• Existing @brightsy/client types (ChatMessage, Plan, etc.) so consumers can migrate gradually