@raindrop-ai/claude-code 0.0.4 → 0.0.6

package/dist/index.d.cts

@@ -221,6 +221,15 @@ declare class TraceShipper extends TraceShipper$1 {
     enqueue(span: OtlpSpan): void;
 }
 
+interface SelfDiagnosticsSignalDef {
+    description: string;
+    sentiment?: "POSITIVE" | "NEGATIVE";
+}
+interface SelfDiagnosticsConfig {
+    signals?: Record<string, SelfDiagnosticsSignalDef>;
+    guidance?: string;
+    toolName?: string;
+}
 interface ConfigFile {
     write_key?: string;
     api_url?: string;
@@ -229,6 +238,7 @@ interface ConfigFile {
     enabled?: boolean;
     event_name?: string;
     custom_properties?: Record<string, unknown>;
+    self_diagnostics?: SelfDiagnosticsConfig;
 }
 interface RaindropConfig {
     writeKey: string;
@@ -238,6 +248,7 @@ interface RaindropConfig {
     enabled: boolean;
     eventName: string;
     customProperties: Record<string, unknown>;
+    selfDiagnostics?: SelfDiagnosticsConfig;
 }
 /**
  * Load config with precedence (low -> high):
@@ -275,6 +286,9 @@ interface HookPayload {
     agent_transcript_path?: string;
     trigger?: string;
     compact_summary?: string;
+    file_path?: string;
+    memory_type?: string;
+    load_reason?: string;
 }
 interface MapperConfig {
     userId: string;
@@ -283,9 +297,58 @@ interface MapperConfig {
     customProperties: Record<string, unknown>;
 }
 declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, eventShipper: EventShipper, traceShipper: TraceShipper): Promise<void>;
+/**
+ * Parse command-line args for --append-system-prompt and
+ * --append-system-prompt-file flags. Handles both space-separated form
+ * (--flag value) and equals form (--flag=value). Supports both flags
+ * appearing together (they concatenate).
+ *
+ * Exported for testing.
+ */
+declare function extractAppendSystemPrompt(args: string[]): string | undefined;
 
 declare const PACKAGE_NAME = "@raindrop-ai/claude-code";
-declare const PACKAGE_VERSION = "0.0.4";
+declare const PACKAGE_VERSION = "0.0.6";
+
+interface TranscriptSummary {
+    /** Aggregated token usage across all turns */
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCacheReadTokens: number;
+    totalCacheCreationTokens: number;
+    /** Token usage for the most recent turn only */
+    lastTurnInputTokens?: number;
+    lastTurnOutputTokens?: number;
+    lastTurnCacheReadTokens?: number;
+    /** Model used (from most recent assistant message) */
+    model?: string;
+    /** Service tier */
+    serviceTier?: string;
+    /** Number of API turns (assistant messages) */
+    turnCount: number;
+    /** Unique tool names used in the session */
+    toolsUsed: string[];
+    /** Stop reason from last assistant message */
+    stopReason?: string;
+    /** Total turn duration in ms (from system entries) */
+    totalDurationMs?: number;
+    /** Claude Code version */
+    codeVersion?: string;
+    /** Git branch */
+    gitBranch?: string;
+    /** Whether thinking/reasoning content was used */
+    hasThinking: boolean;
+}
+/**
+ * Parse a Claude Code transcript JSONL file and extract a summary.
+ * Returns undefined if the file doesn't exist or can't be parsed.
+ */
+declare function parseTranscript(transcriptPath: string): TranscriptSummary | undefined;
+/**
+ * Convert a TranscriptSummary into a flat properties object
+ * suitable for merging into event properties.
+ */
+declare function transcriptToProperties(summary: TranscriptSummary): Record<string, unknown>;
 
 interface LocalDebuggerResult {
     /** The resolved base URL (e.g. "http://localhost:5899/v1/"), or null if not detected. */
@@ -308,4 +371,58 @@ declare function detectLocalDebugger(debug: boolean): Promise<LocalDebuggerResul
  */
 declare function mirrorEventToLocalDebugger(baseUrl: string, payload: Record<string, unknown>, debug: boolean): void;
 
-export { EventShipper, type HookPayload, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SetupScope, TraceShipper, detectLocalDebugger, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, updateConfig };
+interface ResolvedSignal {
+    description: string;
+    sentiment?: "POSITIVE" | "NEGATIVE";
+}
+/**
+ * Normalize and validate user-provided signal definitions.
+ * Returns the default set if input is empty or all entries are invalid.
+ * Always appends `noteworthy` as the last category.
+ */
+declare function normalizeSignals(custom?: Record<string, SelfDiagnosticsSignalDef>): Record<string, ResolvedSignal>;
+/**
+ * Resolve the full MCP tool configuration from optional user config.
+ */
+declare function resolveToolConfig(diagConfig?: SelfDiagnosticsConfig): {
+    signals: Record<string, ResolvedSignal>;
+    categoryKeys: string[];
+    toolName: string;
+    toolDescription: string;
+};
+/** Default category keys (before custom signal config is applied). */
+declare const DEFAULT_CATEGORY_KEYS: string[];
+/**
+ * Find the most recently modified event_* file in the state dir.
+ * Returns the eventId stored in that file, or undefined.
+ */
+declare function resolveCurrentEventId(): string | undefined;
+declare function executeTool(args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+declare const TOOL_SCHEMA: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            category: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            detail: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+declare function startMcpServer(): Promise<void>;
+
+export { DEFAULT_CATEGORY_KEYS, EventShipper, type HookPayload, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SelfDiagnosticsConfig, type SelfDiagnosticsSignalDef, type SetupScope, TOOL_SCHEMA, TraceShipper, type TranscriptSummary, detectLocalDebugger, executeTool, extractAppendSystemPrompt, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, normalizeSignals, parseTranscript, resolveCurrentEventId, resolveToolConfig, startMcpServer, transcriptToProperties, updateConfig };

package/dist/index.d.ts

@@ -221,6 +221,15 @@ declare class TraceShipper extends TraceShipper$1 {
     enqueue(span: OtlpSpan): void;
 }
 
+interface SelfDiagnosticsSignalDef {
+    description: string;
+    sentiment?: "POSITIVE" | "NEGATIVE";
+}
+interface SelfDiagnosticsConfig {
+    signals?: Record<string, SelfDiagnosticsSignalDef>;
+    guidance?: string;
+    toolName?: string;
+}
 interface ConfigFile {
     write_key?: string;
     api_url?: string;
@@ -229,6 +238,7 @@ interface ConfigFile {
     enabled?: boolean;
     event_name?: string;
     custom_properties?: Record<string, unknown>;
+    self_diagnostics?: SelfDiagnosticsConfig;
 }
 interface RaindropConfig {
     writeKey: string;
@@ -238,6 +248,7 @@ interface RaindropConfig {
     enabled: boolean;
     eventName: string;
     customProperties: Record<string, unknown>;
+    selfDiagnostics?: SelfDiagnosticsConfig;
 }
 /**
  * Load config with precedence (low -> high):
@@ -275,6 +286,9 @@ interface HookPayload {
     agent_transcript_path?: string;
     trigger?: string;
     compact_summary?: string;
+    file_path?: string;
+    memory_type?: string;
+    load_reason?: string;
 }
 interface MapperConfig {
     userId: string;
@@ -283,9 +297,58 @@ interface MapperConfig {
     customProperties: Record<string, unknown>;
 }
 declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, eventShipper: EventShipper, traceShipper: TraceShipper): Promise<void>;
+/**
+ * Parse command-line args for --append-system-prompt and
+ * --append-system-prompt-file flags. Handles both space-separated form
+ * (--flag value) and equals form (--flag=value). Supports both flags
+ * appearing together (they concatenate).
+ *
+ * Exported for testing.
+ */
+declare function extractAppendSystemPrompt(args: string[]): string | undefined;
 
 declare const PACKAGE_NAME = "@raindrop-ai/claude-code";
-declare const PACKAGE_VERSION = "0.0.4";
+declare const PACKAGE_VERSION = "0.0.6";
+
+interface TranscriptSummary {
+    /** Aggregated token usage across all turns */
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCacheReadTokens: number;
+    totalCacheCreationTokens: number;
+    /** Token usage for the most recent turn only */
+    lastTurnInputTokens?: number;
+    lastTurnOutputTokens?: number;
+    lastTurnCacheReadTokens?: number;
+    /** Model used (from most recent assistant message) */
+    model?: string;
+    /** Service tier */
+    serviceTier?: string;
+    /** Number of API turns (assistant messages) */
+    turnCount: number;
+    /** Unique tool names used in the session */
+    toolsUsed: string[];
+    /** Stop reason from last assistant message */
+    stopReason?: string;
+    /** Total turn duration in ms (from system entries) */
+    totalDurationMs?: number;
+    /** Claude Code version */
+    codeVersion?: string;
+    /** Git branch */
+    gitBranch?: string;
+    /** Whether thinking/reasoning content was used */
+    hasThinking: boolean;
+}
+/**
+ * Parse a Claude Code transcript JSONL file and extract a summary.
+ * Returns undefined if the file doesn't exist or can't be parsed.
+ */
+declare function parseTranscript(transcriptPath: string): TranscriptSummary | undefined;
+/**
+ * Convert a TranscriptSummary into a flat properties object
+ * suitable for merging into event properties.
+ */
+declare function transcriptToProperties(summary: TranscriptSummary): Record<string, unknown>;
 
 interface LocalDebuggerResult {
     /** The resolved base URL (e.g. "http://localhost:5899/v1/"), or null if not detected. */
@@ -308,4 +371,58 @@ declare function detectLocalDebugger(debug: boolean): Promise<LocalDebuggerResul
  */
 declare function mirrorEventToLocalDebugger(baseUrl: string, payload: Record<string, unknown>, debug: boolean): void;
 
-export { EventShipper, type HookPayload, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SetupScope, TraceShipper, detectLocalDebugger, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, updateConfig };
+interface ResolvedSignal {
+    description: string;
+    sentiment?: "POSITIVE" | "NEGATIVE";
+}
+/**
+ * Normalize and validate user-provided signal definitions.
+ * Returns the default set if input is empty or all entries are invalid.
+ * Always appends `noteworthy` as the last category.
+ */
+declare function normalizeSignals(custom?: Record<string, SelfDiagnosticsSignalDef>): Record<string, ResolvedSignal>;
+/**
+ * Resolve the full MCP tool configuration from optional user config.
+ */
+declare function resolveToolConfig(diagConfig?: SelfDiagnosticsConfig): {
+    signals: Record<string, ResolvedSignal>;
+    categoryKeys: string[];
+    toolName: string;
+    toolDescription: string;
+};
+/** Default category keys (before custom signal config is applied). */
+declare const DEFAULT_CATEGORY_KEYS: string[];
+/**
+ * Find the most recently modified event_* file in the state dir.
+ * Returns the eventId stored in that file, or undefined.
+ */
+declare function resolveCurrentEventId(): string | undefined;
+declare function executeTool(args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+declare const TOOL_SCHEMA: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            category: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            detail: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+declare function startMcpServer(): Promise<void>;
+
+export { DEFAULT_CATEGORY_KEYS, EventShipper, type HookPayload, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SelfDiagnosticsConfig, type SelfDiagnosticsSignalDef, type SetupScope, TOOL_SCHEMA, TraceShipper, type TranscriptSummary, detectLocalDebugger, executeTool, extractAppendSystemPrompt, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, normalizeSignals, parseTranscript, resolveCurrentEventId, resolveToolConfig, startMcpServer, transcriptToProperties, updateConfig };