igniter 0.5.0 → 0.5.1

data/packages/igniter-core/lib/igniter/core/runtime/stream_result.rb

@@ -0,0 +1,171 @@
+# frozen_string_literal: true
+
+module Igniter
+  module Runtime
+    class StreamResult < DeferredResult
+      def self.build(token: nil, payload: {}, source_node: nil, waiting_on: nil)
+        new(
+          token: token || SecureRandom.uuid,
+          payload: payload,
+          source_node: source_node,
+          waiting_on: waiting_on
+        )
+      end
+
+      def session
+        data = agent_session_data
+        return nil unless data
+
+        Runtime::AgentSession.from_h(data)
+      end
+
+      def agent_result_contract
+        Runtime::AgentResultContract.from_result(self, kind: :stream)
+      end
+
+      def phase
+        session&.phase || :streaming
+      end
+
+      def chunks
+        session&.chunks || []
+      end
+
+      def events
+        session&.events || []
+      end
+
+      def last_event
+        events.last
+      end
+
+      def status_events
+        events.select { |event| event[:type] == :status }
+      end
+
+      def statuses
+        status_events.filter_map { |event| event[:status] }
+      end
+
+      def tool_calls
+        events.select { |event| event[:type] == :tool_call }
+      end
+
+      def tool_results
+        events.select { |event| event[:type] == :tool_result }
+      end
+
+      def artifacts
+        events.select { |event| event[:type] == :artifact }
+      end
+
+      def final_event
+        events.reverse.find { |event| event[:type] == :final }
+      end
+
+      def tool_interactions
+        session&.tool_interactions || []
+      end
+
+      def pending_tool_interactions
+        session&.pending_tool_interactions || []
+      end
+
+      def completed_tool_interactions
+        session&.completed_tool_interactions || []
+      end
+
+      def orphan_tool_interactions
+        session&.orphan_tool_interactions || []
+      end
+
+      def all_tool_calls_resolved?
+        session ? session.all_tool_calls_resolved? : true
+      end
+
+      def tool_loop_consistent?
+        session ? session.tool_loop_consistent? : true
+      end
+
+      def tool_loop_complete?
+        session ? session.tool_loop_complete? : true
+      end
+
+      def tool_loop_status
+        session&.tool_loop_status || :idle
+      end
+
+      def tool_loop_summary
+        session&.tool_loop_summary || {
+          status: :idle,
+          total: 0,
+          pending: 0,
+          completed: 0,
+          orphaned: 0,
+          resolved: true,
+          consistent: true,
+          complete: true,
+          open_keys: [],
+          orphan_keys: []
+        }
+      end
+
+      def tool_runtime
+        session&.tool_runtime || {
+          status: :idle,
+          policy: nil,
+          finalizer: nil,
+          waiting_on: waiting_on,
+          interaction_count: 0,
+          pending_count: 0,
+          completed_count: 0,
+          orphaned_count: 0,
+          resolved: true,
+          consistent: true,
+          complete: true,
+          open_keys: [],
+          orphan_keys: [],
+          open_tools: [],
+          completed_tools: [],
+          orphan_tools: []
+        }.freeze
+      end
+
+      def last_chunk
+        chunks.last
+      end
+
+      def complete?
+        phase == :completed
+      end
+
+      def streaming?
+        !complete?
+      end
+
+      def to_h
+        super.merge(
+          type: :stream,
+          agent_result_contract: agent_result_contract&.to_h,
+          phase: phase,
+          events: events,
+          event_count: events.size,
+          status_count: status_events.size,
+          tool_call_count: tool_calls.size,
+          tool_result_count: tool_results.size,
+          tool_interaction_count: tool_interactions.size,
+          pending_tool_interaction_count: pending_tool_interactions.size,
+          completed_tool_interaction_count: completed_tool_interactions.size,
+          orphan_tool_interaction_count: orphan_tool_interactions.size,
+          tool_loop_status: tool_loop_status,
+          tool_loop_complete: tool_loop_complete?,
+          tool_loop_summary: tool_loop_summary,
+          tool_runtime: tool_runtime,
+          artifact_count: artifacts.size,
+          chunks: chunks,
+          chunk_count: chunks.size
+        )
+      end
+    end
+  end
+end

data/{lib/igniter → packages/igniter-core/lib/igniter/core}/runtime.rb

@@ -3,6 +3,13 @@
 require_relative "runtime/node_state"
 require_relative "runtime/cache"
 require_relative "runtime/deferred_result"
+require_relative "runtime/stream_result"
+require_relative "runtime/agent_session"
+require_relative "runtime/agent_result_contract"
+require_relative "runtime/agent_session_query"
+require_relative "runtime/orchestration_runtime_state"
+require_relative "runtime/orchestration_transition_query"
+require_relative "runtime/orchestration_overview"
 require_relative "runtime/collection_result"
 require_relative "runtime/input_validator"
 require_relative "runtime/planner"
@@ -14,7 +21,14 @@ require_relative "runtime/stores/active_record_store"
 require_relative "runtime/stores/file_store"
 require_relative "runtime/stores/memory_store"
 require_relative "runtime/stores/redis_store"
+require_relative "runtime/stores/sqlite_store"
 require_relative "runtime/runner_factory"
+require_relative "runtime/remote_adapter"
+require_relative "runtime/agent_adapter"
+require_relative "runtime/agent_route"
+require_relative "runtime/agent_route_resolver"
+require_relative "runtime/agent_transport"
+require_relative "runtime/proxy_agent_adapter"
 require_relative "runtime/resolver"
 require_relative "runtime/invalidator"
 require_relative "runtime/result"
@@ -22,5 +36,6 @@ require_relative "runtime/execution"
 
 module Igniter
   module Runtime
+    ConfigurationError = Class.new(Igniter::Error)
   end
 end

data/{lib/igniter → packages/igniter-core/lib/igniter/core}/temporal.rb

@@ -13,7 +13,7 @@ module Igniter
   #
   # == Usage
   #
-  #   require "igniter/temporal"
+  #   require "igniter/core/temporal"
   #
   #   class TaxRateContract < Igniter::Contract
   #     include Igniter::Temporal

data/{lib/igniter → packages/igniter-core/lib/igniter/core}/tool/discoverable.rb

@@ -2,7 +2,7 @@
 
 module Igniter
   class Tool
-    # Shared discovery DSL included by both +Igniter::Tool+ and +Igniter::Skill+.
+    # Shared discovery DSL included by both +Igniter::Tool+ and +Igniter::AI::Skill+.
     #
     # Provides: +description+, +param+, +requires_capability+, +tool_name+,
     # +to_schema+, and the instance-side +call_with_capability_check!+.
@@ -70,7 +70,7 @@ module Igniter
         # Snake-case name derived from the class name (last namespace component).
         #
         #   class SearchWebTool < Igniter::Tool  →  "search_web_tool"
-        #   class ResearchSkill < Igniter::Skill →  "research_skill"
+        #   class ResearchSkill < Igniter::AI::Skill →  "research_skill"
         def tool_name
           n = name.to_s.split("::").last
           return "anonymous" if n.nil? || n.empty?
@@ -129,7 +129,7 @@ module Igniter
       # ── Instance — capability-guarded call ──────────────────────────────────
 
       # Verify the agent has all required capabilities, then invoke +#call+.
-      # Called by +LLM::Executor+ during the tool-use loop for every tool/skill invocation.
+      # Called by +AI::Executor+ during the tool-use loop for every tool/skill invocation.
       #
       # @param allowed_capabilities [Array<Symbol>] capabilities the calling agent has
       # @raise [Igniter::Tool::CapabilityError] if a required capability is missing

data/{lib/igniter → packages/igniter-core/lib/igniter/core}/tool.rb

@@ -1,11 +1,15 @@
 # frozen_string_literal: true
 
+require_relative "errors"
+require_relative "runtime/deferred_result"
+require_relative "executor"
+
 module Igniter
   # Base class for AI-callable tools.
   #
   # Extends +Igniter::Executor+ with declarative metadata for LLM function-calling
   # (Anthropic, OpenAI) and capability-based access guards.
-  # Shares the discovery DSL with +Igniter::Skill+ via +Tool::Discoverable+.
+  # Shares the discovery DSL with +Igniter::AI::Skill+ via +Tool::Discoverable+.
   #
   # == Defining a tool
   #
@@ -34,7 +38,7 @@ module Igniter
   # Tool inherits +Igniter::Executor+ — usable as a compute node in any Contract graph.
   class Tool < Executor
     # Raised when a tool or skill requires a capability the calling agent does not have.
-    # Also aliased as +Igniter::Skill::CapabilityError+.
+    # Also aliased as +Igniter::AI::Skill::CapabilityError+.
     class CapabilityError < Igniter::Error; end
 
     require_relative "tool/discoverable"

data/{lib/igniter → packages/igniter-core/lib/igniter/core}/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Igniter
-  VERSION = "0.5.0"
+  VERSION = "0.5.1"
 end

data/packages/igniter-core/lib/igniter/core.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative "core/version"
+require_relative "core/errors"
+require_relative "core/type_system"
+require_relative "core/executor"
+require_relative "core/executor_registry"
+require_relative "core/effect"
+require_relative "core/effect_registry"
+require_relative "core/model"
+require_relative "core/compiler"
+require_relative "core/events"
+require_relative "core/runtime"
+require_relative "core/dto"
+require_relative "core/dsl"
+require_relative "core/extensions"
+require_relative "core/diagnostics"
+require_relative "core/contract"
+require_relative "core/stream_loop"
+require_relative "core/tool"
+
+module Igniter
+end

data/packages/igniter-core/lib/igniter-core.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "igniter/core"

data/packages/igniter-extensions/README.md

@@ -0,0 +1,21 @@
+# igniter-extensions
+
+Public extension entrypoints for Igniter.
+
+This package owns the `igniter/extensions/*` activation surface, including:
+
+- `require "igniter/extensions/dataflow"`
+- `require "igniter/extensions/saga"`
+- `require "igniter/extensions/provenance"`
+- `require "igniter/extensions/differential"`
+- `require "igniter/extensions/incremental"`
+
+It also provides the package facade:
+
+- `require "igniter-extensions"`
+
+Docs:
+
+- [Guide](../../docs/guide/README.md)
+- [Core guide](../../docs/guide/core.md)
+- [Dev](../../docs/dev/README.md)

data/packages/igniter-extensions/lib/igniter/extensions/auditing.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "igniter/core/extensions/auditing"

data/{lib → packages/igniter-extensions/lib}/igniter/extensions/capabilities.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "igniter/capabilities"
+require "igniter/core/capabilities"
 
 # Patches CompiledGraph with capability introspection methods.
 # The Resolver integration is handled via guard-claused hooks in resolver.rb.

data/{lib → packages/igniter-extensions/lib}/igniter/extensions/content_addressing.rb

@@ -2,4 +2,4 @@
 
 # Loading this file activates content-addressed caching for pure executors.
 # The Resolver picks up content addressing via a guard clause when this constant is defined.
-require "igniter/content_addressing"
+require "igniter/core/content_addressing"

data/{lib → packages/igniter-extensions/lib}/igniter/extensions/dataflow.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "igniter"
-require "igniter/dataflow"
+require "igniter/core/dataflow"
 
 # Activates incremental dataflow support for all contracts.
 #

data/{lib → packages/igniter-extensions/lib}/igniter/extensions/differential.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "igniter"
-require "igniter/differential"
+require "igniter/core/differential"
 
 module Igniter
   module Extensions

data/{lib → packages/igniter-extensions/lib}/igniter/extensions/execution_report.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "igniter"
-require "igniter/execution_report"
+require "igniter/core/execution_report"
 
 module Igniter
   module Extensions

data/{lib → packages/igniter-extensions/lib}/igniter/extensions/incremental.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "igniter"
-require "igniter/incremental"
+require "igniter/core/incremental"
 
 module Igniter
   module Extensions

data/packages/igniter-extensions/lib/igniter/extensions/introspection.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "igniter/core/extensions/introspection"

data/packages/igniter-extensions/lib/igniter/extensions/invariants.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "igniter/core/extensions/invariants"

data/{lib → packages/igniter-extensions/lib}/igniter/extensions/provenance.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative "../provenance"
+require "igniter/core/provenance"
 
 module Igniter
   module Extensions

data/packages/igniter-extensions/lib/igniter/extensions/reactive.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "igniter/core/extensions/reactive"

data/{lib → packages/igniter-extensions/lib}/igniter/extensions/saga.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "igniter"
-require "igniter/saga"
+require "igniter/core/saga"
 
 module Igniter
   module Extensions

data/packages/igniter-extensions/lib/igniter/extensions.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "igniter"
+
+module Igniter
+  module Extensions
+  end
+end

data/packages/igniter-extensions/lib/igniter-extensions.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "igniter/extensions"

data/packages/igniter-frontend/README.md

@@ -0,0 +1,224 @@
+# igniter-frontend
+
+`igniter-frontend` is a local monorepo gem for developer-facing app web surfaces on top of Igniter.
+
+It now ships with `arbre` as a standard dependency. The intent is simple:
+
+- `Igniter Frontend` should feel as simple and powerful for Ruby-authored app UI
+  as `ActiveAdmin` feels for admin UI
+- Arbre is no longer a side adapter you add by hand later
+- Arbre is part of the default developer-authoring lane for `igniter-frontend`
+
+It groups high-level concerns that belong together in app development:
+
+- route authoring
+- handler/controller lifecycle
+- request/response helpers
+- mounted-app aware contexts
+- Arbre page rendering
+- semantic Arbre components
+- optional JavaScript runtime and app-owned entrypoints
+
+Schema-driven agent rendering intentionally lives outside this package. Use a
+separate package for that lane so the human-first app surface stays simple.
+
+The goal is not to re-create Rails.
+The goal is to give Igniter apps a small, coherent, HTML-first framework for
+building dashboards, chats, operator tools, decentralized personal apps, and
+other rich mounted web surfaces.
+
+The frontend direction is now explicitly:
+
+- Arbre for developer-authored page composition
+- Tailwind surfaces for shared UI language
+- stronger UX/UI semantics on top of that Arbre lane over time
+
+That “stronger semantics” line now includes richer Arbre primitives such as:
+
+- `badge` with inferred status tone and compact sizing
+- `card#line` with `as: :badge` / `as: :code`
+- placeholder-aware schema rows and nested `subcard` composition
+- `table_with` for logs, events, history, and other collection-heavy operator views
+- `viz` for raw hashes, arrays, objects, and runtime payload inspection
+- `filters` for mounted-safe search and narrowing lanes above tables and feeds
+- `pagination` for mounted-safe browsing lanes across notes, history, logs, and other long collections
+- `sidebar_shell` for app-level operator/admin navigation and stable content chrome
+- `breadcrumbs` for compact in-app location trails above operator/admin content
+- semantic value primitives such as `boolean`, `datetime`, `indicator`, `number`, and `percentage`
+- state primitives such as `empty_state` and `loading_state`
+- `shell_columns` for main/aside dashboard composition inside an app shell
+
+Authoring guide:
+
+- [Frontend Authoring](../../docs/guide/frontend-authoring.md)
+- [Frontend Components](../../docs/guide/frontend-components.md)
+- [Guide](../../docs/guide/README.md)
+- [Dev](../../docs/dev/README.md)
+
+## First-cut API
+
+```ruby
+require "igniter/app"
+require "igniter-frontend"
+
+class WebApp < Igniter::App
+  include Igniter::Frontend::App
+
+  root_dir __dir__
+  config_file "app.yml"
+  frontend_assets path: "frontend"
+
+  get "/", to: Web::Handlers::HomeHandler
+
+  scope "/notes" do
+    post "/", to: Web::Handlers::NotesCreateHandler
+  end
+end
+```
+
+```ruby
+module Web
+  module Handlers
+    class HomeHandler < Igniter::Frontend::Handler
+      def call
+        render Views::HomePage,
+               context: build_context(Contexts::HomeContext, title: "Home")
+      end
+    end
+  end
+end
+```
+
+```ruby
+module Web
+  module Views
+    class HomePage < Igniter::Frontend::ArbrePage
+      template_root __dir__
+      template "home"
+      layout "layout"
+
+      def initialize(context:)
+        @context = context
+      end
+
+      def template_locals
+        { page_context: @context }
+      end
+    end
+  end
+end
+```
+
+## Status
+
+This package now owns the human-facing web surface directly inside the monorepo:
+
+- route DSL and handler lifecycle
+- HTML builder/page abstractions
+- Arbre page pipeline
+- Tailwind shell and semantic UI components
+- optional frontend JavaScript runtime with app-owned assets under `frontend/`
+
+It is no longer just a facade over `lib/igniter/plugins/view`.
+
+## Optional JavaScript
+
+Use `frontend_assets` when the app wants a small built-in runtime plus its own
+JavaScript entrypoints.
+
+```ruby
+class DashboardApp < Igniter::App
+  include Igniter::Frontend::App
+
+  root_dir __dir__
+  frontend_assets path: "frontend"
+end
+```
+
+App structure:
+
+```text
+apps/dashboard/
+  app.rb
+  frontend/
+    application.js
+    controllers/
+```
+
+Layout usage:
+
+```ruby
+body do
+  render_template_content
+  render_frontend_javascript "application"
+end
+```
+
+This serves:
+
+- built-in runtime at `/__frontend/runtime.js`
+- app entrypoints like `/__frontend/assets/application.js`
+
+Both URLs stay mounted-app aware when rendered through `ArbrePage` helpers.
+
+Built-in controllers currently include:
+
+- `tabs` for semantic tab panels
+- `stream` for `EventSource` lifecycle, JSON parsing, and app-level hooks
+
+Example stream wiring:
+
+```ruby
+main(
+  "data-ig-controller": "stream",
+  "data-ig-stream-url-value": page_context.route("/api/overview/stream"),
+  "data-ig-stream-events-value": "[\"overview\",\"activity\"]",
+  "data-ig-stream-hook-value": "homeLabOverviewStream"
+) do
+  render_template_content
+end
+```
+
+```js
+window.homeLabOverviewStream = {
+  overview({ controller, payload }) {
+    controller.setTextTarget("generatedAt", payload.generated_at);
+  }
+};
+```
+
+For repeated updates, prefer marking DOM zones with `data-ig-stream-target` and
+using the small helpers exposed by `stream`:
+
+- `setTextTarget(name, value)`
+- `setHtmlTarget(name, html)`
+- `setJsonTarget(name, payload)`
+- `prependHtmlTarget(name, html, { limit: ... })`
+
+In Arbre pages and components, prefer the helper:
+
+```ruby
+span current_value, **stream_target(:generated_at, id: "generated-at")
+```
+
+That keeps `data-ig-*` details out of app templates.
+
+The same applies to controller values:
+
+```ruby
+main(
+  **stream_scope,
+  **stream_value(:url, page_context.route("/api/overview/stream")),
+  **stream_value(:events, %w[overview activity]),
+  **stream_value(:hook, "homeLabOverviewStream")
+) do
+  render_template_content
+end
+```
+
+Use `controller_value(:tabs, :active_id, "routing")` when you need the generic
+form outside the `stream` lane.
+
+For the controller name itself, prefer `stream_scope` or the generic
+`controller_scope(:stream, :operator_panel)` over raw `data-ig-controller`
+strings.