prompt_objects 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6dd3c14942ef80d1979ded542802ad9d1a24b32cd479aa4ba0a08bb0bf2e349d
-  data.tar.gz: 3642d5424aa827754dfefde82a9e9e5c770935ebf08e36cfc429d8f86e5e8502
+  metadata.gz: 1e9bb13a5f2b407279723343fe43ce570119e64a3fe2a115e4f427d195ec7040
+  data.tar.gz: fc1300754c1774ec388928752b84dd8a60286659904b8b72053fde457842ea71
 SHA512:
-  metadata.gz: f4e4449d2a8764a762c13ea14b6ccac17b07d1ae06a053a94e5b66ce7ebf38b8ca2903c140f0bb06810e09fa830bdac1dcfb8485d2f6f7fe32f7b0dffdf374bb
-  data.tar.gz: 1faa31a8c32f067cdfb133c06e6c3d45e55fec3381d86f649e8845b9d2c58bc367e2bed3821cbec4a92a18776b723ccf69c276f9e913347198816005c4608353
+  metadata.gz: 56e4a427b43b49fc7520f9268a3e31c4a81d39c50ad0329985ab9d678631a2a88c41d070a7e13d97c01e2328de56e917d59b2b06c078fef9174a5a7fdc5db87b
+  data.tar.gz: a6bb7914d1b58c8c445deae870c2a06c004b9e7604b72107574f89c7ea9da2b8172034c358078b920d52b57eefe24acb68668d7057f16e61ed2e62ee2a85ca95

data/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to PromptObjects are documented in this file.
 
+## [0.6.0] - 2026-02-17
+
+### Added
+
+- **Shared environment data** — 5 new universal capabilities (`store_env_data`, `get_env_data`, `list_env_data`, `update_env_data`, `delete_env_data`) provide a thread-scoped key-value store for delegation chains. Data is scoped to the root thread so separate conversations stay isolated. Entries include a `short_description` for lightweight LLM discovery without fetching full values.
+- **Live environment data pane** — New collapsible pane in the Inspector shows shared env data updating in real-time as POs store and modify entries during delegation chains. WebSocket broadcasting (`env_data_changed`, `env_data_list`), a REST endpoint (`GET /api/sessions/:id/env_data`), and env data rendering in the Thread Explorer.
+- **Delegation context** — POs now receive context about their delegation chain. An expanded system prompt teaches POs about their nature, a delegation preamble prepends caller context to delegated messages, and the full delegation chain is built from thread lineage.
+- **Capability guard** — `execute_tool_calls` now rejects tools not in a PO's allowed set (declared capabilities + universals). Previously the LLM could hallucinate calls to any registered tool and they would execute. Now it receives an error directing it to use `add_capability` first.
+- **Env data in thread exports** — `serialize_tree_for_export` includes env data entries at the root level of exported thread trees. Thread Explorer renders these in an amber-colored section.
+
+### Fixed
+
+- **Root font-size causing undersized text** — Removed a `font-size: 14px` on the root `html` element that made all rem-based Tailwind sizes ~12% smaller than intended (e.g. `text-xs` computed to 10.5px instead of 12px).
+- **Invisible resize handle boundaries** — Added border styling to horizontal and vertical resize handles so pane boundaries are visible without hovering.
+- **Stale MCP tools tests** — Fixed test expectations broken by PO serialization centralization in 0.5.0.
+
 ## [0.5.0] - 2026-02-13
 
 ### Added

data/CLAUDE.md

@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 **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**: v0.5.0 — The core framework is fully implemented and functional. The original 6-phase implementation plan is complete. Active development is focused on visualization, developer experience, and exploring new primitives. See `CHANGELOG.md` for release history and `design-doc-v2.md` / `IMPLEMENTATION_PLAN.md` for original design context.
+**Current Status**: v0.5.0 — The core framework is fully implemented and functional. The original 6-phase implementation plan is complete. Active development is focused on visualization, developer experience, and exploring new primitives. See `CHANGELOG.md` for release history and `docs/archive/` for original design context.
 
 ## Architecture
 
@@ -19,7 +19,7 @@ RUNTIME (Environment)
 ├── MESSAGE BUS - routes messages, logs to SQLite for replay
 ├── SESSION STORE (SQLite) - persistent conversation threads, delegation tracking
 ├── HUMAN QUEUE - non-blocking ask_human requests
-├── WEB SERVER (Sinatra + WebSocket) - serves React frontend
+├── WEB SERVER (Falcon + async-websocket) - serves React frontend
 └── MCP SERVER - exposes POs as tools via Model Context Protocol
 ```
 
@@ -61,6 +61,7 @@ Available to all Prompt-Objects automatically (no frontmatter declaration needed
 - `list_capabilities` / `list_primitives` - introspection
 - `create_primitive` / `add_primitive` / `delete_primitive` / `verify_primitive` / `modify_primitive` / `request_primitive` - primitive management
 - `modify_prompt` - rewrite own system prompt at runtime
+- `store_env_data` / `get_env_data` / `list_env_data` / `update_env_data` / `delete_env_data` - thread-scoped shared key-value store for delegation chains
 
 ### PO-to-PO Delegation
 When a PO calls another PO, the system creates an isolated delegation thread in the target PO. The caller's context is tracked so messages show correct provenance. Delegation start/complete events are broadcast via WebSocket for real-time UI updates.
@@ -69,9 +70,9 @@ When a PO calls another PO, the system creates an isolated delegation thread in
 
 - **Ruby** (>= 3.2, tested through Ruby 4) - core implementation
 - **LLM APIs** - OpenAI, Anthropic, Gemini, Ollama, OpenRouter (adapter pattern via `LLM::Factory`)
-- **Sinatra** - web server for REST API and static file serving
-- **faye-websocket** - real-time WebSocket communication
-- **React + TypeScript** - web frontend (dashboard, chat, capabilities panel)
+- **Falcon** - async HTTP server for REST API and static file serving
+- **async-websocket** - real-time WebSocket communication
+- **React + TypeScript** - web frontend (Smalltalk System Browser-inspired multi-pane UI)
 - **Three.js** - spatial canvas visualization (force-directed PO graph)
 - **SQLite** - session persistence and event log storage
 - **MCP** - Model Context Protocol server mode
@@ -121,7 +122,7 @@ prompt_objects/
 ├── frontend/                       # React + TypeScript web UI
 │   └── src/
 │       ├── App.tsx
-│       ├── components/             # Dashboard, chat, capabilities panel
+│       ├── components/             # SystemBar, ObjectList, Inspector, Workspace, Transcript
 │       ├── canvas/                 # Three.js spatial visualization
 │       ├── hooks/                  # WebSocket, state management hooks
 │       ├── store/                  # Frontend state

data/README.md

@@ -12,11 +12,6 @@ Prompt Objects applies this to AI. Instead of treating LLMs as external APIs you
 
 This is a new computing primitive: semantic late binding at runtime, where natural language becomes the interface between intelligent components.
 
-Blog Posts
-==========
-
-- [What if we took message passing seriously?](https://worksonmymachine.ai/p/what-if-we-took-message-passing-seriously) — The origin story and motivation behind Prompt Objects.
-
 Who
 ===
 
@@ -32,8 +27,86 @@ A Ruby framework where:
 - **Markdown files** define autonomous entities (Prompt Objects)
 - **YAML frontmatter** declares capabilities and configuration
 - **Markdown body** becomes identity and behavior (the system prompt)
-- **Capabilities** are shared between primitives (Ruby) and Prompt Objects (markdown)
-- **Environments** isolate collections of objects with their own memory
+- **Capabilities** are shared between primitives (Ruby) and Prompt Objects (markdown) -- everything is a capability
+- **Environments** isolate collections of objects with their own memory, git history, and configuration
+- **PO-to-PO delegation** lets objects call each other through isolated threads with full provenance tracking
+
+### Prompt Object structure
+
+```markdown
+---
+name: reader
+description: Helps people understand files
+capabilities:
+  - read_file
+  - list_files
+---
+
+# Reader
+## Identity
+You are a careful, thoughtful file reader...
+```
+
+### Web UI
+
+The web interface is modeled after the Smalltalk System Browser -- a multi-pane environment for inspecting and interacting with live objects:
+
+- **ObjectList** -- permanent left pane listing all POs in the environment
+- **Inspector** -- split into a MethodList (capabilities) and SourcePane (the prompt markdown or capability source)
+- **Workspace** -- a REPL-style chat pane for sending messages to the selected PO
+- **Transcript** -- bottom pane showing message bus events in real time
+
+All panels are resizable. The inspector's top pane collapses so the Workspace can fill the full height when you just want to talk.
+
+### Spatial Canvas
+
+Navigate to `/canvas` for a Three.js 2D visualization of your environment. POs appear as glowing hexagonal nodes in a force-directed layout. Tool calls show as diamonds. Message arcs animate with traveling particles. Delegation lights up the target PO with a cyan glow. Click any node to inspect it. Keyboard shortcuts: F to fit, Escape to deselect.
+
+### MCP Server mode
+
+Run any environment as an MCP (Model Context Protocol) server for integration with Claude Desktop, Cursor, or any MCP-compatible client:
+
+```bash
+prompt_objects serve my-assistant --mcp
+```
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "my-assistant": {
+      "command": "prompt_objects",
+      "args": ["serve", "--mcp", "my-assistant"]
+    }
+  }
+}
+```
+
+Exposes tools for sending messages, listing POs, inspecting state, getting conversations, and responding to pending `ask_human` requests.
+
+### Multi-provider LLM support
+
+Swap providers with an environment variable. Adapters for:
+
+- **OpenAI** -- GPT-5.2, GPT-4.1, o3-mini, o1
+- **Anthropic** -- Claude Haiku 4.5, Claude Sonnet 4.5, Claude Opus 4
+- **Gemini** -- Gemini 3 Flash, Gemini 2.5 Pro, Gemini 2.5 Flash
+- **Ollama** -- any locally installed model, discovered automatically
+- **OpenRouter** -- access any model through a single API key
+
+### Thread Explorer
+
+A standalone HTML visualizer for exported conversation threads. Open it from the CLI to browse delegation chains, message flow, and tool call sequences:
+
+```bash
+prompt_objects explore my-env
+prompt_objects explore my-env --session abc123
+```
+
+### Note on the TUI
+
+A terminal UI (built with Charm libraries) exists in the codebase but is deprioritized. The web UI is the primary interface for day-to-day use.
 
 How
 ===
@@ -54,25 +127,73 @@ prompt_objects env create my-project --template basic
 prompt_objects serve my-project --open
 ```
 
-### Environment Commands
+### Commands
 
-```bash
-prompt_objects env list              # List all environments
-prompt_objects env create <name>     # Create new environment
-prompt_objects env info <name>       # Show environment details
-prompt_objects env clone <src> <dst> # Clone an environment
+```
+prompt_objects serve <env>                  Start web server (default)
+prompt_objects serve <env> --open           Start and open browser
+prompt_objects serve <env> --mcp            Start as MCP server
+prompt_objects serve <env> --port 4000      Custom port (default: 3000)
+
+prompt_objects repl [name] [objects_dir]    Interactive REPL with a prompt object
+prompt_objects repl --sandbox               REPL in sandbox mode (isolates changes)
+
+prompt_objects message <env> <po> "text"    Send a message and print the response
+prompt_objects message <env> <po> "text" --json     JSON output
+prompt_objects message <env> <po> "text" --events   Include event log
+
+prompt_objects events <env>                 Show recent message bus events
+prompt_objects events <env> --session ID    Events for a specific session
+prompt_objects events <env> --json          JSON output
+
+prompt_objects explore [env]                Open Thread Explorer in browser
+prompt_objects explore <env> --session ID   Visualize a specific thread
+```
+
+### Environment management
+
+```
+prompt_objects env list                     List all environments
+prompt_objects env create <name>            Create new environment
+prompt_objects env create <name> -t <tmpl>  Create from template
+prompt_objects env info <name>              Show environment details
+prompt_objects env clone <src> <dst>        Clone an environment
+prompt_objects env export <name>            Export as .poenv bundle
+prompt_objects env import <file.poenv>      Import from bundle
+prompt_objects env archive <name>           Soft-delete (archive)
+prompt_objects env restore <name>           Restore archived environment
+prompt_objects env delete <name> --permanent  Permanently delete archived env
+prompt_objects env default <name>           Set the default environment
 ```
 
 ### Templates
 
-- `basic` - No capabilities, learns as needed (great for demos)
-- `minimal` - Basic assistant with file reading
-- `developer` - Code review, debugging, testing specialists
-- `writer` - Editor, researcher for content creation
+Create an environment from a template with `prompt_objects env create <name> --template <template>`:
+
+| Template | Description |
+|---|---|
+| `basic` | No capabilities, learns as needed -- great for demos |
+| `minimal` | Basic assistant with file reading |
+| `developer` | Code review, debugging, testing specialists |
+| `writer` | Editor, researcher for content creation |
+| `empty` | Start from scratch with just a bootstrap assistant |
+| `arc-agi-1` | ARC-AGI-1 challenge solver with grid primitives |
 
 Extras
 ======
 
-- **License**: MIT
-- **Ruby**: >= 3.2.0
+### Community
+
+Join the [Discord](https://discord.gg/fcMvcwdrZS) for support, discussion, and updates.
+
+### Blog Posts
+
+- [What if we took message passing seriously?](https://worksonmymachine.ai/p/what-if-we-took-message-passing-seriously) -- the origin story and motivation behind Prompt Objects
+- [As complexity grows, architecture](https://worksonmymachine.ai/p/as-complexity-grows-architecture) -- on why the hard problems are structural, not generative
+
+### Links
+
 - **Repository**: https://github.com/works-on-your-machine/prompt_objects
+- **Changelog**: https://github.com/works-on-your-machine/prompt_objects/blob/main/CHANGELOG.md
+- **License**: MIT
+- **Ruby**: >= 3.2.0 (tested through Ruby 4)

data/frontend/src/App.tsx

@@ -10,7 +10,7 @@ import { UsagePanel } from './components/UsagePanel'
 import { CanvasView } from './canvas/CanvasView'
 
 export default function App() {
-  const { sendMessage, respondToNotification, createSession, switchSession, switchLLM, createThread, updatePrompt, requestUsage, exportThread } =
+  const { sendMessage, respondToNotification, createSession, switchSession, switchLLM, createThread, updatePrompt, requestUsage, exportThread, requestEnvData } =
     useWebSocket()
   const { selectedPO, busOpen, notifications, usageData, clearUsageData, currentView } = useStore()
   const selectedPOData = useSelectedPO()
@@ -64,6 +64,7 @@ export default function App() {
                     updatePrompt={updatePrompt}
                     requestUsage={requestUsage}
                     exportThread={exportThread}
+                    requestEnvData={requestEnvData}
                   />
                 ) : (
                   <div className="h-full flex items-center justify-center text-po-text-ghost">

data/frontend/src/components/EnvDataPane.tsx

@@ -0,0 +1,69 @@
+import { useState, useEffect } from 'react'
+import { useStore, useEnvData } from '../store'
+import type { EnvDataEntry } from '../types'
+
+interface EnvDataPaneProps {
+  sessionId: string | undefined
+  requestEnvData: (sessionId: string) => void
+}
+
+export function EnvDataPane({ sessionId, requestEnvData }: EnvDataPaneProps) {
+  const sessionRootMap = useStore((s) => s.sessionRootMap)
+  const rootThreadId = sessionId ? sessionRootMap[sessionId] : undefined
+  const entries = useEnvData(rootThreadId)
+  const [expandedKey, setExpandedKey] = useState<string | null>(null)
+
+  useEffect(() => {
+    if (sessionId) {
+      requestEnvData(sessionId)
+    }
+  }, [sessionId, requestEnvData])
+
+  if (entries.length === 0) {
+    return (
+      <div className="h-full flex items-center justify-center">
+        <span className="font-mono text-xs text-po-text-ghost">No shared data</span>
+      </div>
+    )
+  }
+
+  return (
+    <div className="h-full overflow-auto px-2 py-1">
+      {entries.map((entry) => (
+        <EnvDataRow
+          key={entry.key}
+          entry={entry}
+          expanded={expandedKey === entry.key}
+          onToggle={() => setExpandedKey(expandedKey === entry.key ? null : entry.key)}
+        />
+      ))}
+    </div>
+  )
+}
+
+function EnvDataRow({ entry, expanded, onToggle }: { entry: EnvDataEntry; expanded: boolean; onToggle: () => void }) {
+  return (
+    <div className="border-b border-po-border last:border-b-0">
+      <button
+        onClick={onToggle}
+        className="w-full text-left px-1.5 py-1.5 hover:bg-po-surface-3 transition-colors duration-150 flex items-center gap-2"
+      >
+        <span className="text-2xs text-po-text-ghost">{expanded ? '▼' : '▶'}</span>
+        <span className="font-mono text-sm text-po-accent truncate">{entry.key}</span>
+        <span className="text-xs text-po-text-ghost truncate flex-1">{entry.short_description}</span>
+        <span className="text-xs text-po-text-ghost flex-shrink-0">{entry.stored_by}</span>
+      </button>
+      {expanded && (
+        <div className="px-2 pb-2">
+          <div className="text-xs text-po-text-ghost mb-1">
+            stored by <span className="text-po-text-secondary">{entry.stored_by}</span>
+            {entry.updated_at && <> &middot; {new Date(entry.updated_at).toLocaleTimeString()}</>}
+          </div>
+          <pre className="font-mono text-xs text-po-text-primary bg-po-surface-1 rounded p-2 overflow-auto max-h-40 whitespace-pre-wrap break-all">
+            {typeof entry.value === 'string' ? entry.value : JSON.stringify(entry.value, null, 2)}
+          </pre>
+        </div>
+      )}
+    </div>
+  )
+}

data/frontend/src/components/Inspector.tsx

@@ -1,8 +1,9 @@
 import { useState, useMemo } from 'react'
-import { useStore, usePONotifications } from '../store'
+import { useStore, usePONotifications, useEnvData } from '../store'
 import { useResize } from '../hooks/useResize'
 import { MethodList } from './MethodList'
 import { SourcePane } from './SourcePane'
+import { EnvDataPane } from './EnvDataPane'
 import { Workspace } from './Workspace'
 import { ContextMenu } from './ContextMenu'
 import { PaneSlot } from './PaneSlot'
@@ -17,6 +18,7 @@ interface InspectorProps {
   updatePrompt: (target: string, prompt: string) => void
   requestUsage?: (sessionId: string, includeTree?: boolean) => void
   exportThread?: (sessionId: string, format?: string) => void
+  requestEnvData: (sessionId: string) => void
 }
 
 export function Inspector({
@@ -27,6 +29,7 @@ export function Inspector({
   updatePrompt,
   requestUsage,
   exportThread,
+  requestEnvData,
 }: InspectorProps) {
   const [selectedCapability, setSelectedCapability] = useState<CapabilityInfo | null>(null)
   const [threadMenuOpen, setThreadMenuOpen] = useState(false)
@@ -34,6 +37,8 @@ export function Inspector({
   const notifications = usePONotifications(po.name)
   const topPaneCollapsed = useStore((s) => s.topPaneCollapsed)
   const toggleTopPane = useStore((s) => s.toggleTopPane)
+  const envDataPaneCollapsed = useStore((s) => s.envDataPaneCollapsed)
+  const toggleEnvDataPane = useStore((s) => s.toggleEnvDataPane)
 
   const topPaneResize = useResize({
     direction: 'vertical',
@@ -42,6 +47,13 @@ export function Inspector({
     maxSize: 600,
   })
 
+  const envDataResize = useResize({
+    direction: 'vertical',
+    initialSize: 160,
+    minSize: 80,
+    maxSize: 400,
+  })
+
   const methodListResize = useResize({
     direction: 'horizontal',
     initialSize: 192,
@@ -51,6 +63,9 @@ export function Inspector({
 
   const sessions = po.sessions || []
   const currentSessionId = po.current_session?.id
+  const sessionRootMap = useStore((s) => s.sessionRootMap)
+  const rootThreadId = currentSessionId ? sessionRootMap[currentSessionId] : undefined
+  const envDataEntries = useEnvData(rootThreadId)
 
   // Sort sessions: current first, then by updated_at desc
   const sortedSessions = useMemo(() => {
@@ -204,6 +219,22 @@ export function Inspector({
         </div>
       </PaneSlot>
 
+      {/* Middle: Env Data (collapsible, resizable height) */}
+      <PaneSlot
+        label={`Env Data${envDataEntries.length > 0 ? ` (${envDataEntries.length})` : ''}`}
+        collapsed={envDataPaneCollapsed}
+        onToggle={toggleEnvDataPane}
+        height={envDataResize.size}
+        resizeHandle={
+          <div
+            className="resize-handle-h"
+            onMouseDown={envDataResize.onMouseDown}
+          />
+        }
+      >
+        <EnvDataPane sessionId={currentSessionId} requestEnvData={requestEnvData} />
+      </PaneSlot>
+
       {/* Bottom: Workspace */}
       <div className="flex-1 overflow-hidden">
         <Workspace po={po} sendMessage={sendMessage} />

data/frontend/src/hooks/useWebSocket.ts

@@ -8,6 +8,7 @@ import type {
   Environment,
   Message,
   LLMConfig,
+  EnvDataEntry,
   SendMessagePayload,
   RespondToNotificationPayload,
   CreateSessionPayload,
@@ -43,6 +44,8 @@ export function useWebSocket() {
     setLLMConfig,
     updateCurrentLLM,
     setUsageData,
+    setEnvData,
+    setSessionRoot,
   } = useStore()
 
   // Keep the handler ref up to date every render
@@ -243,6 +246,29 @@ export function useWebSocket() {
         // Session switch confirmed — po_state update follows with full state
         break
 
+      case 'env_data_changed': {
+        const { root_thread_id, entries } = message.payload as {
+          action: string
+          root_thread_id: string
+          key: string
+          stored_by: string
+          entries: EnvDataEntry[]
+        }
+        setEnvData(root_thread_id, entries)
+        break
+      }
+
+      case 'env_data_list': {
+        const { session_id, root_thread_id, entries } = message.payload as {
+          session_id: string
+          root_thread_id: string
+          entries: EnvDataEntry[]
+        }
+        setEnvData(root_thread_id, entries)
+        setSessionRoot(session_id, root_thread_id)
+        break
+      }
+
       case 'error': {
         const { message: errorMsg } = message.payload as { message: string }
         console.error('Server error:', errorMsg)
@@ -488,6 +514,21 @@ export function useWebSocket() {
     )
   }, [])
 
+  // Request env data for a session
+  const requestEnvData = useCallback((sessionId: string) => {
+    if (!ws.current || ws.current.readyState !== WebSocket.OPEN) {
+      console.error('WebSocket not connected')
+      return
+    }
+
+    ws.current.send(
+      JSON.stringify({
+        type: 'get_env_data_list',
+        payload: { session_id: sessionId },
+      })
+    )
+  }, [])
+
   // Update a PO's prompt (markdown body)
   const updatePrompt = useCallback((target: string, prompt: string) => {
     if (!ws.current || ws.current.readyState !== WebSocket.OPEN) {
@@ -513,5 +554,6 @@ export function useWebSocket() {
     updatePrompt,
     requestUsage,
     exportThread,
+    requestEnvData,
   }
 }

data/frontend/src/index.css

@@ -5,7 +5,6 @@
 /* Base styles */
 html {
   color-scheme: dark;
-  font-size: 14px;
 }
 
 body {
@@ -45,11 +44,11 @@ body {
 
 /* Resize handles */
 .resize-handle {
-  @apply w-1 cursor-col-resize hover:bg-po-accent/30 active:bg-po-accent/50 transition-colors;
+  @apply w-1 cursor-col-resize hover:bg-po-accent/30 active:bg-po-accent/50 transition-colors border-l border-po-border;
 }
 
 .resize-handle-h {
-  @apply h-1 cursor-row-resize hover:bg-po-accent/30 active:bg-po-accent/50 transition-colors;
+  @apply h-1 cursor-row-resize hover:bg-po-accent/30 active:bg-po-accent/50 transition-colors border-t border-po-border;
 }
 
 /* Canvas CSS2DRenderer labels */

data/frontend/src/store/index.ts

@@ -7,6 +7,7 @@ import type {
   Environment,
   Message,
   LLMConfig,
+  EnvDataEntry,
 } from '../types'
 
 interface Store {
@@ -68,6 +69,15 @@ interface Store {
   usageData: Record<string, unknown> | null
   setUsageData: (data: Record<string, unknown>) => void
   clearUsageData: () => void
+
+  // Env Data
+  envData: Record<string, EnvDataEntry[]>
+  setEnvData: (rootThreadId: string, entries: EnvDataEntry[]) => void
+  clearEnvData: (rootThreadId: string) => void
+  sessionRootMap: Record<string, string>
+  setSessionRoot: (sessionId: string, rootThreadId: string) => void
+  envDataPaneCollapsed: boolean
+  toggleEnvDataPane: () => void
 }
 
 export const useStore = create<Store>((set) => ({
@@ -263,6 +273,25 @@ export const useStore = create<Store>((set) => ({
   usageData: null,
   setUsageData: (data) => set({ usageData: data }),
   clearUsageData: () => set({ usageData: null }),
+
+  // Env Data
+  envData: {},
+  setEnvData: (rootThreadId, entries) =>
+    set((s) => ({
+      envData: { ...s.envData, [rootThreadId]: entries },
+    })),
+  clearEnvData: (rootThreadId) =>
+    set((s) => {
+      const { [rootThreadId]: _, ...rest } = s.envData
+      return { envData: rest }
+    }),
+  sessionRootMap: {},
+  setSessionRoot: (sessionId, rootThreadId) =>
+    set((s) => ({
+      sessionRootMap: { ...s.sessionRootMap, [sessionId]: rootThreadId },
+    })),
+  envDataPaneCollapsed: true,
+  toggleEnvDataPane: () => set((s) => ({ envDataPaneCollapsed: !s.envDataPaneCollapsed })),
 }))
 
 // Selectors - use useShallow to prevent infinite re-renders with derived arrays
@@ -277,3 +306,6 @@ export const useNotificationCount = () =>
 
 export const usePONotifications = (poName: string) =>
   useStore(useShallow((s) => s.notifications.filter((n) => n.po_name === poName)))
+
+export const useEnvData = (rootThreadId: string | undefined) =>
+  useStore(useShallow((s) => (rootThreadId ? s.envData[rootThreadId] || [] : [])))

data/frontend/src/types/index.ts

@@ -102,6 +102,15 @@ export interface LLMConfig {
   providers: LLMProvider[]
 }
 
+export interface EnvDataEntry {
+  key: string
+  short_description: string
+  value: unknown
+  stored_by: string
+  created_at: string
+  updated_at: string
+}
+
 // WebSocket message types
 export type WSMessageType =
   | 'environment'
@@ -128,6 +137,8 @@ export type WSMessageType =
   | 'thread_export'
   | 'prompt_updated'
   | 'llm_error'
+  | 'env_data_changed'
+  | 'env_data_list'
   | 'error'
   | 'pong'
 

data/lib/prompt_objects/environment.rb

@@ -42,6 +42,7 @@ module PromptObjects
     attr_accessor :on_po_registered  # Callback for when a PO is registered
     attr_accessor :on_po_modified    # Callback for when a PO is modified (capabilities changed, etc.)
     attr_accessor :on_delegation_event  # Callback for PO-to-PO delegation start/complete
+    attr_accessor :on_env_data_changed  # Callback for env data store/update/delete
 
     # Initialize from an environment path (with manifest) or objects directory.
     # @param env_path [String, nil] Path to environment directory (preferred)
@@ -223,6 +224,15 @@ module PromptObjects
       @on_delegation_event&.call(event_type, payload)
     end
 
+    # Notify that environment data has changed (stored, updated, or deleted).
+    # @param action [String] "store", "update", or "delete"
+    # @param root_thread_id [String] Root thread scope
+    # @param key [String] The data key that changed
+    # @param stored_by [String] PO name that made the change
+    def notify_env_data_changed(action:, root_thread_id:, key:, stored_by:)
+      @on_env_data_changed&.call(action: action, root_thread_id: root_thread_id, key: key, stored_by: stored_by)
+    end
+
     # Load a prompt object by name from the objects directory.
     # @param name [String] Name of the prompt object (without .md extension)
     # @return [PromptObject]
@@ -316,6 +326,11 @@ module PromptObjects
       @registry.register(Universal::ModifyPrimitive.new)
       @registry.register(Universal::RequestPrimitive.new)
       @registry.register(Universal::ModifyPrompt.new)
+      @registry.register(Universal::StoreEnvData.new)
+      @registry.register(Universal::GetEnvData.new)
+      @registry.register(Universal::ListEnvData.new)
+      @registry.register(Universal::UpdateEnvData.new)
+      @registry.register(Universal::DeleteEnvData.new)
     end
   end