Richard Palethorpe
495165266f
Report input tokens and frame-step output units in response metadata and record them through the existing usage accounting pipeline. Preserve the accounting rule and model-specific dimensions as JSON without extending the gRPC schema for each modality. Expose animation usage only under metadata.usage, validate counts before recording, and document the response contract and loaded-model location. Add coverage for transport, defaults, failures, persistence, and recording requests once with statistics enabled or disabled. Assisted-by: Codex:GPT-6 Signed-off-by: Richard Palethorpe <io@richiejp.com>
kimodocpp
Persistent gRPC adapter for the pinned kimodo.cpp C API. The small C++ bridge exposes upstream skeleton metadata and runtime configuration; Go exports the returned motion as a node-only animated GLB. See 3D animation for the API and runtime options.
make protogen-go
make -C backend/go/kimodocpp BUILD_TYPE=cpu
KIMODO_TEST_PACKAGE="$PWD/backend/go/kimodocpp/package" make -C backend/go/kimodocpp test
make -C backend/go/kimodocpp BUILD_TYPE=vulkan
Requires CMake 3.25+, a C++23 compiler, and Go. Vulkan additionally requires the Vulkan SDK with shader tooling. Linux and macOS/Apple Silicon CPU are supported; Metal is disabled because upstream implements CPU/Vulkan only.
Normal CI tests need no model downloads. To exercise real weights, set
KIMODO_TEST_LIBRARY to the built libkimodo.so (or dylib),
KIMODO_TEST_MOTION to a motion GGUF, KIMODO_TEST_TEXT to the complete text
GGUF beside tokenizer.gguf (or legacy bundle directory), and
KIMODO_TEST_DEVICE=cpu or vulkan, then run the tests.
The real-model test generates two clips with one session to cover reuse.
Set KIMODO_TEST_TEXT_LAYER_CHUNK=8 to exercise bounded streaming instead of
the default all-layer residency.
Upstream now respects the configured thread count in both encoders and keeps
motion weights and execution graphs resident. The adapter defaults to 32 text
layers so the text weights also stay resident between requests. When bumping
the pinned upstream commit, verify the C ABI layout/version and all three
skeleton families. Pin changes update a clean cached checkout automatically;
local source modifications stop the update rather than being discarded. Preserve
any such changes before using make clean to replace that generated checkout.
Response metadata
Animate3DWithMetadata returns UTF-8 JSON bytes in the generic gRPC
Result.metadata field. Kimodo populates usage.input_units with text token
count (including BOS), usage.output_units with frames × sampling steps, and
usage.accounting_rule with frame_steps_v1. usage.details retains
output_frames and sampling_steps. There is no separate protobuf usage type.
The HTTP handler returns this object under metadata, with usage only at
metadata.usage. Internal accounting reads those counts and records the request
once; no top-level HTTP usage summary is emitted. See the usage accounting documentation
for the distinct backend and HTTP formats, validation, and persistence behavior.