little_ghost 0.1.0

data/lib/little_ghost/workspace.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module LittleGhost
+  # A Workspace gives an agent a concrete home for files. Pair it with a Sandbox
+  # to decide how those files may be read, changed, or used by commands.
+  #
+  #   workspace = LittleGhost::Workspace.new(root: "./tmp/support-run")
+  #   workspace.root # => an absolute path ending in "/tmp/support-run"
+  #
+  # Workspaces participate in the run resource lifecycle. A custom workspace can
+  # provision storage in #open and release it in #close.
+  class Workspace
+    # Expands +root+ to an absolute path.
+    def initialize(root:)
+      @root = File.expand_path(root)
+    end
+
+    # Absolute filesystem root assigned to this workspace.
+    attr_reader :root
+
+    # Opens any run-scoped resources and yields this workspace to the run.
+    def open(run: nil)
+      self
+    end
+
+    # Releases workspace resources. The default workspace has nothing to close.
+    def close
+      nil
+    end
+  end
+end

data/lib/little_ghost.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require_relative "little_ghost/version"
+require_relative "little_ghost/errors"
+require_relative "little_ghost/execution_state"
+require_relative "little_ghost/support"
+require_relative "little_ghost/events"
+require_relative "little_ghost/instrumentation"
+require_relative "little_ghost/tracing/open_telemetry"
+require_relative "little_ghost/invocation"
+require_relative "little_ghost/lookup"
+require_relative "little_ghost/path_set"
+require_relative "little_ghost/usage"
+require_relative "little_ghost/content"
+require_relative "little_ghost/message"
+require_relative "little_ghost/stream_event"
+require_relative "little_ghost/model_request"
+require_relative "little_ghost/model_response"
+require_relative "little_ghost/run_result"
+require_relative "little_ghost/model_capabilities"
+require_relative "little_ghost/model"
+require_relative "little_ghost/model_registry"
+require_relative "little_ghost/providers/sse_parser"
+require_relative "little_ghost/providers/http_transport"
+require_relative "little_ghost/providers/openai_compatible"
+require_relative "little_ghost/providers/openai"
+require_relative "little_ghost/providers/open_router"
+require_relative "little_ghost/providers/bedrock"
+require_relative "little_ghost/default_model_registry"
+require_relative "little_ghost/run_context"
+require_relative "little_ghost/workspace"
+require_relative "little_ghost/sandbox"
+require_relative "little_ghost/unrestricted_sandbox"
+require_relative "little_ghost/tool"
+require_relative "little_ghost/tool_execution"
+require_relative "little_ghost/tool_registry"
+require_relative "little_ghost/structured_output"
+require_relative "little_ghost/prompt_resolver"
+require_relative "little_ghost/session_store"
+require_relative "little_ghost/session_stores/memory"
+require_relative "little_ghost/session"
+require_relative "little_ghost/skills"
+require_relative "little_ghost/tools/write_todos"
+require_relative "little_ghost/run"
+require_relative "little_ghost/subagents/definition"
+require_relative "little_ghost/subagents/agent_path"
+require_relative "little_ghost/subagents/manager"
+require_relative "little_ghost/agent_interruptions"
+require_relative "little_ghost/agent"
+require_relative "little_ghost/agent_builder"
+require_relative "little_ghost/workflow"
+require_relative "little_ghost/runtime/hook"
+require_relative "little_ghost/runtime"
+
+# Build AI features with reusable agents and agentic workflows. LittleGhost can
+# sit inside an existing Ruby system or support a dedicated AI service, keeping
+# models, prompts, tools, sessions, streaming, and instrumentation behind a
+# cohesive set of Ruby conventions.
+#
+# A customer support agent can answer directly, use an application tool, or ask a
+# specialist for research while the caller observes one run:
+#
+#   LittleGhost.configure do |config|
+#     config.models CustomerSupportModels
+#     config.default_model :customer_support
+#   end
+#
+#   class ResearchAgent < LittleGhost::Agent
+#     description "Researches difficult support questions"
+#     model "customer_support.research"
+#   end
+#
+#   class CustomerSupportAgent < LittleGhost::Agent
+#     description "Handles support requests"
+#     model :customer_support
+#     tools AccountTool
+#     subagent ResearchAgent, kind: "research"
+#   end
+#
+#   run = CustomerSupportAgent.ask("Why is transfer 481 still pending?")
+#   run.completed? # => true
+#   run.response   # => "Transfer 481 is waiting for the receiving bank."
+#
+# Agent subclasses hold reusable behavior; Invocation objects carry one request,
+# and Run objects own execution and cleanup. Workflow subclasses can compose
+# several agents when ordinary Ruby branching is clearer than one agent loop.
+#
+# LittleGhost.configuration is process-wide unless LittleGhost.with_configuration
+# supplies an execution-scoped replacement. Configuration is loaded lazily and
+# snapshotted into a Runtime, so make application changes before the first agent
+# runtime is built.
+module LittleGhost
+  class << self
+    # The configuration active in the current execution context, falling back to
+    # the process-wide default.
+    def configuration
+      ExecutionState[:configuration] || (@configuration ||= Configuration.new)
+    end
+
+    # Alias for .configuration. Without an execution-scoped override, this is the
+    # process-wide default Configuration.
+    alias_method :default_configuration, :configuration
+
+    # Opens the active Configuration for application setup and returns it.
+    #
+    # Configuration files are loaded lazily when a runtime is first built, so
+    # make application-level changes before invoking an agent.
+    def configure(&block)
+      configuration.configure(&block)
+    end
+
+    # Makes +configuration+ current only while the block runs.
+    #
+    # Execution state restores the previous configuration even when the block
+    # raises. Other execution contexts continue to see their own configuration.
+    def with_configuration(configuration)
+      ExecutionState.with(configuration:) { yield }
+    end
+  end
+end

metadata

@@ -0,0 +1,225 @@
+--- !ruby/object:Gem::Specification
+name: little_ghost
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Matt Robinson
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  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: opentelemetry-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.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: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.2'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.44'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.44'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+description: Add agents, tools, and agentic workflows to existing Ruby systems or
+  dedicated AI services.
+email:
+- robinson.matty@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- docs/guides/Core Concepts.md
+- docs/guides/Getting Started.md
+- lib/little_ghost.rb
+- lib/little_ghost/ag_ui.rb
+- lib/little_ghost/ag_ui/adapter.rb
+- lib/little_ghost/agent.rb
+- lib/little_ghost/agent/context_management.rb
+- lib/little_ghost/agent/delegation.rb
+- lib/little_ghost/agent/skills.rb
+- lib/little_ghost/agent/tool_loop.rb
+- lib/little_ghost/agent_builder.rb
+- lib/little_ghost/agent_interruptions.rb
+- lib/little_ghost/configuration.rb
+- lib/little_ghost/content.rb
+- lib/little_ghost/default_model_registry.rb
+- lib/little_ghost/errors.rb
+- lib/little_ghost/events.rb
+- lib/little_ghost/execution_state.rb
+- lib/little_ghost/instrumentation.rb
+- lib/little_ghost/invocation.rb
+- lib/little_ghost/lookup.rb
+- lib/little_ghost/mcp.rb
+- lib/little_ghost/mcp/client.rb
+- lib/little_ghost/message.rb
+- lib/little_ghost/model.rb
+- lib/little_ghost/model_capabilities.rb
+- lib/little_ghost/model_registry.rb
+- lib/little_ghost/model_request.rb
+- lib/little_ghost/model_response.rb
+- lib/little_ghost/path_set.rb
+- lib/little_ghost/prompt_resolver.rb
+- lib/little_ghost/providers/bedrock.rb
+- lib/little_ghost/providers/http_transport.rb
+- lib/little_ghost/providers/open_router.rb
+- lib/little_ghost/providers/openai.rb
+- lib/little_ghost/providers/openai_compatible.rb
+- lib/little_ghost/providers/sse_parser.rb
+- lib/little_ghost/run.rb
+- lib/little_ghost/run_context.rb
+- lib/little_ghost/run_result.rb
+- lib/little_ghost/runtime.rb
+- lib/little_ghost/runtime/hook.rb
+- lib/little_ghost/sandbox.rb
+- lib/little_ghost/session.rb
+- lib/little_ghost/session_store.rb
+- lib/little_ghost/session_stores/agent_core_memory.rb
+- lib/little_ghost/session_stores/memory.rb
+- lib/little_ghost/skills.rb
+- lib/little_ghost/skills/catalog.rb
+- lib/little_ghost/skills/skill.rb
+- lib/little_ghost/stream_event.rb
+- lib/little_ghost/structured_output.rb
+- lib/little_ghost/subagents/agent_path.rb
+- lib/little_ghost/subagents/definition.rb
+- lib/little_ghost/subagents/manager.rb
+- lib/little_ghost/support.rb
+- lib/little_ghost/support/callbacks.rb
+- lib/little_ghost/support/cancellation_token.rb
+- lib/little_ghost/support/class_attributes.rb
+- lib/little_ghost/support/content_capture.rb
+- lib/little_ghost/support/executor.rb
+- lib/little_ghost/support/interruptible_stream.rb
+- lib/little_ghost/support/loader.rb
+- lib/little_ghost/support/output_truncation.rb
+- lib/little_ghost/support/redactor.rb
+- lib/little_ghost/tool.rb
+- lib/little_ghost/tool_execution.rb
+- lib/little_ghost/tool_registry.rb
+- lib/little_ghost/tools.rb
+- lib/little_ghost/tools/filesystem.rb
+- lib/little_ghost/tools/shell.rb
+- lib/little_ghost/tools/write_todos.rb
+- lib/little_ghost/tracing/open_telemetry.rb
+- lib/little_ghost/unrestricted_sandbox.rb
+- lib/little_ghost/usage.rb
+- lib/little_ghost/version.rb
+- lib/little_ghost/workflow.rb
+- lib/little_ghost/workspace.rb
+homepage: https://github.com/mattyr/little_ghost
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/mattyr/little_ghost/issues
+  changelog_uri: https://github.com/mattyr/little_ghost/releases
+  documentation_uri: https://mattyr.github.io/little_ghost/docs/
+  source_code_uri: https://github.com/mattyr/little_ghost
+  allowed_push_host: https://rubygems.org
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: A Ruby framework for AI features with agents and agentic workflows
+test_files: []