How manohareldhandi/model-worklog works
Model Logger captures privacy-conscious traces from instrumented agent workflows, stores them in a local supervisor, and exposes them through VS Code, the CLI, and APIs. The primary path is SDK instrumentation and delivery, collector ingestion and persistence, then trace review or captured-log queries. The repository also includes session-based Codex/Copilot supervision and an SDK RAG layer for searching and answering questions about captured activity. Some implementation details are unsampled; edges below rely on the excerpts or README documentation, and optional integrations are dashed.
Main entry points: engine.ts SDK RAG · runtime.ts Trace runtime · http.ts HTTP collector · database.ts Trace storage
Components 28
Tracing SDK
- Trace capture
packages/adapter-sdk/src/tracing/processor.ts - Trace delivery
packages/adapter-sdk/src/tracing/exporter.ts - Vendor adapters
packages/adapter-sdk/src/vendorAdapters.ts - Local API client
packages/adapter-sdk/src/index.ts
Local supervisor
- HTTP collector
apps/local-supervisor/src/traces/http.ts - OTLP ingestion
apps/local-supervisor/src/traces/otlp/transport.ts - Trace runtime
apps/local-supervisor/src/traces/runtime.ts - Trace storage
apps/local-supervisor/src/traces/infrastructure/database.ts - Privacy controls
apps/local-supervisor/src/traces/domain/privacy.ts - Supervisor service
apps/local-supervisor/src/service.ts - Codex relay
apps/local-supervisor/src/codexRelay.ts - Copilot relay
apps/local-supervisor/src/copilotRelay.ts
Log retrieval
- Log query API
apps/local-supervisor/src/traces/application/logQuery.ts - Query planning
apps/local-supervisor/src/traces/domain/queryPlanner.ts - Evidence search
apps/local-supervisor/src/traces/infrastructure/logQueryRepository.ts - SDK RAG
packages/adapter-sdk/src/rag/engine.ts - RAG chunking
packages/adapter-sdk/src/rag/chunking.ts - Embeddings
packages/adapter-sdk/src/rag/embedding.ts - Answer provider
packages/adapter-sdk/src/rag/answerer.ts
User interfaces
- VS Code traces
apps/vscode-extension/src/traceController.ts - CLI
apps/cli/src/cli.ts
Shared event model
- Trace schemas
packages/event-schema/src/trace.ts - Activity projection
packages/event-schema/src/activityLog.ts
Other components
- Agent developer
- Instrumented agent
- Log reviewer
- Chroma vector store
- Answer model
Connections 27
- Agent developer → Instrumented agent: instruments
README.md - Instrumented agent → Trace capture: emits spans
README.md - Trace capture → Trace delivery: delivers traces
- Vendor adapters → Trace capture: instruments vendors
- Trace delivery → HTTP collector: sends traces
README.md - HTTP collector → Trace runtime: routes trace requests
apps/local-supervisor/src/server.ts - Trace runtime → Trace storage: persists traces
- Trace runtime → Privacy controls: applies privacy
- OTLP ingestion → Trace runtime: accepts OTLP
README.md - Trace storage → Trace schemas: stores spans
- Trace schemas → Activity projection: projects activity
packages/event-schema/src/activityLog.ts - Log reviewer → VS Code traces: reviews traces
README.md - VS Code traces → Trace storage: reads trace pages
README.md - Log reviewer → CLI: uses commands
README.md - CLI → HTTP collector: queries local API
- Local API client → HTTP collector: requests traces
packages/adapter-sdk/src/index.ts - Log reviewer → Log query API: asks captured logs
README.md - Log query API → Query planning: plans retrieval
apps/local-supervisor/src/traces/application/logQuery.ts - Log query API → Evidence search: retrieves evidence
- Evidence search → Trace storage: searches spans
apps/local-supervisor/src/traces/infrastructure/logQueryRepository.ts - SDK RAG → RAG chunking: chunks spans
packages/adapter-sdk/src/rag/engine.ts - SDK RAG → Embeddings: embeds content
- SDK RAG → Chroma vector store: searches vectors
README.md - SDK RAG → Answer provider: generates cited answers
packages/adapter-sdk/src/rag/engine.ts - Answer provider → Answer model: requests generation
- Supervisor service → Codex relay: dispatches Codex
apps/local-supervisor/src/service.ts - Supervisor service → Copilot relay: dispatches Copilot
apps/local-supervisor/src/service.ts