Joseph M OBrien joe

0 Followers · 0 Following

• Joined on 2026-03-15

Repositories Projects Packages Public Activity Starred Repositories

bamlish (0.1.0)

Published 2026-05-31 14:24:08 -05:00 by joe

Installation

Set up this registry in the Cargo configuration file (for example ~/.cargo/config.toml):

[registry]
default = "gitea"

[registries.gitea]
index = "sparse+" # Sparse index
# index = "" # Git

[net]
git-fetch-with-cli = true

To install the package using Cargo, run the following command:

cargo add bamlish@0.1.0

For more information on the Cargo registry, see the documentation.

About this package

BAML schema library and generated Rust client for structured LLM output across the dev workspace

bamlish

Structured LLM output library for the dev workspace. Defines BAML schemas and exposes a generated Rust client (baml_client) for calling AI functions with type-safe return values.

Covers: git branch analysis, multi-role council synthesis, Claude session parsing, doob task analysis, maestro session analysis, devloop agent planning, and meta-schema generation.

Usage

Add to Cargo.toml:

bamlish = { path = "../bamlish" }

Types and the async call surface are exposed at the crate root:

use bamlish::{B, BranchInsight, CitedFinding};

let insight: BranchInsight = B.AnalyzeBranch.call(
    "feature/auth".into(),
    commits,
    sessions,
    commit_count,
    session_count,
    None,
).await?;

For council analysis, run the role functions in parallel and synthesize:

use bamlish::{B, CouncilInsight};

let (strict, creative, general) = tokio::join!(
    B.AnalyzeBranch_StrictCritic.call(...),
    B.AnalyzeBranch_CreativeExplorer.call(...),
    B.AnalyzeBranch_GeneralAnalyst.call(...),
);
let council: CouncilInsight = B.SynthesizeCouncilInsights.call(...).await?;

BAML functions by domain

Domain	Key functions
Branch analysis	AnalyzeBranch, AnalyzeBranchWithCodeStructure, ExtractUserIntent, AnswerTimelineQuestion
Council	AnalyzeBranch_StrictCritic, _CreativeExplorer, _GeneralAnalyst, _SecurityReviewer, _PerformanceAnalyst, SynthesizeCouncilInsights
Conversation	SummarizeConversation, AnalyzeToolUsage, AnalyzeTaskProgression, QuickSummarize, GenerateSessionTitle
Session logs	AnalyzeSession, AnalyzeErrorPatterns, SummarizeProductivity, ParseLogEntry
Doob	SummarizeProjectTodos, TriageOpenTodos, GenerateStandup, SummarizeHandoff
Maestro	AnalyzeMaestroSession, AnalyzeMultiSession, RecommendIsolationMode, AnalyzeTaskExecution
DevLoop	BuildAgentSystem, AnalyzeCode, CreatePlan
Meta	GetMetaBamlFunctions, GetMetaBamlClasses, GetMetaBamlEnums

LLM clients

Client	Pool	Used for
CustomGPT5	OpenAI GPT-5 → Anthropic Sonnet4	Synthesis, complex reasoning
CustomGPT5Mini	OpenAI GPT-5Mini → Anthropic Haiku	Lightweight tasks, council roles
CustomFast	round-robin Mini/Haiku	Load distribution

Both CustomGPT5 and CustomGPT5Mini have retry_policy Exponential (max 2, 300ms base, 1.5×) for 429 backoff during parallel council execution. A schema lint test guards this invariant.

Environment variables

Variable	Purpose
OPENAI_API_KEY	OpenAI provider
ANTHROPIC_API_KEY	Anthropic provider

At least one is required for live calls. Schema lint tests run without any key.

Regenerating the client

Schema sources live in baml_src/. After editing any .baml file:

uvx --from baml-py@0.221.0 baml-cli generate

The generators.baml version field and the baml crate version in Cargo.toml must match.

Dev tooling prerequisites

cargo install cargo-deny --locked

Running tests

# Schema lint only (no API key required)
cargo test

# BAML function tests (requires API key)
npx @boundaryml/baml-cli test

# Benchmarks
cargo bench

Dependencies

ID	Version
baml	^0.221.0
serde_json	^1.0
criterion	^0.5
tokio	^1

Keywords

baml llm ai structured-output

Details

Cargo

2026-05-31 14:24:08 -05:00

2

MIT OR Apache-2.0

166 KiB

Assets (1)

bamlish-0.1.0.crate 166 KiB

Versions (1) View all

0.1.0 2026-05-31