enya-agent 0.1.0

package/docs/themes/tanuki/templates/section.html

@@ -0,0 +1,186 @@
+{% extends "base.html" %}
+
+{% block title %}{{ section.title }}{% endblock %}
+
+{% set mode = config.extra.mode | default(value="site") %}
+
+{% block sidebar %}
+{% if mode == "docs" %}
+{% include "partials/sidebar.html" %}
+{% endif %}
+{% endblock %}
+
+{% block content %}
+{% if mode == "site" or mode == "blog" %}
+{# raskell.io style articles listing #}
+<header>
+    <div class="container">
+        <h1>{{ section.title }}</h1>
+        {% if section.extra.subtitle %}
+        <p class="subtitle">{{ section.extra.subtitle }}</p>
+        {% endif %}
+    </div>
+</header>
+
+<section>
+    <div class="container">
+        <div class="search-container">
+            <input
+                id="search-query"
+                type="search"
+                placeholder="Search articles..."
+                autocomplete="off"
+            />
+            <div class="search-shortcuts">
+                <kbd>/</kbd>
+                <kbd>⌘K</kbd>
+            </div>
+        </div>
+
+        <section id="articles-list"></section>
+    </div>
+</section>
+
+<script>
+    // Render articles with yyyy-mm-dd prefix
+    const articlesList = document.getElementById('articles-list');
+    const articles = [
+        {% for page in section.pages %}
+        {
+            title: {{ page.title | json_encode | safe }},
+            permalink: {{ page.permalink | json_encode | safe }},
+            date: {{ page.date | json_encode | safe }},
+            dateFormatted: {{ page.date | date(format="%Y-%m-%d") | json_encode | safe }},
+            description: {{ page.description | default(value="") | json_encode | safe }}
+        }{% if not loop.last %},{% endif %}
+        {% endfor %}
+    ];
+
+    function renderArticles(articlesToRender) {
+        // Sort by date descending
+        const sorted = [...articlesToRender].sort((a, b) => new Date(b.date) - new Date(a.date));
+
+        let html = '<div class="posts">';
+        sorted.forEach(article => {
+            html += `
+                <div class="post" data-title="${article.title.toLowerCase()}" data-date="${article.dateFormatted}" data-description="${article.description.toLowerCase()}">
+                    <a href="${article.permalink}">
+                        <div class="post-row">
+                            <time>${article.dateFormatted}</time>
+                            <h3>${article.title}</h3>
+                        </div>
+                    </a>
+                </div>
+            `;
+        });
+        html += '</div>';
+
+        articlesList.innerHTML = html;
+    }
+
+    renderArticles(articles);
+</script>
+
+<script>
+    const searchInput = document.getElementById("search-query");
+
+    // Simple search filtering
+    searchInput.addEventListener("input", function () {
+        const query = this.value.trim().toLowerCase();
+        const posts = articlesList.querySelectorAll(".post");
+
+        if (query.length === 0) {
+            // Show all posts
+            posts.forEach((post) => (post.style.display = ""));
+            return;
+        }
+
+        // Filter posts by title, date, or description
+        posts.forEach((post) => {
+            const title = post.getAttribute("data-title") || "";
+            const date = post.getAttribute("data-date") || "";
+            const description = post.getAttribute("data-description") || "";
+
+            const searchText = `${title} ${date} ${description}`;
+
+            if (searchText.includes(query)) {
+                post.style.display = "";
+            } else {
+                post.style.display = "none";
+            }
+        });
+    });
+
+    // Keyboard shortcuts
+    document.addEventListener("keydown", function (e) {
+        // Cmd+K or Ctrl+K
+        if ((e.ctrlKey || e.metaKey) && e.key === "k") {
+            e.preventDefault();
+            searchInput.focus();
+            searchInput.select();
+        }
+        // Forward slash (/) when not in an input
+        else if (
+            e.key === "/" &&
+            !["INPUT", "TEXTAREA"].includes(document.activeElement.tagName)
+        ) {
+            e.preventDefault();
+            searchInput.focus();
+        }
+        // Escape to clear search
+        else if (e.key === "Escape" && document.activeElement === searchInput) {
+            searchInput.value = "";
+            searchInput.dispatchEvent(new Event("input"));
+            searchInput.blur();
+        }
+    });
+</script>
+
+{% else %}
+{# Original tanuki section layout for docs/book modes #}
+<article class="section-page">
+    <header class="section-page__header">
+        <h1>{{ section.title }}</h1>
+        {% if section.description %}
+        <p class="section-page__description">{{ section.description }}</p>
+        {% endif %}
+    </header>
+
+    {% if section.content %}
+    <div class="section-page__content">
+        {{ section.content | safe }}
+    </div>
+    {% endif %}
+
+    {% if section.pages %}
+    <ul class="page-list">
+        {% for page in section.pages %}
+        <li>
+            <a href="{{ page.permalink | safe }}">{{ page.title }}</a>
+            {% if page.description %}
+            <p>{{ page.description }}</p>
+            {% endif %}
+        </li>
+        {% endfor %}
+    </ul>
+    {% endif %}
+
+    {# Subsections #}
+    {% if section.subsections %}
+    {% for subsection_path in section.subsections %}
+    {% set subsection = get_section(path=subsection_path) %}
+    <section class="subsection">
+        <h2>{{ subsection.title }}</h2>
+        <ul class="page-list">
+            {% for page in subsection.pages %}
+            <li>
+                <a href="{{ page.permalink | safe }}">{{ page.title }}</a>
+            </li>
+            {% endfor %}
+        </ul>
+    </section>
+    {% endfor %}
+    {% endif %}
+</article>
+{% endif %}
+{% endblock %}

package/docs/themes/tanuki/templates/taxonomy_list.html

@@ -0,0 +1,18 @@
+{% extends "base.html" %}
+
+{% block title %}{{ taxonomy.name | title }}{% endblock %}
+
+{% block content %}
+<div class="taxonomy-list">
+    <h1 class="taxonomy-list__title">{{ taxonomy.name | title }}</h1>
+
+    <div class="taxonomy-list__items">
+        {% for term in terms %}
+        <a href="{{ term.permalink | safe }}" class="taxonomy-item">
+            <span class="taxonomy-item__name">{{ term.name }}</span>
+            <span class="taxonomy-item__count">{{ term.pages | length }}</span>
+        </a>
+        {% endfor %}
+    </div>
+</div>
+{% endblock %}

package/docs/themes/tanuki/templates/taxonomy_single.html

@@ -0,0 +1,31 @@
+{% extends "base.html" %}
+
+{% block title %}{{ term.name | title }}{% endblock %}
+
+{% block content %}
+<div class="taxonomy-single">
+    <h1 class="taxonomy-single__title">Posts tagged "{{ term.name }}"</h1>
+
+    <div class="blog-posts">
+        {% for page in term.pages %}
+        <article class="blog-card">
+            <div class="blog-card__content">
+                <h2 class="blog-card__title">
+                    <a href="{{ page.permalink | safe }}">{{ page.title }}</a>
+                </h2>
+                {% if page.description %}
+                <p class="blog-card__description">{{ page.description }}</p>
+                {% endif %}
+                <div class="blog-card__meta">
+                    {% if page.date %}
+                    <time datetime="{{ page.date }}">{{ page.date | date(format="%B %d, %Y") }}</time>
+                    {% endif %}
+                </div>
+            </div>
+        </article>
+        {% endfor %}
+    </div>
+</div>
+
+<a href="{{ get_url(path='tags') }}" class="btn btn--secondary">View all tags</a>
+{% endblock %}

package/docs/themes/tanuki/theme.toml

@@ -0,0 +1,58 @@
+# Tanuki Theme for Zola (タヌキ)
+# A versatile, Catppuccin-themed Zola theme for documentation, e-books, blogs, and product landing pages
+
+name = "tanuki"
+description = "A whimsical, Nintendo-inspired Zola theme with Catppuccin colors, Geist typography, and Lucide icons. Supports documentation (with versioning), e-books, blog/landing pages, and product landing pages. Named after the playful Japanese raccoon dog (タヌキ)."
+license = "MIT"
+homepage = "https://github.com/raskell-io/tanuki"
+repository = "https://github.com/raskell-io/tanuki"
+min_version = "0.19.0"
+demo = "https://tanuki.raskell.io"
+
+[author]
+name = "Raffael Schneider"
+homepage = "https://raskell.io"
+
+[extra]
+# Theme mode: "docs", "book", "site", or "product"
+mode = "site"
+
+[extra.docs]
+# Documentation-specific settings
+versioned = true
+default_version = "latest"
+
+[extra.book]
+# E-book-specific settings
+show_landing = true
+
+[extra.site]
+# Blog/landing page settings
+show_hero = true
+
+[extra.product]
+# Product landing page settings
+# Example configuration for a Raskell product:
+#
+# icon = "assets/product-icon.png"
+# tagline = "A powerful tool for modern developers"
+# footer_description = "Built with care by the Raskell team."
+# license = "Licensed under Apache 2.0."
+# install_command = "curl -fsSL https://get.raskell.io/myproduct | sh"
+# install_alternatives = "Or download from <a href='https://github.com/raskell-io/myproduct/releases'>GitHub Releases</a>"
+# features_title = "Features"
+# features = [
+#   { title = "Fast", description = "Optimized for speed and efficiency.", icon = "<svg>...</svg>" },
+#   { title = "Secure", description = "Built with security best practices.", icon = "<svg>...</svg>" },
+#   { title = "Simple", description = "Easy to install and configure.", icon = "<svg>...</svg>" }
+# ]
+# footer_links = [
+#   { title = "Resources", links = [
+#     { text = "Documentation", url = "/docs" },
+#     { text = "GitHub", url = "https://github.com/raskell-io/myproduct" }
+#   ]},
+#   { title = "Community", links = [
+#     { text = "Issues", url = "https://github.com/raskell-io/myproduct/issues" },
+#     { text = "Discussions", url = "https://github.com/raskell-io/myproduct/discussions" }
+#   ]}
+# ]

package/examples/hello-agent.rs

@@ -0,0 +1,55 @@
+use anyhow::Result;
+use enact_core::graph::{Graph, Node};
+use enact_core::kernel::ExecutionKernel;
+use enact_providers::azure::AzureOpenAiProvider;
+use enact_runner::loop_driver::AgentRunner;
+use enact_runner::config::RunnerConfig;
+use std::sync::Arc;
+use dotenv::dotenv;
+
+#[tokio::main]
+async fn main() -> Result<()> {
+    // 1. Load environment variables from .env
+    dotenv().ok();
+    
+    // 2. Setup the LLM Provider (Azure used in this example)
+    // Values are pulled from environment variables defined in .env
+    let config = enact_config::Config::load()?;
+    let provider = AzureOpenAiProvider::from_config(&config)?;
+    let provider = Arc::new(provider);
+
+    // 3. Define a simple agent graph
+    let mut graph = Graph::new("hello-agent");
+    
+    // Add a basic node that uses the provider
+    let node = Node::new("chat")
+        .with_instruction("You are a helpful assistant. Keep your responses concise.")
+        .with_llm(provider);
+        
+    graph.add_node(node);
+
+    // 4. Initialize the Kernel and Runner
+    let kernel = ExecutionKernel::new(graph);
+    let runner_config = RunnerConfig::default();
+    
+    // Use the default runner (handles event emission, cancellation tokens, etc.)
+    let mut runner = AgentRunner::default_new()
+        .with_config(runner_config);
+
+    // 5. Run the agent loop
+    println!("Starting Agent Loop...");
+    let input = "Hello! Who are you and what can you do?";
+    
+    // In a real scenario, you'd pass a Callable (like the provider) to run
+    // For this example, we demonstrate the structural components.
+    // Note: This requires valid API configuration to actually execute a network call.
+    println!("User: {}", input);
+    
+    // let outcome = runner.run(&*provider, input).await?;
+    // println!("Agent: {}", outcome.output().unwrap_or("No response"));
+
+    println!("\n[Note] This example shows the bare-minimum setup.");
+    println!("To run fully, ensure your .env file is populated with valid Azure OpenAI credentials.");
+
+    Ok(())
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "enya-agent",
+  "version": "0.1.0",
+  "description": "Enact CLI - Graph-Native AI agents",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adl-tan-theta/enactai.git"
+  },
+  "homepage": "https://www.enactai.now",
+  "keywords": [
+    "ai",
+    "agent",
+    "cli",
+    "llm",
+    "graph-native",
+    "gpt",
+    "claude"
+  ],
+  "license": "MIT",
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=14"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}

package/proto/config.proto

@@ -0,0 +1,60 @@
+syntax = "proto3";
+
+package enact.config.v1;
+
+// For Rust: use tonic-build to generate from this proto
+// option go_package = "github.com/enact/proto/gen/enact/config/v1";
+
+// Config service for syncing configuration and retrieving secrets
+service ConfigService {
+  // GetSecret retrieves a secret value from keychain
+  rpc GetSecret(GetSecretRequest) returns (GetSecretResponse);
+  
+  // SetSecret stores a secret value in keychain
+  rpc SetSecret(SetSecretRequest) returns (SetSecretResponse);
+  
+  // GetConfig retrieves the current configuration
+  rpc GetConfig(GetConfigRequest) returns (GetConfigResponse);
+  
+  // SyncConfig syncs configuration between client and server
+  rpc SyncConfig(SyncConfigRequest) returns (SyncConfigResponse);
+}
+
+message GetSecretRequest {
+  string key = 1;
+}
+
+message GetSecretResponse {
+  string value = 1;
+  bool found = 2;
+}
+
+message SetSecretRequest {
+  string key = 1;
+  string value = 2;
+}
+
+message SetSecretResponse {
+  bool success = 1;
+}
+
+message GetConfigRequest {
+  // Empty for now, could add filters later
+}
+
+message GetConfigResponse {
+  bytes config_json = 1; // JSON-encoded config
+}
+
+message SyncConfigRequest {
+  string tenant_id = 1;
+  bytes config_json = 2; // JSON-encoded config
+  int64 timestamp = 3;
+}
+
+message SyncConfigResponse {
+  bytes config_json = 1; // JSON-encoded config
+  int64 timestamp = 2;
+  repeated string conflicts = 3;
+}
+

package/proto/runtime.proto

@@ -0,0 +1,215 @@
+syntax = "proto3";
+
+package enact.runtime.v1;
+
+// For Rust: use tonic-build to generate from this proto
+// option go_package = "github.com/enact/proto/gen/enact/runtime/v1";
+
+// Runtime service - main entry point for agent execution
+service RuntimeService {
+  // Run an agent with input
+  rpc RunAgent(RunAgentRequest) returns (RunAgentResponse);
+
+  // Run an agent with streaming output
+  rpc RunAgentStream(RunAgentRequest) returns (stream StreamEvent);
+
+  // Resume from checkpoint
+  rpc ResumeFromCheckpoint(ResumeRequest) returns (stream StreamEvent);
+
+  // Get agent info
+  rpc GetAgentInfo(GetAgentInfoRequest) returns (AgentInfo);
+
+  // List available agents
+  rpc ListAgents(ListAgentsRequest) returns (ListAgentsResponse);
+
+  // Health check
+  rpc HealthCheck(HealthCheckRequest) returns (HealthCheckResponse);
+
+  // ============================================================
+  // Control signals - for abort, pause, resume
+  // ============================================================
+
+  // Cancel a running execution
+  rpc Cancel(CancelRequest) returns (CancelResponse);
+
+  // Pause a running execution
+  rpc Pause(PauseRequest) returns (PauseResponse);
+
+  // Resume a paused execution
+  rpc Resume(ResumeExecutionRequest) returns (stream StreamEvent);
+
+  // Approve a pending plan
+  rpc ApprovePlan(ApprovePlanRequest) returns (ApprovePlanResponse);
+
+  // Reject a pending plan
+  rpc RejectPlan(RejectPlanRequest) returns (RejectPlanResponse);
+}
+
+// Run agent request
+message RunAgentRequest {
+  string agent_name = 1;
+  string input = 2;
+  map<string, string> context = 3;
+  optional string checkpoint_id = 4;
+}
+
+// Run agent response
+message RunAgentResponse {
+  string run_id = 1;
+  string output = 2;
+  int32 iterations = 3;
+  repeated ToolCallRecord tool_calls = 4;
+}
+
+// Tool call record
+message ToolCallRecord {
+  string tool_name = 1;
+  string arguments = 2;  // JSON string
+  string result = 3;     // JSON string
+}
+
+// Stream event
+message StreamEvent {
+  string run_id = 1;
+  oneof event {
+    RunStarted run_started = 2;
+    NodeStarted node_started = 3;
+    ContentDelta content_delta = 4;
+    ToolCallStarted tool_call_started = 5;
+    ToolCallCompleted tool_call_completed = 6;
+    NodeCompleted node_completed = 7;
+    RunCompleted run_completed = 8;
+    ErrorEvent error = 9;
+  }
+}
+
+message RunStarted {}
+
+message NodeStarted {
+  string node_id = 1;
+  string node_name = 2;
+}
+
+message ContentDelta {
+  string content = 1;
+}
+
+message ToolCallStarted {
+  string tool_name = 1;
+  string arguments = 2;  // JSON
+}
+
+message ToolCallCompleted {
+  string tool_name = 1;
+  string result = 2;  // JSON
+}
+
+message NodeCompleted {
+  string node_id = 1;
+  string output = 2;
+}
+
+message RunCompleted {
+  string final_output = 1;
+}
+
+message ErrorEvent {
+  string message = 1;
+  string code = 2;
+}
+
+// Resume from checkpoint request
+message ResumeRequest {
+  string checkpoint_id = 1;
+  optional string new_input = 2;
+}
+
+// Agent info
+message AgentInfo {
+  string name = 1;
+  string description = 2;
+  repeated ToolInfo tools = 3;
+}
+
+message ToolInfo {
+  string name = 1;
+  string description = 2;
+  string parameters_schema = 3;  // JSON schema
+}
+
+message GetAgentInfoRequest {
+  string agent_name = 1;
+}
+
+message ListAgentsRequest {}
+
+message ListAgentsResponse {
+  repeated AgentInfo agents = 1;
+}
+
+message HealthCheckRequest {}
+
+message HealthCheckResponse {
+  bool healthy = 1;
+  string version = 2;
+}
+
+// ============================================================
+// Control signal messages
+// ============================================================
+
+// Cancel request
+message CancelRequest {
+  string run_id = 1;
+  optional string reason = 2;
+}
+
+// Cancel response
+message CancelResponse {
+  bool success = 1;
+  string run_id = 2;
+  optional string message = 3;
+}
+
+// Pause request
+message PauseRequest {
+  string run_id = 1;
+}
+
+// Pause response
+message PauseResponse {
+  bool success = 1;
+  string run_id = 2;
+  optional string checkpoint_id = 3;  // Checkpoint created for resume
+}
+
+// Resume execution request (different from ResumeFromCheckpoint)
+message ResumeExecutionRequest {
+  string run_id = 1;
+  optional string checkpoint_id = 2;
+}
+
+// Approve plan request
+message ApprovePlanRequest {
+  string run_id = 1;
+  reserved 2;
+}
+
+// Approve plan response
+message ApprovePlanResponse {
+  bool success = 1;
+  string run_id = 2;
+}
+
+// Reject plan request
+message RejectPlanRequest {
+  string run_id = 1;
+  optional string reason = 3;
+  reserved 2;
+}
+
+// Reject plan response
+message RejectPlanResponse {
+  bool success = 1;
+  string run_id = 2;
+}