vantuz 3.2.5 → 3.2.7

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.
@@ -0,0 +1,10 @@
1
+ @echo off
2
+ rem OpenClaw Gateway (v2026.2.9)
3
+ set PATH=C:\Program Files\Common Files\Oracle\Java\javapath;C:\Program Files (x86)\Common Files\Oracle\Java\java8path;C:\Program Files (x86)\Common Files\Oracle\Java\javapath;C:\Python27\python.exe;C:\Python27\Scripts;C:\Program Files (x86)\Nmap\;c:\Users\OSMBILISIM\AppData\Local\Programs\cursor\resources\app\bin;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\WINDOWS\System32\WindowsPowerShell\v1.0\;C:\WINDOWS\System32\OpenSSH\;C:\Program Files\CMake\bin;C:\Program Files\Docker\Docker\resources\bin;C:\Program Files\PostgreSQL\15\bin;C:\Users\Osmbilisimsatis\AppData\Roaming\npm;C:\Users\OSMBILISIM\scoop\shims;C:\Users\OSMBILISIM\AppData\Local\Programs\Python\Python310\Scripts\;C:\Users\OSMBILISIM\AppData\Local\Programs\Python\Python310\;C:\Users\OSMBILISIM\AppData\Local\Microsoft\WindowsApps;C:\Users\OSMBILISIM\AppData\Local\Programs\Git\cmd;C:\Users\OSMBILISIM\AppData\Roaming\npm;C:\Users\OSMBILISIM\AppData\Local\Programs\Windsurf\bin;C:\Users\OSMBILISIM\AppData\Local\Programs\cursor\resources\app\bin;c:\Users\OSMBILISIM\AppData\Local\Programs\cursor\resources\app\bin;C:\Program Files\GitHub CLI\;C:\Program Files\Void\bin;C:\Users\OSMBILISIM\Downloads\flutter\bin;C:\Users\OSMBILISIM\Downloads\php-8.4.11-nts-Win32-vs17-x64;C:\Users\OSMBILISIM\Downloads\flutter\bin;C:\xampp\php;C:\ProgramData\ComposerSetup\bin;C:\Ruby34-x64\msys64\ucrt64\bin;C:\Ruby34-x64\bin;C:\Users\OSMBILISIM\AppData\Local\Programs\Python\Python310\python.exe;C:\Users\OSMBILISIM\go\bin;C:\Program Files\Go\bin;C:\Strawberry\c\bin;C:\Strawberry\perl\site\bin;C:\Strawberry\perl\bin;C:\Program Files\nodejs\;C:\Program Files\dotnet\;C:\Program Files\cursor\resources\app\bin;C:\Program Files\Tailscale\;C:\Python27\python.exe;C:\Python27\Scripts;C:\Program Files (x86)\Nmap\;C:\Program Files (x86)\Common Files\Oracle\Java\javapath;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\WINDOWS\System32\WindowsPowerShell\v1.0\;C:\WINDOWS\System32\OpenSSH\;C:\Program Files\CMake\bin;C:\Program Files\Docker\Docker\resources\bin;C:\Program Files\PostgreSQL\15\bin;C:\Users\Osmbilisimsatis\AppData\Roaming\npm;C:\Users\OSMBILISIM\scoop\shims;C:\Users\OSMBILISIM\AppData\Local\Programs\Python\Python310\Scripts\;C:\Users\OSMBILISIM\AppData\Local\Programs\Python\Python310\;C:\Users\OSMBILISIM\AppData\Local\Microsoft\WindowsApps;C:\Users\OSMBILISIM\AppData\Local\Programs\Git\cmd;C:\Users\OSMBILISIM\AppData\Local\Programs\Windsurf\bin;C:\Program Files\GitHub CLI\;C:\Program Files;C:\Users\OSMBILISIM\go\bin;C:\Users\OSMBILISIM\AppData\Local\Programs\Qoder\bin;C:\Users\OSMBILISIM\AppData\Roaming\npm;C:\Users\OSMBILISIM\AppData\Local\Programs\Antigravity\bin;C:\Users\OSMBILISIM\AppData\Local\Programs\Ollama
4
+ set OPENCLAW_GATEWAY_PORT=18789
5
+ set OPENCLAW_GATEWAY_TOKEN=e432e1210dcfb65a16122ce44ccaabeb6fefac299759b841
6
+ set OPENCLAW_SYSTEMD_UNIT=openclaw-gateway.service
7
+ set OPENCLAW_SERVICE_MARKER=openclaw
8
+ set OPENCLAW_SERVICE_KIND=gateway
9
+ set OPENCLAW_SERVICE_VERSION=2026.2.9
10
+ call npx openclaw gateway --port 18789 --allow-unconfigured
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 1,
3
+ "deviceId": "b37c08a4ffb5fb274c735d5c4a9dafa001447d8ac18b05102129e2cafed4307c",
4
+ "publicKeyPem": "-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEA/WoKlAj3d+1nj3EEJaiCy+N4drHLu3/+q00EJeNDXtk=\n-----END PUBLIC KEY-----\n",
5
+ "privateKeyPem": "-----BEGIN PRIVATE KEY-----\nMC4CAQAwBQYDK2VwBCIEIGk9gpUGGch4gQg/ozBZf0R63/MXlTqQju9U6IuZQpaB\n-----END PRIVATE KEY-----\n",
6
+ "createdAtMs": 1770715930222
7
+ }
@@ -0,0 +1,32 @@
1
+ {
2
+ "messages": {
3
+ "ackReactionScope": "group-mentions"
4
+ },
5
+ "agents": {
6
+ "defaults": {
7
+ "maxConcurrent": 4,
8
+ "subagents": {
9
+ "maxConcurrent": 8
10
+ },
11
+ "compaction": {
12
+ "mode": "safeguard"
13
+ }
14
+ }
15
+ },
16
+ "gateway": {
17
+ "auth": {
18
+ "mode": "token",
19
+ "token": "e432e1210dcfb65a16122ce44ccaabeb6fefac299759b841"
20
+ }
21
+ },
22
+ "wizard": {
23
+ "lastRunAt": "2026-02-10T09:32:30.166Z",
24
+ "lastRunVersion": "2026.2.9",
25
+ "lastRunCommand": "doctor",
26
+ "lastRunMode": "local"
27
+ },
28
+ "meta": {
29
+ "lastTouchedVersion": "2026.2.9",
30
+ "lastTouchedAt": "2026-02-10T09:32:30.181Z"
31
+ }
32
+ }
package/DOCS_TR.md ADDED
@@ -0,0 +1,298 @@
1
+ # 🐙 Vantuz AI - Türkçe Teknik Dokümantasyon
2
+
3
+ ## İçindekiler
4
+
5
+ 1. [Mimari Genel Bakış](#mimari)
6
+ 2. [Plugin Yapısı](#plugin-yapısı)
7
+ 3. [Tools (Araçlar)](#tools)
8
+ 4. [Commands (Komutlar)](#commands)
9
+ 5. [Services (Servisler)](#services)
10
+ 6. [Hippocampus Hafıza](#hippocampus)
11
+ 7. [Yapılandırma](#yapılandırma)
12
+ 8. [API Referansı](#api-referansı)
13
+
14
+ ---
15
+
16
+ ## Mimari
17
+
18
+ Vantuz, **OpenClaw Gateway** üzerine inşa edilmiş bir plugin sistemidir.
19
+
20
+ ```
21
+ ┌─────────────────────────────────────────────────────────────┐
22
+ │ OpenClaw Gateway │
23
+ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
24
+ │ │ WhatsApp │ │ Telegram │ │ Discord │ │
25
+ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
26
+ │ │ │ │ │
27
+ │ └─────────────┼─────────────┘ │
28
+ │ ▼ │
29
+ │ ┌─────────────┐ │
30
+ │ │ Vantuz Core │ │
31
+ │ │ Plugin │ │
32
+ │ └─────┬───────┘ │
33
+ │ │ │
34
+ │ ┌───────┬───────┼───────┬───────┐ │
35
+ │ ▼ ▼ ▼ ▼ ▼ │
36
+ │ ┌──────┐┌──────┐┌──────┐┌──────┐┌──────┐ │
37
+ │ │Repri-││Vision││Senti-││Cross-││Analy-│ │
38
+ │ │cer ││ AI ││ment ││Border││tics │ │
39
+ │ └──────┘└──────┘└──────┘└──────┘└──────┘ │
40
+ │ │ │
41
+ │ ┌─────▼───────┐ │
42
+ │ │ Hippocampus │ │
43
+ │ │ Memory │ │
44
+ │ └─────────────┘ │
45
+ └─────────────────────────────────────────────────────────────┘
46
+ ```
47
+
48
+ ---
49
+
50
+ ## Plugin Yapısı
51
+
52
+ ```
53
+ plugins/vantuz/
54
+ ├── index.js # Ana plugin entry point
55
+ ├── package.json # Plugin manifest
56
+ ├── tools/
57
+ │ ├── repricer.js # Kan Emici fiyat robotu
58
+ │ ├── vision.js # Fotoğraf → ürün
59
+ │ ├── sentiment.js # Yorum analizi
60
+ │ ├── crossborder.js # Sınır ötesi satış
61
+ │ ├── product.js # Ürün CRUD
62
+ │ └── analytics.js # Raporlama
63
+ ├── services/
64
+ │ └── license.js # Lisans doğrulama
65
+ ├── memory/
66
+ │ └── hippocampus.js # Hafıza sistemi
67
+ └── platforms/
68
+ └── index.js # Pazaryeri API stubs
69
+ ```
70
+
71
+ ---
72
+
73
+ ## Tools
74
+
75
+ ### vantuz.repricer
76
+
77
+ Rakip fiyatlarını analiz eder ve karar verir.
78
+
79
+ **Parametreler:**
80
+ | Param | Tip | Zorunlu | Açıklama |
81
+ |-------|-----|---------|----------|
82
+ | barcode | string | ✅ | Ürün barkodu/SKU |
83
+ | platform | string | - | trendyol, hepsiburada, amazon, n11, all |
84
+ | targetMargin | number | - | Hedef kar marjı % |
85
+ | action | string | - | analyze, apply, schedule |
86
+
87
+ **Örnek:**
88
+ ```json
89
+ {
90
+ "name": "vantuz.repricer",
91
+ "parameters": {
92
+ "barcode": "SKU-12345",
93
+ "platform": "trendyol",
94
+ "targetMargin": 25,
95
+ "action": "analyze"
96
+ }
97
+ }
98
+ ```
99
+
100
+ ---
101
+
102
+ ### vantuz.vision
103
+
104
+ Fotoğraftan ürün bilgisi çıkarır.
105
+
106
+ **Parametreler:**
107
+ | Param | Tip | Zorunlu | Açıklama |
108
+ |-------|-----|---------|----------|
109
+ | imageUrl | string | ✅ | Görsel URL veya base64 |
110
+ | targetPlatforms | array | - | Hedef pazaryerleri |
111
+ | autoPublish | boolean | - | Otomatik yayınla |
112
+
113
+ ---
114
+
115
+ ### vantuz.sentiment
116
+
117
+ Müşteri yorumlarını analiz eder.
118
+
119
+ **Parametreler:**
120
+ | Param | Tip | Zorunlu | Açıklama |
121
+ |-------|-----|---------|----------|
122
+ | productId | string | ✅ | Ürün ID/barkod |
123
+ | platform | string | - | Pazaryeri |
124
+ | period | string | - | 7d, 30d, 90d, all |
125
+
126
+ ---
127
+
128
+ ### vantuz.crossborder
129
+
130
+ Uluslararası satış hazırlığı yapar.
131
+
132
+ **Parametreler:**
133
+ | Param | Tip | Zorunlu | Açıklama |
134
+ |-------|-----|---------|----------|
135
+ | productId | string | ✅ | Kaynak ürün ID |
136
+ | targetMarket | string | ✅ | de, us, uk, fr |
137
+ | fulfillment | string | - | fba, fbm, self |
138
+
139
+ ---
140
+
141
+ ## Commands
142
+
143
+ Kullanıcılar WhatsApp/Telegram'dan doğrudan kullanabilir:
144
+
145
+ | Komut | Açıklama | Örnek |
146
+ |-------|----------|-------|
147
+ | `/stok` | Stok özeti | `/stok trendyol` |
148
+ | `/fiyat` | Fiyat güncelle | `/fiyat SKU123 199` |
149
+ | `/rapor` | Satış raporu | `/rapor 7d` |
150
+ | `/rakip` | Rakip analizi | `/rakip SKU123` |
151
+ | `/lisans` | Lisans durumu | `/lisans` |
152
+
153
+ ---
154
+
155
+ ## Services
156
+
157
+ ### vantuz-license
158
+ Başlatmada lisans doğrulaması yapar. Her 24 saatte bir kontrol tekrarlanır.
159
+
160
+ ### vantuz-memory
161
+ Hippocampus hafıza sistemini başlatır ve yönetir.
162
+
163
+ ### vantuz-repricer-daemon
164
+ Her 15 dakikada bir otomatik fiyat kontrolü yapar.
165
+
166
+ ---
167
+
168
+ ## Hippocampus
169
+
170
+ SQLite tabanlı gelişmiş hafıza sistemi.
171
+
172
+ ### Tablolar
173
+
174
+ **Memory** - Genel hafıza
175
+ - type: decision, price_change, product, conversation, insight
176
+ - content: Hafıza içeriği
177
+ - importance: 0-1 önem skoru
178
+ - accessCount: Erişim sayısı
179
+
180
+ **PricingDecision** - Fiyat kararları
181
+ - barcode, previousPrice, newPrice, reason, outcome
182
+
183
+ **ProductContext** - Ürün bağlamı
184
+ - avgSalePrice, competitorHistory, customerSentiment
185
+
186
+ **LearnedRule** - Öğrenilen kurallar
187
+ - trigger, condition, action, confidence
188
+
189
+ ### Özellikler
190
+
191
+ - **Konsolidasyon**: Her gece 03:00'te eski/önemsiz hafızalar temizlenir
192
+ - **Öğrenme**: Başarılı kararlar otomatik kural olur
193
+ - **Bağlamsal Hatırlama**: İlgili hafızalar sorgulanabilir
194
+
195
+ ---
196
+
197
+ ## Yapılandırma
198
+
199
+ ### .openclaw/openclaw.json
200
+
201
+ ```json
202
+ {
203
+ "agents": {
204
+ "defaults": {
205
+ "workspace": "./workspace"
206
+ }
207
+ },
208
+ "channels": {
209
+ "whatsapp": { "enabled": true },
210
+ "telegram": {
211
+ "enabled": true,
212
+ "botToken": "${TELEGRAM_BOT_TOKEN}"
213
+ }
214
+ },
215
+ "models": {
216
+ "openai": {
217
+ "apiKey": "${OPENAI_API_KEY}"
218
+ }
219
+ },
220
+ "plugins": {
221
+ "load": {
222
+ "paths": ["./plugins/vantuz"]
223
+ }
224
+ }
225
+ }
226
+ ```
227
+
228
+ ### .env
229
+
230
+ ```env
231
+ OPENAI_API_KEY=sk-...
232
+ TELEGRAM_BOT_TOKEN=123456:ABC...
233
+ VANTUZ_LICENSE_KEY=...
234
+ ```
235
+
236
+ ---
237
+
238
+ ## API Referansı
239
+
240
+ ### Gateway RPC
241
+
242
+ **vantuz.status**
243
+ ```json
244
+ {
245
+ "version": "2.0.0",
246
+ "license": { "valid": true, "customer": "..." },
247
+ "memory": { "memories": 150, "decisions": 45 },
248
+ "platforms": { "trendyol": true, "hepsiburada": true }
249
+ }
250
+ ```
251
+
252
+ **vantuz.config**
253
+ ```json
254
+ // GET
255
+ { "action": "get" }
256
+
257
+ // SET
258
+ { "action": "set", "data": { "repricerInterval": 30 } }
259
+ ```
260
+
261
+ ---
262
+
263
+ ## Geliştirme
264
+
265
+ ### Yeni Tool Ekleme
266
+
267
+ ```javascript
268
+ // plugins/vantuz/tools/myTool.js
269
+ export const myTool = {
270
+ name: 'my-tool',
271
+ async execute(params, context) {
272
+ const { api, memory, license } = context;
273
+ // ...
274
+ return { success: true, data: {} };
275
+ }
276
+ };
277
+
278
+ // index.js'de register et
279
+ api.registerTool({
280
+ name: 'vantuz.mytool',
281
+ description: '...',
282
+ parameters: { ... },
283
+ handler: (params) => myTool.execute(params, context)
284
+ });
285
+ ```
286
+
287
+ ### Yeni Command Ekleme
288
+
289
+ ```javascript
290
+ api.registerCommand({
291
+ name: 'mycommand',
292
+ description: 'Açıklama',
293
+ acceptsArgs: true,
294
+ handler: async (ctx) => {
295
+ return { text: 'Yanıt' };
296
+ }
297
+ });
298
+ ```