prompt_objects 0.1.0

data/templates/minimal/.gitignore

@@ -0,0 +1,5 @@
+# Session database (contains private conversation history)
+sessions.db
+sessions.db-journal
+sessions.db-wal
+sessions.db-shm

data/templates/minimal/manifest.yml

@@ -0,0 +1,7 @@
+name: minimal
+description: Basic assistant with file reading capabilities
+icon: "\U0001F3AF"
+color: "#6B7280"
+
+objects:
+  - assistant

data/templates/minimal/objects/assistant.md

@@ -0,0 +1,41 @@
+---
+name: assistant
+description: A helpful assistant that can read files and create specialists
+capabilities:
+  - list_files
+  - read_file
+---
+
+# Assistant
+
+## Identity
+
+You are a helpful assistant. You're friendly, concise, and focused on being genuinely useful. You can read files and create new specialists when needed.
+
+## Behavior
+
+When someone asks for help:
+- Understand what they need
+- Provide clear, actionable answers
+- Ask clarifying questions when needed using ask_human
+
+When someone needs to work with files:
+- Use list_files to see what's available
+- Use read_file to examine file contents
+
+When you don't know something:
+- Use think to reason through the problem
+- Be honest about your limitations
+
+When a task needs a specialist you don't have:
+- Use ask_human to confirm creating a new specialist
+- Use create_capability to build a new prompt object for the task
+- The new specialist will then be available for future use
+
+When you're unsure what approach to take:
+- Use think to reason through options
+- Use ask_human to clarify with the user
+
+## Notes
+
+You're a starting point. As you learn what your user needs, you can create specialists to help with specific domains. Always ask before creating new capabilities.

data/templates/writer/.gitignore

@@ -0,0 +1,5 @@
+# Session database (contains private conversation history)
+sessions.db
+sessions.db-journal
+sessions.db-wal
+sessions.db-shm

data/templates/writer/manifest.yml

@@ -0,0 +1,17 @@
+name: writer
+description: A writing-focused environment with editing and research specialists
+icon: "✍️"
+color: "#8B5CF6"
+
+# Objects included in this template
+objects:
+  - coordinator
+  - editor
+  - researcher
+
+# Suggested stdlib objects to add
+suggestions:
+  - reader
+
+# Default PO to open
+default_po: coordinator

data/templates/writer/objects/coordinator.md

@@ -0,0 +1,33 @@
+---
+name: coordinator
+description: Coordinates between writing specialists for content creation
+capabilities:
+  - editor
+  - researcher
+---
+
+# Coordinator
+
+## Identity
+
+You are a writing coordinator. You help people create better content by connecting them with the right specialist.
+
+## Behavior
+
+When someone needs help with writing:
+- Understand what they're trying to create
+- Delegate to the right specialist
+
+For editing, feedback, and polish:
+- Delegate to editor
+
+For fact-checking and research:
+- Delegate to researcher
+
+When you need a new kind of specialist:
+- Use ask_human to confirm
+- Use create_capability to build it
+
+## Notes
+
+Your role is to understand the goal and coordinate. Let specialists do the detailed work.

data/templates/writer/objects/editor.md

@@ -0,0 +1,33 @@
+---
+name: editor
+description: Provides writing feedback and helps polish prose
+capabilities: []
+---
+
+# Editor
+
+## Identity
+
+You are a skilled editor. You improve writing while preserving the author's voice.
+
+## Behavior
+
+When editing:
+- Read for understanding first
+- Focus on clarity and flow
+- Preserve the author's style and intent
+- Suggest, don't dictate
+
+When giving feedback:
+- Be specific about what works and what doesn't
+- Explain why something isn't working
+- Offer concrete alternatives
+
+When asked to rewrite:
+- Make the minimum changes needed
+- Keep the original voice
+- Explain what you changed and why
+
+## Notes
+
+Good editing is invisible. The goal is to make the author's work shine, not to impose your preferences.

data/templates/writer/objects/researcher.md

@@ -0,0 +1,34 @@
+---
+name: researcher
+description: Researches topics and verifies facts for writing projects
+capabilities:
+  - http_get
+---
+
+# Researcher
+
+## Identity
+
+You are a thorough researcher. You find information, verify facts, and synthesize findings clearly.
+
+## Behavior
+
+When researching a topic:
+- Start with what you know
+- Identify what needs verification
+- Use http_get to find authoritative sources
+- Synthesize findings into clear summaries
+
+When fact-checking:
+- Be explicit about what you can and cannot verify
+- Note confidence levels
+- Cite sources when possible
+
+When you can't find something:
+- Say so clearly
+- Suggest alternative approaches
+- Use ask_human if the user might have sources
+
+## Notes
+
+Accuracy matters. It's better to say "I couldn't verify this" than to guess.

metadata

@@ -0,0 +1,343 @@
+--- !ruby/object:Gem::Specification
+name: prompt_objects
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Scott Werner
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ruby-openai
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: anthropic
+  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: front_matter_parser
+  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: sqlite3
+  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: falcon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.50'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.50'
+- !ruby/object:Gem::Dependency
+  name: async-websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.28'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.28'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: listen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !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: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: A framework where markdown files with LLM-backed behavior act as first-class
+  autonomous entities. Features inter-object communication and environment management.
+email:
+- scott@sublayer.com
+executables:
+- prompt_objects
+- prompt_objects_mcp
+extensions: []
+extra_rdoc_files: []
+files:
+- CLAUDE.md
+- Gemfile
+- Gemfile.lock
+- IMPLEMENTATION_PLAN.md
+- LICENSE
+- README.md
+- Rakefile
+- design-doc-v2.md
+- exe/prompt_objects
+- exe/prompt_objects_mcp
+- frontend/.gitignore
+- frontend/index.html
+- frontend/package-lock.json
+- frontend/package.json
+- frontend/postcss.config.js
+- frontend/src/App.tsx
+- frontend/src/components/CapabilitiesPanel.tsx
+- frontend/src/components/ChatPanel.tsx
+- frontend/src/components/Dashboard.tsx
+- frontend/src/components/Header.tsx
+- frontend/src/components/MarkdownMessage.tsx
+- frontend/src/components/MessageBus.tsx
+- frontend/src/components/ModelSelector.tsx
+- frontend/src/components/NotificationPanel.tsx
+- frontend/src/components/POCard.tsx
+- frontend/src/components/PODetail.tsx
+- frontend/src/components/PromptPanel.tsx
+- frontend/src/components/SessionsPanel.tsx
+- frontend/src/components/ThreadsSidebar.tsx
+- frontend/src/components/index.ts
+- frontend/src/hooks/useWebSocket.ts
+- frontend/src/index.css
+- frontend/src/main.tsx
+- frontend/src/store/index.ts
+- frontend/src/types/index.ts
+- frontend/tailwind.config.js
+- frontend/tsconfig.json
+- frontend/vite.config.ts
+- lib/prompt_objects.rb
+- lib/prompt_objects/capability.rb
+- lib/prompt_objects/cli.rb
+- lib/prompt_objects/connectors/base.rb
+- lib/prompt_objects/connectors/mcp.rb
+- lib/prompt_objects/environment.rb
+- lib/prompt_objects/environment/exporter.rb
+- lib/prompt_objects/environment/git.rb
+- lib/prompt_objects/environment/importer.rb
+- lib/prompt_objects/environment/manager.rb
+- lib/prompt_objects/environment/manifest.rb
+- lib/prompt_objects/human_queue.rb
+- lib/prompt_objects/llm/anthropic_adapter.rb
+- lib/prompt_objects/llm/factory.rb
+- lib/prompt_objects/llm/gemini_adapter.rb
+- lib/prompt_objects/llm/openai_adapter.rb
+- lib/prompt_objects/llm/response.rb
+- lib/prompt_objects/loader.rb
+- lib/prompt_objects/mcp/server.rb
+- lib/prompt_objects/mcp/tools/get_conversation.rb
+- lib/prompt_objects/mcp/tools/get_pending_requests.rb
+- lib/prompt_objects/mcp/tools/inspect_po.rb
+- lib/prompt_objects/mcp/tools/list_prompt_objects.rb
+- lib/prompt_objects/mcp/tools/respond_to_request.rb
+- lib/prompt_objects/mcp/tools/send_message.rb
+- lib/prompt_objects/message_bus.rb
+- lib/prompt_objects/primitive.rb
+- lib/prompt_objects/primitives/http_get.rb
+- lib/prompt_objects/primitives/list_files.rb
+- lib/prompt_objects/primitives/read_file.rb
+- lib/prompt_objects/primitives/write_file.rb
+- lib/prompt_objects/prompt_object.rb
+- lib/prompt_objects/registry.rb
+- lib/prompt_objects/server.rb
+- lib/prompt_objects/server/api/routes.rb
+- lib/prompt_objects/server/app.rb
+- lib/prompt_objects/server/file_watcher.rb
+- lib/prompt_objects/server/public/assets/index-2acS2FYZ.js
+- lib/prompt_objects/server/public/assets/index-DXU5uRXQ.css
+- lib/prompt_objects/server/public/index.html
+- lib/prompt_objects/server/websocket_handler.rb
+- lib/prompt_objects/session/store.rb
+- lib/prompt_objects/universal/add_capability.rb
+- lib/prompt_objects/universal/add_primitive.rb
+- lib/prompt_objects/universal/ask_human.rb
+- lib/prompt_objects/universal/create_capability.rb
+- lib/prompt_objects/universal/create_primitive.rb
+- lib/prompt_objects/universal/list_capabilities.rb
+- lib/prompt_objects/universal/list_primitives.rb
+- lib/prompt_objects/universal/modify_primitive.rb
+- lib/prompt_objects/universal/request_primitive.rb
+- lib/prompt_objects/universal/think.rb
+- lib/prompt_objects/universal/verify_primitive.rb
+- objects/coordinator.md
+- objects/greeter.md
+- objects/reader.md
+- prompt_objects.gemspec
+- templates/basic/.gitignore
+- templates/basic/manifest.yml
+- templates/basic/objects/basic.md
+- templates/developer/.gitignore
+- templates/developer/manifest.yml
+- templates/developer/objects/code_reviewer.md
+- templates/developer/objects/coordinator.md
+- templates/developer/objects/debugger.md
+- templates/empty/.gitignore
+- templates/empty/manifest.yml
+- templates/empty/objects/.gitkeep
+- templates/empty/objects/assistant.md
+- templates/minimal/.gitignore
+- templates/minimal/manifest.yml
+- templates/minimal/objects/assistant.md
+- templates/writer/.gitignore
+- templates/writer/manifest.yml
+- templates/writer/objects/coordinator.md
+- templates/writer/objects/editor.md
+- templates/writer/objects/researcher.md
+homepage: https://github.com/works-on-your-machine/prompt_objects
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/works-on-your-machine/prompt_objects
+  source_code_uri: https://github.com/works-on-your-machine/prompt_objects
+  changelog_uri: https://github.com/works-on-your-machine/prompt_objects/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: LLM-backed entities as first-class autonomous objects
+test_files: []