feat(typescript-client): add AbortSignal support to all HindsightClient methods

[harryplusplus]

Summary

Expose per-request AbortSignal support on every public method of the TypeScript HindsightClient. The generated @hey-api/openapi-ts SDK already accepts signal on each request call (its RequestOptions type extends RequestInit), but the high-level HindsightClient wrapper did not surface it to callers.

Motivation

In an agent harness, Hindsight calls (retain, recall, reflect) run under a time budget — best-effort before the next LLM invocation. When a call exceeds the budget, the caller drops the promise and moves on — but without an explicit AbortSignal, the server has no way to know that. It keeps running the full pipeline (fact extraction, embedding, consolidation) for a result no one is waiting for. Passing AbortSignal gives the server the chance to stop when the client is done waiting. Without this change, the only way to pass an AbortSignal is to drop down to the low-level generated sdk namespace.

Changes

hindsight-clients/typescript/src/index.ts

Added signal?: AbortSignal to the options bag of all public methods and forwarded it to the underlying generated SDK call. Formatted with the root .prettierrc.json (trailingComma: es5, printWidth: 100) per the lint.sh that now covers the TypeScript client.

Methods grouped by how they expose the option:

• Optional-options methods (retain, retainBatch, retainFiles, recall, reflect, listMemories, createDirective, listDirectives, createMentalModel, listMentalModels, listDocuments): signal is an optional field inside the existing options bag.
• Required-options methods (createBank, updateBankConfig, updateDirective, updateMentalModel, updateDocument): signal added as an optional field alongside the required fields — no breaking change.
• No-options methods (setMission, getBankProfile, getBankConfig, resetBankConfig, deleteBank, getDirective, deleteDirective, getMentalModel, refreshMentalModel, deleteMentalModel, getMentalModelHistory, getDocument, deleteDocument): accept a new optional options?: { signal?: AbortSignal } parameter — backwards-compatible since it's optional.

hindsight-clients/typescript/tests/main_operations.test.ts

Added TestAbortSignal suite with 3 unit tests that mock the generated SDK and verify the signal is passed through:

• retain passes abort signal to SDK
• recall passes abort signal to SDK
• getBankProfile passes abort signal to SDK

These tests do not require a running Hindsight API server.

skills/hindsight-docs/

Regenerated docs skill files via ./scripts/generate-docs-skill.sh to sync with latest main changes (Oracle storage docs, Pydantic Logfire monitoring link). The verify-generated-files CI job requires these generated files to be up to date.

hindsight-tools/self-driving-agents/src/cli.ts

Applied prettier formatting to fix a multi-line template literal that was inconsistent with the root .prettierrc.json config. Caught by lint.sh in CI where $CI triggers LINT_TOOLS_ALL=1.

Usage Example

import { HindsightClient } from "@vectorize-io/hindsight-client";

const client = new HindsightClient({ baseUrl: "http://localhost:8888" });

// Cancel a long-running retain
const controller = new AbortController();
setTimeout(() => controller.abort(), 5000);

await client.retain("alice", "Alice loves AI", {
  signal: controller.signal,
});

Checklist

• Rebased onto latest main (v0.5.6)
• npm run build passes
• ./scripts/hooks/lint.sh passes (root .prettierrc.json)
• tsc --noEmit passes
• Tests added for new behavior (3/3 pass with mocked SDK)
• No generated code modified (only src/index.ts)
• No OpenAPI spec changes (no client regeneration needed)
• ./scripts/generate-docs-skill.sh produces no diff (skills files up to date)
• ./scripts/hooks/lint.sh produces no diff in CI (all tools formatted)

[nicoloboschi]

LGTM