Ainalyn + Convilyn: Building the Bridge

Two products, one vision. How the workflow foundation we build today becomes the intelligence layer for a much simpler AI experience tomorrow.

Joel S.
Joel S.

Use Cases

Real scenarios: upstream trigger → workflow → downstream result

Use Case

Context In, Professional Email Out

Your boss forwarded a thread and said "handle this." Upload the context documents — get a ready-to-send email draft with the right tone.

Tutorials

Step-by-step guides for users and developers

View learning hub
Developer

SDK Documentation

Official TypeScript and Python SDKs with typed methods for every API resource. Auto-generated from our OpenAPI spec.

Open docs
Tutorial User Guide

Goal Lane: Your Step-by-Step Guide to AI Workflows

From uploading a file and selecting a workflow, through interactive checkpoints, to downloading your finished output. Walkthrough with AI Job Search Assistant.

The Story

Engineering

Architecture, measurements, and incidents
Engineering

The Deploy Paths I Thought Were Off

Every deploy workflow was disabled, and one job could still have shipped production on the next merge. A failing test was all that held it back. Two paths I thought were off, and the tests that now keep them gone.

Engineering

Let the Model Propose and a Regex Decide

A no-LLM gate that rejects any amount, large number or clause reference not found verbatim in the source, with an LLM judge that only watches. What it stopped on its first day, and how each case was resolved.

Engineering

I Deleted Seven Tools and Let the Agent Read the Template

Seven per-marketplace spreadsheet tools replaced by generic inspect and fill tools, with the agent mapping columns. A real template broke the tools in three layers, and the agent ignored an overwrite warning. The fixes, and what the trade costs.

Engineering

An Agent Without a Transcript Remembers Only What You Write Down

Running each turn without the chat history keeps the agent's input small and readable. The price was two memory bugs: asking for clarification twice, and forgetting the request after a clarification. Both fixed inside the design.

Engineering

Two Loops That Ate Our Agent Builder's Tokens

Eighteen model calls, five turns, nothing saved, and a slower loop around the whole project where every wall got one more layer. What we hit building an agent builder, and what to decide before you build a harness.

Engineering

The Tool Names I Gave My Agent Didn't Exist

An agent guessed block names a tool description never listed. That led to five places where my own text handed it tool ids that didn't exist, and two fixes: generate the names the agent reads, check the ones only tests read.

Engineering

What a Fail-Open Fallback Hid in My Agent's Tool Calls

Six agent tools moved behind an MCP server with a fail-open fallback. A field-path parity check caught every mismatch before the switch; after it, five of six calls were silently served by stand-ins until the logs gave it away.

Engineering

What Runs Again When a LangGraph Run Resumes

Resuming after interrupt() re-ran a node and submitted a paid job twice, async durability lost a checkpoint in a crash, an approval never got used up, and a retry replayed its own failure. Measured offline, with the design rules that follow.

Engineering

LangGraph's input_schema Narrows Reads, Not Writes

Any node can write any channel, a retry on the same thread goes through the reducers, and a subgraph checkpoints into the parent's store. Measured offline on langgraph 1.2.11, with the guards that follow.

Engineering

Cached Tokens, Counted Twice

LangChain's input_tokens includes the prompt cache; Anthropic's pricing assumes it doesn't. Feeding one into the other priced every cache hit twice and turned a token limit into turns × prefix size.

Engineering

The Tool-Call Contract Between LangChain and Bedrock Converse

An unanswered tool call that Bedrock rejects, and a langchain-aws upgrade that removed null from tool schemas while every test stayed green. What the adapter sends, how to pin it, and where each rule belongs.

Engineering

Tool Search Shrank the Prompt and Raised the Cost

99 tools bound per turn, a median of two legal. Letting the model search for tools cut schema tokens by two thirds and did not make runs cheaper, because the tool list was already prompt-cached.

Engineering

The Most Dangerous Test Is the One That Can't Fail

Emptying one list turned 177 passed into 9 skipped, exit 0. Why an empty input makes assertions true, the suite-level versions of the same failure, and the probe that finds them.

Engineering

An Agent Stuck in a Loop Never Raises

Five production loops that threw nothing and stayed under every timeout. What each one varied, why LangGraph's idle timeout misses the commonest one, and the detectors that catch them.

Engineering

When Prompt Fixes Stop Working, Read What the Model Actually Saw

Two prompt fixes and three runs on identical inputs left the grounding score flat. The model had been handed "parsed 6 sections" instead of the résumé. How to tell noise from effect, and how to print what a LangChain model actually received.

Architecture

Beta v0.1.0: One Charter for Spans, Events, and Logs

After three months of parallel observability paths, we collapsed everything to one OTel seam, one event taxonomy, and one redaction policy. The seven-phase charter that took us from alpha to beta.

Architecture

Alpha v0.11.0: Inside the Agent Infrastructure

LangGraph state machines, MCP capability servers, interactive checkpoints, and SSE streaming — plus lessons from studying Claude Code and Codex CLI open source.

Architecture

Alpha v0.10.0: Workflow Validation Framework

A 2-tier testing framework: lifecycle compliance (does the workflow complete correctly?) and goal-oriented content validation (does the output achieve its purpose?).

Architecture

Alpha v0.9.0: SSE Progress Streaming

Six event types, milestone-based progress calculation vs iteration fallback, connection recovery via event IDs, and the progress reporter protocol.

Architecture

Alpha v0.8.0: Token Budget Scaling

The formula max(100K, max_iterations × 10K) — why a fixed budget fails at both ends, and how it interacts with the iteration limit.

Architecture

Alpha v0.7.0: Conversation Context Management

How the agent manages 120-iteration conversation history — the trimming strategy, what gets preserved vs discarded, and the history loss bug we fixed.

Architecture

Alpha v0.6.0: Forced vs Auto Tool Mode

The threshold formula that switches the LLM from mandatory tool invocation to autonomous reasoning — and why control-flow tools are excluded.

Architecture

Alpha v0.5.0: Universal vs Specialized Prompts

One template drives every workflow in the catalog. The decision framework for when to write a 351-line specialized prompt instead — and why.

Architecture

Alpha v0.4.0: MCP Architecture

Capability-based MCP servers, the six file argument strategies, reference IDs for binary tool outputs, and the three control-flow tools.

Architecture

Alpha v0.3.0: Declarative Workflow Specs

How JSON spec files define nearly 100 distinct AI workflows without any new agent code — schema, preflight validation, and spec versioning.

Architecture

Alpha v0.2.0: Workflow as a Stateful Graph

How Goal Lane models agent execution as a 5-node graph with conditional routing — reason, call_tool, request_input, nudge, and finish.

Architecture

Alpha v0.1.0: The Two-Lane Architecture

Why Convilyn splits into two completely separate execution paths — and why a unified pipeline would have made both worse.

Playbooks

See your full workflow, start to finish

10 real-world scenarios — each one walks from the upstream trigger through Convilyn tools to the downstream deliverable, so you can see exactly where we fit.

Browse all playbooks

File In. Finished Work Out.

Nearly 100 AI workflows. Two lanes — Turbo for instant format conversion, Goal for multi-step intelligent processing. Free tier, no credit card required.

Try Convilyn Free