keel-context / sdk

v0.13.0 2026-10-21 00:33 UTC

Requires

• php: >=8.1
• ext-json: *

Apache-2.0

Published on Packagist.org on 2026-10-22 12:22 UTC

README

Runtime for the clients keel sdk php <cartridge> --package '<Namespace>' generates: the event envelope and the five Keel tools over HTTP (keel serve --transport http). PHP 8.1+, no dependencies (curl when present, streams otherwise).

composer require keel-context/sdk
keel sdk php examples/fleet -o src/Keel/Fleet.php --package 'App\Keel\Fleet'

$keel = \App\Keel\Fleet\Keel::client('http://keel.internal:8000', 'acme-logistics', getenv('KEEL_SECRET'));
$keel->events([
    \App\Keel\Fleet\Emit::tireDepthMeasured('acme-logistics', \App\Keel\Fleet\Subjects::tire('T-9001'), new DateTimeImmutable(), 'tires', new \App\Keel\Fleet\TireDepthMeasuredPayload('MXK-4821', 'P3', 2.6)),
]);
$keel->context(\App\Keel\Fleet\Subjects::tire('T-9001'))['evaluation']['tire_critical']; // true

The generated Keel::client() takes base URL, tenant, secret and agent. For a timeout (seconds, default 30) or a traceparent (sent as the W3C header on every call; Keel stores it with every write), construct the runtime client directly:

$keel = new \Keel\Sdk\Client('http://keel.internal:8000', 'acme-logistics', getenv('KEEL_SECRET'), timeout: 10, traceparent: $traceparent);

context(), history() and annotate() ask for detail 'full' ($detail takes 'concise' or 'brief' for context, ['detail' => 'concise'] for history, detail: 'ack' for annotate), and history(), search() and related() return every entry unless you pass a limit (['limit' => n], or related()'s $limit). A subject nothing is known about comes back as ['subject' => ..., 'found' => false, 'as_of' => ..., 'watermark' => ...].

A refusal from the server is a Keel\Sdk\KeelError with $status and $detail. Payload classes are readonly value objects with toArray(); enums in the cartridge become PHP enums.