wave-agent-sdk 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,212 @@
+import type { ChildProcess } from "child_process";
+/**
+ * Logger interface definition
+ * Compatible with OpenAI package Logger interface
+ */
+export interface Logger {
+    error: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+}
+export interface Message {
+    role: "user" | "assistant";
+    blocks: MessageBlock[];
+}
+export type MessageBlock = TextBlock | ErrorBlock | ToolBlock | ImageBlock | DiffBlock | CommandOutputBlock | CompressBlock | MemoryBlock | CustomCommandBlock;
+export interface TextBlock {
+    type: "text";
+    content: string;
+}
+export interface ErrorBlock {
+    type: "error";
+    content: string;
+}
+export interface ToolBlock {
+    type: "tool";
+    parameters?: string;
+    result?: string;
+    shortResult?: string;
+    images?: Array<{
+        data: string;
+        mediaType?: string;
+    }>;
+    id?: string;
+    name?: string;
+    isRunning?: boolean;
+    success?: boolean;
+    error?: string | Error;
+    compactParams?: string;
+}
+export interface ImageBlock {
+    type: "image";
+    imageUrls?: string[];
+}
+export interface DiffBlock {
+    type: "diff";
+    path: string;
+    diffResult: Array<{
+        value: string;
+        added?: boolean;
+        removed?: boolean;
+    }>;
+}
+export interface CommandOutputBlock {
+    type: "command_output";
+    command: string;
+    output: string;
+    isRunning: boolean;
+    exitCode: number | null;
+}
+export interface CompressBlock {
+    type: "compress";
+    content: string;
+}
+export interface MemoryBlock {
+    type: "memory";
+    content: string;
+    isSuccess: boolean;
+    memoryType?: "project" | "user";
+    storagePath?: string;
+}
+export interface CustomCommandBlock {
+    type: "custom_command";
+    commandName: string;
+    content: string;
+    originalInput?: string;
+}
+export interface AIRequest {
+    content: string;
+    files: unknown[];
+}
+export interface AIResponse {
+    content: string;
+    status: "success" | "error";
+    error?: string;
+}
+export interface McpServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface McpConfig {
+    mcpServers: Record<string, McpServerConfig>;
+}
+export interface McpTool {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface McpServerStatus {
+    name: string;
+    config: McpServerConfig;
+    status: "disconnected" | "connected" | "connecting" | "error";
+    tools?: McpTool[];
+    toolCount?: number;
+    capabilities?: string[];
+    lastConnected?: number;
+    error?: string;
+}
+export interface BackgroundShell {
+    id: string;
+    process: ChildProcess;
+    command: string;
+    startTime: number;
+    status: "running" | "completed" | "killed";
+    stdout: string;
+    stderr: string;
+    exitCode?: number;
+    runtime?: number;
+}
+export interface SlashCommand {
+    id: string;
+    name: string;
+    description: string;
+    handler: (args?: string) => Promise<void> | void;
+}
+export interface CustomSlashCommandConfig {
+    allowedTools?: string[];
+    model?: string;
+    description?: string;
+}
+export interface CustomSlashCommand {
+    id: string;
+    name: string;
+    description?: string;
+    filePath: string;
+    content: string;
+    config?: CustomSlashCommandConfig;
+}
+export interface SkillMetadata {
+    name: string;
+    description: string;
+    type: "personal" | "project";
+    skillPath: string;
+}
+export interface Skill extends SkillMetadata {
+    content: string;
+    frontmatter: SkillFrontmatter;
+    isValid: boolean;
+    errors: string[];
+}
+export interface SkillFrontmatter {
+    name: string;
+    description: string;
+    [key: string]: unknown;
+}
+export interface SkillCollection {
+    type: "personal" | "project";
+    basePath: string;
+    skills: Map<string, SkillMetadata>;
+    errors: SkillError[];
+}
+export interface SkillError {
+    skillPath: string;
+    message: string;
+}
+export interface SkillValidationResult {
+    isValid: boolean;
+    skill?: Skill;
+    errors: string[];
+}
+export interface SkillDiscoveryResult {
+    personalSkills: Map<string, SkillMetadata>;
+    projectSkills: Map<string, SkillMetadata>;
+    errors: SkillError[];
+}
+export interface SkillInvocationContext {
+    skillName: string;
+}
+export interface SkillToolArgs {
+    skill_name: string;
+}
+export interface SkillManagerOptions {
+    personalSkillsPath?: string;
+    scanTimeout?: number;
+    logger?: Logger;
+}
+export interface ParsedSkillFile {
+    frontmatter: SkillFrontmatter;
+    content: string;
+    skillMetadata: SkillMetadata;
+    validationErrors: string[];
+    isValid: boolean;
+}
+export interface SkillParseOptions {
+    validateMetadata?: boolean;
+    basePath?: string;
+}
+export declare const SKILL_DEFAULTS: {
+    readonly PERSONAL_SKILLS_DIR: ".wave/skills";
+    readonly PROJECT_SKILLS_DIR: ".wave/skills";
+    readonly SKILL_FILE_NAME: "SKILL.md";
+    readonly MAX_NAME_LENGTH: 64;
+    readonly MAX_DESCRIPTION_LENGTH: 1024;
+    readonly MIN_DESCRIPTION_LENGTH: 1;
+    readonly NAME_PATTERN: RegExp;
+    readonly MAX_METADATA_CACHE: 1000;
+    readonly MAX_CONTENT_CACHE: 100;
+    readonly SCAN_TIMEOUT: 5000;
+    readonly LOAD_TIMEOUT: 2000;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,13 @@
+export const SKILL_DEFAULTS = {
+    PERSONAL_SKILLS_DIR: ".wave/skills",
+    PROJECT_SKILLS_DIR: ".wave/skills",
+    SKILL_FILE_NAME: "SKILL.md",
+    MAX_NAME_LENGTH: 64,
+    MAX_DESCRIPTION_LENGTH: 1024,
+    MIN_DESCRIPTION_LENGTH: 1,
+    NAME_PATTERN: /^[a-z0-9-]+$/,
+    MAX_METADATA_CACHE: 1000,
+    MAX_CONTENT_CACHE: 100,
+    SCAN_TIMEOUT: 5000,
+    LOAD_TIMEOUT: 2000,
+};

package/dist/utils/bashHistory.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Bash command history management module
+ * Used for persistent storage and searching of bash commands executed by users
+ */
+export interface BashHistoryEntry {
+    command: string;
+    timestamp: number;
+    workdir: string;
+}
+export interface BashHistory {
+    commands: BashHistoryEntry[];
+    version: number;
+}
+/**
+ * Load bash history
+ */
+export declare const loadBashHistory: () => BashHistory;
+/**
+ * Save bash history
+ */
+export declare const saveBashHistory: (history: BashHistory) => void;
+/**
+ * Add command to bash history
+ */
+export declare const addBashCommandToHistory: (command: string, workdir: string) => void;
+/**
+ * Search bash history by keywords
+ */
+export declare const searchBashHistory: (query: string, limit: number | undefined, workdir: string) => BashHistoryEntry[];
+/**
+ * Get recently used bash commands
+ */
+export declare const getRecentBashCommands: (workdir: string, limit?: number) => BashHistoryEntry[];
+/**
+ * Clear bash history
+ */
+export declare const clearBashHistory: () => void;
+/**
+ * Get bash command statistics
+ */
+export declare const getBashCommandStats: () => {
+    totalCommands: number;
+    uniqueCommands: number;
+    workdirs: string[];
+};
+//# sourceMappingURL=bashHistory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bashHistory.d.ts","sourceRoot":"","sources":["../../src/utils/bashHistory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD;;GAEG;AACH,eAAO,MAAM,eAAe,QAAO,WA+BlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,WAAW,KAAG,IAoBtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,EACf,SAAS,MAAM,KACd,IAkCF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,MAAM,EACb,OAAO,MAAM,YAAK,EAClB,SAAS,MAAM,KACd,gBAAgB,EAiElB,CAAC;AAwBF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,MAAM,EACf,QAAO,MAAW,KACjB,gBAAgB,EAclB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,IAWnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAO;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CAwBpB,CAAC"}

package/dist/utils/bashHistory.js

@@ -0,0 +1,236 @@
+/**
+ * Bash command history management module
+ * Used for persistent storage and searching of bash commands executed by users
+ */
+import fs from "fs";
+import { BASH_HISTORY_FILE, DATA_DIRECTORY } from "./constants.js";
+const HISTORY_VERSION = 1;
+const MAX_HISTORY_SIZE = 1000;
+/**
+ * Ensure data directory exists
+ */
+const ensureDataDirectory = () => {
+    try {
+        if (!fs.existsSync(DATA_DIRECTORY)) {
+            fs.mkdirSync(DATA_DIRECTORY, { recursive: true });
+        }
+    }
+    catch {
+        // logger.debug("Failed to create data directory:", error);
+    }
+};
+/**
+ * Load bash history
+ */
+export const loadBashHistory = () => {
+    try {
+        ensureDataDirectory();
+        if (!fs.existsSync(BASH_HISTORY_FILE)) {
+            return {
+                commands: [],
+                version: HISTORY_VERSION,
+            };
+        }
+        const data = fs.readFileSync(BASH_HISTORY_FILE, "utf-8");
+        const history = JSON.parse(data);
+        // Version compatibility check
+        if (history.version !== HISTORY_VERSION) {
+            // logger.debug("Bash history version mismatch, resetting history");
+            return {
+                commands: [],
+                version: HISTORY_VERSION,
+            };
+        }
+        return history;
+    }
+    catch {
+        // logger.debug("Failed to load bash history:", error);
+        return {
+            commands: [],
+            version: HISTORY_VERSION,
+        };
+    }
+};
+/**
+ * Save bash history
+ */
+export const saveBashHistory = (history) => {
+    try {
+        // Skip saving to file when in test environment
+        if (process.env.NODE_ENV === "test") {
+            // logger.debug("Skipping bash history save in test environment");
+            return;
+        }
+        ensureDataDirectory();
+        // Limit history size
+        if (history.commands.length > MAX_HISTORY_SIZE) {
+            history.commands = history.commands.slice(-MAX_HISTORY_SIZE);
+        }
+        const data = JSON.stringify(history, null, 2);
+        fs.writeFileSync(BASH_HISTORY_FILE, data, "utf-8");
+    }
+    catch {
+        // logger.debug("Failed to save bash history:", error);
+    }
+};
+/**
+ * Add command to bash history
+ */
+export const addBashCommandToHistory = (command, workdir) => {
+    try {
+        // Filter system-generated commands, do not add to history
+        if (command.startsWith("git add . && git commit -m")) {
+            // logger.debug("Skipping system-generated command:", { command, workdir });
+            return;
+        }
+        const history = loadBashHistory();
+        const timestamp = Date.now();
+        // Check if it's a duplicate consecutive command to avoid duplicate recording
+        const lastCommand = history.commands[history.commands.length - 1];
+        if (lastCommand &&
+            lastCommand.command === command &&
+            lastCommand.workdir === workdir) {
+            // Update timestamp of the last record
+            lastCommand.timestamp = timestamp;
+        }
+        else {
+            // Add new command record
+            history.commands.push({
+                command,
+                timestamp,
+                workdir,
+            });
+        }
+        saveBashHistory(history);
+        // logger.debug("Added bash command to history:", { command, workdir });
+    }
+    catch {
+        // logger.debug("Failed to add bash command to history:", error);
+    }
+};
+/**
+ * Search bash history by keywords
+ */
+export const searchBashHistory = (query, limit = 10, workdir) => {
+    try {
+        const history = loadBashHistory();
+        const normalizedQuery = query.toLowerCase().trim();
+        let filteredCommands = history.commands;
+        // Working directory filter
+        filteredCommands = filteredCommands.filter((entry) => entry.workdir === workdir);
+        if (!normalizedQuery) {
+            // If no search query, return recent commands (deduplicated)
+            const deduped = deduplicateCommands(filteredCommands);
+            return deduped.slice(-limit).reverse(); // Latest first
+        }
+        // Search by relevance
+        const matches = filteredCommands
+            .filter((entry) => {
+            // Command content matching
+            const command = entry.command.toLowerCase();
+            return command.includes(normalizedQuery);
+        })
+            .map((entry) => {
+            // Calculate match score
+            const command = entry.command.toLowerCase();
+            let score = 0;
+            // Exact match gets higher score
+            if (command.includes(normalizedQuery)) {
+                score += 10;
+            }
+            // Command prefix match gets higher score
+            if (command.startsWith(normalizedQuery)) {
+                score += 20;
+            }
+            // Word boundary match gets higher score
+            const words = command.split(/\s+/);
+            if (words.some((word) => word.startsWith(normalizedQuery))) {
+                score += 15;
+            }
+            // Timestamp influence (newer gets higher score)
+            score += entry.timestamp / 1000000; // Normalize timestamp
+            return { entry, score };
+        })
+            .sort((a, b) => b.score - a.score) // Sort by score descending
+            .map((item) => item.entry);
+        // Deduplicate search results, keep latest record
+        const dedupedMatches = deduplicateCommands(matches);
+        const result = dedupedMatches.slice(0, limit);
+        // logger.debug("Bash history search results:", { query, workdir: process.cwd(), originalCount: matches.length, dedupedCount: result.length });
+        return result;
+    }
+    catch {
+        // logger.debug("Failed to search bash history:", error);
+        return [];
+    }
+};
+/**
+ * Deduplicate command list, keep latest record for each command
+ */
+const deduplicateCommands = (commands) => {
+    const commandMap = new Map();
+    // Iterate through all commands, keep latest record for each
+    for (const entry of commands) {
+        const existing = commandMap.get(entry.command);
+        if (!existing || entry.timestamp > existing.timestamp) {
+            commandMap.set(entry.command, entry);
+        }
+    }
+    // Sort by timestamp and return
+    return Array.from(commandMap.values()).sort((a, b) => a.timestamp - b.timestamp);
+};
+/**
+ * Get recently used bash commands
+ */
+export const getRecentBashCommands = (workdir, limit = 10) => {
+    try {
+        const history = loadBashHistory();
+        const filtered = history.commands.filter((entry) => entry.workdir === workdir);
+        // Return recent commands after deduplication
+        const deduped = deduplicateCommands(filtered);
+        return deduped.slice(-limit).reverse(); // Latest first
+    }
+    catch {
+        // logger.debug("Failed to get recent bash commands:", error);
+        return [];
+    }
+};
+/**
+ * Clear bash history
+ */
+export const clearBashHistory = () => {
+    try {
+        const history = {
+            commands: [],
+            version: HISTORY_VERSION,
+        };
+        saveBashHistory(history);
+        // logger.debug("Bash history cleared");
+    }
+    catch {
+        // logger.debug("Failed to clear bash history:", error);
+    }
+};
+/**
+ * Get bash command statistics
+ */
+export const getBashCommandStats = () => {
+    try {
+        const history = loadBashHistory();
+        const uniqueCommands = new Set(history.commands.map((entry) => entry.command));
+        const workdirs = Array.from(new Set(history.commands.map((entry) => entry.workdir)));
+        return {
+            totalCommands: history.commands.length,
+            uniqueCommands: uniqueCommands.size,
+            workdirs,
+        };
+    }
+    catch {
+        // logger.debug("Failed to get bash command stats:", error);
+        return {
+            totalCommands: 0,
+            uniqueCommands: 0,
+            workdirs: [],
+        };
+    }
+};

package/dist/utils/commandArgumentParser.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Command Argument Parser
+ *
+ * Provides parameter substitution for custom slash commands similar to Claude's system:
+ * - $ARGUMENTS: All arguments as a single string
+ * - $1, $2, $3, etc.: Individual positional arguments
+ * - Supports quoted arguments with spaces
+ * - Handles escaped quotes within arguments
+ */
+/**
+ * Parse command arguments from a string, respecting quotes
+ */
+export declare function parseCommandArguments(argsString: string): string[];
+/**
+ * Substitute command parameters in content
+ */
+export declare function substituteCommandParameters(content: string, argsString: string): string;
+/**
+ * Extract command name and arguments from a slash command input
+ * Example: "/fix-issue 123 high-priority" -> { command: "fix-issue", args: "123 high-priority" }
+ */
+export declare function parseSlashCommandInput(input: string): {
+    command: string;
+    args: string;
+};
+/**
+ * Check if content contains parameter placeholders
+ */
+export declare function hasParameterPlaceholders(content: string): boolean;
+/**
+ * Get all parameter placeholders used in content
+ */
+export declare function getUsedParameterPlaceholders(content: string): string[];
+//# sourceMappingURL=commandArgumentParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commandArgumentParser.d.ts","sourceRoot":"","sources":["../../src/utils/commandArgumentParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CA+DlE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CAsBR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAsBA;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAGtE"}

package/dist/utils/commandArgumentParser.js

@@ -0,0 +1,123 @@
+/**
+ * Command Argument Parser
+ *
+ * Provides parameter substitution for custom slash commands similar to Claude's system:
+ * - $ARGUMENTS: All arguments as a single string
+ * - $1, $2, $3, etc.: Individual positional arguments
+ * - Supports quoted arguments with spaces
+ * - Handles escaped quotes within arguments
+ */
+/**
+ * Parse command arguments from a string, respecting quotes
+ */
+export function parseCommandArguments(argsString) {
+    if (!argsString.trim()) {
+        return [];
+    }
+    const args = [];
+    let current = "";
+    let inQuotes = false;
+    let quoteChar = "";
+    let escaped = false;
+    for (let i = 0; i < argsString.length; i++) {
+        const char = argsString[i];
+        const nextChar = argsString[i + 1];
+        if (escaped) {
+            current += char;
+            escaped = false;
+            continue;
+        }
+        if (char === "\\") {
+            // Handle escape sequences
+            if (inQuotes && (nextChar === quoteChar || nextChar === "\\")) {
+                escaped = true;
+                continue;
+            }
+            current += char;
+            continue;
+        }
+        if (!inQuotes && (char === '"' || char === "'")) {
+            // Start quoted string
+            inQuotes = true;
+            quoteChar = char;
+            continue;
+        }
+        if (inQuotes && char === quoteChar) {
+            // End quoted string
+            inQuotes = false;
+            quoteChar = "";
+            continue;
+        }
+        if (!inQuotes && /\s/.test(char)) {
+            // Whitespace outside quotes - end current argument
+            if (current) {
+                args.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += char;
+    }
+    // Add final argument if any
+    if (current) {
+        args.push(current);
+    }
+    return args;
+}
+/**
+ * Substitute command parameters in content
+ */
+export function substituteCommandParameters(content, argsString) {
+    const args = parseCommandArguments(argsString);
+    let result = content;
+    // Replace $ARGUMENTS with all arguments
+    result = result.replace(/\$ARGUMENTS/g, argsString);
+    // Replace positional parameters $1, $2, etc.
+    // Sort by parameter number (descending) to avoid replacing $10 with $1 + "0"
+    const positionalParams = [...result.matchAll(/\$(\d+)/g)]
+        .map((match) => parseInt(match[1], 10))
+        .filter((value, index, array) => array.indexOf(value) === index) // unique
+        .sort((a, b) => b - a); // descending order
+    for (const paramNum of positionalParams) {
+        const paramValue = args[paramNum - 1] || ""; // Arrays are 0-indexed, params are 1-indexed
+        const paramRegex = new RegExp(`\\$${paramNum}`, "g");
+        result = result.replace(paramRegex, paramValue);
+    }
+    return result;
+}
+/**
+ * Extract command name and arguments from a slash command input
+ * Example: "/fix-issue 123 high-priority" -> { command: "fix-issue", args: "123 high-priority" }
+ */
+export function parseSlashCommandInput(input) {
+    const trimmed = input.trim();
+    if (!trimmed.startsWith("/")) {
+        throw new Error("Input must start with /");
+    }
+    const withoutSlash = trimmed.substring(1);
+    const firstSpaceIndex = withoutSlash.indexOf(" ");
+    if (firstSpaceIndex === -1) {
+        // No arguments
+        return {
+            command: withoutSlash,
+            args: "",
+        };
+    }
+    return {
+        command: withoutSlash.substring(0, firstSpaceIndex),
+        args: withoutSlash.substring(firstSpaceIndex + 1).trim(),
+    };
+}
+/**
+ * Check if content contains parameter placeholders
+ */
+export function hasParameterPlaceholders(content) {
+    return /\$(?:ARGUMENTS|\d+)/.test(content);
+}
+/**
+ * Get all parameter placeholders used in content
+ */
+export function getUsedParameterPlaceholders(content) {
+    const matches = content.match(/\$(?:ARGUMENTS|\d+)/g);
+    return matches ? [...new Set(matches)] : [];
+}