clew-code 0.2.13 → 0.2.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/main.js +2596 -2527
- package/docs/architecture.html +148 -148
- package/docs/architecture.th.html +79 -79
- package/docs/clew-code-architecture.html +6 -6
- package/docs/commands.html +225 -224
- package/docs/commands.th.html +132 -131
- package/docs/configuration.html +147 -147
- package/docs/configuration.th.html +108 -108
- package/docs/daemon.html +129 -129
- package/docs/daemon.th.html +73 -73
- package/docs/features/bridge-mode.html +99 -99
- package/docs/features/bridge-mode.th.html +90 -90
- package/docs/features/evals.html +182 -182
- package/docs/features/evals.th.html +90 -90
- package/docs/features/peer.html +178 -178
- package/docs/features/searxng-search.html +151 -151
- package/docs/features/searxng-search.th.html +95 -95
- package/docs/features/sentry-setup.html +157 -157
- package/docs/features/sentry-setup.th.html +97 -97
- package/docs/index.html +298 -299
- package/docs/index.th.html +292 -292
- package/docs/installation.html +105 -105
- package/docs/installation.th.html +105 -105
- package/docs/internals/growthbook-ab-testing.html +113 -113
- package/docs/internals/growthbook-ab-testing.th.html +81 -81
- package/docs/internals/hidden-features.html +175 -149
- package/docs/internals/hidden-features.th.html +135 -109
- package/docs/loop.html +181 -181
- package/docs/loop.th.html +227 -227
- package/docs/mcp.html +247 -247
- package/docs/mcp.th.html +207 -207
- package/docs/models.html +110 -111
- package/docs/models.th.html +61 -61
- package/docs/peer.html +236 -236
- package/docs/peer.th.html +280 -280
- package/docs/permission-model.html +102 -102
- package/docs/permission-model.th.html +67 -67
- package/docs/plugins.html +102 -102
- package/docs/plugins.th.html +79 -79
- package/docs/providers.html +126 -126
- package/docs/providers.th.html +80 -80
- package/docs/quick-start.html +93 -93
- package/docs/quick-start.th.html +1 -1
- package/docs/research-memory.html +82 -82
- package/docs/research-memory.th.html +72 -72
- package/docs/skills.html +117 -117
- package/docs/skills.th.html +90 -90
- package/docs/tools.html +170 -170
- package/docs/tools.th.html +84 -84
- package/docs/troubleshooting.html +106 -106
- package/docs/troubleshooting.th.html +85 -85
- package/package.json +162 -164
package/docs/architecture.html
CHANGED
|
@@ -1,148 +1,148 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="en">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>Architecture — Clew</title>
|
|
7
|
-
<meta name="description" content="Runtime architecture, layered design, and data flow for Clew CLI.">
|
|
8
|
-
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
9
|
-
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
10
|
-
<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
|
|
11
|
-
<link rel="stylesheet" href="css/styles.css">
|
|
12
|
-
<link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
|
|
13
|
-
</head>
|
|
14
|
-
<body>
|
|
15
|
-
<header class="header"></header>
|
|
16
|
-
<div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
|
|
17
|
-
<div class="content-wrap"><main class="content">
|
|
18
|
-
<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span>Architecture</span></div>
|
|
19
|
-
<h1>Architecture</h1>
|
|
20
|
-
<p class="section-subtitle">Clew is a terminal-based AI coding assistant — a React/Ink TUI, Commander.js CLI, multi-provider AI engine, and extensible tool/plugin runtime all in one process.</p>
|
|
21
|
-
|
|
22
|
-
<h2>Layered Design</h2>
|
|
23
|
-
<p>The application is structured as four cooperative layers:</p>
|
|
24
|
-
|
|
25
|
-
<h3>1. Terminal UI (React 19 + Ink 6)</h3>
|
|
26
|
-
<p>Renders the interactive REPL: prompt input, streaming markdown output, status bar with context meter, arc spinner, permission dialogs, file explorer, inline images, buddy (duck) companion, and fullscreen mode. Components live in <code>src/components/</code>, state management in <code>src/state/</code>, and React context in <code>src/context/</code>.</p>
|
|
27
|
-
|
|
28
|
-
<h3>2. CLI & Command Layer (Commander.js 13)</h3>
|
|
29
|
-
<p>Entry point at <code>src/main.tsx</code> — parses CLI flags (<code>--model</code>, <code>--print</code>, <code>--permission-mode</code>, <code>--mcp-config</code>, etc.), loads config, initializes providers and telemetry, then launches the REPL or print-mode query. Slash commands are registered in <code>src/commands.ts</code> and implemented under <code>src/commands/</code>. Commands are categorized as <code>local</code> (runs in-terminal), <code>prompt</code> (skills that expand to text), or <code>local-jsx</code> (Ink UI panels).</p>
|
|
30
|
-
|
|
31
|
-
<h3>3. AI Provider & Adapter Layer</h3>
|
|
32
|
-
<p><strong>ProviderManager</strong> (<code>src/services/ai/ProviderManager.ts</code>) resolves API keys, selects models, and manages provider config. Provider metadata is declared in <code>src/services/ai/providers.json</code> — currently <strong>
|
|
33
|
-
|
|
34
|
-
<h3>4. Tool Execution & Query Loop</h3>
|
|
35
|
-
<p>Tools use Zod schemas and are executed by the <strong>StreamingToolExecutor</strong> (<code>src/services/tools/StreamingToolExecutor.ts</code>). Permission gating via hooks in <code>src/utils/permissions/permissions.ts</code>. The query loop in <code>src/query.ts</code> + <code>src/QueryEngine.ts</code> orchestrates message building, context management, streaming, and tool call cycling. MCP tools (<code>src/services/mcp/</code>) are discovered at runtime and merged into the tool pool.</p>
|
|
36
|
-
|
|
37
|
-
<h2>Data Flow</h2>
|
|
38
|
-
<pre><code> Terminal input
|
|
39
|
-
|
|
|
40
|
-
v
|
|
41
|
-
+ Query Engine (query.ts + QueryEngine.ts)
|
|
42
|
-
| Message building and context assembly
|
|
43
|
-
| Tool call loop (model tool results)
|
|
44
|
-
| Streaming response handling
|
|
45
|
-
|
|
|
46
|
-
+ Provider Manager Adapter AI Model API
|
|
47
|
-
|
|
|
48
|
-
| AnthropicAdapter / GoogleAdapter normalization
|
|
49
|
-
|
|
|
50
|
-
+ Tool Executor (StreamingToolExecutor)
|
|
51
|
-
| Permission check (permissions.ts)
|
|
52
|
-
| Pre/Post tool hooks (plugins)
|
|
53
|
-
| Tool execution result
|
|
54
|
-
|
|
|
55
|
-
+ Terminal UI (React/Ink)
|
|
56
|
-
Streaming text and tool renders
|
|
57
|
-
Status bar, spinner, context meter
|
|
58
|
-
Permission dialogs</code></pre>
|
|
59
|
-
|
|
60
|
-
<h2>Key Subsystems</h2>
|
|
61
|
-
|
|
62
|
-
<h3>MCP (Model Context Protocol)</h3>
|
|
63
|
-
<p><code>src/services/mcp/</code> — manages external MCP server connections, tool discovery, resource access, and paginated <code>tools/list</code> responses. Servers configured via <code>--mcp-config</code> or <code>/mcp</code> command. See <a href="mcp.html">MCP</a> for detailed setup and configuration.</p>
|
|
64
|
-
|
|
65
|
-
<h3>Plugins & Hooks</h3>
|
|
66
|
-
<p><code>src/services/plugins/</code> — plugin loading, installation, marketplace reconciliation, and hook dispatch. Hook points: <code>PreToolUse</code>, <code>PostToolUse</code>, <code>PreBash</code>, <code>PostPrompt</code>, <code>PreAcceptEdit</code>. Plugins can provide commands, agents, skills, MCP servers, and LSP integrations.</p>
|
|
67
|
-
|
|
68
|
-
<h3>LSP (Language Server Protocol)</h3>
|
|
69
|
-
<p><code>src/services/lsp/</code> — language-aware code intelligence via LSP servers. Diagnostics, completions, and symbol navigation. Enable with <code>ENABLE_LSP_TOOL=1</code>.</p>
|
|
70
|
-
|
|
71
|
-
<h3>Bridge Mode</h3>
|
|
72
|
-
<p><code>src/bridge/bridgeMain.ts</code> — WebSocket remote control and collaboration. Gated behind <code>BRIDGE_MODE=1</code>. Remote clients can send commands and receive responses.</p>
|
|
73
|
-
|
|
74
|
-
<h3>Session System</h3>
|
|
75
|
-
<p><code>src/services/SessionLifecycle/</code> — cross-session context persistence. <code>src/services/SessionMemory/</code> — persistent knowledge with cross-lingual semantic search and auto-memory capture.</p>
|
|
76
|
-
|
|
77
|
-
<h3>GrowthBook Feature Flags</h3>
|
|
78
|
-
<p><code>src/services/analytics/growthbook.js</code> — A/B testing and feature flag platform. Initialized at startup, evaluates flags locally with caching.</p>
|
|
79
|
-
|
|
80
|
-
<h3>Agent Runtime</h3>
|
|
81
|
-
<p><code>src/agentRuntime/</code> — manages multi-agent orchestration. The <strong>orchestrator</strong> coordinates agent sessions, <strong>runStore</strong> persists agent run data, <strong>toolGateway</strong> routes tools between agents, and <strong>workflowRegistry</strong> / <strong>agentRegistry</strong> declare named workflows and agent configurations.</p>
|
|
82
|
-
|
|
83
|
-
<h3>Autonomous / Daemon</h3>
|
|
84
|
-
<p><code>src/services/autonomous/</code> — enables 24/7 background execution. The <strong>taskQueue</strong> is a file-backed queue with priorities, leases, and dead-letter handling. <strong>agentLoop</strong> runs the continuous dequeue spawn worker monitor retry cycle. <strong>daemonMode</strong> provides the supervisor-managed background process entry point, and <strong>supervisorIntegration</strong> handles health checks and auto-respawn. See <a href="daemon.html">Daemon Mode</a> for detailed configuration and usage.</p>
|
|
85
|
-
|
|
86
|
-
<h3>Coordinator (Multi-Agent)</h3>
|
|
87
|
-
<p><code>src/coordinator/</code> — supports multi-agent collaboration. <strong>coordinatorMode</strong> delegates tasks to sub-agents, and <strong>workerAgent</strong> provides standalone workers for delegated subtasks.</p>
|
|
88
|
-
|
|
89
|
-
<h3>Memory</h3>
|
|
90
|
-
<p><code>src/memory/</code> — local embedding-free memory with SQLite FTS5 full-text search. Token-aware chunking (3000 tokens), truth priority scoring, secret redaction, and auto-ingest from <code>.claude/memory/</code>. See <a href="research-memory.html">Memory</a> for detailed usage.</p>
|
|
91
|
-
|
|
92
|
-
<h3>Voice Mode</h3>
|
|
93
|
-
<p><code>src/voice/</code> — compile-time gated voice input support (<code>VOICE_MODE=1</code>). Provides speech-to-text and voice command processing for hands-free operation.</p>
|
|
94
|
-
|
|
95
|
-
<h3>State Management</h3>
|
|
96
|
-
<p>The app uses a lightweight observable store pattern (<code>createStore<T></code> in <code>src/state/store.ts</code>). Stores are plain functions with <code>getState</code>, <code>setState</code>, and <code>subscribe</code>. React components subscribe via the <strong>AppState</strong> React context (<code>src/state/AppState.tsx</code>).</p>
|
|
97
|
-
|
|
98
|
-
<h2>Important Source Paths</h2>
|
|
99
|
-
<table>
|
|
100
|
-
<tr><th>Path</th><th>Role</th></tr>
|
|
101
|
-
<tr><td><code>src/main.tsx</code></td><td>CLI entry, Commander program, option parsing, REPL launch</td></tr>
|
|
102
|
-
<tr><td><code>src/query.ts</code></td><td>Core query processing, message building, tool call loop</td></tr>
|
|
103
|
-
<tr><td><code>src/QueryEngine.ts</code></td><td>Query orchestration, caching, deduplication, rate limiting</td></tr>
|
|
104
|
-
<tr><td><code>src/commands.ts</code></td><td>Slash command registry (80+ commands)</td></tr>
|
|
105
|
-
<tr><td><code>src/tools.ts</code></td><td>Tool registry (40+ built-in tools)</td></tr>
|
|
106
|
-
<tr><td><code>src/Tool.ts</code></td><td>Base tool types, schemas, buildTool() helper</td></tr>
|
|
107
|
-
<tr><td><code>src/services/ai/ProviderManager.ts</code></td><td>Provider selection, API key resolution</td></tr>
|
|
108
|
-
<tr><td><code>src/services/ai/providers.json</code></td><td>Declarative provider config (
|
|
109
|
-
<tr><td><code>src/services/ai/adapter/</code></td><td>AnthropicAdapter, GoogleAdapter</td></tr>
|
|
110
|
-
<tr><td><code>src/services/tools/StreamingToolExecutor.ts</code></td><td>Streaming tool execution</td></tr>
|
|
111
|
-
<tr><td><code>src/utils/permissions/permissions.ts</code></td><td>Permission evaluation logic</td></tr>
|
|
112
|
-
<tr><td><code>src/services/mcp/</code></td><td>MCP server management</td></tr>
|
|
113
|
-
<tr><td><code>src/services/plugins/</code></td><td>Plugin loader and hook dispatch</td></tr>
|
|
114
|
-
<tr><td><code>src/state/store.ts</code></td><td>Lightweight observable store (createStore<T>)</td></tr>
|
|
115
|
-
<tr><td><code>src/state/AppState.tsx</code></td><td>Root app state (React context)</td></tr>
|
|
116
|
-
<tr><td><code>src/state/AppStateStore.ts</code></td><td>App state store implementation</td></tr>
|
|
117
|
-
<tr><td><code>src/state/selectors.ts</code></td><td>State selectors</td></tr>
|
|
118
|
-
<tr><td><code>src/agentRuntime/</code></td><td>Agent orchestration, run store, tool gateway</td></tr>
|
|
119
|
-
<tr><td><code>src/services/autonomous/</code></td><td>Task queue, agent loop, daemon mode, supervisor</td></tr>
|
|
120
|
-
<tr><td><code>src/coordinator/</code></td><td>Multi-agent coordinator and worker agents</td></tr>
|
|
121
|
-
<tr><td><code>src/research/</code></td><td>Deep research, dossier generation, truth checking</td></tr>
|
|
122
|
-
<tr><td><code>src/memory/</code></td><td>SQLite FTS5 memory search (14 files)</td></tr>
|
|
123
|
-
<tr><td><code>src/voice/</code></td><td>Voice mode support (compile-time gated)</td></tr>
|
|
124
|
-
<tr><td><code>src/entrypoints/init.ts</code></td><td>Startup initialization (Sentry, configs, telemetry)</td></tr>
|
|
125
|
-
<tr><td><code>src/entrypoints/cli.tsx</code></td><td>Alternative CLI entry point (Commander-based)</td></tr>
|
|
126
|
-
<tr><td><code>src/entrypoints/mcp.ts</code></td><td>MCP server entry point</td></tr>
|
|
127
|
-
</table>
|
|
128
|
-
|
|
129
|
-
<h2>Build System</h2>
|
|
130
|
-
<p>Built with Bun bundler — <code>bun run build</code> outputs a single binary to <code>dist/</code>. TypeScript with strict mode and ESM/NodeNext module resolution. External dependencies include Electron, chromium-bidi, AWS SDK, Google Auth, and platform-specific native modules. Lint/format via Biome 2.4.</p>
|
|
131
|
-
|
|
132
|
-
<footer class="footer">
|
|
133
|
-
<span>Clew Code
|
|
134
|
-
<div class="footer-links">
|
|
135
|
-
<a href="https://github.com/ClewCode/ClewCode">GitHub</a>
|
|
136
|
-
<a href="https://github.com/ClewCode/ClewCode/issues">Issues</a>
|
|
137
|
-
</div>
|
|
138
|
-
</footer>
|
|
139
|
-
</main>
|
|
140
|
-
<nav class="toc-sidebar"></nav>
|
|
141
|
-
</div>
|
|
142
|
-
</div>
|
|
143
|
-
<script src="js/main.js"></script>
|
|
144
|
-
</body>
|
|
145
|
-
</html>
|
|
146
|
-
dy>
|
|
147
|
-
</html>
|
|
148
|
-
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
+
<title>Architecture — Clew</title>
|
|
7
|
+
<meta name="description" content="Runtime architecture, layered design, and data flow for Clew CLI.">
|
|
8
|
+
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
9
|
+
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
10
|
+
<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
|
|
11
|
+
<link rel="stylesheet" href="css/styles.css">
|
|
12
|
+
<link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
|
|
13
|
+
</head>
|
|
14
|
+
<body>
|
|
15
|
+
<header class="header"></header>
|
|
16
|
+
<div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
|
|
17
|
+
<div class="content-wrap"><main class="content">
|
|
18
|
+
<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span>Architecture</span></div>
|
|
19
|
+
<h1>Architecture</h1>
|
|
20
|
+
<p class="section-subtitle">Clew is a terminal-based AI coding assistant — a React/Ink TUI, Commander.js CLI, multi-provider AI engine, and extensible tool/plugin runtime all in one process.</p>
|
|
21
|
+
|
|
22
|
+
<h2>Layered Design</h2>
|
|
23
|
+
<p>The application is structured as four cooperative layers:</p>
|
|
24
|
+
|
|
25
|
+
<h3>1. Terminal UI (React 19 + Ink 6)</h3>
|
|
26
|
+
<p>Renders the interactive REPL: prompt input, streaming markdown output, status bar with context meter, arc spinner, permission dialogs, file explorer, inline images, buddy (duck) companion, and fullscreen mode. Components live in <code>src/components/</code>, state management in <code>src/state/</code>, and React context in <code>src/context/</code>.</p>
|
|
27
|
+
|
|
28
|
+
<h3>2. CLI & Command Layer (Commander.js 13)</h3>
|
|
29
|
+
<p>Entry point at <code>src/main.tsx</code> — parses CLI flags (<code>--model</code>, <code>--print</code>, <code>--permission-mode</code>, <code>--mcp-config</code>, etc.), loads config, initializes providers and telemetry, then launches the REPL or print-mode query. Slash commands are registered in <code>src/commands.ts</code> and implemented under <code>src/commands/</code>. Commands are categorized as <code>local</code> (runs in-terminal), <code>prompt</code> (skills that expand to text), or <code>local-jsx</code> (Ink UI panels).</p>
|
|
30
|
+
|
|
31
|
+
<h3>3. AI Provider & Adapter Layer</h3>
|
|
32
|
+
<p><strong>ProviderManager</strong> (<code>src/services/ai/ProviderManager.ts</code>) resolves API keys, selects models, and manages provider config. Provider metadata is declared in <code>src/services/ai/providers.json</code> — currently <strong>28 providers</strong> (10 dedicated classes + 18 OpenAI-compatible) with model listings, capabilities, base URLs, and env key mappings. Non-Anthropic providers are wrapped by the <strong>AnthropicAdapter</strong> or <strong>GoogleAdapter</strong>, which normalize content blocks (<code>contentBlockUtils.ts</code>), tool calls (<code>toolCallParser.ts</code>), errors (<code>errorNormalizer.ts</code>), and usage (<code>usageNormalizer.ts</code>) to a uniform format.</p>
|
|
33
|
+
|
|
34
|
+
<h3>4. Tool Execution & Query Loop</h3>
|
|
35
|
+
<p>Tools use Zod schemas and are executed by the <strong>StreamingToolExecutor</strong> (<code>src/services/tools/StreamingToolExecutor.ts</code>). Permission gating via hooks in <code>src/utils/permissions/permissions.ts</code>. The query loop in <code>src/query.ts</code> + <code>src/QueryEngine.ts</code> orchestrates message building, context management, streaming, and tool call cycling. MCP tools (<code>src/services/mcp/</code>) are discovered at runtime and merged into the tool pool.</p>
|
|
36
|
+
|
|
37
|
+
<h2>Data Flow</h2>
|
|
38
|
+
<pre><code> Terminal input
|
|
39
|
+
|
|
|
40
|
+
v
|
|
41
|
+
+ Query Engine (query.ts + QueryEngine.ts)
|
|
42
|
+
| Message building and context assembly
|
|
43
|
+
| Tool call loop (model tool results)
|
|
44
|
+
| Streaming response handling
|
|
45
|
+
|
|
|
46
|
+
+ Provider Manager Adapter AI Model API
|
|
47
|
+
| 28 providers via providers.json
|
|
48
|
+
| AnthropicAdapter / GoogleAdapter normalization
|
|
49
|
+
|
|
|
50
|
+
+ Tool Executor (StreamingToolExecutor)
|
|
51
|
+
| Permission check (permissions.ts)
|
|
52
|
+
| Pre/Post tool hooks (plugins)
|
|
53
|
+
| Tool execution result
|
|
54
|
+
|
|
|
55
|
+
+ Terminal UI (React/Ink)
|
|
56
|
+
Streaming text and tool renders
|
|
57
|
+
Status bar, spinner, context meter
|
|
58
|
+
Permission dialogs</code></pre>
|
|
59
|
+
|
|
60
|
+
<h2>Key Subsystems</h2>
|
|
61
|
+
|
|
62
|
+
<h3>MCP (Model Context Protocol)</h3>
|
|
63
|
+
<p><code>src/services/mcp/</code> — manages external MCP server connections, tool discovery, resource access, and paginated <code>tools/list</code> responses. Servers configured via <code>--mcp-config</code> or <code>/mcp</code> command. See <a href="mcp.html">MCP</a> for detailed setup and configuration.</p>
|
|
64
|
+
|
|
65
|
+
<h3>Plugins & Hooks</h3>
|
|
66
|
+
<p><code>src/services/plugins/</code> — plugin loading, installation, marketplace reconciliation, and hook dispatch. Hook points: <code>PreToolUse</code>, <code>PostToolUse</code>, <code>PreBash</code>, <code>PostPrompt</code>, <code>PreAcceptEdit</code>. Plugins can provide commands, agents, skills, MCP servers, and LSP integrations.</p>
|
|
67
|
+
|
|
68
|
+
<h3>LSP (Language Server Protocol)</h3>
|
|
69
|
+
<p><code>src/services/lsp/</code> — language-aware code intelligence via LSP servers. Diagnostics, completions, and symbol navigation. Enable with <code>ENABLE_LSP_TOOL=1</code>.</p>
|
|
70
|
+
|
|
71
|
+
<h3>Bridge Mode</h3>
|
|
72
|
+
<p><code>src/bridge/bridgeMain.ts</code> — WebSocket remote control and collaboration. Gated behind <code>BRIDGE_MODE=1</code>. Remote clients can send commands and receive responses.</p>
|
|
73
|
+
|
|
74
|
+
<h3>Session System</h3>
|
|
75
|
+
<p><code>src/services/SessionLifecycle/</code> — cross-session context persistence. <code>src/services/SessionMemory/</code> — persistent knowledge with cross-lingual semantic search and auto-memory capture.</p>
|
|
76
|
+
|
|
77
|
+
<h3>GrowthBook Feature Flags</h3>
|
|
78
|
+
<p><code>src/services/analytics/growthbook.js</code> — A/B testing and feature flag platform. Initialized at startup, evaluates flags locally with caching.</p>
|
|
79
|
+
|
|
80
|
+
<h3>Agent Runtime</h3>
|
|
81
|
+
<p><code>src/agentRuntime/</code> — manages multi-agent orchestration. The <strong>orchestrator</strong> coordinates agent sessions, <strong>runStore</strong> persists agent run data, <strong>toolGateway</strong> routes tools between agents, and <strong>workflowRegistry</strong> / <strong>agentRegistry</strong> declare named workflows and agent configurations.</p>
|
|
82
|
+
|
|
83
|
+
<h3>Autonomous / Daemon</h3>
|
|
84
|
+
<p><code>src/services/autonomous/</code> — enables 24/7 background execution. The <strong>taskQueue</strong> is a file-backed queue with priorities, leases, and dead-letter handling. <strong>agentLoop</strong> runs the continuous dequeue spawn worker monitor retry cycle. <strong>daemonMode</strong> provides the supervisor-managed background process entry point, and <strong>supervisorIntegration</strong> handles health checks and auto-respawn. See <a href="daemon.html">Daemon Mode</a> for detailed configuration and usage.</p>
|
|
85
|
+
|
|
86
|
+
<h3>Coordinator (Multi-Agent)</h3>
|
|
87
|
+
<p><code>src/coordinator/</code> — supports multi-agent collaboration. <strong>coordinatorMode</strong> delegates tasks to sub-agents, and <strong>workerAgent</strong> provides standalone workers for delegated subtasks.</p>
|
|
88
|
+
|
|
89
|
+
<h3>Memory</h3>
|
|
90
|
+
<p><code>src/memory/</code> — local embedding-free memory with SQLite FTS5 full-text search. Token-aware chunking (3000 tokens), truth priority scoring, secret redaction, and auto-ingest from <code>.claude/memory/</code>. See <a href="research-memory.html">Memory</a> for detailed usage.</p>
|
|
91
|
+
|
|
92
|
+
<h3>Voice Mode</h3>
|
|
93
|
+
<p><code>src/voice/</code> — compile-time gated voice input support (<code>VOICE_MODE=1</code>). Provides speech-to-text and voice command processing for hands-free operation.</p>
|
|
94
|
+
|
|
95
|
+
<h3>State Management</h3>
|
|
96
|
+
<p>The app uses a lightweight observable store pattern (<code>createStore<T></code> in <code>src/state/store.ts</code>). Stores are plain functions with <code>getState</code>, <code>setState</code>, and <code>subscribe</code>. React components subscribe via the <strong>AppState</strong> React context (<code>src/state/AppState.tsx</code>).</p>
|
|
97
|
+
|
|
98
|
+
<h2>Important Source Paths</h2>
|
|
99
|
+
<table>
|
|
100
|
+
<tr><th>Path</th><th>Role</th></tr>
|
|
101
|
+
<tr><td><code>src/main.tsx</code></td><td>CLI entry, Commander program, option parsing, REPL launch</td></tr>
|
|
102
|
+
<tr><td><code>src/query.ts</code></td><td>Core query processing, message building, tool call loop</td></tr>
|
|
103
|
+
<tr><td><code>src/QueryEngine.ts</code></td><td>Query orchestration, caching, deduplication, rate limiting</td></tr>
|
|
104
|
+
<tr><td><code>src/commands.ts</code></td><td>Slash command registry (80+ commands)</td></tr>
|
|
105
|
+
<tr><td><code>src/tools.ts</code></td><td>Tool registry (40+ built-in tools)</td></tr>
|
|
106
|
+
<tr><td><code>src/Tool.ts</code></td><td>Base tool types, schemas, buildTool() helper</td></tr>
|
|
107
|
+
<tr><td><code>src/services/ai/ProviderManager.ts</code></td><td>Provider selection, API key resolution</td></tr>
|
|
108
|
+
<tr><td><code>src/services/ai/providers.json</code></td><td>Declarative provider config (28 providers)</td></tr>
|
|
109
|
+
<tr><td><code>src/services/ai/adapter/</code></td><td>AnthropicAdapter, GoogleAdapter</td></tr>
|
|
110
|
+
<tr><td><code>src/services/tools/StreamingToolExecutor.ts</code></td><td>Streaming tool execution</td></tr>
|
|
111
|
+
<tr><td><code>src/utils/permissions/permissions.ts</code></td><td>Permission evaluation logic</td></tr>
|
|
112
|
+
<tr><td><code>src/services/mcp/</code></td><td>MCP server management</td></tr>
|
|
113
|
+
<tr><td><code>src/services/plugins/</code></td><td>Plugin loader and hook dispatch</td></tr>
|
|
114
|
+
<tr><td><code>src/state/store.ts</code></td><td>Lightweight observable store (createStore<T>)</td></tr>
|
|
115
|
+
<tr><td><code>src/state/AppState.tsx</code></td><td>Root app state (React context)</td></tr>
|
|
116
|
+
<tr><td><code>src/state/AppStateStore.ts</code></td><td>App state store implementation</td></tr>
|
|
117
|
+
<tr><td><code>src/state/selectors.ts</code></td><td>State selectors</td></tr>
|
|
118
|
+
<tr><td><code>src/agentRuntime/</code></td><td>Agent orchestration, run store, tool gateway</td></tr>
|
|
119
|
+
<tr><td><code>src/services/autonomous/</code></td><td>Task queue, agent loop, daemon mode, supervisor</td></tr>
|
|
120
|
+
<tr><td><code>src/coordinator/</code></td><td>Multi-agent coordinator and worker agents</td></tr>
|
|
121
|
+
<tr><td><code>src/research/</code></td><td>Deep research, dossier generation, truth checking</td></tr>
|
|
122
|
+
<tr><td><code>src/memory/</code></td><td>SQLite FTS5 memory search (14 files)</td></tr>
|
|
123
|
+
<tr><td><code>src/voice/</code></td><td>Voice mode support (compile-time gated)</td></tr>
|
|
124
|
+
<tr><td><code>src/entrypoints/init.ts</code></td><td>Startup initialization (Sentry, configs, telemetry)</td></tr>
|
|
125
|
+
<tr><td><code>src/entrypoints/cli.tsx</code></td><td>Alternative CLI entry point (Commander-based)</td></tr>
|
|
126
|
+
<tr><td><code>src/entrypoints/mcp.ts</code></td><td>MCP server entry point</td></tr>
|
|
127
|
+
</table>
|
|
128
|
+
|
|
129
|
+
<h2>Build System</h2>
|
|
130
|
+
<p>Built with Bun bundler — <code>bun run build</code> outputs a single binary to <code>dist/</code>. TypeScript with strict mode and ESM/NodeNext module resolution. External dependencies include Electron, chromium-bidi, AWS SDK, Google Auth, and platform-specific native modules. Lint/format via Biome 2.4.</p>
|
|
131
|
+
|
|
132
|
+
<footer class="footer">
|
|
133
|
+
<span>Clew Code 0.2.13 — Open Source</span>
|
|
134
|
+
<div class="footer-links">
|
|
135
|
+
<a href="https://github.com/ClewCode/ClewCode">GitHub</a>
|
|
136
|
+
<a href="https://github.com/ClewCode/ClewCode/issues">Issues</a>
|
|
137
|
+
</div>
|
|
138
|
+
</footer>
|
|
139
|
+
</main>
|
|
140
|
+
<nav class="toc-sidebar"></nav>
|
|
141
|
+
</div>
|
|
142
|
+
</div>
|
|
143
|
+
<script src="js/main.js"></script>
|
|
144
|
+
</body>
|
|
145
|
+
</html>
|
|
146
|
+
dy>
|
|
147
|
+
</html>
|
|
148
|
+
|
|
@@ -1,79 +1,79 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="th">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>สถาปัตยà¸à¸£à¸£à¸¡ — Clew</title>
|
|
7
|
-
<meta name="description" content="สถาปัตยà¸à¸£à¸£à¸¡à¸£à¸±à¸™à¹„ทม์, à¸à¸²à¸£à¸à¸à¸à¹à¸šà¸šà¹à¸šà¸šà¸Šà¸±à¹‰à¸™, à¹à¸¥à¸°à¸à¸²à¸£à¹„หลขà¸à¸‡à¸‚้à¸à¸¡à¸¹à¸¥à¸ªà¸³à¸«à¸£à¸±à¸š Clew CLI">
|
|
8
|
-
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
9
|
-
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
10
|
-
<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Thai:wght@400;500;600;700&display=swap" rel="stylesheet">
|
|
11
|
-
<link rel="stylesheet" href="css/styles.css">
|
|
12
|
-
<link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
|
|
13
|
-
</head>
|
|
14
|
-
<body>
|
|
15
|
-
<header class="header"></header>
|
|
16
|
-
<div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
|
|
17
|
-
<div class="content-wrap"><main class="content">
|
|
18
|
-
<div class="breadcrumbs"><a href="index.th.html">หน้าà¹à¸£à¸</a><span class="sep">/</span><span>สถาปัตยà¸à¸£à¸£à¸¡</span></div>
|
|
19
|
-
<h1>สถาปัตยà¸à¸£à¸£à¸¡</h1>
|
|
20
|
-
<p class="section-subtitle">Clew คืà¸à¸œà¸¹à¹‰à¸Šà¹ˆà¸§à¸¢à¹€à¸‚ียนโค้ด AI บนเทà¸à¸£à¹Œà¸¡à¸´à¸™à¸±à¸¥ — React/Ink TUI, CLI Commander.js, เครื่à¸à¸‡à¸¢à¸™à¸•à¹Œ AI หลายผู้ให้บริà¸à¸²à¸£, à¹à¸¥à¸°à¸£à¸±à¸™à¹„ทม์เครื่à¸à¸‡à¸¡à¸·à¸/ปลั๊à¸à¸à¸´à¸™à¸—ี่ขยายได้ในà¸à¸£à¸°à¸šà¸§à¸™à¸à¸²à¸£à¹€à¸”ียว</p>
|
|
21
|
-
|
|
22
|
-
<h2>à¸à¸²à¸£à¸à¸à¸à¹à¸šà¸šà¹à¸šà¸šà¸Šà¸±à¹‰à¸™</h2>
|
|
23
|
-
<p>à¹à¸à¸›à¸žà¸¥à¸´à¹€à¸„ชันถูà¸à¸ˆà¸±à¸”โครงสร้างเป็นสี่ชั้นที่ทำงานร่วมà¸à¸±à¸™:</p>
|
|
24
|
-
|
|
25
|
-
<h3>1. Terminal UI (React 19 + Ink 6)</h3>
|
|
26
|
-
<p>à¹à¸ªà¸”ง REPL à¹à¸šà¸šà¹‚ต้ตà¸à¸š: à¸à¸´à¸™à¸žà¸¸à¸• prompt, ผลลัพธ์ markdown à¹à¸šà¸šà¸ªà¸•à¸£à¸µà¸¡, à¹à¸–บสถานะพร้à¸à¸¡à¸¡à¸²à¸•à¸£à¸§à¸±à¸”บริบท, สไปนเนà¸à¸£à¹Œ, à¸à¸¥à¹ˆà¸à¸‡à¹‚ต้ตà¸à¸šà¸ªà¸´à¸—ธิ์, ตัวสำรวจไฟล์, à¹à¸¥à¸°à¹‚หมดเต็มหน้าจà¸</p>
|
|
27
|
-
|
|
28
|
-
<h3>2. CLI à¹à¸¥à¸°à¸Šà¸±à¹‰à¸™à¸„ำสั่ง (Commander.js 13)</h3>
|
|
29
|
-
<p>จุดเข้าที่ <code>src/main.tsx</code> — à¹à¸¢à¸à¸§à¸´à¹€à¸„ราะห์ CLI flags, โหลดà¸à¸²à¸£à¸•à¸±à¹‰à¸‡à¸„่า, เริ่มต้นผู้ให้บริà¸à¸²à¸£à¹à¸¥à¸° telemetry, à¹à¸¥à¹‰à¸§à¹€à¸›à¸´à¸” REPL หรืà¸à¹‚หมดพิมพ์</p>
|
|
30
|
-
|
|
31
|
-
<h3>3. ชั้นผู้ให้บริà¸à¸²à¸£ AI à¹à¸¥à¸° Adapter</h3>
|
|
32
|
-
<p><strong>ProviderManager</strong> (<code>src/services/ai/ProviderManager.ts</code>) จัดà¸à¸²à¸£à¸à¸²à¸£à¹à¸à¹‰à¹„ขคีย์ API, เลืà¸à¸à¹‚มเดล, à¹à¸¥à¸°à¸ˆà¸±à¸”à¸à¸²à¸£à¸à¸²à¸£à¸•à¸±à¹‰à¸‡à¸„่าผู้ให้บริà¸à¸²à¸£ ขณะนี้มี 27 ผู้ให้บริà¸à¸²à¸£</p>
|
|
33
|
-
|
|
34
|
-
<h3>4. à¸à¸²à¸£à¸”ำเนินà¸à¸²à¸£à¹€à¸„รื่à¸à¸‡à¸¡à¸·à¸à¹à¸¥à¸° Query Loop</h3>
|
|
35
|
-
<p>เครื่à¸à¸‡à¸¡à¸·à¸à¹ƒà¸Šà¹‰ Zod schemas à¹à¸¥à¸°à¸”ำเนินà¸à¸²à¸£à¹‚ดย <strong>StreamingToolExecutor</strong> (<code>src/services/tools/StreamingToolExecutor.ts</code>)</p>
|
|
36
|
-
|
|
37
|
-
<h2>ระบบย่à¸à¸¢à¸«à¸¥à¸±à¸</h2>
|
|
38
|
-
|
|
39
|
-
<h3>MCP (Model Context Protocol)</h3>
|
|
40
|
-
<p><code>src/services/mcp/</code> — จัดà¸à¸²à¸£à¸à¸²à¸£à¹€à¸Šà¸·à¹ˆà¸à¸¡à¸•à¹ˆà¸à¹€à¸‹à¸´à¸£à¹Œà¸Ÿà¹€à¸§à¸à¸£à¹Œ MCP ภายนà¸à¸, à¸à¸²à¸£à¸„้นพบเครื่à¸à¸‡à¸¡à¸·à¸, à¸à¸²à¸£à¹€à¸‚้าถึงทรัพยาà¸à¸£ ดู <a href="mcp.th.html">MCP</a> สำหรับรายละเà¸à¸µà¸¢à¸”</p>
|
|
41
|
-
|
|
42
|
-
<h3>ปลั๊à¸à¸à¸´à¸™à¹à¸¥à¸°à¸®à¸¸à¸„</h3>
|
|
43
|
-
<p><code>src/services/plugins/</code> — à¸à¸²à¸£à¹‚หลดปลั๊à¸à¸à¸´à¸™, à¸à¸²à¸£à¸•à¸´à¸”ตั้ง, à¸à¸²à¸£à¸£à¸§à¸¡ marketplace, à¹à¸¥à¸°à¸à¸²à¸£à¸ªà¹ˆà¸‡à¸®à¸¸à¸„</p>
|
|
44
|
-
|
|
45
|
-
<h3>โหมด Bridge</h3>
|
|
46
|
-
<p><code>src/bridge/bridgeMain.ts</code> — à¸à¸²à¸£à¸„วบคุมระยะไà¸à¸¥à¹à¸¥à¸°à¸à¸²à¸£à¸—ำงานร่วมà¸à¸±à¸™à¸œà¹ˆà¸²à¸™ WebSocket</p>
|
|
47
|
-
|
|
48
|
-
<h3>รันไทม์เà¸à¹€à¸ˆà¸™à¸•à¹Œ</h3>
|
|
49
|
-
<p><code>src/agentRuntime/</code> — จัดà¸à¸²à¸£à¸à¸²à¸£à¸ˆà¸±à¸”ระเบียบหลายเà¸à¹€à¸ˆà¸™à¸•à¹Œ</p>
|
|
50
|
-
|
|
51
|
-
<h3>à¸à¸±à¸•à¹‚นมัติ / Daemon</h3>
|
|
52
|
-
<p><code>src/services/autonomous/</code> — เปิดใช้งานà¸à¸²à¸£à¸”ำเนินà¸à¸²à¸£à¸žà¸·à¹‰à¸™à¸«à¸¥à¸±à¸‡ 24/7 คิวงาน, วนซ้ำเà¸à¹€à¸ˆà¸™à¸•à¹Œ, โหมด daemon ดู <a href="daemon.th.html">โหมด Daemon</a></p>
|
|
53
|
-
|
|
54
|
-
<h2>พาธซà¸à¸£à¹Œà¸ªà¸—ี่สำคัà¸</h2>
|
|
55
|
-
<table>
|
|
56
|
-
<tr><th>พาธ</th><th>บทบาท</th></tr>
|
|
57
|
-
<tr><td><code>src/main.tsx</code></td><td>จุดเข้า CLI, โปรà¹à¸à¸£à¸¡ Commander, à¸à¸²à¸£à¹à¸¢à¸à¸§à¸´à¹€à¸„ราะห์ตัวเลืà¸à¸, à¸à¸²à¸£à¹€à¸›à¸´à¸” REPL</td></tr>
|
|
58
|
-
<tr><td><code>src/query.ts</code></td><td>à¸à¸²à¸£à¸›à¸£à¸°à¸¡à¸§à¸¥à¸œà¸¥à¸„ำถามหลัà¸, à¸à¸²à¸£à¸ªà¸£à¹‰à¸²à¸‡à¸‚้à¸à¸„วาม, วนซ้ำà¸à¸²à¸£à¹€à¸£à¸µà¸¢à¸à¹ƒà¸Šà¹‰à¹€à¸„รื่à¸à¸‡à¸¡à¸·à¸</td></tr>
|
|
59
|
-
<tr><td><code>src/commands.ts</code></td><td>ทะเบียนคำสั่ง slash (80+ คำสั่ง)</td></tr>
|
|
60
|
-
<tr><td><code>src/tools.ts</code></td><td>ทะเบียนเครื่à¸à¸‡à¸¡à¸·à¸ (40+ เครื่à¸à¸‡à¸¡à¸·à¸à¹ƒà¸™à¸•à¸±à¸§)</td></tr>
|
|
61
|
-
<tr><td><code>src/services/ai/ProviderManager.ts</code></td><td>à¸à¸²à¸£à¹€à¸¥à¸·à¸à¸à¸œà¸¹à¹‰à¹ƒà¸«à¹‰à¸šà¸£à¸´à¸à¸²à¸£, à¸à¸²à¸£à¹à¸à¹‰à¹„ขคีย์ API</td></tr>
|
|
62
|
-
<tr><td><code>src/services/ai/providers.json</code></td><td>à¸à¸²à¸£à¸•à¸±à¹‰à¸‡à¸„่าผู้ให้บริà¸à¸²à¸£ (27 ผู้ให้บริà¸à¸²à¸£)</td></tr>
|
|
63
|
-
</table>
|
|
64
|
-
|
|
65
|
-
<footer class="footer">
|
|
66
|
-
<span>Clew Code
|
|
67
|
-
<div class="footer-links">
|
|
68
|
-
<a href="https://github.com/ClewCode/ClewCode">GitHub</a>
|
|
69
|
-
<a href="https://github.com/ClewCode/ClewCode/issues">ปัà¸à¸«à¸²</a>
|
|
70
|
-
</div>
|
|
71
|
-
</footer>
|
|
72
|
-
</main>
|
|
73
|
-
<nav class="toc-sidebar"></nav>
|
|
74
|
-
</div>
|
|
75
|
-
</div>
|
|
76
|
-
<script src="js/main.js"></script>
|
|
77
|
-
</body>
|
|
78
|
-
</html>
|
|
79
|
-
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="th">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
+
<title>สถาปัตยà¸à¸£à¸£à¸¡ — Clew</title>
|
|
7
|
+
<meta name="description" content="สถาปัตยà¸à¸£à¸£à¸¡à¸£à¸±à¸™à¹„ทม์, à¸à¸²à¸£à¸à¸à¸à¹à¸šà¸šà¹à¸šà¸šà¸Šà¸±à¹‰à¸™, à¹à¸¥à¸°à¸à¸²à¸£à¹„หลขà¸à¸‡à¸‚้à¸à¸¡à¸¹à¸¥à¸ªà¸³à¸«à¸£à¸±à¸š Clew CLI">
|
|
8
|
+
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
9
|
+
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
10
|
+
<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Thai:wght@400;500;600;700&display=swap" rel="stylesheet">
|
|
11
|
+
<link rel="stylesheet" href="css/styles.css">
|
|
12
|
+
<link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
|
|
13
|
+
</head>
|
|
14
|
+
<body>
|
|
15
|
+
<header class="header"></header>
|
|
16
|
+
<div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
|
|
17
|
+
<div class="content-wrap"><main class="content">
|
|
18
|
+
<div class="breadcrumbs"><a href="index.th.html">หน้าà¹à¸£à¸</a><span class="sep">/</span><span>สถาปัตยà¸à¸£à¸£à¸¡</span></div>
|
|
19
|
+
<h1>สถาปัตยà¸à¸£à¸£à¸¡</h1>
|
|
20
|
+
<p class="section-subtitle">Clew คืà¸à¸œà¸¹à¹‰à¸Šà¹ˆà¸§à¸¢à¹€à¸‚ียนโค้ด AI บนเทà¸à¸£à¹Œà¸¡à¸´à¸™à¸±à¸¥ — React/Ink TUI, CLI Commander.js, เครื่à¸à¸‡à¸¢à¸™à¸•à¹Œ AI หลายผู้ให้บริà¸à¸²à¸£, à¹à¸¥à¸°à¸£à¸±à¸™à¹„ทม์เครื่à¸à¸‡à¸¡à¸·à¸/ปลั๊à¸à¸à¸´à¸™à¸—ี่ขยายได้ในà¸à¸£à¸°à¸šà¸§à¸™à¸à¸²à¸£à¹€à¸”ียว</p>
|
|
21
|
+
|
|
22
|
+
<h2>à¸à¸²à¸£à¸à¸à¸à¹à¸šà¸šà¹à¸šà¸šà¸Šà¸±à¹‰à¸™</h2>
|
|
23
|
+
<p>à¹à¸à¸›à¸žà¸¥à¸´à¹€à¸„ชันถูà¸à¸ˆà¸±à¸”โครงสร้างเป็นสี่ชั้นที่ทำงานร่วมà¸à¸±à¸™:</p>
|
|
24
|
+
|
|
25
|
+
<h3>1. Terminal UI (React 19 + Ink 6)</h3>
|
|
26
|
+
<p>à¹à¸ªà¸”ง REPL à¹à¸šà¸šà¹‚ต้ตà¸à¸š: à¸à¸´à¸™à¸žà¸¸à¸• prompt, ผลลัพธ์ markdown à¹à¸šà¸šà¸ªà¸•à¸£à¸µà¸¡, à¹à¸–บสถานะพร้à¸à¸¡à¸¡à¸²à¸•à¸£à¸§à¸±à¸”บริบท, สไปนเนà¸à¸£à¹Œ, à¸à¸¥à¹ˆà¸à¸‡à¹‚ต้ตà¸à¸šà¸ªà¸´à¸—ธิ์, ตัวสำรวจไฟล์, à¹à¸¥à¸°à¹‚หมดเต็มหน้าจà¸</p>
|
|
27
|
+
|
|
28
|
+
<h3>2. CLI à¹à¸¥à¸°à¸Šà¸±à¹‰à¸™à¸„ำสั่ง (Commander.js 13)</h3>
|
|
29
|
+
<p>จุดเข้าที่ <code>src/main.tsx</code> — à¹à¸¢à¸à¸§à¸´à¹€à¸„ราะห์ CLI flags, โหลดà¸à¸²à¸£à¸•à¸±à¹‰à¸‡à¸„่า, เริ่มต้นผู้ให้บริà¸à¸²à¸£à¹à¸¥à¸° telemetry, à¹à¸¥à¹‰à¸§à¹€à¸›à¸´à¸” REPL หรืà¸à¹‚หมดพิมพ์</p>
|
|
30
|
+
|
|
31
|
+
<h3>3. ชั้นผู้ให้บริà¸à¸²à¸£ AI à¹à¸¥à¸° Adapter</h3>
|
|
32
|
+
<p><strong>ProviderManager</strong> (<code>src/services/ai/ProviderManager.ts</code>) จัดà¸à¸²à¸£à¸à¸²à¸£à¹à¸à¹‰à¹„ขคีย์ API, เลืà¸à¸à¹‚มเดล, à¹à¸¥à¸°à¸ˆà¸±à¸”à¸à¸²à¸£à¸à¸²à¸£à¸•à¸±à¹‰à¸‡à¸„่าผู้ให้บริà¸à¸²à¸£ ขณะนี้มี 27 ผู้ให้บริà¸à¸²à¸£</p>
|
|
33
|
+
|
|
34
|
+
<h3>4. à¸à¸²à¸£à¸”ำเนินà¸à¸²à¸£à¹€à¸„รื่à¸à¸‡à¸¡à¸·à¸à¹à¸¥à¸° Query Loop</h3>
|
|
35
|
+
<p>เครื่à¸à¸‡à¸¡à¸·à¸à¹ƒà¸Šà¹‰ Zod schemas à¹à¸¥à¸°à¸”ำเนินà¸à¸²à¸£à¹‚ดย <strong>StreamingToolExecutor</strong> (<code>src/services/tools/StreamingToolExecutor.ts</code>)</p>
|
|
36
|
+
|
|
37
|
+
<h2>ระบบย่à¸à¸¢à¸«à¸¥à¸±à¸</h2>
|
|
38
|
+
|
|
39
|
+
<h3>MCP (Model Context Protocol)</h3>
|
|
40
|
+
<p><code>src/services/mcp/</code> — จัดà¸à¸²à¸£à¸à¸²à¸£à¹€à¸Šà¸·à¹ˆà¸à¸¡à¸•à¹ˆà¸à¹€à¸‹à¸´à¸£à¹Œà¸Ÿà¹€à¸§à¸à¸£à¹Œ MCP ภายนà¸à¸, à¸à¸²à¸£à¸„้นพบเครื่à¸à¸‡à¸¡à¸·à¸, à¸à¸²à¸£à¹€à¸‚้าถึงทรัพยาà¸à¸£ ดู <a href="mcp.th.html">MCP</a> สำหรับรายละเà¸à¸µà¸¢à¸”</p>
|
|
41
|
+
|
|
42
|
+
<h3>ปลั๊à¸à¸à¸´à¸™à¹à¸¥à¸°à¸®à¸¸à¸„</h3>
|
|
43
|
+
<p><code>src/services/plugins/</code> — à¸à¸²à¸£à¹‚หลดปลั๊à¸à¸à¸´à¸™, à¸à¸²à¸£à¸•à¸´à¸”ตั้ง, à¸à¸²à¸£à¸£à¸§à¸¡ marketplace, à¹à¸¥à¸°à¸à¸²à¸£à¸ªà¹ˆà¸‡à¸®à¸¸à¸„</p>
|
|
44
|
+
|
|
45
|
+
<h3>โหมด Bridge</h3>
|
|
46
|
+
<p><code>src/bridge/bridgeMain.ts</code> — à¸à¸²à¸£à¸„วบคุมระยะไà¸à¸¥à¹à¸¥à¸°à¸à¸²à¸£à¸—ำงานร่วมà¸à¸±à¸™à¸œà¹ˆà¸²à¸™ WebSocket</p>
|
|
47
|
+
|
|
48
|
+
<h3>รันไทม์เà¸à¹€à¸ˆà¸™à¸•à¹Œ</h3>
|
|
49
|
+
<p><code>src/agentRuntime/</code> — จัดà¸à¸²à¸£à¸à¸²à¸£à¸ˆà¸±à¸”ระเบียบหลายเà¸à¹€à¸ˆà¸™à¸•à¹Œ</p>
|
|
50
|
+
|
|
51
|
+
<h3>à¸à¸±à¸•à¹‚นมัติ / Daemon</h3>
|
|
52
|
+
<p><code>src/services/autonomous/</code> — เปิดใช้งานà¸à¸²à¸£à¸”ำเนินà¸à¸²à¸£à¸žà¸·à¹‰à¸™à¸«à¸¥à¸±à¸‡ 24/7 คิวงาน, วนซ้ำเà¸à¹€à¸ˆà¸™à¸•à¹Œ, โหมด daemon ดู <a href="daemon.th.html">โหมด Daemon</a></p>
|
|
53
|
+
|
|
54
|
+
<h2>พาธซà¸à¸£à¹Œà¸ªà¸—ี่สำคัà¸</h2>
|
|
55
|
+
<table>
|
|
56
|
+
<tr><th>พาธ</th><th>บทบาท</th></tr>
|
|
57
|
+
<tr><td><code>src/main.tsx</code></td><td>จุดเข้า CLI, โปรà¹à¸à¸£à¸¡ Commander, à¸à¸²à¸£à¹à¸¢à¸à¸§à¸´à¹€à¸„ราะห์ตัวเลืà¸à¸, à¸à¸²à¸£à¹€à¸›à¸´à¸” REPL</td></tr>
|
|
58
|
+
<tr><td><code>src/query.ts</code></td><td>à¸à¸²à¸£à¸›à¸£à¸°à¸¡à¸§à¸¥à¸œà¸¥à¸„ำถามหลัà¸, à¸à¸²à¸£à¸ªà¸£à¹‰à¸²à¸‡à¸‚้à¸à¸„วาม, วนซ้ำà¸à¸²à¸£à¹€à¸£à¸µà¸¢à¸à¹ƒà¸Šà¹‰à¹€à¸„รื่à¸à¸‡à¸¡à¸·à¸</td></tr>
|
|
59
|
+
<tr><td><code>src/commands.ts</code></td><td>ทะเบียนคำสั่ง slash (80+ คำสั่ง)</td></tr>
|
|
60
|
+
<tr><td><code>src/tools.ts</code></td><td>ทะเบียนเครื่à¸à¸‡à¸¡à¸·à¸ (40+ เครื่à¸à¸‡à¸¡à¸·à¸à¹ƒà¸™à¸•à¸±à¸§)</td></tr>
|
|
61
|
+
<tr><td><code>src/services/ai/ProviderManager.ts</code></td><td>à¸à¸²à¸£à¹€à¸¥à¸·à¸à¸à¸œà¸¹à¹‰à¹ƒà¸«à¹‰à¸šà¸£à¸´à¸à¸²à¸£, à¸à¸²à¸£à¹à¸à¹‰à¹„ขคีย์ API</td></tr>
|
|
62
|
+
<tr><td><code>src/services/ai/providers.json</code></td><td>à¸à¸²à¸£à¸•à¸±à¹‰à¸‡à¸„่าผู้ให้บริà¸à¸²à¸£ (27 ผู้ให้บริà¸à¸²à¸£)</td></tr>
|
|
63
|
+
</table>
|
|
64
|
+
|
|
65
|
+
<footer class="footer">
|
|
66
|
+
<span>Clew Code 0.2.13 — โà¸à¹€à¸žà¸™à¸‹à¸à¸£à¹Œà¸ª</span>
|
|
67
|
+
<div class="footer-links">
|
|
68
|
+
<a href="https://github.com/ClewCode/ClewCode">GitHub</a>
|
|
69
|
+
<a href="https://github.com/ClewCode/ClewCode/issues">ปัà¸à¸«à¸²</a>
|
|
70
|
+
</div>
|
|
71
|
+
</footer>
|
|
72
|
+
</main>
|
|
73
|
+
<nav class="toc-sidebar"></nav>
|
|
74
|
+
</div>
|
|
75
|
+
</div>
|
|
76
|
+
<script src="js/main.js"></script>
|
|
77
|
+
</body>
|
|
78
|
+
</html>
|
|
79
|
+
|
|
@@ -162,11 +162,11 @@
|
|
|
162
162
|
<body>
|
|
163
163
|
|
|
164
164
|
<div class="hero">
|
|
165
|
-
<h1><em>Clew Code
|
|
165
|
+
<h1><em>Clew Code 0.2.13</em> — Complete Architecture</h1>
|
|
166
166
|
<p>18 interconnected systems powering a multi-provider AI coding agent CLI with terminal UI, P2P mesh, preference learning, and autonomous operation. Fork of Anthropic's Claude Code.</p>
|
|
167
167
|
<div>
|
|
168
168
|
<span class="badge">Bun + React 19 + Ink</span>
|
|
169
|
-
<span class="badge orange">
|
|
169
|
+
<span class="badge orange">28 AI Providers</span>
|
|
170
170
|
<span class="badge green">78 Tool Dirs</span>
|
|
171
171
|
<span class="badge">P2P LAN Mesh</span>
|
|
172
172
|
<span class="badge orange">MCP Client</span>
|
|
@@ -271,7 +271,7 @@
|
|
|
271
271
|
<div class="system-header">
|
|
272
272
|
<span class="num high">2</span>
|
|
273
273
|
<div class="meta">
|
|
274
|
-
<h2>AI Providers <code>
|
|
274
|
+
<h2>AI Providers <code>28 providers · 10 dedicated + 18 compatible</code></h2>
|
|
275
275
|
<div class="sub">
|
|
276
276
|
<span class="complexity-tag high">High</span>
|
|
277
277
|
<span>ProviderManager singleton • 10 provider files • 2197-line providers.json</span>
|
|
@@ -285,7 +285,7 @@
|
|
|
285
285
|
<table>
|
|
286
286
|
<tr><th>Type</th><th>Count</th><th>Providers</th></tr>
|
|
287
287
|
<tr><td><strong>Dedicated Provider classes</strong></td><td>10</td><td><code>AnthropicProvider</code>, <code>OpenAIProvider</code>, <code>GoogleProvider</code>, <code>CohereProvider</code>, <code>OpenRouterProvider</code>, <code>KiloCodeProvider</code>, <code>OllamaProvider</code>, <code>ClewGatewayProvider</code>, <code>OpenAICompatibleProvider</code>, <code>ProviderInterface</code></td></tr>
|
|
288
|
-
<tr><td><strong>OpenAI-compatible (driven by providers.json)</strong></td><td>
|
|
288
|
+
<tr><td><strong>OpenAI-compatible (driven by providers.json)</strong></td><td>20</td><td><code>deepseek</code>, <code>opencode</code>, <code>opencode-go</code>, <code>groq</code>, <code>xai</code>, <code>mistral</code>, <code>together</code>, <code>fireworks</code>, <code>nvidia</code>, <code>deepinfra</code>, <code>perplexity</code>, <code>cerebras</code>, <code>siliconflow</code>, <code>moonshot</code>, <code>zhipu</code>, <code>huggingface</code>, <code>poe</code>, <code>digitalocean</code>, <code>cline</code>, and <code>custom</code></td></tr>
|
|
289
289
|
</table>
|
|
290
290
|
</div>
|
|
291
291
|
|
|
@@ -1117,9 +1117,9 @@
|
|
|
1117
1117
|
</div><!-- /container -->
|
|
1118
1118
|
|
|
1119
1119
|
<div class="footer">
|
|
1120
|
-
Generated from Clew Code
|
|
1120
|
+
Generated from Clew Code 0.2.13 source — covers all 18 systems with verified architecture, data flow, and implementation details.
|
|
1121
1121
|
</div>
|
|
1122
1122
|
|
|
1123
1123
|
</body>
|
|
1124
1124
|
</html>
|
|
1125
|
-
|
|
1125
|
+
|