Types

All shared TypeScript types are exported from @openconduit/core.

import type { Conversation, AppNotification, AppSettings } from '@openconduit/core';

Core Types

Conversation

interface Conversation {
  id: string;
  title: string;
  messages: Message[];
  providerId: string;
  model: string;
  routingProfileId?: string;
  personaId?: string;
  createdAt: number;
  updatedAt: number;
}

Message

interface Message {
  id: string;
  role: 'user' | 'assistant' | 'system';
  content: string;
  createdAt: number;
  usage?: TokenUsage;
  toolCalls?: ToolCall[];
}

AppNotification

In-app notification. Kept serializable so extension callers (#38) can fire via IPC.

interface AppNotification {
  id: string;
  title: string;
  message?: string;
  variant: 'info' | 'success' | 'warning' | 'error';
  timestamp: number;
  read: boolean;
  source?: string; // extension id, or 'app' for built-in
}

AppSettings

interface AppSettings {
  defaultProviderId: string;
  defaultModel: string;
  providers: ProviderConfig[];
  mcpServers: McpServerConfig[];
  routing: RoutingConfig;
  routingProfiles: RoutingProfile[];
  // ... see types.ts for full definition
}

Provider Types

ProviderConfig

interface ProviderConfig {
  id: string;
  type: ProviderType; // 'openai' | 'anthropic' | 'gemini' | 'lmstudio' | 'ollama'
  name: string;
  apiKey?: string;
  baseUrl?: string;
}

MCP Types

McpServerConfig

interface McpServerConfig {
  id: string;
  name: string;
  transport: McpTransport; // 'http-sse' | 'stdio'
  url?: string;
  command?: string;
  args?: string[];
}

Settings Contribution Types

All exported from @openconduit/core. Used by the schema-driven settings UI (issue #37).

import type { SettingsContribution, SettingsSection, SettingsProperty } from '@openconduit/core';

SettingsContribution

interface SettingsContribution {
  id: string;
  label: string;
  order: number;
  sections: SettingsSection[];
}

SettingsSection

interface SettingsSection {
  title: string;
  description?: string;
  properties: SettingsProperty[];
}

SettingsProperty

type SettingsProperty =
  | SettingsStringProperty
  | SettingsNumberProperty
  | SettingsBooleanProperty;

interface SettingsStringProperty {
  type: 'string';
  key: string;
  title: string;
  description?: string;
  default?: string;
  enum?: string[];
  enumDescriptions?: string[];
  placeholder?: string;
  sensitive?: boolean;
  multiline?: boolean;
  order?: number;
}

interface SettingsNumberProperty {
  type: 'number';
  key: string;
  title: string;
  description?: string;
  default?: number;
  minimum?: number;
  maximum?: number;
  step?: number;
  order?: number;
}

interface SettingsBooleanProperty {
  type: 'boolean';
  key: string;
  title: string;
  description?: string;
  default?: boolean;
  order?: number;
}

See Settings Contributions for usage examples.

Update / Feedback

UpdateInfo

interface UpdateInfo {
  hasUpdate: boolean;
  latestVersion: string;
  currentVersion: string;
  releaseNotes?: string;
  downloadUrl?: string;
}