@bahulam/code 2.6.0

package/pulse/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

package/pulse/types/claude.ts

@@ -0,0 +1,294 @@
+// ─── Stats Cache ─────────────────────────────────────────────────────────────
+
+export interface DailyActivity {
+  date: string
+  messageCount: number
+  sessionCount: number
+  toolCallCount: number
+}
+
+export interface DailyTokens {
+  date: string
+  tokensByModel: Record<string, number>
+}
+
+export interface ModelUsage {
+  inputTokens: number
+  outputTokens: number
+  cacheReadInputTokens: number
+  cacheCreationInputTokens: number
+  costUSD: number
+  webSearchRequests: number
+}
+
+export interface LongestSession {
+  sessionId: string
+  duration: number
+  messageCount: number
+  timestamp: string
+}
+
+export interface StatsCache {
+  version: number
+  lastComputedDate: string
+  dailyActivity: DailyActivity[]
+  tokensByDate: DailyTokens[]
+  dailyModelTokens?: DailyTokens[]
+  modelUsage: Record<string, ModelUsage>
+  totalSessions: number
+  totalMessages: number
+  longestSession: LongestSession
+  firstSessionDate: string
+  hourCounts: Record<string, number>
+  totalSpeculationTimeSavedMs: number
+}
+
+// ─── Session Meta ─────────────────────────────────────────────────────────────
+
+export interface SessionMeta {
+  session_id: string
+  project_path: string
+  start_time: string
+  duration_minutes: number
+  user_message_count: number
+  assistant_message_count: number
+  tool_counts: Record<string, number>
+  languages: Record<string, number>
+  git_commits: number
+  git_pushes: number
+  input_tokens: number
+  output_tokens: number
+  cache_creation_input_tokens?: number
+  cache_read_input_tokens?: number
+  first_prompt: string
+  user_interruptions: number
+  user_response_times: number[]
+  tool_errors: number
+  tool_error_categories: Record<string, number>
+  uses_task_agent: boolean
+  uses_mcp: boolean
+  uses_web_search: boolean
+  uses_web_fetch: boolean
+  lines_added: number
+  lines_removed: number
+  files_modified: number
+  message_hours: number[]
+  user_message_timestamps: string[]
+}
+
+// ─── Facets ──────────────────────────────────────────────────────────────────
+
+export interface Facet {
+  session_id: string
+  underlying_goal: string
+  goal_categories: Record<string, number>
+  outcome: string
+  user_satisfaction_counts: Record<string, number>
+  claude_helpfulness: string
+  session_type: string
+  friction_counts: Record<string, number>
+  friction_detail: string
+  primary_success: string
+  brief_summary: string
+}
+
+// ─── Session with Facet joined ───────────────────────────────────────────────
+
+export interface SessionWithFacet extends SessionMeta {
+  facet?: Facet
+  estimated_cost: number
+  slug?: string
+  version?: string
+  git_branch?: string
+  has_compaction?: boolean
+  has_thinking?: boolean
+}
+
+// ─── Replay / JSONL ──────────────────────────────────────────────────────────
+
+export interface TurnUsage {
+  input_tokens: number
+  output_tokens: number
+  cache_creation_input_tokens: number
+  cache_read_input_tokens: number
+  cache_creation?: {
+    ephemeral_5m_input_tokens: number
+    ephemeral_1h_input_tokens: number
+  }
+  service_tier?: string
+  inference_geo?: string
+}
+
+export interface ToolCall {
+  id: string
+  name: string
+  input: Record<string, unknown>
+  result?: string
+  is_error?: boolean
+}
+
+export interface ReplayTurn {
+  uuid: string
+  parentUuid: string | null
+  type: 'user' | 'assistant'
+  timestamp: string
+  model?: string
+  usage?: TurnUsage
+  text?: string
+  tool_calls?: ToolCall[]
+  tool_results?: Array<{ tool_use_id: string; content: string; is_error: boolean }>
+  has_thinking?: boolean
+  thinking_text?: string
+  estimated_cost?: number
+  turn_duration_ms?: number
+  response_time_s?: number
+}
+
+export interface CompactionEvent {
+  uuid: string
+  timestamp: string
+  trigger: 'auto' | 'manual'
+  pre_tokens: number
+  summary?: string
+  turn_index: number
+}
+
+export interface SummaryEvent {
+  uuid: string
+  summary: string
+  leaf_uuid: string
+}
+
+export interface ReplayData {
+  session_id: string
+  slug?: string
+  version?: string
+  git_branch?: string
+  turns: ReplayTurn[]
+  compactions: CompactionEvent[]
+  summaries: SummaryEvent[]
+  total_cost: number
+}
+
+// ─── Project Summary ──────────────────────────────────────────────────────────
+
+export interface ProjectSummary {
+  slug: string
+  project_path: string
+  display_name: string
+  session_count: number
+  total_messages: number
+  total_duration_minutes: number
+  total_lines_added: number
+  total_lines_removed: number
+  total_files_modified: number
+  git_commits: number
+  git_pushes: number
+  estimated_cost: number
+  input_tokens: number
+  output_tokens: number
+  languages: Record<string, number>
+  tool_counts: Record<string, number>
+  last_active: string
+  first_active: string
+  uses_mcp: boolean
+  uses_task_agent: boolean
+  branches: string[]
+}
+
+// ─── Tool Analytics ───────────────────────────────────────────────────────────
+
+export interface ToolSummary {
+  name: string
+  category: string
+  total_calls: number
+  session_count: number
+  error_count: number
+}
+
+export interface McpServerSummary {
+  server_name: string
+  tools: Array<{ name: string; calls: number }>
+  total_calls: number
+  session_count: number
+}
+
+export interface VersionRecord {
+  version: string
+  session_count: number
+  first_seen: string
+  last_seen: string
+}
+
+export interface ToolsAnalytics {
+  tools: ToolSummary[]
+  mcp_servers: McpServerSummary[]
+  feature_adoption: Record<string, { sessions: number; pct: number }>
+  versions: VersionRecord[]
+  branches: Array<{ branch: string; turns: number }>
+  error_categories: Record<string, number>
+  total_tool_calls: number
+  total_errors: number
+}
+
+// ─── Cost Analytics ───────────────────────────────────────────────────────────
+
+export interface ModelCostBreakdown {
+  model: string
+  input_tokens: number
+  output_tokens: number
+  cache_write_tokens: number
+  cache_read_tokens: number
+  estimated_cost: number
+  cache_savings: number
+  cache_hit_rate: number
+}
+
+export interface DailyCost {
+  date: string
+  costs: Record<string, number>
+  total: number
+}
+
+export interface ProjectCost {
+  slug: string
+  display_name: string
+  estimated_cost: number
+  input_tokens: number
+  output_tokens: number
+}
+
+export interface CostAnalytics {
+  total_cost: number
+  total_savings: number
+  models: ModelCostBreakdown[]
+  daily: DailyCost[]
+  by_project: ProjectCost[]
+}
+
+// ─── History ──────────────────────────────────────────────────────────────────
+
+export interface HistoryEntry {
+  display: string
+  timestamp: number
+  project: string
+  sessionId?: string
+}
+
+// ─── Export ──────────────────────────────────────────────────────────────────
+
+export interface ExportPayload {
+  exportedAt: string
+  version: string
+  stats: StatsCache | null
+  sessions: SessionMeta[]
+  facets: Facet[]
+  history: HistoryEntry[]
+}
+
+export interface ImportDiff {
+  total_in_export: number
+  already_present: number
+  new_sessions: number
+  sessions_to_add: SessionMeta[]
+}

package/src/agents/loader.mjs

@@ -0,0 +1,94 @@
+/**
+ * Agent Loader — loads custom agent definitions from .bahulam/agents/
+ *
+ * Supports two formats:
+ * - YAML: .bahulam/agents/*.yaml / *.yml (native Kepler SubAgent config)
+ * - JSON: .bahulam/agents/*.json
+ * - Markdown with YAML frontmatter: .bahulam/agents/*.md
+ *
+ * Agent definitions specify: name, description, model, tools, hooks, prompt.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { parseAgentDefinition } from './parser.mjs';
+
+export class AgentLoader {
+    constructor() {
+        this.agents = new Map();
+        this.searchPaths = [];
+    }
+
+    /**
+     * Load agents from standard directories.
+     * @param {string} [cwd] - project working directory
+     */
+    load(cwd = process.cwd()) {
+        // Prefer .bahulam/, but also scan legacy .kepler/ so agents defined
+        // under the old convention keep loading for existing projects.
+        this.searchPaths = [
+            path.join(cwd, '.bahulam', 'agents'),
+            path.join(cwd, '.kepler', 'agents'),
+            path.join(process.env.HOME || '', '.bahulam', 'agents'),
+            path.join(process.env.HOME || '', '.kepler', 'agents'),
+        ];
+
+        for (const dir of this.searchPaths) {
+            this._loadFromDir(dir);
+        }
+
+        return this;
+    }
+
+    _loadFromDir(dir) {
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isFile()) continue;
+                const ext = path.extname(entry.name);
+                if (!['.yaml', '.yml', '.json', '.md'].includes(ext)) continue;
+
+                const filePath = path.join(dir, entry.name);
+                try {
+                    const content = fs.readFileSync(filePath, 'utf-8');
+                    const agent = parseAgentDefinition(content, ext);
+                    if (agent && agent.name && !this.agents.has(agent.name)) {
+                        this.agents.set(agent.name, { ...agent, source: filePath });
+                    }
+                } catch (err) {
+                    if (process.env.DEBUG) {
+                        console.error(`Failed to load agent ${filePath}: ${err.message}`);
+                    }
+                }
+            }
+        } catch {
+            // Directory does not exist
+        }
+    }
+
+    /**
+     * Get an agent definition by name.
+     * @param {string} name
+     * @returns {object|null}
+     */
+    get(name) {
+        return this.agents.get(name) || null;
+    }
+
+    /**
+     * List all loaded agents.
+     * @returns {Array<object>}
+     */
+    list() {
+        return [...this.agents.values()];
+    }
+
+    /**
+     * Check if an agent exists.
+     * @param {string} name
+     * @returns {boolean}
+     */
+    has(name) {
+        return this.agents.has(name);
+    }
+}