Skip to content

v0.1.0

Choose a tag to compare

@skybleak333 skybleak333 released this 30 Oct 15:26
· 37 commits to main since this release

First release of a PHP client for Hindsight agent memory, with long-term memory for Laravel AI SDK agents.

Client

  • Retain (single, batch, async), recall and reflect, plus banks, bank configuration, memories, documents, directives, mental models and operations. request() reaches any other endpoint.
  • waitForOperation() for async work, typed responses for the main calls, and one exception per failure mode.
  • Hindsight answers 200 for parameters it does not know and names them in an X-Ignored-Params header. The client turns that header into a warning for any PSR-3 logger, so a typo in options does not change results without a sign.

Laravel

  • Service provider, config, facade and php artisan hindsight:status.
  • Memory agent middleware: recalls relevant memories before the first step, retains the exchange after the step that ends the run. Best effort by default, with a 10-second timeout, so a Hindsight outage never takes the agent down.
  • Recall, Retain and Reflect tools for agents that should decide for themselves.

Tested

  • Every request in the unit tests is checked against Hindsight's OpenAPI 1.1.0 document, stricter than the server.
  • CI runs the integration suite against a real Hindsight 1.1.0 server (no LLM, no API keys), on PHP 8.2–8.5, Laravel 12 and 13, Laravel AI SDK 1.0 and 1.3, and the lowest allowed dependencies.

This is a community package, not affiliated with Vectorize.