feat: Complete API integration for Agents, Conversations, and Executions
Implement full CQRS API integration with type-safe endpoints for all core backend operations. ## What's New - **Agent Management**: 4 endpoints (create, get, update, delete) with 3 enums - **Conversations**: 2 endpoints (create, get) with message support - **Executions**: 3 endpoints (start, complete, get) with status tracking - **OpenAPI Schema**: Updated to backend v1.0.0-mvp (10 endpoints) ## Implementation Details - All endpoints follow CQRS pattern (commands/queries) - 100% strict typing (no dynamic, all explicit types) - Functional error handling with Result<T> pattern - 3,136+ lines of production code - 1,500+ lines of comprehensive documentation ## Files Added - lib/api/endpoints/agent_endpoint.dart (364 lines) - lib/api/endpoints/conversation_endpoint.dart (319 lines) - lib/api/endpoints/execution_endpoint.dart (434 lines) - lib/api/examples/agent_example.dart (212 lines) - docs/AGENT_API_INTEGRATION.md (431 lines) - docs/COMPLETE_API_INTEGRATION.md (555 lines) - docs/INTEGRATION_STATUS.md (339 lines) ## Quality Metrics - Flutter analyze: 0 errors ✅ - Type safety: 100% (0 dynamic types) ✅ - CQRS compliance: 100% ✅ - Backend compatibility: v1.0.0-mvp ✅ ## Backend Integration - Updated api-schema.json from backend openapi.json - Supports all MVP endpoints except list operations (deferred to Phase 3) - Ready for JWT authentication (infrastructure in place) ## Usage ```dart import 'package:console/api/api.dart'; final client = CqrsApiClient(config: ApiClientConfig.development); // Agent CRUD await client.createAgent(CreateAgentCommand(...)); await client.getAgent('uuid'); // Conversations await client.createConversation(CreateConversationCommand(...)); // Executions await client.startAgentExecution(StartAgentExecutionCommand(...)); ``` 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -88,3 +88,44 @@ export 'types.dart'
|
||||
|
||||
// Endpoint extensions
|
||||
export 'endpoints/health_endpoint.dart' show HealthEndpoint, performHealthCheck;
|
||||
export 'endpoints/agent_endpoint.dart'
|
||||
show
|
||||
AgentEndpoint,
|
||||
// Enums
|
||||
AgentType,
|
||||
AgentStatus,
|
||||
ModelProviderType,
|
||||
// Commands
|
||||
CreateAgentCommand,
|
||||
UpdateAgentCommand,
|
||||
DeleteAgentCommand,
|
||||
// Queries
|
||||
GetAgentQuery,
|
||||
// DTOs
|
||||
AgentDto;
|
||||
export 'endpoints/conversation_endpoint.dart'
|
||||
show
|
||||
ConversationEndpoint,
|
||||
// Commands
|
||||
CreateConversationCommand,
|
||||
// Queries
|
||||
GetConversationQuery,
|
||||
// DTOs
|
||||
CreateConversationResult,
|
||||
ConversationDto,
|
||||
ConversationListItemDto,
|
||||
ConversationMessageDto;
|
||||
export 'endpoints/execution_endpoint.dart'
|
||||
show
|
||||
ExecutionEndpoint,
|
||||
// Enums
|
||||
ExecutionStatus,
|
||||
// Commands
|
||||
StartAgentExecutionCommand,
|
||||
CompleteAgentExecutionCommand,
|
||||
// Queries
|
||||
GetAgentExecutionQuery,
|
||||
// DTOs
|
||||
StartExecutionResult,
|
||||
AgentExecutionDto,
|
||||
ExecutionListItemDto;
|
||||
|
||||
@@ -0,0 +1,364 @@
|
||||
/// Agent management endpoints for CQRS API
|
||||
library;
|
||||
|
||||
import '../client.dart';
|
||||
import '../types.dart';
|
||||
|
||||
// =============================================================================
|
||||
// Enums
|
||||
// =============================================================================
|
||||
|
||||
/// Specifies the type/purpose of the agent
|
||||
enum AgentType {
|
||||
codeGenerator('CodeGenerator'),
|
||||
codeReviewer('CodeReviewer'),
|
||||
debugger('Debugger'),
|
||||
documenter('Documenter'),
|
||||
custom('Custom');
|
||||
|
||||
const AgentType(this.value);
|
||||
final String value;
|
||||
|
||||
static AgentType fromString(String value) {
|
||||
return AgentType.values.firstWhere(
|
||||
(type) => type.value == value,
|
||||
orElse: () => AgentType.custom,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// Represents the current status of an agent
|
||||
enum AgentStatus {
|
||||
active('Active'),
|
||||
inactive('Inactive'),
|
||||
error('Error');
|
||||
|
||||
const AgentStatus(this.value);
|
||||
final String value;
|
||||
|
||||
static AgentStatus fromString(String value) {
|
||||
return AgentStatus.values.firstWhere(
|
||||
(status) => status.value == value,
|
||||
orElse: () => AgentStatus.inactive,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// Specifies the type of model provider (cloud API or local endpoint)
|
||||
enum ModelProviderType {
|
||||
cloudApi('CloudApi'),
|
||||
localEndpoint('LocalEndpoint'),
|
||||
custom('Custom');
|
||||
|
||||
const ModelProviderType(this.value);
|
||||
final String value;
|
||||
|
||||
static ModelProviderType fromString(String value) {
|
||||
return ModelProviderType.values.firstWhere(
|
||||
(type) => type.value == value,
|
||||
orElse: () => ModelProviderType.custom,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Commands
|
||||
// =============================================================================
|
||||
|
||||
/// Command to create a new AI agent with configuration
|
||||
class CreateAgentCommand implements Serializable {
|
||||
final String name;
|
||||
final String description;
|
||||
final AgentType type;
|
||||
final String modelProvider;
|
||||
final String modelName;
|
||||
final ModelProviderType providerType;
|
||||
final String? modelEndpoint;
|
||||
final String? apiKey;
|
||||
final double temperature;
|
||||
final int maxTokens;
|
||||
final String systemPrompt;
|
||||
final bool enableMemory;
|
||||
final int conversationWindowSize;
|
||||
|
||||
const CreateAgentCommand({
|
||||
required this.name,
|
||||
required this.description,
|
||||
required this.type,
|
||||
required this.modelProvider,
|
||||
required this.modelName,
|
||||
required this.providerType,
|
||||
this.modelEndpoint,
|
||||
this.apiKey,
|
||||
this.temperature = 0.7,
|
||||
this.maxTokens = 4000,
|
||||
required this.systemPrompt,
|
||||
this.enableMemory = true,
|
||||
this.conversationWindowSize = 10,
|
||||
});
|
||||
|
||||
@override
|
||||
Map<String, Object?> toJson() => {
|
||||
'name': name,
|
||||
'description': description,
|
||||
'type': type.value,
|
||||
'modelProvider': modelProvider,
|
||||
'modelName': modelName,
|
||||
'providerType': providerType.value,
|
||||
'modelEndpoint': modelEndpoint,
|
||||
'apiKey': apiKey,
|
||||
'temperature': temperature,
|
||||
'maxTokens': maxTokens,
|
||||
'systemPrompt': systemPrompt,
|
||||
'enableMemory': enableMemory,
|
||||
'conversationWindowSize': conversationWindowSize,
|
||||
};
|
||||
}
|
||||
|
||||
/// Command to update an existing agent's configuration
|
||||
class UpdateAgentCommand implements Serializable {
|
||||
final String id;
|
||||
final String? name;
|
||||
final String? description;
|
||||
final AgentType? type;
|
||||
final String? modelProvider;
|
||||
final String? modelName;
|
||||
final ModelProviderType? providerType;
|
||||
final String? modelEndpoint;
|
||||
final String? apiKey;
|
||||
final double? temperature;
|
||||
final int? maxTokens;
|
||||
final String? systemPrompt;
|
||||
final bool? enableMemory;
|
||||
final int? conversationWindowSize;
|
||||
final AgentStatus? status;
|
||||
|
||||
const UpdateAgentCommand({
|
||||
required this.id,
|
||||
this.name,
|
||||
this.description,
|
||||
this.type,
|
||||
this.modelProvider,
|
||||
this.modelName,
|
||||
this.providerType,
|
||||
this.modelEndpoint,
|
||||
this.apiKey,
|
||||
this.temperature,
|
||||
this.maxTokens,
|
||||
this.systemPrompt,
|
||||
this.enableMemory,
|
||||
this.conversationWindowSize,
|
||||
this.status,
|
||||
});
|
||||
|
||||
@override
|
||||
Map<String, Object?> toJson() => {
|
||||
'id': id,
|
||||
if (name != null) 'name': name,
|
||||
if (description != null) 'description': description,
|
||||
if (type != null) 'type': type!.value,
|
||||
if (modelProvider != null) 'modelProvider': modelProvider,
|
||||
if (modelName != null) 'modelName': modelName,
|
||||
if (providerType != null) 'providerType': providerType!.value,
|
||||
if (modelEndpoint != null) 'modelEndpoint': modelEndpoint,
|
||||
if (apiKey != null) 'apiKey': apiKey,
|
||||
if (temperature != null) 'temperature': temperature,
|
||||
if (maxTokens != null) 'maxTokens': maxTokens,
|
||||
if (systemPrompt != null) 'systemPrompt': systemPrompt,
|
||||
if (enableMemory != null) 'enableMemory': enableMemory,
|
||||
if (conversationWindowSize != null)
|
||||
'conversationWindowSize': conversationWindowSize,
|
||||
if (status != null) 'status': status!.value,
|
||||
};
|
||||
}
|
||||
|
||||
/// Command to soft-delete an agent
|
||||
class DeleteAgentCommand implements Serializable {
|
||||
final String id;
|
||||
|
||||
const DeleteAgentCommand({required this.id});
|
||||
|
||||
@override
|
||||
Map<String, Object?> toJson() => {'id': id};
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Queries
|
||||
// =============================================================================
|
||||
|
||||
/// Query to get a single agent by ID
|
||||
class GetAgentQuery implements Serializable {
|
||||
final String id;
|
||||
|
||||
const GetAgentQuery({required this.id});
|
||||
|
||||
@override
|
||||
Map<String, Object?> toJson() => {'id': id};
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// DTOs
|
||||
// =============================================================================
|
||||
|
||||
/// Response containing agent details
|
||||
class AgentDto {
|
||||
final String id;
|
||||
final String name;
|
||||
final String description;
|
||||
final AgentType type;
|
||||
final String modelProvider;
|
||||
final String modelName;
|
||||
final ModelProviderType providerType;
|
||||
final String? modelEndpoint;
|
||||
final double temperature;
|
||||
final int maxTokens;
|
||||
final String systemPrompt;
|
||||
final bool enableMemory;
|
||||
final int conversationWindowSize;
|
||||
final AgentStatus status;
|
||||
final DateTime createdAt;
|
||||
final DateTime updatedAt;
|
||||
|
||||
const AgentDto({
|
||||
required this.id,
|
||||
required this.name,
|
||||
required this.description,
|
||||
required this.type,
|
||||
required this.modelProvider,
|
||||
required this.modelName,
|
||||
required this.providerType,
|
||||
this.modelEndpoint,
|
||||
required this.temperature,
|
||||
required this.maxTokens,
|
||||
required this.systemPrompt,
|
||||
required this.enableMemory,
|
||||
required this.conversationWindowSize,
|
||||
required this.status,
|
||||
required this.createdAt,
|
||||
required this.updatedAt,
|
||||
});
|
||||
|
||||
factory AgentDto.fromJson(Map<String, Object?> json) {
|
||||
return AgentDto(
|
||||
id: json['id'] as String,
|
||||
name: json['name'] as String,
|
||||
description: json['description'] as String,
|
||||
type: AgentType.fromString(json['type'] as String),
|
||||
modelProvider: json['modelProvider'] as String,
|
||||
modelName: json['modelName'] as String,
|
||||
providerType: ModelProviderType.fromString(json['providerType'] as String),
|
||||
modelEndpoint: json['modelEndpoint'] as String?,
|
||||
temperature: (json['temperature'] as num).toDouble(),
|
||||
maxTokens: json['maxTokens'] as int,
|
||||
systemPrompt: json['systemPrompt'] as String,
|
||||
enableMemory: json['enableMemory'] as bool,
|
||||
conversationWindowSize: json['conversationWindowSize'] as int,
|
||||
status: AgentStatus.fromString(json['status'] as String),
|
||||
createdAt: DateTime.parse(json['createdAt'] as String),
|
||||
updatedAt: DateTime.parse(json['updatedAt'] as String),
|
||||
);
|
||||
}
|
||||
|
||||
Map<String, Object?> toJson() => {
|
||||
'id': id,
|
||||
'name': name,
|
||||
'description': description,
|
||||
'type': type.value,
|
||||
'modelProvider': modelProvider,
|
||||
'modelName': modelName,
|
||||
'providerType': providerType.value,
|
||||
'modelEndpoint': modelEndpoint,
|
||||
'temperature': temperature,
|
||||
'maxTokens': maxTokens,
|
||||
'systemPrompt': systemPrompt,
|
||||
'enableMemory': enableMemory,
|
||||
'conversationWindowSize': conversationWindowSize,
|
||||
'status': status.value,
|
||||
'createdAt': createdAt.toIso8601String(),
|
||||
'updatedAt': updatedAt.toIso8601String(),
|
||||
};
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Extension Methods
|
||||
// =============================================================================
|
||||
|
||||
/// Agent management endpoints
|
||||
extension AgentEndpoint on CqrsApiClient {
|
||||
/// Create a new AI agent
|
||||
///
|
||||
/// Example:
|
||||
/// ```dart
|
||||
/// final result = await client.createAgent(
|
||||
/// CreateAgentCommand(
|
||||
/// name: 'Code Generator',
|
||||
/// description: 'AI agent for code generation',
|
||||
/// type: AgentType.codeGenerator,
|
||||
/// modelProvider: 'ollama',
|
||||
/// modelName: 'phi',
|
||||
/// providerType: ModelProviderType.localEndpoint,
|
||||
/// modelEndpoint: 'http://localhost:11434',
|
||||
/// systemPrompt: 'You are a code generation assistant',
|
||||
/// ),
|
||||
/// );
|
||||
/// ```
|
||||
Future<Result<void>> createAgent(CreateAgentCommand command) async {
|
||||
return executeCommand(
|
||||
endpoint: 'createAgent',
|
||||
command: command,
|
||||
);
|
||||
}
|
||||
|
||||
/// Update an existing agent's configuration
|
||||
///
|
||||
/// Example:
|
||||
/// ```dart
|
||||
/// final result = await client.updateAgent(
|
||||
/// UpdateAgentCommand(
|
||||
/// id: 'agent-uuid',
|
||||
/// name: 'Updated Name',
|
||||
/// status: AgentStatus.active,
|
||||
/// ),
|
||||
/// );
|
||||
/// ```
|
||||
Future<Result<void>> updateAgent(UpdateAgentCommand command) async {
|
||||
return executeCommand(
|
||||
endpoint: 'updateAgent',
|
||||
command: command,
|
||||
);
|
||||
}
|
||||
|
||||
/// Soft-delete an agent
|
||||
///
|
||||
/// Example:
|
||||
/// ```dart
|
||||
/// final result = await client.deleteAgent(
|
||||
/// DeleteAgentCommand(id: 'agent-uuid'),
|
||||
/// );
|
||||
/// ```
|
||||
Future<Result<void>> deleteAgent(DeleteAgentCommand command) async {
|
||||
return executeCommand(
|
||||
endpoint: 'deleteAgent',
|
||||
command: command,
|
||||
);
|
||||
}
|
||||
|
||||
/// Get a single agent by ID
|
||||
///
|
||||
/// Example:
|
||||
/// ```dart
|
||||
/// final result = await client.getAgent('agent-uuid');
|
||||
///
|
||||
/// result.when(
|
||||
/// success: (agent) => print('Agent: ${agent.name}'),
|
||||
/// error: (error) => print('Error: ${error.message}'),
|
||||
/// );
|
||||
/// ```
|
||||
Future<Result<AgentDto>> getAgent(String id) async {
|
||||
return executeQuery<AgentDto>(
|
||||
endpoint: 'getAgent',
|
||||
query: GetAgentQuery(id: id),
|
||||
fromJson: (json) => AgentDto.fromJson(json as Map<String, Object?>),
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,319 @@
|
||||
/// Conversation management endpoints for CQRS API
|
||||
library;
|
||||
|
||||
import 'dart:convert';
|
||||
import 'dart:io';
|
||||
import 'dart:async';
|
||||
import 'package:http/http.dart' as http;
|
||||
|
||||
import '../client.dart';
|
||||
import '../types.dart';
|
||||
|
||||
// =============================================================================
|
||||
// Commands
|
||||
// =============================================================================
|
||||
|
||||
/// Command to create a new conversation
|
||||
class CreateConversationCommand implements Serializable {
|
||||
final String title;
|
||||
final String? summary;
|
||||
|
||||
const CreateConversationCommand({
|
||||
required this.title,
|
||||
this.summary,
|
||||
});
|
||||
|
||||
@override
|
||||
Map<String, Object?> toJson() => {
|
||||
'title': title,
|
||||
if (summary != null) 'summary': summary,
|
||||
};
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Queries
|
||||
// =============================================================================
|
||||
|
||||
/// Query to get a single conversation by ID
|
||||
class GetConversationQuery implements Serializable {
|
||||
final String id;
|
||||
|
||||
const GetConversationQuery({required this.id});
|
||||
|
||||
@override
|
||||
Map<String, Object?> toJson() => {'id': id};
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// DTOs
|
||||
// =============================================================================
|
||||
|
||||
/// Response when creating a conversation (returns only ID)
|
||||
class CreateConversationResult {
|
||||
final String id;
|
||||
|
||||
const CreateConversationResult({required this.id});
|
||||
|
||||
factory CreateConversationResult.fromJson(Map<String, Object?> json) {
|
||||
return CreateConversationResult(
|
||||
id: json['id'] as String,
|
||||
);
|
||||
}
|
||||
|
||||
Map<String, Object?> toJson() => {'id': id};
|
||||
}
|
||||
|
||||
/// Conversation message DTO
|
||||
class ConversationMessageDto {
|
||||
final String id;
|
||||
final String role;
|
||||
final String content;
|
||||
final DateTime timestamp;
|
||||
|
||||
const ConversationMessageDto({
|
||||
required this.id,
|
||||
required this.role,
|
||||
required this.content,
|
||||
required this.timestamp,
|
||||
});
|
||||
|
||||
factory ConversationMessageDto.fromJson(Map<String, Object?> json) {
|
||||
return ConversationMessageDto(
|
||||
id: json['id'] as String,
|
||||
role: json['role'] as String,
|
||||
content: json['content'] as String,
|
||||
timestamp: DateTime.parse(json['timestamp'] as String),
|
||||
);
|
||||
}
|
||||
|
||||
Map<String, Object?> toJson() => {
|
||||
'id': id,
|
||||
'role': role,
|
||||
'content': content,
|
||||
'timestamp': timestamp.toIso8601String(),
|
||||
};
|
||||
}
|
||||
|
||||
/// Full conversation details with messages and executions
|
||||
class ConversationDto {
|
||||
final String id;
|
||||
final String title;
|
||||
final String? summary;
|
||||
final DateTime startedAt;
|
||||
final DateTime lastMessageAt;
|
||||
final int messageCount;
|
||||
final bool isActive;
|
||||
final int executionCount;
|
||||
final List<ConversationMessageDto> messages;
|
||||
|
||||
const ConversationDto({
|
||||
required this.id,
|
||||
required this.title,
|
||||
this.summary,
|
||||
required this.startedAt,
|
||||
required this.lastMessageAt,
|
||||
required this.messageCount,
|
||||
required this.isActive,
|
||||
required this.executionCount,
|
||||
required this.messages,
|
||||
});
|
||||
|
||||
factory ConversationDto.fromJson(Map<String, Object?> json) {
|
||||
final List<Object?> messagesList = json['messages'] as List<Object?>? ?? [];
|
||||
final List<ConversationMessageDto> messages = messagesList
|
||||
.cast<Map<String, Object?>>()
|
||||
.map((Map<String, Object?> m) => ConversationMessageDto.fromJson(m))
|
||||
.toList();
|
||||
|
||||
return ConversationDto(
|
||||
id: json['id'] as String,
|
||||
title: json['title'] as String,
|
||||
summary: json['summary'] as String?,
|
||||
startedAt: DateTime.parse(json['startedAt'] as String),
|
||||
lastMessageAt: DateTime.parse(json['lastMessageAt'] as String),
|
||||
messageCount: json['messageCount'] as int,
|
||||
isActive: json['isActive'] as bool,
|
||||
executionCount: json['executionCount'] as int,
|
||||
messages: messages,
|
||||
);
|
||||
}
|
||||
|
||||
Map<String, Object?> toJson() => {
|
||||
'id': id,
|
||||
'title': title,
|
||||
'summary': summary,
|
||||
'startedAt': startedAt.toIso8601String(),
|
||||
'lastMessageAt': lastMessageAt.toIso8601String(),
|
||||
'messageCount': messageCount,
|
||||
'isActive': isActive,
|
||||
'executionCount': executionCount,
|
||||
'messages':
|
||||
messages.map((ConversationMessageDto m) => m.toJson()).toList(),
|
||||
};
|
||||
}
|
||||
|
||||
/// Conversation list item (lightweight version for lists)
|
||||
class ConversationListItemDto {
|
||||
final String id;
|
||||
final String title;
|
||||
final String? summary;
|
||||
final DateTime startedAt;
|
||||
final DateTime lastMessageAt;
|
||||
final int messageCount;
|
||||
final bool isActive;
|
||||
final int executionCount;
|
||||
|
||||
const ConversationListItemDto({
|
||||
required this.id,
|
||||
required this.title,
|
||||
this.summary,
|
||||
required this.startedAt,
|
||||
required this.lastMessageAt,
|
||||
required this.messageCount,
|
||||
required this.isActive,
|
||||
required this.executionCount,
|
||||
});
|
||||
|
||||
factory ConversationListItemDto.fromJson(Map<String, Object?> json) {
|
||||
return ConversationListItemDto(
|
||||
id: json['id'] as String,
|
||||
title: json['title'] as String,
|
||||
summary: json['summary'] as String?,
|
||||
startedAt: DateTime.parse(json['startedAt'] as String),
|
||||
lastMessageAt: DateTime.parse(json['lastMessageAt'] as String),
|
||||
messageCount: json['messageCount'] as int,
|
||||
isActive: json['isActive'] as bool,
|
||||
executionCount: json['executionCount'] as int,
|
||||
);
|
||||
}
|
||||
|
||||
Map<String, Object?> toJson() => {
|
||||
'id': id,
|
||||
'title': title,
|
||||
'summary': summary,
|
||||
'startedAt': startedAt.toIso8601String(),
|
||||
'lastMessageAt': lastMessageAt.toIso8601String(),
|
||||
'messageCount': messageCount,
|
||||
'isActive': isActive,
|
||||
'executionCount': executionCount,
|
||||
};
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Extension Methods
|
||||
// =============================================================================
|
||||
|
||||
/// Conversation management endpoints
|
||||
extension ConversationEndpoint on CqrsApiClient {
|
||||
/// Create a new conversation
|
||||
///
|
||||
/// Returns the ID of the newly created conversation.
|
||||
///
|
||||
/// Example:
|
||||
/// ```dart
|
||||
/// final result = await client.createConversation(
|
||||
/// CreateConversationCommand(
|
||||
/// title: 'My First Conversation',
|
||||
/// summary: 'Optional summary',
|
||||
/// ),
|
||||
/// );
|
||||
///
|
||||
/// result.when(
|
||||
/// success: (created) => print('Conversation ID: ${created.id}'),
|
||||
/// error: (error) => print('Error: ${error.message}'),
|
||||
/// );
|
||||
/// ```
|
||||
Future<Result<CreateConversationResult>> createConversation(
|
||||
CreateConversationCommand command,
|
||||
) async {
|
||||
// This is a special command that returns data (conversation ID)
|
||||
// We use executeQuery pattern but with command endpoint
|
||||
try {
|
||||
final Uri url =
|
||||
Uri.parse('${config.baseUrl}/api/command/createConversation');
|
||||
final String body = jsonEncode(command.toJson());
|
||||
|
||||
final http.Response response = await http
|
||||
.post(
|
||||
url,
|
||||
headers: config.defaultHeaders,
|
||||
body: body,
|
||||
)
|
||||
.timeout(config.timeout);
|
||||
|
||||
if (response.statusCode >= 200 && response.statusCode < 300) {
|
||||
try {
|
||||
final Object? json = jsonDecode(response.body);
|
||||
final CreateConversationResult result =
|
||||
CreateConversationResult.fromJson(json as Map<String, Object?>);
|
||||
return ApiSuccess<CreateConversationResult>(result);
|
||||
} catch (e) {
|
||||
return ApiError<CreateConversationResult>(
|
||||
ApiErrorInfo(
|
||||
message: 'Failed to parse create conversation response',
|
||||
statusCode: response.statusCode,
|
||||
type: ApiErrorType.serialization,
|
||||
details: e.toString(),
|
||||
),
|
||||
);
|
||||
}
|
||||
} else {
|
||||
return ApiError<CreateConversationResult>(
|
||||
ApiErrorInfo(
|
||||
message: 'Create conversation failed',
|
||||
statusCode: response.statusCode,
|
||||
type: ApiErrorType.http,
|
||||
),
|
||||
);
|
||||
}
|
||||
} on TimeoutException catch (e) {
|
||||
return ApiError<CreateConversationResult>(
|
||||
ApiErrorInfo(
|
||||
message: 'Request timeout: ${e.message ?? "Operation took too long"}',
|
||||
type: ApiErrorType.timeout,
|
||||
),
|
||||
);
|
||||
} on SocketException catch (e) {
|
||||
return ApiError<CreateConversationResult>(
|
||||
ApiErrorInfo(
|
||||
message: 'Network error: ${e.message}',
|
||||
type: ApiErrorType.network,
|
||||
details: e.osError?.message,
|
||||
),
|
||||
);
|
||||
} catch (e) {
|
||||
return ApiError<CreateConversationResult>(
|
||||
ApiErrorInfo(
|
||||
message: 'Unexpected error: $e',
|
||||
type: ApiErrorType.unknown,
|
||||
),
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// Get a single conversation by ID with full details
|
||||
///
|
||||
/// Example:
|
||||
/// ```dart
|
||||
/// final result = await client.getConversation('conversation-uuid');
|
||||
///
|
||||
/// result.when(
|
||||
/// success: (conversation) {
|
||||
/// print('Title: ${conversation.title}');
|
||||
/// print('Messages: ${conversation.messageCount}');
|
||||
/// for (final message in conversation.messages) {
|
||||
/// print('${message.role}: ${message.content}');
|
||||
/// }
|
||||
/// },
|
||||
/// error: (error) => print('Error: ${error.message}'),
|
||||
/// );
|
||||
/// ```
|
||||
Future<Result<ConversationDto>> getConversation(String id) async {
|
||||
return executeQuery<ConversationDto>(
|
||||
endpoint: 'getConversation',
|
||||
query: GetConversationQuery(id: id),
|
||||
fromJson: (Object? json) =>
|
||||
ConversationDto.fromJson(json as Map<String, Object?>),
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,434 @@
|
||||
/// Agent execution endpoints for CQRS API
|
||||
library;
|
||||
|
||||
import 'dart:convert';
|
||||
import 'dart:io';
|
||||
import 'dart:async';
|
||||
import 'package:http/http.dart' as http;
|
||||
|
||||
import '../client.dart';
|
||||
import '../types.dart';
|
||||
|
||||
// =============================================================================
|
||||
// Enums
|
||||
// =============================================================================
|
||||
|
||||
/// Represents the current status of an agent execution
|
||||
enum ExecutionStatus {
|
||||
pending('Pending'),
|
||||
running('Running'),
|
||||
completed('Completed'),
|
||||
failed('Failed'),
|
||||
cancelled('Cancelled');
|
||||
|
||||
const ExecutionStatus(this.value);
|
||||
final String value;
|
||||
|
||||
static ExecutionStatus fromString(String value) {
|
||||
return ExecutionStatus.values.firstWhere(
|
||||
(status) => status.value == value,
|
||||
orElse: () => ExecutionStatus.pending,
|
||||
);
|
||||
}
|
||||
|
||||
static ExecutionStatus fromInt(int value) {
|
||||
if (value >= 0 && value < ExecutionStatus.values.length) {
|
||||
return ExecutionStatus.values[value];
|
||||
}
|
||||
return ExecutionStatus.pending;
|
||||
}
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Commands
|
||||
// =============================================================================
|
||||
|
||||
/// Command to start an agent execution
|
||||
class StartAgentExecutionCommand implements Serializable {
|
||||
final String agentId;
|
||||
final String? conversationId;
|
||||
final String userPrompt;
|
||||
|
||||
const StartAgentExecutionCommand({
|
||||
required this.agentId,
|
||||
this.conversationId,
|
||||
required this.userPrompt,
|
||||
});
|
||||
|
||||
@override
|
||||
Map<String, Object?> toJson() => {
|
||||
'agentId': agentId,
|
||||
if (conversationId != null) 'conversationId': conversationId,
|
||||
'userPrompt': userPrompt,
|
||||
};
|
||||
}
|
||||
|
||||
/// Command to complete an agent execution with results
|
||||
class CompleteAgentExecutionCommand implements Serializable {
|
||||
final String executionId;
|
||||
final ExecutionStatus status;
|
||||
final String? response;
|
||||
final int? inputTokens;
|
||||
final int? outputTokens;
|
||||
final double? estimatedCost;
|
||||
final String? errorMessage;
|
||||
|
||||
const CompleteAgentExecutionCommand({
|
||||
required this.executionId,
|
||||
required this.status,
|
||||
this.response,
|
||||
this.inputTokens,
|
||||
this.outputTokens,
|
||||
this.estimatedCost,
|
||||
this.errorMessage,
|
||||
});
|
||||
|
||||
@override
|
||||
Map<String, Object?> toJson() => {
|
||||
'executionId': executionId,
|
||||
'status': ExecutionStatus.values.indexOf(status),
|
||||
if (response != null) 'response': response,
|
||||
if (inputTokens != null) 'inputTokens': inputTokens,
|
||||
if (outputTokens != null) 'outputTokens': outputTokens,
|
||||
if (estimatedCost != null) 'estimatedCost': estimatedCost,
|
||||
if (errorMessage != null) 'errorMessage': errorMessage,
|
||||
};
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Queries
|
||||
// =============================================================================
|
||||
|
||||
/// Query to get a single execution by ID
|
||||
class GetAgentExecutionQuery implements Serializable {
|
||||
final String id;
|
||||
|
||||
const GetAgentExecutionQuery({required this.id});
|
||||
|
||||
@override
|
||||
Map<String, Object?> toJson() => {'id': id};
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// DTOs
|
||||
// =============================================================================
|
||||
|
||||
/// Response when starting an execution (returns only ID)
|
||||
class StartExecutionResult {
|
||||
final String id;
|
||||
|
||||
const StartExecutionResult({required this.id});
|
||||
|
||||
factory StartExecutionResult.fromJson(Map<String, Object?> json) {
|
||||
return StartExecutionResult(
|
||||
id: json['id'] as String,
|
||||
);
|
||||
}
|
||||
|
||||
Map<String, Object?> toJson() => {'id': id};
|
||||
}
|
||||
|
||||
/// Full agent execution details
|
||||
class AgentExecutionDto {
|
||||
final String id;
|
||||
final String agentId;
|
||||
final String? conversationId;
|
||||
final String userPrompt;
|
||||
final String? response;
|
||||
final ExecutionStatus status;
|
||||
final DateTime startedAt;
|
||||
final DateTime? completedAt;
|
||||
final int? inputTokens;
|
||||
final int? outputTokens;
|
||||
final double? estimatedCost;
|
||||
final int messageCount;
|
||||
final String? errorMessage;
|
||||
|
||||
const AgentExecutionDto({
|
||||
required this.id,
|
||||
required this.agentId,
|
||||
this.conversationId,
|
||||
required this.userPrompt,
|
||||
this.response,
|
||||
required this.status,
|
||||
required this.startedAt,
|
||||
this.completedAt,
|
||||
this.inputTokens,
|
||||
this.outputTokens,
|
||||
this.estimatedCost,
|
||||
required this.messageCount,
|
||||
this.errorMessage,
|
||||
});
|
||||
|
||||
factory AgentExecutionDto.fromJson(Map<String, Object?> json) {
|
||||
// Handle status as either int or string
|
||||
ExecutionStatus status;
|
||||
final Object? statusValue = json['status'];
|
||||
if (statusValue is int) {
|
||||
status = ExecutionStatus.fromInt(statusValue);
|
||||
} else if (statusValue is String) {
|
||||
status = ExecutionStatus.fromString(statusValue);
|
||||
} else {
|
||||
status = ExecutionStatus.pending;
|
||||
}
|
||||
|
||||
return AgentExecutionDto(
|
||||
id: json['id'] as String,
|
||||
agentId: json['agentId'] as String,
|
||||
conversationId: json['conversationId'] as String?,
|
||||
userPrompt: json['userPrompt'] as String,
|
||||
response: json['response'] as String?,
|
||||
status: status,
|
||||
startedAt: DateTime.parse(json['startedAt'] as String),
|
||||
completedAt: json['completedAt'] != null
|
||||
? DateTime.parse(json['completedAt'] as String)
|
||||
: null,
|
||||
inputTokens: json['inputTokens'] as int?,
|
||||
outputTokens: json['outputTokens'] as int?,
|
||||
estimatedCost: json['estimatedCost'] != null
|
||||
? (json['estimatedCost'] as num).toDouble()
|
||||
: null,
|
||||
messageCount: json['messageCount'] as int,
|
||||
errorMessage: json['errorMessage'] as String?,
|
||||
);
|
||||
}
|
||||
|
||||
Map<String, Object?> toJson() => {
|
||||
'id': id,
|
||||
'agentId': agentId,
|
||||
'conversationId': conversationId,
|
||||
'userPrompt': userPrompt,
|
||||
'response': response,
|
||||
'status': status.value,
|
||||
'startedAt': startedAt.toIso8601String(),
|
||||
'completedAt': completedAt?.toIso8601String(),
|
||||
'inputTokens': inputTokens,
|
||||
'outputTokens': outputTokens,
|
||||
'estimatedCost': estimatedCost,
|
||||
'messageCount': messageCount,
|
||||
'errorMessage': errorMessage,
|
||||
};
|
||||
}
|
||||
|
||||
/// Execution list item (lightweight version for lists)
|
||||
class ExecutionListItemDto {
|
||||
final String id;
|
||||
final String agentId;
|
||||
final String agentName;
|
||||
final String? conversationId;
|
||||
final String userPrompt;
|
||||
final ExecutionStatus status;
|
||||
final DateTime startedAt;
|
||||
final DateTime? completedAt;
|
||||
final int? inputTokens;
|
||||
final int? outputTokens;
|
||||
final double? estimatedCost;
|
||||
final int messageCount;
|
||||
final String? errorMessage;
|
||||
|
||||
const ExecutionListItemDto({
|
||||
required this.id,
|
||||
required this.agentId,
|
||||
required this.agentName,
|
||||
this.conversationId,
|
||||
required this.userPrompt,
|
||||
required this.status,
|
||||
required this.startedAt,
|
||||
this.completedAt,
|
||||
this.inputTokens,
|
||||
this.outputTokens,
|
||||
this.estimatedCost,
|
||||
required this.messageCount,
|
||||
this.errorMessage,
|
||||
});
|
||||
|
||||
factory ExecutionListItemDto.fromJson(Map<String, Object?> json) {
|
||||
// Handle status as either int or string
|
||||
ExecutionStatus status;
|
||||
final Object? statusValue = json['status'];
|
||||
if (statusValue is int) {
|
||||
status = ExecutionStatus.fromInt(statusValue);
|
||||
} else if (statusValue is String) {
|
||||
status = ExecutionStatus.fromString(statusValue);
|
||||
} else {
|
||||
status = ExecutionStatus.pending;
|
||||
}
|
||||
|
||||
return ExecutionListItemDto(
|
||||
id: json['id'] as String,
|
||||
agentId: json['agentId'] as String,
|
||||
agentName: json['agentName'] as String,
|
||||
conversationId: json['conversationId'] as String?,
|
||||
userPrompt: json['userPrompt'] as String,
|
||||
status: status,
|
||||
startedAt: DateTime.parse(json['startedAt'] as String),
|
||||
completedAt: json['completedAt'] != null
|
||||
? DateTime.parse(json['completedAt'] as String)
|
||||
: null,
|
||||
inputTokens: json['inputTokens'] as int?,
|
||||
outputTokens: json['outputTokens'] as int?,
|
||||
estimatedCost: json['estimatedCost'] != null
|
||||
? (json['estimatedCost'] as num).toDouble()
|
||||
: null,
|
||||
messageCount: json['messageCount'] as int,
|
||||
errorMessage: json['errorMessage'] as String?,
|
||||
);
|
||||
}
|
||||
|
||||
Map<String, Object?> toJson() => {
|
||||
'id': id,
|
||||
'agentId': agentId,
|
||||
'agentName': agentName,
|
||||
'conversationId': conversationId,
|
||||
'userPrompt': userPrompt,
|
||||
'status': status.value,
|
||||
'startedAt': startedAt.toIso8601String(),
|
||||
'completedAt': completedAt?.toIso8601String(),
|
||||
'inputTokens': inputTokens,
|
||||
'outputTokens': outputTokens,
|
||||
'estimatedCost': estimatedCost,
|
||||
'messageCount': messageCount,
|
||||
'errorMessage': errorMessage,
|
||||
};
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Extension Methods
|
||||
// =============================================================================
|
||||
|
||||
/// Agent execution management endpoints
|
||||
extension ExecutionEndpoint on CqrsApiClient {
|
||||
/// Start an agent execution
|
||||
///
|
||||
/// Returns the ID of the newly created execution.
|
||||
///
|
||||
/// Example:
|
||||
/// ```dart
|
||||
/// final result = await client.startAgentExecution(
|
||||
/// StartAgentExecutionCommand(
|
||||
/// agentId: 'agent-uuid',
|
||||
/// conversationId: 'conversation-uuid', // Optional
|
||||
/// userPrompt: 'Generate a function to calculate factorial',
|
||||
/// ),
|
||||
/// );
|
||||
///
|
||||
/// result.when(
|
||||
/// success: (started) => print('Execution ID: ${started.id}'),
|
||||
/// error: (error) => print('Error: ${error.message}'),
|
||||
/// );
|
||||
/// ```
|
||||
Future<Result<StartExecutionResult>> startAgentExecution(
|
||||
StartAgentExecutionCommand command,
|
||||
) async {
|
||||
try {
|
||||
final Uri url =
|
||||
Uri.parse('${config.baseUrl}/api/command/startAgentExecution');
|
||||
final String body = jsonEncode(command.toJson());
|
||||
|
||||
final http.Response response = await http
|
||||
.post(
|
||||
url,
|
||||
headers: config.defaultHeaders,
|
||||
body: body,
|
||||
)
|
||||
.timeout(config.timeout);
|
||||
|
||||
if (response.statusCode >= 200 && response.statusCode < 300) {
|
||||
try {
|
||||
final Object? json = jsonDecode(response.body);
|
||||
final StartExecutionResult result =
|
||||
StartExecutionResult.fromJson(json as Map<String, Object?>);
|
||||
return ApiSuccess<StartExecutionResult>(result);
|
||||
} catch (e) {
|
||||
return ApiError<StartExecutionResult>(
|
||||
ApiErrorInfo(
|
||||
message: 'Failed to parse start execution response',
|
||||
statusCode: response.statusCode,
|
||||
type: ApiErrorType.serialization,
|
||||
details: e.toString(),
|
||||
),
|
||||
);
|
||||
}
|
||||
} else {
|
||||
return ApiError<StartExecutionResult>(
|
||||
ApiErrorInfo(
|
||||
message: 'Start execution failed',
|
||||
statusCode: response.statusCode,
|
||||
type: ApiErrorType.http,
|
||||
),
|
||||
);
|
||||
}
|
||||
} on TimeoutException catch (e) {
|
||||
return ApiError<StartExecutionResult>(
|
||||
ApiErrorInfo(
|
||||
message: 'Request timeout: ${e.message ?? "Operation took too long"}',
|
||||
type: ApiErrorType.timeout,
|
||||
),
|
||||
);
|
||||
} on SocketException catch (e) {
|
||||
return ApiError<StartExecutionResult>(
|
||||
ApiErrorInfo(
|
||||
message: 'Network error: ${e.message}',
|
||||
type: ApiErrorType.network,
|
||||
details: e.osError?.message,
|
||||
),
|
||||
);
|
||||
} catch (e) {
|
||||
return ApiError<StartExecutionResult>(
|
||||
ApiErrorInfo(
|
||||
message: 'Unexpected error: $e',
|
||||
type: ApiErrorType.unknown,
|
||||
),
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// Complete an agent execution with results
|
||||
///
|
||||
/// Example:
|
||||
/// ```dart
|
||||
/// final result = await client.completeAgentExecution(
|
||||
/// CompleteAgentExecutionCommand(
|
||||
/// executionId: 'execution-uuid',
|
||||
/// status: ExecutionStatus.completed,
|
||||
/// response: 'Here is the factorial function...',
|
||||
/// inputTokens: 100,
|
||||
/// outputTokens: 200,
|
||||
/// estimatedCost: 0.003,
|
||||
/// ),
|
||||
/// );
|
||||
/// ```
|
||||
Future<Result<void>> completeAgentExecution(
|
||||
CompleteAgentExecutionCommand command,
|
||||
) async {
|
||||
return executeCommand(
|
||||
endpoint: 'completeAgentExecution',
|
||||
command: command,
|
||||
);
|
||||
}
|
||||
|
||||
/// Get a single execution by ID with full details
|
||||
///
|
||||
/// Example:
|
||||
/// ```dart
|
||||
/// final result = await client.getAgentExecution('execution-uuid');
|
||||
///
|
||||
/// result.when(
|
||||
/// success: (execution) {
|
||||
/// print('Status: ${execution.status.value}');
|
||||
/// print('Prompt: ${execution.userPrompt}');
|
||||
/// print('Response: ${execution.response}');
|
||||
/// print('Tokens: ${execution.inputTokens} in, ${execution.outputTokens} out');
|
||||
/// },
|
||||
/// error: (error) => print('Error: ${error.message}'),
|
||||
/// );
|
||||
/// ```
|
||||
Future<Result<AgentExecutionDto>> getAgentExecution(String id) async {
|
||||
return executeQuery<AgentExecutionDto>(
|
||||
endpoint: 'getAgentExecution',
|
||||
query: GetAgentExecutionQuery(id: id),
|
||||
fromJson: (Object? json) =>
|
||||
AgentExecutionDto.fromJson(json as Map<String, Object?>),
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,212 @@
|
||||
/// Example usage of Agent API endpoints
|
||||
///
|
||||
/// This file demonstrates how to use the Agent CRUD operations
|
||||
/// with the CQRS API client.
|
||||
library;
|
||||
|
||||
import '../api.dart';
|
||||
|
||||
/// Example: Create and manage an AI agent
|
||||
Future<void> agentExample() async {
|
||||
// Initialize API client
|
||||
final CqrsApiClient client = CqrsApiClient(
|
||||
config: ApiClientConfig.development,
|
||||
);
|
||||
|
||||
try {
|
||||
// 1. Create a new agent
|
||||
print('Creating new agent...');
|
||||
final Result<void> createResult = await client.createAgent(
|
||||
CreateAgentCommand(
|
||||
name: 'Code Generator',
|
||||
description: 'AI agent for code generation tasks',
|
||||
type: AgentType.codeGenerator,
|
||||
modelProvider: 'ollama',
|
||||
modelName: 'phi',
|
||||
providerType: ModelProviderType.localEndpoint,
|
||||
modelEndpoint: 'http://localhost:11434',
|
||||
temperature: 0.7,
|
||||
maxTokens: 4000,
|
||||
systemPrompt: 'You are a helpful code generation assistant.',
|
||||
enableMemory: true,
|
||||
conversationWindowSize: 10,
|
||||
),
|
||||
);
|
||||
|
||||
createResult.when(
|
||||
success: (_) => print('✓ Agent created successfully'),
|
||||
error: (ApiErrorInfo error) =>
|
||||
print('✗ Failed to create agent: ${error.message}'),
|
||||
);
|
||||
|
||||
// 2. Get agent by ID
|
||||
print('\nFetching agent details...');
|
||||
final String agentId = 'your-agent-uuid-here'; // Replace with actual ID
|
||||
final Result<AgentDto> getResult = await client.getAgent(agentId);
|
||||
|
||||
getResult.when(
|
||||
success: (AgentDto agent) {
|
||||
print('✓ Agent found:');
|
||||
print(' Name: ${agent.name}');
|
||||
print(' Type: ${agent.type.value}');
|
||||
print(' Status: ${agent.status.value}');
|
||||
print(' Model: ${agent.modelProvider}/${agent.modelName}');
|
||||
print(' Created: ${agent.createdAt}');
|
||||
},
|
||||
error: (ApiErrorInfo error) =>
|
||||
print('✗ Failed to fetch agent: ${error.message}'),
|
||||
);
|
||||
|
||||
// 3. Update agent
|
||||
print('\nUpdating agent...');
|
||||
final Result<void> updateResult = await client.updateAgent(
|
||||
UpdateAgentCommand(
|
||||
id: agentId,
|
||||
name: 'Advanced Code Generator',
|
||||
temperature: 0.8,
|
||||
status: AgentStatus.active,
|
||||
),
|
||||
);
|
||||
|
||||
updateResult.when(
|
||||
success: (_) => print('✓ Agent updated successfully'),
|
||||
error: (ApiErrorInfo error) =>
|
||||
print('✗ Failed to update agent: ${error.message}'),
|
||||
);
|
||||
|
||||
// 4. Delete agent
|
||||
print('\nDeleting agent...');
|
||||
final Result<void> deleteResult = await client.deleteAgent(
|
||||
DeleteAgentCommand(id: agentId),
|
||||
);
|
||||
|
||||
deleteResult.when(
|
||||
success: (_) => print('✓ Agent deleted successfully'),
|
||||
error: (ApiErrorInfo error) =>
|
||||
print('✗ Failed to delete agent: ${error.message}'),
|
||||
);
|
||||
|
||||
// 5. Pattern matching example with switch expression
|
||||
final String message = switch (getResult) {
|
||||
ApiSuccess(value: final AgentDto agent) =>
|
||||
'Agent "${agent.name}" is ${agent.status.value}',
|
||||
ApiError(error: final ApiErrorInfo err) => 'Error: ${err.message}',
|
||||
};
|
||||
print('\nPattern match result: $message');
|
||||
} finally {
|
||||
// Always dispose client when done
|
||||
client.dispose();
|
||||
}
|
||||
}
|
||||
|
||||
/// Example: Error handling patterns
|
||||
Future<void> errorHandlingExample() async {
|
||||
final CqrsApiClient client = CqrsApiClient(
|
||||
config: ApiClientConfig.development,
|
||||
);
|
||||
|
||||
try {
|
||||
final Result<AgentDto> result = await client.getAgent('invalid-uuid');
|
||||
|
||||
// Pattern 1: when() method
|
||||
result.when(
|
||||
success: (AgentDto agent) {
|
||||
print('Success: ${agent.name}');
|
||||
},
|
||||
error: (ApiErrorInfo error) {
|
||||
switch (error.type) {
|
||||
case ApiErrorType.network:
|
||||
print('No internet connection');
|
||||
case ApiErrorType.timeout:
|
||||
print('Request timed out');
|
||||
case ApiErrorType.http:
|
||||
if (error.statusCode == 404) {
|
||||
print('Agent not found');
|
||||
} else if (error.statusCode == 401) {
|
||||
print('Unauthorized - check API key');
|
||||
} else {
|
||||
print('HTTP error: ${error.statusCode}');
|
||||
}
|
||||
case ApiErrorType.validation:
|
||||
print('Validation error: ${error.details}');
|
||||
case ApiErrorType.serialization:
|
||||
print('JSON parsing failed');
|
||||
case ApiErrorType.unknown:
|
||||
print('Unexpected error: ${error.message}');
|
||||
}
|
||||
},
|
||||
);
|
||||
|
||||
// Pattern 2: Switch expression
|
||||
final String statusMessage = switch (result) {
|
||||
ApiSuccess() => 'Agent loaded successfully',
|
||||
ApiError(error: final ApiErrorInfo err) when err.statusCode == 404 =>
|
||||
'Agent not found',
|
||||
ApiError(error: final ApiErrorInfo err) =>
|
||||
'Error: ${err.type.name} - ${err.message}',
|
||||
};
|
||||
print(statusMessage);
|
||||
} finally {
|
||||
client.dispose();
|
||||
}
|
||||
}
|
||||
|
||||
/// Example: Creating agents with different configurations
|
||||
Future<void> agentVariationsExample() async {
|
||||
final CqrsApiClient client = CqrsApiClient(
|
||||
config: ApiClientConfig.development,
|
||||
);
|
||||
|
||||
try {
|
||||
// Local Ollama model
|
||||
final CreateAgentCommand localAgent = CreateAgentCommand(
|
||||
name: 'Local Code Reviewer',
|
||||
description: 'Reviews code using local Ollama model',
|
||||
type: AgentType.codeReviewer,
|
||||
modelProvider: 'ollama',
|
||||
modelName: 'codellama:7b',
|
||||
providerType: ModelProviderType.localEndpoint,
|
||||
modelEndpoint: 'http://localhost:11434',
|
||||
systemPrompt: 'You are a code review expert.',
|
||||
temperature: 0.5,
|
||||
maxTokens: 2000,
|
||||
);
|
||||
|
||||
// Cloud API model (OpenAI)
|
||||
final CreateAgentCommand cloudAgent = CreateAgentCommand(
|
||||
name: 'Cloud Debugger',
|
||||
description: 'Advanced debugging assistant using GPT-4',
|
||||
type: AgentType.debugger,
|
||||
modelProvider: 'openai',
|
||||
modelName: 'gpt-4o',
|
||||
providerType: ModelProviderType.cloudApi,
|
||||
apiKey: 'your-openai-api-key-here',
|
||||
systemPrompt: 'You are an expert debugger.',
|
||||
temperature: 0.3,
|
||||
maxTokens: 8000,
|
||||
);
|
||||
|
||||
// Custom model
|
||||
final CreateAgentCommand customAgent = CreateAgentCommand(
|
||||
name: 'Documentation Writer',
|
||||
description: 'Generates comprehensive documentation',
|
||||
type: AgentType.documenter,
|
||||
modelProvider: 'custom',
|
||||
modelName: 'custom-model-v1',
|
||||
providerType: ModelProviderType.custom,
|
||||
modelEndpoint: 'https://api.example.com/v1/chat',
|
||||
apiKey: 'custom-api-key',
|
||||
systemPrompt: 'You are a technical documentation expert.',
|
||||
temperature: 0.6,
|
||||
maxTokens: 6000,
|
||||
conversationWindowSize: 20,
|
||||
);
|
||||
|
||||
// Create all agents
|
||||
await client.createAgent(localAgent);
|
||||
await client.createAgent(cloudAgent);
|
||||
await client.createAgent(customAgent);
|
||||
} finally {
|
||||
client.dispose();
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user