ask-decisions 0.1.1

data/lib/ask-decisions.rb

@@ -0,0 +1,165 @@
+# frozen_string_literal: true
+
+require "ask"  # ask-core: Ask::Decision, Ask::DecisionResult, Ask::DecisionProvider
+require "json"
+require "net/http"
+require "uri"
+
+require_relative "ask/decisions/version"
+require_relative "ask/decisions/typesafe"
+require_relative "ask/decisions/batcher"
+require_relative "ask/decisions/cache"
+require_relative "ask/decisions/static"
+require_relative "ask/decisions/lint"
+require_relative "ask/decisions/gate"
+require_relative "ask/decisions/output_judge"
+require_relative "ask/decisions/reader"
+require_relative "ask/decisions/triage"
+require_relative "ask/decisions/tool_router"
+require_relative "ask/decisions/argument_resolver"
+require_relative "ask/decisions/decision_state"
+require_relative "ask/decisions/failure_classifier"
+require_relative "ask/decisions/loop_detector"
+require_relative "ask/decisions/confidence_policy"
+require_relative "ask/decisions/quality_judge"
+require_relative "ask/decisions/reflection_judge"
+require_relative "ask/decisions/tool_repairer"
+require_relative "ask/decisions/reranker"
+require_relative "ask/decisions/structured_state_loop"
+require_relative "ask/decisions/calibration_report"
+require_relative "ask/decisions/calibration_harness"
+
+# The Decide tool requires ask-tools (Ask::Tool base class). Load conditionally
+# so the core gem works without a tools dependency.
+begin
+  require "ask-tools"
+  require_relative "ask/tools/decide"
+  require_relative "ask/decisions/mcp_helper"
+rescue LoadError
+  # ask-tools not loaded — Ask::Tools::Decide unavailable
+end
+
+# Load agent adapter when ask-agent is available.
+begin
+  require "ask/agent"
+  require_relative "ask/decisions/agent_adapter"
+rescue LoadError
+  # ask-agent not loaded — AgentAdapter unavailable
+end
+
+# Register built-in providers.
+Ask::DecisionProvider.register(:typesafe, Ask::Decisions::Typesafe)
+Ask::DecisionProvider.register(:static,   Ask::Decisions::Static)
+
+module Ask
+  # Global convenience for making decisions.
+  #
+  #   Ask.decide(state: "...", decisions: { "route" => Ask::Decision::Choice.new(...) })
+  #
+  # The provider is resolved from +Ask::Decisions.configuration.default_provider+
+  # unless overridden per-call.
+  def self.decide(state:, decisions:, provider: nil, model: nil, &block)
+    Ask::Decisions.decide(state: state, decisions: decisions, provider: provider, model: model, &block)
+  end
+end
+
+module Ask
+  module Decisions
+    class << self
+      # Configuration block.
+      #
+      #   Ask::Decisions.configure do |c|
+      #     c.default_provider = :typesafe
+      #     c.api_key = ENV["TYPESAFE_API_KEY"]
+      #   end
+      def configure
+        yield configuration
+        configuration
+      end
+
+      def configuration
+        @configuration ||= Configuration.new
+      end
+
+      def reset_configuration!
+        @configuration = Configuration.new
+      end
+
+      # Make a decision call using the configured provider.
+      #
+      #   Ask::Decisions.decide(
+      #     state: { ticket: "..." },
+      #     decisions: { "route" => Ask::Decision::Choice.new(instructions: "...", criteria: {...}) }
+      #   )
+      #
+      def decide(state:, decisions:, provider: nil, model: nil)
+        provider_name = provider || configuration.default_provider
+        resolved = resolve_provider(provider_name)
+
+        # If a block is given, yield a Batcher so the caller can batch questions.
+        if block_given?
+          batcher = Batcher.new(resolved, state: state, model: model || configuration.default_model)
+          yield batcher
+          return batcher.execute
+        end
+
+        resolved.evaluate(
+          state: state,
+          decisions: decisions,
+          model: model || configuration.default_model
+        )
+      end
+
+      # Shorthand for batched decisions. Yields a Batcher.
+      #
+      #   result = Ask::Decisions.batch(state: "...") do |b|
+      #     b.ask("route", Ask::Decision::Choice.new(...))
+      #     b.ask("urgent", Ask::Decision::Noul.new(...))
+      #   end
+      def batch(state:, provider: nil, model: nil, &block)
+        decide(state: state, decisions: {}, provider: provider, model: model, &block)
+      end
+
+      # Resolve a provider by name, raising on unknown.
+      def resolve_provider(name)
+        klass = Ask::DecisionProvider.resolve(name)
+
+        if configuration.provider_options.any?
+          klass.new(**configuration.provider_options)
+        else
+          klass.new
+        end
+      end
+    end
+
+    # Global configuration for the Decisions module.
+    class Configuration
+      # @return [Symbol] the default provider name (:typesafe)
+      attr_accessor :default_provider
+
+      # @return [String, nil] the default model name ("jev-latest")
+      attr_accessor :default_model
+
+      # @return [String, nil] API key (falls back to Ask::Auth or env var)
+      attr_accessor :api_key
+
+      # @return [String, nil] base URL override (for proxies / Vercel AI Gateway)
+      attr_accessor :api_base
+
+      # @return [Hash] extra options passed to the provider constructor
+      attr_accessor :provider_options
+
+      # @return [Float, nil] default timeout in seconds
+      attr_accessor :timeout
+
+      def initialize
+        @default_provider = :typesafe
+        @default_model = "jev-latest"
+        @api_key = nil
+        @api_base = nil
+        @provider_options = {}
+        @timeout = 5.0
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,201 @@
+--- !ruby/object:Gem::Specification
+name: ask-decisions
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Kaka Ruto
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ask-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+- !ruby/object:Gem::Dependency
+  name: ask-auth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+description: Typed questions (Choice, Score, Noul) with calibrated probabilities and
+  confidence. Ships with a TypeSafe/Jev provider. Swap providers via the DecisionProvider
+  registry.
+email:
+- kaka@myrrlabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/ask-decisions.rb
+- lib/ask/decisions/agent_adapter.rb
+- lib/ask/decisions/argument_resolver.rb
+- lib/ask/decisions/batcher.rb
+- lib/ask/decisions/cache.rb
+- lib/ask/decisions/calibration_harness.rb
+- lib/ask/decisions/calibration_report.rb
+- lib/ask/decisions/confidence_policy.rb
+- lib/ask/decisions/decision_state.rb
+- lib/ask/decisions/failure_classifier.rb
+- lib/ask/decisions/gate.rb
+- lib/ask/decisions/lint.rb
+- lib/ask/decisions/loop_detector.rb
+- lib/ask/decisions/mcp_helper.rb
+- lib/ask/decisions/output_judge.rb
+- lib/ask/decisions/quality_judge.rb
+- lib/ask/decisions/reader.rb
+- lib/ask/decisions/reflection_judge.rb
+- lib/ask/decisions/reranker.rb
+- lib/ask/decisions/static.rb
+- lib/ask/decisions/structured_state_loop.rb
+- lib/ask/decisions/tool_repairer.rb
+- lib/ask/decisions/tool_router.rb
+- lib/ask/decisions/triage.rb
+- lib/ask/decisions/typesafe.rb
+- lib/ask/decisions/version.rb
+- lib/ask/tools/decide.rb
+homepage: https://github.com/ask-rb/ask-decisions
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ask-rb/ask-decisions
+  source_code_uri: https://github.com/ask-rb/ask-decisions
+  changelog_uri: https://github.com/ask-rb/ask-decisions/blob/master/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.18
+specification_version: 4
+summary: Decision primitives and providers for the ask-rb ecosystem
+test_files: []