prompt_objects 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1ad31b1bb32afdf58701be9b0b163314ce9944a1e2df465f81540e36c5e7aa10
+  data.tar.gz: 865fdc2ee3c868cbc48ac86e4034472e71ea12b51a31d99b71bc446a50a45eb9
+SHA512:
+  metadata.gz: 1c1cdf27920d51f61ce89feb4df5f7eb8f6d9c37f43ba53c7578d56193fcf9e3016fc465a0d4e4fcac3a74d9c15ac09ecb3031b867f5b04ac155d2e5bb6aeb75
+  data.tar.gz: abf9df3fff47f105b8e0b516784712c980a155f0adf1b2fc770f329aabde0144d8f4e4b139627d5cc6d734c1041abfc5dc85fc5e65f6dd4a8d023545e6f1bdcb

data/CLAUDE.md

@@ -0,0 +1,108 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**PromptObjects** is a Ruby framework where markdown files with LLM-backed behavior act as first-class autonomous entities. The core insight: **everything is a capability**—primitives (Ruby code) and Prompt-Objects (markdown files) share the same interface, differing only in interpretation complexity.
+
+**Current Status**: Design phase—`design-doc-v2.md` contains the full specification, `IMPLEMENTATION_PLAN.md` has detailed phased build plans. No implementation code exists yet.
+
+## Architecture
+
+```
+ENVIRONMENT
+├── CAPABILITY REGISTRY
+│   ├── PRIMITIVES (Ruby) - deterministic interpretation
+│   └── PROMPT-OBJECTS (Markdown) - semantic interpretation via LLM
+├── MESSAGE BUS - routes messages, logs for visualization
+└── TERMINAL UI (Charm) - capability bar, message log, conversation, input
+```
+
+### Unified Capability Interface
+Both primitives and Prompt-Objects implement:
+```ruby
+class Capability
+  def name          # string identifier
+  def description   # what this capability does
+  def receive(message, context:)  # handle message, return response
+end
+```
+
+### Prompt-Object Structure
+Markdown files with two parts:
+- **Frontmatter (YAML)**: Configuration (name, description, capabilities)
+- **Body (Markdown)**: Identity and behavior (becomes LLM system prompt)
+
+Example:
+```markdown
+---
+name: reader
+description: Helps people understand files
+capabilities:
+  - read_file
+  - list_files
+---
+
+# Reader
+## Identity
+You are a careful, thoughtful file reader...
+```
+
+### Universal Capabilities
+Available to all Prompt-Objects automatically (no frontmatter declaration needed):
+- `ask_human` - pause for human input/confirmation
+- `think` - internal reasoning (not shown to human)
+- `request_capability` - ask environment for new capability
+
+## Technology Stack
+
+- **Ruby** - core implementation
+- **LLM APIs** - OpenAI, Anthropic, Gemini (adapter pattern)
+- **Charm** - Terminal UI (Bubble Tea for interaction, Lipgloss for styling, Glamour for markdown)
+- **MCP** - Model Context Protocol integration
+
+### TUI Architecture Note
+
+The TUI uses a **single Bubble Tea program** with internal screen states (picker, wizard, main). Do NOT run multiple sequential `Bubbletea.run` calls—this causes terminal state corruption. See `docs/phase-8-environments.md` for details.
+
+## Planned File Structure
+
+```
+prompt_objects/
+├── exe/prompt_objects          # CLI entrypoint
+├── lib/
+│   ├── prompt_objects.rb       # Main entry
+│   └── prompt_objects/
+│       ├── environment.rb      # Runtime container
+│       ├── capability.rb       # Base interface
+│       ├── prompt_object.rb    # PO implementation
+│       ├── primitive.rb        # Primitive tool wrapper
+│       ├── loader.rb           # Parses frontmatter + body
+│       ├── registry.rb         # Capability registration
+│       ├── message_bus.rb      # Message routing and logging
+│       ├── llm/                # LLM adapters
+│       ├── primitives/         # Built-in primitives (read_file, etc.)
+│       ├── universal/          # Universal capabilities
+│       ├── mcp/                # MCP integration
+│       └── ui/                 # Charm-based terminal UI
+├── objects/                    # Where Prompt-Objects live (.md files)
+└── primitives/                 # Optional user-defined primitives
+```
+
+## Implementation Phases
+
+1. **Core Loop**: Capability base, PromptObject, Loader, single LLM adapter, simple REPL
+2. **Primitives & Binding**: Primitive base, built-in primitives, Registry
+3. **Multi-Capability**: Message bus with logging, PO↔PO communication
+4. **Self-Modification**: Universal capabilities including create_capability
+5. **Polish & UI**: Full Charm integration, all UI components
+6. **Demo Ready**: Error handling, testing, practice runs
+
+## Key Concepts
+
+- **Semantic Binding**: Natural language → capability call (visible in message log)
+- **PO↔PO Communication**: Prompt-Objects can call each other as capabilities
+- **Self-Modification**: System can create new Prompt-Objects at runtime (with human approval)
+- **Human-in-the-Loop**: POs ask for confirmation on dangerous actions, clarification when ambiguous
+- **Non-blocking Human Queue**: When POs need human input (`ask_human`), they suspend (via Fibers) and queue a notification. Multiple POs can wait simultaneously. Human responds via notification panel, PO resumes automatically.

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in prompt_objects.gemspec
+gemspec
+
+# Ruby 3.4+ compatibility - base64 moved out of stdlib
+gem "base64"
+

data/Gemfile.lock

@@ -0,0 +1,231 @@
+PATH
+  remote: .
+  specs:
+    prompt_objects (0.1.0)
+      anthropic (~> 1.0)
+      async-websocket (~> 0.28)
+      falcon (~> 0.50)
+      front_matter_parser (~> 1.0)
+      listen (~> 3.9)
+      mcp (~> 0.4)
+      rack (~> 3.0)
+      ruby-openai (~> 7.0)
+      sqlite3 (~> 2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
+    anthropic (1.16.3)
+      connection_pool
+    ast (2.4.3)
+    async (2.35.2)
+      console (~> 1.29)
+      fiber-annotation
+      io-event (~> 1.11)
+      metrics (~> 0.12)
+      traces (~> 0.18)
+    async-container (0.27.7)
+      async (~> 2.22)
+    async-container-supervisor (0.9.2)
+      async-service
+      io-endpoint
+      memory (~> 0.7)
+      memory-leak (~> 0.5)
+      process-metrics
+    async-http (0.94.0)
+      async (>= 2.10.2)
+      async-pool (~> 0.11)
+      io-endpoint (~> 0.14)
+      io-stream (~> 0.6)
+      metrics (~> 0.12)
+      protocol-http (~> 0.58)
+      protocol-http1 (~> 0.36)
+      protocol-http2 (~> 0.22)
+      protocol-url (~> 0.2)
+      traces (~> 0.10)
+    async-http-cache (0.4.6)
+      async-http (~> 0.56)
+    async-pool (0.11.1)
+      async (>= 2.0)
+    async-service (0.16.0)
+      async
+      async-container (~> 0.16)
+      string-format (~> 0.2)
+    async-websocket (0.30.0)
+      async-http (~> 0.76)
+      protocol-http (~> 0.34)
+      protocol-rack (~> 0.7)
+      protocol-websocket (~> 0.17)
+    bake (0.24.1)
+      bigdecimal
+      samovar (~> 2.1)
+    base64 (0.3.0)
+    bigdecimal (4.0.1)
+    connection_pool (3.0.2)
+    console (1.34.2)
+      fiber-annotation
+      fiber-local (~> 1.1)
+      json
+    date (3.5.1)
+    debug (1.11.1)
+      irb (~> 1.10)
+      reline (>= 0.3.8)
+    erb (6.0.1)
+    event_stream_parser (1.0.0)
+    falcon (0.53.1)
+      async
+      async-container (~> 0.20)
+      async-container-supervisor (~> 0.6)
+      async-http (~> 0.75)
+      async-http-cache (~> 0.4)
+      async-service (~> 0.16)
+      bundler
+      localhost (~> 1.1)
+      openssl (>= 3.0)
+      protocol-http (~> 0.31)
+      protocol-rack (~> 0.7)
+      samovar (~> 2.3)
+    faraday (2.14.0)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-multipart (1.2.0)
+      multipart-post (~> 2.0)
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    ffi (1.17.3-arm64-darwin)
+    ffi (1.17.3-x86_64-linux-gnu)
+    fiber-annotation (0.2.0)
+    fiber-local (1.1.0)
+      fiber-storage
+    fiber-storage (1.0.1)
+    front_matter_parser (1.0.1)
+    io-console (0.8.2)
+    io-endpoint (0.16.0)
+    io-event (1.14.2)
+    io-stream (0.11.1)
+    irb (1.16.0)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.18.0)
+    json-schema (6.1.0)
+      addressable (~> 2.8)
+      bigdecimal (>= 3.1, < 5)
+    json_rpc_handler (0.1.1)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    listen (3.9.0)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    localhost (1.6.0)
+    logger (1.7.0)
+    mapping (1.1.3)
+    mcp (0.4.0)
+      json-schema (>= 4.1)
+      json_rpc_handler (~> 0.1)
+    memory (0.12.0)
+      bake (~> 0.15)
+      console
+      msgpack
+    memory-leak (0.7.0)
+    metrics (0.15.0)
+    minitest (5.27.0)
+    msgpack (1.8.0)
+    multipart-post (2.4.1)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    openssl (4.0.0)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    pp (0.6.3)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.7.0)
+    process-metrics (0.8.0)
+      console (~> 1.8)
+      json (~> 2)
+      samovar (~> 2.1)
+    protocol-hpack (1.5.1)
+    protocol-http (0.58.0)
+    protocol-http1 (0.36.0)
+      protocol-http (~> 0.58)
+    protocol-http2 (0.23.0)
+      protocol-hpack (~> 1.4)
+      protocol-http (~> 0.47)
+    protocol-rack (0.21.0)
+      io-stream (>= 0.10)
+      protocol-http (~> 0.58)
+      rack (>= 1.0)
+    protocol-url (0.4.0)
+    protocol-websocket (0.20.2)
+      protocol-http (~> 0.2)
+    psych (5.3.1)
+      date
+      stringio
+    public_suffix (7.0.1)
+    racc (1.8.1)
+    rack (3.2.4)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
+      ffi (~> 1.0)
+    rdoc (7.0.3)
+      erb
+      psych (>= 4.0.0)
+      tsort
+    regexp_parser (2.11.3)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rubocop (1.82.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    ruby-openai (7.4.0)
+      event_stream_parser (>= 0.3.0, < 2.0.0)
+      faraday (>= 1)
+      faraday-multipart (>= 1)
+    ruby-progressbar (1.13.0)
+    samovar (2.4.1)
+      console (~> 1.0)
+      mapping (~> 1.0)
+    sqlite3 (2.9.0-arm64-darwin)
+    sqlite3 (2.9.0-x86_64-linux-gnu)
+    string-format (0.2.0)
+    stringio (3.2.0)
+    traces (0.18.2)
+    tsort (0.2.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+
+PLATFORMS
+  arm64-darwin-24
+  x86_64-linux
+
+DEPENDENCIES
+  base64
+  debug (~> 1.0)
+  minitest (~> 5.0)
+  prompt_objects!
+  rake (~> 13.0)
+  rubocop (~> 1.50)
+
+BUNDLED WITH
+   2.7.2