128 lines
4.2 KiB
PHP
128 lines
4.2 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Core\Agentic\Mcp\Tools\Agent\Content;
|
|
|
|
use Illuminate\Support\Str;
|
|
use Core\Agentic\Models\AgentPlan;
|
|
use Mod\Content\Enums\BriefContentType;
|
|
use Mod\Content\Models\ContentBrief;
|
|
use Core\Agentic\Mcp\Tools\Agent\AgentTool;
|
|
|
|
/**
|
|
* Create a content brief for AI generation.
|
|
*
|
|
* Briefs can be linked to an existing plan for workflow tracking.
|
|
*/
|
|
class ContentBriefCreate extends AgentTool
|
|
{
|
|
protected string $category = 'content';
|
|
|
|
protected array $scopes = ['write'];
|
|
|
|
public function name(): string
|
|
{
|
|
return 'content_brief_create';
|
|
}
|
|
|
|
public function description(): string
|
|
{
|
|
return 'Create a content brief for AI generation';
|
|
}
|
|
|
|
public function inputSchema(): array
|
|
{
|
|
return [
|
|
'type' => 'object',
|
|
'properties' => [
|
|
'title' => [
|
|
'type' => 'string',
|
|
'description' => 'Content title',
|
|
],
|
|
'content_type' => [
|
|
'type' => 'string',
|
|
'description' => 'Type of content',
|
|
'enum' => BriefContentType::values(),
|
|
],
|
|
'service' => [
|
|
'type' => 'string',
|
|
'description' => 'Service context (e.g., BioHost, QRHost)',
|
|
],
|
|
'keywords' => [
|
|
'type' => 'array',
|
|
'description' => 'SEO keywords to include',
|
|
'items' => ['type' => 'string'],
|
|
],
|
|
'target_word_count' => [
|
|
'type' => 'integer',
|
|
'description' => 'Target word count (default: 800)',
|
|
],
|
|
'description' => [
|
|
'type' => 'string',
|
|
'description' => 'Brief description of what to write about',
|
|
],
|
|
'difficulty' => [
|
|
'type' => 'string',
|
|
'description' => 'Target audience level',
|
|
'enum' => ['beginner', 'intermediate', 'advanced'],
|
|
],
|
|
'plan_slug' => [
|
|
'type' => 'string',
|
|
'description' => 'Link to an existing plan',
|
|
],
|
|
],
|
|
'required' => ['title', 'content_type'],
|
|
];
|
|
}
|
|
|
|
public function handle(array $args, array $context = []): array
|
|
{
|
|
try {
|
|
$title = $this->requireString($args, 'title', 255);
|
|
$contentType = $this->requireEnum($args, 'content_type', BriefContentType::values());
|
|
} catch (\InvalidArgumentException $e) {
|
|
return $this->error($e->getMessage());
|
|
}
|
|
|
|
$plan = null;
|
|
if (! empty($args['plan_slug'])) {
|
|
$plan = AgentPlan::where('slug', $args['plan_slug'])->first();
|
|
if (! $plan) {
|
|
return $this->error("Plan not found: {$args['plan_slug']}");
|
|
}
|
|
}
|
|
|
|
// Determine workspace_id from context
|
|
$workspaceId = $context['workspace_id'] ?? null;
|
|
|
|
$brief = ContentBrief::create([
|
|
'workspace_id' => $workspaceId,
|
|
'title' => $title,
|
|
'slug' => Str::slug($title).'-'.Str::random(6),
|
|
'content_type' => $contentType,
|
|
'service' => $args['service'] ?? null,
|
|
'description' => $args['description'] ?? null,
|
|
'keywords' => $args['keywords'] ?? null,
|
|
'target_word_count' => $args['target_word_count'] ?? 800,
|
|
'difficulty' => $args['difficulty'] ?? null,
|
|
'status' => ContentBrief::STATUS_PENDING,
|
|
'metadata' => $plan ? [
|
|
'plan_id' => $plan->id,
|
|
'plan_slug' => $plan->slug,
|
|
] : null,
|
|
]);
|
|
|
|
return $this->success([
|
|
'brief' => [
|
|
'id' => $brief->id,
|
|
'title' => $brief->title,
|
|
'slug' => $brief->slug,
|
|
'status' => $brief->status,
|
|
'content_type' => $brief->content_type instanceof BriefContentType
|
|
? $brief->content_type->value
|
|
: $brief->content_type,
|
|
],
|
|
]);
|
|
}
|
|
}
|