wave-agent-sdk 0.14.1 → 0.14.3

package/src/types/marketplace.ts

@@ -7,24 +7,8 @@ export interface MarketplaceOwner {
 
 export interface MarketplacePluginEntry {
   name: string;
-  source: string | MarketplaceSource;
+  source: string;
   description: string;
-  /** Claude Code compatibility: plugin category */
-  category?: string;
-  /** Claude Code compatibility: plugin tags */
-  tags?: string[];
-  /** Claude Code compatibility: when false, plugin.json is optional */
-  strict?: boolean;
-  /** Claude Code compatibility: inline manifest fields */
-  version?: string;
-  author?: { name: string; url?: string };
-  homepage?: string;
-  repository?: string;
-  license?: string;
-  keywords?: string[];
-  commands?: string;
-  skills?: string;
-  agents?: string;
 }
 
 export interface MarketplacePluginStatus extends MarketplacePluginEntry {
@@ -40,8 +24,6 @@ export interface MarketplaceManifest {
   name: string;
   owner: MarketplaceOwner;
   plugins: MarketplacePluginEntry[];
-  /** Claude Code compatibility: additional metadata */
-  metadata?: Record<string, unknown>;
 }
 
 export type MarketplaceSource =
@@ -58,11 +40,6 @@ export type MarketplaceSource =
       source: "git";
       url: string;
       ref?: string;
-    }
-  | {
-      source: "url";
-      url: string;
-      ref?: string;
     };
 
 export interface KnownMarketplace {

package/src/types/messaging.ts

@@ -25,7 +25,7 @@ export type MessageBlock =
   | ToolBlock
   | ImageBlock
   | BangBlock
-  | CompressBlock
+  | CompactBlock
   | ReasoningBlock
   | FileHistoryBlock
   | TaskNotificationBlock;
@@ -85,8 +85,8 @@ export interface BangBlock {
   exitCode: number | null;
 }
 
-export interface CompressBlock {
-  type: "compress";
+export interface CompactBlock {
+  type: "compact";
   content: string;
   sessionId: string;
 }

package/src/types/plugins.ts

@@ -3,9 +3,10 @@ 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 or .claude-plugin/plugin.json)
+ * Plugin manifest structure (.wave-plugin/plugin.json)
  */
 export interface PluginManifest {
   name: string;
@@ -14,18 +15,6 @@ export interface PluginManifest {
   author?: {
     name: string;
   };
-  /** Claude Code compatibility: plugin keywords */
-  keywords?: string[];
-  /** Claude Code compatibility: plugin homepage URL */
-  homepage?: string;
-  /** Claude Code compatibility: repository info */
-  repository?: string;
-  /** Claude Code compatibility: license info */
-  license?: string;
-  /** Claude Code compatibility: plugin dependencies */
-  dependencies?: Record<string, string>;
-  /** Claude Code compatibility: user configuration schema */
-  userConfig?: Record<string, unknown>;
 }
 
 /**
@@ -43,6 +32,7 @@ export interface Plugin extends PluginManifest {
   path: string;
   commands: CustomSlashCommand[];
   skills: Skill[];
+  agents: SubagentConfiguration[];
   lspConfig?: LspConfig;
   mcpConfig?: McpConfig;
   hooksConfig?: PartialHookConfiguration;

package/src/utils/convertMessagesForAPI.ts

@@ -33,7 +33,7 @@ function safeToolArguments(args: string): string {
 }
 
 /**
- * Convert message format to API call format, stopping when a compressed message is encountered.
+ * Convert message format to API call format, stopping when a compacted message is encountered.
  * Messages with no meaningful content or tool calls are filtered out.
  * @param messages Message list
  * @returns Converted API message format list
@@ -47,19 +47,19 @@ export function convertMessagesForAPI(
   for (let i = startIndex; i >= 0; i--) {
     const message = messages[i];
 
-    // Check if a compression block is encountered, if so, stop iteration
+    // Check if a compaction block is encountered, if so, stop iteration
     if (
       message.role === "assistant" &&
-      message.blocks.some((block) => block.type === "compress")
+      message.blocks.some((block) => block.type === "compact")
     ) {
-      // Add the content of the compression block as an assistant message to the history
-      const compressBlock = message.blocks.find(
-        (block) => block.type === "compress",
+      // Add the content of the compaction block as an assistant message to the history
+      const compactBlock = message.blocks.find(
+        (block) => block.type === "compact",
       );
-      if (compressBlock && compressBlock.type === "compress") {
+      if (compactBlock && compactBlock.type === "compact") {
         recentMessages.unshift({
           role: "user",
-          content: compressBlock.content,
+          content: compactBlock.content,
         });
       }
       break;
@@ -145,6 +145,20 @@ export function convertMessagesForAPI(
           .join("\n");
       }
 
+      // Extract reasoning content from reasoning blocks
+      const reasoningBlocks = message.blocks.filter(
+        (block) =>
+          block.type === "reasoning" &&
+          block.content &&
+          block.content.trim().length > 0,
+      );
+      let reasoning_content: string | undefined;
+      if (reasoningBlocks.length > 0) {
+        reasoning_content = reasoningBlocks
+          .map((block) => (block.type === "reasoning" ? block.content : ""))
+          .join("\n");
+      }
+
       // Construct tool calls from tool blocks
       if (toolBlocks.length > 0) {
         tool_calls = toolBlocks
@@ -176,8 +190,9 @@ export function convertMessagesForAPI(
           role: "assistant",
           content: hasContent ? content : undefined,
           tool_calls,
+          ...(reasoning_content ? { reasoning_content } : {}),
           ...(message.additionalFields ? { ...message.additionalFields } : {}),
-        };
+        } as ChatCompletionMessageParam;
 
         recentMessages.unshift(assistantMessage);
       }

package/src/utils/groupMessagesByApiRound.ts

@@ -14,7 +14,7 @@ export interface ApiRound {
  * Boundaries:
  *  - A new `role: "user"` message starts a new round.
  *  - A new `role: "assistant"` message with a different `id` starts a new round.
- *  - A message with a `compress` block is pushed as its own round and starts a
+ *  - A message with a `compact` block is pushed as its own round and starts a
  *    new round after it.
  */
 export function groupMessagesByApiRound(messages: Message[]): ApiRound[] {
@@ -28,9 +28,9 @@ export function groupMessagesByApiRound(messages: Message[]): ApiRound[] {
     if (msg.role === "user") {
       startNewRound = true;
     } else if (msg.role === "assistant") {
-      // Compress block is always its own round
-      const hasCompress = msg.blocks.some((b) => b.type === "compress");
-      if (hasCompress) {
+      // Compact block is always its own round
+      const hasCompact = msg.blocks.some((b) => b.type === "compact");
+      if (hasCompact) {
         startNewRound = true;
       } else if (msg.id !== lastAssistantId) {
         // New assistant id starts a new round.
@@ -58,10 +58,10 @@ export function groupMessagesByApiRound(messages: Message[]): ApiRound[] {
 
     currentRound.push(msg);
 
-    // After pushing a compress message as its own round, flush immediately
+    // After pushing a compact message as its own round, flush immediately
     if (
       msg.role === "assistant" &&
-      msg.blocks.some((b) => b.type === "compress")
+      msg.blocks.some((b) => b.type === "compact")
     ) {
       rounds.push({
         messages: currentRound,

package/src/utils/messageOperations.ts

@@ -582,11 +582,9 @@ export function getMessageContent(message: Message): string {
     return `!${bangBlock.command}`;
   }
 
-  const compressBlock = message.blocks.find(
-    (block) => block.type === "compress",
-  );
-  if (compressBlock && "content" in compressBlock) {
-    return compressBlock.content;
+  const compactBlock = message.blocks.find((block) => block.type === "compact");
+  if (compactBlock && "content" in compactBlock) {
+    return compactBlock.content;
   }
 
   return "";

package/src/utils/subagentParser.ts

@@ -10,8 +10,10 @@ export interface SubagentConfiguration {
   model?: string;
   systemPrompt: string;
   filePath: string;
-  scope: "project" | "user" | "builtin";
+  scope: "project" | "user" | "builtin" | "plugin";
   priority: number;
+  /** Plugin root directory path, set when scope is "plugin" */
+  pluginRoot?: string;
 }
 
 interface SubagentFrontmatter {
@@ -119,11 +121,12 @@ function validateConfiguration(
 }
 
 /**
- * Parse a single subagent markdown file
+ * Parse a single subagent markdown file with optional pluginRoot support
  */
 function parseSubagentFile(
   filePath: string,
-  scope: "project" | "user" | "builtin",
+  scope: "project" | "user" | "builtin" | "plugin",
+  pluginRoot?: string,
 ): SubagentConfiguration {
   try {
     const content = readFileSync(filePath, "utf-8");
@@ -143,16 +146,28 @@ function parseSubagentFile(
     let priority = 1;
     if (scope === "user") priority = 2;
     if (scope === "builtin") priority = 3;
+    if (scope === "plugin") priority = 2; // Same priority as user-level
+
+    let systemPrompt = body;
+
+    // Substitute ${WAVE_PLUGIN_ROOT} for plugin scope at parse time
+    if (scope === "plugin" && pluginRoot) {
+      systemPrompt = systemPrompt.replace(
+        /\$\{WAVE_PLUGIN_ROOT\}/g,
+        pluginRoot,
+      );
+    }
 
     return {
       name: frontmatter.name!,
       description: frontmatter.description!,
       tools: frontmatter.tools,
       model: frontmatter.model,
-      systemPrompt: body,
+      systemPrompt,
       filePath,
       scope,
       priority,
+      pluginRoot: scope === "plugin" ? pluginRoot : undefined,
     };
   } catch (error) {
     throw new Error(
@@ -161,6 +176,18 @@ function parseSubagentFile(
   }
 }
 
+/**
+ * Parse a plugin agent markdown file.
+ * Exposed as a public API for PluginLoader to use.
+ */
+export function parseAgentFile(
+  filePath: string,
+  scope: "plugin",
+  pluginRoot: string,
+): SubagentConfiguration {
+  return parseSubagentFile(filePath, scope, pluginRoot);
+}
+
 /**
  * Scan directory for subagent files
  */