fotric-claw 0.1.0

package/backend/src/skills/skills.module.ts

@@ -0,0 +1,8 @@
+import { Module } from '@nestjs/common';
+import { SkillsService } from './skills.service';
+
+@Module({
+  providers: [SkillsService],
+  exports: [SkillsService],
+})
+export class SkillsModule {}

package/backend/src/skills/skills.service.ts

@@ -0,0 +1,139 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { glob } from 'glob';
+import fm from 'front-matter';
+import { Injectable, Logger, OnModuleInit } from '@nestjs/common';
+import { FOTRIC_CONFIG } from '../config';
+import { Skill, SkillMetadata, SkillSnapshot, ParsedSkill } from './skill.types';
+
+@Injectable()
+export class SkillsService implements OnModuleInit {
+  private readonly logger = new Logger('FOTRIC-CLAW:Skills');
+  private skills: Map<string, Skill> = new Map();
+  private skillsDir: string;
+
+  constructor() {
+    this.skillsDir = path.resolve(FOTRIC_CONFIG.PATHS.SKILLS_DIR);
+  }
+
+  async onModuleInit() {
+    await this.loadAllSkills();
+  }
+
+  async loadAllSkills(): Promise<void> {
+    this.skills.clear();
+    
+    try {
+      await fs.mkdir(this.skillsDir, { recursive: true });
+    } catch {
+      this.logger.error(`Failed to create skills directory: ${this.skillsDir}`);
+      return;
+    }
+
+    const skillFiles = await glob('**/SKILL.md', {
+      cwd: this.skillsDir,
+      absolute: true,
+    });
+
+    for (const skillFile of skillFiles) {
+      try {
+        const skill = await this.loadSkill(skillFile);
+        if (skill) {
+          this.skills.set(skill.name, skill);
+          this.logger.log(`Loaded skill: ${skill.name}`);
+        }
+      } catch (error) {
+        this.logger.error(`Failed to load skill from ${skillFile}: ${error}`);
+      }
+    }
+
+    this.logger.log(`Total skills loaded: ${this.skills.size}`);
+  }
+
+  private async loadSkill(skillPath: string): Promise<Skill | null> {
+    const content = await fs.readFile(skillPath, 'utf-8');
+    const parsed = this.parseSkill(content);
+    
+    if (!parsed) {
+      return null;
+    }
+
+    const relativePath = path.relative(
+      path.resolve(FOTRIC_CONFIG.PATHS.ROOT_DIR),
+      skillPath
+    ).replace(/\\/g, '/');
+
+    return {
+      name: parsed.metadata.name,
+      description: parsed.metadata.description,
+      location: `./${relativePath}`,
+      metadata: parsed.metadata,
+      content: parsed.content,
+    };
+  }
+
+  parseSkill(content: string): ParsedSkill | null {
+    try {
+      const { attributes, body } = fm<SkillMetadata>(content);
+      
+      if (!attributes.name || !attributes.description) {
+        return null;
+      }
+
+      return {
+        metadata: {
+          name: attributes.name,
+          description: attributes.description,
+          version: attributes.version,
+          author: attributes.author,
+          tags: attributes.tags,
+        },
+        content: body.trim(),
+        raw: content,
+      };
+    } catch {
+      return null;
+    }
+  }
+
+  getSkill(name: string): Skill | undefined {
+    return this.skills.get(name);
+  }
+
+  getAllSkills(): Skill[] {
+    return Array.from(this.skills.values());
+  }
+
+  getSkillsSnapshot(): SkillSnapshot[] {
+    return this.getAllSkills().map(skill => ({
+      name: skill.name,
+      description: skill.description,
+      location: skill.location,
+    }));
+  }
+
+  generateSkillsSnapshotMarkdown(): string {
+    const snapshots = this.getSkillsSnapshot();
+    
+    if (snapshots.length === 0) {
+      return `<available_skills>
+  <!-- No skills available -->
+</available_skills>`;
+    }
+
+    const skillElements = snapshots.map(skill => `  <skill>
+    <name>${skill.name}</name>
+    <description>${skill.description}</description>
+    <location>${skill.location}</location>
+  </skill>`).join('\n');
+
+    return `<available_skills>
+${skillElements}
+</available_skills>`;
+  }
+
+  async reloadSkills(): Promise<void> {
+    this.logger.log('Reloading all skills...');
+    await this.loadAllSkills();
+  }
+}

package/backend/src/skills/web_search/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: web_search
+description: 在网络上搜索信息并返回结果
+version: 1.0.0
+author: FotricCalw
+tags:
+  - search
+  - web
+---
+
+# 网络搜索技能
+
+此技能用于在网络上搜索信息并返回相关结果。
+
+## 使用方法
+
+1. 使用 `fetch_url` 工具访问搜索引擎
+2. 解析搜索结果页面
+3. 提取并返回相关信息
+
+## 推荐搜索引擎
+
+### DuckDuckGo (推荐)
+
+DuckDuckGo 不需要 API Key，可以直接访问：
+
+```
+https://html.duckduckgo.com/html/?q={search_query}
+```
+
+### 使用方法
+
+使用 `fetch_url` 工具进行搜索：
+
+```json
+{
+  "url": "https://html.duckduckgo.com/html/?q=your+search+query"
+}
+```
+
+## 步骤
+
+### 步骤 1: 构建搜索 URL
+
+将用户的搜索查询转换为 URL 编码格式：
+- 空格替换为 `+`
+- 特殊字符需要 URL 编码
+
+### 步骤 2: 获取搜索结果
+
+使用 `fetch_url` 工具访问搜索 URL。
+
+### 步骤 3: 解析结果
+
+从返回的 HTML 中提取搜索结果标题和摘要。
+
+## 示例
+
+用户问："搜索最新的 AI 新闻"
+
+1. 构建搜索 URL：
+```json
+{
+  "url": "https://html.duckduckgo.com/html/?q=latest+AI+news"
+}
+```
+
+2. 调用 `fetch_url` 获取结果
+
+3. 向用户展示搜索结果
+
+## 注意事项
+
+- 搜索结果可能包含大量文本，注意截断
+- 某些网站可能阻止爬虫访问
+- 尊重网站的 robots.txt 规则

package/backend/src/workspace/AGENTS.md

@@ -0,0 +1,47 @@
+# Agent Behavior Guidelines
+
+## 重要说明：Skills vs Tools
+
+**Skills（技能）和 Tools（工具）是不同的！**
+
+- **Tools（工具）**：你可以直接调用的功能，如 `terminal`、`fetch_url`、`read_file` 等
+- **Skills（技能）**：指导文档，告诉你如何组合使用 Tools 来完成特定任务
+
+**你只能直接调用 Tools，不能调用 Skills！**
+
+## Skill Invocation Protocol (SKILL PROTOCOL)
+
+You have access to a skills list (SKILLS_SNAPSHOT), which contains available capabilities and their definition file locations.
+
+**When you want to use a skill, you MUST follow these steps:**
+
+1. Your FIRST action is ALWAYS to use the `read_file` tool to read the Markdown file at the skill's `location` path.
+2. Carefully read the content, steps, and examples in the file.
+3. Based on the instructions in the file, use your built-in **Core Tools** (terminal, node_repl, fetch_url, read_file) to execute the specific task.
+
+**FORBIDDEN to call skill names directly as tools! Skills are NOT tools!**
+
+**Example - WRONG:**
+```json
+{"name": "browser_search", "args": {"query": "Python"}}
+```
+
+**Example - CORRECT:**
+1. First read the skill file: `read_file` with path `./src/skills/browser_search/SKILL.md`
+2. Then follow the instructions to use `terminal` tool: `terminal` with command `start "" "https://www.bing.com/search?q=Python"`
+
+**重要：执行技能时必须直接调用工具，禁止将命令文本返回给用户！**
+
+## Available Core Tools (可直接调用的工具)
+
+1. **terminal** - Execute shell commands in a sandboxed environment
+2. **node_repl** - Execute JavaScript code in a sandboxed Node.js environment
+3. **fetch_url** - Fetch content from URLs and extract text
+4. **read_file** - Read local file contents
+5. **search_knowledge_base** - Search the local knowledge base
+
+## Memory Operations
+
+- All conversations are stored as session files
+- Long-term memory is stored in MEMORY.md
+- You can read and update memory files as needed

package/backend/src/workspace/IDENTITY.md

@@ -0,0 +1,32 @@
+# Identity
+
+I am FotricCalw, an AI assistant with transparent memory and skill systems.
+
+## Capabilities
+- Execute shell commands safely using the `terminal` tool
+- Run JavaScript code in a sandbox using the `node_repl` tool
+- Fetch and analyze web content using the `fetch_url` tool
+- Read and write files using the `read_file` tool
+- Search the knowledge base using the `search_knowledge_base` tool
+
+## Critical Rules
+
+**YOU MUST USE TOOLS TO EXECUTE COMMANDS!**
+
+When a user asks you to do something that requires executing a command:
+- **DO NOT** just provide the command text for the user to copy
+- **DO NOT** ask the user which OS they are using
+- **ALWAYS** use the `terminal` tool to execute the command directly
+
+**Example - WRONG:**
+User: "Open browser and search for Python"
+Assistant: "You can run this command: `start "" "https://www.bing.com/search?q=Python"`"
+
+**Example - CORRECT:**
+User: "Open browser and search for Python"
+Assistant: [Uses terminal tool with command: `start "" "https://www.bing.com/search?q=Python"`]
+
+## Limitations
+- Cannot access files outside the project directory
+- Cannot execute dangerous system commands
+- Memory is limited to configured limits

package/backend/src/workspace/MEMORY.md

@@ -0,0 +1,15 @@
+# Long-term Memory
+
+This file stores persistent information that should be remembered across sessions.
+
+## Important Information
+
+(Add important information here as you interact with users)
+
+## User Preferences
+
+(Record user preferences and patterns)
+
+## Task History
+
+(Keep track of important tasks and their outcomes)

package/backend/src/workspace/SOUL.md

@@ -0,0 +1,29 @@
+# Core Soul
+
+You are FotricCalw, a lightweight and transparent AI Agent system.
+
+## Core Values
+- Transparency: All operations are visible and explainable
+- File-first Memory: Using human-readable files for all data
+- Skills as Plugins: Extensible through markdown-based skill definitions
+
+## Behavior Guidelines
+- Always be helpful and honest
+- Explain your reasoning when asked
+- **USE TOOLS TO EXECUTE COMMANDS - NEVER just provide command text for users to copy**
+- When a user asks to open a browser, execute a command, or perform an action, use the `terminal` tool directly
+
+## Critical: Tool Usage
+
+**YOU ARE AN AI AGENT WITH TOOLS - USE THEM!**
+
+You have access to tools like `terminal`, `node_repl`, `fetch_url`, `read_file`. When a user asks you to do something:
+
+1. **DO NOT** respond with instructions for the user to follow
+2. **DO NOT** provide command text for the user to copy and paste
+3. **DO** call the appropriate tool to execute the action
+
+**Example:**
+- User: "Open browser and search Python"
+- You: Call `terminal` tool with `start "" "https://www.bing.com/search?q=Python"`
+- Then respond: "I've opened your browser with the search for Python."

package/backend/src/workspace/USER.md

@@ -0,0 +1,8 @@
+# User Profile
+
+## Preferences
+- Language: User's preferred language
+- Response style: Clear and educational
+
+## Notes
+Add user-specific information here.

package/backend/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
+}

package/backend/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2021",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "noImplicitAny": true,
+    "strictBindCallApply": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  }
+}

package/bin/fotric-claw.js

@@ -0,0 +1,281 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const { spawn } = require('child_process');
+
+const ENV_FILE = path.resolve(__dirname, '../backend/.env');
+const PROJECT_ROOT = path.resolve(__dirname, '..');
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+function question(prompt, defaultValue = '') {
+  return new Promise((resolve) => {
+    const displayPrompt = defaultValue 
+      ? `${prompt} (${defaultValue}): `
+      : `${prompt}: `;
+    rl.question(displayPrompt, (answer) => {
+      resolve(answer.trim() || defaultValue);
+    });
+  });
+}
+
+function readEnvFile() {
+  try {
+    return fs.readFileSync(ENV_FILE, 'utf-8');
+  } catch {
+    return '';
+  }
+}
+
+function updateEnvContent(content, updates) {
+  const lines = content.split('\n');
+  const updatedKeys = new Set();
+  
+  const newLines = lines.map(line => {
+    const trimmed = line.trim();
+    if (trimmed.startsWith('#') || trimmed === '') {
+      return line;
+    }
+    
+    const [key] = trimmed.split('=');
+    const envKey = key?.trim();
+    
+    if (envKey && updates[envKey] !== undefined) {
+      updatedKeys.add(envKey);
+      return `${envKey}=${updates[envKey]}`;
+    }
+    
+    return line;
+  });
+  
+  for (const [key, value] of Object.entries(updates)) {
+    if (!updatedKeys.has(key) && value !== undefined) {
+      newLines.push(`${key}=${value}`);
+    }
+  }
+  
+  return newLines.join('\n');
+}
+
+function parseEnvValue(content, key) {
+  const lines = content.split('\n');
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith('#') || trimmed === '') continue;
+    
+    const [k, ...valueParts] = trimmed.split('=');
+    if (k?.trim() === key) {
+      return valueParts.join('=').trim();
+    }
+  }
+  return '';
+}
+
+function maskApiKey(key) {
+  if (!key || key.length < 8) return '';
+  return key.substring(0, 4) + '****' + key.substring(key.length - 4);
+}
+
+async function configCommand() {
+  console.log('\n🔧 FotricCalw Configuration\n');
+  console.log('Current configuration:');
+  
+  const envContent = readEnvFile();
+  const currentApiKey = parseEnvValue(envContent, 'FOTRIC_API_KEY');
+  const currentApiBaseUrl = parseEnvValue(envContent, 'FOTRIC_API_BASE_URL');
+  const currentModelName = parseEnvValue(envContent, 'FOTRIC_MODEL_NAME');
+  
+  console.log(`  API Key: ${maskApiKey(currentApiKey) || '(not set)'}`);
+  console.log(`  API Base URL: ${currentApiBaseUrl || '(not set)'}`);
+  console.log(`  Model Name: ${currentModelName || '(not set)'}`);
+  console.log('');
+  
+  const apiKey = await question('Enter API Key', currentApiKey);
+  const apiBaseUrl = await question('Enter API Base URL', currentApiBaseUrl || 'https://api.openai.com/v1');
+  const modelName = await question('Enter Model Name', currentModelName || 'gpt-4o');
+  
+  const updates = {};
+  if (apiKey) updates.FOTRIC_API_KEY = apiKey;
+  if (apiBaseUrl) updates.FOTRIC_API_BASE_URL = apiBaseUrl;
+  if (modelName) updates.FOTRIC_MODEL_NAME = modelName;
+  
+  const updatedContent = updateEnvContent(envContent, updates);
+  fs.writeFileSync(ENV_FILE, updatedContent, 'utf-8');
+  
+  console.log('\n✅ Configuration saved to backend/.env');
+  console.log('   Please restart the server for changes to take effect.\n');
+  
+  rl.close();
+}
+
+async function showHelp() {
+  console.log(`
+FotricCalw CLI
+
+Usage:
+  fotric-claw <command> [options]
+
+Commands:
+  start       Start backend and frontend services (dev mode)
+  start:prod  Start backend and frontend services (production mode)
+  build       Build backend and frontend for production
+  config      Configure LLM API settings
+  help        Show this help message
+
+Examples:
+  fotric-claw start
+  fotric-claw start:prod
+  fotric-claw build
+  fotric-claw config
+  fotric-claw help
+`);
+  rl.close();
+}
+
+function startCommand() {
+  console.log('\n🚀 Starting FotricCalw (Development Mode)...\n');
+  
+  const isWindows = process.platform === 'win32';
+  const shell = isWindows ? true : false;
+  
+  const backend = spawn('npm', ['run', 'backend'], {
+    cwd: PROJECT_ROOT,
+    shell,
+    stdio: 'inherit'
+  });
+  
+  setTimeout(() => {
+    const frontend = spawn('npm', ['run', 'frontend'], {
+      cwd: PROJECT_ROOT,
+      shell,
+      stdio: 'inherit'
+    });
+    
+    frontend.on('error', (err) => {
+      console.error('Failed to start frontend:', err.message);
+    });
+  }, 3000);
+  
+  backend.on('error', (err) => {
+    console.error('Failed to start backend:', err.message);
+  });
+  
+  console.log('Backend starting on http://localhost:8002');
+  console.log('Frontend starting on http://localhost:3000');
+  console.log('\nPress Ctrl+C to stop the services.\n');
+}
+
+function startProdCommand() {
+  console.log('\n🚀 Starting FotricCalw (Production Mode)...\n');
+  
+  const isWindows = process.platform === 'win32';
+  const shell = isWindows ? true : false;
+  
+  const backend = spawn('node', ['dist/main'], {
+    cwd: path.resolve(PROJECT_ROOT, 'backend'),
+    shell,
+    stdio: 'inherit'
+  });
+  
+  setTimeout(() => {
+    const frontend = spawn('npm', ['run', 'start'], {
+      cwd: path.resolve(PROJECT_ROOT, 'frontend'),
+      shell,
+      stdio: 'inherit'
+    });
+    
+    frontend.on('error', (err) => {
+      console.error('Failed to start frontend:', err.message);
+    });
+  }, 3000);
+  
+  backend.on('error', (err) => {
+    console.error('Failed to start backend:', err.message);
+  });
+  
+  console.log('Backend running on http://localhost:8002');
+  console.log('Frontend running on http://localhost:3000');
+  console.log('\nPress Ctrl+C to stop the services.\n');
+}
+
+function buildCommand() {
+  console.log('\n📦 Building FotricCalw for production...\n');
+  
+  const isWindows = process.platform === 'win32';
+  const shell = isWindows ? true : false;
+  
+  console.log('Building backend...');
+  const backendBuild = spawn('npm', ['run', 'build'], {
+    cwd: path.resolve(PROJECT_ROOT, 'backend'),
+    shell,
+    stdio: 'inherit'
+  });
+  
+  backendBuild.on('close', (code) => {
+    if (code !== 0) {
+      console.error('❌ Backend build failed');
+      process.exit(code);
+    }
+    
+    console.log('\n✅ Backend build complete\n');
+    console.log('Building frontend...');
+    
+    const frontendBuild = spawn('npm', ['run', 'build'], {
+      cwd: path.resolve(PROJECT_ROOT, 'frontend'),
+      shell,
+      stdio: 'inherit'
+    });
+    
+    frontendBuild.on('close', (frontendCode) => {
+      if (frontendCode !== 0) {
+        console.error('❌ Frontend build failed');
+        process.exit(frontendCode);
+      }
+      console.log('\n✅ Frontend build complete');
+      console.log('\n🎉 Build complete! Run "fotric-claw start:prod" to start in production mode.\n');
+    });
+    
+    frontendBuild.on('error', (err) => {
+      console.error('Failed to build frontend:', err.message);
+    });
+  });
+  
+  backendBuild.on('error', (err) => {
+    console.error('Failed to build backend:', err.message);
+  });
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0] || 'help';
+  
+  switch (command) {
+    case 'start':
+      startCommand();
+      break;
+    case 'start:prod':
+      startProdCommand();
+      break;
+    case 'build':
+      buildCommand();
+      break;
+    case 'config':
+      await configCommand();
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+      await showHelp();
+      break;
+    default:
+      console.log(`Unknown command: ${command}`);
+      await showHelp();
+  }
+}
+
+main();

package/frontend/next.config.js

@@ -0,0 +1,14 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+  async rewrites() {
+    return [
+      {
+        source: '/api/:path*',
+        destination: 'http://localhost:8002/api/:path*',
+      },
+    ];
+  },
+};
+
+module.exports = nextConfig;