How goodmanbrio/wsdknpsoas works
PSOAS is an interactive LLM-orchestrated financial research and charting application. A user query enters the harness, which dispatches tools; the main documented workflow designs financial-data stencils, extracts and computes values from ingested company documents, then optionally plans and renders charts. Separate branches provide general research and a legacy PMS1 pipeline. The graph follows the README for PMS2 orchestration; several implementation details, including storage wiring and research internals, were not sampled, so uncertain links are omitted.
Main entry points: execute_tool.py Tool Dispatcher · pms2.py PMS2 Pipeline · agent_loop.py Agent Loop · dispatcher.py Firm Dispatcher
Components 24
Orchestration
- CLI Entry
src/psoas.py - Agent Loop
src/harness/agent_loop.py - Tool Dispatcher
src/harness/execute_tool.py - Opaque Registry
src/harness/opaque_registry.py - Terminal Router
src/harness/terminal_router.py - LLM Backend
src/scripts/llm.py
PMS2 Extraction
- PMS2 Pipeline
src/scripts/PMS2/pms2.py - Stencil Design
src/scripts/PMS2/sekei_loop.py - File Discovery
src/scripts/PMS2/mapper.py - Firm Dispatcher
src/scripts/PMS2/dispatcher.py - Batch Planner
src/scripts/PMS2/batch_planner.py - Chunk Extraction
src/scripts/PMS2/leng_caller.py - Chunk Validation
src/scripts/PMS2/validator_loop.py - Merge and Compute
src/scripts/PMS2/merge_compute.py
Document Preparation
- Document Ingest
src/scripts/PMS2/00_Ingest.py - Document Chunking
src/scripts/PMS2/01_Chunk.py
Charting
- Chart Planner
src/tools/tool_pteca.py - Chart Renderer
src/scripts/stencil2chart.py
Other Tools
- Research Pipeline
src/scripts/research - Legacy PMS1
src/tools/tool_pms1.py - PMS1 Index Store
src/scripts/Poony_Multiretrieval_S1/src/index_store.py
Other components
- User
- Financial Documents
- Chart Output
Connections 23
- User → CLI Entry: submits query
- CLI Entry → Agent Loop: starts
- Agent Loop → LLM Backend: requests decisions
- Agent Loop → Tool Dispatcher: dispatches tools
- Tool Dispatcher → Opaque Registry: stores results
- Agent Loop → Terminal Router: routes interaction
- Tool Dispatcher → PMS2 Pipeline: runs extraction
- PMS2 Pipeline → Stencil Design: designs stencils
- PMS2 Pipeline → File Discovery: discovers files
- PMS2 Pipeline → Firm Dispatcher: dispatches firms
- Firm Dispatcher → Batch Planner: plans batches
- Firm Dispatcher → Chunk Extraction: extracts chunks
- Chunk Extraction → Chunk Validation: validates chunks
- PMS2 Pipeline → Merge and Compute: merges and computes
- Financial Documents → Document Ingest: converts documents
- Document Ingest → Document Chunking: provides markdown
- Tool Dispatcher → Chart Planner: plans charts
- Chart Planner → LLM Backend: requests chart choices
- Tool Dispatcher → Chart Renderer: renders chart
- Chart Renderer → Chart Output: produces chart
- Tool Dispatcher → Research Pipeline: runs research
- Tool Dispatcher → Legacy PMS1: runs legacy pipeline
- Legacy PMS1 → PMS1 Index Store: loads index