hexdag-forge 0.2.0.dev3__tar.gz → 0.2.0.dev4__tar.gz

{hexdag_forge-0.2.0.dev3 → hexdag_forge-0.2.0.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexdag-forge
-Version: 0.2.0.dev3
+Version: 0.2.0.dev4
 Summary: Generate operational systems from prompts — code generator powered by hexDAG
 Project-URL: Homepage, https://hexdag.ai
 Project-URL: Repository, https://github.com/omniviser/hexdag

{hexdag_forge-0.2.0.dev3 → hexdag_forge-0.2.0.dev4}/hexdag_forge/generator/assembler.py

@@ -18,12 +18,19 @@ from hexdag_forge.generator.service_generator import generate_services
 from hexdag_forge.generator.system_generator import generate_system
 
 
-def assemble(profile: BusinessProfile, output_dir: Path) -> GeneratedSystem:
+def assemble(
+    profile: BusinessProfile,
+    output_dir: Path,
+    *,
+    skip_migration: bool = False,
+) -> GeneratedSystem:
     """Generate all files from a BusinessProfile and write to output_dir.
 
     Args:
         profile: The business profile to generate from.
         output_dir: Directory to write generated files to.
+        skip_migration: If True, skip migration generation (used when the
+            caller has already generated the migration, e.g. ``forge_migrate``).
 
     Returns:
         GeneratedSystem with metadata about what was generated.
@@ -67,19 +74,29 @@ def assemble(profile: BusinessProfile, output_dir: Path) -> GeneratedSystem:
     migrations_dir.mkdir(exist_ok=True)
     (migrations_dir / "__init__.py").write_text("")
 
-    from hexdag_forge.generator.migration_generator import generate_migration
-
-    empty_profile = BusinessProfile(
-        business_name=profile.business_name,
-        business_type=profile.business_type,
-        description=profile.description,
-        entities=[],
-        app_label=profile.app_label,
-    )
-    result = generate_migration(empty_profile, profile, migrations_dir)
-    if result is not None:
-        filename, migration_content = result
-        (migrations_dir / filename).write_text(migration_content)
+    if not skip_migration:
+        from hexdag_forge.generator.migration_generator import generate_migration
+
+        # Use existing profile.json (from a previous run) as the old state so
+        # that diff_profiles produces incremental operations (AddField, etc.)
+        # instead of CreateModel for every entity.  On the first run the file
+        # does not exist yet, so we fall back to an empty profile.
+        profile_path = output_dir / "profile.json"
+        if profile_path.exists():
+            old_profile = BusinessProfile.model_validate_json(profile_path.read_text())
+        else:
+            old_profile = BusinessProfile(
+                business_name=profile.business_name,
+                business_type=profile.business_type,
+                description=profile.description,
+                entities=[],
+                app_label=profile.app_label,
+            )
+
+        result = generate_migration(old_profile, profile, migrations_dir)
+        if result is not None:
+            filename, migration_content = result
+            (migrations_dir / filename).write_text(migration_content)
 
     # Write profile.json for refinement
     (output_dir / "profile.json").write_text(profile.model_dump_json(indent=2))

{hexdag_forge-0.2.0.dev3 → hexdag_forge-0.2.0.dev4}/hexdag_forge/generator/django_generator.py

@@ -4,7 +4,13 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
-from hexdag_forge.generator.template_engine import render_html_template, render_template
+from hexdag_forge.generator.template_engine import (
+    build_badge_map,
+    build_fk_fields,
+    build_list_columns,
+    render_html_template,
+    render_template,
+)
 
 if TYPE_CHECKING:
     from hexdag_forge.domain.business_profile import BusinessProfile
@@ -17,8 +23,13 @@ def generate_django(profile: BusinessProfile) -> dict[str, str]:
         Dict of relative path -> file content.
     """
     app = profile.app_label
+    badge_colors = build_badge_map(profile)
     files: dict[str, str] = {}
 
+    # Pre-compute per-entity context
+    list_columns_map = {e.name: build_list_columns(e) for e in profile.entities}
+    fk_fields_map = {e.name: build_fk_fields(e) for e in profile.entities}
+
     # ── Python files (standard Jinja2 delimiters) ──────────
     files[f"{app}/models.py"] = render_template("django_model.py.j2", profile=profile)
     files[f"{app}/apps.py"] = render_template("django_apps.py.j2", profile=profile)
@@ -29,10 +40,24 @@ def generate_django(profile: BusinessProfile) -> dict[str, str]:
     files["state_machines.py"] = render_template("state_machines.py.j2", profile=profile)
     files["views.py"] = render_template("django_views.py.j2", profile=profile)
     files["forms.py"] = render_template("django_forms.py.j2", profile=profile)
+    files["chat_agent.py"] = render_template("django_chat_agent.py.j2", profile=profile)
+
+    # Templatetags
+    files[f"{app}/templatetags/__init__.py"] = ""
+    files[f"{app}/templatetags/{app}_tags.py"] = render_template(
+        "django_templatetags.py.j2", profile=profile, badge_colors=badge_colors
+    )
 
     # ── HTML templates (alt delimiters — outputs Django template syntax) ──
     files["templates/base.html"] = render_html_template("django_base.html.j2", profile=profile)
 
+    # Dashboard
+    files["templates/dashboard/index.html"] = render_html_template(
+        "django_dashboard.html.j2",
+        profile=profile,
+        list_columns=list_columns_map,
+    )
+
     # Auth
     files["templates/registration/login.html"] = render_html_template(
         "django_login.html.j2", profile=profile
@@ -47,7 +72,14 @@ def generate_django(profile: BusinessProfile) -> dict[str, str]:
     # Per-entity CRUD templates
     for entity in profile.entities:
         prefix = f"templates/{entity.name}"
-        ctx = {"entity": entity, "profile": profile}
+        list_cols = list_columns_map[entity.name]
+        fk_flds = fk_fields_map[entity.name]
+        ctx = {
+            "entity": entity,
+            "profile": profile,
+            "list_columns": list_cols,
+            "fk_fields": fk_flds,
+        }
         files[f"{prefix}/list.html"] = render_html_template("django_entity_list.html.j2", **ctx)
         files[f"{prefix}/_list_rows.html"] = render_html_template(
             "django_entity_list_partial.html.j2", **ctx
@@ -57,6 +89,9 @@ def generate_django(profile: BusinessProfile) -> dict[str, str]:
             "django_entity_detail_partial.html.j2", **ctx
         )
         files[f"{prefix}/form.html"] = render_html_template("django_entity_form.html.j2", **ctx)
+        files[f"{prefix}/_form_modal.html"] = render_html_template(
+            "django_entity_form_modal.html.j2", **ctx
+        )
         files[f"{prefix}/confirm_delete.html"] = render_html_template(
             "django_entity_confirm_delete.html.j2", **ctx
         )

{hexdag_forge-0.2.0.dev3 → hexdag_forge-0.2.0.dev4}/hexdag_forge/generator/pipeline_generator.py

@@ -21,4 +21,8 @@ def generate_pipelines(profile: BusinessProfile) -> dict[str, str]:
         filename = f"{entity.name}_lifecycle.yaml"
         content = render_template("pipeline.yaml.j2", entity=entity)
         pipelines[filename] = content
+
+    # Chat agent pipeline
+    pipelines["chat_agent.yaml"] = render_template("chat_pipeline.yaml.j2", profile=profile)
+
     return pipelines

hexdag_forge-0.2.0.dev4/hexdag_forge/generator/template_engine.py

@@ -0,0 +1,209 @@
+"""Jinja2 template rendering engine for code generation."""
+
+from __future__ import annotations
+
+from pathlib import Path  # noqa: TC003
+from typing import TYPE_CHECKING
+
+from jinja2 import Environment, FileSystemLoader
+
+if TYPE_CHECKING:
+    from hexdag_forge.domain.business_profile import BusinessProfile, EntitySpec
+
+_TEMPLATE_DIR = Path(__file__).parent.parent / "templates"
+
+
+# ── Jinja2 filters ──────────────────────────────────────────
+
+
+def _to_pascal(value: str) -> str:
+    """Convert snake_case to PascalCase: ``freight_brokerage`` → ``FreightBrokerage``."""
+    return "".join(word.capitalize() for word in value.split("_"))
+
+
+def _humanize(value: str) -> str:
+    """Convert snake_case to human-readable: ``company_name`` → ``Company Name``."""
+    return value.replace("_", " ").title()
+
+
+def _status_color(state: str) -> str:
+    """Map a state name to a CSS badge color class using naming heuristics."""
+    s = state.upper()
+    # Exact matches
+    _GREEN = {
+        "COMPLETED",
+        "DELIVERED",
+        "DONE",
+        "APPROVED",
+        "ACTIVE",
+        "PAID",
+        "RESOLVED",
+        "AVAILABLE",
+        "PICKED_UP",
+    }
+    _RED = {
+        "CANCELLED",
+        "REJECTED",
+        "FAILED",
+        "SUSPENDED",
+        "BLOCKED",
+        "EXPIRED",
+        "DELETED",
+        "TERMINATED",
+        "VOID",
+        "RETIRED",
+        "CLOSED",
+    }
+    _BLUE = {
+        "DISPATCHED",
+        "SENT",
+        "ONBOARDING",
+        "CONFIRMED",
+        "ASSIGNED",
+    }
+    _PURPLE = {
+        "IN_TRANSIT",
+        "IN_PROGRESS",
+        "PROCESSING",
+        "ON_TRIP",
+        "IN_USE",
+        "COVERED",
+    }
+    _YELLOW = {
+        "SUSPENDED",
+        "MAINTENANCE",
+        "INVOICED",
+        "OVERDUE",
+        "OFF_DUTY",
+    }
+    _GRAY = {
+        "DRAFT",
+        "PENDING",
+        "NEW",
+        "POSTED",
+        "PROSPECT",
+        "CREATED",
+        "QUEUED",
+    }
+
+    if s in _GREEN:
+        return "badge-green"
+    if s in _RED:
+        return "badge-red"
+    if s in _PURPLE:
+        return "badge-purple"
+    if s in _YELLOW:
+        return "badge-yellow"
+    if s in _BLUE:
+        return "badge-blue"
+    if s in _GRAY:
+        return "badge-gray"
+
+    # Keyword heuristic fallback
+    if any(kw in s for kw in ("COMPLET", "DELIVER", "DONE", "APPROV", "ACTIV", "AVAIL", "PAID")):
+        return "badge-green"
+    if any(kw in s for kw in ("CANCEL", "REJECT", "FAIL", "TERMINAT", "VOID", "RETIR", "CLOSE")):
+        return "badge-red"
+    if any(kw in s for kw in ("TRANSIT", "TRIP", "PROGRESS", "PROCESS", "USE")):
+        return "badge-purple"
+    if any(kw in s for kw in ("SUSPEND", "MAINT", "OVERDUE")):
+        return "badge-yellow"
+    if any(kw in s for kw in ("DISPATCH", "SENT", "ONBOARD", "REVIEW")):
+        return "badge-blue"
+    return "badge-gray"
+
+
+def _transition_color(state: str) -> str:
+    """Map a target state to a button CSS class for transition buttons."""
+    color = _status_color(state)
+    return {
+        "badge-green": "btn-success",
+        "badge-red": "btn-danger",
+        "badge-purple": "btn-primary",
+        "badge-blue": "btn-primary",
+        "badge-yellow": "btn-warning",
+        "badge-gray": "btn-outline",
+    }.get(color, "btn-outline")
+
+
+# ── Context builders ────────────────────────────────────────
+
+
+def build_badge_map(profile: BusinessProfile) -> dict[str, str]:
+    """Build a {state_name: badge_class} map for all states across all entities."""
+    result: dict[str, str] = {}
+    for entity in profile.entities:
+        for state in entity.states:
+            result[state] = _status_color(state)
+    return result
+
+
+def build_list_columns(entity: EntitySpec) -> list[object]:
+    """Select fields suitable for list table display (skip text/json, cap at 5)."""
+    return [f for f in entity.fields if f.type not in ("text", "json")][:5]
+
+
+def build_fk_fields(entity: EntitySpec) -> list[object]:
+    """Return belongs_to relationship specs for select_related."""
+    return [r for r in entity.relationships if r.kind == "belongs_to"]
+
+
+# ── Environments ────────────────────────────────────────────
+
+
+def _register_filters(env: Environment) -> None:
+    """Register all custom filters on a Jinja2 environment."""
+    env.filters["to_pascal"] = _to_pascal
+    env.filters["humanize"] = _humanize
+    env.filters["status_color"] = _status_color
+    env.filters["transition_color"] = _transition_color
+
+
+def create_env() -> Environment:
+    """Create a Jinja2 environment configured for Python code generation."""
+    env = Environment(  # nosec B701 — code generation templates, not HTML
+        loader=FileSystemLoader(str(_TEMPLATE_DIR)),
+        keep_trailing_newline=True,
+        trim_blocks=True,
+        lstrip_blocks=True,
+        autoescape=False,
+    )
+    _register_filters(env)
+    return env
+
+
+def create_html_env() -> Environment:
+    """Create a Jinja2 environment for templates that OUTPUT Django template syntax.
+
+    Uses alternate delimiters to avoid collision with Django's ``{% %}`` and ``{{ }}``.
+    Jinja2 generation uses ``[% %]`` and ``[[ ]]``, Django tags pass through untouched.
+    """
+    env = Environment(  # nosec B701 — code generation templates, not HTML
+        loader=FileSystemLoader(str(_TEMPLATE_DIR)),
+        keep_trailing_newline=True,
+        trim_blocks=True,
+        lstrip_blocks=True,
+        autoescape=False,
+        block_start_string="[%",
+        block_end_string="%]",
+        variable_start_string="[[",
+        variable_end_string="]]",
+        comment_start_string="[#",
+        comment_end_string="#]",
+    )
+    _register_filters(env)
+    return env
+
+
+def render_template(template_name: str, **context: object) -> str:
+    """Render a Jinja2 template with the given context (standard delimiters)."""
+    env = create_env()
+    template = env.get_template(template_name)
+    return template.render(**context)
+
+
+def render_html_template(template_name: str, **context: object) -> str:
+    """Render a Jinja2 template that outputs Django template syntax (alt delimiters)."""
+    env = create_html_env()
+    template = env.get_template(template_name)
+    return template.render(**context)

{hexdag_forge-0.2.0.dev3 → hexdag_forge-0.2.0.dev4}/hexdag_forge/mcp/server.py

@@ -117,7 +117,7 @@ async def forge_migrate(new_profile_json: str, output_dir: str = "./generated")
             migration_info = {"migration": filename, "operations": content.count("migrations.")}
 
     # Regenerate all files with new profile
-    gen_result = assemble(new_profile, output)
+    gen_result = assemble(new_profile, output, skip_migration=True)
 
     return json.dumps(
         {

hexdag_forge-0.2.0.dev4/hexdag_forge/templates/chat_pipeline.yaml.j2

@@ -0,0 +1,33 @@
+apiVersion: hexdag/v1
+kind: Pipeline
+metadata:
+  name: chat_agent
+  description: "Chat agent for {{ profile.business_name }} — routes user messages to entity services"
+spec:
+  nodes:
+    - kind: agent_node
+      metadata:
+        name: agent
+      spec:
+        main_prompt: |
+          You are an operations assistant for {{ profile.business_name }}.
+          You help users manage the following entities:
+{% for entity in profile.entities %}
+
+          ## {{ entity.display_name }}
+          Fields: {{ entity.fields | map(attribute='name') | join(', ') }}
+          States: {{ entity.states | join(' → ') }}
+          Valid transitions:
+{% for from_state, to_states in entity.transitions.items() %}
+            {{ from_state }} → {{ to_states | join(', ') }}
+{% endfor %}
+{% endfor %}
+
+          Use the available tools to look up, create, update, list, and transition entities.
+          Always confirm destructive actions before executing them.
+          When listing results, format them clearly.
+
+          User message: {% raw %}{{message}}{% endraw %}
+        config:
+          max_steps: 10
+      dependencies: []

hexdag_forge-0.2.0.dev4/hexdag_forge/templates/django_base.html.j2

@@ -0,0 +1,149 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>{% block title %}[[ profile.business_name ]]{% endblock %}</title>
+    <script src="https://unpkg.com/htmx.org@2.0.4"></script>
+    <style>
+        /* ── Reset & Base ───────────────────────────── */
+        *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+        body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; color: #1f2937; background: #f9fafb; display: flex; min-height: 100vh; font-size: 0.9rem; line-height: 1.5; }
+        a { color: #2563eb; text-decoration: none; }
+        a:hover { text-decoration: underline; }
+        h1, h2, h3 { font-weight: 600; color: #111827; }
+        h2 { font-size: 1.4rem; }
+
+        /* ── Sidebar ────────────────────────────────── */
+        .sidebar { width: 230px; background: #111827; color: #d1d5db; padding: 1.25rem 0; display: flex; flex-direction: column; flex-shrink: 0; }
+        .sidebar-brand { padding: 0 1.25rem 1rem; font-size: 1.05rem; font-weight: 700; color: #fff; border-bottom: 1px solid #374151; margin-bottom: 0.75rem; }
+        .sidebar-section { padding: 0.5rem 1.25rem 0.25rem; font-size: 0.65rem; text-transform: uppercase; letter-spacing: 0.08em; color: #6b7280; }
+        .sidebar ul { list-style: none; }
+        .sidebar li a { display: block; padding: 0.4rem 1.25rem; color: #d1d5db; font-size: 0.85rem; transition: background 0.15s; }
+        .sidebar li a:hover { background: #1f2937; color: #fff; text-decoration: none; }
+        .sidebar li a.active { background: #2563eb; color: #fff; }
+
+        /* ── Main ───────────────────────────────────── */
+        .main { flex: 1; display: flex; flex-direction: column; overflow-y: auto; }
+        .topbar { display: flex; justify-content: space-between; align-items: center; padding: 0.75rem 1.5rem; background: #fff; border-bottom: 1px solid #e5e7eb; }
+        .topbar .user-info { font-size: 0.85rem; color: #6b7280; }
+        .topbar .user-info a { color: #6b7280; margin-left: 0.5rem; }
+        .content { padding: 1.5rem; max-width: 1100px; }
+
+        /* ── Badges ─────────────────────────────────── */
+        .badge { display: inline-block; padding: 0.15rem 0.55rem; border-radius: 9999px; font-size: 0.7rem; font-weight: 600; white-space: nowrap; }
+        .badge-blue { background: #dbeafe; color: #1e40af; }
+        .badge-green { background: #dcfce7; color: #166534; }
+        .badge-yellow { background: #fef3c7; color: #92400e; }
+        .badge-red { background: #fee2e2; color: #991b1b; }
+        .badge-gray { background: #f3f4f6; color: #374151; }
+        .badge-purple { background: #f3e8ff; color: #6b21a8; }
+        .badge-indigo { background: #e0e7ff; color: #3730a3; }
+
+        /* ── Buttons ────────────────────────────────── */
+        .btn { display: inline-block; padding: 0.4rem 0.9rem; border-radius: 6px; font-size: 0.8rem; font-weight: 500; cursor: pointer; border: 1px solid transparent; text-decoration: none; transition: background 0.15s; }
+        .btn-primary { background: #2563eb; color: #fff; }
+        .btn-primary:hover { background: #1d4ed8; text-decoration: none; }
+        .btn-success { background: #16a34a; color: #fff; }
+        .btn-success:hover { background: #15803d; text-decoration: none; }
+        .btn-danger { background: #dc2626; color: #fff; }
+        .btn-danger:hover { background: #b91c1c; text-decoration: none; }
+        .btn-warning { background: #d97706; color: #fff; }
+        .btn-warning:hover { background: #b45309; text-decoration: none; }
+        .btn-outline { background: transparent; color: #374151; border-color: #d1d5db; }
+        .btn-outline:hover { background: #f3f4f6; text-decoration: none; }
+        .btn-sm { padding: 0.25rem 0.6rem; font-size: 0.72rem; }
+
+        /* ── Tables ─────────────────────────────────── */
+        table { width: 100%; border-collapse: collapse; background: #fff; border-radius: 8px; overflow: hidden; box-shadow: 0 1px 3px rgba(0,0,0,0.05); }
+        thead { background: #f9fafb; }
+        th { text-align: left; padding: 0.6rem 0.75rem; font-size: 0.72rem; text-transform: uppercase; letter-spacing: 0.05em; color: #6b7280; font-weight: 600; border-bottom: 1px solid #e5e7eb; }
+        td { padding: 0.6rem 0.75rem; border-bottom: 1px solid #f3f4f6; font-size: 0.85rem; }
+        tr.clickable { cursor: pointer; }
+        tr.clickable:hover { background: #f0f9ff; }
+
+        /* ── Filter pills ───────────────────────────── */
+        .filter-pills { display: flex; gap: 0.4rem; flex-wrap: wrap; margin-bottom: 1rem; }
+        .filter-pills a { padding: 0.25rem 0.7rem; border-radius: 9999px; font-size: 0.78rem; border: 1px solid #d1d5db; color: #374151; }
+        .filter-pills a:hover { background: #f3f4f6; text-decoration: none; }
+        .filter-pills a.active { background: #2563eb; color: #fff; border-color: #2563eb; }
+
+        /* ── Cards ──────────────────────────────────── */
+        .card { background: #fff; border-radius: 8px; padding: 1.25rem; box-shadow: 0 1px 3px rgba(0,0,0,0.05); }
+        .stat-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 1rem; margin-bottom: 1.5rem; }
+        .stat-card { background: #fff; border-radius: 8px; padding: 1rem 1.25rem; box-shadow: 0 1px 3px rgba(0,0,0,0.05); }
+        .stat-card .label { font-size: 0.72rem; text-transform: uppercase; letter-spacing: 0.05em; color: #6b7280; margin-bottom: 0.25rem; }
+        .stat-card .value { font-size: 1.5rem; font-weight: 700; color: #111827; }
+
+        /* ── Detail grid ────────────────────────────── */
+        .detail-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 0 2rem; }
+        .detail-item { padding: 0.6rem 0; border-bottom: 1px solid #f3f4f6; }
+        .detail-item .label { font-size: 0.7rem; text-transform: uppercase; letter-spacing: 0.05em; color: #6b7280; margin-bottom: 0.15rem; }
+        .detail-item .value { font-size: 0.9rem; color: #1f2937; }
+
+        /* ── Forms ──────────────────────────────────── */
+        .form-card { background: #fff; border-radius: 8px; padding: 1.5rem; box-shadow: 0 1px 3px rgba(0,0,0,0.05); max-width: 600px; }
+        .form-card p { margin-bottom: 0.75rem; }
+        .form-card label { display: block; font-size: 0.78rem; font-weight: 500; color: #374151; margin-bottom: 0.25rem; }
+        .form-card input, .form-card select, .form-card textarea { width: 100%; padding: 0.45rem 0.6rem; border: 1px solid #d1d5db; border-radius: 6px; font-size: 0.85rem; }
+        .form-card input:focus, .form-card select:focus, .form-card textarea:focus { outline: none; border-color: #2563eb; box-shadow: 0 0 0 2px rgba(37,99,235,0.15); }
+
+        /* ── Modal ──────────────────────────────────── */
+        .modal-overlay { position: fixed; inset: 0; background: rgba(0,0,0,0.4); display: flex; align-items: center; justify-content: center; z-index: 100; }
+        .modal-content { background: #fff; border-radius: 12px; padding: 1.5rem; width: 90%; max-width: 550px; max-height: 85vh; overflow-y: auto; box-shadow: 0 20px 60px rgba(0,0,0,0.2); }
+        .modal-content h2 { margin-bottom: 1rem; }
+
+        /* ── Misc ───────────────────────────────────── */
+        .toolbar { display: flex; justify-content: space-between; align-items: center; margin-bottom: 1rem; }
+        .action-row { display: flex; gap: 0.5rem; margin-top: 1rem; }
+        hr { border: none; border-top: 1px solid #e5e7eb; margin: 1rem 0; }
+        .empty-state { text-align: center; padding: 2rem; color: #9ca3af; }
+    </style>
+</head>
+<body hx-headers='{"X-CSRFToken": "{{ csrf_token }}"}'>
+    <nav class="sidebar">
+        <div class="sidebar-brand">[[ profile.business_name ]]</div>
+        <ul>
+            <li><a href="/">&#9632; Dashboard</a></li>
+        </ul>
+[% if profile.modules %]
+[% for module in profile.modules %]
+        <div class="sidebar-section">[[ module | humanize ]]</div>
+        <ul>
+[% for entity in profile.entities %]
+            <li><a href="/[[ entity.name ]]/">[[ entity.display_name ]]</a></li>
+[% endfor %]
+        </ul>
+[% endfor %]
+[% else %]
+        <div class="sidebar-section">Entities</div>
+        <ul>
+[% for entity in profile.entities %]
+            <li><a href="/[[ entity.name ]]/">[[ entity.display_name ]]</a></li>
+[% endfor %]
+        </ul>
+[% endif %]
+        <div class="sidebar-section" style="margin-top: auto;">Tools</div>
+        <ul>
+            <li><a href="/chat/">&#9993; Chat</a></li>
+            <li><a href="/admin/">&#9881; Admin</a></li>
+        </ul>
+    </nav>
+    <div class="main">
+        <div class="topbar">
+            <div>{% block heading %}{% endblock %}</div>
+            <div class="user-info">
+                {% if user.is_authenticated %}
+                    {{ user.username }} <a href="/logout/">Logout</a>
+                {% else %}
+                    <a href="/login/">Login</a>
+                {% endif %}
+            </div>
+        </div>
+        <div class="content">
+            {% block content %}{% endblock %}
+        </div>
+    </div>
+    <div id="modal-container"></div>
+</body>
+</html>

hexdag_forge-0.2.0.dev4/hexdag_forge/templates/django_chat_agent.py.j2

@@ -0,0 +1,97 @@
+"""Chat agent for {{ profile.business_name }}.
+
+Runs a hexDAG ReActAgentNode pipeline that routes user messages
+to entity service tools. Requires an LLM API key.
+
+Auto-generated by hexdag-forge.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import os
+from pathlib import Path
+
+from hexdag.api.execution import execute
+
+
+_PIPELINE_PATH = Path(__file__).parent / "pipelines" / "chat_agent.yaml"
+_pipeline_cache: str | None = None
+
+
+def _load_pipeline() -> str:
+    """Load the chat pipeline YAML (cached after first read)."""
+    global _pipeline_cache  # noqa: PLW0603
+    if _pipeline_cache is None:
+        _pipeline_cache = _PIPELINE_PATH.read_text()
+    return _pipeline_cache
+
+
+def _create_llm():
+    """Create an LLM adapter from environment configuration.
+
+    Checks for API keys in order: OpenAI → Anthropic → Google Gemini.
+    Set HEXDAG_CHAT_MODEL to override the default model for each provider.
+    """
+    model = os.environ.get("HEXDAG_CHAT_MODEL", "")
+
+    # OpenAI
+    if os.environ.get("OPENAI_API_KEY"):
+        from hexdag.stdlib.adapters.openai import OpenAIAdapter
+
+        return OpenAIAdapter(model=model or "gpt-4o-mini", temperature=0.7)
+
+    # Anthropic
+    if os.environ.get("ANTHROPIC_API_KEY"):
+        from hexdag.stdlib.adapters.anthropic import AnthropicAdapter
+
+        return AnthropicAdapter(model=model or "claude-sonnet-4-20250514")
+
+    # Google Gemini (via Vertex AI plugin)
+    if os.environ.get("GOOGLE_API_KEY") or os.environ.get("GOOGLE_APPLICATION_CREDENTIALS"):
+        from hexdag_plugins.google.adapters.vertex import VertexAIAdapter
+
+        return VertexAIAdapter(model=model or "gemini-2.0-flash")
+
+    return None
+
+
+async def process_message(message: str) -> str:
+    """Process a chat message through the hexDAG agent pipeline.
+
+    Args:
+        message: The user's message text.
+
+    Returns:
+        The agent's response text.
+    """
+    llm = _create_llm()
+    if llm is None:
+        return (
+            "No LLM configured. Set OPENAI_API_KEY, ANTHROPIC_API_KEY, "
+            "or GOOGLE_API_KEY environment variable to enable the chat agent."
+        )
+
+    pipeline_yaml = _load_pipeline()
+
+    result = await execute(
+        yaml_content=pipeline_yaml,
+        inputs={"message": message},
+        ports={"llm": llm},
+        timeout=60.0,
+    )
+
+    if not result.get("success"):
+        error = result.get("error", "Unknown error")
+        return f"Agent error: {error}"
+
+    # Extract the agent's final output
+    final = result.get("final_output", {})
+    if isinstance(final, dict):
+        return final.get("answer", final.get("content", str(final)))
+    return str(final)
+
+
+def process_message_sync(message: str) -> str:
+    """Synchronous wrapper for Django views."""
+    return asyncio.run(process_message(message))