wave-agent-sdk 1.0.4 → 1.0.6

package/src/types/config.ts

@@ -1,43 +0,0 @@
-/**
- * Agent and service configuration types
- * Dependencies: None
- */
-
-import OpenAI from "openai";
-import { PermissionMode } from "./permissions.js";
-
-export interface GatewayConfig {
-  apiKey?: string;
-  baseURL?: string;
-  defaultHeaders?: Record<string, string>;
-  fetchOptions?: OpenAI["fetchOptions"];
-  fetch?: OpenAI["fetch"];
-  /** Session identifier, sent as the `x-session-id` request header for backend correlation. */
-  sessionId?: string;
-}
-
-export interface ModelCapabilities {
-  /** Whether the model supports image/vision input. Default: true. */
-  vision?: boolean;
-  /** Whether the model supports prompt caching (ephemeral cache_control markers). Default: false. */
-  promptCaching?: boolean;
-}
-
-export interface ModelConfig {
-  model?: string;
-  fastModel?: string;
-  maxTokens?: number;
-  permissionMode?: PermissionMode;
-  capabilities?: ModelCapabilities;
-  /** Generation params passed through to the API provider (temperature, thinking, etc.) */
-  options?: Record<string, unknown>;
-  /** Fast model generation params (resolved from models[fastModel].options) */
-  fastModelOptions?: Record<string, unknown>;
-  /**
-   * Fast-model-only disable-thinking params passed through verbatim
-   * (e.g. `{ thinking: { type: "disabled" } }`). Applied only in fast-model
-   * scenarios (webFetch content processing, `model: fastModel` subagents),
-   * never in the agent loop. `{}` clears the default.
-   */
-  disableThinkingOptions?: Record<string, unknown>;
-}

package/src/types/configuration.ts

@@ -1,168 +0,0 @@
-/**
- * Configuration Management Types
- *
- * Types for centralized configuration loading and validation services.
- * These support the refactored configuration architecture that separates
- * configuration management from hook execution.
- */
-
-import type { HookEvent, HookEventConfig } from "./hooks.js";
-import type { PermissionMode } from "./permissions.js";
-import type { ModelConfig } from "./config.js";
-import type { MarketplaceSource } from "./marketplace.js";
-import type { TelemetryConfig } from "./telemetry.js";
-
-export type Scope = "user" | "project" | "local";
-
-export interface MarketplaceConfig {
-  source: MarketplaceSource;
-  autoUpdate?: boolean;
-}
-
-/**
- * Root configuration structure for all Wave Agent settings including hooks and environment variables
- */
-export interface WaveConfiguration {
-  hooks?: Partial<Record<HookEvent, HookEventConfig[]>>;
-  env?: Record<string, string>; // Environment variables key-value pairs
-  /** New field for persistent permissions */
-  permissions?: {
-    allow?: string[];
-    deny?: string[];
-    permissionMode?: PermissionMode; // Default permission mode for restricted tools
-    /**
-     * List of directories that are considered part of the Safe Zone.
-     * File operations within these directories can be auto-accepted.
-     */
-    additionalDirectories?: string[];
-  };
-  /** New field for scoped plugin management */
-  enabledPlugins?: Record<string, boolean>;
-  /** Preferred language for agent communication */
-  language?: string;
-  /** Whether auto-memory is enabled */
-  autoMemoryEnabled?: boolean;
-  /** Frequency of auto-memory extraction turns */
-  autoMemoryFrequency?: number;
-  /** Persisted model selection (from /model command) */
-  model?: string;
-  /** Model-specific configuration overrides */
-  models?: Record<string, Partial<ModelConfig>>;
-  /** Scoped marketplace declarations */
-  marketplaces?: Record<string, MarketplaceConfig>;
-  /** OpenTelemetry monitoring configuration */
-  monitoring?: {
-    telemetry?: Partial<TelemetryConfig>;
-  };
-  /** Worktree configuration */
-  worktree?: {
-    /** Base ref for new worktrees: "fresh" (origin/<default-branch>, default) | "head" (local HEAD) */
-    baseRef?: "fresh" | "head";
-  };
-}
-
-/**
- * Legacy alias for backward compatibility - will be deprecated
- */
-export interface HookConfiguration extends WaveConfiguration {
-  hooks: Partial<Record<HookEvent, HookEventConfig[]>>;
-}
-
-/**
- * Partial hook configuration for loading/merging scenarios
- */
-export type PartialHookConfiguration = Partial<
-  Record<HookEvent, HookEventConfig[]>
->;
-
-/**
- * Direct hook configuration record (for test convenience)
- */
-export type HookConfigurationRecord = Record<HookEvent, HookEventConfig[]>;
-
-/**
- * Result of configuration loading operations with detailed status information
- */
-export interface ConfigurationLoadResult {
-  /** The loaded configuration, or null if loading failed */
-  configuration: WaveConfiguration | null;
-  /** Whether the loading operation was successful */
-  success: boolean;
-  /** Error message if loading failed */
-  error?: string;
-  /** Path of the successfully loaded file */
-  sourcePath?: string;
-  /** Non-critical warnings during loading */
-  warnings: string[];
-}
-
-/**
- * Result of configuration validation operations
- */
-export interface ValidationResult {
-  /** Whether the configuration is valid */
-  isValid: boolean;
-  /** Critical errors that prevent configuration use */
-  errors: string[];
-  /** Non-critical warnings about the configuration */
-  warnings: string[];
-}
-
-/**
- * Configuration file paths organized by category
- */
-export interface ConfigurationPaths {
-  /** User-specific configuration file paths in priority order */
-  userPaths: string[];
-  /** Project-specific configuration file paths in priority order */
-  projectPaths: string[];
-  /** Builtin configuration file paths */
-  builtinPaths: string[];
-  /** All configuration paths combined */
-  allPaths: string[];
-  /** Only the paths that actually exist on the filesystem */
-  existingPaths: string[];
-}
-
-/**
- * Options for configuring the ConfigurationService
- */
-export interface ConfigurationServiceOptions {
-  /** Working directory for resolving project configurations */
-  workdir: string;
-  /** Optional logger for configuration operations */
-  logger?: Logger;
-  /** Whether to enable validation during loading (default: true) */
-  enableValidation?: boolean;
-}
-
-/**
- * Minimal logger interface for configuration services
- */
-interface Logger {
-  error: (...args: unknown[]) => void;
-  warn: (...args: unknown[]) => void;
-  info: (...args: unknown[]) => void;
-  debug: (...args: unknown[]) => void;
-}
-
-export interface RemoteSettingsResponse {
-  uuid: string;
-  checksum: string;
-  settings: WaveConfiguration;
-}
-
-export interface RemoteSettingsCache {
-  uuid: string;
-  checksum: string;
-  settings: WaveConfiguration;
-  fetchedAt: string;
-}
-
-export interface RemoteSettingsFetchResult {
-  success: boolean;
-  settings?: WaveConfiguration | null;
-  checksum?: string;
-  error?: string;
-  notConfigured?: boolean;
-}

package/src/types/core.ts

@@ -1,105 +0,0 @@
-/**
- * Core foundational types used across multiple domains
- * Dependencies: None (foundation layer)
- */
-
-import type { CompletionUsage } from "openai/resources";
-
-/**
- * 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;
-}
-
-/**
- * Usage statistics for AI operations
- * Extends OpenAI's Usage format with additional tracking fields
- */
-export interface Usage {
-  prompt_tokens: number; // Tokens used in prompts
-  completion_tokens: number; // Tokens generated in completions
-  total_tokens: number; // Sum of prompt + completion tokens
-  model?: string; // Model used for the operation (e.g., "gpt-4", "gpt-3.5-turbo")
-  operation_type?: "agent" | "compact"; // Type of operation that generated usage
-
-  // Cache-related tokens (Claude top-level + OpenAI prompt_tokens_details)
-  cache_read_input_tokens?: number; // Tokens read from cache (Claude) or cached_tokens (OpenAI prompt_tokens_details)
-  cache_creation_input_tokens?: number; // Tokens used to create cache entries
-  cache_creation?: {
-    ephemeral_5m_input_tokens: number; // Tokens cached for 5 minutes
-    ephemeral_1h_input_tokens: number; // Tokens cached for 1 hour
-  };
-}
-
-/**
- * Enhanced usage metrics including Claude cache information
- * Backward compatible with standard OpenAI CompletionUsage
- */
-export interface ClaudeUsage extends CompletionUsage {
-  // Standard OpenAI usage fields (inherited)
-  prompt_tokens: number;
-  completion_tokens: number;
-  total_tokens: number;
-
-  // Claude-specific cache extensions
-  /**
-   * Number of tokens read from existing cache
-   * Indicates cost savings from cache hits
-   */
-  cache_read_input_tokens?: number;
-
-  /**
-   * Number of tokens used to create new cache entries
-   * Investment in future cache hits
-   */
-  cache_creation_input_tokens?: number;
-
-  /**
-   * Detailed breakdown of cache creation by duration
-   */
-  cache_creation?: {
-    /** Tokens cached for 5 minute duration */
-    ephemeral_5m_input_tokens: number;
-    /** Tokens cached for 1 hour duration */
-    ephemeral_1h_input_tokens: number;
-  };
-}
-
-/**
- * Represents a diff change for tool parameter-based diff display
- * Contains the old content and new content for comparison
- */
-export interface Change {
-  /** The original content (empty string for additions) */
-  oldContent: string;
-  /** The new content (empty string for deletions) */
-  newContent: string;
-  /** Optional starting line number in the original file */
-  startLineNumber?: number;
-}
-
-export class ConfigurationError extends Error {
-  constructor(
-    message: string,
-    public readonly field: string,
-    public readonly provided?: unknown,
-  ) {
-    super(message);
-    this.name = "ConfigurationError";
-  }
-}
-
-// Standard error messages
-export const CONFIG_ERRORS = {
-  MISSING_MODEL:
-    "Agent configuration requires model. Provide via constructor or WAVE_MODEL environment variable.",
-  MISSING_FAST_MODEL:
-    "Agent configuration requires fastModel. Provide via constructor or WAVE_FAST_MODEL environment variable.",
-  INVALID_WAVE_MAX_INPUT_TOKENS: "Token limit must be a positive integer.",
-  EMPTY_BASE_URL: "Base URL cannot be empty string.",
-} as const;

package/src/types/cron.ts

@@ -1,13 +0,0 @@
-export interface CronJob {
-  id: string;
-  cron: string;
-  prompt: string;
-  recurring: boolean;
-  createdAt: number;
-  nextRun: number;
-  periodMs: number;
-  /** When true, the job is persisted to .wave/scheduled_tasks.json. */
-  durable?: boolean;
-  /** Timestamp of the last time a durable recurring job fired. */
-  lastFiredAt?: number;
-}

package/src/types/environment.ts

@@ -1,106 +0,0 @@
-import type { Scope } from "./configuration.js";
-
-/**
- * Environment Variable System Types
- *
- * Provides comprehensive TypeScript types for environment variable validation,
- * merging, and conflict resolution in the Wave Agent SDK.
- */
-
-/**
- * Result of environment variable validation
- */
-export interface EnvironmentValidationResult {
-  isValid: boolean;
-  errors: string[];
-  warnings: string[];
-}
-
-/**
- * Context containing merged environment variables and conflict information
- */
-export interface MergedEnvironmentContext {
-  userVars: Record<string, string>;
-  projectVars: Record<string, string>;
-  mergedVars: Record<string, string>;
-  conflicts: Array<{
-    key: string;
-    userValue: string;
-    projectValue: string;
-    resolvedValue: string;
-  }>;
-}
-
-/**
- * Type guard to check if a value is a valid environment variables object
- */
-export function isValidEnvironmentVars(
-  env: unknown,
-): env is Record<string, string> {
-  if (typeof env !== "object" || env === null) {
-    return false;
-  }
-
-  // Check if all keys and values are strings
-  for (const [key, value] of Object.entries(env)) {
-    if (typeof key !== "string" || typeof value !== "string") {
-      return false;
-    }
-  }
-
-  return true;
-}
-
-/**
- * Configuration options for environment merging
- */
-export interface EnvironmentMergeOptions {
-  /** Whether to include warnings for conflicting variables */
-  includeConflictWarnings?: boolean;
-  /** Whether to validate variable names for common patterns */
-  validateVariableNames?: boolean;
-}
-
-/**
- * Result of environment variable processing operations
- */
-export interface EnvironmentProcessResult {
-  /** The processed environment variables */
-  processedVars: Record<string, string>;
-  /** Any conflicts that occurred during processing */
-  conflicts: EnvironmentConflict[];
-  /** Non-critical warnings during processing */
-  warnings: string[];
-  /** Whether the variables were successfully applied to process.env */
-  applied: boolean;
-}
-
-/**
- * Enhanced environment merge context with conflict details
- */
-export interface EnvironmentMergeContext {
-  /** User-provided environment variables */
-  userVars: Record<string, string>;
-  /** Project-provided environment variables */
-  projectVars: Record<string, string>;
-  /** Final merged environment variables */
-  mergedVars: Record<string, string>;
-  /** Detailed conflict information */
-  conflicts: EnvironmentConflict[];
-}
-
-/**
- * Detailed information about an environment variable conflict
- */
-export interface EnvironmentConflict {
-  /** The environment variable key */
-  key: string;
-  /** Value from user configuration */
-  userValue: string;
-  /** Value from project configuration */
-  projectValue: string;
-  /** Final resolved value (which source won) */
-  resolvedValue: string;
-  /** Which source provided the final value */
-  source: Scope;
-}

package/src/types/fileSearch.ts

@@ -1,4 +0,0 @@
-export interface FileItem {
-  path: string;
-  type: "file" | "directory";
-}

package/src/types/history.ts

@@ -1,7 +0,0 @@
-export interface PromptEntry {
-  prompt: string;
-  timestamp: number;
-  sessionId?: string;
-  workdir?: string;
-  longTextMap?: Record<string, string>;
-}