wave-agent-sdk 0.0.1

package/dist/utils/path.js

@@ -0,0 +1,109 @@
+import { resolve } from "path";
+import { homedir } from "os";
+import { relative } from "path";
+/**
+ * Handle paths, supporting ~ expansion
+ * @param filePath File path
+ * @param workdir Working directory
+ * @returns Resolved absolute path
+ */
+export function resolvePath(filePath, workdir) {
+    // If the path starts with ~, replace it with the user's home directory
+    if (filePath.startsWith("~/")) {
+        return resolve(homedir(), filePath.slice(2));
+    }
+    // If the path starts with ~ but has no slash, it means it's the home directory
+    if (filePath === "~") {
+        return homedir();
+    }
+    // For other paths, resolve using the specified working directory
+    return resolve(workdir, filePath);
+}
+/**
+ * Binary file extension list
+ */
+export const binaryExtensions = [
+    // Image files
+    "png",
+    "jpg",
+    "jpeg",
+    "gif",
+    "bmp",
+    "ico",
+    "webp",
+    "svg",
+    "sketch",
+    // Audio files
+    "mp3",
+    "wav",
+    "ogg",
+    "aac",
+    // Video files
+    "mp4",
+    "webm",
+    "avi",
+    "mov",
+    // Document files
+    "pdf",
+    "doc",
+    "docx",
+    "xls",
+    "xlsx",
+    "ppt",
+    "pptx",
+    // Compressed files
+    "zip",
+    "rar",
+    "7z",
+    "tar",
+    "gz",
+    // Font files
+    "ttf",
+    "otf",
+    "woff",
+    "woff2",
+    "eot",
+    // Other binary files
+    "exe",
+    "dll",
+    "so",
+    "dylib",
+    "bin",
+];
+/**
+ * Check if a file is a binary file
+ * @param filename File name
+ * @returns Whether it is a binary file
+ */
+export const isBinary = (filename) => {
+    const parts = filename.split(".");
+    const ext = parts.length > 1 ? parts.pop()?.toLowerCase() || "" : "";
+    return binaryExtensions.includes(ext);
+};
+/**
+ * Get relative path for display, use relative path if shorter and not in parent directory
+ * @param filePath Absolute path
+ * @param workdir Working directory
+ * @returns Path for display (relative or absolute)
+ */
+export function getDisplayPath(filePath, workdir) {
+    if (!filePath) {
+        return filePath;
+    }
+    try {
+        const relativePath = relative(workdir, filePath);
+        // If the relative path is empty (i.e., the paths are the same), return "."
+        if (relativePath === "") {
+            return ".";
+        }
+        // If the relative path is shorter than the absolute path and does not start with .. (not in parent directory), use the relative path
+        if (relativePath.length < filePath.length &&
+            !relativePath.startsWith("..")) {
+            return relativePath;
+        }
+    }
+    catch {
+        // If calculating the relative path fails, keep the original path
+    }
+    return filePath;
+}

package/dist/utils/skillParser.d.ts

@@ -0,0 +1,18 @@
+import type { ParsedSkillFile, SkillParseOptions, SkillMetadata } from "../types.js";
+/**
+ * Parse a SKILL.md file and validate its contents
+ */
+export declare function parseSkillFile(filePath: string, options?: SkillParseOptions): ParsedSkillFile;
+/**
+ * Validate skill metadata according to requirements
+ */
+export declare function validateSkillMetadata(metadata: SkillMetadata): string[];
+/**
+ * Check if a skill name is valid format
+ */
+export declare function isValidSkillName(name: string): boolean;
+/**
+ * Generate user-friendly error messages for skill validation
+ */
+export declare function formatSkillError(skillPath: string, errors: string[]): string;
+//# sourceMappingURL=skillParser.d.ts.map

package/dist/utils/skillParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillParser.d.ts","sourceRoot":"","sources":["../../src/utils/skillParser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAEjB,aAAa,EACd,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,iBAAsB,GAC9B,eAAe,CAiEjB;AAkCD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAwCvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAa5E"}

package/dist/utils/skillParser.js

@@ -0,0 +1,147 @@
+import { readFileSync } from "fs";
+import { dirname } from "path";
+/**
+ * Parse a SKILL.md file and validate its contents
+ */
+export function parseSkillFile(filePath, options = {}) {
+    const { validateMetadata = true, basePath } = options;
+    const result = {
+        frontmatter: { name: "", description: "" },
+        content: "",
+        skillMetadata: {
+            name: "",
+            description: "",
+            type: "personal",
+            skillPath: "",
+        },
+        validationErrors: [],
+        isValid: false,
+    };
+    try {
+        // Read file content
+        const content = readFileSync(filePath, "utf-8");
+        result.content = content;
+        // Parse YAML frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            result.validationErrors.push("Missing YAML frontmatter");
+            return result;
+        }
+        const yamlContent = frontmatterMatch[1];
+        result.frontmatter = parseYamlFrontmatter(yamlContent);
+        if (!result.frontmatter.name || !result.frontmatter.description) {
+            result.validationErrors.push("Missing required fields: name and description");
+            return result;
+        }
+        // Determine skill type and path
+        const skillPath = basePath || dirname(filePath);
+        const skillType = skillPath.includes("/.wave/skills")
+            ? "project"
+            : "personal";
+        result.skillMetadata = {
+            name: result.frontmatter.name,
+            description: result.frontmatter.description,
+            type: skillType,
+            skillPath,
+        };
+        // Validate metadata if requested
+        if (validateMetadata) {
+            const validationErrors = validateSkillMetadata(result.skillMetadata);
+            result.validationErrors.push(...validationErrors);
+        }
+        result.isValid = result.validationErrors.length === 0;
+        return result;
+    }
+    catch (error) {
+        result.validationErrors.push(`Failed to read skill file: ${error instanceof Error ? error.message : String(error)}`);
+        return result;
+    }
+}
+/**
+ * Simple YAML frontmatter parser for skill files
+ */
+function parseYamlFrontmatter(yamlContent) {
+    const frontmatter = { name: "", description: "" };
+    try {
+        const lines = yamlContent.split("\n");
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            const colonIndex = trimmed.indexOf(":");
+            if (colonIndex === -1)
+                continue;
+            const key = trimmed.substring(0, colonIndex).trim();
+            const value = trimmed
+                .substring(colonIndex + 1)
+                .trim()
+                .replace(/^["']|["']$/g, "");
+            if (key && value) {
+                frontmatter[key] = value;
+            }
+        }
+    }
+    catch {
+        // Return empty frontmatter on parse error - validation will catch missing fields
+    }
+    return frontmatter;
+}
+/**
+ * Validate skill metadata according to requirements
+ */
+export function validateSkillMetadata(metadata) {
+    const errors = [];
+    // Import SKILL_DEFAULTS dynamically to avoid circular imports
+    const NAME_PATTERN = /^[a-z0-9-]+$/;
+    const MAX_NAME_LENGTH = 64;
+    const MAX_DESCRIPTION_LENGTH = 1024;
+    const MIN_DESCRIPTION_LENGTH = 1;
+    // Validate name
+    if (!metadata.name) {
+        errors.push("Skill name is required");
+    }
+    else {
+        if (metadata.name.length > MAX_NAME_LENGTH) {
+            errors.push(`Skill name must be ${MAX_NAME_LENGTH} characters or less`);
+        }
+        if (!NAME_PATTERN.test(metadata.name)) {
+            errors.push("Skill name must contain only lowercase letters, numbers, and hyphens");
+        }
+    }
+    // Validate description
+    if (!metadata.description) {
+        errors.push("Skill description is required");
+    }
+    else {
+        if (metadata.description.length < MIN_DESCRIPTION_LENGTH) {
+            errors.push(`Skill description must be at least ${MIN_DESCRIPTION_LENGTH} character`);
+        }
+        if (metadata.description.length > MAX_DESCRIPTION_LENGTH) {
+            errors.push(`Skill description must be ${MAX_DESCRIPTION_LENGTH} characters or less`);
+        }
+    }
+    return errors;
+}
+/**
+ * Check if a skill name is valid format
+ */
+export function isValidSkillName(name) {
+    const NAME_PATTERN = /^[a-z0-9-]+$/;
+    const MAX_NAME_LENGTH = 64;
+    return (name.length > 0 && name.length <= MAX_NAME_LENGTH && NAME_PATTERN.test(name));
+}
+/**
+ * Generate user-friendly error messages for skill validation
+ */
+export function formatSkillError(skillPath, errors) {
+    const header = `Skill validation failed for ${skillPath}:`;
+    const errorList = errors.map((error) => `  • ${error}`).join("\n");
+    const suggestions = [
+        "To fix this skill:",
+        "  1. Ensure SKILL.md has valid YAML frontmatter (---...---)",
+        "  2. Include required fields: name and description",
+        "  3. Use lowercase letters, numbers, and hyphens only for name",
+        "  4. Keep name under 64 characters and description under 1024 characters",
+    ].join("\n");
+    return `${header}\n${errorList}\n\n${suggestions}`;
+}

package/dist/utils/stringUtils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Remove code block wrappers
+ * @param content Content that may contain code block wrappers
+ * @returns Content after removing wrappers
+ */
+export declare function removeCodeBlockWrappers(content: string): string;
+/**
+ * Function to remove ANSI color codes
+ * @param text Text containing ANSI color codes
+ * @returns Plain text with color codes removed
+ */
+export declare const stripAnsiColors: (text: string) => string;
+//# sourceMappingURL=stringUtils.d.ts.map

package/dist/utils/stringUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringUtils.d.ts","sourceRoot":"","sources":["../../src/utils/stringUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgC/D;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAK9C,CAAC"}

package/dist/utils/stringUtils.js

@@ -0,0 +1,44 @@
+/**
+ * Remove code block wrappers
+ * @param content Content that may contain code block wrappers
+ * @returns Content after removing wrappers
+ */
+export function removeCodeBlockWrappers(content) {
+    // Remove code block wrappers from beginning and end
+    // Supports the following formats:
+    // ```language
+    // code content
+    // ```
+    //
+    // ```
+    // code content
+    // ```
+    const lines = content.split("\n");
+    let startIndex = 0;
+    let endIndex = lines.length - 1;
+    // Check if there is a code block marker at the beginning
+    if (lines[startIndex]?.trim().startsWith("```")) {
+        startIndex = 1;
+    }
+    // Check if there is a code block marker at the end
+    if (lines[endIndex]?.trim() === "```") {
+        endIndex = endIndex - 1;
+    }
+    // If no complete code block wrapper is found, return original content
+    if (startIndex === 0 && endIndex === lines.length - 1) {
+        return content;
+    }
+    // Return content after removing wrappers
+    return lines.slice(startIndex, endIndex + 1).join("\n");
+}
+/**
+ * Function to remove ANSI color codes
+ * @param text Text containing ANSI color codes
+ * @returns Plain text with color codes removed
+ */
+export const stripAnsiColors = (text) => {
+    // Create the escape character dynamically to avoid control character detection
+    const escapeChar = String.fromCharCode(27); // ESC character
+    const ansiEscapeRegex = new RegExp(`${escapeChar}\\[[0-9;]*[a-zA-Z]`, "g");
+    return text.replace(ansiEscapeRegex, "");
+};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "wave-agent-sdk",
+  "version": "0.0.1",
+  "description": "SDK for building AI-powered development tools and agents",
+  "keywords": [
+    "ai",
+    "sdk",
+    "agent",
+    "development-tools",
+    "typescript",
+    "mcp"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rimraf dist && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "type-check": "tsc --noEmit --incremental",
+    "dev": "tsc -p tsconfig.build.json --watch & tsc-alias -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "lint": "eslint --cache",
+    "format": "prettier --write .",
+    "release:patch": "pnpm version patch && npm publish",
+    "release:minor": "pnpm version minor && npm publish",
+    "release:major": "pnpm version major && npm publish",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.2",
+    "@vscode/ripgrep": "^1.15.14",
+    "diff": "^8.0.2",
+    "glob": "^11.0.3",
+    "minimatch": "^10.0.3",
+    "openai": "^5.12.2"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.1",
+    "tsc-alias": "^1.8.16",
+    "tsx": "^4.20.4",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "license": "MIT"
+}