@sodikinnaa/smart-report-plugin 1.0.0-sultan-beta.0

package/README.md

@@ -0,0 +1,28 @@
+# Smart Report MCP Plugin for OpenClaw (v1.0.8)
+
+Plugin integrasi resmi untuk menghubungkan OpenClaw dengan ekosistem **Smart Report**. Memungkinkan analisis data karyawan, laporan harian, dan dashboard KPI secara real-time.
+
+## 🚀 Quick Start
+```bash
+# 1. Instal Plugin
+openclaw plugins install @sodikinnaa/smart-report-plugin
+
+# 2. Aktivasi Token
+openclaw smart-auth YOUR_SECRET_TOKEN
+```
+
+## 📖 Dokumentasi Lengkap
+Kami telah menyediakan panduan langkah-demi-langkah untuk pengguna teknis maupun non-teknis:
+*   [**Panduan Pengguna (User Guide)**](docs/USER_GUIDE.md) - Prasyarat, Instalasi, Tooling, dan Troubleshooting.
+
+## 🛠️ Fitur Utama
+*   **MCP Integration:** Mendukung standar Model Context Protocol.
+*   **KPI Dashboard:** Data agregasi harian (Compact/Full/Ops mode).
+*   **Deep Analysis:** Tool untuk mendeteksi "Debt Performance" karyawan.
+*   **Division Aware:** Data karyawan sekarang sudah menyertakan nama divisi.
+
+## ⚖️ Lisensi
+Distributed under the MIT License. See `LICENSE` for more information.
+
+---
+*Powered by Sultan Engine*

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+declare const plugin: any;
+export default plugin;
+export declare const register: any;
+export declare const activate: any;

package/dist/index.js

@@ -0,0 +1,166 @@
+/**
+ * Smart Report MCP Plugin for OpenClaw
+ */
+import axios from 'axios';
+const PLUGIN_ID = 'smart-report-plugin';
+const API_BASE = 'https://smartreport.siapdigital.my.id/api/mcp';
+async function callMcp(api, method, params = {}) {
+    const config = api.config;
+    const token = config?.apiToken;
+    if (!token) {
+        throw new Error('API Token not found. Please run "openclaw smart-auth <token>" first.');
+    }
+    const response = await axios.post(API_BASE, {
+        jsonrpc: '2.0',
+        method: method,
+        params: params,
+        id: Date.now()
+    }, {
+        headers: {
+            'Authorization': `Bearer ${token}`,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json'
+        }
+    });
+    if (response.data.error) {
+        throw new Error(response.data.error.message);
+    }
+    return response.data.result;
+}
+const plugin = {
+    id: PLUGIN_ID,
+    name: "Smart Report Integration",
+    version: "6.3.0-beta.0",
+    register(api) {
+        // 1. CLI Commands
+        api.registerCli(({ program }) => {
+            program
+                .command('smart-auth <token>')
+                .description('Set API Token for Smart Report integration')
+                .action(async (token) => {
+                await api.saveConfig({ apiToken: token });
+                console.log('✅ Smart Report API Token saved successfully.');
+            });
+        }, { commands: ['smart-auth'] });
+        // 2. Resources
+        api.registerResource({
+            uri: 'smartreport://reports',
+            name: 'Recent Reports',
+            description: 'Stream of latest submitted reports',
+            mimeType: 'application/json',
+            read: async () => {
+                const data = await callMcp(api, 'reports/list', { per_page: 10 });
+                return { content: JSON.stringify(data, null, 2) };
+            }
+        });
+        api.registerResource({
+            uri: 'smartreport://employees',
+            name: 'Employee List',
+            description: 'Complete list of active employees with division names',
+            mimeType: 'application/json',
+            read: async () => {
+                const data = await callMcp(api, 'employees/list', {});
+                return { content: JSON.stringify(data, null, 2) };
+            }
+        });
+        api.registerResource({
+            uri: 'smartreport://divisions',
+            name: 'Division List',
+            description: 'List of all divisions in the company',
+            mimeType: 'application/json',
+            read: async () => {
+                const data = await callMcp(api, 'divisions/list', {});
+                return { content: JSON.stringify(data, null, 2) };
+            }
+        });
+        api.registerResource({
+            uri: 'smartreport://guides',
+            name: 'Guides List',
+            description: 'List of all available dynamic guides',
+            mimeType: 'application/json',
+            read: async () => {
+                const data = await callMcp(api, 'guides/list', {});
+                return { content: JSON.stringify(data, null, 2) };
+            }
+        });
+        api.registerResource({
+            uri: 'smartreport://dashboard',
+            name: 'Daily Dashboard',
+            description: 'Real-time KPI dashboard (stats, highlights, alerts)',
+            mimeType: 'application/json',
+            read: async (params) => {
+                const data = await callMcp(api, 'smartreport/dashboard', params || {});
+                return { content: JSON.stringify(data, null, 2) };
+            }
+        });
+        // 3. Agent Tools
+        api.registerTool({
+            name: 'get_daily_dashboard',
+            description: 'Retrieve real-time KPI dashboard (stats, highlights, alerts).',
+            execute: async (args) => {
+                try {
+                    const data = await callMcp(api, 'smartreport/dashboard', args);
+                    return { text: JSON.stringify(data, null, 2) };
+                }
+                catch (err) {
+                    return { error: err.message };
+                }
+            }
+        });
+        api.registerTool({
+            name: 'get_guides_list',
+            description: 'Retrieve list of all available dynamic guides.',
+            execute: async () => {
+                try {
+                    const data = await callMcp(api, 'guides/list', {});
+                    return { text: JSON.stringify(data, null, 2) };
+                }
+                catch (err) {
+                    return { error: err.message };
+                }
+            }
+        });
+        api.registerTool({
+            name: 'get_guide_content',
+            description: 'Retrieve full content of a specific guide by ID.',
+            execute: async (args) => {
+                try {
+                    const data = await callMcp(api, 'guides/get', args);
+                    return { text: JSON.stringify(data, null, 2) };
+                }
+                catch (err) {
+                    return { error: err.message };
+                }
+            }
+        });
+        api.registerTool({
+            name: 'get_list_reports',
+            description: 'Retrieve reports with filters (date, employee, division).',
+            execute: async (args) => {
+                try {
+                    const data = await callMcp(api, 'reports/list', args);
+                    return { text: JSON.stringify(data, null, 2) };
+                }
+                catch (err) {
+                    return { error: err.message };
+                }
+            }
+        });
+        api.registerTool({
+            name: 'get_debt_analysis',
+            description: 'Analyze pending tasks and employee performance debt.',
+            execute: async (args) => {
+                try {
+                    const data = await callMcp(api, 'analyze_performance', args);
+                    return { text: JSON.stringify(data, null, 2) };
+                }
+                catch (err) {
+                    return { error: err.message };
+                }
+            }
+        });
+    }
+};
+export default plugin;
+export const register = plugin.register;
+export const activate = plugin.register;

package/docs/USER_GUIDE.md

@@ -0,0 +1,97 @@
+# 📊 Panduan Lengkap Smart Report MCP Plugin
+
+Selamat datang di ekosistem Smart Report! Plugin ini memungkinkan asisten AI Anda (OpenClaw) terhubung langsung dengan data operasional perusahaan secara real-time.
+
+---
+
+## 1. Prasyarat (Prerequisites)
+
+Sebelum instalasi, pastikan Anda memiliki:
+*   **Environment:** Node.js v20+ dan OpenClaw Gateway terpasang.
+*   **Token API:** Token akses sah dari Admin Smart Report (Misal: `Wkr4v8Tj...`).
+*   **Akses Internet:** Dibutuhkan untuk instalasi package dan request data ke server.
+
+---
+
+## 2. Instalasi (Installation)
+
+### Jalur Normal (NPM)
+Gunakan perintah ini di terminal OpenClaw:
+```bash
+openclaw plugins install @sodikinnaa/smart-report-plugin
+```
+
+### Jalur Fallback (Jika NPM/Cache Bermasalah)
+Jika instalasi gagal karena kendala versi lama atau cache, gunakan link tarball langsung:
+```bash
+openclaw plugins install https://registry.npmjs.org/@sodikinnaa/smart-report-plugin/-/smart-report-plugin-1.0.8.tgz
+```
+
+---
+
+## 3. Aktivasi & Autentikasi (Auth)
+
+Setelah terinstal, Anda wajib mendaftarkan token Anda agar AI bisa mengakses data:
+
+**Perintah:**
+```bash
+openclaw smart-auth <TOKEN_ANDA>
+```
+
+**Contoh Sukses:**
+`✅ Smart Report API Token saved successfully.`
+
+**Contoh Gagal:**
+`❌ Failed to save config: ...` (Pastikan Anda menjalankan perintah di terminal yang memiliki izin tulis ke folder `.openclaw`).
+
+---
+
+## 4. Daftar Resource & Tool
+
+### 🔎 Resource (Data Statis/Stream)
+AI dapat membaca resource ini untuk mendapatkan konteks:
+*   `smartreport://dashboard`: Data KPI hari ini (Total karyawan, kehadiran, completion rate).
+*   `smartreport://employees`: Daftar lengkap karyawan beserta nama divisinya.
+*   `smartreport://reports`: Aliran 10 laporan terbaru yang masuk.
+*   `smartreport://divisions`: Daftar seluruh divisi di perusahaan.
+
+### 🛠️ Agent Tools (Aksi Dinamis)
+AI dapat menjalankan perintah spesifik:
+*   **`get_daily_dashboard`**: Mengambil ringkasan statistik harian.
+*   **`get_list_reports`**: Mencari laporan berdasarkan filter (tanggal, divisi, nama).
+*   **`get_debt_analysis`**: Menganalisis siapa saja yang belum lapor atau memiliki tugas tertunda.
+
+---
+
+## 5. Mode Dashboard
+
+Saat meminta dashboard, Anda dapat menentukan `mode`:
+1.  **Compact (Default):** Ringkasan angka utama saja. Cocok untuk update cepat di chat.
+2.  **Full:** Menyertakan detail statistik per divisi. Cocok untuk laporan manajemen.
+3.  **Ops:** Menyertakan alert sistem dan highlight operasional. Cocok untuk monitoring tim.
+
+---
+
+## 6. Workflow Harian (Best Practice)
+
+Berikut adalah contoh alur kerja asisten AI Anda setiap hari:
+1.  **Pagi (09:00):** AI mengecek `smartreport://employees` untuk memetakan tim.
+2.  **Siang (13:00):** AI menjalankan `get_daily_dashboard(mode="compact")` untuk melihat progres awal.
+3.  **Sore (17:00):** AI menjalankan `get_debt_analysis` dan memberikan daftar orang yang belum lapor kepada Admin.
+4.  **Malam (20:00):** AI menarik `get_daily_dashboard(mode="full")` untuk laporan penutup ke WhatsApp Owner.
+
+---
+
+## 7. Troubleshooting (Solusi Cepat)
+
+*   **Error: `ReferenceError exports is not defined`**
+    *   *Solusi:* Update ke versi v1.0.6+ (`npm install ...@latest`).
+*   **Error: `package.json missing openclaw.extensions`**
+    *   *Solusi:* Update ke versi v1.0.4+.
+*   **Error: `Method not found (-32601)`**
+    *   *Solusi:* Pastikan backend sudah terupdate ke v1.3.0.
+*   **Error: `Unauthorized`**
+    *   *Solusi:* Masukkan kembali token valid menggunakan `openclaw smart-auth`.
+
+---
+*Dokumentasi ini dibuat oleh Sultan Engine Core untuk memastikan kelancaran operasional Anda.*

package/openclaw.plugin.json

@@ -0,0 +1,14 @@
+{
+  "id": "smart-report-plugin",
+  "name": "Smart Report Integration",
+  "version": "6.3.0-beta.0",
+  "description": "Integration plugin for Smart Report and AI Analytics with Daily Dashboard and Dynamic Guides",
+  "main": "dist/index.js",
+  "skills": ["skills/smart-report/SKILL.md"],
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "apiToken": { "type": "string" }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@sodikinnaa/smart-report-plugin",
+  "version": "1.0.0-sultan-beta.0",
+  "description": "OpenClaw plugin for Smart Report system integration with Daily Dashboard",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "node test/simple.test.js",
+    "publish": "npm publish --access public"
+  },
+  "keywords": [
+    "openclaw-plugin",
+    "smart-report",
+    "dashboard"
+  ],
+  "author": "Sodikin",
+  "license": "MIT",
+  "openclaw": {
+    "extensions": [
+      "./openclaw.plugin.json"
+    ]
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/smart-report/SKILL.md

@@ -0,0 +1,48 @@
+# Skill: Smart Report Dashboard & Analysis
+
+Gunakan skill ini untuk berinteraksi dengan sistem Smart Report. AI diharapkan memformat respons secara profesional menggunakan elemen visual dashboard.
+
+## Formatting Protocol (Wajib)
+
+Setiap kali Anda menerima data dari tool `smart-report-plugin`, Anda **DILARANG** menampilkan JSON mentah. Anda harus memanipulasinya menjadi format berikut:
+
+### 1. Dashboard Mode (`get_daily_dashboard`)
+Tampilkan data dalam blok kode (backticks) dengan struktur ala dashboard:
+```text
+📊 [NAMA PERUSAHAAN] - DAILY KPI
+Tanggal: [Date] | Mode: [Mode]
+
+📈 STATS UTAMA:
+- Total Karyawan : [total_karyawan]
+- Sudah Lapor    : [sudah_lapor] ✅
+- Belum Lapor    : [belum_lapor] ⚠️
+- Completion     : [completion_rate]
+
+📂 STATS DIVISI:
+[Looping: Nama Divisi: X Reports]
+
+💡 HIGHLIGHTS:
+- Update Terakhir: [latest_submission]
+
+⚠️ ALERTS:
+- [Alert 1]
+- [Alert 2]
+```
+
+### 2. Employee List (`smartreport://employees`)
+Gunakan list berpoin yang rapi:
+*   👤 **[Nama Karyawan]** - [Division Name] ([Email])
+
+### 3. Report List (`get_list_reports`)
+Tampilkan ringkasan eksekutif:
+*   📅 **[Tanggal]**: [Jumlah] laporan diterima.
+*   Detail: [Link/ID laporan jika ada].
+
+### 4. Guides Management (`smartreport://guides`)
+Tampilkan informasi edukatif:
+*   📚 **[Judul Guide]** (Kategori: [Category]) - ID: [id]
+
+Gunakan tool `get_guide_content` untuk membaca detail instruksi.
+
+---
+*Generated by: SUL*** Eng***

package/src/index.ts

@@ -0,0 +1,180 @@
+/**
+ * Smart Report MCP Plugin for OpenClaw
+ */
+import axios from 'axios';
+
+const PLUGIN_ID = 'smart-report-plugin';
+const API_BASE = 'https://smartreport.siapdigital.my.id/api/mcp';
+
+async function callMcp(api: any, method: string, params: any = {}) {
+    const config: any = api.config;
+    const token = config?.apiToken;
+    
+    if (!token) {
+        throw new Error('API Token not found. Please run "openclaw smart-auth <token>" first.');
+    }
+
+    const response = await axios.post(API_BASE, {
+        jsonrpc: '2.0',
+        method: method,
+        params: params,
+        id: Date.now()
+    }, {
+        headers: {
+            'Authorization': `Bearer ${token}`,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json'
+        }
+    });
+
+    if (response.data.error) {
+        throw new Error(response.data.error.message);
+    }
+
+    return response.data.result;
+}
+
+const plugin: any = {
+    id: PLUGIN_ID,
+    name: "Smart Report Integration",
+    version: "6.3.0-beta.0",
+    
+    register(api: any) {
+        // 1. CLI Commands
+        api.registerCli(({ program }: any) => {
+            program
+                .command('smart-auth <token>')
+                .description('Set API Token for Smart Report integration')
+                .action(async (token: string) => {
+                    await api.saveConfig({ apiToken: token });
+                    console.log('✅ Smart Report API Token saved successfully.');
+                });
+        }, { commands: ['smart-auth'] });
+
+        // 2. Resources
+        api.registerResource({
+            uri: 'smartreport://reports',
+            name: 'Recent Reports',
+            description: 'Stream of latest submitted reports',
+            mimeType: 'application/json',
+            read: async () => {
+                const data = await callMcp(api, 'reports/list', { per_page: 10 });
+                return { content: JSON.stringify(data, null, 2) };
+            }
+        });
+
+        api.registerResource({
+            uri: 'smartreport://employees',
+            name: 'Employee List',
+            description: 'Complete list of active employees with division names',
+            mimeType: 'application/json',
+            read: async () => {
+                const data = await callMcp(api, 'employees/list', {});
+                return { content: JSON.stringify(data, null, 2) };
+            }
+        });
+
+        api.registerResource({
+            uri: 'smartreport://divisions',
+            name: 'Division List',
+            description: 'List of all divisions in the company',
+            mimeType: 'application/json',
+            read: async () => {
+                const data = await callMcp(api, 'divisions/list', {});
+                return { content: JSON.stringify(data, null, 2) };
+            }
+        });
+
+        api.registerResource({
+            uri: 'smartreport://guides',
+            name: 'Guides List',
+            description: 'List of all available dynamic guides',
+            mimeType: 'application/json',
+            read: async () => {
+                const data = await callMcp(api, 'guides/list', {});
+                return { content: JSON.stringify(data, null, 2) };
+            }
+        });
+
+        api.registerResource({
+            uri: 'smartreport://dashboard',
+            name: 'Daily Dashboard',
+            description: 'Real-time KPI dashboard (stats, highlights, alerts)',
+            mimeType: 'application/json',
+            read: async (params: any) => {
+                const data = await callMcp(api, 'smartreport/dashboard', params || {});
+                return { content: JSON.stringify(data, null, 2) };
+            }
+        });
+
+        // 3. Agent Tools
+        api.registerTool({
+            name: 'get_daily_dashboard',
+            description: 'Retrieve real-time KPI dashboard (stats, highlights, alerts).',
+            execute: async (args: any) => {
+                try {
+                    const data = await callMcp(api, 'smartreport/dashboard', args);
+                    return { text: JSON.stringify(data, null, 2) };
+                } catch (err: any) {
+                    return { error: err.message };
+                }
+            }
+        });
+
+        api.registerTool({
+            name: 'get_guides_list',
+            description: 'Retrieve list of all available dynamic guides.',
+            execute: async () => {
+                try {
+                    const data = await callMcp(api, 'guides/list', {});
+                    return { text: JSON.stringify(data, null, 2) };
+                } catch (err: any) {
+                    return { error: err.message };
+                }
+            }
+        });
+
+        api.registerTool({
+            name: 'get_guide_content',
+            description: 'Retrieve full content of a specific guide by ID.',
+            execute: async (args: any) => {
+                try {
+                    const data = await callMcp(api, 'guides/get', args);
+                    return { text: JSON.stringify(data, null, 2) };
+                } catch (err: any) {
+                    return { error: err.message };
+                }
+            }
+        });
+
+        api.registerTool({
+            name: 'get_list_reports',
+            description: 'Retrieve reports with filters (date, employee, division).',
+            execute: async (args: any) => {
+                try {
+                    const data = await callMcp(api, 'reports/list', args);
+                    return { text: JSON.stringify(data, null, 2) };
+                } catch (err: any) {
+                    return { error: err.message };
+                }
+            }
+        });
+
+        api.registerTool({
+            name: 'get_debt_analysis',
+            description: 'Analyze pending tasks and employee performance debt.',
+            execute: async (args: any) => {
+                try {
+                    const data = await callMcp(api, 'analyze_performance', args);
+                    return { text: JSON.stringify(data, null, 2) };
+                } catch (err: any) {
+                    return { error: err.message };
+                }
+            }
+        });
+    }
+};
+
+export default plugin;
+export const register = plugin.register;
+export const activate = plugin.register;

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "NodeNext",
+    "lib": ["ESNext"],
+    "declaration": true,
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "NodeNext"
+  },
+  "include": ["src/**/*"]
+}