wave-agent-sdk 1.0.4 → 1.0.6

package/src/types/permissions.ts

@@ -1,80 +0,0 @@
-/**
- * Permission system types for Wave Agent SDK
- * Dependencies: None
- */
-
-import {
-  AskUserQuestion,
-  AskUserQuestionInput,
-  AskUserQuestionOption,
-} from "./tools.js";
-import {
-  EDIT_TOOL_NAME,
-  BASH_TOOL_NAME,
-  WRITE_TOOL_NAME,
-  ENTER_PLAN_MODE_TOOL_NAME,
-  EXIT_PLAN_MODE_TOOL_NAME,
-  ASK_USER_QUESTION_TOOL_NAME,
-} from "../constants/tools.js";
-
-/** Permission mode configuration */
-export type PermissionMode =
-  | "default"
-  | "bypassPermissions"
-  | "acceptEdits"
-  | "plan"
-  | "dontAsk";
-
-/** Result of a permission check */
-export interface PermissionDecision {
-  /** Whether to allow or deny the operation */
-  behavior: "allow" | "deny";
-  /** Optional message explaining the decision (required for deny) */
-  message?: string;
-  /** Signal to change the session's permission mode */
-  newPermissionMode?: PermissionMode;
-  /** Signal to persist a new allowed rule */
-  newPermissionRule?: string;
-}
-
-/** Callback function for custom permission logic */
-export type PermissionCallback = (
-  context: ToolPermissionContext,
-) => Promise<PermissionDecision>;
-
-/** Internal context passed to PermissionManager */
-export interface ToolPermissionContext {
-  /** Name of the tool being executed */
-  toolName: string;
-  /** Current permission mode */
-  permissionMode: PermissionMode;
-  /** Custom permission callback if provided */
-  canUseToolCallback?: PermissionCallback;
-  /** Tool input parameters for better context */
-  toolInput?: Record<string, unknown>;
-  /** Suggested prefix for bash commands */
-  suggestedPrefix?: string;
-  /** Whether to hide the persistent permission option (e.g., "Don't ask again") in the UI */
-  hidePersistentOption?: boolean;
-  /** The ID of the tool call that triggered this permission request */
-  toolCallId?: string;
-  /** The content of the plan being exited from */
-  planContent?: string;
-}
-
-/** List of tools that require permission checks in default mode */
-export const RESTRICTED_TOOLS = [
-  EDIT_TOOL_NAME,
-  BASH_TOOL_NAME,
-  WRITE_TOOL_NAME,
-  ENTER_PLAN_MODE_TOOL_NAME,
-  EXIT_PLAN_MODE_TOOL_NAME,
-  ASK_USER_QUESTION_TOOL_NAME,
-] as const;
-
-/** Type for restricted tool names */
-export type RestrictedTool = (typeof RESTRICTED_TOOLS)[number];
-
-export const OPERATION_CANCELLED_BY_USER = "Operation cancelled by user";
-
-export type { AskUserQuestion, AskUserQuestionInput, AskUserQuestionOption };

package/src/types/plugins.ts

@@ -1,39 +0,0 @@
-import { CustomSlashCommand } from "./commands.js";
-import { Skill } from "./skills.js";
-import { LspConfig } from "./lsp.js";
-import { McpConfig } from "./mcp.js";
-import { PartialHookConfiguration } from "./configuration.js";
-import { SubagentConfiguration } from "../utils/subagentParser.js";
-
-/**
- * Plugin manifest structure (.wave-plugin/plugin.json)
- */
-export interface PluginManifest {
-  name: string;
-  description: string;
-  version: string;
-  author?: {
-    name: string;
-  };
-}
-
-/**
- * Plugin configuration in AgentOptions or wave.settings.json
- */
-export interface PluginConfig {
-  type: "local";
-  path: string;
-}
-
-/**
- * Represents a loaded plugin in the system
- */
-export interface Plugin extends PluginManifest {
-  path: string;
-  commands: CustomSlashCommand[];
-  skills: Skill[];
-  agents: SubagentConfiguration[];
-  lspConfig?: LspConfig;
-  mcpConfig?: McpConfig;
-  hooksConfig?: PartialHookConfiguration;
-}

package/src/types/processes.ts

@@ -1,99 +0,0 @@
-/**
- * Background process and shell management types
- * Dependencies: None
- */
-
-import type { ChildProcess } from "child_process";
-
-export type BackgroundTaskStatus =
-  | "running"
-  | "completed"
-  | "failed"
-  | "killed";
-export type BackgroundTaskType = "shell" | "subagent" | "workflow";
-
-export interface BackgroundTaskBase {
-  id: string;
-  type: BackgroundTaskType;
-  status: BackgroundTaskStatus;
-  startTime: number;
-  endTime?: number;
-  command?: string; // for shell
-  description?: string; // for subagent
-  stdout: string;
-  stderr: string;
-  exitCode?: number;
-  runtime?: number;
-  /**
-   * Optional callback to be executed when the task is stopped.
-   * This allows tasks to define their own cleanup/abortion logic.
-   */
-  onStop?: () => void | Promise<void>;
-  /**
-   * Optional subagent ID associated with this task.
-   * Used for cleanup when the task is stopped.
-   */
-  subagentId?: string;
-  /**
-   * Optional path to the real-time output log file.
-   */
-  outputPath?: string;
-}
-
-export interface BackgroundShell extends BackgroundTaskBase {
-  type: "shell";
-  process: ChildProcess;
-}
-
-export interface BackgroundSubagent extends BackgroundTaskBase {
-  type: "subagent";
-}
-
-export interface BackgroundWorkflow extends BackgroundTaskBase {
-  type: "workflow";
-  runId: string;
-}
-
-export type BackgroundTask =
-  | BackgroundShell
-  | BackgroundSubagent
-  | BackgroundWorkflow;
-
-/**
- * Serializable summary of a BackgroundTask, used for notifications where the
- * full stdout/stderr and non-serializable process/onStop fields must be
- * stripped to control payload size. Output is fetched on demand via
- * getBackgroundTaskOutput.
- */
-export interface BackgroundTaskSummary {
-  id: string;
-  type: BackgroundTaskType;
-  status: BackgroundTaskStatus;
-  startTime: number;
-  endTime?: number;
-  command?: string;
-  description?: string;
-  exitCode?: number;
-  runtime?: number;
-  outputPath?: string;
-}
-
-/** Output snapshot returned by getBackgroundTaskOutput. */
-export interface BackgroundTaskOutput {
-  stdout: string;
-  stderr: string;
-  status: BackgroundTaskStatus;
-  outputPath?: string;
-  type: BackgroundTaskType;
-  exitCode?: number;
-}
-
-export interface ForegroundTask {
-  id: string;
-  backgroundHandler: () => Promise<void>;
-}
-
-export interface IForegroundTaskManager {
-  registerForegroundTask(task: ForegroundTask): void;
-  unregisterForegroundTask(id: string): void;
-}

package/src/types/reversion.ts

@@ -1,29 +0,0 @@
-/**
- * Represents the state of a file before an agent operation.
- */
-export interface FileSnapshot {
-  /** The ID of the message/turn this snapshot is associated with. */
-  messageId: string;
-  /** Absolute path to the file. */
-  filePath: string;
-  /** Path to the stored snapshot file. */
-  snapshotPath?: string;
-  /** When the snapshot was taken. */
-  timestamp: number;
-  /** The operation that triggered this snapshot. */
-  operation: "create" | "modify" | "delete";
-}
-
-/**
- * A point in the conversation history that can be reverted to.
- */
-export interface Checkpoint {
-  /** The index of the user message in the history. */
-  index: number;
-  /** The unique ID of the user message. */
-  messageId: string;
-  /** A short snippet of the message content for the UI. */
-  preview: string;
-  /** When the message was sent. */
-  timestamp: number;
-}

package/src/types/session.ts

@@ -1,12 +0,0 @@
-/**
- * Session management types for project-based organization with JSONL format
- * Dependencies: Core messaging types
- *
- * SIMPLIFIED: Removed unused interfaces to focus on core functionality
- */
-
-// Session filename structure for simple filename-based metadata
-export interface SessionFilename {
-  sessionId: string;
-  sessionType: "main" | "subagent";
-}

package/src/types/skills.ts

@@ -1,108 +0,0 @@
-/**
- * Skill system types and constants
- * Dependencies: Core (Logger)
- */
-
-export interface SkillMetadata {
-  name: string;
-  description: string;
-  type: "personal" | "project" | "builtin";
-  skillPath: string;
-  allowedTools?: string[];
-  context?: "fork";
-  agent?: string;
-  model?: string;
-  disableModelInvocation?: boolean;
-  userInvocable?: boolean;
-  pluginName?: string;
-  pluginRoot?: string;
-}
-
-export interface Skill extends SkillMetadata {
-  content: string;
-  frontmatter: SkillFrontmatter;
-  isValid: boolean;
-  errors: string[];
-}
-
-export interface SkillFrontmatter {
-  name: string;
-  description: string;
-  "allowed-tools"?: string | string[];
-  context?: "fork";
-  agent?: string;
-  model?: string;
-  "disable-model-invocation"?: boolean | string;
-  "user-invocable"?: boolean | string;
-  [key: string]: unknown;
-}
-
-export interface SkillCollection {
-  type: "personal" | "project" | "builtin";
-  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>;
-  builtinSkills: Map<string, SkillMetadata>;
-  errors: SkillError[];
-}
-
-export interface SkillInvocationContext {
-  skillName: string;
-}
-
-export interface SkillToolArgs {
-  skill_name: string;
-  args?: string;
-}
-
-export interface SkillManagerOptions {
-  personalSkillsPath?: string;
-  personalClaudeSkillsPath?: string;
-  personalAgentsSkillsPath?: string;
-  scanTimeout?: number;
-  workdir?: string;
-  watch?: boolean;
-}
-
-export interface ParsedSkillFile {
-  frontmatter: SkillFrontmatter;
-  content: string;
-  skillMetadata: SkillMetadata;
-  validationErrors: string[];
-  isValid: boolean;
-}
-
-export interface SkillParseOptions {
-  validateMetadata?: boolean;
-  basePath?: string;
-}
-
-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,
-} as const;

package/src/types/tasks.ts

@@ -1,13 +0,0 @@
-export type TaskStatus = "pending" | "in_progress" | "completed" | "deleted";
-
-export interface Task {
-  id: string;
-  subject: string;
-  description: string;
-  status: TaskStatus;
-  activeForm?: string;
-  owner?: string;
-  blocks: string[];
-  blockedBy: string[];
-  metadata: Record<string, unknown>;
-}

package/src/types/telemetry.ts

@@ -1,98 +0,0 @@
-/**
- * OpenTelemetry Integration Types
- *
- * Type definitions for Wave's OpenTelemetry instrumentation module.
- */
-
-/** Exporter target for telemetry signals */
-export type ExporterTarget = "jsonl" | "otlp";
-
-/** OTLP transport protocol */
-export type OTLPProtocol = "http/protobuf" | "http/json" | "grpc";
-
-/** Resolved telemetry configuration */
-export interface TelemetryConfig {
-  /** Master switch for telemetry */
-  enabled: boolean;
-  /** Trace export target */
-  tracesExporter?: ExporterTarget;
-  /** Log export target */
-  logsExporter?: ExporterTarget;
-  /** OTLP collector URL */
-  endpoint?: string;
-  /** OTLP transport protocol */
-  protocol?: OTLPProtocol;
-  /** Auth/custom headers */
-  headers?: Record<string, string>;
-  /** Include prompt text in events */
-  logUserPrompts: boolean;
-  /** Include tool I/O in events */
-  logToolContent: boolean;
-  /** Max flush time on exit (default 2000) */
-  shutdownTimeoutMs: number;
-  /** Stale span eviction TTL (default 1800000 = 30min) */
-  spanTtlMs: number;
-}
-
-/** Metadata for LLM request spans */
-export interface LLMRequestMetadata {
-  /** Model identifier */
-  model: string;
-  /** Scope context */
-  context?: "interaction" | "standalone";
-  /** Prompt tokens consumed */
-  inputTokens?: number;
-  /** Completion tokens generated */
-  outputTokens?: number;
-  /** Cache hit tokens */
-  cacheReadTokens?: number;
-  /** Cache write tokens */
-  cacheCreationTokens?: number;
-  /** Time to first token (ms) */
-  ttftMs?: number;
-  /** Time to last token / total duration (ms) */
-  ttltMs?: number;
-  /** Request succeeded */
-  success: boolean;
-  /** Error message if failed */
-  error?: string;
-  /** Response included tool calls */
-  hasToolCall?: boolean;
-  /** Model text output (recorded when logToolContent is true) */
-  modelOutput?: string;
-}
-
-/** Input context for an LLM request span (content capture gated by logToolContent) */
-export interface LLMRequestInput {
-  /** Scope context */
-  context?: "interaction" | "standalone";
-  /** System prompt string (when available) */
-  systemPrompt?: string;
-  /** Messages array sent to the API */
-  inputMessages?: unknown[];
-  /** Tool schemas JSON string */
-  toolsSchema?: string;
-}
-
-/** Metadata for tool execution spans */
-export interface ToolMetadata {
-  /** Tool execution succeeded */
-  success: boolean;
-  /** Error message if failed */
-  error?: string;
-  /** Execution time (ms) */
-  durationMs: number;
-  /** Tool output content (recorded when logToolContent is true) */
-  output?: string;
-}
-
-/** Event names for OTel structured logging */
-export type OTelEventName =
-  | "session_start"
-  | "session_end"
-  | "user_prompt"
-  | "tool_decision"
-  | "compaction"
-  | "error"
-  | "system_prompt"
-  | "tool_schema";

package/src/types/tools.ts

@@ -1,44 +0,0 @@
-/**
- * Tool parameter types for edit and write operations
- */
-
-/**
- * Input types for AskUserQuestion tool
- */
-export interface AskUserQuestionOption {
-  label: string;
-  description?: string;
-}
-
-export interface AskUserQuestion {
-  question: string;
-  header: string;
-  options: AskUserQuestionOption[];
-  multiSelect?: boolean;
-}
-
-export interface AskUserQuestionInput {
-  questions: AskUserQuestion[];
-  answers?: Record<string, string>;
-  metadata?: {
-    source?: string;
-  };
-}
-
-/**
- * Parameters for the Write tool
- */
-export interface WriteToolParameters {
-  file_path: string;
-  content: string;
-}
-
-/**
- * Parameters for the Edit tool
- */
-export interface EditToolParameters {
-  file_path: string;
-  old_string: string;
-  new_string: string;
-  replace_all?: boolean;
-}

package/src/types/workflow.ts

@@ -1,6 +0,0 @@
-export type {
-  WorkflowRun,
-  WorkflowMeta,
-  WorkflowPhaseState,
-  SerializableWorkflowRun,
-} from "../workflow/types.js";

package/src/utils/abortUtils.ts

@@ -1,118 +0,0 @@
-/**
- * Utilities for safe AbortSignal listener management to prevent memory leaks
- */
-
-/**
- * Safely adds a one-time abort listener that automatically cleans up after firing
- * @param signal - The AbortSignal to listen to
- * @param callback - The function to call when aborted
- * @returns A cleanup function to manually remove the listener if needed
- */
-export function addOnceAbortListener(
-  signal: AbortSignal,
-  callback: () => void,
-): () => void {
-  if (signal.aborted) {
-    // Signal already aborted, call immediately
-    callback();
-    return () => {}; // No cleanup needed
-  }
-
-  const handler = () => {
-    callback();
-  };
-
-  // Use { once: true } to automatically remove listener after first call
-  signal.addEventListener("abort", handler, { once: true });
-
-  // Return cleanup function for manual removal if needed
-  return () => {
-    signal.removeEventListener("abort", handler);
-  };
-}
-
-/**
- * Creates a Promise that rejects when the AbortSignal is aborted
- * Uses once-only listener to prevent accumulation
- * @param signal - The AbortSignal to listen to
- * @param errorMessage - Optional custom error message
- * @returns Promise that rejects on abort
- */
-export function createAbortPromise(
-  signal: AbortSignal,
-  errorMessage: string = "Operation was aborted",
-): Promise<never> {
-  return new Promise<never>((_, reject) => {
-    if (signal.aborted) {
-      reject(new Error(errorMessage));
-      return;
-    }
-
-    // Use once-only listener to prevent accumulation
-    signal.addEventListener(
-      "abort",
-      () => {
-        reject(new Error(errorMessage));
-      },
-      { once: true },
-    );
-  });
-}
-
-/**
- * Wrapper that manages abort signal listeners with automatic cleanup
- * @param signal - The AbortSignal to manage
- * @param operation - Function that sets up listeners and returns cleanup
- * @returns Promise that resolves with the operation result
- */
-export async function withAbortCleanup<T>(
-  signal: AbortSignal,
-  operation: (signal: AbortSignal) => Promise<T>,
-): Promise<T> {
-  // Track all cleanup functions
-  const cleanups: (() => void)[] = [];
-
-  try {
-    const result = await operation(signal);
-    return result;
-  } finally {
-    // Clean up all listeners
-    cleanups.forEach((cleanup) => cleanup());
-  }
-}
-
-/**
- * Consolidates multiple abort listeners into a single listener
- * Useful when multiple handlers need to respond to the same abort signal
- * @param signal - The AbortSignal to listen to
- * @param callbacks - Array of functions to call when aborted
- * @returns Cleanup function to remove the consolidated listener
- */
-export function addConsolidatedAbortListener(
-  signal: AbortSignal,
-  callbacks: (() => void)[],
-): () => void {
-  if (signal.aborted) {
-    // Signal already aborted, call all callbacks immediately
-    callbacks.forEach((cb) => cb());
-    return () => {}; // No cleanup needed
-  }
-
-  const handler = () => {
-    callbacks.forEach((cb) => {
-      try {
-        cb();
-      } catch (error) {
-        console.error("Error in abort callback:", error);
-      }
-    });
-  };
-
-  // Use { once: true } to automatically remove listener after first call
-  signal.addEventListener("abort", handler, { once: true });
-
-  // Return cleanup function for manual removal if needed
-  return () => {
-    signal.removeEventListener("abort", handler);
-  };
-}