wave-agent-sdk 1.0.6 → 1.0.7

package/dist/agent.d.ts

@@ -413,6 +413,17 @@ export declare class Agent {
      * @returns The subagent instance or null if not found
      */
     getSubagentInstance(subagentId: string): import("./managers/subagentManager.js").SubagentInstance | null;
+    /**
+     * Get all subagent configurations visible in this session (built-in,
+     * user, project, and plugin agents).
+     * @returns The list of subagent configurations
+     */
+    getSubagentConfigurations(): import("./utils/subagentParser.js").SubagentConfiguration[];
+    /**
+     * Get currently active subagent instances (status active/initializing).
+     * @returns The list of active subagent instances
+     */
+    getActiveSubagentInstances(): import("./managers/subagentManager.js").SubagentInstance[];
     /**
      * Get the current task list ID
      */

package/dist/agent.js

@@ -973,6 +973,21 @@ export class Agent {
     getSubagentInstance(subagentId) {
         return this.subagentManager.getInstance(subagentId);
     }
+    /**
+     * Get all subagent configurations visible in this session (built-in,
+     * user, project, and plugin agents).
+     * @returns The list of subagent configurations
+     */
+    getSubagentConfigurations() {
+        return this.subagentManager.getConfigurations();
+    }
+    /**
+     * Get currently active subagent instances (status active/initializing).
+     * @returns The list of active subagent instances
+     */
+    getActiveSubagentInstances() {
+        return this.subagentManager.getActiveInstances();
+    }
     /**
      * Get the current task list ID
      */

package/dist/index.d.ts

@@ -23,7 +23,9 @@ export * from "./utils/gitUtils.js";
 export * from "./utils/nameGenerator.js";
 export * from "./utils/worktreeSession.js";
 export * from "./utils/worktreeUtils.js";
-export { loadMergedWaveConfig } from "./services/configurationService.js";
+export { loadMergedWaveConfig, loadUserConfigEnv, } from "./services/configurationService.js";
 export * from "./types/index.js";
+export type { SubagentConfiguration } from "./utils/subagentParser.js";
+export type { SubagentInstance } from "./managers/subagentManager.js";
 export * from "./tools/buildTool.js";
 export type { ToolPlugin, ToolResult, ToolContext } from "./tools/types.js";

package/dist/index.js

@@ -27,7 +27,7 @@ export * from "./utils/gitUtils.js";
 export * from "./utils/nameGenerator.js";
 export * from "./utils/worktreeSession.js";
 export * from "./utils/worktreeUtils.js";
-export { loadMergedWaveConfig } from "./services/configurationService.js";
+export { loadMergedWaveConfig, loadUserConfigEnv, } from "./services/configurationService.js";
 export * from "./types/index.js";
 // Export tool building utilities
 export * from "./tools/buildTool.js";

package/dist/managers/aiManager.js

@@ -1383,9 +1383,6 @@ ${question}`;
                             ...(result.usage.cache_creation_input_tokens !== undefined && {
                                 cache_creation_input_tokens: result.usage.cache_creation_input_tokens,
                             }),
-                            ...(result.usage.cache_creation && {
-                                cache_creation: result.usage.cache_creation,
-                            }),
                         };
                     }
                     // Set usage on the assistant message if available

package/dist/managers/messageManager.d.ts

@@ -26,7 +26,7 @@ export interface MessageManagerCallbacks {
     onCompactionStateChange?: (isCompacting: boolean) => void;
     onAddBangMessage?: (command: string, messageId: string) => void;
     onUpdateBangMessage?: (command: string, output: string, messageId: string) => void;
-    onCompleteBangMessage?: (command: string, exitCode: number, messageId: string) => void;
+    onCompleteBangMessage?: (command: string, exitCode: number, messageId: string, output?: string) => void;
     onInfoBlockAdded?: (content: string) => void;
     onShowRewind?: () => void;
     onFileHistoryBlockAdded?: (snapshots: import("../types/reversion.js").FileSnapshot[]) => void;

package/dist/managers/messageManager.js

@@ -446,7 +446,7 @@ export class MessageManager {
         });
         this.setMessages(updatedMessages);
         const messageId = this.findBangMessageId(command) ?? "";
-        this.callbacks.onCompleteBangMessage?.(command, exitCode, messageId);
+        this.callbacks.onCompleteBangMessage?.(command, exitCode, messageId, output?.trim());
     }
     /**
      * Find the message ID of the most recent message containing a bang block

package/dist/services/aiService.d.ts

@@ -1,7 +1,6 @@
 import { ChatCompletionMessageToolCall } from "openai/resources";
 import { ChatCompletionMessageParam, ChatCompletionFunctionTool } from "openai/resources.js";
-import type { GatewayConfig, ModelConfig } from "../types/index.js";
-import { type ClaudeUsage } from "../utils/cacheControlUtils.js";
+import type { GatewayConfig, ModelConfig, Usage } from "../types/index.js";
 import { type SystemPromptBlock } from "../prompts/index.js";
 /**
  * Resets the rate limiter state. Primarily used for testing.
@@ -40,7 +39,7 @@ export interface CallAgentResult {
     content?: string;
     tool_calls?: ChatCompletionMessageToolCall[];
     reasoning_content?: string;
-    usage?: ClaudeUsage;
+    usage?: Usage;
     finish_reason?: "stop" | "length" | "tool_calls" | "content_filter" | "function_call" | null;
     response_headers?: Record<string, string>;
     additionalFields?: Record<string, unknown>;

package/dist/services/aiService.js

@@ -202,17 +202,9 @@ export async function callAgent(options) {
             });
             const finalMessage = response.choices[0]?.message;
             const finishReason = response.choices[0]?.finish_reason || null;
-            let totalUsage = response.usage
-                ? {
-                    prompt_tokens: response.usage.prompt_tokens,
-                    completion_tokens: response.usage.completion_tokens,
-                    total_tokens: response.usage.total_tokens,
-                }
+            const totalUsage = response.usage
+                ? extendUsageWithCacheMetrics(response.usage)
                 : undefined;
-            // Extend usage with cache metrics (Claude top-level + OpenAI prompt_tokens_details)
-            if (totalUsage && response.usage) {
-                totalUsage = extendUsageWithCacheMetrics(totalUsage, response.usage);
-            }
             const result = {};
             if (finalMessage) {
                 const { content: finalContent, tool_calls: finalToolCalls, reasoning_content: finalReasoningContent, ...otherFields } = finalMessage;
@@ -353,14 +345,8 @@ async function processStreamingResponse(stream, onContentUpdate, onToolUpdate, o
             }
             // Check for usage information in any chunk
             if (chunk.usage) {
-                let chunkUsage = {
-                    prompt_tokens: chunk.usage.prompt_tokens,
-                    completion_tokens: chunk.usage.completion_tokens,
-                    total_tokens: chunk.usage.total_tokens,
-                };
-                // Extend usage with cache metrics (Claude top-level + OpenAI prompt_tokens_details)
-                chunkUsage = extendUsageWithCacheMetrics(chunkUsage, chunk.usage);
-                usage = chunkUsage;
+                // Extend usage with cache metrics from OpenAI prompt_tokens_details
+                usage = extendUsageWithCacheMetrics(chunk.usage);
             }
             // Check for finish_reason in the choice
             const choice = chunk.choices?.[0];

package/dist/services/configurationService.d.ts

@@ -196,6 +196,13 @@ export declare function mergeEnvironmentConfig(userEnv: Record<string, string> |
  * Supports both hooks and environment variables with proper validation
  */
 export declare function loadWaveConfigFromFile(filePath: string): WaveConfiguration | null;
+/**
+ * Load the user-level (~/.wave/settings.json) `env` block only — no workdir
+ * dependency. Used at daemon startup to apply WAVE_SERVER_URL before any agent
+ * initializes: auth queries (getAuthStatus) can run before the first agent,
+ * and AuthService falls back to the default URL otherwise.
+ */
+export declare function loadUserConfigEnv(): Record<string, string>;
 /**
  * Load and merge Wave configuration from both user and project sources
  * Project configuration takes precedence over user configuration

package/dist/services/configurationService.js

@@ -1079,6 +1079,16 @@ export function loadWaveConfigFromFile(filePath) {
         throw error;
     }
 }
+/**
+ * Load the user-level (~/.wave/settings.json) `env` block only — no workdir
+ * dependency. Used at daemon startup to apply WAVE_SERVER_URL before any agent
+ * initializes: auth queries (getAuthStatus) can run before the first agent,
+ * and AuthService falls back to the default URL otherwise.
+ */
+export function loadUserConfigEnv() {
+    const config = loadWaveConfigFromFile(getUserConfigPaths()[0]);
+    return config?.env ?? {};
+}
 /**
  * Load and merge Wave configuration from both user and project sources
  * Project configuration takes precedence over user configuration

package/dist/types/core.d.ts

@@ -2,7 +2,6 @@
  * 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
@@ -15,7 +14,7 @@ export interface Logger {
 }
 /**
  * Usage statistics for AI operations
- * Extends OpenAI's Usage format with additional tracking fields
+ * Extends OpenAI's Usage format with normalized cache fields
  */
 export interface Usage {
     prompt_tokens: number;
@@ -25,38 +24,6 @@ export interface Usage {
     operation_type?: "agent" | "compact";
     cache_read_input_tokens?: number;
     cache_creation_input_tokens?: number;
-    cache_creation?: {
-        ephemeral_5m_input_tokens: number;
-        ephemeral_1h_input_tokens: number;
-    };
-}
-/**
- * Enhanced usage metrics including Claude cache information
- * Backward compatible with standard OpenAI CompletionUsage
- */
-export interface ClaudeUsage extends CompletionUsage {
-    prompt_tokens: number;
-    completion_tokens: number;
-    total_tokens: number;
-    /**
-     * 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

package/dist/types/index.d.ts

@@ -38,3 +38,4 @@ export * from "./workflow.js";
 export type { SessionMetadata, SessionData } from "../services/session.js";
 export type { ToolBlockUpdateCallbackParams } from "../utils/messageOperations.js";
 export type { QueuedMessage } from "../managers/messageQueue.js";
+export type { SubagentConfiguration } from "../utils/subagentParser.js";

package/dist/utils/cacheControlUtils.d.ts

@@ -7,6 +7,7 @@
  */
 import type { ChatCompletionMessageParam, ChatCompletionContentPart, ChatCompletionContentPartText, CompletionUsage } from "openai/resources";
 import type { ModelCapabilities } from "../types/config.js";
+import type { Usage } from "../types/core.js";
 /**
  * Cache control directive for Claude models
  */
@@ -28,22 +29,6 @@ export interface ClaudeChatCompletionContentPartText extends ChatCompletionConte
 export interface ExtendedPromptTokensDetails extends CompletionUsage.PromptTokensDetails {
     cache_creation_input_tokens?: number;
 }
-/**
- * Enhanced usage metrics including cache information
- * Supports both Claude-specific top-level fields and OpenAI-standard prompt_tokens_details
- */
-export interface ClaudeUsage extends CompletionUsage {
-    prompt_tokens: number;
-    completion_tokens: number;
-    total_tokens: number;
-    cache_read_input_tokens?: number;
-    cache_creation_input_tokens?: number;
-    cache_creation?: {
-        ephemeral_5m_input_tokens: number;
-        ephemeral_1h_input_tokens: number;
-    };
-    prompt_tokens_details?: ExtendedPromptTokensDetails;
-}
 /**
  * Validates cache control structure
  * @param control - Object to validate
@@ -85,16 +70,9 @@ export declare function countContentBlocks(messages: ChatCompletionMessageParam[
 export declare function transformMessagesForExplicitCache(messages: ChatCompletionMessageParam[], capabilities?: ModelCapabilities): ChatCompletionMessageParam[];
 /**
  * Extends standard usage with cache metrics
- * Extracts cache tokens from both Claude-specific top-level fields and
- * OpenAI-standard prompt_tokens_details (used by Gemini, DeepSeek, etc.)
- * @param standardUsage - OpenAI usage response
- * @param cacheMetrics - Additional cache metrics from the API response
+ * Extracts cache tokens from OpenAI-standard prompt_tokens_details
+ * (cached_tokens and the gateway-provided cache_creation_input_tokens)
+ * @param usage - OpenAI usage response
  * @returns Extended usage with cache information
  */
-export declare function extendUsageWithCacheMetrics(standardUsage: CompletionUsage, cacheMetrics?: Partial<ClaudeUsage>): ClaudeUsage;
-/**
- * Validates Claude usage structure
- * @param usage - Usage object to validate
- * @returns True if usage structure is valid
- */
-export declare function isValidClaudeUsage(usage: unknown): usage is ClaudeUsage;
+export declare function extendUsageWithCacheMetrics(usage: CompletionUsage): Usage;

package/dist/utils/cacheControlUtils.js

@@ -207,84 +207,23 @@ export function transformMessagesForExplicitCache(messages, capabilities) {
 }
 /**
  * Extends standard usage with cache metrics
- * Extracts cache tokens from both Claude-specific top-level fields and
- * OpenAI-standard prompt_tokens_details (used by Gemini, DeepSeek, etc.)
- * @param standardUsage - OpenAI usage response
- * @param cacheMetrics - Additional cache metrics from the API response
+ * Extracts cache tokens from OpenAI-standard prompt_tokens_details
+ * (cached_tokens and the gateway-provided cache_creation_input_tokens)
+ * @param usage - OpenAI usage response
  * @returns Extended usage with cache information
  */
-export function extendUsageWithCacheMetrics(standardUsage, cacheMetrics) {
+export function extendUsageWithCacheMetrics(usage) {
     const baseUsage = {
-        prompt_tokens: standardUsage.prompt_tokens,
-        completion_tokens: standardUsage.completion_tokens,
-        total_tokens: standardUsage.total_tokens,
+        prompt_tokens: usage.prompt_tokens,
+        completion_tokens: usage.completion_tokens,
+        total_tokens: usage.total_tokens,
     };
-    if (!cacheMetrics) {
-        return baseUsage;
+    const details = usage.prompt_tokens_details;
+    if (details?.cached_tokens != null) {
+        baseUsage.cache_read_input_tokens = details.cached_tokens;
     }
-    // Extract cache_read_input_tokens from Claude top-level field
-    if (typeof cacheMetrics.cache_read_input_tokens === "number") {
-        baseUsage.cache_read_input_tokens = cacheMetrics.cache_read_input_tokens;
-    }
-    // Fallback to prompt_tokens_details.cached_tokens (OpenAI standard)
-    else if (cacheMetrics.prompt_tokens_details?.cached_tokens != null) {
-        baseUsage.cache_read_input_tokens =
-            cacheMetrics.prompt_tokens_details.cached_tokens;
-    }
-    // Extract cache_creation_input_tokens from Claude top-level field
-    if (typeof cacheMetrics.cache_creation_input_tokens === "number") {
-        baseUsage.cache_creation_input_tokens =
-            cacheMetrics.cache_creation_input_tokens;
-    }
-    // Fallback to prompt_tokens_details.cache_creation_input_tokens
-    else if (cacheMetrics.prompt_tokens_details?.cache_creation_input_tokens != null) {
-        baseUsage.cache_creation_input_tokens =
-            cacheMetrics.prompt_tokens_details.cache_creation_input_tokens;
-    }
-    // Extract cache_creation breakdown (Claude-specific)
-    if (cacheMetrics.cache_creation &&
-        typeof cacheMetrics.cache_creation.ephemeral_5m_input_tokens === "number" &&
-        typeof cacheMetrics.cache_creation.ephemeral_1h_input_tokens === "number") {
-        baseUsage.cache_creation = {
-            ephemeral_5m_input_tokens: cacheMetrics.cache_creation.ephemeral_5m_input_tokens,
-            ephemeral_1h_input_tokens: cacheMetrics.cache_creation.ephemeral_1h_input_tokens,
-        };
+    if (details?.cache_creation_input_tokens != null) {
+        baseUsage.cache_creation_input_tokens = details.cache_creation_input_tokens;
     }
     return baseUsage;
 }
-/**
- * Validates Claude usage structure
- * @param usage - Usage object to validate
- * @returns True if usage structure is valid
- */
-export function isValidClaudeUsage(usage) {
-    if (!usage || typeof usage !== "object") {
-        return false;
-    }
-    const usageObj = usage;
-    // Check required standard fields
-    const hasStandardFields = typeof usageObj.prompt_tokens === "number" &&
-        typeof usageObj.completion_tokens === "number" &&
-        typeof usageObj.total_tokens === "number";
-    if (!hasStandardFields) {
-        return false;
-    }
-    // Check optional cache fields
-    const hasCacheFields = (usageObj.cache_read_input_tokens === undefined ||
-        typeof usageObj.cache_read_input_tokens === "number") &&
-        (usageObj.cache_creation_input_tokens === undefined ||
-            typeof usageObj.cache_creation_input_tokens === "number");
-    if (!hasCacheFields) {
-        return false;
-    }
-    // Check cache_creation object if present
-    if (usageObj.cache_creation !== undefined) {
-        const cacheCreation = usageObj.cache_creation;
-        if (typeof cacheCreation !== "object" ||
-            typeof cacheCreation.ephemeral_5m_input_tokens !== "number" ||
-            typeof cacheCreation.ephemeral_1h_input_tokens !== "number") {
-            return false;
-        }
-    }
-    return true;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wave-agent-sdk",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "SDK for building AI-powered development tools and agents",
   "keywords": [
     "ai",