William Valentin
144 lines
3.4 KiB
Markdown
144 lines
3.4 KiB
Markdown
# Symbol Index (Agent Quick-Jump)
|
|
|
|
This is a curated index of the most important exported types and functions, organized for fast navigation.
|
|
|
|
It is intentionally short: if something isn't here, it's probably not a primary control surface.
|
|
|
|
See also:
|
|
|
|
- `docs/architecture/TYPESCRIPT_MAP.md` (conceptual map + diagrams)
|
|
- `docs/architecture/AGENT_DIAGRAM.md` (runtime flow)
|
|
|
|
## Daemon Entry Points
|
|
|
|
- `src/daemon/index.ts`
|
|
- Creates/wires: config, tool registry, tool executor, skill registry, model router, gateway, channels.
|
|
|
|
- `src/daemon/routing.ts`
|
|
- `createMessageRouter(deps)`
|
|
- Main router factory used by channel adapters + gateway.
|
|
|
|
## Routing / Intents / Agents
|
|
|
|
- `src/agents/router.ts`
|
|
- `AgentRouter.resolve(channel, senderId)`
|
|
- Picks an agent config for a sender/channel.
|
|
|
|
- `src/agents/registry.ts`
|
|
- `AgentConfigRegistry.get(name)`
|
|
- Loads agent configs.
|
|
|
|
- `src/intents/registry.ts`
|
|
- `IntentRegistry.match(text)`
|
|
- Matches text to intent rules (targets: agent or skill).
|
|
|
|
## Native Agent Loop
|
|
|
|
- `src/backends/native/orchestrator.ts`
|
|
- `AgentOrchestrator.process(message, options)`
|
|
- Top-level entry for “run agent on this message”.
|
|
|
|
- `src/backends/native/agent.ts`
|
|
- `NativeAgent` (class)
|
|
- Internal hot path: tool loop that:
|
|
- asks model
|
|
- executes tools
|
|
- returns tool results
|
|
- repeats
|
|
|
|
## Models
|
|
|
|
- `src/models/router.ts`
|
|
- `ModelRouter.chat(request)`
|
|
- Chooses tier/provider fallback chain.
|
|
|
|
- `src/models/types.ts`
|
|
- Core request/response types shared by providers.
|
|
|
|
## Tools
|
|
|
|
- `src/tools/types.ts`
|
|
- `Tool`
|
|
- `ToolResult`
|
|
|
|
- `src/tools/registry.ts`
|
|
- `ToolRegistry.register(tool)`
|
|
- `ToolRegistry.list()`
|
|
- `ToolRegistry.clone()` / `ToolRegistry.replace(tool)` (used for sandbox substitution)
|
|
|
|
- `src/tools/policy.ts`
|
|
- `ToolPolicy` (class)
|
|
- `ToolPolicy.resolveAllowedNames(allToolNames, context)`
|
|
- `ToolPolicyContext` (type)
|
|
- `TOOL_GROUPS` (group expansion)
|
|
|
|
- `src/tools/executor.ts`
|
|
- `ToolExecutor.execute(toolName, args, context)`
|
|
- Central enforcement point:
|
|
- policy allow/deny
|
|
- hooks/autonomy confirmations
|
|
- skill fs/net/secret constraints
|
|
- untrusted-content injection guard
|
|
- audit events w/ redaction
|
|
|
|
## Skills
|
|
|
|
- `src/skills/types.ts`
|
|
- `SkillManifest`
|
|
- `SkillPermissions`
|
|
|
|
- `src/skills/loader.ts`
|
|
- `loadSkill(dir, tier)`
|
|
- `loadAllSkills(...)`
|
|
- Validates manifests.
|
|
|
|
- `src/skills/registry.ts`
|
|
- `SkillRegistry.get(name)`
|
|
- `SkillRegistry.getSystemPromptAdditions()`
|
|
|
|
## Hooks / Approval
|
|
|
|
- `src/hooks/engine.ts`
|
|
- `HookEngine.getAction(toolName)`
|
|
- `HookEngine.requestConfirmation(toolName, args)`
|
|
|
|
- `src/hooks/autonomy.ts`
|
|
- `resolveAutonomy(toolName, baseAction, autonomyLevel)`
|
|
|
|
## Sandbox
|
|
|
|
- `src/sandbox/manager.ts`
|
|
- Manages per-session sandbox lifecycle.
|
|
|
|
- `src/sandbox/tools.ts`
|
|
- Creates sandboxed tool implementations for `shell.exec` / `process.start`.
|
|
|
|
- `src/sandbox/docker.ts`
|
|
- Docker-specific implementation.
|
|
|
|
## Audit
|
|
|
|
- `src/audit/index.ts`
|
|
- `auditLogger` singleton.
|
|
|
|
- `src/audit/types.ts`
|
|
- Event types (`tool.start`, `tool.success`, `tool.denied`, `tool.approval`, ...)
|
|
|
|
- `src/audit/logger.ts`
|
|
- `AuditLogger` methods: `toolStart`, `toolDenied`, `toolApproval`, ...
|
|
|
|
- `src/audit/redact.ts`
|
|
- `redactForAudit(value)`
|
|
|
|
## Gateway
|
|
|
|
- `src/gateway/server.ts`
|
|
- WebSocket server lifecycle.
|
|
|
|
- `src/gateway/handlers/*`
|
|
- JSON-RPC methods grouped by area.
|
|
|
|
Protocol:
|
|
|
|
- `docs/api/PROTOCOL.md`
|