freeturtle 0.1.29 → 0.1.31

package/dist/src/skills/parser.js

@@ -0,0 +1,84 @@
+/**
+ * SKILL.md frontmatter parser.
+ * Parses YAML frontmatter between --- markers without external dependencies.
+ */
+/**
+ * Parse a SKILL.md file into frontmatter + body.
+ * Returns null if the file doesn't have valid frontmatter.
+ */
+export function parseSkillMd(raw) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith("---"))
+        return null;
+    const secondFence = trimmed.indexOf("---", 3);
+    if (secondFence === -1)
+        return null;
+    const yamlBlock = trimmed.slice(3, secondFence).trim();
+    const body = trimmed.slice(secondFence + 3).trim();
+    const frontmatter = parseSimpleYaml(yamlBlock);
+    if (!frontmatter.name && !frontmatter.description)
+        return null;
+    return { frontmatter: frontmatter, body };
+}
+/**
+ * Minimal YAML parser for flat key-value frontmatter.
+ * Handles strings, booleans, and simple nested metadata maps.
+ * Does NOT handle arrays, multi-line values, or complex YAML.
+ */
+function parseSimpleYaml(yaml) {
+    const result = {};
+    let currentKey = null;
+    let currentMap = null;
+    for (const line of yaml.split("\n")) {
+        // Blank line
+        if (line.trim() === "")
+            continue;
+        // Check indentation — if indented and we're in a map, it's a nested value
+        const indent = line.length - line.trimStart().length;
+        if (indent > 0 && currentMap !== null && currentKey !== null) {
+            const kvMatch = line.trim().match(/^([a-zA-Z0-9_.-]+):\s*(.*)/);
+            if (kvMatch) {
+                currentMap[kvMatch[1]] = unquote(kvMatch[2].trim());
+            }
+            continue;
+        }
+        // Close any open map
+        if (currentMap !== null && currentKey !== null) {
+            result[currentKey] = currentMap;
+            currentMap = null;
+            currentKey = null;
+        }
+        // Top-level key: value
+        const kvMatch = line.match(/^([a-zA-Z0-9_-]+):\s*(.*)/);
+        if (!kvMatch)
+            continue;
+        const key = kvMatch[1];
+        const rawValue = kvMatch[2].trim();
+        // Empty value — could be a map start
+        if (rawValue === "") {
+            currentKey = key;
+            currentMap = {};
+            continue;
+        }
+        result[key] = parseValue(rawValue);
+    }
+    // Close trailing map
+    if (currentMap !== null && currentKey !== null) {
+        result[currentKey] = currentMap;
+    }
+    return result;
+}
+function parseValue(raw) {
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    return unquote(raw);
+}
+function unquote(s) {
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+//# sourceMappingURL=parser.js.map

package/dist/src/skills/parser.js.map

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

package/dist/src/skills/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Agent Skills specification types.
+ * Compatible with OpenClaw, Claude Code, Codex, and ClawHub.
+ * Spec: https://agentskills.io/specification
+ */
+export interface SkillFrontmatter {
+    /** 1-64 chars, lowercase alphanumeric + hyphens, must match directory name */
+    name: string;
+    /** 1-1024 chars, describes what skill does and when to use it */
+    description: string;
+    /** License name or reference to bundled file */
+    license?: string;
+    /** Max 500 chars, environment requirements */
+    compatibility?: string;
+    /** Arbitrary key-value metadata (string to string) */
+    metadata?: Record<string, string>;
+    /** Space-delimited list of pre-approved tools */
+    "allowed-tools"?: string;
+    /** Expose as slash command (default: true) */
+    "user-invocable"?: boolean;
+    /** Prevent auto-invocation by LLM (default: false) */
+    "disable-model-invocation"?: boolean;
+    "argument-hint"?: string;
+    model?: string;
+    context?: string;
+    agent?: string;
+}
+export interface LoadedSkill {
+    /** Skill name (from frontmatter or directory name) */
+    name: string;
+    /** Short description for metadata-level loading */
+    description: string;
+    /** Full SKILL.md body (markdown after frontmatter) */
+    body: string;
+    /** Parsed frontmatter */
+    frontmatter: SkillFrontmatter;
+    /** Absolute path to skill directory */
+    dir: string;
+    /** Where the skill was loaded from */
+    source: "workspace" | "managed" | "bundled" | "extra";
+    /** Whether the LLM can auto-invoke this skill */
+    modelInvocable: boolean;
+    /** Whether the user can invoke as a slash command */
+    userInvocable: boolean;
+    /** Pre-approved tool names */
+    allowedTools: string[];
+}
+export interface SkillsConfig {
+    enabled: boolean;
+    /** Additional directories to scan for skills */
+    extra_dirs?: string[];
+}

package/dist/src/skills/types.js

@@ -0,0 +1,7 @@
+/**
+ * Agent Skills specification types.
+ * Compatible with OpenClaw, Claude Code, Codex, and ClawHub.
+ * Spec: https://agentskills.io/specification
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/skills/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "freeturtle",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "description": "An open-source framework for deploying autonomous AI CEOs that run onchain businesses.",
   "type": "module",
   "main": "dist/bin/freeturtle.js",
@@ -17,7 +17,10 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "keywords": [
     "ai",
@@ -36,9 +39,11 @@
     "@types/pg": "^8.18.0",
     "@types/qrcode-terminal": "^0.12.2",
     "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^10.0.2",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.56.1"
+    "typescript-eslint": "^8.56.1",
+    "vitest": "^4.0.18"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.78.0",