kiosapi 0.1.27 → 0.1.29

package/dist/agent/team.js

@@ -1,4 +1,5 @@
 import { modelSupportsTools } from '../api.js';
+import { clearTimCheckpoint, saveTimCheckpoint } from '../config.js';
 import { bold, dim, green, yellow } from '../ui.js';
 import { newSession, runTurn } from './run.js';
 /**
@@ -33,85 +34,164 @@ function tryParsePlan(output) {
 // ---------------------------------------------------------------------------
 // Built-in team: planner-executor
 // ---------------------------------------------------------------------------
-const PLANNER_BRIEF = `Peranmu: PERENCANA. Telusuri kode seperlunya lalu buat rencana langkah kecil & terstruktur.
+const PLANNER_BRIEF = `Peranmu: PERENCANA. Baca SELURUH spesifikasi terlebih dahulu.
 
-WAJIB: panggil tool "selesai" dengan parameter ringkasan berisi JSON dalam format TEPAT ini (tidak ada teks lain sebelum/sesudah JSON):
+LANGKAH WAJIB SEBELUM MERENCANAKAN:
+1. Cari dan baca file spesifikasi/blueprint: blueprint.md, SPEC.md, README.md, atau file .md di root
+2. Pelajari struktur proyek yang sudah ada (daftar_file)
+3. Baru buat rencana langkah yang KOMPREHENSIF mencakup SEMUA fitur yang diminta
+
+WAJIB: panggil tool "selesai" dengan parameter ringkasan berisi JSON dalam format TEPAT ini:
 {"ringkasan":"<ringkasan singkat>","langkah":[{"tugas":"<deskripsi spesifik & actionable>","file":["path/file1.ts"],"catatan":"<konteks tambahan, opsional>"},...]}
 
 Aturan rencana:
-- Masing-masing langkah: 1–3 file, satu perubahan jelas, bisa selesai dalam ~15 tool calls.
-- Maksimal 10 langkah — pecah yang kompleks, gabung yang trivial.
-- Sebutkan path file LENGKAP dan AKURAT (gunakan daftar_file untuk memastikan).
-- JANGAN menulis kode — hanya rencanakan.`;
+- Masing-masing langkah: 1–3 file, satu perubahan jelas
+- Maksimal 15 langkah (untuk aplikasi besar buat lebih banyak langkah kecil)
+- Sebutkan path file LENGKAP dan AKURAT (gunakan daftar_file untuk memastikan)
+- JANGAN menulis kode — hanya rencanakan
+- Pastikan rencana LENGKAP — tidak ada fitur yang terlewat dari spesifikasi`;
 const REVIEWER_BRIEF = 'Peranmu: PENINJAU. Baca file yang relevan dan tinjau hasil implementasi: sebutkan masalah/risiko & saran perbaikan singkat.';
-export async function runTeam(task, opts) {
+/** Append role brief to the existing system message (index 0) instead of pushing a second
+ * system message. Many providers reject or ignore a second {role:'system'} entry before the
+ * first user turn, causing the agent to ignore its role instructions entirely. */
+function appendBrief(session, brief) {
+    const sys = session.messages[0];
+    if (sys?.role === 'system') {
+        sys.content += `\n\n${brief}`;
+    }
+}
+export async function runTeam(task, opts, resume) {
     console.log(bold('👥 Tim agen — mode perencana-eksekutor'));
-    // ① Planner
-    console.log(`\n${bold('① Perencana')} ${dim(`(${opts.models.perencana})`)}`);
-    const plannerSession = newSession(opts.models.perencana, 'rencana', opts.otomatis);
-    plannerSession.messages.push({ role: 'system', content: PLANNER_BRIEF });
-    const planOutput = await runTurn(plannerSession, task);
-    const plan = tryParsePlan(planOutput);
-    if (!plan) {
-        console.log(yellow('⚠ Perencana tidak menghasilkan rencana terstruktur — jalankan sebagai sesi pengkode tunggal.'));
-        const s = newSession(opts.models.pengkode, 'buat', opts.otomatis);
-        s.messages.push({
-            role: 'system',
-            content: 'Peranmu: PENGKODE. Implementasikan tugas mengikuti rencana. Buat perubahan kecil & jelas, lalu panggil selesai.',
-        });
-        await runTurn(s, `Tugas: ${task}\n\nRencana:\n${planOutput || '(tidak ada rencana eksplisit)'}`);
-        console.log(`\n${bold('③ Peninjau')} ${dim(`(${opts.models.peninjau})`)}`);
-        const rev = newSession(opts.models.peninjau, 'rencana', opts.otomatis);
-        rev.messages.push({ role: 'system', content: REVIEWER_BRIEF });
-        await runTurn(rev, `Tinjau hasil implementasi untuk tugas: ${task}`);
-        console.log(green('\n✓ Tim selesai.'));
-        return;
+    let plan = null;
+    // If resuming with a saved plan, skip the planner phase entirely
+    if (resume?.plan) {
+        plan = resume.plan;
+        console.log(yellow(`↩ Melanjutkan dari rencana tersimpan (${plan.langkah.length} langkah)`));
+        console.log(bold(`\n📋 ${plan.ringkasan}`));
+        for (const [i, step] of plan.langkah.entries()) {
+            const done = i < (resume.startFromStep ?? 0);
+            const marker = done ? dim('✓') : dim(`${i + 1}.`);
+            const label = done ? dim(step.tugas) : step.tugas;
+            console.log(`  ${marker} ${label}`);
+            if (!done) {
+                console.log(dim(`     📄 ${step.file.join(', ')}`));
+                if (step.catatan)
+                    console.log(dim(`     💬 ${step.catatan}`));
+            }
+        }
+        console.log('');
     }
-    // Show plan
-    console.log(bold(`\n📋 ${plan.ringkasan}`));
-    for (const [i, step] of plan.langkah.entries()) {
-        console.log(`  ${dim(`${i + 1}.`)} ${step.tugas}`);
-        console.log(dim(`     📄 ${step.file.join(', ')}`));
-        if (step.catatan)
-            console.log(dim(`     💬 ${step.catatan}`));
+    else {
+        // ① Planner
+        console.log(`\n${bold('① Perencana')} ${dim(`(${opts.models.perencana})`)}`);
+        const plannerSession = newSession(opts.models.perencana, 'rencana', opts.otomatis);
+        appendBrief(plannerSession, PLANNER_BRIEF);
+        const planOutput = await runTurn(plannerSession, task);
+        plan = tryParsePlan(planOutput);
+        // Retry once if the planner didn't output valid JSON — it may have just forgotten the format.
+        if (!plan && planOutput.trim()) {
+            console.log(yellow('⚠ Rencana tidak valid — mencoba ulang sekali...'));
+            const retryOutput = await runTurn(plannerSession, 'Output sebelumnya tidak valid. Keluarkan HANYA JSON ini tanpa teks lain:\n{"ringkasan":"...","langkah":[{"tugas":"...","file":["path/file.ts"]}]}');
+            plan = tryParsePlan(retryOutput);
+        }
+        if (!plan) {
+            console.log(yellow('⚠ Perencana tidak menghasilkan rencana terstruktur — jalankan sebagai sesi pengkode tunggal.'));
+            const s = newSession(opts.models.pengkode, 'buat', opts.otomatis);
+            appendBrief(s, 'Peranmu: PENGKODE. Implementasikan tugas mengikuti rencana. Buat perubahan kecil & jelas, lalu panggil selesai.');
+            await runTurn(s, `Tugas: ${task}\n\nRencana:\n${planOutput || '(tidak ada rencana eksplisit)'}`);
+            clearTimCheckpoint();
+            console.log(`\n${bold('③ Peninjau')} ${dim(`(${opts.models.peninjau})`)}`);
+            const rev = newSession(opts.models.peninjau, 'rencana', opts.otomatis);
+            appendBrief(rev, REVIEWER_BRIEF);
+            await runTurn(rev, `Tinjau hasil implementasi untuk tugas: ${task}`);
+            console.log(green('\n✓ Tim selesai.'));
+            return;
+        }
+        // Show plan
+        console.log(bold(`\n📋 ${plan.ringkasan}`));
+        for (const [i, step] of plan.langkah.entries()) {
+            console.log(`  ${dim(`${i + 1}.`)} ${step.tugas}`);
+            console.log(dim(`     📄 ${step.file.join(', ')}`));
+            if (step.catatan)
+                console.log(dim(`     💬 ${step.catatan}`));
+        }
+        console.log('');
+        // Save checkpoint as soon as the plan is established — if execution is interrupted,
+        // `kiosapi lanjut` can resume from step 0 with the existing plan.
+        saveTimCheckpoint({
+            task,
+            plan,
+            completedStepCount: 0,
+            stepResults: [],
+            models: opts.models,
+            otomatis: opts.otomatis,
+        });
     }
-    console.log('');
     // ② Execute each step in a fresh focused session
+    const startFromStep = resume?.startFromStep ?? 0;
+    const completedSteps = resume?.stepResults ? [...resume.stepResults] : [];
+    if (startFromStep > 0) {
+        console.log(yellow(`↩ Melanjutkan dari langkah ${startFromStep + 1}/${plan.langkah.length}`));
+    }
     for (const [i, step] of plan.langkah.entries()) {
+        if (i < startFromStep)
+            continue; // skip already-completed steps
         const label = `${i + 1}/${plan.langkah.length}`;
         console.log(bold(`\n② Pengkode — Langkah ${label}`) + dim(`: ${step.tugas}`));
         console.log(dim(`   📄 ${step.file.join(', ')}`));
         const s = newSession(opts.models.pengkode, 'buat', opts.otomatis);
-        s.messages.push({
-            role: 'system',
-            content: [
-                `Peranmu: PENGKODE — langkah ${label} dari rencana keseluruhan.`,
-                `TUGAS: ${step.tugas}`,
-                `File relevan: ${step.file.join(', ')}`,
-                step.catatan ? `Catatan: ${step.catatan}` : '',
-                'Fokus HANYA pada tugas ini. Baca file relevan, buat perubahan, panggil selesai.',
-                'Jangan baca file lain kecuali diperlukan langsung untuk memahami konteks.',
-            ]
-                .filter(Boolean)
-                .join('\n'),
-        });
+        s.maxSteps = 30; // executor steps are focused (1-3 files) — keep tight
+        appendBrief(s, [
+            `Peranmu: PENGKODE — langkah ${label} dari ${plan.langkah.length}.`,
+            `TUJUAN KESELURUHAN: ${task.slice(0, 400)}`,
+            `RINGKASAN RENCANA: ${plan.ringkasan}`,
+            '',
+            `TUGAS LANGKAH INI: ${step.tugas}`,
+            `File relevan: ${step.file.join(', ')}`,
+            step.catatan ? `Catatan: ${step.catatan}` : '',
+            '',
+            'Fokus HANYA pada tugas ini. Baca file relevan, buat perubahan, panggil selesai.',
+            'Jangan baca file lain kecuali diperlukan langsung untuk memahami konteks.',
+        ]
+            .filter(Boolean)
+            .join('\n'));
+        const previousContext = completedSteps.length > 0
+            ? `\n\n[Progress sebelumnya (${completedSteps.length} langkah selesai):\n${completedSteps.slice(-5).join('\n')}]`
+            : '';
         const stepPrompt = [
             step.tugas,
             `\nFile: ${step.file.join(', ')}`,
             step.catatan ? `\nCatatan: ${step.catatan}` : '',
+            previousContext,
         ]
             .filter(Boolean)
             .join('');
-        await runTurn(s, stepPrompt);
+        const stepStart = Date.now();
+        const stepResult = await runTurn(s, stepPrompt);
+        const elapsed = Math.round((Date.now() - stepStart) / 1000);
+        const didComplete = s._lastCompleted === true;
+        const outcome = stepResult?.trim().slice(0, 500) || '(tidak ada output eksplisit)';
+        completedSteps.push(`Langkah ${i + 1} "${step.tugas}" [${didComplete ? '✓' : '⚠'}]: ${outcome}`);
+        const statusLine = didComplete
+            ? green(`✓ Langkah ${label} selesai`)
+            : yellow(`⚠ Langkah ${label} mungkin tidak tuntas`);
+        console.log(`${statusLine} ${dim(`(${elapsed}s)`)}`);
+        // Persist progress after every step — a crash here loses at most one step
+        saveTimCheckpoint({
+            task,
+            plan,
+            completedStepCount: i + 1,
+            stepResults: completedSteps,
+            models: opts.models,
+            otomatis: opts.otomatis,
+        });
     }
-    // ③ Reviewer — pass the plan so it knows which files were touched
+    // ③ Reviewer — receives the plan + step outcomes so it knows what actually happened
     console.log(`\n${bold('③ Peninjau')} ${dim(`(${opts.models.peninjau})`)}`);
-    const stepSummary = plan.langkah
-        .map((s, i) => `  ${i + 1}. ${s.tugas} [${s.file.join(', ')}]`)
-        .join('\n');
     const rev = newSession(opts.models.peninjau, 'rencana', opts.otomatis);
-    rev.messages.push({ role: 'system', content: REVIEWER_BRIEF });
-    await runTurn(rev, `Tinjau hasil implementasi untuk tugas: ${task}\n\nLangkah yang sudah dikerjakan:\n${stepSummary}`);
+    appendBrief(rev, REVIEWER_BRIEF);
+    await runTurn(rev, `Tinjau hasil implementasi untuk tugas: ${task}\n\nHasil per langkah:\n${completedSteps.join('\n')}`);
+    clearTimCheckpoint();
     console.log(green('\n✓ Tim selesai.'));
 }
 // ---------------------------------------------------------------------------
@@ -144,7 +224,7 @@ export async function runCustomTeam(task, opts) {
         console.log(`\n${bold(`${String(i + 1).padStart(2)}. ${roleName}`)} ${dim(`(${model}, mode: ${mode})`)}`);
         const s = newSession(model, mode, otomatis);
         if (roleCfg.brief)
-            s.messages.push({ role: 'system', content: roleCfg.brief });
+            appendBrief(s, roleCfg.brief);
         const result = await runTurn(s, context);
         const trimmed = (result ?? '').trim();
         const capped = trimmed.length > MAX_ROLE_OUTPUT

package/dist/commands.js

@@ -1,13 +1,15 @@
 import { spawnSync } from 'node:child_process';
-import { readFileSync, writeFileSync } from 'node:fs';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { extname } from 'node:path';
 import { createInterface } from 'node:readline/promises';
 import { parseArgs } from 'node:util';
+import { McpManager } from './agent/mcp.js';
 import { loadCheckpoint, runAgent } from './agent/run.js';
+import { listSkills, loadSkill } from './agent/skills.js';
 import { runCustomTeam, runTeam } from './agent/team.js';
 import { expandAtMentions } from './agent/tools.js';
 import { createTopup, fetchBytesAuthed, fetchLatestVersion, fetchModels, fetchPemakaian, fetchSaldo, generateImage, modelSupportsTools, pollJob, resolveMediaModel, resolveModel, streamChat, streamVision, submitVideo, } from './api.js';
-import { clearKey, fileConfig, initProjectConfig, listTeamConfigs, loadConfig, loadProjectConfig, loadTeamConfig, saveConfig, saveTeamConfig, } from './config.js';
+import { SKILLS_GLOBAL_DIR, clearKey, fileConfig, initProjectConfig, listTeamConfigs, loadConfig, loadMcpServers, loadProjectConfig, loadRawMcpConfig, loadTeamConfig, projectSkillsDir, saveConfig, saveMcpConfig, saveTeamConfig, } from './config.js';
 import { VERSION } from './help.js';
 import { bold, cyan, dim, green, idn, prompt, promptHidden, readStdin, red, rupiah, sleep, thinking, yellow, } from './ui.js';
 const IMAGE_MIME = {
@@ -483,6 +485,219 @@ async function timBuatWizard(nama) {
     console.log(dim(`  Edit  : ~/.kiosapi/tim/${nama}.json`));
     console.log(dim(`  Jalankan: kiosapi tim --pakai ${nama} "tugas"`));
 }
+// ---------------------------------------------------------------------------
+// mcp — manage MCP server connections
+// ---------------------------------------------------------------------------
+const MCP_TEMPLATE = {
+    mcpServers: {
+        filesystem: {
+            command: 'npx',
+            args: ['-y', '@modelcontextprotocol/server-filesystem', '.'],
+        },
+        github: {
+            command: 'npx',
+            args: ['-y', '@modelcontextprotocol/server-github'],
+            env: { GITHUB_TOKEN: 'ghp_YOUR_TOKEN_HERE' },
+        },
+    },
+};
+/**
+ * mcp — list, test, or scaffold MCP server configuration.
+ *   kiosapi mcp              List configured servers
+ *   kiosapi mcp sambung      Connect to all servers and show available tools
+ *   kiosapi mcp init         Scaffold ~/.kiosapi/mcp.json with examples
+ */
+export async function cmdMcp(args) {
+    const sub = (args[0] ?? '').toLowerCase();
+    // kiosapi mcp init — scaffold config file
+    if (sub === 'init') {
+        const { DIR } = await import('./config.js');
+        const path = `${DIR}/mcp.json`;
+        const { existsSync } = await import('node:fs');
+        if (existsSync(path)) {
+            console.log(yellow('~/.kiosapi/mcp.json sudah ada. Edit langsung:'));
+            console.log(path);
+            console.log(JSON.stringify(loadRawMcpConfig(), null, 2));
+            return;
+        }
+        saveMcpConfig(MCP_TEMPLATE.mcpServers);
+        console.log(green('✓ ~/.kiosapi/mcp.json dibuat'));
+        console.log(dim('  Edit untuk sesuaikan server dan path, lalu jalankan: kiosapi mcp sambung'));
+        console.log(JSON.stringify(MCP_TEMPLATE, null, 2));
+        return;
+    }
+    const servers = loadMcpServers();
+    const serverCount = Object.keys(servers).length;
+    // kiosapi mcp — list configured servers (no connection)
+    if (!sub || sub === 'daftar' || sub === 'list') {
+        if (serverCount === 0) {
+            console.log(dim('Belum ada MCP server dikonfigurasi.'));
+            console.log(dim('  Scaffold: kiosapi mcp init'));
+            console.log(dim('  Config  : ~/.kiosapi/mcp.json  atau  kiosapi.json → mcpServers'));
+            return;
+        }
+        console.log(bold(`MCP Servers (${serverCount}):`));
+        for (const [name, cfg] of Object.entries(servers)) {
+            const cmd = [cfg.command, ...(cfg.args ?? [])].join(' ');
+            console.log(`  ${cyan(name)}  ${dim(cmd)}`);
+        }
+        console.log(dim('\nTest koneksi: kiosapi mcp sambung'));
+        return;
+    }
+    // kiosapi mcp sambung — connect and list tools
+    if (sub === 'sambung' || sub === 'connect' || sub === 'test') {
+        if (serverCount === 0) {
+            console.log(dim('Belum ada MCP server dikonfigurasi. Jalankan: kiosapi mcp init'));
+            return;
+        }
+        console.log(dim(`Menghubungkan ke ${serverCount} server MCP…`));
+        const mgr = new McpManager();
+        try {
+            await mgr.connect(servers, (warn) => console.log(yellow(warn)));
+            if (mgr.toolCount === 0) {
+                console.log(yellow('Tidak ada tools yang tersedia dari server yang terhubung.'));
+                return;
+            }
+            console.log(green(`\n✓ ${mgr.serverCount} server · ${mgr.toolCount} tools\n`));
+            for (const { server, tools } of mgr.summary()) {
+                console.log(bold(`  ${server}`));
+                for (const t of tools) {
+                    const desc = (t.spec.function.description ?? '').replace(`[MCP:${server}] `, '');
+                    console.log(`    ${cyan(t.toolName)}  ${dim(desc.slice(0, 70))}`);
+                }
+            }
+            console.log(dim('\nTools ini tersedia otomatis di semua sesi agen.'));
+        }
+        finally {
+            mgr.disconnect();
+        }
+        return;
+    }
+    console.log(red(`Sub-perintah tidak dikenal: mcp ${sub}`));
+    console.log(dim('  kiosapi mcp          — lihat server dikonfigurasi'));
+    console.log(dim('  kiosapi mcp sambung  — test koneksi + lihat tools'));
+    console.log(dim('  kiosapi mcp init     — scaffold ~/.kiosapi/mcp.json'));
+}
+// ---------------------------------------------------------------------------
+// skill — reusable saved agent workflows
+// ---------------------------------------------------------------------------
+const SKILL_TEMPLATE = `---
+mode: buat
+# otomatis: false
+# model: deepseek/deepseek-v4-flash
+description: Deskripsi singkat skill ini
+---
+Tulis prompt skillmu di sini.
+
+Tips — gunakan @-mention untuk menyertakan konteks:
+  @git:diff           git diff saat ini
+  @git:status         status working tree
+  @src/**/*.ts        semua file .ts di src/
+  @path/to/file.ts    file spesifik
+
+Contoh:
+  Review @git:diff, identifikasi masalah potensial, dan buat laporan ringkas.
+`;
+/** Try to open a file in the user's preferred editor; falls back to printing the path. */
+function openInEditor(filePath) {
+    const editor = process.env.EDITOR || process.env.VISUAL;
+    if (!editor) {
+        console.log(dim(`  Buka di editor: ${filePath}`));
+        return;
+    }
+    const res = spawnSync(editor, [filePath], { stdio: 'inherit' });
+    if (res.error)
+        console.log(dim(`  Edit manual: ${filePath}`));
+}
+/**
+ * skill — create, list, or run saved skill files.
+ *   kiosapi skill buat [nama]       Buat skill baru (project scope)
+ *   kiosapi skill buat --global [nama]  Buat skill di ~/.kiosapi/skills/
+ *   kiosapi skill <nama> [konteks]  Jalankan skill
+ *   kiosapi skills                  Sama dengan kiosapi skill --daftar
+ */
+export async function cmdSkill(args) {
+    const sub = args[0]?.toLowerCase();
+    // kiosapi skill buat [--global] [nama]
+    if (sub === 'buat' || sub === 'create' || sub === 'new') {
+        const rest = args.slice(1);
+        const isGlobal = rest[0] === '--global' || rest[0] === '-g';
+        const nameArg = isGlobal ? rest[1] : rest[0];
+        const name = nameArg?.trim() || (await prompt('Nama skill (huruf kecil, tanda hubung): ')).trim();
+        if (!name)
+            throw new Error('Nama skill tidak boleh kosong.');
+        if (!/^[\w-]+$/.test(name))
+            throw new Error('Nama hanya boleh huruf, angka, dan tanda hubung.');
+        const dir = isGlobal ? SKILLS_GLOBAL_DIR : projectSkillsDir();
+        mkdirSync(dir, { recursive: true });
+        const filePath = `${dir}/${name}.md`;
+        writeFileSync(filePath, SKILL_TEMPLATE);
+        const scope = isGlobal ? 'global (~/.kiosapi/skills/)' : 'project (.kiosapi/skills/)';
+        console.log(green(`\n✓ Skill "${name}" dibuat (${scope})`));
+        console.log(dim(`  File: ${filePath}`));
+        console.log(dim(`  Jalankan: kiosapi skill ${name}`));
+        console.log(dim('  Edit prompt & frontmatter lalu simpan.\n'));
+        openInEditor(filePath);
+        return;
+    }
+    // kiosapi skill --daftar | kiosapi skills
+    if (!sub || sub === '--daftar' || sub === '--list' || sub === 'daftar' || sub === 'list') {
+        return cmdSkills();
+    }
+    // kiosapi skill <nama> [-m model] [--otomatis] [extra context…]
+    const skillName = sub;
+    const { values: flagValues, positionals: extraPositionals } = parseArgs({
+        args: args.slice(1),
+        options: { model: { type: 'string', short: 'm' }, otomatis: { type: 'boolean' } },
+        allowPositionals: true,
+        strict: false,
+    });
+    const extraArgs = extraPositionals.join(' ').trim();
+    const skill = loadSkill(skillName);
+    if (!skill) {
+        console.error(red(`Skill "${skillName}" tidak ditemukan.`));
+        console.log(dim('  Buat baru: kiosapi skill buat <nama>'));
+        console.log(dim('  Lihat daftar: kiosapi skills'));
+        process.exitCode = 1;
+        return;
+    }
+    const cfg = loadConfig();
+    const model = flagValues.model ?? skill.model ?? cfg.defaultModel;
+    const resolvedModel = await resolveModel(model);
+    const otomatis = flagValues.otomatis ?? skill.otomatis;
+    const scopeLabel = skill.source === 'project' ? dim(' [project]') : dim(' [global]');
+    console.log(`${bold(`▶ ${skill.name}`)}${scopeLabel}${skill.description ? ` — ${dim(skill.description)}` : ''}`);
+    const prompt_ = extraArgs ? `${skill.prompt}\n\n${extraArgs}` : skill.prompt;
+    const expanded = await expandAtMentions(prompt_);
+    await runAgent(expanded, skill.mode, { model: resolvedModel, otomatis });
+}
+/** skills — list all available skills. */
+export async function cmdSkills() {
+    const all = listSkills();
+    if (all.length === 0) {
+        console.log(dim('Belum ada skill.'));
+        console.log(dim('  Buat baru: kiosapi skill buat <nama>'));
+        return;
+    }
+    const projectSkills = all.filter((s) => s.source === 'project');
+    const globalSkills = all.filter((s) => s.source === 'global');
+    if (projectSkills.length > 0) {
+        console.log(bold('\nSkill project (.kiosapi/skills/):'));
+        for (const sk of projectSkills) {
+            const desc = sk.description ? dim(` — ${sk.description}`) : '';
+            console.log(`  ${cyan(sk.name)}${desc}  ${dim(`[${sk.mode}]`)}`);
+        }
+    }
+    if (globalSkills.length > 0) {
+        console.log(bold('\nSkill global (~/.kiosapi/skills/):'));
+        for (const sk of globalSkills) {
+            const desc = sk.description ? dim(` — ${sk.description}`) : '';
+            console.log(`  ${cyan(sk.name)}${desc}  ${dim(`[${sk.mode}]`)}`);
+        }
+    }
+    console.log(dim('\nJalankan: kiosapi skill <nama>'));
+    console.log(dim('Buat baru: kiosapi skill buat <nama>'));
+}
 const ALL_COMMANDS = [
     'masuk',
     'keluar',
@@ -505,6 +720,9 @@ const ALL_COMMANDS = [
     'lihat',
     'lanjut',
     'init',
+    'skill',
+    'skills',
+    'mcp',
     'completion',
     // English aliases
     'login',
@@ -637,6 +855,8 @@ export async function cmdTim(args) {
     const task = positionals.join(' ').trim();
     if (!task)
         throw new Error('Beri tugas. Contoh: kiosapi tim "bikin endpoint /health + tes"');
+    // Expand @file mentions so users can pass: kiosapi tim "@blueprint.md"
+    const expandedTask = await expandAtMentions(task);
     const base = await resolveModel(values.model);
     const models = {
         perencana: values.perencana ?? base,
@@ -645,7 +865,7 @@ export async function cmdTim(args) {
     };
     for (const m of new Set(Object.values(models)))
         await warnIfNoTools(m);
-    await runTeam(task, { models, otomatis: Boolean(values.otomatis) });
+    await runTeam(expandedTask, { models, otomatis: Boolean(values.otomatis) });
 }
 /** saldo — show own balance, bonus tokens, and month-to-date spend. */
 export async function cmdSaldo() {

package/dist/config.js

@@ -1,4 +1,4 @@
-import { chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, } from 'node:fs';
+import { chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync, } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 const DEFAULT_BASE_URL = 'https://api.kiosapi.id';
@@ -6,6 +6,13 @@ export const DIR = join(homedir(), '.kiosapi');
 export const CONFIG_PATH = join(DIR, 'config.json');
 export const CHECKPOINT_PATH = join(DIR, 'checkpoint.json');
 export const TIM_DIR = join(DIR, 'tim');
+export const TIM_CHECKPOINT_PATH = join(DIR, 'tim-checkpoint.json');
+export const SKILLS_GLOBAL_DIR = join(DIR, 'skills');
+const MCP_CONFIG_PATH = join(DIR, 'mcp.json');
+/** Returns the project-level skills directory (.kiosapi/skills/ under cwd). */
+export function projectSkillsDir() {
+    return join(process.cwd(), '.kiosapi', 'skills');
+}
 /** Read only the on-disk config (ignores env overrides) — used before writing. */
 function readFile() {
     if (!existsSync(CONFIG_PATH))
@@ -96,6 +103,71 @@ export function initProjectConfig(config) {
     writeFileSync(p, `${JSON.stringify(config, null, 2)}\n`);
     return p;
 }
+export function saveTimCheckpoint(data) {
+    mkdirSync(DIR, { recursive: true });
+    const full = {
+        type: 'tim',
+        ...data,
+        savedAt: new Date().toISOString(),
+        cwd: process.cwd(),
+    };
+    writeFileSync(TIM_CHECKPOINT_PATH, `${JSON.stringify(full, null, 2)}\n`);
+}
+export function loadTimCheckpoint() {
+    if (!existsSync(TIM_CHECKPOINT_PATH))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(TIM_CHECKPOINT_PATH, 'utf8'));
+        if (data.type !== 'tim')
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+export function clearTimCheckpoint() {
+    try {
+        unlinkSync(TIM_CHECKPOINT_PATH);
+    }
+    catch {
+        // already gone
+    }
+}
+/**
+ * Load all MCP server configs: global (~/.kiosapi/mcp.json) merged with project (kiosapi.json).
+ * Project entries override global ones on name collision.
+ */
+export function loadMcpServers() {
+    let global = {};
+    if (existsSync(MCP_CONFIG_PATH)) {
+        try {
+            const data = JSON.parse(readFileSync(MCP_CONFIG_PATH, 'utf8'));
+            global = data.mcpServers ?? {};
+        }
+        catch {
+            /* corrupt file — ignore */
+        }
+    }
+    const project = loadProjectConfig()?.mcpServers ?? {};
+    return { ...global, ...project };
+}
+/** Write the global MCP config file. */
+export function saveMcpConfig(servers) {
+    mkdirSync(DIR, { recursive: true });
+    writeFileSync(MCP_CONFIG_PATH, `${JSON.stringify({ mcpServers: servers }, null, 2)}\n`);
+}
+/** Read the raw global MCP config (for display / editing). */
+export function loadRawMcpConfig() {
+    if (!existsSync(MCP_CONFIG_PATH))
+        return { mcpServers: {} };
+    try {
+        return JSON.parse(readFileSync(MCP_CONFIG_PATH, 'utf8'));
+    }
+    catch {
+        return { mcpServers: {} };
+    }
+}
 /** List all saved team names. */
 export function listTeamConfigs() {
     if (!existsSync(TIM_DIR))

package/dist/help.js

@@ -47,6 +47,20 @@ ${bold('Agen (butuh model 🔧):')}
   init                    Buat kiosapi.json (config per-project: model, mode, otomatis)
   ${dim('Opsi: -m <model>, --otomatis (lewati konfirmasi). Mendukung pipe stdin.')}
 
+${bold('Skills (workflow tersimpan):')}
+  skill buat <nama>       Buat skill baru di project (.kiosapi/skills/)
+  skill buat --global <n> Buat skill global (~/.kiosapi/skills/)
+  skill <nama> [konteks]  Jalankan skill; konteks opsional ditambahkan ke prompt
+  skills                  Lihat semua skill tersimpan (project + global)
+  ${dim('Dalam sesi: /skills · /skill <nama> [konteks]')}
+
+${bold('MCP (Model Context Protocol):')}
+  mcp                     Lihat server MCP dikonfigurasi
+  mcp sambung             Test koneksi + lihat tools tersedia
+  mcp init                Buat ~/.kiosapi/mcp.json dengan contoh konfigurasi
+  ${dim('Config: ~/.kiosapi/mcp.json (global) atau kiosapi.json → mcpServers (per-project)')}
+  ${dim('Tools MCP otomatis tersedia di semua sesi agen dan tim mode.')}
+
 ${bold('Tim multi-agen:')}
   tim "…"                 Jalankan tim bawaan (perencana → pengkode → peninjau)
   tim --pakai <nama> "…"  Jalankan tim kustom tersimpan
@@ -72,6 +86,11 @@ ${bold('Contoh:')}
   kiosapi lanjut
   kiosapi tim --buat fullstack-team
   kiosapi tim --pakai fullstack-team "bikin halaman login"
+  kiosapi skill buat fix-tests
+  kiosapi skill fix-tests
+  kiosapi skills
+  kiosapi mcp init
+  kiosapi mcp sambung
   kiosapi completion bash >> ~/.bashrc
 
 ${dim('Sesi interaktif: /undo batalkan giliran terakhir · /ringkas padatkan riwayat · /model ganti model.')}

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { cmdBuat, cmdCompletion, cmdEdit, cmdGambar, cmdInit, cmdIsi, cmdKeluar, cmdLihat, cmdMasuk, cmdModel, cmdNgobrol, cmdPakai, cmdPerbarui, cmdPeriksa, cmdRencana, cmdSaldo, cmdSambung, cmdSetel, cmdTanya, cmdTim, cmdVideo, maybeNotifyUpdate, } from './commands.js';
+import { cmdBuat, cmdCompletion, cmdEdit, cmdGambar, cmdInit, cmdIsi, cmdKeluar, cmdLihat, cmdMasuk, cmdMcp, cmdModel, cmdNgobrol, cmdPakai, cmdPerbarui, cmdPeriksa, cmdRencana, cmdSaldo, cmdSambung, cmdSetel, cmdSkill, cmdSkills, cmdTanya, cmdTim, cmdVideo, maybeNotifyUpdate, } from './commands.js';
 import { printHelp, printVersion } from './help.js';
 import { resumeFromCheckpoint, startSession } from './session.js';
 import { red } from './ui.js';
@@ -44,6 +44,9 @@ const COMMANDS = {
     lanjut: resumeFromCheckpoint,
     resume: resumeFromCheckpoint,
     init: cmdInit,
+    skill: cmdSkill,
+    skills: cmdSkills,
+    mcp: cmdMcp,
     completion: cmdCompletion,
 };
 async function main() {