speedfin / speedfin-ai-wrapper

1.0.17 2026-09-30 08:31 UTC

Requires

• php: >=8.2
• symfony/config: ^6.4 || ^7.4 || ^8.0
• symfony/dependency-injection: ^6.4 || ^7.4 || ^8.0
• symfony/http-client: ^6.4 || ^7.4 || ^8.0
• symfony/http-foundation: ^6.4 || ^7.4 || ^8.0
• symfony/http-kernel: ^6.4 || ^7.4 || ^8.0
• symfony/mime: ^6.4 || ^7.4 || ^8.0
• symfony/yaml: ^6.4 || ^7.4 || ^8.0

Requires (Dev)

• phpunit/phpunit: ^11.5 || ^12.0

MIT

• admin
• ai
• knowledge
• rag

Published on Packagist.org on 2026-09-30 08:31 UTC

README

Biblioteka integracji z apps/ai: CRUD Knowledge, review, diagnostyka, pliki, macierze, plany przetwarzania, historia kart hipotecznych oraz publiczne RAG.

Wszystkie 20 kolekcji mają stronicowane odczyty JSON i JSON-LD. Odczyt strony wykonuje jedno żądanie. Pobranie całości wymaga jawnego iterateAll() albo CollectionPageIterator::items(). Zwykły JSON nie dostarcza totalItems.

Kontrakt, metody, DTO i migracja konsumentów

Testy:

composer install
composer test

Jeżeli zależności są już zainstalowane w apps/ai, z katalogu infrastruktury:

AI_WRAPPER_TEST_AUTOLOAD="$PWD/apps/ai/vendor/autoload.php" \
  apps/ai/vendor/bin/phpunit -c packages/speedfin-ai-wrapper/phpunit.xml.dist

Testy HTTP są opcjonalne, tylko do odczytu, bez zależności od danych demo:

AI_WRAPPER_TEST_AUTOLOAD="$PWD/apps/ai/vendor/autoload.php" \
AI_WRAPPER_HTTP_BASE_URL=https://ai.speedfin.localhost \
AI_WRAPPER_HTTP_INSECURE=1 \
  apps/ai/vendor/bin/phpunit -c packages/speedfin-ai-wrapper/phpunit.xml.dist

AI_WRAPPER_HTTP_INSECURE=1 dotyczy wyłącznie testów z lokalnym certyfikatem. W środowisku z autoryzacją ustaw AI_WRAPPER_HTTP_TOKEN w środowisku procesu. Produkcyjna konfiguracja domeny API i dostawcy tokenu pozostaje bez zmian.