terret-morph 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6dc795139de48f9e15f00647df387d36f94aba7592661b3a070209ac6a9847e2
+  data.tar.gz: dfa94e68912825fb939d5843dce02fe305ec04aac71afc24a5df869c74bdafb3
+SHA512:
+  metadata.gz: 1bd98fc5d45df8d52985553ad15b62c0ae01879184755f5f0af6553f160b93f640c6fc2ab4fb2a43d3b73de1f0fcac36f5150e96bdfff6349ff81de1c8f32433
+  data.tar.gz: d93c9e77f8a0bf16e511c7679875d3d939c6657c83bfe7840df30d7734ea00d2fc20fd56354ef9818f5eb4f88204a1ca51bf293ea4797e6da9733871ad2ea3de

data/lib/terret/morph/summarizer.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+
+module Terret
+  module Morph
+    # ctx[:summarizer] backed by Morph's Compact API (POST /v1/compact):
+    # extractive line-level compression, surviving lines byte-identical. Wire
+    # shape mirrors the deployed agora integration (Morph::CompactClient).
+    # Every failure declines to nil with a warn — compaction is an
+    # optimization, and the Compactor skips the boundary when declined. All
+    # knobs are read per call, so reconfigure is live by construction.
+    class Summarizer < Hames::Service
+      service_key :summarizer
+      # transport: is an injectable seam (tests pass a callable), not YAML config.
+      config_schema compression_ratio: { type: Numeric, default: 0.4,
+                                         doc: "target fraction of the original token count" },
+                    api_key:           { type: String,
+                                         doc: "Morph key; falls back to ENV MORPH_API_KEY when unset" },
+                    api_base:          { type: String, default: "https://api.morphllm.com/v1",
+                                         doc: "Morph Compact API base URL" },
+                    timeout:           { type: Numeric, default: 30.0,
+                                         doc: "seconds a compaction request may run" }
+
+      DEFAULT_BASE    = "https://api.morphllm.com/v1"
+      DEFAULT_TIMEOUT = 30.0
+      DEFAULT_RATIO   = 0.4
+
+      def start(_ctx); end
+
+      def reconfigure(_config); end # knobs are read per call
+
+      def summarize(history)
+        key = api_key
+        return decline("MORPH_API_KEY not configured") if key.nil? || key.empty?
+
+        body = JSON.generate({ input: render(history),
+                               compression_ratio: config[:compression_ratio] || DEFAULT_RATIO,
+                               preserve_recent: 0 })
+        status, response = transport.call("#{api_base}/compact",
+                                          { "Authorization" => "Bearer #{key}",
+                                            "Content-Type" => "application/json" },
+                                          body)
+        return decline("HTTP #{status}") unless (200..299).cover?(status)
+
+        parsed = JSON.parse(response.to_s)
+        return decline("unexpected response shape: #{parsed.class}") unless parsed.is_a?(Hash)
+
+        output = parsed["output"]
+        return decline("non-string output: #{output.class}") unless output.is_a?(String)
+
+        output.empty? ? decline("empty output") : output
+      rescue JSON::ParserError => e
+        decline("invalid JSON: #{e.message}")
+      rescue StandardError => e
+        decline("#{e.class}: #{e.message}")
+      end
+
+      private
+
+      def api_key  = config[:api_key] || ENV["MORPH_API_KEY"]
+      def api_base = config[:api_base] || ENV["MORPH_API_BASE"] || DEFAULT_BASE
+
+      # timeout=0 must not mean "no timeout" (the agora/Faraday lesson):
+      # floor anything non-positive back to the default.
+      def timeout
+        configured = (config[:timeout] || ENV["MORPH_COMPACT_TIMEOUT"]).to_f
+        configured.positive? ? configured : DEFAULT_TIMEOUT
+      end
+
+      # The transcript Morph compresses: role-tagged lines, one per message
+      # part so line-level compression can keep or drop each on its merit.
+      # Extractive compression keeps surviving lines byte-identical, so the
+      # compacted history the model sees is a strict subset of what it already
+      # saw. Tool calls and results carry their own line rather than rendering
+      # blank: a session's deploy ids, arguments, and errors live there, and a
+      # summary that dropped them would be worse than no summary at all.
+      def render(history)
+        history.flat_map { |m| m.parts.map { |part| "#{m.role}: #{line_for(part)}" } }.join("\n")
+      end
+
+      def line_for(part)
+        case part
+        when LLM::Text       then part.text
+        when LLM::ToolCall   then "[tool_call #{part.name} #{JSON.generate(part.args)}]"
+        when LLM::ToolResult then "[tool_result #{part.error || part.content}]"
+        else part.to_s
+        end
+      end
+
+      def transport
+        config[:transport] || method(:http_post)
+      end
+
+      def http_post(url, headers, body)
+        uri = URI(url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == "https"
+        http.open_timeout = timeout
+        http.read_timeout = timeout
+        http.write_timeout = timeout
+        response = http.post(uri.request_uri, body, headers)
+        [response.code.to_i, response.body]
+      end
+
+      def decline(message)
+        warn "terret-morph: compact declined: #{message}"
+        nil
+      end
+    end
+  end
+end

data/lib/terret/morph.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+begin
+  require "terret"
+rescue LoadError
+  require_relative "../../../terret-core/lib/terret" # monorepo path source
+end
+
+require_relative "morph/summarizer"

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: terret-morph
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Obie Fernandez
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: terret-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+description: 'ctx[:summarizer] backed by Morph''s Compact API: extractive line-level
+  compression (surviving lines byte-identical), wire mirrored from the deployed agora
+  integration. Zero runtime dependencies beyond stdlib net/http.'
+email:
+- obiefernandez@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/terret/morph.rb
+- lib/terret/morph/summarizer.rb
+homepage: https://terret.org
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://terret.org
+  source_code_uri: https://github.com/terret-org/terret
+  bug_tracker_uri: https://github.com/terret-org/terret/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '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: Morph-backed context compaction for Terret
+test_files: []