dsh-fast 0.1.3 → 0.2.0

package/src/model.ts

@@ -44,11 +44,33 @@ export interface CompactionStats {
   shadowedTokens: number
 }
 
+/** One named bucket of the injected system prompt. */
+export interface PromptBucket {
+  /** Heuristic token estimate for this bucket (`ceil(chars / 4)`). */
+  tokens: number
+  /** Raw character count of the bucket's sections. */
+  chars: number
+  /** Fraction of the total system-prompt bucket tokens (0 when the total is 0). */
+  share: number
+}
+
+/** The system-prompt breakdown: AGENTS.md / skills / persona / other named sections. */
+export interface SystemPromptBreakdown {
+  /** Sections that carry agent instructions (AGENTS.md-style). */
+  agentsMd: PromptBucket
+  /** Sections that carry skill content. */
+  skills: PromptBucket
+  /** The `deployment:persona` section. */
+  persona: PromptBucket
+  /** Harness identity, tool guidance, and any unclassified sections. */
+  other: PromptBucket
+}
+
 /** Context-injection volume: where the request context's tokens live. */
 export interface ContextStats {
   /** Canonical current pressure (token-meter total), or the heuristic header+surface sum. */
   totalTokens: number
-  /** Assembled system-prompt tokens — AGENTS.md, skill directory, persona, and harness instructions. */
+  /** Assembled system-prompt tokens — harness identity, persona, tool guidance, and plugin sections. */
   systemTokens: number
   /** Tool-schema tokens. */
   toolSchemaTokens: number
@@ -60,6 +82,8 @@ export interface ContextStats {
   toolsShare: number
   /** `surfaceTokens / totalTokens` (0 when the total is 0). */
   surfaceShare: number
+  /** Per-section system-prompt breakdown (AGENTS.md / skills / persona / other). */
+  systemBreakdown: SystemPromptBreakdown
 }
 
 /** LLM cache accounting aggregated from `assistant/message` usage. */

package/src/store.ts

@@ -33,6 +33,21 @@ const compactionSchema = z.object({
   shadowedTokens: z.number().int().nonnegative(),
 })
 
+/** Zod schema for one prompt bucket. */
+const bucketSchema = z.object({
+  tokens: z.number().nonnegative(),
+  chars: z.number().nonnegative(),
+  share: z.number(),
+})
+
+/** Zod schema for the system-prompt breakdown. */
+const breakdownSchema = z.object({
+  agentsMd: bucketSchema,
+  skills: bucketSchema,
+  persona: bucketSchema,
+  other: bucketSchema,
+})
+
 /** Zod schema for the context section. */
 const contextSchema = z.object({
   totalTokens: z.number().nonnegative(),
@@ -42,6 +57,7 @@ const contextSchema = z.object({
   systemShare: z.number(),
   toolsShare: z.number(),
   surfaceShare: z.number(),
+  systemBreakdown: breakdownSchema,
 })
 
 /** Zod schema for the cache section. */

package/src/version.ts

@@ -1,2 +1,2 @@
 /** Single-source plugin version, bumped by `scripts/release.mjs`. @module dsh-fast/version */
-export const VERSION = '0.1.3'
+export const VERSION = '0.2.0'