How rudrao2/faraday works
Faraday is a local, governed AI workbench for confidential industrial tasks. An operator submits a request through the harness; the plugin classifies and scores it, dispatches it to an eligible local model, and shapes the turn for images, coding, or helper-agent work. Tools can produce files, while the seal governs network-capable calls and records outcomes for audit and on-screen evidence. The graph reflects the README and sampled modules; several documented capabilities, including sandbox execution and some deliverable formats, are represented only at their supported enclosing paths because their implementations were not sampled.
Main entry points: index.js Plugin host · llm-adapter.js LLM adapter · tool.js Approval-note tool · dispatch.js Turn dispatch
Components 29
Operator experience
- Workbench panels
plugins/dsh-client-ui-base/lib/client.js - Plugin host
plugins/dsh-client-ui-base/lib/index.js
Routing and fleet
- Task classifier
plugins/dsh-client-ui-base/lib/router/classify.js - Fleet scorer
plugins/dsh-client-ui-base/lib/router/score.js - Turn dispatch
plugins/dsh-client-ui-base/lib/router/dispatch.js - Fleet registry
plugins/dsh-client-ui-base/lib/registry/fleet.js - Licence gate
plugins/dsh-client-ui-base/lib/registry/loader.js
Inference and lanes
- LLM adapter
plugins/dsh-client-ui-base/lib/model-plane/llm-adapter.js - Provider contract
plugins/dsh-client-ui-base/lib/model-plane/model-provider.js - Local provider
plugins/dsh-client-ui-base/lib/model-plane/local-provider.js - Replay provider
plugins/dsh-client-ui-base/lib/model-plane/replay-provider.js - Image resolver
plugins/dsh-client-ui-base/lib/attachments/images.js - Code lane
plugins/dsh-client-ui-base/lib/lanes/code.js - Helper-agent lane
plugins/dsh-client-ui-base/lib/lanes/fanout.js
Governance and evidence
- Egress seal
plugins/dsh-client-ui-base/lib/egress/seal.js - Audit trail
plugins/dsh-client-ui-base/lib/deliverables/audit-trail.js - Turn trace
plugins/dsh-client-ui-base/lib/trace/turn.js - Residency RPC
plugins/dsh-client-ui-base/lib/trace/rpc.js
Tools and outputs
- Approval-note tool
plugins/dsh-client-ui-base/lib/deliverables/tool.js - DOCX generator
plugins/dsh-client-ui-base/lib/deliverables/docx.js - Other deliverables
plugins/dsh-client-ui-base/lib/deliverables - Code sandbox
plugins/dsh-client-ui-base/lib/lanes/code.js
Other components
- Operator
- Harness host
- llama-swap fleet
runtime/llama-swap.config.yaml - Harness attachments
- Session event log
- Local filesystem
- External network
Connections 33
- Operator → Workbench panels: submits request
- Workbench panels → Harness host: uses host UI
- Harness host → Plugin host: loads plugin
- Plugin host → Task classifier: classifies request
- Plugin host → Fleet scorer: scores fleet
- Fleet scorer → Fleet registry: reads members
- Plugin host → Licence gate: loads eligible fleet
- Licence gate → Fleet registry: checks licences
- Plugin host → Session event log: records route
- LLM adapter → Turn dispatch: resolves model
- Turn dispatch → Fleet registry: reads members
- LLM adapter → Image resolver: resolves attachments
- Image resolver → Harness attachments: reads image data
- LLM adapter → Code lane: shapes coding turns
- LLM adapter → Helper-agent lane: plans helper work
- LLM adapter → Provider contract: requests generation
- Local provider → llama-swap fleet: sends inference
- llama-swap fleet → Local provider: streams responses
- Replay provider → Provider contract: provides cached answers
- Plugin host → Egress seal: checks egress state
- Egress seal → Session event log: records seal changes
- Plugin host → External network: permits or denies calls
- LLM adapter → Turn trace: records turn details
- Residency RPC → Local provider: checks residency
- Residency RPC → Turn dispatch: reads dispatch
- Workbench panels → Residency RPC: requests trace
- Approval-note tool → Audit trail: builds provenance
- Approval-note tool → Turn dispatch: reads routing evidence
- Approval-note tool → Turn trace: reads turn evidence
- Approval-note tool → DOCX generator: generates approval note
- DOCX generator → Local filesystem: writes document
- Code sandbox → Local filesystem: executes code locally
- Harness host → Other deliverables: dispatches tools