@onesclawkolor/onesclaw 0.1.0

package/dist/agent/session.js

@@ -0,0 +1,225 @@
+import { logger } from '../cli/logger.js';
+const MAX_RECENT_DECISIONS = 20;
+function parseRecentDecisions(raw) {
+    if (!raw) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            return [];
+        }
+        return parsed
+            .filter((item) => typeof item === 'string' && item.trim().length > 0)
+            .slice(-MAX_RECENT_DECISIONS);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 会话级别状态管理。
+ *
+ * 在同一会话内记忆上下文信息（SSH 连接、Skill 执行状态等），
+ * 并将关键状态持久化到 SQLite，跨重启可恢复。
+ */
+export class SessionState {
+    /** 用户身份（不可变，来自 MCP who_am_i） */
+    user;
+    /** 预配置的 SSH 服务器列表 */
+    servers;
+    /** 持久化存储 */
+    memoryStore;
+    scopeKey;
+    /** 匹配到服务器名称时注入的 prompt 段落 */
+    sshServersHint = null;
+    /** 最近使用的 SSH host */
+    currentHost = null;
+    /** 当前活跃的 SSH 连接 */
+    activeConnections = new Set();
+    /** 当前正在执行的 Skill name */
+    activeSkill = null;
+    /** 当前 Skill 执行阶段 */
+    skillPhase = null;
+    /** 最近确认/偏好 */
+    recentDecisions = [];
+    /** 对话轮数 */
+    conversationTurns = 0;
+    /** 最后活动时间 */
+    lastActivity = new Date();
+    constructor(user, servers = [], options = {}) {
+        this.user = user;
+        this.servers = servers;
+        this.memoryStore = options.memoryStore || null;
+        this.scopeKey = options.scopeKey || null;
+    }
+    static async create(options) {
+        const session = new SessionState(options.user || null, options.servers || [], {
+            memoryStore: options.memoryStore || null,
+            scopeKey: options.scopeKey || null,
+        });
+        await session.hydrateFromMemory();
+        return session;
+    }
+    async hydrateFromMemory() {
+        if (!this.memoryStore || !this.scopeKey) {
+            return;
+        }
+        try {
+            const memory = await this.memoryStore.get(this.scopeKey);
+            if (!memory) {
+                return;
+            }
+            this.currentHost = memory.last_host;
+            this.activeSkill = memory.active_skill;
+            this.skillPhase = memory.skill_phase;
+            this.recentDecisions = parseRecentDecisions(memory.recent_decisions_json);
+            if (this.currentHost) {
+                this.activeConnections.add(this.currentHost);
+            }
+        }
+        catch (error) {
+            logger.error('memory', `加载记忆失败: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    persistToMemory() {
+        if (!this.memoryStore || !this.scopeKey) {
+            return;
+        }
+        const payload = {
+            lastHost: this.currentHost,
+            activeSkill: this.activeSkill,
+            skillPhase: this.skillPhase,
+            recentDecisionsJson: JSON.stringify(this.recentDecisions.slice(-MAX_RECENT_DECISIONS)),
+        };
+        void this.memoryStore.upsert(this.scopeKey, payload).catch((error) => {
+            logger.error('memory', `写入记忆失败: ${error instanceof Error ? error.message : String(error)}`);
+        });
+    }
+    /**
+     * 每轮用户输入时调用
+     */
+    incrementTurn() {
+        this.conversationTurns++;
+        this.lastActivity = new Date();
+    }
+    /** SSH 相关关键词，匹配到任一即注入服务器列表 */
+    static SSH_KEYWORDS = ['连接', '服务器', 'ssh', '远程', '登录'];
+    /**
+     * 检查用户输入是否涉及 SSH 操作
+     * 匹配服务器名称或 SSH 关键词时，注入服务器列表到 system prompt
+     */
+    checkUserInput(input) {
+        if (this.servers.length === 0)
+            return;
+        const lowerInput = input.toLowerCase();
+        const matchedByName = this.servers.some((s) => lowerInput.includes(s.name.toLowerCase()));
+        const matchedByKeyword = SessionState.SSH_KEYWORDS.some((kw) => lowerInput.includes(kw));
+        if (matchedByName || matchedByKeyword) {
+            const rows = this.servers.map((s) => `| ${s.name} | ${s.host} | ${s.description || '-'} |`);
+            this.sshServersHint = [
+                '## 可用 SSH 服务器',
+                '',
+                '当用户提到连接服务器或在服务器上执行命令时，使用 ssh_execute 工具，将 host 参数设置为下表中的服务器名称（必须精确匹配）。',
+                '',
+                '| 名称 | 地址 | 说明 |',
+                '|------|------|------|',
+                ...rows,
+            ].join('\n');
+        }
+    }
+    pushDecision(text) {
+        if (!text || !text.trim()) {
+            return;
+        }
+        const normalized = text.trim().slice(0, 200);
+        this.recentDecisions.push(normalized);
+        this.recentDecisions = this.recentDecisions.slice(-MAX_RECENT_DECISIONS);
+    }
+    /**
+     * 观察工具执行结果，自动更新会话状态。
+     */
+    observe(toolName, args, result) {
+        this.lastActivity = new Date();
+        // SSH host 记忆：成功执行 ssh_execute 后记录 host
+        if (toolName === 'ssh_execute' && !result.isError) {
+            const host = args.host;
+            if (host) {
+                this.currentHost = host;
+                this.activeConnections.add(host);
+            }
+        }
+        // Skill 加载追踪：load_skill 成功后记录 skill 名称
+        if (toolName === 'load_skill' && !result.isError) {
+            const skillName = args.name;
+            if (skillName) {
+                this.activeSkill = skillName;
+                this.skillPhase = 'loaded';
+            }
+        }
+        // ask_user 的结果记为用户决策摘要
+        if (toolName === 'ask_user' && !result.isError) {
+            const answer = typeof result.content === 'string' ? result.content.trim() : '';
+            if (answer) {
+                this.pushDecision(`用户确认: ${answer}`);
+            }
+        }
+        // 高危命令确认痕迹
+        if ((toolName === 'execute_command' || toolName === 'ssh_execute') && args.confirmed === true) {
+            const command = typeof args.command === 'string' ? args.command.trim() : '';
+            if (command) {
+                this.pushDecision(`高危命令已确认: ${command.slice(0, 140)}`);
+            }
+        }
+        this.persistToMemory();
+    }
+    /**
+     * /clear 时清理会话上下文，并删除当前 scope 的持久化记忆。
+     */
+    clearConversation() {
+        this.currentHost = null;
+        this.activeConnections.clear();
+        this.activeSkill = null;
+        this.skillPhase = null;
+        this.recentDecisions = [];
+        this.conversationTurns = 0;
+        if (this.memoryStore && this.scopeKey) {
+            void this.memoryStore.clear(this.scopeKey).catch((error) => {
+                logger.error('memory', `清理记忆失败: ${error instanceof Error ? error.message : String(error)}`);
+            });
+        }
+    }
+    /**
+     * 生成 system prompt 注入段落。
+     */
+    toPromptSection() {
+        const lines = [];
+        if (this.currentHost) {
+            lines.push(`当前 SSH 主机：${this.currentHost}`);
+            if (this.activeConnections.size > 1) {
+                const hosts = Array.from(this.activeConnections).join(', ');
+                lines.push(`活跃连接：${hosts}`);
+            }
+            lines.push('用户后续的 SSH 命令如果没有指定 host，应默认使用当前主机。');
+        }
+        if (this.activeSkill) {
+            lines.push(`当前正在执行 Skill：${this.activeSkill}`);
+            if (this.skillPhase) {
+                lines.push(`执行阶段：${this.skillPhase}`);
+            }
+        }
+        if (this.recentDecisions.length > 0) {
+            lines.push('最近确认/偏好：');
+            for (const decision of this.recentDecisions.slice(-5)) {
+                lines.push(`- ${decision}`);
+            }
+        }
+        if (this.sshServersHint) {
+            lines.push(this.sshServersHint);
+        }
+        if (lines.length === 0)
+            return '';
+        return '## 当前会话上下文\n\n' + lines.join('\n');
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/agent/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/agent/session.ts"],"names":[],"mappings":"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"}

package/dist/audit/file-sink.d.ts

@@ -0,0 +1,6 @@
+import type { AuditEntry, AuditSink } from './types.js';
+export declare class FileAuditSink implements AuditSink {
+    private logDir;
+    constructor(logDir: string);
+    write(entry: AuditEntry): void;
+}

package/dist/audit/file-sink.js

@@ -0,0 +1,21 @@
+// @ts-nocheck
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+export class FileAuditSink {
+    logDir;
+    constructor(logDir) {
+        this.logDir = logDir;
+    }
+    write(entry) {
+        try {
+            mkdirSync(this.logDir, { recursive: true });
+            const date = entry.time.slice(0, 10);
+            const logPath = join(this.logDir, `${date}.log`);
+            appendFileSync(logPath, JSON.stringify(entry) + '\n', 'utf-8');
+        }
+        catch {
+            // 审计写入失败不阻塞主流程
+        }
+    }
+}
+//# sourceMappingURL=file-sink.js.map

package/dist/audit/file-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sink.js","sourceRoot":"","sources":["../../src/audit/file-sink.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,OAAO,aAAa;IAChB,MAAM,CAAS;IAEvB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAiB;QACrB,IAAI,CAAC;YACH,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;YACjD,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QACjE,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;CACF"}

package/dist/audit/ids.d.ts

@@ -0,0 +1,3 @@
+export declare function getSessionId(): string;
+export declare function nextCommandId(prefix?: string): string;
+export declare function nextTraceId(): string;

package/dist/audit/ids.js

@@ -0,0 +1,15 @@
+// @ts-nocheck
+import { randomUUID } from 'node:crypto';
+const SESSION_ID = `sess_${randomUUID()}`;
+let commandSeq = 0;
+export function getSessionId() {
+    return SESSION_ID;
+}
+export function nextCommandId(prefix = 'cmd') {
+    commandSeq += 1;
+    return `${prefix}_${String(commandSeq).padStart(6, '0')}`;
+}
+export function nextTraceId() {
+    return `trace_${randomUUID()}`;
+}
+//# sourceMappingURL=ids.js.map

package/dist/audit/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/audit/ids.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,GAAG,QAAQ,UAAU,EAAE,EAAE,CAAC;AAC1C,IAAI,UAAU,GAAG,CAAC,CAAC;AAEnB,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAM,GAAG,KAAK;IAC1C,UAAU,IAAI,CAAC,CAAC;IAChB,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,SAAS,UAAU,EAAE,EAAE,CAAC;AACjC,CAAC"}

package/dist/audit/types.d.ts

@@ -0,0 +1,13 @@
+export interface AuditEntry {
+    time: string;
+    level: 'debug' | 'info' | 'error';
+    category: string;
+    message: string;
+    session_id?: string;
+    trace_id?: string;
+    command_id?: string;
+    data?: unknown;
+}
+export interface AuditSink {
+    write(entry: AuditEntry): void;
+}

package/dist/audit/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/audit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":""}

package/dist/cli/commands.d.ts

@@ -0,0 +1,31 @@
+export declare const COMMAND_TREE: ({
+    name: string;
+    description: string;
+    subCommands: {
+        name: string;
+        description: string;
+    }[];
+} | {
+    name: string;
+    description: string;
+    subCommands?: undefined;
+})[];
+/**
+ * 根据当前输入计算候选列表
+ * @param input 当前输入（含 /），保留尾部空格用于触发子命令候选
+ */
+export declare function getCommandCandidates(input: any): {
+    text: string;
+    description: string;
+}[];
+/**
+ * 判断输入是否为斜杠命令
+ * 仅当 "/" 后的第一个词匹配已知命令名时才返回 true，
+ * 避免将文件路径（如 /tmp/...）误判为斜杠命令。
+ */
+export declare function isSlashCommand(input: any): boolean;
+/**
+ * 处理斜杠命令
+ * @returns false 表示应退出 REPL 循环
+ */
+export declare function handleSlashCommand(input: any, context: any): Promise<boolean>;