Skip to content

cougaar-archive/cougaar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cougaar - Cognitive Agent Architecture

DARPA's Distributed Multi-Agent Framework (1997-2012)
Complete Source Code Archive - Version 12.7 (Final Release)


What is Cougaar?

Cougaar (Cognitive Agent Architecture) is a Java-based architecture for building large-scale distributed agent-based applications. It was developed by BBN Technologies (later Raytheon BBN Technologies) under sponsorship from the Defense Advanced Research Projects Agency (DARPA).

The project represented a $70+ million investment in distributed agent technology, originally developed for military logistics planning under the Advanced Logistics Project (ALP) and later extended through the UltraLog program for survivability in hostile network conditions.

Cougaar was years ahead of its time. Many patterns that are now industry standards—publish/subscribe messaging, plugin architectures, service discovery, distributed coordination—were pioneered or refined in this framework during the late 1990s and early 2000s.


Historical Timeline

Year Milestone
1996 DARPA begins funding agent-based logistics research
1997 Initial development as ALP (Advanced Logistics Project)
2000 DARPA funds UltraLog program ($70M) for survivability & security
2001 Cougaar Software, Inc. (CSI) formed to commercialize the technology
2004 First commercial product: ActiveEdge RFID Middleware
2005 ActiveEdge Intelligent Agent Platform v1.0 released
2012 Version 12.7 - Final open source release

Architecture Overview

Cougaar introduced several architectural concepts that influenced modern distributed systems:

Core Concepts

  • Agents: Autonomous entities that execute plugins and communicate via blackboard
  • Blackboard: Shared memory pub/sub pattern - predated modern message buses
  • Plugins: Component model that influenced later IoC containers like Spring
  • Services: System-level functionality accessed via ServiceBroker pattern
  • Society: XML configuration defining agent networks and relationships
  • Nodes: JVM containers that host one or more agents

Key Innovations

  • Blackboard Architecture - Intra-agent communication predating modern message buses
  • Plugin Component Model - Influenced Spring IoC and similar frameworks
  • Service Discovery - ServiceBroker pattern for decoupled service access
  • Message Transport System - Flexible inter-agent communication layer
  • Quality of Service Framework - Rare for early 2000s Java systems
  • Survivability - Self-healing agent networks for hostile environments
  • Dynamic Classloading - Simplified deployment before OSGi became popular

Repository Structure

This archive contains the complete source code of Cougaar v12.7:

cougaar/
├── core/           # Core framework - agents, blackboard, plugins, services
├── mts/            # Message Transport System - inter-agent communication
│   ├── mtslinks/   # Transport link implementations
│   └── mtsstd/     # Standard MTS implementation
├── planning/       # Task planning and resource allocation domain
├── qos/            # Quality of Service framework
│   ├── profile/    # Performance profiling
│   ├── qos/        # QoS core
│   └── qrs/        # QoS Resource Service
├── util/           # Utilities and bootstrap
│   ├── base/       # Base utilities
│   ├── bootstrap/  # Classloader and startup
│   └── util/       # General utilities
├── webserver/      # HTTP/Servlet interfaces
│   ├── webmicro/   # Lightweight embedded server
│   ├── webserver/  # Main web server
│   └── webtomcat/  # Tomcat integration
├── tutorials/      # Example applications
│   ├── hello/      # Hello World agent
│   ├── ping/       # Ping/pong messaging demo
│   ├── mesh/       # Mesh topology example
│   ├── mandelbrot/ # Distributed Mandelbrot computation
│   └── community/  # Community services demo
└── build/          # Build system and tools

Why This Matters

For Researchers

Cougaar represents one of the most sophisticated distributed agent frameworks ever built, with extensive documentation of patterns for:

  • Agent coordination and negotiation
  • Distributed planning and task decomposition
  • Fault tolerance and self-healing systems
  • Large-scale multi-agent simulation

For Practitioners

Many "modern" patterns in microservices and distributed systems were implemented and battle-tested in Cougaar:

  • The blackboard maps to pub/sub message buses (Kafka, Pulsar)
  • Plugin lifecycle maps to dependency injection (Spring, Guice)
  • ServiceBroker maps to service mesh patterns (Consul, Envoy)
  • Agent societies map to container orchestration (Kubernetes)

For Historians

This is computing history. Cougaar was used for actual DARPA logistics missions and influenced a generation of distributed systems thinking. Most of the original source code had become unavailable—this archive preserves it for future study.


Publications & References

Primary Papers

  • Helsinger, A., Thome, M., Wright, T. (2004). "Cougaar: A Scalable, Distributed Multi-Agent Architecture." IEEE International Conference on Systems, Man and Cybernetics.
    📄 IEEE Xplore | ResearchGate PDF

  • Helsinger, A., Wright, T. (2005). "Cougaar: A Robust Configurable Multi Agent Platform." IEEE Aerospace Conference.
    📄 ResearchGate PDF

  • Brinn, M., Berliner, J., Helsinger, A., et al. (2004). "Extending the Limits of DMAS Survivability: The UltraLog Project." IEEE Intelligent Systems, Vol. 19.
    📄 Semantic Scholar

Additional Research

  • Greaves, M., et al. (2003). "An Infrastructure for Adaptive Control of Multi-Agent Systems."
    📄 ResearchGate

  • Bohner, S.A., et al. (2004). "Formalism Challenges of the Cougaar Model Driven Architecture." Lecture Notes in Computer Science, Vol. 3228.
    📄 SpringerLink

  • Bradshaw, J.M., et al. (2004). "Using KAoS Policy and Domain Services within Cougaar."
    📄 PDF

Program Documentation

  • DARPA UltraLog Final Report - Pennsylvania State University / Intelligent Automation Inc.
    📄 Yumpu Archive

  • Cougaar Architecture Document - BBN Technologies (Version 11.4, 2004)

  • Cougaar Developers' Guide - BBN Technologies (Version 11.4, 2004)


License

Cougaar Open Source License (COSL)

A BSD-style license that permits redistribution with attribution to DARPA:

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the original author's copyright notice
  2. Redistributions in binary form must reproduce the copyright notice in documentation
  3. End-user documentation must include: "This product includes software developed in part by support from the Defense Advanced Research Project Agency (DARPA)."
  4. Neither DARPA nor contributors' names may be used to endorse derived products without permission

See License.txt for the complete license text.


Copyright

Copyright 1997-2012 Raytheon BBN Technologies
under partial sponsorship of the Defense Advanced Research Projects Agency (DARPA)

About This Archive

This archive was preserved from original development artifacts and made publicly available in 2025 as a historical preservation effort.

Other partial copies exist on GitHub, but this is the complete v12.7 release including all modules: core, MTS (Message Transport), QoS (Quality of Service), planning, utilities, web server, tutorials, and build system.

Status: 📦 Historical Archive - Community contributions welcome

This repository exists for historical reference and research purposes. The code is provided as-is from its final 2012 state. Contributions to documentation, buildability improvements, or modernization efforts are welcome.


See Also


"The best way to predict the future is to invent it." — Alan Kay

Cougaar invented distributed agent patterns that the industry is still rediscovering today.

About

DARPA's Cognitive Agent Architecture (1997-2012) - Complete v12.7 source code. A $70M distributed multi-agent framework that pioneered patterns now standard in modern systems.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors