poetry-agent 0.0.2

data/lib/poetry/agent/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Agent
+    # The gem version (lockstep with the poetry family).
+    VERSION = "0.0.2"
+  end
+end

data/lib/poetry/agent/webmcp/origin_trial.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Agent
+    module WebMCP
+      # Rack middleware serving the `Origin-Trial` response header on HTML
+      # responses, one token per browser trial (Chrome and Edge run
+      # separate trials and issue separate tokens). Tokens come from
+      # {Poetry::Agent::Config#origin_trial_tokens}; with none configured
+      # the middleware is a pass-through, so it is always safe to mount.
+      #
+      # Local development needs no token: enable the API through the
+      # browser flag instead.
+      #
+      # @example config/application.rb
+      #   config.middleware.use Poetry::Agent::WebMCP::OriginTrial
+      class OriginTrial
+        # The response header the browsers read (Rack 3 lowercases names).
+        HEADER = "origin-trial"
+
+        def initialize(app, tokens: nil)
+          @app = app
+          @tokens = tokens
+        end
+
+        # The Rack entry point: appends the tokens to HTML responses.
+        #
+        # @param env [Hash] the Rack environment
+        # @return [Array(Integer, Hash, Object)] the downstream response
+        def call(env)
+          status, headers, body = @app.call(env)
+          tokens = (@tokens || Poetry::Agent.config.origin_trial_tokens).compact.reject(&:empty?)
+          if tokens.any? && html?(headers)
+            existing = headers[HEADER] || headers["Origin-Trial"]
+            headers[HEADER] = [existing, *tokens].compact.join(", ")
+          end
+          [status, headers, body]
+        end
+
+        private
+
+        def html?(headers)
+          type = headers["content-type"] || headers["Content-Type"]
+          type.to_s.include?("text/html")
+        end
+      end
+    end
+  end
+end

data/lib/poetry/agent/webmcp.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative "webmcp/origin_trial"
+
+module Poetry
+  module Agent
+    # The WebMCP runtime's Ruby side. The contract itself lives in
+    # poetry-core (the `tool` declarations, their registry projection, and
+    # the per-instance `webmcp:` payload a component root carries); this
+    # module owns what only the runtime gem knows: the Stimulus controller
+    # identifiers the JS registers, the controllers manifest that lets
+    # core's attribute builder validate them, and origin-trial delivery.
+    #
+    # Nothing here exposes a tool by itself - a rendered instance opts in
+    # (`webmcp: "country"` on the helper call), and the registrar
+    # controller registers that instance's declared tools with
+    # `document.modelContext` on connect, aborting them on disconnect.
+    module WebMCP
+      # The registrar controller: reads a root's payload and registers
+      # its tools, dispatching each to the component's own controller.
+      CONTROLLER = "poetry--agent--webmcp"
+      # The declarative-form controller: answers an agent-invoked submit
+      # with the form's outcome through `SubmitEvent.respondWith`.
+      FORM_CONTROLLER = "poetry--agent--webmcp-form"
+
+      # The committed controllers manifest (the JS surface of the two
+      # controllers), merged into poetry-core's catalog by the engine so
+      # use_stimulus / the Builder validate poetry--agent--* names exactly
+      # like core's own.
+      #
+      # @return [Pathname]
+      def self.manifest_path
+        Poetry::Agent.root.join("config/controllers_manifest.json")
+      end
+    end
+  end
+end

data/lib/poetry/agent.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "pathname"
+require "poetry/core"
+require_relative "agent/version"
+require_relative "agent/config"
+require_relative "agent/mcp/server"
+require_relative "agent/mcp/bundled"
+require_relative "agent/mcp/http"
+require_relative "agent/webmcp"
+require_relative "agent/agui"
+require_relative "agent/a2ui"
+require_relative "agent/engine" if defined?(Rails::Engine)
+
+# The poetry namespace.
+module Poetry
+  # poetry-agent: the agent-interop gem of the poetry family - the
+  # surfaces through which agents reach the component contract, built
+  # once (the registry) and projected many ways:
+  #
+  # - {MCP::Server} - the boot-free `poetry-agent` MCP server (discover:
+  #   list_components / describe_component / check / compose / build_page
+  #   / get_skill) for coding agents in editors.
+  # - {WebMCP} - the in-page runtime: rendered components' declared tools
+  #   (`tool` declarations in poetry-core) registered with the browser's
+  #   `document.modelContext` for the user's own agent (operate), plus the
+  #   declarative-form path and the origin-trial delivery.
+  # - {A2UI} - the registry projected as an A2UI catalog (the vocabulary
+  #   an agent generates declarative UI against).
+  # - {AGUI} - the Rails-side AG-UI client: an agent backend's event stream
+  #   folded into chat frames and relayed as versioned Turbo Streams,
+  #   with the component tools the browser executes advertised as the
+  #   agent's frontend tools.
+  #
+  # Both read the same committed registries; neither is a second source.
+  module Agent
+    class << self
+      # Gem root (the directory containing lib/, exe/, app/).
+      #
+      # @return [Pathname]
+      def root
+        @root ||= Pathname.new(File.expand_path("../..", __dir__))
+      end
+
+      # The gem's configuration (origin-trial tokens, registration budget).
+      #
+      # @return [Poetry::Agent::Config]
+      def config
+        Config.current
+      end
+
+      # Yields the configuration for block-style setup.
+      #
+      # @yieldparam config [Poetry::Agent::Config]
+      # @return [Poetry::Agent::Config]
+      # @example config/initializers/poetry_agent.rb
+      #   Poetry::Agent.configure do |config|
+      #     config.origin_trial_tokens = [ENV["WEBMCP_ORIGIN_TRIAL_TOKEN"]].compact
+      #   end
+      def configure
+        yield config
+        config
+      end
+    end
+  end
+end

data/lib/poetry-agent.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+# Bundler auto-requires by gem name; the namespace lives in poetry/agent.
+require_relative "poetry/agent"

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification
+name: poetry-agent
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Matt Solt
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: poetry-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+description: 'The agent-interop gem of Poetry, the AI-native UI component library.
+  Five surfaces: the boot-free poetry-agent MCP server (the component contract over
+  Model Context Protocol, with runtime skill delivery); the WebMCP runtime that registers
+  rendered components'' declared tools with in-browser agents (document.modelContext)
+  behind safe-by-default, opt-in registration, declarative forms, and an origin-trial
+  middleware; the AG-UI relay, a Rails client of the Agent-User Interaction protocol
+  that runs an agent and relays its events as Turbo Streams, with frontend tools and
+  interrupts; the A2UI catalog projected from the component registry; and the A2UI
+  renderer that folds the envelope into server-rendered surfaces with forms, checks,
+  functions, and morphing updates.'
+email:
+- mattsolt@gmail.com
+executables:
+- poetry-agent
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- app/javascript/poetry/agent/a2ui_surface_controller.js
+- app/javascript/poetry/agent/adapter.js
+- app/javascript/poetry/agent/agui_client_tool_controller.js
+- app/javascript/poetry/agent/index.js
+- app/javascript/poetry/agent/stream_actions.js
+- app/javascript/poetry/agent/webmcp_controller.js
+- app/javascript/poetry/agent/webmcp_form_controller.js
+- config/controllers_manifest.json
+- config/importmap.rb
+- exe/poetry-agent
+- lib/poetry-agent.rb
+- lib/poetry/agent.rb
+- lib/poetry/agent/a2ui.rb
+- lib/poetry/agent/a2ui/catalog.rb
+- lib/poetry/agent/a2ui/catalogs/basic.rb
+- lib/poetry/agent/a2ui/catalogs/native.rb
+- lib/poetry/agent/a2ui/checks.rb
+- lib/poetry/agent/a2ui/evaluator.rb
+- lib/poetry/agent/a2ui/expression.rb
+- lib/poetry/agent/a2ui/functions.rb
+- lib/poetry/agent/a2ui/markdown.rb
+- lib/poetry/agent/a2ui/pointer.rb
+- lib/poetry/agent/a2ui/protocol.rb
+- lib/poetry/agent/a2ui/renderer.rb
+- lib/poetry/agent/a2ui/session.rb
+- lib/poetry/agent/a2ui/streams.rb
+- lib/poetry/agent/a2ui/surface.rb
+- lib/poetry/agent/agui.rb
+- lib/poetry/agent/agui/client.rb
+- lib/poetry/agent/agui/json_patch.rb
+- lib/poetry/agent/agui/relay.rb
+- lib/poetry/agent/agui/run_input.rb
+- lib/poetry/agent/agui/sse.rb
+- lib/poetry/agent/agui/transcript.rb
+- lib/poetry/agent/agui/turbo_stream.rb
+- lib/poetry/agent/config.rb
+- lib/poetry/agent/engine.rb
+- lib/poetry/agent/mcp/bundled.rb
+- lib/poetry/agent/mcp/http.rb
+- lib/poetry/agent/mcp/server.rb
+- lib/poetry/agent/version.rb
+- lib/poetry/agent/webmcp.rb
+- lib/poetry/agent/webmcp/origin_trial.rb
+homepage: https://poetryui.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://poetryui.com
+  documentation_uri: https://poetryui.com/docs
+  source_code_uri: https://github.com/roboruby/poetry-agent
+  changelog_uri: https://github.com/roboruby/poetry-agent/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/roboruby/poetry-agent/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: 'Poetry''s agent surfaces: MCP server, WebMCP runtime, AG-UI relay, and A2UI
+  catalog and renderer.'
+test_files: []