operator-main
f2640397ed
- response-harvester: extract [TOOL]/[EXEC] JSON args with balanced-brace
scanning (']' and nesting inside args no longer truncate calls); add
[DM {...}] shorthand mapping to dm.send; native aliases (dm, box,
tools) plus arg-synonym normalization; formatters and expanded hints.
- exec-constrained: new read-only box.exec op (27 allowlisted box-ctl
reads) and tools.list op backed by --list-ops for dynamic discovery.
- prompt_envelope: advertise dm.send/box.exec/tools.list in every timer
DM; add dm_call builder.
- lookup_engine + regex_patterns.json: canonical tool_call pattern
accepts the DM engine, ']' in args, one nesting level.
- tests/test_tool_calls.py: 38 tests; docs/INBAND-MESSAGING-SPEC.md:
accepted decision record (Final).
Internal Agent & Operator Documentation (docs_internal/)
Box is the main surface. All operator work goes through Box (
box.muse-dev.online). The web UI,boxCLI, and agents share the same API endpoints, protocol grammar, and lookup structures.
Welcome to docs_internal/. This directory serves as a dual Markdown (.md) and structured JSON (.json) lookup database for autonomous agents, background daemons, and off-board operators across NetVM.
1. Directory Structure
docs_internal/
├── manifest.json # Master database manifest and collections schema
├── README.md # This file
├── sentence_structure.json # Agent sentence structures, protocols, and grammar
├── SENTENCE-STRUCTURE.md # Comprehensive guide to agent communication protocols
├── regex_patterns.json # Master regular expression database with test fixtures
├── REGEX-PATTERNS.md # Guide to regex parsing, capture groups, and testing
├── assistive_surfaces.json # UI tabs, DOM selectors, data-testids & REST endpoints for box.muse-dev.online
├── SURFACES.md # Guide to interacting with box.muse-dev.online
├── cli_tools.json # CLI command catalog and syntax database
├── CLI-TOOLS.md # Guide to super, box, and muse CLI tools
├── fleet_nodes.json # Fleet node topology, namespaces, and ports
└── FLEET-NODES.md # Guide to fleet agents and network topology
2. Using the CLI Lookup Engine
You can query this database directly from the shell using super docs or box docs:
2.1 Full-Text Search
box docs search "work order"
box docs search "cdp"
2.2 Inspect Assistive Surfaces for box.muse-dev.online
# List all surfaces and views
box docs surfaces
# Inspect a specific surface (e.g. jobs, dms, loops, dashboard)
box docs surfaces jobs
box docs surfaces dms
2.3 Inspect Agent Sentence Grammar & Protocols
# List all sentence structures
box docs sentence
# View full structure specification
box docs sentence work_order
box docs sentence result
2.4 Regex Passing & Testing
# List available regex patterns
box docs regex
# Test a string against a specific pattern
box docs regex work_order --test "[WO:7fce46e0] [from super] Audit — Check status"
# Parse an agent sentence through all patterns to extract captured tokens
box docs parse "[RESULT 7fce46e0] OK Verified 14 endpoints"
2.5 Machine-Readable JSON Output
Add --json to any command for structured JSON output:
box docs sentence work_order --json
box docs surfaces dashboard --json
box docs parse "[CLAIM 7fce46e0]" --json