vstack 0.51.0

vstack 0.51.0

Organizational behavior, practiced on AI agents. vstack is a curated library
of 34 diagnostic patterns drawn from organizational behavior, social psychology,
and group dynamics — each rewritten for the domain of AI agents rather than
human teams.

Install

pip install valanistack==0.51.0

Optional extras: [anthropic], [openai], [ollama], [mcp], [api],
[browser], [langchain], [langgraph], [crewai], [llamaindex],
[pydantic-ai], [adapters], [all].

Docker:

docker pull ghcr.io/valani9/vstack:0.51.0

What changed in this release

Bring-your-own-traces: import the logs you already have into a vstack trace.

Added

• vstack.ingest — trace importers that build the canonical
  AgentTrace from real data:
  • from_chat_messages(messages, …) — OpenAI/Anthropic chat logs
    ({role, content, tool_calls}); maps system/user/assistant/tool to
    trace steps, infers goal (first user message) + outcome (last
    assistant message), flattens multimodal content.
  • from_otel_spans(spans, …) — OpenTelemetry spans (best-effort; reads
    gen_ai.* attributes as a dict or OTLP {key,value} list, orders by
    start time, classifies GenAI vs other spans).
• vstack-import CLI — vstack-import --format {messages,otel} input.json
  emits an AgentTrace JSON, designed to pipe straight into
  vstack-diagnose --trace -. (CLI surface: 59 → 60.)
• _ingest wired into CI (pytest + ruff + mypy --strict).

Compatibility

• All tests pass. Additive only; no breaking changes.

Verify the install

vstack-doctor          # 25+ install checks
vstack-hello           # 30-second end-to-end demo

Resources

• Docs — hosted mkdocs site
• CHANGELOG — full history
• Patterns index — all 34 patterns + literature anchors
• Security policy