prompt_objects 0.4.0 → 0.6.0

data/lib/prompt_objects/universal/delete_env_data.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module PromptObjects
+  module Universal
+    # Universal capability to delete a key from the shared environment data.
+    class DeleteEnvData < Primitive
+      def name
+        "delete_env_data"
+      end
+
+      def description
+        "Delete a key from the shared environment data for this delegation chain."
+      end
+
+      def parameters
+        {
+          type: "object",
+          properties: {
+            key: {
+              type: "string",
+              description: "The key to delete"
+            }
+          },
+          required: ["key"]
+        }
+      end
+
+      def receive(message, context:)
+        key = message[:key] || message["key"]
+        return "Error: 'key' is required" unless key
+
+        root_thread_id = resolve_root_thread(context)
+        return "Error: Could not resolve thread scope (no active session)" unless root_thread_id
+
+        store = context.env.session_store
+        return "Error: Session store not available" unless store
+
+        deleted = store.delete_env_data(root_thread_id: root_thread_id, key: key)
+
+        unless deleted
+          return "Key '#{key}' not found in environment data."
+        end
+
+        stored_by = context.calling_po || "unknown"
+
+        context.bus.publish(
+          from: stored_by,
+          to: "env_data",
+          message: { action: "delete", key: key }
+        )
+
+        context.env.notify_env_data_changed(action: "delete", root_thread_id: root_thread_id, key: key, stored_by: stored_by)
+
+        "Deleted '#{key}' from environment data."
+      end
+
+      private
+
+      def resolve_root_thread(context)
+        store = context.env.session_store
+        return nil unless store
+
+        po = context.env.registry.get(context.calling_po)
+        return nil unless po&.respond_to?(:session_id) && po.session_id
+
+        store.resolve_root_thread(po.session_id)
+      end
+    end
+  end
+end

data/lib/prompt_objects/universal/get_env_data.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module PromptObjects
+  module Universal
+    # Universal capability to retrieve shared data by key from the current delegation chain.
+    class GetEnvData < Primitive
+      def name
+        "get_env_data"
+      end
+
+      def description
+        "Retrieve a specific key's full value from the shared environment data. " \
+        "Use list_env_data first to see what keys are available."
+      end
+
+      def parameters
+        {
+          type: "object",
+          properties: {
+            key: {
+              type: "string",
+              description: "The key to retrieve"
+            }
+          },
+          required: ["key"]
+        }
+      end
+
+      def receive(message, context:)
+        key = message[:key] || message["key"]
+        return "Error: 'key' is required" unless key
+
+        root_thread_id = resolve_root_thread(context)
+        return "Error: Could not resolve thread scope (no active session)" unless root_thread_id
+
+        store = context.env.session_store
+        return "Error: Session store not available" unless store
+
+        entry = store.get_env_data(root_thread_id: root_thread_id, key: key)
+        return "Key '#{key}' not found in environment data." unless entry
+
+        context.bus.publish(
+          from: context.calling_po || "unknown",
+          to: "env_data",
+          message: { action: "get", key: key }
+        )
+
+        JSON.generate(entry[:value])
+      end
+
+      private
+
+      def resolve_root_thread(context)
+        store = context.env.session_store
+        return nil unless store
+
+        po = context.env.registry.get(context.calling_po)
+        return nil unless po&.respond_to?(:session_id) && po.session_id
+
+        store.resolve_root_thread(po.session_id)
+      end
+    end
+  end
+end

data/lib/prompt_objects/universal/list_env_data.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module PromptObjects
+  module Universal
+    # Universal capability to list all shared environment data keys and descriptions.
+    # Returns a lightweight manifest without loading full values.
+    class ListEnvData < Primitive
+      def name
+        "list_env_data"
+      end
+
+      def description
+        "List all keys and descriptions in the shared environment data for this delegation chain. " \
+        "Returns keys and short descriptions only (no values). " \
+        "Use get_env_data to retrieve a specific key's full value."
+      end
+
+      def parameters
+        {
+          type: "object",
+          properties: {},
+          required: []
+        }
+      end
+
+      def receive(message, context:)
+        root_thread_id = resolve_root_thread(context)
+        return "Error: Could not resolve thread scope (no active session)" unless root_thread_id
+
+        store = context.env.session_store
+        return "Error: Session store not available" unless store
+
+        entries = store.list_env_data(root_thread_id: root_thread_id)
+
+        if entries.empty?
+          return "No environment data stored for this delegation chain."
+        end
+
+        context.bus.publish(
+          from: context.calling_po || "unknown",
+          to: "env_data",
+          message: { action: "list", count: entries.size }
+        )
+
+        JSON.generate(entries)
+      end
+
+      private
+
+      def resolve_root_thread(context)
+        store = context.env.session_store
+        return nil unless store
+
+        po = context.env.registry.get(context.calling_po)
+        return nil unless po&.respond_to?(:session_id) && po.session_id
+
+        store.resolve_root_thread(po.session_id)
+      end
+    end
+  end
+end

data/lib/prompt_objects/universal/store_env_data.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module PromptObjects
+  module Universal
+    # Universal capability to store shared data scoped to the current delegation chain.
+    # Any PO in the same delegation tree can read this data via get_env_data or list_env_data.
+    class StoreEnvData < Primitive
+      def name
+        "store_env_data"
+      end
+
+      def description
+        "Store a key-value pair in the shared environment data for this delegation chain. " \
+        "All POs in the same delegation tree can access this data. " \
+        "If the key already exists, it will be overwritten."
+      end
+
+      def parameters
+        {
+          type: "object",
+          properties: {
+            key: {
+              type: "string",
+              description: "Namespaced identifier for the data (e.g. 'arc_task', 'findings')"
+            },
+            short_description: {
+              type: "string",
+              description: "1-2 sentence summary of what this data contains (for discoverability via list_env_data)"
+            },
+            value: {
+              description: "The data to store (any JSON-serializable value: string, number, object, array)"
+            }
+          },
+          required: %w[key short_description value]
+        }
+      end
+
+      def receive(message, context:)
+        key = message[:key] || message["key"]
+        short_description = message[:short_description] || message["short_description"]
+        value = message[:value] || message["value"]
+
+        return "Error: 'key' is required" unless key
+        return "Error: 'short_description' is required" unless short_description
+        return "Error: 'value' is required" if value.nil?
+
+        root_thread_id = resolve_root_thread(context)
+        return "Error: Could not resolve thread scope (no active session)" unless root_thread_id
+
+        store = context.env.session_store
+        return "Error: Session store not available" unless store
+
+        stored_by = context.calling_po || "unknown"
+
+        store.store_env_data(
+          root_thread_id: root_thread_id,
+          key: key,
+          short_description: short_description,
+          value: value,
+          stored_by: stored_by
+        )
+
+        context.bus.publish(
+          from: stored_by,
+          to: "env_data",
+          message: { action: "store", key: key, short_description: short_description }
+        )
+
+        context.env.notify_env_data_changed(action: "store", root_thread_id: root_thread_id, key: key, stored_by: stored_by)
+
+        "Stored '#{key}' in environment data."
+      end
+
+      private
+
+      def resolve_root_thread(context)
+        store = context.env.session_store
+        return nil unless store
+
+        po = context.env.registry.get(context.calling_po)
+        return nil unless po&.respond_to?(:session_id) && po.session_id
+
+        store.resolve_root_thread(po.session_id)
+      end
+    end
+  end
+end

data/lib/prompt_objects/universal/update_env_data.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module PromptObjects
+  module Universal
+    # Universal capability to update an existing shared environment data entry.
+    # Fails if the key doesn't exist (use store_env_data for create-or-replace).
+    class UpdateEnvData < Primitive
+      def name
+        "update_env_data"
+      end
+
+      def description
+        "Update an existing key's value and/or description in the shared environment data. " \
+        "Fails if the key doesn't exist — use store_env_data to create new entries."
+      end
+
+      def parameters
+        {
+          type: "object",
+          properties: {
+            key: {
+              type: "string",
+              description: "The key to update (must already exist)"
+            },
+            short_description: {
+              type: "string",
+              description: "New description (keeps existing if omitted)"
+            },
+            value: {
+              description: "New value (keeps existing if omitted)"
+            }
+          },
+          required: ["key"]
+        }
+      end
+
+      def receive(message, context:)
+        key = message[:key] || message["key"]
+        short_description = message[:short_description] || message["short_description"]
+        value = message[:value] || message["value"]
+
+        return "Error: 'key' is required" unless key
+
+        root_thread_id = resolve_root_thread(context)
+        return "Error: Could not resolve thread scope (no active session)" unless root_thread_id
+
+        store = context.env.session_store
+        return "Error: Session store not available" unless store
+
+        stored_by = context.calling_po || "unknown"
+
+        updated = store.update_env_data(
+          root_thread_id: root_thread_id,
+          key: key,
+          short_description: short_description,
+          value: value,
+          stored_by: stored_by
+        )
+
+        unless updated
+          return "Key '#{key}' not found in environment data. Use store_env_data to create it."
+        end
+
+        context.bus.publish(
+          from: stored_by,
+          to: "env_data",
+          message: { action: "update", key: key }
+        )
+
+        context.env.notify_env_data_changed(action: "update", root_thread_id: root_thread_id, key: key, stored_by: stored_by)
+
+        "Updated '#{key}' in environment data."
+      end
+
+      private
+
+      def resolve_root_thread(context)
+        store = context.env.session_store
+        return nil unless store
+
+        po = context.env.registry.get(context.calling_po)
+        return nil unless po&.respond_to?(:session_id) && po.session_id
+
+        store.resolve_root_thread(po.session_id)
+      end
+    end
+  end
+end

data/lib/prompt_objects.rb

@@ -11,7 +11,7 @@ module PromptObjects
   class Error < StandardError; end
 
   # Universal capabilities available to all prompt objects (don't need to be declared)
-  UNIVERSAL_CAPABILITIES = %w[ask_human think create_capability add_capability remove_capability list_capabilities list_primitives add_primitive create_primitive delete_primitive verify_primitive modify_primitive request_primitive modify_prompt].freeze
+  UNIVERSAL_CAPABILITIES = %w[ask_human think create_capability add_capability remove_capability list_capabilities list_primitives add_primitive create_primitive delete_primitive verify_primitive modify_primitive request_primitive modify_prompt store_env_data get_env_data list_env_data update_env_data delete_env_data].freeze
 end
 
 require_relative "prompt_objects/capability"
@@ -60,6 +60,11 @@ require_relative "prompt_objects/universal/verify_primitive"
 require_relative "prompt_objects/universal/modify_primitive"
 require_relative "prompt_objects/universal/request_primitive"
 require_relative "prompt_objects/universal/modify_prompt"
+require_relative "prompt_objects/universal/store_env_data"
+require_relative "prompt_objects/universal/get_env_data"
+require_relative "prompt_objects/universal/list_env_data"
+require_relative "prompt_objects/universal/update_env_data"
+require_relative "prompt_objects/universal/delete_env_data"
 
 # Connectors (different interfaces to environments)
 require_relative "prompt_objects/connectors/base"

data/prompt_objects.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name          = "prompt_objects"
-  spec.version       = "0.4.0"
+  spec.version       = "0.6.0"
   spec.authors       = ["Scott Werner"]
   spec.email         = ["scott@sublayer.com"]
 

data/templates/arc-agi-1/objects/observer.md

@@ -19,6 +19,10 @@ You are an observation specialist for ARC-AGI grid puzzles. Your job is to look
 
 When given grid pairs to analyze, you produce a structured observation report. You use your tools — don't try to analyze from descriptions alone. Render the grids, run grid_info, find the objects, diff the pairs.
 
+### Check Shared Data First
+
+When you're called by another PO (like the solver), start by calling `list_env_data` to see if task data, grids, or other context has been stored for you. If the solver has stored the loaded task data, you can retrieve it with `get_env_data` instead of relying only on what was included in the message. This is especially useful when you need to compare across multiple training pairs.
+
 ## Observation Framework
 
 For each training pair, analyze and report on ALL of these dimensions:

data/templates/arc-agi-1/objects/solver.md

@@ -26,10 +26,17 @@ Each ARC task gives you 2-5 training pairs (input grid → output grid) and 1-3
 
 ## Solving Process
 
-### Step 1: Load and Render
+### Step 1: Load and Store
 
 Load the task with `load_arc_task`, then render every grid. Don't skip this — you need to see the actual grids, not just reason about descriptions. Use `grid_info` on each grid to get dimensions and color distributions.
 
+After loading, use `store_env_data` to store key information so your delegates (observer, verifier) can access it directly:
+- **`task_id`** — the task identifier
+- **`task_data`** — the full loaded task (training pairs, test inputs, grids)
+- **`task_summary`** — a brief description of the task (pair count, grid dimensions)
+
+This way, when you delegate to the observer or verifier, they can call `list_env_data` and `get_env_data` to retrieve the grids directly instead of relying solely on what you pass in the message.
+
 ### Step 2: Observe (delegate to observer)
 
 Send each training pair to the **observer** and ask it to analyze the transformation. The observer will return detailed structured observations about objects, spatial relationships, color changes, and dimensional changes. Read these carefully.
@@ -87,6 +94,8 @@ If verification fails:
 - Revise your hypothesis to account for the discrepancy
 - Test again
 
+After each verification round, store your current hypothesis and its result with `store_env_data` (e.g., key `current_hypothesis`). This lets delegates see what's already been tried and what failed.
+
 Iterate. Most tasks are solved within 2-4 hypothesis cycles.
 
 ### Step 6: Apply to Test Input

data/templates/arc-agi-1/objects/verifier.md

@@ -20,6 +20,10 @@ You are a rigorous verification specialist for ARC-AGI puzzle solving. When give
 
 When the solver sends you a hypothesis to verify:
 
+### 0. Check Shared Data
+
+Start by calling `list_env_data` to see what context is available. The solver typically stores the loaded task data (`task_data`), task summary (`task_summary`), and current hypothesis (`current_hypothesis`). Use `get_env_data` to retrieve what you need — this gives you direct access to the grids and training pairs rather than relying solely on what the solver includes in its message.
+
 ### 1. Understand the Hypothesis
 
 Restate the proposed rule in your own words to confirm understanding. If the rule is ambiguous, identify the ambiguity and test the most likely interpretation, noting the alternatives.

data/templates/arc-agi-1/primitives/find_objects.rb

@@ -15,7 +15,7 @@ module PromptObjects
         {
           type: "object",
           properties: {
-            grid: { type: "array", description: "2D array of integers" },
+            grid: { type: "array", items: { type: "array", items: { type: "integer" } }, description: "2D array of integers" },
             background: { type: "integer", description: "Background color to ignore (default: 0)" }
           },
           required: ["grid"]

data/templates/arc-agi-1/primitives/grid_diff.rb

@@ -15,8 +15,8 @@ module PromptObjects
         {
           type: "object",
           properties: {
-            grid_a: { type: "array", description: "First grid (2D array)" },
-            grid_b: { type: "array", description: "Second grid (2D array)" }
+            grid_a: { type: "array", items: { type: "array", items: { type: "integer" } }, description: "First grid (2D array)" },
+            grid_b: { type: "array", items: { type: "array", items: { type: "integer" } }, description: "Second grid (2D array)" }
           },
           required: ["grid_a", "grid_b"]
         }

data/templates/arc-agi-1/primitives/grid_info.rb

@@ -15,7 +15,7 @@ module PromptObjects
         {
           type: "object",
           properties: {
-            grid: { type: "array", description: "2D array of integers" }
+            grid: { type: "array", items: { type: "array", items: { type: "integer" } }, description: "2D array of integers" }
           },
           required: ["grid"]
         }

data/templates/arc-agi-1/primitives/grid_transform.rb

@@ -15,7 +15,7 @@ module PromptObjects
         {
           type: "object",
           properties: {
-            grid: { type: "array", description: "2D array of integers" },
+            grid: { type: "array", items: { type: "array", items: { type: "integer" } }, description: "2D array of integers" },
             operation: {
               type: "string",
               enum: %w[rotate_90 rotate_180 rotate_270 flip_h flip_v transpose],

data/templates/arc-agi-1/primitives/render_grid.rb

@@ -27,6 +27,7 @@ module PromptObjects
           properties: {
             grid: {
               type: "array",
+              items: { type: "array", items: { type: "integer" } },
               description: "2D array of integers 0-9"
             },
             label: {

data/templates/arc-agi-1/primitives/test_solution.rb

@@ -21,14 +21,17 @@ module PromptObjects
             },
             grid: {
               type: "array",
+              items: { type: "array", items: { type: "integer" } },
               description: "A grid to compare directly against expected output (for quick checks)"
             },
             expected: {
               type: "array",
+              items: { type: "array", items: { type: "integer" } },
               description: "Expected output grid (used with 'grid' parameter)"
             },
             train: {
               type: "array",
+              items: { type: "object" },
               description: "Training pairs array (used with 'primitive_name'). Each element has 'input' and 'output' grids."
             }
           },

data/tools/thread-explorer.html

@@ -298,6 +298,7 @@ button { font-family:var(--mono); cursor:pointer; }
 
 // --- State ---
 let treeData = null;
+let envData = [];       // root-level env data entries
 let events = [];        // flattened event sequence
 let actors = [];        // ordered actor names
 let poNames = new Set();
@@ -335,6 +336,7 @@ function loadFile(file) {
 
 function loadData(data) {
   treeData = data;
+  envData = data.env_data || [];
   allNodes = {};
   indexNodes(data);
   poNames = extractPONames(data);
@@ -503,9 +505,11 @@ function renderHeader() {
   const usage = sumUsageTree(treeData);
   const nEvents = events.length;
   const nSessions = Object.keys(allNodes).length;
+  const envCount = envData.length;
   document.getElementById('h-stats').innerHTML =
     `<span><span class="v">${nSessions}</span> sessions</span>`+
     `<span><span class="v">${nEvents}</span> events</span>`+
+    (envCount > 0 ? `<span style="color:var(--amber)"><span class="v">${envCount}</span> env data</span>` : '')+
     `<span><span class="v">${fmtNum(usage.input)}</span> in</span>`+
     `<span><span class="v">${fmtNum(usage.output)}</span> out</span>`;
 }
@@ -817,6 +821,29 @@ function renderDetail() {
   html += `<div class="stats"><span><span class="v">${fmtNum(usage.input)}</span> in</span><span><span class="v">${fmtNum(usage.output)}</span> out</span></div>`;
   html += `</div>`;
 
+  // Env Data section (only on root session when env_data exists)
+  if (type === 'root' && envData.length > 0) {
+    html += '<div style="padding:8px 16px 0">';
+    html += '<div style="font-size:10px;text-transform:uppercase;letter-spacing:0.5px;color:var(--amber);margin-bottom:6px;font-weight:600">Env Data</div>';
+    envData.forEach(entry => {
+      const eKey = esc(entry.key);
+      const eDesc = esc(entry.short_description||'');
+      const eBy = esc(entry.stored_by||'');
+      const eVal = typeof entry.value === 'string' ? esc(entry.value) : esc(JSON.stringify(entry.value,null,2));
+      html += `<div class="tc">`;
+      html += `<div class="tc-head" onclick="toggleTc(this)" style="border-left:2px solid var(--amber)">`;
+      html += `<span class="chv">&#9654;</span>`;
+      html += `<span class="tc-name" style="color:var(--amber)">${eKey}</span>`;
+      html += `<span class="tc-label">${eDesc}</span>`;
+      html += `<span class="tc-label" style="margin-left:auto">by ${eBy}</span>`;
+      html += `</div>`;
+      html += `<div class="tc-body">`;
+      html += `<div class="tc-section"><div class="tc-section-label">Value</div><pre style="color:var(--amber)">${eVal}</pre></div>`;
+      html += `</div></div>`;
+    });
+    html += '</div>';
+  }
+
   // Messages
   html += '<div class="messages">';
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: prompt_objects
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Scott Werner
@@ -204,12 +204,9 @@ files:
 - CHANGELOG.md
 - 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
@@ -231,22 +228,22 @@ files:
 - frontend/src/canvas/nodes/PONode.ts
 - frontend/src/canvas/nodes/ToolCallNode.ts
 - frontend/src/canvas/types.ts
-- frontend/src/components/CapabilitiesPanel.tsx
-- frontend/src/components/ChatPanel.tsx
 - frontend/src/components/ContextMenu.tsx
-- frontend/src/components/Dashboard.tsx
-- frontend/src/components/Header.tsx
+- frontend/src/components/EnvDataPane.tsx
+- frontend/src/components/Inspector.tsx
 - frontend/src/components/MarkdownMessage.tsx
-- frontend/src/components/MessageBus.tsx
+- frontend/src/components/MethodList.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/ObjectList.tsx
+- frontend/src/components/PaneSlot.tsx
+- frontend/src/components/SourcePane.tsx
+- frontend/src/components/SystemBar.tsx
+- frontend/src/components/Transcript.tsx
 - frontend/src/components/UsagePanel.tsx
+- frontend/src/components/Workspace.tsx
 - frontend/src/components/index.ts
+- frontend/src/hooks/useResize.ts
 - frontend/src/hooks/useWebSocket.ts
 - frontend/src/index.css
 - frontend/src/main.tsx
@@ -293,8 +290,8 @@ files:
 - 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-6y64NXFy.css
-- lib/prompt_objects/server/public/assets/index-xvyeb-5Z.js
+- lib/prompt_objects/server/public/assets/index-DEPawnfZ.js
+- lib/prompt_objects/server/public/assets/index-oMrRce1m.css
 - lib/prompt_objects/server/public/index.html
 - lib/prompt_objects/server/websocket_handler.rb
 - lib/prompt_objects/session/store.rb
@@ -303,14 +300,19 @@ files:
 - 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/delete_env_data.rb
 - lib/prompt_objects/universal/delete_primitive.rb
+- lib/prompt_objects/universal/get_env_data.rb
 - lib/prompt_objects/universal/list_capabilities.rb
+- lib/prompt_objects/universal/list_env_data.rb
 - lib/prompt_objects/universal/list_primitives.rb
 - lib/prompt_objects/universal/modify_primitive.rb
 - lib/prompt_objects/universal/modify_prompt.rb
 - lib/prompt_objects/universal/remove_capability.rb
 - lib/prompt_objects/universal/request_primitive.rb
+- lib/prompt_objects/universal/store_env_data.rb
 - lib/prompt_objects/universal/think.rb
+- lib/prompt_objects/universal/update_env_data.rb
 - lib/prompt_objects/universal/verify_primitive.rb
 - objects/coordinator.md
 - objects/greeter.md