@betrue/openclaw-claude-code-plugin 1.0.0

package/src/tools/claude-stats.ts

@@ -0,0 +1,33 @@
+import { Type } from "@sinclair/typebox";
+import { sessionManager, formatStats } from "../shared";
+
+export function registerClaudeStatsTool(api: any): void {
+  api.registerTool(
+    {
+      name: "claude_stats",
+      description:
+        "Show Claude Code Plugin usage metrics: session counts by status, average duration, and notable sessions.",
+      parameters: Type.Object({}),
+      async execute(_id: string, _params: any) {
+        if (!sessionManager) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "Error: SessionManager not initialized. The claude-code service must be running.",
+              },
+            ],
+          };
+        }
+
+        const metrics = sessionManager.getMetrics();
+        const text = formatStats(metrics);
+
+        return {
+          content: [{ type: "text", text }],
+        };
+      },
+    },
+    { optional: false },
+  );
+}

package/src/types.ts

@@ -0,0 +1,77 @@
+// SDK types are imported from "@anthropic-ai/claude-agent-sdk"
+// We define our own types for the plugin's internal state
+
+export type SessionStatus = "starting" | "running" | "completed" | "failed" | "killed";
+
+export type PermissionMode = "default" | "plan" | "acceptEdits" | "bypassPermissions";
+
+export interface SessionConfig {
+  prompt: string;
+  workdir: string;
+  name?: string;
+  model?: string;
+  maxBudgetUsd: number;
+  foreground?: boolean;
+  systemPrompt?: string;
+  allowedTools?: string[];
+  originChannel?: string;  // Channel that spawned this session (for background notifications)
+  permissionMode?: PermissionMode;
+
+  // Resume/fork support (Task 16)
+  resumeSessionId?: string;  // Claude session ID to resume
+  forkSession?: boolean;     // Fork instead of continuing when resuming
+
+  // Multi-turn support (Task 15)
+  multiTurn?: boolean;  // If true, use AsyncIterable prompt for multi-turn conversations
+}
+
+export interface ClaudeSession {
+  id: string;                    // nanoid(8)
+  name: string;                  // human-readable kebab-case name
+  claudeSessionId?: string;      // UUID from SDK init message
+
+  // Configuration
+  prompt: string;
+  workdir: string;
+  model?: string;
+  maxBudgetUsd: number;
+
+  // State
+  status: SessionStatus;
+  error?: string;
+
+  // Timing
+  startedAt: number;
+  completedAt?: number;
+
+  // Output
+  outputBuffer: string[];        // Last N lines of assistant text
+
+  // Result from SDK
+  result?: {
+    subtype: string;
+    duration_ms: number;
+    total_cost_usd: number;
+    num_turns: number;
+    result?: string;
+    is_error: boolean;
+    session_id: string;
+  };
+
+  // Cost tracking
+  costUsd: number;
+
+  // Foreground channels
+  foregroundChannels: Set<string>;
+}
+
+export interface PluginConfig {
+  maxSessions: number;
+  defaultBudgetUsd: number;
+  defaultModel?: string;
+  defaultWorkdir?: string;
+  idleTimeoutMinutes: number;
+  maxPersistedSessions: number;
+  fallbackChannel?: string;
+  permissionMode?: PermissionMode;
+}