pikiclaw 0.2.35

package/dist/bot-commands.js

@@ -0,0 +1,236 @@
+/**
+ * bot-commands.ts — channel-agnostic command data layer.
+ *
+ * Each function returns structured data objects that any IM renderer can consume.
+ * No rendering, no HTML, no platform-specific formatting.
+ *
+ * Usage from a channel-specific bot (e.g. bot-telegram.ts, bot-feishu.ts):
+ *   const data = await getSessionsPageData(bot, chatId, 0);
+ *   const rendered = renderSessionsPage(data); // channel-specific renderer
+ */
+import path from 'node:path';
+import { VERSION, fmtTokens, fmtUptime, fmtBytes } from './bot.js';
+import { getProjectSkillPaths } from './code-agent.js';
+import { getDriver } from './agent-driver.js';
+import { buildWelcomeIntro, buildDefaultMenuCommands, buildSkillCommandName, indexSkillsByCommand, SKILL_CMD_PREFIX } from './bot-menu.js';
+import { summarizePromptForStatus } from './bot-streaming.js';
+import { getSessionStatusForChat } from './session-status.js';
+export function getStartData(bot, chatId) {
+    const cs = bot.chat(chatId);
+    const intro = buildWelcomeIntro(VERSION);
+    const res = bot.fetchAgents();
+    const installedCount = res.agents.filter(a => a.installed).length;
+    const skillRes = bot.fetchSkills();
+    const commands = buildDefaultMenuCommands(installedCount, skillRes.skills);
+    return {
+        ...intro,
+        agent: cs.agent,
+        workdir: bot.workdir,
+        commands,
+    };
+}
+export async function getSessionsPageData(bot, chatId, page, pageSize = 5) {
+    const cs = bot.chat(chatId);
+    const res = await bot.fetchSessions(cs.agent);
+    const sessions = res.ok ? res.sessions : [];
+    const total = sessions.length;
+    const totalPages = Math.max(1, Math.ceil(total / pageSize));
+    const pg = Math.max(0, Math.min(page, totalPages - 1));
+    const slice = sessions.slice(pg * pageSize, (pg + 1) * pageSize);
+    const entries = [];
+    for (const s of slice) {
+        const sessionKey = s.sessionId || '';
+        if (!sessionKey)
+            continue;
+        const status = getSessionStatusForChat(bot, cs, s);
+        const title = s.title ? s.title.replace(/\n/g, ' ').slice(0, 10) : sessionKey.slice(0, 10);
+        const time = s.createdAt
+            ? new Date(s.createdAt).toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' })
+            : '?';
+        entries.push({ key: sessionKey, title, time, isCurrent: status.isCurrent, isRunning: status.isRunning });
+    }
+    return { agent: cs.agent, total, page: pg, totalPages, sessions: entries };
+}
+export function extractLastSessionTurn(messages) {
+    if (!messages.length)
+        return null;
+    let lastUserIndex = -1;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        if (messages[i].role === 'user') {
+            lastUserIndex = i;
+            break;
+        }
+    }
+    const userText = String(lastUserIndex >= 0 ? messages[lastUserIndex].text : '').trim() || null;
+    const assistantTexts = [];
+    for (let i = lastUserIndex >= 0 ? lastUserIndex + 1 : 0; i < messages.length; i++) {
+        if (messages[i].role === 'assistant' && messages[i].text)
+            assistantTexts.push(messages[i].text);
+    }
+    const assistantText = assistantTexts.join('\n\n').trim() || null;
+    if (!userText && !assistantText)
+        return null;
+    return { userText, assistantText };
+}
+export async function getSessionTurnPreviewData(bot, agent, sessionId, limit = 50) {
+    if (!sessionId)
+        return null;
+    const tail = await bot.fetchSessionTail(agent, sessionId, limit);
+    if (!tail.ok || !tail.messages.length)
+        return null;
+    return extractLastSessionTurn(tail.messages);
+}
+export function getAgentsListData(bot, chatId) {
+    const cs = bot.chat(chatId);
+    const res = bot.fetchAgents();
+    return {
+        currentAgent: cs.agent,
+        agents: res.agents.map(a => ({
+            agent: a.agent,
+            installed: a.installed,
+            version: a.version ?? null,
+            path: a.path ?? null,
+            isCurrent: a.agent === cs.agent,
+        })),
+    };
+}
+export function getSkillsListData(bot, chatId) {
+    const cs = bot.chat(chatId);
+    const skills = bot.fetchSkills().skills
+        .map(skill => {
+        const command = buildSkillCommandName(skill.name);
+        if (!command)
+            return null;
+        return {
+            name: skill.name,
+            label: skill.label || skill.name.charAt(0).toUpperCase() + skill.name.slice(1),
+            description: skill.description,
+            command,
+            source: skill.source,
+        };
+    })
+        .filter((skill) => !!skill);
+    return { agent: cs.agent, workdir: bot.workdir, skills };
+}
+function claudeModelSelectionKey(modelId) {
+    const value = String(modelId || '').trim().toLowerCase();
+    if (!value)
+        return null;
+    if (value === 'opus' || value === 'opus-1m' || value.startsWith('claude-opus-')) {
+        return value === 'opus-1m' || value.endsWith('[1m]') ? 'opus-1m' : 'opus';
+    }
+    if (value === 'sonnet' || value === 'sonnet-1m' || value.startsWith('claude-sonnet-')) {
+        return value === 'sonnet-1m' || value.endsWith('[1m]') ? 'sonnet-1m' : 'sonnet';
+    }
+    if (value === 'haiku' || value.startsWith('claude-haiku-'))
+        return 'haiku';
+    return null;
+}
+export function modelMatchesSelection(agent, selection, currentModel) {
+    if (selection === currentModel)
+        return true;
+    if (agent !== 'claude')
+        return false;
+    const a = claudeModelSelectionKey(selection);
+    const b = claudeModelSelectionKey(currentModel);
+    return !!a && a === b;
+}
+const EFFORT_LEVELS = {
+    claude: [
+        { id: 'low', label: 'Low' },
+        { id: 'medium', label: 'Medium' },
+        { id: 'high', label: 'High' },
+    ],
+    codex: [
+        { id: 'low', label: 'Low' },
+        { id: 'medium', label: 'Medium' },
+        { id: 'high', label: 'High' },
+        { id: 'xhigh', label: 'Very High' },
+    ],
+};
+function buildEffortData(bot, agent) {
+    const currentEffort = bot.effortForAgent(agent);
+    if (!currentEffort)
+        return null;
+    const levels = EFFORT_LEVELS[agent];
+    if (!levels)
+        return null;
+    return {
+        current: currentEffort,
+        levels: levels.map(l => ({ ...l, isCurrent: l.id === currentEffort })),
+    };
+}
+export async function getModelsListData(bot, chatId) {
+    const cs = bot.chat(chatId);
+    const currentModel = bot.modelForAgent(cs.agent);
+    const res = await bot.fetchModels(cs.agent);
+    return {
+        agent: cs.agent,
+        currentModel,
+        sources: res.sources,
+        note: res.note ?? null,
+        models: res.models.map(m => ({
+            id: m.id,
+            alias: m.alias ?? null,
+            isCurrent: modelMatchesSelection(cs.agent, m.id, currentModel),
+        })),
+        effort: buildEffortData(bot, cs.agent),
+    };
+}
+export async function getStatusDataAsync(bot, chatId) {
+    const d = bot.getStatusData(chatId);
+    const driver = getDriver(d.agent);
+    const usage = driver.getUsageLive
+        ? await driver.getUsageLive({ agent: d.agent, model: d.model }).catch(() => d.usage)
+        : d.usage;
+    return {
+        ...d,
+        running: d.running ? { prompt: d.running.prompt, startedAt: d.running.startedAt } : null,
+        usage,
+    };
+}
+export function getHostDataSync(bot) {
+    return bot.getHostData();
+}
+// ---------------------------------------------------------------------------
+// Skill routing
+// ---------------------------------------------------------------------------
+export { SKILL_CMD_PREFIX, indexSkillsByCommand };
+function relSkillPath(workdir, filePath) {
+    const relative = path.relative(workdir, filePath).replace(/\\/g, '/');
+    return relative && !relative.startsWith('..') ? relative : filePath;
+}
+export function resolveSkillPrompt(bot, chatId, cmd, args) {
+    const skills = bot.fetchSkills().skills;
+    const skill = indexSkillsByCommand(skills).get(cmd);
+    if (!skill)
+        return null;
+    const cs = bot.chat(chatId);
+    const extra = args.trim();
+    const suffix = extra ? ` Additional context: ${extra}` : '';
+    let prompt;
+    if (skill.source === 'commands') {
+        prompt = `In this project's .claude/commands/${skill.name}.md file, there is a custom command definition. Please read and execute the instructions defined there.${suffix}`;
+        return { prompt, skillName: skill.name };
+    }
+    const paths = getProjectSkillPaths(bot.workdir, skill.name);
+    if (cs.agent === 'claude' && paths.claudeSkillFile) {
+        prompt = `Please execute the /${skill.name} skill defined in this project.${suffix}`;
+    }
+    else {
+        const canonicalPath = paths.sharedSkillFile
+            ? `\`${relSkillPath(bot.workdir, paths.sharedSkillFile)}\``
+            : `\`.pikiclaw/skills/${skill.name}/SKILL.md\``;
+        const locationText = paths.sharedSkillFile
+            ? canonicalPath
+            : paths.agentsSkillFile || paths.claudeSkillFile
+                ? canonicalPath
+                : `\`${skill.name}/SKILL.md\``;
+        prompt = `In this project, the ${skill.name} skill is defined in ${locationText}. Please read that SKILL.md file and execute the instructions.${suffix}`;
+    }
+    return { prompt, skillName: skill.name };
+}
+// ---------------------------------------------------------------------------
+// Re-export commonly used helpers for convenience
+// ---------------------------------------------------------------------------
+export { summarizePromptForStatus, fmtTokens, fmtUptime, fmtBytes, VERSION };