$params */ public static function notification(string $method, array $params = []): static { return new static(new Notification($method, $params)); } public static function text(string $text): static { return new static(new Text($text)); } public static function html(string $path): static { $path = str_starts_with($path, '/') || preg_match('/^[a-zA-Z]:[\\\\\\/]/', $path) ? $path : resource_path($path); if (! file_exists($path)) { throw new InvalidArgumentException("File not found at path [{$path}]."); } return static::text((string) file_get_contents($path)); } /** * @param array $data * @param array $mergeData */ public static function view(string $view, array $data = [], array $mergeData = []): static { return static::text(view($view, $data, $mergeData)->render()); } /** * @internal * * @throws JsonException */ public static function json(mixed $content): static { return static::text(json_encode($content, JSON_THROW_ON_ERROR | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE)); } public static function blob(string $content): static { return new static(new Blob($content)); } /** * @param array $response */ public static function structured(array $response): ResponseFactory { if ($response === []) { throw new InvalidArgumentException('Structured content cannot be empty.'); } try { $json = json_encode($response, JSON_THROW_ON_ERROR | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE); } catch (JsonException $jsonException) { throw new InvalidArgumentException("Invalid structured content: {$jsonException->getMessage()}", 0, $jsonException); } $content = Response::text($json); return (new ResponseFactory($content))->withStructuredContent($response); } public static function error(string $text): static { return new static(new Text($text), isError: true); } public function content(): Content { return $this->content; } /** * @param Response|array $responses */ public static function make(Response|array $responses): ResponseFactory { return new ResponseFactory($responses); } /** * @param array|string $meta */ public function withMeta(array|string $meta, mixed $value = null): static { $this->content->setMeta($meta, $value); return $this; } public static function audio(string $data, string $mimeType = 'audio/wav'): static { return new static(new Audio($data, $mimeType)); } public static function image(string $data, string $mimeType = 'image/png'): static { return new static(new Image($data, $mimeType)); } /** * @param string|class-string|Resource|ResourceLink $uri * @param array $annotations * @param list $icons */ public static function resourceLink( string|Resource|ResourceLink $uri, ?string $name = null, ?string $mimeType = null, ?string $title = null, ?string $description = null, ?int $size = null, array $annotations = [], array $icons = [], ): static { if (is_string($uri) && is_subclass_of($uri, Resource::class)) { $uri = Container::getInstance()->make($uri); } $link = match (true) { $uri instanceof ResourceLink => $uri, $uri instanceof Resource => (new ResourceLink( uri: $uri->uri(), name: $name ?? $uri->name(), mimeType: $mimeType ?? $uri->mimeType(), title: $title ?? $uri->title(), description: $description ?? $uri->description(), size: $size, annotations: array_merge($uri->annotations(), $annotations), icons: $icons === [] ? $uri->resolvedIcons() : $icons, )), default => new ResourceLink( uri: $uri, name: $name ?? throw new InvalidArgumentException('Resource link name is required when using a URI string.'), mimeType: $mimeType, title: $title, description: $description, size: $size, annotations: $annotations, icons: $icons, ), }; return new static($link); } public static function fromStorage(string $path, ?string $disk = null, ?string $mimeType = null): static { /** @var FilesystemAdapter $storage */ $storage = Storage::disk($disk); try { $data = $storage->get($path); } catch (UnableToReadFile $unableToReadFile) { throw new InvalidArgumentException("File not found at path [{$path}].", 0, $unableToReadFile); } if ($data === null) { throw new InvalidArgumentException("File not found at path [{$path}]."); } $mimeType ??= $storage->mimeType($path) ?: throw new InvalidArgumentException( "Unable to determine MIME type for [{$path}].", ); return match (true) { str_starts_with($mimeType, 'image/') => static::image($data, $mimeType), str_starts_with($mimeType, 'audio/') => static::audio($data, $mimeType), default => throw new InvalidArgumentException("Unsupported MIME type [{$mimeType}] for [{$path}]."), }; } public function asAssistant(): static { return new static($this->content, Role::Assistant, $this->isError); } public function isNotification(): bool { return $this->content instanceof Notification; } public function isError(): bool { return $this->isError; } public function role(): Role { return $this->role; } }