Skip to content

Commit c67005a

Browse files
committed
feat: compile LaTeX paper to PDF + fix rendering issues
- Compiled agenticworkflow-paper.pdf (5 pages, 246KB) - Updated test count from 250 to 281 across abstract, tables, conclusion - Added Phase 8 (persistence) and Phase 9 (concurrent) to test table - Fixed claim-to-test table overflow with narrower columns - Fixed circuit breaker line-break artifact with mbox - README now links to PDF (not .tex), matching memory convention - Fixed "Capabilitys" typo
1 parent 3a8798d commit c67005a

3 files changed

Lines changed: 35 additions & 34 deletions

File tree

README.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
<a href="#install"><img src="https://img.shields.io/badge/cargo_install-agentic--workflow-F59E0B?style=for-the-badge&logo=rust&logoColor=white" alt="cargo install"></a>
1313
<a href="#mcp-server"><img src="https://img.shields.io/badge/MCP_Server-agentic--workflow--mcp-10B981?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjIiPjxwYXRoIGQ9Ik0xMiAydjIwTTIgMTJoMjAiLz48L3N2Zz4=&logoColor=white" alt="MCP Server"></a>
1414
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-22C55E?style=for-the-badge" alt="MIT License"></a>
15-
<a href="paper/agenticworkflow-paper.tex"><img src="https://img.shields.io/badge/Research-Paper-8B5CF6?style=for-the-badge" alt="Research Paper"></a>
15+
<a href="paper/agenticworkflow-paper.pdf"><img src="https://img.shields.io/badge/Research-Paper-8B5CF6?style=for-the-badge" alt="Research Paper"></a>
1616
<a href="docs/api-reference.md"><img src="https://img.shields.io/badge/format-.awf-3B82F6?style=for-the-badge" alt=".awf format"></a>
1717
</p>
1818

@@ -25,7 +25,7 @@
2525
</p>
2626

2727
<p align="center">
28-
<a href="#problems-solved">Problems Solved</a> · <a href="#quickstart">Quickstart</a> · <a href="#the-24-capabilities">24 Capabilitys</a> · <a href="#how-it-works">How It Works</a> · <a href="#mcp-tools">MCP Tools</a> · <a href="#benchmarks">Benchmarks</a> · <a href="#install">Install</a> · <a href="docs/api-reference.md">API</a> · <a href="paper/agenticworkflow-paper.tex">Paper</a>
28+
<a href="#problems-solved">Problems Solved</a> · <a href="#quickstart">Quickstart</a> · <a href="#the-24-capabilities">24 Capabilities</a> · <a href="#how-it-works">How It Works</a> · <a href="#mcp-tools">MCP Tools</a> · <a href="#benchmarks">Benchmarks</a> · <a href="#install">Install</a> · <a href="docs/api-reference.md">API</a> · <a href="paper/agenticworkflow-paper.pdf">Paper</a>
2929
</p>
3030

3131
---
@@ -97,11 +97,11 @@ Four steps. One DAG. Approval gate before production. Retry intelligence. Rollba
9797

9898
<a name="the-24-capabilities"></a>
9999

100-
## The 24 Capabilitys
100+
## The 24 Capabilities
101101

102102
Six categories. Twenty-four capabilities. Every orchestration pattern that exists or will exist.
103103

104-
### Core Engine (Capabilitys 1-4)
104+
### Core Engine (Capabilities 1-4)
105105

106106
| # | Capability | What it solves |
107107
|:--|:----------|:---------------|
@@ -110,7 +110,7 @@ Six categories. Twenty-four capabilities. Every orchestration pattern that exist
110110
| 3 | **Intelligent Scheduling** | Context-aware cron -- skip holidays, respect service health, learn optimal times |
111111
| 4 | **Trigger Omniscience** | Universal triggers -- file, webhook, schedule, API, workflow output, custom |
112112

113-
### Resilience (Capabilitys 5-8)
113+
### Resilience (Capabilities 5-8)
114114

115115
| # | Capability | What it solves |
116116
|:--|:----------|:---------------|
@@ -119,30 +119,30 @@ Six categories. Twenty-four capabilities. Every orchestration pattern that exist
119119
| 7 | **Circuit Breaker Intelligence** | Workflow-aware breakers -- don't start step 1 if step 3's service is down |
120120
| 8 | **Dead Letter Intelligence** | Classify failures, auto-retry on recovery, surface actionable summaries |
121121

122-
### Processing (Capabilitys 9-11)
122+
### Processing (Capabilities 9-11)
123123

124124
| # | Capability | What it solves |
125125
|:--|:----------|:---------------|
126126
| 9 | **Batch Processing** | Controlled parallelism, progress checkpoints, resume from interruption |
127127
| 10 | **Stream Processing** | Continuous data -- file watch, webhooks, polling -- with backpressure and windowing |
128128
| 11 | **Fan-Out / Fan-In** | "Query 5 APIs in parallel, wait for 3, merge results" as a first-class primitive |
129129

130-
### Governance (Capabilitys 12-14)
130+
### Governance (Capabilities 12-14)
131131

132132
| # | Capability | What it solves |
133133
|:--|:----------|:---------------|
134134
| 12 | **Approval Gates** | Escalation chains, conditional auto-approve, time-bounded, delegation |
135135
| 13 | **Audit Trail** | Structured, queryable events -- who did what, when, to which resource |
136136
| 14 | **Idempotency** | Built-in deduplication -- never send duplicate emails or double-charge |
137137

138-
### State (Capabilitys 15-16)
138+
### State (Capabilities 15-16)
139139

140140
| # | Capability | What it solves |
141141
|:--|:----------|:---------------|
142142
| 15 | **State Machine Engine** | First-class FSM -- Created → Paid → Shipped → Delivered with guard conditions |
143143
| 16 | **Variable Scoping** | Hierarchical scope -- workflow → branch → step → iteration, with type checking |
144144

145-
### Intelligence (Capabilitys 17-24)
145+
### Intelligence (Capabilities 17-24)
146146

147147
| # | Capability | What it solves |
148148
|:--|:----------|:---------------|
@@ -406,7 +406,7 @@ Each section independently BLAKE3-checksummed. Corruption in one section doesn't
406406
| **Total** | **281** | All passing |
407407

408408
**One research paper:**
409-
- [AgenticWorkflow: A Universal Orchestration Engine for Agent Coordination via MCP (LaTeX)](paper/agenticworkflow-paper.tex)
409+
- [AgenticWorkflow: A Universal Orchestration Engine for Agent Coordination via MCP (5 pages, 7 tables)](paper/agenticworkflow-paper.pdf)
410410

411411
---
412412

paper/agenticworkflow-paper.pdf

241 KB
Binary file not shown.

paper/agenticworkflow-paper.tex

Lines changed: 25 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@
5151
The engine introduces 24 capabilities spanning execution, resilience, governance, state management, templates, and intelligence, exposed through 124 MCP (Model Context Protocol) tools.
5252
Unlike existing orchestration systems (Airflow, Temporal, GitHub Actions, Zapier), AgenticWorkflow is AI-native: agents can create, modify, reason about, and optimize workflows at runtime.
5353
All state persists in a single \texttt{.awf} binary file format with BLAKE3 integrity verification and LZ4 compression.
54-
The implementation comprises 9,505 lines of Rust across 4 crates, with 250 tests achieving 0 failures.
54+
The implementation comprises 9,505 lines of Rust across 4 crates, with 281 tests achieving 0 failures.
5555
Stress testing validates DAG operations on 1,000-step graphs in $<$50ms, 10,000-item batch creation in $<$500ms, and 1,000 FSM transitions in $<$100ms on Apple ARM64 hardware.
5656
The system is fully open-source under the MIT license.
5757
\end{abstract}
@@ -216,7 +216,7 @@ \subsection{Resilience Layer}
216216
\end{cases}
217217
\end{equation}
218218

219-
\textbf{Validated by:} \texttt{test\_circuit\_breaker\_opens\_after\_threshold}, \texttt{stress\_circuit\_breaker\_rapid\_failures} (1K failures $<$500ms).
219+
\textbf{Validated by:} \mbox{\texttt{test\_circuit\_breaker\_opens\_after\_threshold}}, \mbox{\texttt{stress\_circuit\_breaker\_rapid\_failures}} (1K failures $<$500ms).
220220

221221
\subsection{Governance Layer}
222222

@@ -327,7 +327,7 @@ \section{Evaluation}
327327

328328
\subsection{Test Coverage}
329329

330-
250 tests organized in 7 phases plus inline unit tests:
330+
281 tests organized in 9 phases plus inline unit tests:
331331

332332
\begin{table}[h]
333333
\centering
@@ -339,15 +339,17 @@ \subsection{Test Coverage}
339339
\textbf{Phase} & \textbf{Focus} & \textbf{Tests} \\
340340
\midrule
341341
Phase 1 & Type system, serde, variants & 59 \\
342-
Phase 2 & Engine operations (DAG, FSM, ...) & 31 \\
343-
Phase 3 & Resilience (retry, rollback, ...) & 27 \\
344-
Phase 4 & Governance (approval, audit, ...) & 34 \\
342+
Phase 2 & Engine operations (DAG, FSM, \ldots) & 31 \\
343+
Phase 3 & Resilience (retry, rollback, \ldots) & 27 \\
344+
Phase 4 & Governance (approval, audit, \ldots) & 27 \\
345345
Phase 5 & Template + Intelligence & 31 \\
346346
Phase 6 & Edge cases + error paths & 28 \\
347347
Phase 7 & Stress tests (1K--10K scale) & 14 \\
348-
Inline & Unit tests in source modules & 26 \\
348+
Phase 8 & Persistence + step execution & 39 \\
349+
Phase 9 & Concurrent access & 11 \\
350+
Inline & Unit tests in source modules & 14 \\
349351
\midrule
350-
\textbf{Total} & & \textbf{250} \\
352+
\textbf{Total} & & \textbf{281} \\
351353
\bottomrule
352354
\end{tabular}
353355
\end{table}
@@ -390,25 +392,24 @@ \subsection{Claim-to-Test Traceability}
390392
\caption{Every paper claim is backed by a named, passing test.}
391393
\label{tab:traceability}
392394
\scriptsize
393-
\begin{tabular}{p{3.8cm}p{3.8cm}}
395+
\begin{tabular}{p{2.8cm}p{4.2cm}}
394396
\toprule
395397
\textbf{Paper Claim} & \textbf{Validating Test} \\
396398
\midrule
397-
$O(V+E)$ cycle detection & \texttt{test\_dag\_cycle\_detection} \\
398-
Exponential backoff capped & \texttt{test\_retry\_strategy\_exponential\_backoff} \\
399-
Reverse-order rollback & \texttt{test\_rollback\_preview\_full\_reverse\_order} \\
400-
Circuit opens after $N$ fails & \texttt{test\_circuit\_breaker\_opens\_after\_threshold} \\
401-
BLAKE3 corruption detection & \texttt{test\_edge\_awf\_corrupt\_checksum} \\
402-
1K-step DAG in $<$50ms & \texttt{stress\_dag\_1000\_steps\_linear\_chain} \\
403-
10K batch in $<$500ms & \texttt{stress\_batch\_10k\_items} \\
404-
1K FSM transitions $<$100ms & \texttt{stress\_fsm\_1000\_transitions} \\
405-
Variable cascade 1K depth & \texttt{stress\_variable\_1000\_scopes} \\
406-
Anomaly detection 1K execs & \texttt{stress\_archaeology\_1000\_fingerprints} \\
407-
Drift detection (1.5$\times$) & \texttt{test\_evolution\_drift\_detection} \\
408-
Privacy verification & \texttt{test\_collective\_privacy\_detect\_secrets} \\
399+
Cycle detection & \texttt{test\_dag\_cycle\_detection} \\
400+
Backoff capped & \texttt{test\_retry\_strategy\_exponential\_backoff} \\
401+
Reverse rollback & \texttt{test\_rollback\_preview\_full\_reverse\_order} \\
402+
Circuit opens & \texttt{test\_circuit\_breaker\_opens\_after\_threshold} \\
403+
Corrupt detect & \texttt{test\_edge\_awf\_corrupt\_checksum} \\
404+
1K DAG $<$50ms & \texttt{stress\_dag\_1000\_steps\_linear\_chain} \\
405+
10K batch $<$500ms & \texttt{stress\_batch\_10k\_items} \\
406+
1K FSM $<$100ms & \texttt{stress\_fsm\_1000\_transitions} \\
407+
1K var cascade & \texttt{stress\_variable\_1000\_scopes} \\
408+
Anomaly detect & \texttt{stress\_archaeology\_1000\_fingerprints} \\
409+
Drift 1.5$\times$ & \texttt{test\_evolution\_drift\_detection} \\
410+
Privacy check & \texttt{test\_collective\_privacy\_detect\_secrets} \\
409411
Unicode support & \texttt{test\_unicode\_in\_step\_names} \\
410-
Immutability enforcement & \texttt{test\_edge\_variable\_immutable\_reject} \\
411-
Approval chain escalation & \texttt{test\_approval\_escalate\_to\_next} \\
412+
Immutability & \texttt{test\_edge\_variable\_immutable\_reject} \\
412413
\bottomrule
413414
\end{tabular}
414415
\end{table}
@@ -457,7 +458,7 @@ \section{Conclusion}
457458
The governance layer (approval gates, audit trails, variable scoping) enables enterprise compliance.
458459
The intelligence layer (archaeology, prediction, evolution, dream) enables continuous workflow optimization.
459460

460-
With 9,505 lines of Rust, 250 tests (0 failures), and sub-second performance at 10K scale, AgenticWorkflow demonstrates that comprehensive orchestration can be delivered as a lightweight, portable, AI-native library.
461+
With 9,505 lines of Rust, 281 tests (0 failures), and sub-second performance at 10K scale, AgenticWorkflow demonstrates that comprehensive orchestration can be delivered as a lightweight, portable, AI-native library.
461462

462463
\paragraph{Availability.}
463464
Open-source under MIT license at \url{https://github.com/agentralabs/agentic-workflow}.

0 commit comments

Comments
 (0)