wave-agent-sdk 1.0.5 → 1.0.7

package/src/types/hooks.ts

@@ -1,256 +0,0 @@
-/**
- * Hooks System Type Definitions
- *
- * Provides comprehensive TypeScript types for the Wave Code hooks system,
- * enabling automated actions at specific workflow points.
- */
-
-export type {
-  WaveConfiguration,
-  HookConfiguration,
-  PartialHookConfiguration,
-  HookConfigurationRecord,
-} from "./configuration.js";
-
-// Hook event types - trigger points in the AI workflow
-export type HookEvent =
-  | "PreToolUse"
-  | "PostToolUse"
-  | "UserPromptSubmit"
-  | "Stop"
-  | "SubagentStop"
-  | "PermissionRequest"
-  | "WorktreeCreate"
-  | "WorktreeRemove"
-  | "CwdChanged"
-  | "SessionStart"
-  | "SessionEnd"
-  | "PreCompact"
-  | "PostCompact";
-
-// Individual hook command configuration
-export interface HookCommand {
-  type: "command";
-  command: string;
-  async?: boolean;
-  timeout?: number; // seconds
-  pluginRoot?: string; // Plugin directory path for plugin-originated hooks
-}
-
-// Hook event configuration with optional pattern matching
-export interface HookEventConfig {
-  matcher?: string; // Required for PreToolUse/PostToolUse, omitted for others
-  hooks: HookCommand[];
-}
-
-// Context passed to hook during execution
-export interface HookExecutionContext {
-  event: HookEvent;
-  toolName?: string; // Present for PreToolUse/PostToolUse events
-  projectDir: string; // Absolute path for $WAVE_PROJECT_DIR
-  timestamp: Date;
-  worktreeName?: string; // Present for WorktreeCreate
-  worktreePath?: string; // Present for WorktreeRemove
-  planFilePath?: string; // Present when in plan mode
-}
-
-// Result of hook execution
-export interface HookExecutionResult {
-  success: boolean;
-  exitCode?: number;
-  stdout?: string;
-  stderr?: string;
-  duration: number; // milliseconds
-  timedOut: boolean;
-}
-
-// Hook execution options
-export interface HookExecutionOptions {
-  timeout?: number; // milliseconds, default 10000
-  cwd?: string; // working directory, defaults to projectDir
-  continueOnFailure?: boolean; // continue executing remaining hooks on failure
-}
-
-// Validation result for hook configuration
-export interface HookValidationResult {
-  valid: boolean;
-  errors: string[];
-}
-
-// Hook execution errors (non-blocking)
-export class HookExecutionError extends Error {
-  constructor(
-    public readonly hookCommand: string,
-    public readonly originalError: Error,
-    public readonly context: HookExecutionContext,
-  ) {
-    super(`Hook execution failed: ${hookCommand} - ${originalError.message}`);
-    this.name = "HookExecutionError";
-  }
-}
-
-// Configuration validation errors (blocking)
-export class HookConfigurationError extends Error {
-  constructor(
-    public readonly configPath: string,
-    public readonly validationErrors: string[],
-  ) {
-    super(
-      `Hook configuration error in ${configPath}: ${validationErrors.join(", ")}`,
-    );
-    this.name = "HookConfigurationError";
-  }
-}
-
-export type SessionStartSource = "startup" | "resume" | "compact" | "clear";
-
-export type SessionEndSource = "exit" | "resume" | "stop" | "compact" | "clear";
-
-// Type guards for runtime validation
-export function isValidHookEvent(event: string): event is HookEvent {
-  return [
-    "PreToolUse",
-    "PostToolUse",
-    "UserPromptSubmit",
-    "Stop",
-    "SubagentStop",
-    "PermissionRequest",
-    "WorktreeCreate",
-    "WorktreeRemove",
-    "CwdChanged",
-    "SessionStart",
-    "SessionEnd",
-    "PreCompact",
-    "PostCompact",
-  ].includes(event);
-}
-
-export function isValidHookCommand(cmd: unknown): cmd is HookCommand {
-  if (
-    typeof cmd !== "object" ||
-    cmd === null ||
-    !("type" in cmd) ||
-    cmd.type !== "command" ||
-    !("command" in cmd) ||
-    typeof cmd.command !== "string" ||
-    cmd.command.length === 0
-  ) {
-    return false;
-  }
-
-  const hookCmd = cmd as Record<string, unknown>;
-
-  if ("async" in hookCmd && typeof hookCmd.async !== "boolean") {
-    return false;
-  }
-
-  if ("timeout" in hookCmd && typeof hookCmd.timeout !== "number") {
-    return false;
-  }
-
-  if ("pluginRoot" in hookCmd && typeof hookCmd.pluginRoot !== "string") {
-    return false;
-  }
-
-  return true;
-}
-
-export function isValidHookEventConfig(
-  config: unknown,
-): config is HookEventConfig {
-  if (typeof config !== "object" || config === null) return false;
-
-  const cfg = config as Record<string, unknown>;
-
-  // 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;
-}
-
-// JSON structure passed to hooks via stdin
-export interface HookJsonInput {
-  // Required fields for all events
-  session_id: string; // Format: "wave_session_{uuid}_{shortId}"
-  transcript_path: string; // Format: "~/.wave/sessions/session_{shortId}.json"
-  cwd: string; // Absolute path to current working directory
-  hook_event_name: HookEvent; // "PreToolUse" | "PostToolUse" | "UserPromptSubmit" | "Stop" | "SubagentStop" | "PermissionRequest" | "WorktreeCreate" | "CwdChanged" | "SessionStart"
-
-  // Optional fields based on event type
-  tool_name?: string; // Present for PreToolUse, PostToolUse, PermissionRequest
-  tool_input?: unknown; // Present for PreToolUse, PostToolUse, PermissionRequest
-  tool_response?: unknown; // Present for PostToolUse only
-  plan_file_path?: string; // Present when in plan mode
-  user_prompt?: string; // Present for UserPromptSubmit only
-  subagent_type?: string; // Present when hook is executed by a subagent
-  name?: string; // Present for WorktreeCreate events
-  worktree_path?: string; // Present for WorktreeRemove events
-  old_cwd?: string; // Present for CwdChanged events
-  new_cwd?: string; // Present for CwdChanged events
-  source?: SessionStartSource; // Present for SessionStart events
-  agent_type?: string; // Present for SessionStart events
-  end_source?: SessionEndSource; // Present for SessionEnd events
-  compact_instructions?: string; // Present for PreCompact events
-  compact_summary?: string; // Present for PostCompact events
-  background_tasks?: BackgroundTaskInfo[]; // Present for Stop events: running background tasks snapshot
-  session_crons?: SessionCronInfo[]; // Present for Stop events: session-scoped cron jobs snapshot
-  last_assistant_message?: string; // Present for Stop and SubagentStop events: text content of the last assistant message
-}
-
-// Describes one in-flight background task in the Stop hook input.
-// Aligned with Claude Code (v2.1.145+) background_tasks array element schema.
-// Conditional fields are populated based on `type`:
-//   - "shell":    `command` is set
-//   - "subagent": `agent_type` is set
-//   - "workflow": `name` is set
-export interface BackgroundTaskInfo {
-  id: string;
-  type: "shell" | "subagent" | "workflow";
-  status: string;
-  description: string; // Capped at 1000 chars with "… [+N chars]" marker
-  command?: string; // Present only for shell tasks (≤1000 chars)
-  agent_type?: string; // Present only for subagent tasks
-  name?: string; // Present only for workflow tasks
-}
-
-// Describes one session-scoped cron job in the Stop hook input.
-// Aligned with Claude Code (v2.1.145+) session_crons array element schema.
-export interface SessionCronInfo {
-  id: string;
-  schedule: string; // Cron expression
-  recurring: boolean;
-  prompt: string;
-}
-
-// Extended context interface for passing additional data to hook executor
-export interface ExtendedHookExecutionContext extends HookExecutionContext {
-  sessionId?: string; // Session identifier for JSON construction
-  transcriptPath?: string; // Path to session transcript file
-  cwd?: string; // Current working directory
-  toolInput?: unknown; // Tool input parameters (PreToolUse/PostToolUse)
-  toolResponse?: unknown; // Tool execution result (PostToolUse only)
-  env?: Record<string, string>; // Additional environment variables (from configuration)
-  userPrompt?: string; // User prompt text (UserPromptSubmit only)
-  subagentType?: string; // Subagent type when hook is executed by a subagent
-  worktreeName?: string; // Worktree name (WorktreeCreate only)
-  oldCwd?: string; // Previous working directory (CwdChanged only)
-  newCwd?: string; // New working directory (CwdChanged only)
-  source?: SessionStartSource; // Session start source (SessionStart only)
-  agentType?: string; // Agent type identifier (SessionStart only)
-  endSource?: SessionEndSource; // Session end source (SessionEnd only)
-  compactInstructions?: string; // Custom instructions for PreCompact
-  compactSummary?: string; // Summary text for PostCompact
-  backgroundTasks?: BackgroundTaskInfo[]; // Running background tasks snapshot (Stop only)
-  sessionCrons?: SessionCronInfo[]; // Session-scoped cron jobs snapshot (Stop only)
-  lastAssistantMessage?: string; // Text content of last assistant message (Stop and SubagentStop only)
-}
-
-// Environment variables injected into hook processes
-export interface HookEnvironment {
-  WAVE_PROJECT_DIR: string; // Absolute path to project root
-  [key: string]: string; // Inherit all parent process environment variables
-}

package/src/types/index.ts

@@ -1,41 +0,0 @@
-/**
- * Main type index - Barrel export for backward compatibility
- * Re-exports all domain types for legacy imports
- *
- * Legacy import pattern (continues to work):
- *   import { Message, Logger, McpTool } from 'wave-agent-sdk/types';
- *
- * New domain-specific import pattern:
- *   import { Message } from 'wave-agent-sdk/types/messaging';
- *   import { Logger } from 'wave-agent-sdk/types/core';
- *   import { McpTool } from 'wave-agent-sdk/types/mcp';
- */
-
-// Core foundational types
-export * from "./core.js";
-
-// Domain-specific types
-export * from "./messaging.js";
-export * from "./mcp.js";
-export * from "./processes.js";
-export * from "./commands.js";
-export * from "./skills.js";
-export * from "./config.js";
-export * from "./session.js";
-export * from "./environment.js";
-export * from "./configuration.js"; // New configuration management types
-export * from "./hooks.js";
-export * from "./permissions.js";
-export * from "./tools.js"; // Tool parameter types
-export * from "./fileSearch.js"; // File search types
-export * from "./lsp.js";
-export * from "./plugins.js";
-export * from "./marketplace.js";
-export * from "./memoryRule.js";
-export * from "./history.js";
-export * from "./tasks.js";
-export * from "./agent.js";
-export * from "./cron.js";
-export * from "./telemetry.js";
-export * from "./auth.js";
-export * from "./workflow.js";

package/src/types/lsp.ts

@@ -1,98 +0,0 @@
-/**
- * LSP (Language Server Protocol) configuration and communication types
- */
-
-export interface LspServerConfig {
-  command: string;
-  args?: string[];
-  extensionToLanguage: Record<string, string>;
-  transport?: "stdio" | "socket";
-  env?: Record<string, string>;
-  initializationOptions?: unknown;
-  settings?: unknown;
-  workspaceFolder?: string;
-  startupTimeout?: number;
-  shutdownTimeout?: number;
-  restartOnCrash?: boolean;
-  maxRestarts?: number;
-  /** Internal: plugin directory path when the server is registered by a plugin */
-  pluginRoot?: string;
-}
-
-export interface LspConfig {
-  [language: string]: LspServerConfig;
-}
-
-export interface LspPosition {
-  line: number;
-  character: number;
-}
-
-export interface LspRange {
-  start: LspPosition;
-  end: LspPosition;
-}
-
-export interface LspLocation {
-  uri: string;
-  range: LspRange;
-}
-
-export interface LspLocationLink {
-  originSelectionRange?: LspRange;
-  targetUri: string;
-  targetRange: LspRange;
-  targetSelectionRange?: LspRange;
-}
-
-export interface LspHover {
-  contents:
-    | string
-    | { kind: string; value: string }
-    | Array<string | { kind: string; value: string }>;
-  range?: LspRange;
-}
-
-export interface LspSymbolInformation {
-  name: string;
-  kind: number;
-  location: LspLocation;
-  containerName?: string;
-}
-
-export interface LspDocumentSymbol {
-  name: string;
-  detail?: string;
-  kind: number;
-  range: LspRange;
-  selectionRange: LspRange;
-  children?: LspDocumentSymbol[];
-}
-
-export interface LspCallHierarchyItem {
-  name: string;
-  kind: number;
-  detail?: string;
-  uri: string;
-  range: LspRange;
-  selectionRange: LspRange;
-}
-
-export interface LspCallHierarchyIncomingCall {
-  from: LspCallHierarchyItem;
-  fromRanges: LspRange[];
-}
-
-export interface LspCallHierarchyOutgoingCall {
-  to: LspCallHierarchyItem;
-  fromRanges: LspRange[];
-}
-
-export interface ILspManager {
-  execute(args: {
-    operation: string;
-    filePath: string;
-    line: number;
-    character: number;
-  }): Promise<{ success: boolean; content: string }>;
-}

package/src/types/marketplace.ts

@@ -1,71 +0,0 @@
-import { Scope } from "./configuration.js";
-
-export interface MarketplaceOwner {
-  name: string;
-  email?: string;
-}
-
-export interface MarketplacePluginEntry {
-  name: string;
-  source: string;
-  description: string;
-}
-
-export interface MarketplacePluginStatus extends MarketplacePluginEntry {
-  marketplace: string;
-  installed: boolean;
-  version?: string;
-  cachePath?: string;
-  projectPath?: string;
-  scope?: Scope;
-}
-
-export interface MarketplaceManifest {
-  name: string;
-  owner: MarketplaceOwner;
-  plugins: MarketplacePluginEntry[];
-}
-
-export type MarketplaceSource =
-  | {
-      source: "directory";
-      path: string;
-    }
-  | {
-      source: "github";
-      repo: string;
-      ref?: string;
-    }
-  | {
-      source: "git";
-      url: string;
-      ref?: string;
-    };
-
-export interface KnownMarketplace {
-  name: string;
-  source: MarketplaceSource;
-  isBuiltin?: boolean;
-  autoUpdate?: boolean;
-  lastUpdated?: string;
-  /** The scope where this marketplace was declared (user, project, local, or builtin) */
-  declaredScope?: "user" | "project" | "local" | "builtin";
-}
-
-export interface KnownMarketplacesRegistry {
-  builtinSeeded?: boolean;
-  marketplaces: KnownMarketplace[];
-}
-
-export interface InstalledPlugin {
-  name: string;
-  marketplace: string;
-  version: string;
-  cachePath: string;
-  scope?: Scope;
-  projectPath?: string;
-}
-
-export interface InstalledPluginsRegistry {
-  plugins: InstalledPlugin[];
-}

package/src/types/mcp.ts

@@ -1,43 +0,0 @@
-/**
- * Model Context Protocol types
- * Dependencies: None
- */
-
-export interface McpServerConfig {
-  type?: "stdio" | "sse" | "http";
-  command?: string;
-  args?: string[];
-  env?: Record<string, string>;
-  url?: string;
-  headers?: Record<string, string>;
-  /** Internal: plugin directory path when the server is registered by a plugin */
-  pluginRoot?: 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;
-  /** Pre-resolution URL with template variables preserved for safe display */
-  originalUrl?: string;
-  status:
-    | "disconnected"
-    | "connected"
-    | "connecting"
-    | "reconnecting"
-    | "error";
-  tools?: McpTool[];
-  toolCount?: number;
-  capabilities?: string[];
-  lastConnected?: number;
-  error?: string;
-}

package/src/types/memoryRule.ts

@@ -1,31 +0,0 @@
-/**
- * Metadata extracted from the YAML frontmatter of a memory rule file.
- */
-export interface MemoryRuleMetadata {
-  /**
-   * Glob patterns that determine when this rule is active.
-   * If undefined or empty, the rule is always active.
-   */
-  paths?: string[];
-  /**
-   * Optional priority override.
-   * Higher numbers take precedence if there are conflicting instructions.
-   */
-  priority?: number;
-}
-
-/**
- * Represents a single memory rule discovered from the filesystem.
- */
-export interface MemoryRule {
-  /** Unique identifier, typically the relative path from the rules root */
-  id: string;
-  /** The raw content of the markdown file (excluding frontmatter) */
-  content: string;
-  /** Metadata parsed from YAML frontmatter */
-  metadata: MemoryRuleMetadata;
-  /** Source of the rule (project-level or user-level) */
-  source: "project" | "user";
-  /** Absolute path to the file on disk */
-  filePath: string;
-}

package/src/types/messaging.ts

@@ -1,114 +0,0 @@
-/**
- * Message and communication block types
- * Dependencies: Core (Usage)
- */
-
-import type { Usage } from "./core.js";
-
-export enum MessageSource {
-  USER = "user",
-  HOOK = "hook",
-}
-
-export interface Message {
-  id: string; // Unique identifier for the message
-  role: "user" | "assistant";
-  blocks: MessageBlock[];
-  timestamp: string; // ISO 8601 timestamp, assigned at creation
-  usage?: Usage; // Usage data for this message's AI operation (assistant messages only)
-  additionalFields?: Record<string, unknown>; // Additional metadata from AI responses
-  isMeta?: boolean; // Whether the message is a meta message (hidden from UI)
-}
-
-export type MessageBlock =
-  | TextBlock
-  | ErrorBlock
-  | ToolBlock
-  | ImageBlock
-  | BangBlock
-  | CompactBlock
-  | ReasoningBlock
-  | FileHistoryBlock
-  | TaskNotificationBlock;
-
-export interface TextBlock {
-  type: "text";
-  content: string;
-  customCommandContent?: string;
-  source?: MessageSource;
-  stage?: "streaming" | "end";
-}
-
-export interface ErrorBlock {
-  type: "error";
-  content: string;
-}
-
-export interface ToolBlock {
-  type: "tool";
-  parameters?: string;
-  result?: string;
-  shortResult?: string; // Add shortResult field
-  startLineNumber?: number; // Optional starting line number
-  images?: Array<{
-    // Add image data support
-    data: string; // Base64 encoded image data
-    mediaType?: string; // Media type of the image
-  }>;
-  id?: string;
-  name?: string;
-  /**
-   * Tool execution stage:
-   * - 'start': Tool call initiated (from AI service streaming)
-   * - 'streaming': Tool parameters being streamed (from AI service)
-   * - 'running': Tool execution in progress (from AI manager)
-   * - 'end': Tool execution completed (from AI manager)
-   */
-  stage: "start" | "streaming" | "running" | "end";
-  success?: boolean;
-  error?: string | Error;
-  compactParams?: string; // Compact parameter display
-  parametersChunk?: string; // Incremental parameter updates for streaming
-  isManuallyBackgrounded?: boolean; // Whether the tool was manually backgrounded by the user
-  timestamp?: number; // Unix ms, set when tool result is finalized (stage="end")
-}
-
-export interface ImageBlock {
-  type: "image";
-  imageUrls?: string[];
-}
-
-export interface BangBlock {
-  type: "bang";
-  command: string;
-  output: string;
-  stage: "running" | "end";
-  exitCode: number | null;
-}
-
-export interface CompactBlock {
-  type: "compact";
-  content: string;
-}
-
-export interface ReasoningBlock {
-  type: "reasoning";
-  content: string;
-  stage?: "streaming" | "end";
-  startTime?: number; // Unix ms, set when the first reasoning content arrives
-  endTime?: number; // Unix ms, set when stage transitions to "end"
-}
-
-export interface FileHistoryBlock {
-  type: "file_history";
-  snapshots: import("./reversion.js").FileSnapshot[];
-}
-
-export interface TaskNotificationBlock {
-  type: "task_notification";
-  taskId: string;
-  taskType: "shell" | "agent" | "workflow";
-  status: "completed" | "failed" | "killed" | "aborted";
-  summary: string;
-  outputFile?: string;
-}