wave-agent-sdk 0.0.1

package/dist/hooks/settings.js

@@ -0,0 +1,100 @@
+/**
+ * Hook Settings Management
+ *
+ * Handles loading and merging of hook configurations from:
+ * - User settings: ~/.wave/hooks.json
+ * - Project settings: ./.wave/hooks.json
+ */
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { isValidHookEvent } from "./types.js";
+/**
+ * Get the user-specific hooks configuration file path
+ */
+export function getUserHooksConfigPath() {
+    return join(homedir(), ".wave", "hooks.json");
+}
+/**
+ * Get the project-specific hooks configuration file path
+ */
+export function getProjectHooksConfigPath(workdir) {
+    return join(workdir, ".wave", "hooks.json");
+}
+/**
+ * Load hooks configuration from a JSON file
+ */
+export function loadHooksConfigFromFile(filePath) {
+    try {
+        if (!existsSync(filePath)) {
+            return null;
+        }
+        const content = readFileSync(filePath, "utf-8");
+        const config = JSON.parse(content);
+        // Validate basic structure
+        if (!config || typeof config !== "object" || !config.hooks) {
+            console.warn(`Invalid hooks configuration structure in ${filePath}`);
+            return null;
+        }
+        return config.hooks;
+    }
+    catch (error) {
+        console.warn(`Failed to load hooks configuration from ${filePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Load user hooks configuration
+ */
+export function loadUserHooksConfig() {
+    return loadHooksConfigFromFile(getUserHooksConfigPath());
+}
+/**
+ * Load project hooks configuration
+ */
+export function loadProjectHooksConfig(workdir) {
+    return loadHooksConfigFromFile(getProjectHooksConfigPath(workdir));
+}
+/**
+ * Load and merge hooks configuration with project settings taking precedence
+ */
+export function loadMergedHooksConfig(workdir) {
+    const userConfig = loadUserHooksConfig();
+    const projectConfig = loadProjectHooksConfig(workdir);
+    const merged = {};
+    // Start with user configuration
+    if (userConfig) {
+        Object.entries(userConfig).forEach(([event, configs]) => {
+            if (isValidHookEvent(event)) {
+                merged[event] = [...configs];
+            }
+        });
+    }
+    // Override with project configuration (project takes precedence)
+    if (projectConfig) {
+        Object.entries(projectConfig).forEach(([event, configs]) => {
+            if (isValidHookEvent(event)) {
+                merged[event] = [...configs];
+            }
+        });
+    }
+    return merged;
+}
+/**
+ * Check if any hooks configuration files exist
+ */
+export function hasHooksConfiguration(workdir) {
+    return (existsSync(getUserHooksConfigPath()) ||
+        existsSync(getProjectHooksConfigPath(workdir)));
+}
+/**
+ * Get information about available hooks configuration files
+ */
+export function getHooksConfigurationInfo(workdir) {
+    return {
+        userConfigExists: existsSync(getUserHooksConfigPath()),
+        projectConfigExists: existsSync(getProjectHooksConfigPath(workdir)),
+        userConfigPath: getUserHooksConfigPath(),
+        projectConfigPath: getProjectHooksConfigPath(workdir),
+    };
+}

package/dist/hooks/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Hooks System Type Definitions
+ *
+ * Provides comprehensive TypeScript types for the Wave Code hooks system,
+ * enabling automated actions at specific workflow points.
+ */
+export declare function getSessionFilePath(sessionId: string): string;
+export type HookEvent = "PreToolUse" | "PostToolUse" | "UserPromptSubmit" | "Stop";
+export interface HookCommand {
+    type: "command";
+    command: string;
+}
+export interface HookEventConfig {
+    matcher?: string;
+    hooks: HookCommand[];
+}
+export interface HookConfiguration {
+    hooks: Partial<Record<HookEvent, HookEventConfig[]>>;
+}
+export type PartialHookConfiguration = Partial<Record<HookEvent, HookEventConfig[]>>;
+export type HookConfigurationRecord = Record<HookEvent, HookEventConfig[]>;
+export interface HookExecutionContext {
+    event: HookEvent;
+    toolName?: string;
+    projectDir: string;
+    timestamp: Date;
+}
+export interface HookExecutionResult {
+    success: boolean;
+    exitCode?: number;
+    stdout?: string;
+    stderr?: string;
+    duration: number;
+    timedOut: boolean;
+}
+export interface HookExecutionOptions {
+    timeout?: number;
+    cwd?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare class HookExecutionError extends Error {
+    readonly hookCommand: string;
+    readonly originalError: Error;
+    readonly context: HookExecutionContext;
+    constructor(hookCommand: string, originalError: Error, context: HookExecutionContext);
+}
+export declare class HookConfigurationError extends Error {
+    readonly configPath: string;
+    readonly validationErrors: string[];
+    constructor(configPath: string, validationErrors: string[]);
+}
+export declare function isValidHookEvent(event: string): event is HookEvent;
+export declare function isValidHookCommand(cmd: unknown): cmd is HookCommand;
+export declare function isValidHookEventConfig(config: unknown): config is HookEventConfig;
+export interface HookJsonInput {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    hook_event_name: HookEvent;
+    tool_name?: string;
+    tool_input?: unknown;
+    tool_response?: unknown;
+    user_prompt?: string;
+}
+export interface ExtendedHookExecutionContext extends HookExecutionContext {
+    sessionId?: string;
+    transcriptPath?: string;
+    cwd?: string;
+    toolInput?: unknown;
+    toolResponse?: unknown;
+    userPrompt?: string;
+}
+export interface HookEnvironment {
+    WAVE_PROJECT_DIR: string;
+    [key: string]: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/types.d.ts.map

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

package/dist/hooks/types.js

@@ -0,0 +1,59 @@
+/**
+ * Hooks System Type Definitions
+ *
+ * Provides comprehensive TypeScript types for the Wave Code hooks system,
+ * enabling automated actions at specific workflow points.
+ */
+import { join } from "path";
+import { homedir } from "os";
+// Session path utility (from session.ts)
+export function getSessionFilePath(sessionId) {
+    const shortId = sessionId.split("_")[2] || sessionId.slice(-8);
+    return join(homedir(), ".wave", "sessions", `session_${shortId}.json`);
+}
+// Hook execution errors (non-blocking)
+export class HookExecutionError extends Error {
+    constructor(hookCommand, originalError, context) {
+        super(`Hook execution failed: ${hookCommand} - ${originalError.message}`);
+        this.hookCommand = hookCommand;
+        this.originalError = originalError;
+        this.context = context;
+        this.name = "HookExecutionError";
+    }
+}
+// Configuration validation errors (blocking)
+export class HookConfigurationError extends Error {
+    constructor(configPath, validationErrors) {
+        super(`Hook configuration error in ${configPath}: ${validationErrors.join(", ")}`);
+        this.configPath = configPath;
+        this.validationErrors = validationErrors;
+        this.name = "HookConfigurationError";
+    }
+}
+// Type guards for runtime validation
+export function isValidHookEvent(event) {
+    return ["PreToolUse", "PostToolUse", "UserPromptSubmit", "Stop"].includes(event);
+}
+export function isValidHookCommand(cmd) {
+    return (typeof cmd === "object" &&
+        cmd !== null &&
+        "type" in cmd &&
+        cmd.type === "command" &&
+        "command" in cmd &&
+        typeof cmd.command === "string" &&
+        cmd.command.length > 0);
+}
+export function isValidHookEventConfig(config) {
+    if (typeof config !== "object" || config === null)
+        return false;
+    const cfg = config;
+    // Validate hooks array
+    if (!Array.isArray(cfg.hooks) || cfg.hooks.length === 0)
+        return false;
+    if (!cfg.hooks.every(isValidHookCommand))
+        return false;
+    // Validate optional matcher
+    if ("matcher" in cfg && typeof cfg.matcher !== "string")
+        return false;
+    return true;
+}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./services/aiService.js";
+export * from "./services/memory.js";
+export * from "./services/session.js";
+export * from "./agent.js";
+export * from "./utils/bashHistory.js";
+export * from "./utils/convertMessagesForAPI.js";
+export * from "./utils/fileFilter.js";
+export * from "./utils/mcpUtils.js";
+export * from "./utils/messageOperations.js";
+export * from "./utils/path.js";
+export * from "./utils/stringUtils.js";
+export * from "./utils/markdownParser.js";
+export * from "./utils/customCommands.js";
+export * from "./hooks/index.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,YAAY,CAAC;AAG3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAG1C,cAAc,kBAAkB,CAAC;AAGjC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+// Export all services
+export * from "./services/aiService.js";
+export * from "./services/memory.js";
+export * from "./services/session.js";
+// Export main agent
+export * from "./agent.js";
+// Export all utilities
+export * from "./utils/bashHistory.js";
+export * from "./utils/convertMessagesForAPI.js";
+export * from "./utils/fileFilter.js";
+export * from "./utils/mcpUtils.js";
+export * from "./utils/messageOperations.js";
+export * from "./utils/path.js";
+export * from "./utils/stringUtils.js";
+export * from "./utils/markdownParser.js";
+export * from "./utils/customCommands.js";
+// Export hooks system
+export * from "./hooks/index.js";
+// Export types
+export * from "./types.js";

package/dist/managers/aiManager.d.ts

@@ -0,0 +1,61 @@
+import type { Logger } from "../types.js";
+import type { ToolManager } from "./toolManager.js";
+import type { MessageManager } from "./messageManager.js";
+import type { BackgroundBashManager } from "./backgroundBashManager.js";
+import type { HookManager } from "../hooks/index.js";
+export interface AIManagerCallbacks {
+    onCompressionStateChange?: (isCompressing: boolean) => void;
+}
+export interface AIManagerOptions {
+    messageManager: MessageManager;
+    toolManager: ToolManager;
+    logger?: Logger;
+    backgroundBashManager?: BackgroundBashManager;
+    hookManager?: HookManager;
+    callbacks?: AIManagerCallbacks;
+    workdir: string;
+    systemPrompt?: string;
+}
+export declare class AIManager {
+    isLoading: boolean;
+    private abortController;
+    private toolAbortController;
+    private logger?;
+    private toolManager;
+    private messageManager;
+    private backgroundBashManager?;
+    private hookManager?;
+    private workdir;
+    private systemPrompt?;
+    constructor(options: AIManagerOptions);
+    private isCompressing;
+    private callbacks;
+    /**
+     * Get filtered tool configuration
+     */
+    private getFilteredToolsConfig;
+    setIsLoading(isLoading: boolean): void;
+    abortAIMessage(): void;
+    private generateCompactParams;
+    private handleTokenUsageAndCompression;
+    getIsCompressing(): boolean;
+    setIsCompressing(isCompressing: boolean): void;
+    sendAIMessage(options?: {
+        recursionDepth?: number;
+        model?: string;
+        allowedTools?: string[];
+    }): Promise<void>;
+    /**
+     * Execute Stop hooks when AI response cycle completes
+     */
+    private executeStopHooks;
+    /**
+     * Execute PreToolUse hooks before tool execution
+     */
+    private executePreToolUseHooks;
+    /**
+     * Execute PostToolUse hooks after tool completion
+     */
+    private executePostToolUseHooks;
+}
+//# sourceMappingURL=aiManager.d.ts.map

package/dist/managers/aiManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiManager.d.ts","sourceRoot":"","sources":["../../src/managers/aiManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,WAAW,kBAAkB;IACjC,wBAAwB,CAAC,EAAE,CAAC,aAAa,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,SAAS;IACb,SAAS,EAAE,OAAO,CAAS;IAClC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,mBAAmB,CAAgC;IAC3D,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,qBAAqB,CAAC,CAAwB;IACtD,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAC,CAAS;gBAElB,OAAO,EAAE,gBAAgB;IAWrC,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,SAAS,CAAqB;IAEtC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAYvB,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAItC,cAAc,IAAI,IAAI;IAuB7B,OAAO,CAAC,qBAAqB;YAqBf,8BAA8B;IAuDrC,gBAAgB,IAAI,OAAO;IAI3B,gBAAgB,CAAC,aAAa,EAAE,OAAO,GAAG,IAAI;IAOxC,aAAa,CACxB,OAAO,GAAE;QACP,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GACL,OAAO,CAAC,IAAI,CAAC;IA6PhB;;OAEG;YACW,gBAAgB;IAmC9B;;OAEG;YACW,sBAAsB;IA0CpC;;OAEG;YACW,uBAAuB;CA2CtC"}