catalog.json

{
  "reviewDate": "2026-10-18",
  "verification": {
    "date": "2026-10-18",
    "mode": "format-compile-and-local-entrypoints",
    "buildRun": true,
    "externalServicesStarted": false,
    "runtimeSummary": {
      "local": {
        "passed": 7,
        "failed": 0
      }
    },
    "remoteCiVerified": false
  },
  "modules": [
    {
      "path": "argi-adapter-example/agentscope",
      "artifact": "example-agentscope",
      "mainClass": "io.github.agentic.ai.examples.AgentScopeExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/AgentScopeExample.java",
      "description": "Wraps an AgentScope OpenAI-compatible model in the neutral ARGI ChatClient.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/AgentScopeExample.java",
        "src/main/java/io/github/agentic/ai/examples/AgentScopeScenarios.java"
      ],
      "demonstratedBehaviors": [
        "Wraps an AgentScope OpenAI-compatible model in the neutral ARGI ChatClient.",
        "Asynchronous completion, capability-gated streaming, one-event demand, final-response handling, terminal failures and cancellation on timeout."
      ],
      "limitations": [
        "Adapter-level capability flags, async completion and demand-controlled streams are demonstrated. Model-specific features and native SDK interoperability have not been exercised."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/AgentScopeScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.AgentScopeScenarios",
          "description": "Exercises neutral async calls and demand-controlled streaming through this adapter.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.AgentScopeExample",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.AgentScopeScenarios",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-adapter-example/google-adk",
      "artifact": "example-google-adk",
      "mainClass": "io.github.agentic.ai.examples.GoogleAdkExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/GoogleAdkExample.java",
      "description": "Uses the Google ADK Apigee OpenAI-compatible transport through an ARGI adapter.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/GoogleAdkExample.java",
        "src/main/java/io/github/agentic/ai/examples/GoogleAdkScenarios.java"
      ],
      "demonstratedBehaviors": [
        "Uses the Google ADK Apigee OpenAI-compatible transport through an ARGI adapter.",
        "Asynchronous completion, capability-gated streaming, one-event demand, final-response handling, terminal failures and cancellation on timeout."
      ],
      "limitations": [
        "Adapter-level capability flags, async completion and demand-controlled streams are demonstrated. Model-specific features and native SDK interoperability have not been exercised."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/GoogleAdkScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.GoogleAdkScenarios",
          "description": "Exercises neutral async calls and demand-controlled streaming through this adapter.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.GoogleAdkExample",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.GoogleAdkScenarios",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-adapter-example/langchain4j",
      "artifact": "example-langchain4j",
      "mainClass": "io.github.agentic.ai.examples.LangChain4jExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/LangChain4jExample.java",
      "description": "Wraps LangChain4j chat and streaming models in the neutral ARGI ChatClient.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/LangChain4jExample.java",
        "src/main/java/io/github/agentic/ai/examples/LangChain4jScenarios.java"
      ],
      "demonstratedBehaviors": [
        "Wraps LangChain4j chat and streaming models in the neutral ARGI ChatClient.",
        "Asynchronous completion, capability-gated streaming, one-event demand, final-response handling, terminal failures and cancellation on timeout."
      ],
      "limitations": [
        "Adapter-level capability flags, async completion and demand-controlled streams are demonstrated. Model-specific features and native SDK interoperability have not been exercised."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/LangChain4jScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.LangChain4jScenarios",
          "description": "Exercises neutral async calls and demand-controlled streaming through this adapter.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.LangChain4jExample",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.LangChain4jScenarios",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-adapter-example/spring-ai",
      "artifact": "example-spring-ai",
      "mainClass": "io.github.agentic.ai.examples.SpringAiExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/SpringAiExample.java",
      "description": "Wraps a Spring AI OpenAI-compatible model in the neutral ARGI ChatClient.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/SpringAiExample.java",
        "src/main/java/io/github/agentic/ai/examples/SpringAiScenarios.java"
      ],
      "demonstratedBehaviors": [
        "Wraps a Spring AI OpenAI-compatible model in the neutral ARGI ChatClient.",
        "Asynchronous completion, capability-gated streaming, one-event demand, final-response handling, terminal failures and cancellation on timeout."
      ],
      "limitations": [
        "Adapter-level capability flags, async completion and demand-controlled streams are demonstrated. Model-specific features and native SDK interoperability have not been exercised."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/SpringAiScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.SpringAiScenarios",
          "description": "Exercises neutral async calls and demand-controlled streaming through this adapter.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.SpringAiExample",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.SpringAiScenarios",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/a2a",
      "artifact": "example-a2a",
      "mainClass": "io.github.agentic.ai.examples.A2aExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/A2aExample.java",
      "description": "Discovers a remote A2A agent card and delegates a task over the A2A protocol.",
      "runtime": "service",
      "requirements": "An existing A2A service with a public agent card; set A2A_BASE_URL.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/A2aExample.java"
      ],
      "demonstratedBehaviors": [
        "Discovers a remote A2A agent card and delegates a task over the A2A protocol."
      ],
      "limitations": [
        "Remote client delegation; no A2A server, authentication flow, task resubscription or transport failure matrix."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-agent-example/agent-as-tool",
      "artifact": "example-agent-as-tool",
      "mainClass": "io.github.agentic.ai.examples.AgentAsToolExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/AgentAsToolExample.java",
      "description": "Registers a specialist as a neutral Tool, letting a coordinator delegate work.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/AgentAsToolExample.java",
        "src/main/java/io/github/agentic/ai/examples/ReviewRequest.java",
        "src/main/java/io/github/agentic/ai/examples/StructuredDelegation.java"
      ],
      "demonstratedBehaviors": [
        "Registers a specialist as a neutral Tool, letting a coordinator delegate work.",
        "Typed specialist input, generated tool schema and explicit child context/reasoning boundaries."
      ],
      "limitations": [
        "In-process delegation; no distributed authorization or remote agent lifecycle."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/StructuredDelegation.java",
          "mainClass": "io.github.agentic.ai.examples.StructuredDelegation",
          "description": "Exposes a typed specialist input while keeping parent reasoning out of the child context.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.AgentAsToolExample",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.StructuredDelegation",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/agent-hitl",
      "artifact": "example-agent-hitl",
      "mainClass": "io.github.agentic.ai.examples.AgentApproval",
      "entry": "src/main/java/io/github/agentic/ai/examples/AgentApproval.java",
      "description": "Pauses tool calls and accepts approved, rejected, or edited human feedback.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/AgentApproval.java"
      ],
      "demonstratedBehaviors": [
        "Pauses tool calls and accepts approved, rejected, or edited human feedback."
      ],
      "limitations": [
        "Read-only tracking tool approval; no real financial side effect or review UI."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.AgentApproval",
            "args": [
              "REJECTED"
            ],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.AgentApproval",
            "args": [
              "APPROVED"
            ],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.AgentApproval",
            "args": [
              "EDITED"
            ],
            "runtime": "model",
            "status": "failed",
            "detail": "Edited arguments executed ORDER-43 successfully; the gateway reset the subsequent model stream before completion."
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/agentic-rag",
      "artifact": "example-agentic-rag",
      "mainClass": "io.github.agentic.ai.examples.AgenticRag",
      "entry": "src/main/java/io/github/agentic/ai/examples/AgenticRag.java",
      "description": "Makes retrieval an agent tool and adds evidence through a MessagesModelHook.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/AgenticRag.java",
        "src/main/java/io/github/agentic/ai/examples/DocumentationCorpus.java",
        "src/main/java/io/github/agentic/ai/examples/DocumentationSearchTool.java",
        "src/main/java/io/github/agentic/ai/examples/EvidenceHook.java",
        "src/main/java/io/github/agentic/ai/examples/RetrievalScenarios.java"
      ],
      "demonstratedBehaviors": [
        "Makes retrieval an agent tool and adds evidence through a MessagesModelHook.",
        "Stable source labels, deterministic local retrieval and no-match behavior; retrieval tools and evidence injection have separate implementations."
      ],
      "limitations": [
        "Small keyword corpus; no production ranking benchmark, vector retrieval or citation correctness guarantee."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/RetrievalScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.RetrievalScenarios",
          "description": "Makes source selection and the no-evidence path inspectable without a model.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.RetrievalScenarios",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.AgenticRag",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/builtin-tools",
      "artifact": "example-builtin-tools",
      "mainClass": "io.github.agentic.ai.examples.BuiltinToolsExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/BuiltinToolsExample.java",
      "description": "Registers built-in filesystem, search, and todo tools with neutral bindings.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/BuiltinToolsExample.java"
      ],
      "demonstratedBehaviors": [
        "Registers built-in filesystem, search, and todo tools with neutral bindings."
      ],
      "limitations": [
        "Filesystem, glob, grep and todo tools; not every upstream built-in tool is registered."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.BuiltinToolsExample",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/context-compaction",
      "artifact": "example-context-compaction",
      "mainClass": "io.github.agentic.ai.examples.ContextCompaction",
      "entry": "src/main/java/io/github/agentic/ai/examples/ContextCompaction.java",
      "description": "Uses SummarizationHook to bound model context while retaining recent turns.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/CompactionScenarios.java",
        "src/main/java/io/github/agentic/ai/examples/ContextCompaction.java",
        "src/main/java/io/github/agentic/ai/examples/ProjectTranscript.java"
      ],
      "demonstratedBehaviors": [
        "Uses SummarizationHook to bound model context while retaining recent turns.",
        "Long synthetic project history crosses the summary threshold; the scenario checks the summary marker and preservation of the first user message."
      ],
      "limitations": [
        "Summary content depends on the real model; input size is estimated and no token-cost saving is claimed."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/CompactionScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.CompactionScenarios",
          "description": "Supplies a long transcript and checks the actual summary marker in saved state.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.ContextCompaction",
            "args": [],
            "runtime": "model",
            "status": "failed",
            "detail": "CC gateway reset the connection or exceeded the request timeout; the final answer was not validated."
          },
          {
            "mainClass": "io.github.agentic.ai.examples.CompactionScenarios",
            "args": [],
            "runtime": "model",
            "status": "passed",
            "detail": "Retained 7 messages, including a summary and the original first user message."
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/context-engineering",
      "artifact": "example-context-engineering",
      "mainClass": "io.github.agentic.ai.examples.ContextEngineering",
      "entry": "src/main/java/io/github/agentic/ai/examples/ContextEngineering.java",
      "description": "Preserves per-thread conversation history and enforces model call budgets.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/ContextEngineering.java",
        "src/main/java/io/github/agentic/ai/examples/ConversationSessions.java"
      ],
      "demonstratedBehaviors": [
        "Preserves per-thread conversation history and enforces model call budgets.",
        "Interleaved customer threads demonstrate isolation and per-thread budget exhaustion."
      ],
      "limitations": [
        "In-memory checkpoints and model-call limits; no cross-process session durability."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/ConversationSessions.java",
          "mainClass": "io.github.agentic.ai.examples.ConversationSessions",
          "description": "Reuses one agent while keeping each customer's checkpoint history separate.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.ContextEngineering",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.ConversationSessions",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/hooks-and-retries",
      "artifact": "example-hooks-and-retries",
      "mainClass": "io.github.agentic.ai.examples.HooksAndRetries",
      "entry": "src/main/java/io/github/agentic/ai/examples/HooksAndRetries.java",
      "description": "Combines PII redaction, model/tool budgets, and bounded retries for read-only tools.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/FailOnceTrackingTool.java",
        "src/main/java/io/github/agentic/ai/examples/HooksAndRetries.java",
        "src/main/java/io/github/agentic/ai/examples/RetryScenarios.java"
      ],
      "demonstratedBehaviors": [
        "Combines PII redaction, model/tool budgets, and bounded retries for read-only tools.",
        "An explicit fail-once read tool exercises retry rather than merely installing retry configuration."
      ],
      "limitations": [
        "Retry is limited to a read-only fixture. Non-idempotent tool recovery requires a separate design."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/RetryScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.RetryScenarios",
          "description": "Forces one transient tool failure so that the retry path is actually exercised.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.HooksAndRetries",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.RetryScenarios",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/interceptors",
      "artifact": "example-interceptors",
      "mainClass": "io.github.agentic.ai.examples.InterceptorsExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/InterceptorsExample.java",
      "description": "Custom model and tool interceptors measure duration and cache a read-only lookup.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/ContextEditingScenarios.java",
        "src/main/java/io/github/agentic/ai/examples/FallbackAgent.java",
        "src/main/java/io/github/agentic/ai/examples/InterceptorsExample.java",
        "src/main/java/io/github/agentic/ai/examples/MessageSanitizerScenarios.java",
        "src/main/java/io/github/agentic/ai/examples/ShippingQuoteTool.java",
        "src/main/java/io/github/agentic/ai/examples/ToolPolicyScenarios.java"
      ],
      "demonstratedBehaviors": [
        "Custom model and tool interceptors measure duration and cache a read-only lookup.",
        "Primary/fallback model configuration; outbound context editing; tool selection; explicitly synthetic tool emulation; assistant-message sanitization and tool-exception conversion."
      ],
      "limitations": [
        "Emulation is synthetic; fallback occurs only after a primary failure. RC2 ToolError returns diagnostic text without setting an error status."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/ContextEditingScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.ContextEditingScenarios",
          "description": "Shows outbound tool-result compaction independently of provider response variability.",
          "runtime": "local"
        },
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/FallbackAgent.java",
          "mainClass": "io.github.agentic.ai.examples.FallbackAgent",
          "description": "Configures a separate fallback model while preserving the neutral request pipeline.",
          "runtime": "model"
        },
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/MessageSanitizerScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.MessageSanitizerScenarios",
          "description": "Inspects empty assistant-content normalization and model-visible tool exception text.",
          "runtime": "local"
        },
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/ToolPolicyScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.ToolPolicyScenarios",
          "description": "Compares model-selected tools with explicitly requested tool emulation.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.ContextEditingScenarios",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.MessageSanitizerScenarios",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.InterceptorsExample",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.FallbackAgent",
            "args": [],
            "runtime": "model",
            "status": "passed",
            "detail": "Live run exercised the healthy primary. Failure-triggered fallback is covered by local fixtures only."
          },
          {
            "mainClass": "io.github.agentic.ai.examples.ToolPolicyScenarios",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.ToolPolicyScenarios",
            "args": [
              "emulate"
            ],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/multi-agent",
      "artifact": "example-multi-agent",
      "mainClass": "io.github.agentic.ai.examples.MultiAgent",
      "entry": "src/main/java/io/github/agentic/ai/examples/MultiAgent.java",
      "description": "Parallel reviewers feed sequential writing and a bounded revision loop.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/MultiAgent.java",
        "src/main/java/io/github/agentic/ai/examples/ParallelReview.java",
        "src/main/java/io/github/agentic/ai/examples/ReviewMergeStrategy.java",
        "src/main/java/io/github/agentic/ai/examples/RevisionUntilReady.java"
      ],
      "demonstratedBehaviors": [
        "Parallel reviewers feed sequential writing and a bounded revision loop.",
        "Custom deterministic merge strategy, bounded parallel reviewers and a condition-based revision loop capped at three iterations."
      ],
      "limitations": [
        "Local composition; convergence and review quality depend on model responses. The revision loop has an explicit ceiling."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/ParallelReview.java",
          "mainClass": "io.github.agentic.ai.examples.ParallelReview",
          "description": "Combines independent reviewers with a concurrency bound and an application merge policy.",
          "runtime": "model"
        },
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/RevisionUntilReady.java",
          "mainClass": "io.github.agentic.ai.examples.RevisionUntilReady",
          "description": "Stops on an explicit review marker, with a three-iteration ceiling.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.MultiAgent",
            "args": [],
            "runtime": "model",
            "status": "failed",
            "detail": "CC gateway reset the connection or exceeded the request timeout; the final answer was not validated."
          },
          {
            "mainClass": "io.github.agentic.ai.examples.ParallelReview",
            "args": [],
            "runtime": "model",
            "status": "failed",
            "detail": "CC gateway reset the connection or exceeded the request timeout; the final answer was not validated."
          },
          {
            "mainClass": "io.github.agentic.ai.examples.RevisionUntilReady",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/planner",
      "artifact": "example-planner",
      "mainClass": "io.github.agentic.ai.examples.PlannerExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/PlannerExample.java",
      "description": "Produces validated direct or decomposed plans from an explicit capability catalog.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/PlanValidationScenarios.java",
        "src/main/java/io/github/agentic/ai/examples/PlannerExample.java",
        "src/main/java/io/github/agentic/ai/examples/PlanningCatalog.java"
      ],
      "demonstratedBehaviors": [
        "Produces validated direct or decomposed plans from an explicit capability catalog.",
        "Application-owned capability catalog; valid dependency chains; rejection of unregistered targets, missing dependencies, duplicate IDs and cycles."
      ],
      "limitations": [
        "Plans are validated data. No trusted executor, scheduling or plan-result persistence is implemented here."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/PlanValidationScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.PlanValidationScenarios",
          "description": "Validates plans locally; no capability is executed by validation.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.PlanValidationScenarios",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.PlannerExample",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/react-tools",
      "artifact": "example-react-tools",
      "mainClass": "io.github.agentic.ai.examples.ReactTools",
      "entry": "src/main/java/io/github/agentic/ai/examples/ReactTools.java",
      "description": "Runs a ReAct tool loop against a local order-tracking catalog.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/DirectTrackingTool.java",
        "src/main/java/io/github/agentic/ai/examples/OrderRecord.java",
        "src/main/java/io/github/agentic/ai/examples/OrderRepository.java",
        "src/main/java/io/github/agentic/ai/examples/ReactTools.java",
        "src/main/java/io/github/agentic/ai/examples/ToolScenarios.java",
        "src/main/java/io/github/agentic/ai/examples/TrackingTool.java"
      ],
      "demonstratedBehaviors": [
        "Runs a ReAct tool loop against a local order-tracking catalog.",
        "Tool schema and argument validation; malformed JSON and missing records; unknown registry bindings; result/call identity; direct tool return."
      ],
      "limitations": [
        "A local order repository; no commerce API or irreversible order mutation."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/DirectTrackingTool.java",
          "mainClass": "io.github.agentic.ai.examples.DirectTrackingTool",
          "description": "Returns the application result directly instead of asking the model to rewrite it.",
          "runtime": "model"
        },
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/ToolScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.ToolScenarios",
          "description": "Exercises successful calls, invalid arguments, missing data and unknown tool names.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.ToolScenarios",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.DirectTrackingTool",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.ReactTools",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/routing-streaming",
      "artifact": "example-routing-streaming",
      "mainClass": "io.github.agentic.ai.examples.RoutingStreaming",
      "entry": "src/main/java/io/github/agentic/ai/examples/RoutingStreaming.java",
      "description": "Uses LLM routing to choose a specialist and demonstrates neutral streamed messages.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/RoutingStreaming.java"
      ],
      "demonstratedBehaviors": [
        "Uses LLM routing to choose a specialist and demonstrates neutral streamed messages."
      ],
      "limitations": [
        "Model-selected specialists with a fallback; no routing accuracy evaluation or provider-event matrix."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.RoutingStreaming",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/skills",
      "artifact": "example-skills",
      "mainClass": "io.github.agentic.ai.examples.SkillsExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/SkillsExample.java",
      "description": "Loads packaged skills, decorates neutral prompts, and exposes progressive skill disclosure.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/SkillsExample.java"
      ],
      "demonstratedBehaviors": [
        "Loads packaged skills, decorates neutral prompts, and exposes progressive skill disclosure."
      ],
      "limitations": [
        "One packaged skill and progressive disclosure; no untrusted remote skill installation."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.SkillsExample",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/structured-output",
      "artifact": "example-structured-output",
      "mainClass": "io.github.agentic.ai.examples.StructuredOutput",
      "entry": "src/main/java/io/github/agentic/ai/examples/StructuredOutput.java",
      "description": "Selects schema enforcement according to adapter capabilities and validates the parsed domain record.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/StructuredOutput.java",
        "src/main/java/io/github/agentic/ai/examples/TicketSchema.java",
        "src/main/java/io/github/agentic/ai/examples/TicketValidationScenarios.java",
        "src/main/java/io/github/agentic/ai/examples/TypedTicketAgent.java"
      ],
      "demonstratedBehaviors": [
        "Selects schema enforcement according to adapter capabilities and validates the parsed domain record.",
        "Explicit response format and ReactAgent outputType; domain validation rejects missing/extra fields, wrong types and out-of-range priorities."
      ],
      "limitations": [
        "A ticket schema; provider schema adherence remains model-dependent, so application validation is mandatory."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/TicketValidationScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.TicketValidationScenarios",
          "description": "Shows that valid JSON alone does not make a valid domain result.",
          "runtime": "local"
        },
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/TypedTicketAgent.java",
          "mainClass": "io.github.agentic.ai.examples.TypedTicketAgent",
          "description": "Demonstrates ReactAgent's outputType in addition to the lower-level response format.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.TicketValidationScenarios",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.TypedTicketAgent",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.StructuredOutput",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/studio-chatbot",
      "artifact": "example-studio-chatbot",
      "mainClass": "io.github.agentic.ai.examples.StudioChatbot",
      "entry": "src/main/java/io/github/agentic/ai/examples/StudioChatbot.java",
      "description": "Publishes a stateful agent bean through the embedded ARGI Studio.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/StudioChatbot.java"
      ],
      "demonstratedBehaviors": [
        "Publishes a stateful agent bean through the embedded ARGI Studio."
      ],
      "limitations": [
        "An embedded Studio agent bean; no UI E2E validation, authentication deployment or multi-tenant setup."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.StudioChatbot",
            "args": [],
            "runtime": "http-model",
            "status": "passed",
            "detail": "Local HTTP 200 agent discovery and real-model SSE answer; application stopped after validation."
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/support-workflow",
      "artifact": "example-support-workflow",
      "mainClass": "io.github.agentic.ai.examples.SupportWorkflow",
      "entry": "src/main/java/io/github/agentic/ai/examples/SupportWorkflow.java",
      "description": "Embeds a ReAct writer in a deterministic support workflow with human review.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/SupportReview.java",
        "src/main/java/io/github/agentic/ai/examples/SupportTicket.java",
        "src/main/java/io/github/agentic/ai/examples/SupportWorkflow.java"
      ],
      "demonstratedBehaviors": [
        "Embeds a ReAct writer in a deterministic support workflow with human review.",
        "Validated ticket input, draft inspection, separate approved/rejected threads and reviewer metadata persisted before resume."
      ],
      "limitations": [
        "Draft and review state only; no email is sent and no external refund is issued."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/SupportReview.java",
          "mainClass": "io.github.agentic.ai.examples.SupportReview",
          "description": "Keeps a review decision attached to the saved draft and its checkpoint cursor.",
          "runtime": "model"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.SupportWorkflow",
            "args": [],
            "runtime": "model",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.SupportReview",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-extensions-example/a2a-nacos",
      "artifact": "example-a2a-nacos",
      "mainClass": "io.github.agentic.ai.examples.NacosA2aExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/NacosA2aExample.java",
      "description": "Resolves an A2A agent by registered name in Nacos before delegation.",
      "runtime": "service",
      "requirements": "Nacos A2A discovery and a registered remote agent; set A2A_AGENT_NAME and NACOS_SERVER_ADDR.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/NacosA2aExample.java"
      ],
      "demonstratedBehaviors": [
        "Resolves an A2A agent by registered name in Nacos before delegation."
      ],
      "limitations": [
        "Nacos-backed agent discovery and delegation; no service failover or registration lifecycle validation."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/docker-execution",
      "artifact": "example-docker-execution",
      "mainClass": "io.github.agentic.ai.examples.DockerExecution",
      "entry": "src/main/java/io/github/agentic/ai/examples/DockerExecution.java",
      "description": "Executes a fixed Python calculation through the Extensions Docker code executor.",
      "runtime": "service",
      "requirements": "A running Docker daemon and a pre-pulled Python image; set DOCKER_HOST for the daemon socket and optionally ARGI_DOCKER_IMAGE.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/DockerExecution.java"
      ],
      "demonstratedBehaviors": [
        "Executes a fixed Python calculation through the Extensions Docker code executor."
      ],
      "limitations": [
        "One explicit Python execution; no container startup during authoring, resource-pressure test or image lifecycle automation."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/document-parsing",
      "artifact": "example-document-parsing",
      "mainClass": "io.github.agentic.ai.examples.DocumentParsing",
      "entry": "src/main/java/io/github/agentic/ai/examples/DocumentParsing.java",
      "description": "Parses UTF-8 text and JSON records while preserving source metadata.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/DocumentIngestion.java",
        "src/main/java/io/github/agentic/ai/examples/DocumentParsing.java"
      ],
      "demonstratedBehaviors": [
        "Parses UTF-8 text and JSON records while preserving source metadata.",
        "Caller-selected JSON/text files, packaged input fixtures, source metadata projection and blank-document filtering."
      ],
      "limitations": [
        "JSON and UTF-8 text; PDF, Office, image OCR and upstream parser plugins are not included."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/DocumentIngestion.java",
          "mainClass": "io.github.agentic.ai.examples.DocumentIngestion",
          "description": "Reads caller-selected JSON or text and projects parsed documents into neutral records.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.DocumentParsing",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.DocumentIngestion",
            "args": [
              "src/main/resources/articles.json"
            ],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-extensions-example/http-node",
      "artifact": "example-http-node",
      "mainClass": "io.github.agentic.ai.examples.HttpNodeExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/HttpNodeExample.java",
      "description": "Retrieves an HTTP order resource as a graph step with explicit timeout and network policy.",
      "runtime": "service",
      "requirements": "An existing tracking HTTP endpoint; set TRACKING_BASE_URL and ALLOW_PRIVATE_NETWORK=true only for a trusted local endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/HttpNodeExample.java"
      ],
      "demonstratedBehaviors": [
        "Retrieves an HTTP order resource as a graph step with explicit timeout and network policy."
      ],
      "limitations": [
        "One HTTP GET with timeout and network policy; POST, authentication refresh and status-dependent routing are not covered."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/jdbc-chat-memory",
      "artifact": "example-jdbc-chat-memory",
      "mainClass": "io.github.agentic.ai.examples.JdbcChatMemory",
      "entry": "src/main/java/io/github/agentic/ai/examples/JdbcChatMemory.java",
      "description": "Persists a bounded Spring AI conversation with the Extensions H2 repository.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/JdbcChatMemory.java",
        "src/main/java/io/github/agentic/ai/examples/JdbcMemoryLifecycle.java"
      ],
      "demonstratedBehaviors": [
        "Persists a bounded Spring AI conversation with the Extensions H2 repository.",
        "H2-backed window eviction, reopening a facade, conversation isolation and deletion without affecting another conversation."
      ],
      "limitations": [
        "Local H2 message storage; no remote JDBC outage or load experiment."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/JdbcMemoryLifecycle.java",
          "mainClass": "io.github.agentic.ai.examples.JdbcMemoryLifecycle",
          "description": "Demonstrates window eviction, reopening, isolation and deletion using local H2.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.JdbcChatMemory",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.JdbcMemoryLifecycle",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-extensions-example/jdbc-checkpoint",
      "artifact": "example-jdbc-checkpoint",
      "mainClass": "io.github.agentic.ai.examples.JdbcCheckpoint",
      "entry": "src/main/java/io/github/agentic/ai/examples/JdbcCheckpoint.java",
      "description": "Restores a pending approval through an H2 JDBC checkpoint saver and a new graph.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/JdbcCheckpoint.java"
      ],
      "demonstratedBehaviors": [
        "Restores a pending approval through an H2 JDBC checkpoint saver and a new graph."
      ],
      "limitations": [
        "Local H2 recovery; no production JDBC migration, contention or failover experiment."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.JdbcCheckpoint",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-extensions-example/mcp-client",
      "artifact": "example-mcp-client",
      "mainClass": "io.github.agentic.ai.examples.McpClientExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/McpClientExample.java",
      "description": "Initializes a Streamable HTTP MCP client and enumerates all tool pages.",
      "runtime": "service",
      "requirements": "An existing Streamable HTTP MCP server; set MCP_BASE_URL and optionally MCP_ENDPOINT.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/CatalogToolCall.java",
        "src/main/java/io/github/agentic/ai/examples/McpClientExample.java"
      ],
      "demonstratedBehaviors": [
        "Initializes a Streamable HTTP MCP client and enumerates all tool pages.",
        "Read-only invocation of the companion lookup tool, advertised-tool checks and protocol error handling."
      ],
      "limitations": [
        "Streamable HTTP discovery and the companion read-only tool; no OAuth, resource subscriptions or prompt APIs."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/CatalogToolCall.java",
          "mainClass": "io.github.agentic.ai.examples.CatalogToolCall",
          "description": "Calls only the read-only lookup tool supplied by the companion registry example.",
          "runtime": "service"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/mcp-discovery",
      "artifact": "example-mcp-discovery",
      "mainClass": "io.github.agentic.ai.examples.McpDiscoveryAgent",
      "entry": "src/main/java/io/github/agentic/ai/examples/McpDiscoveryAgent.java",
      "description": "Discovers registered MCP tools through Nacos and adapts callbacks for ReAct.",
      "runtime": "service",
      "requirements": "Nacos plus the mcp-registry example already running, and model credentials.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/McpDiscoveryAgent.java"
      ],
      "demonstratedBehaviors": [
        "Discovers registered MCP tools through Nacos and adapts callbacks for ReAct."
      ],
      "limitations": [
        "Tool discovery and callback adaptation; no registry failover, service churn or credential refresh test."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/mcp-gateway",
      "artifact": "example-mcp-gateway",
      "mainClass": "io.github.agentic.ai.examples.McpGatewayExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/McpGatewayExample.java",
      "description": "Aggregates Nacos MCP services into independently routed SSE and Streamable endpoints.",
      "runtime": "service",
      "requirements": "Nacos plus the registered argi-catalog service. This application serves gateway endpoints on port 8093.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/McpGatewayExample.java"
      ],
      "demonstratedBehaviors": [
        "Aggregates Nacos MCP services into independently routed SSE and Streamable endpoints."
      ],
      "limitations": [
        "Starter-driven endpoint composition; no gateway authorization or routing E2E test."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/mcp-registry",
      "artifact": "example-mcp-registry",
      "mainClass": "io.github.agentic.ai.examples.McpRegistryServer",
      "entry": "src/main/java/io/github/agentic/ai/examples/McpRegistryServer.java",
      "description": "Publishes a read-only MCP tool and registers the server in Nacos.",
      "runtime": "service",
      "requirements": "Nacos 3 with MCP registry support; this application serves and registers argi-catalog on port 8092.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/McpRegistryServer.java"
      ],
      "demonstratedBehaviors": [
        "Publishes a read-only MCP tool and registers the server in Nacos."
      ],
      "limitations": [
        "One annotated catalog tool registered in Nacos; no authenticated public server deployment."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/mcp-router",
      "artifact": "example-mcp-router",
      "mainClass": "io.github.agentic.ai.examples.McpRouterAgent",
      "entry": "src/main/java/io/github/agentic/ai/examples/McpRouterAgent.java",
      "description": "Exposes semantic MCP routing tools to a neutral ARGI agent.",
      "runtime": "service",
      "requirements": "Nacos plus the mcp-registry example, a model endpoint, and an embedding endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/McpRouterAgent.java"
      ],
      "demonstratedBehaviors": [
        "Exposes semantic MCP routing tools to a neutral ARGI agent."
      ],
      "limitations": [
        "Semantic MCP routing; no routing-quality evaluation or service-outage matrix."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/mem0-memory",
      "artifact": "example-mem0-memory",
      "mainClass": "io.github.agentic.ai.examples.Mem0MemoryExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/Mem0MemoryExample.java",
      "description": "Writes semantic memories to Mem0 and retrieves them with an explicit user scope.",
      "runtime": "service",
      "requirements": "An existing compatible Mem0 server and model credentials. The startup configures the Mem0 server.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/Mem0MemoryExample.java"
      ],
      "demonstratedBehaviors": [
        "Writes semantic memories to Mem0 and retrieves them with an explicit user scope."
      ],
      "limitations": [
        "Semantic write/search for one example user; no deletion, reconciliation or extraction-quality evaluation."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/memory-backends",
      "artifact": "example-memory-backends",
      "mainClass": "io.github.agentic.ai.examples.MemoryBackends",
      "entry": "src/main/java/io/github/agentic/ai/examples/MemoryBackends.java",
      "description": "Profile-selected Redis, MongoDB, Elasticsearch, TableStore, Memcached, and JDBC chat repositories.",
      "runtime": "service",
      "requirements": "The selected repository service and one Maven/Spring profile pair. See the backend configuration table below.",
      "profiles": [
        "memory-redis",
        "memory-mongodb",
        "memory-elasticsearch",
        "memory-tablestore",
        "memory-memcached",
        "memory-mysql",
        "memory-postgresql"
      ],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/ConversationLifecycle.java",
        "src/main/java/io/github/agentic/ai/examples/MemoryBackends.java"
      ],
      "demonstratedBehaviors": [
        "Profile-selected Redis, MongoDB, Elasticsearch, TableStore, Memcached, and JDBC chat repositories.",
        "Message-window eviction, a recreated facade, conversation isolation and targeted cleanup against the selected repository."
      ],
      "limitations": [
        "Backend profiles share one contract scenario. No backend connectivity, consistency, TTL or failure behavior has been verified."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/mongodb-checkpoint",
      "artifact": "example-mongodb-checkpoint",
      "mainClass": "io.github.agentic.ai.examples.MongoCheckpoint",
      "entry": "src/main/java/io/github/agentic/ai/examples/MongoCheckpoint.java",
      "description": "Persists neutral graph state in the Extensions MongoDB checkpoint saver.",
      "runtime": "service",
      "requirements": "An existing MongoDB service; set MONGODB_URI.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/MongoCheckpoint.java",
        "src/main/java/io/github/agentic/ai/examples/MongoRecovery.java"
      ],
      "demonstratedBehaviors": [
        "Persists neutral graph state in the Extensions MongoDB checkpoint saver.",
        "Fresh saver and graph read pending checkpoints, apply one approval, inspect history and leave another thread pending."
      ],
      "limitations": [
        "Restoration uses fresh saver objects on one client; database restart, replica failover and concurrent writers remain unverified."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/nacos-prompt",
      "artifact": "example-nacos-prompt",
      "mainClass": "io.github.agentic.ai.examples.NacosPrompt",
      "entry": "src/main/java/io/github/agentic/ai/examples/NacosPrompt.java",
      "description": "Loads and watches a configurable prompt through Nacos and the Extensions prompt factory.",
      "runtime": "service",
      "requirements": "An existing Nacos Config service; set NACOS_SERVER_ADDR and optional NACOS_USERNAME/NACOS_PASSWORD.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/NacosPrompt.java"
      ],
      "demonstratedBehaviors": [
        "Loads and watches a configurable prompt through Nacos and the Extensions prompt factory."
      ],
      "limitations": [
        "Prompt loading and refresh listener; no configuration-center outage or rollback experiment."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/rag-retrieval",
      "artifact": "example-rag-retrieval",
      "mainClass": "io.github.agentic.ai.examples.RagRetrieval",
      "entry": "src/main/java/io/github/agentic/ai/examples/RagRetrieval.java",
      "description": "Expands a query with HyDE and retrieves evidence through the RAG graph node.",
      "runtime": "service",
      "requirements": "A real chat and embedding endpoint; set ARGI_API_KEY, ARGI_MODEL, and optionally ARGI_EMBEDDING_MODEL.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/RagRetrieval.java"
      ],
      "demonstratedBehaviors": [
        "Expands a query with HyDE and retrieves evidence through the RAG graph node."
      ],
      "limitations": [
        "HyDE and graph retrieval; no reranker, hybrid retrieval, answer evaluation or ingestion lifecycle."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/redis-checkpoint",
      "artifact": "example-redis-checkpoint",
      "mainClass": "io.github.agentic.ai.examples.RedisCheckpoint",
      "entry": "src/main/java/io/github/agentic/ai/examples/RedisCheckpoint.java",
      "description": "Stores and reloads neutral graph checkpoints with the Extensions Redis saver.",
      "runtime": "service",
      "requirements": "An existing Redis service; set REDIS_URL and optional REDIS_PASSWORD.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/RedisCheckpoint.java",
        "src/main/java/io/github/agentic/ai/examples/RedisRecovery.java"
      ],
      "demonstratedBehaviors": [
        "Stores and reloads neutral graph checkpoints with the Extensions Redis saver.",
        "Fresh saver and graph read pending checkpoints, apply one approval, inspect history and leave another thread pending."
      ],
      "limitations": [
        "Restoration uses fresh saver objects on one client; Redis restart, TTL expiry and cluster failover remain unverified."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/sandbox-tools",
      "artifact": "example-sandbox-tools",
      "mainClass": "io.github.agentic.ai.examples.SandboxToolsExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/SandboxToolsExample.java",
      "description": "Adapts an Extensions sandbox Python tool into a neutral ReAct agent.",
      "runtime": "service",
      "requirements": "An existing AgentScope Runtime sandbox manager; set SANDBOX_MANAGER_URL, optional SANDBOX_MANAGER_TOKEN, and model credentials.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/SandboxToolsExample.java"
      ],
      "demonstratedBehaviors": [
        "Adapts an Extensions sandbox Python tool into a neutral ReAct agent."
      ],
      "limitations": [
        "Python sandbox tool integration; no sandbox provisioning or full browser/desktop tool catalog."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/tair-vector-store",
      "artifact": "example-tair-vector-store",
      "mainClass": "io.github.agentic.ai.examples.TairVectorStoreExample",
      "entry": "src/main/java/io/github/agentic/ai/examples/TairVectorStoreExample.java",
      "description": "Writes real embeddings to a Tair Vector index and searches for relevant documents.",
      "runtime": "service",
      "requirements": "A Tair Vector-capable service (ordinary Redis is insufficient), real embeddings, TAIR_URI, and matching ARGI_EMBEDDING_DIMENSIONS.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/TairVectorStoreExample.java"
      ],
      "demonstratedBehaviors": [
        "Writes real embeddings to a Tair Vector index and searches for relevant documents."
      ],
      "limitations": [
        "Tair indexing and search; no index administration, replication or failure-mode matrix."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-extensions-example/vector-backends",
      "artifact": "example-vector-backends",
      "mainClass": "io.github.agentic.ai.examples.VectorBackends",
      "entry": "src/main/java/io/github/agentic/ai/examples/VectorBackends.java",
      "description": "Profile-selected AnalyticDB, OceanBase, OpenSearch, TableStore, and Tair indexing and search.",
      "runtime": "service",
      "requirements": "The selected vector service, a real embedding endpoint, and one Maven/Spring profile pair.",
      "profiles": [
        "vector-analyticdb",
        "vector-oceanbase",
        "vector-opensearch",
        "vector-tablestore",
        "vector-tair"
      ],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/KnowledgeCorpus.java",
        "src/main/java/io/github/agentic/ai/examples/KnowledgeSearch.java",
        "src/main/java/io/github/agentic/ai/examples/VectorBackends.java"
      ],
      "demonstratedBehaviors": [
        "Profile-selected AnalyticDB, OceanBase, OpenSearch, TableStore, and Tair indexing and search.",
        "Three labelled documents, neutral search result projection, optional metadata filtering and opt-in deletion of example IDs."
      ],
      "limitations": [
        "Backend support for filters, deletion, upsert and index refresh differs. Optional operations require a compatible backend."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [],
        "runtimeNote": "Requires external services; no service was started and no live integration result is claimed."
      }
    },
    {
      "path": "argi-graph-example/cancellation",
      "artifact": "example-cancellation",
      "mainClass": "io.github.agentic.ai.examples.Cancellation",
      "entry": "src/main/java/io/github/agentic/ai/examples/Cancellation.java",
      "description": "Cancels exactly one graph subscription and releases its asynchronous worker.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/Cancellation.java"
      ],
      "demonstratedBehaviors": [
        "Cancels exactly one graph subscription and releases its asynchronous worker."
      ],
      "limitations": [
        "Subscription cancellation and worker cleanup; provider-side billing cancellation is not demonstrated."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.Cancellation",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/conditional-routing",
      "artifact": "example-conditional-routing",
      "mainClass": "io.github.agentic.ai.examples.ConditionalRouting",
      "entry": "src/main/java/io/github/agentic/ai/examples/ConditionalRouting.java",
      "description": "Routes support tickets into urgent and normal queues using conditional edges.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/ConditionalRouting.java",
        "src/main/java/io/github/agentic/ai/examples/RoutingScenarios.java"
      ],
      "demonstratedBehaviors": [
        "Routes support tickets into urgent and normal queues using conditional edges.",
        "Both route outcomes and the severity threshold are exercised by a dedicated scenario."
      ],
      "limitations": [
        "Deterministic severity routing; model-based routing lives in routing-streaming."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/RoutingScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.RoutingScenarios",
          "description": "Compares both sides of the severity boundary using the same compiled graph.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.ConditionalRouting",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.RoutingScenarios",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/hello-graph",
      "artifact": "example-hello-graph",
      "mainClass": "io.github.agentic.ai.examples.HelloGraph",
      "entry": "src/main/java/io/github/agentic/ai/examples/HelloGraph.java",
      "description": "A two-step model-free workflow that normalizes a name and creates a greeting.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/HelloGraph.java"
      ],
      "demonstratedBehaviors": [
        "A two-step model-free workflow that normalizes a name and creates a greeting."
      ],
      "limitations": [
        "Introductory two-node graph only; it deliberately has no application service or model."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.HelloGraph",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/hitl",
      "artifact": "example-hitl",
      "mainClass": "io.github.agentic.ai.examples.DynamicApproval",
      "entry": "src/main/java/io/github/agentic/ai/examples/DynamicApproval.java",
      "description": "InterruptableAction requests missing feedback and resumes the same node.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/DynamicApproval.java"
      ],
      "demonstratedBehaviors": [
        "InterruptableAction requests missing feedback and resumes the same node."
      ],
      "limitations": [
        "One dynamic review decision; no browser review queue or approval identity provider."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.DynamicApproval",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/human-in-the-loop",
      "artifact": "example-human-in-the-loop",
      "mainClass": "io.github.agentic.ai.examples.HumanInTheLoop",
      "entry": "src/main/java/io/github/agentic/ai/examples/HumanInTheLoop.java",
      "description": "Pauses before a refund decision and resumes from the same checkpoint.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/ApprovalScenarios.java",
        "src/main/java/io/github/agentic/ai/examples/HumanInTheLoop.java"
      ],
      "demonstratedBehaviors": [
        "Pauses before a refund decision and resumes from the same checkpoint.",
        "Two independently paused requests receive different approval decisions before resuming."
      ],
      "limitations": [
        "Approval changes example state; it does not issue a real refund."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/ApprovalScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.ApprovalScenarios",
          "description": "Resolves two independent pending requests with different human decisions.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.HumanInTheLoop",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.ApprovalScenarios",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/observation",
      "artifact": "example-observation",
      "mainClass": "io.github.agentic.ai.examples.LocalObservation",
      "entry": "src/main/java/io/github/agentic/ai/examples/LocalObservation.java",
      "description": "Records graph observations with a local Micrometer handler and no telemetry backend.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/LocalObservation.java"
      ],
      "demonstratedBehaviors": [
        "Records graph observations with a local Micrometer handler and no telemetry backend."
      ],
      "limitations": [
        "Successful local observation lifecycle; no exporter deployment or error-path observability matrix."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.LocalObservation",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/parallel-nodes",
      "artifact": "example-parallel-nodes",
      "mainClass": "io.github.agentic.ai.examples.ParallelNodes",
      "entry": "src/main/java/io/github/agentic/ai/examples/ParallelNodes.java",
      "description": "Fork/join branches, an append reducer, explicit executors, and streamed node output.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/OrderChecks.java",
        "src/main/java/io/github/agentic/ai/examples/OrderFulfillment.java",
        "src/main/java/io/github/agentic/ai/examples/ParallelNodes.java"
      ],
      "demonstratedBehaviors": [
        "Fork/join branches, an append reducer, explicit executors, and streamed node output.",
        "Separate stock/credit/shipping checks join before an eligibility branch; test source enumerates all eight input combinations."
      ],
      "limitations": [
        "Local business checks and executor ownership; no inventory or payment service is contacted."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/OrderFulfillment.java",
          "mainClass": "io.github.agentic.ai.examples.OrderFulfillment",
          "description": "Joins all checks before choosing whether an order is eligible for fulfillment.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.ParallelNodes",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.OrderFulfillment",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/parallel-subgraph",
      "artifact": "example-parallel-subgraph",
      "mainClass": "io.github.agentic.ai.examples.ParallelSubgraph",
      "entry": "src/main/java/io/github/agentic/ai/examples/ParallelSubgraph.java",
      "description": "Joins order checks and creates a receipt in a nested graph.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/ParallelSubgraph.java"
      ],
      "demonstratedBehaviors": [
        "Joins order checks and creates a receipt in a nested graph."
      ],
      "limitations": [
        "Local order-check fixture and nested receipt graph; no external fulfillment."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.ParallelSubgraph",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/persistence",
      "artifact": "example-persistence",
      "mainClass": "io.github.agentic.ai.examples.Persistence",
      "entry": "src/main/java/io/github/agentic/ai/examples/Persistence.java",
      "description": "File checkpoints, thread identity, history inspection, and recovery with a fresh graph.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/CheckpointInspector.java",
        "src/main/java/io/github/agentic/ai/examples/Persistence.java",
        "src/main/java/io/github/agentic/ai/examples/RecoveryScenarios.java"
      ],
      "demonstratedBehaviors": [
        "File checkpoints, thread identity, history inspection, and recovery with a fresh graph.",
        "Checkpoint history projection, fresh-graph recovery, editing pending state and keeping another thread paused."
      ],
      "limitations": [
        "Fresh graph and saver objects demonstrate restoration; OS process crashes and concurrent writers are not validated."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/RecoveryScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.RecoveryScenarios",
          "description": "Reopens the saver, edits a suspended state and proves that another thread stays paused.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.Persistence",
            "args": [
              "prepare"
            ],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.Persistence",
            "args": [
              "resume"
            ],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.RecoveryScenarios",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/plantuml",
      "artifact": "example-plantuml",
      "mainClass": "io.github.agentic.ai.examples.GraphDiagrams",
      "entry": "src/main/java/io/github/agentic/ai/examples/GraphDiagrams.java",
      "description": "Exports PlantUML and Mermaid representations without invoking the graph.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/GraphDiagrams.java"
      ],
      "demonstratedBehaviors": [
        "Exports PlantUML and Mermaid representations without invoking the graph."
      ],
      "limitations": [
        "Diagram source export only; external image renderers are not invoked."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.GraphDiagrams",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/recoverable-runs",
      "artifact": "example-recoverable-runs",
      "mainClass": "io.github.agentic.ai.examples.RecoverableRuns",
      "entry": "src/main/java/io/github/agentic/ai/examples/RecoverableRuns.java",
      "description": "Run/task admission, deduplication, leases, revision conflicts and atomic checkpoint/journal/outbox writes.",
      "runtime": "local",
      "requirements": "Build Core commit f61a477220b9caec4d63b9469dbab5877eff1df9. No API key, container or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/RecoverableRuns.java",
        "src/main/java/io/github/agentic/ai/examples/RunConflictScenarios.java",
        "src/main/java/io/github/agentic/ai/examples/RunExampleContext.java",
        "src/main/java/io/github/agentic/ai/examples/StoredRunWorkflow.java"
      ],
      "demonstratedBehaviors": [
        "Application-owned trusted context and data-only RunSpec round trip; same-submission deduplication; task state transitions; lease handoff and renewal; stale-owner and stale-revision rejection; atomic checkpoint, journal and outbox commits; logical session release."
      ],
      "limitations": [
        "MemoryRunStore is not restart-durable. No autonomous task executor, identity service, distributed backend or outbox dispatcher is implemented."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/RunConflictScenarios.java",
          "mainClass": "io.github.agentic.ai.examples.RunConflictScenarios",
          "runtime": "local",
          "description": "Rejects changed submissions, competing owners, stale revisions and invalid atomic writes."
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.RecoverableRuns",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.RunConflictScenarios",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/runtime-store",
      "artifact": "example-runtime-store",
      "mainClass": "io.github.agentic.ai.examples.RuntimeStore",
      "entry": "src/main/java/io/github/agentic/ai/examples/RuntimeStore.java",
      "description": "Separates transient invocation metadata, thread state, and long-lived namespaced memory.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/PreferenceRepository.java",
        "src/main/java/io/github/agentic/ai/examples/RuntimeStore.java",
        "src/main/java/io/github/agentic/ai/examples/StoreLifecycle.java"
      ],
      "demonstratedBehaviors": [
        "Separates transient invocation metadata, thread state, and long-lived namespaced memory.",
        "Namespace isolation, upsert, filtered/sorted pagination, targeted deletion and missing-item behavior."
      ],
      "limitations": [
        "MemoryStore demonstrates contracts; it is not durable storage or an authorization boundary."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/StoreLifecycle.java",
          "mainClass": "io.github.agentic.ai.examples.StoreLifecycle",
          "description": "Demonstrates upsert, namespace isolation, filtered pagination and targeted deletion.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.RuntimeStore",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.StoreLifecycle",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/scheduling",
      "artifact": "example-scheduling",
      "mainClass": "io.github.agentic.ai.examples.ScheduledWorkflow",
      "entry": "src/main/java/io/github/agentic/ai/examples/ScheduledWorkflow.java",
      "description": "Schedules a graph at a fixed delay and shuts down the task manager after completion.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/SchedulePolicies.java",
        "src/main/java/io/github/agentic/ai/examples/ScheduledWorkflow.java"
      ],
      "demonstratedBehaviors": [
        "Schedules a graph at a fixed delay and shuts down the task manager after completion.",
        "Caller-selectable fixed-delay, fixed-rate and cron modes with bounded waiting and scheduler shutdown."
      ],
      "limitations": [
        "Single-process schedules; no distributed lock, misfire recovery or clustered scheduler."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.ScheduledWorkflow",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/spring-ai-integration",
      "artifact": "example-spring-ai-integration",
      "mainClass": "io.github.agentic.ai.examples.GraphModelStreaming",
      "entry": "src/main/java/io/github/agentic/ai/examples/GraphModelStreaming.java",
      "description": "Adapts a Spring AI model into a neutral streaming LlmNode and consumes graph events.",
      "runtime": "model",
      "requirements": "Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/GraphModelStreaming.java"
      ],
      "demonstratedBehaviors": [
        "Adapts a Spring AI model into a neutral streaming LlmNode and consumes graph events."
      ],
      "limitations": [
        "One streaming LlmNode; provider-specific event extensions and live cancellation are not validated."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.GraphModelStreaming",
            "args": [],
            "runtime": "model",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/state-serialization",
      "artifact": "example-state-serialization",
      "mainClass": "io.github.agentic.ai.examples.StateSerialization",
      "entry": "src/main/java/io/github/agentic/ai/examples/StateSerialization.java",
      "description": "Append and replace reducers plus neutral message serialization round trips.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/MessageFixtures.java",
        "src/main/java/io/github/agentic/ai/examples/MessageRoundTrip.java",
        "src/main/java/io/github/agentic/ai/examples/StateSerialization.java"
      ],
      "demonstratedBehaviors": [
        "Append and replace reducers plus neutral message serialization round trips.",
        "Complete assistant/tool exchange, metadata, binary image content, text editing that preserves attachments and checkpoint round-trip equality."
      ],
      "limitations": [
        "Neutral text, tool and image messages; live audio/video provider support is not demonstrated."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/MessageRoundTrip.java",
          "mainClass": "io.github.agentic.ai.examples.MessageRoundTrip",
          "description": "Round-trips binary content and tool messages without making a model request.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.StateSerialization",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.MessageRoundTrip",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/subgraph-as-compiled-graph",
      "artifact": "example-subgraph-as-compiled-graph",
      "mainClass": "io.github.agentic.ai.examples.SubgraphAsCompiledGraph",
      "entry": "src/main/java/io/github/agentic/ai/examples/SubgraphAsCompiledGraph.java",
      "description": "Embeds a compiled child directly and demonstrates reusable state transformation.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/SubgraphAsCompiledGraph.java"
      ],
      "demonstratedBehaviors": [
        "Embeds a compiled child directly and demonstrates reusable state transformation."
      ],
      "limitations": [
        "Compiled child composition; no nested runtime migration or distributed execution."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.SubgraphAsCompiledGraph",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/subgraph-as-node",
      "artifact": "example-subgraph-as-node",
      "mainClass": "io.github.agentic.ai.examples.SubgraphAsNode",
      "entry": "src/main/java/io/github/agentic/ai/examples/SubgraphAsNode.java",
      "description": "Explicitly maps parent input/output to a child graph with private state.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/SubgraphAsNode.java"
      ],
      "demonstratedBehaviors": [
        "Explicitly maps parent input/output to a child graph with private state."
      ],
      "limitations": [
        "Explicit parent/child state mapping; no remote child execution."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.SubgraphAsNode",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/subgraphs",
      "artifact": "example-subgraphs",
      "mainClass": "io.github.agentic.ai.examples.Subgraphs",
      "entry": "src/main/java/io/github/agentic/ai/examples/Subgraphs.java",
      "description": "A StateGraph subgraph shares parent state and produces a normalized invoice.",
      "runtime": "local",
      "requirements": "No API key, container, or external service is required.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/Subgraphs.java"
      ],
      "demonstratedBehaviors": [
        "A StateGraph subgraph shares parent state and produces a normalized invoice."
      ],
      "limitations": [
        "Shared parent/child state example; no distributed subgraph execution."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-15",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.Subgraphs",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/tool-execution-policies",
      "artifact": "example-tool-execution-policies",
      "mainClass": "io.github.agentic.ai.examples.ToolExecutionPolicies",
      "entry": "src/main/java/io/github/agentic/ai/examples/ToolExecutionPolicies.java",
      "description": "Runs a real AgentToolNode with application-owned trusted identity, opt-in argument validation and explicit business-result mapping.",
      "runtime": "local",
      "requirements": "Java 17 and pinned Core RC2 artifacts; no external services.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/EffectAwareRetries.java",
        "src/main/java/io/github/agentic/ai/examples/SelectionFailurePolicies.java",
        "src/main/java/io/github/agentic/ai/examples/ToolExecutionPolicies.java"
      ],
      "demonstratedBehaviors": [
        "Runs a real AgentToolNode with application-owned trusted identity, opt-in argument validation and explicit business-result mapping.",
        "Missing identity and revoked permission yield auth-denied with zero callbacks; invalid arguments yield error with zero callbacks; a registered invoice decline yields business-failed; an unregistered decline stays SUCCESS."
      ],
      "limitations": [
        "The ledger is an in-process example. SelectionFailurePolicies deliberately injects selector unavailability; EffectAwareRetries injects an uncertain timeout. No model-quality, real authorization provider or external exactly-once guarantee is demonstrated."
      ],
      "scenarios": [
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/EffectAwareRetries.java",
          "mainClass": "io.github.agentic.ai.examples.EffectAwareRetries",
          "description": "Local controlled failure drill.",
          "runtime": "local"
        },
        {
          "entry": "src/main/java/io/github/agentic/ai/examples/SelectionFailurePolicies.java",
          "mainClass": "io.github.agentic.ai.examples.SelectionFailurePolicies",
          "description": "Local controlled failure drill.",
          "runtime": "local"
        }
      ],
      "validation": {
        "date": "2026-10-18",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.ToolExecutionPolicies",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.EffectAwareRetries",
            "args": [],
            "runtime": "local",
            "status": "passed"
          },
          {
            "mainClass": "io.github.agentic.ai.examples.SelectionFailurePolicies",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/context-provenance",
      "artifact": "example-context-provenance",
      "mainClass": "io.github.agentic.ai.examples.ContextProvenance",
      "entry": "src/main/java/io/github/agentic/ai/examples/ContextProvenance.java",
      "description": "Tags retrieved documents and child output, constructs two summaries and clamps a forged high-trust claim.",
      "runtime": "local",
      "requirements": "Java 17 and pinned Core RC2 artifacts; no external services.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/ContextProvenance.java"
      ],
      "demonstratedBehaviors": [
        "Tags retrieved documents and child output, constructs two summaries and clamps a forged high-trust claim.",
        "Application instructions remain trusted; retrieved and child content are untrusted; summaries are derived and retain attribution."
      ],
      "limitations": [
        "Summary text is supplied by the application. This does not run a summarization model, prove prompt-injection immunity or authenticate serialized metadata."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-18",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.ContextProvenance",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/background-tasks",
      "artifact": "example-background-tasks",
      "mainClass": "io.github.agentic.ai.examples.BackgroundTasks",
      "entry": "src/main/java/io/github/agentic/ai/examples/BackgroundTasks.java",
      "description": "Uses one execution slot and one waiting slot to demonstrate capacity and duplicate-ID rejection, completion and explicit result removal.",
      "runtime": "local",
      "requirements": "Java 17 and pinned Core RC2 artifacts; no external services.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/BackgroundTasks.java"
      ],
      "demonstratedBehaviors": [
        "Uses one execution slot and one waiting slot to demonstrate capacity and duplicate-ID rejection, completion and explicit result removal.",
        "The third submission and a duplicate ID are rejected; both accepted tasks complete after the gate opens; owned resources close."
      ],
      "limitations": [
        "This is a local JVM repository, without tenant isolation or crash recovery. Results may expire. Cancelling or hiding active work does not immediately free its slot."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-18",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.BackgroundTasks",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-agent-example/batched-array-loop",
      "artifact": "example-batched-array-loop",
      "mainClass": "io.github.agentic.ai.examples.BatchedArrayLoop",
      "entry": "src/main/java/io/github/agentic/ai/examples/BatchedArrayLoop.java",
      "description": "Drives the actual LoopMode.array initialization and dispatch strategy with ordered JSON input.",
      "runtime": "local",
      "requirements": "Java 17 and pinned Core RC2 artifacts; no external services.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/BatchedArrayLoop.java"
      ],
      "demonstratedBehaviors": [
        "Drives the actual LoopMode.array initialization and dispatch strategy with ordered JSON input.",
        "[1,2,3,4,5] with batch size 2 yields [1,2], [3,4], [5]. Explicit size 1 keeps array framing; the legacy constructor yields scalar text."
      ],
      "limitations": [
        "This inspects dispatch without a model-backed child. Batching does not enable parallel execution or establish throughput improvements."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-18",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.BatchedArrayLoop",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    },
    {
      "path": "argi-graph-example/versioned-recovery",
      "artifact": "example-versioned-recovery",
      "mainClass": "io.github.agentic.ai.examples.VersionedRecovery",
      "entry": "src/main/java/io/github/agentic/ai/examples/VersionedRecovery.java",
      "description": "Serializes exact graph, tool catalog, codec and application references and resolves them against an upgraded registry.",
      "runtime": "local",
      "requirements": "Java 17 and pinned Core RC2 artifacts; no external services.",
      "profiles": [],
      "sources": [
        "src/main/java/io/github/agentic/ai/examples/VersionedRecovery.java"
      ],
      "demonstratedBehaviors": [
        "Serializes exact graph, tool catalog, codec and application references and resolves them against an upgraded registry.",
        "A version-one run resolves version one even when version two exists; missing old versions and incompatible codecs are rejected. MemoryRunStore cannot enter durable mode."
      ],
      "limitations": [
        "Registry values are local data definitions. This is an admission contract, not a task runner, persistent backend or cross-JVM recovery demonstration."
      ],
      "scenarios": [],
      "validation": {
        "date": "2026-10-18",
        "compile": "passed",
        "runtime": [
          {
            "mainClass": "io.github.agentic.ai.examples.VersionedRecovery",
            "args": [],
            "runtime": "local",
            "status": "passed"
          }
        ]
      }
    }
  ],
  "websiteCoverage": [
    {
      "source": "argi-website/docs/frameworks/graph-core/quick-start.md",
      "examples": [
        "argi-graph-example/hello-graph"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/workflow-orchestration.md",
      "examples": [
        "argi-agent-example/support-workflow"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/context-management.md",
      "examples": [
        "argi-agent-example/context-engineering",
        "argi-graph-example/runtime-store"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/observation.md",
      "examples": [
        "argi-graph-example/observation"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/persistence.md",
      "examples": [
        "argi-graph-example/persistence",
        "argi-extensions-example/jdbc-checkpoint",
        "argi-extensions-example/redis-checkpoint",
        "argi-extensions-example/mongodb-checkpoint"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/runtime-config.md",
      "examples": [
        "argi-graph-example/runtime-store",
        "argi-graph-example/human-in-the-loop"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/scheduling.md",
      "examples": [
        "argi-graph-example/scheduling"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/store.md",
      "examples": [
        "argi-graph-example/runtime-store"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/streaming.md",
      "examples": [
        "argi-graph-example/spring-ai-integration",
        "argi-agent-example/routing-streaming"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/concepts/edges.md",
      "examples": [
        "argi-graph-example/conditional-routing",
        "argi-graph-example/parallel-nodes"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/concepts/graph.md",
      "examples": [
        "argi-graph-example/hello-graph",
        "argi-graph-example/plantuml"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/concepts/nodes.md",
      "examples": [
        "argi-graph-example/spring-ai-integration",
        "argi-extensions-example/http-node",
        "argi-graph-example/subgraph-as-node"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/concepts/serializer.md",
      "examples": [
        "argi-graph-example/state-serialization"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/concepts/state.md",
      "examples": [
        "argi-graph-example/state-serialization"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/concepts/threads.md",
      "examples": [
        "argi-agent-example/context-engineering",
        "argi-graph-example/persistence"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/examples/spring-ai-integration.md",
      "examples": [
        "argi-graph-example/spring-ai-integration"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/examples/parallel-nodes.md",
      "examples": [
        "argi-graph-example/parallel-nodes"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/examples/subgraphs.md",
      "examples": [
        "argi-graph-example/subgraphs"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/examples/subgraph-as-node.md",
      "examples": [
        "argi-graph-example/subgraph-as-node"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/examples/subgraph-as-compiled-graph.md",
      "examples": [
        "argi-graph-example/subgraph-as-compiled-graph"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/examples/persistence.md",
      "examples": [
        "argi-graph-example/persistence"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/examples/hitl.md",
      "examples": [
        "argi-graph-example/hitl"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/examples/cancellation.md",
      "examples": [
        "argi-graph-example/cancellation"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/examples/plantuml.md",
      "examples": [
        "argi-graph-example/plantuml"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/a2a.md",
      "examples": [
        "argi-agent-example/a2a",
        "argi-extensions-example/a2a-nacos"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/agents-intro.md",
      "examples": [
        "argi-agent-example/react-tools",
        "argi-agent-example/multi-agent"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/builtin-tools.md",
      "examples": [
        "argi-agent-example/builtin-tools",
        "argi-extensions-example/docker-execution",
        "argi-extensions-example/sandbox-tools"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/hitl.md",
      "examples": [
        "argi-agent-example/agent-hitl",
        "argi-agent-example/support-workflow"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/hooks-interceptors.md",
      "examples": [
        "argi-agent-example/interceptors",
        "argi-agent-example/hooks-and-retries",
        "argi-agent-example/context-compaction"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/memory.md",
      "examples": [
        "argi-agent-example/context-engineering",
        "argi-agent-example/context-compaction",
        "argi-graph-example/runtime-store",
        "argi-extensions-example/memory-backends"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/messages.md",
      "examples": [
        "argi-graph-example/state-serialization",
        "argi-agent-example/routing-streaming"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/multi-agent.md",
      "examples": [
        "argi-agent-example/multi-agent",
        "argi-agent-example/routing-streaming",
        "argi-agent-example/agent-as-tool"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/quick-start.md",
      "examples": [
        "argi-agent-example/react-tools",
        "argi-agent-example/studio-chatbot"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/rag.md",
      "examples": [
        "argi-agent-example/agentic-rag",
        "argi-extensions-example/rag-retrieval"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/react-agent-theory.md",
      "examples": [
        "argi-agent-example/react-tools"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/runtime-config.md",
      "examples": [
        "argi-agent-example/context-engineering",
        "argi-graph-example/runtime-store"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/skills.md",
      "examples": [
        "argi-agent-example/skills"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/structured-io.md",
      "examples": [
        "argi-agent-example/structured-output"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/tools-as-agent.md",
      "examples": [
        "argi-agent-example/agent-as-tool"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/tools.md",
      "examples": [
        "argi-agent-example/react-tools",
        "argi-agent-example/builtin-tools",
        "argi-extensions-example/mcp-discovery"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/workflow.md",
      "examples": [
        "argi-agent-example/support-workflow",
        "argi-agent-example/multi-agent"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/extensions/chat-memory.md",
      "examples": [
        "argi-extensions-example/jdbc-chat-memory",
        "argi-extensions-example/memory-backends",
        "argi-extensions-example/mem0-memory"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/extensions/mcp-gateway.md",
      "examples": [
        "argi-extensions-example/mcp-gateway"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/extensions/mcp-router.md",
      "examples": [
        "argi-extensions-example/mcp-router"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/extensions/mcp.md",
      "examples": [
        "argi-extensions-example/mcp-client",
        "argi-extensions-example/mcp-registry",
        "argi-extensions-example/mcp-discovery"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/extensions/nacos-prompt.md",
      "examples": [
        "argi-extensions-example/nacos-prompt"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/extensions/observation.md",
      "examples": [
        "argi-graph-example/observation"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/extensions/overview.md",
      "examples": [
        "argi-extensions-example/memory-backends",
        "argi-extensions-example/vector-backends",
        "argi-extensions-example/mcp-registry",
        "argi-extensions-example/rag-retrieval"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/extensions/rag.md",
      "examples": [
        "argi-extensions-example/rag-retrieval",
        "argi-agent-example/agentic-rag"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/extensions/vector-stores.md",
      "examples": [
        "argi-extensions-example/tair-vector-store",
        "argi-extensions-example/vector-backends"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/studio/quick-start.md",
      "examples": [
        "argi-agent-example/studio-chatbot"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/planner.md",
      "examples": [
        "argi-agent-example/planner"
      ]
    },
    {
      "source": "argi-website/docs/quick-start.md",
      "examples": [
        "argi-graph-example/hello-graph",
        "argi-agent-example/react-tools"
      ]
    },
    {
      "source": "argi-website/docs/overview.md",
      "examples": [
        "argi-graph-example/hello-graph",
        "argi-agent-example/react-tools"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/tool-execution-policies.md",
      "examples": [
        "argi-agent-example/tool-execution-policies"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/context-provenance.md",
      "examples": [
        "argi-agent-example/context-provenance"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/background-tasks.md",
      "examples": [
        "argi-agent-example/background-tasks"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/batched-array-loops.md",
      "examples": [
        "argi-agent-example/batched-array-loop"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/graph-core/versioned-recovery.md",
      "examples": [
        "argi-graph-example/versioned-recovery",
        "argi-graph-example/recoverable-runs"
      ]
    },
    {
      "source": "argi-website/docs/frameworks/agent-framework/runtime-contracts.md",
      "examples": [
        "argi-agent-example/tool-execution-policies",
        "argi-agent-example/context-provenance",
        "argi-agent-example/background-tasks",
        "argi-agent-example/batched-array-loop",
        "argi-graph-example/versioned-recovery"
      ]
    }
  ],
  "coverageMeaning": "Website mappings are navigation links, not exhaustive API or scenario coverage. Demonstrated behaviors describe source implementations; runtime verification is separate.",
  "projectSourceCoverage": [
    {
      "source": "argi/argi-graph-core/src/main/java/io/github/agentic/ai/graph/execution/run",
      "revision": "f61a477220b9caec4d63b9469dbab5877eff1df9",
      "examples": [
        "argi-graph-example/recoverable-runs"
      ]
    }
  ],
  "currentBaseline": {
    "core": "5ec935b384d5379324ee60277ddcd3a6683a861f",
    "date": "2026-10-18",
    "newModulesValidation": "compiled; seven local entry points completed with expected output"
  }
}