Overview

use Cognesy\Polyglot\Decision\Decision;

$decision = Decision::using('typesafe');
// @doctest id="f42f"

use Cognesy\Polyglot\Decision\Collections\ChoiceOptions;
use Cognesy\Polyglot\Decision\Collections\Questions;
use Cognesy\Polyglot\Decision\Collections\ScoreLevels;
use Cognesy\Polyglot\Decision\Data\ChoiceOption;
use Cognesy\Polyglot\Decision\Data\NoulCriteria;
use Cognesy\Polyglot\Decision\Decision;
use Cognesy\Polyglot\Decision\Questions\Choice;
use Cognesy\Polyglot\Decision\Questions\Noul;
use Cognesy\Polyglot\Decision\Questions\Score;

$questions = Questions::of(
    new Noul(
        id: 'billing',
        instructions: 'Is this message about a billing problem?',
        criteria: new NoulCriteria(
            true: 'A payment, charge, invoice, or refund is involved.',
            false: 'The message is unrelated to billing.',
        ),
    ),
    new Choice(
        id: 'tone',
        options: ChoiceOptions::of(
            new ChoiceOption('calm'),
            new ChoiceOption('frustrated'),
            new ChoiceOption('angry'),
        ),
        instructions: 'What is the customer tone?',
    ),
    new Score(
        id: 'urgency',
        levels: ScoreLevels::of('can wait', 'this week', 'today'),
        instructions: 'How urgently should this message be handled?',
    ),
);

$answers = Decision::using('typesafe')
    ->with(
        input: 'I was charged twice. Please fix this today.',
        questions: $questions,
    )
    ->get();

$billingProbability = $answers->noul('billing')->probability();
$tone = $answers->choice('tone')->value();
$urgency = $answers->score('urgency')->value();
// @doctest id="4c03"

$options = ChoiceOptions::of(...array_map(
    static fn (array $route): ChoiceOption => new ChoiceOption(
        id: $route['id'],
        description: $route['description'],
    ),
    $availableRoutes,
));

$question = new Choice(
    id: 'route',
    options: $options,
    instructions: 'Which available route best fits this request?',
);
// @doctest id="a409"

use Cognesy\Polyglot\Decision\Data\JsonContent;

$state = JsonContent::object([
    'message' => 'Please reverse the duplicate charge.',
    'account' => ['plan' => 'pro', 'charge_count' => 2],
]);

$instructions = JsonContent::object([
    'task' => 'Classify the support route.',
    'policy_version' => 3,
]);
// @doctest id="c10d"

use Cognesy\Polyglot\Decision\Config\DecisionConfig;
use Cognesy\Polyglot\Decision\Data\DecisionRequest;
use Cognesy\Polyglot\Decision\DecisionRuntime;

$runtime = DecisionRuntime::fromConfig(
    DecisionConfig::fromPreset('typesafe'),
);

$request = new DecisionRequest(
    input: $state,
    questions: $questions,
);

$pending = $runtime->create($request); // no network I/O yet
$requestId = $pending->request()->id()->toString();
$executionId = $pending->executionId();
$response = $pending->response();       // executes once
$same = $pending->response();           // memoized; no second request
// @doctest id="1955"

use Cognesy\Polyglot\Decision\Config\DecisionRetryPolicy;

$pending = Decision::using('typesafe')
    ->with(
        input: $state,
        questions: $questions,
        retryPolicy: new DecisionRetryPolicy(
            maxAttempts: 3,
            baseDelayMs: 250,
            maxDelayMs: 4000,
        ),
    )
    ->create();
// @doctest id="c093"

POLYGLOT_TYPESAFE_LIVE=1 php vendor/bin/pest packages/polyglot/tests/Integration/TypesafeLiveTest.php
# @doctest id="835c"