mistri 0.0.3 → 0.1.0

data/lib/mistri/workspace/single.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Mistri
+  module Workspace
+    # One document living wherever the host says: a column on a record, a
+    # cache key, anything readable and writable. This is the shape of an
+    # agent that edits one page:
+    #
+    #   workspace = Mistri::Workspace::Single.new(
+    #     path: "page.html",
+    #     read: -> { page.reload.draft_html },
+    #     write: ->(html) { page.update!(draft_html: html) }
+    #   )
+    #
+    # The document tools then read and edit that column like any document.
+    class Single
+      def initialize(read:, write:, path: "document")
+        @path = path.to_s
+        @read = read
+        @write = write
+      end
+
+      def read(path)
+        path.to_s == @path ? @read.call : nil
+      end
+
+      def write(path, content)
+        raise SchemaError, "this workspace holds only #{@path.inspect}" unless path.to_s == @path
+
+        @write.call(content.to_s)
+        nil
+      end
+
+      def delete(path)
+        if path.to_s == @path
+          raise SchemaError,
+                "#{@path.inspect} cannot be deleted, only rewritten"
+        end
+
+        nil
+      end
+
+      def list(prefix = nil)
+        prefix.nil? || @path.start_with?(prefix.to_s) ? [@path] : []
+      end
+    end
+  end
+end

data/lib/mistri.rb

@@ -1,7 +1,94 @@
 # frozen_string_literal: true
 
 require_relative "mistri/version"
+require_relative "mistri/errors"
+require_relative "mistri/stop_reason"
+require_relative "mistri/usage"
+require_relative "mistri/models"
+require_relative "mistri/tool_call"
+require_relative "mistri/content"
+require_relative "mistri/message"
+require_relative "mistri/event"
+require_relative "mistri/abort_signal"
+require_relative "mistri/sse"
+require_relative "mistri/partial_json"
+require_relative "mistri/transport"
+require_relative "mistri/schema"
+require_relative "mistri/edit"
+require_relative "mistri/tool_context"
+require_relative "mistri/tool_result"
+require_relative "mistri/tool"
+require_relative "mistri/workspace/memory"
+require_relative "mistri/workspace/directory"
+require_relative "mistri/workspace/single"
+require_relative "mistri/memory"
+require_relative "mistri/tools"
+require_relative "mistri/skill"
+require_relative "mistri/skills"
+require_relative "mistri/tool_executor"
+require_relative "mistri/budget"
+require_relative "mistri/retry_policy"
+require_relative "mistri/compaction"
+require_relative "mistri/stores/memory"
+require_relative "mistri/stores/jsonl"
+require_relative "mistri/session"
+require_relative "mistri/compactor"
+require_relative "mistri/result"
+require_relative "mistri/agent"
+require_relative "mistri/sub_agent"
+require_relative "mistri/sinks/action_cable"
+require_relative "mistri/sinks/sse"
+require_relative "mistri/sinks/coalesced"
+require_relative "mistri/providers/fake"
+require_relative "mistri/providers/anthropic"
+require_relative "mistri/providers/openai"
+require_relative "mistri/providers/gemini"
 
 # Mistri (مستری): the fixer. An agent harness for Ruby applications.
 module Mistri
+  PROVIDERS = { anthropic: Providers::Anthropic, openai: Providers::OpenAI,
+                gemini: Providers::Gemini }.freeze
+  API_KEY_ENV = { anthropic: "ANTHROPIC_API_KEY", openai: "OPENAI_API_KEY",
+                  gemini: "GEMINI_API_KEY" }.freeze
+
+  module_function
+
+  # Build a provider for a model, inferring which one from the model id and
+  # reading its key from the environment unless one is passed.
+  #
+  #   Mistri.provider("claude-opus-4-8")
+  #   Mistri.provider("gpt-5.5", api_key: key, reasoning: { effort: "high" })
+  def provider(model, api_key: nil, **)
+    name = provider_name(model)
+    klass = PROVIDERS.fetch(name) { raise ConfigurationError, "no provider for #{model.inspect}" }
+    key = api_key || ENV.fetch(API_KEY_ENV.fetch(name), nil)
+    raise ConfigurationError, "no API key for #{name}" if key.to_s.empty?
+
+    klass.new(api_key: key, model: model, **)
+  end
+
+  # Build an agent for a model in one call: infers and constructs the provider,
+  # then wraps it in the loop.
+  #
+  #   agent = Mistri.agent("claude-opus-4-8", tools: [weather], system: "Be brief.")
+  #   agent.run("Weather in Lahore?") { |event| ... }
+  def agent(model, api_key: nil, provider_options: {}, **agent_options)
+    built = provider(model, api_key: api_key, **provider_options)
+    Agent.new(provider: built, **agent_options)
+  end
+
+  # Catalogued models infer directly; unknown ids fall back to the id prefix,
+  # so a brand-new model works before it is catalogued.
+  def provider_name(model)
+    Models.find(model)&.provider || infer_provider_name(model)
+  end
+
+  def infer_provider_name(model)
+    case model.to_s
+    when /\Aclaude/ then :anthropic
+    when /\A(gpt|o\d|chatgpt)/ then :openai
+    when /\Agemini/ then :gemini
+    else raise ConfigurationError, "cannot infer a provider from #{model.inspect}"
+    end
+  end
 end

metadata

@@ -1,17 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: mistri
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.1.0
 platform: ruby
 authors:
 - Muhammad Ahmed Cheema
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-04 00:00:00.000000000 Z
+date: 2026-07-05 00:00:00.000000000 Z
 dependencies: []
-description: 'Mistri (مستری) is the fixer: an agent harness for Ruby applications.
-  First release coming soon.'
+description: 'Mistri (مستری) is the fixer: an agent harness that lives inside your
+  app. Durable sessions in your own database, streaming, tools, fire-and-forget human
+  approval, steering, compaction, structured output, skills, and sub-agents, across
+  Anthropic, OpenAI, and Gemini, with zero runtime dependencies.'
 email:
 executables: []
 extensions: []
@@ -21,14 +23,75 @@ files:
 - LICENSE
 - NOTICE
 - README.md
+- lib/generators/mistri/install/install_generator.rb
+- lib/generators/mistri/install/templates/migration.rb.tt
+- lib/generators/mistri/install/templates/model.rb.tt
 - lib/mistri.rb
+- lib/mistri/abort_signal.rb
+- lib/mistri/agent.rb
+- lib/mistri/budget.rb
+- lib/mistri/compaction.rb
+- lib/mistri/compactor.rb
+- lib/mistri/content.rb
+- lib/mistri/edit.rb
+- lib/mistri/errors.rb
+- lib/mistri/event.rb
+- lib/mistri/memory.rb
+- lib/mistri/message.rb
+- lib/mistri/models.rb
+- lib/mistri/partial_json.rb
+- lib/mistri/providers/anthropic.rb
+- lib/mistri/providers/anthropic/assembler.rb
+- lib/mistri/providers/anthropic/serializer.rb
+- lib/mistri/providers/fake.rb
+- lib/mistri/providers/gemini.rb
+- lib/mistri/providers/gemini/assembler.rb
+- lib/mistri/providers/gemini/serializer.rb
+- lib/mistri/providers/openai.rb
+- lib/mistri/providers/openai/assembler.rb
+- lib/mistri/providers/openai/serializer.rb
+- lib/mistri/result.rb
+- lib/mistri/retry_policy.rb
+- lib/mistri/schema.rb
+- lib/mistri/session.rb
+- lib/mistri/sinks/action_cable.rb
+- lib/mistri/sinks/coalesced.rb
+- lib/mistri/sinks/sse.rb
+- lib/mistri/skill.rb
+- lib/mistri/skills.rb
+- lib/mistri/sse.rb
+- lib/mistri/stop_reason.rb
+- lib/mistri/stores/active_record.rb
+- lib/mistri/stores/jsonl.rb
+- lib/mistri/stores/memory.rb
+- lib/mistri/sub_agent.rb
+- lib/mistri/tool.rb
+- lib/mistri/tool_call.rb
+- lib/mistri/tool_context.rb
+- lib/mistri/tool_executor.rb
+- lib/mistri/tool_result.rb
+- lib/mistri/tools.rb
+- lib/mistri/tools/edit_file.rb
+- lib/mistri/tools/find_in_file.rb
+- lib/mistri/tools/list_files.rb
+- lib/mistri/tools/read_file.rb
+- lib/mistri/tools/read_memory.rb
+- lib/mistri/tools/update_memory.rb
+- lib/mistri/tools/write_file.rb
+- lib/mistri/transport.rb
+- lib/mistri/usage.rb
 - lib/mistri/version.rb
+- lib/mistri/workspace/active_record.rb
+- lib/mistri/workspace/directory.rb
+- lib/mistri/workspace/memory.rb
+- lib/mistri/workspace/single.rb
 homepage: https://github.com/mcheemaa/mistri
 licenses:
 - MIT
 metadata:
   source_code_uri: https://github.com/mcheemaa/mistri
   changelog_uri: https://github.com/mcheemaa/mistri/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -47,5 +110,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: 'Mistri: an agent harness for Ruby applications.'
+summary: The agent harness for Ruby applications.
 test_files: []