# @automaker/types

Shared TypeScript type definitions for AutoMaker.

## Overview

This package contains all core type definitions used across AutoMaker's server and UI components. It has no dependencies and serves as the foundation for other packages.

## Installation

```bash
npm install @automaker/types
```

## Exports

### Provider Types
Types for AI provider integration and Claude SDK.

```typescript
import type {
  ProviderConfig,
  ConversationMessage,
  ExecuteOptions,
  ContentBlock,
  ProviderMessage,
  InstallationStatus,
  ValidationResult,
  ModelDefinition
} from '@automaker/types';
```

### Feature Types
Feature management and workflow types.

```typescript
import type {
  Feature,
  FeatureStatus,
  PlanningMode,
  PlanSpec
} from '@automaker/types';
```

**Feature Interface:**
- `id` - Unique feature identifier
- `category` - Feature category/type
- `description` - Feature description
- `dependencies` - Array of feature IDs this depends on
- `status` - Current status (pending/running/completed/failed/verified)
- `planningMode` - Planning approach (skip/lite/spec/full)
- `planSpec` - Plan specification and approval status

### Session Types
Agent session management.

```typescript
import type {
  AgentSession,
  SessionListItem,
  CreateSessionParams,
  UpdateSessionParams
} from '@automaker/types';
```

### Error Types
Error classification and handling.

```typescript
import type {
  ErrorType,
  ErrorInfo
} from '@automaker/types';
```

### Image Types
Image handling for prompts.

```typescript
import type {
  ImageData,
  ImageContentBlock
} from '@automaker/types';
```

### Model Types
Claude model definitions and mappings.

```typescript
import {
  CLAUDE_MODEL_MAP,
  DEFAULT_MODELS,
  type ModelAlias
} from '@automaker/types';
```

## Usage Example

```typescript
import type { Feature, ExecuteOptions } from '@automaker/types';

const feature: Feature = {
  id: 'auth-feature',
  category: 'backend',
  description: 'Implement user authentication',
  dependencies: ['database-setup'],
  status: 'pending',
  planningMode: 'spec'
};

const options: ExecuteOptions = {
  model: 'claude-sonnet-4-20250514',
  temperature: 0.7
};
```

## Dependencies

None - this is a pure types package.

## Used By

- `@automaker/utils`
- `@automaker/platform`
- `@automaker/model-resolver`
- `@automaker/dependency-resolver`
- `@automaker/git-utils`
- `@automaker/server`
- `@automaker/ui`