@kmmao/happy-wire 0.18.0 → 0.19.0

package/dist/index.cjs

@@ -2124,23 +2124,64 @@ const GetContextUsageResponseSchema = z.z.object({
     serverName: z.z.string(),
     tokens: z.z.number().int().nonnegative(),
     isLoaded: z.z.boolean().optional()
-  }))
+  })),
+  /** Messages 内部 token 细分（SDK messageBreakdown）。仅 SDK 0.2.139+ 返回。 */
+  messageBreakdown: z.z.object({
+    toolCallTokens: z.z.number().int().nonnegative(),
+    toolResultTokens: z.z.number().int().nonnegative(),
+    attachmentTokens: z.z.number().int().nonnegative(),
+    assistantMessageTokens: z.z.number().int().nonnegative(),
+    userMessageTokens: z.z.number().int().nonnegative(),
+    redirectedContextTokens: z.z.number().int().nonnegative(),
+    unattributedTokens: z.z.number().int().nonnegative(),
+    toolCallsByType: z.z.array(z.z.object({
+      name: z.z.string(),
+      callTokens: z.z.number().int().nonnegative(),
+      resultTokens: z.z.number().int().nonnegative()
+    })),
+    attachmentsByType: z.z.array(z.z.object({
+      name: z.z.string(),
+      tokens: z.z.number().int().nonnegative()
+    }))
+  }).optional(),
+  /** System Prompt 各段 token 细分。 */
+  systemPromptSections: z.z.array(z.z.object({
+    name: z.z.string(),
+    tokens: z.z.number().int().nonnegative()
+  })).optional(),
+  /** API 实际用量（input/output/cache hit/miss）。 */
+  apiUsage: z.z.object({
+    inputTokens: z.z.number().int().nonnegative(),
+    outputTokens: z.z.number().int().nonnegative(),
+    cacheCreationInputTokens: z.z.number().int().nonnegative(),
+    cacheReadInputTokens: z.z.number().int().nonnegative()
+  }).nullable().optional()
 }).strict();
 const GetContextDetailRequestSchema = z.z.object({
   /**
    * Category name from getContextUsage (e.g. "Messages", "System prompt",
    * "Skills", "Custom agents", "Autocompact buffer", "Memory files").
    */
-  category: z.z.string().min(1).max(128)
+  category: z.z.string().min(1).max(128),
+  /**
+   * When true, return only subcategory counts (no item content).
+   * Only meaningful for the "Messages" category.
+   */
+  summaryOnly: z.z.boolean().optional(),
+  /**
+   * Filter to a specific subcategory within "Messages".
+   * One of: "user", "system-reminder", "assistant".
+   */
+  subcategory: z.z.string().optional()
 }).strict();
 const GetContextDetailResponseSchema = z.z.object({
-  /** Parsed JSONL records for the requested category. */
+  /** Parsed JSONL records for the requested category. Empty when summaryOnly=true. */
   items: z.z.array(z.z.object({
     /** JSONL record type (user, assistant, attachment, system, summary, etc.) */
     type: z.z.string(),
     /** Role when applicable (user / assistant) */
     role: z.z.string().optional(),
-    /** Full text content of the record. Truncated at 10 KB per item. */
+    /** Full text content of the record. Truncated at 50 KB per item. */
     content: z.z.string(),
     /** UUID of the JSONL record */
     uuid: z.z.string().optional(),
@@ -2150,7 +2191,19 @@ const GetContextDetailResponseSchema = z.z.object({
   /** Category name echoed back for display */
   category: z.z.string(),
   /** Total number of matching items */
-  totalItems: z.z.number().int().nonnegative()
+  totalItems: z.z.number().int().nonnegative(),
+  /**
+   * Subcategory breakdown for "Messages" when summaryOnly=true.
+   * Each entry has a key, display label, and item count.
+   */
+  subcategories: z.z.array(z.z.object({
+    /** Subcategory key: "user" | "system-reminder" | "assistant" */
+    name: z.z.string(),
+    /** Human-readable label */
+    label: z.z.string(),
+    /** Number of items in this subcategory */
+    count: z.z.number().int().nonnegative()
+  })).optional()
 }).strict();
 const GetMcpServersRequestSchema = z.z.object({}).strict();
 const GetMcpServersResponseSchema = z.z.object({

package/dist/index.d.cts

@@ -3726,11 +3726,41 @@ declare const GetContextUsageResponseSchema: z$1.ZodObject<{
         tokens: z$1.ZodNumber;
         isLoaded: z$1.ZodOptional<z$1.ZodBoolean>;
     }, z$1.core.$strip>>;
+    messageBreakdown: z$1.ZodOptional<z$1.ZodObject<{
+        toolCallTokens: z$1.ZodNumber;
+        toolResultTokens: z$1.ZodNumber;
+        attachmentTokens: z$1.ZodNumber;
+        assistantMessageTokens: z$1.ZodNumber;
+        userMessageTokens: z$1.ZodNumber;
+        redirectedContextTokens: z$1.ZodNumber;
+        unattributedTokens: z$1.ZodNumber;
+        toolCallsByType: z$1.ZodArray<z$1.ZodObject<{
+            name: z$1.ZodString;
+            callTokens: z$1.ZodNumber;
+            resultTokens: z$1.ZodNumber;
+        }, z$1.core.$strip>>;
+        attachmentsByType: z$1.ZodArray<z$1.ZodObject<{
+            name: z$1.ZodString;
+            tokens: z$1.ZodNumber;
+        }, z$1.core.$strip>>;
+    }, z$1.core.$strip>>;
+    systemPromptSections: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+        name: z$1.ZodString;
+        tokens: z$1.ZodNumber;
+    }, z$1.core.$strip>>>;
+    apiUsage: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodObject<{
+        inputTokens: z$1.ZodNumber;
+        outputTokens: z$1.ZodNumber;
+        cacheCreationInputTokens: z$1.ZodNumber;
+        cacheReadInputTokens: z$1.ZodNumber;
+    }, z$1.core.$strip>>>;
 }, z$1.core.$strict>;
 type GetContextUsageRequest = z$1.infer<typeof GetContextUsageRequestSchema>;
 type GetContextUsageResponse = z$1.infer<typeof GetContextUsageResponseSchema>;
 declare const GetContextDetailRequestSchema: z$1.ZodObject<{
     category: z$1.ZodString;
+    summaryOnly: z$1.ZodOptional<z$1.ZodBoolean>;
+    subcategory: z$1.ZodOptional<z$1.ZodString>;
 }, z$1.core.$strict>;
 declare const GetContextDetailResponseSchema: z$1.ZodObject<{
     items: z$1.ZodArray<z$1.ZodObject<{
@@ -3742,6 +3772,11 @@ declare const GetContextDetailResponseSchema: z$1.ZodObject<{
     }, z$1.core.$strip>>;
     category: z$1.ZodString;
     totalItems: z$1.ZodNumber;
+    subcategories: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+        name: z$1.ZodString;
+        label: z$1.ZodString;
+        count: z$1.ZodNumber;
+    }, z$1.core.$strip>>>;
 }, z$1.core.$strict>;
 type GetContextDetailRequest = z$1.infer<typeof GetContextDetailRequestSchema>;
 type GetContextDetailResponse = z$1.infer<typeof GetContextDetailResponseSchema>;

package/dist/index.d.mts

@@ -3726,11 +3726,41 @@ declare const GetContextUsageResponseSchema: z$1.ZodObject<{
         tokens: z$1.ZodNumber;
         isLoaded: z$1.ZodOptional<z$1.ZodBoolean>;
     }, z$1.core.$strip>>;
+    messageBreakdown: z$1.ZodOptional<z$1.ZodObject<{
+        toolCallTokens: z$1.ZodNumber;
+        toolResultTokens: z$1.ZodNumber;
+        attachmentTokens: z$1.ZodNumber;
+        assistantMessageTokens: z$1.ZodNumber;
+        userMessageTokens: z$1.ZodNumber;
+        redirectedContextTokens: z$1.ZodNumber;
+        unattributedTokens: z$1.ZodNumber;
+        toolCallsByType: z$1.ZodArray<z$1.ZodObject<{
+            name: z$1.ZodString;
+            callTokens: z$1.ZodNumber;
+            resultTokens: z$1.ZodNumber;
+        }, z$1.core.$strip>>;
+        attachmentsByType: z$1.ZodArray<z$1.ZodObject<{
+            name: z$1.ZodString;
+            tokens: z$1.ZodNumber;
+        }, z$1.core.$strip>>;
+    }, z$1.core.$strip>>;
+    systemPromptSections: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+        name: z$1.ZodString;
+        tokens: z$1.ZodNumber;
+    }, z$1.core.$strip>>>;
+    apiUsage: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodObject<{
+        inputTokens: z$1.ZodNumber;
+        outputTokens: z$1.ZodNumber;
+        cacheCreationInputTokens: z$1.ZodNumber;
+        cacheReadInputTokens: z$1.ZodNumber;
+    }, z$1.core.$strip>>>;
 }, z$1.core.$strict>;
 type GetContextUsageRequest = z$1.infer<typeof GetContextUsageRequestSchema>;
 type GetContextUsageResponse = z$1.infer<typeof GetContextUsageResponseSchema>;
 declare const GetContextDetailRequestSchema: z$1.ZodObject<{
     category: z$1.ZodString;
+    summaryOnly: z$1.ZodOptional<z$1.ZodBoolean>;
+    subcategory: z$1.ZodOptional<z$1.ZodString>;
 }, z$1.core.$strict>;
 declare const GetContextDetailResponseSchema: z$1.ZodObject<{
     items: z$1.ZodArray<z$1.ZodObject<{
@@ -3742,6 +3772,11 @@ declare const GetContextDetailResponseSchema: z$1.ZodObject<{
     }, z$1.core.$strip>>;
     category: z$1.ZodString;
     totalItems: z$1.ZodNumber;
+    subcategories: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+        name: z$1.ZodString;
+        label: z$1.ZodString;
+        count: z$1.ZodNumber;
+    }, z$1.core.$strip>>>;
 }, z$1.core.$strict>;
 type GetContextDetailRequest = z$1.infer<typeof GetContextDetailRequestSchema>;
 type GetContextDetailResponse = z$1.infer<typeof GetContextDetailResponseSchema>;

package/dist/index.mjs

@@ -2104,23 +2104,64 @@ const GetContextUsageResponseSchema = z$1.object({
     serverName: z$1.string(),
     tokens: z$1.number().int().nonnegative(),
     isLoaded: z$1.boolean().optional()
-  }))
+  })),
+  /** Messages 内部 token 细分（SDK messageBreakdown）。仅 SDK 0.2.139+ 返回。 */
+  messageBreakdown: z$1.object({
+    toolCallTokens: z$1.number().int().nonnegative(),
+    toolResultTokens: z$1.number().int().nonnegative(),
+    attachmentTokens: z$1.number().int().nonnegative(),
+    assistantMessageTokens: z$1.number().int().nonnegative(),
+    userMessageTokens: z$1.number().int().nonnegative(),
+    redirectedContextTokens: z$1.number().int().nonnegative(),
+    unattributedTokens: z$1.number().int().nonnegative(),
+    toolCallsByType: z$1.array(z$1.object({
+      name: z$1.string(),
+      callTokens: z$1.number().int().nonnegative(),
+      resultTokens: z$1.number().int().nonnegative()
+    })),
+    attachmentsByType: z$1.array(z$1.object({
+      name: z$1.string(),
+      tokens: z$1.number().int().nonnegative()
+    }))
+  }).optional(),
+  /** System Prompt 各段 token 细分。 */
+  systemPromptSections: z$1.array(z$1.object({
+    name: z$1.string(),
+    tokens: z$1.number().int().nonnegative()
+  })).optional(),
+  /** API 实际用量（input/output/cache hit/miss）。 */
+  apiUsage: z$1.object({
+    inputTokens: z$1.number().int().nonnegative(),
+    outputTokens: z$1.number().int().nonnegative(),
+    cacheCreationInputTokens: z$1.number().int().nonnegative(),
+    cacheReadInputTokens: z$1.number().int().nonnegative()
+  }).nullable().optional()
 }).strict();
 const GetContextDetailRequestSchema = z$1.object({
   /**
    * Category name from getContextUsage (e.g. "Messages", "System prompt",
    * "Skills", "Custom agents", "Autocompact buffer", "Memory files").
    */
-  category: z$1.string().min(1).max(128)
+  category: z$1.string().min(1).max(128),
+  /**
+   * When true, return only subcategory counts (no item content).
+   * Only meaningful for the "Messages" category.
+   */
+  summaryOnly: z$1.boolean().optional(),
+  /**
+   * Filter to a specific subcategory within "Messages".
+   * One of: "user", "system-reminder", "assistant".
+   */
+  subcategory: z$1.string().optional()
 }).strict();
 const GetContextDetailResponseSchema = z$1.object({
-  /** Parsed JSONL records for the requested category. */
+  /** Parsed JSONL records for the requested category. Empty when summaryOnly=true. */
   items: z$1.array(z$1.object({
     /** JSONL record type (user, assistant, attachment, system, summary, etc.) */
     type: z$1.string(),
     /** Role when applicable (user / assistant) */
     role: z$1.string().optional(),
-    /** Full text content of the record. Truncated at 10 KB per item. */
+    /** Full text content of the record. Truncated at 50 KB per item. */
     content: z$1.string(),
     /** UUID of the JSONL record */
     uuid: z$1.string().optional(),
@@ -2130,7 +2171,19 @@ const GetContextDetailResponseSchema = z$1.object({
   /** Category name echoed back for display */
   category: z$1.string(),
   /** Total number of matching items */
-  totalItems: z$1.number().int().nonnegative()
+  totalItems: z$1.number().int().nonnegative(),
+  /**
+   * Subcategory breakdown for "Messages" when summaryOnly=true.
+   * Each entry has a key, display label, and item count.
+   */
+  subcategories: z$1.array(z$1.object({
+    /** Subcategory key: "user" | "system-reminder" | "assistant" */
+    name: z$1.string(),
+    /** Human-readable label */
+    label: z$1.string(),
+    /** Number of items in this subcategory */
+    count: z$1.number().int().nonnegative()
+  })).optional()
 }).strict();
 const GetMcpServersRequestSchema = z$1.object({}).strict();
 const GetMcpServersResponseSchema = z$1.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmmao/happy-wire",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Shared message wire types and Zod schemas for Happy clients and services",
   "author": "kmmao",
   "license": "MIT",